@particle-academy/holy-sheet 2.2.1 → 2.3.1

package/dist/index.cjs

@@ -289,10 +289,10 @@ var Cell = class {
 
 // src/workbook/cell-comment.ts
 var CellComment = class {
-  constructor(text, author = null, color = null) {
+  constructor(text, author = null, color2 = null) {
     this.text = text;
     this.author = author;
-    this.color = color;
+    this.color = color2;
   }
 };
 
@@ -721,6 +721,7 @@ var ERR_REF = "#REF!";
 var ERR_NAME = "#NAME?";
 var ERR_DIV0 = "#DIV/0!";
 var ERR_CIRC = "#CIRC!";
+var SHEET_QUALIFIER = "('(?:[^']|'')+'|[A-Za-z_][A-Za-z0-9_.]*)!";
 var LinterError = class extends Error {
   constructor(errorCode) {
     super(errorCode);
@@ -731,9 +732,16 @@ var FormulaLinter = class {
   constructor() {
     this.index = /* @__PURE__ */ new Map();
     this.cache = /* @__PURE__ */ new Map();
+    /**
+     * Every sheet name, keyed by its lower-cased form. Excel matches sheet names
+     * without regard to case, and a reference to a sheet that is not here is
+     * `#REF!` rather than a range of blanks.
+     */
+    this.sheetNames = /* @__PURE__ */ new Map();
   }
   lint(schema) {
     const workbook = new Normalizer().normalize(schema);
+    this.sheetNames = new Map(workbook.sheets.map((sheet) => [sheet.name.toLowerCase(), sheet.name]));
     this.index = this.buildIndex(workbook);
     this.cache = /* @__PURE__ */ new Map();
     const issues = [];
@@ -809,6 +817,24 @@ var FormulaLinter = class {
         tokens.push({ type: "STRING", value });
         continue;
       }
+      if (ch === "'") {
+        const start = i;
+        i++;
+        for (; ; ) {
+          if (i >= len) throw new LinterError(ERR_NAME);
+          if (src[i] === "'") {
+            if (i + 1 < len && src[i + 1] === "'") {
+              i += 2;
+              continue;
+            }
+            i++;
+            break;
+          }
+          i++;
+        }
+        tokens.push({ type: "SHEET", value: src.slice(start, i) });
+        continue;
+      }
       if (isAlpha(ch) || ch === "_" || ch === "$") {
         const start = i;
         while (i < len && (isAlnum(src[i]) || src[i] === "_" || src[i] === "$" || src[i] === ".")) i++;
@@ -926,16 +952,18 @@ var FormulaLinter = class {
       c.pos++;
       return tok.value;
     }
-    if (tok.type === "IDENT") {
+    if (tok.type === "SHEET" || tok.type === "IDENT") {
       const next = c.tokens[c.pos + 1];
       const next2 = c.tokens[c.pos + 2];
       if (next && next.type === "OP" && next.value === "!" && next2 && next2.type === "IDENT") {
-        const sheetName = this.cleanSheetName(tok.value);
+        const sheetName = this.sheetNames.get(this.cleanSheetName(tok.value).toLowerCase());
+        if (sheetName === void 0) throw new LinterError(ERR_REF);
         c.pos += 2;
         const startTok = c.tokens[c.pos].value;
         c.pos++;
         return this.resolveRefOrRange(startTok, sheetName, c, stack);
       }
+      if (tok.type === "SHEET") throw new LinterError(ERR_NAME);
       if (next && next.type === "OP" && next.value === "(") {
         const name = tok.value.toUpperCase();
         c.pos += 2;
@@ -980,9 +1008,13 @@ var FormulaLinter = class {
     const r = ref.replace(/\$/g, "").toUpperCase();
     return /^[A-Z]+\d+$/.test(r) ? r : null;
   }
+  /**
+   * Unwrap the single quotes Excel puts around a sheet name that needs them,
+   * and turn its doubled quote back into one: 'Q3 ''Final''' is Q3 'Final'.
+   */
   cleanSheetName(name) {
     if (name.length >= 2 && name[0] === "'" && name[name.length - 1] === "'") {
-      return name.slice(1, -1);
+      return name.slice(1, -1).split("''").join("'");
     }
     return name;
   }
@@ -1150,7 +1182,7 @@ var FormulaLinter = class {
       case ERR_VALUE:
         return this.hintValue(formula, sheet);
       case ERR_REF:
-        return "A cell reference points to a cell that doesn't exist in the workbook. Check column letters and row numbers.";
+        return this.hintRef(formula);
       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:
@@ -1161,11 +1193,20 @@ var FormulaLinter = class {
         return "Formula evaluation failed.";
     }
   }
+  hintRef(formula) {
+    for (const m of formula.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.`;
+      }
+    }
+    return "A cell reference points to a cell that doesn't exist in the workbook. Check column letters and row numbers.";
+  }
   hintValue(formula, sheet) {
-    const re = /(?:([A-Za-z][A-Za-z0-9_]*)!)?\$?([A-Z]+)\$?(\d+)/gi;
+    const re = new RegExp(`(?:${SHEET_QUALIFIER})?\\$?([A-Z]+)\\$?(\\d+)`, "gi");
     const offenders = [];
     for (const m of formula.matchAll(re)) {
-      const sheetName = m[1] ? m[1] : sheet;
+      const sheetName = m[1] ? this.sheetNames.get(this.cleanSheetName(m[1]).toLowerCase()) ?? this.cleanSheetName(m[1]) : sheet;
       const a1 = m[2].toUpperCase() + m[3];
       const key = sheetName + "!" + a1;
       const cell = this.index.get(key);
@@ -1214,10 +1255,33 @@ function summarize(errors) {
     const e = errors[0];
     return `[holy-sheet] schema invalid at ${e.path}: expected ${e.expected}, got ${e.got}`;
   }
-  const first = errors[0];
+  const first2 = errors[0];
   const rest = errors.length - 1;
-  return `[holy-sheet] schema invalid at ${first.path}: expected ${first.expected}, got ${first.got} (+${rest} more)`;
+  return `[holy-sheet] schema invalid at ${first2.path}: expected ${first2.expected}, got ${first2.got} (+${rest} more)`;
 }
+var UnsupportedFormatException = class _UnsupportedFormatException extends Error {
+  constructor(message, path = null, mimetype = null) {
+    super(message);
+    this.name = "UnsupportedFormatException";
+    this.path = path;
+    this.mimetype = mimetype;
+    Object.setPrototypeOf(this, _UnsupportedFormatException.prototype);
+  }
+  static notAZip(path = null) {
+    return new _UnsupportedFormatException(
+      `[holy-sheet] cannot read ${path ?? "this file"}: it is not a zip archive, and xlsx and ods both are`,
+      path
+    );
+  }
+  static unknownPackage(path, mimetype) {
+    const what = mimetype !== null && mimetype !== "" ? `its mimetype is ${mimetype}` : "it has neither xl/workbook.xml nor an OpenDocument mimetype";
+    return new _UnsupportedFormatException(
+      `[holy-sheet] cannot read ${path ?? "this file"}: ${what}. Supported: xlsx, ods`,
+      path,
+      mimetype !== "" ? mimetype : null
+    );
+  }
+};
 
 // src/schema/repairer.ts
 var VALID_THEMES = ["default", "minimal", "plain", "business"];
@@ -1446,7 +1510,8 @@ var Validator = class {
       }
     }
     if (sheet.cells != null) {
-      if (!isPlainObject(sheet.cells)) {
+      const emptyList = Array.isArray(sheet.cells) && sheet.cells.length === 0;
+      if (!isPlainObject(sheet.cells) && !emptyList) {
         errors.push(
           error(
             `${path}.cells`,
@@ -1591,13 +1656,13 @@ function zipSync(files) {
   edv.setUint16(20, 0, true);
   const out = new Uint8Array(localSize + centralSize + 22);
   let p = 0;
-  for (const part of localParts) {
-    out.set(part, p);
-    p += part.length;
+  for (const part2 of localParts) {
+    out.set(part2, p);
+    p += part2.length;
   }
-  for (const part of centralParts) {
-    out.set(part, p);
-    p += part.length;
+  for (const part2 of centralParts) {
+    out.set(part2, p);
+    p += part2.length;
   }
   out.set(eocd, p);
   return out;
@@ -1957,7 +2022,638 @@ function unzipSync(data) {
   return result;
 }
 
+// src/reader/ods/ns.ts
+var NS = {
+  OFFICE: "urn:oasis:names:tc:opendocument:xmlns:office:1.0",
+  TABLE: "urn:oasis:names:tc:opendocument:xmlns:table:1.0",
+  TEXT: "urn:oasis:names:tc:opendocument:xmlns:text:1.0",
+  STYLE: "urn:oasis:names:tc:opendocument:xmlns:style:1.0",
+  FO: "urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0",
+  NUMBER: "urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0",
+  DC: "http://purl.org/dc/elements/1.1/",
+  META: "urn:oasis:names:tc:opendocument:xmlns:meta:1.0",
+  /** LibreOffice's extension namespace; carries `value-type="error"` for a formula error. */
+  CALCEXT: "urn:org:documentfoundation:names:experimental:calc:xmlns:calcext:1.0"
+};
+function child(node, ns, name) {
+  return node?.children.find((c) => c.ns === ns && c.name === name);
+}
+function childrenIn(node, ns) {
+  return node ? node.children.filter((c) => c.ns === ns) : [];
+}
+function attr(node, ns, name) {
+  return node?.nsAttrs?.[`{${ns}}${name}`];
+}
+function ownText(node) {
+  return node ? node.text : "";
+}
+function phpTrim(s) {
+  return s.replace(/^[ \t\n\r\0\x0B]+|[ \t\n\r\0\x0B]+$/g, "");
+}
+function asciiLower(s) {
+  return s.replace(/[A-Z]/g, (c) => c.toLowerCase());
+}
+function phpInt(s) {
+  const m = /^[ \t\n\r\v\f]*([+-]?\d+)/.exec(s);
+  return m ? parseInt(m[1], 10) : 0;
+}
+function phpIsNumeric(s) {
+  return /^[ \t\n\r\v\f]*[+-]?(\d+(\.\d*)?|\.\d+)([eE][+-]?\d+)?[ \t\n\r\v\f]*$/.test(s);
+}
+
+// src/reader/format-sniffer.ts
+var ODS_MIMETYPES = /* @__PURE__ */ new Set([
+  "application/vnd.oasis.opendocument.spreadsheet",
+  "application/vnd.oasis.opendocument.spreadsheet-template"
+]);
+var decoder2 = new TextDecoder();
+var FormatSniffer = {
+  sniff(bytes, path = null) {
+    let files;
+    try {
+      files = unzipSync(bytes);
+    } catch (e) {
+      if (e instanceof Error && e.message.includes("unsupported zip method")) throw e;
+      throw UnsupportedFormatException.notAZip(path);
+    }
+    const mimetype = files["mimetype"] ? phpTrim(decoder2.decode(files["mimetype"])) : null;
+    if (mimetype !== null && ODS_MIMETYPES.has(mimetype)) return { format: "ods", files };
+    if (files["xl/workbook.xml"]) return { format: "xlsx", files };
+    throw UnsupportedFormatException.unknownPackage(path, mimetype);
+  }
+};
+
+// src/reader/ods/ods-formula.ts
+function odsFormulaToA1(formula) {
+  let grammar = "of";
+  const m = /^(of|oooc|msoxl):/i.exec(formula);
+  if (m) {
+    grammar = m[1].toLowerCase();
+    formula = formula.slice(m[0].length);
+  }
+  if (formula.startsWith("=")) formula = formula.slice(1);
+  return grammar === "msoxl" ? formula : translate(formula);
+}
+function translate(s) {
+  let out = "";
+  const length = s.length;
+  let arrayDepth = 0;
+  for (let i = 0; i < length; i++) {
+    let c = s[i];
+    if (c === '"') {
+      let end = i + 1;
+      while (end < length) {
+        if (s[end] === '"') {
+          if (end + 1 < length && s[end + 1] === '"') {
+            end += 2;
+            continue;
+          }
+          break;
+        }
+        end++;
+      }
+      out += s.slice(i, end + 1);
+      i = end;
+      continue;
+    }
+    if (c === "[") {
+      let end = i + 1;
+      let quoted = false;
+      while (end < length && (quoted || s[end] !== "]")) {
+        if (s[end] === "'") quoted = !quoted;
+        end++;
+      }
+      out += reference(s.slice(i + 1, end));
+      i = end;
+      continue;
+    }
+    if (c === "{") {
+      arrayDepth++;
+    } else if (c === "}") {
+      arrayDepth = Math.max(0, arrayDepth - 1);
+    } else if (c === ";") {
+      c = ",";
+    } else if (c === "|" && arrayDepth > 0) {
+      c = ";";
+    }
+    out += c;
+  }
+  return out;
+}
+function reference(ref) {
+  const parts = [];
+  let start = 0;
+  let quoted = false;
+  for (let i = 0; i < ref.length; i++) {
+    if (ref[i] === "'") {
+      quoted = !quoted;
+    } else if (ref[i] === ":" && !quoted) {
+      parts.push(ref.slice(start, i));
+      start = i + 1;
+    }
+  }
+  parts.push(ref.slice(start));
+  const parsed = parts.length <= 2 ? parts.map(part) : [null];
+  if (parsed.some((p) => p === null)) {
+    return ref.includes("#REF!") ? "#REF!" : `[${ref}]`;
+  }
+  const [sheet, address] = parsed[0];
+  if (parsed.length === 1) return sheetPrefix(sheet) + address;
+  const [sheet2, address2] = parsed[1];
+  if (sheet2 === null || sheet2 === sheet) return sheetPrefix(sheet) + address + ":" + address2;
+  if (sheet === null) return address + ":" + sheetPrefix(sheet2) + address2;
+  const both = needsQuotes(sheet) || needsQuotes(sheet2) ? "'" + sheet.replace(/'/g, "''") + ":" + sheet2.replace(/'/g, "''") + "'" : sheet + ":" + sheet2;
+  return both + "!" + address + ":" + address2;
+}
+function part(p) {
+  const length = p.length;
+  let i = 0;
+  if (i < length && p[i] === "$") i++;
+  let sheet = null;
+  if (i < length && p[i] === "'") {
+    sheet = "";
+    i++;
+    for (; ; ) {
+      if (i >= length) return null;
+      if (p[i] === "'") {
+        if (i + 1 < length && p[i + 1] === "'") {
+          sheet += "'";
+          i += 2;
+          continue;
+        }
+        i++;
+        break;
+      }
+      sheet += p[i++];
+    }
+    if (i >= length || p[i] !== ".") return null;
+    i++;
+  } else {
+    const dot = p.indexOf(".", i);
+    if (dot < 0) return null;
+    if (dot > i) sheet = p.slice(i, dot);
+    i = dot + 1;
+  }
+  const address = p.slice(i);
+  if (!/^(\$?[A-Za-z]{1,3}\$?[0-9]+|\$?[A-Za-z]{1,3}|\$?[0-9]+)$/.test(address)) return null;
+  return [sheet, address];
+}
+function sheetPrefix(sheet) {
+  if (sheet === null) return "";
+  return (needsQuotes(sheet) ? "'" + sheet.replace(/'/g, "''") + "'" : sheet) + "!";
+}
+function needsQuotes(sheet) {
+  return !/^[A-Za-z_][A-Za-z0-9_.]*$/.test(sheet) || /^[A-Za-z]{1,3}[0-9]+$/.test(sheet) || /^[Rr]([0-9]+)?[Cc]([0-9]+)?$/.test(sheet);
+}
+
+// src/reader/format/num-fmt-parser.ts
+var BUILTIN = {
+  0: "General",
+  1: "0",
+  2: "0.00",
+  3: "#,##0",
+  4: "#,##0.00",
+  9: "0%",
+  10: "0.00%",
+  11: "0.00E+00",
+  12: "# ?/?",
+  13: "# ??/??",
+  14: "mm-dd-yy",
+  15: "d-mmm-yy",
+  16: "d-mmm",
+  17: "mmm-yy",
+  18: "h:mm AM/PM",
+  19: "h:mm:ss AM/PM",
+  20: "h:mm",
+  21: "h:mm:ss",
+  22: "m/d/yy h:mm",
+  37: "#,##0 ;(#,##0)",
+  38: "#,##0 ;[Red](#,##0)",
+  39: "#,##0.00;(#,##0.00)",
+  40: "#,##0.00;[Red](#,##0.00)",
+  45: "mm:ss",
+  46: "[h]:mm:ss",
+  47: "mmss.0",
+  48: "##0.0E+0",
+  49: "@"
+};
+var SYMBOL_TO_ISO = {
+  $: "USD",
+  "\u20AC": "EUR",
+  "\xA3": "GBP",
+  "\xA5": "JPY",
+  "\u20B9": "INR",
+  "\u20A9": "KRW"
+};
+var NumFmtParser = {
+  parse(formatCode) {
+    if (formatCode === null) return null;
+    const code = formatCode;
+    if (code === "" || code === "General" || code === "@") {
+      return { displayFormat: code === "@" ? "text" : "auto" };
+    }
+    if (looksLikeDate(code)) {
+      return { displayFormat: hasTimeComponent(code) ? "datetime" : "date" };
+    }
+    if (code.includes("%")) {
+      return { displayFormat: "percentage", decimals: decimalsAfter(code) };
+    }
+    const m = /^"([^"]+)"/u.exec(code);
+    if (m) {
+      const iso = SYMBOL_TO_ISO[m[1]];
+      const result = { displayFormat: "currency", decimals: decimalsAfter(code) };
+      if (iso !== void 0) result.currency = iso;
+      return result;
+    }
+    if (/^#?,?#?#?0(\.0+)?$/.test(code.split(";")[0])) {
+      return { displayFormat: "number", decimals: decimalsAfter(code) };
+    }
+    return null;
+  },
+  parseBuiltin(id) {
+    const code = BUILTIN[id];
+    if (code === void 0) return null;
+    return NumFmtParser.parse(code);
+  }
+};
+function looksLikeDate(code) {
+  const stripped = code.replace(/"[^"]*"|\[[^\]]*\]/gu, "");
+  return /[ymd]/i.test(stripped);
+}
+function hasTimeComponent(code) {
+  const stripped = code.replace(/"[^"]*"|\[[^\]]*\]/gu, "");
+  return /[hHsS]/.test(stripped) || stripped.toLowerCase().includes("mm:");
+}
+function decimalsAfter(code) {
+  const section = code.split(";")[0];
+  const m = /0\.(0+)/.exec(section);
+  return m ? m[1].length : 0;
+}
+
+// src/reader/ods/ods-styles.ts
+var OdsStyles = class {
+  constructor(content, styles) {
+    this.automatic = /* @__PURE__ */ new Map();
+    this.common = /* @__PURE__ */ new Map();
+    this.defaultStyle = null;
+    this.dataStyles = /* @__PURE__ */ new Map();
+    this.resolved = /* @__PURE__ */ new Map();
+    if (content) this.index(child(content, NS.OFFICE, "automatic-styles"), this.automatic);
+    if (styles) {
+      this.index(child(styles, NS.OFFICE, "styles"), this.common);
+      this.index(child(styles, NS.OFFICE, "automatic-styles"), this.common);
+    }
+    this.defaultFontSize = this.properties("Default").fontSize;
+  }
+  /**
+   * The format of one cell.
+   *
+   * @param styleName  the cell's effective style (cell, row default, column default, or "Default")
+   * @param valueType  office:value-type
+   * @param currency   office:currency, the ISO code a currency value carries
+   * @param dateHasTime whether an office:date-value carries a time of day
+   */
+  cellFormat(styleName, valueType, currency, dateHasTime) {
+    const p = this.properties(styleName);
+    let data = p.data;
+    const display = data?.displayFormat ?? null;
+    switch (valueType) {
+      case "date":
+        data = { displayFormat: display === "date" || display === "datetime" ? display : dateHasTime ? "datetime" : "date" };
+        break;
+      case "time":
+        data = { displayFormat: "datetime" };
+        break;
+      case "percentage":
+        if (display !== "percentage") {
+          data = { displayFormat: "percentage", ...data?.decimals !== void 0 ? { decimals: data.decimals } : {} };
+        }
+        break;
+      case "currency":
+        if (display !== "currency") {
+          data = { displayFormat: "currency", ...data?.decimals !== void 0 ? { decimals: data.decimals } : {} };
+        } else {
+          data = { ...data };
+        }
+        if (currency !== null && currency !== "") data.currency = currency;
+        break;
+    }
+    const format = new CellFormat({
+      bold: p.bold,
+      italic: p.italic,
+      textAlign: p.textAlign,
+      displayFormat: data?.displayFormat ?? null,
+      decimals: data?.decimals ?? null,
+      color: p.color,
+      backgroundColor: p.backgroundColor,
+      fontSize: p.fontSize !== null && p.fontSize !== this.defaultFontSize ? p.fontSize : null,
+      borderTop: p.borderTop,
+      borderRight: p.borderRight,
+      borderBottom: p.borderBottom,
+      borderLeft: p.borderLeft,
+      currency: data?.currency ?? null
+    });
+    return format.isEmpty() ? null : format;
+  }
+  index(container, into) {
+    if (!container) return;
+    for (const el2 of childrenIn(container, NS.STYLE)) {
+      const family = attr(el2, NS.STYLE, "family") ?? "";
+      if (el2.name === "default-style" && family === "table-cell") {
+        this.defaultStyle ?? (this.defaultStyle = el2);
+      } else if (el2.name === "style" && family === "table-cell") {
+        const name = attr(el2, NS.STYLE, "name") ?? "";
+        if (!into.has(name)) into.set(name, el2);
+      }
+    }
+    for (const el2 of childrenIn(container, NS.NUMBER)) {
+      const name = attr(el2, NS.STYLE, "name") ?? "";
+      if (!this.dataStyles.has(name)) this.dataStyles.set(name, el2);
+    }
+  }
+  /** The style and its ancestors, nearest first, ending with the default style. */
+  chain(name) {
+    const chain = [];
+    const seen = /* @__PURE__ */ new Set();
+    let el2 = this.automatic.get(name) ?? this.common.get(name);
+    while (el2 !== void 0 && !seen.has(name)) {
+      seen.add(name);
+      chain.push(el2);
+      name = attr(el2, NS.STYLE, "parent-style-name") ?? "";
+      el2 = name === "" ? void 0 : this.common.get(name) ?? this.automatic.get(name);
+    }
+    if (this.defaultStyle) chain.push(this.defaultStyle);
+    return chain;
+  }
+  properties(name) {
+    const cached = this.resolved.get(name);
+    if (cached) return cached;
+    const chain = this.chain(name);
+    const weight = first(chain, "text-properties", NS.FO, "font-weight");
+    const style = first(chain, "text-properties", NS.FO, "font-style");
+    const size = first(chain, "text-properties", NS.FO, "font-size");
+    let dataStyle = null;
+    for (const el2 of chain) {
+      const candidate = attr(el2, NS.STYLE, "data-style-name") ?? "";
+      if (candidate !== "") {
+        dataStyle = candidate;
+        break;
+      }
+    }
+    const sizeMatch = size !== null ? /^([0-9]*\.?[0-9]+)pt$/.exec(size) : null;
+    const resolved = {
+      bold: weight !== null && (weight === "bold" || phpIsNumeric(weight) && phpInt(weight) >= 600),
+      italic: style === "italic" || style === "oblique",
+      textAlign: textAlign(chain),
+      color: color(chain),
+      backgroundColor: background(chain),
+      fontSize: sizeMatch ? Math.trunc(parseFloat(sizeMatch[1])) : null,
+      borderTop: border(chain, "top"),
+      borderRight: border(chain, "right"),
+      borderBottom: border(chain, "bottom"),
+      borderLeft: border(chain, "left"),
+      data: this.dataFormat(dataStyle, 0)
+    };
+    this.resolved.set(name, resolved);
+    return resolved;
+  }
+  /** A data style -> displayFormat, decimals, currency. */
+  dataFormat(name, depth) {
+    if (name === null || depth > 4) return null;
+    const el2 = this.dataStyles.get(name);
+    if (!el2) return null;
+    for (const map of childrenIn(el2, NS.STYLE)) {
+      if (map.name !== "map") continue;
+      const condition = (attr(map, NS.STYLE, "condition") ?? "").replace(/[ \t\n\r\f\v]+/g, "");
+      if (condition === "value()>=0" || condition === "value()>0") {
+        const mapped = this.dataFormat(attr(map, NS.STYLE, "apply-style-name") ?? "", depth + 1);
+        if (mapped !== null) return mapped;
+      }
+    }
+    const parts = childrenIn(el2, NS.NUMBER);
+    const has = (local) => parts.some((p) => p.name === local);
+    const number = parts.find((p) => p.name === "number");
+    let decimals = null;
+    if (number) {
+      const places = attr(number, NS.NUMBER, "decimal-places") ?? attr(number, NS.NUMBER, "min-decimal-places");
+      decimals = places !== void 0 ? phpInt(places) : null;
+    }
+    switch (el2.name) {
+      case "number-style": {
+        if (has("scientific-number") || has("fraction")) return null;
+        for (const text of parts.filter((p) => p.name === "text")) {
+          const iso = currencyCode(ownText(text).replace(/[-()"\u00A0]/g, ""));
+          if (iso !== null) return { displayFormat: "currency", decimals: decimals ?? 0, currency: iso };
+        }
+        if (!number) return null;
+        return decimals === null ? { displayFormat: "auto" } : { displayFormat: "number", decimals };
+      }
+      case "percentage-style":
+        return { displayFormat: "percentage", decimals: decimals ?? 0 };
+      case "currency-style": {
+        const out = { displayFormat: "currency", decimals: decimals ?? 0 };
+        const symbol = parts.find((p) => p.name === "currency-symbol");
+        const iso = symbol ? currencyCode(ownText(symbol)) : null;
+        if (iso !== null) out.currency = iso;
+        return out;
+      }
+      case "date-style":
+        return ["hours", "minutes", "seconds", "am-pm"].some(has) ? { displayFormat: "datetime" } : { displayFormat: "date" };
+      case "time-style":
+        return { displayFormat: "datetime" };
+      case "text-style":
+        return { displayFormat: "text" };
+      default:
+        return null;
+    }
+  }
+};
+function first(chain, properties, ns, name) {
+  for (const el2 of chain) {
+    const props = child(el2, NS.STYLE, properties);
+    const value = attr(props, ns, name);
+    if (value !== void 0) return phpTrim(value);
+  }
+  return null;
+}
+function color(chain) {
+  for (const el2 of chain) {
+    const props = child(el2, NS.STYLE, "text-properties");
+    if (!props) continue;
+    if (attr(props, NS.STYLE, "use-window-font-color") === "true") return null;
+    const value = attr(props, NS.FO, "color");
+    if (value !== void 0) return hex(value);
+  }
+  return null;
+}
+function background(chain) {
+  const value = first(chain, "table-cell-properties", NS.FO, "background-color");
+  return value === null || value === "transparent" ? null : hex(value);
+}
+function border(chain, side) {
+  for (const el2 of chain) {
+    const props = child(el2, NS.STYLE, "table-cell-properties");
+    if (!props) continue;
+    const raw = attr(props, NS.FO, `border-${side}`) ?? attr(props, NS.FO, "border");
+    if (raw === void 0) continue;
+    const value = asciiLower(phpTrim(raw));
+    if (value === "" || /\b(none|hidden)\b/.test(value)) return null;
+    const m = /#([0-9a-f]{6})\b/.exec(value);
+    return m ? "#" + m[1].toUpperCase() : "#000000";
+  }
+  return null;
+}
+function textAlign(chain) {
+  if (first(chain, "table-cell-properties", NS.STYLE, "text-align-source") === "value-type") return null;
+  const align = first(chain, "paragraph-properties", NS.FO, "text-align");
+  if (align === null || align === "") return null;
+  if (align === "start") return "left";
+  if (align === "end") return "right";
+  return align;
+}
+function hex(value) {
+  const m = /^#([0-9a-fA-F]{6})$/.exec(phpTrim(value));
+  return m ? "#" + m[1].toUpperCase() : null;
+}
+function currencyCode(symbol) {
+  const s = phpTrim(symbol);
+  if (s === "") return null;
+  if (/^[A-Z]{3}$/.test(s)) return s;
+  return SYMBOL_TO_ISO[s] ?? null;
+}
+
+// src/reader/ods/ods-text.ts
+var SKIPPED = /* @__PURE__ */ new Set(["annotation", "note"]);
+function paragraphs(node) {
+  const lines = [];
+  for (const c of node.children) {
+    if (c.ns === NS.TEXT && (c.name === "p" || c.name === "h")) lines.push(paragraph(c));
+  }
+  return lines.length === 0 ? null : lines.join("\n");
+}
+function paragraph(p) {
+  const state = { out: "", ignoreSpace: true };
+  walk(p, state);
+  return state.out;
+}
+function walk(node, state) {
+  for (const item of node.content ?? []) {
+    if (typeof item === "string") {
+      appendCharacters(state, item);
+      continue;
+    }
+    if (SKIPPED.has(item.name)) continue;
+    if (item.name === "s") {
+      const c = item.attrs["c"];
+      const count = c !== void 0 && /^\d+$/.test(c) ? parseInt(c, 10) : 1;
+      state.out += " ".repeat(Math.max(1, count));
+      state.ignoreSpace = false;
+    } else if (item.name === "tab") {
+      state.out += "	";
+      state.ignoreSpace = false;
+    } else if (item.name === "line-break") {
+      state.out += "\n";
+      state.ignoreSpace = false;
+    }
+    walk(item, state);
+  }
+}
+function appendCharacters(state, chars) {
+  for (let i = 0; i < chars.length; i++) {
+    const c = chars[i];
+    if (c === " " || c === "	" || c === "\n" || c === "\r") {
+      if (!state.ignoreSpace) {
+        state.out += " ";
+        state.ignoreSpace = true;
+      }
+      continue;
+    }
+    state.out += c;
+    state.ignoreSpace = false;
+  }
+}
+
+// src/reader/format/date-inverter.ts
+var DateInverter = {
+  toIso(serial2, includeTime = false) {
+    const epoch = Date.UTC(1899, 11, 30, 0, 0, 0);
+    const ms = epoch + Math.round(serial2 * 86400) * 1e3;
+    const d = new Date(ms);
+    const pad = (n) => String(n).padStart(2, "0");
+    const date = `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+    if (!includeTime) return date;
+    return `${date}T${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}Z`;
+  }
+};
+
+// src/reader/workbook-schema.ts
+var WorkbookSchema = {
+  fromWorkbook(workbook) {
+    const schema = { sheets: workbook.sheets.map(sheetToSchema) };
+    if (Object.keys(workbook.meta).length > 0) schema["meta"] = workbook.meta;
+    return schema;
+  }
+};
+function sheetToSchema(sheet) {
+  const cells = {};
+  for (const [address, cell] of sheet.cells) {
+    const cellSchema = cellToSchema(cell);
+    if (cellSchema === null) continue;
+    cells[address] = cellSchema;
+  }
+  const out = { name: sheet.name, cells };
+  if (sheet.mergedRegions.length > 0) {
+    out["mergedRegions"] = sheet.mergedRegions.map((m) => ({ start: m.start, end: m.end }));
+  }
+  if (sheet.columnWidths.size > 0) {
+    const widths = {};
+    for (const [k, v] of sheet.columnWidths) widths[k] = v;
+    out["columnWidths"] = widths;
+  }
+  if (sheet.frozenRows > 0) out["frozenRows"] = sheet.frozenRows;
+  if (sheet.frozenCols > 0) out["frozenCols"] = sheet.frozenCols;
+  return out;
+}
+function cellToSchema(cell) {
+  let value = cell.value;
+  const format = cell.format;
+  if (format !== null && (format.displayFormat === "date" || format.displayFormat === "datetime") && isNumericString(value)) {
+    value = DateInverter.toIso(Number(value), format.displayFormat === "datetime");
+  }
+  const out = { value };
+  if (cell.formula !== null) out["formula"] = cell.formula;
+  if (cell.cachedValue !== null) out["computedValue"] = cell.cachedValue;
+  if (format !== null && !format.isEmpty()) out["format"] = formatToObject(format);
+  if (cell.comment !== null) out["comment"] = commentToObject(cell.comment);
+  if (Object.keys(out).length === 1 && out["value"] === null) return null;
+  return out;
+}
+function formatToObject(f) {
+  const out = {};
+  if (f.bold) out["bold"] = true;
+  if (f.italic) out["italic"] = true;
+  if (f.textAlign !== null) out["textAlign"] = f.textAlign;
+  if (f.displayFormat !== null) out["displayFormat"] = f.displayFormat;
+  if (f.decimals !== null) out["decimals"] = f.decimals;
+  if (f.color !== null) out["color"] = f.color;
+  if (f.backgroundColor !== null) out["backgroundColor"] = f.backgroundColor;
+  if (f.fontSize !== null) out["fontSize"] = f.fontSize;
+  if (f.borderTop !== null) out["borderTop"] = f.borderTop;
+  if (f.borderRight !== null) out["borderRight"] = f.borderRight;
+  if (f.borderBottom !== null) out["borderBottom"] = f.borderBottom;
+  if (f.borderLeft !== null) out["borderLeft"] = f.borderLeft;
+  if (f.currency !== null) out["currency"] = f.currency;
+  return out;
+}
+function commentToObject(c) {
+  const out = { text: c.text };
+  if (c.author !== null) out["author"] = c.author;
+  if (c.color !== null) out["color"] = c.color;
+  return out;
+}
+
 // src/reader/xml.ts
+var XML_NS = "http://www.w3.org/XML/1998/namespace";
 function localName(name) {
   const idx = name.indexOf(":");
   return idx >= 0 ? name.slice(idx + 1) : name;
@@ -2006,19 +2702,28 @@ function parseTag(inner) {
   while (i < trimmed.length && !/\s/.test(trimmed[i])) i++;
   const name = trimmed.slice(0, i);
   const attrs = {};
+  const raw = [];
   const rest = trimmed.slice(i);
   for (const m of rest.matchAll(ATTR_RE)) {
-    const key = localName(m[1]);
-    const value = unescapeXml(m[3] ?? m[4] ?? "");
-    attrs[key] = value;
+    const rawValue = m[3] ?? m[4] ?? "";
+    attrs[localName(m[1])] = unescapeXml(rawValue);
+    raw.push([m[1], rawValue]);
   }
-  return { name, attrs };
+  return { name, attrs, raw };
 }
-function parseXml(src) {
+function parseXml(src, options = {}) {
+  const namespaces = options.namespaces === true;
   let i = 0;
   const n = src.length;
   const root = { name: "#root", attrs: {}, children: [], text: "" };
+  if (namespaces) root.content = [];
   const stack = [root];
+  const scopes = [{ xml: XML_NS }];
+  const appendText = (text) => {
+    const top = stack[stack.length - 1];
+    top.text += text;
+    if (namespaces && text !== "") top.content.push(text);
+  };
   while (i < n) {
     if (src[i] === "<") {
       if (src.startsWith("<!--", i)) {
@@ -2028,7 +2733,7 @@ function parseXml(src) {
       }
       if (src.startsWith("<![CDATA[", i)) {
         const end2 = src.indexOf("]]>", i);
-        stack[stack.length - 1].text += src.slice(i + 9, end2 < 0 ? n : end2);
+        appendText(src.slice(i + 9, end2 < 0 ? n : end2));
         i = end2 < 0 ? n : end2 + 3;
         continue;
       }
@@ -2044,27 +2749,64 @@ function parseXml(src) {
       }
       if (src[i + 1] === "/") {
         const end2 = src.indexOf(">", i);
-        if (stack.length > 1) stack.pop();
+        if (stack.length > 1) {
+          stack.pop();
+          if (namespaces) scopes.pop();
+        }
         i = end2 < 0 ? n : end2 + 1;
         continue;
       }
       const end = findTagEnd(src, i + 1);
       const tagContent = src.slice(i + 1, end);
       const selfClosing = tagContent.endsWith("/");
-      const { name, attrs } = parseTag(selfClosing ? tagContent.slice(0, -1) : tagContent);
+      const { name, attrs, raw } = parseTag(selfClosing ? tagContent.slice(0, -1) : tagContent);
       const node = { name: localName(name), attrs, children: [], text: "" };
-      stack[stack.length - 1].children.push(node);
-      if (!selfClosing) stack.push(node);
+      const parent = stack[stack.length - 1];
+      parent.children.push(node);
+      let scope;
+      if (namespaces) {
+        scope = resolveNamespaces(node, name, raw, scopes[scopes.length - 1]);
+        parent.content.push(node);
+      }
+      if (!selfClosing) {
+        stack.push(node);
+        if (scope) scopes.push(scope);
+      }
       i = end + 1;
     } else {
       const next = src.indexOf("<", i);
       const stop = next < 0 ? n : next;
-      stack[stack.length - 1].text += unescapeXml(src.slice(i, stop));
+      appendText(unescapeXml(src.slice(i, stop)));
       i = stop;
     }
   }
   return root.children[0] ?? null;
 }
+function resolveNamespaces(node, qname, raw, parentScope) {
+  let scope = parentScope;
+  for (const [key, value] of raw) {
+    if (key === "xmlns" || key.startsWith("xmlns:")) {
+      if (scope === parentScope) scope = { ...parentScope };
+      scope[key === "xmlns" ? "" : key.slice(6)] = unescapeXml(value);
+    }
+  }
+  const colon = qname.indexOf(":");
+  node.ns = scope[colon >= 0 ? qname.slice(0, colon) : ""] ?? "";
+  node.content = [];
+  const nsAttrs = {};
+  for (const [key, value] of raw) {
+    if (key === "xmlns" || key.startsWith("xmlns:")) continue;
+    const idx = key.indexOf(":");
+    const normalised = unescapeXml(value.replace(/[\t\n\r]/g, " "));
+    if (idx < 0) {
+      nsAttrs[key] = normalised;
+    } else {
+      nsAttrs[`{${scope[key.slice(0, idx)] ?? ""}}${key.slice(idx + 1)}`] = normalised;
+    }
+  }
+  node.nsAttrs = nsAttrs;
+  return scope;
+}
 function el(node, name) {
   return node?.children.find((c) => c.name === name);
 }
@@ -2075,6 +2817,259 @@ function at(node, name) {
   return node?.attrs[name];
 }
 
+// src/reader/ods-reader.ts
+var MAX_ROWS = 1048576;
+var MAX_COLUMNS = 16384;
+var UNIX_EPOCH_SERIAL = 25569;
+var decoder3 = new TextDecoder();
+var OdsReader = class {
+  describe(bytes) {
+    return WorkbookSchema.fromWorkbook(this.readWorkbook(bytes));
+  }
+  readWorkbook(bytes) {
+    return this.readFiles(unzipSync(bytes));
+  }
+  /** Read an already-unzipped package (name -> bytes). */
+  readFiles(files) {
+    const getText = (name) => files[name] ? decoder3.decode(files[name]) : null;
+    const content = getText("content.xml");
+    if (content === null) throw new Error("[holy-sheet] missing content.xml");
+    const contentDoc = parseXml(content, { namespaces: true });
+    if (!contentDoc) throw new Error("[holy-sheet] failed to parse content.xml");
+    const stylesText = getText("styles.xml");
+    const stylesDoc = stylesText === null ? null : parseXml(stylesText, { namespaces: true });
+    const styles = new OdsStyles(contentDoc, stylesDoc);
+    const sheets = [];
+    const spreadsheet = child(child(contentDoc, NS.OFFICE, "body"), NS.OFFICE, "spreadsheet");
+    for (const table of spreadsheet?.children ?? []) {
+      if (table.ns === NS.TABLE && table.name === "table") sheets.push(this.readSheet(table, styles));
+    }
+    const meta = getText("meta.xml");
+    return new Workbook(sheets, meta === null ? {} : readMeta(meta));
+  }
+  readSheet(table, styles) {
+    const columns = [];
+    collectColumns(table, columns, { next: 0 });
+    const state = { row: 0, cells: /* @__PURE__ */ new Map(), merges: [] };
+    this.walkRows(table, styles, columns, state);
+    return new Sheet(attr(table, NS.TABLE, "name") ?? "", state.cells, state.merges);
+  }
+  walkRows(container, styles, columns, state) {
+    for (const el2 of container.children) {
+      if (state.row >= MAX_ROWS) return;
+      if (el2.ns !== NS.TABLE) continue;
+      if (el2.name === "table-row") {
+        this.readRow(el2, styles, columns, state);
+      } else if (el2.name === "table-header-rows" || el2.name === "table-rows" || el2.name === "table-row-group") {
+        this.walkRows(el2, styles, columns, state);
+      }
+    }
+  }
+  readRow(row, styles, columns, state) {
+    const repeat = Math.max(1, phpInt(attr(row, NS.TABLE, "number-rows-repeated") ?? "1"));
+    const rowStyle = attr(row, NS.TABLE, "default-cell-style-name") ?? "";
+    const entries = [];
+    let column = 0;
+    for (const cell of row.children) {
+      if (cell.ns !== NS.TABLE || cell.name !== "table-cell" && cell.name !== "covered-table-cell") continue;
+      const span = cell.name === "table-cell" ? [
+        Math.max(1, phpInt(attr(cell, NS.TABLE, "number-columns-spanned") ?? "1")),
+        Math.max(1, phpInt(attr(cell, NS.TABLE, "number-rows-spanned") ?? "1"))
+      ] : [1, 1];
+      const read = hasContent(cell) ? readCell(cell) : null;
+      const count = Math.max(1, phpInt(attr(cell, NS.TABLE, "number-columns-repeated") ?? "1"));
+      if (read !== null || span[0] !== 1 || span[1] !== 1) {
+        const style = attr(cell, NS.TABLE, "style-name") ?? "";
+        for (let i = 0; i < count && column + i < MAX_COLUMNS; i++) {
+          entries.push([column + i, read, span, style]);
+        }
+      }
+      column += count;
+      if (column >= MAX_COLUMNS) break;
+    }
+    if (entries.length === 0) {
+      state.row += repeat;
+      return;
+    }
+    for (let r = 0; r < repeat && state.row < MAX_ROWS; r++) {
+      const rowNumber = state.row + 1;
+      for (const [col, read, span, style] of entries) {
+        const address = CellAddress.letter(col) + rowNumber;
+        if (span[0] !== 1 || span[1] !== 1) {
+          state.merges.push(
+            new MergedRegion(
+              address,
+              CellAddress.letter(Math.min(col + span[0], MAX_COLUMNS) - 1) + Math.min(rowNumber + span[1] - 1, MAX_ROWS)
+            )
+          );
+        }
+        if (read === null) continue;
+        const styleName = style !== "" ? style : rowStyle !== "" ? rowStyle : columnStyle(columns, col);
+        const format = styles.cellFormat(styleName, read.type, read.currency, read.dateHasTime);
+        let value = read.value;
+        if (read.seconds !== null) {
+          value = isoFromSeconds(read.seconds, format?.displayFormat !== "date");
+        }
+        state.cells.set(address, new Cell(address, value, read.formula, format, read.comment, read.cached));
+      }
+      state.row++;
+    }
+  }
+};
+function collectColumns(container, columns, cursor) {
+  for (const el2 of container.children) {
+    if (el2.ns === NS.TABLE && el2.name === "table-column") {
+      const repeat = Math.max(1, phpInt(attr(el2, NS.TABLE, "number-columns-repeated") ?? "1"));
+      const style = attr(el2, NS.TABLE, "default-cell-style-name") ?? "";
+      if (style !== "") columns.push([cursor.next, cursor.next + repeat - 1, style]);
+      cursor.next += repeat;
+    } else if (el2.ns === NS.TABLE && (el2.name === "table-columns" || el2.name === "table-header-columns" || el2.name === "table-column-group")) {
+      collectColumns(el2, columns, cursor);
+    }
+    if (cursor.next >= MAX_COLUMNS) return;
+  }
+}
+function columnStyle(columns, column) {
+  for (const [first2, last, style] of columns) {
+    if (column >= first2 && column <= last) return style;
+  }
+  return "Default";
+}
+function hasContent(cell) {
+  if (attr(cell, NS.OFFICE, "value-type") !== void 0) return true;
+  if (attr(cell, NS.TABLE, "formula") !== void 0) return true;
+  if (child(cell, NS.OFFICE, "annotation") !== void 0) return true;
+  return (paragraphs(cell) ?? "") !== "";
+}
+function readCell(cell) {
+  const type = attr(cell, NS.OFFICE, "value-type") ?? null;
+  const text = paragraphs(cell);
+  let value = null;
+  let seconds = null;
+  let dateHasTime = false;
+  switch (type) {
+    case "float":
+    case "percentage":
+    case "currency":
+      value = toNumber(attr(cell, NS.OFFICE, "value") ?? "");
+      break;
+    case "boolean": {
+      const b = asciiLower(phpTrim(attr(cell, NS.OFFICE, "boolean-value") ?? ""));
+      value = b === "true" || b === "1";
+      break;
+    }
+    case "date": {
+      const raw = phpTrim(attr(cell, NS.OFFICE, "date-value") ?? "");
+      seconds = dateSeconds(raw);
+      dateHasTime = raw.includes("T");
+      break;
+    }
+    case "time": {
+      const duration = durationSeconds(attr(cell, NS.OFFICE, "time-value") ?? "");
+      seconds = duration === null ? null : duration - UNIX_EPOCH_SERIAL * 86400;
+      break;
+    }
+    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 ?? "";
+      break;
+    }
+    default:
+      value = text !== null && text !== "" ? text : null;
+  }
+  let formula = 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;
+      cached = seconds !== null ? serial(seconds) : value;
+      value = null;
+      seconds = null;
+    }
+  }
+  let comment = null;
+  const annotation = child(cell, NS.OFFICE, "annotation");
+  if (annotation) {
+    const creator = child(annotation, NS.DC, "creator");
+    const author = creator ? phpTrim(creator.text) : "";
+    comment = new CellComment(paragraphs(annotation) ?? "", author === "" ? null : author);
+  }
+  const currency = attr(cell, NS.OFFICE, "currency");
+  return {
+    value,
+    formula,
+    cached,
+    type,
+    currency: currency !== void 0 ? phpTrim(currency) : null,
+    dateHasTime,
+    comment,
+    seconds
+  };
+}
+function toNumber(raw) {
+  const s = phpTrim(raw);
+  if (s === "") return null;
+  if (/^-?\d+$/.test(s)) return parseInt(s, 10);
+  return phpIsNumeric(s) ? Number(s) : null;
+}
+function dateSeconds(raw) {
+  const m = /^(-?\d{4,})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2})(\.\d+)?)?)?(Z|[+-]\d{2}:?\d{2})?$/.exec(raw);
+  if (!m) return null;
+  const days = daysFromCivil(parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10));
+  let seconds = days * 86400 + phpInt(m[4] ?? "0") * 3600 + phpInt(m[5] ?? "0") * 60 + phpInt(m[6] ?? "0");
+  const fraction = m[7] !== void 0 && m[7] !== "" ? Number("0" + m[7]) : 0;
+  const zone = m[8] ?? "";
+  if (zone !== "" && zone !== "Z") {
+    const digits = zone.slice(1).replace(":", "");
+    const offset = phpInt(digits.slice(0, 2)) * 3600 + phpInt(digits.slice(2, 4)) * 60;
+    seconds -= zone[0] === "-" ? -offset : offset;
+  }
+  return seconds + Math.round(fraction);
+}
+function durationSeconds(raw) {
+  const m = /^(-)?P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/.exec(phpTrim(raw));
+  if (!m) return null;
+  const total = phpInt(m[2] ?? "0") * 86400 + phpInt(m[3] ?? "0") * 3600 + phpInt(m[4] ?? "0") * 60 + (m[5] ? Number(m[5]) : 0);
+  const seconds = Math.round(total);
+  return m[1] === "-" ? -seconds : seconds;
+}
+function daysFromCivil(year, month, day) {
+  year -= month <= 2 ? 1 : 0;
+  const era = Math.trunc((year >= 0 ? year : year - 399) / 400);
+  const yoe = year - era * 400;
+  const doy = Math.trunc((153 * (month + (month > 2 ? -3 : 9)) + 2) / 5) + day - 1;
+  const doe = yoe * 365 + Math.trunc(yoe / 4) - Math.trunc(yoe / 100) + doy;
+  return era * 146097 + doe - 719468;
+}
+function serial(seconds) {
+  return (seconds + UNIX_EPOCH_SERIAL * 86400) / 86400;
+}
+function isoFromSeconds(seconds, withTime) {
+  const d = new Date(seconds * 1e3);
+  const pad = (n, width = 2) => String(n).padStart(width, "0");
+  const date = `${pad(d.getUTCFullYear(), 4)}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+  if (!withTime) return date;
+  return `${date}T${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}Z`;
+}
+function readMeta(xml) {
+  const doc = parseXml(xml, { namespaces: true });
+  const meta = child(doc, NS.OFFICE, "meta");
+  if (!meta) return {};
+  const out = {};
+  const creator = child(meta, NS.META, "initial-creator") ?? child(meta, NS.DC, "creator");
+  if (creator && phpTrim(creator.text) !== "") out["creator"] = phpTrim(creator.text);
+  const created = child(meta, NS.META, "creation-date");
+  if (created && phpTrim(created.text) !== "") {
+    const value = phpTrim(created.text);
+    out["created"] = /(Z|[+-]\d{2}:?\d{2})$/.test(value) ? value : value + "Z";
+  }
+  return out;
+}
+
 // src/reader/comments-parser.ts
 var CommentsParser = {
   parse(commentsXml) {
@@ -2099,19 +3094,6 @@ function extractText(textNode) {
   return parts.join("");
 }
 
-// src/reader/format/date-inverter.ts
-var DateInverter = {
-  toIso(serial, includeTime = false) {
-    const epoch = Date.UTC(1899, 11, 30, 0, 0, 0);
-    const ms = epoch + Math.round(serial * 86400) * 1e3;
-    const d = new Date(ms);
-    const pad = (n) => String(n).padStart(2, "0");
-    const date = `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
-    if (!includeTime) return date;
-    return `${date}T${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}Z`;
-  }
-};
-
 // src/reader/rels-parser.ts
 var RelsParser = {
   parse(relsXml) {
@@ -2147,90 +3129,6 @@ function renderSi(si) {
   return els(si, "r").map((run) => el(run, "t")?.text ?? "").join("");
 }
 
-// src/reader/format/num-fmt-parser.ts
-var BUILTIN = {
-  0: "General",
-  1: "0",
-  2: "0.00",
-  3: "#,##0",
-  4: "#,##0.00",
-  9: "0%",
-  10: "0.00%",
-  11: "0.00E+00",
-  12: "# ?/?",
-  13: "# ??/??",
-  14: "mm-dd-yy",
-  15: "d-mmm-yy",
-  16: "d-mmm",
-  17: "mmm-yy",
-  18: "h:mm AM/PM",
-  19: "h:mm:ss AM/PM",
-  20: "h:mm",
-  21: "h:mm:ss",
-  22: "m/d/yy h:mm",
-  37: "#,##0 ;(#,##0)",
-  38: "#,##0 ;[Red](#,##0)",
-  39: "#,##0.00;(#,##0.00)",
-  40: "#,##0.00;[Red](#,##0.00)",
-  45: "mm:ss",
-  46: "[h]:mm:ss",
-  47: "mmss.0",
-  48: "##0.0E+0",
-  49: "@"
-};
-var SYMBOL_TO_ISO = {
-  $: "USD",
-  "\u20AC": "EUR",
-  "\xA3": "GBP",
-  "\xA5": "JPY",
-  "\u20B9": "INR",
-  "\u20A9": "KRW"
-};
-var NumFmtParser = {
-  parse(formatCode) {
-    if (formatCode === null) return null;
-    const code = formatCode;
-    if (code === "" || code === "General" || code === "@") {
-      return { displayFormat: code === "@" ? "text" : "auto" };
-    }
-    if (looksLikeDate(code)) {
-      return { displayFormat: hasTimeComponent(code) ? "datetime" : "date" };
-    }
-    if (code.includes("%")) {
-      return { displayFormat: "percentage", decimals: decimalsAfter(code) };
-    }
-    const m = /^"([^"]+)"/u.exec(code);
-    if (m) {
-      const iso = SYMBOL_TO_ISO[m[1]];
-      const result = { displayFormat: "currency", decimals: decimalsAfter(code) };
-      if (iso !== void 0) result.currency = iso;
-      return result;
-    }
-    if (/^#?,?#?#?0(\.0+)?$/.test(code.split(";")[0])) {
-      return { displayFormat: "number", decimals: decimalsAfter(code) };
-    }
-    return null;
-  },
-  parseBuiltin(id) {
-    const code = BUILTIN[id];
-    if (code === void 0) return null;
-    return NumFmtParser.parse(code);
-  }
-};
-function looksLikeDate(code) {
-  const stripped = code.replace(/"[^"]*"|\[[^\]]*\]/gu, "");
-  return /[ymd]/i.test(stripped);
-}
-function hasTimeComponent(code) {
-  const stripped = code.replace(/"[^"]*"|\[[^\]]*\]/gu, "");
-  return /[hHsS]/.test(stripped) || stripped.toLowerCase().includes("mm:");
-}
-function decimalsAfter(code) {
-  const section = code.split(";")[0];
-  const m = /0\.(0+)/.exec(section);
-  return m ? m[1].length : 0;
-}
-
 // src/reader/styles-parser.ts
 var StylesParser = {
   parse(stylesXml) {
@@ -2250,14 +3148,14 @@ var StylesParser = {
       const align = alignment && alignment.attrs["horizontal"] !== void 0 ? alignment.attrs["horizontal"] : null;
       const font = fonts[fontId] ?? null;
       const fill = fills[fillId] ?? null;
-      const border = borders[borderId] ?? null;
+      const border2 = borders[borderId] ?? null;
       const customCode = numFmts[numFmtId];
       const numFmtParsed = customCode !== void 0 ? NumFmtParser.parse(customCode) : NumFmtParser.parseBuiltin(numFmtId);
-      if (xfs.length === 0 && font === null && fill === null && border === null && !numFmtParsed && align === null) {
+      if (xfs.length === 0 && font === null && fill === null && border2 === null && !numFmtParsed && align === null) {
         xfs.push(null);
         continue;
       }
-      xfs.push(buildCellFormat(font, fill, border, numFmtParsed, align));
+      xfs.push(buildCellFormat(font, fill, border2, numFmtParsed, align));
     }
     return xfs;
   }
@@ -2272,12 +3170,12 @@ function parseNumFmts(xml) {
 function parseFonts(xml) {
   return els(el(xml, "fonts"), "font").map((f) => {
     const sz = el(f, "sz");
-    const color = el(f, "color");
+    const color2 = el(f, "color");
     return {
       bold: !!el(f, "b"),
       italic: !!el(f, "i"),
       size: sz ? Math.trunc(Number(at(sz, "val"))) : 11,
-      color: color && at(color, "rgb") !== void 0 ? argbToHex(at(color, "rgb")) : null
+      color: color2 && at(color2, "rgb") !== void 0 ? argbToHex(at(color2, "rgb")) : null
     };
   });
 }
@@ -2295,15 +3193,15 @@ function parseBorders(xml) {
     const rec = { top: null, right: null, bottom: null, left: null };
     for (const side of ["top", "right", "bottom", "left"]) {
       const sideEl = el(b, side);
-      const color = el(sideEl, "color");
-      if (sideEl && at(sideEl, "style") !== void 0 && at(sideEl, "style") !== "" && color && at(color, "rgb") !== void 0) {
-        rec[side] = argbToHex(at(color, "rgb"));
+      const color2 = el(sideEl, "color");
+      if (sideEl && at(sideEl, "style") !== void 0 && at(sideEl, "style") !== "" && color2 && at(color2, "rgb") !== void 0) {
+        rec[side] = argbToHex(at(color2, "rgb"));
       }
     }
     return rec;
   });
 }
-function buildCellFormat(font, fill, border, numFmt, align) {
+function buildCellFormat(font, fill, border2, numFmt, align) {
   return new CellFormat({
     bold: font?.bold ?? false,
     italic: font?.italic ?? false,
@@ -2313,10 +3211,10 @@ function buildCellFormat(font, fill, border, numFmt, align) {
     color: font?.color ?? null,
     backgroundColor: fill,
     fontSize: font && font.size !== 11 ? font.size : null,
-    borderTop: border?.top ?? null,
-    borderRight: border?.right ?? null,
-    borderBottom: border?.bottom ?? null,
-    borderLeft: border?.left ?? null,
+    borderTop: border2?.top ?? null,
+    borderRight: border2?.right ?? null,
+    borderBottom: border2?.bottom ?? null,
+    borderLeft: border2?.left ?? null,
     currency: numFmt?.currency ?? null
   });
 }
@@ -2416,14 +3314,17 @@ function parseFrozen(xml) {
 }
 
 // src/reader/xlsx-reader.ts
-var decoder2 = new TextDecoder();
+var decoder4 = new TextDecoder();
 var XlsxReader = class {
   describe(bytes) {
-    return this.workbookToSchema(this.readWorkbook(bytes));
+    return WorkbookSchema.fromWorkbook(this.readWorkbook(bytes));
   }
   readWorkbook(bytes) {
-    const files = unzipSync(bytes);
-    const getText = (name) => files[name] ? decoder2.decode(files[name]) : null;
+    return this.readFiles(unzipSync(bytes));
+  }
+  /** Read an already-unzipped package (name -> bytes), so a caller that sniffed it does not unzip twice. */
+  readFiles(files) {
+    const getText = (name) => files[name] ? decoder4.decode(files[name]) : null;
     const stylesXml = getText("xl/styles.xml");
     const stylesIndex = stylesXml ? StylesParser.parse(stylesXml) : [];
     const sharedStringsXml = getText("xl/sharedStrings.xml");
@@ -2472,69 +3373,7 @@ var XlsxReader = class {
     if (created) meta["created"] = created.text;
     return meta;
   }
-  workbookToSchema(workbook) {
-    const schema = { sheets: workbook.sheets.map((s) => this.sheetToSchema(s)) };
-    if (Object.keys(workbook.meta).length > 0) schema["meta"] = workbook.meta;
-    return schema;
-  }
-  sheetToSchema(sheet) {
-    const cells = {};
-    for (const [address, cell] of sheet.cells) {
-      const cellSchema = this.cellToSchema(cell);
-      if (cellSchema === null) continue;
-      cells[address] = cellSchema;
-    }
-    const out = { name: sheet.name, cells };
-    if (sheet.mergedRegions.length > 0) {
-      out["mergedRegions"] = sheet.mergedRegions.map((m) => ({ start: m.start, end: m.end }));
-    }
-    if (sheet.columnWidths.size > 0) {
-      const widths = {};
-      for (const [k, v] of sheet.columnWidths) widths[k] = v;
-      out["columnWidths"] = widths;
-    }
-    if (sheet.frozenRows > 0) out["frozenRows"] = sheet.frozenRows;
-    if (sheet.frozenCols > 0) out["frozenCols"] = sheet.frozenCols;
-    return out;
-  }
-  cellToSchema(cell) {
-    let value = cell.value;
-    const format = cell.format;
-    if (format !== null && (format.displayFormat === "date" || format.displayFormat === "datetime") && isNumericString(value)) {
-      value = DateInverter.toIso(Number(value), format.displayFormat === "datetime");
-    }
-    const out = { value };
-    if (cell.formula !== null) out["formula"] = cell.formula;
-    if (cell.cachedValue !== null) out["computedValue"] = cell.cachedValue;
-    if (format !== null && !format.isEmpty()) out["format"] = formatToObject(format);
-    if (cell.comment !== null) out["comment"] = commentToObject(cell.comment);
-    if (Object.keys(out).length === 1 && out["value"] === null) return null;
-    return out;
-  }
 };
-function formatToObject(f) {
-  const out = {};
-  if (f.bold) out["bold"] = true;
-  if (f.italic) out["italic"] = true;
-  if (f.textAlign !== null) out["textAlign"] = f.textAlign;
-  if (f.displayFormat !== null) out["displayFormat"] = f.displayFormat;
-  if (f.decimals !== null) out["decimals"] = f.decimals;
-  if (f.color !== null) out["color"] = f.color;
-  if (f.backgroundColor !== null) out["backgroundColor"] = f.backgroundColor;
-  if (f.fontSize !== null) out["fontSize"] = f.fontSize;
-  if (f.borderTop !== null) out["borderTop"] = f.borderTop;
-  if (f.borderRight !== null) out["borderRight"] = f.borderRight;
-  if (f.borderBottom !== null) out["borderBottom"] = f.borderBottom;
-  if (f.borderLeft !== null) out["borderLeft"] = f.borderLeft;
-  if (f.currency !== null) out["currency"] = f.currency;
-  return out;
-}
-function commentToObject(c) {
-  const out = { text: c.text };
-  if (c.author !== null) out["author"] = c.author;
-  if (c.color !== null) out["color"] = c.color;
-  return out;
-}
 function resolveRelativePath(base, target) {
   const baseDir = base.includes("/") ? base.slice(0, base.lastIndexOf("/")) : ".";
   const combined = baseDir + "/" + target;
@@ -2738,11 +3577,11 @@ var StylesRegistry = class {
     for (const b of this.borders) {
       bordersXml += "<border>";
       for (const side of ["left", "right", "top", "bottom"]) {
-        const color = b[side];
-        if (!color) {
+        const color2 = b[side];
+        if (!color2) {
           bordersXml += `<${side}/>`;
         } else {
-          bordersXml += `<${side} style="thin"><color rgb="${hexToArgb(color)}"/></${side}>`;
+          bordersXml += `<${side} style="thin"><color rgb="${hexToArgb(color2)}"/></${side}>`;
         }
       }
       bordersXml += "<diagonal/></border>";
@@ -2764,8 +3603,8 @@ var StylesRegistry = class {
     return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">' + numFmtsXml + fontsXml + fillsXml + bordersXml + '<cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs>' + cellXfsXml + '<cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles><dxfs count="0"/><tableStyles count="0" defaultTableStyle="TableStyleMedium2" defaultPivotStyle="PivotStyleLight16"/></styleSheet>';
   }
 };
-function hexToArgb(hex) {
-  const h = hex.replace(/^#/, "");
+function hexToArgb(hex2) {
+  const h = hex2.replace(/^#/, "");
   if (h.length === 6) return "FF" + h.toUpperCase();
   if (h.length === 8) return h.toUpperCase();
   return "FF000000";
@@ -2958,23 +3797,32 @@ var holy_sheet_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "https://github.com/Particle-Academy/holy-sheet/skills/holy-sheet.schema.json",
   title: "Holy Sheet workbook schema",
-  description: "Input format for HolySheet\\Agent::write(). Describes a multi-sheet xlsx workbook agentically. v0.2.0 supports scalar values, formulas (cached), and multiple sheets. Styles, formats, comments, merges land in subsequent minors.",
+  description: "Input format for HolySheet\\Agent::write(). Describes a multi-sheet xlsx workbook agentically. Everything in this schema is SUPPORTED NOW: values, formulas, per-column types and number formats, per-cell styling, themes, merges, frozen panes, column widths, totals and comments. A workbook is judged by how it READS, not only by whether the numbers are right \u2014 money should render as money and a header row should look like one, so prefer a typed column over a raw number and set the presentation the document needs.",
   type: "object",
-  required: ["sheets"],
+  required: [
+    "sheets"
+  ],
   additionalProperties: false,
   properties: {
     sheets: {
       type: "array",
       minItems: 1,
       description: "One or more sheets. The first sheet is shown when the file opens.",
-      items: { $ref: "#/definitions/Sheet" }
+      items: {
+        $ref: "#/definitions/Sheet"
+      }
     },
     meta: {
       type: "object",
       description: "Optional workbook metadata surfaced in Excel's File \u2192 Info pane.",
       properties: {
-        creator: { type: "string" },
-        created: { type: "string", description: "ISO-8601 datetime. Defaults to now()." }
+        creator: {
+          type: "string"
+        },
+        created: {
+          type: "string",
+          description: "ISO-8601 datetime. Defaults to now()."
+        }
       },
       additionalProperties: true
     }
@@ -2982,11 +3830,24 @@ var holy_sheet_schema_default = {
   definitions: {
     Sheet: {
       type: "object",
-      required: ["name"],
+      required: [
+        "name"
+      ],
       additionalProperties: false,
       oneOf: [
-        { required: ["columns", "rows"], description: "Row-oriented (agent-ergonomic)." },
-        { required: ["cells"], description: "Sparse A1-keyed map (fancy-sheets passthrough)." }
+        {
+          required: [
+            "columns",
+            "rows"
+          ],
+          description: "Row-oriented (agent-ergonomic)."
+        },
+        {
+          required: [
+            "cells"
+          ],
+          description: "Sparse A1-keyed map (fancy-sheets passthrough)."
+        }
       ],
       properties: {
         name: {
@@ -2997,7 +3858,9 @@ var holy_sheet_schema_default = {
         },
         columns: {
           type: "array",
-          items: { $ref: "#/definitions/Column" },
+          items: {
+            $ref: "#/definitions/Column"
+          },
           description: "When present, the first row is the header row. Column types are applied to every row in that column."
         },
         rows: {
@@ -3005,89 +3868,155 @@ var holy_sheet_schema_default = {
           items: {
             type: "array",
             description: "One row of cell values, in column order. Use null for missing values.",
-            items: { $ref: "#/definitions/CellValue" }
+            items: {
+              $ref: "#/definitions/CellValue"
+            }
           }
         },
         cells: {
           type: "object",
-          description: "Sparse A1-keyed map. Use this shape when exporting from <Spreadsheet>.",
-          additionalProperties: { $ref: "#/definitions/CellData" },
+          description: "Sparse cells keyed by A1 address, for anything the row/column model does not cover \u2014 a title band, a callout, a note. May be used ALONGSIDE columns/rows: the explicit cell wins at its address and inherits that column's format for anything it does not set.",
+          additionalProperties: {
+            $ref: "#/definitions/CellData"
+          },
           patternProperties: {
-            "^[A-Z]+[1-9][0-9]*$": { $ref: "#/definitions/CellData" }
+            "^[A-Z]+[1-9][0-9]*$": {
+              $ref: "#/definitions/CellData"
+            }
           }
         },
         totals: {
           type: "object",
-          description: "Symbolic aggregations appended below the data. Key = column header; value = aggregation. Lands in 0.7.",
+          description: "Symbolic aggregations appended below the data. Key = column header; value = one of sum, avg, count, min, max. These become real FORMULAS, so a total updates when a figure above it is edited \u2014 a row of typed numbers looks identical and is wrong the moment anyone changes anything.",
           additionalProperties: {
             type: "string",
-            enum: ["sum", "avg", "count", "min", "max"]
+            enum: [
+              "sum",
+              "avg",
+              "count",
+              "min",
+              "max"
+            ]
           }
         },
         theme: {
           type: "string",
-          enum: ["default", "minimal", "plain", "business"],
+          enum: [
+            "default",
+            "minimal",
+            "plain",
+            "business"
+          ],
           default: "default",
-          description: "Pre-baked style preset. Lands in 0.3."
+          description: "Pre-baked style preset applied to headers, banding and totals. The cheapest way to make a sheet look deliberate: set it unless you are styling every cell yourself."
         },
         mergedRegions: {
           type: "array",
           items: {
             type: "object",
-            required: ["start", "end"],
+            required: [
+              "start",
+              "end"
+            ],
             properties: {
-              start: { type: "string", description: "A1 ref of top-left." },
-              end: { type: "string", description: "A1 ref of bottom-right." }
+              start: {
+                type: "string",
+                description: "A1 ref of top-left."
+              },
+              end: {
+                type: "string",
+                description: "A1 ref of bottom-right."
+              }
             }
           },
-          description: "Cells to merge. Lands in 0.5."
+          description: 'Cells to merge, as [{start, end}] \u2014 e.g. [{"start": "A1", "end": "D1"}]. Use it for a title band spanning the table.'
         },
         columnWidths: {
           type: "object",
-          description: "Override widths in pixels. Keys are 0-based column indexes. Lands in 0.5.",
-          additionalProperties: { type: "number", minimum: 0 }
+          description: "Override widths in pixels. Keys are 0-based column indexes. Set these when a header or a formatted number would otherwise be cut off or shown as ####.",
+          additionalProperties: {
+            type: "number",
+            minimum: 0
+          }
+        },
+        frozenRows: {
+          type: "integer",
+          minimum: 0,
+          description: "How many rows stay visible while the sheet scrolls. Set to 1 whenever there is a header row, so the reader can still see what the columns are further down."
         },
-        frozenRows: { type: "integer", minimum: 0, description: "Lands in 0.5." },
-        frozenCols: { type: "integer", minimum: 0, description: "Lands in 0.5." }
+        frozenCols: {
+          type: "integer",
+          minimum: 0,
+          description: "How many columns stay visible while the sheet scrolls sideways. Set to 1 when the first column is the label for the row."
+        }
       }
     },
     Column: {
       type: "object",
-      required: ["header"],
+      required: [
+        "header"
+      ],
       additionalProperties: false,
       properties: {
-        header: { type: "string" },
+        header: {
+          type: "string"
+        },
         type: {
           type: "string",
-          enum: ["auto", "string", "number", "integer", "boolean", "date", "datetime", "currency", "percent", "formula"],
+          enum: [
+            "auto",
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "date",
+            "datetime",
+            "currency",
+            "percent",
+            "formula"
+          ],
           default: "auto",
-          description: "Cell type applied to every value in this column. 'auto' infers per cell."
+          description: "Cell type applied to every value in this column, and the main thing deciding whether the sheet reads as a document or as a dump. Use 'currency' for money, 'percent' for rates and 'date' for dates \u2014 'auto' infers a plain number and leaves 1250000.5 looking like 1250000.5."
         },
         currency: {
           type: "string",
-          description: "ISO-4217 code (USD, EUR, JPY, ...) when type=currency. Defaults to config('holy-sheet.locale')."
+          description: "ISO currency code for a 'currency' column, e.g. USD. Pair it with decimals: 2."
         },
         decimals: {
           type: "integer",
           minimum: 0,
           maximum: 10,
-          description: "Display decimals for number/currency/percent. Default 2 for currency, 1 for percent, 0 for integer, none for number."
+          description: "Decimal places for a numeric, currency or percent column. Money is normally 2; a growth rate is normally 1."
         },
         format: {
           type: "string",
           description: "Custom Excel number format string. Overrides type-derived format. Power-user escape hatch."
         },
-        width: { type: "number", minimum: 0, description: "Column width in pixels. Same as columnWidths but per-column." }
+        width: {
+          type: "number",
+          minimum: 0,
+          description: "Column width in pixels. Same as columnWidths but per-column."
+        }
       }
     },
     CellValue: {
       description: "A primitive value, null, or an object {value, formula, format, comment} for per-cell control.",
       oneOf: [
-        { type: "string" },
-        { type: "number" },
-        { type: "boolean" },
-        { type: "null" },
-        { $ref: "#/definitions/CellData" }
+        {
+          type: "string"
+        },
+        {
+          type: "number"
+        },
+        {
+          type: "boolean"
+        },
+        {
+          type: "null"
+        },
+        {
+          $ref: "#/definitions/CellData"
+        }
       ]
     },
     CellData: {
@@ -3097,10 +4026,18 @@ var holy_sheet_schema_default = {
         value: {
           description: "Raw cell value.",
           oneOf: [
-            { type: "string" },
-            { type: "number" },
-            { type: "boolean" },
-            { type: "null" }
+            {
+              type: "string"
+            },
+            {
+              type: "number"
+            },
+            {
+              type: "boolean"
+            },
+            {
+              type: "null"
+            }
           ]
         },
         formula: {
@@ -3109,53 +4046,125 @@ var holy_sheet_schema_default = {
         },
         computedValue: {
           description: "Cached value from a previous evaluation. When present, Excel shows it without recomputing on open.",
-          oneOf: [{ type: "string" }, { type: "number" }, { type: "boolean" }, { type: "null" }]
+          oneOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "number"
+            },
+            {
+              type: "boolean"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        format: {
+          $ref: "#/definitions/CellFormat"
         },
-        format: { $ref: "#/definitions/CellFormat" },
-        comment: { $ref: "#/definitions/CellComment" }
+        comment: {
+          $ref: "#/definitions/CellComment"
+        }
       }
     },
     CellFormat: {
       type: "object",
-      description: "Per-cell format. Lands in 0.3.",
+      description: "Per-cell presentation: bold, italic, font size, text and background colour, alignment, borders and number format. Use it for the things a column type cannot express \u2014 a title band, a highlighted figure, a ruled callout.",
       additionalProperties: false,
       properties: {
-        bold: { type: "boolean" },
-        italic: { type: "boolean" },
-        textAlign: { type: "string", enum: ["left", "center", "right"] },
+        bold: {
+          type: "boolean"
+        },
+        italic: {
+          type: "boolean"
+        },
+        textAlign: {
+          type: "string",
+          enum: [
+            "left",
+            "center",
+            "right"
+          ]
+        },
         displayFormat: {
           type: "string",
-          enum: ["auto", "text", "number", "date", "datetime", "percentage", "currency"]
+          enum: [
+            "auto",
+            "text",
+            "number",
+            "date",
+            "datetime",
+            "percentage",
+            "currency"
+          ]
+        },
+        decimals: {
+          type: "integer",
+          minimum: 0,
+          maximum: 10
         },
-        decimals: { type: "integer", minimum: 0, maximum: 10 },
-        color: { type: "string", description: "Hex color (#RRGGBB) for text." },
-        backgroundColor: { type: "string", description: "Hex color for cell fill." },
-        fontSize: { type: "integer", minimum: 6, maximum: 72 },
-        borderTop: { type: "string" },
-        borderRight: { type: "string" },
-        borderBottom: { type: "string" },
-        borderLeft: { type: "string" }
+        color: {
+          type: "string",
+          description: "Hex color (#RRGGBB) for text."
+        },
+        backgroundColor: {
+          type: "string",
+          description: "Hex color for cell fill."
+        },
+        fontSize: {
+          type: "integer",
+          minimum: 6,
+          maximum: 72
+        },
+        borderTop: {
+          type: "string"
+        },
+        borderRight: {
+          type: "string"
+        },
+        borderBottom: {
+          type: "string"
+        },
+        borderLeft: {
+          type: "string"
+        }
       }
     },
     CellComment: {
       type: "object",
-      description: "Lands in 0.6.",
-      required: ["text"],
+      description: "A reviewer note attached to a cell. Accepts a plain string, or an object with text/author/color.",
+      required: [
+        "text"
+      ],
       additionalProperties: false,
       properties: {
-        text: { type: "string" },
-        author: { type: "string" },
-        color: { type: "string", description: "Hex color for the corner triangle indicator." }
+        text: {
+          type: "string"
+        },
+        author: {
+          type: "string"
+        },
+        color: {
+          type: "string",
+          description: "Hex color for the corner triangle indicator."
+        }
       }
     }
   }
 };
 
 // src/agent.ts
-var VERSION = "2.2.1";
+var VERSION = "2.3.1";
 function toU8(input) {
   return input instanceof Uint8Array ? input : new Uint8Array(input);
 }
+function readSpreadsheet(bytes, path) {
+  const { format, files } = FormatSniffer.sniff(bytes, path);
+  const workbook = format === "ods" ? new OdsReader().readFiles(files) : new XlsxReader().readFiles(files);
+  return WorkbookSchema.fromWorkbook(workbook);
+}
 var Agent = {
   /** Validate a schema without writing. Empty array = valid. */
   validate(schema) {
@@ -3180,16 +4189,20 @@ var Agent = {
   toolDefinition() {
     return holy_sheet_schema_default;
   },
-  /** Round-trip xlsx bytes back to a schema. Universal. */
+  /**
+   * Round-trip xlsx or ods bytes back to a schema. Universal. The format is
+   * told apart by content, never by name, and both describe to the same
+   * schema. Throws `UnsupportedFormatException` for anything else.
+   */
   read(input) {
-    return new XlsxReader().describe(toU8(input));
+    return readSpreadsheet(toU8(input), null);
   },
-  /** Round-trip an xlsx file on disk back to a schema (Node only). */
+  /** Round-trip an xlsx or ods file on disk back to a schema (Node only). */
   async describe(path) {
     const fs = await import('fs');
     if (!fs.existsSync(path)) return { error: "not_found", path };
     const bytes = fs.readFileSync(path);
-    return new XlsxReader().describe(new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength));
+    return readSpreadsheet(new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength), path);
   },
   /** Validate + conservative repairs in one call. */
   validateAndRepair(schema) {
@@ -3257,13 +4270,16 @@ exports.Agent = Agent;
 exports.ArrayBuilder = ArrayBuilder;
 exports.CellAddress = CellAddress;
 exports.CsvBuilder = CsvBuilder;
+exports.FormatSniffer = FormatSniffer;
 exports.FormulaLinter = FormulaLinter;
 exports.HolySheet = HolySheet;
 exports.Inference = Inference;
 exports.Normalizer = Normalizer;
+exports.OdsReader = OdsReader;
 exports.Repairer = Repairer;
 exports.SchemaException = SchemaException;
 exports.Theme = Theme;
+exports.UnsupportedFormatException = UnsupportedFormatException;
 exports.VERSION = VERSION;
 exports.Validator = Validator;
 exports.XlsxReader = XlsxReader;