@proteus-vue/plugin-vite 0.2.0-beta.0

package/dist/appSkeleton.d.ts

@@ -0,0 +1 @@
+export declare const APP_LAUNCH_SKELETON = "App({\n  onLaunch() {\n    // \u5168\u94FE\u8DEF\u8C03\u8BD5\u5F00\u5173\uFF08PROTEUS_DEBUG=1 \u6784\u5EFA\u65F6\u7531\u63D2\u4EF6\u66FF\u6362\u4E3A true\uFF09\n    const debug = typeof __PROTEUS_DEBUG__ !== 'undefined' && __PROTEUS_DEBUG__\n    if (debug) console.log('[proteus][app] \u542F\u52A8', Date.now())\n    // \u5168\u5C40\u9519\u8BEF\u6355\u83B7\uFF08debug \u6784\u5EFA\u8F93\u51FA\uFF0C\u6B63\u5F0F\u6784\u5EFA\u5E38\u91CF\u6298\u53E0\u96F6\u6B8B\u7559\uFF09\n    if (typeof wx !== 'undefined' && wx.onError) {\n      wx.onError(function (err) {\n        if (debug) console.error('[proteus][error]', err, Date.now())\n      })\n    }\n    // \u5185\u7F6E\u9884\u8BBE\u6CE8\u518C\uFF08\u540C\u6587\u4EF6\u9759\u6001\u53EF\u5206\u6790\uFF1A\u51FD\u6570\u5B9A\u4E49\u5728\u524D\u3001\u6CE8\u518C\u5728\u540E\uFF0C\u63D2\u4EF6\u5DF2\u4FDD\u8BC1\u987A\u5E8F\uFF09\n    if (typeof wx !== 'undefined' && wx.router) {\n__PRESET_REGISTRATION__\n    }\n  },\n  // \u2605lifecycle-plan B4\uFF1AApp \u7EA7 onShow/onHide \u94A9\u5B50\uFF08\u8C03\u8BD5\u65E5\u5FD7\uFF1BWeb \u7AEF\u5BF9\u5E94 visibilitychange\uFF09\n  onShow() {\n    const debug = typeof __PROTEUS_DEBUG__ !== 'undefined' && __PROTEUS_DEBUG__\n    if (debug) console.log('[proteus][app] onShow', Date.now())\n  },\n  onHide() {\n    const debug = typeof __PROTEUS_DEBUG__ !== 'undefined' && __PROTEUS_DEBUG__\n    if (debug) console.log('[proteus][app] onHide', Date.now())\n  },\n})\n";

package/dist/cache.d.ts

@@ -0,0 +1,61 @@
+export interface CompileCacheEntry {
+    wxml: string;
+    js: string;
+    wxss: string;
+    warnings: string[];
+}
+export interface CompileCacheStats {
+    hits: number;
+    misses: number;
+}
+/** 编译器版本指纹（缓存键组成部分——编译器代码变更即全局失效）
+ * ★修复①：仅 package.json version 不足（代码改了版本没变 → 缓存命中旧产物）；改用 dist 代码内容哈希
+ * ★修复②（2026-08 真机复现）：vite 5.4 加载 config 时把插件 bundle 到 os.tmpdir() → import.meta.url 基准失效 →
+ *   require.resolve 找不到项目 node_modules（MODULE_NOT_FOUND）→ 恒 'unknown' → 指纹永不变化 → 改编译器代码缓存不失效
+ *   （8aac7c3 的 dist 指纹设计在 vite bundle 场景从未生效）。改以 projectRoot 为基准（createRequire(projectRoot)）显式解析 */
+export declare function getCompilerVersion(projectRoot: string): string;
+/** esbuild 版本（bundle 缓存键组成部分；同样以 projectRoot 为基准解析，避免 vite config bundle 基准失效） */
+export declare function getEsbuildVersion(projectRoot: string): string;
+/** 计算缓存键：sha1(源码 + 全编译入参 JSON + 编译器版本) */
+export declare function compileCacheKey(source: string, options: {
+    rel: string;
+    isComponent: boolean;
+    px2rpx: boolean;
+    rpxRatio: number;
+    rules?: Record<string, unknown>;
+    moduleImports?: Array<{
+        source: string;
+        requirePath: string;
+    }>;
+    annotateLines: boolean;
+    debug: boolean;
+    autoScrollContainer?: boolean;
+}, projectRoot: string): string;
+/** 编译缓存：磁盘 + 内存双层（root 为项目根，缓存目录 node_modules/.cache/proteus/compile/） */
+export declare function createCompileCache(cacheDir: string): {
+    get(key: string): CompileCacheEntry | null;
+    set(key: string, entry: CompileCacheEntry): void;
+    stats(): CompileCacheStats;
+};
+/** 输入文件快照（mtime+size 指纹，对齐 webpack/babel-loader 持久化缓存实践） */
+export interface BundleInputSnapshot {
+    file: string;
+    mtimeMs: number;
+    size: number;
+}
+export interface BundleCacheEntry {
+    output: string;
+    inputs: BundleInputSnapshot[];
+}
+/** bundle 缓存键：sha1(入口文件 + esbuild 版本 + 构建选项) */
+export declare function bundleCacheKey(entryFile: string, projectRoot: string): string;
+/**
+ * esbuild bundle 缓存：磁盘 + 内存双层
+ * 键 = sha1(入口文件 + esbuild 版本 + 构建选项)；命中需输入快照全部有效（mtime+size 一致）
+ * 注意：首次构建需 metafile 记录输入集（第一次必然未命中，后续命中）
+ */
+export declare function createBundleCache(cacheDir: string): {
+    get(key: string): BundleCacheEntry | null;
+    set(key: string, entry: BundleCacheEntry): void;
+    stats(): CompileCacheStats;
+};

package/dist/config.d.ts

@@ -0,0 +1 @@
+export type { ProteusConfig } from '@proteus-vue/types/config';

package/dist/gen-routes.d.ts

@@ -0,0 +1,28 @@
+import type { ProteusConfig } from './config';
+/** 入口选项：config 为项目编译配置，root 为项目根目录（默认 process.cwd()） */
+export interface GenRoutesOptions {
+    config: ProteusConfig;
+    root?: string;
+    /** --trace-router：输出每条路由的生成决策（来源登记 + 父路由推导依据） */
+    trace?: (msg: string) => void;
+    /**
+     * ★框架内置组件目录（组件库未拆包，决策 #115）：显式传入绝对路径（如 monorepo 根 src/components）；
+     * 缺省相对 root 的 src/components（create-proteus 模板工程用）
+     * ★v2.0 退役：@proteus-vue/components 拆为独立 npm 包后本选项删除（改 resolvePkgPath 包内路径，见 docs/packages.md）
+     */
+    frameworkComponentsDir?: string;
+    /**
+     * ★module-plan B5：模块契约（@proteus-vue/module 扫描产物，调用方 async 扫描后传入）：
+     * 分包依赖（dependencies）与 preloadRule 生成——模块 chunk/name 与 config.subPackages 的 name/root 基名匹配
+     */
+    moduleConfigs?: Array<{
+        name: string;
+        chunk?: string;
+        dependencies?: Record<string, string>;
+        preload?: string[];
+    }>;
+}
+/**
+ * 运行路由表生成（纯函数，可单测）：清理 dist 产物 → 扫描页面 → 生成 auto-routes/app.json/page.json/component.json
+ */
+export declare function runGenRoutes(options: GenRoutesOptions): void;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { default as mpTransform, defaultScopedPlugin } from './plugin';
+export { runGenRoutes } from './gen-routes';
+export type { GenRoutesOptions } from './gen-routes';
+export type { ProteusConfig } from './config';
+export type { PluginOptions } from './plugin';

package/dist/index.js

