@rowsncolumns/spreadsheet-state 28.0.74 → 28.0.76

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

@@ -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,6 +78,7 @@ 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";
@@ -88,6 +87,7 @@ 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 +102,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 +122,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";
@@ -528,7 +528,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;
@@ -998,7 +998,16 @@ sanitizeHtml, }) => {
         ...props,
         customAutofillLists: props.customAutofillLists ?? customAutofillLists,
     }), [rawGetAutoFillValues, customAutofillLists]);
-    // Fill
+    // Fill. A merged seed lands one merged block per target block (Excel replicates the merge
+    // shape); the target's own merges give way, and the snapped fill extent stays selected.
+    const onFillMerges = useCallback((sheetId, activeCell, clearRange, fillMerges, selectRange) => {
+        onUnMergeCells(sheetId, activeCell, [{ range: clearRange }]);
+        if (fillMerges.length) {
+            onMergeCells(sheetId, activeCell, fillMerges.map((range) => ({ range })));
+        }
+        // `onMergeCells` clears the selection; the filled range stays selected like Excel.
+        onChangeSelections?.(sheetId, [{ range: selectRange }]);
+    }, [onUnMergeCells, onMergeCells, onChangeSelections]);
     const onFill = useOnFill({
         locale,
         cellXfsRegistry,
@@ -1015,6 +1024,8 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         createHistory,
         onCommand,
+        getMerges: getPaintMerges,
+        onFillMerges,
     });
     // Delete row
     const onDeleteRow = useOnDeleteRow({
@@ -1041,8 +1052,14 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     });
     // Delete row
     const onDeleteColumn = useOnDeleteColumn({
@@ -1069,8 +1086,14 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     });
     // Delete cells shift up
     const onDeleteCellsShiftUp = useOnDeleteCellsShiftUp({
@@ -1082,13 +1105,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({
@@ -1100,13 +1129,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({
@@ -1118,13 +1153,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({
@@ -1136,13 +1177,19 @@ sanitizeHtml, }) => {
         getActiveCell,
         getSelections,
         getDependents,
+        getSheetName,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
         createHistory,
         onChangeSheets,
         onChangeSheetData,
+        onChangeTables,
+        onChangeCitations,
         onCommand,
+        sheetData,
+        sheets,
+        tables,
     });
     // Insert row
     const onInsertRow = useOnInsertRow({
@@ -1150,6 +1197,7 @@ sanitizeHtml, }) => {
         columnCount,
         locale,
         maxRowCount,
+        sheetData,
         cellXfsRegistry,
         getActiveCell,
         getSelections,
@@ -1166,6 +1214,10 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         onChangeTables,
         getSheetName,
         onCommand,
@@ -1177,6 +1229,7 @@ sanitizeHtml, }) => {
         locale,
         tables,
         maxColumnCount,
+        sheetData,
         cellXfsRegistry,
         sharedStringRegistry,
         getDependents,
@@ -1193,6 +1246,10 @@ sanitizeHtml, }) => {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         getActiveCell,
         getSelections,
         getSheetName,

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

@@ -20,8 +20,11 @@ export * from "./helpers";
 export * from "./api/fill";
 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,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

@@ -20,8 +20,11 @@ export * from "./helpers";
 export * from "./api/fill";
 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/apply-fill.d.ts

@@ -1,6 +1,6 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
-import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
-import type { AutoFillType } from "../api/fill";
+import type { CellData, FillOptions, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import { type AutoFillType } from "../api/fill";
 import type { UseOnFillProps } from "../hooks/use-on-fill";
-export declare const applyFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getCellData, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, createHistory, onChangeDataValidations, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType) => Promise<void>;
+export declare const applyFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getCellData, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, createHistory, onChangeDataValidations, getMerges, onFillMerges, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType, options?: FillOptions) => Promise<void>;
 //# sourceMappingURL=apply-fill.d.ts.map

package/dist/esm/interface/apply-fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-fill.d.ts","sourceRoot":"","sources":["../../../interface/apply-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAU3D,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,sQAe5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,MAGnB,SAAS,MAAM,EAEf,YAAY,aAAa,EAEzB,eAAe,aAAa,EAE5B,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,qBAAqB,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAEzD,WAAW,YAAY,kBA0Q1B,CAAC"}
+{"version":3,"file":"apply-fill.d.ts","sourceRoot":"","sources":["../../../interface/apply-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,aAAa,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,+RAiB5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,MAGnB,SAAS,MAAM,EAEf,YAAY,aAAa,EAEzB,eAAe,aAAa,EAE5B,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,qBAAqB,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAEzD,WAAW,YAAY,EAEvB,UAAU,WAAW,kBA+SxB,CAAC"}

package/dist/esm/interface/apply-fill.js

@@ -1,12 +1,13 @@
 import { Direction } from "@rowsncolumns/common-types";
 import { selectionFromActiveCell } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
+import { FILL_UNTOUCHED } from "../api/fill";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
 import { defaultCellCoords, defaultSheetId, SheetCell } from "../sheet-cell";
 import { getFillDirection } from "./../api/selection";
 import { collectDataValidationTarget, extendDataValidationRanges, } from "./data-validation-utils";
-export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getCellData, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, createHistory, onChangeDataValidations, }) => {
+export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, getCellData, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, createHistory, onChangeDataValidations, getMerges, onFillMerges, }) => {
     return async (
     // Active sheet ID
     sheetId, 
@@ -17,7 +18,9 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
     // Current selections of the user
     selections, fillableSelections, 
     // Fill type - if not specified, will auto-detect
-    fillType) => {
+    fillType, 
+    // Ctrl/Cmd toggle held on the fill handle and/or Series-dialog parameters
+    options) => {
         const finalSelections = selections.length
             ? selections
             : selectionFromActiveCell(activeCell);
@@ -41,12 +44,47 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
             locale,
             cellXfsRegistry,
             getDataValidationById,
-            fillType,
+            merges: getMerges?.(sheetId),
+            fillType: fillType ?? options?.fillType,
+            modifier: options?.modifier,
+            series: options?.series,
         });
+        // A merged seed snaps the fill extent to whole blocks — that is the area written (and the
+        // selection left behind); the drag's raw extent only feeds the cache invalidation below.
+        const targetBounds = fillValues.snappedFillBounds ?? fillBounds;
+        const filledArea = direction === Direction.Down
+            ? {
+                startRowIndex: selection.range.endRowIndex + 1,
+                endRowIndex: targetBounds.endRowIndex,
+                startColumnIndex: selection.range.startColumnIndex,
+                endColumnIndex: selection.range.endColumnIndex,
+            }
+            : direction === Direction.Up
+                ? {
+                    startRowIndex: targetBounds.startRowIndex,
+                    endRowIndex: selection.range.startRowIndex - 1,
+                    startColumnIndex: selection.range.startColumnIndex,
+                    endColumnIndex: selection.range.endColumnIndex,
+                }
+                : direction === Direction.Right
+                    ? {
+                        startRowIndex: selection.range.startRowIndex,
+                        endRowIndex: selection.range.endRowIndex,
+                        startColumnIndex: selection.range.endColumnIndex + 1,
+                        endColumnIndex: targetBounds.endColumnIndex,
+                    }
+                    : {
+                        startRowIndex: selection.range.startRowIndex,
+                        endRowIndex: selection.range.endRowIndex,
+                        startColumnIndex: targetBounds.startColumnIndex,
+                        endColumnIndex: selection.range.startColumnIndex - 1,
+                    };
         // Sample cell
         const sheetCell = new SheetCell(defaultSheetId, defaultCellCoords, undefined, { locale, cellXfsRegistry, getDataValidationById });
         const getFillValue = (rowIndex, columnIndex) => {
-            const fillValue = fillValues[rowIndex][columnIndex];
+            const fillValue = fillValues[rowIndex]?.[columnIndex];
+            if (fillValue === FILL_UNTOUCHED)
+                return FILL_UNTOUCHED;
             if (typeof fillValue !== "object") {
                 sheetCell.setUserEnteredValue(fillValue);
                 sharedStringRegistry?.registerCell(sheetCell);
@@ -55,6 +93,37 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
             }
             return fillValue;
         };
+        /**
+         * Write one cell of the fill into the draft and register it for validation, recalculation and
+         * history — the single write path for filled targets and rewritten seeds.
+         */
+        const writeCell = (draft, rowIndex, columnIndex, cellData) => {
+            const newSheet = createSheetDraft(draft, sheetId, rowIndex);
+            newSheet[rowIndex].values[columnIndex] = cellData;
+            collectDataValidationTarget(dataValidationTargets, sheetId, rowIndex, columnIndex, cellData);
+            enqueueCalculation({
+                position: { rowIndex, columnIndex, sheetId },
+                type: "add",
+                force: true,
+            });
+            recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, columnIndex), {
+                rowIndex,
+                columnIndex,
+                sheetId,
+                force: true,
+            });
+        };
+        /**
+         * Write the fill value at `[rollingRowIndex][rollingColumnIndex]` into the target cell. A
+         * Series-dialog `stop` reached before the selection's end marks the target untouched — Excel
+         * writes nothing there, so neither do we.
+         */
+        const writeFilledCell = (draft, rowIndex, columnIndex, rollingRowIndex, rollingColumnIndex) => {
+            const cellData = getFillValue(rollingRowIndex, rollingColumnIndex);
+            if (cellData === FILL_UNTOUCHED)
+                return;
+            writeCell(draft, rowIndex, columnIndex, cellData);
+        };
         // Fill writes through `onChangeSheetData` directly. The calculator
         // only invalidates `rangeCache` for cells it recomputes, so the
         // freshly-filled positions stay cached until we tell it otherwise.
