odf-kit 0.9.7 → 0.9.9

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to odf-kit will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.8] - 2026-04-10
+
+### Added
+
+- **`readOds()`** — Parse an ODS file into a structured `OdsDocumentModel`. Returns typed JavaScript values — `string`, `number`, `boolean`, `Date` — never display-formatted strings. Available via `odf-kit/ods-reader`.
+- **`odsToHtml()`** — Convert an ODS file directly to an HTML string. Each sheet rendered as a `<table>` with inline styles. Available via `odf-kit/ods-reader`.
+- **`OdsDocumentModel`** — sheets → rows → cells with `value`, `type`, `formula?`, `displayText?`, `colSpan?`, `rowSpan?`, `formatting?`.
+- **Cell types:** `"string"`, `"float"`, `"date"`, `"boolean"`, `"formula"`, `"empty"`, `"covered"`.
+- **Formula cells** — `value` is the cached result, `formula` is the original formula string (e.g. `"=SUM(A1:A10)"`).
+- **Merged cell handling** — primary cell has `colSpan`/`rowSpan`, covered cells have `type: "covered"` and `value: null` at correct physical column indices.
+- **Cell formatting** — `OdsCellFormatting` with bold, italic, underline, fontSize, fontFamily, color, backgroundColor, textAlign, verticalAlign, numberFormat, dateFormat. Set `includeFormatting: false` for faster parsing when only values are needed.
+- **Sheet metadata** — tab color, freeze rows/columns read from settings.xml.
+- **Document metadata** — title, creator, description from meta.xml.
+- **`odf-kit/ods-reader`** sub-export added.
+- **`odf-kit/odt-reader`** alias added for `odf-kit/reader` — consistent naming with `odf-kit/ods-reader`.
+- 40 new tests (889 total).
+
 ## [0.9.7] - 2026-04-10
 
 ### Added
@@ -169,6 +186,7 @@ Initial release. Complete ODT generation support.
 - Tables, page layout, headers/footers, page breaks, lists, tab stops.
 - Method chaining. Full TypeScript types. ESM-only, Node.js 22+. 102 tests.
 
+[0.9.8]: https://github.com/GitHubNewbie0/odf-kit/releases/tag/v0.9.8
 [0.9.7]: https://github.com/GitHubNewbie0/odf-kit/releases/tag/v0.9.7
 [0.9.6]: https://github.com/GitHubNewbie0/odf-kit/releases/tag/v0.9.6
 [0.9.5]: https://github.com/GitHubNewbie0/odf-kit/releases/tag/v0.9.5

package/README.md

@@ -8,7 +8,7 @@ Generate, fill, read, and convert OpenDocument Format files (.odt, .ods) in Type
 npm install odf-kit
 ```
 
-## Eight ways to work with ODF files
+## Nine ways to work with ODF files
 
 ```typescript
 // 1. Build an ODT document from scratch
@@ -119,7 +119,16 @@ const html  = odtToHtml(bytes);            // styled HTML string
 ```
 
 ```typescript
-// 8. Convert .odt to Typst for PDF generation
+// 8. Read an existing .ods spreadsheet
+import { readOds, odsToHtml } from "odf-kit/ods-reader";
+
+const bytes = readFileSync("data.ods");
+const model = readOds(bytes);              // structured model — typed values
+const html  = odsToHtml(bytes);            // HTML table string
+```
+
+```typescript
+// 9. Convert .odt to Typst for PDF generation
 import { odtToTypst } from "odf-kit/typst";
 import { execSync } from "child_process";
 
@@ -140,7 +149,8 @@ Node.js 22+ required. ESM only. Sub-exports:
 
 ```typescript
 import { OdtDocument, OdsDocument, htmlToOdt, markdownToOdt, tiptapToOdt, fillTemplate } from "odf-kit";
-import { readOdt, odtToHtml }                from "odf-kit/reader";
+import { readOdt, odtToHtml } from "odf-kit/odt-reader";
+import { readOds, odsToHtml } from "odf-kit/ods-reader";
 import { odtToTypst, modelToTypst }          from "odf-kit/typst";
 ```
 
