@rowsncolumns/spreadsheet-state 29.1.4 → 29.1.7

package/dist/cjs/api/dependency.d.ts

@@ -38,7 +38,17 @@ export declare const collectUniqueDependentsForRange: <T extends CellData>(param
     rowIndex: number;
     columnIndex: number;
 }>;
-export declare const moveFormulaAtPosition: <T extends CellData>({ draft, position, destinationSheetId, activeSheetName, enqueueCalculation, enqueueGraphOperation, recalcCells, movedKeys, rowDelta, columnDelta, sourceRange, deletedRange, destinationPosition, locale, rowCount, columnCount, cellXfsRegistry, sharedStringRegistry, }: {
+/**
+ * One reference shift of a structural edit: the references inside `sourceRange` move by the
+ * deltas, those inside `deletedRange` break to `#REF!`.
+ */
+export type FormulaMoveStep = {
+    rowDelta: number;
+    columnDelta: number;
+    sourceRange?: GridRange;
+    deletedRange?: GridRange;
+};
+export declare const moveFormulaAtPosition: <T extends CellData>({ draft, position, destinationSheetId, activeSheetName, enqueueCalculation, enqueueGraphOperation, recalcCells, movedKeys, rowDelta, columnDelta, sourceRange, deletedRange, steps, destinationPosition, locale, rowCount, columnCount, cellXfsRegistry, sharedStringRegistry, }: {
     draft: Draft<SheetData<T>>;
     position: {
         sheetId: number;
@@ -56,6 +66,14 @@ export declare const moveFormulaAtPosition: <T extends CellData>({ draft, positi
     sourceRange?: GridRange;
     /** Cells removed by a delete-cells shift — references into it become `#REF!` (SHF-09). */
     deletedRange?: GridRange;
+    /**
+     * Several shifts applied to the formula text in order, one per deleted band of a
+     * non-contiguous delete (Ctrl-selected rows 2 and 4): each step shifts the references inside
+     * its own `sourceRange` by its delta and breaks those inside its `deletedRange`. Replaces the
+     * single `rowDelta` / `columnDelta` / `sourceRange` / `deletedRange` shift when given; pass
+     * `destinationPosition` with it (the cell's own move is not any single step's delta).
+     */
+    steps?: FormulaMoveStep[];
     /**
      * Where the formula cell itself ends up. Defaults to `position + delta` (the cell moves with the
      * shift). A dependent OUTSIDE the shifted band keeps its place while its references into the

package/dist/cjs/api/dependency.d.ts.map

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

package/dist/cjs/api/dependency.js

@@ -232,29 +232,45 @@ export var collectUniqueDependentsForRange = function (params) {
 };
 // Process a single formula move at a specific position with the specified deltas.
 export var moveFormulaAtPosition = function (_a) {
-    var _b, _c, _d, _e;
-    var draft = _a.draft, position = _a.position, destinationSheetId = _a.destinationSheetId, activeSheetName = _a.activeSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, recalcCells = _a.recalcCells, movedKeys = _a.movedKeys, _f = _a.rowDelta, rowDelta = _f === void 0 ? 0 : _f, _g = _a.columnDelta, columnDelta = _g === void 0 ? 0 : _g, sourceRange = _a.sourceRange, deletedRange = _a.deletedRange, destinationPosition = _a.destinationPosition, locale = _a.locale, rowCount = _a.rowCount, columnCount = _a.columnCount, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
+    var e_3, _b;
+    var _c, _d, _e, _f;
+    var draft = _a.draft, position = _a.position, destinationSheetId = _a.destinationSheetId, activeSheetName = _a.activeSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, recalcCells = _a.recalcCells, movedKeys = _a.movedKeys, _g = _a.rowDelta, rowDelta = _g === void 0 ? 0 : _g, _h = _a.columnDelta, columnDelta = _h === void 0 ? 0 : _h, sourceRange = _a.sourceRange, deletedRange = _a.deletedRange, steps = _a.steps, destinationPosition = _a.destinationPosition, locale = _a.locale, rowCount = _a.rowCount, columnCount = _a.columnCount, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
     var sheetCell = new SheetCell();
     var currentSheet = createSheetDraft(draft, position.sheetId, position.rowIndex);
-    var cellData = (_c = (_b = currentSheet[position.rowIndex]) === null || _b === void 0 ? void 0 : _b.values) === null || _c === void 0 ? void 0 : _c[position.columnIndex];
+    var cellData = (_d = (_c = currentSheet[position.rowIndex]) === null || _c === void 0 ? void 0 : _c.values) === null || _d === void 0 ? void 0 : _d[position.columnIndex];
     sheetCell.assign(position.sheetId, { rowIndex: position.rowIndex, columnIndex: position.columnIndex }, cellData, { locale: locale, cellXfsRegistry: cellXfsRegistry, sharedStringRegistry: sharedStringRegistry });
     if (!movedKeys.has(sheetCell.key) && sheetCell.isFormula()) {
         movedKeys.add(sheetCell.key);
         var previousFormula = sheetCell.formula;
-        var newRowIndex = (_d = destinationPosition === null || destinationPosition === void 0 ? void 0 : destinationPosition.rowIndex) !== null && _d !== void 0 ? _d : position.rowIndex + rowDelta;
-        var newColumnIndex = (_e = destinationPosition === null || destinationPosition === void 0 ? void 0 : destinationPosition.columnIndex) !== null && _e !== void 0 ? _e : position.columnIndex + columnDelta;
+        var newRowIndex = (_e = destinationPosition === null || destinationPosition === void 0 ? void 0 : destinationPosition.rowIndex) !== null && _e !== void 0 ? _e : position.rowIndex + rowDelta;
+        var newColumnIndex = (_f = destinationPosition === null || destinationPosition === void 0 ? void 0 : destinationPosition.columnIndex) !== null && _f !== void 0 ? _f : position.columnIndex + columnDelta;
         var resolvedSheetName = activeSheetName !== null && activeSheetName !== void 0 ? activeSheetName : "";
         // The delta is applied to the references inside `sourceRange`; the formula cell's own
         // destination (for the graph re-key) may differ when it does not move itself.
-        sheetCell.moveFormula({ rowIndex: position.rowIndex, columnIndex: position.columnIndex }, {
-            rowIndex: position.rowIndex + rowDelta,
-            columnIndex: position.columnIndex + columnDelta,
-        }, resolvedSheetName, {
-            exclusionRange: sourceRange,
-            deletedRange: deletedRange,
-            rowCount: rowCount,
-            columnCount: columnCount,
-        });
+        var moves = steps !== null && steps !== void 0 ? steps : [
+            { rowDelta: rowDelta, columnDelta: columnDelta, sourceRange: sourceRange, deletedRange: deletedRange },
+        ];
+        try {
+            for (var moves_1 = __values(moves), moves_1_1 = moves_1.next(); !moves_1_1.done; moves_1_1 = moves_1.next()) {
+                var move = moves_1_1.value;
+                sheetCell.moveFormula({ rowIndex: position.rowIndex, columnIndex: position.columnIndex }, {
+                    rowIndex: position.rowIndex + move.rowDelta,
+                    columnIndex: position.columnIndex + move.columnDelta,
+                }, resolvedSheetName, {
+                    exclusionRange: move.sourceRange,
+                    deletedRange: move.deletedRange,
+                    rowCount: rowCount,
+                    columnCount: columnCount,
+                });
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (moves_1_1 && !moves_1_1.done && (_b = moves_1.return)) _b.call(moves_1);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
         if (previousFormula !== sheetCell.formula) {
             // Set cell data at old position (formula updated prior to structural move)
             currentSheet[position.rowIndex].values[position.columnIndex] =

package/dist/cjs/api/filter-condition.d.ts

@@ -0,0 +1,58 @@
+import type { BooleanCondition, ConditionType } from "@rowsncolumns/spreadsheet";
+export declare const isDateFilterCondition: (type: ConditionType | string | null | undefined) => boolean;
+/**
+ * Whether a filter clause compares the cell's NUMBER — a Number Filter or a
+ * Date Filter comparison. Text (even numeric-looking text such as `'500`),
+ * booleans, errors and blanks never satisfy such a clause.
+ */
+export declare const isNumericFilterCondition: (type: ConditionType | string | null | undefined) => boolean;
+/** A cell value that takes part in a Number / Date Filter: a finite number. */
+export declare const isNumericFilterCellValue: (value: unknown) => value is number;
+/**
+ * How a Number / Date Filter criterion (`userEnteredValue`, the free text
+ * typed into the filter dialog) reads.
+ *
+ * - `empty`: nothing typed — the clause is inactive.
+ * - `number`: a typed literal — number, `50%`, currency, or a date / time in
+ *   the document locale — as its numeric value (a date is its serial, exactly
+ *   what the cell holds).
+ * - `formula`: `=…` or a cell reference; only the calculator can resolve it.
+ * - `text`: anything else; no number satisfies it.
+ */
+export type FilterCriterion = {
+    kind: "empty";
+} | {
+    kind: "number";
+    value: number;
+} | {
+    kind: "formula";
+} | {
+    kind: "text";
+};
+/**
+ * Classify a filter criterion the way Excel's Custom AutoFilter reads the typed
+ * box — as a cell entry in the workbook `locale` (`1/15/2024` is Jan 15 in
+ * en-US, `15.1.2024` in de-DE, `2024-02-01` anywhere, `6,5` is 6.5 in de-DE),
+ * so a Date Filter compares serials instead of quoting the text.
+ */
+export declare const classifyFilterCriterion: (raw: string | undefined | null, locale?: string) => FilterCriterion;
+/**
+ * Decide one Number Filter / Date Filter clause against a cell's typed value,
+ * the way Excel does — without the calculator:
+ *
+ * - Only NUMBERS take part. Text (including numeric-looking text such as
+ *   `'500`), booleans, errors and blanks never satisfy `> 500` / `after
+ *   1/15/2024` and are hidden (`false`). The calculator's coercion would say
+ *   text > number is TRUE and a blank is 0 — neither is Excel. "Does not
+ *   equal" is the complement of "equals": text and blanks stay visible.
+ * - A typed date criterion is read in the document `locale` and compared as a
+ *   SERIAL; Date Filters compare calendar days (`INT`), so `1/15/2024 14:00`
+ *   equals `1/15/2024` and is not after it.
+ * - A `=…` / reference criterion is `undefined` — left to the calculator, which
+ *   then compares a number (the cell-type gate has already run). An empty
+ *   criterion is `undefined` too (an inactive clause).
+ *
+ * `undefined` for a condition type this evaluator does not own.
+ */
+export declare const evaluateNumericFilterCondition: (condition: BooleanCondition | null | undefined, value: unknown, locale?: string) => boolean | undefined;
+//# sourceMappingURL=filter-condition.d.ts.map

package/dist/cjs/api/filter-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-condition.d.ts","sourceRoot":"","sources":["../../../api/filter-condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACd,MAAM,2BAA2B,CAAC;AA4CnC,eAAO,MAAM,qBAAqB,GAChC,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAC9C,OACsE,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAC9C,OAKA,CAAC;AAEJ,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACd,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,EAC9B,SAAS,MAAM,KACd,eAcF,CAAC;AAKF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,8BAA8B,GACzC,WAAW,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,OAAO,EACd,SAAS,MAAM,KACd,OAAO,GAAG,SA2DZ,CAAC"}

package/dist/cjs/api/filter-condition.js

@@ -0,0 +1,157 @@
+import { __read } from "tslib";
+import { checkIfStringIsReference } from "@rowsncolumns/utils";
+import { detectValueTypeAndPattern } from "./datatype";
+/**
+ * Excel's Number Filters and Date Filters — the AutoFilter clauses that act on
+ * the cell's NUMBER (a date is its serial) and hide every non-numeric cell.
+ * Twin of `is_numeric_filter_kind` in the Rust engine (`rnc-store/support.rs`);
+ * the shared table `libs/common-types/fixtures/filter-evaluator-table.json`
+ * (`numeric`) keeps the two evaluators identical.
+ */
+var NUMBER_FILTER_CONDITION_TYPES = new Set([
+    "NUMBER_EQ",
+    "NUMBER_NOT_EQ",
+    "NUMBER_GREATER",
+    "NUMBER_GREATER_THAN_EQ",
+    "NUMBER_LESS",
+    "NUMBER_LESS_THAN_EQ",
+    "NUMBER_BETWEEN",
+    "NUMBER_NOT_BETWEEN",
+]);
+var DATE_FILTER_CONDITION_TYPES = new Set([
+    "DATE_EQ",
+    "DATE_NOT_EQ",
+    "DATE_BEFORE",
+    "DATE_AFTER",
+    "DATE_ON_OR_BEFORE",
+    "DATE_ON_OR_AFTER",
+    "DATE_BETWEEN",
+    "DATE_NOT_BETWEEN",
+]);
+var TWO_OPERAND_FILTER_CONDITION_TYPES = new Set([
+    "NUMBER_BETWEEN",
+    "NUMBER_NOT_BETWEEN",
+    "DATE_BETWEEN",
+    "DATE_NOT_BETWEEN",
+]);
+export var isDateFilterCondition = function (type) {
+    return Boolean(type && DATE_FILTER_CONDITION_TYPES.has(type));
+};
+/**
+ * Whether a filter clause compares the cell's NUMBER — a Number Filter or a
+ * Date Filter comparison. Text (even numeric-looking text such as `'500`),
+ * booleans, errors and blanks never satisfy such a clause.
+ */
+export var isNumericFilterCondition = function (type) {
+    return Boolean(type &&
+        (NUMBER_FILTER_CONDITION_TYPES.has(type) ||
+            DATE_FILTER_CONDITION_TYPES.has(type)));
+};
+/** A cell value that takes part in a Number / Date Filter: a finite number. */
+export var isNumericFilterCellValue = function (value) {
+    return typeof value === "number" && Number.isFinite(value);
+};
+/**
+ * Classify a filter criterion the way Excel's Custom AutoFilter reads the typed
+ * box — as a cell entry in the workbook `locale` (`1/15/2024` is Jan 15 in
+ * en-US, `15.1.2024` in de-DE, `2024-02-01` anywhere, `6,5` is 6.5 in de-DE),
+ * so a Date Filter compares serials instead of quoting the text.
+ */
+export var classifyFilterCriterion = function (raw, locale) {
+    var _a;
+    var trimmed = (_a = raw === null || raw === void 0 ? void 0 : raw.trim()) !== null && _a !== void 0 ? _a : "";
+    if (!trimmed)
+        return { kind: "empty" };
+    if (trimmed.startsWith("=") || checkIfStringIsReference(trimmed)) {
+        return { kind: "formula" };
+    }
+    var _b = __read(detectValueTypeAndPattern(trimmed, locale !== null && locale !== void 0 ? locale : "en-US"), 3), formatValue = _b[0], numberValue = _b[2];
+    if (formatValue === "numberValue" && isNumericFilterCellValue(numberValue)) {
+        return { kind: "number", value: numberValue };
+    }
+    return { kind: "text" };
+};
+var numbersEqual = function (a, b) {
+    return Math.abs(a - b) <= 1e-9 * Math.max(Math.abs(a), Math.abs(b), 1);
+};
+/**
+ * Decide one Number Filter / Date Filter clause against a cell's typed value,
+ * the way Excel does — without the calculator:
+ *
+ * - Only NUMBERS take part. Text (including numeric-looking text such as
+ *   `'500`), booleans, errors and blanks never satisfy `> 500` / `after
+ *   1/15/2024` and are hidden (`false`). The calculator's coercion would say
+ *   text > number is TRUE and a blank is 0 — neither is Excel. "Does not
+ *   equal" is the complement of "equals": text and blanks stay visible.
+ * - A typed date criterion is read in the document `locale` and compared as a
+ *   SERIAL; Date Filters compare calendar days (`INT`), so `1/15/2024 14:00`
+ *   equals `1/15/2024` and is not after it.
+ * - A `=…` / reference criterion is `undefined` — left to the calculator, which
+ *   then compares a number (the cell-type gate has already run). An empty
+ *   criterion is `undefined` too (an inactive clause).
+ *
+ * `undefined` for a condition type this evaluator does not own.
+ */
+export var evaluateNumericFilterCondition = function (condition, value, locale) {
+    var _a, _b, _c, _d, _e;
+    var type = condition === null || condition === void 0 ? void 0 : condition.type;
+    if (!type || !isNumericFilterCondition(type))
+        return undefined;
+    var values = (_a = condition === null || condition === void 0 ? void 0 : condition.values) !== null && _a !== void 0 ? _a : [];
+    if (!isNumericFilterCellValue(value)) {
+        // "Does not equal" is the complement of "equals" over the whole column: a
+        // text cell or a blank does not equal 500 and stays visible (a text cell
+        // whose display text IS the criterion hides).
+        if (type === "NUMBER_NOT_EQ" || type === "DATE_NOT_EQ") {
+            var shown = value === undefined || value === null ? "" : String(value);
+            return (shown.trim().toLowerCase() !==
+                ((_c = (_b = values[0]) === null || _b === void 0 ? void 0 : _b.userEnteredValue) !== null && _c !== void 0 ? _c : "").trim().toLowerCase());
+        }
+        return false;
+    }
+    var first = classifyFilterCriterion((_d = values[0]) === null || _d === void 0 ? void 0 : _d.userEnteredValue, locale);
+    var second = TWO_OPERAND_FILTER_CONDITION_TYPES.has(type)
+        ? classifyFilterCriterion((_e = values[1]) === null || _e === void 0 ? void 0 : _e.userEnteredValue, locale)
+        : { kind: "number", value: 0 };
+    if (first.kind === "empty" || second.kind === "empty")
+        return undefined;
+    if (first.kind === "formula" || second.kind === "formula")
+        return undefined;
+    if (first.kind !== "number" || second.kind !== "number")
+        return false;
+    // Date Filters compare calendar days; Number Filters the exact values.
+    var day = isDateFilterCondition(type)
+        ? function (n) { return Math.floor(n); }
+        : function (n) { return n; };
+    var a = day(value);
+    var lo = day(first.value);
+    var hi = day(second.value);
+    switch (type) {
+        case "NUMBER_EQ":
+        case "DATE_EQ":
+            return numbersEqual(a, lo);
+        case "NUMBER_NOT_EQ":
+        case "DATE_NOT_EQ":
+            return !numbersEqual(a, lo);
+        case "NUMBER_GREATER":
+        case "DATE_AFTER":
+            return a > lo;
+        case "NUMBER_GREATER_THAN_EQ":
+        case "DATE_ON_OR_AFTER":
+            return a >= lo;
+        case "NUMBER_LESS":
+        case "DATE_BEFORE":
+            return a < lo;
+        case "NUMBER_LESS_THAN_EQ":
+        case "DATE_ON_OR_BEFORE":
+            return a <= lo;
+        case "NUMBER_BETWEEN":
+        case "DATE_BETWEEN":
+            return a >= lo && a <= hi;
+        case "NUMBER_NOT_BETWEEN":
+        case "DATE_NOT_BETWEEN":
+            return a < lo || a > hi;
+        default:
+            return undefined;
+    }
+};

package/dist/cjs/api/formula.d.ts.map

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

package/dist/cjs/api/formula.js

@@ -1,6 +1,6 @@
 import { __assign, __read, __spreadArray, __values } from "tslib";
 import { cleanupColumnName, cleanupSpecialItem, cleanupTableName, detectCurrentRow, isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
-import { addressToCell, alpha2number, cellToAddress, desanitizeSheetName, number2Alpha, sanitizeSheetName, } from "@rowsncolumns/utils";
+import { addressToCell, alpha2number, cellToAddress, desanitizeSheetName, escapeCharacters, number2Alpha, sanitizeSheetName, } from "@rowsncolumns/utils";
 export { ERROR_CIRCULAR_DEPENDENCY, ERROR_REFERENCE, formulaToRelativeReference, } from "@rowsncolumns/calculator";
 /**
  * Update sheet name in formula
@@ -12,22 +12,24 @@ export var updateSheetName = function (formulaValue, newName, oldName) {
     var e_1, _a;
     var tokens = cloneTokens(lexify(formulaValue).tokens);
     var newTokens = [];
+    // Sheet names compare case-insensitively (Excel's rule); the old name is a literal, not a pattern —
+    // `Q1 (2024)` or `Sheet.2` must match exactly that title.
+    var isOldName = new RegExp("^" + escapeCharacters(oldName) + "$", "i");
     try {
+        // `sanitizeSheetName` re-quotes the new name the way Excel writes it — `'2024'!A1`, `'A1'!A1`,
+        // `'TRUE'!A1` — and drops quotes a plain identifier no longer needs (rowsncolumns/spreadsheet#939 K-10).
         for (var tokens_1 = __values(tokens), tokens_1_1 = tokens_1.next(); !tokens_1_1.done; tokens_1_1 = tokens_1.next()) {
             var token = tokens_1_1.value;
             if (token.tokenType.name === tokenVocabulary.Sheet.name) {
                 token.image =
-                    sanitizeSheetName(token.image
-                        .slice(0, -1)
-                        .replace(new RegExp("^" + oldName + "$", "gi"), newName)) + "!";
+                    sanitizeSheetName(token.image.slice(0, -1).replace(isOldName, newName)) +
+                        "!";
             }
             if (token.tokenType.name === tokenVocabulary.SheetQuoted.name) {
                 var cleanSheetName = desanitizeSheetName(token.image);
                 if (cleanSheetName) {
                     token.image =
-                        sanitizeSheetName(cleanSheetName
-                            .slice(0, -1)
-                            .replace(new RegExp("^" + oldName + "$", "gi"), newName)) + "!";
+                        sanitizeSheetName(cleanSheetName.slice(0, -1).replace(isOldName, newName)) + "!";
                 }
             }
             newTokens.push(token);

package/dist/cjs/api/image-embed.d.ts

@@ -0,0 +1,41 @@
+import type { CellInterface } from "@rowsncolumns/common-types";
+import type { EmbeddedObject } from "@rowsncolumns/spreadsheet";
+import type { UseSpreadsheetProps } from "../hooks/use-spreadsheet-state";
+/**
+ * Upper bound (px) for a floating image's longer side when the grid's viewport is unknown — a
+ * paste or drop outside a mounted `CanvasGrid` (no `getSheetDimensions`). With a viewport the image
+ * is capped to the viewport instead, so a picture is never larger than what the user can see.
+ */
+export declare const DEFAULT_IMAGE_EMBED_MAX_DIMENSION = 800;
+/** The visible grid area in pixels — `CanvasGrid`'s `getSheetDimensions()` (width, height). */
+export type ImageViewport = readonly [width: number, height: number];
+export type ImageEmbedSize = {
+    widthPixels: number;
+    heightPixels: number;
+};
+/**
+ * Excel / Google Sheets default size for an inserted picture: its natural pixel size, only scaled
+ * DOWN (aspect ratio kept) when it would not fit the viewport. Never scales up. An image with an
+ * unknown / degenerate size (0 or NaN) is left as-is so the caller can still place it.
+ */
+export declare const fitImageToViewport: (width: number, height: number, viewport?: ImageViewport | null) => ImageEmbedSize;
+export type CreateImageEmbedOptions = {
+    sheetId: number;
+    /** The cell the picture's top-left corner is anchored to (Excel anchors a pasted picture at the active cell). */
+    anchorCell: CellInterface;
+    imageUrl: string;
+    /** Natural image size in pixels; fitted to `viewport` by {@link fitImageToViewport}. */
+    width: number;
+    height: number;
+    viewport?: ImageViewport | null;
+    /** A fixed id (replacing an existing embed keeps its id); defaults to `idCreationStrategy("embed")` / a uuid. */
+    embedId?: EmbeddedObject["embedId"];
+    idCreationStrategy?: UseSpreadsheetProps["idCreationStrategy"];
+};
+/**
+ * The ONE way a picture becomes a floating object over the cells — shared by the clipboard paste,
+ * the file drop, the Insert → Image dialog and the engine command handlers, so every entry point
+ * produces the same movable, resizable, aspect-locked embed anchored at the target cell.
+ */
+export declare const createImageEmbed: ({ sheetId, anchorCell, imageUrl, width, height, viewport, embedId, idCreationStrategy, }: CreateImageEmbedOptions) => EmbeddedObject;
+//# sourceMappingURL=image-embed.d.ts.map

package/dist/cjs/api/image-embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-embed.d.ts","sourceRoot":"","sources":["../../../api/image-embed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,+FAA+F;AAC/F,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,WAAW,aAAa,GAAG,IAAI,KAC9B,cAaF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,iHAAiH;IACjH,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,iHAAiH;IACjH,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACpC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;CAChE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,0FAS9B,uBAAuB,KAAG,cAyB5B,CAAC"}

package/dist/cjs/api/image-embed.js

@@ -0,0 +1,55 @@
+import { __read } from "tslib";
+import { uuid } from "@rowsncolumns/utils";
+/**
+ * Upper bound (px) for a floating image's longer side when the grid's viewport is unknown — a
+ * paste or drop outside a mounted `CanvasGrid` (no `getSheetDimensions`). With a viewport the image
+ * is capped to the viewport instead, so a picture is never larger than what the user can see.
+ */
+export var DEFAULT_IMAGE_EMBED_MAX_DIMENSION = 800;
+/**
+ * Excel / Google Sheets default size for an inserted picture: its natural pixel size, only scaled
+ * DOWN (aspect ratio kept) when it would not fit the viewport. Never scales up. An image with an
+ * unknown / degenerate size (0 or NaN) is left as-is so the caller can still place it.
+ */
+export var fitImageToViewport = function (width, height, viewport) {
+    if (!(width > 0) || !(height > 0)) {
+        return { widthPixels: width, heightPixels: height };
+    }
+    var _a = __read(viewport && viewport[0] > 0 && viewport[1] > 0
+        ? viewport
+        : [DEFAULT_IMAGE_EMBED_MAX_DIMENSION, DEFAULT_IMAGE_EMBED_MAX_DIMENSION], 2), maxWidth = _a[0], maxHeight = _a[1];
+    var scale = Math.min(1, maxWidth / width, maxHeight / height);
+    return {
+        widthPixels: Math.round(width * scale),
+        heightPixels: Math.round(height * scale),
+    };
+};
+/**
+ * The ONE way a picture becomes a floating object over the cells — shared by the clipboard paste,
+ * the file drop, the Insert → Image dialog and the engine command handlers, so every entry point
+ * produces the same movable, resizable, aspect-locked embed anchored at the target cell.
+ */
+export var createImageEmbed = function (_a) {
+    var _b;
+    var sheetId = _a.sheetId, anchorCell = _a.anchorCell, imageUrl = _a.imageUrl, width = _a.width, height = _a.height, viewport = _a.viewport, embedId = _a.embedId, idCreationStrategy = _a.idCreationStrategy;
+    var _c = fitImageToViewport(width, height, viewport), widthPixels = _c.widthPixels, heightPixels = _c.heightPixels;
+    return {
+        embedId: (_b = embedId !== null && embedId !== void 0 ? embedId : idCreationStrategy === null || idCreationStrategy === void 0 ? void 0 : idCreationStrategy("embed")) !== null && _b !== void 0 ? _b : uuid(),
+        position: {
+            sheetId: sheetId,
+            overlayPosition: {
+                anchorCell: { rowIndex: anchorCell.rowIndex, columnIndex: anchorCell.columnIndex },
+                widthPixels: widthPixels,
+                heightPixels: heightPixels,
+                offsetXPixels: 0,
+                offsetYPixels: 0,
+            },
+        },
+        borderColor: "transparent",
+        lockAspectRatio: true,
+        spec: {
+            type: "image",
+            imageUrl: imageUrl,
+        },
+    };
+};

package/dist/cjs/api/immer-utils.d.ts.map

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

package/dist/cjs/api/immer-utils.js

@@ -62,6 +62,12 @@ export var cloneCellWithFormatting = function (celLData) {
  * first-specific-wins merging rule in `processPrecedentCell`.
  */
 var isGenericNumberFormatType = function (type) { return !type || type === "NUMBER" || type === "GENERAL"; };
+/**
+ * Whether a number format carries a real pattern — `General` (or a missing
+ * pattern) is "no format", the shape a plain typed number and an
+ * unformatted formula result have in Excel.
+ */
+var hasConcretePattern = function (format) { return !!(format === null || format === void 0 ? void 0 : format.pattern) && format.pattern !== "General"; };
 /**
  * Date-family types — when the derived (resolved) type is one of these
  * and the precedent's type is also in this set, we preserve the
@@ -494,6 +500,8 @@ resolvePrecedentNumberFormat) {
     }
     // Priority
     // NUMBER -> PERCENTAGE -> CURRENCY
+    // Assigned inside `processPrecedentCell`; the cast keeps TypeScript from
+    // narrowing the declaration to `undefined` for the reads below.
     var numFormat = undefined;
     // Expected return type from function
     var expectedOutputType = undefined;
@@ -613,8 +621,13 @@ resolvePrecedentNumberFormat) {
             // specific format is locked in we don't let a different specific
             // format override it (e.g. PERCENT then CURRENCY → keep PERCENT,
             // matching Excel; previously priority-based merging picked the
-            // higher-priority one regardless of position).
-            if (!numFormat || isGenericNumberFormatType(numFormat.type)) {
+            // higher-priority one regardless of position). Among generics, a
+            // pattern-less one (a General cell) never displaces an earlier one
+            // that carries a real pattern (`0.0`) — that pattern is the format
+            // Excel would inherit.
+            if (!numFormat ||
+                (isGenericNumberFormatType(numFormat.type) &&
+                    !(hasConcretePattern(numFormat) && !hasConcretePattern(curNumFormat)))) {
                 numFormat = curNumFormat;
             }
         }
@@ -654,11 +667,11 @@ resolvePrecedentNumberFormat) {
     if (typeof calculatedValue === "number") {
         maxDecimals = Math.max(maxDecimals, calculatedDecimals !== null && calculatedDecimals !== void 0 ? calculatedDecimals : 0);
     }
-    if (!numFormat && maxDecimals > 0) {
-        numFormat = { type: "NUMBER" };
-    }
+    // A result with no formatted precedent is General, as in Excel: `=1/3`
+    // displays `0.333333333`, `=PI()` `3.141592654`. Decimals in the computed
+    // value are never a reason to manufacture a NUMBER pattern — a General
+    // result used to get `0.000` here and paint `0.333`.
     var applyDecimalHeuristic = function (format) {
-        var _a;
         // `#` is the implicit integer pattern inferred from plain numeric cells,
         // but it suppresses zero. Formula results should still display a derived
         // zero; an explicitly formatted formula cell returned above remains
@@ -681,21 +694,36 @@ resolvePrecedentNumberFormat) {
                 return __assign(__assign({}, format), { pattern: changeDecimals(format.pattern, calculatedDecimals, false) });
             }
         }
-        // Original heuristic for NUMBER type
-        if ((format === null || format === void 0 ? void 0 : format.type) === "NUMBER" && maxDecimals > 0) {
-            var basePattern = (_a = format.pattern) !== null && _a !== void 0 ? _a : "0";
-            return __assign(__assign({}, format), { pattern: changeDecimals(basePattern, Math.min(maxDecimals, 3), false) });
+        // NUMBER decimals are only ever adjusted on a pattern a precedent
+        // actually carries (`0.0` → `0.00`). A NUMBER type without one — from
+        // General precedents, or from the AST reducing CURRENCY ÷ CURRENCY /
+        // DATE − DATE to a plain number — stays pattern-less and displays
+        // through General (`=D1/D2` → `1.5`, not `1.50`).
+        if ((format === null || format === void 0 ? void 0 : format.type) === "NUMBER" &&
+            hasConcretePattern(format) &&
+            maxDecimals > 0) {
+            return __assign(__assign({}, format), { pattern: changeDecimals(format.pattern, Math.min(maxDecimals, 3), false) });
         }
         return format;
     };
     // Useful for Percentages
     // 20% x 50 => number
-    if (numFormat) {
-        // Does not support structured references as of now
-        var astDerivedNumberFormat = getNumberFormatFromFormulaAst(formula, numFormat, draft, tokenizer, sheetId, getSheetId, cellXfsRegistry, getDataValidationById, locale);
-        if (astDerivedNumberFormat) {
-            return applyDecimalHeuristic(astDerivedNumberFormat);
+    // The AST runs even when no precedent carried a format: it knows that
+    // `=NOW()-TODAY()` is a plain number where the function-return-type scan
+    // below would call it DATE_TIME. A General placeholder stands in for the
+    // missing precedent format and comes back as a pattern-less NUMBER for a
+    // General result. Does not support structured references as of now.
+    var astDerivedNumberFormat = getNumberFormatFromFormulaAst(formula, numFormat !== null && numFormat !== void 0 ? numFormat : { type: "NUMBER" }, draft, tokenizer, sheetId, getSheetId, cellXfsRegistry, getDataValidationById, locale);
+    if (astDerivedNumberFormat) {
+        if (!numFormat &&
+            astDerivedNumberFormat.type === "NUMBER" &&
+            !astDerivedNumberFormat.pattern) {
+            // The placeholder came back unchanged: a General result with no
+            // formatted precedent has no format at all (`=1/3`, `=B1` of a plain
+            // cell, `=NOW()-TODAY()`).
+            return undefined;
         }
+        return applyDecimalHeuristic(astDerivedNumberFormat);
     }
     // If we could not derive from function
     if (expectedOutputType === undefined) {