@rowsncolumns/spreadsheet-state 28.0.75 → 29.0.0

package/dist/esm/hooks/use-spreadsheet-state.js

@@ -4,7 +4,7 @@ import { createNewSheet, DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, useGetCellDime
 import { useFonts } from "@rowsncolumns/spreadsheet";
 import { getBandedCells } from "@rowsncolumns/spreadsheet";
 import { defaultSpreadsheetTheme, useCallbackRef, useSpreadsheetTheme, } from "@rowsncolumns/spreadsheet";
-import { findMatchingBandProperty, getCurrentLocale, isNil, setDefaultEnableAtFormula, uuid, } from "@rowsncolumns/utils";
+import { findMatchingBandProperty, getCurrentLocale, getFormulaLocale, isNil, setDefaultEnableAtFormula, uuid, } from "@rowsncolumns/utils";
 import { enableMapSet, enablePatches, setUseStrictShallowCopy } from "immer";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { getAutoFillValues as defaultGetAutoFillValues } from "../api/fill";
@@ -14,12 +14,13 @@ import { useCalculation } from "./use-calculation";
 import { useCalculationInitialize } from "./use-calculation-initialize";
 import { useCalculationWorker } from "./use-calculation-worker";
 import { useCellXfsRegistry } from "./use-cellxfs-registry";
-import { useComments } from "./use-comments";
 import { useCitations } from "./use-citations";
+import { useComments } from "./use-comments";
 import { useConditionalFormattingRules } from "./use-conditional-formatting-rules";
 import { useDataValidationRules } from "./use-data-validation-rules";
 import { useIndent } from "./use-indent";
 import { useNamedRange } from "./use-named-range";
+import { useOnAdvancedFilter } from "./use-on-advanced-filter";
 import { useOnAutoResize } from "./use-on-autoresize";
 import { useOnBandedRanges } from "./use-on-banded-ranges";
 import { useOnCalculationBegin } from "./use-on-calculation-begin";
@@ -32,6 +33,8 @@ import { useOnChangeFormatting } from "./use-on-change-formatting";
 import { useOnChangeSheetTabcolor } from "./use-on-change-sheet-tabcolor";
 import { useOnChangeTheme } from "./use-on-change-theme";
 import { useOnClearFormatting } from "./use-on-clear-formatting";
+import { useOnCollapseColumnGroup } from "./use-on-collapse-column-group";
+import { useOnCollapseRowGroup } from "./use-on-collapse-row-group";
 import { useOnCopy } from "./use-on-copy";
 import { useOnCreateNamedRange } from "./use-on-create-named-range";
 import { useOnCreateNewSheet } from "./use-on-create-sheet";
@@ -46,23 +49,18 @@ import { useOnDeleteTableRow } from "./use-on-delete-table-row";
 import { useOnDragnDrop } from "./use-on-drag-n-drop";
 import { useOnDuplicateSheet } from "./use-on-duplicate-sheet";
 import { useOnEmbeds } from "./use-on-embeds";
-import { useSlicers } from "./use-slicers";
+import { useOnExpandColumnGroup } from "./use-on-expand-column-group";
+import { useOnExpandRowGroup } from "./use-on-expand-row-group";
 import { useOnFill } from "./use-on-fill";
 import { useOnFillRange } from "./use-on-fill-range";
 import { useOnFilterTable } from "./use-on-filter-table";
 import { useOnFindReplace } from "./use-on-find-replace";
 import { useOnFreeze } from "./use-on-freeze";
-import { useOnCollapseColumnGroup } from "./use-on-collapse-column-group";
-import { useOnCollapseRowGroup } from "./use-on-collapse-row-group";
-import { useOnExpandColumnGroup } from "./use-on-expand-column-group";
-import { useOnExpandRowGroup } from "./use-on-expand-row-group";
+import { useOnGoalSeek } from "./use-on-goal-seek";
 import { useOnGroupColumns } from "./use-on-group-columns";
 import { useOnGroupRows } from "./use-on-group-rows";
-import { useOnSetOutlineDepth } from "./use-on-set-outline-depth";
 import { useOnHideColumn } from "./use-on-hide-column";
 import { useOnHideRow } from "./use-on-hide-row";
-import { useOnUngroupColumns } from "./use-on-ungroup-columns";
-import { useOnUngroupRows } from "./use-on-ungroup-rows";
 import { useOnShowHideSheet } from "./use-on-hide-show-sheet";
 import { useOnImportCSV } from "./use-on-import-csv";
 import { useOnImportCSVLegacy } from "./use-on-import-csv-legacy";
@@ -80,14 +78,20 @@ import { useOnInsertNote } from "./use-on-insert-note";
 import { useOnInsertRow } from "./use-on-insert-row";
 import { useOnInsertTableRow } from "./use-on-insert-table-row";
 import { useOnInsertTime } from "./use-on-insert-time";
+import { useOnLocaleChange } from "./use-on-locale-change";
 import { useOnMergeUnMergeCells } from "./use-on-merge-unmerge-cells";
 import { useOnMoveColumns } from "./use-on-move-columns";
 import { useOnMoveRows } from "./use-on-move-rows";
 import { useOnMoveSelection } from "./use-on-move-selection";
+import { planInsertCutCells } from "../api/insert-cut-cells";
+import { findPartiallyCoveredMerge, MERGED_CELL_MOVE_ERROR } from "../api/merges";
+import { useShowError } from "../atoms/error-state.atom";
+import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
 import { useOnMoveSheet } from "./use-on-move-sheet";
 import { useOnPaste } from "./use-on-paste";
 import { useOnProtectRange } from "./use-on-protect-range";
 import { useOnProtectSheet } from "./use-on-protect-sheet";
+import { useOnRemoveDuplicates } from "./use-on-remove-duplicates";
 import { useOnRenameSheet } from "./use-on-rename-sheet";
 import { useOnRequestCalculateWrapper } from "./use-on-request-calculate-wrapper";
 import { useOnRequestConditionalFormat } from "./use-on-request-conditional-format";
@@ -102,13 +106,17 @@ import { useOnRequestResize } from "./use-on-request-resize";
 import { useOnRequestUpdateNamedRange } from "./use-on-request-update-named-range";
 import { useOnResize } from "./use-on-resize";
 import { useOnResizeTable } from "./use-on-resize-table";
+import { useOnSetOutlineDepth } from "./use-on-set-outline-depth";
 import { useOnShowColumn } from "./use-on-show-column";
 import { useOnShowRow } from "./use-on-show-row";
 import { useOnSortColumn } from "./use-on-sort-column";
 import { useOnSortRange } from "./use-on-sort-range";
 import { useOnSortTable } from "./use-on-sort-table";
+import { useOnSubtotal } from "./use-on-subtotal";
 import { useOnTable } from "./use-on-table";
 import { useOnTraceDependentsPrecedents } from "./use-on-trace-dependents-precedents";
+import { useOnUngroupColumns } from "./use-on-ungroup-columns";
+import { useOnUngroupRows } from "./use-on-ungroup-rows";
 import { useOnUpdateNamedRange } from "./use-on-update-named-range";
 import { useOnUpdateNote } from "./use-on-update-note";
 import { useOnUpdateSheet } from "./use-on-update-sheet";
@@ -118,12 +126,8 @@ import { useSheetObserver } from "./use-sheet-observer";
 import { useSheetProperties } from "./use-sheet-properties";
 import { useSheetState } from "./use-sheet-state";
 import { useSheetDataSubscriber } from "./use-sheetdata-subscriber";
+import { useSlicers } from "./use-slicers";
 import { useSplitTextToColumns } from "./use-split-text-to-columns";
-import { useOnLocaleChange } from "./use-on-locale-change";
-import { useOnRemoveDuplicates } from "./use-on-remove-duplicates";
-import { useOnGoalSeek } from "./use-on-goal-seek";
-import { useOnSubtotal } from "./use-on-subtotal";
-import { useOnAdvancedFilter } from "./use-on-advanced-filter";
 import { useSharedStringRegistry } from "./use-ss-registry";
 import { useStructuredReference } from "./use-structured-reference";
 import { useUndoRedo } from "./use-undo-redo";
@@ -227,7 +231,7 @@ enableDragnDrop = true,
 // Enable undo/redo functionality
 enabledUndoRedo = true, 
 // Current locale
-locale = getCurrentLocale(), 
+locale = getCurrentLocale(), formulaLocale: formulaLocaleProp, 
 // Templates for auto-generated names (sheets, tables, table columns)
 generatedNames: generatedNamesProp, enableAtFormula = false, 
 // Preserve data formatting like color, font style on paste
@@ -528,7 +532,7 @@ sanitizeHtml, }) => {
         enabled: calculationMode !== "worker",
     });
     // Use the appropriate calculation hook based on mode
