postext-pdf 1.20.2 → 1.21.0

package/dist/print/images.js

@@ -0,0 +1,198 @@
+/**
+ * Pictures in a colour-managed print render (#603): RGB bitmaps are
+ * separated through the output profile into DeviceCMYK image XObjects.
+ * PDF/X-1a, which has no transparency, gets each picture composed over the
+ * paper; PDF/X-4 keeps its alpha as a DeviceGray soft mask. CMYK and
+ * grayscale JPEGs pass through untouched (they are already print data).
+ */
+import { PDFImage, PDFName } from 'pdf-lib';
+import UPNG from '@pdf-lib/upng';
+import { buildRgbLut, outputTransform, sampleRgbLut } from 'postext';
+/** Channels of a JPEG from its SOF marker (1 gray, 3 YCbCr/RGB, 4 CMYK). */
+export function jpegComponents(bytes) {
+    let i = 2;
+    while (i + 9 < bytes.length) {
+        if (bytes[i] !== 0xff)
+            return null;
+        const marker = bytes[i + 1];
+        const len = (bytes[i + 2] << 8) | bytes[i + 3];
+        // SOF0–SOF15 except DHT (C4), JPG (C8) and DAC (CC).
+        if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+            return bytes[i + 9];
+        }
+        i += 2 + len;
+    }
+    return null;
+}
+async function decodeWithCanvas(bytes, type) {
+    const g = globalThis;
+    if (!g.createImageBitmap || !g.OffscreenCanvas)
+        return null;
+    try {
+        const bitmap = await g.createImageBitmap(new Blob([bytes], { type }));
+        const canvas = new g.OffscreenCanvas(bitmap.width, bitmap.height);
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            return null;
+        ctx.drawImage(bitmap, 0, 0);
+        const { data } = ctx.getImageData(0, 0, bitmap.width, bitmap.height);
+        return { width: bitmap.width, height: bitmap.height, data };
+    }
+    catch {
+        return null;
+    }
+}
+/** Decode a PNG or JPEG to RGBA. */
+export async function decodeRgba(bytes, format) {
+    if (format === 'png') {
+        try {
+            const img = UPNG.decode(bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength));
+            const frames = UPNG.toRGBA8(img);
+            const first = frames[0];
+            if (!first)
+                return null;
+            return { width: img.width, height: img.height, data: new Uint8Array(first) };
+        }
+        catch {
+            return decodeWithCanvas(bytes, 'image/png');
+        }
+    }
+    const viaCanvas = await decodeWithCanvas(bytes, 'image/jpeg');
+    if (viaCanvas)
+        return viaCanvas;
+    try {
+        const jpeg = (await import('jpeg-js'));
+        const decode = jpeg.decode ?? jpeg.default?.decode;
+        if (!decode)
+            return null;
+        const out = decode(bytes, { useTArray: true, formatAsRGBA: true });
+        return { width: out.width, height: out.height, data: out.data };
+    }
+    catch {
+        return null;
+    }
+}
+const lutCache = new WeakMap();
+/** The sRGB → CMYK pixel LUT of a mode: the profile's own black
+ *  generation (no K-only neutrals, which suit flat colours, not tones). */
+function pixelLut(mode) {
+    let lut = lutCache.get(mode);
+    if (!lut) {
+        const t = outputTransform(mode.profile, {
+            intent: mode.config.renderingIntent,
+            blackPointCompensation: mode.config.blackPointCompensation,
+            preserveNeutrals: false,
+        });
+        lut = buildRgbLut(33, 4, (r, g, b) => {
+            const k = t.fromRgb(r, g, b);
+            return [k.c, k.m, k.y, k.k];
+        });
+        lutCache.set(mode, lut);
+    }
+    return lut;
+}
+/** Separate RGBA pixels into CMYK bytes (and an alpha plane when any pixel
+ *  is translucent and the mode keeps transparency). */
+export function separatePixels(px, mode) {
+    const lut = pixelLut(mode);
+    const n = px.width * px.height;
+    const cmyk = new Uint8Array(n * 4);
+    const keepAlpha = !mode.flattenTransparency;
+    let alpha;
+    const out = new Float32Array(4);
+    // Flat areas repeat colours: remember the last few conversions.
+    const memo = new Map();
+    for (let i = 0; i < n; i++) {
+        let r = px.data[i * 4];
+        let g = px.data[i * 4 + 1];
+        let b = px.data[i * 4 + 2];
+        const a = px.data[i * 4 + 3];
+        if (a < 255) {
+            if (keepAlpha) {
+                alpha ??= new Uint8Array(n).fill(255);
+                alpha[i] = a;
+            }
+            else {
+                // Over the paper.
+                const f = a / 255;
+                r = Math.round(r * f + 255 * (1 - f));
+                g = Math.round(g * f + 255 * (1 - f));
+                b = Math.round(b * f + 255 * (1 - f));
+            }
+        }
+        const key = (r << 16) | (g << 8) | b;
+        const hit = memo.get(key);
+        if (hit !== undefined) {
+            cmyk[i * 4] = hit >>> 24;
+            cmyk[i * 4 + 1] = (hit >>> 16) & 255;
+            cmyk[i * 4 + 2] = (hit >>> 8) & 255;
+            cmyk[i * 4 + 3] = hit & 255;
+            continue;
+        }
+        sampleRgbLut(lut, r, g, b, out);
+        const c = Math.round(out[0] * 255);
+        const m = Math.round(out[1] * 255);
+        const y = Math.round(out[2] * 255);
+        const k = Math.round(out[3] * 255);
+        cmyk[i * 4] = c;
+        cmyk[i * 4 + 1] = m;
+        cmyk[i * 4 + 2] = y;
+        cmyk[i * 4 + 3] = k;
+        if (memo.size > 4096)
+            memo.clear();
+        memo.set(key, ((c << 24) | (m << 16) | (y << 8) | k) >>> 0);
+    }
+    return alpha ? { cmyk, alpha } : { cmyk };
+}
+/** A pdf-lib PDFImage over an image XObject already written to `ref`. */
+function imageOf(pdfDoc, ref, width, height) {
+    const embedder = {
+        width,
+        height,
+        bitsPerComponent: 8,
+        embedIntoContext: async (_context, r) => r ?? ref,
+    };
+    return PDFImage.of(ref, pdfDoc, embedder);
+}
+/** Write separated pixels as a DeviceCMYK image XObject. */
+export function embedCmykPixels(pdfDoc, width, height, sep) {
+    const context = pdfDoc.context;
+    let smask;
+    if (sep.alpha) {
+        smask = context.register(context.flateStream(sep.alpha, { Type: 'XObject', Subtype: 'Image', Width: width, Height: height, ColorSpace: 'DeviceGray', BitsPerComponent: 8 }));
+    }
+    const dict = {
+        Type: 'XObject',
+        Subtype: 'Image',
+        Width: width,
+        Height: height,
+        ColorSpace: 'DeviceCMYK',
+        BitsPerComponent: 8,
+    };
+    const stream = context.flateStream(sep.cmyk, dict);
+    if (smask)
+        stream.dict.set(PDFName.of('SMask'), smask);
+    const ref = context.register(stream);
+    return imageOf(pdfDoc, ref, width, height);
+}
+/**
+ * Embed a raster picture for a print render: separated into CMYK when the
+ * mode converts pictures and the bitmap is RGB, else as pdf-lib embeds it.
+ * PDF/X-1a always flattens a PNG's alpha (over paper) even when it keeps
+ * a picture's colours.
+ */
+export async function embedPrintRaster(pdfDoc, bytes, format, mode) {
+    if (format === 'jpeg') {
+        const channels = jpegComponents(bytes);
+        if (channels !== 3 || !mode.convertImages)
+            return pdfDoc.embedJpg(bytes);
+    }
+    if (!mode.convertImages && !mode.flattenTransparency) {
+        return format === 'png' ? pdfDoc.embedPng(bytes) : pdfDoc.embedJpg(bytes);
+    }
+    const px = await decodeRgba(bytes, format);
+    if (!px)
+        return format === 'png' ? pdfDoc.embedPng(bytes) : pdfDoc.embedJpg(bytes);
+    return embedCmykPixels(pdfDoc, px.width, px.height, separatePixels(px, mode));
+}
+//# sourceMappingURL=images.js.map

