@rowsncolumns/utils 9.2.39 → 9.2.41

package/dist/cjs/cell-data-helpers.d.ts

@@ -31,6 +31,19 @@ export declare const getExtendedValueError: (extValue?: Record<string, any> | nu
  * `getDefaultHorizontalAlignment(sheetId, rowIndex, columnIndex)` so a toolbar
  * alignment selector reports the alignment the grid actually draws.
  */
+/**
+ * Excel's `justify` and `distributed` alignments imply word wrap: the cell
+ * wraps inside its own width even without `wrapStrategy: "wrap"` (there is
+ * nothing to spread across otherwise) and the row auto-fits the wrapped
+ * lines. Shared by the canvas renderer (wrap + overflow decision) and the
+ * state hooks' row auto-height so both agree on which cells wrap.
+ */
+export declare const alignmentImpliesWrap: (align: HorizontalAlign | string | null | undefined) => boolean;
+/**
+ * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ */
+export declare const cellFormatWrapsText: (format: Pick<CellFormat, "wrapStrategy" | "horizontalAlignment"> | null | undefined) => boolean;
 export declare const resolveDefaultHorizontalAlignment: ({ errorValue, userEnteredValue, effectiveValue, dataValidation, }: {
     errorValue: unknown;
     userEnteredValue: Record<string, any> | null | undefined;

package/dist/cjs/cell-data-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cell-data-helpers.d.ts","sourceRoot":"","sources":["../../cell-data-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,EACxD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,QAAQ,EACzD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EACvD,OAAO,CAAC,GAAG,IAAI,KACd,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAEvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,MAAM,GAAG,SAAS,GAAG,IAEvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAE1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,OAAO,GAAG,SAEZ,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,GAAG,GAAG,SAER,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iCAAiC,GAAI,mEAK/C;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,cAAc,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1E,KAAG,eAAe,GAAG,SASrB,CAAC"}
+{"version":3,"file":"cell-data-helpers.d.ts","sourceRoot":"","sources":["../../cell-data-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,EACxD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,QAAQ,EACzD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EACvD,OAAO,CAAC,GAAG,IAAI,KACd,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAEvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,MAAM,GAAG,SAAS,GAAG,IAEvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAE1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,OAAO,GAAG,SAEZ,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,GAAG,GAAG,SAER,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KACjD,OAAyD,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QACI,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,qBAAqB,CAAC,GACxD,IAAI,GACJ,SAAS,KACZ,OAEgD,CAAC;AAEpD,eAAO,MAAM,iCAAiC,GAAI,mEAK/C;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,cAAc,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1E,KAAG,eAAe,GAAG,SASrB,CAAC"}

package/dist/cjs/cell-data-helpers.js

@@ -6,7 +6,7 @@
  * Note: These functions use generic types to avoid circular dependencies
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveDefaultHorizontalAlignment = exports.getExtendedValueError = exports.getExtendedValueFormula = exports.getExtendedValueBool = exports.getExtendedValueString = exports.getExtendedValueNumber = exports.getStyleId = exports.getCellFormattedValue = exports.getCellEffectiveFormat = exports.getCellUserEnteredFormat = exports.getCellEffectiveValue = exports.getCellUserEnteredValue = void 0;
+exports.resolveDefaultHorizontalAlignment = exports.cellFormatWrapsText = exports.alignmentImpliesWrap = exports.getExtendedValueError = exports.getExtendedValueFormula = exports.getExtendedValueBool = exports.getExtendedValueString = exports.getExtendedValueNumber = exports.getStyleId = exports.getCellFormattedValue = exports.getCellEffectiveFormat = exports.getCellUserEnteredFormat = exports.getCellEffectiveValue = exports.getCellUserEnteredValue = void 0;
 var getCellUserEnteredValue = function (cell) {
     var _a;
     return (_a = cell === null || cell === void 0 ? void 0 : cell.ue) !== null && _a !== void 0 ? _a : cell === null || cell === void 0 ? void 0 : cell.userEnteredValue;
@@ -77,6 +77,24 @@ exports.getExtendedValueError = getExtendedValueError;
  * `getDefaultHorizontalAlignment(sheetId, rowIndex, columnIndex)` so a toolbar
  * alignment selector reports the alignment the grid actually draws.
  */
+/**
+ * Excel's `justify` and `distributed` alignments imply word wrap: the cell
+ * wraps inside its own width even without `wrapStrategy: "wrap"` (there is
+ * nothing to spread across otherwise) and the row auto-fits the wrapped
+ * lines. Shared by the canvas renderer (wrap + overflow decision) and the
+ * state hooks' row auto-height so both agree on which cells wrap.
+ */
+var alignmentImpliesWrap = function (align) { return align === "justify" || align === "distributed"; };
+exports.alignmentImpliesWrap = alignmentImpliesWrap;
+/**
+ * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ */
+var cellFormatWrapsText = function (format) {
+    return (format === null || format === void 0 ? void 0 : format.wrapStrategy) === "wrap" ||
+        (0, exports.alignmentImpliesWrap)(format === null || format === void 0 ? void 0 : format.horizontalAlignment);
+};
+exports.cellFormatWrapsText = cellFormatWrapsText;
 var resolveDefaultHorizontalAlignment = function (_a) {
     var _b;
     var errorValue = _a.errorValue, userEnteredValue = _a.userEnteredValue, effectiveValue = _a.effectiveValue, dataValidation = _a.dataValidation;

package/dist/cjs/excel-number-format.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Excel-parity pre-pass for number formatting.
+ *
+ * `numfmt` renders the bulk of Excel's format language, but it decides three
+ * things from the binary double where Excel decides them from the number's
+ * 15-significant-digit decimal representation:
+ *
+ *  - rounding to a fixed number of decimals (`0.00` of `1.005` is `1.01`, not
+ *    the `1.00` the double `1.00499999999999989…` rounds to);
+ *  - `General`, which switches to scientific notation below 1E-4 and above
+ *    11 digits and rounds (never truncates) the 11th digit;
+ *  - magnitudes ≥ 1E15, where Excel pads the 15 significant digits with
+ *    zeros (`0.00` of `1E21` is `1000000000000000000000.00`).
+ *
+ * It also renders a date/time format for a serial outside Excel's calendar
+ * (negative, or ≥ 10000-01-01) as `#######`, as Excel does in the cell.
+ *
+ * Everything here works on the pattern's SECTION the value selects, so
+ * multi-section formats (`0.00;(0.00);"-"`) keep their Excel section rules.
+ * A format with `[>100]`-style conditions is resolved here too — which
+ * section matches, and whether the value's sign is shown — so the matched
+ * section gets the same decimal rules; the library then renders that one
+ * section on its own.
+ */
+/**
+ * What Excel shows when a value cannot be rendered by its format: a
+ * date/time outside the calendar, or a number no conditional section takes.
+ */
+export declare const DATE_OVERFLOW_DISPLAY = "#######";
+export type FormatSectionKind = "general" | "empty" | "number" | "date" | "text" | "other";
+export type FormatConditionOperator = "<" | "<=" | ">" | ">=" | "=" | "<>";
+/** A `[>100]`-style section condition. */
+export interface FormatCondition {
+    op: FormatConditionOperator;
+    operand: number;
+}
+export interface FormatSectionInfo {
+    kind: FormatSectionKind;
+    /** The section body with color / locale / condition tokens removed. */
+    body: string;
+    /** `[>100]`-style condition on this section. */
+    hasCondition: boolean;
+    condition?: FormatCondition;
+    /** Elapsed-time token (`[h]`, `[mm]`, `[s]`) — negative values are legal. */
+    isElapsed: boolean;
+    /** Literal text before a `General` token (`-General` → `"-"`). */
+    generalPrefix: string;
+    /** Digit placeholders after the decimal point. */
+    decimals: number;
+    /** Number of `%` signs (each scales by 100). */
+    percent: number;
+    /** Trailing scaling commas (each divides by 1000). */
+    commaScale: number;
+    /** A grouping comma between digit placeholders. */
+    grouping: boolean;
+    /** Only placeholders / separators — safe to render without the library. */
+    isPlainNumber: boolean;
+    /**
+     * Digit placeholders outside a fraction: a `-` prefixed to this section is
+     * dropped when every digit it renders is zero (`0.00` of -0.001 → `0.00`).
+     */
+    volatileSign: boolean;
+}
+/**
+ * Split a format code into its `;` sections, honouring quotes, bracket
+ * tokens and backslash escapes.
+ */
+export declare const splitFormatSections: (code: string) => string[];
+/** Classify one section of a format code. */
+export declare const analyzeFormatSection: (section: string) => FormatSectionInfo;
+/**
+ * Which section Excel applies to a numeric value: one section covers every
+ * number; two sections split positive-or-zero / negative; three add a zero
+ * section. Returns the index and whether the section's sign is implicit.
+ */
+export declare const pickNumberSection: (sectionCount: number, value: number) => {
+    index: number;
+    implicitSign: boolean;
+};
+export interface ResolvedConditionalSection {
+    index: number;
+    /** The implicit `General` fallback Excel adds to a one-section conditional format. */
+    generated: boolean;
+    /** A negative value's rendering is prefixed with `-`. */
+    minus: boolean;
+}
+/**
+ * Excel's section selection for a format with `[>100]`-style conditions:
+ * the first of the (up to three) numeric sections whose condition holds —
+ * an unconditional section always holds — or `undefined` when none does.
+ * `conditions[i]` is section i's condition (or `undefined`).
+ */
+export declare const resolveConditionalSection: (conditions: readonly (FormatCondition | undefined)[], value: number) => ResolvedConditionalSection | undefined;
+/** Remove the `[>100]`-style condition tokens from one section. */
+export declare const stripConditionTokens: (section: string) => string;
+/**
+ * Round |x|·10^shift half away from zero to `decimals` places using its
+ * 15-significant-digit decimal representation, and return the rounded value
+ * scaled back (÷10^shift). Returns `x` unchanged when no digit is dropped.
+ */
+export declare const roundDecimal15: (x: number, decimals: number, shift?: number) => number;
+/** Excel `General` for a finite number, using `.`/`E` (caller localizes). */
+export declare const excelGeneral: (value: number) => string;
+/**
+ * Digits of |x| for |x| ≥ 1E15 as Excel shows them: the 15 significant
+ * digits followed by zeros (Excel stores nothing beyond 15 digits).
+ */
+export declare const hugeIntegerDigits: (x: number) => string;
+export declare const groupDigits: (digits: string, separator: string) => string;
+export interface ExcelPrePassResult {
+    /** A final rendering; the library is not consulted. */
+    text?: string;
+    /** The (possibly pre-rounded) value to hand to the library. */
+    value: number;
+}
+export interface ExcelPrePassLocale {
+    decimal: string;
+    group: string;
+}
+/** Renders one section of a format code with the formatting library. */
+export type RenderFormatSection = (code: string, value: number) => string;
+/**
+ * Apply Excel's decimal rules before handing a numeric value to `numfmt`.
+ * `render` formats one section of the pattern with the library; it is used
+ * when the pre-pass has to resolve a conditional format itself.
+ */
+export declare const excelNumberPrePass: (pattern: string, value: number, l10n: ExcelPrePassLocale, render: RenderFormatSection) => ExcelPrePassResult;
+//# sourceMappingURL=excel-number-format.d.ts.map

package/dist/cjs/excel-number-format.d.ts.map

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