odf-kit 0.9.6 → 0.9.8

package/dist/ods/sheet-builder.js

@@ -12,7 +12,8 @@
  *   .addRow(["February", 14200.00])
  *   .addRow(["Total", { value: "=SUM(B2:B3)", type: "formula" }])
  *   .setColumnWidth(0, "4cm")
- *   .setColumnWidth(1, "5cm");
+ *   .setColumnWidth(1, "5cm")
+ *   .freezeRows(1);
  */
 export class OdsSheet {
     /** Internal sheet data — used by OdsDocument.save(). */
@@ -33,26 +34,20 @@ export class OdsSheet {
      * - `boolean` → boolean
      * - `string` → string (never auto-detected as formula)
      * - `null` / `undefined` → empty cell
-     * - {@link OdsCellObject} → explicit type (required for formulas)
-     *
-     * Row options apply formatting defaults to every cell in the row.
-     * Per-cell {@link OdsCellObject} options override row-level defaults.
+     * - {@link OdsCellObject} → explicit type (required for formulas, percentages, currencies)
      *
      * @param values - Array of cell values in column order.
      * @param options - Optional formatting defaults for all cells in this row.
      * @returns This sheet, for chaining.
      *
      * @example
-     * // Simple auto-typed row
-     * sheet.addRow([1.23, "Text", new Date("2026-01-15"), true]);
-     *
-     * @example
-     * // Header row with formatting
      * sheet.addRow(["Month", "Revenue"], { bold: true, backgroundColor: "#DDDDDD" });
-     *
-     * @example
-     * // Row with a formula cell
-     * sheet.addRow(["Total", { value: "=SUM(B1:B10)", type: "formula" }]);
+     * sheet.addRow(["January", 12500.00]);
+     * sheet.addRow(["Total", { value: "=SUM(B2:B3)", type: "formula" }]);
+     * sheet.addRow([{ value: 0.1234, type: "percentage", numberFormat: "percentage:1" }]);
+     * sheet.addRow([{ value: 1234.56, type: "currency", numberFormat: "currency:EUR" }]);
+     * sheet.addRow([{ value: "Report", type: "string", colSpan: 3, bold: true }]);
+     * sheet.addRow([{ value: "odf-kit", type: "string", href: "https://github.com/GitHubNewbie0/odf-kit" }]);
      */
     addRow(values, options) {
         const cells = values.map((v) => toCellData(v));
@@ -62,16 +57,9 @@ export class OdsSheet {
     /**
      * Set the width of a column.
      *
-     * May be called before or after adding rows. Uses zero-based column index.
-     * Columns without an explicit width use the application's optimal width.
-     *
      * @param colIndex - Zero-based column index.
      * @param width - Width with units (e.g. `"3cm"`, `"1.5in"`).
      * @returns This sheet, for chaining.
-     *
-     * @example
-     * sheet.setColumnWidth(0, "4cm");
-     * sheet.setColumnWidth(1, "8cm");
      */
     setColumnWidth(colIndex, width) {
         this.data.columns.set(colIndex, { width });
@@ -80,17 +68,9 @@ export class OdsSheet {
     /**
      * Set the height of a row.
      *
-     * The row must already exist (added via {@link addRow}). Uses zero-based
-     * row index. Silently ignored for out-of-range indices.
-     * Rows without an explicit height use the application's optimal height.
-     *
      * @param rowIndex - Zero-based row index.
      * @param height - Height with units (e.g. `"1cm"`, `"18pt"`).
      * @returns This sheet, for chaining.
-     *
-     * @example
-     * sheet.addRow(["Header"]);
-     * sheet.setRowHeight(0, "1cm");
      */
     setRowHeight(rowIndex, height) {
         const row = this.data.rows[rowIndex];
@@ -99,24 +79,65 @@ export class OdsSheet {
         }
         return this;
     }
+    /**
+     * Freeze the top N rows so they remain visible when scrolling down.
+     *
+     * Typically used to keep a header row visible. Call after adding rows.
+     *
+     * @param rows - Number of rows to freeze (default 1).
+     * @returns This sheet, for chaining.
+     *
+     * @example
+     * sheet.addRow(["Name", "Amount", "Date"], { bold: true });
+     * sheet.freezeRows(1);
+     */
+    freezeRows(rows = 1) {
+        this.data.freezeRows = rows;
+        return this;
+    }
+    /**
+     * Freeze the left N columns so they remain visible when scrolling right.
+     *
+     * @param cols - Number of columns to freeze (default 1).
+     * @returns This sheet, for chaining.
+     *
+     * @example
+     * sheet.freezeColumns(1); // freeze the first column
+     */
+    freezeColumns(cols = 1) {
+        this.data.freezeColumns = cols;
+        return this;
+    }
+    /**
+     * Set the sheet tab color.
+     *
+     * @param color - Hex color (`"#FF0000"`) or CSS named color (`"red"`).
+     * @returns This sheet, for chaining.
+     *
+     * @example
+     * doc.addSheet("Q1").setTabColor("#4CAF50");
+     * doc.addSheet("Q2").setTabColor("#2196F3");
+     */
+    setTabColor(color) {
+        this.data.tabColor = color;
+        return this;
+    }
 }
 // ─── Internal Helpers ─────────────────────────────────────────────────
-/**
- * Convert an OdsCellValue to internal OdsCellData with resolved type.
- */
 function toCellData(value) {
     if (value === null || value === undefined) {
         return { value: null, type: "empty" };
     }
-    // OdsCellObject — has an explicit 'type' field alongside 'value'
     if (isOdsCellObject(value)) {
         return {
             value: value.value,
             type: value.type,
             options: extractCellOptions(value),
+            colSpan: value.colSpan,
+            rowSpan: value.rowSpan,
+            href: value.href,
         };
     }
-    // Auto-typed primitives
     if (value instanceof Date) {
         return { value, type: "date" };
     }
@@ -126,19 +147,11 @@ function toCellData(value) {
     if (typeof value === "number") {
         return { value, type: "float" };
     }
-    // string — never auto-detected as formula
     return { value: value, type: "string" };
 }
-/**
- * Type guard: returns true when value is an OdsCellObject.
- */
 function isOdsCellObject(value) {
     return typeof value === "object" && value !== null && !(value instanceof Date) && "type" in value;
 }
-/**
- * Extract OdsCellOptions fields from an OdsCellObject, excluding 'value' and 'type'.
- * Returns undefined when no formatting options are present.
- */
 function extractCellOptions(obj) {
     const opts = {};
     if (obj.bold !== undefined)
@@ -175,6 +188,8 @@ function extractCellOptions(obj) {
         opts.wrap = obj.wrap;
     if (obj.dateFormat !== undefined)
         opts.dateFormat = obj.dateFormat;
+    if (obj.numberFormat !== undefined)
+        opts.numberFormat = obj.numberFormat;
     return Object.keys(opts).length > 0 ? opts : undefined;
 }
 //# sourceMappingURL=sheet-builder.js.map

package/dist/ods/sheet-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"sheet-builder.js","sourceRoot":"","sources":["../../src/ods/sheet-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sheet-builder.js","sourceRoot":"","sources":["../../src/ods/sheet-builder.ts"],"names":[],"mappings":"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"}

package/dist/ods/types.d.ts

@@ -1,5 +1,5 @@
 /** Recognized cell types in ODS. */
-export type OdsCellType = "string" | "float" | "date" | "boolean" | "formula";
+export type OdsCellType = "string" | "float" | "date" | "boolean" | "formula" | "percentage" | "currency";
 /** Built-in date display formats. */
 export type OdsDateFormat = "YYYY-MM-DD" | "DD/MM/YYYY" | "MM/DD/YYYY";
 /**
@@ -7,14 +7,6 @@ export type OdsDateFormat = "YYYY-MM-DD" | "DD/MM/YYYY" | "MM/DD/YYYY";
  *
  * Applied at the row level (as defaults for all cells) or at the cell level
  * (as overrides for a single cell via {@link OdsCellObject}).
- *
- * @example
- * // Row-level defaults
- * sheet.addRow(["Header", "Value"], { bold: true, backgroundColor: "#DDDDDD" });
- *
- * @example
- * // Cell-level overrides inside OdsCellObject
- * sheet.addRow([{ value: "Special", type: "string", color: "#FF0000" }]);
  */
 export interface OdsCellOptions {
     /** Bold text. */
@@ -28,19 +20,15 @@ export interface OdsCellOptions {
     fontSize?: number | string;
     /** Font family (e.g. `"Arial"`, `"Liberation Sans"`). */
     fontFamily?: string;
-    /**
-     * Text color. Accepts hex (`"#FF0000"`) or CSS named colors (`"red"`).
-     */
+    /** Text color. Accepts hex (`"#FF0000"`) or CSS named colors (`"red"`). */
     color?: string;
     /** Underline the text. */
     underline?: boolean;
-    /**
-     * Cell background color. Accepts hex (`"#DDDDDD"`) or CSS named colors.
-     */
+    /** Cell background color. Accepts hex (`"#DDDDDD"`) or CSS named colors. */
     backgroundColor?: string;
     /**
-     * Border on all four sides. Uses CSS border shorthand:
-     * `"<width> <style> <color>"` (e.g. `"0.5pt solid #000000"`).
+     * Border on all four sides. CSS shorthand: `"<width> <style> <color>"`
+     * (e.g. `"0.5pt solid #000000"`).
      */
     border?: string;
     /** Top border. Overrides `border` for the top side. */
@@ -64,6 +52,24 @@ export interface OdsCellOptions {
      * Overrides the document-level default set via `OdsDocument.setDateFormat()`.
      */
     dateFormat?: OdsDateFormat;
+    /**
+     * Number display format. Applies when the cell contains a numeric value.
+     *
+     * Predefined formats:
+     * - `"integer"`          — 1,234 (no decimal places, thousands separator)
+     * - `"decimal:N"`        — 1,234.56 (N decimal places, thousands separator)
+     * - `"percentage"`       — 12.34% (raw value × 100, 2 decimal places)
+     * - `"percentage:N"`     — 12.3% (N decimal places)
+     * - `"currency:CODE"`    — €1,234.56 (ISO 4217 code, 2 decimal places)
+     * - `"currency:CODE:N"`  — €1,234.6 (currency with N decimal places)
+     *
+     * @example
+     * { value: 1234567.89, type: "float", numberFormat: "decimal:2" }
+     * { value: 0.1234, type: "percentage", numberFormat: "percentage:1" }
+     * { value: 1234.56, type: "currency", numberFormat: "currency:EUR" }
+     * { value: 9999, type: "float", numberFormat: "integer" }
+     */
+    numberFormat?: string;
 }
 /**
  * Row-level formatting options. Applied to all cells in the row as defaults.
@@ -73,29 +79,53 @@ export type OdsRowOptions = OdsCellOptions;
 /**
  * Explicit typed cell — use when automatic type detection is insufficient.
  *
- * Required for formula cells. Also allows per-cell formatting that overrides
- * the row-level defaults set in `addRow()`.
- *
- * Extends {@link OdsCellOptions} so individual cell formatting can override
- * row-level defaults.
+ * Required for formula, percentage, and currency cells. Also allows per-cell
+ * formatting that overrides row-level defaults.
  *
  * @example
  * // Formula — explicit type required
  * { value: "=SUM(B1:B10)", type: "formula" }
  *
  * @example
- * // Date with per-cell format override
- * { value: new Date("2026-01-15"), type: "date", dateFormat: "DD/MM/YYYY" }
+ * // Percentage
+ * { value: 0.1234, type: "percentage", numberFormat: "percentage:1" }
  *
  * @example
- * // String with bold override inside a non-bold row
- * { value: "Total", type: "string", bold: true }
+ * // Currency
+ * { value: 1234.56, type: "currency", numberFormat: "currency:EUR" }
+ *
+ * @example
+ * // Merged cell spanning 3 columns
+ * { value: "Q1 Report", type: "string", colSpan: 3, bold: true }
+ *
+ * @example
+ * // Hyperlink
+ * { value: "odf-kit", type: "string", href: "https://github.com/GitHubNewbie0/odf-kit" }
  */
 export interface OdsCellObject extends OdsCellOptions {
     /** The cell value. */
     value: string | number | boolean | Date | null;
     /** The explicit cell type. */
     type: OdsCellType;
+    /**
+     * Span this cell across N columns (default 1).
+     * The spanned columns in the same row are automatically filled with
+     * covered cells.
+     */
+    colSpan?: number;
+    /**
+     * Span this cell across N rows (default 1).
+     * The spanned cells in subsequent rows at the same column position are
+     * automatically filled with covered cells.
+     */
+    rowSpan?: number;
+    /**
+     * Hyperlink URL. When set, the cell text becomes a clickable link.
+     *
+     * @example
+     * { value: "odf-kit", type: "string", href: "https://github.com/GitHubNewbie0/odf-kit" }
+     */
+    href?: string;
 }
 /**
  * A cell value — either a primitive (auto-typed) or an explicit {@link OdsCellObject}.
@@ -108,11 +138,7 @@ export interface OdsCellObject extends OdsCellOptions {
  * - `null` / `undefined` → empty cell
  *
  * @example
- * // Primitives — auto-typed
  * sheet.addRow(["Hello", 42, new Date("2026-01-15"), true]);
- *
- * @example
- * // Mix of primitives and explicit objects
  * sheet.addRow(["Total", { value: "=SUM(B1:B10)", type: "formula" }]);
  */
 export type OdsCellValue = string | number | boolean | Date | null | undefined | OdsCellObject;
@@ -124,6 +150,12 @@ export interface OdsCellData {
     type: OdsCellType | "empty";
     /** Cell-level formatting options — merged with row options at render time. */
     options?: OdsCellOptions;
+    /** Column span — number of columns this cell covers (default 1). */
+    colSpan?: number;
+    /** Row span — number of rows this cell covers (default 1). */
+    rowSpan?: number;
+    /** Hyperlink URL — when set, cell text is rendered as a link. */
+    href?: string;
 }
 /** Internal representation of a row. */
 export interface OdsRowData {
@@ -147,5 +179,11 @@ export interface OdsSheetData {
     rows: OdsRowData[];
     /** Sparse column definitions keyed by zero-based column index. */
     columns: Map<number, OdsColumnData>;
+    /** Number of rows to freeze at the top (0 = no freeze). */
+    freezeRows?: number;
+    /** Number of columns to freeze at the left (0 = no freeze). */
+    freezeColumns?: number;
+    /** Sheet tab color (hex e.g. `"#FF0000"` or CSS named color). */
+    tabColor?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/ods/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ods/types.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9E,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEpC,qDAAqD;IACrD,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAE5C,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,sBAAsB;IACtB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAE/C,8BAA8B;IAC9B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC;AAI/F,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAE/C,8BAA8B;IAC9B,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IAE5B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,KAAK,EAAE,WAAW,EAAE,CAAC;IAErB,uEAAuE;IACvE,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,IAAI,EAAE,UAAU,EAAE,CAAC;IAEnB,kEAAkE;IAClE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ods/types.ts"],"names":[],"mappings":"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"}

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":"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"}

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"}