weaver-e10-builder 1.2.3 → 1.2.5

package/dist/services/designer-css.js

@@ -0,0 +1,163 @@
+/**
+ * 页面设计器 —— 组件自定义 CSS（纯函数层，可单测）。
+ *
+ * 落点：`comp.config.styles[0].customStyle.base.codeSource`（自由文本 CSS）。
+ * 一个页面有 PC/MOBILE 两套布局，**每个终端各有一份组件**，靠互指 `refCompId` 配对。
+ *
+ * `styles` 数组里有两种记录，**必须分清**（真机样本 + factory 模板对照得出）：
+ *   - **自由 CSS 记录**：`{category, useCustom:true, useComStyle:false, styleVersion, customStyle:{...}}`
+ *   - **主题绑定记录**：`{id, category, customType, useCustom:false, themeId, useComStyle:true}`（Picture/CountDown 自带）
+ * 两者标志位正好相反。干净组件是 `styles: []`。
+ * 本模块**只认自由记录、绝不碰主题记录**。
+ *
+ * ⚠️ 写入本身是通的（真机确认：最小记录存得进去、回读一模一样、设计器里能看到），
+ * 但 `/layout/save` **不会**触发服务端重新编译 `sourceCode.cssCache` —— 编译属平台渲染环节，
+ * 不在 CLI 职责内，故这里不做「样式是否已编译」的判断，只保证**写对、写稳、回读一致**。
+ */
+import { randomBytes, randomInt } from 'node:crypto';
+/**
+ * 新建自由 CSS 记录时用的骨架。
+ *
+ * 真机验证：**只有这四项 + `customStyle.base.codeSource` 就能存进去**，服务端不会补字段，
+ * 也不是必须把 `customStyle` 的 title/content/footer/container 都填上。
+ */
+export const DEFAULT_FREE_RECORD = Object.freeze({
+    category: '1',
+    useCustom: true,
+    useComStyle: false,
+    styleVersion: '1',
+});
+/** 主题绑定记录：一定不碰。 */
+export function isThemeBound(record) {
+    if (!record || typeof record !== 'object')
+        return true;
+    if (record.useComStyle === true)
+        return true;
+    return record.themeId !== undefined && record.themeId !== null && record.themeId !== '';
+}
+/** 定位自由 CSS 记录：优先看 `customStyle`，其次看 `useComStyle === false`。找不到返回 null。 */
+export function findFreeCssRecord(comp) {
+    const styles = comp?.config?.styles;
+    if (!Array.isArray(styles) || !styles.length)
+        return null;
+    const byCustom = styles.findIndex((r) => r && typeof r === 'object' && r.customStyle && typeof r.customStyle === 'object' && !isThemeBound(r));
+    if (byCustom >= 0)
+        return { record: styles[byCustom], index: byCustom };
+    const byFlag = styles.findIndex((r) => r && typeof r === 'object' && r.useComStyle === false && !isThemeBound(r));
+    return byFlag >= 0 ? { record: styles[byFlag], index: byFlag } : null;
+}
+/** 读组件的自定义 CSS；没有则空串。 */
+export function readCustomCss(comp) {
+    const hit = findFreeCssRecord(comp);
+    const src = hit?.record?.customStyle?.base?.codeSource;
+    return typeof src === 'string' ? src : '';
+}
+/**
+ * 算出写入后的 `styles` 数组。**返回新数组、不改入参。**
+ *
+ * - 已有自由记录 → **外科式**只换 `customStyle.base.codeSource`，`customStyle` 下其它块
+ *   （title/content/footer/container）与记录的其它字段原样保留。
+ * - 只有主题绑定记录（或无记录）→ **追加**一条新记录，不动已有的。
+ */
+export function buildCustomCssPatch(comp, css, o = {}) {
+    const input = typeof css === 'string' ? css : '';
+    const existing = Array.isArray(comp?.config?.styles) ? comp.config.styles : [];
+    const before = readCustomCss(comp);
+    let after;
+    if (o.clear)
+        after = '';
+    else if (o.append && before.trim())
+        after = `${before.replace(/\s+$/, '')}\n\n${input}`;
+    else
+        after = input;
+    const hit = findFreeCssRecord(comp);
+    if (hit) {
+        const styles = existing.map((r, i) => (i === hit.index
+            ? { ...r, customStyle: { ...(r.customStyle || {}), base: { ...((r.customStyle || {}).base || {}), codeSource: after } } }
+            : r));
+        return { styles, before, after, created: false, recordIndex: hit.index };
+    }
+    const styles = [...existing, { ...DEFAULT_FREE_RECORD, customStyle: { base: { codeSource: after } } }];
+    return { styles, before, after, created: true, recordIndex: existing.length };
+}
+/**
+ * 归一化：去注释、压空白、抹平结构符号周围的空格。
+ * 只用于**比对**，不用于落库 —— 编译器本身会去掉注释，我们写的原文要原样保存。
+ */
+export function normalizeCss(css) {
+    return String(css ?? '')
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        .replace(/\s+/g, ' ')
+        .replace(/\s*([{};:,])\s*/g, '$1')
+        .trim();
+}
+/** 两份 CSS 在归一化后是否等价。 */
+export function sameCss(a, b) {
+    return normalizeCss(a) === normalizeCss(b);
+}
+/** 兼容大小写与 `ebd_page`/`ebd_style_lib` 之外的写法差异的终端名归一。 */
+function terminalOf(layout) {
+    const t = String(layout?.terminalType || '').toUpperCase();
+    return t === 'PC' || t === 'MOBILE' ? t : '';
+}
+/**
+ * 由**任一端**的 compId 解出要写的目标组件。
+ *
+ * 设计器本身就是双端同写（真机：一次编写两端 `codeSource` 一模一样），所以默认也是双端。
+ * 允许传移动端的 id（用户在移动端设计器里复制到的是那一个），按 `refCompId` 反查 PC 端。
+ */
+export function resolveCssTargets(layouts, compId, terminal = 'both') {
+    const id = String(compId || '').trim();
+    if (!id)
+        throw new Error('缺少组件 ID');
+    const pc = layouts.find((l) => terminalOf(l) === 'PC');
+    const mobile = layouts.find((l) => terminalOf(l) === 'MOBILE');
+    const pcComps = pc?.comps || [];
+    const mobComps = mobile?.comps || [];
+    const hitPc = pcComps.find((c) => String(c?.id) === id);
+    const hitMob = mobComps.find((c) => String(c?.id) === id);
+    if (!hitPc && !hitMob)
+        throw new Error(`未找到组件 ${id}（用 designer layout <pageId> --json 查组件 id）`);
+    // 任一端命中后，用 refCompId 把另一端配出来
+    const anchorPc = hitPc || pcComps.find((c) => String(c?.id) === String(hitMob?.refCompId));
+    const anchorMob = hitMob || mobComps.find((c) => String(c?.id) === String(hitPc?.refCompId));
+    const out = [];
+    if ((terminal === 'pc' || terminal === 'both') && anchorPc && pc)
+        out.push({ terminal: 'PC', comp: anchorPc, layout: pc });
+    if ((terminal === 'mobile' || terminal === 'both') && anchorMob && mobile)
+        out.push({ terminal: 'MOBILE', comp: anchorMob, layout: mobile });
+    if (!out.length) {
+        throw new Error(`组件 ${id} 在 ${terminal} 端不存在（该页只有 ${[pc && 'PC', mobile && 'MOBILE'].filter(Boolean).join('/')}）`);
+    }
+    return out;
+}
+/**
+ * 两端现有的自定义 CSS 是否已经分叉（都非空且不一致）。
+ *
+ * 双端同写会覆盖掉其中一端，分叉说明有人单独改过 —— 调用方须据此要一次确认。
+ */
+export function terminalConflict(targets) {
+    const filled = targets
+        .map((t) => ({ terminal: t.terminal, id: String(t.comp?.id || ''), css: readCustomCss(t.comp) }))
+        .filter((x) => x.css.trim() !== '');
+    if (filled.length < 2)
+        return { conflict: false, detail: '' };
+    const first = normalizeCss(filled[0].css);
+    const diverged = filled.some((x) => normalizeCss(x.css) !== first);
+    if (!diverged)
+        return { conflict: false, detail: '' };
+    return {
+        conflict: true,
+        detail: filled.map((x) => `${x.terminal}(${x.id.slice(0, 12)}) ${Buffer.byteLength(x.css, 'utf-8')} 字节`).join('，'),
+    };
+}
+/** 组件在页面里的展示名（回显用）。 */
+export function describeComp(comp) {
+    return [comp?.type, comp?.id ? String(comp.id).slice(0, 12) : ''].filter(Boolean).join(' ');
+}
+/** 供命令层生成占位名/调试用（与 designer-common 同款：首位字母，其余 hex）。 */
+export function genProbeId(length = 8) {
+    const tail = randomBytes(Math.ceil((length - 1) / 2)).toString('hex').slice(0, length - 1);
+    return 'abcdef'[randomInt(6)] + tail;
+}
+//# sourceMappingURL=designer-css.js.map

