weaver-e10-builder 1.5.15 → 1.6.0

package/dist/services/form-layout-template-flow.js.map

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

package/dist/services/form-layout-template-verification.d.ts

@@ -0,0 +1,34 @@
+import type { ApiClient } from '../core/client.js';
+export interface TemplateEvidence {
+    kind: 'advanced' | 'flow';
+    id: string;
+    fingerprint: string;
+    style: Record<string, unknown>;
+    columns?: Array<{
+        type: string;
+        size: number;
+    }>;
+}
+export interface EasyTemplateEvidence {
+    kind: 'easy';
+    id: string;
+    fingerprint: string;
+    columns: Array<{
+        type: string;
+        size: number;
+    }>;
+    rowHeight: number;
+    titleStyle: {
+        backColor?: string;
+        borderColor?: string;
+    };
+    fieldStyle: {
+        backColor?: string;
+        borderColor?: string;
+    };
+}
+export declare function readEasyTemplateEvidence(client: Pick<ApiClient, 'get' | 'post'>, baseUrl: string, id: string): Promise<EasyTemplateEvidence>;
+export declare function verifyAppliedEasyTemplate(evidence: EasyTemplateEvidence, formLayout: any): string[];
+export declare function readTemplateEvidence(client: Pick<ApiClient, 'post'>, baseUrl: string, layoutType: string, id: string): Promise<TemplateEvidence>;
+export declare function verifyAppliedTemplate(evidence: TemplateEvidence, formLayout: any): string[];
+//# sourceMappingURL=form-layout-template-verification.d.ts.map

package/dist/services/form-layout-template-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout-template-verification.d.ts","sourceRoot":"","sources":["../../src/services/form-layout-template-verification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AACD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAC9C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,UAAU,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAMD,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EACrG,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqB3C;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,EAAE,CAgBnG;AAqBD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EACzF,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB3D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,EAAE,CAoB3F"}

package/dist/services/form-layout-template-verification.js

