agentation-vue 0.2.0

package/dist/composables/useMarkerPositions.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useMarkerPositions = useMarkerPositions;
+var _vueDemi = require("vue-demi");
+function useMarkerPositions(annotations) {
+  let resizeObserver = null;
+  let rafId = null;
+  function recalculatePositions() {
+    if (rafId !== null) return;
+    rafId = requestAnimationFrame(() => {
+      rafId = null;
+      for (const annotation of annotations.value) {
+        const el = annotation._targetRef?.deref();
+        if (!el) continue;
+        const rect = el.getBoundingClientRect();
+        const scrollTop = window.scrollY || document.documentElement.scrollTop;
+        annotation.x = (rect.left + rect.width / 2) / window.innerWidth * 100;
+        annotation.y = annotation.isFixed ? rect.top + rect.height / 2 : rect.top + rect.height / 2 + scrollTop;
+      }
+    });
+  }
+  (0, _vueDemi.onMounted)(() => {
+    window.addEventListener("resize", recalculatePositions, {
+      passive: true
+    });
+    window.addEventListener("scroll", recalculatePositions, {
+      passive: true
+    });
+    resizeObserver = new ResizeObserver(recalculatePositions);
+    const appRoot = document.querySelector("#app") || document.body;
+    resizeObserver.observe(appRoot);
+  });
+  (0, _vueDemi.onBeforeUnmount)(() => {
+    window.removeEventListener("resize", recalculatePositions);
+    window.removeEventListener("scroll", recalculatePositions);
+    resizeObserver?.disconnect();
+    if (rafId !== null) cancelAnimationFrame(rafId);
+  });
+  return {
+    recalculatePositions
+  };
+}

package/dist/composables/useMarkerPositions.mjs

@@ -0,0 +1,36 @@
+import { onBeforeUnmount, onMounted } from "vue-demi";
+export function useMarkerPositions(annotations) {
+  let resizeObserver = null;
+  let rafId = null;
+  function recalculatePositions() {
+    if (rafId !== null)
+      return;
+    rafId = requestAnimationFrame(() => {
+      rafId = null;
+      for (const annotation of annotations.value) {
+        const el = annotation._targetRef?.deref();
+        if (!el)
+          continue;
+        const rect = el.getBoundingClientRect();
+        const scrollTop = window.scrollY || document.documentElement.scrollTop;
+        annotation.x = (rect.left + rect.width / 2) / window.innerWidth * 100;
+        annotation.y = annotation.isFixed ? rect.top + rect.height / 2 : rect.top + rect.height / 2 + scrollTop;
+      }
+    });
+  }
+  onMounted(() => {
+    window.addEventListener("resize", recalculatePositions, { passive: true });
+    window.addEventListener("scroll", recalculatePositions, { passive: true });
+    resizeObserver = new ResizeObserver(recalculatePositions);
+    const appRoot = document.querySelector("#app") || document.body;
+    resizeObserver.observe(appRoot);
+  });
+  onBeforeUnmount(() => {
+    window.removeEventListener("resize", recalculatePositions);
+    window.removeEventListener("scroll", recalculatePositions);
+    resizeObserver?.disconnect();
+    if (rafId !== null)
+      cancelAnimationFrame(rafId);
+  });
+  return { recalculatePositions };
+}

package/dist/composables/useMultiSelect.d.ts

