@tianyr/schema-antd 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,15 @@
+import type { SelectCode, SelectParams, SelectSource } from './types.js';
+/**
+ * 源的稳定身份，参与缓存键。
+ *
+ * 注册名带版本号：重新注册或主动失效后，已挂载的实例会换 key 重新取数，
+ * 而不是继续用挂载时捕获的旧函数。
+ */
+export declare function selectSourceKey(source?: string | SelectSource, cacheKey?: string): string;
+/** 键序稳定的序列化：对象字面量顺序不同不算参数变化 */
+export declare function stableStringify(value: unknown): string;
+export declare function paramsKeyOf(params?: SelectParams): string;
+/** 来源键固定占第二段，清理单个源的缓存时按它匹配 */
+export declare function candidatesCacheKey(scope: string, sourceKey: string, paramsKey: string): string;
+export declare function resolveCacheKey(scope: string, sourceKey: string, code: SelectCode, paramsKey: string): string;
+//# sourceMappingURL=key.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/biz-select/key.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAetE;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAiBR;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAStD;AAED,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,8BAA8B;AAC9B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/biz-select/key.js

@@ -0,0 +1,69 @@
+/**
+ * 稳定键推导。
+ *
+ * 缓存和 effect 都只认一个字符串，所以「源是谁」必须能算成一个 key。
+ * 四档由强到弱：注册名 → 显式 cacheKey → 纯数据内容 → 函数引用。
+ * 只有最后一档会在内联箭头函数下抖动，此时退化为实例级缓存（见设计文档 §7）。
+ */
+import { getSelectSourceVersion } from './registry.js';
+import { nameSourceKey } from './source-id.js';
+import { optionsContentKey } from './format.js';
+const fnIds = new WeakMap();
+let fnIdSeq = 0;
+/** 函数引用 → 稳定编号；模块级导出的函数因此可以跨实例共享缓存 */
+function fnId(fn) {
+    const hit = fnIds.get(fn);
+    if (hit !== undefined)
+        return hit;
+    fnIdSeq += 1;
+    fnIds.set(fn, fnIdSeq);
+    return fnIdSeq;
+}
+/**
+ * 源的稳定身份，参与缓存键。
+ *
+ * 注册名带版本号：重新注册或主动失效后，已挂载的实例会换 key 重新取数，
+ * 而不是继续用挂载时捕获的旧函数。
+ */
+export function selectSourceKey(source, cacheKey) {
+    // 注册名本身就是跨实例稳定的身份，版本号也在里面：再传 cacheKey 只会把它盖掉，
+    // 连带绕过 invalidate / 重注册的失效机制。cacheKey 只服务内联源。
+    if (typeof source === 'string') {
+        return nameSourceKey(source, getSelectSourceVersion(source));
+    }
+    if (cacheKey)
+        return `c:${cacheKey}`;
+    if (!source)
+        return '';
+    const parts = [source.load, source.search, source.resolve, source.namespace].map((fn) => fn ? fnId(fn) : '-');
+    if (parts.every((part) => part === '-')) {
+        // 纯数据源没有闭包，按内容识别才安全，且写在 JSX 里也能命中同一份缓存
+        return `d:${optionsContentKey(source.options)}`;
+    }
+    return `f:${parts.join('.')}`;
+}
+/** 键序稳定的序列化：对象字面量顺序不同不算参数变化 */
+export function stableStringify(value) {
+    if (value === undefined)
+        return 'undefined';
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    const record = value;
+    const keys = Object.keys(record).sort();
+    return `{${keys
+        .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+        .join(',')}}`;
+}
+export function paramsKeyOf(params) {
+    return stableStringify(params ?? null);
+}
+/** 来源键固定占第二段，清理单个源的缓存时按它匹配 */
+export function candidatesCacheKey(scope, sourceKey, paramsKey) {
+    return `${scope}|${sourceKey}|${paramsKey}`;
+}
+export function resolveCacheKey(scope, sourceKey, code, paramsKey) {
+    return `${scope}|${sourceKey}|r|${typeof code}:${code}|${paramsKey}`;
+}
+//# sourceMappingURL=key.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * 能力推导：从源「提供了什么」推「该怎么做」，不看类型标签。
+ *
+ * 这张推导表同时解释了三种来源（静态 / 有限枚举 / 无限表）——
+ * 它们不是三种类型，是三种能力组合。
+ */
+import type { SelectParams, SelectSource } from './types.js';
+export type CandidateMode = 
+/** 同步全集，无需请求 */
+'sync'
+/** 异步全集，一次拉完前端过滤 */
+ | 'load'
+/** 只有关键词搜索，过滤在后端 */
+ | 'search'
+/** 空关键词走全集，有关键词走后端 */
+ | 'hybrid'
+/** 没有候选能力，只能按编码解析（只读展示可用） */
+ | 'none'
+/** 什么能力都没有，配置非法 */
+ | 'invalid';
+export interface SourceCapability {
+    source?: SelectSource;
+    candidateMode: CandidateMode;
+    /** 候选是否需要发请求 */
+    needsFetch: boolean;
+    /** 是否在前端做关键词过滤 */
+    canLocalFilter: boolean;
+    /** 搜索交给后端 */
+    canSearch: boolean;
+    canResolve: boolean;
+    requiredParams: string[];
+    namespace?: () => string;
+}
+export declare function normalizeSource(source?: SelectSource): SourceCapability;
+/**
+ * 必需的查询参数是否齐备。
+ * 缺任何一个都不该发请求——用空条件查，可能拿到别的租户/省份的记录。
+ */
+export declare function hasRequiredParams(required: string[] | undefined, params: SelectParams | undefined): boolean;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/biz-select/normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,MAAM,aAAa;AACvB,gBAAgB;AACd,MAAM;AACR,oBAAoB;GAClB,MAAM;AACR,oBAAoB;GAClB,QAAQ;AACV,sBAAsB;GACpB,QAAQ;AACV,6BAA6B;GAC3B,MAAM;AACR,mBAAmB;GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAwBvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAC9B,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,OAAO,CAQT"}

