@rowsncolumns/spreadsheet-state 29.1.4 → 29.1.7

package/dist/cjs/api/circular-reference.d.ts

@@ -0,0 +1,31 @@
+/** A formula cell the engine stamped as a member of a circular reference. */
+export type CircularReferenceCell = {
+    sheetId: number;
+    rowIndex: number;
+    columnIndex: number;
+};
+export declare const CIRCULAR_REFERENCE_WARNING_TITLE = "Circular Reference";
+/** Excel's circular-reference warning (iterative calculation off: the cells display 0). */
+export declare const CIRCULAR_REFERENCE_WARNING = "There are one or more circular references where a formula refers to its own cell either directly or indirectly. This might cause them to calculate incorrectly. Try removing or changing these references, or moving the formulas to different cells.";
+/**
+ * The warning text for a batch of newly circular cells: Excel's sentence plus the addresses so the
+ * user can find them (`Sheet2!N20` when the workbook has more than one sheet).
+ */
+export declare const formatCircularReferenceWarning: (cells: readonly CircularReferenceCell[], getSheetName?: (sheetId: number) => string | undefined, qualifySheet?: boolean) => string;
+/**
+ * Excel warns ONCE when a circular reference appears, not on every recalculation of the loop —
+ * this tracks the cells already warned about so a batch only surfaces the NEW ones. A tracked
+ * cell is forgotten when a later batch recalculates it without stamping it circular (the loop
+ * was broken), so re-creating the loop warns again.
+ */
+export declare class CircularReferenceTracker {
+    private readonly known;
+    /**
+     * @param circular the cells this batch stamped circular
+     * @param recalculated every cell this batch recomputed (optional — without it, a broken loop is
+     *   never forgotten, so the same cell warns once per tracker lifetime)
+     * @returns the circular cells not warned about before
+     */
+    next(circular: readonly CircularReferenceCell[] | undefined, recalculated?: Iterable<CircularReferenceCell>): CircularReferenceCell[];
+}
+//# sourceMappingURL=circular-reference.d.ts.map

package/dist/cjs/api/circular-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circular-reference.d.ts","sourceRoot":"","sources":["../../../api/circular-reference.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,gCAAgC,uBAAuB,CAAC;AAErE,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,0PACkN,CAAC;AAO1P;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GACzC,OAAO,SAAS,qBAAqB,EAAE,EACvC,eAAe,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACtD,sBAAoB,WAUrB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C;;;;;OAKG;IACH,IAAI,CACF,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,EACtD,YAAY,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAC7C,qBAAqB,EAAE;CAoB3B"}

package/dist/cjs/api/circular-reference.js

