weaver-e10-builder 1.5.2 → 1.5.4

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

@@ -0,0 +1,103 @@
+/**
+ * **按字段取组件模板** —— 布局增量插入在「本表还没有这个类型」时的模板来源。
+ *
+ * ## 这条路解决的是什么
+ *
+ * `form-layout-insert` 的增量插入是**照现成的同类型 comp 克隆**的（布局层专有键 + 各类型
+ * 自己的键集，按类型名拼只能猜）。于是一张表里**第一次**加某个类型时会中止：
+ * 「本表还没有『Switch』类型的字段，没有可参照的组件模板」。
+ *
+ * 平台其实有现成的模板，只是不在布局里 —— 在 `getFormFieldExist` 的返回里。
+ *
+ * ## `getFormFieldExist` 给什么
+ *
+ * `POST /api/ebuilder/form/form/builder/getFormFieldExist`（body 里的 `formField.title` 传空串即
+ * 「本表单全部字段」）按分类返回字段的**面板形态**：
+ *
+ * ```
+ * { id: <fieldId>, name, higherLevelId, leftSideType: 'used', applyStyle, category, icon,
+ *   configPC: '[{ styleCategoryCompKey, package, prop, applyStyle, styleCategoryPackage,
+ *                type, config: { …该字段的完整配置… } }]' }
+ * ```
+ *
+ * `configPC[0]` 就是**平台按该字段定义生成的组件模板**：顶层键（按类型的样式键）与 config
+ * （含类型专有键）都给全了。拿一根 Switch 实测对照平台自己 `initLayout` 产出的 comp：
+ *
+ * | 键 | 平台 comp | 字段记录 | **configPC** |
+ * |---|---|---|---|
+ * | `switchType` | `"switch"` | `"switch"` | `"switch"` |
+ * | `childName` / `parentName` | `""` | **无** | `""` |
+ * | `hasChild` | `false` | **无** | `false` |
+ * | `options` | `[]` | **无** | `[]` |
+ * | `typeLen` | `1` | **无** | `1` |
+ *
+ * ⚠ **字段记录（`getFormFieldPage`）不够** —— 它缺 `childName`/`parentName`/`hasChild`/`options`/
+ * `typeLen` 这类**只存在于组件侧的默认值**。所以模板必须从这个接口拿，不能靠字段记录拼。
+ *
+ * ## 覆盖范围（实测）
+ *
+ * - ✅ **主表字段**：新建的字段立刻就在返回里（`leftSideType: 'used'`），**本表从没有过的类型也有**。
+ * - ❌ **明细表字段**：拿不到 —— 分类「明细表」恒为空，试过 `subFormId` / `higherLevelId` /
+ *   `formTableId` / `ebbusinessid` 换成子表 id 等 8 种参数，一律不返回。
+ *   **但 configPC 是「按类型」而不是「按作用域」的**（`config.flow` 是空对象、没有 `excel`），
+ *   所以明细表要新类型时，可以借**主表**同类型字段的那一份，作用域由调用方自己写。
+ */
+const PATH = '/api/ebuilder/form/form/builder/getFormFieldExist';
+/**
+ * 取本表单**主表**字段的组件模板，按 `fieldId` 索引。
+ *
+ * 明细表字段不在返回里（见模块头），所以这张表只覆盖主表。
+ * 调用方要明细表的模板时，用 `componentKey` 去这张表里找同类型的主表字段。
+ */
+export async function fetchFieldTypeTemplates(client, baseUrl, appId, formId) {
+    const res = await client.post(`${baseUrl}${PATH}?apid=${encodeURIComponent(appId)}`, {
+        module: 'ebuilderform',
+        appId,
+        customParam: { terminal: '', objId: formId },
+        formField: { formId, title: '' },
+    }, { ebbusinessid: formId });
+    const out = new Map();
+    if (res?.code !== 200 || !res?.status)
+        return out;
+    for (const cat of res?.data || []) {
+        for (const entry of cat?.comps || []) {
+            const comps = parseConfigPC(entry?.configPC);
+            const comp = comps[0];
+            if (!comp || !entry?.id)
+                continue;
+            out.set(String(entry.id), { fieldId: String(entry.id), comp, type: String(comp.type || '') });
+        }
+    }
+    return out;
+}
+/** `configPC` 是**JSON 字符串**（设计器那边存的形态），解析失败当没有。 */
+export function parseConfigPC(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    if (typeof raw !== 'string' || !raw.trim())
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 在模板表里找一个**指定类型**的模板（`fieldId` 命中不了时用）。
+ *
+ * 给明细表字段用：明细表自己那份拿不到，就借主表同类型的。`preferType` 是
+ * `componentKey`（如 `Switch` / `NumberComponent`），对不上 `type` 时再比一次 `type`。
+ */
+export function findTemplateByType(templates, want) {
+    const target = String(want);
+    for (const entry of templates.values()) {
+        if (entry.type === target)
+            return entry;
+        if (String(entry.comp?.config?.componentKey ?? '') === target)
+            return entry;
+    }
+    return null;
+}
+//# sourceMappingURL=form-field-template.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-template.js","sourceRoot":"","sources":["../../src/services/form-field-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAWH,MAAM,IAAI,GAAG,mDAAmD,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA0E,EAC1E,OAAe,EACf,KAAa,EACb,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAC3B,GAAG,OAAO,GAAG,IAAI,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,EACrD;QACE,MAAM,EAAE,cAAc;QACtB,KAAK;QACL,WAAW,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QAC5C,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;KACjC,EACD,EAAE,YAAY,EAAE,MAAM,EAAE,CACzB,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,IAAI,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM;QAAE,OAAO,GAAG,CAAC;IAElD,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE;gBAAE,SAAS;YAClC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA0C,EAC1C,IAAY;IAEZ,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,26 @@
+export declare function canonComponentKey(ck: string): string;
+/** 可用的字段类型 = 基础组件（CK_CANON 的值）∪ 富组件（RICH_TYPE_MAP 的键）∪ 上述补充。
+ * 导出仅为让测试能盯住"平台支持的合法类型不许漏登记"（漏了会被 assertFieldType 误杀）。 */
+export declare const FIELD_TYPE_CHOICES: string[];
+/**
+ * 校验字段类型名。不校验的话错类型会**直送服务器**，换回一段
+ * `Cannot invoke "ComponentType.name()" because ... getComponentKey() is null`——
+ * 既看不出哪错了，也看不出该填什么。这里先拦下来并列出可选值。
+ */
+export declare function assertFieldType(fieldType: string, where?: string): void;
+/**
+ * 校验选项定义。**键名必须是 `name` / `valueKey`**——写成 `{value,label}` 这类
+ * 不会被拦下，而是静默存成「没有名字的选项」（平台侧 fieldOptionName 为空），
+ * 之后 `form data add` 按选项名写数据会直接失效，且读回也看不出哪里错了。
+ */
+export declare function assertFieldOptions(fieldName: string, options: any[]): void;
+/**
+ * 把用户写的字段定义归一成平台认的形状：
+ * - `fieldType` → `componentKey`（两个名字都收）
+ * - componentKey 大小写归一
+ * - `options`（字符串数组简写）→ `fieldOptions: [{name}]`
+ *
+ * 顶层字段与明细子字段共用本函数，避免两边校验不一致。
+ */
+export declare function normalizeFieldDef(raw: any): any;
+//# sourceMappingURL=form-field-validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-validate.d.ts","sourceRoot":"","sources":["../../src/services/form-field-validate.ts"],"names":[],"mappings":"AA2BA,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEpD;AAmBD;0DAC0D;AAC1D,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAI7B,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAgB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAsB/C"}

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

@@ -0,0 +1,121 @@
+import { RICH_TYPE_MAP } from './rich-types.js';
+/**
+ * 字段定义的**归一化与校验**（建表 / 加字段入口共用）。
+ *
+ * 原先内联在 `commands/form.ts` 的建表 action 里。抽出来是为了让
+ * **「标准建表」与「专项建表」两个入口共用同一份** —— 多一个入口就多一处真相，
+ * 两边的类型归一或选项校验一旦分叉，问题会以「为什么这张表建出来的字段不对」的形式出现。
+ *
+ * 注：校验失败走 `process.exit(1)`（与原实现一致）—— 这是命令层的既有约定，
+ * 搬移时**刻意不改**，避免改变任何调用方的行为。
+ */
+/**
+ * componentKey 大小写归一：用户/示例常写 "Textarea"/"Ebuilder" 等小写变体，但代码各处
+ * `=== 'TextArea'`、storageFieldType 按 canonical 大小写匹配。不归一会导致 type 存成小写
+ * "Textarea"（FLOW 渲染器按 type 查组件查不到 → 多行文本在流式布局下渲染异常）、TextArea
+ * 分支（content/maxLen）漏跑。建表 create 和加字段 add-field 都用。
+ */
+const CK_CANON = {
+    textarea: 'TextArea', ebuilder: 'EBuilder', datetime: 'DateTime',
+    idcard: 'IDCard', mobile: 'Mobile', email: 'Email', phone: 'Phone',
+    employee: 'Employee', department: 'Department', subcompany: 'SubCompany', location: 'Location',
+    switch: 'Switch', select: 'Select', checkbox: 'CheckBox', radiobox: 'RadioBox',
+    money: 'Money', number: 'Number', date: 'Date', text: 'Text',
+    daterange: 'DateRange', detailtable: 'DetailTable', city: 'City',
+};
+export function canonComponentKey(ck) {
+    return CK_CANON[String(ck).toLowerCase()] || ck;
+}
+/**
+ * 代码里另有分支/别名、不在 CK_CANON 与 RICH_TYPE_MAP 两处的字段类型。
+ * **宁宽勿窄**：多列一个只是照旧送服务器，漏一个会把合法类型误杀，所以这里尽量收全。
+ * 新增字段类型时记得同步。
+ */
+const EXTRA_FIELD_TYPES = [
+    'Flow', 'SelectMultiple', 'DateInterval', 'ColorPicker', 'DataTable',
+    'DocFolder', 'DocFloder', 'Fold', 'Placeholder', 'Sharer', 'FileComponent',
+    // 附件是 `FileComponent`。**不要**再往这里加 `Attachment` —— 平台没有这个组件键：
+    // 送过去字段直接建不出来（`getComponentKey()` 为 null），而列在这儿等于告诉用户"它可以"。
+    'EbuilderAppTag', 'Image', 'Signature', 'RichText', 'RelateBrowser',
+    // EInvoice 电子发票：下方 add-field 有专属构建分支（isSingle/invoiceType），此前漏登记 →
+    // 被 assertFieldType 挡成死代码。AudioRecord/VideoRecord 语音视频：极简 jsonObj，平台原样透传
+    // （见 rich-types.ts 的说明），无需富组件模板。
+    'EInvoice', 'AudioRecord', 'VideoRecord',
+];
+/** 可用的字段类型 = 基础组件（CK_CANON 的值）∪ 富组件（RICH_TYPE_MAP 的键）∪ 上述补充。
+ * 导出仅为让测试能盯住"平台支持的合法类型不许漏登记"（漏了会被 assertFieldType 误杀）。 */
+export const FIELD_TYPE_CHOICES = [...new Set([
+        ...Object.values(CK_CANON),
+        ...Object.keys(RICH_TYPE_MAP),
+        ...EXTRA_FIELD_TYPES,
+    ])].sort();
+/**
+ * 校验字段类型名。不校验的话错类型会**直送服务器**，换回一段
+ * `Cannot invoke "ComponentType.name()" because ... getComponentKey() is null`——
+ * 既看不出哪错了，也看不出该填什么。这里先拦下来并列出可选值。
+ */
+export function assertFieldType(fieldType, where = '') {
+    if (FIELD_TYPE_CHOICES.includes(fieldType))
+        return;
+    console.error(`${where}不支持的字段类型: ${fieldType}`);
+    console.error(`  可选: ${FIELD_TYPE_CHOICES.join(' / ')}`);
+    process.exit(1);
+}
+/**
+ * 校验选项定义。**键名必须是 `name` / `valueKey`**——写成 `{value,label}` 这类
+ * 不会被拦下，而是静默存成「没有名字的选项」（平台侧 fieldOptionName 为空），
+ * 之后 `form data add` 按选项名写数据会直接失效，且读回也看不出哪里错了。
+ */
+export function assertFieldOptions(fieldName, options) {
+    options.forEach((o, i) => {
+        if (typeof o === 'string')
+            return; // 字符串简写，归一化时会补成 {name}
+        const where = `字段「${fieldName}」第 ${i + 1} 个选项`;
+        if (typeof o?.name !== 'string' || !o.name.trim()) {
+            const got = o && typeof o === 'object' ? Object.keys(o).join(' / ') : String(o);
+            console.error(`${where}缺少 name（收到键：${got || '(无)'}）`);
+            console.error('  正确写法: {"name":"待入职","valueKey":"1"}（valueKey 省略则由平台生成）');
+            process.exit(1);
+        }
+        const vk = o.valueKey;
+        if (vk !== undefined && vk !== null && String(vk) !== '' && !/^\d+$/.test(String(vk))) {
+            console.error(`${where}的 valueKey「${vk}」必须是数字（平台规范，下游按数字引用）`);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * 把用户写的字段定义归一成平台认的形状：
+ * - `fieldType` → `componentKey`（两个名字都收）
+ * - componentKey 大小写归一
+ * - `options`（字符串数组简写）→ `fieldOptions: [{name}]`
+ *
+ * 顶层字段与明细子字段共用本函数，避免两边校验不一致。
+ */
+export function normalizeFieldDef(raw) {
+    const out = { ...raw };
+    if (!out.componentKey && out.fieldType)
+        out.componentKey = out.fieldType;
+    if (out.componentKey)
+        out.componentKey = canonComponentKey(out.componentKey);
+    const label = out.fieldName || out.title || '(未命名)';
+    assertFieldType(out.componentKey || '', `字段「${label}」`);
+    if (Array.isArray(out.options) && !out.fieldOptions) {
+        out.fieldOptions = out.options.map((o) => typeof o === 'string' ? { name: o } : o);
+    }
+    if (Array.isArray(out.fieldOptions)) {
+        assertFieldOptions(label, out.fieldOptions);
+    }
+    else if (out.fieldOptions !== undefined && out.fieldOptions !== null) {
+        // **写成对象时必须当场拦下。** 以前这里只判数组，非数组就这么放过去了，
+        // 一路带到建表里的 `fieldOptions.map(...)` 才炸成
+        // `TypeError: fieldOptions.map is not a function` —— 报错既看不出是哪个字段，
+        // 也看不出该写什么（用户往往是想配「精度/多选」这类**字段属性**，塞错了地方）。
+        console.error(`字段「${label}」的 fieldOptions 必须是**数组**：[{"name":"待入职","valueKey":"1"}]；`
+            + `收到的是对象（键：${Object.keys(out.fieldOptions).join(' / ') || '(无)'}）。`);
+        console.error('  想配精度 / 多选这类**字段属性**，写在字段对象本身上：precision、multiple、delimiter…');
+        process.exit(1);
+    }
+    return out;
+}
+//# sourceMappingURL=form-field-validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-validate.js","sourceRoot":"","sources":["../../src/services/form-field-validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,QAAQ,GAA2B;IACvC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU;IAChE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;IAClE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU;IAC9F,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU;IAC9E,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAC5D,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM;CACjE,CAAC;AACF,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG;IACxB,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW;IACpE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe;IAC1E,6DAA6D;IAC7D,4DAA4D;IAC5D,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe;IACnE,mEAAmE;IACnE,yEAAyE;IACzE,iCAAiC;IACjC,UAAU,EAAE,aAAa,EAAE,aAAa;CACzC,CAAC;AAEF;0DAC0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAa,CAAC,GAAG,IAAI,GAAG,CAAC;QACtD,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1B,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7B,GAAG,iBAAiB;KACrB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,KAAK,GAAG,EAAE;IAC3D,IAAI,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO;IACnD,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,aAAa,SAAS,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,KAAK,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,OAAc;IAClE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,uBAAuB;QAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC/C,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAChF,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,eAAe,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;QACtB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,cAAc,EAAE,sBAAsB,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,SAAS,CAAC;IACzE,IAAI,GAAG,CAAC,YAAY;QAAE,GAAG,CAAC,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC;IACpD,eAAe,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE,MAAM,KAAK,GAAG,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACpD,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QACvE,wCAAwC;QACxC,uCAAuC;QACvC,kEAAkE;QAClE,4CAA4C;QAC5C,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,4DAA4D;cACjF,YAAY,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/services/form-id.d.ts

@@ -0,0 +1,50 @@
+import type { ApiClient } from '../core/client.js';
+export type FormIdClient = Pick<ApiClient, 'get'>;
+/** 需要同时 POST 的调用方（补齐三方表单、按 formId 反查）。 */
+export type FormListClient = Pick<ApiClient, 'get' | 'post'>;
+/**
+ * 把**三方表单**追加进一份 `obj/getList` 风格的列表（就地 push）。
+ *
+ * `obj/getList` 不含三方表单（专项应用），所以 `form list`、EBuilder 关联字段解析目标表名
+ * 这类「拿整份列表挑」的地方会漏。这里用前端那份列表补齐，并**归一成 getList 行的形状**：
+ * `id` = objId、`formId` 就位、`formName` / `name` 对齐 —— 调用方一行都不用改。
+ *
+ * 已有 id 的不重复加；补齐拿不到就什么都不做。标准应用里没有三方表单，等于空转。
+ */
+export declare function appendThirdPartyForms(client: FormListClient, baseUrl: string, appId: string, list: any[]): Promise<void>;
+/**
+ * 反查：`formId` → `objId`。
+ *
+ * 与 `resolveFormRecord` 方向相反。主力仍是 `obj/getList`（按 formId 找 `id`）；
+ * 三方表单不在那份列表里，命不中时改走前端那份列表（每行 `id` 是 formId、`objId` 是 objId），
+ * 并**核对 appId 一致**才采纳。两条都拿不到回 `''`。
+ */
+export declare function resolveObjIdByFormId(client: FormListClient, baseUrl: string, appId: string, formId: string): Promise<string>;
+/**
+ * 按 `objId` 取表单记录（`appId` 用于定位与校验）。
+ *
+ * 平台上有两条取法：
+ *
+ * 1. **`obj/getList/<appId>`** —— 列这个应用下的全部表单，按 objId 找。**主力路径**，
+ *    各处原本就是这么写的；命中的就是**原来那一行记录对象**，字段一个不多一个不少。
+ * 2. **`obj/getInfoById/<objId>`** —— 按 id 直取单张表。
+ *
+ * ⚠ **第 1 条会漏表**：`obj/getList` **不含三方表单**（专项应用里 `thirdPartyFlag=1` 的表）。
+ * 在那类应用上它一条都查不到 —— 现象是「无法获取 formId」，而 objId / appId 其实完全正确。
+ * 第 2 条按 id 取，与列表的收录范围无关，能拿到。
+ *
+ * 兜底刻意写窄，保证**不影响原有行为**：
+ *
+ * - 只有第 1 条**没命中**时才走第 2 条 —— 原本查得到的路径一行不变、一次请求不多
+ * - 第 2 条的结果必须**核对 `appId` 一致**才采纳 —— 否则 objId 属于别的应用时会把不相干的
+ *   记录带进来，把「原本报错」变成「静默做错事」
+ * - 两条都拿不到就回 `null`，调用方照原样报错
+ */
+export declare function resolveFormRecord(client: FormIdClient, baseUrl: string, appId: string, objId: string, 
+/** 调用点原本若还按行上的 `objId` 字段匹配（而不只是 `id`），传 true 保持语义不变。 */
+opts?: {
+    matchObjIdKey?: boolean;
+}): Promise<any | null>;
+/** `resolveFormRecord` 的 formId 版。取不到回 `''`（与原本「查不到就空串」的写法一致）。 */
+export declare function resolveFormId(client: FormIdClient, baseUrl: string, appId: string, objId: string): Promise<string>;
+//# sourceMappingURL=form-id.d.ts.map

package/dist/services/form-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-id.d.ts","sourceRoot":"","sources":["../../src/services/form-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAElD,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;AAwB7D;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,GAAG,EAAE,GACV,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM;AACb,yDAAyD;AACzD,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAoBrB;AAED,kEAAkE;AAClE,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/services/form-id.js

@@ -0,0 +1,110 @@
+import { FORM_PAGE_PATH, buildFormPageBody, SPECIAL_FRONT_EBBUSINESSID } from './special-route.js';
+/**
+ * 从**前端那份表单列表**（`formManage/getFormPage` + `terminal=front`）取行。
+ *
+ * 这是唯一一份**含三方表单**的列表：`obj/getList` 的 `system` 栏只含 `thirdPartyFlag=0`，
+ * `thirdParty` 栏需要 `tpaid`（语义未摸清，恒空）。
+ *
+ * 拿不到就回 `[]` —— 调用方按「没补齐」处理，绝不影响原本的结果。
+ */
+async function fetchFrontFormRows(client, baseUrl, appId) {
+    try {
+        const res = await client.post(`${baseUrl}${FORM_PAGE_PATH}`, buildFormPageBody(appId, 1, 500), { ebbusinessid: SPECIAL_FRONT_EBBUSINESSID });
+        const rows = res?.data?.pageDatas?.result;
+        return Array.isArray(rows) ? rows : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 把**三方表单**追加进一份 `obj/getList` 风格的列表（就地 push）。
+ *
+ * `obj/getList` 不含三方表单（专项应用），所以 `form list`、EBuilder 关联字段解析目标表名
+ * 这类「拿整份列表挑」的地方会漏。这里用前端那份列表补齐，并**归一成 getList 行的形状**：
+ * `id` = objId、`formId` 就位、`formName` / `name` 对齐 —— 调用方一行都不用改。
+ *
+ * 已有 id 的不重复加；补齐拿不到就什么都不做。标准应用里没有三方表单，等于空转。
+ */
+export async function appendThirdPartyForms(client, baseUrl, appId, list) {
+    const rows = await fetchFrontFormRows(client, baseUrl, appId);
+    if (rows.length === 0)
+        return;
+    const known = new Set(list.map((f) => String(f?.id)));
+    for (const r of rows) {
+        if (String(r?.thirdPartyFlag) !== '1')
+            continue; // 只补三方表单；系统表单本来就在
+        const objId = String(r?.objId ?? '');
+        if (!objId || known.has(objId))
+            continue;
+        known.add(objId);
+        list.push({
+            ...r,
+            id: objId,
+            formId: String(r?.id ?? ''),
+            formName: r?.name ?? '',
+            name: r?.name ?? '',
+        });
+    }
+}
+/**
+ * 反查：`formId` → `objId`。
+ *
+ * 与 `resolveFormRecord` 方向相反。主力仍是 `obj/getList`（按 formId 找 `id`）；
+ * 三方表单不在那份列表里，命不中时改走前端那份列表（每行 `id` 是 formId、`objId` 是 objId），
+ * 并**核对 appId 一致**才采纳。两条都拿不到回 `''`。
+ */
+export async function resolveObjIdByFormId(client, baseUrl, appId, formId) {
+    const encApp = encodeURIComponent(appId);
+    const listRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${encApp}?apid=${encApp}`, { ebbusinessid: appId });
+    const hit = (listRes?.data || []).find((f) => String(f?.formId) === String(formId));
+    if (hit?.id)
+        return String(hit.id);
+    const rows = await fetchFrontFormRows(client, baseUrl, appId);
+    const row = rows.find((r) => String(r?.id) === String(formId));
+    if (row?.objId && String(row.appId ?? '') === String(appId))
+        return String(row.objId);
+    return '';
+}
+/**
+ * 按 `objId` 取表单记录（`appId` 用于定位与校验）。
+ *
+ * 平台上有两条取法：
+ *
+ * 1. **`obj/getList/<appId>`** —— 列这个应用下的全部表单，按 objId 找。**主力路径**，
+ *    各处原本就是这么写的；命中的就是**原来那一行记录对象**，字段一个不多一个不少。
+ * 2. **`obj/getInfoById/<objId>`** —— 按 id 直取单张表。
+ *
+ * ⚠ **第 1 条会漏表**：`obj/getList` **不含三方表单**（专项应用里 `thirdPartyFlag=1` 的表）。
+ * 在那类应用上它一条都查不到 —— 现象是「无法获取 formId」，而 objId / appId 其实完全正确。
+ * 第 2 条按 id 取，与列表的收录范围无关，能拿到。
+ *
+ * 兜底刻意写窄，保证**不影响原有行为**：
+ *
+ * - 只有第 1 条**没命中**时才走第 2 条 —— 原本查得到的路径一行不变、一次请求不多
+ * - 第 2 条的结果必须**核对 `appId` 一致**才采纳 —— 否则 objId 属于别的应用时会把不相干的
+ *   记录带进来，把「原本报错」变成「静默做错事」
+ * - 两条都拿不到就回 `null`，调用方照原样报错
+ */
+export async function resolveFormRecord(client, baseUrl, appId, objId, 
+/** 调用点原本若还按行上的 `objId` 字段匹配（而不只是 `id`），传 true 保持语义不变。 */
+opts = {}) {
+    const encApp = encodeURIComponent(appId);
+    const listRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${encApp}?apid=${encApp}`, { ebbusinessid: appId });
+    const hit = (listRes?.data || []).find((f) => String(f?.id) === String(objId)
+        || (opts.matchObjIdKey === true && String(f?.objId) === String(objId)));
+    if (hit)
+        return hit;
+    // 列表里没有 —— 三方表单就是这种情况。按 id 直取，但必须确认它真属于这个应用。
+    const infoRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getInfoById/${encodeURIComponent(objId)}?apid=${encApp}`, { ebbusinessid: appId });
+    const record = infoRes?.data;
+    if (record && String(record.appId ?? '') === String(appId) && record.id)
+        return record;
+    return null;
+}
+/** `resolveFormRecord` 的 formId 版。取不到回 `''`（与原本「查不到就空串」的写法一致）。 */
+export async function resolveFormId(client, baseUrl, appId, objId) {
+    const record = await resolveFormRecord(client, baseUrl, appId, objId);
+    return record?.formId ? String(record.formId) : '';
+}
+//# sourceMappingURL=form-id.js.map

package/dist/services/form-id.js.map

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

package/dist/services/form-layout-grid.d.ts

@@ -0,0 +1,123 @@
+/**
+ * EXCEL 布局的**网格层**：`pageLayouts[].config.workbook.Sheet1`。
+ *
+ * ## 为什么单开一个模块
+ *
+ * EXCEL 布局的位置有**两份副本**，必须同时改，少改一份就是一个静默的坏布局：
+ *
+ * | 副本 | 字段 | 谁在读 |
+ * |---|---|---|
+ * | 组件层 | `comps[].config.excel.row` / `.col` | `form layout read`、其它 comp 逻辑 |
+ * | 网格层 | `config.workbook.Sheet1.cells[].row` / `.col` + `style.cellType.comId` | **设计器渲染** |
+ *
+ * 网格那一份是**设计器的渲染源**：每个格子靠 `style.cellType.comId` 认到自己的 comp，
+ * 位置也以格子自己的 `row`/`col` 为准。只改组件层的话，接口回 200、命令报成功，
+ * 但设计器里**新字段没有格子可画**（或被画在旧位置）—— 表现是「布局改坏了 / 前端渲染错误」，
+ * 而手工在页面上保存一次（设计器按 comps 重算网格）就又好了。
+ *
+ * 实测（2026-10-10）：平台自己的 `initLayout` 产出**严格一一对应**；
+ * 我们此前的增量插入只改组件层。`form layout remove-field` 当年就同步了网格
+ * （见 `commands/form-layout.ts`），插入与移动这两条漏了 —— 本模块把这份同步收成一处。
+ *
+ * ## FLOW 没有网格
+ *
+ * FLOW 布局靠 `config.flow.parent` / `nodes` 排布，**根本没有 `config.workbook`**。
+ * 所有函数遇到没有网格的页一律 no-op，返回 0/false，不抛错。
+ *
+ * ## 格子形状（实测抓的）
+ *
+ * ```jsonc
+ * { "row": "1", "col": "2",                              // ⚠ 字符串，不是数字
+ *   "style": { "foreColor": "#111111", "textIndent": 2,
+ *              "borderBottom": {...}, ...,               // 标签格另有 backColor + hAlign
+ *              "cellType": { "comId": "<comp id>", "type": "Text" } } }
+ * ```
+ *
+ * 样式不进这个模块的判据 —— 新格子一律**照模板 comp 的格子克隆**，只改写
+ * `row`/`col`/`cellType`，这样边框、底纹、对齐都跟着模板走，不用逐键猜。
+ */
+/**
+ * 取 EXCEL 布局的网格 Sheet；**FLOW（没有 workbook）返回 null**。
+ *
+ * `cells` 为空数组时也返回 sheet —— 空网格是合法状态（表里一个字段都没有）。
+ * 只有 `cells` 压根不是数组（不是 EXCEL 布局）才返回 null。
+ */
+export declare function excelSheetOf(page: any): any | null;
+/**
+ * EXCEL 页里**某个作用域**对应的网格 Sheet。
+ *
+ * 主表是 `Sheet1`；**明细表有自己的一张**，`workbook` 的键就是那个 `DetailTable` 组件的 `id`
+ * （`form add-detail-table --force` 摘组件时也是这么认的）。主表字段不能去明细那张找格子，
+ * 反之亦然 —— 找错表的表现是「模板格找不到，没补格」。
+ */
+export declare function sheetForScope(page: any, subFormId?: string): any | null;
+/**
+ * 按 comp id 找它那一格。
+ *
+ * 空 `compId` 一律返回 null：表单标题那一格**没有** `cellType.comId`（`compIdOf` 得到空串），
+ * 不挡的话拿空串一查就命中它，把标题格当成某个组件的格。
+ */
+export declare function findCellByCompId(sheet: any, compId: string): any | null;
+/**
+ * 保证 `rows` 覆盖到 `row` 行。不够就补，尺寸沿用最后一行的（没有就 30）。
+ *
+ * 平台产出的 `rows` 会比实际用到的略长（实测用了 0–3 行、`rows` 有 6 条），
+ * 但**不能假定它一定够** —— 补上比让设计器去猜安全。
+ */
+export declare function ensureRowCovered(sheet: any, row: number): number;
+export interface NewCompCell {
+    /** 新组件的 `id`。 */
+    compId: string;
+    /** 新组件的 `type`（写进 `cellType.type`）。 */
+    type: string;
+    /** 新组件的位置 —— 直接读它自己的 `config.excel.row/col`。 */
+    row: number;
+    col: number;
+    /** 拿谁的格子当模板（同表同类型的现成 comp）。 */
+    templateCompId: string;
+}
+export interface AppendCellsResult {
+    added: number;
+    warnings: string[];
+}
+export interface FillCellsOptions {
+    /**
+     * 模板格从哪来。返回 `null` 表示借不到。
+     *
+     * 两条路各有各的来源：**增量插入**从本页网格里找同类型 comp 的格子；
+     * **建视图**时本页网格本来就是空的，得从**源布局**借同一个字段的格子。
+     */
+    templateCellOf: (entry: NewCompCell) => any | null;
+    /**
+     * 借不到模板格时，是否造一格**最小格**（只有位置 + `cellType`）。
+     *
+     * - `false`（缺省）：跳过并告警。用在增量插入 —— 那里借不到模板说明这张表的网格
+     *   本来就残缺，凭空补一格等于把「残缺」伪装成「正常」。
+     * - `true`：造最小格。用在建视图 —— 那里源布局里**可能**没有对应字段（新加的字段），
+     *   但视图总得有格子才画得出来，宁可样式素一点也不能缺格。样式缺失会在 warnings 里说明。
+     */
+    synthesizeWhenMissing?: boolean;
+    /** 要写哪张网格。不给就按主表（`Sheet1`）—— 明细字段要传明细表那张（见 `sheetForScope`）。 */
+    sheet?: any;
+}
+/**
+ * 给一批新 comp 造格子并塞进网格。模板格由调用方给（见 `FillCellsOptions`），
+ * 统一在这里做三件事：克隆改写、占位告警、`rows` 补够。
+ *
+ * 没有网格（FLOW）时返回 `{added:0, warnings:[]}` —— 静默 no-op，因为那不是异常。
+ */
+export declare function fillCells(page: any, entries: NewCompCell[], opts: FillCellsOptions): AppendCellsResult;
+/**
+ * 增量插入用的入口：模板格**从本页网格里**找（同表同类型的现成 comp 的格子）。
+ *
+ * 借不到就跳过并告警 —— 见 `FillCellsOptions.synthesizeWhenMissing` 那段取舍。
+ */
+export declare function appendCellsForNewComps(page: any, entries: NewCompCell[], subFormId?: string): AppendCellsResult;
+/**
+ * 把某 comp 的格子挪到新位置（`form layout move` 用）。
+ *
+ * 只改格子的 `row`/`col` —— `cellType`、样式都留原样，动的只是位置。
+ * 没有网格（FLOW）或找不到格子时返回 false（调用方自己决定要不要提示）。
+ */
+export declare function moveCellTo(page: any, compId: string, row: number, col: number): boolean;
+//# sourceMappingURL=form-layout-grid.d.ts.map

package/dist/services/form-layout-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout-grid.d.ts","sourceRoot":"","sources":["../../src/services/form-layout-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAKH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAIlD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAUvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,GAAG,GAAG,IAAI,CAAC;IACnD;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gEAAgE;IAChE,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CA8CtG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAM/G;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CASvF"}