@tianyr/schema-antd 0.0.0-stage → 0.1.1

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":"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"}

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":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAmCnD,mCAAmC;AACnC,MAAM,SAAS,GAAG;IAChB,QAAQ;IACR,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,aAAa;IACb,aAAa;IACb,YAAY;CACJ,CAAC;AAEX;;;;GAIG;AACH,SAAS,iBAAiB,CACxB,MAA8C,EAC9C,OAA6B;IAE7B,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,cAAc,GAAG,IAAI,EAAE,KAAK,CAAC;IACnC,wDAAwD;IACxD,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,SAAS,CAA6B,CAAC;IAErF,MAAM,OAAO,GAAkB;QAC7B,GAAG,IAAI;QACP,mBAAmB;QACnB,YAAY,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACvE,KAAK,EAAE,CAAC,GAAgB,EAAE,EAAE;YAC1B,MAAM,SAAS,GACb,OAAO,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;YACtF,MAAM,eAAe,GAAI,SAAuC,CAAC,MAAM,CAAC;YACxE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1F,iEAAiE;YACjE,qBAAqB;YACrB,OAAO;gBACL,GAAG,SAAS;gBACZ,MAAM,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,eAAe,EAAE,GAAG,MAAM,EAAE;aAC3D,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,+CAA+C;IAC/C,MAAM,OAAO,GACX,MAAM,CAAC,aAAa,KAAK,KAAK;QAC5B,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEpG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAA+B,MAAS;IAC9E,MAAM,GAAG,GAAG,MAA2D,CAAC;IACxE,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IAE5C,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAyB,CAAC;IAC7E,mCAAmC;IACnC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAEhE,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,EAAE,EAA6B,CAAC;IAE3F,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACtC,CAAC;IAED,mDAAmD;IACnD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,IAAS,CAAC;AACnB,CAAC"}

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"}

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

@@ -0,0 +1,48 @@
+/**
+ * 展示与取值：纯函数，不依赖 React，可直接单测。
+ *
+ * 展示模式统一走「先取首选字段，缺失再降级」，不写三套分支；
+ * 编码 0 是合法值，判空一律用 present，不能用真值判断。
+ */
+import type { BizObjectValue, BizOption, DisplayMode, SearchFields, SelectCode, ValueFieldMap, ValueMode } from './types.js';
+/** 与 read.tsx 的 EMPTY_TEXT 保持一致；接 BMS 时由覆盖层决定最终观感 */
+export declare const EMPTY = "\u2014";
+/** `V-L` 的连接符：场景不多，不做配置 */
+export declare const LABEL_SEPARATOR = "-";
+export declare function present(value: unknown): boolean;
+export declare function isEmptyCode(value: SelectCode | null | undefined): boolean;
+/** 展示模式 → 默认的搜索字段 */
+export declare function defaultSearchFields(mode: DisplayMode): SearchFields;
+/**
+ * 拼接展示文本。
+ * 降级规则：`L` 缺名称用编码，`V` 缺编码用名称，`V-L` 缺一侧就只显示另一侧。
+ */
+export declare function formatLabel(option: Pick<BizOption, 'code' | 'name'>, mode: DisplayMode, separator?: string): string;
+/** 关键字是否命中：空关键字一律命中，前端过滤只管 `options` / `load` 两类源 */
+export declare function matchKeyword(option: BizOption, keyword: string, fields: SearchFields): boolean;
+/** 本地过滤：候选全集已在前端时用；关键词为空直接返回原数组，避免多余遍历 */
+export declare function filterOptions(list: BizOption[], keyword: string, fields: SearchFields): BizOption[];
+/** 按内容判断候选是否真的变了：内联数组每次新建也能对上 */
+export declare function optionsContentKey(list?: BizOption[] | null): string;
+/** 契约选项 → antd 需要的 `{ value, label }` */
+export declare function toAntOption(option: BizOption, mode: DisplayMode): {
+    value: SelectCode;
+    label: string;
+    disabled: boolean | undefined;
+    raw: BizOption<unknown>;
+};
+export declare function resolveValueFields(fields?: ValueFieldMap): Required<ValueFieldMap>;
+/** 从值里取出编码，标量与对象两种形态统一到一处 */
+export declare function readCode(value: SelectCode | BizObjectValue | null | undefined, valueMode: ValueMode, fields?: ValueFieldMap): SelectCode | undefined;
+/** 从对象值里取出已带的名称，命中就不必再 resolve */
+export declare function readObjectName(value: SelectCode | BizObjectValue | null | undefined, valueMode: ValueMode, fields?: ValueFieldMap): string | undefined;
+/**
+ * 标量编码 + 选项 → 对象值；名称缺失时留空串，由展示层降级到编码。
+ *
+ * 只输出 valueFields 指定的两个键。改选是换成另一条记录，旧对象上的 id /
+ * 部门等字段属于上一条，跟着搬过去就是串数据；拿不到新名称时也不能沿用旧名称，
+ * 那会把「张三」显示成「李四」的编码。需要附加字段的业务从 onChange 的
+ * 第二个参数 `option.raw` 里取。
+ */
+export declare function buildObjectValue(code: SelectCode, option: BizOption | undefined, fields?: ValueFieldMap): BizObjectValue;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/biz-select/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,SAAS,EACV,MAAM,SAAS,CAAC;AAEjB,qDAAqD;AACrD,eAAO,MAAM,KAAK,WAAM,CAAC;AAEzB,2BAA2B;AAC3B,eAAO,MAAM,eAAe,MAAM,CAAC;AAInC,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEzE;AAED,qBAAqB;AACrB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAInE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,EACxC,IAAI,EAAE,WAAW,EACjB,SAAS,SAAkB,GAC1B,MAAM,CAUR;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAU9F;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GACnB,SAAS,EAAE,CAGb;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,MAAM,CAKnE;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW;;;;;EAO/D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAKlF;AAED,6BAA6B;AAC7B,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,EACrD,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,aAAa,GACrB,UAAU,GAAG,SAAS,CAOxB;AAED,kCAAkC;AAClC,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,EACrD,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,MAAM,CAAC,EAAE,aAAa,GACrB,cAAc,CAGhB"}

