@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/page-editor-chrome/SpellCheckHighlightings.js

@@ -0,0 +1,197 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState, useSyncExternalStore, } from "react";
+import { useEditContext } from "../client/editContext";
+import { collectFindReplaceItemSources, descriptorKey, } from "../find-replace/findReplaceTargets";
+import { usePageViewState, } from "../page-viewer/pageViewContext";
+import { spellCheckCanvasStore } from "../spellcheck/spellCheckCanvasStore";
+import { collectSpellCheckCanvasMatches, collectSpellCheckTargets, getSpellCheckCanvasClientKey, SPELLCHECK_BRIDGE_SOURCE, toSpellCheckBridgeTextRange, } from "../spellcheck/spellCheckCanvasTargets";
+import { spellCheckClient } from "../spellcheck/spellCheckClient";
+import { SPELLCHECK_UNDERLINE_HEIGHT, spellCheckUnderlineClass, } from "../spellcheck/spellCheckStyles";
+import { useSpellCheckEnabled } from "../spellcheck/useSpellCheck";
+import { measureBridgeTextRangeRects, rectListEquals, } from "./overlay/geometry";
+import { useOverlayMeasurement } from "./overlay/useOverlayMeasurement";
+import { buildOverviewRulerMarks, usePublishOverviewRulerMarks, } from "../page-viewer/overviewRuler";
+export const SPELLCHECK_HIGHLIGHT_TEST_ID = "spellcheck-highlight";
+const EMPTY_ITEMS = [];
+function measuredMatchesEqual(previous, next) {
+    if (previous.length !== next.length)
+        return false;
+    for (let i = 0; i < previous.length; i++) {
+        const a = previous[i];
+        const b = next[i];
+        if (a.key !== b.key || a.word !== b.word)
+            return false;
+        if (!rectListEquals(a.rects, b.rects))
+            return false;
+    }
+    return true;
+}
+/**
+ * Underlines misspelled words on the canvas without touching the site DOM:
+ * the writable text fields of the page's items are checked through the shared
+ * client, every misspelling is published as a bridge text range (the same
+ * primitive find-and-replace, comments and version diff use), and the rects
+ * the bridge reports get a wavy strip along their bottom edge.
+ */
+export function SpellCheckHighlightings({ pageViewContext, }) {
+    const editContext = useEditContext();
+    const preferenceEnabled = useSpellCheckEnabled();
+    const enabled = preferenceEnabled && !!editContext && editContext.mode === "edit";
+    const sources = useMemo(() => editContext
+        ? collectFindReplaceItemSources({
+            page: editContext.page,
+            item: editContext.item,
+            currentItemDescriptor: editContext.currentItemDescriptor,
+            scope: editContext.page?.rootComponent ? "page" : "item",
+        })
+        : [], [editContext?.page, editContext?.item, editContext?.currentItemDescriptor]);
+    // The page object is replaced on every canvas refresh; reload only when the
+    // set of items changed or a field value changed underneath us.
+    const signature = sources.map((source) => descriptorKey(source.descriptor)).join("|");
+    const sourcesRef = useRef(sources);
+    sourcesRef.current = sources;
+    const [items, setItems] = useState(EMPTY_ITEMS);
+    const [reloadTick, setReloadTick] = useState(0);
+    const itemsRepository = editContext?.itemsRepository;
+    useEffect(() => {
+        if (!enabled || !itemsRepository)
+            return;
+        let cancelled = false;
+        itemsRepository
+            .getItems(sourcesRef.current.map((source) => source.descriptor))
+            .then((loaded) => {
+            if (!cancelled)
+                setItems(loaded);
+        })
+            .catch((error) => {
+            console.error("[SpellCheckHighlightings] Could not load items", error);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [enabled, itemsRepository, signature, reloadTick]);
+    useEffect(() => {
+        if (!enabled || !itemsRepository)
+            return;
+        let timer;
+        const unsubscribe = itemsRepository.subscribeItemsChanged(() => {
+            if (timer !== undefined)
+                window.clearTimeout(timer);
+            timer = window.setTimeout(() => setReloadTick((tick) => tick + 1), 150);
+        });
+        return () => {
+            unsubscribe();
+            if (timer !== undefined)
+                window.clearTimeout(timer);
+        };
+    }, [enabled, itemsRepository]);
+    const targets = useMemo(() => (enabled ? collectSpellCheckTargets(items, sources) : []), [enabled, items, sources]);
+    // Register every target's text with the client and follow its results.
+    const revision = useSyncExternalStore(spellCheckClient.subscribe, spellCheckClient.getRevision, spellCheckClient.getRevision);
+    useEffect(() => {
+        targets.forEach((target) => spellCheckClient.request(getSpellCheckCanvasClientKey(target), target.language, target.text));
+        return () => {
+            targets.forEach((target) => spellCheckClient.release(getSpellCheckCanvasClientKey(target)));
+        };
+    }, [targets]);
+    const matches = useMemo(() => collectSpellCheckCanvasMatches(targets, (language, text) => spellCheckClient.getResult(language, text)?.misspellings), 
+    // The client revision is what makes fresh results visible.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [targets, revision]);
+    useEffect(() => {
+        spellCheckCanvasStore.set(matches, targets);
+    }, [matches, targets]);
+    useEffect(() => () => spellCheckCanvasStore.reset(), []);
+    const textRanges = useMemo(() => matches.map(toSpellCheckBridgeTextRange), [matches]);
+    const lastPublishedSignatureRef = useRef("");
+    const bridgeReady = usePageViewState(pageViewContext, (state) => state.bridgeReady);
+    const bridgeGeometry = usePageViewState(pageViewContext, (state) => state.bridgeGeometry);
+    useEffect(() => {
+        if (!bridgeReady) {
+            lastPublishedSignatureRef.current = "";
+            return;
+        }
+        const rangesSignature = textRanges.length > 0 ? JSON.stringify(textRanges) : "";
+        if (rangesSignature === lastPublishedSignatureRef.current)
+            return;
+        let cancelled = false;
+        let retryTimer;
+        let retryCount = 0;
+        const publish = () => {
+            if (cancelled)
+                return;
+            // The frame installs requestBridgeGeometry after its children mounted
+            // and a reconnect can briefly reject commands; only remember the
+            // signature once the bridge accepted it.
+            const accepted = pageViewContext.requestBridgeGeometry?.({
+                source: SPELLCHECK_BRIDGE_SOURCE,
+                textRanges,
+            });
+            if (accepted) {
+                lastPublishedSignatureRef.current = rangesSignature;
+                return;
+            }
+            const delay = Math.min(50 * 2 ** retryCount, 500);
+            retryCount += 1;
+            retryTimer = window.setTimeout(publish, delay);
+        };
+        publish();
+        return () => {
+            cancelled = true;
+            if (retryTimer !== undefined)
+                window.clearTimeout(retryTimer);
+        };
+    }, [pageViewContext, bridgeReady, textRanges]);
+    useEffect(() => () => {
+        pageViewContext.requestBridgeGeometry?.({
+            source: SPELLCHECK_BRIDGE_SOURCE,
+            textRanges: [],
+        });
+    }, [pageViewContext]);
+    const measured = useOverlayMeasurement((metrics) => {
+        const geometry = bridgeGeometry;
+        if (!geometry || matches.length === 0)
+            return [];
+        const result = [];
+        matches.forEach((match) => {
+            const seen = new Set();
+            const rects = measureBridgeTextRangeRects(geometry, match.key, metrics).filter((rect) => {
+                const rectKey = `${Math.round(rect.x)}:${Math.round(rect.y)}:${Math.round(rect.width)}:${Math.round(rect.height)}`;
+                if (seen.has(rectKey))
+                    return false;
+                seen.add(rectKey);
+                return true;
+            });
+            if (rects.length === 0)
+                return;
+            result.push({ key: match.key, word: match.word, rects });
+        });
+        return result;
+    }, [bridgeGeometry, matches], {
+        initialValue: [],
+        equals: measuredMatchesEqual,
+        interests: ["viewport", "layout", "text", "adornment-data"],
+    });
+    // The canvas overview ruler marks every misspelled word on the page; a
+    // click scrolls to it.
+    const rulerMarks = useMemo(() => {
+        if (!enabled || measured.length === 0)
+            return null;
+        return buildOverviewRulerMarks(measured.map((match) => ({
+            tone: "spelling",
+            rects: match.rects,
+            ids: [match.key],
+            details: [match.word],
+        })));
+    }, [enabled, measured]);
+    usePublishOverviewRulerMarks("spelling", rulerMarks);
+    if (!enabled || measured.length === 0)
+        return null;
+    return (_jsx(_Fragment, { children: measured.flatMap((match) => match.rects.map((rect, index) => (_jsx("div", { className: `${spellCheckUnderlineClass} pointer-events-none absolute`, "data-testid": SPELLCHECK_HIGHLIGHT_TEST_ID, "data-word": match.word, style: {
+                top: rect.y + rect.height - SPELLCHECK_UNDERLINE_HEIGHT,
+                left: rect.x,
+                width: Math.max(rect.width, 2),
+                height: SPELLCHECK_UNDERLINE_HEIGHT,
+            } }, `${match.key}-${index}`)))) }));
+}
+//# sourceMappingURL=SpellCheckHighlightings.js.map

package/dist/editor/page-editor-chrome/SpellCheckHighlightings.js.map

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

package/dist/editor/page-editor-chrome/ValidationRulerMarks.d.ts

@@ -0,0 +1,11 @@
+import { type PageViewContext } from "../page-viewer/pageViewContext";
+/**
+ * Marks the page's validation issues on the canvas overview ruler, one dash
+ * per field in its worst severity's colour, the messages as its tooltip. A
+ * click scrolls to the field, selects its component and focuses the field, so
+ * the form shows the issue. Issues on fields the canvas does not render have
+ * no place on the ruler; the Validation sidebar lists them.
+ */
+export declare function ValidationRulerMarks({ pageViewContext, }: {
+    pageViewContext: PageViewContext;
+}): null;

package/dist/editor/page-editor-chrome/ValidationRulerMarks.js

@@ -0,0 +1,56 @@
+import { useCallback, useMemo } from "react";
+import { useEditContext, useFieldsEditContext } from "../client/editContext";
+import { usePageViewState, } from "../page-viewer/pageViewContext";
+import { buildOverviewRulerMarks, overviewRulerMarksEqual, usePublishOverviewRulerMarks, } from "../page-viewer/overviewRuler";
+import { collectValidationRulerIssues } from "../validation/validationRulerIssues";
+import { measureBridgeFieldRect } from "./overlay/geometry";
+import { useOverlayMeasurement } from "./overlay/useOverlayMeasurement";
+/**
+ * Marks the page's validation issues on the canvas overview ruler, one dash
+ * per field in its worst severity's colour, the messages as its tooltip. A
+ * click scrolls to the field, selects its component and focuses the field, so
+ * the form shows the issue. Issues on fields the canvas does not render have
+ * no place on the ruler; the Validation sidebar lists them.
+ */
+export function ValidationRulerMarks({ pageViewContext, }) {
+    const editContext = useEditContext();
+    const fieldsContext = useFieldsEditContext();
+    const bridgeGeometry = usePageViewState(pageViewContext, (state) => state.bridgeGeometry);
+    const bridgeStructure = usePageViewState(pageViewContext, (state) => state.bridgeStructure);
+    const issues = useMemo(() => collectValidationRulerIssues(editContext?.validationResult), [editContext?.validationResult]);
+    const marks = useOverlayMeasurement((metrics) => {
+        if (!bridgeGeometry || issues.length === 0)
+            return null;
+        const measured = buildOverviewRulerMarks(issues.flatMap((issue) => {
+            const rect = measureBridgeFieldRect(bridgeGeometry, bridgeStructure, issue.field, metrics);
+            return rect
+                ? [
+                    {
+                        tone: `validation-${issue.severity}`,
+                        rects: [rect],
+                        ids: [issue.key],
+                        details: issue.messages,
+                    },
+                ]
+                : [];
+        }));
+        return measured.length > 0 ? measured : null;
+    }, [bridgeGeometry, bridgeStructure, issues], {
+        initialValue: null,
+        equals: overviewRulerMarksEqual,
+        interests: ["viewport", "layout", "text"],
+    });
+    const select = editContext?.select;
+    const setFocusedField = fieldsContext?.setFocusedField;
+    const focusIssue = useCallback((mark, scrollToMark) => {
+        scrollToMark();
+        const issue = issues.find((candidate) => candidate.key === mark.ids?.[0]);
+        if (!issue)
+            return;
+        select?.([issue.field.item.id]);
+        void setFocusedField?.(issue.field, false);
+    }, [issues, select, setFocusedField]);
+    usePublishOverviewRulerMarks("validation", marks, focusIssue);
+    return null;
+}
+//# sourceMappingURL=ValidationRulerMarks.js.map

package/dist/editor/page-editor-chrome/ValidationRulerMarks.js.map

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

package/dist/editor/page-editor-chrome/diffRulerSegments.d.ts

@@ -0,0 +1,18 @@
+import type { DiffRangeKind } from "../version-diff/versionDiffTargets";
+import type { OverlayRect } from "./overlay/geometry";
+export type DiffRulerSegment = {
+    top: number;
+    height: number;
+    kind: "added" | "removed";
+};
+export declare const DIFF_RULER_MIN_SEGMENT_HEIGHT = 3;
+/**
+ * Collapses highlight rects into the vertical dashes of an overview ruler:
+ * one dash per run of changes, so a paragraph of edits reads as a single
+ * mark instead of a stack of overlapping slivers. Removals keep their own
+ * colour and are merged separately from additions.
+ */
+export declare function buildDiffRulerSegments(highlights: ReadonlyArray<{
+    kind: DiffRangeKind;
+    rects: OverlayRect[];
+}>): DiffRulerSegment[];

package/dist/editor/page-editor-chrome/diffRulerSegments.js

@@ -0,0 +1,37 @@
+export const DIFF_RULER_MIN_SEGMENT_HEIGHT = 3;
+/**
+ * Collapses highlight rects into the vertical dashes of an overview ruler:
+ * one dash per run of changes, so a paragraph of edits reads as a single
+ * mark instead of a stack of overlapping slivers. Removals keep their own
+ * colour and are merged separately from additions.
+ */
+export function buildDiffRulerSegments(highlights) {
+    const byKind = {
+        added: [],
+        removed: [],
+    };
+    for (const highlight of highlights) {
+        const kind = highlight.kind === "removed" ? "removed" : "added";
+        for (const rect of highlight.rects) {
+            const top = Math.round(rect.y);
+            const height = Math.max(Math.round(rect.height), DIFF_RULER_MIN_SEGMENT_HEIGHT);
+            byKind[kind].push({ top, height, kind });
+        }
+    }
+    const merged = [];
+    for (const kind of ["added", "removed"]) {
+        const sorted = byKind[kind].sort((a, b) => a.top - b.top);
+        for (const segment of sorted) {
+            const last = merged[merged.length - 1];
+            if (last &&
+                last.kind === kind &&
+                segment.top <= last.top + last.height + 1) {
+                last.height = Math.max(last.height, segment.top + segment.height - last.top);
+                continue;
+            }
+            merged.push({ ...segment });
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=diffRulerSegments.js.map

package/dist/editor/page-editor-chrome/diffRulerSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffRulerSegments.js","sourceRoot":"","sources":["../../../src/editor/page-editor-chrome/diffRulerSegments.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAwE;IAExE,MAAM,MAAM,GAAyD;QACnE,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EACvB,6BAA6B,CAC9B,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,SAAS,CAAU,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1D,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACvC,IACE,IAAI;gBACJ,IAAI,CAAC,IAAI,KAAK,IAAI;gBAClB,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EACzC,CAAC;gBACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,MAAM,EACX,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CACxC,CAAC;gBACF,SAAS;YACX,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/editor/page-editor-chrome/overlay/feedbackAnchorMeasurements.d.ts

@@ -0,0 +1,44 @@
+import type { PageViewState } from "../../page-viewer/pageViewContext";
+import { OverlayRect } from "./geometry";
+/**
+ * Measured canvas geometry of one feedback item (comment thread or suggested
+ * edit): the document-space rects of its anchored text, or of the field /
+ * component it falls back to when no text range can be resolved.
+ */
+export type AnchorMeasurement = {
+    rects: OverlayRect[];
+    isTextRange: boolean;
+};
+export type AnchorMeasurements = Record<string, AnchorMeasurement>;
+export declare function anchorMeasurementsEqual(previous: AnchorMeasurements, next: AnchorMeasurements): boolean;
+export declare function roundMeasurement(value: number): number;
+/** Groups feedback items that share the same measured rects. */
+export declare function getAnchorMeasurementKey(measurement: AnchorMeasurement): string;
+export declare function dedupeOverlayRects(rects: OverlayRect[]): OverlayRect[];
+/**
+ * The point a margin card and its leader line attach to: the top of the
+ * anchored text, the vertical middle of its first line, and where that first
+ * line ends so a leader can leave the text without crossing it.
+ */
+export type FeedbackAnchor = {
+    y: number;
+    lineMidY: number;
+    /** Where the first line starts (for a tick mark at the text). */
+    xStart: number;
+    xEnd: number;
+    height: number;
+};
+export declare function getFeedbackAnchor(measurement: AnchorMeasurement | undefined): FeedbackAnchor | null;
+export declare function hasAnyExpectedBridgeTextRange(geometry: PageViewState["bridgeGeometry"], textRanges: {
+    key: string;
+}[]): boolean;
+/** Range key of the `index`-th item a feedback range may live on (0 = primary). */
+export declare function getFallbackTextRangeKey(key: string, index: number): string;
+/**
+ * Whether every expected range is there. A range queried on several candidate
+ * items (`getFallbackTextRangeKey`) only ever resolves on one of them, so it
+ * counts as soon as any of its keys does.
+ */
+export declare function hasAllExpectedBridgeTextRanges(geometry: PageViewState["bridgeGeometry"], textRanges: {
+    key: string;
+}[]): boolean;

package/dist/editor/page-editor-chrome/overlay/feedbackAnchorMeasurements.js

@@ -0,0 +1,89 @@
+import { rectListEquals } from "./geometry";
+export function anchorMeasurementsEqual(previous, next) {
+    const previousKeys = Object.keys(previous);
+    const nextKeys = Object.keys(next);
+    if (previousKeys.length !== nextKeys.length)
+        return false;
+    for (const key of previousKeys) {
+        const previousValue = previous[key];
+        const nextValue = next[key];
+        if (!previousValue || !nextValue)
+            return false;
+        if (previousValue.isTextRange !== nextValue.isTextRange)
+            return false;
+        if (!rectListEquals(previousValue.rects, nextValue.rects))
+            return false;
+    }
+    return true;
+}
+export function roundMeasurement(value) {
+    return Math.round(value * 2) / 2;
+}
+/** Groups feedback items that share the same measured rects. */
+export function getAnchorMeasurementKey(measurement) {
+    const rectKey = measurement.rects
+        .map((rect) => `${roundMeasurement(rect.x)}:${roundMeasurement(rect.y)}:${roundMeasurement(rect.width)}:${roundMeasurement(rect.height)}`)
+        .join("|");
+    return `${measurement.isTextRange ? "text" : "box"}:${rectKey}`;
+}
+export function dedupeOverlayRects(rects) {
+    const seen = new Set();
+    return rects.filter((rect) => {
+        const key = [
+            Math.round(rect.x * 100),
+            Math.round(rect.y * 100),
+            Math.round(rect.width * 100),
+            Math.round(rect.height * 100),
+        ].join(":");
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+export function getFeedbackAnchor(measurement) {
+    if (!measurement || measurement.rects.length === 0)
+        return null;
+    let first = measurement.rects[0];
+    for (const rect of measurement.rects) {
+        if (rect.y < first.y - 0.5 ||
+            (Math.abs(rect.y - first.y) <= 0.5 && rect.x < first.x)) {
+            first = rect;
+        }
+    }
+    const y = Math.min(...measurement.rects.map((rect) => rect.y));
+    const bottom = Math.max(...measurement.rects.map((rect) => rect.y + rect.height));
+    return {
+        y,
+        lineMidY: first.y + first.height / 2,
+        xStart: first.x,
+        xEnd: first.x + first.width,
+        height: Math.max(0, bottom - y),
+    };
+}
+export function hasAnyExpectedBridgeTextRange(geometry, textRanges) {
+    if (!geometry)
+        return false;
+    const expectedKeys = new Set(textRanges.map((range) => range.key));
+    return geometry.targets.some((target) => target.kind === "textRange" && expectedKeys.has(target.key));
+}
+const FALLBACK_RANGE_KEY_SUFFIX = /:alt\d+$/;
+/** Range key of the `index`-th item a feedback range may live on (0 = primary). */
+export function getFallbackTextRangeKey(key, index) {
+    return index === 0 ? key : `${key}:alt${index}`;
+}
+/**
+ * Whether every expected range is there. A range queried on several candidate
+ * items (`getFallbackTextRangeKey`) only ever resolves on one of them, so it
+ * counts as soon as any of its keys does.
+ */
+export function hasAllExpectedBridgeTextRanges(geometry, textRanges) {
+    if (!geometry)
+        return false;
+    const baseKey = (key) => key.replace(FALLBACK_RANGE_KEY_SUFFIX, "");
+    const availableKeys = new Set(geometry.targets
+        .filter((target) => target.kind === "textRange")
+        .map((target) => baseKey(target.key)));
+    return textRanges.every((range) => availableKeys.has(baseKey(range.key)));
+}
+//# sourceMappingURL=feedbackAnchorMeasurements.js.map

package/dist/editor/page-editor-chrome/overlay/feedbackAnchorMeasurements.js.map

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

package/dist/editor/page-editor-chrome/overlay/feedbackAnchorStore.d.ts

@@ -0,0 +1,17 @@
+import type { AnchorMeasurements } from "./feedbackAnchorMeasurements";
+/**
+ * The canvas overlay's measured comment and suggestion anchors, shared per
+ * iframe with the comment margin beside it. The margin never measures on its
+ * own: its cards must sit exactly where the highlights are, and one source of
+ * truth is the only way to guarantee that.
+ */
+export type FeedbackAnchorSnapshot = {
+    comments: AnchorMeasurements;
+    suggestions: AnchorMeasurements;
+};
+export declare function publishCommentAnchors(key: object | null | undefined, comments: AnchorMeasurements): void;
+export declare function publishSuggestionAnchors(key: object | null | undefined, suggestions: AnchorMeasurements): void;
+export declare function getFeedbackAnchors(key: object | null | undefined): FeedbackAnchorSnapshot;
+export declare function subscribeFeedbackAnchors(key: object | null | undefined, listener: () => void): () => void;
+/** The canvas anchors published for `key` (the page iframe element). */
+export declare function useFeedbackAnchors(key: object | null | undefined): FeedbackAnchorSnapshot;

package/dist/editor/page-editor-chrome/overlay/feedbackAnchorStore.js

@@ -0,0 +1,53 @@
+import { useCallback, useSyncExternalStore } from "react";
+const EMPTY_SNAPSHOT = Object.freeze({
+    comments: {},
+    suggestions: {},
+});
+const entries = new WeakMap();
+function getEntry(key) {
+    let entry = entries.get(key);
+    if (!entry) {
+        entry = { snapshot: EMPTY_SNAPSHOT, listeners: new Set() };
+        entries.set(key, entry);
+    }
+    return entry;
+}
+function publish(key, patch) {
+    if (!key)
+        return;
+    const entry = getEntry(key);
+    const next = { ...entry.snapshot, ...patch };
+    if (next.comments === entry.snapshot.comments &&
+        next.suggestions === entry.snapshot.suggestions) {
+        return;
+    }
+    entry.snapshot = next;
+    entry.listeners.forEach((listener) => listener());
+}
+export function publishCommentAnchors(key, comments) {
+    publish(key, { comments });
+}
+export function publishSuggestionAnchors(key, suggestions) {
+    publish(key, { suggestions });
+}
+export function getFeedbackAnchors(key) {
+    if (!key)
+        return EMPTY_SNAPSHOT;
+    return entries.get(key)?.snapshot ?? EMPTY_SNAPSHOT;
+}
+export function subscribeFeedbackAnchors(key, listener) {
+    if (!key)
+        return () => { };
+    const entry = getEntry(key);
+    entry.listeners.add(listener);
+    return () => {
+        entry.listeners.delete(listener);
+    };
+}
+/** The canvas anchors published for `key` (the page iframe element). */
+export function useFeedbackAnchors(key) {
+    const subscribe = useCallback((listener) => subscribeFeedbackAnchors(key, listener), [key]);
+    const getSnapshot = useCallback(() => getFeedbackAnchors(key), [key]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+//# sourceMappingURL=feedbackAnchorStore.js.map

package/dist/editor/page-editor-chrome/overlay/feedbackAnchorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackAnchorStore.js","sourceRoot":"","sources":["../../../../src/editor/page-editor-chrome/overlay/feedbackAnchorStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAmB1D,MAAM,cAAc,GAA2B,MAAM,CAAC,MAAM,CAAC;IAC3D,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;CAChB,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAiB,CAAC;AAE7C,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CACd,GAA8B,EAC9B,KAAsC;IAEtC,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IAC7C,IACE,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACzC,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,QAAQ,CAAC,WAAW,EAC/C,CAAC;QACD,OAAO;IACT,CAAC;IACD,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,GAA8B,EAC9B,QAA4B;IAE5B,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,GAA8B,EAC9B,WAA+B;IAE/B,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAA8B;IAC/D,IAAI,CAAC,GAAG;QAAE,OAAO,cAAc,CAAC;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,cAAc,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,GAA8B,EAC9B,QAAoB;IAEpB,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE;QACV,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,GAA8B;IAC/D,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,QAAoB,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,EACjE,CAAC,GAAG,CAAC,CACN,CAAC;IACF,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACnE,CAAC"}

package/dist/editor/page-editor-chrome/overlay/useBridgeTextRangeRequest.d.ts

@@ -0,0 +1,11 @@
+import { type BridgeGeometryQuery, type PageViewContext } from "../../page-viewer/pageViewContext";
+export type BridgeTextRangeRequest = NonNullable<BridgeGeometryQuery["textRanges"]>[number];
+export declare function getBridgeTextRangeSignature(textRanges: BridgeTextRangeRequest[]): string;
+/**
+ * Keeps the canvas bridge's text-range geometry for one overlay feature
+ * (`source`) in sync with the ranges that feature currently needs. The bridge
+ * only answers with rects for ranges that were queried, so every consumer
+ * re-queries when its set changes, when the page re-rendered and the targets
+ * vanished, or when a previous query never produced any target.
+ */
+export declare function useBridgeTextRangeRequest(pageViewContext: PageViewContext, source: string, textRanges: BridgeTextRangeRequest[], enabled?: boolean): void;