@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/sidebar/liveComponentThumbnails.d.ts

@@ -0,0 +1,66 @@
+import { type CSSProperties } from "react";
+import type { PageSnapshotResultEventPayload } from "../bridge/protocol";
+import { type PageViewContext } from "../page-viewer/pageViewContext";
+export type ThumbnailRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * One raster of the whole page plus the component boxes inside it. Rows crop
+ * their own thumbnail out of the shared image with CSS background positioning,
+ * so a page with thirty components costs one capture and zero canvases here.
+ */
+export type LiveComponentThumbnailSheet = {
+    imageUrl: string;
+    /** CSS pixel size of the captured page; rects share this space. */
+    width: number;
+    height: number;
+    rects: Map<string, ThumbnailRect>;
+};
+/** Quiet time after the last host DOM mutation before the page is recaptured. */
+export declare const LIVE_THUMBNAIL_DEBOUNCE_MS = 1200;
+/** Delay for the first capture after thumbnails are switched on. */
+export declare const LIVE_THUMBNAIL_INITIAL_DELAY_MS = 300;
+export declare const LIVE_THUMBNAIL_BOX: {
+    width: number;
+    height: number;
+};
+/** Allow long pages while the host limits total pixels and sizes for each crop. */
+export declare const LIVE_THUMBNAIL_MAX_DIMENSION = 16384;
+export declare function buildThumbnailSheet(payload: PageSnapshotResultEventPayload, imageUrl: string): LiveComponentThumbnailSheet;
+export declare function findThumbnailRect(sheet: LiveComponentThumbnailSheet, componentId: string | null | undefined): ThumbnailRect | null;
+/**
+ * CSS that shows exactly one component's crop of the sheet inside a box of the
+ * given size. Always fits the entire component, including tall modules in a
+ * narrow viewport. Clip the shared page image to the component's bounds so
+ * neighboring components cannot show through the unused space.
+ */
+export declare function getThumbnailBackgroundStyle(sheet: LiveComponentThumbnailSheet, rect: ThumbnailRect, box: {
+    width: number;
+    height: number;
+}): CSSProperties;
+/**
+ * Turns the host's data URL into an object URL so thirty rows reference one
+ * short blob URL instead of each inlining a megabyte of base64 into their
+ * style attribute. Falls back to the data URL where object URLs are missing.
+ */
+export declare function toThumbnailImageUrl(dataUrl: string): string;
+export type LiveComponentThumbnails = {
+    /** Null until the first capture lands, or when the bridge is unavailable. */
+    sheet: LiveComponentThumbnailSheet | null;
+    /**
+     * True while thumbnails are on and the first sheet is still on its way
+     * (bridge warming up or capture pending). False once a sheet exists, when
+     * the context cannot capture at all, or after the first capture failed.
+     */
+    loading: boolean;
+};
+/**
+ * Keeps a fresh page sheet while `enabled`: captures shortly after switching
+ * on, then again a little after every burst of host DOM mutations (typing,
+ * inserts, reorders, refreshes). Only one capture runs at a time; changes that
+ * arrive mid-capture queue exactly one follow-up.
+ */
+export declare function useLiveComponentThumbnails(pageViewContext: PageViewContext | undefined, enabled: boolean): LiveComponentThumbnails;

package/dist/editor/sidebar/liveComponentThumbnails.js

