@nasti-toolchain/nasti 2.4.2 → 2.4.3

package/README.md

@@ -22,7 +22,7 @@
 - **OXC 转译** - Rust 编写的 TS/JSX/TSX 转译器，比 Babel 快 20-50x
 - **Vite 插件兼容** - 直接使用现有 Vite/Rollup 插件（resolveId / load / transform）
 - **内置 React 支持** - JSX 自动转换 + React Fast Refresh HMR
-- **内置 Vue 支持** - SFC 编译 + Vue HMR（可选依赖 `@vue/compiler-sfc`）
+- **内置 Vue 支持** - SFC 编译 + Vue HMR；测试版支持 Vue 3.6 Vapor Mode（可选依赖 `@vue/compiler-sfc`）
 - **Electron 41+ 支持** - React/Vue renderer + 主进程 / Preload，支持 ESM 主进程
 - **Environment Driver** - 可桥接 Rspeedy 等非 Rolldown 工具链，含 build/dev/watch 生命周期
 - **Monaco Editor 集成** - 内置 `monacoEditorPlugin`，预打包 Web Worker，修复 HMR 期间的 EMFILE
@@ -198,6 +198,39 @@ export default defineConfig({
 })
 ```
 
+### Vapor Mode（测试版，需 Vue / `@vue/compiler-sfc` ≥ 3.6）
+
+若仍在使用 Vue 3.5，请先升级依赖（详见 [website/pages/vue.html](./website/pages/vue.html)）：
+
+```bash
+npm install vue@^3.6.0-rc.2
+npm install -D @vue/compiler-sfc@^3.6.0-rc.2
+```
+
+[Vapor Mode](https://github.com/vuejs/core/releases) 是 Vue 3.6 的 opt-in 编译模式，跳过 Virtual DOM，生成直接 DOM 操作。Nasti 支持单文件标记与环境级强制：
+
+```vue
+<!-- 单文件 opt-in -->
+<script setup vapor>
+import { ref } from 'vue'
+const count = ref(0)
+</script>
+```
+
+```ts
+// 环境级强制：对 <script setup> / 纯 template SFC 启用 Vapor
+export default defineConfig({
+  framework: 'vue',
+  environments: {
+    client: {
+      vue: { features: { vapor: true } },
+    },
+  },
+})
+```
+
+启用后，终端与浏览器控制台会打印测试版免责声明。Vapor Mode **不适合 SSR**；生产环境无崩溃保证，仅建议用于试验或局部性能热点。
+
 ## Electron 支持
 
 Nasti 原生支持 Electron，**最低 Electron 41**（对应 Node 22 / Chromium 138，完整 ESM 主进程）。

package/dist/cli.cjs

@@ -4349,8 +4349,10 @@ function vuePlugin(config, environmentName = "client") {
       });
       const scopeId = hashId(id);
       const wantsSourceMap = !!config.build.sourcemap || transformedSfc.map != null;
+      const vapor = resolveVaporMode(descriptor, vueOptions, sfc, config);
       let scriptCode = "";
       let scriptMap;
+      let scriptBindings;
       if (descriptor.script || descriptor.scriptSetup) {
         const inlineTemplate = vueOptions.script?.inlineTemplate !== false;
         const compiled = sfc.compileScript(descriptor, {
@@ -4362,9 +4364,11 @@ function vuePlugin(config, environmentName = "client") {
           // 让 compileScript 产出 `const __sfc__ = ...`（而非默认的 `export default {...}`）。
           // 否则下方追加的 `__sfc__.render` / `__sfc__.__scopeId` / HMR 记录会引用一个
           // 不存在的 `__sfc__`，并与 compileScript 自带的 `export default` 形成双重默认导出。
-          genDefaultAs: "__sfc__"
+          genDefaultAs: "__sfc__",
+          vapor
         });
         scriptCode = compiled.content;
+        scriptBindings = compiled.bindings;
         scriptMap = composeSourceMapChain(
           [compiled.map, transformedSfc.map],
           { filename: id, environmentName, type: "sfc" }
@@ -4378,7 +4382,9 @@ function vuePlugin(config, environmentName = "client") {
       }
       let templateCode = "";
       let templateMap;
+      let templateMultiRoot;
       const scriptSetupIsInline = !!descriptor.scriptSetup && vueOptions.script?.inlineTemplate !== false;
+      const isTemplateOnlyVapor = vapor && !descriptor.script && !descriptor.scriptSetup;
       if (descriptor.template && !scriptSetupIsInline) {
         const transformedTemplate = await applySourceTransform(
           vueOptions.transformTemplate,
@@ -4400,12 +4406,16 @@ function vuePlugin(config, environmentName = "client") {
           filename: id,
           id: scopeId,
           inMap: templateInputMap,
+          vapor,
           compilerOptions: {
             ...customCompilerOptions,
+            // Vapor 在 bindingMetadata 缺失时需要空对象（与 Vite / compiler-sfc 一致）
+            bindingMetadata: customCompilerOptions.bindingMetadata ?? scriptBindings ?? (vapor ? {} : void 0),
             scopeId: `data-v-${scopeId}`
           }
         });
         templateCode = compiled.code;
+        templateMultiRoot = compiled.multiRoot;
         if (wantsSourceMap || transformedTemplate.map != null) {
           templateMap = compiled.map;
         }
@@ -4443,12 +4453,20 @@ function vuePlugin(config, environmentName = "client") {
           outputNode.add(fragment);
         }
       };
-      append(scriptCode || "const __sfc__ = {}", scriptMap);
+      append(
+        scriptCode || (vapor ? "const __sfc__ = { __vapor: true }" : "const __sfc__ = {}"),
+        scriptMap
+      );
       if (templateCode) {
         append("\n");
         append(templateCode, templateMap);
         append("\n");
         append("\n__sfc__.render = render\n");
+        if (isTemplateOnlyVapor && templateMultiRoot !== void 0) {
+          append(`
+__sfc__.__multiRoot = ${JSON.stringify(templateMultiRoot)}
+`);
+        }
       }
       if (descriptor.styles.length > 0) {
         for (let i = 0; i < descriptor.styles.length; i++) {
@@ -4457,6 +4475,16 @@ import "${id}?vue&type=style&index=${i}&lang.css"
 `);
         }
       }
