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

package/dist/canvas/overlays/SelectionOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionOverlay.js","names":["SelectionOverlay","panZoom","current: Node | null","canvasWithMetadata: CanvasWithMetadata"],"sources":["../../../src/canvas/overlays/SelectionOverlay.ts"],"sourcesContent":["import { consume } from \"@lit/context\";\nimport { css, html, LitElement } from \"lit\";\nimport { customElement, property, state } from \"lit/decorators.js\";\nimport {\n  selectionContext,\n  type SelectionContext,\n} from \"../selection/selectionContext.js\";\nimport { panZoomTransformContext } from \"../../gui/panZoomTransformContext.js\";\nimport type { PanZoomTransform } from \"../../elements/EFPanZoom.js\";\nimport {\n  type OverlayState,\n  type CanvasWithMetadata,\n  getOverlayTargets,\n  calculateOverlayState,\n} from \"./overlayState.js\";\n\n/**\n * Selection overlay that renders unscaled selection indicators.\n * Uses fixed positioning to ensure 1:1 pixel ratio regardless of zoom level.\n */\n@customElement(\"ef-canvas-selection-overlay\")\nexport class SelectionOverlay extends LitElement {\n  static styles = [\n    css`\n      :host {\n        position: fixed;\n        top: 0;\n        left: 0;\n        width: 100vw;\n        height: 100vh;\n        pointer-events: none;\n        z-index: 1000;\n      }\n      .box-select {\n        position: absolute;\n        border: 2px dashed rgb(59, 130, 246);\n        background: rgba(59, 130, 246, 0.05);\n        pointer-events: none;\n      }\n      .highlight-box {\n        position: absolute;\n        border: 2px solid rgb(148, 163, 184);\n        background: rgba(148, 163, 184, 0.1);\n        pointer-events: none;\n        box-shadow: 0 0 0 2px rgba(148, 163, 184, 0.3);\n      }\n    `,\n  ];\n\n  createRenderRoot() {\n    // Return this to render directly to the element (no shadow DOM)\n    // This allows the overlay to use fixed positioning relative to viewport\n    // Lit will inject styles as a <style> element when createRenderRoot returns this\n    return this;\n  }\n\n  firstUpdated(\n    changedProperties: Map<string | number | symbol, unknown>,\n  ): void {\n    super.firstUpdated?.(changedProperties);\n    // When createRenderRoot returns this, Lit injects styles as a <style> element\n    // Verify styles are present and log for debugging\n    // Only check/warn if we're not in a test environment where styles might not be injected\n    const styleElement = this.querySelector(\"style\");\n    if (!styleElement) {\n      // Only warn if we're in a context where styles are expected (not in isolated test scenarios)\n      // Check if we're in a sandbox/test container by looking for common test container attributes\n      const isInTestContainer = this.closest(\"[data-test-container]\") !== null ||\n        this.closest(\"#sandbox-container\") !== null ||\n        window.location.pathname.includes(\"scenario-runner\");\n      \n      if (!isInTestContainer) {\n        console.warn(\n          \"[SelectionOverlay] No style element found - styles may not be applied\",\n        );\n      }\n    } else {\n      console.log(\n        \"[SelectionOverlay] Style element found, content length:\",\n        styleElement.textContent?.length || 0,\n      );\n    }\n  }\n\n  @consume({ context: selectionContext, subscribe: true })\n  selectionFromContext?: SelectionContext;\n\n  @consume({ context: panZoomTransformContext, subscribe: true })\n  panZoomTransformFromContext?: PanZoomTransform;\n\n  /**\n   * Selection context as fallback for when overlay is outside context providers (e.g., sibling of pan-zoom).\n   */\n  @property({ type: Object })\n  selection?: SelectionContext;\n\n  /**\n   * Pan/zoom transform as fallback for when overlay is outside context providers (e.g., sibling of pan-zoom).\n   */\n  @property({ type: Object })\n  panZoomTransform?: PanZoomTransform;\n\n  @state()\n  private canvasElement: HTMLElement | null = null;\n\n  /**\n   * Canvas element property - can be set directly when overlay is outside context providers.\n   */\n  @property({ type: Object })\n  canvas?: HTMLElement;\n\n  /**\n   * Complete overlay state - calculated from targets using the abstraction layer.\n   * This is the SINGLE source of truth for overlay bounds.\n   */\n  @state()\n  private overlayState: OverlayState = {\n    selection: null,\n    boxSelect: null,\n    highlight: null,\n  };\n\n  @state()\n  private lastSelectionMode: string | null = null;\n\n  private animationFrame?: number;\n  private rafLoopActive = false;\n\n  connectedCallback(): void {\n    super.connectedCallback();\n    // Apply styles directly since :host doesn't work in light DOM\n    // These styles are critical for proper positioning relative to viewport\n    this.style.position = \"fixed\";\n    this.style.top = \"0\";\n    this.style.left = \"0\";\n    this.style.width = \"100vw\";\n    this.style.height = \"100vh\";\n    this.style.pointerEvents = \"none\";\n    this.style.zIndex = \"1000\";\n    // Add a data attribute for easier debugging\n    this.setAttribute(\"data-selection-overlay\", \"true\");\n    // Use requestAnimationFrame to ensure DOM is ready\n    requestAnimationFrame(() => {\n      // Use canvas property if provided, otherwise try to find it\n      if (this.canvas) {\n        this.canvasElement = this.canvas;\n      } else {\n        this.findCanvasElement();\n      }\n      // Always start RAF loop if we have a canvas element (needed for highlight updates)\n      if (this.canvasElement) {\n        this.startRafLoop();\n      }\n    });\n  }\n\n  disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this.stopRafLoop();\n  }\n\n  /**\n   * React to selection context changes to ensure box selection visual updates.\n   * This is called whenever Lit detects a property change, including context updates.\n   * Note: We don't call requestUpdate() here to avoid the Lit warning about scheduling\n   * updates after an update completes. The RAF loop handles all updates.\n   */\n  updated(changedProperties: Map<string | number | symbol, unknown>): void {\n    super.updated?.(changedProperties);\n    // Check if selection mode changed (context updates might not show in changedProperties)\n    const selection = this.effectiveSelection;\n    const currentMode = selection?.selectionMode ?? null;\n    if (currentMode !== this.lastSelectionMode) {\n      this.lastSelectionMode = currentMode;\n      // Don't call updateOverlayData() here - let the RAF loop handle it\n      // This avoids scheduling updates during the update cycle\n    }\n    // Ensure RAF loop is running when box selecting (in case it stopped)\n    if (currentMode === \"box-selecting\" && !this.rafLoopActive) {\n      this.startRafLoop();\n    }\n    // Ensure RAF loop is running when canvas property is set (for highlight updates)\n    if (changedProperties.has(\"canvas\") && this.canvas) {\n      this.canvasElement = this.canvas;\n      if (!this.rafLoopActive) {\n        this.startRafLoop();\n      }\n    }\n    // Ensure RAF loop is always running when we have a canvas (needed for highlight updates)\n    if (this.canvasElement && !this.rafLoopActive) {\n      this.startRafLoop();\n    }\n  }\n\n  /**\n   * Find the EFCanvas element.\n   * Handles both cases:\n   * 1. Overlay is inside EFCanvas's shadow DOM (old case)\n   * 2. Overlay is a sibling of ef-pan-zoom (new case - outside transform)\n   */\n  private findCanvasElement(): void {\n    // First, try to find ef-canvas as a sibling or descendant of ef-pan-zoom\n    // (when overlay is outside the transform)\n    // Since overlay is a sibling of ef-pan-zoom, we need to search in the parent\n    const parent = this.parentElement;\n    if (parent) {\n      // Look for ef-pan-zoom sibling\n      const panZoom = parent.querySelector(\"ef-pan-zoom\") as HTMLElement | null;\n      if (panZoom) {\n        // Look for ef-canvas inside ef-pan-zoom\n        const canvas = panZoom.querySelector(\"ef-canvas\") as HTMLElement | null;\n        if (canvas) {\n          this.canvasElement = canvas;\n          return;\n        }\n      }\n    }\n\n    // Also try closest in case overlay is inside pan-zoom somehow\n    const panZoom = this.closest(\"ef-pan-zoom\") as HTMLElement | null;\n    if (panZoom) {\n      const canvas = panZoom.querySelector(\"ef-canvas\") as HTMLElement | null;\n      if (canvas) {\n        this.canvasElement = canvas;\n        return;\n      }\n    }\n\n    // Fallback: traverse up the DOM tree (for when overlay is inside canvas shadow DOM)\n    let current: Node | null = this;\n    while (current) {\n      if (current instanceof ShadowRoot) {\n        current = (current as ShadowRoot).host;\n      } else if (current instanceof HTMLElement) {\n        // Check if this is the EFCanvas element (case-insensitive check)\n        if (\n          current.tagName === \"EF-CANVAS\" ||\n          current.tagName.toLowerCase() === \"ef-canvas\"\n        ) {\n          this.canvasElement = current;\n          return;\n        }\n        // Check parent element or shadow root host\n        const rootNode = current.getRootNode();\n        if (rootNode instanceof ShadowRoot) {\n          current = rootNode.host;\n        } else {\n          current = current.parentElement;\n        }\n      } else {\n        const rootNode = (current as Node).getRootNode();\n        if (rootNode instanceof ShadowRoot) {\n          current = rootNode.host;\n        } else {\n          current = (current as Node).parentElement;\n        }\n      }\n    }\n  }\n\n  /**\n   * Start continuous RAF loop for smooth overlay updates.\n   */\n  private startRafLoop(): void {\n    if (this.rafLoopActive) {\n      return;\n    }\n    this.rafLoopActive = true;\n    this.rafLoop();\n  }\n\n  /**\n   * Stop RAF loop.\n   */\n  private stopRafLoop(): void {\n    this.rafLoopActive = false;\n    if (this.animationFrame) {\n      cancelAnimationFrame(this.animationFrame);\n      this.animationFrame = undefined;\n    }\n  }\n\n  /**\n   * Continuous RAF loop to update overlays every frame using Lit render cycle.\n   */\n  private rafLoop = (): void => {\n    if (!this.rafLoopActive) {\n      return;\n    }\n\n    // Update overlay data and trigger Lit render\n    this.updateOverlayData();\n\n    // Schedule next frame\n    this.animationFrame = requestAnimationFrame(this.rafLoop);\n  };\n\n  /**\n   * Get the effective selection context (from context or property).\n   */\n  private get effectiveSelection(): SelectionContext | undefined {\n    return this.selectionFromContext ?? this.selection;\n  }\n\n  /**\n   * Get the effective pan-zoom transform (from context or property).\n   */\n  private get effectivePanZoomTransform(): PanZoomTransform | undefined {\n    return this.panZoomTransformFromContext ?? this.panZoomTransform;\n  }\n\n  /**\n   * Update overlay data state using the abstraction layer.\n   * \n   * This method now uses the clean separation of:\n   * - SEMANTICS: getOverlayTargets() determines WHAT should be shown\n   * - MECHANISM: calculateOverlayState() determines HOW to show it\n   */\n  private updateOverlayData(): void {\n    // Ensure canvas element reference is up-to-date\n    if (this.canvas && this.canvas !== this.canvasElement) {\n      this.canvasElement = this.canvas;\n    }\n\n    // Get canvas element - required for all overlay calculations\n    const effectiveCanvas = this.canvasElement || this.canvas;\n    if (!effectiveCanvas) {\n      this.overlayState = { selection: null, boxSelect: null, highlight: null };\n      return;\n    }\n\n    // Get canvas rect (try .canvas-content first for accurate positioning)\n    let canvasRect = effectiveCanvas.getBoundingClientRect();\n    if (effectiveCanvas.shadowRoot) {\n      const canvasContent = effectiveCanvas.shadowRoot.querySelector(\n        \".canvas-content\",\n      ) as HTMLElement;\n      if (canvasContent) {\n        canvasRect = canvasContent.getBoundingClientRect();\n      }\n    }\n\n    // Get pan-zoom element for box-select coordinate conversion\n    const panZoomElement = effectiveCanvas.closest(\"ef-pan-zoom\") as HTMLElement | null;\n\n    // Get highlighted element from canvas\n    const canvas = effectiveCanvas as any;\n    const highlightedElement = canvas?.highlightedElement as HTMLElement | null;\n\n    // SEMANTICS: What should be shown?\n    const targets = getOverlayTargets(this.effectiveSelection, highlightedElement);\n\n    // Adapt canvas to CanvasWithMetadata interface\n    const canvasWithMetadata: CanvasWithMetadata = {\n      getElementData: (id: string) => canvas?.getElementData?.(id),\n      getElement: (id: string) => canvas?.elementRegistry?.get(id),\n      querySelector: (selector: string) => effectiveCanvas.querySelector(selector),\n      shadowRoot: effectiveCanvas.shadowRoot,\n    };\n\n    // Read current transform directly from panzoom element (not stale property/context)\n    // This ensures we always have the current scale/pan values\n    const currentTransform = this.readCurrentTransform(panZoomElement);\n\n    // MECHANISM: Calculate screen bounds\n    this.overlayState = calculateOverlayState(\n      targets,\n      canvasWithMetadata,\n      canvasRect,\n      panZoomElement,\n      currentTransform,\n    );\n  }\n\n  /**\n   * Read current transform directly from panzoom element.\n   * This ensures we always have fresh values instead of stale property/context.\n   */\n  private readCurrentTransform(panZoomElement: HTMLElement | null): PanZoomTransform | undefined {\n    // Try reading from panzoom element directly (most accurate)\n    if (panZoomElement) {\n      const pz = panZoomElement as any;\n      if (typeof pz.x === \"number\" && typeof pz.y === \"number\" && typeof pz.scale === \"number\") {\n        return { x: pz.x, y: pz.y, scale: pz.scale };\n      }\n    }\n\n    // Fall back to context/property\n    return this.effectivePanZoomTransform;\n  }\n\n  render() {\n    // We only need canvasElement to render overlays\n    const effectiveCanvas = this.canvasElement || this.canvas;\n    if (!effectiveCanvas) {\n      return html``;\n    }\n\n    // NOTE: Selection visualization is handled by EFTransformHandles (with rotation support).\n    // This overlay only renders:\n    // - box-select: marquee during drag-to-select\n    // - highlight-box: hover indication for non-selected elements\n    const { boxSelect, highlight } = this.overlayState;\n    const selectionMode = this.effectiveSelection?.selectionMode;\n\n    return html`\n      ${\n        boxSelect\n          ? html`\n            <div\n              class=\"box-select\"\n              style=\"left: ${boxSelect.x}px; top: ${boxSelect.y}px; width: ${boxSelect.width}px; height: ${boxSelect.height}px; position: absolute; border: 2px dashed rgb(59, 130, 246); background: rgba(59, 130, 246, 0.05); pointer-events: none;\"\n            ></div>\n          `\n          : html``\n      }\n      ${\n        highlight\n          ? html`\n            <div\n              class=\"highlight-box\"\n              style=\"left: ${highlight.x}px; top: ${highlight.y}px; width: ${highlight.width}px; height: ${highlight.height}px; position: absolute; border: 2px solid rgb(148, 163, 184); background: rgba(148, 163, 184, 0.1); pointer-events: none; box-shadow: 0 0 0 2px rgba(148, 163, 184, 0.3);\"\n            ></div>\n          `\n          : html``\n      }\n      ${\n        selectionMode === \"box-selecting\" && !boxSelect\n          ? html`\n            <div style=\"position: fixed; top: 50px; right: 10px; background: orange; color: white; padding: 4px; z-index: 10000; font-size: 12px;\">\n              Box selecting but no bounds! mode=${selectionMode} bounds=${this.effectiveSelection?.boxSelectBounds ? \"exists\" : \"null\"}\n            </div>\n          `\n          : html``\n      }\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"ef-canvas-selection-overlay\": SelectionOverlay;\n  }\n}\n"],"mappings":"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"}

