@editframe/elements 0.30.2-beta.0 → 0.31.0-beta.1

package/dist/gui/EFTransformHandles.js

@@ -0,0 +1,393 @@
+import { __decorate } from "../_virtual/_@oxc-project_runtime@0.94.0/helpers/decorate.js";
+import { panZoomTransformContext } from "./panZoomTransformContext.js";
+import { getCornerPoint, getOppositeCorner } from "./transformUtils.js";
+import { calculateDragBounds, calculateResizeBounds, getResizeHandleCursor } from "./transformCalculations.js";
+import { consume } from "@lit/context";
+import { LitElement, css, html } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import { styleMap } from "lit/directives/style-map.js";
+
+//#region src/gui/EFTransformHandles.ts
+const DEFAULT_MIN_SIZE = 10;
+let EFTransformHandles = class EFTransformHandles$1 extends LitElement {
+	constructor(..._args) {
+		super(..._args);
+		this.bounds = {
+			x: 0,
+			y: 0,
+			width: 100,
+			height: 100
+		};
+		this.minSize = DEFAULT_MIN_SIZE;
+		this.canvasScale = 1;
+		this.enableRotation = false;
+		this.enableResize = true;
+		this.cornersOnly = false;
+		this.lockAspectRatio = false;
+		this.enableDrag = true;
+		this.interactionMode = "idle";
+		this.activeResizeHandle = null;
+		this.mouseStart = null;
+		this.initialBounds = null;
+		this.handleMouseDown = (e) => {
+			if (!this.enableDrag) return;
+			e.stopPropagation();
+			this.interactionMode = this.transitionInteractionMode("mousedown-drag");
+			this.mouseStart = {
+				x: e.clientX,
+				y: e.clientY
+			};
+			this.initialBounds = { ...this.bounds };
+			document.addEventListener("mousemove", this.handleMouseMove);
+			document.addEventListener("mouseup", this.handleMouseUp);
+		};
+		this.handleResizeMouseDown = (e, handle) => {
+			if (!this.enableResize) return;
+			e.stopPropagation();
+			e.preventDefault();
+			this.interactionMode = this.transitionInteractionMode("mousedown-resize");
+			this.activeResizeHandle = handle;
+			this.mouseStart = {
+				x: e.clientX,
+				y: e.clientY
+			};
+			this.initialBounds = { ...this.bounds };
+			document.addEventListener("mousemove", this.handleMouseMove);
+			document.addEventListener("mouseup", this.handleMouseUp);
+		};
+		this.handleRotateMouseDown = (e) => {
+			if (!this.enableRotation) return;
+			e.stopPropagation();
+			this.interactionMode = this.transitionInteractionMode("mousedown-rotate");
+			this.mouseStart = {
+				x: e.clientX,
+				y: e.clientY
+			};
+			this.initialBounds = { ...this.bounds };
+			document.addEventListener("mousemove", this.handleMouseMove);
+			document.addEventListener("mouseup", this.handleMouseUp);
+		};
+		this.handleMouseMove = (e) => {
+			if (!this.mouseStart || !this.initialBounds) return;
+			const screenDeltaX = e.clientX - this.mouseStart.x;
+			const screenDeltaY = e.clientY - this.mouseStart.y;
+			switch (this.interactionMode) {
+				case "dragging": {
+					const zoomScale = this.getZoomScale();
+					const initialCanvas = this.screenToCanvas(this.initialBounds);
+					const newPosition = calculateDragBounds({
+						x: initialCanvas.x,
+						y: initialCanvas.y
+					}, screenDeltaX, screenDeltaY, zoomScale);
+					this.dispatchBoundsChange({
+						...newPosition,
+						width: initialCanvas.width,
+						height: initialCanvas.height,
+						rotation: this.initialBounds.rotation
+					});
+					break;
+				}
+				case "resizing": {
+					if (!this.activeResizeHandle) return;
+					const zoomScale = this.getZoomScale();
+					const initialCanvas = this.screenToCanvas(this.initialBounds);
+					const rotation = this.enableRotation ? this.initialBounds.rotation ?? 0 : 0;
+					const oppositeCorner = getOppositeCorner(this.activeResizeHandle);
+					const rotationRadians = rotation * Math.PI / 180;
+					const fixedCorner = getCornerPoint(initialCanvas.x, initialCanvas.y, initialCanvas.width, initialCanvas.height, rotationRadians, oppositeCorner.x, oppositeCorner.y);
+					const newCanvasBounds = calculateResizeBounds({
+						width: initialCanvas.width,
+						height: initialCanvas.height
+					}, {
+						x: initialCanvas.x,
+						y: initialCanvas.y
+					}, fixedCorner, this.activeResizeHandle, screenDeltaX, screenDeltaY, rotation, this.minSize / zoomScale, zoomScale, {
+						lockAspectRatio: this.lockAspectRatio || e.shiftKey,
+						resizeFromCenter: e.ctrlKey || e.metaKey
+					});
+					newCanvasBounds.rotation = this.initialBounds.rotation;
+					this.dispatchBoundsChange(newCanvasBounds);
+					break;
+				}
+				case "rotating": {
+					const overlayRect = this.offsetParent?.getBoundingClientRect() ?? {
+						left: 0,
+						top: 0
+					};
+					const centerX = overlayRect.left + this.initialBounds.x + this.initialBounds.width / 2;
+					const centerY = overlayRect.top + this.initialBounds.y + this.initialBounds.height / 2;
+					const startAngle = Math.atan2(this.mouseStart.y - centerY, this.mouseStart.x - centerX) * (180 / Math.PI) + 90;
+					let deltaAngle = Math.atan2(e.clientY - centerY, e.clientX - centerX) * (180 / Math.PI) + 90 - startAngle;
+					while (deltaAngle > 180) deltaAngle -= 360;
+					while (deltaAngle < -180) deltaAngle += 360;
+					let newRotation = (this.initialBounds.rotation ?? 0) + deltaAngle;
+					if (this.rotationStep !== void 0 && this.rotationStep > 0) newRotation = Math.round(newRotation / this.rotationStep) * this.rotationStep;
+					this.dispatchEvent(new CustomEvent("rotation-change", {
+						detail: { rotation: newRotation },
+						bubbles: true,
+						composed: true
+					}));
+					break;
+				}
+				case "idle": break;
+			}
+		};
+		this.handleMouseUp = () => {
+			this.cleanup();
+		};
+	}
+	static {
+		this.styles = css`
+    :host {
+      display: block;
+      position: absolute;
+      pointer-events: none;
+    }
+    .overlay {
+      position: absolute;
+      border: 2px solid var(--ef-transform-handles-border-color, #3b82f6);
+      pointer-events: none;
+    }
+    .overlay.dragging {
+      border-color: var(--ef-transform-handles-dragging-border-color, #2563eb);
+    }
+    .drag-area {
+      position: absolute;
+      inset: 0;
+      cursor: move;
+      pointer-events: none;
+    }
+    /* Only enable pointer events when actively dragging */
+    .drag-area:active {
+      pointer-events: auto;
+    }
+    .handle {
+      position: absolute;
+      width: 8px;
+      height: 8px;
+      background: var(--ef-transform-handles-handle-color, white);
+      border: 1px solid var(--ef-transform-handles-handle-border-color, #3b82f6);
+      pointer-events: auto;
+      /* Only capture pointer events, allow wheel events to pass through */
+      touch-action: none;
+    }
+    .handle.nw { top: -4px; left: -4px; }
+    .handle.n { top: -4px; left: 50%; transform: translateX(-50%); }
+    .handle.ne { top: -4px; right: -4px; }
+    .handle.e { top: 50%; right: -4px; transform: translateY(-50%); }
+    .handle.se { bottom: -4px; right: -4px; }
+    .handle.s { bottom: -4px; left: 50%; transform: translateX(-50%); }
+    .handle.sw { bottom: -4px; left: -4px; }
+    .handle.w { top: 50%; left: -4px; transform: translateY(-50%); }
+    .rotate-handle {
+      position: absolute;
+      top: -30px;
+      left: 50%;
+      transform: translateX(-50%);
+      cursor: grab;
+      pointer-events: auto;
+      /* Only capture pointer events, allow wheel events to pass through */
+      touch-action: none;
+    }
+    .rotate-handle-circle {
+      width: 24px;
+      height: 24px;
+      background: var(--ef-transform-handles-rotate-handle-color, #10b981);
+      border: 2px solid white;
+      border-radius: 50%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .rotate-handle-circle span {
+      font-size: 12px;
+      color: white;
+    }
+  `;
+	}
+	/**
+	* Single source of truth for zoom scale.
+	* Priority: context > prop > 1.0
+	*/
+	getZoomScale() {
+		return this.panZoomTransformFromContext?.scale ?? this.canvasScale ?? 1;
+	}
+	/**
+	* Convert screen pixel bounds to canvas coordinates.
+	*/
+	screenToCanvas(bounds) {
+		const scale = this.getZoomScale();
+		return {
+			x: bounds.x / scale,
+			y: bounds.y / scale,
+			width: bounds.width / scale,
+			height: bounds.height / scale,
+			rotation: bounds.rotation
+		};
+	}
+	connectedCallback() {
+		super.connectedCallback();
+		this.resizeObserver = new ResizeObserver(() => {});
+		if (this.offsetParent) this.resizeObserver.observe(this.offsetParent);
+		this.addEventListener("wheel", (e) => {
+			if (this.interactionMode === "idle") {
+				const panZoom = this.closest("ef-pan-zoom");
+				if (panZoom) {
+					const wheelEvent = new WheelEvent("wheel", {
+						bubbles: true,
+						cancelable: true,
+						clientX: e.clientX,
+						clientY: e.clientY,
+						deltaX: e.deltaX,
+						deltaY: e.deltaY,
+						deltaZ: e.deltaZ,
+						deltaMode: e.deltaMode,
+						ctrlKey: e.ctrlKey,
+						metaKey: e.metaKey,
+						shiftKey: e.shiftKey,
+						altKey: e.altKey
+					});
+					panZoom.dispatchEvent(wheelEvent);
+				}
+			}
+		}, { passive: true });
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback();
+		this.resizeObserver?.disconnect();
+		this.cleanup();
+	}
+	/**
+	* Transition interaction mode state machine.
+	* Ensures only one mode is active at a time (invariant).
+	*/
+	transitionInteractionMode(event) {
+		if (event === "mouseup") return "idle";
+		if (this.interactionMode !== "idle") return this.interactionMode;
+		switch (event) {
+			case "mousedown-drag": return "dragging";
+			case "mousedown-resize": return "resizing";
+			case "mousedown-rotate": return "rotating";
+			default: return "idle";
+		}
+	}
+	/**
+	* Dispatch bounds change event (one-way data flow).
+	* Parent updates element, then reads element and updates handle bounds prop.
+	* We don't modify this.bounds directly - always render from prop.
+	*/
+	dispatchBoundsChange(bounds) {
+		this.dispatchEvent(new CustomEvent("bounds-change", {
+			detail: { bounds },
+			bubbles: true,
+			composed: true
+		}));
+	}
+	cleanup() {
+		this.interactionMode = this.transitionInteractionMode("mouseup");
+		this.activeResizeHandle = null;
+		this.mouseStart = null;
+		this.initialBounds = null;
+		document.removeEventListener("mousemove", this.handleMouseMove);
+		document.removeEventListener("mouseup", this.handleMouseUp);
+	}
+	render() {
+		const currentBounds = this.bounds;
+		const rotation = this.enableRotation ? currentBounds.rotation ?? 0 : 0;
+		const overlayStyles = {
+			left: `${currentBounds.x}px`,
+			top: `${currentBounds.y}px`,
+			width: `${currentBounds.width}px`,
+			height: `${currentBounds.height}px`
+		};
+		if (this.enableRotation && rotation !== 0) {
+			overlayStyles.transform = `rotate(${rotation}deg)`;
+			overlayStyles.transformOrigin = "center";
+		}
+		const handles = this.cornersOnly ? [
+			"nw",
+			"ne",
+			"se",
+			"sw"
+		] : [
+			"nw",
+			"n",
+			"ne",
+			"e",
+			"se",
+			"s",
+			"sw",
+			"w"
+		];
+		return html`
+      <div
+        class="overlay ${this.interactionMode === "dragging" ? "dragging" : ""}"
+        style=${styleMap(overlayStyles)}
+      >
+        ${this.enableDrag ? html`
+              <div
+                class="drag-area"
+                @mousedown=${this.handleMouseDown}
+              ></div>
+            ` : ""}
+        ${this.enableResize ? handles.map((handle) => {
+			return html`
+                <div
+                  class="handle ${handle}"
+                      style=${styleMap({ cursor: getResizeHandleCursor(handle, this.enableRotation ? currentBounds.rotation ?? 0 : 0) })}
+                  @mousedown=${(e) => this.handleResizeMouseDown(e, handle)}
+                ></div>
+                  `;
+		}) : ""}
+        ${this.enableRotation ? html`
+              <div class="rotate-handle" @mousedown=${this.handleRotateMouseDown}>
+                <div class="rotate-handle-circle">
+                  <span>↻</span>
+                </div>
+              </div>
+            ` : ""}
+      </div>
+    `;
+	}
+};
+__decorate([property({ type: Object })], EFTransformHandles.prototype, "bounds", void 0);
+__decorate([property({ type: Number })], EFTransformHandles.prototype, "minSize", void 0);
+__decorate([property({ type: String })], EFTransformHandles.prototype, "target", void 0);
+__decorate([consume({
+	context: panZoomTransformContext,
+	subscribe: true
+})], EFTransformHandles.prototype, "panZoomTransformFromContext", void 0);
+__decorate([property({
+	type: Number,
+	attribute: "canvas-scale"
+})], EFTransformHandles.prototype, "canvasScale", void 0);
+__decorate([property({
+	type: Boolean,
+	attribute: "enable-rotation"
+})], EFTransformHandles.prototype, "enableRotation", void 0);
+__decorate([property({
+	type: Boolean,
+	attribute: "enable-resize"
+})], EFTransformHandles.prototype, "enableResize", void 0);
+__decorate([property({
+	type: Boolean,
+	attribute: "corners-only"
+})], EFTransformHandles.prototype, "cornersOnly", void 0);
+__decorate([property({
+	type: Boolean,
+	attribute: "lock-aspect-ratio"
+})], EFTransformHandles.prototype, "lockAspectRatio", void 0);
+__decorate([property({
+	type: Boolean,
+	attribute: "enable-drag"
+})], EFTransformHandles.prototype, "enableDrag", void 0);
+__decorate([property({
+	type: Number,
+	attribute: "rotation-step"
+})], EFTransformHandles.prototype, "rotationStep", void 0);
+__decorate([state()], EFTransformHandles.prototype, "interactionMode", void 0);
+EFTransformHandles = __decorate([customElement("ef-transform-handles")], EFTransformHandles);
+
+//#endregion
+export { EFTransformHandles };
+//# sourceMappingURL=EFTransformHandles.js.map

