@bendyline/squisq-formats 2.5.1 → 2.6.1

package/dist/{import-B0gBYUmd.d.ts → import-D59rxNTj.d.ts}

@@ -41,8 +41,11 @@ interface HtmlExportOptions {
      * Only used in ZIP exports — single HTML uses timer-based playback.
      */
     audio?: Map<string, ArrayBuffer>;
-    /** Rendering mode: 'slideshow' (interactive, default) or 'static' (scrollable) */
-    mode?: 'slideshow' | 'static';
+    /**
+     * Rendering mode: 'slideshow' (interactive, default), 'video' (timed
+     * auto-advance movie playback), or 'static' (scrollable).
+     */
+    mode?: 'slideshow' | 'video' | 'static';
     /** HTML page title (default: 'Squisq Document') */
     title?: string;
     /** Auto-play slideshow on load (default: false) */
@@ -56,6 +59,11 @@ interface HtmlExportOptions {
      * lower-third. Omitted = captions off (mount default).
      */
     captionStyle?: 'standard' | 'social';
+    /**
+     * Caption placement over the frame, passed through to `SquisqPlayer.mount`.
+     * Omitted = the style's classic spot (standard: top; social: lower band).
+     */
+    captionPosition?: 'top' | 'center' | 'bottom';
     /**
      * Squisq theme ID to apply (e.g., 'documentary', 'cinematic').
      * When set, the theme is assigned to the Doc before rendering,
@@ -78,7 +86,7 @@ declare function collectImagePaths(doc: Doc): Set<string>;
  * @param options - Export options (playerScript is not embedded, referenced via src)
  * @returns Complete HTML string
  */
-declare function generateExternalHtml(doc: Doc, options: Pick<HtmlExportOptions, 'mode' | 'title' | 'autoPlay' | 'showCodeCopyButton' | 'captionStyle' | 'themeId' | 'themeRegistry' | 'basePath'> & {
+declare function generateExternalHtml(doc: Doc, options: Pick<HtmlExportOptions, 'mode' | 'title' | 'autoPlay' | 'showCodeCopyButton' | 'captionStyle' | 'captionPosition' | 'themeId' | 'themeRegistry' | 'basePath'> & {
     /** Relative path to the player JS file (e.g., 'squisq-player.js') */
     playerScriptPath: string;
     /** Map of original image paths to their rewritten relative paths in the ZIP */

package/dist/index.d.ts

@@ -6,13 +6,13 @@ export { PdfExportOptions, PdfImportOptions, configurePdfWorker, docToPdf, markd
 export { HtmlZipExportOptions, docToHtml, docToHtmlZip } from './html/index.js';
 export { EpubExportOptions, docToEpub, markdownDocToEpub } from './epub/index.js';
 export { ExtractedFileTheme, InferSourceFormat, InferThemeOptions, InferredFileTheme, compileExtractedTheme, inferThemeFromFile } from './infer/index.js';
-export { B as BUILTIN_FORMAT_IDS, a as BuiltinFormatOptions, C as ConversionLimits, b as ConversionResult, c as ConvertOptions, d as ConvertSource, D as DEFAULT_CONVERSION_LIMITS, e as DbkFormatOptions, F as FormatDefinition, f as FormatId, g as FormatRegistry, M as MarkdownFormatOptions, N as NormalizedInput, P as PreparedConversion, h as PreparedExportOptions, r as resolveConversionLimits } from './types-bwP9PBSk.js';
+export { B as BUILTIN_FORMAT_IDS, a as BuiltinFormatOptions, C as ConversionLimits, b as ConversionResult, c as ConvertOptions, d as ConvertSource, D as DEFAULT_CONVERSION_LIMITS, e as DbkFormatOptions, F as FormatDefinition, f as FormatId, g as FormatRegistry, M as MarkdownFormatOptions, N as NormalizedInput, P as PreparedConversion, h as PreparedExportOptions, r as resolveConversionLimits } from './types-BD23kHNG.js';
 export { ConversionError, ConversionErrorCode, ConversionErrorOptions, convert, createRegistry, defaultFormats, defaultRegistry, prepareConversion } from './registry/index.js';
 export { ImportedOutsideInDocument, OUTSIDE_IN_FORMAT_IDS, OUTSIDE_IN_UPDATE_FROM_MARKDOWN_KEY, OutsideInFormatId, OutsideInLayout, OutsideInMetadata, RenderOutsideInOptions, chooseOutsideInMarkdownPath, importOutsideInDocument, isOutsideInMarkdownEditingEnabled, isOutsideInTargetPath, readOutsideInMetadata, renderOutsideInDocument, resolveOutsideInLayout, withOutsideInMarkdownEditing, withOutsideInMetadata } from './outside-in/index.js';
 export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from './zipLimits-BOKCB7qk.js';
-export { H as HtmlExportOptions, a as HtmlImportOptions, c as collectImagePaths, h as htmlToMarkdown, b as htmlToMarkdownDoc, d as htmlToMarkdownDocSync } from './import-B0gBYUmd.js';
+export { H as HtmlExportOptions, a as HtmlImportOptions, c as collectImagePaths, h as htmlToMarkdown, b as htmlToMarkdownDoc, d as htmlToMarkdownDocSync } from './import-D59rxNTj.js';
 export { P as PptxExportOptions, a as PptxImportOptions, d as docToPptx, m as markdownDocToPptx, p as pptxToMarkdownDoc } from './import-C16E8Y4X.js';
-export { X as XlsxExportOptions, a as XlsxImportOptions, b as XlsxTable, c as XlsxTableColumn, d as XlsxTablesOptions, e as docToXlsx, g as gridToTables, m as markdownDocToXlsx, x as xlsxToMarkdownDoc, f as xlsxToTables } from './export-Boq78GMq.js';
+export { X as XlsxExportOptions, a as XlsxImportOptions, b as XlsxTable, c as XlsxTableColumn, d as XlsxTablesOptions, e as docToXlsx, g as gridToTables, m as markdownDocToXlsx, x as xlsxToMarkdownDoc, f as xlsxToTables } from './export-6iQXd-lQ.js';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/markdown';
 import './reader-B_m1aKZC.js';

package/dist/index.js

@@ -1,13 +1,24 @@
+import {
+  collectImagePaths,
+  docToHtml,
+  docToHtmlZip,
+  htmlToMarkdown,
+  htmlToMarkdownDoc,
+  htmlToMarkdownDocSync
+} from "./chunk-POO3PJFH.js";
 import {
   docToEpub,
   markdownDocToEpub
-} from "./chunk-2LT3JL7U.js";
+} from "./chunk-3ITGQRL5.js";
 import {
   BUILTIN_FORMAT_IDS
 } from "./chunk-2P5HJAQL.js";
 import {
   inferThemeFromFile
-} from "./chunk-KMBBO5H7.js";
+} from "./chunk-7DQP2I57.js";
+import {
+  compileExtractedTheme
+} from "./chunk-2JJ5RFDZ.js";
 import {
   OUTSIDE_IN_FORMAT_IDS,
   OUTSIDE_IN_UPDATE_FROM_MARKDOWN_KEY,
@@ -20,7 +31,7 @@ import {
   resolveOutsideInLayout,
   withOutsideInMarkdownEditing,
   withOutsideInMetadata
-} from "./chunk-TVUX3RUC.js";
+} from "./chunk-2OCP46K5.js";
 import {
   DEFAULT_CONVERSION_LIMITS,
   convert,
@@ -29,43 +40,45 @@ import {
   defaultRegistry,
   prepareConversion,
   resolveConversionLimits
-} from "./chunk-5JQ5NDRC.js";
+} from "./chunk-JPU5GPGG.js";
 import {
   ConversionError
 } from "./chunk-KXOZMWBS.js";
 import "./chunk-WATAOG4Y.js";
-import {
-  compileExtractedTheme
-} from "./chunk-2JJ5RFDZ.js";
 import {
   docToDocx,
   docxToDoc,
   docxToMarkdownDoc,
   markdownDocToDocx
-} from "./chunk-FIOSE4BO.js";
+} from "./chunk-XJNOZTAY.js";
 import {
   docToPptx,
   markdownDocToPptx,
   pptxToDoc,
   pptxToMarkdownDoc
-} from "./chunk-FMQWNPCV.js";
+} from "./chunk-AGGNLRHV.js";
 import "./chunk-6N2J7C2B.js";
+import "./chunk-VPWPEMZJ.js";
 import "./chunk-A6N6IN3I.js";
+import "./chunk-B7GEAZBI.js";
 import {
   docToXlsx,
-  gridToTables,
   markdownDocToXlsx,
-  xlsxToDoc,
+  xlsxToDoc
+} from "./chunk-CKSTGNVZ.js";
+import "./chunk-AVOZAKGP.js";
+import {
+  gridToTables,
   xlsxToMarkdownDoc,
   xlsxToTables
-} from "./chunk-RX55T5HO.js";
-import "./chunk-AVOZAKGP.js";
+} from "./chunk-OBADJV7C.js";
 import {
   csvToDoc,
   csvToMarkdownDoc,
   markdownDocToCsv,
   parseCsv
-} from "./chunk-AD2WT564.js";
+} from "./chunk-Q77KNJIN.js";
+import "./chunk-DXYWKZ52.js";
 import "./chunk-OK622ILP.js";
 import "./chunk-ILCJ3WFD.js";
 import "./chunk-JU2RHXUB.js";
@@ -79,20 +92,10 @@ import {
   markdownDocToPdf,
   pdfToDoc,
   pdfToMarkdownDoc
-} from "./chunk-M7XPXGXW.js";
+} from "./chunk-ROF7SSQP.js";
+import "./chunk-BXWNU4T5.js";
 import "./chunk-IIQYS2YH.js";
 import "./chunk-USU6HTKB.js";
