@parhelia/core 0.3.12832 → 0.3.12833

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;

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

@@ -0,0 +1,84 @@
+import { useEffect, useMemo, useRef } from "react";
+import { usePageViewState, } from "../../page-viewer/pageViewContext";
+import { hasAllExpectedBridgeTextRanges, hasAnyExpectedBridgeTextRange, } from "./feedbackAnchorMeasurements";
+export function getBridgeTextRangeSignature(textRanges) {
+    return textRanges
+        .map((range) => [
+        range.key,
+        range.elementKey ?? "",
+        range.fieldId ?? "",
+        range.item?.id ?? "",
+        range.item?.language ?? "",
+        range.item?.version ?? "",
+        range.start,
+        range.end,
+    ].join(":"))
+        .join("|");
+}
+/**
+ * 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 function useBridgeTextRangeRequest(pageViewContext, source, textRanges, enabled = true) {
+    // A readiness flip or a new geometry re-runs the effect: a comment that
+    // arrives during the bridge's reconnect (ready false for a few ms after a
+    // page load) is queried once the bridge is back.
+    const bridgeReady = usePageViewState(pageViewContext, (state) => state.bridgeReady);
+    const bridgeGeometry = usePageViewState(pageViewContext, (state) => state.bridgeGeometry);
+    const requestStateRef = useRef({
+        signature: "",
+        requestedSignature: "",
+        hasSeenAnyTarget: false,
+    });
+    const signature = useMemo(() => getBridgeTextRangeSignature(textRanges), [textRanges]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const requestState = requestStateRef.current;
+        if (!bridgeReady || textRanges.length === 0) {
+            if (bridgeReady && requestState.signature !== "") {
+                // Drop our contribution from the shared union so the highlights clear
+                // instead of lingering as phantom geometry targets.
+                pageViewContext.requestBridgeGeometry?.({ source, textRanges: [] });
+            }
+            requestState.signature = "";
+            requestState.requestedSignature = "";
+            requestState.hasSeenAnyTarget = false;
+            return;
+        }
+        const signatureChanged = requestState.signature !== signature;
+        if (signatureChanged) {
+            requestState.signature = signature;
+            requestState.requestedSignature = "";
+            requestState.hasSeenAnyTarget = false;
+        }
+        const hasAnyTarget = hasAnyExpectedBridgeTextRange(bridgeGeometry, textRanges);
+        const hasAllTargets = hasAllExpectedBridgeTextRanges(bridgeGeometry, textRanges);
+        if (hasAnyTarget) {
+            requestState.hasSeenAnyTarget = true;
+        }
+        if (hasAllTargets && !signatureChanged) {
+            requestState.requestedSignature = "";
+            return;
+        }
+        const shouldRequest = signatureChanged ||
+            requestState.requestedSignature !== signature ||
+            (requestState.hasSeenAnyTarget && !hasAnyTarget);
+        if (!shouldRequest)
+            return;
+        requestState.requestedSignature = signature;
+        pageViewContext.requestBridgeGeometry?.({ source, textRanges });
+    }, [
+        enabled,
+        pageViewContext,
+        bridgeReady,
+        bridgeGeometry,
+        source,
+        textRanges,
+        signature,
+    ]);
+}
+//# sourceMappingURL=useBridgeTextRangeRequest.js.map

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

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

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

@@ -0,0 +1,34 @@
+import type { SelectionRange } from "../../client/editContext";
+import type { Comment } from "../../../types";
+import { type PageViewContext } from "../../page-viewer/pageViewContext";
+import type { FieldDescriptor } from "../../pageModel";
+import { OverlayRect } from "./geometry";
+import { type AnchorMeasurements } from "./feedbackAnchorMeasurements";
+export declare const COMMENT_BRIDGE_SOURCE = "comments";
+export type CommentAnchorMeasurementsOptions = {
+    /**
+     * Whether this consumer asks the bridge for the text-range geometry. The
+     * canvas highlight layer does; secondary readers (margin, minimap) reuse the
+     * rects the canvas already requested.
+     */
+    request?: boolean;
+};
+export type CommentAnchorMeasurementsResult = {
+    measurements: AnchorMeasurements;
+    draftRects: OverlayRect[];
+    draftRange: SelectionRange | undefined;
+};
+/**
+ * Measures where each comment sits on the canvas: its anchored text range
+ * when the bridge resolved one, else the field, else the component, else the
+ * transient selection rect captured when the comment was drafted.
+ *
+ * Must run inside an `IframeOverlayProvider`.
+ */
+export declare function useCommentAnchorMeasurements(pageViewContext: PageViewContext, comments: Comment[], options?: CommentAnchorMeasurementsOptions): CommentAnchorMeasurementsResult;
+/**
+ * Geometry key for the comment's n-th candidate item: the comment's own key
+ * for its item, suffixed keys for the page / related-item fallbacks.
+ */
+export declare function getCommentCandidateTextRangeKey(comment: Comment, candidateIndex: number): string;
+export declare function getCommentFieldDescriptors(comment: Comment): FieldDescriptor[];

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

