@rowsncolumns/toolkit 24.4.1

package/LICENSE.md

@@ -0,0 +1,100 @@
+# Rows n' Columns Commercial License Agreement
+
+This Rows n' Columns Commercial License Agreement (the "Agreement") governs
+the use of the Rows n' Columns software packages published under the
+`@rowsncolumns` npm scope, including associated JavaScript, WebAssembly
+binaries, stylesheets, type definitions and documentation (the "Software").
+
+The Software is **not** open source. Downloading or installing the Software
+from a public package registry does not grant any right to use it beyond the
+evaluation use described below.
+
+## 1. Definitions
+
+- **"Licensor"** means Rows n' Columns (rowsncolumns.app).
+- **"Licensee"** means the individual or legal entity identified in an Order.
+- **"Order"** means a purchase of a license for the Software from Licensor,
+  identified by an order ID and associated with a License Key.
+- **"License Key"** means the signed key issued by Licensor that identifies
+  the Licensee, license tier, and Update Window.
+- **"Update Window"** means the period stated in the Order during which
+  Software versions released by Licensor are covered by the License Key.
+
+## 2. License Grant
+
+Subject to payment of the applicable fees and compliance with this Agreement,
+Licensor grants Licensee a non-exclusive, non-transferable, worldwide license
+to use, and to distribute in compiled form as an embedded component of
+Licensee's own applications, any version of the Software released during the
+Update Window, in accordance with the license tier stated in the Order.
+
+This grant is perpetual for versions released during the Update Window:
+Licensee may continue to use those versions after the Update Window ends.
+Versions released after the Update Window ends require a new or renewed
+Order.
+
+## 3. Evaluation Use
+
+The Software may be used without a License Key solely for internal
+evaluation and development purposes. Evaluation use in production, or
+removal or suppression of evaluation notices, is not permitted.
+
+## 4. Restrictions
+
+Except as expressly permitted by this Agreement or by applicable law that
+cannot be contractually waived, Licensee shall not:
+
+1. redistribute, resell, sublicense, or otherwise make the Software
+   available as a standalone product, library, or development component;
+2. use the Software to build a product that competes with the Software;
+3. remove, alter, or circumvent License Key validation, evaluation notices,
+   watermarks, or copyright notices in the Software;
+4. share License Keys with any third party, or use a License Key outside
+   the scope of the tier stated in the Order;
+5. reverse engineer, decompile, or disassemble the Software except to the
+   extent permitted by applicable law.
+
+## 5. Ownership
+
+The Software is licensed, not sold. Licensor and its licensors retain all
+right, title, and interest in and to the Software, including all
+intellectual property rights.
+
+## 6. Third-Party Components
+
+The Software may include third-party open-source components. Those
+components remain governed by their own license terms, which are included
+with the applicable component and are not limited by this Agreement.
+
+## 7. Termination
+
+This Agreement terminates automatically upon material breach by Licensee
+that remains uncured 30 days after written notice. Upon termination,
+Licensee must cease use and distribution of the Software, except that
+end-user copies of Licensee applications already distributed in compliance
+with this Agreement are unaffected.
+
+## 8. Warranty Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+## 9. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL LICENSOR BE LIABLE
+FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES,
+OR ANY LOSS OF PROFITS, DATA, OR GOODWILL, ARISING OUT OF OR RELATED TO THIS
+AGREEMENT, AND LICENSOR'S AGGREGATE LIABILITY SHALL NOT EXCEED THE FEES PAID
+BY LICENSEE IN THE TWELVE MONTHS PRECEDING THE CLAIM.
+
+## 10. General
+
+This Agreement constitutes the entire agreement between the parties
+concerning the Software and supersedes any prior agreements. If any
+provision is held unenforceable, the remainder remains in effect. Failure to
+enforce a provision is not a waiver.
+
+For licensing inquiries, visit <https://www.rowsncolumns.app/pricing>.
+
+Copyright © Rows n' Columns. All rights reserved.

package/Readme.md

