@parhelia/core 0.3.12771 → 0.3.12788

package/dist/editor/page-viewer/PageViewerFrame.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useLayoutEffect, useRef, useState, } from "react";
 import { BRIDGE_DOM_UPDATED_EVENT, MiniMap } from "./MiniMap";
 import { resolveMiniMapVisibility, } from "./minimapVisibility";
@@ -27,6 +27,7 @@ import { NoLayout } from "../page-editor-chrome/NoLayout";
 import { Spinner } from "../ui/Spinner";
 import { DeviceToolbar } from "./DeviceToolbar";
 import { FullscreenControls } from "../client/ui/FullscreenControls";
+import { PageSelector } from "../menubar/PageSelector";
 import { toSitecoreDate } from "../utils/sitecoreDate";
 import { pickVersionAtDate } from "../utils/versionAtDate";
 import { BridgeClient } from "../bridge/BridgeClient";
@@ -34,10 +35,12 @@ import { beginPerfTrace, isPerfTraceActive, isPerfTraceEnabled, perfTraceStep, }
 import { getPendingFieldSuggestions, getSuggestionSelectionKey, getSuggestionDisplayValue, } from "../reviews/suggestionDisplayValue";
 import { buildBridgeFieldPatchPayload, buildBridgeFieldPatchSignature, buildRemoteCaretFieldPatches, getBridgeFieldPatchValue, hasRemoteCaretDraftForField, isBridgePatchableTextField, isSuggestionPreviewPatchSignature, } from "./bridgeFieldPatch";
 import { bridgeSelectionMatchesInteraction, resolveBridgeTextCompletionInput, } from "./bridgeTextCompletion";
-import { logFieldValueDiagnostic, summarizeField, summarizeFieldDescriptor, summarizeFieldValue, } from "../fieldValueDiagnostics";
-import { createKeyboardEventFromBridgeInteraction } from "./bridgeKeyboardShortcuts";
+import { logFieldValueDiagnostic, summarizeFieldDescriptor, summarizeFieldValue, } from "../fieldValueDiagnostics";
+import { createKeyboardEventFromBridgeInteraction, getBridgeFieldHistoryStepDirection, INLINE_FIELD_HISTORY_STEP_EVENT, } from "./bridgeKeyboardShortcuts";
 import { formatParentBridgeInjectionDiagnostic, injectParheliaBridgeFromParent, } from "./parentBridgeInjection";
 import { getTextCompletion, normalizeTextCompletion, } from "../services/textCompletionService";
+import { resolvePageAndSiteByPath } from "../services/contentService";
+import { extractInternalLinkPath, extractInternalLinkTargetItemId, shouldOpenInternalLinkInNewSlot, } from "./internalLinkNavigation";
 const ZOOM_MIN = 0.25;
 const ZOOM_MAX = 2;
 const ZOOM_STEP = 0.25;
@@ -186,12 +189,10 @@ function bridgeHoverInteractionsEqual(left, right) {
 function findBridgeFieldDocumentBounds(geometry, descriptor) {
     if (!geometry)
         return undefined;
-    const target = geometry.targets.find((candidate) => {
-        if (candidate.kind !== "field")
-            return false;
-        return (bridgeKeysMatch(candidate.fieldId, descriptor.fieldId) &&
-            bridgeItemMatches(candidate.item, descriptor.item));
-    });
+    const matchingTargets = geometry.targets.filter((candidate) => candidate.kind === "field" &&
+        bridgeKeysMatch(candidate.fieldId, descriptor.fieldId) &&
+        bridgeItemMatches(candidate.item, descriptor.item));
+    const target = matchingTargets.find((candidate) => candidate.rect.width > 0 || candidate.rect.height > 0) ?? matchingTargets[0];
     return target?.rect
         ? bridgeTargetToDocumentBounds(geometry, target)
         : undefined;
@@ -307,6 +308,16 @@ function requestScrollTargetGeometry(pageViewContext, target) {
         textRanges,
     }) ?? false);
 }
