@supernal/interface 1.0.9 → 1.0.11

package/dist/esm/src/testing/graph-tester/core/TestFunction.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Abstract base class for all test functions.
+ *
+ * Test functions implement specific testing modes (visual regression, performance, accessibility, etc.).
+ * Each test function:
+ * 1. Receives a Playwright page and test context
+ * 2. Performs its testing logic
+ * 3. Returns a TestResult with pass/fail status and metadata
+ *
+ * @packageDocumentation
+ */
+import type { Page } from '@playwright/test';
+import type { TestContext, TestResult, TestMode } from './types';
+/**
+ * Abstract base class for test functions.
+ *
+ * @example
+ * ```typescript
+ * class VisualRegressionMode extends TestFunction {
+ *   mode = 'visual';
+ *
+ *   async execute(page: Page, context: TestContext): Promise<TestResult> {
+ *     const startTime = Date.now();
+ *     const screenshot = await page.screenshot({ fullPage: true });
+ *
+ *     return {
+ *       passed: true,
+ *       duration: Date.now() - startTime,
+ *       errors: [],
+ *       metadata: {
+ *         screenshot,
+ *         screenshotPath: './screenshots/example.png'
+ *       }
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class TestFunction {
+    /**
+     * Test mode identifier.
+     * Must be unique across all test functions.
+     */
+    abstract readonly mode: TestMode;
+    /**
+     * Human-readable name for this test function.
+     */
+    abstract readonly name: string;
+    /**
+     * Description of what this test function does.
+     */
+    abstract readonly description: string;
+    /**
+     * Execute the test function.
+     *
+     * @param page - Playwright page instance
+     * @param context - Test context (route, metadata)
+     * @returns Test result with pass/fail status and metadata
+     */
+    abstract execute(page: Page, context: TestContext): Promise<TestResult>;
+    /**
+     * Optional setup hook called before execute().
+     * Use for initialization that should happen once per route.
+     *
+     * @param page - Playwright page instance
+     */
+    setup?(page: Page): Promise<void>;
+    /**
+     * Optional teardown hook called after execute().
+     * Use for cleanup that should happen once per route.
+     *
+     * @param page - Playwright page instance
+     */
+    teardown?(page: Page): Promise<void>;
+    /**
+     * Optional predicate to determine if this test should run for a given context.
+     * Return false to skip testing this route with this test function.
+     *
+     * @param context - Test context
+     * @returns Whether to test this route
+     *
+     * @example
+     * ```typescript
+     * // Only test authenticated routes
+     * shouldTest(context: TestContext): boolean {
+     *   return context.metadata?.requiresAuth === true;
+     * }
+     * ```
+     */
+    shouldTest?(context: TestContext): boolean;
+    /**
+     * Execute the full test lifecycle: setup, execute, teardown.
+     * This method handles the orchestration and error handling.
+     *
+     * @param page - Playwright page instance
+     * @param context - Test context
+     * @returns Test result
+     */
+    run(page: Page, context: TestContext): Promise<TestResult>;
+    /**
+     * Validate test function configuration.
+     * Override to add custom validation logic.
+     *
+     * @returns Array of validation errors (empty if valid)
+     */
+    validate(): string[];
+    /**
+     * Get test function info for reporting.
+     */
+    getInfo(): {
+        mode: TestMode;
+        name: string;
+        description: string;
+    };
+}
+/**
+ * Type guard to check if an object is a TestFunction.
+ */
+export declare function isTestFunction(obj: any): obj is TestFunction;
+//# sourceMappingURL=TestFunction.d.ts.map

package/dist/esm/src/testing/graph-tester/core/TestFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestFunction.d.ts","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/TestFunction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EAIT,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,YAAY;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAEvE;;;;;OAKG;IACG,KAAK,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvC;;;;;OAKG;IACG,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1C;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAE1C;;;;;;;OAOG;IACG,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAqGhE;;;;;OAKG;IACH,QAAQ,IAAI,MAAM,EAAE;IAkBpB;;OAEG;IACH,OAAO,IAAI;QACT,IAAI,EAAE,QAAQ,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB;CAOF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAS5D"}

