@ornery/ui-grid-vanilla 1.0.4 → 1.0.6

package/demo/main.ts

@@ -1,7 +1,6 @@
 import { mountVanillaUiGrid } from '../src/index';
 import type { GridOptions, UiGridApi } from '../src/index';
 import type { GridBenchmarkResult } from '@ornery/ui-grid-core';
-import * as uiGridRustWebModule from '../../../dist/ui-grid-wasm-web/ui_grid_wasm.js';
 
 const statuses = ['Active', 'Expansion', 'Enterprise', 'Pilot'] as const;
 const companies = ['Northwind', 'Blue Harbor', 'Forge Group', 'Larkspur', 'Atlas'] as const;
@@ -113,7 +112,7 @@ exportButton?.addEventListener('click', () => {
   gridApi?.core.exportCsv();
 });
 
-void mountVanillaUiGrid(mountPoint, options, uiGridRustWebModule).catch((error) => {
+void mountVanillaUiGrid(mountPoint, options).catch((error) => {
   console.error(error);
   mountPoint.textContent = error instanceof Error ? error.message : String(error);
 });

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;
@@ -390,6 +401,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 +454,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
@@ -547,6 +567,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 +624,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 +755,7 @@ declare class UiGridStandaloneElement extends HTMLElement {
     private patchCells;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private benchmarkRender;
     /** @internal */
     ensureShadowRoot(): ShadowRoot;
     /** @internal */
@@ -854,7 +893,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;
@@ -390,6 +401,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 +454,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
@@ -547,6 +567,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 +624,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 +755,7 @@ declare class UiGridStandaloneElement extends HTMLElement {
     private patchCells;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private benchmarkRender;
     /** @internal */
     ensureShadowRoot(): ShadowRoot;
     /** @internal */
@@ -854,7 +893,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>;