@nasti-toolchain/nasti 2.3.1 → 2.4.1

package/README.md

@@ -31,6 +31,8 @@
 
 ## Quick Start
 
+Requires Node.js `^20.19.0` or `>=22.12.0`.
+
 ```bash
 # 安装
 npm install -D @nasti-toolchain/nasti
@@ -303,7 +305,101 @@ export default defineConfig({
 
 bridge 插件通过 `createEnvironmentDriver()` 提供 `build`、`serve`、`watchChange`
 和 `close`，并可使用 `setup(api)`、`api.expose/useExposed` 与
-`afterBuildApp()` 协调多个插件或环境。
+`afterBuildApp(results, api, context)` 协调多个插件或环境。
+
+## 原生多环境聚合（Lynx BG / MT）
+
+纯 Lynx 应用可以禁用默认 Web client，把同一入口交给两套独立的 client-consumer
+Rolldown 环境。每套环境都有独立 module graph、resolve conditions、插件上下文和输出目录：
+
+```ts
+export default defineConfig({
+  environments: {
+    client: { buildEnabled: false },
+    'lynx-background': {
+      consumer: 'client',
+      entry: 'src/index.ts',
+      resolve: { conditions: ['lynx-background', 'browser', 'import'] },
+    },
+    'lynx-main-thread': {
+      consumer: 'client',
+      entry: 'src/index.ts',
+      resolve: { conditions: ['lynx-main-thread', 'browser', 'import'] },
+      build: {
+        target: 'es2019',
+        // 保留 CSS 模块图与 chunk 所有权，但不生成浏览器副作用/文件。
+        css: { inject: false, emit: false },
+      },
+      vue: {
+        template: { compilerOptions: { whitespace: 'condense' } },
+        transformTemplate(source, context) {
+          return transformLynxTemplate(source, context.environmentName)
+        },
+      },
+    },
+  },
+  plugins: [pluginVueLynxNative()],
+})
+```
+
+Environment API 是 `conditionNames` 和 `mainFields` 的唯一高层配置入口：
+请使用 `environments.<name>.resolve.conditions` / `mainFields`（client 也可使用
+top-level `resolve`）。这些值会无条件覆盖
+`build.rolldownOptions.resolve.conditionNames` / `mainFields` 中的对应底层选项。
+
+生产与 dev 插件钩子的 `this.environment` 都会准确指向当前 BG/MT 环境。
+每个 client-consumer 环境拥有独立的 module graph、transform 缓存和命名 HMR
+通道；工具链可以调用 `server.transformEnvironmentRequest(name, url)`（或
+`server.environments[name].transformRequest(url)`）取得特定环境的转换结果。
+`handleHotUpdateApp` 在一个文件完成所有环境的失效与重转后只调用一次：
+
+```ts
+const pluginVueLynxNative = () => ({
+  name: 'vue-lynx:native',
+
+  async handleHotUpdateApp({ environments }) {
+    for (const [name, update] of Object.entries(environments)) {
+      await reencodeAffectedSections(name, update.transformed)
+    }
+  },
+})
+```
+
+CSS 原文/转换结果可从 `environment.getCssModule(id)` /
+`environment.getCssModules()` 读取，无需解析浏览器 `<style>` 注入代码。
+生产插件还可登记结构化 manifest，并在 app 级 finalizer 中直接查询
+entry、chunk、CSS、asset 和 source map，最后写出聚合 bundle：
+
+```ts
+const pluginVueLynxNative = () => ({
+  name: 'vue-lynx:native',
+
+  generateBundle() {
+    this.environment.setBuildMetadata({
+      manifest: { thread: this.environment.name },
+    })
+  },
+
+  afterBuildApp(_results, _api, app) {
+    const background = app.getEntry('lynx-background', 'index')
+    const mainThread = app.getEntry('lynx-main-thread', 'index')
+    if (!background || !mainThread) throw new Error('Missing Lynx thread entry')
+
+    app.emitFile({
+      type: 'asset',
+      fileName: 'main.native.lynx.bundle',
+      source: encodeLynxBundle({ background, mainThread }),
+    })
+  },
+})
+```
+
+`build()` 的 `environmentResults` 会包含原生环境自动推导的 `entries`、插件登记的
+`manifest/stats`、`chunks/assets/css/sourceMaps` 及完整 `output`；对应的
+`BuildAppContext.getChunk/getCss/getSourceMap/resolvePublicPath` 可跨环境关联初始与
+lazy chunk。app 级产物同时出现在 `BuildResult.appOutput`。高层
+`environments.<name>.build.target` 会同时应用于 OXC 的 TS/JSX 转换和 Rolldown
+的最终输出，无需再设置底层 `rolldownOptions.transform.target`。
 
 ## Monaco Editor 支持
 

package/client/hmr.ts

@@ -3,10 +3,11 @@
 
 export interface HotModule {
   accept(cb?: (mod: any) => void): void
+  accept(dep: string, cb: (mod: any) => void): void
   accept(deps: string[], cb: (mods: any[]) => void): void
-  dispose(cb: (data: any) => void): void
-  prune(cb: () => void): void
-  invalidate(): void
+  dispose(cb: (data: Record<string, any>) => void | Promise<void>): void
+  prune(cb: (data: Record<string, any>) => void | Promise<void>): void
+  invalidate(message?: string): void
   data: Record<string, any>
 }