@rowsncolumns/rnc-engine 1.0.0 → 1.1.1

package/dist/esm/use-spreadsheet-engine.js

@@ -1,3 +1,12 @@
+/**
+ * `useSpreadsheetEngine` — the batteries-included **Option B** hook: the engine-backed data/calc core
+ * ({@link useEngineCore}) composed with the backend-agnostic chrome ({@link useSpreadsheetUI}). It's
+ * the Option-B peer of `useSpreadsheetState` — one hook a component drives the whole grid + dialogs
+ * from. The core owns the engine surface (data/calc/commands/accessors); the chrome owns the dialogs +
+ * host intents (clipboard/citations/comments/…). Their UNION is what makes this a structural drop-in
+ * for `useSpreadsheetState` — the parity lock below is asserted here, not on either layer alone.
+ */
+import { useOnRequestCreateTable, useOnRequestDataValidation, useOnRequestEditTable, useOnRequestInsertSlicer, useOnRequestResizeTable, useSparklineGroups, } from "@rowsncolumns/spreadsheet-state";
 import { useCallback, useMemo } from "react";
 import { useEngineCore, } from "./use-engine-core";
 import { useSpreadsheetUI } from "./use-spreadsheet-ui";
@@ -7,17 +16,76 @@ export function useSpreadsheetEngine(options) {
     const core = useEngineCore(options);
     const ui = useSpreadsheetUI();
     // Insert → Checkbox / Dropdown pass a pre-built rule (checkbox with `showEditUI: false`). The
-    // chrome opener alone would drop it and only show the dialog — create the rule through the engine
-    // first, then open the dialog unless suppressed, mirroring the JS host's
-    // `useOnRequestDataValidation` (create immediately; dialog is optional edit UI on top).
+    // chrome opener alone would drop it and only show the dialog — compose the JS host's
+    // `useOnRequestDataValidation` (it hands a rule the dialog will show to the editor as a DRAFT the
+    // user's Save creates, and creates a dialog-less rule through the engine immediately), then flip
+    // the chrome flag so a `dialogs`-driven host opens the same editor.
+    const requestDataValidation = useOnRequestDataValidation({
+        onCreateDataValidationRule: core.onCreateDataValidationRule,
+    });
     const onRequestDataValidation = useCallback((sheetId, activeCell, selections, rule, showEditUI = true) => {
-        if (rule) {
-            core.onCreateDataValidationRule?.(rule);
-        }
+        requestDataValidation(sheetId, activeCell, selections, rule, showEditUI);
         if (showEditUI) {
             ui.onRequestDataValidation(sheetId, activeCell, selections, rule, showEditUI);
         }
-    }, [core, ui]);
+    }, [requestDataValidation, ui]);
+    // The Create Table dialog pre-fills its range and guesses "My table has headers" from the
+    // engine's cells, so the opener is composed here (the chrome alone has no cell access): it
+    // writes the request the `TableEditor` create dialog reads and stashes the chrome context too.
+    const requestCreateTable = useOnRequestCreateTable({
+        getEffectiveExtendedValue: core.getEffectiveExtendedValue,
+    });
+    const onRequestCreateTable = useCallback((sheetId, activeCell, selections, theme, bandedRange) => {
+        requestCreateTable(sheetId, activeCell, selections, theme, bandedRange);
+        ui.onRequestCreateTable(sheetId, activeCell, selections, theme, bandedRange);
+    }, [requestCreateTable, ui]);
+    // The Edit Table dialog is the jotai-driven `TableEditor` one (the grid's context menu, Table
+    // Design → Properties): stash the table for it and the chrome context too.
+    const requestEditTable = useOnRequestEditTable();
+    const onRequestEditTable = useCallback((table) => {
+        requestEditTable(table);
+        ui.onRequestEditTable(table);
+    }, [requestEditTable, ui]);
+    // The Resize Table dialog is the jotai-driven `TableEditor` one: stash the table for it and
+    // the chrome context too.
+    const requestResizeTable = useOnRequestResizeTable();
+    const onRequestResizeTable = useCallback((table) => {
+        requestResizeTable(table);
+        ui.onRequestResizeTable(table);
+    }, [requestResizeTable, ui]);
+    // The Insert Slicers dialog is the jotai-driven `TableEditor` one too: stash the table for it and
+    // the chrome context.
+    const requestInsertSlicer = useOnRequestInsertSlicer();
+    const onRequestInsertSlicer = useCallback((table) => {
+        requestInsertSlicer(table);
+        ui.onRequestInsertSlicer(table);
+    }, [requestInsertSlicer, ui]);
+    // Excel sparkline groups ride the engine's own `change-batch` / `delete-cells` commands, one
+    // `batch` per action — the shared hook only needs the core's writes + formula reads.
+    const sparklineGroups = useSparklineGroups({
+        onChangeBatch: core.onChangeBatch,
+        onDelete: core.onDelete,
+        batchHistory: core.batchHistory,
+        getUserEnteredValue: core.getUserEnteredValue,
+    });
     // `ui` last: its dialog-openers + host-intent defaults complete the engine core's surface.
