@jsonpdf/plugins 0.1.0-alpha.1

package/dist/container/container-plugin.d.ts

@@ -0,0 +1,15 @@
+import type { JSONSchema } from '@jsonpdf/core';
+import type { Plugin } from '../types.js';
+export interface ContainerProps {
+    /** Layout mode for child elements. */
+    layout: 'horizontal' | 'vertical' | 'absolute' | 'grid';
+    /** Spacing between children in points (horizontal, vertical, grid). Default 0. */
+    gap?: number;
+    /** Number of columns for grid layout. Default 2. */
+    gridColumns?: number;
+    /** Cross-axis alignment for horizontal/vertical/grid layouts. */
+    alignItems?: 'start' | 'center' | 'end';
+}
+export declare const containerPropsSchema: JSONSchema;
+export declare const containerPlugin: Plugin<ContainerProps>;
+//# sourceMappingURL=container-plugin.d.ts.map

package/dist/container/container-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-plugin.d.ts","sourceRoot":"","sources":["../../src/container/container-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAmB,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACxD,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CACzC;AAED,eAAO,MAAM,oBAAoB,EAAE,UAUlC,CAAC;AA4JF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,CA+FlD,CAAC"}

package/dist/container/container-plugin.js

@@ -0,0 +1,190 @@
+export const containerPropsSchema = {
+    type: 'object',
+    required: ['layout'],
+    additionalProperties: false,
+    properties: {
+        layout: { type: 'string', enum: ['horizontal', 'vertical', 'absolute', 'grid'] },
+        gap: { type: 'number', minimum: 0 },
+        gridColumns: { type: 'integer', minimum: 1 },
+        alignItems: { type: 'string', enum: ['start', 'center', 'end'] },
+    },
+};
+const DEFAULTS = {
+    layout: 'absolute',
+    gap: 0,
+    gridColumns: 2,
+    alignItems: 'start',
+};
+async function measureChildren(children, measureChild) {
+    const entries = await Promise.all(children.map(async (child) => [child.id, await measureChild(child)]));
+    return new Map(entries);
+}
+function computeAbsoluteLayout(children, sizes) {
+    const layouts = [];
+    let maxRight = 0;
+    let maxBottom = 0;
+    for (const child of children) {
+        layouts.push({ element: child, offsetX: child.x, offsetY: child.y });
+        const size = sizes.get(child.id);
+        const childHeight = size ? size.height : child.height;
+        maxRight = Math.max(maxRight, child.x + child.width);
+        maxBottom = Math.max(maxBottom, child.y + childHeight);
+    }
+    return { layouts, totalWidth: maxRight, totalHeight: maxBottom };
+}
+function computeHorizontalLayout(children, sizes, gap, alignItems, containerHeight) {
+    const layouts = [];
+    let cursorX = 0;
+    let maxHeight = 0;
+    for (const child of children) {
+        const size = sizes.get(child.id);
+        const childHeight = size ? size.height : child.height;
+        maxHeight = Math.max(maxHeight, childHeight);
+    }
+    for (const child of children) {
+        const size = sizes.get(child.id);
+        const childHeight = size ? size.height : child.height;
+        const offsetY = alignOffset(alignItems, containerHeight, childHeight);
+        layouts.push({ element: child, offsetX: cursorX, offsetY });
+        cursorX += child.width + gap;
+    }
+    const totalWidth = children.length > 0 ? cursorX - gap : 0;
+    return { layouts, totalWidth, totalHeight: maxHeight };
+}
+function computeVerticalLayout(children, sizes, gap, alignItems, containerWidth) {
+    const layouts = [];
+    let cursorY = 0;
+    let maxWidth = 0;
+    for (const child of children) {
+        maxWidth = Math.max(maxWidth, child.width);
+    }
+    for (const child of children) {
+        const size = sizes.get(child.id);
+        const childHeight = size ? size.height : child.height;
+        const offsetX = alignOffset(alignItems, containerWidth, child.width);
+        layouts.push({ element: child, offsetX, offsetY: cursorY });
+        cursorY += childHeight + gap;
+    }
+    const totalHeight = children.length > 0 ? cursorY - gap : 0;
+    return { layouts, totalWidth: maxWidth, totalHeight };
+}
+function computeGridLayout(children, sizes, gap, gridColumns, alignItems, containerWidth) {
+    const layouts = [];
+    const colWidth = (containerWidth - gap * (gridColumns - 1)) / gridColumns;
+    // Compute row heights
+    const rowCount = Math.ceil(children.length / gridColumns);
+    const rowHeights = [];
+    for (let row = 0; row < rowCount; row++) {
+        let maxH = 0;
+        for (let col = 0; col < gridColumns; col++) {
+            const idx = row * gridColumns + col;
+            if (idx >= children.length)
+                break;
+            const child = children[idx];
+            const size = sizes.get(child.id);
+            const childHeight = size ? size.height : child.height;
+            maxH = Math.max(maxH, childHeight);
+        }
+        rowHeights.push(maxH);
+    }
+    let cursorY = 0;
+    for (let row = 0; row < rowCount; row++) {
+        for (let col = 0; col < gridColumns; col++) {
+            const idx = row * gridColumns + col;
+            if (idx >= children.length)
+                break;
+            const child = children[idx];
+            const size = sizes.get(child.id);
+            const childHeight = size ? size.height : child.height;
+            const offsetX = col * (colWidth + gap);
+            const offsetY = cursorY + alignOffset(alignItems, rowHeights[row], childHeight);
+            layouts.push({ element: child, offsetX, offsetY });
+        }
+        cursorY += rowHeights[row] + gap;
+    }
+    const totalHeight = rowCount > 0 ? cursorY - gap : 0;
+    return { layouts, totalWidth: containerWidth, totalHeight };
+}
+function alignOffset(alignItems, available, size) {
+    switch (alignItems) {
+        case 'center':
+            return (available - size) / 2;
+        case 'end':
+            return available - size;
+        default:
+            return 0;
+    }
+}
+export const containerPlugin = {
+    type: 'container',
+    propsSchema: containerPropsSchema,
+    defaultProps: DEFAULTS,
+    resolveProps(raw) {
+        return { ...DEFAULTS, ...raw };
+    },
+    validate(props) {
+        const errors = [];
+        if (props.layout === 'grid' && props.gridColumns !== undefined && props.gridColumns < 1) {
+            errors.push({ path: '/gridColumns', message: 'must be at least 1' });
+        }
+        return errors;
+    },
+    async measure(props, ctx) {
+        const children = ctx.children ?? [];
+        if (children.length === 0) {
+            return { width: ctx.availableWidth, height: ctx.availableHeight };
+        }
+        if (!ctx.measureChild) {
+            return { width: ctx.availableWidth, height: ctx.availableHeight };
+        }
+        const sizes = await measureChildren(children, ctx.measureChild);
+        const gap = props.gap ?? 0;
+        const align = props.alignItems ?? 'start';
+        let result;
+        switch (props.layout) {
+            case 'absolute':
+                result = computeAbsoluteLayout(children, sizes);
+                break;
+            case 'horizontal':
+                result = computeHorizontalLayout(children, sizes, gap, align, ctx.availableHeight);
+                break;
+            case 'vertical':
+                result = computeVerticalLayout(children, sizes, gap, align, ctx.availableWidth);
+                break;
+            case 'grid':
+                result = computeGridLayout(children, sizes, gap, props.gridColumns ?? 2, align, ctx.availableWidth);
+                break;
+        }
+        return { width: result.totalWidth, height: result.totalHeight };
+    },
+    async render(props, ctx) {
+        const children = ctx.children ?? [];
+        if (children.length === 0 || !ctx.renderChild)
+            return;
+        if (!ctx.measureChild) {
+            throw new Error('Container plugin requires measureChild callback');
+        }
+        const sizes = await measureChildren(children, ctx.measureChild);
+        const gap = props.gap ?? 0;
+        const align = props.alignItems ?? 'start';
+        let layouts;
+        switch (props.layout) {
+            case 'absolute':
+                layouts = computeAbsoluteLayout(children, sizes).layouts;
+                break;
+            case 'horizontal':
+                layouts = computeHorizontalLayout(children, sizes, gap, align, ctx.height).layouts;
+                break;
+            case 'vertical':
+                layouts = computeVerticalLayout(children, sizes, gap, align, ctx.width).layouts;
+                break;
+            case 'grid':
+                layouts = computeGridLayout(children, sizes, gap, props.gridColumns ?? 2, align, ctx.width).layouts;
+                break;
+        }
+        for (const layout of layouts) {
+            await ctx.renderChild(layout.element, layout.offsetX, layout.offsetY);
+        }
+    },
+};
+//# sourceMappingURL=container-plugin.js.map

