@proteus-vue/plugin-vite 0.2.0-beta.2 → 0.2.0-beta.5

package/dist/gen-routes.d.ts

@@ -20,6 +20,17 @@ export interface GenRoutesOptions {
         dependencies?: Record<string, string>;
         preload?: string[];
     }>;
+    /**
+     * ★Web 目标只生成**应用侧路由表**（2026-09-19 修外部实战报告的第 3 条阻断项）：
+     *   `auto-routes.ts` 是 **双端共用** 产物（Web 的 RouterView 与 MP 的 app.json 同源），
+     *   但此前 gen-routes 只在 MP 目标被调用（`needsGenRoutes: isMp`）→ 使用 `proteus build --target web`
+     *   的工程新增页面后路由表不更新 → **页面 404**（外部项目实测：新增 `src/pages/editor/` 后
+     *   Web 构建成功但路由表未收录）。
+     *   `webOnly: true` 时：只 `scanPages → buildRoutes → validate → writeAutoRoutes`，
+     *   **跳过 MP 专属产物**（app.json/page.json/component.json/project.config.json，web 构建不需要）
+     *   且**不清理 `dist/mp-weixin`**（否则会把已构建的 MP 产物删掉——那不属于 web 构建的职责）。
+     */
+    webOnly?: boolean;
 }
 /**
  * 运行路由表生成（纯函数，可单测）：清理 dist 产物 → 扫描页面 → 生成 auto-routes/app.json/page.json/component.json

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/plugin.ts
-import fs4 from "node:fs";
-import path4 from "node:path";
+import fs5 from "node:fs";
+import path5 from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 
 // ../types/src/router-config.ts
@@ -294,6 +294,10 @@ function runGenRoutes(options) {
     return `  { ${parts.join(", ")} },`;
   }
   function writeAutoRoutes(routes2) {
+    if (!rc.routesOutput) {
+      console.log("[gen-routes] routesOutput \u4E3A\u7A7A \u2192 \u6309\u914D\u7F6E**\u8DF3\u8FC7**\u5E94\u7528\u4FA7\u8DEF\u7531\u8868\u751F\u6210\uFF08\u5DE5\u7A0B\u81EA\u5E26\u8DEF\u7531\u673A\u5236\uFF09");
+      return;
+    }
     const lines = [
       `// ${rc.routesOutput} \u2014\u2014 \u5E94\u7528\u4FA7\u8DEF\u7531\u8868\uFF08AUTO-GENERATED by scripts/gen-routes.ts\uFF0C\u52FF\u624B\u52A8\u7F16\u8F91\uFF09`,
       "// \u2605\u62C6\u5305\u6B65\u9AA4 4\uFF1Aauto-routes \u968F\u5E94\u7528\u5B58\u653E\uFF08\u5DE5\u5382\u5316\u540E\u8DEF\u7531\u8868\u7531\u5E94\u7528\u6CE8\u5165 createRouter\uFF09\uFF0C\u4E0D\u518D\u5C5E\u4E8E @proteus-vue/router \u5305",
@@ -555,7 +559,7 @@ function runGenRoutes(options) {
     "details",
     "summary"
   ]);
-  function extractTemplateBody(src) {
+  function extractTemplateBody2(src) {
     const n = src.length;
     let i = 0;
     while (i < n) {
@@ -611,7 +615,7 @@ function runGenRoutes(options) {
   }
   function collectComponents(file, skipSemantic = false) {
     const src = fs2.readFileSync(file, "utf-8");
-    const tpl = extractTemplateBody(src);
+    const tpl = extractTemplateBody2(src);
     const customTags = new Set(Object.keys(config.rules?.customTags ?? {}));
     const gridRuleDisabled = (config.rules?.disabled ?? []).includes("fluid/semantic-grid");
     const semanticTags = skipSemantic && !gridRuleDisabled ? /* @__PURE__ */ new Set(["p-grid"]) : /* @__PURE__ */ new Set();
@@ -715,10 +719,15 @@ function runGenRoutes(options) {
     fs2.writeFileSync(path2.join(OUT_DIR, "project.config.json"), JSON.stringify(projectConfig, null, 2) + "\n");
     console.log(`[gen-routes] \u5DF2\u751F\u6210 dist/mp-weixin/project.config.json\uFF08appid=${config.appid}\uFF0Cprojectname=${projectName}\uFF09`);
   }
-  fs2.rmSync(OUT_DIR, { recursive: true, force: true });
   const pages = scanPages();
   const routes = buildRoutes(pages);
   validate(pages, routes);
+  if (options.webOnly) {
+    writeAutoRoutes(routes);
+    console.log(`[gen-routes] \uFF08web \u76EE\u6807\uFF09\u5DF2\u66F4\u65B0\u5E94\u7528\u4FA7\u8DEF\u7531\u8868\uFF1A\u5171 ${pages.length} \u4E2A\u9875\u9762`);
+    return;
+  }
+  fs2.rmSync(OUT_DIR, { recursive: true, force: true });
   writeAutoRoutes(routes);
   writeAppJson(pages, routes);
   writePageJsons(pages);
@@ -898,6 +907,138 @@ function createBundleCache(cacheDir) {
   };
 }
 
