@palmerama/hd-canvas 1.0.0

package/dist/core/ColorBuffer.js

@@ -0,0 +1,138 @@
+/**
+ * ColorBuffer — Float32/Float64 RGBA pixel buffer
+ *
+ * The foundation of the HD Canvas framework. Stores pixel data as
+ * unbounded floats (0.0–1.0 is "standard" range, >1.0 is HDR).
+ * Row-major layout, 4 floats per pixel (R, G, B, A).
+ */
+export class ColorBuffer {
+    width;
+    height;
+    depth;
+    data;
+    constructor(width, height, depth = 32) {
+        if (!Number.isInteger(width) || width <= 0) {
+            throw new RangeError(`width must be a positive integer, got ${width}`);
+        }
+        if (!Number.isInteger(height) || height <= 0) {
+            throw new RangeError(`height must be a positive integer, got ${height}`);
+        }
+        this.width = width;
+        this.height = height;
+        this.depth = depth;
+        const length = width * height * 4;
+        this.data = depth === 64 ? new Float64Array(length) : new Float32Array(length);
+    }
+    /** Byte size of the underlying typed array */
+    get byteLength() {
+        return this.data.byteLength;
+    }
+    offset(x, y) {
+        if (x < 0 || x >= this.width || y < 0 || y >= this.height) {
+            throw new RangeError(`Pixel (${x}, ${y}) out of bounds for ${this.width}×${this.height} buffer`);
+        }
+        return (y * this.width + x) * 4;
+    }
+    setPixel(x, y, r, g, b, a = 1.0) {
+        const i = this.offset(x, y);
+        this.data[i] = r;
+        this.data[i + 1] = g;
+        this.data[i + 2] = b;
+        this.data[i + 3] = a;
+    }
+    getPixel(x, y) {
+        const i = this.offset(x, y);
+        return [
+            this.data[i],
+            this.data[i + 1],
+            this.data[i + 2],
+            this.data[i + 3],
+        ];
+    }
+    /**
+     * Blend a color onto the existing pixel using the specified blend mode.
+     * All modes use standard alpha compositing for the alpha channel.
+     */
+    blendPixel(x, y, r, g, b, a, mode = 'normal') {
+        const i = this.offset(x, y);
+        const dstR = this.data[i];
+        const dstG = this.data[i + 1];
+        const dstB = this.data[i + 2];
+        const dstA = this.data[i + 3];
+        let blendedR;
+        let blendedG;
+        let blendedB;
+        switch (mode) {
+            case 'normal':
+                blendedR = r;
+                blendedG = g;
+                blendedB = b;
+                break;
+            case 'add':
+                blendedR = dstR + r;
+                blendedG = dstG + g;
+                blendedB = dstB + b;
+                break;
+            case 'multiply':
+                blendedR = dstR * r;
+                blendedG = dstG * g;
+                blendedB = dstB * b;
+                break;
+            default: {
+                const _exhaustive = mode;
+                throw new Error(`Unknown blend mode: ${_exhaustive}`);
+            }
+        }
+        // Alpha compositing: src over dst
+        const outA = a + dstA * (1 - a);
+        if (outA === 0) {
+            this.data[i] = 0;
+            this.data[i + 1] = 0;
+            this.data[i + 2] = 0;
+            this.data[i + 3] = 0;
+        }
+        else {
+            this.data[i] = (blendedR * a + dstR * dstA * (1 - a)) / outA;
+            this.data[i + 1] = (blendedG * a + dstG * dstA * (1 - a)) / outA;
+            this.data[i + 2] = (blendedB * a + dstB * dstA * (1 - a)) / outA;
+            this.data[i + 3] = outA;
+        }
+    }
+    /** Fill the entire buffer with a single color (default: transparent black) */
+    clear(r = 0, g = 0, b = 0, a = 0) {
+        for (let i = 0; i < this.data.length; i += 4) {
+            this.data[i] = r;
+            this.data[i + 1] = g;
+            this.data[i + 2] = b;
+            this.data[i + 3] = a;
+        }
+    }
+    /** Extract a rectangular region as a new ColorBuffer */
+    getRegion(x, y, w, h) {
+        if (x < 0 || y < 0 || x + w > this.width || y + h > this.height) {
+            throw new RangeError(`Region (${x},${y} ${w}×${h}) exceeds buffer bounds ${this.width}×${this.height}`);
+        }
+        if (w <= 0 || h <= 0) {
+            throw new RangeError(`Region dimensions must be positive, got ${w}×${h}`);
+        }
+        const region = new ColorBuffer(w, h, this.depth);
+        for (let row = 0; row < h; row++) {
+            const srcStart = ((y + row) * this.width + x) * 4;
+            const dstStart = row * w * 4;
+            region.data.set(this.data.subarray(srcStart, srcStart + w * 4), dstStart);
+        }
+        return region;
+    }
+    /** Write a ColorBuffer region into this buffer at the given position */
+    putRegion(x, y, region) {
+        if (x < 0 || y < 0 || x + region.width > this.width || y + region.height > this.height) {
+            throw new RangeError(`Region (${x},${y} ${region.width}×${region.height}) exceeds buffer bounds ${this.width}×${this.height}`);
+        }
+        for (let row = 0; row < region.height; row++) {
+            const srcStart = row * region.width * 4;
+            const dstStart = ((y + row) * this.width + x) * 4;
+            this.data.set(region.data.subarray(srcStart, srcStart + region.width * 4), dstStart);
+        }
+    }
+}
+//# sourceMappingURL=ColorBuffer.js.map

