@photivra/engine 1.5.0 → 2.1.0

package/dist/output/png-encoder.js

@@ -0,0 +1,461 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Browser-safe PNG still-image encoder for 8- and 16-bit RGB, with explicit colour signalling for wide-gamut
+ * and HDR output. Independently written from the W3C PNG Specification (Third Edition, W3C Recommendation
+ * 24 June 2025), RFC 1950 (zlib) and RFC 1951 (DEFLATE); no third-party encoder source and no dependency.
+ *
+ * - Colour: exactly one of an sRGB chunk (plus the gAMA/cHRM compatibility values the PNG specification
+ *   lists), an iCCP embedded ICC profile, or a cICP chunk with ITU-T H.273 code points (BT.709/sRGB,
+ *   Display P3, BT.2020 primaries; sRGB, BT.709 or linear transfer). PQ and HLG code points are not written:
+ *   those transfer functions are not part of 2.0 (see THIRD_PARTY.md).
+ * - Static display metadata: mDCV (mastering display colour volume) and cLLI (MaxCLL/MaxFALL), only with cICP,
+ *   as defined in the W3C PNG Third Edition and ITU-T H.265 Annex D (also SMPTE ST 2086 and CTA-861.3). The
+ *   PNG specification allows mDCV with SDR encodings too, so both stay available for the remaining code points.
+ * - Compression: zlib with stored or fixed-Huffman DEFLATE blocks and a bounded greedy LZ77 matcher.
+ *   Output bytes are a pure function of the input; no platform CompressionStream is used.
+ *
+ * The encoder writes the caller's integer code values unchanged. Converting linear light to an encoded
+ * signal (for example sRGB) and choosing a gamut mapping is the caller's job.
+ * @see docs/IMPORT_AND_PNG.md for chunk layouts, code points and limits.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+export const PNG_ENCODER_ID = "photivra-png-rgb-v1";
+/** Limits, checked before allocation. 100 MP (megapixels) of 16-bit RGB is about 600 MB of filtered scanlines. */
+export const PNG_ENCODER_LIMITS = Object.freeze({ maximumDimension: 65535, maximumPixels: 100_000_000, maximumIccProfileBytes: 4_000_000 });
+// Maps, not plain objects: a lookup must never reach Object.prototype names such as "constructor" or "toString".
+const PRIMARIES = new Map([["bt709", 1], ["display-p3", 12], ["bt2020", 9]]);
+const TRANSFER = new Map([["bt709", 1], ["linear", 8], ["srgb", 13]]);
+const INTENT = new Map([["perceptual", 0], ["relative-colorimetric", 1], ["saturation", 2], ["absolute-colorimetric", 3]]);
+const COLOUR_ENCODING_FIELDS = Object.freeze({
+    srgb: ["kind", "renderingIntent"], icc: ["kind", "profileName", "profile"], cicp: ["kind", "primaries", "transfer", "fullRange"]
+});
+function fail(message) { throw new InvalidConfigurationError("PNG encoder: " + message); }
+/** Growable byte sink; doubles capacity as needed. */
+class ByteSink {
+    bytes = new Uint8Array(1 << 16);
+    length = 0;
+    reserve(count) {
+        if (this.length + count <= this.bytes.length)
+            return;
+        let size = this.bytes.length * 2;
+        while (size < this.length + count)
+            size *= 2;
+        const grown = new Uint8Array(size);
+        grown.set(this.bytes.subarray(0, this.length));
+        this.bytes = grown;
+    }
+    push(...values) { this.reserve(values.length); for (const v of values)
+        this.bytes[this.length++] = v; }
+    append(data) { this.reserve(data.length); this.bytes.set(data, this.length); this.length += data.length; }
+    u32(v) { this.push(v >>> 24, (v >>> 16) & 255, (v >>> 8) & 255, v & 255); }
+    result() { return this.bytes.slice(0, this.length); }
+}
+let crcTable;
+/** CRC-32 (ISO 3309 / ITU-T V.42 polynomial 0xEDB88320, reflected), as specified for PNG chunks. */
+export function pngCrc32(data, initial = 0) {
+    const table = crcTable ??= Uint32Array.from({ length: 256 }, (_, n) => { let c = n; for (let k = 0; k < 8; k++)
+        c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; return c >>> 0; });
+    let c = ~initial >>> 0;
+    for (let i = 0; i < data.length; i++)
+        c = table[(c ^ data[i]) & 255] ^ (c >>> 8);
+    return ~c >>> 0;
+}
+function adler32(data) {
+    let a = 1, b = 0;
+    for (let i = 0; i < data.length;) {
+        const end = Math.min(data.length, i + 5552); // largest run that cannot overflow before the modulo (RFC 1950)
+        for (; i < end; i++) {
+            a += data[i];
+            b += a;
+        }
+        a %= 65521;
+        b %= 65521;
+    }
+    return ((b << 16) | a) >>> 0;
+}
+const LENGTH_BASE = [3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15, 17, 19, 23, 27, 31, 35, 43, 51, 59, 67, 83, 99, 115, 131, 163, 195, 227, 258];
+const LENGTH_EXTRA = [0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0];
+const DIST_BASE = [1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193, 257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145, 8193, 12289, 16385, 24577];
+const DIST_EXTRA = [0, 0, 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13];
+const DEFLATE_WINDOW = 32768;
+/** Huffman codes are defined MSB-first (RFC 1951 §3.1.1); the stream is LSB-first, so codes are stored bit-reversed. */
+function reverseBits(code, length) { let r = 0; for (let i = 0; i < length; i++)
+    r = (r << 1) | ((code >> i) & 1); return r; }
+let fixedTables;
+/** Built once: the same codes the per-symbol definition gives, precomputed and pre-reversed. */
+function fixedHuffmanTables() {
+    if (fixedTables)
+        return fixedTables;
+    const literalCode = new Uint16Array(288), literalBits = new Uint8Array(288);
+    for (let symbol = 0; symbol < 288; symbol++) {
+        const [code, bits] = symbol < 144 ? [0x30 + symbol, 8] : symbol < 256 ? [0x190 + symbol - 144, 9] : symbol < 280 ? [symbol - 256, 7] : [0xc0 + symbol - 280, 8];
+        literalCode[symbol] = reverseBits(code, bits);
+        literalBits[symbol] = bits;
+    }
+    const lengthCode = new Uint16Array(259), lengthBits = new Uint8Array(259);
+    for (let length = 3, l = 0; length <= 258; length++) {
+        while (l < 28 && LENGTH_BASE[l + 1] <= length)
+            l++; // largest l with LENGTH_BASE[l] <= length
+        const symbol = 257 + l, bits = literalBits[symbol];
+        lengthCode[length] = literalCode[symbol] | ((length - LENGTH_BASE[l]) << bits);
+        lengthBits[length] = bits + LENGTH_EXTRA[l];
+    }
+    const distanceCode = new Uint32Array(DEFLATE_WINDOW + 1), distanceBits = new Uint8Array(DEFLATE_WINDOW + 1);
+    for (let distance = 1, d = 0; distance <= DEFLATE_WINDOW; distance++) {
+        while (d < 29 && DIST_BASE[d + 1] <= distance)
+            d++;
+        distanceCode[distance] = reverseBits(d, 5) | ((distance - DIST_BASE[d]) << 5);
+        distanceBits[distance] = 5 + DIST_EXTRA[d];
+    }
+    fixedTables = { literalCode, literalBits, lengthCode, lengthBits, distanceCode, distanceBits };
+    return fixedTables;
+}
+/**
+ * zlib stream (RFC 1950: CMF 0x78 = deflate with 32 KiB window, FLG 0x01, Adler-32 trailer) holding stored
+ * blocks or one fixed-Huffman block. LZ77 is greedy with a 3-byte hash and at most 64 chain probes.
+ */
+export function deflateZlib(data, mode) {
+    const n = data.length;
+    // Exact upper bound: a fixed-Huffman literal is at most 9 bits and a match of length L >= 3 at most 25 bits
+    // per 3 bytes, so the block needs at most 9 bits per input byte plus 3 header and 7 end-of-block bits.
+    const capacity = 2 + 4 + (mode === "stored" ? n + 5 * Math.max(1, Math.ceil(n / 65535)) : Math.ceil((9 * n + 10) / 8));
+    const out = new Uint8Array(capacity);
+    let pos = 0;
+    out[pos++] = 0x78;
+    out[pos++] = 0x01;
+    if (mode === "stored") {
+        if (n === 0) {
+            out[pos++] = 1;
+            out[pos++] = 0;
+            out[pos++] = 0;
+            out[pos++] = 255;
+            out[pos++] = 255;
+        }
+        for (let i = 0; i < n; i += 65535) {
+            const len = Math.min(65535, n - i);
+            out[pos++] = i + len >= n ? 1 : 0;
+            out[pos++] = len & 255;
+            out[pos++] = len >> 8;
+            out[pos++] = ~len & 255;
+            out[pos++] = (~len >> 8) & 255;
+            out.set(data.subarray(i, i + len), pos);
+            pos += len;
+        }
+    }
+    else {
+        const { literalCode, literalBits, lengthCode, lengthBits, distanceCode, distanceBits } = fixedHuffmanTables();
+        // LSB-first bit accumulator; at most 7 bits stay pending, and no single write exceeds 18 bits.
+        let accumulator = 0b011, bits = 3; // BFINAL = 1, BTYPE = 01 (fixed Huffman)
+        const window = DEFLATE_WINDOW, mask = window - 1, head = new Int32Array(1 << 15).fill(-1), previous = new Int32Array(window).fill(-1);
+        // Hash of the 3 bytes at i: ((data[i] << 10) ^ (data[i + 1] << 5) ^ data[i + 2]) & 0x7fff. It rolls exactly as
+        // h(i + 1) = ((h(i) << 5) ^ data[i + 3]) & 0x7fff, because the mask drops every bit of data[i] after the shift.
+        const hashed = n - 2; // positions i < hashed have three bytes to hash
+        let h = n >= 2 ? ((data[0] << 5) ^ data[1]) & 0x7fff : 0;
+        for (let i = 0; i < n;) {
+            let bestLength = 0, bestDistance = 0;
+            if (i < hashed) {
+                h = ((h << 5) ^ data[i + 2]) & 0x7fff;
+                const limit = Math.min(258, n - i);
+                for (let candidate = head[h], probes = 0; candidate >= 0 && i - candidate <= window && probes < 64; candidate = previous[candidate & mask], probes++) {
+                    if (candidate >= i)
+                        break;
+                    // A candidate that differs at index bestLength cannot be longer than the current best.
+                    if (data[candidate + bestLength] !== data[i + bestLength])
+                        continue;
+                    let length = 0;
+                    while (length < limit && data[candidate + length] === data[i + length])
+                        length++;
+                    if (length > bestLength) {
+                        bestLength = length;
+                        bestDistance = i - candidate;
+                        if (length === limit)
+                            break;
+                    }
+                }
+                previous[i & mask] = head[h];
+                head[h] = i;
+            }
+            if (bestLength >= 3) {
+                accumulator |= lengthCode[bestLength] << bits;
+                bits += lengthBits[bestLength];
+                while (bits >= 8) {
+                    out[pos++] = accumulator & 255;
+                    accumulator >>>= 8;
+                    bits -= 8;
+                }
+                accumulator |= distanceCode[bestDistance] << bits;
+                bits += distanceBits[bestDistance];
+                const end = i + bestLength;
+                for (i++; i < end; i++) {
+                    if (i < hashed) {
+                        h = ((h << 5) ^ data[i + 2]) & 0x7fff;
+                        previous[i & mask] = head[h];
+                        head[h] = i;
+                    }
+                }
+            }
+            else {
+                const symbol = data[i++];
+                accumulator |= literalCode[symbol] << bits;
+                bits += literalBits[symbol];
+            }
+            while (bits >= 8) {
+                out[pos++] = accumulator & 255;
+                accumulator >>>= 8;
+                bits -= 8;
+            }
+        }
+        accumulator |= literalCode[256] << bits;
+        bits += literalBits[256];
+        while (bits > 0) {
+            out[pos++] = accumulator & 255;
+            accumulator >>>= 8;
+            bits -= 8;
+        } // flush and byte-align
+    }
+    const adler = adler32(data);
+    out[pos++] = adler >>> 24;
+    out[pos++] = (adler >>> 16) & 255;
+    out[pos++] = (adler >>> 8) & 255;
+    out[pos++] = adler & 255;
+    return out.slice(0, pos);
+}
+/** Writes PNG filter `type` (0–4, PNG specification §9.2) of `raw` against `prior` into `target`. */
+function filterRow(type, raw, prior, target, rowBytes, bpp) {
+    const head = Math.min(bpp, rowBytes);
+    switch (type) {
+        case 0:
+            target.set(raw.subarray(0, rowBytes));
+            return;
+        case 1:
+            for (let i = 0; i < head; i++)
+                target[i] = raw[i];
+            for (let i = bpp; i < rowBytes; i++)
+                target[i] = (raw[i] - raw[i - bpp]) & 255;
+            return;
+        case 2:
+            for (let i = 0; i < rowBytes; i++)
+                target[i] = (raw[i] - prior[i]) & 255;
+            return;
+        case 3:
+            for (let i = 0; i < head; i++)
+                target[i] = (raw[i] - (prior[i] >> 1)) & 255;
+            for (let i = bpp; i < rowBytes; i++)
+                target[i] = (raw[i] - ((raw[i - bpp] + prior[i]) >> 1)) & 255;
+            return;
+        default:
+            // Paeth with a = c = 0 in the first pixel predicts b.
+            for (let i = 0; i < head; i++)
+                target[i] = (raw[i] - prior[i]) & 255;
+            for (let i = bpp; i < rowBytes; i++) {
+                const a = raw[i - bpp], b = prior[i], c = prior[i - bpp], p = a + b - c, pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);
+                target[i] = (raw[i] - (pa <= pb && pa <= pc ? a : pb <= pc ? b : c)) & 255;
+            }
+    }
+}
+/** |v| of a filtered byte v read as a signed byte (two's complement), for the §12.7 heuristic. */
+const SIGNED_BYTE_MAGNITUDE = Uint8Array.from({ length: 256 }, (_, v) => (v < 128 ? v : 256 - v));
+/** Sum of |signed byte| of filter `type` applied to a row (PNG specification §12.7), without writing the row. */
+function filterCost(type, raw, prior, rowBytes, bpp) {
+    const head = Math.min(bpp, rowBytes), magnitude = SIGNED_BYTE_MAGNITUDE;
+    let sum = 0;
+    switch (type) {
+        case 0:
+            for (let i = 0; i < rowBytes; i++)
+                sum += magnitude[raw[i]];
+            return sum;
+        case 1:
+            for (let i = 0; i < head; i++)
+                sum += magnitude[raw[i]];
+            for (let i = bpp; i < rowBytes; i++)
+                sum += magnitude[(raw[i] - raw[i - bpp]) & 255];
+            return sum;
+        case 2:
+            for (let i = 0; i < rowBytes; i++)
+                sum += magnitude[(raw[i] - prior[i]) & 255];
+            return sum;
+        case 3:
+            for (let i = 0; i < head; i++)
+                sum += magnitude[(raw[i] - (prior[i] >> 1)) & 255];
+            for (let i = bpp; i < rowBytes; i++)
+                sum += magnitude[(raw[i] - ((raw[i - bpp] + prior[i]) >> 1)) & 255];
+            return sum;
+        default:
+            for (let i = 0; i < head; i++)
+                sum += magnitude[(raw[i] - prior[i]) & 255];
+            for (let i = bpp; i < rowBytes; i++) {
+                const a = raw[i - bpp], b = prior[i], c = prior[i - bpp], p = a + b - c, pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);
+                sum += magnitude[(raw[i] - (pa <= pb && pa <= pc ? a : pb <= pc ? b : c)) & 255];
+            }
+            return sum;
+    }
+}
+function requireFields(value, allowed, name) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        fail(name + " must be an object.");
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            fail("unknown " + name + " field.");
+}
+function finite(value, minimum, maximum, message) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < minimum || value > maximum)
+        fail(message);
+    return value;
+}
+/**
+ * Encode an RGB still image as PNG (colour type 2, no interlace). Samples are written unchanged; 16-bit
+ * samples are stored big-endian as PNG requires. Throws `InvalidConfigurationError` for any invalid or
+ * inconsistent field before allocating the scanline buffer.
+ */
+export function serializePngImage(input) {
+    if (input === null || typeof input !== "object")
+        fail("input must be an object.");
+    for (const key of Object.keys(input))
+        if (!["width", "height", "bitDepth", "samples", "colourEncoding", "masteringDisplay", "contentLightLevel", "compression", "filter"].includes(key))
+            fail("unknown input field.");
+    const { width, height, bitDepth, samples } = input;
+    if (![width, height].every((v) => Number.isSafeInteger(v) && v >= 1 && v <= PNG_ENCODER_LIMITS.maximumDimension) || width * height > PNG_ENCODER_LIMITS.maximumPixels)
+        fail("dimensions are out of range.");
+    if (bitDepth !== 8 && bitDepth !== 16)
+        fail("bitDepth must be 8 or 16.");
+    if (bitDepth === 8 ? !(samples instanceof Uint8Array) : !(samples instanceof Uint16Array))
+        fail("samples must be a Uint8Array for 8-bit or a Uint16Array for 16-bit.");
+    if (samples.length !== width * height * 3)
+        fail("samples must hold width x height RGB triples.");
+    const compression = input.compression ?? "fixed-huffman", filter = input.filter ?? "adaptive";
+    if (compression !== "stored" && compression !== "fixed-huffman")
+        fail("unknown compression.");
+    const filters = ["none", "sub", "up", "average", "paeth", "adaptive"];
+    if (!filters.includes(filter))
+        fail("unknown filter.");
+    const colour = input.colourEncoding;
+    if (colour === null || typeof colour !== "object")
+        fail("colourEncoding is required.");
+    const colourFields = typeof colour.kind === "string" && Object.hasOwn(COLOUR_ENCODING_FIELDS, colour.kind) ? COLOUR_ENCODING_FIELDS[colour.kind] : undefined;
+    if (colourFields === undefined)
+        fail("unknown colourEncoding kind.");
+    for (const key of Object.keys(colour))
+        if (!colourFields.includes(key))
+            fail("unknown colourEncoding field.");
+    if (input.masteringDisplay !== undefined)
+        requireFields(input.masteringDisplay, ["redXy", "greenXy", "blueXy", "whiteXy", "maximumLuminanceCdPerSquareMeter", "minimumLuminanceCdPerSquareMeter"], "masteringDisplay");
+    if (input.contentLightLevel !== undefined)
+        requireFields(input.contentLightLevel, ["maximumContentLightLevelCdPerSquareMeter", "maximumFrameAverageLightLevelCdPerSquareMeter"], "contentLightLevel");
+    const chunks = [];
+    const ihdr = new Uint8Array(13), view = new DataView(ihdr.buffer);
+    view.setUint32(0, width);
+    view.setUint32(4, height);
+    ihdr[8] = bitDepth;
+    ihdr[9] = 2; // colour type 2: truecolour
+    chunks.push({ type: "IHDR", data: ihdr });
+    if (colour.kind === "cicp") {
+        const p = PRIMARIES.get(colour.primaries), t = TRANSFER.get(colour.transfer);
+        if (p === undefined || t === undefined || typeof colour.fullRange !== "boolean")
+            fail("unknown cICP primaries or transfer.");
+        // MatrixCoefficients 0 (identity/RGB) is the only value PNG permits.
+        chunks.push({ type: "cICP", data: Uint8Array.of(p, t, 0, colour.fullRange ? 1 : 0) });
+    }
+    else if (colour.kind === "icc") {
+        const name = colour.profileName, profile = colour.profile;
+        if (typeof name !== "string" || !/^[\x20-\x7e\xa1-\xff]{1,79}$/.test(name) || name.startsWith(" ") || name.endsWith(" ") || name.includes("  "))
+            fail("ICC profile name must be 1-79 Latin-1 characters without leading, trailing or repeated spaces.");
+        if (!(profile instanceof Uint8Array) || profile.length < 132 || profile.length > PNG_ENCODER_LIMITS.maximumIccProfileBytes ||
+            new DataView(profile.buffer, profile.byteOffset, profile.byteLength).getUint32(0) !== profile.length)
+            fail("ICC profile must be a complete profile whose header size matches its length.");
+        const compressed = deflateZlib(profile, compression), data = new Uint8Array(name.length + 2 + compressed.length);
+        for (let i = 0; i < name.length; i++)
+            data[i] = name.charCodeAt(i);
+        data.set(compressed, name.length + 2); // NUL separator and compression method 0 are already zero
+        chunks.push({ type: "iCCP", data });
+    }
+    else if (colour.kind === "srgb") {
+        const intent = INTENT.get(colour.renderingIntent);
+        if (intent === undefined)
+            fail("unknown sRGB rendering intent.");
+        // PNG Third Edition Table 17: the only gAMA/cHRM values to accompany sRGB.
+        const gama = new Uint8Array(4);
+        new DataView(gama.buffer).setUint32(0, 45455);
+        const chrm = new Uint8Array(32), c = new DataView(chrm.buffer);
+        [31270, 32900, 64000, 33000, 30000, 60000, 15000, 6000].forEach((v, i) => c.setUint32(i * 4, v));
+        chunks.push({ type: "sRGB", data: Uint8Array.of(intent) }, { type: "gAMA", data: gama }, { type: "cHRM", data: chrm });
+    }
+    else
+        fail("unknown colourEncoding kind.");
+    if ((input.masteringDisplay || input.contentLightLevel) && colour.kind !== "cicp")
+        fail("mDCV and cLLI metadata require a cICP colour encoding.");
+    if (input.masteringDisplay) {
+        const m = input.masteringDisplay, data = new Uint8Array(24), d = new DataView(data.buffer);
+        [m.redXy, m.greenXy, m.blueXy, m.whiteXy].forEach((xy, i) => {
+            if (!Array.isArray(xy) || xy.length !== 2)
+                fail("mastering chromaticities must be [x, y] pairs.");
+            // Stored value = chromaticity / 0.00002, a PNG two-byte unsigned integer.
+            for (let k = 0; k < 2; k++)
+                d.setUint16(i * 4 + k * 2, Math.round(finite(xy[k], 0, 1.3107, "mastering chromaticity must be in 0..1.3107.") * 50000));
+        });
+        const max = finite(m.maximumLuminanceCdPerSquareMeter, 0, 429496.7295, "mastering luminance is out of range."), min = finite(m.minimumLuminanceCdPerSquareMeter, 0, 429496.7295, "mastering luminance is out of range.");
+        if (min >= max)
+            fail("mastering minimum luminance must be below the maximum.");
+        d.setUint32(16, Math.round(max * 10000));
+        d.setUint32(20, Math.round(min * 10000)); // divisor 0.0001 cd/m²
+        chunks.push({ type: "mDCV", data });
+    }
+    if (input.contentLightLevel) {
+        const l = input.contentLightLevel, data = new Uint8Array(8), d = new DataView(data.buffer);
+        const cll = finite(l.maximumContentLightLevelCdPerSquareMeter, 0, 429496.7295, "content light level is out of range."), fall = finite(l.maximumFrameAverageLightLevelCdPerSquareMeter, 0, 429496.7295, "content light level is out of range.");
+        if (cll !== 0 && fall > cll)
+            fail("MaxFALL cannot exceed MaxCLL.");
+        d.setUint32(0, Math.round(cll * 10000));
+        d.setUint32(4, Math.round(fall * 10000));
+        chunks.push({ type: "cLLI", data });
+    }
+    // Scanlines: one filter-type byte then big-endian samples; bpp = bytes per complete pixel.
+    const bpp = bitDepth === 8 ? 3 : 6, rowBytes = width * bpp;
+    let raw = new Uint8Array(rowBytes), prior = new Uint8Array(rowBytes);
+    const filtered = new Uint8Array(height * (rowBytes + 1)), fixedType = filters.indexOf(filter);
+    for (let y = 0; y < height; y++) {
+        const base = y * width * 3;
+        if (bitDepth === 8)
+            raw.set(samples.subarray(base, base + width * 3));
+        else
+            for (let i = 0; i < width * 3; i++) {
+                const v = samples[base + i];
+                raw[i * 2] = v >> 8;
+                raw[i * 2 + 1] = v & 255;
+            }
+        const row = y * (rowBytes + 1) + 1;
+        let type = fixedType;
+        if (filter === "adaptive") {
+            // PNG specification §12.7 heuristic: choose the type with the minimum sum of |signed byte| (ties: lowest type).
+            let best = Infinity;
+            for (let t = 0; t <= 4; t++) {
+                const sum = filterCost(t, raw, prior, rowBytes, bpp);
+                if (sum < best) {
+                    best = sum;
+                    type = t;
+                }
+            }
+        }
+        filtered[row - 1] = type;
+        filterRow(type, raw, prior, filtered.subarray(row, row + rowBytes), rowBytes, bpp);
+        const done = prior;
+        prior = raw;
+        raw = done; // this row is the next row's prior
+    }
+    const idat = deflateZlib(filtered, compression);
+    const out = new ByteSink();
+    out.push(137, 80, 78, 71, 13, 10, 26, 10);
+    const writeChunk = (type, data) => {
+        const typeBytes = Uint8Array.from(type, (ch) => ch.charCodeAt(0));
+        out.u32(data.length);
+        out.append(typeBytes);
+        out.append(data);
+        out.u32(pngCrc32(data, pngCrc32(typeBytes)));
+    };
+    for (const chunk of chunks)
+        writeChunk(chunk.type, chunk.data);
+    for (let i = 0; i < idat.length; i += 1 << 20)
+        writeChunk("IDAT", idat.subarray(i, Math.min(idat.length, i + (1 << 20))));
+    writeChunk("IEND", new Uint8Array(0));
+    return out.result();
+}
+//# sourceMappingURL=png-encoder.js.map

