@printwithsynergy/lens-pdf 0.3.0-beta.81

package/dist/browser/codexOverlay.js

@@ -0,0 +1,256 @@
+/**
+ * Codex accuracy overlay for `<LensPDFDemo>`.
+ *
+ * When a host passes a `codex` client, `LensPDFDemo` fires
+ * `extractStream` in the background. This module wraps the codex
+ * render APIs (renderSeparations, renderHeatmap, renderLayer) into
+ * the `ViewerServices` slot interface so the viewer can swap in
+ * Ghostscript-accurate renders silently once they arrive.
+ *
+ * This module has **no import of `@printwithsynergy/codex-client`**.
+ * It defines a minimal structural interface — any object whose shape
+ * matches `MinimalCodexClient` (including `HttpClient` from
+ * `@printwithsynergy/codex-client`) satisfies it.
+ *
+ * @public
+ */
+import { PROCESS_CHANNELS } from "./constants.js";
+// ---------------------------------------------------------------------------
+// Ink / layer extraction helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract a `DetectedInk[]` from the `color_world` SSE event payload.
+ * Returns the 4 CMYK process channels plus any spot colorants the
+ * PDF declares (accurate — from pikepdf, not regex scanning).
+ *
+ * @public
+ */
+export function extractInksFromColorWorld(colorWorld) {
+    const process = PROCESS_CHANNELS.map((name) => ({
+        name,
+        type: "process",
+        altRgb: _PROCESS_INK_RGB[name.toLowerCase()] ?? [0, 0, 0],
+    }));
+    const spots = [];
+    const colorants = colorWorld["spot_colorants"];
+    if (Array.isArray(colorants)) {
+        for (const c of colorants) {
+            if (!c || typeof c !== "object")
+                continue;
+            const name = String(c["name"] ?? "");
+            if (!name)
+                continue;
+            const rgb = c["rgb"];
+            let altRgb = [128, 128, 128];
+            if (Array.isArray(rgb) && rgb.length >= 3) {
+                altRgb = [
+                    Math.round(Number(rgb[0]) * 255),
+                    Math.round(Number(rgb[1]) * 255),
+                    Math.round(Number(rgb[2]) * 255),
+                ];
+            }
+            spots.push({ name, type: "spot", altRgb });
+        }
+    }
+    return [...process, ...spots];
+}
+/** @internal */
+const _PROCESS_INK_RGB = {
+    cyan: [0, 174, 239],
+    magenta: [236, 0, 140],
+    yellow: [255, 242, 0],
+    black: [35, 31, 32],
+};
+/**
+ * Extract a layer list from the `ocgs` SSE event payload.
+ *
+ * @public
+ */
+export function extractLayersFromOcgs(ocgs) {
+    const list = ocgs["ocgs"];
+    if (!Array.isArray(list))
+        return [];
+    const result = [];
+    for (let i = 0; i < list.length; i++) {
+        const item = list[i];
+        if (!item || typeof item !== "object")
+            continue;
+        const name = String(item["name"] ?? `Layer ${i + 1}`);
+        const defaultOn = item["default_on"];
+        result.push({
+            name,
+            ocg_index: i,
+            default_on: defaultOn !== false,
+        });
+    }
+    return result;
+}
+/**
+ * Build `separations`, `tacHeatmap`, and `layers` service slots backed
+ * by the codex render APIs. Lazy: each page's renders are fetched the
+ * first time they're requested, then cached as blob URLs.
+ *
+ * Hosts swap these into `ViewerServices` after `phase2_complete` fires
+ * so pdfjs approximations are replaced by Ghostscript renders.
+ *
+ * @public
+ */
+export function createCodexOverlayServices(client, sha256, tacLimit, layerData) {
+    const pdfRef = { sha256 };
+    // Blob URL caches
+    // Separations: keyed `${pageNum}|${channelName}` → url
+    const channelUrls = new Map();
+    const channelBuilds = new Map();
+    // Heatmaps: keyed `${pageNum}|${limit}` → url
+    const heatmapUrls = new Map();
+    const heatmapBuilds = new Map();
+    // Layers: keyed `${pageNum}|${layerIndex}` → url
+    const layerUrlMap = new Map();
+    const layerBuilds = new Map();
+    const blobs = [];
+    const subscribers = new Set();
+    function notify() {
+        for (const cb of subscribers)
+            cb();
+    }
+    function makeBlobUrl(bytes, type = "image/png") {
+        // Copy into a plain ArrayBuffer to satisfy Blob's type constraints
+        // (TypeScript requires ArrayBuffer, not SharedArrayBuffer).
+        const ab = bytes.buffer instanceof ArrayBuffer
+            ? bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength)
+            : new Uint8Array(bytes).buffer;
+        const blob = new Blob([ab], { type });
+        const url = URL.createObjectURL(blob);
+        blobs.push(url);
+        return url;
+    }
+    function base64ToUint8Array(b64) {
+        const raw = atob(b64);
+        const out = new Uint8Array(raw.length);
+        for (let i = 0; i < raw.length; i++)
+            out[i] = raw.charCodeAt(i);
+        return out;
+    }
+    // Fetch all channels for a page in one call, cache each individually.
+    function ensureChannelsForPage(pageNum) {
+        const buildKey = `page:${pageNum}`;
+        if (channelBuilds.has(buildKey))
+            return;
+        const promise = client
+            .renderSeparations(pdfRef, { page: pageNum })
+            .then((result) => {
+            for (const ch of result.channels) {
+                const key = `${pageNum}|${ch.name}`;
+                if (channelUrls.has(key))
+                    continue;
+                try {
+                    const bytes = base64ToUint8Array(ch.png_b64);
+                    channelUrls.set(key, makeBlobUrl(bytes));
+                }
+                catch {
+                    // Skip bad channel silently.
+                }
+            }
+            channelBuilds.delete(buildKey);
+            notify();
+        })
+            .catch(() => {
+            channelBuilds.delete(buildKey);
+        });
+        channelBuilds.set(buildKey, promise);
+    }
+    function ensureHeatmap(pageNum, limit) {
+        const key = `${pageNum}|${limit}`;
+        if (heatmapUrls.has(key) || heatmapBuilds.has(key))
+            return;
+        const promise = client
+            .renderHeatmap(pdfRef, { page: pageNum, tacLimit: limit })
+            .then((result) => {
+            const url = makeBlobUrl(result.png);
+            heatmapUrls.set(key, url);
+            heatmapBuilds.delete(key);
+            notify();
+            return url;
+        })
+            .catch(() => {
+            heatmapBuilds.delete(key);
+            return "";
+        });
+        heatmapBuilds.set(key, promise);
+    }
+    const allLayerIndices = layerData.map((l) => l.ocg_index);
+    function ensureLayer(pageNum, layerIndex) {
+        const key = `${pageNum}|${layerIndex}`;
+        if (layerUrlMap.has(key) || layerBuilds.has(key))
+            return;
+        const promise = client
+            .renderLayer(pdfRef, { page: pageNum, layerIndex, allLayerIndices })
+            .then((bytes) => {
+            const url = makeBlobUrl(bytes);
+            layerUrlMap.set(key, url);
+            layerBuilds.delete(key);
+            notify();
+            return url;
+        })
+            .catch(() => {
+            layerBuilds.delete(key);
+            return "";
+        });
+        layerBuilds.set(key, promise);
+    }
+    const separations = {
+        getChannelImageUrl({ pageNum, channelName }) {
+            const key = `${pageNum}|${channelName}`;
+            const cached = channelUrls.get(key);
+            if (cached)
+                return cached;
+            ensureChannelsForPage(pageNum);
+            return "";
+        },
+    };
+    const tacHeatmap = {
+        getHeatmapImageUrl({ pageNum, tacLimit: tl }) {
+            const limit = tl ?? tacLimit;
+            const key = `${pageNum}|${limit}`;
+            const cached = heatmapUrls.get(key);
+            if (cached)
+                return cached;
+            ensureHeatmap(pageNum, limit);
+            return "";
+        },
+        listRuns: async (_args) => [],
+    };
+    const layers = {
+        getLayerImageUrl({ pageNum, layerIndex }) {
+            const key = `${pageNum}|${layerIndex}`;
+            const cached = layerUrlMap.get(key);
+            if (cached)
+                return cached;
+            ensureLayer(pageNum, layerIndex);
+            return "";
+        },
+        listLayers: async () => layerData,
+    };
+    return {
+        separations,
+        tacHeatmap,
+        layers,
+        subscribe(listener) {
+            subscribers.add(listener);
+            return () => subscribers.delete(listener);
+        },
+        dispose() {
+            for (const url of blobs)
+                URL.revokeObjectURL(url);
+            blobs.length = 0;
+            channelUrls.clear();
+            channelBuilds.clear();
+            heatmapUrls.clear();
+            heatmapBuilds.clear();
+            layerUrlMap.clear();
+            layerBuilds.clear();
+            subscribers.clear();
+        },
+    };
+}
+//# sourceMappingURL=codexOverlay.js.map