@@ -0,0 +1,27 @@
+# Excel import/export toolkit
+
+## Reading Excel file from NodeJS
+
+```typescript
+import { Workbook, getSheets, getCharts, processSheetData } from "@rowsncolumns/toolkit"
+
+
+const workbook = new Workbook()
+
+// Load the excel file to workbook
+await workbook.load(file)
+
+const [sheets, tables, dataValidations] = await getSheets(workbook)
+
+// SheetData 
+
+for await (const result of processSheetData(workbook,e.data.pageSize)) {
+  // Process result
+}
+
+// Charts
+const charts = await getCharts(workbook);
+
+// Cleanup
+workbook.dispose();
+```

package/dist/cjs/autofilter-condition.d.ts

@@ -0,0 +1,43 @@
+import type { ConditionType } from "@rowsncolumns/common-types";
+/**
+ * Bidirectional mapping between the in-app AutoFilter `filterCriteria.condition`
+ * ({type, values}) and Excel's `<customFilters>` / `<dynamicFilter>` XML.
+ *
+ * Excel autoFilter supports three condition shapes (besides value-list /
+ * color / icon): customFilter comparisons (number/text/date), two-filter
+ * AND/OR ranges (between / not-between), and dynamicFilter (relative dates +
+ * above/below average). This module keeps export and import symmetric so a
+ * condition filter survives an XLSX round-trip (previously dropped both ways).
+ *
+ * Round-trip fidelity note: Excel's customFilter has no number-vs-date tag, so
+ * date comparison filters re-import as the NUMBER_* equivalent. The comparison
+ * itself (>, <, between, …) — and therefore which rows stay visible — is
+ * preserved, which is the point.
+ */
+type ConditionValue = {
+    userEnteredValue: string;
+};
+export type AutoFilterCondition = {
+    type: ConditionType;
+    values: ConditionValue[];
+};
+export type RawCustomFilter = {
+    operator?: string;
+    val?: string;
+};
+/**
+ * Build the `<customFilters>` / `<dynamicFilter>` XML for a filter condition,
+ * or `null` when the condition type has no AutoFilter representation (BLANK /
+ * ERROR / CUSTOM_FORMULA / ONE_OF_* / DATE_LAST_7_DAYS / …) — the caller then
+ * falls back to a value-list `<filters>`.
+ */
+export declare const buildAutoFilterConditionXml: (condition: {
+    type?: ConditionType | null;
+    values?: ConditionValue[] | null;
+} | null | undefined) => string | null;
+/** Map an Excel `<dynamicFilter type=…>` back to a condition, or null. */
+export declare const dynamicFilterToCondition: (type: string | undefined) => AutoFilterCondition | null;
+/** Map Excel `<customFilters>` children back to a condition, or null. */
+export declare const customFiltersToCondition: (filters: RawCustomFilter[], and: boolean) => AutoFilterCondition | null;
+export {};
+//# sourceMappingURL=autofilter-condition.d.ts.map

package/dist/cjs/autofilter-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofilter-condition.d.ts","sourceRoot":"","sources":["../../autofilter-condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AAEH,KAAK,cAAc,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAmElE;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW;IAAE,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KAC9F,MAAM,GAAG,IA4BX,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,GACnC,MAAM,MAAM,GAAG,SAAS,KACvB,mBAAmB,GAAG,IAIxB,CAAC;AAIF,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,GACnC,SAAS,eAAe,EAAE,EAC1B,KAAK,OAAO,KACX,mBAAmB,GAAG,IA6CxB,CAAC"}

package/dist/cjs/autofilter-condition.js

