@voplus/morpho-csp 11.2.8 → 11.3.0-dev.0

package/es/components/LegalContactSelect/index.d.ts

@@ -1,6 +1,13 @@
 import { IIdentity } from "../../data/identity";
 import React from "react";
 declare const LegalContactSelect: (props: {
+    /** Company whose member/officer owners are eligible representatives. */
+    companyId?: string;
+    /** Form-controlled restored legal identity, independent of its owner id. */
+    value?: {
+        id: string;
+        name?: string;
+    };
     onChange?: (contact?: IIdentity) => void;
 }) => React.JSX.Element;
 export default LegalContactSelect;

package/es/components/LegalContactSelect/index.js

@@ -1,28 +1,143 @@
-import { useIdentityListEffect } from "../../data/identity";
-import React, { useState } from "react";
-import { Select } from "antd";
+import { useIdentityStore } from "../../data/identity";
+import React, { useEffect, useRef, useState } from "react";
+import { Button, Select } from "antd";
 import { State } from "./state";
 import { observe } from "@voplus/morpho-ui";
 import { runInAction } from "mobx";
+import { useMemberStore } from "../../data/member";
+import { useOfficerStore } from "../../data/officer";
+/** Explicit paging prevents the standard list endpoint's 50-row default from hiding eligible data. */
+const PAGE_SIZE = 50;
+/** Loads every page from a standard list endpoint without requesting its counted envelope. */
+async function loadEveryPage(load, filters) {
+    const items = [];
+    for (let page = 1;; page += 1) {
+        const next = await load({
+            Filters: filters,
+            List: true,
+            Total: false,
+            Page: { Page: page, PageSize: PAGE_SIZE },
+        });
+        items.push(...next);
+        if (next.length < PAGE_SIZE)
+            return items;
+    }
+}
+/** Builds a stable readable label from members actually emitted by the IdentityModel wire. */
+function identityLabel(identity) {
+    const parts = [identity.fullName, identity.number, identity.shape?.name]
+        .map((part) => part?.trim())
+        .filter((part) => !!part);
+    return parts.length ? parts.join(" · ") : identity.id;
+}
 const LegalContactSelect = (props) => {
     const [state] = useState(new State());
-    useIdentityListEffect(null, (list) => {
+    const [requestState, setRequestState] = useState(props.companyId ? "loading" : "idle");
+    const [retryVersion, setRetryVersion] = useState(0);
+    const previousCompanyId = useRef(props.companyId);
+    const selectionCompanyId = useRef(props.value?.id ? props.companyId : undefined);
+    const onChange = useRef(props.onChange);
+    const value = useRef(props.value);
+    onChange.current = props.onChange;
+    value.current = props.value;
+    const memberStore = useMemberStore();
+    const officerStore = useOfficerStore();
+    const identityStore = useIdentityStore();
+    // spec:1929 — CSP: 需要指定人员的表单提供“选择已有”与“手动录入”两种单选模式
+    // spec:1930 — CSP: 使用“Select existing”模式时，表单发送所选实体的 id；手动模式发送用户键入的字段
+    useEffect(() => {
+        let current = true;
+        const companyChanged = previousCompanyId.current !== props.companyId;
+        const restoringInitialCompany = previousCompanyId.current === undefined &&
+            props.companyId !== undefined &&
+            selectionCompanyId.current === undefined &&
+            !!value.current?.id;
+        previousCompanyId.current = props.companyId;
+        if (restoringInitialCompany) {
+            selectionCompanyId.current = props.companyId;
+        }
+        else if (companyChanged) {
+            selectionCompanyId.current = undefined;
+            if (value.current?.id)
+                onChange.current?.(undefined);
+        }
         runInAction(() => {
-            state.contactList = list || [];
-            state.loading = false;
+            state.contactList = [];
+            if (companyChanged)
+                state.identityId = "";
         });
-    });
-    return observe(() => (React.createElement(Select, { value: state.identityId, loading: state.loading, showSearch: { filterOption: filterItems }, optionLabelProp: "title", onSelect: onSelect, style: { width: "100%" }, options: state.contactList.map((i) => {
-            return { value: i.id, label: i.identity, title: i.identity };
-        }) })));
+        setRequestState(props.companyId ? "loading" : "idle");
+        if (!props.companyId)
+            return () => void (current = false);
+        const corporateFilter = [
+            { c: "CorporateId", o: "=", l: "And", v1: props.companyId },
+        ];
+        void (async () => {
+            try {
+                const [members, officers] = await Promise.all([
+                    loadEveryPage(memberStore.loadList.bind(memberStore), corporateFilter),
+                    loadEveryPage(officerStore.loadList.bind(officerStore), corporateFilter),
+                ]);
+                const ownerIds = new Set();
+                members.forEach((member) => member.contact?.id && ownerIds.add(member.contact.id));
+                officers.forEach((officer) => officer.appointment && officer.contact?.id && ownerIds.add(officer.contact.id));
+                const pages = await Promise.all([...ownerIds].map((ownerId) => loadEveryPage(identityStore.loadList.bind(identityStore), [
+                    { c: "UnitId", o: "=", l: "And", v1: ownerId },
+                ])));
+                if (!current)
+                    return;
+                const unique = new Map();
+                pages.flat().forEach((identity) => unique.set(identity.id, identity));
+                runInAction(() => {
+                    state.contactList = [...unique.values()];
+                });
+                setRequestState("idle");
+            }
+            catch {
+                if (current) {
+                    runInAction(() => (state.contactList = []));
+                    setRequestState("error");
+                }
+            }
+        })();
+        return () => void (current = false);
+    }, [identityStore, memberStore, officerStore, props.companyId, retryVersion, state]);
+    const selectionBelongsToCompany = selectionCompanyId.current === props.companyId;
+    return observe(() => (React.createElement(React.Fragment, null,
+        React.createElement(Select, { value: selectionBelongsToCompany ? props.value?.id ?? state.identityId : "", loading: requestState === "loading", disabled: !props.companyId, status: requestState === "error" ? "error" : undefined, showSearch: { filterOption: filterItems }, optionLabelProp: "title", onSelect: onSelect, style: { width: "100%" }, options: [
+                ...(selectionBelongsToCompany &&
+                    props.value?.id &&
+                    !state.contactList.some((identity) => identity.id === props.value?.id)
+                    ? [
+                        {
+                            value: props.value.id,
+                            label: props.value.name ?? props.value.id,
+                            title: props.value.name ?? props.value.id,
+                        },
+                    ]
+                    : []),
+                ...state.contactList.map((i) => {
+                    const label = identityLabel(i);
+                    return { value: i.id, label, title: label };
+                }),
+            ] }),
+        requestState === "error" && (React.createElement("div", { role: "alert" },
+            "Unable to load company contacts.",
+            " ",
+            React.createElement(Button, { onClick: () => setRetryVersion((v) => v + 1) }, "Retry"))))));
+    /** Matches only readable option metadata and stays safe for restored fallback rows. */
     function filterItems(input, option) {
-        return option.title.toLowerCase().includes(input.toLowerCase());
+        return option?.title?.toLowerCase().includes(input.toLowerCase()) ?? false;
     }
+    // spec:3848 — CSP form identities retain their selected shape snapshot
     /** select unit */
     function onSelect(id) {
         const contact = state.contactList.find((x) => x.id === id);
         runInAction(() => (state.identityId = id));
-        props.onChange?.(contact);
+        if (contact) {
+            selectionCompanyId.current = props.companyId;
+            props.onChange?.(contact);
+        }
     }
 };
 export default LegalContactSelect;