package/dist/container/container-plugin.js.map

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

package/dist/frame/frame-plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '../types.js';
+import { type FrameProps } from './frame-types.js';
+export declare const framePlugin: Plugin<FrameProps>;
+//# sourceMappingURL=frame-plugin.d.ts.map

package/dist/frame/frame-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-plugin.d.ts","sourceRoot":"","sources":["../../src/frame/frame-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,KAAK,UAAU,EAAoC,MAAM,kBAAkB,CAAC;AAErF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,CA4D1C,CAAC"}

package/dist/frame/frame-plugin.js

@@ -0,0 +1,52 @@
+import { framePropsSchema, FRAME_DEFAULTS } from './frame-types.js';
+export const framePlugin = {
+    type: 'frame',
+    propsSchema: framePropsSchema,
+    defaultProps: FRAME_DEFAULTS,
+    resolveProps(raw) {
+        return { ...FRAME_DEFAULTS, ...raw };
+    },
+    validate(props) {
+        const errors = [];
+        const bands = props.bands;
+        if (!Array.isArray(bands)) {
+            errors.push({ path: '/bands', message: 'bands is required and must be an array' });
+            return errors;
+        }
+        if (bands.length === 0) {
+            errors.push({ path: '/bands', message: 'bands must not be empty' });
+            return errors;
+        }
+        for (let i = 0; i < bands.length; i++) {
+            const band = bands[i];
+            const prefix = `/bands/${String(i)}`;
+            if (!band.id) {
+                errors.push({ path: `${prefix}/id`, message: 'band must have an id' });
+            }
+            if (!band.type) {
+                errors.push({ path: `${prefix}/type`, message: 'band must have a type' });
+            }
+            if (!Array.isArray(band.elements)) {
+                errors.push({ path: `${prefix}/elements`, message: 'band must have an elements array' });
+            }
+        }
+        return errors;
+    },
+    async measure(props, ctx) {
+        if (props.bands.length === 0) {
+            return { width: 0, height: 0 };
+        }
+        if (!ctx.measureBands) {
+            return { width: ctx.availableWidth, height: ctx.availableHeight };
+        }
+        const { totalHeight } = await ctx.measureBands(props.bands);
+        return { width: ctx.availableWidth, height: totalHeight };
+    },
+    async render(props, ctx) {
+        if (props.bands.length === 0 || !ctx.renderBands) {
+            return;
+        }
+        await ctx.renderBands(props.bands);
+    },
+};
+//# sourceMappingURL=frame-plugin.js.map

