@cj-tech-master/excelts 3.0.1-canary.20251230173853.c3c79fa → 3.1.0-canary.20260102041828.82ed571

package/dist/esm/csv/csv.base.js

@@ -1,131 +0,0 @@
-/**
- * CSV Base class - Shared functionality for Node.js and Browser
- *
- * Uses native CSV parser (RFC 4180 compliant) with zero external dependencies.
- * Date parsing uses native high-performance datetime utilities.
- */
-import { DateParser, DateFormatter } from "../utils/datetime.js";
-import { parseCsv, formatCsv } from "./csv-core.js";
-import { parseNumberFromCsv } from "./csv-number.js";
-// Special Excel values mapping
-const SpecialValues = {
-    true: true,
-    false: false,
-    "#N/A": { error: "#N/A" },
-    "#REF!": { error: "#REF!" },
-    "#NAME?": { error: "#NAME?" },
-    "#DIV/0!": { error: "#DIV/0!" },
-    "#NULL!": { error: "#NULL!" },
-    "#VALUE!": { error: "#VALUE!" },
-    "#NUM!": { error: "#NUM!" }
-};
-/**
- * Create the default value mapper for CSV parsing
- */
-export function createDefaultValueMapper(dateFormats, parserOptions) {
-    const dateParser = DateParser.create(dateFormats);
-    const decimalSeparator = parserOptions?.decimalSeparator ?? ".";
-    return function mapValue(datum) {
-        if (datum === "") {
-            return null;
-        }
-        // Try to parse as number
-        const datumNumber = typeof datum === "string" ? parseNumberFromCsv(datum, decimalSeparator) : Number(datum);
-        if (!Number.isNaN(datumNumber) && datumNumber !== Infinity) {
-            return datumNumber;
-        }
-        // Try to parse as date
-        const date = dateParser.parse(datum);
-        if (date) {
-            return date;
-        }
-        // Check for special values
-        const special = SpecialValues[datum];
-        if (special !== undefined) {
-            return special;
-        }
-        return datum;
-    };
-}
-/**
- * Create the default value mapper for CSV writing
- */
-export function createDefaultWriteMapper(dateFormat, dateUTC) {
-    const formatter = dateFormat
-        ? DateFormatter.create(dateFormat, { utc: dateUTC })
-        : DateFormatter.iso(dateUTC);
-    return function mapValue(value) {
-        if (value) {
-            // Handle hyperlinks
-            if (value.text || value.hyperlink) {
-                return value.hyperlink || value.text || "";
-            }
-            // Handle formulas
-            if (value.formula || value.result) {
-                return value.result || "";
-            }
-            // Handle dates
-            if (value instanceof Date) {
-                return formatter.format(value);
-            }
-            // Handle errors
-            if (value.error) {
-                return value.error;
-            }
-            // Handle other objects
-            if (typeof value === "object") {
-                return JSON.stringify(value);
-            }
-        }
-        return value;
-    };
-}
-/**
- * Parse CSV content into a worksheet
- */
-export function parseCsvToWorksheet(content, workbook, options = {}) {
-    const worksheet = workbook.addWorksheet(options.sheetName);
-    const dateFormats = options.dateFormats || [
-        "YYYY-MM-DD[T]HH:mm:ssZ",
-        "YYYY-MM-DD[T]HH:mm:ss",
-        "YYYY-MM-DD"
-    ];
-    // If using the default mapper, pass parserOptions for locale-aware number parsing.
-    // (Custom map overrides this behavior.)
-    const effectiveMap = options.map || createDefaultValueMapper(dateFormats, options.parserOptions);
-    // Parse CSV
-    const rows = parseCsv(content, options.parserOptions);
-    // Add rows to worksheet
-    for (const row of rows) {
-        worksheet.addRow(row.map(effectiveMap));
-    }
-    return worksheet;
-}
-/**
- * Format worksheet as CSV string
- */
-export function formatWorksheetToCsv(worksheet, options = {}) {
-    if (!worksheet) {
-        return "";
-    }
-    const { dateFormat, dateUTC } = options;
-    const map = options.map || createDefaultWriteMapper(dateFormat, dateUTC);
-    const includeEmptyRows = options.includeEmptyRows !== false;
-    const rows = [];
-    let lastRow = 1;
-    worksheet.eachRow((row, rowNumber) => {
-        // Add empty rows if needed
-        if (includeEmptyRows) {
-            while (lastRow++ < rowNumber - 1) {
-                rows.push([]);
-            }
-        }
-        const { values } = row;
-        values.shift(); // Remove first empty element (1-indexed)
-        rows.push(values.map(map));
-        lastRow = rowNumber;
-    });
-    return formatCsv(rows, options.formatterOptions);
-}
-// Re-export core types
-export { parseCsv, formatCsv, parseCsvStream } from "./csv-core.js";

