@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/cjs/api/anchored-objects.d.ts

@@ -1,6 +1,7 @@
 import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
-import type { EmbeddedChart, EmbeddedObject, ProtectedRange } from "@rowsncolumns/spreadsheet";
+import type { EmbeddedChart, EmbeddedObject, OverlayPosition, OverlayToAnchor, ProtectedRange, Slicer, TableView } from "@rowsncolumns/spreadsheet";
 import type { Draft } from "immer";
+import type { RangeBandSpan } from "./formula";
 /**
  * Structural (whole row / whole column insert or delete) relocation of the
  * objects Excel anchors to cells rather than storing inside them: floating
@@ -11,8 +12,11 @@ import type { Draft } from "immer";
  * - A floating object's anchor cell shifts like any cell: pushed down/right by
  *   an insert at or before it, pulled up/left by a delete before it. When the
  *   anchor row/column itself is deleted the object snaps to the first
- *   surviving cell at the deletion index (Move-and-size / Move-don't-size both
- *   move; only absolute anchors stay put). Size never changes.
+ *   surviving cell at the deletion index. `moveAndSize` (Excel's default)
+ *   shifts its second anchor the same way, so an insert between the corners
+ *   stretches the frame and a delete inside shrinks it; a delete consuming
+ *   the whole span removes the object. `moveOnly` moves with a fixed size;
+ *   `absolute` (Don't move or size with cells) stays put.
  * - A range (chart series, AllowEditRange) shifts like a formula reference:
  *   insert at/before the start moves it, insert strictly inside grows it,
  *   delete inside shrinks it, delete of the whole span removes it (`#REF!`).
@@ -49,18 +53,130 @@ export declare const shiftGridRangeLikeReference: <R extends GridRange>(range: R
  * (`sources`), nulled on properties (`dataRange`) — the chart's `#REF!`.
  * Unknown keys are left untouched. Mutates in place; returns whether anything
  * changed.
+ *
+ * `band` restricts the rewrite to ranges whose PERPENDICULAR span lies wholly
+ * inside it — the insert/delete-CELLS shift of columns `B:C` only touches
+ * ranges living entirely in B..C, exactly like `expandRangesInFormula` /
+ * `contractRangesInFormula` with the same `bandSpan` (SHF-07 / SHF-08), so a
+ * chart and a formula reading the same cells always agree. A range that only
+ * partially overlaps the band keeps its address, as in Excel.
+ */
+export declare const shiftChartSpecRanges: (spec: unknown, sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number, band?: RangeBandSpan) => boolean;
+/**
+ * Record (or clear) the second anchor a move / resize gesture reported —
+ * `moveAndSize` objects carry one, `moveOnly` / `absolute` never do.
  */
