@fivepixels-js/react 0.2.8 → 0.2.10

package/dist/utils/overlay/devicePreviewCapture.js

@@ -0,0 +1,167 @@
+import { FIVEPIXELS_HOST_ID } from "../../constants/overlayChrome.js";
+export const DEVICE_PREVIEW_BUTTON_OUTSET = 3;
+export function shouldCaptureDevicePreviewNode(node) {
+    if (node.nodeType !== Node.ELEMENT_NODE) {
+        return true;
+    }
+    const element = node;
+    if (element.hasAttribute("data-fivepixels-skip-capture")) {
+        return false;
+    }
+    return element.id !== FIVEPIXELS_HOST_ID;
+}
+function sanitizeFilenamePart(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "device";
+}
+function formatCaptureStamp(now) {
+    const year = String(now.getFullYear());
+    const month = String(now.getMonth() + 1).padStart(2, "0");
+    const day = String(now.getDate()).padStart(2, "0");
+    const hours = String(now.getHours()).padStart(2, "0");
+    const minutes = String(now.getMinutes()).padStart(2, "0");
+    const seconds = String(now.getSeconds()).padStart(2, "0");
+    return `${year}${month}${day}-${hours}${minutes}${seconds}`;
+}
+export function getDevicePreviewCaptureLayout(args) {
+    const screenWidth = Math.max(1, Math.round(args.screenWidth));
+    const screenHeight = Math.max(1, Math.round(args.screenHeight));
+    const bezel = args.deviceImageEnabled
+        ? {
+            top: Math.max(0, Math.round(args.bezel.top)),
+            right: Math.max(0, Math.round(args.bezel.right)),
+            bottom: Math.max(0, Math.round(args.bezel.bottom)),
+            left: Math.max(0, Math.round(args.bezel.left)),
+        }
+        : { top: 0, right: 0, bottom: 0, left: 0 };
+    const frameWidth = screenWidth + bezel.left + bezel.right;
+    const frameHeight = screenHeight + bezel.top + bezel.bottom;
+    const outset = args.deviceImageEnabled ? DEVICE_PREVIEW_BUTTON_OUTSET : 0;
+    return {
+        canvasWidth: frameWidth + outset * 2,
+        canvasHeight: frameHeight + outset * 2,
+        frameWidth,
+        frameHeight,
+        screenX: outset + bezel.left,
+        screenY: outset + bezel.top,
+        screenWidth,
+        screenHeight,
+        outset,
+    };
+}
+export function buildDevicePreviewCaptureFilename(args) {
+    const deviceId = sanitizeFilenamePart(args.deviceId);
+    const width = Math.max(1, Math.round(args.width));
+    const height = Math.max(1, Math.round(args.height));
+    const stamp = formatCaptureStamp(args.now ?? new Date());
+    return `fivepixels-preview-${deviceId}-${width}x${height}-${stamp}.png`;
+}
+function cropCanvas(source, sx, sy, width, height) {
+    const output = document.createElement("canvas");
+    output.width = width;
+    output.height = height;
+    const context = output.getContext("2d");
+    if (!context) {
+        throw new Error("Canvas 2D context is unavailable.");
+    }
+    const safeX = Math.max(0, Math.min(Math.round(sx), Math.max(0, source.width - width)));
+    const safeY = Math.max(0, Math.min(Math.round(sy), Math.max(0, source.height - height)));
+    context.drawImage(source, safeX, safeY, width, height, 0, 0, width, height);
+    return output;
+}
+export async function defaultRasterizeElement(element, options) {
+    const { toCanvas } = await import("html-to-image");
+    const captureHeight = options.cropToViewport ? Math.max(options.height, Math.round(element.scrollHeight) || options.height) : options.height;
+    const canvas = await toCanvas(element, {
+        width: options.width,
+        height: captureHeight,
+        pixelRatio: 1,
+        skipAutoScale: true,
+        backgroundColor: options.backgroundColor ?? undefined,
+        skipFonts: true,
+        style: {
+            transform: "none",
+            transformOrigin: "top left",
+            margin: "0px",
+            marginLeft: "0px",
+            marginTop: "0px",
+            marginRight: "0px",
+            marginBottom: "0px",
+            left: "0px",
+            top: "0px",
+            right: "auto",
+            bottom: "auto",
+            position: "relative",
+            overflow: options.cropToViewport ? "visible" : "hidden",
+            width: `${options.width}px`,
+            height: `${captureHeight}px`,
+        },
+        filter: shouldCaptureDevicePreviewNode,
+    });
+    if (!options.cropToViewport || (canvas.width === options.width && canvas.height === options.height && element.scrollTop <= 0 && element.scrollLeft <= 0)) {
+        return canvas;
+    }
+    return cropCanvas(canvas, element.scrollLeft, element.scrollTop, options.width, options.height);
+}
+export async function captureDevicePreview(args) {
+    const rasterize = args.rasterize ?? defaultRasterizeElement;
+    const { layout } = args;
+    const output = document.createElement("canvas");
+    output.width = layout.canvasWidth;
+    output.height = layout.canvasHeight;
+    const context = output.getContext("2d");
+    if (!context) {
+        throw new Error("Canvas 2D context is unavailable.");
+    }
+    context.clearRect(0, 0, output.width, output.height);
+    context.fillStyle = args.background;
+    context.fillRect(layout.screenX, layout.screenY, layout.screenWidth, layout.screenHeight);
+    const contentCanvas = await rasterize(args.contentRoot, {
+        width: layout.screenWidth,
+        height: layout.screenHeight,
+        backgroundColor: args.background,
+        cropToViewport: true,
+    });
+    context.drawImage(contentCanvas, layout.screenX, layout.screenY, layout.screenWidth, layout.screenHeight);
+    if (args.deviceImageEnabled) {
+        if (!args.chromeStage) {
+            throw new Error("Device preview chrome is missing.");
+        }
+        const chromeCanvas = await rasterize(args.chromeStage, {
+            width: layout.frameWidth,
+            height: layout.frameHeight,
+            backgroundColor: null,
+        });
+        context.drawImage(chromeCanvas, layout.outset, layout.outset, layout.frameWidth, layout.frameHeight);
+        return output;
+    }
+    if (args.statusBarEnabled && args.statusBarLayer) {
+        const statusBarCanvas = await rasterize(args.statusBarLayer, {
+            width: layout.screenWidth,
+            height: layout.screenHeight,
+            backgroundColor: null,
+        });
+        context.drawImage(statusBarCanvas, layout.screenX, layout.screenY, layout.screenWidth, layout.screenHeight);
+    }
+    return output;
+}
+export function downloadCanvasPng(canvas, filename) {
+    return new Promise((resolve, reject) => {
+        canvas.toBlob((blob) => {
+            if (!blob) {
+                reject(new Error("Failed to encode the preview PNG."));
+                return;
+            }
+            const url = URL.createObjectURL(blob);
+            const anchor = document.createElement("a");
+            anchor.href = url;
+            anchor.download = filename;
+            anchor.rel = "noopener";
+            document.body.append(anchor);
+            anchor.click();
+            anchor.remove();
+            URL.revokeObjectURL(url);
+            resolve();
+        }, "image/png");
+    });
+}
+//# sourceMappingURL=devicePreviewCapture.js.map

