dom-docx 0.1.0

package/dist/converter/flex.d.ts

@@ -0,0 +1,59 @@
+import { Table } from "docx";
+import type { Element } from "domhandler";
+import { type ParsedCss } from "./css.js";
+import type { StyleResolver } from "./style-resolver.js";
+import type { BlockLayout, DocxBlock, FlexLayout } from "./types.js";
+export declare function borderlessTableBorders(): {
+    top: {
+        style: "none";
+        size: number;
+        color: string;
+    };
+    bottom: {
+        style: "none";
+        size: number;
+        color: string;
+    };
+    left: {
+        style: "none";
+        size: number;
+        color: string;
+    };
+    right: {
+        style: "none";
+        size: number;
+        color: string;
+    };
+    insideHorizontal: {
+        style: "none";
+        size: number;
+        color: string;
+    };
+    insideVertical: {
+        style: "none";
+        size: number;
+        color: string;
+    };
+};
+export interface FlexItemContent {
+    layout: BlockLayout;
+    blocks: DocxBlock[];
+    /** Shrink-wrapped column width when flex items have no flex-grow. */
+    intrinsicWidthTwips?: number;
+    /**
+     * Estimated tight content height (twips) for card-style items with block children.
+     * LibreOffice sizes rows by natural font metrics (ignoring EXACT line spacing), so an
+     * explicit exact row height is needed to keep cards from inflating vertically.
+     */
+    contentHeightTwips?: number;
+}
+export declare function estimateFlexItemWidthTwips(element: Element, layout: BlockLayout, styleResolver?: StyleResolver): number;
+export declare function parseFlexLayoutFromCss(css: ParsedCss): FlexLayout | null;
+export declare function parseFlexLayout(css: ParsedCss): FlexLayout | null;
+export declare function isFlexContainer(element: Element, styleResolver?: StyleResolver): boolean;
+export declare function flexItemElements(element: Element, styleResolver?: StyleResolver): Element[];
+/** Horizontal flex → single-row borderless table with explicit gap columns. */
+export declare function makeFlexRowTable(items: FlexItemContent[], gap: number | undefined, containerLayout: BlockLayout): Table;
+/** Vertical flex → multi-row borderless table; gap via unshaded exact-height spacer rows. */
+export declare function makeFlexColumnTable(items: FlexItemContent[], gap: number | undefined, containerLayout: BlockLayout): Table;
+//# sourceMappingURL=flex.d.ts.map

package/dist/converter/flex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../../src/converter/flex.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,EAKN,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAA4E,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACpH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIrE,wBAAgB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAiBD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,aAAa,GAAE,aAAqC,GACnD,MAAM,CAUR;AAwDD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAMxE;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,GACb,UAAU,GAAG,IAAI,CAEnB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,aAAqC,GACnD,OAAO,CAET;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,aAAqC,GACnD,OAAO,EAAE,CAIX;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EAAE,EACxB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,eAAe,EAAE,WAAW,GAC3B,KAAK,CAuDP;AAyED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EAAE,EACxB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,eAAe,EAAE,WAAW,GAC3B,KAAK,CA8CP"}

package/dist/converter/flex.js