-    const { enqueueCalculation, enqueueGraphOperation, enqueueStructureChange, clearRangeCache, onRequestCalculate: onRequestCalculateWithoutFormatting, getPrecedents, getDependents, getPrecedentsFromFormulaString, getGraphNodes, getGraphNodesInSheet, addStaticReference, addFormulaToGraph, removeStaticReference, onResetCalculator, getDependencyGraph, updateDependencyGraph, isArrayFormula, applyNamedRanges, } = calculationMode === "worker" ? workerCalculation : singleCalculation;
+    const { enqueueCalculation, enqueueGraphOperation, enqueueStructureChange, clearRangeCache, onRequestCalculate: onRequestCalculateWithoutFormatting, getPrecedents, getDependents, getPrecedentsFromFormulaString, getGraphNodes, getGraphNodesInSheet, addStaticReference, addFormulaToGraph, removeStaticReference, onResetCalculator, getDependencyGraph, updateDependencyGraph, isArrayFormula, getArrayRange, applyNamedRanges, } = calculationMode === "worker" ? workerCalculation : singleCalculation;
     // Bind the forward-ref so `useSheetProperties.getEffectiveFormat` can walk
     // precedents now that the calculator is initialised.
     getPrecedentsRef.current = getPrecedents;
@@ -960,6 +964,8 @@ sanitizeHtml, }) => {
         onCommand,
     });
     // Locale change - regenerate formatted values and normalize validation rules