-import {
-  collectImagePaths,
-  docToHtml,
-  docToHtmlZip,
-  htmlToMarkdown,
-  htmlToMarkdownDoc,
-  htmlToMarkdownDocSync
-} from "./chunk-T4PX33AG.js";
-import "./chunk-6RQOV3B3.js";
-import "./chunk-AONELFLA.js";
-import "./chunk-BXWNU4T5.js";
 export {
   BUILTIN_FORMAT_IDS,
   ConversionError,

package/dist/infer/index.js

@@ -1,17 +1,17 @@
 import {
   inferThemeFromFile
-} from "../chunk-KMBBO5H7.js";
+} from "../chunk-7DQP2I57.js";
+import {
+  colorHintsFromExtraction,
+  compileExtractedTheme,
+  extractedThemeToPartial
+} from "../chunk-2JJ5RFDZ.js";
 import "../chunk-KXOZMWBS.js";
 import {
   extractDocxTheme,
   extractPptxTheme,
   extractXlsxTheme
 } from "../chunk-WATAOG4Y.js";
-import {
-  colorHintsFromExtraction,
-  compileExtractedTheme,
-  extractedThemeToPartial
-} from "../chunk-2JJ5RFDZ.js";
 import "../chunk-OK622ILP.js";
 import "../chunk-S5PCVMKU.js";
 import "../chunk-7AWFHP5U.js";

