@docmentis/udoc-viewer 0.6.21 → 0.6.23

package/dist/src/ui/viewer/tools/AnnotationSelectController.js

@@ -0,0 +1,367 @@
+/**
+ * AnnotationSelectController — handles annotation selection, move, resize, and deletion.
+ *
+ * When the "select" sub-tool is active (in either annotate or markup tool sets):
+ * - Clicking an annotation selects it, showing a bounding box with resize handles.
+ * - Dragging the bounding box moves the annotation.
+ * - Dragging a resize handle resizes the annotation.
+ * - Pressing Delete/Backspace removes the selected annotation.
+ * - Clicking empty space deselects.
+ */
+import { getPointsToPixels, isToolSet, ANNOTATION_FORMATS } from "../state";
+import { offsetAnnotation, resizeAnnotation } from "../annotation/utils";
+const SELECT_CURSOR_CLASS = "udoc-viewer--tool-select";
+const MOVING_CLASS = "udoc-viewer--annotation-moving";
+const RESIZING_CLASS = "udoc-viewer--annotation-resizing";
+const BBOX_CLASS = "udoc-annotation-select-bbox";
+const HANDLE_POSITIONS = ["nw", "n", "ne", "e", "se", "s", "sw", "w"];
+const HANDLE_CURSORS = {
+    nw: "nwse-resize",
+    n: "ns-resize",
+    ne: "nesw-resize",
+    e: "ew-resize",
+    se: "nwse-resize",
+    s: "ns-resize",
+    sw: "nesw-resize",
+    w: "ew-resize",
+};
+export function createAnnotationSelectController(options) {
+    const { scrollArea, viewerRoot, store } = options;
+    let active = false;
+    let bboxEl = null;
+    let innerEl = null;
+    let isDragging = false;
+    let dragMode = "move";
+    let dragScale = 1;
+    let dragStartX = 0;
+    let dragStartY = 0;
+    let dragDx = 0;
+    let dragDy = 0;
+    let dragAnnotationPageIndex = -1;
+    let dragAnnotationIndex = -1;
+    /** Original bounds at drag start (for resize) */
+    let dragOriginalBounds = { x: 0, y: 0, width: 0, height: 0 };
+    /** Which handle is being dragged (for resize) */
+    let dragHandle = "se";
+    // =========================================================================
+    // Bounding box with handles
+    // =========================================================================
+    function removeBbox() {
+        if (bboxEl) {
+            bboxEl.remove();
+            bboxEl = null;
+            innerEl = null;
+        }
+    }
+    function updateSelectionVisual() {
+        removeBbox();
+        const state = store.getState();
+        const sel = state.selectedAnnotation;
+        if (!sel)
+            return;
+        const annotations = state.pageAnnotations.get(sel.pageIndex);
+        if (!annotations || sel.annotationIndex >= annotations.length)
+            return;
+        const annotation = annotations[sel.annotationIndex];
+        const bounds = annotation.bounds;
+        if (!bounds || (bounds.width === 0 && bounds.height === 0))
+            return;
+        const pageNum = sel.pageIndex + 1;
+        const slot = scrollArea.querySelector(`[data-page="${pageNum}"]`);
+        if (!slot)
+            return;
+        const annotationLayer = slot.querySelector(".udoc-spread__annotation-layer");
+        if (!annotationLayer)
+            return;
+        const pointsToPixels = getPointsToPixels(state.dpi);
+        const zoom = state.effectiveZoom ?? state.zoom;
+        const scale = pointsToPixels * zoom;
+        // Outer wrapper — copies annotation layer positioning
+        bboxEl = document.createElement("div");
+        bboxEl.className = BBOX_CLASS;
+        bboxEl.style.position = "absolute";
+        bboxEl.style.width = annotationLayer.style.width;
+        bboxEl.style.height = annotationLayer.style.height;
+        bboxEl.style.left = annotationLayer.style.left;
+        bboxEl.style.top = annotationLayer.style.top;
+        bboxEl.style.transform = annotationLayer.style.transform;
+        bboxEl.style.transformOrigin = "center";
+        // Inner — the actual bounding rectangle
+        innerEl = document.createElement("div");
+        innerEl.className = BBOX_CLASS + "__inner";
+        innerEl.style.position = "absolute";
+        innerEl.style.left = `${bounds.x * scale}px`;
+        innerEl.style.top = `${bounds.y * scale}px`;
+        innerEl.style.width = `${bounds.width * scale}px`;
+        innerEl.style.height = `${bounds.height * scale}px`;
+        // Resize handles
+        for (const pos of HANDLE_POSITIONS) {
+            const handle = document.createElement("div");
+            handle.className = `${BBOX_CLASS}__handle ${BBOX_CLASS}__handle--${pos}`;
+            handle.style.cursor = HANDLE_CURSORS[pos];
+            handle.dataset.handle = pos;
+            innerEl.appendChild(handle);
+        }
+        bboxEl.appendChild(innerEl);
+        slot.appendChild(bboxEl);
+    }
+    /** Update inner element position/size during drag preview. */
+    function updateInnerPreview(bounds, newBounds) {
+        if (!innerEl)
+            return;
+        innerEl.style.left = `${newBounds.x * dragScale}px`;
+        innerEl.style.top = `${newBounds.y * dragScale}px`;
+        innerEl.style.width = `${newBounds.width * dragScale}px`;
+        innerEl.style.height = `${newBounds.height * dragScale}px`;
+    }
+    // =========================================================================
+    // Resize bounds computation
+    // =========================================================================
+    /** Compute new bounds from dragging a resize handle. */
+    function computeResizedBounds(original, handle, dx, dy) {
+        let { x, y, width, height } = original;
+        // Adjust edges based on handle
+        if (handle.includes("w")) {
+            x += dx;
+            width -= dx;
+        }
+        if (handle.includes("e") || handle === "e") {
+            width += dx;
+        }
+        if (handle.includes("n") && handle !== "ne" && handle !== "nw") {
+            // "n" only
+            y += dy;
+            height -= dy;
+        }
+        if (handle === "nw" || handle === "n" || handle === "ne") {
+            y += dy;
+            height -= dy;
+        }
+        if (handle === "sw" || handle === "s" || handle === "se") {
+            height += dy;
+        }
+        // Enforce minimum size and flip if dragged past opposite edge
+        const MIN = 2;
+        if (width < MIN) {
+            x = x + width - MIN;
+            width = MIN;
+        }
+        if (height < MIN) {
+            y = y + height - MIN;
+            height = MIN;
+        }
+        return { x, y, width, height };
+    }
+    // =========================================================================
+    // Pointer events
+    // =========================================================================
+    function onPointerDown(e) {
+        if (e.button !== 0)
+            return;
+        const target = e.target;
+        // Check if clicking a resize handle
+        const handleEl = target.closest(`[data-handle]`);
+        if (handleEl && bboxEl?.contains(handleEl)) {
+            const sel = store.getState().selectedAnnotation;
+            if (sel) {
+                const slotEl = bboxEl.closest("[data-page]");
+                if (slotEl) {
+                    startDrag(e, sel.pageIndex, sel.annotationIndex, "resize", handleEl.dataset.handle);
+                    return;
+                }
+            }
+        }
+        // Check if clicking on an annotation
+        const annotationEl = target.closest("[data-annotation-index]");
+        if (annotationEl) {
+            const slotEl = annotationEl.closest("[data-page]");
+            if (!slotEl)
+                return;
+            const pageNum = parseInt(slotEl.dataset.page, 10);
+            if (isNaN(pageNum))
+                return;
+            const annotationIndex = parseInt(annotationEl.getAttribute("data-annotation-index"), 10);
+            if (isNaN(annotationIndex))
+                return;
+            const pageIndex = pageNum - 1;
+            const sel = store.getState().selectedAnnotation;
+            if (sel && sel.pageIndex === pageIndex && sel.annotationIndex === annotationIndex) {
+                startDrag(e, pageIndex, annotationIndex, "move");
+                return;
+            }
+            store.dispatch({ type: "SELECT_ANNOTATION", pageIndex, annotationIndex });
+            e.preventDefault();
+            e.stopPropagation();
+            return;
+        }
+        // Check if clicking on the bbox inner (for move)
+        if (innerEl && (target === innerEl || innerEl.contains(target))) {
+            const sel = store.getState().selectedAnnotation;
+            if (sel) {
+                startDrag(e, sel.pageIndex, sel.annotationIndex, "move");
+                return;
+            }
+        }
+        // Clicked outside — deselect
+        store.dispatch({ type: "DESELECT_ANNOTATION" });
+    }
+    function startDrag(e, pageIndex, annotationIndex, mode, handle) {
+        const state = store.getState();
+        const pointsToPixels = getPointsToPixels(state.dpi);
+        const zoom = state.effectiveZoom ?? state.zoom;
+        const annotations = state.pageAnnotations.get(pageIndex);
+        if (!annotations || annotationIndex >= annotations.length)
+            return;
+        isDragging = true;
+        dragMode = mode;
+        dragScale = pointsToPixels * zoom;
+        dragStartX = e.clientX;
+        dragStartY = e.clientY;
+        dragDx = 0;
+        dragDy = 0;
+        dragAnnotationPageIndex = pageIndex;
+        dragAnnotationIndex = annotationIndex;
+        dragOriginalBounds = { ...annotations[annotationIndex].bounds };
+        dragHandle = handle ?? "se";
+        viewerRoot.classList.add(mode === "move" ? MOVING_CLASS : RESIZING_CLASS);
+        if (mode === "resize") {
+            viewerRoot.style.cursor = HANDLE_CURSORS[dragHandle];
+        }
+        scrollArea.setPointerCapture(e.pointerId);
+        e.preventDefault();
+        e.stopPropagation();
+    }
+    function onPointerMove(e) {
+        if (!isDragging)
+            return;
+        const pxDx = e.clientX - dragStartX;
+        const pxDy = e.clientY - dragStartY;
+        dragDx = pxDx / dragScale;
+        dragDy = pxDy / dragScale;
+        if (dragMode === "move") {
+            if (innerEl) {
+                const b = dragOriginalBounds;
+                updateInnerPreview(b, { x: b.x + dragDx, y: b.y + dragDy, width: b.width, height: b.height });
+            }
+        }
+        else {
+            // Resize preview
+            const newBounds = computeResizedBounds(dragOriginalBounds, dragHandle, dragDx, dragDy);
+            updateInnerPreview(dragOriginalBounds, newBounds);
+        }
+    }
+    function onPointerUp(e) {
+        if (!isDragging)
+            return;
+        scrollArea.releasePointerCapture(e.pointerId);
+        viewerRoot.classList.remove(MOVING_CLASS);
+        viewerRoot.classList.remove(RESIZING_CLASS);
+        viewerRoot.style.cursor = "";
+        isDragging = false;
+        // Check for meaningful movement
+        if (Math.abs(dragDx) < 0.5 && Math.abs(dragDy) < 0.5) {
+            updateSelectionVisual();
+            return;
+        }
+        const state = store.getState();
+        const annotations = state.pageAnnotations.get(dragAnnotationPageIndex);
+        if (!annotations || dragAnnotationIndex >= annotations.length)
+            return;
+        const original = annotations[dragAnnotationIndex];
+        let updated;
+        if (dragMode === "move") {
+            updated = offsetAnnotation(original, dragDx, dragDy);
+        }
+        else {
+            const newBounds = computeResizedBounds(dragOriginalBounds, dragHandle, dragDx, dragDy);
+            updated = resizeAnnotation(original, newBounds);
+        }
+        store.dispatch({
+            type: "UPDATE_ANNOTATION",
+            pageIndex: dragAnnotationPageIndex,
+            annotationIndex: dragAnnotationIndex,
+            annotation: updated,
+        });
+    }
+    function onPointerCancel(e) {
+        if (!isDragging)
+            return;
+        scrollArea.releasePointerCapture(e.pointerId);
+        viewerRoot.classList.remove(MOVING_CLASS);
+        viewerRoot.classList.remove(RESIZING_CLASS);
+        viewerRoot.style.cursor = "";
+        isDragging = false;
+        updateSelectionVisual();
+    }
+    // =========================================================================
+    // Keyboard
+    // =========================================================================
+    function onKeyDown(e) {
+        if (e.key !== "Delete" && e.key !== "Backspace")
+            return;
+        const tag = e.target.tagName;
+        if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT")
+            return;
+        const sel = store.getState().selectedAnnotation;
+        if (!sel)
+            return;
+        store.dispatch({ type: "REMOVE_ANNOTATION", pageIndex: sel.pageIndex, annotationIndex: sel.annotationIndex });
+        e.preventDefault();
+    }
+    // =========================================================================
+    // Activate / deactivate
+    // =========================================================================
+    function activate() {
+        if (active)
+            return;
+        active = true;
+        viewerRoot.classList.add(SELECT_CURSOR_CLASS);
+        scrollArea.addEventListener("pointerdown", onPointerDown);
+        scrollArea.addEventListener("pointermove", onPointerMove);
+        scrollArea.addEventListener("pointerup", onPointerUp);
+        scrollArea.addEventListener("pointercancel", onPointerCancel);
+        document.addEventListener("keydown", onKeyDown);
+    }
+    function deactivate() {
+        if (!active)
+            return;
+        active = false;
+        viewerRoot.classList.remove(SELECT_CURSOR_CLASS);
+        viewerRoot.classList.remove(MOVING_CLASS);
+        viewerRoot.classList.remove(RESIZING_CLASS);
+        viewerRoot.style.cursor = "";
+        scrollArea.removeEventListener("pointerdown", onPointerDown);
+        scrollArea.removeEventListener("pointermove", onPointerMove);
+        scrollArea.removeEventListener("pointerup", onPointerUp);
+        scrollArea.removeEventListener("pointercancel", onPointerCancel);
+        document.removeEventListener("keydown", onKeyDown);
+        removeBbox();
+        isDragging = false;
+    }
+    function isSelectMode(s) {
+        return (s.documentFormat !== null &&
+            ANNOTATION_FORMATS.has(s.documentFormat) &&
+            isToolSet(s.activeTool) &&
+            s.activeSubTool === "select");
+    }
+    const unsub = store.subscribeRender((_prev, next) => {
+        if (isSelectMode(next)) {
+            activate();
+            if (!isDragging) {
+                updateSelectionVisual();
+            }
+        }
+        else {
+            deactivate();
+        }
+    });
+    if (isSelectMode(store.getState())) {
+        activate();
+    }
+    function destroy() {
+        unsub();
+        deactivate();
+    }
+    return { destroy };
+}
+//# sourceMappingURL=AnnotationSelectController.js.map

