@syntrologie/adapt-overlays 2.4.1 → 2.5.1

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkB/B,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqC7B,2BAA2B;;;;;;;;;;;;;;;;;IAY3B,2BAA2B;;;;;;;;;;;;;;IAW3B,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgC3B,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -3,6 +3,7 @@
  *
  * Zod schema for validating overlays app configuration.
  */
+import { TriggerWhenZ } from '@syntrologie/sdk-contracts';
 import { z } from 'zod';
 /**
  * Overlays app config schema.
@@ -118,3 +119,38 @@ export const configSchema = z.object({
     }))
         .optional(),
 });
+// ============================================================================
+// Celebrate Action Schema
+// ============================================================================
+const CelebrateActionZ = z
+    .object({
+    kind: z.literal('overlays:celebrate'),
+    effect: z.string(),
+    duration: z.number().optional(),
+    intensity: z.enum(['light', 'medium', 'heavy']).optional(),
+    colors: z.array(z.string()).optional(),
+    props: z.record(z.unknown()).optional(),
+    label: z.string().optional(),
+    triggerWhen: TriggerWhenZ,
+})
+    .strict();
+// ============================================================================
+// Unified Schema Export
+// ============================================================================
+export const actionStepSchemas = [{ defName: 'celebrate', schema: CelebrateActionZ }];
+// ============================================================================
+// Tile Widget Definitions
+// ============================================================================
+/**
+ * Tile widget definitions for unified JSON Schema generation.
+ * Maps widget IDs to their props validation schema so the build script
+ * can inject if/then constraints on tile.props.
+ */
+const WorkflowTrackerPropsZ = z.object({}).passthrough();
+export const tileWidgets = [
+    {
+        widget: 'adaptive-overlays:workflow-tracker',
+        defName: 'workflowTrackerProps',
+        propsSchema: WorkflowTrackerPropsZ,
+    },
+];

package/dist/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAezD;AAYD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,cAAc,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAuCR"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAc/C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAezD;AAYD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,cAAc,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAuCR"}

package/dist/summarize.js

@@ -4,6 +4,17 @@
  * Pure functions — no DOM access, just string formatting from config data.
  */
 const MAX_TEXT_LEN = 40;
+/** Extract the CSS selector string from an anchorId (object or legacy string). */
+function resolveAnchorSelector(anchorId) {
+    if (!anchorId)
+        return '';
+    if (typeof anchorId === 'string')
+        return anchorId;
+    if (typeof anchorId === 'object' && 'selector' in anchorId) {
+        return anchorId.selector;
+    }
+    return '';
+}
 /**
  * Convert a CSS selector into a human-friendly element description.
  */
