@particle-academy/holy-sheet 2.7.0 → 2.9.0

package/dist/index.js

@@ -77,9 +77,9 @@ var Inference = {
     return { header: headerName, type: "auto" };
   }
 };
-function nonNullSample(values) {
+function nonNullSample(values2) {
   const out = [];
-  for (const v of values) {
+  for (const v of values2) {
     if (v === null || v === void 0) continue;
     out.push(v);
     if (out.length >= SAMPLE_SIZE) break;
@@ -269,10 +269,10 @@ var CellAddress = {
 
 // src/workbook/cell.ts
 var Cell = class {
-  constructor(address, value, formula = null, format = null, comment = null, cachedValue = null) {
+  constructor(address, value, formula2 = null, format = null, comment = null, cachedValue = null) {
     this.address = address;
     this.value = value;
-    this.formula = formula;
+    this.formula = formula2;
     this.format = format;
     this.comment = comment;
     this.cachedValue = cachedValue;
@@ -320,8 +320,8 @@ var ColumnWidths = {
 
 // src/workbook/cell-comment.ts
 var CellComment = class {
-  constructor(text, author = null, color2 = null) {
-    this.text = text;
+  constructor(text2, author = null, color2 = null) {
+    this.text = text2;
     this.author = author;
     this.color = color2;
   }
@@ -415,8 +415,8 @@ var MergedRegion = class {
 };
 
 // src/workbook/sheet.ts
-var Sheet = class {
-  constructor(name, cells = /* @__PURE__ */ new Map(), mergedRegions = [], columnWidths = /* @__PURE__ */ new Map(), frozenRows = 0, frozenCols = 0, rowHeights = /* @__PURE__ */ new Map(), print = null) {
+var Sheet = class _Sheet {
+  constructor(name, cells = /* @__PURE__ */ new Map(), mergedRegions = [], columnWidths = /* @__PURE__ */ new Map(), frozenRows = 0, frozenCols = 0, rowHeights = /* @__PURE__ */ new Map(), print = null, charts = []) {
     this.name = name;
     this.cells = cells;
     this.mergedRegions = mergedRegions;
@@ -425,6 +425,10 @@ var Sheet = class {
     this.frozenCols = frozenCols;
     this.rowHeights = rowHeights;
     this.print = print;
+    this.charts = charts;
+  }
+  withCharts(charts) {
+    return new _Sheet(this.name, this.cells, this.mergedRegions, this.columnWidths, this.frozenRows, this.frozenCols, this.rowHeights, this.print, charts);
   }
   /** rowNumber → (colLetter → Cell), sorted by ascending row number. */
   rows() {
@@ -455,6 +459,59 @@ var Sheet = class {
   }
 };
 
+// src/workbook/chart-range.ts
+var ChartRange = class _ChartRange {
+  constructor(sheet, c1, r1, c2, r2) {
+    this.sheet = sheet;
+    this.c1 = c1;
+    this.r1 = r1;
+    this.c2 = c2;
+    this.r2 = r2;
+  }
+  static parse(ref, defaultSheet) {
+    if (typeof ref !== "string") return null;
+    let text2 = ref.trim();
+    let sheet = defaultSheet;
+    const bang = text2.lastIndexOf("!");
+    if (bang >= 0) {
+      let sheetPart = text2.slice(0, bang);
+      text2 = text2.slice(bang + 1);
+      if (sheetPart.length >= 2 && sheetPart.startsWith("'") && sheetPart.endsWith("'")) {
+        sheetPart = sheetPart.slice(1, -1).replace(/''/g, "'");
+      }
+      if (sheetPart === "") return null;
+      sheet = sheetPart;
+    }
+    const ends = text2.replace(/\$/g, "").split(":");
+    if (ends.length > 2) return null;
+    const a = CellAddress.parse(ends[0]);
+    const b = CellAddress.parse(ends[1] ?? ends[0]);
+    if (a === null || b === null || a[1] < 1 || b[1] < 1) return null;
+    return new _ChartRange(sheet, Math.min(a[0], b[0]), Math.min(a[1], b[1]), Math.max(a[0], b[0]), Math.max(a[1], b[1]));
+  }
+  /** 'Q3 Revenue'!$B$5:$B$7 */
+  formula() {
+    const from = "$" + CellAddress.letter(this.c1) + "$" + this.r1;
+    const to = "$" + CellAddress.letter(this.c2) + "$" + this.r2;
+    return "'" + this.sheet.replace(/'/g, "''") + "'!" + from + (from === to ? "" : ":" + to);
+  }
+  /** "B5:B7" on its own sheet, "'Data'!B5:B7" on another. */
+  toSchema(ownSheet) {
+    const from = CellAddress.letter(this.c1) + this.r1;
+    const to = CellAddress.letter(this.c2) + this.r2;
+    const ref = from === to ? from : from + ":" + to;
+    return this.sheet === ownSheet ? ref : "'" + this.sheet.replace(/'/g, "''") + "'!" + ref;
+  }
+  /** A1 addresses, row by row. */
+  addresses() {
+    const out = [];
+    for (let r = this.r1; r <= this.r2; r++) {
+      for (let c = this.c1; c <= this.c2; c++) out.push(CellAddress.letter(c) + r);
+    }
+    return out;
+  }
+};
+
 // src/workbook/workbook.ts
 var Workbook = class {
   constructor(sheets, meta = {}) {
@@ -667,20 +724,21 @@ var Normalizer = class {
       toInt(sheet.frozenRows ?? 0),
       toInt(sheet.frozenCols ?? 0),
       normalizeRowHeights(sheet.rowHeights),
-      normalizePrint(sheet.print)
+      normalizePrint(sheet.print),
+      normalizeCharts(sheet.charts, name, cells)
     );
   }
   normalizeCellMap(map, sheetName2) {
     const cells = /* @__PURE__ */ new Map();
     for (const [address, cellData] of Object.entries(map)) {
       if (!isCellSpec(cellData)) {
-        const [bare, formula] = promoteFormula(cellData);
+        const [bare, formula2] = promoteFormula(cellData);
         cells.set(
           address,
           new Cell(
             address,
-            formula !== null ? null : this.coerceValue(bare, null, address, sheetName2),
-            formula
+            formula2 !== null ? null : this.coerceValue(bare, null, address, sheetName2),
+            formula2
           )
         );
         continue;
@@ -796,11 +854,11 @@ var Normalizer = class {
         value.computedValue ?? null
       );
     }
-    const [bare, formula] = promoteFormula(value);
+    const [bare, formula2] = promoteFormula(value);
     return new Cell(
       address,
-      formula !== null ? null : this.coerceValue(bare, columnFormat, address, sheetName2),
-      formula,
+      formula2 !== null ? null : this.coerceValue(bare, columnFormat, address, sheetName2),
+      formula2,
       columnFormat
     );
   }
@@ -858,6 +916,72 @@ function toInt(v) {
   const n = Math.trunc(Number(v));
   return Number.isFinite(n) ? n : 0;
 }
+function normalizePoints(points2, count) {
+  if (!isPlainObject(points2) && !Array.isArray(points2)) return [];
+  const byIndex = /* @__PURE__ */ new Map();
+  for (const p of Object.values(points2)) {
+    const rec = isPlainObject(p) || Array.isArray(p) ? p : null;
+    const index = rec ? rec.index : void 0;
+    const color2 = rec ? rec.color : void 0;
+    const m = typeof color2 === "string" ? /^#([0-9A-Fa-f]{6})$/.exec(color2) : null;
+    if (typeof index === "number" && Number.isInteger(index) && index >= 0 && index < count && m) {
+      byIndex.set(index, m[1].toUpperCase());
+    }
+  }
+  return [...byIndex.entries()].sort((a, b) => a[0] - b[0]).map(([index, color2]) => ({ index, color: color2 }));
+}
+var CHART_TYPES = ["column", "bar", "line", "pie"];
+function normalizeCharts(charts, sheetName2, cells) {
+  if (!isPlainObject(charts) && !Array.isArray(charts)) return [];
+  let lastCol = -1;
+  for (const address of cells.keys()) {
+    const parsed = CellAddress.parse(address);
+    if (parsed !== null) lastCol = Math.max(lastCol, parsed[0]);
+  }
+  const out = [];
+  for (const chart of Object.values(charts)) {
+    if (!isPlainObject(chart) || !CHART_TYPES.includes(chart.type)) continue;
+    const series = [];
+    const rawSeries = isPlainObject(chart.series) || Array.isArray(chart.series) ? Object.values(chart.series) : [];
+    for (const s of rawSeries) {
+      const values2 = isPlainObject(s) || Array.isArray(s) ? ChartRange.parse(s.values, sheetName2) : null;
+      if (values2 === null) continue;
+      const rec = s;
+      const m = typeof rec.color === "string" ? /^#([0-9A-Fa-f]{6})$/.exec(rec.color) : null;
+      series.push({
+        name: typeof rec.name === "string" ? rec.name : null,
+        values: values2,
+        color: m ? m[1].toUpperCase() : null,
+        points: normalizePoints(rec.points, values2.addresses().length)
+      });
+    }
+    if (series.length === 0) continue;
+    const stack = out.length;
+    let from = [lastCol + 2, 1 + 18 * stack];
+    let to = [from[0] + 8, from[1] + 16];
+    if (isPlainObject(chart.position) || Array.isArray(chart.position)) {
+      const p = chart.position;
+      const a = typeof p.from === "string" ? CellAddress.parse(p.from) : null;
+      const b = typeof p.to === "string" ? CellAddress.parse(p.to) : null;
+      if (a !== null && b !== null && b[0] > a[0] && b[1] > a[1]) {
+        from = [a[0], a[1] - 1];
+        to = [b[0], b[1] - 1];
+      }
+    }
+    out.push({
+      type: chart.type,
+      title: typeof chart.title === "string" && chart.title !== "" ? chart.title : null,
+      categories: ChartRange.parse(chart.categories, sheetName2),
+      series,
+      from,
+      to,
+      legend: typeof chart.legend === "boolean" ? chart.legend : null,
+      dataLabels: chart.dataLabels === true,
+      format: typeof chart.format === "string" && chart.format !== "" ? chart.format : null
+    });
+  }
+  return out;
+}
 function phpNumeric(v) {
   if (typeof v === "number") return Number.isFinite(v) ? v : null;
   return isNumericString(v) ? numericStringToNumber(v) : null;
@@ -876,6 +1000,7 @@ function normalizePrint(print) {
   const p = print;
   const orientation = p.orientation === "portrait" || p.orientation === "landscape" ? p.orientation : null;
   const fitToWidth = p.fitToWidth === true;
+  const fitToPage = p.fitToPage === true;
   let footer = null;
   if (isPlainObject(p.footer) || Array.isArray(p.footer)) {
     const f = p.footer;
@@ -883,8 +1008,8 @@ function normalizePrint(print) {
     footer = { left: slot("left"), center: slot("center"), right: slot("right") };
     if (footer.left === "" && footer.center === "" && footer.right === "") footer = null;
   }
-  if (orientation === null && !fitToWidth && footer === null) return null;
-  return { orientation, fitToWidth, footer };
+  if (orientation === null && !fitToWidth && !fitToPage && footer === null) return null;
+  return { orientation, fitToWidth, fitToPage, footer };
 }
 
 // src/schema/formula-linter.ts
@@ -948,9 +1073,9 @@ var FormulaLinter = class {
   isError(v) {
     return typeof v === "string" && v.length > 0 && v[0] === "#";
   }
-  evaluate(formula, defaultSheet, stack) {
+  evaluate(formula2, defaultSheet, stack) {
     try {
-      const c = { tokens: this.tokenize(formula), pos: 0 };
+      const c = { tokens: this.tokenize(formula2), pos: 0 };
       const result = this.parseExpr(c, defaultSheet, stack);
       if (c.pos < c.tokens.length) return ERR_NAME;
       return result;
@@ -1211,13 +1336,13 @@ var FormulaLinter = class {
     const row1 = Math.min(a[1], b[1]);
     const col2 = Math.max(a[0], b[0]);
     const row2 = Math.max(a[1], b[1]);
-    const values = [];
+    const values2 = [];
     for (let r = row1; r <= row2; r++) {
       for (let col = col1; col <= col2; col++) {
-        values.push(this.resolveCell(sheet, CellAddress.letter(col) + r, stack));
+        values2.push(this.resolveCell(sheet, CellAddress.letter(col) + r, stack));
       }
     }
-    return values;
+    return values2;
   }
   expectOp(c, op) {
     const t = c.tokens[c.pos];
@@ -1349,12 +1474,12 @@ var FormulaLinter = class {
     return truthy ? args[1] : args[2] ?? false;
   }
   // ---- Hints ----
-  hint(error2, formula, sheet) {
+  hint(error2, formula2, sheet) {
     switch (error2) {
       case ERR_VALUE:
-        return this.hintValue(formula, sheet);
+        return this.hintValue(formula2, sheet);
       case ERR_REF:
-        return this.hintRef(formula);
+        return this.hintRef(formula2);
       case ERR_NAME:
         return "The formula references an unknown function or has a syntax error. Holy Sheet supports: SUM, AVERAGE, COUNT, COUNTA, MIN, MAX, IF, ROUND, ABS, LEN, UPPER, LOWER, CONCAT.";
       case ERR_DIV0:
@@ -1365,8 +1490,8 @@ var FormulaLinter = class {
         return "Formula evaluation failed.";
     }
   }
-  hintRef(formula) {
-    for (const m of formula.matchAll(new RegExp(SHEET_QUALIFIER, "g"))) {
+  hintRef(formula2) {
+    for (const m of formula2.matchAll(new RegExp(SHEET_QUALIFIER, "g"))) {
       const name = this.cleanSheetName(m[1]);
       if (!this.sheetNames.has(name.toLowerCase())) {
         return `The formula refers to a sheet named '${name}', and this workbook has no such sheet. Its sheets are: ${[...this.sheetNames.values()].join(", ")}. Quote a name that contains spaces or punctuation: 'My Sheet'!A1.`;
@@ -1374,10 +1499,10 @@ var FormulaLinter = class {
     }
     return "A cell reference points to a cell that doesn't exist in the workbook. Check column letters and row numbers.";
   }
-  hintValue(formula, sheet) {
+  hintValue(formula2, sheet) {
     const re = new RegExp(`(?:${SHEET_QUALIFIER})?\\$?([A-Z]+)\\$?(\\d+)`, "gi");
     const offenders = [];
-    for (const m of formula.matchAll(re)) {
+    for (const m of formula2.matchAll(re)) {
       const sheetName2 = m[1] ? this.sheetNames.get(this.cleanSheetName(m[1]).toLowerCase()) ?? this.cleanSheetName(m[1]) : sheet;
       const a1 = m[2].toUpperCase() + m[3];
       const key = sheetName2 + "!" + a1;
@@ -1500,11 +1625,11 @@ var Repairer = class {
     sheet.columns.forEach((col, colIdx) => {
       if (!isPlainObject(col)) return;
       if (col.type !== void 0 && col.type !== "auto") return;
-      const values = [];
+      const values2 = [];
       for (const row of sheet.rows) {
-        if (Array.isArray(row) && colIdx < row.length) values.push(row[colIdx]);
+        if (Array.isArray(row) && colIdx < row.length) values2.push(row[colIdx]);
       }
-      const nonNull = values.filter((v) => v !== null && v !== void 0);
+      const nonNull = values2.filter((v) => v !== null && v !== void 0);
       if (nonNull.length === 0) return;
       const allDateLike = nonNull.every((v) => typeof v === "string" && ISO_DATE2.test(v));
       if (allDateLike) {
@@ -1767,6 +1892,9 @@ var Validator = class {
         }
       }
     }
+    if (sheet.charts != null) {
+      errors.push(...validateCharts(sheet.charts, path, typeof sheet.name === "string" ? sheet.name : ""));
+    }
     if (sheet.print != null) {
       const print = sheet.print;
       if (!isPlainObject(print) && !Array.isArray(print)) {
@@ -1796,6 +1924,15 @@ var Validator = class {
             "true scales the sheet to one page wide when printed."
           ));
         }
+        if (print.fitToPage != null && typeof print.fitToPage !== "boolean") {
+          errors.push(error(
+            `${path}.print.fitToPage`,
+            "boolean",
+            typeOf(print.fitToPage),
+            print.fitToPage,
+            "true scales the sheet onto ONE page, wide and tall: a one-page summary with a chart prints whole."
+          ));
+        }
         if (print.footer != null) {
           if (!isPlainObject(print.footer) && !Array.isArray(print.footer)) {
             errors.push(error(
@@ -1867,6 +2004,149 @@ var Validator = class {
     return errors;
   }
 };
+function validatePoints(points2, at2, values2) {
+  if (!Array.isArray(points2)) {
+    return [
+      error(
+        at2,
+        "a list of points",
+        typeOf(points2),
+        points2,
+        'Colour single points: [{"index": 2, "color": "#C2410C"}], index 0-based within values.'
+      )
+    ];
+  }
+  const count = values2 === null ? 0 : values2.addresses().length;
+  const errors = [];
+  points2.forEach((p, k) => {
+    const rec = isPlainObject(p) || Array.isArray(p) ? p : null;
+    const index = rec ? rec.index ?? null : null;
+    const color2 = rec ? rec.color ?? null : null;
+    if (typeof index !== "number" || !Number.isInteger(index) || index < 0 || index >= count) {
+      errors.push(error(
+        `${at2}[${k}].index`,
+        "an index within values (0 to " + Math.max(0, count - 1) + ")",
+        typeOf(index),
+        index,
+        'The 0-based position of the point in its values range: "B5:B7" has points 0, 1 and 2.'
+      ));
+    }
+    if (typeof color2 !== "string" || !/^#[0-9A-Fa-f]{6}$/.test(color2)) {
+      errors.push(error(`${at2}[${k}].color`, "#RRGGBB", typeOf(color2), color2, 'A hex colour, like "#C2410C".'));
+    }
+  });
+  return errors;
+}
+function validateCharts(charts, path, sheetName2) {
+  if (!Array.isArray(charts)) {
+    return [
+      error(
+        `${path}.charts`,
+        "a list of charts",
+        typeOf(charts),
+        charts,
+        'charts is a list: [{"type": "column", "categories": "A5:A7", "series": [{"name": "Revenue", "values": "B5:B7"}]}].'
+      )
+    ];
+  }
+  const errors = [];
+  charts.forEach((chart, i) => {
+    const at2 = `${path}.charts[${i}]`;
+    if (!isPlainObject(chart) && !Array.isArray(chart)) {
+      errors.push(error(at2, "object", typeOf(chart), chart, "A chart is an object with a type and series."));
+      return;
+    }
+    const c = chart;
+    if (!CHART_TYPES.includes(c.type)) {
+      errors.push(error(
+        `${at2}.type`,
+        "one of: " + CHART_TYPES.join(", "),
+        typeOf(c.type ?? null),
+        c.type ?? null,
+        "column compares values across categories; bar does the same horizontally (long labels); line shows change over time; pie shows parts of one whole."
+      ));
+    }
+    const series = c.series;
+    if (!Array.isArray(series) || series.length === 0) {
+      errors.push(error(
+        `${at2}.series`,
+        "a non-empty list of series",
+        typeOf(series ?? null),
+        series ?? null,
+        'Each series names the range it plots: [{"name": "Revenue", "values": "B5:B7"}].'
+      ));
+    } else {
+      series.forEach((s, j) => {
+        const isObj = isPlainObject(s) || Array.isArray(s);
+        const values2 = isObj ? s.values ?? null : s;
+        if (!isObj || ChartRange.parse(values2, sheetName2) === null) {
+          errors.push(error(
+            `${at2}.series[${j}].values`,
+            'a cell range like "B5:B7"',
+            typeOf(values2),
+            values2,
+            `A range of cells: "B5:B7" on this sheet, or "'Other sheet'!B5:B7".`
+          ));
+        } else {
+          const color2 = s.color;
+          if (color2 != null && (typeof color2 !== "string" || !/^#[0-9A-Fa-f]{6}$/.test(color2))) {
+            errors.push(error(`${at2}.series[${j}].color`, "#RRGGBB", typeOf(color2), color2, 'A hex colour, like "#1F3A5F".'));
+          }
+        }
+        if (isObj && s.points != null) {
+          errors.push(...validatePoints(s.points, `${at2}.series[${j}].points`, ChartRange.parse(values2, sheetName2)));
+        }
+      });
+    }
+    if (c.categories != null && ChartRange.parse(c.categories, sheetName2) === null) {
+      errors.push(error(
+        `${at2}.categories`,
+        'a cell range like "A5:A7"',
+        typeOf(c.categories),
+        c.categories,
+        'The labels along the axis, as a range: "A5:A7".'
+      ));
+    }
+    if (c.position != null) {
+      const p = c.position;
+      const isObj = isPlainObject(p) || Array.isArray(p);
+      const a = isObj && typeof p.from === "string" ? CellAddress.parse(p.from) : null;
+      const b = isObj && typeof p.to === "string" ? CellAddress.parse(p.to) : null;
+      if (a === null || b === null || b[0] <= a[0] || b[1] <= a[1]) {
+        errors.push(error(
+          `${at2}.position`,
+          '{"from": top-left cell, "to": bottom-right cell}',
+          typeOf(p),
+          p,
+          'Two cells, the second below and to the right of the first: {"from": "E2", "to": "L18"} is 7 columns by 16 rows.'
+        ));
+      }
+    }
+    for (const key of ["title", "format"]) {
+      if (c[key] != null && typeof c[key] !== "string") {
+        errors.push(error(
+          `${at2}.${key}`,
+          "string",
+          typeOf(c[key]),
+          c[key],
+          key === "format" ? 'An Excel number format for the axis and labels, like "$#,##0" or "0.0%".' : "The chart title."
+        ));
+      }
+    }
+    for (const key of ["dataLabels", "legend"]) {
+      if (c[key] != null && typeof c[key] !== "boolean") {
+        errors.push(error(
+          `${at2}.${key}`,
+          "boolean",
+          typeOf(c[key]),
+          c[key],
+          key === "dataLabels" ? "true prints each value on the chart." : "Defaults to on for several series or a pie."
+        ));
+      }
+    }
+  });
+  return errors;
+}
 function error(path, expected, got, value, hint) {
   return { path, expected, got, value, hint };
 }
@@ -2383,15 +2663,15 @@ var FormatSniffer = {
 };
 
 // src/reader/ods/ods-formula.ts
-function odsFormulaToA1(formula) {
+function odsFormulaToA1(formula2) {
   let grammar = "of";
-  const m = /^(of|oooc|msoxl):/i.exec(formula);
+  const m = /^(of|oooc|msoxl):/i.exec(formula2);
   if (m) {
     grammar = m[1].toLowerCase();
-    formula = formula.slice(m[0].length);
+    formula2 = formula2.slice(m[0].length);
   }
-  if (formula.startsWith("=")) formula = formula.slice(1);
-  return grammar === "msoxl" ? formula : translate(formula);
+  if (formula2.startsWith("=")) formula2 = formula2.slice(1);
+  return grammar === "msoxl" ? formula2 : translate(formula2);
 }
 function translate(s) {
   let out = "";
@@ -2740,8 +3020,8 @@ var OdsStyles = class {
     switch (el2.name) {
       case "number-style": {
         if (has2("scientific-number") || has2("fraction")) return null;
-        for (const text of parts.filter((p) => p.name === "text")) {
-          const iso = currencyCode(ownText(text).replace(/[-()"\u00A0]/g, ""));
+        for (const text2 of parts.filter((p) => p.name === "text")) {
+          const iso = currencyCode(ownText(text2).replace(/[-()"\u00A0]/g, ""));
           if (iso !== null) return { displayFormat: "currency", decimals: decimals ?? 0, currency: iso };
         }
         if (!number) return null;
@@ -2920,6 +3200,7 @@ function sheetToSchema(sheet) {
     const print = {};
     if (sheet.print.orientation !== null) print["orientation"] = sheet.print.orientation;
     if (sheet.print.fitToWidth) print["fitToWidth"] = true;
+    if (sheet.print.fitToPage) print["fitToPage"] = true;
     if (sheet.print.footer !== null) {
       const footer = {};
       for (const k of ["left", "center", "right"]) if (sheet.print.footer[k] !== "") footer[k] = sheet.print.footer[k];
@@ -2927,6 +3208,30 @@ function sheetToSchema(sheet) {
     }
     out["print"] = print;
   }
+  if (sheet.charts.length > 0) {
+    out["charts"] = sheet.charts.map((c) => chartToSchema(c, sheet.name));
+  }
+  return out;
+}
+function chartToSchema(chart, sheetName2) {
+  const out = { type: chart.type };
+  if (chart.title !== null) out["title"] = chart.title;
+  if (chart.categories !== null) out["categories"] = chart.categories.toSchema(sheetName2);
+  out["series"] = chart.series.map((s) => {
+    const series = {};
+    if (s.name !== null) series["name"] = s.name;
+    series["values"] = s.values.toSchema(sheetName2);
+    if (s.color !== null) series["color"] = "#" + s.color;
+    if (s.points.length > 0) series["points"] = s.points.map((p) => ({ index: p.index, color: "#" + p.color }));
+    return series;
+  });
+  out["position"] = {
+    from: CellAddress.letter(chart.from[0]) + (chart.from[1] + 1),
+    to: CellAddress.letter(chart.to[0]) + (chart.to[1] + 1)
+  };
+  if (chart.dataLabels) out["dataLabels"] = true;
+  if (chart.legend !== null) out["legend"] = chart.legend;
+  if (chart.format !== null) out["format"] = chart.format;
   return out;
 }
 function cellToSchema(cell) {
@@ -3034,10 +3339,10 @@ function parseXml(src, options = {}) {
   if (namespaces) root.content = [];
   const stack = [root];
   const scopes = [{ xml: XML_NS }];
-  const appendText = (text) => {
+  const appendText = (text2) => {
     const top = stack[stack.length - 1];
-    top.text += text;
-    if (namespaces && text !== "") top.content.push(text);
+    top.text += text2;
+    if (namespaces && text2 !== "") top.content.push(text2);
   };
   while (i < n) {
     if (src[i] === "<") {
@@ -3258,7 +3563,7 @@ function hasContent(cell) {
 }
 function readCell(cell) {
   const type = attr(cell, NS.OFFICE, "value-type") ?? null;
-  const text = paragraphs(cell);
+  const text2 = paragraphs(cell);
   let value = null;
   let seconds = null;
   let dateHasTime = false;
@@ -3287,20 +3592,20 @@ function readCell(cell) {
     case "string": {
       const error2 = attr(cell, NS.CALCEXT, "value-type") === "error";
       const stored = attr(cell, NS.OFFICE, "string-value");
-      value = stored !== void 0 && !error2 ? stored : text ?? "";
+      value = stored !== void 0 && !error2 ? stored : text2 ?? "";
       break;
     }
     default:
-      value = text !== null && text !== "" ? text : null;
+      value = text2 !== null && text2 !== "" ? text2 : null;
   }
-  let formula = null;
+  let formula2 = null;
   let cached = null;
   const formulaAttr = attr(cell, NS.TABLE, "formula");
   if (formulaAttr !== void 0) {
     const translated = odsFormulaToA1(formulaAttr);
     const literalBoolean = type === "boolean" && /^[ \t\n\r\f\v]*(TRUE|FALSE)\(\)[ \t\n\r\f\v]*$/i.test(translated);
     if (!literalBoolean) {
-      formula = translated;
+      formula2 = translated;
       cached = seconds !== null ? serial(seconds) : value;
       value = null;
       seconds = null;
@@ -3316,7 +3621,7 @@ function readCell(cell) {
   const currency = attr(cell, NS.OFFICE, "currency");
   return {
     value,
-    formula,
+    formula: formula2,
     cached,
     type,
     currency: currency !== void 0 ? phpTrim(currency) : null,
@@ -3385,6 +3690,139 @@ function readMeta(xml) {
   return out;
 }
 
+// src/reader/chart-parser.ts
+function descendants(node, name) {
+  const out = [];
+  const stack = node ? [...node.children].reverse() : [];
+  while (stack.length > 0) {
+    const n = stack.pop();
+    if (n.name === name) out.push(n);
+    for (let i = n.children.length - 1; i >= 0; i--) stack.push(n.children[i]);
+  }
+  return out;
+}
+function load(xml) {
+  if (/<!DOCTYPE/i.test(xml)) return null;
+  return parseXml(xml);
+}
+function wrap2(root) {
+  return { name: "#document", attrs: {}, children: [root], text: "" };
+}
+var ChartParser = {
+  anchors(drawingXml) {
+    const root = load(drawingXml);
+    if (!root) return [];
+    const out = [];
+    for (const anchor of descendants(wrap2(root), "twoCellAnchor")) {
+      const from = marker(anchor, "from");
+      const to = marker(anchor, "to");
+      const chart = descendants(anchor, "chart")[0];
+      const rel = chart ? at(chart, "id") ?? "" : "";
+      if (from !== null && to !== null && rel !== "") out.push({ from, to, rel });
+    }
+    return out;
+  },
+  chart(chartXml, sheetName2, from, to) {
+    const root = load(chartXml);
+    if (!root) return null;
+    const doc = wrap2(root);
+    let plot;
+    let type = null;
+    for (const tag of ["barChart", "lineChart", "pieChart"]) {
+      const found = descendants(doc, tag)[0];
+      if (found) {
+        plot = found;
+        type = tag === "lineChart" ? "line" : tag === "pieChart" ? "pie" : at(el(found, "barDir"), "val") === "bar" ? "bar" : "column";
+        break;
+      }
+    }
+    if (!plot || type === null) return null;
+    let categories = null;
+    const series = [];
+    for (const ser of els(plot, "ser")) {
+      const valRef = formula(ser, "val");
+      const values2 = valRef !== null ? ChartRange.parse(valRef, sheetName2) : null;
+      if (values2 === null) continue;
+      if (categories === null) {
+        const catRef = formula(ser, "cat");
+        categories = catRef !== null ? ChartRange.parse(catRef, sheetName2) : null;
+      }
+      series.push({ name: seriesName(ser), values: values2, color: seriesColor(ser), points: points(ser) });
+    }
+    if (series.length === 0) return null;
+    const labels = el(plot, "dLbls");
+    const dataLabels2 = labels !== void 0 && at(el(labels, "showVal"), "val") === "1";
+    let format = null;
+    for (const host of [labels, descendants(doc, "valAx")[0]]) {
+      const numFmt = host ? el(host, "numFmt") : void 0;
+      if (numFmt && at(numFmt, "sourceLinked") === "0" && (at(numFmt, "formatCode") ?? "") !== "") {
+        format = at(numFmt, "formatCode");
+        break;
+      }
+    }
+    let title = null;
+    const titleEl = descendants(doc, "title")[0];
+    if (titleEl) {
+      const text2 = descendants(titleEl, "t").map((t) => t.text).join("");
+      title = text2 !== "" ? text2 : null;
+    }
+    return {
+      type,
+      title,
+      categories,
+      series,
+      from,
+      to,
+      legend: descendants(doc, "legend").length > 0 ? true : null,
+      dataLabels: dataLabels2,
+      format
+    };
+  }
+};
+function marker(anchor, tag) {
+  const m = el(anchor, tag);
+  if (!m) return null;
+  const col = descendants(m, "col")[0]?.text.trim() ?? "";
+  const row = descendants(m, "row")[0]?.text.trim() ?? "";
+  return /^\d+$/.test(col) && /^\d+$/.test(row) ? [parseInt(col, 10), parseInt(row, 10)] : null;
+}
+function formula(ser, name) {
+  const host = el(ser, name);
+  if (!host) return null;
+  for (const ref of ["numRef", "strRef"]) {
+    const f = el(el(host, ref), "f");
+    if (f && f.text.trim() !== "") return f.text.trim();
+  }
+  return null;
+}
+function seriesName(ser) {
+  const tx = el(ser, "tx");
+  if (!tx) return null;
+  const v = el(tx, "v");
+  if (v) return v.text;
+  const cached = descendants(tx, "v")[0];
+  return cached ? cached.text : null;
+}
+function points(ser) {
+  const byIndex = /* @__PURE__ */ new Map();
+  for (const dPt of els(ser, "dPt")) {
+    const idx = at(el(dPt, "idx"), "val");
+    const clr = descendants(dPt, "srgbClr")[0];
+    const color2 = (clr ? at(clr, "val") ?? "" : "").toUpperCase();
+    if (idx !== void 0 && /^[0-9]+$/.test(idx) && /^[0-9A-F]{6}$/.test(color2)) {
+      byIndex.set(parseInt(idx, 10), color2);
+    }
+  }
+  return [...byIndex.entries()].sort((a, b) => a[0] - b[0]).map(([index, color2]) => ({ index, color: color2 }));
+}
+function seriesColor(ser) {
+  const spPr = el(ser, "spPr");
+  if (!spPr) return null;
+  const clr = descendants(spPr, "srgbClr")[0];
+  const val = (clr ? at(clr, "val") ?? "" : "").toUpperCase();
+  return /^[0-9A-F]{6}$/.test(val) ? val : null;
+}
+
 // src/reader/comments-parser.ts
 var CommentsParser = {
   parse(commentsXml) {
@@ -3572,10 +4010,11 @@ function parsePrint(xml) {
   const o = at(setup, "orientation");
   const orientation = o === "portrait" || o === "landscape" ? o : null;
   const fitToWidth = fitToPage && setup !== void 0 && at(setup, "fitToWidth") === "1" && ["0", ""].includes(at(setup, "fitToHeight") ?? "");
+  const fitToPageOnly = fitToPage && setup !== void 0 && at(setup, "fitToWidth") === "1" && at(setup, "fitToHeight") === "1";
   const oddFooter = el(el(xml, "headerFooter"), "oddFooter");
   const footer = oddFooter !== void 0 ? parseFooterCodes(oddFooter.text) : null;
-  if (orientation === null && !fitToWidth && footer === null) return null;
-  return { orientation, fitToWidth, footer };
+  if (orientation === null && !fitToWidth && !fitToPageOnly && footer === null) return null;
+  return { orientation, fitToWidth, fitToPage: fitToPageOnly, footer };
 }
 function parseFooterCodes(codes) {
   const slots = { left: "", center: "", right: "" };
@@ -3616,13 +4055,13 @@ function parseCells(xml, stylesIndex, comments, sharedStrings) {
       const type = c.attrs["t"] ?? "n";
       const styleIdx = c.attrs["s"] !== void 0 ? parseInt(c.attrs["s"], 10) : 0;
       const format = stylesIndex[styleIdx] ?? null;
-      let formula = null;
+      let formula2 = null;
       let cachedValue = null;
       let value = null;
       const f = el(c, "f");
       const v = el(c, "v");
       if (f) {
-        formula = f.text;
+        formula2 = f.text;
         cachedValue = v ? coerceValue(v.text, type) : null;
       } else if (type === "inlineStr" && el(c, "is") && el(el(c, "is"), "t")) {
         value = el(el(c, "is"), "t").text;
@@ -3633,7 +4072,7 @@ function parseCells(xml, stylesIndex, comments, sharedStrings) {
         value = coerceValue(v.text, type);
       }
       const comment = comments[address] ?? null;
-      cells.set(address, new Cell(address, value, formula, format, comment, cachedValue));
+      cells.set(address, new Cell(address, value, formula2, format, comment, cachedValue));
     }
   }
   return cells;
@@ -3724,7 +4163,26 @@ var XlsxReader = class {
           if (commentsXml) comments = { ...comments, ...CommentsParser.parse(commentsXml) };
         }
       }
-      sheets.push(WorksheetParser.parse(worksheetXml, name, stylesIndex, comments, sharedStrings));
+      let sheet = WorksheetParser.parse(worksheetXml, name, stylesIndex, comments, sharedStrings);
+      if (sheetRelsXml) {
+        const charts = [];
+        for (const dr of Object.values(RelsParser.byType(RelsParser.parse(sheetRelsXml), "/drawing"))) {
+          const drawingPath = resolveRelativePath(sheetPath, dr.Target);
+          const slash = drawingPath.lastIndexOf("/");
+          const drawingXml = getText(drawingPath);
+          const drawingRelsXml = getText(drawingPath.slice(0, slash) + "/_rels/" + drawingPath.slice(slash + 1) + ".rels");
+          if (drawingXml === null || drawingRelsXml === null) continue;
+          const drawingRels = RelsParser.parse(drawingRelsXml);
+          for (const anchor of ChartParser.anchors(drawingXml)) {
+            const target2 = drawingRels[anchor.rel]?.Target;
+            const chartXml = typeof target2 === "string" ? getText(resolveRelativePath(drawingPath, target2)) : null;
+            const chart = chartXml !== null ? ChartParser.chart(chartXml, name, anchor.from, anchor.to) : null;
+            if (chart !== null) charts.push(chart);
+          }
+        }
+        if (charts.length > 0) sheet = sheet.withCharts(charts);
+      }
+      sheets.push(sheet);
       i++;
     }
     const meta = this.parseDocProps(getText("docProps/core.xml"));
@@ -3978,6 +4436,119 @@ function hexToArgb(hex2) {
   return "FF000000";
 }
 
+// src/writer/chart-xml.ts
+var NS_C = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+var NS_A = "http://schemas.openxmlformats.org/drawingml/2006/main";
+var NS_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var ChartXml = {
+  drawing(charts, firstChartNum) {
+    let anchors = "";
+    charts.forEach((chart, k) => {
+      const id = k + 2;
+      const num = firstChartNum + k;
+      anchors += '<xdr:twoCellAnchor editAs="oneCell">' + marker2("from", chart.from) + marker2("to", chart.to) + `<xdr:graphicFrame macro=""><xdr:nvGraphicFramePr><xdr:cNvPr id="${id}" name="Chart ${num}"/><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="${NS_C}"><c:chart xmlns:c="${NS_C}" xmlns:r="${NS_R}" r:id="rId${k + 1}"/></a:graphicData></a:graphic></xdr:graphicFrame><xdr:clientData/></xdr:twoCellAnchor>`;
+    });
+    return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><xdr:wsDr xmlns:xdr="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing" xmlns:a="${NS_A}">` + anchors + "</xdr:wsDr>";
+  },
+  drawingRels(charts, firstChartNum) {
+    let rels = "";
+    charts.forEach((_, k) => {
+      rels += `<Relationship Id="rId${k + 1}" Type="${NS_R}/chart" Target="../charts/chart${firstChartNum + k}.xml"/>`;
+    });
+    return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' + rels + "</Relationships>";
+  },
+  chart(chart, workbook) {
+    const type = chart.type;
+    let series = "";
+    chart.series.forEach((s, i) => {
+      series += seriesXml(i, s, chart, workbook);
+    });
+    const labels = chart.dataLabels ? dataLabels(type, chart.format) : "";
+    let plot;
+    if (type === "line") {
+      plot = '<c:lineChart><c:grouping val="standard"/><c:varyColors val="0"/>' + series + labels + '<c:marker val="1"/><c:axId val="10"/><c:axId val="20"/></c:lineChart>';
+    } else if (type === "pie") {
+      plot = '<c:pieChart><c:varyColors val="1"/>' + series + labels + '<c:firstSliceAng val="0"/></c:pieChart>';
+    } else {
+      plot = `<c:barChart><c:barDir val="${type === "bar" ? "bar" : "col"}"/><c:grouping val="clustered"/><c:varyColors val="0"/>` + series + labels + '<c:gapWidth val="80"/><c:axId val="10"/><c:axId val="20"/></c:barChart>';
+    }
+    const axesXml = type === "pie" ? "" : axes(type === "bar", chart.format);
+    const legend = chart.legend ?? (chart.series.length > 1 || type === "pie");
+    const title = chart.title !== null ? `<c:title><c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:pPr><a:defRPr sz="1200" b="1"/></a:pPr><a:r><a:rPr lang="en-US" sz="1200" b="1"/><a:t>${text(chart.title)}</a:t></a:r></a:p></c:rich></c:tx><c:overlay val="0"/></c:title><c:autoTitleDeleted val="0"/>` : '<c:autoTitleDeleted val="1"/>';
+    return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><c:chartSpace xmlns:c="${NS_C}" xmlns:a="${NS_A}" xmlns:r="${NS_R}"><c:roundedCorners val="0"/><c:chart>` + title + "<c:plotArea><c:layout/>" + plot + axesXml + "</c:plotArea>" + (legend ? '<c:legend><c:legendPos val="b"/><c:overlay val="0"/></c:legend>' : "") + '<c:plotVisOnly val="1"/><c:dispBlanksAs val="gap"/></c:chart><c:spPr><a:noFill/><a:ln><a:noFill/></a:ln></c:spPr>' + textProps("595959", 900) + "</c:chartSpace>";
+  }
+};
+function marker2(tag, at2) {
+  return `<xdr:${tag}><xdr:col>${at2[0]}</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>${at2[1]}</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:${tag}>`;
+}
+function seriesXml(i, s, chart, workbook) {
+  const type = chart.type;
+  const name = s.name !== null ? `<c:tx><c:v>${text(s.name)}</c:v></c:tx>` : "";
+  let fill = "";
+  if (s.color !== null && type !== "pie") {
+    fill = type === "line" ? `<c:spPr><a:ln w="28575" cap="rnd"><a:solidFill><a:srgbClr val="${s.color}"/></a:solidFill><a:round/></a:ln></c:spPr>` : `<c:spPr><a:solidFill><a:srgbClr val="${s.color}"/></a:solidFill></c:spPr>`;
+  }
+  const invert = type === "column" || type === "bar" ? '<c:invertIfNegative val="0"/>' : "";
+  const mark = type === "line" ? '<c:marker><c:symbol val="circle"/><c:size val="6"/></c:marker>' : "";
+  const cat = chart.categories !== null ? "<c:cat>" + strRef(chart.categories, workbook) + "</c:cat>" : "";
+  const smooth = type === "line" ? '<c:smooth val="0"/>' : "";
+  let points2 = "";
+  for (const p of s.points) {
+    const solid = `<a:solidFill><a:srgbClr val="${p.color}"/></a:solidFill>`;
+    points2 += `<c:dPt><c:idx val="${p.index}"/>` + (type === "line" ? `<c:marker><c:symbol val="circle"/><c:size val="6"/><c:spPr>${solid}<a:ln>${solid}</a:ln></c:spPr></c:marker><c:bubble3D val="0"/>` : type === "pie" ? `<c:bubble3D val="0"/><c:spPr>${solid}</c:spPr>` : `<c:invertIfNegative val="0"/><c:bubble3D val="0"/><c:spPr>${solid}</c:spPr>`) + "</c:dPt>";
+  }
+  return `<c:ser><c:idx val="${i}"/><c:order val="${i}"/>` + name + fill + invert + mark + points2 + cat + "<c:val>" + numRef(s.values, workbook) + "</c:val>" + smooth + "</c:ser>";
+}
+function strRef(range, workbook) {
+  let pts = "";
+  const vals = values(range, workbook);
+  vals.forEach((v, idx) => {
+    if (v !== null) pts += `<c:pt idx="${idx}"><c:v>${text(category(v))}</c:v></c:pt>`;
+  });
+  return `<c:strRef><c:f>${text(range.formula())}</c:f><c:strCache><c:ptCount val="${vals.length}"/>` + pts + "</c:strCache></c:strRef>";
+}
+function numRef(range, workbook) {
+  let pts = "";
+  const vals = values(range, workbook);
+  vals.forEach((v, idx) => {
+    if (typeof v === "number") pts += `<c:pt idx="${idx}"><c:v>${formatFloat(v)}</c:v></c:pt>`;
+  });
+  return `<c:numRef><c:f>${text(range.formula())}</c:f><c:numCache><c:formatCode>General</c:formatCode><c:ptCount val="${vals.length}"/>` + pts + "</c:numCache></c:numRef>";
+}
+function values(range, workbook) {
+  const sheet = workbook.sheets.find((s) => s.name === range.sheet);
+  return range.addresses().map((address) => {
+    const cell = sheet?.cells.get(address);
+    if (cell === void 0) return null;
+    const v = cell.formula !== null ? cell.cachedValue : cell.value;
+    return v === void 0 ? null : v;
+  });
+}
+function category(v) {
+  if (typeof v === "boolean") return v ? "TRUE" : "FALSE";
+  if (typeof v === "number") return formatFloat(v);
+  return v;
+}
+function dataLabels(type, format) {
+  const pos = type === "line" ? "t" : type === "pie" ? "bestFit" : "outEnd";
+  return "<c:dLbls>" + (format !== null ? `<c:numFmt formatCode="${attr2(format)}" sourceLinked="0"/>` : "") + "<c:spPr><a:noFill/><a:ln><a:noFill/></a:ln></c:spPr>" + textProps("404040", 900) + `<c:dLblPos val="${pos}"/><c:showLegendKey val="0"/><c:showVal val="1"/><c:showCatName val="0"/><c:showSerName val="0"/><c:showPercent val="0"/><c:showBubbleSize val="0"/></c:dLbls>`;
+}
+function axes(horizontal, format) {
+  const catPos = horizontal ? "l" : "b";
+  const valPos = horizontal ? "b" : "l";
+  const numFmt = format !== null ? `<c:numFmt formatCode="${attr2(format)}" sourceLinked="0"/>` : '<c:numFmt formatCode="General" sourceLinked="1"/>';
+  return `<c:catAx><c:axId val="10"/><c:scaling><c:orientation val="${horizontal ? "maxMin" : "minMax"}"/></c:scaling><c:delete val="0"/><c:axPos val="${catPos}"/><c:numFmt formatCode="General" sourceLinked="1"/><c:majorTickMark val="none"/><c:minorTickMark val="none"/><c:tickLblPos val="low"/><c:spPr><a:ln w="9525"><a:solidFill><a:srgbClr val="BFBFBF"/></a:solidFill></a:ln></c:spPr><c:crossAx val="20"/><c:crosses val="autoZero"/><c:auto val="1"/><c:lblAlgn val="ctr"/><c:lblOffset val="100"/><c:noMultiLvlLbl val="0"/></c:catAx><c:valAx><c:axId val="20"/><c:scaling><c:orientation val="minMax"/></c:scaling><c:delete val="0"/><c:axPos val="${valPos}"/><c:majorGridlines><c:spPr><a:ln w="9525"><a:solidFill><a:srgbClr val="E5E7EB"/></a:solidFill></a:ln></c:spPr></c:majorGridlines>` + numFmt + `<c:majorTickMark val="none"/><c:minorTickMark val="none"/><c:tickLblPos val="nextTo"/><c:spPr><a:ln><a:noFill/></a:ln></c:spPr><c:crossAx val="10"/><c:crosses val="${horizontal ? "max" : "autoZero"}"/><c:crossBetween val="between"/></c:valAx>`;
+}
+function textProps(color2, size) {
+  return `<c:txPr><a:bodyPr/><a:lstStyle/><a:p><a:pPr><a:defRPr sz="${size}"><a:solidFill><a:srgbClr val="${color2}"/></a:solidFill></a:defRPr></a:pPr><a:endParaRPr lang="en-US"/></a:p></c:txPr>`;
+}
+function text(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function attr2(s) {
+  return text(s).replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+
 // src/writer/xlsx-writer.ts
 var encoder2 = new TextEncoder();
 function footerCodes(footer) {
@@ -3989,6 +4560,9 @@ function footerCodes(footer) {
   }
   return codes;
 }
+function drawingRelId(comments) {
+  return comments ? "rId3" : "rId1";
+}
 function decimal(value) {
   const out = value.toFixed(4).replace(/0+$/, "").replace(/\.$/, "");
   return out === "" || out === "-0" ? "0" : out;
@@ -4012,14 +4586,29 @@ var XlsxWriter = class {
     add("xl/styles.xml", styles.toXml());
     add("docProps/core.xml", this.coreXml(workbook));
     add("docProps/app.xml", this.appXml());
+    const firstChart = [];
+    let next = 1;
+    workbook.sheets.forEach((sheet, i) => {
+      firstChart[i] = next;
+      next += sheet.charts.length;
+    });
     workbook.sheets.forEach((sheet, i) => {
       const n = i + 1;
       add(`xl/worksheets/sheet${n}.xml`, sheetXmls[i]);
+      if (sheet.hasComments() || sheet.charts.length > 0) {
+        add(`xl/worksheets/_rels/sheet${n}.xml.rels`, this.sheetRelsXml(n, sheet.hasComments(), sheet.charts.length > 0));
+      }
       if (sheet.hasComments()) {
-        add(`xl/worksheets/_rels/sheet${n}.xml.rels`, this.sheetRelsXml(n));
         add(`xl/comments${n}.xml`, this.commentsXml(sheet));
         add(`xl/drawings/vmlDrawing${n}.vml`, this.vmlDrawingXml(sheet));
       }
+      if (sheet.charts.length > 0) {
+        add(`xl/drawings/drawing${n}.xml`, ChartXml.drawing(sheet.charts, firstChart[i]));
+        add(`xl/drawings/_rels/drawing${n}.xml.rels`, ChartXml.drawingRels(sheet.charts, firstChart[i]));
+        sheet.charts.forEach((chart, k) => {
+          add(`xl/charts/chart${firstChart[i] + k}.xml`, ChartXml.chart(chart, workbook));
+        });
+      }
     });
     return zipSync(files);
   }
@@ -4033,6 +4622,16 @@ var XlsxWriter = class {
       const n = i + 1;
       overrides += `<Override PartName="/xl/comments${n}.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml"/>`;
     }
+    let chartNum = 1;
+    workbook.sheets.forEach((sheet, i) => {
+      if (sheet.charts.length === 0) return;
+      const n = i + 1;
+      overrides += `<Override PartName="/xl/drawings/drawing${n}.xml" ContentType="application/vnd.openxmlformats-officedocument.drawing+xml"/>`;
+      for (let k = 0; k < sheet.charts.length; k++) {
+        overrides += `<Override PartName="/xl/charts/chart${chartNum}.xml" ContentType="application/vnd.openxmlformats-officedocument.drawingml.chart+xml"/>`;
+        chartNum++;
+      }
+    });
     let defaults = '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/>';
     if (sheetsWithComments.length > 0) {
       defaults += '<Default Extension="vml" ContentType="application/vnd.openxmlformats-officedocument.vmlDrawing"/>';
@@ -4061,8 +4660,16 @@ var XlsxWriter = class {
     rels += `<Relationship Id="rId${workbook.sheets.length + 1}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/>`;
     return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' + rels + "</Relationships>";
   }
-  sheetRelsXml(sheetNum) {
-    return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing" Target="../drawings/vmlDrawing${sheetNum}.vml"/><Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments" Target="../comments${sheetNum}.xml"/></Relationships>`;
+  /** Comments keep rId1 (vml) and rId2 (comments); the chart drawing takes the next id. */
+  sheetRelsXml(sheetNum, comments, charts) {
+    let rels = "";
+    if (comments) {
+      rels += `<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing" Target="../drawings/vmlDrawing${sheetNum}.vml"/><Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments" Target="../comments${sheetNum}.xml"/>`;
+    }
+    if (charts) {
+      rels += `<Relationship Id="${drawingRelId(comments)}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing" Target="../drawings/drawing${sheetNum}.xml"/>`;
+    }
+    return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' + rels + "</Relationships>";
   }
   sheetXml(sheet, styles) {
     let sheetViewsXml = "";
@@ -4104,13 +4711,15 @@ var XlsxWriter = class {
     }
     const legacyDrawing = sheet.hasComments() ? '<legacyDrawing r:id="rId1"/>' : "";
     const print = sheet.print;
-    const sheetPrXml = print?.fitToWidth ? '<sheetPr><pageSetUpPr fitToPage="1"/></sheetPr>' : "";
+    const fits = (print?.fitToWidth ?? false) || (print?.fitToPage ?? false);
+    const sheetPrXml = fits ? '<sheetPr><pageSetUpPr fitToPage="1"/></sheetPr>' : "";
     let pageSetupXml = "";
-    if (print !== null && (print.orientation !== null || print.fitToWidth)) {
-      pageSetupXml = "<pageSetup" + (print.orientation !== null ? ` orientation="${print.orientation}"` : "") + (print.fitToWidth ? ' fitToWidth="1" fitToHeight="0"' : "") + "/>";
+    if (print !== null && (print.orientation !== null || fits)) {
+      pageSetupXml = "<pageSetup" + (print.orientation !== null ? ` orientation="${print.orientation}"` : "") + // fitToPage: one page wide AND tall. fitToWidth: one wide, as tall as it needs.
+      (print.fitToPage ? ' fitToWidth="1" fitToHeight="1"' : print.fitToWidth ? ' fitToWidth="1" fitToHeight="0"' : "") + "/>";
     }
     const headerFooterXml = print?.footer ? `<headerFooter><oddFooter>${this.escape(footerCodes(print.footer))}</oddFooter></headerFooter>` : "";
-    return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">' + sheetPrXml + sheetViewsXml + colsXml + `<sheetData>${rowsXml}</sheetData>` + mergesXml + pageSetupXml + headerFooterXml + legacyDrawing + "</worksheet>";
+    return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">' + sheetPrXml + sheetViewsXml + colsXml + `<sheetData>${rowsXml}</sheetData>` + mergesXml + pageSetupXml + headerFooterXml + (sheet.charts.length > 0 ? `<drawing r:id="${drawingRelId(sheet.hasComments())}"/>` : "") + legacyDrawing + "</worksheet>";
   }
   cellXml(cell, styles) {
     const ref = cell.address;
@@ -4150,8 +4759,8 @@ var XlsxWriter = class {
       const author = entry.comment.author ?? "Author";
       if (!authors.includes(author)) authors.push(author);
       const authorIdx = authors.indexOf(author);
-      const text = this.escape(entry.comment.text);
-      commentList += `<comment ref="${entry.address}" authorId="${authorIdx}"><text><r><t xml:space="preserve">${text}</t></r></text></comment>`;
+      const text2 = this.escape(entry.comment.text);
+      commentList += `<comment ref="${entry.address}" authorId="${authorIdx}"><text><r><t xml:space="preserve">${text2}</t></r></text></comment>`;
     }
     let authorsXml = "<authors>";
     for (const a of authors) authorsXml += `<author>${this.escape(a)}</author>`;
@@ -5031,19 +5640,19 @@ function canonEntries(root) {
       continue;
     }
     stack.pop();
-    const text = top.list ? "[" + top.parts.join(",") + "]" : "{" + top.parts.join(",") + "}";
+    const text2 = top.list ? "[" + top.parts.join(",") + "]" : "{" + top.parts.join(",") + "}";
     const parent = stack[stack.length - 1];
     if (parent === void 0) {
-      return text;
+      return text2;
     }
-    parent.parts.push(member(parent, top.key, text));
+    parent.parts.push(member(parent, top.key, text2));
   }
 }
 function entriesFor(value) {
   return Array.isArray(value) ? Array.from(value, (item, i) => [String(i), item]) : entriesOf(value);
 }
-function member(frame, key, text) {
-  return frame.list ? text : quote(key) + ":" + text;
+function member(frame, key, text2) {
+  return frame.list ? text2 : quote(key) + ":" + text2;
 }
 function scalar(value) {
   switch (typeof value) {
@@ -5061,11 +5670,11 @@ function scalar(value) {
   return JSON.stringify(value) ?? "null";
 }
 var LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/;
-function quote(text) {
-  if (LONE_SURROGATE.test(text)) {
+function quote(text2) {
+  if (LONE_SURROGATE.test(text2)) {
     throw unencodable("Single unpaired UTF-16 surrogate");
   }
-  return JSON.stringify(text);
+  return JSON.stringify(text2);
 }
 function unencodable(reason) {
   return new TypeError(`[holy-sheet] cannot compare a value JSON cannot hold: ${reason}`);
@@ -5234,6 +5843,56 @@ var holy_sheet_schema_default = {
           propertyNames: { pattern: "^[1-9][0-9]*$" },
           additionalProperties: { type: "number", minimum: 0 }
         },
+        charts: {
+          type: "array",
+          description: "Native Excel charts over CELL RANGES on this sheet: edit a figure and the chart follows. Use one whenever the sheet compares values -- a board reader sees the comparison before the numbers. Keep them quiet: a title that states the point, dataLabels with a format, one colour per series.",
+          items: {
+            type: "object",
+            additionalProperties: false,
+            required: ["type", "series"],
+            properties: {
+              type: { type: "string", enum: ["column", "bar", "line", "pie"], description: "column compares categories; bar does it horizontally (long labels, ranked lists); line shows change over time; pie shows parts of ONE whole (at most ~5 slices)." },
+              title: { type: "string" },
+              categories: { type: "string", description: `The labels along the axis (or the pie's slices), as a range: "A5:A7". Another sheet: "'Data'!A5:A7".` },
+              series: {
+                type: "array",
+                minItems: 1,
+                items: {
+                  type: "object",
+                  additionalProperties: false,
+                  required: ["values"],
+                  properties: {
+                    name: { type: "string", description: "Shown in the legend." },
+                    values: { type: "string", description: 'The numbers, as a range the same length as categories: "B5:B7".' },
+                    color: { type: "string", description: "#RRGGBB. Ignored for a pie, whose slices take a palette." },
+                    points: {
+                      type: "array",
+                      description: 'Colour single points to make the finding stand out: the one bar or slice the title is about. index is 0-based within values: [{"index": 2, "color": "#C2410C"}].',
+                      items: {
+                        type: "object",
+                        additionalProperties: false,
+                        required: ["index", "color"],
+                        properties: {
+                          index: { type: "integer", minimum: 0 },
+                          color: { type: "string", description: "#RRGGBB" }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              position: {
+                type: "object",
+                additionalProperties: false,
+                description: 'Where the chart sits: from its top-left cell to its bottom-right cell, {"from": "E2", "to": "L18"}. Omitted: to the right of the data, 8 columns by 16 rows.',
+                properties: { from: { type: "string" }, to: { type: "string" } }
+              },
+              dataLabels: { type: "boolean", description: "Print each value on the chart. Usually right for a board chart." },
+              legend: { type: "boolean", description: "Defaults to on for several series or a pie, off for one series." },
+              format: { type: "string", description: 'Excel number format for the value axis and labels: "$#,##0", "0.0%", "$#,##0,K".' }
+            }
+          }
+        },
         print: {
           type: "object",
           additionalProperties: false,
@@ -5241,6 +5900,7 @@ var holy_sheet_schema_default = {
           properties: {
             orientation: { type: "string", enum: ["portrait", "landscape"] },
             fitToWidth: { type: "boolean", description: "Scale the sheet to one page wide (as many pages tall as it needs)." },
+            fitToPage: { type: "boolean", description: "Scale the sheet onto ONE page, wide and tall. Use it for a one-page summary with a chart, so the page break never cuts the chart." },
             footer: {
               type: "object",
               additionalProperties: false,
@@ -5460,7 +6120,7 @@ var holy_sheet_schema_default = {
 };
 
 // src/agent.ts
-var VERSION = "2.7.0";
+var VERSION = "2.9.0";
 function toU8(input) {
   return input instanceof Uint8Array ? input : new Uint8Array(input);
 }