package/dist/output/png-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"png-encoder.js","sourceRoot":"","sources":["../../src/output/png-encoder.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,CAAC,MAAM,cAAc,GAAG,qBAA8B,CAAC;AAC7D,kHAAkH;AAClH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,sBAAsB,EAAE,SAAS,EAAE,CAAC,CAAC;AAuC5I,iHAAiH;AACjH,MAAM,SAAS,GAAgC,IAAI,GAAG,CAA2B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpI,MAAM,QAAQ,GAAgC,IAAI,GAAG,CAA0B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5H,MAAM,MAAM,GAAgC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACxJ,MAAM,sBAAsB,GAAgD,MAAM,CAAC,MAAM,CAAC;IACxF,IAAI,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC;CACjI,CAAC,CAAC;AACH,SAAS,IAAI,CAAC,OAAe,IAAW,MAAM,IAAI,yBAAyB,CAAC,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzG,sDAAsD;AACtD,MAAM,QAAQ;IACZ,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAa;QACnB,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QACrD,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAAC,OAAO,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK;YAAE,IAAI,IAAI,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACzG,CAAC;IACD,IAAI,CAAC,GAAG,MAAgB,IAAU,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvH,MAAM,CAAC,IAAgB,IAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5H,GAAG,CAAC,CAAS,IAAU,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,KAAiB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAClE;AAED,IAAI,QAAiC,CAAC;AACtC,oGAAoG;AACpG,MAAM,UAAU,QAAQ,CAAC,IAAgB,EAAE,OAAO,GAAG,CAAC;IACpD,MAAM,KAAK,GAAG,QAAQ,KAAK,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjL,IAAI,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACnF,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;AAClB,CAAC;AACD,SAAS,OAAO,CAAC,IAAgB;IAC/B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,gEAAgE;QAC7G,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC;YAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAC/C,CAAC,IAAI,KAAK,CAAC;QAAC,CAAC,IAAI,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACxI,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7G,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACjK,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACtH,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B,wHAAwH;AACxH,SAAS,WAAW,CAAC,IAAY,EAAE,MAAc,IAAY,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;IAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAUtJ,IAAI,WAA2C,CAAC;AAChD,gGAAgG;AAChG,SAAS,kBAAkB;IACzB,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5E,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QAChK,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5E,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAC1E,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;QACpD,OAAO,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,MAAM;YAAE,CAAC,EAAE,CAAC,CAAC,0CAA0C;QAC/F,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,MAAM,CAAE,CAAC;QACpD,UAAU,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAE,GAAG,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC,IAAI,IAAI,CAAC,CAAC;QAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IACjI,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,WAAW,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,UAAU,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAC5G,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,cAAc,EAAE,QAAQ,EAAE,EAAE,CAAC;QACrE,OAAO,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,QAAQ;YAAE,CAAC,EAAE,CAAC;QACpD,YAAY,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;IAC9H,CAAC;IACD,WAAW,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IAC/F,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,IAAgC;IAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,4GAA4G;IAC5G,uGAAuG;IACvG,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvH,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IACrC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QAAC,CAAC;QACpG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;YAC1I,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YAAC,GAAG,IAAI,GAAG,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAC9G,+FAA+F;QAC/F,IAAI,WAAW,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,yCAAyC;QAC5E,MAAM,MAAM,GAAG,cAAc,EAAE,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACtI,+GAA+G;QAC/G,gHAAgH;QAChH,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,gDAAgD;QACtE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;YACvB,IAAI,UAAU,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;gBACf,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,GAAG,MAAM,CAAC;gBACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACnC,KAAK,IAAI,SAAS,GAAG,IAAI,CAAC,CAAC,CAAE,EAAE,MAAM,GAAG,CAAC,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,IAAI,MAAM,IAAI,MAAM,GAAG,EAAE,EAAE,SAAS,GAAG,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAE,EAAE,MAAM,EAAE,EAAE,CAAC;oBACvJ,IAAI,SAAS,IAAI,CAAC;wBAAE,MAAM;oBAC1B,uFAAuF;oBACvF,IAAI,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC;wBAAE,SAAS;oBACpE,IAAI,MAAM,GAAG,CAAC,CAAC;oBAAC,OAAO,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;wBAAE,MAAM,EAAE,CAAC;oBACjG,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;wBAAC,UAAU,GAAG,MAAM,CAAC;wBAAC,YAAY,GAAG,CAAC,GAAG,SAAS,CAAC;wBAAC,IAAI,MAAM,KAAK,KAAK;4BAAE,MAAM;oBAAC,CAAC;gBAC9G,CAAC;gBACD,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;gBAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;gBACpB,WAAW,IAAI,UAAU,CAAC,UAAU,CAAE,IAAI,IAAI,CAAC;gBAAC,IAAI,IAAI,UAAU,CAAC,UAAU,CAAE,CAAC;gBAChF,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;oBAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC;oBAAC,WAAW,MAAM,CAAC,CAAC;oBAAC,IAAI,IAAI,CAAC,CAAC;gBAAC,CAAC;gBACpF,WAAW,IAAI,YAAY,CAAC,YAAY,CAAE,IAAI,IAAI,CAAC;gBAAC,IAAI,IAAI,YAAY,CAAC,YAAY,CAAE,CAAC;gBACxF,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC;gBAC3B,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBACvB,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;wBAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,GAAG,MAAM,CAAC;wBAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;wBAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAAC,CAAC;gBACzG,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAE,CAAC;gBAC1B,WAAW,IAAI,WAAW,CAAC,MAAM,CAAE,IAAI,IAAI,CAAC;gBAAC,IAAI,IAAI,WAAW,CAAC,MAAM,CAAE,CAAC;YAC5E,CAAC;YACD,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;gBAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC;gBAAC,WAAW,MAAM,CAAC,CAAC;gBAAC,IAAI,IAAI,CAAC,CAAC;YAAC,CAAC;QACtF,CAAC;QACD,WAAW,IAAI,WAAW,CAAC,GAAG,CAAE,IAAI,IAAI,CAAC;QAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAE,CAAC;QACpE,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC;YAAC,WAAW,MAAM,CAAC,CAAC;YAAC,IAAI,IAAI,CAAC,CAAC;QAAC,CAAC,CAAC,uBAAuB;IAC7G,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;IAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC;IAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC;IAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;IACzH,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,qGAAqG;AACrG,SAAS,SAAS,CAAC,IAAY,EAAE,GAAe,EAAE,KAAiB,EAAE,MAAkB,EAAE,QAAgB,EAAE,GAAW;IACpH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;YAAC,OAAO;QACtD,KAAK,CAAC;YACJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;YACnD,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,CAAC,GAAG,GAAG,CAAC;YACjF,OAAO;QACT,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAC;YAAC,OAAO;QAC3F,KAAK,CAAC;YACJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAC9E,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YACtG,OAAO;QACT;YACE,sDAAsD;YACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAC;YACvE,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,GAAG,CAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7I,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAC9E,CAAC;IACL,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,qBAAqB,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAElG,iHAAiH;AACjH,SAAS,UAAU,CAAC,IAAY,EAAE,GAAe,EAAE,KAAiB,EAAE,QAAgB,EAAE,GAAW;IACjG,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,qBAAqB,CAAC;IACxE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAE,CAAE,CAAC;YAAC,OAAO,GAAG,CAAC;QAClF,KAAK,CAAC;YACJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAE,CAAE,CAAC;YAC1D,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,CAAC,GAAG,GAAG,CAAE,CAAC;YACxF,OAAO,GAAG,CAAC;QACb,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAE,CAAC;YAAC,OAAO,GAAG,CAAC;QACtG,KAAK,CAAC;YACJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAE,CAAC;YACrF,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAE,CAAC;YAC7G,OAAO,GAAG,CAAC;QACb;YACE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAE,CAAC;YAC9E,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,GAAG,CAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7I,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAE,CAAC;YACrF,CAAC;YACD,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,OAA0B,EAAE,IAAY;IAC7E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,CAAC;IAC5G,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,OAAe,EAAE,OAAe,EAAE,OAAe;IAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG,OAAO;QAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9G,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAClF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtN,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IACnD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,gBAAgB,CAAC,IAAI,KAAK,GAAG,MAAM,GAAG,kBAAkB,CAAC,aAAa;QAAE,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5M,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,EAAE;QAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzE,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,YAAY,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,YAAY,WAAW,CAAC;QAAE,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACvK,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,GAAG,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,+CAA+C,CAAC,CAAC;IACjG,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,eAAe,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC;IAC9F,IAAI,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,eAAe;QAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;IAC/E,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACvF,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9J,IAAI,YAAY,KAAK,SAAS;QAAE,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9G,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS;QAAE,aAAa,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,kCAAkC,EAAE,kCAAkC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACvN,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS;QAAE,aAAa,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,0CAA0C,EAAE,+CAA+C,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAEtM,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,4BAA4B;IAClH,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAC7H,qEAAqE;QACrE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,gGAAgG,CAAC,CAAC;QACxP,IAAI,CAAC,CAAC,OAAO,YAAY,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,kBAAkB,CAAC,sBAAsB;YACxH,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC7L,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACjH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0DAA0D;QACjG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACjE,2EAA2E;QAC3E,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzH,CAAC;;QAAM,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAClJ,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,gBAAgB,EAAE,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;YAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAClG,0EAA0E;YAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAAE,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,MAAM,EAAE,8CAA8C,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QACxJ,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,gCAAgC,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,gCAAgC,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,CAAC,CAAC;QACzN,IAAI,GAAG,IAAI,GAAG;YAAE,IAAI,CAAC,wDAAwD,CAAC,CAAC;QAC/E,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;QAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAC3G,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,iBAAiB,EAAE,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3F,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,wCAAwC,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,6CAA6C,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,CAAC,CAAC;QAC/O,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG;YAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACnE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;QAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,2FAA2F;IAC3F,MAAM,GAAG,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,GAAG,CAAC;IAC3D,IAAI,GAAG,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAC3B,IAAI,QAAQ,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,CAAE,OAAsB,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;;YACjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAE,CAAC;gBAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YAAC,CAAC;QACzH,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,gHAAgH;YAChH,IAAI,IAAI,GAAG,QAAQ,CAAC;YACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;gBACrD,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;oBAAC,IAAI,GAAG,GAAG,CAAC;oBAAC,IAAI,GAAG,CAAC,CAAC;gBAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7G,MAAM,IAAI,GAAG,KAAK,CAAC;QAAC,KAAK,GAAG,GAAG,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,CAAC,mCAAmC;IAClF,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC3B,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,IAAgB,EAAQ,EAAE;QAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1H,UAAU,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;AACtB,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Browser-safe PNG still-image encoder for 8- and 16-bit RGB, with explicit colour signalling for wide-gamut\n * and HDR output. Independently written from the W3C PNG Specification (Third Edition, W3C Recommendation\n * 24 June 2025), RFC 1950 (zlib) and RFC 1951 (DEFLATE); no third-party encoder source and no dependency.\n *\n * - Colour: exactly one of an sRGB chunk (plus the gAMA/cHRM compatibility values the PNG specification\n *   lists), an iCCP embedded ICC profile, or a cICP chunk with ITU-T H.273 code points (BT.709/sRGB,\n *   Display P3, BT.2020 primaries; sRGB, BT.709 or linear transfer). PQ and HLG code points are not written:\n *   those transfer functions are not part of 2.0 (see THIRD_PARTY.md).\n * - Static display metadata: mDCV (mastering display colour volume) and cLLI (MaxCLL/MaxFALL), only with cICP,\n *   as defined in the W3C PNG Third Edition and ITU-T H.265 Annex D (also SMPTE ST 2086 and CTA-861.3). The\n *   PNG specification allows mDCV with SDR encodings too, so both stay available for the remaining code points.\n * - Compression: zlib with stored or fixed-Huffman DEFLATE blocks and a bounded greedy LZ77 matcher.\n *   Output bytes are a pure function of the input; no platform CompressionStream is used.\n *\n * The encoder writes the caller's integer code values unchanged. Converting linear light to an encoded\n * signal (for example sRGB) and choosing a gamut mapping is the caller's job.\n * @see docs/IMPORT_AND_PNG.md for chunk layouts, code points and limits.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nexport const PNG_ENCODER_ID = \"photivra-png-rgb-v1\" as const;\n/** Limits, checked before allocation. 100 MP (megapixels) of 16-bit RGB is about 600 MB of filtered scanlines. */\nexport const PNG_ENCODER_LIMITS = Object.freeze({ maximumDimension: 65535, maximumPixels: 100_000_000, maximumIccProfileBytes: 4_000_000 });\n\n/** ITU-T H.273 ColourPrimaries: bt709 = 1 (also sRGB), display-p3 = 12 (P3 primaries with D65 white; W3C CSS Color 4, also SMPTE EG 432-1), bt2020 = 9 (BT.2020). */\nexport type PngCicpPrimaries = \"bt709\" | \"display-p3\" | \"bt2020\";\n/** ITU-T H.273 TransferCharacteristics: bt709 = 1, linear = 8, srgb = 13 (sRGB). PQ (16) and HLG (18) are not offered in 2.0. */\nexport type PngCicpTransfer = \"bt709\" | \"linear\" | \"srgb\";\nexport type PngColourEncoding =\n  | { kind: \"srgb\"; renderingIntent: \"perceptual\" | \"relative-colorimetric\" | \"saturation\" | \"absolute-colorimetric\" }\n  | { kind: \"icc\"; profileName: string; profile: Uint8Array }\n  | { kind: \"cicp\"; primaries: PngCicpPrimaries; transfer: PngCicpTransfer; fullRange: boolean };\n/** Mastering display colour volume (W3C PNG mDCV; ITU-T H.265 Annex D SEI; also SMPTE ST 2086): CIE 1931 xy chromaticities and luminance in cd/m². */\nexport interface PngMasteringDisplay {\n  redXy: readonly [number, number];\n  greenXy: readonly [number, number];\n  blueXy: readonly [number, number];\n  whiteXy: readonly [number, number];\n  maximumLuminanceCdPerSquareMeter: number;\n  minimumLuminanceCdPerSquareMeter: number;\n}\n/** Content light level in cd/m² (W3C PNG cLLI; ITU-T H.265 content light level SEI; also CTA-861.3); 0 means unknown. */\nexport interface PngContentLightLevel {\n  maximumContentLightLevelCdPerSquareMeter: number;\n  maximumFrameAverageLightLevelCdPerSquareMeter: number;\n}\nexport interface PngEncodeInput {\n  width: number;\n  height: number;\n  bitDepth: 8 | 16;\n  /** Interleaved RGB code values, row-major; Uint8Array for 8-bit, Uint16Array for 16-bit. */\n  samples: Uint8Array | Uint16Array;\n  colourEncoding: PngColourEncoding;\n  masteringDisplay?: PngMasteringDisplay;\n  contentLightLevel?: PngContentLightLevel;\n  /** Default \"fixed-huffman\". */\n  compression?: \"stored\" | \"fixed-huffman\";\n  /** PNG filter type 0..4 for every row, or the specification's minimum-sum-of-absolute-differences heuristic. Default \"adaptive\". */\n  filter?: \"none\" | \"sub\" | \"up\" | \"average\" | \"paeth\" | \"adaptive\";\n}\n\n// Maps, not plain objects: a lookup must never reach Object.prototype names such as \"constructor\" or \"toString\".\nconst PRIMARIES: ReadonlyMap<string, number> = new Map<PngCicpPrimaries, number>([[\"bt709\", 1], [\"display-p3\", 12], [\"bt2020\", 9]]);\nconst TRANSFER: ReadonlyMap<string, number> = new Map<PngCicpTransfer, number>([[\"bt709\", 1], [\"linear\", 8], [\"srgb\", 13]]);\nconst INTENT: ReadonlyMap<string, number> = new Map([[\"perceptual\", 0], [\"relative-colorimetric\", 1], [\"saturation\", 2], [\"absolute-colorimetric\", 3]]);\nconst COLOUR_ENCODING_FIELDS: Readonly<Record<string, readonly string[]>> = Object.freeze({\n  srgb: [\"kind\", \"renderingIntent\"], icc: [\"kind\", \"profileName\", \"profile\"], cicp: [\"kind\", \"primaries\", \"transfer\", \"fullRange\"]\n});\nfunction fail(message: string): never { throw new InvalidConfigurationError(\"PNG encoder: \" + message); }\n\n/** Growable byte sink; doubles capacity as needed. */\nclass ByteSink {\n  bytes = new Uint8Array(1 << 16); length = 0;\n  reserve(count: number): void {\n    if (this.length + count <= this.bytes.length) return;\n    let size = this.bytes.length * 2; while (size < this.length + count) size *= 2;\n    const grown = new Uint8Array(size); grown.set(this.bytes.subarray(0, this.length)); this.bytes = grown;\n  }\n  push(...values: number[]): void { this.reserve(values.length); for (const v of values) this.bytes[this.length++] = v; }\n  append(data: Uint8Array): void { this.reserve(data.length); this.bytes.set(data, this.length); this.length += data.length; }\n  u32(v: number): void { this.push(v >>> 24, (v >>> 16) & 255, (v >>> 8) & 255, v & 255); }\n  result(): Uint8Array { return this.bytes.slice(0, this.length); }\n}\n\nlet crcTable: Uint32Array | undefined;\n/** CRC-32 (ISO 3309 / ITU-T V.42 polynomial 0xEDB88320, reflected), as specified for PNG chunks. */\nexport function pngCrc32(data: Uint8Array, initial = 0): number {\n  const table = crcTable ??= Uint32Array.from({ length: 256 }, (_, n) => { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; return c >>> 0; });\n  let c = ~initial >>> 0;\n  for (let i = 0; i < data.length; i++) c = table[(c ^ data[i]!) & 255]! ^ (c >>> 8);\n  return ~c >>> 0;\n}\nfunction adler32(data: Uint8Array): number {\n  let a = 1, b = 0;\n  for (let i = 0; i < data.length;) {\n    const end = Math.min(data.length, i + 5552); // largest run that cannot overflow before the modulo (RFC 1950)\n    for (; i < end; i++) { a += data[i]!; b += a; }\n    a %= 65521; b %= 65521;\n  }\n  return ((b << 16) | a) >>> 0;\n}\n\nconst LENGTH_BASE = [3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15, 17, 19, 23, 27, 31, 35, 43, 51, 59, 67, 83, 99, 115, 131, 163, 195, 227, 258];\nconst LENGTH_EXTRA = [0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0];\nconst DIST_BASE = [1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193, 257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145, 8193, 12289, 16385, 24577];\nconst DIST_EXTRA = [0, 0, 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13];\nconst DEFLATE_WINDOW = 32768;\n\n/** Huffman codes are defined MSB-first (RFC 1951 §3.1.1); the stream is LSB-first, so codes are stored bit-reversed. */\nfunction reverseBits(code: number, length: number): number { let r = 0; for (let i = 0; i < length; i++) r = (r << 1) | ((code >> i) & 1); return r; }\n\ninterface FixedHuffmanTables {\n  /** Bit-reversed RFC 1951 §3.2.6 fixed literal/length codes and their lengths, symbols 0–287. */\n  literalCode: Uint16Array; literalBits: Uint8Array;\n  /** Per match length 3–258: reversed length code with its extra bits appended, and the total bit count. */\n  lengthCode: Uint16Array; lengthBits: Uint8Array;\n  /** Per distance 1–32768: reversed 5-bit distance code with its extra bits appended, and the total bit count. */\n  distanceCode: Uint32Array; distanceBits: Uint8Array;\n}\nlet fixedTables: FixedHuffmanTables | undefined;\n/** Built once: the same codes the per-symbol definition gives, precomputed and pre-reversed. */\nfunction fixedHuffmanTables(): FixedHuffmanTables {\n  if (fixedTables) return fixedTables;\n  const literalCode = new Uint16Array(288), literalBits = new Uint8Array(288);\n  for (let symbol = 0; symbol < 288; symbol++) {\n    const [code, bits] = symbol < 144 ? [0x30 + symbol, 8] : symbol < 256 ? [0x190 + symbol - 144, 9] : symbol < 280 ? [symbol - 256, 7] : [0xc0 + symbol - 280, 8];\n    literalCode[symbol] = reverseBits(code, bits); literalBits[symbol] = bits;\n  }\n  const lengthCode = new Uint16Array(259), lengthBits = new Uint8Array(259);\n  for (let length = 3, l = 0; length <= 258; length++) {\n    while (l < 28 && LENGTH_BASE[l + 1]! <= length) l++; // largest l with LENGTH_BASE[l] <= length\n    const symbol = 257 + l, bits = literalBits[symbol]!;\n    lengthCode[length] = literalCode[symbol]! | ((length - LENGTH_BASE[l]!) << bits); lengthBits[length] = bits + LENGTH_EXTRA[l]!;\n  }\n  const distanceCode = new Uint32Array(DEFLATE_WINDOW + 1), distanceBits = new Uint8Array(DEFLATE_WINDOW + 1);\n  for (let distance = 1, d = 0; distance <= DEFLATE_WINDOW; distance++) {\n    while (d < 29 && DIST_BASE[d + 1]! <= distance) d++;\n    distanceCode[distance] = reverseBits(d, 5) | ((distance - DIST_BASE[d]!) << 5); distanceBits[distance] = 5 + DIST_EXTRA[d]!;\n  }\n  fixedTables = { literalCode, literalBits, lengthCode, lengthBits, distanceCode, distanceBits };\n  return fixedTables;\n}\n\n/**\n * zlib stream (RFC 1950: CMF 0x78 = deflate with 32 KiB window, FLG 0x01, Adler-32 trailer) holding stored\n * blocks or one fixed-Huffman block. LZ77 is greedy with a 3-byte hash and at most 64 chain probes.\n */\nexport function deflateZlib(data: Uint8Array, mode: \"stored\" | \"fixed-huffman\"): Uint8Array {\n  const n = data.length;\n  // Exact upper bound: a fixed-Huffman literal is at most 9 bits and a match of length L >= 3 at most 25 bits\n  // per 3 bytes, so the block needs at most 9 bits per input byte plus 3 header and 7 end-of-block bits.\n  const capacity = 2 + 4 + (mode === \"stored\" ? n + 5 * Math.max(1, Math.ceil(n / 65535)) : Math.ceil((9 * n + 10) / 8));\n  const out = new Uint8Array(capacity);\n  let pos = 0;\n  out[pos++] = 0x78; out[pos++] = 0x01;\n  if (mode === \"stored\") {\n    if (n === 0) { out[pos++] = 1; out[pos++] = 0; out[pos++] = 0; out[pos++] = 255; out[pos++] = 255; }\n    for (let i = 0; i < n; i += 65535) {\n      const len = Math.min(65535, n - i);\n      out[pos++] = i + len >= n ? 1 : 0; out[pos++] = len & 255; out[pos++] = len >> 8; out[pos++] = ~len & 255; out[pos++] = (~len >> 8) & 255;\n      out.set(data.subarray(i, i + len), pos); pos += len;\n    }\n  } else {\n    const { literalCode, literalBits, lengthCode, lengthBits, distanceCode, distanceBits } = fixedHuffmanTables();\n    // LSB-first bit accumulator; at most 7 bits stay pending, and no single write exceeds 18 bits.\n    let accumulator = 0b011, bits = 3; // BFINAL = 1, BTYPE = 01 (fixed Huffman)\n    const window = DEFLATE_WINDOW, mask = window - 1, head = new Int32Array(1 << 15).fill(-1), previous = new Int32Array(window).fill(-1);\n    // Hash of the 3 bytes at i: ((data[i] << 10) ^ (data[i + 1] << 5) ^ data[i + 2]) & 0x7fff. It rolls exactly as\n    // h(i + 1) = ((h(i) << 5) ^ data[i + 3]) & 0x7fff, because the mask drops every bit of data[i] after the shift.\n    const hashed = n - 2; // positions i < hashed have three bytes to hash\n    let h = n >= 2 ? ((data[0]! << 5) ^ data[1]!) & 0x7fff : 0;\n    for (let i = 0; i < n;) {\n      let bestLength = 0, bestDistance = 0;\n      if (i < hashed) {\n        h = ((h << 5) ^ data[i + 2]!) & 0x7fff;\n        const limit = Math.min(258, n - i);\n        for (let candidate = head[h]!, probes = 0; candidate >= 0 && i - candidate <= window && probes < 64; candidate = previous[candidate & mask]!, probes++) {\n          if (candidate >= i) break;\n          // A candidate that differs at index bestLength cannot be longer than the current best.\n          if (data[candidate + bestLength] !== data[i + bestLength]) continue;\n          let length = 0; while (length < limit && data[candidate + length] === data[i + length]) length++;\n          if (length > bestLength) { bestLength = length; bestDistance = i - candidate; if (length === limit) break; }\n        }\n        previous[i & mask] = head[h]!; head[h] = i;\n      }\n      if (bestLength >= 3) {\n        accumulator |= lengthCode[bestLength]! << bits; bits += lengthBits[bestLength]!;\n        while (bits >= 8) { out[pos++] = accumulator & 255; accumulator >>>= 8; bits -= 8; }\n        accumulator |= distanceCode[bestDistance]! << bits; bits += distanceBits[bestDistance]!;\n        const end = i + bestLength;\n        for (i++; i < end; i++) {\n          if (i < hashed) { h = ((h << 5) ^ data[i + 2]!) & 0x7fff; previous[i & mask] = head[h]!; head[h] = i; }\n        }\n      } else {\n        const symbol = data[i++]!;\n        accumulator |= literalCode[symbol]! << bits; bits += literalBits[symbol]!;\n      }\n      while (bits >= 8) { out[pos++] = accumulator & 255; accumulator >>>= 8; bits -= 8; }\n    }\n    accumulator |= literalCode[256]! << bits; bits += literalBits[256]!;\n    while (bits > 0) { out[pos++] = accumulator & 255; accumulator >>>= 8; bits -= 8; } // flush and byte-align\n  }\n  const adler = adler32(data);\n  out[pos++] = adler >>> 24; out[pos++] = (adler >>> 16) & 255; out[pos++] = (adler >>> 8) & 255; out[pos++] = adler & 255;\n  return out.slice(0, pos);\n}\n\n/** Writes PNG filter `type` (0–4, PNG specification §9.2) of `raw` against `prior` into `target`. */\nfunction filterRow(type: number, raw: Uint8Array, prior: Uint8Array, target: Uint8Array, rowBytes: number, bpp: number): void {\n  const head = Math.min(bpp, rowBytes);\n  switch (type) {\n    case 0: target.set(raw.subarray(0, rowBytes)); return;\n    case 1:\n      for (let i = 0; i < head; i++) target[i] = raw[i]!;\n      for (let i = bpp; i < rowBytes; i++) target[i] = (raw[i]! - raw[i - bpp]!) & 255;\n      return;\n    case 2: for (let i = 0; i < rowBytes; i++) target[i] = (raw[i]! - prior[i]!) & 255; return;\n    case 3:\n      for (let i = 0; i < head; i++) target[i] = (raw[i]! - (prior[i]! >> 1)) & 255;\n      for (let i = bpp; i < rowBytes; i++) target[i] = (raw[i]! - ((raw[i - bpp]! + prior[i]!) >> 1)) & 255;\n      return;\n    default:\n      // Paeth with a = c = 0 in the first pixel predicts b.\n      for (let i = 0; i < head; i++) target[i] = (raw[i]! - prior[i]!) & 255;\n      for (let i = bpp; i < rowBytes; i++) {\n        const a = raw[i - bpp]!, b = prior[i]!, c = prior[i - bpp]!, p = a + b - c, pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);\n        target[i] = (raw[i]! - (pa <= pb && pa <= pc ? a : pb <= pc ? b : c)) & 255;\n      }\n  }\n}\n\n/** |v| of a filtered byte v read as a signed byte (two's complement), for the §12.7 heuristic. */\nconst SIGNED_BYTE_MAGNITUDE = Uint8Array.from({ length: 256 }, (_, v) => (v < 128 ? v : 256 - v));\n\n/** Sum of |signed byte| of filter `type` applied to a row (PNG specification §12.7), without writing the row. */\nfunction filterCost(type: number, raw: Uint8Array, prior: Uint8Array, rowBytes: number, bpp: number): number {\n  const head = Math.min(bpp, rowBytes), magnitude = SIGNED_BYTE_MAGNITUDE;\n  let sum = 0;\n  switch (type) {\n    case 0: for (let i = 0; i < rowBytes; i++) sum += magnitude[raw[i]!]!; return sum;\n    case 1:\n      for (let i = 0; i < head; i++) sum += magnitude[raw[i]!]!;\n      for (let i = bpp; i < rowBytes; i++) sum += magnitude[(raw[i]! - raw[i - bpp]!) & 255]!;\n      return sum;\n    case 2: for (let i = 0; i < rowBytes; i++) sum += magnitude[(raw[i]! - prior[i]!) & 255]!; return sum;\n    case 3:\n      for (let i = 0; i < head; i++) sum += magnitude[(raw[i]! - (prior[i]! >> 1)) & 255]!;\n      for (let i = bpp; i < rowBytes; i++) sum += magnitude[(raw[i]! - ((raw[i - bpp]! + prior[i]!) >> 1)) & 255]!;\n      return sum;\n    default:\n      for (let i = 0; i < head; i++) sum += magnitude[(raw[i]! - prior[i]!) & 255]!;\n      for (let i = bpp; i < rowBytes; i++) {\n        const a = raw[i - bpp]!, b = prior[i]!, c = prior[i - bpp]!, p = a + b - c, pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);\n        sum += magnitude[(raw[i]! - (pa <= pb && pa <= pc ? a : pb <= pc ? b : c)) & 255]!;\n      }\n      return sum;\n  }\n}\n\nfunction requireFields(value: unknown, allowed: readonly string[], name: string): void {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) fail(name + \" must be an object.\");\n  for (const key of Object.keys(value)) if (!allowed.includes(key)) fail(\"unknown \" + name + \" field.\");\n}\n\nfunction finite(value: number, minimum: number, maximum: number, message: string): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < minimum || value > maximum) fail(message);\n  return value;\n}\n\n/**\n * Encode an RGB still image as PNG (colour type 2, no interlace). Samples are written unchanged; 16-bit\n * samples are stored big-endian as PNG requires. Throws `InvalidConfigurationError` for any invalid or\n * inconsistent field before allocating the scanline buffer.\n */\nexport function serializePngImage(input: PngEncodeInput): Uint8Array {\n  if (input === null || typeof input !== \"object\") fail(\"input must be an object.\");\n  for (const key of Object.keys(input)) if (![\"width\", \"height\", \"bitDepth\", \"samples\", \"colourEncoding\", \"masteringDisplay\", \"contentLightLevel\", \"compression\", \"filter\"].includes(key)) fail(\"unknown input field.\");\n  const { width, height, bitDepth, samples } = input;\n  if (![width, height].every((v) => Number.isSafeInteger(v) && v >= 1 && v <= PNG_ENCODER_LIMITS.maximumDimension) || width * height > PNG_ENCODER_LIMITS.maximumPixels) fail(\"dimensions are out of range.\");\n  if (bitDepth !== 8 && bitDepth !== 16) fail(\"bitDepth must be 8 or 16.\");\n  if (bitDepth === 8 ? !(samples instanceof Uint8Array) : !(samples instanceof Uint16Array)) fail(\"samples must be a Uint8Array for 8-bit or a Uint16Array for 16-bit.\");\n  if (samples.length !== width * height * 3) fail(\"samples must hold width x height RGB triples.\");\n  const compression = input.compression ?? \"fixed-huffman\", filter = input.filter ?? \"adaptive\";\n  if (compression !== \"stored\" && compression !== \"fixed-huffman\") fail(\"unknown compression.\");\n  const filters = [\"none\", \"sub\", \"up\", \"average\", \"paeth\", \"adaptive\"] as const;\n  if (!filters.includes(filter)) fail(\"unknown filter.\");\n  const colour = input.colourEncoding;\n  if (colour === null || typeof colour !== \"object\") fail(\"colourEncoding is required.\");\n  const colourFields = typeof colour.kind === \"string\" && Object.hasOwn(COLOUR_ENCODING_FIELDS, colour.kind) ? COLOUR_ENCODING_FIELDS[colour.kind]! : undefined;\n  if (colourFields === undefined) fail(\"unknown colourEncoding kind.\");\n  for (const key of Object.keys(colour)) if (!colourFields.includes(key)) fail(\"unknown colourEncoding field.\");\n  if (input.masteringDisplay !== undefined) requireFields(input.masteringDisplay, [\"redXy\", \"greenXy\", \"blueXy\", \"whiteXy\", \"maximumLuminanceCdPerSquareMeter\", \"minimumLuminanceCdPerSquareMeter\"], \"masteringDisplay\");\n  if (input.contentLightLevel !== undefined) requireFields(input.contentLightLevel, [\"maximumContentLightLevelCdPerSquareMeter\", \"maximumFrameAverageLightLevelCdPerSquareMeter\"], \"contentLightLevel\");\n\n  const chunks: { type: string; data: Uint8Array }[] = [];\n  const ihdr = new Uint8Array(13), view = new DataView(ihdr.buffer);\n  view.setUint32(0, width); view.setUint32(4, height); ihdr[8] = bitDepth; ihdr[9] = 2; // colour type 2: truecolour\n  chunks.push({ type: \"IHDR\", data: ihdr });\n  if (colour.kind === \"cicp\") {\n    const p = PRIMARIES.get(colour.primaries), t = TRANSFER.get(colour.transfer);\n    if (p === undefined || t === undefined || typeof colour.fullRange !== \"boolean\") fail(\"unknown cICP primaries or transfer.\");\n    // MatrixCoefficients 0 (identity/RGB) is the only value PNG permits.\n    chunks.push({ type: \"cICP\", data: Uint8Array.of(p, t, 0, colour.fullRange ? 1 : 0) });\n  } else if (colour.kind === \"icc\") {\n    const name = colour.profileName, profile = colour.profile;\n    if (typeof name !== \"string\" || !/^[\\x20-\\x7e\\xa1-\\xff]{1,79}$/.test(name) || name.startsWith(\" \") || name.endsWith(\" \") || name.includes(\"  \")) fail(\"ICC profile name must be 1-79 Latin-1 characters without leading, trailing or repeated spaces.\");\n    if (!(profile instanceof Uint8Array) || profile.length < 132 || profile.length > PNG_ENCODER_LIMITS.maximumIccProfileBytes ||\n      new DataView(profile.buffer, profile.byteOffset, profile.byteLength).getUint32(0) !== profile.length) fail(\"ICC profile must be a complete profile whose header size matches its length.\");\n    const compressed = deflateZlib(profile, compression), data = new Uint8Array(name.length + 2 + compressed.length);\n    for (let i = 0; i < name.length; i++) data[i] = name.charCodeAt(i);\n    data.set(compressed, name.length + 2); // NUL separator and compression method 0 are already zero\n    chunks.push({ type: \"iCCP\", data });\n  } else if (colour.kind === \"srgb\") {\n    const intent = INTENT.get(colour.renderingIntent);\n    if (intent === undefined) fail(\"unknown sRGB rendering intent.\");\n    // PNG Third Edition Table 17: the only gAMA/cHRM values to accompany sRGB.\n    const gama = new Uint8Array(4); new DataView(gama.buffer).setUint32(0, 45455);\n    const chrm = new Uint8Array(32), c = new DataView(chrm.buffer);\n    [31270, 32900, 64000, 33000, 30000, 60000, 15000, 6000].forEach((v, i) => c.setUint32(i * 4, v));\n    chunks.push({ type: \"sRGB\", data: Uint8Array.of(intent) }, { type: \"gAMA\", data: gama }, { type: \"cHRM\", data: chrm });\n  } else fail(\"unknown colourEncoding kind.\");\n  if ((input.masteringDisplay || input.contentLightLevel) && colour.kind !== \"cicp\") fail(\"mDCV and cLLI metadata require a cICP colour encoding.\");\n  if (input.masteringDisplay) {\n    const m = input.masteringDisplay, data = new Uint8Array(24), d = new DataView(data.buffer);\n    [m.redXy, m.greenXy, m.blueXy, m.whiteXy].forEach((xy, i) => {\n      if (!Array.isArray(xy) || xy.length !== 2) fail(\"mastering chromaticities must be [x, y] pairs.\");\n      // Stored value = chromaticity / 0.00002, a PNG two-byte unsigned integer.\n      for (let k = 0; k < 2; k++) d.setUint16(i * 4 + k * 2, Math.round(finite(xy[k]!, 0, 1.3107, \"mastering chromaticity must be in 0..1.3107.\") * 50000));\n    });\n    const max = finite(m.maximumLuminanceCdPerSquareMeter, 0, 429496.7295, \"mastering luminance is out of range.\"), min = finite(m.minimumLuminanceCdPerSquareMeter, 0, 429496.7295, \"mastering luminance is out of range.\");\n    if (min >= max) fail(\"mastering minimum luminance must be below the maximum.\");\n    d.setUint32(16, Math.round(max * 10000)); d.setUint32(20, Math.round(min * 10000)); // divisor 0.0001 cd/m²\n    chunks.push({ type: \"mDCV\", data });\n  }\n  if (input.contentLightLevel) {\n    const l = input.contentLightLevel, data = new Uint8Array(8), d = new DataView(data.buffer);\n    const cll = finite(l.maximumContentLightLevelCdPerSquareMeter, 0, 429496.7295, \"content light level is out of range.\"), fall = finite(l.maximumFrameAverageLightLevelCdPerSquareMeter, 0, 429496.7295, \"content light level is out of range.\");\n    if (cll !== 0 && fall > cll) fail(\"MaxFALL cannot exceed MaxCLL.\");\n    d.setUint32(0, Math.round(cll * 10000)); d.setUint32(4, Math.round(fall * 10000));\n    chunks.push({ type: \"cLLI\", data });\n  }\n\n  // Scanlines: one filter-type byte then big-endian samples; bpp = bytes per complete pixel.\n  const bpp = bitDepth === 8 ? 3 : 6, rowBytes = width * bpp;\n  let raw = new Uint8Array(rowBytes), prior = new Uint8Array(rowBytes);\n  const filtered = new Uint8Array(height * (rowBytes + 1)), fixedType = filters.indexOf(filter);\n  for (let y = 0; y < height; y++) {\n    const base = y * width * 3;\n    if (bitDepth === 8) raw.set((samples as Uint8Array).subarray(base, base + width * 3));\n    else for (let i = 0; i < width * 3; i++) { const v = samples[base + i]!; raw[i * 2] = v >> 8; raw[i * 2 + 1] = v & 255; }\n    const row = y * (rowBytes + 1) + 1;\n    let type = fixedType;\n    if (filter === \"adaptive\") {\n      // PNG specification §12.7 heuristic: choose the type with the minimum sum of |signed byte| (ties: lowest type).\n      let best = Infinity;\n      for (let t = 0; t <= 4; t++) {\n        const sum = filterCost(t, raw, prior, rowBytes, bpp);\n        if (sum < best) { best = sum; type = t; }\n      }\n    }\n    filtered[row - 1] = type; filterRow(type, raw, prior, filtered.subarray(row, row + rowBytes), rowBytes, bpp);\n    const done = prior; prior = raw; raw = done; // this row is the next row's prior\n  }\n  const idat = deflateZlib(filtered, compression);\n\n  const out = new ByteSink();\n  out.push(137, 80, 78, 71, 13, 10, 26, 10);\n  const writeChunk = (type: string, data: Uint8Array): void => {\n    const typeBytes = Uint8Array.from(type, (ch) => ch.charCodeAt(0));\n    out.u32(data.length); out.append(typeBytes); out.append(data);\n    out.u32(pngCrc32(data, pngCrc32(typeBytes)));\n  };\n  for (const chunk of chunks) writeChunk(chunk.type, chunk.data);\n  for (let i = 0; i < idat.length; i += 1 << 20) writeChunk(\"IDAT\", idat.subarray(i, Math.min(idat.length, i + (1 << 20))));\n  writeChunk(\"IEND\", new Uint8Array(0));\n  return out.result();\n}\n"]}