@@ -0,0 +1,252 @@
+import { BorderStyle, HeightRule, LineRuleType, Paragraph, ShadingType, Table, TableCell, TableRow, VerticalAlign, WidthType, } from "docx";
+import { PRINTABLE_CONTENT_WIDTH_TWIPS } from "./constants.js";
+import { visibleCellBorders } from "./bordered-block.js";
+import { isHiddenElement, layoutForNativeShadedBlock, pxToTwips } from "./css.js";
+import { INLINE_STYLE_RESOLVER } from "./style-resolver.js";
+import { estimateTextWidthTwips, minContentWidthTwips } from "./text-metrics.js";
+const BORDERLESS = { style: BorderStyle.NONE, size: 0, color: "auto" };
+export function borderlessTableBorders() {
+    return {
+        top: BORDERLESS,
+        bottom: BORDERLESS,
+        left: BORDERLESS,
+        right: BORDERLESS,
+        insideHorizontal: BORDERLESS,
+        insideVertical: BORDERLESS,
+    };
+}
+function elementPlainText(element) {
+    const parts = [];
+    function walk(nodes) {
+        for (const node of nodes) {
+            if (node.type === "text")
+                parts.push(node.data ?? "");
+            else if (node.type === "tag")
+                walk(node.children ?? []);
+        }
+    }
+    walk(element.children ?? []);
+    return parts.join("").replace(/\s+/g, " ").trim();
+}
+/** Word/LibreOffice Arial runs slightly wider than our glyph estimate — pad shrink-wrapped flex columns. */
+const FLEX_ITEM_WIDTH_SAFETY_TWIPS = pxToTwips(8);
+export function estimateFlexItemWidthTwips(element, layout, styleResolver = INLINE_STYLE_RESOLVER) {
+    const text = elementPlainText(element);
+    const css = styleResolver.getCss(element);
+    const bold = css.fontWeight === "bold" || Number(css.fontWeight) >= 600;
+    const padX = (layout.paddingLeft ?? 0) + (layout.paddingRight ?? 0);
+    const content = Math.max(minContentWidthTwips(32), estimateTextWidthTwips(text, { bold, fontSizeHalfPoints: css.fontSize }));
+    return padX + content + FLEX_ITEM_WIDTH_SAFETY_TWIPS;
+}
+function distributeFlexItemWidths(weights, total) {
+    if (weights.length === 0)
+        return [];
+    const sum = weights.reduce((acc, w) => acc + w, 0);
+    if (sum <= 0) {
+        const base = Math.floor(total / weights.length);
+        const equal = Array.from({ length: weights.length }, () => base);
+        for (let i = 0; i < total - base * weights.length; i++) {
+            equal[i] += 1;
+        }
+        return equal;
+    }
+    const scaled = weights.map((w) => (w / sum) * total);
+    const columnWidths = scaled.map((w) => Math.floor(w));
+    let remainder = total - columnWidths.reduce((acc, w) => acc + w, 0);
+    const fractional = scaled
+        .map((w, index) => ({ index, fraction: w - Math.floor(w) }))
+        .sort((a, b) => b.fraction - a.fraction);
+    for (let i = 0; remainder > 0; i++, remainder--) {
+        columnWidths[fractional[i % fractional.length].index] += 1;
+    }
+    return columnWidths;
+}
+function rowColumnPlan(items, gapTwips) {
+    const itemCount = items.length;
+    const gapTotal = gapTwips * Math.max(0, itemCount - 1);
+    const available = Math.max(0, PRINTABLE_CONTENT_WIDTH_TWIPS - gapTotal);
+    const weights = items.map((item) => Math.max(minContentWidthTwips(32), item.intrinsicWidthTwips ?? 0));
+    // Browsers shrink-wrap row items (no flex-grow parsing) — keep intrinsic
+    // widths and only scale down when they would overflow the printable width.
+    const wanted = weights.reduce((acc, w) => acc + w, 0);
+    const itemWidths = wanted > available ? distributeFlexItemWidths(weights, available) : weights;
+    const columnWidths = [];
+    let totalWidth = 0;
+    itemWidths.forEach((width, index) => {
+        columnWidths.push(width);
+        totalWidth += width;
+        if (index < itemCount - 1 && gapTwips > 0) {
+            columnWidths.push(gapTwips);
+            totalWidth += gapTwips;
+        }
+    });
+    return { columnWidths, totalWidth };
+}
+export function parseFlexLayoutFromCss(css) {
+    if (css.display !== "flex" && css.display !== "inline-flex")
+        return null;
+    return {
+        direction: css.flexDirection === "column" ? "column" : "row",
+        gap: css.gap,
+    };
+}
+export function parseFlexLayout(css) {
+    return parseFlexLayoutFromCss(css);
+}
+export function isFlexContainer(element, styleResolver = INLINE_STYLE_RESOLVER) {
+    return parseFlexLayoutFromCss(styleResolver.getCss(element)) !== null;
+}
+export function flexItemElements(element, styleResolver = INLINE_STYLE_RESOLVER) {
+    return (element.children ?? []).filter((node) => node.type === "tag" && !isHiddenElement(node, styleResolver));
+}
+/** Horizontal flex → single-row borderless table with explicit gap columns. */
+export function makeFlexRowTable(items, gap, containerLayout) {
+    const gapTwips = gap ?? 0;
+    const { columnWidths, totalWidth } = rowColumnPlan(items, gapTwips);
+    const cells = [];
+    items.forEach((item, index) => {
+        const width = columnWidths[cells.length];
+        cells.push(new TableCell({
+            width: { size: width, type: WidthType.DXA },
+            // Card items (stacked block children) flow from the top like the browser;
+            // simple inline items stay vertically centered.
+            verticalAlign: item.contentHeightTwips ? VerticalAlign.TOP : VerticalAlign.CENTER,
+            shading: item.layout.shading
+                ? { type: ShadingType.CLEAR, ...item.layout.shading }
+                : undefined,
+            ...(item.layout.borders ? { borders: visibleCellBorders(item.layout.borders) } : {}),
+            margins: {
+                top: item.layout.paddingTop ?? 0,
+                bottom: item.layout.paddingBottom ?? 0,
+                left: item.layout.paddingLeft ?? 0,
+                right: item.layout.paddingRight ?? 0,
+            },
+            children: item.blocks.length > 0 ? item.blocks : [new Paragraph({ children: [] })],
+        }));
+        if (index < items.length - 1 && gapTwips > 0) {
+            cells.push(new TableCell({
+                width: { size: gapTwips, type: WidthType.DXA },
+                margins: { top: 0, bottom: 0, left: 0, right: 0 },
+                children: [new Paragraph({ children: [] })],
+            }));
+        }
+    });
+    // Card rows: LibreOffice sizes rows by natural font metrics, inflating cards. Force an
+    // exact row height = the tallest item's tight content height so cards match the browser.
+    const maxContentHeight = Math.max(0, ...items.map((it) => it.contentHeightTwips ?? 0));
+    const rowOptions = maxContentHeight > 0
+        ? { children: cells, height: { value: maxContentHeight, rule: HeightRule.EXACT } }
+        : { children: cells };
+    const inner = new Table({
+        width: { size: totalWidth, type: WidthType.DXA },
+        columnWidths,
+        layout: "fixed",
+        borders: borderlessTableBorders(),
+        rows: [new TableRow(rowOptions)],
+    });
+    return wrapInnerTable(inner, containerLayout);
+}
+function containerPaddingMargins(layout) {
+    return {
+        top: layout.paddingTop ?? 0,
+        bottom: layout.paddingBottom ?? 0,
+        left: layout.paddingLeft ?? 0,
+        right: layout.paddingRight ?? 0,
+    };
+}
+function wrapInnerTable(inner, containerLayout) {
+    const needsWrapper = Boolean(containerLayout.shading?.fill) ||
+        Boolean(containerLayout.paddingTop ||
+            containerLayout.paddingBottom ||
+            containerLayout.paddingLeft ||
+            containerLayout.paddingRight);
+    if (!needsWrapper)
+        return inner;
+    const padLayout = containerLayout.shading
+        ? layoutForNativeShadedBlock(containerLayout)
+        : containerLayout;
+    return new Table({
+        width: { size: PRINTABLE_CONTENT_WIDTH_TWIPS, type: WidthType.DXA },
+        columnWidths: [PRINTABLE_CONTENT_WIDTH_TWIPS],
+        layout: "fixed",
+        borders: borderlessTableBorders(),
+        rows: [
+            new TableRow({
+                children: [
+                    new TableCell({
+                        width: { size: PRINTABLE_CONTENT_WIDTH_TWIPS, type: WidthType.DXA },
+                        shading: containerLayout.shading
+                            ? { type: ShadingType.CLEAR, ...containerLayout.shading }
+                            : undefined,
+                        margins: containerPaddingMargins(padLayout),
+                        children: [inner],
+                    }),
+                ],
+            }),
+        ],
+    });
+}
+/**
+ * Unshaded spacer row of exact `gapTwips` height — renders the flex `gap` as a band of
+ * the container's own fill (nested cells without shading are transparent, so the wrapper
+ * cell's background shows through). Gap-as-cell-margin does NOT work: cell margins are
+ * painted with the cell's shading, which visually fuses adjacent shaded items.
+ */
+function gapSpacerRow(widthTwips, gapTwips) {
+    return new TableRow({
+        height: { value: gapTwips, rule: HeightRule.EXACT },
+        children: [
+            new TableCell({
+                width: { size: widthTwips, type: WidthType.DXA },
+                margins: { top: 0, bottom: 0, left: 0, right: 0 },
+                children: [
+                    new Paragraph({
+                        spacing: { before: 0, after: 0, line: gapTwips, lineRule: LineRuleType.EXACT },
+                        children: [],
+                    }),
+                ],
+            }),
+        ],
+    });
+}
+/** Vertical flex → multi-row borderless table; gap via unshaded exact-height spacer rows. */
+export function makeFlexColumnTable(items, gap, containerLayout) {
+    const gapTwips = gap ?? 0;
+    // The inner table sits inside the wrapper cell, inset by the container's padding —
+    // sizing it to the full printable width would overflow the wrapper to the page edge.
+    const innerWidth = Math.max(0, PRINTABLE_CONTENT_WIDTH_TWIPS -
+        (containerLayout.paddingLeft ?? 0) -
+        (containerLayout.paddingRight ?? 0));
+    const rows = [];
+    items.forEach((item, index) => {
+        if (index > 0 && gapTwips > 0) {
+            rows.push(gapSpacerRow(innerWidth, gapTwips));
+        }
+        rows.push(new TableRow({
+            children: [
+                new TableCell({
+                    width: { size: innerWidth, type: WidthType.DXA },
+                    shading: item.layout.shading
+                        ? { type: ShadingType.CLEAR, ...item.layout.shading }
+                        : undefined,
+                    margins: {
+                        top: item.layout.paddingTop ?? 0,
+                        bottom: item.layout.paddingBottom ?? 0,
+                        left: item.layout.paddingLeft ?? 0,
+                        right: item.layout.paddingRight ?? 0,
+                    },
+                    children: item.blocks.length > 0 ? item.blocks : [new Paragraph({ children: [] })],
+                }),
+            ],
+        }));
+    });
+    const inner = new Table({
+        width: { size: innerWidth, type: WidthType.DXA },
+        columnWidths: [innerWidth],
+        layout: "fixed",
+        borders: borderlessTableBorders(),
+        rows,
+    });
+    return wrapInnerTable(inner, containerLayout);
+}
+//# sourceMappingURL=flex.js.map