package/es/components/LegalContactSelect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/LegalContactSelect/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,kBAAkB,GAAG,CAAC,KAAmD,EAAE,EAAE;IAClF,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAEtC,qBAAqB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACpC,WAAW,CAAC,GAAG,EAAE;YAChB,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CACpB,oBAAC,MAAM,IACN,KAAK,EAAE,KAAK,CAAC,UAAU,EACvB,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,UAAU,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,EACzC,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9D,CAAC,CAAC,GACD,CACF,CAAC,CAAC;IACH,SAAS,WAAW,CAAC,KAAU,EAAE,MAAW;QAC3C,OAAQ,MAAM,CAAC,KAAgB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,kBAAkB;IAClB,SAAS,QAAQ,CAAC,EAAU;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACF,CAAC,CAAC;AACF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/LegalContactSelect/index.tsx"],"names":[],"mappings":"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"}

package/es/data/clda-form/conversion.d.ts

@@ -1,7 +1,10 @@
-/** 把字符串首字母转为大字 */
+/** The typed PascalCase JSON counterpart, preserving primitives, arrays and date serializers. */
+export type PascalValue<T> = T extends Date ? T : T extends readonly (infer V)[] ? PascalValue<V>[] : T extends object ? {
+    [K in keyof T as K extends string ? Capitalize<K> : K]: PascalValue<T[K]>;
+} : T;
+/** Capitalize a JSON field name without changing its remaining spelling. */
 export declare function titleCase(str: string): string;