@@ -597,7 +607,7 @@ Falsy values (`false`, `null`, `undefined`, `0`, `""`, `[]`) remove the block. T
 `odf-kit/reader` parses `.odt` files into a structured model and renders to HTML.
 
 ```typescript
-import { readOdt, odtToHtml } from "odf-kit/reader";
+import { readOdt, odtToHtml } from "odf-kit/odt-reader";
 
 const bytes = readFileSync("report.odt");
 const model = readOdt(bytes);
@@ -611,6 +621,65 @@ const marked   = odtToHtml(bytes, {}, { trackedChanges: "changes" });
 
 ---
 
+## Read: ODS Spreadsheets
+
+`odf-kit/ods-reader` parses `.ods` files into a structured model and renders to HTML.
+
+```typescript
+import { readOds, odsToHtml } from "odf-kit/ods-reader";
+import { readFileSync } from "fs";
+
+const bytes = readFileSync("data.ods");
+
+// Structured model — typed JavaScript values
+const model = readOds(bytes);
+for (const sheet of model.sheets) {
+  console.log(sheet.name);
+  for (const row of sheet.rows) {
+    for (const cell of row.cells) {
+      console.log(cell.colIndex, cell.type, cell.value);
+      // e.g. 0 "float" 1234.56
+      // e.g. 1 "string" "Hello"
+      // e.g. 2 "date" Date { 2026-01-15 }
+      // e.g. 3 "formula" 100  (cell.formula = "=SUM(A1:A10)")
+      // e.g. 4 "covered" null (part of a merged cell)
+    }
+  }
+}
+
+// HTML table
+const html = odsToHtml(bytes);
+
+// Fast mode — values only, no formatting
+const model2 = readOds(bytes, { includeFormatting: false });
+```
+
+### Cell types
+
+| Type | `value` | Notes |
+|------|---------|-------|
+| `"string"` | `string` | |
+| `"float"` | `number` | Includes percentage and currency cells |
+| `"date"` | `Date` (UTC) | |
+| `"boolean"` | `boolean` | |
+| `"formula"` | cached result | `cell.formula` has original string e.g. `"=SUM(A1:A10)"` |
+| `"empty"` | `null` | |
+| `"covered"` | `null` | Covered by a merge — correct `colIndex` always maintained |
+
+### Merged cells
+
+Primary cells have `colSpan` and/or `rowSpan`. Covered cells have `type: "covered"`, `value: null`, and the correct physical `colIndex` — no offset confusion.
+
+```typescript
+// A1:C1 merged — reading row 0:
+// cell 0: { type: "string", value: "Header", colSpan: 3 }
+// cell 1: { type: "covered", value: null, colIndex: 1 }
+// cell 2: { type: "covered", value: null, colIndex: 2 }
+// cell 3: { type: "string", value: "D1", colIndex: 3 }  ← always correct
+```
+
+---
+
 ## Typst: ODT to PDF
 
 ```typescript
@@ -783,6 +852,8 @@ odf-kit targets ODF 1.2 (ISO/IEC 26300). Generated files include proper ZIP pack
 
 ## Version history
 
+**v0.9.8** — ODS reader: `readOds()` and `odsToHtml()` via `odf-kit/ods-reader`. Typed values, formula strings, merged cell handling, formatting, metadata. `odf-kit/odt-reader` alias added. 889 tests passing.
+
 **v0.9.7** — ODS enhancements: number formats (integer, decimal:N, percentage, currency), merged cells (colSpan/rowSpan), freeze rows/columns, hyperlinks in cells, sheet tab color. 849 tests passing.
 
 **v0.9.6** — `tiptapToOdt()`: TipTap/ProseMirror JSON→ODT conversion. `TiptapNode`, `TiptapMark`, `TiptapToOdtOptions` types. `unknownNodeHandler` for custom extensions. Image support via pre-fetched bytes map. 817 tests passing.

