@browserflow-ai/exploration 0.0.6

package/dist/adapters/types.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Represents a step execution result from AI exploration
+ */
+export interface StepExecution {
+    status: 'completed' | 'failed' | 'skipped';
+    method: string;
+    elementRef?: string;
+    selectorUsed?: string;
+    durationMs: number;
+    error?: string | null;
+}
+/**
+ * Screenshots captured during a step
+ */
+export interface StepScreenshots {
+    before: string;
+    after: string;
+}
+/**
+ * Result of executing a single step
+ */
+export interface StepResult {
+    stepIndex: number;
+    specAction: Record<string, unknown>;
+    execution: StepExecution;
+    screenshots: StepScreenshots;
+    snapshotBefore?: Record<string, unknown>;
+    snapshotAfter?: Record<string, unknown>;
+}
+/**
+ * Outcome check result
+ */
+export interface OutcomeCheck {
+    check: string;
+    expected: unknown;
+    actual: unknown;
+    passed: boolean;
+}
+/**
+ * Complete output from an exploration run
+ */
+export interface ExplorationOutput {
+    spec: string;
+    specPath: string;
+    specDescription?: string;
+    explorationId: string;
+    timestamp: string;
+    durationMs: number;
+    browser: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    baseUrl: string;
+    steps: StepResult[];
+    outcomeChecks: OutcomeCheck[];
+    overallStatus: 'completed' | 'failed' | 'timeout';
+    errors: string[];
+}
+/**
+ * Verify check conditions
+ */
+export interface VerifyCheck {
+    element_visible?: string;
+    element_not_visible?: string;
+    text_contains?: string;
+    text_not_contains?: string;
+    url_contains?: string;
+    element_count?: {
+        selector: string;
+        expected: number;
+    };
+    attribute?: {
+        selector: string;
+        attribute: string;
+        equals: string;
+    };
+}
+/**
+ * Step definition from a spec file
+ */
+export interface SpecStep {
+    action: string;
+    query?: string;
+    selector?: string;
+    ref?: string;
+    url?: string;
+    to?: string;
+    value?: string;
+    for?: string;
+    text?: string;
+    contains?: string;
+    timeout?: string | number;
+    duration?: string | number;
+    checks?: VerifyCheck[];
+    name?: string;
+    description?: string;
+    why?: string;
+    option?: string;
+    checked?: boolean;
+    scrollX?: number;
+    scrollY?: number;
+    [key: string]: unknown;
+}
+/**
+ * Spec file structure
+ */
+export interface Spec {
+    name: string;
+    description?: string;
+    preconditions?: Record<string, unknown>;
+    steps: SpecStep[];
+    expectedOutcomes?: Record<string, unknown>[];
+    tags?: string[];
+    timeout?: string;
+    priority?: string;
+}
+/**
+ * Parameters for running an exploration
+ */
+export interface ExploreParams {
+    spec: Spec;
+    specPath: string;
+    baseUrl: string;
+    browser?: 'chromium' | 'firefox' | 'webkit';
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeout?: number;
+    outputDir: string;
+    sessionId?: string;
+}
+/**
+ * Parameters for retrying with feedback
+ */
+export interface RetryParams extends ExploreParams {
+    previousExploration: ExplorationOutput;
+    reviewFeedback: ReviewFeedback;
+}
+/**
+ * Review feedback structure
+ */
+export interface ReviewFeedback {
+    explorationId: string;
+    reviewer: string;
+    steps: {
+        stepIndex: number;
+        status: 'approved' | 'rejected' | 'pending';
+        comment?: string;
+        tags?: string[];
+    }[];
+    overallNotes?: string;
+    verdict: 'approved' | 'rejected';
+}
+/**
+ * Enhanced snapshot from browser - includes tree and element refs
+ */
+export interface EnhancedSnapshot {
+    tree: string;
+    refs: Record<string, unknown>;
+}
+/**
+ * Result from findElement operation
+ */
+export interface FindElementResult {
+    /** Element reference (e.g., "e5") or "NOT_FOUND" */
+    ref: string;
+    /** AI reasoning for why this element was selected */
+    reasoning: string;
+    /** Confidence score 0-1 */
+    confidence: number;
+}
+/**
+ * AI Adapter interface - defines the contract for LLM integrations
+ */
+export interface AIAdapter {
+    /**
+     * Name of the adapter (e.g., 'claude', 'openai')
+     */
+    readonly name: string;
+    /**
+     * Run exploration on a spec
+     */
+    explore(params: ExploreParams): Promise<ExplorationOutput>;
+    /**
+     * Find element from natural language query
+     * Uses AI to interpret the query and match against snapshot elements
+     */
+    findElement(query: string, snapshot: EnhancedSnapshot): Promise<FindElementResult>;
+    /**
+     * Retry exploration with review feedback
+     */
+    retryWithFeedback?(params: RetryParams): Promise<ExplorationOutput>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

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

package/dist/adapters/types.js

@@ -0,0 +1,3 @@
+// @browserflow-ai/exploration - Adapter types
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,8CAA8C"}

package/dist/agent-browser-session.d.ts

@@ -0,0 +1,62 @@
+/**
+ * BrowserSession adapter using agent-browser's BrowserManager
+ *
+ * This adapter wraps agent-browser to provide a clean BrowserSession interface
+ * for the exploration engine.
+ */
+import type { BrowserSession, BrowserLaunchOptions } from './explorer';
+import type { EnhancedSnapshot } from './adapters/types';
+/**
+ * AgentBrowserSession implements BrowserSession using agent-browser
+ */
+export declare class AgentBrowserSession implements BrowserSession {
+    private browser;
+    constructor();
+    isLaunched(): boolean;
+    launch(options?: BrowserLaunchOptions): Promise<void>;
+    navigate(url: string): Promise<void>;
+    screenshot(options?: {
+        fullPage?: boolean;
+        clip?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        mask?: string[];
+        quality?: number;
+    }): Promise<Buffer>;
+    getSnapshot(options?: {
+        interactive?: boolean;
+        maxDepth?: number;
+        compact?: boolean;
+        selector?: string;
+    }): Promise<EnhancedSnapshot>;
+    close(): Promise<void>;
+    click(ref: string): Promise<void>;
+    fill(ref: string, value: string): Promise<void>;
+    type(ref: string, text: string): Promise<void>;
+    select(ref: string, option: string): Promise<void>;
+    check(ref: string, checked: boolean): Promise<void>;
+    press(key: string): Promise<void>;
+    back(): Promise<void>;
+    forward(): Promise<void>;
+    refresh(): Promise<void>;
+    waitForSelector(selector: string, timeout: number): Promise<void>;
+    waitForURL(urlPattern: string, timeout: number): Promise<void>;
+    waitForText(text: string, timeout: number): Promise<void>;
+    waitForLoadState(state: 'load' | 'domcontentloaded' | 'networkidle'): Promise<void>;
+    waitForTimeout(ms: number): Promise<void>;
+    scrollIntoView(ref: string): Promise<void>;
+    scroll(x: number, y: number): Promise<void>;
+    getCurrentURL(): string;
+    /**
+     * Ensures browser is launched before performing operations
+     */
+    private ensureLaunched;
+}
+/**
+ * Factory function to create a new browser session
+ */
+export declare function createBrowserSession(): BrowserSession;
+//# sourceMappingURL=agent-browser-session.d.ts.map

package/dist/agent-browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-browser-session.d.ts","sourceRoot":"","sources":["../src/agent-browser-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,OAAO,CAAiB;;IAMhC,UAAU,IAAI,OAAO;IAIf,MAAM,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,UAAU,CAAC,OAAO,CAAC,EAAE;QACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBb,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAanF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,aAAa,IAAI,MAAM;IAavB;;OAEG;IACH,OAAO,CAAC,cAAc;CAKvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/agent-browser-session.js

@@ -0,0 +1,272 @@
+/**
+ * BrowserSession adapter using agent-browser's BrowserManager
+ *
+ * This adapter wraps agent-browser to provide a clean BrowserSession interface
+ * for the exploration engine.
+ */
+import { BrowserManager } from 'agent-browser/dist/browser.js';
+/**
+ * AgentBrowserSession implements BrowserSession using agent-browser
+ */
+export class AgentBrowserSession {
+    browser;
+    constructor() {
+        this.browser = new BrowserManager();
+    }
+    isLaunched() {
+        return this.browser.isLaunched();
+    }
+    async launch(options) {
+        const launchOptions = {
+            id: 'launch',
+            action: 'launch',
+            headless: options?.headless ?? true,
+            viewport: options?.viewport ?? { width: 1280, height: 720 },
+            browser: 'chromium',
+        };
+        try {
+            await this.browser.launch(launchOptions);
+        }
+        catch (error) {
+            throw new Error(`Failed to launch browser: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async navigate(url) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.goto(url, { waitUntil: 'load' });
+        }
+        catch (error) {
+            throw new Error(`Failed to navigate to ${url}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async screenshot(options) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            const { mask, ...restOptions } = options ?? {};
+            const buffer = await page.screenshot({
+                type: 'png',
+                ...restOptions,
+                ...(mask && { mask: mask.map((selector) => page.locator(selector)) }),
+            });
+            return Buffer.from(buffer);
+        }
+        catch (error) {
+            throw new Error(`Failed to capture screenshot: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async getSnapshot(options) {
+        this.ensureLaunched();
+        try {
+            const snapshot = await this.browser.getSnapshot(options);
+            return {
+                tree: snapshot.tree,
+                refs: snapshot.refs,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get snapshot: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async close() {
+        if (this.browser.isLaunched()) {
+            try {
+                await this.browser.close();
+            }
+            catch (error) {
+                // Ignore errors on close - browser might already be closed
+            }
+        }
+    }
+    // Interaction methods
+    async click(ref) {
+        this.ensureLaunched();
+        try {
+            const locator = this.browser.getLocator(ref);
+            await locator.click();
+        }
+        catch (error) {
+            throw new Error(`Failed to click ${ref}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async fill(ref, value) {
+        this.ensureLaunched();
+        try {
+            const locator = this.browser.getLocator(ref);
+            await locator.fill(value);
+        }
+        catch (error) {
+            throw new Error(`Failed to fill ${ref}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async type(ref, text) {
+        this.ensureLaunched();
+        try {
+            const locator = this.browser.getLocator(ref);
+            await locator.pressSequentially(text);
+        }
+        catch (error) {
+            throw new Error(`Failed to type into ${ref}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async select(ref, option) {
+        this.ensureLaunched();
+        try {
+            const locator = this.browser.getLocator(ref);
+            await locator.selectOption(option);
+        }
+        catch (error) {
+            throw new Error(`Failed to select option in ${ref}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async check(ref, checked) {
+        this.ensureLaunched();
+        try {
+            const locator = this.browser.getLocator(ref);
+            if (checked) {
+                await locator.check();
+            }
+            else {
+                await locator.uncheck();
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to ${checked ? 'check' : 'uncheck'} ${ref}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async press(key) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.keyboard.press(key);
+        }
+        catch (error) {
+            throw new Error(`Failed to press key ${key}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Navigation methods
+    async back() {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.goBack();
+        }
+        catch (error) {
+            throw new Error(`Failed to go back: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async forward() {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.goForward();
+        }
+        catch (error) {
+            throw new Error(`Failed to go forward: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async refresh() {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.reload();
+        }
+        catch (error) {
+            throw new Error(`Failed to refresh page: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Wait methods
+    async waitForSelector(selector, timeout) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.waitForSelector(selector, { timeout });
+        }
+        catch (error) {
+            throw new Error(`Failed to wait for selector ${selector}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async waitForURL(urlPattern, timeout) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.waitForURL(urlPattern, { timeout });
+        }
+        catch (error) {
+            throw new Error(`Failed to wait for URL ${urlPattern}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async waitForText(text, timeout) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.locator(`text=${text}`).waitFor({ timeout });
+        }
+        catch (error) {
+            throw new Error(`Failed to wait for text "${text}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async waitForLoadState(state) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            await page.waitForLoadState(state);
+        }
+        catch (error) {
+            throw new Error(`Failed to wait for load state ${state}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async waitForTimeout(ms) {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    // Scroll methods
+    async scrollIntoView(ref) {
+        this.ensureLaunched();
+        try {
+            const locator = this.browser.getLocator(ref);
+            await locator.scrollIntoViewIfNeeded();
+        }
+        catch (error) {
+            throw new Error(`Failed to scroll ${ref} into view: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async scroll(x, y) {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            // Use mouse wheel for scrolling (more reliable than evaluate)
+            await page.mouse.wheel(x, y);
+        }
+        catch (error) {
+            throw new Error(`Failed to scroll by (${x}, ${y}): ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // State methods
+    getCurrentURL() {
+        this.ensureLaunched();
+        try {
+            const page = this.browser.getPage();
+            return page.url();
+        }
+        catch (error) {
+            throw new Error(`Failed to get current URL: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Ensures browser is launched before performing operations
+     */
+    ensureLaunched() {
+        if (!this.browser.isLaunched()) {
+            throw new Error('Browser is not launched. Call launch() first.');
+        }
+    }
+}
+/**
+ * Factory function to create a new browser session
+ */
+export function createBrowserSession() {
+    return new AgentBrowserSession();
+}
+//# sourceMappingURL=agent-browser-session.js.map

package/dist/agent-browser-session.js.map

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

package/dist/evidence.d.ts

@@ -0,0 +1,111 @@
+import type { BrowserSession } from './explorer';
+/**
+ * Evidence metadata
+ */
+export interface EvidenceMetadata {
+    timestamp: string;
+    sessionId: string;
+    stepIndex?: number;
+    type: 'screenshot' | 'trace' | 'snapshot';
+    path: string;
+}
+/**
+ * Screenshot capture options
+ */
+export interface ScreenshotOptions {
+    fullPage?: boolean;
+    clip?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    mask?: string[];
+    quality?: number;
+}
+/**
+ * Configuration for the evidence collector
+ */
+export interface EvidenceCollectorConfig {
+    outputDir?: string;
+    screenshotFormat?: 'png' | 'jpeg';
+    screenshotQuality?: number;
+}
+/**
+ * EvidenceCollector - Captures screenshots and traces during exploration
+ *
+ * Provides:
+ * - Screenshot capture (full page, clipped, masked)
+ * - Browser snapshot capture
+ * - Trace/HAR file generation
+ * - Evidence metadata tracking
+ */
+export declare class EvidenceCollector {
+    private outputDir;
+    private screenshotFormat;
+    private screenshotQuality;
+    private evidence;
+    private sessions;
+    constructor(config?: EvidenceCollectorConfig);
+    /**
+     * Register a browser session for screenshot capture
+     *
+     * @param sessionId - Unique identifier for the session
+     * @param session - Browser session instance
+     */
+    registerSession(sessionId: string, session: BrowserSession): void;
+    /**
+     * Unregister a browser session
+     *
+     * @param sessionId - Session identifier to remove
+     */
+    unregisterSession(sessionId: string): void;
+    /**
+     * Capture a screenshot from the browser session
+     *
+     * @param sessionId - Browser session ID
+     * @param name - Screenshot name/identifier
+     * @param options - Screenshot options
+     * @returns Promise resolving to screenshot file path
+     */
+    captureScreenshot(sessionId: string, name: string, options?: ScreenshotOptions): Promise<string>;
+    /**
+     * Capture a browser snapshot (DOM state with element refs)
+     *
+     * @param sessionId - Browser session ID
+     * @param name - Snapshot name/identifier
+     * @returns Promise resolving to snapshot data
+     */
+    captureSnapshot(sessionId: string, name: string): Promise<Record<string, unknown>>;
+    /**
+     * Start trace recording
+     *
+     * @param sessionId - Browser session ID
+     * @param name - Trace name/identifier
+     */
+    startTrace(sessionId: string, name: string): Promise<void>;
+    /**
+     * Stop trace recording and save
+     *
+     * @param sessionId - Browser session ID
+     * @returns Promise resolving to trace file path
+     */
+    stopTrace(sessionId: string): Promise<string>;
+    /**
+     * Get all collected evidence metadata
+     */
+    getEvidence(): EvidenceMetadata[];
+    /**
+     * Clear collected evidence metadata
+     */
+    clearEvidence(): void;
+    /**
+     * Get the output directory
+     */
+    getOutputDir(): string;
+    /**
+     * Set the output directory
+     */
+    setOutputDir(dir: string): void;
+}
+//# sourceMappingURL=evidence.d.ts.map

package/dist/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,QAAQ,CAA0C;gBAE9C,MAAM,GAAE,uBAA4B;IAMhD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAIjE;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1C;;;;;;;OAOG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC;IA8BlB;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAenC;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE;;;;;OAKG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAenD;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE;IAIjC;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGhC"}