@@ -0,0 +1,225 @@
+import { useEffect, useRef, useState } from "react";
+import { normalizeBridgeKey } from "../bridge/bridgeKeys";
+import { usePageViewState, } from "../page-viewer/pageViewContext";
+/** Quiet time after the last host DOM mutation before the page is recaptured. */
+export const LIVE_THUMBNAIL_DEBOUNCE_MS = 1200;
+/** Delay for the first capture after thumbnails are switched on. */
+export const LIVE_THUMBNAIL_INITIAL_DELAY_MS = 300;
+export const LIVE_THUMBNAIL_BOX = { width: 56, height: 36 };
+/** Allow long pages while the host limits total pixels and sizes for each crop. */
+export const LIVE_THUMBNAIL_MAX_DIMENSION = 16_384;
+export function buildThumbnailSheet(payload, imageUrl) {
+    const rects = new Map();
+    for (const component of payload.components ?? []) {
+        const id = normalizeBridgeKey(component.componentId || component.key);
+        if (!id || rects.has(id))
+            continue;
+        if (component.width <= 0 || component.height <= 0)
+            continue;
+        rects.set(id, {
+            x: component.x,
+            y: component.y,
+            width: component.width,
+            height: component.height,
+        });
+    }
+    return {
+        imageUrl,
+        width: Math.max(1, payload.width ?? 1),
+        height: Math.max(1, payload.height ?? 1),
+        rects,
+    };
+}
+export function findThumbnailRect(sheet, componentId) {
+    return sheet.rects.get(normalizeBridgeKey(componentId)) ?? null;
+}
+/**
+ * CSS that shows exactly one component's crop of the sheet inside a box of the
+ * given size. Always fits the entire component, including tall modules in a
+ * narrow viewport. Clip the shared page image to the component's bounds so
+ * neighboring components cannot show through the unused space.
+ */
+export function getThumbnailBackgroundStyle(sheet, rect, box) {
+    const scale = Math.min(box.width / rect.width, box.height / rect.height, 1);
+    const insetX = Math.max(0, (box.width - rect.width * scale) / 2);
+    const insetY = Math.max(0, (box.height - rect.height * scale) / 2);
+    const offsetX = insetX - rect.x * scale;
+    const offsetY = insetY - rect.y * scale;
+    return {
+        backgroundImage: `url("${sheet.imageUrl}")`,
+        backgroundRepeat: "no-repeat",
+        backgroundSize: `${round(sheet.width * scale)}px ${round(sheet.height * scale)}px`,
+        backgroundPosition: `${round(offsetX)}px ${round(offsetY)}px`,
+        clipPath: `inset(${round(insetY)}px ${round(insetX)}px)`,
+    };
+}
+function round(value) {
+    return Math.round(value * 100) / 100;
+}
+/**
+ * Turns the host's data URL into an object URL so thirty rows reference one
+ * short blob URL instead of each inlining a megabyte of base64 into their
+ * style attribute. Falls back to the data URL where object URLs are missing.
+ */
+export function toThumbnailImageUrl(dataUrl) {
+    if (typeof URL === "undefined" ||
+        typeof URL.createObjectURL !== "function" ||
+        typeof Blob === "undefined") {
+        return dataUrl;
+    }
+    try {
+        const comma = dataUrl.indexOf(",");
+        const header = dataUrl.slice(0, comma);
+        const body = dataUrl.slice(comma + 1);
+        const mimeMatch = /^data:([^;,]+)/.exec(header);
+        const mime = mimeMatch?.[1] ?? "image/png";
+        if (!/;base64$/i.test(header)) {
+            return dataUrl;
+        }
+        const binary = atob(body);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return URL.createObjectURL(new Blob([bytes], { type: mime }));
+    }
+    catch {
+        return dataUrl;
+    }
+}
+function revokeThumbnailImageUrl(url) {
+    if (!url || !url.startsWith("blob:"))
+        return;
+    try {
+        URL.revokeObjectURL(url);
+    }
+    catch {
+        // Already revoked or unsupported - nothing to release.
+    }
+}
+/**
+ * Keeps a fresh page sheet while `enabled`: captures shortly after switching
+ * on, then again a little after every burst of host DOM mutations (typing,
+ * inserts, reorders, refreshes). Only one capture runs at a time; changes that
+ * arrive mid-capture queue exactly one follow-up.
+ */
+export function useLiveComponentThumbnails(pageViewContext, enabled) {
+    const [sheet, setSheet] = useState(null);
+    const [initialCaptureFailed, setInitialCaptureFailed] = useState(false);
+    const sheetRef = useRef(null);
+    const timerRef = useRef(null);
+    const inFlightRef = useRef(false);
+    const dirtyRef = useRef(false);
+    const disposedRef = useRef(false);
+    const bridgeReady = !!usePageViewState(pageViewContext, (state) => state.bridgeReady);
+    const canvasAttached = !!usePageViewState(pageViewContext, (state) => state.canvasAttached);
+    const bridgeStructure = usePageViewState(pageViewContext, (state) => state.bridgeStructure);
+    const active = enabled && bridgeReady && canvasAttached;
+    useEffect(() => {
+        disposedRef.current = false;
+        return () => {
+            disposedRef.current = true;
+            if (timerRef.current !== null) {
+                window.clearTimeout(timerRef.current);
+                timerRef.current = null;
+            }
+            revokeThumbnailImageUrl(sheetRef.current?.imageUrl);
+            sheetRef.current = null;
+        };
+    }, []);
+    useEffect(() => {
+        if (!active) {
+            setInitialCaptureFailed(false);
+            if (timerRef.current !== null) {
+                window.clearTimeout(timerRef.current);
+                timerRef.current = null;
+            }
+            dirtyRef.current = false;
+            if (sheetRef.current) {
+                revokeThumbnailImageUrl(sheetRef.current.imageUrl);
+                sheetRef.current = null;
+                setSheet(null);
+            }
+            return;
+        }
+        const capture = async () => {
+            timerRef.current = null;
+            const request = pageViewContext?.requestBridgePageSnapshot;
+            if (!request || !pageViewContext?.getState().bridgeReady)
+                return;
+            if (inFlightRef.current) {
+                dirtyRef.current = true;
+                return;
+            }
+            inFlightRef.current = true;
+            dirtyRef.current = false;
+            try {
+                const payload = await request({
+                    maxDimension: LIVE_THUMBNAIL_MAX_DIMENSION,
+                    thumbnailSize: {
+                        width: LIVE_THUMBNAIL_BOX.width * 2,
+                        height: LIVE_THUMBNAIL_BOX.height * 2,
+                    },
+                });
+                if (disposedRef.current)
+                    return;
+                if (payload.dataUrl && !payload.error) {
+                    const next = buildThumbnailSheet(payload, toThumbnailImageUrl(payload.dataUrl));
+                    revokeThumbnailImageUrl(sheetRef.current?.imageUrl);
+                    sheetRef.current = next;
+                    setSheet(next);
+                    setInitialCaptureFailed(false);
+                }
+                else if (!sheetRef.current) {
+                    setInitialCaptureFailed(true);
+                }
+            }
+            catch {
+                // Keep the previous sheet; the next DOM change retries.
+                if (!disposedRef.current && !sheetRef.current) {
+                    setInitialCaptureFailed(true);
+                }
+            }
+            finally {
+                inFlightRef.current = false;
+                if (dirtyRef.current && !disposedRef.current) {
+                    schedule(LIVE_THUMBNAIL_DEBOUNCE_MS);
+                }
+            }
+        };
+        const schedule = (delay) => {
+            if (timerRef.current !== null) {
+                window.clearTimeout(timerRef.current);
+            }
+            timerRef.current = window.setTimeout(() => {
+                void capture();
+            }, delay);
+        };
+        // Every new DOM snapshot of the host is a mutation burst to settle.
+        let lastDom = pageViewContext?.getState().bridgeDom;
+        const unsubscribe = pageViewContext?.subscribe(() => {
+            const dom = pageViewContext.getState().bridgeDom;
+            if (dom === lastDom)
+                return;
+            lastDom = dom;
+            schedule(LIVE_THUMBNAIL_DEBOUNCE_MS);
+        });
+        schedule(sheetRef.current
+            ? LIVE_THUMBNAIL_DEBOUNCE_MS
+            : LIVE_THUMBNAIL_INITIAL_DELAY_MS);
+        return () => {
+            unsubscribe?.();
+            if (timerRef.current !== null) {
+                window.clearTimeout(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+        // A new structure means components were added, removed or reordered; the
+        // effect re-runs and schedules a debounced recapture.
+    }, [active, pageViewContext, bridgeStructure]);
+    // A not-yet-ready bridge still counts as loading: the page is warming up and
+    // the capture follows. A context that cannot capture at all never loads.
+    const loading = enabled && canvasAttached && !sheet && !initialCaptureFailed;
+    return { sheet, loading };
+}
+//# sourceMappingURL=liveComponentThumbnails.js.map

package/dist/editor/sidebar/liveComponentThumbnails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveComponentThumbnails.js","sourceRoot":"","sources":["../../../src/editor/sidebar/liveComponentThumbnails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAsB,MAAM,OAAO,CAAC;AAExE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAEL,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AAsBxC,iFAAiF;AACjF,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,oEAAoE;AACpE,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC5D,mFAAmF;AACnF,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD,MAAM,UAAU,mBAAmB,CACjC,OAAuC,EACvC,QAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QACtE,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QACnC,IAAI,SAAS,CAAC,KAAK,IAAI,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QAC5D,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YACZ,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,MAAM,EAAE,SAAS,CAAC,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACxC,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAkC,EAClC,WAAsC;IAEtC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAkC,EAClC,IAAmB,EACnB,GAAsC;IAEtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;IACxC,OAAO;QACL,eAAe,EAAE,QAAQ,KAAK,CAAC,QAAQ,IAAI;QAC3C,gBAAgB,EAAE,WAAW;QAC7B,cAAc,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI;QAClF,kBAAkB,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI;QAC7D,QAAQ,EAAE,SAAS,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IACE,OAAO,GAAG,KAAK,WAAW;QAC1B,OAAO,GAAG,CAAC,eAAe,KAAK,UAAU;QACzC,OAAO,IAAI,KAAK,WAAW,EAC3B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,GAA8B;IAC7D,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IAC7C,IAAI,CAAC;QACH,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;AACH,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,eAA4C,EAC5C,OAAgB;IAEhB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAqC,IAAI,CAAC,CAAC;IAC7E,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAqC,IAAI,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,CAAC,CAAC,gBAAgB,CACpC,eAAe,EACf,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAC7B,CAAC;IACF,MAAM,cAAc,GAAG,CAAC,CAAC,gBAAgB,CACvC,eAAe,EACf,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAChC,CAAC;IACF,MAAM,eAAe,GAAG,gBAAgB,CACtC,eAAe,EACf,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,CACjC,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,IAAI,WAAW,IAAI,cAAc,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;QAC5B,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACtC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,uBAAuB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpD,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACtC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;YACzB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACnD,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,MAAM,OAAO,GAAG,eAAe,EAAE,yBAAyB,CAAC;YAC3D,IAAI,CAAC,OAAO,IAAI,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,WAAW;gBAAE,OAAO;YACjE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;gBACxB,OAAO;YACT,CAAC;YACD,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;oBAC5B,YAAY,EAAE,4BAA4B;oBAC1C,aAAa,EAAE;wBACb,KAAK,EAAE,kBAAkB,CAAC,KAAK,GAAG,CAAC;wBACnC,MAAM,EAAE,kBAAkB,CAAC,MAAM,GAAG,CAAC;qBACtC;iBACF,CAAC,CAAC;gBACH,IAAI,WAAW,CAAC,OAAO;oBAAE,OAAO;gBAChC,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACtC,MAAM,IAAI,GAAG,mBAAmB,CAC9B,OAAO,EACP,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CACrC,CAAC;oBACF,uBAAuB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;oBACpD,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,CAAC;oBACf,uBAAuB,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;qBAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC7B,uBAAuB,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;gBACxD,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC9C,uBAAuB,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC5B,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;oBAC7C,QAAQ,CAAC,0BAA0B,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;YACjC,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;YACD,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBACxC,KAAK,OAAO,EAAE,CAAC;YACjB,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC,CAAC;QAEF,oEAAoE;QACpE,IAAI,OAAO,GAAG,eAAe,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC;QACpD,MAAM,WAAW,GAAG,eAAe,EAAE,SAAS,CAAC,GAAG,EAAE;YAClD,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC;YACjD,IAAI,GAAG,KAAK,OAAO;gBAAE,OAAO;YAC5B,OAAO,GAAG,GAAG,CAAC;YACd,QAAQ,CAAC,0BAA0B,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,QAAQ,CACN,QAAQ,CAAC,OAAO;YACd,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,+BAA+B,CACpC,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,EAAE,CAAC;YAChB,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACtC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;QACF,yEAAyE;QACzE,sDAAsD;IACxD,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;IAE/C,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAAO,IAAI,cAAc,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC;IAE7E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/dist/editor/spellcheck/canvasSpellCheckContextMenu.d.ts

@@ -0,0 +1,30 @@
+import type { MenuItem } from "../../config/types";
+import type { BridgeGeometrySnapshot } from "../bridge/protocol";
+import type { FieldDescriptor } from "../pageModel";
+import { type SpellCheckClient } from "./spellCheckClient";
+export declare const SPANS_FORMATTING_MESSAGE = "This word spans formatting; edit it in the side panel.";
+/** The slice of the edit context the canvas menu needs. */
+export type CanvasSpellCheckEditor = {
+    operations: {
+        editField(args: {
+            field: FieldDescriptor;
+            value: string;
+            refresh: "none" | "immediate";
+            saveMode: "immediate";
+        }): Promise<unknown>;
+    };
+};
+/**
+ * The spell-check section of the canvas context menu: suggestions for the
+ * misspelling under the right-clicked point, or nothing when the point is not
+ * over one. Replacement goes through the same field write the find-and-replace
+ * dialog uses, after the guard proved the field value is still the checked one.
+ */
+export declare function buildCanvasSpellCheckMenuItems(args: {
+    editor: CanvasSpellCheckEditor;
+    geometry: BridgeGeometrySnapshot | undefined;
+    clientX: number | undefined;
+    clientY: number | undefined;
+    enabled?: boolean;
+    client?: SpellCheckClient;
+}): Promise<MenuItem[]>;

package/dist/editor/spellcheck/canvasSpellCheckContextMenu.js

@@ -0,0 +1,69 @@
+import { toast } from "sonner";
+import { captureReplacement, STALE_REPLACEMENT_MESSAGE, verifyReplacement, } from "./replacementGuard";
+import { spellCheckClient } from "./spellCheckClient";
+import { spellCheckCanvasStore } from "./spellCheckCanvasStore";
+import { findSpellCheckTargetAtPoint } from "./spellCheckCanvasTargets";
+import { addWordToDictionary, buildSpellCheckMenuItems, SPELLCHECK_MENU_ID_PREFIX, } from "./spellCheckContextMenu";
+import { replaceRenderedRange } from "./spellCheckReplace";
+export const SPANS_FORMATTING_MESSAGE = "This word spans formatting; edit it in the side panel.";
+/**
+ * The spell-check section of the canvas context menu: suggestions for the
+ * misspelling under the right-clicked point, or nothing when the point is not
+ * over one. Replacement goes through the same field write the find-and-replace
+ * dialog uses, after the guard proved the field value is still the checked one.
+ */
+export async function buildCanvasSpellCheckMenuItems(args) {
+    if (args.enabled === false)
+        return [];
+    const key = findSpellCheckTargetAtPoint(args.geometry, args.clientX, args.clientY);
+    if (!key)
+        return [];
+    const match = spellCheckCanvasStore.getMatch(key);
+    if (!match)
+        return [];
+    const client = args.client ?? spellCheckClient;
+    const capture = captureReplacement(match.checkedText, {
+        start: match.start,
+        end: match.end,
+        word: match.word,
+    });
+    const items = await buildSpellCheckMenuItems({
+        language: match.language,
+        word: match.word,
+        onReplace: async (replacement) => {
+            const latest = spellCheckCanvasStore.getTarget(match.targetKey);
+            const verdict = verifyReplacement(capture, latest?.text ?? "");
+            if (!latest || !verdict.ok || latest.value !== match.value) {
+                toast.info(STALE_REPLACEMENT_MESSAGE);
+                client.invalidateLanguage(match.language);
+                return;
+            }
+            const next = replaceRenderedRange(latest.value, match.fieldType, capture.start, capture.end, capture.word, replacement);
+            if (next === undefined) {
+                toast.error(SPANS_FORMATTING_MESSAGE);
+                return;
+            }
+            await args.editor.operations.editField({
+                field: match.field,
+                value: next,
+                refresh: "immediate",
+                saveMode: "immediate",
+            });
+        },
+        onIgnore: () => client.ignoreWord(match.language, match.word),
+        onAddToDictionary: async () => {
+            await addWordToDictionary(match.language, match.word, client);
+        },
+    });
+    if (items.length === 0)
+        return [];
+    return [
+        {
+            id: `${SPELLCHECK_MENU_ID_PREFIX}heading`,
+            label: `Spelling: ${match.word}`,
+            disabled: true,
+        },
+        ...items,
+    ];
+}
+//# sourceMappingURL=canvasSpellCheckContextMenu.js.map

package/dist/editor/spellcheck/canvasSpellCheckContextMenu.js.map

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

package/dist/editor/spellcheck/htmlSpellDocument.d.ts

@@ -0,0 +1,60 @@
+import { type HtmlToken } from "./htmlSpellTokenizer";
+/**
+ * One parsed representation of a stored HTML value that serves both spell
+ * text extraction and replacement.
+ *
+ * - `text` is the spell-check text: every text token decoded with the full
+ *   HTML5 entity table and its line breaks normalized (`\r\n` and `\r` become
+ *   `\n`, as the browser's input preprocessing does), plus a `"\n"` separator
+ *   whenever a block-level element is entered or left and for `<br>` / `<hr>`.
+ *   Raw-text content (`script`, `style`, `textarea`, `title`) is part of the
+ *   browser's `textContent`, so it is kept at full length but masked with
+ *   spaces: nothing inside is ever checked and every later offset stays put.
+ * - Removing the separators yields exactly `element.textContent` of the
+ *   rendered value, which is the offset space the canvas bridge measures.
+ * - Every segment remembers its source range and a decoded→source mapping, so
+ *   a replacement rebuilds the value from untouched source slices and only
+ *   re-encodes the replaced word.
+ */
+export type HtmlSpellSegment = {
+    kind: "text" | "masked";
+    sourceStart: number;
+    sourceEnd: number;
+    /** Decoded, newline-normalized text (spaces for masked segments). */
+    decoded: string;
+    spellStart: number;
+    spellEnd: number;
+    /**
+     * Decoded runs with their source ranges, for mapping decoded offsets back
+     * to source offsets. Absent when the mapping could not be verified against
+     * the authoritative decode; such a segment is checked but never edited.
+     */
+    runs?: DecodedRun[];
+};
+export type DecodedRun = {
+    decStart: number;
+    decEnd: number;
+    srcStart: number;
+    srcEnd: number;
+};
+export type HtmlSpellDocument = {
+    source: string;
+    text: string;
+    separators: number[];
+    segments: HtmlSpellSegment[];
+    tokens: HtmlToken[];
+};
+export declare function parseHtmlSpellDocument(source: string): HtmlSpellDocument;
+/**
+ * Converts a spell-text offset to the matching `element.textContent` offset by
+ * discounting the separators inserted before it.
+ */
+export declare function toTextContentOffset(offset: number, separators: number[]): number;
+/**
+ * Replaces `[start, end)` of the spell text, which must lie inside one text
+ * segment and equal `word`, and returns the new source value. Everything
+ * outside the replaced word is copied from the source byte for byte; the
+ * replacement itself is entity-encoded. Returns undefined when the range spans
+ * a tag boundary, does not match `word`, or falls inside an entity.
+ */
+export declare function replaceInDocument(document: HtmlSpellDocument, start: number, end: number, word: string, replacement: string): string | undefined;

package/dist/editor/spellcheck/htmlSpellDocument.js

@@ -0,0 +1,181 @@
+import { decode, encode } from "html-entities";
+import { tokenizeHtml } from "./htmlSpellTokenizer";
+const ENTITY_PATTERN = /&(?:#[xX][0-9a-fA-F]+;?|#[0-9]+;?|[a-zA-Z][a-zA-Z0-9]*;?)/g;
+function decodeText(raw) {
+    return decode(raw, { level: "html5", scope: "body" });
+}
+/** `\r\n` and lone `\r` become `\n`, matching the HTML input stream preprocessing. */
+function normalizeNewlines(text) {
+    return text.replace(/\r\n?/g, "\n");
+}
+/**
+ * Decodes `raw` run by run (plain characters, entities, CRLF) and records the
+ * source range of every run. Returns undefined when the run-wise decode does
+ * not reproduce the authoritative decode, so callers never map offsets
+ * through an inconsistent table.
+ */
+function buildRuns(raw, decoded) {
+    const runs = [];
+    let out = "";
+    let src = 0;
+    let plainStart = -1;
+    const closePlain = (end) => {
+        if (plainStart < 0)
+            return;
+        runs.push({
+            decStart: out.length,
+            decEnd: out.length + (end - plainStart),
+            srcStart: plainStart,
+            srcEnd: end,
+        });
+        out += raw.slice(plainStart, end);
+        plainStart = -1;
+    };
+    while (src < raw.length) {
+        const code = raw.charCodeAt(src);
+        if (code === 13 /* \r */) {
+            closePlain(src);
+            const end = raw.charCodeAt(src + 1) === 10 ? src + 2 : src + 1;
+            runs.push({ decStart: out.length, decEnd: out.length + 1, srcStart: src, srcEnd: end });
+            out += "\n";
+            src = end;
+            continue;
+        }
+        if (code === 38 /* & */) {
+            ENTITY_PATTERN.lastIndex = src;
+            const match = ENTITY_PATTERN.exec(raw);
+            if (match && match.index === src) {
+                const entityText = decodeText(match[0]);
+                if (entityText !== match[0]) {
+                    closePlain(src);
+                    runs.push({
+                        decStart: out.length,
+                        decEnd: out.length + entityText.length,
+                        srcStart: src,
+                        srcEnd: src + match[0].length,
+                    });
+                    out += entityText;
+                    src += match[0].length;
+                    continue;
+                }
+            }
+        }
+        if (plainStart < 0)
+            plainStart = src;
+        src++;
+    }
+    closePlain(raw.length);
+    return out === decoded ? runs : undefined;
+}
+export function parseHtmlSpellDocument(source) {
+    const tokens = tokenizeHtml(source);
+    const segments = [];
+    const separators = [];
+    let text = "";
+    const separator = () => {
+        separators.push(text.length);
+        text += "\n";
+    };
+    for (const token of tokens) {
+        if (token.kind === "text") {
+            const raw = source.slice(token.start, token.end);
+            const decoded = normalizeNewlines(decodeText(raw));
+            const runs = buildRuns(raw, decoded);
+            segments.push({
+                kind: "text",
+                sourceStart: token.start,
+                sourceEnd: token.end,
+                decoded,
+                spellStart: text.length,
+                spellEnd: text.length + decoded.length,
+                runs,
+            });
+            text += decoded;
+            continue;
+        }
+        if (token.kind === "rawText") {
+            const raw = source.slice(token.start, token.end);
+            const content = normalizeNewlines(token.decodesEntities ? decodeText(raw) : raw);
+            const masked = " ".repeat(content.length);
+            segments.push({
+                kind: "masked",
+                sourceStart: token.start,
+                sourceEnd: token.end,
+                decoded: masked,
+                spellStart: text.length,
+                spellEnd: text.length + masked.length,
+            });
+            text += masked;
+            continue;
+        }
+        if (token.kind === "startTag") {
+            if (token.isBlock)
+                separator();
+            continue;
+        }
+        if (token.kind === "endTag") {
+            if (token.isBlock && !token.isVoid)
+                separator();
+        }
+    }
+    return { source, text, separators, segments, tokens };
+}
+/**
+ * Converts a spell-text offset to the matching `element.textContent` offset by
+ * discounting the separators inserted before it.
+ */
+export function toTextContentOffset(offset, separators) {
+    let count = 0;
+    for (const separator of separators) {
+        if (separator < offset)
+            count++;
+        else
+            break;
+    }
+    return offset - count;
+}
+/** Source offset of a decoded offset inside a segment, or undefined inside a multi-character decode. */
+function toSourceOffset(segment, decodedOffset) {
+    const runs = segment.runs;
+    if (!runs)
+        return undefined;
+    if (decodedOffset === segment.decoded.length)
+        return segment.sourceEnd;
+    // Run offsets are relative to the segment's raw text.
+    const base = segment.sourceStart;
+    for (const run of runs) {
+        if (decodedOffset < run.decStart || decodedOffset >= run.decEnd)
+            continue;
+        if (decodedOffset === run.decStart)
+            return base + run.srcStart;
+        const oneToOne = run.decEnd - run.decStart === run.srcEnd - run.srcStart;
+        return oneToOne ? base + run.srcStart + (decodedOffset - run.decStart) : undefined;
+    }
+    return decodedOffset === 0 ? segment.sourceStart : undefined;
+}
+/**
+ * Replaces `[start, end)` of the spell text, which must lie inside one text
+ * segment and equal `word`, and returns the new source value. Everything
+ * outside the replaced word is copied from the source byte for byte; the
+ * replacement itself is entity-encoded. Returns undefined when the range spans
+ * a tag boundary, does not match `word`, or falls inside an entity.
+ */
+export function replaceInDocument(document, start, end, word, replacement) {
+    if (end <= start)
+        return undefined;
+    const segment = document.segments.find((candidate) => candidate.kind === "text" && candidate.spellStart <= start && end <= candidate.spellEnd);
+    if (!segment)
+        return undefined;
+    const localStart = start - segment.spellStart;
+    const localEnd = end - segment.spellStart;
+    if (segment.decoded.slice(localStart, localEnd) !== word)
+        return undefined;
+    const sourceStart = toSourceOffset(segment, localStart);
+    const sourceEnd = toSourceOffset(segment, localEnd);
+    if (sourceStart === undefined || sourceEnd === undefined)
+        return undefined;
+    return (document.source.slice(0, sourceStart) +
+        encode(replacement, { mode: "specialChars" }) +
+        document.source.slice(sourceEnd));
+}
+//# sourceMappingURL=htmlSpellDocument.js.map

package/dist/editor/spellcheck/htmlSpellDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlSpellDocument.js","sourceRoot":"","sources":["../../../src/editor/spellcheck/htmlSpellDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAkDpE,MAAM,cAAc,GAAG,4DAA4D,CAAC;AAEpF,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,sFAAsF;AACtF,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,GAAW,EAAE,OAAe;IAC7C,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpB,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE;QACjC,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO;QAC3B,IAAI,CAAC,IAAI,CAAC;YACR,QAAQ,EAAE,GAAG,CAAC,MAAM;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC;YACvC,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;QACH,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAClC,UAAU,GAAG,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC;YACzB,UAAU,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAC/D,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxF,GAAG,IAAI,IAAI,CAAC;YACZ,GAAG,GAAG,GAAG,CAAC;YACV,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC;YACxB,cAAc,CAAC,SAAS,GAAG,GAAG,CAAC;YAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxC,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5B,UAAU,CAAC,GAAG,CAAC,CAAC;oBAChB,IAAI,CAAC,IAAI,CAAC;wBACR,QAAQ,EAAE,GAAG,CAAC,MAAM;wBACpB,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM;wBACtC,QAAQ,EAAE,GAAG;wBACb,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;qBAC9B,CAAC,CAAC;oBACH,GAAG,IAAI,UAAU,CAAC;oBAClB,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;oBACvB,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,UAAU,GAAG,CAAC;YAAE,UAAU,GAAG,GAAG,CAAC;QACrC,GAAG,EAAE,CAAC;IACR,CAAC;IACD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,IAAI,IAAI,CAAC;IACf,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,KAAK,CAAC,KAAK;gBACxB,SAAS,EAAE,KAAK,CAAC,GAAG;gBACpB,OAAO;gBACP,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;gBACtC,IAAI;aACL,CAAC,CAAC;YACH,IAAI,IAAI,OAAO,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,KAAK,CAAC,KAAK;gBACxB,SAAS,EAAE,KAAK,CAAC,GAAG;gBACpB,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;aACtC,CAAC,CAAC;YACH,IAAI,IAAI,MAAM,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO;gBAAE,SAAS,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,SAAS,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,UAAoB;IACtE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,GAAG,MAAM;YAAE,KAAK,EAAE,CAAC;;YAC3B,MAAM;IACb,CAAC;IACD,OAAO,MAAM,GAAG,KAAK,CAAC;AACxB,CAAC;AAED,wGAAwG;AACxG,SAAS,cAAc,CAAC,OAAyB,EAAE,aAAqB;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACvE,sDAAsD;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,aAAa,GAAG,GAAG,CAAC,QAAQ,IAAI,aAAa,IAAI,GAAG,CAAC,MAAM;YAAE,SAAS;QAC1E,IAAI,aAAa,KAAK,GAAG,CAAC,QAAQ;YAAE,OAAO,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC/D,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;QACzE,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,CAAC;IACD,OAAO,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA2B,EAC3B,KAAa,EACb,GAAW,EACX,IAAY,EACZ,WAAmB;IAEnB,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CACpC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,UAAU,IAAI,KAAK,IAAI,GAAG,IAAI,SAAS,CAAC,QAAQ,CAC1F,CAAC;IACF,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAC1C,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC3E,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3E,OAAO,CACL,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;QACrC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAC7C,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CACjC,CAAC;AACJ,CAAC"}