@qilitt-mickey/vue3-temp-skill 1.1.72 → 1.1.75

package/parser/generator.js

@@ -1,178 +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());
-}
+/**
+ * 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（业务项目直接消费产物）：产物随 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 变量基线 ----
+  // 有出厂值的令牌生成真实 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（基线注入）产物：全局令牌变量基线。",
+    " * 仅空白新项目从零接入 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（业务级覆写）",
+    "// 用法：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());
+}