omc-core 0.4.36 → 0.4.38

package/dist/capability-shape.js

@@ -0,0 +1,154 @@
+export const CAPABILITY_CONTROL_TYPES = Object.freeze({
+    0: 1,
+    1: 2,
+    2: 4,
+    3: 3,
+    4: 8,
+    5: 62,
+    6: 9,
+    8: 201,
+    9: 80,
+    10: 14,
+    11: 81,
+    12: 5,
+    13: 6,
+    14: 7,
+    15: 19,
+    16: 82,
+    17: 17,
+    28: 28,
+    50: 50,
+    51: 51,
+    60: 60,
+    61: 61,
+    100: 89,
+});
+const commonEvidence = [
+    "8.6.26 BizPropertyType/BizFormPropertyType",
+    "desensitized-config-shapes.md §3.2",
+    "frontend-dist/admin/js/4280.*.js designer bundle",
+];
+const shape = (propertyType, field, control, evidence = commonEvidence) => ({ propertyType, controlType: CAPABILITY_CONTROL_TYPES[propertyType], field, control, evidence });
+const face = (requiredKeys, defaults, evidence = commonEvidence, nonEmptyKeys) => ({ requiredKeys, defaults, evidence, ...(nonEmptyKeys ? { nonEmptyKeys } : {}) });
+export const FIELD_CAPABILITY_SHAPES = Object.freeze({
+    0: shape(0, face([], { dictionaryData: "" }), face(["defaultValue", "maxLength"], { defaultValue: null, placeholder: "请输入", maxLength: 200, currentMaxLength: 2000000, noRepeat: false, enableEncrypt: false })),
+    1: shape(1, face([], { dictionaryData: "" }), face(["defaultValue", "maxLength"], { defaultValue: null, textAreaType: "longText", maxLength: 2000, placeholder: "请输入" })),
+    2: shape(2, face([], { dictionaryData: "" }), face(["defaultValue", "format"], { defaultValue: null, placeholder: "请输入", computeFormula: "", format1: "decimal", format: "decimal", verifyFormula: "", isFlag: false })),
+    3: shape(3, face(["format"], { dictionaryData: "", format: "YYYY-MM-DD" }), face(["format", "format1"], { defaultValue: null, dataItemDefault: "", format1: "YYYY-MM-DD", format: "YYYY-MM-DD", minDate: "", maxDate: "", verifyFormula: "" })),
+    4: shape(4, face(["defaultValue"], { defaultValue: false }), face(["defaultValue"], { defaultValue: true })),
+    6: shape(6, face([], {}), face(["displayTemplate", "limitNumber", "fileNumber", "batch"], { displayTemplate: true, limitNumber: "unlimited", fileNumber: 1, batch: true, displayFormula: "", requiredFormula: "", readonlyFormula: false, limit: "200M", onUpload: "", onDelete: "" }), ["cp-sources/frontend-dist/admin/js/12404.1675d362.js attachment schema", "cp-sources/frontend-dist/admin/js/24187.6e75bd30.js uploadOptions/baseUploadOptions"]),
+    // CHILD_TABLE(8) — scalar child table. Lifted from blocked on 2026-09-18:
+    // the wire shape is live-accepted (omc-core `childtable-field-contract.ts`,
+    // live record `childtable-execute-20260908070635135.md`, 2026-09-08) and the
+    // Sheet201 form control is live-proven (omc-core
+    // `childtable-sheet201-contract.ts`). The field row carries no `options`; its
+    // definition is the `subSchema` ({code:<parent field code>, properties:[...]})
+    // and the form control is Sheet(201) with `columns`. Nested CHILD_TABLE (a
+    // child of a child) remains out of coverage and is refused in
+    // `assertFieldFamilyAllowed`.
+    8: shape(8, face([], {}), face([], {}), ["omc-core childtable-field-contract.ts (live 2026-09-08)", "omc-core childtable-sheet201-contract.ts", "8.6.26 BizPropertyType CHILD_TABLE=8 / BizFormPropertyType Sheet=201"]),
+    9: shape(9, face([], { dictionaryData: "" }), face([], { schemaCode: "", displayField: "name", relativePropertyMatchCode: "name", queryCode: "", linkMode: true, showStyle: "", selectMode: "popup", isAuthorize: true, treeView: false, treeStartFromRoot: false, mappings: "", searchFormula: "", conditions: "" })),
+    10: shape(10, face(["defaultValue"], { defaultValue: "" }), face(["locationType", "addressDetail", "showEmpty", "emptyValue", "autoGetLocation"], { locationType: "pp-cc-aa", addressDetail: "true", showEmpty: "false", emptyValue: "请选择", autoGetLocation: "false" }), [".scratch/omc-app-management/research/desensitized-config-shapes.md §3.2 ADDRESS", "cp-sources/frontend-dist/admin/js/12404.1675d362.js address schema", ".scratch/omc-app-management/evidence/field-families-fwb-20260914.md:113-119 (fwb field row {\"defaultValue\":\"\",\"virtualField\":false})"]),
+    11: shape(11, face([], { dictionaryData: "" }), face([], { schemaCode: "", displayField: "name", relativePropertyMatchCode: "name", queryCode: "", linkMode: true, showStyle: "", selectMode: "popup", isAuthorize: true, treeView: false, treeStartFromRoot: false, mappings: "", searchFormula: "", conditions: "" })),
+    // Ticket 108 determination: selection families (12/13/14/15) emit NO
+    // dictionaryData — designer-produced rows carry none of it (fwb §12-15
+    // outer key unions) and live 8.6.26 proves the platform merely
+    // accepts-and-persists the extra key without requiring it. The other
+    // text/date/relation families keep the designer-carried empty-string
+    // default; ATTACHMENT(6) stays intentionally empty (system rows often
+    // have no options). The wider 2026-09-14 key unions are multi-field
+    // unions of designer rows — platform auto-fill territory, never required
+    // for creation (minimal default + caller passthrough is the boundary).
+    12: shape(12, face([], {}), face([], { defaultValue: "", options: "", hasLabel: false })),
+    13: shape(13, face([], {}), face([], { defaultValue: "", options: "", hasLabel: false, direction: "horizontal", displaySetting: "showSelected" })),
+    14: shape(14, face([], {}), face([], { displayEmpty: true, emptyValue: "请选择", multi: false })),
+    15: shape(15, face([], {}), face([], { displayEmpty: true, emptyValue: "请选择", multi: true })),
+    16: shape(16, face([], { dictionaryData: "" }), face([], {})),
+    17: shape(17, face(["defaultValue", "dictionaryData", "maxLength"], { defaultValue: "", dictionaryData: "", maxLength: 200 }), face(["defaultValue", "placeholder", "maxLength"], { defaultValue: "", placeholder: "请输入", maxLength: 200 }), [".scratch/omc-app-management/research/desensitized-config-shapes.md §3.2 HYPER_LINK", "cp-sources/frontend-dist/admin/js/12404.1675d362.js URL schema"]),
+    28: shape(28, face(["format"], { defaultValue: "", format: "HH:mm" }), face(["format", "format1"], { defaultValue: "none", dataItemDefault: "", format: "HH:mm", format1: "HH:mm", syncFormate: true }), [".scratch/omc-app-management/research/desensitized-config-shapes.md §3.2 TIME", "cp-sources/frontend-dist/admin/js/46948.4825f4e2.js Time1760153573819"]),
+    // Org-selector families. Evidence: the yst/fwb published-face dumps
+    // (origin/research/yst-examples, 2656 rows of types 5/50/51/60/61) show the
+    // FIELD row (bizproperty) options as null or `{defaultValue, mappings,
+    // virtualField, noRepeat}` — deptVisible/multi NEVER appear there. The
+    // deptVisible/multi discriminator is FORM-CONTROL-face only (source:
+    // DataModelInitUtils.updateSelectionType / BizPropertyTypeUpdateUtils.
+    // disposeUpdateType read `control.options`; ticket 69 already writes them on
+    // the control face). Field faces below mirror the observed publish-safe
+    // shapes (single: defaultValue ""; multi: defaultValue []).
+    5: shape(5, face([], { defaultValue: [], mappings: "", virtualField: false }), face(["defaultValue", "deptVisible", "multi"], { defaultValue: [], defaultValueType: "", deptVisible: "all", multi: "true" })),
+    50: shape(50, face([], { defaultValue: "", mappings: "", virtualField: false }), face(["deptVisible", "multi"], { deptVisible: "user", multi: "false" })),
+    51: shape(51, face([], { defaultValue: [], mappings: "", virtualField: false }), face(["deptVisible", "multi"], { deptVisible: "user", multi: "true" })),
+    60: shape(60, face([], { defaultValue: [], mappings: "", virtualField: false }), face(["deptVisible", "multi"], { deptVisible: "org", multi: "false" })),
+    61: shape(61, face([], { defaultValue: [], mappings: "", virtualField: false }), face(["deptVisible", "multi"], { deptVisible: "org", multi: "true" })),
+    100: shape(100, face([], {}), face([], { defaultValue: null })),
+});
+export const BLOCKED_CAPABILITY_SHAPES = Object.freeze({});
+/**
+ * Ticket 101 — control codes observed in real forms but with NO field-family
+ * emission path. PHONE(24) and PHOTO(10) are authoritative 8.6.26 control
+ * codes (BizFormPropertyType.java:23-51), but BizPropertyType.java:27-54 has
+ * no PHONE/PHOTO entry, so no accepted field family can scaffold them and no
+ * options shape is evidenced for a write. Declared blocked so the absence
+ * reads as policy (fail-closed), not omission; caller-provided explicit
+ * layouts are unaffected. Adding an emission path requires new family
+ * evidence AND consciously lifting this declaration.
+ */
+export const BLOCKED_CONTROL_CODES = Object.freeze({
+    24: "PHONE control has no BizPropertyType mapping (BizPropertyType.java:27-54) — no field family emits it; creation not offered until a family + options shape are evidenced",
+    10: "PHOTO control has no BizPropertyType mapping (BizPropertyType.java:27-54) — no field family emits it; creation not offered until a family + options shape are evidenced",
+});
+export const CAPABILITY_SHAPE_ACCEPTED_TYPES = Object.freeze(Object.keys(FIELD_CAPABILITY_SHAPES).map(Number));
+export function capabilityShapeFor(type) {
+    return FIELD_CAPABILITY_SHAPES[type] ?? BLOCKED_CAPABILITY_SHAPES[type];
+}
+export function capabilityShapeError(type, faceName, options) {
+    const current = capabilityShapeFor(type);
+    if (!current)
+        return `propertyType ${type} has no capability shape`;
+    if (current.blocked)
+        return `${current.citation ?? "blocked capability"} (propertyType ${type})`;
+    const face = current[faceName];
+    const missing = face.requiredKeys.filter((key) => options[key] === undefined || ((face.nonEmptyKeys ?? []).includes(key) && options[key] === ""));
+    return missing.length > 0 ? `capability shape ${faceName} missing required keys for propertyType ${type}: ${missing.join(", ")}` : undefined;
+}
+export function assertCapabilityShapeContract() {
+    for (const type of CAPABILITY_SHAPE_ACCEPTED_TYPES) {
+        const current = FIELD_CAPABILITY_SHAPES[type];
+        if (!current)
+            throw new Error(`capability shape missing for propertyType ${type}`);
+        if (current.blocked && !current.citation)
+            throw new Error(`blocked capability shape ${type} requires citation`);
+        if (current.controlType !== CAPABILITY_CONTROL_TYPES[type])
+            throw new Error(`capability shape control type mismatch for ${type}`);
+        for (const key of current.field.requiredKeys)
+            if (!(key in current.field.defaults))
+                throw new Error(`field shape ${type} missing default for ${key}`);
+        for (const key of current.control.requiredKeys)
+            if (!(key in current.control.defaults))
+                throw new Error(`control shape ${type} missing default for ${key}`);
+    }
+}
+export function assertCapabilityFace(type, faceName, options) {
+    const current = capabilityShapeFor(type);
+    if (!current)
+        throw new Error(`capability shape missing for propertyType ${type}`);
+    if (current.blocked)
+        throw new Error(`propertyType ${type} is blocked: ${current.citation ?? "missing evidence"}`);
+    const face = current[faceName];
+    const missing = face.requiredKeys.filter((key) => options[key] === undefined || ((face.nonEmptyKeys ?? []).includes(key) && options[key] === ""));
+    if (missing.length > 0)
+        throw new Error(`capability shape ${faceName} missing required keys for propertyType ${type}: ${missing.join(", ")}`);
+}
+export function deriveFieldOptions(type, explicit) {
+    const current = capabilityShapeFor(type);
+    if (!current || current.blocked)
+        throw new Error(`propertyType ${type} is blocked or has no capability shape`);
+    return { ...current.field.defaults, ...(explicit ?? {}) };
+}
+export function deriveControlOptions(type, explicit) {
+    const current = capabilityShapeFor(type);
+    if (!current || current.blocked)
+        throw new Error(`propertyType ${type} is blocked or has no capability shape`);
+    return { ...current.control.defaults, ...(explicit ?? {}) };
+}
+//# sourceMappingURL=capability-shape.js.map