+function getFocusedFieldScrollKey(field) {
+    const item = field.item;
+    return [
+        item.database || "",
+        item.id,
+        item.language,
+        item.version,
+        field.fieldId,
+    ].join("|");
+}
 function scrollBridgeBoundsIntoView(pageViewContext, bounds, currentScroll) {
     const geometry = pageViewContext.bridgeGeometry;
     if (!geometry)
@@ -619,6 +630,7 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     const bridgePatchSignatureRef = useRef(new Map());
     const bridgeTextRangeSourcesRef = useRef(new Map());
     const activeBridgeInlineEditRef = useRef(null);
+    const discardActiveFieldDraftOnNextRefreshRef = useRef(false);
     const [isBridgeInlineEditing, setIsBridgeInlineEditing] = useState(false);
     const bridgeInlineEditSessionRef = useRef(null);
     if (!bridgeInlineEditSessionRef.current) {
@@ -644,6 +656,10 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     const lastBridgeHoverInteractionRef = useRef(undefined);
     const [bridgeInteraction, setBridgeInteraction] = useState(undefined);
     const pendingRefreshScrollRef = useRef(undefined);
+    // #fragment carried by a canvas link navigation (preview click / alt+click).
+    // Applied to the next iframe src load so the browser lands the canvas on the
+    // linked section instead of the page top.
+    const pendingCanvasAnchorRef = useRef(undefined);
     // When the pending refresh scroll was captured, and when the last explicit
     // scrollBy command (minimap click/wheel) was issued. A capture is only safe
     // to restore while no explicit command is newer than it: the capture
@@ -660,6 +676,10 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     // needless refresh would drop scroll position and inline-edit state.
     const lastRenderSignatureRef = useRef(undefined);
     const lastRenderModeRef = useRef(editContext.mode);
+    // Last fullReloadToken this frame acted on. Each frame tracks it separately so
+    // a hard refresh reloads every open editor slot, not just the first to react.
+    // undefined until the first render pass, so mounting never counts as a request.
+    const lastFullReloadTokenRef = useRef(undefined);
     // Set when a canvas refresh (bridge patch or full reload) has been requested
     // and its result has not landed yet. While in flight, bridgeGeometry still
     // describes the PRE-refresh DOM — a moved component is still measured at its
@@ -738,6 +758,10 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     // change. Without this guard that blur re-render would scroll the just
     // clicked component into view after the suppress flag was already consumed.
     const lastScrolledSelectionKeyRef = useRef("");
+    // Field descriptors are cloned whenever the edit form is clicked. Track the
+    // stable field identity so repeated clicks inside the already-focused field
+    // do not keep re-centering it in the iframe.
+    const lastScrolledFocusedFieldKeyRef = useRef(undefined);
     const scrollIntoViewRequestRef = useRef({
         signature: "",
         requestedTextRangeGeometry: false,
@@ -849,10 +873,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     const sendBeginInlineEdit = useCallback((payload) => {
         const sent = bridgeClientRef.current?.sendCommand("beginInlineEdit", payload) ??
             false;
-        logFieldValueDiagnostic("bridge-frame", "beginInlineEdit command", {
-            sent,
-            payload,
-        });
         return sent;
     }, []);
     const sendCancelInlineEdit = useCallback((payload) => {
@@ -923,18 +943,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         sendApplyFieldPatch: sendApplyFieldPatchCommand,
     });
     const beginTrackedBridgeInlineEdit = useCallback(async (interaction) => {
-        logFieldValueDiagnostic("bridge-frame", "begin tracked inline edit", {
-            previousActiveInlineEdit: activeBridgeInlineEditRef.current,
-            interaction: {
-                kind: interaction.kind,
-                elementKey: interaction.elementKey,
-                fieldId: interaction.fieldId,
-                item: interaction.item,
-                selectedText: summarizeFieldValue(interaction.selectedText),
-                selectionStartOffset: interaction.selectionStartOffset,
-                selectionEndOffset: interaction.selectionEndOffset,
-            },
-        });
         if (!interaction.elementKey || !interaction.fieldId)
             return false;
         const interactionItem = interaction.item?.id &&
@@ -956,10 +964,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
             item: interactionItem,
             modeAtStart: editContextRef.current?.mode ?? editContext.mode,
         }, ({ isCurrent, sessionId }) => beginBridgeInlineEdit(interaction, { isCurrent, sessionId }));
-        logFieldValueDiagnostic("bridge-frame", "tracked inline edit result", {
-            started,
-            nextActiveInlineEdit: activeBridgeInlineEditRef.current,
-        });
         return started;
     }, [
         beginBridgeInlineEdit,
@@ -968,9 +972,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         editContextRef,
     ]);
     const endTrackedBridgeFieldFocus = useCallback(() => {
-        logFieldValueDiagnostic("bridge-frame", "ending tracked field focus", {
-            activeInlineEdit: activeBridgeInlineEditRef.current,
-        });
         clearActiveBridgeInlineEdit();
         endBridgeFieldFocus();
     }, [clearActiveBridgeInlineEdit, endBridgeFieldFocus]);
@@ -1060,26 +1061,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                 ? "suggestion-preview"
                 : "real",
         };
-        logFieldValueDiagnostic("bridge-patch", "display value resolved", {
-            showSuggestions,
-            preferRepositoryValue,
-            field: summarizeField(field),
-            structureField: {
-                elementKey: structureField.elementKey,
-                fieldId: structureField.fieldId,
-                item: structureField.item,
-                textContent: summarizeFieldValue(structureField.textContent),
-                isRichText: structureField.isRichText,
-            },
-            itemDescriptor,
-            repositoryValue: summarizeFieldValue(repositoryValue),
-            result: {
-                ...result,
-                value: summarizeFieldValue(result.value),
-            },
-            modifiedFieldCount: fieldsContext?.modifiedFields?.length,
-            suggestedEditCount: editContext.suggestedEdits?.length,
-        });
         return result;
     }, [
         editContext.mode,
@@ -1112,26 +1093,9 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         const signature = buildBridgeFieldPatchSignature(patch, observedTextContent);
         const previousSignature = bridgePatchSignatureRef.current.get(cacheKey);
         if (previousSignature === signature) {
-            logFieldValueDiagnostic("bridge-patch", "skipped duplicate send", {
-                cacheKey,
-                patch: {
-                    ...patch,
-                    value: summarizeFieldValue(patch.value),
-                },
-                observedTextContent: summarizeFieldValue(observedTextContent),
-            });
             return false;
         }
         bridgePatchSignatureRef.current.set(cacheKey, signature);
-        logFieldValueDiagnostic("bridge-patch", "sending patch", {
-            cacheKey,
-            patch: {
-                ...patch,
-                value: summarizeFieldValue(patch.value),
-            },
-            observedTextContent: summarizeFieldValue(observedTextContent),
-            previousSignature,
-        });
         bridge.sendCommand("applyFieldPatch", patch);
         return true;
     }, []);