@@ -0,0 +1,1082 @@
+// src/plugin.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+import { createRequire as createRequire2 } from "node:module";
+import { transform as esbuildTransform, build as esbuildBuild } from "esbuild";
+import * as sass from "sass";
+import { compileVueSfc } from "@proteus-vue/compiler";
+
+// src/appSkeleton.ts
+var APP_LAUNCH_SKELETON = `App({
+  onLaunch() {
+    // \u5168\u94FE\u8DEF\u8C03\u8BD5\u5F00\u5173\uFF08PROTEUS_DEBUG=1 \u6784\u5EFA\u65F6\u7531\u63D2\u4EF6\u66FF\u6362\u4E3A true\uFF09
+    const debug = typeof __PROTEUS_DEBUG__ !== 'undefined' && __PROTEUS_DEBUG__
+    if (debug) console.log('[proteus][app] \u542F\u52A8', Date.now())
+    // \u5168\u5C40\u9519\u8BEF\u6355\u83B7\uFF08debug \u6784\u5EFA\u8F93\u51FA\uFF0C\u6B63\u5F0F\u6784\u5EFA\u5E38\u91CF\u6298\u53E0\u96F6\u6B8B\u7559\uFF09
+    if (typeof wx !== 'undefined' && wx.onError) {
+      wx.onError(function (err) {
+        if (debug) console.error('[proteus][error]', err, Date.now())
+      })
+    }
+    // \u5185\u7F6E\u9884\u8BBE\u6CE8\u518C\uFF08\u540C\u6587\u4EF6\u9759\u6001\u53EF\u5206\u6790\uFF1A\u51FD\u6570\u5B9A\u4E49\u5728\u524D\u3001\u6CE8\u518C\u5728\u540E\uFF0C\u63D2\u4EF6\u5DF2\u4FDD\u8BC1\u987A\u5E8F\uFF09
+    if (typeof wx !== 'undefined' && wx.router) {
+__PRESET_REGISTRATION__
+    }
+  },
+  // \u2605lifecycle-plan B4\uFF1AApp \u7EA7 onShow/onHide \u94A9\u5B50\uFF08\u8C03\u8BD5\u65E5\u5FD7\uFF1BWeb \u7AEF\u5BF9\u5E94 visibilitychange\uFF09
+  onShow() {
+    const debug = typeof __PROTEUS_DEBUG__ !== 'undefined' && __PROTEUS_DEBUG__
+    if (debug) console.log('[proteus][app] onShow', Date.now())
+  },
+  onHide() {
+    const debug = typeof __PROTEUS_DEBUG__ !== 'undefined' && __PROTEUS_DEBUG__
+    if (debug) console.log('[proteus][app] onHide', Date.now())
+  },
+})
+`;
+
+// src/cache.ts
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { createRequire } from "node:module";
+function getCompilerVersion(projectRoot) {
+  try {
+    const require3 = createRequire(path.join(projectRoot, "package.json"));
+    const pkgJsonPath = require3.resolve("@proteus-vue/compiler/package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+    const dist = path.join(path.dirname(pkgJsonPath), pkg.main ?? "dist/index.js");
+    const h = crypto.createHash("sha1");
+    h.update(fs.readFileSync(dist, "utf-8"));
+    return `${pkg.version}-${h.digest("hex").slice(0, 8)}`;
+  } catch {
+    return "unknown";
+  }
+}
+function getEsbuildVersion(projectRoot) {
+  try {
+    const require3 = createRequire(path.join(projectRoot, "package.json"));
+    const pkg = JSON.parse(fs.readFileSync(require3.resolve("esbuild/package.json"), "utf-8"));
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+}
+function compileCacheKey(source, options, projectRoot) {
+  const h = crypto.createHash("sha1");
+  h.update(source);
+  h.update("|");
+  h.update(JSON.stringify({ ...options, compilerVersion: getCompilerVersion(projectRoot) }));
+  return h.digest("hex");
+}
+function createCompileCache(cacheDir) {
+  fs.mkdirSync(cacheDir, { recursive: true });
+  const memory = /* @__PURE__ */ new Map();
+  let hits = 0;
+  let misses = 0;
+  return {
+    get(key) {
+      const mem = memory.get(key);
+      if (mem) {
+        hits++;
+        return mem;
+      }
+      const file = path.join(cacheDir, `${key}.json`);
+      if (fs.existsSync(file)) {
+        try {
+          const entry = JSON.parse(fs.readFileSync(file, "utf-8"));
+          memory.set(key, entry);
+          hits++;
+          return entry;
+        } catch {
+        }
+      }
+      misses++;
+      return null;
+    },
+    set(key, entry) {
+      memory.set(key, entry);
+      try {
+        fs.writeFileSync(path.join(cacheDir, `${key}.json`), JSON.stringify(entry));
+      } catch {
+      }
+    },
+    stats() {
+      return { hits, misses };
+    }
+  };
+}
+function bundleCacheKey(entryFile, projectRoot) {
+  const h = crypto.createHash("sha1");
+  h.update(entryFile);
+  h.update("|");
+  h.update(
+    JSON.stringify({
+      esbuild: getEsbuildVersion(projectRoot),
+      target: "es2018",
+      format: "cjs",
+      charset: "utf8",
+      minify: true,
+      external: ["@proteus-vue/*"]
+    })
+  );
+  return h.digest("hex");
+}
+function inputsValid(inputs) {
+  for (let i = 0; i < inputs.length; i++) {
+    try {
+      const st = fs.statSync(inputs[i].file);
+      if (st.mtimeMs !== inputs[i].mtimeMs || st.size !== inputs[i].size) return false;
+    } catch {
+      return false;
+    }
+  }
+  return true;
+}
+function createBundleCache(cacheDir) {
+  fs.mkdirSync(cacheDir, { recursive: true });
+  const memory = /* @__PURE__ */ new Map();
+  let hits = 0;
+  let misses = 0;
+  return {
+    get(key) {
+      const mem = memory.get(key);
+      if (mem && inputsValid(mem.inputs)) {
+        hits++;
+        return mem;
+      }
+      const file = path.join(cacheDir, `${key}.json`);
+      if (fs.existsSync(file)) {
+        try {
+          const entry = JSON.parse(fs.readFileSync(file, "utf-8"));
+          if (inputsValid(entry.inputs)) {
+            memory.set(key, entry);
+            hits++;
+            return entry;
+          }
+        } catch {
+        }
+      }
+      misses++;
+      return null;
+    },
+    set(key, entry) {
+      memory.set(key, entry);
+      try {
+        fs.writeFileSync(path.join(cacheDir, `${key}.json`), JSON.stringify(entry));
+      } catch {
+      }
+    },
+    stats() {
+      return { hits, misses };
+    }
+  };
+}
+
+// src/plugin.ts
+var MP_TAG_MAP = {
+  view: "proteus-view",
+  text: "proteus-text",
+  button: "proteus-button",
+  input: "proteus-input",
+  image: "proteus-image",
+  "scroll-view": "proteus-scroll-view",
+  textarea: "proteus-textarea",
+  switch: "proteus-switch",
+  slider: "proteus-slider",
+  icon: "proteus-icon",
+  progress: "proteus-progress",
+  navigator: "proteus-navigator",
+  picker: "proteus-picker"
+};
+function defaultScopedPlugin() {
+  return {
+    name: "proteus-default-scoped",
+    enforce: "pre",
+    transform(code, id) {
+      if (!id.endsWith(".vue")) return null;
+      let out = code.replace(/<style\b([^>]*)>/g, (m, attrs) => {
+        if (/\bscoped\b/.test(attrs)) return m;
+        if (/\bglobal\b/.test(attrs)) return m.replace(/\bglobal\b\s*/, "");
+        return m.replace(/^<style/, "<style scoped");
+      });
+      out = out.replace(/<(\/)?(view|text|button|input|image|scroll-view|textarea|switch|slider|icon|progress|navigator|picker)(\s|\/?>)/g, (m, close, tag, rest) => {
+        return `<${close ?? ""}${MP_TAG_MAP[tag]}${rest}`;
+      });
+      if ((/function\s+onPageScroll\s*\(/.test(out) || /function\s+onReachBottom\s*\(/.test(out)) && out.includes("<script")) {
+        const importLine = "\nimport { onMounted as __proteusOnMounted, onUnmounted as __proteusOnUnmounted } from 'vue'\n";
+        const hookCode = "\nlet __proteusScrollHandler = () => {\n  const __y = window.scrollY || 0\n  // typeof \u5B89\u5168\u5305\u88F9\uFF1A\u9875\u9762\u53EF\u80FD\u53EA\u58F0\u660E onPageScroll \u6216 onReachBottom \u4E4B\u4E00\uFF08\u672A\u58F0\u660E\u6807\u8BC6\u7B26\u76F4\u63A5\u5F15\u7528\u629B ReferenceError\uFF09\n  const __f = typeof onPageScroll === 'function' ? onPageScroll : null; if (__f) __f({ scrollTop: __y, scrollLeft: window.scrollX || 0 })\n  if (typeof onReachBottom === 'function' && __y + window.innerHeight >= document.documentElement.scrollHeight - 50) onReachBottom()\n}\n__proteusOnMounted(() => { window.addEventListener('scroll', __proteusScrollHandler) })\n__proteusOnUnmounted(() => { window.removeEventListener('scroll', __proteusScrollHandler) })\n";
+        out = out.replace(/<script([^>]*)>/, (m) => `${m}${importLine}`);
+        out = out.replace("</script>", `${hookCode}</script>`);
+      }
+      return out === code ? null : { code: out, map: null };
+    }
+  };
+}
+var require2 = createRequire2(import.meta.url);
+function resolvePkgPath(projectRoot, modPath) {
+  const m = modPath.match(/^node_modules\/((?:@[^/]+\/)?[^/]+)\/([\s\S]+)$/);
+  if (m) {
+    try {
+      const pkgRequire = createRequire2(path2.join(projectRoot, "package.json"));
+      const pkgRoot = path2.dirname(pkgRequire.resolve(`${m[1]}/package.json`));
+      return path2.join(pkgRoot, m[2]);
+    } catch {
+    }
+  }
+  return path2.join(projectRoot, modPath);
+}
+function preprocessStyle(lang, content) {
+  if (lang === "scss" || lang === "sass") {
+    try {
+      return sass.compileString(content).css;
+    } catch (err) {
+      console.warn(`[mp-transform] scss \u7F16\u8BD1\u5931\u8D25\uFF08\u539F\u6837\u8F93\u51FA\uFF09\uFF1A${err.message}`);
+      return content;
+    }
+  }
+  if (lang === "less") {
+    console.warn("[mp-transform] less \u9884\u5904\u7406\u5668\u6682\u672A\u5185\u7F6E\uFF08MVP \u4EC5 scss\uFF09\uFF0C\u5DF2\u539F\u6837\u8F93\u51FA");
+    return content;
+  }
+  return content;
+}
+function resolveSharedModule(appDir, absFrom, source, frameworkDir) {
+  if (source.startsWith("@proteus-vue/")) {
+    try {
+      const pkgRoot = path2.dirname(require2.resolve(`${source}/package.json`));
+      const entry = path2.join(pkgRoot, "dist", "index.js");
+      if (!fs2.existsSync(entry)) return null;
+      return { file: entry, relNoExt: `_proteus/${source.replace("@proteus-vue/", "")}` };
+    } catch {
+      return null;
+    }
+  }
+  if (!source.startsWith(".")) return null;
+  const base = path2.resolve(path2.dirname(absFrom), source);
+  for (const cand of [base, `${base}.ts`, `${base}.js`, path2.join(base, "index.ts"), path2.join(base, "index.js")]) {
+    if (cand.endsWith(".vue")) continue;
+    let isFile = false;
+    try {
+      isFile = fs2.statSync(cand).isFile();
+    } catch {
+      isFile = false;
+    }
+    if (isFile) {
+      let relNoExt = path2.relative(appDir, cand).replace(/\\/g, "/").replace(/\.(ts|js)$/, "");
+      if (relNoExt.startsWith("../") && frameworkDir && !path2.relative(frameworkDir, cand).startsWith("..")) {
+        relNoExt = `proteus/${path2.relative(frameworkDir, cand).replace(/\\/g, "/").replace(/\.(ts|js)$/, "")}`;
+      }
+      return { file: cand, relNoExt };
+    }
+  }
+  return null;
+}
+function extractBuilderFnName(code) {
+  const m = code.match(/function\s+([A-Za-z_$][\w$]*)\s*\(/);
+  return m ? m[1] : null;
+}
+function assembleAppJs(mainCode, presets) {
+  const presetCode = presets.map((p) => p.source.trim()).join("\n\n");
+  const custom = mainCode.trim();
+  const registerLines = presets.map((p) => `  wx.router.addRouteBuilder('${p.name}', ${p.fnName})`);
+  if (custom.includes("App(")) {
+    const register = presets.length ? `
+if (typeof wx !== 'undefined' && wx.router) {
+${registerLines.join("\n")}
+}
+` : "";
+    return `${custom}
+
+${presetCode}${register}`;
+  }
+  const skeletonReg = presets.map((p) => `      wx.router.addRouteBuilder('${p.name}', ${p.fnName})`);
+  const skeleton = APP_LAUNCH_SKELETON.replace("__PRESET_REGISTRATION__", skeletonReg.join("\n") || "      // \u65E0\u5185\u7F6E\u9884\u8BBE");
+  return `${custom ? `${custom}
+
+` : ""}${presetCode ? `${presetCode}
+
+` : ""}${skeleton}`;
+}
+function filterOverriddenPresets(mainCode, presets) {
+  return presets.filter((p) => !new RegExp(`addRouteBuilder\\s*\\(\\s*['"]${p.name}['"]`).test(mainCode));
+}
+async function loadPresetBuilders(projectRoot, cfg) {
+  const presets = [];
+  for (const [name, modPath] of Object.entries(cfg.customRoute.builders)) {
+    const abs = resolvePkgPath(projectRoot, modPath);
+    if (!fs2.existsSync(abs)) {
+      console.warn(`[mp-transform] \u9884\u8BBE builder ${name} \u4E0D\u5B58\u5728\uFF1A${modPath}`);
+      continue;
+    }
+    const { code } = await esbuildTransform(fs2.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`);
+      continue;
+    }
+    presets.push({ name, fnName, source: code });
+  }
+  return presets;
+}
+function walkVueFiles(dir, acc = []) {
+  if (!fs2.existsSync(dir)) return acc;
+  for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.name.startsWith(".")) continue;
+    const full = path2.join(dir, entry.name);
+    if (entry.isDirectory()) walkVueFiles(full, acc);
+    else if (entry.name.endsWith(".vue")) acc.push(full);
+  }
+  return acc;
+}
+function mpTransform(opts) {
+  const cfg = opts.config;
+  const px2rpx = opts.px2rpx ?? cfg.style.px2rpx;
+  const rpxRatio = opts.rpxRatio ?? cfg.style.rpxRatio;
+  const rules = opts.rules ?? cfg.rules;
+  const autoScrollContainer = cfg.page?.autoScrollContainer ?? true;
+  const isDebug = process.env.PROTEUS_DEBUG === "1";
+  let projectRoot = process.cwd();
+  const warningReport = [];
+  return {
+    name: "vite-plugin-mp-transform",
+    enforce: "pre",
+    configResolved(resolved) {
+      projectRoot = resolved.root;
+    },
+    async buildStart() {
+      const appDir = path2.join(projectRoot, path2.dirname(cfg.pagesDir));
+      const compileCache = createCompileCache(path2.join(projectRoot, "node_modules", ".cache", "proteus", "compile"));
+      const bundleCache = createBundleCache(path2.join(projectRoot, "node_modules", ".cache", "proteus", "bundle"));
+      const files = [];
+      const pushRel = (dir) => {
+        for (const f of walkVueFiles(dir)) {
+          files.push({ file: f, rel: path2.relative(appDir, f).replace(/\\/g, "/").replace(/\.vue$/, "") });
+        }
+      };
+      pushRel(path2.join(projectRoot, cfg.pagesDir));
+      for (const sp of cfg.subPackages ?? []) {
+        pushRel(path2.join(projectRoot, sp.root));
+      }
+      const appComponents = path2.join(appDir, "components");
+      if (fs2.existsSync(appComponents)) pushRel(appComponents);
+      const frameworkComponents = opts.frameworkComponentsDir ?? path2.join(projectRoot, "src", "components");
+      if (fs2.existsSync(frameworkComponents)) {
+        for (const f of walkVueFiles(frameworkComponents)) {
+          const relIn = path2.relative(frameworkComponents, f).replace(/\\/g, "/").replace(/\.vue$/, "");
+          files.push({ file: f, rel: `proteus/${relIn}` });
+        }
+      }
+      const mpEntry = path2.join(appDir, "main.mp.ts");
+      if (fs2.existsSync(mpEntry)) {
+        const src = fs2.readFileSync(mpEntry, "utf-8");
+        const { code } = await esbuildTransform(src, { loader: "ts", charset: "utf8" });
+        const presets = filterOverriddenPresets(code, await loadPresetBuilders(projectRoot, cfg));
+        const appJs = assembleAppJs(code, presets).replace(/__PROTEUS_DEBUG__/g, isDebug ? "true" : "false").replace(/"worklet"/g, "'worklet'");
+        this.emitFile({ type: "asset", fileName: "app.js", source: appJs });
+        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"}`);
+      }
+      const moduleImportsByFile = /* @__PURE__ */ new Map();
+      const sharedModules = /* @__PURE__ */ new Set();
+      const sharedRelNoExt = /* @__PURE__ */ new Map();
+      const resolveShared = (absFrom, source) => resolveSharedModule(appDir, absFrom, source, frameworkComponents);
+      const scanImports = (absFile) => {
+        const src = fs2.readFileSync(absFile, "utf-8");
+        const script = src.includes("<script") ? src.match(/<script[^>]*>([\s\S]*?)<\/script>/i)?.[1] ?? "" : src;
+        const out = [];
+        for (const m of script.matchAll(/import\s+(?:type\s+)?.*?from\s+['"]([^'"]+)['"]|import\s+['"]([^'"]+)['"]/gm)) {
+          const s = m[1] || m[2];
+          if (s) out.push({ source: s, typeOnly: m[0].includes("import type") });
+        }
+        return out;
+      };
+      for (const { file } of files) {
+        const list = [];
+        for (const imp of scanImports(file)) {
+          if (imp.typeOnly) continue;
+          const resolved = resolveShared(file, imp.source);
+          if (!resolved) continue;
+          sharedModules.add(resolved.file);
+          sharedRelNoExt.set(resolved.file, resolved.relNoExt);
+          list.push({ source: imp.source, requirePath: "" });
+        }
+        if (list.length) moduleImportsByFile.set(file, list);
+      }
+      const pending = [...sharedModules];
+      while (pending.length) {
+        const cur = pending.pop();
+        for (const imp of scanImports(cur)) {
+          if (imp.typeOnly) continue;
+          const resolved = resolveShared(cur, imp.source);
+          if (!resolved || sharedModules.has(resolved.file)) continue;
+          sharedModules.add(resolved.file);
+          sharedRelNoExt.set(resolved.file, resolved.relNoExt);
+          pending.push(resolved.file);
+        }
+      }
+      const THIRD_PARTY_ALLOW = /* @__PURE__ */ new Set(["pinia", "vue", "vue-demi", "@vue/reactivity", "@vue/shared", "@vue/runtime-core"]);
+      const hasThirdParty = /* @__PURE__ */ new Set();
+      for (const sharedFile of sharedModules) {
+        for (const imp of scanImports(sharedFile)) {
+          if (imp.typeOnly) continue;
+          if (!imp.source.startsWith(".") && !imp.source.startsWith("@proteus-vue/") && !THIRD_PARTY_ALLOW.has(imp.source)) hasThirdParty.add(sharedFile);
+        }
+      }
+      const skipShared = /* @__PURE__ */ new Set();
+      const markSkip = (f) => {
+        if (skipShared.has(f)) return;
+        skipShared.add(f);
+        for (const other of sharedModules) {
+          if (other === f) continue;
+          const deps = scanImports(other).map((i) => resolveShared(other, i.source)?.file).filter(Boolean);
+          if (deps.includes(f)) markSkip(other);
+        }
+      };
+      for (const f of hasThirdParty) markSkip(f);
+      if (skipShared.size) {
+        console.warn(`[mp-transform] \u26A0 ${skipShared.size} \u4E2A\u5171\u4EAB\u6A21\u5757\u542B\u7B2C\u4E09\u65B9\u4F9D\u8D56\uFF08pinia/vue \u7B49\uFF09\u5DF2\u8DF3\u8FC7\u7F16\u8BD1\uFF08B0 MVP\uFF1A\u4EC5\u652F\u6301\u7EAF\u903B\u8F91 + @proteus-vue/* \u6846\u67B6\u5305\u5171\u4EAB\u6A21\u5757\uFF09\u2014\u2014\u8BF7\u7528 store \u6865 / \u5185\u8054\uFF0CPinia \u63A5\u5165\u4E3A\u540E\u7EED\u6279\u6B21`);
+        for (const [file, list] of moduleImportsByFile) {
+          moduleImportsByFile.set(file, list.filter((item) => !skipShared.has(resolveShared(file, item.source)?.file ?? "")));
+        }
+      }
+      const bundleCacheEnabled = !process.env.PROTEUS_NO_CACHE && !isDebug;
+      for (const sharedFile of sharedModules) {
+        if (skipShared.has(sharedFile)) continue;
+        const relNoExt = sharedRelNoExt.get(sharedFile) ?? "";
+        let code = "";
+        let bundleHit = false;
+        if (bundleCacheEnabled) {
+          const bKey = bundleCacheKey(sharedFile, projectRoot);
+          const cachedBundle = bundleCache.get(bKey);
+          if (cachedBundle) {
+            code = cachedBundle.output;
+            bundleHit = true;
+            console.log(`[mp-transform] bundle \u7F13\u5B58\u547D\u4E2D\uFF1A${relNoExt}`);
+          }
+        }
+        if (!code) {
+          const build = await esbuildBuild({
+            entryPoints: [sharedFile],
+            bundle: true,
+            format: "cjs",
+            write: false,
+            target: "es2018",
+            charset: "utf8",
+            logLevel: "silent",
+            minify: true,
+            metafile: true,
+            // ★@proteus-vue/* external：运行时 require 产物 _proteus/<name>.js（微信 require 缓存同路径同实例）
+            external: ["@proteus-vue/*"],
+            plugins: [
+              {
+                name: "proteus-pkg-require-path",
+                setup(b) {
+                  b.onResolve({ filter: /^@proteus-vue\// }, (args) => {
+                    const pkgRel = `_proteus/${args.path.replace("@proteus-vue/", "")}.js`;
+                    const dir = path2.posix.dirname(relNoExt);
+                    let rel = path2.posix.relative(dir, pkgRel);
+                    if (!rel.startsWith(".")) rel = `./${rel}`;
+                    return { path: rel, external: true };
+                  });
+                }
+              }
+            ]
+          });
+          code = build.outputFiles[0]?.text ?? "";
+          if (!code) {
+            console.warn(`[mp-transform] \u5171\u4EAB\u6A21\u5757\u7F16\u8BD1\u5931\u8D25\uFF1A${relNoExt}`);
+            continue;
+          }
+          if (bundleCacheEnabled && build.metafile) {
+            const inputFiles = Object.keys(build.metafile.inputs);
+            const inputs = inputFiles.map((f) => {
+              try {
+                const st = fs2.statSync(f);
+                return { file: f, mtimeMs: st.mtimeMs, size: st.size };
+              } catch {
+                return null;
+              }
+            }).filter((x) => x !== null);
+            bundleCache.set(bundleCacheKey(sharedFile, projectRoot), { output: code, inputs });
+          }
+        }
+        this.emitFile({ type: "asset", fileName: `${relNoExt}.js`, source: code });
+        console.log(`[mp-transform] \u5171\u4EAB\u6A21\u5757 \u2192 ${relNoExt}.js\uFF08${(code.length / 1024).toFixed(1)}KB\uFF0Cbundle \u5185\u8054\uFF09`);
+      }
+      for (const [file, list] of moduleImportsByFile) {
+        const entry = files.find((f) => f.file === file);
+        if (!entry) continue;
+        const pageDir = path2.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 = path2.posix.relative(pageDir, sharedRel);
+          if (!rel.startsWith(".")) rel = `./${rel}`;
+          item.requirePath = rel;
+        }
+      }
+      for (const { file, rel } of files) {
+        const source = fs2.readFileSync(file, "utf-8");
+        const isComponent = file.includes(`${path2.sep}components${path2.sep}`);
+        const cacheEnabled = !process.env.PROTEUS_NO_CACHE && !isDebug;
+        let wxml;
+        let js;
+        let wxss;
+        let warnings = [];
+        let trace;
+        let sourcemap;
+        let cached = false;
+        if (cacheEnabled) {
+          const key = compileCacheKey(
+            source,
+            {
+              rel,
+              isComponent,
+              px2rpx,
+              rpxRatio,
+              rules,
+              moduleImports: moduleImportsByFile.get(file),
+              annotateLines: isDebug,
+              debug: isDebug,
+              autoScrollContainer
+            },
+            projectRoot
+          );
+          const entry = compileCache.get(key);
+          if (entry) {
+            wxml = entry.wxml;
+            js = entry.js;
+            wxss = entry.wxss;
+            warnings = entry.warnings;
+            cached = true;
+          } else {
+            const result = compileVueSfc(source, {
+              filename: rel,
+              isComponent,
+              px2rpx,
+              rpxRatio,
+              rules,
+              moduleImports: moduleImportsByFile.get(file),
+              annotateLines: isDebug,
+              debug: isDebug,
+              preprocessStyle,
+              autoScrollContainer
+            });
+            wxml = result.wxml;
+            js = result.js;
+            wxss = result.wxss;
+            warnings = result.warnings;
+            trace = result.trace;
+            sourcemap = result.sourcemap;
+            compileCache.set(key, { wxml, js, wxss, warnings });
+          }
+        } else {
+          const result = compileVueSfc(source, {
+            filename: rel,
+            isComponent,
+            px2rpx,
+            rpxRatio,
+            rules,
+            moduleImports: moduleImportsByFile.get(file),
+            annotateLines: isDebug,
+            debug: isDebug,
+            preprocessStyle,
+            autoScrollContainer
+          });
+          wxml = result.wxml;
+          js = result.js;
+          wxss = result.wxss;
+          warnings = result.warnings;
+          trace = result.trace;
+          sourcemap = result.sourcemap;
+        }
+        if (cached) {
+          console.log(`[mp-transform] \u7F16\u8BD1\u7F13\u5B58\u547D\u4E2D\uFF1A${rel}`);
+        }
+        const jsWithMap = sourcemap && isDebug ? `${js}//# sourceMappingURL=${rel}.js.map
+` : js;
+        this.emitFile({ type: "asset", fileName: `${rel}.wxml`, source: wxml });
+        this.emitFile({ type: "asset", fileName: `${rel}.js`, source: jsWithMap });
+        this.emitFile({ type: "asset", fileName: `${rel}.wxss`, source: wxss });
+        if (sourcemap && isDebug) {
+          this.emitFile({ type: "asset", fileName: `${rel}.js.map`, source: sourcemap });
+        }
+        if (isDebug) {
+          this.emitFile({
+            type: "asset",
+            fileName: `.transform-debug/${rel}.json`,
+            source: JSON.stringify({ file: rel, wxml, js, wxss, warnings, trace }, null, 2)
+          });
+        }
+        if (warnings.length) warningReport.push({ file: rel, warnings });
+        console.log(`[mp-transform] ${rel} \u2192 wxml/js/wxss \u5DF2\u8F93\u51FA`);
+      }
+      if (!process.env.PROTEUS_NO_CACHE && !isDebug) {
+        const st = compileCache.stats();
+        const bs = bundleCache.stats();
+        console.log(`[mp-transform] \u7F16\u8BD1\u7F13\u5B58\uFF1A${st.hits} \u547D\u4E2D / ${st.misses} \u672A\u547D\u4E2D\uFF08${files.length} \u4E2A\u6587\u4EF6\uFF09\uFF1Bbundle \u7F13\u5B58\uFF1A${bs.hits} \u547D\u4E2D / ${bs.misses} \u672A\u547D\u4E2D\uFF08${sharedModules.size} \u4E2A\u5171\u4EAB\u6A21\u5757\uFF09`);
+      }
+    },
+    buildEnd() {
+      const total = warningReport.reduce((n, w) => n + w.warnings.length, 0);
+      if (total) {
+        console.warn(`[mp-transform] \u26A0 \u7F16\u8BD1\u6458\u8981\uFF1A${warningReport.length} \u4E2A\u6587\u4EF6\u5171 ${total} \u6761\u8B66\u544A`);
+        for (const w of warningReport) {
+          console.warn(`  ${w.file}: ${w.warnings.join("\uFF1B")}`);
+        }
+      }
+    },
+    generateBundle(_options, bundle) {
+      delete bundle["mp-entry.js"];
+    }
+  };
+}
+
+// src/gen-routes.ts
+import fs3 from "node:fs";
+import path3 from "node:path";
+import { mergeMeta } from "@proteus-vue/router/merge";
+import { scanRoutes } from "@proteus-vue/router/scan";
+import { buildRouteTree } from "@proteus-vue/router/tree";
+function runGenRoutes(options) {
+  const config = options.config;
+  const ROOT = options.root ?? process.cwd();
+  const trace = options.trace ?? (() => {
+  });
+  const APP_DIR = path3.resolve(ROOT, path3.dirname(config.pagesDir));
+  const OUT_DIR = path3.join(ROOT, "dist", "mp-weixin");
+  const FW_COMPONENTS = options.frameworkComponentsDir ?? path3.join(ROOT, "src", "components");
+  const moduleChunks = /* @__PURE__ */ new Map();
+  for (const mc of options.moduleConfigs ?? []) moduleChunks.set(mc.name, mc.chunk ?? mc.name);
+  const subPackageModules = /* @__PURE__ */ new Map();
+  for (const mc of options.moduleConfigs ?? []) {
+    const chunk = mc.chunk ?? mc.name;
+    const matched = (config.subPackages ?? []).some((sp) => (sp.name ?? path3.basename(sp.root)) === chunk);
+    if (matched) subPackageModules.set(chunk, { deps: Object.keys(mc.dependencies ?? {}), preload: mc.preload ?? [] });
+    for (const dep of Object.keys(mc.dependencies ?? {})) {
+      if (!moduleChunks.has(dep)) console.warn(`[gen-routes] \u6A21\u5757 ${mc.name} \u4F9D\u8D56 "${dep}" \u672A\u627E\u5230\u5BF9\u5E94\u6A21\u5757\u5951\u7EA6\uFF08proteus-module.config.ts\uFF09\u2014\u2014\u4F9D\u8D56\u5C06\u4E0D\u751F\u6548`);
+    }
+  }
+  const subPackageNameOf = (moduleName) => {
+    const chunk = moduleChunks.get(moduleName);
+    return (config.subPackages ?? []).some((sp) => (sp.name ?? path3.basename(sp.root)) === chunk) ? chunk : void 0;
+  };
+  function walkVueFiles2(dir, acc = []) {
+    if (!fs3.existsSync(dir)) return acc;
+    for (const entry of fs3.readdirSync(dir, { withFileTypes: true })) {
+      if (entry.name.startsWith(".")) continue;
+      const full = path3.join(dir, entry.name);
+      if (entry.isDirectory()) walkVueFiles2(full, acc);
+      else if (entry.name.endsWith(".vue")) acc.push(full);
+    }
+    return acc;
+  }
+  function resolveConfigMeta(configMeta, pageRel) {
+    if (!configMeta) return void 0;
+    let dirMeta;
+    const segs = pageRel.split("/");
+    for (let i = segs.length - 1; i >= 1; i--) {
+      const prefix = segs.slice(0, i).join("/");
+      if (configMeta[prefix]) {
+        dirMeta = configMeta[prefix];
+        break;
+      }
+    }
+    const exact = configMeta[pageRel];
+    if (dirMeta && exact) return mergeMeta(dirMeta, exact);
+    return dirMeta ?? exact;
+  }
+  function scanPages() {
+    const pages2 = [];
+    const configMeta = config.router?.meta;
+    const mainBlocks = scanRoutes(path3.join(ROOT, config.pagesDir), { derivePath: true, verbose: true, includeNoRoute: true });
+    for (const b of mainBlocks) {
+      const relSrc = path3.relative(APP_DIR, b.componentPath).replace(/\\/g, "/").replace(/\.vue$/, "");
+      const pageRel = relSrc.replace(/^pages\//, "");
+      trace(`[route] ${relSrc} \u6765\u6E90\u767B\u8BB0\uFF08${b.loc.file}:${b.loc.line}\uFF0Croute/scan\uFF09`);
+      pages2.push({
+        file: b.componentPath,
+        relSrc,
+        mpPath: relSrc,
+        // ★集中 meta：config（精确/目录前缀）→ 页面 <route> 覆盖（mergeMeta 页面胜）
+        meta: mergeMeta(resolveConfigMeta(configMeta, pageRel), b.meta),
+        params: b.params,
+        pageJson: b.pageJson,
+        customRouteKeyName: b.customRouteKeyName
+      });
+    }
+    for (const sp of config.subPackages ?? []) {
+      const spRootAbs = path3.join(ROOT, sp.root);
+      const spName = sp.name ?? path3.basename(sp.root);
+      const spBlocks = scanRoutes(spRootAbs, { derivePath: true, verbose: true, includeNoRoute: true });
+      for (const b of spBlocks) {
+        const relSrc = path3.relative(APP_DIR, b.componentPath).replace(/\\/g, "/").replace(/\.vue$/, "");
+        const relInSub = path3.relative(spRootAbs, b.componentPath).replace(/\\/g, "/").replace(/\.vue$/, "");
+        const pageRel = relInSub.replace(/^pages\//, "");
+        pages2.push({
+          file: b.componentPath,
+          relSrc,
+          mpPath: relSrc,
+          subPackage: spName,
+          relInSub,
+          meta: mergeMeta(resolveConfigMeta(configMeta, pageRel), b.meta),
+          params: b.params,
+          pageJson: b.pageJson,
+          customRouteKeyName: b.customRouteKeyName,
+          chunk: b.chunk
+        });
+        if (b.chunk && b.chunk !== spName) {
+          console.warn(`[gen-routes] \u5206\u5305\u9875\u9762 ${relInSub} \u58F0\u660E chunk="${b.chunk}" \u4E0E\u5206\u5305\u540D "${spName}" \u4E0D\u4E00\u81F4\uFF08Router M7.1\uFF1A\u9875\u9762 chunk \u5E94\u5BF9\u9F50\u6A21\u5757\u5206\u5305\u540D\uFF0C\u89C1 module-plan 05\uFF09`);
+        }
+      }
+    }
+    return pages2;
+  }
+  function buildRoutes(pages2) {
+    const routes2 = pages2.map((p) => {
+      const r = {
+        // ★统一后 name 由 scan 推导（derivePath 模式：index 归并目录名，与旧 toRouteName 一致）
+        name: deriveName(p),
+        path: p.mpPath,
+        // 相对 RouterView 所在目录（{appDir}/router）的路径，Web 端 import.meta.glob 按此匹配
+        component: path3.relative(path3.join(APP_DIR, "router"), p.file).replace(/\\/g, "/")
+      };
+      if (p.subPackage) r.subPackage = p.subPackage;
+      if (p.meta && Object.keys(p.meta).length > 0) r.meta = p.meta;
+      if (p.customRouteKeyName) r.customRouteKeyName = p.customRouteKeyName;
+      if (p.params && Object.keys(p.params).length > 0) r.params = p.params;
+      return r;
+    });
+    const nameByRel = new Map(pages2.map((p) => [p.relSrc, deriveName(p)]));
+    const blocks = pages2.map((p) => ({
+      loc: { file: p.file, line: 1, column: 1 },
+      path: p.relSrc.endsWith("/index") ? p.relSrc.slice(0, -"/index".length) : p.relSrc,
+      name: nameByRel.get(p.relSrc),
+      meta: p.meta ?? {},
+      componentPath: p.file
+    }));
+    const tree = buildRouteTree(blocks, {}, trace);
+    const parentByName = /* @__PURE__ */ new Map();
+    const walk = (nodes, parent) => {
+      for (const n of nodes) {
+        if (n.name && parent) parentByName.set(n.name, parent);
+        walk(n.children, n.name);
+      }
+    };
+    walk(tree);
+    for (const r of routes2) {
+      const parent = parentByName.get(r.name);
+      if (parent && parent !== r.name) r.parent = parent;
+    }
+    return routes2;
+  }
+  function deriveName(p) {
+    const base = p.relSrc.split("/").pop() ?? "";
+    if (base === "index") {
+      const dir = p.relSrc.slice(0, p.relSrc.lastIndexOf("/"));
+      const stripped = dir.replace(/^(pages|subpackages)(\/|$)/, "").replace(/\/$/, "");
+      return stripped ? stripped.replace(/\//g, "-") : "index";
+    }
+    return p.relSrc.replace(/^(pages|subpackages)\//, "").replace(/\//g, "-");
+  }
+  function validate(pages2, routes2) {
+    const mainCount = pages2.filter((p) => !p.subPackage).length;
+    if (mainCount > 32) {
+      throw new Error(
+        `[gen-routes] \u4E3B\u5305\u9875\u9762\u6570 ${mainCount} \u8D85\u8FC7\u5E73\u53F0\u786C\u8FB9\u754C 32\uFF0C\u8BF7\u5C06\u90E8\u5206\u9875\u9762\u79FB\u5165\u5206\u5305\uFF08platform limitation, cannot exceed\uFF09`
+      );
+    }
+    const dupNames = routes2.filter((r, i) => routes2.findIndex((x) => x.name === r.name) !== i);
+    if (dupNames.length) {
+      throw new Error(`[gen-routes] \u547D\u540D\u8DEF\u7531\u91CD\u590D\uFF1A${dupNames.map((r) => r.name).join(", ")}`);
+    }
+  }
+  function formatRoute(r) {
+    const parts = [
+      `name: ${JSON.stringify(r.name)}`,
+      `path: ${JSON.stringify(r.path)}`,
+      `component: ${JSON.stringify(r.component)}`
+    ];
+    if (r.parent) parts.push(`parent: ${JSON.stringify(r.parent)}`);
+    if (r.subPackage) parts.push(`subPackage: ${JSON.stringify(r.subPackage)}`);
+    if (r.meta && Object.keys(r.meta).length) parts.push(`meta: ${JSON.stringify(r.meta)}`);
+    if (r.customRouteKeyName) parts.push(`customRouteKeyName: ${JSON.stringify(r.customRouteKeyName)}`);
+    return `  { ${parts.join(", ")} },`;
+  }
+  function writeAutoRoutes(routes2) {
+    const lines = [
+      `// ${config.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",
+      "import type { RouteRecord } from '@proteus-vue/router/types'",
+      "",
+      "export const routes: RouteRecord[] = [",
+      ...routes2.map(formatRoute),
+      "]",
+      "",
+      "export const tabRoutes: RouteRecord[] = routes.filter(r => r.meta?.isTab)",
+      "export const routeMap: Record<string, RouteRecord> = routes.reduce((m, r) => { m[r.name] = r; return m }, {} as Record<string, RouteRecord>)",
+      ""
+    ];
+    lines.push("// \u2605 \u7C7B\u578B\u63D0\u793A\uFF1A\u6309\u8DEF\u7531\u540D\u7D22\u5F15\u7684\u53C2\u6570\u7C7B\u578B\u8868\uFF08\u6765\u6E90\uFF1A<route> \u5757 params \u58F0\u660E\uFF09");
+    lines.push("declare module '@proteus-vue/router/types' {");
+    lines.push("  interface RouteParamsByName {");
+    for (const r of routes2) {
+      const params = r.params ?? {};
+      const fields = Object.entries(params);
+      const body = fields.length ? fields.map(([k, t]) => `${k}?: ${tsType(t)}`).join("; ") : "";
+      lines.push(`    '${r.name}': { ${body} },`);
+    }
+    lines.push("  }", "}");
+    const outFile = path3.join(ROOT, config.routesOutput);
+    fs3.mkdirSync(path3.dirname(outFile), { recursive: true });
+    fs3.writeFileSync(outFile, lines.join("\n"));
+    console.log(`[gen-routes] \u5DF2\u751F\u6210 ${path3.relative(ROOT, outFile)}\uFF08${routes2.length} \u6761\u8DEF\u7531 + RouteParamsByName\uFF09`);
+  }
+  function tsType(t) {
+    if (t === "number") return "number";
+    if (t === "boolean") return "boolean";
+    if (t !== "string") {
+      console.warn(`[gen-routes] \u672A\u77E5\u53C2\u6570\u7C7B\u578B ${t}\uFF08\u652F\u6301 string/number/boolean\uFF09\uFF0C\u5DF2\u6309 string \u5904\u7406`);
+    }
+    return "string";
+  }
+  function writeAppJson(pages2, routes2) {
+    const mainPages = pages2.filter((p) => !p.subPackage).map((p) => p.mpPath);
+    const entryPath = path3.relative(APP_DIR, path3.join(ROOT, config.pagesDir, "index")).replace(/\\/g, "/");
+    const entryIdx = mainPages.indexOf(entryPath);
+    if (entryIdx > 0) {
+      mainPages.splice(entryIdx, 1);
+      mainPages.unshift(entryPath);
+    }
+    const subPackages = (config.subPackages ?? []).filter((sp) => pages2.some((p) => p.subPackage === (sp.name ?? path3.basename(sp.root)))).map((sp) => {
+      const spName = sp.name ?? path3.basename(sp.root);
+      const out = {
+        root: path3.relative(APP_DIR, path3.join(ROOT, sp.root)).replace(/\\/g, "/"),
+        ...sp.name ? { name: sp.name } : {},
+        pages: pages2.filter((p) => p.subPackage === spName && p.relInSub).map((p) => p.relInSub)
+      };
+      const mod = subPackageModules.get(spName);
+      if (mod) {
+        const depNames = mod.deps.map(subPackageNameOf).filter((n) => Boolean(n));
+        if (depNames.length) out.dependencies = depNames;
+      }
+      return out;
+    });
+    const preloadRule = {};
+    for (const [spName, mod] of subPackageModules) {
+      const targetPackages = mod.preload.map(subPackageNameOf).filter((n) => Boolean(n));
+      if (!targetPackages.length) continue;
+      const entryPage = pages2.find((p) => p.subPackage === spName && p.relInSub);
+      if (!entryPage) continue;
+      preloadRule[entryPage.mpPath] = { network: "all", packages: targetPackages };
+    }
+    const windowConfig = { navigationStyle: "custom" };
+    const tabRoutes = routes2.filter((r) => r.meta?.isTab);
+    const appJson = { pages: mainPages };
+    if (subPackages.length) appJson.subPackages = subPackages;
+    if (Object.keys(preloadRule).length) appJson.preloadRule = preloadRule;
+    appJson.window = windowConfig;
+    if (config.skyline) appJson.lazyCodeLoading = "requiredComponents";
+    if (config.skyline) {
+      appJson.rendererOptions = { skyline: { defaultDisplayBlock: config.skylineLayout?.defaultDisplayBlock ?? true } };
+    }
+    if (tabRoutes.length >= 2) {
+      appJson.tabBar = {
+        list: tabRoutes.map((r) => ({ pagePath: r.path, text: r.meta?.title ?? r.name }))
+      };
+    } else if (tabRoutes.length === 1) {
+      console.warn(`[gen-routes] tabBar \u4EC5\u58F0\u660E 1 \u9879\uFF08${tabRoutes[0].name}\uFF09\uFF0C\u5FAE\u4FE1\u8981\u6C42\u81F3\u5C11 2 \u9879\uFF0C\u5DF2\u5FFD\u7565 tabBar \u914D\u7F6E\uFF1B\u53EF\u5C06\u66F4\u591A\u9875\u9762\u6807\u8BB0 isTab \u6216\u79FB\u9664\u73B0\u6709 isTab`);
+    }
+    fs3.mkdirSync(OUT_DIR, { recursive: true });
+    fs3.writeFileSync(path3.join(OUT_DIR, "app.json"), JSON.stringify(appJson, null, 2) + "\n");
+    console.log(`[gen-routes] \u5DF2\u751F\u6210 dist/mp-weixin/app.json\uFF08\u4E3B\u5305 ${mainPages.length} \u9875\uFF0C\u5206\u5305 ${subPackages.length} \u4E2A\uFF09`);
+  }
+  const NATIVE_MP_TAGS = /* @__PURE__ */ new Set([
+    "view",
+    "text",
+    "image",
+    "button",
+    "input",
+    "textarea",
+    "video",
+    "canvas",
+    "scroll-view",
+    "slot",
+    "rich-text",
+    "swiper",
+    "swiper-item",
+    "navigator",
+    "icon",
+    "progress",
+    "checkbox",
+    "radio",
+    "form",
+    "label",
+    "picker",
+    "slider",
+    "switch",
+    "map",
+    "web-view",
+    "cover-view",
+    "cover-image",
+    "movable-area",
+    "movable-view",
+    "block",
+    "template",
+    "wxs",
+    "audio",
+    "camera",
+    "live-player",
+    "ad",
+    "official-account",
+    "open-data",
+    "page-container",
+    "root-portal",
+    "match-media",
+    // ★vue-compat-advance Batch 2/5：<transition> 由编译器消费（装饰式，产物不输出该标签）——扫描跳过，非自定义组件
+    "transition"
+  ]);
+  const HTML_TAGS = /* @__PURE__ */ new Set([
+    "div",
+    "span",
+    "p",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "a",
+    "img",
+    "br",
+    "ul",
+    "ol",
+    "li",
+    "section",
+    "header",
+    "footer",
+    "main",
+    "aside",
+    "nav",
+    "article",
+    "strong",
+    "em",
+    "b",
+    "i",
+    "small",
+    "code",
+    "pre",
+    "select",
+    "option",
+    "table",
+    "tr",
+    "td",
+    "th",
+    "form",
+    "label",
+    "tbody",
+    "thead",
+    "caption",
+    "figure",
+    "figcaption",
+    "details",
+    "summary"
+  ]);
+  function collectComponents(file) {
+    const src = fs3.readFileSync(file, "utf-8");
+    const tpl = src.match(/<template[^>]*>([\s\S]*?)<\/template>/i)?.[1] ?? "";
+    const customTags = new Set(Object.keys(config.rules?.customTags ?? {}));
+    const used = /* @__PURE__ */ new Set();
+    const tagRe = /<([a-z][\w-]*)/g;
+    let m;
+    while (m = tagRe.exec(tpl)) {
+      const tag = m[1];
+      if (tag.startsWith("!")) continue;
+      if (NATIVE_MP_TAGS.has(tag) || HTML_TAGS.has(tag) || customTags.has(tag)) continue;
+      used.add(tag);
+    }
+    const out = {};
+    for (const tag of used) {
+      const appCandidates = [path3.join(APP_DIR, "components", tag, "index.vue"), path3.join(APP_DIR, "components", `${tag}.vue`)];
+      const appFound = appCandidates.find((c) => fs3.existsSync(c));
+      if (appFound) {
+        out[tag] = `/components/${tag}/index`;
+        continue;
+      }
+      const fwCandidates = [path3.join(FW_COMPONENTS, tag, "index.vue"), path3.join(FW_COMPONENTS, `${tag}.vue`)];
+      const fwFound = fwCandidates.find((c) => fs3.existsSync(c));
+      if (fwFound) {
+        out[tag] = `/proteus/${tag}/index`;
+        continue;
+      }
+      console.warn(`[gen-routes] ${file} \u4F7F\u7528\u4E86\u7EC4\u4EF6 <${tag}>\uFF0C\u4F46\u672A\u627E\u5230 ${appCandidates.join(" \u6216 ")} \u6216\u6846\u67B6\u7EC4\u4EF6 ${fwCandidates.join(" \u6216 ")}`);
+    }
+    return out;
+  }
+  function writePageJsons(pages2) {
+    for (const p of pages2) {
+      const pageJson = {};
+      if (config.skyline) {
+        pageJson.renderer = "skyline";
+        pageJson.componentFramework = "glass-easel";
+      }
+      if (p.pageJson) Object.assign(pageJson, p.pageJson);
+      const components = collectComponents(p.file);
+      if (Object.keys(components).length) pageJson.usingComponents = components;
+      const outFile = path3.join(OUT_DIR, p.mpPath + ".json");
+      fs3.mkdirSync(path3.dirname(outFile), { recursive: true });
+      fs3.writeFileSync(outFile, JSON.stringify(pageJson, null, 2) + "\n");
+    }
+    console.log(`[gen-routes] \u5DF2\u751F\u6210 ${pages2.length} \u4E2A\u9875\u9762 page.json`);
+  }
+  function writeComponentJsons() {
+    const roots = [
+      { dir: path3.join(APP_DIR, "components"), prefix: "components" },
+      { dir: FW_COMPONENTS, prefix: "proteus" }
+    ];
+    let count = 0;
+    for (const { dir, prefix } of roots) {
+      if (!fs3.existsSync(dir)) continue;
+      for (const f of walkVueFiles2(dir)) {
+        const rel = path3.relative(dir, f).replace(/\\/g, "/").replace(/\.vue$/, "");
+        const comps = collectComponents(f);
+        const outFile = path3.join(OUT_DIR, prefix, `${rel}.json`);
+        fs3.mkdirSync(path3.dirname(outFile), { recursive: true });
+        const json = { component: true };
+        json.styleIsolation = "apply-shared";
+        if (Object.keys(comps).length) json.usingComponents = comps;
+        fs3.writeFileSync(outFile, JSON.stringify(json, null, 2) + "\n");
+        count++;
+      }
+    }
+    if (count) console.log(`[gen-routes] \u5DF2\u751F\u6210 ${count} \u4E2A\u7EC4\u4EF6 component.json\uFF08component \u58F0\u660E + usingComponents \u5D4C\u5957\uFF09`);
+  }
+  function writeProjectConfig() {
+    const projectName = path3.basename(ROOT).replace(/[^\w.-]/g, "-");
+    const projectConfig = {
+      compileType: "miniprogram",
+      appid: config.appid,
+      projectname: projectName,
+      setting: { minifyWXML: true, urlCheck: false }
+    };
+    fs3.mkdirSync(OUT_DIR, { recursive: true });
+    fs3.writeFileSync(path3.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`);
+  }
+  fs3.rmSync(OUT_DIR, { recursive: true, force: true });
+  const pages = scanPages();
+  const routes = buildRoutes(pages);
+  validate(pages, routes);
+  writeAutoRoutes(routes);
+  writeAppJson(pages, routes);
+  writePageJsons(pages);
+  writeComponentJsons();
+  writeProjectConfig();
+  console.log(`[gen-routes] \u5B8C\u6210\uFF1A\u5171 ${pages.length} \u4E2A\u9875\u9762`);
+}
+export {
+  defaultScopedPlugin,
+  mpTransform,
+  runGenRoutes
+};

package/dist/plugin.d.ts

@@ -0,0 +1,61 @@
+import type { Plugin } from 'vite';
+import type { TransformRuleOverrides } from '@proteus-vue/compiler';
+import type { ProteusConfig } from './config';
+export declare function defaultScopedPlugin(): Plugin;
+export declare function resolvePkgPath(projectRoot: string, modPath: string): string;
+/**
+ * ★module-plan B0 + platform-plan B5 尾：共享模块解析（纯函数可测）
+ * - 相对路径（本地 .ts/.js）→ 产物相对 appDir 路径
+ * - @proteus-vue/*（框架包 dist）→ 产物 _proteus/<name>（白名单放行；微信 require 缓存同路径同实例）
+ * - 其余裸模块（vue/pinia 等第三方）→ null（不参与）
+ */
+export declare function resolveSharedModule(appDir: string, absFrom: string, source: string, frameworkDir?: string): {
+    file: string;
+    relNoExt: string;
+} | null;
+/**
+ * 提取 builder 函数名：function xxxBuilder(...)
+ */
+export declare function extractBuilderFnName(code: string): string | null;
+/**
+ * 组装 app.js：入口源码 + 内置预设 builder 函数定义 + 注册（纯函数，可单测）
+ * 两种模式：
+ *  ① 全量自定义（向后兼容）：入口含 App() → 原样保留入口，追加预设定义 + 注册块
+ *  ② 极简模式（★默认推荐）：入口不含 App() → 自动拼装 app 骨架（App/调试/错误捕获/预设注册），
+ *     开发者只需写自定义 builder（覆盖预设 / 新增预设），零样板
+ * 注册块在模块顶层执行（官方文档形态），builder 与 addRouteBuilder 同文件静态可分析
+ */
+export declare function assembleAppJs(mainCode: string, presets: Array<{
+    name: string;
+    fnName: string;
+    source: string;
+}>): string;
+/**
+ * 过滤被开发者覆盖的预设：main 中已 addRouteBuilder('<name>' 的预设跳过自动注册（开发者优先）
+ */
+export declare function filterOverriddenPresets(mainCode: string, presets: Array<{
+    name: string;
+    fnName: string;
+    source: string;
+}>): Array<{
+    name: string;
+    fnName: string;
+    source: string;
+}>;
+export interface PluginOptions {
+    /** ★拆包步骤 5：完整 ProteusConfig（由 vite.config 从项目 proteus.config.ts 注入） */
+    config: ProteusConfig;
+    /** 样式换算（缺省取 config.style.px2rpx） */
+    px2rpx?: boolean;
+    rpxRatio?: number;
+    /** ★底线循环 ①③：规则覆盖（缺省取 config.rules） */
+    rules?: TransformRuleOverrides;
+    /**
+     * ★框架内置组件目录（@proteus-vue/components 组件库拆包前的定位方式，决策 #115）：
+     * 组件库未拆包，仓库在工程根之外（如 monorepo 根 src/components）时，工程显式传入绝对路径；
+     * 缺省相对工程根 src/components（create-proteus 模板工程用）
+     * ★v2.0 退役：@proteus-vue/components 拆为独立 npm 包后本选项删除（改 resolvePkgPath 包内路径，见 docs/packages.md）
+     */
+    frameworkComponentsDir?: string;
+}
+export default function mpTransform(opts: PluginOptions): Plugin;

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@proteus-vue/plugin-vite",
+  "version": "0.2.0-beta.0",
+  "description": "Proteus Vite 插件（mp-weixin 编译管线适配层）+ gen-routes 路由表生成器",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && esbuild src/index.ts --bundle --format=esm --platform=node --outfile=dist/index.js --external:@proteus-vue/compiler --external:@proteus-vue/router --external:esbuild --external:sass --external:vite"
+  },
+  "dependencies": {
+    "@proteus-vue/compiler": "0.3.0-beta.0",
+    "@proteus-vue/module": "0.1.0",
+    "@proteus-vue/router": "0.2.0-beta.0",
+    "@proteus-vue/types": "0.1.0",
+    "esbuild": "^0.28.2",
+    "sass": "^1.103.1"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "vite": "^5.0.0"
+  }
+}