@cj-tech-master/excelts 3.0.1 → 3.1.0-canary.20260102043356.6791d4e

package/dist/esm/doc/table.js

@@ -1,405 +0,0 @@
-import { colCache } from "../utils/col-cache.js";
-class Column {
-    constructor(table, column, index) {
-        this.table = table;
-        this.column = column;
-        this.index = index;
-    }
-    _set(name, value) {
-        this.table.cacheState();
-        this.column[name] = value;
-    }
-    get name() {
-        return this.column.name;
-    }
-    set name(value) {
-        this._set("name", value);
-    }
-    get filterButton() {
-        return this.column.filterButton;
-    }
-    set filterButton(value) {
-        this.column.filterButton = value;
-    }
-    get style() {
-        return this.column.style;
-    }
-    set style(value) {
-        this.column.style = value;
-    }
-    get totalsRowLabel() {
-        return this.column.totalsRowLabel;
-    }
-    set totalsRowLabel(value) {
-        this._set("totalsRowLabel", value);
-    }
-    get totalsRowFunction() {
-        return this.column.totalsRowFunction;
-    }
-    set totalsRowFunction(value) {
-        this._set("totalsRowFunction", value);
-    }
-    get totalsRowResult() {
-        return this.column.totalsRowResult;
-    }
-    set totalsRowResult(value) {
-        this._set("totalsRowResult", value);
-    }
-    get totalsRowFormula() {
-        return this.column.totalsRowFormula;
-    }
-    set totalsRowFormula(value) {
-        this._set("totalsRowFormula", value);
-    }
-}
-class Table {
-    constructor(worksheet, table) {
-        this.worksheet = worksheet;
-        if (table) {
-            this.table = table;
-            // check things are ok first
-            this.validate();
-            this.store();
-        }
-    }
-    getFormula(column) {
-        // get the correct formula to apply to the totals row
-        switch (column.totalsRowFunction) {
-            case "none":
-                return null;
-            case "average":
-                return `SUBTOTAL(101,${this.table.name}[${column.name}])`;
-            case "countNums":
-                return `SUBTOTAL(102,${this.table.name}[${column.name}])`;
-            case "count":
-                return `SUBTOTAL(103,${this.table.name}[${column.name}])`;
-            case "max":
-                return `SUBTOTAL(104,${this.table.name}[${column.name}])`;
-            case "min":
-                return `SUBTOTAL(105,${this.table.name}[${column.name}])`;
-            case "stdDev":
-                return `SUBTOTAL(106,${this.table.name}[${column.name}])`;
-            case "var":
-                return `SUBTOTAL(107,${this.table.name}[${column.name}])`;
-            case "sum":
-                return `SUBTOTAL(109,${this.table.name}[${column.name}])`;
-            case "custom":
-                return column.totalsRowFormula || null;
-            default:
-                throw new Error(`Invalid Totals Row Function: ${column.totalsRowFunction}`);
-        }
-    }
-    get width() {
-        // width of the table
-        return this.table.columns.length;
-    }
-    get height() {
-        // height of the table data
-        return this.table.rows.length;
-    }
-    get filterHeight() {
-        // height of the table data plus optional header row
-        return this.height + (this.table.headerRow ? 1 : 0);
-    }
-    get tableHeight() {
-        // full height of the table on the sheet
-        return this.filterHeight + (this.table.totalsRow ? 1 : 0);
-    }
-    validate() {
-        const { table } = this;
-        // set defaults and check is valid
-        const assign = (o, name, dflt) => {
-            if (o[name] === undefined) {
-                o[name] = dflt;
-            }
-        };
-        assign(table, "headerRow", true);
-        assign(table, "totalsRow", false);
-        assign(table, "style", {});
-        assign(table.style, "theme", "TableStyleMedium2");
-        assign(table.style, "showFirstColumn", false);
-        assign(table.style, "showLastColumn", false);
-        assign(table.style, "showRowStripes", false);
-        assign(table.style, "showColumnStripes", false);
-        const assert = (test, message) => {
-            if (!test) {
-                throw new Error(message);
-            }
-        };
-        assert(!!table.ref, "Table must have ref");
-        assert(!!table.columns, "Table must have column definitions");
-        assert(!!table.rows, "Table must have row definitions");
-        table.tl = colCache.decodeAddress(table.ref);
-        const { row, col } = table.tl;
-        assert(row > 0, "Table must be on valid row");
-        assert(col > 0, "Table must be on valid col");
-        const { width, filterHeight, tableHeight } = this;
-        // autoFilterRef is a range that includes optional headers only
-        table.autoFilterRef = colCache.encode(row, col, row + filterHeight - 1, col + width - 1);
-        // tableRef is a range that includes optional headers and totals
-        table.tableRef = colCache.encode(row, col, row + tableHeight - 1, col + width - 1);
-        table.columns.forEach((column, i) => {
-            assert(!!column.name, `Column ${i} must have a name`);
-            if (i === 0) {
-                assign(column, "totalsRowLabel", "Total");
-            }
-            else {
-                assign(column, "totalsRowFunction", "none");
-                column.totalsRowFormula = this.getFormula(column) || undefined;
-            }
-        });
-    }
-    store() {
-        // where the table needs to store table data, headers, footers in
-        // the sheet...
-        const assignStyle = (cell, style) => {
-            if (style) {
-                Object.assign(cell.style, style);
-            }
-        };
-        const { worksheet, table } = this;
-        const { row, col } = table.tl;
-        let count = 0;
-        if (table.headerRow) {
-            const r = worksheet.getRow(row + count++);
-            table.columns.forEach((column, j) => {
-                const { style, name } = column;
-                const cell = r.getCell(col + j);
-                cell.value = name;
-                assignStyle(cell, style);
-            });
-        }
-        table.rows.forEach(data => {
-            const r = worksheet.getRow(row + count++);
-            data.forEach((value, j) => {
-                const cell = r.getCell(col + j);
-                cell.value = value;
-                assignStyle(cell, table.columns[j].style);
-            });
-        });
-        if (table.totalsRow) {
-            const r = worksheet.getRow(row + count++);
-            table.columns.forEach((column, j) => {
-                const cell = r.getCell(col + j);
-                if (j === 0) {
-                    cell.value = column.totalsRowLabel;
-                }
-                else {
-                    const formula = this.getFormula(column);
-                    if (formula) {
-                        cell.value = {
-                            formula: column.totalsRowFormula,
-                            result: column.totalsRowResult
-                        };
-                    }
-                    else {
-                        cell.value = null;
-                    }
-                }
-                assignStyle(cell, column.style);
-            });
-        }
-    }
-    load(worksheet) {
-        // where the table will read necessary features from a loaded sheet
-        const { table } = this;
-        const { row, col } = table.tl;
-        let count = 0;
-        if (table.headerRow) {
-            const r = worksheet.getRow(row + count++);
-            table.columns.forEach((column, j) => {
-                const cell = r.getCell(col + j);
-                cell.value = column.name;
-            });
-        }
-        table.rows.forEach(data => {
-            const r = worksheet.getRow(row + count++);
-            data.forEach((value, j) => {
-                const cell = r.getCell(col + j);
-                cell.value = value;
-            });
-        });
-        if (table.totalsRow) {
-            const r = worksheet.getRow(row + count++);
-            table.columns.forEach((column, j) => {
-                const cell = r.getCell(col + j);
-                if (j === 0) {
-                    cell.value = column.totalsRowLabel;
-                }
-                else {
-                    const formula = this.getFormula(column);
-                    if (formula) {
-                        cell.value = {
-                            formula: column.totalsRowFormula,
-                            result: column.totalsRowResult
-                        };
-                    }
-                }
-            });
-        }
-    }
-    get model() {
-        return this.table;
-    }
-    set model(value) {
-        this.table = value;
-    }
-    // ================================================================
-    // TODO: Mutating methods
-    cacheState() {
-        if (!this._cache) {
-            this._cache = {
-                ref: this.ref,
-                width: this.width,
-                tableHeight: this.tableHeight
-            };
-        }
-    }
-    commit() {
-        // changes may have been made that might have on-sheet effects
-        if (!this._cache) {
-            return;
-        }
-        // check things are ok first
-        this.validate();
-        const ref = colCache.decodeAddress(this._cache.ref);
-        if (this.ref !== this._cache.ref) {
-            // wipe out whole table footprint at previous location
-            for (let i = 0; i < this._cache.tableHeight; i++) {
-                const row = this.worksheet.getRow(ref.row + i);
-                for (let j = 0; j < this._cache.width; j++) {
-                    const cell = row.getCell(ref.col + j);
-                    cell.value = null;
-                }
-            }
-        }
-        else {
-            // clear out below table if it has shrunk
-            for (let i = this.tableHeight; i < this._cache.tableHeight; i++) {
-                const row = this.worksheet.getRow(ref.row + i);
-                for (let j = 0; j < this._cache.width; j++) {
-                    const cell = row.getCell(ref.col + j);
-                    cell.value = null;
-                }
-            }
-            // clear out to right of table if it has lost columns
-            for (let i = 0; i < this.tableHeight; i++) {
-                const row = this.worksheet.getRow(ref.row + i);
-                for (let j = this.width; j < this._cache.width; j++) {
-                    const cell = row.getCell(ref.col + j);
-                    cell.value = null;
-                }
-            }
-        }
-        this.store();
-    }
-    addRow(values, rowNumber) {
-        // Add a row of data, either insert at rowNumber or append
-        this.cacheState();
-        if (rowNumber === undefined) {
-            this.table.rows.push(values);
-        }
-        else {
-            this.table.rows.splice(rowNumber, 0, values);
-        }
-    }
-    removeRows(rowIndex, count = 1) {
-        // Remove a rows of data
-        this.cacheState();
-        this.table.rows.splice(rowIndex, count);
-    }
-    getColumn(colIndex) {
-        const column = this.table.columns[colIndex];
-        return new Column(this, column, colIndex);
-    }
-    addColumn(column, values, colIndex) {
-        // Add a new column, including column defn and values
-        // Inserts at colNumber or adds to the right
-        this.cacheState();
-        if (colIndex === undefined) {
-            this.table.columns.push(column);
-            this.table.rows.forEach((row, i) => {
-                row.push(values[i]);
-            });
-        }
-        else {
-            this.table.columns.splice(colIndex, 0, column);
-            this.table.rows.forEach((row, i) => {
-                row.splice(colIndex, 0, values[i]);
-            });
-        }
-    }
-    removeColumns(colIndex, count = 1) {
-        // Remove a column with data
-        this.cacheState();
-        this.table.columns.splice(colIndex, count);
-        this.table.rows.forEach(row => {
-            row.splice(colIndex, count);
-        });
-    }
-    _assign(target, prop, value) {
-        this.cacheState();
-        target[prop] = value;
-    }
-    get ref() {
-        return this.table.ref;
-    }
-    set ref(value) {
-        this._assign(this.table, "ref", value);
-    }
-    get name() {
-        return this.table.name;
-    }
-    set name(value) {
-        this.table.name = value;
-    }
-    get displayName() {
-        return this.table.displayName || this.table.name;
-    }
-    set displayName(value) {
-        this.table.displayName = value;
-    }
-    get headerRow() {
-        return this.table.headerRow;
-    }
-    set headerRow(value) {
-        this._assign(this.table, "headerRow", value);
-    }
-    get totalsRow() {
-        return this.table.totalsRow;
-    }
-    set totalsRow(value) {
-        this._assign(this.table, "totalsRow", value);
-    }
-    get theme() {
-        return this.table.style.theme;
-    }
-    set theme(value) {
-        this.table.style.theme = value;
-    }
-    get showFirstColumn() {
-        return this.table.style.showFirstColumn;
-    }
-    set showFirstColumn(value) {
-        this.table.style.showFirstColumn = value;
-    }
-    get showLastColumn() {
-        return this.table.style.showLastColumn;
-    }
-    set showLastColumn(value) {
-        this.table.style.showLastColumn = value;
-    }
-    get showRowStripes() {
-        return this.table.style.showRowStripes;
-    }
-    set showRowStripes(value) {
-        this.table.style.showRowStripes = value;
-    }
-    get showColumnStripes() {
-        return this.table.style.showColumnStripes;
-    }
-    set showColumnStripes(value) {
-        this.table.style.showColumnStripes = value;
-    }
-}
-export { Table };