+// src/tag-scan.ts
+import fs4 from "node:fs";
+import path4 from "node:path";
+function extractTemplateBody(src) {
+  const n = src.length;
+  let i = 0;
+  while (i < n) {
+    const lt = src.indexOf("<", i);
+    if (lt < 0) return "";
+    if (src.startsWith("<!--", lt)) {
+      const e = src.indexOf("-->", lt + 4);
+      i = e < 0 ? n : e + 3;
+      continue;
+    }
+    const block = /^<(script|style)\b/i.exec(src.slice(lt, lt + 32));
+    if (block) {
+      const tag = block[1].toLowerCase();
+      const end = src.toLowerCase().indexOf(`</${tag}`, lt + block[0].length);
+      if (end < 0) return "";
+      const gt = src.indexOf(">", end);
+      i = gt < 0 ? n : gt + 1;
+      continue;
+    }
+    if (/^<template[\s>]/i.test(src.slice(lt, lt + 16))) {
+      const gt = src.indexOf(">", lt);
+      if (gt < 0) return "";
+      let depth = 1;
+      let j = gt + 1;
+      while (j < n) {
+        const l2 = src.indexOf("<", j);
+        if (l2 < 0) return src.slice(gt + 1);
+        if (src.startsWith("<!--", l2)) {
+          const e = src.indexOf("-->", l2 + 4);
+          j = e < 0 ? n : e + 3;
+          continue;
+        }
+        const seg = src.slice(l2, l2 + 16);
+        if (/^<\/template[\s>]/i.test(seg)) {
+          depth--;
+          if (depth === 0) return src.slice(gt + 1, l2);
+          j = l2 + "</template>".length;
+          continue;
+        }
+        if (/^<template[\s>]/i.test(seg)) {
+          depth++;
+          const g2 = src.indexOf(">", l2);
+          j = g2 < 0 ? n : g2 + 1;
+          continue;
+        }
+        j = l2 + 1;
+      }
+      return src.slice(gt + 1);
+    }
+    i = lt + 1;
+  }
+  return "";
+}
+function extractTags(tpl) {
+  const out = /* @__PURE__ */ new Set();
+  let idx = 0;
+  while (idx < tpl.length) {
+    const lt = tpl.indexOf("<", idx);
+    if (lt < 0) break;
+    if (tpl.startsWith("<!--", lt)) {
+      const e = tpl.indexOf("-->", lt + 4);
+      idx = e < 0 ? tpl.length : e + 3;
+      continue;
+    }
+    if (tpl.startsWith("</", lt)) {
+      idx = lt + 2;
+      continue;
+    }
+    const mm = /^([A-Za-z][\w-]*)/.exec(tpl.slice(lt + 1));
+    if (!mm) {
+      idx = lt + 1;
+      continue;
+    }
+    const raw = mm[1];
+    out.add(/[A-Z]/.test(raw) ? raw.replace(/\B([A-Z])/g, "-$1").toLowerCase() : raw);
+    idx = lt + 1 + mm[0].length;
+  }
+  return out;
+}
+function collectCompilerEmittedTags(templateBody) {
+  const out = /* @__PURE__ */ new Set();
+  if (/<(?:svg|circle|rect|ellipse|path|line|polyline|polygon)[\s>][\s\S]*?<animate\b/i.test(templateBody)) {
+    const shapeAnim = /<animate\s[^>]*attributeName\s*=\s*["'](cx|cy|r|rx|ry|x|y|width|height|d|points|stroke-dashoffset|stroke-dasharray)["']/i;
+    if (shapeAnim.test(templateBody)) out.add("p-svg-canvas");
+  }
+  return out;
+}
+function resolveComponentFile(componentsDir, tag) {
+  const dirIndex = path4.join(componentsDir, tag, "index.vue");
+  if (fs4.existsSync(dirIndex)) return dirIndex;
+  const flat = path4.join(componentsDir, `${tag}.vue`);
+  if (fs4.existsSync(flat)) return flat;
+  return null;
+}
+function collectUsedFrameworkComponents(pageFiles, componentsDir) {
+  const used = /* @__PURE__ */ new Set();
+  const visitedFiles = /* @__PURE__ */ new Set();
+  const queue = [...pageFiles];
+  while (queue.length) {
+    const file = queue.pop();
+    if (visitedFiles.has(file)) continue;
+    visitedFiles.add(file);
+    if (!fs4.existsSync(file)) continue;
+    let tags;
+    const body = (() => {
+      try {
+        return extractTemplateBody(fs4.readFileSync(file, "utf-8"));
+      } catch {
+        return "";
+      }
+    })();
+    try {
+      tags = extractTags(body);
+      for (const t of collectCompilerEmittedTags(body)) tags.add(t);
+    } catch {
+      continue;
+    }
+    for (const tag of tags) {
+      if (used.has(tag)) continue;
+      const compFile = resolveComponentFile(componentsDir, tag);
+      if (!compFile) continue;
+      used.add(tag);
+      queue.push(compFile);
+    }
+  }
+  return used;
+}
+
 // src/plugin.ts
 var MP_TAG_MAP = {
   view: "proteus-view",
@@ -925,7 +1066,15 @@ var MP_ONLY_TAGS = /* @__PURE__ */ new Set([
   "share-element",
   "keyboard-accessory",
   "cover-view",
-  "cover-image"
+  "cover-image",
+  // ★端对齐批次3（2026-09-16）：宿主能力组件的 MP 原生标签——其模板用 v-if 双分支
+  //   （MP 原生 / Web 降级），Web 端死分支不渲染但会被 resolveComponent 提升解析 → 声明为自定义元素消除告警。
+  "rich-text",
+  "map",
+  "camera",
+  "canvas",
+  "ad",
+  "web-view"
 ]);
 function defaultScopedPlugin() {
   return {
@@ -960,13 +1109,13 @@ function resolvePkgPath(projectRoot, modPath) {
   const m = modPath.match(/^node_modules\/((?:@[^/]+\/)?[^/]+)\/([\s\S]+)$/);
   if (m) {
     try {
-      const pkgRequire = createRequire3(path4.join(projectRoot, "package.json"));
-      const pkgRoot = path4.dirname(pkgRequire.resolve(`${m[1]}/package.json`));
-      return path4.join(pkgRoot, m[2]);
+      const pkgRequire = createRequire3(path5.join(projectRoot, "package.json"));
+      const pkgRoot = path5.dirname(pkgRequire.resolve(`${m[1]}/package.json`));
+      return path5.join(pkgRoot, m[2]);
     } catch {
     }
   }
-  return path4.join(projectRoot, modPath);
+  return path5.join(projectRoot, modPath);
 }
 function preprocessStyle(lang, content) {
   if (lang === "scss" || lang === "sass") {
@@ -984,11 +1133,11 @@ function preprocessStyle(lang, content) {
   return content;
 }
 function loadStyleSrcWithVariant(src, fromFilename, platform = "mp") {
-  const base = path4.resolve(path4.dirname(fromFilename), src);
-  const hit = resolvePlatformVariant(base, platform, fs4.existsSync);
+  const base = path5.resolve(path5.dirname(fromFilename), src);
+  const hit = resolvePlatformVariant(base, platform, fs5.existsSync);
   if (!hit) return null;
   try {
-    return fs4.readFileSync(hit, "utf-8");
+    return fs5.readFileSync(hit, "utf-8");
   } catch {
     return null;
   }
@@ -997,10 +1146,10 @@ var VENDOR_SINGLETONS = ["pinia", "vue", "@vue/devtools-api"];
 function resolveSharedModule(appDir, absFrom, source, frameworkDir, resolveFrom, platform = "mp") {
   if (source.startsWith("@proteus-vue/")) {
     try {
-      const resolver = resolveFrom ? createRequire3(path4.join(resolveFrom, "package.json")) : require2;
-      const pkgRoot = path4.dirname(resolver.resolve(`${source}/package.json`));
-      const entry = path4.join(pkgRoot, "dist", "index.js");
-      if (!fs4.existsSync(entry)) return null;
+      const resolver = resolveFrom ? createRequire3(path5.join(resolveFrom, "package.json")) : require2;
+      const pkgRoot = path5.dirname(resolver.resolve(`${source}/package.json`));
+      const entry = path5.join(pkgRoot, "dist", "index.js");
+      if (!fs5.existsSync(entry)) return null;
       return { file: entry, relNoExt: `_proteus/${source.replace("@proteus-vue/", "")}` };
     } catch {
       return null;
@@ -1014,34 +1163,34 @@ function resolveSharedModule(appDir, absFrom, source, frameworkDir, resolveFrom,
         return null;
       }
     };
-    const entry = tryResolve(path4.join(resolveFrom ?? appDir, "package.json")) ?? tryResolve(absFrom);
-    if (!entry || !fs4.existsSync(entry)) return null;
+    const entry = tryResolve(path5.join(resolveFrom ?? appDir, "package.json")) ?? tryResolve(absFrom);
+    if (!entry || !fs5.existsSync(entry)) return null;
     return { file: entry, relNoExt: `_proteus/${source}` };
   }
   if (!source.startsWith(".")) return null;
-  const base = path4.resolve(path4.dirname(absFrom), source);
+  const base = path5.resolve(path5.dirname(absFrom), source);
   const JS_EXTS = /* @__PURE__ */ new Set([".ts", ".js", ".mjs", ".cjs"]);
   const variantHit = resolvePlatformVariantWithExts(base, [...JS_EXTS], platform, (p) => {
     try {
-      return fs4.statSync(p).isFile();
+      return fs5.statSync(p).isFile();
     } catch {
       return false;
     }
   });
-  const candidates = variantHit ? [variantHit] : [base, `${base}.ts`, `${base}.js`, path4.join(base, "index.ts"), path4.join(base, "index.js")];
+  const candidates = variantHit ? [variantHit] : [base, `${base}.ts`, `${base}.js`, path5.join(base, "index.ts"), path5.join(base, "index.js")];
   for (const cand of candidates) {
     if (cand.endsWith(".vue")) continue;
-    if (!JS_EXTS.has(path4.extname(cand).toLowerCase())) continue;
+    if (!JS_EXTS.has(path5.extname(cand).toLowerCase())) continue;
     let isFile = false;
     try {
-      isFile = fs4.statSync(cand).isFile();
+      isFile = fs5.statSync(cand).isFile();
     } catch {
       isFile = false;
     }
     if (isFile) {
-      let relNoExt = path4.relative(appDir, cand).replace(/\\/g, "/").replace(/\.(ts|js)$/, "");
-      if (relNoExt.startsWith("../") && frameworkDir && !path4.relative(frameworkDir, cand).startsWith("..")) {
-        relNoExt = `proteus/${path4.relative(frameworkDir, cand).replace(/\\/g, "/").replace(/\.(ts|js)$/, "")}`;
+      let relNoExt = path5.relative(appDir, cand).replace(/\\/g, "/").replace(/\.(ts|js)$/, "");
+      if (relNoExt.startsWith("../") && frameworkDir && !path5.relative(frameworkDir, cand).startsWith("..")) {
+        relNoExt = `proteus/${path5.relative(frameworkDir, cand).replace(/\\/g, "/").replace(/\.(ts|js)$/, "")}`;
       }
       return { file: cand, relNoExt };
     }
@@ -1053,10 +1202,10 @@ function rewriteRootToPage(css) {
 }
 function rewriteFrameworkRequires(js, relOutput) {
   if (!js.includes("require('@proteus-vue/")) return js;
-  const pageDir = path4.posix.dirname(relOutput);
+  const pageDir = path5.posix.dirname(relOutput);
   return js.replace(/require\('@proteus-vue\/([A-Za-z0-9_-]+)'\)/g, (m, name) => {
     const pkgRel = `_proteus/${name}.js`;
-    let rel = path4.posix.relative(pageDir, pkgRel);
+    let rel = path5.posix.relative(pageDir, pkgRel);
     if (!rel.startsWith(".")) rel = `./${rel}`;
     return `require('${rel}')`;
   });
@@ -1105,11 +1254,11 @@ async function loadPresetBuilders(projectRoot, cfg) {
   for (const d of duplicates) console.warn(`[mp-transform] \u8DEF\u7531\u5B57\u6BB5 "${d}" \u5728\u9876\u5C42\u4E0E router \u6BB5\u540C\u65F6\u58F0\u660E\u2014\u2014\u5DF2\u53D6 router.${d}\uFF08#492 \u7EDF\u4E00\u8DEF\u7531\u7BA1\u7406\uFF1A\u5EFA\u8BAE\u5220\u9664\u9876\u5C42\u9057\u7559\u5199\u6CD5\uFF09`);
   for (const [name, modPath] of Object.entries(rc.customRoute.builders)) {
     const abs = resolvePkgPath(projectRoot, modPath);
-    if (!fs4.existsSync(abs)) {
+    if (!fs5.existsSync(abs)) {
       console.warn(`[mp-transform] \u9884\u8BBE builder ${name} \u4E0D\u5B58\u5728\uFF1A${modPath}`);
       continue;
     }
-    const { code } = await esbuildTransform(fs4.readFileSync(abs, "utf-8"), { loader: "ts", charset: "utf8" });
+    const { code } = await esbuildTransform(fs5.readFileSync(abs, "utf-8"), { loader: "ts", charset: "utf8" });
     const fnName = extractBuilderFnName(code);
     if (!fnName) {
       console.warn(`[mp-transform] \u9884\u8BBE builder ${name} \u672A\u627E\u5230\u51FD\u6570\u58F0\u660E\uFF0C\u5DF2\u8DF3\u8FC7`);
@@ -1120,10 +1269,10 @@ async function loadPresetBuilders(projectRoot, cfg) {
   return presets;
 }
 function walkVueFiles(dir, acc = []) {
-  if (!fs4.existsSync(dir)) return acc;
-  for (const entry of fs4.readdirSync(dir, { withFileTypes: true })) {
+  if (!fs5.existsSync(dir)) return acc;
+  for (const entry of fs5.readdirSync(dir, { withFileTypes: true })) {
     if (entry.name.startsWith(".")) continue;
-    const full = path4.join(dir, entry.name);
+    const full = path5.join(dir, entry.name);
     if (entry.isDirectory()) walkVueFiles(full, acc);
     else if (entry.name.endsWith(".vue")) acc.push(full);
   }
@@ -1139,19 +1288,26 @@ function collectMpEntries(opts) {
         onSkipWebOnly?.(f);
         continue;
       }
-      const relBase = path4.relative(appDir, splitVariant2(f).base).replace(/\\/g, "/");
+      const relBase = path5.relative(appDir, splitVariant2(f).base).replace(/\\/g, "/");
       out.push({ file: f, rel: relBase.replace(/\.vue$/, ""), isComponent });
     }
   };
-  pushRel(path4.join(projectRoot, pagesDir), false);
-  for (const sp of subPackages) pushRel(path4.join(projectRoot, sp.root), false);
-  pushRel(path4.join(appDir, "components"), true);
+  pushRel(path5.join(projectRoot, pagesDir), false);
+  for (const sp of subPackages) pushRel(path5.join(projectRoot, sp.root), false);
+  pushRel(path5.join(appDir, "components"), true);
+  const pageFiles = out.filter((t) => !t.isComponent).map((t) => t.file);
+  const emitAll = (opts.componentEmit ?? "used") === "all";
+  const usedComponents = emitAll ? null : collectUsedFrameworkComponents(pageFiles, componentsDir);
   for (const f of effectiveVariants2(walkVueFiles(componentsDir), platform)) {
     if (webOnlyPages?.has(f)) {
       onSkipWebOnly?.(f);
       continue;
     }
-    const relIn = path4.relative(componentsDir, splitVariant2(f).base).replace(/\\/g, "/").replace(/\.vue$/, "");
+    if (usedComponents) {
+      const compName = path5.relative(componentsDir, splitVariant2(f).base).replace(/\\/g, "/").split("/")[0];
+      if (!usedComponents.has(compName)) continue;
+    }
+    const relIn = path5.relative(componentsDir, splitVariant2(f).base).replace(/\\/g, "/").replace(/\.vue$/, "");
     out.push({ file: f, rel: `proteus/${relIn}`, isComponent: true });
   }
   return out;
@@ -1184,13 +1340,13 @@ function mpTransform(opts) {
       projectRoot = resolved.root;
     },
     async buildStart() {
-      const appDir = path4.join(projectRoot, path4.dirname(cfg.pagesDir));
-      const compileCache = createCompileCache(path4.join(projectRoot, "node_modules", ".cache", "proteus", "compile"));
-      const bundleCache = createBundleCache(path4.join(projectRoot, "node_modules", ".cache", "proteus", "bundle"));
+      const appDir = path5.join(projectRoot, path5.dirname(cfg.pagesDir));
+      const compileCache = createCompileCache(path5.join(projectRoot, "node_modules", ".cache", "proteus", "compile"));
+      const bundleCache = createBundleCache(path5.join(projectRoot, "node_modules", ".cache", "proteus", "bundle"));
       const webOnlyPages = /* @__PURE__ */ new Set();
       const detectWebOnly = (file) => {
         try {
-          const src = fs4.readFileSync(file, "utf-8");
+          const src = fs5.readFileSync(file, "utf-8");
           const m = src.match(/<route>\s*([\s\S]*?)<\/route>/);
           if (!m) return;
           if (/"?webOnly"?\s*:\s*true/.test(m[1])) {
@@ -1210,10 +1366,10 @@ function mpTransform(opts) {
         } catch {
         }
       };
-      for (const pagesRoot of [path4.join(projectRoot, cfg.pagesDir), ...(effectiveSubPackages ?? []).map((sp) => path4.join(projectRoot, sp.root))]) {
+      for (const pagesRoot of [path5.join(projectRoot, cfg.pagesDir), ...(effectiveSubPackages ?? []).map((sp) => path5.join(projectRoot, sp.root))]) {
         for (const f of walkVueFiles(pagesRoot)) detectWebOnly(f);
       }
-      const frameworkComponents = opts.componentsDir ? path4.resolve(projectRoot, opts.componentsDir) : resolveComponentsRoot(projectRoot);
+      const frameworkComponents = opts.componentsDir ? path5.resolve(projectRoot, opts.componentsDir) : resolveComponentsRoot(projectRoot);
       const files = collectMpEntries({
         projectRoot,
         appDir,
@@ -1221,20 +1377,22 @@ function mpTransform(opts) {
         subPackages: effectiveSubPackages ?? [],
         componentsDir: frameworkComponents,
         webOnlyPages,
-        onSkipWebOnly: (f) => console.log(`[mp-transform] \u8DF3\u8FC7 webOnly \u9875\u9762\uFF1A${path4.relative(projectRoot, f).replace(/\\/g, "/")}`)
+        onSkipWebOnly: (f) => console.log(`[mp-transform] \u8DF3\u8FC7 webOnly \u9875\u9762\uFF1A${path5.relative(projectRoot, f).replace(/\\/g, "/")}`),
+        // ★框架组件按引用输出（2026-09-18）；PROTEUS_COMPONENTS_EMIT=all 回退全量（非常规用法逃生舱）
+        componentEmit: process.env.PROTEUS_COMPONENTS_EMIT === "all" ? "all" : "used"
       });
       const appUsesStore = files.some((f) => {
         try {
-          const s = fs4.readFileSync(f.file, "utf-8");
+          const s = fs5.readFileSync(f.file, "utf-8");
           const script = s.includes("<script") ? s.match(/<script[^>]*>([\s\S]*?)<\/script>/i)?.[1] ?? "" : s;
           return /\buse[A-Z]\w*Store\s*\(/.test(script);
         } catch {
           return false;
         }
       });
-      const mpEntry = path4.join(appDir, "main.mp.ts");
-      if (fs4.existsSync(mpEntry)) {
-        const src = fs4.readFileSync(mpEntry, "utf-8");
+      const mpEntry = path5.join(appDir, "main.mp.ts");
+      if (fs5.existsSync(mpEntry)) {
+        const src = fs5.readFileSync(mpEntry, "utf-8");
         const { code } = await esbuildTransform(src, { loader: "ts", charset: "utf8" });
         const presets = filterOverriddenPresets(code, await loadPresetBuilders(projectRoot, cfg));
         const piniaInstall = appUsesStore ? "    // \u2605\u9875\u9762\u4F7F\u7528 store \u2192 \u5B89\u88C5\u5E76\u6FC0\u6D3B Pinia\uFF08\u5C0F\u7A0B\u5E8F\u65E0 createApp\uFF0C\u5FC5\u987B setActivePinia\uFF09\n    var __proteusPiniaMod = require('./_proteus/runtime.js')\n    if (__proteusPiniaMod && __proteusPiniaMod.createMpPinia) __proteusPiniaMod.createMpPinia()" : "    // \uFF08\u672A\u68C0\u6D4B\u5230 store \u4F7F\u7528\u2014\u2014\u8DF3\u8FC7 Pinia \u5B89\u88C5\uFF09";
@@ -1243,19 +1401,19 @@ function mpTransform(opts) {
         console.log(`[mp-transform] app.js \u5DF2\u76F4\u51FA\uFF08${isDebug ? "debug" : "\u6B63\u5F0F"}\uFF09\uFF0C\u5185\u7F6E\u9884\u8BBE\uFF1A${presets.map((p) => p.name).join("/") || "\u65E0"}${appUsesStore ? "\uFF0CPinia \u5DF2\u5B89\u88C5" : ""}`);
       }
       {
-        const explicit = cfg.globalStyle ? path4.resolve(projectRoot, cfg.globalStyle) : void 0;
+        const explicit = cfg.globalStyle ? path5.resolve(projectRoot, cfg.globalStyle) : void 0;
         const candidates = [
           explicit,
-          path4.join(appDir, "app.wxss"),
-          path4.join(projectRoot, "app.wxss")
+          path5.join(appDir, "app.wxss"),
+          path5.join(projectRoot, "app.wxss")
         ].filter((p) => Boolean(p));
-        const globalStylePath = candidates.find((p) => fs4.existsSync(p));
+        const globalStylePath = candidates.find((p) => fs5.existsSync(p));
         if (globalStylePath) {
-          const raw = fs4.readFileSync(globalStylePath, "utf-8");
+          const raw = fs5.readFileSync(globalStylePath, "utf-8");
           const normalized = rewriteRootToPage(raw);
           const wxss = transformStyleToWxss(normalized, { px2rpx: cfg.style?.px2rpx ?? true, rpxRatio: cfg.style?.rpxRatio ?? 2, rules: cfg.rules });
           this.emitFile({ type: "asset", fileName: "app.wxss", source: wxss });
-          console.log(`[mp-transform] app.wxss \u5DF2\u4EA7\u51FA\uFF08${path4.relative(projectRoot, globalStylePath).replace(/\\/g, "/")}\u2014\u2014\u5168\u5C40\u8BBE\u8BA1 token/\u91CD\u7F6E\uFF0C:root\u2192page\uFF09`);
+          console.log(`[mp-transform] app.wxss \u5DF2\u4EA7\u51FA\uFF08${path5.relative(projectRoot, globalStylePath).replace(/\\/g, "/")}\u2014\u2014\u5168\u5C40\u8BBE\u8BA1 token/\u91CD\u7F6E\uFF0C:root\u2192page\uFF09`);
         }
       }
       const moduleImportsByFile = /* @__PURE__ */ new Map();
@@ -1263,7 +1421,7 @@ function mpTransform(opts) {
       const sharedRelNoExt = /* @__PURE__ */ new Map();
       const resolveShared = (absFrom, source) => resolveSharedModule(appDir, absFrom, source, frameworkComponents, projectRoot, "mp");
       const scanImports = (absFile) => {
-        const src = fs4.readFileSync(absFile, "utf-8");
+        const src = fs5.readFileSync(absFile, "utf-8");
         const script = src.includes("<script") ? src.match(/<script[^>]*>([\s\S]*?)<\/script>/i)?.[1] ?? "" : src;
         return scanSourceImports(script);
       };
@@ -1327,21 +1485,21 @@ function mpTransform(opts) {
         name: "proteus-pkg-require-path",
         setup(b) {
           const mapExternal = (target) => {
-            const dir = path4.posix.dirname(relNoExt);
-            let rel = path4.posix.relative(dir, target);
+            const dir = path5.posix.dirname(relNoExt);
+            let rel = path5.posix.relative(dir, target);
             if (!rel.startsWith(".")) rel = `./${rel}`;
             return { path: rel, external: true };
           };
           b.onResolve({ filter: /^@proteus-vue\// }, (args) => mapExternal(`_proteus/${args.path.replace("@proteus-vue/", "")}.js`));
           b.onResolve({ filter: new RegExp(`^(${VENDOR_SINGLETONS.join("|")})$`) }, (args) => mapExternal(`_proteus/${args.path}.js`));
           b.onLoad({ filter: /\.(md|txt|json)$/ }, (args) => ({
-            contents: `export default ${JSON.stringify(fs4.readFileSync(args.path, "utf-8"))}`,
+            contents: `export default ${JSON.stringify(fs5.readFileSync(args.path, "utf-8"))}`,
             loader: "js"
           }));
           b.onLoad({ filter: /\.(png|jpe?g|gif|webp|svg|ico|woff2?|ttf|eot|mp3|mp4|wav|zip)$/ }, (args) => ({
             errors: [
               {
-                text: `MP \u4EA7\u7269\u4E0D\u652F\u6301\u4E8C\u8FDB\u5236\u8D44\u6E90 import\uFF1A${path4.relative(projectRoot, args.path)}\u2014\u2014\u8BF7\u6539\u7528\u7F51\u7EDC URL \u6216 base64 \u5185\u8054`
+                text: `MP \u4EA7\u7269\u4E0D\u652F\u6301\u4E8C\u8FDB\u5236\u8D44\u6E90 import\uFF1A${path5.relative(projectRoot, args.path)}\u2014\u2014\u8BF7\u6539\u7528\u7F51\u7EDC URL \u6216 base64 \u5185\u8054`
               }
             ]
           }));
@@ -1400,7 +1558,7 @@ function mpTransform(opts) {
             const inputFiles = Object.keys(build.metafile.inputs);
             const inputs = inputFiles.map((f) => {
               try {
-                const st = fs4.statSync(f);
+                const st = fs5.statSync(f);
                 return { file: f, mtimeMs: st.mtimeMs, size: st.size };
               } catch {
                 return null;
@@ -1415,18 +1573,18 @@ function mpTransform(opts) {
       for (const [file, list] of moduleImportsByFile) {
         const entry = files.find((f) => f.file === file);
         if (!entry) continue;
-        const pageDir = path4.posix.dirname(entry.rel);
+        const pageDir = path5.posix.dirname(entry.rel);
         for (const item of list) {
           const shared = resolveShared(file, item.source);
           if (!shared) continue;
           const sharedRel = `${shared.relNoExt}.js`;
-          let rel = path4.posix.relative(pageDir, sharedRel);
+          let rel = path5.posix.relative(pageDir, sharedRel);
           if (!rel.startsWith(".")) rel = `./${rel}`;
           item.requirePath = rel;
         }
       }
       for (const { file, rel, isComponent } of files) {
-        const source = fs4.readFileSync(file, "utf-8");
+        const source = fs5.readFileSync(file, "utf-8");
         if (rustCompiler) {
           const v = verifyDualCompilerEquivalence(source, { rustBin: rustCliBin, filename: file });
           if (v.status === "ok") {
@@ -1546,21 +1704,21 @@ function mpTransform(opts) {
         console.log(`[mp-transform] ${rel} \u2192 wxml/js/wxss \u5DF2\u8F93\u51FA`);
       }
       {
-        const publicDir = path4.join(projectRoot, "public");
-        if (fs4.existsSync(publicDir)) {
+        const publicDir = path5.join(projectRoot, "public");
+        if (fs5.existsSync(publicDir)) {
           const rels = [];
           const walk = (dir) => {
-            for (const e of fs4.readdirSync(dir, { withFileTypes: true })) {
+            for (const e of fs5.readdirSync(dir, { withFileTypes: true })) {
               if (e.name.startsWith(".")) continue;
-              const full = path4.join(dir, e.name);
+              const full = path5.join(dir, e.name);
               if (e.isDirectory()) walk(full);
-              else rels.push(path4.relative(publicDir, full).replace(/\\/g, "/"));
+              else rels.push(path5.relative(publicDir, full).replace(/\\/g, "/"));
             }
           };
           walk(publicDir);
           let assetN = 0;
           for (const { from, to } of mapPublicAssetVariants(rels, "mp")) {
-            this.emitFile({ type: "asset", fileName: to, source: fs4.readFileSync(path4.join(publicDir, from)) });
+            this.emitFile({ type: "asset", fileName: to, source: fs5.readFileSync(path5.join(publicDir, from)) });
             assetN++;
           }
           if (assetN) console.log(`[mp-transform] public \u9759\u6001\u8D44\u6E90 \u2192 ${assetN} \u4E2A\uFF08\u5E73\u53F0\u53D8\u4F53\u5DF2\u6309 mp \u89E3\u6790\uFF09`);
@@ -1592,8 +1750,8 @@ function mpTransform(opts) {
 }
 
 // src/devtools-plugin.ts
-import fs5 from "node:fs";
-import path5 from "node:path";
+import fs6 from "node:fs";
+import path6 from "node:path";
 import { createRequire as createRequire4 } from "node:module";
 import { WebSocketServer } from "ws";
 
@@ -1664,7 +1822,7 @@ function isOriginAllowed(origin, allowFrom) {
   return allowFrom.indexOf(origin) >= 0;
 }
 function resolveDevtoolsDir() {
-  return path5.dirname(require_.resolve("@proteus-vue/devtools/package.json"));
+  return path6.dirname(require_.resolve("@proteus-vue/devtools/package.json"));
 }
 function createPanelPageHandler(devtoolsDir) {
   return (req, res) => {
@@ -1673,19 +1831,19 @@ function createPanelPageHandler(devtoolsDir) {
     if (pathname === base || pathname === base + "/") {
       const host = req.headers?.host ?? "localhost";
       const proto = req.headers?.["x-forwarded-proto"] === "https" ? "wss" : "ws";
-      const html = fs5.readFileSync(path5.join(devtoolsDir, "panel.html"), "utf8").replace(/__PROTEUS_DEFAULT_WS__/g, `'${proto}://${host}/proteus-panel'`).replace("./style.css", base + "/style.css").replace("./dist/panel.js", base + "/panel.js");
+      const html = fs6.readFileSync(path6.join(devtoolsDir, "panel.html"), "utf8").replace(/__PROTEUS_DEFAULT_WS__/g, `'${proto}://${host}/proteus-panel'`).replace("./style.css", base + "/style.css").replace("./dist/panel.js", base + "/panel.js");
       res.setHeader("content-type", "text/html; charset=utf-8");
       res.end(html);
       return true;
     }
     if (pathname === base + "/style.css") {
       res.setHeader("content-type", "text/css; charset=utf-8");
-      res.end(fs5.readFileSync(path5.join(devtoolsDir, "style.css")));
+      res.end(fs6.readFileSync(path6.join(devtoolsDir, "style.css")));
       return true;
     }
     if (pathname === base + "/panel.js") {
       res.setHeader("content-type", "application/javascript; charset=utf-8");
-      res.end(fs5.readFileSync(path5.join(devtoolsDir, "dist", "panel.js")));
+      res.end(fs6.readFileSync(path6.join(devtoolsDir, "dist", "panel.js")));
       return true;
     }
     return false;
@@ -1759,8 +1917,8 @@ function devtoolsRelayPlugin(opts = {}) {
 }
 
 // src/vite-config.ts
-import path6 from "node:path";
-import fs6 from "node:fs";
+import path7 from "node:path";
+import fs7 from "node:fs";
 import { pathToFileURL } from "node:url";
 import { createRequire as createRequire5 } from "node:module";
 import {
@@ -1794,25 +1952,25 @@ function platformVariantPlugin(root, platform) {
       const bare = qIdx >= 0 ? id.slice(0, qIdx) : id;
       if (!bare) return null;
       let base;
-      if (bare.startsWith(".")) base = path6.resolve(path6.dirname(importer), bare);
-      else if (bare.startsWith("@/")) base = path6.resolve(root, "src", bare.slice(2));
+      if (bare.startsWith(".")) base = path7.resolve(path7.dirname(importer), bare);
+      else if (bare.startsWith("@/")) base = path7.resolve(root, "src", bare.slice(2));
       else return null;
-      const hasExt = path6.extname(base) !== "";
+      const hasExt = path7.extname(base) !== "";
       if (hasExt) {
-        const r2 = resolvePlatformVariant2(base, platform, fs6.existsSync);
+        const r2 = resolvePlatformVariant2(base, platform, fs7.existsSync);
         return r2 && r2 !== base ? r2 + query : null;
       }
-      const r = resolvePlatformVariantWithExts2(base, CODE_EXTS, platform, fs6.existsSync);
+      const r = resolvePlatformVariantWithExts2(base, CODE_EXTS, platform, fs7.existsSync);
       return r ? r + query : null;
     }
   };
 }
 function hasPublicVariants(publicDir) {
-  if (!fs6.existsSync(publicDir)) return false;
+  if (!fs7.existsSync(publicDir)) return false;
   const walk = (dir) => {
-    for (const e of fs6.readdirSync(dir, { withFileTypes: true })) {
+    for (const e of fs7.readdirSync(dir, { withFileTypes: true })) {
       if (e.name.startsWith(".")) continue;
-      const full = path6.join(dir, e.name);
+      const full = path7.join(dir, e.name);
       if (e.isDirectory()) {
         if (walk(full)) return true;
       } else if (splitVariant3(e.name).platform !== void 0) {
@@ -1828,20 +1986,20 @@ function platformPublicAssetsPlugin(root, platform) {
     name: "proteus-platform-public-assets",
     apply: "build",
     generateBundle() {
-      const publicDir = path6.join(root, "public");
-      if (!fs6.existsSync(publicDir)) return;
+      const publicDir = path7.join(root, "public");
+      if (!fs7.existsSync(publicDir)) return;
       const rels = [];
       const walk = (dir) => {
-        for (const e of fs6.readdirSync(dir, { withFileTypes: true })) {
+        for (const e of fs7.readdirSync(dir, { withFileTypes: true })) {
           if (e.name.startsWith(".")) continue;
-          const full = path6.join(dir, e.name);
+          const full = path7.join(dir, e.name);
           if (e.isDirectory()) walk(full);
-          else rels.push(path6.relative(publicDir, full).replace(/\\/g, "/"));
+          else rels.push(path7.relative(publicDir, full).replace(/\\/g, "/"));
         }
       };
       walk(publicDir);
       for (const { from, to } of mapPublicAssetVariants2(rels, platform)) {
-        this.emitFile({ type: "asset", fileName: to, source: fs6.readFileSync(path6.join(publicDir, from)) });
+        this.emitFile({ type: "asset", fileName: to, source: fs7.readFileSync(path7.join(publicDir, from)) });
       }
     }
   };
@@ -1869,7 +2027,7 @@ function virtualMpEntryPlugin() {
   };
 }
 async function importFromRoot(root, spec) {
-  const req = createRequire5(path6.join(root, "package.json"));
+  const req = createRequire5(path7.join(root, "package.json"));
   const resolved = req.resolve(spec);
   return import(pathToFileURL(resolved).href);
 }
@@ -1906,15 +2064,15 @@ async function resolveProteusViteConfig(ctx, config) {
     // ★平台变体·静态资源 Web 通道（第 3 层）：public/ 含平台变体（logo.web.png）时，
     //   关掉 Vite 默认逐字拷贝（会把他端变体也拷进产物），改由 platformPublicAssetsPlugin 按 web 解析；
     //   无变体时保持默认（零侵入，避免改变既有工程行为）。
-    publicDir: hasPublicVariants(path6.join(root, "public")) ? false : void 0,
+    publicDir: hasPublicVariants(path7.join(root, "public")) ? false : void 0,
     resolve: {
-      alias: [{ find: "@", replacement: path6.join(root, "src") }]
+      alias: [{ find: "@", replacement: path7.join(root, "src") }]
     },
     build: {
       target: "es2018",
       cssCodeSplit: false,
       minify: isMp ? false : void 0,
-      outDir: path6.join(root, "dist", platform),
+      outDir: path7.join(root, "dist", platform),
       emptyOutDir: !isMp,
       rollupOptions: isMp ? { input: "proteus:mp-entry", output: { entryFileNames: "mp-entry.js" } } : void 0
     }

package/dist/plugin.d.ts

@@ -119,6 +119,8 @@ export declare function collectMpEntries(opts: {
     onSkipWebOnly?: (file: string) => void;
     /** ★平台变体（2026-09-13）：按该平台解析 `foo.mp.vue`/`foo.web.vue`（缺省 mp） */
     platform?: VariantPlatform;
+    /** ★框架组件输出策略（2026-09-18）：'used'（缺省，按引用闭包输出）/ 'all'（全量，逃生舱） */
+    componentEmit?: 'used' | 'all';
 }): Array<{
     file: string;
     rel: string;

package/dist/tag-scan.d.ts

@@ -0,0 +1,28 @@
+/** 抽取 `<template>` 块正文（跳过注释 / script / style / 嵌套 template 深度） */
+export declare function extractTemplateBody(src: string): string;
+/**
+ * 扫描模板正文中出现的全部标签名（kebab 化；跳过注释块）。
+ * PascalCase（`<PSafe>`）→ kebab（`p-safe`）——★旧正则只匹配小写开头，
+ * 导致 `<PSafe>` 完全跳过扫描（既不注册也不告警 → 组件静默不渲染，showcase 踩坑）。
+ */
+export declare function extractTags(tpl: string): Set<string>;
+/**
+ * ★编译器**产出**的组件标签（源码模板中不存在，由 compiler lowering 生成）。
+ * 必须计入引用集合，否则按需输出会把这些组件漏掉 → 运行时不渲染（真 bug）。
+ *
+ * 与 gen-routes 的 collectComponents 同源规则（两处必须一致）：
+ *   源码含**形状变化动画**的 SVG（cx/r/d/stroke-dashoffset 等）→ 编译器 lowering 为 `<p-svg-canvas>`。
+ */
+export declare function collectCompilerEmittedTags(templateBody: string): Set<string>;
+/**
+ * 计算页面**实际引用**的框架组件目录集合（含组件间传递依赖闭包）。
+ *
+ * 用途：MP 产物只输出用到的组件（而非全量 76 个 = 607 KB）——对每个真实应用都是可观瘦身。
+ *   ★诚实边界：仅识别**静态模板标签**。运行时动态拼标签不受支持（MP 本就无 `<component :is>`，
+ *   编译器已对 `<component :is>` 显式告警）——若确有非常规用法，可用 `components.emit: 'all'` 关闭本优化。
+ *
+ * @param pageFiles  页面源文件绝对路径（主包 + 分包，**须已排除 webOnly 页面**）
+ * @param componentsDir 框架组件根目录
+ * @returns 组件目录名集合（如 `p-view`）；空集表示「未引用任何框架组件」
+ */
+export declare function collectUsedFrameworkComponents(pageFiles: readonly string[], componentsDir: string): Set<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteus-vue/plugin-vite",
-  "version": "0.2.0-beta.2",
+  "version": "0.2.0-beta.5",
   "description": "Proteus Vite 插件（mp-weixin 编译管线适配层）+ gen-routes 路由表生成器",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,14 +19,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@proteus-vue/compiler": "0.3.0-beta.2",
-    "@proteus-vue/module": "0.1.0",
-    "@proteus-vue/router": "0.2.0-beta.2",
-    "@proteus-vue/types": "0.2.0-beta.1",
+    "@proteus-vue/compiler": "0.3.0-beta.3",
+    "@proteus-vue/module": "0.1.1-beta.0",
+    "@proteus-vue/router": "0.2.0-beta.5",
+    "@proteus-vue/types": "0.2.0-beta.2",
     "esbuild": "^0.28.2",
     "sass": "^1.103.1",
     "ws": "^8.0.0",
-    "@proteus-vue/compiler-backend": "0.1.1-beta.0"
+    "@proteus-vue/compiler-backend": "0.1.1-beta.1"
   },
   "peerDependencies": {
     "vite": "^5.0.0"