docx-kit 0.2.0 → 0.3.0

package/dist/compileDocument-DIFdjo67.mjs

@@ -1,1051 +0,0 @@
-import { n as dataUrlToUint8Array, t as createImageRun } from "./image-CdfLh9GO.mjs";
-import { t as DocxKitError } from "./errors-c9CC63Ti.mjs";
-import { AlignmentType, BorderStyle, Document, ExternalHyperlink, Footer, Header, HeadingLevel, HighlightColor, LevelFormat, PageBreak, Paragraph, ShadingType, Table, TableCell, TableRow, TextRun, VerticalAlign, WidthType } from "docx";
-//#region src/style/normalizeStyle.ts
-/**
-* Style normalization — merge multiple style sources into one resolved rule.
-*
-* Implements the CSS-like cascade:
-* `defaults → className(s) → inline style`
-*
-* @module style/normalizeStyle
-*/
-/**
-* Merge styles in priority order (lowest → highest):
-* `base` → `className`(s) → `inline style`.
-*
-* - `base` — Typically a default style for the element type
-* - `className` — Single string, space-separated string, or array of class names
-* - `inline` — Inline style override on the node itself
-* - `styles` — The stylesheet map to resolve class names against
-*
-* @returns A new merged `DocxStyleRule` (does not mutate inputs).
-*
-* @example
-* ```ts
-* const resolved = resolveStyle({
-*   base:      { fontSize: 12 },
-*   className: ['body', 'blue'],
-*   inline:    { fontWeight: 'bold' },
-*   styles:    { body: { lineHeight: 1.5 }, blue: { color: '#00f' } },
-* })
-* // => { fontSize: 12, lineHeight: 1.5, color: '#00f', fontWeight: 'bold' }
-* ```
-*/
-function resolveStyle(options) {
-	const classStyles = (Array.isArray(options.className) ? options.className : options.className ? options.className.split(/\s+/).filter(Boolean) : []).map((name) => {
-		const rule = options.styles?.[name];
-		if (options.styles != null && rule == null) throw new DocxKitError("STYLE_UNKNOWN_CLASS", `Style class not found: "${name}"`);
-		return rule;
-	}).filter((s) => s != null);
-	return Object.assign({}, options.base, ...classStyles, options.inline);
-}
-//#endregion
-//#region src/compiler/units.ts
-/**
-* Word OpenXML unit conversion utilities.
-*
-* All bare numbers are interpreted according to the property they represent:
-* - `fontSize` (toPtHalf) → **pt**
-* - spacing / indent / margin (toTwip) → **pt**
-* - image size (toPx) → **px**
-*
-* @module compiler/units
-*/
-/**
-* Points per inch — standard typographic convention.
-*
-* All other conversions derive from this and the DPI assumption.
-*/
-const POINTS_PER_INCH = 72;
-/**
-* Pixels per inch at 96 DPI (standard screen resolution).
-*/
-const PIXELS_PER_INCH = 96;
-/**
-* Pixels per point at 96 DPI.
-*
-* 96 px/in ÷ 72 pt/in = 4/3 ≈ 1.333 px/pt.
-*/
-const PX_PER_POINT = PIXELS_PER_INCH / POINTS_PER_INCH;
-/**
-* Points per pixel at 96 DPI.
-*
-* 72 pt/in ÷ 96 px/in = 0.75 pt/px.
-*/
-const POINTS_PER_PX = POINTS_PER_INCH / PIXELS_PER_INCH;
-/**
-* Points per millimeter.
-*
-* 72 pt/in ÷ 25.4 mm/in ≈ 2.835 pt/mm.
-*/
-const POINTS_PER_MM = POINTS_PER_INCH / 25.4;
-/**
-* Points per centimeter.
-*
-* POINTS_PER_MM × 10.
-*/
-const POINTS_PER_CM = POINTS_PER_MM * 10;
-/**
-* Twips per point — the fundamental Word OpenXML spacing unit.
-*
-* 1 twip = 1/20 of a point. All margins, indents, and spacing
-* values in Word are expressed in twips.
-*/
-const TWIPS_PER_POINT = 20;
-/**
-* Twips per pixel at 96 DPI.
-*
-* POINTS_PER_PX × TWIPS_PER_POINT = 0.75 × 20 = 15.
-*/
-const TWIPS_PER_PX = POINTS_PER_PX * TWIPS_PER_POINT;
-/**
-* Half-points per point (used for font sizes in Word OpenXML).
-*
-* Word stores font sizes in half-points: 12pt → 24 half-points.
-*/
-const HALF_POINTS_PER_POINT = 2;
-/**
-* Half-points per pixel at 96 DPI.
-*
-* POINTS_PER_PX × HALF_POINTS_PER_POINT = 0.75 × 2 = 1.5.
-*/
-const HALF_POINTS_PER_PX = POINTS_PER_PX * HALF_POINTS_PER_POINT;
-/**
-* Parse a CSS margin/padding shorthand string into top/right/bottom/left
-* values expressed in **twips** (1/20 pt).
-*
-* Supports 1-value, 2-value, and 4-value shorthand.
-*
-* @param value - — Single number, unit string, or CSS shorthand
-* @returns `{ top, right, bottom, left }` values in twips, or `undefined`
-*
-* @example
-* ```ts
-* parseShorthandTwip('10pt 20pt')
-* // => { top: 200, right: 400, bottom: 200, left: 400 }
-*
-* parseShorthandTwip('5pt 10pt 15pt 20pt')
-* // => { top: 100, right: 200, bottom: 300, left: 400 }
-* ```
-*/
-function parseShorthandTwip(value) {
-	if (value == null) return;
-	const parts = String(value).trim().split(/\s+/);
-	if (parts.length === 1) {
-		const v = toTwip(parts[0]) ?? 0;
-		return {
-			bottom: v,
-			left: v,
-			right: v,
-			top: v
-		};
-	}
-	if (parts.length === 2) {
-		const [tb, lr] = parts.map((p) => toTwip(p) ?? 0);
-		return {
-			bottom: tb,
-			left: lr,
-			right: lr,
-			top: tb
-		};
-	}
-	if (parts.length === 4) {
-		const [top, right, bottom, left] = parts.map((p) => toTwip(p) ?? 0);
-		return {
-			bottom,
-			left,
-			right,
-			top
-		};
-	}
-}
-/**
-* Convert a font-size value to Word **half-points** (used by the `docx`
-* library's `size` field on text runs).
-*
-* Bare number is treated as **pt** (e.g. `12` → 24 half-points).
-*
-* @param value - — Number (pt) or unit string (`"12pt"`, `"16px"`, `"4mm"`, etc.)
-* @returns Half-point integer, or `undefined` if input is null/undefined
-*
-* @example
-* ```ts
-* toPtHalf(12)        // 24   (12pt × 2)
-* toPtHalf('14pt')    // 28
-* toPtHalf('16px')    // 24   (16px ≈ 12pt)
-* ```
-*/
-function toPtHalf(value) {
-	if (value == null) return;
-	if (typeof value === "number") return Math.round(value * HALF_POINTS_PER_POINT);
-	const n = Number.parseFloat(value);
-	if (value.endsWith("pt")) return Math.round(n * HALF_POINTS_PER_POINT);
-	if (value.endsWith("px")) return Math.round(n * HALF_POINTS_PER_PX);
-	if (value.endsWith("mm")) return Math.round(n * POINTS_PER_MM * HALF_POINTS_PER_POINT);
-	if (value.endsWith("cm")) return Math.round(n * POINTS_PER_CM * HALF_POINTS_PER_POINT);
-	if (value.endsWith("in")) return Math.round(n * POINTS_PER_INCH * HALF_POINTS_PER_POINT);
-	return Math.round(n * HALF_POINTS_PER_POINT);
-}
-/**
-* Convert a length value to **pixels** (used for image dimensions).
-*
-* Bare number is treated as **px**.
-*
-* @param value - — Number (px) or unit string (`"100px"`, `"72pt"`, `"5cm"`, etc.)
-* @returns Pixel integer, or `undefined` if input is null/undefined
-*
-* @example
-* ```ts
-* toPx(200)          // 200
-* toPx('150px')      // 150
-* toPx('72pt')       // 96   (72pt × 1.333)
-* ```
-*/
-function toPx(value) {
-	if (value == null) return;
-	if (typeof value === "number") return value;
-	const n = Number.parseFloat(value);
-	if (value.endsWith("px")) return n;
-	if (value.endsWith("pt")) return Math.round(n * PX_PER_POINT);
-	if (value.endsWith("mm")) return Math.round(n * POINTS_PER_MM * PX_PER_POINT);
-	if (value.endsWith("cm")) return Math.round(n * POINTS_PER_CM * PX_PER_POINT);
-	if (value.endsWith("in")) return Math.round(n * PIXELS_PER_INCH);
-	return n;
-}
-/**
-* Convert a length value to **twips** (1/20 of a point).
-*
-* Used for spacing, indent, and margin values in Word OpenXML.
-* Bare number is treated as **pt**.
-*
-* @param value - — Number (pt) or unit string (`"10pt"`, `"12px"`, `"5mm"`, etc.)
-* @returns Twip integer, or `undefined` if input is null/undefined
-*
-* @example
-* ```ts
-* toTwip(12)         // 240  (12pt × 20)
-* toTwip('1in')      // 1440 (1 inch × 1440)
-* toTwip('10mm')     // 567  (10mm × 56.7)
-* ```
-*/
-function toTwip(value) {
-	if (value == null) return;
-	if (typeof value === "number") return Math.round(value * TWIPS_PER_POINT);
-	const n = Number.parseFloat(value);
-	if (value.endsWith("pt")) return Math.round(n * TWIPS_PER_POINT);
-	if (value.endsWith("px")) return Math.round(n * TWIPS_PER_PX);
-	if (value.endsWith("mm")) return Math.round(n * POINTS_PER_MM * TWIPS_PER_POINT);
-	if (value.endsWith("cm")) return Math.round(n * POINTS_PER_CM * TWIPS_PER_POINT);
-	if (value.endsWith("in")) return Math.round(n * POINTS_PER_INCH * TWIPS_PER_POINT);
-	return Math.round(n * TWIPS_PER_POINT);
-}
-//#endregion
-//#region src/compiler/compileStyle.ts
-/**
-* Style compiler — maps `DocxStyleRule` (CSS-like) → `docx` constructor options.
-*
-* Each exported function converts one aspect of a style rule into the shape
-* expected by the underlying `docx` library.
-*
-* @module compiler/compileStyle
-*/
-/**
-* Compile all border properties from a `DocxStyleRule`.
-*
-* Returns `undefined` if no borders are specified.
-*
-* @param style - — The resolved style rule
-* @returns Border options for `docx` or `undefined`
-*
-* @example
-* ```ts
-* compileBorder({ border: { style: 'single', color: '#333', width: '1pt' } })
-* // => { top: {...}, right: {...}, bottom: {...}, left: {...} }
-* ```
-*/
-function compileBorder(style) {
-	const b = style.border;
-	const bt = style.borderTop ?? b;
-	const br = style.borderRight ?? b;
-	const bb = style.borderBottom ?? b;
-	const bl = style.borderLeft ?? b;
-	if (!bt && !br && !bb && !bl) return;
-	return {
-		bottom: bb ? compileSingleBorder(bb) : void 0,
-		left: bl ? compileSingleBorder(bl) : void 0,
-		right: br ? compileSingleBorder(br) : void 0,
-		top: bt ? compileSingleBorder(bt) : void 0
-	};
-}
-/**
-* Compile a `DocxStyleRule` into `docx` table cell options
-* (vertical alignment, margins, shading).
-*
-* Applies sensible default cell padding (5 pt left/right, 2 pt top/bottom)
-* when no margins are explicitly set.
-*
-* @param style - — The resolved style rule
-* @returns Options object suitable for `new TableCell(...)`
-*
-* @example
-* ```ts
-* compileCellStyle({ verticalAlign: 'middle', backgroundColor: '#f0f0f0' })
-* // => { verticalAlign: VerticalAlign.CENTER, shading: { fill: 'f0f0f0', ... } }
-* ```
-*/
-function compileCellStyle(style) {
-	const shorthand = style.margin == null ? void 0 : parseShorthandTwip(style.margin);
-	const bottom = toTwip(style.marginBottom) ?? shorthand?.bottom;
-	const left = toTwip(style.marginLeft) ?? shorthand?.left;
-	const right = toTwip(style.marginRight) ?? shorthand?.right;
-	const top = toTwip(style.marginTop) ?? shorthand?.top;
-	const hasAnyMargin = bottom != null || left != null || right != null || top != null;
-	return {
-		verticalAlign: compileVerticalAlign(style.verticalAlign),
-		margins: hasAnyMargin ? {
-			bottom: bottom ?? 0,
-			left: left ?? 0,
-			right: right ?? 0,
-			top: top ?? 0
-		} : {
-			bottom: 0,
-			left: 100,
-			right: 100,
-			top: 0
-		},
-		shading: style.backgroundColor == null ? void 0 : {
-			fill: normalizeColor(style.backgroundColor),
-			type: ShadingType.CLEAR
-		}
-	};
-}
-/**
-* Compile a column width value.
-*
-* If the value is a percentage string (e.g. `"30%"`), returns
-* a percentage width config. Otherwise returns `undefined`.
-*
-* @param width - — Column width value
-* @returns Width config or `undefined`
-*
-* @example
-* ```ts
-* compileColumnWidth('25%')
-* // => { size: 25, type: WidthType.PERCENTAGE }
-* ```
-*/
-function compileColumnWidth(width) {
-	if (typeof width === "string" && width.endsWith("%")) return {
-		size: Number.parseFloat(width),
-		type: WidthType.PERCENTAGE
-	};
-}
-/** Compile paragraph-level borders (separate from cell borders). */
-function compileParagraphBorder(style) {
-	const borders = compileBorder(style);
-	if (!borders) return {};
-	return { border: borders };
-}
-/**
-* Compile a `DocxStyleRule` into `docx` paragraph-level options
-* (alignment, indent, spacing).
-*
-* @param style - — The resolved style rule
-* @returns Options object suitable for `new Paragraph(...)`
-*
-* @example
-* ```ts
-* compileParagraphStyle({ textAlign: 'center', marginTop: '10pt' })
-* // => { alignment: AlignmentType.CENTER, spacing: { before: 200, ... } }
-* ```
-*/
-function compileParagraphStyle(style) {
-	const spacing = resolveSpacing(style);
-	const indent = resolveIndent(style);
-	return {
-		alignment: compileAlignment(style.textAlign),
-		...compileParagraphBorder(style),
-		indent,
-		keepLines: style.keepLines,
-		keepNext: style.keepNext,
-		pageBreakBefore: style.pageBreakBefore,
-		spacing
-	};
-}
-/**
-* Compile a `DocxStyleRule` into `docx` run-level options
-* (font, color, size, bold, italic, underline, etc.).
-*
-* Also merges any passthrough properties from `style.docx`.
-*
-* @param style - — The resolved style rule
-* @returns Options object suitable for `new TextRun(...)`
-*
-* @example
-* ```ts
-* compileTextStyle({ fontSize: 14, fontWeight: 'bold', color: '#ff0000' })
-* // => { size: 28, bold: true, color: 'ff0000' }
-* ```
-*/
-function compileTextStyle(style) {
-	const result = {
-		allCaps: style.allCaps,
-		bold: style.fontWeight === "bold" || Number(style.fontWeight) >= 600,
-		characterSpacing: style.characterSpacing,
-		color: normalizeColor(style.color),
-		font: style.fontFamily,
-		highlight: compileHighlight(style.highlight),
-		italics: style.fontStyle === "italic",
-		size: toPtHalf(style.fontSize),
-		smallCaps: style.smallCaps,
-		strike: style.strike,
-		subScript: style.subScript,
-		superScript: style.superScript,
-		underline: style.underline ? {} : void 0
-	};
-	if (style.docx) Object.assign(result, style.docx);
-	return result;
-}
-/**
-* Map the CSS-like text-align value to a `docx` `AlignmentType`.
-*/
-function compileAlignment(value) {
-	if (value === "center") return AlignmentType.CENTER;
-	if (value === "right") return AlignmentType.RIGHT;
-	if (value === "justify") return AlignmentType.JUSTIFIED;
-	return AlignmentType.LEFT;
-}
-/**
-* Map a CSS-like border-style string to a `docx` `BorderStyle` enum value.
-*/
-function compileBorderStyle(style) {
-	if (style === "dashed") return BorderStyle.DASHED;
-	if (style === "dotted") return BorderStyle.DOTTED;
-	if (style === "double") return BorderStyle.DOUBLE;
-	if (style === "none") return BorderStyle.NONE;
-	return BorderStyle.SINGLE;
-}
-/**
-* Map a highlight color name to `docx` `HighlightColor`.
-*/
-function compileHighlight(color) {
-	if (!color || color === "none") return;
-	return HighlightColor[color.toUpperCase()];
-}
-/** Convert line-height multiplier to twips. 1 → 240 (single-spacing). */
-function compileLineHeight(value) {
-	if (typeof value === "number") return Math.round(value * 240);
-	return toTwip(value);
-}
-/**
-* Compile a single border side into `docx` border options.
-*/
-function compileSingleBorder(rule) {
-	return {
-		color: normalizeColor(rule.color),
-		size: rule.width == null ? 1 : toTwip(rule.width),
-		style: compileBorderStyle(rule.style)
-	};
-}
-/**
-* Map the CSS-like vertical-align to a `docx` `VerticalAlign` enum value.
-*/
-function compileVerticalAlign(value) {
-	if (value === "middle") return VerticalAlign.CENTER;
-	if (value === "bottom") return VerticalAlign.BOTTOM;
-	return VerticalAlign.TOP;
-}
-/** Strip leading `#` from a color string (docx expects raw hex). */
-function normalizeColor(color) {
-	return color?.replace(/^#/, "");
-}
-/**
-* Resolve paragraph indent from a `DocxStyleRule`.
-*
-* Handles margin shorthand, explicit left/right margin, and text-indent.
-*/
-function resolveIndent(style) {
-	const shorthand = style.margin == null ? void 0 : parseShorthandTwip(style.margin);
-	const left = toTwip(style.marginLeft) ?? shorthand?.left;
-	const right = toTwip(style.marginRight) ?? shorthand?.right;
-	const firstLine = toTwip(style.textIndent);
-	if (left == null && right == null && firstLine == null) return;
-	return {
-		firstLine,
-		left,
-		right
-	};
-}
-/**
-* Resolve paragraph spacing from a `DocxStyleRule`.
-*
-* Handles margin shorthand for top/bottom spacing and line height.
-*/
-function resolveSpacing(style) {
-	const shorthand = style.margin == null ? void 0 : parseShorthandTwip(style.margin);
-	const before = toTwip(style.marginTop) ?? shorthand?.top;
-	const after = toTwip(style.marginBottom) ?? shorthand?.bottom;
-	const line = compileLineHeight(style.lineHeight);
-	if (before == null && after == null && line == null) return;
-	return {
-		after,
-		before,
-		line
-	};
-}
-//#endregion
-//#region src/compiler/compileNode.ts
-/**
-* Node compiler — dispatches DSL nodes to `docx` objects.
-*
-* Each node type (heading, paragraph, image, table, pageBreak, plugin)
-* is compiled into the corresponding `docx` constructor.
-*
-* @module compiler/compileNode
-*/
-/** Map heading level numbers to `docx` `HeadingLevel` enum values. */
-const HEADING_MAP = {
-	1: HeadingLevel.HEADING_1,
-	2: HeadingLevel.HEADING_2,
-	3: HeadingLevel.HEADING_3,
-	4: HeadingLevel.HEADING_4,
-	5: HeadingLevel.HEADING_5,
-	6: HeadingLevel.HEADING_6
-};
-/**
-* Compile a single DSL node into its `docx` representation.
-*
-* Dispatches to the appropriate sub-compiler based on `node.type`.
-*
-* @param ctx - — Compilation context with config, node, and plugins
-* @returns A `docx` object (Paragraph, Table, etc.) or array of objects
-*
-* @example
-* ```ts
-* const para = await compileNode({
-*   config:  { styles: { p: { fontSize: 12 } } },
-*   node:    { type: 'paragraph', text: 'Hello', className: 'p' },
-*   plugins: new Map(),
-* })
-* ```
-*/
-async function compileNode(ctx) {
-	switch (ctx.node.type) {
-		case "bulletList": return compileBulletList(ctx.node, ctx.config);
-		case "heading": return compileHeading(ctx.node, ctx.config);
-		case "hyperlink": return compileHyperlink(ctx.node, ctx.config);
-		case "image": return compileImage(ctx.node, ctx.config);
-		case "numberedList": return compileNumberedList(ctx.node, ctx.config);
-		case "pageBreak": return new Paragraph({ children: [new PageBreak()] });
-		case "sectionBreak": throw new DocxKitError("UNKNOWN_NODE_TYPE", "Section break nodes must be handled at the document compilation level");
-		case "paragraph": return compileParagraph(ctx.node, ctx.config);
-		case "table": return compileTable(ctx.node, ctx.config);
-		case "plugin": {
-			const plugin = ctx.plugins.get(ctx.node.name);
-			if (!plugin) throw new DocxKitError("PLUGIN_NOT_REGISTERED", `Plugin not registered: ${ctx.node.name}`);
-			try {
-				return await plugin.render(ctx.node.options, createPluginContext(ctx));
-			} catch (err) {
-				throw new DocxKitError("PLUGIN_RENDER_FAILED", `Plugin render failed: ${plugin.name}`, err);
-			}
-		}
-		default: throw new DocxKitError("UNKNOWN_NODE_TYPE", `Unknown node type: ${ctx.node.type}`);
-	}
-}
-/**
-* Build floating layout options for `ImageRun`.
-*/
-function compileFloating(floating) {
-	if (!floating) return;
-	if (floating === true) return {};
-	return {
-		horizontalPosition: floating.x === void 0 ? void 0 : { offset: floating.x },
-		verticalPosition: floating.y === void 0 ? void 0 : { offset: floating.y }
-	};
-}
-/**
-* Compile a heading node into a `docx` Paragraph with heading level.
-*
-* Default class name is `h{level}` (e.g. `h1`, `h2`).
-*/
-function compileHeading(node, config) {
-	const style = resolveStyle({
-		className: node.className ?? `h${node.level}`,
-		inline: node.style,
-		styles: config.styles
-	});
-	return new Paragraph({
-		...compileParagraphStyle(style),
-		heading: HEADING_MAP[node.level],
-		children: [new TextRun({
-			text: node.text,
-			...compileTextStyle(style)
-		})]
-	});
-}
-/**
-* Compile a hyperlink node into an `ExternalHyperlink` containing `TextRun`s.
-*/
-function compileHyperlink(node, config) {
-	const style = resolveStyle({
-		className: node.className,
-		inline: node.style,
-		styles: config.styles
-	});
-	return new Paragraph({ children: [new ExternalHyperlink({
-		children: node.children.map((child) => {
-			if (typeof child === "string") return new TextRun({
-				text: child,
-				...compileTextStyle(style)
-			});
-			return new TextRun({
-				text: child.text,
-				...compileTextStyle(resolveStyle({
-					base: style,
-					className: child.className,
-					inline: child.style,
-					styles: config.styles
-				}))
-			});
-		}),
-		link: node.url
-	})] });
-}
-/**
-* Compile an image node into a `docx` Paragraph containing an `ImageRun`.
-*
-* Handles image data normalization (Blob → Uint8Array), auto format detection,
-* floating layout, and size transformations.
-*/
-async function compileImage(node, config) {
-	if (node.data == null || typeof node.data === "string" && node.data.length === 0) throw new DocxKitError("IMAGE_INVALID_DATA", "Image data is empty or null");
-	const data = await normalizeImageData(node.data);
-	const imageType = node.imageType ?? "png";
-	return new Paragraph({
-		...compileParagraphStyle(resolveStyle({
-			base: config.defaults?.image,
-			className: node.className,
-			inline: node.style,
-			styles: config.styles
-		})),
-		children: [createImageRun({
-			data,
-			floating: compileFloating(node.floating),
-			height: toPx(node.height),
-			type: imageType,
-			width: toPx(node.width)
-		})]
-	});
-}
-/**
-* Compile a paragraph node into a `docx` Paragraph.
-*
-* Supports plain text (`node.text`) or inline children (`node.children`).
-*/
-function compileParagraph(node, config) {
-	const style = resolveStyle({
-		base: config.defaults?.paragraph,
-		className: node.className ?? "p",
-		inline: node.style,
-		styles: config.styles
-	});
-	const children = node.children && node.children.length > 0 ? node.children.map((child) => child.type === "text" ? new TextRun({
-		text: child.text,
-		...compileTextStyle(resolveStyle({
-			base: style,
-			className: child.className,
-			inline: child.style,
-			styles: config.styles
-		}))
-	}) : (() => {
-		throw new DocxKitError("UNKNOWN_NODE_TYPE", `Inline image is not supported yet. Use top-level \`.image()\` instead.`);
-	})()) : [new TextRun({
-		text: node.text ?? "",
-		...compileTextStyle(style)
-	})];
-	return new Paragraph({
-		...compileParagraphStyle(style),
-		children
-	});
-}
-const numberingConfigMap = /* @__PURE__ */ new Map();
-let numberingCounter = 0;
-/** Reset numbering state between compilations. */
-function resetNumberingState() {
-	numberingConfigMap.clear();
-	numberingCounter = 0;
-}
-/**
-* Generate a numbering config entry for a bullet list
-* and return Paragraphs with numbering references.
-*/
-function compileBulletList(node, config) {
-	const ref = `bullet-${++numberingCounter}`;
-	const bullet = node.bullet ?? "•";
-	numberingConfigMap.set(ref, {
-		reference: ref,
-		levels: [{
-			alignment: AlignmentType.LEFT,
-			format: LevelFormat.BULLET,
-			level: node.level ?? 0,
-			text: bullet
-		}]
-	});
-	const style = resolveStyle({
-		className: node.className,
-		inline: node.style,
-		styles: config.styles
-	});
-	return node.items.map((item) => {
-		const text = typeof item === "string" ? item : item.text;
-		const itemStyle = typeof item === "object" ? resolveStyle({
-			base: style,
-			className: item.className,
-			inline: item.style,
-			styles: config.styles
-		}) : style;
-		return new Paragraph({
-			...compileParagraphStyle(itemStyle),
-			numbering: {
-				level: node.level ?? 0,
-				reference: ref
-			},
-			children: [new TextRun({
-				text,
-				...compileTextStyle(itemStyle)
-			})]
-		});
-	});
-}
-/**
-* Generate a numbering config entry for an ordered list
-* and return Paragraphs with numbering references.
-*/
-function compileNumberedList(node, config) {
-	const ref = `numbered-${++numberingCounter}`;
-	const formatMap = {
-		decimal: LevelFormat.DECIMAL,
-		lowerLetter: LevelFormat.LOWER_LETTER,
-		lowerRoman: LevelFormat.LOWER_ROMAN,
-		upperLetter: LevelFormat.UPPER_LETTER,
-		upperRoman: LevelFormat.UPPER_ROMAN
-	};
-	numberingConfigMap.set(ref, {
-		reference: ref,
-		levels: [{
-			alignment: AlignmentType.LEFT,
-			level: node.level ?? 0,
-			start: node.start ?? 1,
-			text: "%1.",
-			format: formatMap[node.numberingFormat ?? "decimal"] ?? LevelFormat.DECIMAL
-		}]
-	});
-	const style = resolveStyle({
-		className: node.className,
-		inline: node.style,
-		styles: config.styles
-	});
-	return node.items.map((item) => {
-		const text = typeof item === "string" ? item : item.text;
-		const itemStyle = typeof item === "object" ? resolveStyle({
-			base: style,
-			className: item.className,
-			inline: item.style,
-			styles: config.styles
-		}) : style;
-		return new Paragraph({
-			...compileParagraphStyle(itemStyle),
-			numbering: {
-				level: node.level ?? 0,
-				reference: ref
-			},
-			children: [new TextRun({
-				text,
-				...compileTextStyle(itemStyle)
-			})]
-		});
-	});
-}
-/**
-* Compile a table node into a `docx` Table.
-*
-* Generates header row (unless `header: false`) and data rows.
-* Supports custom cell renderers via `column.render`.
-*/
-function compileTable(node, _config) {
-	if (node.columns.length === 0) throw new DocxKitError("TABLE_INVALID_COLUMNS", "Table must have at least one column");
-	const rows = [];
-	if (node.header !== false) rows.push(new TableRow({
-		tableHeader: true,
-		children: node.columns.map((col) => new TableCell({
-			...compileCellStyle(node.headerCellStyle ?? {}),
-			children: [new Paragraph(String(col.title))],
-			...col.colSpan && col.colSpan > 1 ? { columnSpan: col.colSpan } : {},
-			width: compileColumnWidth(col.width)
-		}))
-	}));
-	rows.push(...node.data.map((row, rowIndex) => new TableRow({ children: node.columns.map((col) => {
-		const raw = row[col.key];
-		const rendered = col.render ? col.render(raw, row, rowIndex) : String(raw ?? "");
-		const cellColSpan = row[`_${col.key}_colSpan`] ?? col.colSpan;
-		const isEvenRow = rowIndex % 2 === 1;
-		const baseCellStyle = node.cellStyle ? { ...compileCellStyle(node.cellStyle) } : {};
-		return new TableCell({
-			...baseCellStyle,
-			...node.striped && isEvenRow && baseCellStyle.shading ? { shading: {
-				...baseCellStyle.shading,
-				fill: "F2F2F2"
-			} } : {},
-			children: [new Paragraph(String(rendered))],
-			...cellColSpan && cellColSpan > 1 ? { columnSpan: cellColSpan } : {},
-			width: compileColumnWidth(col.width)
-		});
-	}) })));
-	return new Table({
-		rows,
-		width: {
-			size: 100,
-			type: WidthType.PERCENTAGE
-		}
-	});
-}
-/**
-* Build a `PluginRenderContext` for plugin rendering.
-*
-* Provides access to config, image utilities, and the ability to
-* recursively compile child nodes.
-*/
-function createPluginContext(ctx) {
-	return {
-		config: ctx.config,
-		utils: { image: {
-			fromDataUrl: (dataUrl) => dataUrlToUint8Array(dataUrl),
-			fromBlob: async (blob) => new Uint8Array(await blob.arrayBuffer())
-		} },
-		compileNode: (node) => compileNode({
-			config: ctx.config,
-			node,
-			plugins: ctx.plugins
-		})
-	};
-}
-/**
-* Normalize image data to a form `ImageRun` accepts.
-*
-* Converts `Blob` → `Uint8Array` in browser environments.
-*/
-async function normalizeImageData(data) {
-	if (typeof Blob !== "undefined" && data instanceof Blob) return new Uint8Array(await data.arrayBuffer());
-	return data;
-}
-//#endregion
-//#region src/compiler/compileDocument.ts
-/**
-* Document compiler — assembles a `docx` `Document` from an array of DSL nodes.
-*
-* This is the top-level compilation entry point. It iterates over all block
-* nodes, compiles each one via {@link compileNode}, and wraps them in a
-* `Document` with page properties and metadata.
-*
-* Multi-section support: {@link SectionBreakNode} markers split content
-* into separate sections, each with its own page setup, headers, and footers.
-*
-* @module compiler/compileDocument
-*/
-/**
-* Compile an array of block nodes into a `docx` {@link Document} instance.
-*
-* This is the primary compilation pipeline — nodes flow through
-* `compileNode` → individual sub-compilers → `docx` objects → `Document`.
-*
-* If `SectionBreakNode` markers are present, content is split into
-* multiple sections, each with its own page setup, headers, and footers.
-*
-* @param options - — Compilation options with config, nodes, and plugins
-* @returns A `docx` `Document` ready for packaging
-*
-* @example
-* ```ts
-* const doc = await compileDocument({
-*   config: { page: { size: 'A4' } },
-*   nodes: [
-*     { type: 'heading', level: 1, text: 'Title' },
-*     { type: 'paragraph', text: 'Hello world' },
-*   ],
-*   plugins: new Map(),
-* })
-* ```
-*/
-async function compileDocument(options) {
-	resetNumberingState();
-	const sectionGroups = [{ nodes: [] }];
-	for (const node of options.nodes) if (node.type === "sectionBreak") sectionGroups.push({
-		config: node.config,
-		nodes: []
-	});
-	else sectionGroups[sectionGroups.length - 1].nodes.push(node);
-	const sections = [];
-	for (const [i, group] of sectionGroups.entries()) {
-		const children = [];
-		for (const node of group.nodes) {
-			const compiled = await compileNode({
-				config: options.config,
-				node,
-				plugins: options.plugins
-			});
-			if (Array.isArray(compiled)) children.push(...compiled);
-			else children.push(compiled);
-		}
-		const sectionConfig = group.config;
-		const pageConfig = i === 0 ? options.config : mergePageConfig(options.config, sectionConfig);
-		sections.push({
-			...compileSectionProperties(pageConfig),
-			children,
-			footers: compileFooters(i === 0 ? void 0 : sectionConfig?.footer, options.config),
-			headers: compileHeaders(i === 0 ? void 0 : sectionConfig?.header, options.config)
-		});
-	}
-	const numberingConfig = numberingConfigMap.size > 0 ? Array.from(numberingConfigMap.values()) : void 0;
-	return new Document({
-		creator: options.config.metadata?.creator,
-		description: options.config.metadata?.description,
-		keywords: options.config.metadata?.keywords?.join(", "),
-		lastModifiedBy: options.config.metadata?.lastModifiedBy,
-		subject: options.config.metadata?.subject,
-		title: options.config.metadata?.title,
-		...numberingConfig ? { numbering: { config: numberingConfig } } : {},
-		sections
-	});
-}
-/**
-* Compile section footers into `docx` `Footer` objects.
-*
-* @returns `{ default?, first?, even? }` or `undefined` if no footers defined
-*/
-function compileFooters(config, _docConfig) {
-	if (!config) return;
-	const result = {};
-	if (config.default) result.default = new Footer({ children: compileHeaderFooterChildren(config.default) });
-	if (config.first) result.first = new Footer({ children: compileHeaderFooterChildren(config.first) });
-	if (config.even) result.even = new Footer({ children: compileHeaderFooterChildren(config.even) });
-	return Object.keys(result).length > 0 ? result : void 0;
-}
-/**
-* Compile a `HeaderFooterContent` into a list of `docx` `Paragraph`s.
-*/
-function compileHeaderFooterChildren(content) {
-	return content.children.map((text) => new Paragraph(text));
-}
-/**
-* Compile section headers into `docx` `Header` objects.
-*
-* @returns `{ default?, first?, even? }` or `undefined` if no headers defined
-*/
-function compileHeaders(config, _docConfig) {
-	if (!config) return;
-	const result = {};
-	if (config.default) result.default = new Header({ children: compileHeaderFooterChildren(config.default) });
-	if (config.first) result.first = new Header({ children: compileHeaderFooterChildren(config.first) });
-	if (config.even) result.even = new Header({ children: compileHeaderFooterChildren(config.even) });
-	return Object.keys(result).length > 0 ? result : void 0;
-}
-/**
-* Compile a single page margin value (shorthand or explicit) into twips.
-*/
-function compilePageMargin(margin) {
-	if (!margin) return;
-	const parsed = parseShorthandTwip(margin);
-	if (!parsed) return;
-	return {
-		bottom: parsed.bottom,
-		left: parsed.left,
-		right: parsed.right,
-		top: parsed.top
-	};
-}
-/**
-* Build the section properties (page size, margin) for the `Document`.
-*/
-function compileSectionProperties(config) {
-	return { properties: { page: {
-		margin: compilePageMargin(config.page?.margin),
-		size: compilePageSize(config.page?.size, config.page?.orientation)
-	} } };
-}
-/**
-* Merge document-level page config with per-section overrides.
-*
-* Section config wins when both are specified; falls back to document
-* defaults for any property not set in the section.
-*/
-function mergePageConfig(docConfig, sectionConfig) {
-	if (!sectionConfig?.page) return docConfig;
-	return {
-		...docConfig,
-		page: {
-			...docConfig.page,
-			...sectionConfig.page
-		}
-	};
-}
-/**
-* Page size presets in twips (width × height).
-*
-* Values sourced from the OOXML specification.
-*/
-const PAGE_SIZE_PRESETS = {
-	/** A3: 297 × 420 mm */
-	A3: {
-		height: 23811,
-		width: 16838
-	},
-	/** A4: 210 × 297 mm */
-	A4: {
-		height: 16838,
-		width: 11906
-	},
-	/** US Legal: 8.5 × 14 in */
-	Legal: {
-		height: 20160,
-		width: 12240
-	},
-	/** US Letter: 8.5 × 11 in */
-	Letter: {
-		height: 15840,
-		width: 12240
-	}
-};
-/**
-* Compile page size into Word twips.
-*
-* Resolves presets (`"A4"`, `"Letter"`, etc.) or custom dimensions.
-* Swaps width/height when orientation is `"landscape"`.
-*/
-function compilePageSize(size, orientation) {
-	if (!size) return;
-	let width;
-	let height;
-	if (typeof size === "string") {
-		const preset = PAGE_SIZE_PRESETS[size];
-		if (preset) {
-			width = preset.width;
-			height = preset.height;
-		}
-	} else if (typeof size === "object" && size !== null) {
-		const s = size;
-		width = toTwip(s.width);
-		height = toTwip(s.height);
-	}
-	if (width == null || height == null) return;
-	if (orientation === "landscape") return {
-		height: width,
-		width: height
-	};
-	return {
-		height,
-		width
-	};
-}
-//#endregion
-export { compileDocument };