@vueye-table/headless 3.0.0-alpha.1 → 3.0.0-alpha.11

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { AnyDataTableBinding, DataGridBinding, DataTableBinding } from "@vueye-table/vue";
-import { PropType, SlotsType, VNode, VNodeChild } from "vue";
-import { GridDirection, PageItem, SelectionCoverage, SortInfo, TableColumn, TableRow } from "@vueye-table/core";
+import { AnyDataTableBinding, DataGridBinding, DataTableBinding, RowDraft, VirtualBinding, VirtualColumnItem, VirtualRowItem } from "@vueye-table/vue";
+import { PropType, SlotsType, VNode, VNodeChild, shallowRef } from "vue";
+import { EditResult, EditorSpec, LoadState, PageItem, RowKey, SelectionCoverage, SortInfo, TableColumn, TableIssue, TableRow } from "@vueye-table/core";
 //#region src/controls.d.ts
 /**
  * Selects or clears every row in the table's select-all scope. It shows the indeterminate state
@@ -56,6 +56,7 @@ declare const DataTableSelectRow: import("vue").DefineComponent<import("vue").Ex
 }, SlotsType<{
   default?: (props: {
     selected: boolean;
+    indeterminate: boolean;
     toggle: () => void;
   }) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -197,6 +198,21 @@ declare const DataTableColumnVisibility: import("vue").DefineComponent<import("v
  * A polite live region describing what is shown, such as "1–10 of 57 rows". Screen readers
  * announce it after a search, filter, or page change.
  */
