@tianyr/schema-antd 0.0.0-stage → 0.1.0

package/dist/app-select/cache.js

@@ -0,0 +1,82 @@
+const DEFAULT_TTL = 5 * 60 * 1000;
+/** 解析不到时只短暂记住，避免把“暂时查不到”永久当成不存在 */
+const MISS_TTL = 30 * 1000;
+const resolveCache = new Map();
+/**
+ * 同一个 key 的并发调用共享一次请求；失败不缓存，下次可重试。
+ * 调用方各自的取消只影响自己的状态更新，不打断共享请求。
+ */
+export function resolveOptionWithCache(key, loader, ttl = DEFAULT_TTL) {
+    const now = Date.now();
+    const cached = resolveCache.get(key);
+    if (cached && cached.expiresAt > now) {
+        return cached.promise;
+    }
+    const promise = loader()
+        .then((option) => {
+        resolveCache.set(key, {
+            promise: Promise.resolve(option),
+            expiresAt: Date.now() + (option ? ttl : MISS_TTL),
+        });
+        return option;
+    })
+        .catch((error) => {
+        resolveCache.delete(key);
+        throw error;
+    });
+    resolveCache.set(key, { promise, expiresAt: now + ttl });
+    return promise;
+}
+/** 静态 / 有限字典集合的共享缓存：同一来源在同一窗口内只加载一次 */
+const loadCache = new Map();
+/**
+ * 静态 / 字典集合的加载缓存。
+ * 每个 AppSelect 单元格各自 loadOptions 会在表格里重复打同一批字典请求，
+ * 因此按来源键共享；失败不缓存，下一次可重试。
+ */
+export function loadOptionsWithCache(key, loader, ttl = DEFAULT_TTL) {
+    const now = Date.now();
+    const cached = loadCache.get(key);
+    if (cached && cached.expiresAt > now) {
+        return cached.promise;
+    }
+    const promise = Promise.resolve()
+        .then(loader)
+        .then((list) => {
+        const options = list ?? [];
+        loadCache.set(key, { promise: Promise.resolve(options), expiresAt: Date.now() + ttl });
+        return options;
+    })
+        .catch((error) => {
+        loadCache.delete(key);
+        throw error;
+    });
+    loadCache.set(key, { promise, expiresAt: now + ttl });
+    return promise;
+}
+/**
+ * 清掉某个注册源名下的缓存。
+ * 重新注册同名源（常见于开发态 HMR）时必须调用，否则会继续读到旧实现的结果。
+ */
+export function clearAppSelectCacheOfSource(name) {
+    const sourceKey = `source:${name}`;
+    const marker = `|${sourceKey}|`;
+    // 集合缓存直接用来源键当 key；解析缓存的键是 scope|source|类型|值|参数
+    const matches = (key) => key === sourceKey || key.includes(marker);
+    for (const key of resolveCache.keys()) {
+        if (matches(key))
+            resolveCache.delete(key);
+    }
+    for (const key of loadCache.keys()) {
+        if (matches(key))
+            loadCache.delete(key);
+    }
+}
+export function clearAppSelectCache() {
+    resolveCache.clear();
+    loadCache.clear();
+}
+export function getAppSelectCacheSize() {
+    return resolveCache.size + loadCache.size;
+}
+//# sourceMappingURL=cache.js.map

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

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

package/dist/app-select/hooks.d.ts