+      if (vapor) {
+        append(
+          `
+if (!globalThis.__NASTI_VAPOR_BETA_WARNED__) {
+  globalThis.__NASTI_VAPOR_BETA_WARNED__ = true
+  console.warn(${JSON.stringify(VAPOR_BETA_WARNING)})
+}
+`
+        );
+      }
       append(`
 __sfc__.__scopeId = "data-v-${scopeId}"
 `);
@@ -4516,6 +4544,32 @@ if (import.meta.hot) {
     }
   };
 }
+function resolveVaporMode(descriptor, vueOptions, sfc, config) {
+  const requested = !!descriptor.vapor || !!vueOptions.features?.vapor && canForceVaporMode(descriptor);
+  if (!requested) return false;
+  if (!supportsVaporCompiler(sfc)) {
+    config.logger.warnOnce(
+      "[nasti:vue] Vapor Mode requires @vue/compiler-sfc >= 3.6. Install it: npm install @vue/compiler-sfc@^3.6.0-0"
+    );
+    return false;
+  }
+  config.logger.warnOnce(VAPOR_BETA_WARNING);
+  return true;
+}
+function canForceVaporMode(descriptor) {
+  if (typeof descriptor.filename === "string" && descriptor.filename.endsWith(".vue")) {
+    if (descriptor.script && !descriptor.scriptSetup) return false;
+    return !!(descriptor.scriptSetup || descriptor.template);
+  }
+  return true;
+}
+function supportsVaporCompiler(sfc) {
+  const version = sfc.version;
+  if (!version) return false;
+  const [major, minor] = version.split(".").map((part) => Number.parseInt(part, 10));
+  if (!Number.isFinite(major) || !Number.isFinite(minor)) return false;
+  return major > 3 || major === 3 && minor >= 6;
+}
 async function applySourceTransform(transform2, source, context) {
   if (!transform2) return { code: source };
   const result = await transform2(source, context);
@@ -4576,7 +4630,7 @@ function warnUnchainableMap(context, reason) {
 function hashId(filename) {
   return import_node_crypto2.default.createHash("sha256").update(filename).digest("hex").slice(0, 8);
 }
-var import_node_crypto2, import_source_map_js2, VUE_FILE_RE, VUE_QUERY_RE, debug3, compiler;
+var import_node_crypto2, import_source_map_js2, VUE_FILE_RE, VUE_QUERY_RE, debug3, VAPOR_BETA_WARNING, compiler;
 var init_vue = __esm({
   "src/plugins/vue.ts"() {
     "use strict";
@@ -4587,6 +4641,7 @@ var init_vue = __esm({
     VUE_FILE_RE = /\.vue$/;
     VUE_QUERY_RE = /\.vue\?vue&type=(script|template|style)(&index=\d+)?(&lang[.=]\w+)?/;
     debug3 = createDebugger("nasti:vue");
+    VAPOR_BETA_WARNING = "Vapor Mode is a beta feature; Zixiao Labs and the Vue team do not provide guarantees against crashes in production environments, and it is not suitable for server-side rendering environments.";
     compiler = null;
   }
 });
@@ -5385,7 +5440,7 @@ async function build(inlineConfig = {}) {
   const startTime = performance.now();
   logger.info(
     import_picocolors6.default.cyan(`
-nasti v${"2.4.2"} `) + import_picocolors6.default.green(`building for ${config.mode}...`)
+nasti v${"2.4.3"} `) + import_picocolors6.default.green(`building for ${config.mode}...`)
   );
   debug6?.(`root: ${config.root}`);
   const buildableNames = Object.keys(config.environments).filter((name) => {
@@ -6408,7 +6463,7 @@ async function createServer(inlineConfig = {}) {
           const readyIn = Math.ceil(performance.now() - startTime);
           logger.info(
             `
-  ${import_picocolors8.default.cyan(import_picocolors8.default.bold("NASTI"))} ${import_picocolors8.default.cyan(`v${"2.4.2"}`)}  ${import_picocolors8.default.dim("ready in")} ${import_picocolors8.default.bold(readyIn)} ${import_picocolors8.default.dim("ms")}
+  ${import_picocolors8.default.cyan(import_picocolors8.default.bold("NASTI"))} ${import_picocolors8.default.cyan(`v${"2.4.3"}`)}  ${import_picocolors8.default.dim("ready in")} ${import_picocolors8.default.bold(readyIn)} ${import_picocolors8.default.dim("ms")}
 `
           );
           printServerUrls(
@@ -6606,7 +6661,7 @@ async function buildElectron(inlineConfig = {}) {
   const config = await resolveConfig({ ...inlineConfig, target: "electron" }, "build");
   const startTime = performance.now();
   assertElectronVersion(config);
-  console.log(import_picocolors9.default.cyan("\n\u26A1 nasti build (electron)") + import_picocolors9.default.dim(` v${"2.4.2"}`));
+  console.log(import_picocolors9.default.cyan("\n\u26A1 nasti build (electron)") + import_picocolors9.default.dim(` v${"2.4.3"}`));
   console.log(import_picocolors9.default.dim(`  root: ${config.root}`));
   console.log(import_picocolors9.default.dim(`  mode: ${config.mode}`));
   console.log(import_picocolors9.default.dim(`  target: electron (\u2265 ${config.electron.minVersion})`));
@@ -6785,7 +6840,7 @@ async function startElectronDev(inlineConfig = {}) {
   const { noSpawn, ...rest } = inlineConfig;
   const config = await resolveConfig({ ...rest, target: "electron" }, "serve");
   warnElectronVersion(config);
-  console.log(import_picocolors10.default.cyan("\n\u26A1 nasti electron dev") + import_picocolors10.default.dim(` v${"2.4.2"}`));
+  console.log(import_picocolors10.default.cyan("\n\u26A1 nasti electron dev") + import_picocolors10.default.dim(` v${"2.4.3"}`));
   const { createServer: createServer2 } = await Promise.resolve().then(() => (init_server(), server_exports));
   const server = await createServer2({
     ...rest,
@@ -7150,7 +7205,7 @@ cli.command("preview [root]", "Preview production build").option("--port <port>"
     const host = options.host === true ? "0.0.0.0" : options.host ?? "localhost";
     http2.createServer(app).listen(port, host, () => {
       logger.info(`
-  ${import_picocolors11.default.cyan(import_picocolors11.default.bold("NASTI"))} ${import_picocolors11.default.cyan(`v${"2.4.2"}`)}  ${import_picocolors11.default.dim("preview")}
+  ${import_picocolors11.default.cyan(import_picocolors11.default.bold("NASTI"))} ${import_picocolors11.default.cyan(`v${"2.4.3"}`)}  ${import_picocolors11.default.dim("preview")}
 `);
       printServerUrls2(
         {
@@ -7167,6 +7222,6 @@ cli.command("preview [root]", "Preview production build").option("--port <port>"
   }
 });
 cli.help();
-cli.version("2.4.2");
+cli.version("2.4.3");
 cli.parse();
 //# sourceMappingURL=cli.cjs.map