package/dist/biz-select/normalize.js

@@ -0,0 +1,46 @@
+export function normalizeSource(source) {
+    const hasOptions = Array.isArray(source?.options);
+    const canLoad = typeof source?.load === 'function';
+    const canSearch = typeof source?.search === 'function';
+    const canResolve = typeof source?.resolve === 'function';
+    let candidateMode;
+    if (hasOptions)
+        candidateMode = 'sync';
+    else if (canLoad && canSearch)
+        candidateMode = 'hybrid';
+    else if (canLoad)
+        candidateMode = 'load';
+    else if (canSearch)
+        candidateMode = 'search';
+    else if (canResolve)
+        candidateMode = 'none';
+    else
+        candidateMode = 'invalid';
+    return {
+        source,
+        candidateMode,
+        needsFetch: candidateMode === 'load' || candidateMode === 'search' || candidateMode === 'hybrid',
+        canLocalFilter: hasOptions || canLoad,
+        canSearch,
+        canResolve,
+        requiredParams: source?.requiredParams ?? [],
+        namespace: source?.namespace,
+    };
+}
+/**
+ * 必需的查询参数是否齐备。
+ * 缺任何一个都不该发请求——用空条件查，可能拿到别的租户/省份的记录。
+ */
+export function hasRequiredParams(required, params) {
+    if (!required || !required.length)
+        return true;
+    return required.every((key) => {
+        const value = params?.[key];
+        if (value === undefined || value === null || value === '')
+            return false;
+        if (Array.isArray(value) && value.length === 0)
+            return false;
+        return true;
+    });
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/biz-select/normalize.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,MAAM,EAAE,IAAI,KAAK,UAAU,CAAC;IACnD,MAAM,SAAS,GAAG,OAAO,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC;IACvD,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,UAAU,CAAC;IAEzD,IAAI,aAA4B,CAAC;IACjC,IAAI,UAAU;QAAE,aAAa,GAAG,MAAM,CAAC;SAClC,IAAI,OAAO,IAAI,SAAS;QAAE,aAAa,GAAG,QAAQ,CAAC;SACnD,IAAI,OAAO;QAAE,aAAa,GAAG,MAAM,CAAC;SACpC,IAAI,SAAS;QAAE,aAAa,GAAG,QAAQ,CAAC;SACxC,IAAI,UAAU;QAAE,aAAa,GAAG,MAAM,CAAC;;QACvC,aAAa,GAAG,SAAS,CAAC;IAE/B,OAAO;QACL,MAAM;QACN,aAAa;QACb,UAAU,EAAE,aAAa,KAAK,MAAM,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,QAAQ;QAChG,cAAc,EAAE,UAAU,IAAI,OAAO;QACrC,SAAS;QACT,UAAU;QACV,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,EAAE;QAC5C,SAAS,EAAE,MAAM,EAAE,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA8B,EAC9B,MAAgC;IAEhC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;QACxE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { SelectSource } from './types.js';
+export declare function subscribeSelectSourceVersion(name: string, listener: () => void): () => void;
+export declare function registerSelectSource(name: string, source: SelectSource): void;
+/** 批量注册：应用启动时一次写完 */
+export declare function defineSelectSources(map: Record<string, SelectSource>): void;
+export declare function unregisterSelectSource(name: string): void;
+/** 让已挂载的实例重新取数：版本 +1 换 key，同时清掉旧结果 */
+export declare function invalidateSelectSource(name: string): void;
+export declare function getSelectSource(name?: string): SelectSource | undefined;
+export declare function getSelectSourceVersion(name: string): number;
+/** 注册名或内联源统一解析；传对象时直接用，不看名字 */
+export declare function resolveSelectSource(source?: string | SelectSource): SelectSource | undefined;
+export declare function getRegisteredSelectSourceNames(): string[];
+export declare function clearSelectSources(): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/biz-select/registry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAY5C,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQ3F;AAYD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAM7E;AAED,qBAAqB;AACrB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAE3E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzD;AAED,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,GAC7B,YAAY,GAAG,SAAS,CAG1B;AAED,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CAEzD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC"}

package/dist/biz-select/registry.js

@@ -0,0 +1,81 @@
+/**
+ * 业务下拉数据源注册表。
+ *
+ * 注册表存在的两个理由：给缓存一个稳定标识，给 schema 一个可序列化的引用
+ * （schema 是数据，装不下函数）。
+ */
+import { clearSelectCache, clearSelectCacheOfSource } from './cache.js';
+import { nameSourceKey } from './source-id.js';
+const sources = new Map();
+/** 每次注册/失效都递增，进入来源键：已挂载实例因此能感知到源被换掉 */
+const versions = new Map();
+/**
+ * 版本订阅。版本号只存在 Map 里，单单改值不会让任何组件重渲染，
+ * 所以「失效后已挂载实例重新取数」必须靠订阅把变化推给组件。
+ */
+const versionListeners = new Map();
+export function subscribeSelectSourceVersion(name, listener) {
+    const listeners = versionListeners.get(name) ?? new Set();
+    listeners.add(listener);
+    versionListeners.set(name, listeners);
+    return () => {
+        listeners.delete(listener);
+        if (!listeners.size)
+            versionListeners.delete(name);
+    };
+}
+function bumpVersion(name) {
+    versions.set(name, (versions.get(name) ?? 0) + 1);
+    versionListeners.get(name)?.forEach((listener) => listener());
+}
+/** 换实现时清掉上一版的缓存，否则旧结果会留到 TTL 结束 */
+function clearPrevious(name, previousVersion) {
+    clearSelectCacheOfSource(nameSourceKey(name, previousVersion));
+}
+export function registerSelectSource(name, source) {
+    const previous = versions.get(name) ?? 0;
+    sources.set(name, source);
+    bumpVersion(name);
+    // 同名重注册（HMR / 动态切换）后旧缓存不再代表当前实现
+    clearPrevious(name, previous);
+}
+/** 批量注册：应用启动时一次写完 */
+export function defineSelectSources(map) {
+    for (const [name, source] of Object.entries(map))
+        registerSelectSource(name, source);
+}
+export function unregisterSelectSource(name) {
+    const previous = versions.get(name) ?? 0;
+    sources.delete(name);
+    bumpVersion(name);
+    clearPrevious(name, previous);
+}
+/** 让已挂载的实例重新取数：版本 +1 换 key，同时清掉旧结果 */
+export function invalidateSelectSource(name) {
+    const previous = versions.get(name) ?? 0;
+    bumpVersion(name);
+    clearPrevious(name, previous);
+}
+export function getSelectSource(name) {
+    return name ? sources.get(name) : undefined;
+}
+export function getSelectSourceVersion(name) {
+    return versions.get(name) ?? 0;
+}
+/** 注册名或内联源统一解析；传对象时直接用，不看名字 */
+export function resolveSelectSource(source) {
+    if (!source)
+        return undefined;
+    return typeof source === 'string' ? sources.get(source) : source;
+}
+export function getRegisteredSelectSourceNames() {
+    return [...sources.keys()];
+}
+export function clearSelectSources() {
+    sources.clear();
+    versions.clear();
+    // 版本 Map 一起清掉了，不主动通知的话订阅方永远等不到变化
+    versionListeners.forEach((listeners) => listeners.forEach((listener) => listener()));
+    clearSelectCache();
+}
+//# sourceMappingURL=registry.js.map

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

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

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

@@ -0,0 +1,5 @@
+import { normalizeBizSelectSchema } from './compile.js';
+export { normalizeBizSelectSchema };
+export type { BizSelectSchemaProps } from './compile.js';
+export declare function registerBizSelectField(): void;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/biz-select/schema.tsx"],"names":[],"mappings":"AASA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,wBAAgB,sBAAsB,IAAI,IAAI,CAgB7C"}

package/dist/biz-select/schema.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BizSelect 的字段类型注册。
+ *
+ * 刻意不自动执行：包默认只提供标准 antd 控件，使用方需要时调一次
+ * `registerBizSelectField()`。
+ */
+import { registerField } from '../registry.js';
+import { BizSelect } from './BizSelect.js';
+import { BizSelectDisplay } from './BizSelectDisplay.js';
+import { normalizeBizSelectSchema } from './compile.js';
+export { normalizeBizSelectSchema };
+export function registerBizSelectField() {
+    registerField('BizSelect', {
+        component: BizSelect,
+        normalize: normalizeBizSelectSchema,
+        // 只读态复用同一套解析，不挂载交互组件
+        renderRead: (value, props) => (_jsx(BizSelectDisplay, { value: value, ...props })),
+    }, { override: true });
+}
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/biz-select/schema.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAGpC,MAAM,UAAU,sBAAsB;IACpC,aAAa,CACX,WAAW,EACX;QACE,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,wBAAwB;QACnC,qBAAqB;QACrB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAC5B,KAAC,gBAAgB,IACf,KAAK,EAAE,KAAc,KAChB,KAA0C,GAC/C,CACH;KACF,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;AACJ,CAAC"}

package/dist/biz-select/source-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 注册名的来源键格式。
+ *
+ * 单独成一个文件是为了打断 `key.ts ↔ registry.ts` 的循环依赖：
+ * 两边都要拼同一个字符串，格式漂移会让缓存清不掉。
+ */
+export declare function nameSourceKey(name: string, version: number): string;
+//# sourceMappingURL=source-id.d.ts.map

package/dist/biz-select/source-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-id.d.ts","sourceRoot":"","sources":["../../src/biz-select/source-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/biz-select/source-id.js

@@ -0,0 +1,10 @@
+/**
+ * 注册名的来源键格式。
+ *
+ * 单独成一个文件是为了打断 `key.ts ↔ registry.ts` 的循环依赖：
+ * 两边都要拼同一个字符串，格式漂移会让缓存清不掉。
+ */
+export function nameSourceKey(name, version) {
+    return `n:${name}@${version}`;
+}
+//# sourceMappingURL=source-id.js.map

package/dist/biz-select/source-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-id.js","sourceRoot":"","sources":["../../src/biz-select/source-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAe;IACzD,OAAO,KAAK,IAAI,IAAI,OAAO,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,104 @@
+/**
+ * BizSelect 的类型契约。
+ *
+ * 对外只有一个「数据源」概念：能给出候选、能按编码解析名称。
+ * 具体是前端常量、一次拉全量还是关键词翻页，由源**提供了哪些能力**决定，
+ * 不再用 kind 之类的标签分类。
+ */
+import type { ReactNode } from 'react';
+import type { SelectProps } from 'antd';
+export type SelectCode = string | number;
+/** 契约层的标准选项；后端字段换名在 adapter 层做，不污染组件 */
+export interface BizOption<T = unknown> {
+    code: SelectCode;
+    name?: string;
+    disabled?: boolean;
+    /** 原始接口记录，原样带回给业务回调 */
+    raw?: T;
+}
+/** 展示模式：编码 / 编码-名称 / 名称 */
+export type DisplayMode = 'V' | 'V-L' | 'L';
+/** 前端过滤时匹配哪些字段 */
+export type SearchFields = 'code' | 'name' | 'both';
+/** 值形态：标量编码，或自带名称的对象 */
+export type ValueMode = 'primitive' | 'object';
+/**
+ * 对象值里哪个键装编码、哪个装名称。
+ * 默认 `{ code: 'value', name: 'label' }`，兼容存量 `{ value, label }` 协议。
+ */
+export interface ValueFieldMap {
+    code?: string;
+    name?: string;
+}
+export type SelectParams = Record<string, unknown>;
+/** 对象形态的值；具体键名由 valueFields 决定，所以只能约束到 Record */
+export type BizObjectValue = Record<string, unknown>;
+/**
+ * 数据源契约。只有能力声明，不认识 URL、method、低代码控件配置。
+ *
+ * 行为推导：
+ * - 只有 `options` → 同步全集，前端过滤
+ * - 只有 `load` → 需要时加载一次，前端过滤
+ * - 只有 `search` → 后端过滤
+ * - `load` + `search` → 空关键词走 load 缓存，有关键词走后端
+ */
+export interface SelectSource<P extends SelectParams = SelectParams> {
+    /** 同步全集：纯前端常量，没有请求也没有 loading */
+    options?: BizOption[];
+    /** 异步全集：一次拉完，之后前端过滤 */
+    load?: (params: P, signal?: AbortSignal) => Promise<BizOption[]>;
+    /** 关键词搜索：分页接口固定取第一页 */
+    search?: (keyword: string, params: P, signal?: AbortSignal) => Promise<BizOption[]>;
+    /** 按编码精确查：远程回显，不能用模糊搜索冒充 */
+    resolve?: (code: SelectCode, params: P, signal?: AbortSignal) => Promise<BizOption | null>;
+    /** 缺任一参数就不发请求：用空条件查可能拿到别家数据 */
+    requiredParams?: string[];
+    /** 租户/权限隔离，参与缓存键 */
+    namespace?: () => string;
+}
+/**
+ * 受控通道与搜索协议由组件接管，这些属性传进来要么被静默忽略、要么直接把控件弄坏：
+ * - `searchValue`：antd 的受控搜索框，传了会锁死用户输入（组件自己维护 keyword）
+ * - `showSearch` / `filterOption` / `optionFilterProp` / `onSearch`：搜索行为由源的能力决定
+ * - `optionLabelProp`：标签取哪个字段由 displayMode 决定
+ */
+type BaseAntProps = Omit<SelectProps, 'value' | 'defaultValue' | 'onChange' | 'options' | 'labelInValue' | 'mode' | 'onSearch' | 'searchValue' | 'showSearch' | 'filterOption' | 'optionFilterProp' | 'optionLabelProp'>;
+/** 与 antd 无关的公共属性：可编辑与只读都吃这一份 */
+interface CoreProps {
+    /** 注册名或内联源；schema 里只能是字符串 */
+    source?: string | SelectSource;
+    /** 传给 load/search/resolve，参与缓存键 */
+    params?: SelectParams;
+    /** 下拉与回显文本，默认 L */
+    displayMode?: DisplayMode;
+    /** 前端过滤匹配的字段，缺省随 displayMode 推导 */
+    searchFields?: SearchFields;
+    /** 详情已带回的名称，省掉一次 resolve */
+    seedOptions?: BizOption[];
+    /** 远程搜索防抖，默认 300ms */
+    debounceMs?: number;
+    /** 内联源需要跨实例共享缓存时显式指定 */
+    cacheKey?: string;
+    /** 门禁提示文案 */
+    blockedText?: ReactNode;
+    valueMode?: ValueMode;
+    valueFields?: ValueFieldMap;
+}
+interface PrimitiveModeProps {
+    valueMode?: 'primitive';
+    value?: SelectCode | null;
+    onChange?: (value: SelectCode | undefined, option?: BizOption) => void;
+}
+interface ObjectModeProps {
+    valueMode: 'object';
+    value?: BizObjectValue | null;
+    onChange?: (value: BizObjectValue | undefined, option?: BizOption) => void;
+}
+export type BizSelectProps = CoreProps & BaseAntProps & (PrimitiveModeProps | ObjectModeProps);
+export interface BizSelectDisplayProps extends CoreProps {
+    value?: SelectCode | BizObjectValue | null;
+    /** 只读占位 */
+    emptyText?: ReactNode;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/biz-select/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/biz-select/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,40 @@
+import type { BizOption, SearchFields, SelectParams, SelectSource } from './types.js';
+export interface UseCandidatesOptions {
+    /**
+     * 注册名或内联源。解析与来源键都在 Hook 内完成：
+     * 让调用方自己拼 sourceKey 就会绕开注册名的版本身份，组件和 Hook 表现不一致。
+     */
+    source?: string | SelectSource;
+    /** 内联源需要跨实例共享缓存时显式指定；注册名自带稳定键 */
+    cacheKey?: string;
+    params?: SelectParams;
+    /** 前端过滤匹配哪些字段 */
+    searchFields: SearchFields;
+    debounceMs?: number;
+}
+export interface UseCandidatesResult {
+    /** 解析后的来源键，和组件用的是同一个身份；要传给别的 Hook 时直接用它 */
+    sourceKey: string;
+    /** 当前该给下拉看的候选：本地过滤型已按 keyword 过滤 */
+    options: BizOption[];
+    /**
+     * 回显专用候选：优先取未过滤的全集。
+     * 已选中的项可能被关键词过滤掉，用它查名称才不会退回编码。
+     */
+    echoOptions: BizOption[];
+    /** 当前关键词：搜索中不要往结果里补回已选项 */
+    keyword: string;
+    loading: boolean;
+    error: boolean;
+    /** 缺少必需参数，主动不查 */
+    blocked: boolean;
+    /** 展开下拉：`load` 型在这里才发第一次请求 */
+    open(): void;
+    /** 输入关键词：后端搜索型防抖请求；本地过滤型只更新关键字 */
+    search(keyword: string): void;
+    /** 收起下拉时清掉关键字：不发请求，避免下次打开看到上次的过滤结果 */
+    resetKeyword(): void;
+    reload(): void;
+}
+export declare function useCandidates({ source: sourceProp, cacheKey, params, searchFields, debounceMs, }: UseCandidatesOptions): UseCandidatesResult;
+//# sourceMappingURL=useCandidates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCandidates.d.ts","sourceRoot":"","sources":["../../src/biz-select/useCandidates.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnF,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC/B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,iBAAiB;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sCAAsC;IACtC,YAAY,IAAI,IAAI,CAAC;IACrB,MAAM,IAAI,IAAI,CAAC;CAChB;AAuBD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAgB,GACjB,EAAE,oBAAoB,GAAG,mBAAmB,CA0S5C"}