package/dist/ods-reader/html-renderer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ODS HTML renderer — converts an OdsDocumentModel to an HTML string.
+ *
+ * Each sheet is rendered as an HTML <table>. Merged cells use colspan/rowspan.
+ * Covered cells are omitted. Cell formatting is applied as inline styles.
+ */
+import type { OdsDocumentModel, OdsHtmlOptions } from "./types.js";
+/**
+ * Render an OdsDocumentModel as an HTML string.
+ *
+ * Each sheet is rendered as a `<table>`. Merged cells use `colspan`/`rowspan`.
+ * Covered cells are omitted. Cell formatting applied as inline styles.
+ *
+ * @param model   - Parsed document model from readOds().
+ * @param options - Optional rendering options.
+ * @returns HTML string.
+ */
+export declare function renderOdsHtml(model: OdsDocumentModel, options?: OdsHtmlOptions): string;
+//# sourceMappingURL=html-renderer.d.ts.map

package/dist/ods-reader/html-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-renderer.d.ts","sourceRoot":"","sources":["../../src/ods-reader/html-renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAKhB,cAAc,EACf,MAAM,YAAY,CAAC;AA2GpB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CASvF"}

package/dist/ods-reader/html-renderer.js

@@ -0,0 +1,123 @@
+/**
+ * ODS HTML renderer — converts an OdsDocumentModel to an HTML string.
+ *
+ * Each sheet is rendered as an HTML <table>. Merged cells use colspan/rowspan.
+ * Covered cells are omitted. Cell formatting is applied as inline styles.
+ */
+// ─── Style Building ───────────────────────────────────────────────────
+function buildInlineStyle(fmt) {
+    const parts = [];
+    if (fmt.bold)
+        parts.push("font-weight:bold");
+    if (fmt.italic)
+        parts.push("font-style:italic");
+    if (fmt.underline)
+        parts.push("text-decoration:underline");
+    if (fmt.fontSize)
+        parts.push(`font-size:${fmt.fontSize}`);
+    if (fmt.fontFamily)
+        parts.push(`font-family:${fmt.fontFamily}`);
+    if (fmt.color)
+        parts.push(`color:${fmt.color}`);
+    if (fmt.backgroundColor)
+        parts.push(`background-color:${fmt.backgroundColor}`);
+    if (fmt.textAlign)
+        parts.push(`text-align:${fmt.textAlign}`);
+    if (fmt.verticalAlign)
+        parts.push(`vertical-align:${fmt.verticalAlign}`);
+    return parts.join(";");
+}
+// ─── HTML Escaping ────────────────────────────────────────────────────
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+// ─── Cell Rendering ───────────────────────────────────────────────────
+function renderCellValue(cell) {
+    // Prefer display text when available
+    if (cell.displayText !== undefined && cell.displayText !== "") {
+        return escapeHtml(cell.displayText);
+    }
+    if (cell.value === null || cell.value === undefined)
+        return "";
+    if (cell.value instanceof Date) {
+        return escapeHtml(cell.value.toISOString().slice(0, 10));
+    }
+    return escapeHtml(String(cell.value));
+}
+function renderCell(cell, includeStyles, prefix) {
+    const attrs = [`class="${prefix}-cell"`];
+    if (cell.colSpan && cell.colSpan > 1)
+        attrs.push(`colspan="${cell.colSpan}"`);
+    if (cell.rowSpan && cell.rowSpan > 1)
+        attrs.push(`rowspan="${cell.rowSpan}"`);
+    if (includeStyles && cell.formatting) {
+        const style = buildInlineStyle(cell.formatting);
+        if (style)
+            attrs.push(`style="${style}"`);
+    }
+    // Right-align numbers by default if no explicit alignment
+    if (includeStyles &&
+        !cell.formatting?.textAlign &&
+        (cell.type === "float" || cell.type === "formula")) {
+        const existingStyle = attrs.find((a) => a.startsWith("style="));
+        if (existingStyle) {
+            const idx = attrs.indexOf(existingStyle);
+            attrs[idx] = existingStyle.replace('"', '"text-align:right;');
+        }
+        else {
+            attrs.push(`style="text-align:right"`);
+        }
+    }
+    const content = renderCellValue(cell);
+    return `<td ${attrs.join(" ")}>${content}</td>`;
+}
+// ─── Row Rendering ────────────────────────────────────────────────────
+function renderRow(row, includeStyles, prefix) {
+    const cells = row.cells
+        .filter((c) => c.type !== "covered")
+        .map((c) => renderCell(c, includeStyles, prefix))
+        .join("");
+    const style = includeStyles && row.height ? ` style="height:${row.height}"` : "";
+    return `<tr class="${prefix}-row"${style}>${cells}</tr>`;
+}
+// ─── Sheet Rendering ──────────────────────────────────────────────────
+function renderSheet(sheet, includeStyles, prefix) {
+    if (sheet.rows.length === 0) {
+        return `<h2 class="${prefix}-sheet-name">${escapeHtml(sheet.name)}</h2>\n<table class="${prefix}-sheet"></table>`;
+    }
+    const rows = sheet.rows
+        .map((r) => renderRow(r, includeStyles, prefix))
+        .join("\n    ");
+    return [
+        `<h2 class="${prefix}-sheet-name">${escapeHtml(sheet.name)}</h2>`,
+        `<table class="${prefix}-sheet">`,
+        `  <tbody>`,
+        `    ${rows}`,
+        `  </tbody>`,
+        `</table>`,
+    ].join("\n");
+}
+// ─── Public API ───────────────────────────────────────────────────────
+/**
+ * Render an OdsDocumentModel as an HTML string.
+ *
+ * Each sheet is rendered as a `<table>`. Merged cells use `colspan`/`rowspan`.
+ * Covered cells are omitted. Cell formatting applied as inline styles.
+ *
+ * @param model   - Parsed document model from readOds().
+ * @param options - Optional rendering options.
+ * @returns HTML string.
+ */
+export function renderOdsHtml(model, options) {
+    const includeStyles = options?.includeStyles ?? true;
+    const prefix = options?.classPrefix ?? "ods";
+    const sheets = model.sheets
+        .map((s) => renderSheet(s, includeStyles, prefix))
+        .join("\n\n");
+    return `<div class="${prefix}-document">\n${sheets}\n</div>`;
+}
+//# sourceMappingURL=html-renderer.js.map

