@ornery/ui-grid-vanilla 1.0.5 → 1.0.7

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { GridCellTemplateContext, GridLabels, GridExpandableTemplateContext, GridColumnDef, GridHeaderTemplateContext, GridRow, GroupItem, GridOptions, PipelineResult, SortState, PinnedColumnState, GridCellPosition, UiGridApi, GridRecord, DisplayItem, SortDirection, PinDirection, GridSelectionState, resolveGridSelectionOptions, GridInfiniteScrollState, GridValidatorRegistry, BuildGridPipelineContext } from '@ornery/ui-grid-core';
+import { GridCellTemplateContext, GridLabels, GridExpandableTemplateContext, GridColumnDef, GridHeaderTemplateContext, GridRow, GroupItem, GridOptions, PipelineResult, SortState, PinnedColumnState, GridCellPosition, UiGridApi, GridRecord, DisplayItem, SortDirection, PinDirection, GridSelectionState, resolveGridSelectionOptions, GridBenchmarkResult, GridInfiniteScrollState, GridValidatorRegistry } from '@ornery/ui-grid-core';
 export { GridOptions, UiGridApi } from '@ornery/ui-grid-core';
 
 /**
@@ -127,6 +127,17 @@ declare class FrameworkSlotBridge {
     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;
@@ -280,6 +291,8 @@ declare class VanillaGridController {
     private labels;
     private visibleColumns;
     private apiRegistered;
+    private disposed;
+    private wasmEngineInitRequested;
     private readonly subscribers;
     readonly gridApi: UiGridApi;
     constructor(options: GridOptions);
@@ -390,6 +403,11 @@ declare class VanillaGridController {
      * 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;
@@ -438,6 +456,10 @@ declare class VanillaGridController {
     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
@@ -459,6 +481,7 @@ declare class VanillaGridController {
         scrollLeft: number;
     }) | null, restore: ((scrollTop: number, scrollLeft: number) => void) | null): void;
     private refresh;
+    private maybeEnableWasmEngine;
     private emit;
     private findRowById;
     private buildRowsFromData;
@@ -547,6 +570,12 @@ type VanillaUiGridElement = HTMLElement & {
      * remains completely smooth while data ticks in the background.
      */
     setData(rows: GridRecord[]): void;