@@ -0,0 +1,155 @@
+import { __read } from "tslib";
+var escapeXml = function (value) {
+    return String(value)
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+};
+// condition type -> Excel dynamicFilter `type` attribute
+var DYNAMIC_BY_TYPE = {
+    DATE_TODAY: "today",
+    DATE_YESTERDAY: "yesterday",
+    DATE_TOMORROW: "tomorrow",
+    DATE_THIS_WEEK: "thisWeek",
+    DATE_LAST_WEEK: "lastWeek",
+    DATE_NEXT_WEEK: "nextWeek",
+    DATE_THIS_MONTH: "thisMonth",
+    DATE_LAST_MONTH: "lastMonth",
+    DATE_NEXT_MONTH: "nextMonth",
+    NUMBER_ABOVE_AVERAGE: "aboveAverage",
+    NUMBER_BELOW_AVERAGE: "belowAverage",
+};
+var TYPE_BY_DYNAMIC = Object.fromEntries(Object.entries(DYNAMIC_BY_TYPE).map(function (_a) {
+    var _b = __read(_a, 2), k = _b[0], v = _b[1];
+    return [v, k];
+}));
+// condition type -> single customFilter operator (number + date comparisons)
+var OPERATOR_BY_TYPE = {
+    NUMBER_GREATER: "greaterThan",
+    DATE_AFTER: "greaterThan",
+    NUMBER_GREATER_THAN_EQ: "greaterThanOrEqual",
+    DATE_ON_OR_AFTER: "greaterThanOrEqual",
+    NUMBER_LESS: "lessThan",
+    DATE_BEFORE: "lessThan",
+    NUMBER_LESS_THAN_EQ: "lessThanOrEqual",
+    DATE_ON_OR_BEFORE: "lessThanOrEqual",
+    NUMBER_EQ: "equal",
+    DATE_EQ: "equal",
+    NUMBER_NOT_EQ: "notEqual",
+    DATE_NOT_EQ: "notEqual",
+};
+var TYPE_BY_OPERATOR = {
+    greaterThan: "NUMBER_GREATER",
+    greaterThanOrEqual: "NUMBER_GREATER_THAN_EQ",
+    lessThan: "NUMBER_LESS",
+    lessThanOrEqual: "NUMBER_LESS_THAN_EQ",
+    equal: "NUMBER_EQ",
+    notEqual: "NUMBER_NOT_EQ",
+};
+// text condition type -> {operator, how to wrap the value with wildcards}
+var TEXT_WRAP = {
+    TEXT_EQ: { op: "equal", wrap: function (v) { return v; } },
+    TEXT_NOT_EQ: { op: "notEqual", wrap: function (v) { return v; } },
+    TEXT_CONTAINS: { op: "equal", wrap: function (v) { return "*".concat(v, "*"); } },
+    TEXT_NOT_CONTAINS: { op: "notEqual", wrap: function (v) { return "*".concat(v, "*"); } },
+    TEXT_STARTS_WITH: { op: "equal", wrap: function (v) { return "".concat(v, "*"); } },
+    TEXT_ENDS_WITH: { op: "equal", wrap: function (v) { return "*".concat(v); } },
+};
+var customFilterXml = function (operator, val) {
+    return "<customFilter operator=\"".concat(operator, "\" val=\"").concat(escapeXml(val), "\"/>");
+};
+/**
+ * Build the `<customFilters>` / `<dynamicFilter>` XML for a filter condition,
+ * or `null` when the condition type has no AutoFilter representation (BLANK /
+ * ERROR / CUSTOM_FORMULA / ONE_OF_* / DATE_LAST_7_DAYS / …) — the caller then
+ * falls back to a value-list `<filters>`.
+ */
+export var buildAutoFilterConditionXml = function (condition) {
+    var _a, _b, _c;
+    var type = condition === null || condition === void 0 ? void 0 : condition.type;
+    if (!type)
+        return null;
+    var values = (_a = condition === null || condition === void 0 ? void 0 : condition.values) !== null && _a !== void 0 ? _a : [];
+    var v0 = (_b = values[0]) === null || _b === void 0 ? void 0 : _b.userEnteredValue;
+    var v1 = (_c = values[1]) === null || _c === void 0 ? void 0 : _c.userEnteredValue;
+    var dynamic = DYNAMIC_BY_TYPE[type];
+    if (dynamic)
+        return "<dynamicFilter type=\"".concat(dynamic, "\"/>");
+    if (type === "NUMBER_BETWEEN" || type === "DATE_BETWEEN") {
+        if (v0 == null || v1 == null)
+            return null;
+        return "<customFilters and=\"1\">".concat(customFilterXml("greaterThanOrEqual", v0)).concat(customFilterXml("lessThanOrEqual", v1), "</customFilters>");
+    }
+    if (type === "NUMBER_NOT_BETWEEN" || type === "DATE_NOT_BETWEEN") {
+        if (v0 == null || v1 == null)
+            return null;
+        return "<customFilters>".concat(customFilterXml("lessThan", v0)).concat(customFilterXml("greaterThan", v1), "</customFilters>");
+    }
+    var op = OPERATOR_BY_TYPE[type];
+    if (op && v0 != null) {
+        return "<customFilters>".concat(customFilterXml(op, v0), "</customFilters>");
+    }
+    var text = TEXT_WRAP[type];
+    if (text && v0 != null) {
+        return "<customFilters>".concat(customFilterXml(text.op, text.wrap(v0)), "</customFilters>");
+    }
+    return null;
+};
+/** Map an Excel `<dynamicFilter type=…>` back to a condition, or null. */
+export var dynamicFilterToCondition = function (type) {
+    if (!type)
+        return null;
+    var conditionType = TYPE_BY_DYNAMIC[type];
+    return conditionType ? { type: conditionType, values: [] } : null;
+};
+var isNumeric = function (v) { return v !== "" && !Number.isNaN(Number(v)); };
+/** Map Excel `<customFilters>` children back to a condition, or null. */
+export var customFiltersToCondition = function (filters, and) {
+    var _a, _b, _c, _d;
+    var valid = filters.filter(function (f) { return f && f.val !== undefined; });
+    if (valid.length === 0)
+        return null;
+    // Two filters => a range (between when AND, not-between when OR).
+    if (valid.length >= 2) {
+        var v0 = String((_a = valid[0].val) !== null && _a !== void 0 ? _a : "");
+        var v1 = String((_b = valid[1].val) !== null && _b !== void 0 ? _b : "");
+        return {
+            type: and ? "NUMBER_BETWEEN" : "NUMBER_NOT_BETWEEN",
+            values: [{ userEnteredValue: v0 }, { userEnteredValue: v1 }],
+        };
+    }
+    var operator = (_c = valid[0].operator) !== null && _c !== void 0 ? _c : "equal";
+    var val = String((_d = valid[0].val) !== null && _d !== void 0 ? _d : "");
+    // Text wildcards: equal/notEqual carrying * map back to contains/starts/ends.
+    if ((operator === "equal" || operator === "notEqual") && /[*?]/.test(val)) {
+        var negated = operator === "notEqual";
+        var lead = val.startsWith("*");
+        var trail = val.endsWith("*");
+        var core = val.replace(/^\*/, "").replace(/\*$/, "");
+        if (lead && trail) {
+            return {
+                type: negated ? "TEXT_NOT_CONTAINS" : "TEXT_CONTAINS",
+                values: [{ userEnteredValue: core }],
+            };
+        }
+        if (trail) {
+            return { type: "TEXT_STARTS_WITH", values: [{ userEnteredValue: core }] };
+        }
+        if (lead) {
+            return { type: "TEXT_ENDS_WITH", values: [{ userEnteredValue: core }] };
+        }
+    }
+    var conditionType = TYPE_BY_OPERATOR[operator];
+    if (!conditionType)
+        return null;
+    // A non-numeric equal/notEqual is a text equality, not a numeric one.
+    if (!isNumeric(val)) {
+        if (operator === "equal")
+            conditionType = "TEXT_EQ";
+        else if (operator === "notEqual")
+            conditionType = "TEXT_NOT_EQ";
+    }
+    return { type: conditionType, values: [{ userEnteredValue: val }] };
+};

