@tianyr/schema-antd 0.1.0 → 0.2.0

package/dist/biz-select/format.js

@@ -0,0 +1,175 @@
+/** 与 read.tsx 的 EMPTY_TEXT 保持一致；接 BMS 时由覆盖层决定最终观感 */
+export const EMPTY = '—';
+/** `V-L` 的连接符：场景不多，不做配置 */
+export const LABEL_SEPARATOR = '-';
+const DEFAULT_VALUE_FIELDS = { value: 'value', label: 'label' };
+export function present(value) {
+    return value !== undefined && value !== null && value !== '';
+}
+export function isEmptyValue(value) {
+    return value === undefined || value === null || value === '';
+}
+/** 展示模式 → 默认的搜索字段 */
+export function defaultSearchFields(mode) {
+    if (mode === 'V')
+        return 'value';
+    if (mode === 'V-L')
+        return 'both';
+    return 'label';
+}
+/**
+ * 拼接展示文本。
+ * 降级规则：`L` 缺名称用值，`V` 缺值用名称，`V-L` 缺一侧就只显示另一侧。
+ */
+export function formatLabel(option, mode, separator = LABEL_SEPARATOR) {
+    const { value, label } = option;
+    if (mode === 'V-L') {
+        // 缺一侧时不留下悬挂的分隔符
+        return [value, label].filter(present).join(separator) || EMPTY;
+    }
+    const preferred = mode === 'V' ? value : label;
+    const fallback = mode === 'V' ? label : value;
+    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 value = present(option.value) ? String(option.value).toLowerCase() : '';
+    const label = present(option.label) ? String(option.label).toLowerCase() : '';
+    // 名称缺失时回退值：展示层是这么降级的，搜索必须同口径，否则「看得见却搜不到」
+    if (!label)
+        return value.includes(word);
+    if (fields === 'value')
+        return value.includes(word);
+    if (fields === 'label')
+        return label.includes(word);
+    return value.includes(word) || label.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.value, item.value, item.label ?? null, item.disabled ?? false]));
+}
+/** 契约选项 → antd 需要的 `{ value, label }`；形状一致，这里只负责拼展示文本 */
+export function toAntOption(option, mode) {
+    return {
+        value: option.value,
+        label: formatLabel(option, mode),
+        disabled: option.disabled,
+        raw: option,
+    };
+}
+export function resolveValueFields(fields) {
+    return {
+        value: fields?.value || DEFAULT_VALUE_FIELDS.value,
+        label: fields?.label || DEFAULT_VALUE_FIELDS.label,
+    };
+}
+/** 从值里取出编码，标量与对象两种形态统一到一处 */
+export function readValue(value, valueMode, fields) {
+    if (isEmptyValue(value))
+        return undefined;
+    if (valueMode === 'primitive')
+        return value;
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const keys = resolveValueFields(fields);
+    const raw = value[keys.value];
+    return isEmptyValue(raw) ? undefined : raw;
+}
+/** 从对象值里取出已带的名称，命中就不必再 resolve */
+export function readObjectLabel(value, valueMode, fields) {
+    if (valueMode !== 'object' || !value || typeof value !== 'object')
+        return undefined;
+    const keys = resolveValueFields(fields);
+    const raw = value[keys.label];
+    return present(raw) ? String(raw) : undefined;
+}
+/**
+ * 标量值 + 选项 → 对象值；名称缺失时留空串，由展示层降级到值本身。
+ *
+ * 只输出 valueFields 指定的两个键。改选是换成另一条记录，旧对象上的 id /
+ * 部门等字段属于上一条，跟着搬过去就是串数据；拿不到新名称时也不能沿用旧名称，
+ * 那会把「张三」显示成「李四」的编码。需要附加字段的业务从 onChange 的
+ * 第二个参数 `option.raw` 里取。
+ */
+export function buildObjectValue(value, option, fields) {
+    const keys = resolveValueFields(fields);
+    return { [keys.value]: value, [keys.label]: option?.label ?? '' };
+}
+// ---------------------------------------------------------------------------
+// 多选
+//
+// 空值一律归成空数组，对外只输出 `undefined`：
+// 与 `ctx.clear()` 一致，也让 antd 的 `required` 规则天然生效（它拿 `[]` 没辙）。
+// 不认逗号串、不把单值当数组——猜形状比报错难查。
+// ---------------------------------------------------------------------------
+/**
+ * 值 → 编码数组。
+ *
+ * 输入接受 `undefined` / `null` / `[]` 和各种混杂形态，输出永远是数组；
+ * 空值一律给 `[]`（调用方判断"有没有值"用长度，不用再区分 undefined）。
+ */
+export function readValues(value, valueMode, fields) {
+    if (value === undefined || value === null)
+        return [];
+    const list = Array.isArray(value) ? value : [value];
+    const codes = [];
+    for (const item of list) {
+        if (valueMode === 'primitive') {
+            if (isEmptyValue(item))
+                continue;
+            codes.push(item);
+            continue;
+        }
+        if (!item || typeof item !== 'object')
+            continue;
+        const raw = item[resolveValueFields(fields).value];
+        if (isEmptyValue(raw))
+            continue;
+        codes.push(raw);
+    }
+    return codes;
+}
+/**
+ * 对象数组 → 编码 → 名称的映射。
+ * 只服务于回显里的第一优先级「值自己带着名称」，没有名称的键不写。
+ */
+export function readObjectLabels(value, valueMode, fields) {
+    const names = new Map();
+    if (valueMode !== 'object' || value === undefined || value === null)
+        return names;
+    const keys = resolveValueFields(fields);
+    const list = Array.isArray(value) ? value : [value];
+    for (const item of list) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const record = item;
+        const raw = record[keys.value];
+        if (isEmptyValue(raw))
+            continue;
+        const name = record[keys.label];
+        if (present(name))
+            names.set(String(raw), String(name));
+    }
+    return names;
+}
+/** 编码数组 + 已解析选项 → 对象数组；缺名称的留空串，由展示层降级到编码本身 */
+export function buildObjectValues(codes, options, fields) {
+    const keys = resolveValueFields(fields);
+    return codes.map((code) => ({
+        [keys.value]: code,
+        [keys.label]: options.get(String(code))?.label ?? '',
+    }));
+}
+//# 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,28 @@
+/**
+ * BizSelect 对外出口。
+ *
+ * 刻意不在这里 import './schema.js'：字段类型由使用方显式注册，
+ * 包默认只提供标准 antd 控件，避免导入即产生副作用。
+ *
+ * 公开面刻意收窄：只导出发出去就形成兼容责任的东西。
+ * 键推导、能力归一化、AntD 选项转换、格式化这些都留在内部模块，
+ * 需要时直接从对应文件引用，不要经由本文件对外承诺。
+ */
+export { BizSelect } from './BizSelect.js';
+export { BizSelectDisplay } from './BizSelectDisplay.js';
+export { BizMultiSelect } from './BizMultiSelect.js';
+export { BizMultiSelectDisplay } from './BizMultiSelectDisplay.js';
+export { registerBizSelectField } from './schema.js';
+export type { BizSelectSchemaProps, ParamsFromEntry } from './schema.js';
+/** 候选取数：给下拉以外的 UI（树 / 弹窗列表）复用同一份数据 */
+export { useCandidates } from './useCandidates.js';
+export type { UseCandidatesOptions, UseCandidatesResult } from './useCandidates.js';
+/** 批量按值解析：表格列这类「只有 id、没有名称」的一屏回显 */
+export { useResolvedLabels } from './useResolvedLabels.js';
+export type { UseResolvedLabelsOptions, UseResolvedLabelsResult } from './useResolvedLabels.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 { BizMultiSelectDisplayProps, BizMultiSelectProps, BizObjectValue, BizOption, BizSelectDisplayProps, BizSelectProps, DisplayMode, RecordFieldNames, SearchFields, SelectParams, SelectSource, SelectValue, SelectValues, 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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEtE,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,oCAAoC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,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,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/biz-select/index.js