@@ -0,0 +1,85 @@
+import { __values } from "tslib";
+import { cellToAddress } from "@rowsncolumns/utils";
+export var CIRCULAR_REFERENCE_WARNING_TITLE = "Circular Reference";
+/** Excel's circular-reference warning (iterative calculation off: the cells display 0). */
+export var CIRCULAR_REFERENCE_WARNING = "There are one or more circular references where a formula refers to its own cell either directly or indirectly. This might cause them to calculate incorrectly. Try removing or changing these references, or moving the formulas to different cells.";
+var MAX_LISTED_CELLS = 8;
+var cellKey = function (cell) {
+    return "".concat(cell.sheetId, ":").concat(cell.rowIndex, ":").concat(cell.columnIndex);
+};
+/**
+ * The warning text for a batch of newly circular cells: Excel's sentence plus the addresses so the
+ * user can find them (`Sheet2!N20` when the workbook has more than one sheet).
+ */
+export var formatCircularReferenceWarning = function (cells, getSheetName, qualifySheet) {
+    if (qualifySheet === void 0) { qualifySheet = false; }
+    var addresses = cells.slice(0, MAX_LISTED_CELLS).map(function (cell) {
+        var _a;
+        var address = (_a = cellToAddress(cell)) !== null && _a !== void 0 ? _a : "R".concat(cell.rowIndex, "C").concat(cell.columnIndex);
+        var sheetName = qualifySheet ? getSheetName === null || getSheetName === void 0 ? void 0 : getSheetName(cell.sheetId) : undefined;
+        return sheetName ? "".concat(sheetName, "!").concat(address) : address;
+    });
+    var more = cells.length - addresses.length;
+    var list = more > 0 ? "".concat(addresses.join(", "), " and ").concat(more, " more") : addresses.join(", ");
+    return list ? "".concat(CIRCULAR_REFERENCE_WARNING, "\n\nCircular references: ").concat(list) : CIRCULAR_REFERENCE_WARNING;
+};
+/**
+ * Excel warns ONCE when a circular reference appears, not on every recalculation of the loop —
+ * this tracks the cells already warned about so a batch only surfaces the NEW ones. A tracked
+ * cell is forgotten when a later batch recalculates it without stamping it circular (the loop
+ * was broken), so re-creating the loop warns again.
+ */
+var CircularReferenceTracker = /** @class */ (function () {
+    function CircularReferenceTracker() {
+        this.known = new Set();
+    }
+    /**
+     * @param circular the cells this batch stamped circular
+     * @param recalculated every cell this batch recomputed (optional — without it, a broken loop is
+     *   never forgotten, so the same cell warns once per tracker lifetime)
+     * @returns the circular cells not warned about before
+     */
+    CircularReferenceTracker.prototype.next = function (circular, recalculated) {
+        var e_1, _a, e_2, _b;
+        var stamped = new Set((circular !== null && circular !== void 0 ? circular : []).map(cellKey));
+        if (recalculated && this.known.size) {
+            try {
+                for (var recalculated_1 = __values(recalculated), recalculated_1_1 = recalculated_1.next(); !recalculated_1_1.done; recalculated_1_1 = recalculated_1.next()) {
+                    var cell = recalculated_1_1.value;
+                    var key = cellKey(cell);
+                    if (!stamped.has(key)) {
+                        this.known.delete(key);
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (recalculated_1_1 && !recalculated_1_1.done && (_a = recalculated_1.return)) _a.call(recalculated_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
+        var fresh = [];
+        try {
+            for (var _c = __values(circular !== null && circular !== void 0 ? circular : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var cell = _d.value;
+                var key = cellKey(cell);
+                if (!this.known.has(key)) {
+                    this.known.add(key);
+                    fresh.push(cell);
+                }
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        return fresh;
+    };
+    return CircularReferenceTracker;
+}());
+export { CircularReferenceTracker };

package/dist/cjs/api/copy-paste.d.ts

@@ -1,6 +1,7 @@
 import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
 import type { CellData, EmbeddedObject, TableView } from "@rowsncolumns/spreadsheet";
 import type { UseSpreadsheetProps } from "../hooks/use-spreadsheet-state";
+import { type ImageViewport } from "./image-embed";
 export type ClipBoardFormat = "text/html" | "text/csv" | "text/plain" | "application/json" | "image/apng" | "image/bmp" | "image/gif" | "image/jpeg" | "image/pjpeg" | "image/png" | "image/svg+xml" | "image/tiff" | "image/webp" | "image/x-icon";
 export declare const SUPPORTED_IMAGE_TYPES: string[];
 export declare const generateDataFromClipboard: <T extends CellData>(e: ClipboardEvent | undefined, activeCell: CellInterface, sheetId: number, activeSheetName: string, preserveFormatting?: boolean, locale?: string, idCreationStrategy?: UseSpreadsheetProps<T>["idCreationStrategy"], forcePlainText?: boolean, sanitizeHtml?: (html: string) => string, options?: {
@@ -10,6 +11,11 @@ export declare const generateDataFromClipboard: <T extends CellData>(e: Clipboar
      * only repoints references INTO the moved block, which the consumer does itself.
      */
     relocateFormulas?: boolean;
+    /**
+     * The visible grid area (`CanvasGrid.getSheetDimensions()`): a pasted image FILE becomes a
+     * floating picture at its natural size, scaled down to fit this viewport (Excel / Sheets).
+     */
+    imageViewport?: ImageViewport | null;
 }) => Promise<{
     results?: (CellData | null | undefined)[][];
     merges?: GridRange[];

package/dist/cjs/api/copy-paste.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-paste.d.ts","sourceRoot":"","sources":["../../../api/copy-paste.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAcnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAW1E,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,CAAC;AAEnB,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAU,CAAC,SAAS,QAAQ,EAChE,GAAG,cAAc,GAAG,SAAS,EAC7B,YAAY,aAAa,EACzB,SAAS,MAAM,EACf,iBAAiB,MAAM,EACvB,qBAAqB,OAAO,EAC5B,SAAS,MAAM,EACf,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,EACjE,iBAAiB,OAAO,EACxB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACvC,UAAU;IACR;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KACA,OAAO,CACN;IACE,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACD,SAAS,CAqQZ,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAazC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,yCAwB9C;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAC1C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAkChB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAwBhB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,KACnD,MAAM,EAmBR,CAAC"}
+{"version":3,"file":"copy-paste.d.ts","sourceRoot":"","sources":["../../../api/copy-paste.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAcnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAS1E,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAGrE,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,CAAC;AAEnB,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAU,CAAC,SAAS,QAAQ,EAChE,GAAG,cAAc,GAAG,SAAS,EAC7B,YAAY,aAAa,EACzB,SAAS,MAAM,EACf,iBAAiB,MAAM,EACvB,qBAAqB,OAAO,EAC5B,SAAS,MAAM,EACf,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,EACjE,iBAAiB,OAAO,EACxB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACvC,UAAU;IACR;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC,KACA,OAAO,CACN;IACE,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACD,SAAS,CAkRZ,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAazC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,yCAwB9C;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAC1C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAkChB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAwBhB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,KACnD,MAAM,EAmBR,CAAC"}

package/dist/cjs/api/copy-paste.js

@@ -5,6 +5,7 @@ import { uuid } from "@rowsncolumns/utils";
 import { defaultCellCoords, defaultSheetId, isStyleReference, SheetCell, } from "../sheet-cell";
 import { isRichSharedString } from "../types";
 import { isBoolean, isValidURLorEmail } from "./datatype";
+import { createImageEmbed } from "./image-embed";
 import { parseHtml } from "./parse-html";
 export var SUPPORTED_IMAGE_TYPES = [
     "image/apng",
@@ -19,7 +20,7 @@ export var SUPPORTED_IMAGE_TYPES = [
     "image/x-icon",
 ];
 export var generateDataFromClipboard = function (e, activeCell, sheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml, options) { return __awaiter(void 0, void 0, void 0, function () {
-    var items, files, formatOrder, plainTextValue, isFormula, format, rows, filesArray, filesArray_1, filesArray_1_1, file, _a, imageUrl, e_1_1, clipboardValue, sheetCell, clipboard, isPlainTextOnly, _b, parsed, sheetData, tables, cellXfs, parsedSharedStrings, sharedStrings_1, tables_1, tables_1_1, table, rowDelta, colDelta, rowSpan, colSpan, merges_1, cellXfsMap_1, results, itemsArray, itemsArray_1, itemsArray_1_1, item, e_2_1, results, results;
+    var items, files, formatOrder, plainTextValue, isFormula, format, embeds, filesArray, filesArray_1, filesArray_1_1, file, _a, imageUrl, width, height, e_1_1, clipboardValue, sheetCell, clipboard, isPlainTextOnly, _b, parsed, sheetData, tables, cellXfs, parsedSharedStrings, sharedStrings_1, tables_1, tables_1_1, table, rowDelta, colDelta, rowSpan, colSpan, merges_1, cellXfsMap_1, results, itemsArray, itemsArray_1, itemsArray_1_1, item, e_2_1, results, results;
     var e_1, _c, e_3, _d, e_2, _e;
     var _f, _g, _h, _j, _k, _l, _m;
     return __generator(this, function (_o) {
@@ -39,7 +40,7 @@ export var generateDataFromClipboard = function (e, activeCell, sheetId, activeS
                     ? "text/plain"
                     : formatOrder.find(function (type) { var _a; return (_a = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _a === void 0 ? void 0 : _a.getData(type); });
                 if (!((files === null || files === void 0 ? void 0 : files.length) && !format)) return [3 /*break*/, 9];
-                rows = [];
+                embeds = [];
                 filesArray = Array.from(files);
                 _o.label = 1;
             case 1:
@@ -54,12 +55,16 @@ export var generateDataFromClipboard = function (e, activeCell, sheetId, activeS
                 }
                 return [4 /*yield*/, readImageFileAsDataUri(file)];
             case 3:
-                _a = __read.apply(void 0, [_o.sent(), 1]), imageUrl = _a[0];
-                rows.push([
-                    {
-                        imageUrl: imageUrl,
-                    },
-                ]);
+                _a = __read.apply(void 0, [_o.sent(), 3]), imageUrl = _a[0], width = _a[1], height = _a[2];
+                embeds.push(createImageEmbed({
+                    sheetId: sheetId,
+                    anchorCell: activeCell,
+                    imageUrl: imageUrl,
+                    width: width,
+                    height: height,
+                    viewport: options === null || options === void 0 ? void 0 : options.imageViewport,
+                    idCreationStrategy: idCreationStrategy,
+                }));
                 _o.label = 4;
             case 4:
                 filesArray_1_1 = filesArray_1.next();
@@ -76,7 +81,8 @@ export var generateDataFromClipboard = function (e, activeCell, sheetId, activeS
                 finally { if (e_1) throw e_1.error; }
                 return [7 /*endfinally*/];
             case 8: return [2 /*return*/, {
-                    results: rows,
+                    results: [],
+                    embeds: embeds,
                 }];
             case 9:
                 if (!items || !format) {
@@ -252,13 +258,16 @@ export var generateDataFromClipboard = function (e, activeCell, sheetId, activeS
                     results = clipboardValue.split("\n").map(function (cellValues) {
                         return cellValues.split("\t").map(function (value) {
                             var trimmedValue = value.trim();
-                            var isFormula = isAFormula(trimmedValue);
                             var isEmptyValue = trimmedValue.length === 0;
-                            // Force text for formulas (prevent execution), and when forcePlainText
-                            // is enabled, also for booleans (prevent coercion) and URLs (prevent auto-linking)
-                            var needsTextPrefix = isFormula ||
-                                (forcePlainText &&
-                                    (isBoolean(trimmedValue) || isValidURLorEmail(trimmedValue)));
+                            // A pasted `=…` cell is classified exactly like the same text typed into the cell
+                            // (Excel / Google Sheets parse `=`-prefixed plain text as formulas; a `'=` quote
+                            // prefix keeps it text, as when typing). Only an explicit "paste as plain text"
+                            // request (Ctrl/Cmd+Shift+V) forces formulas, booleans (prevent coercion) and URLs
+                            // (prevent auto-linking) to text.
+                            var needsTextPrefix = forcePlainText &&
+                                (isAFormula(trimmedValue) ||
+                                    isBoolean(trimmedValue) ||
+                                    isValidURLorEmail(trimmedValue));
                             var shouldForceText = isPlainTextOnly &&
                                 !isEmptyValue &&
                                 needsTextPrefix &&

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

@@ -5,6 +5,8 @@ export declare const pattern_percent = "0%";
 export declare const pattern_percent_decimal = "0.00%";
 export declare const pattern_currency = "\"$\"#,##0_);(\"$\"#,##0)";
 export declare const pattern_currency_decimal = "\"$\"#,##0.00_);(\"$\"#,##0.00)";
+export declare const pattern_comma = "_(* #,##0.00_);_(* (#,##0.00);_(* \"-\"??_);_(@_)";
+export declare const pattern_comma_rounded = "_(* #,##0_);_(* (#,##0);_(* \"-\"??_);_(@_)";
 export declare const date_pattern = "mm/dd/yyyy";
 export declare const time_pattern_base = "hh:mm:ss";
 export declare const time_pattern = "hh:mm:ss AM/PM";

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

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

package/dist/cjs/api/datatype.js

@@ -1,7 +1,7 @@
 import { __read, __values } from "tslib";
-import { getDefaultDateFormat, getDefaultDateTimeFormat, isAFormula, isNil, ssfFormat, ssfFormatColor, toDate, toSerial, } from "@rowsncolumns/utils";
+import { getDefaultDateFormat, getDefaultDateTimeFormat, isAFormula, isNil, ssfFormat, ssfFormatColor, toDate, toSerial, toSerialFromParts, } from "@rowsncolumns/utils";
 import { detectDateFormatPattern, detectDateTimeFormatPattern, isValidDate, isValidDateTime, toTimeSerial, validateDate, validateDateTime, } from "./date";
-import { detectDecimalPattern } from "./decimals";
+import { changeDecimals, detectDecimalPattern, getDecimalPlaces, hasThousandsGrouping, pattern_number_thousands, } from "./decimals";
 import { buildGroupRegex, getGroupingInfo, getLocaleDigitMap, getLocaleSeparators, getPercentSignInfo, getSignInfo, } from "./intl";
 export var pattern_percent = "0%";
 export var pattern_percent_decimal = "0.00%";
@@ -12,6 +12,11 @@ export var pattern_percent_decimal = "0.00%";
 // Excel renders the workbook identically to one it produced itself.
 export var pattern_currency = '"$"#,##0_);("$"#,##0)';
 export var pattern_currency_decimal = '"$"#,##0.00_);("$"#,##0.00)';
+// Excel's built-in "Comma Style" / "Comma [0]" cell styles (numFmtId 43 / 41):
+// accounting layout without a currency symbol — negatives in parentheses,
+// zero as `-`, padded so the digits align in a column. Neither is red.
+export var pattern_comma = '_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)';
+export var pattern_comma_rounded = '_(* #,##0_);_(* (#,##0);_(* "-"??_);_(@_)';
 export var date_pattern = "mm/dd/yyyy";
 export var time_pattern_base = "hh:mm:ss";
 export var time_pattern = "hh:mm:ss AM/PM";
@@ -429,11 +434,12 @@ export var createNumberValue = function (value, numFormatType, locale, use1904,
     var isDate = numFormatType === "DATE";
     var isDateTime = numFormatType === "DATE_TIME";
     if (typeof value !== "boolean" && (isDate || isDateTime)) {
+        // A number is already a serial: applying the Date type only changes the
+        // format. Round-tripping it through `toDate`/`toSerial` moved Excel's
+        // phantom 1900-02-29 (60) onto the 28th (59) because no `Date` holds the
+        // 29th (rowsncolumns/spreadsheet#1026).
         if (typeof value === "number") {
-            var dateValue_1 = createDateValueFromNumber(value, use1904);
-            if (!isNil(dateValue_1) && dateValue_1 instanceof Date) {
-                return toSerial(dateValue_1, use1904);
-            }
+            return value;
         }
         var dateValue = isDate
             ? validateDate(value, locale)
@@ -443,7 +449,7 @@ export var createNumberValue = function (value, numFormatType, locale, use1904,
             if (isTimeOnly) {
                 return toTimeSerial(hour !== null && hour !== void 0 ? hour : 0, minute !== null && minute !== void 0 ? minute : 0, second !== null && second !== void 0 ? second : 0);
             }
-            return toSerial(new Date(year, month, day, hour, minute, second, 0), use1904);
+            return toSerialFromParts(year, month, day, hour, minute, second, use1904);
         }
     }
     return convertToNumber(value, locale, lenientGrouping);
@@ -491,6 +497,33 @@ export var detectNumberFormatType = function (value, locale, lenientGrouping) {
         return "DATE_TIME";
     }
 };
+/**
+ * Currency base pattern for a typed literal: the detected symbol in the position it was typed
+ * (`$30` → `"$"#,##0`, `12,50 €` → `#,##0"€"`), defaulting to a `$` prefix.
+ */
+var currencyBasePattern = function (value) {
+    var currencyInfo = extractCurrencySymbol(String(value));
+    var symbol = (currencyInfo === null || currencyInfo === void 0 ? void 0 : currencyInfo.symbol) || "$";
+    var position = (currencyInfo === null || currencyInfo === void 0 ? void 0 : currencyInfo.position) || "prefix";
+    return position === "suffix" ? "#,##0\"".concat(symbol, "\"") : "\"".concat(symbol, "\"#,##0");
+};
+/**
+ * Currency / percent pattern whose decimal places are the ones the user TYPED
+ * (`$1,234.50` → `"$"#,##0.00`, `50.00%` → `0.00%`), not the parsed number's (`1234.5` → one
+ * place), so trailing zeros survive like in Excel. The base already carries the symbol and
+ * grouping, so only the decimals are appended. Ports Rust `detect_decimal_pattern_typed`; both
+ * `detectValueTypeAndPattern` (typed cell entry) and `detectNumberFormatPattern` go through it
+ * so the two never disagree on the same literal.
+ */
+var detectTypedDecimalPattern = function (value, numberValue, basePattern, locale) {
+    // A JS number carries no typed digits; its own decimal expansion is the best we have (a
+    // percent's `numberValue` is already /100, so it must not be the source for a numeric input).
+    var typed = typeof value === "string" || typeof value === "number"
+        ? value
+        : numberValue !== null && numberValue !== void 0 ? numberValue : 0;
+    var decimalsLen = getDecimalPlaces(typed, locale);
+    return decimalsLen ? changeDecimals(basePattern, decimalsLen, true) : basePattern;
+};
 /**
  * Detect pattern of a number format
  * @param type
@@ -499,16 +532,10 @@ export var detectNumberFormatType = function (value, locale, lenientGrouping) {
 export var detectNumberFormatPattern = function (value, numberValue, type, locale, use1904) {
     var _a, _b;
     if (type === "PERCENT") {
-        return detectDecimalPattern(value, pattern_percent, locale);
+        return detectTypedDecimalPattern(value, numberValue, pattern_percent, locale);
     }
     if (type === "CURRENCY") {
-        // Extract the actual currency symbol and position from the input
-        var currencyInfo = extractCurrencySymbol(String(value));
-        var symbol = (currencyInfo === null || currencyInfo === void 0 ? void 0 : currencyInfo.symbol) || "$";
-        var position = (currencyInfo === null || currencyInfo === void 0 ? void 0 : currencyInfo.position) || "prefix";
-        // Create a pattern with the detected currency symbol in the correct position
-        var baseCurrencyPattern = position === "suffix" ? "#,##0\"".concat(symbol, "\"") : "\"".concat(symbol, "\"#,##0");
-        return detectDecimalPattern(numberValue, baseCurrencyPattern, locale);
+        return detectTypedDecimalPattern(value, numberValue, currencyBasePattern(value), locale);
     }
     if (type === "DATE") {
         return (_a = detectDateFormatPattern(value, locale)) !== null && _a !== void 0 ? _a : date_pattern;
@@ -517,17 +544,20 @@ export var detectNumberFormatPattern = function (value, numberValue, type, local
         return (_b = detectDateTimeFormatPattern(value)) !== null && _b !== void 0 ? _b : time_pattern;
     }
     if (type === "NUMBER") {
-        // An integer zero with no explicit format stays "General" — typing `0`,
-        // `00`, or a signed zero into a blank cell shouldn't manufacture a `#`
-        // number pattern that renders the value as blank. This rule is
-        // specific to the implicit NUMBER format; explicit CURRENCY / PERCENT
-        // formats keep their own base pattern for zero (handled above), so `$0`
-        // stays `"$"#,##0` rather than collapsing to a bare `0`.
-        if (value === 0 ||
-            (typeof value === "string" && /^[-+]?0+$/.test(value.trim()))) {
-            return "General";
+        // Excel leaves a General cell General for a plain number — `5`, `5.25`,
+        // `1.50`, `0.0000123` all display through General (`1.5`, `1.23E-05`)
+        // and stamp nothing, so a later entry in the same cell is never rounded
+        // through an inferred `#` / `#.00`. Only a thousands-grouped literal
+        // (`1,000`, `1,234.56`) is a formatting cue: it stamps `#,##0` plus the
+        // typed decimal places, and that stamp then sticks like any other format
+        // (Excel shows `0` for a later `0.25`). This rule is specific to the
+        // implicit NUMBER format; explicit CURRENCY / PERCENT formats keep their
+        // own base pattern (handled above), so `$0` stays `"$"#,##0`.
+        if (typeof value === "string" &&
+            hasThousandsGrouping(value, locale, numberValue)) {
+            return detectDecimalPattern(value, pattern_number_thousands, locale);
         }
-        return detectDecimalPattern(value, undefined, locale);
+        return "General";
     }
     return undefined;
 };
@@ -590,18 +620,12 @@ export var detectValueTypeAndPattern = function (value, locale, lenientGrouping,
         }
         // Check currency
         if (isCurr) {
-            // Extract the actual currency symbol and position from the input
-            var currencyInfo = extractCurrencySymbol(String(value));
-            var symbol = (currencyInfo === null || currencyInfo === void 0 ? void 0 : currencyInfo.symbol) || "$";
-            var position = (currencyInfo === null || currencyInfo === void 0 ? void 0 : currencyInfo.position) || "prefix";
-            // Create a pattern with the detected currency symbol in the correct position
-            var baseCurrencyPattern = position === "suffix" ? "#,##0\"".concat(symbol, "\"") : "\"".concat(symbol, "\"#,##0");
-            var pattern = detectDecimalPattern(numberValue, baseCurrencyPattern, locale);
+            var pattern = detectTypedDecimalPattern(value, numberValue, currencyBasePattern(value), locale);
             return ["numberValue", "CURRENCY", numberValue, pattern];
         }
         // Numbers can be number, percent, date, datetime
         if (isPercentage(value, locale, lenientGrouping)) {
-            var pattern = detectDecimalPattern(numberValue, pattern_percent, locale);
+            var pattern = detectTypedDecimalPattern(value, numberValue, pattern_percent, locale);
             var percentValue = convertToNumber(value, locale, lenientGrouping) / 100;
             return ["numberValue", "PERCENT", percentValue, pattern];
         }
@@ -625,14 +649,16 @@ export var detectValueTypeAndPattern = function (value, locale, lenientGrouping,
         var _a = dateTimeValue.parts, year = _a.year, month = _a.month, day = _a.day, hour = _a.hour, minute = _a.minute, second = _a.second, isTimeOnly = dateTimeValue.isTimeOnly;
         var numberValue = isTimeOnly
             ? toTimeSerial(hour !== null && hour !== void 0 ? hour : 0, minute !== null && minute !== void 0 ? minute : 0, second !== null && second !== void 0 ? second : 0)
-            : toSerial(new Date(year, month, day, hour, minute, second, 0), use1904);
+            : toSerialFromParts(year, month, day, hour, minute, second, use1904);
         return ["numberValue", "DATE_TIME", numberValue, dateTimeValue.format];
     }
     // Dates
     var dateValue = validateDate(value, locale);
     if (dateValue) {
         var _b = dateValue.parts, year = _b.year, month = _b.month, day = _b.day, hour = _b.hour, minute = _b.minute, second = _b.second;
-        var numberValue = toSerial(new Date(year, month, day, hour, minute, second, 0), use1904);
+        // Parts, not a `Date`: Excel's phantom 1900-02-29 must land on serial 60
+        // rather than roll over to March 1 (rowsncolumns/spreadsheet#1026).
+        var numberValue = toSerialFromParts(year, month, day, hour, minute, second, use1904);
         return ["numberValue", "DATE", numberValue, dateValue.format];
     }
     return ["stringValue"];

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

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../api/date.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAYD,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,MAAM,GAAG,SAAS,KACzB,eAAe,GAAG,SAiCpB,CAAC;AAGF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,KAClD,eAAe,GAAG,SAoEpB,CAAC;AA6CF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,WAGxE,CAAC;AAwBF,eAAO,MAAM,WAAW,GACtB,OAAO,GAAG,EACV,QAAQ,MAAM,GAAG,SAAS,KACzB,OAKF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,GAAG,KAAG,OAK5C,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAClC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,MAAM,GAAG,SAAS,KACzB,MAAM,GAAG,SAKX,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,KAClD,MAAM,GAAG,SAKX,CAAC;AAYF,eAAO,MAAM,cAAc,cAA+B,CAAC;AAC3D,eAAO,MAAM,eAAe,cAAgC,CAAC;AAC7D,eAAO,MAAM,aAAa,cAA8B,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../api/date.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAYD,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,MAAM,GAAG,SAAS,KACzB,eAAe,GAAG,SAsCpB,CAAC;AAGF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,KAClD,eAAe,GAAG,SAsEpB,CAAC;AA6CF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,WAGxE,CAAC;AAwBF,eAAO,MAAM,WAAW,GACtB,OAAO,GAAG,EACV,QAAQ,MAAM,GAAG,SAAS,KACzB,OAKF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,GAAG,KAAG,OAK5C,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAClC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,MAAM,GAAG,SAAS,KACzB,MAAM,GAAG,SAKX,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,KAClD,MAAM,GAAG,SAKX,CAAC;AAYF,eAAO,MAAM,cAAc,cAA+B,CAAC;AAC3D,eAAO,MAAM,eAAe,cAAgC,CAAC;AAC7D,eAAO,MAAM,aAAa,cAA8B,CAAC"}

package/dist/cjs/api/date.js

@@ -17,14 +17,17 @@ var TIME_FORMATS = {
     FULL: "hh:mm:ss",
     SHORT_WITH_MERIDIAN: "hh:mm AM/PM",
     SHORT: "hh:mm",
-    // Excel "elapsed time" patterns. The square brackets around `h` tell the
-    // formatter to display the full elapsed-hours count without wrapping at
-    // 24 — `[h]:mm:ss` will render a 25.5-hour duration as `25:30:00`, not
-    // `01:30:00`. Excel auto-applies these when the user types a value with
-    // hours > 24.
-    FULL_ELAPSED: "[h]:mm:ss",
-    SHORT_ELAPSED: "[h]:mm",
+    // Excel "elapsed time" (Duration) pattern. The square brackets around `h`
+    // tell the formatter to display the full elapsed-hours count without
+    // wrapping at 24 — `[h]:mm:ss` renders a 25.5-hour duration as `25:30:00`,
+    // not `01:30:00`. Excel auto-applies it when the typed hours reach 24
+    // (`24:00` is one day, `25:00` a duration) and always shows the seconds, so
+    // a typed `25:00` displays `25:00:00` (rowsncolumns/spreadsheet#1027) —
+    // the same pattern the Number menu's "Duration" item applies.
+    ELAPSED: "[h]:mm:ss",
 };
+// Typed hours at or past a full day are a Duration, never a clock time.
+var ELAPSED_HOURS_MIN = 24;
 // Cap elapsed-time hours at Excel's documented limit (`9999:59:59`). Beyond
 // this, treat as text rather than producing absurdly large fractional
 // serials. JS `Number.isFinite` would let `Infinity` through, so we cap
@@ -60,12 +63,17 @@ export var validateDate = function (value, locale) {
     if (year < EXCEL_DATE_MIN_YEAR || year > EXCEL_DATE_MAX_YEAR) {
         return undefined;
     }
+    // Excel's phantom 1900-02-29 (serial 60): the parser hands back a stand-in
+    // `Date` on the 28th with `excelLeapDay` set, because no `Date` can hold the
+    // 29th. Report the day the user typed; `toSerialFromParts` maps it to 60
+    // (rowsncolumns/spreadsheet#1026).
+    var day = "excelLeapDay" in result && result.excelLeapDay ? 29 : dateValue.getDate();
     return {
         format: result.pattern,
         parts: {
             year: year,
             month: dateValue.getMonth(),
-            day: dateValue.getDate(),
+            day: day,
             hour: dateValue.getHours(),
             minute: dateValue.getMinutes(),
             second: dateValue.getSeconds(),
@@ -94,10 +102,10 @@ export var validateDateTime = function (value) {
         var minute = parseInt(match[2], 10);
         var second = parseInt(match[3], 10);
         if (isValidTimeComponents(hour, minute, second)) {
-            // Excel parity: hour > 24 is an elapsed-time entry (e.g. `25:30:00`,
-            // `48:00:00`). Auto-apply `[h]:mm:ss` so the cell displays the full
-            // hours count instead of wrapping to `01:30:00`.
-            var format = hour > 24 ? TIME_FORMATS.FULL_ELAPSED : TIME_FORMATS.FULL;
+            // Excel parity: hours >= 24 are an elapsed-time entry (`24:00:00`,
+            // `25:30:00`, `48:00:00`). Auto-apply `[h]:mm:ss` so the cell displays
+            // the full hours count instead of wrapping to `01:30:00`.
+            var format = hour >= ELAPSED_HOURS_MIN ? TIME_FORMATS.ELAPSED : TIME_FORMATS.FULL;
             return createTimeResult(format, hour, minute, second);
         }
     }
@@ -115,8 +123,9 @@ export var validateDateTime = function (value) {
         var hour = parseInt(match[1], 10);
         var minute = parseInt(match[2], 10);
         if (isValidTimeComponents(hour, minute, 0)) {
-            // Same elapsed-time auto-pattern logic as the full form above.
-            var format = hour > 24 ? TIME_FORMATS.SHORT_ELAPSED : TIME_FORMATS.SHORT;
+            // Same elapsed-time rule as the full form: a duration typed without
+            // seconds still gets `[h]:mm:ss` (`25:00` → `25:00:00`, as Excel).
+            var format = hour >= ELAPSED_HOURS_MIN ? TIME_FORMATS.ELAPSED : TIME_FORMATS.SHORT;
             return createTimeResult(format, hour, minute, 0);
         }
     }

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

@@ -1,6 +1,16 @@
 export declare const pattern_number = "#";
 export declare const pattern_number_thousands = "#,##0";
 export declare const getDecimalPlaces: (value: string | number, locale?: string) => number;
+/**
+ * Whether a typed literal groups its integer part with the locale's thousands
+ * separator (`1,000` / `1,234.56` in en-US, `1.234,56` in de-DE, `1 234` in
+ * fr-FR). In a comma-decimal locale a canonical dot-decimal string (`1.234`)
+ * is ambiguous — the programmatic decimal 1.234, or the grouped 1234 — so when
+ * the caller knows what the literal parsed to (`parsedValue`) that decides;
+ * without it the canonical reading wins, so the locale's `.` group separator
+ * is not mistaken for grouping. Rust `has_thousands_grouping`.
+ */
+export declare const hasThousandsGrouping: (value: string | number, locale?: string, parsedValue?: number) => boolean;
 export declare const detectDecimalPattern: (value: string | number | boolean | Date | undefined, defaultPattern?: string, locale?: string) => string;
 export declare const changeDecimals: (pattern?: string | undefined, changeBy?: number, delta?: boolean) => string;
 export declare const getCurrentDecimalCountInPattern: (pattern?: string | undefined | null) => number;

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

@@ -1 +1 @@
-{"version":3,"file":"decimals.d.ts","sourceRoot":"","sources":["../../../api/decimals.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAyDhD,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,GAAG,MAAM,EACtB,SAAS,MAAM,KACd,MAsCF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,uBAA+B,EAC/B,SAAS,MAAM,WAkChB,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,UAAS,MAAM,GAAG,SAAc,EAChC,WAAU,MAAU,EACpB,eAAY,WAuCb,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,UAAS,MAAM,GAAG,SAAS,GAAG,IAAS,WAexC,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,UAAS,MAAM,GAAG,SAAc,WAwBpE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,UAAS,MAAM,GAAG,SAAc,WAQvE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,UAAS,MAAM,GAAG,SAAc,YAIrE,CAAC"}
+{"version":3,"file":"decimals.d.ts","sourceRoot":"","sources":["../../../api/decimals.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAyDhD,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,GAAG,MAAM,EACtB,SAAS,MAAM,KACd,MAsCF,CAAC;AAcF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,GAAG,MAAM,EACtB,SAAS,MAAM,EACf,cAAc,MAAM,KACnB,OAeF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,uBAA+B,EAC/B,SAAS,MAAM,WAsBhB,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,UAAS,MAAM,GAAG,SAAc,EAChC,WAAU,MAAU,EACpB,eAAY,WAuCb,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,UAAS,MAAM,GAAG,SAAS,GAAG,IAAS,WAexC,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,UAAS,MAAM,GAAG,SAAc,WAwBpE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,UAAS,MAAM,GAAG,SAAc,WAQvE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,UAAS,MAAM,GAAG,SAAc,YAIrE,CAAC"}

package/dist/cjs/api/decimals.js

@@ -76,20 +76,43 @@ export var getDecimalPlaces = function (value, locale) {
     // Return the length of the decimal part
     return decimalPart.length;
 };
-export var detectDecimalPattern = function (value, defaultPattern, locale) {
-    if (defaultPattern === void 0) { defaultPattern = pattern_number; }
-    var str = typeof value === "number" ? normalizeFloatingPointString(value) : String(value);
+var WHITESPACE_GROUP_REGEX = /[\s\u00A0\u202F]/;
+/**
+ * Whether `integerPart` contains the locale's group separator. Locales that
+ * group with a space accept the whole whitespace family (regular, no-break,
+ * narrow no-break) — users type a plain space for fr-FR's `\u202F`.
+ */
+var integerPartHasGroup = function (integerPart, group) {
+    return group.trim() === ""
+        ? WHITESPACE_GROUP_REGEX.test(integerPart)
+        : integerPart.includes(group);
+};
+/**
+ * Whether a typed literal groups its integer part with the locale's thousands
+ * separator (`1,000` / `1,234.56` in en-US, `1.234,56` in de-DE, `1 234` in
+ * fr-FR). In a comma-decimal locale a canonical dot-decimal string (`1.234`)
+ * is ambiguous — the programmatic decimal 1.234, or the grouped 1234 — so when
+ * the caller knows what the literal parsed to (`parsedValue`) that decides;
+ * without it the canonical reading wins, so the locale's `.` group separator
+ * is not mistaken for grouping. Rust `has_thousands_grouping`.
+ */
+export var hasThousandsGrouping = function (value, locale, parsedValue) {
+    var str = typeof value === "number" ? normalizeFloatingPointString(value) : value;
     var _a = getLocaleSeparators(locale), decimal = _a.decimal, group = _a.group;
     var groupSeparator = group !== null && group !== void 0 ? group : ",";
     var decimalSeparator = decimal !== null && decimal !== void 0 ? decimal : ".";
-    var usesCanonicalDotDecimal = decimalSeparator !== "." && CANONICAL_DOT_DECIMAL_REGEX.test(str);
-    var effectiveDecimalSeparator = usesCanonicalDotDecimal
-        ? "."
-        : decimalSeparator;
-    var integerPart = effectiveDecimalSeparator
-        ? str.split(effectiveDecimalSeparator)[0]
-        : str;
-    var hasThousands = Boolean(groupSeparator) && integerPart.includes(groupSeparator);
+    if (decimalSeparator !== "." && CANONICAL_DOT_DECIMAL_REGEX.test(str)) {
+        return (parsedValue !== undefined &&
+            Number(str) !== parsedValue &&
+            integerPartHasGroup(str, groupSeparator));
+    }
+    var integerPart = str.split(decimalSeparator)[0];
+    return Boolean(groupSeparator) && integerPartHasGroup(integerPart, groupSeparator);
+};
+export var detectDecimalPattern = function (value, defaultPattern, locale) {
+    if (defaultPattern === void 0) { defaultPattern = pattern_number; }
+    var str = typeof value === "number" ? normalizeFloatingPointString(value) : String(value);
+    var hasThousands = hasThousandsGrouping(str, locale);
     var decimalsLen = getDecimalPlaces(value, locale);
     // Use "0" pattern for numbers less than 1 to ensure leading zero
     var numValue = Number(str.replace(/[^0-9.-]/g, ""));