@supernal/interface 1.0.9 → 1.0.12

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/background/navigation/INavigationGraph.d.ts

@@ -45,6 +45,21 @@ export interface INavigationGraph {
     getToolContext?(toolId: string): string | null;
     navigate?(path: string | RouteInfo): void;
     navigateToContext?(contextId: string): Promise<boolean>;
+    setRouter?(router: {
+        push?: (path: string) => void;
+        back?: () => void;
+        forward?: () => void;
+        refresh?: () => void;
+    }): void;
+    getRouter?(): {
+        push?: (path: string) => void;
+        back?: () => void;
+        forward?: () => void;
+        refresh?: () => void;
+    } | null;
+    back?(): void;
+    forward?(): void;
+    refresh?(): void;
     trackComponent?(id: string, parent?: string): void;
     getTree?(): NavigationNode[];
     trackNavigation?(from: string, to: string): void;

package/dist/esm/src/background/navigation/INavigationGraph.d.ts.map

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

package/dist/esm/src/background/navigation/NavigationGraph.d.ts

@@ -23,6 +23,7 @@ export declare class NavigationGraph implements INavigationGraph {
     private currentContext;
     private contextTools;
     private navigationHandler;
+    private router;
     private contextListeners;
     private locationUnsubscribe;
     private warnOnce;
@@ -49,6 +50,37 @@ export declare class NavigationGraph implements INavigationGraph {
      */
     onContextChange(fn: (ctx: string) => void): () => void;
     setNavigationHandler(handler: (path: string | RouteInfo) => void | Promise<void>): void;
+    /**
+     * Set router for browser navigation tools (back/forward/refresh)
+     * Called by framework adapters (e.g., useNavigationGraphSetup in @supernal/interface-nextjs)
+     */
+    setRouter(router: {
+        push?: (path: string) => void;
+        back?: () => void;
+        forward?: () => void;
+        refresh?: () => void;
+    }): void;
+    /**
+     * Get the registered router
+     */
+    getRouter(): {
+        push?: (path: string) => void;
+        back?: () => void;
+        forward?: () => void;
+        refresh?: () => void;
+    } | null;
+    /**
+     * Navigate back in browser history
+     */
+    back(): void;
+    /**
+     * Navigate forward in browser history
+     */
+    forward(): void;
+    /**
+     * Refresh the current page
+     */
+    refresh(): void;
     getNavigationHandler(): ((pageName: string) => void | Promise<void>) | null;
     /**
      * Navigate to a path using the registered navigation handler

package/dist/esm/src/background/navigation/NavigationGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAW9F,QAAA,MAAM,oBAAoB,kCAAkC,CAAC;AAG7D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,CAAC,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,CAAC;KAC3C;CACF;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE5E,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,iBAAiB,CAAqE;IAG9F,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,mBAAmB,CAA6B;IAExD,OAAO,CAAC,QAAQ;IAUhB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAwBzB,MAAM,CAAC,WAAW,IAAI,eAAe;IAsBrC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,IAAI,cAAc,EAAE;IAK3B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAKb,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAKrE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAKnC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAOhF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKnD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAmCtD;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKtD,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvF,oBAAoB,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAI3E;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAclC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKzD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAKtC,iBAAiB,IAAI,MAAM;IAgB3B;;;OAGG;IACH,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC,cAAc,IAAI,GAAG,EAAE;IAKvB,WAAW,IAAI,GAAG,EAAE;IAKpB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK7C,KAAK,IAAI,IAAI;IAIb,cAAc,IAAI,IAAI;IAItB,SAAS,IAAI,MAAM;IAKnB,MAAM,IAAI,GAAG;CAId"}
+{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/background/navigation/NavigationGraph.js

@@ -20,6 +20,8 @@ export class NavigationGraph {
         this.warned = false;
         this.contextTools = new Map(); // toolId -> contextId
         this.navigationHandler = null;
+        // Router for browser navigation tools (back/forward/refresh)
+        this.router = null;
         // Context change listeners
         this.contextListeners = new Set();
         this.locationUnsubscribe = null;
@@ -160,6 +162,52 @@ export class NavigationGraph {
     setNavigationHandler(handler) {
         this.navigationHandler = handler;
     }
+    /**
+     * Set router for browser navigation tools (back/forward/refresh)
+     * Called by framework adapters (e.g., useNavigationGraphSetup in @supernal/interface-nextjs)
+     */
+    setRouter(router) {
+        this.router = router;
+    }
+    /**
+     * Get the registered router
+     */
+    getRouter() {
+        return this.router;
+    }
+    /**
+     * Navigate back in browser history
+     */
+    back() {
+        if (this.router?.back) {
+            this.router.back();
+        }
+        else if (typeof window !== 'undefined') {
+            window.history.back();
+        }
+    }
+    /**
+     * Navigate forward in browser history
+     */
+    forward() {
+        if (this.router?.forward) {
+            this.router.forward();
+        }
+        else if (typeof window !== 'undefined') {
+            window.history.forward();
+        }
+    }
+    /**
+     * Refresh the current page
+     */
+    refresh() {
+        if (this.router?.refresh) {
+            this.router.refresh();
+        }
+        else if (typeof window !== 'undefined') {
+            window.location.reload();
+        }
+    }
     getNavigationHandler() {
         return this.navigationHandler;
     }

package/dist/esm/src/background/navigation/NavigationGraph.js.map

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

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