@jsonpdf/plugins 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JsonPDF
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @jsonpdf/plugins
+
+Element type implementations for the jsonpdf rendering pipeline. Each plugin provides `measure()` and `render()` methods for a specific visual element type.
+
+Plugins receive resolved values and never touch LiquidJS — expression resolution is handled upstream by the renderer.
+
+## Plugins
+
+| Plugin      | Description                                                                 |
+| ----------- | --------------------------------------------------------------------------- |
+| `text`      | Text rendering with word wrapping and decoration (underline, strikethrough) |
+| `line`      | Line drawing with configurable dash patterns                                |
+| `list`      | Bullet, numbered, and lettered lists                                        |
+| `shape`     | Rectangle, circle, ellipse, and rounded rectangle                           |
+| `image`     | Image rendering with fit modes (contain, cover, stretch, none)              |
+| `container` | Horizontal, vertical, absolute, and grid layouts                            |
+| `table`     | Table rendering with automatic column width calculation                     |
+| `barcode`   | Barcode and QR code generation via bwip-js                                  |
+| `chart`     | Chart rendering via Vega-Lite                                               |
+| `frame`     | Nested band container for sub-layouts                                       |
+
+## Platform abstraction
+
+The package uses Node.js subpath imports (`#platform/*`) to swap implementations between Node and browser environments:
+
+| Module                     | Node                       | Browser                                            |
+| -------------------------- | -------------------------- | -------------------------------------------------- |
+| `#platform/fs`             | Node `fs` for file reading | Throws (files must be inlined)                     |
+| `#platform/svg-rasterizer` | `@resvg/resvg-js` (native) | `@resvg/resvg-wasm`                                |
+| `#platform/init`           | No-op                      | Requires `initBrowser(resvgWasm)` before rendering |
+
+Browser consumers must call `initBrowser(resvgWasm)` once before rendering.
+
+## Usage
+
+```ts
+import { textPlugin, imagePlugin, PluginRegistry } from '@jsonpdf/plugins';
+
+// Plugins are registered automatically when imported
+// Use the registry to look up plugins by element type
+const plugin = PluginRegistry.get('text');
+```
+
+## Exports
+
+| Category  | Exports                                                                                       |
+| --------- | --------------------------------------------------------------------------------------------- |
+| Registry  | `PluginRegistry`, `registerPlugin`, `getPlugin`, `hasPlugin`, `getAllPlugins`, `clearPlugins` |
+| Text      | `textPlugin`, `wrapText`, `measureTextWidth`                                                  |
+| Line      | `linePlugin`                                                                                  |
+| List      | `listPlugin`, `ListItem`, `isListItem`, `toListItem`                                          |
+| Shape     | `shapePlugin`, `roundedRectPath`                                                              |
+| Image     | `imagePlugin`, `computeFitDimensions`, `createImageCache`, `loadImageBytes`, `rasterizeSvg`   |
+| Container | `containerPlugin`                                                                             |
+| Table     | `tablePlugin`, `TableColumn`, `computeColumnWidths`                                           |
+| Barcode   | `barcodePlugin`, `generateBarcode`, `createBarcodeCache`, `BarcodeFormat`                     |
+| Chart     | `chartPlugin`, `generateChart`, `createChartCache`, `buildFinalSpec`                          |
+| Frame     | `framePlugin`                                                                                 |
+| Platform  | `readFileBytes`, `uint8ArrayToBase64`, `initBrowser`                                          |

package/dist/barcode/barcode-generator.d.ts

@@ -0,0 +1,18 @@
+import type { BarcodeProps } from './barcode-types.js';
+/** Cache for generated barcode data URIs, keyed by deterministic option string. */
+export type BarcodeCache = Map<string, Promise<string>>;
+/** Create a new barcode cache instance. */
+export declare function createBarcodeCache(): BarcodeCache;
+/**
+ * Strip '#' from a hex color for bwip-js (expects hex without prefix).
+ * Handles both '#RGB' shorthand and '#RRGGBB'.
+ */
+export declare function toBwipColor(hex: string): string;
+/**
+ * Generate a barcode PNG and return it as a data URI string.
+ *
+ * Uses the provided cache to deduplicate calls with identical props
+ * (important because the two-pass renderer calls measure+render twice).
+ */
+export declare function generateBarcode(props: BarcodeProps, cache: BarcodeCache): Promise<string>;
+//# sourceMappingURL=barcode-generator.d.ts.map