package/dist/esm/doc/workbook.base.js

@@ -1,207 +0,0 @@
-/**
- * WorkbookBase - Platform-independent base class for Workbook
- *
- * This file contains all the shared logic between Node.js and Browser versions.
- * Platform-specific features (xlsx, csv, streaming) are added by subclasses.
- */
-import { Worksheet } from "./worksheet.js";
-import { DefinedNames } from "./defined-names.js";
-// =============================================================================
-// WorkbookBase Class
-// =============================================================================
-/**
- * Base class for Workbook containing all platform-independent functionality.
- *
- * Subclasses add:
- * - Node.js: xlsx (full), csv, streaming (createStreamWriter/Reader)
- * - Browser: xlsx (buffer only), no csv, no streaming
- */
-export class WorkbookBase {
-    constructor() {
-        this.category = "";
-        this.company = "";
-        this.created = new Date();
-        this.description = "";
-        this.keywords = "";
-        this.manager = "";
-        this.modified = this.created;
-        this.properties = {};
-        this.calcProperties = {};
-        this._worksheets = [];
-        this.subject = "";
-        this.title = "";
-        this.views = [];
-        this.media = [];
-        this.pivotTables = [];
-        this._definedNames = new DefinedNames();
-    }
-    // ===========================================================================
-    // Worksheet Management
-    // ===========================================================================
-    get nextId() {
-        // Find the next unique spot to add worksheet
-        for (let i = 1; i < this._worksheets.length; i++) {
-            if (!this._worksheets[i]) {
-                return i;
-            }
-        }
-        return this._worksheets.length || 1;
-    }
-    /**
-     * Add a new worksheet and return a reference to it
-     */
-    addWorksheet(name, options) {
-        const id = this.nextId;
-        const lastOrderNo = this._worksheets.reduce((acc, ws) => ((ws && ws.orderNo) > acc ? ws.orderNo : acc), 0);
-        const worksheetOptions = {
-            ...options,
-            id,
-            name,
-            orderNo: lastOrderNo + 1,
-            workbook: this
-        };
-        const worksheet = new Worksheet(worksheetOptions);
-        this._worksheets[id] = worksheet;
-        return worksheet;
-    }
-    removeWorksheetEx(worksheet) {
-        delete this._worksheets[worksheet.id];
-    }
-    removeWorksheet(id) {
-        const worksheet = this.getWorksheet(id);
-        if (worksheet) {
-            worksheet.destroy();
-        }
-    }
-    /**
-     * Fetch sheet by name or id
-     */
-    getWorksheet(id) {
-        if (id === undefined) {
-            return this._worksheets.find(Boolean);
-        }
-        if (typeof id === "number") {
-            return this._worksheets[id];
-        }
-        if (typeof id === "string") {
-            return this._worksheets.find(worksheet => worksheet && worksheet.name === id);
-        }
-        return undefined;
-    }
-    /**
-     * Return a clone of worksheets in order
-     */
-    get worksheets() {
-        return this._worksheets
-            .slice(1)
-            .sort((a, b) => a.orderNo - b.orderNo)
-            .filter(Boolean);
-    }
-    /**
-     * Iterate over all sheets.
-     *
-     * Note: `workbook.worksheets.forEach` will still work but this is better.
-     */
-    eachSheet(callback) {
-        this.worksheets.forEach(sheet => {
-            callback(sheet, sheet.id);
-        });
-    }
-    // ===========================================================================
-    // Defined Names
-    // ===========================================================================
-    get definedNames() {
-        return this._definedNames;
-    }
-    // ===========================================================================
-    // Themes
-    // ===========================================================================
-    clearThemes() {
-        // Note: themes are not an exposed feature, meddle at your peril!
-        this._themes = undefined;
-    }
-    // ===========================================================================
-    // Images
-    // ===========================================================================
-    /**
-     * Add Image to Workbook and return the id
-     */
-    addImage(image) {
-        const id = this.media.length;
-        this.media.push({ ...image, type: "image" });
-        return id;
-    }
-    getImage(id) {
-        return this.media[Number(id)];
-    }
-    // ===========================================================================
-    // Model (Serialization)
-    // ===========================================================================
-    get model() {
-        return {
-            creator: this.creator || "Unknown",
-            lastModifiedBy: this.lastModifiedBy || "Unknown",
-            lastPrinted: this.lastPrinted,
-            created: this.created,
-            modified: this.modified,
-            properties: this.properties,
-            worksheets: this.worksheets.map(worksheet => worksheet.model),
-            sheets: this.worksheets.map(ws => ws.model).filter(Boolean),
-            definedNames: this._definedNames.model,
-            views: this.views,
-            company: this.company,
-            manager: this.manager,
-            title: this.title,
-            subject: this.subject,
-            keywords: this.keywords,
-            category: this.category,
-            description: this.description,
-            language: this.language,
-            revision: this.revision,
-            contentStatus: this.contentStatus,
-            themes: this._themes,
-            media: this.media,
-            pivotTables: this.pivotTables,
-            calcProperties: this.calcProperties
-        };
-    }
-    set model(value) {
-        this.creator = value.creator;
-        this.lastModifiedBy = value.lastModifiedBy;
-        this.lastPrinted = value.lastPrinted;
-        this.created = value.created;
-        this.modified = value.modified;
-        this.company = value.company;
-        this.manager = value.manager;
-        this.title = value.title;
-        this.subject = value.subject;
-        this.keywords = value.keywords;
-        this.category = value.category;
-        this.description = value.description;
-        this.language = value.language;
-        this.revision = value.revision;
-        this.contentStatus = value.contentStatus;
-        this.properties = value.properties;
-        this.calcProperties = value.calcProperties;
-        this._worksheets = [];
-        value.worksheets.forEach(worksheetModel => {
-            const { id, name, state } = worksheetModel;
-            const orderNo = value.sheets && value.sheets.findIndex(ws => ws.id === id);
-            const worksheet = (this._worksheets[id] = new Worksheet({
-                id,
-                name,
-                orderNo: orderNo !== -1 ? orderNo : undefined,
-                state,
-                workbook: this
-            }));
-            worksheet.model = worksheetModel;
-        });
-        this._definedNames.model = value.definedNames;
-        this.views = value.views;
-        this._themes = value.themes;
-        this.media = value.media || [];
-        // Handle pivot tables - either newly created or loaded from file
-        // Loaded pivot tables come from loadedPivotTables after reconciliation
-        this.pivotTables = value.pivotTables || value.loadedPivotTables || [];
-    }
-}