package/dist/ods-reader/html-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-renderer.js","sourceRoot":"","sources":["../../src/ods-reader/html-renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,yEAAyE;AAEzE,SAAS,gBAAgB,CAAC,GAAsB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7C,IAAI,GAAG,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1D,IAAI,GAAG,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,IAAI,GAAG,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,eAAe;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/E,IAAI,GAAG,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7D,IAAI,GAAG,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,yEAAyE;AAEzE,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,yEAAyE;AAEzE,SAAS,eAAe,CAAC,IAAkB;IACzC,qCAAqC;IACrC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,EAAE,EAAE,CAAC;QAC9D,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC/D,IAAI,IAAI,CAAC,KAAK,YAAY,IAAI,EAAE,CAAC;QAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,IAAkB,EAAE,aAAsB,EAAE,MAAc;IAC5E,MAAM,KAAK,GAAa,CAAC,UAAU,MAAM,QAAQ,CAAC,CAAC;IAEnD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IAE9E,IAAI,aAAa,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,0DAA0D;IAC1D,IACE,aAAa;QACb,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS;QAC3B,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,EAClD,CAAC;QACD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACzC,KAAK,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,OAAO,CAAC;AAClD,CAAC;AAED,yEAAyE;AAEzE,SAAS,SAAS,CAAC,GAAgB,EAAE,aAAsB,EAAE,MAAc;IACzE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK;SACpB,MAAM,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;SACjD,GAAG,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;SAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,aAAa,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,cAAc,MAAM,QAAQ,KAAK,IAAI,KAAK,OAAO,CAAC;AAC3D,CAAC;AAED,yEAAyE;AAEzE,SAAS,WAAW,CAAC,KAAoB,EAAE,aAAsB,EAAE,MAAc;IAC/E,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,cAAc,MAAM,gBAAgB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,kBAAkB,CAAC;IACpH,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI;SACpB,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;SAC5D,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElB,OAAO;QACL,cAAc,MAAM,gBAAgB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO;QACjE,iBAAiB,MAAM,UAAU;QACjC,WAAW;QACX,OAAO,IAAI,EAAE;QACb,YAAY;QACZ,UAAU;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,yEAAyE;AAEzE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAuB,EAAE,OAAwB;IAC7E,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAE7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;SACxB,GAAG,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;SAChE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,eAAe,MAAM,gBAAgB,MAAM,UAAU,CAAC;AAC/D,CAAC"}

