@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/cjs/modules/excel/workbook.js

@@ -7,12 +7,60 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Workbook = void 0;
 const errors_1 = require("./errors.js");
+const workbook_reader_1 = require("./stream/workbook-reader.js");
+const workbook_writer_1 = require("./stream/workbook-writer.js");
 const workbook_browser_1 = require("./workbook.browser.js");
+const xlsx_1 = require("./xlsx/xlsx.js");
 const fs_1 = require("../../utils/fs.js");
 // =============================================================================
 // Node.js Workbook Class
 // =============================================================================
 class Workbook extends workbook_browser_1.Workbook {
+    /**
+     * xlsx file format operations — Node.js variant. Exposes the
+     * `readFile` / `writeFile` / streaming `read` / `write` methods that
+     * the browser XLSX omits. Overriding here (rather than typing the
+     * base getter as Node XLSX directly) keeps the browser
+     * `Workbook.xlsx` type clean — browser consumers see only the
+     * operations the bundle actually supports and get a TS error if
+     * they accidentally reach for file-path APIs.
+     */
+    get xlsx() {
+        if (!this._xlsxNode) {
+            this._xlsxNode = new xlsx_1.XLSX(this);
+        }
+        return this._xlsxNode;
+    }
+    /**
+     * Create a streaming workbook writer — Node.js variant. Accepts the
+     * Node-only `{ filename }` option for direct file-path output in
+     * addition to the cross-platform `{ stream }` option. Overriding
+     * here (rather than typing the base factory as the Node writer)
+     * keeps the browser bundle free of Node-only stream code.
+     *
+     * The return type is declared as the browser `WorkbookWriter` to
+     * preserve static-side Liskov compatibility with the base class;
+     * downcast at the call site if the Node subclass API is needed, or
+     * use `new WorkbookWriter()` directly.
+     */
+    static createStreamWriter(options) {
+        return new workbook_writer_1.WorkbookWriter(options);
+    }
+    /**
+     * Create a streaming workbook reader — Node.js variant. Accepts a
+     * Node-only file-path `string` in addition to the cross-platform
+     * `CommonInput` types (buffer / readable). Overriding here keeps the
+     * browser bundle free of Node-only `fs` imports.
+     *
+     * The return type is declared as the browser `WorkbookReader` to
+     * preserve static-side Liskov compatibility with the base class.
+     * The runtime instance is the Node `WorkbookReader` subclass and
+     * handles file-path inputs transparently; downcast if the subclass
+     * API is needed, or use `new WorkbookReader()` directly.
+     */
+    static createStreamReader(input, options) {
+        return new workbook_reader_1.WorkbookReader(input, options);
+    }
     /**
      * Read CSV from file (Node.js only)
      *

package/dist/cjs/modules/excel/worksheet.js

@@ -1,15 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Worksheet = void 0;
+// Chart runtime is accessed via the chart-host-registry slot rather
+// than imported directly. See `chart-host-registry.ts` and
+// `chart/install.ts` for the registration protocol. Types are pulled
+// in via `import type` so bundlers emit zero runtime chart code unless
+// the consumer imports `@cj-tech-master/excelts/chart`.
+const chart_host_registry_1 = require("./chart-host-registry.js");
 const column_1 = require("./column.js");
 const data_validations_1 = require("./data-validations.js");
 const enums_1 = require("./enums.js");
 const errors_1 = require("./errors.js");
 const form_control_1 = require("./form-control.js");
 const image_1 = require("./image.js");
+const pivot_chart_1 = require("./pivot-chart.js");
 const pivot_table_1 = require("./pivot-table.js");
 const range_1 = require("./range.js");
 const row_1 = require("./row.js");
+const sparkline_1 = require("./sparkline/index.js");
 const table_1 = require("./table.js");
 const address_1 = require("./utils/address.js");
 const cell_format_1 = require("./utils/cell-format.js");
@@ -99,6 +107,9 @@ class Worksheet {
         this.autoFilter = options.autoFilter ?? null;
         // for images, etc
         this._media = [];
+        // for charts
+        this._charts = [];
+        this._sparklineGroups = [];
         // worksheet protection
         this.sheetProtection = null;
         // for tables
@@ -109,6 +120,8 @@ class Worksheet {
         this.formControls = [];
         // ignored errors (suppress green triangles in Excel)
         this.ignoredErrors = [];
+        // Office 365 threaded comments (separate from classic VML notes).
+        this.threadedComments = [];
         // watermark configuration
         this._watermark = null;
     }
@@ -122,34 +135,15 @@ class Worksheet {
         if (this._name === name) {
             return;
         }
-        if (typeof name !== "string") {
-            throw new errors_1.WorksheetNameError("The name has to be a string.");
-        }
-        if (name === "") {
-            throw new errors_1.WorksheetNameError("The name can't be empty.");
-        }
-        if (name === "History") {
-            throw new errors_1.WorksheetNameError('The name "History" is protected. Please use a different name.');
-        }
-        // Illegal character in worksheet name: asterisk (*), question mark (?),
-        // colon (:), forward slash (/ \), or bracket ([])
-        if (/[*?:/\\[\]]/.test(name)) {
-            throw new errors_1.WorksheetNameError(`Worksheet name ${name} cannot include any of the following characters: * ? : \\ / [ ]`);
-        }
-        if (/(^')|('$)/.test(name)) {
-            throw new errors_1.WorksheetNameError(`The first or last character of worksheet name cannot be a single quotation mark: ${name}`);
-        }
-        if (name.length > 31) {
-            if (process.env.NODE_ENV !== "production") {
-                console.warn(`Worksheet name ${name} exceeds 31 chars. This will be truncated`);
-            }
-            name = name.substring(0, 31);
-        }
-        const nameLower = name.toLowerCase();
-        if (this._workbook.worksheets.find(ws => ws && ws !== this && ws.name.toLowerCase() === nameLower)) {
-            throw new errors_1.WorksheetNameError(`Worksheet name already exists: ${name}`);
-        }
-        this._name = name;
+        // Delegate to the workbook-level validator so both worksheets and
+        // chartsheets share a single naming namespace. Previously this
+        // setter only cross-checked against other worksheets, allowing a
+        // chartsheet named "S" to coexist with a worksheet named "S";
+        // Excel itself forbids that collision. `validateSheetName`
+        // performs the full type / empty / illegal-char / quote / length
+        // / case-insensitive duplicate checks and returns the sanitised
+        // name (truncated to 31 chars if needed).
+        this._name = this._workbook.validateSheetName(name, this);
     }
     /**
      * The workbook that contains this worksheet
@@ -319,6 +313,8 @@ class Worksheet {
                     }
                 }
             }
+            // account for chart anchors in drawing and programmatic chart objects
+            this._shiftChartAnchors("col", start - 1, nExpand);
         }
         // account for merges
         this._spliceMerges("col", start, count, inserts.length);
@@ -661,6 +657,8 @@ class Worksheet {
                     }
                 }
             }
+            // account for chart anchors in drawing and programmatic chart objects
+            this._shiftChartAnchors("row", start - 1, nExpand);
         }
         // account for merges
         this._spliceMerges("row", start, count, nInserts);
@@ -779,6 +777,39 @@ class Worksheet {
             delete this._merges[master.address];
         }
     }
+    /**
+     * Shift all chart anchors (drawing anchors + programmatic charts) by delta along an axis.
+     * @param axis "row" or "col"
+     * @param threshold 0-based index; anchors at or beyond this are shifted
+     * @param delta number of positions to shift (positive = expand, negative = shrink)
+     */
+    _shiftChartAnchors(axis, threshold, delta) {
+        const prop = axis === "row" ? "nativeRow" : "nativeCol";
+        // Drawing anchors (from loaded file)
+        const drawing = this._drawing;
+        if (drawing?.anchors) {
+            for (const anchor of drawing.anchors) {
+                const tl = anchor.range?.tl;
+                const br = anchor.range?.br;
+                if (tl && tl[prop] >= threshold) {
+                    tl[prop] = Math.max(0, tl[prop] + delta);
+                }
+                if (br && br[prop] >= threshold) {
+                    br[prop] = Math.max(0, br[prop] + delta);
+                }
+            }
+        }
+        // Programmatic chart objects
+        for (const chart of this._charts) {
+            const { tl, br } = chart.range;
+            if (tl[prop] >= threshold) {
+                tl[prop] = Math.max(0, tl[prop] + delta);
+            }
+            if (br && br[prop] >= threshold) {
+                br[prop] = Math.max(0, br[prop] + delta);
+            }
+        }
+    }
     /**
      * Update _merges dictionary and cell-level merge references after a row or column splice.
      */
@@ -970,6 +1001,300 @@ class Worksheet {
     getImages() {
         return this._media.filter(m => m.type === "image");
     }
+    // ===========================================================================
+    // Charts
+    // ===========================================================================
+    /**
+     * Add a chart to the worksheet, positioned at the given range.
+     * Returns the chart number (1-based) that identifies this chart in the workbook.
+     */
+    addChart(options, range) {
+        const chart = (0, chart_host_registry_1.getChartSupport)();
+        return this._registerChart(chart.buildChartModel(options), range, options);
+    }
+    addColumnChart(options, range) {
+        return this.addChart({ ...options, type: "bar", barDir: "col" }, range);
+    }
+    addBarChart(options, range) {
+        return this.addChart({ ...options, type: "bar", barDir: "bar" }, range);
+    }
+    addLineChart(options, range) {
+        return this.addChart({ ...options, type: "line" }, range);
+    }
+    addAreaChart(options, range) {
+        return this.addChart({ ...options, type: "area" }, range);
+    }
+    addPieChart(options, range) {
+        return this.addChart({ ...options, type: "pie" }, range);
+    }
+    addDoughnutChart(options, range) {
+        return this.addChart({ ...options, type: "doughnut" }, range);
+    }
+    addScatterChart(options, range) {
+        return this.addChart({ ...options, type: "scatter" }, range);
+    }
+    addBubbleChart(options, range) {
+        return this.addChart({ ...options, type: "bubble" }, range);
+    }
+    addRadarChart(options, range) {
+        return this.addChart({ ...options, type: "radar" }, range);
+    }
+    addStockChart(options, range) {
+        return this.addChart({ ...options, type: "stock" }, range);
+    }
+    addSurfaceChart(options, range) {
+        return this.addChart({ ...options, type: "surface" }, range);
+    }
+    addHistogramChart(options, range) {
+        return this.addChartEx({ ...options, type: "histogram" }, range);
+    }
+    addParetoChart(options, range) {
+        return this.addChartEx({ ...options, type: "pareto" }, range);
+    }
+    addWaterfallChart(options, range) {
+        return this.addChartEx({ ...options, type: "waterfall" }, range);
+    }
+    addFunnelChart(options, range) {
+        return this.addChartEx({ ...options, type: "funnel" }, range);
+    }
+    addTreemapChart(options, range) {
+        return this.addChartEx({ ...options, type: "treemap" }, range);
+    }
+    addSunburstChart(options, range) {
+        return this.addChartEx({ ...options, type: "sunburst" }, range);
+    }
+    addBoxWhiskerChart(options, range) {
+        return this.addChartEx({ ...options, type: "boxWhisker" }, range);
+    }
+    addRegionMapChart(options, range) {
+        return this.addChartEx({ ...options, type: "regionMap" }, range);
+    }
+    addPresetChart(preset, options, range) {
+        return this.addChart((0, chart_host_registry_1.getChartSupport)().applyChartPreset(preset, options), range);
+    }
+    addPresetChartEx(preset, options, range) {
+        return this.addChartEx((0, chart_host_registry_1.getChartSupport)().applyChartExPreset(preset, options), range);
+    }
+    seriesFromColumns(options) {
+        return (0, chart_host_registry_1.getChartSupport)().seriesFromColumns(this.name, options);
+    }
+    addChartFromTable(table, options, range) {
+        return this.addChart((0, chart_host_registry_1.getChartSupport)().chartOptionsFromTable(this, table, options), range);
+    }
+    addChartFromRows(rows, options, range) {
+        return this.addChart((0, chart_host_registry_1.getChartSupport)().chartOptionsFromRows(this, rows, options), range);
+    }
+    addColumnChartFromRows(rows, options, range) {
+        return this.addChart((0, chart_host_registry_1.getChartSupport)().chartOptionsFromRows(this, rows, {
+            ...options,
+            type: "bar",
+            barDir: "col"
+        }), range);
+    }
+    /**
+     * Add a chartEx chart whose data references come from a worksheet Table.
+     * Mirrors {@link addChartFromTable} for the modern `cx:` chart types
+     * (sunburst, treemap, waterfall, funnel, histogram, pareto, boxWhisker).
+     * `regionMap` is not supported through this helper because its data
+     * model expects geographic labels — use {@link addChartEx} directly.
+     */
+    addChartExFromTable(table, options, range) {
+        return this.addChartEx((0, chart_host_registry_1.getChartSupport)().chartExOptionsFromTable(this, table, options), range);
+    }
+    /**
+     * Add a chartEx chart whose rows come from a plain object-array, staged
+     * into the worksheet before being referenced by absolute range. Mirrors
+     * {@link addChartFromRows} for the modern `cx:` chart types.
+     */
+    addChartExFromRows(rows, options, range) {
+        return this.addChartEx((0, chart_host_registry_1.getChartSupport)().chartExOptionsFromRows(this, rows, options), range);
+    }
+    /**
+     * Add a classic pivot chart linked to an existing pivot table.
+     * Returns the chart number (1-based) that identifies this chart in the workbook.
+     */
+    addPivotChart(pivotTable, options, range) {
+        const pivotChartOptions = (0, pivot_chart_1.withPivotChartSource)(pivotTable, options);
+        return this._registerChart((0, chart_host_registry_1.getChartSupport)().buildChartModel(pivotChartOptions), range, pivotChartOptions);
+    }
+    /**
+     * Add a combo pivot chart linked to an existing pivot table.
+     * Returns the chart number (1-based) that identifies this chart in the workbook.
+     */
+    addPivotComboChart(pivotTable, options, range) {
+        const pivotChartOptions = (0, pivot_chart_1.withPivotChartSource)(pivotTable, options);
+        return this._registerChart((0, chart_host_registry_1.getChartSupport)().buildComboChartModel(pivotChartOptions), range, pivotChartOptions);
+    }
+    /**
+     * Add a combo chart (multiple chart type groups) to the worksheet.
+     * Returns the chart number (1-based) that identifies this chart in the workbook.
+     */
+    addComboChart(options, range) {
+        return this._registerChart((0, chart_host_registry_1.getChartSupport)().buildComboChartModel(options), range, options);
+    }
+    /**
+     * Add a ChartEx (Office 2016+ extended chart) to the worksheet.
+     *
+     * Supported types: `sunburst`, `treemap`, `waterfall`, `funnel`, `histogram`,
+     * `pareto`, `boxWhisker`, `regionMap`.
+     *
+     * Returns the chartEx number (1-based) that identifies this chart in the workbook.
+     */
+    addChartEx(options, range) {
+        const model = (0, chart_host_registry_1.getChartSupport)().buildChartExModel(options);
+        return this._registerChartEx(model, range);
+    }
+    /** @internal Register a built chartEx model into the workbook and this worksheet. */
+    _registerChartEx(model, range) {
+        const chart = (0, chart_host_registry_1.getChartSupport)();
+        const chartExNumber = this._workbook.nextChartExNumber();
+        try {
+            // Pass `this` as context worksheet so sheet-scoped defined names on
+            // this sheet take precedence over workbook-scoped names of the same
+            // bare name (matches Excel resolution order).
+            chart.fillChartExCaches(model, this._workbook, this);
+        }
+        catch {
+            // Cache population is best-effort; never let it break chart creation.
+        }
+        this._workbook.addChartExStructuredEntry({ chartExNumber, model });
+        const chartInstance = chart.createChart(this, { chartExNumber }, range);
+        this._charts.push(chartInstance);
+        return chartExNumber;
+    }
+    /** @internal Register a built chart model into the workbook and this worksheet. */
+    _registerChart(chartModel, range, options) {
+        const chart = (0, chart_host_registry_1.getChartSupport)();
+        const chartNumber = this._workbook.nextChartNumber();
+        // Auto-populate caches so headless consumers see non-empty charts.
+        // Excel itself will recompute on open; this is a best-effort enrichment.
+        // Pass `this` as context worksheet so sheet-scoped defined names on
+        // this sheet take precedence over workbook-scoped names of the same
+        // bare name (matches Excel resolution order).
+        try {
+            chart.fillChartCaches(chartModel, this._workbook, this);
+        }
+        catch {
+            // Cache population is best-effort; never let it break chart creation.
+        }
+        const entry = { chartNumber, model: chartModel };
+        // Resolve any staged `pictureFill.image` payloads into real workbook
+        // media entries + chart relationships. Safe to call before
+        // `addChartEntry` so the entry we store already carries the final
+        // `entry.rels` array.
+        try {
+            chart.resolvePendingChartImages(entry, this._workbook, chartNumber);
+        }
+        catch {
+            // Image resolution is best-effort; a broken image payload should
+            // never take down chart creation — the series keeps its
+            // `pictureOptions`, just without the blipFill.
+        }
+        this._workbook.addChartEntry(entry);
+        this._applyChartSidecars(chartNumber, options);
+        const chartInstance = chart.createChart(this, { chartNumber }, range);
+        this._charts.push(chartInstance);
+        return chartNumber;
+    }
+    _applyChartSidecars(chartNumber, options) {
+        if (!options?.chartStyle && !options?.chartColors) {
+            return;
+        }
+        const chart = (0, chart_host_registry_1.getChartSupport)();
+        if (options?.chartStyle) {
+            this._workbook.setChartStyle(chartNumber, new TextEncoder().encode(chart.buildChartStyle(options.chartStyle)));
+        }
+        if (options?.chartColors) {
+            this._workbook.setChartColors(chartNumber, new TextEncoder().encode(chart.buildChartColors(options.chartColors)));
+        }
+    }
+    /**
+     * Get all charts embedded in this worksheet.
+     */
+    getCharts() {
+        return [...this._charts];
+    }
+    /**
+     * Remove a chart from this worksheet.
+     *
+     * @param chart - Either the chart object or its 0-based index in the worksheet.
+     * @returns `true` if a chart was removed, `false` otherwise.
+     */
+    removeChart(chart) {
+        const idx = typeof chart === "number" ? chart : this._charts.indexOf(chart);
+        if (idx < 0 || idx >= this._charts.length) {
+            return false;
+        }
+        const removed = this._charts.splice(idx, 1)[0];
+        if (removed.chartNumber > 0) {
+            this._workbook.removeChartEntry?.(removed.chartNumber);
+        }
+        if (removed.chartExNumber > 0) {
+            this._workbook.removeChartExStructuredEntry?.(removed.chartExNumber);
+        }
+        // Prune the matching anchor from the loaded drawing so the writer
+        // doesn't emit a dangling rel pointing at the now-removed chart
+        // part. The drawing xform regenerates rels from `drawing.anchors`
+        // on every write (see `worksheet-xform.ts` chart-anchor reconcile),
+        // so dropping the anchor here is sufficient — we don't need to
+        // hand-edit `drawing.rels` ourselves.
+        const drawing = this._drawing;
+        if (drawing?.anchors) {
+            drawing.anchors = drawing.anchors.filter(anchor => {
+                if (removed.chartNumber > 0 && anchor.chartNumber === removed.chartNumber) {
+                    return false;
+                }
+                if (removed.chartExNumber > 0 && anchor.chartExNumber === removed.chartExNumber) {
+                    return false;
+                }
+                return true;
+            });
+        }
+        return true;
+    }
+    // ===========================================================================
+    // Sparklines (x14:sparklineGroups)
+    // ===========================================================================
+    /**
+     * Add a sparkline group to this worksheet.
+     *
+     * A sparkline group is a collection of small in-cell charts sharing common
+     * styling. Sparklines are rendered via `x14:sparklineGroups` inside the
+     * worksheet extension list.
+     *
+     * @returns The newly added SparklineGroup for further modification.
+     */
+    addSparklineGroup(options) {
+        const group = (0, sparkline_1.buildSparklineGroup)(options);
+        this._sparklineGroups.push(group);
+        return group;
+    }
+    /** Get all sparkline groups on this worksheet. */
+    getSparklineGroups() {
+        return [...this._sparklineGroups];
+    }
+    /** @internal Used by the worksheet xform to access raw storage. */
+    get sparklineGroups() {
+        return this._sparklineGroups;
+    }
+    /** @internal Used when rebuilding from a parsed model. */
+    set sparklineGroups(value) {
+        this._sparklineGroups = value ?? [];
+    }
+    /**
+     * Remove a sparkline group.
+     *
+     * @param groupOrIndex - The group object or its 0-based index.
+     * @returns `true` if removed, `false` otherwise.
+     */
+    removeSparklineGroup(groupOrIndex) {
+        const idx = typeof groupOrIndex === "number" ? groupOrIndex : this._sparklineGroups.indexOf(groupOrIndex);
+        if (idx < 0 || idx >= this._sparklineGroups.length) {
+            return false;
+        }
+        this._sparklineGroups.splice(idx, 1);
+        return true;
+    }
     /**
      * Using the image id from `Workbook.addImage`, set the background to the worksheet
      */
@@ -1165,14 +1490,20 @@ class Worksheet {
         this.conditionalFormattings.push(cf);
     }
     /**
-     * Delete conditional formatting rules
+     * Delete conditional formatting rules.
+     *
+     * - When `filter` is a number, removes the rule at that index.
+     * - When `filter` is a function, removes every rule for which it returns `true`
+     *   (i.e. the predicate selects the rules to delete, not the ones to keep).
+     * - When `filter` is omitted/falsy, removes all rules.
      */
     removeConditionalFormatting(filter) {
         if (typeof filter === "number") {
             this.conditionalFormattings.splice(filter, 1);
         }
-        else if (filter instanceof Function) {
-            this.conditionalFormattings = this.conditionalFormattings.filter(filter);
+        else if (typeof filter === "function") {
+            // Keep entries for which the predicate returns false; drop the matches.
+            this.conditionalFormattings = this.conditionalFormattings.filter((value, index, array) => !filter(value, index, array));
         }
         else {
             this.conditionalFormattings = [];
@@ -1389,7 +1720,10 @@ class Worksheet {
             formControls: this.formControls.map(fc => fc.model),
             ignoredErrors: this.ignoredErrors,
             watermark: this._watermark,
-            drawing: this._drawing
+            drawing: this._drawing,
+            charts: this._charts.map(c => c.model),
+            sparklineGroups: this._sparklineGroups,
+            threadedComments: this.threadedComments
         };
         // =================================================
         // columns
@@ -1476,12 +1810,37 @@ class Worksheet {
             return tables;
         }, {});
         this.pivotTables = value.pivotTables;
+        for (const pivotTable of this.pivotTables ?? []) {
+            pivotTable.worksheetName ?? (pivotTable.worksheetName = this.name);
+            pivotTable.name ?? (pivotTable.name = `PivotTable${pivotTable.tableNumber}`);
+        }
         this.conditionalFormattings = value.conditionalFormattings;
         this.ignoredErrors = value.ignoredErrors ?? [];
-        // Form controls are currently write-only (not parsed from XLSX)
-        this.formControls = [];
+        this.threadedComments = value.threadedComments ?? [];
+        // Rebuild form controls from the serialised model so importSheet() and any
+        // other model round-trip preserves checkbox state, position, and links.
+        this.formControls = (value.formControls ?? []).map(fcModel => form_control_1.FormCheckbox.fromModel(this, fcModel));
         // Preserve loaded drawing data (charts, etc.)
         this._drawing = value.drawing;
+        // Restore chart objects from model (explicit charts array) or from drawing anchors.
+        // If chart support is not installed we still preserve the chart data inside
+        // `workbook.charts` entries (the serialiser reads from there), but we leave
+        // `_charts` empty because the `Chart` wrapper class lives in the optional
+        // chart module. Consumers who want to *manipulate* charts must install
+        // chart support; consumers doing pure load-save pass-through don't need to.
+        const chartHost = (0, chart_host_registry_1.tryGetChartSupport)();
+        if (chartHost && value.charts && value.charts.length > 0) {
+            this._charts = value.charts.map((c) => chartHost.createChart(this, { chartNumber: c.chartNumber, chartExNumber: c.chartExNumber }, c.range));
+        }
+        else if (chartHost && value.drawing?.anchors) {
+            // Extract chart anchors from drawing (loaded from XLSX)
+            this._charts = value.drawing.anchors
+                .filter((a) => a.chartNumber || a.chartExNumber)
+                .map((a) => chartHost.createChart(this, { chartNumber: a.chartNumber ?? 0, chartExNumber: a.chartExNumber ?? 0 }, a.range));
+        }
+        else {
+            this._charts = [];
+        }
     }
     toJSON(opts) {
         const o = opts || {};

package/dist/cjs/modules/excel/xlsx/rel-type.js

@@ -34,6 +34,46 @@ const RelType = {
      * relative to the current workbook's directory — exactly the behaviour users
      * expect from `=[测试.xlsx]Sheet1!A1`.
      */
-    ExternalLinkPath: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLinkPath"
+    ExternalLinkPath: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLinkPath",
+    Chart: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart",
+    ChartEx: "http://schemas.microsoft.com/office/2014/relationships/chartEx",
+    ChartStyle: "http://schemas.microsoft.com/office/2011/relationships/chartStyle",
+    ChartColors: "http://schemas.microsoft.com/office/2011/relationships/chartColorStyle",
+    Drawing: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing",
+    /**
+     * `c:userShapes` overlay drawing targeted from a chart rels file. OOXML
+     * treats this as a separate relationship type from regular worksheet
+     * drawings so the spec's schema for the two parts can diverge.
+     */
+    ChartUserShapes: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartUserShapes",
+    Chartsheet: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartsheet",
+    /**
+     * Office 365 threaded comments — the conversation tree for modern
+     * comments, kept alongside classic VML comments so older viewers still
+     * see the fallback text. From MS-XLSX ext spec (2018).
+     */
+    ThreadedComments: "http://schemas.microsoft.com/office/2017/10/relationships/threadedComment",
+    /**
+     * `xl/persons/person.xml` — the person directory referenced by
+     * threaded-comment `personId` fields. Workbook-level relationship.
+     */
+    Person: "http://schemas.microsoft.com/office/2017/10/relationships/person",
+    /**
+     * Slicer part reference from sheets. One per slicer definition.
+     */
+    Slicer: "http://schemas.microsoft.com/office/2007/relationships/slicer",
+    /**
+     * Slicer cache reference from workbook — each slicer points at a
+     * cache defining its filter state.
+     */
+    SlicerCache: "http://schemas.microsoft.com/office/2007/relationships/slicerCache",
+    /**
+     * Excel 2013+ timeline control (date-based slicer).
+     */
+    Timeline: "http://schemas.microsoft.com/office/2011/relationships/timeline",
+    /**
+     * Cache behind a timeline control.
+     */
+    TimelineCache: "http://schemas.microsoft.com/office/2011/relationships/timelineCache"
 };
 exports.RelType = RelType;

package/dist/cjs/modules/excel/xlsx/xform/book/defined-name-xform.js

@@ -11,11 +11,16 @@ class DefinedNamesXform extends base_xform_1.BaseXform {
         // <definedNames>
         //   <definedName name="name">text</definedName>
         //   <definedName name="_xlnm.Print_Area" localSheetId="0">text</definedName>
+        //   <definedName name="_xlchart.v1.0" hidden="1">Sheet1!$A$1:$A$3</definedName>
         // </definedNames>
-        xmlStream.openNode("definedName", {
+        const attrs = {
             name: model.name,
             localSheetId: model.localSheetId
-        });
+        };
+        if (model.hidden) {
+            attrs.hidden = 1;
+        }
+        xmlStream.openNode("definedName", attrs);
         // For opaque names, write the rawText verbatim to preserve round-trip fidelity.
         // For reference/formula names, join the ranges array as before.
         if (model.kind === "opaque" && model.rawText) {
@@ -31,6 +36,7 @@ class DefinedNamesXform extends base_xform_1.BaseXform {
             case "definedName":
                 this._parsedName = node.attributes.name;
                 this._parsedLocalSheetId = node.attributes.localSheetId;
+                this._parsedHidden = node.attributes.hidden;
                 this._parsedText = [];
                 return true;
             default:
@@ -55,6 +61,9 @@ class DefinedNamesXform extends base_xform_1.BaseXform {
         if (this._parsedLocalSheetId !== undefined) {
             model.localSheetId = parseInt(this._parsedLocalSheetId, 10);
         }
+        if (this._parsedHidden === "1" || this._parsedHidden === "true") {
+            model.hidden = true;
+        }
         this.model = model;
         return false;
     }