@bendyline/squisq-formats 2.5.0 → 2.6.0

package/dist/pptx/index.js

@@ -4,12 +4,14 @@ import {
   pptxToContainer,
   pptxToDoc,
   pptxToMarkdownDoc
-} from "../chunk-FMQWNPCV.js";
+} from "../chunk-AGGNLRHV.js";
 import {
   analyzePptxLayouts,
   inspectPptxLayouts
 } from "../chunk-6N2J7C2B.js";
+import "../chunk-VPWPEMZJ.js";
 import "../chunk-A6N6IN3I.js";
+import "../chunk-B7GEAZBI.js";
 import "../chunk-AVOZAKGP.js";
 import "../chunk-ILCJ3WFD.js";
 import "../chunk-JU2RHXUB.js";
@@ -17,8 +19,6 @@ import "../chunk-S5PCVMKU.js";
 import "../chunk-7AWFHP5U.js";
 import "../chunk-IIQYS2YH.js";
 import "../chunk-USU6HTKB.js";
-import "../chunk-6RQOV3B3.js";
-import "../chunk-AONELFLA.js";
 export {
   analyzePptxLayouts,
   docToPptx,

package/dist/registry/index.d.ts

@@ -1,5 +1,5 @@
-import { f as FormatId, g as FormatRegistry, F as FormatDefinition, d as ConvertSource, c as ConvertOptions, b as ConversionResult, P as PreparedConversion } from '../types-DByrrXeB.js';
-export { B as BUILTIN_FORMAT_IDS, a as BuiltinFormatOptions, C as ConversionLimits, D as DEFAULT_CONVERSION_LIMITS, e as DbkFormatOptions, M as MarkdownFormatOptions, N as NormalizedInput, h as PreparedExportOptions, r as resolveConversionLimits } from '../types-DByrrXeB.js';
+import { f as FormatId, g as FormatRegistry, F as FormatDefinition, d as ConvertSource, c as ConvertOptions, b as ConversionResult, P as PreparedConversion } from '../types-Dzd_5H2A.js';
+export { B as BUILTIN_FORMAT_IDS, a as BuiltinFormatOptions, C as ConversionLimits, D as DEFAULT_CONVERSION_LIMITS, e as DbkFormatOptions, M as MarkdownFormatOptions, N as NormalizedInput, h as PreparedExportOptions, r as resolveConversionLimits } from '../types-Dzd_5H2A.js';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/transform';
 import '@bendyline/squisq/markdown';
@@ -8,10 +8,10 @@ import '../docx/index.js';
 import '../reader-B_m1aKZC.js';
 import '../zipLimits-BOKCB7qk.js';
 import '../import-C16E8Y4X.js';
-import '../export-m0tr9r9d.js';
+import '../export-6iQXd-lQ.js';
 import '../csv/index.js';
 import '../pdf/index.js';
-import '../import-B0gBYUmd.js';
+import '../import-C7c9tQHK.js';
 import '../epub/index.js';
 import '../container/index.js';
 

package/dist/registry/index.js

@@ -9,7 +9,7 @@ import {
   defaultRegistry,
   prepareConversion,
   resolveConversionLimits
-} from "../chunk-JTGWQK5V.js";
+} from "../chunk-GRKQTQOF.js";
 import {
   ConversionError
 } from "../chunk-KXOZMWBS.js";

package/dist/{types-DByrrXeB.d.ts → types-Dzd_5H2A.d.ts}

@@ -4,10 +4,10 @@ import { ParseOptions, StringifyOptions, MarkdownDocument } from '@bendyline/squ
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { DocxImportOptions, DocxExportOptions } from './docx/index.js';
 import { a as PptxImportOptions, P as PptxExportOptions } from './import-C16E8Y4X.js';
-import { a as XlsxImportOptions, X as XlsxExportOptions } from './export-m0tr9r9d.js';
-import { CsvImportOptions, CsvExportOptions } from './csv/index.js';
+import { j as XlsxContainerOptions, X as XlsxExportOptions } from './export-6iQXd-lQ.js';
+import { CsvContainerOptions, CsvExportOptions } from './csv/index.js';
 import { PdfImportOptions, PdfExportOptions } from './pdf/index.js';
-import { a as HtmlImportOptions, H as HtmlExportOptions } from './import-B0gBYUmd.js';
+import { a as HtmlImportOptions, H as HtmlExportOptions } from './import-C7c9tQHK.js';
 import { EpubExportOptions } from './epub/index.js';
 import { ContainerToZipOptions } from './container/index.js';
 import { c as ZipSafetyLimits } from './zipLimits-BOKCB7qk.js';
