@esmx/core 3.0.0-rc.11 → 3.0.0-rc.111

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 Vanelink
+Copyright (c) 2020 Esmx Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,29 +1,61 @@
-# @esmx/core
-
-提供现代化的微前端解决方案和模块链接能力，为应用开发提供强大的基础支持。
-
-## 特性
-
-- 🚀 **原生微前端** - 基于 ESM + importmap 的原生模块加载，零运行时开销
-- 💡 **依赖管理** - 中心化的依赖管理，基于内容哈希的强缓存策略
-- 🎨 **应用隔离** - ESM 原生模块隔离，保障应用运行时的稳定性
-- 🛠️ **SSR 支持** - 灵活的服务端渲染策略，支持任意前端框架
-- 🔧 **开发体验** - 完整的 TypeScript 支持，原生模块链接能力
-
-## 安装
+<div align="center">
+  <img src="https://esmx.dev/logo.svg?t=2025" width="120" alt="Esmx Logo" />
+  <h1>@esmx/core</h1>
+  
+  <div>
+    <a href="https://www.npmjs.com/package/@esmx/core">
+      <img src="https://img.shields.io/npm/v/@esmx/core.svg" alt="npm version" />
+    </a>
+    <a href="https://github.com/esmnext/esmx/actions/workflows/build.yml">
+      <img src="https://github.com/esmnext/esmx/actions/workflows/build.yml/badge.svg" alt="Build" />
+    </a>
+    <a href="https://esmx.dev/coverage/">
+      <img src="https://img.shields.io/badge/coverage-live%20report-brightgreen" alt="Coverage Report" />
+    </a>
+    <a href="https://nodejs.org/">
+      <img src="https://img.shields.io/node/v/@esmx/core.svg" alt="node version" />
+    </a>
+    <a href="https://bundlephobia.com/package/@esmx/core">
+      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/core" alt="size" />
+    </a>
+  </div>
+  
+  <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>
+  </p>
+</div>
+
+## 🚀 Features
+
+- **Native Microfrontend** - Based on ESM + ImportMap for native module loading with zero runtime overhead
+- **Dependency Management** - Centralized dependency management with content-hash-based strong caching strategy
+- **Application Isolation** - ESM native module isolation ensuring runtime stability
+- **SSR Support** - Flexible server-side rendering strategy supporting any frontend framework
+- **Developer Experience** - Complete TypeScript support with native Module Linking capabilities
+
+## 📦 Installation
 
 ```bash
+# npm
+npm install @esmx/core
+
+# pnpm
 pnpm add @esmx/core
-# 或
+
+# yarn
 yarn add @esmx/core
-# 或
-npm install @esmx/core
 ```
 
-## 文档
+## 🚀 Quick Start
+
+See Quick Start guide: https://esmx.dev/guide/start/getting-started.html
+
+## 📚 Documentation
 