package/dist/print/images.js.map

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

package/dist/print/inspectMaster.d.ts

@@ -0,0 +1,17 @@
+/**
+ * What a placed PDF (a print master, `Resource.svg.pdfFileId`) brings into
+ * a print file that postext does not control (#605): fonts it does not
+ * embed, RGB colour, and transparency (which PDF/X-1a forbids).
+ */
+export interface PrintMasterReport {
+    /** Base names of fonts used without an embedded font program. */
+    nonEmbeddedFonts: string[];
+    /** The page paints in an RGB colour space (device or ICC-based). */
+    rgb: boolean;
+    /** The page uses transparency: alpha, soft masks, blend modes or
+     *  transparency groups. */
+    transparency: boolean;
+}
+/** Inspect the first page of a PDF's bytes (the page postext embeds). */
+export declare function inspectPrintMaster(bytes: Uint8Array): Promise<PrintMasterReport>;
+//# sourceMappingURL=inspectMaster.d.ts.map

package/dist/print/inspectMaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectMaster.d.ts","sourceRoot":"","sources":["../../src/print/inspectMaster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oEAAoE;IACpE,GAAG,EAAE,OAAO,CAAC;IACb;+BAC2B;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAID,yEAAyE;AACzE,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8GtF"}

package/dist/print/inspectMaster.js