package/dist/converter/flex.js.map

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

package/dist/converter/image.d.ts

@@ -0,0 +1,38 @@
+import { ImageRun } from "docx";
+import type { CheerioAPI } from "cheerio";
+import type { Element } from "domhandler";
+type ImageType = "png" | "jpg" | "gif" | "bmp";
+/** Raw image bytes a caller's {@link ImageResolver} returns for a non-`data:` `src`. */
+export interface ResolvedImage {
+    /** Encoded image bytes (not base64 — the raw file contents). */
+    readonly data: Uint8Array | ArrayBuffer;
+    readonly type: ImageType;
+    /** Optional intrinsic size (px); used only when the `<img>` omits width/height. */
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * Caller-supplied hook to resolve non-`data:` `<img src>` (e.g. `http(s):` / `file:`).
+ * The library never fetches on its own — the caller owns the network/filesystem access
+ * and its security policy (host allowlist, SSRF/private-IP blocking, auth, size caps).
+ * Return `null` to skip an image (it falls back to alt text).
+ */
+export type ImageResolver = (src: string) => Promise<ResolvedImage | null> | ResolvedImage | null;
+/** Encode a resolved image as a `data:` URL so the sync conversion path handles it uniformly. */
+export declare function resolvedImageToDataUrl(resolved: ResolvedImage): string;
+/**
+ * Pre-resolution pass (run before the synchronous tree walk): for every `<img>` whose
+ * `src` is not already a `data:` URL, ask the caller's resolver for bytes and, if given,
+ * rewrite `src` to an inline `data:` URL. Unresolved images keep their `src` and fall
+ * back to alt text. Resolver errors are swallowed per-image (never abort the conversion).
+ */
+export declare function applyImageResolver($: CheerioAPI, resolver: ImageResolver): Promise<void>;
+/**
+ * Build a docx `ImageRun` from an `<img>` element. Supports base64 `data:` raster
+ * URLs (png/jpg/gif/bmp). Display size comes from `width`/`height` attributes,
+ * falling back to the image's natural size (aspect-preserved if only one is given).
+ * Returns null for unsupported sources (e.g. remote URLs) — caller drops to alt text.
+ */
+export declare function imageRunFromElement(element: Element): ImageRun | null;
+export {};
+//# sourceMappingURL=image.d.ts.map

package/dist/converter/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/converter/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,KAAK,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAiB/C,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC;AAmB1D,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAEtE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,CAAC,EAAE,UAAU,EACb,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAgED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CA0BrE"}

package/dist/converter/image.js

@@ -0,0 +1,159 @@
+import { ImageRun } from "docx";
+const MIME_TO_TYPE = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/jpg": "jpg",
+    "image/gif": "gif",
+    "image/bmp": "bmp",
+};
+const TYPE_TO_MIME = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    gif: "image/gif",
+    bmp: "image/bmp",
+};
+function toBase64(data) {
+    const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);
+    if (typeof Buffer !== "undefined")
+        return Buffer.from(bytes).toString("base64");
+    // Browser-safe fallback.
+    let binary = "";
+    for (let i = 0; i < bytes.length; i++)
+        binary += String.fromCharCode(bytes[i]);
+    return btoa(binary);
+}
+function decodeBase64(base64) {
+    if (typeof Buffer !== "undefined")
+        return new Uint8Array(Buffer.from(base64, "base64"));
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+/** Encode a resolved image as a `data:` URL so the sync conversion path handles it uniformly. */
+export function resolvedImageToDataUrl(resolved) {
+    return `data:${TYPE_TO_MIME[resolved.type]};base64,${toBase64(resolved.data)}`;
+}
+/**
+ * Pre-resolution pass (run before the synchronous tree walk): for every `<img>` whose
+ * `src` is not already a `data:` URL, ask the caller's resolver for bytes and, if given,
+ * rewrite `src` to an inline `data:` URL. Unresolved images keep their `src` and fall
+ * back to alt text. Resolver errors are swallowed per-image (never abort the conversion).
+ */
+export async function applyImageResolver($, resolver) {
+    const targets = $("img")
+        .toArray()
+        .filter((el) => {
+        const src = el.attribs?.src;
+        return typeof src === "string" && src.length > 0 && !/^data:/i.test(src);
+    });
+    await Promise.all(targets.map(async (el) => {
+        try {
+            const resolved = await resolver(el.attribs.src);
+            if (!resolved)
+                return;
+            el.attribs.src = resolvedImageToDataUrl(resolved);
+            if (resolved.width && !el.attribs.width)
+                el.attribs.width = String(resolved.width);
+            if (resolved.height && !el.attribs.height)
+                el.attribs.height = String(resolved.height);
+        }
+        catch {
+            // Leave src untouched → alt-text fallback. The caller's resolver owns errors.
+        }
+    }));
+}
+/** Parse a `data:<mime>;base64,<payload>` URL into raw bytes + docx image type. */
+function parseDataUrl(src) {
+    const match = /^data:([^;,]+)?(;base64)?,(.*)$/is.exec(src.trim());
+    if (!match)
+        return null;
+    const mime = (match[1] ?? "image/png").toLowerCase();
+    const isBase64 = Boolean(match[2]);
+    const type = MIME_TO_TYPE[mime];
+    if (!type || !isBase64)
+        return null; // only base64 raster data URLs for now
+    try {
+        return { type, data: decodeBase64(match[3]) };
+    }
+    catch {
+        return null;
+    }
+}
+/** Natural pixel dimensions from a decoded raster header (PNG / GIF / BMP / JPEG). */
+function naturalSize(type, data) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    try {
+        if (type === "png" && data.length >= 24) {
+            // IHDR width/height are big-endian uint32 at byte 16 / 20.
+            return { w: view.getUint32(16), h: view.getUint32(20) };
+        }
+        if (type === "gif" && data.length >= 10) {
+            // Logical screen width/height are little-endian uint16 at byte 6 / 8.
+            return { w: view.getUint16(6, true), h: view.getUint16(8, true) };
+        }
+        if (type === "bmp" && data.length >= 26) {
+            return { w: view.getInt32(18, true), h: Math.abs(view.getInt32(22, true)) };
+        }
+        if (type === "jpg") {
+            // Scan SOF markers for frame dimensions.
+            let off = 2;
+            while (off + 9 < data.length) {
+                if (view.getUint8(off) !== 0xff) {
+                    off++;
+                    continue;
+                }
+                const marker = view.getUint8(off + 1);
+                if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+                    return { h: view.getUint16(off + 5), w: view.getUint16(off + 7) };
+                }
+                off += 2 + view.getUint16(off + 2);
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function attrPx(value) {
+    if (!value)
+        return undefined;
+    const n = parseFloat(value);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+/**
+ * Build a docx `ImageRun` from an `<img>` element. Supports base64 `data:` raster
+ * URLs (png/jpg/gif/bmp). Display size comes from `width`/`height` attributes,
+ * falling back to the image's natural size (aspect-preserved if only one is given).
+ * Returns null for unsupported sources (e.g. remote URLs) — caller drops to alt text.
+ */
+export function imageRunFromElement(element) {
+    const src = element.attribs?.src;
+    if (!src)
+        return null;
+    const decoded = parseDataUrl(src);
+    if (!decoded)
+        return null;
+    const natural = naturalSize(decoded.type, decoded.data);
+    let width = attrPx(element.attribs?.width);
+    let height = attrPx(element.attribs?.height);
+    if (width && !height)
+        height = natural ? Math.round((width / natural.w) * natural.h) : width;
+    else if (height && !width)
+        width = natural ? Math.round((height / natural.h) * natural.w) : height;
+    else if (!width && !height) {
+        width = natural?.w ?? 200;
+        height = natural?.h ?? 150;
+    }
+    return new ImageRun({
+        type: decoded.type,
+        data: decoded.data,
+        transformation: { width: width, height: height },
+        altText: element.attribs?.alt
+            ? { title: element.attribs.alt, description: element.attribs.alt, name: element.attribs.alt }
+            : undefined,
+    });
+}
+//# sourceMappingURL=image.js.map

package/dist/converter/image.js.map

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

package/dist/converter/inline.d.ts

@@ -0,0 +1,18 @@
+import { type ParagraphChild } from "docx";
+import type { AnyNode, Element } from "domhandler";
+import { isBlockElement, typographyFromBlockElement } from "./css.js";
+import type { StyleResolver } from "./style-resolver.js";
+import type { RunTypography } from "./types.js";
+export declare function typographyToTextRunOptions(style: RunTypography, defaultSize?: number): Record<string, unknown>;
+interface InlineRunState {
+    leadingTextDone: boolean;
+    needsSpaceBeforeNext: boolean;
+    /** After `<br>` — trim HTML source indentation on the next line. */
+    afterLineBreak: boolean;
+}
+export declare function collectInlineRunsFromNodes(childNodes: AnyNode[], inherited?: RunTypography, state?: InlineRunState, styleResolver?: StyleResolver, defaultSize?: number): ParagraphChild[];
+export declare function hasDirectBlockChild(element: Element, styleResolver?: StyleResolver): boolean;
+export declare function getDirectBlockChildren(element: Element, styleResolver?: StyleResolver): Element[];
+export declare function getInlineOrTextNodes(element: Element, styleResolver?: StyleResolver): AnyNode[];
+export { isBlockElement, typographyFromBlockElement };
+//# sourceMappingURL=inline.d.ts.map

package/dist/converter/inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/converter/inline.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAEL,cAAc,EAGd,0BAA0B,EAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,YAAY,CAAC;AAsC7D,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,WAAW,GAAE,MAA8B,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB;AA6BD,UAAU,cAAc;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;CACzB;AAsBD,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,OAAO,EAAE,EACrB,SAAS,GAAE,aAAkB,EAC7B,KAAK,GAAE,cAA+F,EACtG,aAAa,GAAE,aAAqC,EACpD,WAAW,GAAE,MAA8B,GAC1C,cAAc,EAAE,CAwGlB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,aAAqC,GACnD,OAAO,CAET;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,aAAqC,GACnD,OAAO,EAAE,CAIX;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,aAAqC,GACnD,OAAO,EAAE,CAMX;AAED,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC"}