-访问 [@esmx/core 官方文档](https://www.esmnext.com) 获取详细的使用指南和 API 文档。
+Visit the [official documentation](https://esmx.dev) for detailed usage guides and API reference.
 
-## 许可证
+## 📄 License
 
-MIT
+MIT © [Esmx Team](https://github.com/esmnext/esmx)

package/README.zh-CN.md

@@ -0,0 +1,61 @@
+<div align="center">
+  <img src="https://esmx.dev/logo.svg?t=2025" width="120" alt="Esmx Logo" />
+  <h1>@esmx/core</h1>
+  
+  <div>
+    <a href="https://www.npmjs.com/package/@esmx/core">
+      <img src="https://img.shields.io/npm/v/@esmx/core.svg" alt="npm version" />
+    </a>
+    <a href="https://github.com/esmnext/esmx/actions/workflows/build.yml">
+      <img src="https://github.com/esmnext/esmx/actions/workflows/build.yml/badge.svg" alt="Build" />
+    </a>
+    <a href="https://esmx.dev/coverage/">
+      <img src="https://img.shields.io/badge/coverage-live%20report-brightgreen" alt="Coverage Report" />
+    </a>
+    <a href="https://nodejs.org/">
+      <img src="https://img.shields.io/node/v/@esmx/core.svg" alt="node version" />
+    </a>
+    <a href="https://bundlephobia.com/package/@esmx/core">
+      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/core" alt="size" />
+    </a>
+  </div>
+  
+  <p>支持 Vue、React、Preact、Solid、Svelte 的高性能微前端框架，具备 SSR 和模块链接能力</p>
+  
+  <p>
+    <a href="https://github.com/esmnext/esmx/blob/master/packages/core/README.md">English</a> | 中文
+  </p>
+</div>
+
+## 🚀 特性
+
+- **原生微前端** - 基于 ESM + ImportMap 的原生模块加载，零运行时开销
+- **依赖管理** - 中心化的依赖管理，基于内容哈希的强缓存策略
+- **应用隔离** - ESM 原生模块隔离，保障应用运行时的稳定性
+- **SSR 支持** - 灵活的服务端渲染策略，支持任意前端框架
+- **开发体验** - 完整的 TypeScript 支持，原生模块链接能力
+
+## 📦 安装
+
+```bash
+# npm
+npm install @esmx/core
+
+# pnpm
+pnpm add @esmx/core
+
+# yarn
+yarn add @esmx/core
+```
+
+## 🚀 快速开始
+
+查看快速开始指南：https://esmx.dev/zh-CN/guide/start/getting-started.html
+
+## 📚 文档
+
+访问[官方文档](https://esmx.dev)获取详细的使用指南和 API 参考。
+
+## 📄 许可证
+
+MIT © [Esmx Team](https://github.com/esmnext/esmx)

package/dist/app.d.ts

@@ -1,22 +1,22 @@
-import type { COMMAND, Esmx } from './esmx';
+import type { COMMAND, Esmx } from './core';
 import { RenderContext, type RenderContextOptions } from './render-context';
 import { type Middleware } from './utils/middleware';
 /**
- * 应用程序实例接口。
+ * Application instance interface.
  *
- * App 是 Esmx 框架的应用抽象，提供了统一的接口来管理应用的生命周期、
- * 静态资源和服务端渲染。
+ * App is the application abstraction of the Esmx framework, providing a unified interface
+ * to manage application lifecycle, static assets, and server-side rendering.
  *
  * @example
  * ```ts
  * // entry.node.ts
  * export default {
- *   // 开发环境配置
+ *   // Development environment configuration
  *   async devApp(esmx) {
  *     return import('@esmx/rspack').then((m) =>
  *       m.createRspackHtmlApp(esmx, {
  *         config(rc) {
- *           // 自定义 Rspack 配置
+ *           // Custom Rspack configuration
  *         }
  *       })
  *     );
@@ -26,17 +26,17 @@ import { type Middleware } from './utils/middleware';
  */
 export interface App {
     /**
-     * 静态资源处理中间件。
+     * Static asset processing middleware.
      *
-     * 开发环境：
-     * - 处理源码的静态资源请求
-     * - 支持实时编译和热更新
-     * - 使用 no-cache 缓存策略
+     * Development environment:
+     * - Handles static asset requests from source code
+     * - Supports real-time compilation and hot reloading
+     * - Uses no-cache strategy
      *
-     * 生产环境：
-     * - 处理构建后的静态资源
-     * - 支持不可变文件的长期缓存（.final.xxx）
-     * - 优化的资源加载策略
+     * Production environment:
+     * - Handles built static assets
+     * - Supports long-term caching for immutable files (.final.xxx)
+     * - Optimized asset loading strategy
      *
      * @example
      * ```ts
@@ -45,14 +45,14 @@ export interface App {
      */
     middleware: Middleware;
     /**
-     * 服务端渲染函数。
+     * Server-side rendering function.
      *
-     * 根据运行环境提供不同实现：
-     * - 生产环境（start）：加载构建后的服务端入口文件（entry.server）执行渲染
-     * - 开发环境（dev）：加载源码中的服务端入口文件执行渲染
+     * Provides different implementations based on the runtime environment:
+     * - Production environment (start): Loads the built server entry file (entry.server) to execute rendering
+     * - Development environment (dev): Loads the server entry file from source code to execute rendering
      *
-     * @param options - 渲染选项
-     * @returns 返回渲染上下文，包含渲染结果
+     * @param options - Rendering options
+     * @returns Returns the rendering context containing the rendering result
      *
      * @example
      * ```ts
@@ -64,21 +64,21 @@ export interface App {
      */
     render: (options?: RenderContextOptions) => Promise<RenderContext>;
     /**
-     * 生产环境构建函数。
-     * 用于资源打包和优化。
+     * Production environment build function.
+     * Used for asset packaging and optimization.
      *
-     * @returns 构建成功返回 true，失败返回 false
+     * @returns Returns true for successful build, false for failed build
      */
     build?: () => Promise<boolean>;
     /**
-     * 资源清理函数。
-     * 用于关闭服务器、断开连接等。
+     * Resource cleanup function.
+     * Used for shutting down servers, disconnecting connections, etc.
      *
-     * @returns 清理成功返回 true，失败返回 false
+     * @returns Returns true for successful cleanup, false for failed cleanup
      */
     destroy?: () => Promise<boolean>;
 }
 /**
- * 创建生产环境的应用程序实例，开发环境不可用。
+ * Create an application instance for production environment, not available in development environment.
  */
 export declare function createApp(esmx: Esmx, command: COMMAND): Promise<App>;

package/dist/app.mjs

@@ -12,7 +12,7 @@ export async function createApp(esmx, command) {
   };
 }
 async function createStartRender(esmx) {
-  const baseURL = pathToFileURL(esmx.root);
+  const baseURL = pathToFileURL(esmx.resolvePath("dist/server"));
   const importMap = await esmx.getImportMap("server");
   const loaderImport = createLoaderImport(baseURL, importMap);
   return async (options) => {

package/dist/cli/cli.mjs

@@ -1,14 +1,32 @@
 import module from "node:module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { COMMAND, Esmx } from "../esmx";
+import { styleText } from "node:util";
+import pkg from "../../package.json" with { type: "json" };
+import { COMMAND, Esmx } from "../core.mjs";
+import { resolveImportPath } from "../utils/resolve-path.mjs";
 async function getSrcOptions() {
-  return import(path.resolve(process.cwd(), "./src/entry.node.ts")).then(
+  return import(resolveImportPath(process.cwd(), "./src/entry.node.ts")).then(
     (m) => m.default
   );
 }
+async function getDistOptions() {
+  try {
+    const m = await import(resolveImportPath(process.cwd(), "./dist/node/src/entry.node.mjs"));
+    return m.default;
+  } catch (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) {
-  if (command !== COMMAND.dev) {
+  console.log(`\u{1F525} ${styleText("yellow", "Esmx")} v${pkg.version}
+    `);
+  if (command !== COMMAND.dev && typeof process.env.NODE_ENV === "undefined") {
     process.env.NODE_ENV = "production";
   }
   let esmx;
@@ -22,9 +40,12 @@ export async function cli(command) {
       opts = null;
       break;
     case COMMAND.start:
-      throw new Error(
-        `Please use 'NODE_ENV=production node dist/index.js' to run the built program`
-      );
+      opts = await getDistOptions();
+      esmx = new Esmx(opts);
+      exit(await esmx.init(COMMAND.start));
+      esmx = null;
+      opts = null;
+      break;
     case COMMAND.build:
       opts = await getSrcOptions();
       esmx = new Esmx(opts);
@@ -53,7 +74,7 @@ export async function cli(command) {
       opts = null;
       break;
     default:
-      await import(path.resolve(process.cwd(), command));
+      await import(resolveImportPath(process.cwd(), command));
       break;
   }
 }
@@ -62,7 +83,7 @@ function exit(ok) {
     process.exit(17);
   }
 }
-module.register(fileURLToPath(import.meta.url), {
+module.register(import.meta.url, {
   parentURL: import.meta.url
 });
 export function resolve(specifier, context, nextResolve) {

package/dist/cli/index.mjs

@@ -1,3 +1,8 @@
 #!/usr/bin/env node --no-warnings --experimental-vm-modules --experimental-import-meta-resolve --experimental-strip-types
+import { enableCompileCache } from "node:module";
+try {
+  enableCompileCache();
+} catch {
+}
 import { cli } from "./cli.mjs";
 cli(process.argv.slice(2)[0] || "");