-/** 把对象{}内的key 從camelCase 改成PascalCase */
-export declare function setPascalCase(obj: any): {
-    [k: string]: unknown;
-};
-export declare function CapitalizeFirstLetter(arr: any[]): any;
+/** Map all nested form fields, including array members, without touching wire literals. */
+export declare function setPascalCase<T>(value: T): PascalValue<T>;
+/** Retain the established roster API while using the same recursive JSON mapper. */
+export declare function CapitalizeFirstLetter<T>(arr: T[]): PascalValue<T>[];

package/es/data/clda-form/conversion.js

@@ -1,25 +1,18 @@
-/** 把字符串首字母转为大字 */
+/** Capitalize a JSON field name without changing its remaining spelling. */
 export function titleCase(str) {
     return str.slice(0, 1).toUpperCase() + str.slice(1);
 }
-/** 把对象{}内的key 從camelCase 改成PascalCase */
-export function setPascalCase(obj) {
-    const objL = Object.entries(obj);
-    objL.forEach((v) => {
-        v[0] = titleCase(v[0]);
-        // v[1] 为object不为array时, 才进行递归调用
-        if (typeof v[1] === "object" && !Array.isArray(v[1])) {
-            v[1] = setPascalCase(v[1]);
-        }
-    });
-    return Object.fromEntries(objL);
+// spec:3850 — typed form saves preserve full rosters and nullable captured clears.
+/** Map all nested form fields, including array members, without touching wire literals. */
+export function setPascalCase(value) {
+    if (Array.isArray(value))
+        return value.map((field) => setPascalCase(field));
+    if (value === null || typeof value !== "object" || value instanceof Date || "toJSON" in value)
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, field]) => [titleCase(key), setPascalCase(field)]));
 }
+/** Retain the established roster API while using the same recursive JSON mapper. */
 export function CapitalizeFirstLetter(arr) {
-    const newArr = [];
-    arr.forEach((item) => {
-        item = setPascalCase(item);
-        newArr.push(item);
-    });
-    return newArr;
+    return arr.map((item) => setPascalCase(item));
 }
 //# sourceMappingURL=conversion.js.map

package/es/data/clda-form/conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../../src/data/clda-form/conversion.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,MAAM,UAAU,SAAS,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,GAAQ;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAClB,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,gCAAgC;QAChC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAU;IAC/C,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACpB,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../../src/data/clda-form/conversion.ts"],"names":[],"mappings":"AAQA,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AACD,mFAAmF;AACnF,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAI,KAAQ;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAmB,CAAC;IAC9F,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI,IAAI,QAAQ,IAAI,KAAK;QAC5F,OAAO,KAAuB,CAAC;IAChC,OAAO,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CACjE,CAAC;AACrB,CAAC;AACD,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CAAI,GAAQ;IAChD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/es/data/clda-form/identityAdapter.d.ts

