@tianyr/schema-antd 0.1.0 → 0.2.0

package/dist/biz-select/useCandidates.js

@@ -0,0 +1,292 @@
+/**
+ * 候选选项：加载、搜索、防抖、取消、参数失效。
+ *
+ * 关键约束（设计文档 §5.3）：**effect / useCallback 的依赖里不出现源对象和其中的函数**。
+ * 源一律从 ref 读，依赖只保留 sourceKey / paramsKey 这类字符串。
+ * 违反这条的直接后果是：父组件每渲染一次，列表里每个单元格各发一次请求。
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { dropCandidateCache, loadCandidatesWithCache } from './cache.js';
+import { candidatesCacheKey, paramsKeyOf } from './key.js';
+import { hasRequiredParams, normalizeSource } from './normalize.js';
+import { resolveSelectSource } from './registry.js';
+import { useStableSourceKey } from './useStableSourceKey.js';
+import { filterOptions } from './format.js';
+const EMPTY_OPTIONS = [];
+export function useCandidates({ source: sourceProp, cacheKey, params, searchFields, debounceMs = 300, }) {
+    const source = resolveSelectSource(sourceProp);
+    // 订阅版本在这里：失效 / 重注册后键会变，已挂载的实例才会重新取数
+    const sourceKey = useStableSourceKey(sourceProp, cacheKey);
+    const capability = normalizeSource(source);
+    const { candidateMode, requiredParams, needsFetch } = capability;
+    const paramsKey = paramsKeyOf(params);
+    const blocked = !hasRequiredParams(requiredParams, params);
+    // 源与参数只走 ref：它们可以每帧变化，但绝不能成为 effect 依赖
+    const sourceRef = useRef(source);
+    sourceRef.current = source;
+    const paramsRef = useRef(params);
+    paramsRef.current = params;
+    const scopeRef = useRef('');
+    scopeRef.current = source?.namespace?.() ?? '';
+    // 当前作用域参与结果归属判断：只进缓存键不够，租户切换后旧候选仍会显示
+    const scope = scopeRef.current;
+    const sourceKeyRef = useRef(sourceKey);
+    sourceKeyRef.current = sourceKey;
+    const [loadState, setLoadState] = useState(null);
+    const [searchState, setSearchState] = useState(null);
+    const [keyword, setKeyword] = useState('');
+    // reload 在回调里要读当前关键词，不能进依赖（否则每次输入都换新函数）
+    const keywordRef = useRef('');
+    keywordRef.current = keyword;
+    // load 与 search 各记一份：共用会互相覆盖，一个结束就把另一个的「进行中」抹掉
+    const [loadLoading, setLoadLoading] = useState(false);
+    const [searchLoading, setSearchLoading] = useState(false);
+    const [error, setError] = useState(false);
+    /** 递增表示「需要拉一次候选」：展开下拉或手动重载 */
+    const [loadTick, setLoadTick] = useState(0);
+    /** 下拉是否展开：纯搜索型只在展开时才跟着源 / 条件变化重查 */
+    const openedRef = useRef(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;
+        // 作废版本号才是正确性保障：abort 只是优化，源不认 signal 时仍会 resolve，
+        // 那时 seq 已经对不上，不会把旧结果写成 error / 空列表
+        seqRef.current += 1;
+        // 被作废的请求不再回来收尾，loading 得在这里结束：否则关掉下拉后就一直转圈
+        setSearchLoading(false);
+    }, []);
+    useEffect(() => cancelPending, [cancelPending]);
+    // 加载全集：只在展开下拉之后发生，依赖全是字符串，源从 ref 取
+    useEffect(() => {
+        const current = sourceRef.current;
+        const load = current?.load;
+        // 上一次的请求被这次变更作废（cancelled）后不会自己收尾，提前返回时必须补关 loading
+        if (!loadTick || blocked || !load) {
+            setLoadLoading(false);
+            return;
+        }
+        const key = candidatesCacheKey(scope, sourceKey, paramsKey);
+        let cancelled = false;
+        setLoadLoading(true);
+        setError(false);
+        loadCandidatesWithCache(key, () => load(paramsRef.current ?? {}, undefined))
+            .then((list) => {
+            if (!cancelled)
+                setLoadState({ sourceKey, scope, paramsKey, list });
+        })
+            .catch(() => {
+            if (!cancelled) {
+                setLoadState({ sourceKey, scope, paramsKey, list: EMPTY_OPTIONS });
+                setError(true);
+            }
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoadLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [loadTick, sourceKey, scope, paramsKey, blocked, candidateMode]);
+    // 身份变化（条件 / 来源 / 租户）：取消在途请求，旧结果靠三元比对自动失效。
+    // scope 必须在这里：租户切了但 sourceKey、paramsKey 没变，在途请求照样得作废
+    useEffect(() => {
+        cancelPending();
+        setKeyword('');
+    }, [paramsKey, sourceKey, scope, cancelPending]);
+    const runSearch = useCallback((keywordValue, key) => {
+        // 缺必需参数一律不查。open / reload 是公开入口（树、弹窗也会调），
+        // 光靠组件上的 disabled 挡不住，守卫必须收在真正发请求的这一处
+        if (blocked)
+            return;
+        const current = sourceRef.current;
+        const search = current?.search;
+        if (!search)
+            return;
+        const seq = seqRef.current + 1;
+        seqRef.current = seq;
+        const controller = new AbortController();
+        abortRef.current = controller;
+        // 归属信息在发请求时定格：结果回来后要能证明它属于哪个源、哪个租户
+        const sourceKeyAtRequest = sourceKeyRef.current;
+        const scopeAtRequest = scopeRef.current;
+        setSearchLoading(true);
+        setError(false);
+        search(keywordValue, paramsRef.current ?? {}, controller.signal)
+            .then((list) => {
+            if (seq !== seqRef.current)
+                return;
+            setSearchState({
+                sourceKey: sourceKeyAtRequest,
+                scope: scopeAtRequest,
+                paramsKey: key,
+                keyword: keywordValue,
+                list,
+            });
+        })
+            .catch(() => {
+            if (seq !== seqRef.current)
+                return;
+            setSearchState({
+                sourceKey: sourceKeyAtRequest,
+                scope: scopeAtRequest,
+                paramsKey: key,
+                keyword: keywordValue,
+                list: EMPTY_OPTIONS,
+            });
+            setError(true);
+        })
+            .finally(() => {
+            if (seq === seqRef.current)
+                setSearchLoading(false);
+        });
+    }, [blocked]);
+    const search = useCallback((keywordValue) => {
+        setKeyword(keywordValue);
+        if (blocked || !needsFetch || candidateMode === 'load')
+            return;
+        if (candidateMode !== 'search' && candidateMode !== 'hybrid')
+            return;
+        cancelPending();
+        const key = paramsKeyOf(paramsRef.current);
+        timerRef.current = setTimeout(() => {
+            timerRef.current = null;
+            runSearch(keywordValue, key);
+        }, debounceMs);
+    }, [blocked, needsFetch, candidateMode, debounceMs, cancelPending, runSearch]);
+    const searchStateRef = useRef(null);
+    searchStateRef.current = searchState;
+    const open = useCallback(() => {
+        openedRef.current = true;
+        setLoadTick((tick) => tick + 1);
+        // 纯搜索型没有全集，展开时先取一次默认候选；已经取过就不重复请求
+        const current = sourceRef.current;
+        if (!current?.search || current.load)
+            return;
+        const key = paramsKeyOf(paramsRef.current);
+        const state = searchStateRef.current;
+        // 换了源或租户，旧结果不再代表当前范围，必须重查
+        if (!state ||
+            state.sourceKey !== sourceKeyRef.current ||
+            state.scope !== scopeRef.current ||
+            state.paramsKey !== key ||
+            state.keyword !== '') {
+            runSearch('', key);
+        }
+    }, [runSearch]);
+    /** 收起下拉：清关键字并作废在途搜索，避免关掉之后才回来的结果写进状态 */
+    const resetKeyword = useCallback(() => {
+        openedRef.current = false;
+        cancelPending();
+        setKeyword('');
+    }, [cancelPending]);
+    /** 手动重取：绕开缓存。有关键词就重跑搜索，否则重拉全集 */
+    const reload = useCallback(() => {
+        cancelPending();
+        const key = paramsKeyOf(paramsRef.current);
+        const current = sourceRef.current;
+        if (keywordRef.current && current?.search) {
+            runSearch(keywordRef.current, key);
+            return;
+        }
+        if (current?.load) {
+            // 先删缓存再 bump，否则 effect 跑起来又会命中同一份
+            dropCandidateCache(candidatesCacheKey(scopeRef.current, sourceKeyRef.current, key));
+            setLoadTick((tick) => tick + 1);
+            return;
+        }
+        if (current?.search)
+            runSearch('', key);
+    }, [cancelPending, runSearch]);
+    /**
+     * 纯搜索型没有 load effect 兜底：源失效、或父字段改了条件，而下拉还开着时，
+     * 旧候选会一直挂在列表里（可能是别的仓库的记录）。这里补一次重查。
+     * 带 load 的源由加载 effect 负责，不重复发请求。
+     */
+    const identityRef = useRef({ sourceKey, paramsKey, scope });
+    useEffect(() => {
+        const previous = identityRef.current;
+        identityRef.current = { sourceKey, paramsKey, scope };
+        if (!openedRef.current)
+            return;
+        if (previous.sourceKey === sourceKey &&
+            previous.paramsKey === paramsKey &&
+            previous.scope === scope) {
+            return;
+        }
+        const current = sourceRef.current;
+        if (!current?.search || current.load)
+            return;
+        runSearch('', paramsKeyOf(paramsRef.current));
+    }, [sourceKey, paramsKey, scope, runSearch]);
+    const loadValid = Boolean(loadState &&
+        loadState.sourceKey === sourceKey &&
+        loadState.scope === scope &&
+        loadState.paramsKey === paramsKey);
+    const searchValid = Boolean(searchState &&
+        searchState.sourceKey === sourceKey &&
+        searchState.scope === scope &&
+        searchState.paramsKey === paramsKey &&
+        searchState.keyword === keyword);
+    const options = useMemo(() => {
+        if (blocked || candidateMode === 'invalid' || candidateMode === 'none')
+            return EMPTY_OPTIONS;
+        // 同步全集也要过本地过滤：filterOption=false 已关掉 antd 自带过滤，
+        // 这里不处理的话静态源在输入框里根本筛不动
+        if (candidateMode === 'sync') {
+            return filterOptions(source?.options ?? EMPTY_OPTIONS, keyword, searchFields);
+        }
+        if (candidateMode === 'load') {
+            if (!loadValid || !loadState)
+                return EMPTY_OPTIONS;
+            // 全集已在前端，关键字只做本地过滤
+            return filterOptions(loadState.list, keyword, searchFields);
+        }
+        if (candidateMode === 'hybrid') {
+            if (keyword)
+                return searchValid && searchState ? searchState.list : EMPTY_OPTIONS;
+            return loadValid && loadState ? loadState.list : EMPTY_OPTIONS;
+        }
+        return searchValid && searchState ? searchState.list : EMPTY_OPTIONS;
+    }, [
+        blocked,
+        candidateMode,
+        source,
+        loadValid,
+        loadState,
+        searchValid,
+        searchState,
+        keyword,
+        searchFields,
+    ]);
+    // 回显要用未过滤的候选：已选项可能正好被关键词筛掉
+    const echoOptions = useMemo(() => {
+        if (candidateMode === 'sync')
+            return source?.options ?? EMPTY_OPTIONS;
+        if (loadValid && loadState)
+            return loadState.list;
+        // 纯搜索型没有全集，只能用手上这批
+        return options;
+    }, [candidateMode, source, loadValid, loadState, options]);
+    return {
+        sourceKey,
+        options,
+        echoOptions,
+        keyword,
+        loading: loadLoading || searchLoading,
+        error,
+        blocked,
+        open,
+        search,
+        resetKeyword,
+        reload,
+    };
+}
+//# sourceMappingURL=useCandidates.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { BizOption, SelectParams, SelectSource, SelectValue } from './types.js';
+export interface UseResolvedLabelsOptions {
+    /** 注册名或内联源；解析与来源键都在 Hook 内完成，调用方别自己拼 */
+    source?: string | SelectSource;
+    /** 这一屏出现的编码，重复的、空值的会被去掉 */
+    values?: ReadonlyArray<SelectValue | null | undefined>;
+    /** 传给源的查询条件，参与缓存键；缺 requiredParams 就不查 */
+    params?: SelectParams;
+    /** 内联源需要跨实例共享缓存时显式指定；注册名自带稳定键 */
+    cacheKey?: string;
+    /** 每批最多多少个编码，按接口上限配，默认 100 */
+    batchSize?: number;
+}
+export interface UseResolvedLabelsResult {
+    /** 编码 → 选项，键不带类型前缀，列表行里的原始值能直接查 */
+    byCode: Map<string, BizOption>;
+    /** 解析到的全部选项，可直接当 `seedOptions` 传给表格单元格 */
+    options: BizOption[];
+    loading: boolean;
+    error: boolean;
+    /** 缺 requiredParams，一个请求都没发 */
+    blocked: boolean;
+    /** 这次实际发起的请求数；没声明 `resolveMany` 时等于不同编码的个数 */
+    requests: number;
+    reload(): void;
+}
+export declare function useResolvedLabels({ source: sourceProp, values, params, cacheKey, batchSize, }: UseResolvedLabelsOptions): UseResolvedLabelsResult;
+//# sourceMappingURL=useResolvedLabels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedLabels.d.ts","sourceRoot":"","sources":["../../src/biz-select/useResolvedLabels.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC/B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACvD,0CAA0C;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,0CAA0C;IAC1C,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,IAAI,IAAI,CAAC;CAChB;AA8BD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EAAE,UAAU,EAClB,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAA8B,GAC/B,EAAE,wBAAwB,GAAG,uBAAuB,CA6HpD"}

package/dist/biz-select/useResolvedLabels.js

@@ -0,0 +1,151 @@
+/**
+ * 一屏编码 → 名称：表格列这类「只有 id、没有名称」的批量回显。
+ *
+ * 和 `useCandidates` 对称：那边拿候选全集，这边只拿已解析的这几条。
+ * 页面调一次，结果既能直接当 `seedOptions` 传给单元格，也能按编码查表渲染文本。
+ *
+ * 依赖里同样只放字符串（sourceKey / paramsKey / codesKey），源从 ref 读——
+ * 否则父组件每渲染一次就会重发一轮批量请求。
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { IS_DEV } from '../env.js';
+import { lookupKeyOf, paramsKeyOf } from './key.js';
+import { normalizeSource } from './normalize.js';
+import { resolveSelectSource } from './registry.js';
+import { DEFAULT_BATCH_SIZE, resolveCodes } from './resolveBatch.js';
+import { useStableSourceKey } from './useStableSourceKey.js';
+const EMPTY_MAP = new Map();
+const EMPTY_OPTIONS = [];
+/** 编码集合的稳定身份：排序后拼接，行顺序变了不算变化 */
+function codesKeyOf(values) {
+    const keys = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        const key = lookupKeyOf(value);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        keys.push(key);
+    }
+    return keys.sort().join('|');
+}
+export function useResolvedLabels({ source: sourceProp, values, params, cacheKey, batchSize = DEFAULT_BATCH_SIZE, }) {
+    const source = resolveSelectSource(sourceProp);
+    const sourceKey = useStableSourceKey(sourceProp, cacheKey);
+    const scope = source?.namespace?.() ?? '';
+    const paramsKey = paramsKeyOf(params);
+    const codesKey = codesKeyOf(values ?? []);
+    const sourceRef = useRef(source);
+    sourceRef.current = source;
+    const paramsRef = useRef(params);
+    paramsRef.current = params;
+    const valuesRef = useRef(values);
+    valuesRef.current = values;
+    const [state, setState] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(false);
+    const [nonce, setNonce] = useState(0);
+    const warnedRef = useRef(new Set());
+    /** reload 是一次性的：用完就清，否则之后换页也会一直绕开缓存 */
+    const forceRef = useRef(false);
+    useEffect(() => {
+        if (!codesKey) {
+            setState(null);
+            setLoading(false);
+            setError(false);
+            return;
+        }
+        const current = sourceRef.current;
+        // 没有按值查询能力：不发请求，展示层会退回编码
+        if (!normalizeSource(current).canResolve) {
+            setState(null);
+            setLoading(false);
+            return;
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(false);
+        const force = forceRef.current;
+        forceRef.current = false;
+        resolveCodes({
+            source: current,
+            sourceKey,
+            scope,
+            params: paramsRef.current,
+            codes: valuesRef.current ?? [],
+            batchSize,
+            force,
+        })
+            .then((result) => {
+            if (cancelled)
+                return;
+            // 没声明批量接口时，这一屏就是 N 个请求——开发态提示一次，
+            // 用来收集「哪个页面真的需要后端批量接口」，而不是靠感觉判断
+            if (IS_DEV && !current?.resolveMany && result.requests > 1 && !warnedRef.current.has(sourceKey)) {
+                warnedRef.current.add(sourceKey);
+                console.warn(`[schema] 本次为 ${result.requests} 个不同编码各发了一次请求。` +
+                    '源支持 IN 过滤时请声明 resolveMany；不支持的话，表格列应改用 load 型源一次拉全量');
+            }
+            setState({
+                sourceKey,
+                scope,
+                paramsKey,
+                codesKey,
+                byCode: result.byCode,
+                options: [...result.byCode.values()],
+                blocked: result.blocked,
+                requests: result.requests,
+            });
+        })
+            .catch(() => {
+            if (cancelled)
+                return;
+            // 批量失败就是整片失败：不自动降级成逐条重试，否则一次故障放大成 N 个请求
+            setState(null);
+            setError(true);
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+        // sourceKey / scope / paramsKey / codesKey 都是字符串，源与参数从 ref 读
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [sourceKey, scope, paramsKey, codesKey, batchSize, nonce]);
+    const reload = useCallback(() => {
+        forceRef.current = true;
+        setNonce((value) => value + 1);
+    }, []);
+    return useMemo(() => {
+        const matched = state &&
+            state.sourceKey === sourceKey &&
+            state.scope === scope &&
+            state.paramsKey === paramsKey &&
+            state.codesKey === codesKey;
+        if (!matched || !state) {
+            return {
+                byCode: EMPTY_MAP,
+                options: EMPTY_OPTIONS,
+                loading,
+                error,
+                blocked: false,
+                requests: 0,
+                reload,
+            };
+        }
+        return {
+            byCode: state.byCode,
+            options: state.options,
+            loading,
+            error,
+            blocked: state.blocked,
+            requests: state.requests,
+            reload,
+        };
+    }, [state, sourceKey, scope, paramsKey, codesKey, loading, error, reload]);
+}
+//# sourceMappingURL=useResolvedLabels.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { BizOption, SelectParams, SelectSource, SelectValue } from './types.js';
+export type SelectedStatus = 'empty' | 'loading' | 'resolved' | 'missing' | 'blocked' | 'error';
+export interface UseSelectedLabelOptions {
+    source?: SelectSource;
+    sourceKey: string;
+    code?: SelectValue;
+    /** 对象值里自带的名称 */
+    valueName?: string;
+    seedOptions?: BizOption[];
+    candidates?: BizOption[];
+    params?: SelectParams;
+}
+export interface UseSelectedLabelResult {
+    option: BizOption | null;
+    status: SelectedStatus;
+}
+export declare function useSelectedLabel({ source, sourceKey, code, valueName, seedOptions, candidates, params, }: UseSelectedLabelOptions): UseSelectedLabelResult;
+//# sourceMappingURL=useSelectedLabel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectedLabel.d.ts","sourceRoot":"","sources":["../../src/biz-select/useSelectedLabel.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElF,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhG,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;CACxB;AAqBD,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,SAAS,EACT,IAAI,EACJ,SAAS,EACT,WAAW,EACX,UAAU,EACV,MAAM,GACP,EAAE,uBAAuB,GAAG,sBAAsB,CAkJlD"}