package/dist/core/ColorBuffer.js.map

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

package/dist/core/HDCanvas.d.ts

@@ -0,0 +1,80 @@
+/**
+ * HDCanvas — Main class for the HD Canvas framework
+ *
+ * Wires together ColorBuffer + PaperSize into a single API surface.
+ * Construct with paper size + DPI, draw with float colors, preview on screen, export.
+ */
+import { ColorBuffer, type ColorDepth, type BlendMode, type RGBA } from './ColorBuffer.js';
+import { type PaperSizeKey, type PaperDimensions, type Orientation } from './PaperSize.js';
+import { type DrawWith2DOptions } from '../bridge/Canvas2DBridge.js';
+export interface HDCanvasOptions {
+    /** Predefined paper size key or custom dimensions in mm */
+    paperSize: PaperSizeKey | {
+        widthMM: number;
+        heightMM: number;
+    };
+    /** Dots per inch — default 300 */
+    dpi?: number;
+    /** Float32 or Float64 color depth — default 32 */
+    colorDepth?: ColorDepth;
+    /** Portrait or landscape — default portrait */
+    orientation?: Orientation;
+}
+export interface ExportOptions {
+    /** Tone mapping algorithm */
+    toneMap?: 'reinhard' | 'aces' | 'clamp';
+    /** Exposure adjustment (stops) */
+    exposure?: number;
+    /** Gamma correction */
+    gamma?: number;
+    /** Output format */
+    format?: 'png';
+}
+export declare class HDCanvas {
+    readonly widthPx: number;
+    readonly heightPx: number;
+    readonly dpi: number;
+    readonly colorDepth: ColorDepth;
+    readonly buffer: ColorBuffer;
+    readonly paperMM: PaperDimensions;
+    private previewRenderer;
+    private exportFn;
+    constructor(options: HDCanvasOptions);
+    setPixel(x: number, y: number, r: number, g: number, b: number, a?: number): void;
+    getPixel(x: number, y: number): RGBA;
+    blendPixel(x: number, y: number, r: number, g: number, b: number, a: number, mode?: BlendMode): void;
+    clear(r?: number, g?: number, b?: number, a?: number): void;
+    getRegion(x: number, y: number, w: number, h: number): ColorBuffer;
+    putRegion(x: number, y: number, region: ColorBuffer): void;
+    /**
+     * Draw using the familiar Canvas 2D API. Creates a temporary offscreen canvas,
+     * passes the 2D context to your callback, and reads pixels back into the float buffer.
+     *
+     * Note: Canvas 2D is 8-bit, so this is for convenience shapes/text, not HDR input.
+     * For HDR drawing, use the pixel API directly.
+     *
+     * Automatically tiles for large canvases (A0+) to stay within browser limits.
+     */
+    drawWith2D(callback: (ctx: CanvasRenderingContext2D) => void, options?: DrawWith2DOptions): void;
+    /**
+     * Attach a preview renderer. The renderer is injected to avoid
+     * coupling the core to DOM APIs (enables Node.js usage for headless export).
+     */
+    setPreviewRenderer(renderer: {
+        refresh(): void;
+        destroy(): void;
+    }): void;
+    /** Trigger a preview refresh. No-op if no renderer attached. */
+    refreshPreview(): void;
+    /**
+     * Register an export function. Injected to decouple core from export pipeline.
+     */
+    setExportFn(fn: (buffer: ColorBuffer, options: ExportOptions) => Promise<Blob>): void;
+    /** Export the canvas to a Blob. Requires an export function to be registered. */
+    export(options?: ExportOptions): Promise<Blob>;
+    /** Estimated memory usage of the buffer in bytes */
+    get memoryBytes(): number;
+    /** Clean up resources */
+    destroy(): void;
+}
+//# sourceMappingURL=HDCanvas.d.ts.map