@@ -0,0 +1,60 @@
+import type { IdentityShapeCatalogStatus } from "@voplus/morpho-compliance/es/components/IdentityShapeSelect";
+import type { IIdentity } from "../identity";
+import type { IAddress } from "@voplus/morpho-ui/es/data";
+import type { IFormPeopleOptions } from "./interfaces";
+import type { ILegalGenerationShapeSnapshot } from "../../modules/corporate/legal-generation/form/legalGenerationSubmit";
+/** The form-only wizard callback; these values never create a Compliance owner or identity. */
+export interface FormContactCapture {
+    /** Display name, synchronized with the captured identity's full name. */
+    FullName: string;
+    /** Captured document number. */
+    Number: string | number;
+    /** The person's nationality or organisation's registration country. */
+    Country: string;
+    /** Legacy metadata supplied by historical callers, never inferred from a custom shape. */
+    Type?: IIdentity["type"];
+    /** The contact's subject applicability. */
+    UnitType: string;
+    /** Redundant authoritative selected source. */
+    SourceNumber?: number;
+    /** Complete frozen sibling record. */
+    IdentityShape?: ILegalGenerationShapeSnapshot;
+    /** Optional or explicitly cleared alias. */
+    Alias?: string | null;
+    /** Independent issuing country or explicit clear. */
+    IssuingCountry?: string | null;
+    /** Captured expiry value or explicit clear. */
+    ExpiryDate?: string | null;
+    /** Contact email, retained from the wizard. */
+    Email?: string;
+    /** Contact phone, retained from the wizard. */
+    Phone?: string;
+    /** Contact address, retained from the wizard. */
+    Address?: IAddress;
+}
+/** Project a form identity into the shared editor without mutating the saved form. */
+export declare function toFormIdentity(contact: IFormPeopleOptions): IIdentity & {
+    sourceNumber?: number;
+};
+/** Apply shared editor values, keeping snapshots beside Identity and confirmed clears explicit. */
+export declare function applyFormIdentity(contact: IFormPeopleOptions, value: IIdentity): void;
+/** Create a form-person value from a wizard callback without guessing a deprecated Type. */
+export declare function toFormPerson(id: string, info: FormContactCapture): IFormPeopleOptions;
+/** 完整身份校验供新捕获、冻结值及最终提交使用；历史草稿保存另行分类。 */
+export declare function validateFormIdentity(contact: IFormPeopleOptions): string[];
+/** 普通文书草稿的保存判断；与最终提交的完整性校验分开。 */
+export interface FormDraftSaveDecision {
+    /** 按钮及实际保存入口共同使用的放行结果。 */
+    allowed: boolean;
+    /** 直接触发保存时可显示的失败原因。 */
+    errors: string[];
+    /** 区分已保存资料、新捕获以及无效变更。 */
+    reason: "retained-manual" | "legacy-draft" | "current-capture" | "invalid-transition" | "catalog-unavailable";
+}
+/**
+ * 基线必须由宿主在打开编辑时独立复制，不能传入正在编辑的对象。
+ * 本函数只判断，不回填身份或读取目录；新捕获的来源认证仍由共享选择器及服务端执行。
+ */
+export declare function getFormDraftSaveDecision(baseline: Readonly<IFormPeopleOptions> | undefined, draft: IFormPeopleOptions, catalogStatus: IdentityShapeCatalogStatus): FormDraftSaveDecision;
+/** 股份区段只读接收人可直接保存引用；更换手工接收人必须按新捕获验证，不能借用原草稿基线。 */
+export declare function getFormRecipientSaveDecision(baseline: Readonly<IFormPeopleOptions>, recipient: Readonly<IFormPeopleOptions>, draft: IFormPeopleOptions, catalogStatus: IdentityShapeCatalogStatus): FormDraftSaveDecision;

package/es/data/clda-form/identityAdapter.js