package/dist/utils/overlay/devicePreviewCapture.js.map

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

package/dist/utils/overlay/devicePreviewFrame.d.ts

@@ -0,0 +1,31 @@
+export declare const DEVICE_PREVIEW_FRAME_ATTR = "data-fivepixels-device-preview-frame";
+export declare const DEVICE_PREVIEW_FRAME_NAME = "fivepixels-device-preview-guest";
+export declare const DEVICE_PREVIEW_GUEST_STYLE_ID = "fivepixels-device-preview-guest-style";
+export declare const HTML_DEVICE_PREVIEW_ACTIVE_CLASS = "fivepixels-device-preview-active";
+export declare const DEVICE_PREVIEW_HOST_STYLE_ID = "fivepixels-device-preview-host-style";
+export type DevicePreviewContentMetrics = {
+    scrollY: number;
+    scrollHeight: number;
+    clientHeight: number;
+    left: number;
+    top: number;
+    width: number;
+    viewportWidth: number;
+    viewportHeight: number;
+};
+export declare function isInsideDevicePreviewFrame(): boolean;
+export declare function getGuestWindow(iframe: HTMLIFrameElement | null): Window | null;
+export declare function getGuestDocument(iframe: HTMLIFrameElement | null): Document | null;
+export declare function getGuestCaptureRoot(iframe: HTMLIFrameElement | null): HTMLElement | null;
+export declare function isGuestDocumentReady(iframe: HTMLIFrameElement | null): boolean;
+export declare function readGuestContentMetrics(iframe: HTMLIFrameElement | null, fallbackWidth: number): DevicePreviewContentMetrics;
+export declare function buildDevicePreviewHostStyle(args: {
+    background: string;
+    line: string;
+    gridSize: number;
+}): string;
+export declare function syncGuestStatusBarStyle(doc: Document | null, statusBarHeight: number): void;
+export declare function clearGuestStatusBarStyle(doc: Document | null): void;
+export declare function readGuestPageHref(iframe: HTMLIFrameElement | null): string | null;
+export declare function closeDevicePreviewAndSyncGuestUrl(iframe: HTMLIFrameElement | null, close: () => void): void;
+//# sourceMappingURL=devicePreviewFrame.d.ts.map

