@esmx/core 3.0.0-rc.69 → 3.0.0-rc.71

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

@@ -1,13 +1,14 @@
 import { assert, describe, test } from "vitest";
 import {
-  buildImportsMap,
-  buildScopesMap,
-  fixNestedScopesResolution,
-  getImportMap
+  compressImportMap,
+  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 +32,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -55,7 +56,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -84,7 +85,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -100,7 +101,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -121,7 +122,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -157,7 +158,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -181,7 +182,7 @@ describe("buildImportsMap", () => {
         scopes: {}
       }
     ];
-    const result = buildImportsMap(
+    const result = createImportsMap(
       manifests,
       (name, file) => `${name}/${file}`
     );
@@ -191,7 +192,7 @@ describe("buildImportsMap", () => {
     });
   });
 });
-describe("fixNestedScopesResolution", () => {
+describe("fixImportMapNestedScopes", () => {
   test("should return unchanged import map for empty scopes", () => {
     const importMap = {
       imports: {
@@ -199,7 +200,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 +214,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 +256,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle multiple nested scopes correctly", () => {
@@ -305,7 +306,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle deeply nested scopes", () => {
@@ -334,7 +335,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 +359,7 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
+    const result = fixImportMapNestedScopes(importMap);
     assert.deepEqual(result, expected);
   });
   test("should handle empty imports", () => {
@@ -374,7 +375,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,19 +391,17 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
-    assert.deepEqual(result.imports, importMap.imports);
-    assert.deepEqual(
-      result.scopes["/shared-modules/vue2/"],
-      importMap.scopes["/shared-modules/vue2/"]
-    );
-    assert.deepEqual(
-      result.scopes["/shared-modules/vue2/component.u5v4w3x2.final.mjs"],
-      {
-        vue: "/shared-modules/vue2.q9r8s7t6.final.mjs",
-        "vue-router": "/shared-modules/vue2/router.y1z0a9b8.final.mjs"
+    const result = fixImportMapNestedScopes(importMap);
+    const expected = {
+      imports: importMap.imports,
+      scopes: {
+        "/shared-modules/vue2/component.u5v4w3x2.final.mjs": {
+          vue: "/shared-modules/vue2.q9r8s7t6.final.mjs",
+          "vue-router": "/shared-modules/vue2/router.y1z0a9b8.final.mjs"
+        }
       }
-    );
+    };
+    assert.deepEqual(result, expected);
   });
   test("should handle complex priority scenarios with multiple nested levels", () => {
     const importMap = {
@@ -454,7 +453,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 +499,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 +551,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 +585,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 +607,14 @@ describe("fixNestedScopesResolution", () => {
         }
       }
     };
-    const result = fixNestedScopesResolution(importMap);
-    assert.deepEqual(result.imports, importMap.imports);
-    assert.isUndefined(result.scopes["/shared/modules/vue2/"]);
+    const result = fixImportMapNestedScopes(importMap);
+    const expected = {
+      imports: importMap.imports,
+      scopes: {}
+    };
+    assert.deepEqual(result, expected);
     assert.doesNotThrow(() => {
-      fixNestedScopesResolution(importMap);
+      fixImportMapNestedScopes(importMap);
     });
   });
   describe("scope path processing logic", () => {
@@ -651,7 +653,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 +673,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 +693,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 +725,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 +759,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 +793,7 @@ describe("buildScopesMap", () => {
         scopes: {}
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -828,7 +830,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -863,7 +865,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -898,7 +900,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -939,7 +941,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -972,7 +974,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1015,7 +1017,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1068,7 +1070,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1102,7 +1104,7 @@ describe("buildScopesMap", () => {
         }
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1129,7 +1131,7 @@ describe("buildScopesMap", () => {
         scopes: void 0
       }
     ];
-    const result = buildScopesMap(
+    const result = createScopesMap(
       imports,
       manifests,
       (name, scope) => `${name}/${scope}`
@@ -1137,14 +1139,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 +1182,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 +1235,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 +1270,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 +1294,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 +1327,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 +1358,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 +1390,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 +1426,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",
@@ -1438,3 +1440,147 @@ describe("getImportMap", () => {
     });
   });
 });
+describe("compressImportMap", () => {
+  test("does not promote when no global exists; keeps scopes intact", () => {
+    const importMap = {
+      imports: {},
+      scopes: {
+        "/a/": {
+          vue: "/a/vue.final.mjs"
+        },
+        "/b/": {
+          vue: "/a/vue.final.mjs"
+        }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, {
+      imports: { vue: "/a/vue.final.mjs" }
+    });
+  });
+  test("does not promote when scoped mappings conflict across scopes", () => {
+    const importMap = {
+      imports: {},
+      scopes: {
+        "/a/": { vue: "/a/vue.final.mjs" },
+        "/b/": { vue: "/b/vue.final.mjs" }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, importMap);
+  });
+  test("removes scoped entries that equal global mapping", () => {
+    const importMap = {
+      imports: { vue: "/shared/vue.final.mjs" },
+      scopes: {
+        "/a/": {
+          vue: "/shared/vue.final.mjs",
+          lodash: "/a/lodash.final.mjs"
+        }
+      }
+    };
+    const result = compressImportMap(importMap);
+    const expected = {
+      imports: {
+        vue: "/shared/vue.final.mjs",
+        lodash: "/a/lodash.final.mjs"
+      }
+    };
+    assert.deepEqual(result, expected);
+  });
+  test("promotes to global when global matches single unique target across scopes", () => {
+    const importMap = {
+      imports: { vue: "/shared/vue.final.mjs" },
+      scopes: {
+        "/a/": { vue: "/shared/vue.final.mjs" },
+        "/b/": { vue: "/shared/vue.final.mjs" }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, {
+      imports: { vue: "/shared/vue.final.mjs" }
+    });
+  });
+  test("promotes to global when no global exists and targets are consistent across scopes (promote mode)", () => {
+    const importMap = {
+      imports: {},
+      scopes: {
+        "/a/": { vue: "/x/vue.final.mjs" },
+        "/b/": { vue: "/x/vue.final.mjs" }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, {
+      imports: { vue: "/x/vue.final.mjs" }
+    });
+  });
+  test("promotes dominant target and keeps exceptions in scopes (promote mode)", () => {
+    const importMap = {
+      imports: {},
+      scopes: {
+        "/a/": { vue: "/x/vue.final.mjs" },
+        "/b/": { vue: "/x/vue.final.mjs" },
+        "/c/": { vue: "/y/vue2.final.mjs" }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, {
+      imports: { vue: "/x/vue.final.mjs" },
+      scopes: {
+        "/c/": { vue: "/y/vue2.final.mjs" }
+      }
+    });
+  });
+  test("does not promote when no global exists; keeps scopes intact", () => {
+    const importMap = {
+      imports: {},
+      scopes: {
+        "/a/": { vue: "/shared/vue.final.mjs" },
+        "/b/": { vue: "/shared/vue.final.mjs" },
+        "/c/": { vue: "/c/vue2.final.mjs" }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, {
+      imports: { vue: "/shared/vue.final.mjs" },
+      scopes: { "/c/": { vue: "/c/vue2.final.mjs" } }
+    });
+  });
+  test("aggressive default does not override different existing global", () => {
+    const importMap = {
+      imports: { vue: "/global/vue.final.mjs" },
+      scopes: {
+        "/a/": { vue: "/shared/vue.final.mjs" },
+        "/b/": { vue: "/shared/vue.final.mjs" }
+      }
+    };
+    const result = compressImportMap(importMap);
+    assert.deepEqual(result, {
+      imports: { vue: "/global/vue.final.mjs" },
+      scopes: {
+        "/a/": { vue: "/shared/vue.final.mjs" },
+        "/b/": { vue: "/shared/vue.final.mjs" }
+      }
+    });
+  });
+  test("returns new object and keeps input unchanged", () => {
+    const original = {
+      imports: {},
+      scopes: {
+        "/a/": { vue: "/x/vue.final.mjs" },
+        "/b/": { vue: "/x/vue.final.mjs" },
+        "/c/": { vue: "/y/vue2.final.mjs" }
+      }
+    };
+    const importMap = JSON.parse(JSON.stringify(original));
+    const result = compressImportMap(importMap);
+    assert.notStrictEqual(result, importMap);
+    assert.notStrictEqual(result.imports, importMap.imports);
+    assert.notStrictEqual(result.scopes, importMap.scopes);
+    assert.deepEqual(importMap, original);
+    assert.deepEqual(result, {
+      imports: { vue: "/x/vue.final.mjs" },
+      scopes: { "/c/": { vue: "/y/vue2.final.mjs" } }
+    });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@esmx/core",
-    "description": "A high-performance microfrontend framework supporting Vue, React, Preact, Solid, and Svelte with SSR and Module Federation capabilities.",
+    "description": "A high-performance microfrontend framework supporting Vue, React, Preact, Solid, and Svelte with SSR and Module Linking capabilities.",
     "contributors": [
         {
             "name": "lzxb",
@@ -39,7 +39,7 @@
         "Microfrontend",
         "SSR",
         "Rspack",
-        "Module Federation",
+        "Module Linking",
         "High Performance",
         "TypeScript"
     ],
@@ -59,7 +59,7 @@
         "build": "unbuild"
     },
     "dependencies": {
-        "@esmx/import": "3.0.0-rc.69",
+        "@esmx/import": "3.0.0-rc.71",
         "@types/serialize-javascript": "^5.0.4",
         "es-module-lexer": "^1.7.0",
         "find": "^0.3.0",
@@ -69,15 +69,15 @@
     "devDependencies": {
         "@biomejs/biome": "1.9.4",
         "@types/find": "^0.2.4",
-        "@types/node": "^24.0.0",
-        "@types/send": "^0.17.4",
+        "@types/node": "^24.10.0",
+        "@types/send": "^1.2.1",
         "@types/write": "^2.0.4",
         "@vitest/coverage-v8": "3.2.4",
-        "typescript": "5.9.2",
-        "unbuild": "3.6.0",
+        "typescript": "5.9.3",
+        "unbuild": "3.6.1",
         "vitest": "3.2.4"
     },
-    "version": "3.0.0-rc.69",
+    "version": "3.0.0-rc.71",
     "type": "module",
     "private": false,
     "exports": {
@@ -100,5 +100,5 @@
         "template",
         "public"
     ],
-    "gitHead": "340151dd2777a5d7a10cd08e10783fdc24fb7eb5"
+    "gitHead": "1616c7a1f820387d4d14bac0babd42356f6f7f33"
 }

package/src/cli/cli.ts

@@ -13,13 +13,19 @@ async function getSrcOptions(): Promise<EsmxOptions> {
 
 async function getDistOptions(): Promise<EsmxOptions> {
     try {
-        return import(
-            resolveImportPath(process.cwd(), './dist/index.mjs')
-        ).then((m) => m.default);
+        const m = await import(
+            resolveImportPath(process.cwd(), './dist/node/src/entry.node.mjs')
+        );
+        return m.default;
     } catch (e) {
-        throw new Error(
-            `Failed to load configuration from dist/index.mjs. Please make sure you have run 'esmx build' first.\n${e}`
+        console.error(
+            styleText(
+                'red',
+                'Failed to load dist entry: dist/node/src/entry.node.mjs'
+            )
         );
+        console.error(styleText('yellow', 'Run `esmx build` and try again.'));
+        process.exit(17);
     }
 }