@palmerama/hd-canvas 1.0.0

package/dist/export/ExportPipeline.js

@@ -0,0 +1,121 @@
+/**
+ * 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 { ToneMapper } from './ToneMapper.js';
+import { PNGExporter } from './PNGExporter.js';
+// ─── Core export function ────────────────────────────────────────────
+/**
+ * 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 function exportBuffer(buffer, options) {
+    const { toneMap = 'reinhard', exposure = 0, gamma = 2.2, format = 'png', dpi, onProgress, } = options;
+    if (format !== 'png') {
+        throw new Error(`Unsupported export format: "${format}". Currently supported: png`);
+    }
+    // Step 1: Tone map (HDR float → 8-bit LDR)
+    onProgress?.(0);
+    const toneMapper = new ToneMapper({
+        algorithm: toneMap,
+        exposure,
+        gamma,
+        outputDepth: 8,
+    });
+    const ldrData = toneMapper.map(buffer);
+    onProgress?.(50);
+    // Step 2: Encode PNG with DPI metadata
+    const pngExporter = new PNGExporter();
+    const result = pngExporter.export(ldrData, {
+        width: buffer.width,
+        height: buffer.height,
+        dpi,
+        depth: 8,
+    });
+    onProgress?.(90);
+    // Step 3: Create Blob
+    const blob = new Blob([result.data.buffer], { type: 'image/png' });
+    onProgress?.(100);
+    return blob;
+}
+/**
+ * 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 function attachExportPipeline(canvas, onProgress) {
+    canvas.setExportFn(async (buffer, options) => {
+        return exportBuffer(buffer, {
+            ...options,
+            dpi: canvas.dpi,
+            onProgress,
+        });
+    });
+}
+// ─── Download helper ─────────────────────────────────────────────────
+/**
+ * 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 function downloadBlob(blob, filename) {
+    if (typeof document === 'undefined') {
+        throw new Error('downloadBlob() requires a browser environment with DOM access');
+    }
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    a.style.display = 'none';
+    document.body.appendChild(a);
+    a.click();
+    // Clean up after a tick to ensure download starts
+    setTimeout(() => {
+        URL.revokeObjectURL(url);
+        document.body.removeChild(a);
+    }, 100);
+}
+/**
+ * Generate a descriptive filename for an export.
+ *
+ * @example generateFilename(3508, 4961, 300) → "artwork-3508x4961-300dpi.png"
+ */
+export function generateFilename(width, height, dpi, prefix = 'artwork') {
+    return `${prefix}-${width}x${height}-${dpi}dpi.png`;
+}
+/**
+ * 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 async function exportAndDownload(canvas, options = {}, filename) {
+    const blob = await exportBuffer(canvas.buffer, {
+        ...options,
+        dpi: canvas.dpi,
+    });
+    const name = filename ?? generateFilename(canvas.buffer.width, canvas.buffer.height, canvas.dpi);
+    downloadBlob(blob, name);
+}
+//# sourceMappingURL=ExportPipeline.js.map

package/dist/export/ExportPipeline.js.map

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

package/dist/export/PNGExporter.d.ts

@@ -0,0 +1,62 @@
+/**
+ * PNGExporter — Full-resolution PNG export with DPI metadata.
+ *
+ * Takes tone-mapped pixel data (Uint8Array or Uint16Array RGBA) and
+ * produces a PNG file with the pHYs chunk set for correct print DPI.
+ *
+ * Uses fast-png for encoding — pure JS, works in both Node.js and browser.
+ * No native dependencies.
+ *
+ * The pHYs chunk tells image viewers/print software the physical pixel
+ * density, so an A3@300DPI image opens at the correct physical size.
+ */
+export interface PNGExportOptions {
+    /** Pixel width of the image. */
+    width: number;
+    /** Pixel height of the image. */
+    height: number;
+    /** DPI for the pHYs metadata chunk. */
+    dpi: number;
+    /**
+     * Bit depth of the input data.
+     * 8 → expects Uint8Array, 16 → expects Uint16Array.
+     * Default: 8.
+     */
+    depth?: 8 | 16;
+}
+export interface PNGExportResult {
+    /** Raw PNG file bytes. */
+    data: Uint8Array;
+    /** MIME type. */
+    mimeType: 'image/png';
+    /** Suggested filename. */
+    filename: string;
+}
+/**
+ * Convert DPI to pixels-per-meter for the PNG pHYs chunk.
+ * 1 inch = 0.0254 meters, so ppm = dpi / 0.0254.
+ */
+export declare function dpiToPixelsPerMeter(dpi: number): number;
+/**
+ * Inject a pHYs chunk into an existing PNG buffer.
+ *
+ * PNG structure: signature (8 bytes) → IHDR chunk → ... → IDAT → IEND
+ * pHYs must appear before the first IDAT chunk.
+ * We insert it right after IHDR (which is always the first chunk).
+ */
+export declare function injectPHYs(png: Uint8Array, dpi: number): Uint8Array;
+export declare class PNGExporter {
+    /**
+     * Export tone-mapped pixel data to PNG with DPI metadata.
+     *
+     * @param data - Tone-mapped RGBA pixel data (Uint8Array for 8-bit, Uint16Array for 16-bit)
+     * @param options - Export options (width, height, dpi, depth)
+     * @returns PNG file data with pHYs chunk embedded
+     */
+    export(data: Uint8Array | Uint16Array, options: PNGExportOptions): PNGExportResult;
+    /**
+     * Export and return as a Blob (browser convenience).
+     */
+    exportBlob(data: Uint8Array | Uint16Array, options: PNGExportOptions): Blob;
+}
+//# sourceMappingURL=PNGExporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PNGExporter.d.ts","sourceRoot":"","sources":["../../src/export/PNGExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,iBAAiB;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AA2DD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBnE;AAID,qBAAa,WAAW;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,eAAe;IA2ClF;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;CAK5E"}