package/dist/esm/csv/csv.browser.js

@@ -1,65 +0,0 @@
-/**
- * CSV class for Browser - No file system dependencies
- *
- * Provides:
- * - load: Load from string or ArrayBuffer
- * - writeString: Write to string
- * - writeBuffer: Write to Uint8Array
- */
-import { parseCsvToWorksheet, formatWorksheetToCsv } from "./csv.base.js";
-class CSV {
-    constructor(workbook) {
-        this.workbook = workbook;
-    }
-    /**
-     * Load CSV from string or ArrayBuffer
-     */
-    load(data, options) {
-        let content;
-        if (typeof data === "string") {
-            content = data;
-        }
-        else if (data instanceof ArrayBuffer) {
-            content = new TextDecoder("utf-8").decode(data);
-        }
-        else if (data instanceof Uint8Array) {
-            content = new TextDecoder("utf-8").decode(data);
-        }
-        else {
-            throw new Error("Invalid data type. Expected string, ArrayBuffer, or Uint8Array.");
-        }
-        return parseCsvToWorksheet(content, this.workbook, options);
-    }
-    /**
-     * Write CSV to string
-     */
-    writeString(options) {
-        const worksheet = this.workbook.getWorksheet(options?.sheetName || options?.sheetId);
-        return formatWorksheetToCsv(worksheet, options);
-    }
-    /**
-     * Write CSV to Uint8Array buffer
-     */
-    writeBuffer(options) {
-        const content = this.writeString(options);
-        return new TextEncoder().encode(content);
-    }
-    // Stubs for unsupported methods - throw helpful errors
-    async readFile(_filename, _options) {
-        throw new Error("CSV.readFile() is not available in browser. " +
-            "Use CSV.load() with string or ArrayBuffer instead.");
-    }
-    async read(_stream, _options) {
-        throw new Error("CSV.read() stream is not available in browser. " +
-            "Use CSV.load() with string or ArrayBuffer instead.");
-    }
-    async writeFile(_filename, _options) {
-        throw new Error("CSV.writeFile() is not available in browser. " +
-            "Use CSV.writeString() or CSV.writeBuffer() and handle download manually.");
-    }
-    write(_stream, _options) {
-        throw new Error("CSV.write() stream is not available in browser. " +
-            "Use CSV.writeString() or CSV.writeBuffer() instead.");
-    }
-}
-export { CSV };

package/dist/esm/csv/csv.js

