@ornery/ui-grid-react 1.0.5 → 1.0.6

package/dist/UiGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UiGrid.d.ts","sourceRoot":"","sources":["../src/UiGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EAEvB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,WAAW,mBAAmB;IAClC,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC7E;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,WAAW,2CAqLvF"}
+{"version":3,"file":"UiGrid.d.ts","sourceRoot":"","sources":["../src/UiGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAEV,WAAW,EACX,uBAAuB,EAEvB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,WAAW,mBAAmB;IAClC,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC7E;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,WAAW,2CAsSvF"}

package/dist/index.js

@@ -58,6 +58,33 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
   const optionsRef = import_react.default.useRef(options);
   optionsRef.current = options;
   const currentSlotColumnsRef = import_react.default.useRef([]);
+  const wrapperRenderVersionRef = import_react.default.useRef(0);
+  const scheduledWrapperRenderVersionRef = import_react.default.useRef(0);
+  const wrapperRenderWaitersRef = import_react.default.useRef([]);
+  const benchmarkSubscriptionUnsubscribeRef = import_react.default.useRef(null);
+  import_react.default.useLayoutEffect(() => {
+    wrapperRenderVersionRef.current += 1;
+    const ready = wrapperRenderWaitersRef.current.filter(
+      (waiter) => waiter.target <= wrapperRenderVersionRef.current
+    );
+    if (ready.length === 0) {
+      return;
+    }
+    wrapperRenderWaitersRef.current = wrapperRenderWaitersRef.current.filter(
+      (waiter) => waiter.target > wrapperRenderVersionRef.current
+    );
+    for (const waiter of ready) {
+      waiter.resolve();
+    }
+  });
+  import_react.default.useEffect(() => {
+    return () => {
+      if (benchmarkSubscriptionUnsubscribeRef.current) {
+        benchmarkSubscriptionUnsubscribeRef.current();
+        benchmarkSubscriptionUnsubscribeRef.current = null;
+      }
+    };
+  }, []);
   import_react.default.useEffect(() => {
     const container = containerRef.current;
     if (!container) return;
@@ -81,6 +108,10 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     void mount();
     return () => {
       disposed = true;
+      if (benchmarkSubscriptionUnsubscribeRef.current) {
+        benchmarkSubscriptionUnsubscribeRef.current();
+        benchmarkSubscriptionUnsubscribeRef.current = null;
+      }
       if (el) {
         el.removeEventListener("cellSlotsChanged", handleCellSlotsChanged);
         el.remove();
@@ -109,6 +140,7 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
       const col = options.columnDefs?.find((c) => c.name === entry.columnName);
       const value = col?.field ? getNestedValue(row, col.field) : row[entry.columnName];
       if (entry.context.value !== value || entry.context.row !== row) {
+        markWrapperRenderScheduled();
         nextSlots.set(key, {
           ...entry,
           context: { ...entry.context, $implicit: value, value, row }
@@ -118,6 +150,67 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     }
     if (changed) setSlots(nextSlots);
   }, [options.data]);
+  function markWrapperRenderScheduled() {
+    scheduledWrapperRenderVersionRef.current = Math.max(
+      scheduledWrapperRenderVersionRef.current,
+      wrapperRenderVersionRef.current + 1
+    );
+  }
+  function waitForScheduledWrapperRender() {
+    const target = scheduledWrapperRenderVersionRef.current;
+    if (target <= wrapperRenderVersionRef.current) {
+      return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+      wrapperRenderWaitersRef.current.push({ target, resolve });
+    });
+  }
+  function createWrappedGridApi(api, opts) {
+    const benchmarkListeners = /* @__PURE__ */ new Set();
+    const now = () => typeof performance === "undefined" ? Date.now() : performance.now();
+    if (benchmarkSubscriptionUnsubscribeRef.current) {
+      benchmarkSubscriptionUnsubscribeRef.current();
+    }
+    benchmarkSubscriptionUnsubscribeRef.current = api.core.on.benchmarkComplete((result) => {
+      for (const listener of benchmarkListeners) {
+        listener(result);
+      }
+    });
+    return {
+      ...api,
+      core: {
+        ...api.core,
+        on: {
+          ...api.core.on,
+          benchmarkComplete: (listener) => {
+            benchmarkListeners.add(listener);
+            return () => benchmarkListeners.delete(listener);
+          }
+        },
+        benchmark: async (iterations) => {
+          const loops = Math.max(1, iterations ?? opts.benchmark?.iterations ?? 25);
+          const started = now();
+          let lastResult = null;
+          for (let index = 0; index < loops; index += 1) {
+            lastResult = await api.core.benchmark(1);
+            await waitForScheduledWrapperRender();
+          }
+          const totalMs = now() - started;
+          const result = {
+            iterations: loops,
+            totalMs,
+            averageMs: totalMs / loops,
+            visibleRows: lastResult?.visibleRows ?? 0,
+            renderedItems: lastResult?.renderedItems ?? 0
+          };
+          for (const listener of benchmarkListeners) {
+            listener(result);
+          }
+          return result;
+        }
+      }
+    };
+  }
   function applyOptions(el, opts) {
     const renderers2 = cellRenderersRef.current;
     const cellSlotColumns = [];
@@ -131,8 +224,9 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     const wrappedOptions = {
       ...opts,
       onRegisterApi: (api) => {
-        onRegisterApiRef.current?.(api);
-        opts.onRegisterApi?.(api);
+        const wrappedApi = createWrappedGridApi(api, opts);
+        onRegisterApiRef.current?.(wrappedApi);
+        opts.onRegisterApi?.(wrappedApi);
       }
     };
     el.options = wrappedOptions;
@@ -147,6 +241,9 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     const detail = event.detail;
     const el = elementRef.current;
     if (!el) return;
+    if (detail.removed.length > 0 || detail.added.length > 0) {
+      markWrapperRenderScheduled();
+    }
     setSlots((prev) => {
       const next = new Map(prev);
       for (const slot of detail.removed) {
@@ -185,7 +282,15 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
       }
     }
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { ref: containerRef, className, style: { display: "block", height: "100%", minHeight: 0 }, children: portals });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      ref: containerRef,
+      className,
+      style: { display: "block", height: "100%", minHeight: 0 },
+      children: portals
+    }
+  );
 }
 function getNestedValue(obj, field) {
   const parts = field.split(".");

package/dist/index.mjs

@@ -16,6 +16,33 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
   const optionsRef = React.useRef(options);
   optionsRef.current = options;
   const currentSlotColumnsRef = React.useRef([]);
+  const wrapperRenderVersionRef = React.useRef(0);
+  const scheduledWrapperRenderVersionRef = React.useRef(0);
+  const wrapperRenderWaitersRef = React.useRef([]);
+  const benchmarkSubscriptionUnsubscribeRef = React.useRef(null);
+  React.useLayoutEffect(() => {
+    wrapperRenderVersionRef.current += 1;
+    const ready = wrapperRenderWaitersRef.current.filter(
+      (waiter) => waiter.target <= wrapperRenderVersionRef.current
+    );
+    if (ready.length === 0) {
+      return;
+    }
+    wrapperRenderWaitersRef.current = wrapperRenderWaitersRef.current.filter(
+      (waiter) => waiter.target > wrapperRenderVersionRef.current
+    );
+    for (const waiter of ready) {
+      waiter.resolve();
+    }
+  });
+  React.useEffect(() => {
+    return () => {
+      if (benchmarkSubscriptionUnsubscribeRef.current) {
+        benchmarkSubscriptionUnsubscribeRef.current();
+        benchmarkSubscriptionUnsubscribeRef.current = null;
+      }
+    };
+  }, []);
   React.useEffect(() => {
     const container = containerRef.current;
     if (!container) return;
@@ -39,6 +66,10 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     void mount();
     return () => {
       disposed = true;
+      if (benchmarkSubscriptionUnsubscribeRef.current) {
+        benchmarkSubscriptionUnsubscribeRef.current();
+        benchmarkSubscriptionUnsubscribeRef.current = null;
+      }
       if (el) {
         el.removeEventListener("cellSlotsChanged", handleCellSlotsChanged);
         el.remove();
@@ -67,6 +98,7 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
       const col = options.columnDefs?.find((c) => c.name === entry.columnName);
       const value = col?.field ? getNestedValue(row, col.field) : row[entry.columnName];
       if (entry.context.value !== value || entry.context.row !== row) {
+        markWrapperRenderScheduled();
         nextSlots.set(key, {
           ...entry,
           context: { ...entry.context, $implicit: value, value, row }
@@ -76,6 +108,67 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     }
     if (changed) setSlots(nextSlots);
   }, [options.data]);
+  function markWrapperRenderScheduled() {
+    scheduledWrapperRenderVersionRef.current = Math.max(
+      scheduledWrapperRenderVersionRef.current,
+      wrapperRenderVersionRef.current + 1
+    );
+  }
+  function waitForScheduledWrapperRender() {
+    const target = scheduledWrapperRenderVersionRef.current;
+    if (target <= wrapperRenderVersionRef.current) {
+      return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+      wrapperRenderWaitersRef.current.push({ target, resolve });
+    });
+  }
+  function createWrappedGridApi(api, opts) {
+    const benchmarkListeners = /* @__PURE__ */ new Set();
+    const now = () => typeof performance === "undefined" ? Date.now() : performance.now();
+    if (benchmarkSubscriptionUnsubscribeRef.current) {
+      benchmarkSubscriptionUnsubscribeRef.current();
+    }
+    benchmarkSubscriptionUnsubscribeRef.current = api.core.on.benchmarkComplete((result) => {
+      for (const listener of benchmarkListeners) {
+        listener(result);
+      }
+    });
+    return {
+      ...api,
+      core: {
+        ...api.core,
+        on: {
+          ...api.core.on,
+          benchmarkComplete: (listener) => {
+            benchmarkListeners.add(listener);
+            return () => benchmarkListeners.delete(listener);
+          }
+        },
+        benchmark: async (iterations) => {
+          const loops = Math.max(1, iterations ?? opts.benchmark?.iterations ?? 25);
+          const started = now();
+          let lastResult = null;
+          for (let index = 0; index < loops; index += 1) {
+            lastResult = await api.core.benchmark(1);
+            await waitForScheduledWrapperRender();
+          }
+          const totalMs = now() - started;
+          const result = {
+            iterations: loops,
+            totalMs,
+            averageMs: totalMs / loops,
+            visibleRows: lastResult?.visibleRows ?? 0,
+            renderedItems: lastResult?.renderedItems ?? 0
+          };
+          for (const listener of benchmarkListeners) {
+            listener(result);
+          }
+          return result;
+        }
+      }
+    };
+  }
   function applyOptions(el, opts) {
     const renderers2 = cellRenderersRef.current;
     const cellSlotColumns = [];
@@ -89,8 +182,9 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     const wrappedOptions = {
       ...opts,
       onRegisterApi: (api) => {
-        onRegisterApiRef.current?.(api);
-        opts.onRegisterApi?.(api);
+        const wrappedApi = createWrappedGridApi(api, opts);
+        onRegisterApiRef.current?.(wrappedApi);
+        opts.onRegisterApi?.(wrappedApi);
       }
     };
     el.options = wrappedOptions;
@@ -105,6 +199,9 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
     const detail = event.detail;
     const el = elementRef.current;
     if (!el) return;
+    if (detail.removed.length > 0 || detail.added.length > 0) {
+      markWrapperRenderScheduled();
+    }
     setSlots((prev) => {
       const next = new Map(prev);
       for (const slot of detail.removed) {
@@ -143,7 +240,15 @@ function UiGrid({ options, onRegisterApi, cellRenderers, className }) {
       }
     }
   }
-  return /* @__PURE__ */ jsx("div", { ref: containerRef, className, style: { display: "block", height: "100%", minHeight: 0 }, children: portals });
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref: containerRef,
+      className,
+      style: { display: "block", height: "100%", minHeight: 0 },
+      children: portals
+    }
+  );
 }
 function getNestedValue(obj, field) {
   const parts = field.split(".");

package/dist/rustWasmGridEngine.d.ts

@@ -1,8 +1,7 @@
-import type { PipelineResult } from '@ornery/ui-grid-core';
 type UiGridWasmModule = {
-    build_pipeline_js(context: unknown): PipelineResult;
+    default(input?: unknown): Promise<unknown>;
 };
-export declare function registerReactUiGridWasmEngineFromModule(module: UiGridWasmModule): void;
+export declare function registerReactUiGridWasmEngineFromModule(_module: UiGridWasmModule): void;
 export declare function enableReactUiGridWasmEngine(): Promise<void>;
 export {};
 //# sourceMappingURL=rustWasmGridEngine.d.ts.map

package/dist/rustWasmGridEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rustWasmGridEngine.d.ts","sourceRoot":"","sources":["../src/rustWasmGridEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMrF,KAAK,gBAAgB,GAAG;IACtB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC;CACrD,CAAC;AAEF,wBAAgB,uCAAuC,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAMtF;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjE"}
+{"version":3,"file":"rustWasmGridEngine.d.ts","sourceRoot":"","sources":["../src/rustWasmGridEngine.ts"],"names":[],"mappings":"AAGA,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,wBAAgB,uCAAuC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CACvF;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAGjE"}

package/dist/useGridState.d.ts

@@ -108,7 +108,7 @@ export interface UseGridStateResult {
     nextPage: () => void;
     previousPage: () => void;
     onPageSizeChange: (value: string) => void;
-    runBenchmark: (iterations?: number) => GridBenchmarkResult;
+    runBenchmark: (iterations?: number) => Promise<GridBenchmarkResult>;
     exportCsv: () => void;
     onViewportScroll: (startIndex: number) => void;
 }

package/dist/useGridState.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ornery/ui-grid-react",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "React wrapper for @ornery/ui-grid-core",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -14,8 +14,8 @@
     "./styles": "./dist/ui-grid.css"
   },
   "peerDependencies": {
-    "@ornery/ui-grid-core": "1.0.5",
-    "@ornery/ui-grid-vanilla": "1.0.5",
+    "@ornery/ui-grid-core": "1.0.6",
+    "@ornery/ui-grid-vanilla": "1.0.6",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
@@ -36,8 +36,9 @@
   },
   "scripts": {
     "start": "vite serve demo --config demo/vite.config.ts",
-    "build": "npm run build --prefix ../ui-grid-core && npm run build --prefix ../ui-grid-vanilla && tsup src/index.ts --format esm,cjs --tsconfig tsconfig.build.json --external react --external react-dom --external @ornery/ui-grid-core --external @ornery/ui-grid-vanilla && tsc -p tsconfig.dts.json && node -e \"require('fs').copyFileSync('src/ui-grid.css','dist/ui-grid.css')\"",
+    "build": "tsup src/index.ts --format esm,cjs --tsconfig tsconfig.build.json --external react --external react-dom --external @ornery/ui-grid-core --external @ornery/ui-grid-vanilla && tsc -p tsconfig.dts.json && node -e \"require('fs').copyFileSync('src/ui-grid.css','dist/ui-grid.css')\"",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest"
   }
 }

package/src/UiGrid.test.tsx

@@ -274,4 +274,53 @@ describe('UiGrid React component', () => {
 
     expect(gridApi.core.getVisibleRows()).toHaveLength(3);
   });
+
+  it('row selection + expandable rows: selection toggle only repaints the affected row', async () => {
+    // Regression test for the selection+expand performance issue. The patch
+    // path's per-row fingerprint cache (in the vanilla layer) skips cells
+    // whose visual state didn't change. The React wrapper inherits this fix
+    // automatically because it mounts the same vanilla element. This test
+    // pins the end-to-end behaviour: clicking the row-selection checkbox
+    // for one row must only flip ui-grid-row-selected on that row's cells —
+    // not invalidate any visible state on the unselected rows.
+    const expandableTemplate = { createEmbeddedView: () => undefined };
+    const { gridApi, shadowRoot } = await renderGrid({
+      enableRowSelection: true,
+      enableExpandable: true,
+      expandableRowTemplate:
+        expandableTemplate as unknown as GridOptions['expandableRowTemplate'],
+    });
+
+    const cellFor = (rowId: string, column: string): HTMLElement => {
+      const el = shadowRoot.querySelector<HTMLElement>(
+        `.body-cell[data-row="${rowId}"][data-column="${column}"]`,
+      );
+      if (!el) throw new Error(`Cell ${rowId}/${column} not rendered`);
+      return el;
+    };
+
+    expect(cellFor('row-1', 'name').classList.contains('ui-grid-row-selected')).toBe(false);
+    expect(cellFor('row-2', 'name').classList.contains('ui-grid-row-selected')).toBe(false);
+    expect(cellFor('row-3', 'name').classList.contains('ui-grid-row-selected')).toBe(false);
+
+    await act(async () => {
+      gridApi.selection.selectRow(baseData[1] as Record<string, unknown>);
+    });
+
+    // row-2 must be selected, the others untouched.
+    expect(cellFor('row-1', 'name').classList.contains('ui-grid-row-selected')).toBe(false);
+    expect(cellFor('row-2', 'name').classList.contains('ui-grid-row-selected')).toBe(true);
+    expect(cellFor('row-2', 'status').classList.contains('ui-grid-row-selected')).toBe(true);
+    expect(cellFor('row-3', 'name').classList.contains('ui-grid-row-selected')).toBe(false);
+
+    // Toggling expand on row-1 must insert exactly one expandable detail
+    // row and leave selection on row-2 intact.
+    await act(async () => {
+      gridApi.expandable.toggleRowExpansion(baseData[0] as Record<string, unknown>);
+    });
+    await waitFor(() => {
+      expect(shadowRoot.querySelectorAll('.expandable-row').length).toBe(1);
+    });
+    expect(cellFor('row-2', 'name').classList.contains('ui-grid-row-selected')).toBe(true);
+  });
 });

package/src/UiGrid.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
 import { createPortal } from 'react-dom';
 import type {
+  GridBenchmarkResult,
   GridOptions,
   GridCellTemplateContext,
   GridRecord,
@@ -46,6 +47,36 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
   const optionsRef = React.useRef(options);
   optionsRef.current = options;
   const currentSlotColumnsRef = React.useRef<string[]>([]);
+  const wrapperRenderVersionRef = React.useRef(0);
+  const scheduledWrapperRenderVersionRef = React.useRef(0);
+  const wrapperRenderWaitersRef = React.useRef<Array<{ target: number; resolve: () => void }>>([]);
+  const benchmarkSubscriptionUnsubscribeRef = React.useRef<(() => void) | null>(null);
+
+  React.useLayoutEffect(() => {
+    wrapperRenderVersionRef.current += 1;
+    const ready = wrapperRenderWaitersRef.current.filter(
+      (waiter) => waiter.target <= wrapperRenderVersionRef.current,
+    );
+    if (ready.length === 0) {
+      return;
+    }
+    wrapperRenderWaitersRef.current = wrapperRenderWaitersRef.current.filter(
+      (waiter) => waiter.target > wrapperRenderVersionRef.current,
+    );
+    for (const waiter of ready) {
+      waiter.resolve();
+    }
+  });
+
+  // Clean up underlying benchmark subscription if it's still active
+  React.useEffect(() => {
+    return () => {
+      if (benchmarkSubscriptionUnsubscribeRef.current) {
+        benchmarkSubscriptionUnsubscribeRef.current();
+        benchmarkSubscriptionUnsubscribeRef.current = null;
+      }
+    };
+  }, []);
 
   // Mount the vanilla element once
   React.useEffect(() => {
@@ -77,6 +108,10 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
 
     return () => {
       disposed = true;
+      if (benchmarkSubscriptionUnsubscribeRef.current) {
+        benchmarkSubscriptionUnsubscribeRef.current();
+        benchmarkSubscriptionUnsubscribeRef.current = null;
+      }
       if (el) {
         el.removeEventListener('cellSlotsChanged', handleCellSlotsChanged);
         el.remove();
@@ -115,6 +150,7 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
       const value = col?.field ? getNestedValue(row, col.field) : row[entry.columnName];
 
       if (entry.context.value !== value || entry.context.row !== row) {
+        markWrapperRenderScheduled();
         nextSlots.set(key, {
           ...entry,
           context: { ...entry.context, $implicit: value, value, row },
@@ -127,6 +163,77 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [options.data]);
 
+  function markWrapperRenderScheduled() {
+    scheduledWrapperRenderVersionRef.current = Math.max(
+      scheduledWrapperRenderVersionRef.current,
+      wrapperRenderVersionRef.current + 1,
+    );
+  }
+
+  function waitForScheduledWrapperRender(): Promise<void> {
+    const target = scheduledWrapperRenderVersionRef.current;
+    if (target <= wrapperRenderVersionRef.current) {
+      return Promise.resolve();
+    }
+    return new Promise<void>((resolve) => {
+      wrapperRenderWaitersRef.current.push({ target, resolve });
+    });
+  }
+
+  function createWrappedGridApi(api: UiGridApi, opts: GridOptions): UiGridApi {
+    const benchmarkListeners = new Set<(result: GridBenchmarkResult) => void>();
+    const now = () => (typeof performance === 'undefined' ? Date.now() : performance.now());
+    // Clean up previous underlying subscription if it exists
+    if (benchmarkSubscriptionUnsubscribeRef.current) {
+      benchmarkSubscriptionUnsubscribeRef.current();
+    }
+    // Subscribe to underlying benchmarkComplete and forward to wrapper listeners
+    benchmarkSubscriptionUnsubscribeRef.current = api.core.on.benchmarkComplete((result) => {
+      for (const listener of benchmarkListeners) {
+        listener(result);
+      }
+    });
+
+    return {
+      ...api,
+      core: {
+        ...api.core,
+        on: {
+          ...api.core.on,
+          benchmarkComplete: (listener) => {
+            benchmarkListeners.add(listener);
+            return () => benchmarkListeners.delete(listener);
+          },
+        },
+        benchmark: async (iterations?: number) => {
+          const loops = Math.max(1, iterations ?? opts.benchmark?.iterations ?? 25);
+          const started = now();
+          let lastResult: GridBenchmarkResult | null = null;
+
+          for (let index = 0; index < loops; index += 1) {
+            lastResult = await api.core.benchmark(1);
+            await waitForScheduledWrapperRender();
+          }
+
+          const totalMs = now() - started;
+
+          const result: GridBenchmarkResult = {
+            iterations: loops,
+            totalMs,
+            averageMs: totalMs / loops,
+            visibleRows: lastResult?.visibleRows ?? 0,
+            renderedItems: lastResult?.renderedItems ?? 0,
+          };
+
+          for (const listener of benchmarkListeners) {
+            listener(result);
+          }
+          return result;
+        },
+      },
+    };
+  }
+
   function applyOptions(el: UiGridStandaloneElement, opts: GridOptions) {
     const renderers = cellRenderersRef.current;
     const cellSlotColumns: string[] = [];
@@ -142,8 +249,9 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
     const wrappedOptions: GridOptions = {
       ...opts,
       onRegisterApi: (api) => {
-        onRegisterApiRef.current?.(api as UiGridApi);
-        opts.onRegisterApi?.(api);
+        const wrappedApi = createWrappedGridApi(api as UiGridApi, opts);
+        onRegisterApiRef.current?.(wrappedApi);
+        opts.onRegisterApi?.(wrappedApi);
       },
     };
 
@@ -151,8 +259,7 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
 
     const prev = currentSlotColumnsRef.current;
     const columnsChanged =
-      cellSlotColumns.length !== prev.length ||
-      cellSlotColumns.some((name, i) => name !== prev[i]);
+      cellSlotColumns.length !== prev.length || cellSlotColumns.some((name, i) => name !== prev[i]);
 
     if (columnsChanged) {
       currentSlotColumnsRef.current = cellSlotColumns;
@@ -164,6 +271,9 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
     const detail = (event as CustomEvent<FrameworkSlotDelta<FrameworkCellSlot>>).detail;
     const el = elementRef.current;
     if (!el) return;
+    if (detail.removed.length > 0 || detail.added.length > 0) {
+      markWrapperRenderScheduled();
+    }
 
     setSlots((prev) => {
       const next = new Map(prev);
@@ -212,7 +322,11 @@ export function UiGrid({ options, onRegisterApi, cellRenderers, className }: UiG
   }
 
   return (
-    <div ref={containerRef} className={className} style={{ display: 'block', height: '100%', minHeight: 0 }}>
+    <div
+      ref={containerRef}
+      className={className}
+      style={{ display: 'block', height: '100%', minHeight: 0 }}
+    >
       {portals}
     </div>
   );

package/src/rustWasmGridEngine.test.ts

@@ -1,12 +1,8 @@
 import { beforeEach, describe, expect, it } from 'vitest';
-import {
-  activeGridEngineBackend,
-  clearRustWasmGridEngine,
-  defaultGridEngine,
-} from '@ornery/ui-grid-core';
+import { activeGridEngineBackend, clearRustWasmGridEngine, defaultGridEngine } from '@ornery/ui-grid-core';
 import { registerReactUiGridWasmEngineFromModule } from './rustWasmGridEngine';
 import { SORT_DIRECTIONS } from '@ornery/ui-grid-core';
-import type { BuildGridPipelineContext, PipelineResult } from '@ornery/ui-grid-core';
+import type { BuildGridPipelineContext } from '@ornery/ui-grid-core';
 
 function createContext(): BuildGridPipelineContext {
   return {
@@ -37,20 +33,15 @@ describe('rustWasmGridEngine', () => {
     clearRustWasmGridEngine();
   });
 
-  it('registers the real module shape into the shared engine seam', () => {
-    const sentinel: PipelineResult = {
-      visibleRows: [],
-      displayItems: [],
-      virtualizationEnabled: true,
-      pipelineMs: 0,
-      totalItems: 77,
-    };
-
+  it('does not install a wasm pipeline engine through the React helper', () => {
     registerReactUiGridWasmEngineFromModule({
-      build_pipeline_js: () => sentinel,
+      default: async () => undefined,
     });
 
-    expect(defaultGridEngine.buildPipeline(createContext())).toBe(sentinel);
-    expect(activeGridEngineBackend()).toBe('rust-wasm');
+    expect(defaultGridEngine.buildPipeline(createContext()).visibleRows.map((row) => row.id)).toEqual([
+      'react-engine-spec-0',
+      'react-engine-spec-1',
+    ]);
+    expect(activeGridEngineBackend()).toBe('typescript');
   });
 });

package/src/rustWasmGridEngine.ts

@@ -1,23 +1,14 @@
-import type { BuildGridPipelineContext, PipelineResult } from '@ornery/ui-grid-core';
-import { registerRustWasmGridEngine } from '@ornery/ui-grid-core';
-
 const uiGridWasmModulePath = '../../../dist/ui-grid-wasm-web/ui_grid_wasm.js';
 const uiGridWasmBinaryPath = '/dist/ui-grid-wasm-web/ui_grid_wasm_bg.wasm';
 
 type UiGridWasmModule = {
-  build_pipeline_js(context: unknown): PipelineResult;
+  default(input?: unknown): Promise<unknown>;
 };
 
-export function registerReactUiGridWasmEngineFromModule(module: UiGridWasmModule): void {
-  registerRustWasmGridEngine({
-    buildPipeline(context: BuildGridPipelineContext): PipelineResult {
-      return module.build_pipeline_js(context);
-    },
-  });
+export function registerReactUiGridWasmEngineFromModule(_module: UiGridWasmModule): void {
 }
 
 export async function enableReactUiGridWasmEngine(): Promise<void> {
   const module = await import(/* @vite-ignore */ uiGridWasmModulePath);
   await module.default(uiGridWasmBinaryPath);
-  registerReactUiGridWasmEngineFromModule(module);
 }

package/src/useGridState.ts

@@ -316,7 +316,7 @@ export interface UseGridStateResult {
   nextPage: () => void;
   previousPage: () => void;
   onPageSizeChange: (value: string) => void;
-  runBenchmark: (iterations?: number) => GridBenchmarkResult;
+  runBenchmark: (iterations?: number) => Promise<GridBenchmarkResult>;
   exportCsv: () => void;
   onViewportScroll: (startIndex: number) => void;
 }
@@ -1070,11 +1070,19 @@ export function useGridState(
     [focusRenderedCell, isCellEditable, shouldEditOnFocusFn, startCellEditFn],
   );
 
-  const runBenchmarkFn = useCallback((iterations?: number): GridBenchmarkResult => {
+  const runBenchmarkFn = useCallback(async (iterations?: number): Promise<GridBenchmarkResult> => {
     const safeIterations = resolveBenchmarkIterations(
       iterations,
       optionsRef.current.benchmark?.iterations,
     );
+    const nextFrame = () =>
+      new Promise<void>((resolve) => {
+        if (typeof requestAnimationFrame === 'undefined') {
+          setTimeout(resolve, 0);
+          return;
+        }
+        requestAnimationFrame(() => resolve());
+      });
     const startedAt = performance.now();
     let lastResult = defaultGridEngine.buildPipeline({
       options: optionsRef.current,
@@ -1118,6 +1126,7 @@ export function useGridState(
     };
 
     setBenchmarkResult(result);
+    await nextFrame();
     raiseGridBenchmarkComplete(gridApiRef.current!, result);
     return result;
   }, []);

package/tsconfig.json

@@ -11,5 +11,5 @@
       "@ornery/ui-grid-vanilla": ["../ui-grid-vanilla/src/index.ts"]
     }
   },
-  "include": ["src"]
+  "include": ["src", "../ui-grid-vanilla/src/scss.d.ts"]
 }

package/vitest.config.ts

@@ -9,8 +9,15 @@ export default defineConfig({
     },
   },
   test: {
-    environment: 'jsdom',
+    environment: 'happy-dom',
     globals: true,
     setupFiles: ['./src/test-setup.ts'],
+    coverage: {
+      provider: 'v8',
+      include: ['src/**/*.ts', 'src/**/*.tsx'],
+      exclude: ['src/**/*.test.ts', 'src/**/*.test.tsx', 'src/**/*.spec.ts', 'src/test-setup.ts'],
+      reporter: ['text', 'lcov', 'html'],
+      reportsDirectory: './coverage',
+    },
   },
 });