@@ -0,0 +1,56 @@
+import type { AppOption, AppSelectSource, SelectId } from './types.js';
+/**
+ * 已选 ID 的解析状态。
+ * 设计文档 §6.4 要求区分 loading / empty / not-found / error，
+ * 用户不能把「还在查」或「查不到」误认为业务值为空。
+ * `blocked` 是「缺少必需查询参数」：为了不查出别家范围的数据，宁可不解析。
+ */
+export type SelectedOptionStatus = 'empty' | 'loading' | 'resolved' | 'missing' | 'blocked' | 'error';
+export interface SelectedOptionState {
+    option: AppOption | null;
+    status: SelectedOptionStatus;
+}
+export interface ResolvedSource {
+    sourceObj?: AppSelectSource;
+    /** 稳定来源键：只用于缓存与告警，不进入 effect 依赖 */
+    sourceKey: string;
+}
+/**
+ * 每次渲染解析一次数据源，供候选与回显两条链路共用。
+ * 缓存键必须与「实际生效的源」一致，所以统一在这里算，不在各 hook 里各算一遍。
+ */
+export declare function useResolvedSource(source?: string, dataSource?: AppSelectSource): ResolvedSource;
+interface CandidateOptionsParams extends ResolvedSource {
+    queryParams?: Record<string, unknown>;
+    debounceMs?: number;
+}
+/**
+ * 候选选项：静态/字典挂载时加载一次；remote 只在打开下拉或输入关键词后请求，
+ * 避免表格首屏为每个单元格发默认候选请求。
+ */
+export declare function useCandidateOptions({ sourceObj, sourceKey, queryParams, debounceMs, }: CandidateOptionsParams): {
+    sourceObj: AppSelectSource | undefined;
+    candidates: AppOption<unknown>[];
+    loading: boolean;
+    search: (keyword: string) => void;
+    cancelPending: () => void;
+};
+interface SelectedOptionParams extends ResolvedSource {
+    value?: SelectId | null;
+    /** 对象模式自带的 label，可直接回显 */
+    legacyLabel?: string;
+    selectedOptions?: AppOption[];
+    /** 当前已加载候选：解析顺序第 3 位，命中就不用再发 resolve */
+    candidates?: AppOption[];
+    queryParams?: Record<string, unknown>;
+}
+/**
+ * 已选 ID 的标签解析：与关键词搜索完全独立。
+ *
+ * 解析顺序见设计文档 §6.1：
+ * 1. 匹配的 `selectedOptions`；2. 对象模式的 `value.label`；3. 已加载候选；
+ * 4. `resolve(id, queryParams)`；5. 未命中就保持 ID，并暴露状态。
+ */
+export declare function useSelectedOption({ sourceObj, sourceKey, value, legacyLabel, selectedOptions, candidates, queryParams, }: SelectedOptionParams): SelectedOptionState;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/app-select/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/app-select/hooks.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AASpE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,cAAc,CAmC/F;AAED,UAAU,sBAAuB,SAAQ,cAAc;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAgB,GACjB,EAAE,sBAAsB;;;;sBAsEX,MAAM;;EAkCnB;AAED,UAAU,oBAAqB,SAAQ,cAAc;IACnD,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;IAC9B,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAkBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,SAAS,EACT,KAAK,EACL,WAAW,EACX,eAAe,EACf,UAAU,EACV,WAAW,GACZ,EAAE,oBAAoB,GAAG,mBAAmB,CAgK5C"}

package/dist/app-select/hooks.js