@@ -74,7 +143,7 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                 switch (direction) {
                     case Direction.Down: {
                         const start = selection.range.endRowIndex + 1;
-                        const end = fillBounds.endRowIndex;
+                        const end = targetBounds.endRowIndex;
                         let counter = 0;
                         for (let i = start; i <= end; i++) {
                             let rowIndex = selection.range.startRowIndex + counter;
@@ -85,16 +154,7 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                             const rollingRowIndex = i - start;
                             for (let columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
                                 const rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
-                                const newSheet = createSheetDraft(draft, sheetId, i);
-                                const newCellData = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                newSheet[i].values[columnIndex] = newCellData;
-                                collectDataValidationTarget(dataValidationTargets, sheetId, i, columnIndex, newCellData);
-                                enqueueCalculation({
-                                    position: { rowIndex: i, columnIndex, sheetId },
-                                    type: "add",
-                                    force: true,
-                                });
-                                recalcCells.set(createSheetCellIdentifier(sheetId, i, columnIndex), { rowIndex: i, columnIndex, sheetId, force: true });
+                                writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
                             }
                             counter++;
                         }
@@ -102,20 +162,12 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                     }
                     case Direction.Up: {
                         const start = selection.range.startRowIndex - 1;
-                        const end = fillBounds.startRowIndex;
+                        const end = targetBounds.startRowIndex;
                         for (let i = start; i >= end; i--) {
-                            const rollingRowIndex = i - fillBounds.startRowIndex;
+                            const rollingRowIndex = i - targetBounds.startRowIndex;
                             for (let columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
                                 const rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
-                                const newSheet = createSheetDraft(draft, sheetId, i);
-                                newSheet[i].values[columnIndex] = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                collectDataValidationTarget(dataValidationTargets, sheetId, i, columnIndex, newSheet[i].values[columnIndex]);
-                                enqueueCalculation({
-                                    position: { rowIndex: i, columnIndex, sheetId },
-                                    type: "add",
-                                    force: true,
-                                });
-                                recalcCells.set(createSheetCellIdentifier(sheetId, i, columnIndex), { rowIndex: i, columnIndex, sheetId, force: true });
+                                writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
                             }
                         }
                         break;
@@ -123,7 +175,7 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                     case Direction.Right: {
                         for (let rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
                             const start = selection.range.endColumnIndex + 1;
-                            const end = fillBounds.endColumnIndex;
+                            const end = targetBounds.endColumnIndex;
                             let counter = 0;
                             const rollingRowIndex = rowIndex - selection.range.startRowIndex;
                             for (let j = start; j <= end; j++) {
@@ -133,15 +185,7 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                                     columnIndex = selection.range.startColumnIndex;
                                 }
                                 const rollingColumnIndex = j - start;
-                                const newSheet = createSheetDraft(draft, sheetId, rowIndex);
-                                newSheet[rowIndex].values[j] = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                collectDataValidationTarget(dataValidationTargets, sheetId, rowIndex, j, newSheet[rowIndex].values[j]);
-                                enqueueCalculation({
-                                    position: { rowIndex, columnIndex: j, sheetId },
-                                    type: "add",
-                                    force: true,
-                                });
-                                recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, j), { rowIndex, columnIndex: j, sheetId, force: true });
+                                writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
                                 counter++;
                             }
                         }
