odf-kit 0.7.0 → 0.8.0

package/dist/typst/emitter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Typst emitter for the ODT document model.
+ *
+ * Converts the structured document model produced by the ODT parser into
+ * a Typst markup string (.typ). Zero runtime dependencies — the emitter is
+ * a pure function over OdtDocumentModel and produces output suitable for
+ * any Typst 0.11+ installation:
+ *
+ *   typst compile document.typ document.pdf
+ *
+ * Structural coverage:
+ *  - Headings levels 1–6 (= through ======)
+ *  - Paragraphs with text-align via #align()
+ *  - Bold, italic, underline, strikethrough, superscript, subscript
+ *  - Hyperlinks via #link()
+ *  - Footnotes and endnotes via #footnote[]
+ *  - Bookmarks as Typst labels (<name>) for point and start positions
+ *  - Text fields: pageNumber and pageCount mapped to Typst counters;
+ *    all others rendered as their stored evaluated value
+ *  - Unordered and ordered lists with nested sub-lists
+ *  - Tables via #table() with column widths where available
+ *  - Named sections with comment headers
+ *  - Tracked changes: final (default), original, and changes modes
+ *
+ * Tier 2 character style coverage (SpanStyle):
+ *  - fontColor       → #text(fill: rgb("..."))[]
+ *  - fontSize        → #text(size: Npt)[]
+ *  - fontFamily      → #text(font: "...")[]
+ *  - highlightColor  → #highlight(fill: rgb("..."))[]
+ *
+ * Page geometry (PageLayout) → #set page(width:, height:, margin: (...))
+ *
+ * Images: base64 image data cannot be embedded inline in Typst without
+ * filesystem access. Each image is emitted as a comment placeholder
+ * preserving its document position:
+ *
+ *   // [image: name 17cm × 5.74cm]
+ *
+ * Consumers that need images in the PDF should extract ImageNode.data
+ * (base64) from the model, write the files alongside the .typ output,
+ * and substitute the placeholders with #image("filename") calls.
+ *
+ * Text content is escaped for Typst markup mode. The following characters
+ * are prefixed with a backslash: \ * _ # < @ ` ~ $ [ ]
+ * A leading = on any line is also escaped to prevent heading misinterpretation.
+ */
+import type { OdtDocumentModel } from "../reader/types.js";
+import type { ReadOdtOptions } from "../reader/types.js";
+/**
+ * Options for the Typst emitter.
+ */
+export interface TypstEmitOptions {
+    /**
+     * Controls how tracked changes are emitted. Mirrors ReadOdtOptions.trackedChanges.
+     *
+     * "final" (default): TrackedChangeNode values render as their insertion body;
+     *   deletions produce no output. Matches the "final" parse mode behavior.
+     * "original": TrackedChangeNode values render as their deletion body;
+     *   insertions produce no output. Matches the "original" parse mode behavior.
+     * "changes": insertions → #underline[], deletions → #strike[],
+     *   format-change → body content only with no wrapper.
+     *
+     * Set readOdt and modelToTypst to the same mode for consistent results.
+     * When readOdt is called with "final" (default), no TrackedChangeNode values
+     * are emitted by the parser and this option has no effect.
+     */
+    trackedChanges?: "final" | "original" | "changes";
+}
+/**
+ * Convert an OdtDocumentModel to a Typst markup string.
+ *
+ * This is the primary emitter function. It accepts a pre-parsed document
+ * model and returns a .typ string with no side effects and no filesystem
+ * access. Use this when you already have a model from readOdt() or when
+ * you need fine-grained control over read options.
+ *
+ * @param model - The parsed ODT document model from readOdt().
+ * @param options - Typst emitter options.
+ * @returns Typst markup string (.typ).
+ *
+ * @example
+ * ```typescript
+ * import { readOdt } from "odf-kit/reader";
+ * import { modelToTypst } from "odf-kit/typst";
+ * import { readFileSync, writeFileSync } from "node:fs";
+ *
+ * const bytes = new Uint8Array(readFileSync("document.odt"));
+ * const model = readOdt(bytes);
+ * const typ = modelToTypst(model);
+ * writeFileSync("document.typ", typ);
+ * // then: typst compile document.typ document.pdf
+ * ```
+ */
+export declare function modelToTypst(model: OdtDocumentModel, options?: TypstEmitOptions): string;
+/**
+ * Convert an .odt file directly to a Typst markup string.
+ *
+ * Convenience wrapper around readOdt() + modelToTypst(). Use modelToTypst()
+ * directly when you need access to the document model, metadata, or want to
+ * share a single readOdt() call between multiple emitters.
+ *
+ * @param bytes - The raw .odt file as a Uint8Array.
+ * @param options - Combined emitter and read options. The trackedChanges
+ *   field is forwarded to both readOdt() and modelToTypst() — set it once
+ *   for consistent results across both steps.
+ * @returns Typst markup string (.typ).
+ *
+ * @example
+ * ```typescript
+ * import { odtToTypst } from "odf-kit/typst";
+ * import { readFileSync, writeFileSync } from "node:fs";
+ *
+ * const bytes = new Uint8Array(readFileSync("document.odt"));
+ * const typ = odtToTypst(bytes);
+ * writeFileSync("document.typ", typ);
+ * // then: typst compile document.typ document.pdf
+ * ```
+ */
+export declare function odtToTypst(bytes: Uint8Array, options?: TypstEmitOptions & ReadOdtOptions): string;
+//# sourceMappingURL=emitter.d.ts.map

