@robot-admin/naive-ui-components 0.3.0

package/dist/useModalEdit.d.ts

@@ -0,0 +1,960 @@
+import * as vue from "vue";
+import { ComputedRef, MaybeRef, Ref, VNodeChild } from "vue";
+import { DataTableColumns, DataTableRowKey } from "naive-ui";
+import * as naive_ui_es0 from "naive-ui/es";
+import { DataTableColumn, DataTableRowKey as DataTableRowKey$1 } from "naive-ui/es";
+import { FormItemRule } from "naive-ui/es/form";
+
+//#region src/components/C_Table/types.d.ts
+type RefLike<T> = {
+  value: T;
+} | T;
+type MaybeRefLike<T> = RefLike<T> | MaybeRef<T>;
+type DataRecord = Record<string, unknown>;
+type EditMode = 'row' | 'cell' | 'both' | 'modal' | 'none';
+type EditType = 'input' | 'textarea' | 'select' | 'date' | 'number' | 'switch' | 'email' | 'mobile';
+type ButtonType = 'default' | 'primary' | 'info' | 'success' | 'warning' | 'error';
+type ParentChildLinkMode = 'strict' | 'loose';
+interface PaginationConfig {
+  enabled?: boolean;
+  page?: number;
+  pageSize?: number;
+  total?: number;
+  showSizePicker?: boolean;
+  showQuickJumper?: boolean;
+  pageSizes?: number[];
+  simple?: boolean;
+  size?: 'small' | 'medium' | 'large';
+  remote?: boolean;
+}
+/** API 函数类型 */
+type ApiFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => Promise<any> | any;
+/** 渲染函数类型 */
+type RenderFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => VNodeChild;
+/** 自定义操作按钮配置 */
+interface CustomAction<T extends DataRecord = DataRecord> {
+  /** 按钮唯一键 */
+  key: string;
+  /** 按钮显示文本 */
+  label: string | ((row: T, index: number) => string);
+  /** 按钮图标 */
+  icon: string | ((row: T, index: number) => string);
+  /** 按钮类型样式 */
+  type?: ButtonType | ((row: T, index: number) => ButtonType);
+  /** 点击事件处理器 */
+  onClick: (row: T, index: number) => void | Promise<void>;
+  /** 条件显示函数（可选） */
+  show?: (row: T, index: number) => boolean;
+  /** 是否禁用（可选） */
+  disabled?: (row: T, index: number) => boolean;
+  /** 按钮提示文本（可选） */
+  tooltip?: string;
+}
+/** 简化的操作配置 - 二元法则 */
+interface SimpleTableActions<T extends DataRecord = DataRecord> {
+  /** 编辑操作 - 直接传入函数 */
+  edit?: false | ApiFunction<T>;
+  /** 删除操作 - 直接传入函数 */
+  delete?: false | ApiFunction<T>;
+  /** 详情操作 - 直接传入函数 */
+  detail?: false | ApiFunction<T>;
+  /** 自定义操作按钮 */
+  custom?: CustomAction<T>[];
+  /** 完全自定义渲染 - 10%场景 */
+  render?: RenderFunction<T>;
+}
+/** useTableActions Hook 选项类型 */
+interface UseTableActionsOptions<T extends DataRecord = DataRecord> {
+  /** 操作配置 */
+  actions: Ref<SimpleTableActions<T>> | ComputedRef<SimpleTableActions<T>>;
+  /** 表格配置 */
+  config: Ref<any> | ComputedRef<any>;
+  /** 表格管理器 */
+  tableManager: any;
+  /** 行键获取函数 */
+  rowKey: (row: T) => DataTableRowKey;
+  /** 事件发射器 */
+  emit: any;
+  /** 查看详情回调 */
+  onViewDetail?: (data: T) => void;
+}
+/** useTableActions Hook 返回类型 */
+interface UseTableActionsReturn<T extends DataRecord = DataRecord> {
+  /** 渲染操作列 */
+  renderActions: (rowData: T, rowIndex: number) => VNodeChild;
+  /** 检查操作是否启用 */
+  isActionEnabled: (actionKey: 'edit' | 'delete' | 'detail') => boolean;
+}
+interface BaseOption {
+  label: string;
+  value: string | number;
+  disabled?: boolean;
+}
+interface BaseConfig<T extends DataRecord = DataRecord> {
+  enabled?: boolean;
+  rowCheckable?: (row: T) => boolean;
+}
+type SelectOption = BaseOption;
+interface EditProps {
+  min?: number;
+  max?: number;
+  step?: number;
+  showButton?: boolean;
+  type?: string;
+  rows?: number;
+  placeholder?: string;
+  options?: SelectOption[];
+  rules?: FormItemRule[];
+  format?: string;
+  valueFormat?: string;
+  clearable?: boolean;
+  disabled?: boolean;
+  readonly?: boolean;
+}
+/**
+ * ================= 列类型系统 =================
+ * 说明：
+ * - BaseTableColumn：去除了 naive 的 key/title/render，提供扩展位
+ * - NormalTableColumn：普通数据列，必须有 key + title
+ * - BuiltInTableColumn：内置列（selection/expand），不需要 key/title
+ * - TableColumn：以上二者联合
+ */
+interface BaseTableColumn<T extends DataRecord = DataRecord> extends Omit<DataTableColumns<T>[number], 'key' | 'title' | 'render'> {
+  editable?: boolean;
+  required?: boolean;
+  editType?: EditType;
+  editProps?: EditProps;
+  editRender?: (value: any, rowData: T, rowIndex: number) => VNodeChild;
+  render?: (rowData: T, rowIndex: number) => VNodeChild;
+  fixed?: 'left' | 'right';
+  resizable?: boolean;
+  minWidth?: number;
+  maxWidth?: number;
+}
+interface NormalTableColumn<T extends DataRecord = DataRecord> extends BaseTableColumn<T> {
+  key: keyof T | string;
+  title: string;
+}
+interface BuiltInTableColumn<T extends DataRecord = DataRecord> extends BaseTableColumn<T> {
+  /** 内置列类型：无需 key / title */
+  type: 'selection' | 'expand' | 'index';
+  /** 展开行渲染函数（仅当 type = expand 时有效） */
+  renderExpand?: (rowData: T, rowIndex: number) => VNodeChild;
+}
+type TableColumn<T extends DataRecord = DataRecord> = NormalTableColumn<T> | BuiltInTableColumn<T>;
+interface ChildSelectionState {
+  selectedKeys: DataTableRowKey[];
+  isAllChecked: boolean;
+  selectAll: () => void;
+  clearAll: () => void;
+}
+interface ExpandConfig$1<T extends DataRecord = DataRecord, C = any> {
+  onLoadData?: (row: T) => Promise<C[]> | C[];
+  renderContent?: (row: T, expandData: C[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild;
+  rowExpandable?: (row: T) => boolean;
+}
+interface SelectionConfig$1<T extends DataRecord = DataRecord> extends BaseConfig<T> {
+  enableSelection?: boolean;
+  defaultCheckedKeys?: DataTableRowKey[];
+  maxSelection?: number;
+  enableChildSelection?: boolean;
+  childRowCheckable?: (childRow: any, parentRow: T) => boolean;
+  enableParentChildLink?: boolean;
+  parentChildLinkMode?: ParentChildLinkMode;
+}
+interface TableExpandEvents<T extends DataRecord = DataRecord> {
+  'expand-change': [expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean];
+}
+interface TableSelectionEvents<T extends DataRecord = DataRecord> {
+  'selection-change': [checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>];
+  'child-selection-change': [parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: any[]];
+  'parent-child-link-change': [parentKey: DataTableRowKey, shouldSelect: boolean];
+}
+interface TableEditEvents<T extends DataRecord = DataRecord> {
+  'update:data': [data: T[]];
+  save: [rowData: T, rowIndex: number, columnKey?: string];
+  cancel: [rowData: T, rowIndex: number];
+}
+interface TableEmits<T extends DataRecord = DataRecord> extends TableExpandEvents<T>, TableSelectionEvents<T>, TableEditEvents<T> {
+  'pagination-change': [page: number, pageSize: number];
+  'row-delete': [deletedRow: T, index: number];
+}
+interface UseTableExpandOptions<T extends DataRecord = DataRecord, C = any> extends ExpandConfig$1<T, C>, SelectionConfig$1<T> {
+  data: Ref<T[]> | ComputedRef<T[]>;
+  rowKey: (row: T) => DataTableRowKey;
+  childRowKey?: (child: C) => DataTableRowKey;
+  defaultExpandedKeys?: DataTableRowKey[];
+  onExpandChange?: (expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean) => void;
+  onSelectionChange?: (checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>) => void;
+  onChildSelectionChange?: (parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]) => void;
+}
+interface UseTableExpandReturn<T extends DataRecord = DataRecord, C = any> {
+  expandedKeys: Ref<DataTableRowKey[]>;
+  checkedKeys: Ref<DataTableRowKey[]>;
+  childSelections: Ref<Map<DataTableRowKey, DataTableRowKey[]>>;
+  expandDataMap: Ref<Map<DataTableRowKey, C[]>>;
+  loadingMap: Ref<Map<DataTableRowKey, boolean>>;
+  selectedRowsCount: ComputedRef<number>;
+  totalChildSelections: ComputedRef<number>;
+  expandAll: () => Promise<void>;
+  collapseAll: () => void;
+  expandRow: (key: DataTableRowKey) => Promise<void>;
+  handleExpandChange: (keys: DataTableRowKey[]) => void;
+  selectAll: () => void;
+  clearSelection: () => void;
+  clearAllSelections: () => void;
+  handleSelectionChange: (keys: DataTableRowKey[]) => void;
+  getTableColumns: (originalColumns: TableColumn<T>[]) => any[];
+}
+//#endregion
+//#region src/components/C_Table/composables/usePrintWatermark.d.ts
+interface WatermarkConfig {
+  text: string;
+  textSize?: number;
+  textColor?: string;
+  font?: string;
+  opacity?: number;
+  rotate?: number;
+  position?: "center" | "repeat" | "corner" | "diagonal";
+  xGap?: number;
+  yGap?: number;
+}
+interface CaptureConfig {
+  scale?: number;
+  quality?: number;
+  format?: "png" | "jpeg" | "webp";
+  backgroundColor?: string;
+  logging?: boolean;
+  allowTaint?: boolean;
+  useCORS?: boolean;
+}
+interface PrintConfig {
+  orientation?: "portrait" | "landscape";
+  paperSize?: "A4" | "A3" | "Letter" | string;
+  margin?: string;
+  style?: string;
+  header?: string;
+  footer?: string;
+  showModal?: boolean;
+  modalMessage?: string;
+  onLoadingStart?: () => void;
+  onLoadingEnd?: () => void;
+  onPrintDialogClose?: () => void;
+}
+interface PrintWatermarkOptions {
+  watermark?: WatermarkConfig;
+  capture?: CaptureConfig;
+  print?: PrintConfig;
+}
+declare function drawWatermark(canvas: HTMLCanvasElement, config: WatermarkConfig): HTMLCanvasElement;
+declare function captureElement(element: HTMLElement, config?: CaptureConfig): Promise<HTMLCanvasElement>;
+declare function canvasToDataURL(canvas: HTMLCanvasElement, format?: "png" | "jpeg" | "webp", quality?: number): string;
+declare function downloadCanvas(canvas: HTMLCanvasElement, filename?: string, format?: "png" | "jpeg" | "webp"): void;
+declare function printImage(imageDataURL: string, config?: PrintConfig): Promise<void>;
+declare function usePrintWatermark(): {
+  loading: vue.Ref<boolean, boolean>;
+  progress: vue.Ref<number, number>;
+  captureWithWatermark: (element: HTMLElement, options?: PrintWatermarkOptions) => Promise<string>;
+  printWithWatermark: (element: HTMLElement, options?: PrintWatermarkOptions) => Promise<void>;
+  downloadScreenshot: (element: HTMLElement, filename?: string, options?: PrintWatermarkOptions) => Promise<void>;
+  quickPrint: (element: HTMLElement, watermarkText?: string) => Promise<void>;
+  batchCapture: (elements: HTMLElement[], options?: PrintWatermarkOptions) => Promise<string[]>;
+  batchPrint: (elements: HTMLElement[], options?: PrintWatermarkOptions) => Promise<void>;
+  mergePrint: (elements: HTMLElement[], options?: PrintWatermarkOptions, mergeOptions?: {
+    orientation?: "horizontal" | "vertical";
+    spacing?: number;
+    backgroundColor?: string;
+  }) => Promise<void>;
+  createPreset: (name: string, options: PrintWatermarkOptions) => {
+    use: (element: HTMLElement) => Promise<void>;
+    download: (element: HTMLElement, filename?: string) => Promise<void>;
+  };
+  updateProgress: (value: number) => void;
+  utils: {
+    captureElement: typeof captureElement;
+    drawWatermark: typeof drawWatermark;
+    canvasToDataURL: typeof canvasToDataURL;
+    downloadCanvas: typeof downloadCanvas;
+    printImage: typeof printImage;
+  };
+};
+declare const printPresets: {
+  readonly table: {
+    readonly watermark: {
+      readonly text: "Robot Admin - 数据表格";
+      readonly position: "repeat";
+      readonly textColor: "rgba(100, 100, 100, 0.25)";
+      readonly textSize: 14;
+      readonly xGap: 250;
+      readonly yGap: 120;
+    };
+    readonly capture: {
+      readonly scale: 1.2;
+    };
+    readonly print: {
+      readonly orientation: "landscape";
+      readonly style: "@page { margin: 8mm; } body { font-family: Arial, sans-serif; }";
+    };
+  };
+  readonly form: {
+    readonly watermark: {
+      readonly text: "Robot Admin - 表单数据";
+      readonly position: "diagonal";
+      readonly textColor: "rgba(150, 150, 150, 0.2)";
+      readonly textSize: 16;
+    };
+    readonly print: {
+      readonly orientation: "portrait";
+    };
+  };
+  readonly report: {
+    readonly watermark: {
+      readonly text: "Robot Admin - 机密报告";
+      readonly position: "center";
+      readonly textColor: "rgba(200, 50, 50, 0.15)";
+      readonly textSize: 24;
+    };
+    readonly capture: {
+      readonly quality: 0.95;
+      readonly format: "png";
+    };
+  };
+};
+//#endregion
+//#region src/components/C_Table/composables/useDynamicRow.d.ts
+interface DynamicRowsOptions<T extends DataRecord = DataRecord> {
+  rowKey?: string | ((row: T) => DataTableRowKey$1);
+  defaultRowData?: () => T;
+  enableRadioSelection?: boolean;
+  enableAdd?: boolean;
+  enableInsert?: boolean;
+  enableDelete?: boolean;
+  enableCopy?: boolean;
+  enableMove?: boolean;
+  enablePrint?: boolean;
+  printOptions?: PrintWatermarkOptions;
+  printPreset?: "table" | "form" | "report";
+  printWatermarkText?: string;
+  printTargetSelector?: string;
+  confirmDelete?: boolean;
+  deleteConfirmText?: string;
+  onRowChange?: (data: T[]) => void;
+  onSelectionChange?: (selectedKey: DataTableRowKey$1 | null, selectedRow: T | null) => void;
+  onRowAdd?: (newRow: T) => void;
+  onRowDelete?: (deletedRow: T, index: number) => void;
+  onRowCopy?: (originalRow: T, newRow: T) => void;
+  onRowMove?: (row: T, fromIndex: number, toIndex: number) => void;
+}
+interface DynamicRowsReturn<T extends DataRecord = DataRecord> {
+  selectedRowKey: Ref<DataTableRowKey$1 | null>;
+  selectedRowData: Ref<T | null>;
+  selectedRowIndex: Ref<number>;
+  canMoveUp: Ref<boolean>;
+  canMoveDown: Ref<boolean>;
+  deleteConfirmVisible: Ref<boolean>;
+  printLoading: Ref<boolean>;
+  printProgress: Ref<number>;
+  addRow: () => void;
+  insertRow: () => void;
+  deleteRow: () => void;
+  confirmDelete: () => void;
+  copyRow: () => void;
+  moveRowUp: () => void;
+  moveRowDown: () => void;
+  selectRow: (key: DataTableRowKey$1) => void;
+  clearSelection: () => void;
+  handlePrint: (elementRef: Ref<HTMLElement | undefined>) => Promise<void>;
+  handleDownload: (elementRef: Ref<HTMLElement | undefined>, filename?: string) => Promise<void>;
+  handleQuickPrint: (elementRef: Ref<HTMLElement | undefined>) => Promise<void>;
+  enhanceColumns: (columns: TableColumn<T>[]) => TableColumn<T>[];
+  renderToolbar: () => VNodeChild;
+  renderConfirmModal: () => VNodeChild;
+}
+/**
+ * 表格动态行操作功能组合
+ */
+declare function useDynamicRows<T extends DataRecord = DataRecord>(data: Ref<T[]>, options?: DynamicRowsOptions<T>): DynamicRowsReturn<T>;
+//#endregion
+//#region src/components/C_Table/composables/useTableConfig.d.ts
+/** 可绑定到 C_Table 的 CRUD 对象接口 */
+interface CrudBinding {
+  data: Ref<DataRecord[]>;
+  loading: Ref<boolean>;
+  columns: ComputedRef<TableColumn[]>;
+  actions?: ComputedRef<SimpleTableActions>;
+  pagination?: ComputedRef<PaginationConfig | null>;
+  tableRef?: Ref<unknown>;
+  save?: (...args: unknown[]) => unknown;
+  handleCancel?: () => void;
+  handlePaginationChange?: (page: number, pageSize: number) => void;
+  handleRowDelete?: (...args: unknown[]) => void;
+  detail?: {
+    show: (...args: unknown[]) => void;
+  };
+}
+/** C_Table :config prop 的类型 — 所有功能配置收拢在此 */
+interface TableConfig<T extends DataRecord = DataRecord> {
+  /** 编辑配置 */
+  edit?: EditConfig | boolean;
+  /** 操作按钮 */
+  actions?: SimpleTableActions<T>;
+  /** 分页配置 */
+  pagination?: PaginationConfig | boolean;
+  /** 展开行配置 */
+  expand?: ExpandConfig<T> | boolean;
+  /** 选择配置 */
+  selection?: SelectionConfig<T> | boolean;
+  /** 动态行配置 */
+  dynamicRows?: DynamicRowsOptions<T> | boolean;
+  /** 工具栏 */
+  toolbar?: ToolbarConfig;
+  /** 表格显示属性 */
+  display?: DisplayConfig;
+}
+interface EditConfig {
+  enabled?: boolean;
+  mode?: "row" | "cell" | "modal" | "both" | "none";
+  showRowActions?: boolean;
+  modalTitle?: string;
+  modalWidth?: number;
+}
+interface ExpandConfig<T extends DataRecord = DataRecord> {
+  enabled?: boolean;
+  defaultExpandedKeys?: DataTableRowKey$1[];
+  onLoadData?: (row: T) => Promise<unknown[]> | unknown[];
+  renderContent?: (row: T, expandData: unknown[], loading: boolean, childSelection?: unknown) => VNodeChild;
+  rowExpandable?: (row: T) => boolean;
+}
+interface SelectionConfig<T extends DataRecord = DataRecord> {
+  enabled?: boolean;
+  defaultCheckedKeys?: naive_ui_es0.DataTableRowKey[];
+  rowCheckable?: (row: T) => boolean;
+  maxSelection?: number;
+  childSelection?: {
+    enabled?: boolean;
+    childRowCheckable?: (childRow: unknown, parentRow: T) => boolean;
+  };
+  parentChildLink?: {
+    enabled?: boolean;
+    mode?: ParentChildLinkMode;
+  };
+}
+interface ToolbarConfig {
+  /** 是否显示工具栏 */
+  show?: boolean;
+  /** 是否启用列设置 */
+  columnSettings?: boolean;
+}
+interface DisplayConfig {
+  striped?: boolean;
+  bordered?: boolean;
+  singleLine?: boolean;
+  size?: "small" | "medium" | "large";
+  maxHeight?: number | string;
+  scrollX?: number | string;
+  columnWidth?: number;
+}
+interface ResolvedConfig {
+  editable: boolean;
+  editMode: string;
+  showRowActions: boolean;
+  modalTitle: string;
+  modalWidth: number;
+  expandable: boolean;
+  defaultExpandedKeys: DataTableRowKey$1[] | undefined;
+  onLoadExpandData: ((row: DataRecord) => Promise<unknown[]> | unknown[]) | undefined;
+  renderExpandContent: ((row: DataRecord, expandData: unknown[], loading: boolean, childSelection?: unknown) => VNodeChild) | undefined;
+  rowExpandable: ((row: DataRecord) => boolean) | undefined;
+  enableSelection: boolean;
+  defaultCheckedKeys: DataTableRowKey$1[] | undefined;
+  rowCheckable: ((row: DataRecord) => boolean) | undefined;
+  maxSelection: number | undefined;
+  enableChildSelection: boolean;
+  childRowCheckable: ((childRow: unknown, parentRow: DataRecord) => boolean) | undefined;
+  enableParentChildLink: boolean;
+  parentChildLinkMode: ParentChildLinkMode;
+  pagination: PaginationConfig | null;
+  dynamicRows: DynamicRowsOptions<DataRecord> | undefined;
+  striped: boolean;
+  bordered: boolean;
+  singleLine: boolean;
+  size: string;
+  maxHeight: number | string | undefined;
+  scrollX: number | string | undefined;
+  columnWidth: number;
+  showToolbar: boolean;
+  enableColumnSettings: boolean;
+}
+/**
+ * 将 config 单一对象解析为内部扁平化配置
+ */
+declare function resolveConfig(config?: TableConfig): ResolvedConfig;
+declare const createEditModeChecker: (config: ResolvedConfig) => {
+  isNonEditable: (column: TableColumn) => boolean;
+  isRowEditMode: () => boolean;
+  isCellEditMode: () => boolean;
+};
+//#endregion
+//#region src/components/C_Table/index.vue.d.ts
+type __VLS_Props = {
+  /** 列配置（crud 模式下可省略） */columns?: TableColumn[]; /** 数据源（crud 模式下可省略） */
+  data?: MaybeRefLike<DataRecord[]>; /** 加载状态 */
+  loading?: MaybeRefLike<boolean>; /** 行唯一键 */
+  rowKey?: (row: DataRecord) => DataTableRowKey$1; /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
+  config?: TableConfig; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
+  crud?: CrudBinding;
+};
+declare var __VLS_6: {}, __VLS_8: {};
+type __VLS_Slots = {} & {
+  'toolbar-left'?: (props: typeof __VLS_6) => any;
+} & {
+  'toolbar-right'?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
+  startEdit: (rowKey: DataTableRowKey$1, columnKey?: string) => void;
+  expandAll: () => Promise<void>;
+  collapseAll: () => void;
+  selectAll: () => void;
+  clearSelection: () => void;
+  clearAllSelections: () => void;
+  clearRowSelection: () => void;
+  resetToFirstPage: () => void;
+  getSelectedRows: () => DataRecord[];
+  getEditingData: () => vue.Ref<Record<string, any>, Record<string, any>> | DataRecord | null;
+  isEditing: (rowKey: DataTableRowKey$1, columnKey?: string) => boolean;
+  isExpanded: (rowKey: DataTableRowKey$1) => boolean;
+  getManager: () => {
+    edit: {
+      start(rowKey: DataTableRowKey$1, columnKey?: string): void;
+      cancel(): void;
+      save(): Promise<void>;
+      isEditing(rowKey: DataTableRowKey$1, columnKey?: string): boolean;
+      getEditingData(): vue.Ref<Record<string, any>, Record<string, any>> | DataRecord | null;
+    };
+    expand: {
+      row(rowKey: DataTableRowKey$1): Promise<void>;
+      collapse(rowKey: DataTableRowKey$1): void;
+      toggle(rowKey: DataTableRowKey$1): Promise<void>;
+      all(): Promise<void>;
+      collapseAll(): void;
+      isExpanded(rowKey: DataTableRowKey$1): boolean;
+    };
+    selection: {
+      select(rowKey: DataTableRowKey$1): void;
+      unselect(rowKey: DataTableRowKey$1): void;
+      all(): void;
+      clear(): void;
+      isSelected(rowKey: DataTableRowKey$1): boolean;
+      getSelected(): DataRecord[];
+    };
+    childSelection: {
+      select(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void;
+      unselect(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void;
+      selectAll(parentKey: DataTableRowKey$1): void;
+      clear(parentKey: DataTableRowKey$1): void;
+      getSelected(parentKey: DataTableRowKey$1): DataRecord[];
+    };
+    dynamicRows: {
+      add(): void;
+      insert(): void;
+      delete(): void;
+      copy(): void;
+      moveUp(): void;
+      moveDown(): void;
+      clearSelection(): void;
+      getSelected(): DataRecord | null;
+      print(elementRef?: HTMLElement): Promise<void>;
+      download(elementRef?: HTMLElement, filename?: string): Promise<void>;
+    };
+    clearAllSelections(): void;
+  };
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  cancel: (rowData: DataRecord, rowIndex: number) => any;
+  save: (rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any;
+  "pagination-change": (...args: unknown[]) => any;
+  "row-delete": (...args: unknown[]) => any;
+  "expand-change": (expandedKeys: DataTableRowKey$1[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any;
+  "selection-change": (checkedKeys: DataTableRowKey$1[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey$1, DataTableRowKey$1[]> | undefined) => any;
+  "child-selection-change": (parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: any[]) => any;
+  "parent-child-link-change": (parentKey: DataTableRowKey$1, shouldSelect: boolean) => any;
+  "update:data": (data: DataRecord[]) => any;
+  "row-add": (newRow: DataRecord) => any;
+  "row-copy": (originalRow: DataRecord, newRow: DataRecord) => any;
+  "row-move": (row: DataRecord, fromIndex: number, toIndex: number) => any;
+  "row-selection-change": (selectedKey: DataTableRowKey$1 | null, selectedRow: DataRecord | null) => any;
+  "view-detail": (data: DataRecord) => any;
+  "column-change": (columns: TableColumn[]) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  onCancel?: ((rowData: DataRecord, rowIndex: number) => any) | undefined;
+  onSave?: ((rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any) | undefined;
+  "onPagination-change"?: ((...args: unknown[]) => any) | undefined;
+  "onRow-delete"?: ((...args: unknown[]) => any) | undefined;
+  "onExpand-change"?: ((expandedKeys: DataTableRowKey$1[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any) | undefined;
+  "onSelection-change"?: ((checkedKeys: DataTableRowKey$1[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey$1, DataTableRowKey$1[]> | undefined) => any) | undefined;
+  "onChild-selection-change"?: ((parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: any[]) => any) | undefined;
+  "onParent-child-link-change"?: ((parentKey: DataTableRowKey$1, shouldSelect: boolean) => any) | undefined;
+  "onUpdate:data"?: ((data: DataRecord[]) => any) | undefined;
+  "onRow-add"?: ((newRow: DataRecord) => any) | undefined;
+  "onRow-copy"?: ((originalRow: DataRecord, newRow: DataRecord) => any) | undefined;
+  "onRow-move"?: ((row: DataRecord, fromIndex: number, toIndex: number) => any) | undefined;
+  "onRow-selection-change"?: ((selectedKey: DataTableRowKey$1 | null, selectedRow: DataRecord | null) => any) | undefined;
+  "onView-detail"?: ((data: DataRecord) => any) | undefined;
+  "onColumn-change"?: ((columns: TableColumn[]) => any) | undefined;
+}>, {
+  loading: MaybeRefLike<boolean>;
+  config: TableConfig;
+  rowKey: (row: DataRecord) => DataTableRowKey$1;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+}; //# sourceMappingURL=index.vue.d.ts.map
+//#endregion
+//#region src/components/C_Table/composables/useTableColumns.d.ts
+/** useTableColumns 中对 tableManager 的最小依赖接口 */
+interface TableManagerRef {
+  editStates: {
+    cellEdit: {
+      isEditingCell: (rowKey: DataTableRowKey$1, columnKey: string) => boolean;
+      getEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string) => unknown;
+      updateEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string, value: unknown) => void;
+      saveEditCell: () => Promise<unknown>;
+      cancelEditCell: () => void;
+      startEditCell: (rowKey: DataTableRowKey$1, columnKey: string) => void;
+    };
+    rowEdit: {
+      isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
+      getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord | undefined;
+      updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
+    };
+  };
+  dynamicRowsState?: {
+    enhanceColumns: (columns: TableColumn[]) => TableColumn[];
+  } | null;
+  expandState?: {
+    getTableColumns: (originalColumns: TableColumn[]) => DataTableColumn[];
+  } | null;
+}
+/**
+ * 渲染编辑组件（行编辑/单元格编辑通用）
+ */
+interface UseTableColumnsOptions {
+  /** 原始列配置 */
+  rawColumns: ComputedRef<TableColumn[]>;
+  /** 统一配置 */
+  config: ComputedRef<ResolvedConfig>;
+  /** 默认列宽 */
+  columnWidth: number;
+  /** 用户设定的 scrollX */
+  scrollX?: number | string;
+  /** 行键获取函数 */
+  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  /** 表格管理器 */
+  tableManager: TableManagerRef;
+  /** 操作列渲染函数 */
+  actionsRenderer: (row: DataRecord, index: number) => VNodeChild;
+  /** 编辑模式检查器 */
+  editModeChecker: ComputedRef<{
+    isNonEditable: (column: TableColumn) => boolean;
+    isRowEditMode: () => boolean;
+    isCellEditMode: () => boolean;
+  }>;
+}
+interface UseTableColumnsReturn {
+  reactiveColumns: Ref<TableColumn[]>;
+  showSettingsPanel: Ref<boolean>;
+  computedColumns: ComputedRef<DataTableColumn[]>;
+  computedScrollX: ComputedRef<number | string | undefined>;
+  handleColumnChange: (columns: TableColumn[]) => void;
+}
+/**
+ * 表格列处理引擎
+ */
+declare function useTableColumns(options: UseTableColumnsOptions): UseTableColumnsReturn;
+//#endregion
+//#region src/components/C_Table/composables/useTableManager.d.ts
+/**
+ * 表格管理器配置接口
+ */
+interface TableManagerConfig {
+  editable: boolean;
+  editMode: string;
+  showRowActions: boolean;
+  modalTitle: string;
+  modalWidth: number;
+  expandable: boolean;
+  defaultExpandedKeys?: DataTableRowKey$1[];
+  onLoadExpandData?: (row: DataRecord) => Promise<any[]> | any[];
+  renderExpandContent?: unknown;
+  rowExpandable?: (row: DataRecord) => boolean;
+  enableSelection: boolean;
+  defaultCheckedKeys?: DataTableRowKey$1[];
+  rowCheckable?: (row: DataRecord) => boolean;
+  maxSelection?: number;
+  enableChildSelection: boolean;
+  childRowCheckable?: (childRow: DataRecord, parentRow: DataRecord) => boolean;
+  enableParentChildLink: boolean;
+  parentChildLinkMode: ParentChildLinkMode;
+  dynamicRows?: DynamicRowsOptions<DataRecord>;
+}
+/**
+ * 表格管理器参数接口
+ */
+interface TableManagerParams {
+  config: TableManagerConfig;
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  emit: (...args: unknown[]) => void;
+}
+/**
+ * 事件处理器接口
+ */
+interface EventHandlers {
+  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string) => Promise<void>;
+  onCancel: (rowData: DataRecord, rowIndex: number) => void;
+  onExpandChange: (keys: DataTableRowKey$1[], row?: DataRecord, expanded?: boolean) => void;
+  onSelectionChange: (checkedKeys: DataTableRowKey$1[], checkedRows: DataRecord[], childSelections: Map<DataTableRowKey$1, DataTableRowKey$1[]>) => void;
+  onChildSelectionChange: (parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: DataRecord[]) => void;
+  onRowChange: (data: DataRecord[]) => void;
+  onRowSelectionChange: (selectedKey: DataTableRowKey$1 | null, selectedRow: DataRecord | null) => void;
+  onRowAdd: (newRow: DataRecord) => void;
+  onRowDelete: (deletedRow: DataRecord, index: number) => void;
+  onRowCopy: (originalRow: DataRecord, newRow: DataRecord) => void;
+  onRowMove: (row: DataRecord, fromIndex: number, toIndex: number) => void;
+}
+/**
+ * 表格统一状态管理器
+ */
+declare function useTableManager(params: TableManagerParams): {
+  editStates: {
+    rowEdit: {
+      editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+      isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
+      startEditRow: (rowKey: DataTableRowKey$1) => void;
+      cancelEditRow: () => Promise<void>;
+      saveEditRow: () => Promise<{
+        updatedData: DataRecord;
+        rowIndex: number;
+      } | undefined>;
+      getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord;
+      updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
+      findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+    };
+    cellEdit: {
+      editingCell: vue.Ref<{
+        rowKey: DataTableRowKey$1 | null;
+        columnKey: string | null;
+      }, {
+        rowKey: DataTableRowKey$1 | null;
+        columnKey: string | null;
+      } | {
+        rowKey: DataTableRowKey$1 | null;
+        columnKey: string | null;
+      }>;
+      isEditingCell: (rowKey: DataTableRowKey$1, columnKey: string) => boolean;
+      startEditCell: (rowKey: DataTableRowKey$1, columnKey: string) => void;
+      saveEditCell: () => Promise<{
+        updatedData: {
+          [x: string]: unknown;
+        };
+        rowIndex: number;
+        columnKey: string;
+      } | undefined>;
+      cancelEditCell: () => void;
+      getEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string) => unknown;
+      updateEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string, value: unknown) => void;
+      findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+    };
+    modalEdit: {
+      isModalVisible: vue.Ref<boolean, boolean>;
+      editingData: vue.Ref<Record<string, any>, Record<string, any>>;
+      editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+      editingRowIndex: vue.ComputedRef<number>;
+      startEdit: (rowKey: DataTableRowKey$1) => void;
+      saveEdit: (formData?: Record<string, any>) => Promise<void>;
+      cancelEdit: () => Promise<void>;
+      updateEditingData: (data: Record<string, any>) => void;
+      resetEditingState: () => void;
+      isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
+      getEditingRowData: (rowKey: DataTableRowKey$1) => Record<string, any> | null;
+    };
+  };
+  expandState: UseTableExpandReturn<DataRecord, DataRecord> | null;
+  dynamicRowsState: DynamicRowsReturn<DataRecord> | null;
+  stateManager: {
+    edit: {
+      /** 开始编辑 */start(rowKey: DataTableRowKey$1, columnKey?: string): void; /** 取消编辑 */
+      cancel(): void; /** 保存编辑 */
+      save(): Promise<void>; /** 是否正在编辑 */
+      isEditing(rowKey: DataTableRowKey$1, columnKey?: string): boolean; /** 获取当前编辑数据 */
+      getEditingData(): vue.Ref<Record<string, any>, Record<string, any>> | DataRecord | null;
+    };
+    expand: {
+      /** 展开行 */row(rowKey: DataTableRowKey$1): Promise<void>; /** 折叠行 */
+      collapse(rowKey: DataTableRowKey$1): void; /** 展开折叠切换 */
+      toggle(rowKey: DataTableRowKey$1): Promise<void>; /** 展开所有行 */
+      all(): Promise<void>; /** 折叠所有行 */
+      collapseAll(): void; /** 检查行是否已展开 */
+      isExpanded(rowKey: DataTableRowKey$1): boolean;
+    };
+    selection: {
+      /** 选择指定行 */select(rowKey: DataTableRowKey$1): void; /** 取消选择指定行 */
+      unselect(rowKey: DataTableRowKey$1): void; /** 选择所有行 */
+      all(): void; /** 清除所有行选择 */
+      clear(): void; /** 检查行是否已选择 */
+      isSelected(rowKey: DataTableRowKey$1): boolean; /** 获取所有已选择的行数据 */
+      getSelected(): DataRecord[];
+    };
+    childSelection: {
+      /** 选择指定父行下的子行 */select(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void; /** 取消选择指定父行下的子行 */
+      unselect(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void; /** 选择指定父行下的所有子行 */
+      selectAll(parentKey: DataTableRowKey$1): void; /** 清除指定父行下的所有子行选择 */
+      clear(parentKey: DataTableRowKey$1): void; /** 获取指定父行下所有已选择的子行数据 */
+      getSelected(parentKey: DataTableRowKey$1): DataRecord[];
+    };
+    dynamicRows: {
+      /** 添加行 */add(): void; /** 插入行 */
+      insert(): void; /** 删除行 */
+      delete(): void; /** 复制行 */
+      copy(): void; /** 上移动态行 */
+      moveUp(): void; /** 下移动态行 */
+      moveDown(): void; /** 清空动态行数据 */
+      clearSelection(): void; /** 获取当前选中的动态行数据 */
+      getSelected(): DataRecord | null; /** 打印表格 */
+      print(elementRef?: HTMLElement): Promise<void>; /** 导出表格数据 */
+      download(elementRef?: HTMLElement, filename?: string): Promise<void>;
+    }; /** 清除所有选择 */
+    clearAllSelections(): void;
+  };
+  expandedKeys: vue.ComputedRef<DataTableRowKey$1[]>;
+  checkedKeys: vue.ComputedRef<DataTableRowKey$1[]>;
+  eventHandlers: EventHandlers;
+};
+//#endregion
+//#region src/components/C_Table/composables/useTableExpand.d.ts
+declare function useTableExpand<T extends DataRecord = Record<string, any>, C = any>(options: UseTableExpandOptions<T, C>): UseTableExpandReturn<T, C>;
+//#endregion
+//#region src/components/C_Table/composables/useTableActions.d.ts
+/**
+ * 表格操作Hook
+ */
+declare function useTableActions<T extends DataRecord = DataRecord>(options: UseTableActionsOptions<T>): UseTableActionsReturn<T>;
+//#endregion
+//#region src/components/C_Table/composables/usePagination.d.ts
+interface UsePaginationOptions<T extends DataRecord = DataRecord> {
+  /** 数据源 - 支持函数、Ref 或 ComputedRef */
+  data: (() => T[]) | Ref<T[]> | ComputedRef<T[]>;
+  /** 分页配置 */
+  config: Ref<PaginationConfig | null> | ComputedRef<PaginationConfig | null>;
+  /** 事件触发器 */
+  emit?: (event: "pagination-change", page: number, pageSize: number) => void;
+}
+interface UsePaginationReturn<T extends DataRecord = DataRecord> {
+  currentPage: Ref<number>;
+  currentPageSize: Ref<number>;
+  paginatedData: ComputedRef<T[]>;
+  paginationConfig: ComputedRef<any>;
+  handlePageChange: (page: number) => void;
+  handlePageSizeChange: (pageSize: number) => void;
+  resetToFirstPage: () => void;
+  getTotalPages: () => number;
+}
+declare function usePagination<T extends DataRecord = DataRecord>(options: UsePaginationOptions<T>): UsePaginationReturn<T>;
+//#endregion
+//#region src/components/C_Table/composables/useRowEdit.d.ts
+/**
+ * 行编辑配置选项
+ */
+interface RowEditOptions {
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => void;
+}
+/**
+ * 可编辑行组合函数，提供表格整行的编辑功能
+ */
+declare function useRowEdit(options: RowEditOptions): {
+  editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+  isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
+  startEditRow: (rowKey: DataTableRowKey$1) => void;
+  cancelEditRow: () => Promise<void>;
+  saveEditRow: () => Promise<{
+    updatedData: DataRecord;
+    rowIndex: number;
+  } | undefined>;
+  getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord;
+  updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
+  findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+};
+//#endregion
+//#region src/components/C_Table/composables/useCellEdit.d.ts
+/**
+ * 单元格编辑配置选项
+ */
+interface CellEditOptions {
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string) => void | Promise<void>;
+}
+/**
+ * 可编辑单元格组合函数，提供表格单元格的编辑功能
+ */
+declare function useCellEdit(options: CellEditOptions): {
+  editingCell: vue.Ref<{
+    rowKey: DataTableRowKey$1 | null;
+    columnKey: string | null;
+  }, {
+    rowKey: DataTableRowKey$1 | null;
+    columnKey: string | null;
+  } | {
+    rowKey: DataTableRowKey$1 | null;
+    columnKey: string | null;
+  }>;
+  isEditingCell: (rowKey: DataTableRowKey$1, columnKey: string) => boolean;
+  startEditCell: (rowKey: DataTableRowKey$1, columnKey: string) => void;
+  saveEditCell: () => Promise<{
+    updatedData: {
+      [x: string]: unknown;
+    };
+    rowIndex: number;
+    columnKey: string;
+  } | undefined>;
+  cancelEditCell: () => void;
+  getEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string) => unknown;
+  updateEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string, value: unknown) => void;
+  findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+};
+//#endregion
+//#region src/components/C_Table/composables/useModalEdit.d.ts
+/**
+ * 模态框编辑配置选项
+ */
+interface ModalEditOptions<T = Record<string, any>> {
+  data: () => T[];
+  rowKey: (row: T) => DataTableRowKey$1;
+  onSave?: (editingData: Record<string, any>, rowIndex: number) => void | Promise<void>;
+  onCancel?: (originalData: T, rowIndex: number) => void | Promise<void>;
+}
+/**
+ * 模态框编辑组合函数，提供弹窗形式的数据编辑功能
+ */
+declare function useModalEdit<T = Record<string, any>>(options: ModalEditOptions<T>): {
+  isModalVisible: vue.Ref<boolean, boolean>;
+  editingData: vue.Ref<Record<string, any>, Record<string, any>>;
+  editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+  editingRowIndex: vue.ComputedRef<number>;
+  startEdit: (rowKey: DataTableRowKey$1) => void;
+  saveEdit: (formData?: Record<string, any>) => Promise<void>;
+  cancelEdit: () => Promise<void>;
+  updateEditingData: (data: Record<string, any>) => void;
+  resetEditingState: () => void;
+  isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
+  getEditingRowData: (rowKey: DataTableRowKey$1) => Record<string, any> | null;
+};
+//#endregion
+export { MaybeRefLike as C, TableEmits as D, TableColumn as E, UseTableExpandOptions as O, EditMode as S, ParentChildLinkMode as T, PrintWatermarkOptions as _, useTableActions as a, ChildSelectionState as b, useTableColumns as c, TableConfig as d, createEditModeChecker as f, useDynamicRows as g, DynamicRowsReturn as h, usePagination as i, UseTableExpandReturn as k, _default as l, DynamicRowsOptions as m, useCellEdit as n, useTableExpand as o, resolveConfig as p, useRowEdit as r, useTableManager as s, useModalEdit as t, CrudBinding as u, printPresets as v, PaginationConfig as w, DataRecord as x, usePrintWatermark as y };
+//# sourceMappingURL=useModalEdit.d.ts.map