@usejunior/odf-core 0.9.1 → 0.11.0

package/dist/convert/inline.js

@@ -0,0 +1,274 @@
+/**
+ * Inline content emission for the DOCX → ODT converter: `tagged_text` TOON tokens →
+ * `text:span` / `text:a` DOM, backed by a deduped automatic text-style registry.
+ *
+ * The token grammar is owned by docx-core (`tokenizeToonInline`, the same primitive the
+ * markdown/HTML serializers consume) so this module never re-derives it. Supported wraps are
+ * bold / italic / underline / highlight (with its full-mode source color) and the full-mode
+ * `<font color size face>` tag, mapped to `fo:color` / `fo:font-size` / `style:font-name`
+ * automatic styles (#406 phase 3). Unsafe hyperlink schemes degrade to plain text via the
+ * shared `isSafeHref`.
+ */
+import { isSafeHref, tokenizeToonInline } from '@usejunior/docx-core';
+import { ODF_NS } from '../shared/odf/namespaces.js';
+import { appendTextWithWhitespace, quoteFontFamily } from './package.js';
+/**
+ * OOXML `ST_HighlightColor` enum values (`w:highlight`) → the hex Word renders them as.
+ * The TOON highlight tag carries the source enum value in full mode; anything unknown
+ * degrades to yellow with a lossiness entry rather than dropping the highlight.
+ */
+const HIGHLIGHT_COLOR_HEX = {
+    yellow: '#ffff00',
+    green: '#00ff00',
+    cyan: '#00ffff',
+    magenta: '#ff00ff',
+    blue: '#0000ff',
+    red: '#ff0000',
+    darkBlue: '#00008b',
+    darkCyan: '#008b8b',
+    darkGreen: '#006400',
+    darkMagenta: '#8b008b',
+    darkRed: '#8b0000',
+    darkYellow: '#808000',
+    darkGray: '#a9a9a9',
+    lightGray: '#d3d3d3',
+    black: '#000000',
+    white: '#ffffff',
+};
+const DEFAULT_HIGHLIGHT_HEX = HIGHLIGHT_COLOR_HEX['yellow'];
+/**
+ * Deduped `office:font-face-decls` registry: one `style:font-face` per distinct face name
+ * used anywhere in the document (ODF resolves `style:font-name` against declared faces).
+ */
+export class FontFaceRegistry {
+    doc;
+    container;
+    declared = new Set();
+    constructor(doc, container) {
+        this.doc = doc;
+        this.container = container;
+    }
+    ensure(face) {
+        if (this.declared.has(face))
+            return;
+        this.declared.add(face);
+        const decl = this.doc.createElementNS(ODF_NS.STYLE, 'style:font-face');
+        decl.setAttributeNS(ODF_NS.STYLE, 'style:name', face);
+        decl.setAttributeNS(ODF_NS.SVG, 'svg:font-family', quoteFontFamily(face));
+        this.container.appendChild(decl);
+    }
+}
+/**
+ * Deduped `office:automatic-styles` registry for run formatting: one `T<n>` text style per
+ * distinct format combination, shared across the whole document.
+ */
+export class TextStyleRegistry {
+    doc;
+    container;
+    fontFaces;
+    byKey = new Map();
+    constructor(doc, container, fontFaces) {
+        this.doc = doc;
+        this.container = container;
+        this.fontFaces = fontFaces;
+    }
+    styleFor(formats) {
+        const key = [
+            formats.bold ? 'b' : '',
+            formats.italic ? 'i' : '',
+            formats.underline ? 'u' : '',
+            formats.highlight ?? '',
+            formats.fontColor ?? '',
+            formats.fontSizePt ?? '',
+            formats.fontFace ?? '',
+        ].join('|');
+        const existing = this.byKey.get(key);
+        if (existing)
+            return existing;
+        const name = `T${this.byKey.size + 1}`;
+        const style = this.doc.createElementNS(ODF_NS.STYLE, 'style:style');
+        style.setAttributeNS(ODF_NS.STYLE, 'style:name', name);
+        style.setAttributeNS(ODF_NS.STYLE, 'style:family', 'text');
+        const props = this.doc.createElementNS(ODF_NS.STYLE, 'style:text-properties');
+        if (formats.bold)
+            props.setAttributeNS(ODF_NS.FO, 'fo:font-weight', 'bold');
+        if (formats.italic)
+            props.setAttributeNS(ODF_NS.FO, 'fo:font-style', 'italic');
+        if (formats.underline) {
+            props.setAttributeNS(ODF_NS.STYLE, 'style:text-underline-style', 'solid');
+            props.setAttributeNS(ODF_NS.STYLE, 'style:text-underline-width', 'auto');
+            props.setAttributeNS(ODF_NS.STYLE, 'style:text-underline-color', 'font-color');
+        }
+        if (formats.highlight)
+            props.setAttributeNS(ODF_NS.FO, 'fo:background-color', formats.highlight);
+        if (formats.fontColor)
+            props.setAttributeNS(ODF_NS.FO, 'fo:color', formats.fontColor);
+        if (formats.fontSizePt !== null)
+            props.setAttributeNS(ODF_NS.FO, 'fo:font-size', `${formats.fontSizePt}pt`);
+        if (formats.fontFace) {
+            this.fontFaces.ensure(formats.fontFace);
+            props.setAttributeNS(ODF_NS.STYLE, 'style:font-name', formats.fontFace);
+        }
+        style.appendChild(props);
+        this.container.appendChild(style);
+        this.byKey.set(key, name);
+        return name;
+    }
+}
+/** Reverse of `formatting_tags.ts`'s `escapeHtmlAttribute` (`&amp;` last so it can't re-expand). */
+function unescapeAttributeValue(value) {
+    return value
+        .replaceAll('&lt;', '<')
+        .replaceAll('&gt;', '>')
+        .replaceAll('&quot;', '"')
+        .replaceAll('&amp;', '&');
+}
+function attributeValue(tag, name) {
+    const match = new RegExp(`\\b${name}="([^"]*)"`).exec(tag);
+    return match ? unescapeAttributeValue(match[1]) : null;
+}
+/** Map a TOON highlight open tag to its ODF background hex. */
+function highlightHexFor(tag, lossiness) {
+    const val = attributeValue(tag, 'color');
+    // Compact mode emits the value-less form; the historical normalization to yellow applies.
+    if (val === null)
+        return DEFAULT_HIGHLIGHT_HEX;
+    const hex = HIGHLIGHT_COLOR_HEX[val];
+    if (hex)
+        return hex;
+    lossiness.add('unknown-highlight-color', val);
+    return DEFAULT_HIGHLIGHT_HEX;
+}
+/**
+ * Append one `tagged_text` string's content to `parent` (a `text:p`/`text:h` or table-cell
+ * paragraph), wrapping formatted runs in `text:span` and hyperlinks in `text:a`.
+ */
+export function appendInlineContent(doc, parent, taggedText, styles, lossiness) {
+    const formats = {
+        bold: false,
+        italic: false,
+        underline: false,
+        highlight: null,
+        fontColor: null,
+        fontSizePt: null,
+        fontFace: null,
+    };
+    let openAnchor = null;
+    // The currently open span and the format key it was created for: consecutive text tokens with
+    // an unchanged format set share one span instead of fragmenting into adjacent twins.
+    let openSpan = null;
+    const formatKey = () => [
+        formats.bold ? 'b' : '',
+        formats.italic ? 'i' : '',
+        formats.underline ? 'u' : '',
+        formats.highlight ?? '',
+        formats.fontColor ?? '',
+        formats.fontSizePt ?? '',
+        formats.fontFace ?? '',
+    ].join('|');
+    const EMPTY_KEY = '||||||';
+    for (const token of tokenizeToonInline(taggedText)) {
+        if (token.kind === 'text') {
+            const container = openAnchor ?? parent;
+            const key = formatKey();
+            if (key === EMPTY_KEY) {
+                openSpan = null;
+                appendTextWithWhitespace(doc, container, token.value);
+                continue;
+            }
+            if (!openSpan || openSpan.key !== key || openSpan.el.parentNode !== container) {
+                const span = doc.createElementNS(ODF_NS.TEXT, 'text:span');
+                span.setAttributeNS(ODF_NS.TEXT, 'text:style-name', styles.styleFor(formats));
+                container.appendChild(span);
+                openSpan = { el: span, key };
+            }
+            appendTextWithWhitespace(doc, openSpan.el, token.value);
+            continue;
+        }
+        const tag = token.value;
+        if (tag === '<b>') {
+            formats.bold = true;
+            openSpan = null;
+        }
+        else if (tag === '</b>') {
+            formats.bold = false;
+            openSpan = null;
+        }
+        else if (tag === '<i>') {
+            formats.italic = true;
+            openSpan = null;
+        }
+        else if (tag === '</i>') {
+            formats.italic = false;
+            openSpan = null;
+        }
+        else if (tag === '<u>') {
+            formats.underline = true;
+            openSpan = null;
+        }
+        else if (tag === '</u>') {
+            formats.underline = false;
+            openSpan = null;
+        }
+        else if (tag === '<highlight>' || tag.startsWith('<highlight ')) {
+            formats.highlight = highlightHexFor(tag, lossiness);
+            openSpan = null;
+        }
+        else if (tag === '</highlight>') {
+            formats.highlight = null;
+            openSpan = null;
+        }
+        else if (tag.startsWith('<a ')) {
+            const escapedHref = /href="([^"]*)"/.exec(tag)?.[1] ?? '';
+            // The TOON attribute value is escaped by emitFormattingTags; setAttributeNS escapes
+            // again on serialize, so assign the DECODED value or `&amp;` doubles.
+            const href = unescapeAttributeValue(escapedHref);
+            if (isSafeHref(href)) {
+                const anchor = doc.createElementNS(ODF_NS.TEXT, 'text:a');
+                anchor.setAttributeNS(ODF_NS.XLINK, 'xlink:type', 'simple');
+                anchor.setAttributeNS(ODF_NS.XLINK, 'xlink:href', href);
+                parent.appendChild(anchor);
+                openAnchor = anchor;
+            }
+            else {
+                lossiness.add('unsafe-hyperlink-href', href);
+                openAnchor = null;
+            }
+            openSpan = null;
+        }
+        else if (tag === '</a>') {
+            openAnchor = null;
+            openSpan = null;
+        }
+        else if (tag.startsWith('<font ')) {
+            // Full-mode font runs: color is the raw w:color hex (no '#'), size is points, face is
+            // the font name. A malformed color degrades to the default color, reported.
+            const color = attributeValue(tag, 'color');
+            if (color !== null) {
+                if (/^[0-9A-Fa-f]{6}$/.test(color)) {
+                    formats.fontColor = `#${color.toLowerCase()}`;
+                }
+                else {
+                    lossiness.add('unmappable-font-color', color);
+                    formats.fontColor = null;
+                }
+            }
+            else {
+                formats.fontColor = null;
+            }
+            const size = attributeValue(tag, 'size');
+            const sizePt = size !== null ? Number(size) : NaN;
+            formats.fontSizePt = Number.isFinite(sizePt) && sizePt > 0 ? sizePt : null;
+            const face = attributeValue(tag, 'face');
+            formats.fontFace = face !== null && face.trim() !== '' ? face : null;
+            openSpan = null;
+        }
+        else if (tag === '</font>') {
+            formats.fontColor = null;
+            formats.fontSizePt = null;
+            formats.fontFace = null;
+            openSpan = null;
+        }
+    }
+}
+//# sourceMappingURL=inline.js.map