package/dist/utils/overlay/devicePreviewFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devicePreviewFrame.d.ts","sourceRoot":"","sources":["../../../src/utils/overlay/devicePreviewFrame.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,yCAAyC,CAAC;AAChF,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,6BAA6B,0CAA0C,CAAC;AACrF,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AACnF,eAAO,MAAM,4BAA4B,yCAAyC,CAAC;AAEnF,MAAM,MAAM,2BAA2B,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,0BAA0B,IAAI,OAAO,CAepD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAU9E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAUlF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAWxF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAG9E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,2BAA2B,CAgB5H;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA+BhH;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,MAAM,QAyBpF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,QAE5D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAWjF;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,QAOpG"}

package/dist/utils/overlay/devicePreviewFrame.js

@@ -0,0 +1,149 @@
+import { FIVEPIXELS_HOST_ID } from "../../constants/overlayChrome.js";
+export const DEVICE_PREVIEW_FRAME_ATTR = "data-fivepixels-device-preview-frame";
+export const DEVICE_PREVIEW_FRAME_NAME = "fivepixels-device-preview-guest";
+export const DEVICE_PREVIEW_GUEST_STYLE_ID = "fivepixels-device-preview-guest-style";
+export const HTML_DEVICE_PREVIEW_ACTIVE_CLASS = "fivepixels-device-preview-active";
+export const DEVICE_PREVIEW_HOST_STYLE_ID = "fivepixels-device-preview-host-style";
+export function isInsideDevicePreviewFrame() {
+    if (typeof window === "undefined") {
+        return false;
+    }
+    try {
+        if (window.name === DEVICE_PREVIEW_FRAME_NAME) {
+            return true;
+        }
+        const frame = window.frameElement;
+        return frame instanceof HTMLIFrameElement && frame.hasAttribute(DEVICE_PREVIEW_FRAME_ATTR);
+    }
+    catch {
+        return window.name === DEVICE_PREVIEW_FRAME_NAME;
+    }
+}
+export function getGuestWindow(iframe) {
+    if (!iframe) {
+        return null;
+    }
+    try {
+        return iframe.contentWindow;
+    }
+    catch {
+        return null;
+    }
+}
+export function getGuestDocument(iframe) {
+    if (!iframe) {
+        return null;
+    }
+    try {
+        return iframe.contentDocument;
+    }
+    catch {
+        return null;
+    }
+}
+export function getGuestCaptureRoot(iframe) {
+    const doc = getGuestDocument(iframe);
+    if (!doc) {
+        return null;
+    }
+    if (doc.body) {
+        return doc.body;
+    }
+    return doc.documentElement;
+}
+export function isGuestDocumentReady(iframe) {
+    const doc = getGuestDocument(iframe);
+    return Boolean(doc?.documentElement);
+}
+export function readGuestContentMetrics(iframe, fallbackWidth) {
+    const guestWindow = getGuestWindow(iframe);
+    const guestDocument = getGuestDocument(iframe);
+    const scrolling = guestDocument?.scrollingElement ?? guestDocument?.documentElement;
+    const rect = iframe?.getBoundingClientRect();
+    return {
+        scrollY: Math.round(guestWindow?.scrollY ?? scrolling?.scrollTop ?? 0),
+        scrollHeight: Math.round(scrolling?.scrollHeight ?? 0),
+        clientHeight: Math.round(guestWindow?.innerHeight ?? scrolling?.clientHeight ?? 0),
+        left: Math.round(rect?.left ?? 0),
+        top: Math.round(rect?.top ?? 0),
+        width: Math.round(rect?.width ?? fallbackWidth),
+        viewportWidth: typeof window !== "undefined" && window.innerWidth > 0 ? window.innerWidth : 1280,
+        viewportHeight: typeof window !== "undefined" && window.innerHeight > 0 ? window.innerHeight : 800,
+    };
+}
+export function buildDevicePreviewHostStyle(args) {
+    const { background, line, gridSize } = args;
+    const active = `html.${HTML_DEVICE_PREVIEW_ACTIVE_CLASS}`;
+    return `
+${active},
+${active} body {
+  height: 100% !important;
+  max-height: 100% !important;
+  overflow: hidden !important;
+  background-color: ${background} !important;
+  background-image: linear-gradient(${line} 1px, transparent 1px), linear-gradient(90deg, ${line} 1px, transparent 1px) !important;
+  background-size: ${gridSize}px ${gridSize}px !important;
+}
+
+${active} body > :not(#${FIVEPIXELS_HOST_ID}) {
+  display: none !important;
+}
+
+${active} #${FIVEPIXELS_HOST_ID} {
+  position: fixed !important;
+  inset: 0 !important;
+  width: 100vw !important;
+  height: 100vh !important;
+  max-width: none !important;
+  max-height: none !important;
+  margin: 0 !important;
+  pointer-events: none !important;
+  z-index: 2147483646 !important;
+}
+`;
+}
+export function syncGuestStatusBarStyle(doc, statusBarHeight) {
+    if (!doc) {
+        return;
+    }
+    const safeHeight = Math.max(0, Math.round(statusBarHeight));
+    if (safeHeight <= 0) {
+        doc.getElementById(DEVICE_PREVIEW_GUEST_STYLE_ID)?.remove();
+        return;
+    }
+    let style = doc.getElementById(DEVICE_PREVIEW_GUEST_STYLE_ID);
+    if (!style) {
+        style = doc.createElement("style");
+        style.id = DEVICE_PREVIEW_GUEST_STYLE_ID;
+        doc.documentElement.append(style);
+    }
+    style.textContent = `
+html {
+  padding-top: ${safeHeight}px !important;
+  box-sizing: border-box !important;
+}
+`;
+}
+export function clearGuestStatusBarStyle(doc) {
+    doc?.getElementById(DEVICE_PREVIEW_GUEST_STYLE_ID)?.remove();
+}
+export function readGuestPageHref(iframe) {
+    try {
+        const href = iframe?.contentWindow?.location.href;
+        if (!href || href.startsWith("about:")) {
+            return null;
+        }
+        return href;
+    }
+    catch {
+        return null;
+    }
+}
+export function closeDevicePreviewAndSyncGuestUrl(iframe, close) {
+    const guestHref = readGuestPageHref(iframe);
+    close();
+    if (guestHref && guestHref !== window.location.href) {
+        window.location.replace(guestHref);
+    }
+}
+//# sourceMappingURL=devicePreviewFrame.js.map