package/dist/core/HDCanvas.d.ts.map

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

package/dist/core/HDCanvas.js

@@ -0,0 +1,104 @@
+/**
+ * HDCanvas — Main class for the HD Canvas framework
+ *
+ * Wires together ColorBuffer + PaperSize into a single API surface.
+ * Construct with paper size + DPI, draw with float colors, preview on screen, export.
+ */
+import { ColorBuffer } from './ColorBuffer.js';
+import { resolvePaperSize, sizeToPx, } from './PaperSize.js';
+import { drawWith2D } from '../bridge/Canvas2DBridge.js';
+export class HDCanvas {
+    widthPx;
+    heightPx;
+    dpi;
+    colorDepth;
+    buffer;
+    paperMM;
+    previewRenderer = null;
+    exportFn = null;
+    constructor(options) {
+        const dpi = options.dpi ?? 300;
+        const colorDepth = options.colorDepth ?? 32;
+        const orientation = options.orientation ?? 'portrait';
+        if (dpi <= 0) {
+            throw new RangeError(`DPI must be positive, got ${dpi}`);
+        }
+        this.dpi = dpi;
+        this.colorDepth = colorDepth;
+        this.paperMM = resolvePaperSize(options.paperSize, orientation);
+        const px = sizeToPx(this.paperMM, dpi);
+        this.widthPx = px.width;
+        this.heightPx = px.height;
+        this.buffer = new ColorBuffer(this.widthPx, this.heightPx, colorDepth);
+    }
+    // --- Drawing API (delegates to ColorBuffer) ---
+    setPixel(x, y, r, g, b, a) {
+        this.buffer.setPixel(x, y, r, g, b, a);
+    }
+    getPixel(x, y) {
+        return this.buffer.getPixel(x, y);
+    }
+    blendPixel(x, y, r, g, b, a, mode) {
+        this.buffer.blendPixel(x, y, r, g, b, a, mode);
+    }
+    clear(r, g, b, a) {
+        this.buffer.clear(r, g, b, a);
+    }
+    getRegion(x, y, w, h) {
+        return this.buffer.getRegion(x, y, w, h);
+    }
+    putRegion(x, y, region) {
+        this.buffer.putRegion(x, y, region);
+    }
+    // --- Canvas 2D Bridge ---
+    /**
+     * Draw using the familiar Canvas 2D API. Creates a temporary offscreen canvas,
+     * passes the 2D context to your callback, and reads pixels back into the float buffer.
+     *
+     * Note: Canvas 2D is 8-bit, so this is for convenience shapes/text, not HDR input.
+     * For HDR drawing, use the pixel API directly.
+     *
+     * Automatically tiles for large canvases (A0+) to stay within browser limits.
+     */
+    drawWith2D(callback, options) {
+        drawWith2D(this.buffer, callback, options);
+    }
+    // --- Preview ---
+    /**
+     * Attach a preview renderer. The renderer is injected to avoid
+     * coupling the core to DOM APIs (enables Node.js usage for headless export).
+     */
+    setPreviewRenderer(renderer) {
+        this.previewRenderer?.destroy();
+        this.previewRenderer = renderer;
+    }
+    /** Trigger a preview refresh. No-op if no renderer attached. */
+    refreshPreview() {
+        this.previewRenderer?.refresh();
+    }
+    // --- Export ---
+    /**
+     * Register an export function. Injected to decouple core from export pipeline.
+     */
+    setExportFn(fn) {
+        this.exportFn = fn;
+    }
+    /** Export the canvas to a Blob. Requires an export function to be registered. */
+    async export(options = {}) {
+        if (!this.exportFn) {
+            throw new Error('No export function registered. Call setExportFn() or use the export pipeline module.');
+        }
+        return this.exportFn(this.buffer, options);
+    }
+    /** Estimated memory usage of the buffer in bytes */
+    get memoryBytes() {
+        return this.buffer.byteLength;
+    }
+    /** Clean up resources */
+    destroy() {
+        this.previewRenderer?.destroy();
+        this.previewRenderer = null;
+        this.exportFn = null;
+    }
+}
+//# sourceMappingURL=HDCanvas.js.map