@@ -67,8 +67,8 @@ interface BuiltinFormatOptions {
     md: MarkdownFormatOptions;
     docx: DocxImportOptions & DocxExportOptions;
     pptx: PptxImportOptions & PptxExportOptions;
-    xlsx: XlsxImportOptions & XlsxExportOptions;
-    csv: CsvImportOptions & CsvExportOptions;
+    xlsx: XlsxContainerOptions & XlsxExportOptions;
+    csv: CsvContainerOptions & CsvExportOptions;
     pdf: PdfImportOptions & PdfExportOptions;
     html: HtmlImportOptions & Partial<Omit<HtmlExportOptions, 'playerScript'>>;
     htmlzip: Partial<Omit<HtmlExportOptions, 'playerScript'>>;

package/dist/xlsx/index.d.ts

@@ -1,10 +1,91 @@
 import { Doc } from '@bendyline/squisq/schemas';
-import { a as XlsxImportOptions } from '../export-m0tr9r9d.js';
-export { X as XlsxExportOptions, d as docToXlsx, m as markdownDocToXlsx, x as xlsxToMarkdownDoc } from '../export-m0tr9r9d.js';
+import { a as XlsxImportOptions } from '../export-6iQXd-lQ.js';
+export { C as CellRect, S as SheetRef, h as XlsxCell, i as XlsxCellKind, j as XlsxContainerOptions, X as XlsxExportOptions, k as XlsxSheetGrid, b as XlsxTable, c as XlsxTableColumn, d as XlsxTablesOptions, l as XlsxWorkbookGrids, e as docToXlsx, n as formatCellRef, g as gridToTables, o as listSheetParts, m as markdownDocToXlsx, p as parseCellRef, q as xlsxToCellGrids, r as xlsxToContainer, x as xlsxToMarkdownDoc, f as xlsxToTables } from '../export-6iQXd-lQ.js';
+import { O as OoxmlOpenOptions } from '../reader-B_m1aKZC.js';
 import '@bendyline/squisq/markdown';
-import '../reader-B_m1aKZC.js';
+import '@bendyline/squisq/storage';
 import '../zipLimits-BOKCB7qk.js';
 
+/**
+ * XLSX in-place cell-value patching — the grid's XLSX save path.
+ *
+ * `patchXlsxCellValues(bytes, patches)` rewrites ONLY the worksheet parts a
+ * patch touches (plus `xl/workbook.xml` for the calc flag) and copies every
+ * other archive member through untouched, so charts, pivot caches, styles,
+ * macros and anything else this library does not model survive a save
+ * byte-for-byte (uncompressed content — the archive itself is re-deflated).
+ *
+ * All-or-nothing: any per-cell refusal throws `XlsxPatchRefusal` BEFORE any
+ * output is produced. Refusals, and their whys:
+ *  - `sheet-missing` / `cell-ref-invalid` — the patch addresses nothing.
+ *  - `formula-cell` — overwriting `<v>` under an `<f>` silently desyncs the
+ *    cached value from the formula; deleting the `<f>` destroys authored
+ *    logic. Formula editing arrives with the calculation engine (Phase 3).
+ *  - `shared-formula-follower` — worse: the cell LOOKS empty (`<f t="shared"
+ *    si="…"/>` with no text) but is the fill-down continuation of a master
+ *    formula; distinguished from `formula-cell` so a UI can explain it.
+ *  - `date-value-unsupported` — a date-styled cell stores a serial number
+ *    whose meaning depends on the workbook epoch and format code; writing a
+ *    naive number or string produces a silently wrong date. Clearing
+ *    (value `null`) is allowed — it keeps the style.
+ *
+ * Values write the way Excel does: number → `<v>` with no `t`; boolean →
+ * `t="b"`; string → `t="inlineStr"` (a shared-string cell is switched to
+ * inlineStr — orphaned sst entries are legal per ECMA-376); `null` clears
+ * content but keeps the cell and its style. After a successful patch the
+ * workbook's `<calcPr fullCalcOnLoad="1"/>` is set (inserted in CT_Workbook
+ * sequence position when absent) so Excel recomputes every formula on open
+ * instead of trusting caches that may reference patched inputs.
+ *
+ * XML is parsed AND serialized with the package-owned xmldom in every
+ * environment — browser DOMParser/XMLSerializer output differs across
+ * engines, and a deterministic writer is what makes the untouched-member and
+ * zero-patch guardrail tests meaningful. The XML declaration is re-prefixed
+ * from the original bytes (a serializer never reproduces it verbatim).
+ */
+
+interface XlsxCellPatch {
+    /** Sheet name, exactly as the workbook lists it. */
+    sheet: string;
+    /** A1-style cell reference (e.g. `B4`). */
+    ref: string;
+    /**
+     * New cell value; `null` clears the cell's content, keeping its style.
+     * Mutually exclusive with `formula`.
+     */
+    value?: number | boolean | string | null;
+    /**
+     * New formula source WITHOUT the leading `=` — the grid's formula-editing
+     * save path. The cell's `<f>` is replaced (a shared-formula FOLLOWER's
+     * membership is self-contained, so overwriting it simply removes that
+     * cell from the group; a shared MASTER is refused — its followers'
+     * `si` would dangle). Pair with `cachedValue` so viewers that don't
+     * recalculate still show the engine's result; `fullCalcOnLoad` makes
+     * Excel recompute regardless.
+     */
+    formula?: string;
+    /** Engine-computed result stored beside `formula` as the cached `<v>`. */
+    cachedValue?: number | boolean | string;
+}
+type XlsxPatchRefusalCode = 'sheet-missing' | 'cell-ref-invalid' | 'formula-cell' | 'shared-formula-follower' | 'shared-formula-master' | 'date-value-unsupported' | 'number-not-finite' | 'patch-invalid';
+/** A per-cell condition that makes the whole patch refuse (all-or-nothing). */
+declare class XlsxPatchRefusal extends Error {
+    readonly code: XlsxPatchRefusalCode;
+    readonly sheet: string;
+    readonly ref: string;
+    constructor(code: XlsxPatchRefusalCode, sheet: string, ref: string, message: string);
+}
+type XlsxPatchOptions = OoxmlOpenOptions;
+/**
+ * Apply cell-value patches to an XLSX file in place.
+ *
+ * @param bytes - The original workbook bytes.
+ * @param patches - Cell writes; all applied, or none (`XlsxPatchRefusal`).
+ * @param options - Zip safety limits (same contract as import).
+ * @returns The patched workbook as a new ArrayBuffer.
+ */
+declare function patchXlsxCellValues(bytes: ArrayBuffer, patches: readonly XlsxCellPatch[], options?: XlsxPatchOptions): Promise<ArrayBuffer>;
+
 /**
  * @bendyline/squisq-formats XLSX Module
  *
@@ -26,4 +107,4 @@ import '../zipLimits-BOKCB7qk.js';
  */
 declare function xlsxToDoc(data: ArrayBuffer | Blob, options?: XlsxImportOptions): Promise<Doc>;
 
-export { XlsxImportOptions, xlsxToDoc };
+export { type XlsxCellPatch, XlsxImportOptions, type XlsxPatchOptions, XlsxPatchRefusal, type XlsxPatchRefusalCode, patchXlsxCellValues, xlsxToDoc };

package/dist/xlsx/index.js

@@ -1,17 +1,38 @@
 import {
+  XlsxPatchRefusal,
   docToXlsx,
   markdownDocToXlsx,
-  xlsxToDoc,
-  xlsxToMarkdownDoc
-} from "../chunk-A6LSCIO5.js";
+  patchXlsxCellValues,
+  xlsxToDoc
+} from "../chunk-CKSTGNVZ.js";
 import "../chunk-AVOZAKGP.js";