package/dist/services/designer-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designer-css.js","sourceRoot":"","sources":["../../src/services/designer-css.ts"],"names":[],"mappings":"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"}

package/dist/services/dom-structure.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 文档目录解析顺序（与 designer factoryDirs 同款四层）：
+ * npm 包 → 仓库源码 → 已装 skill（workbuddy / claude）。
+ */
+export declare function domStructureDirs(): string[];
+/** 把用户给的类型/名称解成规范 type；解不出时报错并列出已覆盖的组件。 */
+export declare function typeToFile(input: string): string;
+export interface DomEntry {
+    type: string;
+    file: string;
+    path: string;
+    /** 文档自述的组件名（`component` 字段）。 */
+    display: string;
+    bytes: number;
+    /** 顶层区块与各自字节数，供按需取用。 */
+    sections: Array<{
+        key: string;
+        bytes: number;
+    }>;
+}
+/** 列出全部可用文档（运行时扫描，不落索引文件，免得再多一份要同步的东西）。 */
+export declare function listDomStructures(): DomEntry[];
+export interface DomDoc extends DomEntry {
+    doc: any;
+}
+/** 取一份文档（input 可以是平台 type，也可以是常见写法）。 */
+export declare function readDomStructure(input: string): DomDoc;
+/** 取顶层区块或子路径，如 `shared` / `shared.title` / `branches.btn-pc.root`。 */
+export declare function sectionOf(doc: any, path: string): any;
+/**
+ * 统一取出根树。容忍三种 `root` 形态与 eb-button 的 `branches`。
+ * 返回的每一项是 `{name, node}`；`name` 用于回显（`root` / `branches.<分支>`）。
+ */
+export declare function domRoots(doc: any): Array<{
+    name: string;
+    node: any;
+}>;
+/** `class` 归一：字符串按空白切、数组原样收，统一返回字符串数组。 */
+export declare function classList(node: any): string[];
+/** 就地展开 `{ref:"shared.x"}` / `"ref:shared.x"`；解不出或成环时原样返回，不抛。 */
+export declare function deref(node: any, shared: any, seen?: Set<string>): any;
+//# sourceMappingURL=dom-structure.d.ts.map