@@ -0,0 +1,139 @@
+/**
+ * What a placed PDF (a print master, `Resource.svg.pdfFileId`) brings into
+ * a print file that postext does not control (#605): fonts it does not
+ * embed, RGB colour, and transparency (which PDF/X-1a forbids).
+ */
+import { PDFArray, PDFDict, PDFDocument, PDFName, PDFNumber, PDFRawStream, PDFRef, PDFStream, decodePDFRawStream } from 'pdf-lib';
+const name = (o) => (o instanceof PDFName ? o.asString().slice(1) : undefined);
+/** Inspect the first page of a PDF's bytes (the page postext embeds). */
+export async function inspectPrintMaster(bytes) {
+    const pdf = await PDFDocument.load(bytes, { ignoreEncryption: true, updateMetadata: false });
+    const ctx = pdf.context;
+    const lookup = (o) => (o instanceof PDFRef ? ctx.lookup(o) : o);
+    const fonts = new Set();
+    let rgb = false;
+    let transparency = false;
+    const seen = new Set();
+    const checkSpace = (cs) => {
+        const v = lookup(cs);
+        const n = name(v);
+        if (n === 'DeviceRGB' || n === 'CalRGB' || n === 'RGB')
+            rgb = true;
+        if (v instanceof PDFArray) {
+            const kind = name(lookup(v.get(0)));
+            if (kind === 'CalRGB')
+                rgb = true;
+            if (kind === 'ICCBased') {
+                const s = lookup(v.get(1));
+                const comps = s instanceof PDFStream ? lookup(s.dict.get(PDFName.of('N'))) : undefined;
+                if (comps instanceof PDFNumber && comps.asNumber() === 3)
+                    rgb = true;
+            }
+            // Indexed / Separation / DeviceN: their base or alternate space.
+            if (kind === 'Indexed')
+                checkSpace(v.get(1));
+            if (kind === 'Separation' || kind === 'DeviceN')
+                checkSpace(v.get(kind === 'Separation' ? 2 : 2));
+        }
+    };
+    const fontEmbedded = (font) => {
+        const sub = name(lookup(font.get(PDFName.of('Subtype'))));
+        if (sub === 'Type3')
+            return true;
+        if (sub === 'Type0') {
+            const kids = lookup(font.get(PDFName.of('DescendantFonts')));
+            const kid = kids instanceof PDFArray ? lookup(kids.get(0)) : undefined;
+            return kid instanceof PDFDict ? fontEmbedded(kid) : false;
+        }
+        const fd = lookup(font.get(PDFName.of('FontDescriptor')));
+        if (!(fd instanceof PDFDict))
+            return false;
+        return ['FontFile', 'FontFile2', 'FontFile3'].some((k) => fd.get(PDFName.of(k)) !== undefined);
+    };
+    /** Device RGB set straight in a content stream (`rg` / `RG`). */
+    const scanContent = (stream) => {
+        const s = lookup(stream);
+        if (s instanceof PDFArray) {
+            for (let i = 0; i < s.size(); i++)
+                scanContent(s.get(i));
+            return;
+        }
+        if (!(s instanceof PDFRawStream))
+            return;
+        try {
+            const text = new TextDecoder('latin1').decode(decodePDFRawStream(s).decode());
+            if (/(^|[\s\]])(rg|RG)(?=\s|$)/.test(text))
+                rgb = true;
+        }
+        catch {
+            // An undecodable stream says nothing.
+        }
+    };
+    const walkResources = (res) => {
+        const r = lookup(res);
+        if (!(r instanceof PDFDict) || seen.has(r))
+            return;
+        seen.add(r);
+        const fontDict = lookup(r.get(PDFName.of('Font')));
+        if (fontDict instanceof PDFDict) {
+            for (const [, f] of fontDict.entries()) {
+                const font = lookup(f);
+                if (font instanceof PDFDict && !fontEmbedded(font))
+                    fonts.add(name(lookup(font.get(PDFName.of('BaseFont')))) ?? 'unnamed');
+            }
+        }
+        const spaces = lookup(r.get(PDFName.of('ColorSpace')));
+        if (spaces instanceof PDFDict)
+            for (const [, cs] of spaces.entries())
+                checkSpace(cs);
+        const states = lookup(r.get(PDFName.of('ExtGState')));
+        if (states instanceof PDFDict) {
+            for (const [, g] of states.entries()) {
+                const gs = lookup(g);
+                if (!(gs instanceof PDFDict))
+                    continue;
+                for (const k of ['ca', 'CA']) {
+                    const v = lookup(gs.get(PDFName.of(k)));
+                    if (v instanceof PDFNumber && v.asNumber() < 1)
+                        transparency = true;
+                }
+                const smask = lookup(gs.get(PDFName.of('SMask')));
+                if (smask && name(smask) !== 'None')
+                    transparency = true;
+                const bm = lookup(gs.get(PDFName.of('BM')));
+                if (bm && name(bm) !== 'Normal' && name(bm) !== 'Compatible')
+                    transparency = true;
+            }
+        }
+        const xobjects = lookup(r.get(PDFName.of('XObject')));
+        if (xobjects instanceof PDFDict) {
+            for (const [, x] of xobjects.entries()) {
+                const xo = lookup(x);
+                if (!(xo instanceof PDFStream))
+                    continue;
+                const d = xo.dict;
+                const sub = name(lookup(d.get(PDFName.of('Subtype'))));
+                if (sub === 'Image') {
+                    checkSpace(d.get(PDFName.of('ColorSpace')));
+                    if (d.get(PDFName.of('SMask')) !== undefined)
+                        transparency = true;
+                }
+                else if (sub === 'Form') {
+                    scanContent(xo);
+                    const group = lookup(d.get(PDFName.of('Group')));
+                    if (group instanceof PDFDict && name(lookup(group.get(PDFName.of('S')))) === 'Transparency')
+                        transparency = true;
+                    walkResources(d.get(PDFName.of('Resources')));
+                }
+            }
+        }
+    };
+    const page = pdf.getPage(0);
+    walkResources(page.node.Resources());
+    scanContent(page.node.get(PDFName.of('Contents')));
+    const group = page.node.lookup(PDFName.of('Group'));
+    if (group instanceof PDFDict && name(lookup(group.get(PDFName.of('S')))) === 'Transparency')
+        transparency = true;
+    return { nonEmbeddedFonts: [...fonts].sort(), rgb, transparency };
+}
+//# sourceMappingURL=inspectMaster.js.map