+import {
+  formatCellRef,
+  gridToTables,
+  listSheetParts,
+  parseCellRef,
+  xlsxToCellGrids,
+  xlsxToContainer,
+  xlsxToMarkdownDoc,
+  xlsxToTables
+} from "../chunk-OBADJV7C.js";
+import "../chunk-DXYWKZ52.js";
 import "../chunk-ILCJ3WFD.js";
 import "../chunk-JU2RHXUB.js";
 import "../chunk-S5PCVMKU.js";
 import "../chunk-7AWFHP5U.js";
 export {
+  XlsxPatchRefusal,
   docToXlsx,
+  formatCellRef,
+  gridToTables,
+  listSheetParts,
   markdownDocToXlsx,
+  parseCellRef,
+  patchXlsxCellValues,
+  xlsxToCellGrids,
+  xlsxToContainer,
   xlsxToDoc,
-  xlsxToMarkdownDoc
+  xlsxToMarkdownDoc,
+  xlsxToTables
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-formats",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Document format converters — DOCX, PDF, OOXML import/export",
   "license": "MIT",
   "author": "Bendyline",
@@ -63,6 +63,11 @@
       "import": "./dist/csv/index.js",
       "default": "./dist/csv/index.js"
     },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "import": "./dist/data/index.js",
+      "default": "./dist/data/index.js"
+    },
     "./ooxml": {
       "types": "./dist/ooxml/index.d.ts",
       "import": "./dist/ooxml/index.js",
@@ -110,16 +115,26 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@bendyline/squisq": "2.11.0",
     "@pdf-lib/fontkit": "1.1.1",
     "@pdf-lib/upng": "1.0.1",
-    "@xmldom/xmldom": "0.9.11",
-    "@bendyline/squisq": "2.10.0",
+    "@xmldom/xmldom": "0.9.12",
     "jszip": "3.10.1",
     "pdf-lib": "1.17.1",
     "pdfjs-dist": "4.10.38"
   },
