@robot-admin/naive-ui-components 0.14.3 → 0.15.0

package/dist/useTableQuery.d.cts

@@ -1,11 +1,25 @@
 import { f as ActionItem, s as ActionBarConfig } from "./presets.cjs";
-import { i as ComponentLocale, r as ComponentFeedback } from "./config.cjs";
+import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.cjs";
 import * as vue from "vue";
 import { App, ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, VNodeChild } from "vue";
 import { DataTableBaseColumn, DataTableColumn, DataTableRowKey, FormItemRule, PaginationProps } from "naive-ui";
 import * as _vue_shared0 from "@vue/shared";
 import { HLJSApi } from "highlight.js";
 
+//#region src/context.d.ts
+declare const COMPONENT_FEEDBACK_KEY: InjectionKey<ComponentFeedback>;
+declare const COMPONENT_LOCALE_KEY: InjectionKey<ComponentLocale>;
+//#endregion
+//#region src/composables/useComponentLocale.d.ts
+/** Bind the UI-independent translator to this Vue application and local configuration. */
+declare function useComponentLocale(local?: MaybeRefOrGetter<ComponentLocale | undefined>): {
+  t: (key: string, params?: Record<string, string | number>) => string;
+};
+//#endregion
+//#region src/adapters/naive/feedback.d.ts
+/** Reuse Naive providers when present and safely degrade to injected/no-op feedback. */
+declare function useComponentFeedback(local?: MaybeRefOrGetter<ComponentFeedback | undefined>): Required<ComponentFeedback>;
+//#endregion
 //#region src/components/C_Table/composables/usePrintWatermark.d.ts
 interface WatermarkConfig {
   text: string;
@@ -234,44 +248,41 @@ declare function useRowDrag<T extends object = DataRecord>(options: UseRowDragOp
 //#region src/components/C_Table/composables/useCrossPageSelection.d.ts
 interface CrossPageSelectionConfig {
   enabled?: boolean;
-  /** 最大选择数 */
+  /** Maximum selected rows, including previously visited remote pages. */
   maxSelection?: number;
 }
 interface UseCrossPageSelectionOptions<T extends object = DataRecord> {
-  /** 全量数据（非分页后的） */
+  /** All local rows, or the loaded page when remote is enabled. */
   allData: Ref<T[]> | ComputedRef<T[]>;
-  /** 行键函数 */
   rowKey: (row: T) => DataTableRowKey;
-  /** 配置 */
   config: MaybeRefOrGetter<CrossPageSelectionConfig | undefined>;
+  remote?: MaybeRefOrGetter<boolean>;
+  childrenKey?: MaybeRefOrGetter<string | undefined>;
+  rowCheckable?: (row: T) => boolean;
+  onSelectionChange?: (keys: DataTableRowKey[], rows: T[]) => void;
 }
 interface UseCrossPageSelectionReturn<T extends object = DataRecord> {
-  /** 所有选中的 key（跨页） */
   selectedKeys: Ref<Set<DataTableRowKey>>;
-  /** 选中行数量 */
   selectedCount: ComputedRef<number>;
-  /** 当前页数据的 checkedKeys（给 NDataTable 绑定） */
   getPageCheckedKeys: (pageData: T[]) => DataTableRowKey[];
-  /** NDataTable @update:checked-row-keys 处理器 */
   handlePageSelectionChange: (keys: DataTableRowKey[], pageData: T[]) => void;
-  /** 全选所有页 */
+  /** In remote mode, adds the currently loaded page; never claims to select unseen server rows. */
   selectAll: () => void;
-  /** 选择指定 key */
   select: (key: DataTableRowKey) => boolean;
-  /** 取消选择指定 key */
   unselect: (key: DataTableRowKey) => void;
-  /** 清除所有页选中 */
   clearAll: () => void;
-  /** 获取所有选中行数据 */
   getSelectedRows: () => T[];
-  /** 判断 key 是否选中 */
   isSelected: (key: DataTableRowKey) => boolean;
 }
-/** 跨页多选组合式函数 */
+/** Preserve selected identities and loaded row snapshots across local or remote pages. */
 declare function useCrossPageSelection<T extends object = DataRecord>(options: UseCrossPageSelectionOptions<T>): UseCrossPageSelectionReturn<T>;
 //#endregion
 //#region src/components/C_Table/composables/useTableExport.d.ts
 interface ExportConfig {
+  /** Data scope used by C_Table; source preserves the legacy loaded-source behavior. */
+  scope?: 'source' | 'page' | 'selected';
+  /** Explicit server-side/full-data export request; invoked only when exporting. */
+  requestData?: () => DataRecord[] | Promise<DataRecord[]>;
   /** 导出文件名（不含扩展名） */
   filename?: string;
   /** 导出格式 */
@@ -784,7 +795,9 @@ interface BaseTableColumn<T extends object = DataRecord> extends Omit<DataTableB
   required?: boolean;
   editType?: EditType;
   editProps?: EditProps;
-  editRender?: (value: unknown, rowData: T, rowIndex: number) => VNodeChild;
+  editRender?: (value: unknown, rowData: T, rowIndex: number, context: {
+    onUpdate: (value: unknown) => void;
+  }) => VNodeChild;
   render?: (rowData: T, rowIndex: number) => VNodeChild;
   /** 声明式格式化器（优先级低于 render） */
   formatter?: ColumnFormatter;
@@ -911,6 +924,8 @@ interface TableExpandMethods {
   expandAll: () => Promise<void>;
   collapseAll: () => void;
   isExpanded: (rowKey: DataTableRowKey) => boolean;
+  retryExpand: (rowKey: DataTableRowKey) => Promise<void>;
+  invalidateExpand: (rowKey?: DataTableRowKey) => void;
 }
 interface TableSelectionMethods<T extends object = DataRecord, C = DataRecord> {
   selectRow: (rowKey: DataTableRowKey) => boolean | void;
@@ -942,11 +957,16 @@ interface TablePaginationMethods {
   resetToFirstPage: () => void;
   getTotalPages: () => number;
 }
-interface TableInstance<T extends object = DataRecord, C = DataRecord> extends TableEditMethods<T>, TableExpandMethods, TableSelectionMethods<T, C>, TableDynamicRowsMethods<T>, TablePaginationMethods {}
+interface TableInstance<T extends object = DataRecord, C = DataRecord> extends TableEditMethods<T>, TableExpandMethods, TableSelectionMethods<T, C>, TableDynamicRowsMethods<T>, TablePaginationMethods {
+  exportData: () => Promise<void>;
+}
 interface UseTableExpandOptions<T extends object = DataRecord, C = DataRecord> extends ExpandConfig<T, C>, SelectionConfig<T, C> {
   data: Ref<T[]> | ComputedRef<T[]>;
   rowKey: (row: T) => DataTableRowKey;
   childRowKey?: (child: C) => DataTableRowKey;
+  /** Native tree children field; omitted for flat/detail-expansion tables. */
+  childrenKey?: string;
+  locale?: ComponentLocale;
   /** 展开数据等待时的加载内容，C_Table 内置统一 SVG；独立引擎可按需提供。 */
   renderLoading?: () => VNodeChild;
   defaultExpandedKeys?: DataTableRowKey[];
@@ -960,6 +980,9 @@ interface UseTableExpandReturn<T extends object = DataRecord, C = DataRecord> {
   childSelections: Ref<Map<DataTableRowKey, DataTableRowKey[]>>;
   expandDataMap: Ref<Map<DataTableRowKey, C[]>>;
   loadingMap: Ref<Map<DataTableRowKey, boolean>>;
+  errorMap: Ref<Map<DataTableRowKey, unknown>>;
+  retryExpand: (key: DataTableRowKey) => Promise<void>;
+  invalidateExpand: (key?: DataTableRowKey) => void;
   selectedRowsCount: ComputedRef<number>;
   totalChildSelections: ComputedRef<number>;
   expandAll: () => Promise<void>;
@@ -1005,7 +1028,9 @@ declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNull
     data?: MaybeRefLike<T[]>; /** 加载状态 */
     loading?: MaybeRefLike<boolean>; /** 行唯一键 */
     rowKey?: string | ((row: T) => DataTableRowKey); /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
-    config?: TableConfig<T>; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
+    config?: TableConfig<T>; /** Native pagination compatibility path; takes ownership over config.pagination. */
+    pagination?: PaginationProps | false; /** Native remote mode, used with the native pagination compatibility path. */
+    remote?: boolean; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
     crud?: CrudBinding<T>;
   } & {
     [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
@@ -1019,6 +1044,8 @@ declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNull
     expandRow: (rowKey: DataTableRowKey) => Promise<void>;
     collapseRow: (rowKey: DataTableRowKey) => void;
     toggleExpand: (rowKey: DataTableRowKey) => Promise<void>;
+    retryExpand: (rowKey: DataTableRowKey) => Promise<void>;
+    invalidateExpand: (rowKey?: DataTableRowKey) => void;
     expandAll: () => Promise<void>;
     collapseAll: () => void;
     selectRow: (rowKey: DataTableRowKey) => boolean;
@@ -1117,7 +1144,7 @@ declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNull
   } & {
     loading?: (props: {}) => any;
   };
-  emit: ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
+  emit: ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -1208,7 +1235,7 @@ interface RowValidationError {
 interface RowEditOptions {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey;
-  onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onSave?: (rowData: DataRecord, rowIndex: number, originalKey?: DataTableRowKey) => void | Promise<void>;
   onCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
@@ -1270,6 +1297,8 @@ interface TableManagerConfig {
   enableParentChildLink: boolean;
   parentChildLinkMode: ParentChildLinkMode;
   dynamicRows?: DynamicRowsOptions<DataRecord>;
+  treeEnabled?: boolean;
+  treeChildrenKey?: string;
 }
 /**
  * 表格管理器参数接口
@@ -1283,12 +1312,14 @@ interface TableManagerParams {
   columns?: () => TableColumn[];
   /** UI 壳提供加载内容，状态引擎保持可独立调用。 */
   renderLoading?: () => VNodeChild;
+  /** String row-key field inherited by dynamic row creation; explicit dynamicRows.rowKey wins. */
+  rowKeyField?: MaybeRefOrGetter<string | undefined>;
 }
 /**
  * 事件处理器接口
  */
 interface EventHandlers {
-  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string) => Promise<void>;
+  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string, originalKey?: DataTableRowKey) => Promise<void>;
   onCancel: (rowData: DataRecord, rowIndex: number) => Promise<void>;
   onExpandChange: (keys: DataTableRowKey[], row?: DataRecord, expanded?: boolean) => void;
   onSelectionChange: (checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections: Map<DataTableRowKey, DataTableRowKey[]>) => void;
@@ -1468,7 +1499,7 @@ declare function usePagination<T extends object = DataRecord>(options: UsePagina
 interface CellEditOptions {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey;
-  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string) => void | Promise<void>;
+  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string, originalKey?: DataTableRowKey) => void | Promise<void>;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
 }
@@ -1509,7 +1540,7 @@ declare function useCellEdit(options: CellEditOptions): {
 interface ModalEditOptions<T extends object = DataRecord> {
   data: () => T[];
   rowKey: (row: T) => DataTableRowKey;
-  onSave?: (editingData: T, rowIndex: number) => void | Promise<void>;
+  onSave?: (editingData: T, rowIndex: number, originalKey?: DataTableRowKey) => void | Promise<void>;
   onCancel?: (originalData: T, rowIndex: number) => void | Promise<void>;
 }
 /** Modal edit state with lossless snapshots and retry-safe async saves. */
@@ -1535,6 +1566,8 @@ declare function useModalEdit<T extends object = DataRecord>(options: ModalEditO
 interface HighlightPluginOptions {
   autoDetect?: boolean;
   extraLanguages?: string[];
+  /** Explicit compatibility bridge; restored when the owning app unmounts. */
+  exposeToWindow?: boolean;
   /** Enable lifecycle diagnostics through the supplied logger. */
   debug?: boolean;
   logger?: Pick<Console, 'info' | 'warn' | 'error'>;
@@ -1543,23 +1576,23 @@ interface HighlightPluginOptions {
     language: string;
   }) => void;
 }
-/**
- * * @description 获取 highlight 功能的 API 接口
- * ! @return highlight API 对象，包含所有可用方法
- */
-declare const useHighlight: (options?: HighlightPluginOptions) => {
+interface HighlightAPI {
   getHljs: () => HLJSApi;
   loadLanguage: (language: string) => Promise<boolean>;
   loadLanguages: (languages: string[]) => Promise<string[]>;
   getLoadedLanguages: () => string[];
-};
+}
+/** Create an independent highlighter, including its language registry and loaders. */
+declare function createHighlight(options?: HighlightPluginOptions): HighlightAPI;
+/** Reuse the current app's highlighter or create a standalone, isolated one. */
+declare function useHighlight(options?: HighlightPluginOptions): HighlightAPI;
 /**
  * * @description 安装 highlight.js 插件到 Vue 应用
  * ? @param app - Vue 应用实例
  * ? @param options - 插件配置选项
- * ! @return void
+ * ! @return 应用独立的 highlight API
  */
-declare function setupHighlight(app: App, options?: HighlightPluginOptions): void;
+declare function setupHighlight(app: App, options?: HighlightPluginOptions): HighlightAPI;
 //#endregion
 //#region src/utils/storage.d.ts
 /** SSR-safe localStorage helpers. Storage failures never break component state. */
@@ -1700,4 +1733,4 @@ declare function useTableQuery<T extends object, Q extends object = Record<strin
   cancel: () => void;
 };
 //#endregion
-export { applyFormatter as $, EditMode as A, PrintWatermarkOptions as At, TableColumn as B, _default as C, RowDragConfig as Ct, ColumnWithKey as D, DynamicRowsOptions as Dt, ChildSelectionState as E, useRowDrag as Et, RenderFunction as F, TableRowKeyIssue as G, TableInstance as H, RowAction as I, ColumnFormatter as J, UseTableExpandOptions as K, SelectOption as L, NormalTableColumn as M, usePrintWatermark as Mt, PaginationConfig as N, CustomAction as O, DynamicRowsReturn as Ot, ParentChildLinkMode as P, TableGlobalConfig as Q, SimpleTableActions as R, validateTableRowKeys as S, useCrossPageSelection as St, BuiltInTableColumn as T, UseRowDragReturn as Tt, TableProps as U, TableEmits as V, TableRowKey as W, FormatterType as X, FormatterConfig as Y, TABLE_GLOBAL_CONFIG_KEY as Z, useTableManager as _, ExportConfig as _t, getItem as a, DisplayConfig as at, defineTableColumns as b, UseCrossPageSelectionOptions as bt, setItem as c, ExpandConfig$1 as ct, useHighlight as d, TableConfig as dt, mergeGlobalConfig as et, useModalEdit as f, ToolbarConfig as ft, useTableExpand as g, resolveConfig as gt, useTableActions as h, createEditModeChecker as ht, useTableQuery as i, CrudBinding as it, MaybeRefLike as j, printPresets as jt, DataRecord as k, useDynamicRows as kt, HighlightPluginOptions as l, SelectionConfig$1 as lt, usePagination as m, VirtualScrollConfig as mt, TableQueryResult as n, BatchActionsConfig as nt, removeAllItem as o, EditConfig as ot, useCellEdit as p, TreeConfig as pt, UseTableExpandReturn as q, UseTableQueryOptions as r, ColumnDragConfig as rt, removeItem as s, ErrorConfig as st, TableQueryContext as t, useTableGlobalConfig as tt, setupHighlight as u, SummaryConfig as ut, useRowEdit as v, exportTableData as vt, ApiFunction as w, UseRowDragOptions as wt, defineTableConfig as x, UseCrossPageSelectionReturn as xt, useTableColumns as y, CrossPageSelectionConfig as yt, StrictTableColumn as z };
+export { TABLE_GLOBAL_CONFIG_KEY as $, CustomAction as A, DynamicRowsReturn as At, SimpleTableActions as B, defineTableConfig as C, UseCrossPageSelectionReturn as Ct, BuiltInTableColumn as D, UseRowDragReturn as Dt, ApiFunction as E, UseRowDragOptions as Et, PaginationConfig as F, useComponentFeedback as Ft, TableProps as G, TableColumn as H, ParentChildLinkMode as I, useComponentLocale as It, UseTableExpandOptions as J, TableRowKey as K, RenderFunction as L, COMPONENT_FEEDBACK_KEY as Lt, EditMode as M, PrintWatermarkOptions as Mt, MaybeRefLike as N, printPresets as Nt, ChildSelectionState as O, useRowDrag as Ot, NormalTableColumn as P, usePrintWatermark as Pt, FormatterType as Q, RowAction as R, COMPONENT_LOCALE_KEY as Rt, defineTableColumns as S, UseCrossPageSelectionOptions as St, _default as T, RowDragConfig as Tt, TableEmits as U, StrictTableColumn as V, TableInstance as W, ColumnFormatter as X, UseTableExpandReturn as Y, FormatterConfig as Z, useTableActions as _, createEditModeChecker as _t, getItem as a, ColumnDragConfig as at, useRowEdit as b, exportTableData as bt, setItem as c, EditConfig as ct, createHighlight as d, SelectionConfig$1 as dt, TableGlobalConfig as et, setupHighlight as f, SummaryConfig as ft, usePagination as g, VirtualScrollConfig as gt, useCellEdit as h, TreeConfig as ht, useTableQuery as i, BatchActionsConfig as it, DataRecord as j, useDynamicRows as jt, ColumnWithKey as k, DynamicRowsOptions as kt, HighlightAPI as l, ErrorConfig as lt, useModalEdit as m, ToolbarConfig as mt, TableQueryResult as n, mergeGlobalConfig as nt, removeAllItem as o, CrudBinding as ot, useHighlight as p, TableConfig as pt, TableRowKeyIssue as q, UseTableQueryOptions as r, useTableGlobalConfig as rt, removeItem as s, DisplayConfig as st, TableQueryContext as t, applyFormatter as tt, HighlightPluginOptions as u, ExpandConfig$1 as ut, useTableExpand as v, resolveConfig as vt, validateTableRowKeys as w, useCrossPageSelection as wt, useTableColumns as x, CrossPageSelectionConfig as xt, useTableManager as y, ExportConfig as yt, SelectOption as z };

package/dist/useTableQuery.d.ts

@@ -1,11 +1,25 @@
 import { f as ActionItem, s as ActionBarConfig } from "./presets.js";
-import { i as ComponentLocale, r as ComponentFeedback } from "./config.js";
+import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.js";
 import * as vue from "vue";
 import { App, ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, VNodeChild } from "vue";
 import { DataTableBaseColumn, DataTableColumn, DataTableRowKey, FormItemRule, PaginationProps } from "naive-ui";
 import * as _vue_shared0 from "@vue/shared";
 import { HLJSApi } from "highlight.js";
 
+//#region src/context.d.ts
+declare const COMPONENT_FEEDBACK_KEY: InjectionKey<ComponentFeedback>;
+declare const COMPONENT_LOCALE_KEY: InjectionKey<ComponentLocale>;
+//#endregion
+//#region src/composables/useComponentLocale.d.ts
+/** Bind the UI-independent translator to this Vue application and local configuration. */
+declare function useComponentLocale(local?: MaybeRefOrGetter<ComponentLocale | undefined>): {
+  t: (key: string, params?: Record<string, string | number>) => string;
+};
+//#endregion
+//#region src/adapters/naive/feedback.d.ts
+/** Reuse Naive providers when present and safely degrade to injected/no-op feedback. */
+declare function useComponentFeedback(local?: MaybeRefOrGetter<ComponentFeedback | undefined>): Required<ComponentFeedback>;
+//#endregion
 //#region src/components/C_Table/composables/usePrintWatermark.d.ts
 interface WatermarkConfig {
   text: string;
@@ -234,44 +248,41 @@ declare function useRowDrag<T extends object = DataRecord>(options: UseRowDragOp
 //#region src/components/C_Table/composables/useCrossPageSelection.d.ts
 interface CrossPageSelectionConfig {
   enabled?: boolean;
-  /** 最大选择数 */
+  /** Maximum selected rows, including previously visited remote pages. */
   maxSelection?: number;
 }
 interface UseCrossPageSelectionOptions<T extends object = DataRecord> {
-  /** 全量数据（非分页后的） */
+  /** All local rows, or the loaded page when remote is enabled. */
   allData: Ref<T[]> | ComputedRef<T[]>;
-  /** 行键函数 */
   rowKey: (row: T) => DataTableRowKey;
-  /** 配置 */
   config: MaybeRefOrGetter<CrossPageSelectionConfig | undefined>;
+  remote?: MaybeRefOrGetter<boolean>;
+  childrenKey?: MaybeRefOrGetter<string | undefined>;
+  rowCheckable?: (row: T) => boolean;
+  onSelectionChange?: (keys: DataTableRowKey[], rows: T[]) => void;
 }
 interface UseCrossPageSelectionReturn<T extends object = DataRecord> {
-  /** 所有选中的 key（跨页） */
   selectedKeys: Ref<Set<DataTableRowKey>>;
-  /** 选中行数量 */
   selectedCount: ComputedRef<number>;
-  /** 当前页数据的 checkedKeys（给 NDataTable 绑定） */
   getPageCheckedKeys: (pageData: T[]) => DataTableRowKey[];
-  /** NDataTable @update:checked-row-keys 处理器 */
   handlePageSelectionChange: (keys: DataTableRowKey[], pageData: T[]) => void;
-  /** 全选所有页 */
+  /** In remote mode, adds the currently loaded page; never claims to select unseen server rows. */
   selectAll: () => void;
-  /** 选择指定 key */
   select: (key: DataTableRowKey) => boolean;
-  /** 取消选择指定 key */
   unselect: (key: DataTableRowKey) => void;
-  /** 清除所有页选中 */
   clearAll: () => void;
-  /** 获取所有选中行数据 */
   getSelectedRows: () => T[];
-  /** 判断 key 是否选中 */
   isSelected: (key: DataTableRowKey) => boolean;
 }
-/** 跨页多选组合式函数 */
+/** Preserve selected identities and loaded row snapshots across local or remote pages. */
 declare function useCrossPageSelection<T extends object = DataRecord>(options: UseCrossPageSelectionOptions<T>): UseCrossPageSelectionReturn<T>;
 //#endregion
 //#region src/components/C_Table/composables/useTableExport.d.ts
 interface ExportConfig {
+  /** Data scope used by C_Table; source preserves the legacy loaded-source behavior. */
+  scope?: 'source' | 'page' | 'selected';
+  /** Explicit server-side/full-data export request; invoked only when exporting. */
+  requestData?: () => DataRecord[] | Promise<DataRecord[]>;
   /** 导出文件名（不含扩展名） */
   filename?: string;
   /** 导出格式 */
@@ -784,7 +795,9 @@ interface BaseTableColumn<T extends object = DataRecord> extends Omit<DataTableB
   required?: boolean;
   editType?: EditType;
   editProps?: EditProps;
-  editRender?: (value: unknown, rowData: T, rowIndex: number) => VNodeChild;
+  editRender?: (value: unknown, rowData: T, rowIndex: number, context: {
+    onUpdate: (value: unknown) => void;
+  }) => VNodeChild;
   render?: (rowData: T, rowIndex: number) => VNodeChild;
   /** 声明式格式化器（优先级低于 render） */
   formatter?: ColumnFormatter;
@@ -911,6 +924,8 @@ interface TableExpandMethods {
   expandAll: () => Promise<void>;
   collapseAll: () => void;
   isExpanded: (rowKey: DataTableRowKey) => boolean;
+  retryExpand: (rowKey: DataTableRowKey) => Promise<void>;
+  invalidateExpand: (rowKey?: DataTableRowKey) => void;
 }
 interface TableSelectionMethods<T extends object = DataRecord, C = DataRecord> {
   selectRow: (rowKey: DataTableRowKey) => boolean | void;
@@ -942,11 +957,16 @@ interface TablePaginationMethods {
   resetToFirstPage: () => void;
   getTotalPages: () => number;
 }
-interface TableInstance<T extends object = DataRecord, C = DataRecord> extends TableEditMethods<T>, TableExpandMethods, TableSelectionMethods<T, C>, TableDynamicRowsMethods<T>, TablePaginationMethods {}
+interface TableInstance<T extends object = DataRecord, C = DataRecord> extends TableEditMethods<T>, TableExpandMethods, TableSelectionMethods<T, C>, TableDynamicRowsMethods<T>, TablePaginationMethods {
+  exportData: () => Promise<void>;
+}
 interface UseTableExpandOptions<T extends object = DataRecord, C = DataRecord> extends ExpandConfig<T, C>, SelectionConfig<T, C> {
   data: Ref<T[]> | ComputedRef<T[]>;
   rowKey: (row: T) => DataTableRowKey;
   childRowKey?: (child: C) => DataTableRowKey;
+  /** Native tree children field; omitted for flat/detail-expansion tables. */
+  childrenKey?: string;
+  locale?: ComponentLocale;
   /** 展开数据等待时的加载内容，C_Table 内置统一 SVG；独立引擎可按需提供。 */
   renderLoading?: () => VNodeChild;
   defaultExpandedKeys?: DataTableRowKey[];
@@ -960,6 +980,9 @@ interface UseTableExpandReturn<T extends object = DataRecord, C = DataRecord> {
   childSelections: Ref<Map<DataTableRowKey, DataTableRowKey[]>>;
   expandDataMap: Ref<Map<DataTableRowKey, C[]>>;
   loadingMap: Ref<Map<DataTableRowKey, boolean>>;
+  errorMap: Ref<Map<DataTableRowKey, unknown>>;
+  retryExpand: (key: DataTableRowKey) => Promise<void>;
+  invalidateExpand: (key?: DataTableRowKey) => void;
   selectedRowsCount: ComputedRef<number>;
   totalChildSelections: ComputedRef<number>;
   expandAll: () => Promise<void>;
@@ -1005,7 +1028,9 @@ declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNull
     data?: MaybeRefLike<T[]>; /** 加载状态 */
     loading?: MaybeRefLike<boolean>; /** 行唯一键 */
     rowKey?: string | ((row: T) => DataTableRowKey); /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
-    config?: TableConfig<T>; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
+    config?: TableConfig<T>; /** Native pagination compatibility path; takes ownership over config.pagination. */
+    pagination?: PaginationProps | false; /** Native remote mode, used with the native pagination compatibility path. */
+    remote?: boolean; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
     crud?: CrudBinding<T>;
   } & {
     [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
@@ -1019,6 +1044,8 @@ declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNull
     expandRow: (rowKey: DataTableRowKey) => Promise<void>;
     collapseRow: (rowKey: DataTableRowKey) => void;
     toggleExpand: (rowKey: DataTableRowKey) => Promise<void>;
+    retryExpand: (rowKey: DataTableRowKey) => Promise<void>;
+    invalidateExpand: (rowKey?: DataTableRowKey) => void;
     expandAll: () => Promise<void>;
     collapseAll: () => void;
     selectRow: (rowKey: DataTableRowKey) => boolean;
@@ -1117,7 +1144,7 @@ declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNull
   } & {
     loading?: (props: {}) => any;
   };
-  emit: ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
+  emit: ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -1208,7 +1235,7 @@ interface RowValidationError {
 interface RowEditOptions {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey;
-  onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onSave?: (rowData: DataRecord, rowIndex: number, originalKey?: DataTableRowKey) => void | Promise<void>;
   onCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
@@ -1270,6 +1297,8 @@ interface TableManagerConfig {
   enableParentChildLink: boolean;
   parentChildLinkMode: ParentChildLinkMode;
   dynamicRows?: DynamicRowsOptions<DataRecord>;
+  treeEnabled?: boolean;
+  treeChildrenKey?: string;
 }
 /**
  * 表格管理器参数接口
@@ -1283,12 +1312,14 @@ interface TableManagerParams {
   columns?: () => TableColumn[];
   /** UI 壳提供加载内容，状态引擎保持可独立调用。 */
   renderLoading?: () => VNodeChild;
+  /** String row-key field inherited by dynamic row creation; explicit dynamicRows.rowKey wins. */
+  rowKeyField?: MaybeRefOrGetter<string | undefined>;
 }
 /**
  * 事件处理器接口
  */
 interface EventHandlers {
-  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string) => Promise<void>;
+  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string, originalKey?: DataTableRowKey) => Promise<void>;
   onCancel: (rowData: DataRecord, rowIndex: number) => Promise<void>;
   onExpandChange: (keys: DataTableRowKey[], row?: DataRecord, expanded?: boolean) => void;
   onSelectionChange: (checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections: Map<DataTableRowKey, DataTableRowKey[]>) => void;
@@ -1468,7 +1499,7 @@ declare function usePagination<T extends object = DataRecord>(options: UsePagina
 interface CellEditOptions {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey;
-  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string) => void | Promise<void>;
+  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string, originalKey?: DataTableRowKey) => void | Promise<void>;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
 }
@@ -1509,7 +1540,7 @@ declare function useCellEdit(options: CellEditOptions): {
 interface ModalEditOptions<T extends object = DataRecord> {
   data: () => T[];
   rowKey: (row: T) => DataTableRowKey;
-  onSave?: (editingData: T, rowIndex: number) => void | Promise<void>;
+  onSave?: (editingData: T, rowIndex: number, originalKey?: DataTableRowKey) => void | Promise<void>;
   onCancel?: (originalData: T, rowIndex: number) => void | Promise<void>;
 }
 /** Modal edit state with lossless snapshots and retry-safe async saves. */
@@ -1535,6 +1566,8 @@ declare function useModalEdit<T extends object = DataRecord>(options: ModalEditO
 interface HighlightPluginOptions {
   autoDetect?: boolean;
   extraLanguages?: string[];
+  /** Explicit compatibility bridge; restored when the owning app unmounts. */
+  exposeToWindow?: boolean;
   /** Enable lifecycle diagnostics through the supplied logger. */
   debug?: boolean;
   logger?: Pick<Console, 'info' | 'warn' | 'error'>;
@@ -1543,23 +1576,23 @@ interface HighlightPluginOptions {
     language: string;
   }) => void;
 }
-/**
- * * @description 获取 highlight 功能的 API 接口
- * ! @return highlight API 对象，包含所有可用方法
- */
-declare const useHighlight: (options?: HighlightPluginOptions) => {
+interface HighlightAPI {
   getHljs: () => HLJSApi;
   loadLanguage: (language: string) => Promise<boolean>;
   loadLanguages: (languages: string[]) => Promise<string[]>;
   getLoadedLanguages: () => string[];
-};
+}
+/** Create an independent highlighter, including its language registry and loaders. */
+declare function createHighlight(options?: HighlightPluginOptions): HighlightAPI;
+/** Reuse the current app's highlighter or create a standalone, isolated one. */
+declare function useHighlight(options?: HighlightPluginOptions): HighlightAPI;
 /**
  * * @description 安装 highlight.js 插件到 Vue 应用
  * ? @param app - Vue 应用实例
  * ? @param options - 插件配置选项
- * ! @return void
+ * ! @return 应用独立的 highlight API
  */
-declare function setupHighlight(app: App, options?: HighlightPluginOptions): void;
+declare function setupHighlight(app: App, options?: HighlightPluginOptions): HighlightAPI;
 //#endregion
 //#region src/utils/storage.d.ts
 /** SSR-safe localStorage helpers. Storage failures never break component state. */
@@ -1700,4 +1733,4 @@ declare function useTableQuery<T extends object, Q extends object = Record<strin
   cancel: () => void;
 };
 //#endregion
-export { applyFormatter as $, EditMode as A, PrintWatermarkOptions as At, TableColumn as B, _default as C, RowDragConfig as Ct, ColumnWithKey as D, DynamicRowsOptions as Dt, ChildSelectionState as E, useRowDrag as Et, RenderFunction as F, TableRowKeyIssue as G, TableInstance as H, RowAction as I, ColumnFormatter as J, UseTableExpandOptions as K, SelectOption as L, NormalTableColumn as M, usePrintWatermark as Mt, PaginationConfig as N, CustomAction as O, DynamicRowsReturn as Ot, ParentChildLinkMode as P, TableGlobalConfig as Q, SimpleTableActions as R, validateTableRowKeys as S, useCrossPageSelection as St, BuiltInTableColumn as T, UseRowDragReturn as Tt, TableProps as U, TableEmits as V, TableRowKey as W, FormatterType as X, FormatterConfig as Y, TABLE_GLOBAL_CONFIG_KEY as Z, useTableManager as _, ExportConfig as _t, getItem as a, DisplayConfig as at, defineTableColumns as b, UseCrossPageSelectionOptions as bt, setItem as c, ExpandConfig$1 as ct, useHighlight as d, TableConfig as dt, mergeGlobalConfig as et, useModalEdit as f, ToolbarConfig as ft, useTableExpand as g, resolveConfig as gt, useTableActions as h, createEditModeChecker as ht, useTableQuery as i, CrudBinding as it, MaybeRefLike as j, printPresets as jt, DataRecord as k, useDynamicRows as kt, HighlightPluginOptions as l, SelectionConfig$1 as lt, usePagination as m, VirtualScrollConfig as mt, TableQueryResult as n, BatchActionsConfig as nt, removeAllItem as o, EditConfig as ot, useCellEdit as p, TreeConfig as pt, UseTableExpandReturn as q, UseTableQueryOptions as r, ColumnDragConfig as rt, removeItem as s, ErrorConfig as st, TableQueryContext as t, useTableGlobalConfig as tt, setupHighlight as u, SummaryConfig as ut, useRowEdit as v, exportTableData as vt, ApiFunction as w, UseRowDragOptions as wt, defineTableConfig as x, UseCrossPageSelectionReturn as xt, useTableColumns as y, CrossPageSelectionConfig as yt, StrictTableColumn as z };
+export { TABLE_GLOBAL_CONFIG_KEY as $, CustomAction as A, DynamicRowsReturn as At, SimpleTableActions as B, defineTableConfig as C, UseCrossPageSelectionReturn as Ct, BuiltInTableColumn as D, UseRowDragReturn as Dt, ApiFunction as E, UseRowDragOptions as Et, PaginationConfig as F, useComponentFeedback as Ft, TableProps as G, TableColumn as H, ParentChildLinkMode as I, useComponentLocale as It, UseTableExpandOptions as J, TableRowKey as K, RenderFunction as L, COMPONENT_FEEDBACK_KEY as Lt, EditMode as M, PrintWatermarkOptions as Mt, MaybeRefLike as N, printPresets as Nt, ChildSelectionState as O, useRowDrag as Ot, NormalTableColumn as P, usePrintWatermark as Pt, FormatterType as Q, RowAction as R, COMPONENT_LOCALE_KEY as Rt, defineTableColumns as S, UseCrossPageSelectionOptions as St, _default as T, RowDragConfig as Tt, TableEmits as U, StrictTableColumn as V, TableInstance as W, ColumnFormatter as X, UseTableExpandReturn as Y, FormatterConfig as Z, useTableActions as _, createEditModeChecker as _t, getItem as a, ColumnDragConfig as at, useRowEdit as b, exportTableData as bt, setItem as c, EditConfig as ct, createHighlight as d, SelectionConfig$1 as dt, TableGlobalConfig as et, setupHighlight as f, SummaryConfig as ft, usePagination as g, VirtualScrollConfig as gt, useCellEdit as h, TreeConfig as ht, useTableQuery as i, BatchActionsConfig as it, DataRecord as j, useDynamicRows as jt, ColumnWithKey as k, DynamicRowsOptions as kt, HighlightAPI as l, ErrorConfig as lt, useModalEdit as m, ToolbarConfig as mt, TableQueryResult as n, mergeGlobalConfig as nt, removeAllItem as o, CrudBinding as ot, useHighlight as p, TableConfig as pt, TableRowKeyIssue as q, UseTableQueryOptions as r, useTableGlobalConfig as rt, removeItem as s, DisplayConfig as st, TableQueryContext as t, applyFormatter as tt, HighlightPluginOptions as u, ExpandConfig$1 as ut, useTableExpand as v, resolveConfig as vt, validateTableRowKeys as w, useCrossPageSelection as wt, useTableColumns as x, CrossPageSelectionConfig as xt, useTableManager as y, ExportConfig as yt, SelectOption as z };