@robot-admin/naive-ui-components 0.24.6 → 0.25.0

package/dist/useDynamicFormState.d.ts

@@ -38,6 +38,8 @@ interface UseFormRendererOptions {
   asyncLoadingMap: Ref<Record<string, boolean>>;
   getDictionaryOptions?: (field: string) => readonly DictionaryOption[];
   isDictionaryLoading?: (field: string) => boolean;
+  getOptionsError?: (field: string) => unknown;
+  reloadOptions?: (field: string) => Promise<void>;
   renderers?: ComputedRef<Record<string, FormRenderer> | undefined>;
   /** Overrides application injection. An isolated registry never reads legacy globals. */
   registry?: FormRendererRegistry;
@@ -79,10 +81,10 @@ declare const __VLS_export$3: <T extends object = FormRecord>(__VLS_props: NonNu
     config?: FormConfig<T>; /** 当前表单实例的自定义渲染器，不污染全局注册表 */
     renderers?: Record<string, FormRenderer>;
   } & {
-    "onUpdate:modelValue"?: ((model: T) => any) | undefined;
     onSubmit?: ((payload: SubmitEventPayload<T>) => any) | undefined;
-    "onValidate-success"?: ((model: T) => any) | undefined;
+    "onUpdate:modelValue"?: ((model: T) => any) | undefined;
     "onValidate-error"?: ((errors: unknown) => any) | undefined;
+    "onValidate-success"?: ((model: T) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -112,13 +114,14 @@ declare const __VLS_export$3: <T extends object = FormRecord>(__VLS_props: NonNu
     markAsClean: () => void;
     asyncLoadingMap: Ref<Record<string, boolean>, Record<string, boolean>>;
     asyncErrorMap: Ref<Record<string, unknown>, Record<string, unknown>>;
+    getDictionaryError: (key: string) => unknown;
     reloadOptions: (field?: string) => Promise<void>;
     isSubmitting: Ref<boolean, boolean>;
     submit: () => Promise<boolean>;
   }>) => void;
   attrs: any;
   slots: FormSlots<T>;
-  emit: ((evt: "update:modelValue", model: T) => void) & ((evt: "submit", payload: SubmitEventPayload<T>) => void) & ((evt: "validate-success", model: T) => void) & ((evt: "validate-error", errors: unknown) => void);
+  emit: ((evt: "submit", payload: SubmitEventPayload<T>) => void) & ((evt: "update:modelValue", model: T) => void) & ((evt: "validate-error", errors: unknown) => void) & ((evt: "validate-success", model: T) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -189,8 +192,8 @@ declare function setupHighlight(app: App, options?: HighlightPluginOptions): Hig
 //#region src/components/C_Table/index.vue.d.ts
 declare const __VLS_export$2: <T extends object = DataRecord, C = unknown>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$2<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: vue.PublicProps & __VLS_PrettifyLocal$2<TableRuntimeProps<T, C> & {
-    onCancel?: ((rowData: T, rowIndex: number) => any) | undefined;
     onSave?: ((rowData: T, rowIndex: number, columnKey?: string | undefined) => any) | undefined;
+    onCancel?: ((rowData: T, rowIndex: number) => any) | undefined;
     "onPagination-change"?: ((page: number, pageSize: number) => any) | undefined;
     "onRow-delete"?: ((deletedRow: T, index: number) => any) | undefined;
     "onBatch-action-error"?: ((error: unknown, actionKey: string) => any) | undefined;
@@ -225,7 +228,7 @@ declare const __VLS_export$2: <T extends object = DataRecord, C = unknown>(__VLS
   } & {
     empty?: (props: {}) => any;
   };
-  emit: ((evt: "cancel", rowData: T, rowIndex: number) => void) & ((evt: "save", rowData: T, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "pagination-change", page: number, pageSize: number) => void) & ((evt: "row-delete", deletedRow: T, index: number) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<T>[]) => void) & ((evt: "row-add", newRow: T) => void) & ((evt: "row-copy", originalRow: T, newRow: T) => void) & ((evt: "row-move", row: T, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: T | null) => void) & ((evt: "view-detail", data: T) => void) & ((evt: "column-change", columns: TableColumn<T>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: T | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: T[]) => void) & ((evt: "edit-error", error: unknown) => void);
+  emit: ((evt: "save", rowData: T, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "cancel", rowData: T, rowIndex: number) => void) & ((evt: "pagination-change", page: number, pageSize: number) => void) & ((evt: "row-delete", deletedRow: T, index: number) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<T>[]) => void) & ((evt: "row-add", newRow: T) => void) & ((evt: "row-copy", originalRow: T, newRow: T) => void) & ((evt: "row-move", row: T, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: T | null) => void) & ((evt: "view-detail", data: T) => void) & ((evt: "column-change", columns: TableColumn<T>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: T | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: T[]) => void) & ((evt: "edit-error", error: unknown) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -302,6 +305,11 @@ interface UseTableColumnsReturn {
   computedColumns: ComputedRef<DataTableColumn[]>;
   computedScrollX: ComputedRef<number | string | undefined>;
   getDictionaryLabel: (column: TableColumn, value: unknown) => string;
+  dictionaryStatus: ComputedRef<{
+    failed: number;
+    loading: number;
+  }>;
+  retryDictionaries: () => Promise<void>;
   handleColumnChange: (columns: TableColumn[]) => void;
 }
 /**
@@ -957,15 +965,15 @@ interface TreeSlots<T extends object = TreeOption$1> {
 declare const __VLS_export$1: <T extends object = TreeNodeData>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$1<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: vue.PublicProps & __VLS_PrettifyLocal$1<TreeProps$1<T> & {
     onAdd?: ((parentNode?: T | undefined) => any) | undefined;
+    "onLoad-error"?: ((error: unknown, node: T) => any) | undefined;
+    "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "expand" | "collapse" | "select" | "unselect" | "check" | "uncheck">) => any) | undefined;
+    onRefresh?: (() => any) | undefined;
     "onUpdate:searchPattern"?: ((pattern: string) => any) | undefined;
-    "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "unselect" | "collapse" | "check" | "uncheck">) => any) | undefined;
-    "onUpdate:selectedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "unselect" | "collapse" | "check" | "uncheck">) => any) | undefined;
-    "onUpdate:checkedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "unselect" | "collapse" | "check" | "uncheck">) => any) | undefined;
+    "onUpdate:selectedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "expand" | "collapse" | "select" | "unselect" | "check" | "uncheck">) => any) | undefined;
+    "onUpdate:checkedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "expand" | "collapse" | "select" | "unselect" | "check" | "uncheck">) => any) | undefined;
     "onNode-select"?: ((node: T | null, selectedKeys: TreeKey[]) => any) | undefined;
     "onNode-action"?: ((action: string, node: T) => any) | undefined;
     "onNode-drop"?: ((info: DropInfo<T>) => any) | undefined;
-    "onLoad-error"?: ((error: unknown, node: T) => any) | undefined;
-    onRefresh?: (() => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -976,7 +984,7 @@ declare const __VLS_export$1: <T extends object = TreeNodeData>(__VLS_props: Non
   }>) => void;
   attrs: any;
   slots: TreeSlots<T>;
-  emit: ((evt: "add", parentNode?: T | undefined) => void) & ((evt: "update:searchPattern", pattern: string) => void) & ((evt: "update:expandedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "unselect" | "collapse" | "check" | "uncheck">) => void) & ((evt: "update:selectedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "unselect" | "collapse" | "check" | "uncheck">) => void) & ((evt: "update:checkedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "unselect" | "collapse" | "check" | "uncheck">) => void) & ((evt: "node-select", node: T | null, selectedKeys: TreeKey[]) => void) & ((evt: "node-action", action: string, node: T) => void) & ((evt: "node-drop", info: DropInfo<T>) => void) & ((evt: "load-error", error: unknown, node: T) => void) & ((evt: "refresh") => void);
+  emit: ((evt: "add", parentNode?: T | undefined) => void) & ((evt: "load-error", error: unknown, node: T) => void) & ((evt: "update:expandedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "expand" | "collapse" | "select" | "unselect" | "check" | "uncheck">) => void) & ((evt: "refresh") => void) & ((evt: "update:searchPattern", pattern: string) => void) & ((evt: "update:selectedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "expand" | "collapse" | "select" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:checkedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "expand" | "collapse" | "select" | "unselect" | "check" | "uncheck">) => void) & ((evt: "node-select", node: T | null, selectedKeys: TreeKey[]) => void) & ((evt: "node-action", action: string, node: T) => void) & ((evt: "node-drop", info: DropInfo<T>) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -1057,8 +1065,8 @@ interface FormModalEmits<T extends object = FormRecord> {
 //#region src/components/C_FormModal/index.vue.d.ts
 declare const __VLS_export: <T extends object = FormRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: vue.PublicProps & __VLS_PrettifyLocal<FormModalProps<T> & {
-    onClose?: (() => any) | undefined;
     onSubmit?: ((payload: SubmitEventPayload<T>, saved: boolean) => any) | undefined;
+    onClose?: (() => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -1067,7 +1075,7 @@ declare const __VLS_export: <T extends object = FormRecord>(__VLS_props: NonNull
   slots: {
     [x: string]: ((props: any) => any) | undefined;
   };
-  emit: ((evt: "close") => void) & ((evt: "submit", payload: SubmitEventPayload<T>, saved: boolean) => void);
+  emit: ((evt: "submit", payload: SubmitEventPayload<T>, saved: boolean) => void) & ((evt: "close") => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -1130,6 +1138,7 @@ declare function useFormState(options: ComputedRef<FormOption[]>, config: Comput
   asyncErrorMap: Ref<Record<string, unknown>, Record<string, unknown>>;
   getDictionaryOptions: (key: string) => readonly DictionaryOption[];
   isDictionaryLoading: (key: string) => boolean;
+  getDictionaryError: (key: string) => unknown;
   reloadOptions: (field?: string) => Promise<void>;
 };
 //#endregion

package/dist/useEdgeInteraction.d.cts

@@ -264,10 +264,10 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
-  readonly: boolean;
-  width: string | number;
   theme: "light" | "dark";
   height: string | number;
+  width: string | number;
+  readonly: boolean;
   showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/useEdgeInteraction.d.ts

@@ -264,10 +264,10 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
-  readonly: boolean;
-  width: string | number;
   theme: "light" | "dark";
   height: string | number;
+  width: string | number;
+  readonly: boolean;
   showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/useFormConfig.d.cts

@@ -365,6 +365,8 @@ interface FormInstance<T extends object = FormRecord> {
   asyncLoadingMap: Record<string, boolean>;
   /** 字段异步选项加载错误 */
   asyncErrorMap: Record<string, unknown>;
+  /** 当前字段字典加载错误；不修改模型，不等同于业务校验错误。 */
+  getDictionaryError(field: FieldPath<T>): unknown;
   /** 重新加载全部或指定字段的异步选项 */
   reloadOptions(field?: FieldPath<T>): Promise<void>;
   /** 是否正在提交 */

package/dist/useFormConfig.d.ts

@@ -365,6 +365,8 @@ interface FormInstance<T extends object = FormRecord> {
   asyncLoadingMap: Record<string, boolean>;
   /** 字段异步选项加载错误 */
   asyncErrorMap: Record<string, unknown>;
+  /** 当前字段字典加载错误；不修改模型，不等同于业务校验错误。 */
+  getDictionaryError(field: FieldPath<T>): unknown;
   /** 重新加载全部或指定字段的异步选项 */
   reloadOptions(field?: FieldPath<T>): Promise<void>;
   /** 是否正在提交 */

package/dist/useInfiniteScroll.d.cts

@@ -87,9 +87,9 @@ declare const __VLS_base: vue.DefineComponent<WaterFallProps, WaterFallExpose, {
   "onImage-loaded"?: ((item: WaterFallItem) => any) | undefined;
   "onImage-error"?: ((item: WaterFallItem) => any) | undefined;
 }>, {
-  columns: number;
   loading: boolean;
   virtualScroll: boolean;
+  columns: number;
   gap: number;
   lazy: boolean;
   infinite: boolean;

package/dist/useInfiniteScroll.d.ts

@@ -87,9 +87,9 @@ declare const __VLS_base: vue.DefineComponent<WaterFallProps, WaterFallExpose, {
   "onImage-loaded"?: ((item: WaterFallItem) => any) | undefined;
   "onImage-error"?: ((item: WaterFallItem) => any) | undefined;
 }>, {
-  columns: number;
   loading: boolean;
   virtualScroll: boolean;
+  columns: number;
   gap: number;
   lazy: boolean;
   infinite: boolean;

package/dist/useQRCode.d.cts

@@ -50,10 +50,10 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  mode: RenderMode;
-  color: string;
   size: number;
+  color: string;
   label: string;
+  mode: RenderMode;
   showBorder: boolean;
   showLabel: boolean;
   bgColor: string;

package/dist/useQRCode.d.ts

@@ -50,10 +50,10 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  mode: RenderMode;
-  color: string;
   size: number;
+  color: string;
   label: string;
+  mode: RenderMode;
   showBorder: boolean;
   showLabel: boolean;
   bgColor: string;

package/dist/useSignatureHistory.d.cts

@@ -92,28 +92,28 @@ interface SignatureEmits {
 //#endregion
 //#region src/components/C_Signature/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<SignatureProps, SignatureExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  clear: () => any;
+  change: (data: SignatureStroke[]) => any;
   error: (error: Error) => any;
+  clear: () => any;
   "start-draw": () => any;
   drawing: (point: SignaturePoint) => any;
   "end-draw": (stroke: SignatureStroke) => any;
   undo: () => any;
   redo: () => any;
-  change: (data: SignatureStroke[]) => any;
 }, string, vue.PublicProps, Readonly<SignatureProps> & Readonly<{
-  onClear?: (() => any) | undefined;
+  onChange?: ((data: SignatureStroke[]) => any) | undefined;
   onError?: ((error: Error) => any) | undefined;
+  onClear?: (() => any) | undefined;
   "onStart-draw"?: (() => any) | undefined;
   onDrawing?: ((point: SignaturePoint) => any) | undefined;
   "onEnd-draw"?: ((stroke: SignatureStroke) => any) | undefined;
   onUndo?: (() => any) | undefined;
   onRedo?: (() => any) | undefined;
-  onChange?: ((data: SignatureStroke[]) => any) | undefined;
 }>, {
   disabled: boolean;
-  readonly: boolean;
-  width: number | string;
   height: number | string;
+  width: number | string;
+  readonly: boolean;
   showToolbar: boolean;
   maxHistory: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/useSignatureHistory.d.ts

@@ -92,28 +92,28 @@ interface SignatureEmits {
 //#endregion
 //#region src/components/C_Signature/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<SignatureProps, SignatureExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  clear: () => any;
+  change: (data: SignatureStroke[]) => any;
   error: (error: Error) => any;
+  clear: () => any;
   "start-draw": () => any;
   drawing: (point: SignaturePoint) => any;
   "end-draw": (stroke: SignatureStroke) => any;
   undo: () => any;
   redo: () => any;
-  change: (data: SignatureStroke[]) => any;
 }, string, vue.PublicProps, Readonly<SignatureProps> & Readonly<{
-  onClear?: (() => any) | undefined;
+  onChange?: ((data: SignatureStroke[]) => any) | undefined;
   onError?: ((error: Error) => any) | undefined;
+  onClear?: (() => any) | undefined;
   "onStart-draw"?: (() => any) | undefined;
   onDrawing?: ((point: SignaturePoint) => any) | undefined;
   "onEnd-draw"?: ((stroke: SignatureStroke) => any) | undefined;
   onUndo?: (() => any) | undefined;
   onRedo?: (() => any) | undefined;
-  onChange?: ((data: SignatureStroke[]) => any) | undefined;
 }>, {
   disabled: boolean;
-  readonly: boolean;
-  width: number | string;
   height: number | string;
+  width: number | string;
+  readonly: boolean;
   showToolbar: boolean;
   maxHistory: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/useSplitResize.d.cts

@@ -56,28 +56,28 @@ type __VLS_Slots = {
 };
 declare const __VLS_base: vue.DefineComponent<SplitPaneProps, SplitPaneExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   expand: (target: CollapseTarget) => any;
-  "update:size": (size: number) => any;
-  resize: (firstSize: number, secondSize: number) => any;
   collapse: (target: CollapseTarget) => any;
   "drag-start": (size: number) => any;
   "drag-end": (size: number) => any;
+  resize: (firstSize: number, secondSize: number) => any;
+  "update:size": (size: number) => any;
 }, string, vue.PublicProps, Readonly<SplitPaneProps> & Readonly<{
   onExpand?: ((target: CollapseTarget) => any) | undefined;
-  "onUpdate:size"?: ((size: number) => any) | undefined;
-  onResize?: ((firstSize: number, secondSize: number) => any) | undefined;
   onCollapse?: ((target: CollapseTarget) => any) | undefined;
   "onDrag-start"?: ((size: number) => any) | undefined;
   "onDrag-end"?: ((size: number) => any) | undefined;
+  onResize?: ((firstSize: number, secondSize: number) => any) | undefined;
+  "onUpdate:size"?: ((size: number) => any) | undefined;
 }>, {
-  step: number;
   disabled: boolean;
+  step: number;
   direction: SplitDirection;
+  collapsible: boolean;
+  maxSize: number;
   defaultSize: number;
   minSize: number;
-  maxSize: number;
   minFirstSize: number;
   minSecondSize: number;
-  collapsible: boolean;
   showCollapseButton: boolean;
   gutterSize: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/useSplitResize.d.ts

@@ -56,28 +56,28 @@ type __VLS_Slots = {
 };
 declare const __VLS_base: vue.DefineComponent<SplitPaneProps, SplitPaneExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   expand: (target: CollapseTarget) => any;
-  "update:size": (size: number) => any;
-  resize: (firstSize: number, secondSize: number) => any;
   collapse: (target: CollapseTarget) => any;
   "drag-start": (size: number) => any;
   "drag-end": (size: number) => any;
+  resize: (firstSize: number, secondSize: number) => any;
+  "update:size": (size: number) => any;
 }, string, vue.PublicProps, Readonly<SplitPaneProps> & Readonly<{
   onExpand?: ((target: CollapseTarget) => any) | undefined;
-  "onUpdate:size"?: ((size: number) => any) | undefined;
-  onResize?: ((firstSize: number, secondSize: number) => any) | undefined;
   onCollapse?: ((target: CollapseTarget) => any) | undefined;
   "onDrag-start"?: ((size: number) => any) | undefined;
   "onDrag-end"?: ((size: number) => any) | undefined;
+  onResize?: ((firstSize: number, secondSize: number) => any) | undefined;
+  "onUpdate:size"?: ((size: number) => any) | undefined;
 }>, {
-  step: number;
   disabled: boolean;
+  step: number;
   direction: SplitDirection;
+  collapsible: boolean;
+  maxSize: number;
   defaultSize: number;
   minSize: number;
-  maxSize: number;
   minFirstSize: number;
   minSecondSize: number;
-  collapsible: boolean;
   showCollapseButton: boolean;
   gutterSize: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/useWorkflowValidation.d.cts

@@ -261,20 +261,20 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   "update:modelValue": (value: WorkflowData) => any;
   change: (value: WorkflowData) => any;
-  save: (data: WorkflowData) => any;
-  "validate-error": (errors: ValidationError[]) => any;
   "node-click": (node: WorkflowNode<NodeType>) => any;
   "edge-click": (edge: WorkflowEdge) => any;
+  save: (data: WorkflowData) => any;
+  "validate-error": (errors: ValidationError[]) => any;
 }, string, vue.PublicProps, Readonly<WorkflowProps> & Readonly<{
   "onUpdate:modelValue"?: ((value: WorkflowData) => any) | undefined;
   onChange?: ((value: WorkflowData) => any) | undefined;
-  onSave?: ((data: WorkflowData) => any) | undefined;
-  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
   "onNode-click"?: ((node: WorkflowNode<NodeType>) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
+  onSave?: ((data: WorkflowData) => any) | undefined;
+  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
 }>, {
-  readonly: boolean;
   theme: "light" | "dark";
+  readonly: boolean;
   users: User[];
   roles: Role[];
   departments: Department[];

package/dist/useWorkflowValidation.d.ts

@@ -261,20 +261,20 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   "update:modelValue": (value: WorkflowData) => any;
   change: (value: WorkflowData) => any;
-  save: (data: WorkflowData) => any;
-  "validate-error": (errors: ValidationError[]) => any;
   "node-click": (node: WorkflowNode<NodeType>) => any;
   "edge-click": (edge: WorkflowEdge) => any;
+  save: (data: WorkflowData) => any;
+  "validate-error": (errors: ValidationError[]) => any;
 }, string, vue.PublicProps, Readonly<WorkflowProps> & Readonly<{
   "onUpdate:modelValue"?: ((value: WorkflowData) => any) | undefined;
   onChange?: ((value: WorkflowData) => any) | undefined;
-  onSave?: ((data: WorkflowData) => any) | undefined;
-  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
   "onNode-click"?: ((node: WorkflowNode<NodeType>) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
+  onSave?: ((data: WorkflowData) => any) | undefined;
+  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
 }>, {
-  readonly: boolean;
   theme: "light" | "dark";
+  readonly: boolean;
   users: User[];
   roles: Role[];
   departments: Department[];

package/dist/verification.d.cts

@@ -77,23 +77,23 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
   reset: () => any;
-  "load-error": (error: unknown) => any;
+  success: (data: CaptchaSuccessPayload) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
+  "load-error": (error: unknown) => any;
   "visible-change": (visible: boolean) => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
   onChange?: ((valid: boolean) => any) | undefined;
-  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onReset?: (() => any) | undefined;
-  "onLoad-error"?: ((error: unknown) => any) | undefined;
+  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
+  "onLoad-error"?: ((error: unknown) => any) | undefined;
   "onVisible-change"?: ((visible: boolean) => any) | undefined;
 }>, {
-  disabled: boolean;
   theme: "light" | "dark";
+  disabled: boolean;
   provider: CaptchaProvider;
   images: string[];
   verificationTimeout: number;

package/dist/verification.d.ts

@@ -77,23 +77,23 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
   reset: () => any;
-  "load-error": (error: unknown) => any;
+  success: (data: CaptchaSuccessPayload) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
+  "load-error": (error: unknown) => any;
   "visible-change": (visible: boolean) => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
   onChange?: ((valid: boolean) => any) | undefined;
-  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onReset?: (() => any) | undefined;
-  "onLoad-error"?: ((error: unknown) => any) | undefined;
+  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
+  "onLoad-error"?: ((error: unknown) => any) | undefined;
   "onVisible-change"?: ((visible: boolean) => any) | undefined;
 }>, {
-  disabled: boolean;
   theme: "light" | "dark";
+  disabled: boolean;
   provider: CaptchaProvider;
   images: string[];
   verificationTimeout: number;

package/docs/guides/data-workflows.md

@@ -30,11 +30,20 @@ app.use(Components, {
 - `getOptions()`：同步快照，编码保留 string/number/boolean 类型。
 - `load({ signal })`：可选的异步准备；视图会忽略已失效的请求。
 - `subscribe(listener)`：可选的更新通知，返回取消订阅函数。
+- `getState()`：可选的共享状态快照，`status` 为 `idle/loading/ready/empty/error`，失败时可带 `error`。提供它时，订阅同时通知状态变化；源应先更新快照再通知。未提供时保持原有协议。
+
+状态快照可选带 `options`，这代表该数组不可变，并且与 `getOptions()` 返回同一份数据。此时仅加载／失败变化不会复制选项或重建翻译索引。未提供这个承诺的旧源仍支持修改原数组后发出订阅通知。
+
+初次绑定调用 `load({ signal })`，字段或表格的显式重试调用 `load({ signal, force: true })`。源负责合并同一字典的并发请求，某个控件卸载仅取消自己的等待，不能打断其他使用者。空数组是成功的空字典，不应通过抛错表示空结果。
+
+表单和搜索就地显示失败与重试，表格只显示一条按字典源去重的状态条；失败保留旧标签和原值，不逐单元格弹消息。`C_Form.getDictionaryError(field)` 可读取诊断，显式 `config.onError` 仍可观测表单异常。组件不把字典错误当作字段业务校验错误，也不会覆盖校验提示。表格的显式 `feedback.error` 继续可选接管诊断。
 
 应用已有 store/resolver 时直接桥接，不叠加第二套 TTL 缓存。源负责组织、租户、语言和业务参数隔离：请求开始时捕获作用域，参数切换后不得把旧响应写进新作用域。可由 `getDictionary` 返回该作用域的稳定源，或发布当前快照变更通知。组件仅管理可销毁的选项视图及派生索引。
 
 选项必须是有效且唯一的原始编码、字符串标签及可选 boolean disabled。空数组是已提供的空选项，不回退到旧数据。未知编码原样回显；停用历史编码可以保留在源中供展示。重复标签在反向解析时报告歧义，不自动选择第一项。高频展示使用 `createDictionaryLabelResolver(options)`，快照变化时重建一次索引。
 
+数组编码逐项翻译，以 `、` 连接；空数组显示为空。字符串编码不按逗号或其他字符自动拆分。普通枚举仅负责文字转换，状态色仍由表格列的 `status` 显式声明。
+
 ## 数值：存储、显示和校验分别定义
 
 ```ts

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.24.6",
+  "version": "0.25.0",
   "description": "基于 Naive UI 的 Vue 3 组件库",
   "packageManager": "bun@1.4.2",
   "engines": {