package/dist/convert/inline.js.map

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

package/dist/convert/lists.d.ts

@@ -0,0 +1,41 @@
+/**
+ * List emission for the DOCX → ODT converter: flat auto-numbered/bullet view nodes →
+ * nested `text:list` DOM plus synthesized `text:list-style`s.
+ *
+ * The nesting logic is a DOM port of the HTML serializer's `ListBuilder`: OOXML `ilvl`
+ * carries no monotonicity guarantee, so each open list records the item LEVEL that opened
+ * it (not just depth) — that keeps consecutive same-level items siblings even after a
+ * level jump that skipped intermediate depths.
+ */
+import type { NumberingModel } from '@usejunior/docx-core';
+/**
+ * Deduped `office:automatic-styles` registry for lists: one `L<n>` list style per source
+ * `num_id` (or per fallback kind when the numbering model has no entry), with one
+ * `text:list-level-style-*` per level sourced from the OOXML numbering definition.
+ */
+export declare class ListStyleRegistry {
+    private readonly doc;
+    private readonly container;
+    private readonly numbering;
+    private byKey;
+    constructor(doc: Document, container: Element, numbering: NumberingModel | null);
+    /** Style name for a list opened by a node with the given `num_id` (bullet hint for model-less docs). */
+    styleFor(numId: string | null, bulletHint: boolean): string;
+    /** True when the level's source `numFmt` is `bullet` (used to pick the fallback hint). */
+    isBulletLevel(numId: string | null, ilvl: number | null): boolean;
+    private abstractFor;
+    private bulletLevel;
+    private numberLevel;
+}
+/**
+ * Builds one contiguous run of list items as nested `text:list` DOM under `parent`.
+ * `item()` returns the `text:p` to fill with the node's inline content.
+ */
+export declare class ListDomBuilder {
+    private readonly doc;
+    private readonly parent;
+    private stack;
+    constructor(doc: Document, parent: Element);
+    item(level: number, styleName: string, paragraphStyleName?: string): Element;
+}
+//# sourceMappingURL=lists.d.ts.map