@@ -0,0 +1,229 @@
+import { useEffect, useMemo, useRef, useState } from "react";
+import { usePageViewState, } from "../../page-viewer/pageViewContext";
+import { getComponentById } from "../../componentTreeHelper";
+import { normalizeMarkerId } from "../../utils";
+import { COMMENT_DRAFT_SELECTION_EVENT, COMMENT_TRANSIENT_SELECTION_RECT, } from "../../reviews/commentTransientSelection";
+import { getCommentTextRange, getCommentTextRangeKey, getCommentTransientElementKey, } from "../../reviews/feedbackScrollTarget";
+import { measureBridgeComponentRect, measureBridgeFieldRect, measureBridgeTextRangeRects, rectListEquals, toOverlayRect, } from "./geometry";
+import { anchorMeasurementsEqual, dedupeOverlayRects, getFallbackTextRangeKey, } from "./feedbackAnchorMeasurements";
+import { useBridgeTextRangeRequest, } from "./useBridgeTextRangeRequest";
+import { useOverlayMeasurement } from "./useOverlayMeasurement";
+export const COMMENT_BRIDGE_SOURCE = "comments";
+const COMMENT_DRAFT_TEXT_RANGE_KEY = "comment-draft-selection";
+/**
+ * Measures where each comment sits on the canvas: its anchored text range
+ * when the bridge resolved one, else the field, else the component, else the
+ * transient selection rect captured when the comment was drafted.
+ *
+ * Must run inside an `IframeOverlayProvider`.
+ */
+export function useCommentAnchorMeasurements(pageViewContext, comments, options = {}) {
+    const { request = true } = options;
+    const lastMeasurementsRef = useRef({});
+    const [commentDraftRange, setCommentDraftRange] = useState();
+    const page = usePageViewState(pageViewContext, (state) => state.page);
+    const bridgeGeometry = usePageViewState(pageViewContext, (state) => state.bridgeGeometry);
+    const bridgeStructure = usePageViewState(pageViewContext, (state) => state.bridgeStructure);
+    const editorIframe = usePageViewState(pageViewContext, (state) => state.editorIframe);
+    useEffect(() => {
+        const handleDraftSelection = (event) => {
+            const detail = event
+                .detail;
+            setCommentDraftRange(detail?.range);
+        };
+        window.addEventListener(COMMENT_DRAFT_SELECTION_EVENT, handleDraftSelection);
+        return () => {
+            window.removeEventListener(COMMENT_DRAFT_SELECTION_EVENT, handleDraftSelection);
+        };
+    }, []);
+    const bridgeTextRanges = useMemo(() => {
+        const commentRanges = comments.flatMap((comment) => {
+            const range = getCommentTextRange(comment);
+            if (!comment.fieldId || !range)
+                return [];
+            // The comment's own item is the anchor; the page and related items are
+            // fallbacks for comments whose item is not rendered. They get their own
+            // keys so a fallback match cannot compete with the real one.
+            return getCommentFieldDescriptors(comment).map((descriptor, index) => ({
+                key: getCommentCandidateTextRangeKey(comment, index),
+                elementKey: getCommentTransientElementKey(comment),
+                fieldId: descriptor.fieldId,
+                item: descriptor.item,
+                start: range[0],
+                end: range[1],
+            }));
+        });
+        const draftRange = getDraftBridgeTextRange(commentDraftRange);
+        return draftRange ? [...commentRanges, draftRange] : commentRanges;
+    }, [comments, commentDraftRange]);
+    useBridgeTextRangeRequest(pageViewContext, COMMENT_BRIDGE_SOURCE, bridgeTextRanges, request);
+    const measurements = useOverlayMeasurement((metrics, reasons) => {
+        const canReusePreviousMeasurement = !reasons.has("viewport") &&
+            !reasons.has("layout") &&
+            !reasons.has("text");
+        const nextMeasurements = {};
+        for (const comment of comments) {
+            const textRange = getCommentTextRange(comment);
+            const fieldDescriptors = getCommentFieldDescriptors(comment);
+            const hasTextRange = !!comment.fieldId && !!textRange;
+            let textRangeRects = [];
+            if (hasTextRange) {
+                for (let index = 0; index < fieldDescriptors.length; index++) {
+                    textRangeRects = dedupeOverlayRects(measureBridgeTextRangeRects(bridgeGeometry, getCommentCandidateTextRangeKey(comment, index), metrics));
+                    if (textRangeRects.length > 0)
+                        break;
+                }
+            }
+            const previousMeasurement = lastMeasurementsRef.current[comment.id];
+            const previousTextRangeRects = canReusePreviousMeasurement && previousMeasurement?.isTextRange
+                ? previousMeasurement.rects
+                : [];
+            let rects = [];
+            let isTextRange = false;
+            if (hasTextRange) {
+                rects = textRangeRects.length
+                    ? textRangeRects
+                    : previousTextRangeRects.length
+                        ? previousTextRangeRects
+                        : getTransientSelectionRects(comment, metrics, editorIframe);
+                isTextRange = rects.length > 0;
+            }
+            else {
+                const fallbackRect = fieldDescriptors
+                    .map((descriptor) => measureBridgeFieldRect(bridgeGeometry, bridgeStructure, descriptor, metrics))
+                    .find((rect) => !!rect) ??
+                    measureBridgeCommentComponentRect(comment, page, bridgeGeometry, metrics);
+                rects = fallbackRect
+                    ? [fallbackRect]
+                    : canReusePreviousMeasurement && previousMeasurement?.rects.length
+                        ? previousMeasurement.rects
+                        : [];
+                isTextRange =
+                    !fallbackRect &&
+                        canReusePreviousMeasurement &&
+                        previousMeasurement?.isTextRange === true;
+            }
+            if (rects.length > 0) {
+                nextMeasurements[comment.id] = { rects, isTextRange };
+            }
+        }
+        return nextMeasurements;
+    }, [bridgeGeometry, bridgeStructure, editorIframe, comments, page], {
+        initialValue: {},
+        equals: anchorMeasurementsEqual,
+        interests: ["viewport", "layout", "text", "adornment-data"],
+    });
+    const draftRects = useOverlayMeasurement((metrics) => {
+        if (!commentDraftRange)
+            return [];
+        const bridgeRects = dedupeOverlayRects(measureBridgeTextRangeRects(bridgeGeometry, COMMENT_DRAFT_TEXT_RANGE_KEY, metrics));
+        const fallbackRects = getSelectionRangeClientRects(commentDraftRange, metrics, editorIframe);
+        return bridgeRects.length ? bridgeRects : fallbackRects;
+    }, [commentDraftRange, bridgeGeometry, editorIframe], {
+        initialValue: [],
+        equals: rectListEquals,
+        interests: ["viewport", "layout", "text", "adornment-data"],
+    });
+    useEffect(() => {
+        lastMeasurementsRef.current = measurements;
+    }, [measurements]);
+    return { measurements, draftRects, draftRange: commentDraftRange };
+}
+function getDraftBridgeTextRange(range) {
+    const textRange = getSelectionTextRange(range);
+    if (!range?.fieldId || !range.itemId || !textRange)
+        return undefined;
+    return {
+        key: COMMENT_DRAFT_TEXT_RANGE_KEY,
+        elementKey: range.elementKey,
+        fieldId: range.fieldId,
+        item: {
+            id: range.itemId,
+            language: range.language || "",
+            version: typeof range.version === "number" ? range.version : undefined,
+        },
+        start: textRange[0],
+        end: textRange[1],
+    };
+}
+function getSelectionTextRange(range) {
+    if (!range?.text?.trim() ||
+        typeof range.startOffset !== "number" ||
+        typeof range.endOffset !== "number") {
+        return null;
+    }
+    const start = Math.max(0, Math.min(range.startOffset, range.endOffset));
+    const end = Math.max(start, range.startOffset, range.endOffset);
+    return end > start ? [start, end] : null;
+}
+/**
+ * Geometry key for the comment's n-th candidate item: the comment's own key
+ * for its item, suffixed keys for the page / related-item fallbacks.
+ */
+export function getCommentCandidateTextRangeKey(comment, candidateIndex) {
+    return getFallbackTextRangeKey(getCommentTextRangeKey(comment), candidateIndex);
+}
+export function getCommentFieldDescriptors(comment) {
+    if (!comment.fieldId)
+        return [];
+    const items = getCommentCandidateItems(comment);
+    return items.map((item) => ({
+        fieldId: comment.fieldId,
+        item,
+    }));
+}
+function getCommentCandidateItems(comment) {
+    const candidates = [];
+    const addCandidate = (id) => {
+        if (!id)
+            return;
+        const normalizedId = normalizeMarkerId(id);
+        if (candidates.some((candidate) => normalizeMarkerId(candidate.id) === normalizedId)) {
+            return;
+        }
+        candidates.push({
+            id,
+            language: comment.language,
+            version: comment.version,
+        });
+    };
+    addCandidate(comment.itemId);
+    addCandidate(comment.mainItemId);
+    comment.relatedItems?.forEach((item) => addCandidate(item.itemId));
+    return candidates;
+}
+function measureBridgeCommentComponentRect(comment, page, bridgeGeometry, metrics) {
+    if (!page)
+        return null;
+    for (const item of getCommentCandidateItems(comment)) {
+        const component = getComponentById(item.id, page);
+        if (!component)
+            continue;
+        const measurement = measureBridgeComponentRect(bridgeGeometry, component, metrics);
+        if (measurement?.rect)
+            return measurement.rect;
+    }
+    return null;
+}
+function getTransientSelectionRects(comment, metrics, iframe) {
+    const rect = comment[COMMENT_TRANSIENT_SELECTION_RECT];
+    return rect ? viewportSelectionRectToOverlayRects(rect, metrics, iframe) : [];
+}
+function getSelectionRangeClientRects(range, metrics, iframe) {
+    const rect = range.clientRect;
+    return rect ? viewportSelectionRectToOverlayRects(rect, metrics, iframe) : [];
+}
+function viewportSelectionRectToOverlayRects(rect, metrics, iframe) {
+    if (!rect || rect.width <= 0 || rect.height <= 0)
+        return [];
+    const iframeRect = iframe?.getBoundingClientRect();
+    return [
+        toOverlayRect({
+            left: iframeRect ? rect.left - iframeRect.left : rect.left,
+            top: iframeRect ? rect.top - iframeRect.top : rect.top,
+            width: rect.width,
+            height: rect.height,
+        }, metrics),
+    ];
+}
+//# sourceMappingURL=useCommentAnchorMeasurements.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { OverlayMetrics } from "./geometry";
+/**
+ * Right edge of the visible canvas viewport in overlay (document) coordinates.
+ * Unlike `viewportWidth` alone this follows horizontal scrolling, so a line
+ * drawn to the viewport edge keeps reaching it after the page scrolled
+ * sideways. Updated on every scroll and measurement pass.
+ */
+export declare function getOverlayViewportRight(metrics: OverlayMetrics): number;
+export declare function useOverlayViewportRight(): number;

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