package/dist/canvas/overlays/overlayState.js

@@ -0,0 +1,153 @@
+import { getElementBounds } from "../getElementBounds.js";
+
+//#region src/canvas/overlays/overlayState.ts
+/**
+* Extract overlay targets from selection context and highlighted element.
+* This is pure SEMANTICS - it determines WHAT should be shown.
+*/
+function getOverlayTargets(selection, highlightedElement) {
+	return {
+		selectedIds: selection?.selectedIds ? new Set(selection.selectedIds) : /* @__PURE__ */ new Set(),
+		boxSelectBounds: selection?.boxSelectBounds ?? null,
+		highlightedElementId: highlightedElement?.getAttribute("data-element-id") ?? highlightedElement?.id ?? null
+	};
+}
+/**
+* Calculate screen bounds for a single element.
+* This is the SINGLE SOURCE OF TRUTH for element → screen bounds conversion.
+*
+* Strategy:
+* 1. Try to use metadata (already in canvas coordinates)
+* 2. Fall back to DOM measurement if metadata unavailable
+*
+* @param elementId - The element's ID (data-element-id or id attribute)
+* @param canvas - Canvas element with getElementData method
+* @param canvasRect - Canvas content element's bounding rect
+* @param scale - Current zoom scale
+* @returns Screen bounds or null if element not found
+*/
+function calculateElementScreenBounds(elementId, canvas, canvasRect, scale) {
+	const metadata = canvas.getElementData(elementId);
+	if (metadata && metadata.width > 0 && metadata.height > 0) return {
+		x: canvasRect.left + metadata.x * scale,
+		y: canvasRect.top + metadata.y * scale,
+		width: metadata.width * scale,
+		height: metadata.height * scale
+	};
+	const element = findElement(elementId, canvas);
+	if (!element) return null;
+	const bounds = getElementBounds(element);
+	return {
+		x: bounds.left,
+		y: bounds.top,
+		width: bounds.width,
+		height: bounds.height
+	};
+}
+/**
+* Find an element by ID in the canvas (checks both light DOM and shadow DOM).
+*/
+function findElement(elementId, canvas) {
+	if (canvas.getElement) {
+		const element = canvas.getElement(elementId);
+		if (element) return element;
+	}
+	if (canvas.shadowRoot) {
+		const element = canvas.shadowRoot.querySelector(`[data-element-id="${elementId}"]`);
+		if (element) return element;
+	}
+	return canvas.querySelector(`[data-element-id="${elementId}"]`);
+}
+/**
+* Calculate the union of multiple bounds (bounding box that contains all).
+*/
+function unionBounds(bounds) {
+	if (bounds.length === 0) return null;
+	let minX = Infinity;
+	let minY = Infinity;
+	let maxX = -Infinity;
+	let maxY = -Infinity;
+	for (const b of bounds) {
+		minX = Math.min(minX, b.x);
+		minY = Math.min(minY, b.y);
+		maxX = Math.max(maxX, b.x + b.width);
+		maxY = Math.max(maxY, b.y + b.height);
+	}
+	return {
+		x: minX,
+		y: minY,
+		width: maxX - minX,
+		height: maxY - minY
+	};
+}
+/**
+* Calculate selection bounds for all selected elements.
+*/
+function calculateSelectionBounds(selectedIds, canvas, canvasRect, scale) {
+	if (selectedIds.size === 0) return null;
+	return unionBounds(Array.from(selectedIds).map((id) => calculateElementScreenBounds(id, canvas, canvasRect, scale)).filter((b) => b !== null));
+}
+/**
+* Calculate box-select bounds (convert canvas bounds to screen bounds).
+*
+* @param boxSelectBounds - Box selection bounds in canvas coordinates
+* @param panZoomElement - The pan-zoom element (for canvasToScreen conversion)
+* @param panZoomTransform - Current pan-zoom transform
+* @returns Screen bounds or null
+*/
+function calculateBoxSelectBounds(boxSelectBounds, panZoomElement, panZoomTransform) {
+	if (!boxSelectBounds || !panZoomElement || !panZoomTransform) return null;
+	const pz = panZoomElement;
+	if (typeof pz.canvasToScreen === "function") {
+		const topLeft = pz.canvasToScreen(boxSelectBounds.left, boxSelectBounds.top);
+		const bottomRight = pz.canvasToScreen(boxSelectBounds.right, boxSelectBounds.bottom);
+		return {
+			x: topLeft.x,
+			y: topLeft.y,
+			width: bottomRight.x - topLeft.x,
+			height: bottomRight.y - topLeft.y
+		};
+	}
+	const panZoomRect = panZoomElement.getBoundingClientRect();
+	const { scale, x, y } = panZoomTransform;
+	const screenLeft = panZoomRect.left + boxSelectBounds.left * scale + x;
+	const screenTop = panZoomRect.top + boxSelectBounds.top * scale + y;
+	const screenRight = panZoomRect.left + boxSelectBounds.right * scale + x;
+	const screenBottom = panZoomRect.top + boxSelectBounds.bottom * scale + y;
+	return {
+		x: screenLeft,
+		y: screenTop,
+		width: screenRight - screenLeft,
+		height: screenBottom - screenTop
+	};
+}
+/**
+* Calculate highlight bounds for the highlighted element.
+*/
+function calculateHighlightBounds(highlightedElementId, canvas, canvasRect, scale) {
+	if (!highlightedElementId) return null;
+	return calculateElementScreenBounds(highlightedElementId, canvas, canvasRect, scale);
+}
+/**
+* Calculate the complete overlay state from targets.
+* This is the main entry point that combines semantics and mechanism.
+*
+* @param targets - What should be shown (from getOverlayTargets)
+* @param canvas - Canvas element with metadata
+* @param canvasRect - Canvas content bounding rect
+* @param panZoomElement - Pan-zoom element (for box-select conversion)
+* @param panZoomTransform - Current transform
+* @returns Complete overlay state
+*/
+function calculateOverlayState(targets, canvas, canvasRect, panZoomElement, panZoomTransform) {
+	const scale = panZoomTransform?.scale ?? 1;
+	return {
+		selection: calculateSelectionBounds(targets.selectedIds, canvas, canvasRect, scale),
+		boxSelect: calculateBoxSelectBounds(targets.boxSelectBounds, panZoomElement, panZoomTransform),
+		highlight: calculateHighlightBounds(targets.highlightedElementId, canvas, canvasRect, scale)
+	};
+}
+
+//#endregion
+export { calculateOverlayState, getOverlayTargets };
+//# sourceMappingURL=overlayState.js.map

