@parhelia/core 0.1.12907 → 0.1.12909

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

@@ -0,0 +1,334 @@
+import { useCallback, useEffect, useRef } from "react";
+import { useEditContextRef, useFieldsEditContextRef, } from "../client/editContext";
+import { getComponentById } from "../componentTreeHelper";
+import { getBridgeFieldPatchValue, isBridgePatchableTextField, } from "../page-viewer/bridgeFieldPatch";
+import { useSlotContext } from "../views/editorSlotContext";
+import { normalizeMarkerId } from "../utils";
+export function useBridgeInlineEditing({ pageViewContextRef, activeBridgeInlineEditRef, blockIframeBlurUntil, sendBeginInlineEdit, sendCancelInlineEdit, sendApplyFieldPatch, }) {
+    const editContextRef = useEditContextRef();
+    const fieldsContextRef = useFieldsEditContextRef();
+    const slotContext = useSlotContext();
+    const slotIdRef = useRef(slotContext?.slotId);
+    const lastBridgeInlineValueRef = useRef(new Map());
+    const deniedInlineCancelKeysRef = useRef(new Set());
+    useEffect(() => {
+        slotIdRef.current = slotContext?.slotId;
+    }, [slotContext?.slotId]);
+    const rejectInlineEdit = useCallback((payload, field, currentField) => {
+        if (!payload.elementKey)
+            return;
+        const denyKey = getInlineEditKey(payload.elementKey, field.fieldId);
+        deniedInlineCancelKeysRef.current.add(denyKey);
+        activeBridgeInlineEditRef.current = null;
+        if (currentField) {
+            sendApplyFieldPatch({
+                elementKey: payload.elementKey,
+                fieldId: field.fieldId,
+                isRichText: payload.isRichText,
+                source: "reset",
+                value: getBridgeFieldPatchValue(currentField),
+            });
+        }
+        sendCancelInlineEdit({
+            elementKey: payload.elementKey,
+            fieldId: field.fieldId,
+            forceReadOnly: true,
+        });
+    }, [activeBridgeInlineEditRef, sendApplyFieldPatch, sendCancelInlineEdit]);
+    const ensureBridgeFieldLock = useCallback(async (field) => {
+        const editor = editContextRef.current;
+        if (!editor || editor.mode === "suggestions")
+            return true;
+        if (fieldDescriptorsMatch(editor.lockedField, field))
+            return true;
+        if (getForeignFieldLockSession(editor, field))
+            return false;
+        return (await editor.operations.ensureLock(field)) || false;
+    }, [editContextRef]);
+    const resolveFieldDescriptor = useCallback((fieldId, item, elementKey) => {
+        if (!fieldId)
+            return undefined;
+        const pageView = pageViewContextRef.current;
+        const structureField = pageView?.bridgeStructure?.fields.find((field) => (elementKey && field.elementKey === elementKey) ||
+            (field.fieldId === fieldId &&
+                (!item?.id || field.item?.id === item.id)));
+        const fallbackItem = pageView?.page?.item ?? pageView?.pageItemDescriptor;
+        const sourceItem = item?.id
+            ? item
+            : (structureField?.item ?? fallbackItem);
+        const id = sourceItem?.id ?? fallbackItem?.id;
+        const language = sourceItem?.language ?? fallbackItem?.language;
+        const versionValue = sourceItem?.version ?? fallbackItem?.version;
+        const version = typeof versionValue === "number" && Number.isFinite(versionValue)
+            ? versionValue
+            : undefined;
+        if (!id || !language || version === undefined)
+            return undefined;
+        return {
+            fieldId,
+            item: {
+                id,
+                language,
+                version,
+                name: sourceItem?.name ?? fallbackItem?.name,
+                displayName: sourceItem?.displayName ?? fallbackItem?.displayName,
+                path: sourceItem?.path ?? fallbackItem?.path,
+                database: sourceItem?.database ?? fallbackItem?.database,
+            },
+        };
+    }, [pageViewContextRef]);
+    const handleFieldValueChanged = useCallback(async (payload) => {
+        const editor = editContextRef.current;
+        if (!editor || editor.mode === "preview")
+            return;
+        const field = resolveFieldDescriptor(payload.fieldId, payload.item, payload.elementKey);
+        if (!field)
+            return;
+        const currentField = await editor.itemsRepository.getField(field);
+        if (!currentField ||
+            !isBridgePatchableTextField(currentField, payload.isRichText)) {
+            return;
+        }
+        const hasLock = await ensureBridgeFieldLock(field);
+        if (!hasLock) {
+            logBridgeInlineEditDiagnostic("blocked: field locked by another user", {
+                fieldId: field.fieldId,
+                itemId: field.item.id,
+            });
+            rejectInlineEdit(payload, field, currentField);
+            return;
+        }
+        // Input can arrive before the delayed click interaction finishes the
+        // beginInlineEdit handshake. Mark it active immediately so suggestion
+        // preview patches do not rewrite the focused host node and reset caret.
+        if (payload.elementKey) {
+            const activeEdit = activeBridgeInlineEditRef.current;
+            activeBridgeInlineEditRef.current = {
+                elementKey: payload.elementKey,
+                fieldId: field.fieldId,
+                item: field.item,
+                modeAtStart: activeEdit &&
+                    activeEdit.elementKey === payload.elementKey &&
+                    activeEdit.fieldId === field.fieldId
+                    ? activeEdit.modeAtStart
+                    : editor.mode,
+                value: (payload.value ?? "").replaceAll("\u200B", ""),
+            };
+        }
+        const value = (payload.value ?? "").replaceAll("\u200B", "");
+        const valueKey = `${field.item.id}:${field.item.language}:${field.item.version}:${field.fieldId}`;
+        if (lastBridgeInlineValueRef.current.get(valueKey) === value)
+            return;
+        lastBridgeInlineValueRef.current.set(valueKey, value);
+        const activeEdit = activeBridgeInlineEditRef.current;
+        const modeAtStart = activeEdit &&
+            activeEdit.elementKey === payload.elementKey &&
+            activeEdit.fieldId === field.fieldId
+            ? activeEdit.modeAtStart
+            : undefined;
+        editor.operations.editField({
+            field,
+            forceMode: modeAtStart === "suggestions" || editor.mode === "suggestions"
+                ? "suggestions"
+                : undefined,
+            originatingSlotId: slotIdRef.current,
+            refresh: "none",
+            value,
+        });
+    }, [
+        activeBridgeInlineEditRef,
+        editContextRef,
+        ensureBridgeFieldLock,
+        rejectInlineEdit,
+        resolveFieldDescriptor,
+    ]);
+    const endFieldFocus = useCallback(() => {
+        editContextRef.current?.operations.onFieldBlur?.();
+        fieldsContextRef.current?.setFocusedField(undefined, false);
+    }, [editContextRef, fieldsContextRef]);
+    const handleInlineEditEnded = useCallback((payload) => {
+        const denyKey = getInlineEditKey(payload.elementKey, payload.fieldId);
+        if (payload.reason === "cancel" &&
+            deniedInlineCancelKeysRef.current.delete(denyKey)) {
+            endFieldFocus();
+            return;
+        }
+        handleFieldValueChanged(payload);
+        endFieldFocus();
+    }, [endFieldFocus, handleFieldValueChanged]);
+    const beginInlineEdit = useCallback(async (interaction) => {
+        const editor = editContextRef.current;
+        if (!editor || !interaction.fieldId || !interaction.elementKey) {
+            logBridgeInlineEditDiagnostic("skipped: missing context", {
+                hasEditor: !!editor,
+                fieldId: interaction.fieldId,
+                elementKey: interaction.elementKey,
+                kind: interaction.kind,
+            });
+            return false;
+        }
+        if (interaction.ctrlKey || interaction.shiftKey || interaction.metaKey) {
+            logBridgeInlineEditDiagnostic("skipped: modifier click", {
+                fieldId: interaction.fieldId,
+                ctrlKey: interaction.ctrlKey,
+                shiftKey: interaction.shiftKey,
+                metaKey: interaction.metaKey,
+            });
+            return false;
+        }
+        if (editor.mode !== "edit" && editor.mode !== "suggestions") {
+            logBridgeInlineEditDiagnostic("skipped: mode", {
+                mode: editor.mode,
+                fieldId: interaction.fieldId,
+            });
+            return false;
+        }
+        const page = pageViewContextRef.current?.page;
+        if (editor.mode === "edit" && page && !page.item.canWriteItem) {
+            logBridgeInlineEditDiagnostic("skipped: item is not writable", {
+                fieldId: interaction.fieldId,
+                itemId: page.item.id,
+            });
+            return false;
+        }
+        const resolvedField = resolveFieldDescriptor(interaction.fieldId, interaction.item, interaction.elementKey);
+        if (!resolvedField) {
+            logBridgeInlineEditDiagnostic("skipped: unresolved field", {
+                fieldId: interaction.fieldId,
+                elementKey: interaction.elementKey,
+                itemId: interaction.item?.id,
+            });
+            return false;
+        }
+        if (editor.showLayoutComponents === false && page) {
+            const owner = getComponentById(resolvedField.item.id, page);
+            if (owner?.layoutId) {
+                logBridgeInlineEditDiagnostic("skipped: layout component hidden", {
+                    fieldId: resolvedField.fieldId,
+                    itemId: resolvedField.item.id,
+                });
+                return false;
+            }
+        }
+        const hasKnownOrAcquiredLock = await ensureBridgeFieldLock(resolvedField);
+        if (!hasKnownOrAcquiredLock) {
+            logBridgeInlineEditDiagnostic("skipped: field locked by another user", {
+                fieldId: resolvedField.fieldId,
+                itemId: resolvedField.item.id,
+            });
+            rejectInlineEdit(interaction, resolvedField);
+            return false;
+        }
+        blockIframeBlurUntil(Date.now() + 500);
+        const shouldRequestLock = editor.mode !== "suggestions";
+        logBridgeInlineEditDiagnostic("requesting lock", {
+            fieldId: resolvedField.fieldId,
+            itemId: resolvedField.item.id,
+            language: resolvedField.item.language,
+            version: resolvedField.item.version,
+            shouldRequestLock,
+        });
+        const hasLock = shouldRequestLock &&
+            fieldDescriptorsMatch(editor.lockedField, resolvedField)
+            ? ((await fieldsContextRef.current?.setFocusedField(resolvedField, false)) ?? false)
+            : ((await fieldsContextRef.current?.setFocusedField(resolvedField, shouldRequestLock)) ?? false);
+        if (!hasLock) {
+            logBridgeInlineEditDiagnostic("skipped: lock failed", {
+                fieldId: resolvedField.fieldId,
+                itemId: resolvedField.item.id,
+            });
+            rejectInlineEdit(interaction, resolvedField);
+            return false;
+        }
+        const beginPayload = {
+            elementKey: interaction.elementKey,
+            fieldId: resolvedField.fieldId,
+            clientX: interaction.clientX,
+            clientY: interaction.clientY,
+        };
+        if (typeof interaction.selectionStartOffset === "number" &&
+            typeof interaction.selectionEndOffset === "number") {
+            beginPayload.selectedText = interaction.selectedText;
+            beginPayload.selectionStartOffset = interaction.selectionStartOffset;
+            beginPayload.selectionEndOffset = interaction.selectionEndOffset;
+        }
+        const sent = sendBeginInlineEdit(beginPayload);
+        logBridgeInlineEditDiagnostic(sent ? "started" : "command not sent", {
+            fieldId: resolvedField.fieldId,
+            itemId: resolvedField.item.id,
+            elementKey: interaction.elementKey,
+        });
+        return sent;
+    }, [
+        blockIframeBlurUntil,
+        editContextRef,
+        ensureBridgeFieldLock,
+        fieldsContextRef,
+        pageViewContextRef,
+        rejectInlineEdit,
+        resolveFieldDescriptor,
+        sendBeginInlineEdit,
+    ]);
+    return {
+        beginInlineEdit,
+        clearInlineDedupe: () => lastBridgeInlineValueRef.current.clear(),
+        endFieldFocus,
+        handleFieldValueChanged,
+        handleInlineEditEnded,
+    };
+}
+function getInlineEditKey(elementKey, fieldId) {
+    return `${elementKey ?? ""}:${normalizeMarkerId(fieldId)}`;
+}
+function fieldDescriptorsMatch(left, right) {
+    if (!left || !right)
+        return false;
+    return (normalizeMarkerId(left.fieldId) === normalizeMarkerId(right.fieldId) &&
+        fieldItemsMatch(left.item, right.item));
+}
+function fieldItemsMatch(left, right) {
+    if (!left || !right)
+        return false;
+    if (normalizeMarkerId(left.id) !== normalizeMarkerId(right.id))
+        return false;
+    if (left.language &&
+        right.language &&
+        left.language.toLowerCase() !== right.language.toLowerCase()) {
+        return false;
+    }
+    if (left.version !== undefined &&
+        right.version !== undefined &&
+        left.version !== right.version) {
+        return false;
+    }
+    return true;
+}
+function getForeignFieldLockSession(editor, field) {
+    return editor.activeSessions.find((session) => session.sessionId !== editor.sessionId &&
+        fieldDescriptorsMatch(session.fieldLock, field));
+}
+function logBridgeInlineEditDiagnostic(message, details) {
+    try {
+        const meta = import.meta;
+        const params = new URLSearchParams(window.location.search);
+        const enabled = meta.env?.DEV ||
+            meta.env?.MODE === "development" ||
+            window.location.hostname === "localhost" ||
+            params.get("parhelia_bridge_debug") === "1" ||
+            params.get("parhelia_bridge_debug") === "verbose" ||
+            window.localStorage.getItem("parhelia:bridge:debug") === "1" ||
+            window.localStorage.getItem("parhelia:bridge:debug") === "true";
+        if (!enabled)
+            return;
+    }
+    catch {
+        return;
+    }
+    if (details) {
+        console.debug(`[Parhelia bridge] inline edit ${message}`, details);
+    }
+    else {
+        console.debug(`[Parhelia bridge] inline edit ${message}`);
+    }
+}
+//# sourceMappingURL=useBridgeInlineEditing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBridgeInlineEditing.js","sourceRoot":"","sources":["../../../src/editor/page-editor-chrome/useBridgeInlineEditing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAU5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAyB7C,MAAM,UAAU,sBAAsB,CAAC,EACrC,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACW;IAC9B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,MAAM,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;IACnD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,CAAqB,WAAW,EAAE,MAAM,CAAC,CAAC;IAClE,MAAM,wBAAwB,GAAG,MAAM,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;IACxE,MAAM,yBAAyB,GAAG,MAAM,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC;IAC1C,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAE1B,MAAM,gBAAgB,GAAG,WAAW,CAClC,CACE,OAAsD,EACtD,KAAsB,EACtB,YAAgD,EAChD,EAAE;QACF,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,OAAO;QAEhC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACpE,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,yBAAyB,CAAC,OAAO,GAAG,IAAI,CAAC;QAEzC,IAAI,YAAY,EAAE,CAAC;YACjB,mBAAmB,CAAC;gBAClB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,wBAAwB,CAAC,YAAY,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,oBAAoB,CAAC;YACnB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC,EACD,CAAC,yBAAyB,EAAE,mBAAmB,EAAE,oBAAoB,CAAC,CACvE,CAAC;IAEF,MAAM,qBAAqB,GAAG,WAAW,CACvC,KAAK,EAAE,KAAsB,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa;YAAE,OAAO,IAAI,CAAC;QAC1D,IAAI,qBAAqB,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClE,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAE5D,OAAO,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC;IAC9D,CAAC,EACD,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,MAAM,sBAAsB,GAAG,WAAW,CACxC,CACE,OAA2B,EAC3B,IAA2B,EAC3B,UAAmB,EACU,EAAE;QAC/B,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC;QAC5C,MAAM,cAAc,GAAG,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,CAC3D,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC;YAC/C,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO;gBACxB,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAC/C,CAAC;QACF,MAAM,YAAY,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,kBAAkB,CAAC;QAC1E,MAAM,UAAU,GAAG,IAAI,EAAE,EAAE;YACzB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,IAAI,YAAY,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,UAAU,EAAE,EAAE,IAAI,YAAY,EAAE,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,UAAU,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,CAAC;QAChE,MAAM,YAAY,GAAG,UAAU,EAAE,OAAO,IAAI,YAAY,EAAE,OAAO,CAAC;QAClE,MAAM,OAAO,GACX,OAAO,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC/D,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhE,OAAO;YACL,OAAO;YACP,IAAI,EAAE;gBACJ,EAAE;gBACF,QAAQ;gBACR,OAAO;gBACP,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,YAAY,EAAE,IAAI;gBAC5C,WAAW,EAAE,UAAU,EAAE,WAAW,IAAI,YAAY,EAAE,WAAW;gBACjE,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,YAAY,EAAE,IAAI;gBAC5C,QAAQ,EAAE,UAAU,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ;aACzD;SACF,CAAC;IACJ,CAAC,EACD,CAAC,kBAAkB,CAAC,CACrB,CAAC;IAEF,MAAM,uBAAuB,GAAG,WAAW,CACzC,KAAK,EAAE,OAAsC,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAEjD,MAAM,KAAK,GAAG,sBAAsB,CAClC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,UAAU,CACnB,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClE,IACE,CAAC,YAAY;YACb,CAAC,0BAA0B,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,EAC7D,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,6BAA6B,CAAC,uCAAuC,EAAE;gBACrE,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;aACtB,CAAC,CAAC;YACH,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,sEAAsE;QACtE,wEAAwE;QACxE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC;YACrD,yBAAyB,CAAC,OAAO,GAAG;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EACT,UAAU;oBACV,UAAU,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;oBAC5C,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;oBAClC,CAAC,CAAC,UAAU,CAAC,WAAW;oBACxB,CAAC,CAAC,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClG,IAAI,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK;YAAE,OAAO;QAErE,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC;QACrD,MAAM,WAAW,GACf,UAAU;YACV,UAAU,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;YAC5C,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAClC,CAAC,CAAC,UAAU,CAAC,WAAW;YACxB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;YAC1B,KAAK;YACL,SAAS,EACP,WAAW,KAAK,aAAa,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa;gBAC5D,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,SAAS;YACf,iBAAiB,EAAE,SAAS,CAAC,OAAO;YACpC,OAAO,EAAE,MAAM;YACf,KAAK;SACN,CAAC,CAAC;IACL,CAAC,EACD;QACE,yBAAyB;QACzB,cAAc;QACd,qBAAqB;QACrB,gBAAgB;QAChB,sBAAsB;KACvB,CACF,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEvC,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,OAAoC,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACtE,IACE,OAAO,CAAC,MAAM,KAAK,QAAQ;YAC3B,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EACjD,CAAC;YACD,aAAa,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACjC,aAAa,EAAE,CAAC;IAClB,CAAC,EACD,CAAC,aAAa,EAAE,uBAAuB,CAAC,CACzC,CAAC;IAEF,MAAM,eAAe,GAAG,WAAW,CACjC,KAAK,EAAE,WAAwC,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAC/D,6BAA6B,CAAC,0BAA0B,EAAE;gBACxD,SAAS,EAAE,CAAC,CAAC,MAAM;gBACnB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,IAAI,EAAE,WAAW,CAAC,IAAI;aACvB,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACvE,6BAA6B,CAAC,yBAAyB,EAAE;gBACvD,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;aAC7B,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC5D,6BAA6B,CAAC,eAAe,EAAE;gBAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,WAAW,CAAC,OAAO;aAC7B,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC;QAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9D,6BAA6B,CAAC,+BAA+B,EAAE;gBAC7D,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;aACrB,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAAG,sBAAsB,CAC1C,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,UAAU,CACvB,CAAC;QACF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,6BAA6B,CAAC,2BAA2B,EAAE;gBACzD,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE;aAC7B,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK,IAAI,IAAI,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC5D,IAAI,KAAK,EAAE,QAAQ,EAAE,CAAC;gBACpB,6BAA6B,CAAC,kCAAkC,EAAE;oBAChE,OAAO,EAAE,aAAa,CAAC,OAAO;oBAC9B,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE;iBAC9B,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,MAAM,sBAAsB,GAAG,MAAM,qBAAqB,CAAC,aAAa,CAAC,CAAC;QAC1E,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC5B,6BAA6B,CAAC,uCAAuC,EAAE;gBACrE,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE;aAC9B,CAAC,CAAC;YACH,gBAAgB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC;QACvC,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC;QACxD,6BAA6B,CAAC,iBAAiB,EAAE;YAC/C,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE;YAC7B,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ;YACrC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO;YACnC,iBAAiB;SAClB,CAAC,CAAC;QACH,MAAM,OAAO,GACX,iBAAiB;YACjB,qBAAqB,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;YACtD,CAAC,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAC/C,aAAa,EACb,KAAK,CACN,CAAC,IAAI,KAAK,CAAC;YACd,CAAC,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAC/C,aAAa,EACb,iBAAiB,CAClB,CAAC,IAAI,KAAK,CAAC,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,6BAA6B,CAAC,sBAAsB,EAAE;gBACpD,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE;aAC9B,CAAC,CAAC;YACH,gBAAgB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,YAAY,GAAkC;YAClD,UAAU,EAAE,WAAW,CAAC,UAAU;YAClC,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;SAC7B,CAAC;QACF,IACE,OAAO,WAAW,CAAC,oBAAoB,KAAK,QAAQ;YACpD,OAAO,WAAW,CAAC,kBAAkB,KAAK,QAAQ,EAClD,CAAC;YACD,YAAY,CAAC,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC;YACrD,YAAY,CAAC,oBAAoB,GAAG,WAAW,CAAC,oBAAoB,CAAC;YACrE,YAAY,CAAC,kBAAkB,GAAG,WAAW,CAAC,kBAAkB,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAC/C,6BAA6B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,EAAE;YACnE,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE;YAC7B,UAAU,EAAE,WAAW,CAAC,UAAU;SACnC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC,EACD;QACE,oBAAoB;QACpB,cAAc;QACd,qBAAqB;QACrB,gBAAgB;QAChB,kBAAkB;QAClB,gBAAgB;QAChB,sBAAsB;QACtB,mBAAmB;KACpB,CACF,CAAC;IAEF,OAAO;QACL,eAAe;QACf,iBAAiB,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,EAAE;QACjE,aAAa;QACb,uBAAuB;QACvB,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,UAA8B,EAAE,OAAe;IACvE,OAAO,GAAG,UAAU,IAAI,EAAE,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAiC,EACjC,KAAkC;IAElC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,CACL,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC;QACpE,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,IAAyC,EACzC,KAA0C;IAE1C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7E,IACE,IAAI,CAAC,QAAQ;QACb,KAAK,CAAC,QAAQ;QACd,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,IAAI,CAAC,OAAO,KAAK,SAAS;QAC1B,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,0BAA0B,CACjC,MAAuB,EACvB,KAAsB;IAEtB,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,CAC/B,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QACtC,qBAAqB,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,OAAe,EACf,OAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAEnB,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,OAAO,GACX,IAAI,CAAC,GAAG,EAAE,GAAG;YACb,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,aAAa;YAChC,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,WAAW;YACxC,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,GAAG;YAC3C,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,SAAS;YACjD,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,GAAG;YAC5D,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,MAAM,CAAC;QAClE,IAAI,CAAC,OAAO;YAAE,OAAO;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,iCAAiC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { Component } from "../pageModel";
+import type { PageViewContext } from "../page-viewer/pageViewContext";
+type Options = {
+    component: Component;
+    pageViewContext?: PageViewContext;
+    /** Whether the grip may start a drag (component movable, not layout-locked). */
+    enabled: boolean;
+};
+/**
+ * Parent-DOM drag source for a component grip (the frame-menu header). It owns
+ * the pointer via `setPointerCapture` and forwards a "client"-space gesture
+ * stream to {@link DragInsertionOverlay} - the very same orchestration the
+ * in-iframe whole-component grab uses. The grip therefore gets the continuous
+ * insertion line, the cursor-following chip/snapshot, edge auto-scroll, and the
+ * shared `droppedInPlaceholder` commit path instead of janky native HTML5 DnD.
+ *
+ * Below the 6px threshold nothing is dispatched, so a plain click on the grip
+ * (or a nested button such as "select parent") still behaves normally.
+ */
+export declare function useComponentDragHandle({ component, pageViewContext, enabled, }: Options): {
+    onPointerDown: (e: React.PointerEvent<HTMLElement>) => void;
+};
+export {};

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