package/dist/childtable-sheet201-contract.js

@@ -1,5 +1,5 @@
 import { buildChildTableDeleteRequest, buildSheetControlBinding } from "./childtable-field-contract.js";
-import { ticket11ScaffoldControlKeys, buildTicket11ScaffoldControls, ticket11DraftLayoutIsEmpty } from "./ticket11-test-form-draft.js";
+import { ticket11ScaffoldControlKeys, buildTicket11ScaffoldControls, ticket11DraftLayoutIsEmpty } from "./form-scaffold-contract.js";
 export const CHILD_TABLE_SHEET201_ENDPOINTS = Object.freeze({
     fieldPublish: "/api/api/app/bizproperty/publish",
     formGet: "/api/api/app/bizsheet/get",

package/dist/field-probe-runner-contract.js

@@ -1,6 +1,6 @@
 import { CHILD_TABLE_CONTRACT } from "./childtable-field-contract.js";
 import { FORMULA_FIELD_CONTRACT } from "./formula-field-contract.js";
-import { ticket08TargetSchemaCode, isTicket08TargetSchema } from "./ticket08-test-model-mutation.js";
+import { ticket08TargetSchemaCode, isTicket08TargetSchema } from "./field-probe-schema.js";
 export const FIELD_PROBE_MODES = Object.freeze(["rehearsal", "execute"]);
 export const FIELD_PROBE_KINDS = Object.freeze(["formula", "childtable"]);
 export const FIELD_PROBE_PHASES = Object.freeze(["field-create", "publish", "controls"]);

package/dist/field-probe-schema.js

@@ -0,0 +1,19 @@
+/**
+ * 字段探针目标模型 schema 契约（生产）：omc_t08_<16hex> 生成/识别/断言。
+ * 原实现住在 ticket08 测试编排内；C2-lite 拆分——field-probe-runner 与测试岛屿共用。
+ */
+import { randomUUID } from "node:crypto";
+export const TICKET08_TARGET_SCHEMA_PATTERN = /^omc_t08_[0-9a-f]{16}$/;
+const TICKET08_SCHEMA_CODE_PREFIX = "omc_t08_";
+export function ticket08TargetSchemaCode() {
+    return `${TICKET08_SCHEMA_CODE_PREFIX}${randomUUID().replaceAll("-", "").slice(0, 16)}`;
+}
+export function isTicket08TargetSchema(targetSchemaCode) {
+    return TICKET08_TARGET_SCHEMA_PATTERN.test(targetSchemaCode);
+}
+export function assertTicket08TargetSchema(targetSchemaCode) {
+    if (!isTicket08TargetSchema(targetSchemaCode))
+        throw new Error("Ticket 08 targetSchemaCode must be a host-scoped omc_t08_<16-hex> schema within the CloudPivot 8.6.26 26-character code contract.");
+    return targetSchemaCode;
+}
+//# sourceMappingURL=field-probe-schema.js.map

package/dist/form-scaffold-contract.js

@@ -0,0 +1,126 @@
+/**
+ * 表单脚手架契约（生产）：默认表单 Title/系统行/Group 三行脚手架的构建与解码。
+ * 原实现住在 ticket11 测试编排内；C2-lite 拆分——生产消费者
+ * （formula-controls / childtable-sheet201 契约）与测试岛屿共用此唯一事实源。
+ */
+export const TICKET11_SCAFFOLD_SYSTEM_ROW = Object.freeze(["creater", "createdTime", "sequenceNo"]);
+export const TICKET11_SCAFFOLD_SYSTEM_CONTROL_TYPES = Object.freeze({ creater: 101, createdTime: 104, sequenceNo: 100 });
+/** The UID rule value is a designer/composer constant, not a per-model scheme reference (research §13.2). */
+export const TICKET11_SCAFFOLD_SEQNO_UID_VALUE = "aa860e64ff2e4f86851a661d663ae358";
+export const TICKET11_SCAFFOLD_GROUP_NAME = "业务标题";
+export const TICKET11_SCAFFOLD_DATE_FORMAT = "YYYY-MM-DD HH:mm:ss";
+/** One shared timestamp per composition mirrors the designer's Title<ts>/Group<ts> pattern (research §13.4). */
+export function ticket11ScaffoldControlKeys(capturedAt) {
+    const epochMs = Date.parse(capturedAt);
+    if (!Number.isFinite(epochMs) || epochMs <= 0)
+        throw new Error("Ticket 11 scaffold composition requires the evidence capture clock; nothing ships on guessed layout keys.");
+    return Object.freeze({ titleKey: `Title${epochMs}`, groupKey: `Group${epochMs}` });
+}
+function deepFrozen(value) {
+    if (Array.isArray(value))
+        return Object.freeze(value.map(deepFrozen));
+    if (value && typeof value === "object")
+        return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, item]) => [key, deepFrozen(item)])));
+    return value;
+}
+/** The designer-standard scaffolding control map entries, mirroring the live agent_test_customer sample member-for-member (research §13.1). Deep-frozen: the composition is an immutable contract value. */
+export function buildTicket11ScaffoldControls(input) {
+    return deepFrozen({
+        [input.titleKey]: {
+            key: input.titleKey,
+            type: 203,
+            options: {
+                name: input.formName,
+                name_i18n: { en: input.formName, zh: input.formName },
+                visible: true,
+                labelVisible: true,
+                span: 24,
+                labelAlign: "",
+                style: "",
+                tips: "",
+                dataItemName: "",
+                useDataTitle: true,
+                styleInfo: { height: 1, bgColor: "#ffffff", bgImg: "", textAlign: "center", fontSize: 28, textColor: "#111218", blod: true, italic: false, textCss: "", textCssSwitch: false },
+            },
+        },
+        creater: {
+            key: "creater",
+            type: TICKET11_SCAFFOLD_SYSTEM_CONTROL_TYPES.creater,
+            options: { name: "创建人", name_i18n: "", visible: true, labelVisible: true, span: 8, labelAlign: "", style: "", tips: "", dataItemName: "", widgetType: "", dataItemType: "", mappings: "", verifyFormula: "", defaultValue: "" },
+        },
+        createdTime: {
+            key: "createdTime",
+            type: TICKET11_SCAFFOLD_SYSTEM_CONTROL_TYPES.createdTime,
+            options: { name: "创建时间", name_i18n: "", visible: true, labelVisible: true, span: 8, labelAlign: "", style: "", tips: "", dataItemName: "", widgetType: "", dataItemType: "", format1: TICKET11_SCAFFOLD_DATE_FORMAT, format: TICKET11_SCAFFOLD_DATE_FORMAT, syncFormate: true, verifyFormula: "", defaultValue: "" },
+        },
+        sequenceNo: {
+            key: "sequenceNo",
+            type: TICKET11_SCAFFOLD_SYSTEM_CONTROL_TYPES.sequenceNo,
+            options: { name: "单据号", name_i18n: "", visible: true, labelVisible: true, span: 8, labelAlign: "", style: "", tips: "", dataItemName: "", widgetType: "", dataItemType: "", seqNoSetting: [{ type: "UID", value: TICKET11_SCAFFOLD_SEQNO_UID_VALUE }], formPropertyType: 100, verifyFormula: "", displayFormula: "", defaultValue: "" },
+        },
+        [input.groupKey]: {
+            key: input.groupKey,
+            type: 200,
+            options: { name: TICKET11_SCAFFOLD_GROUP_NAME, tips: "", expand: true, align: "", style: "", styleInfo: { fontSize: 18, textColor: "#111218", blod: true, italic: false, textCss: "", textCssSwitch: false }, span: 24 },
+        },
+    });
+}
+/** An auto-created default form decodes with an empty draft layout (research §2): draftViewJson null/[] and draftAttributesJson null/{}. */
+export function ticket11DraftLayoutIsEmpty(form) {
+    let view = null;
+    let attributes = null;
+    try {
+        view = form.draftViewJson === null ? [] : JSON.parse(form.draftViewJson);
+        attributes = form.draftAttributesJson === null ? {} : JSON.parse(form.draftAttributesJson);
+    }
+    catch {
+        return false;
+    }
+    return Array.isArray(view) && view.length === 0 && typeof attributes === "object" && attributes !== null && !Array.isArray(attributes) && Object.keys(attributes).length === 0;
+}
+export function decodeTicket11ScaffoldPresence(form) {
+    if (form.draftViewJson === null || form.draftAttributesJson === null)
+        return { decodable: false, rowOrderMatchesContract: false };
+    let view;
+    let attributes;
+    try {
+        view = JSON.parse(form.draftViewJson);
+        attributes = JSON.parse(form.draftAttributesJson);
+    }
+    catch {
+        return { decodable: false, rowOrderMatchesContract: false };
+    }
+    if (!Array.isArray(view) || view.some((row) => !Array.isArray(row) || row.some((key) => typeof key !== "string")) || !attributes || typeof attributes !== "object" || Array.isArray(attributes))
+        return { decodable: false, rowOrderMatchesContract: false };
+    const rows = view;
+    const map = attributes;
+    const entry = (key) => {
+        const value = map[key];
+        return value && typeof value === "object" && !Array.isArray(value) && typeof value.type === "number" && value.options && typeof value.options === "object"
+            ? value
+            : undefined;
+    };
+    // The row contract is positional (research §13.5): row 0 is the single-key
+    // Title row, row 1 is exactly the system row, row 2 is the single-key Group
+    // row. Extra or duplicated scaffold rows decode as non-contract.
+    const isTitleKey = (key) => /^Title\d+$/.test(key);
+    const isGroupKey = (key) => /^Group\d+$/.test(key);
+    const titleShaped = rows.length >= 3 && rows[0].length === 1 && isTitleKey(rows[0][0]) && entry(rows[0][0]) !== undefined;
+    const systemShaped = rows.length >= 3 && rows[1].length === 3 && rows[1][0] === "creater" && rows[1][1] === "createdTime" && rows[1][2] === "sequenceNo";
+    const groupShaped = rows.length >= 3 && rows[2].length === 1 && isGroupKey(rows[2][0]) && entry(rows[2][0]) !== undefined;
+    if (!titleShaped || !systemShaped || !groupShaped)
+        return { decodable: false, rowOrderMatchesContract: false };
+    const title = entry(rows[0][0]);
+    const group = entry(rows[2][0]);
+    const systemTypes = rows[1].map((key) => entry(key)?.type ?? -1);
+    const scaffoldRowsOnly = rows.slice(0, 3).every((row, index) => index === 0 ? row.length === 1 && isTitleKey(row[0] ?? "") : index === 1 ? row.length === 3 : row.length === 1 && isGroupKey(row[0] ?? "")) && rows.slice(3).every((row) => row.length === 0 || (!isTitleKey(row[0] ?? "") && !isGroupKey(row[0] ?? "") && row[0] !== "creater" && row[0] !== "createdTime" && row[0] !== "sequenceNo"));
+    return Object.freeze({
+        decodable: true,
+        title: Object.freeze({ key: rows[0][0], type: title.type, useDataTitle: title.options.useDataTitle === true, name: title.options.name }),
+        systemRow: Object.freeze({ keys: Object.freeze([...rows[1]]), types: Object.freeze(systemTypes) }),
+        group: Object.freeze({ key: rows[2][0], type: group.type }),
+        rowOrder: Object.freeze(rows.map((row) => row.join("+"))),
+        rowOrderMatchesContract: scaffoldRowsOnly,
+    });
+}
+//# sourceMappingURL=form-scaffold-contract.js.map