package/dist/canvas/overlays/overlayState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayState.js","names":[],"sources":["../../../src/canvas/overlays/overlayState.ts"],"sourcesContent":["/**\n * Overlay State Management\n *\n * This module provides a clean separation between:\n * - SEMANTICS: What should be shown? (OverlayTargets)\n * - MECHANISM: How to calculate screen bounds (calculateOverlayState)\n *\n * INVARIANTS:\n * 1. Overlay is visible iff bounds are non-null with positive dimensions\n * 2. All bounds are in screen coordinates (relative to viewport origin)\n * 3. Only one element can be highlighted at a time\n *\n * COORDINATE SPACES:\n * - Canvas space: Logical coordinates, unaffected by zoom (used for element positioning)\n * - Screen space: Viewport coordinates (used for overlay positioning)\n */\n\nimport type { PanZoomTransform } from \"../../elements/EFPanZoom.js\";\nimport type { SelectionContext } from \"../selection/selectionContext.js\";\nimport { getElementBounds } from \"../getElementBounds.js\";\n\n// ============================================================================\n// TYPES: Core Concepts\n// ============================================================================\n\n/**\n * Screen-space bounding box for overlay positioning.\n * All values are in viewport coordinates (pixels from viewport origin).\n */\nexport interface ScreenBounds {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/**\n * Canvas-space bounding box (from selection context).\n */\nexport interface CanvasBounds {\n  left: number;\n  top: number;\n  right: number;\n  bottom: number;\n}\n\n/**\n * The complete state of all overlays.\n * Each property is either a ScreenBounds or null.\n * An overlay is visible iff its bounds are non-null.\n */\nexport interface OverlayState {\n  selection: ScreenBounds | null;\n  boxSelect: ScreenBounds | null;\n  highlight: ScreenBounds | null;\n}\n\n/**\n * SEMANTICS: What elements should have overlays?\n * This represents the \"what\" without the \"how\".\n */\nexport interface OverlayTargets {\n  selectedIds: Set<string>;\n  boxSelectBounds: CanvasBounds | null;\n  highlightedElementId: string | null;\n}\n\n/**\n * Interface for canvas element data (metadata).\n */\nexport interface ElementMetadata {\n  id: string;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  rotation?: number;\n}\n\n/**\n * Interface for canvas that provides element data.\n */\nexport interface CanvasWithMetadata {\n  getElementData(elementId: string): ElementMetadata | undefined;\n  getElement?(elementId: string): HTMLElement | undefined;\n  querySelector(selector: string): HTMLElement | null;\n  shadowRoot: ShadowRoot | null;\n}\n\n// ============================================================================\n// SEMANTICS: Extract what should be shown\n// ============================================================================\n\n/**\n * Extract overlay targets from selection context and highlighted element.\n * This is pure SEMANTICS - it determines WHAT should be shown.\n */\nexport function getOverlayTargets(\n  selection: SelectionContext | undefined,\n  highlightedElement: HTMLElement | null,\n): OverlayTargets {\n  return {\n    selectedIds: selection?.selectedIds ? new Set(selection.selectedIds) : new Set(),\n    boxSelectBounds: selection?.boxSelectBounds ?? null,\n    highlightedElementId:\n      highlightedElement?.getAttribute(\"data-element-id\") ??\n      highlightedElement?.id ??\n      null,\n  };\n}\n\n// ============================================================================\n// MECHANISM: Calculate screen bounds\n// ============================================================================\n\n/**\n * Calculate screen bounds for a single element.\n * This is the SINGLE SOURCE OF TRUTH for element → screen bounds conversion.\n *\n * Strategy:\n * 1. Try to use metadata (already in canvas coordinates)\n * 2. Fall back to DOM measurement if metadata unavailable\n *\n * @param elementId - The element's ID (data-element-id or id attribute)\n * @param canvas - Canvas element with getElementData method\n * @param canvasRect - Canvas content element's bounding rect\n * @param scale - Current zoom scale\n * @returns Screen bounds or null if element not found\n */\nexport function calculateElementScreenBounds(\n  elementId: string,\n  canvas: CanvasWithMetadata,\n  canvasRect: DOMRect,\n  scale: number,\n): ScreenBounds | null {\n  const metadata = canvas.getElementData(elementId);\n\n  if (metadata && metadata.width > 0 && metadata.height > 0) {\n    // Use metadata (already in canvas coordinates)\n    return {\n      x: canvasRect.left + metadata.x * scale,\n      y: canvasRect.top + metadata.y * scale,\n      width: metadata.width * scale,\n      height: metadata.height * scale,\n    };\n  }\n\n  // Fallback: find element and use DOM measurement\n  const element = findElement(elementId, canvas);\n  if (!element) return null;\n\n  const bounds = getElementBounds(element);\n  return {\n    x: bounds.left,\n    y: bounds.top,\n    width: bounds.width,\n    height: bounds.height,\n  };\n}\n\n/**\n * Find an element by ID in the canvas (checks both light DOM and shadow DOM).\n */\nfunction findElement(\n  elementId: string,\n  canvas: CanvasWithMetadata,\n): HTMLElement | null {\n  // Try canvas's getElement method first\n  if (canvas.getElement) {\n    const element = canvas.getElement(elementId);\n    if (element) return element;\n  }\n\n  // Try shadow DOM\n  if (canvas.shadowRoot) {\n    const element = canvas.shadowRoot.querySelector(\n      `[data-element-id=\"${elementId}\"]`,\n    ) as HTMLElement | null;\n    if (element) return element;\n  }\n\n  // Try light DOM\n  return canvas.querySelector(\n    `[data-element-id=\"${elementId}\"]`,\n  ) as HTMLElement | null;\n}\n\n/**\n * Calculate the union of multiple bounds (bounding box that contains all).\n */\nexport function unionBounds(bounds: ScreenBounds[]): ScreenBounds | null {\n  if (bounds.length === 0) return null;\n\n  let minX = Infinity;\n  let minY = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n\n  for (const b of bounds) {\n    minX = Math.min(minX, b.x);\n    minY = Math.min(minY, b.y);\n    maxX = Math.max(maxX, b.x + b.width);\n    maxY = Math.max(maxY, b.y + b.height);\n  }\n\n  return {\n    x: minX,\n    y: minY,\n    width: maxX - minX,\n    height: maxY - minY,\n  };\n}\n\n/**\n * Calculate selection bounds for all selected elements.\n */\nexport function calculateSelectionBounds(\n  selectedIds: Set<string>,\n  canvas: CanvasWithMetadata,\n  canvasRect: DOMRect,\n  scale: number,\n): ScreenBounds | null {\n  if (selectedIds.size === 0) return null;\n\n  const elementBounds = Array.from(selectedIds)\n    .map((id) => calculateElementScreenBounds(id, canvas, canvasRect, scale))\n    .filter((b): b is ScreenBounds => b !== null);\n\n  return unionBounds(elementBounds);\n}\n\n/**\n * Calculate box-select bounds (convert canvas bounds to screen bounds).\n *\n * @param boxSelectBounds - Box selection bounds in canvas coordinates\n * @param panZoomElement - The pan-zoom element (for canvasToScreen conversion)\n * @param panZoomTransform - Current pan-zoom transform\n * @returns Screen bounds or null\n */\nexport function calculateBoxSelectBounds(\n  boxSelectBounds: CanvasBounds | null,\n  panZoomElement: HTMLElement | null,\n  panZoomTransform: PanZoomTransform | undefined,\n): ScreenBounds | null {\n  if (!boxSelectBounds || !panZoomElement || !panZoomTransform) {\n    return null;\n  }\n\n  // Try to use EFPanZoom's canvasToScreen method if available\n  const pz = panZoomElement as any;\n  if (typeof pz.canvasToScreen === \"function\") {\n    const topLeft = pz.canvasToScreen(boxSelectBounds.left, boxSelectBounds.top);\n    const bottomRight = pz.canvasToScreen(\n      boxSelectBounds.right,\n      boxSelectBounds.bottom,\n    );\n\n    return {\n      x: topLeft.x,\n      y: topLeft.y,\n      width: bottomRight.x - topLeft.x,\n      height: bottomRight.y - topLeft.y,\n    };\n  }\n\n  // Fallback: manual calculation\n  const panZoomRect = panZoomElement.getBoundingClientRect();\n  const { scale, x, y } = panZoomTransform;\n\n  const screenLeft = panZoomRect.left + boxSelectBounds.left * scale + x;\n  const screenTop = panZoomRect.top + boxSelectBounds.top * scale + y;\n  const screenRight = panZoomRect.left + boxSelectBounds.right * scale + x;\n  const screenBottom = panZoomRect.top + boxSelectBounds.bottom * scale + y;\n\n  return {\n    x: screenLeft,\n    y: screenTop,\n    width: screenRight - screenLeft,\n    height: screenBottom - screenTop,\n  };\n}\n\n/**\n * Calculate highlight bounds for the highlighted element.\n */\nexport function calculateHighlightBounds(\n  highlightedElementId: string | null,\n  canvas: CanvasWithMetadata,\n  canvasRect: DOMRect,\n  scale: number,\n): ScreenBounds | null {\n  if (!highlightedElementId) return null;\n\n  return calculateElementScreenBounds(\n    highlightedElementId,\n    canvas,\n    canvasRect,\n    scale,\n  );\n}\n\n// ============================================================================\n// MAIN: Calculate complete overlay state\n// ============================================================================\n\n/**\n * Calculate the complete overlay state from targets.\n * This is the main entry point that combines semantics and mechanism.\n *\n * @param targets - What should be shown (from getOverlayTargets)\n * @param canvas - Canvas element with metadata\n * @param canvasRect - Canvas content bounding rect\n * @param panZoomElement - Pan-zoom element (for box-select conversion)\n * @param panZoomTransform - Current transform\n * @returns Complete overlay state\n */\nexport function calculateOverlayState(\n  targets: OverlayTargets,\n  canvas: CanvasWithMetadata,\n  canvasRect: DOMRect,\n  panZoomElement: HTMLElement | null,\n  panZoomTransform: PanZoomTransform | undefined,\n): OverlayState {\n  const scale = panZoomTransform?.scale ?? 1;\n\n  return {\n    selection: calculateSelectionBounds(\n      targets.selectedIds,\n      canvas,\n      canvasRect,\n      scale,\n    ),\n    boxSelect: calculateBoxSelectBounds(\n      targets.boxSelectBounds,\n      panZoomElement,\n      panZoomTransform,\n    ),\n    highlight: calculateHighlightBounds(\n      targets.highlightedElementId,\n      canvas,\n      canvasRect,\n      scale,\n    ),\n  };\n}\n\n// ============================================================================\n// INVARIANTS: Helper functions to check invariants\n// ============================================================================\n\n/**\n * INVARIANT: Overlay is visible iff bounds exist with positive dimensions.\n */\nexport function isOverlayVisible(bounds: ScreenBounds | null): boolean {\n  return bounds !== null && bounds.width > 0 && bounds.height > 0;\n}\n\n/**\n * Check if overlay state has any visible overlays.\n */\nexport function hasVisibleOverlays(state: OverlayState): boolean {\n  return (\n    isOverlayVisible(state.selection) ||\n    isOverlayVisible(state.boxSelect) ||\n    isOverlayVisible(state.highlight)\n  );\n}\n\n"],"mappings":"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"}