package/dist/barcode/barcode-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-generator.d.ts","sourceRoot":"","sources":["../../src/barcode/barcode-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAExD,2CAA2C;AAC3C,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAiBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBzF"}

package/dist/barcode/barcode-generator.js

@@ -0,0 +1,94 @@
+import BwipJs from 'bwip-js';
+import { TWO_D_FORMATS } from './barcode-types.js';
+import { rasterizeSvg } from '../image/svg-rasterizer.js';
+import { uint8ArrayToBase64 } from '../platform/base64.js';
+/** Create a new barcode cache instance. */
+export function createBarcodeCache() {
+    return new Map();
+}
+/**
+ * Strip '#' from a hex color for bwip-js (expects hex without prefix).
+ * Handles both '#RGB' shorthand and '#RRGGBB'.
+ */
+export function toBwipColor(hex) {
+    const raw = hex.startsWith('#') ? hex.slice(1) : hex;
+    if (raw.length === 3) {
+        return raw[0] + raw[0] + raw[1] + raw[1] + raw[2] + raw[2];
+    }
+    return raw;
+}
+/** Build a deterministic cache key from barcode props. */
+function cacheKey(props) {
+    return JSON.stringify({
+        v: props.value,
+        f: props.format,
+        bc: props.barColor ?? '#000000',
+        bg: props.backgroundColor ?? '#FFFFFF',
+        it: props.includeText ?? false,
+        ts: props.textSize,
+        s: props.scale ?? 3,
+        mh: props.moduleHeight ?? 10,
+        p: props.padding ?? 2,
+    });
+}
+/**
+ * Generate a barcode PNG and return it as a data URI string.
+ *
+ * Uses the provided cache to deduplicate calls with identical props
+ * (important because the two-pass renderer calls measure+render twice).
+ */
+export function generateBarcode(props, cache) {
+    const key = cacheKey(props);
+    const existing = cache.get(key);
+    if (existing) {
+        return existing;
+    }
+    // Wrap in a Promise constructor so synchronous throws become rejections
+    // without creating a transiently unhandled rejected promise.
+    const promise = new Promise((resolve, reject) => {
+        try {
+            resolve(generateBarcodeUncached(props));
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // Remove from cache on failure so retries can succeed
+    promise.catch(() => cache.delete(key));
+    cache.set(key, promise);
+    return promise;
+}
+function generateBarcodeUncached(props) {
+    const options = {
+        bcid: props.format,
+        text: props.value,
+        scale: props.scale ?? 3,
+        paddingwidth: props.padding ?? 2,
+        paddingheight: props.padding ?? 2,
+        backgroundcolor: toBwipColor(props.backgroundColor ?? '#FFFFFF'),
+        barcolor: toBwipColor(props.barColor ?? '#000000'),
+    };
+    // Only set height for linear barcodes (not 2D codes)
+    if (!TWO_D_FORMATS.has(props.format)) {
+        options.height = props.moduleHeight ?? 10;
+    }
+    if (props.includeText) {
+        options.includetext = true;
+        options.textxalign = 'center';
+        if (props.textSize !== undefined) {
+            options.textsize = props.textSize;
+        }
+    }
+    let svgString;
+    try {
+        svgString = BwipJs.toSVG(options);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Barcode generation failed for format "${props.format}" with value "${props.value}": ${message}`);
+    }
+    const { pngBytes } = rasterizeSvg(svgString, 1);
+    const base64 = uint8ArrayToBase64(pngBytes);
+    return `data:image/png;base64,${base64}`;
+}
+//# sourceMappingURL=barcode-generator.js.map

package/dist/barcode/barcode-generator.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-plugin.d.ts","sourceRoot":"","sources":["../../src/barcode/barcode-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAgD,MAAM,aAAa,CAAC;AAExF,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAC;AAY5B,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,CAoF9C,CAAC"}

package/dist/barcode/barcode-plugin.js

@@ -0,0 +1,70 @@
+import { computeFitDimensions } from '../image/image-plugin.js';
+import { barcodePropsSchema, BARCODE_DEFAULTS, SUPPORTED_FORMATS, } from './barcode-types.js';
+import { generateBarcode, createBarcodeCache } from './barcode-generator.js';
+/** Module-level barcode cache shared across measure and render passes. */
+const barcodeCache = createBarcodeCache();
+/** Get the barcode as an embedded PDF image. */
+async function getBarcode(props, ctx) {
+    const dataUri = await generateBarcode(props, barcodeCache);
+    return ctx.imageCache.getOrEmbed(dataUri, ctx.pdfDoc);
+}
+export const barcodePlugin = {
+    type: 'barcode',
+    propsSchema: barcodePropsSchema,
+    defaultProps: BARCODE_DEFAULTS,
+    resolveProps(raw) {
+        return { ...BARCODE_DEFAULTS, ...raw };
+    },
+    validate(props) {
+        const errors = [];
+        if (!props.value || typeof props.value !== 'string' || props.value.trim().length === 0) {
+            errors.push({ path: '/value', message: 'value is required and must be a non-empty string' });
+        }
+        if (!SUPPORTED_FORMATS.includes(props.format)) {
+            errors.push({
+                path: '/format',
+                message: `format must be one of: ${SUPPORTED_FORMATS.join(', ')}`,
+            });
+        }
+        if (props.barColor !== undefined &&
+            typeof props.barColor === 'string' &&
+            !props.barColor.startsWith('#')) {
+            errors.push({ path: '/barColor', message: 'barColor must be a hex string starting with #' });
+        }
+        if (props.backgroundColor !== undefined &&
+            typeof props.backgroundColor === 'string' &&
+            !props.backgroundColor.startsWith('#')) {
+            errors.push({
+                path: '/backgroundColor',
+                message: 'backgroundColor must be a hex string starting with #',
+            });
+        }
+        return errors;
+    },
+    async measure(props, ctx) {
+        if (!props.value || props.value.trim().length === 0) {
+            return { width: 0, height: 0 };
+        }
+        await getBarcode(props, ctx);
+        return { width: ctx.availableWidth, height: ctx.availableHeight };
+    },
+    async render(props, ctx) {
+        if (!props.value || props.value.trim().length === 0) {
+            return;
+        }
+        const embedded = await getBarcode(props, ctx);
+        const { drawWidth, drawHeight, offsetX, offsetY } = computeFitDimensions(embedded.width, embedded.height, ctx.width, ctx.height, 'contain');
+        // pdf-lib drawImage: x,y is the bottom-left corner.
+        // ctx.x, ctx.y is the top-left of content area in pdf-lib coords (y up).
+        const imgX = ctx.x + offsetX;
+        const imgY = ctx.y - offsetY - drawHeight;
+        ctx.page.drawImage(embedded.image, {
+            x: imgX,
+            y: imgY,
+            width: drawWidth,
+            height: drawHeight,
+            opacity: ctx.opacity,
+        });
+    },
+};
+//# sourceMappingURL=barcode-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-plugin.js","sourceRoot":"","sources":["../../src/barcode/barcode-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAqB,MAAM,wBAAwB,CAAC;AAEhG,0EAA0E;AAC1E,MAAM,YAAY,GAAiB,kBAAkB,EAAE,CAAC;AAExD,gDAAgD;AAChD,KAAK,UAAU,UAAU,CAAC,KAAmB,EAAE,GAAmB;IAChE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAyB;IACjD,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,kBAAkB;IAC/B,YAAY,EAAE,gBAAgB;IAE9B,YAAY,CAAC,GAA4B;QACvC,OAAO,EAAE,GAAG,gBAAgB,EAAE,GAAG,GAAG,EAAkB,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,KAAmB;QAC1B,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,0BAA0B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAClE,CAAC,CAAC;QACL,CAAC;QAED,IACE,KAAK,CAAC,QAAQ,KAAK,SAAS;YAC5B,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAClC,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAC/B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,IACE,KAAK,CAAC,eAAe,KAAK,SAAS;YACnC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ;YACzC,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,EACtC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,sDAAsD;aAChE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAmB,EACnB,GAAmB;QAEnB,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAmB,EAAE,GAAkB;QAClD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,oBAAoB,CACtE,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,MAAM,EACf,GAAG,CAAC,KAAK,EACT,GAAG,CAAC,MAAM,EACV,SAAS,CACV,CAAC;QAEF,oDAAoD;QACpD,yEAAyE;QACzE,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;QAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,OAAO,GAAG,UAAU,CAAC;QAE1C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE;YACjC,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,IAAI;YACP,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { JSONSchema } from '@jsonpdf/core';
+/** Supported barcode/QR format identifiers (bwip-js bcid values). */
+export declare const SUPPORTED_FORMATS: readonly ["qrcode", "datamatrix", "pdf417", "azteccode", "azteccodecompact", "maxicode", "code128", "code39", "ean13", "ean8", "upca", "upce", "itf14", "codabar", "interleaved2of5", "code93", "isbn", "issn", "gs1-128"];
+export type BarcodeFormat = (typeof SUPPORTED_FORMATS)[number];
+export interface BarcodeProps {
+    /** Data to encode (required). */
+    value: string;
+    /** Barcode type — bwip-js bcid (required). */
+    format: BarcodeFormat;
+    /** Bar/module color as hex string. Default '#000000'. */
+    barColor?: string;
+    /** Background color as hex string. Default '#FFFFFF'. */
+    backgroundColor?: string;
+    /** Show human-readable text below linear barcodes. Default false. */
+    includeText?: boolean;
+    /** Font size for the human-readable text in points. */
+    textSize?: number;
+    /** Module scale factor. Default 3. Higher = larger PNG before fitting. */
+    scale?: number;
+    /** Bar height in mm for linear barcodes. Default 10. Ignored for 2D codes. */
+    moduleHeight?: number;
+    /** Quiet zone padding in modules. Default 2. */
+    padding?: number;
+}
+export declare const barcodePropsSchema: JSONSchema;
+export declare const BARCODE_DEFAULTS: BarcodeProps;
+/** Set of 2D barcode formats where moduleHeight does not apply. */
+export declare const TWO_D_FORMATS: ReadonlySet<string>;
+//# sourceMappingURL=barcode-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-types.d.ts","sourceRoot":"","sources":["../../src/barcode/barcode-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,4NAsBpB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB,EAAE,UAehC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YAS9B,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAO5C,CAAC"}

package/dist/barcode/barcode-types.js

@@ -0,0 +1,60 @@
+/** Supported barcode/QR format identifiers (bwip-js bcid values). */
+export const SUPPORTED_FORMATS = [
+    // 2D codes
+    'qrcode',
+    'datamatrix',
+    'pdf417',
+    'azteccode',
+    'azteccodecompact',
+    'maxicode',
+    // Linear codes
+    'code128',
+    'code39',
+    'ean13',
+    'ean8',
+    'upca',
+    'upce',
+    'itf14',
+    'codabar',
+    'interleaved2of5',
+    'code93',
+    'isbn',
+    'issn',
+    'gs1-128',
+];
+export const barcodePropsSchema = {
+    type: 'object',
+    required: ['value', 'format'],
+    additionalProperties: false,
+    properties: {
+        value: { type: 'string', minLength: 1 },
+        format: { type: 'string', enum: [...SUPPORTED_FORMATS] },
+        barColor: { type: 'string' },
+        backgroundColor: { type: 'string' },
+        includeText: { type: 'boolean' },
+        textSize: { type: 'number', minimum: 1 },
+        scale: { type: 'number', minimum: 1 },
+        moduleHeight: { type: 'number', minimum: 1 },
+        padding: { type: 'number', minimum: 0 },
+    },
+};
+export const BARCODE_DEFAULTS = {
+    value: '',
+    format: 'qrcode',
+    barColor: '#000000',
+    backgroundColor: '#FFFFFF',
+    includeText: false,
+    scale: 3,
+    moduleHeight: 10,
+    padding: 2,
+};
+/** Set of 2D barcode formats where moduleHeight does not apply. */
+export const TWO_D_FORMATS = new Set([
+    'qrcode',
+    'datamatrix',
+    'pdf417',
+    'azteccode',
+    'azteccodecompact',
+    'maxicode',
+]);
+//# sourceMappingURL=barcode-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-types.js","sourceRoot":"","sources":["../../src/barcode/barcode-types.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,UAAU;IACV,eAAe;IACf,SAAS;IACT,QAAQ;IACR,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,QAAQ;IACR,MAAM;IACN,MAAM;IACN,SAAS;CACD,CAAC;AAyBX,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC7B,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;QACvC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE;QACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAChC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QACxC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QACrC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QAC5C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;KACxC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,SAAS;IACnB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,EAAE;IAChB,OAAO,EAAE,CAAC;CACX,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IACxD,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,UAAU;CACX,CAAC,CAAC"}

package/dist/chart/chart-generator.d.ts

@@ -0,0 +1,17 @@
+import type { ChartProps } from './chart-types.js';
+/** Cache for generated chart PNG data URIs. */
+export type ChartCache = Map<string, Promise<string>>;
+/** Create a new chart cache instance. */
+export declare function createChartCache(): ChartCache;
+/**
+ * Build the final Vega-Lite spec by merging dataSource and background.
+ */
+export declare function buildFinalSpec(props: ChartProps): Record<string, unknown>;
+/**
+ * Generate a chart PNG data URI from a resolved Vega-Lite spec.
+ *
+ * Uses the provided cache to deduplicate calls with identical specs
+ * (important because the two-pass renderer calls measure+render twice).
+ */
+export declare function generateChart(props: ChartProps, cache: ChartCache): Promise<string>;
+//# sourceMappingURL=chart-generator.d.ts.map

package/dist/chart/chart-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-generator.d.ts","sourceRoot":"","sources":["../../src/chart/chart-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAEtD,yCAAyC;AACzC,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C;AAOD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAYnF"}

package/dist/chart/chart-generator.js

@@ -0,0 +1,77 @@
+import * as vl from 'vega-lite';
+import * as vega from 'vega';
+import { rasterizeSvg } from '../image/svg-rasterizer.js';
+import { uint8ArrayToBase64 } from '../platform/base64.js';
+/** Create a new chart cache instance. */
+export function createChartCache() {
+    return new Map();
+}
+/** Build a deterministic cache key from resolved spec + scale. */
+function cacheKey(spec, scale) {
+    return JSON.stringify({ s: spec, sc: scale });
+}
+/**
+ * Build the final Vega-Lite spec by merging dataSource and background.
+ */
+export function buildFinalSpec(props) {
+    let spec = { ...props.spec };
+    if (props.dataSource !== undefined) {
+        spec = { ...spec, data: { values: props.dataSource } };
+    }
+    if (props.background !== undefined) {
+        spec = { ...spec, background: props.background };
+    }
+    return spec;
+}
+/**
+ * Generate a chart PNG data URI from a resolved Vega-Lite spec.
+ *
+ * Uses the provided cache to deduplicate calls with identical specs
+ * (important because the two-pass renderer calls measure+render twice).
+ */
+export function generateChart(props, cache) {
+    const finalSpec = buildFinalSpec(props);
+    const scale = props.scale ?? 2;
+    const key = cacheKey(finalSpec, scale);
+    const existing = cache.get(key);
+    if (existing)
+        return existing;
+    const promise = generateChartUncached(finalSpec, scale);
+    promise.catch(() => cache.delete(key));
+    cache.set(key, promise);
+    return promise;
+}
+async function generateChartUncached(spec, scale) {
+    // Step 1: Compile Vega-Lite spec to Vega spec
+    let vegaSpec;
+    try {
+        const result = vl.compile(spec);
+        vegaSpec = result.spec;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Vega-Lite compilation failed: ${message}`);
+    }
+    // Step 2: Render Vega spec to SVG
+    let svgString;
+    const runtime = vega.parse(vegaSpec);
+    const view = new vega.View(runtime, { renderer: 'none' });
+    try {
+        view.initialize();
+        await view.runAsync();
+        svgString = await view.toSVG();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Vega chart rendering failed: ${message}`);
+    }
+    finally {
+        view.finalize();
+    }
+    // Step 3: Rasterize SVG to PNG
+    const { pngBytes } = rasterizeSvg(svgString, scale);
+    // Step 4: Convert to data URI
+    const base64 = uint8ArrayToBase64(pngBytes);
+    return `data:image/png;base64,${base64}`;
+}
+//# sourceMappingURL=chart-generator.js.map

package/dist/chart/chart-generator.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-plugin.d.ts","sourceRoot":"","sources":["../../src/chart/chart-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAgD,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,KAAK,UAAU,EAAoC,MAAM,kBAAkB,CAAC;AAYrF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,CA0E1C,CAAC"}

package/dist/chart/chart-plugin.js

@@ -0,0 +1,65 @@
+import { computeFitDimensions } from '../image/image-plugin.js';
+import { chartPropsSchema, CHART_DEFAULTS } from './chart-types.js';
+import { generateChart, createChartCache } from './chart-generator.js';
+/** Module-level chart cache shared across measure and render passes. */
+const chartCache = createChartCache();
+/** Get the chart as an embedded PDF image. */
+async function getChart(props, ctx) {
+    const dataUri = await generateChart(props, chartCache);
+    return ctx.imageCache.getOrEmbed(dataUri, ctx.pdfDoc);
+}
+export const chartPlugin = {
+    type: 'chart',
+    propsSchema: chartPropsSchema,
+    defaultProps: CHART_DEFAULTS,
+    resolveProps(raw) {
+        return { ...CHART_DEFAULTS, ...raw };
+    },
+    validate(props) {
+        const errors = [];
+        const spec = props.spec;
+        if (!spec || typeof spec !== 'object' || Array.isArray(spec)) {
+            errors.push({ path: '/spec', message: 'spec is required and must be a non-empty object' });
+        }
+        else if (Object.keys(props.spec).length === 0) {
+            errors.push({ path: '/spec', message: 'spec must not be empty' });
+        }
+        if (props.dataSource !== undefined && !Array.isArray(props.dataSource)) {
+            errors.push({ path: '/dataSource', message: 'dataSource must be an array' });
+        }
+        if (props.fit !== undefined && !['contain', 'cover', 'fill', 'none'].includes(props.fit)) {
+            errors.push({ path: '/fit', message: 'fit must be contain, cover, fill, or none' });
+        }
+        if (props.scale !== undefined && (typeof props.scale !== 'number' || props.scale < 0.5)) {
+            errors.push({ path: '/scale', message: 'scale must be a number >= 0.5' });
+        }
+        return errors;
+    },
+    async measure(props, ctx) {
+        if (Object.keys(props.spec).length === 0) {
+            return { width: 0, height: 0 };
+        }
+        await getChart(props, ctx);
+        return { width: ctx.availableWidth, height: ctx.availableHeight };
+    },
+    async render(props, ctx) {
+        if (Object.keys(props.spec).length === 0) {
+            return;
+        }
+        const embedded = await getChart(props, 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.
+        // ctx.x, ctx.y is the top-left of content area in pdf-lib coords (y up).
+        const imgX = ctx.x + offsetX;
+        const imgY = ctx.y - offsetY - drawHeight;
+        ctx.page.drawImage(embedded.image, {
+            x: imgX,
+            y: imgY,
+            width: drawWidth,
+            height: drawHeight,
+            opacity: ctx.opacity,
+        });
+    },
+};
+//# sourceMappingURL=chart-plugin.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { JSONSchema } from '@jsonpdf/core';
+/** Fit mode for chart image within element bounds. */
+export type ChartFit = 'contain' | 'cover' | 'fill' | 'none';
+export interface ChartProps {
+    /** Vega-Lite specification object (fully resolved by renderer). */
+    spec: Record<string, unknown>;
+    /** Optional data array to inject as spec.data.values. */
+    dataSource?: unknown[];
+    /** How the chart image fits within the element bounds. Default 'contain'. */
+    fit?: ChartFit;
+    /** Scale factor for SVG rasterization. Default 2 (HiDPI). */
+    scale?: number;
+    /** Background color for the chart. If set, overrides spec.background. */
+    background?: string;
+}
+export declare const chartPropsSchema: JSONSchema;
+export declare const CHART_DEFAULTS: ChartProps;
+//# sourceMappingURL=chart-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-types.d.ts","sourceRoot":"","sources":["../../src/chart/chart-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,UAW9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,UAI5B,CAAC"}

package/dist/chart/chart-types.js

@@ -0,0 +1,18 @@
+export const chartPropsSchema = {
+    type: 'object',
+    required: ['spec'],
+    additionalProperties: false,
+    properties: {
+        spec: { type: 'object' },
+        dataSource: { type: 'array' },
+        fit: { type: 'string', enum: ['contain', 'cover', 'fill', 'none'] },
+        scale: { type: 'number', minimum: 0.5 },
+        background: { type: 'string' },
+    },
+};
+export const CHART_DEFAULTS = {
+    spec: {},
+    fit: 'contain',
+    scale: 2,
+};
+//# sourceMappingURL=chart-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-types.js","sourceRoot":"","sources":["../../src/chart/chart-types.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QAC7B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;QACvC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC/B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,CAAC;CACT,CAAC"}