package/dist/biz-select/format.js

@@ -0,0 +1,110 @@
+/** 与 read.tsx 的 EMPTY_TEXT 保持一致；接 BMS 时由覆盖层决定最终观感 */
+export const EMPTY = '—';
+/** `V-L` 的连接符：场景不多，不做配置 */
+export const LABEL_SEPARATOR = '-';
+const DEFAULT_VALUE_FIELDS = { code: 'value', name: 'label' };
+export function present(value) {
+    return value !== undefined && value !== null && value !== '';
+}
+export function isEmptyCode(value) {
+    return value === undefined || value === null || value === '';
+}
+/** 展示模式 → 默认的搜索字段 */
+export function defaultSearchFields(mode) {
+    if (mode === 'V')
+        return 'code';
+    if (mode === 'V-L')
+        return 'both';
+    return 'name';
+}
+/**
+ * 拼接展示文本。
+ * 降级规则：`L` 缺名称用编码，`V` 缺编码用名称，`V-L` 缺一侧就只显示另一侧。
+ */
+export function formatLabel(option, mode, separator = LABEL_SEPARATOR) {
+    const { code, name } = option;
+    if (mode === 'V-L') {
+        // 缺一侧时不留下悬挂的分隔符
+        return [code, name].filter(present).join(separator) || EMPTY;
+    }
+    const preferred = mode === 'V' ? code : name;
+    const fallback = mode === 'V' ? name : code;
+    const text = present(preferred) ? preferred : present(fallback) ? fallback : EMPTY;
+    return String(text);
+}
+/** 关键字是否命中：空关键字一律命中，前端过滤只管 `options` / `load` 两类源 */
+export function matchKeyword(option, keyword, fields) {
+    const word = keyword.trim().toLowerCase();
+    if (!word)
+        return true;
+    const code = present(option.code) ? String(option.code).toLowerCase() : '';
+    const name = present(option.name) ? String(option.name).toLowerCase() : '';
+    // 名称缺失时回退编码：展示层是这么降级的，搜索必须同口径，否则「看得见却搜不到」
+    if (!name)
+        return code.includes(word);
+    if (fields === 'code')
+        return code.includes(word);
+    if (fields === 'name')
+        return name.includes(word);
+    return code.includes(word) || name.includes(word);
+}
+/** 本地过滤：候选全集已在前端时用；关键词为空直接返回原数组，避免多余遍历 */
+export function filterOptions(list, keyword, fields) {
+    if (!keyword.trim())
+        return list;
+    return list.filter((item) => matchKeyword(item, keyword, fields));
+}
+/** 按内容判断候选是否真的变了：内联数组每次新建也能对上 */
+export function optionsContentKey(list) {
+    if (!list || !list.length)
+        return '';
+    return JSON.stringify(list.map((item) => [typeof item.code, item.code, item.name ?? null, item.disabled ?? false]));
+}
+/** 契约选项 → antd 需要的 `{ value, label }` */
+export function toAntOption(option, mode) {
+    return {
+        value: option.code,
+        label: formatLabel(option, mode),
+        disabled: option.disabled,
+        raw: option,
+    };
+}
+export function resolveValueFields(fields) {
+    return {
+        code: fields?.code || DEFAULT_VALUE_FIELDS.code,
+        name: fields?.name || DEFAULT_VALUE_FIELDS.name,
+    };
+}
+/** 从值里取出编码，标量与对象两种形态统一到一处 */
+export function readCode(value, valueMode, fields) {
+    if (isEmptyCode(value))
+        return undefined;
+    if (valueMode === 'primitive')
+        return value;
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const { code } = resolveValueFields(fields);
+    const raw = value[code];
+    return isEmptyCode(raw) ? undefined : raw;
+}
+/** 从对象值里取出已带的名称，命中就不必再 resolve */
+export function readObjectName(value, valueMode, fields) {
+    if (valueMode !== 'object' || !value || typeof value !== 'object')
+        return undefined;
+    const { name } = resolveValueFields(fields);
+    const raw = value[name];
+    return present(raw) ? String(raw) : undefined;
+}
+/**
+ * 标量编码 + 选项 → 对象值；名称缺失时留空串，由展示层降级到编码。
+ *
+ * 只输出 valueFields 指定的两个键。改选是换成另一条记录，旧对象上的 id /
+ * 部门等字段属于上一条，跟着搬过去就是串数据；拿不到新名称时也不能沿用旧名称，
+ * 那会把「张三」显示成「李四」的编码。需要附加字段的业务从 onChange 的
+ * 第二个参数 `option.raw` 里取。
+ */
+export function buildObjectValue(code, option, fields) {
+    const keys = resolveValueFields(fields);
+    return { [keys.code]: code, [keys.name]: option?.name ?? '' };
+}
+//# sourceMappingURL=format.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * BizSelect 对外出口。
+ *
+ * 刻意不在这里 import './schema.js'：字段类型由使用方显式注册，
+ * 包默认只提供标准 antd 控件，避免导入即产生副作用。
+ *
+ * 公开面刻意收窄：只导出发出去就形成兼容责任的东西。
+ * 键推导、能力归一化、AntD 选项转换、格式化这些都留在内部模块，
+ * 需要时直接从对应文件引用，不要经由本文件对外承诺。
+ */
+export { BizSelect } from './BizSelect.js';
+export { BizSelectDisplay } from './BizSelectDisplay.js';
+export { registerBizSelectField } from './schema.js';
+export type { BizSelectSchemaProps } from './schema.js';
+/** 候选取数：给下拉以外的 UI（树 / 弹窗列表）复用同一份数据 */
+export { useCandidates } from './useCandidates.js';
+export type { UseCandidatesOptions, UseCandidatesResult } from './useCandidates.js';
+/** 源工厂：三种能力组合，别处不再分类 */
+export { staticList, loaded, remote } from './factories.js';
+export { registerSelectSource, defineSelectSources, unregisterSelectSource, invalidateSelectSource, getSelectSource, getRegisteredSelectSourceNames, clearSelectSources, } from './registry.js';
+export { clearSelectCache } from './cache.js';
+export type { BizObjectValue, BizOption, BizSelectDisplayProps, BizSelectProps, DisplayMode, SearchFields, SelectCode, SelectParams, SelectSource, ValueFieldMap, ValueMode, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/biz-select/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,8BAA8B,EAC9B,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,YAAY,EACV,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/biz-select/index.js

@@ -0,0 +1,22 @@
+/**
+ * BizSelect 对外出口。
+ *
+ * 刻意不在这里 import './schema.js'：字段类型由使用方显式注册，
+ * 包默认只提供标准 antd 控件，避免导入即产生副作用。
+ *
+ * 公开面刻意收窄：只导出发出去就形成兼容责任的东西。
+ * 键推导、能力归一化、AntD 选项转换、格式化这些都留在内部模块，
+ * 需要时直接从对应文件引用，不要经由本文件对外承诺。
+ */
+export { BizSelect } from './BizSelect.js';
+export { BizSelectDisplay } from './BizSelectDisplay.js';
+export { registerBizSelectField } from './schema.js';
+/** 候选取数：给下拉以外的 UI（树 / 弹窗列表）复用同一份数据 */
+export { useCandidates } from './useCandidates.js';
+/** 源工厂：三种能力组合，别处不再分类 */
+export { staticList, loaded, remote } from './factories.js';
+export { registerSelectSource, defineSelectSources, unregisterSelectSource, invalidateSelectSource, getSelectSource, getRegisteredSelectSourceNames, clearSelectSources, } from './registry.js';
+// 源解析与来源键不对外：useCandidates 内部已经做好，放出去只会让调用方自己拼身份、
+// 绕开注册名的版本订阅。确实需要读源的话用 getSelectSource。
+export { clearSelectCache } from './cache.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/biz-select/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGlD,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,8BAA8B,EAC9B,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,kDAAkD;AAClD,wCAAwC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}