@@ -1180,12 +1144,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         });
         if (lastSentBridgeCaretRef.current === nextKey)
             return;
-        logFieldValueDiagnostic("bridge-caret", "sending position", {
-            fieldId: activeField.fieldId,
-            item,
-            offset,
-            value: summarizeFieldValue(activeField.value),
-        });
         editor.sendSocketMessage({
             type: "caret-position",
             payload: {
@@ -1592,6 +1550,20 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
             if (bridgeTextCompletionRef.current && interaction.fieldId) {
                 clearBridgeTextCompletion();
             }
+            // Ctrl+Z / Ctrl+Y pressed inside the canvas iframe never reach the host window, so
+            // the undo/redo commands (which bind those keys) could not fire. The bridge already
+            // preventDefaults the keystroke and forwards it here; replay it on `window`, where
+            // useGlobalEditorKeyDown listens, so the keyboard and the toolbar drive the same
+            // application undo stack.
+            const undoRedoKeyboardEvent = createKeyboardEventFromBridgeInteraction(interaction);
+            if (undoRedoKeyboardEvent) {
+                // The application operation will deliberately replace the focused
+                // field's value. Tell the next bridge refresh not to restore the
+                // iframe's pre-operation caret/draft snapshot over that value.
+                discardActiveFieldDraftOnNextRefreshRef.current = true;
+                window.dispatchEvent(undoRedoKeyboardEvent);
+                return;
+            }
             if (isBridgeLinkShortcut(interaction)) {
                 const editor = editContextRef.current;
                 let linkRange = editor?.selectedRange;
@@ -1653,6 +1625,16 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                 }
                 return;
             }
+            const fieldHistoryStep = getBridgeFieldHistoryStepDirection(interaction);
+            if (fieldHistoryStep) {
+                // The pill lives in the chrome overlay, outside this frame's tree.
+                document.dispatchEvent(new CustomEvent(INLINE_FIELD_HISTORY_STEP_EVENT, {
+                    bubbles: true,
+                    cancelable: true,
+                    detail: { direction: fieldHistoryStep },
+                }));
+                return;
+            }
             if (isBridgeInlineAiShortcut(interaction)) {
                 const editor = editContextRef.current;
                 const field = await resolveBridgeFieldDescriptor(interaction);
@@ -1717,6 +1699,110 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         const editor = editContextRef.current;
         if (!editor)
             return;
+        // In preview mode the bridge suppresses the canvas's native link
+        // navigation (the proxied iframe cannot follow root-relative hrefs), so
+        // a plain click on an internal link navigates the editor to the linked
+        // page instead — carrying any #anchor along.
+        const isPreviewLinkClick = interaction.kind === "click" &&
+            !interaction.altKey &&
+            !!interaction.link?.internal &&
+            editor.mode === "preview";
+        if (interaction.kind === "click" &&
+            (interaction.altKey || isPreviewLinkClick) &&
+            interaction.link?.internal) {
+            const canvasLinkHash = (() => {
+                try {
+                    return (new URL(interaction.link.href, window.location.href).hash.slice(1) || undefined);
+                }
+                catch {
+                    return undefined;
+                }
+            })();
+            let rawFieldValue;
+            let structuredFieldValue;
+            const linkFieldInteraction = interaction.link
+                .fieldId
+                ? {
+                    ...interaction,
+                    elementKey: interaction.link.elementKey ?? interaction.elementKey,
+                    fieldId: interaction.link.fieldId,
+                    item: interaction.link.item ?? interaction.item,
+                }
+                : interaction;
+            if (linkFieldInteraction.fieldId) {
+                const fieldDescriptor = await resolveBridgeFieldDescriptor(linkFieldInteraction);
+                if (fieldDescriptor) {
+                    try {
+                        const field = await editor.itemsRepository.getField(fieldDescriptor);
+                        rawFieldValue = field?.rawValue;
+                        structuredFieldValue = field?.value;
+                    }
+                    catch {
+                        // Direct target metadata and Sitecore link.aspx URLs can still
+                        // resolve when repository hydration is unavailable.
+                    }
+                }
+            }
+            let targetItemId = extractInternalLinkTargetItemId({
+                href: interaction.link.href,
+                targetItemId: interaction.link.targetItemId,
+                rawFieldValue,
+                structuredFieldValue,
+                anchorIndex: interaction.link.anchorIndex,
+            });
+            const sourceItem = pageViewContextRef.current?.page?.item ??
+                pageViewContextRef.current?.pageItemDescriptor ??
+                interaction.item;
+            if (!targetItemId && sourceItem) {
+                const linkPath = extractInternalLinkPath(interaction.link.href, window.location.href);
+                if (linkPath) {
+                    const resolvedPage = await resolvePageAndSiteByPath(linkPath, sourceItem.language ?? "en", pageViewContextRef.current?.site?.name);
+                    targetItemId = resolvedPage?.pageItem.id;
+                }
+            }
+            if (!targetItemId) {
+                editor.showToast("Could not resolve the linked page.");
+                return;
+            }
+            // A link to a section of the page already on the canvas needs no
+            // navigation — scroll the canvas to the anchor instead (a reload
+            // would lose scroll state and flash the page).
+            if (canvasLinkHash &&
+                sourceItem?.id &&
+                targetItemId.toLowerCase() === sourceItem.id.toLowerCase()) {
+                bridgeClientRef.current?.sendCommand("scrollIntoView", {
+                    anchorId: canvasLinkHash,
+                    block: "start",
+                });
+                return;
+            }
+            // Consumed by the render-url effect on the iframe load that this
+            // loadItem triggers; set before the await so the effect cannot run
+            // first, cleared if the navigation fails.
+            if (canvasLinkHash)
+                pendingCanvasAnchorRef.current = canvasLinkHash;
+            try {
+                const linkedPage = await editor.loadItem({
+                    id: targetItemId,
+                    language: sourceItem?.language ?? "en",
+                    version: 0,
+                    database: sourceItem?.database,
+                }, {
+                    openInNewSlot: isPreviewLinkClick
+                        ? false
+                        : shouldOpenInternalLinkInNewSlot(editor.fullscreen),
+                });
+                if (!linkedPage) {
+                    pendingCanvasAnchorRef.current = undefined;
+                    editor.showToast("The linked page could not be loaded.");
+                }
+            }
+            catch {
+                pendingCanvasAnchorRef.current = undefined;
+                editor.showToast("The linked page could not be loaded.");
+            }
+            return;
+        }
         const selectFromBridgeInteraction = (ids) => {
             const unchanged = bridgeComponentSelectionsMatch(editor.getSelection(), ids);
             if (!unchanged) {
@@ -2019,10 +2105,7 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         const iframe = iframeElement;
         if (!iframe)
             return;
-        const currentIframeSrc = iframe.src;
-        if (!iframeSrc ||
-            !loadedIframeSrc ||
-            loadedIframeSrc !== currentIframeSrc) {
+        if (!iframeSrc || !loadedIframeSrc) {
             pageViewContext.setBridgeReady(false);
             pageViewContext.setIframeSupportsRefresh(false);
             return;
@@ -2031,11 +2114,12 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
             getUrlOrigin(pageViewContext.editUrl),
             getUrlOrigin(pageViewContext.previewUrl),
         ].filter((origin) => Boolean(origin));
-        if (allowedHostOrigins.length === 0) {
-            pageViewContext.setBridgeReady(false);
-            pageViewContext.setIframeSupportsRefresh(false);
-            return;
-        }
+        // The iframe can finish loading before the page-view URLs have propagated
+        // into context, and a same-origin host can normalize its live URL after the
+        // load event. Neither case should strand the bridge: BridgeClient always
+        // verifies event.source against this iframe and derives a safe configured
+        // origin from the iframe src when the context allowlist is temporarily
+        // empty. The repeated hello handshake then survives late host startup.
         let client;
         client = new BridgeClient({
             iframe,
@@ -2046,14 +2130,14 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                 if (!ready)
                     pageViewContext.setIframeSupportsRefresh(false);
             },
-            onError: (error) => {
+            onError: () => {
                 pageViewContext.setBridgeReady(false);
                 pageViewContext.setIframeSupportsRefresh(false);
                 const parentInjectionDiagnostic = formatParentBridgeInjectionDiagnostic(latestParentBridgeInjectionRef.current);
                 const details = parentInjectionDiagnostic
-                    ? `${error.message}\n\nParent injection: ${parentInjectionDiagnostic}`
-                    : error.message;
-                console.error("[Parhelia bridge]", error.message, latestParentBridgeInjectionRef.current);
+                    ? `The editing host bridge did not become ready.\n\nParent injection: ${parentInjectionDiagnostic}`
+                    : "The editing host bridge did not become ready.";
+                console.error("[Parhelia bridge]", parentInjectionDiagnostic);
                 if (!compareView) {
                     editContextRef.current?.showErrorToast({
                         summary: "Editing host bridge unavailable",
@@ -2086,6 +2170,11 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                         bridge.sendCommand("setZoom", {
                             zoom: pageViewContextRef.current?.zoom ?? 1,
                         });
+                        // Ready confirms the bridge transport, not that its initial
+                        // mutation-driven geometry snapshot reached the editor. Query the
+                        // current DOM explicitly so editing chrome never depends on that
+                        // first unsolicited event surviving startup contention.
+                        bridge.sendCommand("queryGeometry", {});
                         if (pendingRefreshScrollRef.current) {
                             restorePendingRefreshScroll(iframe, pendingRefreshScrollRef.current);
                         }
@@ -2241,38 +2330,15 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                         handleBridgeSelection(event.payload.selection, iframe);
                         break;
                     case "fieldValueChanged":
-                        logFieldValueDiagnostic("bridge-frame", "fieldValueChanged event", {
-                            elementKey: event.payload.elementKey,
-                            fieldId: event.payload.fieldId,
-                            item: event.payload.item,
-                            isRichText: event.payload.isRichText,
-                            value: summarizeFieldValue(event.payload.value),
-                            activeInlineEdit: activeBridgeInlineEditRef.current,
-                        });
                         handleBridgeFieldValueChanged(event.payload);
                         break;
                     case "inlineEditEnded":
-                        logFieldValueDiagnostic("bridge-frame", "inlineEditEnded event", {
-                            reason: event.payload.reason,
-                            elementKey: event.payload.elementKey,
-                            fieldId: event.payload.fieldId,
-                            item: event.payload.item,
-                            isRichText: event.payload.isRichText,
-                            value: summarizeFieldValue(event.payload.value),
-                            activeInlineEdit: activeBridgeInlineEditRef.current,
-                        });
                         const inlineEditEnd = bridgeInlineEditSession.end(event.payload);
                         handleBridgeInlineEditEnded(event.payload, {
                             recordSession: false,
                             releaseFocus: inlineEditEnd.matched,
                             endedModeAtStart: inlineEditEnd.endedState?.modeAtStart,
                         });
-                        logFieldValueDiagnostic("bridge-frame", inlineEditEnd.matched
-                            ? "active inline edit cleared after end"
-                            : "non-current inline edit end persisted", {
-                            fieldId: event.payload.fieldId,
-                            reason: event.payload.reason,
-                        });
                         break;
                     case "interaction":
                         if (event.payload.kind === "hover") {
@@ -2650,6 +2716,7 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
             return (bridgeClientRef.current?.sendCommand("cancelPointerDrag", {}) ?? false);
         };
         pageViewContext.requestBridgeScrollBy = requestBridgeScrollBy;
+        pageViewContext.requestBridgeFieldPatch = sendApplyFieldPatchCommand;
         pageViewContext.requestBridgeRichTextCommand = requestBridgeRichTextCommand;
         pageViewContext.requestBridgePreviewGap = requestBridgePreviewGap;
         pageViewContext.requestBridgeCaptureSnapshot = requestBridgeCaptureSnapshot;
@@ -2679,12 +2746,15 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                 requestBridgeCancelPointerDrag) {
                 pageViewContext.requestBridgeCancelPointerDrag = undefined;
             }
+            if (pageViewContext.requestBridgeFieldPatch === sendApplyFieldPatchCommand) {
+                pageViewContext.requestBridgeFieldPatch = undefined;
+            }
             if (pageViewContext.requestBridgeRichTextCommand ===
                 requestBridgeRichTextCommand) {
                 pageViewContext.requestBridgeRichTextCommand = undefined;
             }
         };
-    }, [pageViewContext]);
+    }, [pageViewContext, sendApplyFieldPatchCommand]);
     useEffect(() => {
         const requestBridgeCaptureDom = (payload) => {
             const bridge = bridgeClientRef.current;
@@ -2820,7 +2890,16 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         const initialLoad = currentItemDescriptor?.id !== pageItemDescriptor.id ||
             currentItemDescriptor?.language !== pageItemDescriptor.language ||
             currentItemDescriptor?.version !== pageItemDescriptor.version;
-        const shouldUseIframeSrcReload = initialLoad || pageViewContext.fullscreen || iframeOriginChanged;
+        // A user-requested hard refresh: skip the incremental path entirely. It is
+        // the escape hatch for the case where the bridge patch is what produced the
+        // wrong DOM, so routing it through the bridge again would repeat the fault.
+        const fullReloadRequested = lastFullReloadTokenRef.current !== undefined &&
+            lastFullReloadTokenRef.current !== editContext.fullReloadToken;
+        lastFullReloadTokenRef.current = editContext.fullReloadToken;
+        const shouldUseIframeSrcReload = initialLoad ||
+            pageViewContext.fullscreen ||
+            iframeOriginChanged ||
+            fullReloadRequested;
         const signatureUrl = new URL(renderUrl.toString());
         signatureUrl.searchParams.delete("edit_rev");
         const renderSignature = `${signatureUrl.toString()}|rev:${editContext.revision}`;
@@ -2842,7 +2921,13 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         function runFallbackRefresh() {
             lastRenderSignatureRef.current = renderSignature;
             pageViewContext.setIframeSupportsRefresh(false);
-            if (!pendingRefreshScrollRef.current) {
+            if (pendingCanvasAnchorRef.current) {
+                // An anchor navigation decides the landing position — restoring the
+                // previous page's scroll on ready would yank the canvas off the
+                // linked section.
+                pendingRefreshScrollRef.current = undefined;
+            }
+            else if (!pendingRefreshScrollRef.current) {
                 pendingRefreshScrollRef.current =
                     getIframeWindowScroll(iframeRef.current) ??
                         latestBridgeScrollRef.current;
@@ -2858,8 +2943,16 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                     ? "Cross-origin load - setting iframe src"
                     : iframeOriginChanged
                         ? "Iframe origin changed - setting iframe src"
-                        : "Reloading iframe src");
+                        : fullReloadRequested
+                            ? "Hard refresh requested - setting iframe src"
+                            : "Reloading iframe src");
             setLoadedIframeSrc(undefined);
+            // A canvas link navigation may carry a #anchor; the browser scrolls the
+            // freshly loaded document to it natively.
+            if (pendingCanvasAnchorRef.current) {
+                renderUrl.hash = pendingCanvasAnchorRef.current;
+                pendingCanvasAnchorRef.current = undefined;
+            }
             setIframeSrc(renderUrl.toString());
         }
         function runBridgeRefresh() {
@@ -2878,10 +2971,13 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
             canvasRefreshInFlightSinceRef.current = Date.now();
             awaitingHostAppRefreshRenderRef.current = false;
             hostAppRefreshSawStructureUpdateRef.current = false;
+            const discardActiveFieldDraft = discardActiveFieldDraftOnNextRefreshRef.current;
+            discardActiveFieldDraftOnNextRefreshRef.current = false;
             const accepted = bridge.sendCommand("refresh", {
                 url: renderUrl.toString(),
                 revision: editContext.revision,
                 layoutKind: editContext.layoutMode,
+                discardActiveFieldDraft: discardActiveFieldDraft || undefined,
             });
             if (!accepted) {
                 pendingRefreshScrollRef.current = undefined;
@@ -2911,6 +3007,7 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     }, [
         pathname,
         editContext.revision,
+        editContext.fullReloadToken,
         pageItemDescriptor,
         pageViewContext.editUrl,
         pageViewContext.previewUrl,
@@ -2924,25 +3021,45 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
     ]);
     useEffect(() => {
         if (fieldsContext?.focusedField) {
+            const focusedField = fieldsContext.focusedField;
+            const focusedFieldKey = getFocusedFieldScrollKey(focusedField);
+            // The post-operation auto-focus of a moved/added component arms this
+            // suppression at its source: it carries no user intent to see the
+            // field, and after a move the field still measures at its pre-move
+            // rect (the drag origin) until the refreshed geometry lands — the
+            // canvas refresh may not even have started yet, so the in-flight
+            // check below cannot catch it. Deterministic — no time window to lose
+            // against a slow operation. Consumed before the same-key return so an
+            // armed flag never leaks to a later genuine focus; the key is recorded
+            // so a re-run for the same field doesn't scroll either.
+            if (editContext.consumeNextFocusedFieldAutoScrollSuppression?.()) {
+                lastScrolledFocusedFieldKeyRef.current = focusedFieldKey;
+                return;
+            }
+            if (lastScrolledFocusedFieldKeyRef.current === focusedFieldKey)
+                return;
             // A refresh is being applied: the field's rect still describes the
             // pre-edit DOM (after a move, its old position — where the drag
             // started), so scrolling now would yank the canvas to a stale spot.
-            // This fires on the post-operation auto-focus of the moved/added
-            // component; a genuine user focus during a refresh loses one
-            // auto-scroll, which is the lesser evil.
+            // A genuine user focus during a refresh loses one auto-scroll, which
+            // is the lesser evil.
             if (isCanvasRefreshInFlight())
                 return;
             // Event-time read: this effect is keyed on focusedField, not selection.
             const currentSelection = editContext.getSelection();
             if (currentSelection.length > 0 &&
-                fieldsContext.focusedField.item.id !== currentSelection[0])
+                focusedField.item.id !== currentSelection[0])
                 return;
-            const bounds = findBridgeFieldDocumentBounds(pageViewContextRef.current?.bridgeGeometry, fieldsContext.focusedField);
+            lastScrolledFocusedFieldKeyRef.current = focusedFieldKey;
+            const bounds = findBridgeFieldDocumentBounds(pageViewContextRef.current?.bridgeGeometry, focusedField);
             const activePageViewContext = pageViewContextRef.current;
             if (bounds && activePageViewContext) {
                 scrollBridgeBoundsIntoView(activePageViewContext, bounds, latestBridgeScrollRef.current);
             }
         }
+        else {
+            lastScrolledFocusedFieldKeyRef.current = undefined;
+        }
     }, [fieldsContext?.focusedField, isCanvasRefreshInFlight]);
     // Drive the selection-scroll suppression window from the drag lifecycle.
     // Declared BEFORE the selection-scroll effect so it runs first in the same
@@ -3172,6 +3289,23 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
             window.clearTimeout(geometryTimer);
         };
     }, [zoom]);
+    useEffect(() => {
+        if (!pageViewContext.bridgeReady ||
+            (!editContext.dragObject &&
+                !editContext.selectedForInsertion &&
+                !editContext.insertMode)) {
+            return;
+        }
+        // Insert mode needs a fresh structural measurement. In particular, the
+        // host can become ready before its rendering framework has committed the
+        // placeholder markers, leaving the startup snapshot structurally empty.
+        bridgeClientRef.current?.sendCommand("queryGeometry", {});
+    }, [
+        editContext.dragObject,
+        editContext.insertMode,
+        editContext.selectedForInsertion,
+        pageViewContext.bridgeReady,
+    ]);
     useEffect(() => {
         let geometryTimer = null;
         const sendViewportStateToBridge = (event) => {
@@ -3214,11 +3348,8 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
         : (pageViewContext.deviceWidth || 640) +
             editContext.configuration.outline.width +
             "px";
-    const fullscreenPageTitle = pageViewContext.page?.item?.displayName?.trim() ||
-        pageViewContext.page?.item?.name?.trim() ||
-        "Page";
     const showSuggestionsCursor = !isBridgeInlineEditing && editContext.mode === "suggestions";
-    return (_jsxs("div", { className: cn("relative flex h-full w-full flex-col items-center select-none", className, editContext.showAgentsPanel && !editContext.currentWizardId && "pr-0"), children: [!pageViewContext.fullscreen && (_jsx(EditorWarnings, { item: pageViewContext.page?.item })), slotCloseButton && (_jsx("div", { className: "absolute top-3 right-3 z-50", children: slotCloseButton })), pageViewContext.fullscreen && (_jsxs("div", { className: "border-neutral-grey-15 relative z-40 flex h-11 w-full shrink-0 items-center justify-center border-b bg-white px-28 text-center shadow-sm", "data-testid": "fullscreen-page-title-bar", children: [_jsx("div", { className: "text-neutral-grey-100 max-w-full truncate text-sm font-medium", title: fullscreenPageTitle, "data-testid": "fullscreen-page-title", children: fullscreenPageTitle }), _jsx("div", { className: "absolute top-1/2 right-3 -translate-y-1/2", children: _jsx(FullscreenControls, { device: pageViewContext.device, setDevice: (device) => pageViewContext.setDevice(device), canExit: !editContext.configuration.forceFullscreen, onExit: () => editContext.setFullscreen(false) }) })] })), pageViewContext.device !== "desktop" && (_jsx(DeviceToolbar, { pageViewContext: pageViewContext, configuration: editContext.configuration })), _jsxs("div", { className: "relative flex min-h-0 flex-1 transition-[width] duration-300 ease-in-out select-none motion-reduce:transition-none", "data-testid": "page-viewer-viewport", style: {
+    return (_jsxs("div", { className: cn("relative flex h-full w-full flex-col items-center select-none", className, editContext.showAgentsPanel && !editContext.currentWizardId && "pr-0"), children: [!pageViewContext.fullscreen && (_jsx(EditorWarnings, { item: pageViewContext.page?.item })), slotCloseButton && (_jsx("div", { className: "absolute top-3 right-3 z-50", children: slotCloseButton })), pageViewContext.fullscreen && (_jsxs("div", { className: "border-neutral-grey-15 relative z-40 grid h-11 w-full shrink-0 grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] items-center border-b bg-white px-3 shadow-sm", "data-testid": "fullscreen-page-title-bar", children: [_jsx("div", { className: "w-full min-w-0 pr-3 text-left", children: _jsx(PageSelector, { itemDescriptor: pageViewContext.page?.item, variant: "fullscreen" }) }), _jsx("div", { className: "justify-self-center", children: _jsx(FullscreenControls, { device: pageViewContext.device, setDevice: (device) => pageViewContext.setDevice(device), zoom: pageViewContext.zoom, setZoom: pageViewContext.setZoom, canExit: !editContext.configuration.forceFullscreen, onExit: () => editContext.setFullscreen(false) }) }), _jsx("div", { "aria-hidden": "true" })] })), pageViewContext.device !== "desktop" && (_jsx(DeviceToolbar, { pageViewContext: pageViewContext, configuration: editContext.configuration })), _jsxs("div", { className: "relative flex min-h-0 flex-1 transition-[width] duration-300 ease-in-out select-none motion-reduce:transition-none", "data-testid": "page-viewer-viewport", style: {
                     width: deviceWidth,
                 }, children: [_jsxs("div", { className: "relative h-full w-full overflow-visible", onMouseLeave: () => {
                             if (pageViewContext.bridgeInteraction?.kind === "hover") {
@@ -3263,6 +3394,6 @@ function PageViewerFrameContent({ compareView, pageViewContext, editContext, cla
                                         }
                                         completeCanvasRefresh();
                                     }
-                                } }), iframeElement && (_jsx(IframeOverlayProvider, { iframe: iframeElement, mode: "scrolling", scrollScale: 1, visualScale: 1, invalidationKey: `${zoom}:${bridgeGeometryRevision}`, deferredInvalidationMs: ZOOM_TRANSITION_MS + 50, bleed: { top: 2, bottom: 2, left: 2 }, children: _jsx(PageEditorChrome, { iframe: iframeElement, compareView: compareView, pageViewContext: pageViewContext, bridgeInteraction: bridgeInteraction, onBridgeRichTextCommand: sendApplyRichTextCommand }) })), pageViewContext.deviceHeight && pageViewContext.device && (_jsx("div", { className: "bg-neutral-grey-5 relative z-40 h-full w-full" }))] }), shouldRenderMiniMap && (_jsx(MiniMap, { compareView: compareView, scroll: scroll, mainViewIframeRef: iframeRef, pageViewContext: pageViewContext })), showSpinner && (_jsxs(_Fragment, { children: [_jsx("div", { className: "bg-neutral-grey-5/50 absolute top-0 left-0 h-full w-full" }), _jsx("div", { className: "absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 transform", children: _jsx(Spinner, {}) })] }))] }), _jsx(FieldActionsOverlay, { ref: fieldActionsOverlay, generatorButtons: contextMenuFieldButtons, onActionClick: handleActionClick, onParameterizedActionExecute: handleParameterizedActionExecute, currentOverlay: editContext?.currentOverlay, fieldId: contextMenuField?.fieldId || "", setCurrentOverlay: editContext?.setCurrentOverlay || (() => { }), preSelectedAction: preSelectedAction })] }));
+                                } }), iframeElement && (_jsx(IframeOverlayProvider, { iframe: iframeElement, mode: "scrolling", scrollScale: 1, visualScale: 1, invalidationKey: `${zoom}:${bridgeGeometryRevision}`, deferredInvalidationMs: ZOOM_TRANSITION_MS + 50, bleed: { top: 2, right: 150, bottom: 2, left: 2 }, children: _jsx(PageEditorChrome, { iframe: iframeElement, compareView: compareView, pageViewContext: pageViewContext, bridgeInteraction: bridgeInteraction, onBridgeRichTextCommand: sendApplyRichTextCommand }) })), pageViewContext.deviceHeight && pageViewContext.device && (_jsx("div", { className: "bg-neutral-grey-5 relative z-40 h-full w-full" }))] }), shouldRenderMiniMap && (_jsx(MiniMap, { compareView: compareView, scroll: scroll, mainViewIframeRef: iframeRef, pageViewContext: pageViewContext })), showSpinner && (_jsxs(_Fragment, { children: [_jsx("div", { className: "bg-neutral-grey-5/50 absolute top-0 left-0 h-full w-full" }), _jsx("div", { className: "absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 transform", children: _jsx(Spinner, {}) })] }))] }), _jsx(FieldActionsOverlay, { ref: fieldActionsOverlay, generatorButtons: contextMenuFieldButtons, onActionClick: handleActionClick, onParameterizedActionExecute: handleParameterizedActionExecute, currentOverlay: editContext?.currentOverlay, fieldId: contextMenuField?.fieldId || "", setCurrentOverlay: editContext?.setCurrentOverlay || (() => { }), preSelectedAction: preSelectedAction })] }));
 }
 //# sourceMappingURL=PageViewerFrame.js.map