@stalfh233/omc-cli 0.0.0-stage → 0.4.0

package/dist/lanes/list-view-shapes.js

@@ -0,0 +1,1207 @@
+import { z } from "zod";
+import { ToolRefusalError } from "../tool-types.js";
+import { decodeJsonColumn, encodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "../json-column.js";
+import { FIELD_PROPERTY_TYPES } from "../field-families.js";
+function wireEnum(key, index) {
+    return {
+        key,
+        names: Object.keys(index),
+        index,
+        name: Object.fromEntries(Object.entries(index).map(([name, value]) => [value, name])),
+    };
+}
+/** Encode an enum name to its wire numeric index (undefined when unknown). */
+export function encodeEnumName(descriptor, name) {
+    return typeof name === "string" ? descriptor.index[name] : undefined;
+}
+/** Decode a wire numeric index back to its enum name (unknown numbers pass through). */
+export function decodeWireEnum(descriptor, value) {
+    return typeof value === "number" ? descriptor.name[value] ?? value : value ?? null;
+}
+/**
+ * `QueryFilterType` (QueryFilterType.java) is the list-condition OPERATOR
+ * (Eq/NotEq/Gt/Lt/Gte/Lte/Like/NotLike/IsNull/IsNotNull/In/NotIn/Between/
+ * NotBetween/Of/NotOf/ContainsAll/…). Unlike SortDirectionType/DisplayType it
+ * carries NO `@JsonValue`; as an `IStringEnum` it serializes as its NAME STRING
+ * on the wire (live readback of `h_biz_query_detail.queryConfigJson`
+ * filterType:"Like"). So the tool speaks/reads the enum name verbatim — no
+ * numeric index conversion.
+ */
+export const QUERY_FILTER_TYPE = [
+    "Eq", "NotEq", "Gt", "Lt", "Gte", "Lte", "Like", "NotLike",
+    "IsNull", "IsNotNull", "Of", "NotOf", "In", "NotIn", "Between", "NotBetween",
+    "ContainsAll", "NotContainsAll", "ContainsAny", "NotContainsAny", "EqAny", "NotEqAny",
+    "MonthTimeBetween", "DayTimeBetween", "TimeBetween", "TimeNotBetween",
+    "TimeGt", "TimeGte", "TimeLt", "TimeLte",
+];
+const QUERY_FILTER_TYPES = new Set(QUERY_FILTER_TYPE);
+/**
+ * The platform's own default operator per property type
+ * (`QueryFilterType.getDefaultQueryFilterType`, QueryFilterType.java) — used
+ * when a condition omits `filterType`, so the stored row names its comparison.
+ */
+function defaultQueryFilterType(propertyType) {
+    switch (propertyType) {
+        case FIELD_PROPERTY_TYPES.LOGICAL:
+        case FIELD_PROPERTY_TYPES.WORK_SHEET:
+        case FIELD_PROPERTY_TYPES.MULT_WORK_SHEET:
+        case FIELD_PROPERTY_TYPES.STAFF_SELECTOR:
+        case FIELD_PROPERTY_TYPES.ADDRESS:
+        case FIELD_PROPERTY_TYPES.RADIO:
+        case FIELD_PROPERTY_TYPES.DROPDOWN_BOX:
+            return "Eq";
+        case FIELD_PROPERTY_TYPES.DEPARTMENT_SELECTOR:
+            return "Eq";
+        case FIELD_PROPERTY_TYPES.DATE:
+        case FIELD_PROPERTY_TYPES.NUMERICAL:
+            return "Between";
+        case FIELD_PROPERTY_TYPES.ATTACHMENT:
+            return "IsNull";
+        default:
+            return "Like";
+    }
+}
+/**
+ * Wire enum maps pinned to the 8.6.26 query DTOs. The enums carry
+ * `@JsonValue getIndex()` (BizQuerySortModel/BizQueryConditionModel), so the
+ * HTTP body uses the numeric index while the tool speaks the enum name and
+ * decodes it back on readback.
+ */
+export const SORT_DIRECTION = wireEnum("SortDirectionType", { ASC: 1, DESC: 2 });
+export const DISPLAY_TYPE = wireEnum("DisplayType", { INPUT: 0, RADIO: 1, CHECKBOX: 2, SELECT: 3, RANGE: 4 });
+export const CHOICE_TYPE = wireEnum("ChoiceType", { SELECT: 1, POPUP: 2, TREE_LEFT: 3 });
+/**
+ * BizQueryActionModel enums. `QueryActionType` (QueryActionType.java:13-35) and
+ * `QueryActionRelativeType` (BIZSHEET 0/WORKFLOW 1) both carry
+ * `@JsonValue getIndex()` so the wire body is numeric; the tool speaks the enum
+ * name and decodes on readback. `associationType`/`associationCode` are the
+ * JSON names of the DTO fields `queryActionRelativeType`/`relativeCode`
+ * (`@JsonProperty`, BizQueryActionModel.java:31-35).
+ */
+export const QUERY_ACTION_TYPE = wireEnum("QueryActionType", {
+    QUERY: 1,
+    ADD: 2,
+    EDIT: 3,
+    DELETE: 4,
+    IMPORT: 5,
+    EXPORT: 6,
+    CUSTOM: 7,
+    QR_CODE: 8,
+    EDITOWNER: 9,
+    BATCH_PRINT: 10,
+    BATCH_UPDATE: 11,
+    CUSTOMIZE_BTN: 12,
+    PRINT: 13,
+    COPY: 14,
+    TEMPORARY: 15,
+    SUBMIT: 16,
+    CLEAR_ROW: 17,
+    ADD_BEFORE: 18,
+    ADD_AFTER: 19,
+    MANUAL_SYNC: 20,
+    IMPORT_ATTACHMENT: 21,
+    EXPORT_ATTACHMENT: 22,
+    BATCH_SUBMIT: 23,
+});
+export const QUERY_ACTION_RELATIVE = wireEnum("QueryActionRelativeType", { BIZSHEET: 0, WORKFLOW: 1 });
+/**
+ * `BizButtonModel` enums (listview custom buttons). Unlike the query DTOs
+ * above, these implement `IStringEnum` with no `@JsonValue`, so Hutool parses
+ * and Jackson serializes them by enum name (the desensitized customButtonJson
+ * carries `bindAction:"SCRIPT"` etc.). `triggerType`/`triggerCode` are forced by
+ * `BizButtonFacadeImpl.addBizButtonList(String,...)` (:96-101), so they are only
+ * decoded back, never authored. `sortKey` is overwritten with the array index.
+ */
+export const BUTTON_TRIGGER_TYPE = wireEnum("ButtonTriggerType", { QUERY: 1, FORM: 2 });
+export const BUTTON_BIND_ACTION = wireEnum("ButtonBindAction", {
+    LIST: 1,
+    FORM: 2,
+    ADD_DATA: 3,
+    FLOW: 4,
+    BUSINESS_RULE: 5,
+    SCRIPT: 6,
+    CUSTOM_PAGE: 7,
+    WORKFLOW_CENTER_PAGE: 8,
+    FRONT_EVENT: 9,
+    AGENT: 10,
+});
+export const BUTTON_USE_LOCATION = wireEnum("ButtonUseLocation", { LIST: 1, FORM: 2, ROW: 3 });
+export const BUTTON_OPERATE_TYPE = wireEnum("ButtonOperateType", { WITH_VIEW: 1, WITH_OUT_VIEW: 2 });
+export const BUTTON_SHOW_PERM_TYPE = wireEnum("ButtonShowPermType", {
+    BIND_SYS_BUTTON: 1,
+    BIND_BUSINESS_RULE: 2,
+    BIND_FRONT_EVENT_BUTTON: 3,
+});
+/**
+ * `BizButtonFacadeImpl.validateParamMessage` rejects these codes (uppercased)
+ * with `INVALID_SYSTEM_CODE_USED` (:243-245), so the dry-lint refuses them too.
+ */
+export const BUTTON_SYSTEM_CODES = new Set(["ADD", "DELETE", "IMPORT", "EXPORT", "QR_CODE", "EDITOWNER", "BATCH_PRINT", "BATCH_UPDATE"]);
+/**
+ * `QueryPresentationType` (8.6.26) is an `IStringEnum` with `@JsonValue
+ * getIndex()` whose index equals the name, so the wire carries the name
+ * LIST/BOARD/CALENDAR/GANTT; `@JsonCreator get(String)` parses it back.
+ * (No numeric index — the wire value IS the name.)
+ */
+export const QUERY_PRESENTATION_TYPE = {
+    key: "QueryPresentationType",
+    names: ["LIST", "BOARD", "CALENDAR", "GANTT"],
+};
+/**
+ * BizQueryPresentModel payload fields. On the wire they are all JSON strings
+ * (BizQueryPresent.java declares htmlJson/actionsJson/columnsJson/
+ * schemaRelations/options as TEXT and queryViewDataSource as LONGTEXT);
+ * `clientType` is a ClientType string enum (PC/APP/OTHER) forced to PC by
+ * query/update. `schemaRelations` is platform-derived by
+ * ModelManagementFacadeImpl.resolveRelations and overwrites any input.
+ */
+export const PRESENTATION_FIELDS = ["htmlJson", "actionsJson", "columnsJson", "queryViewDataSource", "schemaRelations", "options"];
+export const directionArg = z.enum(["ASC", "DESC"]).describe("SortDirectionType; sent numeric ASC(1)/DESC(2)");
+export const displayTypeArg = z
+    .enum(["INPUT", "RADIO", "CHECKBOX", "SELECT", "RANGE"])
+    .describe("DisplayType; sent numeric INPUT(0)/RADIO(1)/CHECKBOX(2)/SELECT(3)/RANGE(4)");
+export const choiceTypeArg = z.enum(["SELECT", "POPUP", "TREE_LEFT"]).describe("ChoiceType; sent numeric SELECT(1)/POPUP(2)/TREE_LEFT(3)");
+export const conditionOptionsArg = z
+    .union([z.string(), z.record(z.string(), z.unknown())])
+    .describe("queryCondition options; an object is JSON-stringified for the wire and decoded on readback");
+export const listViewSortArg = z.object({
+    propertyCode: z.string().min(1).describe("目标字段：propertyCode 或字段显示名（唯一匹配时自动解析，歧义拒绝）"),
+    propertyType: z.number().int().optional().describe("BizPropertyType numeric; derived from published field metadata when omitted"),
+    direction: directionArg,
+    sortKey: z.number().int().optional().describe("sort order; defaults to the array position"),
+});
+export const listViewConditionArg = z
+    .object({
+    propertyCode: z.string().min(1).describe("目标字段：propertyCode 或字段显示名（唯一匹配时自动解析，歧义拒绝）"),
+    propertyType: z.number().int().optional().describe("BizPropertyType numeric; derived from published field metadata when omitted"),
+    displayType: displayTypeArg.optional(),
+    defaultValue: z.string().optional(),
+    options: conditionOptionsArg.optional(),
+    startValue: z.string().optional(),
+    endValue: z.string().optional(),
+    shortcutFilter: z.boolean().optional(),
+    choiceType: choiceTypeArg.optional(),
+    dateType: z.number().int().optional(),
+    accurateSearch: z.boolean().optional(),
+    showNull: z.boolean().optional(),
+    showNotNull: z.boolean().optional(),
+    includeSubData: z.boolean().optional(),
+    buildTreeBy: z.string().optional(),
+    visible: z.boolean().optional(),
+    filterType: z.string().optional().describe(`QueryFilterType 比较符（平台字符串枚举）：${QUERY_FILTER_TYPE.join("/")}；省略时按 propertyType 取平台默认`),
+    operator: z.string().optional().describe("filterType 的别名（同一比较符）"),
+    op: z.string().optional().describe("filterType 的别名（同一比较符）"),
+})
+    // Keep unknown keys so `assertListViewConfigureShape` can REFUSE them with a
+    // helpful message. A default `z.object` strips them, so `{operator, value}`
+    // silently disappeared and the write looked like it landed (dogfood R2).
+    .passthrough();
+export const queryActionTypeArg = z
+    .enum(Object.keys(QUERY_ACTION_TYPE.index))
+    .describe("QueryActionType; sent numeric QUERY(1)/ADD(2)/EDIT(3)/DELETE(4)/IMPORT(5)/EXPORT(6)/CUSTOM(7)/QR_CODE(8)/EDITOWNER(9)/BATCH_PRINT(10)/BATCH_UPDATE(11)/CUSTOMIZE_BTN(12)/PRINT(13)/COPY(14)/TEMPORARY(15)/SUBMIT(16)/CLEAR_ROW(17)/ADD_BEFORE(18)/ADD_AFTER(19)/MANUAL_SYNC(20)/IMPORT_ATTACHMENT(21)/EXPORT_ATTACHMENT(22)/BATCH_SUBMIT(23)");
+export const associationTypeArg = z.enum(["BIZSHEET", "WORKFLOW"]).describe("QueryActionRelativeType; sent numeric BIZSHEET(0)/WORKFLOW(1)");
+export const listViewActionArg = z.object({
+    actionCode: z.string().min(1),
+    name: z.string().optional(),
+    icon: z.string().optional(),
+    queryActionType: queryActionTypeArg,
+    systemAction: z.boolean().optional(),
+    serviceCode: z.string().optional(),
+    serviceMethod: z.string().optional(),
+    customService: z.boolean().optional(),
+    associationCode: z.string().optional().describe("relativeCode JSON name; the associated form/workflow code"),
+    associationType: associationTypeArg.optional(),
+    sortKey: z.number().int().optional().describe("sort order; query/update resets it to the array position i+1"),
+});
+export const buttonBindActionArg = z
+    .enum(Object.keys(BUTTON_BIND_ACTION.index))
+    .describe("ButtonBindAction; sent as the enum name LIST(1)/FORM(2)/ADD_DATA(3)/FLOW(4)/BUSINESS_RULE(5)/SCRIPT(6)/CUSTOM_PAGE(7)/WORKFLOW_CENTER_PAGE(8)/FRONT_EVENT(9)/AGENT(10)");
+export const buttonUseLocationArg = z
+    .enum(["LIST", "FORM", "ROW"])
+    .describe("ButtonUseLocation; sent as the enum name LIST(1)/FORM(2)/ROW(3)");
+export const buttonOperateTypeArg = z
+    .enum(["WITH_VIEW", "WITH_OUT_VIEW"])
+    .describe("ButtonOperateType; sent as the enum name WITH_VIEW(1)/WITH_OUT_VIEW(2)");
+export const buttonShowPermTypeArg = z
+    .enum(["BIND_SYS_BUTTON", "BIND_BUSINESS_RULE", "BIND_FRONT_EVENT_BUTTON"])
+    .describe("ButtonShowPermType; sent as the enum name BIND_SYS_BUTTON(1)/BIND_BUSINESS_RULE(2)/BIND_FRONT_EVENT_BUTTON(3)");
+const buttonConfigureListArg = z
+    .object({
+    currentDataItemId: z.string().min(1).optional().describe("源字段 code（当前视图模型上的字段）；缺失由 dry-lint 拒绝（listview-buttons-invalid）"),
+    targetDataItemId: z.string().min(1).optional().describe("目标字段 code（targetModel 上的字段）；缺失由 dry-lint 拒绝（listview-buttons-invalid）"),
+    isConst: z.string().optional().describe('常量开关是字符串 "true"/"false"；仅 "false" 已取证（常量赋值键名未取证，未实现）'),
+    OptionType: z.string().optional().describe("赋值算子（注意大写 O）；仅 Eq 已取证"),
+})
+    .describe("actionConfig.configureList[] 数据赋值条目；字段对象内联副本由工具从发布面读回展开");
+export const listViewButtonArg = z
+    .object({
+    code: z.string().min(1),
+    name: z.string().min(1),
+    useLocation: buttonUseLocationArg,
+    bindAction: buttonBindActionArg,
+    operateType: buttonOperateTypeArg,
+    showPermCode: z.string().optional(),
+    showPermType: buttonShowPermTypeArg.optional(),
+    hint: z.string().optional(),
+    targetCode: z.string().optional(),
+    targetObjCode: z.string().optional(),
+    description: z.string().optional(),
+    targetModel: z.string().min(1).optional().describe("ADD_DATA/FORM 目标模型 code；工具读回应用树节点内联展开成 actionConfig.schemaCodeVal（targetCode/targetObjCode 对这两类按钮无效——实测恒 null 不参与）"),
+    targetForm: z.string().min(1).optional().describe("ADD_DATA/FORM 目标表单 code；缺省用目标模型的默认表单；展开成 actionConfig.formListData"),
+    configureList: z.array(buttonConfigureListArg).optional().describe("ADD_DATA 数据赋值；展开成 actionConfig.configureList（含 isConst:\"false\"、OptionType:\"Eq\" 与字段内联副本）"),
+    actionConfig: z
+        .union([z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe("BizButtonModel.actionConfig 原样透传（与 targetModel/targetForm/configureList 互斥）；ADD_DATA/FORM 只接受 schemaCodeVal/formListData/configureList 子形状"),
+})
+    .describe("customButtons[] entry (BizButtonModel); name/code/useLocation/bindAction/operateType are required; triggerType/triggerCode are forced to QUERY/view code and sortKey to the array position");
+/**
+ * `BizQueryModel.options` (a String column on `h_biz_query`) parsed by the
+ * platform as `BizQueryOption` (8.6.26): only `pagingSetting`
+ * (BizQueryPaging{pageSize,showTotal}) and `listViewModeSetting`
+ * (ListViewModeSetting{mode,canSwitch}) have class evidence. `defaultOption()`
+ * is pageSize 20 / showTotal true / mode "spreadsheet" / canSwitch false.
+ * `rowColorSetting` exists only in newer yst/fwb samples with no 8.6.26 class,
+ * so the object form refuses it (a raw string stays the escape hatch).
+ */
+export const listViewPagingSettingArg = z
+    .object({
+    pageSize: z.number().int().positive().optional().describe("BizQueryPaging.pageSize (8.6.26 default 20)"),
+    showTotal: z.boolean().optional().describe("BizQueryPaging.showTotal (8.6.26 default true)"),
+})
+    .strict();
+export const listViewModeSettingArg = z
+    .object({
+    mode: z.string().min(1).optional().describe("ListViewModeSetting.mode; 8.6.26 SPREAD_SHEET default \"spreadsheet\" (a plain String, no enum)"),
+    canSwitch: z.boolean().optional().describe("ListViewModeSetting.canSwitch (8.6.26 default false)"),
+})
+    .strict();
+export const listViewOptionsArg = z
+    .union([
+    z.string(),
+    z
+        .object({
+        pagingSetting: listViewPagingSettingArg.optional(),
+        listViewModeSetting: listViewModeSettingArg.optional(),
+    })
+        .strict(),
+])
+    .describe("view header options (BizQueryModel.options, a BizQueryOption JSON string); a raw string is sent verbatim, an object is JSON-stringified; object keys are limited to pagingSetting{pageSize,showTotal} + listViewModeSetting{mode,canSwitch} (rowColorSetting has no 8.6.26 class and is refused)");
+/**
+ * `queryGanttModel` (BizQueryGanttModel) is the GANTT config; when
+ * presentationType is GANTT the controller requires it with non-null
+ * startTimePropertyCode/endTimePropertyCode/titlePropertyCode
+ * (BizQueryController.validateNotEmptyGantt :1121-1136).
+ */
+export const presentationTypeArg = z.enum(QUERY_PRESENTATION_TYPE.names).describe("QueryPresentationType; sent as the name LIST/BOARD/CALENDAR/GANTT (@JsonValue index == name)");
+export const listViewGanttArg = z
+    .object({
+    startTimePropertyCode: z.string().min(1).optional(),
+    endTimePropertyCode: z.string().min(1).optional(),
+    progressPropertyCode: z.string().optional(),
+    titlePropertyCode: z.string().min(1).optional(),
+    preDependencyPropertyCode: z.string().optional(),
+    endDependencyPropertyCode: z.string().optional(),
+    levelPropertyCode: z.string().optional().describe("hierarchy field; platform forces parentId for TREE models"),
+    milepostCode: z.string().optional(),
+    sortKey: z.string().optional().describe("BizQueryGantt.sortKey is a String column"),
+    configJson: z.union([z.string(), z.record(z.string(), z.unknown())]).optional().describe("extension JSON; an object is JSON-stringified"),
+    liableManCode: z.string().optional(),
+    statusCode: z.string().optional(),
+    defaultPrecision: z.string().optional(),
+})
+    .strict()
+    .describe("BizQueryGanttModel (queryGanttModel); queryId/schemaCode are platform/tool supplied; required (startTime/endTime/title) only when presentationType is GANTT");
+/**
+ * `queryLayer` (BizQueryLayer[]) is a real JSON array in the DTO (not a String
+ * column), so it is sent as an array. `multiTableHeaderConfig` is a String
+ * column holding a HeaderConfig[] JSON (type/name/field/propertyType/children),
+ * parsed by EasyExcelUtils/DefaultDataIEFileOperateServiceImpl via
+ * JSONObject.parseArray. saveBizQueryDetail assigns both unconditionally
+ * (:184-186), so omitted keys would overwrite stored values; the read face
+ * always carries them (BizQueryFacadeImpl:344-345), so the tool echoes them.
+ */
+export const listViewQueryLayerArg = z
+    .array(z.record(z.string(), z.unknown()))
+    .describe("queryLayer (BizQueryLayer[]); array of layer objects, passed through and read back");
+export const listViewMultiTableHeaderArg = z
+    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+    .describe("multiTableHeaderConfig (HeaderConfig[] JSON); a raw JSON string is sent verbatim, an array is JSON-stringified; decoded on readback when valid JSON");
+export const presentationJsonArg = z
+    .union([z.string(), z.record(z.string(), z.unknown()), z.array(z.unknown())])
+    .describe("queryPresentation field; a JSON string is sent as-is, an object/array is JSON-stringified; decoded on readback when valid JSON");
+export const listViewPresentationArg = z
+    .object({
+    htmlJson: presentationJsonArg.optional(),
+    actionsJson: presentationJsonArg.optional(),
+    columnsJson: presentationJsonArg.optional(),
+    queryViewDataSource: presentationJsonArg.optional(),
+    schemaRelations: presentationJsonArg.optional(),
+    options: presentationJsonArg.optional(),
+})
+    .describe("queryPresentation {clientType,htmlJson,actionsJson,columnsJson,queryViewDataSource,schemaRelations,options}; omitted leaves the existing presentation untouched, provided replaces it (clientType is forced to PC; schemaRelations is platform-derived)");
+function refusePresentation(message) {
+    throw new ToolRefusalError({ status: "refused", blocker: "listview-presentation-render-invalid", message });
+}
+function decodePresentationForValidation(value, key) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        refusePresentation(`presentation.${key} must be valid JSON: ${error.message}`);
+    }
+}
+function presentationShape(value, key) {
+    const decoded = decodePresentationForValidation(value, key);
+    if (key === "htmlJson") {
+        if (!Array.isArray(decoded))
+            refusePresentation("presentation.htmlJson must decode to an array");
+        for (const [index, element] of decoded.entries()) {
+            if (!element || typeof element !== "object" || Array.isArray(element))
+                refusePresentation(`presentation.htmlJson[${index}] must be an object`);
+            const row = element;
+            if (typeof row.tagName !== "string" || row.tagName.length === 0 || !Array.isArray(row.attrs))
+                refusePresentation(`presentation.htmlJson[${index}] requires non-empty tagName and attrs array`);
+        }
+        return decoded;
+    }
+    if (key === "actionsJson" || key === "columnsJson") {
+        if (!Array.isArray(decoded))
+            refusePresentation(`presentation.${key} must decode to an array`);
+        for (const [index, element] of decoded.entries()) {
+            if (!element || typeof element !== "object" || Array.isArray(element))
+                refusePresentation(`presentation.${key}[${index}] must be an object`);
+            const row = element;
+            const required = key === "actionsJson" ? ["actionCode", "name", "icon"] : ["propertyCode", "propertyType"];
+            for (const field of required) {
+                const valid = field === "propertyType" ? typeof row[field] === "number" : typeof row[field] === "string" && row[field].length > 0;
+                if (!valid)
+                    refusePresentation(`presentation.${key}[${index}] requires ${field}`);
+            }
+        }
+        return decoded;
+    }
+    return decoded;
+}
+export function validatePresentationRenderShape(presentation) {
+    for (const key of ["htmlJson", "actionsJson", "columnsJson"]) {
+        if (presentation[key] !== undefined)
+            presentationShape(presentation[key], key);
+    }
+}
+function decodeButtonActionConfig(value, code) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string") {
+        try {
+            value = JSON.parse(value);
+        }
+        catch (error) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: actionConfig must be valid JSON (${error.message})` });
+        }
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: actionConfig must decode to an object` });
+    }
+    return value;
+}
+function requireButtonConfig(config, code, bindAction) {
+    const required = bindAction === "SCRIPT" ? ["scriptData"] : bindAction === "BUSINESS_RULE" || bindAction === "FLOW" ? ["targetCode"] : bindAction === "ADD_DATA" || bindAction === "FORM" ? ["schemaCodeVal", "formListData", "configureList"] : [];
+    for (const key of required) {
+        if (config?.[key] === undefined || config[key] === null) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: ${bindAction} actionConfig requires ${key}` });
+        }
+    }
+    if (bindAction === "SCRIPT" && typeof config?.scriptData !== "string") {
+        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: SCRIPT actionConfig.scriptData must be a string` });
+    }
+    if ((bindAction === "ADD_DATA" || bindAction === "FORM") && (typeof config?.schemaCodeVal !== "object" || config.schemaCodeVal === null || Array.isArray(config.schemaCodeVal) || !Array.isArray(config.formListData) || !Array.isArray(config.configureList))) {
+        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: ${bindAction} actionConfig requires object schemaCodeVal and array formListData/configureList` });
+    }
+}
+export function validateButtonActionConfig(entry) {
+    const bindAction = typeof entry.bindAction === "string" ? entry.bindAction : "";
+    const code = String(entry.code ?? "");
+    const config = decodeButtonActionConfig(entry.actionConfig, code);
+    if (bindAction === "BUSINESS_RULE") {
+        if (typeof entry.targetCode !== "string" || entry.targetCode.length === 0) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: BUSINESS_RULE requires targetCode` });
+        }
+        return;
+    }
+    if (bindAction === "FLOW") {
+        if (typeof entry.targetCode !== "string" || entry.targetCode.length === 0) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: FLOW requires targetCode (workflow code)` });
+        }
+        // A caller-supplied FLOW actionConfig must carry WorkflowListData; the
+        // runtime indexes [0].workflowCode and iterates configureList. Omitted is
+        // fine — expandButtonActionConfigs derives both from targetCode.
+        if (config !== undefined && (typeof config !== "object" || config === null || !Array.isArray(config.WorkflowListData))) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: FLOW actionConfig requires a WorkflowListData array (or omit actionConfig and the tool derives it from targetCode)` });
+        }
+        return;
+    }
+    if ((bindAction === "ADD_DATA" || bindAction === "FORM") && (entry.targetModel !== undefined || entry.targetForm !== undefined || entry.configureList !== undefined) && entry.actionConfig === undefined)
+        return;
+    requireButtonConfig(config, code, bindAction);
+}
+export function columnsRenderCompat(columns) {
+    const violations = [];
+    for (const [index, column] of columns.entries()) {
+        if (typeof column.propertyCode !== "string" || column.propertyCode.length === 0)
+            violations.push(`columns[${index}].propertyCode`);
+        if (typeof column.propertyType !== "number")
+            violations.push(`columns[${index}].propertyType`);
+        if (typeof column.name !== "string" || column.name.length === 0)
+            violations.push(`columns[${index}].name`);
+        if (typeof column.visible !== "boolean")
+            violations.push(`columns[${index}].visible`);
+        if (typeof column.width !== "string" && typeof column.width !== "number")
+            violations.push(`columns[${index}].width`);
+        if (typeof column.sortKey !== "number")
+            violations.push(`columns[${index}].sortKey`);
+    }
+    return violations.length ? { ok: false, violations } : { ok: true };
+}
+export function buttonsRenderCompat(buttons) {
+    const violations = [];
+    for (const [index, button] of buttons.entries()) {
+        try {
+            validateButtonActionConfig(button);
+        }
+        catch {
+            violations.push(`buttons[${index}].actionConfig`);
+        }
+    }
+    return violations.length ? { ok: false, violations } : { ok: true };
+}
+/**
+ * The keys a list-view condition (a filter CONTROL definition) accepts. Mirrors
+ * `com.authine.cloudpivot.metadata.bizquery.BizQueryConditionModel` (8.6.26) at
+ * the field level, minus server-owned keys (queryId/schemaCode/clientType). A
+ * condition is a filter control whose `filterType` (QueryFilterType) declares
+ * the comparison operator (`Eq`/`NotEq`/…), with an optional value carrier
+ * (`defaultValue`/`options`/`startValue`/`endValue`/`showNull`/`showNotNull`).
+ */
+const LISTVIEW_CONDITION_KEYS = new Set([
+    "propertyCode",
+    "propertyType",
+    "name",
+    "displayType",
+    "defaultValue",
+    "options",
+    "startValue",
+    "endValue",
+    "shortcutFilter",
+    "choiceType",
+    "dateType",
+    "accurateSearch",
+    "showNull",
+    "showNotNull",
+    "includeSubData",
+    "buildTreeBy",
+    "visible",
+    "filterType",
+]);
+/**
+ * Out-the-door dry lint for `sorts`/`conditions`/`actions`/`presentation`/
+ * `buttons`/`options`. `omc call` bypasses zod, so this refuses a malformed list
+ * or options object before the write permission gate and before any write. Duplicates
+ * are refused because the provided list replaces the stored one; `options`
+ * objects are limited to the 8.6.26-evidenced `pagingSetting`/
+ * `listViewModeSetting` (rowColorSetting has no class).
+ */
+export function assertListViewConfigureShape(args) {
+    const lists = [
+        ["sorts", args.sorts],
+        ["conditions", args.conditions],
+    ];
+    for (const [kind, value] of lists) {
+        if (value === undefined)
+            continue;
+        if (!Array.isArray(value)) {
+            throw new ToolRefusalError({ status: "refused", blocker: `listview-${kind}-invalid`, message: `${kind} must be an array` });
+        }
+        const seen = new Set();
+        for (const entry of value) {
+            const propertyCode = entry?.propertyCode;
+            if (typeof propertyCode !== "string" || propertyCode.length === 0) {
+                throw new ToolRefusalError({ status: "refused", blocker: `listview-${kind}-invalid`, message: `${kind} entries require a non-empty propertyCode` });
+            }
+            if (seen.has(propertyCode)) {
+                throw new ToolRefusalError({ status: "refused", blocker: `listview-${kind}-duplicate`, message: `${kind} has duplicate propertyCode ${propertyCode}` });
+            }
+            seen.add(propertyCode);
+            if (kind === "sorts" && entry.direction !== "ASC" && entry.direction !== "DESC") {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-sorts-invalid", message: `sorts direction must be ASC or DESC (got ${String(entry.direction)})` });
+            }
+            // A list-view filter is a filter CONTROL whose OPERATOR is `filterType`
+            // (QueryFilterType). `operator`/`op` are accepted aliases for it; a bare
+            // `value` is not a platform key (the value carrier is defaultValue/
+            // options/startValue/endValue). An unknown key is refused rather than
+            // silently dropped, so `ok:true` cannot hide a filter that never landed.
+            if (kind === "conditions") {
+                const ALIASES = new Set(["operator", "op"]);
+                for (const key of Object.keys(entry)) {
+                    if (LISTVIEW_CONDITION_KEYS.has(key) || ALIASES.has(key))
+                        continue;
+                    const operatorish = key === "operator" || key === "value";
+                    throw new ToolRefusalError({
+                        status: "refused",
+                        blocker: "listview-condition-unknown-key",
+                        message: operatorish
+                            ? `conditions 的 "${key}" 不是平台字段：比较符是 filterType（QueryFilterType：Eq/NotEq/…，operator/op 是其别名），值用 defaultValue/options/startValue/endValue 承载。可选键：${[...LISTVIEW_CONDITION_KEYS].join(" / ")}。要"状态不等于已归档"用 {propertyCode:"status", filterType:"NotEq", defaultValue:"已归档"}`
+                            : `conditions 不支持键 "${key}"；可选键：${[...LISTVIEW_CONDITION_KEYS].join(" / ")} + 别名 operator/op`,
+                        key,
+                    });
+                }
+            }
+        }
+    }
+    const actions = args.actions;
+    if (actions !== undefined) {
+        if (!Array.isArray(actions)) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-invalid", message: "actions must be an array" });
+        }
+        const seen = new Set();
+        for (const entry of actions) {
+            const actionCode = entry?.actionCode;
+            if (typeof actionCode !== "string" || actionCode.length === 0) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-invalid", message: "actions entries require a non-empty actionCode" });
+            }
+            if (seen.has(actionCode)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-duplicate", message: `actions has duplicate actionCode ${actionCode}` });
+            }
+            seen.add(actionCode);
+            if (typeof entry.queryActionType !== "string" || !(entry.queryActionType in QUERY_ACTION_TYPE.index)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-invalid", message: `actions queryActionType must be a QueryActionType name (got ${String(entry.queryActionType)})` });
+            }
+            const defaults = ACTION_RENDER_DEFAULTS[entry.queryActionType];
+            if (!defaults && (typeof entry.name !== "string" || entry.name.length === 0 || typeof entry.icon !== "string" || entry.icon.length === 0)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-invalid", message: `actions ${actionCode} requires explicit name and icon for rendering` });
+            }
+            if (entry.associationType !== undefined && (typeof entry.associationType !== "string" || !(entry.associationType in QUERY_ACTION_RELATIVE.index))) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-invalid", message: `actions associationType must be BIZSHEET or WORKFLOW (got ${String(entry.associationType)})` });
+            }
+        }
+    }
+    if (args.presentation !== undefined) {
+        const presentation = args.presentation;
+        if (typeof presentation !== "object" || presentation === null || Array.isArray(presentation)) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-presentation-invalid", message: "presentation must be an object" });
+        }
+        validatePresentationRenderShape(presentation);
+        for (const key of PRESENTATION_FIELDS) {
+            const value = presentation[key];
+            if (value === undefined || typeof value === "string")
+                continue;
+            if (typeof value === "object" && value !== null)
+                continue;
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "listview-presentation-invalid",
+                message: `presentation.${key} must be a JSON string, object, or array (got ${typeof value})`,
+            });
+        }
+    }
+    const buttons = args.buttons;
+    if (buttons !== undefined) {
+        if (!Array.isArray(buttons)) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: "buttons must be an array" });
+        }
+        const seen = new Set();
+        for (const entry of buttons) {
+            const code = entry?.code;
+            const name = entry?.name;
+            if (typeof code !== "string" || code.length === 0) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: "buttons entries require a non-empty code" });
+            }
+            if (typeof name !== "string" || name.length === 0) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: "buttons entries require a non-empty name" });
+            }
+            if (seen.has(code)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-duplicate", message: `buttons has duplicate code ${code}` });
+            }
+            seen.add(code);
+            if (BUTTON_SYSTEM_CODES.has(code.toUpperCase())) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-system-code", message: `buttons code ${code} is a reserved system code` });
+            }
+            if (typeof entry.useLocation !== "string" || !(entry.useLocation in BUTTON_USE_LOCATION.index)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons useLocation must be LIST, FORM, or ROW (got ${String(entry.useLocation)})` });
+            }
+            if (typeof entry.bindAction !== "string" || !(entry.bindAction in BUTTON_BIND_ACTION.index)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons bindAction must be a ButtonBindAction name (got ${String(entry.bindAction)})` });
+            }
+            if (typeof entry.operateType !== "string" || !(entry.operateType in BUTTON_OPERATE_TYPE.index)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons operateType must be WITH_VIEW or WITH_OUT_VIEW (got ${String(entry.operateType)})` });
+            }
+            if (entry.showPermType !== undefined && (typeof entry.showPermType !== "string" || !(entry.showPermType in BUTTON_SHOW_PERM_TYPE.index))) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons showPermType must be a ButtonShowPermType name (got ${String(entry.showPermType)})` });
+            }
+            if (entry.actionConfig !== undefined && typeof entry.actionConfig !== "string" && (typeof entry.actionConfig !== "object" || entry.actionConfig === null || Array.isArray(entry.actionConfig))) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: "buttons actionConfig must be a JSON string or object" });
+            }
+            // Ticket 75 — the ADD_DATA/FORM target binding lives in actionConfig
+            // (schemaCodeVal + formListData + configureList); targetCode/targetObjCode
+            // are measured always-null and NOT consumed for these bind actions.
+            if (entry.bindAction === "ADD_DATA" || entry.bindAction === "FORM") {
+                if (entry.targetCode !== undefined || entry.targetObjCode !== undefined) {
+                    throw new ToolRefusalError({
+                        status: "refused",
+                        blocker: "listview-button-target-ineffective",
+                        message: `buttons ${String(entry.code)}：ADD_DATA/FORM 的目标绑定不走 targetCode/targetObjCode（实测恒 null、平台不消费）——它们只认 actionConfig（schemaCodeVal 目标模型对象 + formListData 目标表单 + configureList 数据赋值）。用高层参数 targetModel/targetForm/configureList 让工具展开，或直接给 actionConfig`,
+                    });
+                }
+                if (entry.actionConfig !== undefined) {
+                    // A JSON string is a valid wire form; for ADD_DATA/FORM it must
+                    // still decode to the authoritative sub-shape (review finding:
+                    // string actionConfig previously bypassed the key whitelist).
+                    let actionConfigObject;
+                    if (typeof entry.actionConfig === "object" && entry.actionConfig !== null) {
+                        actionConfigObject = entry.actionConfig;
+                    }
+                    else if (typeof entry.actionConfig === "string") {
+                        try {
+                            const parsed = JSON.parse(entry.actionConfig);
+                            if (parsed && typeof parsed === "object" && !Array.isArray(parsed))
+                                actionConfigObject = parsed;
+                            else
+                                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${String(entry.code)}：ADD_DATA/FORM 的 actionConfig 字符串必须解析为对象（schemaCodeVal/formListData/configureList）` });
+                        }
+                        catch (error) {
+                            if (error instanceof ToolRefusalError)
+                                throw error;
+                            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${String(entry.code)}：ADD_DATA/FORM 的 actionConfig 不是合法 JSON——解析失败（${error.message}）` });
+                        }
+                    }
+                    if (actionConfigObject) {
+                        const unknownKeys = Object.keys(actionConfigObject).filter((key) => key !== "schemaCodeVal" && key !== "formListData" && key !== "configureList");
+                        if (unknownKeys.length > 0) {
+                            throw new ToolRefusalError({
+                                status: "refused",
+                                blocker: "listview-buttons-invalid",
+                                message: `buttons ${String(entry.code)}：ADD_DATA/FORM 的 actionConfig 子形状只含 schemaCodeVal/formListData/configureList（live 抓包取证）；未知键：${unknownKeys.join("、")}`,
+                            });
+                        }
+                    }
+                }
+            }
+            validateButtonActionConfig(entry);
+            const usesExpansion = entry.targetModel !== undefined || entry.targetForm !== undefined || entry.configureList !== undefined;
+            if (usesExpansion && entry.actionConfig !== undefined) {
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "listview-buttons-invalid",
+                    message: `buttons ${String(entry.code)}：actionConfig 与 targetModel/targetForm/configureList 互斥——要么原样透传，要么让工具从读回元数据展开`,
+                });
+            }
+            if (entry.configureList !== undefined) {
+                for (const raw of entry.configureList) {
+                    const assignment = (raw && typeof raw === "object" ? raw : {});
+                    if (typeof assignment.currentDataItemId !== "string" || assignment.currentDataItemId.length === 0 || typeof assignment.targetDataItemId !== "string" || assignment.targetDataItemId.length === 0) {
+                        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${String(entry.code)}：configureList 每条需要 currentDataItemId + targetDataItemId（字段 code）` });
+                    }
+                    if (assignment.isConst !== undefined && assignment.isConst !== "false") {
+                        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${String(entry.code)}：configureList.isConst 仅 "false" 已取证（字符串）；常量赋值的值键名未取证，未实现` });
+                    }
+                    if (assignment.OptionType !== undefined && assignment.OptionType !== "Eq") {
+                        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${String(entry.code)}：configureList.OptionType（注意大写 O）仅 "Eq" 已取证` });
+                    }
+                }
+            }
+        }
+    }
+    const options = args.options;
+    if (options !== undefined && typeof options !== "string") {
+        const refuseOptions = (message, unknown) => {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-options-invalid", message, ...(unknown ? { unknown } : {}) });
+        };
+        if (typeof options !== "object" || options === null || Array.isArray(options)) {
+            refuseOptions("options must be a BizQueryOption JSON string or object");
+        }
+        const record = options;
+        const unknown = Object.keys(record).filter((key) => key !== "pagingSetting" && key !== "listViewModeSetting");
+        if (unknown.length > 0) {
+            refuseOptions(`options only supports pagingSetting and listViewModeSetting (rowColorSetting has no 8.6.26 class evidence); unknown keys: ${unknown.join(", ")}`, unknown);
+        }
+        const paging = record.pagingSetting;
+        if (paging !== undefined) {
+            if (typeof paging !== "object" || paging === null || Array.isArray(paging))
+                refuseOptions("options.pagingSetting must be an object");
+            const pagingRecord = paging;
+            const pagingUnknown = Object.keys(pagingRecord).filter((key) => key !== "pageSize" && key !== "showTotal");
+            if (pagingUnknown.length > 0)
+                refuseOptions(`options.pagingSetting only supports pageSize/showTotal; unknown keys: ${pagingUnknown.join(", ")}`, pagingUnknown);
+            const pageSize = pagingRecord.pageSize;
+            if (pageSize !== undefined && (typeof pageSize !== "number" || !Number.isInteger(pageSize) || pageSize <= 0))
+                refuseOptions("options.pagingSetting.pageSize must be a positive integer");
+            if (pagingRecord.showTotal !== undefined && typeof pagingRecord.showTotal !== "boolean")
+                refuseOptions("options.pagingSetting.showTotal must be a boolean");
+        }
+        const modeSetting = record.listViewModeSetting;
+        if (modeSetting !== undefined) {
+            if (typeof modeSetting !== "object" || modeSetting === null || Array.isArray(modeSetting))
+                refuseOptions("options.listViewModeSetting must be an object");
+            const modeRecord = modeSetting;
+            const modeUnknown = Object.keys(modeRecord).filter((key) => key !== "mode" && key !== "canSwitch");
+            if (modeUnknown.length > 0)
+                refuseOptions(`options.listViewModeSetting only supports mode/canSwitch; unknown keys: ${modeUnknown.join(", ")}`, modeUnknown);
+            if (modeRecord.mode !== undefined && (typeof modeRecord.mode !== "string" || modeRecord.mode.length === 0))
+                refuseOptions("options.listViewModeSetting.mode must be a non-empty string");
+            if (modeRecord.canSwitch !== undefined && typeof modeRecord.canSwitch !== "boolean")
+                refuseOptions("options.listViewModeSetting.canSwitch must be a boolean");
+        }
+    }
+    const presentationType = args.presentationType;
+    if (presentationType !== undefined && (typeof presentationType !== "string" || !QUERY_PRESENTATION_TYPE.names.includes(presentationType))) {
+        throw new ToolRefusalError({ status: "refused", blocker: "listview-presentation-type-invalid", message: `presentationType must be a QueryPresentationType name (LIST/BOARD/CALENDAR/GANTT), got ${String(presentationType)}` });
+    }
+    const gantt = args.gantt;
+    if (gantt !== undefined) {
+        if (typeof gantt !== "object" || gantt === null || Array.isArray(gantt)) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-gantt-invalid", message: "gantt must be a BizQueryGanttModel object" });
+        }
+        const ganttRecord = gantt;
+        const stringKeys = ["startTimePropertyCode", "endTimePropertyCode", "progressPropertyCode", "titlePropertyCode", "preDependencyPropertyCode", "endDependencyPropertyCode", "levelPropertyCode", "milepostCode", "sortKey", "liableManCode", "statusCode", "defaultPrecision"];
+        for (const key of stringKeys) {
+            if (ganttRecord[key] !== undefined && typeof ganttRecord[key] !== "string") {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-gantt-invalid", message: `gantt.${key} must be a string` });
+            }
+        }
+        if (ganttRecord.configJson !== undefined && typeof ganttRecord.configJson !== "string" && (typeof ganttRecord.configJson !== "object" || ganttRecord.configJson === null || Array.isArray(ganttRecord.configJson))) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-gantt-invalid", message: "gantt.configJson must be a JSON string or object" });
+        }
+    }
+    // BizQueryController.validateNotEmptyGantt (:1121-1136): GANTT requires the
+    // gantt model with startTime/endTime/title codes non-null.
+    if (presentationType === "GANTT") {
+        if (gantt === undefined || typeof gantt !== "object" || gantt === null) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-gantt-required", message: "presentationType GANTT requires a gantt model" });
+        }
+        const ganttRecord = gantt;
+        for (const key of ["startTimePropertyCode", "endTimePropertyCode", "titlePropertyCode"]) {
+            if (typeof ganttRecord[key] !== "string" || ganttRecord[key].length === 0) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-gantt-required", message: `presentationType GANTT requires gantt.${key}` });
+            }
+        }
+    }
+    const queryLayer = args.queryLayer;
+    if (queryLayer !== undefined) {
+        if (!Array.isArray(queryLayer)) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-query-layer-invalid", message: "queryLayer must be an array of BizQueryLayer objects" });
+        }
+        for (const entry of queryLayer) {
+            if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-query-layer-invalid", message: "queryLayer entries must be objects" });
+            }
+        }
+    }
+    const multiTableHeaderConfig = args.multiTableHeaderConfig;
+    if (multiTableHeaderConfig !== undefined && typeof multiTableHeaderConfig !== "string") {
+        if (!Array.isArray(multiTableHeaderConfig)) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-multi-table-header-invalid", message: "multiTableHeaderConfig must be a JSON string or an array of HeaderConfig objects" });
+        }
+        for (const entry of multiTableHeaderConfig) {
+            if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-multi-table-header-invalid", message: "multiTableHeaderConfig entries must be objects" });
+            }
+        }
+    }
+}
+export function findField(fieldRows, propertyCode) {
+    return fieldRows.find((row) => (row.code ?? row.propertyCode) === propertyCode);
+}
+/**
+ * cpdocs base3.0 parity (cp-query-view resolveField): a field reference may be
+ * either its propertyCode or its display name, so a caller can say「订单号」
+ * without first looking up `eq_ro_subject`. Code match wins; a name matching
+ * exactly one field resolves; a name matching several is ambiguous and refused;
+ * no match returns undefined (the caller then reports it as unknown).
+ */
+export function resolveFieldRef(fieldRows, ref) {
+    const byCode = fieldRows.find((row) => (row.code ?? row.propertyCode) === ref);
+    if (byCode)
+        return { code: String(byCode.code ?? byCode.propertyCode), field: byCode };
+    const byName = fieldRows.filter((row) => String(row.name ?? "") === ref);
+    if (byName.length > 1)
+        throw new ToolRefusalError({
+            status: "refused",
+            blocker: "listview-field-ambiguous",
+            reference: ref,
+            candidates: byName.map((row) => String(row.code ?? row.propertyCode)),
+            message: `字段引用「${ref}」在该模型上匹配到多个字段（${byName.map((row) => String(row.code ?? row.propertyCode)).join("、")}）；请改用 propertyCode`,
+        });
+    if (byName.length === 1)
+        return { code: String(byName[0].code ?? byName[0].propertyCode), field: byName[0] };
+    return undefined;
+}
+export function fieldPropertyType(field) {
+    const raw = field?.type ?? field?.propertyType;
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number(raw);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+function collectUnknown(rows, kind) {
+    const unknown = rows.flatMap((row) => row.unknown);
+    if (unknown.length > 0) {
+        throw new ToolRefusalError({
+            status: "refused",
+            blocker: `listview-${kind}-unknown-field`,
+            message: `${kind} reference fields that are not published on this schema; pass propertyType to target a field outside the published metadata`,
+            unknown,
+        });
+    }
+}
+export function normalizeSorts(sorts, fieldRows, schemaCode) {
+    const built = sorts.map((sort, index) => {
+        const resolved = resolveFieldRef(fieldRows, sort.propertyCode);
+        const field = resolved?.field;
+        const propertyCode = resolved?.code ?? sort.propertyCode;
+        const propertyType = sort.propertyType ?? fieldPropertyType(field);
+        return {
+            unknown: propertyType === undefined ? [sort.propertyCode] : [],
+            row: {
+                name: field?.name ?? null,
+                propertyCode,
+                propertyType: propertyType ?? null,
+                schemaCode,
+                direction: SORT_DIRECTION.index[sort.direction] ?? null,
+                sortKey: sort.sortKey ?? index + 1,
+                clientType: "PC",
+            },
+        };
+    });
+    collectUnknown(built, "sorts");
+    return built.map((entry) => entry.row);
+}
+export function normalizeConditions(conditions, fieldRows, schemaCode) {
+    const built = conditions.map((condition) => {
+        const resolved = resolveFieldRef(fieldRows, condition.propertyCode);
+        const field = resolved?.field;
+        const propertyType = condition.propertyType ?? fieldPropertyType(field);
+        const row = {
+            name: field?.name ?? null,
+            propertyCode: resolved?.code ?? condition.propertyCode,
+            propertyType: propertyType ?? null,
+            schemaCode,
+            clientType: "PC",
+        };
+        // filterType is the condition's OPERATOR (QueryFilterType). Accept the
+        // caller's `operator`/`op` as aliases; validate the value fail-closed (the
+        // platform parse throws on an unknown name). Default it from the same table
+        // the platform uses when omitted, so a bare control row still names its
+        // comparison instead of silently reading back as "Like".
+        const requestedFilterType = condition.filterType ?? condition.operator ?? condition.op;
+        if (requestedFilterType !== undefined && !QUERY_FILTER_TYPES.has(String(requestedFilterType)))
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "listview-condition-filtertype-invalid",
+                propertyCode: row.propertyCode,
+                value: requestedFilterType,
+                message: `conditions 的 filterType "${String(requestedFilterType)}" 不是平台 QueryFilterType；可选：${QUERY_FILTER_TYPE.join(" / ")}`,
+            });
+        row.filterType = requestedFilterType !== undefined ? String(requestedFilterType) : defaultQueryFilterType(propertyType);
+        if (condition.displayType !== undefined)
+            row.displayType = DISPLAY_TYPE.index[condition.displayType] ?? null;
+        if (condition.defaultValue !== undefined)
+            row.defaultValue = condition.defaultValue;
+        if (condition.options !== undefined)
+            row.options = encodeJsonColumn(condition.options);
+        if (condition.startValue !== undefined)
+            row.startValue = condition.startValue;
+        if (condition.endValue !== undefined)
+            row.endValue = condition.endValue;
+        if (condition.shortcutFilter !== undefined)
+            row.shortcutFilter = condition.shortcutFilter;
+        if (condition.choiceType !== undefined)
+            row.choiceType = CHOICE_TYPE.index[condition.choiceType] ?? null;
+        if (condition.dateType !== undefined)
+            row.dateType = condition.dateType;
+        if (condition.accurateSearch !== undefined)
+            row.accurateSearch = condition.accurateSearch;
+        if (condition.showNull !== undefined)
+            row.showNull = condition.showNull;
+        if (condition.includeSubData !== undefined)
+            row.includeSubData = condition.includeSubData;
+        if (condition.buildTreeBy !== undefined)
+            row.buildTreeBy = condition.buildTreeBy;
+        // A query condition IS a filter the list shows; the platform defaults an
+        // omitted `visible` to false, which hides every filter the caller asked
+        // for. Offer it shown unless the caller explicitly opts out.
+        row.visible = condition.visible ?? true;
+        return { unknown: propertyType === undefined ? [condition.propertyCode] : [], row };
+    });
+    collectUnknown(built, "conditions");
+    return built.map((entry) => entry.row);
+}
+/**
+ * Ticket 116 — designer-default icon/name per queryActionType. Evidence:
+ * native rows (h_biz_query_detail.queryConfigJson, e.g. dev_repair_record)
+ * carry an icon on EVERY action; a written row with icon:null persists green
+ * but renders the button without its icon — the same "data ok, render
+ * broken" class as tickets 109-112. Defaults apply ONLY when the caller
+ * omits the field; explicit values win.
+ */
+const ACTION_RENDER_DEFAULTS = Object.freeze({
+    ADD: { icon: "plus", name: "新增" },
+    EDIT: { icon: "edit", name: "编辑" },
+    DELETE: { icon: "delete", name: "删除" },
+    IMPORT: { icon: "upload", name: "导入" },
+    EXPORT: { icon: "download", name: "导出" },
+    BATCH_PRINT: { icon: "plus", name: "批量打印" },
+    QR_CODE: { icon: "plus", name: "打印二维码" },
+    EDITOWNER: { icon: "plus", name: "修改拥有者" },
+    IMPORT_ATTACHMENT: { icon: "upload", name: "导入附件" },
+    EXPORT_ATTACHMENT: { icon: "download", name: "导出附件" },
+    BATCH_UPDATE: { icon: "plus", name: "批量修改" },
+    BATCH_SUBMIT: { icon: "plus", name: "批量提交" },
+    COPY: { icon: "copy", name: "复制" },
+    PRINT: { icon: "print", name: "打印" },
+});
+/**
+ * The platform's own default action set for a PC LIST view, measured live on
+ * 2026-09-17 from two un-configured views (eq_repair_order, a fresh model's
+ * default view) — identical 11 rows in both. `defaultActions:true` seeds a
+ * merge with this set so a view that already lost its buttons (by an earlier
+ * `actions` replace) gets 新增/导入/导出 back.
+ */
+export const PLATFORM_DEFAULT_LIST_ACTIONS = Object.freeze([
+    { actionCode: "add", queryActionType: "ADD" },
+    { actionCode: "delete", queryActionType: "DELETE" },
+    { actionCode: "batch_update", queryActionType: "BATCH_UPDATE" },
+    { actionCode: "batch_submit", queryActionType: "BATCH_SUBMIT" },
+    { actionCode: "import", queryActionType: "IMPORT" },
+    { actionCode: "export", queryActionType: "EXPORT" },
+    { actionCode: "batch_print", queryActionType: "BATCH_PRINT" },
+    { actionCode: "qr_code", queryActionType: "QR_CODE" },
+    { actionCode: "editowner", queryActionType: "EDITOWNER" },
+    { actionCode: "import_attachment", queryActionType: "IMPORT_ATTACHMENT" },
+    { actionCode: "export_attachment", queryActionType: "EXPORT_ATTACHMENT" },
+]);
+/**
+ * Merge caller actions into a base set by actionCode (existing rows keep their
+ * platform fields, caller fields win) and append the rest. Live 2026-09-17:
+ * `queryActions` is REPLACE, not merge — the platform deletes every stored
+ * action and re-adds the submitted list, so passing one action used to drop
+ * the built-in 新增/删除/导入/导出 and the form rendered with no Add button.
+ * Order = base order then appended; the platform resets sortKey to i+1.
+ */
+export function mergeActions(base, incoming) {
+    const merged = [];
+    const indexOf = new Map();
+    for (const row of base) {
+        const key = String(row.actionCode ?? "");
+        if (key === "" || indexOf.has(key))
+            continue;
+        indexOf.set(key, merged.length);
+        merged.push({ ...row });
+    }
+    for (const action of incoming) {
+        const key = String(action.actionCode ?? "");
+        const at = indexOf.get(key);
+        if (at !== undefined)
+            merged[at] = { ...merged[at], ...action };
+        else {
+            indexOf.set(key, merged.length);
+            merged.push({ ...action });
+        }
+    }
+    return merged;
+}
+export function normalizeActions(actions, schemaCode) {
+    return actions.map((action, index) => {
+        // Ticket 116: render-fidelity defaults for the evidenced action families.
+        const renderDefault = ACTION_RENDER_DEFAULTS[action.queryActionType];
+        const row = {
+            actionCode: action.actionCode,
+            queryActionType: QUERY_ACTION_TYPE.index[action.queryActionType] ?? null,
+            sortKey: action.sortKey ?? index + 1,
+            clientType: "PC",
+            schemaCode,
+        };
+        row.name = action.name ?? renderDefault?.name;
+        row.icon = action.icon ?? renderDefault?.icon;
+        if (row.name === undefined || row.icon === undefined) {
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-actions-invalid", message: `action ${action.actionCode} (${action.queryActionType}) requires name and icon for rendering` });
+        }
+        if (action.systemAction !== undefined)
+            row.systemAction = action.systemAction;
+        if (action.serviceCode !== undefined)
+            row.serviceCode = action.serviceCode;
+        if (action.serviceMethod !== undefined)
+            row.serviceMethod = action.serviceMethod;
+        if (action.customService !== undefined)
+            row.customService = action.customService;
+        if (action.associationCode !== undefined)
+            row.associationCode = action.associationCode;
+        if (action.associationType !== undefined)
+            row.associationType = QUERY_ACTION_RELATIVE.index[action.associationType] ?? null;
+        return row;
+    });
+}
+/**
+ * `buttons` -> the `customButtonJson` update-body field (a JSON array string).
+ * `BizButtonFacadeImpl.addBizButtonList(String,...)` (:112-137) forces
+ * schemaCode/triggerType(QUERY)/triggerCode(view code), sets sortKey to the
+ * array index, rejects duplicate `schemaCode.code` and reserved system codes.
+ * Enum fields are sent as their `IStringEnum` names (no `@JsonValue`).
+ */
+export function normalizeButtons(buttons, schemaCode, triggerCode) {
+    return buttons.map((button, index) => {
+        const row = {
+            schemaCode,
+            name: button.name,
+            code: button.code,
+            triggerType: "QUERY",
+            triggerCode,
+            useLocation: button.useLocation,
+            bindAction: button.bindAction,
+            operateType: button.operateType,
+            sortKey: index,
+        };
+        if (button.showPermCode !== undefined)
+            row.showPermCode = button.showPermCode;
+        if (button.showPermType !== undefined)
+            row.showPermType = button.showPermType;
+        if (button.hint !== undefined)
+            row.hint = button.hint;
+        if (button.targetCode !== undefined)
+            row.targetCode = button.targetCode;
+        if (button.targetObjCode !== undefined)
+            row.targetObjCode = button.targetObjCode;
+        if (button.description !== undefined)
+            row.description = button.description;
+        // BizButtonModel.actionConfig is a non-null String on the render path. The
+        // list runtime does `"string"==typeof a ? JSON.parse(a) : a`, then for
+        // FORM/ADD_DATA/FLOW it ITERATES `a.configureList` — so both a null
+        // (configureList on null) and a config without the array
+        // ("undefined is not iterable") blank the click. Emit an empty
+        // configureList for those three bind actions and `{}` otherwise.
+        const needsConfigureList = button.bindAction === "FLOW" || button.bindAction === "ADD_DATA" || button.bindAction === "FORM";
+        row.actionConfig = encodeJsonColumn(button.actionConfig ?? (needsConfigureList ? { configureList: [] } : {}));
+        return row;
+    });
+}
+/** condition options / presentation / gantt configJson decode; policy: non-strings null-coalesce, unparseable passes through. */
+export function parseConditionOptions(value) {
+    return decodeJsonColumn(value, JSON_COLUMN_NULL_COALESCE);
+}
+/**
+ * `presentation` replaces the whole queryPresentation (saveBizQueryDetail
+ * removes every presentation whose clientType matches before re-adding), so a
+ * provided object sends exactly its fields; clientType is forced to PC (the
+ * controller overwrites it). JSON-ish fields are stringified for the wire.
+ */
+export function normalizePresentation(presentation) {
+    const row = { clientType: "PC" };
+    for (const key of PRESENTATION_FIELDS) {
+        const value = presentation[key];
+        if (value !== undefined)
+            row[key] = encodeJsonColumn(value);
+    }
+    return row;
+}
+export function decodePresentation(row) {
+    const out = { clientType: row.clientType ?? null };
+    for (const key of PRESENTATION_FIELDS)
+        out[key] = parseConditionOptions(row[key]);
+    return out;
+}
+export const GANTT_FIELDS = ["startTimePropertyCode", "endTimePropertyCode", "progressPropertyCode", "titlePropertyCode", "preDependencyPropertyCode", "endDependencyPropertyCode", "levelPropertyCode", "milepostCode", "sortKey", "configJson", "liableManCode", "statusCode", "defaultPrecision"];
+/**
+ * `gantt` -> the query/update body `queryGanttModel`. The tool supplies
+ * schemaCode; queryId is set by BizQueryDetailServiceImpl.saveBizQueryDetail
+ * (:179-181). configJson is a JSON string field (object stringified).
+ */
+export function normalizeGantt(gantt, schemaCode) {
+    const row = { schemaCode };
+    for (const key of GANTT_FIELDS) {
+        const value = gantt[key];
+        if (value !== undefined)
+            row[key] = key === "configJson" ? encodeJsonColumn(value) : value;
+    }
+    return row;
+}
+export function decodeGantt(row) {
+    const out = { queryId: row.queryId ?? null, schemaCode: row.schemaCode ?? null };
+    for (const key of GANTT_FIELDS)
+        out[key] = key === "configJson" ? parseConditionOptions(row[key]) : row[key] ?? null;
+    return out;
+}
+export function decodeSortRow(row) {
+    return {
+        propertyCode: row.propertyCode ?? null,
+        propertyType: row.propertyType ?? null,
+        direction: decodeWireEnum(SORT_DIRECTION, row.direction),
+        sortKey: row.sortKey ?? null,
+        clientType: row.clientType ?? null,
+    };
+}
+export function decodeConditionRow(row) {
+    return {
+        propertyCode: row.propertyCode ?? null,
+        propertyType: row.propertyType ?? null,
+        displayType: decodeWireEnum(DISPLAY_TYPE, row.displayType),
+        // The condition's operator (QueryFilterType); it serializes as a NAME STRING
+        // (no @JsonValue), so pass it through verbatim (live proof: filterType:"Like").
+        filterType: row.filterType ?? null,
+        defaultValue: row.defaultValue ?? null,
+        options: parseConditionOptions(row.options),
+        startValue: row.startValue ?? null,
+        endValue: row.endValue ?? null,
+        shortcutFilter: row.shortcutFilter ?? null,
+        choiceType: decodeWireEnum(CHOICE_TYPE, row.choiceType),
+        dateType: row.dateType ?? null,
+        accurateSearch: row.accurateSearch ?? null,
+        showNull: row.showNull ?? null,
+        includeSubData: row.includeSubData ?? null,
+        buildTreeBy: row.buildTreeBy ?? null,
+        visible: row.visible ?? null,
+    };
+}
+export function readArray(model, key) {
+    const value = model[key];
+    return Array.isArray(value) ? value : [];
+}
+export function decodeActionRow(row) {
+    const type = row.queryActionType;
+    const association = row.associationType ?? row.queryActionRelativeType;
+    return {
+        actionCode: row.actionCode ?? null,
+        name: row.name ?? null,
+        icon: row.icon ?? null,
+        queryActionType: decodeWireEnum(QUERY_ACTION_TYPE, type),
+        systemAction: row.systemAction ?? null,
+        serviceCode: row.serviceCode ?? null,
+        serviceMethod: row.serviceMethod ?? null,
+        customService: row.customService ?? null,
+        associationCode: row.associationCode ?? row.relativeCode ?? null,
+        associationType: decodeWireEnum(QUERY_ACTION_RELATIVE, association),
+        sortKey: row.sortKey ?? null,
+        clientType: row.clientType ?? null,
+    };
+}
+export function decodeButtonRow(row) {
+    return {
+        schemaCode: row.schemaCode ?? null,
+        name: row.name ?? null,
+        code: row.code ?? null,
+        triggerCode: row.triggerCode ?? null,
+        triggerType: decodeWireEnum(BUTTON_TRIGGER_TYPE, row.triggerType),
+        showPermCode: row.showPermCode ?? null,
+        showPermType: decodeWireEnum(BUTTON_SHOW_PERM_TYPE, row.showPermType),
+        hint: row.hint ?? null,
+        targetCode: row.targetCode ?? null,
+        targetObjCode: row.targetObjCode ?? null,
+        useLocation: decodeWireEnum(BUTTON_USE_LOCATION, row.useLocation),
+        bindAction: decodeWireEnum(BUTTON_BIND_ACTION, row.bindAction),
+        operateType: decodeWireEnum(BUTTON_OPERATE_TYPE, row.operateType),
+        description: row.description ?? null,
+        actionConfig: parseConditionOptions(row.actionConfig),
+        sortKey: row.sortKey ?? null,
+    };
+}
+//# sourceMappingURL=list-view-shapes.js.map