package/dist/gui/EFTransformHandles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EFTransformHandles.js","names":["EFTransformHandles","overlayStyles: Record<string, string>"],"sources":["../../src/gui/EFTransformHandles.ts"],"sourcesContent":["import { consume } from \"@lit/context\";\nimport { css, html, LitElement } from \"lit\";\nimport { customElement, property, state } from \"lit/decorators.js\";\nimport { styleMap } from \"lit/directives/style-map.js\";\nimport { panZoomTransformContext } from \"./panZoomTransformContext.js\";\nimport type { PanZoomTransform } from \"../elements/EFPanZoom.js\";\nimport {\n  type ResizeHandle,\n  calculateDragBounds,\n  calculateResizeBounds,\n  getResizeHandleCursor,\n} from \"./transformCalculations.js\";\nimport { getCornerPoint, getOppositeCorner } from \"./transformUtils.js\";\n\nconst DEFAULT_MIN_SIZE = 10;\n\nexport interface TransformBounds {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  rotation?: number;\n}\n\n/**\n * Interaction mode enumeration.\n * Only one mode can be active at a time (invariant).\n */\ntype InteractionMode = \"idle\" | \"dragging\" | \"resizing\" | \"rotating\";\n\n@customElement(\"ef-transform-handles\")\nexport class EFTransformHandles extends LitElement {\n  @property({ type: Object })\n  bounds: TransformBounds = { x: 0, y: 0, width: 100, height: 100 };\n\n  @property({ type: Number })\n  minSize = DEFAULT_MIN_SIZE;\n\n  @property({ type: String })\n  target?: string;\n\n  @consume({ context: panZoomTransformContext, subscribe: true })\n  panZoomTransformFromContext?: PanZoomTransform;\n\n  @property({ type: Number, attribute: \"canvas-scale\" })\n  canvasScale = 1;\n\n  @property({ type: Boolean, attribute: \"enable-rotation\" })\n  enableRotation = false;\n\n  @property({ type: Boolean, attribute: \"enable-resize\" })\n  enableResize = true;\n\n  @property({ type: Boolean, attribute: \"corners-only\" })\n  cornersOnly = false;\n\n  @property({ type: Boolean, attribute: \"lock-aspect-ratio\" })\n  lockAspectRatio = false;\n\n  @property({ type: Boolean, attribute: \"enable-drag\" })\n  enableDrag = true;\n\n  @property({ type: Number, attribute: \"rotation-step\" })\n  rotationStep?: number;\n\n  /**\n   * Current interaction mode.\n   * Invariant: Only one mode active at a time.\n   */\n  @state()\n  interactionMode: InteractionMode = \"idle\";\n\n  /**\n   * Active resize handle when in \"resizing\" mode.\n   * Only valid when interactionMode === \"resizing\".\n   */\n  private activeResizeHandle: ResizeHandle | null = null;\n\n  /**\n   * Mouse start position for calculating deltas.\n   * Only valid during active interaction.\n   */\n  private mouseStart: { x: number; y: number } | null = null;\n\n  /**\n   * Initial bounds at interaction start - NEVER mutated during interaction.\n   * All calculations derive from this + mouse deltas.\n   * Note: Not a @state() property to avoid re-renders during interaction.\n   */\n  private initialBounds: TransformBounds | null = null;\n\n  static styles = css`\n    :host {\n      display: block;\n      position: absolute;\n      pointer-events: none;\n    }\n    .overlay {\n      position: absolute;\n      border: 2px solid var(--ef-transform-handles-border-color, #3b82f6);\n      pointer-events: none;\n    }\n    .overlay.dragging {\n      border-color: var(--ef-transform-handles-dragging-border-color, #2563eb);\n    }\n    .drag-area {\n      position: absolute;\n      inset: 0;\n      cursor: move;\n      pointer-events: none;\n    }\n    /* Only enable pointer events when actively dragging */\n    .drag-area:active {\n      pointer-events: auto;\n    }\n    .handle {\n      position: absolute;\n      width: 8px;\n      height: 8px;\n      background: var(--ef-transform-handles-handle-color, white);\n      border: 1px solid var(--ef-transform-handles-handle-border-color, #3b82f6);\n      pointer-events: auto;\n      /* Only capture pointer events, allow wheel events to pass through */\n      touch-action: none;\n    }\n    .handle.nw { top: -4px; left: -4px; }\n    .handle.n { top: -4px; left: 50%; transform: translateX(-50%); }\n    .handle.ne { top: -4px; right: -4px; }\n    .handle.e { top: 50%; right: -4px; transform: translateY(-50%); }\n    .handle.se { bottom: -4px; right: -4px; }\n    .handle.s { bottom: -4px; left: 50%; transform: translateX(-50%); }\n    .handle.sw { bottom: -4px; left: -4px; }\n    .handle.w { top: 50%; left: -4px; transform: translateY(-50%); }\n    .rotate-handle {\n      position: absolute;\n      top: -30px;\n      left: 50%;\n      transform: translateX(-50%);\n      cursor: grab;\n      pointer-events: auto;\n      /* Only capture pointer events, allow wheel events to pass through */\n      touch-action: none;\n    }\n    .rotate-handle-circle {\n      width: 24px;\n      height: 24px;\n      background: var(--ef-transform-handles-rotate-handle-color, #10b981);\n      border: 2px solid white;\n      border-radius: 50%;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n    }\n    .rotate-handle-circle span {\n      font-size: 12px;\n      color: white;\n    }\n  `;\n\n  private resizeObserver?: ResizeObserver;\n\n  /**\n   * Single source of truth for zoom scale.\n   * Priority: context > prop > 1.0\n   */\n  private getZoomScale(): number {\n    return this.panZoomTransformFromContext?.scale ?? this.canvasScale ?? 1;\n  }\n\n  /**\n   * Convert screen pixel bounds to canvas coordinates.\n   */\n  private screenToCanvas(bounds: TransformBounds): TransformBounds {\n    const scale = this.getZoomScale();\n    return {\n      x: bounds.x / scale,\n      y: bounds.y / scale,\n      width: bounds.width / scale,\n      height: bounds.height / scale,\n      rotation: bounds.rotation,\n    };\n  }\n\n  connectedCallback() {\n    super.connectedCallback();\n    this.resizeObserver = new ResizeObserver(() => {\n      // Dimensions are read directly when needed\n    });\n    if (this.offsetParent) {\n      this.resizeObserver.observe(this.offsetParent);\n    }\n    // Forward wheel events to parent panzoom so zoom works even when pointer is over handles\n    // Wheel events should pass through, but we'll forward them to ensure panzoom receives them\n    this.addEventListener(\n      \"wheel\",\n      (e: WheelEvent) => {\n        // Only forward if not actively interacting with handles\n        if (this.interactionMode === \"idle\") {\n          // Find parent panzoom and forward the event\n          const panZoom = this.closest(\"ef-pan-zoom\");\n          if (panZoom) {\n            // Create a new wheel event and dispatch it on panzoom\n            const wheelEvent = new WheelEvent(\"wheel\", {\n              bubbles: true,\n              cancelable: true,\n              clientX: e.clientX,\n              clientY: e.clientY,\n              deltaX: e.deltaX,\n              deltaY: e.deltaY,\n              deltaZ: e.deltaZ,\n              deltaMode: e.deltaMode,\n              ctrlKey: e.ctrlKey,\n              metaKey: e.metaKey,\n              shiftKey: e.shiftKey,\n              altKey: e.altKey,\n            });\n            panZoom.dispatchEvent(wheelEvent);\n          }\n        }\n      },\n      { passive: true },\n    );\n  }\n\n  disconnectedCallback() {\n    super.disconnectedCallback();\n    this.resizeObserver?.disconnect();\n    this.cleanup();\n  }\n\n  /**\n   * Transition interaction mode state machine.\n   * Ensures only one mode is active at a time (invariant).\n   */\n  private transitionInteractionMode(\n    event:\n      | \"mousedown-drag\"\n      | \"mousedown-resize\"\n      | \"mousedown-rotate\"\n      | \"mouseup\",\n  ): InteractionMode {\n    if (event === \"mouseup\") {\n      return \"idle\";\n    }\n    // Only allow transition from idle\n    if (this.interactionMode !== \"idle\") {\n      return this.interactionMode;\n    }\n    switch (event) {\n      case \"mousedown-drag\":\n        return \"dragging\";\n      case \"mousedown-resize\":\n        return \"resizing\";\n      case \"mousedown-rotate\":\n        return \"rotating\";\n      default:\n        return \"idle\";\n    }\n  }\n\n  private handleMouseDown = (e: MouseEvent) => {\n    if (!this.enableDrag) return;\n    e.stopPropagation();\n    this.interactionMode = this.transitionInteractionMode(\"mousedown-drag\");\n    this.mouseStart = { x: e.clientX, y: e.clientY };\n    this.initialBounds = { ...this.bounds };\n    document.addEventListener(\"mousemove\", this.handleMouseMove);\n    document.addEventListener(\"mouseup\", this.handleMouseUp);\n  };\n\n  private handleResizeMouseDown = (e: MouseEvent, handle: ResizeHandle) => {\n    if (!this.enableResize) return;\n    e.stopPropagation();\n    e.preventDefault();\n    this.interactionMode = this.transitionInteractionMode(\"mousedown-resize\");\n    this.activeResizeHandle = handle;\n    this.mouseStart = { x: e.clientX, y: e.clientY };\n    // Store initial bounds as-is (in screen pixels) - we'll convert to canvas when calculating\n    this.initialBounds = { ...this.bounds };\n    document.addEventListener(\"mousemove\", this.handleMouseMove);\n    document.addEventListener(\"mouseup\", this.handleMouseUp);\n  };\n\n  private handleRotateMouseDown = (e: MouseEvent) => {\n    if (!this.enableRotation) return;\n    e.stopPropagation();\n    this.interactionMode = this.transitionInteractionMode(\"mousedown-rotate\");\n    this.mouseStart = { x: e.clientX, y: e.clientY };\n    this.initialBounds = { ...this.bounds };\n    document.addEventListener(\"mousemove\", this.handleMouseMove);\n    document.addEventListener(\"mouseup\", this.handleMouseUp);\n  };\n\n  /**\n   * Dispatch bounds change event (one-way data flow).\n   * Parent updates element, then reads element and updates handle bounds prop.\n   * We don't modify this.bounds directly - always render from prop.\n   */\n  private dispatchBoundsChange(bounds: TransformBounds): void {\n    this.dispatchEvent(\n      new CustomEvent(\"bounds-change\", {\n        detail: { bounds },\n        bubbles: true,\n        composed: true,\n      }),\n    );\n  }\n\n  private handleMouseMove = (e: MouseEvent) => {\n    if (!this.mouseStart || !this.initialBounds) return;\n\n    // Calculate mouse deltas in viewport coordinates\n    const screenDeltaX = e.clientX - this.mouseStart.x;\n    const screenDeltaY = e.clientY - this.mouseStart.y;\n\n    switch (this.interactionMode) {\n      case \"dragging\": {\n        const zoomScale = this.getZoomScale();\n        const initialCanvas = this.screenToCanvas(this.initialBounds);\n\n        const newPosition = calculateDragBounds(\n          { x: initialCanvas.x, y: initialCanvas.y },\n          screenDeltaX,\n          screenDeltaY,\n          zoomScale,\n        );\n\n        this.dispatchBoundsChange({\n          ...newPosition,\n          width: initialCanvas.width,\n          height: initialCanvas.height,\n          rotation: this.initialBounds.rotation,\n        });\n        break;\n      }\n\n      case \"resizing\": {\n        if (!this.activeResizeHandle) return;\n\n        const zoomScale = this.getZoomScale();\n        const initialCanvas = this.screenToCanvas(this.initialBounds);\n        const rotation = this.enableRotation\n          ? (this.initialBounds.rotation ?? 0)\n          : 0;\n\n        // Calculate the fixed corner (opposite to handle being dragged)\n        const oppositeCorner = getOppositeCorner(this.activeResizeHandle);\n        const rotationRadians = (rotation * Math.PI) / 180;\n        const fixedCorner = getCornerPoint(\n          initialCanvas.x,\n          initialCanvas.y,\n          initialCanvas.width,\n          initialCanvas.height,\n          rotationRadians,\n          oppositeCorner.x,\n          oppositeCorner.y,\n        );\n\n        const newCanvasBounds = calculateResizeBounds(\n          { width: initialCanvas.width, height: initialCanvas.height },\n          { x: initialCanvas.x, y: initialCanvas.y },\n          fixedCorner,\n          this.activeResizeHandle,\n          screenDeltaX,\n          screenDeltaY,\n          rotation,\n          this.minSize / zoomScale,\n          zoomScale,\n          {\n            lockAspectRatio: this.lockAspectRatio || e.shiftKey,\n            resizeFromCenter: e.ctrlKey || e.metaKey,\n          },\n        );\n\n        // Preserve rotation\n        newCanvasBounds.rotation = this.initialBounds.rotation;\n        this.dispatchBoundsChange(newCanvasBounds);\n        break;\n      }\n\n      case \"rotating\": {\n        // Calculate center in screen coordinates (bounds are overlay-relative)\n        const overlayRect = this.offsetParent?.getBoundingClientRect() ?? {\n          left: 0,\n          top: 0,\n        };\n        const centerX =\n          overlayRect.left +\n          this.initialBounds.x +\n          this.initialBounds.width / 2;\n        const centerY =\n          overlayRect.top +\n          this.initialBounds.y +\n          this.initialBounds.height / 2;\n\n        // Calculate angle from mouse start to current position\n        const startAngle =\n          Math.atan2(this.mouseStart.y - centerY, this.mouseStart.x - centerX) *\n            (180 / Math.PI) +\n          90;\n        const currentAngle =\n          Math.atan2(e.clientY - centerY, e.clientX - centerX) *\n            (180 / Math.PI) +\n          90;\n\n        // Normalize angle difference to [-180, 180] to avoid wrapping issues\n        let deltaAngle = currentAngle - startAngle;\n        while (deltaAngle > 180) deltaAngle -= 360;\n        while (deltaAngle < -180) deltaAngle += 360;\n\n        let newRotation = (this.initialBounds.rotation ?? 0) + deltaAngle;\n        if (this.rotationStep !== undefined && this.rotationStep > 0) {\n          newRotation =\n            Math.round(newRotation / this.rotationStep) * this.rotationStep;\n        }\n\n        this.dispatchEvent(\n          new CustomEvent(\"rotation-change\", {\n            detail: { rotation: newRotation },\n            bubbles: true,\n            composed: true,\n          }),\n        );\n        break;\n      }\n\n      case \"idle\":\n        // No action needed\n        break;\n    }\n  };\n\n  private handleMouseUp = () => {\n    this.cleanup();\n  };\n\n  private cleanup() {\n    this.interactionMode = this.transitionInteractionMode(\"mouseup\");\n    this.activeResizeHandle = null;\n    this.mouseStart = null;\n    this.initialBounds = null;\n    document.removeEventListener(\"mousemove\", this.handleMouseMove);\n    document.removeEventListener(\"mouseup\", this.handleMouseUp);\n  }\n\n  render() {\n    // Always render from bounds prop (one-way data flow)\n    // During interaction: dispatch events, parent updates element, parent updates handle bounds prop\n    const currentBounds = this.bounds;\n    const rotation = this.enableRotation ? (currentBounds.rotation ?? 0) : 0;\n\n    const overlayStyles: Record<string, string> = {\n      left: `${currentBounds.x}px`,\n      top: `${currentBounds.y}px`,\n      width: `${currentBounds.width}px`,\n      height: `${currentBounds.height}px`,\n    };\n\n    if (this.enableRotation && rotation !== 0) {\n      overlayStyles.transform = `rotate(${rotation}deg)`;\n      overlayStyles.transformOrigin = \"center\";\n    }\n\n    const allHandles: ResizeHandle[] = [\n      \"nw\",\n      \"n\",\n      \"ne\",\n      \"e\",\n      \"se\",\n      \"s\",\n      \"sw\",\n      \"w\",\n    ];\n    const cornerHandles: ResizeHandle[] = [\"nw\", \"ne\", \"se\", \"sw\"];\n    const handles = this.cornersOnly ? cornerHandles : allHandles;\n\n    return html`\n      <div\n        class=\"overlay ${this.interactionMode === \"dragging\" ? \"dragging\" : \"\"}\"\n        style=${styleMap(overlayStyles)}\n      >\n        ${\n          this.enableDrag\n            ? html`\n              <div\n                class=\"drag-area\"\n                @mousedown=${this.handleMouseDown}\n              ></div>\n            `\n            : \"\"\n        }\n        ${\n          this.enableResize\n            ? handles.map((handle) => {\n                const rotation = this.enableRotation\n                  ? (currentBounds.rotation ?? 0)\n                  : 0;\n                const cursor = getResizeHandleCursor(handle, rotation);\n                return html`\n                <div\n                  class=\"handle ${handle}\"\n                      style=${styleMap({ cursor })}\n                  @mousedown=${(e: MouseEvent) => this.handleResizeMouseDown(e, handle)}\n                ></div>\n                  `;\n              })\n            : \"\"\n        }\n        ${\n          this.enableRotation\n            ? html`\n              <div class=\"rotate-handle\" @mousedown=${this.handleRotateMouseDown}>\n                <div class=\"rotate-handle-circle\">\n                  <span>↻</span>\n                </div>\n              </div>\n            `\n            : \"\"\n        }\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"ef-transform-handles\": EFTransformHandles;\n  }\n}\n"],"mappings":"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"}