@@ -0,0 +1,322 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { IS_DEV } from '../env.js';
+import { loadOptionsWithCache, resolveOptionWithCache } from './cache.js';
+import { resolveAppSelectSource, resolveAppSelectSourceKey } from './sources.js';
+import { buildResolveKey, hasRequiredParams, isEmptyId, optionsContentKey, stableStringify, } from './utils.js';
+/** 内联源的「形状」：kind + 提供了哪几个能力，用来识别「同一份配置每次渲染新建」 */
+function sourceShape(source) {
+    if (!source)
+        return '';
+    return [
+        source.kind,
+        source.loadOptions ? 1 : 0,
+        source.search ? 1 : 0,
+        source.resolve ? 1 : 0,
+        source.cacheNamespace ? 1 : 0,
+    ].join(':');
+}
+/**
+ * 每次渲染解析一次数据源，供候选与回显两条链路共用。
+ * 缓存键必须与「实际生效的源」一致，所以统一在这里算，不在各 hook 里各算一遍。
+ */
+export function useResolvedSource(source, dataSource) {
+    const sourceObj = resolveAppSelectSource(source, dataSource);
+    const sourceKey = resolveAppSelectSourceKey(source, dataSource);
+    const previousRef = useRef({ key: sourceKey, shape: sourceShape(sourceObj) });
+    const warnedMixedRef = useRef(false);
+    const warnedChurnRef = useRef(false);
+    if (IS_DEV) {
+        if (source && dataSource && !warnedMixedRef.current) {
+            warnedMixedRef.current = true;
+            console.warn('[schema] AppSelect 同时传了 source 与 dataSource，以 dataSource 为准');
+        }
+        // 形状没变、键却变了：几乎可以确定是页面每次渲染都新建了 dataSource / 内联函数，
+        // 缓存键会跟着失效（等同于不缓存），提示提到组件外或改用注册源。
+        const previous = previousRef.current;
+        if (!warnedChurnRef.current &&
+            previous.key !== sourceKey &&
+            previous.key.startsWith('inline:') &&
+            sourceKey.startsWith('inline:') &&
+            previous.shape === sourceShape(sourceObj)) {
+            warnedChurnRef.current = true;
+            console.warn('[schema] AppSelect 的 dataSource 每次渲染都产生新的函数引用，解析缓存会失效；' +
+                '请把 dataSource 提到组件外，或改用 registerAppSelectSource 注册');
+        }
+    }
+    previousRef.current = { key: sourceKey, shape: sourceShape(sourceObj) };
+    return { sourceObj, sourceKey };
+}
+// 空数组用常量，避免每次渲染新建引用导致下游 memo 失效
+const EMPTY_CANDIDATES = [];
+const NO_CANDIDATES = { paramsKey: null, list: EMPTY_CANDIDATES };
+/**
+ * 候选选项：静态/字典挂载时加载一次；remote 只在打开下拉或输入关键词后请求，
+ * 避免表格首屏为每个单元格发默认候选请求。
+ */
+export function useCandidateOptions({ sourceObj, sourceKey, queryParams, debounceMs = 300, }) {
+    // 搜索回调需要读最新的 requiredParams，避免用旧配置判断范围参数
+    const sourceRef = useRef(sourceObj);
+    sourceRef.current = sourceObj;
+    const paramsKey = stableStringify(queryParams ?? null);
+    const paramsRef = useRef(queryParams);
+    paramsRef.current = queryParams;
+    // 候选必须带着「取回时的级联参数」一起存：参数一变旧候选立刻失效，
+    // 否则切换省份后回显会先闪出一个别的省份的同 ID 名称。
+    // paramsKey 为 null 表示与参数无关（静态 / 字典）。
+    const [candidateState, setCandidateState] = useState(NO_CANDIDATES);
+    const candidates = candidateState.paramsKey === null || candidateState.paramsKey === paramsKey
+        ? candidateState.list
+        : EMPTY_CANDIDATES;
+    const [loading, setLoading] = useState(false);
+    const seqRef = useRef(0);
+    const abortRef = useRef(null);
+    const timerRef = useRef(null);
+    const cancelPending = useCallback(() => {
+        if (timerRef.current) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+        abortRef.current?.abort();
+        abortRef.current = null;
+    }, []);
+    useEffect(() => cancelPending, [cancelPending]);
+    const isRemote = sourceObj?.kind === 'remote';
+    const searchFn = isRemote ? sourceObj?.search : undefined;
+    const loadFn = !isRemote ? sourceObj?.loadOptions : undefined;
+    // 静态 / 有限字典：加载一次即可，失败不抛给调用方
+    useEffect(() => {
+        if (!loadFn) {
+            // 切到 remote 源时旧 effect 已被取消，这里要负责把 loading 和旧候选收掉
+            setCandidateState(NO_CANDIDATES);
+            setLoading(false);
+            return;
+        }
+        let cancelled = false;
+        setLoading(true);
+        loadOptionsWithCache(sourceKey, () => loadFn())
+            .then((list) => {
+            // 静态源的候选与级联参数无关，标记为 paramsKey: null
+            if (!cancelled)
+                setCandidateState({ paramsKey: null, list });
+        })
+            .catch(() => {
+            if (!cancelled)
+                setCandidateState(NO_CANDIDATES);
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [loadFn, sourceKey]);
+    // 级联参数变化：取消在途请求；旧候选由上面的 paramsKey 比对挡住，不必清空
+    useEffect(() => {
+        cancelPending();
+    }, [paramsKey, cancelPending]);
+    const search = useCallback((keyword) => {
+        if (!searchFn)
+            return;
+        // 范围参数不全就不发搜索：否则用户会看到别的租户/省份的候选
+        if (!hasRequiredParams(sourceRef.current?.requiredParams, paramsRef.current)) {
+            cancelPending();
+            setCandidateState({ paramsKey, list: EMPTY_CANDIDATES });
+            setLoading(false);
+            return;
+        }
+        cancelPending();
+        timerRef.current = setTimeout(() => {
+            timerRef.current = null;
+            const seq = seqRef.current + 1;
+            seqRef.current = seq;
+            const controller = new AbortController();
+            abortRef.current = controller;
+            setLoading(true);
+            searchFn(keyword, paramsRef.current, controller.signal)
+                .then((list) => {
+                // 记下请求发出时的 paramsKey：返回时参数已变，这批候选会被挡住
+                if (seq === seqRef.current)
+                    setCandidateState({ paramsKey, list });
+            })
+                .catch(() => {
+                if (seq === seqRef.current)
+                    setCandidateState({ paramsKey, list: EMPTY_CANDIDATES });
+            })
+                .finally(() => {
+                if (seq === seqRef.current)
+                    setLoading(false);
+            });
+        }, debounceMs);
+    }, [searchFn, paramsKey, debounceMs, cancelPending]);
+    return { sourceObj, candidates, loading, search, cancelPending };
+}
+const EMPTY_SELECTED = {
+    value: undefined,
+    sourceKey: '',
+    paramsKey: '',
+    option: null,
+    status: 'empty',
+};
+/**
+ * 已选 ID 的标签解析：与关键词搜索完全独立。
+ *
+ * 解析顺序见设计文档 §6.1：
+ * 1. 匹配的 `selectedOptions`；2. 对象模式的 `value.label`；3. 已加载候选；
+ * 4. `resolve(id, queryParams)`；5. 未命中就保持 ID，并暴露状态。
+ */
+export function useSelectedOption({ sourceObj, sourceKey, value, legacyLabel, selectedOptions, candidates, queryParams, }) {
+    const sourceRef = useRef(sourceObj);
+    sourceRef.current = sourceObj;
+    const paramsRef = useRef(queryParams);
+    paramsRef.current = queryParams;
+    const paramsKey = stableStringify(queryParams ?? null);
+    const empty = isEmptyId(value);
+    const hint = empty ? undefined : selectedOptions?.find((item) => item.value === value);
+    const candidate = empty ? undefined : candidates?.find((item) => item.value === value);
+    // 前三级可以同步拿到结果。用内容键判断，父组件每次渲染新建数组不会触发重新解析。
+    const syncKey = [
+        empty ? 'empty' : `${typeof value}:${String(value)}`,
+        legacyLabel ?? '',
+        optionsContentKey(hint ? [hint] : undefined),
+        optionsContentKey(candidate ? [candidate] : undefined),
+    ].join('|');
+    const syncRef = useRef({ key: '', option: null });
+    if (syncRef.current.key !== syncKey) {
+        let option = null;
+        if (!empty) {
+            const id = value;
+            if (hint)
+                option = hint;
+            else if (legacyLabel)
+                option = { value: id, label: legacyLabel };
+            else if (candidate)
+                option = candidate;
+        }
+        syncRef.current = { key: syncKey, option };
+    }
+    const syncOption = syncRef.current.option;
+    // 已经展示过的标签：用户继续输入关键词、候选被换掉时，已选项不该短暂退回原始 ID
+    const knownRef = useRef(null);
+    if (!empty && syncOption) {
+        knownRef.current = { value: value, sourceKey, paramsKey, option: syncOption };
+    }
+    const [asyncSelected, setAsyncSelected] = useState(EMPTY_SELECTED);
+    const isRemote = sourceObj?.kind === 'remote';
+    const loadFn = !isRemote ? sourceObj?.loadOptions : undefined;
+    const resolveFn = isRemote ? sourceObj?.resolve : undefined;
+    // 范围参数不全：宁可不解析，也不能用空条件查出别家范围的数据
+    const blocked = !hasRequiredParams(sourceObj?.requiredParams, paramsRef.current);
+    useEffect(() => {
+        // 前三级已经给出结果，不需要请求
+        if (syncOption)
+            return;
+        if (empty) {
+            setAsyncSelected(EMPTY_SELECTED);
+            return;
+        }
+        if (!loadFn && !resolveFn) {
+            setAsyncSelected({
+                value: value,
+                sourceKey,
+                paramsKey,
+                option: null,
+                status: 'missing',
+            });
+            return;
+        }
+        if (blocked) {
+            setAsyncSelected({
+                value: value,
+                sourceKey,
+                paramsKey,
+                option: null,
+                status: 'blocked',
+            });
+            return;
+        }
+        let cancelled = false;
+        const settle = (option) => {
+            if (cancelled)
+                return;
+            setAsyncSelected({
+                value: value,
+                sourceKey,
+                paramsKey,
+                option,
+                status: option ? 'resolved' : 'missing',
+            });
+        };
+        const fail = () => {
+            if (cancelled)
+                return;
+            setAsyncSelected({
+                value: value,
+                sourceKey,
+                paramsKey,
+                option: null,
+                status: 'error',
+            });
+        };
+        setAsyncSelected({
+            value: value,
+            sourceKey,
+            paramsKey,
+            option: null,
+            status: 'loading',
+        });
+        if (loadFn) {
+            // 静态 / 字典：本地集合里匹配
+            loadOptionsWithCache(sourceKey, () => loadFn())
+                .then((list) => settle(list.find((option) => option.value === value) ?? null))
+                .catch(fail);
+        }
+        else {
+            // 远程按 ID 精确解析，走共享缓存
+            const key = buildResolveKey({
+                scope: sourceRef.current?.cacheNamespace?.(),
+                sourceKey,
+                value: value,
+                params: paramsRef.current,
+            });
+            resolveOptionWithCache(key, () => resolveFn(value, paramsRef.current))
+                .then(settle)
+                .catch(fail);
+        }
+        return () => {
+            cancelled = true;
+        };
+    }, [value, empty, syncOption, loadFn, resolveFn, blocked, sourceKey, paramsKey]);
+    if (syncOption)
+        return { option: syncOption, status: 'resolved' };
+    if (empty)
+        return { option: null, status: 'empty' };
+    // 数据源没有解析能力时不必等 effect，直接给出 missing
+    if (!loadFn && !resolveFn)
+        return { option: null, status: 'missing' };
+    if (blocked)
+        return { option: null, status: 'blocked' };
+    // 值 / 来源 / 级联参数变了但 effect 还没跑完：不能拿上一轮的结果顶上
+    if (asyncSelected.value !== value ||
+        asyncSelected.sourceKey !== sourceKey ||
+        asyncSelected.paramsKey !== paramsKey) {
+        return { option: null, status: 'loading' };
+    }
+    if (asyncSelected.option) {
+        knownRef.current = {
+            value: value,
+            sourceKey,
+            paramsKey,
+            option: asyncSelected.option,
+        };
+    }
+    // 正在按同一上下文重新解析：先沿用上次拿到的标签，避免一闪而过的原始 ID
+    if (asyncSelected.status === 'loading' && knownRef.current) {
+        const known = knownRef.current;
+        if (known.value === value && known.sourceKey === sourceKey && known.paramsKey === paramsKey) {
+            return { option: known.option, status: 'resolved' };
+        }
+    }
+    return { option: asyncSelected.option, status: asyncSelected.status };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/app-select/hooks.js.map

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

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

@@ -0,0 +1,7 @@
+import './register.js';
+export { AppSelect } from './AppSelect.js';
+export { AppSelectDisplay } from './AppSelectDisplay.js';
+export { registerAppSelectSource, unregisterAppSelectSource, getAppSelectSource, resolveAppSelectSource, clearAppSelectSources, } from './sources.js';
+export { clearAppSelectCache, getAppSelectCacheSize } from './cache.js';
+export type { AppOption, AppSelectDisplayProps, AppSelectProps, AppSelectSource, AppValueMode, LegacyValue, SelectId, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-select/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrE,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC"}

package/dist/app-select/index.js

@@ -0,0 +1,6 @@
+import './register.js';
+export { AppSelect } from './AppSelect.js';
+export { AppSelectDisplay } from './AppSelectDisplay.js';
+export { registerAppSelectSource, unregisterAppSelectSource, getAppSelectSource, resolveAppSelectSource, clearAppSelectSources, } from './sources.js';
+export { clearAppSelectCache, getAppSelectCacheSize } from './cache.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app-select/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

package/dist/app-select/register.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/app-select/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/app-select/register.tsx"],"names":[],"mappings":""}

package/dist/app-select/register.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { registerField } from '../registry.js';
+import { AppSelect } from './AppSelect.js';
+import { AppSelectDisplay } from './AppSelectDisplay.js';
+// 只读展示必须走同一个解析能力，因此注册项里挂 AppSelectDisplay 而不是简单取 label
+registerField('AppSelect', {
+    component: AppSelect,
+    renderRead: (value, props) => (_jsx(AppSelectDisplay, { value: value, source: props.source, dataSource: props.dataSource, valueMode: props.valueMode, queryParams: props.queryParams, selectedOptions: props.selectedOptions })),
+});
+//# sourceMappingURL=register.js.map

package/dist/app-select/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/app-select/register.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,uDAAuD;AACvD,aAAa,CAAC,WAAW,EAAE;IACzB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAC5B,KAAC,gBAAgB,IACf,KAAK,EAAE,KAAkD,EACzD,MAAM,EAAE,KAAK,CAAC,MAA4B,EAC1C,UAAU,EAAE,KAAK,CAAC,UAAiD,EACnE,SAAS,EAAE,KAAK,CAAC,SAAqC,EACtD,WAAW,EAAE,KAAK,CAAC,WAAkD,EACrE,eAAe,EAAE,KAAK,CAAC,eAA0C,GACjE,CACH;CACF,CAAC,CAAC"}

package/dist/app-select/sources.d.ts

@@ -0,0 +1,20 @@
+import type { AppSelectSource } from './types.js';
+/** 注册应用级数据源；系统级常见字段优先走这里，低频页面可直接传 dataSource */
+export declare function registerAppSelectSource(name: string, source: AppSelectSource): void;
+export declare function unregisterAppSelectSource(name: string): void;
+export declare function getAppSelectSource(name?: string): AppSelectSource | undefined;
+/** source 与 dataSource 二选一，dataSource 优先，不做静默混合 */
+export declare function resolveAppSelectSource(name?: string, dataSource?: AppSelectSource): AppSelectSource | undefined;
+export declare function clearAppSelectSources(): void;
+/**
+ * 来源的稳定身份，参与解析缓存键。
+ *
+ * 注册源直接用名字；内联 `dataSource` 没有名字，不能像旧实现那样统一退化成 `'inline'`，
+ * 否则两个不同接口遇到相同 id + 相同参数会命中同一缓存，拿到别家的 label。
+ *
+ * 内联源优先按**函数引用**识别：模块级/页面级的 dataSource 常量函数引用稳定，
+ * 表格里同一列的多个单元格因此还能共享一份解析缓存。
+ * 只有完全没有函数的纯数据源才退回对象身份。
+ */
+export declare function resolveAppSelectSourceKey(name?: string, dataSource?: AppSelectSource): string;
+//# sourceMappingURL=sources.d.ts.map

package/dist/app-select/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/app-select/sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAInF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG5D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE7E;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CACpC,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,eAAe,GAC3B,eAAe,GAAG,SAAS,CAE7B;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAeD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,eAAe,GAC3B,MAAM,CAcR"}

package/dist/app-select/sources.js

@@ -0,0 +1,59 @@
+import { clearAppSelectCacheOfSource } from './cache.js';
+const sources = new Map();
+/** 注册应用级数据源；系统级常见字段优先走这里，低频页面可直接传 dataSource */
+export function registerAppSelectSource(name, source) {
+    sources.set(name, source);
+    // 同名重新注册（HMR / 动态切换）时旧缓存不再代表当前实现
+    clearAppSelectCacheOfSource(name);
+}
+export function unregisterAppSelectSource(name) {
+    sources.delete(name);
+    clearAppSelectCacheOfSource(name);
+}
+export function getAppSelectSource(name) {
+    return name ? sources.get(name) : undefined;
+}
+/** source 与 dataSource 二选一，dataSource 优先，不做静默混合 */
+export function resolveAppSelectSource(name, dataSource) {
+    return dataSource ?? getAppSelectSource(name);
+}
+export function clearAppSelectSources() {
+    sources.clear();
+}
+const inlineIds = new WeakMap();
+let inlineIdSeq = 0;
+function nextInlineId(target) {
+    let id = inlineIds.get(target);
+    if (id === undefined) {
+        inlineIdSeq += 1;
+        id = inlineIdSeq;
+        inlineIds.set(target, id);
+    }
+    return id;
+}
+/**
+ * 来源的稳定身份，参与解析缓存键。
+ *
+ * 注册源直接用名字；内联 `dataSource` 没有名字，不能像旧实现那样统一退化成 `'inline'`，
+ * 否则两个不同接口遇到相同 id + 相同参数会命中同一缓存，拿到别家的 label。
+ *
+ * 内联源优先按**函数引用**识别：模块级/页面级的 dataSource 常量函数引用稳定，
+ * 表格里同一列的多个单元格因此还能共享一份解析缓存。
+ * 只有完全没有函数的纯数据源才退回对象身份。
+ */
+export function resolveAppSelectSourceKey(name, dataSource) {
+    if (!dataSource)
+        return name ? `source:${name}` : '';
+    const functions = [
+        dataSource.loadOptions,
+        dataSource.search,
+        dataSource.resolve,
+        dataSource.cacheNamespace,
+    ];
+    const parts = functions.map((fn) => (fn ? nextInlineId(fn) : '-'));
+    if (!parts.some((part) => part !== '-')) {
+        return `inline:${dataSource.kind}:data#${nextInlineId(dataSource)}`;
+    }
+    return `inline:${dataSource.kind}:${parts.join('.')}`;
+}
+//# sourceMappingURL=sources.js.map

package/dist/app-select/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/app-select/sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAGtD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEnD,gDAAgD;AAChD,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAAuB;IAC3E,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1B,iCAAiC;IACjC,2BAA2B,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,2BAA2B,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,sBAAsB,CACpC,IAAa,EACb,UAA4B;IAE5B,OAAO,UAAU,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,OAAO,EAAkB,CAAC;AAChD,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,WAAW,IAAI,CAAC,CAAC;QACjB,EAAE,GAAG,WAAW,CAAC;QACjB,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAa,EACb,UAA4B;IAE5B,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD,MAAM,SAAS,GAAG;QAChB,UAAU,CAAC,WAAW;QACtB,UAAU,CAAC,MAAM;QACjB,UAAU,CAAC,OAAO;QAClB,UAAU,CAAC,cAAc;KAC1B,CAAC;IACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,UAAU,UAAU,CAAC,IAAI,SAAS,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,UAAU,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACxD,CAAC"}