package/dist/materialize-A34OZGEU.js

@@ -0,0 +1,11 @@
+import {
+  materializeDataReferences
+} from "./chunk-FLR2ARKC.js";
+import "./chunk-OBADJV7C.js";
+import "./chunk-Q77KNJIN.js";
+import "./chunk-DXYWKZ52.js";
+import "./chunk-S5PCVMKU.js";
+import "./chunk-7AWFHP5U.js";
+export {
+  materializeDataReferences
+};

package/dist/outside-in/index.d.ts

@@ -1,16 +1,16 @@
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import { c as ConvertOptions, b as ConversionResult } from '../types-bwP9PBSk.js';
+import { c as ConvertOptions, b as ConversionResult } from '../types-BD23kHNG.js';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/transform';
 import '../docx/index.js';
 import '../reader-B_m1aKZC.js';
 import '../zipLimits-BOKCB7qk.js';
 import '../import-C16E8Y4X.js';
-import '../export-Boq78GMq.js';
+import '../export-6iQXd-lQ.js';
 import '../csv/index.js';
 import '../pdf/index.js';
-import '../import-B0gBYUmd.js';
+import '../import-D59rxNTj.js';
 import '../epub/index.js';
 import '../container/index.js';
 
@@ -30,7 +30,7 @@ import '../container/index.js';
  * the portable path/frontmatter contract plus registry-backed import/export.
  */
 