package/dist/esm/doc/workbook.browser.js

@@ -1,59 +0,0 @@
-/**
- * Workbook Browser version - No Node.js dependencies
- *
- * Extends WorkbookBase with:
- * - xlsx: Buffer-based operations (load, writeBuffer)
- * - csv: Buffer-based operations (load, writeString, writeBuffer)
- * - streaming: NOT supported (throws error)
- */
-import { WorkbookBase } from "./workbook.base.js";
-import { XLSX } from "../xlsx/xlsx.browser.js";
-import { CSV } from "../csv/csv.browser.js";
-class Workbook extends WorkbookBase {
-    /**
-     * xlsx file format operations
-     * Supports: load (buffer), writeBuffer
-     * NOT supported: readFile, writeFile, read (stream), write (stream)
-     */
-    get xlsx() {
-        if (!this._xlsx) {
-            this._xlsx = new XLSX(this);
-        }
-        return this._xlsx;
-    }
-    /**
-     * CSV file format operations
-     * Supports: load (string/buffer), writeString, writeBuffer
-     * NOT supported: readFile, writeFile, read (stream), write (stream)
-     */
-    get csv() {
-        if (!this._csv) {
-            this._csv = new CSV(this);
-        }
-        return this._csv;
-    }
-    // ===========================================================================
-    // Static Factory Methods - NOT available in browser
-    // TypeScript users: These methods don't exist on this type
-    // JavaScript users: These methods throw helpful errors
-    // ===========================================================================
-    /**
-     * @deprecated Streaming is not available in browser
-     * @throws Error with helpful message
-     */
-    static createStreamWriter(_options) {
-        throw new Error("Streaming workbook writer is not available in browser. " +
-            "Use `new Workbook()` with `xlsx.writeBuffer()` instead, " +
-            "or import from 'excelts' (Node.js) for streaming support.");
-    }
-    /**
-     * @deprecated Streaming is not available in browser
-     * @throws Error with helpful message
-     */
-    static createStreamReader(_input, _options) {
-        throw new Error("Streaming workbook reader is not available in browser. " +
-            "Use `new Workbook()` with `xlsx.load()` instead, " +
-            "or import from 'excelts' (Node.js) for streaming support.");
-    }
-}
-export { Workbook };