-export declare const shiftChartSpecRanges: (spec: unknown, sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => boolean;
-/** Shift the anchor cell of every embed (picture, shape, text box…) on the edited sheet. */
+export declare const setOverlayToAnchor: (overlay: Draft<OverlayPosition>, toAnchor: OverlayToAnchor | undefined) => void;
+/**
+ * Shift a floating object's anchors for a whole row / column insert or
+ * delete, per its placement mode. Returns `"removed"` when a delete consumed
+ * the whole span of a `moveAndSize` object (Excel deletes it), otherwise
+ * whether anything moved.
+ */
+export declare const shiftOverlayOnStructuralChange: (overlay: Draft<OverlayPosition>, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => boolean | "removed";
+/** Shift the anchors of every embed (picture, shape, text box…) on the edited sheet. */
 export declare const shiftEmbedsOnStructuralChange: (draft: Draft<EmbeddedObject>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
 /**
- * Shift every chart on the edited sheet: its anchor cell like a floating
+ * Shift the anchors of every slicer on the edited sheet — a slicer is a
+ * floating frame with the same placement modes as a picture (#668 C-46).
+ */
+export declare const shiftSlicersOnStructuralChange: (draft: Draft<Slicer>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+/**
+ * Shift every chart on the edited sheet: its anchors like a floating
  * object, and the ranges inside its spec like references.
  */
 export declare const shiftChartsOnStructuralChange: (draft: Draft<EmbeddedChart>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+/**
+ * Insert/delete CELLS with shift (SHF-*): only the ranges a chart reads move —
+ * those wholly inside the shifted band's columns (shift down/up) or rows
+ * (shift right/left), with the reference rule along the shift axis. Excel
+ * moves drawing anchors only for whole row/column edits, so the chart frame
+ * stays where it is.
+ */
+export declare const shiftChartsOnCellShift: (draft: Draft<EmbeddedChart>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number, band: RangeBandSpan) => void;
 /**
  * Shift AllowEditRange rectangles. A protected range without a rectangle
  * (sheet-scoped protection) is untouched; one the delete consumes is removed.
  */
 export declare const shiftProtectedRangesOnStructuralChange: (draft: Draft<ProtectedRange>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+/**
+ * Deleting a sheet consumes every range on it: a chart elsewhere whose series
+ * / category / data range read the deleted sheet keeps the chart but loses
+ * that range (Excel's empty `#REF!` series).
+ */
+export declare const removeChartSpecRangesOnSheet: (spec: unknown, sheetId: number) => boolean;
+/**
+ * Re-point every range on `fromSheetId` at `toSheetId` — a duplicated sheet's
+ * charts read the copy's own cells (Excel), while ranges on other sheets keep
+ * reading the original.
+ */
+export declare const retargetChartSpecRanges: (spec: unknown, fromSheetId: number, toSheetId: number) => boolean;
+/**
+ * Relocate the ranges inside a chart spec when the block `from` on
+ * `fromSheetId` is moved (drag-move, cut → paste) to `to` on `toSheetId`, the
+ * way Excel re-points series like references: a range that lies ENTIRELY
+ * inside the moved block travels with it (shifted by the move delta and onto
+ * the destination sheet); a range the block covers only partially, and any
+ * range outside it, keeps referring to its original cells. Mirrors
+ * `move_spec_sheet_ranges` in `rnc-store`.
+ */
+export declare const moveChartSpecRanges: (spec: unknown, fromSheetId: number, from: GridRange, toSheetId: number, to: GridRange) => boolean;
+/** Re-point the ranges of every chart when a cell block is moved (see `moveChartSpecRanges`). */
+export declare const moveChartsOnRangeMove: (draft: Draft<EmbeddedChart>[], fromSheetId: number, from: GridRange, toSheetId: number, to: GridRange) => void;
+/**
+ * Where line `index` (a row or column) ends up after the whole lines `lines`
+ * (sorted ascending) are moved so the block lands at `target` in the
+ * post-removal frame — the permutation a row/column move applies to every
+ * cell. A moved line lands at `target` + its rank in the block; a line outside
+ * closes the gap the block left and is pushed by the block landing at or
+ * before it. Mirrors `moved_line_index` in `rnc-store`.
+ */
+export declare const movedLineIndex: (lines: readonly number[], target: number, index: number) => number;
+/**
+ * Re-point the ranges inside a chart spec when whole rows / columns of
+ * `sheetId` are moved (`lines` land at `target`), with the rule the engines
+ * apply to formula references: both edges follow their line, and the range is
+ * rewritten only when that yields a range of the same size — so a range wholly
+ * inside the moved block relocates with it, one wholly inside the displaced
+ * band shifts by the block size, and one straddling the block and its
+ * neighbours keeps its text (it still covers the same cells). Mirrors
+ * `permute_spec_sheet_ranges` in `rnc-store` / `remap_formula_axis`.
+ */
+export declare const reorderChartSpecRanges: (spec: unknown, sheetId: number, axis: StructuralAxis, lines: readonly number[], target: number) => boolean;
+/** Re-point the ranges of every chart when whole rows / columns are moved (see `reorderChartSpecRanges`). */
+export declare const reorderChartsOnLineMove: (draft: Draft<EmbeddedChart>[], sheetId: number, axis: StructuralAxis, lines: readonly number[], target: number) => void;
+/**
+ * The table a chart range may be bound to — Excel's ListObject binding, taken BEFORE the table
+ * edit: `range` is the table's range, `rowStarts` the rows a bound range may begin at (the header
+ * row when shown, the first body row) and `bodyEndRowIndex` its last body row (the totals row
+ * excluded). Mirrors `TableBinding` in `rnc-store`.
+ */
+export type TableBinding = {
+    range: GridRange;
+    rowStarts: readonly number[];
+    bodyEndRowIndex: number;
+};
+export declare const tableBinding: (table: Pick<TableView, "range" | "headerRow" | "totalRow">) => TableBinding;
+/**
+ * Insert / delete table rows (or columns): the cells inside the table's columns (rows) at/after
+ * `index` move, so every chart range wholly inside that band follows the reference rule like
+ * insert/delete-cells — except a range bound to the table (`isTableBoundRange`), which grows /
+ * shrinks by `count` even when the rows are appended below the last body row (where the
+ * reference rule would leave it alone) or inserted above the first one (where it would shift):
+ * Excel keeps the series on the table column. A range that collapses is removed (`#REF!`).
+ * Mutates in place; returns whether anything changed. Mirrors
+ * `shift_spec_sheet_ranges_for_table_edit` in `rnc-store`.
+ */
+export declare const shiftChartSpecRangesOnTableEdit: (spec: unknown, sheetId: number, binding: TableBinding, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => boolean;
+/**
+ * Table growth without a cell shift — the resize handle, typing below / to the right of the
+ * table: a range bound to the table (`isTableBoundRange`) grows / shrinks with its body by
+ * `rowDelta` rows, then by `columnDelta` columns against the row-grown table. Mutates in place;
+ * returns whether anything changed. Mirrors `grow_table_bound_spec_ranges` in `rnc-store`.
+ */
+export declare const growTableBoundChartSpecRanges: (spec: unknown, sheetId: number, binding: TableBinding, rowDelta: number, columnDelta: number) => boolean;
+/** Every chart's ranges follow a table-local row / column insert or delete (see `shiftChartSpecRangesOnTableEdit`). */
+export declare const shiftChartsOnTableEdit: (draft: Draft<EmbeddedChart>[], sheetId: number, binding: TableBinding, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+/** Every chart's table-bound ranges grow / shrink with a resized or auto-expanded table (see `growTableBoundChartSpecRanges`). */
+export declare const growChartsWithTable: (draft: Draft<EmbeddedChart>[], sheetId: number, binding: TableBinding, rowDelta: number, columnDelta: number) => void;
 //# sourceMappingURL=anchored-objects.d.ts.map

package/dist/cjs/api/anchored-objects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchored-objects.d.ts","sourceRoot":"","sources":["../../../api/anchored-objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EAEV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,KAAK,MAAM,EACX,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAerB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,MASF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,QAAQ,aAAa,EACrB,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,aASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,SAAS,EAC7D,OAAO,CAAC,EACR,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,CAAC,GAAG,IAgBN,CAAC;AAgBF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,OAAO,EACb,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,OAoCF,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,CAAC,cAAc,CAAC,EAAE,EAC9B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,SAUd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,CAAC,aAAa,CAAC,EAAE,EAC7B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,SAad,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,OAAO,KAAK,CAAC,cAAc,CAAC,EAAE,EAC9B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,SAyCd,CAAC"}
+{"version":3,"file":"anchored-objects.d.ts","sourceRoot":"","sources":["../../../api/anchored-objects.ts"],"names":[],"mappings":"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"}