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

package/README.md

@@ -20,7 +20,7 @@
     </a>
   </div>
   
-  <p>A high-performance microfrontend framework supporting Vue, React, Preact, Solid, and Svelte with SSR and Module Federation capabilities</p>
+  <p>A high-performance microfrontend framework supporting Vue, React, Preact, Solid, and Svelte with SSR and Module Linking capabilities</p>
   
   <p>
     English | <a href="https://github.com/esmnext/esmx/blob/master/packages/core/README.zh-CN.md">中文</a>
@@ -38,16 +38,19 @@
 ## 📦 Installation
 
 ```bash
+# npm
 npm install @esmx/core
-```
 
-## 🚀 Quick Start
+# pnpm
+pnpm add @esmx/core
 
-```bash
-npm install @esmx/core
+# yarn
+yarn add @esmx/core
 ```
 
-For detailed usage examples and configuration options, please visit the [official documentation](https://esmx.dev).
+## 🚀 Quick Start
+
+See Quick Start guide: https://esmx.dev/guide/start/getting-started.html
 
 ## 📚 Documentation
 
@@ -55,4 +58,4 @@ Visit the [official documentation](https://esmx.dev) for detailed usage guides a
 
 ## 📄 License
 
-MIT © [Esmx Team](https://github.com/esmnext/esmx)
+MIT © [Esmx Team](https://github.com/esmnext/esmx)

package/README.zh-CN.md

@@ -20,7 +20,7 @@
     </a>
   </div>
   
-  <p>支持 Vue、React、Preact、Solid、Svelte 的高性能微前端框架，具备 SSR 和模块联邦能力</p>
+  <p>支持 Vue、React、Preact、Solid、Svelte 的高性能微前端框架，具备 SSR 和模块链接能力</p>
   
   <p>
     <a href="https://github.com/esmnext/esmx/blob/master/packages/core/README.md">English</a> | 中文
@@ -38,16 +38,19 @@
 ## 📦 安装
 
 ```bash
+# npm
 npm install @esmx/core
-```
 
-## 🚀 快速开始
+# pnpm
+pnpm add @esmx/core
 
-```bash
-npm install @esmx/core
+# yarn
+yarn add @esmx/core
 ```
 
-详细的使用示例和配置选项，请访问[官方文档](https://esmx.dev)。
+## 🚀 快速开始
+
+查看快速开始指南：https://esmx.dev/zh-CN/guide/start/getting-started.html
 
 ## 📚 文档
 
@@ -55,4 +58,4 @@ npm install @esmx/core
 
 ## 📄 许可证
 
-MIT © [Esmx Team](https://github.com/esmnext/esmx)
+MIT © [Esmx Team](https://github.com/esmnext/esmx)

package/dist/cli/cli.mjs

@@ -10,12 +10,17 @@ async function getSrcOptions() {
 }
 async function getDistOptions() {
   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.
-${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);
   }
 }
 export async function cli(command) {

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 { createClientImportMap, 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 = createClientImportMap({
             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,7 @@ 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 compressImportMap(importMap: Required<ImportMap>): ImportMap;
+export declare function createImportMap({ manifests, getFile, getScope }: GetImportMapOptions): Required<ImportMap>;
+export declare function createClientImportMap(options: GetImportMapOptions): 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,15 +48,65 @@ export function fixNestedScopesResolution(importMap) {
   });
   return importMap;
 }
-export function getImportMap({
+export function compressImportMap(importMap) {
+  const compressed = {
+    imports: { ...importMap.imports },
+    scopes: {}
+  };
+  const counts = {};
+  Object.values(importMap.scopes).forEach((scopeMappings) => {
+    Object.entries(scopeMappings).forEach(([specifier, target]) => {
+      if (Object.hasOwn(importMap.imports, specifier)) return;
+      counts[specifier] ??= {};
+      counts[specifier][target] = (counts[specifier][target] ?? 0) + 1;
+    });
+  });
+  Object.entries(counts).forEach(([specifier, targetCounts]) => {
+    const entries = Object.entries(targetCounts);
+    let best = null;
+    let secondBestCount = 0;
+    for (const [t, c] of entries) {
+      if (!best || c > best[1]) {
+        secondBestCount = best ? Math.max(secondBestCount, best[1]) : secondBestCount;
+        best = [t, c];
+      } else {
+        secondBestCount = Math.max(secondBestCount, c);
+      }
+    }
+    if (best && best[1] > secondBestCount) {
+      compressed.imports[specifier] = best[0];
+    }
+  });
+  Object.entries(importMap.scopes).forEach(([scopePath, scopeMappings]) => {
+    const filtered = {};
+    Object.entries(scopeMappings).forEach(([specifier, target]) => {
+      const globalTarget = compressed.imports[specifier];
+      if (globalTarget === target) {
+        return;
+      }
+      filtered[specifier] = target;
+    });
+    if (Object.keys(filtered).length > 0) {
+      compressed.scopes[scopePath] = filtered;
+    }
+  });
+  const hasScopes = Object.keys(compressed.scopes).length > 0;
+  return hasScopes ? compressed : { imports: compressed.imports };
+}
+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
   };
 }
+export function createClientImportMap(options) {
+  const base = createImportMap(options);
+  const fixed = fixImportMapNestedScopes(base);
+  return compressImportMap(fixed);
+}