-    return useMemo(() => ({ ...core, ...ui, onRequestDataValidation }), [core, ui, onRequestDataValidation]);
+    return useMemo(() => ({
+        ...core,
+        ...ui,
+        ...sparklineGroups,
+        onRequestDataValidation,
+        onRequestCreateTable,
+        onRequestEditTable,
+        onRequestResizeTable,
+        onRequestInsertSlicer,
+    }), [
+        core,
+        ui,
+        sparklineGroups,
+        onRequestDataValidation,
+        onRequestCreateTable,
+        onRequestEditTable,
+        onRequestResizeTable,
+        onRequestInsertSlicer,
+    ]);
 }

package/dist/esm/use-spreadsheet-ui.d.ts

@@ -15,12 +15,12 @@ import type { useSpreadsheetState } from "@rowsncolumns/spreadsheet-state";
  * exposes it (so they're drop-in for CanvasGrid's props). Erased at runtime. */
 type SS = ReturnType<typeof useSpreadsheetState>;
 /** The dialogs the chrome can open. */
-export type DialogName = "editTable" | "editEmbed" | "editSlicer" | "deleteSheet" | "namedRange" | "resize" | "formatCells" | "conditionalFormat" | "insertImage" | "insertLink" | "dataValidation" | "note";
+export type DialogName = "editTable" | "createTable" | "resizeTable" | "insertSlicer" | "editEmbed" | "editSlicer" | "deleteSheet" | "namedRange" | "resize" | "formatCells" | "conditionalFormat" | "insertImage" | "insertLink" | "dataValidation" | "note";
 /** The host/chrome slice of `useSpreadsheetState`: dialog-openers (`onRequest*`, `onInsertNote`) plus
  * the few intents the HOST genuinely owns (file drag/drop/insert). Picked from `SS` so signatures stay
  * exact. Everything that reads or mutates engine data — paint format, citations, comments, link follow,
  * CF preview — moved to {@link useEngineCore}; the chrome is backend-agnostic UI only. */
