@qilitt-mickey/vue3-temp-skill 1.1.76 → 1.2.2

package/parser/loader.js

@@ -1,66 +0,0 @@
-/**
- * loader.js — mapping/ 目录读取与合并
- *
- * 递归遍历 mapping/ 下所有 .json 文件，按目录层级合并为完整映射数据集。
- * 合并顺序（后加载覆盖先加载，同 ID 时场景级扩展全局定义）：
- *   basic/ → layout/ → component/ → scenes/<scene>/
- */
-
-import { readdirSync, readFileSync, statSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const MAPPING_ROOT = path.resolve(__dirname, "..", "mapping");
-
-/** 递归收集 JSON 文件（按目录名字典序，保证合并顺序稳定） */
-function collectJsonFiles(dir) {
-  const out = [];
-  for (const name of readdirSync(dir).sort()) {
-    if (name.startsWith("_") || name.startsWith("."))
-      continue;
-    const full = path.join(dir, name);
-    const st = statSync(full);
-    if (st.isDirectory())
-      out.push(...collectJsonFiles(full));
-    else if (name.endsWith(".json"))
-      out.push(full);
-  }
-  return out;
-}
-
-/**
- * 构建映射数据集。
- * @returns {{ files: Record<string, object>, fileCount: number, ids: Record<string, {file, meta}> }}
- */
-export function buildMappingDataset() {
-  const files = {};
-  const idSource = {};
-
-  for (const filePath of collectJsonFiles(MAPPING_ROOT)) {
-    const rel = path.relative(MAPPING_ROOT, filePath).replaceAll("\\", "/");
-    let data;
-    try {
-      data = JSON.parse(readFileSync(filePath, "utf-8"));
-    }
-    catch (e) {
-      throw new Error(`[mapping/${rel}] JSON 解析失败：${e.message}`);
-    }
-    files[rel] = data;
-
-    if (data.mappings) {
-      for (const id of Object.keys(data.mappings)) {
-        if (id.startsWith("$"))
-          continue;
-        if (idSource[id])
-          console.warn(`  ⚠ 语义 ID「${id}」在 ${idSource[id].file} 与 ${rel} 中重复，后者覆盖`);
-        idSource[id] = { file: rel, meta: data.meta || {} };
-      }
-    }
-  }
-
-  return { files, fileCount: Object.keys(files).length, idSource };
-}
-
-/** 供 validator 使用的别名（保持独立可测） */
-export { buildMappingDataset as buildMappingDatasetForValidator };

package/parser/override.js

@@ -1,119 +0,0 @@
-/**
- * override.js — 业务级映射覆写 API（可选扩展）
- *
- * 用途：业务项目存在少量自定义映射需求时，通过本 API 在运行时覆写
- * 指定字段，无需在业务侧维护完整 mapping/ 目录。
- *
- * 设计约束（严格按方案）：
- *   1. 浅覆写 + 深合并：覆写只落在传入的 key 上，未提及的映射原样保留。
- *   2. 不可变：返回新对象，不修改传入的 themeVars / 映射数据集。
- *   3. 白名单校验：只允许覆写词典中已存在的 key——防止业务侧拼错字段名
- *      造成静默失效（与 parser「守门员」职责一致：错误数据进不了链路）。
- *      需要放开时传 { strict: false }，未知 key 将产生告警但不阻断。
- *   4. 本 API 属链路 A（基线注入）配套能力：服务于「空白新项目从零接入
- *      Skill 主题体系」的场景；成熟模板项目（如 vue3-web-temp）不引入。
- *
- * 用法：
- *   import { themeVars, overrideMapping } from "@qilitt-mickey/vue3-temp-skill/dist/theme-vars.js";
- *   const custom = overrideMapping(themeVars, { color: { brandPrimary: "#ff6600" } });
- *
- * 或对语义 ID 映射条目覆写（parser 内部使用）：
- *   const entry = overrideMapping(baseEntry, { css_vars: { menu_bg: "--custom-var" } }, { id: "admin.layout.sidebar.menu" });
- */
-
-/** 递归合并覆写：override 中的值覆盖 base，对象做深合并，其余类型直接替换 */
-function deepMerge(base, override) {
-  const out = Array.isArray(base) ? [...base] : { ...base };
-  for (const [k, v] of Object.entries(override ?? {})) {
-    if (v !== null && typeof v === "object" && !Array.isArray(v)
-      && out[k] !== null && typeof out[k] === "object" && !Array.isArray(out[k])) {
-      out[k] = deepMerge(out[k], v);
-    }
-    else {
-      out[k] = v;
-    }
-  }
-  return out;
-}
-
-/**
- * 覆写映射对象。
- * @param {object} base     基础映射（themeVars / 单个映射条目 / 整个 dataset）
- * @param {object} override 覆写片段，结构与 base 对应部分同构
- * @param {{ id?: string, strict?: boolean }} [opts]
- *   - id：被覆写对象的标识（用于错误提示，如语义 ID 名）
- *   - strict：默认 true——override 中出现 base 不存在的 key 时抛错
- * @returns {object} 新对象（base 不被修改）
- */
-export function overrideMapping(base, override, opts = {}) {
-  const { id = "mapping", strict = true } = opts;
-  if (base === null || typeof base !== "object")
-    throw new TypeError(`overrideMapping: base 必须为对象（${id}）`);
-  if (override === null || override === undefined)
-    return base;
-  if (typeof override !== "object")
-    throw new TypeError(`overrideMapping: override 必须为对象（${id}）`);
-
-  // 白名单校验：只允许覆写已存在的 key（拼错字段名直接暴露）
-  for (const k of Object.keys(override)) {
-    if (!(k in base)) {
-      const msg = `overrideMapping: 「${k}」在 ${id} 中不存在，无法覆写${strict ? "（strict 模式，疑似字段名拼写错误）" : "（已忽略）"}`;
-      if (strict)
-        throw new Error(msg);
-      console.warn(`  ⚠ ${msg}`);
-    }
-  }
-
-  return deepMerge(base, override);
-}
-
-/**
- * 便捷封装：批量覆写多个语义 ID 条目。
- * @param {Record<string, object>} index  合并索引（id → 条目），如 buildMergedIndex 结果
- * @param {Record<string, object>} overrides { 语义ID: 覆写片段 }
- * @param {{ strict?: boolean }} [opts]
- * @returns {Record<string, object>} 新索引
- */
-export function overrideMappings(index, overrides, opts = {}) {
-  const out = { ...index };
-  for (const [id, patch] of Object.entries(overrides)) {
-    if (!out[id]) {
-      const msg = `overrideMappings: 语义 ID「${id}」不在词典中，无法覆写`;
-      if (opts.strict !== false)
-        throw new Error(msg);
-      console.warn(`  ⚠ ${msg}`);
-      continue;
-    }
-    out[id] = overrideMapping(out[id], patch, { id, strict: opts.strict !== false });
-  }
-  return out;
-}
-
-// ---- CLI 独立执行：对一份 changeset 计算覆写结果（调试用）----
-// 用法：node parser/override.js <overrides.json>
-//   overrides.json 形如 { "admin.layout.sidebar.menu": { "css_vars": { "menu_bg": "--x" } } }
-if (process.argv[1] && process.argv[1].endsWith("override.js")) {
-  const { readFileSync } = await import("node:fs");
-  const { buildMappingDataset } = await import("./loader.js");
-  const { buildMergedIndex } = await import("./validator.js");
-  const file = process.argv[2];
-  if (!file) {
-    console.error("用法：node parser/override.js <overrides.json>");
-    process.exit(1);
-  }
-  try {
-    const overrides = JSON.parse(readFileSync(file, "utf-8"));
-    const dataset = buildMappingDataset();
-    const index = buildMergedIndex(dataset);
-    const merged = overrideMappings(index, overrides);
-    const changed = Object.keys(overrides).filter(id => merged[id]);
-    console.log(`✔ 覆写成功 ${changed.length} 条：`);
-    for (const id of changed)
-      console.log(`  - ${id}`);
-    console.log(JSON.stringify(Object.fromEntries(changed.map(id => [id, merged[id]])), null, 2));
-  }
-  catch (e) {
-    console.error(`✖ 覆写失败：${e.message}`);
-    process.exit(1);
-  }
-}

package/parser/regression.js

@@ -1,301 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * A-T 端到端一键回归（作者侧维护工具，不随技能分发）
- *
- * 用法（cwd 任意，脚本内部已固定为 skill 根目录执行）：
- *   node parser/regression.js
- *   npm run regression
- *
- * 步骤与预期同 references/design-apply.md「端到端回归」一一对应：
- *   A  validator 映射词典全量校验          → exit 0
- *   B  list 场景清单与版本头               → exit 0
- *   C  match 正例                          → exit 0 且输出含 #245BFF（语义值译表解析）
- *   C2 match 缺口阻断（L3 点位 + 字段级未命中） → exit 1 且输出含「缺口清单」（缺口不静默放行）
- *   D  match 负例1（缺 schema）            → exit 1
- *   E  match 负例2（mapping_version 不符） → exit 1
- *   F  match 负例3（禁词阻断）             → exit 1
- *   G  match 旧协议兼容                    → exit 0 且输出含 ⚠ 告警
- *   H  match 整页场景还原样例（mode=restore）→ exit 0 且输出含 #245BFF 与「G8 模式闸」（壳层+内容区全模块 L1）
- *   P  match G8 负例（mode=restore 缺 oracle/coverage）→ exit 1 且输出含「G8 模式闸」（伪还原变更集拦截）
- *   Q  match G8 强化负例（mode=restore 但 mockup/registry 为空壳）→ exit 1 且输出含「G8 模式闸」（有壳无芯伪基线拦截）
- *   R  match G9 负例（scheme=tangerine 却引 default 方案登记表 = 身份错配）→ exit 1 且输出含「G9 登记表身份闸」（分母偷换拦截）
- *   S  match G10 负例（header_cell ID 已声明但缺 text_align/nowrap 维度）→ exit 1 且输出含「G10」与「缺 dims=」（点位在细节丢拦截）
- *   T  match G11 负例（橘橙主色配钴蓝效果图且无 theme_mapping = 主题错配）→ exit 1 且输出含「G11」与「主题错配」（基线断裂拦截）
- *   I  build --dry 产物链自检              → exit 0 且输出含 dry-run
- *   J  match  三声明维度                → exit 0 且输出含「结构施工 structure_ops」
- *   K  audit 挂载点 / 死通道审计            → exit 1（夹具项目故意存在挂载点缺失 / 死通道）
- *   L  verify 渲染态逐点验收                → exit 1 且归因各计其数（夹具含故意缺口：三类渲染缺口 + G12 存在性 + G14 状态 + G15 孤儿）
- *   M  match 登记表覆盖率细闸               → exit 1（夹具故意欠声明两条恒存在子项）
- *   N  registry 登记表通道核验              → exit 0 且输出含「登记表通道核验」
- *   O  registry 硬缺口负例                  → exit 1（引用了不存在且未标 pending 的点位）
- *   U  verify 残差豁免 + 收口 + 状态 + 无孤儿正例（clean 夹具）→ exit 0 且输出含「已申报残差」「已收口」「状态断言 1/1 命中」（申报点位不计缺口、收口/状态绿灯、无孤儿）
- *   V  verify 快照回归（snapshot → baseline）→ clean 快照为基线、缺口夹具为实测 → exit 1 且输出含「基线漂移」（上轮命中本轮退步必红）
- *
- * 任一步骤失败 → 本脚本 exit 1，并回显该步骤完整输出便于定位。
- */
-
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { existsSync } from "node:fs";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(__dirname, "..");
-const INDEX = path.join(__dirname, "index.js");
-const VALIDATOR = path.join(__dirname, "validator.js");
-const FIXTURES = path.join(__dirname, "fixtures");
-
-// 前置自检：fixtures 缺失（如被误删或处于用户安装副本）直接说明并退出
-if (!existsSync(FIXTURES)) {
-  console.error("✖ 未找到 parser/fixtures/ —— 回归夹具缺失。");
-  console.error("  本工具是作者侧维护工具，仅在 skill 仓库内可用；");
-  console.error("  若在仓库内见到此提示，请检查 fixtures 目录是否被误删。");
-  process.exit(1);
-}
-
-const steps = [
-  {
-    key: "A",
-    name: "validator 映射词典全量校验",
-    script: VALIDATOR,
-    args: [],
-    expect: { code: 0 },
-  },
-  {
-    key: "B",
-    name: "list 场景清单与版本头",
-    script: INDEX,
-    args: ["list", "--scene", "admin", "--verbose"],
-    expect: { code: 0 },
-  },
-  {
-    key: "C",
-    name: "match 正例（译表解析 + pending）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-pos.json")],
-    expect: { code: 0, includes: "#245BFF" },
-  },
-  {
-    key: "C2",
-    name: "match 缺口阻断（词典未登记点位 L3 + 字段级未命中 → exit 1，缺口清单不静默放行）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-gap-block.json")],
-    expect: { code: 1, includes: "缺口清单" },
-  },
-  {
-    key: "D",
-    name: "match 负例1（缺 schema → 拒绝）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg1.json")],
-    expect: { code: 1 },
-  },
-  {
-    key: "E",
-    name: "match 负例2（mapping_version 不匹配 → 拒绝）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg2.json")],
-    expect: { code: 1 },
-  },
-  {
-    key: "F",
-    name: "match 负例3（禁词 → 阻断）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg3.json")],
-    expect: { code: 1 },
-  },
-  {
-    key: "G",
-    name: "match 旧协议兼容（exit 0 + 双告警）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-legacy.json")],
-    expect: { code: 0, includes: "⚠" },
-  },
-  {
-    key: "H",
-    name: "match 整页场景还原样例（mode=restore 基线三件套 + 壳层+内容区全模块 L1 + 数值字面量透传）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-fullpage-restore.json")],
-    expect: { code: 0, includes: ["#245BFF", "G8 模式闸"] },
-  },
-  {
-    key: "I",
-    name: "build --dry 产物链自检",
-    script: INDEX,
-    args: ["build", "--dry"],
-    expect: { code: 0, includes: "dry-run" },
-  },
-  {
-    key: "J",
-    name: "match  三声明维度 + coverage 覆盖率（apply_via / layer / structure_ops / coverage）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-v32-fields.json")],
-    expect: { code: 0, includes: ["结构施工 structure_ops", "验收基线 oracle", "覆盖率 coverage"] },
-  },
-  {
-    key: "K",
-    name: "audit 挂载点 / 死通道审计（夹具项目应报出问题 → exit 1）",
-    script: INDEX,
-    args: ["audit", "--project", path.join(FIXTURES, "fake-project"), path.join(FIXTURES, "changeset-v32-fields.json")],
-    expect: { code: 1, includes: "挂载 / 通道问题" },
-  },
-  {
-    key: "L",
-    name: "verify 渲染态逐点验收（夹具含四类缺口 + G12 存在性 + G14 状态 + G15 孤儿 → exit 1）",
-    script: INDEX,
-    args: ["verify", "--oracle", path.join(FIXTURES, "verify", "oracle.json"), "--actual", path.join(FIXTURES, "verify", "actual.json")],
-    expect: { code: 1, includes: ["选择器落空 2 / 权重被压 3 / 语境错位 2", "存在性缺口 1", "状态缺口 1", "孤儿点位 1"] },
-  },
-  {
-    key: "M",
-    script: INDEX,
-    args: ["match", "--registry", path.join(FIXTURES, "registry-sample.json"), path.join(FIXTURES, "changeset-registry-gap.json")],
-    expect: { code: 1, includes: ["登记表覆盖率", "缺口 2"] },
-  },
-  {
-    key: "N",
-    name: "registry 登记表通道核验（点位全部命中 → exit 0）",
-    script: INDEX,
-    args: ["registry", path.join(FIXTURES, "registry-sample.json")],
-    expect: { code: 0, includes: ["登记表通道核验", "登记项 6 条"] },
-  },
-  {
-    key: "O",
-    name: "registry 硬缺口负例（引用不存在且未标 pending 的点位 → exit 1）",
-    script: INDEX,
-    args: ["registry", path.join(FIXTURES, "registry-bad.json")],
-    expect: { code: 1, includes: "硬缺口" },
-  },
-  {
-    key: "P",
-    name: "match G8 模式闸负例（mode=restore 缺 oracle/coverage = 伪还原变更集 → exit 1）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg4-g8.json")],
-    expect: { code: 1, includes: "G8 模式闸" },
-  },
-  {
-    key: "Q",
-    name: "match G8 强化负例（mode=restore 但 oracle.mockup / coverage.registry 为空壳 = 有壳无芯 → exit 1）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg5-g8-stub.json")],
-    expect: { code: 1, includes: "G8 模式闸" },
-  },
-  {
-    key: "R",
-    name: "match G9 负例（scheme=tangerine 却引 default 方案登记表 = 身份错配 → exit 1）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg6-g9-identity.json")],
-    expect: { code: 1, includes: "G9 登记表身份闸" },
-  },
-  {
-    key: "S",
-    name: "match G10 负例（header_cell ID 已声明但缺 text_align/nowrap 维度 = 点位在细节丢 → exit 1）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg7-g10-dims.json")],
-    expect: { code: 1, includes: ["G10", "缺 dims="] },
-  },
-  {
-    key: "T",
-    name: "match G11 负例（橘橙主色配钴蓝效果图且无 theme_mapping = 主题错配 → exit 1）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-neg8-g11-oracle.json")],
-    expect: { code: 1, includes: ["G11", "主题错配"] },
-  },
-  {
-    key: "U",
-    name: "verify 残差豁免 + 收口 + 状态 + 无孤儿正例（clean 夹具：申报不计缺口、absent 已收口、G14 状态命中、G15 无孤儿 → exit 0）",
-    script: INDEX,
-    args: ["verify", "--oracle", path.join(FIXTURES, "verify", "oracle.json"), "--actual", path.join(FIXTURES, "verify", "actual-clean.json")],
-    expect: { code: 0, includes: ["已申报固有残差", "已收口", "状态断言 1/1 命中", "验收通过"] },
-  },
-  {
-    key: "V",
-    name: "verify 快照回归（clean 快照为基线 + L 缺口夹具为实测：上轮命中本轮退步 → exit 1 且含「基线漂移」）",
-    script: INDEX,
-    args: [], // 两段式：先 --snapshot 导出，再 --baseline 比对，见下方 custom 分支
-    expect: { code: 1, includes: "基线漂移" },
-    custom: "snapshot-drift",
-  },
-  {
-    key: "W",
-    name: "match 主题与基线图解耦正例（中性文件名 + 图内 data-mockup-theme=钴蓝，本次主题=橘橙 + theme_mapping → 走色值归一、exit 0）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-pos-theme-neutral.json")],
-    expect: { code: 0, includes: ["changeset.theme", "图内 data-mockup-theme", "同构异色归一已声明"] },
-  },
-  {
-    key: "X",
-    name: "match 基线图缺身份元数据不阻断（中性文件名 + 无 data-mockup-theme，已声明 changeset.theme → 仅提示、exit 0）",
-    script: INDEX,
-    args: ["match", path.join(FIXTURES, "changeset-pos-theme-nometa.json")],
-    expect: { code: 0, includes: "基线图未带主题身份元数据" },
-  },
-];
-
-const results = [];
-let failed = 0;
-
-console.log("=== A-X 端到端一键回归 ===\n");
-
-const SNAPSHOT_TMP = path.join(FIXTURES, "verify", "snapshot-latest.json");
-
-for (const step of steps) {
-  // V 步两段式：① 用 clean 夹具导出「上一轮全绿」快照；② 用 L 缺口夹具 + --baseline 比对 → 应报基线漂移
-  const spawnArgs = step.custom === "snapshot-drift"
-    ? []
-    : [step.script, ...step.args];
-  let status, stdout, stderr;
-  if (step.custom === "snapshot-drift") {
-    const s1 = spawnSync(process.execPath, [
-      INDEX, "verify",
-      "--oracle", path.join(FIXTURES, "verify", "oracle.json"),
-      "--actual", path.join(FIXTURES, "verify", "actual-clean.json"),
-      "--snapshot", SNAPSHOT_TMP,
-    ], { cwd: ROOT, encoding: "utf-8" });
-    if (s1.status !== 0 || !existsSync(SNAPSHOT_TMP)) {
-      status = s1.status;
-      stdout = s1.stdout ?? "";
-      stderr = `快照导出段失败（exit ${s1.status}）：快照回归前置不成立\n${s1.stderr ?? ""}`;
-    }
-    else {
-      ({ status, stdout, stderr } = spawnSync(process.execPath, [
-        INDEX, "verify",
-        "--oracle", path.join(FIXTURES, "verify", "oracle.json"),
-        "--actual", path.join(FIXTURES, "verify", "actual.json"),
-        "--baseline", SNAPSHOT_TMP,
-      ], { cwd: ROOT, encoding: "utf-8" }));
-    }
-  }
-  else {
-    ({ status, stdout, stderr } = spawnSync(process.execPath, spawnArgs, { cwd: ROOT, encoding: "utf-8" }));
-  }
-  const output = `${stdout ?? ""}${stderr ?? ""}`;
-  const code = status ?? -1;
-
-  const codeOk = code === step.expect.code;
-  const wanted = step.expect.includes === undefined
-    ? []
-    : (Array.isArray(step.expect.includes) ? step.expect.includes : [step.expect.includes]);
-  const missing = wanted.filter(w => !output.includes(w));
-  const textOk = missing.length === 0;
-  const ok = codeOk && textOk;
-
-  if (ok) results.push(`${step.key}✔`);
-  else {
-    failed++;
-    results.push(`${step.key}✘`);
-    console.error(`✖ ${step.key} · ${step.name}`);
-    if (!codeOk) console.error(`    期望 exit ${step.expect.code}，实际 exit ${code}`);
-    if (!textOk) console.error(`    输出未包含预期片段：${missing.join("、")}`);
-    console.error("    ───── 该步骤完整输出 ─────");
-    for (const line of output.trimEnd().split("\n")) console.error(`    ${line}`);
-    console.error("");
-  }
-}
-
-console.log(`回归结果：${results.join("  ")}`);
-if (failed > 0) {
-  console.error(`\n✖ ${failed} 步未通过，见上方详情`);
-  process.exit(1);
-}
-console.log("\n✔ A-X 全部通过，mapping/parser 可提交或发版");