package/dist/cjs/csv-export.d.ts

@@ -0,0 +1,49 @@
+import type { CellData, Sheet } from "@rowsncolumns/spreadsheet";
+import type { RowData, RowDataWithValue } from "@rowsncolumns/common-types";
+import { type SharedStrings } from "@rowsncolumns/spreadsheet-state";
+type ExportCSVProps<T extends CellData | null> = {
+    rowData: (RowData<T | null> | RowDataWithValue<T | null> | null)[];
+    sharedStrings?: SharedStrings;
+    config?: {
+        delimiter?: string;
+        /**
+         * Prepend a UTF-8 byte-order mark to the exported file. Output is
+         * always UTF-8; the BOM only helps Excel detect the encoding when
+         * double-clicking a .csv (otherwise it assumes the ANSI codepage).
+         */
+        includeBom?: boolean;
+        skipEmptyLines?: boolean;
+        header?: boolean;
+    };
+    /**
+     * Optional context for deriving formatted values on formula cells that
+     * don't carry a persisted `fv` (the new contract for formula cells).
+     * When provided, formula cells with no `fv` get their value formatted
+     * using the precedent-derived number format (same logic as the renderer
+     * uses).
+     */
+    derivationContext?: {
+        sheetId: number;
+        sheetData: Record<string | number, any>;
+        sheets?: Sheet[];
+        locale?: string;
+        /**
+         * Map of styleId -> CellFormat. Required when precedent cells'
+         * `uf` is a `{ sid }` style reference (xlsx-imported workbooks),
+         * otherwise the derive helper can't resolve the styleId.
+         */
+        cellXfs?: Map<string | number, any> | null;
+    };
+};
+/**
+ * Create csv string from sheetData using XLSX
+ * @param rowData
+ * @param config
+ * @returns
+ */
+export declare const createCSVFromSheetData: <T extends CellData | null>(rowData: ExportCSVProps<T>["rowData"], sharedStrings?: ExportCSVProps<T>["sharedStrings"], config?: ExportCSVProps<T>["config"], derivationContext?: ExportCSVProps<T>["derivationContext"]) => string;
+export declare const exportToCSV: <T extends CellData | null>({ filename, rowData, sharedStrings, config, derivationContext, }: ExportCSVProps<T> & {
+    filename: string;
+}) => string | Blob | undefined;
+export {};
+//# sourceMappingURL=csv-export.d.ts.map

