@qilitt-mickey/vue3-temp-skill 1.2.6 → 1.2.8

package/scripts/generate-page.mjs

@@ -1,734 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * generate-page.mjs —— 契约 structure → 页面脚手架 SFC 的确定性生成器
- *
- * 用法:
- *   node generate-page.mjs --project <项目根> [--out src/views/design-restore] [--page list]
- *
- * 职责（design-apply 第 6 步.4 的机器执行版，消灭「凭印象重建页面」）:
- *   1. 读契约 .design/visual-contract-*.json 的 structure（页面骨架）+ pages（角色绑定）
- *   2. 生成列表页 SFC：页头 / 筛选区 / 操作栏 / 表格列 / 状态标签 / 分页，区块数量、
- *      列数与宽度档位、控件类型、fixed、对齐、标签变体、图标 path 全部照抄骨架
- *   3. 角色 class 一律以字面量写入模板（.role-*），与 ui-roles.css 的生成物一一对应
- *
- * 红线（形态/内容分离）:
- *   - 业务内容（列名文字、label、数据行、状态文案）一律以 SAMPLE 占位，接入真实业务时替换
- *   - 本脚本不产生任何视觉判断——视觉形态全部由 ui-tokens/ui-roles/ui-layout.css 承载
- *   - 同一契约输入必得同一输出（可复现）；生成物禁止手改
- *
- * 范围:
- *   只生成 content 区内的页面骨架。壳层（brand/sidebar/header/tabs）由布局宿主承接，
- *   见 mapping/<场景>.json 的 layoutHost 与 design-apply 第 4/5 步。
- */
-
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const SKILL_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-
-// ────────────────────────────── 参数
-
-function parseArgs(argv) {
-  const out = { project: process.cwd(), out: null, page: null };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--project" || a === "-p") out.project = path.resolve(argv[++i]);
-    else if (a === "--out") out.out = argv[++i];
-    else if (a === "--page") out.page = argv[++i];
-    else if (a === "--help" || a === "-h") {
-      console.log(
-        "用法: node generate-page.mjs --project <项目根> [--out src/views/design-restore] [--page list]"
-      );
-      process.exit(0);
-    }
-  }
-  return out;
-}
-
-// ────────────────────────────── 名称转换（与 generate-css.mjs / check-landing.mjs 完全一致）
-
-function expectedClassName(roleName) {
-  return (
-    "role-" +
-    roleName
-      .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
-      .replace(/\./g, "-")
-      .replace(/_/g, "-")
-      .toLowerCase()
-  );
-}
-
-function variantClassName(variantName) {
-  return variantName
-    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
-    .replace(/_/g, "-")
-    .toLowerCase();
-}
-
-// ────────────────────────────── 读取契约
-
-function loadContract(projectRoot) {
-  const designDir = path.join(projectRoot, ".design");
-  if (!fs.existsSync(designDir)) {
-    throw new Error("项目根下没有 .design/ 目录 —— 先由设计侧落盘契约");
-  }
-  const names = fs.readdirSync(designDir).filter((n) => /^visual-contract.*\.json$/.test(n));
-  if (!names.length) throw new Error(".design/ 下没有 visual-contract-*.json");
-  const contractPath = path.join(designDir, names[0]);
-  return { contract: JSON.parse(fs.readFileSync(contractPath, "utf-8")), contractPath };
-}
-
-// ────────────────────────────── 骨架归一化
-
-/** 宽度档位 → px 数值；数字字符串原样；档位未知 → null（列不设宽，打印警告） */
-const WIDTH_STEPS = { xs: 80, s: 120, m: 160, l: 200, xl: 280, xxl: 360 };
-
-function normWidth(raw, warnings, label) {
-  if (raw == null || raw === "") return null;
-  if (typeof raw === "number") return raw;
-  const key = String(raw).trim().toLowerCase();
-  if (/^\d+$/.test(key)) return parseInt(key, 10);
-  const px = key.match(/^(\d+)px$/);
-  if (px) return parseInt(px[1], 10);
-  if (WIDTH_STEPS[key] != null) return WIDTH_STEPS[key];
-  warnings.push(`${label}: 宽度档位 "${raw}" 无法识别（可用 ${Object.keys(WIDTH_STEPS).join("/")} 或像素数字），该列不设宽`);
-  return null;
-}
-
-/** cellKind → 缺省 cellRole（契约列未声明 cellRole 时按 cellKind 兜底，与角色库对齐） */
-const DEFAULT_ROLE_BY_KIND = {
-  index: "table.cell.index",
-  selection: "table.cell.selection",
-  amount: "table.cell.amount",
-  thumb: "table.cell.thumb",
-  tag: "table.cell.status",
-  actions: "table.cell.action",
-  link: "table.cell",
-  route: "table.cell",
-  text: "table.cell",
-};
-
-/** 操作列 actions 归一化：["查看","编辑"] / [{text,danger}] / {count:N} / 数字 → [{text,danger}] 或 null */
-function normActionItems(raw) {
-  if (!Array.isArray(raw)) return null;
-  return raw.map((a, i) => {
-    const text = typeof a === "string" ? a : (a && (a.text || a.label)) || `操作${i + 1}`;
-    const danger = typeof a === "object" && a ? a.danger === true : /删除|作废|停用/.test(text);
-    return { text, danger };
-  });
-}
-
-/** cellRole → 列型反推（契约结构列常只声明 cellRole 不写 cellKind，如 {cellRole: table.cell.selection}） */
-const KIND_BY_CELL_ROLE = {
-  "table.cell.selection": "selection",
-  "table.cell.index": "index",
-  "table.cell.amount": "amount",
-  "table.cell.thumb": "thumb",
-  "table.cell.status": "tag",
-  "table.cell.action": "actions",
-};
-
-function normColumns(rawColumns, warnings) {
-  return (Array.isArray(rawColumns) ? rawColumns : []).map((c, i) => {
-    // 列型识别：契约操作列只写 cellRole: table.cell.action + actions 数组（无 cellKind），必须显式推导
-    const actionItems = normActionItems(c.actions);
-    const kind = c.cellKind || c.kind || KIND_BY_CELL_ROLE[c.cellRole] || (actionItems ? "actions" : "text");
-    const roleName = c.cellRole || c.role || DEFAULT_ROLE_BY_KIND[kind] || "table.cell";
-    if (!c.cellRole && !c.role) {
-      warnings.push(`列 ${i + 1}: 未声明 cellRole，按列型 "${kind}" 用缺省角色 "${roleName}"`);
-    }
-    return {
-      prop: c.prop || c.key || `col${i + 1}`,
-      label: c.label || c.sampleLabel || (["selection", "index"].includes(kind) ? "" : `列${i + 1}`),
-      kind,
-      roleName,
-      cls: expectedClassName(roleName),
-      width: normWidth(c.width ?? c.widthStep, warnings, `列 ${i + 1}`),
-      fixed: c.fixed === "left" || c.fixed === "right" ? c.fixed : null,
-      align: ["left", "center", "right"].includes(c.align) ? c.align : null,
-      tagVariant: typeof c.tagVariant === "string" && c.tagVariant ? c.tagVariant : null,
-      actionsCount: actionItems
-        ? actionItems.length
-        : (c.actions && typeof c.actions === "object" && !Array.isArray(c.actions) && c.actions.count) || 3,
-      actionItems,
-    };
-  });
-}
-
-/** statusMap 归一化：对象 { name: {label, icon, tagVariant} } 或数组 [{name, label, icon, tagVariant}] → [{name, label, icon, tagVariant}] */
-function normStatusMap(sm) {
-  if (!sm) return [];
-  const entries = [];
-  if (Array.isArray(sm)) {
-    for (const it of sm) {
-      const name = it.name || it.variant || it.key;
-      if (name)
-        entries.push({
-          name: String(name),
-          label: it.label || String(name),
-          icon: it.icon || null,
-          tagVariant: it.tagVariant || null,
-        });
-    }
-  } else if (typeof sm === "object") {
-    for (const [name, def] of Object.entries(sm)) {
-      const d = def && typeof def === "object" ? def : {};
-      entries.push({ name, label: d.label || name, icon: d.icon || null, tagVariant: d.tagVariant || null });
-    }
-  }
-  return entries;
-}
-
-/** icon path 记法 → 内联 SVG 字符串（M... 多段用 | 分隔；rect:x y w h rx；circle:cx cy r） */
-function iconSvg(spec, size) {
-  if (!spec || typeof spec !== "string") return "";
-  const parts = spec.split("|").map((s) => s.trim()).filter(Boolean);
-  const inner = parts
-    .map((p) => {
-      if (p.startsWith("rect:")) {
-        const [x, y, w, h, rx] = p.slice(5).trim().split(/\s+/);
-        return `<rect x="${x}" y="${y}" width="${w}" height="${h}" rx="${rx || 0}" />`;
-      }
-      if (p.startsWith("circle:")) {
-        const [cx, cy, r] = p.slice(7).trim().split(/\s+/);
-        return `<circle cx="${cx}" cy="${cy}" r="${r}" />`;
-      }
-      return `<path d="${p}" />`;
-    })
-    .join("");
-  return `<svg viewBox="0 0 24 24" width="${size}" height="${size}" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">${inner}</svg>`;
-}
-
-/** 按钮组归一化：{buttons: N} / {buttons: [{text,icon}]} / 数组 → [{text, icon}] */
-function normButtons(raw, fallbackText) {
-  let count = 0;
-  let items = null;
-  if (Array.isArray(raw)) items = raw;
-  else if (raw && Array.isArray(raw.buttons)) items = raw.buttons;
-  else if (raw && typeof raw === "object" && raw.buttons != null) count = Number(raw.buttons) || 0;
-  else if (typeof raw === "number") count = raw;
-  if (items) {
-    return items.map((b, i) => {
-      // 契约按钮组常用纯字符串数组（["新增运单","批量导入"]），必须先认字符串
-      if (typeof b === "string") return { text: b, icon: null };
-      return {
-        text: (b && (b.text || b.label)) || `${fallbackText}${i + 1}`,
-        icon: (b && b.icon) || null,
-      };
-    });
-  }
-  return Array.from({ length: count }, (_, i) => ({ text: `${fallbackText}${i + 1}`, icon: null }));
-}
-
-/** 筛选项归一化 */
-function normFilters(raw, warnings) {
-  const arr = Array.isArray(raw) ? raw : [];
-  return arr.map((f, i) => {
-    const type = f.type || f.control || "input";
-    if (!["input", "select", "dateRange"].includes(type)) {
-      warnings.push(`筛选项 ${i + 1}: 控件类型 "${type}" 不在 input/select/dateRange 值域，按 input 处理`);
-    }
-    const t = ["input", "select", "dateRange"].includes(type) ? type : "input";
-    return {
-      type: t,
-      label: f.label || f.sampleLabel || `筛选${i + 1}`,
-      prop: `q${i}`,
-      placeholder: f.placeholder || null,
-      collapsed: f.collapsed === true || f.collapsible === true,
-      roleCls: expectedClassName(`filter.${t}`),
-      options: Array.isArray(f.options) ? f.options.map(String) : [],
-    };
-  });
-}
-
-/** 从 pages.<页型>.nodes 消费绑定：返回指定区域的绑定列表（角色 + variants + for） */
-function bindsFor(pages, pageName, areaSuffix) {
-  const page = (pages && pages[pageName]) || {};
-  const nodes = Array.isArray(page.nodes) ? page.nodes : [];
-  return nodes.filter((n) => n && typeof n.in === "string" && n.in.endsWith(areaSuffix));
-}
-
-// ────────────────────────────── SFC 生成
-
-function genSfc(contract, pageName, warnings) {
-  const structure = contract.structure || {};
-  const pageS = structure.page || {};
-  const L = [];
-  const push = (...lines) => L.push(...lines);
-
-  // —— 骨架各区块
-  const pageHeader = pageS.header || null;
-  const rawFilters = pageS.filters || [];
-  const filterSection = Array.isArray(rawFilters) ? { items: rawFilters } : rawFilters || null;
-  const filters = normFilters(filterSection && filterSection.items, warnings);
-  const hasCollapse = filters.some((f) => f.collapsed);
-  const toolbar = pageS.toolbar || null;
-  const table = pageS.table || {};
-  const columns = normColumns(table.columns, warnings);
-  const statusEntries = normStatusMap(table.statusMap);
-  const tagVariants = new Set(statusEntries.map((s) => s.name));
-  for (const b of bindsFor(contract.pages, pageName, "table.cell")) {
-    if (b.role && Array.isArray(b.variants)) for (const v of b.variants) tagVariants.add(String(v));
-  }
-  const rowCount = (table.rows && table.rows.count) || 8;
-  const pagination = pageS.pagination || null;
-
-  if (!columns.length) {
-    throw new Error("契约 structure 缺 page.table.columns —— 列表页没有骨架可重建（契约 §7 第 5 条）");
-  }
-
-  // —— 按钮角色消费：优先按 nodes 绑定的 for 文本精确匹配；无匹配时按按钮语义回退。
-  //    不做游标消费（页头/筛选/工具栏共用一套语义映射，先到先得会让页头动作抢走 danger/text 绑定）；
-  //    契约模板常以「主按钮/次按钮/危险按钮」泛称标注 for，文本匹配不上时语义兜底才是主路径
-  const toolbarBinds = bindsFor(contract.pages, pageName, "toolbar.bar").filter((b) => /^button\./.test(b.role || ""));
-  const roleClsOf = (role) => ({ cls: expectedClassName(role), primary: /primary/.test(role) });
-  const semanticRole = (text) =>
-    /删除|作废|停用/.test(text)
-      ? "button.danger"
-      : /查询|搜索|新增|创建|新建|提交|保存/.test(text)
-        ? "button.primary"
-        : "button.secondary";
-  const findBindFor = (text) => {
-    const idx = toolbarBinds.findIndex((b) => b.for && b.for.includes(text));
-    if (idx >= 0) return roleClsOf(toolbarBinds[idx].role);
-    return roleClsOf(semanticRole(text));
-  };
-  const searchBtn = findBindFor("查询");
-  const resetBtn = findBindFor("重置");
-
-  const toolbarLeft = normButtons(toolbar && (toolbar.left ?? toolbar.leftButtons), "操作");
-  const toolbarRight = normButtons(toolbar && (toolbar.right ?? toolbar.rightButtons), "工具");
-  const headerActions = pageHeader && pageHeader.actions ? normButtons(pageHeader.actions, "动作") : [];
-  const headerTitle = (pageHeader && pageHeader.title) || "页面标题（SAMPLE）";
-  const actionsCol = columns.find((c) => c.kind === "actions");
-  const actionItems = (actionsCol && actionsCol.actionItems) || [
-    { text: "编辑", danger: false },
-    { text: "详情", danger: false },
-    { text: "删除", danger: true },
-  ];
-  const hasSelectionInfo = [...toolbarLeft, ...toolbarRight].some((b) => /已选/.test(b.text) && /项/.test(b.text));
-  const isSelectionInfo = (text) => /已选/.test(text) && /项/.test(text);
-  const selectionInfoText = (text) => (text.includes("N") ? text.replace(/N/g, "{{ selectedCount }}") : text);
-
-  // —— TAG 变体类映射与状态图标（字面量落文件，供 roles 比对与 v-html 使用）
-  const tagCls = "role-tag-status";
-  // statusMap 键 → CSS 英文变体类：契约以 tagVariant 声明变体（success/warning…），禁止用中文键拼类名
-  const tagVariantMap = [...tagVariants].map((v) => {
-    const sm = statusEntries.find((s) => s.name === v);
-    const variant = (sm && sm.tagVariant) || v;
-    return `  ${JSON.stringify(v)}: "${tagCls}--${variantClassName(variant)}",`;
-  });
-  const statusIconEntries = statusEntries.filter((s) => s.icon);
-  const statusIconMap = statusIconEntries.map(
-    (s) => `  ${JSON.stringify(s.name)}: ${JSON.stringify(iconSvg(s.icon, 12))},`
-  );
-  const headerIconEntries = headerActions.filter((b) => b.icon);
-  const toolbarIconEntries = [...toolbarLeft, ...toolbarRight].filter((b) => b.icon);
-
-  // —— 分页组成
-  const pLayout = pagination
-    ? [
-        pagination.total !== false && "total",
-        pagination.sizes !== false && "sizes",
-        "prev",
-        "pager",
-        "next",
-        pagination.jumper !== false && "jumper",
-      ]
-        .filter(Boolean)
-        .join(", ")
-    : null;
-  const pSizes = (pagination && Array.isArray(pagination.pageSizes) && pagination.pageSizes) || [10, 20, 50, 100];
-  // 契约分页 total 可能是文案（"共 256 条"）→ 抽数字作为 SAMPLE 总数
-  const paginationTotal =
-    pagination && typeof pagination.total === "string" ? (pagination.total.match(/\d+/) || [])[0] : null;
-
-  // —— mock 行（SAMPLE）：契约 rowsSampleOnly 是按列序排列的位置数组，逐行取模填充非结构列
-  const statusNames = statusEntries.length ? statusEntries.map((s) => s.name) : ["SAMPLE"];
-  const sampleRowsRaw = (table && Array.isArray(table.rowsSampleOnly) && table.rowsSampleOnly) || [];
-  const valueCols = columns.filter((c) => !["selection", "index", "actions", "thumb"].includes(c.kind));
-  const dynamicStatusCol = columns.find((c) => c.kind === "tag" && (!c.tagVariant || c.tagVariant === "status"));
-  const sampleRows = [];
-  for (let i = 0; i < rowCount; i++) {
-    const row = {};
-    const src = sampleRowsRaw.length ? sampleRowsRaw[i % sampleRowsRaw.length] : null;
-    let vi = 0;
-    for (const c of valueCols) {
-      const v = src ? src[vi++] : null;
-      const isDynStatus = dynamicStatusCol && c.prop === dynamicStatusCol.prop;
-      if (isDynStatus && i >= sampleRowsRaw.length) {
-        row[c.prop] = statusNames[i % statusNames.length];
-      } else if (v != null) {
-        row[c.prop] = String(v);
-      } else if (c.kind === "tag") {
-        row[c.prop] = c.tagVariant && c.tagVariant !== "status" ? "选项（SAMPLE）" : statusNames[i % statusNames.length];
-      } else if (c.kind === "amount") {
-        row[c.prop] = "0.00";
-      } else {
-        row[c.prop] = `SAMPLE-${i + 1}`;
-      }
-    }
-    sampleRows.push(row);
-  }
-
-  // ================= 模板 =================
-  push("<!-- ============================================================");
-  push("  由 vue3-temp-skill/scripts/generate-page.mjs 按契约 structure 生成 —— 禁止手改");
-  push(`  事实源: .design/visual-contract（页面骨架 + 角色绑定）；视觉形态全部来自 ui-*.css`);
-  push("  接入方式: 在路由中注册本页；接入真实业务时替换全部 SAMPLE 占位");
-  push(`  （列名/prop/API/权限/字典/数据行——形态保持，内容必须换）`);
-  push("============================================================ -->");
-  push('<template>');
-  push('  <div class="ui-page design-restore-page">');
-  push(`    <section class="role-page-card design-card">`);
-  // —— 页头
-  if (pageHeader) {
-    push(`      <header class="role-page-header">`);
-    push(`        <div class="page-header-main">`);
-    // CSS 期望 .role-page-header-title 是 flex-column 容器，内含 title-text / subtitle-text 子元素（ui-roles.css）
-    push(`          <div class="role-page-header-title">`);
-    push(`            <span class="title-text">${headerTitle}</span>`);
-    if (pageHeader.subtitle) push(`            <span class="subtitle-text">${pageHeader.subtitle}</span>`);
-    push(`          </div>`);
-    push(`        </div>`);
-    push(`        <div class="role-page-header-actions">`);
-    if (!headerActions.length) {
-      push(`          <!-- 骨架未声明页头动作钮 -->`);
-    }
-    for (const b of headerActions) {
-      const bind = findBindFor(b.text);
-      // v-html 外层用单引号：JSON.stringify 产出双引号 key，双引号属性会嵌套截断
-      const iconSpan = b.icon ? `<span class="btn-icon" v-html='HEADER_ICONS[${JSON.stringify(b.text)}]'></span>` : "";
-      push(
-        `          <el-button class="${bind.cls || "role-button-secondary"}"${bind.primary ? ` type="primary"` : ""}><!-- SAMPLE 动作钮 -->${iconSpan}${b.text}</el-button>`,
-      );
-    }
-    push(`        </div>`);
-    push(`      </header>`);
-  }
-  // —— 筛选区
-  if (filters.length) {
-    push(`      <div class="role-filter-section">`);
-    filters.forEach((f, i) => {
-      push(`        <div class="role-filter-item"${f.collapsed ? ` v-show="filtersExpanded"` : ""}>`);
-      push(`          <label class="role-filter-label">${f.label}</label>`);
-      if (f.type === "input") {
-        push(`          <el-input`);
-        push(`            v-model="query.${f.prop}"`);
-        // 契约 nodes 同时绑定 filter.input 与 input.base：筛选控件需两类同挂（base 段承载边框/高度形态）
-        push(`            class="${f.roleCls} role-input-base"`);
-        push(`            placeholder="${f.placeholder || "请输入（SAMPLE）"}"`);
-        push(`            clearable`);
-        push(`          />`);
-      } else if (f.type === "select") {
-        // select 缺省显示：契约 placeholder → 契约 options[0]（admin 惯例首选项「全部状态」）→ 通用文案；不用 SAMPLE 占位用户可见 UI
-        push(`          <el-select v-model="query.${f.prop}" class="${f.roleCls} role-select-base" placeholder="${f.placeholder || f.options?.[0] || "请选择"}" clearable>`);
-        push(`            <el-option v-for="o in FILTER_OPTIONS[${i}]" :key="o" :label="o" :value="o" />`);
-        push(`          </el-select>`);
-      } else {
-        push(`          <el-date-picker`);
-        push(`            v-model="query.${f.prop}"`);
-        push(`            type="daterange"`);
-        push(`            class="${f.roleCls}"`);
-        push(`            range-separator="至"`);
-        push(`            start-placeholder="开始日期"`);
-        push(`            end-placeholder="结束日期"`);
-        push(`          />`);
-      }
-      push(`        </div>`);
-    });
-    push(`        <div class="role-filter-actions">`);
-    push(`          <el-button class="${searchBtn.cls || "role-button-primary"}"${searchBtn.primary ? ` type="primary"` : ""} @click="onSearch">查询</el-button>`);
-    push(`          <el-button class="${resetBtn.cls || "role-button-secondary"}"${resetBtn.primary ? ` type="primary"` : ""} @click="onReset">重置</el-button>`);
-    if (hasCollapse) {
-      push(`          <el-button link type="primary" class="role-button-text" @click="filtersExpanded = !filtersExpanded">`);
-      push(`            {{ filtersExpanded ? "收起" : "展开" }}`);
-      push(`          </el-button>`);
-    }
-    push(`        </div>`);
-    push(`      </div>`);
-  }
-  // —— 操作栏
-  if (toolbar) {
-    push(`      <div class="role-toolbar-bar">`);
-    push(`        <div class="toolbar-group">`);
-    for (const b of toolbarLeft) {
-      if (isSelectionInfo(b.text)) {
-        push(`          <span class="toolbar-selection-info">${selectionInfoText(b.text)}</span>`);
-        continue;
-      }
-      const bind = findBindFor(b.text);
-      push(`          <el-button class="${bind.cls || "role-button-secondary"}"${bind.primary ? ` type="primary"` : ""}>`);
-      if (b.icon) push(`            <span class="btn-icon" v-html='TOOLBAR_ICONS[${JSON.stringify(b.text)}]'></span>`);
-      push(`            ${b.text}`);
-      push(`          </el-button>`);
-    }
-    push(`        </div>`);
-    push(`        <div class="toolbar-group">`);
-    for (const b of toolbarRight) {
-      if (isSelectionInfo(b.text)) {
-        push(`          <span class="toolbar-selection-info">${selectionInfoText(b.text)}</span>`);
-        continue;
-      }
-      const bind = findBindFor(b.text);
-      push(`          <el-button class="${bind.cls || "role-button-secondary"}"${bind.primary ? ` type="primary"` : ""}>`);
-      if (b.icon) push(`            <span class="btn-icon" v-html='TOOLBAR_ICONS[${JSON.stringify(b.text)}]'></span>`);
-      push(`            ${b.text}`);
-      push(`          </el-button>`);
-    }
-    push(`        </div>`);
-    push(`      </div>`);
-  }
-  // —— 表格
-  push(`      <div class="role-table-wrapper">`);
-  push(`        <el-table`);
-  push(`          :data="rows"`);
-  push(`          header-cell-class-name="role-table-header-cell"`);
-  push(`          class="design-table"`);
-  push(`        >`);
-  for (const c of columns) {
-    const attrs = [
-      c.kind === "index" ? `type="index"` : null,
-      c.kind === "selection" ? `type="selection"` : null,
-      `prop="${c.kind === "actions" || c.kind === "selection" || c.kind === "index" ? c.prop : c.prop}"`,
-      `label="${c.label}"`,
-      c.width != null ? `:width="${c.width}"` : null,
-      c.fixed ? `fixed="${c.fixed}"` : null,
-      // 结构列（selection/index/actions）表头变体类：ui-roles.css 有对应 --selection/--index/--action 段（居中等），EP 经 label-class-name 挂到 th
-      ["selection", "index", "actions"].includes(c.kind) ? `label-class-name="role-table-header-cell--${c.kind === "actions" ? "action" : c.kind}"` : null,
-      // 数据对齐用契约 align；操作列头居中是基线约定（契约 thead .col-actions text-align:center），契约未声明 align 时缺省——align 只输出一次
-      c.align || c.kind === "actions" ? `align="${c.align || "center"}"` : null,
-      `class-name="${c.cls}"`,
-    ]
-      .filter(Boolean)
-      .map((a) => `            ${a}`)
-      .join("\n");
-    const needsSlot = ["link", "route", "tag", "actions", "thumb", "amount"].includes(c.kind);
-    if (!needsSlot) {
-      push(`          <el-table-column`);
-      push(attrs);
-      push(`          />`);
-      continue;
-    }
-    push(`          <el-table-column`);
-    push(attrs);
-    push(`          >`);
-    if (c.kind === "link" || c.kind === "route") {
-      push(`            <template #default="{ row }">`);
-      push(`              <!-- SAMPLE 链接；route 形态接入 router.push -->`);
-      push(`              <el-link type="primary" class="role-link">{{ row.${c.prop} }}</el-link>`);
-      push(`            </template>`);
-    } else if (c.kind === "tag" && c.tagVariant && c.tagVariant !== "status") {
-      // 静态变体 tag：变体类在契约列上声明（outlined/default…），不经 statusMap 动态解析；
-      // 形状来自基类 .role-tag-status（adapter 段），变体类只补颜色
-      push(`            <template #default="{ row }">`);
-      push(`              <el-tag class="${tagCls} ${tagCls}--${variantClassName(c.tagVariant)}" effect="light">{{ row.${c.prop} }}</el-tag>`);
-      push(`            </template>`);
-    } else if (c.kind === "tag") {
-      push(`            <template #default="{ row }">`);
-      push(`              <el-tag`);
-      push(`                class="${tagCls}"`);
-      push(`                :class="TAG_VARIANT_CLASS[row.${c.prop}] || '${tagCls}--default'"`);
-      push(`                effect="light"`);
-      push(`              >`);
-      if (statusIconEntries.length) {
-        push(`                <span v-if="STATUS_ICONS[row.${c.prop}]" class="tag-icon" v-html="STATUS_ICONS[row.${c.prop}]"></span>`);
-      }
-      push(`                {{ row.${c.prop} }}`);
-      push(`              </el-tag>`);
-      push(`            </template>`);
-    } else if (c.kind === "actions") {
-      push(`            <template #default>`);
-      push(`              <!-- SAMPLE 操作项，接入真实业务动作 -->`);
-      push(`              <template v-for="(a, ai) in ACTION_ITEMS.slice(0, ${c.actionsCount})" :key="a.text">`);
-      push(`                <span v-if="ai > 0" class="cell-action-divider"></span>`);
-      push(`                <el-button link :type="a.danger ? 'danger' : 'primary'" class="role-button-text">{{ a.text }}</el-button>`);
-      push(`              </template>`);
-      push(`            </template>`);
-    } else if (c.kind === "thumb") {
-      push(`            <template #default>`);
-      push(`              <div class="cell-thumb-ph" aria-hidden="true"></div>`);
-      push(`            </template>`);
-    } else if (c.kind === "amount") {
-      push(`            <template #default="{ row }">`);
-      push(`              <span class="cell-amount">{{ row.${c.prop} }}</span>`);
-      push(`            </template>`);
-    }
-    push(`          </el-table-column>`);
-  }
-  push(`          <template #empty>`);
-  push(`            <div class="role-table-empty">暂无数据</div>`);
-  push(`          </template>`);
-  push(`        </el-table>`);
-  push(`      </div>`);
-  // —— 分页
-  if (pagination) {
-    push(`      <footer class="role-pagination-bar">`);
-    push(`        <span class="page-total">{{ \`共 \${total} 条\` }}</span>`);
-    push(`        <el-pagination`);
-    push(`          v-model:current-page="pageNo"`);
-    push(`          v-model:page-size="pageSize"`);
-    push(`          :page-sizes="PAGE_SIZES"`);
-    push(`          :total="total"`);
-    push(`          layout="${pLayout}"`);
-    push(`          background`);
-    push(`        />`);
-    push(`      </footer>`);
-  }
-  push(`    </section>`);
-  push(`  </div>`);
-  push(`</template>`);
-  push("");
-
-  // ================= 脚本 =================
-  push(`<script setup lang="ts">`);
-  push(`/** SAMPLE：本段全部为演示占位。接入真实业务时替换为项目字段与 API。 */`);
-  push(`import { reactive, ref } from "vue";`);
-  push("");
-  push(`const TITLE = ${JSON.stringify(headerTitle)};`);
-  if (filters.length) {
-    push(`const query = reactive({`);
-    for (const f of filters) {
-      push(`  ${f.prop}: ${f.type === "dateRange" ? "null" : '""'},${f.collapsed ? " // 折叠项" : ""}`);
-    }
-    push(`});`);
-    const selectOpts = filters
-      .map((f, i) => (f.type === "select" ? `  [${i}]: [${(f.options.length ? f.options : ["选项一（SAMPLE）", "选项二（SAMPLE）"]).map((o) => JSON.stringify(o)).join(", ")}],` : null))
-      .filter(Boolean);
-    push(`const FILTER_OPTIONS: Record<number, string[]> = {`);
-    push(...selectOpts);
-    push(`};`);
-    if (hasCollapse) push(`const filtersExpanded = ref(false);`);
-  }
-  push(`const rows = ${JSON.stringify(sampleRows, null, 2).split("\n").join("\n")};`);
-  push(`const ACTION_ITEMS = [`);
-  for (const a of actionItems) {
-    push(`  { text: ${JSON.stringify(a.text)}, danger: ${a.danger} },`);
-  }
-  push(`];`);
-  if (hasSelectionInfo) push(`const selectedCount = ref(0);`);
-  if (tagVariants.size) {
-    push(`const TAG_VARIANT_CLASS: Record<string, string> = {`);
-    push(...tagVariantMap);
-    push(`};`);
-  }
-  if (statusIconMap.length) {
-    push(`const STATUS_ICONS: Record<string, string> = {`);
-    push(...statusIconMap);
-    push(`};`);
-  }
-  if (headerIconEntries.length) {
-    push(`const HEADER_ICONS: Record<string, string> = {`);
-    for (const b of headerIconEntries) {
-      push(`  ${JSON.stringify(b.text)}: ${JSON.stringify(iconSvg(b.icon, 14))},`);
-    }
-    push(`};`);
-  }
-  if (toolbarIconEntries.length) {
-    push(`const TOOLBAR_ICONS: Record<string, string> = {`);
-    for (const b of toolbarIconEntries) {
-      push(`  ${JSON.stringify(b.text)}: ${JSON.stringify(iconSvg(b.icon, 14))},`);
-    }
-    push(`};`);
-  }
-  if (pagination) {
-    push(`const PAGE_SIZES = ${JSON.stringify(pSizes)};`);
-    push(`const pageNo = ref(1);`);
-    push(`const pageSize = ref(${pSizes[0]});`);
-    push(`const total = ref(${paginationTotal || rowCount});`);
-  }
-  push(`function onSearch() {`);
-  push(`  // SAMPLE：接入真实查询 API`);
-  push(`}`);
-  push(`function onReset() {`);
-  if (filters.length) {
-    push(`  Object.assign(query, {`);
-    for (const f of filters) push(`    ${f.prop}: ${f.type === "dateRange" ? "null" : '""'},`);
-    push(`  });`);
-  }
-  push(`}`);
-  push(`</script>`);
-  push("");
-
-  // ================= 占位样式（仅 mock 视觉，不属于契约形态） =================
-  push(`<style scoped>`);
-  push(`/* 仅 SAMPLE 占位样式：mock 缩略块 / 操作分隔线 / 图标对齐。契约视觉全部来自 ui-*.css，禁止在此写主题值 */`);
-  push(`.cell-thumb-ph {`);
-  push(`  width: 40px;`);
-  push(`  height: 40px;`);
-  push(`  border-radius: 6px;`);
-  push(`  background: #f0f0f0;`);
-  push(`}`);
-  push(`.cell-action-divider {`);
-  push(`  display: inline-block;`);
-  push(`  width: 1px;`);
-  push(`  height: 12px;`);
-  push(`  margin: 0 8px;`);
-  push(`  background: #e5e6eb;`);
-  push(`  vertical-align: middle;`);
-  push(`}`);
-  push(`.btn-icon,`);
-  push(`.tag-icon {`);
-  push(`  display: inline-flex;`);
-  push(`  align-items: center;`);
-  push(`  vertical-align: middle;`);
-  push(`}`);
-  push(`.tag-icon {`);
-  push(`  margin-right: 4px;`);
-  push(`}`);
-  push(`.toolbar-selection-info {`);
-  push(`  align-self: center;`);
-  push(`  font-size: var(--font-size-md);`);
-  push(`  color: var(--color-text-secondary);`);
-  push(`  white-space: nowrap;`);
-  push(`}`);
-  push(`</style>`);
-  push("");
-
-  return L.join("\n");
-}
-
-// ────────────────────────────── 主流程
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const warnings = [];
-
-  const { contract, contractPath } = loadContract(args.project);
-
-  // 页型：--page > meta.pageTypes[0]
-  const metaPages = Array.isArray(contract.meta && contract.meta.pageTypes) ? contract.meta.pageTypes : [];
-  const pageName = args.page || metaPages[0] || "list";
-  if (!contract.structure || !contract.structure.page) {
-    console.error("✗ 契约缺 structure（或 structure.page）—— 页面骨架没有事实源");
-    console.error("  回设计侧补抽 structure（contract-schema §2.7），重新出契约。");
-    process.exit(1);
-  }
-  if (pageName !== "list") {
-    console.error(`✗ 页型 "${pageName}" 的脚手架生成器未实现（当前支持 list）`);
-    console.error("  该页型请按 design-apply.md 第 6 步.4 手工重建骨架。");
-    process.exit(1);
-  }
-
-  const sfc = genSfc(contract, pageName, warnings);
-
-  const outDir = path.join(args.project, args.out || "src/views/design-restore");
-  fs.mkdirSync(outDir, { recursive: true });
-  const outFile = path.join(outDir, `${pageName}.vue`);
-  fs.writeFileSync(outFile, sfc);
-
-  console.log(`契约: ${path.relative(args.project, contractPath)}`);
-  console.log(`生成: ${path.relative(args.project, outFile)}`);
-  console.log("骨架已按 structure 重建；角色类已字面量挂载（表格经 class-name / header-cell-class-name）。");
-  console.log("下一步: 注册路由 → 重跑 check-landing.mjs 看 roles-mounted 覆盖率。");
-  console.log("红线: 文件内 SAMPLE 占位接入真实业务时必须替换；本文件禁止手改，骨架变更回契约重新生成。");
-  if (warnings.length) {
-    console.log("");
-    console.log("警告（不阻塞，建议回查契约）:");
-    for (const w of [...new Set(warnings)]) console.log(`  - ${w}`);
-  }
-}
-
-main();