package/dist/canvas/selection/SelectionController.js

@@ -0,0 +1,105 @@
+import { SelectionModel } from "./SelectionModel.js";
+
+//#region src/canvas/selection/SelectionController.ts
+/**
+* Reactive controller that bridges SelectionModel and Lit element lifecycle.
+* Provides selection context to child elements.
+*/
+var SelectionController = class {
+	constructor(host) {
+		this.hitTestFn = null;
+		this.host = host;
+		this.selectionModel = new SelectionModel();
+		this.selectionContext = this.createContextProxy();
+		host.addController(this);
+		this.selectionModel.addEventListener("selectionchange", () => {
+			queueMicrotask(() => this.host.requestUpdate());
+		});
+	}
+	hostConnected() {}
+	hostDisconnected() {}
+	/**
+	* Set the hit test function for box selection.
+	*/
+	setHitTest(fn) {
+		this.hitTestFn = fn;
+	}
+	/**
+	* Get the underlying selection model.
+	*/
+	getModel() {
+		return this.selectionModel;
+	}
+	/**
+	* Create a proxy context that delegates to the selection model.
+	*/
+	createContextProxy() {
+		const controller = this;
+		return {
+			get selectedIds() {
+				return controller.selectionModel.selectedIds;
+			},
+			get selectionMode() {
+				return controller.selectionModel.selectionMode;
+			},
+			get boxSelectBounds() {
+				return controller.selectionModel.boxSelectBounds;
+			},
+			select: (id) => {
+				controller.selectionModel.select(id);
+			},
+			selectMultiple: (ids) => {
+				controller.selectionModel.selectMultiple(ids);
+			},
+			addToSelection: (id) => {
+				controller.selectionModel.addToSelection(id);
+			},
+			deselect: (id) => {
+				controller.selectionModel.deselect(id);
+			},
+			toggle: (id) => {
+				controller.selectionModel.toggle(id);
+			},
+			clear: () => {
+				controller.selectionModel.clear();
+			},
+			startBoxSelect: (x, y) => {
+				controller.selectionModel.startBoxSelect(x, y);
+				queueMicrotask(() => controller.host.requestUpdate());
+			},
+			updateBoxSelect: (x, y) => {
+				controller.selectionModel.updateBoxSelect(x, y);
+				queueMicrotask(() => controller.host.requestUpdate());
+			},
+			endBoxSelect: (hitTest, addToSelection) => {
+				const fn = hitTest || controller.hitTestFn;
+				if (fn) controller.selectionModel.endBoxSelect(fn, addToSelection ?? false);
+			},
+			createGroup: (ids) => {
+				return controller.selectionModel.createGroup(ids);
+			},
+			ungroup: (groupId) => {
+				controller.selectionModel.ungroup(groupId);
+			},
+			selectGroup: (groupId) => {
+				controller.selectionModel.selectGroup(groupId);
+			},
+			getGroupId: (elementId) => {
+				return controller.selectionModel.getGroupId(elementId);
+			},
+			getGroupElements: (groupId) => {
+				return controller.selectionModel.getGroupElements(groupId);
+			},
+			addEventListener: (type, listener) => {
+				controller.selectionModel.addEventListener(type, listener);
+			},
+			removeEventListener: (type, listener) => {
+				controller.selectionModel.removeEventListener(type, listener);
+			}
+		};
+	}
+};
+
+//#endregion
+export { SelectionController };
+//# sourceMappingURL=SelectionController.js.map