package/dist/formula-controls-contract.js

@@ -1,6 +1,6 @@
 import { decodeDraftControl } from "./cloudpivot-low-code.js";
 import { buildFormulaFieldDeleteRequest } from "./formula-field-contract.js";
-import { buildTicket11ScaffoldControls, decodeTicket11ScaffoldPresence, ticket11DraftLayoutIsEmpty, ticket11ScaffoldControlKeys } from "./ticket11-test-form-draft.js";
+import { buildTicket11ScaffoldControls, decodeTicket11ScaffoldPresence, ticket11DraftLayoutIsEmpty, ticket11ScaffoldControlKeys } from "./form-scaffold-contract.js";
 export const FORMULA_CONTROL_TYPE = 89;
 export const FORMULA_FORM_DRAFT_ENDPOINT = "/api/api/app/bizsheet/update";
 export const FORMULA_FORM_PUBLISH_ENDPOINT = "/api/api/app/bizsheet/publish";

package/dist/index.js

@@ -1,3 +1,10 @@
+export * from "./zip.js";
+export * from "./capability-shape.js";
+export * from "./json-column.js";
+export * from "./refusal.js";
+export * from "./wire-facts.js";
+export * from "./relation-shape.js";
+export * from "./list-view-wire.js";
 export * from "./ordinary-synthesis-router.js";
 export * from "./cloudpivot-adapter.js";
 export * from "./cloudpivot-fingerprints.js";

