@devmm/puredocs-excel-charts 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TVE
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,226 @@
+# @devmm/puredocs-excel-charts
+
+> Chart support for [`@devmm/puredocs-excel`](../core). Generates valid OOXML chart
+> parts (column, bar, line, area, pie, doughnut, radar, scatter, bubble) and embeds
+> them into a workbook — no dependency other than the core package.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
+
+---
+
+## Install
+
+```bash
+npm install @devmm/puredocs-excel @devmm/puredocs-excel-charts
+```
+
+`@devmm/puredocs-excel` is a peer dependency.
+
+---
+
+## Quick start
+
+```typescript
+import { Workbook } from '@devmm/puredocs-excel';
+import { ExcelChart, ExcelChartType, ChartLegendPosition } from '@devmm/puredocs-excel-charts';
+
+const wb = Workbook.create();
+const sheet = wb.addWorksheet('Sales');
+
+sheet.getRange('A1:B5').setValues([
+  ['Month', 'Revenue'],
+  ['Jan', 120], ['Feb', 150], ['Mar', 130], ['Apr', 180],
+]);
+
+ExcelChart.create(ExcelChartType.ColumnClustered)
+  .setAnchor({ from: 'D2', to: 'K20' })
+  .setTitle('Monthly Revenue')
+  .addSeries({ name: 'Sales!$B$1', values: 'Sales!$B$2:$B$5', categories: 'Sales!$A$2:$A$5' })
+  .configureValueAxis(a => { a.numberFormat = '#,##0'; a.title = 'VND'; })
+  .configureLegend(l => { l.position = ChartLegendPosition.Bottom; })
+  .showDataLabels({ value: true })
+  .addTo(sheet);
+
+await wb.saveToFile('./report.xlsx');
+```
+
+> **Ranges must be absolute and sheet-qualified**, e.g. `Sheet1!$B$2:$B$5`.
+
+---
+
+## Chart types
+
+`ExcelChart.create(type)` accepts any [`ExcelChartType`](./src/chart-enums.ts):
+
+| Family | Types |
+|---|---|
+| Column / Bar | `ColumnClustered`, `ColumnStacked`, `BarClustered`, `BarStacked` |
+| Line | `Line`, `LineMarkers` |
+| Area | `Area` |
+| Pie | `Pie`, `Doughnut` |
+| Radar | `Radar`, `RadarMarkers`, `RadarFilled` |
+| XY | `Scatter`, `ScatterLines`, `ScatterSmooth`, `Bubble` |
+
+**Series data by family:**
+
+| Family | `categories` | `values` | `bubbleSize` |
+|---|---|---|---|
+| Column/Bar/Line/Area/Pie/Doughnut/Radar | X labels | Y values | — |
+| Scatter | X values | Y values | — |
+| Bubble | X values | Y values | bubble sizes |
+
+---
+
+## API
+
+### `ExcelChart.create(type): ExcelChart`
+
+Static factory. All configuration methods are fluent (return `this`).
+
+| Method | Description |
+|---|---|
+| `setAnchor(anchor)` | Position: `{ from: 'D2', to: 'K20' }` or `{ fromRow, fromCol, toRow, toCol }` (0-based) |
+| `setTitle(text)` | Chart title |
+| `addSeries(series)` | Add a data series (see [`ChartSeries`](#chartseries)) |
+| `configureLegend(fn)` | `fn(legend)` → set `legend.position` ([`ChartLegendPosition`](./src/chart-enums.ts)) |
+| `configureCategoryAxis(fn)` | `fn(axis)` → set title / numberFormat / min / max / majorGridlines |
+| `configureValueAxis(fn)` | Same, for the primary value axis |
+| `configureSecondaryValueAxis(fn)` | Same, for the secondary value axis (combo charts) |
+| `setSecondaryType(type)` | Chart type for `secondaryAxis` series (default `Line`) |
+| `showDataLabels(config?)` | Toggle labels: `{ value?, category?, series?, percent? }` (default `{ value: true }`) |
+| `setGapWidth(n)` | Bar/column gap width (%) |
+| `setHoleSize(pct)` | Doughnut hole size (10–90) |
+| `addTo(sheet)` | Attach to a `Worksheet` |
+
+### `ChartSeries`
+
+```typescript
+interface ChartSeries {
+  name?: string;                       // ref (contains '!') or literal
+  values: string;                      // Y range (absolute, sheet-qualified)
+  categories?: string;                 // X range / labels
+  bubbleSize?: string;                 // bubble charts only
+  color?: ExcelColor | string;         // '#RRGGBB' or ExcelColor
+  secondaryAxis?: boolean;             // plot on the secondary axis (combo)
+  trendline?: ChartTrendline;          // regression line
+  pointColors?: (ExcelColor | string)[]; // per-data-point colours
+}
+```
+
+### `ChartTrendline`
+
+```typescript
+interface ChartTrendline {
+  type: TrendlineType;   // Linear | Exponential | Logarithmic | MovingAverage | Polynomial | Power
+  order?: number;        // Polynomial order (2–6)
+  period?: number;       // MovingAverage period
+  displayEquation?: boolean;
+  displayRSquared?: boolean;
+}
+```
+
+---
+
+## Examples
+
+### Multi-series column with data labels
+
+```typescript
+ExcelChart.create(ExcelChartType.ColumnClustered)
+  .setTitle('Revenue vs Cost')
+  .addSeries({ name: 'Sales!$B$1', values: 'Sales!$B$2:$B$5', categories: 'Sales!$A$2:$A$5' })
+  .addSeries({ name: 'Sales!$C$1', values: 'Sales!$C$2:$C$5', categories: 'Sales!$A$2:$A$5' })
+  .showDataLabels({ value: true })
+  .addTo(sheet);
+```
+
+### Pie with per-slice colours and percentages
+
+```typescript
+ExcelChart.create(ExcelChartType.Pie)
+  .setTitle('Revenue share')
+  .addSeries({
+    values: 'Sales!$B$2:$B$5',
+    categories: 'Sales!$A$2:$A$5',
+    pointColors: ['#4472C4', '#ED7D31', '#A5A5A5', '#FFC000'],
+  })
+  .showDataLabels({ percent: true })
+  .addTo(sheet);
+```
+
+### Doughnut
+
+```typescript
+ExcelChart.create(ExcelChartType.Doughnut)
+  .setHoleSize(60)
+  .addSeries({ values: 'Sales!$B$2:$B$5', categories: 'Sales!$A$2:$A$5' })
+  .addTo(sheet);
+```
+
+### Scatter with a linear trendline
+
+```typescript
+import { TrendlineType } from '@devmm/puredocs-excel-charts';
+
+ExcelChart.create(ExcelChartType.Scatter)
+  .setTitle('Cost vs Revenue')
+  .addSeries({
+    name: 'corr',
+    categories: 'Sales!$C$2:$C$5',  // X
+    values: 'Sales!$B$2:$B$5',      // Y
+    trendline: { type: TrendlineType.Linear, displayEquation: true, displayRSquared: true },
+  })
+  .configureCategoryAxis(a => { a.title = 'Cost'; })
+  .configureValueAxis(a => { a.title = 'Revenue'; })
+  .addTo(sheet);
+```
+
+### Bubble
+
+```typescript
+ExcelChart.create(ExcelChartType.Bubble)
+  .addSeries({
+    categories: 'Data!$A$2:$A$6',   // X
+    values: 'Data!$B$2:$B$6',       // Y
+    bubbleSize: 'Data!$C$2:$C$6',
+  })
+  .addTo(sheet);
+```
+
+### Combo chart (column + line on a secondary axis)
+
+```typescript
+ExcelChart.create(ExcelChartType.ColumnClustered)
+  .setTitle('Revenue vs Margin')
+  .addSeries({ name: 'Data!$B$1', values: 'Data!$B$2:$B$6', categories: 'Data!$A$2:$A$6' })
+  .addSeries({ name: 'Data!$D$1', values: 'Data!$D$2:$D$6', categories: 'Data!$A$2:$A$6',
+    secondaryAxis: true, color: '#ED7D31' })
+  .setSecondaryType(ExcelChartType.LineMarkers)
+  .configureValueAxis(a => { a.title = 'VND'; a.numberFormat = '#,##0'; })
+  .configureSecondaryValueAxis(a => { a.title = 'Margin %'; a.numberFormat = '0"%"'; })
+  .addTo(sheet);
+```
+
+### Multiple charts on one sheet
+
+Call `.addTo(sheet)` several times — all charts are aggregated into a single drawing
+part automatically:
+
+```typescript
+ExcelChart.create(ExcelChartType.ColumnClustered).setAnchor({ from: 'E1', to: 'L16' })
+  .addSeries({ values: 'S!$B$2:$B$5', categories: 'S!$A$2:$A$5' }).addTo(sheet);
+ExcelChart.create(ExcelChartType.Line).setAnchor({ from: 'E18', to: 'L33' })
+  .addSeries({ values: 'S!$B$2:$B$5', categories: 'S!$A$2:$A$5' }).addTo(sheet);
+```
+
+---
+
+## Notes & limitations
+
+- Ranges are **not** validated against the worksheet; pass correct absolute refs.
+- Charts are **write-only** in this version — they are not read back when loading a file.
+- Not yet supported: error bars, 3D views. See [`DESIGN.md`](./DESIGN.md) for the roadmap.
+
+## License
+
+MIT © TVE

package/dist/index.cjs

@@ -0,0 +1,364 @@
+'use strict';
+
+var puredocsExcel = require('@devmm/puredocs-excel');
+
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/chart-enums.ts
+var ExcelChartType = /* @__PURE__ */ ((ExcelChartType2) => {
+  ExcelChartType2["ColumnClustered"] = "columnClustered";
+  ExcelChartType2["ColumnStacked"] = "columnStacked";
+  ExcelChartType2["BarClustered"] = "barClustered";
+  ExcelChartType2["BarStacked"] = "barStacked";
+  ExcelChartType2["Line"] = "line";
+  ExcelChartType2["LineMarkers"] = "lineMarkers";
+  ExcelChartType2["Area"] = "area";
+  ExcelChartType2["Pie"] = "pie";
+  ExcelChartType2["Doughnut"] = "doughnut";
+  ExcelChartType2["Radar"] = "radar";
+  ExcelChartType2["RadarMarkers"] = "radarMarkers";
+  ExcelChartType2["RadarFilled"] = "radarFilled";
+  ExcelChartType2["Scatter"] = "scatter";
+  ExcelChartType2["ScatterLines"] = "scatterLines";
+  ExcelChartType2["ScatterSmooth"] = "scatterSmooth";
+  ExcelChartType2["Bubble"] = "bubble";
+  return ExcelChartType2;
+})(ExcelChartType || {});
+var TrendlineType = /* @__PURE__ */ ((TrendlineType2) => {
+  TrendlineType2["Linear"] = "linear";
+  TrendlineType2["Exponential"] = "exp";
+  TrendlineType2["Logarithmic"] = "log";
+  TrendlineType2["MovingAverage"] = "movingAvg";
+  TrendlineType2["Polynomial"] = "poly";
+  TrendlineType2["Power"] = "power";
+  return TrendlineType2;
+})(TrendlineType || {});
+var ChartLegendPosition = /* @__PURE__ */ ((ChartLegendPosition2) => {
+  ChartLegendPosition2["Right"] = "r";
+  ChartLegendPosition2["Left"] = "l";
+  ChartLegendPosition2["Top"] = "t";
+  ChartLegendPosition2["Bottom"] = "b";
+  ChartLegendPosition2["TopRight"] = "tr";
+  ChartLegendPosition2["None"] = "none";
+  return ChartLegendPosition2;
+})(ChartLegendPosition || {});
+
+// src/excel-chart.ts
+var CHART_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+var CAT_AX_ID = 111111111;
+var VAL_AX_ID = 222222222;
+var SEC_VAL_AX_ID = 333333333;
+var SEC_CAT_AX_ID = 444444444;
+var CARTESIAN = /* @__PURE__ */ new Set(["barChart", "lineChart", "areaChart"]);
+function resolveFamily(type) {
+  const base = {
+    seriesKind: "category",
+    isPieLike: false,
+    hasAxes: true,
+    markers: false,
+    smooth: false,
+    colorAsLine: false,
+    catAxPos: "b",
+    valAxPos: "l"
+  };
+  switch (type) {
+    case "columnClustered" /* ColumnClustered */:
+      return { ...base, element: "barChart", barDir: "col", grouping: "clustered", overlap: -27 };
+    case "columnStacked" /* ColumnStacked */:
+      return { ...base, element: "barChart", barDir: "col", grouping: "stacked", overlap: 100 };
+    case "barClustered" /* BarClustered */:
+      return { ...base, element: "barChart", barDir: "bar", grouping: "clustered", overlap: -27, catAxPos: "l", valAxPos: "b" };
+    case "barStacked" /* BarStacked */:
+      return { ...base, element: "barChart", barDir: "bar", grouping: "stacked", overlap: 100, catAxPos: "l", valAxPos: "b" };
+    case "line" /* Line */:
+      return { ...base, element: "lineChart", grouping: "standard", colorAsLine: true };
+    case "lineMarkers" /* LineMarkers */:
+      return { ...base, element: "lineChart", grouping: "standard", markers: true, colorAsLine: true };
+    case "area" /* Area */:
+      return { ...base, element: "areaChart", grouping: "standard" };
+    case "pie" /* Pie */:
+      return { ...base, element: "pieChart", isPieLike: true, hasAxes: false };
+    case "doughnut" /* Doughnut */:
+      return { ...base, element: "doughnutChart", isPieLike: true, hasAxes: false, holeSize: 50 };
+    case "radar" /* Radar */:
+      return { ...base, element: "radarChart", radarStyle: "standard", colorAsLine: true };
+    case "radarMarkers" /* RadarMarkers */:
+      return { ...base, element: "radarChart", radarStyle: "marker", markers: true, colorAsLine: true };
+    case "radarFilled" /* RadarFilled */:
+      return { ...base, element: "radarChart", radarStyle: "filled" };
+    case "scatter" /* Scatter */:
+      return { ...base, element: "scatterChart", seriesKind: "xy", scatterStyle: "marker", markers: true, colorAsLine: true };
+    case "scatterLines" /* ScatterLines */:
+      return { ...base, element: "scatterChart", seriesKind: "xy", scatterStyle: "lineMarker", markers: true, colorAsLine: true };
+    case "scatterSmooth" /* ScatterSmooth */:
+      return { ...base, element: "scatterChart", seriesKind: "xy", scatterStyle: "smoothMarker", markers: true, smooth: true, colorAsLine: true };
+    case "bubble" /* Bubble */:
+      return { ...base, element: "bubbleChart", seriesKind: "bubble" };
+  }
+}
+function toSrgb(color) {
+  const raw = typeof color === "string" ? color : color.toXmlAttrs().rgb ?? "FF000000";
+  const hex = raw.replace(/[^0-9a-fA-F]/g, "");
+  return (hex.length >= 6 ? hex.slice(-6) : hex.padStart(6, "0")).toUpperCase();
+}
+function numRef(ref) {
+  return `<c:numRef><c:f>${puredocsExcel.escapeXml(ref)}</c:f></c:numRef>`;
+}
+function strRef(ref) {
+  return `<c:strRef><c:f>${puredocsExcel.escapeXml(ref)}</c:f></c:strRef>`;
+}
+var _type, _family, _secondaryType, _anchor, _title, _series, _legend, _categoryAxis, _valueAxis, _secondaryValueAxis, _dataLabels, _gapWidth, _holeSize, _ExcelChart_instances, hasSecondary_fn, buildPlotElement_fn, cartesianGroupXml_fn, seriesGroupXml_fn, buildSeriesXml_fn, buildDataPointsXml_fn, buildTrendlineXml_fn, seriesColorXml_fn, refOrLiteral_fn, buildDataLabelsXml_fn, buildAxesXml_fn, buildCatAx_fn, buildValAx_fn, buildTitleXml_fn;
+var _ExcelChart = class _ExcelChart {
+  constructor(type) {
+    __privateAdd(this, _ExcelChart_instances);
+    __privateAdd(this, _type);
+    __privateAdd(this, _family);
+    __privateAdd(this, _secondaryType, "line" /* Line */);
+    __privateAdd(this, _anchor, { fromCol: 0, fromRow: 0, toCol: 8, toRow: 15 });
+    __privateAdd(this, _title);
+    __privateAdd(this, _series, []);
+    __privateAdd(this, _legend, { position: "r" /* Right */ });
+    __privateAdd(this, _categoryAxis, {});
+    __privateAdd(this, _valueAxis, { majorGridlines: true });
+    __privateAdd(this, _secondaryValueAxis, {});
+    __privateAdd(this, _dataLabels);
+    __privateAdd(this, _gapWidth, 150);
+    __privateAdd(this, _holeSize);
+    __privateSet(this, _type, type);
+    __privateSet(this, _family, resolveFamily(type));
+    __privateSet(this, _holeSize, __privateGet(this, _family).holeSize);
+  }
+  /** Creates a chart of the given type. */
+  static create(type) {
+    return new _ExcelChart(type);
+  }
+  /** The chart type. */
+  get type() {
+    return __privateGet(this, _type);
+  }
+  // ── Fluent configuration ──────────────────────────────────────────────────
+  setAnchor(anchor) {
+    if ("from" in anchor) {
+      const f = puredocsExcel.parseCellRef(anchor.from);
+      const t = puredocsExcel.parseCellRef(anchor.to);
+      __privateSet(this, _anchor, { fromCol: f.column - 1, fromRow: f.row - 1, toCol: t.column - 1, toRow: t.row - 1 });
+    } else {
+      __privateSet(this, _anchor, { fromCol: anchor.fromCol, fromRow: anchor.fromRow, toCol: anchor.toCol, toRow: anchor.toRow });
+    }
+    return this;
+  }
+  setTitle(title) {
+    __privateSet(this, _title, title);
+    return this;
+  }
+  addSeries(series) {
+    __privateGet(this, _series).push(series);
+    return this;
+  }
+  configureLegend(fn) {
+    fn(__privateGet(this, _legend));
+    return this;
+  }
+  configureCategoryAxis(fn) {
+    fn(__privateGet(this, _categoryAxis));
+    return this;
+  }
+  configureValueAxis(fn) {
+    fn(__privateGet(this, _valueAxis));
+    return this;
+  }
+  configureSecondaryValueAxis(fn) {
+    fn(__privateGet(this, _secondaryValueAxis));
+    return this;
+  }
+  /** Chart type used for series flagged `secondaryAxis` (default `Line`). */
+  setSecondaryType(type) {
+    __privateSet(this, _secondaryType, type);
+    return this;
+  }
+  showDataLabels(config = { value: true }) {
+    __privateSet(this, _dataLabels, config);
+    return this;
+  }
+  setGapWidth(gapWidth) {
+    __privateSet(this, _gapWidth, gapWidth);
+    return this;
+  }
+  /** Doughnut hole size as a percentage (10–90). Ignored by non-doughnut charts. */
+  setHoleSize(percent) {
+    __privateSet(this, _holeSize, percent);
+    return this;
+  }
+  /** Attaches this chart to a worksheet. */
+  addTo(sheet) {
+    sheet.addDrawingProvider(this);
+    return this;
+  }
+  // ── DrawingProvider contract ──────────────────────────────────────────────
+  buildAnchorXml(relationshipId) {
+    const a = __privateGet(this, _anchor);
+    const frameId = parseInt(relationshipId.slice(3), 10) + 1;
+    return `<xdr:twoCellAnchor><xdr:from><xdr:col>${a.fromCol}</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>${a.fromRow}</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:from><xdr:to><xdr:col>${a.toCol}</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>${a.toRow}</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:to><xdr:graphicFrame macro=""><xdr:nvGraphicFramePr><xdr:cNvPr id="${frameId}" name="Chart ${frameId}"/><xdr:cNvGraphicFramePr/></xdr:nvGraphicFramePr><xdr:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/></xdr:xfrm><a:graphic><a:graphicData uri="${CHART_NS}"><c:chart xmlns:c="${CHART_NS}" xmlns:r="${puredocsExcel.NS.relationships}" r:id="${relationshipId}"/></a:graphicData></a:graphic></xdr:graphicFrame><xdr:clientData/></xdr:twoCellAnchor>`;
+  }
+  buildPart(partIndex) {
+    return {
+      path: `xl/charts/chart${partIndex}.xml`,
+      content: this.toChartXml(),
+      contentType: puredocsExcel.CONTENT_TYPES.chart,
+      relType: puredocsExcel.REL_TYPES.chart
+    };
+  }
+  /** Builds the full `xl/charts/chartN.xml` content. */
+  toChartXml() {
+    const titleXml = __privateGet(this, _title) ? `${__privateMethod(this, _ExcelChart_instances, buildTitleXml_fn).call(this, __privateGet(this, _title))}<c:autoTitleDeleted val="0"/>` : `<c:autoTitleDeleted val="1"/>`;
+    const plot = __privateMethod(this, _ExcelChart_instances, buildPlotElement_fn).call(this);
+    const axes = __privateGet(this, _family).hasAxes ? __privateMethod(this, _ExcelChart_instances, buildAxesXml_fn).call(this) : "";
+    const legend = __privateGet(this, _legend).position === "none" /* None */ ? "" : `<c:legend><c:legendPos val="${__privateGet(this, _legend).position}"/><c:overlay val="0"/></c:legend>`;
+    return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><c:chartSpace xmlns:c="${CHART_NS}" xmlns:a="${puredocsExcel.NS.drawingml}" xmlns:r="${puredocsExcel.NS.relationships}"><c:chart>` + titleXml + `<c:plotArea><c:layout/>` + plot + axes + `</c:plotArea>` + legend + `<c:plotVisOnly val="1"/><c:dispBlanksAs val="gap"/></c:chart></c:chartSpace>`;
+  }
+};
+_type = new WeakMap();
+_family = new WeakMap();
+_secondaryType = new WeakMap();
+_anchor = new WeakMap();
+_title = new WeakMap();
+_series = new WeakMap();
+_legend = new WeakMap();
+_categoryAxis = new WeakMap();
+_valueAxis = new WeakMap();
+_secondaryValueAxis = new WeakMap();
+_dataLabels = new WeakMap();
+_gapWidth = new WeakMap();
+_holeSize = new WeakMap();
+_ExcelChart_instances = new WeakSet();
+// ── Chart XML ─────────────────────────────────────────────────────────────
+/** True when a secondary-axis combo should be emitted. */
+hasSecondary_fn = function() {
+  return CARTESIAN.has(__privateGet(this, _family).element) && __privateGet(this, _series).some((s) => s.secondaryAxis);
+};
+buildPlotElement_fn = function() {
+  const fam = __privateGet(this, _family);
+  const el = fam.element;
+  const indexed = __privateGet(this, _series).map((s, idx) => ({ s, idx }));
+  const dLbls = __privateMethod(this, _ExcelChart_instances, buildDataLabelsXml_fn).call(this);
+  if (el === "pieChart") {
+    return `<c:pieChart><c:varyColors val="1"/>${__privateMethod(this, _ExcelChart_instances, seriesGroupXml_fn).call(this, indexed, fam)}${dLbls}<c:firstSliceAng val="0"/></c:pieChart>`;
+  }
+  if (el === "doughnutChart") {
+    return `<c:doughnutChart><c:varyColors val="1"/>${__privateMethod(this, _ExcelChart_instances, seriesGroupXml_fn).call(this, indexed, fam)}${dLbls}<c:firstSliceAng val="0"/><c:holeSize val="${__privateGet(this, _holeSize) ?? 50}"/></c:doughnutChart>`;
+  }
+  if (el === "radarChart") {
+    return `<c:radarChart><c:radarStyle val="${fam.radarStyle}"/><c:varyColors val="0"/>${__privateMethod(this, _ExcelChart_instances, seriesGroupXml_fn).call(this, indexed, fam)}${dLbls}<c:axId val="${CAT_AX_ID}"/><c:axId val="${VAL_AX_ID}"/></c:radarChart>`;
+  }
+  if (el === "scatterChart") {
+    return `<c:scatterChart><c:scatterStyle val="${fam.scatterStyle}"/><c:varyColors val="0"/>${__privateMethod(this, _ExcelChart_instances, seriesGroupXml_fn).call(this, indexed, fam)}${dLbls}<c:axId val="${CAT_AX_ID}"/><c:axId val="${VAL_AX_ID}"/></c:scatterChart>`;
+  }
+  if (el === "bubbleChart") {
+    return `<c:bubbleChart><c:varyColors val="0"/>${__privateMethod(this, _ExcelChart_instances, seriesGroupXml_fn).call(this, indexed, fam)}${dLbls}<c:bubbleScale val="100"/><c:showNegBubbles val="0"/><c:axId val="${CAT_AX_ID}"/><c:axId val="${VAL_AX_ID}"/></c:bubbleChart>`;
+  }
+  if (!__privateMethod(this, _ExcelChart_instances, hasSecondary_fn).call(this)) {
+    return __privateMethod(this, _ExcelChart_instances, cartesianGroupXml_fn).call(this, indexed, fam, CAT_AX_ID, VAL_AX_ID);
+  }
+  const primary = indexed.filter((e) => !e.s.secondaryAxis);
+  const secondary = indexed.filter((e) => e.s.secondaryAxis);
+  const secFam = resolveFamily(__privateGet(this, _secondaryType));
+  return __privateMethod(this, _ExcelChart_instances, cartesianGroupXml_fn).call(this, primary, fam, CAT_AX_ID, VAL_AX_ID) + __privateMethod(this, _ExcelChart_instances, cartesianGroupXml_fn).call(this, secondary, secFam, SEC_CAT_AX_ID, SEC_VAL_AX_ID);
+};
+cartesianGroupXml_fn = function(entries, fam, catId, valId) {
+  const el = fam.element;
+  const barDir = fam.barDir ? `<c:barDir val="${fam.barDir}"/>` : "";
+  const grouping = fam.grouping ? `<c:grouping val="${fam.grouping}"/>` : "";
+  const marker = el === "lineChart" ? `<c:marker val="${fam.markers ? 1 : 0}"/>` : "";
+  const barExtras = el === "barChart" ? `<c:gapWidth val="${__privateGet(this, _gapWidth)}"/>${fam.overlap !== void 0 ? `<c:overlap val="${fam.overlap}"/>` : ""}` : "";
+  return `<c:${el}>${barDir}${grouping}<c:varyColors val="0"/>${__privateMethod(this, _ExcelChart_instances, seriesGroupXml_fn).call(this, entries, fam)}${__privateMethod(this, _ExcelChart_instances, buildDataLabelsXml_fn).call(this)}${barExtras}${marker}<c:axId val="${catId}"/><c:axId val="${valId}"/></c:${el}>`;
+};
+seriesGroupXml_fn = function(entries, fam) {
+  return entries.map((e) => __privateMethod(this, _ExcelChart_instances, buildSeriesXml_fn).call(this, e.s, e.idx, fam)).join("");
+};
+buildSeriesXml_fn = function(s, idx, fam) {
+  const tx = s.name ? `<c:tx>${__privateMethod(this, _ExcelChart_instances, refOrLiteral_fn).call(this, s.name)}</c:tx>` : "";
+  const spPr = s.color ? __privateMethod(this, _ExcelChart_instances, seriesColorXml_fn).call(this, s.color, fam) : "";
+  const dPt = s.pointColors && s.pointColors.length ? __privateMethod(this, _ExcelChart_instances, buildDataPointsXml_fn).call(this, s.pointColors, fam) : "";
+  const trend = s.trendline ? __privateMethod(this, _ExcelChart_instances, buildTrendlineXml_fn).call(this, s.trendline) : "";
+  const marker = fam.markers ? `<c:marker><c:symbol val="circle"/><c:size val="5"/></c:marker>` : "";
+  if (fam.seriesKind === "xy") {
+    const xVal = s.categories ? `<c:xVal>${numRef(s.categories)}</c:xVal>` : "";
+    const yVal = `<c:yVal>${numRef(s.values)}</c:yVal>`;
+    const smooth2 = `<c:smooth val="${fam.smooth ? 1 : 0}"/>`;
+    return `<c:ser><c:idx val="${idx}"/><c:order val="${idx}"/>${tx}${spPr}${marker}${dPt}${trend}${xVal}${yVal}${smooth2}</c:ser>`;
+  }
+  if (fam.seriesKind === "bubble") {
+    const xVal = s.categories ? `<c:xVal>${numRef(s.categories)}</c:xVal>` : "";
+    const yVal = `<c:yVal>${numRef(s.values)}</c:yVal>`;
+    const bub = s.bubbleSize ? `<c:bubbleSize>${numRef(s.bubbleSize)}</c:bubbleSize>` : `<c:bubbleSize><c:numLit><c:formatCode>General</c:formatCode><c:ptCount val="0"/></c:numLit></c:bubbleSize>`;
+    return `<c:ser><c:idx val="${idx}"/><c:order val="${idx}"/>${tx}${spPr}${dPt}${trend}${xVal}${yVal}${bub}<c:bubble3D val="0"/></c:ser>`;
+  }
+  const catMarker = fam.element === "lineChart" || fam.element === "radarChart" ? marker : "";
+  const cat = s.categories ? `<c:cat>${strRef(s.categories)}</c:cat>` : "";
+  const val = `<c:val>${numRef(s.values)}</c:val>`;
+  const smooth = fam.element === "lineChart" ? `<c:smooth val="0"/>` : "";
+  return `<c:ser><c:idx val="${idx}"/><c:order val="${idx}"/>${tx}${spPr}${catMarker}${dPt}${trend}${cat}${val}${smooth}</c:ser>`;
+};
+buildDataPointsXml_fn = function(colors, fam) {
+  return colors.map((c, i) => `<c:dPt><c:idx val="${i}"/><c:bubble3D val="0"/>${__privateMethod(this, _ExcelChart_instances, seriesColorXml_fn).call(this, c, fam)}</c:dPt>`).join("");
+};
+buildTrendlineXml_fn = function(t) {
+  const order = t.type === "poly" /* Polynomial */ ? `<c:order val="${t.order ?? 2}"/>` : "";
+  const period = t.type === "movingAvg" /* MovingAverage */ ? `<c:period val="${t.period ?? 2}"/>` : "";
+  return `<c:trendline><c:trendlineType val="${t.type}"/>` + order + period + `<c:dispRSqr val="${t.displayRSquared ? 1 : 0}"/><c:dispEq val="${t.displayEquation ? 1 : 0}"/></c:trendline>`;
+};
+seriesColorXml_fn = function(color, fam) {
+  const fill = `<a:solidFill><a:srgbClr val="${toSrgb(color)}"/></a:solidFill>`;
+  return fam.colorAsLine ? `<c:spPr><a:ln w="28575">${fill}</a:ln></c:spPr>` : `<c:spPr>${fill}</c:spPr>`;
+};
+refOrLiteral_fn = function(name) {
+  return name.includes("!") ? strRef(name) : `<c:v>${puredocsExcel.escapeXml(name)}</c:v>`;
+};
+buildDataLabelsXml_fn = function() {
+  const d = __privateGet(this, _dataLabels);
+  if (!d) return "";
+  const flag = (b) => b ? 1 : 0;
+  return `<c:dLbls><c:showLegendKey val="0"/><c:showVal val="${flag(d.value)}"/><c:showCatName val="${flag(d.category)}"/><c:showSerName val="${flag(d.series)}"/><c:showPercent val="${flag(d.percent)}"/><c:showBubbleSize val="0"/></c:dLbls>`;
+};
+buildAxesXml_fn = function() {
+  const fam = __privateGet(this, _family);
+  if (fam.seriesKind !== "category") {
+    return __privateMethod(this, _ExcelChart_instances, buildValAx_fn).call(this, CAT_AX_ID, "b", VAL_AX_ID, __privateGet(this, _categoryAxis), {}) + __privateMethod(this, _ExcelChart_instances, buildValAx_fn).call(this, VAL_AX_ID, "l", CAT_AX_ID, __privateGet(this, _valueAxis), {});
+  }
+  let out = __privateMethod(this, _ExcelChart_instances, buildCatAx_fn).call(this, CAT_AX_ID, fam.catAxPos, VAL_AX_ID, __privateGet(this, _categoryAxis), {}) + __privateMethod(this, _ExcelChart_instances, buildValAx_fn).call(this, VAL_AX_ID, fam.valAxPos, CAT_AX_ID, __privateGet(this, _valueAxis), { crossBetween: "between" });
+  if (__privateMethod(this, _ExcelChart_instances, hasSecondary_fn).call(this)) {
+    out += __privateMethod(this, _ExcelChart_instances, buildValAx_fn).call(this, SEC_VAL_AX_ID, "r", SEC_CAT_AX_ID, __privateGet(this, _secondaryValueAxis), { crossBetween: "between", crosses: "max" }) + __privateMethod(this, _ExcelChart_instances, buildCatAx_fn).call(this, SEC_CAT_AX_ID, fam.catAxPos, SEC_VAL_AX_ID, {}, { deleted: true });
+  }
+  return out;
+};
+buildCatAx_fn = function(id, pos, crossId, cfg, opts) {
+  const title = cfg.title ? __privateMethod(this, _ExcelChart_instances, buildTitleXml_fn).call(this, cfg.title) : "";
+  const numFmt = cfg.numberFormat ? `<c:numFmt formatCode="${puredocsExcel.escapeXml(cfg.numberFormat)}" sourceLinked="0"/>` : "";
+  return `<c:catAx><c:axId val="${id}"/><c:scaling><c:orientation val="minMax"/></c:scaling><c:delete val="${opts.deleted ? 1 : 0}"/><c:axPos val="${pos}"/>` + title + numFmt + `<c:majorTickMark val="out"/><c:minorTickMark val="none"/><c:tickLblPos val="nextTo"/><c:crossAx val="${crossId}"/><c:crosses val="autoZero"/><c:auto val="1"/><c:lblAlgn val="ctr"/><c:lblOffset val="100"/><c:noMultiLvlLbl val="0"/></c:catAx>`;
+};
+buildValAx_fn = function(id, pos, crossId, cfg, opts) {
+  const grid = cfg.majorGridlines ? `<c:majorGridlines/>` : "";
+  const title = cfg.title ? __privateMethod(this, _ExcelChart_instances, buildTitleXml_fn).call(this, cfg.title) : "";
+  const numFmt = cfg.numberFormat ? `<c:numFmt formatCode="${puredocsExcel.escapeXml(cfg.numberFormat)}" sourceLinked="0"/>` : "";
+  const scaling = `<c:scaling><c:orientation val="minMax"/>${cfg.max !== void 0 ? `<c:max val="${cfg.max}"/>` : ""}${cfg.min !== void 0 ? `<c:min val="${cfg.min}"/>` : ""}</c:scaling>`;
+  const cb = opts.crossBetween ? `<c:crossBetween val="${opts.crossBetween}"/>` : "";
+  return `<c:valAx><c:axId val="${id}"/>` + scaling + `<c:delete val="0"/><c:axPos val="${pos}"/>` + grid + title + numFmt + `<c:majorTickMark val="out"/><c:minorTickMark val="none"/><c:tickLblPos val="nextTo"/><c:crossAx val="${crossId}"/><c:crosses val="${opts.crosses ?? "autoZero"}"/>` + cb + `</c:valAx>`;
+};
+buildTitleXml_fn = function(text) {
+  return `<c:title><c:tx><c:rich><a:bodyPr rot="0" spcFirstLastPara="1" vertOverflow="ellipsis" vert="horz" wrap="square" anchor="ctr" anchorCtr="1"/><a:lstStyle/><a:p><a:r><a:t>${puredocsExcel.escapeXml(text)}</a:t></a:r></a:p></c:rich></c:tx><c:overlay val="0"/></c:title>`;
+};
+var ExcelChart = _ExcelChart;
+
+exports.ChartLegendPosition = ChartLegendPosition;
+exports.ExcelChart = ExcelChart;
+exports.ExcelChartType = ExcelChartType;
+exports.TrendlineType = TrendlineType;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map