package/dist/frame/frame-plugin.js.map

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

package/dist/frame/frame-types.d.ts

@@ -0,0 +1,8 @@
+import type { Band, JSONSchema } from '@jsonpdf/core';
+export interface FrameProps {
+    /** Nested bands to expand and render within the frame. */
+    bands: Band[];
+}
+export declare const framePropsSchema: JSONSchema;
+export declare const FRAME_DEFAULTS: FrameProps;
+//# sourceMappingURL=frame-types.d.ts.map

package/dist/frame/frame-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-types.d.ts","sourceRoot":"","sources":["../../src/frame/frame-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,eAAO,MAAM,gBAAgB,EAAE,UAc9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,UAA0B,CAAC"}

package/dist/frame/frame-types.js

@@ -0,0 +1,17 @@
+export const framePropsSchema = {
+    type: 'object',
+    required: ['bands'],
+    additionalProperties: false,
+    properties: {
+        bands: {
+            type: 'array',
+            minItems: 1,
+            items: {
+                type: 'object',
+                required: ['id', 'type', 'height', 'elements'],
+            },
+        },
+    },
+};
+export const FRAME_DEFAULTS = { bands: [] };
+//# sourceMappingURL=frame-types.js.map

package/dist/frame/frame-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-types.js","sourceRoot":"","sources":["../../src/frame/frame-types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;aAC/C;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC"}

