@rowsncolumns/spreadsheet-state 29.1.4 → 29.1.6

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) {

package/dist/cjs/api/named-range-structural.d.ts

@@ -2,6 +2,21 @@ import type { NamedRange, SheetPrintSettings } from "@rowsncolumns/spreadsheet";
 import type { WritableDraft } from "immer";
 export type StructuralAxis = "row" | "column";
 export type StructuralOp = "insert" | "delete";
+/**
+ * The edited axis's extent, so a band can be recognised as UNBOUNDED on it:
+ * a whole-column name is modelled as `B1:B<rowCount>` and a whole-row name
+ * as `A1:<columnCount>1`, and Excel keeps `$B:$B` / `$1:$1` whole through
+ * every insert / delete on that axis.
+ */
+export type StructuralAxisBounds = {
+    /** The sheet's row / column count on the edited axis before the edit. */
+    length: number;
+    /**
+     * The hard cap the grid never grows past (`maxRowCount` / `maxColumnCount`);
+     * a band's end is clamped to it and a band pushed past it is `#REF!`.
+     */
+    max?: number;
+};
 /**
  * The `value` a defined name carries once every cell of its range has been
  * deleted. Excel keeps the name in the Name Manager as `=Sheet1!#REF!` and
@@ -22,8 +37,15 @@ export declare const isRefErrorNamedRange: (namedRange: Pick<NamedRange, "range"
  * - insert at the boundary directly below → unchanged;
  * - delete wholly above → shifts back; delete overlapping → shrinks by the
  *   deleted indices inside the band; delete covering the band → `null`.
+ *
+ * With `bounds`, a band that spans the whole axis (`1..length` — a
+ * whole-column `$B:$B` / whole-row `$1:$1` name) is unbounded on it: an
+ * insert anywhere keeps its start at 1 and stretches its end with the grid
+ * (Excel never turns `$B:$B` into `$B$2:$B$1001`), a delete only shrinks the
+ * end with the grid. Ends never pass `bounds.max`; a band whose start would
+ * is `null` (`#REF!`), like a cell reference pushed off the sheet.
  */
-export declare const shiftNamedBand: (start: number, end: number, op: StructuralOp, index: number, count: number) => [number, number] | null;
+export declare const shiftNamedBand: (start: number, end: number, op: StructuralOp, index: number, count: number, bounds?: StructuralAxisBounds) => [number, number] | null;
 export type NamedRangeStructuralUpdate<N extends NamedRange> = {
     /** Names whose range moved, grew, or shrank. */
     changed: N[];
@@ -41,13 +63,17 @@ export type NamedRangeStructuralUpdate<N extends NamedRange> = {
  * A name whose entire range is deleted is NOT dropped: it keeps its entry
  * with `range` cleared and `value: "#REF!"`, so `=SUM(Data)` evaluates to
  * `#REF!` like Excel rather than `#NAME?`.
+ *
+ * `bounds` (the edited sheet's row / column count on the edited axis) lets a
+ * whole-column / whole-row name keep its whole-axis geometry — see
+ * {@link shiftNamedBand}.
  */
-export declare const updateNamedRangesOnStructuralChange: (draft: WritableDraft<NamedRange>[], axis: StructuralAxis, op: StructuralOp, index: number, count: number, sheetId: number) => NamedRangeStructuralUpdate<WritableDraft<NamedRange>>;
+export declare const updateNamedRangesOnStructuralChange: (draft: WritableDraft<NamedRange>[], axis: StructuralAxis, op: StructuralOp, index: number, count: number, sheetId: number, bounds?: StructuralAxisBounds) => NamedRangeStructuralUpdate<WritableDraft<NamedRange>>;
 /**
  * Pure variant of {@link updateNamedRangesOnStructuralChange}: returns the
  * adjusted list (sharing untouched entries) plus the names that changed.
  */
-export declare const shiftNamedRangesOnStructuralChange: <N extends NamedRange>(namedRanges: readonly N[], axis: StructuralAxis, op: StructuralOp, index: number, count: number, sheetId: number) => {
+export declare const shiftNamedRangesOnStructuralChange: <N extends NamedRange>(namedRanges: readonly N[], axis: StructuralAxis, op: StructuralOp, index: number, count: number, sheetId: number, bounds?: StructuralAxisBounds) => {
     next: N[];
 } & NamedRangeStructuralUpdate<N>;
 /**

package/dist/cjs/api/named-range-structural.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"named-range-structural.d.ts","sourceRoot":"","sources":["../../../api/named-range-structural.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,GAC/B,YAAY,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,YACmB,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,KAAK,MAAM,EACX,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAgBrB,CAAC;AAmBF,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,UAAU,IAAI;IAC7D,gDAAgD;IAChD,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,gEAAgE;IAChE,UAAU,EAAE,CAAC,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mCAAmC,GAC9C,OAAO,aAAa,CAAC,UAAU,CAAC,EAAE,EAClC,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,SAAS,MAAM,KACd,0BAA0B,CAAC,aAAa,CAAC,UAAU,CAAC,CAmBtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kCAAkC,GAAI,CAAC,SAAS,UAAU,EACrE,aAAa,SAAS,CAAC,EAAE,EACzB,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,SAAS,MAAM,KACd;IAAE,IAAI,EAAE,CAAC,EAAE,CAAA;CAAE,GAAG,0BAA0B,CAAC,CAAC,CAsB9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,GAChD,eAAe,aAAa,CAAC,kBAAkB,CAAC,EAChD,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,OAiDF,CAAC"}
+{"version":3,"file":"named-range-structural.d.ts","sourceRoot":"","sources":["../../../api/named-range-structural.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,GAC/B,YAAY,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,YACmB,CAAC;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,KAAK,MAAM,EACX,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,SAAS,oBAAoB,KAC5B,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IA2BrB,CAAC;AA2BF,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,UAAU,IAAI;IAC7D,gDAAgD;IAChD,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,gEAAgE;IAChE,UAAU,EAAE,CAAC,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mCAAmC,GAC9C,OAAO,aAAa,CAAC,UAAU,CAAC,EAAE,EAClC,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,SAAS,MAAM,EACf,SAAS,oBAAoB,KAC5B,0BAA0B,CAAC,aAAa,CAAC,UAAU,CAAC,CAmBtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kCAAkC,GAAI,CAAC,SAAS,UAAU,EACrE,aAAa,SAAS,CAAC,EAAE,EACzB,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,SAAS,MAAM,EACf,SAAS,oBAAoB,KAC5B;IAAE,IAAI,EAAE,CAAC,EAAE,CAAA;CAAE,GAAG,0BAA0B,CAAC,CAAC,CAsB9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,GAChD,eAAe,aAAa,CAAC,kBAAkB,CAAC,EAChD,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,OAiDF,CAAC"}