@bendyline/squisq-formats 2.5.0 → 2.6.0

package/dist/{chunk-A6LSCIO5.js → chunk-OBADJV7C.js}

@@ -1,23 +1,9 @@
 import {
-  extractPlainText,
-  inlineToPlainText
-} from "./chunk-AVOZAKGP.js";
+  planDataSidecar
+} from "./chunk-DXYWKZ52.js";
 import {
-  createPackage
-} from "./chunk-ILCJ3WFD.js";
-import {
-  escapeXml,
-  xmlDeclaration
-} from "./chunk-JU2RHXUB.js";
-import {
-  CONTENT_TYPE_XLSX_STYLES,
-  CONTENT_TYPE_XLSX_WORKBOOK,
-  CONTENT_TYPE_XLSX_WORKSHEET,
   NS_R,
   NS_SML,
-  REL_OFFICE_DOCUMENT,
-  REL_STYLES,
-  REL_WORKSHEET,
   baseDirOf,
   getPartRelationships,
   getPartXml,
@@ -25,9 +11,6 @@ import {
   requireMainPartPath
 } from "./chunk-S5PCVMKU.js";
 
-// src/xlsx/index.ts
-import { markdownToDoc } from "@bendyline/squisq/doc";
-
 // src/xlsx/cells.ts
 var MAX_COL_INDEX = 16383;
 var MAX_ROW_INDEX = 1048575;
@@ -387,7 +370,116 @@ function peelCaptionRow(grid, rect) {
   return { caption, rect: { ...rect, top: rect.top + 1 } };
 }
 
+// src/xlsx/tables.ts
+function columnLetter2(index) {
+  let n = index;
+  let out = "";
+  do {
+    out = String.fromCharCode(65 + n % 26) + out;
+    n = Math.floor(n / 26) - 1;
+  } while (n >= 0);
+  return out;
+}
+function a1(row, col) {
+  return `${columnLetter2(col)}${row + 1}`;
+}
+function regionHasHeader(cells) {
+  if (cells.length < 2) return false;
+  const first = cells[0];
+  if (!first || first.length === 0) return false;
+  return first.every((cell) => cell.kind === "string");
+}
+function cellValue(cell) {
+  if (cell.kind === "empty" || cell.kind === "error") return null;
+  if (cell.value !== void 0) return cell.value;
+  return cell.text === "" ? null : cell.text;
+}
+function dominantKind(kinds) {
+  const counts = /* @__PURE__ */ new Map();
+  let total = 0;
+  for (const kind of kinds) {
+    if (kind === "empty") continue;
+    counts.set(kind, (counts.get(kind) ?? 0) + 1);
+    total += 1;
+  }
+  if (total === 0) return "empty";
+  let best = "string";
+  let bestCount = 0;
+  for (const [kind, count] of counts) {
+    if (count > bestCount) {
+      best = kind;
+      bestCount = count;
+    }
+  }
+  return bestCount * 2 > total ? best : "mixed";
+}
+function sliceRegion(grid, rect) {
+  const out = [];
+  for (let r = rect.top; r <= rect.bottom; r++) {
+    const row = [];
+    for (let c = rect.left; c <= rect.right; c++) {
+      row.push(grid[r]?.[c] ?? { text: "", kind: "empty" });
+    }
+    out.push(row);
+  }
+  return out;
+}
+function regionToTable(sheet, grid, rect, title, minRows) {
+  const cells = sliceRegion(grid, rect);
+  if (cells.length === 0) return null;
+  const hasHeader = regionHasHeader(cells);
+  const body = hasHeader ? cells.slice(1) : cells;
+  if (body.length < minRows) return null;
+  if (!body.some((row) => row.some(isOccupied))) return null;
+  const width = cells.reduce((max, row) => Math.max(max, row.length), 0);
+  const columns = [];
+  for (let c = 0; c < width; c++) {
+    const header = hasHeader ? cells[0]?.[c]?.text ?? "" : "";
+    columns.push({
+      name: header.trim() || columnLetter2(rect.left + c),
+      kind: dominantKind(body.map((row) => row[c]?.kind ?? "empty"))
+    });
+  }
+  return {
+    sheet,
+    anchor: a1(rect.top, rect.left),
+    ...title ? { title } : {},
+    columns,
+    hasHeader,
+    rows: body.map(
+      (row) => Array.from({ length: width }, (_, c) => cellValue(row[c] ?? { text: "", kind: "empty" }))
+    )
+  };
+}
+function gridToTables(sheet, grid, merges = [], options = {}) {
+  if (grid.length === 0) return [];
+  const minRows = options.minRows ?? 1;
+  const plan = detectRegions(grid, merges, {
+    ...options.maxRegionsPerSheet !== void 0 ? { maxRegionsPerSheet: options.maxRegionsPerSheet } : {},
+    ...options.minRegionCells !== void 0 ? { minRegionCells: options.minRegionCells } : {},
+    ...options.signal ? { signal: options.signal } : {}
+  });
+  if (plan.degraded || plan.regions.length === 0) {
+    const rect = {
+      top: 0,
+      left: 0,
+      bottom: grid.length - 1,
+      right: grid.reduce((max, row) => Math.max(max, row.length), 1) - 1
+    };
+    const whole = regionToTable(sheet, grid, rect, void 0, minRows);
+    return whole ? [whole] : [];
+  }
+  const out = [];
+  for (const region of plan.regions) {
+    const table = regionToTable(sheet, grid, region.rect, region.title, minRows);
+    if (table) out.push(table);
+  }
+  return out;
+}
+
 // src/xlsx/import.ts
+import { stringifyMarkdown } from "@bendyline/squisq/markdown";
+import { MemoryContentContainer } from "@bendyline/squisq/storage";
 var XLSX_MAIN_PART = "xl/workbook.xml";
 function attrNS(el, ns, local, fallback) {
   return el.getAttributeNS(ns, local) ?? el.getAttribute(fallback);
@@ -401,7 +493,7 @@ function resolveTarget(baseDir, target) {
   }
   return stack.join("/");
 }
-async function readWorkbook(pkg, mainPart) {
+async function listSheetParts(pkg, mainPart) {
   const wb = await getPartXml(pkg, mainPart);
   if (!wb) {
     throw new Error(`Invalid XLSX package: workbook part "${mainPart}" could not be parsed.`);
@@ -417,11 +509,22 @@ async function readWorkbook(pkg, mainPart) {
     const target = rid ? relById.get(rid) : void 0;
     if (target) out.push({ name, path: resolveTarget(baseDirOf(mainPart), target) });
   }
+  return out;
+}
+async function readWorkbook(pkg, mainPart) {
+  const wb = await getPartXml(pkg, mainPart);
+  if (!wb) {
+    throw new Error(`Invalid XLSX package: workbook part "${mainPart}" could not be parsed.`);
+  }
+  const sheets = await listSheetParts(pkg, mainPart);
   const workbookPr = wb.getElementsByTagNameNS(NS_SML, "workbookPr")[0];
   const date1904Value = workbookPr?.getAttribute("date1904");
+  const calcPr = wb.getElementsByTagNameNS(NS_SML, "calcPr")[0];
+  const fullCalcValue = calcPr?.getAttribute("fullCalcOnLoad");
   return {
-    sheets: out,
-    date1904: date1904Value === "1" || date1904Value === "true"
+    sheets,
+    date1904: date1904Value === "1" || date1904Value === "true",
+    fullCalcOnLoad: fullCalcValue === "1" || fullCalcValue === "true"
   };
 }
 function isPhonetic(el, root) {
@@ -553,6 +656,16 @@ function excelTimeText(serial, includeSeconds, elapsedHours) {
   const seconds = totalSeconds % 60;
   return `${twoDigits(hours)}:${twoDigits(minutes)}${includeSeconds ? `:${twoDigits(seconds)}` : ""}`;
 }
+function dateValueText(serial, kind, style, date1904) {
+  if (!Number.isFinite(serial)) return null;
+  const normalized = style ? normalizeFormatCode(style.formatCode) : "";
+  if (kind === "time")
+    return excelTimeText(serial, /s/.test(normalized), /\[[h]+\]/.test(normalized));
+  const date = excelDateText(serial, date1904);
+  if (!date) return null;
+  if (kind === "datetime") return `${date} ${excelTimeText(serial, /s/.test(normalized), false)}`;
+  return date;
+}
 function formattedNumberText(raw, style, date1904) {
   if (!style) return raw;
   const value = Number(raw);
@@ -581,32 +694,37 @@ function formattedNumberText(raw, style, date1904) {
 function readFormula(cell, row, col, ctx) {
   const fEls = cell.getElementsByTagNameNS(NS_SML, "f");
   const f = fEls.length ? fEls[0] : null;
-  if (!f) return "";
+  if (!f) return { text: "" };
   const text = (f.textContent ?? "").trim();
-  if (f.getAttribute("t") !== "shared") return text;
+  if (f.getAttribute("t") !== "shared") return { text };
   const si = f.getAttribute("si");
-  if (si === null) return text;
+  if (si === null) return { text };
   if (text !== "") {
     ctx.sharedFormulas.set(si, { text, row, col });
-    return text;
+    return { text, sharedRole: "master" };
   }
   const master = ctx.sharedFormulas.get(si);
-  if (!master) return "";
+  if (!master) return { text: "", sharedRole: "follower" };
   try {
-    return translateFormula(master.text, row - master.row, col - master.col);
+    return {
+      text: translateFormula(master.text, row - master.row, col - master.col),
+      sharedRole: "follower"
+    };
   } catch {
-    return "";
+    return { text: "", sharedRole: "follower" };
   }
 }
 function readCell(cell, row, col, ctx) {
-  const formula = readFormula(cell, row, col, ctx);
-  const withFormula = (text2, kind2) => {
+  const { text: formula, sharedRole } = readFormula(cell, row, col, ctx);
+  const withFormula = (text2, kind2, value) => {
     const out = { text: text2, kind: text2 === "" ? "empty" : kind2 };
     if (formula !== "") out.formula = formula;
+    if (sharedRole !== void 0) out.sharedFormulaRole = sharedRole;
+    if (value !== void 0 && out.kind !== "empty") out.value = value;
     return out;
   };
   const stringCell = (item) => {
-    const out = withFormula(item.text, "string");
+    const out = withFormula(item.text, "string", item.text);
     if (item.rich && out.kind !== "empty") out.richText = item.rich;
     return out;
   };
@@ -619,14 +737,19 @@ function readCell(cell, row, col, ctx) {
   const v = vEls.length ? vEls[0].textContent ?? "" : "";
   if (v === "") return withFormula("", "empty");
   if (t === "s") return stringCell(ctx.shared[Number.parseInt(v, 10)] ?? { text: "" });
-  if (t === "b") return withFormula(v === "1" ? "TRUE" : "FALSE", "bool");
+  if (t === "b") return withFormula(v === "1" ? "TRUE" : "FALSE", "bool", v === "1");
   if (t === "e") return withFormula(v, "error");
-  if (t === "str") return withFormula(v, "string");
+  if (t === "str") return withFormula(v, "string", v);
   const style = ctx.styles[Number.parseInt(cell.getAttribute("s") ?? "0", 10)];
   const text = formattedNumberText(v, style, ctx.date1904);
   const dateLike = style ? numberFormatKind(style.formatCode) : "general";
   const kind = dateLike === "date" || dateLike === "time" || dateLike === "datetime" ? "date" : "number";
-  return withFormula(text, kind);
+  const numeric = Number(v);
+  if (kind === "date") {
+    const iso = dateValueText(numeric, dateLike, style, ctx.date1904);
+    return withFormula(text, kind, iso ?? text);
+  }
+  return withFormula(text, kind, Number.isFinite(numeric) ? numeric : v);
 }
 async function sheetToCells(pkg, path, shared, styles, date1904) {
   const doc = await getPartXml(pkg, path);
@@ -723,7 +846,70 @@ function annotatedHeading(depth, text, params) {
     templateAnnotation: { template: "dataTable", params }
   };
 }
+async function xlsxToTables(data, options = {}) {
+  const pkg = await openPackage(data, options);
+  const mainPart = requireMainPartPath(pkg, XLSX_MAIN_PART, "XLSX");
+  const [{ sheets, date1904 }, shared, styles] = await Promise.all([
+    readWorkbook(pkg, mainPart),
+    readSharedStrings(pkg),
+    readCellStyles(pkg)
+  ]);
+  let selected = sheets;
+  if (options.sheet !== void 0) {
+    const picked = typeof options.sheet === "number" ? sheets[options.sheet] : sheets.find((s) => s.name === options.sheet);
+    selected = picked ? [picked] : [];
+  }
+  const out = [];
+  for (const sheet of selected) {
+    const { cells, merges } = await sheetToCells(pkg, sheet.path, shared, styles, date1904);
+    out.push(...gridToTables(sheet.name, cells, merges, options));
+  }
+  return out;
+}
+async function xlsxToCellGrids(data, options = {}) {
+  const pkg = await openPackage(data, options);
+  const mainPart = requireMainPartPath(pkg, XLSX_MAIN_PART, "XLSX");
+  const [{ sheets, date1904, fullCalcOnLoad }, shared, styles] = await Promise.all([
+    readWorkbook(pkg, mainPart),
+    readSharedStrings(pkg),
+    readCellStyles(pkg)
+  ]);
+  let selected = sheets;
+  if (options.sheet !== void 0) {
+    const picked = typeof options.sheet === "number" ? sheets[options.sheet] : sheets.find((s) => s.name === options.sheet);
+    selected = picked ? [picked] : [];
+  }
+  const out = [];
+  for (const sheet of selected) {
+    const { cells, merges } = await sheetToCells(pkg, sheet.path, shared, styles, date1904);
+    out.push({ name: sheet.name, cells, merges });
+  }
+  return { sheets: out, date1904, fullCalcOnLoad };
+}
 async function xlsxToMarkdownDoc(data, options = {}) {
+  return workbookToMarkdown(data, options, void 0);
+}
+function shouldSpillRegion(spill, rect, hasHeader) {
+  if (spill.mode === "always") return true;
+  const height = rect.bottom - rect.top + 1;
+  const width = rect.right - rect.left + 1;
+  const dataRows = height - (hasHeader ? 1 : 0);
+  return dataRows > spill.maxInlineRows || height * width > spill.maxInlineCells;
+}
+function shouldSpillGrid(spill, cells) {
+  if (spill.mode === "always") return true;
+  const width = cells.reduce((max, row) => Math.max(max, row.length), 0);
+  return cells.length - 1 > spill.maxInlineRows || cells.length * width > spill.maxInlineCells;
+}
+function sidecarLinkParagraph(spill) {
+  return {
+    type: "paragraph",
+    children: [
+      { type: "link", url: spill.src, children: [{ type: "text", value: spill.fileName }] }
+    ]
+  };
+}
+async function workbookToMarkdown(data, options, spill) {
   const pkg = await openPackage(data, options);
   const mainPart = requireMainPartPath(pkg, XLSX_MAIN_PART, "XLSX");
   const [{ sheets, date1904 }, shared, styles] = await Promise.all([
@@ -747,6 +933,14 @@ async function xlsxToMarkdownDoc(data, options = {}) {
     }
     if (cells.length === 0) continue;
     if (!useRegions) {
+      if (spill && shouldSpillGrid(spill, cells)) {
+        children.push(
+          annotatedHeading(single ? 1 : 2, sheet.name, { src: spill.src, sheet: sheet.name }),
+          sidecarLinkParagraph(spill)
+        );
+        spill.used = true;
+        continue;
+      }
       children.push(cellsToTable(cells));
       continue;
     }
@@ -757,6 +951,14 @@ async function xlsxToMarkdownDoc(data, options = {}) {
     });
     for (const warning of plan.warnings) console.warn(`XLSX import: ${sheet.name}: ${warning}`);
     if (plan.degraded || plan.regions.length === 0 && plan.strays.length === 0) {
+      if (spill && shouldSpillGrid(spill, cells)) {
+        children.push(
+          annotatedHeading(single ? 1 : 2, sheet.name, { src: spill.src, sheet: sheet.name }),
+          sidecarLinkParagraph(spill)
+        );
+        spill.used = true;
+        continue;
+      }
       children.push(cellsToTable(cells));
       continue;
     }
@@ -765,6 +967,21 @@ async function xlsxToMarkdownDoc(data, options = {}) {
       const slice = sliceRect(cells, region.rect, EMPTY_CELL);
       const anchor = formatCellRef(region.rect.top, region.rect.left);
       const title = region.title ?? `${sheet.name} \u2014 ${anchor}`;
+      const hasHeaderRow = inferHeader(slice);
+      if (spill && shouldSpillRegion(spill, region.rect, hasHeaderRow)) {
+        children.push(
+          annotatedHeading(depth, title, {
+            src: spill.src,
+            sheet: sheet.name,
+            anchor,
+            ...hasHeaderRow ? {} : { headerRow: "false" },
+            ...region.titleCell ? { titleAnchor: formatCellRef(region.titleCell.row, region.titleCell.col) } : {}
+          }),
+          sidecarLinkParagraph(spill)
+        );
+        spill.used = true;
+        continue;
+      }
       children.push(
         annotatedHeading(depth, title, {
           sheet: sheet.name,
@@ -773,7 +990,7 @@ async function xlsxToMarkdownDoc(data, options = {}) {
           // says. (`headerRow`, not `header` — `dataTable` already declares a
           // `headers` input, and two params one letter apart in the same
           // annotation is a trap for anyone reading or editing the markdown.)
-          ...inferHeader(slice) ? {} : { headerRow: "false" },
+          ...hasHeaderRow ? {} : { headerRow: "false" },
           // A caption promoted into the heading has left its cell behind;
           // record where, so the reverse path can put the text back.
           ...region.titleCell ? { titleAnchor: formatCellRef(region.titleCell.row, region.titleCell.col) } : {}
@@ -804,394 +1021,43 @@ async function xlsxToMarkdownDoc(data, options = {}) {
   }
   return { type: "document", children };
 }
-
-// src/xlsx/export.ts
-import { docToMarkdown } from "@bendyline/squisq/doc";
-
-// src/xlsx/workbookPlan.ts
-function hasRichCellContent(nodes) {
-  return nodes.some(
-    (n) => n.type === "superscript" || n.type === "subscript" || "children" in n && Array.isArray(n.children) && hasRichCellContent(n.children)
-  );
-}
-var KEY_STRIDE = MAX_COL_INDEX + 1;
-function cellKey(row, col) {
-  return row * KEY_STRIDE + col;
-}
-function keyRow(key) {
-  return Math.floor(key / KEY_STRIDE);
-}
-function keyCol(key) {
-  return key - keyRow(key) * KEY_STRIDE;
-}
-function tableToGrid(table) {
-  return table.children.map(
-    (row) => row.children.map((cell) => extractPlainText(cell.children))
-  );
-}
-function tableToRichGrid(table) {
-  return table.children.map(
-    (row) => row.children.map((cell) => hasRichCellContent(cell.children) ? cell.children : void 0)
-  );
-}
-function readRole(raw) {
-  return raw === "formulas" || raw === "loose" ? raw : "values";
-}
-function collectEntries(nodes) {
-  const entries = [];
-  let pending = null;
-  for (const node of nodes) {
-    if (node.type === "heading") {
-      pending = node;
-      continue;
-    }
-    if (node.type !== "table") continue;
-    const params = pending?.templateAnnotation?.params ?? {};
-    const sheetKey = typeof params.sheet === "string" && params.sheet !== "" ? params.sheet : null;
-    entries.push({
-      table: node,
-      headingText: pending ? extractPlainText(pending.children) : "",
-      params,
-      sheetKey,
-      role: readRole(params.role)
-    });
-    pending = null;
-  }
-  return entries;
-}
-function groupEntries(entries) {
-  const groups = [];
-  const bySheet = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    if (entry.sheetKey !== null) {
-      let group = bySheet.get(entry.sheetKey);
-      if (!group) {
-        group = { candidate: entry.sheetKey, entries: [], anchored: true };
-        bySheet.set(entry.sheetKey, group);
-        groups.push(group);
-      }
-      group.entries.push(entry);
-      continue;
-    }
-    groups.push({ candidate: entry.headingText || null, entries: [entry], anchored: false });
-  }
-  return groups;
-}
-function place(cells, row, col, cell, clashes) {
-  const key = cellKey(row, col);
-  if (cells.has(key)) clashes.push(formatCellRef(row, col));
-  cells.set(key, cell);
-}
-function overlayFormula(cells, row, col, formula) {
-  const key = cellKey(row, col);
-  const existing = cells.get(key);
-  cells.set(key, { text: existing?.text ?? "", formula });
-}
-function formulaSource(raw) {
-  const trimmed = raw.trim();
-  return trimmed.startsWith("=") ? trimmed.slice(1) : trimmed;
-}
-function placeValues(entry, cells, warnings, sheetName, clashes) {
-  const grid = tableToGrid(entry.table);
-  const richGrid = tableToRichGrid(entry.table);
-  const anchorRaw = entry.params.anchor ?? "A1";
-  let anchor = parseCellRef(anchorRaw);
-  if (!anchor) {
-    warnings.push(
-      `Sheet "${sheetName}": anchor "${anchorRaw}" is not a valid cell reference; placed at A1 instead.`
-    );
-    anchor = { row: 0, col: 0 };
-  }
-  const height = grid.length;
-  const width = grid.reduce((m, r) => Math.max(m, r.length), 0);
-  if (anchor.row + height - 1 > MAX_ROW_INDEX || anchor.col + width - 1 > MAX_COL_INDEX) {
-    warnings.push(
-      `Sheet "${sheetName}": a table anchored at ${anchorRaw} runs past the end of the sheet; placed at A1 instead.`
-    );
-    anchor = { row: 0, col: 0 };
-  }
-  const titleRef = entry.params.titleAnchor;
-  if (titleRef !== void 0 && entry.headingText !== "") {
-    const at = parseCellRef(titleRef);
-    if (at) place(cells, at.row, at.col, { text: entry.headingText }, clashes);
-  }
-  for (let r = 0; r < grid.length; r++) {
-    const row = grid[r];
-    for (let c = 0; c < row.length; c++) {
-      const text = row[c];
-      if (text === "") continue;
-      const rich = richGrid[r]?.[c];
-      place(cells, anchor.row + r, anchor.col + c, rich ? { text, rich } : { text }, clashes);
-    }
-  }
-}
-function placeFormulas(entry, cells, warnings, sheetName) {
-  const grid = tableToGrid(entry.table);
-  if (grid.length < 2) return;
-  const anchorRaw = entry.params.anchor ?? "A1";
-  const anchor = parseCellRef(anchorRaw);
-  if (!anchor) {
-    warnings.push(
-      `Sheet "${sheetName}": formulas block anchor "${anchorRaw}" is not a valid cell reference; skipped.`
-    );
-    return;
-  }
-  const columns = grid[0].map((letters) => {
-    const trimmed = letters.trim();
-    if (!/^[A-Za-z]{1,3}$/.test(trimmed)) return -1;
-    const col = columnIndexFromLetters(trimmed);
-    return col >= 0 && col <= MAX_COL_INDEX ? col : -1;
-  });
-  for (let r = 1; r < grid.length; r++) {
-    const row = grid[r];
-    for (let c = 0; c < row.length; c++) {
-      const raw = row[c];
-      if (raw.trim() === "") continue;
-      const mapped = columns[c];
-      const col = mapped !== void 0 && mapped >= 0 ? mapped : anchor.col + c;
-      const targetRow = anchor.row + r - 1;
-      if (targetRow > MAX_ROW_INDEX) continue;
-      overlayFormula(cells, targetRow, col, formulaSource(raw));
-    }
-  }
-}
-function placeLoose(entry, cells, warnings, sheetName, clashes) {
-  const grid = tableToGrid(entry.table);
-  const richGrid = tableToRichGrid(entry.table);
-  let skipped = 0;
-  for (let r = 1; r < grid.length; r++) {
-    const row = grid[r];
-    const ref = (row[0] ?? "").trim();
-    if (ref === "") continue;
-    const at = parseCellRef(ref);
-    if (!at) {
-      skipped++;
-      continue;
-    }
-    const text = row[1] ?? "";
-    const formula = formulaSource(row[2] ?? "");
-    const rich = richGrid[r]?.[1];
-    const planned = { text };
-    if (formula !== "") planned.formula = formula;
-    if (rich) planned.rich = rich;
-    place(cells, at.row, at.col, planned, clashes);
-  }
-  if (skipped > 0) {
-    warnings.push(
-      `Sheet "${sheetName}": ${skipped} loose-cell row(s) had an invalid cell reference and were skipped.`
-    );
-  }
-}
-function planWorkbook(doc, options) {
-  const warnings = [];
-  const groups = groupEntries(collectEntries(doc.children));
-  const used = /* @__PURE__ */ new Set();
-  const sheets = [];
-  groups.forEach((group, index) => {
-    const fallback = `${options.sheetNamePrefix}${index + 1}`;
-    const name = options.sanitize(group.candidate ?? fallback, used, fallback);
-    const cells = /* @__PURE__ */ new Map();
-    const clashes = [];
-    for (const entry of group.entries) {
-      if (entry.role === "values") placeValues(entry, cells, warnings, name, clashes);
-    }
-    for (const entry of group.entries) {
-      if (entry.role === "formulas") placeFormulas(entry, cells, warnings, name);
-    }
-    for (const entry of group.entries) {
-      if (entry.role === "loose") placeLoose(entry, cells, warnings, name, clashes);
-    }
-    if (clashes.length > 0) {
-      const shown = clashes.slice(0, 5).join(", ");
-      const rest = clashes.length > 5 ? ", and more" : "";
-      warnings.push(
-        `Sheet "${name}": ${clashes.length} overlapping cell(s) (${shown}${rest}); the later block won.`
-      );
-    }
-    sheets.push({ name, cells, anchored: group.anchored });
-  });
-  let cellCount = 0;
-  for (const sheet of sheets) cellCount += sheet.cells.size;
-  return { sheets, warnings, cellCount };
-}
-
-// src/xlsx/export.ts
-var NUMERIC_RE = /^-?\d+(\.\d+)?$/;
-function isSafeNumericCell(value) {
-  if (!NUMERIC_RE.test(value)) return false;
-  const unsigned = value.startsWith("-") ? value.slice(1) : value;
-  const [integer] = unsigned.split(".");
-  if (integer.length > 1 && integer.startsWith("0")) return false;
-  const significantDigits = unsigned.replace(".", "").replace(/^0+/, "");
-  if (significantDigits.length > 15) return false;
-  return Number.isFinite(Number(value));
-}
-function cleanSheetName(raw) {
-  return raw.replace(/[[\]:*?/\\]/g, "").trim().slice(0, 31).trim().replace(/^'+|'+$/g, "");
-}
-function sanitizeSheetName(candidate, used, fallback) {
-  let base = cleanSheetName(candidate) || cleanSheetName(fallback) || "Sheet";
-  let name = base;
-  let n = 2;
-  while (used.has(name.toLocaleLowerCase("en-US"))) {
-    const suffix = String(n++);
-    base = base.slice(0, 31 - suffix.length);
-    name = `${base}${suffix}`;
-  }
-  used.add(name.toLocaleLowerCase("en-US"));
-  return name;
-}
-var ERROR_VALUE_RE = /^#[A-Z0-9_/]+[!?]?$/;
-function cellXml(cell, ref, inferNumericCells) {
-  const { text, formula } = cell;
-  if (formula !== void 0 && formula !== "") {
-    const f = `<f>${escapeXml(formula)}</f>`;
-    if (text === "") return `<c r="${ref}">${f}</c>`;
-    if (isSafeNumericCell(text)) return `<c r="${ref}">${f}<v>${escapeXml(text)}</v></c>`;
-    if (ERROR_VALUE_RE.test(text)) return `<c r="${ref}" t="e">${f}<v>${escapeXml(text)}</v></c>`;
-    return `<c r="${ref}" t="str">${f}<v>${escapeXml(text)}</v></c>`;
-  }
-  if (inferNumericCells && isSafeNumericCell(text)) {
-    return `<c r="${ref}"><v>${escapeXml(text)}</v></c>`;
-  }
-  if (cell.rich) {
-    return `<c r="${ref}" t="inlineStr"><is>${richRunsXml(cell.rich)}</is></c>`;
-  }
-  return `<c r="${ref}" t="inlineStr"><is><t xml:space="preserve">${escapeXml(text)}</t></is></c>`;
-}
-function richRunsXml(nodes) {
-  const runs = [];
-  const emit = (text, vertAlign) => {
-    if (text === "") return;
-    const rPr = vertAlign ? `<rPr><vertAlign val="${vertAlign}"/></rPr>` : "";
-    runs.push(`<r>${rPr}<t xml:space="preserve">${escapeXml(text)}</t></r>`);
+var XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+async function xlsxToContainer(data, options = {}) {
+  const plan = planDataSidecar(options.sourceName, "workbook.xlsx");
+  const mode = options.sidecar ?? "auto";
+  const spill = mode === "never" ? void 0 : {
+    src: plan.sidecarPath,
+    fileName: plan.fileName,
+    mode,
+    maxInlineRows: options.maxInlineRows ?? 100,
+    maxInlineCells: options.maxInlineCells ?? 2e3,
+    used: false
   };
-  const walk = (list, vertAlign) => {
-    for (const node of list) {
-      if (node.type === "superscript" || node.type === "subscript") {
-        walk(node.children, node.type === "superscript" ? "superscript" : "subscript");
-      } else if ("children" in node && Array.isArray(node.children)) {
-        walk(node.children, vertAlign);
-      } else {
-        emit(inlineToPlainText(node), vertAlign);
-      }
-    }
-  };
-  walk(nodes, null);
-  return runs.join("");
-}
-function worksheetXml(sheet, inferNumericCells) {
-  const keys = [...sheet.cells.keys()].sort((a, b) => a - b);
-  const rows = [];
-  let maxRow = 0;
-  let maxCol = 0;
-  let i = 0;
-  while (i < keys.length) {
-    const rowIdx = keyRow(keys[i]);
-    let cellsXml = "";
-    while (i < keys.length && keyRow(keys[i]) === rowIdx) {
-      const key = keys[i];
-      const col = keyCol(key);
-      if (col > maxCol) maxCol = col;
-      cellsXml += cellXml(
-        sheet.cells.get(key),
-        `${columnLetter(col)}${rowIdx + 1}`,
-        inferNumericCells
-      );
-      i++;
-    }
-    if (rowIdx > maxRow) maxRow = rowIdx;
-    rows.push(`<row r="${rowIdx + 1}">${cellsXml}</row>`);
+  const markdownDoc = await workbookToMarkdown(data, options, spill);
+  const container = new MemoryContentContainer();
+  await container.writeDocument(stringifyMarkdown(markdownDoc), plan.markdownFilename);
+  if (spill?.used) {
+    const bytes = data instanceof Blob ? await data.arrayBuffer() : data;
+    await container.writeFile(plan.sidecarPath, bytes, XLSX_MIME);
   }
-  const dimension = keys.length > 0 ? `A1:${columnLetter(maxCol)}${maxRow + 1}` : "A1";
-  return `${xmlDeclaration()}
-<worksheet xmlns="${NS_SML}" xmlns:r="${NS_R}"><dimension ref="${dimension}"/><sheetData>${rows.join("")}</sheetData></worksheet>`;
-}
-function workbookXml(sheets, hasFormulas) {
-  const sheetEls = sheets.map(
-    (sheet, i) => `<sheet name="${escapeXml(sheet.name)}" sheetId="${i + 1}" r:id="rId${i + 1}"/>`
-  ).join("");
-  const calcPr = hasFormulas ? `<calcPr calcId="0" fullCalcOnLoad="1"/>` : "";
-  return `${xmlDeclaration()}
-<workbook xmlns="${NS_SML}" xmlns:r="${NS_R}"><sheets>${sheetEls}</sheets>${calcPr}</workbook>`;
-}
-function stylesXml() {
-  return `${xmlDeclaration()}
-<styleSheet xmlns="${NS_SML}"><fonts count="1"><font><sz val="11"/><name val="Calibri"/></font></fonts><fills count="1"><fill><patternFill patternType="none"/></fill></fills><borders count="1"><border/></borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/></cellXfs></styleSheet>`;
-}
-async function markdownDocToXlsx(doc, options = {}) {
-  options.signal?.throwIfAborted();
-  const prefix = cleanSheetName(options.sheetNamePrefix ?? "Sheet") || "Sheet";
-  const maxCells = options.maxCells ?? 1e5;
-  if (!Number.isSafeInteger(maxCells) || maxCells < 0) {
-    throw new RangeError("maxCells must be a non-negative safe integer");
-  }
-  const plan = planWorkbook(doc, { sheetNamePrefix: prefix, sanitize: sanitizeSheetName });
-  for (const warning of plan.warnings) options.onWarning?.(warning);
-  if (plan.cellCount > maxCells) {
-    throw new RangeError(`XLSX export exceeds the ${maxCells}-cell safety limit`);
-  }
-  let sheets = plan.sheets;
-  if (sheets.length === 0) {
-    sheets = [
-      {
-        name: sanitizeSheetName(`${prefix}1`, /* @__PURE__ */ new Set(), "Sheet1"),
-        cells: /* @__PURE__ */ new Map(),
-        anchored: false
-      }
-    ];
-  }
-  const anchored = sheets.some((sheet) => sheet.anchored);
-  const inferNumericCells = options.inferNumericCells ?? anchored;
-  const hasFormulas = sheets.some((sheet) => {
-    for (const cell of sheet.cells.values()) if (cell.formula) return true;
-    return false;
-  });
-  const pkg = createPackage();
-  sheets.forEach((sheet, i) => {
-    if ((i & 31) === 0) options.signal?.throwIfAborted();
-    const sheetPath = `xl/worksheets/sheet${i + 1}.xml`;
-    pkg.addPart(sheetPath, worksheetXml(sheet, inferNumericCells), CONTENT_TYPE_XLSX_WORKSHEET);
-    pkg.addRelationship("xl/workbook.xml", {
-      id: `rId${i + 1}`,
-      type: REL_WORKSHEET,
-      target: `worksheets/sheet${i + 1}.xml`
-    });
-  });
-  pkg.addPart("xl/styles.xml", stylesXml(), CONTENT_TYPE_XLSX_STYLES);
-  pkg.addRelationship("xl/workbook.xml", {
-    id: `rId${sheets.length + 1}`,
-    type: REL_STYLES,
-    target: "styles.xml"
-  });
-  pkg.addPart("xl/workbook.xml", workbookXml(sheets, hasFormulas), CONTENT_TYPE_XLSX_WORKBOOK);
-  pkg.addRelationship("", {
-    id: "rId1",
-    type: REL_OFFICE_DOCUMENT,
-    target: "xl/workbook.xml"
-  });
-  if (options.title || options.author) {
-    pkg.setCoreProperties({
-      title: options.title,
-      creator: options.author,
-      created: (/* @__PURE__ */ new Date()).toISOString(),
-      modified: (/* @__PURE__ */ new Date()).toISOString()
-    });
-  }
-  return pkg.toArrayBuffer();
-}
-async function docToXlsx(doc, options) {
-  return markdownDocToXlsx(docToMarkdown(doc), options);
-}
-
-// src/xlsx/index.ts
-async function xlsxToDoc(data, options) {
-  return markdownToDoc(await xlsxToMarkdownDoc(data, options));
+  return container;
 }
 
 export {
+  MAX_COL_INDEX,
+  MAX_ROW_INDEX,
+  columnLetter,
+  columnIndexFromLetters,
+  colIndex,
+  parseCellRef,
+  formatCellRef,
+  columnLetter2,
+  gridToTables,
+  listSheetParts,
+  readCellStyles,
+  numberFormatKind,
+  xlsxToTables,
+  xlsxToCellGrids,
   xlsxToMarkdownDoc,
-  markdownDocToXlsx,
-  docToXlsx,
-  xlsxToDoc
+  xlsxToContainer
 };