@tianyr/schema-antd 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,68 @@
+import type { ReactNode } from 'react';
+import type { SelectProps } from 'antd';
+export type SelectId = string | number;
+export interface AppOption<T = unknown> {
+    value: SelectId;
+    label: string;
+    disabled?: boolean;
+    /** 原始接口记录，供业务回调使用；不会被写进历史对象协议 */
+    raw?: T;
+}
+/** 历史服务端协议：{ value, label } */
+export type LegacyValue = {
+    value: SelectId;
+    label: string;
+};
+export type AppValueMode = 'primitive' | 'object';
+export interface AppSelectSource {
+    kind: 'static' | 'dict' | 'remote';
+    /** static/dict：有限集合，直接给或异步加载一次 */
+    loadOptions?: () => AppOption[] | Promise<AppOption[]>;
+    /** remote：关键词搜索，允许空关键词返回默认候选 */
+    search?: (keyword: string, params?: Record<string, unknown>, signal?: AbortSignal) => Promise<AppOption[]>;
+    /** remote：按 ID 精确解析，不能用模糊搜索冒充 */
+    resolve?: (id: SelectId, params?: Record<string, unknown>, signal?: AbortSignal) => Promise<AppOption | null>;
+    /** 租户/权限命名空间：参与解析缓存键，缺省视为同一命名空间 */
+    cacheNamespace?: () => string;
+    /**
+     * 必须齐备的查询参数（按 queryParams 的键声明）。
+     * 缺少任何一个都不发请求：用空条件去查，轻则查不到，重则拿到别的租户/省份的记录。
+     */
+    requiredParams?: string[];
+}
+/** 应用级数据源注册表；page 局部接口可直接传 dataSource，不必注册 */
+export type AppSelectSourceRegistry = Map<string, AppSelectSource>;
+type BaseProps = Omit<SelectProps, 'value' | 'defaultValue' | 'onChange' | 'options' | 'labelInValue' | 'mode' | 'onSearch'> & {
+    source?: string;
+    dataSource?: AppSelectSource;
+    options?: AppOption[];
+    queryParams?: Record<string, unknown>;
+    /** remote 默认 300ms */
+    debounceMs?: number;
+    /** 详情已经带回名称时用它省掉一次 resolve */
+    selectedOptions?: AppOption[];
+    /** 只读展示时的占位符 */
+    emptyText?: ReactNode;
+};
+type PrimitiveModeProps = {
+    valueMode?: 'primitive';
+    value?: SelectId | null;
+    onChange?: (value: SelectId | undefined, option?: AppOption) => void;
+};
+type ObjectModeProps = {
+    valueMode: 'object';
+    value?: LegacyValue | null;
+    onChange?: (value: LegacyValue | undefined, option?: AppOption) => void;
+};
+export type AppSelectProps = BaseProps & (PrimitiveModeProps | ObjectModeProps);
+export interface AppSelectDisplayProps {
+    source?: string;
+    dataSource?: AppSelectSource;
+    value?: SelectId | LegacyValue | null;
+    valueMode?: AppValueMode;
+    queryParams?: Record<string, unknown>;
+    selectedOptions?: AppOption[];
+    emptyText?: ReactNode;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/app-select/types.js

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

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

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

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

@@ -0,0 +1,30 @@
+import type { AppOption, SelectId } from './types.js';
+/** 键序稳定的序列化，避免同一个 queryParams 因对象字面量顺序不同而重复请求 */
+export declare function stableStringify(value: unknown): string;
+/**
+ * 空 ID 的统一口径：`undefined` / `null` / `''` 都视为未选择。
+ * 后端序列化空值常给空串，若只判 null 会多跑一次 resolve('')。
+ */
+export declare function isEmptyId(value: SelectId | null | undefined): boolean;
+/**
+ * 必需的查询参数是否齐备。
+ * 缺任何一个都不该发请求——用空条件解析，可能拿到别的租户/省份的记录。
+ */
+export declare function hasRequiredParams(required: string[] | undefined, params: Record<string, unknown> | undefined): boolean;
+/**
+ * 选项内容键：父组件每次渲染新建数组时，用它判断内容是否真的变了。
+ * 用内容而不是引用做依赖，才符合设计文档 §10 的要求。
+ */
+export declare function optionsContentKey(list?: AppOption[] | null): string;
+/** 解析缓存键：必须覆盖 source + value + queryParams，并可带权限命名空间 */
+export declare function buildResolveKey(parts: {
+    scope?: string;
+    sourceKey: string;
+    value: SelectId;
+    params?: Record<string, unknown>;
+}): string;
+/** 把 AntD Select 的选中项选项收敛成标准 AppOption */
+export declare function normalizeOption(option: unknown): AppOption | undefined;
+/** 已选项 + 候选合并去重，已选项优先，保证回显标签不被搜索结果覆盖 */
+export declare function mergeOptions(selected: AppOption | null, ...groups: (AppOption[] | undefined)[]): AppOption[];
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/app-select/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnD,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,MAAM,CAKnE;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,MAAM,CAET;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAUtE;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,GAAG,IAAI,EAC1B,GAAG,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,EAAE,GACrC,SAAS,EAAE,CASb"}

package/dist/app-select/utils.js

@@ -0,0 +1,76 @@
+/** 键序稳定的序列化，避免同一个 queryParams 因对象字面量顺序不同而重复请求 */
+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(',')}}`;
+}
+/**
+ * 空 ID 的统一口径：`undefined` / `null` / `''` 都视为未选择。
+ * 后端序列化空值常给空串，若只判 null 会多跑一次 resolve('')。
+ */
+export function isEmptyId(value) {
+    return value === undefined || value === null || value === '';
+}
+/**
+ * 必需的查询参数是否齐备。
+ * 缺任何一个都不该发请求——用空条件解析，可能拿到别的租户/省份的记录。
+ */
+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;
+    });
+}
+/**
+ * 选项内容键：父组件每次渲染新建数组时，用它判断内容是否真的变了。
+ * 用内容而不是引用做依赖，才符合设计文档 §10 的要求。
+ */
+export function optionsContentKey(list) {
+    if (!list || !list.length)
+        return '';
+    return stableStringify(list.map((item) => [typeof item.value, item.value, item.label, item.disabled ?? false]));
+}
+/** 解析缓存键：必须覆盖 source + value + queryParams，并可带权限命名空间 */
+export function buildResolveKey(parts) {
+    return [parts.scope ?? '', parts.sourceKey, typeof parts.value, String(parts.value), stableStringify(parts.params ?? null)].join('|');
+}
+/** 把 AntD Select 的选中项选项收敛成标准 AppOption */
+export function normalizeOption(option) {
+    if (!option || typeof option !== 'object')
+        return undefined;
+    const record = option;
+    if (record.value === undefined)
+        return undefined;
+    return {
+        value: record.value,
+        label: typeof record.label === 'string' ? record.label : String(record.label ?? record.value),
+        disabled: record.disabled,
+        raw: record.raw,
+    };
+}
+/** 已选项 + 候选合并去重，已选项优先，保证回显标签不被搜索结果覆盖 */
+export function mergeOptions(selected, ...groups) {
+    const map = new Map();
+    if (selected)
+        map.set(selected.value, selected);
+    for (const group of groups) {
+        for (const option of group ?? []) {
+            if (!map.has(option.value))
+                map.set(option.value, option);
+        }
+    }
+    return [...map.values()];
+}
+//# sourceMappingURL=utils.js.map

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

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

package/dist/editable-table/EditableTable.d.ts

@@ -0,0 +1,3 @@
+import type { EditableTableComponent } from './types.js';
+export declare const EditableTable: EditableTableComponent;
+//# sourceMappingURL=EditableTable.d.ts.map

package/dist/editable-table/EditableTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditableTable.d.ts","sourceRoot":"","sources":["../../src/editable-table/EditableTable.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAGV,sBAAsB,EAIvB,MAAM,SAAS,CAAC;AAgmBjB,eAAO,MAAM,aAAa,EAAgD,sBAAsB,CAAC"}