@@ -0,0 +1,34 @@
+import { useEffect, useState } from "react";
+import { useIframeOverlay } from "./IframeOverlayProvider";
+/**
+ * Right edge of the visible canvas viewport in overlay (document) coordinates.
+ * Unlike `viewportWidth` alone this follows horizontal scrolling, so a line
+ * drawn to the viewport edge keeps reaching it after the page scrolled
+ * sideways. Updated on every scroll and measurement pass.
+ */
+export function getOverlayViewportRight(metrics) {
+    return (metrics.scrollLeft * metrics.scrollScale * metrics.visualScale +
+        metrics.viewportWidth);
+}
+export function useOverlayViewportRight() {
+    const overlay = useIframeOverlay();
+    const [right, setRight] = useState(() => getOverlayViewportRight(overlay.getMetrics()));
+    useEffect(() => {
+        const update = (metrics) => {
+            const next = getOverlayViewportRight(metrics);
+            setRight((current) => (current === next ? current : next));
+        };
+        update(overlay.getMetrics());
+        const unsubscribeScroll = overlay.subscribeScroll(update);
+        const unsubscribeMeasurement = overlay.subscribeMeasurement(update, [
+            "viewport",
+            "layout",
+        ]);
+        return () => {
+            unsubscribeScroll();
+            unsubscribeMeasurement();
+        };
+    }, [overlay]);
+    return right;
+}
+//# sourceMappingURL=useOverlayViewportRight.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayViewportRight.js","sourceRoot":"","sources":["../../../../src/editor/page-editor-chrome/overlay/useOverlayViewportRight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,OAAO,CACL,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW;QAC9D,OAAO,CAAC,aAAa,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CACtC,uBAAuB,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAC9C,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,CAAC,OAAuB,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;YAC9C,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7B,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE;YAClE,UAAU;YACV,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,iBAAiB,EAAE,CAAC;YACpB,sBAAsB,EAAE,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,49 @@
+import type { SuggestedEdit } from "../../../types";
+import type { EditContextType } from "../../client/editContext";
+import { type PageViewContext } from "../../page-viewer/pageViewContext";
+import { type SuggestionRangeData } from "../../reviews/feedbackScrollTarget";
+import { type AnchorMeasurements } from "./feedbackAnchorMeasurements";
+export declare const SUGGESTION_BRIDGE_SOURCE = "suggestions";
+export type SuggestionFieldValue = {
+    rawValue: string;
+    itemId: string;
+    language: string;
+    version: number;
+    fieldId: string;
+};
+export type SuggestionAnchorMeasurementsOptions = {
+    /** See `useCommentAnchorMeasurements`. */
+    request?: boolean;
+};
+export type SuggestionAnchorMeasurementsResult = {
+    measurements: AnchorMeasurements;
+    hiddenSuggestionIds: Set<string>;
+    rangeDataBySuggestionId: Record<string, SuggestionRangeData>;
+    fieldValueByIdentity: Record<string, SuggestionFieldValue>;
+    fieldIdentityBySuggestionId: Record<string, string>;
+    previewsSuggestedText: (suggestion: SuggestedEdit) => boolean;
+};
+/** Suggestions that still need a decision and therefore mark the canvas. */
+export declare function getOpenSuggestions(suggestedEdits: SuggestedEdit[]): SuggestedEdit[];
+/**
+ * The single suggestion whose suggested text the canvas shows because its
+ * card is selected. A decided suggestion is never previewed (an applied one
+ * already is the field's text, a rejected one left the original), so
+ * selecting one leaves the field as it is and must not hide its open
+ * siblings on that field.
+ */
+export declare function getPreviewedSuggestionId({ suggestions, selectedSuggestedEditId, previewsAllSuggestions, showSelectedSuggestionOnPage, }: {
+    suggestions: readonly SuggestedEdit[];
+    selectedSuggestedEditId: string | undefined;
+    previewsAllSuggestions: boolean;
+    showSelectedSuggestionOnPage: boolean | undefined;
+}): string | undefined;
+/**
+ * Resolves each suggestion to the text ranges it changes (diffing its old
+ * and new value against the field's current value) and measures those ranges
+ * on the canvas. Callers pass the open suggestions for highlighting, or every
+ * listed suggestion when the measurements also position margin cards.
+ *
+ * Must run inside an `IframeOverlayProvider`.
+ */
+export declare function useSuggestionAnchorMeasurements(pageViewContext: PageViewContext, editContext: EditContextType | undefined, suggestions: SuggestedEdit[], options?: SuggestionAnchorMeasurementsOptions): SuggestionAnchorMeasurementsResult;