package/dist/canvas/selection/SelectionController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionController.js","names":[],"sources":["../../../src/canvas/selection/SelectionController.ts"],"sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport { SelectionModel } from \"./SelectionModel.js\";\nimport type { SelectionContext } from \"./selectionContext.js\";\n\n/**\n * Reactive controller that bridges SelectionModel and Lit element lifecycle.\n * Provides selection context to child elements.\n */\nexport class SelectionController implements ReactiveController {\n  private host: ReactiveControllerHost;\n  private selectionModel: SelectionModel;\n  private hitTestFn: ((bounds: DOMRect) => string[]) | null = null;\n  selectionContext: SelectionContext;\n\n  constructor(host: ReactiveControllerHost) {\n    this.host = host;\n    this.selectionModel = new SelectionModel();\n    this.selectionContext = this.createContextProxy();\n    host.addController(this);\n\n    // Listen to selection change events from the model\n    // Use queueMicrotask to defer the update and avoid Lit warning about\n    // scheduling updates after update completed (change-in-update)\n    this.selectionModel.addEventListener(\"selectionchange\", () => {\n      queueMicrotask(() => this.host.requestUpdate());\n    });\n  }\n\n  hostConnected(): void {\n    // Context is provided via @provide decorator\n  }\n\n  hostDisconnected(): void {\n    // Cleanup if needed\n  }\n\n  /**\n   * Set the hit test function for box selection.\n   */\n  setHitTest(fn: (bounds: DOMRect) => string[]): void {\n    this.hitTestFn = fn;\n  }\n\n  /**\n   * Get the underlying selection model.\n   */\n  getModel(): SelectionModel {\n    return this.selectionModel;\n  }\n\n  /**\n   * Create a proxy context that delegates to the selection model.\n   */\n  private createContextProxy(): SelectionContext {\n    const controller = this;\n    return {\n      get selectedIds() {\n        return controller.selectionModel.selectedIds;\n      },\n      get selectionMode() {\n        return controller.selectionModel.selectionMode;\n      },\n      get boxSelectBounds() {\n        return controller.selectionModel.boxSelectBounds;\n      },\n      select: (id: string) => {\n        controller.selectionModel.select(id);\n        // Event will trigger requestUpdate via event listener\n      },\n      selectMultiple: (ids: string[]) => {\n        controller.selectionModel.selectMultiple(ids);\n        // Event will trigger requestUpdate via event listener\n      },\n      addToSelection: (id: string) => {\n        controller.selectionModel.addToSelection(id);\n        // Event will trigger requestUpdate via event listener\n      },\n      deselect: (id: string) => {\n        controller.selectionModel.deselect(id);\n        // Event will trigger requestUpdate via event listener\n      },\n      toggle: (id: string) => {\n        controller.selectionModel.toggle(id);\n        // Event will trigger requestUpdate via event listener\n      },\n      clear: () => {\n        controller.selectionModel.clear();\n        // Event will trigger requestUpdate via event listener\n      },\n      startBoxSelect: (x: number, y: number) => {\n        controller.selectionModel.startBoxSelect(x, y);\n        queueMicrotask(() => controller.host.requestUpdate());\n      },\n      updateBoxSelect: (x: number, y: number) => {\n        controller.selectionModel.updateBoxSelect(x, y);\n        queueMicrotask(() => controller.host.requestUpdate());\n      },\n      endBoxSelect: (\n        hitTest: (bounds: DOMRect) => string[],\n        addToSelection?: boolean,\n      ) => {\n        const fn = hitTest || controller.hitTestFn;\n        if (fn) {\n          controller.selectionModel.endBoxSelect(fn, addToSelection ?? false);\n        }\n        // Event will trigger requestUpdate via event listener\n      },\n      createGroup: (ids: string[]) => {\n        const groupId = controller.selectionModel.createGroup(ids);\n        return groupId;\n      },\n      ungroup: (groupId: string) => {\n        controller.selectionModel.ungroup(groupId);\n      },\n      selectGroup: (groupId: string) => {\n        controller.selectionModel.selectGroup(groupId);\n        // Event will trigger requestUpdate via event listener\n      },\n      getGroupId: (elementId: string) => {\n        return controller.selectionModel.getGroupId(elementId);\n      },\n      getGroupElements: (groupId: string) => {\n        return controller.selectionModel.getGroupElements(groupId);\n      },\n      addEventListener: (\n        type: \"selectionchange\",\n        listener: (event: CustomEvent) => void,\n      ) => {\n        controller.selectionModel.addEventListener(type, listener as EventListener);\n      },\n      removeEventListener: (\n        type: \"selectionchange\",\n        listener: (event: CustomEvent) => void,\n      ) => {\n        controller.selectionModel.removeEventListener(type, listener as EventListener);\n      },\n    };\n  }\n}\n"],"mappings":";;;;;;;AAQA,IAAa,sBAAb,MAA+D;CAM7D,YAAY,MAA8B;mBAHkB;AAI1D,OAAK,OAAO;AACZ,OAAK,iBAAiB,IAAI,gBAAgB;AAC1C,OAAK,mBAAmB,KAAK,oBAAoB;AACjD,OAAK,cAAc,KAAK;AAKxB,OAAK,eAAe,iBAAiB,yBAAyB;AAC5D,wBAAqB,KAAK,KAAK,eAAe,CAAC;IAC/C;;CAGJ,gBAAsB;CAItB,mBAAyB;;;;CAOzB,WAAW,IAAyC;AAClD,OAAK,YAAY;;;;;CAMnB,WAA2B;AACzB,SAAO,KAAK;;;;;CAMd,AAAQ,qBAAuC;EAC7C,MAAM,aAAa;AACnB,SAAO;GACL,IAAI,cAAc;AAChB,WAAO,WAAW,eAAe;;GAEnC,IAAI,gBAAgB;AAClB,WAAO,WAAW,eAAe;;GAEnC,IAAI,kBAAkB;AACpB,WAAO,WAAW,eAAe;;GAEnC,SAAS,OAAe;AACtB,eAAW,eAAe,OAAO,GAAG;;GAGtC,iBAAiB,QAAkB;AACjC,eAAW,eAAe,eAAe,IAAI;;GAG/C,iBAAiB,OAAe;AAC9B,eAAW,eAAe,eAAe,GAAG;;GAG9C,WAAW,OAAe;AACxB,eAAW,eAAe,SAAS,GAAG;;GAGxC,SAAS,OAAe;AACtB,eAAW,eAAe,OAAO,GAAG;;GAGtC,aAAa;AACX,eAAW,eAAe,OAAO;;GAGnC,iBAAiB,GAAW,MAAc;AACxC,eAAW,eAAe,eAAe,GAAG,EAAE;AAC9C,yBAAqB,WAAW,KAAK,eAAe,CAAC;;GAEvD,kBAAkB,GAAW,MAAc;AACzC,eAAW,eAAe,gBAAgB,GAAG,EAAE;AAC/C,yBAAqB,WAAW,KAAK,eAAe,CAAC;;GAEvD,eACE,SACA,mBACG;IACH,MAAM,KAAK,WAAW,WAAW;AACjC,QAAI,GACF,YAAW,eAAe,aAAa,IAAI,kBAAkB,MAAM;;GAIvE,cAAc,QAAkB;AAE9B,WADgB,WAAW,eAAe,YAAY,IAAI;;GAG5D,UAAU,YAAoB;AAC5B,eAAW,eAAe,QAAQ,QAAQ;;GAE5C,cAAc,YAAoB;AAChC,eAAW,eAAe,YAAY,QAAQ;;GAGhD,aAAa,cAAsB;AACjC,WAAO,WAAW,eAAe,WAAW,UAAU;;GAExD,mBAAmB,YAAoB;AACrC,WAAO,WAAW,eAAe,iBAAiB,QAAQ;;GAE5D,mBACE,MACA,aACG;AACH,eAAW,eAAe,iBAAiB,MAAM,SAA0B;;GAE7E,sBACE,MACA,aACG;AACH,eAAW,eAAe,oBAAoB,MAAM,SAA0B;;GAEjF"}

