devharness 0.8.0

package/build/reference-validator.test.js

@@ -0,0 +1,243 @@
+/**
+ * Unit tests for reference validation
+ */
+import { describe, it, expect } from 'vitest';
+import { validateReference, sanitizeReference, UNNAMED_CONNECTION, RESERVED_REFERENCES, } from './reference-validator.js';
+describe('sanitizeReference', () => {
+    it('should convert to lowercase', () => {
+        expect(sanitizeReference('Test Payment Flow')).toBe('test-payment-flow');
+    });
+    it('should trim whitespace', () => {
+        expect(sanitizeReference('  test payment flow  ')).toBe('test-payment-flow');
+    });
+    it('should replace multiple spaces with single hyphen', () => {
+        expect(sanitizeReference('test  payment  flow')).toBe('test-payment-flow');
+        expect(sanitizeReference('test   payment   flow')).toBe('test-payment-flow');
+    });
+    it('should handle tabs and newlines as whitespace', () => {
+        expect(sanitizeReference('test\tpayment\nflow')).toBe('test-payment-flow');
+    });
+    it('should handle mixed case', () => {
+        expect(sanitizeReference('TeSt PaYmEnT fLoW')).toBe('test-payment-flow');
+    });
+});
+describe('validateReference', () => {
+    describe('valid references', () => {
+        it('should accept exactly 3 words', () => {
+            const result = validateReference('test payment flow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-payment-flow');
+            expect(result.error).toBeUndefined();
+        });
+        it('should accept 3 words with extra whitespace', () => {
+            const result = validateReference('  test   payment   flow  ');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-payment-flow');
+        });
+        it('should accept 3 words with mixed case', () => {
+            const result = validateReference('Test Payment Flow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-payment-flow');
+        });
+        it('should accept 3 words with tabs and newlines', () => {
+            const result = validateReference('test\tpayment\nflow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-payment-flow');
+        });
+        it('should accept already-sanitized 3-part references', () => {
+            const result = validateReference('test-payment-flow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-payment-flow');
+        });
+        it('should accept already-sanitized references with uppercase', () => {
+            const result = validateReference('Test-Payment-Flow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-payment-flow');
+        });
+    });
+    describe('invalid word count', () => {
+        it('should reject 1 word', () => {
+            const result = validateReference('oneword');
+            expect(result.valid).toBe(false);
+            expect(result.sanitized).toBeUndefined();
+            expect(result.error).toBe('Reference must be exactly 3 words, got 1');
+        });
+        it('should reject 2 words', () => {
+            const result = validateReference('two words');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference must be exactly 3 words, got 2');
+        });
+        it('should reject 4 words', () => {
+            const result = validateReference('four words too many');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference must be exactly 3 words, got 4');
+        });
+        it('should reject 5+ words', () => {
+            const result = validateReference('this has way too many words here');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference must be exactly 3 words, got 7');
+        });
+    });
+    describe('empty input', () => {
+        it('should reject empty string', () => {
+            const result = validateReference('');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference cannot be empty');
+        });
+        it('should reject whitespace-only string', () => {
+            const result = validateReference('   ');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference cannot be empty');
+        });
+        it('should reject tabs and newlines only', () => {
+            const result = validateReference('\t\n  \t');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference cannot be empty');
+        });
+    });
+    describe('reserved words', () => {
+        it('should reject "no reference set"', () => {
+            const result = validateReference('no reference set');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should reject "none none none"', () => {
+            const result = validateReference('none none none');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should reject "unknown connection type"', () => {
+            const result = validateReference('unknown connection type');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should reject "unnamed connection default"', () => {
+            const result = validateReference('unnamed connection default');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should reject reserved words with different case', () => {
+            const result = validateReference('No Reference Set');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should reject reserved words with extra whitespace', () => {
+            const result = validateReference('  no   reference   set  ');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should verify reserved words are in hyphenated form', () => {
+            expect(RESERVED_REFERENCES).toContain('no-reference-set');
+            expect(RESERVED_REFERENCES).toContain('none-none-none');
+            expect(RESERVED_REFERENCES).toContain('unknown-connection-type');
+            expect(RESERVED_REFERENCES).toContain(UNNAMED_CONNECTION);
+        });
+    });
+    describe('bypass prevention', () => {
+        it('should prevent whitespace bypass for duplicates', () => {
+            // This was the critical bug: "test payment flow" and "test  payment  flow"
+            // would both become "test-payment-flow" but only the first would be caught
+            const ref1 = validateReference('test payment flow');
+            const ref2 = validateReference('test  payment  flow');
+            expect(ref1.valid).toBe(true);
+            expect(ref2.valid).toBe(true);
+            expect(ref1.sanitized).toBe(ref2.sanitized);
+            expect(ref1.sanitized).toBe('test-payment-flow');
+        });
+        it('should prevent case bypass for duplicates', () => {
+            const ref1 = validateReference('test payment flow');
+            const ref2 = validateReference('Test Payment Flow');
+            expect(ref1.valid).toBe(true);
+            expect(ref2.valid).toBe(true);
+            expect(ref1.sanitized).toBe(ref2.sanitized);
+        });
+        it('should prevent reserved word bypass with whitespace', () => {
+            // This was the critical bug: "no  reference  set" with extra spaces
+            // would pass validation but become "no-reference-set"
+            const result = validateReference('no  reference  set');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+        it('should prevent reserved word bypass with case', () => {
+            const result = validateReference('NO REFERENCE SET');
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('reserved and cannot be used');
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle unicode characters', () => {
+            const result = validateReference('café résumé naïve');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('café-résumé-naïve');
+        });
+        it('should handle numbers', () => {
+            const result = validateReference('test user 123');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-user-123');
+        });
+        it('should handle special characters in words', () => {
+            const result = validateReference('user@123 payment#flow test_case');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('user@123-payment#flow-test_case');
+        });
+        it('should handle emoji', () => {
+            const result = validateReference('test 🎉 flow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('test-🎉-flow');
+        });
+        it('should handle very long words', () => {
+            const longWord = 'a'.repeat(100);
+            const result = validateReference(`${longWord} test flow`);
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe(`${longWord}-test-flow`);
+        });
+    });
+    describe('sanitized format validation', () => {
+        it('should ensure sanitized version has exactly 3 parts', () => {
+            // Normal case: 3 words -> 3 hyphenated parts
+            const result1 = validateReference('test payment flow');
+            expect(result1.valid).toBe(true);
+            expect(result1.sanitized?.split('-').length).toBe(3);
+        });
+        it('should catch edge cases where sanitization creates different part count', () => {
+            // This is a safety check in case sanitization behaves unexpectedly
+            // The current implementation should always produce 3 parts for valid input
+            const result = validateReference('test payment flow');
+            expect(result.valid).toBe(true);
+            const parts = result.sanitized.split('-');
+            expect(parts.length).toBe(3);
+            expect(parts[0]).toBe('test');
+            expect(parts[1]).toBe('payment');
+            expect(parts[2]).toBe('flow');
+        });
+    });
+    describe('real-world examples', () => {
+        it('should accept debugging payment flow', () => {
+            const result = validateReference('debugging payment flow');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('debugging-payment-flow');
+        });
+        it('should accept testing api endpoints', () => {
+            const result = validateReference('testing api endpoints');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('testing-api-endpoints');
+        });
+        it('should accept search wikipedia results', () => {
+            const result = validateReference('search wikipedia results');
+            expect(result.valid).toBe(true);
+            expect(result.sanitized).toBe('search-wikipedia-results');
+        });
+        it('should accept hyphenated 3-part references', () => {
+            // These are now valid since we accept already-sanitized references
+            const result1 = validateReference('nodejs-api-server');
+            expect(result1.valid).toBe(true);
+            expect(result1.sanitized).toBe('nodejs-api-server');
+        });
+        it('should reject 2-part hyphenated references', () => {
+            const result = validateReference('chrome-browser');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Reference must be exactly 3 words, got 2');
+        });
+    });
+});
+//# sourceMappingURL=reference-validator.test.js.map

package/build/reference-validator.test.js.map

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

package/build/replay-cursor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Replay cursor overlay for visual feedback during interaction replay
+ */
+import type { Page } from 'puppeteer-core';
+/**
+ * Inject the replay cursor overlay into the page
+ */
+export declare function injectReplayCursor(page: Page): Promise<void>;
+/**
+ * Move the cursor to a position
+ */
+export declare function moveCursor(page: Page, x: number, y: number): Promise<void>;
+/**
+ * Show click effect (ripple and dot animation)
+ * Moves cursor to position first, waits for animation, then shows click effect
+ * @param isRightClick - true for right click (red), false for left click (green)
+ */
+export declare function showClickEffect(page: Page, x: number, y: number, isRightClick?: boolean): Promise<void>;
+/**
+ * Show key press indicator
+ */
+export declare function showKeyPress(page: Page, key: string): Promise<void>;
+/**
+ * Remove the replay cursor overlay
+ */
+export declare function removeReplayCursor(page: Page): Promise<void>;
+//# sourceMappingURL=replay-cursor.d.ts.map

package/build/replay-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-cursor.d.ts","sourceRoot":"","sources":["../src/replay-cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA8GlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDpH;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDzE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAelE"}

package/build/replay-cursor.js

@@ -0,0 +1,240 @@
+/**
+ * Replay cursor overlay for visual feedback during interaction replay
+ */
+/**
+ * Inject the replay cursor overlay into the page
+ */
+export async function injectReplayCursor(page) {
+    await page.evaluate(() => {
+        const doc = globalThis.document;
+        // Remove existing cursor if any
+        const existing = doc.getElementById('__cdp-replay-cursor');
+        if (existing)
+            existing.remove();
+        // Create cursor element using DOM methods (Trusted Types compatible)
+        const cursor = doc.createElement('div');
+        cursor.id = '__cdp-replay-cursor';
+        // Create pointer container
+        const pointer = doc.createElement('div');
+        pointer.className = 'cdp-cursor-pointer';
+        // Create SVG cursor icon using DOM methods
+        const svg = doc.createElementNS('http://www.w3.org/2000/svg', 'svg');
+        svg.setAttribute('width', '24');
+        svg.setAttribute('height', '24');
+        svg.setAttribute('viewBox', '0 0 24 24');
+        svg.setAttribute('fill', 'none');
+        const path = doc.createElementNS('http://www.w3.org/2000/svg', 'path');
+        path.setAttribute('d', 'M5.5 3.21V20.8C5.5 21.51 6.37 21.88 6.88 21.37L10.73 17.52L14.25 22.5L17.5 20.5L14 15.5H19.5C20.21 15.5 20.58 14.63 20.07 14.12L6.08 3.08C5.57 2.57 5.5 2.5 5.5 3.21Z');
+        path.setAttribute('fill', 'black');
+        path.setAttribute('stroke', 'white');
+        path.setAttribute('stroke-width', '1.5');
+        svg.appendChild(path);
+        pointer.appendChild(svg);
+        // Create ripple element
+        const ripple = doc.createElement('div');
+        ripple.className = 'cdp-cursor-ripple';
+        cursor.appendChild(pointer);
+        cursor.appendChild(ripple);
+        const style = doc.createElement('style');
+        style.id = '__cdp-replay-cursor-style';
+        style.textContent = `
+      #__cdp-replay-cursor {
+        position: fixed;
+        pointer-events: none;
+        z-index: 2147483647;
+        transition: left 0.15s ease-out, top 0.15s ease-out;
+        left: 0;
+        top: 0;
+      }
+
+      .cdp-cursor-pointer {
+        transition: transform 0.1s;
+      }
+
+      .cdp-cursor-pointer.clicking {
+        transform: scale(0.9);
+      }
+
+      .cdp-cursor-pointer svg path {
+        transition: fill 0.1s;
+      }
+
+      .cdp-cursor-pointer.right-click svg path {
+        fill: #ef4444;
+      }
+
+      .cdp-cursor-ripple {
+        position: absolute;
+        top: 4px;
+        left: 4px;
+        width: 16px;
+        height: 16px;
+        border-radius: 50%;
+        pointer-events: none;
+        opacity: 0;
+      }
+
+      .cdp-cursor-ripple.active {
+        animation: cdp-ripple 0.4s ease-out forwards;
+      }
+
+      .cdp-cursor-ripple.left {
+        border: 2px solid #22c55e;
+      }
+
+      .cdp-cursor-ripple.right {
+        border: 2px solid #ef4444;
+      }
+
+      @keyframes cdp-ripple {
+        0% {
+          width: 16px;
+          height: 16px;
+          opacity: 1;
+        }
+        100% {
+          width: 60px;
+          height: 60px;
+          opacity: 0;
+        }
+      }
+    `;
+        doc.head.appendChild(style);
+        doc.body.appendChild(cursor);
+        // Store reference for later access
+        globalThis.__cdpReplayCursor = cursor;
+    });
+}
+/**
+ * Move the cursor to a position
+ */
+export async function moveCursor(page, x, y) {
+    await page.evaluate(({ x, y }) => {
+        const doc = globalThis.document;
+        const cursor = doc.getElementById('__cdp-replay-cursor');
+        if (cursor) {
+            cursor.style.left = `${x}px`;
+            cursor.style.top = `${y}px`;
+        }
+    }, { x, y });
+}
+/**
+ * Show click effect (ripple and dot animation)
+ * Moves cursor to position first, waits for animation, then shows click effect
+ * @param isRightClick - true for right click (red), false for left click (green)
+ */
+export async function showClickEffect(page, x, y, isRightClick = false) {
+    // First move the cursor to the target position
+    await page.evaluate(({ x, y }) => {
+        const doc = globalThis.document;
+        const cursor = doc.getElementById('__cdp-replay-cursor');
+        if (cursor) {
+            cursor.style.left = `${x}px`;
+            cursor.style.top = `${y}px`;
+        }
+    }, { x, y });
+    // Wait for the cursor movement animation (150ms transition + small buffer)
+    await new Promise(resolve => setTimeout(resolve, 180));
+    // Then show the click effect
+    await page.evaluate(({ isRightClick }) => {
+        const doc = globalThis.document;
+        const cursor = doc.getElementById('__cdp-replay-cursor');
+        if (!cursor)
+            return;
+        const pointer = cursor.querySelector('.cdp-cursor-pointer');
+        const ripple = cursor.querySelector('.cdp-cursor-ripple');
+        if (pointer) {
+            pointer.classList.add('clicking');
+            if (isRightClick) {
+                pointer.classList.add('right-click');
+            }
+            setTimeout(() => {
+                pointer.classList.remove('clicking');
+                if (isRightClick) {
+                    pointer.classList.remove('right-click');
+                }
+            }, 150);
+        }
+        if (ripple) {
+            // Reset ripple
+            ripple.classList.remove('active', 'left', 'right');
+            ripple.offsetHeight; // Force reflow
+            // Add appropriate class and trigger animation
+            ripple.classList.add('active', isRightClick ? 'right' : 'left');
+            // Remove classes after animation
+            setTimeout(() => {
+                ripple.classList.remove('active', 'left', 'right');
+            }, 400);
+        }
+    }, { isRightClick });
+}
+/**
+ * Show key press indicator
+ */
+export async function showKeyPress(page, key) {
+    await page.evaluate((key) => {
+        const doc = globalThis.document;
+        // Remove existing key indicator
+        const existing = doc.getElementById('__cdp-replay-key');
+        if (existing)
+            existing.remove();
+        const indicator = doc.createElement('div');
+        indicator.id = '__cdp-replay-key';
+        indicator.textContent = key.length === 1 ? key : `[${key}]`;
+        indicator.style.cssText = `
+      position: fixed;
+      bottom: 20px;
+      left: 50%;
+      transform: translateX(-50%);
+      background: rgba(0, 0, 0, 0.8);
+      color: white;
+      padding: 8px 16px;
+      border-radius: 8px;
+      font-family: monospace;
+      font-size: 14px;
+      z-index: 2147483647;
+      pointer-events: none;
+      animation: cdp-key-fade 1.5s ease-out forwards;
+    `;
+        // Add animation keyframes if not already present
+        if (!doc.getElementById('__cdp-key-style')) {
+            const style = doc.createElement('style');
+            style.id = '__cdp-key-style';
+            style.textContent = `
+        @keyframes cdp-key-fade {
+          0% { opacity: 1; transform: translateX(-50%) translateY(0); }
+          80% { opacity: 1; }
+          100% { opacity: 0; transform: translateX(-50%) translateY(-10px); }
+        }
+      `;
+            doc.head.appendChild(style);
+        }
+        doc.body.appendChild(indicator);
+        // Remove after animation
+        setTimeout(() => {
+            indicator.remove();
+        }, 1500);
+    }, key);
+}
+/**
+ * Remove the replay cursor overlay
+ */
+export async function removeReplayCursor(page) {
+    await page.evaluate(() => {
+        const doc = globalThis.document;
+        const cursor = doc.getElementById('__cdp-replay-cursor');
+        const style = doc.getElementById('__cdp-replay-cursor-style');
+        const keyStyle = doc.getElementById('__cdp-key-style');
+        const keyIndicator = doc.getElementById('__cdp-replay-key');
+        if (cursor)
+            cursor.remove();
+        if (style)
+            style.remove();
+        if (keyStyle)
+            keyStyle.remove();
+        if (keyIndicator)
+            keyIndicator.remove();
+        delete globalThis.__cdpReplayCursor;
+    });
+}
+//# sourceMappingURL=replay-cursor.js.map

package/build/replay-cursor.js.map

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

package/build/runners/docker-compose-runner.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Docker Compose Runner
+ * Runs services using Docker Compose CLI
+ */
+import type { Runner, RunnerType, RunnerStartOptions, RunnerStartResult, RunnerStopOptions, RunnerLogOptions, RunnerStatus, PersistedRunnerState } from './types.js';
+/**
+ * Reset the Docker Compose availability cache.
+ * Called before autoRun to ensure Docker is checked fresh.
+ */
+export declare function resetComposeCheck(): void;
+export declare class DockerComposeRunner implements Runner {
+    readonly type: RunnerType;
+    private id;
+    private command;
+    private cwd;
+    private projectName;
+    private port;
+    private startedAt;
+    private lastLogTimestamp;
+    private composeFile;
+    private env;
+    constructor(id: string);
+    /**
+     * Restore state from persisted data
+     */
+    restore(data: PersistedRunnerState): void;
+    /**
+     * Detect compose file from cwd
+     */
+    private detectComposeFile;
+    /**
+     * Get the docker compose command and cache it
+     * @returns The compose command to use
+     */
+    private getComposeCommand;
+    /**
+     * Execute docker compose command using spawn with args array (prevents shell injection)
+     */
+    private execCompose;
+    /**
+     * Parse the docker compose command to extract flags
+     */
+    private parseCommand;
+    start(options: RunnerStartOptions): Promise<RunnerStartResult>;
+    stop(options?: RunnerStopOptions): Promise<void>;
+    isRunning(): Promise<boolean>;
+    getStatus(): Promise<RunnerStatus>;
+    getLogs(options?: RunnerLogOptions): Promise<string[]>;
+    detectPort(): Promise<number | null>;
+    cleanup(): Promise<void>;
+    /** Getters for state persistence */
+    getId(): string;
+    getCommand(): string;
+    getCwd(): string;
+    getPid(): number;
+    getPort(): number | null;
+    getStartedAt(): Date | null;
+    getProjectName(): string;
+    /** Setters */
+    setPort(port: number): void;
+    /**
+     * Get log access info
+     */
+    getLogAccess(): {
+        type: 'command';
+        command: string;
+    };
+}
+//# sourceMappingURL=docker-compose-runner.d.ts.map

package/build/runners/docker-compose-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-compose-runner.d.ts","sourceRoot":"","sources":["../../src/runners/docker-compose-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA6EpB;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,qBAAa,mBAAoB,YAAW,MAAM;IAChD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAoB;IAE7C,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,GAAG,CAA8B;gBAE7B,EAAE,EAAE,MAAM;IAMtB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAQzC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqDnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBd,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4C9D,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBhD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IA0B7B,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAoClC,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyCtD,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkDpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,oCAAoC;IACpC,KAAK,IAAI,MAAM;IACf,UAAU,IAAI,MAAM;IACpB,MAAM,IAAI,MAAM;IAChB,MAAM,IAAI,MAAM;IAChB,OAAO,IAAI,MAAM,GAAG,IAAI;IACxB,YAAY,IAAI,IAAI,GAAG,IAAI;IAC3B,cAAc,IAAI,MAAM;IAExB,cAAc;IACd,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE3B;;OAEG;IACH,YAAY,IAAI;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAUrD"}