package/dist/convert/lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/convert/lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgB3D;;;;GAIG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,KAAK,CAA6B;gBAGvB,GAAG,EAAE,QAAQ,EACb,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,cAAc,GAAG,IAAI;IAGnD,wGAAwG;IACxG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM;IAsB3D,0FAA0F;IAC1F,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAKjE,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAUpB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,KAAK,CAA+C;gBAGzC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,OAAO;IAGlC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,SAAa,GAAG,OAAO;CAgCjF"}

package/dist/convert/lists.js

@@ -0,0 +1,137 @@
+/**
+ * List emission for the DOCX → ODT converter: flat auto-numbered/bullet view nodes →
+ * nested `text:list` DOM plus synthesized `text:list-style`s.
+ *
+ * The nesting logic is a DOM port of the HTML serializer's `ListBuilder`: OOXML `ilvl`
+ * carries no monotonicity guarantee, so each open list records the item LEVEL that opened
+ * it (not just depth) — that keeps consecutive same-level items siblings even after a
+ * level jump that skipped intermediate depths.
+ */
+import { ODF_NS } from '../shared/odf/namespaces.js';
+/** OOXML `numFmt` → ODF `style:num-format`. Anything unmapped falls back to decimal. */
+const NUM_FORMAT_MAP = {
+    decimal: '1',
+    lowerLetter: 'a',
+    upperLetter: 'A',
+    lowerRoman: 'i',
+    upperRoman: 'I',
+};
+const MAX_LIST_LEVELS = 10;
+const DEFAULT_BULLET_CHAR = '•';
+/**
+ * Deduped `office:automatic-styles` registry for lists: one `L<n>` list style per source
+ * `num_id` (or per fallback kind when the numbering model has no entry), with one
+ * `text:list-level-style-*` per level sourced from the OOXML numbering definition.
+ */
+export class ListStyleRegistry {
+    doc;
+    container;
+    numbering;
+    byKey = new Map();
+    constructor(doc, container, numbering) {
+        this.doc = doc;
+        this.container = container;
+        this.numbering = numbering;
+    }
+    /** Style name for a list opened by a node with the given `num_id` (bullet hint for model-less docs). */
+    styleFor(numId, bulletHint) {
+        const abstract = this.abstractFor(numId);
+        const key = abstract ? `num:${abstract.abstractNumId}` : bulletHint ? 'fallback:bullet' : 'fallback:number';
+        const existing = this.byKey.get(key);
+        if (existing)
+            return existing;
+        const name = `L${this.byKey.size + 1}`;
+        const style = this.doc.createElementNS(ODF_NS.TEXT, 'text:list-style');
+        style.setAttributeNS(ODF_NS.STYLE, 'style:name', name);
+        for (let level = 0; level < MAX_LIST_LEVELS; level++) {
+            const def = abstract?.levels.get(level);
+            if (def ? def.numFmt === 'bullet' : bulletHint) {
+                style.appendChild(this.bulletLevel(level));
+            }
+            else {
+                style.appendChild(this.numberLevel(level, def ?? null));
+            }
+        }
+        this.container.appendChild(style);
+        this.byKey.set(key, name);
+        return name;
+    }
+    /** True when the level's source `numFmt` is `bullet` (used to pick the fallback hint). */
+    isBulletLevel(numId, ilvl) {
+        const def = this.abstractFor(numId)?.levels.get(ilvl ?? 0);
+        return def?.numFmt === 'bullet';
+    }
+    abstractFor(numId) {
+        if (!numId || !this.numbering)
+            return null;
+        const instance = this.numbering.nums.get(numId);
+        if (!instance)
+            return null;
+        return this.numbering.abstractNums.get(instance.abstractNumId) ?? null;
+    }
+    bulletLevel(level) {
+        const el = this.doc.createElementNS(ODF_NS.TEXT, 'text:list-level-style-bullet');
+        el.setAttributeNS(ODF_NS.TEXT, 'text:level', String(level + 1));
+        el.setAttributeNS(ODF_NS.TEXT, 'text:bullet-char', DEFAULT_BULLET_CHAR);
+        return el;
+    }
+    numberLevel(level, def) {
+        const el = this.doc.createElementNS(ODF_NS.TEXT, 'text:list-level-style-number');
+        el.setAttributeNS(ODF_NS.TEXT, 'text:level', String(level + 1));
+        el.setAttributeNS(ODF_NS.STYLE, 'style:num-format', NUM_FORMAT_MAP[def?.numFmt ?? 'decimal'] ?? '1');
+        // The literal after the last `%N` placeholder (e.g. `%1.` → `.`, `%1)` → `)`).
+        const suffix = def ? /%\d+([^%]*)$/.exec(def.lvlText)?.[1] ?? '' : '.';
+        if (suffix)
+            el.setAttributeNS(ODF_NS.STYLE, 'style:num-suffix', suffix);
+        if (def && def.start !== 1)
+            el.setAttributeNS(ODF_NS.TEXT, 'text:start-value', String(def.start));
+        return el;
+    }
+}
+/**
+ * Builds one contiguous run of list items as nested `text:list` DOM under `parent`.
+ * `item()` returns the `text:p` to fill with the node's inline content.
+ */
+export class ListDomBuilder {
+    doc;
+    parent;
+    stack = [];
+    constructor(doc, parent) {
+        this.doc = doc;
+        this.parent = parent;
+    }
+    item(level, styleName, paragraphStyleName = 'Standard') {
+        const lvl = Math.max(0, level);
+        while (this.stack.length > 0 && this.stack[this.stack.length - 1].level > lvl) {
+            this.stack.pop();
+        }
+        let top = this.stack[this.stack.length - 1];
+        if (!top || top.level !== lvl) {
+            // Deeper than the open top (or the first item): open ONE nested list recording the
+            // item's actual level, so a >1 jump still nests a single step.
+            const list = this.doc.createElementNS(ODF_NS.TEXT, 'text:list');
+            list.setAttributeNS(ODF_NS.TEXT, 'text:style-name', styleName);
+            if (!top) {
+                this.parent.appendChild(list);
+            }
+            else {
+                // Nested lists live inside a list-item; reuse the last one or create a holder.
+                let host = top.list.lastChild;
+                if (!host || host.localName !== 'list-item') {
+                    host = this.doc.createElementNS(ODF_NS.TEXT, 'text:list-item');
+                    top.list.appendChild(host);
+                }
+                host.appendChild(list);
+            }
+            this.stack.push({ list, level: lvl });
+            top = this.stack[this.stack.length - 1];
+        }
+        const item = this.doc.createElementNS(ODF_NS.TEXT, 'text:list-item');
+        top.list.appendChild(item);
+        const p = this.doc.createElementNS(ODF_NS.TEXT, 'text:p');
+        p.setAttributeNS(ODF_NS.TEXT, 'text:style-name', paragraphStyleName);
+        item.appendChild(p);
+        return p;
+    }
+}
+//# sourceMappingURL=lists.js.map