package/dist/print/inspectMaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectMaster.js","sourceRoot":"","sources":["../../src/print/inspectMaster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAkB,MAAM,SAAS,CAAC;AAYlJ,MAAM,IAAI,GAAG,CAAC,CAAwB,EAAsB,EAAE,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAE1H,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAiB;IACxD,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,CAAwB,EAAyB,EAAE,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAa,CAAC;IAElC,MAAM,UAAU,GAAG,CAAC,EAAyB,EAAE,EAAE;QAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK;YAAE,GAAG,GAAG,IAAI,CAAC;QACnE,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,QAAQ;gBAAE,GAAG,GAAG,IAAI,CAAC;YAClC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,CAAC,YAAY,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvF,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;oBAAE,GAAG,GAAG,IAAI,CAAC;YACvE,CAAC;YACD,iEAAiE;YACjE,IAAI,IAAI,KAAK,SAAS;gBAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,SAAS;gBAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpG,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,IAAa,EAAW,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,GAAG,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,GAAG,GAAG,IAAI,YAAY,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACvE,OAAO,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,CAAC,EAAE,YAAY,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACjG,CAAC,CAAC;IAEF,iEAAiE;IACjE,MAAM,WAAW,GAAG,CAAC,MAA6B,EAAE,EAAE;QACpD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;YAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;gBAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,YAAY,YAAY,CAAC;YAAE,OAAO;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,GAAG,GAAG,IAAI,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,GAA0B,EAAQ,EAAE;QACzD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO;QACnD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,IAAI,YAAY,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;YAC7H,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,YAAY,OAAO;YAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE;gBAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,CAAC,EAAE,YAAY,OAAO,CAAC;oBAAE,SAAS;gBACvC,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;oBAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACxC,IAAI,CAAC,YAAY,SAAS,IAAI,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC;wBAAE,YAAY,GAAG,IAAI,CAAC;gBACtE,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAClD,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,MAAM;oBAAE,YAAY,GAAG,IAAI,CAAC;gBACzD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5C,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,YAAY;oBAAE,YAAY,GAAG,IAAI,CAAC;YACpF,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,CAAC,EAAE,YAAY,SAAS,CAAC;oBAAE,SAAS;gBACzC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;gBAClB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;oBACpB,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;oBAC5C,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,SAAS;wBAAE,YAAY,GAAG,IAAI,CAAC;gBACpE,CAAC;qBAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;oBAC1B,WAAW,CAAC,EAAE,CAAC,CAAC;oBAChB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACjD,IAAI,KAAK,YAAY,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,cAAc;wBAAE,YAAY,GAAG,IAAI,CAAC;oBACjH,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,IAAI,KAAK,YAAY,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,cAAc;QAAE,YAAY,GAAG,IAAI,CAAC;IACjH,OAAO,EAAE,gBAAgB,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC"}