package/dist/src/ui/viewer/tools/AnnotationSelectController.js.map

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

package/dist/src/ui/viewer/tools/ViewToolController.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ViewToolController — handles pointer, hand (pan), and zoom tool interactions.
+ *
+ * Attaches to the viewport scroll area and manages cursor styles and
+ * mouse/pointer events based on the currently active tool.
+ */
+import type { Store } from "../../framework/store";
+import type { ViewerState } from "../state";
+import type { Action } from "../actions";
+export interface ViewToolControllerOptions {
+    /** The scroll container element (overflow: auto) */
+    scrollArea: HTMLElement;
+    /** The viewer root element (for applying cursor classes) */
+    viewerRoot: HTMLElement;
+    store: Store<ViewerState, Action>;
+}
+export declare function createViewToolController(options: ViewToolControllerOptions): {
+    destroy: () => void;
+};
+//# sourceMappingURL=ViewToolController.d.ts.map

package/dist/src/ui/viewer/tools/ViewToolController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewToolController.d.ts","sourceRoot":"","sources":["../../../../../src/ui/viewer/tools/ViewToolController.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,yBAAyB;IACtC,oDAAoD;IACpD,UAAU,EAAE,WAAW,CAAC;IACxB,4DAA4D;IAC5D,UAAU,EAAE,WAAW,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;CACrC;AAWD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB;mBAoMnD,IAAI;EAU3B"}