-export type ChromeParityStubs = Pick<SS, "onRequestConditionalFormat" | "onRequestDataValidation" | "onRequestDefineNamedRange" | "onRequestDeleteSheet" | "onRequestEditEmbed" | "onRequestEditSlicer" | "onRequestEditTable" | "onRequestFormatCells" | "onRequestInsertImage" | "onRequestInsertLink" | "onRequestResize" | "onRequestUpdateNamedRange" | "onInsertNote" | "onDragOver" | "onDrop" | "onInsertFile">;
+export type ChromeParityStubs = Pick<SS, "onRequestConditionalFormat" | "onRequestCreateTable" | "onRequestDataValidation" | "onRequestDefineNamedRange" | "onRequestDeleteSheet" | "onRequestEditEmbed" | "onRequestEditSlicer" | "onRequestEditTable" | "onRequestResizeTable" | "onRequestInsertSlicer" | "onRequestFormatCells" | "onRequestInsertImage" | "onRequestInsertLink" | "onRequestResize" | "onRequestUpdateNamedRange" | "onInsertNote" | "onDragOver" | "onDrop" | "onInsertFile">;
 /** Chrome state + the dialog-opener handlers + host-owned UI intents. Spread into
  * {@link useSpreadsheetEngine}'s return, where these override the engine core's omitted surface. */
 export interface SpreadsheetUI extends ChromeParityStubs {

package/dist/esm/use-spreadsheet-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-spreadsheet-ui.d.ts","sourceRoot":"","sources":["../../src/use-spreadsheet-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E;gFACgF;AAChF,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEjD,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,mBAAmB,GACnB,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,MAAM,CAAC;AAEX;;;0FAG0F;AAC1F,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,EAAE,EACA,4BAA4B,GAC5B,yBAAyB,GACzB,2BAA2B,GAC3B,sBAAsB,GACtB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,GACjB,2BAA2B,GAC3B,cAAc,GACd,YAAY,GACZ,QAAQ,GACR,cAAc,CACjB,CAAC;AAYF;oGACoG;AACpG,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C;kEAC8D;IAC9D,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,wDAAwD;IACxD,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,sBAAsB;IACtB,WAAW,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CA+HhD"}
+{"version":3,"file":"use-spreadsheet-ui.d.ts","sourceRoot":"","sources":["../../src/use-spreadsheet-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E;gFACgF;AAChF,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEjD,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,aAAa,GACb,aAAa,GACb,cAAc,GACd,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,mBAAmB,GACnB,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,MAAM,CAAC;AAEX;;;0FAG0F;AAC1F,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,EAAE,EACA,4BAA4B,GAC5B,sBAAsB,GACtB,yBAAyB,GACzB,2BAA2B,GAC3B,sBAAsB,GACtB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,sBAAsB,GACtB,uBAAuB,GACvB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,GACjB,2BAA2B,GAC3B,cAAc,GACd,YAAY,GACZ,QAAQ,GACR,cAAc,CACjB,CAAC;AAYF;oGACoG;AACpG,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C;kEAC8D;IAC9D,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,wDAAwD;IACxD,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,sBAAsB;IACtB,WAAW,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CA4JhD"}

package/dist/esm/use-spreadsheet-ui.js

@@ -19,6 +19,19 @@ export function useSpreadsheetUI() {
     // Each opener stashes the value the dialog edits, then opens it. Arg shapes come from `SS[K]`, so
     // they match exactly what CanvasGrid passes.
     const onRequestEditTable = useCallback((table) => openDialog("editTable", table), [openDialog]);
+    // The Resize Table dialog (Table Design → Resize Table, Table → Resize Table…).
+    const onRequestResizeTable = useCallback((table) => openDialog("resizeTable", table), [openDialog]);
+    // The Insert Slicers dialog (Table Design → Insert Slicer, Table → Insert Slicer…).
+    const onRequestInsertSlicer = useCallback((table) => openDialog("insertSlicer", table), [openDialog]);
+    // The Create Table dialog (Ctrl+T / Insert → Table / Format as Table). `useSpreadsheetEngine`
+    // layers the data-aware opener (pre-filled range + headers guess) over this one.
+    const onRequestCreateTable = useCallback((sheetId, activeCell, selections, theme, bandedRange) => openDialog("createTable", {
+        sheetId,
+        activeCell,
+        selections,
+        theme,
+        bandedRange,
+    }), [openDialog]);
     const onRequestEditEmbed = useCallback((embed) => openDialog("editEmbed", embed), [openDialog]);
     const onRequestEditSlicer = useCallback((slicer) => openDialog("editSlicer", slicer), [openDialog]);
     const onRequestDeleteSheet = useCallback((sheetId) => openDialog("deleteSheet", sheetId), [openDialog]);
@@ -40,6 +53,9 @@ export function useSpreadsheetUI() {
         closeDialog,
         // dialog-openers (real)
         onRequestEditTable,
+        onRequestResizeTable,
+        onRequestInsertSlicer,
+        onRequestCreateTable,
         onRequestEditEmbed,
         onRequestEditSlicer,
         onRequestDeleteSheet,
@@ -62,6 +78,9 @@ export function useSpreadsheetUI() {
         openDialog,
         closeDialog,
         onRequestEditTable,
+        onRequestResizeTable,
+        onRequestInsertSlicer,
+        onRequestCreateTable,
         onRequestEditEmbed,
         onRequestEditSlicer,
         onRequestDeleteSheet,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/rnc-engine",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "description": "Typed JS/TS interop for the Rust→WASM spreadsheet calc engine (rnc-wasm). Ergonomic JSON-in/out wrapper over the wasm-bindgen surface: applyCommand(Command)→CommitResult, readWindow→WindowSnapshot, and Map<\"sheet!A1\",CellFormat> style folding. Pluggable backend — single-user `SpreadsheetEngine` (default) or collaborative `CollabSpreadsheetEngine` (Yjs sync) — plus the Option-B `useSpreadsheetEngine` React hook.",
@@ -20,7 +20,9 @@
     "build:wasm": "cd ../../rust && RUSTUP_TOOLCHAIN=nightly wasm-pack build crates/rnc-wasm --target web --out-dir pkg -- --features collab && cp -f crates/rnc-wasm/pkg/rnc_wasm.js crates/rnc-wasm/pkg/rnc_wasm_bg.wasm crates/rnc-wasm/pkg/rnc_wasm.d.ts crates/rnc-wasm/pkg/rnc_wasm_bg.wasm.d.ts ../libs/rnc-engine/src/wasm/",
     "clean": "rimraf dist",
     "build:watch": "tsc -p ./tsconfig.esm.json --watch",
-    "test": "vitest --run"
+    "test": "vitest --run",
+    "types:specs": "node ../../scripts/typecheck-specs.mjs",
+    "types:specs:update": "node ../../scripts/typecheck-specs.mjs --update"
   },
   "files": [
     "dist"
@@ -43,13 +45,13 @@
     "react": ">=18"
   },
   "devDependencies": {
-    "@rowsncolumns/common-types": ">=5.2.33",
+    "@rowsncolumns/common-types": ">=5.2.34",
     "@rowsncolumns/dag": ">=7.2.30",
     "@rowsncolumns/grid": ">=13.2.33",
-    "@rowsncolumns/spreadsheet": ">=10.3.0",
-    "@rowsncolumns/spreadsheet-state": ">=29.0.0",
-    "@rowsncolumns/toolkit": ">=24.4.5",
-    "@rowsncolumns/utils": ">=9.3.0",
+    "@rowsncolumns/spreadsheet": ">=10.4.0",
+    "@rowsncolumns/spreadsheet-state": ">=29.1.2",
+    "@rowsncolumns/toolkit": ">=24.5.0",
+    "@rowsncolumns/utils": ">=9.4.0",
     "fflate": "^0.8.2"
   }
 }