@@ -1,209 +0,0 @@
-/**
- * CSV class for Node.js - Full streaming and file system support
- *
- * Features:
- * - readFile: Read from file path (streaming)
- * - writeFile: Write to file path (streaming)
- * - read: Read from Node.js stream
- * - write: Write to Node.js stream
- * - createReadStream: Create a readable stream from worksheet
- * - createWriteStream: Create a writable stream that writes to worksheet
- */
-import fs from "fs";
-import {} from "stream";
-import { fileExists } from "../utils/utils.js";
-import { createDefaultValueMapper, createDefaultWriteMapper } from "./csv.base.js";
-import { CsvParserStream, CsvFormatterStream } from "./csv-stream.js";
-class CSV {
-    constructor(workbook) {
-        this.workbook = workbook;
-    }
-    /**
-     * Read CSV from file using streaming
-     *
-     * @example
-     * ```ts
-     * const worksheet = await workbook.csv.readFile('data.csv');
-     * ```
-     */
-    async readFile(filename, options) {
-        if (!(await fileExists(filename))) {
-            throw new Error(`File not found: ${filename}`);
-        }
-        const readStream = fs.createReadStream(filename, {
-            encoding: "utf8",
-            highWaterMark: options?.highWaterMark ?? 64 * 1024
-        });
-        return this.read(readStream, options);
-    }
-    /**
-     * Read CSV from Node.js readable stream
-     *
-     * Uses true streaming - processes data row by row without loading entire file into memory.
-     *
-     * @example
-     * ```ts
-     * const stream = fs.createReadStream('data.csv');
-     * const worksheet = await workbook.csv.read(stream);
-     * ```
-     */
-    async read(stream, options) {
-        const worksheet = this.workbook.addWorksheet(options?.sheetName);
-        const dateFormats = options?.dateFormats ??
-            ["YYYY-MM-DD[T]HH:mm:ssZ", "YYYY-MM-DD[T]HH:mm:ss", "MM-DD-YYYY", "YYYY-MM-DD"];
-        const map = options?.map || createDefaultValueMapper(dateFormats, options?.parserOptions);
-        const parser = new CsvParserStream(options?.parserOptions);
-        return new Promise((resolve, reject) => {
-            stream.pipe(parser);
-            parser.on("data", (row) => {
-                worksheet.addRow(row.map(map));
-            });
-            parser.on("end", () => {
-                resolve(worksheet);
-            });
-            parser.on("error", reject);
-            stream.on("error", reject);
-        });
-    }
-    /**
-     * Write CSV to file using streaming
-     *
-     * @example
-     * ```ts
-     * await workbook.csv.writeFile('output.csv');
-     * ```
-     */
-    async writeFile(filename, options) {
-        const writeStream = fs.createWriteStream(filename, {
-            encoding: (options?.encoding || "utf8"),
-            highWaterMark: options?.highWaterMark ?? 64 * 1024
-        });
-        return this.write(writeStream, options);
-    }
-    /**
-     * Write CSV to Node.js writable stream
-     *
-     * Uses true streaming - writes data row by row.
-     *
-     * @example
-     * ```ts
-     * const stream = fs.createWriteStream('output.csv');
-     * await workbook.csv.write(stream);
-     * ```
-     */
-    async write(stream, options) {
-        const worksheet = this.workbook.getWorksheet(options?.sheetName || options?.sheetId);
-        if (!worksheet) {
-            stream.end();
-            return;
-        }
-        const { dateFormat, dateUTC } = options || {};
-        const map = options?.map || createDefaultWriteMapper(dateFormat, dateUTC);
-        const includeEmptyRows = options?.includeEmptyRows !== false;
-        const formatterOptions = {
-            ...options?.formatterOptions
-        };
-        const formatter = new CsvFormatterStream(formatterOptions);
-        formatter.pipe(stream);
-        let lastRow = 1;
-        worksheet.eachRow((row, rowNumber) => {
-            // Add empty rows if needed
-            if (includeEmptyRows) {
-                while (lastRow++ < rowNumber - 1) {
-                    formatter.write([]);
-                }
-            }
-            const { values } = row;
-            values.shift(); // Remove first empty element (1-indexed)
-            formatter.write(values.map(map));
-            lastRow = rowNumber;
-        });
-        return new Promise((resolve, reject) => {
-            formatter.on("error", reject);
-            stream.on("error", reject);
-            stream.on("finish", () => resolve());
-            formatter.end();
-        });
-    }
-    /**
-     * Write CSV to buffer
-     *
-     * Note: This loads the entire CSV into memory. For large files, use write() with a stream.
-     */
-    async writeBuffer(options) {
-        const chunks = [];
-        const { Writable } = await import("stream");
-        const bufferStream = new Writable({
-            write(chunk, encoding, callback) {
-                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, encoding));
-                callback();
-            }
-        });
-        await this.write(bufferStream, options);
-        return Buffer.concat(chunks);
-    }
-    /**
-     * Create a readable stream that outputs CSV rows from the worksheet
-     *
-     * @example
-     * ```ts
-     * const csvStream = workbook.csv.createReadStream();
-     * csvStream.pipe(fs.createWriteStream('output.csv'));
-     * ```
-     */
-    createReadStream(options) {
-        const worksheet = this.workbook.getWorksheet(options?.sheetName || options?.sheetId);
-        const { dateFormat, dateUTC } = options || {};
-        const map = options?.map || createDefaultWriteMapper(dateFormat, dateUTC);
-        const includeEmptyRows = options?.includeEmptyRows !== false;
-        const formatterOptions = {
-            ...options?.formatterOptions
-        };
-        const formatter = new CsvFormatterStream(formatterOptions);
-        if (worksheet) {
-            // Use setImmediate to allow piping before data flows
-            setImmediate(() => {
-                let lastRow = 1;
-                worksheet.eachRow((row, rowNumber) => {
-                    if (includeEmptyRows) {
-                        while (lastRow++ < rowNumber - 1) {
-                            formatter.write([]);
-                        }
-                    }
-                    const { values } = row;
-                    values.shift();
-                    formatter.write(values.map(map));
-                    lastRow = rowNumber;
-                });
-                formatter.end();
-            });
-        }
-        else {
-            setImmediate(() => formatter.end());
-        }
-        return formatter;
-    }
-    /**
-     * Create a writable stream that parses CSV and adds rows to a worksheet
-     *
-     * @example
-     * ```ts
-     * const csvWriter = workbook.csv.createWriteStream({ sheetName: 'Data' });
-     * fs.createReadStream('input.csv').pipe(csvWriter);
-     * await new Promise(resolve => csvWriter.on('finish', resolve));
-     * ```
-     */
-    createWriteStream(options) {
-        const worksheet = this.workbook.addWorksheet(options?.sheetName);
-        const dateFormats = options?.dateFormats ??
-            ["YYYY-MM-DD[T]HH:mm:ssZ", "YYYY-MM-DD[T]HH:mm:ss", "MM-DD-YYYY", "YYYY-MM-DD"];
-        const map = options?.map || createDefaultValueMapper(dateFormats, options?.parserOptions);
-        const parser = new CsvParserStream(options?.parserOptions);
-        parser.on("data", (row) => {
-            worksheet.addRow(row.map(map));
-        });
-        return parser;
-    }
-}
-export { CSV };
-export { CsvParserStream, CsvFormatterStream } from "./csv-stream.js";