package/dist/export/PNGExporter.js

@@ -0,0 +1,146 @@
+/**
+ * PNGExporter — Full-resolution PNG export with DPI metadata.
+ *
+ * Takes tone-mapped pixel data (Uint8Array or Uint16Array RGBA) and
+ * produces a PNG file with the pHYs chunk set for correct print DPI.
+ *
+ * Uses fast-png for encoding — pure JS, works in both Node.js and browser.
+ * No native dependencies.
+ *
+ * The pHYs chunk tells image viewers/print software the physical pixel
+ * density, so an A3@300DPI image opens at the correct physical size.
+ */
+import { encode } from 'fast-png';
+// ─── DPI conversion ──────────────────────────────────────────────────
+/**
+ * Convert DPI to pixels-per-meter for the PNG pHYs chunk.
+ * 1 inch = 0.0254 meters, so ppm = dpi / 0.0254.
+ */
+export function dpiToPixelsPerMeter(dpi) {
+    return Math.round(dpi / 0.0254);
+}
+// ─── PNG pHYs chunk injection ────────────────────────────────────────
+/**
+ * CRC32 lookup table for PNG chunk checksums.
+ */
+const CRC_TABLE = new Uint32Array(256);
+for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) {
+        c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+    }
+    CRC_TABLE[n] = c;
+}
+function crc32(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++) {
+        crc = CRC_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/**
+ * Build a PNG pHYs chunk.
+ *
+ * Format: 4 bytes length + 4 bytes "pHYs" + 9 bytes data + 4 bytes CRC
+ * Data: 4 bytes X ppm (big-endian) + 4 bytes Y ppm + 1 byte unit (1=meter)
+ */
+function buildPHYsChunk(dpi) {
+    const ppm = dpiToPixelsPerMeter(dpi);
+    const chunk = new Uint8Array(21); // 4 + 4 + 9 + 4
+    const view = new DataView(chunk.buffer);
+    // Length of data section (9 bytes)
+    view.setUint32(0, 9, false);
+    // Chunk type: "pHYs"
+    chunk[4] = 0x70; // p
+    chunk[5] = 0x48; // H
+    chunk[6] = 0x59; // Y
+    chunk[7] = 0x73; // s
+    // X pixels per unit (big-endian)
+    view.setUint32(8, ppm, false);
+    // Y pixels per unit (big-endian)
+    view.setUint32(12, ppm, false);
+    // Unit: 1 = meter
+    chunk[16] = 1;
+    // CRC over type + data (bytes 4..16 inclusive)
+    const crcData = chunk.slice(4, 17);
+    const crcVal = crc32(crcData);
+    view.setUint32(17, crcVal, false);
+    return chunk;
+}
+/**
+ * Inject a pHYs chunk into an existing PNG buffer.
+ *
+ * PNG structure: signature (8 bytes) → IHDR chunk → ... → IDAT → IEND
+ * pHYs must appear before the first IDAT chunk.
+ * We insert it right after IHDR (which is always the first chunk).
+ */
+export function injectPHYs(png, dpi) {
+    // PNG signature is 8 bytes
+    // IHDR chunk: 4 (length) + 4 (type) + 13 (data) + 4 (crc) = 25 bytes
+    // So IHDR ends at byte 33
+    const IHDR_END = 8 + 25;
+    // Verify this is a PNG
+    if (png[0] !== 0x89 || png[1] !== 0x50 || png[2] !== 0x4e || png[3] !== 0x47) {
+        throw new Error('Not a valid PNG file');
+    }
+    const phys = buildPHYsChunk(dpi);
+    // Concatenate: [signature + IHDR] + [pHYs] + [rest of PNG]
+    const result = new Uint8Array(png.length + phys.length);
+    result.set(png.subarray(0, IHDR_END), 0);
+    result.set(phys, IHDR_END);
+    result.set(png.subarray(IHDR_END), IHDR_END + phys.length);
+    return result;
+}
+// ─── PNGExporter class ───────────────────────────────────────────────
+export class PNGExporter {
+    /**
+     * Export tone-mapped pixel data to PNG with DPI metadata.
+     *
+     * @param data - Tone-mapped RGBA pixel data (Uint8Array for 8-bit, Uint16Array for 16-bit)
+     * @param options - Export options (width, height, dpi, depth)
+     * @returns PNG file data with pHYs chunk embedded
+     */
+    export(data, options) {
+        const { width, height, dpi, depth = 8 } = options;
+        if (width <= 0 || height <= 0) {
+            throw new Error(`Invalid dimensions: ${width}x${height}`);
+        }
+        if (dpi <= 0) {
+            throw new Error(`DPI must be positive, got: ${dpi}`);
+        }
+        const expectedLength = width * height * 4;
+        if (data.length !== expectedLength) {
+            throw new Error(`Data length mismatch: expected ${expectedLength} (${width}x${height}x4), got ${data.length}`);
+        }
+        if (depth === 16 && !(data instanceof Uint16Array)) {
+            throw new Error('16-bit depth requires Uint16Array input');
+        }
+        if (depth === 8 && !(data instanceof Uint8Array)) {
+            throw new Error('8-bit depth requires Uint8Array input');
+        }
+        // Encode PNG using fast-png
+        const pngBytes = encode({
+            width,
+            height,
+            data,
+            depth,
+            channels: 4,
+        });
+        // Inject pHYs chunk for DPI metadata
+        const pngWithDpi = injectPHYs(pngBytes, dpi);
+        return {
+            data: pngWithDpi,
+            mimeType: 'image/png',
+            filename: `artwork-${width}x${height}-${dpi}dpi.png`,
+        };
+    }
+    /**
+     * Export and return as a Blob (browser convenience).
+     */
+    exportBlob(data, options) {
+        const result = this.export(data, options);
+        // Cast needed: Node.js types have SharedArrayBuffer in ArrayBufferLike
+        return new Blob([result.data.buffer], { type: result.mimeType });
+    }
+}
+//# sourceMappingURL=PNGExporter.js.map

package/dist/export/PNGExporter.js.map

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

package/dist/export/ToneMapper.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ToneMapper — HDR → LDR tone mapping with pluggable algorithms.
+ *
+ * Takes an HDR ColorBuffer (unbounded float RGBA) and produces a
+ * quantized Uint8Array or Uint16Array suitable for image encoding.
+ *
+ * Pipeline per-pixel:
+ *   1. Exposure: multiply RGB by 2^exposure
+ *   2. Tone map: compress HDR range → [0, 1] using selected algorithm
+ *   3. Gamma: apply gamma correction (output = value^(1/gamma))
+ *   4. Quantize: float [0,1] → uint8 [0,255] or uint16 [0,65535]
+ *
+ * Alpha is passed through without tone mapping (clamped to [0,1]).
+ */
+import type { IColorBuffer } from '../core/ColorBuffer.js';
+/**
+ * A tone mapping function. Takes an unbounded HDR luminance value (≥0)
+ * and returns a value in [0, 1].
+ */
+export type ToneMapFn = (v: number) => number;
+/** Simple clamp to [0, 1]. No compression — just clips. */
+export declare function clamp(v: number): number;
+/**
+ * Reinhard tone mapping: v / (1 + v).
+ * Smoothly compresses the full HDR range into [0, 1).
+ * Never clips, but can look washed out without exposure adjustment.
+ */
+export declare function reinhard(v: number): number;
+/**
+ * ACES filmic tone mapping (simplified fit by Krzysztof Narkowicz).
+ * Attempt at a cinematic look with good contrast and saturation.
+ *
+ * f(x) = (x(ax + b)) / (x(cx + d) + e)
+ * where a=2.51, b=0.03, c=2.43, d=0.59, e=0.14
+ */
+export declare function aces(v: number): number;
+/** Built-in algorithm registry. */
+export declare const TONE_MAP_ALGORITHMS: {
+    readonly clamp: typeof clamp;
+    readonly reinhard: typeof reinhard;
+    readonly aces: typeof aces;
+};
+export type ToneMapAlgorithm = keyof typeof TONE_MAP_ALGORITHMS;
+export type OutputDepth = 8 | 16;
+export interface ToneMapOptions {
+    /** Tone mapping algorithm name or custom function. */
+    algorithm: ToneMapAlgorithm | ToneMapFn;
+    /**
+     * Exposure adjustment in stops. RGB values are multiplied by 2^exposure
+     * before tone mapping. Default: 0 (no adjustment).
+     */
+    exposure?: number;
+    /**
+     * Gamma correction value. Applied after tone mapping as v^(1/gamma).
+     * Default: 2.2 (standard sRGB).
+     */
+    gamma?: number;
+    /**
+     * Output bit depth. 8 → Uint8Array [0,255], 16 → Uint16Array [0,65535].
+     * Default: 8.
+     */
+    outputDepth?: OutputDepth;
+}
+export declare class ToneMapper {
+    private readonly mapFn;
+    private readonly exposureMultiplier;
+    private readonly invGamma;
+    private readonly outputDepth;
+    private readonly maxVal;
+    constructor(options: ToneMapOptions);
+    /**
+     * Map a single HDR channel value through the full pipeline.
+     * Useful for testing. Does NOT apply to alpha.
+     */
+    mapValue(v: number): number;
+    /**
+     * Quantize a [0,1] float to the output integer range.
+     */
+    quantize(v: number): number;
+    /**
+     * Process an entire ColorBuffer → quantized RGBA output.
+     *
+     * Returns Uint8Array (outputDepth=8) or Uint16Array (outputDepth=16).
+     * Output has the same pixel layout: 4 values per pixel [R, G, B, A].
+     */
+    map(input: IColorBuffer): Uint8Array | Uint16Array;
+}
+//# sourceMappingURL=ToneMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToneMapper.d.ts","sourceRoot":"","sources":["../../src/export/ToneMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE9C,2DAA2D;AAC3D,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1C;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAStC;AAED,mCAAmC;AACnC,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAIhE,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC;AAEjC,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,cAAc;IA+BnC;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAS3B;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAK3B;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,GAAG,WAAW;CAyEnD"}

package/dist/export/ToneMapper.js

@@ -0,0 +1,175 @@
+/**
+ * ToneMapper — HDR → LDR tone mapping with pluggable algorithms.
+ *
+ * Takes an HDR ColorBuffer (unbounded float RGBA) and produces a
+ * quantized Uint8Array or Uint16Array suitable for image encoding.
+ *
+ * Pipeline per-pixel:
+ *   1. Exposure: multiply RGB by 2^exposure
+ *   2. Tone map: compress HDR range → [0, 1] using selected algorithm
+ *   3. Gamma: apply gamma correction (output = value^(1/gamma))
+ *   4. Quantize: float [0,1] → uint8 [0,255] or uint16 [0,65535]
+ *
+ * Alpha is passed through without tone mapping (clamped to [0,1]).
+ */
+/** Simple clamp to [0, 1]. No compression — just clips. */
+export function clamp(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+/**
+ * Reinhard tone mapping: v / (1 + v).
+ * Smoothly compresses the full HDR range into [0, 1).
+ * Never clips, but can look washed out without exposure adjustment.
+ */
+export function reinhard(v) {
+    if (v < 0)
+        return 0;
+    return v / (1 + v);
+}
+/**
+ * ACES filmic tone mapping (simplified fit by Krzysztof Narkowicz).
+ * Attempt at a cinematic look with good contrast and saturation.
+ *
+ * f(x) = (x(ax + b)) / (x(cx + d) + e)
+ * where a=2.51, b=0.03, c=2.43, d=0.59, e=0.14
+ */
+export function aces(v) {
+    if (v < 0)
+        return 0;
+    const a = 2.51;
+    const b = 0.03;
+    const c = 2.43;
+    const d = 0.59;
+    const e = 0.14;
+    const mapped = (v * (a * v + b)) / (v * (c * v + d) + e);
+    return mapped < 0 ? 0 : mapped > 1 ? 1 : mapped;
+}
+/** Built-in algorithm registry. */
+export const TONE_MAP_ALGORITHMS = {
+    clamp,
+    reinhard,
+    aces,
+};
+// ─── ToneMapper class ────────────────────────────────────────────────
+export class ToneMapper {
+    mapFn;
+    exposureMultiplier;
+    invGamma;
+    outputDepth;
+    maxVal;
+    constructor(options) {
+        // Resolve algorithm
+        if (typeof options.algorithm === 'function') {
+            this.mapFn = options.algorithm;
+        }
+        else {
+            const fn = TONE_MAP_ALGORITHMS[options.algorithm];
+            if (!fn) {
+                throw new Error(`Unknown tone map algorithm: "${options.algorithm}". ` +
+                    `Available: ${Object.keys(TONE_MAP_ALGORITHMS).join(', ')}`);
+            }
+            this.mapFn = fn;
+        }
+        const exposure = options.exposure ?? 0;
+        this.exposureMultiplier = Math.pow(2, exposure);
+        const gamma = options.gamma ?? 2.2;
+        if (gamma <= 0) {
+            throw new Error(`Gamma must be positive, got: ${gamma}`);
+        }
+        this.invGamma = 1 / gamma;
+        this.outputDepth = options.outputDepth ?? 8;
+        if (this.outputDepth !== 8 && this.outputDepth !== 16) {
+            throw new Error(`Output depth must be 8 or 16, got: ${this.outputDepth}`);
+        }
+        this.maxVal = this.outputDepth === 16 ? 65535 : 255;
+    }
+    /**
+     * Map a single HDR channel value through the full pipeline.
+     * Useful for testing. Does NOT apply to alpha.
+     */
+    mapValue(v) {
+        // 1. Exposure
+        const exposed = v * this.exposureMultiplier;
+        // 2. Tone map
+        const mapped = this.mapFn(exposed);
+        // 3. Gamma
+        return Math.pow(mapped, this.invGamma);
+    }
+    /**
+     * Quantize a [0,1] float to the output integer range.
+     */
+    quantize(v) {
+        const clamped = v < 0 ? 0 : v > 1 ? 1 : v;
+        return Math.round(clamped * this.maxVal);
+    }
+    /**
+     * Process an entire ColorBuffer → quantized RGBA output.
+     *
+     * Returns Uint8Array (outputDepth=8) or Uint16Array (outputDepth=16).
+     * Output has the same pixel layout: 4 values per pixel [R, G, B, A].
+     */
+    map(input) {
+        const pixelCount = input.width * input.height;
+        const totalValues = pixelCount * 4;
+        const src = input.data;
+        const dst = this.outputDepth === 16
+            ? new Uint16Array(totalValues)
+            : new Uint8Array(totalValues);
+        const exposureMul = this.exposureMultiplier;
+        const mapFn = this.mapFn;
+        const invGamma = this.invGamma;
+        const maxVal = this.maxVal;
+        // Build a LUT for gamma correction when outputting 8-bit.
+        // Maps integer [0..LUT_SIZE] → gamma-corrected [0..maxVal].
+        // This replaces per-pixel Math.pow with a table lookup.
+        const useGammaLut = this.outputDepth === 8;
+        const LUT_SIZE = 4096;
+        let gammaLut = null;
+        if (useGammaLut) {
+            gammaLut = new Uint8Array(LUT_SIZE + 1);
+            for (let i = 0; i <= LUT_SIZE; i++) {
+                const v = i / LUT_SIZE;
+                gammaLut[i] = Math.round(Math.pow(v, invGamma) * maxVal);
+            }
+        }
+        // Hot loop — fully unrolled RGB channels, no inner loop.
+        // Non-null assertions are safe: loop bounds are derived from array length.
+        if (gammaLut) {
+            // Fast path: 8-bit output with LUT gamma
+            for (let i = 0; i < totalValues; i += 4) {
+                // R
+                let mapped = mapFn(src[i] * exposureMul);
+                mapped = mapped < 0 ? 0 : mapped > 1 ? 1 : mapped;
+                dst[i] = gammaLut[(mapped * LUT_SIZE + 0.5) | 0];
+                // G
+                mapped = mapFn(src[i + 1] * exposureMul);
+                mapped = mapped < 0 ? 0 : mapped > 1 ? 1 : mapped;
+                dst[i + 1] = gammaLut[(mapped * LUT_SIZE + 0.5) | 0];
+                // B
+                mapped = mapFn(src[i + 2] * exposureMul);
+                mapped = mapped < 0 ? 0 : mapped > 1 ? 1 : mapped;
+                dst[i + 2] = gammaLut[(mapped * LUT_SIZE + 0.5) | 0];
+                // Alpha: clamp and quantize directly
+                const a = src[i + 3];
+                dst[i + 3] = Math.round((a < 0 ? 0 : a > 1 ? 1 : a) * maxVal);
+            }
+        }
+        else {
+            // 16-bit path: use Math.pow (LUT would be too large)
+            for (let i = 0; i < totalValues; i += 4) {
+                for (let c = 0; c < 3; c++) {
+                    const exposed = src[i + c] * exposureMul;
+                    const mapped = mapFn(exposed);
+                    const gammaed = Math.pow(mapped, invGamma);
+                    const clamped = gammaed < 0 ? 0 : gammaed > 1 ? 1 : gammaed;
+                    dst[i + c] = Math.round(clamped * maxVal);
+                }
+                const a = src[i + 3];
+                const aClamped = a < 0 ? 0 : a > 1 ? 1 : a;
+                dst[i + 3] = Math.round(aClamped * maxVal);
+            }
+        }
+        return dst;
+    }
+}
+//# sourceMappingURL=ToneMapper.js.map

package/dist/export/ToneMapper.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * HD Canvas Framework — Public API
+ *
+ * A reusable library for generative art with high dynamic range color,
+ * configurable paper sizes, and print-quality export.
+ */
+export { ColorBuffer, type IColorBuffer, type ColorDepth, type BlendMode, type RGBA, } from './core/ColorBuffer.js';
+export { PAPER_SIZES, sizeToPx, resolvePaperSize, estimateBufferBytes, type PaperSizeKey, type PaperDimensions, type Orientation, } from './core/PaperSize.js';
+export { HDCanvas, type HDCanvasOptions, type ExportOptions, } from './core/HDCanvas.js';
+export { PreviewRenderer, type PreviewRendererOptions } from './preview/PreviewRenderer.js';
+export { calculateFit, type FitMode, type FitResult } from './preview/FitStrategy.js';
+export { drawWith2D, type DrawWith2DOptions } from './bridge/Canvas2DBridge.js';
+export { ToneMapper, clamp, reinhard, aces, TONE_MAP_ALGORITHMS, type ToneMapFn, type ToneMapAlgorithm, type ToneMapOptions, type OutputDepth, } from './export/ToneMapper.js';
+export { PNGExporter, dpiToPixelsPerMeter, injectPHYs, type PNGExportOptions, type PNGExportResult, } from './export/PNGExporter.js';
+export { exportBuffer, attachExportPipeline, downloadBlob, generateFilename, exportAndDownload, type ExportPipelineOptions, type ExportProgressFn, type ExportableCanvas, } from './export/ExportPipeline.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,IAAI,GACV,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGhF,OAAO,EACL,UAAU,EACV,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,4BAA4B,CAAC"}