package/dist/utils/overlay/devicePreviewFrame.js.map

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

package/dist/utils/overlay/edgeDock.d.ts

@@ -0,0 +1,47 @@
+import type { CSSProperties } from "react";
+import type { DockEdge, PinRailPlacement } from "../../types/pinnedFeedback.js";
+export type { DockEdge, PinRailPlacement };
+/** Shared left/right edge dock helpers (legacy migration + panel collision). */
+export type EdgeDockPlacement = {
+    edge: DockEdge;
+    /** 0 = near top, 1 = near bottom within the usable vertical band. */
+    offsetRatio: number;
+};
+export declare const DEFAULT_EDGE_DOCK_PLACEMENT: EdgeDockPlacement;
+/** Default free-floating pin window position. */
+export declare const DEFAULT_PIN_RAIL_PLACEMENT: PinRailPlacement;
+export declare function clampOffsetRatio(ratio: number, fallback?: number): number;
+export declare function isDockEdge(value: unknown): value is DockEdge;
+export declare function isEdgeDockPlacement(value: unknown): value is EdgeDockPlacement;
+export declare function isFreePinRailPlacement(value: unknown): value is PinRailPlacement;
+export declare function sanitizeEdgeDockPlacement(value: unknown, fallback?: EdgeDockPlacement): EdgeDockPlacement;
+export declare function edgeTopFromPlacement(placement: EdgeDockPlacement, height: number, viewportHeight?: number): number;
+export declare function sanitizePinRailPlacement(value: unknown): PinRailPlacement;
+/** Map a pointer to the nearest left/right edge (center drops are forced to an edge). */
+export declare function projectPointerToEdgePlacement(clientX: number, clientY: number, options?: {
+    height?: number;
+    viewportWidth?: number;
+    viewportHeight?: number;
+    fallback?: EdgeDockPlacement;
+}): EdgeDockPlacement;
+/** Free-floating pin position from a pointer (centered on the pointer). */
+export declare function projectPointerToPinPlacement(clientX: number, clientY: number, options?: {
+    width?: number;
+    height?: number;
+    viewportWidth?: number;
+    viewportHeight?: number;
+}): PinRailPlacement;
+/** Push two same-edge docks apart when their vertical ratios collide. */
+export declare function resolvePlacementAwayFromOther(placement: EdgeDockPlacement, other: EdgeDockPlacement | null | undefined, separation?: number): EdgeDockPlacement;
+/**
+ * Free pin windows no longer snap away from the panel; keep the stored position.
+ */
+export declare function resolvePinPlacementAwayFromPanel(placement: PinRailPlacement): PinRailPlacement;
+type PinStyleOptions = {
+    isDragging?: boolean;
+    dragLeft?: number | null;
+    dragTop?: number | null;
+    width: number;
+};
+export declare function pinPlacementToStyle(placement: PinRailPlacement, options: PinStyleOptions): CSSProperties;
+//# sourceMappingURL=edgeDock.d.ts.map