package/dist/core/HDCanvas.js.map

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

package/dist/core/PaperSize.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PaperSize — Paper size definitions and DPI→pixel calculations
+ *
+ * Supports ISO A-series (A0–A6) and US sizes (Letter, Legal, Tabloid).
+ * All dimensions stored in millimeters, converted to pixels via DPI.
+ */
+export interface PaperDimensions {
+    /** Width in millimeters */
+    readonly widthMM: number;
+    /** Height in millimeters */
+    readonly heightMM: number;
+}
+export interface PixelDimensions {
+    readonly width: number;
+    readonly height: number;
+}
+export type Orientation = 'portrait' | 'landscape';
+/** Predefined paper size keys */
+export type PaperSizeKey = 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'Letter' | 'Legal' | 'Tabloid';
+/**
+ * Paper size registry — all dimensions in portrait orientation (width < height).
+ * Millimeter values per ISO 216 and ANSI standards.
+ */
+export declare const PAPER_SIZES: Readonly<Record<PaperSizeKey, PaperDimensions>>;
+/**
+ * Convert paper dimensions + DPI to pixel dimensions.
+ * Formula: pixels = (mm / 25.4) * dpi, rounded to nearest integer.
+ */
+export declare function sizeToPx(size: PaperDimensions, dpi: number): PixelDimensions;
+/**
+ * Resolve a paper size input to millimeter dimensions, applying orientation.
+ * Accepts either a predefined key or custom { widthMM, heightMM }.
+ */
+export declare function resolvePaperSize(size: PaperSizeKey | PaperDimensions, orientation?: Orientation): PaperDimensions;
+/**
+ * Estimate memory usage for a buffer at the given size, DPI, and color depth.
+ * Returns size in bytes.
+ */
+export declare function estimateBufferBytes(size: PaperSizeKey | PaperDimensions, dpi: number, depth?: 32 | 64): number;
+//# sourceMappingURL=PaperSize.d.ts.map

package/dist/core/PaperSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaperSize.d.ts","sourceRoot":"","sources":["../../src/core/PaperSize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnD,iCAAiC;AACjC,MAAM,MAAM,YAAY,GACpB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAC9C,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAa9D,CAAC;AAIX;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,GAAG,eAAe,EACpC,WAAW,GAAE,WAAwB,GACpC,eAAe,CAajB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,GAAG,eAAe,EACpC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,EAAE,GAAG,EAAO,GAClB,MAAM,CAKR"}

package/dist/core/PaperSize.js