package/dist/canvas/selection/SelectionModel.d.ts

@@ -0,0 +1,98 @@
+import { SelectionState } from "../api/types.js";
+
+//#region src/canvas/selection/SelectionModel.d.ts
+
+/**
+ * Pure selection logic - semantics separate from mechanism.
+ * Manages selection state and operations.
+ */
+declare class SelectionModel extends EventTarget {
+  private _selectedIds;
+  private _primaryId;
+  private _selectionMode;
+  private _boxSelectStart;
+  private _boxSelectCurrent;
+  private _groups;
+  private _elementToGroup;
+  /**
+   * Emit selectionchange event with current selection state.
+   */
+  private _emitSelectionChange;
+  /**
+   * Get current selection state.
+   */
+  get selectedIds(): ReadonlySet<string>;
+  /**
+   * Get current selection mode.
+   */
+  get selectionMode(): SelectionState;
+  /**
+   * Get current box selection bounds, if active.
+   */
+  get boxSelectBounds(): DOMRect | null;
+  /**
+   * Select a single element.
+   */
+  select(id: string): void;
+  /**
+   * Select multiple elements.
+   */
+  selectMultiple(ids: string[]): void;
+  /**
+   * Add element to selection (for multi-select).
+   */
+  addToSelection(id: string): void;
+  /**
+   * Remove element from selection.
+   */
+  deselect(id: string): void;
+  /**
+   * Toggle element selection state.
+   */
+  toggle(id: string): void;
+  /**
+   * Clear all selections.
+   */
+  clear(): void;
+  /**
+   * Start box selection.
+   */
+  startBoxSelect(x: number, y: number): void;
+  /**
+   * Update box selection.
+   */
+  updateBoxSelect(x: number, y: number): void;
+  /**
+   * End box selection and select elements within bounds.
+   * @param hitTest - Function to find elements within bounds
+   * @param addToSelection - If true, add to existing selection; if false, replace selection
+   */
+  endBoxSelect(hitTest: (bounds: DOMRect) => string[], addToSelection?: boolean): void;
+  /**
+   * Create a group from selected elements.
+   */
+  createGroup(ids: string[]): string;
+  /**
+   * Ungroup a group.
+   */
+  ungroup(groupId: string): void;
+  /**
+   * Select all elements in a group.
+   */
+  selectGroup(groupId: string): void;
+  /**
+   * Get group ID for an element, if any.
+   */
+  getGroupId(elementId: string): string | undefined;
+  /**
+   * Get all element IDs in a group.
+   */
+  getGroupElements(groupId: string): string[];
+  /**
+   * Update selection mode based on current selection count.
+   */
+  private _updateSelectionMode;
+}
+//#endregion
+export { SelectionModel };
+//# sourceMappingURL=SelectionModel.d.ts.map