package/dist/image/image-loader.d.ts

@@ -0,0 +1,13 @@
+import type { ImageCache } from '../types.js';
+export type ImageFormat = 'png' | 'jpeg';
+export interface LoadedImage {
+    bytes: Uint8Array;
+    format: ImageFormat;
+}
+/** Detect image format from the first few bytes. */
+export declare function detectFormat(bytes: Uint8Array): ImageFormat;
+/** Load image bytes from a data URI. */
+export declare function loadImageBytes(src: string): LoadedImage;
+/** Create an image cache that deduplicates loads. */
+export declare function createImageCache(): ImageCache;
+//# sourceMappingURL=image-loader.d.ts.map

package/dist/image/image-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-loader.d.ts","sourceRoot":"","sources":["../../src/image/image-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAU3D;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAoCvD;AAaD,qDAAqD;AACrD,wBAAgB,gBAAgB,IAAI,UAAU,CAe7C"}

package/dist/image/image-loader.js

@@ -0,0 +1,73 @@
+import { isSvgBytes, rasterizeSvg } from './svg-rasterizer.js';
+/** Detect image format from the first few bytes. */
+export function detectFormat(bytes) {
+    // PNG: starts with \x89PNG
+    if (bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47) {
+        return 'png';
+    }
+    // JPEG: starts with \xFF\xD8
+    if (bytes[0] === 0xff && bytes[1] === 0xd8) {
+        return 'jpeg';
+    }
+    throw new Error('Unsupported image format: expected PNG or JPEG');
+}
+/** Load image bytes from a data URI. */
+export function loadImageBytes(src) {
+    let bytes;
+    let isSvgDataUri = false;
+    if (src.startsWith('data:')) {
+        const commaIdx = src.indexOf(',');
+        if (commaIdx === -1) {
+            throw new Error(`Invalid data URI: ${src.slice(0, 50)}`);
+        }
+        const header = src.slice(0, commaIdx).toLowerCase();
+        isSvgDataUri = header.includes('image/svg+xml');
+        if (header.includes(';base64')) {
+            // Base64-encoded data URI (PNG, JPEG, or SVG)
+            const base64 = src.slice(commaIdx + 1);
+            bytes = Uint8Array.from(atob(base64), (c) => c.charCodeAt(0));
+        }
+        else {
+            // URL-encoded data URI (common for SVG)
+            const decoded = decodeURIComponent(src.slice(commaIdx + 1));
+            bytes = new TextEncoder().encode(decoded);
+        }
+    }
+    else {
+        throw new Error(`Unsupported image source: "${src.slice(0, 80)}". Use a data URI (base64 or URL-encoded).`);
+    }
+    // SVG: rasterize to PNG before embedding
+    if (isSvgDataUri || isSvgBytes(bytes)) {
+        const svgString = new TextDecoder().decode(bytes);
+        const { pngBytes } = rasterizeSvg(svgString);
+        return { bytes: pngBytes, format: 'png' };
+    }
+    const format = detectFormat(bytes);
+    return { bytes, format };
+}
+/** Embed an image into a PDF document. */
+async function embedImage(doc, loaded) {
+    const image = loaded.format === 'png' ? await doc.embedPng(loaded.bytes) : await doc.embedJpg(loaded.bytes);
+    return {
+        image,
+        width: image.width,
+        height: image.height,
+    };
+}
+/** Create an image cache that deduplicates loads. */
+export function createImageCache() {
+    const cache = new Map();
+    return {
+        async getOrEmbed(src, doc) {
+            let promise = cache.get(src);
+            if (!promise) {
+                promise = embedImage(doc, loadImageBytes(src));
+                // Remove from cache on failure so retries can succeed
+                promise.catch(() => cache.delete(src));
+                cache.set(src, promise);
+            }
+            return promise;
+        },
+    };
+}
+//# sourceMappingURL=image-loader.js.map

package/dist/image/image-loader.js.map

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

package/dist/image/image-plugin.d.ts