package/dist/ods-reader/index.d.ts

@@ -0,0 +1,19 @@
+import type { ReadOdsOptions, OdsHtmlOptions } from "./types.js";
+export { readOds } from "./parser.js";
+export type { OdsDocumentModel, OdsMetadata, OdsSheetModel, OdsRowModel, OdsCellModel, OdsCellFormatting, ReadOdsOptions, OdsHtmlOptions, } from "./types.js";
+/**
+ * Convert an ODS file directly to an HTML string.
+ *
+ * Convenience wrapper around readOds() + renderOdsHtml().
+ *
+ * @param bytes      - Raw .ods file bytes.
+ * @param htmlOptions - Optional HTML rendering options.
+ * @param readOptions - Optional parsing options.
+ * @returns HTML string with one <table> per sheet.
+ *
+ * @example
+ * import { odsToHtml } from "odf-kit/ods-reader"
+ * const html = odsToHtml(readFileSync("data.ods"))
+ */
+export declare function odsToHtml(bytes: Uint8Array, htmlOptions?: OdsHtmlOptions, readOptions?: ReadOdsOptions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/ods-reader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ods-reader/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,cAAc,EAC5B,WAAW,CAAC,EAAE,cAAc,GAC3B,MAAM,CAGR"}

package/dist/ods-reader/index.js

@@ -0,0 +1,22 @@
+import { readOds } from "./parser.js";
+import { renderOdsHtml } from "./html-renderer.js";
+export { readOds } from "./parser.js";
+/**
+ * Convert an ODS file directly to an HTML string.
+ *
+ * Convenience wrapper around readOds() + renderOdsHtml().
+ *
+ * @param bytes      - Raw .ods file bytes.
+ * @param htmlOptions - Optional HTML rendering options.
+ * @param readOptions - Optional parsing options.
+ * @returns HTML string with one <table> per sheet.
+ *
+ * @example
+ * import { odsToHtml } from "odf-kit/ods-reader"
+ * const html = odsToHtml(readFileSync("data.ods"))
+ */
+export function odsToHtml(bytes, htmlOptions, readOptions) {
+    const model = readOds(bytes, readOptions);
+    return renderOdsHtml(model, htmlOptions);
+}
+//# sourceMappingURL=index.js.map

package/dist/ods-reader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ods-reader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAYtC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CACvB,KAAiB,EACjB,WAA4B,EAC5B,WAA4B;IAE5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1C,OAAO,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC"}

package/dist/ods-reader/parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ODS parser — reads an .ods file and builds an OdsDocumentModel.
+ *
+ * Pipeline:
+ * 1. Unzip the .ods bytes with fflate
+ * 2. Parse content.xml — walk office:spreadsheet → table:table → table:table-row → table:table-cell
+ * 3. Resolve cell types and values from office:value-type attributes
+ * 4. Handle table:number-columns-repeated / table:number-rows-repeated (LibreOffice compression)
+ * 5. Handle merged cells — colSpan/rowSpan on primary, covered cells at correct indices
+ * 6. Resolve cell styles from automatic-styles → OdsCellFormatting
+ * 7. Parse settings.xml for freeze row/column configuration
+ * 8. Parse meta.xml for document metadata
+ * 9. Return OdsDocumentModel
+ */
+import type { OdsDocumentModel, ReadOdsOptions } from "./types.js";
+/**
+ * Parse an ODS file into a structured document model.
+ *
+ * @param bytes   - Raw .ods file bytes (Uint8Array).
+ * @param options - Optional parsing options.
+ * @returns Structured OdsDocumentModel.
+ */
+export declare function readOds(bytes: Uint8Array, options?: ReadOdsOptions): OdsDocumentModel;
+//# sourceMappingURL=parser.d.ts.map

package/dist/ods-reader/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/ods-reader/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAMhB,cAAc,EACf,MAAM,YAAY,CAAC;AAsfpB;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAwErF"}