package/dist/esm/src/testing/graph-tester/core/TestFunction.js

@@ -0,0 +1,184 @@
+/**
+ * Abstract base class for all test functions.
+ *
+ * Test functions implement specific testing modes (visual regression, performance, accessibility, etc.).
+ * Each test function:
+ * 1. Receives a Playwright page and test context
+ * 2. Performs its testing logic
+ * 3. Returns a TestResult with pass/fail status and metadata
+ *
+ * @packageDocumentation
+ */
+/**
+ * Abstract base class for test functions.
+ *
+ * @example
+ * ```typescript
+ * class VisualRegressionMode extends TestFunction {
+ *   mode = 'visual';
+ *
+ *   async execute(page: Page, context: TestContext): Promise<TestResult> {
+ *     const startTime = Date.now();
+ *     const screenshot = await page.screenshot({ fullPage: true });
+ *
+ *     return {
+ *       passed: true,
+ *       duration: Date.now() - startTime,
+ *       errors: [],
+ *       metadata: {
+ *         screenshot,
+ *         screenshotPath: './screenshots/example.png'
+ *       }
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export class TestFunction {
+    /**
+     * Execute the full test lifecycle: setup, execute, teardown.
+     * This method handles the orchestration and error handling.
+     *
+     * @param page - Playwright page instance
+     * @param context - Test context
+     * @returns Test result
+     */
+    async run(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            // Check if we should test this route
+            if (this.shouldTest && !this.shouldTest(context)) {
+                return {
+                    passed: true,
+                    duration: Date.now() - startTime,
+                    errors: [],
+                    metadata: {
+                        skipped: true,
+                        reason: 'Skipped by shouldTest() predicate',
+                    },
+                    mode: this.mode,
+                    route: context.route,
+                };
+            }
+            // Setup
+            if (this.setup) {
+                try {
+                    await this.setup(page);
+                }
+                catch (error) {
+                    errors.push({
+                        severity: 'critical',
+                        message: `Setup failed: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    });
+                    return {
+                        passed: false,
+                        duration: Date.now() - startTime,
+                        errors,
+                        metadata: {},
+                        mode: this.mode,
+                        route: context.route,
+                    };
+                }
+            }
+            // Execute
+            let result;
+            try {
+                result = await this.execute(page, context);
+            }
+            catch (error) {
+                errors.push({
+                    severity: 'critical',
+                    message: `Execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                result = {
+                    passed: false,
+                    duration: Date.now() - startTime,
+                    errors,
+                    metadata: {},
+                };
+            }
+            // Teardown
+            if (this.teardown) {
+                try {
+                    await this.teardown(page);
+                }
+                catch (error) {
+                    errors.push({
+                        severity: 'warning',
+                        message: `Teardown failed: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    });
+                }
+            }
+            // Merge errors and add metadata
+            return {
+                ...result,
+                errors: [...errors, ...result.errors],
+                mode: this.mode,
+                route: context.route,
+            };
+        }
+        catch (error) {
+            // Catch-all for unexpected errors
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors: [
+                    ...errors,
+                    {
+                        severity: 'critical',
+                        message: `Unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    },
+                ],
+                metadata: {},
+                mode: this.mode,
+                route: context.route,
+            };
+        }
+    }
+    /**
+     * Validate test function configuration.
+     * Override to add custom validation logic.
+     *
+     * @returns Array of validation errors (empty if valid)
+     */
+    validate() {
+        const errors = [];
+        if (!this.mode) {
+            errors.push('mode is required');
+        }
+        if (!this.name) {
+            errors.push('name is required');
+        }
+        if (!this.description) {
+            errors.push('description is required');
+        }
+        return errors;
+    }
+    /**
+     * Get test function info for reporting.
+     */
+    getInfo() {
+        return {
+            mode: this.mode,
+            name: this.name,
+            description: this.description,
+        };
+    }
+}
+/**
+ * Type guard to check if an object is a TestFunction.
+ */
+export function isTestFunction(obj) {
+    return (obj &&
+        typeof obj === 'object' &&
+        typeof obj.mode === 'string' &&
+        typeof obj.name === 'string' &&
+        typeof obj.description === 'string' &&
+        typeof obj.execute === 'function');
+}
+//# sourceMappingURL=TestFunction.js.map

package/dist/esm/src/testing/graph-tester/core/TestFunction.js.map

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

package/dist/esm/src/testing/graph-tester/core/types.d.ts

@@ -0,0 +1,331 @@
+/**
+ * Core types for the graph-based testing framework.
+ *
+ * This file is the contract between all packages - changes require consensus.
+ *
+ * @packageDocumentation
+ */
+import type { Page } from '@playwright/test';
+/**
+ * Context provided to test functions during execution.
+ * Contains route information and optional metadata.
+ */
+export interface TestContext {
+    /** The route being tested (e.g., '/', '/dashboard', '/blog/:slug') */
+    route: string;
+    /** Unique identifier for this navigation context (enterprise only) */
+    contextId?: string;
+    /** Additional metadata about the route (tools, parent/child, custom data) */
+    metadata?: RouteMetadata;
+    /** Base URL for the application under test */
+    baseUrl?: string;
+    /** Current viewport being tested (for responsive testing) */
+    viewport?: ViewportConfig;
+}
+/**
+ * Metadata associated with a route.
+ * Enterprise users get richer metadata via NavigationGraph.
+ */
+export interface RouteMetadata {
+    /** Human-readable name for the route */
+    name?: string;
+    /** Tools available on this route (enterprise only) */
+    tools?: string[];
+    /** Parent route in navigation hierarchy (enterprise only) */
+    parent?: string;
+    /** Child routes (enterprise only) */
+    children?: string[];
+    /** Navigation paths to other routes (enterprise only) */
+    navigationPaths?: NavigationPath[];
+    /** Custom user-defined metadata */
+    [key: string]: any;
+}
+/**
+ * Navigation path between routes (enterprise only).
+ */
+export interface NavigationPath {
+    /** Target route */
+    target: string;
+    /** Navigation method (link, button, programmatic) */
+    method: 'link' | 'button' | 'programmatic' | 'other';
+    /** Element selector that triggers navigation (if applicable) */
+    selector?: string;
+}
+/**
+ * Result of a test function execution.
+ */
+export interface TestResult {
+    /** Whether the test passed */
+    passed: boolean;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Errors encountered during testing */
+    errors: TestError[];
+    /** Additional test-specific metadata (screenshots, metrics, violations, etc.) */
+    metadata: Record<string, any>;
+    /** Test mode that produced this result */
+    mode?: TestMode;
+    /** Route that was tested */
+    route?: string;
+}
+/**
+ * Error encountered during testing.
+ */
+export interface TestError {
+    /** Error severity */
+    severity: 'critical' | 'warning' | 'info';
+    /** Error message */
+    message: string;
+    /** Location where error occurred (file:line, selector, etc.) */
+    location?: string;
+    /** Stack trace (if available) */
+    stack?: string;
+    /** Additional error context */
+    context?: Record<string, any>;
+}
+/**
+ * Descriptor for a route to be tested.
+ * Open-source users provide these manually.
+ * Enterprise users get these automatically via NavigationGraph.
+ */
+export interface RouteDescriptor {
+    /** The route path */
+    route: string;
+    /** Unique identifier (enterprise only) */
+    contextId?: string;
+    /** Route metadata */
+    metadata?: RouteMetadata;
+}
+/**
+ * Configuration for route discovery.
+ */
+export interface RouteDiscoveryConfig {
+    /** Discovery strategy ('manual', 'navigation-graph', 'custom') */
+    strategy: 'manual' | 'navigation-graph' | 'custom';
+    /** Routes to include (glob patterns) */
+    include?: string[];
+    /** Routes to exclude (glob patterns) */
+    exclude?: string[];
+    /** Custom discovery function */
+    discoveryFn?: () => Promise<RouteDescriptor[]>;
+}
+/**
+ * Available test modes.
+ */
+export type TestMode = 'visual' | 'performance' | 'accessibility' | 'seo' | string;
+/**
+ * Configuration for a test mode.
+ */
+export interface TestModeConfig {
+    /** Mode identifier */
+    mode: TestMode;
+    /** Whether this mode is enabled */
+    enabled?: boolean;
+    /** Mode-specific options */
+    options?: Record<string, any>;
+}
+/**
+ * Configuration for GraphTester.
+ */
+export interface GraphTesterConfig {
+    /** Base URL for the application under test */
+    baseUrl: string;
+    /** Routes to test (manual mode) or discovery config */
+    routes?: RouteDescriptor[] | RouteDiscoveryConfig;
+    /** Test modes to run */
+    modes: TestMode[] | TestModeConfig[];
+    /** Output configuration */
+    output?: OutputConfig;
+    /** Execution configuration */
+    execution?: ExecutionConfig;
+    /** Browser configuration */
+    browser?: BrowserConfig;
+}
+/**
+ * Output configuration.
+ */
+export interface OutputConfig {
+    /** Output directory */
+    dir: string;
+    /** Output formats ('json', 'html', 'markdown', 'csv') */
+    formats?: ('json' | 'html' | 'markdown' | 'csv')[];
+    /** Whether to include screenshots */
+    includeScreenshots?: boolean;
+    /** Whether to include detailed logs */
+    includeDetailedLogs?: boolean;
+}
+/**
+ * Execution configuration.
+ */
+export interface ExecutionConfig {
+    /** Number of parallel workers */
+    parallel?: number;
+    /** Timeout per test (ms) */
+    timeout?: number;
+    /** Number of retries on failure */
+    retries?: number;
+    /** Whether to fail fast on first error */
+    failFast?: boolean;
+}
+/**
+ * Viewport configuration for responsive testing.
+ */
+export interface ViewportConfig {
+    /** Viewport name (e.g., 'desktop', 'tablet', 'mobile') */
+    name: string;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+    /** Device scale factor (default: 1) */
+    deviceScaleFactor?: number;
+    /** Whether this is a mobile device (default: false) */
+    isMobile?: boolean;
+    /** Whether device has touch support (default: false) */
+    hasTouch?: boolean;
+    /** User agent override */
+    userAgent?: string;
+}
+/**
+ * Predefined viewport presets.
+ */
+export declare const ViewportPresets: {
+    readonly Desktop: {
+        readonly name: "desktop";
+        readonly width: 1920;
+        readonly height: 1080;
+    };
+    readonly DesktopSmall: {
+        readonly name: "desktop-small";
+        readonly width: 1366;
+        readonly height: 768;
+    };
+    readonly Laptop: {
+        readonly name: "laptop";
+        readonly width: 1280;
+        readonly height: 720;
+    };
+    readonly TabletLandscape: {
+        readonly name: "tablet-landscape";
+        readonly width: 1024;
+        readonly height: 768;
+        readonly isMobile: true;
+        readonly hasTouch: true;
+    };
+    readonly TabletPortrait: {
+        readonly name: "tablet-portrait";
+        readonly width: 768;
+        readonly height: 1024;
+        readonly isMobile: true;
+        readonly hasTouch: true;
+    };
+    readonly MobileLarge: {
+        readonly name: "mobile-large";
+        readonly width: 414;
+        readonly height: 896;
+        readonly isMobile: true;
+        readonly hasTouch: true;
+    };
+    readonly Mobile: {
+        readonly name: "mobile";
+        readonly width: 375;
+        readonly height: 812;
+        readonly isMobile: true;
+        readonly hasTouch: true;
+    };
+    readonly MobileSmall: {
+        readonly name: "mobile-small";
+        readonly width: 320;
+        readonly height: 568;
+        readonly isMobile: true;
+        readonly hasTouch: true;
+    };
+};
+/**
+ * Browser configuration.
+ */
+export interface BrowserConfig {
+    /** Browser type ('chromium', 'firefox', 'webkit') */
+    browserType?: 'chromium' | 'firefox' | 'webkit';
+    /** Single viewport size (legacy - use viewports for responsive testing) */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Multiple viewports for responsive testing */
+    viewports?: ViewportConfig[];
+    /** Whether to run headless */
+    headless?: boolean;
+    /** Additional launch options */
+    launchOptions?: Record<string, any>;
+}
+/**
+ * Aggregated results from all test executions.
+ */
+export interface AggregatedTestResults {
+    /** Total number of routes tested */
+    routeCount: number;
+    /** Total number of tests run */
+    testCount: number;
+    /** Number of passed tests */
+    passedCount: number;
+    /** Number of failed tests */
+    failedCount: number;
+    /** Pass rate percentage */
+    passRate: number;
+    /** Total duration (ms) */
+    totalDuration: number;
+    /** Results grouped by route */
+    resultsByRoute: Map<string, TestResult[]>;
+    /** Results grouped by mode */
+    resultsByMode: Map<TestMode, TestResult[]>;
+    /** All errors */
+    errors: TestError[];
+    /** Timestamp */
+    timestamp: Date;
+    /** Configuration used */
+    config: GraphTesterConfig;
+}
+/**
+ * Reporter interface.
+ */
+export interface Reporter {
+    /** Generate report from aggregated results */
+    generate(results: AggregatedTestResults): Promise<void>;
+    /** Reporter name */
+    name: string;
+}
+/**
+ * Report format options.
+ */
+export type ReportFormat = 'json' | 'html' | 'markdown' | 'csv';
+/**
+ * Test function execution options.
+ */
+export interface ExecuteOptions {
+    /** Playwright page instance */
+    page: Page;
+    /** Test context */
+    context: TestContext;
+    /** Timeout (ms) */
+    timeout?: number;
+}
+/**
+ * Test function setup options.
+ */
+export interface SetupOptions {
+    /** Playwright page instance */
+    page: Page;
+    /** Test context */
+    context?: TestContext;
+}
+/**
+ * Test function teardown options.
+ */
+export interface TeardownOptions {
+    /** Playwright page instance */
+    page: Page;
+    /** Test context */
+    context?: TestContext;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/src/testing/graph-tester/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IAEd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,yDAAyD;IACzD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAEnC,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,qDAAqD;IACrD,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC;IAErD,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAEhB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,wCAAwC;IACxC,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAE1C,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAID;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAEnD,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAChD;AAID;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,QAAQ,CAAC;IAEf,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAID;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAEhB,uDAAuD;IACvD,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,oBAAoB,CAAC;IAElD,wBAAwB;IACxB,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAAC;IAErC,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IAEZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;IAEnD,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASlB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,WAAW,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEhD,2EAA2E;IAC3E,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7C,gDAAgD;IAChD,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAE7B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAID;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IAEjB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAE1C,8BAA8B;IAC9B,aAAa,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IAE3C,iBAAiB;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAC;IAEhB,yBAAyB;IACzB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAIhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,IAAI,CAAC;IAEX,mBAAmB;IACnB,OAAO,EAAE,WAAW,CAAC;IAErB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,IAAI,CAAC;IAEX,mBAAmB;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,IAAI,CAAC;IAEX,mBAAmB;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB"}

package/dist/esm/src/testing/graph-tester/core/types.js

@@ -0,0 +1,21 @@
+/**
+ * Core types for the graph-based testing framework.
+ *
+ * This file is the contract between all packages - changes require consensus.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Predefined viewport presets.
+ */
+export const ViewportPresets = {
+    Desktop: { name: 'desktop', width: 1920, height: 1080 },
+    DesktopSmall: { name: 'desktop-small', width: 1366, height: 768 },
+    Laptop: { name: 'laptop', width: 1280, height: 720 },
+    TabletLandscape: { name: 'tablet-landscape', width: 1024, height: 768, isMobile: true, hasTouch: true },
+    TabletPortrait: { name: 'tablet-portrait', width: 768, height: 1024, isMobile: true, hasTouch: true },
+    MobileLarge: { name: 'mobile-large', width: 414, height: 896, isMobile: true, hasTouch: true },
+    Mobile: { name: 'mobile', width: 375, height: 812, isMobile: true, hasTouch: true },
+    MobileSmall: { name: 'mobile-small', width: 320, height: 568, isMobile: true, hasTouch: true },
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/src/testing/graph-tester/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyPH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,YAAY,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACjE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACpD,eAAe,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvG,cAAc,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrG,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACnF,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;CACtF,CAAC"}