@ornery/ui-grid-vanilla 1.0.7 → 1.0.8

package/dist/framework-slots.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Framework-rendered slot bridge for the vanilla grid element.
+ *
+ * The vanilla grid renders every cell / header / filter / group / expandable
+ * / empty-state via string-interpolated templates by default. When a
+ * framework wrapper (Angular, React, or any other consumer) wants to own
+ * rendering of a slot with its own templating engine, it calls
+ * `setFrameworkRenderedSlots()` on the element to flip slot kinds into
+ * "slot placeholder" mode.
+ *
+ * In that mode the element emits `<slot name="…">` placeholders at the
+ * usual render sites. The wrapper listens for the `*SlotsChanged` event
+ * this module dispatches and inserts light-DOM nodes with matching `slot`
+ * attributes carrying its framework-rendered content. Slot projection then
+ * composes the wrapper's view back into the shadow tree without the
+ * wrapper ever touching the shadow DOM directly.
+ *
+ * Slot naming conventions:
+ *   - `cell-<columnName>-<rowId>`     per-cell (one slot per rendered body cell)
+ *   - `header-<columnName>`           per-column, singleton
+ *   - `filter-<columnName>`           per-column, singleton
+ *   - `group-row-<groupId>`           per-group
+ *   - `expandable-row-<rowId>`        per-row
+ *   - `empty`                         singleton
+ */
+import { type GridCellTemplateContext, type GridColumnDef, type GridExpandableTemplateContext, type GridHeaderTemplateContext, type GridLabels, type GridRow, type GroupItem } from '@ornery/ui-grid-core';
+/** Which slot kinds the element should render as `<slot>` placeholders. */
+export interface FrameworkRenderedSlotsConfig {
+    /** Column names whose body cells are framework-rendered. Everything else
+     * continues to use the vanilla interpolation path. */
+    cells?: readonly string[];
+    /** Column names whose header cells are framework-rendered. */
+    headers?: readonly string[];
+    /** Column names whose filter cells are framework-rendered. */
+    filters?: readonly string[];
+    /** When true, group rows are emitted as slot placeholders. */
+    groupRow?: boolean;
+    /** When true, expandable detail rows are emitted as slot placeholders. */
+    expandableRow?: boolean;
+    /** When true, the empty-state panel is emitted as a slot placeholder. */
+    emptyState?: boolean;
+}
+export interface FrameworkCellSlot {
+    slotName: string;
+    columnName: string;
+    rowId: string;
+    rowIndex: number;
+    context: GridCellTemplateContext;
+}
+export interface FrameworkHeaderSlot {
+    slotName: string;
+    columnName: string;
+    context: GridHeaderTemplateContext;
+}
+export interface FrameworkFilterSlot {
+    slotName: string;
+    columnName: string;
+    value: string;
+    placeholder: string;
+    disabled: boolean;
+    column: GridColumnDef;
+}
+export interface FrameworkGroupRowSlot {
+    slotName: string;
+    groupId: string;
+    field: string;
+    label: string;
+    count: number;
+    depth: number;
+    collapsed: boolean;
+}
+export interface FrameworkExpandableRowSlot {
+    slotName: string;
+    rowId: string;
+    rowIndex: number;
+    context: GridExpandableTemplateContext;
+}
+export interface FrameworkEmptyStateSlot {
+    slotName: 'empty';
+    heading: string;
+    description: string;
+    labels: GridLabels;
+}
+export interface FrameworkSlotDelta<TSlot> {
+    added: TSlot[];
+    removed: TSlot[];
+}
+export declare function cellSlotName(column: GridColumnDef): string;
+export declare function cellSlotNameForRow(column: GridColumnDef, row: GridRow): string;
+export declare function headerSlotName(column: GridColumnDef): string;
+export declare function filterSlotName(column: GridColumnDef): string;
+export declare function groupRowSlotName(group: GroupItem): string;
+export declare function expandableRowSlotName(row: GridRow): string;
+/**
+ * Bridge state + behavior. The element creates one instance, reads the
+ * `has*` methods during render to decide which path to take, calls the
+ * `stage*` methods as it emits slot placeholders, and calls `flush()` at
+ * the end of each render pass to emit the add/remove delta.
+ */
+export declare class FrameworkSlotBridge {
+    private readonly host;
+    private flaggedCells;
+    private flaggedHeaders;
+    private flaggedFilters;
+    private flaggedGroupRow;
+    private flaggedExpandableRow;
+    private flaggedEmptyState;
+    private lastCellSlots;
+    private lastExpandableRowSlots;
+    private lastGroupRowSlots;
+    private lastHeaderSlots;
+    private lastFilterSlots;
+    private lastEmptyStateSlot;
+    private pendingCellSlots;
+    private pendingExpandableRowSlots;
+    private pendingGroupRowSlots;
+    private pendingHeaderSlots;
+    private pendingFilterSlots;
+    private pendingEmptyStateSlot;
+    constructor(host: EventTarget);
+    /**
+     * Apply a slots config. Returns true when the structural set changed (and
+     * therefore a re-render is required), false when the config is a no-op.
+     */
+    configure(config: FrameworkRenderedSlotsConfig): boolean;
+    hasCell(columnName: string): boolean;
+    hasHeader(columnName: string): boolean;
+    hasFilter(columnName: string): boolean;
+    hasGroupRow(): boolean;
+    hasExpandableRow(): boolean;
+    hasEmptyState(): boolean;
+    stageCell(column: GridColumnDef, row: GridRow, rowIndex: number): void;
+    /**
+     * Carry forward every previously-known cell slot for `rowId` into the
+     * current pending set. Used by the structural patch path when a row's
+     * fingerprint matches the previous render's: `stageCell` would normally
+     * re-record the slot during cell rendering, but the fingerprint
+     * short-circuit skips the render pass for unchanged rows. Without this,
+     * `flush()` would diff pending (missing the row's slots) against last
+     * (containing them) and emit a spurious `removed` for every cell of the
+     * unchanged row, destroying the framework wrappers' projected content.
+     */
+    carryRowCells(rowId: string): void;
+    stageExpandableRow(row: GridRow, rowIndex: number): void;
+    stageGroupRow(group: GroupItem): void;
+    stageHeader(column: GridColumnDef): void;
+    stageFilter(column: GridColumnDef, value: string, placeholder: string, disabled: boolean): void;
+    stageEmptyState(heading: string, description: string, labels: GridLabels): void;
+    /**
+     * Diff pending vs. last, dispatch `*SlotsChanged` events for every kind
+     * that moved, then swap last = pending and reset pending. Called at the
+     * end of every render pass.
+     */
+    flush(): void;
+    /**
+     * Data-only patch variant: merge pending entries into last without firing
+     * events, since the slot structure hasn't changed (only cell contexts
+     * refreshed). Wrappers that need context updates subscribe to
+     * `rowsVisibleChanged`.
+     */
+    mergePendingIntoLast(): void;
+    /**
+     * On element teardown, emit `removed` for every remaining slot so wrappers
+     * can destroy their views.
+     */
+    flushRemovals(): void;
+    private diffAndEmit;
+    private diffAndEmitSingleton;
+}
+//# sourceMappingURL=framework-slots.d.ts.map