@@ -0,0 +1,19 @@
+import type { JSONSchema } from '@jsonpdf/core';
+import type { Plugin } from '../types.js';
+export interface ImageProps {
+    src: string;
+    fit?: 'contain' | 'cover' | 'fill' | 'none';
+}
+export declare const imagePropsSchema: JSONSchema;
+/**
+ * Compute the draw dimensions and offset for an image within an element.
+ * Returns { drawWidth, drawHeight, offsetX, offsetY } in element-local coordinates.
+ */
+export declare function computeFitDimensions(imgWidth: number, imgHeight: number, elemWidth: number, elemHeight: number, fit: 'contain' | 'cover' | 'fill' | 'none'): {
+    drawWidth: number;
+    drawHeight: number;
+    offsetX: number;
+    offsetY: number;
+};
+export declare const imagePlugin: Plugin<ImageProps>;
+//# sourceMappingURL=image-plugin.d.ts.map

package/dist/image/image-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-plugin.d.ts","sourceRoot":"","sources":["../../src/image/image-plugin.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAgD,MAAM,aAAa,CAAC;AAExF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED,eAAO,MAAM,gBAAgB,EAAE,UAO9B,CAAC;AAIF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GACzC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmC7E;AAoBD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,CAiF1C,CAAC"}

package/dist/image/image-plugin.js

@@ -0,0 +1,112 @@
+import { pushGraphicsState, popGraphicsState, moveTo, lineTo, closePath, clip, endPath, } from 'pdf-lib';
+export const imagePropsSchema = {
+    type: 'object',
+    required: ['src'],
+    properties: {
+        src: { type: 'string', minLength: 1, pattern: '^data:' },
+        fit: { type: 'string', enum: ['contain', 'cover', 'fill', 'none'] },
+    },
+};
+const IMAGE_DEFAULTS = { src: '', fit: 'contain' };
+/**
+ * Compute the draw dimensions and offset for an image within an element.
+ * Returns { drawWidth, drawHeight, offsetX, offsetY } in element-local coordinates.
+ */
+export function computeFitDimensions(imgWidth, imgHeight, elemWidth, elemHeight, fit) {
+    // Guard against degenerate (zero-dimension) images
+    if (imgWidth <= 0 || imgHeight <= 0) {
+        return { drawWidth: 0, drawHeight: 0, offsetX: 0, offsetY: 0 };
+    }
+    switch (fit) {
+        case 'fill':
+            return { drawWidth: elemWidth, drawHeight: elemHeight, offsetX: 0, offsetY: 0 };
+        case 'none': {
+            const offsetX = (elemWidth - imgWidth) / 2;
+            const offsetY = (elemHeight - imgHeight) / 2;
+            return { drawWidth: imgWidth, drawHeight: imgHeight, offsetX, offsetY };
+        }
+        case 'cover': {
+            const scale = Math.max(elemWidth / imgWidth, elemHeight / imgHeight);
+            const drawWidth = imgWidth * scale;
+            const drawHeight = imgHeight * scale;
+            const offsetX = (elemWidth - drawWidth) / 2;
+            const offsetY = (elemHeight - drawHeight) / 2;
+            return { drawWidth, drawHeight, offsetX, offsetY };
+        }
+        case 'contain':
+        default: {
+            const scale = Math.min(elemWidth / imgWidth, elemHeight / imgHeight);
+            const drawWidth = imgWidth * scale;
+            const drawHeight = imgHeight * scale;
+            const offsetX = (elemWidth - drawWidth) / 2;
+            const offsetY = (elemHeight - drawHeight) / 2;
+            return { drawWidth, drawHeight, offsetX, offsetY };
+        }
+    }
+}
+async function getImage(src, ctx) {
+    return ctx.imageCache.getOrEmbed(src, ctx.pdfDoc);
+}
+/** Apply a clipping rectangle to the current page graphics state. */
+function clipToElementBounds(ctx) {
+    ctx.page.pushOperators(pushGraphicsState(), moveTo(ctx.x, ctx.y), lineTo(ctx.x + ctx.width, ctx.y), lineTo(ctx.x + ctx.width, ctx.y - ctx.height), lineTo(ctx.x, ctx.y - ctx.height), closePath(), clip(), endPath());
+}
+export const imagePlugin = {
+    type: 'image',
+    propsSchema: imagePropsSchema,
+    defaultProps: IMAGE_DEFAULTS,
+    resolveProps(raw) {
+        return { ...IMAGE_DEFAULTS, ...raw };
+    },
+    validate(props) {
+        const errors = [];
+        if (!props.src || typeof props.src !== 'string' || props.src.trim().length === 0) {
+            errors.push({ path: '/src', message: 'src is required and must be a non-empty string' });
+        }
+        else if (!props.src.startsWith('data:')) {
+            errors.push({
+                path: '/src',
+                message: 'src must be a data URI (e.g. data:image/png;base64,... or data:image/svg+xml,...)',
+            });
+        }
+        if (props.fit !== undefined && !['contain', 'cover', 'fill', 'none'].includes(props.fit)) {
+            errors.push({ path: '/fit', message: 'fit must be contain, cover, fill, or none' });
+        }
+        return errors;
+    },
+    async measure(props, ctx) {
+        const embedded = await getImage(props.src, ctx);
+        const fit = props.fit ?? 'contain';
+        const { drawWidth, drawHeight } = computeFitDimensions(embedded.width, embedded.height, ctx.availableWidth, ctx.availableHeight, fit);
+        if (fit === 'none') {
+            return { width: drawWidth, height: drawHeight };
+        }
+        return { width: ctx.availableWidth, height: ctx.availableHeight };
+    },
+    async render(props, ctx) {
+        const embedded = await getImage(props.src, ctx);
+        const fit = props.fit ?? 'contain';
+        const { drawWidth, drawHeight, offsetX, offsetY } = computeFitDimensions(embedded.width, embedded.height, ctx.width, ctx.height, fit);
+        // pdf-lib drawImage: x,y is the bottom-left corner of the image.
+        // ctx.x, ctx.y is the top-left of content area in pdf-lib coords (y up).
+        // offsetY is the distance from the top of the element to the top of the image (top-down).
+        const imgX = ctx.x + offsetX;
+        const imgY = ctx.y - offsetY - drawHeight;
+        // Clip to element bounds for modes that can overflow (cover, none)
+        const needsClip = fit === 'cover' || fit === 'none';
+        if (needsClip) {
+            clipToElementBounds(ctx);
+        }
+        ctx.page.drawImage(embedded.image, {
+            x: imgX,
+            y: imgY,
+            width: drawWidth,
+            height: drawHeight,
+            opacity: ctx.opacity,
+        });
+        if (needsClip) {
+            ctx.page.pushOperators(popGraphicsState());
+        }
+    },
+};
+//# sourceMappingURL=image-plugin.js.map