package/dist/json-column.js

@@ -0,0 +1,68 @@
+/**
+ * Ticket 52 — one explicit home for "a platform JSON column may arrive as a
+ * string (or an object)" decoding/encoding. Previously every lane carried a
+ * local copy with subtly different behaviour; the deliberate differences are
+ * now NAMED POLICIES chosen at each call site:
+ *
+ * - `JSON_COLUMN_PASSTHROUGH` — non-strings pass through untouched
+ *   (undefined stays undefined); unparseable strings return verbatim.
+ *   (datarule options, field.list readback)
+ * - `JSON_COLUMN_NULL_COALESCE` — non-strings null-coalesce (undefined →
+ *   null); blank/unparseable strings return verbatim ("" stays "").
+ *   (businessrule node/route/schedulerSetting, b2 configJson/parameter faces,
+ *   rule-support parameter faces, list-view condition options)
+ * - `{ invalid: "throw" }` — a corrupt column is a hard error
+ *   (field.update merge base reads the stored options strictly).
+ *
+ * Blank strings ("", "   ") are not valid JSON, so they always take the
+ * `invalid` branch; at every previous site that meant passthrough.
+ */
+export const JSON_COLUMN_PASSTHROUGH = { nonString: "passthrough", invalid: "passthrough" };
+export const JSON_COLUMN_NULL_COALESCE = { nonString: "null", invalid: "passthrough" };
+export function decodeJsonColumn(value, policy) {
+    if (typeof value !== "string")
+        return policy.nonString === "null" ? value ?? null : value;
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        if (policy.invalid === "throw")
+            throw error;
+        return value;
+    }
+}
+/** Wire encode: a string is sent as-is, anything else is JSON-stringified. */
+export function encodeJsonColumn(value) {
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+/**
+ * Decode an options face that may be a JSON string or already an object into
+ * a plain record (or undefined). Policies preserve the previous per-site
+ * semantics: relation options accept strings/objects/arrays loosely; the
+ * FORMULA formulaConfig validator only accepts strings that parse to a
+ * non-array object; field.update/form-scaffold strict reads throw on corrupt
+ * strings.
+ */
+export function decodeJsonObjectColumn(value, policy) {
+    const asRecord = (parsed) => {
+        if (!parsed || typeof parsed !== "object")
+            return undefined;
+        if (Array.isArray(parsed))
+            return policy.array === "reject" ? undefined : parsed;
+        return parsed;
+    };
+    if (typeof value === "string") {
+        try {
+            return asRecord(JSON.parse(value));
+        }
+        catch (error) {
+            if (policy.invalid === "throw")
+                throw error;
+            return undefined;
+        }
+    }
+    if (policy.object === "reject")
+        return undefined;
+    return asRecord(value);
+}
+//# sourceMappingURL=json-column.js.map

package/dist/list-view-wire.js

@@ -0,0 +1,101 @@
+/** 列表视图按钮 wire 契约（真 lane 与假平台共用）：动作枚举、按钮校验。原居 cli list-view-shapes；C1 下沉。 */
+import { ToolRefusalError } from "./refusal.js";
+export function wireEnum(key, index) {
+    return {
+        key,
+        names: Object.keys(index),
+        index,
+        name: Object.fromEntries(Object.entries(index).map(([name, value]) => [value, name])),
+    };
+}
+/**
+ * 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 });
+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);
+}
+//# sourceMappingURL=list-view-wire.js.map

package/dist/refusal.js

@@ -0,0 +1,9 @@
+/** 受治理拒收（跨适配器契约）：真 lane 与假平台抛同一类、同一实例。原居 cli tool-types；C1 下沉。 */
+export class ToolRefusalError extends Error {
+    payload;
+    constructor(payload) {
+        super(String(payload["blocker"] ?? "tool refused"));
+        this.payload = payload;
+    }
+}
+//# sourceMappingURL=refusal.js.map

package/dist/relation-shape.js

@@ -0,0 +1,25 @@
+/** 关联字段目标模型解析（真 lane 与假平台共用）。原居 cli field-families；C1 下沉。 */
+import { decodeJsonObjectColumn } from "./json-column.js";
+/** relation options face decode; policy: string-or-object accepted, garbage → undefined. */
+export function relationOptions(options) {
+    return decodeJsonObjectColumn(options, { invalid: "undefined", array: "accept", object: "accept" });
+}
+/**
+ * The relation target model of a bizproperty row. Relation families
+ * (WORK_SHEET / MULT_WORK_SHEET) carry the target model code both as the
+ * row-level `relativeCode` and as the `schemaCode` key inside the options JSON
+ * (field.create writes both). RELEVANCE_DATA(16) is deliberately excluded: it
+ * references another *field* (relevanceField/referenceField), not a model, so
+ * it adds no inbound model reference of its own — the local WORK_SHEET field it
+ * resolves through already carries that reference. Either face counts as an
+ * inbound reference for the model.delete precheck (ticket 23: the server's
+ * deleteFunctions dispatcher refuses asynchronously with
+ * "xxx被模型 yyy 引用,不能删除" — the tool surfaces that check at call time).
+ */
+export function relationTargetOf(row) {
+    if (typeof row.relativeCode === "string" && row.relativeCode.trim())
+        return row.relativeCode.trim();
+    const schemaCode = relationOptions(row.options)?.schemaCode;
+    return typeof schemaCode === "string" && schemaCode.trim() ? schemaCode.trim() : undefined;
+}
+//# sourceMappingURL=relation-shape.js.map