package/dist/canvas/selection/SelectionModel.js

@@ -0,0 +1,229 @@
+//#region src/canvas/selection/SelectionModel.ts
+/**
+* Create a DOMRect-like object. Polyfill for Node.js environments.
+*/
+function createRect(x, y, width, height) {
+	if (typeof DOMRect !== "undefined") return new DOMRect(x, y, width, height);
+	return {
+		x,
+		y,
+		width,
+		height,
+		left: x,
+		top: y,
+		right: x + width,
+		bottom: y + height,
+		toJSON: () => ({
+			x,
+			y,
+			width,
+			height
+		})
+	};
+}
+/**
+* Pure selection logic - semantics separate from mechanism.
+* Manages selection state and operations.
+*/
+var SelectionModel = class extends EventTarget {
+	constructor(..._args) {
+		super(..._args);
+		this._selectedIds = /* @__PURE__ */ new Set();
+		this._primaryId = null;
+		this._selectionMode = "none";
+		this._boxSelectStart = null;
+		this._boxSelectCurrent = null;
+		this._groups = /* @__PURE__ */ new Map();
+		this._elementToGroup = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Emit selectionchange event with current selection state.
+	*/
+	_emitSelectionChange() {
+		const selectedIdsArray = this._primaryId && this._selectedIds.has(this._primaryId) ? [this._primaryId, ...Array.from(this._selectedIds).filter((id) => id !== this._primaryId)] : Array.from(this._selectedIds);
+		this.dispatchEvent(new CustomEvent("selectionchange", {
+			detail: {
+				selectedIds: selectedIdsArray,
+				selectionMode: this._selectionMode
+			},
+			bubbles: false,
+			composed: false
+		}));
+	}
+	/**
+	* Get current selection state.
+	*/
+	get selectedIds() {
+		return this._selectedIds;
+	}
+	/**
+	* Get current selection mode.
+	*/
+	get selectionMode() {
+		return this._selectionMode;
+	}
+	/**
+	* Get current box selection bounds, if active.
+	*/
+	get boxSelectBounds() {
+		if (!this._boxSelectStart || !this._boxSelectCurrent) return null;
+		const left = Math.min(this._boxSelectStart.x, this._boxSelectCurrent.x);
+		const top = Math.min(this._boxSelectStart.y, this._boxSelectCurrent.y);
+		const right = Math.max(this._boxSelectStart.x, this._boxSelectCurrent.x);
+		const bottom = Math.max(this._boxSelectStart.y, this._boxSelectCurrent.y);
+		return createRect(left, top, right - left, bottom - top);
+	}
+	/**
+	* Select a single element.
+	*/
+	select(id) {
+		this._selectedIds.clear();
+		this._selectedIds.add(id);
+		this._primaryId = id;
+		this._selectionMode = "single";
+		this._emitSelectionChange();
+	}
+	/**
+	* Select multiple elements.
+	*/
+	selectMultiple(ids) {
+		this._selectedIds.clear();
+		for (const id of ids) this._selectedIds.add(id);
+		this._primaryId = ids.length > 0 ? ids[0] ?? null : null;
+		this._selectionMode = ids.length === 0 ? "none" : ids.length === 1 ? "single" : "multiple";
+		this._emitSelectionChange();
+	}
+	/**
+	* Add element to selection (for multi-select).
+	*/
+	addToSelection(id) {
+		this._selectedIds.add(id);
+		if (!this._primaryId) this._primaryId = id;
+		this._updateSelectionMode();
+		this._emitSelectionChange();
+	}
+	/**
+	* Remove element from selection.
+	*/
+	deselect(id) {
+		this._selectedIds.delete(id);
+		if (this._primaryId === id) {
+			const remaining = Array.from(this._selectedIds);
+			this._primaryId = remaining.length > 0 ? remaining[0] ?? null : null;
+		}
+		this._updateSelectionMode();
+		this._emitSelectionChange();
+	}
+	/**
+	* Toggle element selection state.
+	*/
+	toggle(id) {
+		if (this._selectedIds.has(id)) this.deselect(id);
+		else this.addToSelection(id);
+	}
+	/**
+	* Clear all selections.
+	*/
+	clear() {
+		this._selectedIds.clear();
+		this._primaryId = null;
+		this._selectionMode = "none";
+		this._boxSelectStart = null;
+		this._boxSelectCurrent = null;
+		this._emitSelectionChange();
+	}
+	/**
+	* Start box selection.
+	*/
+	startBoxSelect(x, y) {
+		this._boxSelectStart = {
+			x,
+			y
+		};
+		this._boxSelectCurrent = {
+			x,
+			y
+		};
+		this._selectionMode = "box-selecting";
+	}
+	/**
+	* Update box selection.
+	*/
+	updateBoxSelect(x, y) {
+		if (this._selectionMode !== "box-selecting") return;
+		this._boxSelectCurrent = {
+			x,
+			y
+		};
+	}
+	/**
+	* End box selection and select elements within bounds.
+	* @param hitTest - Function to find elements within bounds
+	* @param addToSelection - If true, add to existing selection; if false, replace selection
+	*/
+	endBoxSelect(hitTest, addToSelection = false) {
+		if (this._selectionMode !== "box-selecting" || !this._boxSelectStart || !this._boxSelectCurrent) return;
+		const bounds = this.boxSelectBounds;
+		if (bounds) {
+			const ids = hitTest(bounds);
+			if (addToSelection) for (const id of ids) this.addToSelection(id);
+			else this.selectMultiple(ids);
+		}
+		this._boxSelectStart = null;
+		this._boxSelectCurrent = null;
+	}
+	/**
+	* Create a group from selected elements.
+	*/
+	createGroup(ids) {
+		if (ids.length === 0) throw new Error("Cannot create group with no elements");
+		const groupId = `group-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+		const groupSet = new Set(ids);
+		this._groups.set(groupId, groupSet);
+		for (const id of ids) this._elementToGroup.set(id, groupId);
+		return groupId;
+	}
+	/**
+	* Ungroup a group.
+	*/
+	ungroup(groupId) {
+		const group = this._groups.get(groupId);
+		if (!group) return;
+		for (const id of group) this._elementToGroup.delete(id);
+		this._groups.delete(groupId);
+	}
+	/**
+	* Select all elements in a group.
+	*/
+	selectGroup(groupId) {
+		const group = this._groups.get(groupId);
+		if (!group) return;
+		this.selectMultiple(Array.from(group));
+	}
+	/**
+	* Get group ID for an element, if any.
+	*/
+	getGroupId(elementId) {
+		return this._elementToGroup.get(elementId);
+	}
+	/**
+	* Get all element IDs in a group.
+	*/
+	getGroupElements(groupId) {
+		const group = this._groups.get(groupId);
+		return group ? Array.from(group) : [];
+	}
+	/**
+	* Update selection mode based on current selection count.
+	*/
+	_updateSelectionMode() {
+		const count = this._selectedIds.size;
+		if (count === 0) this._selectionMode = "none";
+		else if (count === 1) this._selectionMode = "single";
+		else this._selectionMode = "multiple";
+	}
+};
+
+//#endregion
+export { SelectionModel };
+//# sourceMappingURL=SelectionModel.js.map