package/dist/utils/overlay/edgeDock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edgeDock.d.ts","sourceRoot":"","sources":["../../../src/utils/overlay/edgeDock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG5E,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AAE3C,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,iBAGzC,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,EAAE,gBAGxC,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAA0C,GAAG,MAAM,CAM1G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAQ9E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAQhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,iBAA+C,GAAG,iBAAiB,CAStI;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAKlH;AAWD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAazE;AAED,yFAAyF;AACzF,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAC7G,iBAAiB,CAanB;AAED,2EAA2E;AAC3E,wBAAgB,4BAA4B,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F,gBAAgB,CASlB;AAED,yEAAyE;AACzE,wBAAgB,6BAA6B,CACzC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC3C,UAAU,SAA2B,GACtC,iBAAiB,CA2BnB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,gBAAgB,GAAG,gBAAgB,CAE9F;AAED,KAAK,eAAe,GAAG;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,aAAa,CAuBxG"}

package/dist/utils/overlay/edgeDock.js

@@ -0,0 +1,144 @@
+import { OVERLAY_EDGE_MARGIN, PIN_RAIL_BUBBLE_SIZE, PIN_RAIL_EXPANDED_WIDTH } from "../../constants/overlayChrome.js";
+export const DEFAULT_EDGE_DOCK_PLACEMENT = {
+    edge: "right",
+    offsetRatio: 0.2,
+};
+/** Default free-floating pin window position. */
+export const DEFAULT_PIN_RAIL_PLACEMENT = {
+    left: OVERLAY_EDGE_MARGIN,
+    top: OVERLAY_EDGE_MARGIN,
+};
+const MIN_SAME_EDGE_SEPARATION = 0.22;
+export function clampOffsetRatio(ratio, fallback = DEFAULT_EDGE_DOCK_PLACEMENT.offsetRatio) {
+    if (!Number.isFinite(ratio)) {
+        return fallback;
+    }
+    return Math.min(1, Math.max(0, ratio));
+}
+export function isDockEdge(value) {
+    return value === "left" || value === "right";
+}
+export function isEdgeDockPlacement(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const placement = value;
+    return isDockEdge(placement.edge) && typeof placement.offsetRatio === "number" && Number.isFinite(placement.offsetRatio);
+}
+export function isFreePinRailPlacement(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const placement = value;
+    return typeof placement.left === "number" && Number.isFinite(placement.left) && typeof placement.top === "number" && Number.isFinite(placement.top);
+}
+export function sanitizeEdgeDockPlacement(value, fallback = DEFAULT_EDGE_DOCK_PLACEMENT) {
+    if (!isEdgeDockPlacement(value)) {
+        return { ...fallback };
+    }
+    return {
+        edge: value.edge,
+        offsetRatio: clampOffsetRatio(value.offsetRatio, fallback.offsetRatio),
+    };
+}
+export function edgeTopFromPlacement(placement, height, viewportHeight) {
+    const vh = viewportHeight ?? (typeof window !== "undefined" ? window.innerHeight : 720);
+    const usable = Math.max(0, vh - OVERLAY_EDGE_MARGIN * 2 - height);
+    return OVERLAY_EDGE_MARGIN + usable * clampOffsetRatio(placement.offsetRatio);
+}
+function edgePlacementToFreePosition(placement) {
+    const viewportWidth = typeof window !== "undefined" ? window.innerWidth : 1280;
+    const top = edgeTopFromPlacement(placement, PIN_RAIL_BUBBLE_SIZE);
+    const left = placement.edge === "left" ? OVERLAY_EDGE_MARGIN : Math.max(OVERLAY_EDGE_MARGIN, viewportWidth - PIN_RAIL_EXPANDED_WIDTH - OVERLAY_EDGE_MARGIN);
+    return { left, top };
+}
+export function sanitizePinRailPlacement(value) {
+    if (isFreePinRailPlacement(value)) {
+        return {
+            left: value.left,
+            top: Math.max(0, value.top),
+        };
+    }
+    if (isEdgeDockPlacement(value)) {
+        return edgePlacementToFreePosition(sanitizeEdgeDockPlacement(value));
+    }
+    return { ...DEFAULT_PIN_RAIL_PLACEMENT };
+}
+/** Map a pointer to the nearest left/right edge (center drops are forced to an edge). */
+export function projectPointerToEdgePlacement(clientX, clientY, options) {
+    const fallback = options?.fallback ?? DEFAULT_EDGE_DOCK_PLACEMENT;
+    const viewportWidth = options?.viewportWidth ?? (typeof window !== "undefined" ? window.innerWidth : 1280);
+    const viewportHeight = options?.viewportHeight ?? (typeof window !== "undefined" ? window.innerHeight : 720);
+    const height = Math.max(1, options?.height ?? PIN_RAIL_BUBBLE_SIZE);
+    const edge = clientX < viewportWidth / 2 ? "left" : "right";
+    const usable = Math.max(1, viewportHeight - OVERLAY_EDGE_MARGIN * 2 - height);
+    const top = Math.min(Math.max(clientY - height / 2, OVERLAY_EDGE_MARGIN), OVERLAY_EDGE_MARGIN + usable);
+    return {
+        edge,
+        offsetRatio: clampOffsetRatio((top - OVERLAY_EDGE_MARGIN) / usable, fallback.offsetRatio),
+    };
+}
+/** Free-floating pin position from a pointer (centered on the pointer). */
+export function projectPointerToPinPlacement(clientX, clientY, options) {
+    const width = Math.max(1, options?.width ?? PIN_RAIL_EXPANDED_WIDTH);
+    const height = Math.max(1, options?.height ?? PIN_RAIL_BUBBLE_SIZE);
+    const viewportWidth = options?.viewportWidth ?? (typeof window !== "undefined" ? window.innerWidth : 1280);
+    const viewportHeight = options?.viewportHeight ?? (typeof window !== "undefined" ? window.innerHeight : 720);
+    const left = Math.min(Math.max(clientX - width / 2, OVERLAY_EDGE_MARGIN - width + 40), viewportWidth - 40);
+    const top = Math.min(Math.max(clientY - height / 2, OVERLAY_EDGE_MARGIN), Math.max(OVERLAY_EDGE_MARGIN, viewportHeight - 40));
+    return { left, top };
+}
+/** Push two same-edge docks apart when their vertical ratios collide. */
+export function resolvePlacementAwayFromOther(placement, other, separation = MIN_SAME_EDGE_SEPARATION) {
+    const self = sanitizeEdgeDockPlacement(placement);
+    if (!other || other.edge !== self.edge) {
+        return self;
+    }
+    const otherRatio = clampOffsetRatio(other.offsetRatio);
+    let offsetRatio = clampOffsetRatio(self.offsetRatio);
+    if (Math.abs(offsetRatio - otherRatio) >= separation) {
+        return self;
+    }
+    if (offsetRatio <= otherRatio) {
+        offsetRatio = Math.max(0, otherRatio - separation);
+        if (Math.abs(offsetRatio - otherRatio) < separation) {
+            offsetRatio = Math.min(1, otherRatio + separation);
+        }
+    }
+    else {
+        offsetRatio = Math.min(1, otherRatio + separation);
+        if (Math.abs(offsetRatio - otherRatio) < separation) {
+            offsetRatio = Math.max(0, otherRatio - separation);
+        }
+    }
+    return { edge: self.edge, offsetRatio };
+}
+/**
+ * Free pin windows no longer snap away from the panel; keep the stored position.
+ */
+export function resolvePinPlacementAwayFromPanel(placement) {
+    return sanitizePinRailPlacement(placement);
+}
+export function pinPlacementToStyle(placement, options) {
+    const { isDragging, dragLeft, dragTop, width } = options;
+    const resolved = sanitizePinRailPlacement(placement);
+    if (isDragging && typeof dragLeft === "number" && typeof dragTop === "number") {
+        return {
+            position: "fixed",
+            top: dragTop,
+            left: dragLeft,
+            right: "auto",
+            bottom: "auto",
+            width,
+        };
+    }
+    return {
+        position: "fixed",
+        top: resolved.top,
+        left: resolved.left,
+        right: "auto",
+        bottom: "auto",
+        width,
+    };
+}
+//# sourceMappingURL=edgeDock.js.map