@@ -0,0 +1,41 @@
+"use client";
+import { useCallback, useRef } from "react";
+import { useIframeOverlay } from "./overlay/IframeOverlayProvider";
+import { findBridgeComponentTarget } from "./overlay/geometry";
+import { useDragInsertionGesture } from "./useDragInsertionGesture";
+/**
+ * Parent-DOM drag source for a component grip (the frame-menu header). It owns
+ * the pointer via `setPointerCapture` and forwards a "client"-space gesture
+ * stream to {@link DragInsertionOverlay} - the very same orchestration the
+ * in-iframe whole-component grab uses. The grip therefore gets the continuous
+ * insertion line, the cursor-following chip/snapshot, edge auto-scroll, and the
+ * shared `droppedInPlaceholder` commit path instead of janky native HTML5 DnD.
+ *
+ * Below the 6px threshold nothing is dispatched, so a plain click on the grip
+ * (or a nested button such as "select parent") still behaves normally.
+ */
+export function useComponentDragHandle({ component, pageViewContext, enabled, }) {
+    const overlay = useIframeOverlay();
+    const pvcRef = useRef(pageViewContext);
+    pvcRef.current = pageViewContext;
+    const componentRef = useRef(component);
+    componentRef.current = component;
+    const { onPointerDown } = useDragInsertionGesture({
+        iframe: overlay.iframe,
+        pageViewContext,
+        enabled,
+        getStartDetail: useCallback(() => {
+            const geometry = pvcRef.current?.bridgeGeometry;
+            const elementKey = geometry
+                ? (findBridgeComponentTarget(geometry, componentRef.current)
+                    ?.elementKey ?? "")
+                : "";
+            return {
+                elementKey,
+                componentId: componentRef.current.id,
+            };
+        }, []),
+    });
+    return { onPointerDown };
+}
+//# sourceMappingURL=useComponentDragHandle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentDragHandle.js","sourceRoot":"","sources":["../../../src/editor/page-editor-chrome/useComponentDragHandle.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AASpE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,SAAS,EACT,eAAe,EACf,OAAO,GACC;IACR,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC;IACjC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC;IAEjC,MAAM,EAAE,aAAa,EAAE,GAAG,uBAAuB,CAAC;QAChD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,eAAe;QACf,OAAO;QACP,cAAc,EAAE,WAAW,CAAC,GAAG,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC;YAChD,MAAM,UAAU,GAAG,QAAQ;gBACzB,CAAC,CAAC,CAAC,yBAAyB,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC;oBACxD,EAAE,UAAU,IAAI,EAAE,CAAC;gBACvB,CAAC,CAAC,EAAE,CAAC;YACP,OAAO;gBACL,UAAU;gBACV,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE;aACrC,CAAC;QACJ,CAAC,EAAE,EAAE,CAAC;KACP,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { DragObject } from "../client/editContext";
+import type { PageViewContext } from "../page-viewer/pageViewContext";
+export type DragInsertionGestureStartDetail = {
+    elementKey?: string;
+    componentId?: string;
+    dragObject?: DragObject;
+};
+type Options = {
+    iframe?: HTMLIFrameElement | null;
+    pageViewContext?: PageViewContext;
+    enabled: boolean;
+    preventDefaultOnPointerDown?: boolean;
+    getStartDetail: () => DragInsertionGestureStartDetail | null | undefined;
+    onStart?: () => void;
+    onEnd?: (args: {
+        canceled: boolean;
+        started: boolean;
+    }) => void;
+};
+export declare function useDragInsertionGesture({ iframe, pageViewContext, enabled, preventDefaultOnPointerDown, getStartDetail, onStart, onEnd, }: Options): {
+    onPointerDown: (e: React.PointerEvent<HTMLElement>) => void;
+};
+export {};

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

