@robot-admin/naive-ui-components 0.22.0 → 0.23.0

package/dist/dateRange.d.cts

@@ -1,12 +1,31 @@
 import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.cjs";
+import { t as DictionaryBinding } from "./dictionary.cjs";
 import { t as ComponentDensity } from "./density.cjs";
 import * as vue from "vue";
-import { MaybeRefOrGetter, Ref } from "vue";
+import { MaybeRefOrGetter, Ref, VNodeChild } from "vue";
 import { FormInst, FormItemRule } from "naive-ui";
 
 //#region src/components/C_FormSearch/types.d.ts
 /** 搜索字段支持的控件类型 */
-type SearchFieldType = 'input' | 'select' | 'date-range' | 'spacer';
+type SearchFieldType = 'input' | 'select' | 'number' | 'number-range' | 'date' | 'month' | 'date-range' | 'custom' | 'spacer';
+/** 允许只输入一端；空控件仍发布 null。 */
+type SearchNumberRangeValue = [number | null, number | null] | null;
+/** 显式调用 serializeSearch 时才应用，组件不会悄悄改变 onSearch 的业务模型。 */
+interface SearchQueryEncoding {
+  name?: string;
+  keys?: readonly [string, string];
+  serialize?: (value: unknown) => unknown;
+}
+/** 自定义字段与具名插槽共用同一受控边界；updateValue 尊重 fixed/readonly/disabled。 */
+interface SearchFieldContext<T extends object = SearchFormParams> {
+  value: unknown;
+  model: Readonly<T>;
+  prop: Extract<keyof T, string>;
+  disabled: boolean;
+  readonly: boolean;
+  size: 'small' | 'medium' | 'large';
+  updateValue: (value: unknown) => void;
+}
 type SearchOptionValue = string | number | boolean;
 interface SearchOptionItem<V extends SearchOptionValue = SearchOptionValue> {
   labelDefault?: string;
@@ -19,6 +38,19 @@ interface SearchOptionItem<V extends SearchOptionValue = SearchOptionValue> {
 interface SearchFormItemBase {
   type: SearchFieldType;
   prop: string;
+  label?: string;
+  span?: number;
+  minWidth?: number;
+  /** 固定条件继续参与查询，但不允许控件修改或 reset 清除。 */
+  fixed?: boolean;
+  disabled?: boolean;
+  readonly?: boolean;
+  dictionary?: DictionaryBinding;
+  /** 日期初值为 null 时显式声明格式化模型，避免清空后切换模型类型。 */
+  valueMode?: 'timestamp' | 'formatted';
+  query?: SearchQueryEncoding;
+  slot?: string;
+  render?: (context: SearchFieldContext) => VNodeChild;
   placeholder?: string;
   list?: SearchOptionItem[];
   hisList?: string[];
@@ -32,16 +64,54 @@ type FieldOptions<V> = Array<Omit<SearchOptionItem, 'value'> & {
   value: Extract<V, SearchOptionValue>;
 }>;
 type FieldAttributes = Record<string, unknown>;
+type TypedSingleDate<V> = null extends V ? number extends V ? string extends V ? {
+  type: 'date' | 'month';
+  valueMode?: 'timestamp' | 'formatted';
+} : {
+  type: 'date' | 'month';
+  valueMode?: 'timestamp';
+} : string extends V ? {
+  type: 'date' | 'month';
+  valueMode: 'formatted';
+} : never : never;
+type TypedDateRange<V> = null extends V ? [number, number] extends V ? [string, string] extends V ? {
+  type: 'date-range';
+  valueMode?: 'timestamp' | 'formatted';
+} : {
+  type: 'date-range';
+  valueMode?: 'timestamp';
+} : [string, string] extends V ? {
+  type: 'date-range';
+  valueMode: 'formatted';
+} : never : never;
 type TypedSearchControl<V> = {
   type: 'spacer';
   list?: never;
 } | (string extends V ? {
   type: 'input';
   list?: never;
-} : never) | (null extends V ? [number, number] extends V ? {
-  type: 'date-range';
+} : never) | (number extends V ? null extends V ? {
+  type: 'number';
+  list?: never;
+} : {
+  type: 'number';
+  attrs: FieldAttributes & {
+    clearable: false;
+  };
+  defaultValue: V;
+  list?: never;
+} : never) | (null extends V ? SearchNumberRangeValue extends V ? {
+  type: 'number-range';
+  list?: never;
+} : never : never) | (TypedSingleDate<V> & {
+  list?: never;
+}) | (TypedDateRange<V> & {
+  list?: never;
+}) | {
+  type: 'custom';
+  defaultValue: V;
   list?: never;
-} : never : never) | (NonNullable<V> extends readonly (infer Item)[] ? [] extends NonNullable<V> ? {
+} | (NonNullable<V> extends readonly (infer Item)[] ? [] extends NonNullable<V> ? {
   type: 'select';
   attrs: FieldAttributes & {
     multiple: true;
@@ -68,9 +138,10 @@ type TypedSearchControl<V> = {
  */
 type SearchFormItem<T extends object = SearchFormParams> = {
   prop: Extract<keyof T, string>;
-} & (string extends keyof T ? SearchFormItemBase : { [P in Extract<keyof T, string>]: Omit<SearchFormItemBase, 'type' | 'prop' | 'defaultValue' | 'list'> & {
+} & (string extends keyof T ? SearchFormItemBase : { [P in Extract<keyof T, string>]: Omit<SearchFormItemBase, 'type' | 'prop' | 'defaultValue' | 'list' | 'render'> & {
   prop: P;
   defaultValue?: T[P];
+  render?: (context: SearchFieldContext<T>) => VNodeChild;
 } & TypedSearchControl<T[P]> }[Extract<keyof T, string>]);
 interface SearchFormParams {
   pageNum?: number;
@@ -80,6 +151,12 @@ interface SearchFormParams {
 interface SearchConfig<T extends object = SearchFormParams> {
   /** 与 C_Form、C_Table 统一的布局密度，显式 size 和字段 attrs.size 优先。 */
   density?: ComponentDensity;
+  /** inline 保持原有接入；grid 按实际容器宽度重排，columns 为最大列数。 */
+  layout?: 'inline' | 'grid';
+  columns?: number;
+  fieldMinWidth?: number;
+  labelPlacement?: 'left' | 'top';
+  labelWidth?: number | string | 'auto';
   foldThreshold?: number;
   historyMaxItems?: number;
   requireValue?: boolean;
@@ -114,24 +191,37 @@ interface FormSearchEmits<T extends object = SearchFormParams> {
   reset: [params: T];
   'change-params': [params: T];
   'update:modelValue': [params: T];
+  applied: [params: T];
 }
 /** 公开实例的顶层 Ref 已由 Vue 解包。 */
 interface FormSearchExpose<T extends object = SearchFormParams> {
   formRef: FormInst | null;
   formParams: T;
+  /** 仅成功的 onSearch 更新；没有执行时为 null，重置草稿不伪造查询成功。 */
+  appliedParams: T | null;
+  hasUnappliedChanges: boolean;
+  hiddenActiveCount: number;
   searchFn: () => Promise<boolean>;
   cleanFn: () => void;
+  /** 应用常用条件，不改固定/隐藏/只读字段，不自动查询或更新成功快照。 */
+  applyPreset: (values: Partial<T>) => boolean;
   changeFoldState: () => void;
 }
 //#endregion
+//#region src/components/C_FormSearch/serializeSearch.d.ts
+interface SerializeSearchOptions {
+  /** 仅清理查询载荷，不影响草稿；0/false/前导零均保留。默认 true。 */
+  omitEmpty?: boolean;
+}
+/** 显式将搜索模型编码为请求载荷；onSearch/事件始终保留原始 T，不隐式调用此函数。 */
+declare function serializeSearch<T extends object = SearchFormParams>(params: T, fields: readonly SearchFormItem<T>[], options?: SerializeSearchOptions): Record<string, unknown>;
+//#endregion
 //#region src/components/C_FormSearch/composables/useSearchHistory.d.ts
 interface SearchHistoryOptions {
   storageKey?: string;
   maxItems?: number;
 }
-/**
- *
- */
+/** 按控件保存有限条文本历史；固定与只读条件不能由历史选择绕过防写边界。 */
 declare function useSearchHistory<T extends object = SearchFormParams>(fields: Ref<SearchFormItem<T>[]>, formParams: Ref<T>, options?: MaybeRefOrGetter<SearchHistoryOptions>): {
   enabled: vue.ComputedRef<boolean>;
   handleFocus: (prop: string) => void;
@@ -150,10 +240,9 @@ interface UseSearchStateOptions<T extends object = SearchFormParams> {
   config?: MaybeRefOrGetter<SearchConfig<T> | undefined>;
   loading?: MaybeRefOrGetter<boolean>;
   historyOptions?: MaybeRefOrGetter<SearchHistoryOptions>;
+  onApplied?: (params: T) => void;
 }
-/**
- *
- */
+/** 搜索草稿、校验锁与成功快照；字段元数据同步不回滚输入，作用域失效不接受迟到结果。 */
 declare function useSearchState<T extends object = SearchFormParams>(emits: {
   (event: 'search', params: T): void;
   (event: 'reset', params: T): void;
@@ -163,6 +252,9 @@ declare function useSearchState<T extends object = SearchFormParams>(emits: {
   formRef: Ref<FormInst | null, FormInst | null>;
   fields: Ref<SearchFormItem<T>[], SearchFormItem<T>[]>;
   formParams: Ref<T, T>;
+  appliedParams: Ref<T | null, T | null>;
+  hasUnappliedChanges: vue.ComputedRef<boolean>;
+  hiddenActiveCount: vue.ComputedRef<number>;
   expanded: Ref<boolean, boolean>;
   searching: vue.ComputedRef<boolean>;
   visibleFields: vue.ComputedRef<SearchFormItem<T>[]>;
@@ -181,8 +273,11 @@ declare function useSearchState<T extends object = SearchFormParams>(emits: {
   };
   searchFn: () => Promise<boolean>;
   resetFn: () => void;
+  applyPreset: (values: Partial<T>) => boolean;
   toggleFold: () => void;
   syncFromProps: (newItems: SearchFormItem<T>[], newParams: T) => void;
+  syncFields: (newItems: SearchFormItem<T>[]) => void;
+  syncModel: (newParams: T) => void;
 };
 //#endregion
 //#region src/components/C_FormSearch/dateRange.d.ts
@@ -196,4 +291,4 @@ type DateRangeInput = {
 /** 搜索日期范围模型，同时支持时间戳和显式格式化日期。 */
 type SearchDateRangeValue = DateRangeInput['value'];
 //#endregion
-export { FormSearchEmits as a, SearchConfig as c, SearchFormParams as d, SearchOptionItem as f, useSearchHistory as i, SearchFieldType as l, SearchDateRangeValue as n, FormSearchExpose as o, useSearchState as r, FormSearchProps as s, DateRangeInput as t, SearchFormItem as u };
+export { SearchQueryEncoding as _, SerializeSearchOptions as a, FormSearchExpose as c, SearchFieldContext as d, SearchFieldType as f, SearchOptionItem as g, SearchNumberRangeValue as h, useSearchHistory as i, FormSearchProps as l, SearchFormParams as m, SearchDateRangeValue as n, serializeSearch as o, SearchFormItem as p, useSearchState as r, FormSearchEmits as s, DateRangeInput as t, SearchConfig as u };

package/dist/dateRange.d.ts

@@ -1,12 +1,31 @@
 import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.js";
+import { t as DictionaryBinding } from "./dictionary.js";
 import { t as ComponentDensity } from "./density.js";
 import * as vue from "vue";
-import { MaybeRefOrGetter, Ref } from "vue";
+import { MaybeRefOrGetter, Ref, VNodeChild } from "vue";
 import { FormInst, FormItemRule } from "naive-ui";
 
 //#region src/components/C_FormSearch/types.d.ts
 /** 搜索字段支持的控件类型 */
-type SearchFieldType = 'input' | 'select' | 'date-range' | 'spacer';
+type SearchFieldType = 'input' | 'select' | 'number' | 'number-range' | 'date' | 'month' | 'date-range' | 'custom' | 'spacer';
+/** 允许只输入一端；空控件仍发布 null。 */
+type SearchNumberRangeValue = [number | null, number | null] | null;
+/** 显式调用 serializeSearch 时才应用，组件不会悄悄改变 onSearch 的业务模型。 */
+interface SearchQueryEncoding {
+  name?: string;
+  keys?: readonly [string, string];
+  serialize?: (value: unknown) => unknown;
+}
+/** 自定义字段与具名插槽共用同一受控边界；updateValue 尊重 fixed/readonly/disabled。 */
+interface SearchFieldContext<T extends object = SearchFormParams> {
+  value: unknown;
+  model: Readonly<T>;
+  prop: Extract<keyof T, string>;
+  disabled: boolean;
+  readonly: boolean;
+  size: 'small' | 'medium' | 'large';
+  updateValue: (value: unknown) => void;
+}
 type SearchOptionValue = string | number | boolean;
 interface SearchOptionItem<V extends SearchOptionValue = SearchOptionValue> {
   labelDefault?: string;
@@ -19,6 +38,19 @@ interface SearchOptionItem<V extends SearchOptionValue = SearchOptionValue> {
 interface SearchFormItemBase {
   type: SearchFieldType;
   prop: string;
+  label?: string;
+  span?: number;
+  minWidth?: number;
+  /** 固定条件继续参与查询，但不允许控件修改或 reset 清除。 */
+  fixed?: boolean;
+  disabled?: boolean;
+  readonly?: boolean;
+  dictionary?: DictionaryBinding;
+  /** 日期初值为 null 时显式声明格式化模型，避免清空后切换模型类型。 */
+  valueMode?: 'timestamp' | 'formatted';
+  query?: SearchQueryEncoding;
+  slot?: string;
+  render?: (context: SearchFieldContext) => VNodeChild;
   placeholder?: string;
   list?: SearchOptionItem[];
   hisList?: string[];
@@ -32,16 +64,54 @@ type FieldOptions<V> = Array<Omit<SearchOptionItem, 'value'> & {
   value: Extract<V, SearchOptionValue>;
 }>;
 type FieldAttributes = Record<string, unknown>;
+type TypedSingleDate<V> = null extends V ? number extends V ? string extends V ? {
+  type: 'date' | 'month';
+  valueMode?: 'timestamp' | 'formatted';
+} : {
+  type: 'date' | 'month';
+  valueMode?: 'timestamp';
+} : string extends V ? {
+  type: 'date' | 'month';
+  valueMode: 'formatted';
+} : never : never;
+type TypedDateRange<V> = null extends V ? [number, number] extends V ? [string, string] extends V ? {
+  type: 'date-range';
+  valueMode?: 'timestamp' | 'formatted';
+} : {
+  type: 'date-range';
+  valueMode?: 'timestamp';
+} : [string, string] extends V ? {
+  type: 'date-range';
+  valueMode: 'formatted';
+} : never : never;
 type TypedSearchControl<V> = {
   type: 'spacer';
   list?: never;
 } | (string extends V ? {
   type: 'input';
   list?: never;
-} : never) | (null extends V ? [number, number] extends V ? {
-  type: 'date-range';
+} : never) | (number extends V ? null extends V ? {
+  type: 'number';
+  list?: never;
+} : {
+  type: 'number';
+  attrs: FieldAttributes & {
+    clearable: false;
+  };
+  defaultValue: V;
+  list?: never;
+} : never) | (null extends V ? SearchNumberRangeValue extends V ? {
+  type: 'number-range';
+  list?: never;
+} : never : never) | (TypedSingleDate<V> & {
+  list?: never;
+}) | (TypedDateRange<V> & {
+  list?: never;
+}) | {
+  type: 'custom';
+  defaultValue: V;
   list?: never;
-} : never : never) | (NonNullable<V> extends readonly (infer Item)[] ? [] extends NonNullable<V> ? {
+} | (NonNullable<V> extends readonly (infer Item)[] ? [] extends NonNullable<V> ? {
   type: 'select';
   attrs: FieldAttributes & {
     multiple: true;
@@ -68,9 +138,10 @@ type TypedSearchControl<V> = {
  */
 type SearchFormItem<T extends object = SearchFormParams> = {
   prop: Extract<keyof T, string>;
-} & (string extends keyof T ? SearchFormItemBase : { [P in Extract<keyof T, string>]: Omit<SearchFormItemBase, 'type' | 'prop' | 'defaultValue' | 'list'> & {
+} & (string extends keyof T ? SearchFormItemBase : { [P in Extract<keyof T, string>]: Omit<SearchFormItemBase, 'type' | 'prop' | 'defaultValue' | 'list' | 'render'> & {
   prop: P;
   defaultValue?: T[P];
+  render?: (context: SearchFieldContext<T>) => VNodeChild;
 } & TypedSearchControl<T[P]> }[Extract<keyof T, string>]);
 interface SearchFormParams {
   pageNum?: number;
@@ -80,6 +151,12 @@ interface SearchFormParams {
 interface SearchConfig<T extends object = SearchFormParams> {
   /** 与 C_Form、C_Table 统一的布局密度，显式 size 和字段 attrs.size 优先。 */
   density?: ComponentDensity;
+  /** inline 保持原有接入；grid 按实际容器宽度重排，columns 为最大列数。 */
+  layout?: 'inline' | 'grid';
+  columns?: number;
+  fieldMinWidth?: number;
+  labelPlacement?: 'left' | 'top';
+  labelWidth?: number | string | 'auto';
   foldThreshold?: number;
   historyMaxItems?: number;
   requireValue?: boolean;
@@ -114,24 +191,37 @@ interface FormSearchEmits<T extends object = SearchFormParams> {
   reset: [params: T];
   'change-params': [params: T];
   'update:modelValue': [params: T];
+  applied: [params: T];
 }
 /** 公开实例的顶层 Ref 已由 Vue 解包。 */
 interface FormSearchExpose<T extends object = SearchFormParams> {
   formRef: FormInst | null;
   formParams: T;
+  /** 仅成功的 onSearch 更新；没有执行时为 null，重置草稿不伪造查询成功。 */
+  appliedParams: T | null;
+  hasUnappliedChanges: boolean;
+  hiddenActiveCount: number;
   searchFn: () => Promise<boolean>;
   cleanFn: () => void;
+  /** 应用常用条件，不改固定/隐藏/只读字段，不自动查询或更新成功快照。 */
+  applyPreset: (values: Partial<T>) => boolean;
   changeFoldState: () => void;
 }
 //#endregion
+//#region src/components/C_FormSearch/serializeSearch.d.ts
+interface SerializeSearchOptions {
+  /** 仅清理查询载荷，不影响草稿；0/false/前导零均保留。默认 true。 */
+  omitEmpty?: boolean;
+}
+/** 显式将搜索模型编码为请求载荷；onSearch/事件始终保留原始 T，不隐式调用此函数。 */
+declare function serializeSearch<T extends object = SearchFormParams>(params: T, fields: readonly SearchFormItem<T>[], options?: SerializeSearchOptions): Record<string, unknown>;
+//#endregion
 //#region src/components/C_FormSearch/composables/useSearchHistory.d.ts
 interface SearchHistoryOptions {
   storageKey?: string;
   maxItems?: number;
 }
-/**
- *
- */
+/** 按控件保存有限条文本历史；固定与只读条件不能由历史选择绕过防写边界。 */
 declare function useSearchHistory<T extends object = SearchFormParams>(fields: Ref<SearchFormItem<T>[]>, formParams: Ref<T>, options?: MaybeRefOrGetter<SearchHistoryOptions>): {
   enabled: vue.ComputedRef<boolean>;
   handleFocus: (prop: string) => void;
@@ -150,10 +240,9 @@ interface UseSearchStateOptions<T extends object = SearchFormParams> {
   config?: MaybeRefOrGetter<SearchConfig<T> | undefined>;
   loading?: MaybeRefOrGetter<boolean>;
   historyOptions?: MaybeRefOrGetter<SearchHistoryOptions>;
+  onApplied?: (params: T) => void;
 }
-/**
- *
- */
+/** 搜索草稿、校验锁与成功快照；字段元数据同步不回滚输入，作用域失效不接受迟到结果。 */
 declare function useSearchState<T extends object = SearchFormParams>(emits: {
   (event: 'search', params: T): void;
   (event: 'reset', params: T): void;
@@ -163,6 +252,9 @@ declare function useSearchState<T extends object = SearchFormParams>(emits: {
   formRef: Ref<FormInst | null, FormInst | null>;
   fields: Ref<SearchFormItem<T>[], SearchFormItem<T>[]>;
   formParams: Ref<T, T>;
+  appliedParams: Ref<T | null, T | null>;
+  hasUnappliedChanges: vue.ComputedRef<boolean>;
+  hiddenActiveCount: vue.ComputedRef<number>;
   expanded: Ref<boolean, boolean>;
   searching: vue.ComputedRef<boolean>;
   visibleFields: vue.ComputedRef<SearchFormItem<T>[]>;
@@ -181,8 +273,11 @@ declare function useSearchState<T extends object = SearchFormParams>(emits: {
   };
   searchFn: () => Promise<boolean>;
   resetFn: () => void;
+  applyPreset: (values: Partial<T>) => boolean;
   toggleFold: () => void;
   syncFromProps: (newItems: SearchFormItem<T>[], newParams: T) => void;
+  syncFields: (newItems: SearchFormItem<T>[]) => void;
+  syncModel: (newParams: T) => void;
 };
 //#endregion
 //#region src/components/C_FormSearch/dateRange.d.ts
@@ -196,4 +291,4 @@ type DateRangeInput = {
 /** 搜索日期范围模型，同时支持时间戳和显式格式化日期。 */
 type SearchDateRangeValue = DateRangeInput['value'];
 //#endregion
-export { FormSearchEmits as a, SearchConfig as c, SearchFormParams as d, SearchOptionItem as f, useSearchHistory as i, SearchFieldType as l, SearchDateRangeValue as n, FormSearchExpose as o, useSearchState as r, FormSearchProps as s, DateRangeInput as t, SearchFormItem as u };
+export { SearchQueryEncoding as _, SerializeSearchOptions as a, FormSearchExpose as c, SearchFieldContext as d, SearchFieldType as f, SearchOptionItem as g, SearchNumberRangeValue as h, useSearchHistory as i, FormSearchProps as l, SearchFormParams as m, SearchDateRangeValue as n, serializeSearch as o, SearchFormItem as p, useSearchState as r, FormSearchEmits as s, DateRangeInput as t, SearchConfig as u };

package/dist/density.cjs

@@ -1 +1 @@
-const e={default:{density:`default`,size:`medium`,gap:16,rowGap:16,padding:24,formItemGap:24},compact:{density:`compact`,size:`small`,gap:8,rowGap:8,padding:12,formItemGap:12},comfortable:{density:`comfortable`,size:`large`,gap:20,rowGap:20,padding:28,formItemGap:28}},t=t=>({...e[t&&Object.prototype.hasOwnProperty.call(e,t)?t:`default`]});Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+const e={default:{density:`default`,size:`medium`,gap:16,rowGap:16,padding:24,formItemGap:24},compact:{density:`compact`,size:`small`,gap:8,rowGap:8,padding:12,formItemGap:4},comfortable:{density:`comfortable`,size:`large`,gap:20,rowGap:20,padding:28,formItemGap:28}},t=t=>({...e[t&&Object.prototype.hasOwnProperty.call(e,t)?t:`default`]});Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});

package/dist/density.js

@@ -1 +1 @@
-const e={default:{density:`default`,size:`medium`,gap:16,rowGap:16,padding:24,formItemGap:24},compact:{density:`compact`,size:`small`,gap:8,rowGap:8,padding:12,formItemGap:12},comfortable:{density:`comfortable`,size:`large`,gap:20,rowGap:20,padding:28,formItemGap:28}},t=t=>({...e[t&&Object.prototype.hasOwnProperty.call(e,t)?t:`default`]});export{t};
+const e={default:{density:`default`,size:`medium`,gap:16,rowGap:16,padding:24,formItemGap:24},compact:{density:`compact`,size:`small`,gap:8,rowGap:8,padding:12,formItemGap:4},comfortable:{density:`comfortable`,size:`large`,gap:20,rowGap:20,padding:28,formItemGap:28}},t=t=>({...e[t&&Object.prototype.hasOwnProperty.call(e,t)?t:`default`]});export{t};

package/dist/dictionary.cjs

@@ -0,0 +1 @@
+function e(e){let t=new Map;for(let n of e)t.has(n.value)||t.set(n.value,n.label);return e=>t.get(e)??String(e??``)}function t(e,t){return t.find(t=>Object.is(t.value,e))?.label??String(e??``)}function n(e,t){let n=t.find(t=>Object.is(t.value,e));if(n)return{ok:!0,value:n.value};if(typeof e!=`string`)return{ok:!1,reason:`unknown`,input:e};let r=t.filter(t=>String(t.value)===e),i=r.length?r:t.filter(t=>t.label===e);return i.length===1?{ok:!0,value:i[0].value}:{ok:!1,reason:i.length?`ambiguous`:`unknown`,input:e}}function r(e){return Array.isArray(e)?e.map(r):typeof e==`string`||typeof e==`number`||typeof e==`boolean`?JSON.stringify([typeof e,e]):e}function i(e){if(Array.isArray(e))return e.map(i);if(typeof e!=`string`)return e;try{let t=JSON.parse(e);if(Array.isArray(t)&&t.length===2&&[`string`,`number`,`boolean`].includes(t[0])&&typeof t[1]===t[0])return t[1]}catch{}return e}function a(e){return e.map(e=>({...e,value:r(e.value)}))}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return e}});

package/dist/dictionary.d.cts

@@ -0,0 +1,38 @@
+//#region src/core/dictionary.d.ts
+/**
+ * 字典值协议与纯转换工具。数据缓存、请求与租户隔离由应用 Provider 负责。
+ * 此模块不依赖 Vue、UI、DOM 或任何表格实现，可用于导入、导出和适配层。
+ */
+type DictionaryValue = string | number | boolean;
+interface DictionaryOption {
+  value: DictionaryValue;
+  label: string;
+  disabled?: boolean;
+}
+interface DictionarySource {
+  getOptions(): readonly DictionaryOption[];
+  load?(context: {
+    signal: AbortSignal;
+  }): Promise<readonly DictionaryOption[]>;
+  subscribe?(listener: () => void): () => void;
+}
+interface DictionaryProvider {
+  getDictionary(name: string): DictionarySource | undefined;
+}
+type DictionaryBinding = string | DictionarySource;
+type DictionaryParseResult = {
+  ok: true;
+  value: DictionaryValue;
+} | {
+  ok: false;
+  reason: 'unknown' | 'ambiguous';
+  input: unknown;
+};
+/** 每份选项快照只建一次索引，表格单元格解析不重复遍历整份字典。 */
+declare function createDictionaryLabelResolver(options: readonly DictionaryOption[]): (value: unknown) => string;
+/** 原值比较保留 boolean、数值和带前导零的字符串编码，不回写展示标签。 */
+declare function getDictionaryLabel(value: unknown, options: readonly DictionaryOption[]): string;
+/** 原码优先于标签；多义标签或字符串化编码必须交由使用侧明确处理。 */
+declare function parseDictionaryValue(input: unknown, options: readonly DictionaryOption[]): DictionaryParseResult;
+//#endregion
+export { DictionarySource as a, getDictionaryLabel as c, DictionaryProvider as i, parseDictionaryValue as l, DictionaryOption as n, DictionaryValue as o, DictionaryParseResult as r, createDictionaryLabelResolver as s, DictionaryBinding as t };

package/dist/dictionary.d.ts

@@ -0,0 +1,38 @@
+//#region src/core/dictionary.d.ts
+/**
+ * 字典值协议与纯转换工具。数据缓存、请求与租户隔离由应用 Provider 负责。
+ * 此模块不依赖 Vue、UI、DOM 或任何表格实现，可用于导入、导出和适配层。
+ */
+type DictionaryValue = string | number | boolean;
+interface DictionaryOption {
+  value: DictionaryValue;
+  label: string;
+  disabled?: boolean;
+}
+interface DictionarySource {
+  getOptions(): readonly DictionaryOption[];
+  load?(context: {
+    signal: AbortSignal;
+  }): Promise<readonly DictionaryOption[]>;
+  subscribe?(listener: () => void): () => void;
+}
+interface DictionaryProvider {
+  getDictionary(name: string): DictionarySource | undefined;
+}
+type DictionaryBinding = string | DictionarySource;
+type DictionaryParseResult = {
+  ok: true;
+  value: DictionaryValue;
+} | {
+  ok: false;
+  reason: 'unknown' | 'ambiguous';
+  input: unknown;
+};
+/** 每份选项快照只建一次索引，表格单元格解析不重复遍历整份字典。 */
+declare function createDictionaryLabelResolver(options: readonly DictionaryOption[]): (value: unknown) => string;
+/** 原值比较保留 boolean、数值和带前导零的字符串编码，不回写展示标签。 */
+declare function getDictionaryLabel(value: unknown, options: readonly DictionaryOption[]): string;
+/** 原码优先于标签；多义标签或字符串化编码必须交由使用侧明确处理。 */
+declare function parseDictionaryValue(input: unknown, options: readonly DictionaryOption[]): DictionaryParseResult;
+//#endregion
+export { DictionarySource as a, getDictionaryLabel as c, DictionaryProvider as i, parseDictionaryValue as l, DictionaryOption as n, DictionaryValue as o, DictionaryParseResult as r, createDictionaryLabelResolver as s, DictionaryBinding as t };

package/dist/dictionary.js

@@ -0,0 +1 @@
+function e(e){let t=new Map;for(let n of e)t.has(n.value)||t.set(n.value,n.label);return e=>t.get(e)??String(e??``)}function t(e,t){return t.find(t=>Object.is(t.value,e))?.label??String(e??``)}function n(e,t){let n=t.find(t=>Object.is(t.value,e));if(n)return{ok:!0,value:n.value};if(typeof e!=`string`)return{ok:!1,reason:`unknown`,input:e};let r=t.filter(t=>String(t.value)===e),i=r.length?r:t.filter(t=>t.label===e);return i.length===1?{ok:!0,value:i[0].value}:{ok:!1,reason:i.length?`ambiguous`:`unknown`,input:e}}function r(e){return Array.isArray(e)?e.map(r):typeof e==`string`||typeof e==`number`||typeof e==`boolean`?JSON.stringify([typeof e,e]):e}function i(e){if(Array.isArray(e))return e.map(i);if(typeof e!=`string`)return e;try{let t=JSON.parse(e);if(Array.isArray(t)&&t.length===2&&[`string`,`number`,`boolean`].includes(t[0])&&typeof t[1]===t[0])return t[1]}catch{}return e}function a(e){return e.map(e=>({...e,value:r(e.value)}))}export{n as a,t as i,i as n,a as o,r,e as t};