browser-debugger-cli 0.5.1 → 0.6.0

package/README.md

@@ -5,7 +5,7 @@
 [![Security](https://github.com/szymdzum/browser-debugger-cli/actions/workflows/security.yml/badge.svg)](https://github.com/szymdzum/browser-debugger-cli/actions/workflows/security.yml)
 [![npm downloads](https://img.shields.io/npm/dt/browser-debugger-cli?color=blue)](https://www.npmjs.com/package/browser-debugger-cli)
 
-Chrome DevTools Protocol in your terminal. Run any CDP command, pipe the output, build browser automation with tools you already know. Design to be agent friendly
+Chrome DevTools Protocol in your terminal. Self-documenting CDP access with discovery, search, and introspection. Perfect for AI agents and developers who want direct browser control without the framework overhead.
 
 ## Why This Exists
 Puppeteer is great but heavy. CDP is powerful but raw. This tool sits in between: direct protocol access with session management and a few helpful wrappers. No abstractions hiding what's actually happening.
@@ -42,9 +42,14 @@ The CLI uses Unix domain sockets for inter-process communication. Windows users
 # Start a session
 bdg example.com
 
+# Discover what's available
+bdg cdp --list                    # List all 53 domains
+bdg cdp Network --list            # List Network methods
+bdg cdp --search cookie           # Search by keyword
+
 # Run any CDP command
-bdg cdp Runtime.evaluate --params '{"expression":"document.title","returnByValue":true}'
 bdg cdp Network.getCookies
+bdg cdp Runtime.evaluate --params '{"expression":"document.title","returnByValue":true}'
 
 # Check what's running
 bdg status
@@ -55,6 +60,30 @@ bdg stop
 
 ## What You Can Do
 
+### Discover CDP Commands (53 Domains, 300+ Methods)
+
+Built-in introspection helps you find what you need without reading docs:
+
+```bash
+# What can I do with this browser?
+bdg cdp --list
+# Returns: 53 domains (Network, DOM, Page, Runtime, Storage, etc.)
+
+# What Network operations exist?
+bdg cdp Network --list
+# Returns: 39 methods with descriptions and parameter counts
+
+# How do I use this method?
+bdg cdp Network.getCookies --describe
+# Returns: Full schema with parameters, types, examples
+
+# Find cookie-related methods
+bdg cdp --search cookie
+# Returns: 14 methods across domains (Network.getCookies, Storage.getCookies, etc.)
+```
+
+All discovery commands output JSON for easy parsing. Perfect for AI agents building automation on the fly.
+
 ### Run Any CDP Command
 
 All 300+ methods from [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) work out of the box:
@@ -95,6 +124,25 @@ bdg peek --console --json | jq '[.data.console[] | select(.level == "error")] |
 
 ### For AI Agents
 
+**Self-documenting CDP discovery** - agents can explore 300+ browser capabilities without external docs:
+
+```bash
+# Agent discovers what's possible
+bdg cdp --list                           # 53 domains available
+bdg cdp --search screenshot              # Find relevant methods
+bdg cdp Page.captureScreenshot --describe # Learn parameters
+bdg cdp Page.captureScreenshot --params '{"format":"png"}' # Execute
+
+# All commands return structured JSON for easy parsing
+```
+
+**Why this matters for agents:**
+- No need to memorize CDP docs (1000+ pages)
+- Discover → Learn → Execute in one tool
+- Search by keyword (`--search`)
+- Case-insensitive execution (forgiving for LLM outputs)
+- Semantic exit codes for error handling
+
 Claude skill included at `.claude/skills/bdg/` with working automation patterns:
 
 - Common CDP workflows (scraping, polling, navigation)
@@ -108,8 +156,6 @@ bdg --help --json | jq '.command.subcommands[].name'
 bdg --help --json | jq '.exitCodes'
 ```
 
-Agents can figure out what commands exist and how to use them without hardcoded knowledge.
-
 ### Debug Live Apps
 
 Point at localhost, monitor what's happening:

package/dist/__tests__/smoke/error-handling.smoke.test.js

@@ -31,17 +31,6 @@ void describe('Error Handling Smoke Tests', () => {
         // Should provide helpful error message
         assert.ok(result.stderr.includes('daemon'));
     });
-    void it('should handle invalid URL gracefully', async () => {
-        // Note: URL validation is permissive - "not-a-valid-url" becomes "http://not-a-valid-url/"
-        // This test verifies error handling, not URL validation
-        const result = await runCommand('http://example.com', ['--port', '9229', '--headless'], {
-            timeout: 10000,
-        });
-        // Should succeed (URL is valid, session starts)
-        assert.equal(result.exitCode, 0);
-        // Should provide session started message
-        assert.ok(/session started|target:/i.test(result.stderr));
-    });
     void it('should handle daemon crash during session', async () => {
         // Start session with unique port
         await runCommand('http://example.com', ['--port', '9230', '--headless'], { timeout: 10000 });

package/dist/__tests__/smoke/error-handling.smoke.test.js.map

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

package/dist/cdp/protocol.d.ts

@@ -0,0 +1,121 @@
+/**
+ * CDP Protocol Schema Loader
+ *
+ * Loads and parses the Chrome DevTools Protocol schema from the bundled
+ * devtools-protocol package. Provides utilities for domain/method lookup
+ * and introspection.
+ */
+import type { ProtocolSchema, Domain, Command } from './types.js';
+/**
+ * Load the CDP protocol schema.
+ *
+ * Merges browser_protocol.json and js_protocol.json from devtools-protocol package.
+ * The browser protocol contains domains like Network, Page, DOM, etc.
+ * The JS protocol contains Runtime, Debugger, Console, Profiler, etc.
+ * The merged protocol is cached after first load for performance.
+ *
+ * @returns CDP protocol schema with all domains, commands, and types
+ *
+ * @example
+ * ```typescript
+ * const protocol = loadProtocol();
+ * console.log(`Protocol version: ${protocol.version.major}.${protocol.version.minor}`);
+ * console.log(`Domains: ${protocol.domains.length}`); // ~53 domains (47 browser + 6 JS)
+ * ```
+ */
+export declare function loadProtocol(): ProtocolSchema;
+/**
+ * Get all domain names from the protocol.
+ *
+ * @returns Array of domain names (e.g., ['Accessibility', 'Network', 'Runtime'])
+ *
+ * @example
+ * ```typescript
+ * const domains = getDomains();
+ * console.log(domains); // ['Accessibility', 'Animation', 'Network', ...]
+ * ```
+ */
+export declare function getDomains(): string[];
+/**
+ * Find a domain by name (case-insensitive).
+ *
+ * @param domainName - Domain name to find (e.g., 'network', 'Network', 'NETWORK')
+ * @returns Domain object or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const domain = findDomain('network');  // Case-insensitive
+ * console.log(domain?.domain); // 'Network'
+ * console.log(domain?.commands.length); // 39
+ * ```
+ */
+export declare function findDomain(domainName: string): Domain | undefined;
+/**
+ * Find a command within a domain (case-insensitive).
+ *
+ * @param domainName - Domain name (e.g., 'Network')
+ * @param commandName - Command name (e.g., 'getCookies', 'GETCOOKIES')
+ * @returns Command object or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const cmd = findCommand('Network', 'getcookies');  // Case-insensitive
+ * console.log(cmd?.name); // 'getCookies'
+ * console.log(cmd?.parameters); // [...]
+ * ```
+ */
+export declare function findCommand(domainName: string, commandName: string): Command | undefined;
+/**
+ * Normalize a CDP method name to proper casing.
+ *
+ * Converts user input (any case) to CDP's actual method name.
+ *
+ * @param input - Method name in any format (e.g., 'network.getcookies', 'Runtime.Evaluate')
+ * @returns Normalized method name (e.g., 'Network.getCookies') or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * normalizeMethod('network.getcookies') // 'Network.getCookies'
+ * normalizeMethod('runtime.evaluate')   // 'Runtime.evaluate'
+ * normalizeMethod('NETWORK.GETCOOKIES') // 'Network.getCookies'
+ * normalizeMethod('invalid.method')     // undefined
+ * ```
+ */
+export declare function normalizeMethod(input: string): string | undefined;
+/**
+ * Get all commands for a domain.
+ *
+ * @param domainName - Domain name (case-insensitive)
+ * @returns Array of command names or empty array if domain not found
+ *
+ * @example
+ * ```typescript
+ * const commands = getCommandsForDomain('Network');
+ * console.log(commands); // ['getCookies', 'setCookie', 'enable', ...]
+ * ```
+ */
+export declare function getCommandsForDomain(domainName: string): string[];
+/**
+ * Format command signature for help text.
+ *
+ * @param domainName - Domain name
+ * @param commandName - Command name
+ * @returns Formatted signature string or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const sig = formatCommandSignature('Network', 'getCookies');
+ * console.log(sig);
+ * // Network.getCookies
+ * //
+ * // Returns all browser cookies for the current URL.
+ * //
+ * // Parameters:
+ * //   --urls <array> (optional) - The list of URLs for which to fetch cookies
+ * //
+ * // Returns:
+ * //   cookies: Array of Cookie objects
+ * ```
+ */
+export declare function formatCommandSignature(domainName: string, commandName: string): string | undefined;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/cdp/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/cdp/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAa,MAAM,YAAY,CAAC;AAQ7E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,IAAI,cAAc,CA2B7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAGrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAQxF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CA4CpB"}

package/dist/cdp/protocol.js

@@ -0,0 +1,215 @@
+/**
+ * CDP Protocol Schema Loader
+ *
+ * Loads and parses the Chrome DevTools Protocol schema from the bundled
+ * devtools-protocol package. Provides utilities for domain/method lookup
+ * and introspection.
+ */
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Cache the protocol to avoid re-reading the file
+let cachedProtocol = null;
+/**
+ * Load the CDP protocol schema.
+ *
+ * Merges browser_protocol.json and js_protocol.json from devtools-protocol package.
+ * The browser protocol contains domains like Network, Page, DOM, etc.
+ * The JS protocol contains Runtime, Debugger, Console, Profiler, etc.
+ * The merged protocol is cached after first load for performance.
+ *
+ * @returns CDP protocol schema with all domains, commands, and types
+ *
+ * @example
+ * ```typescript
+ * const protocol = loadProtocol();
+ * console.log(`Protocol version: ${protocol.version.major}.${protocol.version.minor}`);
+ * console.log(`Domains: ${protocol.domains.length}`); // ~53 domains (47 browser + 6 JS)
+ * ```
+ */
+export function loadProtocol() {
+    if (cachedProtocol) {
+        return cachedProtocol;
+    }
+    // Find the protocol files in node_modules
+    // When compiled, __dirname is dist/cdp, so go up to project root
+    const browserProtocolPath = join(__dirname, '../../node_modules/devtools-protocol/json/browser_protocol.json');
+    const jsProtocolPath = join(__dirname, '../../node_modules/devtools-protocol/json/js_protocol.json');
+    const browserProtocol = JSON.parse(readFileSync(browserProtocolPath, 'utf-8'));
+    const jsProtocol = JSON.parse(readFileSync(jsProtocolPath, 'utf-8'));
+    // Merge the two protocols
+    // Use browser protocol as base, add JS protocol domains
+    cachedProtocol = {
+        version: browserProtocol.version,
+        domains: [...browserProtocol.domains, ...jsProtocol.domains],
+    };
+    return cachedProtocol;
+}
+/**
+ * Get all domain names from the protocol.
+ *
+ * @returns Array of domain names (e.g., ['Accessibility', 'Network', 'Runtime'])
+ *
+ * @example
+ * ```typescript
+ * const domains = getDomains();
+ * console.log(domains); // ['Accessibility', 'Animation', 'Network', ...]
+ * ```
+ */
+export function getDomains() {
+    const protocol = loadProtocol();
+    return protocol.domains.map((d) => d.domain);
+}
+/**
+ * Find a domain by name (case-insensitive).
+ *
+ * @param domainName - Domain name to find (e.g., 'network', 'Network', 'NETWORK')
+ * @returns Domain object or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const domain = findDomain('network');  // Case-insensitive
+ * console.log(domain?.domain); // 'Network'
+ * console.log(domain?.commands.length); // 39
+ * ```
+ */
+export function findDomain(domainName) {
+    const protocol = loadProtocol();
+    const normalized = domainName.toLowerCase();
+    return protocol.domains.find((d) => d.domain.toLowerCase() === normalized);
+}
+/**
+ * Find a command within a domain (case-insensitive).
+ *
+ * @param domainName - Domain name (e.g., 'Network')
+ * @param commandName - Command name (e.g., 'getCookies', 'GETCOOKIES')
+ * @returns Command object or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const cmd = findCommand('Network', 'getcookies');  // Case-insensitive
+ * console.log(cmd?.name); // 'getCookies'
+ * console.log(cmd?.parameters); // [...]
+ * ```
+ */
+export function findCommand(domainName, commandName) {
+    const domain = findDomain(domainName);
+    if (!domain?.commands) {
+        return undefined;
+    }
+    const normalized = commandName.toLowerCase();
+    return domain.commands.find((c) => c.name.toLowerCase() === normalized);
+}
+/**
+ * Normalize a CDP method name to proper casing.
+ *
+ * Converts user input (any case) to CDP's actual method name.
+ *
+ * @param input - Method name in any format (e.g., 'network.getcookies', 'Runtime.Evaluate')
+ * @returns Normalized method name (e.g., 'Network.getCookies') or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * normalizeMethod('network.getcookies') // 'Network.getCookies'
+ * normalizeMethod('runtime.evaluate')   // 'Runtime.evaluate'
+ * normalizeMethod('NETWORK.GETCOOKIES') // 'Network.getCookies'
+ * normalizeMethod('invalid.method')     // undefined
+ * ```
+ */
+export function normalizeMethod(input) {
+    const [domainName, commandName] = input.split('.');
+    if (!domainName || !commandName) {
+        return undefined;
+    }
+    const domain = findDomain(domainName);
+    if (!domain) {
+        return undefined;
+    }
+    const command = findCommand(domain.domain, commandName);
+    if (!command) {
+        return undefined;
+    }
+    return `${domain.domain}.${command.name}`;
+}
+/**
+ * Get all commands for a domain.
+ *
+ * @param domainName - Domain name (case-insensitive)
+ * @returns Array of command names or empty array if domain not found
+ *
+ * @example
+ * ```typescript
+ * const commands = getCommandsForDomain('Network');
+ * console.log(commands); // ['getCookies', 'setCookie', 'enable', ...]
+ * ```
+ */
+export function getCommandsForDomain(domainName) {
+    const domain = findDomain(domainName);
+    if (!domain?.commands) {
+        return [];
+    }
+    return domain.commands.map((c) => c.name);
+}
+/**
+ * Format command signature for help text.
+ *
+ * @param domainName - Domain name
+ * @param commandName - Command name
+ * @returns Formatted signature string or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const sig = formatCommandSignature('Network', 'getCookies');
+ * console.log(sig);
+ * // Network.getCookies
+ * //
+ * // Returns all browser cookies for the current URL.
+ * //
+ * // Parameters:
+ * //   --urls <array> (optional) - The list of URLs for which to fetch cookies
+ * //
+ * // Returns:
+ * //   cookies: Array of Cookie objects
+ * ```
+ */
+export function formatCommandSignature(domainName, commandName) {
+    const domain = findDomain(domainName);
+    if (!domain) {
+        return undefined;
+    }
+    const command = findCommand(domain.domain, commandName);
+    if (!command) {
+        return undefined;
+    }
+    const lines = [];
+    // Method name
+    lines.push(`${domain.domain}.${command.name}`);
+    lines.push('');
+    // Description
+    if (command.description) {
+        lines.push(command.description);
+        lines.push('');
+    }
+    // Parameters
+    if (command.parameters && command.parameters.length > 0) {
+        lines.push('Parameters:');
+        command.parameters.forEach((param) => {
+            const optional = param.optional ? ' (optional)' : '';
+            const desc = param.description ? ` - ${param.description}` : '';
+            lines.push(`  --${param.name} <${param.type}>${optional}${desc}`);
+        });
+        lines.push('');
+    }
+    // Returns
+    if (command.returns && command.returns.length > 0) {
+        lines.push('Returns:');
+        command.returns.forEach((ret) => {
+            const desc = ret.description ? ` - ${ret.description}` : '';
+            lines.push(`  ${ret.name}: ${ret.type ?? ret.$ref}${desc}`);
+        });
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=protocol.js.map

package/dist/cdp/protocol.js.map

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

package/dist/cdp/schema.d.ts

@@ -0,0 +1,159 @@
+/**
+ * CDP Schema Introspection
+ *
+ * Provides structured, agent-friendly schema information for all CDP domains and methods.
+ * Follows principles from docs/AGENT_FRIENDLY_TOOLS.md:
+ * - Machine-readable output (JSON schema)
+ * - Self-describing tools
+ * - Structured context without verbosity
+ */
+/**
+ * Structured method schema for agent consumption.
+ */
+export interface MethodSchema {
+    /** Full method name (Domain.method) */
+    name: string;
+    /** Domain name */
+    domain: string;
+    /** Method name */
+    method: string;
+    /** Human-readable description */
+    description?: string;
+    /** Whether method is experimental */
+    experimental?: boolean;
+    /** Whether method is deprecated */
+    deprecated?: boolean;
+    /** Parameter schema */
+    parameters: ParameterSchema[];
+    /** Return value schema */
+    returns: ReturnSchema[];
+    /** Usage example (JSON) */
+    example?: {
+        command: string;
+        params?: Record<string, unknown>;
+    };
+}
+/**
+ * Parameter schema for agent consumption.
+ */
+export interface ParameterSchema {
+    /** Parameter name */
+    name: string;
+    /** Type (string, integer, boolean, array, object, or custom type reference) */
+    type: string;
+    /** Whether parameter is required */
+    required: boolean;
+    /** Human-readable description */
+    description?: string;
+    /** Enum values (if type is enum) */
+    enum?: string[];
+    /** Array item type (if type is array) */
+    items?: string;
+    /** Deprecated flag */
+    deprecated?: boolean;
+}
+/**
+ * Return value schema for agent consumption.
+ */
+export interface ReturnSchema {
+    /** Return value name */
+    name: string;
+    /** Type (string, integer, boolean, array, object, or custom type reference) */
+    type: string;
+    /** Whether return value is optional */
+    optional: boolean;
+    /** Human-readable description */
+    description?: string;
+    /** Array item type (if type is array) */
+    items?: string;
+}
+/**
+ * Domain summary for agent consumption.
+ */
+export interface DomainSummary {
+    /** Domain name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Number of commands in this domain */
+    commandCount: number;
+    /** Number of events in this domain */
+    eventCount: number;
+    /** Whether domain is experimental */
+    experimental?: boolean;
+    /** Whether domain is deprecated */
+    deprecated?: boolean;
+    /** Domain dependencies */
+    dependencies?: string[];
+}
+/**
+ * Get structured schema for a specific method.
+ *
+ * @param domainName - Domain name (case-insensitive)
+ * @param methodName - Method name (case-insensitive)
+ * @returns Method schema or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const schema = getMethodSchema('Network', 'getCookies');
+ * console.log(schema.parameters); // [{ name: 'urls', type: 'array', required: false, ... }]
+ * ```
+ */
+export declare function getMethodSchema(domainName: string, methodName: string): MethodSchema | undefined;
+/**
+ * Get all methods in a domain.
+ *
+ * @param domainName - Domain name (case-insensitive)
+ * @returns Array of method schemas
+ *
+ * @example
+ * ```typescript
+ * const methods = getDomainMethods('Network');
+ * console.log(methods.length); // 39
+ * console.log(methods[0].name); // 'Network.getIPProtectionProxyStatus'
+ * ```
+ */
+export declare function getDomainMethods(domainName: string): MethodSchema[];
+/**
+ * Get summary information for a domain.
+ *
+ * @param domainName - Domain name (case-insensitive)
+ * @returns Domain summary or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const summary = getDomainSummary('Network');
+ * console.log(summary.commandCount); // 39
+ * console.log(summary.eventCount); // 12
+ * ```
+ */
+export declare function getDomainSummary(domainName: string): DomainSummary | undefined;
+/**
+ * Get summaries for all domains.
+ *
+ * @returns Array of domain summaries
+ *
+ * @example
+ * ```typescript
+ * const summaries = getAllDomainSummaries();
+ * console.log(summaries.length); // 53
+ * console.log(summaries.find(d => d.name === 'Network').commandCount); // 39
+ * ```
+ */
+export declare function getAllDomainSummaries(): DomainSummary[];
+/**
+ * Search methods by keyword (case-insensitive).
+ *
+ * Searches in method names and descriptions.
+ *
+ * @param query - Search query
+ * @returns Array of matching method schemas
+ *
+ * @example
+ * ```typescript
+ * const cookies = searchMethods('cookie');
+ * // Returns: Network.getCookies, Network.setCookie, Network.deleteCookies, etc.
+ * ```
+ */
+export declare function searchMethods(query: string): MethodSchema[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/cdp/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/cdp/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,0BAA0B;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,2BAA2B;IAC3B,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAYhG;AA0HD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAOnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAO9E;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,EAAE,CAGvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAmB3D"}