@esmx/core 3.0.0-rc.10

package/README.md

@@ -0,0 +1,29 @@
+# @esmx/core
+
+提供现代化的微前端解决方案和模块链接能力，为应用开发提供强大的基础支持。
+
+## 特性
+
+- 🚀 **原生微前端** - 基于 ESM + importmap 的原生模块加载，零运行时开销
+- 💡 **依赖管理** - 中心化的依赖管理，基于内容哈希的强缓存策略
+- 🎨 **应用隔离** - ESM 原生模块隔离，保障应用运行时的稳定性
+- 🛠️ **SSR 支持** - 灵活的服务端渲染策略，支持任意前端框架
+- 🔧 **开发体验** - 完整的 TypeScript 支持，原生模块链接能力
+
+## 安装
+
+```bash
+pnpm add @esmx/core
+# 或
+yarn add @esmx/core
+# 或
+npm install @esmx/core
+```
+
+## 文档
+
+访问 [@esmx/core 官方文档](https://www.esmnext.com) 获取详细的使用指南和 API 文档。
+
+## 许可证
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,84 @@
+import type { COMMAND, Esmx } from './esmx';
+import { RenderContext, type RenderContextOptions } from './render-context';
+import { type Middleware } from './utils/middleware';
+/**
+ * 应用程序实例接口。
+ *
+ * App 是 Esmx 框架的应用抽象，提供了统一的接口来管理应用的生命周期、
+ * 静态资源和服务端渲染。
+ *
+ * @example
+ * ```ts
+ * // entry.node.ts
+ * export default {
+ *   // 开发环境配置
+ *   async devApp(esmx) {
+ *     return import('@esmx/rspack').then((m) =>
+ *       m.createRspackHtmlApp(esmx, {
+ *         config(rc) {
+ *           // 自定义 Rspack 配置
+ *         }
+ *       })
+ *     );
+ *   }
+ * }
+ * ```
+ */
+export interface App {
+    /**
+     * 静态资源处理中间件。
+     *
+     * 开发环境：
+     * - 处理源码的静态资源请求
+     * - 支持实时编译和热更新
+     * - 使用 no-cache 缓存策略
+     *
+     * 生产环境：
+     * - 处理构建后的静态资源
+     * - 支持不可变文件的长期缓存（.final.xxx）
+     * - 优化的资源加载策略
+     *
+     * @example
+     * ```ts
+     * server.use(esmx.middleware);
+     * ```
+     */
+    middleware: Middleware;
+    /**
+     * 服务端渲染函数。
+     *
+     * 根据运行环境提供不同实现：
+     * - 生产环境（start）：加载构建后的服务端入口文件（entry.server）执行渲染
+     * - 开发环境（dev）：加载源码中的服务端入口文件执行渲染
+     *
+     * @param options - 渲染选项
+     * @returns 返回渲染上下文，包含渲染结果
+     *
+     * @example
+     * ```ts
+     * const rc = await esmx.render({
+     *   params: { url: '/page' }
+     * });
+     * res.end(rc.html);
+     * ```
+     */
+    render: (options?: RenderContextOptions) => Promise<RenderContext>;
+    /**
+     * 生产环境构建函数。
+     * 用于资源打包和优化。
+     *
+     * @returns 构建成功返回 true，失败返回 false
+     */
+    build?: () => Promise<boolean>;
+    /**
+     * 资源清理函数。
+     * 用于关闭服务器、断开连接等。
+     *
+     * @returns 清理成功返回 true，失败返回 false
+     */
+    destroy?: () => Promise<boolean>;
+}
+/**
+ * 创建生产环境的应用程序实例，开发环境不可用。
+ */
+export declare function createApp(esmx: Esmx, command: COMMAND): Promise<App>;

package/dist/app.mjs

@@ -0,0 +1,34 @@
+import { pathToFileURL } from "node:url";
+import { createLoaderImport } from "@esmx/import";
+import {
+  RenderContext
+} from "./render-context.mjs";
+import { createMiddleware } from "./utils/middleware.mjs";
+export async function createApp(esmx, command) {
+  const render = command === esmx.COMMAND.start ? await createStartRender(esmx) : createErrorRender(esmx);
+  return {
+    middleware: createMiddleware(esmx),
+    render
+  };
+}
+async function createStartRender(esmx) {
+  const baseURL = pathToFileURL(esmx.root);
+  const importMap = await esmx.getImportMap("server");
+  const loaderImport = createLoaderImport(baseURL, importMap);
+  return async (options) => {
+    const rc = new RenderContext(esmx, options);
+    const result = await loaderImport(`${esmx.name}/src/entry.server`);
+    const serverRender = result[rc.entryName];
+    if (typeof serverRender === "function") {
+      await serverRender(rc);
+    }
+    return rc;
+  };
+}
+function createErrorRender(esmx) {
+  return (options) => {
+    throw new Error(
+      `App instance is only available in production and can only execute built artifacts.`
+    );
+  };
+}

package/dist/cli/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function cli(command: string): Promise<void>;
+export declare function resolve(specifier: string, context: Record<string, any>, nextResolve: Function): any;

package/dist/cli/cli.mjs

@@ -0,0 +1,73 @@
+import module from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { COMMAND, Esmx } from "../esmx";
+async function getSrcOptions() {
+  return import(path.resolve(process.cwd(), "./src/entry.node.ts")).then(
+    (m) => m.default
+  );
+}
+export async function cli(command) {
+  if (command !== COMMAND.dev) {
+    process.env.NODE_ENV = "production";
+  }
+  let esmx;
+  let opts = null;
+  switch (command) {
+    case COMMAND.dev:
+      opts = await getSrcOptions();
+      esmx = new Esmx(opts);
+      exit(await esmx.init(COMMAND.dev));
+      esmx = null;
+      opts = null;
+      break;
+    case COMMAND.start:
+      throw new Error(
+        `Please use 'NODE_ENV=production node dist/index.js' to run the built program`
+      );
+    case COMMAND.build:
+      opts = await getSrcOptions();
+      esmx = new Esmx(opts);
+      exit(await esmx.init(COMMAND.build));
+      exit(await esmx.destroy());
+      if (typeof opts.postBuild === "function") {
+        esmx = new Esmx({
+          ...opts,
+          server: void 0
+        });
+        exit(await esmx.init(COMMAND.start));
+        exit(await esmx.postBuild());
+      }
+      esmx = null;
+      opts = null;
+      break;
+    case COMMAND.preview:
+      opts = await getSrcOptions();
+      esmx = new Esmx(opts);
+      exit(await esmx.init(COMMAND.build));
+      exit(await esmx.destroy());
+      esmx = new Esmx(opts);
+      exit(await esmx.init(COMMAND.start));
+      exit(await esmx.postBuild());
+      esmx = null;
+      opts = null;
+      break;
+    default:
+      await import(path.resolve(process.cwd(), command));
+      break;
+  }
+}
+function exit(ok) {
+  if (!ok) {
+    process.exit(17);
+  }
+}
+module.register(fileURLToPath(import.meta.url), {
+  parentURL: import.meta.url
+});
+export function resolve(specifier, context, nextResolve) {
+  if (context?.parentURL.endsWith(".ts") && specifier.startsWith(".") && !specifier.endsWith(".ts")) {
+    return nextResolve(specifier + ".ts", context);
+  }
+  return nextResolve(specifier, context);
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node --no-warnings --experimental-vm-modules --experimental-import-meta-resolve --experimental-strip-types
+export {};

package/dist/cli/index.mjs

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