@tianyr/schema-antd 0.1.0 → 0.2.0

package/dist/biz-select/useSelectedLabel.js

@@ -0,0 +1,156 @@
+/**
+ * 已选编码 → 名称的解析。
+ *
+ * 与关键词搜索是两条独立逻辑：搜索是模糊的，回显必须精确。
+ * 优先级（设计文档 §5.6）：对象值自带的名称 → seedOptions → 已加载候选
+ * → resolve(code) → 原样显示编码并暴露状态。
+ */
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { resolveCodeWithCache } from './cache.js';
+import { codeKeyOf, paramsKeyOf, resolveCacheKey } from './key.js';
+import { hasRequiredParams, normalizeSource } from './normalize.js';
+import { resolveOne } from './resolveBatch.js';
+/** 编码比对统一走字符串：后端可能把 1 和 '1' 当同一个值 */
+function sameValue(a, b) {
+    return a !== undefined && b !== undefined && String(a) === String(b);
+}
+function findOption(list, code) {
+    return list?.find((item) => item.value === code);
+}
+export function useSelectedLabel({ source, sourceKey, code, valueName, seedOptions, candidates, params, }) {
+    const capability = normalizeSource(source);
+    const { canResolve, requiredParams } = capability;
+    const paramsKey = paramsKeyOf(params);
+    const codeKey = codeKeyOf(code);
+    const scope = source?.namespace?.() ?? '';
+    const blocked = !hasRequiredParams(requiredParams, params);
+    const sourceRef = useRef(source);
+    sourceRef.current = source;
+    const paramsRef = useRef(params);
+    paramsRef.current = params;
+    const codeRef = useRef(code);
+    codeRef.current = code;
+    const [asyncResult, setAsyncResult] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const seqRef = useRef(0);
+    /**
+     * 已选项的兜底记忆。
+     *
+     * 搜索型源的候选会随关键词整批换掉，重新展开拿到的也只是默认第一页，
+     * 已选项常常不在里面；没有 resolve 就只能退回编码。按
+     * 「来源 + 租户 + 条件 + 编码」记住最近一次命中的选项，条件一变自然失效。
+     */
+    const memoryRef = useRef(null);
+    const memoryKey = `${sourceKey}|${scope}|${paramsKey}|${codeKey}`;
+    // 本地能查到就不发请求；命中结果是对象，这里只取布尔作为 effect 依赖
+    const seedHit = useMemo(() => (code === undefined ? undefined : findOption(seedOptions, code)), [seedOptions, code]);
+    const candidateHit = useMemo(() => (code === undefined ? undefined : findOption(candidates, code)), [candidates, code]);
+    const localHit = seedHit ?? candidateHit;
+    const hasLocal = Boolean(localHit);
+    // 对象值已经自带名称：展示层直接用，没有理由再发一次 resolve
+    const hasValueName = Boolean(valueName);
+    useEffect(() => {
+        if (code === undefined || hasLocal || hasValueName || !canResolve || blocked)
+            return;
+        if (!sourceRef.current)
+            return;
+        const requested = codeRef.current;
+        const key = resolveCacheKey(scope, sourceKey, requested, paramsKey);
+        const seq = seqRef.current + 1;
+        seqRef.current = seq;
+        let cancelled = false;
+        setLoading(true);
+        // 不传 AbortSignal：这个 promise 是多个实例共享的，
+        // 单个实例卸载不能把别人的请求掐掉，只放弃自己的状态更新即可
+        // 只声明了 resolveMany 的源也能单条回显：批量一条就是单条
+        resolveCodeWithCache(key, () => resolveOne(sourceRef.current, requested, paramsRef.current ?? {}))
+            .then((option) => {
+            if (cancelled || seq !== seqRef.current)
+                return;
+            // 接口返回了别的编码就别认：认错比认不出更糟，展示层会显示陌生名称。
+            // 数字/字符串同一编码（后端序列化常见）认下，但编码归一到值的类型：
+            // 否则选项 value 与 Select 的 value 对不上，标签等于白解析
+            const matched = option && sameValue(option.value, requested) ? { ...option, value: requested } : null;
+            setAsyncResult({ sourceKey, scope, paramsKey, codeKey, option: matched, failed: false });
+        })
+            .catch(() => {
+            if (cancelled || seq !== seqRef.current)
+                return;
+            setAsyncResult({
+                sourceKey,
+                scope,
+                paramsKey,
+                codeKey,
+                option: null,
+                failed: true,
+            });
+        })
+            .finally(() => {
+            if (!cancelled && seq === seqRef.current)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+        // sourceKey / paramsKey / codeKey 都是字符串，源从 ref 取，函数引用不进依赖
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [sourceKey, scope, paramsKey, codeKey, hasLocal, hasValueName, canResolve, blocked]);
+    return useMemo(() => {
+        if (code === undefined)
+            return { option: null, status: 'empty' };
+        // 命中即记账：下次候选被换掉时还能拿它兜底
+        const remember = (option) => {
+            memoryRef.current = { key: memoryKey, option };
+            return option;
+        };
+        const remembered = memoryRef.current;
+        const fallback = remembered?.key === memoryKey ? remembered.option : undefined;
+        // 1) 对象值自带的名称：详情已经给了，不必再查
+        if (valueName)
+            return { option: remember({ value: code, label: valueName }), status: 'resolved' };
+        // 2) 页面预置的候选
+        if (seedHit)
+            return { option: remember(seedHit), status: 'resolved' };
+        // 3) 已加载的候选
+        if (candidateHit)
+            return { option: remember(candidateHit), status: 'resolved' };
+        const asyncMatched = asyncResult &&
+            asyncResult.sourceKey === sourceKey &&
+            asyncResult.scope === scope &&
+            asyncResult.paramsKey === paramsKey &&
+            asyncResult.codeKey === codeKey;
+        if (asyncMatched && asyncResult) {
+            if (asyncResult.option)
+                return { option: remember(asyncResult.option), status: 'resolved' };
+            // 解析不到但之前见过这个编码：搜索型源的候选已被关键词换掉，别退回编码
+            if (fallback)
+                return { option: fallback, status: 'resolved' };
+            return { option: { value: code }, status: asyncResult.failed ? 'error' : 'missing' };
+        }
+        if (fallback)
+            return { option: fallback, status: 'resolved' };
+        if (!canResolve)
+            return { option: { value: code }, status: 'missing' };
+        // 用空条件查可能拿到别家数据，宁可不查
+        if (blocked)
+            return { option: { value: code }, status: 'blocked' };
+        if (loading)
+            return { option: { value: code }, status: 'loading' };
+        return { option: { value: code }, status: 'missing' };
+    }, [
+        code,
+        valueName,
+        seedHit,
+        candidateHit,
+        asyncResult,
+        memoryKey,
+        sourceKey,
+        scope,
+        paramsKey,
+        codeKey,
+        canResolve,
+        blocked,
+        loading,
+    ]);
+}
+//# sourceMappingURL=useSelectedLabel.js.map

package/dist/biz-select/useSelectedLabel.js.map

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

package/dist/biz-select/useSelectedLabels.d.ts

@@ -0,0 +1,26 @@
+import type { SelectedStatus } from './useSelectedLabel.js';
+import type { BizOption, SelectParams, SelectSource, SelectValue } from './types.js';
+export interface UseSelectedLabelsOptions {
+    /** 注册名或内联源，写法和组件一致 */
+    source?: string | SelectSource;
+    /** 内联源显式共享缓存用；注册名自带稳定键 */
+    cacheKey?: string;
+    /** 已算好的来源键，只用于给记忆分区 */
+    sourceKey: string;
+    /** 当前选中的编码，顺序即展示顺序 */
+    codes: SelectValue[];
+    /** 对象值里自带的名称，键是 `String(编码)` */
+    valueNames?: Map<string, string>;
+    seedOptions?: BizOption[];
+    candidates?: BizOption[];
+    params?: SelectParams;
+}
+export interface UseSelectedLabelsResult {
+    /** 与 `codes` 同序同长；解析不到的是只有 `value` 的占位选项 */
+    options: BizOption[];
+    status: SelectedStatus;
+    /** 批量解析实际发出的请求数，用来判断该不该要批量接口 */
+    requests: number;
+}
+export declare function useSelectedLabels({ source, cacheKey, sourceKey, codes, valueNames, seedOptions, candidates, params, }: UseSelectedLabelsOptions): UseSelectedLabelsResult;
+//# sourceMappingURL=useSelectedLabels.d.ts.map

package/dist/biz-select/useSelectedLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectedLabels.d.ts","sourceRoot":"","sources":["../../src/biz-select/useSelectedLabels.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKlF,MAAM,WAAW,wBAAwB;IACvC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,gCAAgC;IAChC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,KAAK,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,MAAM,GACP,EAAE,wBAAwB,GAAG,uBAAuB,CA0EpD"}

package/dist/biz-select/useSelectedLabels.js

@@ -0,0 +1,88 @@
+/**
+ * 多选的已选项回显。
+ *
+ * 优先级和单选的 `useSelectedLabel` 完全一致，只是按编码逐个求：
+ * 对象值自带的名称 → seedOptions → 已加载候选 → 批量解析 → 原样显示编码。
+ *
+ * 不直接改 `useResolvedLabels`：那个是公开 API（表格列回显），语义只有"批量解析"。
+ * 回显优先级是组件的事，混进去两边的契约都会变模糊。
+ */
+import { useMemo, useRef } from 'react';
+import { lookupKeyOf, paramsKeyOf } from './key.js';
+import { useResolvedLabels } from './useResolvedLabels.js';
+/** 已选项记忆的上限：搜索型源的候选会被关键词整批换掉，靠它兜底 */
+const MAX_MEMORY = 200;
+export function useSelectedLabels({ source, cacheKey, sourceKey, codes, valueNames, seedOptions, candidates, params, }) {
+    // 数组每次渲染都可能是新引用，用字符串当身份
+    const codesKey = codes.map(lookupKeyOf).join('|');
+    const paramsKey = paramsKeyOf(params);
+    // 1) 本地能查到的先命中，不发请求
+    const local = useMemo(() => {
+        const map = new Map();
+        for (const code of codes) {
+            const key = lookupKeyOf(code);
+            const valueName = valueNames?.get(key);
+            if (valueName) {
+                map.set(key, { value: code, label: valueName });
+                continue;
+            }
+            const seed = seedOptions?.find((item) => lookupKeyOf(item.value) === key);
+            if (seed) {
+                map.set(key, seed);
+                continue;
+            }
+            const candidate = candidates?.find((item) => lookupKeyOf(item.value) === key);
+            if (candidate)
+                map.set(key, candidate);
+        }
+        return map;
+    }, [codesKey, valueNames, seedOptions, candidates]);
+    // 2) 剩下的走批量解析；空数组时 Hook 自己会短路
+    const missing = useMemo(() => codes.filter((code) => !local.has(lookupKeyOf(code))), [codesKey, local]);
+    const batch = useResolvedLabels({ source, cacheKey, values: missing, params });
+    /**
+     * 已选项兜底记忆。
+     *
+     * 搜索型源的候选会随关键词整批换掉，重新展开拿到的也只是第一页，
+     * 已选项常常不在里面。按「来源 + 条件 + 编码」记住最近一次的命中，
+     * 条件一变自然失效——和单选同一套做法。
+     */
+    const memoryRef = useRef(new Map());
+    const memoryKeyOf = (code) => `${sourceKey}|${paramsKey}|${lookupKeyOf(code)}`;
+    return useMemo(() => {
+        if (!codes.length)
+            return { options: [], status: 'empty', requests: 0 };
+        let unresolved = 0;
+        const options = codes.map((code) => {
+            const key = lookupKeyOf(code);
+            const hit = local.get(key) ?? batch.byCode.get(key);
+            const option = hit ?? memoryRef.current.get(memoryKeyOf(code)) ?? { value: code };
+            if (hit) {
+                // 命中的顺手记一笔，下次候选被换掉时有得兜底
+                memoryRef.current.set(memoryKeyOf(code), hit);
+                if (memoryRef.current.size > MAX_MEMORY) {
+                    const oldest = memoryRef.current.keys().next();
+                    if (!oldest.done)
+                        memoryRef.current.delete(oldest.value);
+                }
+            }
+            if (option.label === undefined)
+                unresolved += 1;
+            return option;
+        });
+        let status = 'resolved';
+        if (unresolved > 0) {
+            if (batch.loading)
+                status = 'loading';
+            else if (batch.blocked)
+                status = 'blocked';
+            else if (batch.error)
+                status = 'error';
+            else
+                status = 'missing';
+        }
+        return { options, status, requests: batch.requests };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [codesKey, paramsKey, sourceKey, local, batch.byCode, batch.loading, batch.blocked, batch.error, batch.requests]);
+}
+//# sourceMappingURL=useSelectedLabels.js.map

package/dist/biz-select/useSelectedLabels.js.map

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

package/dist/biz-select/useStableSourceKey.d.ts

@@ -0,0 +1,3 @@
+import type { SelectSource } from './types.js';
+export declare function useStableSourceKey(source?: string | SelectSource, cacheKey?: string): string;
+//# sourceMappingURL=useStableSourceKey.d.ts.map

package/dist/biz-select/useStableSourceKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableSourceKey.d.ts","sourceRoot":"","sources":["../../src/biz-select/useStableSourceKey.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAc5C,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAwCR"}

package/dist/biz-select/useStableSourceKey.js

@@ -0,0 +1,48 @@
+/**
+ * 计算来源键，并在开发态识别「每次渲染都换键」的写法。
+ *
+ * 键在变、源的能力组合却没变，几乎只能是内联箭头函数造成的：
+ * 缓存永远不命中，表格里每个单元格各打一次接口。
+ */
+import { useCallback, useRef, useSyncExternalStore } from 'react';
+import { IS_DEV } from '../env.js';
+import { selectSourceKey } from './key.js';
+import { getSelectSourceVersion, subscribeSelectSourceVersion } from './registry.js';
+const NOOP_UNSUBSCRIBE = () => { };
+function sourceShape(source) {
+    if (!source)
+        return '';
+    return [
+        Array.isArray(source.options) ? 'o' : '-',
+        typeof source.load === 'function' ? 'l' : '-',
+        typeof source.search === 'function' ? 's' : '-',
+        typeof source.resolve === 'function' ? 'r' : '-',
+    ].join('');
+}
+export function useStableSourceKey(source, cacheKey) {
+    // 注册名的版本号只在 Map 里，改值不会触发渲染：必须订阅，sourceKey 才会跟着变，
+    // 已挂载的实例才会重新取数（invalidateSelectSource / 同名重注册由此生效）
+    const name = typeof source === 'string' ? source : '';
+    const subscribe = useCallback((listener) => name ? subscribeSelectSourceVersion(name, listener) : NOOP_UNSUBSCRIBE, [name]);
+    useSyncExternalStore(subscribe, () => (name ? getSelectSourceVersion(name) : 0), () => 0);
+    const sourceKey = selectSourceKey(source, cacheKey);
+    const previousRef = useRef({ key: sourceKey, shape: sourceShape(source) });
+    const warnedRef = useRef(false);
+    if (IS_DEV) {
+        const previous = previousRef.current;
+        const shape = sourceShape(source);
+        if (!warnedRef.current &&
+            previous.key !== sourceKey &&
+            previous.shape === shape &&
+            !cacheKey &&
+            typeof source !== 'string' &&
+            source) {
+            warnedRef.current = true;
+            console.warn('[schema] BizSelect 的 source 每次渲染都产生新的函数引用，缓存会一直失效；' +
+                '请把源提到组件外、传入导入的函数，或改用 registerSelectSource 注册');
+        }
+        previousRef.current = { key: sourceKey, shape };
+    }
+    return sourceKey;
+}
+//# sourceMappingURL=useStableSourceKey.js.map

package/dist/biz-select/useStableSourceKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableSourceKey.js","sourceRoot":"","sources":["../../src/biz-select/useStableSourceKey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAGlF,MAAM,gBAAgB,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAElC,SAAS,WAAW,CAAC,MAAqB;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACzC,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAC7C,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAC/C,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;KACjD,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAA8B,EAC9B,QAAiB;IAEjB,iDAAiD;IACjD,mDAAmD;IACnD,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,QAAoB,EAAE,EAAE,CACvB,IAAI,CAAC,CAAC,CAAC,4BAA4B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,EACxE,CAAC,IAAI,CAAC,CACP,CAAC;IACF,oBAAoB,CAClB,SAAS,EACT,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/C,GAAG,EAAE,CAAC,CAAC,CACR,CAAC;IAEF,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,MAAsB,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAsB,CAAC,CAAC;QAClD,IACE,CAAC,SAAS,CAAC,OAAO;YAClB,QAAQ,CAAC,GAAG,KAAK,SAAS;YAC1B,QAAQ,CAAC,KAAK,KAAK,KAAK;YACxB,CAAC,QAAQ;YACT,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,EACN,CAAC;YACD,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YACzB,OAAO,CAAC,IAAI,CACV,oDAAoD;gBAClD,8CAA8C,CACjD,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/flat.d.ts

@@ -0,0 +1,43 @@
+/** 对应关系：表单里哪个字段装对象，平铺结构里哪两个键装值/名称 */
+export interface FlatFieldPair {
+    /** 表单里装对象的字段名。只支持顶层字段 */
+    readonly field: string;
+    /** 平铺结构里装值的键名 */
+    readonly value: string;
+    /** 平铺结构里装名称的键名；省略表示只回传值 */
+    readonly label?: string;
+}
+/** 对象值里装值/名称的键名；不传就与平铺键同名 */
+export interface FlatObjectKeys {
+    readonly value?: string;
+    readonly label?: string;
+}
+export interface FlatFieldsOptions {
+    /**
+     * 对象值内部的键名，缺的按平铺键兜底。
+     *
+     * 默认与平铺键同名——这是新约定的写法：`valueFields` 直接照后端字段名起，
+     * 于是对象是 `{ userId, userName }`、平铺也是 `userId` / `userName`。
+     * 存量页面对象用的是 antd 默认键时传 `ANTD_OBJECT_KEYS`。
+     */
+    readonly objectKeys?: FlatObjectKeys;
+}
+/** 对象值用 antd 默认键 `{ value, label }` 时传它 */
+export declare const ANTD_OBJECT_KEYS: FlatObjectKeys;
+type FlatRecord = Record<string, unknown>;
+export interface FlatFields {
+    readonly pairs: readonly FlatFieldPair[];
+    /** 详情记录 → 表单值：平铺 → 对象。只产出声明的字段 */
+    toForm(record?: FlatRecord | null): FlatRecord;
+    /** 表单值 → 提交结构：对象 → 平铺。只产出声明的键 */
+    toPayload(values?: FlatRecord | null): FlatRecord;
+}
+/**
+ * 声明一份边界对应关系，返回两个纯函数。
+ *
+ * 声明必须显式写出来：`partyA` → `partyAId` + `partyACompanyName` 这种不对称命名，
+ * 任何自动推导都是猜（看到 `Id` 就当值、看到 `Name` 就当名称），猜错会静默串数据。
+ */
+export declare function defineFlatFields(pairs: readonly FlatFieldPair[], options?: FlatFieldsOptions): FlatFields;
+export {};
+//# sourceMappingURL=flat.d.ts.map

package/dist/flat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat.d.ts","sourceRoot":"","sources":["../src/flat.ts"],"names":[],"mappings":"AAeA,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;CACtC;AAED,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,EAAE,cAAmD,CAAC;AAEnF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,kCAAkC;IAClC,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;IAC/C,iCAAiC;IACjC,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;CACnD;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAiEZ"}

package/dist/flat.js

@@ -0,0 +1,91 @@
+/**
+ * 表单边界转换：对象值 ↔ 平铺值。
+ *
+ * 解决的是「详情平铺给出 `partyAId` + `partyACompanyName`，表单里想存一个对象」
+ * 这一类形状问题，只在两个时刻各做一次：进表单（`toForm`）和出表单（`toPayload`）。
+ * 编辑期间表单里只有一份值——不预置、不新增、不隐藏任何字段。
+ *
+ * 不依赖 React / antd，也完全不认识 BizSelect：它只认 `{ field, value, label }`
+ * 三件事的对应关系，所以日期范围、树选择、级联同样能用。
+ *
+ * 为什么不放进组件：组件只产出一个 name 一个值。任何「读/写别的字段」的能力
+ * 都会让它知道提交结构这件事，而提交结构是表单边界的问题，跟用哪个控件无关。
+ */
+import { present } from './biz-select/format.js';
+/** 对象值用 antd 默认键 `{ value, label }` 时传它 */
+export const ANTD_OBJECT_KEYS = { value: 'value', label: 'label' };
+const has = (record, key) => Object.prototype.hasOwnProperty.call(record, key);
+/**
+ * 声明一份边界对应关系，返回两个纯函数。
+ *
+ * 声明必须显式写出来：`partyA` → `partyAId` + `partyACompanyName` 这种不对称命名，
+ * 任何自动推导都是猜（看到 `Id` 就当值、看到 `Name` 就当名称），猜错会静默串数据。
+ */
+export function defineFlatFields(pairs, options = {}) {
+    // 定义期就挡掉重复：平铺键撞了会让后一个静默覆盖前一个，等到线上才发现
+    const fields = new Set();
+    const flatKeys = new Set();
+    for (const pair of pairs) {
+        if (!pair.field || !pair.value) {
+            throw new Error('flat fields：field 与 value 都是必填');
+        }
+        if (fields.has(pair.field)) {
+            throw new Error(`flat fields：表单字段重复 ${pair.field}`);
+        }
+        fields.add(pair.field);
+        for (const key of [pair.value, pair.label]) {
+            if (!key)
+                continue;
+            if (flatKeys.has(key))
+                throw new Error(`flat fields：平铺键重复 ${key}`);
+            flatKeys.add(key);
+        }
+    }
+    const objectKeysOf = (pair) => ({
+        value: options.objectKeys?.value ?? pair.value,
+        label: options.objectKeys?.label ?? pair.label ?? 'label',
+    });
+    function toForm(record) {
+        const source = record ?? {};
+        const out = {};
+        for (const pair of pairs) {
+            const keys = objectKeysOf(pair);
+            const value = source[pair.value];
+            if (!present(value)) {
+                // 显式写 undefined：表单里若有上一次回填的残留，靠这次赋值清掉
+                out[pair.field] = undefined;
+                continue;
+            }
+            const nested = { [keys.value]: value };
+            const label = pair.label ? source[pair.label] : undefined;
+            // 名称缺失就不写这个键，交给组件的 resolve / seedOptions 去补
+            if (present(label))
+                nested[keys.label] = label;
+            out[pair.field] = nested;
+        }
+        return out;
+    }
+    function toPayload(values) {
+        const form = values ?? {};
+        const out = {};
+        for (const pair of pairs) {
+            // 表单里没有这个键：说明这个表单不产出它，别用 undefined 覆盖调用方 {...data} 里的旧值
+            if (!has(form, pair.field))
+                continue;
+            const keys = objectKeysOf(pair);
+            const nested = form[pair.field];
+            const readable = nested && typeof nested === 'object' ? nested : undefined;
+            // 不是对象时按标量用：兼容迁移途中的页面（同一字段有时是对象、有时是字符串），
+            // 这正是 `payer?.value || payer || ''` 这类防御代码的来源
+            const value = readable ? readable[keys.value] : nested;
+            const label = readable && pair.label ? readable[keys.label] : undefined;
+            out[pair.value] = present(value) ? value : undefined;
+            // 键存在但值被清空时也显式给 undefined：两个平铺键要一起清，否则旧值从 {...data} 里漏出来
+            if (pair.label)
+                out[pair.label] = present(label) ? label : undefined;
+        }
+        return out;
+    }
+    return { pairs, toForm, toPayload };
+}
+//# sourceMappingURL=flat.js.map

package/dist/flat.js.map

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

package/dist/form/SchemaFormField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaFormField.d.ts","sourceRoot":"","sources":["../../src/form/SchemaFormField.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AAO5F,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkBD,iBAAS,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,+BAQxD;AAED,eAAO,MAAM,eAAe,kEAA6B,CAAC"}
+{"version":3,"file":"SchemaFormField.d.ts","sourceRoot":"","sources":["../../src/form/SchemaFormField.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AAO5F,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkBD,iBAAS,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,+BAaxD;AAED,eAAO,MAAM,eAAe,kEAA6B,CAAC"}

package/dist/form/SchemaFormField.js

@@ -11,7 +11,7 @@ import { Form } from 'antd';
 import { IS_DEV } from '../env.js';
 import { SchemaField } from '../SchemaField.js';
 import { useFormRuntimeHost } from './FormRuntimeHost.js';
-import { deriveFieldState, withDerivedProps } from './derive.js';
+import { deriveFieldState, normalizeFieldSchema, withDerivedProps } from './derive.js';
 import { dedupeNamePaths, getNestedValue, namePathKey } from './namePath.js';
 const EMPTY_DEPS = [];
 /** 漏写 dependencies 的字段已提醒过，按字段名去重，避免千格表格刷屏 */
@@ -28,12 +28,13 @@ function warnMissingDependencies(schema) {
     console.warn(`[schema] 字段 "${key}" 配了 dynamic 却没有 dependencies，将按静态字段渲染`);
 }
 function SchemaFormFieldInner(props) {
-    const { schema } = props;
+    // 归一化必须早于 dynamic 判断：类型专有属性可能就地编译出 dependencies
+    const schema = normalizeFieldSchema(props.schema);
     const dependencies = schema.dynamic?.dependencies;
     if (IS_DEV && schema.dynamic && !dependencies)
         warnMissingDependencies(schema);
     const reactive = Boolean(dependencies?.length || schema.linkage?.some((rule) => rule.immediate));
-    return reactive ? _jsx(ReactiveField, { ...props }) : _jsx(FieldBody, { ...props });
+    return reactive ? (_jsx(ReactiveField, { ...props, schema: schema })) : (_jsx(FieldBody, { ...props, schema: schema }));
 }
 export const SchemaFormField = memo(SchemaFormFieldInner);
 function FieldBody({ schema, compact, mode, disabled }) {

package/dist/form/SchemaFormField.js.map

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

package/dist/form/derive.d.ts

@@ -1,11 +1,4 @@
-/**
- * 字段状态的统一派生（统一运行契约 §3）。
- *
- * `dynamic` 是字段的运行时派生配置，不是编辑态专属配置：
- * 编辑态与只读态必须共用这一份求值逻辑，两种模式只在
- * 属性下发、校验、事件与写入行为上不同，派生结果本身一致。
- */
-import type { FieldSchema, FormFieldSchema, ReadContext, Rule } from '../types.js';
+import type { AnyFormFieldSchema, FieldSchema, FormFieldSchema, ReadContext, Rule } from '../types.js';
 export interface DerivedFieldState {
     /** 显示优先级：dynamic.visible > visible > !hidden > true */
     visible: boolean;
@@ -16,6 +9,8 @@ export interface DerivedFieldState {
     /** 隐藏时规则为空：隐藏期间跳过校验 */
     rules: Rule[];
 }
+/** 按注册的字段类型归一化字段定义；没有 normalize 的类型原样返回 */
+export declare function normalizeFieldSchema<T extends AnyFormFieldSchema>(schema: T): T;
 /**
  * 计算字段当前的有效状态。派生函数必须是纯函数，只依赖 dynamic.dependencies 声明的字段。
  */

package/dist/form/derive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/form/derive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAW,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGzF,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uBAAuB;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAqBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAsB7F;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpD,MAAM,EAAE,CAAC,EACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAMpE"}
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/form/derive.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAW,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAG7G,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uBAAuB;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AA8BD,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAQ/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAsB7F;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpD,MAAM,EAAE,CAAC,EACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAMpE"}