@@ -150,7 +194,7 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                     case Direction.Left: {
                         for (let rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
                             const start = selection.range.startColumnIndex - 1;
-                            const end = fillBounds.startColumnIndex;
+                            const end = targetBounds.startColumnIndex;
                             const rollingRowIndex = rowIndex - selection.range.startRowIndex;
                             let counter = 0;
                             for (let j = start; j >= end; j--) {
@@ -159,22 +203,18 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                                     counter = 0;
                                     columnIndex = selection.range.endColumnIndex;
                                 }
-                                const rollingColumnIndex = j - fillBounds.startColumnIndex;
-                                const newSheet = createSheetDraft(draft, sheetId, rowIndex);
-                                newSheet[rowIndex].values[j] = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                collectDataValidationTarget(dataValidationTargets, sheetId, rowIndex, j, newSheet[rowIndex].values[j]);
-                                enqueueCalculation({
-                                    position: { rowIndex, columnIndex: j, sheetId },
-                                    type: "add",
-                                    force: true,
-                                });
-                                recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, j), { rowIndex, columnIndex: j, sheetId, force: true });
+                                const rollingColumnIndex = j - targetBounds.startColumnIndex;
+                                writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
                                 counter--;
                             }
                         }
                         break;
                     }
                 }
+                // Series-dialog Trend: the seed cells Excel replaces with the fitted values.
+                for (const seed of fillValues.seedCells ?? []) {
+                    writeCell(draft, seed.rowIndex, seed.columnIndex, seed.cell);
+                }
             });
             // Save history
             saveHistory({
@@ -184,12 +224,17 @@ export const applyFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getDa
                 activeCell: { undo: activeCell, redo: activeCell },
                 selections: {
                     undo: fillableSelections ?? selections,
-                    redo: [fillSelection],
+                    redo: [{ ...fillSelection, range: targetBounds }],
                 },
             });
             extendDataValidationRanges(dataValidationTargets, onChangeDataValidations, saveHistory);
             sharedStringRegistry?.getPatches(saveHistory);
             return nextState;
         });
+        // A merged seed replicates its block shape over the filled area (Excel).
+        const fillMerges = fillValues.fillMerges;
+        if (fillMerges?.length) {
+            onFillMerges?.(sheetId, activeCell, filledArea, fillMerges, targetBounds);
+        }
     };
 };

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;
 }