@@ -0,0 +1,20 @@
+import type { Ref } from 'vue-demi';
+import type { BoundingBox, InteractionMode } from '../types';
+export declare function useMultiSelect(mode: Ref<InteractionMode>, transitionFn: (to: InteractionMode) => boolean): {
+    selectionRect: Ref<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null, BoundingBox | {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
+    selectedElements: Ref<Element[], Element[]>;
+    onMouseDown: (e: MouseEvent) => boolean;
+    onMouseMove: (e: MouseEvent) => void;
+    onMouseUp: () => void;
+    reset: () => void;
+};

package/dist/composables/useMultiSelect.js

@@ -0,0 +1,108 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useMultiSelect = useMultiSelect;
+var _vueDemi = require("vue-demi");
+var _constants = require("../constants");
+const LEAF_TAGS = /* @__PURE__ */new Set(["button", "a", "input", "img"]);
+function useMultiSelect(mode, transitionFn) {
+  const selectionRect = (0, _vueDemi.ref)(null);
+  const selectedElements = (0, _vueDemi.ref)([]);
+  let startX = 0;
+  let startY = 0;
+  let cachedElements = [];
+  let rafId = null;
+  function cacheElements() {
+    cachedElements = [];
+    for (const el of document.querySelectorAll("body *")) {
+      if (el.closest(_constants.VA_DATA_ATTR_SELECTOR)) continue;
+      const rect = el.getBoundingClientRect();
+      if (rect.width === 0 || rect.height === 0) continue;
+      const isLeaf = el.children.length === 0 || LEAF_TAGS.has(el.tagName.toLowerCase());
+      if (isLeaf) {
+        cachedElements.push({
+          el,
+          rect,
+          isLeaf
+        });
+      }
+    }
+  }
+  function onMouseDown(e) {
+    if (mode.value !== "inspect" || !e.shiftKey) return false;
+    e.preventDefault();
+    document.documentElement.style.userSelect = "none";
+    startX = e.clientX;
+    startY = e.clientY;
+    selectionRect.value = {
+      x: startX,
+      y: startY,
+      width: 0,
+      height: 0
+    };
+    transitionFn("multi-selecting");
+    cacheElements();
+    return true;
+  }
+  function onMouseMove(e) {
+    if (mode.value !== "multi-selecting") return;
+    const x = Math.min(startX, e.clientX);
+    const y = Math.min(startY, e.clientY);
+    const width = Math.abs(e.clientX - startX);
+    const height = Math.abs(e.clientY - startY);
+    selectionRect.value = {
+      x,
+      y,
+      width,
+      height
+    };
+    if (rafId !== null) return;
+    rafId = requestAnimationFrame(() => {
+      rafId = null;
+      collectIntersectedElements();
+    });
+  }
+  function onMouseUp() {
+    if (mode.value !== "multi-selecting") return;
+    document.documentElement.style.userSelect = "";
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+    collectIntersectedElements();
+  }
+  function collectIntersectedElements() {
+    if (!selectionRect.value) return;
+    const rect = selectionRect.value;
+    const intersected = [];
+    for (const {
+      el,
+      rect: elRect
+    } of cachedElements) {
+      if (elRect.left < rect.x + rect.width && elRect.right > rect.x && elRect.top < rect.y + rect.height && elRect.bottom > rect.y) {
+        intersected.push(el);
+      }
+    }
+    selectedElements.value = intersected;
+  }
+  function reset() {
+    selectionRect.value = null;
+    selectedElements.value = [];
+    cachedElements = [];
+    document.documentElement.style.userSelect = "";
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+  }
+  return {
+    selectionRect,
+    selectedElements,
+    onMouseDown,
+    onMouseMove,
+    onMouseUp,
+    reset
+  };
+}

package/dist/composables/useMultiSelect.mjs

@@ -0,0 +1,85 @@
+import { ref } from "vue-demi";
+import { VA_DATA_ATTR_SELECTOR } from "../constants.mjs";
+const LEAF_TAGS = /* @__PURE__ */ new Set(["button", "a", "input", "img"]);
+export function useMultiSelect(mode, transitionFn) {
+  const selectionRect = ref(null);
+  const selectedElements = ref([]);
+  let startX = 0;
+  let startY = 0;
+  let cachedElements = [];
+  let rafId = null;
+  function cacheElements() {
+    cachedElements = [];
+    for (const el of document.querySelectorAll("body *")) {
+      if (el.closest(VA_DATA_ATTR_SELECTOR))
+        continue;
+      const rect = el.getBoundingClientRect();
+      if (rect.width === 0 || rect.height === 0)
+        continue;
+      const isLeaf = el.children.length === 0 || LEAF_TAGS.has(el.tagName.toLowerCase());
+      if (isLeaf) {
+        cachedElements.push({ el, rect, isLeaf });
+      }
+    }
+  }
+  function onMouseDown(e) {
+    if (mode.value !== "inspect" || !e.shiftKey)
+      return false;
+    e.preventDefault();
+    document.documentElement.style.userSelect = "none";
+    startX = e.clientX;
+    startY = e.clientY;
+    selectionRect.value = { x: startX, y: startY, width: 0, height: 0 };
+    transitionFn("multi-selecting");
+    cacheElements();
+    return true;
+  }
+  function onMouseMove(e) {
+    if (mode.value !== "multi-selecting")
+      return;
+    const x = Math.min(startX, e.clientX);
+    const y = Math.min(startY, e.clientY);
+    const width = Math.abs(e.clientX - startX);
+    const height = Math.abs(e.clientY - startY);
+    selectionRect.value = { x, y, width, height };
+    if (rafId !== null)
+      return;
+    rafId = requestAnimationFrame(() => {
+      rafId = null;
+      collectIntersectedElements();
+    });
+  }
+  function onMouseUp() {
+    if (mode.value !== "multi-selecting")
+      return;
+    document.documentElement.style.userSelect = "";
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+    collectIntersectedElements();
+  }
+  function collectIntersectedElements() {
+    if (!selectionRect.value)
+      return;
+    const rect = selectionRect.value;
+    const intersected = [];
+    for (const { el, rect: elRect } of cachedElements) {
+      if (elRect.left < rect.x + rect.width && elRect.right > rect.x && elRect.top < rect.y + rect.height && elRect.bottom > rect.y) {
+        intersected.push(el);
+      }
+    }
+    selectedElements.value = intersected;
+  }
+  function reset() {
+    selectionRect.value = null;
+    selectedElements.value = [];
+    cachedElements = [];
+    document.documentElement.style.userSelect = "";
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+  }
+  return { selectionRect, selectedElements, onMouseDown, onMouseMove, onMouseUp, reset };
+}

package/dist/composables/useOutputFormatter.d.ts

@@ -0,0 +1,5 @@
+import type { Annotation, OutputDetail } from '../types';
+export declare function formatAnnotations(annotations: Annotation[], detail: OutputDetail, pageUrl: string): string;
+export declare function useOutputFormatter(): {
+    formatAnnotations: typeof formatAnnotations;
+};

package/dist/composables/useOutputFormatter.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatAnnotations = formatAnnotations;
+exports.useOutputFormatter = useOutputFormatter;
+function formatAnnotations(annotations, detail, pageUrl) {
+  const shortUrl = pageUrl.replace(/^https?:\/\//, "");
+  const lines = [];
+  lines.push(`## Feedback \u2014 ${shortUrl}`);
+  lines.push("");
+  if (detail === "forensic") {
+    const viewport = typeof window !== "undefined" ? `${window.innerWidth}x${window.innerHeight}` : "unknown";
+    const userAgent = typeof navigator !== "undefined" ? navigator.userAgent : "unknown";
+    const dpr = typeof window !== "undefined" ? String(window.devicePixelRatio) : "unknown";
+    lines.push("### Environment");
+    lines.push(`- **Viewport:** ${viewport}`);
+    lines.push(`- **URL:** ${pageUrl}`);
+    lines.push(`- **User Agent:** ${userAgent}`);
+    lines.push(`- **Timestamp:** ${(/* @__PURE__ */new Date()).toISOString()}`);
+    lines.push(`- **Device Pixel Ratio:** ${dpr}`);
+    lines.push("");
+  }
+  for (let i = 0; i < annotations.length; i++) {
+    const ann = annotations[i];
+    const num = i + 1;
+    if (ann.selectedText) {
+      lines.push(`### ${num}. "${ann.selectedText}" (selected text)`);
+    } else if (ann.isMultiSelect) {
+      lines.push(`### ${num}. Multi-selection (${ann.elements?.length || 0} elements)`);
+    } else if (ann.isAreaSelect) {
+      lines.push(`### ${num}. Area selection`);
+    } else {
+      lines.push(`### ${num}. \`${ann.element}\` \u2014 ${ann.elementPath}`);
+    }
+    lines.push(`- **Comment:** ${ann.comment}`);
+    if (ann.selectedText) {
+      lines.push(`- **In element:** \`${ann.element}\` \u2014 ${ann.elementPath}`);
+    }
+    if (ann.isMultiSelect && ann.elements) {
+      lines.push(`- **Elements:**`);
+      for (const el of ann.elements) {
+        lines.push(`  - \`${el.element}\` \u2014 ${el.elementPath}`);
+      }
+    }
+    if (ann.isAreaSelect && ann.area) {
+      lines.push(`- **Area:** x: ${Math.round(ann.area.x)}, y: ${Math.round(ann.area.y)}, width: ${Math.round(ann.area.width)}, height: ${Math.round(ann.area.height)}`);
+    }
+    if ((ann.isAreaSelect || ann.isMultiSelect) && ann.elementPath) {
+      lines.push(`- **Selection path:** ${ann.elementPath}`);
+    }
+    if ((ann.isAreaSelect || ann.isMultiSelect) && ann.boundingBox) {
+      const b = ann.boundingBox;
+      lines.push(`- **Selection box:** x: ${Math.round(b.x)}, y: ${Math.round(b.y)}, width: ${Math.round(b.width)}, height: ${Math.round(b.height)}`);
+    }
+    if (ann.vueComponents) {
+      lines.push(`- **Components:** ${ann.vueComponents}`);
+    }
+    if (!ann.isMultiSelect && !ann.isAreaSelect && !ann.selectedText) {
+      if (ann.elementPath) {
+        lines.push(`- **Path:** ${ann.elementPath}`);
+      }
+    }
+    if (ann.nearbyElements) {
+      lines.push(`- **Nearby:** ${ann.nearbyElements}`);
+    }
+    if (ann.nearbyText && !ann.selectedText) {
+      lines.push(`- **Context:** ${ann.nearbyText}`);
+    }
+    if (detail === "forensic") {
+      if (ann.fullPath) {
+        lines.push(`- **Full path:** ${ann.fullPath}`);
+      }
+      if (ann.cssClasses) {
+        lines.push(`- **CSS classes:** ${ann.cssClasses}`);
+      }
+      if (ann.boundingBox) {
+        const b = ann.boundingBox;
+        lines.push(`- **Bounding box:** x: ${Math.round(b.x)}, y: ${Math.round(b.y)}, width: ${Math.round(b.width)}, height: ${Math.round(b.height)}`);
+      }
+      if (ann.computedStyles) {
+        lines.push(`- **Computed styles:**`);
+        for (const line of ann.computedStyles.split("\n")) {
+          lines.push(`  - ${line}`);
+        }
+      }
+      if (ann.accessibility) {
+        lines.push(`- **Accessibility:** ${ann.accessibility}`);
+      }
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function useOutputFormatter() {
+  return {
+    formatAnnotations
+  };
+}

package/dist/composables/useOutputFormatter.mjs

@@ -0,0 +1,91 @@
+export function formatAnnotations(annotations, detail, pageUrl) {
+  const shortUrl = pageUrl.replace(/^https?:\/\//, "");
+  const lines = [];
+  lines.push(`## Feedback \u2014 ${shortUrl}`);
+  lines.push("");
+  if (detail === "forensic") {
+    const viewport = typeof window !== "undefined" ? `${window.innerWidth}x${window.innerHeight}` : "unknown";
+    const userAgent = typeof navigator !== "undefined" ? navigator.userAgent : "unknown";
+    const dpr = typeof window !== "undefined" ? String(window.devicePixelRatio) : "unknown";
+    lines.push("### Environment");
+    lines.push(`- **Viewport:** ${viewport}`);
+    lines.push(`- **URL:** ${pageUrl}`);
+    lines.push(`- **User Agent:** ${userAgent}`);
+    lines.push(`- **Timestamp:** ${(/* @__PURE__ */ new Date()).toISOString()}`);
+    lines.push(`- **Device Pixel Ratio:** ${dpr}`);
+    lines.push("");
+  }
+  for (let i = 0; i < annotations.length; i++) {
+    const ann = annotations[i];
+    const num = i + 1;
+    if (ann.selectedText) {
+      lines.push(`### ${num}. "${ann.selectedText}" (selected text)`);
+    } else if (ann.isMultiSelect) {
+      lines.push(`### ${num}. Multi-selection (${ann.elements?.length || 0} elements)`);
+    } else if (ann.isAreaSelect) {
+      lines.push(`### ${num}. Area selection`);
+    } else {
+      lines.push(`### ${num}. \`${ann.element}\` \u2014 ${ann.elementPath}`);
+    }
+    lines.push(`- **Comment:** ${ann.comment}`);
+    if (ann.selectedText) {
+      lines.push(`- **In element:** \`${ann.element}\` \u2014 ${ann.elementPath}`);
+    }
+    if (ann.isMultiSelect && ann.elements) {
+      lines.push(`- **Elements:**`);
+      for (const el of ann.elements) {
+        lines.push(`  - \`${el.element}\` \u2014 ${el.elementPath}`);
+      }
+    }
+    if (ann.isAreaSelect && ann.area) {
+      lines.push(`- **Area:** x: ${Math.round(ann.area.x)}, y: ${Math.round(ann.area.y)}, width: ${Math.round(ann.area.width)}, height: ${Math.round(ann.area.height)}`);
+    }
+    if ((ann.isAreaSelect || ann.isMultiSelect) && ann.elementPath) {
+      lines.push(`- **Selection path:** ${ann.elementPath}`);
+    }
+    if ((ann.isAreaSelect || ann.isMultiSelect) && ann.boundingBox) {
+      const b = ann.boundingBox;
+      lines.push(`- **Selection box:** x: ${Math.round(b.x)}, y: ${Math.round(b.y)}, width: ${Math.round(b.width)}, height: ${Math.round(b.height)}`);
+    }
+    if (ann.vueComponents) {
+      lines.push(`- **Components:** ${ann.vueComponents}`);
+    }
+    if (!ann.isMultiSelect && !ann.isAreaSelect && !ann.selectedText) {
+      if (ann.elementPath) {
+        lines.push(`- **Path:** ${ann.elementPath}`);
+      }
+    }
+    if (ann.nearbyElements) {
+      lines.push(`- **Nearby:** ${ann.nearbyElements}`);
+    }
+    if (ann.nearbyText && !ann.selectedText) {
+      lines.push(`- **Context:** ${ann.nearbyText}`);
+    }
+    if (detail === "forensic") {
+      if (ann.fullPath) {
+        lines.push(`- **Full path:** ${ann.fullPath}`);
+      }
+      if (ann.cssClasses) {
+        lines.push(`- **CSS classes:** ${ann.cssClasses}`);
+      }
+      if (ann.boundingBox) {
+        const b = ann.boundingBox;
+        lines.push(`- **Bounding box:** x: ${Math.round(b.x)}, y: ${Math.round(b.y)}, width: ${Math.round(b.width)}, height: ${Math.round(b.height)}`);
+      }
+      if (ann.computedStyles) {
+        lines.push(`- **Computed styles:**`);
+        for (const line of ann.computedStyles.split("\n")) {
+          lines.push(`  - ${line}`);
+        }
+      }
+      if (ann.accessibility) {
+        lines.push(`- **Accessibility:** ${ann.accessibility}`);
+      }
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+export function useOutputFormatter() {
+  return { formatAnnotations };
+}

package/dist/composables/useSettings.d.ts

@@ -0,0 +1,14 @@
+export declare function useSettings(): {
+    settings: {
+        outputDetail: import("../types").OutputDetail;
+        markerColor: string;
+        blockPageInteractions: boolean;
+        autoHideToolbar: boolean;
+        toolbarPlacement: import("../types").ToolbarAnchor;
+        clearAfterCopy: boolean;
+        showComponentTree: boolean;
+        theme: "light" | "dark" | "auto";
+        activationKey: "none" | "Meta" | "Alt" | "Shift";
+    };
+    resetSettings: () => void;
+};

package/dist/composables/useSettings.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSettings = useSettings;
+var _vueDemi = require("vue-demi");
+const STORAGE_KEY = "agentation-vue-settings";
+const defaults = {
+  outputDetail: "standard",
+  markerColor: "#42B883",
+  blockPageInteractions: false,
+  autoHideToolbar: false,
+  toolbarPlacement: "bottom-right",
+  clearAfterCopy: false,
+  showComponentTree: true,
+  theme: "auto",
+  activationKey: "Shift"
+};
+function loadSettings() {
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (stored) return {
+      ...defaults,
+      ...JSON.parse(stored)
+    };
+  } catch {}
+  return {
+    ...defaults
+  };
+}
+const settings = (0, _vueDemi.reactive)(loadSettings());
+(0, _vueDemi.watch)(() => ({
+  ...settings
+}), val => {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(val));
+  } catch {}
+});
+function useSettings() {
+  function resetSettings() {
+    Object.assign(settings, defaults);
+  }
+  return {
+    settings,
+    resetSettings
+  };
+}

package/dist/composables/useSettings.mjs

@@ -0,0 +1,38 @@
+import { reactive, watch } from "vue-demi";
+const STORAGE_KEY = "agentation-vue-settings";
+const defaults = {
+  outputDetail: "standard",
+  markerColor: "#42B883",
+  blockPageInteractions: false,
+  autoHideToolbar: false,
+  toolbarPlacement: "bottom-right",
+  clearAfterCopy: false,
+  showComponentTree: true,
+  theme: "auto",
+  activationKey: "Shift"
+};
+function loadSettings() {
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (stored)
+      return { ...defaults, ...JSON.parse(stored) };
+  } catch {
+  }
+  return { ...defaults };
+}
+const settings = reactive(loadSettings());
+watch(
+  () => ({ ...settings }),
+  (val) => {
+    try {
+      localStorage.setItem(STORAGE_KEY, JSON.stringify(val));
+    } catch {
+    }
+  }
+);
+export function useSettings() {
+  function resetSettings() {
+    Object.assign(settings, defaults);
+  }
+  return { settings, resetSettings };
+}

package/dist/composables/useTextSelection.d.ts

@@ -0,0 +1,11 @@
+import type { Ref } from 'vue-demi';
+import type { InteractionMode } from '../types';
+export interface TextSelectionResult {
+    selectedText: string;
+    range: Range;
+    rect: DOMRect;
+    anchorElement: Element;
+}
+export declare function useTextSelection(mode: Ref<InteractionMode>): {
+    checkTextSelection: (e: MouseEvent) => TextSelectionResult | null;
+};

package/dist/composables/useTextSelection.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useTextSelection = useTextSelection;
+function useTextSelection(mode) {
+  function checkTextSelection(e) {
+    if (mode.value !== "inspect") return null;
+    if (e.shiftKey || e.altKey) return null;
+    const selection = window.getSelection();
+    const selectedText = selection?.toString().trim() ?? "";
+    if (selectedText.length >= 2 && selection?.rangeCount) {
+      const range = selection.getRangeAt(0);
+      const rect = range.getBoundingClientRect();
+      if (rect.width > 5) {
+        const anchorElement = range.commonAncestorContainer instanceof Element ? range.commonAncestorContainer : range.commonAncestorContainer.parentElement;
+        if (anchorElement) {
+          return {
+            selectedText,
+            range,
+            rect,
+            anchorElement
+          };
+        }
+      }
+    }
+    return null;
+  }
+  return {
+    checkTextSelection
+  };
+}

package/dist/composables/useTextSelection.mjs

@@ -0,0 +1,22 @@
+export function useTextSelection(mode) {
+  function checkTextSelection(e) {
+    if (mode.value !== "inspect")
+      return null;
+    if (e.shiftKey || e.altKey)
+      return null;
+    const selection = window.getSelection();
+    const selectedText = selection?.toString().trim() ?? "";
+    if (selectedText.length >= 2 && selection?.rangeCount) {
+      const range = selection.getRangeAt(0);
+      const rect = range.getBoundingClientRect();
+      if (rect.width > 5) {
+        const anchorElement = range.commonAncestorContainer instanceof Element ? range.commonAncestorContainer : range.commonAncestorContainer.parentElement;
+        if (anchorElement) {
+          return { selectedText, range, rect, anchorElement };
+        }
+      }
+    }
+    return null;
+  }
+  return { checkTextSelection };
+}

package/dist/composables/useToolbarAutoHide.d.ts

@@ -0,0 +1,19 @@
+import type { Ref } from 'vue-demi';
+import type { ToolbarAnchor } from './useToolbarDragSnap';
+interface UseToolbarAutoHideOptions {
+    enabled: Ref<boolean>;
+    expanded: Ref<boolean>;
+    isDragging: Ref<boolean>;
+    placement: Ref<ToolbarAnchor>;
+    toolbarEl: Ref<HTMLElement | null>;
+}
+export declare function useToolbarAutoHide(options: UseToolbarAutoHideOptions): {
+    isAutoHideActive: import("vue-demi").ComputedRef<boolean>;
+    isAutoHideRevealed: Ref<boolean, boolean>;
+    onToolbarPointerEnter: () => void;
+    onToolbarPointerLeave: () => void;
+    onToolbarPointerDown: () => void;
+    onToolbarFocusIn: () => void;
+    onToolbarFocusOut: () => void;
+};
+export {};