+    // The formula syntax the editors speak — Excel follows the user's language, so `locale` by default.
+    const formulaLocale = useMemo(() => getFormulaLocale(formulaLocaleProp ?? locale), [formulaLocaleProp, locale]);
     const onChangeLocale = useOnLocaleChange({
         cellXfsRegistry,
         sharedStringRegistry,
@@ -1052,8 +1058,14 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     });
     // Delete row
     const onDeleteColumn = useOnDeleteColumn({
@@ -1080,8 +1092,14 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     });
     // Delete cells shift up
     const onDeleteCellsShiftUp = useOnDeleteCellsShiftUp({
@@ -1093,13 +1111,19 @@ sanitizeHtml, }) => {
         getActiveCell,
         getSelections,
         getDependents,
+        getSheetName,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
         createHistory,
         onChangeSheets,
         onChangeSheetData,
+        onChangeTables,
+        onChangeCitations,
         onCommand,
+        sheetData,
+        sheets,
+        tables,
     });
     // Delete cells shift left
     const onDeleteCellsShiftLeft = useOnDeleteCellsShiftLeft({
@@ -1111,13 +1135,19 @@ sanitizeHtml, }) => {
         getActiveCell,
         getSelections,
         getDependents,
+        getSheetName,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
         createHistory,
         onChangeSheets,
         onChangeSheetData,
+        onChangeTables,
+        onChangeCitations,
         onCommand,
+        sheetData,
+        sheets,
+        tables,
     });
     // Insert cells shift right
     const onInsertCellsShiftRight = useOnInsertCellsShiftRight({
@@ -1129,13 +1159,19 @@ sanitizeHtml, }) => {
         getActiveCell,
         getSelections,
         getDependents,
+        getSheetName,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
         createHistory,
         onChangeSheets,
         onChangeSheetData,
+        onChangeTables,
+        onChangeCitations,
         onCommand,
+        sheetData,
+        sheets,
+        tables,
     });
     // Delete cells shift up
     const onInsertCellsShiftDown = useOnInsertCellsShiftDown({
@@ -1147,13 +1183,19 @@ sanitizeHtml, }) => {
         getActiveCell,
         getSelections,
         getDependents,
+        getSheetName,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
         createHistory,
         onChangeSheets,
         onChangeSheetData,
+        onChangeTables,
+        onChangeCitations,
         onCommand,
+        sheetData,
+        sheets,
+        tables,
     });
     // Insert row
     const onInsertRow = useOnInsertRow({
@@ -1161,6 +1203,7 @@ sanitizeHtml, }) => {
         columnCount,
         locale,
         maxRowCount,
+        sheetData,
         cellXfsRegistry,
         getActiveCell,
         getSelections,
@@ -1177,6 +1220,10 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         onChangeTables,
         getSheetName,
         onCommand,
@@ -1188,6 +1235,7 @@ sanitizeHtml, }) => {
         locale,
         tables,
         maxColumnCount,
+        sheetData,
         cellXfsRegistry,
         sharedStringRegistry,
         getDependents,
@@ -1204,6 +1252,10 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         getActiveCell,
         getSelections,
         getSheetName,
@@ -1253,6 +1305,7 @@ sanitizeHtml, }) => {
     const onMoveSelection = useOnMoveSelection({
         rowCount,
         columnCount,
+        getSheetMerges: getPaintMerges,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
@@ -1273,6 +1326,72 @@ sanitizeHtml, }) => {
         sharedStringRegistry,
         onCommand,
     });