package/dist/framework-slots.d.ts.map

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

package/dist/grid-controller.d.ts

@@ -0,0 +1,363 @@
+import { resolveGridSelectionOptions, GridValidatorRegistry, type GridSelectionState, type GridInfiniteScrollState, type DisplayItem, type GridCellPosition, type GridColumnDef, type GridBenchmarkResult, type GridLabels, type GridOptions, type GridRecord, type GridRow, type PipelineResult, type PinDirection, type PinnedColumnState, type SortDirection, type GroupItem, type SortState, type UiGridApi } from '@ornery/ui-grid-core';
+/**
+ * Complete grid save state — parity with the old `ui.grid.saveState`
+ * module. Every field is optional so partial saves / restores work too.
+ *
+ * Opt-in/out behaviour mirrors the old module: by default save() serialises
+ * everything; consumers can disable per-field capture via
+ * `saveSort`/`saveFilter`/... options on `GridOptions`. Restore tolerates
+ * missing fields.
+ */
+export interface GridSaveState {
+    sortState?: SortState;
+    activeFilters?: Record<string, string>;
+    groupByColumns?: string[];
+    collapsedGroups?: Record<string, boolean>;
+    pinnedColumns?: PinnedColumnState;
+    columnOrder?: string[];
+    columnWidthOverrides?: Record<string, string>;
+    currentPage?: number;
+    pageSize?: number;
+    selectedRowIds?: string[];
+    focusedCell?: GridCellPosition | null;
+    expandedRows?: Record<string, boolean>;
+    expandedTreeRows?: Record<string, boolean>;
+    scrollTop?: number;
+    scrollLeft?: number;
+}
+export interface GridControllerSnapshot {
+    options: GridOptions;
+    labels: GridLabels;
+    rowSize: number;
+    visibleColumns: GridColumnDef[];
+    gridTemplateColumns: string;
+    pipeline: PipelineResult;
+    activeFilters: Record<string, string>;
+    sortState: SortState;
+    groupByColumns: string[];
+    pinnedColumns: PinnedColumnState;
+    currentPage: number;
+    totalPages: number;
+    firstRowIndex: number;
+    lastRowIndex: number;
+    pageSize: number;
+    editingCell: GridCellPosition | null;
+    editingValue: string;
+    /** Row ids currently selected. A ReadonlySet for surgical DOM updates —
+     * the renderer toggles the .ui-grid-row-selected class on every cell
+     * whose data-row matches one of these ids. */
+    selectedRowIds: ReadonlySet<string>;
+    selectAll: boolean;
+    focusedRowId: string | null;
+    selectedCount: number;
+}
+export type GridControllerSubscriber = (snapshot: GridControllerSnapshot) => void;
+export declare class VanillaGridController {
+    private options;
+    private activeFilters;
+    private sortState;
+    private groupByColumns;
+    private lastOptionsGroupBy;
+    private lastOptionsPinnedState;
+    private lastOptionsInfiniteScrollUp;
+    private lastOptionsInfiniteScrollDown;
+    private collapsedGroups;
+    private hiddenRowReasons;
+    private expandedRows;
+    private expandedTreeRows;
+    private pinnedColumns;
+    private columnOrder;
+    private columnWidthOverrides;
+    private viewportWidth;
+    private currentPage;
+    private pageSize;
+    private editingCell;
+    private editingValue;
+    private exporterOverrides;
+    private validatorRegistry;
+    private rowEditState;
+    private rowEditTimers;
+    private rowEditSavePromiseOverrides;
+    private selectionState;
+    /** cellNav state. Persists the last focused cell so the public API's
+     * getFocusedCell returns the right value across re-renders, and tracks
+     * the focused-cells history for getCurrentSelection. */
+    private cellNavLastRowCol;
+    private cellNavFocusedCells;
+    /** Infinite-scroll state. Direction flags seed from options; dataLoading
+     * + previousVisibleRows are runtime bookkeeping for saveScrollPercentage /
+     * dataRemovedTop / dataRemovedBottom. */
+    private infiniteScrollState;
+    private pipeline;
+    private labels;
+    private visibleColumns;
+    private apiRegistered;
+    private disposed;
+    private wasmEngineInitRequested;
+    private readonly subscribers;
+    readonly gridApi: UiGridApi;
+    constructor(options: GridOptions);
+    /** Disposer for the i18n language-change listener — cleared when the
+     * controller is torn down (matches the pattern used for other global
+     * subscriptions). */
+    private disposeLanguageListener;
+    dispose(): void;
+    setOptions(options: GridOptions): void;
+    /**
+     * Fast-path: swap only the row data and rebuild the pipeline without
+     * touching column state. Emits the new snapshot. The element uses this to
+     * patch cell content in-place without rebuilding the full shadow DOM.
+     */
+    refreshData(data: readonly GridRecord[]): void;
+    subscribe(subscriber: GridControllerSubscriber): () => void;
+    getSnapshot(): GridControllerSnapshot;
+    getDisplayItems(): DisplayItem[];
+    setCollapsedGroup(groupId: string, collapsed: boolean): void;
+    toggleSort(columnName: string): void;
+    sortColumn(columnName: string, direction?: SortDirection): void;
+    setFilter(columnName: string, value: string): void;
+    clearAllFilters(): void;
+    toggleGrouping(columnName: string): void;
+    clearGrouping(): void;
+    seekPage(page: number): void;
+    setPageSize(pageSize: number): void;
+    pinColumn(columnName: string, direction: PinDirection): void;
+    moveVisibleColumn(columnName: string, targetColumnName: string): void;
+    toggleRowExpansion(row: GridRow | GridRecord | string): void;
+    expandAllRows(): void;
+    collapseAllRows(): void;
+    toggleTreeRow(row: GridRow | GridRecord | string): void;
+    expandAllTreeRows(): void;
+    collapseAllTreeRows(): void;
+    setTreeRowExpanded(row: GridRow | GridRecord | string, expanded: boolean): void;
+    beginCellEdit(row: GridRow | GridRecord | string, columnName: string, triggerEvent?: Event | KeyboardEvent | null, initialValue?: string): void;
+    updateEditingValue(value: string): void;
+    commitCellEdit(): void;
+    cancelCellEdit(): void;
+    /** Internal: run a core selection mutation, raise events, trigger a render. */
+    private applySelectionChange;
+    private allGridRows;
+    toggleRowSelectionByEntity(rowEntity: GridRecord, evt?: Event | null): void;
+    selectRow(rowEntity: GridRecord, evt?: Event | null): void;
+    selectRowByVisibleIndex(rowNum: number, evt?: Event | null): void;
+    selectRowByKey(isInEntity: boolean, key: string, comparator: unknown, evt?: Event | null, lookInRows?: readonly GridRow[]): void;
+    unSelectRow(rowEntity: GridRecord, evt?: Event | null): void;
+    unSelectRowByVisibleIndex(rowNum: number, evt?: Event | null): void;
+    unSelectRowByKey(isInEntity: boolean, key: string, comparator: unknown, evt?: Event | null, lookInRows?: readonly GridRow[]): void;
+    selectAllRows(evt?: Event | null): void;
+    selectAllVisibleRows(evt?: Event | null): void;
+    clearSelectedRows(evt?: Event | null): void;
+    shiftSelectRow(rowEntity: GridRecord, evt?: Event | null): void;
+    getSelectedRows(): GridRecord[];
+    getUnSelectedRows(): GridRecord[];
+    getSelectedGridRows(): GridRow[];
+    getUnSelectedGridRows(): GridRow[];
+    setMultiSelect(multiSelect: boolean): void;
+    setModifierKeysToMultiSelect(value: boolean): void;
+    /** Focus a row by id — the old module's `row.setFocused(true)` with all
+     * the book-keeping. Raises rowFocusChanged and refreshes. */
+    setRowFocused(rowId: string, focused: boolean, evt?: Event | null): void;
+    getRowSelectionState(): Readonly<GridSelectionState>;
+    /** Resolved/defaulted selection options — exposed for the element layer
+     * so it can decide whether to wire pointer handlers without duplicating
+     * default logic. */
+    getResolvedSelectionOptions(): ReturnType<typeof resolveGridSelectionOptions>;
+    /** Public analogue of findRowById — the element uses this during drag
+     * painting to resolve a row-id back to its entity without calling the
+     * selection API methods that would double-raise events. */
+    findRowByIdPublic(rowId: string): GridRow | null;
+    /** Record a navigation event. Pushes to the focused-cells history,
+     * updates lastRowCol, and raises cellNav.navigate on the public API. */
+    setCellNavFocus(rowId: string | null, columnName: string | null, opts?: {
+        appendToSelection?: boolean;
+    }): void;
+    /** Raise viewPortKeyDown / viewPortKeyPress on behalf of the element.
+     * Element gates this with `options.keyDownOverrides`. */
+    raiseCellNavKeyEvent(type: 'keydown' | 'keypress', event: KeyboardEvent): void;
+    private cellNavGetFocusedCell;
+    private cellNavGetCurrentSelection;
+    private cellNavRowColSelectIndex;
+    private resolveCellNavRowCol;
+    /** cellNav.scrollToFocus — resolves rowEntity + colDef into a logical
+     * focus and delegates to the element (if attached) for actual scrolling.
+     * When the element isn't wired (e.g. bare controller in tests), the
+     * state still updates and the promise resolves immediately. */
+    private cellNavScrollToFocus;
+    /** Element registers its scroll-and-focus handler here so the API
+     * binding above can delegate DOM work. Controller stays DOM-free. */
+    private cellNavScrollRequest;
+    setCellNavScrollHandler(handler: ((rowId: string | null, columnName: string | null) => void) | null): void;
+    /** Read-only accessor for the current options. Used by the element to
+     * inspect keyDownOverrides / modifierKeysToMultiSelectCells without
+     * coupling it to a private field. */
+    getOptions(): GridOptions;
+    /** Evaluate whether the current scroll position should request more
+     * data at the top or bottom. Called from the element's scroll frame. */
+    evaluateInfiniteScroll(startIndex: number, visibleRows: number, viewportRows: number): void;
+    private infiniteScrollDataLoaded;
+    private infiniteScrollResetScroll;
+    private infiniteScrollSavePercentage;
+    private infiniteScrollDataRemovedTop;
+    private infiniteScrollDataRemovedBottom;
+    private infiniteScrollSetDirections;
+    /** Element registers a scroll-to-top handler here so resetScroll can
+     * bring the viewport back to 0. Keeps the controller DOM-free. */
+    private infiniteScrollScrollToTopRequest;
+    setInfiniteScrollResetHandler(handler: (() => void) | null): void;
+    /** Element-owned render benchmark. When present, `core.benchmark()`
+     * measures the actual render path instead of the controller-only
+     * pipeline builder. */
+    private benchmarkRequest;
+    setBenchmarkHandler(handler: ((iterations?: number) => Promise<GridBenchmarkResult>) | null): void;
+    getInfiniteScrollState(): Readonly<GridInfiniteScrollState>;
+    canResizeColumns(): boolean;
+    setViewportWidth(width: number): void;
+    getViewportWidth(): number;
+    setColumnWidthOverride(columnName: string, widthPx: number): void;
+    /** Returns the grid-template-columns string as if `columnName` had the given width,
+     * without triggering a full refresh. Used for smooth drag-resize DOM updates. */
+    buildTemplateColumnsWithOverride(columnName: string, widthPx: number): string;
+    isGroupingEnabled(): boolean;
+    isSortingEnabled(): boolean;
+    isFilteringEnabled(): boolean;
+    isPaginationEnabled(): boolean;
+    shouldShowPaginationControls(): boolean;
+    isTreeEnabled(): boolean;
+    isExpandableEnabled(): boolean;
+    isColumnSortable(column: GridColumnDef): boolean;
+    isColumnFilterable(column: GridColumnDef): boolean;
+    isColumnGrouped(column: GridColumnDef): boolean;
+    sortButtonLabel(column: GridColumnDef): string;
+    groupingButtonLabel(column: GridColumnDef): string;
+    filterPlaceholder(column: GridColumnDef): string;
+    getSortDirection(column: GridColumnDef): SortDirection;
+    isPinningEnabled(): boolean;
+    isColumnPinnable(column: GridColumnDef): boolean;
+    /** True when the given column is editable in principle — does NOT evaluate
+     * a per-row `cellEditableCondition`. Use isCellEditable for that. */
+    isColumnEditable(column: GridColumnDef): boolean;
+    /** True when the (row, column) cell is editable, respecting both the
+     * column's `enableCellEdit` flag and any `cellEditableCondition`. */
+    isCellEditable(row: GridRow, column: GridColumnDef): boolean;
+    isPinned(column: GridColumnDef): boolean;
+    isPinnedLeftLast(column: GridColumnDef): boolean;
+    isPinnedRightFirst(column: GridColumnDef): boolean;
+    groupDisclosureLabel(group: GroupItem): string;
+    pinnedOffset(column: GridColumnDef): {
+        side: 'left' | 'right';
+        offset: string;
+    } | null;
+    displayValue(row: GridRow, column: GridColumnDef): unknown;
+    headerLabel(column: GridColumnDef): string;
+    cellIndent(row: GridRow, column: GridColumnDef): string;
+    showTreeToggle(row: GridRow, column: GridColumnDef): boolean;
+    showExpandToggle(_row: GridRow, column: GridColumnDef): boolean;
+    isTreeRowExpanded(row: GridRow): boolean;
+    treeToggleLabel(row: GridRow): string;
+    expandToggleLabel(row: GridRow): string;
+    editorInputType(column: GridColumnDef): string;
+    isEditingCell(rowId: string, columnName: string): boolean;
+    /** Compact key for the editing cell, or null when no edit is in flight.
+     * Used by the patch path to detect when the editing position moves so it
+     * can force the affected cells through the slow rebuild path. */
+    getEditingCellKey(): string | null;
+    /**
+     * Serialise the current grid state. Mirrors `ui.grid.saveState.save`:
+     * every field is gated by an `options.save*` flag with the old grid's
+     * defaults. A missing flag keeps the matching field out of the result.
+     */
+    getState(): GridSaveState;
+    /**
+     * Apply a previously saved state. All fields are optional — missing
+     * fields are left at whatever the controller currently has. Matches the
+     * old grid's `ui.grid.saveState.restore`.
+     */
+    setState(state: Partial<GridSaveState>): void;
+    /** Element injects its scroll accessor so save() can capture scrollTop/
+     * scrollLeft. Controller stays DOM-free. */
+    private saveStateScrollSnapshot;
+    private saveStateScrollRestore;
+    setSaveStateScrollHandlers(snapshot: (() => {
+        scrollTop: number;
+        scrollLeft: number;
+    }) | null, restore: ((scrollTop: number, scrollLeft: number) => void) | null): void;
+    private refresh;
+    private maybeEnableWasmEngine;
+    private emit;
+    private findRowById;
+    private buildRowsFromData;
+    private findColumnByName;
+    private resolveRowId;
+    private getRowSize;
+    private getTotalPages;
+    private getEffectivePageSize;
+    private getCurrentPage;
+    private getFirstRowIndex;
+    private getLastRowIndex;
+    private setRowInvisible;
+    private clearRowInvisible;
+    private benchmark;
+    /** Returns the rows that match the requested exporter row-type. Mirrors
+     * the old grid's row selection logic: `all` uses the full data set (or
+     * `exporterAllDataFn` when provided), `visible` uses the current pipeline
+     * output, `selected` uses the selection state. */
+    private exporterRowsFor;
+    private resolveExporterOptions;
+    private buildCsv;
+    private exportCsv;
+    private buildPdfDocDefinition;
+    private exportPdf;
+    private buildExcelSheetData;
+    private exportExcel;
+    /** Runs the validators declared on `colDef.validators` against the new
+     * value and flips `$$invalid<col>` / `$$errors<col>` on the entity. On
+     * failure raises `validate.validationFailed`. Async validators are
+     * awaited so the caller can `await` for complete results. */
+    private validateRunValidators;
+    private validateGetFormattedErrors;
+    private validateGetTitleFormattedErrors;
+    private validateGetInvalidRows;
+    /** Test hook — exposes the validator registry so consumers can inspect or
+     * extend it outside of the gridApi surface (e.g. from a controller-level
+     * plugin). */
+    getValidatorRegistry(): GridValidatorRegistry;
+    /** Set by the element so `importAFile()` can trigger its file-picker flow.
+     * Controller stays DOM-free: it just invokes whatever handler was wired. */
+    private importerFilePickerRequest;
+    setImporterFilePickerHandler(handler: (() => void) | null): void;
+    private resolveImporterOptions;
+    private importerRequestFile;
+    private importerDispatchObjects;
+    private importerImportText;
+    private importerImportThisFile;
+    private buildExporterMenuItems;
+    /** Menu items the importer contributes. Just the single "Import"
+     * entry when the feature is enabled; returns an empty array otherwise. */
+    private buildImporterMenuItems;
+    /** Menu items row-edit contributes: "Save changes" + "Retry errored
+     * rows". Each entry is gated by both a gridOption flag and a runtime
+     * predicate (`hasDirtyRows` / `hasErrorRows`) so the menu only surfaces
+     * actions that have something to do. */
+    private buildRowEditMenuItems;
+    private rowEditSetSavePromise;
+    private rowEditGetDirtyRows;
+    private rowEditGetErrorRows;
+    private rowEditFlushDirtyRows;
+    /** Re-fires `saveRow` for every row currently in the error state. The
+     * "Retry errored rows" menu entry funnels through here. Returns a
+     * promise that resolves once every retry promise has settled. */
+    private rowEditRetryErroredRows;
+    private rowEditSetRowsDirty;
+    private rowEditSetRowsClean;
+    private considerSetRowEditTimer;
+    private cancelRowEditTimer;
+    private runRowEditSave;
+    /** Test hook — reports the current row-edit dirty / error / saving state. */
+    getRowEditState(): {
+        dirtyRowIds: string[];
+        errorRowIds: string[];
+        savingRowIds: string[];
+    };
+}
+export declare function createVanillaGridController(options: GridOptions): VanillaGridController;
+//# sourceMappingURL=grid-controller.d.ts.map