@@ -0,0 +1,63 @@
+/**
+ * PaperSize — Paper size definitions and DPI→pixel calculations
+ *
+ * Supports ISO A-series (A0–A6) and US sizes (Letter, Legal, Tabloid).
+ * All dimensions stored in millimeters, converted to pixels via DPI.
+ */
+/**
+ * Paper size registry — all dimensions in portrait orientation (width < height).
+ * Millimeter values per ISO 216 and ANSI standards.
+ */
+export const PAPER_SIZES = {
+    // ISO A-series
+    A0: { widthMM: 841, heightMM: 1189 },
+    A1: { widthMM: 594, heightMM: 841 },
+    A2: { widthMM: 420, heightMM: 594 },
+    A3: { widthMM: 297, heightMM: 420 },
+    A4: { widthMM: 210, heightMM: 297 },
+    A5: { widthMM: 148, heightMM: 210 },
+    A6: { widthMM: 105, heightMM: 148 },
+    // US sizes (converted to mm)
+    Letter: { widthMM: 215.9, heightMM: 279.4 },
+    Legal: { widthMM: 215.9, heightMM: 355.6 },
+    Tabloid: { widthMM: 279.4, heightMM: 431.8 },
+};
+const MM_PER_INCH = 25.4;
+/**
+ * Convert paper dimensions + DPI to pixel dimensions.
+ * Formula: pixels = (mm / 25.4) * dpi, rounded to nearest integer.
+ */
+export function sizeToPx(size, dpi) {
+    if (dpi <= 0) {
+        throw new RangeError(`DPI must be positive, got ${dpi}`);
+    }
+    return {
+        width: Math.round((size.widthMM / MM_PER_INCH) * dpi),
+        height: Math.round((size.heightMM / MM_PER_INCH) * dpi),
+    };
+}
+/**
+ * Resolve a paper size input to millimeter dimensions, applying orientation.
+ * Accepts either a predefined key or custom { widthMM, heightMM }.
+ */
+export function resolvePaperSize(size, orientation = 'portrait') {
+    const dims = typeof size === 'string' ? PAPER_SIZES[size] : size;
+    if (dims.widthMM <= 0 || dims.heightMM <= 0) {
+        throw new RangeError(`Paper dimensions must be positive, got ${dims.widthMM}×${dims.heightMM}mm`);
+    }
+    if (orientation === 'landscape') {
+        return { widthMM: dims.heightMM, heightMM: dims.widthMM };
+    }
+    return dims;
+}
+/**
+ * Estimate memory usage for a buffer at the given size, DPI, and color depth.
+ * Returns size in bytes.
+ */
+export function estimateBufferBytes(size, dpi, depth = 32) {
+    const resolved = typeof size === 'string' ? PAPER_SIZES[size] : size;
+    const px = sizeToPx(resolved, dpi);
+    const bytesPerFloat = depth === 64 ? 8 : 4;
+    return px.width * px.height * 4 * bytesPerFloat; // 4 channels (RGBA)
+}
+//# sourceMappingURL=PaperSize.js.map

package/dist/core/PaperSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaperSize.js","sourceRoot":"","sources":["../../src/core/PaperSize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAoD;IAC1E,eAAe;IACf,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;IACpC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IACnC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IACnC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IACnC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IACnC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IACnC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IACnC,6BAA6B;IAC7B,MAAM,EAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5C,KAAK,EAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5C,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;CACpC,CAAC;AAEX,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAqB,EAAE,GAAW;IACzD,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC;QACrD,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC;KACxD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAoC,EACpC,cAA2B,UAAU;IAErC,MAAM,IAAI,GAAoB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAElF,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,UAAU,CAClB,0CAA0C,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,CAC5E,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAoC,EACpC,GAAW,EACX,QAAiB,EAAE;IAEnB,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,aAAa,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,oBAAoB;AACvE,CAAC"}

package/dist/export/ExportPipeline.d.ts