package/dist/utils/overlay/edgeDock.js.map

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

package/dist/utils/overlay/floatingWindowStack.d.ts

@@ -0,0 +1,6 @@
+/** Always above floating pin/device windows so the control panel is never covered. */
+export declare const PANEL_LAYER_Z_INDEX = 1001000;
+/** Bump global layer so the latest focused floating window sits above peers. */
+export declare function claimFloatingWindowZIndex(base?: number): number;
+export declare function getFloatingWindowZBase(): number;
+//# sourceMappingURL=floatingWindowStack.d.ts.map

package/dist/utils/overlay/floatingWindowStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingWindowStack.d.ts","sourceRoot":"","sources":["../../../src/utils/overlay/floatingWindowStack.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAI7C,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,IAAI,SAAyB,GAAG,MAAM,CAQ/E;AAED,wBAAgB,sBAAsB,WAErC"}

package/dist/utils/overlay/floatingWindowStack.js

@@ -0,0 +1,17 @@
+const FLOATING_WINDOW_Z_BASE = 1000002;
+const FLOATING_WINDOW_Z_CEILING = 1000900;
+/** Always above floating pin/device windows so the control panel is never covered. */
+export const PANEL_LAYER_Z_INDEX = 1001000;
+let nextFloatingWindowZIndex = FLOATING_WINDOW_Z_BASE;
+/** Bump global layer so the latest focused floating window sits above peers. */
+export function claimFloatingWindowZIndex(base = FLOATING_WINDOW_Z_BASE) {
+    nextFloatingWindowZIndex += 1;
+    if (nextFloatingWindowZIndex > FLOATING_WINDOW_Z_CEILING) {
+        nextFloatingWindowZIndex = base + 1;
+    }
+    return Math.max(base, nextFloatingWindowZIndex);
+}
+export function getFloatingWindowZBase() {
+    return FLOATING_WINDOW_Z_BASE;
+}
+//# sourceMappingURL=floatingWindowStack.js.map

package/dist/utils/overlay/floatingWindowStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingWindowStack.js","sourceRoot":"","sources":["../../../src/utils/overlay/floatingWindowStack.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,OAAS,CAAC;AACzC,MAAM,yBAAyB,GAAG,OAAS,CAAC;AAE5C,sFAAsF;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAS,CAAC;AAE7C,IAAI,wBAAwB,GAAG,sBAAsB,CAAC;AAEtD,gFAAgF;AAChF,MAAM,UAAU,yBAAyB,CAAC,IAAI,GAAG,sBAAsB;IACnE,wBAAwB,IAAI,CAAC,CAAC;IAE9B,IAAI,wBAAwB,GAAG,yBAAyB,EAAE,CAAC;QACvD,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,sBAAsB;IAClC,OAAO,sBAAsB,CAAC;AAClC,CAAC"}