package/dist/grid-controller.d.ts.map

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

package/dist/icons.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Icon registry for the vanilla grid element.
+ *
+ * The grid draws its own sort / group / tree / expand / pin / pagination
+ * icons via inline SVGs. Consumers can override any individual icon by
+ * passing an `iconOverrides` map in GridOptions or by writing to the
+ * element's `controlIcons` property at runtime. This module owns the
+ * icon registry class plus the SVG markup helpers so the element file
+ * doesn't have to.
+ */
+export type UiGridControlIconKey = 'sortNone' | 'sortAsc' | 'sortDesc' | 'group' | 'groupExpanded' | 'groupCollapsed' | 'treeExpanded' | 'treeCollapsed' | 'expandExpanded' | 'expandCollapsed' | 'pin' | 'pinLeft' | 'pinRight' | 'paginationPrev' | 'paginationNext';
+export interface UiGridIconDefinition {
+    viewBox?: string;
+    path: string;
+}
+export type UiGridIconOverrides = Partial<Record<UiGridControlIconKey, UiGridIconDefinition>>;
+export declare const DEFAULT_ICONS: Record<UiGridControlIconKey, UiGridIconDefinition>;
+/**
+ * Holds the active set of icons (defaults merged with consumer overrides)
+ * and renders the inline SVG markup for each one. A single instance lives
+ * on the element.
+ */
+export declare class IconRegistry {
+    private overrides;
+    private resolved;
+    getOverrides(): UiGridIconOverrides;
+    setOverrides(value: UiGridIconOverrides): void;
+    resolve(key: UiGridControlIconKey): UiGridIconDefinition;
+    /** Render the SVG markup for a control icon (sort, group, pin, …). */
+    renderControlIcon(key: UiGridControlIconKey): string;
+    /** Render the SVG markup with an arbitrary wrapper class. */
+    renderIconWithClass(svgClass: string, key: UiGridControlIconKey): string;
+}
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,KAAK,GACL,SAAS,GACT,UAAU,GACV,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAE9F,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAgB5E,CAAC;AAEF;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAA4E;IAE5F,YAAY,IAAI,mBAAmB;IAInC,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAK9C,OAAO,CAAC,GAAG,EAAE,oBAAoB,GAAG,oBAAoB;IAIxD,sEAAsE;IACtE,iBAAiB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM;IAIpD,6DAA6D;IAC7D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,MAAM;CAIzE"}