package/dist/output/print-contrast-reference.d.ts

@@ -1,24 +1,26 @@
-/** Static D65 neutral Gabor detection reference; no photographic visibility verdict.
+/** Contrast detection threshold for a static, neutral (D65 white) Gabor patch, from the castleCSF
+ * contrast sensitivity function (CSF) model. A Gabor patch is a sine grating under a Gaussian envelope.
+ * It does not say whether detail in a photograph will be visible.
  * @see docs/PRINT_CONTRAST_REFERENCE.md for exact source, applicability and review gates.
  */
 import { type CalculationResult } from "../core/calculation-result.js";
 export declare const PRINT_CONTRAST_REFERENCE_MODEL_VERSION: "0.1.0";
-/** Exact MIT-licensed numerical-model source, not a local calibration identity. */
+/** Identifies the exact MIT-licensed model source. It is not a local calibration. */
 export declare const PRINT_CONTRAST_REFERENCE_UPSTREAM_REVISION: "f4b0b722af83001d7af979281e06ca642d36e4e8";
-/** Narrow reference stimulus, separate from any measured photographic ROI.
- * Positive but out-of-domain quantities return unsupported rather than extrapolation.
+/** The narrow reference stimulus. It is separate from any measured photographic region of interest (ROI).
+ * Positive values outside the model's range return "unsupported" instead of being extrapolated.
  */
 export interface PrintContrastReferenceInput {
     referenceId: string;
     stimulus: "static-neutral-d65-gabor";
     observer: "published-binocular-natural-pupil-reference";
-    /** Uniform D65 background/carrier mean; not the average of a finite photographic ROI. */
+    /** Mean luminance of the uniform D65 background and grating. Not the average of a photographic ROI. */
     meanLuminanceCdPerSquareMeter: number;
     spatialFrequencyCyclesPerDegree: number;
     gaussianEnvelopeSigmaDegrees: number;
     temporalFrequencyHz: number;
     eccentricityDegrees: number;
-    /** Neutral carrier fractional amplitude before the Gaussian envelope; not arbitrary ROI extrema. */
+    /** Fractional amplitude of the neutral grating before the Gaussian envelope. Not taken from ROI minimum and maximum values. */
     modulationMichelson: number;
 }
 export interface PrintContrastReference {
@@ -40,8 +42,7 @@ export interface PrintContrastReference {
     uncertainty: "not-quantified";
     overallPrintVerdict: "not-offered";
 }
-/** Strictly parse/copy explicit reference conditions; no defaults infer an observer. */
+/** Strictly parses and copies the explicit reference conditions. No defaults are filled in to imply an observer. */
 export declare function parsePrintContrastReferenceInput(value: unknown): PrintContrastReferenceInput;
-/** Estimate the restricted published-model threshold; no individual invisibility claim. */
+/** Estimates the detection threshold from the published model, within its limited range. It does not claim that detail is invisible to any particular person. */
 export declare function calculatePrintContrastReference(value: PrintContrastReferenceInput): CalculationResult<PrintContrastReference>;
-//# sourceMappingURL=print-contrast-reference.d.ts.map