@liuovo/agentation-vue-ui 0.0.2

package/dist/composables/useKeyboard.js

@@ -0,0 +1,122 @@
+import { onMounted, onUnmounted } from "vue";
+// ---------------------------------------------------------------------------
+// Keyboard shortcuts composable
+// ---------------------------------------------------------------------------
+/**
+ * Registers global keyboard shortcuts scoped to the agentation overlay.
+ *
+ * Global shortcuts (work with modifiers):
+ * - `Cmd/Ctrl+Shift+F`: Toggle annotation mode
+ *
+ * Single-key shortcuts (ignored while typing):
+ * - `P`: Toggle animation freeze
+ * - `H`: Toggle marker visibility
+ * - `C`: Copy the currently selected export format
+ * - `X`: Clear all annotations
+ * - `Escape`: Dismiss popover → deselect → disable annotation mode
+ *
+ * Must be called inside a Vue component `setup()`.
+ */
+export function useKeyboardShortcuts(deps) {
+    const { store, selection, overlay, settings, exportActions, freezeState } = deps;
+    function isOwnElement(el) {
+        return !!el.closest("[data-agentation-root]");
+    }
+    function onKeydown(e) {
+        if (e.isComposing)
+            return;
+        const active = document.activeElement;
+        // Cmd/Ctrl+Shift+F → toggle annotation mode
+        if ((e.metaKey || e.ctrlKey) && e.shiftKey && e.code === "KeyF") {
+            e.preventDefault();
+            store.enabled = !store.enabled;
+            if (!store.enabled) {
+                selection.clearHovered();
+                selection.clearSelection();
+                overlay.hidePopover();
+            }
+            return;
+        }
+        // Escape — priority chain
+        if (e.key === "Escape") {
+            if (isEditableField(active) && !isOwnElement(active))
+                return;
+            // 1. Dismiss popover if visible
+            if (overlay.popoverVisible) {
+                e.preventDefault();
+                selection.clearSelection();
+                overlay.hidePopover();
+                return;
+            }
+            // 2. Deselect if selected
+            if (selection.selected) {
+                e.preventDefault();
+                selection.clearSelection();
+                return;
+            }
+            // 3. Disable annotation mode
+            if (store.enabled) {
+                e.preventDefault();
+                store.enabled = false;
+                selection.clearHovered();
+                return;
+            }
+        }
+        // --- Single-key shortcuts (skip while typing or with modifiers) ------
+        if (isEditableField(active) || isEditableField(e.target))
+            return;
+        if (e.metaKey || e.ctrlKey || e.altKey)
+            return;
+        const key = e.key.toLowerCase();
+        // P → toggle animation freeze (works even with 0 annotations)
+        if (key === "p") {
+            e.preventDefault();
+            freezeState?.toggleFreeze();
+            return;
+        }
+        if (store.annotations.length === 0)
+            return;
+        // H → toggle marker visibility
+        if (key === "h") {
+            e.preventDefault();
+            settings.showMarkers = !settings.showMarkers;
+            return;
+        }
+        // C → copy current export format
+        if (key === "c") {
+            e.preventDefault();
+            if (settings.copyFormat === "json") {
+                void exportActions?.exportJSON();
+            }
+            else {
+                void exportActions?.exportMarkdown();
+            }
+            return;
+        }
+        // X → clear all annotations
+        if (key === "x") {
+            e.preventDefault();
+            store.clearAll();
+            selection.clearHovered();
+            selection.clearSelection();
+            overlay.hidePopover();
+        }
+    }
+    onMounted(() => {
+        document.addEventListener("keydown", onKeydown, true);
+    });
+    onUnmounted(() => {
+        document.removeEventListener("keydown", onKeydown, true);
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isEditableField(target) {
+    return target instanceof HTMLElement
+        && (target.tagName === "INPUT"
+            || target.tagName === "TEXTAREA"
+            || target.tagName === "SELECT"
+            || target.isContentEditable);
+}
+//# sourceMappingURL=useKeyboard.js.map

package/dist/composables/useKeyboard.js.map

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

package/dist/composables/useOverlay.d.ts

@@ -0,0 +1,27 @@
+import type { AnnotationV2 } from "@liuovo/agentation-vue-core";
+import type { SelectionState } from "./useSelection.js";
+export interface OverlayPosition {
+    top: number;
+    left: number;
+}
+export interface OverlayState {
+    readonly popoverVisible: boolean;
+    readonly popoverPosition: OverlayPosition | null;
+    /** The annotation currently being edited, or null for create mode. */
+    readonly editingAnnotation: AnnotationV2 | null;
+    /** Incremented when a visible popover should replay its attention animation. */
+    readonly shakeTick?: number;
+    showPopover(): void;
+    hidePopover(): void;
+    /** Open the popover in edit mode, anchored to the given rect. */
+    showEditPopover(annotation: AnnotationV2, anchorRect: DOMRectReadOnly): void;
+}
+/**
+ * Creates overlay state driven by the selection state.
+ *
+ * The popover becomes visible when `showPopover()` is called
+ * (typically right after `select()`), and auto-positions itself
+ * relative to the selected element's bounding rect.
+ */
+export declare function createOverlayState(selection: SelectionState): OverlayState;
+//# sourceMappingURL=useOverlay.d.ts.map

package/dist/composables/useOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlay.d.ts","sourceRoot":"","sources":["../../src/composables/useOverlay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAWvD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAA;IAChD,sEAAsE;IACtE,QAAQ,CAAC,iBAAiB,EAAE,YAAY,GAAG,IAAI,CAAA;IAC/C,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,IAAI,IAAI,CAAA;IACnB,WAAW,IAAI,IAAI,CAAA;IACnB,iEAAiE;IACjE,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;CAC7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,GAAG,YAAY,CAmE1E"}

package/dist/composables/useOverlay.js

@@ -0,0 +1,93 @@
+import { computed, reactive } from "vue";
+// ---------------------------------------------------------------------------
+// Overlay state — manages popover visibility & position
+// ---------------------------------------------------------------------------
+const POPOVER_OFFSET = 12;
+const POPOVER_MARGIN = 12;
+const POPOVER_WIDTH = 280;
+const POPOVER_HEIGHT = 260;
+/**
+ * Creates overlay state driven by the selection state.
+ *
+ * The popover becomes visible when `showPopover()` is called
+ * (typically right after `select()`), and auto-positions itself
+ * relative to the selected element's bounding rect.
+ */
+export function createOverlayState(selection) {
+    const state = reactive({
+        visible: false,
+        editingAnnotation: null,
+        editAnchorRect: null,
+        shakeTick: 0,
+    });
+    const popoverVisible = computed(() => state.visible && (selection.selected !== null || state.editingAnnotation !== null));
+    const popoverPosition = computed(() => {
+        if (!popoverVisible.value)
+            return null;
+        // Edit mode: use the anchor rect from the marker
+        if (state.editingAnnotation && state.editAnchorRect) {
+            return computePopoverPosition(state.editAnchorRect);
+        }
+        // Create mode: use the selected element's rect
+        if (selection.selected) {
+            return computePopoverPosition(selection.selected.rect);
+        }
+        return null;
+    });
+    return {
+        get popoverVisible() {
+            return popoverVisible.value;
+        },
+        get popoverPosition() {
+            return popoverPosition.value;
+        },
+        get editingAnnotation() {
+            return state.editingAnnotation;
+        },
+        get shakeTick() {
+            return state.shakeTick;
+        },
+        showPopover() {
+            if (!selection.selected)
+                return;
+            if (state.visible) {
+                state.shakeTick += 1;
+            }
+            state.editingAnnotation = null;
+            state.editAnchorRect = null;
+            state.visible = true;
+        },
+        hidePopover() {
+            state.visible = false;
+            state.editingAnnotation = null;
+            state.editAnchorRect = null;
+        },
+        showEditPopover(annotation, anchorRect) {
+            if (state.visible) {
+                state.shakeTick += 1;
+            }
+            state.editingAnnotation = annotation;
+            state.editAnchorRect = anchorRect;
+            state.visible = true;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Position computation
+// ---------------------------------------------------------------------------
+function computePopoverPosition(rect) {
+    const vw = typeof window !== "undefined" ? window.innerWidth : 1024;
+    const vh = typeof window !== "undefined" ? window.innerHeight : 768;
+    // Prefer below the element
+    const preferredTop = rect.bottom + POPOVER_OFFSET;
+    const fallbackTop = Math.max(POPOVER_MARGIN, rect.top - POPOVER_HEIGHT - POPOVER_OFFSET);
+    const top = preferredTop + POPOVER_HEIGHT <= vh - POPOVER_MARGIN
+        ? preferredTop
+        : fallbackTop;
+    // Center horizontally, clamped to viewport
+    const maxLeft = Math.max(POPOVER_MARGIN, vw - POPOVER_WIDTH - POPOVER_MARGIN);
+    const centeredLeft = rect.left + rect.width / 2 - POPOVER_WIDTH / 2;
+    const left = Math.min(Math.max(centeredLeft, POPOVER_MARGIN), maxLeft);
+    return { top, left };
+}
+//# sourceMappingURL=useOverlay.js.map

package/dist/composables/useOverlay.js.map

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

package/dist/composables/useSelection.d.ts

@@ -0,0 +1,17 @@
+import type { HoverSnapshot, SelectionSnapshot } from "../types.js";
+export interface SelectionState {
+    readonly hovered: HoverSnapshot | null;
+    readonly selected: SelectionSnapshot | null;
+    setHovered(snapshot: HoverSnapshot): void;
+    clearHovered(): void;
+    select(snapshot: SelectionSnapshot): void;
+    clearSelection(): void;
+}
+/**
+ * Creates a singleton selection state manager.
+ *
+ * Called once by OverlayRoot during setup; runtime event listeners
+ * drive state via `setHovered()` / `select()`.
+ */
+export declare function createSelectionState(): SelectionState;
+//# sourceMappingURL=useSelection.d.ts.map

package/dist/composables/useSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection.d.ts","sourceRoot":"","sources":["../../src/composables/useSelection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAMnE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC3C,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;IACzC,YAAY,IAAI,IAAI,CAAA;IACpB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,cAAc,IAAI,IAAI,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAiCrD"}

package/dist/composables/useSelection.js

@@ -0,0 +1,38 @@
+import { reactive } from "vue";
+/**
+ * Creates a singleton selection state manager.
+ *
+ * Called once by OverlayRoot during setup; runtime event listeners
+ * drive state via `setHovered()` / `select()`.
+ */
+export function createSelectionState() {
+    const state = reactive({
+        hovered: null,
+        selected: null,
+    });
+    return {
+        get hovered() {
+            return state.hovered;
+        },
+        get selected() {
+            return state.selected;
+        },
+        setHovered(snapshot) {
+            // Suppress hover updates while an element is selected
+            if (state.selected)
+                return;
+            state.hovered = snapshot;
+        },
+        clearHovered() {
+            state.hovered = null;
+        },
+        select(snapshot) {
+            state.selected = snapshot;
+            state.hovered = null;
+        },
+        clearSelection() {
+            state.selected = null;
+        },
+    };
+}
+//# sourceMappingURL=useSelection.js.map

package/dist/composables/useSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection.js","sourceRoot":"","sources":["../../src/composables/useSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AAgB9B;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC;QACrB,OAAO,EAAE,IAA4B;QACrC,QAAQ,EAAE,IAAgC;KAC3C,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,OAAO;YACT,OAAO,KAAK,CAAC,OAAO,CAAA;QACtB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,KAAK,CAAC,QAAQ,CAAA;QACvB,CAAC;QAED,UAAU,CAAC,QAAuB;YAChC,sDAAsD;YACtD,IAAI,KAAK,CAAC,QAAQ;gBAAE,OAAM;YAC1B,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAA;QAC1B,CAAC;QAED,YAAY;YACV,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;QACtB,CAAC;QAED,MAAM,CAAC,QAA2B;YAChC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;YACzB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;QACtB,CAAC;QAED,cAAc;YACZ,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/composables/useSettings.d.ts

@@ -0,0 +1,75 @@
+import type { OutputDetailLevel } from "@liuovo/agentation-vue-core";
+import type { Locale } from "../i18n/types.js";
+export declare const COLOR_OPTIONS: readonly [{
+    readonly key: "purple";
+    readonly value: "#AF52DE";
+}, {
+    readonly key: "blue";
+    readonly value: "#3c82f7";
+}, {
+    readonly key: "cyan";
+    readonly value: "#5AC8FA";
+}, {
+    readonly key: "green";
+    readonly value: "#34C759";
+}, {
+    readonly key: "yellow";
+    readonly value: "#FFD60A";
+}, {
+    readonly key: "orange";
+    readonly value: "#FF9500";
+}, {
+    readonly key: "red";
+    readonly value: "#FF3B30";
+}];
+export declare const DEFAULT_ANNOTATION_COLOR = "#3c82f7";
+export type CopyFormat = "json" | "markdown";
+export interface SettingsState {
+    /** Level of detail in export output. */
+    outputDetail: OutputDetailLevel;
+    /** Whether dark mode is active. */
+    darkMode: boolean;
+    /** Whether annotation mode is enabled on load. */
+    enabled: boolean;
+    /** Whether component source resolution is shown. */
+    componentSourceEnabled: boolean;
+    /** Accent colour for annotation markers. */
+    annotationColor: string;
+    /** Whether annotation markers are visible. */
+    showMarkers: boolean;
+    /** Preferred export format for copy actions. */
+    copyFormat: CopyFormat;
+    /** Whether to clear annotations after a successful copy. */
+    autoClearAfterCopy: boolean;
+    /** Whether page interactions are blocked while annotating. */
+    blockInteractions: boolean;
+    /** Current UI locale. */
+    locale: Locale;
+    /** Webhook endpoint URL. */
+    webhookUrl: string;
+    /** Whether webhooks auto-send is enabled. */
+    webhooksEnabled: boolean;
+    /** Toggle between dark and light mode. */
+    toggleDarkMode(): void;
+}
+interface PersistedSettings {
+    outputDetail?: OutputDetailLevel;
+    darkMode?: boolean;
+    enabled?: boolean;
+    componentSourceEnabled?: boolean;
+    annotationColor?: string;
+    showMarkers?: boolean;
+    copyFormat?: CopyFormat;
+    autoClearAfterCopy?: boolean;
+    blockInteractions?: boolean;
+    locale?: Locale;
+    webhookUrl?: string;
+    webhooksEnabled?: boolean;
+}
+/**
+ * Creates the settings state with layered priority:
+ *   plugin config < localStorage < runtime toggle
+ */
+export declare function createSettingsState(defaults?: Partial<PersistedSettings>): SettingsState;
+export {};
+//# sourceMappingURL=useSettings.d.ts.map

package/dist/composables/useSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettings.d.ts","sourceRoot":"","sources":["../../src/composables/useSettings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,OAAO,KAAK,EAAY,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAQxD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAQ0C,CAAA;AAEpE,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAA;AAE5C,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,YAAY,EAAE,iBAAiB,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAA;IACjB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,sBAAsB,EAAE,OAAO,CAAA;IAC/B,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAA;IACvB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAA;IACpB,gDAAgD;IAChD,UAAU,EAAE,UAAU,CAAA;IACtB,4DAA4D;IAC5D,kBAAkB,EAAE,OAAO,CAAA;IAC3B,8DAA8D;IAC9D,iBAAiB,EAAE,OAAO,CAAA;IAC1B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,eAAe,EAAE,OAAO,CAAA;IAExB,0CAA0C;IAC1C,cAAc,IAAI,IAAI,CAAA;CACvB;AAED,UAAU,iBAAiB;IACzB,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,aAAa,CAoExF"}

package/dist/composables/useSettings.js

@@ -0,0 +1,115 @@
+import { reactive, watch } from "vue";
+import { DEFAULT_LOCALE, isValidLocale } from "../i18n/index.js";
+// ---------------------------------------------------------------------------
+// Settings state — persistent user preferences
+// ---------------------------------------------------------------------------
+const STORAGE_KEY = "agentation-vue-settings";
+export const COLOR_OPTIONS = [
+    { key: "purple", value: "#AF52DE" },
+    { key: "blue", value: "#3c82f7" },
+    { key: "cyan", value: "#5AC8FA" },
+    { key: "green", value: "#34C759" },
+    { key: "yellow", value: "#FFD60A" },
+    { key: "orange", value: "#FF9500" },
+    { key: "red", value: "#FF3B30" },
+];
+export const DEFAULT_ANNOTATION_COLOR = "#3c82f7";
+/**
+ * Creates the settings state with layered priority:
+ *   plugin config < localStorage < runtime toggle
+ */
+export function createSettingsState(defaults) {
+    const persisted = loadSettings();
+    const state = reactive({
+        outputDetail: persisted.outputDetail ?? defaults?.outputDetail ?? "standard",
+        darkMode: persisted.darkMode ?? defaults?.darkMode ?? true,
+        enabled: persisted.enabled ?? defaults?.enabled ?? true,
+        componentSourceEnabled: persisted.componentSourceEnabled ?? defaults?.componentSourceEnabled ?? true,
+        annotationColor: persisted.annotationColor ?? defaults?.annotationColor ?? DEFAULT_ANNOTATION_COLOR,
+        showMarkers: persisted.showMarkers ?? defaults?.showMarkers ?? true,
+        copyFormat: persisted.copyFormat ?? defaults?.copyFormat ?? "markdown",
+        autoClearAfterCopy: persisted.autoClearAfterCopy ?? defaults?.autoClearAfterCopy ?? false,
+        blockInteractions: persisted.blockInteractions ?? defaults?.blockInteractions ?? true,
+        locale: normalizeLocale(persisted.locale) ?? normalizeLocale(defaults?.locale) ?? DEFAULT_LOCALE,
+        webhookUrl: persisted.webhookUrl ?? defaults?.webhookUrl ?? "",
+        webhooksEnabled: persisted.webhooksEnabled ?? defaults?.webhooksEnabled ?? false,
+    });
+    // Persist on every change
+    watch(() => ({
+        outputDetail: state.outputDetail,
+        darkMode: state.darkMode,
+        enabled: state.enabled,
+        componentSourceEnabled: state.componentSourceEnabled,
+        annotationColor: state.annotationColor,
+        showMarkers: state.showMarkers,
+        copyFormat: state.copyFormat,
+        autoClearAfterCopy: state.autoClearAfterCopy,
+        blockInteractions: state.blockInteractions,
+        locale: state.locale,
+        webhookUrl: state.webhookUrl,
+        webhooksEnabled: state.webhooksEnabled,
+    }), (settings) => saveSettings(settings), { deep: true });
+    return {
+        get outputDetail() { return state.outputDetail; },
+        set outputDetail(v) { state.outputDetail = v; },
+        get darkMode() { return state.darkMode; },
+        set darkMode(v) { state.darkMode = v; },
+        get enabled() { return state.enabled; },
+        set enabled(v) { state.enabled = v; },
+        get componentSourceEnabled() { return state.componentSourceEnabled; },
+        set componentSourceEnabled(v) { state.componentSourceEnabled = v; },
+        get annotationColor() { return state.annotationColor; },
+        set annotationColor(v) { state.annotationColor = v; },
+        get showMarkers() { return state.showMarkers; },
+        set showMarkers(v) { state.showMarkers = v; },
+        get copyFormat() { return state.copyFormat; },
+        set copyFormat(v) { state.copyFormat = v; },
+        get autoClearAfterCopy() { return state.autoClearAfterCopy; },
+        set autoClearAfterCopy(v) { state.autoClearAfterCopy = v; },
+        get blockInteractions() { return state.blockInteractions; },
+        set blockInteractions(v) { state.blockInteractions = v; },
+        get locale() { return state.locale; },
+        set locale(v) { state.locale = normalizeLocale(v) ?? DEFAULT_LOCALE; },
+        get webhookUrl() { return state.webhookUrl; },
+        set webhookUrl(v) { state.webhookUrl = v; },
+        get webhooksEnabled() { return state.webhooksEnabled; },
+        set webhooksEnabled(v) { state.webhooksEnabled = v; },
+        toggleDarkMode() {
+            state.darkMode = !state.darkMode;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// localStorage helpers
+// ---------------------------------------------------------------------------
+function normalizeLocale(value) {
+    return isValidLocale(value) ? value : undefined;
+}
+function loadSettings() {
+    if (typeof window === "undefined")
+        return {};
+    try {
+        const raw = window.localStorage.getItem(STORAGE_KEY);
+        if (!raw)
+            return {};
+        const parsed = JSON.parse(raw);
+        return {
+            ...parsed,
+            locale: normalizeLocale(parsed.locale),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function saveSettings(settings) {
+    if (typeof window === "undefined")
+        return;
+    try {
+        window.localStorage.setItem(STORAGE_KEY, JSON.stringify(settings));
+    }
+    catch {
+        // silent — localStorage may be full or disabled
+    }
+}
+//# sourceMappingURL=useSettings.js.map

package/dist/composables/useSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettings.js","sourceRoot":"","sources":["../../src/composables/useSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,CAAA;AAErC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhE,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,WAAW,GAAG,yBAAyB,CAAA;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,GAAG,EAAE,QAAiB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5C,EAAE,GAAG,EAAE,MAAe,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,GAAG,EAAE,MAAe,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,GAAG,EAAE,OAAgB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC3C,EAAE,GAAG,EAAE,QAAiB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5C,EAAE,GAAG,EAAE,QAAiB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5C,EAAE,GAAG,EAAE,KAAc,EAAE,KAAK,EAAE,SAAS,EAAE;CACyB,CAAA;AAEpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAA;AAiDjD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAqC;IACvE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC;QACrB,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,QAAQ,EAAE,YAAY,IAAI,UAAU;QAC5E,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,QAAQ,EAAE,QAAQ,IAAI,IAAI;QAC1D,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,IAAI;QACvD,sBAAsB,EAAE,SAAS,CAAC,sBAAsB,IAAI,QAAQ,EAAE,sBAAsB,IAAI,IAAI;QACpG,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,QAAQ,EAAE,eAAe,IAAI,wBAAwB;QACnG,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW,IAAI,IAAI;QACnE,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,QAAQ,EAAE,UAAU,IAAI,UAAU;QACtE,kBAAkB,EAAE,SAAS,CAAC,kBAAkB,IAAI,QAAQ,EAAE,kBAAkB,IAAI,KAAK;QACzF,iBAAiB,EAAE,SAAS,CAAC,iBAAiB,IAAI,QAAQ,EAAE,iBAAiB,IAAI,IAAI;QACrF,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,cAAc;QAChG,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE;QAC9D,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,QAAQ,EAAE,eAAe,IAAI,KAAK;KACjF,CAAC,CAAA;IAEF,0BAA0B;IAC1B,KAAK,CACH,GAAG,EAAE,CAAC,CAAC;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC,EACF,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EACpC,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAA;IAED,OAAO;QACL,IAAI,YAAY,KAAK,OAAO,KAAK,CAAC,YAAY,CAAA,CAAC,CAAC;QAChD,IAAI,YAAY,CAAC,CAAoB,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,CAAA,CAAC,CAAC;QACjE,IAAI,QAAQ,KAAK,OAAO,KAAK,CAAC,QAAQ,CAAA,CAAC,CAAC;QACxC,IAAI,QAAQ,CAAC,CAAU,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAA,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,OAAO,KAAK,CAAC,OAAO,CAAA,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,CAAU,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,CAAA,CAAC,CAAC;QAC7C,IAAI,sBAAsB,KAAK,OAAO,KAAK,CAAC,sBAAsB,CAAA,CAAC,CAAC;QACpE,IAAI,sBAAsB,CAAC,CAAU,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAA,CAAC,CAAC;QAC3E,IAAI,eAAe,KAAK,OAAO,KAAK,CAAC,eAAe,CAAA,CAAC,CAAC;QACtD,IAAI,eAAe,CAAC,CAAS,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,CAAA,CAAC,CAAC;QAC5D,IAAI,WAAW,KAAK,OAAO,KAAK,CAAC,WAAW,CAAA,CAAC,CAAC;QAC9C,IAAI,WAAW,CAAC,CAAU,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,CAAA,CAAC,CAAC;QACrD,IAAI,UAAU,KAAK,OAAO,KAAK,CAAC,UAAU,CAAA,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,CAAa,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAA,CAAC,CAAC;QACtD,IAAI,kBAAkB,KAAK,OAAO,KAAK,CAAC,kBAAkB,CAAA,CAAC,CAAC;QAC5D,IAAI,kBAAkB,CAAC,CAAU,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAA,CAAC,CAAC;QACnE,IAAI,iBAAiB,KAAK,OAAO,KAAK,CAAC,iBAAiB,CAAA,CAAC,CAAC;QAC1D,IAAI,iBAAiB,CAAC,CAAU,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAA,CAAC,CAAC;QACjE,IAAI,MAAM,KAAK,OAAO,KAAK,CAAC,MAAM,CAAA,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,CAAS,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,cAAc,CAAA,CAAC,CAAC;QAC7E,IAAI,UAAU,KAAK,OAAO,KAAK,CAAC,UAAU,CAAA,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,CAAS,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAA,CAAC,CAAC;QAClD,IAAI,eAAe,KAAK,OAAO,KAAK,CAAC,eAAe,CAAA,CAAC,CAAC;QACtD,IAAI,eAAe,CAAC,CAAU,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,CAAA,CAAC,CAAC;QAE7D,cAAc;YACZ,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAA;QAClC,CAAC;KACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACjD,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAA;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACpD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAA;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6C,CAAA;QAC1E,OAAO;YACL,GAAG,MAAM;YACT,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;SACvC,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAA2B;IAC/C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAM;IACzC,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC"}

package/dist/composables/useToolbarDrag.d.ts

@@ -0,0 +1,28 @@
+import { type ComputedRef, type CSSProperties, type Ref } from "vue";
+export interface ToolbarPosition {
+    x: number;
+    y: number;
+}
+export interface ToolbarDragState {
+    readonly position: Readonly<Ref<ToolbarPosition | null>>;
+    readonly isDragging: Readonly<Ref<boolean>>;
+    readonly justFinishedDrag: Readonly<Ref<boolean>>;
+    readonly toolbarStyle: ComputedRef<CSSProperties | undefined>;
+    bindToolbarRef(element: HTMLElement | null): void;
+    onMouseDown(event: MouseEvent): void;
+    consumeJustFinishedDrag(): boolean;
+    syncConstraints(): void;
+}
+/**
+ * Drag composable for the toolbar, powered by @vueuse/core `useDraggable`.
+ *
+ * Fully reactive — VueUse's `x`/`y` refs are the single source of truth
+ * for position. `toolbarStyle` derives from them so Vue's `:style` binding
+ * and the drag position are always in sync. No direct DOM writes needed.
+ */
+export declare function useToolbarDrag(options?: {
+    padding?: number;
+    toolbarHeight?: number;
+    dragThreshold?: number;
+}): ToolbarDragState;
+//# sourceMappingURL=useToolbarDrag.d.ts.map

package/dist/composables/useToolbarDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarDrag.d.ts","sourceRoot":"","sources":["../../src/composables/useToolbarDrag.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,GAAG,EACT,MAAM,KAAK,CAAA;AAQZ,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAA;IACxD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IAC7D,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA;IACjD,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACpC,uBAAuB,IAAI,OAAO,CAAA;IAClC,eAAe,IAAI,IAAI,CAAA;CACxB;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,gBAAgB,CA6OxB"}