@esmx/core 3.0.0-rc.66 → 3.0.0-rc.70

package/dist/core.mjs

@@ -14,7 +14,7 @@ import {
   parsePackConfig
 } from "./pack-config.mjs";
 import { createCache } from "./utils/cache.mjs";
-import { getImportMap } from "./utils/import-map.mjs";
+import { createImportMap } from "./utils/import-map.mjs";
 import { resolvePath } from "./utils/resolve-path.mjs";
 import { getImportPreloadInfo as getStaticImportPaths } from "./utils/static-import-lexer.mjs";
 export var COMMAND = /* @__PURE__ */ ((COMMAND2) => {
@@ -677,7 +677,7 @@ export class Esmx {
       let json = {};
       switch (env) {
         case "client": {
-          json = getImportMap({
+          json = createImportMap({
             manifests,
             getScope(name, scope) {
               return `/${name}${scope}`;
@@ -689,7 +689,7 @@ export class Esmx {
           break;
         }
         case "server":
-          json = getImportMap({
+          json = createImportMap({
             manifests,
             getScope: (name, scope) => {
               const linkPath = moduleConfig.links[name].server;

package/dist/utils/import-map.d.ts

@@ -14,21 +14,22 @@ export interface GetImportMapOptions {
     getScope: (name: string, scope: string) => string;
     getFile: (name: string, file: string) => string;
 }
-export declare function buildImportsMap(manifests: readonly ImportMapManifest[], getFile: (name: string, file: string) => string): SpecifierMap;
-export declare function buildScopesMap(imports: SpecifierMap, manifests: readonly ImportMapManifest[], getScope: (name: string, scope: string) => string): ScopesMap;
+export declare function createImportsMap(manifests: readonly ImportMapManifest[], getFile: (name: string, file: string) => string): SpecifierMap;
+export declare function createScopesMap(imports: SpecifierMap, manifests: readonly ImportMapManifest[], getScope: (name: string, scope: string) => string): ScopesMap;
 /**
- * Fixes Chrome's nested scope resolution bug in import maps.
+ * Fixes the nested scope resolution issue in import maps across all browsers.
  *
- * Chrome has a bug where nested scopes in import maps are not resolved correctly.
+ * Import Maps have a cross-browser issue where nested scopes are not resolved correctly.
  * For example, when you have both "/shared-modules/" and "/shared-modules/vue2/" scopes,
- * Chrome fails to properly apply the more specific nested scope.
+ * browsers fail to properly apply the more specific nested scope.
  *
- * This function works around the bug by:
+ * This function works around the issue by:
  * 1. Sorting scopes by path depth (shallow paths first, deeper paths last)
  * 2. Manually applying scopes to matching imports in the correct order
+ * 3. Converting pattern-based scopes to concrete path scopes
  *
  * @example
- * Problematic import map that fails in Chrome:
+ * Problematic import map that fails in browsers:
  * ```json
  * {
  *   "scopes": {
@@ -45,5 +46,5 @@ export declare function buildScopesMap(imports: SpecifierMap, manifests: readonl
  * @see https://github.com/guybedford/es-module-shims/issues/529
  * @see https://issues.chromium.org/issues/453147451
  */
-export declare function fixNestedScopesResolution(importMap: Required<ImportMap>): Required<ImportMap>;
-export declare function getImportMap({ manifests, getFile, getScope }: GetImportMapOptions): Required<ImportMap>;
+export declare function fixImportMapNestedScopes(importMap: Required<ImportMap>): Required<ImportMap>;
+export declare function createImportMap({ manifests, getFile, getScope }: GetImportMapOptions): Required<ImportMap>;

package/dist/utils/import-map.mjs

@@ -1,5 +1,5 @@
 import { pathWithoutIndex } from "./path-without-index.mjs";
-export function buildImportsMap(manifests, getFile) {
+export function createImportsMap(manifests, getFile) {
   const imports = {};
   manifests.forEach((manifest) => {
     Object.entries(manifest.exports).forEach(([, exportItem]) => {
@@ -10,7 +10,7 @@ export function buildImportsMap(manifests, getFile) {
   pathWithoutIndex(imports);
   return imports;
 }
-export function buildScopesMap(imports, manifests, getScope) {
+export function createScopesMap(imports, manifests, getScope) {
   const scopes = {};
   manifests.forEach((manifest) => {
     if (!manifest.scopes) {
@@ -30,7 +30,7 @@ export function buildScopesMap(imports, manifests, getScope) {
   });
   return scopes;
 }
-export function fixNestedScopesResolution(importMap) {
+export function fixImportMapNestedScopes(importMap) {
   Object.entries(importMap.scopes).sort(([pathA], [pathB]) => {
     const depthA = pathA.split("/").length;
     const depthB = pathB.split("/").length;
@@ -48,13 +48,13 @@ export function fixNestedScopesResolution(importMap) {
   });
   return importMap;
 }
-export function getImportMap({
+export function createImportMap({
   manifests,
   getFile,
   getScope
 }) {
-  const imports = buildImportsMap(manifests, getFile);
-  const scopes = buildScopesMap(imports, manifests, getScope);
+  const imports = createImportsMap(manifests, getFile);
+  const scopes = createScopesMap(imports, manifests, getScope);
   return {
     imports,
     scopes

package/dist/utils/import-map.test.mjs

@@ -1,13 +1,13 @@
 import { assert, describe, test } from "vitest";
 import {
-  buildImportsMap,
-  buildScopesMap,
-  fixNestedScopesResolution,
-  getImportMap
+  createImportMap,
+  createImportsMap,
+  createScopesMap,
+  fixImportMapNestedScopes
 } from "./import-map.mjs";
-describe("buildImportsMap", () => {
+describe("createImportsMap", () => {
   test("should return empty object for empty manifests", () => {
-    const result = buildImportsMap([], (name, file) => `${name}/${file}`);
+    const result = createImportsMap([], (name, file) => `${name}/${file}`);
     assert.deepEqual(result, {});
   });
   test("should process all exports including package exports", () => {
@@ -31,7 +31,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -55,7 +55,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -84,7 +84,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -100,7 +100,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -121,7 +121,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -157,7 +157,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -181,7 +181,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -191,7 +191,7 @@ describe("buildImportsMap", () => {
     });
   });
 });
-describe("fixNestedScopesResolution", () => {
+describe("fixImportMapNestedScopes", () => {
   test("should return unchanged import map for empty scopes", () => {
     const importMap = {
       imports: {
@@ -199,7 +199,7 @@ describe("fixNestedScopesResolution", () => {
       },
       scopes: {}
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, importMap);
   });
   test("should return unchanged import map for shallow scopes only", () => {
@@ -213,7 +213,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, importMap);
   });
   test("should create file-level scopes for nested scopes", () => {
@@ -255,7 +255,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle multiple nested scopes correctly", () => {
@@ -305,7 +305,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle deeply nested scopes", () => {
@@ -334,7 +334,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should not create file-level scopes for imports not matching nested scope", () => {
@@ -358,7 +358,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle empty imports", () => {
@@ -374,7 +374,7 @@ describe("fixNestedScopesResolution", () => {
       imports: {},
       scopes: {}
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should preserve original import map structure", () => {
@@ -390,7 +390,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result.imports, importMap.imports);
     assert.deepEqual(
       result.scopes["/shared-modules/vue2/"],
@@ -454,7 +454,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle priority with overlapping nested scopes", () => {
@@ -500,7 +500,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle very deeply nested scope priority scenarios", () => {
@@ -552,7 +552,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should ensure different directory levels have distinct values for proper testing", () => {
@@ -586,7 +586,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
     assert.equal(
       result.scopes["/shared-modules/level1/level2.e5f6g7h8.final.mjs"].vue,
@@ -608,11 +608,11 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result.imports, importMap.imports);
     assert.isUndefined(result.scopes["/shared/modules/vue2/"]);
     assert.doesNotThrow(() => {
-      fixNestedScopesResolution(importMap);
+      fixImportMapNestedScopes(importMap);
     });
   });
   describe("scope path processing logic", () => {
@@ -651,7 +651,7 @@ describe("fixNestedScopesResolution", () => {
           }
         }
       };
-      const result = fixNestedScopesResolution(importMap);
+      const result = fixImportMapNestedScopes(importMap);
       assert.deepEqual(result, expected);
     });
     test("should handle scope paths with any depth", () => {
@@ -671,7 +671,7 @@ describe("fixNestedScopesResolution", () => {
         },
         scopes: {}
       };
-      const result = fixNestedScopesResolution(importMap);
+      const result = fixImportMapNestedScopes(importMap);
       assert.deepEqual(result, expected);
     });
     test("should handle very deep nested scope paths", () => {
@@ -691,7 +691,7 @@ describe("fixNestedScopesResolution", () => {
         },
         scopes: {}
       };
-      const result = fixNestedScopesResolution(importMap);
+      const result = fixImportMapNestedScopes(importMap);
       assert.deepEqual(result, expected);
     });
     test("should create file-level scopes for all scope paths", () => {
@@ -723,7 +723,7 @@ describe("fixNestedScopesResolution", () => {
           }
         }
       };
-      const result = fixNestedScopesResolution(importMap);
+      const result = fixImportMapNestedScopes(importMap);
       assert.deepEqual(result, expected);
     });
     test("should process multiple scope paths in correct order by depth", () => {
@@ -757,16 +757,16 @@ describe("fixNestedScopesResolution", () => {
           }
         }
       };
-      const result = fixNestedScopesResolution(importMap);
+      const result = fixImportMapNestedScopes(importMap);
       assert.deepEqual(result, expected);
     });
   });
 });
-describe("buildScopesMap", () => {
+describe("createScopesMap", () => {
   test("should return empty object for empty manifests", () => {
     const imports = {};
     const manifests = [];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -791,7 +791,7 @@ describe("buildScopesMap", () => {
         scopes: {}
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -828,7 +828,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -863,7 +863,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -898,7 +898,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -939,7 +939,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -972,7 +972,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1015,7 +1015,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1068,7 +1068,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1102,7 +1102,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1129,7 +1129,7 @@ describe("buildScopesMap", () => {
         scopes: void 0
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1137,14 +1137,14 @@ describe("buildScopesMap", () => {
     assert.deepEqual(result, {});
   });
 });
-describe("getImportMap", () => {
+describe("createImportMap", () => {
   test("should return empty import map for empty manifests", () => {
     const options = {
       manifests: [],
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {},
       scopes: {}
@@ -1180,7 +1180,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "test-module/component": "test-module/component.js",
@@ -1233,7 +1233,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "module-a/utils": "module-a/utils.js",
@@ -1268,7 +1268,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "test-module/component": "test-module/component.js"
@@ -1292,7 +1292,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {},
       scopes: {
@@ -1325,7 +1325,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `/custom/path/${name}/${file}`,
       getScope: (name, scope) => `custom-scope-${name}-${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "test-module/component": "/custom/path/test-module/component.js"
@@ -1356,7 +1356,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "test-module/component": "test-module/component.js"
@@ -1388,7 +1388,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "test-module/component": "test-module/component.js"
@@ -1424,7 +1424,7 @@ describe("getImportMap", () => {
       getFile: (name, file) => `${name}/${file}`,
       getScope: (name, scope) => `${name}/${scope}`
     };
-    const result = getImportMap(options);
+    const result = createImportMap(options);
     assert.deepEqual(result, {
       imports: {
         "test-module/src/index": "test-module/src/index.js",

package/package.json

@@ -59,7 +59,7 @@
         "build": "unbuild"
     },
     "dependencies": {
-        "@esmx/import": "3.0.0-rc.66",
+        "@esmx/import": "3.0.0-rc.70",
         "@types/serialize-javascript": "^5.0.4",
         "es-module-lexer": "^1.7.0",
         "find": "^0.3.0",
@@ -77,7 +77,7 @@
         "unbuild": "3.6.0",
         "vitest": "3.2.4"
     },
-    "version": "3.0.0-rc.66",
+    "version": "3.0.0-rc.70",
     "type": "module",
     "private": false,
     "exports": {
@@ -100,5 +100,5 @@
         "template",
         "public"
     ],
-    "gitHead": "07815a4becd617c4c3fc58f5fd853d8ad4bd4caf"
+    "gitHead": "9aa452ae73e450d285e4ddbd35a4ac8b53427d95"
 }

package/src/core.ts

@@ -22,7 +22,7 @@ import {
 import type { ImportmapMode } from './render-context';
 import type { RenderContext, RenderContextOptions } from './render-context';
 import { type CacheHandle, createCache } from './utils/cache';
-import { getImportMap } from './utils/import-map';
+import { createImportMap } from './utils/import-map';
 import type { Middleware } from './utils/middleware';
 import { type ProjectPath, resolvePath } from './utils/resolve-path';
 import { getImportPreloadInfo as getStaticImportPaths } from './utils/static-import-lexer';
@@ -854,7 +854,7 @@ export class Esmx {
             let json: ImportMap = {};
             switch (env) {
                 case 'client': {
-                    json = getImportMap({
+                    json = createImportMap({
                         manifests,
                         getScope(name, scope) {
                             return `/${name}${scope}`;
@@ -866,7 +866,7 @@ export class Esmx {
                     break;
                 }
                 case 'server':
-                    json = getImportMap({
+                    json = createImportMap({
                         manifests,
                         getScope: (name: string, scope: string) => {
                             const linkPath = moduleConfig.links[name].server;

package/src/utils/import-map.test.ts

@@ -1,15 +1,15 @@
 import { assert, describe, test } from 'vitest';
 import {
-    buildImportsMap,
-    buildScopesMap,
-    fixNestedScopesResolution,
-    getImportMap
+    createImportMap,
+    createImportsMap,
+    createScopesMap,
+    fixImportMapNestedScopes
 } from './import-map';
 import type { GetImportMapOptions, ImportMapManifest } from './import-map';
 
-describe('buildImportsMap', () => {
+describe('createImportsMap', () => {
     test('should return empty object for empty manifests', () => {
-        const result = buildImportsMap([], (name, file) => `${name}/${file}`);
+        const result = createImportsMap([], (name, file) => `${name}/${file}`);
         assert.deepEqual(result, {});
     });
 
@@ -35,7 +35,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -62,7 +62,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -94,7 +94,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -113,7 +113,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -137,7 +137,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -177,7 +177,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -204,7 +204,7 @@ describe('buildImportsMap', () => {
             }
         ];
 
-        const result = buildImportsMap(
+        const result = createImportsMap(
             manifests,
             (name, file) => `${name}/${file}`
         );
@@ -218,7 +218,7 @@ describe('buildImportsMap', () => {
     });
 });
 
-describe('fixNestedScopesResolution', () => {
+describe('fixImportMapNestedScopes', () => {
     test('should return unchanged import map for empty scopes', () => {
         const importMap = {
             imports: {
@@ -227,7 +227,7 @@ describe('fixNestedScopesResolution', () => {
             scopes: {}
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, importMap);
     });
 
@@ -243,7 +243,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, importMap);
     });
 
@@ -294,7 +294,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -355,7 +355,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -391,7 +391,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -420,7 +420,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -439,7 +439,7 @@ describe('fixNestedScopesResolution', () => {
             scopes: {}
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -460,7 +460,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
 
         assert.deepEqual(result.imports, importMap.imports);
         assert.deepEqual(
@@ -543,7 +543,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -607,7 +607,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -674,7 +674,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
     });
 
@@ -717,7 +717,7 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result, expected);
 
         assert.equal(
@@ -746,11 +746,11 @@ describe('fixNestedScopesResolution', () => {
             }
         };
 
-        const result = fixNestedScopesResolution(importMap);
+        const result = fixImportMapNestedScopes(importMap);
         assert.deepEqual(result.imports, importMap.imports);
         assert.isUndefined(result.scopes['/shared/modules/vue2/']);
         assert.doesNotThrow(() => {
-            fixNestedScopesResolution(importMap);
+            fixImportMapNestedScopes(importMap);
         });
     });
 
@@ -794,7 +794,7 @@ describe('fixNestedScopesResolution', () => {
                 }
             };
 
-            const result = fixNestedScopesResolution(importMap);
+            const result = fixImportMapNestedScopes(importMap);
             assert.deepEqual(result, expected);
         });
 
@@ -817,7 +817,7 @@ describe('fixNestedScopesResolution', () => {
                 scopes: {}
             };
 
-            const result = fixNestedScopesResolution(importMap);
+            const result = fixImportMapNestedScopes(importMap);
             assert.deepEqual(result, expected);
         });
 
@@ -840,7 +840,7 @@ describe('fixNestedScopesResolution', () => {
                 scopes: {}
             };
 
-            const result = fixNestedScopesResolution(importMap);
+            const result = fixImportMapNestedScopes(importMap);
             assert.deepEqual(result, expected);
         });
 
@@ -875,7 +875,7 @@ describe('fixNestedScopesResolution', () => {
                 }
             };
 
-            const result = fixNestedScopesResolution(importMap);
+            const result = fixImportMapNestedScopes(importMap);
             assert.deepEqual(result, expected);
         });
 
@@ -919,17 +919,17 @@ describe('fixNestedScopesResolution', () => {
                 }
             };
 
-            const result = fixNestedScopesResolution(importMap);
+            const result = fixImportMapNestedScopes(importMap);
             assert.deepEqual(result, expected);
         });
     });
 });
 
-describe('buildScopesMap', () => {
+describe('createScopesMap', () => {
     test('should return empty object for empty manifests', () => {
         const imports = {};
         const manifests: ImportMapManifest[] = [];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -955,7 +955,7 @@ describe('buildScopesMap', () => {
                 scopes: {}
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -993,7 +993,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1029,7 +1029,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1065,7 +1065,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1107,7 +1107,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1141,7 +1141,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1185,7 +1185,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1239,7 +1239,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1274,7 +1274,7 @@ describe('buildScopesMap', () => {
                 }
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1302,7 +1302,7 @@ describe('buildScopesMap', () => {
                 scopes: undefined as any
             }
         ];
-        const result = buildScopesMap(
+        const result = createScopesMap(
             imports,
             manifests,
             (name, scope) => `${name}/${scope}`
@@ -1311,14 +1311,14 @@ describe('buildScopesMap', () => {
     });
 });
 
-describe('getImportMap', () => {
+describe('createImportMap', () => {
     test('should return empty import map for empty manifests', () => {
         const options: GetImportMapOptions = {
             manifests: [],
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {},
             scopes: {}
@@ -1355,7 +1355,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'test-module/component': 'test-module/component.js',
@@ -1409,7 +1409,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'module-a/utils': 'module-a/utils.js',
@@ -1445,7 +1445,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'test-module/component': 'test-module/component.js'
@@ -1470,7 +1470,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {},
             scopes: {
@@ -1504,7 +1504,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `/custom/path/${name}/${file}`,
             getScope: (name, scope) => `custom-scope-${name}-${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'test-module/component': '/custom/path/test-module/component.js'
@@ -1536,7 +1536,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'test-module/component': 'test-module/component.js'
@@ -1569,7 +1569,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'test-module/component': 'test-module/component.js'
@@ -1606,7 +1606,7 @@ describe('getImportMap', () => {
             getFile: (name, file) => `${name}/${file}`,
             getScope: (name, scope) => `${name}/${scope}`
         };
-        const result = getImportMap(options);
+        const result = createImportMap(options);
         assert.deepEqual(result, {
             imports: {
                 'test-module/src/index': 'test-module/src/index.js',

package/src/utils/import-map.ts

@@ -22,7 +22,7 @@ export interface GetImportMapOptions {
     getFile: (name: string, file: string) => string;
 }
 
-export function buildImportsMap(
+export function createImportsMap(
     manifests: readonly ImportMapManifest[],
     getFile: (name: string, file: string) => string
 ): SpecifierMap {
@@ -40,7 +40,7 @@ export function buildImportsMap(
     return imports;
 }
 
-export function buildScopesMap(
+export function createScopesMap(
     imports: SpecifierMap,
     manifests: readonly ImportMapManifest[],
     getScope: (name: string, scope: string) => string
@@ -73,18 +73,19 @@ export function buildScopesMap(
     return scopes;
 }
 /**
- * Fixes Chrome's nested scope resolution bug in import maps.
+ * Fixes the nested scope resolution issue in import maps across all browsers.
  *
- * Chrome has a bug where nested scopes in import maps are not resolved correctly.
+ * Import Maps have a cross-browser issue where nested scopes are not resolved correctly.
  * For example, when you have both "/shared-modules/" and "/shared-modules/vue2/" scopes,
- * Chrome fails to properly apply the more specific nested scope.
+ * browsers fail to properly apply the more specific nested scope.
  *
- * This function works around the bug by:
+ * This function works around the issue by:
  * 1. Sorting scopes by path depth (shallow paths first, deeper paths last)
  * 2. Manually applying scopes to matching imports in the correct order
+ * 3. Converting pattern-based scopes to concrete path scopes
  *
  * @example
- * Problematic import map that fails in Chrome:
+ * Problematic import map that fails in browsers:
  * ```json
  * {
  *   "scopes": {
@@ -101,7 +102,7 @@ export function buildScopesMap(
  * @see https://github.com/guybedford/es-module-shims/issues/529
  * @see https://issues.chromium.org/issues/453147451
  */
-export function fixNestedScopesResolution(
+export function fixImportMapNestedScopes(
     importMap: Required<ImportMap>
 ): Required<ImportMap> {
     Object.entries(importMap.scopes)
@@ -125,14 +126,14 @@ export function fixNestedScopesResolution(
     return importMap;
 }
 
-export function getImportMap({
+export function createImportMap({
     manifests,
     getFile,
     getScope
 }: GetImportMapOptions): Required<ImportMap> {
-    const imports = buildImportsMap(manifests, getFile);
+    const imports = createImportsMap(manifests, getFile);
 
-    const scopes = buildScopesMap(imports, manifests, getScope);
+    const scopes = createScopesMap(imports, manifests, getScope);
     return {
         imports,
         scopes