Add docs for HtmlHelper::importmap()

Author: ADmad

en/appendices/5-2-migration-guide.rst

@@ -18,7 +18,6 @@ Behavior Changes
   being filterable from logging.
 - ``NumericPaginator::paginate()`` now uses the ``finder`` option even when a ``SelectQuery`` instance is passed to it.
 
-
 Deprecations
 ============
 
@@ -87,7 +86,9 @@ View
 ----
 
  - ``FormHelper::deleteLink()`` has been added as convenience wrapper for delete links in
-   templates using `DELETE` method.
+   templates using ``DELETE`` method.
+- ``HtmlHelper::importmap()`` was added. This method allows you to define
+  import maps for your JavaScript files.
 
 Error
 -----

en/views/helpers/html.rst

@@ -561,6 +561,66 @@ Once you have buffered javascript, you can output it as you would any other
     // In your layout
     echo $this->fetch('script');
 
+Creating Javascript Importmap
+-----------------------------
+
+.. php:method:: importmap(array $map, array $options = []): string
+
+Creates an `importmap` script tag for your JavaScript files::
+
+    // In the head tag of your layout
+    echo $this->Html->importmap([
+        'jquery' => 'jquery.js',
+        'wysiwyg' => '/editor/wysiwyg.js'
+    ]);
+
+Will output:
+
+.. code-block:: html
+
+    <script type="importmap">{
+        "imports": {
+            "jquery": "/js/jquery.js",
+            "wysiwyg": "/editor/wysiwyg.js"
+        }
+    }</script>
+
+Generating maps with imports, scopes and integrity::
+
+    echo $this->Html->importmap([
+        'imports' => [
+            'jquery' => 'jquery-3.7.1.min.js',
+            'wysiwyg' => '/editor/wysiwyg.js'
+        ],
+        'scopes' => [
+            'scoped/' => [
+                'foo' => 'inner/foo',
+            ],
+        ],
+        'integrity' => [
+            'jquery' => 'sha256-/JqT3SQfawRcv/BIHPThkBvs0OEvtFFmqPF/lYI/Cxo=',
+        ],
+    ]);
+
+Will output:
+
+.. code-block:: html
+
+    <script type="importmap">{
+        "imports": {
+            "jquery": "/js/jquery-3.7.1.min.js",
+            "wysiwyg": "/editor/wysiwyg.js"
+        },
+        "scopes": {
+            "scoped/": {
+                "foo": "/js/inner/foo.js"
+            }
+        },
+        "integrity": {
+            "/js/jquery-3.7.1.min.js": "sha256-/JqT3SQfawRcv/BIHPThkBvs0OEvtFFmqPF/lYI/Cxo="
+        }
+    }</script>
+
 Creating Nested Lists
 ---------------------