@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/types/modules/excel/workbook.d.ts

@@ -3,10 +3,52 @@
  *
  * Extends browser Workbook with Node.js file system support for CSV and Markdown operations.
  */
+import { type WorkbookReaderOptions, type NodeInput } from "./stream/workbook-reader.js";
+import type { WorkbookReader as WorkbookReaderBrowser } from "./stream/workbook-reader.browser.js";
+import { type WorkbookWriterOptions } from "./stream/workbook-writer.js";
+import type { WorkbookWriter as WorkbookWriterBrowser } from "./stream/workbook-writer.browser.js";
 import { Workbook as WorkbookBrowser, type CsvOptions } from "./workbook.browser.js";
 import type { Worksheet } from "./worksheet.js";
+import { XLSX } from "./xlsx/xlsx.js";
 import type { MarkdownOptions } from "../markdown/types.js";
 declare class Workbook extends WorkbookBrowser {
+    private _xlsxNode?;
+    /**
+     * 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(): XLSX;
+    /**
+     * 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?: WorkbookWriterOptions): WorkbookWriterBrowser;
+    /**
+     * 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: NodeInput, options?: WorkbookReaderOptions): WorkbookReaderBrowser;
     /**
      * Read CSV from file (Node.js only)
      *
@@ -61,3 +103,4 @@ declare class Workbook extends WorkbookBrowser {
 }
 export { Workbook };
 export type { CsvOptions, CsvInput, WorkbookModel, WorkbookMedia, WorkbookProtectionModel, ExternalLinkModel, ExternalLinkCachedSheet } from "./workbook.browser.js";
+export type { AddChartsheetOptions, AddPivotChartsheetOptions, ChartsheetOptions, ChartsheetViewOptions } from "./chartsheet.js";

package/dist/types/modules/excel/worksheet.d.ts

@@ -1,4 +1,10 @@
 import type { Cell, FormulaResult } from "./cell.js";
+import type { ChartSupport } from "./chart-host-registry.js";
+import type { Chart, ChartAnchorModel } from "./chart/chart.js";
+import type { AddChartExFromRowsOptions, AddChartExFromTableOptions, AddChartFromRowsOptions, AddChartFromTableOptions, SeriesFromColumnsOptions } from "./chart/chart-api.js";
+import type { AddChartExOptions } from "./chart/chart-ex-types.js";
+import type { ExcelChartExPreset, ExcelChartPreset } from "./chart/chart-presets.js";
+import type { AddBarChartOptions, AddChartOptions, AddChartRange, AddComboChartOptions, AddPieChartOptions, AddScatterChartOptions, AddSurfaceChartOptions } from "./chart/types.js";
 import { Column, type ColumnModel, type ColumnDefn } from "./column.js";
 import { DataValidations } from "./data-validations.js";
 import { FormCheckbox, type FormCheckboxModel, type FormCheckboxOptions, type FormControlRange } from "./form-control.js";
@@ -6,8 +12,9 @@ import { Image, type ImageModel } from "./image.js";
 import { type PivotTable, type PivotTableModel } from "./pivot-table.js";
 import { Range, type RangeInput } from "./range.js";
 import { Row, type RowModel } from "./row.js";
+import type { AddSparklineGroupOptions, SparklineGroup } from "./sparkline/index.js";
 import { Table, type TableModel } from "./table.js";
-import type { AddImageRange, AutoFilter, CellValue, ColBreak, ConditionalFormattingOptions, DataValidation, IgnoredError, RowBreak, RowValues, TableProperties, WatermarkOptions, WorksheetProperties, WorksheetState, WorksheetView } from "./types.js";
+import type { AddImageRange, AutoFilter, CellValue, ColBreak, ConditionalFormattingOptions, DataValidation, IgnoredError, RowBreak, RowValues, TableProperties, ThreadedComment, WatermarkOptions, WorksheetProperties, WorksheetState, WorksheetView } from "./types.js";
 import { type Origin } from "./utils/address.js";
 import type { Workbook } from "./workbook.js";
 type DataValidationModel = {
@@ -116,6 +123,19 @@ interface WorksheetModel {
     mergeCells?: string[];
     /** Loaded drawing data (for charts, etc.) - preserved for round-trip */
     drawing?: unknown;
+    /** Chart anchor models for worksheet charts */
+    charts?: ChartAnchorModel[];
+    /** Sparkline groups (x14:sparklineGroups) */
+    sparklineGroups?: SparklineGroup[];
+    /**
+     * Office 365 threaded comments for this worksheet. Rendered as a
+     * separate `xl/threadedComments/threadedComment{N}.xml` part. Empty
+     * when the sheet has no modern comments.
+     */
+    threadedComments?: Array<{
+        ref: string;
+        comment: ThreadedComment;
+    }>;
 }
 declare class Worksheet {
     private _workbook;
@@ -136,6 +156,8 @@ declare class Worksheet {
     views: Partial<WorksheetView>[];
     autoFilter: AutoFilter | null;
     private _media;
+    private _charts;
+    private _sparklineGroups;
     sheetProtection: SheetProtection | null;
     tables: {
         [key: string]: Table;
@@ -144,6 +166,23 @@ declare class Worksheet {
     conditionalFormattings: ConditionalFormattingOptions[];
     formControls: FormCheckbox[];
     ignoredErrors: IgnoredError[];
+    /**
+     * Office 365 threaded comments attached to this sheet, keyed by
+     * cell reference. Each cell may carry a linear conversation (a
+     * top-level comment followed by replies whose `parentId` points at
+     * the top-level entry). Round-tripped verbatim on load; mutating
+     * the array triggers a fresh `xl/threadedComments/threadedComment{N}.xml`
+     * on save.
+     *
+     * Distinct from (and can coexist with) classic VML notes — modern
+     * Excel shows threaded comments in the conversation pane, classic
+     * VML in the tooltip. When both are present the threaded text is
+     * authoritative.
+     */
+    threadedComments: Array<{
+        ref: string;
+        comment: ThreadedComment;
+    }>;
     private _headerRowCount?;
     /** Loaded drawing data (for charts, etc.) - preserved for round-trip */
     private _drawing;
@@ -288,6 +327,13 @@ declare class Worksheet {
     mergeCellsWithoutStyle(...cells: RangeInput[]): void;
     private _mergeCellsInternal;
     private _unMergeMaster;
+    /**
+     * 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)
+     */
+    private _shiftChartAnchors;
     /**
      * Update _merges dictionary and cell-level merge references after a row or column splice.
      */
@@ -306,6 +352,109 @@ declare class Worksheet {
      */
     addImage(imageId: string | number, range: AddImageRange): void;
     getImages(): Image[];
+    /**
+     * 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: AddChartOptions, range: AddChartRange): number;
+    addColumnChart(options: Omit<AddBarChartOptions, "type" | "barDir">, range: AddChartRange): number;
+    addBarChart(options: Omit<AddBarChartOptions, "type" | "barDir">, range: AddChartRange): number;
+    addLineChart(options: Omit<AddChartOptions, "type">, range: AddChartRange): number;
+    addAreaChart(options: Omit<AddChartOptions, "type">, range: AddChartRange): number;
+    addPieChart(options: Omit<AddPieChartOptions, "type">, range: AddChartRange): number;
+    addDoughnutChart(options: Omit<AddPieChartOptions, "type">, range: AddChartRange): number;
+    addScatterChart(options: Omit<AddScatterChartOptions, "type">, range: AddChartRange): number;
+    addBubbleChart(options: Omit<AddChartOptions, "type">, range: AddChartRange): number;
+    addRadarChart(options: Omit<AddChartOptions, "type">, range: AddChartRange): number;
+    addStockChart(options: Omit<AddChartOptions, "type">, range: AddChartRange): number;
+    addSurfaceChart(options: Omit<AddSurfaceChartOptions, "type">, range: AddChartRange): number;
+    addHistogramChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addParetoChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addWaterfallChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addFunnelChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addTreemapChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addSunburstChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addBoxWhiskerChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addRegionMapChart(options: Omit<AddChartExOptions, "type">, range: AddChartRange): number;
+    addPresetChart(preset: ExcelChartPreset, options: Omit<AddChartOptions, "type"> & Partial<Pick<AddChartOptions, "type">>, range: AddChartRange): number;
+    addPresetChartEx(preset: ExcelChartExPreset, options: Omit<AddChartExOptions, "type"> & Partial<Pick<AddChartExOptions, "type">>, range: AddChartRange): number;
+    seriesFromColumns(options: SeriesFromColumnsOptions): ReturnType<ChartSupport["seriesFromColumns"]>;
+    addChartFromTable(table: Table | string, options: AddChartFromTableOptions, range: AddChartRange): number;
+    addChartFromRows<T extends Record<string, unknown>>(rows: T[], options: AddChartFromRowsOptions<T>, range: AddChartRange): number;
+    addColumnChartFromRows<T extends Record<string, unknown>>(rows: T[], options: Omit<AddChartFromRowsOptions<T>, "type" | "barDir">, range: AddChartRange): number;
+    /**
+     * 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: Table | string, options: AddChartExFromTableOptions & {
+        type: Exclude<AddChartExOptions["type"], "regionMap">;
+    }, range: AddChartRange): number;
+    /**
+     * 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<T extends Record<string, unknown>>(rows: T[], options: AddChartExFromRowsOptions<T> & {
+        type: Exclude<AddChartExOptions["type"], "regionMap">;
+    }, range: AddChartRange): number;
+    /**
+     * 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: PivotTable, options: AddChartOptions, range: AddChartRange): number;
+    /**
+     * 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: PivotTable, options: AddComboChartOptions, range: AddChartRange): number;
+    /**
+     * 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: AddComboChartOptions, range: AddChartRange): number;
+    /**
+     * 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: AddChartExOptions, range: AddChartRange): number;
+    private _applyChartSidecars;
+    /**
+     * Get all charts embedded in this worksheet.
+     */
+    getCharts(): Chart[];
+    /**
+     * 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: Chart | number): boolean;
+    /**
+     * 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: AddSparklineGroupOptions): SparklineGroup;
+    /** Get all sparkline groups on this worksheet. */
+    getSparklineGroups(): SparklineGroup[];
+    /**
+     * Remove a sparkline group.
+     *
+     * @param groupOrIndex - The group object or its 0-based index.
+     * @returns `true` if removed, `false` otherwise.
+     */
+    removeSparklineGroup(groupOrIndex: SparklineGroup | number): boolean;
     /**
      * Using the image id from `Workbook.addImage`, set the background to the worksheet
      */
@@ -402,9 +551,14 @@ declare class Worksheet {
      */
     addConditionalFormatting(cf: ConditionalFormattingOptions): void;
     /**
-     * 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: number | ((value: ConditionalFormattingOptions, index: number, array: ConditionalFormattingOptions[]) => boolean)): void;
+    removeConditionalFormatting(filter?: number | ((value: ConditionalFormattingOptions, index: number, array: ConditionalFormattingOptions[]) => boolean)): void;
     /**
      * Auto-fit a single column's width to its content.
      *

package/dist/types/modules/excel/xlsx/rel-type.d.ts

@@ -32,5 +32,45 @@ declare const RelType: {
      * expect from `=[测试.xlsx]Sheet1!A1`.
      */
     ExternalLinkPath: string;
+    Chart: string;
+    ChartEx: string;
+    ChartStyle: string;
+    ChartColors: string;
+    Drawing: string;
+    /**
+     * `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: string;
+    Chartsheet: string;
+    /**
+     * 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: string;
+    /**
+     * `xl/persons/person.xml` — the person directory referenced by
+     * threaded-comment `personId` fields. Workbook-level relationship.
+     */
+    Person: string;
+    /**
+     * Slicer part reference from sheets. One per slicer definition.
+     */
+    Slicer: string;
+    /**
+     * Slicer cache reference from workbook — each slicer points at a
+     * cache defining its filter state.
+     */
+    SlicerCache: string;
+    /**
+     * Excel 2013+ timeline control (date-based slicer).
+     */
+    Timeline: string;
+    /**
+     * Cache behind a timeline control.
+     */
+    TimelineCache: string;
 };
 export { RelType };

package/dist/types/modules/excel/xlsx/xform/book/defined-name-xform.d.ts

@@ -3,6 +3,7 @@ import { BaseXform } from "../base-xform.js";
 declare class DefinedNamesXform extends BaseXform {
     private _parsedName?;
     private _parsedLocalSheetId?;
+    private _parsedHidden?;
     private _parsedText;
     constructor();
     render(xmlStream: any, model: DefinedNameModel): void;

package/dist/types/modules/excel/xlsx/xform/chart/chart-space-xform.d.ts

@@ -0,0 +1,353 @@
+/**
+ * ChartSpaceXform — Full OOXML DrawingML Chart parser and renderer.
+ *
+ * Design: single class with state-stack SAX parsing. Shape properties
+ * (c:spPr) and text properties (c:txPr) are captured as raw XML strings
+ * for perfect round-trip fidelity. Structured access is provided for the
+ * most commonly used properties.
+ *
+ * The c: namespace is http://schemas.openxmlformats.org/drawingml/2006/chart
+ * The a: namespace is http://schemas.openxmlformats.org/drawingml/2006/main
+ * The r: namespace is http://schemas.openxmlformats.org/officeDocument/2006/relationships
+ */
+import type { ChartModel } from "../../../chart/types.js";
+import { BaseXform } from "../base-xform.js";
+import type { XmlSink } from "../../../../xml/types.js";
+declare class ChartSpaceXform extends BaseXform<ChartModel> {
+    private stateStack;
+    private rawCapture;
+    private textBuf;
+    private chartModel;
+    private chartData;
+    private plotArea;
+    private currentChartTypeGroup;
+    private currentSeries;
+    private currentAxis;
+    private currentTitle;
+    private currentLegend;
+    private currentDataLabels;
+    private currentDataLabelEntry;
+    private currentMarker;
+    private currentDataPoint;
+    private currentTrendline;
+    private currentErrorBars;
+    private currentNumRef;
+    private currentStrRef;
+    private currentNumLit;
+    private currentStrLit;
+    private currentNumCache;
+    private currentStrCache;
+    private currentLayout;
+    private currentManualLayout;
+    private currentView3D;
+    private currentUpDownBars;
+    private currentLegendEntry;
+    private currentDataTable;
+    private currentDisplayUnits;
+    private currentPivotFormat;
+    private currentTrendlineLbl;
+    private currentPictureOptions;
+    private currentPrintSettings;
+    private currentMultiLvlStrRef;
+    private currentLvl;
+    /** Tracks c:floor / c:sideWall / c:backWall context */
+    private currentFloorWall;
+    /** Tracks c:hiLowLines / c:dropLines / c:serLines context */
+    private currentLineContext;
+    /** Pending spPr captured inside a line context element */
+    private _pendingLineSpPr;
+    private rawXmlTarget;
+    /** Context hint for c:extLst routing */
+    private rawCaptureContext;
+    /** Whether we are currently inside c:plotArea during parsing */
+    private insidePlotArea;
+    private rawSpPrXml;
+    private rawTxPrXml;
+    get tag(): string;
+    reset(): void;
+    render(xmlStream: XmlSink, model?: ChartModel): void;
+    /**
+     * Render the chart-space-level `<c:extLst>` element, merging the raw XML
+     * captured at parse time (`m.extLst`) with any structured pivot chart
+     * metadata (`m.pivotOptions`).
+     *
+     * The two inputs live side by side for good reason:
+     *   - `m.extLst` holds extensions we do not structurally understand
+     *     (c15 filtered series, c16r2 markup, c16r5 axis-title rich text…).
+     *     These are byte-preserved verbatim for round-trip safety.
+     *   - `m.pivotOptions` is the structured view of the MS Office 2010+
+     *     `c14:pivotOptions` extension. The parser extracts it out of the
+     *     raw extLst precisely so editors can read/mutate it programmatically
+     *     without string surgery.
+     *
+     * Merge strategy: if `m.extLst` is present, splice the new c14 ext
+     * element before its closing `</c:extLst>`; otherwise create a fresh
+     * `<c:extLst>` wrapper containing just the c14 ext.
+     */
+    private _renderChartSpaceExtLst;
+    /**
+     * Serialise the Office 2014+ `c16:pivotOptions16` extension
+     * (`c:chartSpace/c:extLst/c:ext[uri={E28EC0CA-…}]`). Only the
+     * `showExpandCollapseFieldButtons` toggle is modelled here — Excel
+     * adds this block alongside {@link _buildC14PivotOptionsExt} to
+     * control the newer expand/collapse field-button affordances.
+     *
+     * Returns `""` when nothing needs to be written so the caller can
+     * omit the extension entirely.
+     */
+    private _buildC16PivotOptions16Ext;
+    /**
+     * Serialise a {@link PivotChartOptions} as the `c:ext` wrapper Excel
+     * expects:
+     *
+     * ```xml
+     * <c:ext uri="{…}" xmlns:c14="http://schemas.microsoft.com/office/drawing/2007/8/2/chart">
+     *   <c14:pivotOptions>
+     *     <c14:dropZoneFilter val="0"/>
+     *     …
+     *   </c14:pivotOptions>
+     * </c:ext>
+     * ```
+     *
+     * The `uri` attribute is the well-known identifier for the c14 pivot
+     * options extension (see MS-XLSX §2.3.11). Excel 2010+ uses this URI as
+     * the key when deciding whether to honour the extension.
+     */
+    private _buildC14PivotOptionsExt;
+    private _renderChart;
+    private _renderView3D;
+    private _renderPlotArea;
+    private _renderChartTypeGroup;
+    private _renderBarChart;
+    /**
+     * Render a 3-D bar chart per `CT_Bar3DChart`. The 3-D schema DROPS
+     * `overlap` and `serLines` (both 2-D-only) and ADDS `gapDepth` and
+     * `shape`. The child order differs from 2-D:
+     *
+     *   barDir, grouping?, varyColors?, ser*, dLbls?, gapWidth?,
+     *   gapDepth?, shape?, axId{3}.
+     *
+     * Previously the builder shared `_renderBarChart` with bar2D, which
+     * emitted `overlap` / `serLines` on bar3D (schema violation) and put
+     * `shape` before `gapDepth` (sequence violation — Excel tolerates it
+     * on read, strict validators reject).
+     */
+    private _renderBar3DChart;
+    private _renderLineChart;
+    /**
+     * Render a 3-D line chart per `CT_Line3DChart`. Schema DROPS
+     * `hiLowLines`, `upDownBars`, `marker`, `smooth` (all 2-D-only) and
+     * ADDS `gapDepth`. Child order:
+     *
+     *   grouping, varyColors?, ser*, dLbls?, dropLines?, gapDepth?,
+     *   axId{3}.
+     *
+     * Previously the builder shared `_renderLineChart` with line2D,
+     * producing `<c:line3DChart>` with illegal children (most Excel-
+     * authored tools would still open the file, but strict validators
+     * reject it; more importantly, Excel's own read path silently
+     * ignored the illegal children, so the line3D chart lost its marker
+     * / smooth / up-down bars on round-trip).
+     */
+    private _renderLine3DChart;
+    private _renderPieChart;
+    /**
+     * Render `CT_DoughnutChart`. Child order matches the schema:
+     *   varyColors?, ser*, dLbls?, firstSliceAng?, holeSize?, extLst?.
+     *
+     * Excel's reader rejects `<c:dLblPos>` inside a doughnut chart's
+     * `<c:dLbls>` (both group-level and per-series). The Excel UI
+     * confirms this — the "Label Position" control is absent from the
+     * Format Data Labels panel for doughnut charts, whereas pie exposes
+     * center / inside end / outside end / best fit. Writing any
+     * `c:dLblPos` value (even `bestFit`) causes Excel to strip the
+     * entire `drawing1.xml` part on open with "Removed Part: Drawing
+     * shape".
+     *
+     * xlsxwriter hides this by forcibly nulling `labels["position"]`
+     * whenever the user-supplied position equals the chart's default
+     * ("best_fit" for pie/doughnut). That only masks the bug when the
+     * caller doesn't override the default; non-default positions still
+     * emit `c:dLblPos` and still break real-world doughnut files.
+     *
+     * The fix is to suppress `c:dLblPos` at serialisation time for
+     * doughnut — both in series `<c:dLbls>` and inside any per-point
+     * `<c:dLbl>` entries. `pie` and `ofPie` continue to emit it (they
+     * share `_renderPieSeries`, hence the explicit flag). The chart
+     * model still carries `position`, so SVG/PDF renderers keep using
+     * it for layout; only the XLSX writer filters it out.
+     */
+    private _renderDoughnutChart;
+    private _renderAreaChart;
+    private _renderScatterChart;
+    private _renderBubbleChart;
+    private _renderRadarChart;
+    private _renderStockChart;
+    private _renderSurfaceChart;
+    private _renderOfPieChart;
+    private _renderSeriesBase;
+    private _renderBarSeries;
+    private _renderLineSeries;
+    private _renderPieSeries;
+    private _renderAreaSeries;
+    private _renderScatterSeries;
+    private _renderBubbleSeries;
+    private _renderRadarSeries;
+    private _renderSurfaceSeries;
+    private _renderSeriesTx;
+    private _renderCatData;
+    private _renderValData;
+    private _renderNumRef;
+    private _renderStrRef;
+    private _renderNumCache;
+    private _renderStrCache;
+    private _renderNumLit;
+    private _renderStrLit;
+    private _renderMultiLvlStrRef;
+    private _renderMarker;
+    private _renderDataPoint;
+    /**
+     * Serialise a single {@link DataLabelEntry} as `<c:dLbl>…</c:dLbl>`.
+     * Shared between the series-level `<c:dLbls><c:dLbl/>` loop and
+     * pivot-format containers that emit a bare `<c:dLbl/>` without the
+     * enclosing `<c:dLbls>` wrapper.
+     */
+    private _renderDataLabelEntry;
+    private _renderDataLabels;
+    /**
+     * Serialise a {@link DataLabelsRange} as the `c:ext` wrapper Excel
+     * 2013+ expects:
+     *
+     * ```xml
+     * <c:ext uri="{CE6537A1-D6FC-4f65-9D91-7224C49458BB}"
+     *        xmlns:c15="http://schemas.microsoft.com/office/drawing/2012/chart">
+     *   <c15:datalabelsRange>
+     *     <c15:f>Sheet1!$A$1:$A$5</c15:f>
+     *     <c15:dlblRangeCache>
+     *       <c15:ptCount val="5"/>
+     *       <c15:pt idx="0"><c15:v>Label 1</c15:v></c15:pt>
+     *       …
+     *     </c15:dlblRangeCache>
+     *   </c15:datalabelsRange>
+     * </c:ext>
+     * ```
+     *
+     * The URI and child-element names are exactly what Excel emits —
+     * verified against a user-authored xlsx via
+     * `tmp/pivot-sample/xl/charts/chart1.xml` (the extension URI also
+     * appears as a placeholder inside `c:pivotFmt/c:dLbl`).
+     */
+    private _buildC15DataLabelsRangeExt;
+    private _renderTrendline;
+    private _renderErrorBars;
+    private _renderPictureOptions;
+    private _renderUpDownBars;
+    private _renderAxis;
+    private _renderTitle;
+    private _renderLegend;
+    private _renderLayout;
+    private _renderDataTable;
+    private _renderRichText;
+    private _renderBodyProperties;
+    private _renderParagraphProperties;
+    private _renderSpacing;
+    private _renderRunProperties;
+    private _renderSpPr;
+    /**
+     * Emit `<a:xfrm>` with optional `@rot` / `@flipH` / `@flipV` attributes
+     * and nested `<a:off>` / `<a:ext>`. Matches what `parseSpPr` captures in
+     * `shape-properties.ts`.
+     */
+    private _renderShapeTransform;
+    /**
+     * Emit `<a:prstGeom prst="…"><a:avLst>…</a:avLst></a:prstGeom>`. The
+     * `a:avLst` wrapper is always written (even when empty) to match Excel's
+     * own output; adjustments are optional inside.
+     */
+    private _renderPresetGeometry;
+    /**
+     * Emit `<a:custGeom>` with its adjustments list and the `<a:pathLst>`
+     * command stream. Commands map 1:1 to the DrawingML path command set
+     * (`moveTo` / `lnTo` / `arcTo` / `cubicBezTo` / `quadBezTo` / `close`);
+     * `arcTo` carries its parameters as attributes instead of control
+     * points, matching the parser.
+     */
+    private _renderCustomGeometry;
+    private _renderCustomGeometryCommand;
+    /**
+     * Render an `<a:blipFill>` element for a picture fill. The element is
+     * `<a:blipFill><a:blip r:embed="rIdN"/>[<a:srcRect …/>]<a:stretch …>
+     * or <a:tile …></a:blipFill>` matching the OOXML shape-fill subschema
+     * (DrawingML §20.1.8.14).
+     *
+     * Callers are responsible for making sure `blip.relationshipId` is
+     * populated — the writer no-ops when it is missing (see the comment
+     * at the call site in `_renderSpPr`).
+     */
+    private _renderBlipFill;
+    private _renderEffectList;
+    private _renderShadowElement;
+    private _renderScene3D;
+    private _renderSp3D;
+    private _renderTxPr;
+    private _renderColor;
+    private _renderPrintSettings;
+    parseOpen(node: any): boolean;
+    parseText(text: string): void;
+    parseClose(name: string): boolean;
+    private _createChartTypeGroup;
+    private _createAxis;
+    private _parseSeriesElement;
+    private _parseAxisElement;
+    private _handleValueClose;
+    private _attachNumRef;
+    private _attachStrRef;
+    private _attachNumLit;
+    private _attachStrLit;
+    private _attachMultiLvlStrRef;
+    private _findDataParent;
+    private _attachRawXml;
+    /**
+     * Parse the MS `c14:pivotOptions` extension out of a captured
+     * chartSpace-level `<c:extLst>` raw XML blob and populate
+     * {@link ChartModel.pivotOptions} with the structured view.
+     *
+     * Returns the raw XML with the matching `<c:ext uri="{781A…}" …/>`
+     * element removed so the writer does not emit it twice when it
+     * reconstructs the extLst from the merged (raw + structured) state.
+     * If the extension is absent, the input is returned unchanged.
+     *
+     * This function uses regex rather than a full XML parse because the
+     * raw blob is already guaranteed well-formed (it was emitted by our
+     * own raw-capture path) and we need to preserve byte exactness of the
+     * surviving `<c:ext>` elements for round-trip of extensions we do not
+     * understand.
+     */
+    private _extractChartSpaceExtLst;
+    /**
+     * Locate and remove a single `<c:ext uri="{…}">…</c:ext>` element
+     * whose `uri` matches `extUri`, passing the captured XML to
+     * `handler`. Returns the source string with the ext removed. When the
+     * ext is absent the input is returned unchanged.
+     */
+    private _extractAndStripPivotExt;
+    /**
+     * Parse and strip the MS `c15:datalabelsRange` extension (Excel 2013+
+     * "Value From Cells") from a captured `<c:dLbls>/<c:extLst>` raw XML
+     * blob, populating the structured {@link DataLabels.dataLabelsRange}
+     * slot on the given DataLabels object.
+     *
+     * Returns the raw XML with the matching ext element removed so the
+     * writer does not emit it twice when it reconstructs the extLst from
+     * the merged (raw + structured) state. If the extension is absent the
+     * input is returned unchanged.
+     */
+    private _extractDataLabelsExtLst;
+    private _setBoolOnLabels;
+    static CHART_SPACE_ATTRIBUTES: {
+        "xmlns:c": string;
+        "xmlns:a": string;
+        "xmlns:r": string;
+    };
+}
+export { ChartSpaceXform };