-declare const OUTSIDE_IN_FORMAT_IDS: readonly ["html", "docx", "pdf", "pptx", "xlsx"];
+declare const OUTSIDE_IN_FORMAT_IDS: readonly ["html", "docx", "pdf", "pptx", "xlsx", "csv"];
 type OutsideInFormatId = (typeof OUTSIDE_IN_FORMAT_IDS)[number];
 declare const OUTSIDE_IN_UPDATE_FROM_MARKDOWN_KEY = "squisq-updatefrommarkdown";
 interface OutsideInLayout {

package/dist/outside-in/index.js

@@ -10,8 +10,8 @@ import {
   resolveOutsideInLayout,
   withOutsideInMarkdownEditing,
   withOutsideInMetadata
-} from "../chunk-TVUX3RUC.js";
-import "../chunk-5JQ5NDRC.js";
+} from "../chunk-2OCP46K5.js";
+import "../chunk-JPU5GPGG.js";
 import "../chunk-KXOZMWBS.js";
 import "../chunk-7AWFHP5U.js";
 export {

package/dist/pdf/index.js

@@ -5,10 +5,10 @@ import {
   pdfToContainer,
   pdfToDoc,
   pdfToMarkdownDoc
-} from "../chunk-M7XPXGXW.js";
+} from "../chunk-ROF7SSQP.js";
+import "../chunk-BXWNU4T5.js";
 import "../chunk-IIQYS2YH.js";
 import "../chunk-USU6HTKB.js";
-import "../chunk-BXWNU4T5.js";
 export {
   configurePdfWorker,
   docToPdf,

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-bwP9PBSk.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-bwP9PBSk.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-BD23kHNG.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-BD23kHNG.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-Boq78GMq.js';
+import '../export-6iQXd-lQ.js';
 import '../csv/index.js';
 import '../pdf/index.js';
-import '../import-B0gBYUmd.js';
+import '../import-D59rxNTj.js';
 import '../epub/index.js';
 import '../container/index.js';
 

package/dist/registry/index.js

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

package/dist/{types-bwP9PBSk.d.ts → types-BD23kHNG.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-Boq78GMq.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-D59rxNTj.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-Boq78GMq.js';
-export { X as XlsxExportOptions, b as XlsxTable, c as XlsxTableColumn, d as XlsxTablesOptions, e as docToXlsx, g as gridToTables, m as markdownDocToXlsx, x as xlsxToMarkdownDoc, f as xlsxToTables } from '../export-Boq78GMq.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,20 +1,37 @@
 import {
+  XlsxPatchRefusal,
   docToXlsx,
-  gridToTables,
   markdownDocToXlsx,
-  xlsxToDoc,
+  patchXlsxCellValues,
+  xlsxToDoc
+} from "../chunk-CKSTGNVZ.js";
+import "../chunk-AVOZAKGP.js";
+import {
+  formatCellRef,
+  gridToTables,
+  listSheetParts,
+  parseCellRef,
+  xlsxToCellGrids,
+  xlsxToContainer,
   xlsxToMarkdownDoc,
   xlsxToTables
-} from "../chunk-RX55T5HO.js";
-import "../chunk-AVOZAKGP.js";
+} 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,
   xlsxToTables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-formats",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "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.1",
     "@pdf-lib/fontkit": "1.1.1",
     "@pdf-lib/upng": "1.0.1",
     "@xmldom/xmldom": "0.9.12",
-    "@bendyline/squisq": "2.10.0",
     "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/{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";