package/dist/convert/lists.js.map

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

package/dist/convert/package.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Fresh-package scaffolding for the DOCX → ODT converter: XML part templates and the
+ * whitespace writer that is the emit-side mirror of `shared/odf/text_segments.ts`.
+ *
+ * The `office:version="1.3"` attribute on every document root is required — LibreOffice
+ * tolerates its absence, but strict ODF validators reject the package without it.
+ */
+import { type StyleRunFormatting, type StylesModel } from '@usejunior/docx-core';
+/** Quote a font family for `svg:font-family` when it contains non-name characters (spaces). */
+export declare function quoteFontFamily(face: string): string;
+/** The skeleton `content.xml` DOM plus the insertion points the converter fills. */
+export interface ContentScaffold {
+    doc: Document;
+    fontFaceDecls: Element;
+    automaticStyles: Element;
+    body: Element;
+}
+/** Parse the empty content.xml skeleton and hand back its insertion points. */
+export declare function createContentScaffold(): ContentScaffold;
+/** Source-derived named-style formatting feeding {@link buildStylesXml}. */
+export interface SourceNamedStyles {
+    /** Resolved run formatting per heading level 1..6 (absent levels keep template defaults). */
+    headings: Map<number, StyleRunFormatting>;
+    /** Resolved run formatting of the source `Normal` style, or null when undefined. */
+    normal: StyleRunFormatting | null;
+}
+/**
+ * Resolve the source styles the converted `styles.xml` is seeded from: `Heading1..6` (matched
+ * by styleId or by the canonical `heading N` style name) and `Normal`. Properties a chain
+ * never specifies stay `null` so the template defaults survive.
+ */
+export declare function deriveSourceNamedStyles(styles: StylesModel): SourceNamedStyles;
+/**
+ * Seed `styles.xml`: `Standard`, a bold `Heading` base, `Heading_20_1..6` (descending sizes,
+ * `style:default-outline-level`), and `Text_20_body`. When `source` carries the document's
+ * resolved style-chain formatting, heading sizes/weights/colors/fonts and the `Standard` body
+ * font come from the source instead of the fixed template (#406 phase 3); properties the
+ * source never specifies keep the template defaults.
+ */
+export declare function buildStylesXml(source?: SourceNamedStyles): string;
+/** Build `meta.xml` carrying the generator string and optional title. */
+export declare function buildMetaXml(metadata?: {
+    title?: string;
+    generator?: string;
+}): string;
+/**
+ * Append visible text to `parent`, encoding whitespace the way ODF readers decode it
+ * (the writer mirror of `buildSegments`): a run of N≥2 spaces becomes one literal space +
+ * `<text:s text:c="N-1"/>`, tabs become `text:tab`, newlines become `text:line-break`.
+ * A leading space is encoded as `text:s` outright — ODF processors collapse literal
+ * leading whitespace.
+ */
+export declare function appendTextWithWhitespace(doc: Document, parent: Element, text: string): void;
+//# sourceMappingURL=package.d.ts.map

package/dist/convert/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/convert/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAuC,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAItH,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAsBD,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,QAAQ,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,IAAI,eAAe,CAMvD;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1C,oFAAoF;IACpF,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAe9E;AA+BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA2DjE;AAMD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiBtF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAwC3F"}