package/dist/browser/codexOverlay.js.map

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

package/dist/browser/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Module-local constants extracted to break a circular import between
+ * `browser/index.ts` and `browser/codexOverlay.ts`. Astro / Node SSR
+ * evaluates ESM modules in a strict order, and re-exporting
+ * `codexOverlay` from `index` while `codexOverlay` reads
+ * `PROCESS_CHANNELS` back from `index` triggered a TDZ
+ * `Cannot access '_CHANNELS' before initialization` at request time.
+ *
+ * Keep this file dependency-free.
+ */
+/** Process inks the demo synthesises from RGB. */
+export declare const PROCESS_CHANNELS: readonly ["Cyan", "Magenta", "Yellow", "Black"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/browser/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../browser/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,iDAAkD,CAAC"}

package/dist/browser/constants.js

@@ -0,0 +1,13 @@
+/**
+ * Module-local constants extracted to break a circular import between
+ * `browser/index.ts` and `browser/codexOverlay.ts`. Astro / Node SSR
+ * evaluates ESM modules in a strict order, and re-exporting
+ * `codexOverlay` from `index` while `codexOverlay` reads
+ * `PROCESS_CHANNELS` back from `index` triggered a TDZ
+ * `Cannot access '_CHANNELS' before initialization` at request time.
+ *
+ * Keep this file dependency-free.
+ */
+/** Process inks the demo synthesises from RGB. */
+export const PROCESS_CHANNELS = ["Cyan", "Magenta", "Yellow", "Black"];
+//# sourceMappingURL=constants.js.map

package/dist/browser/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../browser/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,211 @@
+/**
+ * `@printwithsynergy/lens-pdf/browser`
+ *
+ * Browser-only ViewerServices factory. One call gives you a fully
+ * wired {@link ViewerServices} instance backed by pdf.js — every
+ * tool the package ships (page raster, layers, separations, TAC
+ * heatmap, color picker, densitometer, in-browser annotations)
+ * works against any PDF the browser can fetch, without a server
+ * backend.
+ *
+ * ```ts
+ * import { createBrowserViewerServices } from "@printwithsynergy/lens-pdf/browser";
+ * const services = createBrowserViewerServices({ pdfUrl: "/proofs/abc.pdf" });
+ * await services.prepare(1); // pre-warm separations + heatmap + layers for page 1
+ * // <ViewerServicesContext.Provider value={services}> ... </Provider>
+ * services.dispose(); // free blob URLs / pdf.js doc on unmount
+ * ```
+ *
+ * Server-only features (true ICC separations, preflight findings,
+ * server-persisted annotations, PDF report exports) are explicitly
+ * left as `markUnwired` no-ops; their components self-hide.
+ *
+ * The CMYK numbers here are **rich-black approximations**, not ICC.
+ * Solid black RGB(0,0,0) reads as C=100, M=100, Y=100, K=80, TAC≈380%
+ * — close enough to a press CMYK rich-black to make the TAC heatmap
+ * and densitometer behave like their real backends. Production
+ * hosts wire a Ghostscript / MuPDF backend for ICC-correct readings.
+ *
+ * **Security**: this factory fetches whatever URL the host hands it.
+ * Sign / scope / expire the URL the same way you would any other PDF
+ * download — the viewer is a pure renderer and trusts the host to
+ * enforce access control upstream.
+ *
+ * @public
+ */
+export type { MinimalCodexClient, CodexOverlayServices } from "./codexOverlay";
+export { createCodexOverlayServices, extractInksFromColorWorld, extractLayersFromOcgs } from "./codexOverlay";
+import { type ThemeTokens, type ViewerServices } from "../plugin/services";
+export { PROCESS_CHANNELS } from "./constants";
+export { pantoneGoldLookup, processPlateLookup, resolveSpotSwatch, rgbToHex, } from "./pantone-gold";
+/**
+ * A single ink reported by the densitometer / color picker.
+ *
+ * @public
+ */
+export interface DetectedInk {
+    /** Display name — `"Cyan"`, `"PANTONE 185 C"`, `"Reflex Blue"` … */
+    name: string;
+    /** `process` for CMYK plates pdf.js composites in RGB; `spot` for
+     *  Separation / DeviceN colorants the host PDF declares. */
+    type: "process" | "spot";
+    /** Synthetic alternate sRGB triplet used to estimate coverage from
+     *  the rasterised RGB pixel. For process inks this is the canonical
+     *  CMYK→sRGB primary; for spots it's parsed from the PDF when
+     *  available, otherwise hash-derived from the spot name so each
+     *  spot still gets a stable, distinct hue. */
+    altRgb: [number, number, number];
+}
+/**
+ * Default URL for the pdf.js worker, served via unpkg pinned to the
+ * exact `pdfjs-dist` version this package was built against. Hosts
+ * that don't want a runtime CDN dep can override via the
+ * `workerSrc` option, set `pdfjs.GlobalWorkerOptions.workerSrc`
+ * directly before constructing the services, or self-host the file.
+ *
+ * @public
+ */
+export declare const defaultBrowserWorkerSrc: string;
+/**
+ * Convert an sRGB triplet to a CMYK approximation. Uses an additive
+ * decomposition with a "rich-black" K plate:
+ *
+ *   C = 1 - R/255
+ *   M = 1 - G/255
+ *   Y = 1 - B/255
+ *   K = min(C, M, Y) × {@link K_FACTOR}
+ *   TAC = (C + M + Y + K) × 100   // [0, 380]
+ *
+ * Returns each ink in [0, 1] and total area coverage as a percentage
+ * in [0, 380].
+ *
+ * This is intentionally NOT a GCR substitution — keeping the full
+ * C/M/Y values lets the TAC heatmap actually trip on solid-black
+ * artwork instead of bottoming out at 100 % from K alone, which is
+ * the behaviour print-prepress reviewers expect.
+ *
+ * @public
+ */
+export declare function rgbToCmyk(r: number, g: number, b: number): {
+    c: number;
+    m: number;
+    y: number;
+    k: number;
+    tac: number;
+};
+/**
+ * Best-effort spot-ink detector. Scans the raw PDF bytes (latin-1
+ * decoded) for `/Separation /Name …` and `/DeviceN [/N1 /N2 …]`
+ * declarations. Misses spots inside compressed object streams — for
+ * those the densitometer falls back to "process only" with no harm
+ * done. Hosts that need 100 % accurate ink lists wire a backend.
+ *
+ * @public
+ */
+export declare function detectSpotInksFromPdfBytes(bytes: Uint8Array): DetectedInk[];
+/**
+ * Options for {@link createBrowserViewerServices}.
+ *
+ * @public
+ */
+export interface BrowserViewerServicesOptions {
+    /** Raw PDF URL the browser can fetch. */
+    pdfUrl: string;
+    /**
+     * Optional override for the pdf.js worker URL. Default:
+     * {@link defaultBrowserWorkerSrc}.
+     */
+    workerSrc?: string;
+    /**
+     * Theme tokens to expose on `services.tokens`. Defaults to the
+     * package's neutral light palette.
+     */
+    tokens?: ThemeTokens;
+    /**
+     * Default TAC limit (in percent) used when the host doesn't specify
+     * one explicitly. The TAC heatmap and densitometer both respect the
+     * per-call value first; this is only used when the call site omits
+     * it. Default 300 — typical sheet-fed press limit.
+     */
+    tacLimit?: number;
+    /**
+     * Email used as the synthetic author for the in-browser annotation
+     * service. Default: `"you@browser.local"`.
+     */
+    annotationAuthorEmail?: string;
+}
+/**
+ * Augmented `ViewerServices` returned by {@link createBrowserViewerServices}.
+ * Extends the wire protocol with lifecycle helpers, a subscription
+ * hook that fires whenever a lazily-built tile URL becomes available,
+ * and a `prepare()` method that pre-warms the analysis raster, every
+ * channel, the TAC heatmap, and (if the PDF has OCGs) every layer
+ * for a given page.
+ *
+ * @public
+ */
+export interface BrowserViewerServices extends ViewerServices {
+    /** How many pages the underlying PDF has (resolves once parsed). */
+    getPageCount(): Promise<number>;
+    /** Page dimensions in PDF points for `pageNum` (1-indexed). */
+    getPageDimensions(pageNum: number): Promise<{
+        widthPts: number;
+        heightPts: number;
+    }>;
+    /**
+     * Inks the densitometer + color picker will report on. Always
+     * includes the four CMYK process plates pdf.js composites in RGB,
+     * plus any spot inks we could extract from the raw PDF bytes
+     * (Separation / DeviceN declarations outside compressed streams).
+     * Resolves once the PDF has been parsed.
+     */
+    getInks(): Promise<DetectedInk[]>;
+    /**
+     * Pre-build analysis raster + every CMYK channel image + the TAC
+     * heatmap + every layer image for `pageNum`. Resolves once they're
+     * all cached so the synchronous URL builders return real blob URLs
+     * rather than placeholders. Hosts mounting `<SeparationCanvas>`,
+     * `<TACHeatmapOverlay>`, or `<LayerCanvas>` should `await` this
+     * before mounting the canvas — those components cache the first
+     * loaded image and never retry on URL change.
+     */
+    prepare(pageNum: number, opts?: {
+        tacLimit?: number;
+    }): Promise<{
+        widthPts: number;
+        heightPts: number;
+        layerCount: number;
+    }>;
+    /**
+     * Subscribe to "URL available" notifications. Components that read
+     * synchronous URL builders (`pageImages.getPageImageUrl` in
+     * particular) should re-render on each event so the next builder
+     * call returns the freshly-cached blob URL instead of the
+     * placeholder.
+     */
+    subscribe(listener: () => void): () => void;
+    /** Free every blob URL the services minted. Call on unmount. */
+    dispose(): void;
+}
+/**
+ * Build a fully-wired {@link ViewerServices} backed by pdf.js. Every
+ * service the package consumes is implemented; consumers can drop the
+ * returned object straight into a `<ViewerServicesContext.Provider>`
+ * and every viewer-only feature works.
+ *
+ * @public
+ */
+export declare function createBrowserViewerServices(opts: BrowserViewerServicesOptions): BrowserViewerServices;
+/**
+ * React hook that re-renders whenever a {@link BrowserViewerServices}
+ * instance fires a `subscribe` event (i.e. a lazily-built page tile,
+ * channel image, heatmap, or annotation has become available).
+ *
+ * Use this in the top-level component that holds the services instance
+ * so children re-read the synchronous URL builders and pick up freshly-
+ * cached blob URLs.
+ *
+ * @public
+ */
+export declare function useBrowserViewerServicesVersion(services: BrowserViewerServices | null | undefined): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE9G,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AA8B5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb;gEAC4D;IAC5D,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB;;;;kDAI8C;IAC9C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,QAA2E,CAAC;AAuEhH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CACvB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAM7D;AAgGD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,CAsC3E;AA6HD;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,oEAAoE;IACpE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,+DAA+D;IAC/D,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClC;;;;;;;;OAQG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,gEAAgE;IAChE,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,4BAA4B,GACjC,qBAAqB,CAizBvB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAOR"}