@@ -0,0 +1,207 @@
+"use client";
+import { useCallback, useEffect, useRef } from "react";
+import { IFRAME_OVERLAY_BRIDGE_DRAG_GESTURE_EVENT, } from "./overlay/IframeOverlayProvider";
+import { DRAG_START_THRESHOLD_PX, getAutoScrollStep, } from "../../lib/pointerDrag";
+export function useDragInsertionGesture({ iframe, pageViewContext, enabled, preventDefaultOnPointerDown = true, getStartDetail, onStart, onEnd, }) {
+    const iframeRef = useRef(iframe);
+    iframeRef.current = iframe;
+    const pvcRef = useRef(pageViewContext);
+    pvcRef.current = pageViewContext;
+    const enabledRef = useRef(enabled);
+    enabledRef.current = enabled;
+    const preventDefaultOnPointerDownRef = useRef(preventDefaultOnPointerDown);
+    preventDefaultOnPointerDownRef.current = preventDefaultOnPointerDown;
+    const getStartDetailRef = useRef(getStartDetail);
+    getStartDetailRef.current = getStartDetail;
+    const onStartRef = useRef(onStart);
+    onStartRef.current = onStart;
+    const onEndRef = useRef(onEnd);
+    onEndRef.current = onEnd;
+    const cleanupRef = useRef(null);
+    useEffect(() => () => cleanupRef.current?.(), []);
+    const onPointerDown = useCallback((e) => {
+        if (!enabledRef.current || e.button !== 0)
+            return;
+        const iframe = iframeRef.current;
+        if (!iframe)
+            return;
+        if (preventDefaultOnPointerDownRef.current) {
+            e.preventDefault();
+        }
+        const source = e.currentTarget;
+        const pointerId = e.pointerId;
+        const startX = e.clientX;
+        const startY = e.clientY;
+        let started = false;
+        let finished = false;
+        let lastX = startX;
+        let lastY = startY;
+        let autoScrollRaf = 0;
+        // Capture the pointer on a STABLE element (the parent <html>) rather than the
+        // grip: the frame menu hides the grip on dragStart, so a grip-bound capture
+        // would be released the instant the drag begins - and once capture is gone,
+        // pointermoves over the canvas iframe stop reaching the parent window and the
+        // drag freezes. documentElement never unmounts, so every move stays routed to
+        // the parent for the whole gesture.
+        const captureTarget = source.ownerDocument?.documentElement ?? source;
+        try {
+            captureTarget.setPointerCapture(pointerId);
+        }
+        catch {
+            // Capture is best-effort; window listeners still drive the gesture.
+        }
+        const controller = new AbortController();
+        const { signal } = controller;
+        const dispatch = (detail) => {
+            iframe.dispatchEvent(new CustomEvent(IFRAME_OVERLAY_BRIDGE_DRAG_GESTURE_EVENT, { detail }));
+        };
+        const stopAutoScroll = () => {
+            if (autoScrollRaf) {
+                cancelAnimationFrame(autoScrollRaf);
+                autoScrollRaf = 0;
+            }
+        };
+        const edgeAutoScrollStep = () => {
+            const rect = iframe.getBoundingClientRect();
+            if (lastX < rect.left || lastX > rect.right)
+                return 0;
+            return getAutoScrollStep(lastY, rect.top, rect.bottom);
+        };
+        const runAutoScroll = () => {
+            autoScrollRaf = 0;
+            if (!started)
+                return;
+            const step = edgeAutoScrollStep();
+            if (step === 0)
+                return;
+            pvcRef.current?.requestBridgeScrollBy?.({ y: step, behavior: "auto" });
+            dispatch({
+                phase: "move",
+                pointerId,
+                clientX: lastX,
+                clientY: lastY,
+                space: "client",
+            });
+            autoScrollRaf = requestAnimationFrame(runAutoScroll);
+        };
+        const updateAutoScroll = () => {
+            const step = edgeAutoScrollStep();
+            if (step !== 0 && !autoScrollRaf) {
+                autoScrollRaf = requestAnimationFrame(runAutoScroll);
+            }
+            else if (step === 0) {
+                stopAutoScroll();
+            }
+        };
+        const cleanup = () => {
+            stopAutoScroll();
+            controller.abort();
+            try {
+                captureTarget.releasePointerCapture(pointerId);
+            }
+            catch {
+                // Already released (e.g. capture never took); nothing to do.
+            }
+            cleanupRef.current = null;
+        };
+        const finish = (canceled) => {
+            if (finished)
+                return;
+            finished = true;
+            if (started) {
+                dispatch({
+                    phase: "end",
+                    pointerId,
+                    clientX: lastX,
+                    clientY: lastY,
+                    canceled,
+                    space: "client",
+                });
+            }
+            cleanup();
+            onEndRef.current?.({ canceled, started });
+        };
+        // Once the drag has started it is driven by the window-level pointer
+        // listeners below, which keep firing even after this hook (and the grip
+        // element) unmount - which is exactly what happens when the frame menu hides
+        // on dragStart (FrameMenus flips into insertion mode and stops rendering the
+        // grip). Cancelling/tearing down on unmount would abort every drag the
+        // instant it begins; let pointerup/pointercancel finish it. Only an
+        // un-started gesture still needs teardown when the grip goes away.
+        cleanupRef.current = () => {
+            if (started)
+                return;
+            finish(true);
+        };
+        window.addEventListener("pointermove", (ev) => {
+            if (ev.pointerId !== pointerId)
+                return;
+            lastX = ev.clientX;
+            lastY = ev.clientY;
+            if (!started) {
+                const dx = ev.clientX - startX;
+                const dy = ev.clientY - startY;
+                if (Math.hypot(dx, dy) <= DRAG_START_THRESHOLD_PX)
+                    return;
+                const startDetail = getStartDetailRef.current();
+                if (!startDetail) {
+                    finish(true);
+                    return;
+                }
+                started = true;
+                onStartRef.current?.();
+                dispatch({
+                    phase: "start",
+                    pointerId,
+                    ...startDetail,
+                    clientX: ev.clientX,
+                    clientY: ev.clientY,
+                    space: "client",
+                });
+            }
+            else {
+                dispatch({
+                    phase: "move",
+                    pointerId,
+                    clientX: ev.clientX,
+                    clientY: ev.clientY,
+                    space: "client",
+                });
+                updateAutoScroll();
+            }
+        }, { signal });
+        window.addEventListener("pointerup", (ev) => {
+            if (ev.pointerId !== pointerId)
+                return;
+            finish(false);
+        }, { signal });
+        window.addEventListener("pointercancel", (ev) => {
+            if (ev.pointerId !== pointerId)
+                return;
+            finish(true);
+        }, { signal });
+        captureTarget.addEventListener("lostpointercapture", (ev) => {
+            if (ev.pointerId !== pointerId)
+                return;
+            // Losing capture before the drag starts cancels it; once started, the
+            // window listeners carry it to completion regardless of capture.
+            if (started)
+                return;
+            finish(true);
+        }, { signal });
+        window.addEventListener("blur", () => finish(true), { signal });
+        window.addEventListener("pagehide", () => finish(true), { signal });
+        document.addEventListener("visibilitychange", () => {
+            if (document.visibilityState === "hidden")
+                finish(true);
+        }, { signal });
+        window.addEventListener("keydown", (ev) => {
+            if (ev.key === "Escape") {
+                ev.preventDefault();
+                finish(true);
+            }
+        }, { signal });
+    }, []);
+    return { onPointerDown };
+}
+//# sourceMappingURL=useDragInsertionGesture.js.map