+    /**
+     * Declare which slots the grid should emit as `<slot>` placeholders for a
+     * framework wrapper to project into. See `FrameworkSlotBridge` for the
+     * full contract.
+     */
+    setFrameworkRenderedSlots(config: FrameworkRenderedSlotsConfig): void;
 };
 type VanillaGridOptions = GridOptions & {
     iconOverrides?: UiGridIconOverrides;
@@ -598,6 +627,18 @@ declare class UiGridStandaloneElement extends HTMLElement {
     /** @internal */ lastItemsFingerprint: string | null;
     /** @internal */ lastVirtualOffset: number;
     /** @internal */ lastTotalVirtualHeight: number;
+    /**
+     * @internal Per-row visual-state fingerprint from the previous patch pass.
+     * The patch path uses this to skip cells whose row state hasn't changed
+     * (selection, expand, dirty/saving/error flags) when the structure
+     * fingerprint matches. Cleared on full re-render.
+     */
+    lastRowStateFingerprints: Map<string, {
+        fingerprint: string;
+        entity: unknown;
+    }>;
+    /** @internal */ lastEditingCellKey: string | null;
+    /** @internal */ lastFocusedCellKey: string | null;
     /**
      * @internal Framework-rendered slot bridge. See `./framework-slots.ts`.
      */
@@ -717,6 +758,7 @@ declare class UiGridStandaloneElement extends HTMLElement {
     private patchCells;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private benchmarkRender;
     /** @internal */
     ensureShadowRoot(): ShadowRoot;
     /** @internal */
@@ -854,7 +896,6 @@ declare class UIGridTemplate extends HTMLTemplateElement {
 
 interface UiGridRustWebModule {
     default(input?: unknown): Promise<unknown>;
-    build_pipeline_js(context: BuildGridPipelineContext): PipelineResult;
 }
 
 declare function registerVanillaUiGridRustModule(module: UiGridRustWebModule, input?: unknown): Promise<void>;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { GridCellTemplateContext, GridLabels, GridExpandableTemplateContext, GridColumnDef, GridHeaderTemplateContext, GridRow, GroupItem, GridOptions, PipelineResult, SortState, PinnedColumnState, GridCellPosition, UiGridApi, GridRecord, DisplayItem, SortDirection, PinDirection, GridSelectionState, resolveGridSelectionOptions, GridInfiniteScrollState, GridValidatorRegistry, BuildGridPipelineContext } from '@ornery/ui-grid-core';
+import { GridCellTemplateContext, GridLabels, GridExpandableTemplateContext, GridColumnDef, GridHeaderTemplateContext, GridRow, GroupItem, GridOptions, PipelineResult, SortState, PinnedColumnState, GridCellPosition, UiGridApi, GridRecord, DisplayItem, SortDirection, PinDirection, GridSelectionState, resolveGridSelectionOptions, GridBenchmarkResult, GridInfiniteScrollState, GridValidatorRegistry } from '@ornery/ui-grid-core';
 export { GridOptions, UiGridApi } from '@ornery/ui-grid-core';
 
 /**
@@ -127,6 +127,17 @@ declare class FrameworkSlotBridge {
     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;
@@ -280,6 +291,8 @@ declare class VanillaGridController {
     private labels;
     private visibleColumns;
     private apiRegistered;
+    private disposed;
+    private wasmEngineInitRequested;
     private readonly subscribers;
     readonly gridApi: UiGridApi;
     constructor(options: GridOptions);
@@ -390,6 +403,11 @@ declare class VanillaGridController {
      * 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;
@@ -438,6 +456,10 @@ declare class VanillaGridController {
     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
@@ -459,6 +481,7 @@ declare class VanillaGridController {
         scrollLeft: number;
     }) | null, restore: ((scrollTop: number, scrollLeft: number) => void) | null): void;
     private refresh;
+    private maybeEnableWasmEngine;
     private emit;
     private findRowById;
     private buildRowsFromData;
@@ -547,6 +570,12 @@ type VanillaUiGridElement = HTMLElement & {
      * remains completely smooth while data ticks in the background.
      */
     setData(rows: GridRecord[]): void;
+    /**
+     * Declare which slots the grid should emit as `<slot>` placeholders for a
+     * framework wrapper to project into. See `FrameworkSlotBridge` for the
+     * full contract.
+     */
+    setFrameworkRenderedSlots(config: FrameworkRenderedSlotsConfig): void;
 };
 type VanillaGridOptions = GridOptions & {
     iconOverrides?: UiGridIconOverrides;
@@ -598,6 +627,18 @@ declare class UiGridStandaloneElement extends HTMLElement {
     /** @internal */ lastItemsFingerprint: string | null;
     /** @internal */ lastVirtualOffset: number;
     /** @internal */ lastTotalVirtualHeight: number;
+    /**
+     * @internal Per-row visual-state fingerprint from the previous patch pass.
+     * The patch path uses this to skip cells whose row state hasn't changed
+     * (selection, expand, dirty/saving/error flags) when the structure
+     * fingerprint matches. Cleared on full re-render.
+     */
+    lastRowStateFingerprints: Map<string, {
+        fingerprint: string;
+        entity: unknown;
+    }>;
+    /** @internal */ lastEditingCellKey: string | null;
+    /** @internal */ lastFocusedCellKey: string | null;
     /**
      * @internal Framework-rendered slot bridge. See `./framework-slots.ts`.
      */
@@ -717,6 +758,7 @@ declare class UiGridStandaloneElement extends HTMLElement {
     private patchCells;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private benchmarkRender;
     /** @internal */
     ensureShadowRoot(): ShadowRoot;
     /** @internal */
@@ -854,7 +896,6 @@ declare class UIGridTemplate extends HTMLTemplateElement {
 
 interface UiGridRustWebModule {
     default(input?: unknown): Promise<unknown>;
-    build_pipeline_js(context: BuildGridPipelineContext): PipelineResult;
 }
 
 declare function registerVanillaUiGridRustModule(module: UiGridRustWebModule, input?: unknown): Promise<void>;