@nasti-toolchain/nasti 2.4.2 → 2.4.3

package/dist/index.d.cts

@@ -150,6 +150,17 @@ interface VueEnvironmentOptions {
     script?: Partial<SFCScriptCompileOptions>;
     template?: Partial<SFCTemplateCompileOptions>;
     style?: Partial<SFCAsyncStyleCompileOptions>;
+    /**
+     * Vue 编译特性开关。
+     *
+     * `vapor`：将可强制进入 Vapor Mode 的 SFC（`<script setup>` / 纯 template）
+     * 统一按 Vapor 编译。单文件仍可通过 `<script setup vapor>` / `<template vapor>`
+     * 按需 opt-in。需要 `@vue/compiler-sfc` ≥ 3.6。
+     * @experimental
+     */
+    features?: {
+        vapor?: boolean;
+    };
     transformSfc?: VueSfcSourceTransform;
     transformTemplate?: VueSfcSourceTransform;
     transformStyle?: VueSfcSourceTransform;

package/dist/index.d.ts

@@ -150,6 +150,17 @@ interface VueEnvironmentOptions {
     script?: Partial<SFCScriptCompileOptions>;
     template?: Partial<SFCTemplateCompileOptions>;
     style?: Partial<SFCAsyncStyleCompileOptions>;
+    /**
+     * Vue 编译特性开关。
+     *
+     * `vapor`：将可强制进入 Vapor Mode 的 SFC（`<script setup>` / 纯 template）
+     * 统一按 Vapor 编译。单文件仍可通过 `<script setup vapor>` / `<template vapor>`
+     * 按需 opt-in。需要 `@vue/compiler-sfc` ≥ 3.6。
+     * @experimental
+     */
+    features?: {
+        vapor?: boolean;
+    };
     transformSfc?: VueSfcSourceTransform;
     transformTemplate?: VueSfcSourceTransform;
     transformStyle?: VueSfcSourceTransform;

package/dist/index.js

@@ -2316,8 +2316,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, {
@@ -2329,9 +2331,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" }
@@ -2345,7 +2349,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,
@@ -2367,12 +2373,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;
         }
@@ -2410,12 +2420,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++) {
@@ -2424,6 +2442,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}"
 `);
@@ -2483,6 +2511,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);
@@ -2543,7 +2597,7 @@ function warnUnchainableMap(context, reason) {
 function hashId(filename) {
   return crypto2.createHash("sha256").update(filename).digest("hex").slice(0, 8);
 }
-var VUE_FILE_RE, VUE_QUERY_RE, debug2, compiler;
+var VUE_FILE_RE, VUE_QUERY_RE, debug2, VAPOR_BETA_WARNING, compiler;
 var init_vue = __esm({
   "src/plugins/vue.ts"() {
     "use strict";
@@ -2552,6 +2606,7 @@ var init_vue = __esm({
     VUE_FILE_RE = /\.vue$/;
     VUE_QUERY_RE = /\.vue\?vue&type=(script|template|style)(&index=\d+)?(&lang[.=]\w+)?/;
     debug2 = 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;
   }
 });
@@ -3811,7 +3866,7 @@ async function build(inlineConfig = {}) {
   const startTime = performance.now();
   logger.info(
     pc4.cyan(`
-nasti v${"2.4.2"} `) + pc4.green(`building for ${config.mode}...`)
+nasti v${"2.4.3"} `) + pc4.green(`building for ${config.mode}...`)
   );
   debug5?.(`root: ${config.root}`);
   const buildableNames = Object.keys(config.environments).filter((name) => {
@@ -6414,7 +6469,7 @@ async function createServer(inlineConfig = {}) {
           const readyIn = Math.ceil(performance.now() - startTime);
           logger.info(
             `
-  ${pc9.cyan(pc9.bold("NASTI"))} ${pc9.cyan(`v${"2.4.2"}`)}  ${pc9.dim("ready in")} ${pc9.bold(readyIn)} ${pc9.dim("ms")}
+  ${pc9.cyan(pc9.bold("NASTI"))} ${pc9.cyan(`v${"2.4.3"}`)}  ${pc9.dim("ready in")} ${pc9.bold(readyIn)} ${pc9.dim("ms")}
 `
           );
           printServerUrls(
@@ -6605,7 +6660,7 @@ async function buildElectron(inlineConfig = {}) {
   const config = await resolveConfig({ ...inlineConfig, target: "electron" }, "build");
   const startTime = performance.now();
   assertElectronVersion(config);
-  console.log(pc5.cyan("\n\u26A1 nasti build (electron)") + pc5.dim(` v${"2.4.2"}`));
+  console.log(pc5.cyan("\n\u26A1 nasti build (electron)") + pc5.dim(` v${"2.4.3"}`));
   console.log(pc5.dim(`  root: ${config.root}`));
   console.log(pc5.dim(`  mode: ${config.mode}`));
   console.log(pc5.dim(`  target: electron (\u2265 ${config.electron.minVersion})`));
@@ -6778,7 +6833,7 @@ async function startElectronDev(inlineConfig = {}) {
   const { noSpawn, ...rest } = inlineConfig;
   const config = await resolveConfig({ ...rest, target: "electron" }, "serve");
   warnElectronVersion(config);
-  console.log(pc10.cyan("\n\u26A1 nasti electron dev") + pc10.dim(` v${"2.4.2"}`));
+  console.log(pc10.cyan("\n\u26A1 nasti electron dev") + pc10.dim(` v${"2.4.3"}`));
   const { createServer: createServer2 } = await Promise.resolve().then(() => (init_server(), server_exports));
   const server = await createServer2({
     ...rest,