package/dist/typst/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/typst/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAajB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;CACnD;AAkXD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAUxF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,cAAc,GAAG,MAAM,CAGjG"}

package/dist/typst/emitter.js

@@ -0,0 +1,458 @@
+/**
+ * Typst emitter for the ODT document model.
+ *
+ * Converts the structured document model produced by the ODT parser into
+ * a Typst markup string (.typ). Zero runtime dependencies — the emitter is
+ * a pure function over OdtDocumentModel and produces output suitable for
+ * any Typst 0.11+ installation:
+ *
+ *   typst compile document.typ document.pdf
+ *
+ * Structural coverage:
+ *  - Headings levels 1–6 (= through ======)
+ *  - Paragraphs with text-align via #align()
+ *  - Bold, italic, underline, strikethrough, superscript, subscript
+ *  - Hyperlinks via #link()
+ *  - Footnotes and endnotes via #footnote[]
+ *  - Bookmarks as Typst labels (<name>) for point and start positions
+ *  - Text fields: pageNumber and pageCount mapped to Typst counters;
+ *    all others rendered as their stored evaluated value
+ *  - Unordered and ordered lists with nested sub-lists
+ *  - Tables via #table() with column widths where available
+ *  - Named sections with comment headers
+ *  - Tracked changes: final (default), original, and changes modes
+ *
+ * Tier 2 character style coverage (SpanStyle):
+ *  - fontColor       → #text(fill: rgb("..."))[]
+ *  - fontSize        → #text(size: Npt)[]
+ *  - fontFamily      → #text(font: "...")[]
+ *  - highlightColor  → #highlight(fill: rgb("..."))[]
+ *
+ * Page geometry (PageLayout) → #set page(width:, height:, margin: (...))
+ *
+ * Images: base64 image data cannot be embedded inline in Typst without
+ * filesystem access. Each image is emitted as a comment placeholder
+ * preserving its document position:
+ *
+ *   // [image: name 17cm × 5.74cm]
+ *
+ * Consumers that need images in the PDF should extract ImageNode.data
+ * (base64) from the model, write the files alongside the .typ output,
+ * and substitute the placeholders with #image("filename") calls.
+ *
+ * Text content is escaped for Typst markup mode. The following characters
+ * are prefixed with a backslash: \ * _ # < @ ` ~ $ [ ]
+ * A leading = on any line is also escaped to prevent heading misinterpretation.
+ */
+import { readOdt } from "../reader/parser.js";
+// ============================================================
+// Typst escaping
+// ============================================================
+/** Characters with special meaning in Typst markup mode. */
+const TYPST_ESCAPE_RE = /[\\*_#<@`~$[\]]/g;
+/**
+ * Escape characters that carry special meaning in Typst markup mode.
+ *
+ * Each matched character is prefixed with a backslash. A leading = on any
+ * line is also escaped so text content is never misinterpreted as a heading.
+ */
+function escapeTypst(text) {
+    return text.replace(TYPST_ESCAPE_RE, (ch) => `\\${ch}`).replace(/^=/gm, "\\=");
+}
+// ============================================================
+// Page setup
+// ============================================================
+/**
+ * Emit a #set page(...) directive from a PageLayout.
+ *
+ * Returns an empty string when pageLayout is absent so the caller can
+ * skip it without emitting a blank directive.
+ */
+function emitPageSetup(model) {
+    const layout = model.pageLayout;
+    if (layout === undefined)
+        return "";
+    const parts = [];
+    if (layout.width !== undefined)
+        parts.push(`width: ${layout.width}`);
+    if (layout.height !== undefined)
+        parts.push(`height: ${layout.height}`);
+    const marginParts = [];
+    if (layout.marginTop !== undefined)
+        marginParts.push(`top: ${layout.marginTop}`);
+    if (layout.marginBottom !== undefined)
+        marginParts.push(`bottom: ${layout.marginBottom}`);
+    if (layout.marginLeft !== undefined)
+        marginParts.push(`left: ${layout.marginLeft}`);
+    if (layout.marginRight !== undefined)
+        marginParts.push(`right: ${layout.marginRight}`);
+    if (marginParts.length > 0)
+        parts.push(`margin: (${marginParts.join(", ")})`);
+    if (parts.length === 0)
+        return "";
+    return `#set page(${parts.join(", ")})`;
+}
+// ============================================================
+// Tier 2 — SpanStyle helper
+// ============================================================
+/**
+ * Wrap Typst content with #text() and #highlight() calls for any SpanStyle
+ * properties that have Typst equivalents.
+ *
+ * Applied after all semantic formatting (#underline, #strike, _italic_,
+ * *bold*) so SpanStyle is the outermost wrapper below the hyperlink anchor.
+ *
+ * Properties without a clean Typst mapping (textTransform, fontVariant,
+ * textShadow, letterSpacing) are intentionally omitted — they have no
+ * standard built-in Typst equivalent and faking them would produce incorrect
+ * output.
+ */
+function applySpanStyle(style, content) {
+    let out = content;
+    // highlight() wraps first so #text() sits outside it
+    if (style.highlightColor !== undefined) {
+        out = `#highlight(fill: rgb("${style.highlightColor}"))[${out}]`;
+    }
+    const textArgs = [];
+    if (style.fontColor !== undefined)
+        textArgs.push(`fill: rgb("${style.fontColor}")`);
+    if (style.fontSize !== undefined)
+        textArgs.push(`size: ${style.fontSize}pt`);
+    if (style.fontFamily !== undefined)
+        textArgs.push(`font: "${style.fontFamily}"`);
+    if (textArgs.length > 0) {
+        out = `#text(${textArgs.join(", ")})[${out}]`;
+    }
+    return out;
+}
+// ============================================================
+// Inline node renderers
+// ============================================================
+/**
+ * Emit a TextSpan to a Typst markup string.
+ *
+ * Hidden spans (text:display="none") produce an empty string.
+ * Hard line breaks produce a Typst forced line break: \
+ *
+ * Formatting nesting order (innermost first, outermost last):
+ * superscript/subscript → strikethrough → underline → italic → bold
+ * → SpanStyle → hyperlink anchor.
+ */
+function emitTextSpan(span) {
+    if (span.lineBreak)
+        return "\\\n";
+    if (span.hidden)
+        return "";
+    let out = escapeTypst(span.text);
+    if (span.superscript)
+        out = `#super[${out}]`;
+    if (span.subscript)
+        out = `#sub[${out}]`;
+    if (span.strikethrough)
+        out = `#strike[${out}]`;
+    if (span.underline)
+        out = `#underline[${out}]`;
+    if (span.italic)
+        out = `_${out}_`;
+    if (span.bold)
+        out = `*${out}*`;
+    if (span.style !== undefined) {
+        out = applySpanStyle(span.style, out);
+    }
+    if (span.href !== undefined) {
+        out = `#link("${span.href}")[${out}]`;
+    }
+    return out;
+}
+/**
+ * Emit an ImageNode as a comment placeholder.
+ *
+ * Typst does not support inline base64 image data without filesystem access.
+ * The placeholder preserves the image's document position and carries its
+ * name and dimensions so consumers can locate and substitute it.
+ *
+ * See module-level documentation for the recommended substitution workflow.
+ */
+function emitImage(node) {
+    const label = node.name ?? node.title ?? "image";
+    const dims = node.width !== undefined && node.height !== undefined
+        ? ` ${node.width} \u00d7 ${node.height}`
+        : "";
+    return `/* [image: ${label}${dims}] */`;
+}
+/**
+ * Emit a NoteNode as a Typst #footnote[].
+ *
+ * Both footnote and endnote classes are emitted as #footnote[] — Typst does
+ * not have a built-in endnote construct. Consumers that need distinct endnote
+ * placement should post-process the .typ output.
+ */
+function emitNote(node, options) {
+    const body = emitBodyNodes(node.body, options);
+    return `#footnote[${body}]`;
+}
+/**
+ * Emit a BookmarkNode as a Typst label.
+ *
+ * point and start positions emit <name> — Typst's label syntax for
+ * cross-reference anchors. end positions produce no output (the span
+ * has already been closed implicitly).
+ */
+function emitBookmark(node) {
+    if (node.position === "end")
+        return "";
+    return `<${node.name}>`;
+}
+/**
+ * Emit a FieldNode to a Typst string.
+ *
+ * pageNumber and pageCount are mapped to their Typst counter equivalents.
+ * All other field types fall back to the stored evaluated value, which is
+ * always present per the ODF spec.
+ */
+function emitField(node) {
+    switch (node.fieldType) {
+        case "pageNumber":
+            return "#counter(page).display()";
+        case "pageCount":
+            return "#counter(page).final().first()";
+        default:
+            return escapeTypst(node.value);
+    }
+}
+/**
+ * Dispatch an InlineNode to the appropriate emitter.
+ *
+ * TextSpan has no `kind` property; all other InlineNode types do.
+ * This mirrors the narrowing pattern used in the HTML renderer.
+ */
+function emitInlineNode(node, options) {
+    if ("kind" in node) {
+        switch (node.kind) {
+            case "image":
+                return emitImage(node);
+            case "note":
+                return emitNote(node, options);
+            case "bookmark":
+                return emitBookmark(node);
+            case "field":
+                return emitField(node);
+        }
+    }
+    return emitTextSpan(node);
+}
+/** Emit an array of InlineNode objects to a concatenated Typst string. */
+function emitSpans(spans, options) {
+    return spans.map((n) => emitInlineNode(n, options)).join("");
+}
+// ============================================================
+// Block node renderers
+// ============================================================
+/**
+ * Map an ODF/CSS text-align value to the Typst alignment keyword.
+ *
+ * ODF spec values "start" and "end" are passed through — Typst supports them
+ * natively for bidirectional text. "justify" maps to Typst's "justify" keyword.
+ */
+function mapTextAlign(textAlign) {
+    switch (textAlign) {
+        case "left":
+            return "left";
+        case "right":
+            return "right";
+        case "center":
+            return "center";
+        case "justify":
+            return "justify";
+        case "start":
+            return "start";
+        case "end":
+            return "end";
+        default:
+            return "left";
+    }
+}
+/**
+ * Emit a ListNode to a Typst list string.
+ *
+ * Unordered items use the - marker; ordered items use +. Nested sub-lists
+ * are indented with two spaces per level as required by the Typst parser.
+ */
+function emitList(list, options, depth = 0) {
+    const marker = list.ordered ? "+" : "-";
+    const indent = "  ".repeat(depth);
+    return list.items
+        .map((item) => {
+        const content = emitSpans(item.spans, options);
+        const nested = item.children !== undefined ? "\n" + emitList(item.children, options, depth + 1) : "";
+        return `${indent}${marker} ${content}${nested}`;
+    })
+        .join("\n");
+}
+/**
+ * Emit a TableNode as a Typst #table() call.
+ *
+ * Column widths are taken from the first row's CellStyle.columnWidth values
+ * when present, producing a columns: (Xcm, Ycm, ...) tuple. When no widths
+ * are available, columns: N (equal-width auto layout) is used instead.
+ *
+ * Cell content is emitted as Typst content blocks [...]. colspan and rowspan
+ * are not yet expressible in standard Typst table syntax and are silently
+ * ignored; the cell content is still emitted.
+ */
+function emitTable(table, options) {
+    if (table.rows.length === 0)
+        return "";
+    const cols = table.rows[0].cells.length;
+    const firstRow = table.rows[0];
+    const colWidths = firstRow.cells.map((cell) => cell.cellStyle?.columnWidth);
+    const hasWidths = colWidths.some((w) => w !== undefined);
+    const columnsArg = hasWidths
+        ? `columns: (${colWidths.map((w) => w ?? "1fr").join(", ")})`
+        : `columns: ${cols}`;
+    const cells = table.rows
+        .flatMap((row) => row.cells.map((cell) => `[${emitSpans(cell.spans, options)}]`))
+        .join(", ");
+    return `#table(\n  ${columnsArg},\n  ${cells}\n)`;
+}
+/**
+ * Emit a SectionNode as a Typst comment header followed by its body content.
+ *
+ * Typst has no built-in section construct. The name is preserved as a comment
+ * so consumers can identify section boundaries in the .typ output.
+ */
+function emitSection(node, options) {
+    const header = node.name !== undefined ? `// Section: ${node.name}` : "// Section";
+    const body = emitBodyNodes(node.body, options);
+    return `${header}\n${body}`;
+}
+/**
+ * Emit a TrackedChangeNode.
+ *
+ * When TypstEmitOptions.trackedChanges is "changes":
+ *  insertion     → #underline[body]
+ *  deletion      → #strike[body]
+ *  format-change → body content only (no formatting wrapper; style changed,
+ *                  not content)
+ *
+ * In other modes ("final", "original") the parser does not emit
+ * TrackedChangeNode values. If one is encountered anyway (e.g. the consumer
+ * constructed the model manually), it is rendered transparently as its body
+ * content with no annotation wrapper — matching the HTML renderer's behavior.
+ */
+function emitTrackedChange(node, options) {
+    const body = emitBodyNodes(node.body, options);
+    if (options?.trackedChanges !== "changes") {
+        return body;
+    }
+    switch (node.changeType) {
+        case "insertion":
+            return `#underline[${body}]`;
+        case "deletion":
+            return `#strike[${body}]`;
+        case "format-change":
+            return body;
+    }
+}
+/** Emit a single BodyNode to a Typst markup string. */
+function emitBodyNode(node, options) {
+    switch (node.kind) {
+        case "paragraph": {
+            const content = emitSpans(node.spans, options);
+            if (node.paragraphStyle?.textAlign !== undefined) {
+                const align = mapTextAlign(node.paragraphStyle.textAlign);
+                return `#align(${align})[${content}]`;
+            }
+            return content;
+        }
+        case "heading": {
+            const prefix = "=".repeat(node.level);
+            const content = emitSpans(node.spans, options);
+            return `${prefix} ${content}`;
+        }
+        case "list":
+            return emitList(node, options);
+        case "table":
+            return emitTable(node, options);
+        case "section":
+            return emitSection(node, options);
+        case "tracked-change":
+            return emitTrackedChange(node, options);
+    }
+}
+/**
+ * Emit an array of BodyNode objects separated by blank lines.
+ *
+ * Blank-line separation is the standard Typst paragraph delimiter and
+ * ensures distinct blocks do not run together in the output.
+ */
+function emitBodyNodes(body, options) {
+    return body.map((n) => emitBodyNode(n, options)).join("\n\n");
+}
+// ============================================================
+// Public API
+// ============================================================
+/**
+ * Convert an OdtDocumentModel to a Typst markup string.
+ *
+ * This is the primary emitter function. It accepts a pre-parsed document
+ * model and returns a .typ string with no side effects and no filesystem
+ * access. Use this when you already have a model from readOdt() or when
+ * you need fine-grained control over read options.
+ *
+ * @param model - The parsed ODT document model from readOdt().
+ * @param options - Typst emitter options.
+ * @returns Typst markup string (.typ).
+ *
+ * @example
+ * ```typescript
+ * import { readOdt } from "odf-kit/reader";
+ * import { modelToTypst } from "odf-kit/typst";
+ * import { readFileSync, writeFileSync } from "node:fs";
+ *
+ * const bytes = new Uint8Array(readFileSync("document.odt"));
+ * const model = readOdt(bytes);
+ * const typ = modelToTypst(model);
+ * writeFileSync("document.typ", typ);
+ * // then: typst compile document.typ document.pdf
+ * ```
+ */
+export function modelToTypst(model, options) {
+    const sections = [];
+    const pageSetup = emitPageSetup(model);
+    if (pageSetup)
+        sections.push(pageSetup);
+    const body = emitBodyNodes(model.body, options);
+    if (body)
+        sections.push(body);
+    return sections.join("\n\n");
+}
+/**
+ * Convert an .odt file directly to a Typst markup string.
+ *
+ * Convenience wrapper around readOdt() + modelToTypst(). Use modelToTypst()
+ * directly when you need access to the document model, metadata, or want to
+ * share a single readOdt() call between multiple emitters.
+ *
+ * @param bytes - The raw .odt file as a Uint8Array.
+ * @param options - Combined emitter and read options. The trackedChanges
+ *   field is forwarded to both readOdt() and modelToTypst() — set it once
+ *   for consistent results across both steps.
+ * @returns Typst markup string (.typ).
+ *
+ * @example
+ * ```typescript
+ * import { odtToTypst } from "odf-kit/typst";
+ * import { readFileSync, writeFileSync } from "node:fs";
+ *
+ * const bytes = new Uint8Array(readFileSync("document.odt"));
+ * const typ = odtToTypst(bytes);
+ * writeFileSync("document.typ", typ);
+ * // then: typst compile document.typ document.pdf
+ * ```
+ */
+export function odtToTypst(bytes, options) {
+    const model = readOdt(bytes, options);
+    return modelToTypst(model, options);
+}
+//# sourceMappingURL=emitter.js.map

package/dist/typst/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/typst/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAiBH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA4B9C,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAE/D,4DAA4D;AAC5D,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAE3C;;;;;GAKG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjF,CAAC;AAED,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D;;;;;GAKG;AACH,SAAS,aAAa,CAAC,KAAuB;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAExE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACjF,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1F,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACpF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACvF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE9E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;AAE/D;;;;;;;;;;;GAWG;AACH,SAAS,cAAc,CAAC,KAAgB,EAAE,OAAe;IACvD,IAAI,GAAG,GAAG,OAAO,CAAC;IAElB,qDAAqD;IACrD,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACvC,GAAG,GAAG,yBAAyB,KAAK,CAAC,cAAc,OAAO,GAAG,GAAG,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IACpF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IACjF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,GAAG,GAAG,SAAS,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;IAChD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAE/D;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,IAAc;IAClC,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAE3B,IAAI,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,WAAW;QAAE,GAAG,GAAG,UAAU,GAAG,GAAG,CAAC;IAC7C,IAAI,IAAI,CAAC,SAAS;QAAE,GAAG,GAAG,QAAQ,GAAG,GAAG,CAAC;IACzC,IAAI,IAAI,CAAC,aAAa;QAAE,GAAG,GAAG,WAAW,GAAG,GAAG,CAAC;IAChD,IAAI,IAAI,CAAC,SAAS;QAAE,GAAG,GAAG,cAAc,GAAG,GAAG,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI;QAAE,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IAEhC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,GAAG,GAAG,UAAU,IAAI,CAAC,IAAI,MAAM,GAAG,GAAG,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,SAAS,CAAC,IAAe;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;IACjD,MAAM,IAAI,GACR,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QACnD,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,MAAM,EAAE;QACxC,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,cAAc,KAAK,GAAG,IAAI,MAAM,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,IAAc,EAAE,OAA0B;IAC1D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,aAAa,IAAI,GAAG,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,IAAkB;IACtC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,IAAe;IAChC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,YAAY;YACf,OAAO,0BAA0B,CAAC;QACpC,KAAK,WAAW;YACd,OAAO,gCAAgC,CAAC;QAC1C;YACE,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,IAAgB,EAAE,OAA0B;IAClE,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;YACzB,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjC,KAAK,UAAU;gBACb,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5B,KAAK,OAAO;gBACV,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,IAAgB,CAAC,CAAC;AACxC,CAAC;AAED,0EAA0E;AAC1E,SAAS,SAAS,CAAC,KAAmB,EAAE,OAA0B;IAChE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,+DAA+D;AAC/D,uBAAuB;AACvB,+DAA+D;AAE/D;;;;;GAKG;AACH,SAAS,YAAY,CAAC,SAAiB;IACrC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,IAAc,EAAE,OAA0B,EAAE,KAAK,GAAG,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,GAAG,MAAM,GAAG,MAAM,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;IAClD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,SAAS,CAAC,KAAgB,EAAE,OAA0B;IAC7D,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAEzD,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,aAAa,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7D,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;IAEvB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI;SACrB,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;SAChF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,cAAc,UAAU,QAAQ,KAAK,KAAK,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,IAAiB,EAAE,OAA0B;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IACnF,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,GAAG,MAAM,KAAK,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,iBAAiB,CAAC,IAAuB,EAAE,OAA0B;IAC5E,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE/C,IAAI,OAAO,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,cAAc,IAAI,GAAG,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,WAAW,IAAI,GAAG,CAAC;QAC5B,KAAK,eAAe;YAClB,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,SAAS,YAAY,CAAC,IAAc,EAAE,OAA0B;IAC9D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,cAAc,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;gBAC1D,OAAO,UAAU,KAAK,KAAK,OAAO,GAAG,CAAC;YACxC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;QAChC,CAAC;QACD,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,gBAAgB;YACnB,OAAO,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAgB,EAAE,OAA0B;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAuB,EAAE,OAA0B;IAC9E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,OAA2C;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/typst/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Typst emitter for odf-kit.
+ *
+ * Converts ODT documents to Typst markup (.typ), which can then be compiled
+ * to PDF by any Typst 0.11+ installation:
+ *
+ *   typst compile document.typ document.pdf
+ *
+ * Import from "odf-kit/typst" (separate from the main "odf-kit" import
+ * so the emitter is only bundled when explicitly needed):
+ *
+ * ```typescript
+ * import { modelToTypst, odtToTypst } from "odf-kit/typst";
+ * ```
+ *
+ * modelToTypst() accepts a pre-parsed OdtDocumentModel and is the primary
+ * function. odtToTypst() is a convenience wrapper that calls readOdt() +
+ * modelToTypst() in a single step.
+ *
+ * Both functions are zero-dependency pure functions — no filesystem access,
+ * no child process spawning, no Typst installation required at import time.
+ * The consumer decides how to use the returned .typ string.
+ */
+export { modelToTypst, odtToTypst } from "./emitter.js";
+export type { TypstEmitOptions } from "./emitter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/typst/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/typst/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/typst/index.js

@@ -0,0 +1,25 @@
+/**
+ * Typst emitter for odf-kit.
+ *
+ * Converts ODT documents to Typst markup (.typ), which can then be compiled
+ * to PDF by any Typst 0.11+ installation:
+ *
+ *   typst compile document.typ document.pdf
+ *
+ * Import from "odf-kit/typst" (separate from the main "odf-kit" import
+ * so the emitter is only bundled when explicitly needed):
+ *
+ * ```typescript
+ * import { modelToTypst, odtToTypst } from "odf-kit/typst";
+ * ```
+ *
+ * modelToTypst() accepts a pre-parsed OdtDocumentModel and is the primary
+ * function. odtToTypst() is a convenience wrapper that calls readOdt() +
+ * modelToTypst() in a single step.
+ *
+ * Both functions are zero-dependency pure functions — no filesystem access,
+ * no child process spawning, no Typst installation required at import time.
+ * The consumer decides how to use the returned .typ string.
+ */
+export { modelToTypst, odtToTypst } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/typst/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typst/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odf-kit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Create OpenDocument Format files (.odt, .ods, .odp, .odg) in TypeScript/JavaScript. Works in Node.js and browsers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,6 +13,10 @@
     "./reader": {
       "types": "./dist/reader/index.d.ts",
       "import": "./dist/reader/index.js"
+    },
+    "./typst": {
+      "types": "./dist/typst/index.d.ts",
+      "import": "./dist/typst/index.js"
     }
   },
   "files": [