package/dist/cjs/csv-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-export.d.ts","sourceRoot":"","sources":["../../csv-export.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAgB,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAoBzC,KAAK,cAAc,CAAC,CAAC,SAAS,QAAQ,GAAG,IAAI,IAAI;IAC/C,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IACnE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB;;;;WAIG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;;WAIG;QACH,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;KAC5C,CAAC;CACH,CAAC;AAgHF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,GAAG,IAAI,EAC9D,SAAS,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EACrC,gBAAgB,cAAc,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,EAClD,SAAS,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACpC,oBAAoB,cAAc,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAgD3D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,QAAQ,GAAG,IAAI,EAAE,kEAMpD,cAAc,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,8BAU1C,CAAC"}

package/dist/cjs/csv-export.js

@@ -0,0 +1,142 @@
+import { __values } from "tslib";
+import { tokenize as defaultTokenizer } from "@rowsncolumns/calculator";
+import { CellXfsRegistry, deriveEffectiveNumberFormatFromFormula, createFormattedValue, detectValueType, } from "@rowsncolumns/spreadsheet-state";
+import { getCellEffectiveValue, getCellFormattedValue, getCellUserEnteredFormat, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, isNil, } from "@rowsncolumns/utils";
+var isStyleRef = function (value) {
+    return !!value && typeof value === "object" && ("sid" in value);
+};
+import * as XLSX from "xlsx";
+import { isInvalidDataValidationError } from "./exporter/invalid-data-validation";
+import { createDownloadableFile } from "./helpers";
+var cellHasFormula = function (cell) {
+    if (!cell)
+        return false;
+    return !!getExtendedValueFormula(getCellUserEnteredValue(cell));
+};
+var resolveCellNumberFormat = function (cell) {
+    var _a;
+    if (!cell)
+        return undefined;
+    var uf = getCellUserEnteredFormat(cell);
+    if (!uf || isStyleRef(uf))
+        return undefined;
+    return (_a = uf.numberFormat) !== null && _a !== void 0 ? _a : undefined;
+};
+var deriveFormulaCellFv = function (cell, rowIndex, columnIndex, ctx) {
+    var e_1, _a;
+    var _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    var ev = getCellEffectiveValue(cell);
+    if (!ev)
+        return undefined;
+    var errorValue = ev.ev;
+    // The data-validation Invalid marker is UI-only — never render it as an
+    // error; fall through to the cell's real value below.
+    if (errorValue && !isInvalidDataValidationError(errorValue)) {
+        return (_b = errorValue.name) !== null && _b !== void 0 ? _b : "#ERROR!";
+    }
+    // Prefer uf.numberFormat; fall back to derivation from precedents.
+    var numberFormat = resolveCellNumberFormat(cell);
+    if (!numberFormat) {
+        var formula = getExtendedValueFormula(getCellUserEnteredValue(cell));
+        if (formula && ctx.sheetData) {
+            var sheetIdByName_1 = new Map();
+            try {
+                for (var _l = __values((_c = ctx.sheets) !== null && _c !== void 0 ? _c : []), _m = _l.next(); !_m.done; _m = _l.next()) {
+                    var s = _m.value;
+                    if (s === null || s === void 0 ? void 0 : s.title)
+                        sheetIdByName_1.set(s.title, s.sheetId);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (_m && !_m.done && (_a = _l.return)) _a.call(_l);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            // Real CellXfsRegistry so the helper can resolve precedent cells
+            // whose `uf` is a `{ sid }` style reference.
+            var cellXfsRegistry = ctx.cellXfs
+                ? new CellXfsRegistry(ctx.cellXfs)
+                : undefined;
+            numberFormat =
+                (_e = deriveEffectiveNumberFormatFromFormula(formula, ctx.sheetId, rowIndex, columnIndex, ctx.sheetData, function (input) { return defaultTokenizer(input); }, function (name) { var _a; return (_a = sheetIdByName_1.get(name)) !== null && _a !== void 0 ? _a : ctx.sheetId; }, ctx.locale, cellXfsRegistry, undefined, (_d = getExtendedValueNumber(ev)) !== null && _d !== void 0 ? _d : null)) !== null && _e !== void 0 ? _e : undefined;
+        }
+    }
+    var value = (_g = (_f = getExtendedValueNumber(ev)) !== null && _f !== void 0 ? _f : getExtendedValueString(ev)) !== null && _g !== void 0 ? _g : getExtendedValueBool(ev);
+    if (value == null)
+        return undefined;
+    var valueType = (_h = detectValueType(value, ctx.locale)) !== null && _h !== void 0 ? _h : "stringValue";
+    return ((_k = createFormattedValue(value, valueType, (_j = numberFormat === null || numberFormat === void 0 ? void 0 : numberFormat.pattern) !== null && _j !== void 0 ? _j : "General", ctx.locale)) !== null && _k !== void 0 ? _k : String(value));
+};
+var getCellFormattedValueInternal = function (cell, rowIndex, columnIndex, sharedStrings, derivationContext) {
+    var sharedStringIndex = cell === null || cell === void 0 ? void 0 : cell.ss;
+    var sharedStringValue = !isNil(sharedStringIndex) && sharedStrings
+        ? sharedStrings.get(String(sharedStringIndex))
+        : undefined;
+    if (sharedStringValue != null) {
+        // Rich shared-string entries (`{ text, runs }`) collapse to their
+        // plain text in CSV — formatting can't survive the format anyway.
+        return typeof sharedStringValue === "string"
+            ? sharedStringValue
+            : sharedStringValue.text;
+    }
+    var formattedValue = getCellFormattedValue(cell);
+    if (formattedValue != null) {
+        return formattedValue;
+    }
+    // Formula cells no longer persist `fv`. If the caller provided
+    // derivation context, compute it on the fly.
+    if (cellHasFormula(cell) && derivationContext) {
+        return deriveFormulaCellFv(cell, rowIndex, columnIndex, derivationContext);
+    }
+    return undefined;
+};
+/**
+ * Create csv string from sheetData using XLSX
+ * @param rowData
+ * @param config
+ * @returns
+ */
+export var createCSVFromSheetData = function (rowData, sharedStrings, config, derivationContext) {
+    var _a, _b, _c, _d;
+    var rowCount = (_a = rowData === null || rowData === void 0 ? void 0 : rowData.length) !== null && _a !== void 0 ? _a : 0;
+    // First pass: find max column with actual data to avoid trailing commas
+    var maxColumn = 0;
+    for (var rowIndex = 1; rowIndex <= rowCount; rowIndex++) {
+        var rowValues = (_b = rowData[rowIndex]) === null || _b === void 0 ? void 0 : _b.values;
+        if (rowValues) {
+            for (var col = rowValues.length - 1; col >= 1; col--) {
+                if (rowValues[col] != null) {
+                    maxColumn = Math.max(maxColumn, col);
+                    break;
+                }
+            }
+        }
+    }
+    var worksheetData = [];
+    for (var rowIndex = 1; rowIndex <= rowCount; rowIndex++) {
+        var rowValues = (_c = rowData[rowIndex]) === null || _c === void 0 ? void 0 : _c.values;
+        var rowCells = [];
+        for (var columnIndex = 1; columnIndex <= maxColumn; columnIndex++) {
+            var cell = rowValues === null || rowValues === void 0 ? void 0 : rowValues[columnIndex];
+            rowCells.push(((_d = getCellFormattedValueInternal(cell, rowIndex, columnIndex, sharedStrings, derivationContext)) !== null && _d !== void 0 ? _d : ""));
+        }
+        worksheetData.push(rowCells);
+    }
+    // Create worksheet from 2D array
+    var worksheet = XLSX.utils.aoa_to_sheet(worksheetData);
+    // Convert to CSV string
+    return XLSX.utils.sheet_to_csv(worksheet, {
+        FS: (config === null || config === void 0 ? void 0 : config.delimiter) || ",", // Field separator
+        RS: "\n", // Record separator
+        skipHidden: true,
+    });
+};
+export var exportToCSV = function (_a) {
+    var filename = _a.filename, rowData = _a.rowData, sharedStrings = _a.sharedStrings, config = _a.config, derivationContext = _a.derivationContext;
+    var csv = createCSVFromSheetData(rowData, sharedStrings, config, derivationContext);
+    var content = (config === null || config === void 0 ? void 0 : config.includeBom) ? "\uFEFF" + csv : csv;
+    var blob = new Blob([content], { type: "text/csv;charset=utf-8;" });
+    return createDownloadableFile("".concat(filename, ".csv"), blob);
+};

package/dist/cjs/csv-import-worker.d.ts

@@ -0,0 +1,16 @@
+import { Observable } from "rxjs";
+import type { CsvWorkerResponse } from "./csv-parser/types";
+export declare const createCSVImportWorker: (file: File | ArrayBuffer, options: {
+    pageSize: number;
+    startRowIndex: number;
+    startColumnIndex: number;
+    preserveFormatting?: boolean;
+    locale?: string;
+    enableSharedStrings?: boolean;
+    enableCellXfsRegistry?: boolean;
+    enableBackpressure?: boolean;
+}) => {
+    observable: Observable<CsvWorkerResponse>;
+    sendMessage: (message: any) => void;
+};
+//# sourceMappingURL=csv-import-worker.d.ts.map

package/dist/cjs/csv-import-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-import-worker.d.ts","sourceRoot":"","sources":["../../csv-import-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAW,MAAM,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAiB5D,eAAO,MAAM,qBAAqB,GAChC,MAAM,IAAI,GAAG,WAAW,EACxB,SAAS;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;;2BAmD6B,GAAG;CAQlC,CAAC"}

package/dist/cjs/csv-import-worker.js

@@ -0,0 +1,60 @@
+import { Observable, Subject } from "rxjs";
+import { CsvRequestType, CsvResponseType } from "./csv-parser/types";
+var getWorkerErrorMessage = function (error) {
+    if (error instanceof ErrorEvent) {
+        var parts = [error.message || "Worker runtime error"];
+        if (error.filename) {
+            var line = error.lineno ? ":".concat(error.lineno) : "";
+            var col = error.colno ? ":".concat(error.colno) : "";
+            parts.push("(".concat(error.filename).concat(line).concat(col, ")"));
+        }
+        return parts.join(" ");
+    }
+    return "Worker failed to load or crashed. Check worker URL resolution and browser console/network logs.";
+};
+export var createCSVImportWorker = function (file, options) {
+    var _a, _b;
+    // Hosts whose bundlers can't resolve the `new URL(...)` worker specifier
+    // (e.g. turbopack) can supply their own worker constructor via the global.
+    var workerFactories = globalThis.__ATHENA_TOOLKIT_WORKER_FACTORIES;
+    var worker = (_b = (_a = workerFactories === null || workerFactories === void 0 ? void 0 : workerFactories.csv) === null || _a === void 0 ? void 0 : _a.call(workerFactories)) !== null && _b !== void 0 ? _b : new Worker(new URL("@rowsncolumns/toolkit/csv-worker", import.meta.url), {
+        type: "module",
+    });
+    var subject = new Subject();
+    worker.onmessage = function (e) {
+        subject.next(e.data);
+    };
+    worker.onerror = function (error) {
+        subject.next({
+            responseType: CsvResponseType.ERROR,
+            error: getWorkerErrorMessage(error),
+        });
+        subject.complete();
+    };
+    worker.postMessage({
+        requestType: CsvRequestType.PARSE_CSV,
+        file: file,
+        pageSize: options.pageSize,
+        startRowIndex: options.startRowIndex,
+        startColumnIndex: options.startColumnIndex,
+        preserveFormatting: options.preserveFormatting,
+        locale: options.locale,
+        enableSharedStrings: options.enableSharedStrings,
+        enableCellXfsRegistry: options.enableCellXfsRegistry,
+        enableBackpressure: options.enableBackpressure,
+    });
+    var observable = new Observable(function (observer) {
+        var subscription = subject.subscribe(observer);
+        return function () {
+            subscription.unsubscribe();
+            worker.terminate();
+        };
+    });
+    var sendMessage = function (message) {
+        worker.postMessage(message);
+    };
+    return {
+        observable: observable,
+        sendMessage: sendMessage,
+    };
+};

package/dist/cjs/csv-import.d.ts

@@ -0,0 +1,38 @@
+import type { CellData } from "@rowsncolumns/spreadsheet";
+import type { RowData } from "@rowsncolumns/common-types";
+type BomEncoding = "utf-8" | "utf-16le" | "utf-16be";
+/**
+ * Sniff a byte-order mark at the start of a CSV byte stream.
+ * Returns the encoding the BOM declares, or `undefined` when no BOM
+ * is present (in which case bytes are treated as UTF-8).
+ */
+export declare const detectCSVBomEncoding: (bytes: Uint8Array) => BomEncoding | undefined;
+/**
+ * Parse csv string into a 2d array
+ * https://stackoverflow.com/a/14991797
+ * @param str
+ * @returns
+ */
+export declare const parseCSV: (input: string | File) => Promise<string[][] | undefined>;
+/**
+ * Create sheet data from csv string
+ * @param csv
+ * @param delimiter
+ * @returns
+ */
+export declare const createRowDataFromCSVString: <T extends CellData>(csv: string | File, preserveFormatting: boolean | undefined, locale: string | undefined) => Promise<RowData<T>[]>;
+/**
+ * Parse CSV file object
+ * @param file
+ * @returns
+ */
+export declare const createRowDataFromCSVFile: <T extends CellData>(file: File, preserveFormatting: boolean | undefined, locale: string | undefined) => Promise<RowData<T>[]>;
+/**
+ * Create sheet data from csv string
+ * @param csv
+ * @param delimiter
+ * @returns
+ */
+export declare const createCellDataArrayFromCSVString: <T extends CellData>(csv: string, locale: string | undefined) => Promise<T[][]>;
+export {};
+//# sourceMappingURL=csv-import.d.ts.map

package/dist/cjs/csv-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-import.d.ts","sourceRoot":"","sources":["../../csv-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAK1D,KAAK,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,UAAU,KAChB,WAAW,GAAG,SAchB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,GAAG,IAAI,KACnB,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,SAAS,CAoChC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAU,CAAC,SAAS,QAAQ,EACjE,KAAK,MAAM,GAAG,IAAI,EAClB,uCAAyB,EACzB,QAAQ,MAAM,GAAG,SAAS,0BA+B3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,CAAC,SAAS,QAAQ,EAC/D,MAAM,IAAI,EACV,uCAAyB,EACzB,QAAQ,MAAM,GAAG,SAAS,0BACwC,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAAU,CAAC,SAAS,QAAQ,EACvE,KAAK,MAAM,EACX,QAAQ,MAAM,GAAG,SAAS,mBAuB3B,CAAC"}