@nasti-toolchain/nasti 2.2.0 → 2.4.0

package/README.md

@@ -23,7 +23,8 @@
 - **Vite 插件兼容** - 直接使用现有 Vite/Rollup 插件（resolveId / load / transform）
 - **内置 React 支持** - JSX 自动转换 + React Fast Refresh HMR
 - **内置 Vue 支持** - SFC 编译 + Vue HMR（可选依赖 `@vue/compiler-sfc`）
-- **Electron 41+ 支持** - 一键构建主进程 / Preload / 渲染进程，支持 ESM 主进程
+- **Electron 41+ 支持** - React/Vue renderer + 主进程 / Preload，支持 ESM 主进程
+- **Environment Driver** - 可桥接 Rspeedy 等非 Rolldown 工具链，含 build/dev/watch 生命周期
 - **Monaco Editor 集成** - 内置 `monacoEditorPlugin`，预打包 Web Worker，修复 HMR 期间的 EMFILE
 - **Dev Server + HMR** - 开发服务器 + WebSocket 热模块替换
 - **TypeScript 优先** - 原生 TS 支持，零配置
@@ -210,9 +211,11 @@ import { defineConfig } from '@nasti-toolchain/nasti'
 
 export default defineConfig({
   target: 'electron',
+  framework: 'auto',                    // 自动识别 React / Vue
   electron: {
     main: 'src/electron/main.ts',        // 主进程入口
     preload: 'src/electron/preload.ts',  // Preload 脚本（可传数组）
+    renderer: 'src/renderer/index.html', // React / Vue renderer HTML
     mainFormat: 'cjs',                   // 主进程输出格式：'cjs' | 'esm'
     preloadFormat: 'cjs',                // Preload 输出格式
     nodeTarget: 'node22',                // Electron 41 捆绑 Node 22
@@ -222,6 +225,19 @@ export default defineConfig({
 })
 ```
 
+Vue renderer 直接使用标准 SFC：
+
+```ts
+// src/renderer/main.ts
+import { createApp } from 'vue'
+import App from './App.vue'
+
+createApp(App).mount('#app')
+```
+
+生产 renderer 默认使用 `base: './'`，因此 `BrowserWindow.loadFile()` 可以正确加载
+hashed JS/CSS；显式配置其他 `base` 时保留用户值。
+
 开发：
 
 ```bash
@@ -269,6 +285,89 @@ app.whenReady().then(createWindow)
 
 > 详细说明见 [Electron 指南](https://nasti.zixiaolabs.com/pages/electron.html)。
 
+## External Environment Driver
+
+Rspeedy 等外部工具链可以接管单个环境，同时保留 Nasti 的 CLI、日志与多环境编排：
+
+```ts
+export default defineConfig({
+  environments: {
+    lynx: {
+      consumer: 'client',
+      driver: 'rspeedy',
+    },
+  },
+  plugins: [pluginRspeedyBridge()],
+})
+```
+
+bridge 插件通过 `createEnvironmentDriver()` 提供 `build`、`serve`、`watchChange`
+和 `close`，并可使用 `setup(api)`、`api.expose/useExposed` 与
+`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'] },
+    },
+  },
+  plugins: [pluginVueLynxNative()],
+})
+```
+
+Environment API 是 `conditionNames` 和 `mainFields` 的唯一高层配置入口：
+请使用 `environments.<name>.resolve.conditions` / `mainFields`（client 也可使用
+top-level `resolve`）。这些值会无条件覆盖
+`build.rolldownOptions.resolve.conditionNames` / `mainFields` 中的对应底层选项。
+
+在生产构建的 bundle/finalizer 相关钩子（如 `generateBundle`、`buildEnd`、
+`closeBundle`）中，`this.environment` 会准确指向当前 BG/MT 环境。unbundled
+dev 调用路径可能不提供该对象，开发期插件不得依赖 `this.environment`；应使用
+Environment API 的显式环境参数。插件可登记结构化 manifest，并在 app 级
+finalizer 中直接查询 entry/artifact，最后写出聚合 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` 及完整 `output`；app 级产物同时出现在 `BuildResult.appOutput`。
+这些 API 只负责双线程编排与聚合，Vue SFC/worklet、Lynx CSS 和 encoder 由后续工具链插件实现。
+
 ## Monaco Editor 支持
 
 内置 `monacoEditorPlugin`（对标 `vite-plugin-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>
 }