package/dist/src/ui/viewer/tools/ViewToolController.js

@@ -0,0 +1,194 @@
+/**
+ * ViewToolController — handles pointer, hand (pan), and zoom tool interactions.
+ *
+ * Attaches to the viewport scroll area and manages cursor styles and
+ * mouse/pointer events based on the currently active tool.
+ */
+/** CSS class applied to viewer root for each tool cursor */
+const CURSOR_CLASSES = {
+    pointer: "",
+    hand: "udoc-viewer--tool-hand",
+    zoom: "udoc-viewer--tool-zoom",
+};
+const HAND_GRABBING_CLASS = "udoc-viewer--tool-hand-grabbing";
+export function createViewToolController(options) {
+    const { scrollArea, viewerRoot, store } = options;
+    let currentTool = "pointer";
+    let cleanupFn = null;
+    // --- Hand tool (drag to pan) ---
+    function attachHandTool() {
+        let isDragging = false;
+        let startX = 0;
+        let startY = 0;
+        let startScrollLeft = 0;
+        let startScrollTop = 0;
+        const onPointerDown = (e) => {
+            // Only primary button
+            if (e.button !== 0)
+                return;
+            // Don't interfere with interactive elements
+            const target = e.target;
+            if (target.closest("a, button, input, [role=button]"))
+                return;
+            isDragging = true;
+            startX = e.clientX;
+            startY = e.clientY;
+            startScrollLeft = scrollArea.scrollLeft;
+            startScrollTop = scrollArea.scrollTop;
+            viewerRoot.classList.add(HAND_GRABBING_CLASS);
+            scrollArea.setPointerCapture(e.pointerId);
+            e.preventDefault();
+        };
+        const onPointerMove = (e) => {
+            if (!isDragging)
+                return;
+            const dx = e.clientX - startX;
+            const dy = e.clientY - startY;
+            scrollArea.scrollLeft = startScrollLeft - dx;
+            scrollArea.scrollTop = startScrollTop - dy;
+        };
+        const onPointerUp = (e) => {
+            if (!isDragging)
+                return;
+            isDragging = false;
+            viewerRoot.classList.remove(HAND_GRABBING_CLASS);
+            scrollArea.releasePointerCapture(e.pointerId);
+        };
+        scrollArea.addEventListener("pointerdown", onPointerDown);
+        scrollArea.addEventListener("pointermove", onPointerMove);
+        scrollArea.addEventListener("pointerup", onPointerUp);
+        scrollArea.addEventListener("pointercancel", onPointerUp);
+        return () => {
+            scrollArea.removeEventListener("pointerdown", onPointerDown);
+            scrollArea.removeEventListener("pointermove", onPointerMove);
+            scrollArea.removeEventListener("pointerup", onPointerUp);
+            scrollArea.removeEventListener("pointercancel", onPointerUp);
+            viewerRoot.classList.remove(HAND_GRABBING_CLASS);
+        };
+    }
+    // --- Zoom tool (click to zoom in, alt+click to zoom out) ---
+    function attachZoomTool() {
+        const ZOOM_OUT_CLASS = "udoc-viewer--tool-zoom-out";
+        const updateZoomCursor = (e) => {
+            const out = e.altKey || e.shiftKey;
+            viewerRoot.classList.toggle(ZOOM_OUT_CLASS, out);
+        };
+        const onKeyDown = (e) => updateZoomCursor(e);
+        const onKeyUp = (e) => updateZoomCursor(e);
+        document.addEventListener("keydown", onKeyDown);
+        document.addEventListener("keyup", onKeyUp);
+        const onClick = (e) => {
+            // Don't interfere with interactive elements
+            const target = e.target;
+            if (target.closest("a, button, input, [role=button]"))
+                return;
+            const rect = scrollArea.getBoundingClientRect();
+            // Viewport-relative click position (0-1 range)
+            const viewX = (e.clientX - rect.left) / rect.width;
+            const viewY = (e.clientY - rect.top) / rect.height;
+            // Scroll position before zoom
+            const prevScrollLeft = scrollArea.scrollLeft;
+            const prevScrollTop = scrollArea.scrollTop;
+            const prevScrollWidth = scrollArea.scrollWidth;
+            const prevScrollHeight = scrollArea.scrollHeight;
+            // Alt/Shift+click = zoom out, normal click = zoom in
+            if (e.altKey || e.shiftKey) {
+                store.dispatch({ type: "ZOOM_OUT" });
+            }
+            else {
+                store.dispatch({ type: "ZOOM_IN" });
+            }
+            // After zoom dispatched, schedule scroll adjustment to keep click point stable.
+            // We use requestAnimationFrame because the layout needs to update first.
+            requestAnimationFrame(() => {
+                const newScrollWidth = scrollArea.scrollWidth;
+                const newScrollHeight = scrollArea.scrollHeight;
+                if (prevScrollWidth === 0 || prevScrollHeight === 0)
+                    return;
+                const scaleX = newScrollWidth / prevScrollWidth;
+                const scaleY = newScrollHeight / prevScrollHeight;
+                // The point under the cursor in the old scroll space
+                const pointX = prevScrollLeft + viewX * rect.width;
+                const pointY = prevScrollTop + viewY * rect.height;
+                // Where that same point is in the new scroll space
+                const newPointX = pointX * scaleX;
+                const newPointY = pointY * scaleY;
+                // Adjust scroll so the point stays under the cursor
+                scrollArea.scrollLeft = newPointX - viewX * rect.width;
+                scrollArea.scrollTop = newPointY - viewY * rect.height;
+            });
+        };
+        scrollArea.addEventListener("click", onClick);
+        return () => {
+            scrollArea.removeEventListener("click", onClick);
+            document.removeEventListener("keydown", onKeyDown);
+            document.removeEventListener("keyup", onKeyUp);
+            viewerRoot.classList.remove(ZOOM_OUT_CLASS);
+        };
+    }
+    // --- Cursor and tool switching ---
+    function setCursorClass(tool) {
+        // Remove all tool cursor classes
+        for (const cls of Object.values(CURSOR_CLASSES)) {
+            if (cls)
+                viewerRoot.classList.remove(cls);
+        }
+        viewerRoot.classList.remove(HAND_GRABBING_CLASS);
+        // Add new one
+        const cls = CURSOR_CLASSES[tool];
+        if (cls)
+            viewerRoot.classList.add(cls);
+    }
+    function switchTool(tool) {
+        if (tool === currentTool)
+            return;
+        // Teardown previous tool
+        if (cleanupFn) {
+            cleanupFn();
+            cleanupFn = null;
+        }
+        currentTool = tool;
+        setCursorClass(tool);
+        // Setup new tool
+        switch (tool) {
+            case "hand":
+                cleanupFn = attachHandTool();
+                break;
+            case "zoom":
+                cleanupFn = attachZoomTool();
+                break;
+            // "pointer" — default behavior, no extra handlers needed
+        }
+    }
+    // Subscribe to tool state changes
+    let prevTool = store.getState().activeTool;
+    const unsub = store.subscribeRender((_prev, next) => {
+        const tool = next.activeTool;
+        if (tool !== prevTool) {
+            prevTool = tool;
+            // Only handle view tools; tool sets don't affect viewport interaction
+            if (tool === "pointer" || tool === "hand" || tool === "zoom") {
+                switchTool(tool);
+            }
+            else {
+                // For annotation/markup tool sets, revert to pointer behavior
+                switchTool("pointer");
+            }
+        }
+    });
+    // Apply initial state
+    const initial = store.getState().activeTool;
+    if (initial === "hand" || initial === "zoom") {
+        switchTool(initial);
+    }
+    function destroy() {
+        unsub();
+        if (cleanupFn) {
+            cleanupFn();
+            cleanupFn = null;
+        }
+        setCursorClass("pointer");
+    }
+    return { destroy };
+}
+//# sourceMappingURL=ViewToolController.js.map

package/dist/src/ui/viewer/tools/ViewToolController.js.map

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