+  "peerDependencies": {
+    "hyparquet": "^1.29.1"
+  },
+  "peerDependenciesMeta": {
+    "hyparquet": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@fortawesome/fontawesome-free": "7.2.0",
+    "hyparquet": "1.29.1",
+    "hyparquet-writer": "0.16.6",
     "tsup": "8.5.1",
     "typescript": "5.9.3"
   }

package/dist/export-m0tr9r9d.d.ts

@@ -1,130 +0,0 @@
-import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { O as OoxmlOpenOptions } from './reader-B_m1aKZC.js';
-import { Doc } from '@bendyline/squisq/schemas';
-
-/**
- * XLSX import — SpreadsheetML (.xlsx) → MarkdownDocument.
- *
- * Reuses the shared ooxml/ reader (zip + DOMParser). Reads the workbook's sheet
- * list, resolves each sheet part via relationships, pulls shared strings, and
- * turns each worksheet into markdown. By default every sheet is imported, each
- * preceded by an H1 of the sheet name; pass `options.sheet` (index or name) to
- * import just one.
- *
- * A sheet is NOT one table. It is usually several tables scattered across the
- * grid with stray labels and notes in the gaps, so by default each worksheet is
- * split into its contiguous data islands (see `regions.ts`) and every island
- * becomes its own block:
- *
- * ```markdown
- * ## Q3 Revenue {[dataTable sheet=Sales anchor=B7]}
- * ```
- *
- * The `sheet`/`anchor` params on the heading annotation are what let
- * `markdownDocToXlsx` put each table back where it came from, so the round trip
- * reproduces addresses rather than piling everything at A1. A region holding
- * formulas additionally emits a `role=formulas` companion table, and every
- * left-over single cell on a sheet collects into one `role=loose` table.
- *
- * Pass `{ regions: false }` for the historical behavior: one table per sheet,
- * spanning the whole used range.
- */
-
-interface XlsxImportOptions extends OoxmlOpenOptions {
-    /** Which sheet to import (0-based index or sheet name). Default: all sheets. */
-    sheet?: number | string;
-    /**
-     * Split each sheet into its contiguous data islands, one block each, anchored
-     * with `{[dataTable sheet=… anchor=…]}`. Default true. Set false for the
-     * historical one-table-per-sheet output.
-     */
-    regions?: boolean;
-    /**
-     * Emit a `role=formulas` companion table for regions that contain formulas.
-     * Default true. Ignored when `regions` is false.
-     */
-    formulas?: boolean;
-    /** Cap on region tables per sheet before the rest fold into loose cells. Default 64. */
-    maxRegionsPerSheet?: number;
-    /** Smallest island that stays a table of its own. Default 2 — single cells coalesce. */
-    minRegionCells?: number;
-}
-declare function xlsxToMarkdownDoc(data: ArrayBuffer | Blob, options?: XlsxImportOptions): Promise<MarkdownDocument>;
-
-/**
- * XLSX export — MarkdownDocument → SpreadsheetML (.xlsx).
- *
- * Tables-only fidelity (honestly documented): every `table` node in the
- * markdown AST becomes worksheet cells; all other content (prose, lists,
- * images, …) is dropped, and headings survive only as sheet names and as the
- * carrier of placement metadata.
- *
- * Placement has two modes, decided per table by `workbookPlan.ts`. A table
- * whose heading carries `{[dataTable sheet=… anchor=…]}` — what
- * `xlsxToMarkdownDoc` emits for every data island it finds — is placed on the
- * named sheet at the named cell, so several mini tables share one worksheet at
- * their original addresses and formulas ride along. A table with no such
- * annotation keeps the historical behavior exactly: its own worksheet, named
- * from the nearest preceding heading, starting at A1.
- *
- * Cells are emitted as inline strings (`t="inlineStr"`) by default so no
- * sharedStrings part is needed and identifier-like numbers remain lossless.
- * Callers can explicitly opt into conservative numeric inference. The package
- * is assembled with the shared ooxml/ writer (auto-generates
- * `[Content_Types].xml` + `_rels`), so only the SpreadsheetML-specific parts
- * (workbook, worksheets, styles) are written here.
- *
- * @example
- * ```ts
- * import { parseMarkdown } from '@bendyline/squisq/markdown';
- * import { markdownDocToXlsx } from '@bendyline/squisq-formats/xlsx';
- *
- * const md = parseMarkdown('# Metrics\n\n| A | B |\n| - | - |\n| 1 | 2 |');
- * const buffer = await markdownDocToXlsx(md);
- * ```
- */
-
-/**
- * Options for XLSX export.
- */
-interface XlsxExportOptions {
-    /** Cancel at bounded export checkpoints. */
-    signal?: AbortSignal;
-    /** Maximum cells emitted. Default: 100,000. */
-    maxCells?: number;
-    /** Workbook title (written to core properties). */
-    title?: string;
-    /** Workbook author (written to core properties). */
-    author?: string;
-    /** Prefix used for auto-named sheets when no heading precedes a table. Default: "Sheet". */
-    sheetNamePrefix?: string;
-    /**
-     * Emit canonical, Excel-safe number strings as numeric cells.
-     *
-     * Defaults to false for hand-authored documents — markdown tables have no
-     * column schema, so preserving authored text is the only lossless choice —
-     * and to true when the document carries `sheet=` anchors, which only an XLSX
-     * import produces. Leading-zero and >15-significant-digit values remain
-     * strings either way. Set explicitly to override both defaults.
-     */
-    inferNumericCells?: boolean;
-    /**
-     * Called for each non-fatal placement problem (a malformed anchor, an
-     * overlapping region, an unusable loose-cell reference). Export never throws
-     * for these — a hand-edited markdown file must still convert.
-     */
-    onWarning?: (message: string) => void;
-}
-/**
- * Convert a MarkdownDocument to a .xlsx file (tables-only fidelity).
- *
- * Each markdown `table` becomes one worksheet; a document with no tables
- * yields a single empty sheet (a valid, openable file — never throws).
- */
-declare function markdownDocToXlsx(doc: MarkdownDocument, options?: XlsxExportOptions): Promise<ArrayBuffer>;
-/**
- * Convert a squisq Doc to a .xlsx file (via the markdown table model).
- */
-declare function docToXlsx(doc: Doc, options?: XlsxExportOptions): Promise<ArrayBuffer>;
-
-export { type XlsxExportOptions as X, type XlsxImportOptions as a, docToXlsx as d, markdownDocToXlsx as m, xlsxToMarkdownDoc as x };

