weaver-e10-builder 1.0.2-beta

package/dist/services/form-table-view.js

@@ -0,0 +1,882 @@
+import { createHash, randomInt } from 'node:crypto';
+export const FORM_TABLE_VIEW_STYLES = {
+    table: '1',
+    list: '2',
+    'left-diagram': '3',
+    'horizontal-list': '4',
+    above: '5',
+    grid: '7',
+    editable: '11',
+};
+export const FORM_TABLE_VIEW_SEARCH_STYLES = {
+    advanced: '0',
+    filter: '1',
+};
+const LIST_FORM_PATH = '/api/bs/ebuilder/form/obj/getList';
+const QUERY_LIST_PATH = '/api/bs/ebuilder/form/list/getNList';
+const CREATE_VIEW_PATH = '/api/bs/ebuilder/form/viewlist/createView';
+const READ_CONFIG_PATH = '/api/bs/ebuilder/form/list/getNListConfig';
+const SAVE_CONFIG_PATH = '/api/bs/ebuilder/form/list/saveNListConfig';
+const QUERY_FIELD_PATH = '/api/ebuilder/form/form/field/manage/getFormFieldPage';
+const QUERY_DATA_SOURCE_FIELD_PATH = '/api/ebuilder/common/ds/fields';
+const GET_VIEWLIST_PATH = '/api/bs/ebuilder/form/viewlist/getViewlist';
+const GET_LIST_FIELDS_PATH = '/api/bs/ebuilder/form/list/getListFields';
+const SAVE_LIST_FIELDS_PATH = '/api/bs/ebuilder/form/list/saveListFields';
+function encode(value) {
+    return encodeURIComponent(value);
+}
+function requireSuccess(response, operation) {
+    if (response?.code !== 200 || response?.status === false || response?.success === false || response?.fail === true) {
+        throw new Error(response?.msg || `${operation} 未确认成功`);
+    }
+    return response;
+}
+function rowId(row) {
+    const id = row?.id ?? row?.viewId;
+    return id === undefined || id === null ? '' : String(id);
+}
+function responseId(response) {
+    const data = response?.data;
+    const id = data?.id ?? data?.viewId ?? (typeof data === 'string' || typeof data === 'number' ? data : '');
+    return id === undefined || id === null ? '' : String(id);
+}
+function stableUid(name) {
+    const namespace = Buffer.from('6ba7b8119dad11d180b400c04fd430c8', 'hex');
+    const hash = createHash('sha1').update(namespace).update(name).digest();
+    hash[6] = (hash[6] & 15) | 80;
+    hash[8] = (hash[8] & 63) | 128;
+    return `g${hash.subarray(0, 16).toString('hex').slice(0, 30)}`;
+}
+function dataSourceRequest(objId) {
+    const form = new FormData();
+    for (const [key, value] of Object.entries({
+        groupId: 'weaver-ebuilder-form-service',
+        sourceId: objId,
+        sourceType: 'LOGIC',
+        detailFieldsGroup: 'true',
+        enableMerge: 'true',
+        needTableName: 'true',
+        params: '[]',
+    })) {
+        form.append(key, value);
+    }
+    return form;
+}
+async function queryMainDataSourceFields(client, baseUrl, appId, objId) {
+    const response = requireSuccess(await client.postMultipart(`${baseUrl}${QUERY_DATA_SOURCE_FIELD_PATH}`, dataSourceRequest(objId), { ebbusinessid: appId }), 'data source fields');
+    return (Array.isArray(response.data) ? response.data : [])
+        .flatMap((group) => (Array.isArray(group?.fields) ? group.fields : []))
+        .filter((field) => !field?.isDetailtable);
+}
+function cloneSearchConditions(config) {
+    const current = config.searchConditions;
+    const searchConditions = current && typeof current === 'object' && !Array.isArray(current)
+        ? structuredClone(current)
+        : {};
+    searchConditions.commonFilters = Array.isArray(searchConditions.commonFilters)
+        ? searchConditions.commonFilters
+        : [];
+    return searchConditions;
+}
+function completeSearchConditions(searchConditions) {
+    const defaults = {
+        quickFilters: [],
+        groupFilters: [],
+        commonSearchType: '0',
+        commonFilterGroups: [],
+        needCondition: '1',
+        noneOfShow: '0',
+        searchRelationEnable: '1',
+        manualFilter: '1',
+        fixedCol: '0',
+        fixedColCount: 3,
+        needOtherCustom: '1',
+        hiddenFieldsForOther: [],
+        filterContraction: '1',
+        showSearchLabel: '1',
+        quickPlaceHolder: { nameAlias: '' },
+    };
+    for (const [key, value] of Object.entries(defaults)) {
+        if (searchConditions[key] === undefined)
+            searchConditions[key] = structuredClone(value);
+    }
+    return searchConditions;
+}
+function searchFieldId(field) {
+    const id = field?.fieldId ?? field?.id;
+    return id === undefined || id === null ? '' : String(id);
+}
+function decimalFilterId() {
+    return `${randomInt(1, 10)}${Array.from({ length: 17 }, () => randomInt(0, 10)).join('')}`;
+}
+function searchFieldOptions(fieldModel) {
+    const options = Array.isArray(fieldModel.options)
+        ? fieldModel.options
+        : Array.isArray(fieldModel.config?.options)
+            ? fieldModel.config.options
+            : [];
+    return options.map((option) => {
+        const value = option.value ?? option.valueKey ?? option.id ?? '';
+        return {
+            ...structuredClone(option),
+            value: String(value),
+            valueKey: String(option.valueKey ?? value),
+        };
+    });
+}
+function createCommonSearchField(fieldModel, condition, searchConditions) {
+    const fieldId = searchFieldId(fieldModel);
+    const name = String(fieldModel.name ?? fieldModel.fieldName ?? '');
+    const text = String(fieldModel.text ?? fieldModel.showName ?? fieldModel.fieldShowName ?? name);
+    const componentKey = String(fieldModel.componentKey ?? fieldModel.compType ?? '');
+    const fieldType = String(fieldModel.fieldType ?? fieldModel.type ?? '');
+    const options = searchFieldOptions(fieldModel);
+    // Match the object produced by the current NList formatFilterData pipeline.
+    // `id` identifies the field; `filterId` identifies this search-condition instance.
+    return {
+        id: fieldId,
+        fieldId,
+        name,
+        fieldName: name,
+        componentKey,
+        conditionType: structuredClone(fieldModel.conditionType ?? []),
+        conditionTypeValue: condition,
+        config: structuredClone(fieldModel.config ?? {}),
+        fieldShowName: text,
+        fieldType,
+        isQuick: '0',
+        objId: String(fieldModel.objId ?? ''),
+        showName: text,
+        text,
+        type: String(fieldModel.type ?? fieldType),
+        options,
+        opened: fieldModel.opened,
+        ebBackField: fieldModel.ebBackField ?? fieldModel.config?.ebBackField,
+        sModule: fieldModel.module,
+        configNameJson: fieldModel.configNameJson ?? '',
+        browserType: fieldModel.browserType ?? '',
+        browserParams: structuredClone(fieldModel.browserParams),
+        filterId: decimalFilterId(),
+        required: 0,
+        multiSelect: fieldModel.multiSelect,
+        shortKey: fieldModel.shortKey,
+        limitInfo: {
+            needWordSearch: true,
+            maxLength: searchConditions.filterInfo?.searchValueContentLengthLimit ?? 10000,
+            maxWordLength: searchConditions.filterInfo?.searchValueElementLengthLimit ?? 50,
+            maxEqWordLength: searchConditions.filterInfo?.searchValueElementLengthLimitWithEq ?? 500,
+        },
+        listFilterDefaultSets: {
+            optionEnable: '0',
+            listGroupSets: structuredClone(options),
+            listFilterSets: [],
+            multiSelect: true,
+            defaultType: '0',
+            startValue: '',
+            startValueSpan: '',
+            startDefaultLabel: '',
+            endValue: '',
+            dateMenuGroup: [],
+            enableTime: '0',
+            conditionTypeValue: condition,
+            enableBrowserFilter: 0,
+            showArchiveOption: '1',
+            searchContentFullMatches: false,
+        },
+    };
+}
+function availableSearchConditions(field) {
+    return (Array.isArray(field.conditionType) ? field.conditionType : [])
+        .filter((condition) => condition?.disabled !== true && condition?.id)
+        .map((condition) => String(condition.id));
+}
+async function queryTableViews(client, baseUrl, appId, objId) {
+    const response = requireSuccess(await client.post(`${baseUrl}${QUERY_LIST_PATH}?apid=${encode(appId)}&appId=${encode(appId)}&tpaid=${encode(objId)}&objId=${encode(objId)}`, { objId }, { ebbusinessid: appId }), 'table view list');
+    return Array.isArray(response.data) ? response.data : [];
+}
+export async function readTableViewConfig(client, baseUrl, appId, listId, terminal) {
+    const response = requireSuccess(await client.get(`${baseUrl}${READ_CONFIG_PATH}/${encode(listId)}?apid=${encode(appId)}&tpaid=${encode(listId)}&terminalType=${terminal}`, { ebbusinessid: appId }), `table view config ${terminal}`);
+    if (!response.data || typeof response.data !== 'object') {
+        throw new Error(`table view config ${terminal} 未返回配置对象`);
+    }
+    return structuredClone(response.data);
+}
+async function resolveFormId(client, baseUrl, appId, objId) {
+    const response = requireSuccess(await client.get(`${baseUrl}${LIST_FORM_PATH}/${encode(appId)}?apid=${encode(appId)}`, { ebbusinessid: appId }), 'form list');
+    const form = (Array.isArray(response.data) ? response.data : [])
+        .find((item) => String(item.id) === objId);
+    const formId = form?.formId === undefined || form?.formId === null ? '' : String(form.formId);
+    if (!formId)
+        throw new Error(`未找到表单 objId=${objId} 对应的 formId`);
+    return formId;
+}
+/**
+ * Populate `tableField` (display columns) of an EXISTING nListView by reading
+ * the form's data-source fields, appending the hidden primary key (id=5),
+ * saving via saveNListConfig, and verifying by re-reading. Shared by
+ * `createAndConfigureFormTableView` (brand-new view) and
+ * `ensureDefaultListDisplayFields` (auto-generated default view that the
+ * platform left empty on some on-prem environments).
+ */
+async function populateListDisplayFields(client, baseUrl, appId, objId, listId, options) {
+    const pcConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const configObjId = pcConfig.objId === undefined || pcConfig.objId === null ? objId : String(pcConfig.objId);
+    if (configObjId !== objId)
+        throw new Error(`列表配置 objId=${configObjId} 与目标表单不一致`);
+    const formId = await resolveFormId(client, baseUrl, appId, objId);
+    const fieldResponse = requireSuccess(await client.post(`${baseUrl}${QUERY_FIELD_PATH}?apid=${encode(appId)}`, {
+        pageNo: 1,
+        pageSize: 100,
+        module: 'ebuilderform',
+        formFieldSearchEntity: { isDelete: 0, status: 'enable', formId },
+    }, { ebbusinessid: formId }), 'field query');
+    const businessFields = fieldResponse.data?.pageDatas?.result ?? [];
+    if (!businessFields.length)
+        throw new Error('目标表单没有可显示的业务字段');
+    const availableIds = businessFields
+        .map((field) => String(field.fieldId ?? field.id ?? ''))
+        .filter(Boolean);
+    // 先取数据源模型：DateRange 父字段只出现在 getFormFieldPage，开始/结束子字段只出现在 ds/fields，
+    // 显式传子字段 ID 时必须在 byId 里也放行，否则前置校验就拦截（R12 场景二）
+    const dataSourceResponse = requireSuccess(await client.postMultipart(`${baseUrl}${QUERY_DATA_SOURCE_FIELD_PATH}`, dataSourceRequest(objId), { ebbusinessid: appId }), 'data source fields');
+    const roots = (Array.isArray(dataSourceResponse.data) ? dataSourceResponse.data : [])
+        .flatMap((group) => (Array.isArray(group?.fields) ? group.fields : []));
+    const mainFields = roots.filter((field) => !field?.isDetailtable);
+    const byId = new Map(mainFields.map((field) => [String(field.id), field]));
+    const selectedIds = (options.fieldIds?.length ? options.fieldIds : availableIds).map(String);
+    if (new Set(selectedIds).size !== selectedIds.length) {
+        throw new Error('指定字段重复');
+    }
+    const unknownIds = selectedIds.filter((id) => !availableIds.includes(id) && !byId.has(id));
+    if (unknownIds.length) {
+        throw new Error(`指定字段不属于目标表单: ${unknownIds.join(', ')}`);
+    }
+    // 数据源模型可能不完整：DateRange 在 getFormFieldPage 里是一个父字段（fieldId），但 ds/fields 把它
+    // 拆成 开始/结束 两个子字段（physicalField=<dataKey>_0 / <dataKey>_1），父 fieldId 不在 ds 模型里。
+    // 因此不再整体抛错「数据源未返回完整模型」（否则整列为空）——父字段映射到两个子列（与平台列表视图
+    // 一致），真正找不到的字段跳过并告警。
+    const tableFields = [];
+    const missingFromDs = [];
+    for (const id of selectedIds) {
+        let field = byId.get(id);
+        if (!field) {
+            const parentField = businessFields.find((b) => String(b.fieldId ?? b.id ?? '') === id);
+            const parentKey = parentField?.dataKey || '';
+            const children = parentKey
+                ? mainFields.filter((mf) => String(mf.physicalField || '').startsWith(`${parentKey}_`))
+                : [];
+            if (children.length > 0) {
+                for (const child of children) {
+                    const cf = structuredClone(child);
+                    cf.uid ??= stableUid(`ebuilder-field:${objId}:${String(cf.id)}`);
+                    cf.mainField ??= true;
+                    cf.mainPrimaryKey = false;
+                    cf.fieldVersion ??= 1;
+                    tableFields.push(cf);
+                }
+                continue;
+            }
+            missingFromDs.push(id);
+            console.error(`  ⚠ 字段 ${id} 数据源未返回，已跳过该列`);
+            continue;
+        }
+        field = structuredClone(field);
+        field.uid ??= stableUid(`ebuilder-field:${objId}:${id}`);
+        field.mainField ??= true;
+        field.mainPrimaryKey = false;
+        field.fieldVersion ??= 1;
+        tableFields.push(field);
+    }
+    if (missingFromDs.length > 0) {
+        console.error(`  ⚠ ${missingFromDs.length} 个字段数据源未返回，视图列已跳过: ${missingFromDs.join(', ')}`);
+    }
+    const hiddenId = structuredClone(byId.get('5'));
+    if (!hiddenId)
+        throw new Error('数据源缺少隐藏主键字段 id=5');
+    Object.assign(hiddenId, {
+        hidden: true,
+        isDetailMainKey: true,
+        mainPrimaryKey: true,
+    });
+    hiddenId.uid ??= stableUid(`ebuilder-field:${objId}:5`);
+    tableFields.push(hiddenId);
+    pcConfig.tableField = tableFields;
+    pcConfig.tableMergeFields = [];
+    pcConfig.personalFields = [];
+    pcConfig.excelDisabledFieldIds ??= [];
+    pcConfig.uaLanguage ??= 'zh_CN';
+    let mobileConfig;
+    try {
+        mobileConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'MOBILE');
+    }
+    catch (error) {
+        if (!options.pcOnly)
+            throw error;
+        mobileConfig = {};
+    }
+    requireSuccess(await client.post(`${baseUrl}${SAVE_CONFIG_PATH}?apid=${encode(appId)}`, {
+        listId,
+        appId,
+        terminalType: 'PC',
+        config: pcConfig,
+        mConfig: mobileConfig,
+    }, { ebbusinessid: appId }), 'table view config save');
+    const verified = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const verifiedFields = Array.isArray(verified.tableField) ? verified.tableField : [];
+    const verifiedIds = verifiedFields.map((field) => String(field.id));
+    // 用实际保存的列 id 校验（DateRange 父字段已映射为 开始/结束 两个子列，selectedIds 里是父 id）
+    const savedIds = tableFields.map((field) => String(field.id));
+    const visibleSavedIds = savedIds.filter((id) => id !== '5');
+    const missing = savedIds.filter((id) => !verifiedIds.includes(id));
+    if (missing.length)
+        throw new Error(`显示列保存后回读缺少字段: ${missing.join(', ')}`);
+    const visibleFieldCount = verifiedFields
+        .filter((field) => visibleSavedIds.includes(String(field.id)) && field.hidden !== true)
+        .length;
+    if (visibleFieldCount !== visibleSavedIds.length)
+        throw new Error('显示列回读数量与目标业务字段不一致');
+    // 同时填默认视图的 listFields（saveListFields 层）。CLI 之前只填 tableField（created view），
+    // 默认视图 listFields 留空 → getListFields.pc=0 是 bug（见 listfields-empty-bug memory）。
+    // 仅当 listFields 为空时填，不覆盖用户已配。
+    await populateDefaultViewListFields(client, baseUrl, appId, objId, listId, formId, tableFields);
+    return {
+        listId,
+        formId,
+        selectedFieldIds: visibleSavedIds,
+        visibleFieldCount,
+        tableFieldCount: verifiedFields.length,
+        persisted: true,
+    };
+}
+/**
+ * 填默认视图的 listFields（saveListFields 层）。仅当 getListFields.pc 为空时填，避免覆盖已配。
+ * list 对象从 getViewlist 取默认视图原对象 + 增强字段；listFields[] 从已显示的业务字段构造
+ * （ds/fields 元数据：id/text/type/compType）。saveListFields body 顶层键 listFields/mobileListFields
+ * （非 pc/mobile），头必须带 ebBusinessId=appId。读回键是 data.pc[]。
+ */
+async function populateDefaultViewListFields(client, baseUrl, appId, objId, listId, formId, tableFields) {
+    // 先读 getListFields，pc 非空则跳过
+    try {
+        const cur = await client.get(`${baseUrl}${GET_LIST_FIELDS_PATH}/${encode(listId)}?apid=${encode(appId)}&tpaid=${encode(listId)}&isVirtualForm=false&clientType=PC`, { ebbusinessid: appId });
+        if (Array.isArray(cur?.data?.pc) && cur.data.pc.length > 0)
+            return false;
+    }
+    catch {
+        // getListFields 读不到（可能环境差异）→ 不强行填，避免误覆盖
+        return false;
+    }
+    // getViewlist 默认视图原对象
+    const gvRes = await client.get(`${baseUrl}${GET_VIEWLIST_PATH}/${encode(objId)}?apid=${encode(appId)}&objId=${encode(objId)}&type=tableView&appId=${encode(appId)}&tpaid=${encode(listId)}&module=tableView`, { ebbusinessid: appId });
+    const detail = gvRes?.data?.tableView?.detail || [];
+    const def = detail.find((d) => String(d.id) === String(listId)) || detail[0];
+    if (!def)
+        return false; // 拿不到默认视图对象，跳过
+    const tenantKey = String(def.tenantKey || '');
+    const creator = String(def.creator || '');
+    const formName = String(def.name || '');
+    const list = { ...def };
+    delete list.conditionData;
+    delete list.conditionId;
+    delete list.conditionText;
+    Object.assign(list, {
+        icon: 'Icon-Business-form-o', type: 'tableView', realViewType: 'List', baseFormId: formId,
+        appId, isVirtualForm: false, isVForm: false, formId, applyAuthParams: {},
+        dataset: { id: objId, text: formName, type: 'FORM', groupId: appId, appId, isPhysical: true },
+    });
+    // listFields[] 从已显示的业务字段构造（排除隐藏主键 id=5 / hidden）
+    const visible = tableFields.filter((f) => String(f.id) !== '5' && !f.hidden);
+    const ts = Date.now();
+    const listFields = visible.map((f, i) => ({
+        id: '', showName: String(f.text || f.name || ''), fieldId: String(f.id),
+        fieldType: String(f.type || ''), componentKey: String(f.compType || ''),
+        listId, objId, width: 150, showOrder: i, tenantKey,
+        hrefLink: '', hrefType: '0', openType: '2', pageWidth: 50, alignment: 'left',
+        formulaType: '', fixed: '0', canNotLink: false, isSubForm: 0, subFieldList: [],
+        conversionSet: '[]', creator, createTime: ts, deleteType: 0, fieldConfig: {},
+        haveActions: false, isEditField: 1, richEditor: false, widthUnit: 'px',
+    }));
+    requireSuccess(await client.post(`${baseUrl}${SAVE_LIST_FIELDS_PATH}?apid=${encode(appId)}&tpaid=${encode(listId)}`, { list, isVirtualForm: false, listFields, mobileListFields: [], mergeColumnInfoList: [], hasMerge: 0, displayColumn: false }, { ebbusinessid: appId }), 'default view listFields save');
+    return true;
+}
+/**
+ * Fallback for on-prem environments where building a form does NOT auto-generate
+ * the default nListView's display columns (tableField stays empty → empty 台账).
+ * Scans all nListViews under the form; the first one whose tableField is empty
+ * gets populated with all business fields (+ hidden primary key). Non-empty
+ * lists are never touched, so user-configured views are safe.
+ */
+export async function ensureDefaultListDisplayFields(client, baseUrl, appId, objId, options = {}) {
+    const lists = await queryTableViews(client, baseUrl, appId, objId);
+    let emptyListId = '';
+    for (const item of lists) {
+        if (String(item.viewType ?? '').toLowerCase() !== 'nlist')
+            continue;
+        const id = rowId(item);
+        if (!id)
+            continue;
+        try {
+            const cfg = await readTableViewConfig(client, baseUrl, appId, id, 'PC');
+            const tf = Array.isArray(cfg.tableField) ? cfg.tableField : [];
+            if (tf.length === 0) {
+                emptyListId = id;
+                break;
+            }
+        }
+        catch {
+            // cannot read this list's config — skip, don't risk overwriting blindly
+        }
+    }
+    if (!emptyListId) {
+        return { listId: '', ensured: false, visibleFieldCount: 0, tableFieldCount: 0, persisted: true };
+    }
+    const result = await populateListDisplayFields(client, baseUrl, appId, objId, emptyListId, options);
+    return {
+        listId: emptyListId,
+        ensured: true,
+        visibleFieldCount: result.visibleFieldCount,
+        tableFieldCount: result.tableFieldCount,
+        persisted: true,
+    };
+}
+export async function createAndConfigureFormTableView(client, baseUrl, appId, objId, options) {
+    const name = options.name.trim();
+    if (!name)
+        throw new Error('表格视图名称不能为空');
+    const before = await queryTableViews(client, baseUrl, appId, objId);
+    const duplicates = before.filter((item) => item.name === name);
+    if (duplicates.length) {
+        throw new Error(`表单下已存在同名表格视图: ${duplicates.map(rowId).filter(Boolean).join(', ') || name}`);
+    }
+    const created = requireSuccess(await client.post(`${baseUrl}${CREATE_VIEW_PATH}?apid=${encode(appId)}&tpaid=${encode(objId)}`, {
+        name,
+        objId,
+        viewType: 'nListView',
+        terminalType: 'PC',
+        layoutType: 'formLayout',
+        formLayoutType: 'FLOW',
+        describe: '',
+    }, { ebbusinessid: appId }), 'table view create');
+    const createdId = responseId(created);
+    if (!createdId)
+        throw new Error('表格视图创建响应缺少 listId，停止后续写入以避免误配');
+    try {
+        const afterCreate = await queryTableViews(client, baseUrl, appId, objId);
+        const createdRow = afterCreate.find((item) => rowId(item) === createdId);
+        if (!createdRow || createdRow.name !== name)
+            throw new Error('创建后列表回读未找到同 ID、同名称的 nListView');
+        const result = await populateListDisplayFields(client, baseUrl, appId, objId, createdId, {
+            fieldIds: options.fieldIds,
+            pcOnly: options.pcOnly,
+        });
+        const afterSave = await queryTableViews(client, baseUrl, appId, objId);
+        if (!afterSave.some((item) => rowId(item) === createdId && item.name === name)) {
+            throw new Error('保存配置后列表回读未找到目标表格视图');
+        }
+        return result;
+    }
+    catch (error) {
+        throw new Error(`表格视图已创建(listId=${createdId})，但配置闭环失败：${error.message}`);
+    }
+}
+export async function setFormTableViewStyle(client, baseUrl, appId, objId, listId, style, options = {}) {
+    const mode = FORM_TABLE_VIEW_STYLES[style];
+    if (!mode) {
+        throw new Error(`不支持的展示样式: ${style}。可选值: ${Object.keys(FORM_TABLE_VIEW_STYLES).join(', ')}`);
+    }
+    const lists = await queryTableViews(client, baseUrl, appId, objId);
+    const target = lists.find((item) => rowId(item) === listId);
+    if (!target)
+        throw new Error(`目标表单下不存在 listId=${listId}`);
+    const pcConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const configObjId = pcConfig.objId === undefined || pcConfig.objId === null ? objId : String(pcConfig.objId);
+    if (configObjId !== objId)
+        throw new Error(`列表配置 objId=${configObjId} 与目标表单不一致`);
+    const previousMode = String(pcConfig.mode ?? '');
+    if (previousMode === mode) {
+        return {
+            listId,
+            style,
+            previousMode,
+            mode,
+            mobilePreserved: true,
+            alreadyConfigured: true,
+            persisted: true,
+        };
+    }
+    let mobileConfig;
+    let mobilePreserved = true;
+    try {
+        mobileConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'MOBILE');
+    }
+    catch (error) {
+        if (!options.pcOnly)
+            throw error;
+        mobileConfig = {};
+        mobilePreserved = false;
+    }
+    pcConfig.mode = mode;
+    requireSuccess(await client.post(`${baseUrl}${SAVE_CONFIG_PATH}?apid=${encode(appId)}`, {
+        listId,
+        appId,
+        terminalType: 'PC',
+        config: pcConfig,
+        mConfig: mobileConfig,
+    }, { ebbusinessid: appId }), 'table view style save');
+    const verified = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    if (String(verified.mode ?? '') !== mode) {
+        throw new Error(`展示样式保存后回读不一致: expected=${mode}, actual=${String(verified.mode ?? '')}`);
+    }
+    const after = await queryTableViews(client, baseUrl, appId, objId);
+    if (!after.some((item) => rowId(item) === listId)) {
+        throw new Error('展示样式保存后列表实体回读失败');
+    }
+    return {
+        listId,
+        style,
+        previousMode,
+        mode,
+        mobilePreserved,
+        alreadyConfigured: false,
+        persisted: true,
+    };
+}
+export async function setFormTableViewSearchStyle(client, baseUrl, appId, objId, listId, style, options = {}) {
+    const commonSearchType = FORM_TABLE_VIEW_SEARCH_STYLES[style];
+    if (commonSearchType === undefined) {
+        throw new Error(`不支持的常用搜索显示方式: ${style}。可选值: ${Object.keys(FORM_TABLE_VIEW_SEARCH_STYLES).join(', ')}`);
+    }
+    const lists = await queryTableViews(client, baseUrl, appId, objId);
+    if (!lists.some((item) => rowId(item) === listId)) {
+        throw new Error(`目标表单下不存在 listId=${listId}`);
+    }
+    const pcConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const configObjId = pcConfig.objId === undefined || pcConfig.objId === null ? objId : String(pcConfig.objId);
+    if (configObjId !== objId)
+        throw new Error(`列表配置 objId=${configObjId} 与目标表单不一致`);
+    const searchConditions = completeSearchConditions(cloneSearchConditions(pcConfig));
+    const previousType = String(searchConditions.commonSearchType ?? '');
+    if (previousType === commonSearchType) {
+        return {
+            listId,
+            style,
+            previousType,
+            commonSearchType,
+            mobilePreserved: true,
+            alreadyConfigured: true,
+            persisted: true,
+        };
+    }
+    let mobileConfig;
+    let mobilePreserved = true;
+    try {
+        mobileConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'MOBILE');
+    }
+    catch (error) {
+        if (!options.pcOnly)
+            throw error;
+        mobileConfig = {};
+        mobilePreserved = false;
+    }
+    searchConditions.commonSearchType = commonSearchType;
+    pcConfig.searchConditions = searchConditions;
+    requireSuccess(await client.post(`${baseUrl}${SAVE_CONFIG_PATH}?apid=${encode(appId)}`, {
+        listId,
+        appId,
+        terminalType: 'PC',
+        config: pcConfig,
+        mConfig: mobileConfig,
+    }, { ebbusinessid: appId }), 'table view common search style save');
+    const verified = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const verifiedType = String(verified.searchConditions?.commonSearchType ?? '');
+    if (verifiedType !== commonSearchType) {
+        throw new Error(`常用搜索显示方式保存后回读不一致: expected=${commonSearchType}, actual=${verifiedType}`);
+    }
+    const after = await queryTableViews(client, baseUrl, appId, objId);
+    if (!after.some((item) => rowId(item) === listId)) {
+        throw new Error('常用搜索显示方式保存后列表实体回读失败');
+    }
+    return {
+        listId,
+        style,
+        previousType,
+        commonSearchType,
+        mobilePreserved,
+        alreadyConfigured: false,
+        persisted: true,
+    };
+}
+export async function addFormTableViewSearchField(client, baseUrl, appId, objId, listId, fieldId, options = {}) {
+    const lists = await queryTableViews(client, baseUrl, appId, objId);
+    if (!lists.some((item) => rowId(item) === listId)) {
+        throw new Error(`目标表单下不存在 listId=${listId}`);
+    }
+    const pcConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const configObjId = pcConfig.objId === undefined || pcConfig.objId === null ? objId : String(pcConfig.objId);
+    if (configObjId !== objId)
+        throw new Error(`列表配置 objId=${configObjId} 与目标表单不一致`);
+    const searchConditions = completeSearchConditions(cloneSearchConditions(pcConfig));
+    const existing = searchConditions.commonFilters
+        .find((field) => searchFieldId(field) === fieldId);
+    if (existing) {
+        return {
+            listId,
+            fieldId,
+            fieldName: String(existing.text ?? existing.showName ?? existing.name ?? fieldId),
+            condition: String(existing.conditionTypeValue ?? ''),
+            commonFilterCount: searchConditions.commonFilters.length,
+            mobilePreserved: true,
+            alreadyConfigured: true,
+            persisted: true,
+        };
+    }
+    const fields = await queryMainDataSourceFields(client, baseUrl, appId, objId);
+    const fieldModel = fields.find((field) => searchFieldId(field) === fieldId);
+    if (!fieldModel)
+        throw new Error(`数据源中不存在主表字段 fieldId=${fieldId}`);
+    if (fieldModel.usage === 'display')
+        throw new Error(`字段 ${fieldId} 仅支持展示，不能作为搜索条件`);
+    if (fieldModel.encrypted === true || fieldModel.config?.encrypted === true) {
+        throw new Error(`字段 ${fieldId} 已加密，不能作为搜索条件`);
+    }
+    const componentKey = String(fieldModel.componentKey ?? fieldModel.compType ?? '');
+    const unsupported = new Set([
+        'ComboSelect',
+        'MatrixComponent',
+        'TreeSelect',
+        'radioboximg',
+        'checkboximg',
+        'ImageCheckBox',
+        'ImageRadioBox',
+        'EmployeeShare',
+        'ConditionFilter',
+    ]);
+    if (unsupported.has(componentKey))
+        throw new Error(`字段类型 ${componentKey} 不支持常用搜索`);
+    const availableConditions = availableSearchConditions(fieldModel);
+    if (!availableConditions.length)
+        throw new Error(`字段 ${fieldId} 没有可用的条件关系`);
+    const condition = options.condition ?? availableConditions[0];
+    if (!availableConditions.includes(condition)) {
+        throw new Error(`字段 ${fieldId} 不支持条件 ${condition}；可选值: ${availableConditions.join(', ')}`);
+    }
+    let mobileConfig;
+    let mobilePreserved = true;
+    try {
+        mobileConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'MOBILE');
+    }
+    catch (error) {
+        if (!options.pcOnly)
+            throw error;
+        mobileConfig = {};
+        mobilePreserved = false;
+    }
+    searchConditions.commonFilters.push(createCommonSearchField(fieldModel, condition, searchConditions));
+    pcConfig.searchConditions = searchConditions;
+    requireSuccess(await client.post(`${baseUrl}${SAVE_CONFIG_PATH}?apid=${encode(appId)}`, {
+        listId,
+        appId,
+        terminalType: 'PC',
+        config: pcConfig,
+        mConfig: mobileConfig,
+    }, { ebbusinessid: appId }), 'table view common search field save');
+    const verified = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const verifiedFilters = Array.isArray(verified.searchConditions?.commonFilters)
+        ? verified.searchConditions.commonFilters
+        : [];
+    const verifiedField = verifiedFilters.find((field) => searchFieldId(field) === fieldId);
+    if (!verifiedField || String(verifiedField.conditionTypeValue ?? '') !== condition) {
+        throw new Error(`常用搜索字段保存后回读不一致: fieldId=${fieldId}, condition=${condition}`);
+    }
+    const after = await queryTableViews(client, baseUrl, appId, objId);
+    if (!after.some((item) => rowId(item) === listId)) {
+        throw new Error('常用搜索字段保存后列表实体回读失败');
+    }
+    return {
+        listId,
+        fieldId,
+        fieldName: String(verifiedField.text ?? verifiedField.showName ?? verifiedField.name ?? fieldId),
+        condition,
+        commonFilterCount: verifiedFilters.length,
+        mobilePreserved,
+        alreadyConfigured: false,
+        persisted: true,
+    };
+}
+export async function configureFormTableViewSearchField(client, baseUrl, appId, objId, listId, fieldId, options) {
+    const hasChange = options.displayName !== undefined
+        || options.defaultValue !== undefined
+        || options.clearDefault === true
+        || options.required !== undefined
+        || options.fullMatch !== undefined
+        || options.condition !== undefined;
+    if (!hasChange)
+        throw new Error('至少指定一项字段配置');
+    if (options.defaultValue !== undefined && options.clearDefault) {
+        throw new Error('--default-value 与 --clear-default 不能同时使用');
+    }
+    if (options.displayName !== undefined && !options.displayName.trim()) {
+        throw new Error('显示名称不能为空');
+    }
+    const lists = await queryTableViews(client, baseUrl, appId, objId);
+    if (!lists.some((item) => rowId(item) === listId)) {
+        throw new Error(`目标表单下不存在 listId=${listId}`);
+    }
+    const pcConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const configObjId = pcConfig.objId === undefined || pcConfig.objId === null ? objId : String(pcConfig.objId);
+    if (configObjId !== objId)
+        throw new Error(`列表配置 objId=${configObjId} 与目标表单不一致`);
+    const searchConditions = cloneSearchConditions(pcConfig);
+    const before = JSON.stringify(searchConditions);
+    completeSearchConditions(searchConditions);
+    const field = searchConditions.commonFilters
+        .find((item) => searchFieldId(item) === fieldId);
+    if (!field)
+        throw new Error(`常用搜索中不存在 fieldId=${fieldId}；请先执行 search-field add`);
+    field.configNameJson ??= '';
+    field.browserType ??= '';
+    field.required ??= 0;
+    field.limitInfo ??= {
+        needWordSearch: true,
+        maxLength: searchConditions.filterInfo?.searchValueContentLengthLimit ?? 10000,
+        maxWordLength: searchConditions.filterInfo?.searchValueElementLengthLimit ?? 50,
+        maxEqWordLength: searchConditions.filterInfo?.searchValueElementLengthLimitWithEq ?? 500,
+    };
+    const settings = field.listFilterDefaultSets
+        && typeof field.listFilterDefaultSets === 'object'
+        && !Array.isArray(field.listFilterDefaultSets)
+        ? field.listFilterDefaultSets
+        : (field.listFilterDefaultSets = {});
+    const settingDefaults = {
+        optionEnable: '0',
+        listGroupSets: [],
+        listFilterSets: [],
+        multiSelect: true,
+        defaultType: '0',
+        startValue: '',
+        startValueSpan: '',
+        startDefaultLabel: '',
+        endValue: '',
+        dateMenuGroup: [],
+        enableTime: '0',
+        conditionTypeValue: String(field.conditionTypeValue ?? ''),
+        enableBrowserFilter: 0,
+        showArchiveOption: '1',
+        searchContentFullMatches: false,
+    };
+    for (const [key, value] of Object.entries(settingDefaults)) {
+        if (settings[key] === undefined)
+            settings[key] = structuredClone(value);
+    }
+    let resolvedDefaultValue = options.defaultValue;
+    if (options.defaultValue !== undefined && String(field.componentKey ?? field.type ?? '') === 'Select') {
+        const fields = await queryMainDataSourceFields(client, baseUrl, appId, objId);
+        const fieldModel = fields.find((item) => searchFieldId(item) === fieldId);
+        if (!fieldModel)
+            throw new Error(`数据源中不存在主表字段 fieldId=${fieldId}`);
+        const selectableOptions = searchFieldOptions(fieldModel);
+        const matches = selectableOptions.filter((option) => {
+            const value = String(option.value ?? option.valueKey ?? '');
+            return value === options.defaultValue || String(option.name ?? '') === options.defaultValue;
+        });
+        if (matches.length !== 1) {
+            const available = selectableOptions
+                .map((option) => `${String(option.name ?? '')}(${String(option.value ?? option.valueKey ?? '')})`)
+                .join(', ');
+            throw new Error(`选项 ${options.defaultValue} 无法唯一解析；可选值: ${available}`);
+        }
+        resolvedDefaultValue = String(matches[0].value ?? matches[0].valueKey);
+        field.options = structuredClone(selectableOptions);
+        settings.listGroupSets = structuredClone(selectableOptions);
+    }
+    if (options.displayName !== undefined)
+        field.showName = options.displayName.trim();
+    if (resolvedDefaultValue !== undefined) {
+        settings.optionEnable = '0';
+        settings.defaultType = '1';
+        settings.startValue = resolvedDefaultValue;
+        settings.startDefaultLabel = '';
+    }
+    else if (options.clearDefault) {
+        settings.defaultType = '0';
+        settings.startValue = '';
+        settings.startDefaultLabel = '';
+    }
+    if (options.required !== undefined)
+        field.required = options.required ? 1 : 0;
+    if (options.fullMatch !== undefined)
+        settings.searchContentFullMatches = options.fullMatch;
+    if (options.condition !== undefined) {
+        const allowed = availableSearchConditions(field);
+        if (!allowed.includes(options.condition)) {
+            throw new Error(`字段 ${fieldId} 不支持条件 ${options.condition}；可选值: ${allowed.join(', ')}`);
+        }
+        field.conditionTypeValue = options.condition;
+        settings.conditionTypeValue = options.condition;
+    }
+    const resultFrom = (configuredField, mobilePreserved, alreadyConfigured) => {
+        const configuredSettings = configuredField.listFilterDefaultSets ?? {};
+        return {
+            listId,
+            fieldId,
+            displayName: String(configuredField.showName ?? configuredField.text ?? configuredField.name ?? fieldId),
+            defaultType: String(configuredSettings.defaultType ?? '0'),
+            defaultValue: String(configuredSettings.startValue ?? ''),
+            defaultLabel: String((Array.isArray(configuredField.options) ? configuredField.options : [])
+                .find((option) => String(option.value ?? option.valueKey ?? '') === String(configuredSettings.startValue ?? ''))
+                ?.name
+                ?? configuredSettings.startValue
+                ?? ''),
+            required: Number(configuredField.required ?? 0) === 1,
+            fullMatch: configuredSettings.searchContentFullMatches === true,
+            condition: String(configuredField.conditionTypeValue ?? ''),
+            mobilePreserved,
+            alreadyConfigured,
+            persisted: true,
+        };
+    };
+    if (JSON.stringify(searchConditions) === before)
+        return resultFrom(field, true, true);
+    let mobileConfig;
+    let mobilePreserved = true;
+    try {
+        mobileConfig = await readTableViewConfig(client, baseUrl, appId, listId, 'MOBILE');
+    }
+    catch (error) {
+        if (!options.pcOnly)
+            throw error;
+        mobileConfig = {};
+        mobilePreserved = false;
+    }
+    pcConfig.searchConditions = searchConditions;
+    requireSuccess(await client.post(`${baseUrl}${SAVE_CONFIG_PATH}?apid=${encode(appId)}`, {
+        listId,
+        appId,
+        terminalType: 'PC',
+        config: pcConfig,
+        mConfig: mobileConfig,
+    }, { ebbusinessid: appId }), 'table view common search field configure');
+    const verified = await readTableViewConfig(client, baseUrl, appId, listId, 'PC');
+    const verifiedField = (Array.isArray(verified.searchConditions?.commonFilters)
+        ? verified.searchConditions.commonFilters
+        : [])
+        .find((item) => searchFieldId(item) === fieldId);
+    if (!verifiedField)
+        throw new Error(`搜索字段配置保存后回读缺少 fieldId=${fieldId}`);
+    const expected = resultFrom(field, mobilePreserved, false);
+    const actual = resultFrom(verifiedField, mobilePreserved, false);
+    for (const key of [
+        'displayName',
+        'defaultType',
+        'defaultValue',
+        'defaultLabel',
+        'required',
+        'fullMatch',
+        'condition',
+    ]) {
+        if (actual[key] !== expected[key]) {
+            throw new Error(`搜索字段配置保存后回读不一致: ${key} expected=${expected[key]}, actual=${actual[key]}`);
+        }
+    }
+    return actual;
+}
+//# sourceMappingURL=form-table-view.js.map