package/dist/print/pdfx.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PDF/X identification and the output intent (#603): what turns a CMYK
+ * render into a PDF/X-1a:2003 or PDF/X-4 file.
+ *
+ * - The output intent `GTS_PDFX`, naming the printing condition (the ICC
+ *   characterization registry name) and embedding the destination
+ *   profile.
+ * - The Info dictionary's `GTS_PDFXVersion`, `/Trapped /False`, title and
+ *   dates; an XMP packet with the same, `pdfxid:GTSPDFXVersion` and the
+ *   document / version ids (PDF/X-4), merged with the PDF/UA one when the
+ *   file is tagged; the trailer `/ID`.
+ * - A TrimBox and BleedBox on every page (the version header, 1.4 for
+ *   X-1a and 1.6 for X-4, is set on the saved bytes), and for X-4 a transparency page group blending in
+ *   CMYK plus `/DefaultRGB` (sRGB) where RGB pictures were kept.
+ */
+import { PDFDocument } from 'pdf-lib';
+import type { PrintColorMode } from './colorMode';
+export interface PdfXMeta {
+    title: string;
+    author?: string;
+    lang?: string;
+    producer: string;
+    creatorTool: string;
+    /** The file is also tagged PDF/UA-1. */
+    pdfua: boolean;
+    /** Set the dates (tests pin them). */
+    date?: Date;
+}
+export declare function pdfxVersionString(standard: 'pdfx1a' | 'pdfx4'): string;
+/** The XMP packet of a PDF/X file (and PDF/UA when tagged). */
+export declare function buildPdfXXmp(meta: PdfXMeta, standard: 'pdfx1a' | 'pdfx4', date: Date, documentId: string): string;
+/** Write the PDF/X parts of a render. Call after every page and the
+ *  structure tree are written, before saving. */
+export declare function writePdfX(pdfDoc: PDFDocument, mode: PrintColorMode, meta: PdfXMeta, keptRgb: boolean): void;
+//# sourceMappingURL=pdfx.d.ts.map

package/dist/print/pdfx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfx.d.ts","sourceRoot":"","sources":["../../src/print/pdfx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAW,WAAW,EAAkD,MAAM,SAAS,CAAC;AAE/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AA2BD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAEtE;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiCjH;AAUD;iDACiD;AACjD,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA2D3G"}

package/dist/print/pdfx.js

@@ -0,0 +1,144 @@
+/**
+ * PDF/X identification and the output intent (#603): what turns a CMYK
+ * render into a PDF/X-1a:2003 or PDF/X-4 file.
+ *
+ * - The output intent `GTS_PDFX`, naming the printing condition (the ICC
+ *   characterization registry name) and embedding the destination
+ *   profile.
+ * - The Info dictionary's `GTS_PDFXVersion`, `/Trapped /False`, title and
+ *   dates; an XMP packet with the same, `pdfxid:GTSPDFXVersion` and the
+ *   document / version ids (PDF/X-4), merged with the PDF/UA one when the
+ *   file is tagged; the trailer `/ID`.
+ * - A TrimBox and BleedBox on every page (the version header, 1.4 for
+ *   X-1a and 1.6 for X-4, is set on the saved bytes), and for X-4 a transparency page group blending in
+ *   CMYK plus `/DefaultRGB` (sRGB) where RGB pictures were kept.
+ */
+import { PDFDict, PDFHexString, PDFName, PDFString } from 'pdf-lib';
+import { srgbProfileBytes } from 'postext';
+function xmlEscape(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function isoDate(d) {
+    return d.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+function hex(bytes) {
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+function randomBytes(n) {
+    const out = new Uint8Array(n);
+    const c = globalThis.crypto;
+    if (c?.getRandomValues)
+        return c.getRandomValues(out);
+    for (let i = 0; i < n; i++)
+        out[i] = Math.floor(Math.random() * 256);
+    return out;
+}
+function uuid(bytes) {
+    const h = hex(bytes.subarray(0, 16));
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20, 32)}`;
+}
+export function pdfxVersionString(standard) {
+    return standard === 'pdfx1a' ? 'PDF/X-1a:2003' : 'PDF/X-4';
+}
+/** The XMP packet of a PDF/X file (and PDF/UA when tagged). */
+export function buildPdfXXmp(meta, standard, date, documentId) {
+    const title = xmlEscape(meta.title);
+    const creator = meta.author ? `<dc:creator><rdf:Seq><rdf:li>${xmlEscape(meta.author)}</rdf:li></rdf:Seq></dc:creator>\n` : '';
+    const language = meta.lang ? `<dc:language><rdf:Bag><rdf:li>${xmlEscape(meta.lang)}</rdf:li></rdf:Bag></dc:language>\n` : '';
+    const when = isoDate(date);
+    return ('<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>\n' +
+        '<x:xmpmeta xmlns:x="adobe:ns:meta/">\n' +
+        '<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">\n' +
+        '<rdf:Description rdf:about="" xmlns:dc="http://purl.org/dc/elements/1.1/"' +
+        ' xmlns:pdf="http://ns.adobe.com/pdf/1.3/" xmlns:xmp="http://ns.adobe.com/xap/1.0/"' +
+        ' xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:pdfxid="http://www.npes.org/pdfx/ns/id/"' +
+        (meta.pdfua ? ' xmlns:pdfuaid="http://www.aiim.org/pdfua/ns/id/"' : '') +
+        '>\n' +
+        `<dc:title><rdf:Alt><rdf:li xml:lang="x-default">${title}</rdf:li></rdf:Alt></dc:title>\n` +
+        creator +
+        language +
+        '<dc:format>application/pdf</dc:format>\n' +
+        `<pdf:Producer>${xmlEscape(meta.producer)}</pdf:Producer>\n` +
+        '<pdf:Trapped>False</pdf:Trapped>\n' +
+        `<xmp:CreatorTool>${xmlEscape(meta.creatorTool)}</xmp:CreatorTool>\n` +
+        `<xmp:CreateDate>${when}</xmp:CreateDate>\n` +
+        `<xmp:ModifyDate>${when}</xmp:ModifyDate>\n` +
+        `<xmp:MetadataDate>${when}</xmp:MetadataDate>\n` +
+        `<xmpMM:DocumentID>uuid:${documentId}</xmpMM:DocumentID>\n` +
+        `<xmpMM:InstanceID>uuid:${documentId}</xmpMM:InstanceID>\n` +
+        '<xmpMM:VersionID>1</xmpMM:VersionID>\n' +
+        '<xmpMM:RenditionClass>default</xmpMM:RenditionClass>\n' +
+        `<pdfxid:GTSPDFXVersion>${pdfxVersionString(standard)}</pdfxid:GTSPDFXVersion>\n` +
+        (meta.pdfua ? '<pdfuaid:part>1</pdfuaid:part>\n' : '') +
+        '</rdf:Description>\n</rdf:RDF>\n</x:xmpmeta>\n' +
+        '<?xpacket end="w"?>');
+}
+/** Give a page a TrimBox and BleedBox (its MediaBox) when it has none. */
+function ensureBoxes(page) {
+    const has = (k) => page.node.get(PDFName.of(k)) !== undefined;
+    const { x, y, width, height } = page.getMediaBox();
+    if (!has('TrimBox'))
+        page.setTrimBox(x, y, width, height);
+    if (!has('BleedBox'))
+        page.setBleedBox(x, y, width, height);
+}
+/** Write the PDF/X parts of a render. Call after every page and the
+ *  structure tree are written, before saving. */
+export function writePdfX(pdfDoc, mode, meta, keptRgb) {
+    if (mode.standard === 'none')
+        return;
+    const standard = mode.standard;
+    const context = pdfDoc.context;
+    const date = meta.date ?? new Date();
+    const idBytes = randomBytes(16);
+    const documentId = uuid(idBytes);
+    // Output intent with the destination profile.
+    const profileRef = context.register(context.flateStream(mode.profile.bytes, { N: 4 }));
+    const intent = context.obj({
+        Type: 'OutputIntent',
+        S: 'GTS_PDFX',
+        OutputConditionIdentifier: PDFString.of(mode.condition.registryName),
+        ...(mode.condition.registryName !== 'Custom' ? { RegistryName: PDFString.of('http://www.color.org') } : {}),
+        OutputCondition: PDFString.of(mode.condition.condition),
+        Info: PDFString.of(mode.condition.name),
+        DestOutputProfile: profileRef,
+    });
+    pdfDoc.catalog.set(PDFName.of('OutputIntents'), context.obj([context.register(intent)]));
+    // Info dictionary.
+    pdfDoc.setTitle(meta.title, { showInWindowTitleBar: true });
+    if (meta.author)
+        pdfDoc.setAuthor(meta.author);
+    pdfDoc.setCreator(meta.creatorTool);
+    pdfDoc.setProducer(meta.producer);
+    pdfDoc.setCreationDate(date);
+    pdfDoc.setModificationDate(date);
+    const info = pdfDoc.getInfoDict();
+    info.set(PDFName.of('Trapped'), PDFName.of('False'));
+    info.set(PDFName.of('GTS_PDFXVersion'), PDFString.of(pdfxVersionString(standard)));
+    // XMP (replacing the PDF/UA-only packet of a tagged render).
+    const xmp = buildPdfXXmp(meta, standard, date, documentId);
+    const metadata = context.stream(new TextEncoder().encode(xmp), { Type: 'Metadata', Subtype: 'XML' });
+    pdfDoc.catalog.set(PDFName.of('Metadata'), context.register(metadata));
+    // Trailer ID: the same bytes twice (a first version of the file).
+    const id = PDFHexString.of(hex(idBytes));
+    context.trailerInfo.ID = context.obj([id, id]);
+    const srgbRef = standard === 'pdfx4' && keptRgb
+        ? context.register(context.flateStream(srgbProfileBytes(), { N: 3 }))
+        : undefined;
+    for (const page of pdfDoc.getPages()) {
+        ensureBoxes(page);
+        if (standard === 'pdfx4') {
+            page.node.set(PDFName.of('Group'), context.obj({ Type: 'Group', S: 'Transparency', CS: 'DeviceCMYK' }));
+            if (srgbRef) {
+                const resources = page.node.normalizedEntries().Resources;
+                let spaces = resources.lookup(PDFName.of('ColorSpace'));
+                if (!(spaces instanceof PDFDict)) {
+                    spaces = context.obj({});
+                    resources.set(PDFName.of('ColorSpace'), spaces);
+                }
+                spaces.set(PDFName.of('DefaultRGB'), context.obj([PDFName.of('ICCBased'), srgbRef]));
+            }
+        }
+    }
+}
+//# sourceMappingURL=pdfx.js.map

package/dist/print/pdfx.js.map

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

package/dist/print/printPass.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The black-handling pass over a content stream (#604), run on every page
+ * and every vector form of a colour-managed (ICC) render once its
+ * operators are written:
+ *
+ * - **Overprint**: whatever paints in 100 % K only (black text, rules,
+ *   strokes, small black shapes) overprints — `op`/`OP` true with `OPM 1`
+ *   — so a plate shifting on press never opens a white halo round it.
+ *   Everything else knocks out, as before; pictures and shadings never
+ *   overprint.
+ * - **Rich black**: a K-only fill whose smaller side reaches
+ *   `richBlackMinSize` (a background, a band, a box) is set in the
+ *   rich-black recipe instead, and knocks out. Text never turns rich.
+ *
+ * Working on the operators rather than at each painter catches every way
+ * the backend paints (pdf-lib's `drawRectangle`/`drawSvgPath`, raw
+ * operator runs, text objects) with one rule.
+ */
+import { PDFName, PDFOperator, type PDFPage } from 'pdf-lib';
+import type { PrintColorMode } from './colorMode';
+/** Overprint flags of a graphics state: fill (`op`) and stroke (`OP`). */
+export interface OverprintFlags {
+    fill: boolean;
+    stroke: boolean;
+}
+/** Registers (or reuses) the ExtGState for a pair of flags in the
+ *  resources the operators run against, returning its name. */
+export type OverprintStateFactory = (flags: OverprintFlags) => PDFName;
+export interface PrintPassOptions {
+    /** Apply rich black to large K-only fills. Off for forms, whose size on
+     *  the page is not known when they are written. */
+    richBlack: boolean;
+    /** User-space units per point at the identity CTM (1 for a page). */
+    unitsPerPoint?: number;
+}
+/** Run the black-handling pass over `ops`, returning the new operator
+ *  list. `stateFor` names the overprint ExtGStates in the stream's
+ *  resources. */
+export declare function applyPrintPass(ops: readonly PDFOperator[], mode: PrintColorMode, stateFor: OverprintStateFactory, options?: PrintPassOptions): PDFOperator[];
+/** The ExtGState dictionary of a pair of overprint flags. */
+export declare function overprintStateDict(flags: OverprintFlags): {
+    Type: string;
+    op: boolean;
+    OP: boolean;
+    OPM: number;
+};
+/** Run the pass over a page's content stream, registering the overprint
+ *  states in the page's resources. Rich black applies (a page's user space
+ *  is in points). */
+export declare function runPagePrintPass(page: PDFPage, mode: PrintColorMode): void;
+//# sourceMappingURL=printPass.d.ts.map

package/dist/print/printPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printPass.d.ts","sourceRoot":"","sources":["../../src/print/printPass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAa,WAAW,EAAoB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;+DAC+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;AA4DvE,MAAM,WAAW,gBAAgB;IAC/B;uDACmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,WAAW,EAAE,EAC3B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE,gBAAuC,GAC/C,WAAW,EAAE,CAgKf;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAEjH;AAED;;qBAEqB;AACrB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAa1E"}