package/dist/esm/doc/anchor.js

@@ -1,97 +0,0 @@
-import { colCache } from "../utils/col-cache.js";
-function isAnchorModel(value) {
-    return (typeof value === "object" &&
-        "nativeCol" in value &&
-        "nativeRow" in value &&
-        "nativeColOff" in value &&
-        "nativeRowOff" in value);
-}
-function isSimpleAddress(value) {
-    return typeof value === "object" && "col" in value && "row" in value;
-}
-class Anchor {
-    constructor(worksheet, address, offset = 0) {
-        this.worksheet = worksheet;
-        if (!address) {
-            this.nativeCol = 0;
-            this.nativeColOff = 0;
-            this.nativeRow = 0;
-            this.nativeRowOff = 0;
-        }
-        else if (typeof address === "string") {
-            const decoded = colCache.decodeAddress(address);
-            this.nativeCol = decoded.col + offset;
-            this.nativeColOff = 0;
-            this.nativeRow = decoded.row + offset;
-            this.nativeRowOff = 0;
-        }
-        else if (isAnchorModel(address)) {
-            this.nativeCol = address.nativeCol || 0;
-            this.nativeColOff = address.nativeColOff || 0;
-            this.nativeRow = address.nativeRow || 0;
-            this.nativeRowOff = address.nativeRowOff || 0;
-        }
-        else if (isSimpleAddress(address)) {
-            this.col = address.col + offset;
-            this.row = address.row + offset;
-        }
-        else {
-            this.nativeCol = 0;
-            this.nativeColOff = 0;
-            this.nativeRow = 0;
-            this.nativeRowOff = 0;
-        }
-    }
-    static asInstance(model) {
-        if (model == null) {
-            return null;
-        }
-        if (model instanceof Anchor) {
-            return model;
-        }
-        return new Anchor(undefined, model);
-    }
-    get col() {
-        return this.nativeCol + Math.min(this.colWidth - 1, this.nativeColOff) / this.colWidth;
-    }
-    set col(v) {
-        this.nativeCol = Math.floor(v);
-        this.nativeColOff = Math.floor((v - this.nativeCol) * this.colWidth);
-    }
-    get row() {
-        return this.nativeRow + Math.min(this.rowHeight - 1, this.nativeRowOff) / this.rowHeight;
-    }
-    set row(v) {
-        this.nativeRow = Math.floor(v);
-        this.nativeRowOff = Math.floor((v - this.nativeRow) * this.rowHeight);
-    }
-    get colWidth() {
-        return this.worksheet &&
-            this.worksheet.getColumn(this.nativeCol + 1) &&
-            this.worksheet.getColumn(this.nativeCol + 1).isCustomWidth
-            ? Math.floor(this.worksheet.getColumn(this.nativeCol + 1).width * 10000)
-            : 640000;
-    }
-    get rowHeight() {
-        return this.worksheet &&
-            this.worksheet.getRow(this.nativeRow + 1) &&
-            this.worksheet.getRow(this.nativeRow + 1).height
-            ? Math.floor(this.worksheet.getRow(this.nativeRow + 1).height * 10000)
-            : 180000;
-    }
-    get model() {
-        return {
-            nativeCol: this.nativeCol,
-            nativeColOff: this.nativeColOff,
-            nativeRow: this.nativeRow,
-            nativeRowOff: this.nativeRowOff
-        };
-    }
-    set model(value) {
-        this.nativeCol = value.nativeCol;
-        this.nativeColOff = value.nativeColOff;
-        this.nativeRow = value.nativeRow;
-        this.nativeRowOff = value.nativeRowOff;
-    }
-}
-export { Anchor };