package/dist/services/dom-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-structure.d.ts","sourceRoot":"","sources":["../../src/services/dom-structure.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAW3C;AA0CD,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAahD;AAaD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,IAAI,QAAQ,EAAE,CA0B9C;AAED,MAAM,WAAW,MAAO,SAAQ,QAAQ;IAAG,GAAG,EAAE,GAAG,CAAA;CAAE;AAErD,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAYrD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CAerE;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,CAK7C;AAED,iEAAiE;AACjE,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAmBhF"}

package/dist/services/dom-structure.js

@@ -0,0 +1,251 @@
+/**
+ * 组件 DOM 结构索引 —— 写页面组件自定义 CSS 时用来找选择器。
+ *
+ * 每份文档回答一件事：**「给这个组件的某一部分设样式」该选谁**。
+ * 它**不是完整 DOM 树**，是「样式定位索引」：`usage`/`pickTree`/`legend` 是散文说明，
+ * 树上的 `class` 才是选择器材料。所以默认输出原样 JSON，让调用方读散文，不做加工。
+ *
+ * 记号（各文件自己的 `legend` 里有解释）：
+ *   `[cls]`  条件类名，满足条件才挂
+ *   `{a|b}`  同一个位置二选一
+ *   `a > b`  父子层级压缩写法
+ *   `<comId>` 占位符，替换成页面里该组件的实例 id
+ *   `ref:shared.x` / `{"ref":"shared.x"}` 引用同文件的复用片段
+ *
+ * ⚠️ 源文档由人工整理，形态**不统一**，读取端必须容忍：
+ *   - `root` 有三种形态：`{desc,tree}` / 普通节点 / eb-button 的占位壳
+ *   - eb-button 把各分支树放在 `branches.<名字>.root`，其余组件放在顶层
+ *   - `class` 有字符串（图表类）和数组（widget 类）两种
+ * 故 `domRoots` / `classList` / `deref` 都做归一，调用方不必自己分支。
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { resolve, basename } from 'node:path';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * 文档目录解析顺序（与 designer factoryDirs 同款四层）：
+ * npm 包 → 仓库源码 → 已装 skill（workbuddy / claude）。
+ */
+export function domStructureDirs() {
+    const home = homedir();
+    return [
+        // npm 包：dist/services → dist → 包根 → skill-docs/assets/dom-structure
+        resolve(__dirname, '..', '..', 'skill-docs', 'assets', 'dom-structure'),
+        // 仓库源码布局：<repo>/skills/weaver-e10-builder/assets/dom-structure
+        resolve(__dirname, '..', '..', '..', '..', 'skills', 'weaver-e10-builder', 'assets', 'dom-structure'),
+        // 已装 skill（auth status 会从 skill-docs 同步 assets）
+        resolve(home, '.workbuddy', 'skills', 'weaver-e10-builder', 'assets', 'dom-structure'),
+        resolve(home, '.claude', 'skills', 'weaver-e10-builder', 'assets', 'dom-structure'),
+    ];
+}
+function primaryDir() {
+    for (const dir of domStructureDirs())
+        if (existsSync(dir))
+            return dir;
+    throw new Error(`找不到组件 DOM 结构文档目录。查过：\n  ${domStructureDirs().join('\n  ')}`);
+}
+/** 文件名一律以**平台组件 type** 命名（见 guide-designer-css 的对照表）。 */
+function domFiles() {
+    const dir = primaryDir();
+    const out = new Map();
+    for (const f of readdirSync(dir)) {
+        if (!f.toLowerCase().endsWith('.json'))
+            continue;
+        const type = basename(f, '.json');
+        out.set(type.toLowerCase(), type);
+        out.set(type.toLowerCase().replace(/[^a-z0-9]/g, ''), type);
+    }
+    return out;
+}
+/**
+ * 少数**源文档名与平台 type 对不上**的，以及常见口语写法。
+ * 其余靠「去分隔符 + 忽略大小写」机械命中，不必逐个列。
+ */
+const ALIASES = {
+    'progress-bar': 'ProgressChart',
+    progressbar: 'ProgressChart',
+    'progress-chart': 'ProgressChart',
+    'progresschart': 'ProgressChart',
+    'n-list': 'NList',
+    'digital-panel': 'DigitalPanel',
+    'eb-button': 'EbButton',
+    'nav-panel': 'NavPanel',
+    'nav-bar': 'NavBar',
+    'new-tab': 'NewTab',
+    'count-down': 'CountDown',
+    'fast-create': 'FastCreate',
+    'search-global': 'SearchGlobal',
+    'collapse-panel': 'CollapsePanel',
+    'page-header': 'PageHeader',
+};
+/** 把用户给的类型/名称解成规范 type；解不出时报错并列出已覆盖的组件。 */
+export function typeToFile(input) {
+    const raw = String(input ?? '').trim();
+    if (!raw)
+        throw new Error('缺少组件类型或名称');
+    if (ALIASES[raw])
+        return ALIASES[raw];
+    const lower = raw.toLowerCase();
+    if (ALIASES[lower])
+        return ALIASES[lower];
+    const files = domFiles();
+    const compact = lower.replace(/[^a-z0-9]/g, '');
+    const hit = files.get(lower) || files.get(compact);
+    if (hit)
+        return hit;
+    throw new Error(`暂无「${raw}」的 DOM 结构文档。已覆盖 ${[...new Set(files.values())].sort().join('、')}`);
+}
+/**
+ * 文档自述的组件名。**形态不统一**：多数是字符串，Calendar 之类是
+ * `{name, pkg, entries, ...}` 对象，所以取 `name` 兜底。
+ */
+function displayOf(doc) {
+    const c = doc?.component;
+    if (typeof c === 'string')
+        return c;
+    if (c && typeof c === 'object')
+        return String(c.name ?? c.component ?? c.type ?? '');
+    return '';
+}
+/** 列出全部可用文档（运行时扫描，不落索引文件，免得再多一份要同步的东西）。 */
+export function listDomStructures() {
+    const dir = primaryDir();
+    const out = [];
+    for (const f of readdirSync(dir)) {
+        if (!f.toLowerCase().endsWith('.json'))
+            continue;
+        const p = resolve(dir, f);
+        let doc = null;
+        let bytes = 0;
+        try {
+            const text = readFileSync(p, 'utf-8');
+            bytes = Buffer.byteLength(text, 'utf-8');
+            doc = JSON.parse(text);
+        }
+        catch {
+            continue;
+        }
+        out.push({
+            type: basename(f, '.json'),
+            file: f,
+            path: p,
+            display: displayOf(doc),
+            bytes,
+            sections: Object.entries(doc || {}).map(([key, v]) => ({
+                key,
+                bytes: Buffer.byteLength(JSON.stringify(v) ?? '', 'utf-8'),
+            })),
+        });
+    }
+    return out.sort((a, b) => a.type.localeCompare(b.type, 'en'));
+}
+/** 取一份文档（input 可以是平台 type，也可以是常见写法）。 */
+export function readDomStructure(input) {
+    const type = typeToFile(input);
+    const dir = primaryDir();
+    const path = resolve(dir, `${type}.json`);
+    if (!existsSync(path))
+        throw new Error(`文档文件缺失：${path}`);
+    const text = readFileSync(path, 'utf-8');
+    let doc;
+    try {
+        doc = JSON.parse(text);
+    }
+    catch (e) {
+        throw new Error(`${type}.json 解析失败：${e?.message || e}`);
+    }
+    return {
+        type,
+        file: `${type}.json`,
+        path,
+        display: displayOf(doc),
+        bytes: Buffer.byteLength(text, 'utf-8'),
+        sections: Object.entries(doc || {}).map(([key, v]) => ({
+            key,
+            bytes: Buffer.byteLength(JSON.stringify(v) ?? '', 'utf-8'),
+        })),
+        doc,
+    };
+}
+/** 取顶层区块或子路径，如 `shared` / `shared.title` / `branches.btn-pc.root`。 */
+export function sectionOf(doc, path) {
+    const keys = String(path || '').split('.').filter(Boolean);
+    if (!keys.length)
+        throw new Error('缺少区块路径');
+    let cur = doc;
+    for (const k of keys) {
+        if (cur === null || typeof cur !== 'object' || !(k in cur)) {
+            const avail = cur && typeof cur === 'object' ? Object.keys(cur).slice(0, 20).join('、') : '（非对象）';
+            throw new Error(`文档里不存在「${path}」（在「${k}」处断了；该层可用键：${avail}）`);
+        }
+        cur = cur[k];
+    }
+    return cur;
+}
+/**
+ * 统一取出根树。容忍三种 `root` 形态与 eb-button 的 `branches`。
+ * 返回的每一项是 `{name, node}`；`name` 用于回显（`root` / `branches.<分支>`）。
+ */
+export function domRoots(doc) {
+    const out = [];
+    const root = doc?.root;
+    if (root && typeof root === 'object') {
+        // `{desc, tree}` 形态：把真正的树取出来
+        out.push({ name: 'root', node: root.tree && typeof root.tree === 'object' ? root.tree : root });
+    }
+    const branches = doc?.branches;
+    if (branches && typeof branches === 'object' && !Array.isArray(branches)) {
+        for (const [k, v] of Object.entries(branches)) {
+            const node = v?.root ?? v;
+            if (node && typeof node === 'object')
+                out.push({ name: `branches.${k}`, node });
+        }
+    }
+    return out;
+}
+/** `class` 归一：字符串按空白切、数组原样收，统一返回字符串数组。 */
+export function classList(node) {
+    const c = node?.class ?? node?.className;
+    if (Array.isArray(c))
+        return c.map((x) => String(x ?? '')).filter(Boolean);
+    if (typeof c === 'string')
+        return c.split(/\s+/).filter(Boolean);
+    return [];
+}
+/** 就地展开 `{ref:"shared.x"}` / `"ref:shared.x"`；解不出或成环时原样返回，不抛。 */
+export function deref(node, shared, seen = new Set()) {
+    if (typeof node === 'string') {
+        const m = /^ref:(.+)$/.exec(node.trim());
+        if (!m)
+            return node;
+        const hit = resolveRef(m[1].trim(), shared, seen);
+        return hit === undefined ? node : hit;
+    }
+    if (Array.isArray(node))
+        return node.map((x) => deref(x, shared, seen));
+    if (!node || typeof node !== 'object')
+        return node;
+    const ref = node.ref ?? node.$ref;
+    if (typeof ref === 'string' && Object.keys(node).length <= 2) {
+        const hit = resolveRef(ref, shared, seen);
+        return hit === undefined ? { ...node } : hit; // 解不出保持原样，不换成标记串
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(node)) {
+        out[k] = k === 'ref' || k === '$ref' ? v : deref(v, shared, seen);
+    }
+    return out;
+}
+/** 解不到（不存在 / 成环）返回 undefined，由调用方决定怎么保留。 */
+function resolveRef(ref, shared, seen) {
+    const key = String(ref || '').replace(/^shared\./, '');
+    if (seen.has(key))
+        return undefined;
+    if (!shared || typeof shared !== 'object' || !(key in shared))
+        return undefined;
+    seen.add(key);
+    return deref(shared[key], shared, seen);
+}
+//# sourceMappingURL=dom-structure.js.map

