@parhelia/core 0.1.12907 → 0.1.12909

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

@@ -0,0 +1,83 @@
+import { Component, FieldDescriptor } from "../../pageModel";
+import type { BridgeGeometrySnapshot, SerializablePageStructure } from "../../bridge/protocol";
+export type OverlayRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type OverlayMetrics = {
+    scrollLeft: number;
+    scrollTop: number;
+    scrollScale: number;
+    visualScale: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    scrollWidth: number;
+    scrollHeight: number;
+};
+type DOMRectLike = Pick<DOMRect, "left" | "top" | "width" | "height">;
+export declare function getOverlayScrollMetrics(_iframe: HTMLIFrameElement | null | undefined, scrollScale: number, visualScale: number): Pick<OverlayMetrics, "scrollLeft" | "scrollTop" | "scrollScale" | "visualScale">;
+export declare function getOverlayMetrics(iframe: HTMLIFrameElement | null | undefined, scrollScale: number, visualScale: number): OverlayMetrics;
+export declare function toOverlayRect(viewportRect: DOMRectLike, metrics: OverlayMetrics): OverlayRect;
+export declare function rectEquals(a: OverlayRect | null | undefined, b: OverlayRect | null | undefined, tolerance?: number): boolean;
+export declare function rectListEquals(a: readonly OverlayRect[] | null | undefined, b: readonly OverlayRect[] | null | undefined, tolerance?: number): boolean;
+export declare function getTextNodeAtOffset(root: Node, offset: number, affinity?: "forward" | "backward"): {
+    node: Text;
+    offset: number;
+} | null;
+export declare function createRangeFromTextOffsets(iframeDocument: Document, root: Node, start: number, end: number): Range | null;
+export declare function measureTextRangeRects(iframeDocument: Document, root: Node, start: number, end: number, metrics: OverlayMetrics): OverlayRect[];
+export declare function measureCollapsedTextOffsetRect(iframeDocument: Document, root: Node, offset: number, metrics: OverlayMetrics): OverlayRect | null;
+export declare function measureElementRect(element: Element | null | undefined, metrics: OverlayMetrics): OverlayRect | null;
+/**
+ * Find the bridge geometry target for a component (carries its `elementKey` and
+ * raw host-viewport rect). Used by the sibling-shift preview to address elements
+ * inside the iframe and size the gap.
+ */
+export declare function findBridgeComponentTarget(geometry: BridgeGeometrySnapshot | undefined, component: Component): import("../../..").BridgeGeometryTarget | null;
+export declare function measureBridgeComponentRect(geometry: BridgeGeometrySnapshot | undefined, component: Component, metrics: OverlayMetrics): {
+    rect: OverlayRect;
+    elements: never[];
+} | null;
+export declare function measureBridgePlaceholderRect(geometry: BridgeGeometrySnapshot | undefined, placeholderKey: string, metrics: OverlayMetrics): {
+    rect: OverlayRect;
+    target: import("../../..").BridgeGeometryTarget;
+} | null;
+export declare function measureBridgeFieldRect(geometry: BridgeGeometrySnapshot | undefined, structure: SerializablePageStructure | undefined, fieldDescriptor: FieldDescriptor, metrics: OverlayMetrics): OverlayRect | null;
+export declare function measureBridgeTextRangeRects(geometry: BridgeGeometrySnapshot | undefined, key: string, metrics: OverlayMetrics): OverlayRect[];
+export declare function bridgeRectToOverlayRect(geometry: BridgeGeometrySnapshot, rect: BridgeGeometrySnapshot["targets"][number]["rect"], metrics: OverlayMetrics): OverlayRect;
+/**
+ * Map a point expressed in the host iframe's viewport coordinate space - the
+ * same space `getBoundingClientRect` uses inside the host, i.e. the space of
+ * the measured target rects - into overlay/document space.
+ *
+ * Used for pointer coordinates forwarded by the bridge host during a canvas
+ * drag gesture. It reuses {@link bridgeRectToOverlayRect} (which already folds
+ * in scroll plus the rect/scroll/visual scales) by treating the point as a
+ * zero-size rect, so scroll is never added twice.
+ */
+export declare function hostViewportToOverlay(point: {
+    x: number;
+    y: number;
+}, geometry: BridgeGeometrySnapshot, metrics: OverlayMetrics): {
+    x: number;
+    y: number;
+};
+/**
+ * Map a parent-document client point (e.g. a pointer/drag event over the
+ * iframe) into overlay/document space so it can be compared with computed zone
+ * positions.
+ *
+ * The overlay layer is only translated (by the scaled scroll); its children are
+ * positioned at coordinates that already include the visual scale. So mapping a
+ * client point is just its offset from the layer's on-screen origin - there is
+ * no scale to divide out and no scroll term to add (both are already baked into
+ * the layer's rect and the zone positions). Pass the overlay *layer* element's
+ * bounding rect.
+ */
+export declare function clientToOverlay(clientX: number, clientY: number, overlayLayerRect: Pick<DOMRect, "left" | "top">): {
+    x: number;
+    y: number;
+};
+export {};

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

