@dxos/react-ui-table 0.8.3 → 0.8.4-main.1068cf700f

package/dist/types/src/model/modal-controller.d.ts

@@ -1,5 +1,5 @@
+import { Atom, type Registry } from '@effect-atom/atom-react';
 import { type RefObject } from 'react';
-import { type Live } from '@dxos/live-object';
 export type ColumnSettingsMode = {
     type: 'create';
 } | {
@@ -16,11 +16,6 @@ export type ModalState = {
     type: 'refPanel';
     targetId: string;
     typename: string;
-} | {
-    type: 'createRefPanel';
-    typename: string;
-    initialValues?: Record<string, string>;
-    onCreate?: (obj: Live<any>) => void;
 } | {
     type: 'columnSettings';
     mode: ColumnSettingsMode;
@@ -28,9 +23,12 @@ export type ModalState = {
     type: 'closed';
 };
 export declare class ModalController {
+    private readonly _registry;
     private readonly _state;
     private readonly _triggerRef;
-    get state(): import("@preact/signals-core").Signal<ModalState>;
+    constructor(registry: Registry.Registry);
+    get state(): Atom.Atom<ModalState>;
+    get stateValue(): ModalState;
     get trigger(): RefObject<HTMLButtonElement>;
     setTrigger: (trigger: HTMLElement) => void;
     showRowMenu: (rowIndex: number) => void;
@@ -38,7 +36,6 @@ export declare class ModalController {
     showColumnCreator: () => void;
     showReferencePanel: (targetId: string, schemaId: string) => void;
     openColumnSettings: () => void;
-    openCreateRef: (typename: string, anchorCell: Element | null, initialValues?: Record<string, string>, onCreate?: (obj: Live<any>) => void) => void;
     close: () => void;
 }
 //# sourceMappingURL=modal-controller.d.ts.map

package/dist/types/src/model/modal-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modal-controller.d.ts","sourceRoot":"","sources":["../../../../src/model/modal-controller.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8E;IAE1G,IAAW,KAAK,sDAEf;IAED,IAAW,OAAO,IACW,SAAS,CAAC,iBAAiB,CAAC,CACxD;IAEM,UAAU,GAAI,SAAS,WAAW,UAEvC;IAEK,WAAW,GAAI,UAAU,MAAM,UAEpC;IAEK,cAAc,GAAI,SAAS,MAAM,UAEtC;IAEK,iBAAiB,aAEtB;IAEK,kBAAkB,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,UAE7D;IAEK,kBAAkB,aAWvB;IAEK,aAAa,GAClB,UAAU,MAAM,EAChB,YAAY,OAAO,GAAG,IAAI,EAC1B,gBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,UAanC;IAEK,KAAK,aAEV;CACH"}
+{"version":3,"file":"modal-controller.d.ts","sourceRoot":"","sources":["../../../../src/model/modal-controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8E;gBAE9F,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAKvC,IAAW,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAExC;IAED,IAAW,UAAU,IAAI,UAAU,CAElC;IAED,IAAW,OAAO,IACW,SAAS,CAAC,iBAAiB,CAAC,CACxD;IAEM,UAAU,GAAI,SAAS,WAAW,UAEvC;IAEK,WAAW,GAAI,UAAU,MAAM,UAEpC;IAEK,cAAc,GAAI,SAAS,MAAM,UAEtC;IAEK,iBAAiB,aAEtB;IAEK,kBAAkB,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,UAE7D;IAEK,kBAAkB,aAYvB;IAEK,KAAK,aAEV;CACH"}

package/dist/types/src/model/selection-model.d.ts

@@ -1,20 +1,30 @@
-import { type ReadonlySignal } from '@preact/signals-core';
+import { Atom, type Registry } from '@effect-atom/atom-react';
 import { Resource } from '@dxos/context';
 import { type TableRow } from './table-model';
 export type SelectionMode = 'single' | 'multiple';
 export declare class SelectionModel<T extends TableRow> extends Resource {
+    private readonly _registry;
     private readonly _rows;
-    private readonly _selectionMode;
-    private readonly _onSelectionChanged?;
     private readonly _selection;
     private readonly _validSelectedIds;
     private readonly _hasSelection;
     private readonly _allSelected;
-    constructor(_rows: ReadonlySignal<T[]>, _selectionMode: SelectionMode, _onSelectionChanged?: (() => void) | undefined);
+    private readonly _selectionMode;
+    private readonly _onSelectionChanged?;
+    constructor(registry: Registry.Registry, rows: Atom.Atom<T[]>, selectionMode: SelectionMode, initialSelection: string[], onSelectionChanged?: () => void);
     protected _open(): Promise<void>;
-    get selection(): ReadonlySignal<Set<string>>;
-    get hasSelection(): ReadonlySignal<boolean>;
-    get allRowsSeleted(): ReadonlySignal<boolean>;
+    /** Get the selection atom for reactive access. */
+    get selectionAtom(): Atom.Atom<Set<string>>;
+    /** Get the current selection value. */
+    get selection(): Set<string>;
+    /** Get the hasSelection atom for reactive access. */
+    get hasSelectionAtom(): Atom.Atom<boolean>;
+    /** Check if there is any selection. */
+    get hasSelection(): boolean;
+    /** Get the allRowsSelected atom for reactive access. */
+    get allRowsSelectedAtom(): Atom.Atom<boolean>;
+    /** Check if all rows are selected. */
+    get allRowsSelected(): boolean;
     get selectionMode(): SelectionMode;
     getSelectedRows: () => T[];
     isRowIndexSelected: (rowIndex: number) => boolean;

package/dist/types/src/model/selection-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selection-model.d.ts","sourceRoot":"","sources":["../../../../src/model/selection-model.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElD,qBAAa,cAAc,CAAC,CAAC,SAAS,QAAQ,CAAE,SAAQ,QAAQ;IAyB5D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IA1BvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAE7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAQ/B;IAEH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkE;IAEhG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAO1B;gBAGgB,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAC1B,cAAc,EAAE,aAAa,EAC7B,mBAAmB,CAAC,GAAE,MAAM,IAAI,aAAA;cAK1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/C,IAAW,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAElD;IAED,IAAW,YAAY,IAAI,cAAc,CAAC,OAAO,CAAC,CAEjD;IAED,IAAW,cAAc,IAAI,cAAc,CAAC,OAAO,CAAC,CAEnD;IAED,IAAW,aAAa,IAAI,aAAa,CAExC;IAEM,eAAe,QAAO,CAAC,EAAE,CAG9B;IAEK,kBAAkB,GAAI,UAAU,MAAM,KAAG,OAAO,CAGrD;IAEK,gBAAgB,GAAI,QAAQ,CAAC,KAAG,OAAO,CAE5C;IAMK,0BAA0B,GAAI,UAAU,MAAM,KAAG,IAAI,CAc1D;IAEK,YAAY,GAAI,MAAM,KAAK,GAAG,MAAM,KAAG,IAAI,CAWhD;CACH"}
+{"version":3,"file":"selection-model.d.ts","sourceRoot":"","sources":["../../../../src/model/selection-model.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElD,qBAAa,cAAc,CAAC,CAAC,SAAS,QAAQ,CAAE,SAAQ,QAAQ;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAa;gBAGhD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EACpB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,MAAM,EAAE,EAC1B,kBAAkB,CAAC,EAAE,MAAM,IAAI;cAkCR,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/C,kDAAkD;IAClD,IAAW,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAEjD;IAED,uCAAuC;IACvC,IAAW,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,CAElC;IAED,qDAAqD;IACrD,IAAW,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAEhD;IAED,uCAAuC;IACvC,IAAW,YAAY,IAAI,OAAO,CAEjC;IAED,wDAAwD;IACxD,IAAW,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAEnD;IAED,sCAAsC;IACtC,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED,IAAW,aAAa,IAAI,aAAa,CAExC;IAEM,eAAe,QAAO,CAAC,EAAE,CAG9B;IAEK,kBAAkB,GAAI,UAAU,MAAM,KAAG,OAAO,CAGrD;IAEK,gBAAgB,GAAI,QAAQ,CAAC,KAAG,OAAO,CAE5C;IAMK,0BAA0B,GAAI,UAAU,MAAM,KAAG,IAAI,CAe1D;IAEK,YAAY,GAAI,MAAM,KAAK,GAAG,MAAM,KAAG,IAAI,CAWhD;CACH"}

package/dist/types/src/model/table-model.d.ts

@@ -1,23 +1,57 @@
-import { type ReadonlySignal } from '@preact/signals-core';
-import { type Space } from '@dxos/client/echo';
+import { Atom, type Registry } from '@effect-atom/atom-react';
 import { Resource } from '@dxos/context';
-import { type FieldSortType, type JsonProp } from '@dxos/echo-schema';
+import { type Database, type QueryAST } from '@dxos/echo';
+import { type JsonProp, type JsonSchemaType } from '@dxos/echo/internal';
+import { type Label } from '@dxos/react-ui';
 import { type DxGridAxisMeta, type DxGridPlanePosition, type DxGridPosition } from '@dxos/react-ui-grid';
-import { type ViewType, type ViewProjection } from '@dxos/schema';
+import { type ProjectionModel, type ValidationError, type View } from '@dxos/schema';
+import { type Table } from '../types';
+/**
+ * Field sort configuration.
+ */
+export type FieldSortType = {
+    fieldId: string;
+    direction: QueryAST.OrderDirection;
+};
 import { type SelectionMode, SelectionModel } from './selection-model';
-import { TableSorting } from './table-sorting';
+/**
+ * Callback type for wrapping mutations in Obj.change().
+ * Contains separate callbacks for table object and row mutations.
+ */
+export type TableChangeCallback<T extends TableRow> = {
+    /** Callback to wrap table object mutations. */
+    table: (mutate: (mutableTable: Table.Table) => void) => void;
+    /** Callback to wrap row mutations. */
+    row: (row: T, mutate: (mutableRow: T) => void) => void;
+};
+/**
+ * Creates a change callback for ECHO-backed table and rows.
+ * Use this when the table and rows are stored in the ECHO database.
+ */
+export declare const createEchoChangeCallback: <T extends TableRow>(table: Table.Table) => TableChangeCallback<T>;
+/**
+ * Creates a change callback that directly mutates objects without wrapping.
+ * Use this for plain JavaScript objects (tests, non-ECHO scenarios).
+ */
+export declare const createDirectChangeCallback: <T extends TableRow>(table: Table.Table) => TableChangeCallback<T>;
+export type TableCellType = 'standard' | 'draft' | 'header';
 export type ValidationResult = {
     valid: true;
 } | {
     valid: false;
     error: string;
 };
+export type DraftRow<T extends TableRow = TableRow> = {
+    data: T;
+    valid: boolean;
+    validationErrors: ValidationError[];
+};
 export type TableRow = Record<JsonProp, any> & {
     id: string;
 };
 export type TableRowAction = {
     id: string;
-    translationKey: string;
+    label: Label;
 };
 export type TableFeatures = {
     selection: {
@@ -27,87 +61,170 @@ export type TableFeatures = {
     dataEditable: boolean;
     schemaEditable: boolean;
 };
+export type InsertRowResult = 'draft' | 'final';
 export type TableModelProps<T extends TableRow = TableRow> = {
-    id?: string;
-    space?: Space;
-    view?: ViewType;
-    projection: ViewProjection;
+    registry: Registry.Registry;
+    object: Table.Table;
+    projection: ProjectionModel;
+    db?: Database.Database;
+    /**
+     * Callbacks to wrap mutations in Obj.change().
+     * Use createEchoChangeCallback() for ECHO-backed objects or createDirectChangeCallback() for plain objects.
+     */
+    change?: TableChangeCallback<T>;
     features?: Partial<TableFeatures>;
-    sorting?: FieldSortType[];
+    initialSelection?: string[];
     pinnedRows?: {
         top: number[];
         bottom: number[];
     };
     rowActions?: TableRowAction[];
-    onInsertRow?: (index?: number) => void;
+    onResolveSchema?: (typename: string) => Promise<JsonSchemaType>;
+    onInsertRow?: (data?: any) => InsertRowResult;
     onDeleteRows?: (index: number, obj: T[]) => void;
-    onDeleteColumn?: (fieldId: string) => void;
+    onColumnDelete?: (fieldId: string) => void;
     onCellUpdate?: (cell: DxGridPosition) => void;
     onRowOrderChange?: () => void;
     onRowAction?: (actionId: string, data: T) => void;
 };
 export declare class TableModel<T extends TableRow = TableRow> extends Resource {
-    private readonly _id;
-    private readonly _space;
-    private readonly _view;
+    private readonly _registry;
+    private readonly _object;
     private readonly _projection;
+    private readonly _db?;
+    private readonly _change;
     private readonly _visibleRange;
     private readonly _onInsertRow?;
     private readonly _onDeleteRows?;
-    private readonly _onDeleteColumn?;
+    private readonly _onColumnDelete?;
     private readonly _onCellUpdate?;
     private readonly _onRowOrderChange?;
     private readonly _onRowAction?;
     private readonly _rowActions;
     private readonly _features;
     private readonly _rows;
+    private readonly _draftRows;
+    private readonly _inMemorySort;
+    private readonly _persistedSort;
     private readonly _sorting;
+    private readonly _sortedRows;
+    private readonly _viewDirty;
     private _pinnedRows;
     private _selection;
     private _columnMeta?;
-    constructor({ id, space, view, projection, features, sorting, pinnedRows, rowActions, onCellUpdate, onDeleteColumn, onDeleteRows, onInsertRow, onRowOrderChange, onRowAction, }: TableModelProps<T>);
-    get id(): string | undefined;
-    get space(): Space | undefined;
-    get view(): ViewType | undefined;
-    get projection(): ViewProjection;
-    get rows(): ReadonlySignal<T[]>;
+    private readonly _cellUpdateCounter;
+    constructor({ registry, object, projection, db, change, features, initialSelection, pinnedRows, rowActions, onCellUpdate, onColumnDelete, onDeleteRows, onInsertRow, onRowOrderChange, onRowAction, }: TableModelProps<T>);
+    get id(): string;
+    get view(): View.View;
+    get table(): Table.Table;
+    get projection(): ProjectionModel;
+    get db(): Database.Database | undefined;
+    /**
+     * Atom for reactive access to rows with in-memory sorting applied.
+     */
+    get rows(): Atom.Atom<T[]>;
+    /**
+     * Gets rows with in-memory sorting applied.
+     * In-memory sort is local to this instance until saved.
+     */
+    getRows(): T[];
+    /** Atom for reactive access to cell changes. */
+    get cellUpdate(): Atom.Atom<number>;
+    /**
+     * Change a row using the configured change callback.
+     * Use this instead of directly mutating to ensure consistent mutation handling.
+     */
+    changeRow(row: T, mutate: (mutableRow: T) => void): void;
     get features(): TableFeatures;
     /**
-     * @reactive
+     * Gets the current sort state.
+     * Priority: in-memory sort (local changes) > persisted sort (from query AST).
      */
-    get sorting(): TableSorting<T> | undefined;
+    getSorting(): FieldSortType | undefined;
     /**
      * Gets the row data at the specified display index.
      */
     getRowAt(displayIndex: number): T | undefined;
     get pinnedRows(): NonNullable<TableModelProps<T>['pinnedRows']>;
-    get columnMeta(): ReadonlySignal<DxGridAxisMeta>;
+    get columnMeta(): Atom.Atom<DxGridAxisMeta>;
     get selection(): SelectionModel<T>;
-    /** @reactive */
-    get isViewDirty(): boolean;
     get rowActions(): TableRowAction[];
     protected _open(): Promise<void>;
     private initializeColumnMeta;
     private initializeEffects;
     setRows: (obj: T[]) => void;
     getRowCount: () => number;
+    getDraftRowCount(): number;
+    /** Atom for reactive access to draft rows. */
+    get draftRows(): Atom.Atom<DraftRow<T>[]>;
+    /** Gets the current draft rows. */
+    getDraftRows(): DraftRow<T>[];
+    /**
+     * Checks if a specific field path has validation errors for a given draft row.
+     * @param draftRowIndex - The index of the draft row to check
+     * @param fieldPath - The path of the field to check for validation errors
+     * @returns true if the field has validation errors, false otherwise
+     */
+    hasDraftRowValidationError(draftRowIndex: number, fieldPath: string): boolean;
     getColumnCount: () => number;
-    insertRow: (rowIndex?: number) => void;
+    insertRow: () => InsertRowResult;
+    private createDraftRow;
+    private validateDraftRow;
+    private validateDraftRowData;
+    commitDraftRow: (draftRowIndex: number) => boolean;
     deleteRow: (rowIndex: number) => void;
     handleRowAction: (actionId: string, rowIndex: number) => void;
-    getCellData: ({ col, row }: DxGridPlanePosition) => any;
-    validateCellData: ({ col, row }: DxGridPlanePosition, value: any) => Promise<ValidationResult>;
-    setCellData: ({ col, row }: DxGridPlanePosition, value: any) => void;
+    getCellData: (cell: DxGridPosition) => any;
+    validateCellData: ({ col, row, plane }: DxGridPosition, value: any) => Promise<ValidationResult>;
+    setCellData: (cell: DxGridPosition, value: any) => void;
     /**
      * Updates a cell's value using a transform function.
      * @param {DxGridPlanePosition} position - The position of the cell to update.
      * @param {(value: any) => any} update - A function that takes the current value and returns the updated value.
      */
     updateCellData({ col, row }: DxGridPlanePosition, update: (value: any) => any): void;
+    /**
+     * Gets the domain-appropriate cell type for a given cell position.
+     * This abstracts away the low-level grid plane concepts and provides domain-specific types.
+     * @param cell - The cell position to classify
+     * @returns The domain-appropriate cell type
+     */
+    getCellType(cell: DxGridPosition): TableCellType;
+    /**
+     * Convenience method to check if a cell is a draft cell.
+     * @param cell - The cell position to check
+     * @returns true if the cell is a draft cell, false otherwise
+     */
+    isDraftCell(cell: DxGridPosition): boolean;
     deleteColumn(fieldId: string): void;
     setColumnWidth(columnIndex: number, width: number): void;
     pinRow(rowIndex: number, side: 'top' | 'bottom'): void;
     unpinRow(rowIndex: number): void;
+    /**
+     * Sets the sort order for a field in-memory (local to this instance).
+     * Use saveView() to persist the sort to the view query.
+     */
+    setSort(fieldId: string, direction: QueryAST.OrderDirection): void;
+    /**
+     * Toggles the sort direction for a field in-memory.
+     */
+    toggleSort(fieldId: string): void;
+    /**
+     * Clears the in-memory sort order.
+     */
+    clearSort(): void;
+    /**
+     * Saves the current in-memory sort to the view query AST.
+     * This persists the sort so it becomes the default for all viewers.
+     */
     saveView(): void;
+    /**
+     * Extracts the base query without order clauses.
+     */
+    private _getBaseQuery;
+    /**
+     * Checks if the view has unsaved changes (in-memory sort differs from persisted sort).
+     */
+    getViewDirty(): boolean;
 }
 //# sourceMappingURL=table-model.d.ts.map

package/dist/types/src/model/table-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-model.d.ts","sourceRoot":"","sources":["../../../../src/model/table-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"table-model.d.ts","sourceRoot":"","sources":["../../../../src/model/table-model.ts"],"names":[],"mappings":"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"}

package/dist/types/src/model/table-presentation.d.ts

@@ -1,6 +1,7 @@
+import { type Registry } from '@effect-atom/atom-react';
 import { type DxGridPlane, type DxGridPlaneCells, type DxGridPlaneRange } from '@dxos/react-ui-grid';
 import { type SelectionMode } from './selection-model';
-import { type TableRow, type TableModel } from './table-model';
+import { type TableModel, type TableRow } from './table-model';
 /**
  * Presentation layer for a table component, handling cell rendering and grid display logic.
  * Manages rendering of table cells, headers, selection columns, and action columns across
@@ -8,15 +9,25 @@ import { type TableRow, type TableModel } from './table-model';
  */
 export declare class TablePresentation<T extends TableRow = TableRow> {
     private readonly model;
+    private readonly _registry;
     private readonly _visibleRange;
-    constructor(model: TableModel<T>, _visibleRange?: import("@preact/signals-core").Signal<DxGridPlaneRange>);
+    private fieldProjectionCache;
+    constructor(registry: Registry.Registry, model: TableModel<T>);
     getCells(range: DxGridPlaneRange, plane: DxGridPlane): DxGridPlaneCells;
+    /**
+     * Gets a field projection, using cache if available within the current render pass.
+     */
+    private getFieldProjection;
+    private createDataCell;
     private getMainGridCells;
+    private getDraftRowCells;
     private getHeaderCells;
     private getSelectionColumnCells;
     private getActionColumnCells;
     private getSelectAllCell;
     private getNewColumnCell;
+    private getDraftActionCells;
+    private getDraftIconCells;
 }
 export declare const cellClassesForRowSelection: (selected: boolean, selectionMode: SelectionMode) => string[] | undefined;
 //# sourceMappingURL=table-presentation.d.ts.map

package/dist/types/src/model/table-presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-presentation.d.ts","sourceRoot":"","sources":["../../../../src/model/table-presentation.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG/D;;;;GAIG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IAExD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,aAAa,0DAG5B;IAGG,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,GAAG,gBAAgB;IAoC9E,OAAO,CAAC,gBAAgB;IAoKxB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,gBAAgB;CAczB;AAED,eAAO,MAAM,0BAA0B,GAAI,UAAU,OAAO,EAAE,eAAe,aAAa,yBAgBzF,CAAC"}
+{"version":3,"file":"table-presentation.d.ts","sourceRoot":"","sources":["../../../../src/model/table-presentation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAM9D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAEtB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;GAIG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IAOxD,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,oBAAoB,CAAkF;gBAG5G,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EACV,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAShC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,GAAG,gBAAgB;IAgD9E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,cAAc;IA+JtB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,iBAAiB;CAe1B;AAED,eAAO,MAAM,0BAA0B,GAAI,UAAU,OAAO,EAAE,eAAe,aAAa,yBAezF,CAAC"}

package/dist/types/src/playwright/TableManager.d.ts

@@ -10,9 +10,10 @@ export declare class TableManager {
     toggleSelectAll(): Promise<void>;
     selection(index: number): Locator;
     sortColumn(index: number, direction: 'ascending' | 'descending'): Promise<void>;
+    addRow(): Promise<void>;
     addColumn({ label, format }: {
         label: string;
-        format: 'number';
+        format?: string;
     }): Promise<void>;
 }
 //# sourceMappingURL=TableManager.d.ts.map

package/dist/types/src/playwright/TableManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableManager.d.ts","sourceRoot":"","sources":["../../../../src/playwright/TableManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAevD,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAET,IAAI,EAAE,IAAI;IAIvC,IAAW,IAAI,IAAI,aAAa,CAE/B;IAEY,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,SAAS,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/E,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ9F"}
+{"version":3,"file":"TableManager.d.ts","sourceRoot":"","sources":["../../../../src/playwright/TableManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAgBvD,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAET,IAAI,EAAE,IAAI;IAIvC,IAAW,IAAI,IAAI,aAAa,CAE/B;IAEY,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,SAAS,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAU7F"}

package/dist/types/src/playwright/playwright.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@playwright/test").PlaywrightTestConfig<{}, {}>;
+export default _default;
+//# sourceMappingURL=playwright.config.d.ts.map

package/dist/types/src/playwright/playwright.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.config.d.ts","sourceRoot":"","sources":["../../../../src/playwright/playwright.config.ts"],"names":[],"mappings":";AAQA,wBAQG"}

package/dist/types/src/testing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './useTestTableModel';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC"}

package/dist/types/src/testing/useTestTableModel.d.ts

@@ -0,0 +1,25 @@
+import { type RefObject } from 'react';
+import { type Database, type Type } from '@dxos/echo';
+import { type ProjectionModel } from '@dxos/schema';
+import { type TableController } from '../components';
+import { type TableModel, TablePresentation } from '../model';
+import { Table } from '../types';
+export type TestTableModel<T extends Type.Obj.Any = Type.Obj.Any> = {
+    schema: T | undefined;
+    table: Table.Table | undefined;
+    projection: ProjectionModel | undefined;
+    tableRef: RefObject<TableController | null>;
+    model: TableModel | undefined;
+    presentation: TablePresentation | undefined;
+    db: Database.Database | undefined;
+    handleInsertRow: () => void;
+    handleSaveView: () => void;
+    handleDeleteRows: (rowIndex: number, objects: any[]) => void;
+    handleDeleteColumn: (fieldId: string) => void;
+};
+/**
+ * Custom hook to create and manage a test table model for storybook demonstrations.
+ * Provides table data, schema, and handlers for table operations.
+ */
+export declare const useTestTableModel: <T extends Type.Obj.Any = Type.Obj.Any>() => TestTableModel<T>;
+//# sourceMappingURL=useTestTableModel.d.ts.map

package/dist/types/src/testing/useTestTableModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTestTableModel.d.ts","sourceRoot":"","sources":["../../../../src/testing/useTestTableModel.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAMtD,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,cAAc,CAAC;AAE1E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIjC,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;IAClE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,QAAQ,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC5C,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC7D,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAK,cAAc,CAAC,CAAC,CA4F3F,CAAC"}

package/dist/types/src/translations.d.ts

@@ -1,13 +1,13 @@
-export declare const translationKey = "table";
-declare const _default: readonly [{
+export declare const translationKey = "@dxos/react-ui-table";
+export declare const translations: [{
     readonly 'en-US': {
-        readonly table: {
+        readonly "@dxos/react-ui-table": {
             readonly 'object placeholder': "New table";
             readonly 'create object label': "Create table";
             readonly 'table name placeholder': "Table name";
             readonly 'settings title': "Table settings";
-            readonly 'table schema label': "Schema";
-            readonly 'new schema': "New schema";
+            readonly 'table schema label': "Type";
+            readonly 'new schema': "New type";
             readonly 'continue label': "Continue";
             readonly 'create stack section label': "Create table";
             readonly 'add row label': "Add row";
@@ -26,5 +26,4 @@ declare const _default: readonly [{
         };
     };
 }];
-export default _default;
 //# sourceMappingURL=translations.d.ts.map

package/dist/types/src/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtC,wBA4BW"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,yBAAyB,CAAC;AAErD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BM,CAAC"}

package/dist/types/src/types/Table.d.ts

@@ -0,0 +1,31 @@
+import * as Schema from 'effect/Schema';
+import { Type } from '@dxos/echo';
+import { type JsonSchemaType } from '@dxos/echo/internal';
+import { View } from '@dxos/schema';
+export declare const Table: Type.Obj<{
+    readonly name?: string | undefined;
+    readonly view: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & View.View>;
+    readonly sizes: {
+        [x: string]: number;
+    };
+}, Schema.Struct.Fields>;
+export interface Table extends Schema.Schema.Type<typeof Table> {
+}
+type MakeProps = {
+    name?: string;
+    sizes?: Record<string, number>;
+    view: View.View;
+    /** Required to auto-size columns. */
+    jsonSchema?: JsonSchemaType;
+};
+/**
+ * Make a table as a view of a data set.
+ */
+export declare const make: ({ name, sizes, view, jsonSchema }: MakeProps) => Table;
+export declare const TableV1: Type.Obj<{
+    readonly sizes: {
+        [x: string]: number;
+    };
+}, Schema.Struct.Fields>;
+export {};
+//# sourceMappingURL=Table.d.ts.map

package/dist/types/src/types/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../../../src/types/Table.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAsC,KAAK,cAAc,EAAmB,MAAM,qBAAqB,CAAC;AAC/G,OAAO,EAAE,IAAI,EAAkB,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,KAAK;;;;;;wBAiBjB,CAAC;AAEF,MAAM,WAAW,KAAM,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC;CAAG;AAElE,KAAK,SAAS,GAAG;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,mCAAwC,SAAS,KAAG,KA6BxE,CAAC;AAMF,eAAO,MAAM,OAAO;;;;wBAUnB,CAAC"}

package/dist/types/src/types/index.d.ts

@@ -1,2 +1,2 @@
-export * from './table';
+export * as Table from './Table';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC"}

package/dist/types/src/util/dynamic-table.d.ts

@@ -1,32 +1,33 @@
-import { type Schema } from 'effect';
-import type { JsonSchemaType, SortDirectionType } from '@dxos/echo-schema';
-import { ViewProjection, type SchemaPropertyDefinition } from '@dxos/schema';
-import { TableType } from '../types';
+import { type Registry } from '@effect-atom/atom-react';
+import type * as Types from 'effect/Types';
+import { type JsonSchema, type QueryAST, Type } from '@dxos/echo';
+import { ProjectionModel, type SchemaPropertyDefinition } from '@dxos/schema';
+import { Table } from '../types';
 type PropertyDisplayProps = {
     size: number;
     title: string;
-    sort: SortDirectionType;
+    sort: QueryAST.OrderDirection;
 };
 export type TablePropertyDefinition = SchemaPropertyDefinition & Partial<PropertyDisplayProps>;
 /**
  * @deprecated
  */
-export declare const getBaseSchema: ({ typename, properties, jsonSchema, schema, }: {
+export declare const getBaseSchema: ({ schema, typename, properties, jsonSchema, }: {
+    schema?: Type.Entity.Any;
     typename?: string;
     properties?: TablePropertyDefinition[];
-    jsonSchema?: JsonSchemaType;
-    schema?: Schema.Schema.AnyNoContext;
+    jsonSchema?: Types.DeepMutable<JsonSchema.JsonSchema>;
 }) => {
     typename: string;
-    jsonSchema: JsonSchemaType;
+    jsonSchema: Types.DeepMutable<JsonSchema.JsonSchema>;
 };
-export declare const makeDynamicTable: ({ typename, jsonSchema, properties, }: {
-    typename: string;
-    jsonSchema: JsonSchemaType;
+export declare const makeDynamicTable: ({ registry, jsonSchema, properties, }: {
+    registry: Registry.Registry;
+    jsonSchema: Types.DeepMutable<JsonSchema.JsonSchema>;
     properties?: TablePropertyDefinition[];
 }) => {
-    table: TableType;
-    projection: ViewProjection;
+    projection: ProjectionModel;
+    object: Table.Table;
 };
 export {};
 //# sourceMappingURL=dynamic-table.d.ts.map