@tianyr/schema-antd 0.1.0 → 0.1.1

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` 把候选来源、编码回显、级联接入收进一个组件，值默认存编码
 
 ## 安装
 
@@ -117,26 +118,53 @@ 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({                      // 关键词交给后端，另配编码精确回显
+    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 里用，级联一行配完（先调一次 `registerBizSelectField()` 注册类型）：
+
+```tsx
+{
+  type: 'BizSelect',
+  name: 'materialCode',
+  label: '物料',
+  source: 'material',
+  paramsFrom: { warehouseCode: 'warehouseCode' },   // 参数名 ← 字段名
+  blockedText: '请先选择仓库',
+}
 ```
 
-页面局部接口不必注册，直接把源对象传给 `dataSource`。
+约定：
+
+- 行为由源的能力推导：`options` 前端常量、`load` 一次拉全量后前端过滤、`search` 后端搜索，三者可组合。
+- `resolve(code)` 专用于按编码精确回显，不要用模糊搜索冒充。
+- `requiredParams` 不齐时进入 `blocked`：候选为空、不发请求。
+- `invalidateSelectSource(name)` 让已挂载的实例重新取数；`useCandidates` 可把同一份候选给树、弹窗复用。
+- 内联源要跨实例共享缓存，就传导入的函数或显式 `cacheKey`；内联箭头每次渲染都换键，缓存命中不了。
 
 ## 其他导出
 
@@ -154,6 +182,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/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,EAAyB,MAAM,SAAS,CAAC;AAIhF,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, readCode, readObjectName, 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 = readCode(value, valueMode, valueFields);
+    const valueName = readObjectName(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.code === 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.code)) {
+            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":"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"}

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, readCode, readObjectName } 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 = readCode(value, valueMode, valueFields);
+    const valueName = readObjectName(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.code === 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,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC7F,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,gBAAgB;IACzB,OAAO,EAAE,cAAc;IACvB,KAAK,EAAE,eAAe;CACvB,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,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAEhE,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,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;IACjF,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,16 @@
+/**
+ * 候选与解析的共享缓存。
+ *
+ * 表格式页面里同一列的几十个单元格会各调一次源，因此在**来源键**这一层共享：
+ * 同键并发只发一次请求，失败不缓存。
+ * 调用方各自的取消只影响自己的状态更新，不打断共享中的请求。
+ */
+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 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,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"}

package/dist/biz-select/cache.js

@@ -0,0 +1,130 @@
+/** 命中后的存活时间 */
+const HIT_TTL = 5 * 60 * 1000;
+/** 空结果的存活时间：别把「暂时查不到」当成长久不存在 */
+const MISS_TTL = 30 * 1000;
+/**
+ * 条目上限。过期只在读到同一个 key 时才清理，没有上限的话，
+ * 大量编码 × 参数组合会一直堆着。这里按插入顺序淘汰（FIFO），够用即可。
+ */
+const MAX_ENTRIES = 500;
+/**
+ * 缓存代次：clear 只清 Map，已经在途的请求稍后回来照样会写回旧数据。
+ * 每次 clear 递增一代，写回时比对代次就能丢掉上一代的结果。
+ */
+let generation = 0;
+const candidateCache = new Map();
+const resolveCache = new Map();
+function take(store, key) {
+    const hit = store.get(key);
+    if (!hit)
+        return undefined;
+    if (hit.expiresAt <= Date.now()) {
+        store.delete(key);
+        return undefined;
+    }
+    return hit.promise;
+}
+function evict(store) {
+    while (store.size > MAX_ENTRIES) {
+        const oldest = store.keys().next();
+        if (oldest.done)
+            return;
+        store.delete(oldest.value);
+    }
+}
+/** 请求发出后缓存被清过：这份结果属于上一代 */
+function staleGeneration(startedGeneration) {
+    return startedGeneration !== generation;
+}
+/** 首次登记：只占位，不覆盖同键已有的请求（并发调用共享同一份 promise） */
+function register(store, key, promise, ttl, startedGeneration) {
+    if (staleGeneration(startedGeneration) || store.has(key))
+        return;
+    store.set(key, { promise, expiresAt: Date.now() + ttl });
+    evict(store);
+}
+/**
+ * 结果写回：条目必须仍属于这次请求。
+ *
+ * 「条目不存在」也算失效——reload 换过一轮、新请求又失败了，此时写回去
+ * 就是让旧数据复活。所以不能只看 `current && current.promise !== owner`。
+ */
+function settle(store, key, owner, value, ttl, startedGeneration) {
+    if (staleGeneration(startedGeneration))
+        return;
+    const current = store.get(key);
+    if (!current || current.promise !== owner)
+        return;
+    store.set(key, { promise: Promise.resolve(value), expiresAt: Date.now() + ttl });
+}
+/** 失败清场：只删自己那一条，别误删已经接手的新请求 */
+function dropOwn(store, key, owner) {
+    if (store.get(key)?.promise === owner)
+        store.delete(key);
+}
+export function loadCandidatesWithCache(key, loader) {
+    const cached = take(candidateCache, key);
+    if (cached)
+        return cached;
+    const startedGeneration = generation;
+    const promise = Promise.resolve()
+        .then(loader)
+        .then((list) => {
+        const options = list ?? [];
+        // 空结果只短暂记住
+        settle(candidateCache, key, promise, options, options.length ? HIT_TTL : MISS_TTL, startedGeneration);
+        return options;
+    })
+        .catch((error) => {
+        // 失败不缓存，下一次仍可重试
+        dropOwn(candidateCache, key, promise);
+        throw error;
+    });
+    register(candidateCache, key, promise, HIT_TTL, startedGeneration);
+    return promise;
+}
+/** 丢掉单条候选缓存：reload() 要真正重取，不能又命中同一份 */
+export function dropCandidateCache(key) {
+    candidateCache.delete(key);
+}
+export function resolveCodeWithCache(key, loader) {
+    const cached = take(resolveCache, key);
+    if (cached)
+        return cached;
+    const startedGeneration = generation;
+    const promise = loader()
+        .then((option) => {
+        settle(resolveCache, key, promise, option, option ? HIT_TTL : MISS_TTL, startedGeneration);
+        return option;
+    })
+        .catch((error) => {
+        dropOwn(resolveCache, key, promise);
+        throw error;
+    });
+    register(resolveCache, key, promise, HIT_TTL, startedGeneration);
+    return promise;
+}
+/** 来源键在缓存键里固定占第二段，因此用两侧分隔符即可精确匹配 */
+function matchesSource(key, sourceKey) {
+    return key.startsWith(`${sourceKey}|`) || key.includes(`|${sourceKey}|`);
+}
+export function clearSelectCacheOfSource(sourceKey) {
+    generation += 1;
+    for (const key of candidateCache.keys()) {
+        if (matchesSource(key, sourceKey))
+            candidateCache.delete(key);
+    }
+    for (const key of resolveCache.keys()) {
+        if (matchesSource(key, sourceKey))
+            resolveCache.delete(key);
+    }
+}
+export function clearSelectCache() {
+    generation += 1;
+    candidateCache.clear();
+    resolveCache.clear();
+}
+export function getSelectCacheSize() {
+    return candidateCache.size + resolveCache.size;
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/biz-select/cache.ts"],"names":[],"mappings":"AASA,eAAe;AACf,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC9B,gCAAgC;AAChC,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3B;;;GAGG;AACH,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;GAGG;AACH,IAAI,UAAU,GAAG,CAAC,CAAC;AAOnB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmC,CAAC;AAClE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAwC,CAAC;AAErE,SAAS,IAAI,CAAI,KAAiC,EAAE,GAAW;IAC7D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAChC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,SAAS,KAAK,CAAI,KAAiC;IACjD,OAAO,KAAK,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI;YAAE,OAAO;QACxB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,2BAA2B;AAC3B,SAAS,eAAe,CAAC,iBAAyB;IAChD,OAAO,iBAAiB,KAAK,UAAU,CAAC;AAC1C,CAAC;AAED,6CAA6C;AAC7C,SAAS,QAAQ,CACf,KAAiC,EACjC,GAAW,EACX,OAAmB,EACnB,GAAW,EACX,iBAAyB;IAEzB,IAAI,eAAe,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IACjE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,KAAK,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,MAAM,CACb,KAAiC,EACjC,GAAW,EACX,KAAuB,EACvB,KAAQ,EACR,GAAW,EACX,iBAAyB;IAEzB,IAAI,eAAe,CAAC,iBAAiB,CAAC;QAAE,OAAO;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO;IAClD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,+BAA+B;AAC/B,SAAS,OAAO,CACd,KAAiC,EACjC,GAAW,EACX,KAAuB;IAEvB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,KAAK;QAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,GAAW,EACX,MAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,iBAAiB,GAAG,UAAU,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;SAC9B,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC3B,WAAW;QACX,MAAM,CACJ,cAAc,EACd,GAAG,EACH,OAAO,EACP,OAAO,EACP,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EACnC,iBAAiB,CAClB,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,gBAAgB;QAChB,OAAO,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACL,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAAW,EACX,MAAuC;IAEvC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,iBAAiB,GAAG,UAAU,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,EAAE;SACrB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC3F,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACL,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oCAAoC;AACpC,SAAS,aAAa,CAAC,GAAW,EAAE,SAAiB;IACnD,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,UAAU,IAAI,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC;YAAE,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC;YAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,UAAU,IAAI,CAAC,CAAC;IAChB,cAAc,CAAC,KAAK,EAAE,CAAC;IACvB,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,cAAc,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { AnyFormFieldSchema, NamePath } from '../types.js';
+import type { BizOption, DisplayMode, SearchFields, ValueFieldMap, ValueMode } from './types.js';
+/** BizSelect 在 schema 里额外认的专有属性 */
+export interface BizSelectSchemaProps {
+    /** 数据源注册名；schema 里不允许写函数 */
+    source?: string;
+    /** 参数名 ← 表单字段名：`{ provinceCode: 'provinceCode' }` */
+    paramsFrom?: Record<string, NamePath>;
+    valueMode?: ValueMode;
+    valueFields?: ValueFieldMap;
+    displayMode?: DisplayMode;
+    searchFields?: SearchFields;
+    seedOptions?: BizOption[];
+    /** 默认 true：父值变化时清空本字段 */
+    clearOnParent?: boolean;
+    blockedText?: unknown;
+    debounceMs?: number;
+}
+/**
+ * 归一化：专有属性下沉 + 级联编译。
+ *
+ * 必须是纯函数——调用方按 schema 对象缓存结果，每次新建对象会让下游 memo 与 effect 全部失效。
+ */
+export declare function normalizeBizSelectSchema<T extends AnyFormFieldSchema>(schema: T): T;
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/biz-select/compile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,kBAAkB,EAIlB,QAAQ,EAET,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,YAAY,EAEZ,aAAa,EACb,SAAS,EACV,MAAM,SAAS,CAAC;AAEjB,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,yBAAyB;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwDD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CA0BnF"}

package/dist/biz-select/compile.js

@@ -0,0 +1,82 @@
+/**
+ * schema 侧的纯逻辑：专有属性下沉 + `paramsFrom` 编译。
+ *
+ * 与 `schema.tsx`（负责注册、需要 antd/React）分开，是为了让这部分能被单测直接加载。
+ */
+import { dedupeNamePaths } from '../form/namePath.js';
+/** 需要下沉到 props 的专有属性：组件只认 props */
+const SUNK_KEYS = [
+    'source',
+    'valueMode',
+    'valueFields',
+    'displayMode',
+    'searchFields',
+    'seedOptions',
+    'blockedText',
+    'debounceMs',
+];
+/**
+ * 把 `paramsFrom` 编译成已有的两套机制：
+ * - `dynamic`：订阅父字段，把值映射成 `params` 传给组件
+ * - `linkage`：父值变化时清空本字段
+ */
+function compileParamsFrom(schema, entries) {
+    const deps = dedupeNamePaths(entries.map(([, path]) => path));
+    const base = schema.dynamic;
+    const inheritedProps = base?.props;
+    // 静态固定条件（如 props.params: { enabled: true }）必须保留，否则查询会放宽
+    const staticParams = (schema.props?.params ?? undefined);
+    const dynamic = {
+        ...base,
+        // 与调用方自己声明的依赖取并集去重
+        dependencies: dedupeNamePaths([...(base?.dependencies ?? []), ...deps]),
+        props: (ctx) => {
+            const inherited = typeof inheritedProps === 'function' ? inheritedProps(ctx) : (inheritedProps ?? {});
+            const inheritedParams = inherited.params;
+            const mapped = Object.fromEntries(entries.map(([param, path]) => [param, ctx.get(path)]));
+            // 合并顺序：静态 props.params < dynamic.props().params < paramsFrom 映射。
+            // 越靠后的越"当前"，同名时覆盖前面的
+            return {
+                ...inherited,
+                params: { ...staticParams, ...inheritedParams, ...mapped },
+            };
+        },
+    };
+    // clearOnParent=false 是「快照语义」：父变不清空，也不额外下发联动规则
+    const linkage = schema.clearOnParent === false
+        ? schema.linkage
+        : [...(schema.linkage ?? []), { dependencies: deps, handler: (ctx) => ctx.clear(schema.name) }];
+    return { dynamic, linkage };
+}
+/**
+ * 归一化：专有属性下沉 + 级联编译。
+ *
+ * 必须是纯函数——调用方按 schema 对象缓存结果，每次新建对象会让下游 memo 与 effect 全部失效。
+ */
+export function normalizeBizSelectSchema(schema) {
+    const ext = schema;
+    if (ext.type !== 'BizSelect')
+        return schema;
+    const sunk = {};
+    for (const key of SUNK_KEYS) {
+        if (ext[key] !== undefined)
+            sunk[key] = ext[key];
+    }
+    const entries = Object.entries(ext.paramsFrom ?? {});
+    // 没有可下沉的属性和可编译的级联时保持同一引用，避免无意义的新对象
+    if (!entries.length && !Object.keys(sunk).length)
+        return schema;
+    const next = { ...schema, props: { ...schema.props, ...sunk } };
+    if (entries.length) {
+        const { dynamic, linkage } = compileParamsFrom(ext, entries);
+        next.dynamic = dynamic;
+        if (linkage)
+            next.linkage = linkage;
+    }
+    // 已经编译进 props / dynamic / linkage 的属性从顶层摘掉，保证归一化幂等
+    for (const key of [...SUNK_KEYS, 'paramsFrom', 'clearOnParent']) {
+        delete next[key];
+    }
+    return next;
+}
+//# sourceMappingURL=compile.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * 三个工厂：只做形状收敛，不注册、不缓存、不发请求。
+ *
+ * 之所以保留工厂而不是让调用方直接写 `{ load, search }`：
+ * 工厂承载了「这个源属于哪种能力组合」的语义，写法越短，越不容易写出
+ * `resolve` 用模糊搜索冒充精确查这类错误。
+ */
+import type { BizOption, SelectCode, SelectSource, SelectParams } from './types.js';
+/** ① 纯前端常量：同步可用，没有请求也没有 loading */
+export declare function staticList<T = unknown>(list: ReadonlyArray<BizOption<T>>): SelectSource;
+/**
+ * ② 有限远程枚举：一次拉全量，之后由前端过滤。
+ * 传导入的函数（如 `api.listCurrency`）而不是内联箭头，才能跨实例共享缓存。
+ */
+export declare function loaded<P extends SelectParams = SelectParams>(load: (params: P, signal?: AbortSignal) => Promise<BizOption[]>, extra?: Pick<SelectSource<P>, 'requiredParams' | 'namespace'>): SelectSource<P>;
+/** ③ 无限远程：关键词搜索 + 按编码回显 */
+export declare function remote<P extends SelectParams = SelectParams>(config: {
+    search: (keyword: string, params: P, signal?: AbortSignal) => Promise<BizOption[]>;
+    resolve?: (code: SelectCode, params: P, signal?: AbortSignal) => Promise<BizOption | null>;
+    requiredParams?: string[];
+    namespace?: () => string;
+}): SelectSource<P>;
+//# sourceMappingURL=factories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../src/biz-select/factories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEjF,mCAAmC;AACnC,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAEvF;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAC1D,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,EAC/D,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAAC,GAC5D,YAAY,CAAC,CAAC,CAAC,CAEjB;AAED,2BAA2B;AAC3B,wBAAgB,MAAM,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,MAAM,EAAE;IACpE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC3F,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B,GAAG,YAAY,CAAC,CAAC,CAAC,CAGlB"}

package/dist/biz-select/factories.js

@@ -0,0 +1,17 @@
+/** ① 纯前端常量：同步可用，没有请求也没有 loading */
+export function staticList(list) {
+    return { options: [...list] };
+}
+/**
+ * ② 有限远程枚举：一次拉全量，之后由前端过滤。
+ * 传导入的函数（如 `api.listCurrency`）而不是内联箭头，才能跨实例共享缓存。
+ */
+export function loaded(load, extra) {
+    return { load, ...extra };
+}
+/** ③ 无限远程：关键词搜索 + 按编码回显 */
+export function remote(config) {
+    const { search, resolve, requiredParams, namespace } = config;
+    return { search, resolve, requiredParams, namespace };
+}
+//# sourceMappingURL=factories.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factories.js","sourceRoot":"","sources":["../../src/biz-select/factories.ts"],"names":[],"mappings":"AASA,mCAAmC;AACnC,MAAM,UAAU,UAAU,CAAc,IAAiC;IACvE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,IAA+D,EAC/D,KAA6D;IAE7D,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,MAAM,CAAwC,MAK7D;IACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC9D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AACxD,CAAC"}