@@ -0,0 +1,94 @@
+/**
+ * ExportPipeline — Wires ToneMapper + PNGExporter into HDCanvas.export()
+ *
+ * This is the integration layer. It creates the export function that
+ * HDCanvas.setExportFn() expects, connecting the float buffer to the
+ * tone mapping → PNG encoding → Blob pipeline.
+ *
+ * Usage:
+ *   import { HDCanvas } from '../core/HDCanvas.js';
+ *   import { attachExportPipeline } from './ExportPipeline.js';
+ *
+ *   const canvas = new HDCanvas({ paperSize: 'A3', dpi: 300 });
+ *   attachExportPipeline(canvas);
+ *
+ *   // Now canvas.export() works:
+ *   const blob = await canvas.export({ toneMap: 'aces', exposure: 1.2 });
+ */
+import type { IColorBuffer } from '../core/ColorBuffer.js';
+/**
+ * Export options — matches the ExportOptions interface from HDCanvas.
+ * We re-declare here to avoid importing from canvas-dev's code directly,
+ * keeping the export pipeline decoupled.
+ */
+export interface ExportOptions {
+    /** Tone mapping algorithm. Default: 'reinhard'. */
+    toneMap?: 'reinhard' | 'aces' | 'clamp';
+    /** Exposure adjustment in stops. Default: 0. */
+    exposure?: number;
+    /** Gamma correction. Default: 2.2 (sRGB). */
+    gamma?: number;
+    /** Output format. Default: 'png'. */
+    format?: 'png';
+}
+/**
+ * Progress callback for large exports.
+ */
+export type ExportProgressFn = (percent: number) => void;
+/**
+ * Extended export options with progress tracking.
+ */
+export interface ExportPipelineOptions extends ExportOptions {
+    /** DPI for the output file metadata. */
+    dpi: number;
+    /** Progress callback. */
+    onProgress?: ExportProgressFn;
+}
+/**
+ * Execute the full export pipeline: tone map → encode PNG → return Blob.
+ *
+ * This is the pure function that does the work. It takes a ColorBuffer
+ * and options, returns a Blob. No side effects, no DOM dependency.
+ */
+export declare function exportBuffer(buffer: IColorBuffer, options: ExportPipelineOptions): Blob;
+/**
+ * Minimal interface for the HDCanvas we need to attach to.
+ * Avoids importing the full HDCanvas class — keeps coupling loose.
+ */
+export interface ExportableCanvas {
+    readonly buffer: IColorBuffer;
+    readonly dpi: number;
+    setExportFn(fn: (buffer: IColorBuffer, options: ExportOptions) => Promise<Blob>): void;
+}
+/**
+ * Attach the export pipeline to an HDCanvas instance.
+ *
+ * After calling this, `canvas.export()` will work:
+ *   const blob = await canvas.export({ toneMap: 'aces', exposure: 1.2 });
+ *
+ * @param canvas - An HDCanvas instance (or anything matching ExportableCanvas)
+ * @param onProgress - Optional progress callback for all exports
+ */
+export declare function attachExportPipeline(canvas: ExportableCanvas, onProgress?: ExportProgressFn): void;
+/**
+ * Trigger a browser download of a Blob.
+ *
+ * Creates a temporary <a> element, clicks it, and cleans up.
+ * Only works in browser environments with DOM access.
+ */
+export declare function downloadBlob(blob: Blob, filename: string): void;
+/**
+ * Generate a descriptive filename for an export.
+ *
+ * @example generateFilename(3508, 4961, 300) → "artwork-3508x4961-300dpi.png"
+ */
+export declare function generateFilename(width: number, height: number, dpi: number, prefix?: string): string;
+/**
+ * Convenience: export an HDCanvas and trigger a browser download.
+ *
+ * @param canvas - HDCanvas with export pipeline attached
+ * @param options - Export options (toneMap, exposure, gamma)
+ * @param filename - Custom filename (auto-generated if omitted)
+ */
+export declare function exportAndDownload(canvas: ExportableCanvas, options?: ExportOptions, filename?: string): Promise<void>;
+//# sourceMappingURL=ExportPipeline.d.ts.map

package/dist/export/ExportPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportPipeline.d.ts","sourceRoot":"","sources":["../../src/export/ExportPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CA4CN;AAID;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,IAAI,CAQN;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkB/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAkB,GACzB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,aAAkB,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAaf"}