package/dist/gui/EFWorkbench.d.ts

@@ -1,4 +1,5 @@
 import { ContextMixinInterface } from "./ContextMixin.js";
+import { RenderToVideoOptions } from "../preview/renderTimegroupToVideo.js";
 import * as lit11 from "lit";
 import { LitElement, PropertyValueMap } from "lit";
 import * as lit_html11 from "lit-html";
@@ -9,12 +10,189 @@ declare const EFWorkbench_base: (new (...args: any[]) => ContextMixinInterface)
 declare class EFWorkbench extends EFWorkbench_base {
   static styles: lit11.CSSResult[];
   rendering: boolean;
+  private panZoomTransform;
+  private isExporting;
+  private exportProgress;
+  private exportStatus;
+  private previewSettings;
+  private renderMode;
+  private presentationMode;
+  private previewResolutionScale;
+  private debugThumbnailTimestamps;
+  private thumbnailCacheMaxSize;
+  private thumbnailCacheStats;
+  private cacheStatsUpdateInterval;
+  private exportOptions;
+  private exportAbortController;
+  private isPlaying;
+  private isScrubbing;
+  private isAtRest;
+  /**
+   * Current adaptive resolution scale (only used when previewResolutionScale === "auto")
+   */
+  private currentAdaptiveScale;
+  /**
+   * Playback stats for display (FPS, dropped frames, etc.)
+   * Mirrors previewSettings.showStats for direct access
+   */
+  private showStats;
+  private statsStrategy;
+  /**
+   * Reference for tracking scrubbing state from EFScrubber.
+   * Pass this to <ef-scrubber isScrubbingRef={...}> to enable motion detection.
+   */
+  readonly isScrubbingRef: {
+    current: boolean;
+  };
+  private restDebounceTimer;
+  private playingCheckInterval;
+  private adaptiveTracker;
+  private savePanZoomDebounceTimer;
+  private cloneOverlayRef;
+  private cloneRefresh;
+  private cloneAnimationFrame;
+  private cloneRootElement;
+  private cloneTimegroup;
+  private structureObserver;
+  private rebuildPending;
+  private canvasRefresh;
+  private canvasPreviewRef;
+  private canvasPreviewResult;
+  private canvasAnimationFrame;
+  private boundHandleTransformChanged;
   focusOverlay: lit_html_directives_ref_js2.Ref<HTMLDivElement>;
   handleStageWheel(event: WheelEvent): void;
   connectedCallback(): void;
   disconnectedCallback(): void;
+  protected firstUpdated(): void;
+  private lastCanvasZoom;
+  private zoomReinitTimeout;
+  private handleTransformChanged;
+  private getTimegroup;
+  /**
+   * Get the root timegroup ID for localStorage key generation.
+   * Returns null if no root timegroup is found or it has no ID.
+   */
+  private getRootTimegroupId;
+  /**
+   * Get localStorage key for preview pan/zoom state.
+   */
+  private getPreviewPanZoomStorageKey;
+  /**
+   * Save preview pan/zoom to localStorage.
+   */
+  private savePreviewPanZoom;
+  /**
+   * Restore preview pan/zoom from localStorage.
+   */
+  private restorePreviewPanZoom;
+  /**
+   * Debounced save of preview pan/zoom to avoid excessive localStorage writes.
+   */
+  private debouncedSavePreviewPanZoom;
+  /**
+   * Start polling for motion state (playing/scrubbing).
+   * We use polling because:
+   * - Playing state comes from timegroup's playbackController
+   * - Scrubbing state comes from isScrubbingRef (set by EFScrubber)
+   */
+  private startMotionStateTracking;
+  private stopMotionStateTracking;
+  /**
+   * Update motion state by checking timegroup and scrubbing ref.
+   */
+  private updateMotionState;
+  /**
+   * Called when motion starts (playing or scrubbing began).
+   */
+  private handleMotionStart;
+  /**
+   * Called when motion stops (not playing and not scrubbing).
+   * Starts a debounce timer before transitioning to rest state.
+   */
+  private handleMotionStop;
+  /**
+   * Called after debounce period when we're confirmed to be at rest.
+   */
+  private transitionToRest;
+  /**
+   * Get the effective resolution scale based on current mode and motion state.
+   * For "auto" mode, returns full resolution at rest, adaptive scale in motion.
+   */
+  private getEffectiveResolutionScale;
+  /**
+   * Apply settings when dependencies are ready.
+   * Called from updated() hook when settings change or dependencies become available.
+   */
+  private applySettings;
+  /**
+   * Update or create stats tracking strategy based on current mode and settings.
+   */
+  private updateStatsStrategy;
+  private initCloneOverlay;
+  private finishCloneSetup;
+  private rebuildClone;
+  private setupStructureObserver;
+  private observeShadowRoots;
+  private updateCloneTransform;
+  private startCloneLoop;
+  private stopCloneOverlay;
+  private handlePresentationModeChange;
+  private initDomMode;
+  private stopDomMode;
+  /**
+   * Get the resolution scale for canvas rendering (for fixed scale modes).
+   *
+   * Logic:
+   * - Get actual displayed size from getBoundingClientRect()
+   * - For "Full": render at displayed size (1:1 pixel mapping)
+   * - For other settings: render at that % of displayed size
+   * - Never exceed composition size (100%)
+   *
+   * Note: For "auto" mode, use getEffectiveResolutionScale() instead.
+   */
+  private getResolutionScale;
+  private initCanvasMode;
+  private stopCanvasMode;
+  private updateCanvasTransform;
+  initCanvasRenderer(): {
+    canvas: HTMLCanvasElement;
+    refresh: () => Promise<void>;
+  } | null;
+  /** Start video export with progress tracking */
+  startExport(options?: RenderToVideoOptions): Promise<void>;
+  /** Cancel the current export */
+  cancelExport(): void;
+  private positionPopover;
+  private handleSettingsPopoverToggle;
+  private handleExportPopoverToggle;
+  private handleStartExport;
+  private updateExportOption;
+  private formatTime;
+  private handleCancelClick;
+  private handleRenderModeChange;
+  private handleResolutionScaleChange;
+  private updateThumbnailCacheStats;
+  private startCacheStatsUpdates;
+  private stopCacheStatsUpdates;
+  private handleThumbnailCacheMaxSizeChange;
+  private handleClearThumbnailCache;
+  private formatBytes;
+  private handleDebugThumbnailTimestampsToggle;
+  private handleShowStatsToggle;
+  /**
+   * Reset and fit the preview to show all content centered.
+   * Finds the pan-zoom element and calls fitToContent() on it.
+   */
+  private handleFitToContent;
+  private renderSettingsPopover;
+  private renderExportPopover;
+  private renderExportProgressPopover;
+  private renderToolbar;
   update(changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
+  updated(changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
   drawOverlays: () => void;
+  private renderPlaybackStats;
   render(): lit_html11.TemplateResult<1>;
 }
 declare global {