+interface TableStatusSlotProps {
+  readonly start: number;
+  readonly end: number;
+  readonly rowCount: number;
+  readonly totalRowCount: number;
+  readonly selectedCount: number;
+  readonly loadState: LoadState;
+  readonly loadedRowCount: number;
+  readonly loadError: TableIssue | undefined;
+  readonly canLoadMore: boolean;
+  readonly retry: () => void;
+  readonly loadNext: () => Promise<void>;
+  readonly loadingChildrenCount: number;
+  readonly childErrorCount: number;
+}
 declare const DataTableStatus: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   as: {
     readonly type: StringConstructor;
@@ -212,19 +228,531 @@ declare const DataTableStatus: import("vue").DefineComponent<import("vue").Extra
 }>> & Readonly<{}>, {
   as: string;
 }, SlotsType<{
-  default?: (props: {
-    start: number;
-    end: number;
-    rowCount: number;
-    totalRowCount: number;
-    selectedCount: number;
-  }) => VNode[];
+  default?: (props: TableStatusSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
+//#region src/loading.d.ts
+/** A keyboard-accessible alternative to automatic virtual-end loading, with error recovery. */
+declare const DataTableLoadMore: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  label: {
+    type: StringConstructor;
+    default: string;
+  };
+  retryLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+  loadingLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  label: {
+    type: StringConstructor;
+    default: string;
+  };
+  retryLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+  loadingLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  label: string;
+  retryLabel: string;
+  loadingLabel: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/editor.d.ts
+/** Shared by native editors and application-owned editor slots. */
+interface CellEditorSlotProps {
+  readonly row: TableRow<unknown>;
+  readonly column: TableColumn<unknown>;
+  readonly value: unknown;
+  readonly draft: string;
+  readonly spec: EditorSpec;
+  readonly finish: (direction?: "up" | "down" | "left" | "right") => void;
+  readonly input: (text: string) => void;
+  /** Alias retained for existing headless grid slots. */
+  readonly update: (text: string) => void;
+  /** Strings pass through parse; typed values use core's value-edit path. */
+  readonly commit: (value?: unknown) => EditResult<unknown> | Promise<EditResult<unknown>> | undefined;
+  readonly cancel: () => void;
+  readonly issues: readonly TableIssue[];
+  readonly pending: boolean;
+  /** Bind to a custom field to associate its validation message. */
+  readonly attrs: Readonly<Record<string, string | undefined>>;
+}
+declare const cellEditorProps: {
+  readonly editor: {
+    readonly type: PropType<CellEditorSlotProps>;
+    readonly required: true;
+  };
+  readonly spec: {
+    readonly type: PropType<EditorSpec>;
+    readonly default: () => {
+      kind: string;
+    };
+  };
+  /** Keyboard movement is owned by the surrounding cell. */
+  readonly finish: {
+    readonly type: PropType<((direction?: "up" | "down" | "left" | "right") => void) | undefined>;
+    readonly default: undefined;
+  };
+  readonly autofocus: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+  readonly blurCommit: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+  readonly tabCommit: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+};
+/** Plain native fields. Select results are searched and capped at 50 mounted options. */
+declare const DataCellEditor: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  readonly editor: {
+    readonly type: PropType<CellEditorSlotProps>;
+    readonly required: true;
+  };
+  readonly spec: {
+    readonly type: PropType<EditorSpec>;
+    readonly default: () => {
+      kind: string;
+    };
+  };
+  /** Keyboard movement is owned by the surrounding cell. */
+  readonly finish: {
+    readonly type: PropType<((direction?: "up" | "down" | "left" | "right") => void) | undefined>;
+    readonly default: undefined;
+  };
+  readonly autofocus: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+  readonly blurCommit: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+  readonly tabCommit: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  readonly editor: {
+    readonly type: PropType<CellEditorSlotProps>;
+    readonly required: true;
+  };
+  readonly spec: {
+    readonly type: PropType<EditorSpec>;
+    readonly default: () => {
+      kind: string;
+    };
+  };
+  /** Keyboard movement is owned by the surrounding cell. */
+  readonly finish: {
+    readonly type: PropType<((direction?: "up" | "down" | "left" | "right") => void) | undefined>;
+    readonly default: undefined;
+  };
+  readonly autofocus: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+  readonly blurCommit: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+  readonly tabCommit: {
+    readonly type: BooleanConstructor;
+    readonly default: true;
+  };
+}>> & Readonly<{}>, {
+  readonly spec: EditorSpec;
+  readonly finish: ((direction?: "up" | "down" | "left" | "right") => void) | undefined;
+  readonly autofocus: boolean;
+  readonly blurCommit: boolean;
+  readonly tabCommit: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
 //#region src/shared.d.ts
 /** Columns of any row type; callbacks on a column make `TableColumn<unknown>` too narrow. */
 type AnyTableColumn = TableColumn<any>;
 //#endregion
+//#region src/editing.d.ts
+interface EditingContext {
+  readonly grid: DataGridBinding<unknown>;
+  readonly mode: "cell" | "row";
+  readonly draft: RowDraft<unknown> | undefined;
+  start(row: TableRow<unknown>): void;
+  save(): Promise<EditResult<unknown> | undefined>;
+  cancel(key: RowKey): void;
+}
+/** Renderless provider for editable data-table cells and row forms. */
+declare const DataTableEditRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  table: {
+    type: PropType<AnyDataTableBinding>;
+    required: true;
+  };
+  mode: {
+    type: PropType<"cell" | "row">;
+    default: string;
+  };
+}>, () => VNodeChild, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  save: (_result: EditResult<unknown>) => true;
+  cancel: (_key: RowKey) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  table: {
+    type: PropType<AnyDataTableBinding>;
+    required: true;
+  };
+  mode: {
+    type: PropType<"cell" | "row">;
+    default: string;
+  };
+}>> & Readonly<{
+  onCancel?: (_key: RowKey) => any;
+  onSave?: (_result: EditResult<unknown>) => any;
+}>, {
+  mode: "row" | "cell";
+}, SlotsType<{
+  default?: (props: {
+    editing: EditingContext;
+  }) => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** A cell with on-demand editing; row mode shares one draft and one save operation. */
+declare const DataTableEditCell: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  column: {
+    readonly type: PropType<AnyTableColumn>;
+    readonly required: true;
+  };
+  rowIndex: {
+    type: PropType<number | undefined>;
+    default: undefined;
+  };
+  tree: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  save: (_result: EditResult<unknown>) => true;
+  cancel: (_key: RowKey) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  column: {
+    readonly type: PropType<AnyTableColumn>;
+    readonly required: true;
+  };
+  rowIndex: {
+    type: PropType<number | undefined>;
+    default: undefined;
+  };
+  tree: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>> & Readonly<{
+  onCancel?: (_key: RowKey) => any;
+  onSave?: (_result: EditResult<unknown>) => any;
+}>, {
+  rowIndex: number | undefined;
+  tree: boolean;
+}, SlotsType<{
+  default?: (props: {
+    row: TableRow<unknown>;
+    value: unknown;
+    display: string;
+  }) => VNodeChild;
+  editor?: (props: CellEditorSlotProps) => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** One active row form. Controls share the provider's draft and core save/undo path. */
+declare const DataTableRowActions: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  editable: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  removable: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  editable: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  removable: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>> & Readonly<{}>, {
+  editable: boolean;
+  removable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/virtual.d.ts
+interface ComponentVirtualOptions {
+  readonly rowHeight?: number | ((index: number) => number) | undefined;
+  readonly overscan?: number | undefined;
+  readonly initialCount?: number | undefined;
+  readonly columnWidth?: number | undefined;
+  readonly columnOverscan?: number | undefined;
+  readonly initialColumnCount?: number | undefined;
+}
+/** Shared opt-in renderer props. Options are applied when the virtual renderer is created. */
+declare const virtualProps: {
+  readonly virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  readonly height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  readonly rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  readonly overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  readonly virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  readonly columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
+};
+interface ComponentVirtualBinding {
+  readonly rows: VirtualBinding<VirtualRowItem<unknown>>;
+  readonly columns: VirtualBinding<VirtualColumnItem<unknown>> | undefined;
+  readonly rowItems: readonly VirtualRowItem<unknown>[];
+  readonly columnItems: readonly VirtualColumnItem<unknown>[] | undefined;
+  readonly gutter: number;
+}
+declare function injectVirtual(): ComponentVirtualBinding | undefined;
+/** A scroll container for a headless table/grid. It supplies its element without global reads. */
+declare const DataTableViewport: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  as: {
+    readonly type: StringConstructor;
+    readonly default: string;
+  };
+  height: {
+    type: StringConstructor;
+    default: string;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  as: {
+    readonly type: StringConstructor;
+    readonly default: string;
+  };
+  height: {
+    type: StringConstructor;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  as: string;
+  height: string;
+}, SlotsType<{
+  default?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/hierarchy.d.ts
+declare const hierarchyProps: {
+  readonly treeColumn: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  readonly keepAliveDetail: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+};
+declare function resolveTreeColumn(table: AnyDataTableBinding, column?: string): string | undefined;
+declare const expandToggleProps: {
+  readonly row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  readonly controls: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  readonly expandLabel: {
+    readonly type: StringConstructor;
+    readonly default: "Expand row";
+  };
+  readonly collapseLabel: {
+    readonly type: StringConstructor;
+    readonly default: "Collapse row";
+  };
+};
+declare const treeCellProps: {
+  readonly row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  readonly as: {
+    readonly type: StringConstructor;
+    readonly default: string;
+  };
+};
+declare const DataTableExpandToggle: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  readonly row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  readonly controls: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  readonly expandLabel: {
+    readonly type: StringConstructor;
+    readonly default: "Expand row";
+  };
+  readonly collapseLabel: {
+    readonly type: StringConstructor;
+    readonly default: "Collapse row";
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  readonly row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  readonly controls: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  readonly expandLabel: {
+    readonly type: StringConstructor;
+    readonly default: "Expand row";
+  };
+  readonly collapseLabel: {
+    readonly type: StringConstructor;
+    readonly default: "Collapse row";
+  };
+}>> & Readonly<{}>, {
+  readonly controls: string | undefined;
+  readonly expandLabel: string;
+  readonly collapseLabel: string;
+}, SlotsType<{
+  default?: (props: {
+    row: TableRow<unknown>;
+    expanded: boolean;
+  }) => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const DataTableTreeCell: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  readonly row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  readonly as: {
+    readonly type: StringConstructor;
+    readonly default: string;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  readonly row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  readonly as: {
+    readonly type: StringConstructor;
+    readonly default: string;
+  };
+}>> & Readonly<{}>, {
+  readonly as: string;
+}, SlotsType<{
+  default?: () => VNodeChild;
+  toggle?: (props: {
+    row: TableRow<unknown>;
+  }) => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** One full-width detail; retained collapsed content remains hidden and unmeasured. */
+declare const DataTableDetailRow: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  colspan: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+  hidden: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  keepAlive: {
+    type: PropType<boolean | undefined>;
+    default: undefined;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  row: {
+    readonly type: PropType<TableRow<unknown>>;
+    readonly required: true;
+  };
+  colspan: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+  hidden: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  keepAlive: {
+    type: PropType<boolean | undefined>;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  colspan: number;
+  hidden: boolean;
+  keepAlive: boolean | undefined;
+}, SlotsType<{
+  default?: (props: {
+    row: TableRow<unknown>;
+  }) => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+interface DetailSlotProps {
+  readonly row: TableRow<unknown>;
+  readonly rowIndex: number;
+}
+//#endregion
 //#region src/grid.d.ts
 declare function cellId(gridId: string, row: number, column: number): string;
 /**
@@ -233,6 +761,47 @@ declare function cellId(gridId: string, row: number, column: number): string;
  * undo, redo, and clipboard copy, cut, and paste all work on the selected range.
  */
 declare const DataGridRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** Width reserved before data columns, for a row-number/header column. */
+  gutter: {
+    type: NumberConstructor;
+    default: number;
+  };
+  leadingColumns: {
+    readonly type: NumberConstructor;
+    readonly default: 0;
+  };
+  treeColumn: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  keepAliveDetail: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   table: {
     type: PropType<AnyDataTableBinding>;
     required: true;
@@ -247,7 +816,51 @@ declare const DataGridRoot: import("vue").DefineComponent<import("vue").ExtractP
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  save: (_result: unknown) => true;
+  cancel: (_key: string | number) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** Width reserved before data columns, for a row-number/header column. */
+  gutter: {
+    type: NumberConstructor;
+    default: number;
+  };
+  leadingColumns: {
+    readonly type: NumberConstructor;
+    readonly default: 0;
+  };
+  treeColumn: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  keepAliveDetail: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   table: {
     type: PropType<AnyDataTableBinding>;
     required: true;
@@ -260,9 +873,22 @@ declare const DataGridRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: PropType<string | undefined>;
     default: undefined;
   };
-}>> & Readonly<{}>, {
+}>> & Readonly<{
+  onCancel?: (_key: string | number) => any;
+  onSave?: (_result: unknown) => any;
+}>, {
   as: string;
+  height: string | undefined;
   label: string | undefined;
+  virtualColumns: boolean;
+  gutter: number;
+  leadingColumns: number;
+  treeColumn: string | undefined;
+  keepAliveDetail: boolean;
+  virtual: boolean | ComponentVirtualOptions;
+  rowHeight: number;
+  overscan: number;
+  columnWidth: number;
 }, SlotsType<{
   default?: (props: {
     table: DataTableBinding<unknown>;
@@ -282,6 +908,38 @@ interface GridCellSlotProps {
  * cell that is not being edited; the `rowHeader` slot adds a leading cell to each row.
  */
 declare const DataGridBody: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  colspan: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+  treeCell: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   as: {
     readonly type: StringConstructor;
     readonly default: string;
@@ -289,12 +947,52 @@ declare const DataGridBody: import("vue").DefineComponent<import("vue").ExtractP
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  colspan: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+  treeCell: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   as: {
     readonly type: StringConstructor;
     readonly default: string;
   };
 }>> & Readonly<{}>, {
   as: string;
+  height: string | undefined;
+  virtualColumns: boolean;
+  colspan: number;
+  virtual: boolean | ComponentVirtualOptions;
+  rowHeight: number;
+  overscan: number;
+  columnWidth: number;
+  treeCell: boolean;
 }, SlotsType<{
   default?: (props: {
     rows: readonly TableRow<unknown>[];
@@ -304,6 +1002,8 @@ declare const DataGridBody: import("vue").DefineComponent<import("vue").ExtractP
     index: number;
   }) => VNode[];
   cell?: (props: GridCellSlotProps) => VNodeChild;
+  editor?: (props: CellEditorSlotProps) => VNodeChild;
+  detail?: (props: DetailSlotProps) => VNodeChild;
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
  * A grid cell. A click selects it, Shift-click or dragging extends the range, and a double click
@@ -322,6 +1022,10 @@ declare const DataGridCell: import("vue").DefineComponent<import("vue").ExtractP
     readonly type: StringConstructor;
     readonly default: string;
   };
+  tree: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
   /** The row's position on the page. Found by searching the rows when left out. */
   rowIndex: {
     type: PropType<number | undefined>;
@@ -347,6 +1051,10 @@ declare const DataGridCell: import("vue").DefineComponent<import("vue").ExtractP
     readonly type: StringConstructor;
     readonly default: string;
   };
+  tree: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
   /** The row's position on the page. Found by searching the rows when left out. */
   rowIndex: {
     type: PropType<number | undefined>;
@@ -360,15 +1068,11 @@ declare const DataGridCell: import("vue").DefineComponent<import("vue").ExtractP
 }>> & Readonly<{}>, {
   as: string;
   rowIndex: number | undefined;
+  tree: boolean;
   columnIndex: number | undefined;
 }, SlotsType<{
   default?: (props: GridCellSlotProps) => VNodeChild;
-  editor?: (props: {
-    draft: string;
-    update: (draft: string) => void;
-    commit: (then?: GridDirection) => unknown;
-    cancel: () => void;
-  }) => VNode[];
+  editor?: (props: CellEditorSlotProps) => VNodeChild;
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/table.d.ts
@@ -377,6 +1081,42 @@ declare const DataGridCell: import("vue").DefineComponent<import("vue").ExtractP
  * slot it renders a complete header and body.
  */
 declare const DataTableRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  leadingColumns: {
+    readonly type: NumberConstructor;
+    readonly default: 0;
+  };
+  treeColumn: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  keepAliveDetail: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   table: {
     type: PropType<AnyDataTableBinding>;
     required: true;
@@ -388,6 +1128,42 @@ declare const DataTableRoot: import("vue").DefineComponent<import("vue").Extract
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  leadingColumns: {
+    readonly type: NumberConstructor;
+    readonly default: 0;
+  };
+  treeColumn: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  keepAliveDetail: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   table: {
     type: PropType<AnyDataTableBinding>;
     required: true;
@@ -398,6 +1174,15 @@ declare const DataTableRoot: import("vue").DefineComponent<import("vue").Extract
   };
 }>> & Readonly<{}>, {
   as: string;
+  height: string | undefined;
+  virtualColumns: boolean;
+  leadingColumns: number;
+  treeColumn: string | undefined;
+  keepAliveDetail: boolean;
+  virtual: boolean | ComponentVirtualOptions;
+  rowHeight: number;
+  overscan: number;
+  columnWidth: number;
 }, SlotsType<{
   default?: (props: {
     table: DataTableBinding<unknown>;
@@ -457,6 +1242,27 @@ declare const DataTableHeaderRow: import("vue").DefineComponent<import("vue").Ex
 }, SlotsType<{
   default?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** Shared header/body column slice, with native spacer cells for omitted columns. */
+declare const DataTableVirtualColumns: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  as: {
+    type: PropType<"th" | "td">;
+    default: string;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  as: {
+    type: PropType<"th" | "td">;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  as: "td" | "th";
+}, SlotsType<{
+  default?: (props: {
+    column: TableColumn<unknown>;
+    index: number;
+  }) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
  * A column header with `aria-sort`. Without a slot it shows the header text inside a sort button
  * for sortable columns.
@@ -530,6 +1336,34 @@ declare const DataTableSortButton: import("vue").DefineComponent<import("vue").E
  * a full-width row when there are none.
  */
 declare const DataTableBody: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  colspan: {
+    type: PropType<number | undefined>;
+    default: undefined;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   as: {
     readonly type: StringConstructor;
     readonly default: string;
@@ -537,17 +1371,57 @@ declare const DataTableBody: import("vue").DefineComponent<import("vue").Extract
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  colspan: {
+    type: PropType<number | undefined>;
+    default: undefined;
+  };
+  virtual: {
+    readonly type: PropType<boolean | ComponentVirtualOptions>;
+    readonly default: false;
+  };
+  height: {
+    readonly type: PropType<string | undefined>;
+    readonly default: undefined;
+  };
+  rowHeight: {
+    readonly type: NumberConstructor;
+    readonly default: 40;
+  };
+  overscan: {
+    readonly type: NumberConstructor;
+    readonly default: 5;
+  };
+  virtualColumns: {
+    readonly type: BooleanConstructor;
+    readonly default: false;
+  };
+  columnWidth: {
+    readonly type: NumberConstructor;
+    readonly default: 120;
+  };
   as: {
     readonly type: StringConstructor;
     readonly default: string;
   };
 }>> & Readonly<{}>, {
   as: string;
+  height: string | undefined;
+  virtualColumns: boolean;
+  colspan: number | undefined;
+  virtual: boolean | ComponentVirtualOptions;
+  rowHeight: number;
+  overscan: number;
+  columnWidth: number;
 }, SlotsType<{
   default?: (props: {
     rows: readonly TableRow<unknown>[];
   }) => VNode[];
   empty?: () => VNode[];
+  detail?: (props: {
+    row: TableRow<unknown>;
+    rowIndex: number;
+  }) => VNode[];
+  row?: (props: DetailSlotProps) => VNodeChild;
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** A body row; `aria-selected` and `data-selected` follow the selection. */
 declare const DataTableRow: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -559,6 +1433,10 @@ declare const DataTableRow: import("vue").DefineComponent<import("vue").ExtractP
     readonly type: StringConstructor;
     readonly default: string;
   };
+  rowIndex: {
+    type: PropType<number | undefined>;
+    default: undefined;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -570,8 +1448,13 @@ declare const DataTableRow: import("vue").DefineComponent<import("vue").ExtractP
     readonly type: StringConstructor;
     readonly default: string;
   };
+  rowIndex: {
+    type: PropType<number | undefined>;
+    default: undefined;
+  };
 }>> & Readonly<{}>, {
   as: string;
+  rowIndex: number | undefined;
 }, SlotsType<{
   default?: (props: {
     row: TableRow<unknown>;
@@ -593,6 +1476,10 @@ declare const DataTableCell: import("vue").DefineComponent<import("vue").Extract
     readonly type: StringConstructor;
     readonly default: string;
   };
+  tree: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -608,8 +1495,13 @@ declare const DataTableCell: import("vue").DefineComponent<import("vue").Extract
     readonly type: StringConstructor;
     readonly default: string;
   };
+  tree: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
 }>> & Readonly<{}>, {
   as: string;
+  tree: boolean;
 }, SlotsType<{
   default?: (props: {
     row: TableRow<unknown>;
@@ -637,5 +1529,5 @@ declare const DataTableEmpty: import("vue").DefineComponent<import("vue").Extrac
   default?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { DataGridBody, DataGridCell, DataGridRoot, DataTableBody, DataTableCaption, DataTableCell, DataTableColumnVisibility, DataTableEmpty, DataTableHeader, DataTableHeaderCell, DataTableHeaderRow, DataTablePageSize, DataTablePagination, DataTableRoot, DataTableRow, DataTableSearch, DataTableSelectAll, DataTableSelectRow, DataTableSortButton, DataTableStatus, type GridCellSlotProps, cellId, columnStyle };
+export { type CellEditorSlotProps, type ComponentVirtualBinding, type ComponentVirtualOptions, DataCellEditor, DataGridBody, DataGridCell, DataGridRoot, DataTableBody, DataTableCaption, DataTableCell, DataTableColumnVisibility, DataTableDetailRow, DataTableEditCell, DataTableEditRoot, DataTableEmpty, DataTableExpandToggle, DataTableHeader, DataTableHeaderCell, DataTableHeaderRow, DataTableLoadMore, DataTablePageSize, DataTablePagination, DataTableRoot, DataTableRow, DataTableRowActions, DataTableSearch, DataTableSelectAll, DataTableSelectRow, DataTableSortButton, DataTableStatus, DataTableTreeCell, DataTableViewport, DataTableVirtualColumns, type DetailSlotProps, type GridCellSlotProps, type TableStatusSlotProps, cellEditorProps, cellId, columnStyle, expandToggleProps, hierarchyProps, injectVirtual as injectVirtualRenderer, resolveTreeColumn, treeCellProps, virtualProps };
 //# sourceMappingURL=index.d.ts.map