@supernal/interface 1.0.9 → 1.0.11

package/dist/cjs/src/testing/graph-tester/screenshot/ScreenshotAnnotator.js

@@ -0,0 +1,376 @@
+"use strict";
+/**
+ * Core screenshot annotation capture logic.
+ *
+ * Captures full-page screenshots with element annotations including:
+ * - Bounding boxes (viewport and page coordinates)
+ * - Element metadata (testid, tag, attributes, styles)
+ * - Interaction capabilities
+ * - Element hierarchy (parent/child relationships)
+ * - ARIA attributes for accessibility analysis
+ *
+ * Uses single-pass DOM traversal for efficiency.
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenshotAnnotator = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Screenshot annotator.
+ *
+ * @example
+ * ```typescript
+ * const annotator = new ScreenshotAnnotator({
+ *   outputDir: './screenshots',
+ *   fullPage: true
+ * });
+ *
+ * const result = await annotator.capture(page, '/dashboard');
+ * console.log(`Captured ${result.annotations.length} annotations`);
+ * ```
+ */
+class ScreenshotAnnotator {
+    constructor(config) {
+        this.config = {
+            fullPage: true,
+            includeInvisible: false,
+            minElementSize: 5,
+            detectNavigation: true,
+            captureLoadMetrics: true,
+            ...config,
+        };
+    }
+    /**
+     * Capture annotated screenshot for a page.
+     *
+     * @param page - Playwright page instance
+     * @param route - Route being captured
+     * @param viewportName - Optional viewport name for responsive testing
+     * @returns Annotated screenshot
+     */
+    async capture(page, route, viewportName) {
+        const startTime = Date.now();
+        // Ensure output directory exists
+        await fs.mkdir(this.config.outputDir, { recursive: true });
+        // Capture screenshot
+        const screenshotFilename = this.generateScreenshotFilename(route, viewportName);
+        const screenshotPath = path.join(this.config.outputDir, screenshotFilename);
+        const screenshot = await page.screenshot({
+            path: screenshotPath,
+            fullPage: this.config.fullPage,
+            type: 'png',
+        });
+        // Extract element annotations (single-pass DOM traversal)
+        const annotations = await this.extractAnnotations(page);
+        // Extract page metadata
+        const pageMetadata = await this.extractPageMetadata(page);
+        const result = {
+            route,
+            screenshot: Buffer.from(screenshot),
+            screenshotPath,
+            annotations,
+            pageMetadata,
+            timestamp: new Date(),
+        };
+        // Save annotation JSON
+        const annotationFilename = screenshotFilename.replace('.png', '.json');
+        const annotationPath = path.join(this.config.outputDir, annotationFilename);
+        await fs.writeFile(annotationPath, JSON.stringify(result, null, 2));
+        console.log(`Captured screenshot in ${Date.now() - startTime}ms: ${screenshotPath}`);
+        console.log(`  Annotations: ${annotations.length}`);
+        console.log(`  Annotation JSON: ${annotationPath}`);
+        return result;
+    }
+    /**
+     * Extract element annotations via single-pass DOM traversal.
+     *
+     * @param page - Playwright page instance
+     * @returns Array of element annotations
+     */
+    async extractAnnotations(page) {
+        const config = this.config;
+        // Single-pass DOM traversal in browser context
+        const rawAnnotations = await page.evaluate(({ includeInvisible, minElementSize, detectNavigation }) => {
+            const annotations = [];
+            const elementMap = new Map(); // Element -> ID mapping
+            let idCounter = 0;
+            // Get all elements
+            const allElements = Array.from(document.querySelectorAll('*'));
+            for (const element of allElements) {
+                // Generate unique ID
+                const elementId = `elem-${idCounter++}`;
+                elementMap.set(element, elementId);
+                // Get bounding box
+                const rect = element.getBoundingClientRect();
+                // Skip elements below minimum size
+                if (rect.width < minElementSize || rect.height < minElementSize) {
+                    continue;
+                }
+                // Get computed styles
+                const computedStyle = window.getComputedStyle(element);
+                // Check visibility
+                const isVisible = computedStyle.visibility !== 'hidden' &&
+                    computedStyle.display !== 'none' &&
+                    parseFloat(computedStyle.opacity) > 0 &&
+                    rect.width > 0 &&
+                    rect.height > 0;
+                // Skip invisible elements if configured
+                if (!includeInvisible && !isVisible) {
+                    continue;
+                }
+                // Get viewport bounding box
+                const boundingBox = {
+                    x: rect.left,
+                    y: rect.top,
+                    width: rect.width,
+                    height: rect.height,
+                };
+                // Get page bounding box (for full-page screenshots)
+                const pageBoundingBox = {
+                    x: rect.left + window.scrollX,
+                    y: rect.top + window.scrollY,
+                    width: rect.width,
+                    height: rect.height,
+                };
+                // Get attributes
+                const attributes = {};
+                for (const attr of Array.from(element.attributes)) {
+                    attributes[attr.name] = attr.value;
+                }
+                // Get ARIA attributes
+                const ariaAttributes = {};
+                for (const attr of Array.from(element.attributes)) {
+                    if (attr.name.startsWith('aria-')) {
+                        ariaAttributes[attr.name] = attr.value;
+                    }
+                }
+                // Detect interaction capabilities
+                const interactions = [];
+                const tagName = element.tagName.toLowerCase();
+                // Clickable elements
+                if (tagName === 'button' ||
+                    tagName === 'a' ||
+                    attributes.role === 'button' ||
+                    attributes.onclick ||
+                    computedStyle.cursor === 'pointer') {
+                    interactions.push({ type: 'click', hasHandler: !!attributes.onclick });
+                }
+                // Input elements
+                if (tagName === 'input' ||
+                    tagName === 'textarea' ||
+                    attributes.contenteditable === 'true') {
+                    interactions.push({ type: 'input', hasHandler: true });
+                }
+                // Select elements
+                if (tagName === 'select') {
+                    interactions.push({ type: 'select', hasHandler: true });
+                }
+                // Focusable elements
+                if (element.hasAttribute('tabindex') ||
+                    ['input', 'button', 'a', 'select', 'textarea'].includes(tagName)) {
+                    interactions.push({ type: 'focus', hasHandler: true });
+                }
+                // Hoverable elements (with hover effects)
+                const hoverSelector = `:hover`;
+                if (attributes.onmouseover || attributes.onmouseenter) {
+                    interactions.push({ type: 'hover', hasHandler: true });
+                }
+                // Detect navigation targets
+                let navigationTarget = undefined;
+                if (detectNavigation && tagName === 'a' && attributes.href) {
+                    navigationTarget = {
+                        target: attributes.href,
+                        method: 'link',
+                        href: attributes.href,
+                        opensInNewTab: attributes.target === '_blank',
+                    };
+                }
+                // Get parent ID
+                let parentId = undefined;
+                if (element.parentElement) {
+                    parentId = elementMap.get(element.parentElement);
+                }
+                // Get child IDs
+                const childIds = [];
+                for (const child of Array.from(element.children)) {
+                    const childId = elementMap.get(child);
+                    if (childId) {
+                        childIds.push(childId);
+                    }
+                }
+                // Build annotation
+                const annotation = {
+                    id: elementId,
+                    selector: getCssSelector(element),
+                    testId: attributes['data-testid'],
+                    tagName,
+                    boundingBox,
+                    pageBoundingBox,
+                    computedStyles: {
+                        backgroundColor: computedStyle.backgroundColor,
+                        color: computedStyle.color,
+                        fontFamily: computedStyle.fontFamily,
+                        fontSize: computedStyle.fontSize,
+                        fontWeight: computedStyle.fontWeight,
+                        display: computedStyle.display,
+                        position: computedStyle.position,
+                        opacity: computedStyle.opacity,
+                        visibility: computedStyle.visibility,
+                        border: computedStyle.border,
+                        borderRadius: computedStyle.borderRadius,
+                        padding: computedStyle.padding,
+                        margin: computedStyle.margin,
+                    },
+                    textContent: element.textContent?.trim().substring(0, 200) || undefined,
+                    attributes,
+                    isInteractive: interactions.length > 0,
+                    interactions,
+                    navigationTarget,
+                    parentId,
+                    childIds,
+                    ariaAttributes,
+                    isVisible,
+                    zIndex: parseInt(computedStyle.zIndex) || 0,
+                };
+                annotations.push(annotation);
+            }
+            // Helper: Generate CSS selector for element
+            function getCssSelector(element) {
+                if (element.id) {
+                    return `#${element.id}`;
+                }
+                if (element.getAttribute('data-testid')) {
+                    return `[data-testid="${element.getAttribute('data-testid')}"]`;
+                }
+                const path = [];
+                let current = element;
+                while (current && current.nodeType === Node.ELEMENT_NODE) {
+                    let selector = current.tagName.toLowerCase();
+                    if (current.id) {
+                        selector += `#${current.id}`;
+                        path.unshift(selector);
+                        break;
+                    }
+                    const siblings = current.parentElement
+                        ? Array.from(current.parentElement.children)
+                        : [];
+                    if (siblings.length > 1) {
+                        const index = siblings.indexOf(current) + 1;
+                        selector += `:nth-child(${index})`;
+                    }
+                    path.unshift(selector);
+                    current = current.parentElement;
+                }
+                return path.join(' > ');
+            }
+            return annotations;
+        }, {
+            includeInvisible: this.config.includeInvisible || false,
+            minElementSize: this.config.minElementSize || 5,
+            detectNavigation: this.config.detectNavigation !== false,
+        });
+        return rawAnnotations;
+    }
+    /**
+     * Extract page metadata.
+     *
+     * @param page - Playwright page instance
+     * @returns Page metadata
+     */
+    async extractPageMetadata(page) {
+        const pageData = await page.evaluate(() => {
+            // Get meta tags
+            const metaTags = {};
+            const metaElements = Array.from(document.querySelectorAll('meta'));
+            for (const meta of metaElements) {
+                const name = meta.getAttribute('name') || meta.getAttribute('property') || '';
+                const content = meta.getAttribute('content') || '';
+                if (name) {
+                    metaTags[name] = content;
+                }
+            }
+            // Get page size
+            const pageSize = {
+                width: Math.max(document.body.scrollWidth, document.documentElement.scrollWidth, document.body.offsetWidth, document.documentElement.offsetWidth, document.documentElement.clientWidth),
+                height: Math.max(document.body.scrollHeight, document.documentElement.scrollHeight, document.body.offsetHeight, document.documentElement.offsetHeight, document.documentElement.clientHeight),
+            };
+            // Get load metrics
+            const perfData = performance.getEntriesByType('navigation')[0];
+            const loadMetrics = perfData
+                ? {
+                    domContentLoaded: perfData.domContentLoadedEventEnd - perfData.domContentLoadedEventStart,
+                    loadComplete: perfData.loadEventEnd - perfData.loadEventStart,
+                }
+                : undefined;
+            return {
+                title: document.title,
+                url: window.location.href,
+                metaTags,
+                pageSize,
+                loadMetrics,
+            };
+        });
+        const viewport = page.viewportSize() || { width: 1280, height: 720 };
+        return {
+            ...pageData,
+            viewport,
+        };
+    }
+    /**
+     * Generate screenshot filename from route and viewport.
+     *
+     * @param route - Route path
+     * @param viewportName - Optional viewport name
+     * @returns Sanitized filename
+     */
+    generateScreenshotFilename(route, viewportName) {
+        // Sanitize route for filename
+        let filename = route.replace(/^\//, '').replace(/\//g, '-') || 'home';
+        // Remove query params and hash
+        filename = filename.split('?')[0].split('#')[0];
+        // Add viewport name if provided
+        if (viewportName) {
+            filename = `${filename}-${viewportName}`;
+        }
+        // Add timestamp
+        const timestamp = Date.now();
+        return `${filename}-${timestamp}.png`;
+    }
+}
+exports.ScreenshotAnnotator = ScreenshotAnnotator;
+//# sourceMappingURL=ScreenshotAnnotator.js.map

package/dist/cjs/src/testing/graph-tester/screenshot/ScreenshotAnnotator.js.map

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

package/dist/cjs/src/testing/graph-tester/screenshot/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Screenshot annotation system exports.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanvasAnnotationRenderer = exports.HTMLAnnotationRenderer = exports.ScreenshotAnnotator = void 0;
+var ScreenshotAnnotator_1 = require("./ScreenshotAnnotator");
+Object.defineProperty(exports, "ScreenshotAnnotator", { enumerable: true, get: function () { return ScreenshotAnnotator_1.ScreenshotAnnotator; } });
+var HTMLAnnotationRenderer_1 = require("./HTMLAnnotationRenderer");
+Object.defineProperty(exports, "HTMLAnnotationRenderer", { enumerable: true, get: function () { return HTMLAnnotationRenderer_1.HTMLAnnotationRenderer; } });
+var CanvasAnnotationRenderer_1 = require("./CanvasAnnotationRenderer");
+Object.defineProperty(exports, "CanvasAnnotationRenderer", { enumerable: true, get: function () { return CanvasAnnotationRenderer_1.CanvasAnnotationRenderer; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/testing/graph-tester/screenshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/screenshot/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAG5B,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA"}

package/dist/cjs/src/testing/graph-tester/screenshot/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Types for screenshot annotation system.
+ *
+ * This defines the structure of annotated screenshots with element metadata,
+ * bounding boxes, and AI-ready output format.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/src/testing/graph-tester/screenshot/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/screenshot/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/cjs/src/testing/selectors.js

@@ -17,7 +17,7 @@ exports.testIdEndsWith = testIdEndsWith;
  *
  * @example
  * ```typescript
- * import { Chat } from '../architecture/DemoComponentNames';
+ * import { Chat } from '../architecture/ComponentNames';
  * import { testId } from '@supernal-interface/core/testing';
  *
  * const input = page.locator(testId(Chat.input));

package/dist/esm/src/browser.d.ts

@@ -8,6 +8,10 @@ export { Tool, ToolConfig, ToolMetadata, setDefaultToolReporter } from './decora
 export { ToolProvider, ToolProviderConfig } from './decorators/ToolProvider';
 export { ClickTool, ChangeTool, TypeTool, HoverTool, MultiActionTool, FormTool, setGlobalToolReporter, type ToolExecutionReporter } from './decorators/ToolHelpers';
 export { ToolRegistry } from './background/registry/ToolRegistry';
+export { Component, ComponentConfig } from './decorators/Component';
+export { AITool, TestTool, OnboardingTool, DangerousTool, DestructiveTool, DataReadTool, DataWriteTool, NavigationTool, AIAndTestTool, OnboardingAndTestTool, } from './decorators/SpecializedTools';
+export { ToolPreset, getToolPreset, applyPreset, registerPendingPreset, clearToolPresets, PresetTemplates, createPreset, componentPreset, pathPreset, } from './decorators/ToolPreset';
+export { ToolCategory } from './types/Tool';
 export { useContainer } from './decorators/ContainerHelpers';
 export { getContainer, getAllContainers, isComponentInContainer, findComponentContainers, ContainerRegistry, type ContainerDefinition, type ContainerId } from './background/architecture';
 export { ExposureCollector } from './exposure/ExposureCollector';
@@ -24,4 +28,9 @@ export { createNames, getComponentIds, isComponentId } from './names/createNames
 export type { ComponentId } from './names/createNames';
 export { DOMExecutor } from './execution/DOMExecutor';
 export { useToolBinding } from './react';
+export { AIInterface, type AICommand, type AIResponse } from './ai/AIInterface';
+export { ToolMatcher, type MatchContext } from './ai/ToolMatcher';
+export { ParameterExtractor } from './ai/ParameterExtractor';
+export { ToolExecutor } from './ai/ToolExecutor';
+export { SuggestionEngine } from './ai/SuggestionEngine';
 //# sourceMappingURL=browser.d.ts.map

package/dist/esm/src/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,QAAQ,EACR,qBAAqB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG7G,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,QAAQ,EACR,qBAAqB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EACL,MAAM,EACN,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG7G,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/esm/src/browser.js

@@ -9,6 +9,14 @@ export { Tool, setDefaultToolReporter } from './decorators/Tool.js';
 export { ToolProvider } from './decorators/ToolProvider.js';
 export { ClickTool, ChangeTool, TypeTool, HoverTool, MultiActionTool, FormTool, setGlobalToolReporter } from './decorators/ToolHelpers.js';
 export { ToolRegistry } from './background/registry/ToolRegistry.js';
+// Component decorator
+export { Component } from './decorators/Component.js';
+// Specialized decorators
+export { AITool, TestTool, OnboardingTool, DangerousTool, DestructiveTool, DataReadTool, DataWriteTool, NavigationTool, AIAndTestTool, OnboardingAndTestTool, } from './decorators/SpecializedTools.js';
+// Tool presets
+export { ToolPreset, getToolPreset, applyPreset, registerPendingPreset, clearToolPresets, PresetTemplates, createPreset, componentPreset, pathPreset, } from './decorators/ToolPreset.js';
+// Tool categories
+export { ToolCategory } from './types/Tool.js';
 // Container HOC
 export { useContainer } from './decorators/ContainerHelpers.js';
 // Architecture (generic types and utilities)
@@ -32,6 +40,12 @@ export { DOMExecutor } from './execution/DOMExecutor.js';
 // Note: usePersistedState excluded due to fs/promises dependency in StorageAdapter
 // export { usePersistedState } from './react/usePersistedState.js';
 export { useToolBinding } from './react/index.js';
+// AI (browser-safe)
+export { AIInterface } from './ai/AIInterface.js';
+export { ToolMatcher } from './ai/ToolMatcher.js';
+export { ParameterExtractor } from './ai/ParameterExtractor.js';
+export { ToolExecutor } from './ai/ToolExecutor.js';
+export { SuggestionEngine } from './ai/SuggestionEngine.js';
 // Note: CLI tools, generators, and Node.js-specific functionality
 // are excluded from browser builds
 //# sourceMappingURL=browser.js.map

package/dist/esm/src/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,OAAO,EAAE,IAAI,EAA4B,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAsB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,QAAQ,EACR,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAGlB,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAQpF,+CAA+C;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,2BAA2B;AAC3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/F,uBAAuB;AACvB,cAAc,SAAS,CAAC;AAExB,iCAAiC;AACjC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGlF,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,6BAA6B;AAC7B,mFAAmF;AACnF,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,kEAAkE;AAClE,mCAAmC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,OAAO,EAAE,IAAI,EAA4B,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAsB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,QAAQ,EACR,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AAEpE,yBAAyB;AACzB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,eAAe;AACf,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAGlB,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAQpF,+CAA+C;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,2BAA2B;AAC3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/F,uBAAuB;AACvB,cAAc,SAAS,CAAC;AAExB,iCAAiC;AACjC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGlF,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,6BAA6B;AAC7B,mFAAmF;AACnF,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAmC,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAqB,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,kEAAkE;AAClE,mCAAmC"}

package/dist/esm/src/decorators/ContainerHelpers.d.ts

@@ -4,7 +4,8 @@
  * Wraps a React component to automatically:
  * 1. Register in RuntimeTreeBuilder component hierarchy
  * 2. Update NavigationGraph current context
- * 3. Track container lifecycle (mount/unmount)
+ * 3. Update LocationContext with visible elements
+ * 4. Track container lifecycle (mount/unmount)
  *
  * Zero boilerplate - just wrap your page/modal component.
  */

package/dist/esm/src/decorators/ContainerHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerHelpers.d.ts","sourceRoot":"","sources":["../../../../src/decorators/ContainerHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAexD"}
+{"version":3,"file":"ContainerHelpers.d.ts","sourceRoot":"","sources":["../../../../src/decorators/ContainerHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAmBxD"}

package/dist/esm/src/decorators/ContainerHelpers.js

@@ -4,13 +4,25 @@
  * Wraps a React component to automatically:
  * 1. Register in RuntimeTreeBuilder component hierarchy
  * 2. Update NavigationGraph current context
- * 3. Track container lifecycle (mount/unmount)
+ * 3. Update LocationContext with visible elements
+ * 4. Track container lifecycle (mount/unmount)
  *
  * Zero boilerplate - just wrap your page/modal component.
  */
 import { useEffect } from 'react';
 import { TreeBuilder } from '../background/navigation/RuntimeTreeBuilder.js';
 import { NavigationGraph } from '../background/navigation/NavigationGraph.js';
+/**
+ * Scan the DOM for visible elements with data-testid attributes
+ */
+function getVisibleElements() {
+    if (typeof document === 'undefined')
+        return [];
+    const elements = document.querySelectorAll('[data-testid]');
+    return Array.from(elements)
+        .map(el => el.getAttribute('data-testid'))
+        .filter(Boolean);
+}
 /**
  * Hook to mark a component as a container
  * Call this at the top of your component function
@@ -31,6 +43,9 @@ export function useContainer(containerName) {
         TreeBuilder.enterComponent(containerName);
         const graph = NavigationGraph.getInstance();
         graph.setCurrentContext(containerName);
+        // DO NOT touch LocationContext here - let useLocationTracking handle it
+        // Calling LocationContext.setCurrent() here creates a race condition
+        // that clears the elements array populated by useLocationTracking
         console.log(`📦 [Container] Registered: ${containerName}`);
         // Cleanup on unmount
         return () => {

package/dist/esm/src/decorators/ContainerHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerHelpers.js","sourceRoot":"","sources":["../../../../src/decorators/ContainerHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB;IAChD,SAAS,CAAC,GAAG,EAAE;QACb,qBAAqB;QACrB,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;QAC5C,KAAK,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAEvC,OAAO,CAAC,GAAG,CAAC,8BAA8B,aAAa,EAAE,CAAC,CAAC;QAE3D,qBAAqB;QACrB,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,aAAa,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,gCAAgC,aAAa,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;AACtB,CAAC"}
+{"version":3,"file":"ContainerHelpers.js","sourceRoot":"","sources":["../../../../src/decorators/ContainerHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAG3E;;GAEG;AACH,SAAS,kBAAkB;IACzB,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;SACxB,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;SACzC,MAAM,CAAC,OAAO,CAAa,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB;IAChD,SAAS,CAAC,GAAG,EAAE;QACb,qBAAqB;QACrB,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;QAC5C,KAAK,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAEvC,wEAAwE;QACxE,qEAAqE;QACrE,kEAAkE;QAElE,OAAO,CAAC,GAAG,CAAC,8BAA8B,aAAa,EAAE,CAAC,CAAC;QAE3D,qBAAqB;QACrB,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,aAAa,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,gCAAgC,aAAa,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;AACtB,CAAC"}

package/dist/esm/src/decorators/Tool.d.ts.map

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

package/dist/esm/src/decorators/Tool.js

@@ -117,10 +117,9 @@ function decorateStandaloneFunction(func, config) {
         ToolRegistry.registerTool(providerName, uniqueFunctionId, toolMetadata);
     }
     catch (error) {
-        console.error('Failed to register tool:', toolMetadata.name, error);
+        DEBUG && console.error('Failed to register tool:', toolMetadata.name, error);
     }
-    DEBUG &&
-        console.log(`[Tool] Registered function: ${toolMetadata.name} (${toolMetadata.category})`);
+    DEBUG && console.log(`[Tool] Registered function: ${toolMetadata.name} (${toolMetadata.category})`);
     // Return a wrapped function that preserves the original's return value
     // This ensures the function's return value is properly propagated to callers
     const wrappedFunction = async function (...args) {