@qilitt-mickey/vue3-temp-skill 1.1.35 → 1.1.36

package/mapping/scenes/admin/layout.json

@@ -0,0 +1,331 @@
+{
+  "$comment": "admin 场景 · 布局模块语义 ID 全属性映射（vue3-web-temp 框架组件实证）。每条含结构定位（selector/file）、形态切换（forms）、样式映射（css_vars 优先 + custom_style_map 兜底）。style_scope 为样式必须包裹的容器类名；:root 表示全局令牌层。",
+  "meta": {
+    "layer": "scene",
+    "scene": "admin",
+    "domain": "layout",
+    "version": "1.0.0",
+    "tech_stack": "vue3 + element-plus + vue3-web-temp"
+  },
+  "mappings": {
+    "admin.layout.sidebar": {
+      "type": "module",
+      "selector": ".sidebar-container",
+      "file": "src/layout/components/lay-sidebar/NavVertical.vue",
+      "style_scope": ".sidebar-container",
+      "default_props": { "width": "var(--sidebar-width, 208px)" },
+      "children": [
+        "admin.layout.sidebar.logo_area",
+        "admin.layout.sidebar.menu",
+        "admin.layout.sidebar.collapse_trigger"
+      ],
+      "css_vars": {
+        "width": "--sidebar-width",
+        "collapsed_width": "--sidebar-collapsed-width",
+        "collapse_bar_height": "--sidebar-collapse-bar-height",
+        "menu_item_height": "--el-menu-item-height"
+      },
+      "custom_style_map": {
+        "bg": "background-color",
+        "border_right": "border-right",
+        "box_shadow": "box-shadow"
+      }
+    },
+    "admin.layout.sidebar.logo_area": {
+      "type": "element",
+      "selector": ".sidebar-logo",
+      "file": "src/layout/components/lay-sidebar/components/SidebarLogo.vue",
+      "style_scope": ".sidebar-container",
+      "visible_prop": "ShowLogo（platform-config.json / emitter logoChange）",
+      "css_vars": {
+        "height": "--vts-bar-height",
+        "bg": "--vts-theme-sidebar-logo",
+        "title_color": "--vts-theme-sub-menu-active-text"
+      },
+      "custom_style_map": {
+        "title_font_size": "font-size",
+        "title_font_weight": "font-weight"
+      }
+    },
+    "admin.layout.sidebar.menu": {
+      "type": "component",
+      "component": "ElMenu",
+      "selector": ".sidebar-container .el-menu",
+      "file": "src/layout/components/lay-sidebar/NavVertical.vue",
+      "style_scope": ".sidebar-container",
+      "css_vars": {
+        "menu_bg": "--vts-theme-menu-bg",
+        "menu_text": "--vts-theme-menu-text",
+        "menu_hover_bg": "--vts-theme-menu-hover",
+        "menu_title_hover": "--vts-theme-menu-title-hover",
+        "sub_menu_bg": "--vts-theme-sub-menu-bg",
+        "sub_menu_active_text": "--vts-theme-sub-menu-active-text",
+        "menu_active_bg": "--vts-theme-menu-active-bg",
+        "menu_active_indicator": "--vts-theme-menu-active-before",
+        "sidebar_border": "--vts-sidebar-border-color",
+        "item_height": "--el-menu-item-height"
+      },
+      "custom_style_map": {
+        "active_indicator_width": "width",
+        "active_indicator_style": "border-radius"
+      },
+      "$note": "侧栏配色挂载点为 html[data-theme='xxx']（theme.scss 8 套预设）；设计输出深色侧栏 → Theme=default + Version++（useTheme 规则），浅色 → Theme=light。menu_active_* 主题变量可被 --sidebar-* 覆写变量替换"
+    },
+    "admin.layout.sidebar.collapse_trigger": {
+      "type": "element",
+      "selector": ".left-collapse / .center-collapse",
+      "file": "src/layout/components/lay-sidebar/components/SidebarLeftCollapse.vue + SidebarCenterCollapse.vue",
+      "style_scope": ".sidebar-container",
+      "forms": {
+        "bottom_bar": "SidebarLeftCollapse（底部条，出厂默认）",
+        "center_edge": "SidebarCenterCollapse（侧缘中点，折叠/悬停时显示）"
+      },
+      "css_vars": {
+        "bar_height": "--sidebar-collapse-bar-height"
+      },
+      "custom_style_map": {
+        "trigger_width": "width",
+        "trigger_height": "height",
+        "trigger_color": "color"
+      }
+    },
+    "admin.layout.header": {
+      "type": "module",
+      "selector": ".navbar",
+      "file": "src/layout/components/lay-navbar/index.vue",
+      "style_scope": ".navbar",
+      "default_props": { "height": "var(--vts-bar-height)" },
+      "children": [
+        "admin.layout.header.logo_area",
+        "admin.layout.header.breadcrumb",
+        "admin.layout.header.lang_switch",
+        "admin.layout.header.fullscreen",
+        "admin.layout.header.setting_button",
+        "admin.layout.header.user_profile"
+      ],
+      "css_vars": {
+        "height": "--header-height",
+        "padding_x": "--header-padding-x"
+      },
+      "custom_style_map": {
+        "bg": "background-color",
+        "box_shadow": "box-shadow"
+      }
+    },
+    "admin.layout.header.logo_area": {
+      "type": "element",
+      "selector": ".navbar .siderLogo",
+      "file": "src/layout/components/lay-sidebar/components/SidebarLogo.vue（navbar 内复用）",
+      "style_scope": ".navbar",
+      "visible_note": "仅 horizontal 布局在顶栏渲染 logo（v-if layout==='horizontal' && showLogo）",
+      "css_vars": {},
+      "custom_style_map": {
+        "min_width": "min-width",
+        "height": "height"
+      }
+    },
+    "admin.layout.header.breadcrumb": {
+      "type": "component",
+      "component": "SidebarBreadCrumb",
+      "selector": ".navbar-breadcrumb-wrap",
+      "file": "src/layout/components/lay-sidebar/components/SidebarBreadCrumb.vue",
+      "style_scope": ".navbar",
+      "visible_note": "v-if layout!=='mix' && layout!=='horizontal' && device!=='mobile'",
+      "css_vars": {
+        "text_color": "--el-text-color-regular"
+      },
+      "custom_style_map": {
+        "font_size": "font-size"
+      },
+      "$note": "分隔符为结构属性（breadcrumb separator 字符），不在样式映射范围"
+    },
+    "admin.layout.header.lang_switch": {
+      "type": "component",
+      "component": "ReLanguageSwitch（ElDropdown 包裹）",
+      "selector": ".navbar .language-trigger",
+      "file": "src/components/ReLanguageSwitch/src/index.vue",
+      "style_scope": ".navbar",
+      "forms": {
+        "icon_only": "出厂现状：纯图标触发器（.language-trigger > .language-icon），下拉菜单选语言"
+      },
+      "css_vars": {
+        "icon_color": "--el-text-color-regular",
+        "hover_bg": "--el-fill-color-light"
+      },
+      "sub_selectors": {
+        "icon": ".language-trigger .language-icon",
+        "text": ".language-trigger .language-text"
+      },
+      "custom_style_map": {
+        "icon_size": "font-size",
+        "gap": "gap",
+        "text_font_size": "font-size"
+      },
+      "$note": "inline_switch 并排切换形态需增量插入片段（变更集 form=inline_switch 时按 V3.0 §4.2 v-if 保形切换，不删原代码）"
+    },
+    "admin.layout.header.fullscreen": {
+      "type": "component",
+      "component": "SidebarFullScreen",
+      "selector": "#full-screen",
+      "file": "src/layout/components/lay-sidebar/components/SidebarFullScreen.vue",
+      "style_scope": ".navbar",
+      "css_vars": {
+        "text_color": "--el-text-color-primary",
+        "hover_bg": "--el-fill-color-light"
+      },
+      "custom_style_map": {
+        "icon_size": "font-size"
+      }
+    },
+    "admin.layout.header.setting_button": {
+      "type": "element",
+      "selector": ".set-icon",
+      "file": "src/layout/components/lay-navbar/index.vue",
+      "style_scope": ".navbar",
+      "css_vars": {
+        "height": "--vts-bar-height"
+      },
+      "custom_style_map": {
+        "icon_size": "font-size",
+        "width": "width"
+      }
+    },
+    "admin.layout.header.user_profile": {
+      "type": "component",
+      "component": "ElDropdown",
+      "selector": ".navbar-right .el-dropdown-link",
+      "file": "src/layout/components/lay-navbar/index.vue",
+      "style_scope": ".navbar",
+      "sub_selectors": {
+        "$comment": "avatar/name 为点位内部部件，不设独立语义 ID（符合 4 段 ID 上限）；样式字段按前缀路由到对应选择器",
+        "avatar": ".navbar-right .el-dropdown-link img",
+        "name": ".navbar-right .el-dropdown-link p"
+      },
+      "css_vars": {
+        "height": "--vts-bar-height",
+        "text_color": "--el-text-color-primary"
+      },
+      "custom_style_map": {
+        "avatar_width": "width",
+        "avatar_height": "height",
+        "avatar_radius": "border-radius",
+        "name_font_size": "font-size",
+        "name_font_weight": "font-weight",
+        "gap": "gap"
+      }
+    },
+    "admin.layout.tabs": {
+      "type": "module",
+      "selector": ".tags-view",
+      "file": "src/layout/components/lay-tag/index.vue",
+      "style_scope": ".tags-view",
+      "visible_prop": "HideTabs（platform-config.json）",
+      "children": ["admin.layout.tabs.home_tab", "admin.layout.tabs.item", "admin.layout.tabs.context_menu"],
+      "forms": {
+        "chrome": "谷歌页签（出厂 ShowModel=chrome）",
+        "card": "卡片页签（ShowModel=card）"
+      },
+      "css_vars": {
+        "height": "--tabs-height",
+        "chrome_inset_top": "--vts-tag-chrome-inset-top",
+        "card_height": "--vts-tag-card-height",
+        "card_radius": "--vts-tag-card-radius",
+        "card_gap": "--vts-tag-card-gap",
+        "card_idle_bg": "--vts-tag-card-idle-bg",
+        "card_active_bg": "--vts-tag-card-active-bg",
+        "card_hover_bg": "--vts-tag-card-hover-bg",
+        "card_active_text": "--vts-tag-card-active-text",
+        "card_idle_text": "--vts-tag-card-idle-text",
+        "card_close_color": "--vts-tag-card-close-color"
+      },
+      "custom_style_map": {
+        "bg": "background-color",
+        "border_bottom": "border-bottom"
+      },
+      "$note": "showModel 由 platform-config.json ShowModel 字段切换；smart/line 模板未实现，映射层按 chrome/card 两形态处理"
+    },
+    "admin.layout.tabs.home_tab": {
+      "type": "element",
+      "selector": ".tags-view .tags-view-item.is-active.home-item, .tags-view .home-item",
+      "file": "src/layout/components/lay-tag/index.vue（首页页签，固定首位）",
+      "style_scope": ".tags-view",
+      "$comment": "设计侧描述（unified-framework §3）：40×40 纯图标按钮（16px home 图标），不可关闭、不可拖拽。项目侧选择器按 vue3-web-temp lay-tag 实证类名核；若类名不符，落地时以源码实证为准并回写本条目",
+      "css_vars": {
+        "width": "--vts-tag-card-height",
+        "height": "--vts-tag-card-height"
+      },
+      "custom_style_map": {
+        "icon_size": "font-size",
+        "icon_color": "color",
+        "divider_color": "border-left-color"
+      },
+      "$note": "divider（首页页签与首个业务页签间的 1px 竖线分割）属子元素结构样式，设计侧通过 divider_color 表达视觉意图"
+    },
+    "admin.layout.tabs.item": {
+      "type": "element",
+      "selector": ".tags-view .tags-view-item:not(.home-item)",
+      "file": "src/layout/components/lay-tag/index.vue（业务页签）",
+      "style_scope": ".tags-view",
+      "$comment": "设计侧描述（unified-framework §3）：点击菜单新增、同路由不重复，padding 0 12px；激活态仅文字变主色+字重 500，无下划线/背景变化；关闭钮 12×12 始终可见，hover 变 #FF4D4F。样式字段优先走 --vts-tag-card-*（layout-theme.md：card 改色/几何优先改 --vts-tag-card-*，勿另复制选择器）",
+      "css_vars": {
+        "card_height": "--vts-tag-card-height",
+        "card_radius": "--vts-tag-card-radius",
+        "card_gap": "--vts-tag-card-gap",
+        "card_idle_bg": "--vts-tag-card-idle-bg",
+        "card_active_bg": "--vts-tag-card-active-bg",
+        "card_hover_bg": "--vts-tag-card-hover-bg",
+        "card_active_text": "--vts-tag-card-active-text",
+        "card_idle_text": "--vts-tag-card-idle-text",
+        "card_close_color": "--vts-tag-card-close-color"
+      },
+      "custom_style_map": {
+        "padding_x": "padding-inline",
+        "divider_color": "border-left-color",
+        "close_size": "font-size",
+        "close_hover_color": "color"
+      },
+      "$note": "card 形态专属令牌挂在父级 admin.layout.tabs 的 css_vars（整组切换）；本条目为页签项级字段补充。chrome 形态梯形样式为模板结构样式，不走样式映射"
+    },
+    "admin.layout.tabs.context_menu": {
+      "type": "element",
+      "selector": ".tags-view .tags-options",
+      "file": "src/layout/components/lay-tag/index.vue（右键菜单容器）",
+      "style_scope": ".tags-view",
+      "$comment": "设计侧描述（unified-framework §3）：右键菜单含刷新/关闭左侧/关闭右侧/关闭其他，宽 160px，圆角 8px。vue3-web-temp 实证容器类名为 .tags-options（lay-tag/index.vue 结构实证）",
+      "css_vars": {
+        "radius": "--el-popper-border-radius",
+        "item_height": "--el-dropdown-menuItem-height"
+      },
+      "custom_style_map": {
+        "width": "width",
+        "bg": "background-color",
+        "item_font_size": "font-size"
+      },
+      "$note": "item_height 若 EP 未暴露 popper 级变量，AI 施工时以 .tags-options li { height } 自定义实现并回写本条目——两层机制天然兜底"
+    },
+    "admin.layout.content": {
+      "type": "module",
+      "selector": ".app-main",
+      "file": "src/layout/components/lay-content/index.vue",
+      "style_scope": ".app-main",
+      "css_vars": {
+        "padding": "--layout-content-padding"
+      },
+      "custom_style_map": {
+        "bg": "background-color"
+      },
+      "$note": "内容区高度链为壳层定高体系（vts-page-card/vts-page-fill），业务页面布局语义见 content.* 语义 ID"
+    },
+    "admin.layout.footer": {
+      "type": "module",
+      "selector": ".main-content 之后的 footer 区（出厂未常驻渲染）",
+      "file": "—",
+      "style_scope": ":root",
+      "visible_prop": "HideFooter（platform-config.json）",
+      "css_vars": {
+        "height": "--layout-footer-height"
+      },
+      "custom_style_map": {}
+    }
+  }
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.35",
+  "version": "1.1.36",
+  "type": "module",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {
     "vue3-temp-skill": "./bin/cli.js"
@@ -13,6 +14,9 @@
     "bin/",
     "references/",
     "scripts/",
+    "mapping/",
+    "parser/",
+    "dist/",
     "SKILL.md",
     "README.md"
   ],
@@ -25,12 +29,12 @@
     "release:major": "node release.js major",
     "check": "node scripts/check.mjs",
     "prepack": "node scripts/check.mjs",
-    "audit": "node scripts/field-schema-audit.mjs",
     "validate": "node scripts/validate.mjs",
     "match": "python scripts/match.py",
     "match:batch": "python scripts/match.py --batch",
-    "handoff:init": "node scripts/handoff.mjs init",
-    "handoff:check": "node scripts/handoff.mjs check",
+    "mapping:build": "node parser/index.js build",
+    "mapping:watch": "node parser/watch.js",
+    "regression": "node parser/regression.js",
     "postpublish": "echo 'Published @qilitt-mickey/vue3-temp-skill to npmjs.org'"
   },
   "keywords": [

package/parser/fixtures/changeset-legacy.json

@@ -0,0 +1,11 @@
+{
+  "$comment": "端到端验证夹具 · 旧协议兼容：v0.2 曾用的顶层 layout 键（应触发告警但按值处理）+ 历史值 schema design-changeset/v1（应告警不阻断）。预期 exit 0 + 两条 ⚠ 告警。",
+  "schema": "design-changeset/v1",
+  "changeset_version": "0.2.0",
+  "mapping_version": "1.0.0",
+  "scene": "admin",
+  "layout": "mix",
+  "changes": [
+    { "id": "admin.layout.tabs", "style": { "card_radius": "小圆角" } }
+  ]
+}

package/parser/fixtures/changeset-neg1.json

@@ -0,0 +1,17 @@
+{
+  "$comment": "端到端验证夹具 · 负例 1：缺 schema + 禁词/hex 位置违规 + 非法 ID。预期被 parser 阻断（exit 1，输出违规清单：缺 mapping_version 提示会在 schema 检查前？不会——schema 先检）。注意本夹具故意缺 schema 与 mapping_version：parser 应在第一步 schema 校验即拒绝。",
+  "changeset_version": "1.0.0",
+  "scene": "admin",
+  "changes": [
+    {
+      "id": "admin.layout.sidebar.menu",
+      "position": "left 20px margin-left .sidebar",
+      "form": "card",
+      "style": { "menu_bg": "#1d223a" }
+    },
+    {
+      "id": "admin.content.sidebar.ElMenu",
+      "style": { "bg": "红色" }
+    }
+  ]
+}

package/parser/fixtures/changeset-neg2.json

@@ -0,0 +1,10 @@
+{
+  "$comment": "端到端验证夹具 · 负例 2：mapping_version 不匹配。预期被 parser 拒绝（exit 1，提示当前映射集版本与依赖版本不一致）。",
+  "schema": "design.changeset/1.0",
+  "changeset_version": "1.0.0",
+  "mapping_version": "9.9.9",
+  "scene": "admin",
+  "changes": [
+    { "id": "admin.layout.tabs", "form": "card" }
+  ]
+}

package/parser/fixtures/changeset-neg3.json

@@ -0,0 +1,22 @@
+{
+  "$comment": "端到端验证夹具 · 负例 3：禁词/非法 ID/位置违规（schema 与版本均合法，专测 checkBannedWords）。预期被阻断并列出：position 含 .sidebar 选择器写法与像素坐标、id 含 ElMenu 技术词与大写、id 不符合命名规范。",
+  "schema": "design.changeset/1.0",
+  "changeset_version": "1.0.0",
+  "mapping_version": "1.0.0",
+  "scene": "admin",
+  "changes": [
+    {
+      "id": "admin.layout.sidebar.menu",
+      "position": "left 20px .sidebar-container",
+      "style": { "menu_bg": "#1d223a" }
+    },
+    {
+      "id": "admin.content.sidebar.ElMenu",
+      "style": { "bg": "红色" }
+    },
+    {
+      "id": "admin.layout.tabs.item.v2.extra",
+      "style": { "padding_x": "宽松" }
+    }
+  ]
+}

package/parser/fixtures/changeset-pos.json

@@ -0,0 +1,43 @@
+{
+  "$comment": "端到端验证夹具 · 正例：语义值 + 临时主题 hex + pending + layout_type + global 全通道覆盖。预期全部通过（L1/L2 命中、钴蓝-5→#245BFF 译表解析、pending 携带功能描述、无阻断）。运行：node parser/index.js match parser/fixtures/changeset-pos.json（cwd 为 skill 根）。",
+  "schema": "design.changeset/1.0",
+  "changeset_version": "1.0.0",
+  "mapping_version": "1.0.0",
+  "scene": "admin",
+  "layout_type": "horizontal",
+  "global": { "brand_primary": "钴蓝-5" },
+  "changes": [
+    {
+      "id": "admin.layout.sidebar.menu",
+      "style": { "menu_bg": "钴蓝-9", "menu_active_bg": "钴蓝-5" }
+    },
+    {
+      "id": "component.button.primary",
+      "style": { "bg_color": "钴蓝-5", "font_weight": "中等" }
+    },
+    {
+      "id": "admin.layout.tabs",
+      "form": "card"
+    },
+    {
+      "id": "admin.layout.sidebar.collapse_trigger",
+      "visible": false
+    },
+    {
+      "id": "portal.content.banner.carousel",
+      "style": { "bg": "#7C3AED" }
+    },
+    {
+      "id": "admin.layout.header.user_profile",
+      "style": { "avatar_radius": "全圆角", "unknown_field": "应进字段级待补充" }
+    }
+  ],
+  "pending": [
+    {
+      "proposed_id": "portal.content.banner.carousel",
+      "function": "门户首页顶部轮播横幅",
+      "parent": "portal.content.banner"
+    }
+  ],
+  "notes": "临时主题：主色 #7C3AED，hover 取 85% 不透明度"
+}

package/parser/generator.js

@@ -0,0 +1,178 @@
+/**
+ * generator.js — 多格式产物生成器
+ *
+ * 校验通过后，从 mapping/ 数据集生成 dist/ 下四种可交付产物：
+ *   1. dist/theme.css        CSS 变量全局基线（:root 层，链路 A 空白项目按需引入）
+ *   2. dist/theme-vars.ts    TypeScript 类型化主题变量对象
+ *   3. dist/theme-vars.js    ESM 运行时入口（themeVars + overrideMapping，§3.4.4.3）
+ *   4. dist/mapping-type.d.ts 映射类型声明
+ *
+ * 链路 A（业务项目直接消费产物）按 V3.1 §4.5.3 后置：产物随 NPM 包发布但不被
+ * vue3-web-temp 引入（其自有 design-tokens.scss 为权威令牌源，避免双令牌源冲突）。
+ *
+ * 用法：node parser/generator.js [--out <dir>] [--dry]
+ */
+
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildMappingDataset } from "./loader.js";
+import { buildMergedIndex } from "./validator.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+
+// ---- CLI ----
+if (process.argv[1] && process.argv[1].endsWith("generator.js")) {
+  const outIdx = process.argv.indexOf("--out");
+  const outDir = outIdx > -1 ? path.resolve(process.argv[outIdx + 1]) : path.join(ROOT, "dist");
+  const dry = process.argv.includes("--dry");
+  const result = generateAll(outDir, dry);
+  if (!dry) {
+    console.log(`✔ 产物生成完成 → ${outDir}`);
+    for (const f of result.written)
+      console.log(`  · ${f}`);
+  }
+  else {
+    console.log(`[dry-run] 将生成 ${result.written.length} 个文件 → ${outDir}`);
+  }
+}
+
+/** 汇总所有 tokens（basic/layout 域的令牌定义），返回 { abstractField, token, default } 数组 */
+export function collectTokens(dataset) {
+  const rows = [];
+  for (const [file, data] of Object.entries(dataset.files)) {
+    if (!data.tokens)
+      continue;
+    for (const [field, def] of Object.entries(data.tokens)) {
+      if (field.startsWith("$"))
+        continue;
+      // token 链（"A → B"）拆为数组：链上每个实现令牌都要生成
+      const tokenChain = typeof def.token === "string" && def.token.includes(" → ")
+        ? def.token.split(" → ").map(s => s.trim()).filter(Boolean)
+        : [def.token || ""];
+      rows.push({
+        abstract: field,
+        token: tokenChain[0],
+        tokenChain,
+        default: def.default ?? "",
+        file,
+      });
+    }
+  }
+  return rows;
+}
+
+export function generateAll(outDir, dry = false) {
+  const dataset = buildMappingDataset();
+  const tokens = collectTokens(dataset);
+  const written = [];
+
+  // ---- 1. theme.css：链路 A 变量基线（V3.1 §4.5.3）----
+  // 有出厂值的令牌生成真实 CSS 自定义属性（空白项目引入即得完整基线）；
+  // 无出厂值的仅生成注释索引（需项目侧自行定值）。
+  const cssBody = [];
+  for (const t of tokens) {
+    if (!t.default) {
+      cssBody.push(`  /* ${t.abstract} → ${t.token || "(value token)"}（无出厂值，需项目侧定值） */`);
+      continue;
+    }
+    for (const token of t.tokenChain) {
+      if (!token)
+        continue;
+      cssBody.push(`  ${token}: ${t.default}; /* ← ${t.abstract} */`);
+    }
+  }
+  const cssLines = [
+    "/* AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT */",
+    "/* 链路 A（基线注入）产物：全局令牌变量基线（V3.1 §4.5.3）。",
+    " * 仅空白新项目从零接入 Skill 主题体系时在样式入口引入一次；",
+    " * 成熟模板项目（自有 design-tokens.scss 权威令牌源）不得引入，避免双令牌源冲突。 */",
+    ":root {",
+    ...cssBody,
+    "}",
+    "",
+  ];
+
+  // ---- 2. theme-vars.ts：类型化变量对象 ----
+  const tsLines = [
+    "// AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT",
+    "export const themeVars = {",
+    ...tokens.map(t => `  /** ${t.tokenChain.join(" → ") || "value token"}${t.default ? ` 出厂 ${t.default}` : ""} */`),
+    ...tokens.map(t => `  ${toCamel(t.abstract)}: '${t.default}' as string,`),
+    "} as const;",
+    "",
+    "export type ThemeVarKey = keyof typeof themeVars;",
+    "",
+  ];
+
+  // ---- 2.5 theme-vars.js：ESM 运行时入口（链路 A 配套，业务级覆写 API 挂载点 §3.4.4.3）----
+  const jsLines = [
+    "// AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT",
+    "// 链路 A 运行时入口：themeVars + overrideMapping（业务级覆写，V3.1 §3.4.4.3）",
+    "// 用法：import { themeVars, overrideMapping } from '@qilitt-mickey/vue3-temp-skill/dist/theme-vars.js';",
+    "//       const custom = overrideMapping(themeVars, { color: { brandPrimary: '#ff6600' } });",
+    "export const themeVars = {",
+    ...tokens.map(t => `  ${toCamel(t.abstract)}: '${t.default}',`),
+    "};",
+    "",
+    "export { overrideMapping, overrideMappings } from '../parser/override.js';",
+    "",
+  ];
+
+  // ---- 3. mapping-type.d.ts：映射条目类型声明 ----
+  const dtsLines = [
+    "// AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT",
+    "",
+    "/** 语义 ID 映射条目（结构与 mapping/scenes/**.json 条目一致） */",
+    "export interface SemanticMappingEntry {",
+    "  type: 'module' | 'component' | 'element' | 'global_component' | 'global_token';",
+    "  selector?: string;",
+    "  component?: string;",
+    "  file?: string;",
+    "  style_scope: string;",
+    "  default_props?: Record<string, unknown>;",
+    "  children?: string[];",
+    "  forms?: Record<string, string>;",
+    "  visible_prop?: string;",
+    "  css_vars?: Record<string, string>;",
+    "  custom_style_map?: Record<string, string>;",
+    "  [key: string]: unknown;",
+    "}",
+    "",
+    "/** 设计变更集（design.changeset/1.0 输入，兼容历史值 design-changeset/v1） */",
+    "export interface DesignChangeset {",
+    "  schema: 'design.changeset/1.0' | 'design-changeset/v1';",
+    "  mapping_version?: string;",
+    "  scene: string;",
+    "  layout_type?: string;",
+    "  global?: Record<string, Record<string, string | number>>;",
+    "  changes: Array<{",
+    "    id: string;",
+    "    visible?: boolean;",
+    "    position?: Record<string, string>;",
+    "    form?: string;",
+    "    style?: Record<string, string | number>;",
+    "  }>;",
+    "}",
+    "",
+  ];
+
+  if (!dry) {
+    mkdirSync(outDir, { recursive: true });
+    writeFileSync(path.join(outDir, "theme.css"), cssLines.join("\n"), "utf-8");
+    writeFileSync(path.join(outDir, "theme-vars.ts"), tsLines.join("\n"), "utf-8");
+    writeFileSync(path.join(outDir, "theme-vars.js"), jsLines.join("\n"), "utf-8");
+    writeFileSync(path.join(outDir, "mapping-type.d.ts"), dtsLines.join("\n"), "utf-8");
+    written.push("theme.css", "theme-vars.ts", "theme-vars.js", "mapping-type.d.ts");
+  }
+  else {
+    written.push("theme.css", "theme-vars.ts", "theme-vars.js", "mapping-type.d.ts");
+  }
+
+  return { written, tokenCount: tokens.length };
+}
+
+function toCamel(s) {
+  return s.replaceAll(/[_-](\w)/g, (_, c) => c.toUpperCase());
+}