@@ -0,0 +1,196 @@
+import { toIdentityCapture, toIdentityShapeSnapshot, } from "../../modules/corporate/legal-generation/form/legalGenerationSubmit";
+// spec:3848 — render stored semantics without catalogue recapture or persisted backfill.
+/** Project a form identity into the shared editor without mutating the saved form. */
+export function toFormIdentity(contact) {
+    return {
+        ...contact.identity,
+        alias: contact.identity?.alias ?? undefined,
+        issuingCountry: contact.identity?.issuingCountry ?? undefined,
+        expiryDate: contact.identity?.expiryDate ?? undefined,
+        fullName: contact.identity?.fullName ?? contact.name ?? "",
+        sourceNumber: contact.identity?.sourceNumber ?? contact.identityShape?.sourceNumber,
+        shape: toIdentityCapture({ identityShape: contact.identityShape, identity: contact.identity })
+            ?.shape,
+        unitType: contact.type === "Organization" ? "Organization" : "Person",
+    };
+}
+// spec:3848 — selected source and seven frozen members share one contact update.
+/** Apply shared editor values, keeping snapshots beside Identity and confirmed clears explicit. */
+export function applyFormIdentity(contact, value) {
+    const savedSource = contact.identity?.sourceNumber;
+    const { shape, unitType: _viewSubject, ...identity } = value;
+    const snapshot = shape ? toIdentityShapeSnapshot(shape) : undefined;
+    const changedShape = snapshot &&
+        Object.keys(snapshot).some((field) => snapshot[field] !== contact.identityShape?.[field]);
+    contact.identity = {
+        ...identity,
+        // spec:3848 — 旧记录的 null 仅在控件投影中归一化；无捕获更新必须保留原清除值。
+        ...(!shape && identity.alias === undefined && contact.identity?.alias === null
+            ? { alias: null }
+            : {}),
+        ...(!shape && identity.issuingCountry === undefined && contact.identity?.issuingCountry === null
+            ? { issuingCountry: null }
+            : {}),
+        ...(!shape && identity.expiryDate === undefined && contact.identity?.expiryDate === null
+            ? { expiryDate: null }
+            : {}),
+        ...(shape && changedShape ? { sourceNumber: shape.source } : {}),
+        ...(shape &&
+            (changedShape || contact.identity?.alias !== identity.alias) &&
+            identity.alias === undefined
+            ? { alias: null }
+            : {}),
+        ...(shape &&
+            (changedShape || contact.identity?.issuingCountry !== identity.issuingCountry) &&
+            identity.issuingCountry === undefined
+            ? { issuingCountry: null }
+            : {}),
+        ...(shape &&
+            (changedShape || contact.identity?.expiryDate !== identity.expiryDate) &&
+            identity.expiryDate === undefined
+            ? { expiryDate: null, clearExpiryDate: true }
+            : {}),
+        ...(shape &&
+            identity.expiryDate !== undefined &&
+            contact.identity?.expiryDate !== identity.expiryDate
+            ? { clearExpiryDate: false }
+            : {}),
+    };
+    // A projection may restore a missing redundant source. It must not silently backfill a read.
+    if (shape && !changedShape && contact.identityShape && savedSource === undefined)
+        delete contact.identity.sourceNumber;
+    contact.name = identity.fullName ?? contact.name;
+    if (snapshot && changedShape)
+        contact.identityShape = snapshot;
+}
+// spec:3848 — all form-only constructors consume the same complete capture.
+/** Create a form-person value from a wizard callback without guessing a deprecated Type. */
+export function toFormPerson(id, info) {
+    return {
+        id,
+        idType: "NewId",
+        name: info.FullName,
+        type: info.UnitType,
+        email: info.Email,
+        phone: info.Phone,
+        address: info.Address,
+        identity: {
+            fullName: info.FullName,
+            number: String(info.Number),
+            country: info.Country,
+            ...(info.Type ? { type: info.Type } : {}),
+            ...(info.IdentityShape
+                ? { sourceNumber: info.IdentityShape.sourceNumber }
+                : info.SourceNumber !== undefined
+                    ? { sourceNumber: info.SourceNumber }
+                    : {}),
+            alias: info.Alias,
+            issuingCountry: info.IssuingCountry,
+            expiryDate: info.ExpiryDate,
+        },
+        ...(info.IdentityShape ? { identityShape: { ...info.IdentityShape } } : {}),
+    };
+}
+// spec:3848 — mandatory captured values follow frozen policies; historical validation stays legacy.
+/** 完整身份校验供新捕获、冻结值及最终提交使用；历史草稿保存另行分类。 */
+export function validateFormIdentity(contact) {
+    const identity = contact.identity;
+    const errors = [];
+    if (!contact.name?.trim() ||
+        !identity?.number?.trim() ||
+        !identity.country?.trim() ||
+        (!contact.identityShape && !identity.type))
+        errors.push("Please input identity details.");
+    if (contact.identityShape) {
+        const fields = [
+            ["aliasPolicy", "alias", "Alias"],
+            ["issuingCountryPolicy", "issuingCountry", "Issuing Country"],
+            ["expiryPolicy", "expiryDate", "Expiry Date"],
+        ];
+        for (const [policy, key, label] of fields)
+            if (contact.identityShape[policy] === "mandatory" && !identity?.[key]?.trim())
+                errors.push(`${label} is required.`);
+    }
+    return errors;
+}
+/** 冻结语义由全部七个成员决定，不能只比较来源或对象引用。 */
+const formShapeMembers = [
+    "sourceNumber",
+    "name",
+    "family",
+    "subject",
+    "aliasPolicy",
+    "issuingCountryPolicy",
+    "expiryPolicy",
+];
+/**
+ * 基线必须由宿主在打开编辑时独立复制，不能传入正在编辑的对象。
+ * 本函数只判断，不回填身份或读取目录；新捕获的来源认证仍由共享选择器及服务端执行。
+ */
+export function getFormDraftSaveDecision(baseline, draft, catalogStatus) {
+    const shape = draft.identityShape;
+    const source = draft.identity?.sourceNumber;
+    /** 绑定或捕获不一致时，不允许退回历史草稿分支。 */
+    const invalid = () => ({
+        allowed: false,
+        errors: [
+            "The contact binding or identity capture has changed. Please select the contact or identity type again.",
+        ],
+        reason: "invalid-transition",
+    });
+    if (baseline &&
+        (baseline.id !== draft.id ||
+            baseline.idType !== draft.idType ||
+            baseline.type !== draft.type ||
+            (baseline.selectedEntityId ?? undefined) !== (draft.selectedEntityId ?? undefined) ||
+            (baseline.selectedIdentityId ?? undefined) !== (draft.selectedIdentityId ?? undefined) ||
+            (baseline.identityShape && !shape)))
+        return invalid();
+    if (shape &&
+        (formShapeMembers.some((member) => shape[member] === undefined || shape[member] === null) ||
+            (source !== undefined && source !== shape.sourceNumber)))
+        return invalid();
+    const manual = draft.idType !== "ExistingContactId" && !draft.selectedEntityId && !draft.selectedIdentityId;
+    if (baseline && !baseline.identityShape && !shape) {
+        // 旧记录的冗余来源保持原样；单独改来源不能冒充无形状旧草稿。
+        if (baseline.identity?.sourceNumber !== source)
+            return invalid();
+        return { allowed: true, errors: [], reason: "legacy-draft" };
+    }
+    if (manual &&
+        baseline?.identityShape &&
+        shape &&
+        formShapeMembers.every((member) => baseline.identityShape[member] === shape[member])) {
+        const errors = validateFormIdentity(draft);
+        return { allowed: errors.length === 0, errors, reason: "retained-manual" };
+    }
+    if (catalogStatus !== "ready") {
+        return {
+            allowed: false,
+            errors: ["Please wait for the identity types to load or retry."],
+            reason: "catalog-unavailable",
+        };
+    }
+    // 新捕获必须有完整形状；无法借历史无形状的宽松保存规则跳过采集。
+    if (!shape || (!manual && !baseline))
+        return invalid();
+    const errors = validateFormIdentity(draft);
+    const subject = draft.type === "Organization" ? "Organization" : "Person";
+    if (shape.subject !== "Both" && shape.subject !== subject)
+        errors.push("The identity type does not apply to this contact.");
+    return { allowed: errors.length === 0, errors, reason: "current-capture" };
+}
+/** 股份区段只读接收人可直接保存引用；更换手工接收人必须按新捕获验证，不能借用原草稿基线。 */
+export function getFormRecipientSaveDecision(baseline, recipient, draft, catalogStatus) {
+    const decision = getFormDraftSaveDecision(recipient, draft, catalogStatus);
+    if (recipient.idType !== "NewId") {
+        // 该分支没有身份编辑器，父列表只保存区段引用，不写联系人资料。
+        return decision.reason === "invalid-transition"
+            ? decision
+            : { allowed: true, errors: [], reason: "current-capture" };
+    }
+    if (!decision.allowed || recipient.id === baseline.id)
+        return decision;
+    return getFormDraftSaveDecision(undefined, draft, catalogStatus);
+}
+//# sourceMappingURL=identityAdapter.js.map