@@ -0,0 +1,349 @@
+import { normalizeMarkerId } from "../../utils";
+export function getOverlayScrollMetrics(_iframe, scrollScale, visualScale) {
+    return {
+        scrollLeft: 0,
+        scrollTop: 0,
+        scrollScale,
+        visualScale,
+    };
+}
+export function getOverlayMetrics(iframe, scrollScale, visualScale) {
+    const scrollMetrics = getOverlayScrollMetrics(iframe, scrollScale, visualScale);
+    const viewportWidth = iframe?.clientWidth || 0;
+    const viewportHeight = iframe?.clientHeight || 0;
+    return {
+        ...scrollMetrics,
+        viewportWidth,
+        viewportHeight,
+        scrollWidth: viewportWidth,
+        scrollHeight: viewportHeight,
+    };
+}
+export function toOverlayRect(viewportRect, metrics) {
+    return {
+        x: (viewportRect.left + metrics.scrollLeft * metrics.scrollScale) *
+            metrics.visualScale,
+        y: (viewportRect.top + metrics.scrollTop * metrics.scrollScale) *
+            metrics.visualScale,
+        width: viewportRect.width * metrics.visualScale,
+        height: viewportRect.height * metrics.visualScale,
+    };
+}
+export function rectEquals(a, b, tolerance = 0.5) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    return (Math.abs(a.x - b.x) <= tolerance &&
+        Math.abs(a.y - b.y) <= tolerance &&
+        Math.abs(a.width - b.width) <= tolerance &&
+        Math.abs(a.height - b.height) <= tolerance);
+}
+export function rectListEquals(a, b, tolerance = 0.5) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!rectEquals(a[i], b[i], tolerance))
+            return false;
+    }
+    return true;
+}
+export function getTextNodeAtOffset(root, offset, affinity = "backward") {
+    const ownerDocument = root.ownerDocument || document;
+    const walker = ownerDocument.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+    let currentNode;
+    let boundaryNode = null;
+    while ((currentNode = walker.nextNode())) {
+        const nodeLength = currentNode.textContent?.length || 0;
+        if (offset < nodeLength) {
+            return { node: currentNode, offset };
+        }
+        if (offset === nodeLength) {
+            if (affinity === "backward") {
+                return { node: currentNode, offset };
+            }
+            boundaryNode = currentNode;
+            offset = 0;
+            continue;
+        }
+        offset -= nodeLength;
+    }
+    return boundaryNode
+        ? { node: boundaryNode, offset: boundaryNode.textContent?.length || 0 }
+        : null;
+}
+export function createRangeFromTextOffsets(iframeDocument, root, start, end) {
+    const startData = getTextNodeAtOffset(root, start, "forward");
+    const endData = getTextNodeAtOffset(root, end, "backward");
+    if (!startData || !endData) {
+        if ((root.textContent ?? "") === "" && start === 0 && end === 0) {
+            try {
+                const emptyRange = iframeDocument.createRange();
+                emptyRange.selectNodeContents(root);
+                emptyRange.collapse(true);
+                return emptyRange;
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    try {
+        const textRange = iframeDocument.createRange();
+        textRange.setStart(startData.node, startData.offset);
+        textRange.setEnd(endData.node, endData.offset);
+        return textRange;
+    }
+    catch {
+        return null;
+    }
+}
+export function measureTextRangeRects(iframeDocument, root, start, end, metrics) {
+    if (start >= end)
+        return [];
+    const textRange = createRangeFromTextOffsets(iframeDocument, root, start, end);
+    return textRange
+        ? Array.from(textRange.getClientRects()).map((rect) => toOverlayRect(rect, metrics))
+        : [];
+}
+export function measureCollapsedTextOffsetRect(iframeDocument, root, offset, metrics) {
+    try {
+        const caretRange = createRangeFromTextOffsets(iframeDocument, root, offset, offset);
+        if (!caretRange)
+            return null;
+        const collapsedRect = Array.from(caretRange.getClientRects()).find((rect) => rect.height > 0);
+        if (collapsedRect) {
+            return toOverlayRect({
+                left: collapsedRect.left,
+                top: collapsedRect.top,
+                width: Math.max(collapsedRect.width, 1),
+                height: collapsedRect.height,
+            }, metrics);
+        }
+        const textLength = root.textContent?.length ?? 0;
+        const fallbackRects = offset > 0
+            ? measureTextRangeRects(iframeDocument, root, offset - 1, offset, metrics)
+            : offset < textLength
+                ? measureTextRangeRects(iframeDocument, root, offset, offset + 1, metrics)
+                : [];
+        const fallbackRect = fallbackRects[0];
+        if (!fallbackRect)
+            return null;
+        return {
+            x: offset > 0 ? fallbackRect.x + fallbackRect.width : fallbackRect.x,
+            y: fallbackRect.y,
+            width: 1,
+            height: fallbackRect.height,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function measureElementRect(element, metrics) {
+    if (!element || !element.isConnected)
+        return null;
+    try {
+        return toOverlayRect(element.getBoundingClientRect(), metrics);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the bridge geometry target for a component (carries its `elementKey` and
+ * raw host-viewport rect). Used by the sibling-shift preview to address elements
+ * inside the iframe and size the gap.
+ */
+export function findBridgeComponentTarget(geometry, component) {
+    if (!geometry || !component.id)
+        return null;
+    const componentId = normalizeMarkerId(component.id);
+    return (geometry.targets.find((candidate) => {
+        if (candidate.kind !== "component")
+            return false;
+        return (normalizeMarkerId(candidate.componentId) === componentId ||
+            normalizeMarkerId(candidate.key) === componentId);
+    }) ?? null);
+}
+export function measureBridgeComponentRect(geometry, component, metrics) {
+    if (!geometry || !component.id)
+        return null;
+    const componentId = normalizeMarkerId(component.id);
+    const target = geometry.targets.find((candidate) => {
+        if (candidate.kind !== "component")
+            return false;
+        return (normalizeMarkerId(candidate.componentId) === componentId ||
+            normalizeMarkerId(candidate.key) === componentId);
+    });
+    if (!target?.rect || !hasBridgeRectSize(target.rect))
+        return null;
+    return {
+        rect: bridgeRectToOverlayRect(geometry, target.rect, metrics),
+        elements: [],
+    };
+}
+export function measureBridgePlaceholderRect(geometry, placeholderKey, metrics) {
+    if (!geometry || !placeholderKey)
+        return null;
+    const target = geometry.targets.find((candidate) => {
+        if (candidate.kind !== "placeholder")
+            return false;
+        return (bridgeKeysMatch(candidate.placeholderKey, placeholderKey) ||
+            bridgeKeysMatch(candidate.key, placeholderKey));
+    });
+    if (!target?.rect || !hasBridgeRectSize(target.rect))
+        return null;
+    return {
+        rect: bridgeRectToOverlayRect(geometry, target.rect, metrics),
+        target,
+    };
+}
+export function measureBridgeFieldRect(geometry, structure, fieldDescriptor, metrics) {
+    const target = findBridgeFieldTarget(geometry, structure, fieldDescriptor);
+    if (!geometry || !target?.rect || !hasBridgeRectSize(target.rect)) {
+        return null;
+    }
+    return bridgeRectToOverlayRect(geometry, target.rect, metrics);
+}
+export function measureBridgeTextRangeRects(geometry, key, metrics) {
+    if (!geometry || !key)
+        return [];
+    return geometry.targets
+        .filter((target) => target.kind === "textRange" &&
+        target.key === key &&
+        hasBridgeRectSize(target.rect))
+        .map((target) => bridgeRectToOverlayRect(geometry, target.rect, metrics));
+}
+// Bridge-reported scales are optional and must be positive/finite to be
+// usable; anything else collapses to 1 (identity).
+function resolveBridgeScale(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0
+        ? value
+        : 1;
+}
+export function bridgeRectToOverlayRect(geometry, rect, metrics) {
+    const rectScale = resolveBridgeScale(geometry.rectScale);
+    const scrollScale = resolveBridgeScale(geometry.scrollScale);
+    const documentX = rect.left * rectScale +
+        geometry.scroll.x * metrics.scrollScale * scrollScale;
+    const documentY = rect.top * rectScale +
+        geometry.scroll.y * metrics.scrollScale * scrollScale;
+    return {
+        x: documentX * metrics.visualScale,
+        y: documentY * metrics.visualScale,
+        width: rect.width * rectScale * metrics.visualScale,
+        height: rect.height * rectScale * metrics.visualScale,
+    };
+}
+/**
+ * Map a point expressed in the host iframe's viewport coordinate space - the
+ * same space `getBoundingClientRect` uses inside the host, i.e. the space of
+ * the measured target rects - into overlay/document space.
+ *
+ * Used for pointer coordinates forwarded by the bridge host during a canvas
+ * drag gesture. It reuses {@link bridgeRectToOverlayRect} (which already folds
+ * in scroll plus the rect/scroll/visual scales) by treating the point as a
+ * zero-size rect, so scroll is never added twice.
+ */
+export function hostViewportToOverlay(point, geometry, metrics) {
+    const rect = {
+        x: point.x,
+        y: point.y,
+        left: point.x,
+        top: point.y,
+        right: point.x,
+        bottom: point.y,
+        width: 0,
+        height: 0,
+    };
+    const overlay = bridgeRectToOverlayRect(geometry, rect, metrics);
+    return { x: overlay.x, y: overlay.y };
+}
+/**
+ * Map a parent-document client point (e.g. a pointer/drag event over the
+ * iframe) into overlay/document space so it can be compared with computed zone
+ * positions.
+ *
+ * The overlay layer is only translated (by the scaled scroll); its children are
+ * positioned at coordinates that already include the visual scale. So mapping a
+ * client point is just its offset from the layer's on-screen origin - there is
+ * no scale to divide out and no scroll term to add (both are already baked into
+ * the layer's rect and the zone positions). Pass the overlay *layer* element's
+ * bounding rect.
+ */
+export function clientToOverlay(clientX, clientY, overlayLayerRect) {
+    return {
+        x: clientX - overlayLayerRect.left,
+        y: clientY - overlayLayerRect.top,
+    };
+}
+function bridgeKeysMatch(left, right) {
+    if (!left || !right)
+        return false;
+    return left === right || normalizeMarkerId(left) === normalizeMarkerId(right);
+}
+function findBridgeFieldTarget(geometry, structure, fieldDescriptor) {
+    if (!geometry || !fieldDescriptor.fieldId)
+        return undefined;
+    const itemMatches = (item) => {
+        if (!item)
+            return false;
+        if (!bridgeKeysMatch(item.id, fieldDescriptor.item.id))
+            return false;
+        if (fieldDescriptor.item.language &&
+            item.language &&
+            item.language !== fieldDescriptor.item.language) {
+            return false;
+        }
+        if (fieldDescriptor.item.version !== undefined &&
+            item.version !== undefined &&
+            item.version !== fieldDescriptor.item.version) {
+            return false;
+        }
+        return true;
+    };
+    const directTarget = geometry.targets.find((target) => {
+        if (target.kind !== "field")
+            return false;
+        if (!bridgeKeysMatch(target.fieldId, fieldDescriptor.fieldId)) {
+            return false;
+        }
+        return itemMatches(target.item);
+    });
+    if (directTarget)
+        return directTarget;
+    const structureField = structure?.fields.find((field) => {
+        if (!bridgeKeysMatch(field.fieldId, fieldDescriptor.fieldId))
+            return false;
+        return itemMatches(field.item);
+    });
+    const structureTarget = structureField
+        ? geometry.targets.find((target) => {
+            if (target.kind !== "field")
+                return false;
+            if (structureField.elementKey &&
+                bridgeKeysMatch(target.elementKey, structureField.elementKey)) {
+                return true;
+            }
+            return false;
+        })
+        : undefined;
+    if (structureTarget)
+        return structureTarget;
+    if (structureField || fieldDescriptor.item.id)
+        return undefined;
+    return geometry.targets.find((target) => {
+        return (target.kind === "field" &&
+            bridgeKeysMatch(target.fieldId, fieldDescriptor.fieldId));
+    });
+}
+function hasBridgeRectSize(rect) {
+    return rect.width > 0 || rect.height > 0;
+}
+//# sourceMappingURL=geometry.js.map

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

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

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

@@ -0,0 +1,67 @@
+import type { DragObject } from "../../client/editContext";
+import { Component, Placeholder } from "../../pageModel";
+import type { BridgeGeometrySnapshot } from "../../bridge/protocol";
+import { OverlayMetrics, OverlayRect } from "./geometry";
+/**
+ * A single insertion gap inside a placeholder, in overlay/document space.
+ *
+ * `index` is the RAW position among ALL of the placeholder's DOM-ordered
+ * children (before-first = 0, after-component-i = i + 1), including hidden
+ * layout components. This is what the host sibling-shift animation needs. The
+ * layout-excluded index that edit operations expect is derived on demand via
+ * {@link layoutAwareIndex}.
+ */
+export type PlaceholderZone = {
+    placeholder: Placeholder;
+    position: {
+        x: number;
+        y: number;
+    };
+    index: number;
+    targetRect?: OverlayRect | null;
+    element?: Element | null;
+    anchor: "top" | "bottom" | "left" | "right";
+    orientation: "horizontal" | "vertical";
+    description?: string | null;
+};
+export type PlaceholderZonesInput = {
+    placeholders: Placeholder[];
+    geometry: BridgeGeometrySnapshot | undefined;
+    metrics: OverlayMetrics;
+    dragObject?: DragObject;
+    selectedForInsertion?: string;
+    insertMode?: boolean;
+    showLayoutComponents?: boolean;
+    hoveredComponentId?: string;
+    scopeInsertModeToHoveredComponent?: boolean;
+};
+export type InsertSuitabilityInput = Pick<PlaceholderZonesInput, "dragObject" | "selectedForInsertion" | "insertMode"> & {
+    selectedForInsertionIsComponent?: boolean;
+};
+/**
+ * Convert a raw zone index (over all DOM children) into the layout-excluded
+ * index that `MoveComponentOperation` / `addComponent` expect. Shared by the
+ * drop-zone dots, the insertion line, and keyboard reordering so all three
+ * agree around hidden layout components.
+ */
+export declare function layoutAwareIndex(components: Component[], rawIndex: number): number;
+/**
+ * Compute the set of insertion gaps for the current drag/insert context, at
+ * their TRUE positions (no overlap-avoidance shuffling). This is the single
+ * source of truth consumed by both the drop-zone dots (which then apply
+ * presentation-only overlap avoidance) and the live insertion zone.
+ */
+export declare function computePlaceholderZones(input: PlaceholderZonesInput): PlaceholderZone[];
+export declare function placeholderAcceptsInsertContext(placeholder: Placeholder, { dragObject, selectedForInsertion, insertMode, selectedForInsertionIsComponent, }: InsertSuitabilityInput): boolean;
+/**
+ * Pick the insertion gap nearest the cursor (in overlay/document space),
+ * weighting the placeholder's cross axis so the cursor stays within the
+ * hovered column/row.
+ */
+export declare function resolveNearestGap(point: {
+    x: number;
+    y: number;
+}, zones: PlaceholderZone[]): PlaceholderZone | null;
+export declare function placeholderZonesEqual(previous: PlaceholderZone[], next: PlaceholderZone[]): boolean;
+export declare function measureBridgePlaceholderZones(placeholder: Placeholder, geometry: BridgeGeometrySnapshot, metrics: OverlayMetrics): PlaceholderZone[];
+export declare function isInsideLayoutComponent(component?: Component | null): boolean;