@@ -0,0 +1,124 @@
+import { digest } from './form-layout-source/schema.js';
+import { AdvancedTemplateService } from './form-layout-template-advanced.js';
+import { FlowTemplateService } from './form-layout-template-flow.js';
+import { EasyTemplateService, buildEasyPayload } from './form-layout-template-easy.js';
+function cellStyle(cell) {
+    return { backColor: cell?.style?.backColor, borderColor: cell?.style?.borderTop?.color };
+}
+export async function readEasyTemplateEvidence(client, baseUrl, id) {
+    const api = new EasyTemplateService(client, baseUrl);
+    const template = await api.get(id);
+    const payload = buildEasyPayload(template.data, {}, id);
+    const { module: _module, id: _id, ...styleTemplateParam } = payload;
+    const response = await client.post(`${baseUrl}/api/form/local/initLayout`, {
+        module: 'form', initMode: 0, colNum: 2, styleTemplateParam,
+    });
+    if (response?.code !== 200 || response?.status !== true)
+        throw new Error('简易模板预览失败');
+    const sheet = response.data?.pageLayouts?.[0]?.config?.workbook?.Sheet1;
+    const columns = sheet?.columns;
+    const cells = sheet?.cells;
+    if (!Array.isArray(columns) || columns.length < 2 || !Array.isArray(cells))
+        throw new Error('简易模板预览缺少主网格');
+    const title = cells.find((cell) => Number(cell.row) === 0 && Number(cell.col) === 0);
+    const field = cells.find((cell) => Number(cell.row) === 0 && Number(cell.col) === 1);
+    if (!title || !field)
+        throw new Error('简易模板预览缺少标题和字段单元格');
+    const evidence = { kind: 'easy', id,
+        columns: columns.map((col) => ({ type: String(col.type), size: Number(col.size) })),
+        rowHeight: Number(template.data.rowHeight), titleStyle: cellStyle(title), fieldStyle: cellStyle(field) };
+    return { ...evidence, fingerprint: digest({ config: template.data, ...evidence }) };
+}
+export function verifyAppliedEasyTemplate(evidence, formLayout) {
+    const sheet = formLayout?.pageLayouts?.[0]?.config?.workbook?.Sheet1;
+    if (!sheet)
+        return ['简易模板主网格未回读'];
+    const issues = [];
+    const columns = Array.isArray(sheet.columns) ? sheet.columns.map((col) => ({
+        type: String(col.type), size: Number(col.size),
+    })) : [];
+    if (digest(columns) !== digest(evidence.columns))
+        issues.push('简易模板列宽未与应用后布局一致');
+    if (!Array.isArray(sheet.rows) || !sheet.rows.some((row) => Number(row.size) === evidence.rowHeight))
+        issues.push('简易模板行高未与应用后布局一致');
+    const actual = Array.isArray(sheet.cells) ? sheet.cells : [];
+    const hasStyle = (style) => actual.some((cell) => matchesSpecified(style, cellStyle(cell)));
+    if (!hasStyle(evidence.titleStyle))
+        issues.push('简易模板标题颜色或边框未与应用后布局一致');
+    if (!hasStyle(evidence.fieldStyle))
+        issues.push('简易模板字段颜色或边框未与应用后布局一致');
+    return issues;
+}
+function object(value, label) {
+    let parsed = value;
+    if (typeof parsed === 'string') {
+        try {
+            parsed = JSON.parse(parsed);
+        }
+        catch {
+            throw new Error(`${label} 不是有效 JSON`);
+        }
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        throw new Error(`${label} 格式无效`);
+    return parsed;
+}
+function matchesSpecified(expected, actual) {
+    if (expected === undefined || actual === undefined)
+        return expected === actual;
+    if (expected && typeof expected === 'object' && !Array.isArray(expected)) {
+        if (!actual || typeof actual !== 'object' || Array.isArray(actual))
+            return false;
+        return Object.entries(expected).every(([key, value]) => matchesSpecified(value, actual[key]));
+    }
+    return digest(expected) === digest(actual);
+}
+export async function readTemplateEvidence(client, baseUrl, layoutType, id) {
+    if (layoutType === 'FLOW') {
+        const row = (await new FlowTemplateService(client, baseUrl).list()).find(item => String(item.id) === id);
+        if (!row || Number(row.templateStatus) !== 1)
+            throw new Error(`流式模板 ${id} 不存在或未启用`);
+        const raw = object(row.styleJson, '流式模板样式');
+        const style = { formHeader: object(raw.formHeader, 'formHeader'),
+            styleConfig: object(raw.styleConfig, 'styleConfig') };
+        return { kind: 'flow', id, fingerprint: digest(style), style };
+    }
+    if (layoutType === 'EXCEL') {
+        const template = await new AdvancedTemplateService(client, baseUrl).get(id);
+        const style = object(template.layoutInfo?.formStyle?.styleConfig || '{}', '高级模板布局样式');
+        const columns = template.layoutInfo?.pageLayouts?.[0]?.config?.workbook?.Sheet1?.columns;
+        if (!Array.isArray(columns) || !columns.length)
+            throw new Error('高级模板主网格列宽缺失');
+        const normalized = columns.map((col) => ({ type: String(col.type), size: Number(col.size) }));
+        if (normalized.some(col => !Number.isFinite(col.size)))
+            throw new Error('高级模板列宽无效');
+        return { kind: 'advanced', id, fingerprint: digest({ style, columns: normalized }), style, columns: normalized };
+    }
+    throw new Error(`不支持的布局类型 ${layoutType}`);
+}
+export function verifyAppliedTemplate(evidence, formLayout) {
+    const issues = [];
+    const actualStyle = formLayout?.formStyle || {};
+    for (const [section, expected] of Object.entries(evidence.style)) {
+        try {
+            const actual = evidence.kind === 'flow'
+                ? object(actualStyle[section], `已应用布局 ${section}`)
+                : object(actualStyle.styleConfig, '已应用布局 styleConfig')[section];
+            if (actual === undefined || !matchesSpecified(expected, actual))
+                issues.push(`模板样式 ${section} 未与应用后布局一致`);
+        }
+        catch {
+            issues.push(`模板样式 ${section} 无法从应用后布局回读`);
+        }
+    }
+    if (evidence.columns) {
+        const actualColumns = formLayout?.pageLayouts?.[0]?.config?.workbook?.Sheet1?.columns;
+        const normalized = Array.isArray(actualColumns) ? actualColumns.map((col) => ({
+            type: String(col.type), size: Number(col.size),
+        })) : [];
+        if (digest(normalized) !== digest(evidence.columns))
+            issues.push('模板主网格列宽未与应用后布局一致');
+    }
+    return issues;
+}
+//# sourceMappingURL=form-layout-template-verification.js.map

package/dist/services/form-layout-template-verification.js.map

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

package/dist/services/form-list-search-custom.d.ts

@@ -0,0 +1,25 @@
+export interface CustomSearchOption {
+    name: string;
+    id?: string;
+    default?: boolean;
+    /** 完整条件树，或已保存条目的原始 conditionData。 */
+    conditionData?: Record<string, unknown> | string;
+    /** 与 form list-filter 相同的条件数组。 */
+    conditions?: Array<Record<string, unknown>>;
+    relation?: 'and' | 'or';
+    /** 系统选项的真实 sysOptionKey，例如 myFollow。 */
+    systemOption?: string;
+}
+export interface CustomSearchConfig {
+    name: string;
+    id?: string;
+    required?: boolean;
+    selection?: 'single' | 'multiple';
+    position?: '0' | '1';
+    showArchiveOption?: boolean;
+    options: CustomSearchOption[];
+}
+export declare function readCustomSearchConfig(input: string): CustomSearchConfig;
+export declare function customSearchIdsNeeded(config: CustomSearchConfig, existing?: any): number;
+export declare function buildCustomSearchEntry(config: CustomSearchConfig, kind: 'common' | 'group', ids: string[], existing?: any): any;
+//# sourceMappingURL=form-list-search-custom.d.ts.map

package/dist/services/form-list-search-custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-list-search-custom.d.ts","sourceRoot":"","sources":["../../src/services/form-list-search-custom.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACjD,kCAAkC;IAClC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAClC,QAAQ,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAoBxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,MAAM,CAIxF;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,QAAQ,GAAG,OAAO,EACxB,GAAG,EAAE,MAAM,EAAE,EACb,QAAQ,CAAC,EAAE,GAAG,GACb,GAAG,CAyDL"}

package/dist/services/form-list-search-custom.js

@@ -0,0 +1,98 @@
+import { readFileSync } from 'node:fs';
+export function readCustomSearchConfig(input) {
+    const raw = input.startsWith('@') ? readFileSync(input.slice(1), 'utf8') : input;
+    const config = JSON.parse(raw);
+    if (!config || typeof config !== 'object' || !String(config.name || '').trim())
+        throw new Error('自定义分类需要 name');
+    if (!Array.isArray(config.options) || !config.options.length)
+        throw new Error('自定义分类至少需要一项 options');
+    if (config.selection && !['single', 'multiple'].includes(config.selection))
+        throw new Error('selection 只能是 single 或 multiple');
+    if (config.position && !['0', '1'].includes(config.position))
+        throw new Error('position 只能是 0 或 1');
+    const names = new Set();
+    for (const option of config.options) {
+        if (!String(option.name || '').trim())
+            throw new Error('自定义选项缺少 name');
+        if (names.has(option.name))
+            throw new Error(`自定义选项名称重复：${option.name}`);
+        names.add(option.name);
+        if (option.systemOption && (option.conditionData || option.conditions))
+            throw new Error(`选项「${option.name}」不能同时设置 systemOption 和条件`);
+        if (option.conditionData && option.conditions)
+            throw new Error(`选项「${option.name}」不能同时设置 conditionData 和 conditions`);
+        if (option.systemOption && option.systemOption !== 'myFollow')
+            throw new Error(`未验证的系统选项：${option.systemOption}；当前只支持 myFollow`);
+    }
+    if (config.selection === 'single' && config.options.filter((option) => option.default).length > 1) {
+        throw new Error('单选分类最多只能有一个默认选项');
+    }
+    return config;
+}
+export function customSearchIdsNeeded(config, existing) {
+    const oldSets = existing?.listFilterDefaultSets?.listGroupSets || [];
+    return (config.id || existing?.id ? 0 : 1)
+        + config.options.filter((option) => !option.id && !oldSets.some((item) => item.setName === option.name && item.id)).length;
+}
+export function buildCustomSearchEntry(config, kind, ids, existing) {
+    const supply = [...ids];
+    const id = String(config.id || existing?.id || supply.shift() || '');
+    if (!/^\d+$/.test(id))
+        throw new Error('自定义分类需要平台生成的数字 ID');
+    const fieldId = `GroupCustom_${id}`;
+    const oldSets = existing?.listFilterDefaultSets?.listGroupSets || [];
+    const sets = config.options.map((option, index) => {
+        const prior = oldSets.find((item) => String(item.setName) === option.name);
+        const optionId = String(option.id || prior?.id || supply.shift() || '');
+        if (!/^\d+$/.test(optionId))
+            throw new Error(`选项「${option.name}」需要平台生成的数字 ID`);
+        const conditionData = option.systemOption
+            ? JSON.stringify({ type: 'pluginAdvice', customParams: { sysOptionKey: option.systemOption } })
+            : option.conditionData === undefined ? prior?.conditionData
+                : typeof option.conditionData === 'string' ? option.conditionData : JSON.stringify(option.conditionData);
+        if (kind === 'common' && !conditionData)
+            throw new Error(`常用搜索选项「${option.name}」缺少 conditionData 或 systemOption`);
+        return {
+            id: optionId,
+            showOrder: index,
+            setName: option.name,
+            ...(kind === 'common' ? { isChecked: option.default === undefined ? prior?.isChecked === true : option.default === true } : {}),
+            ...(conditionData ? { conditionData } : {}),
+            ...(option.systemOption ? { opType: 'SYSTEM' } : {}),
+        };
+    });
+    const archive = config.showArchiveOption === undefined
+        ? existing?.listFilterDefaultSets?.showArchiveOption ?? '1'
+        : config.showArchiveOption ? '1' : '0';
+    const multiSelect = config.selection === undefined
+        ? existing?.listFilterDefaultSets?.multiSelect ?? false
+        : config.selection === 'multiple';
+    if (kind === 'common') {
+        return {
+            ...(existing || {}), id, fieldId, fieldName: fieldId, componentKey: 'GroupCustom',
+            conditionType: [], config: {}, fieldShowName: config.name,
+            isQuick: config.position ?? existing?.isQuick ?? '0', showName: config.name, options: [],
+            listFilterDefaultSets: {
+                ...(existing?.listFilterDefaultSets || {}), listGroupSets: sets, listFilterSets: [],
+                multiSelect, startValue: '', startValueSpan: '', startDefaultLabel: '', endValue: '',
+                showArchiveOption: archive, searchContentFullMatches: false,
+            },
+            filterId: existing?.filterId || id, required: config.required === undefined ? existing?.required ?? 0 : config.required ? 1 : 0,
+        };
+    }
+    return {
+        ...(existing || {}), id, fieldId, name: fieldId, fieldName: fieldId,
+        componentKey: 'GroupCustom', showName: config.name, config: {},
+        showPosition: config.position ?? existing?.showPosition ?? '0', tabStyle: 'select',
+        listFilterDefaultSets: {
+            ...(existing?.listFilterDefaultSets || {}), listGroupSets: sets,
+            multiSelect: config.selection === undefined ? existing?.listFilterDefaultSets?.multiSelect ?? true : multiSelect,
+            enableFilter: existing?.listFilterDefaultSets?.enableFilter ?? 0,
+            enableShowCountNum: existing?.listFilterDefaultSets?.enableShowCountNum ?? 0,
+            showCountNumType: existing?.listFilterDefaultSets?.showCountNumType ?? 'notUpdate',
+            enableShowCountNumLimit: existing?.listFilterDefaultSets?.enableShowCountNumLimit ?? 0,
+            showArchiveOption: archive,
+        },
+    };
+}
+//# sourceMappingURL=form-list-search-custom.js.map

package/dist/services/form-list-search-custom.js.map

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

package/dist/services/form-list-search-group.d.ts

@@ -22,7 +22,7 @@ export declare const OPTION_COMPS: readonly ["Select", "RadioBox", "CheckBox"];
 export declare const BROWSER_COMPS: readonly ["Ebuilder", "EBuilder", "Browser", "Employee", "Department"];
 /** 日期类：分类项 = 时间粒度。 */
 export declare const DATE_COMPS: readonly ["DateComponent", "Date", "DateTime"];
-export type GroupFilterKind = 'option' | 'browser' | 'date' | 'system';
+export type GroupFilterKind = 'option' | 'browser' | 'date' | 'system' | 'custom';
 export declare const KIND_LABEL: Record<GroupFilterKind, string>;
 /** 日期可选的四种粒度，顺序即页面上的顺序。 */
 export declare const DATE_GRANULARITIES: readonly [{
@@ -42,7 +42,16 @@ export declare const DATE_GRANULARITIES: readonly [{
 export declare function isSystemColumn(col: any): boolean;
 /** 按 `compType` 判四档之一；认不出就报错（宁可早报，也不发一个错的 `dataType` 出去）。 */
 export declare function resolveGroupFilterKind(col: any): GroupFilterKind;
+/**
+ * `--position` → 条目 `showPosition`。
+ *
+ * 平台枚举（FieldSearch 前端）：`Top="0"`、`Left="1"` / `DropDown="1"`。
+ * 分类搜索新建条目默认就是 **0（顶部）**；1 表示左侧/下拉样式。
+ * 名称与数字都收，免得用户还要记码值。
+ */
 export declare function parseShowPosition(input: string | undefined): string;
+/** `--display` → 条目 `tabStyle`：平台枚举 `Tab="tab"`（平铺）/ `Select="select"`（下拉，缺省）。 */
+export declare function parseTabStyle(input: string | undefined): string | undefined;
 /** `--option-order default|field` → `optionOrderConfig` 的 `"0"` / `"1"`。 */
 export declare function parseOptionOrder(input: string | undefined): string;
 /** `--date-granularity year,month` → 校验并归一成粒度值数组（保序、去重）。 */
@@ -68,9 +77,15 @@ export interface FilterDefaultOptions {
      * **两份同一规则：勾上才发（=1），不勾整个键都不出现。**
      */
     onlyWithData?: boolean;
+    /**
+     * 「显示封存的选项」(`showArchiveOption`)：前端开关写 `"1"` / `"0"`。
+     * 缺省（undefined）= 与平台新建一致，发 `"1"`。
+     */
+    showArchive?: boolean;
     granularity?: string[];
     optionShow?: string[];
     optionDefault?: string[];
+    showArchiveOption?: boolean;
 }
 /**
  * 四档各自的 `listFilterDefaultSets`。
@@ -85,8 +100,10 @@ export interface FilterDefaultOptions {
  */
 export declare function buildFilterDefaultSets(col: any, kind: GroupFilterKind, opts?: FilterDefaultOptions): any;
 export interface BuildGroupFilterOptions extends FilterDefaultOptions {
-    /** `showPosition`：1 顶部（缺省）/ 0 下拉样式。 */
+    /** `showPosition`：0 顶部（缺省）/ 1 左侧 / 下拉样式（平台枚举 Top="0"、Left/DropDown="1"）。 */
     position?: string;
+    /** 分类搜索「显示方式」`tabStyle`：`tab`=平铺 / `select`=下拉（缺省）。 */
+    tabStyle?: string;
 }
 /**
  * 一条分类搜索条目。
@@ -95,6 +112,23 @@ export interface BuildGroupFilterOptions extends FilterDefaultOptions {
  * 加上按类型算出来的 `listFilterDefaultSets`。
  */
 export declare function buildGroupFilterEntry(col: any, opts?: BuildGroupFilterOptions): any;
+/** 自定义分类（GroupCustom）的组件键。它不是表单字段，条目只存一个引用。 */
+export declare const CUSTOM_GROUP_COMP = "GroupCustom";
+/**
+ * 自定义分类 id：平台前端用 `UUID(18,10)` 生成 18 位数字 id，**没有接口返回**
+ * （2026-10-23 读 FieldSearch 前端包确认）。这里按同样形状生成，并避开已有条目。
+ */
+export declare function genCustomGroupId(existing?: any[]): string;
+/**
+ * 一条「自定义分类」（GroupCustom）。
+ *
+ * 平台「添加分类」先建 `{fieldId:"-1", componentKey:"GroupCustom"}`，保存时由前端补 18 位 id，
+ * `fieldId = "GroupCustom_<id>"`；分类值 `listGroupSets` 初始为空，之后在设计器里配置。
+ * 这里按实测条目形状构造（含「显示方式」`tabStyle` 与「显示封存的选项」`showArchiveOption`）。
+ */
+export declare function buildCustomGroupFilterEntry(showName: string, opts?: BuildGroupFilterOptions & {
+    id?: string;
+}): any;
 /** 候选字段：`getNListConfig` 回包里的 `fieldUsage[0].fields[]`（含系统字段）。 */
 export declare function extractCandidateColumns(listConfig: any): any[];
 /** 按 fieldId 或字段名（`text`）找候选字段；重名报错，不猜。 */

package/dist/services/form-list-search-group.d.ts.map

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

package/dist/services/form-list-search-group.js

@@ -1,3 +1,4 @@
+import { randomInt } from 'node:crypto';
 /**
  * 台账「分类搜索」(`config.searchConditions.groupFilters`) 的取值与构造。
  *
@@ -27,6 +28,7 @@ export const KIND_LABEL = {
     browser: '浏览框',
     date: '日期',
     system: '系统字段',
+    custom: '自定义分类',
 };
 /** 日期可选的四种粒度，顺序即页面上的顺序。 */
 export const DATE_GRANULARITIES = [
@@ -48,6 +50,8 @@ export function resolveGroupFilterKind(col) {
     if (isSystemColumn(col))
         return 'system';
     const comp = String(col?.compType || col?.type || '');
+    if (comp === 'GroupCustom')
+        return 'custom';
     if (OPTION_COMPS.includes(comp))
         return 'option';
     if (DATE_COMPS.includes(comp))
@@ -57,11 +61,33 @@ export function resolveGroupFilterKind(col) {
     throw new Error(`字段「${col?.text ?? col?.id}」的类型 ${comp || '(未知)'} 不支持分类搜索。`
         + `目前支持：选项类 ${OPTION_COMPS.join('/')}、浏览框类 ${BROWSER_COMPS.join('/')}、日期类 ${DATE_COMPS.join('/')}，以及系统字段`);
 }
+/**
+ * `--position` → 条目 `showPosition`。
+ *
+ * 平台枚举（FieldSearch 前端）：`Top="0"`、`Left="1"` / `DropDown="1"`。
+ * 分类搜索新建条目默认就是 **0（顶部）**；1 表示左侧/下拉样式。
+ * 名称与数字都收，免得用户还要记码值。
+ */
 export function parseShowPosition(input) {
-    const v = String(input ?? '1').trim();
-    if (v !== '0' && v !== '1')
-        throw new Error(`--position 只认 0（下拉样式）或 1（顶部），收到「${input}」`);
-    return v;
+    const v = String(input ?? '0').trim();
+    const key = v.toLowerCase();
+    if (v === '0' || key === 'top' || v === '顶部')
+        return '0';
+    if (v === '1' || key === 'left' || key === 'dropdown' || v === '左侧' || v === '下拉' || v === '下拉样式')
+        return '1';
+    throw new Error(`--position 只认 0（顶部）或 1（左侧 / 下拉样式），收到「${input}」`);
+}
+/** `--display` → 条目 `tabStyle`：平台枚举 `Tab="tab"`（平铺）/ `Select="select"`（下拉，缺省）。 */
+export function parseTabStyle(input) {
+    const v = String(input ?? '').trim();
+    if (!v)
+        return undefined;
+    const key = v.toLowerCase();
+    if (key === 'tab' || v === '平铺')
+        return 'tab';
+    if (key === 'select' || v === '下拉' || v === '下拉样式')
+        return 'select';
+    throw new Error(`--display 只认「平铺」或「下拉」，收到「${input}」`);
 }
 /** `--option-order default|field` → `optionOrderConfig` 的 `"0"` / `"1"`。 */
 export function parseOptionOrder(input) {
@@ -166,6 +192,9 @@ export function buildDateGroupSets(granularity, checked) {
  * 不勾时无论选项还是浏览框都整个键都没有。
  */
 export function buildFilterDefaultSets(col, kind, opts = {}) {
+    if (kind === 'custom')
+        throw new Error('自定义分类请使用 --custom 配置');
+    const archive = (opts.showArchiveOption ?? opts.showArchive) === false ? '0' : '1';
     const showCount = opts.showCount !== false ? 1 : 0;
     const onlyWithData = opts.onlyWithData === true ? 1 : 0;
     const count = {
@@ -175,7 +204,7 @@ export function buildFilterDefaultSets(col, kind, opts = {}) {
     };
     if (kind === 'system') {
         // 系统字段那份最薄：只有四个键
-        return { listGroupSets: [], multiSelect: true, enableBrowserFilter: 0, showArchiveOption: '1' };
+        return { listGroupSets: [], multiSelect: true, enableBrowserFilter: 0, showArchiveOption: archive };
     }
     if (kind === 'option') {
         const sets = buildOptionGroupSets(col?.config?.options, opts.optionShow, opts.optionDefault);
@@ -187,7 +216,7 @@ export function buildFilterDefaultSets(col, kind, opts = {}) {
             ...(onlyWithData ? { enableFilter: 1 } : {}),
             ...count,
             enableBrowserFilter: 0,
-            showArchiveOption: '1',
+            showArchiveOption: archive,
         };
     }
     if (kind === 'date') {
@@ -205,7 +234,7 @@ export function buildFilterDefaultSets(col, kind, opts = {}) {
             enableBrowserFilter: 0,
             defaultValueType: '1',
             ...(defaultValue ? { defaultValue } : {}),
-            showArchiveOption: '1',
+            showArchiveOption: archive,
         };
     }
     // browser
@@ -218,7 +247,7 @@ export function buildFilterDefaultSets(col, kind, opts = {}) {
         ...count,
         optionOrderConfig: opts.optionOrder ?? '0',
         enableBrowserFilter: 0,
-        showArchiveOption: '1',
+        showArchiveOption: archive,
     };
 }
 /**
@@ -242,14 +271,64 @@ export function buildGroupFilterEntry(col, opts = {}) {
         text: col?.text,
         config: col?.config ?? {},
         expandMethod: '0',
-        showPosition: opts.position ?? '1',
-        tabStyle: 'select',
+        showPosition: opts.position ?? '0',
+        tabStyle: opts.tabStyle ?? 'select',
         objId: col?.objId,
         fieldType: col?.type,
         type: col?.type,
         listFilterDefaultSets: buildFilterDefaultSets(col, kind, opts),
     };
 }
+/** 自定义分类（GroupCustom）的组件键。它不是表单字段，条目只存一个引用。 */
+export const CUSTOM_GROUP_COMP = 'GroupCustom';
+/**
+ * 自定义分类 id：平台前端用 `UUID(18,10)` 生成 18 位数字 id，**没有接口返回**
+ * （2026-10-23 读 FieldSearch 前端包确认）。这里按同样形状生成，并避开已有条目。
+ */
+export function genCustomGroupId(existing = []) {
+    const taken = new Set(existing.flatMap((g) => [String(g?.id ?? ''), String(g?.fieldId ?? '')]));
+    for (let attempt = 0; attempt < 100; attempt++) {
+        let id = String(randomInt(1, 10));
+        for (let i = 0; i < 17; i++)
+            id += String(randomInt(0, 10));
+        if (!taken.has(id) && !taken.has(`${CUSTOM_GROUP_COMP}_${id}`))
+            return id;
+    }
+    throw new Error('生成自定义分类 id 失败：连续 100 次都与已有条目冲突');
+}
+/**
+ * 一条「自定义分类」（GroupCustom）。
+ *
+ * 平台「添加分类」先建 `{fieldId:"-1", componentKey:"GroupCustom"}`，保存时由前端补 18 位 id，
+ * `fieldId = "GroupCustom_<id>"`；分类值 `listGroupSets` 初始为空，之后在设计器里配置。
+ * 这里按实测条目形状构造（含「显示方式」`tabStyle` 与「显示封存的选项」`showArchiveOption`）。
+ */
+export function buildCustomGroupFilterEntry(showName, opts = {}) {
+    const name = String(showName ?? '').trim();
+    if (!name)
+        throw new Error('自定义分类名称不能为空');
+    const id = String(opts.id || genCustomGroupId());
+    const fieldId = `${CUSTOM_GROUP_COMP}_${id}`;
+    return {
+        id,
+        fieldId,
+        name: fieldId,
+        fieldName: fieldId,
+        componentKey: CUSTOM_GROUP_COMP,
+        showName: name,
+        showPosition: opts.position ?? '0',
+        tabStyle: opts.tabStyle ?? 'select',
+        listFilterDefaultSets: {
+            listGroupSets: [],
+            multiSelect: false,
+            tileOptionNoGroupConfig: { isShow: true },
+            enableShowCountNum: opts.showCount === false ? 0 : 1,
+            showCountNumType: opts.countUpdate === true ? 'withConditionUpdate' : 'notUpdate',
+            enableShowCountNumLimit: 0,
+            showArchiveOption: opts.showArchive === false ? '0' : '1',
+        },
+    };
+}
 /** 候选字段：`getNListConfig` 回包里的 `fieldUsage[0].fields[]`（含系统字段）。 */
 export function extractCandidateColumns(listConfig) {
     const arr = listConfig?.fieldUsage?.[0]?.fields;