package/es/data/clda-form/identityAdapter.js.map

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

package/es/data/clda-form/interfaces.d.ts

@@ -1,6 +1,7 @@
 import { IAddress } from "@voplus/morpho-ui/es/data";
 import { IDocument } from "@voplus/morpho-document-core";
 import { IIdentity } from "../identity";
+import type { ILegalGenerationShapeSnapshot } from "../../modules/corporate/legal-generation/form/legalGenerationSubmit";
 export interface IFormPeopleOptions {
     /** 需要前端自己生成，可以用uuid */
     id: string;
@@ -8,7 +9,25 @@ export interface IFormPeopleOptions {
     email?: string;
     phone?: string;
     address?: IAddress;
-    identity?: Partial<IIdentity>;
+    /** Form identity values are separate from the shared record command and allow explicit clears. */
+    identity?: Omit<Partial<IIdentity>, "shape" | "alias" | "issuingCountry" | "expiryDate"> & {
+        /** Explicit selected source, redundant with the frozen sibling snapshot. */
+        sourceNumber?: number;
+        /** Captured alias or a confirmed clear. */
+        alias?: string | null;
+        /** Independent issuing country or a confirmed clear. */
+        issuingCountry?: string | null;
+        /** Captured expiry or a confirmed clear. */
+        expiryDate?: string | null;
+        /** Legacy clear intent retained in form JSON. */
+        clearExpiryDate?: boolean;
+    };
+    /** The CSP canonical sibling snapshot persisted alongside Identity. */
+    identityShape?: ILegalGenerationShapeSnapshot;
+    /** The gallery picker selection, distinct from owner id. */
+    selectedEntityId?: string | null;
+    /** The exact existing identity the gallery captured. */
+    selectedIdentityId?: string | null;
     idType?: string;
     type?: string;
     types?: (string | undefined)[];

package/es/data/clda-form/saveFormDraft.d.ts

@@ -0,0 +1,4 @@
+import type { CLDAFormStore } from "./store";
+import type { EditCLDAFormOptions } from "./types";
+/** Interpret both store error callbacks and thrown failures before a host closes its editor. */
+export declare function saveFormDraft(store: Pick<CLDAFormStore, "edit">, id: string, data: EditCLDAFormOptions): Promise<boolean>;

package/es/data/clda-form/saveFormDraft.js

@@ -0,0 +1,21 @@
+import { message } from "antd";
+// spec:3848 — a rejected captured save retains the draft and its confirmed clears.
+/** Interpret both store error callbacks and thrown failures before a host closes its editor. */
+export async function saveFormDraft(store, id, data) {
+    let failed = false;
+    try {
+        await store.edit(id, {
+            data,
+            error: (error) => {
+                failed = true;
+                message.error(error.message);
+            },
+        });
+        return !failed;
+    }
+    catch (error) {
+        message.error(error instanceof Error ? error.message : String(error));
+        return false;
+    }
+}
+//# sourceMappingURL=saveFormDraft.js.map

package/es/data/clda-form/saveFormDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveFormDraft.js","sourceRoot":"","sources":["../../../src/data/clda-form/saveFormDraft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B,mFAAmF;AACnF,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,KAAkC,EAClC,EAAU,EACV,IAAyB;IAEzB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC;QACJ,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE;YACpB,IAAI;YACJ,KAAK,EAAE,CAAC,KAAY,EAAQ,EAAE;gBAC7B,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;SACD,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}