Allow to deprecate WebAssets (#40385)

* Log of deprecated WebAssets

* deprecated com_templates.admin-template-compare

Author: Fedik

build/media_source/com_templates/joomla.asset.json

@@ -27,7 +27,9 @@
       ],
       "attributes": {
         "type": "module"
-      }
+      },
+      "deprecated": true,
+      "deprecatedMsg": "To be removed in Joomla 5.0"
     },
     {
       "name": "com_templates.admin-template-toggle-assignment.es5",

libraries/src/Document/Renderer/Html/ScriptsRenderer.php

@@ -159,6 +159,13 @@ private function renderElement($item): string
                 if ($asset->getDependencies()) {
                     $attribs['data-asset-dependencies'] = implode(',', $asset->getDependencies());
                 }
+
+                if ($asset->getOption('deprecated')) {
+                    @trigger_error(
+                        sprintf('Web Asset script [%s] is deprecated. %s', $asset->getName(), $asset->getOption('deprecatedMsg', '')),
+                        E_USER_DEPRECATED
+                    );
+                }
             }
         } else {
             $attribs     = $item;

libraries/src/Document/Renderer/Html/StylesRenderer.php

@@ -151,6 +151,13 @@ private function renderElement($item): string
                 if ($asset->getDependencies()) {
                     $attribs['data-asset-dependencies'] = implode(',', $asset->getDependencies());
                 }
+
+                if ($asset->getOption('deprecated')) {
+                    @trigger_error(
+                        sprintf('Web Asset style [%s] is deprecated. %s', $asset->getName(), $asset->getOption('deprecatedMsg', '')),
+                        E_USER_DEPRECATED
+                    );
+                }
             }
         } else {
             $attribs     = $item;