@tianyr/schema-antd 0.1.0 → 0.2.0

package/README.md

@@ -1,11 +1,12 @@
 # schema-antd
 
-基于 antd v5 的 Schema 驱动表单与可编辑表格。一份扁平的字段配置，同时用于普通表单、
+基于 antd v5 的 Schema 驱动表单、可编辑表格与业务下拉。一份扁平的字段配置，同时用于普通表单、
 单活动行编辑表格和全行常驻编辑表格，字段的显隐、禁用、校验、选项和联动都由配置描述。
 
 - **不内置 antd**：`antd` / `react` 全部是 peer 依赖，产物只有 ESM 与类型声明
 - **一份绑定层**：普通表单和两种表格的行复用同一个字段绑定，联动语义完全一致
 - **可编辑列三态**：`true` 编辑、`'read'` 只读但跟随本行 Form（能看到联动带出的值）、`false` 直接读行记录
+- **业务下拉**：`BizSelect` 把候选来源、名称回显、级联接入收进一个组件，值默认存标量；选项契约 `{ value, label }`
 
 ## 安装
 
@@ -117,26 +118,68 @@ const columns: EditableColumn<OrderRow>[] = [
 />
 ```
 
-## AppSelect
+## BizSelect
 
-带搜索与回显分离的远程选择器。候选源在应用启动时注册一次：
+业务下拉：候选从哪来、只有一个编码时名称怎么还原、切换上级后旧候选怎么办。
+值默认是标量编码（`valueMode="object"` 可存对象），字段类型由使用方显式注册。
 
 ```ts
-import { registerAppSelectSource } from '@tianyr/schema-antd'
-
-registerAppSelectSource('product', {
-  kind: 'remote',
-  search: (keyword, params, signal) => api.searchProduct(keyword, params, signal),
-  resolve: (id, params, signal) => api.getProduct(id, params, signal),
-  requiredParams: ['companyId'],   // 缺任一参数就不发请求
+import { defineSelectSources, loaded, remote, staticList } from '@tianyr/schema-antd'
+
+defineSelectSources({
+  province: staticList(PROVINCES),        // 前端常量，不发请求
+  currency: loaded(api.listCurrency),     // 一次拉全量，之后前端过滤
+  material: remote({                      // 关键词交给后端，另配编码精确回显
+    recordFields: { value: 'code', label: 'name' },   // 后端记录字段名 → 契约 { value, label }
+    search: (keyword, params, signal) => api.pageMaterial({ keyword, ...params }, signal),
+    resolve: (code, params, signal) => api.getMaterial(code, params, signal),
+    requiredParams: ['warehouseCode'],    // 缺参数不发请求，避免查到别家数据
+  }),
 })
 ```
 
 ```tsx
-{ type: 'AppSelect', name: 'productId', label: '物料', props: { source: 'product', queryParams: { companyId } } }
+// 独立使用：受控，value / onChange 必配
+<BizSelect source="currency" value={currency} onChange={setCurrency} />
+
+// 只读：同一套名称解析，不挂 Select
+<BizSelectDisplay source="material" params={{ warehouseCode }} value={materialCode} />
+
+// 多选：独立组件，值是编码数组（schema 里的类型名是 'BizMultiSelect'）
+<BizMultiSelect source="material" params={{ warehouseCode }} value={codes} onChange={setCodes} />
 ```
 
-页面局部接口不必注册，直接把源对象传给 `dataSource`。
+多选刻意不做成 `mode` 属性：值类型属于 API 面，合并会把 `BizSelectProps.value` 拓宽成联合。
+候选、搜索、展示转换、批量解析与单选完全共用；清空时输出 `undefined`（不是 `[]`），
+这样 `required` 规则天然生效。
+
+在 schema 里用，级联一行配完（先调一次 `registerBizSelectField()` 注册类型）：
+
+```tsx
+{
+  type: 'BizSelect',
+  name: 'materialCode',
+  label: '物料',
+  source: 'material',
+  paramsFrom: { warehouseCode: 'warehouseCode' },   // 参数名 ← 字段名
+  blockedText: '请先选择仓库',
+}
+```
+
+约定：
+
+- 选项契约是 `{ value, label }`，和 antd 同词汇；后端 `{ code, name }`、`{ userId, userName }` 在源的
+  `recordFields` 上映射一次（`staticList(list, recordFields)`，`loaded(load, { recordFields })`，`remote({ recordFields })`）。
+  没声明就视为已经是 `{ value, label }`，不做自动嗅探。
+- 行为由源的能力推导：`options` 前端常量、`load` 一次拉全量后前端过滤、`search` 后端搜索，三者可组合。
+- `resolve(value)` 专用于按值精确回显，不要用模糊搜索冒充。
+- `requiredParams` 不齐时进入 `blocked`：候选为空、不发请求。
+- `invalidateSelectSource(name)` 让已挂载的实例重新取数；`useCandidates` 可把同一份候选给树、弹窗复用。
+- 表格列只有 id 时用 `useResolvedLabels` 批量解析：源声明了 `resolveMany` 才会合并成一次请求，
+  没声明就逐条（开发态告警一次）。有限枚举的列应该用 `load` 型源一次拉全量，不必逐条解析。
+- 内联源要跨实例共享缓存，就传导入的函数或显式 `cacheKey`；内联箭头每次渲染都换键，缓存命中不了。
+- 已经是 `{ value, label }` 形状的本地枚举（数据字典、常量表）直接 `staticList` 即可，不必再写 `recordFields`；
+  分组选项和树形选项不在范围内（契约是扁平结构）。详见 `src/biz-select/README.md` §4。
 
 ## 其他导出
 
@@ -154,6 +197,8 @@ registerAppSelectSource('product', {
   不影响功能，只是少几条开发提示。
 - `virtual` 不开放：虚拟滚动会卸载离屏行，全行常驻表格的行 Form 会随之销毁、输入丢失。
 
+版本变更见 [CHANGELOG.md](./CHANGELOG.md)。
+
 ## License
 
 MIT

package/dist/SchemaField.d.ts

@@ -2,7 +2,7 @@ import type { AnyFieldSchema, FieldMode } from './types.js';
 export interface SchemaFieldProps<TValue = unknown> {
     schema: AnyFieldSchema<TValue>;
     value?: TValue;
-    /** 统一为 (value, ...meta)；Select/AppSelect 的 meta[0] 即选中项 */
+    /** 统一为 (value, ...meta)；Select/BizSelect 的 meta[0] 即选中项 */
     onChange?: (value: TValue, ...meta: unknown[]) => void;
     /** 高于 schema.mode */
     mode?: FieldMode;

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

@@ -0,0 +1,3 @@
+import type { BizMultiSelectProps } from './types.js';
+export declare function BizMultiSelect(props: BizMultiSelectProps): import("react").JSX.Element;
+//# sourceMappingURL=BizMultiSelect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizMultiSelect.d.ts","sourceRoot":"","sources":["../../src/biz-select/BizMultiSelect.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,mBAAmB,EAAqC,MAAM,SAAS,CAAC;AAetF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BAsIxD"}

package/dist/biz-select/BizMultiSelect.js

@@ -0,0 +1,120 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BizMultiSelect：业务下拉的多选态。
+ *
+ * 和 `BizSelect` 共用候选、展示转换和批量解析，差别只在值：
+ * 一个是标量/对象，一个是它们的数组。刻意做成独立组件而不是 `mode` 属性，
+ * 因为值类型属于 API 面——合并会把 `BizSelectProps.value` 拓宽成联合，
+ * 所有存量调用点跟着变宽，而我们没有任何地方需要这种兼容。
+ */
+import { useEffect, useMemo } from 'react';
+import { Select } from 'antd';
+import { normalizeSource } from './normalize.js';
+import { resolveSelectSource } from './registry.js';
+import { useCandidates } from './useCandidates.js';
+import { useSelectedLabels } from './useSelectedLabels.js';
+import { buildObjectValues, defaultSearchFields, readObjectLabels, readValues, toAntOption, } from './format.js';
+const DEFAULT_BLOCKED_TEXT = '请先选择上级';
+/** antd 在多选下回传的是已选项数组；单选偶发单个对象，两种都接住 */
+function pickedOptions(antOption) {
+    const list = Array.isArray(antOption) ? antOption : antOption ? [antOption] : [];
+    const picked = [];
+    for (const item of list) {
+        const raw = item?.raw;
+        if (raw)
+            picked.push(raw);
+    }
+    return picked;
+}
+export function BizMultiSelect(props) {
+    const { source, params, displayMode = 'L', searchFields, seedOptions, debounceMs, cacheKey, blockedText = DEFAULT_BLOCKED_TEXT, valueMode = 'primitive', valueFields, value, onChange, disabled, placeholder, ...rest } = props;
+    const codes = readValues(value, valueMode, valueFields);
+    const valueNames = readObjectLabels(value, valueMode, valueFields);
+    const sourceObj = resolveSelectSource(source);
+    const candidates = useCandidates({
+        source,
+        cacheKey,
+        params,
+        searchFields: searchFields ?? defaultSearchFields(displayMode),
+        debounceMs,
+    });
+    const { sourceKey } = candidates;
+    const selected = useSelectedLabels({
+        source,
+        cacheKey,
+        sourceKey,
+        codes,
+        valueNames,
+        seedOptions,
+        // 回显查未过滤全集，否则输入关键词后已选项会被筛掉、名称退回编码
+        candidates: candidates.echoOptions,
+        params,
+    });
+    // load 型没有 resolve，名称只能从全集里找：只要有编码说不清名字就先拉一次
+    const needEchoLoad = selected.status === 'missing' && normalizeSource(sourceObj).candidateMode === 'load';
+    useEffect(() => {
+        if (needEchoLoad)
+            candidates.open();
+    }, [needEchoLoad, sourceKey, candidates.open]);
+    const byCode = useMemo(() => {
+        const map = new Map();
+        for (const option of candidates.options)
+            map.set(String(option.value), option);
+        for (const option of selected.options)
+            map.set(String(option.value), option);
+        return map;
+    }, [candidates.options, selected.options]);
+    /**
+     * 已选项始终补回候选。
+     *
+     * 单选在搜索态会跳过补回（避免结果里混进一条不匹配的记录），多选不能这么做：
+     * antd 的 tag 文本是从候选里查的，候选里没有就退化成裸编码，搜索时整排 tag 一起变编码，
+     * 比多一行已选项难看得多。
+     */
+    const antOptions = useMemo(() => {
+        const list = candidates.options.map((item) => toAntOption(item, displayMode));
+        const present = new Set(list.map((item) => String(item.value)));
+        for (const option of selected.options) {
+            const key = String(option.value);
+            if (present.has(key))
+                continue;
+            present.add(key);
+            list.push(toAntOption(option, displayMode));
+        }
+        return list;
+    }, [candidates.options, selected.options, displayMode]);
+    const handleChange = (next, antOption) => {
+        const list = (Array.isArray(next) ? next : []).filter((item) => item !== undefined && item !== null && item !== '');
+        const emit = onChange;
+        // 清空给 undefined 而不是 []：与 ctx.clear() 一致，也让 required 规则天然生效
+        if (!list.length) {
+            emit?.(undefined, []);
+            return;
+        }
+        // 刚选中/刚取消的项 antd 会给回来：以它为准，再退回候选和已解析结果
+        const picked = new Map();
+        for (const option of pickedOptions(antOption))
+            picked.set(String(option.value), option);
+        const lookup = (code) => picked.get(String(code)) ?? byCode.get(String(code));
+        const options = list.map((code) => lookup(code) ?? { value: code });
+        if (valueMode === 'object') {
+            const objectMap = new Map();
+            for (const option of options)
+                objectMap.set(String(option.value), option);
+            emit?.(buildObjectValues(list, objectMap, valueFields), options);
+            return;
+        }
+        emit?.(list, options);
+    };
+    return (_jsx(Select, { ...rest, mode: "multiple", 
+        // 候选由数据源决定，一律关掉 antd 自带过滤：本地过滤已在 hook 里做
+        filterOption: false, showSearch: true, options: antOptions, value: codes, loading: candidates.loading || selected.status === 'loading' || rest.loading, disabled: disabled || candidates.blocked, placeholder: candidates.blocked ? blockedText : placeholder, notFoundContent: candidates.blocked ? (blockedText) : candidates.error ? (
+        // 失败得能重试：静默给一个空列表等于让用户以为「确实没有」
+        _jsx("a", { onClick: () => candidates.reload(), children: "\u52A0\u8F7D\u5931\u8D25\uFF0C\u70B9\u51FB\u91CD\u8BD5" })) : (rest.notFoundContent), onSearch: candidates.search, onChange: handleChange, onDropdownVisibleChange: (opened) => {
+            if (opened)
+                candidates.open();
+            else
+                candidates.resetKeyword();
+        } }));
+}
+//# sourceMappingURL=BizMultiSelect.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { BizMultiSelectDisplayProps } from './types.js';
+export declare function BizMultiSelectDisplay(props: BizMultiSelectDisplayProps): import("react").JSX.Element;
+//# sourceMappingURL=BizMultiSelectDisplay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizMultiSelectDisplay.d.ts","sourceRoot":"","sources":["../../src/biz-select/BizMultiSelectDisplay.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAa1D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,+BAkDtE"}

package/dist/biz-select/BizMultiSelectDisplay.js

@@ -0,0 +1,59 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BizMultiSelect 的只读态。
+ *
+ * 与 `BizSelectDisplay` 对称：复用同一套名称解析，不挂载 Select。
+ * 解析不出的编码原样显示——宁可露出「查不到」，也不要编一个名字出来。
+ */
+import { useEffect } from 'react';
+import { EMPTY, defaultSearchFields, formatLabel, readObjectLabels, readValues } from './format.js';
+import { normalizeSource } from './normalize.js';
+import { resolveSelectSource } from './registry.js';
+import { useCandidates } from './useCandidates.js';
+import { useSelectedLabels } from './useSelectedLabels.js';
+/** 与 read.tsx 的 MULTI_SEPARATOR 保持一致 */
+const DEFAULT_SEPARATOR = '、';
+/** 状态说明挂在 title 上：不能把「没查到」误认为「业务值为空」 */
+const STATUS_TITLE = {
+    loading: '正在解析名称',
+    missing: '部分名称未找到，显示原始值',
+    blocked: '缺少必需参数，未解析名称',
+    error: '名称解析失败，显示原始值',
+};
+export function BizMultiSelectDisplay(props) {
+    const { source, params, displayMode = 'L', seedOptions, cacheKey, emptyText = EMPTY, valueMode = 'primitive', valueFields, value, separator = DEFAULT_SEPARATOR, } = props;
+    const sourceObj = resolveSelectSource(source);
+    const codes = readValues(value, valueMode, valueFields);
+    const valueNames = readObjectLabels(value, valueMode, valueFields);
+    // 只有 load 型需要为回显拉一次全集：它没有 resolve，名称只能从全集里找
+    const candidates = useCandidates({
+        source,
+        cacheKey,
+        params,
+        searchFields: defaultSearchFields(displayMode),
+    });
+    const { sourceKey } = candidates;
+    const selected = useSelectedLabels({
+        source,
+        cacheKey,
+        sourceKey,
+        codes,
+        valueNames,
+        seedOptions,
+        candidates: candidates.echoOptions,
+        params,
+    });
+    const needEchoLoad = selected.status === 'missing' && normalizeSource(sourceObj).candidateMode === 'load';
+    useEffect(() => {
+        if (needEchoLoad)
+            candidates.open();
+    }, [needEchoLoad, sourceKey, candidates.open]);
+    if (!codes.length)
+        return _jsx(_Fragment, { children: emptyText });
+    // 只返回内容本身：外层 schema-field-read 由 SchemaField 统一包，
+    // 这里再套一层会得到双层 span。title 只在解析异常时挂。
+    const text = selected.options.map((option) => formatLabel(option, displayMode)).join(separator);
+    const title = STATUS_TITLE[selected.status];
+    return title ? _jsx("span", { title: title, children: text }) : _jsx(_Fragment, { children: text });
+}
+//# sourceMappingURL=BizMultiSelectDisplay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizMultiSelectDisplay.js","sourceRoot":"","sources":["../../src/biz-select/BizMultiSelectDisplay.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,wCAAwC;AACxC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,wCAAwC;AACxC,MAAM,YAAY,GAA4C;IAC5D,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,cAAc;IACvB,KAAK,EAAE,cAAc;CACtB,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,MAAM,EACJ,MAAM,EACN,MAAM,EACN,WAAW,GAAG,GAAG,EACjB,WAAW,EACX,QAAQ,EACR,SAAS,GAAG,KAAK,EACjB,SAAS,GAAG,WAAW,EACvB,WAAW,EACX,KAAK,EACL,SAAS,GAAG,iBAAiB,GAC9B,GAAG,KAAK,CAAC;IAEV,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAEnE,4CAA4C;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC;QAC/B,MAAM;QACN,QAAQ;QACR,MAAM;QACN,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC;KAC/C,CAAC,CAAC;IACH,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IAEjC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;QACjC,MAAM;QACN,QAAQ;QACR,SAAS;QACT,KAAK;QACL,UAAU;QACV,WAAW;QACX,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC;IAC1G,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY;YAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,4BAAG,SAAS,GAAI,CAAC;IAE3C,kDAAkD;IAClD,mCAAmC;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,eAAM,KAAK,EAAE,KAAK,YAAG,IAAI,GAAQ,CAAC,CAAC,CAAC,4BAAG,IAAI,GAAI,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { BizSelectProps } from './types.js';
+export declare function BizSelect(props: BizSelectProps): import("react").JSX.Element;
+//# sourceMappingURL=BizSelect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizSelect.d.ts","sourceRoot":"","sources":["../../src/biz-select/BizSelect.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAa,cAAc,EAA0B,MAAM,SAAS,CAAC;AAIjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,+BAmH9C"}

package/dist/biz-select/BizSelect.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BizSelect：业务下拉的可编辑态。
+ *
+ * 渲染层只吃「候选列表 + 已选名称 + 展示模式」，不认识 load / search / resolve。
+ * 所有取数与解析都在 hook 里完成。
+ */
+import { useEffect, useMemo } from 'react';
+import { Select } from 'antd';
+import { normalizeSource } from './normalize.js';
+import { resolveSelectSource } from './registry.js';
+import { useCandidates } from './useCandidates.js';
+import { useSelectedLabel } from './useSelectedLabel.js';
+import { buildObjectValue, defaultSearchFields, readObjectLabel, readValue, toAntOption, } from './format.js';
+const DEFAULT_BLOCKED_TEXT = '请先选择上级';
+export function BizSelect(props) {
+    const { source, params, displayMode = 'L', searchFields, seedOptions, debounceMs, cacheKey, blockedText = DEFAULT_BLOCKED_TEXT, valueMode = 'primitive', valueFields, value, onChange, disabled, placeholder, ...rest } = props;
+    const sourceObj = resolveSelectSource(source);
+    const fields = searchFields ?? defaultSearchFields(displayMode);
+    const code = readValue(value, valueMode, valueFields);
+    const valueName = readObjectLabel(value, valueMode, valueFields);
+    // 源直接交给 Hook：解析与来源键（含版本订阅）都在里面，组件不再自己算一份
+    const candidates = useCandidates({
+        source,
+        cacheKey,
+        params,
+        searchFields: fields,
+        debounceMs,
+    });
+    const { sourceKey } = candidates;
+    const selected = useSelectedLabel({
+        source: sourceObj,
+        sourceKey,
+        code,
+        valueName,
+        seedOptions,
+        // 回显查的是未过滤全集，否则输入关键词后已选项会被筛掉、名称退回编码
+        candidates: candidates.echoOptions,
+        params,
+    });
+    // 只有 load 型需要为了回显提前拉一次全集：它没有 resolve，名称只能从全集里找。
+    // 对象值自带名称、seed 已命中时不用拉。
+    const hasKnownName = Boolean(valueName) || Boolean(seedOptions?.some((item) => item.value === code));
+    const needEchoLoad = code !== undefined && !hasKnownName && normalizeSource(sourceObj).candidateMode === 'load';
+    useEffect(() => {
+        if (needEchoLoad)
+            candidates.open();
+    }, [needEchoLoad, sourceKey, candidates.open]);
+    // 搜索中不要补回已选项：否则结果里会混进一条不匹配的记录。
+    // 关闭下拉后 keyword 归零，已选项会重新补回，闭合态照常显示名称。
+    // 取数失败时也不补：补上一条会让列表非空，antd 就不渲染 notFoundContent，
+    // 重试入口跟着被藏起来，用户只看到孤零零一条已选项。
+    const searching = candidates.keyword.trim().length > 0;
+    const antOptions = useMemo(() => {
+        const list = candidates.options.map((item) => toAntOption(item, displayMode));
+        if (searching || candidates.error)
+            return list;
+        const selectedOption = selected.option;
+        if (selectedOption && !list.some((item) => item.value === selectedOption.value)) {
+            list.unshift(toAntOption(selectedOption, displayMode));
+        }
+        return list;
+    }, [candidates.options, candidates.error, displayMode, selected.option, searching]);
+    const handleChange = (next, antOption) => {
+        const picked = antOption?.raw ??
+            antOptions.find((item) => item.value === next)?.raw;
+        const emit = onChange;
+        if (valueMode === 'object') {
+            emit?.(next === undefined || next === null ? undefined : buildObjectValue(next, picked, valueFields), picked);
+            return;
+        }
+        emit?.(next ?? undefined, picked);
+    };
+    return (_jsx(Select, { ...rest, 
+        // 候选由数据源决定，一律关掉 antd 自带过滤：本地过滤已在 hook 里做
+        filterOption: false, showSearch: true, options: antOptions, value: code, loading: candidates.loading || selected.status === 'loading' || rest.loading, disabled: disabled || candidates.blocked, placeholder: candidates.blocked ? blockedText : placeholder, notFoundContent: candidates.blocked ? (blockedText) : candidates.error ? (
+        // 失败得能重试：静默给一个空列表等于让用户以为「确实没有」
+        _jsx("a", { onClick: () => candidates.reload(), children: "\u52A0\u8F7D\u5931\u8D25\uFF0C\u70B9\u51FB\u91CD\u8BD5" })) : (rest.notFoundContent), onSearch: candidates.search, onChange: handleChange, onDropdownVisibleChange: (opened) => {
+            // 只有展开时才取默认候选，避免挂载即发请求
+            if (opened)
+                candidates.open();
+            else
+                candidates.resetKeyword();
+            rest.onDropdownVisibleChange?.(opened);
+        } }));
+}
+//# sourceMappingURL=BizSelect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizSelect.js","sourceRoot":"","sources":["../../src/biz-select/BizSelect.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,WAAW,GACZ,MAAM,UAAU,CAAC;AAGlB,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAEtC,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EACJ,MAAM,EACN,MAAM,EACN,WAAW,GAAG,GAAG,EACjB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,GAAG,oBAAoB,EAClC,SAAS,GAAG,WAAW,EACvB,WAAW,EACX,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,GAAG,IAAI,EACR,GAAG,KAAmD,CAAC;IAExD,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,YAAY,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEhE,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAEjE,yCAAyC;IACzC,MAAM,UAAU,GAAG,aAAa,CAAC;QAC/B,MAAM;QACN,QAAQ;QACR,MAAM;QACN,YAAY,EAAE,MAAM;QACpB,UAAU;KACX,CAAC,CAAC;IACH,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IAEjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;QAChC,MAAM,EAAE,SAAS;QACjB,SAAS;QACT,IAAI;QACJ,SAAS;QACT,WAAW;QACX,oCAAoC;QACpC,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,MAAM;KACP,CAAC,CAAC;IAEH,gDAAgD;IAChD,wBAAwB;IACxB,MAAM,YAAY,GAChB,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;IAClF,MAAM,YAAY,GAChB,IAAI,KAAK,SAAS,IAAI,CAAC,YAAY,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC;IAC7F,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY;YAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,uCAAuC;IACvC,iDAAiD;IACjD,4BAA4B;IAC5B,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;QAC9E,IAAI,SAAS,IAAI,UAAU,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,IAAI,cAAc,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAEpF,MAAM,YAAY,GAAG,CAAC,IAA6B,EAAE,SAAkB,EAAE,EAAE;QACzE,MAAM,MAAM,GACT,SAA6C,EAAE,GAAG;YACnD,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC;QACtD,MAAM,IAAI,GAAG,QAA0E,CAAC;QAExF,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;YAC9G,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,IAAI,SAAS,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,OAAO,CACL,KAAC,MAAM,OACD,IAAI;QACR,yCAAyC;QACzC,YAAY,EAAE,KAAK,EACnB,UAAU,QACV,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,IAAI,EACX,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,EAC5E,QAAQ,EAAE,QAAQ,IAAI,UAAU,CAAC,OAAO,EACxC,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAC3D,eAAe,EACb,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CACnB,WAAW,CACZ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,+BAA+B;QAC/B,YAAG,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,uEAAe,CACrD,CAAC,CAAC,CAAC,CACF,IAAI,CAAC,eAAe,CACrB,EAEH,QAAQ,EAAE,UAAU,CAAC,MAAM,EAC3B,QAAQ,EAAE,YAAY,EACtB,uBAAuB,EAAE,CAAC,MAAM,EAAE,EAAE;YAClC,uBAAuB;YACvB,IAAI,MAAM;gBAAE,UAAU,CAAC,IAAI,EAAE,CAAC;;gBACzB,UAAU,CAAC,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,uBAAuB,EAAE,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC,GACD,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { BizSelectDisplayProps } from './types.js';
+export declare function BizSelectDisplay(props: BizSelectDisplayProps): import("react").JSX.Element;
+//# sourceMappingURL=BizSelectDisplay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizSelectDisplay.d.ts","sourceRoot":"","sources":["../../src/biz-select/BizSelectDisplay.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAUrD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAmD5D"}

package/dist/biz-select/BizSelectDisplay.js

@@ -0,0 +1,58 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BizSelect 的只读态。
+ *
+ * 复用同一套名称解析，但不挂载 Select：只读列表里成百上千个单元格
+ * 不该为了显示一个名称付出一个交互组件的代价。
+ */
+import { useEffect } from 'react';
+import { EMPTY, defaultSearchFields, formatLabel, readObjectLabel, readValue } from './format.js';
+import { normalizeSource } from './normalize.js';
+import { resolveSelectSource } from './registry.js';
+import { useCandidates } from './useCandidates.js';
+import { useSelectedLabel } from './useSelectedLabel.js';
+/** 状态说明挂在 title 上：用户不能把「没查到」误认为「业务值为空」 */
+const STATUS_TITLE = {
+    loading: '正在解析名称',
+    missing: '未找到对应名称，显示原始值',
+    blocked: '缺少必需参数，未解析名称',
+    error: '名称解析失败，显示原始值',
+};
+export function BizSelectDisplay(props) {
+    const { source, params, displayMode = 'L', seedOptions, cacheKey, emptyText = EMPTY, valueMode = 'primitive', valueFields, value, } = props;
+    const sourceObj = resolveSelectSource(source);
+    const code = readValue(value, valueMode, valueFields);
+    const valueName = readObjectLabel(value, valueMode, valueFields);
+    // 只有 load 型需要为回显拉一次全集：它没有 resolve，名称只能从全集里找
+    const candidates = useCandidates({
+        source,
+        cacheKey,
+        params,
+        searchFields: defaultSearchFields(displayMode),
+    });
+    const { sourceKey } = candidates;
+    // 对象值自带名称、seed 已命中时不用为了回显拉全集
+    const hasKnownName = Boolean(valueName) || Boolean(seedOptions?.some((item) => item.value === code));
+    const needEchoLoad = code !== undefined && !hasKnownName && normalizeSource(sourceObj).candidateMode === 'load';
+    useEffect(() => {
+        if (needEchoLoad)
+            candidates.open();
+    }, [needEchoLoad, sourceKey, candidates.open]);
+    const { option, status } = useSelectedLabel({
+        source: sourceObj,
+        sourceKey,
+        code,
+        valueName,
+        seedOptions,
+        candidates: candidates.echoOptions,
+        params,
+    });
+    if (status === 'empty' || !option)
+        return _jsx(_Fragment, { children: emptyText });
+    // 只返回内容本身：外层 schema-field-read 由 SchemaField 统一包，
+    // 这里再套一层会得到双层 span。title 只在解析异常时挂，正常态不产生额外节点。
+    const text = formatLabel(option, displayMode);
+    const title = STATUS_TITLE[status];
+    return title ? _jsx("span", { title: title, children: text }) : _jsx(_Fragment, { children: text });
+}
+//# sourceMappingURL=BizSelectDisplay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BizSelectDisplay.js","sourceRoot":"","sources":["../../src/biz-select/BizSelectDisplay.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,0CAA0C;AAC1C,MAAM,YAAY,GAA4C;IAC5D,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,cAAc;IACvB,KAAK,EAAE,cAAc;CACtB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EACJ,MAAM,EACN,MAAM,EACN,WAAW,GAAG,GAAG,EACjB,WAAW,EACX,QAAQ,EACR,SAAS,GAAG,KAAK,EACjB,SAAS,GAAG,WAAW,EACvB,WAAW,EACX,KAAK,GACN,GAAG,KAAK,CAAC;IAEV,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAEjE,4CAA4C;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC;QAC/B,MAAM;QACN,QAAQ;QACR,MAAM;QACN,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC;KAC/C,CAAC,CAAC;IACH,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IACjC,6BAA6B;IAC7B,MAAM,YAAY,GAChB,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;IAClF,MAAM,YAAY,GAChB,IAAI,KAAK,SAAS,IAAI,CAAC,YAAY,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC;IAC7F,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY;YAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC;QAC1C,MAAM,EAAE,SAAS;QACjB,SAAS;QACT,IAAI;QACJ,SAAS;QACT,WAAW;QACX,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,4BAAG,SAAS,GAAI,CAAC;IAE3D,kDAAkD;IAClD,8CAA8C;IAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,CAAC,CAAC,eAAM,KAAK,EAAE,KAAK,YAAG,IAAI,GAAQ,CAAC,CAAC,CAAC,4BAAG,IAAI,GAAI,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * 候选与解析的共享缓存。
+ *
+ * 表格式页面里同一列的几十个单元格会各调一次源，因此在**来源键**这一层共享：
+ * 同键并发只发一次请求，失败不缓存。
+ * 调用方各自的取消只影响自己的状态更新，不打断共享中的请求。
+ */
+import type { BizOption } from './types.js';
+export declare function loadCandidatesWithCache(key: string, loader: () => Promise<BizOption[]>): Promise<BizOption[]>;
+/** 丢掉单条候选缓存：reload() 要真正重取，不能又命中同一份 */
+export declare function dropCandidateCache(key: string): void;
+/**
+ * 只看缓存、不发起请求：批量解析用它先把已命中的挑出来，
+ * 免得已经查过的编码还被塞进批量请求里占位。
+ */
+export declare function peekResolved(key: string): Promise<BizOption | null> | undefined;
+/** 丢掉单条解析缓存：`reload()` 要真正重查，不能又命中同一份 */
+export declare function dropResolvedCache(key: string): void;
+export declare function resolveCodeWithCache(key: string, loader: () => Promise<BizOption | null>): Promise<BizOption | null>;
+export declare function clearSelectCacheOfSource(sourceKey: string): void;
+export declare function clearSelectCache(): void;
+export declare function getSelectCacheSize(): number;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/biz-select/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AA2FzC,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,GACjC,OAAO,CAAC,SAAS,EAAE,CAAC,CA2BtB;AAED,uCAAuC;AACvC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,CAE/E;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GACtC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAgB3B;AAOD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQhE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}