@@ -0,0 +1,26 @@
+/**
+ * BizSelect 对外出口。
+ *
+ * 刻意不在这里 import './schema.js'：字段类型由使用方显式注册，
+ * 包默认只提供标准 antd 控件，避免导入即产生副作用。
+ *
+ * 公开面刻意收窄：只导出发出去就形成兼容责任的东西。
+ * 键推导、能力归一化、AntD 选项转换、格式化这些都留在内部模块，
+ * 需要时直接从对应文件引用，不要经由本文件对外承诺。
+ */
+export { BizSelect } from './BizSelect.js';
+export { BizSelectDisplay } from './BizSelectDisplay.js';
+export { BizMultiSelect } from './BizMultiSelect.js';
+export { BizMultiSelectDisplay } from './BizMultiSelectDisplay.js';
+export { registerBizSelectField } from './schema.js';
+/** 候选取数：给下拉以外的 UI（树 / 弹窗列表）复用同一份数据 */
+export { useCandidates } from './useCandidates.js';
+/** 批量按值解析：表格列这类「只有 id、没有名称」的一屏回显 */
+export { useResolvedLabels } from './useResolvedLabels.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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGlD,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,oCAAoC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,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"}

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

@@ -0,0 +1,25 @@
+import type { SelectParams, SelectSource, SelectValue } 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;
+/**
+ * 编码的字符串身份：带类型前缀，缓存键用它区分 1 和 '1'。
+ * 给调用方查表时用 `lookupKeyOf`——那里反过来要求两种类型能对上。
+ */
+export declare function codeKeyOf(value: SelectValue | null | undefined): string;
+/**
+ * 对外查表用的键：**不带类型**。
+ * 后端常把 1 序列化成 '1'，调用方拿着列表行里的原始值来查，必须能命中。
+ */
+export declare function lookupKeyOf(value: SelectValue | null | undefined): string;
+/** 来源键固定占第二段，清理单个源的缓存时按它匹配 */
+export declare function candidatesCacheKey(scope: string, sourceKey: string, paramsKey: string): string;
+export declare function resolveCacheKey(scope: string, sourceKey: string, code: SelectValue, 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,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAevE;;;;;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;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEzE;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,WAAW,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/biz-select/key.js

@@ -0,0 +1,83 @@
+/**
+ * 稳定键推导。
+ *
+ * 缓存和 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);
+}
+/**
+ * 编码的字符串身份：带类型前缀，缓存键用它区分 1 和 '1'。
+ * 给调用方查表时用 `lookupKeyOf`——那里反过来要求两种类型能对上。
+ */
+export function codeKeyOf(value) {
+    return value === undefined || value === null ? '' : `${typeof value}:${value}`;
+}
+/**
+ * 对外查表用的键：**不带类型**。
+ * 后端常把 1 序列化成 '1'，调用方拿着列表行里的原始值来查，必须能命中。
+ */
+export function lookupKeyOf(value) {
+    return value === undefined || value === null ? '' : String(value);
+}
+/** 来源键固定占第二段，清理单个源的缓存时按它匹配 */
+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,43 @@
+/**
+ * 能力推导：从源「提供了什么」推「该怎么做」，不看类型标签。
+ *
+ * 这张推导表同时解释了三种来源（静态 / 有限枚举 / 无限表）——
+ * 它们不是三种类型，是三种能力组合。
+ */
+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;
+    /** 声明了批量接口，表格列可以一次查多条 */
+    canResolveMany: 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,wBAAwB;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,CA2BvE;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,49 @@
+export function normalizeSource(source) {
+    const hasOptions = Array.isArray(source?.options);
+    const canLoad = typeof source?.load === 'function';
+    const canSearch = typeof source?.search === 'function';
+    const canResolveMany = typeof source?.resolveMany === 'function';
+    // 只有批量接口也能单条用：批量一条就是单条，不必逼调用方再写一个 resolve
+    const canResolve = typeof source?.resolve === 'function' || canResolveMany;
+    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,
+        canResolveMany,
+        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":"AAuCA,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,cAAc,GAAG,OAAO,MAAM,EAAE,WAAW,KAAK,UAAU,CAAC;IACjE,0CAA0C;IAC1C,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,UAAU,IAAI,cAAc,CAAC;IAE3E,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;QACd,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/resolveBatch.d.ts

@@ -0,0 +1,34 @@
+import type { BizOption, SelectParams, SelectSource, SelectValue } from './types.js';
+/** 每批最多多少个编码。接口有更小的上限时由调用方传 batchSize */
+export declare const DEFAULT_BATCH_SIZE = 100;
+export interface ResolveCodesOptions {
+    /** 已经解析过的源对象（注册名要先经 resolveSelectSource 换掉） */
+    source?: SelectSource;
+    /** 来源键，和组件共用同一个身份，缓存才对得上 */
+    sourceKey: string;
+    /** 租户/权限作用域，缺省取源自己的 namespace */
+    scope?: string;
+    params?: SelectParams;
+    /** 一屏里出现的所有编码，重复的会被去掉 */
+    codes: ReadonlyArray<SelectValue | null | undefined>;
+    batchSize?: number;
+    /** 绕开缓存重查：`reload()` 用，否则重新查一遍还是命中同一份结果 */
+    force?: boolean;
+}
+export interface ResolveCodesResult {
+    /** 编码 → 选项，键是 `lookupKeyOf(编码)`，不带类型前缀，列表行原始值能直接查 */
+    byCode: Map<string, BizOption>;
+    /** 没解析到的编码（接口没返回、或返回了别的值） */
+    missing: string[];
+    /** 缺 requiredParams，一个请求都没发 */
+    blocked: boolean;
+    /** 实际发起的请求数；开发态用它判断这个页面是不是真的需要批量接口 */
+    requests: number;
+}
+/**
+ * 单条解析：源只声明了批量接口时，批量一条等价于单条，
+ * 不必逼调用方再写一个一模一样的 `resolve`。
+ */
+export declare function resolveOne(source: SelectSource | undefined, value: SelectValue, params: SelectParams): Promise<BizOption | null>;
+export declare function resolveCodes(options: ResolveCodesOptions): Promise<ResolveCodesResult>;
+//# sourceMappingURL=resolveBatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBatch.d.ts","sourceRoot":"","sources":["../../src/biz-select/resolveBatch.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElF,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,yBAAyB;IACzB,KAAK,EAAE,aAAa,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQ3B;AAiCD,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqE5F"}