package/dist/{chunk-KMBBO5H7.js → chunk-7DQP2I57.js}

@@ -1,3 +1,7 @@
+import {
+  colorHintsFromExtraction,
+  compileExtractedTheme
+} from "./chunk-2JJ5RFDZ.js";
 import {
   ConversionError
 } from "./chunk-KXOZMWBS.js";
@@ -6,10 +10,6 @@ import {
   extractPptxTheme,
   extractXlsxTheme
 } from "./chunk-WATAOG4Y.js";
-import {
-  colorHintsFromExtraction,
-  compileExtractedTheme
-} from "./chunk-2JJ5RFDZ.js";
 import {
   openPackage,
   throwIfOoxmlAborted

package/dist/{chunk-M7XPXGXW.js → chunk-ROF7SSQP.js}

@@ -1,3 +1,6 @@
+import {
+  FootnoteIndex
+} from "./chunk-BXWNU4T5.js";
 import {
   buildContainer
 } from "./chunk-IIQYS2YH.js";
@@ -6,9 +9,6 @@ import {
   fontAwesomeFaces,
   fontAwesomeGlyph
 } from "./chunk-USU6HTKB.js";
-import {
-  FootnoteIndex
-} from "./chunk-BXWNU4T5.js";
 
 // src/pdf/export.ts
 import { PDFDocument, StandardFonts, rgb, PDFString } from "pdf-lib";