+    // Excel "Insert Cut Cells" / Shift+drag for a cell range, as the three structural steps the
+    // hooks above own (`planInsertCutCells`): open the destination band, move the block into the
+    // opening, close the gap it left — so Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6 and
+    // a forward move lands before Excel's pre-removal reference row. The refusals are decided up
+    // front — a merge the block or a shifted band covers only partially, a protected range — so a
+    // refused move never leaves the band opened. Each step records its own undo entry.
+    const showError = useShowError();
+    const canEditCellRange = useCanEditCellRange();
+    const canPerformSheetAction = useCanPerformSheetAction();
+    const onInsertCutCells = useCallback((sheetId, from, to) => {
+        const plan = planInsertCutCells(from.range, to.range);
+        if (!plan) {
+            return;
+        }
+        const merges = getPaintMerges(sheetId);
+        if ([from.range, to.range, ...plan.bands].some((range) => findPartiallyCoveredMerge(range, merges))) {
+            showError({ message: MERGED_CELL_MOVE_ERROR });
+            return;
+        }
+        const vertical = plan.shift === "down";
+        if (!canEditCellRange(sheetId, from.range) ||
+            !canEditCellRange(sheetId, to.range) ||
+            !canPerformSheetAction(sheetId, vertical ? "insertRows" : "insertColumns") ||
+            !canPerformSheetAction(sheetId, vertical ? "deleteRows" : "deleteColumns")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't move cells on a protected sheet.",
+            });
+            return;
+        }
+        const target = {
+            rowIndex: to.range.startRowIndex,
+            columnIndex: to.range.startColumnIndex,
+        };
+        if (vertical) {
+            onInsertCellsShiftDown(sheetId, target, [to]);
+        }
+        else {
+            onInsertCellsShiftRight(sheetId, target, [to]);
+        }
+        const source = {
+            ...from,
+            range: plan.shiftedSource,
+        };
+        onMoveSelection(sheetId, source, to);
+        const vacated = {
+            rowIndex: plan.shiftedSource.startRowIndex,
+            columnIndex: plan.shiftedSource.startColumnIndex,
+        };
+        if (vertical) {
+            onDeleteCellsShiftUp(sheetId, vacated, [source]);
+        }
+        else {
+            onDeleteCellsShiftLeft(sheetId, vacated, [source]);
+        }
+    }, [
+        getPaintMerges,
+        showError,
+        canEditCellRange,
+        canPerformSheetAction,
+        onInsertCellsShiftDown,
+        onInsertCellsShiftRight,
+        onDeleteCellsShiftUp,
+        onDeleteCellsShiftLeft,
+        onMoveSelection,
+    ]);
     // Sort column
     const onSortColumn = useOnSortColumn({
         rowCount,
@@ -1368,6 +1487,8 @@ sanitizeHtml, }) => {
         columnCount,
         locale,
         sheetData,
+        onChangeNamedRanges,
+        getSheetMerges: getPaintMerges,
         getDataValidationById,
         preserveFormatting: preserveFormattingOnPaste,
         maxColumnCount,
@@ -1966,6 +2087,7 @@ sanitizeHtml, }) => {
         onMoveColumns,
         onMoveRows,
         onMoveSelection,
+        onInsertCutCells,
         onSortColumn,
         onSortTable,
         onFilterTable,
@@ -2083,6 +2205,8 @@ sanitizeHtml, }) => {
         onClearHistory,
         // Locale change
         onChangeLocale,
+        // Resolved formula syntax locale (see the `formulaLocale` option)
+        formulaLocale,
         // Comments
         onInsertComment,
         onRemoveComment,

package/dist/esm/hooks/use-structured-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-structured-reference.d.ts","sourceRoot":"","sources":["../../../hooks/use-structured-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,eAAO,MAAM,sBAAsB,GAAI,oCAIpC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,iBAGgB,MAAM,GAAG,SAAS,eAChB,MAAM,EAAE,GAAG,SAAS,WACxB,OAAO,eACH,MAAM,GAAG,SAAS,aACpB,MAAM,QACX,UAAU,KACf,SAAS,GAAG,UAsJlB,CAAC"}
+{"version":3,"file":"use-structured-reference.d.ts","sourceRoot":"","sources":["../../../hooks/use-structured-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,eAAO,MAAM,sBAAsB,GAAI,oCAIpC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,iBAGgB,MAAM,GAAG,SAAS,eAChB,MAAM,EAAE,GAAG,SAAS,WACxB,OAAO,eACH,MAAM,GAAG,SAAS,aACpB,MAAM,QACX,UAAU,KACf,SAAS,GAAG,UA0JlB,CAAC"}

package/dist/esm/hooks/use-structured-reference.js

@@ -15,8 +15,10 @@ export const useStructuredReference = ({ tables, sheetId, getSheetName, }) => {
         });
         // Current row
         const { row: rowIndex } = cell;
+        // Excel: a structured reference whose table no longer exists (the table
+        // was deleted, or every one of its rows) is `#REF!`, never `#NAME?`.
         if (!table) {
-            throw new FormulaError("#NAME!", "Table could not be found");
+            throw new FormulaError("#REF!", "Table could not be found");
         }
         // Special this row item
         if (specialItem === "#This Row") {
@@ -30,12 +32,14 @@ export const useStructuredReference = ({ tables, sheetId, getSheetName, }) => {
         const [from, to] = columnNames ?? [];
         const startColIndex = getColumnIndexFromColumnName(table, from);
         const endColIndex = getColumnIndexFromColumnName(table, to);
-        // Exit early, if column could not be found
+        // Exit early, if column could not be found. Excel: a reference to a
+        // column the table does not have — including the `#REF!` specifier a
+        // column delete writes (`Table1[@#REF!]`) — is `#REF!`.
         if (!isNil(to) && isNil(endColIndex)) {
-            throw new FormulaError("#VALUE!", `Column not found ${to}`);
+            throw new FormulaError("#REF!", `Column not found ${to}`);
         }
         if (!isNil(from) && isNil(startColIndex)) {
-            throw new FormulaError("#VALUE!", `Column not found ${from}`);
+            throw new FormulaError("#REF!", `Column not found ${from}`);
         }
         const startColumnIndex = isNil(startColIndex)
             ? range.startColumnIndex
@@ -92,10 +96,10 @@ export const useStructuredReference = ({ tables, sheetId, getSheetName, }) => {
         }
         // If column is not found, lets not select anything
         if (from && isNil(startColIndex)) {
-            throw new FormulaError("#VALUE!", `Column: ${from} could not be found`);
+            throw new FormulaError("#REF!", `Column: ${from} could not be found`);
         }
         if (to && isNil(endColIndex)) {
-            throw new FormulaError("#VALUE!", `Column: ${to} could not be found`);
+            throw new FormulaError("#REF!", `Column: ${to} could not be found`);
         }
         // Check if thisrow is active and current cell is in bounds
         if (thisRow &&

package/dist/esm/index.d.ts

@@ -18,10 +18,14 @@ export * from "./sheet-cell";
 export { useSubscribeToSheet, useSubscribeToMultipleRanges, } from "./hooks/use-sheet-observer";
 export * from "./helpers";
 export * from "./api/fill";
+export * from "./api/insert-cut-cells";
 export * from "./api/immer-utils";
 export * from "./api/range";
+export * from "./api/anchored-objects";
 export * from "./atoms";
 export * from "./api/formula";
+export * from "./api/structural-guards";
+export * from "./constants";
 export * from "./types";
 export * from "./commands";
 export type { ClearType } from "./interface/delete-cells";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC"}

package/dist/esm/index.js

@@ -18,10 +18,14 @@ export * from "./sheet-cell";
 export { useSubscribeToSheet, useSubscribeToMultipleRanges, } from "./hooks/use-sheet-observer";
 export * from "./helpers";
 export * from "./api/fill";
+export * from "./api/insert-cut-cells";
 export * from "./api/immer-utils";
 export * from "./api/range";
+export * from "./api/anchored-objects";
 export * from "./atoms";
 export * from "./api/formula";
+export * from "./api/structural-guards";
+export * from "./constants";
 export * from "./types";
 export * from "./commands";
 // Register

package/dist/esm/interface/calculation-interface.d.ts

@@ -60,6 +60,15 @@ export declare class CalculationInterface {
     private ensureWorkerMetadata;
     private isClientOnlyFormula;
     private executeOperations;
+    /**
+     * Mirror a dynamic-array anchor's spill rectangle on the local graph (a
+     * matrix result registers it, a scalar clears it) so structural edits can
+     * find the projected cells of an anchor they delete — the same bookkeeping
+     * the React worker hook does in `handleArrayEvaluation`.
+     */
+    private trackArrayResult;
+    /** The spill rectangle currently anchored at `position`, if it is a dynamic array. */
+    getArrayRange(position: CellCoordinate): CellCoordinateRange | undefined;
     private createDefaultWorker;
     private ensureWorker;
 }

package/dist/esm/interface/calculation-interface.d.ts.map

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

package/dist/esm/interface/calculation-interface.js

@@ -1,6 +1,6 @@
-import { resolveSheetSpan } from "@rowsncolumns/utils";
 import { CalculationGraph, CalculationWorkerClient, createNamedRangeResolver, createStructuredReferenceResolver, enqueueCalculationOperations, mapOperationToGraphOperation, } from "@rowsncolumns/calculation-worker/server";
 import { FormulaError } from "@rowsncolumns/fast-formula-parser";
+import { resolveSheetSpan } from "@rowsncolumns/utils";
 const isSerializedFormulaError = (value) => {
     return Boolean(value &&
         typeof value === "object" &&
@@ -279,12 +279,43 @@ export class CalculationInterface {
                 return this.options.getEffectiveStructuredValue(value, property);
             },
         });
-        const expandedResults = results.flatMap((result) => expandWorkerResult(result));
+        const expandedResults = results.flatMap((result) => {
+            this.trackArrayResult(result);
+            return expandWorkerResult(result);
+        });
         if (expandedResults.length) {
             this.options.onResults(expandedResults);
         }
         return expandedResults;
     }
+    /**
+     * Mirror a dynamic-array anchor's spill rectangle on the local graph (a
+     * matrix result registers it, a scalar clears it) so structural edits can
+     * find the projected cells of an anchor they delete — the same bookkeeping
+     * the React worker hook does in `handleArrayEvaluation`.
+     */
+    trackArrayResult(result) {
+        if (!result.position)
+            return;
+        const position = result.position;
+        const matrix = normalizeMatrixValue(deserializeWorkerValue(result.value));
+        if (!matrix) {
+            this.graph.unregisterArrayFormula(position);
+            return;
+        }
+        const columns = Math.max(1, ...matrix.map((row) => row.length));
+        this.graph.registerArrayFormula(position, {
+            sheetId: position.sheetId,
+            startRowIndex: position.rowIndex,
+            startColumnIndex: position.columnIndex,
+            endRowIndex: position.rowIndex + matrix.length - 1,
+            endColumnIndex: position.columnIndex + columns - 1,
+        });
+    }
+    /** The spill rectangle currently anchored at `position`, if it is a dynamic array. */
+    getArrayRange(position) {
+        return this.graph.getArrayRange(position);
+    }
     createDefaultWorker() {
         if (typeof require !== "function") {
             throw new Error("createCalculationWorker must be provided outside of Node.js.");

package/dist/esm/interface/delete-cells-shift-left.d.ts

@@ -1,5 +1,12 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
 import type { UseOnDeleteCellsShiftLeftProps } from "../hooks/use-on-delete-cells-shift-left";
-export declare const deleteCellsShiftLeft: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, }: UseOnDeleteCellsShiftLeftProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+/**
+ * Delete cells ▸ Shift cells left (SHF-04) — the horizontal twin of `deleteCellsShiftUp`: only the
+ * selection's rows move, the selected block is removed and every cell to its right slides left by
+ * the block's width. A reference to a deleted cell becomes `#REF!`; one to a cell that slid left
+ * follows it; a range entirely inside the block's rows that the block partially covers contracts.
+ * Refusals (torn merge/table/array) are decided by the hook before this runs.
+ */
+export declare const deleteCellsShiftLeft: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getSheetName, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCitations, }: UseOnDeleteCellsShiftLeftProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=delete-cells-shift-left.d.ts.map

package/dist/esm/interface/delete-cells-shift-left.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-cells-shift-left.d.ts","sourceRoot":"","sources":["../../../interface/delete-cells-shift-left.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAQnC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAG9F,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,gQAgBvE,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,MAEnC,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAkMnD,CAAC"}
+{"version":3,"file":"delete-cells-shift-left.d.ts","sourceRoot":"","sources":["../../../interface/delete-cells-shift-left.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAgBnC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAI9F;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,8RAkBvE,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,MAEnC,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAqRnD,CAAC"}