vaspera 2.9.2 → 2.10.1

package/dist/scanners/runtime/golden-path-runner.js

@@ -0,0 +1,373 @@
+/**
+ * Golden Path Runner
+ *
+ * Executes user-defined flows against a running app using Playwright.
+ * Flows are defined in YAML files under .vaspera/flows/
+ *
+ * @module scanners/runtime/golden-path-runner
+ */
+import { readFile, readdir, mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { parse as parseYaml } from "yaml";
+import { logger } from "../../logger.js";
+import { GoldenPathFlowSchema, } from "./types.js";
+const FLOWS_DIR = ".vaspera/flows";
+const SCREENSHOTS_DIR = ".vaspera/screenshots";
+/**
+ * Load a golden path flow from a YAML file
+ */
+export async function loadFlow(flowPath) {
+    const content = await readFile(flowPath, "utf-8");
+    const parsed = parseYaml(content);
+    return GoldenPathFlowSchema.parse(parsed);
+}
+/**
+ * Discover all flows in a project
+ */
+export async function discoverFlows(projectPath) {
+    const flowsDir = join(projectPath, FLOWS_DIR);
+    const flows = [];
+    try {
+        const files = await readdir(flowsDir);
+        for (const file of files) {
+            if (file.endsWith(".yaml") || file.endsWith(".yml")) {
+                try {
+                    const flowPath = join(flowsDir, file);
+                    const flow = await loadFlow(flowPath);
+                    flows.push({ path: flowPath, flow });
+                }
+                catch (error) {
+                    logger.warn("runtime.flow_parse_error", {
+                        file,
+                        error: error.message,
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        logger.debug("runtime.no_flows_directory", { path: flowsDir });
+    }
+    return flows;
+}
+/**
+ * Execute a single step (without Playwright - basic HTTP/assertion version)
+ * This is a lightweight version for initial implementation.
+ * Full Playwright integration will be added as a separate module.
+ */
+async function executeStep(step, stepIndex, baseUrl, context) {
+    const startTime = Date.now();
+    try {
+        switch (step.action) {
+            case "navigate": {
+                const url = step.url?.startsWith("http")
+                    ? step.url
+                    : `${baseUrl}${step.url}`;
+                const response = await fetch(url, {
+                    method: "GET",
+                    signal: AbortSignal.timeout(step.timeout || 10000),
+                });
+                context.currentUrl = url;
+                context.lastResponse = response;
+                return {
+                    step: stepIndex,
+                    action: step.action,
+                    success: response.ok,
+                    duration: Date.now() - startTime,
+                    error: response.ok ? undefined : `HTTP ${response.status}`,
+                };
+            }
+            case "api": {
+                const url = step.url?.startsWith("http")
+                    ? step.url
+                    : `${baseUrl}${step.url}`;
+                const response = await fetch(url, {
+                    method: step.method || "GET",
+                    headers: {
+                        "Content-Type": "application/json",
+                        ...step.headers,
+                    },
+                    body: step.body ? JSON.stringify(step.body) : undefined,
+                    signal: AbortSignal.timeout(step.timeout || 10000),
+                });
+                context.lastResponse = response;
+                return {
+                    step: stepIndex,
+                    action: step.action,
+                    success: response.ok,
+                    duration: Date.now() - startTime,
+                    error: response.ok ? undefined : `HTTP ${response.status}`,
+                };
+            }
+            case "assert": {
+                // For assertions, we need Playwright for DOM checks
+                // For now, support URL assertions only
+                if (step.url) {
+                    const passed = context.currentUrl.includes(step.url);
+                    return {
+                        step: stepIndex,
+                        action: step.action,
+                        success: passed,
+                        duration: Date.now() - startTime,
+                        assertion: {
+                            expected: step.url,
+                            actual: context.currentUrl,
+                            passed,
+                        },
+                    };
+                }
+                // DOM assertions require Playwright - return skipped
+                return {
+                    step: stepIndex,
+                    action: step.action,
+                    success: true,
+                    duration: Date.now() - startTime,
+                    error: "DOM assertions require Playwright (skipped)",
+                };
+            }
+            case "wait": {
+                const waitTime = step.timeout || 1000;
+                await new Promise((resolve) => setTimeout(resolve, waitTime));
+                return {
+                    step: stepIndex,
+                    action: step.action,
+                    success: true,
+                    duration: Date.now() - startTime,
+                };
+            }
+            case "click":
+            case "fill":
+            case "select":
+            case "screenshot": {
+                // These require Playwright - return skipped
+                return {
+                    step: stepIndex,
+                    action: step.action,
+                    success: true,
+                    duration: Date.now() - startTime,
+                    error: `${step.action} requires Playwright (skipped)`,
+                };
+            }
+            default:
+                return {
+                    step: stepIndex,
+                    action: step.action,
+                    success: false,
+                    duration: Date.now() - startTime,
+                    error: `Unknown action: ${step.action}`,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            step: stepIndex,
+            action: step.action,
+            success: false,
+            duration: Date.now() - startTime,
+            error: error.message,
+        };
+    }
+}
+/**
+ * Run a golden path flow
+ *
+ * By default uses lightweight HTTP-based execution.
+ * Pass usePlaywright: true to use full browser automation.
+ */
+export async function runFlow(flow, baseUrl, options = {}) {
+    // Try Playwright if requested
+    if (options.usePlaywright) {
+        try {
+            const { isPlaywrightAvailable, runFlowWithPlaywright } = await import("./playwright-executor.js");
+            if (await isPlaywrightAvailable()) {
+                return runFlowWithPlaywright(flow, baseUrl, {
+                    headless: options.headless,
+                    slowMo: options.slowMo,
+                    screenshotsDir: options.screenshotsDir,
+                });
+            }
+            logger.warn("runtime.playwright_requested_but_unavailable");
+        }
+        catch {
+            logger.warn("runtime.playwright_import_failed");
+        }
+    }
+    // Fall back to HTTP-based execution
+    const startTime = Date.now();
+    const stepResults = [];
+    const screenshots = [];
+    let failed = false;
+    const context = {
+        currentUrl: baseUrl,
+        lastResponse: undefined,
+    };
+    logger.info("runtime.flow_started", {
+        name: flow.name,
+        steps: flow.steps.length,
+    });
+    for (let i = 0; i < flow.steps.length; i++) {
+        const step = flow.steps[i];
+        if (failed) {
+            // Skip remaining steps after a failure
+            stepResults.push({
+                step: i,
+                action: step.action,
+                success: false,
+                duration: 0,
+                error: "Skipped due to previous failure",
+            });
+            continue;
+        }
+        const result = await executeStep(step, i, baseUrl, context);
+        stepResults.push(result);
+        if (!result.success && !result.error?.includes("skipped")) {
+            failed = true;
+            logger.warn("runtime.step_failed", {
+                flow: flow.name,
+                step: i,
+                action: step.action,
+                error: result.error,
+            });
+        }
+        else {
+            logger.debug("runtime.step_passed", {
+                flow: flow.name,
+                step: i,
+                action: step.action,
+                duration: result.duration,
+            });
+        }
+    }
+    const passedSteps = stepResults.filter((r) => r.success && !r.error?.includes("skipped")).length;
+    const failedSteps = stepResults.filter((r) => !r.success && !r.error?.includes("skipped")).length;
+    logger.info("runtime.flow_completed", {
+        name: flow.name,
+        passed: passedSteps,
+        failed: failedSteps,
+        duration: Date.now() - startTime,
+    });
+    return {
+        flowName: flow.name,
+        success: !failed,
+        totalSteps: flow.steps.length,
+        passedSteps,
+        failedSteps,
+        duration: Date.now() - startTime,
+        steps: stepResults,
+        screenshots,
+    };
+}
+/**
+ * Run all flows in a project
+ */
+export async function runAllFlows(projectPath, baseUrl, options = {}) {
+    const discoveredFlows = await discoverFlows(projectPath);
+    const results = [];
+    // Filter by priority if specified
+    let flows = discoveredFlows;
+    if (options.priority) {
+        const priorities = [
+            "critical",
+            "high",
+            "medium",
+            "low",
+        ];
+        const minPriorityIndex = priorities.indexOf(options.priority);
+        flows = flows.filter((f) => {
+            const flowPriorityIndex = priorities.indexOf(f.flow.priority || "medium");
+            return flowPriorityIndex <= minPriorityIndex;
+        });
+    }
+    // Filter by tags if specified
+    if (options.tags && options.tags.length > 0) {
+        flows = flows.filter((f) => f.flow.tags?.some((tag) => options.tags?.includes(tag)));
+    }
+    // Sort by priority (critical first)
+    const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+    flows.sort((a, b) => priorityOrder[a.flow.priority || "medium"] -
+        priorityOrder[b.flow.priority || "medium"]);
+    logger.info("runtime.running_flows", {
+        total: flows.length,
+        priority: options.priority,
+    });
+    for (const { flow } of flows) {
+        const result = await runFlow(flow, flow.baseUrl || baseUrl, {
+            usePlaywright: options.usePlaywright,
+            headless: options.headless,
+            slowMo: options.slowMo,
+            screenshotsDir: options.screenshotsDir,
+        });
+        results.push(result);
+        // Stop on critical flow failure
+        if (!result.success && flow.priority === "critical") {
+            logger.error("runtime.critical_flow_failed", { name: flow.name });
+            break;
+        }
+    }
+    return results;
+}
+/**
+ * Generate a sample flow file
+ */
+export async function generateSampleFlow(projectPath, name = "sample") {
+    const flowsDir = join(projectPath, FLOWS_DIR);
+    // Ensure directory exists
+    await mkdir(flowsDir, { recursive: true });
+    const sampleFlow = `# ${name} Golden Path Flow
+# Define user flows to verify your app works correctly
+
+name: "${name}"
+description: "Sample golden path flow - customize for your app"
+priority: medium
+tags:
+  - sample
+  - smoke-test
+
+steps:
+  # Navigate to the home page
+  - action: navigate
+    url: "/"
+    description: "Load home page"
+
+  # Verify home page loaded
+  - action: assert
+    url: "/"
+    description: "Verify on home page"
+
+  # Wait for any async content
+  - action: wait
+    timeout: 1000
+    description: "Wait for page to settle"
+
+  # Test an API endpoint
+  - action: api
+    url: "/api/health"
+    method: GET
+    description: "Check health endpoint"
+
+  # Navigate to another page
+  # - action: navigate
+  #   url: "/about"
+  #   description: "Go to about page"
+
+  # Fill a form (requires Playwright)
+  # - action: fill
+  #   selector: "#email"
+  #   value: "test@example.com"
+  #   description: "Enter email"
+
+  # Click a button (requires Playwright)
+  # - action: click
+  #   selector: "[data-testid='submit']"
+  #   description: "Submit form"
+
+  # Take a screenshot (requires Playwright)
+  # - action: screenshot
+  #   description: "Capture final state"
+`;
+    const flowPath = join(flowsDir, `${name}.yaml`);
+    await writeFile(flowPath, sampleFlow, "utf-8");
+    logger.info("runtime.sample_flow_created", { path: flowPath });
+    return flowPath;
+}
+//# sourceMappingURL=golden-path-runner.js.map

package/dist/scanners/runtime/golden-path-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-path-runner.js","sourceRoot":"","sources":["../../../src/scanners/runtime/golden-path-runner.ts"],"names":[],"mappings":"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"}

package/dist/scanners/runtime/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Runtime Verification Scanner
+ *
+ * Orchestrates app launching, golden path testing, and runtime verification.
+ * This is the entry point for M7 runtime verification capabilities.
+ *
+ * @module scanners/runtime
+ */
+import type { RuntimeVerificationResult, GoldenPathFlow } from "./types.js";
+export * from "./types.js";
+export { detectFramework, launchApp, stopApp, stopAllApps, getRunningApps, } from "./app-launcher.js";
+export { discoverFlows, runFlow, runAllFlows, generateSampleFlow, loadFlow, } from "./golden-path-runner.js";
+export { isPlaywrightAvailable, launchBrowser, closeBrowser, runFlowWithPlaywright, } from "./playwright-executor.js";
+/**
+ * Run full runtime verification
+ *
+ * 1. Detect framework
+ * 2. Launch the app
+ * 3. Run golden path flows
+ * 4. Calculate score
+ * 5. Stop the app
+ */
+export declare function runRuntimeVerification(projectPath: string, options?: {
+    port?: number;
+    timeout?: number;
+    priority?: GoldenPathFlow["priority"];
+    stopAfter?: boolean;
+}): Promise<RuntimeVerificationResult>;
+/**
+ * Quick health check - just launch and verify app starts
+ */
+export declare function quickHealthCheck(projectPath: string, options?: {
+    port?: number;
+    timeout?: number;
+}): Promise<{
+    healthy: boolean;
+    url: string;
+    startupTime: number;
+    error?: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/scanners/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scanners/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,OAAO,KAAK,EACV,yBAAyB,EAGzB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,QAAQ,GACT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAiDlC;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,OAAO,CAAC,yBAAyB,CAAC,CAuFpC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBjF"}

package/dist/scanners/runtime/index.js

@@ -0,0 +1,164 @@
+/**
+ * Runtime Verification Scanner
+ *
+ * Orchestrates app launching, golden path testing, and runtime verification.
+ * This is the entry point for M7 runtime verification capabilities.
+ *
+ * @module scanners/runtime
+ */
+import { logger } from "../../logger.js";
+import { detectFramework, launchApp, stopApp, } from "./app-launcher.js";
+import { runAllFlows, } from "./golden-path-runner.js";
+export * from "./types.js";
+export { detectFramework, launchApp, stopApp, stopAllApps, getRunningApps, } from "./app-launcher.js";
+export { discoverFlows, runFlow, runAllFlows, generateSampleFlow, loadFlow, } from "./golden-path-runner.js";
+export { isPlaywrightAvailable, launchBrowser, closeBrowser, runFlowWithPlaywright, } from "./playwright-executor.js";
+/**
+ * Calculate runtime verification score
+ */
+function calculateScore(goldenPathResults) {
+    const goldenPathsTotal = goldenPathResults.length;
+    const goldenPathsPassed = goldenPathResults.filter((r) => r.success).length;
+    // Calculate overall score (0-100)
+    let overallScore = 0;
+    if (goldenPathsTotal > 0) {
+        // Golden paths are weighted by priority
+        const priorityWeights = { critical: 3, high: 2, medium: 1.5, low: 1 };
+        let weightedPassed = 0;
+        let totalWeight = 0;
+        for (const result of goldenPathResults) {
+            // Infer priority from flow name or default to medium
+            const priority = "medium"; // TODO: Store priority in result
+            const weight = priorityWeights[priority];
+            totalWeight += weight;
+            if (result.success) {
+                weightedPassed += weight;
+            }
+        }
+        if (totalWeight > 0) {
+            overallScore = Math.round((weightedPassed / totalWeight) * 100);
+        }
+    }
+    else {
+        // No flows defined - partial score
+        overallScore = 50; // Neutral score when no flows
+    }
+    return {
+        goldenPathsPassed,
+        goldenPathsTotal,
+        visualRegressionsPassed: 0, // TODO: Implement visual regression
+        visualRegressionsTotal: 0,
+        apiTestsPassed: 0, // Counted within golden paths for now
+        apiTestsTotal: 0,
+        overallScore,
+    };
+}
+/**
+ * Run full runtime verification
+ *
+ * 1. Detect framework
+ * 2. Launch the app
+ * 3. Run golden path flows
+ * 4. Calculate score
+ * 5. Stop the app
+ */
+export async function runRuntimeVerification(projectPath, options = {}) {
+    const startTime = Date.now();
+    const { port, timeout = 60000, priority, stopAfter = true } = options;
+    logger.info("runtime.verification_started", { projectPath });
+    // Step 1: Detect framework
+    const detection = await detectFramework(projectPath);
+    logger.info("runtime.framework_detected", {
+        framework: detection.framework,
+        confidence: detection.confidence,
+    });
+    // Step 2: Launch the app
+    const launchConfig = {
+        projectPath,
+        framework: detection.framework,
+        port: port || detection.port,
+        timeout,
+    };
+    const launchResult = await launchApp(launchConfig);
+    if (!launchResult.success) {
+        return {
+            success: false,
+            framework: detection.framework,
+            appUrl: launchResult.url,
+            duration: Date.now() - startTime,
+            goldenPaths: [],
+            visualRegressions: [],
+            score: {
+                goldenPathsPassed: 0,
+                goldenPathsTotal: 0,
+                visualRegressionsPassed: 0,
+                visualRegressionsTotal: 0,
+                apiTestsPassed: 0,
+                apiTestsTotal: 0,
+                overallScore: 0,
+            },
+            error: launchResult.error || "App failed to start",
+        };
+    }
+    logger.info("runtime.app_launched", {
+        url: launchResult.url,
+        startupTime: launchResult.startupTime,
+    });
+    // Step 3: Run golden path flows
+    let goldenPathResults = [];
+    try {
+        goldenPathResults = await runAllFlows(projectPath, launchResult.url, {
+            priority,
+        });
+    }
+    catch (error) {
+        logger.error("runtime.golden_path_error", {
+            error: error.message,
+        });
+    }
+    // Step 4: Calculate score
+    const score = calculateScore(goldenPathResults);
+    // Step 5: Stop the app
+    if (stopAfter) {
+        await stopApp(projectPath, launchResult.port);
+    }
+    const result = {
+        success: score.overallScore >= 70, // Threshold for "passing"
+        framework: detection.framework,
+        appUrl: launchResult.url,
+        duration: Date.now() - startTime,
+        goldenPaths: goldenPathResults,
+        visualRegressions: [], // TODO: Implement
+        score,
+    };
+    logger.info("runtime.verification_completed", {
+        success: result.success,
+        score: score.overallScore,
+        duration: result.duration,
+    });
+    return result;
+}
+/**
+ * Quick health check - just launch and verify app starts
+ */
+export async function quickHealthCheck(projectPath, options = {}) {
+    const { port, timeout = 30000 } = options;
+    const detection = await detectFramework(projectPath);
+    const launchResult = await launchApp({
+        projectPath,
+        framework: detection.framework,
+        port: port || detection.port,
+        timeout,
+    });
+    // Always stop after health check
+    if (launchResult.pid) {
+        await stopApp(projectPath, launchResult.port);
+    }
+    return {
+        healthy: launchResult.success && launchResult.healthStatus === "healthy",
+        url: launchResult.url,
+        startupTime: launchResult.startupTime,
+        error: launchResult.error,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/scanners/runtime/index.js.map

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

package/dist/scanners/runtime/playwright-executor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Playwright Executor
+ *
+ * Executes golden path steps using Playwright for full browser automation.
+ * This module is optional - falls back to HTTP-based execution when Playwright
+ * is not available.
+ *
+ * @module scanners/runtime/playwright-executor
+ */
+import type { GoldenPathFlow, StepResult } from "./types.js";
+/**
+ * Check if Playwright is available
+ */
+export declare function isPlaywrightAvailable(): Promise<boolean>;
+/**
+ * Launch browser for testing
+ */
+export declare function launchBrowser(options?: {
+    headless?: boolean;
+    slowMo?: number;
+}): Promise<boolean>;
+/**
+ * Close browser
+ */
+export declare function closeBrowser(): Promise<void>;
+/**
+ * Execute a step using Playwright
+ */
+export declare function executeStepWithPlaywright(step: GoldenPathFlow["steps"][0], stepIndex: number, baseUrl: string, context: {
+    currentUrl: string;
+    screenshotsDir?: string;
+}): Promise<StepResult>;
+/**
+ * Run a complete flow with Playwright
+ */
+export declare function runFlowWithPlaywright(flow: GoldenPathFlow, baseUrl: string, options?: {
+    headless?: boolean;
+    slowMo?: number;
+    screenshotsDir?: string;
+}): Promise<{
+    flowName: string;
+    success: boolean;
+    totalSteps: number;
+    passedSteps: number;
+    failedSteps: number;
+    duration: number;
+    steps: StepResult[];
+    screenshots: string[];
+}>;
+//# sourceMappingURL=playwright-executor.d.ts.map

package/dist/scanners/runtime/playwright-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-executor.d.ts","sourceRoot":"","sources":["../../../src/scanners/runtime/playwright-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7D;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAe9D;AAUD;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBxB;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,UAAU,CAAC,CA0OrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,CAwGD"}