@@ -37,25 +48,25 @@ function truncateQuoted(text, max) {
 export function summarizeOverlayItem(type, item) {
     switch (type) {
         case 'tooltips': {
-            const anchorId = item.anchorId || '';
+            const anchorId = resolveAnchorSelector(item.anchorId);
             const desc = describeSelector(anchorId);
             const content = item.content;
             const body = content?.body || '';
             return `Tooltip on ${desc}: ${truncateQuoted(body, MAX_TEXT_LEN)}`;
         }
         case 'highlights': {
-            const anchorId = item.anchorId || '';
+            const anchorId = resolveAnchorSelector(item.anchorId);
             const desc = describeSelector(anchorId);
             return `Highlight ${desc}`;
         }
         case 'badges': {
-            const anchorId = item.anchorId || '';
+            const anchorId = resolveAnchorSelector(item.anchorId);
             const desc = describeSelector(anchorId);
             const content = item.content || '';
             return `Badge "${content}" on ${desc}`;
         }
         case 'pulses': {
-            const anchorId = item.anchorId || '';
+            const anchorId = resolveAnchorSelector(item.anchorId);
             const desc = describeSelector(anchorId);
             return `Pulse on ${desc}`;
         }

package/dist/tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../src/tooltip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAQL,KAAK,SAAS,EAGf,MAAM,kBAAkB,CAAC;AAI1B,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,IAAI,IAAI,CAAC;IAAC,EAAE,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAyCD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,cAAc,GACnB,aAAa,CAsPf"}
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../src/tooltip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAQL,KAAK,SAAS,EAGf,MAAM,kBAAkB,CAAC;AAI1B,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,IAAI,IAAI,CAAC;IAAC,EAAE,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAyCD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,cAAc,GACnB,aAAa,CAqQf"}

package/dist/tooltip.js

@@ -184,26 +184,40 @@ export function showTooltip(anchorEl, overlayRoot, opts) {
     }
     const attachTrigger = () => {
         if (opts.trigger === 'hover') {
-            const enter = () => {
+            let hideTimeout = null;
+            const show = () => {
+                if (hideTimeout) {
+                    clearTimeout(hideTimeout);
+                    hideTimeout = null;
+                }
                 div.style.visibility = 'visible';
                 div.style.opacity = '1';
             };
-            const leave = () => {
-                div.style.visibility = 'hidden';
-                div.style.opacity = '0';
+            const scheduleHide = () => {
+                hideTimeout = setTimeout(() => {
+                    div.style.visibility = 'hidden';
+                    div.style.opacity = '0';
+                    hideTimeout = null;
+                }, 100);
             };
             div.style.visibility = 'hidden';
             div.style.opacity = '0';
             div.style.transition = 'opacity 200ms ease, visibility 200ms';
-            anchorEl.addEventListener('mouseenter', enter);
-            anchorEl.addEventListener('mouseleave', leave);
-            anchorEl.addEventListener('focus', enter);
-            anchorEl.addEventListener('blur', leave);
+            anchorEl.addEventListener('mouseenter', show);
+            anchorEl.addEventListener('mouseleave', scheduleHide);
+            div.addEventListener('mouseenter', show);
+            div.addEventListener('mouseleave', scheduleHide);
+            anchorEl.addEventListener('focus', show);
+            anchorEl.addEventListener('blur', scheduleHide);
             return () => {
-                anchorEl.removeEventListener('mouseenter', enter);
-                anchorEl.removeEventListener('mouseleave', leave);
-                anchorEl.removeEventListener('focus', enter);
-                anchorEl.removeEventListener('blur', leave);
+                if (hideTimeout)
+                    clearTimeout(hideTimeout);
+                anchorEl.removeEventListener('mouseenter', show);
+                anchorEl.removeEventListener('mouseleave', scheduleHide);
+                div.removeEventListener('mouseenter', show);
+                div.removeEventListener('mouseleave', scheduleHide);
+                anchorEl.removeEventListener('focus', show);
+                anchorEl.removeEventListener('blur', scheduleHide);
             };
         }
         if (opts.trigger === 'click') {

package/dist/tour-types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tour & Workflow Types
+ *
+ * Canonical type definitions for tours and workflows.
+ * These are the source-of-truth types for the overlays adaptive.
+ */
+/** Tour step with route + action mapping */
+export interface TourStep {
+    id: string;
+    action: Record<string, unknown>;
+    route?: string;
+    onAction?: Record<string, string>;
+}
+/** Orchestrate sequential steps with cross-page state */
+export interface TourAction {
+    kind: 'core:tour';
+    label?: string;
+    tourId: string;
+    steps: TourStep[];
+    startStep?: string;
+    autoStart?: boolean;
+}
+/** Metadata for a workflow tile displayed in the WorkflowTracker widget */
+export interface WorkflowMeta {
+    title: string;
+    icon?: string;
+    description?: string;
+    stepTitles?: Record<string, string>;
+    notification: {
+        title: string;
+        body?: string;
+    };
+}
+//# sourceMappingURL=tour-types.d.ts.map

package/dist/tour-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-types.d.ts","sourceRoot":"","sources":["../src/tour-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,4CAA4C;AAC5C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/tour-types.js

@@ -0,0 +1,7 @@
+/**
+ * Tour & Workflow Types
+ *
+ * Canonical type definitions for tours and workflows.
+ * These are the source-of-truth types for the overlays adaptive.
+ */
+export {};

package/dist/types.d.ts

@@ -5,75 +5,14 @@
  * These match the types exported from @syntrologie/runtime-sdk/types.
  */
 import type { Placement } from '@floating-ui/dom';
-export interface EditorPanelProps {
-    config: Record<string, unknown>;
-    onChange: (config: Record<string, unknown>) => void;
-    editor: {
-        setDirty: (dirty: boolean) => void;
-        navigateHome: () => Promise<boolean>;
-        save: () => Promise<void>;
-        publish: (captureScreenshot?: boolean) => Promise<void>;
-        /** Navigate the target page to a different route (preserves editor params). */
-        navigateTo: (route: string) => Promise<void>;
-        /** Show a persistent blue highlight on the element matching this selector. */
-        highlightElement: (selector: string) => void;
-        /** Remove the persistent element highlight. */
-        clearHighlight: () => void;
-        /** Get the current page route (pathname). */
-        getCurrentRoute: () => string;
-        /** Push a temporary config to the live page preview without saving to state. */
-        previewConfig: (config: Record<string, unknown>) => void;
-        /** Global before/after preview mode set by the panel's toggle. */
-        previewMode?: 'before' | 'after';
-        /** Flat action index to open in edit mode (from accordion navigation). */
-        initialEditKey?: string;
-        /** Open the editor in create mode. */
-        initialCreate?: boolean;
-        /** Clear the initial navigation state (call after consuming). */
-        clearInitialState?: () => void;
-        /** Get dismissed keys persisted in navigation context. */
-        getDismissedKeys?: () => Set<string>;
-        /** Sync dismissed keys back to navigation context. */
-        setDismissedKeys?: (keys: Set<string>) => void;
-        /** Register a back handler shown in the panel header. Pass null to clear. */
-        setBackHandler?: (handler: (() => void) | null) => void;
-    };
-    platformClient?: unknown;
-}
-export interface HighlightStyle {
-    color?: string;
-    scrimOpacity?: number;
-    paddingPx?: number;
-    radiusPx?: number;
-}
-export type BadgePosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-/** CTA button configuration for tooltips/modals */
-export interface CtaButton {
-    label: string;
-    actionId: string;
-    primary?: boolean;
-}
-/** Modal content configuration */
-export interface ModalContent {
-    title?: string;
-    body: string;
-}
-export interface TooltipContent {
-    title?: string;
-    body: string;
-    cta?: {
-        label: string;
-        action: unknown;
-    };
-    ctaButtons?: CtaButton[];
-}
-export type TooltipTrigger = 'immediate' | 'hover' | 'click';
+import type { AnchorId, BadgePosition, CtaButton, EditorPanelProps, HighlightStyle, ModalContent, ModalWaitFor, TooltipContent, TooltipTrigger, TooltipWaitFor } from '@syntrologie/sdk-contracts';
+export type { BadgePosition, CtaButton, EditorPanelProps, HighlightStyle, ModalContent, ModalWaitFor, TooltipContent, TooltipTrigger, TooltipWaitFor, };
 interface BaseAction {
     label?: string;
 }
 export interface HighlightAction extends BaseAction {
     kind: 'overlays:highlight';
-    anchorId: string;
+    anchorId: AnchorId;
     style?: HighlightStyle;
     /** Whether the scrim blocks all page interaction (default: false) */
     blocking?: boolean;
@@ -86,28 +25,24 @@ export interface HighlightAction extends BaseAction {
 }
 export interface PulseAction extends BaseAction {
     kind: 'overlays:pulse';
-    anchorId: string;
+    anchorId: AnchorId;
     duration?: number;
 }
 export interface BadgeAction extends BaseAction {
     kind: 'overlays:badge';
-    anchorId: string;
+    anchorId: AnchorId;
     content: string;
     position?: BadgePosition;
 }
-/** Tooltip lifecycle - when the action completes (for sequences) */
-export type TooltipWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
 export interface TooltipAction extends BaseAction {
     kind: 'overlays:tooltip';
-    anchorId: string;
+    anchorId: AnchorId;
     content: TooltipContent;
     trigger?: TooltipTrigger;
     placement?: Placement;
     /** When the action completes (for sequences). Publishes event to EventBus. */
     waitFor?: TooltipWaitFor;
 }
-/** Modal lifecycle - when the action completes (for sequences) */
-export type ModalWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
 export interface ModalAction extends BaseAction {
     kind: 'overlays:modal';
     content: ModalContent;
@@ -125,20 +60,20 @@ export interface ModalAction extends BaseAction {
     /** When the action completes (for sequences). Publishes event to EventBus. */
     waitFor?: ModalWaitFor;
 }
-/** Tour step with route + action mapping */
-export interface TourStep {
-    id: string;
-    action: Record<string, unknown>;
-    route?: string;
-    onAction?: Record<string, string>;
-}
-/** Orchestrate sequential steps with cross-page state */
-export interface TourAction extends BaseAction {
-    kind: 'core:tour';
-    tourId: string;
-    steps: TourStep[];
-    startStep?: string;
-    autoStart?: boolean;
+export interface CelebrateAction extends BaseAction {
+    kind: 'overlays:celebrate';
+    effect: string;
+    duration?: number;
+    intensity?: 'light' | 'medium' | 'heavy';
+    colors?: string[];
+    props?: Record<string, unknown>;
+    activation?: {
+        routes?: {
+            include?: string[];
+            exclude?: string[];
+        };
+    };
 }
+export type { TourAction, TourStep, WorkflowMeta } from './tour-types';
 export type { ActionExecutor, ExecutorCleanup, ExecutorContext, ExecutorResult, ExecutorUpdate, } from '@syntrologie/sdk-contracts';
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/workflow-types.d.ts

@@ -0,0 +1,15 @@
+import type { WorkflowMeta } from './tour-types';
+export type { WorkflowMeta };
+export interface WorkflowEntry {
+    tourId: string;
+    meta: WorkflowMeta;
+    steps: {
+        id: string;
+        title: string;
+    }[];
+    currentStepId: string | null;
+    completedSteps: string[];
+    status: 'active' | 'completed' | 'dismissed';
+    completedAt?: number;
+}
+//# sourceMappingURL=workflow-types.d.ts.map

package/dist/workflow-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-types.d.ts","sourceRoot":"","sources":["../src/workflow-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/workflow-types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@syntrologie/shared-editor-ui/dist/__tests__/AnchorPicker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AnchorPicker.test.d.ts.map

package/node_modules/@syntrologie/shared-editor-ui/dist/__tests__/AnchorPicker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnchorPicker.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/AnchorPicker.test.tsx"],"names":[],"mappings":""}

package/node_modules/@syntrologie/shared-editor-ui/dist/__tests__/AnchorPicker.test.js

@@ -0,0 +1,224 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { act, render } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { AnchorPicker } from '../components/AnchorPicker';
+// Mock ResizeObserver for jsdom
+vi.stubGlobal('ResizeObserver', class {
+    observe() { }
+    unobserve() { }
+    disconnect() { }
+});
+// Mock selectorGenerator utilities
+vi.mock('../utils/selectorGenerator', () => ({
+    generateSelector: vi.fn((el) => `mock-selector-${el.tagName.toLowerCase()}`),
+    validateSelector: vi.fn(() => true),
+    getElementDescription: vi.fn((el) => `mock-desc-${el.tagName.toLowerCase()}`),
+}));
+import { generateSelector, getElementDescription, validateSelector, } from '../utils/selectorGenerator';
+describe('AnchorPicker', () => {
+    let mockElementAtPoint;
+    beforeEach(() => {
+        mockElementAtPoint = document.createElement('div');
+        mockElementAtPoint.textContent = 'Target Element';
+        document.body.appendChild(mockElementAtPoint);
+        vi.spyOn(mockElementAtPoint, 'getBoundingClientRect').mockReturnValue({
+            top: 100,
+            left: 200,
+            width: 300,
+            height: 150,
+            bottom: 250,
+            right: 500,
+            x: 200,
+            y: 100,
+            toJSON: () => ({}),
+        });
+        vi.mocked(generateSelector).mockClear();
+        vi.mocked(validateSelector).mockClear();
+        vi.mocked(getElementDescription).mockClear();
+        vi.mocked(generateSelector).mockImplementation((el) => `mock-selector-${el.tagName.toLowerCase()}`);
+        vi.mocked(validateSelector).mockReturnValue(true);
+        vi.mocked(getElementDescription).mockImplementation((el) => `mock-desc-${el.tagName.toLowerCase()}`);
+        // Stub elementFromPoint on document (jsdom does not define it)
+        if (!document.elementFromPoint) {
+            document.elementFromPoint = vi.fn(() => null);
+        }
+        else {
+            vi.spyOn(document, 'elementFromPoint').mockReturnValue(null);
+        }
+    });
+    afterEach(() => {
+        if (mockElementAtPoint.parentNode) {
+            mockElementAtPoint.remove();
+        }
+        vi.restoreAllMocks();
+    });
+    it('renders nothing when isActive is false', () => {
+        render(_jsx(AnchorPicker, { isActive: false, onPick: vi.fn(), onCancel: vi.fn() }));
+        const picker = document.body.querySelector('[data-syntro-anchor-picker]');
+        expect(picker).toBeNull();
+    });
+    it('renders overlay portal to document.body when active', () => {
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        const picker = document.body.querySelector('[data-syntro-anchor-picker]');
+        expect(picker).toBeTruthy();
+        unmount();
+    });
+    it('sets crosshair cursor on overlay', () => {
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        const picker = document.body.querySelector('[data-syntro-anchor-picker]');
+        expect(picker.style.cursor).toBe('crosshair');
+        unmount();
+    });
+    it('sets highest z-index on overlay', () => {
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        const picker = document.body.querySelector('[data-syntro-anchor-picker]');
+        expect(picker.style.zIndex).toBe('2147483644');
+        unmount();
+    });
+    it('calls onCancel when Escape key is pressed', () => {
+        const onCancel = vi.fn();
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: onCancel }));
+        act(() => {
+            document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }));
+        });
+        expect(onCancel).toHaveBeenCalledTimes(1);
+        unmount();
+    });
+    it('does not call onCancel for non-Escape keys', () => {
+        const onCancel = vi.fn();
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: onCancel }));
+        act(() => {
+            document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }));
+        });
+        expect(onCancel).not.toHaveBeenCalled();
+        unmount();
+    });
+    it('highlights element on mousemove via elementFromPoint', () => {
+        document.elementFromPoint.mockReturnValue(mockElementAtPoint);
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        // generateSelector should have been called with the element
+        expect(generateSelector).toHaveBeenCalledWith(mockElementAtPoint);
+        unmount();
+    });
+    it('clears hover state when elementFromPoint returns null', () => {
+        document.elementFromPoint.mockReturnValue(null);
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        // No highlight should be shown (just the overlay container + the semi-transparent bg div)
+        const picker = document.body.querySelector('[data-syntro-anchor-picker]');
+        expect(picker.children.length).toBe(1);
+        unmount();
+    });
+    it('excludes editor panel elements from picking', () => {
+        const editorPanel = document.createElement('div');
+        editorPanel.setAttribute('data-syntro-editor-panel', '');
+        const innerEl = document.createElement('span');
+        editorPanel.appendChild(innerEl);
+        document.body.appendChild(editorPanel);
+        document.elementFromPoint.mockReturnValue(innerEl);
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 100, clientY: 100, bubbles: true }));
+        });
+        // Should not call generateSelector for excluded elements
+        expect(generateSelector).not.toHaveBeenCalled();
+        editorPanel.remove();
+        unmount();
+    });
+    it('excludes HTML, BODY, HEAD elements from picking', () => {
+        document.elementFromPoint.mockReturnValue(document.body);
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 100, clientY: 100, bubbles: true }));
+        });
+        expect(generateSelector).not.toHaveBeenCalled();
+        unmount();
+    });
+    it('calls onPick with valid selector on click after hover', () => {
+        const onPick = vi.fn();
+        document.elementFromPoint.mockReturnValue(mockElementAtPoint);
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: onPick, onCancel: vi.fn() }));
+        // First hover to set the hovered element
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        // Then click
+        act(() => {
+            document.dispatchEvent(new MouseEvent('click', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        expect(onPick).toHaveBeenCalledTimes(1);
+        expect(onPick).toHaveBeenCalledWith({
+            element: mockElementAtPoint,
+            selector: 'mock-selector-div',
+            description: 'mock-desc-div',
+        });
+        unmount();
+    });
+    it('regenerates selector when validation fails on click', () => {
+        const onPick = vi.fn();
+        document.elementFromPoint.mockReturnValue(mockElementAtPoint);
+        vi.mocked(validateSelector).mockReturnValue(false);
+        vi.mocked(generateSelector).mockReturnValue('regenerated-selector');
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: onPick, onCancel: vi.fn() }));
+        // Hover to set element
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        // Click
+        act(() => {
+            document.dispatchEvent(new MouseEvent('click', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        expect(onPick).toHaveBeenCalledWith(expect.objectContaining({
+            selector: 'regenerated-selector',
+        }));
+        unmount();
+    });
+    it('does not call onPick when no element is hovered on click', () => {
+        const onPick = vi.fn();
+        document.elementFromPoint.mockReturnValue(null);
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: onPick, onCancel: vi.fn() }));
+        act(() => {
+            document.dispatchEvent(new MouseEvent('click', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        expect(onPick).not.toHaveBeenCalled();
+        unmount();
+    });
+    it('removes event listeners when deactivated', () => {
+        const onCancel = vi.fn();
+        const { rerender, unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: onCancel }));
+        // Deactivate
+        rerender(_jsx(AnchorPicker, { isActive: false, onPick: vi.fn(), onCancel: onCancel }));
+        // Escape should not trigger onCancel after deactivation
+        act(() => {
+            document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }));
+        });
+        expect(onCancel).not.toHaveBeenCalled();
+        unmount();
+    });
+    it('temporarily disables pointer events on overlay during mousemove detection', () => {
+        const overlayPointerEvents = [];
+        document.elementFromPoint.mockImplementation(() => {
+            // Capture overlay pointer events state during elementFromPoint call
+            const overlay = document.body.querySelector('[data-syntro-anchor-picker]');
+            if (overlay) {
+                overlayPointerEvents.push(overlay.style.pointerEvents);
+            }
+            return mockElementAtPoint;
+        });
+        const { unmount } = render(_jsx(AnchorPicker, { isActive: true, onPick: vi.fn(), onCancel: vi.fn() }));
+        act(() => {
+            document.dispatchEvent(new MouseEvent('mousemove', { clientX: 250, clientY: 150, bubbles: true }));
+        });
+        // During elementFromPoint, overlay pointerEvents should be 'none'
+        expect(overlayPointerEvents).toContain('none');
+        // After the call, it should be restored to 'auto'
+        const overlay = document.body.querySelector('[data-syntro-anchor-picker]');
+        expect(overlay.style.pointerEvents).toBe('auto');
+        unmount();
+    });
+});