package/dist/image/image-plugin.js.map

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

package/dist/image/svg-rasterizer.d.ts

@@ -0,0 +1,30 @@
+/** Default scale factor for SVG rasterization (2x for HiDPI). */
+export declare const DEFAULT_SVG_SCALE = 2;
+/**
+ * Check if raw bytes look like SVG content.
+ * Examines the first 1024 bytes (after BOM/whitespace) for `<svg` or `<?xml`.
+ */
+export declare function isSvgBytes(bytes: Uint8Array): boolean;
+/**
+ * Parse intrinsic dimensions from an SVG string.
+ * Uses regex to extract width/height attributes or viewBox from the `<svg>` tag.
+ * Falls back to 300×150 (HTML spec default for replaced elements).
+ */
+export declare function parseSvgDimensions(svg: string): {
+    width: number;
+    height: number;
+};
+/**
+ * Rasterize an SVG string to PNG bytes using @resvg/resvg-js.
+ *
+ * @param svg  SVG markup string
+ * @param scale  Scale factor (default {@link DEFAULT_SVG_SCALE}).
+ *               The SVG intrinsic dimensions are multiplied by this value.
+ * @returns PNG bytes and intrinsic (pre-scale) dimensions for aspect ratio calculations.
+ */
+export declare function rasterizeSvg(svg: string, scale?: number): {
+    pngBytes: Uint8Array;
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=svg-rasterizer.d.ts.map

package/dist/image/svg-rasterizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-rasterizer.d.ts","sourceRoot":"","sources":["../../src/image/svg-rasterizer.ts"],"names":[],"mappings":"AAUA,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAWrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoCjF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,MAA0B,GAChC;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgCzD"}