package/dist/services/dom-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-structure.js","sourceRoot":"","sources":["../../src/services/dom-structure.ts"],"names":[],"mappings":"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"}

package/dist/services/form-field-patch.d.ts

@@ -18,6 +18,28 @@
 export declare const NO_MAX_LEN_TYPES: readonly ["IDCard", "Date", "DateTime", "Time", "City", "EInvoice", "SelectMultiple"];
 /** 支持「默认值」的类型（文本类写 content，数字类同键）。 */
 export declare const DEFAULT_VALUE_TYPES: readonly ["Text", "TextArea", "Number", "Money"];
+/**
+ * CLI 类型名 → **平台归一后的字段形状**（`type` / `componentKey` / 默认 `format`）。
+ *
+ * 为什么必须归一：`saveFormFieldNew` 要求 `componentKey` 非空，而平台接受的
+ * `componentKey` **不是 CLI 类型名**。同一个「日期时间」字段，平台存的是
+ * `type=Date` + `componentKey=DateComponent` + `format=yyyy-MM-dd HH:mm`；
+ * 送 `componentKey=Date`（哪怕 `type=DateTime`）直接 500 程序异常。
+ *
+ * 这张表不是推的，是拿真实租户读回来的 —— 建表路径建出来的字段，平台实际存什么就写什么。
+ * 只列**与类型名不同**的那几个，其余原样直通。
+ */
+export declare const PLATFORM_FIELD_SHAPES: Record<string, {
+    type: string;
+    componentKey: string;
+    format?: string;
+}>;
+/** 取某 CLI 类型对应要发送的平台形状；未登记的类型原样直通（`type`/`componentKey` 同为类型名）。 */
+export declare function platformFieldShape(cliType: string): {
+    type: string;
+    componentKey: string;
+    format?: string;
+};
 export interface FieldPatchOpts {
     /** 文本最大长度（字符串形式，来自命令行）。 */
     maxLen?: string;

package/dist/services/form-field-patch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-patch.d.ts","sourceRoot":"","sources":["../../src/services/form-field-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,uFAEnB,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,kDAAmD,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,cAAc,GACjD,YAAY,CA0Dd"}
+{"version":3,"file":"form-field-patch.d.ts","sourceRoot":"","sources":["../../src/services/form-field-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,uFAEnB,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,kDAAmD,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAazG,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAE3G;AAED,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,cAAc,GACjD,YAAY,CA0Dd"}

package/dist/services/form-field-patch.js

@@ -20,6 +20,35 @@ export const NO_MAX_LEN_TYPES = [
 ];
 /** 支持「默认值」的类型（文本类写 content，数字类同键）。 */
 export const DEFAULT_VALUE_TYPES = ['Text', 'TextArea', 'Number', 'Money'];
+/**
+ * CLI 类型名 → **平台归一后的字段形状**（`type` / `componentKey` / 默认 `format`）。
+ *
+ * 为什么必须归一：`saveFormFieldNew` 要求 `componentKey` 非空，而平台接受的
+ * `componentKey` **不是 CLI 类型名**。同一个「日期时间」字段，平台存的是
+ * `type=Date` + `componentKey=DateComponent` + `format=yyyy-MM-dd HH:mm`；
+ * 送 `componentKey=Date`（哪怕 `type=DateTime`）直接 500 程序异常。
+ *
+ * 这张表不是推的，是拿真实租户读回来的 —— 建表路径建出来的字段，平台实际存什么就写什么。
+ * 只列**与类型名不同**的那几个，其余原样直通。
+ */
+export const PLATFORM_FIELD_SHAPES = {
+    // 数字：平台 componentKey 带 Component 后缀（type 仍是 Number）
+    Number: { type: 'Number', componentKey: 'NumberComponent' },
+    // 日期 / 日期时间：**存储层是同一个东西** —— 都归成 Date/DateComponent，
+    // 唯一区别是 format。所以 `--type Date` 与 `--type DateTime` 的差异全在 format 上，
+    // 改类型时 format 必须一起写：平台不会补默认值（只送 type+componentKey 会存成 format 为空）。
+    Date: { type: 'Date', componentKey: 'DateComponent', format: 'yyyy-MM-dd' },
+    DateTime: { type: 'Date', componentKey: 'DateComponent', format: 'yyyy-MM-dd HH:mm' },
+    Time: { type: 'Time', componentKey: 'TimeComponent', format: 'HH:mm:ss' },
+    // 日期区间：componentKey 与 type 不同名
+    DateRange: { type: 'DateRange', componentKey: 'DateInterval' },
+    // 附件：平台 type 是 File（componentKey 保持全名）
+    FileComponent: { type: 'File', componentKey: 'FileComponent' },
+};
+/** 取某 CLI 类型对应要发送的平台形状；未登记的类型原样直通（`type`/`componentKey` 同为类型名）。 */
+export function platformFieldShape(cliType) {
+    return PLATFORM_FIELD_SHAPES[cliType] || { type: cliType, componentKey: cliType };
+}
 /**
  * 平台接口本身比设计器更宽容：`maxLen` 到 10000 都照收（65535 会被拒，
  * 但报的是「表单字段已超限制，不能继续新增字段」——指的是加字段数，与长度无关）。

package/dist/services/form-field-patch.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-patch.js","sourceRoot":"","sources":["../../src/services/form-field-patch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-field-patch.js","sourceRoot":"","sources":["../../src/services/form-field-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB;CAClE,CAAC;AAEX,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA4E;IAC5G,oDAAoD;IACpD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE;IAC3D,qDAAqD;IACrD,oEAAoE;IACpE,kEAAkE;IAClE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE;IAC3E,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACrF,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE;IACzE,+BAA+B;IAC/B,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE;IAC9D,uCAAuC;IACvC,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE;CAC/D,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,qBAAqB,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACpF,CAAC;AAsBD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,UAAU,iBAAiB,CAC/B,OAA4B,EAAE,IAAoB;IAElD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAExC,uDAAuD;IACvD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAK,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,qCAAqC,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBAC5B,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,eAAe,yBAAyB,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACzD,IAAI,CAAE,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,WAAW,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;YACrE,mDAAmD;YACnD,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;YACtB,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,GAAG,KAAK,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,wCAAwC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,gDAAgD;YAChD,mBAAmB;YACnB,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;YACpB,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/dist/services/form-i18n-label.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 表单多语言标签（i18n label）。
+ *
+ * 平台的**文本类配置位**（字段标题、查重规则的提示语等）存的是**标签 id**，不是文本本身。
+ * 设计器就是这么存的：先在多语言编辑器里写文案，拿到 `labelid`，再把 `labelid` 存进那个配置位。
+ *
+ * ⚠️ **不能直接存中文**。查重规则的 `helpContent` 传文本会被服务端拒：
+ * `提示内容格式不正确。`（2026-09-24 起后端已加拦截）。实测只要给的是 id，
+ * 无论接口走短路径还是双 form 路径、`checkFields` 带不带描述字段，都通。
+ *
+ * 标签 id 的形状是**负数雪花**（如 `-1318635683985383424`）—— 负数不是异常值，
+ * 字段的 `labelObj.title` 用的也是同一种形状。
+ */
+import type { ApiClient } from '../core/client.js';
+export interface LangRow {
+    id: string;
+    langid?: number;
+    langtype: string;
+    langName: string;
+    value?: string;
+    [k: string]: unknown;
+}
+/**
+ * 读多语言标签的各语言行。
+ * `labelId` 传 `'-1'` 拿的是**模板行**（每行有 id/langid/langtype，value 为空），新建标签时用它当底。
+ */
+export declare function readLanguageRows(client: ApiClient, baseUrl: string, labelId: string, module: string): Promise<LangRow[]>;
+/**
+ * 新建一个多语言标签，返回它的 `labelid`（负数雪花）。
+ *
+ * 默认只写简体中文；要同时写英文传 `en`。
+ * 报文形状对齐设计器实际发出的那一次（`dialogVisible`/`loading` 都是 `false`、
+ * `tabMenuValue` 给的是 **en_US 那一行**、`usernamePerLangs` 里不带「(默认)」后缀）。
+ */
+export declare function createMultilangLabel(client: ApiClient, baseUrl: string, zh: string, module: string, en?: string): Promise<string>;
+/** 配置位里存的是不是多语言标签 id（负数雪花）。**不要**用「是负数」一概而论地判文本。 */
+export declare function looksLikeLabelId(value: unknown): boolean;
+/**
+ * 标签写入后有**约 10 秒的延迟才可读**（实测：存完 +7s 仍取回空、+11s 才拿到文本）。
+ * 所以「刚建完规则马上 list」会看到原始 id，**这不是 bug**，等一会儿再读就有文本。
+ * 命令层不做重试等待 —— 等十秒会让人以为卡住了，而换个时间读就好了。
+ */
+/**
+ * 把配置位里的值还原成人能读的文本：是标签 id 就查回简体中文，否则原样返回。
+ * **老数据兼容**：拦截上线前存的规则里 `helpContent` 是中文原文，这条路要能照常显示。
+ */
+export declare function resolveLabelText(client: ApiClient, baseUrl: string, value: unknown, module: string): Promise<string>;
+//# sourceMappingURL=form-i18n-label.d.ts.map

package/dist/services/form-i18n-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-i18n-label.d.ts","sourceRoot":"","sources":["../../src/services/form-i18n-label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKnD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAClE,OAAO,CAAC,OAAO,EAAE,CAAC,CAMpB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAC1E,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;GAIG;AAEH;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GACjE,OAAO,CAAC,MAAM,CAAC,CAWjB"}