@jonnyhoo/ccs 1.0.0

package/dist/delegation/settings-parser.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Parses Claude Code settings for tool restrictions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsParser = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Settings Parser Class
+ */
+class SettingsParser {
+    /**
+     * Parse default permission mode from project settings
+     */
+    static parseDefaultPermissionMode(projectDir) {
+        const settings = this.loadSettings(projectDir);
+        const permissions = settings.permissions || {};
+        // Priority: local > shared > fallback to 'acceptEdits'
+        const defaultMode = permissions.defaultMode || 'acceptEdits';
+        if (process.env.CCS_DEBUG) {
+            console.error(`[i] Permission mode from settings: ${defaultMode}`);
+        }
+        return defaultMode;
+    }
+    /**
+     * Parse project settings for tool restrictions
+     */
+    static parseToolRestrictions(projectDir) {
+        const settings = this.loadSettings(projectDir);
+        const permissions = settings.permissions || {};
+        const allowed = permissions.allow || [];
+        const denied = permissions.deny || [];
+        if (process.env.CCS_DEBUG) {
+            console.error(`[i] Tool restrictions: ${allowed.length} allowed, ${denied.length} denied`);
+        }
+        return {
+            allowedTools: allowed,
+            disallowedTools: denied,
+        };
+    }
+    /**
+     * Load and merge settings files (local overrides shared)
+     */
+    static loadSettings(projectDir) {
+        const claudeDir = path.join(projectDir, '.claude');
+        const sharedPath = path.join(claudeDir, 'settings.json');
+        const localPath = path.join(claudeDir, 'settings.local.json');
+        // Load shared settings
+        const shared = this.readJsonSafe(sharedPath) || {};
+        // Load local settings (overrides shared)
+        const local = this.readJsonSafe(localPath) || {};
+        // Merge permissions (local overrides shared)
+        return {
+            permissions: {
+                allow: [...(shared.permissions?.allow || []), ...(local.permissions?.allow || [])],
+                deny: [...(shared.permissions?.deny || []), ...(local.permissions?.deny || [])],
+                // Local defaultMode takes priority over shared
+                defaultMode: local.permissions?.defaultMode || shared.permissions?.defaultMode || undefined,
+            },
+        };
+    }
+    /**
+     * Read JSON file safely (no throw)
+     */
+    static readJsonSafe(filePath) {
+        try {
+            if (!fs.existsSync(filePath)) {
+                return null;
+            }
+            const content = fs.readFileSync(filePath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (process.env.CCS_DEBUG) {
+                console.warn(`[!] Failed to read settings: ${filePath}: ${error.message}`);
+            }
+            return null;
+        }
+    }
+}
+exports.SettingsParser = SettingsParser;
+//# sourceMappingURL=settings-parser.js.map

package/dist/delegation/settings-parser.js.map

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

package/dist/errors/cleanup-registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Cleanup registry for CCS CLI
+ *
+ * Manages cleanup callbacks that should be run on exit or error.
+ * Used to clean up resources like:
+ * - Spawned processes (proxies, child processes)
+ * - Temporary files
+ * - Network connections
+ * - Open file handles
+ */
+/**
+ * Cleanup callback type
+ * Callbacks should be synchronous and non-throwing
+ */
+export type CleanupCallback = () => void;
+/**
+ * Register a cleanup callback
+ * Callbacks are executed in LIFO order (stack-like behavior)
+ *
+ * @param fn - Cleanup function to register
+ * @returns Unregister function to remove the callback
+ */
+export declare function registerCleanup(fn: CleanupCallback): () => void;
+/**
+ * Run all registered cleanup callbacks
+ * Executes in LIFO order, catches and logs individual errors
+ * Can only be run once per process
+ */
+export declare function runCleanup(): void;
+/**
+ * Clear all registered cleanup callbacks
+ * Primarily used for testing
+ */
+export declare function clearCleanup(): void;
+/**
+ * Get the number of registered cleanup callbacks
+ * Primarily used for testing
+ */
+export declare function getCleanupCount(): number;
+/**
+ * Check if cleanup has already run
+ * Primarily used for testing
+ */
+export declare function hasCleanupRun(): boolean;
+/**
+ * Create a cleanup scope for automatic resource management
+ * Resources registered within the scope are cleaned up when done
+ *
+ * @example
+ * ```typescript
+ * const scope = createCleanupScope();
+ * scope.register(() => process.kill());
+ * try {
+ *   // ... do work
+ * } finally {
+ *   scope.cleanup();
+ * }
+ * ```
+ */
+export declare function createCleanupScope(): {
+    register: (fn: CleanupCallback) => void;
+    cleanup: () => void;
+};
+//# sourceMappingURL=cleanup-registry.d.ts.map

package/dist/errors/cleanup-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-registry.d.ts","sourceRoot":"","sources":["../../src/errors/cleanup-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAazC;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,IAAI,CAU/D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAuBjC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,QAAQ,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,IAAI,CAAC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA8BA"}

package/dist/errors/cleanup-registry.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Cleanup registry for CCS CLI
+ *
+ * Manages cleanup callbacks that should be run on exit or error.
+ * Used to clean up resources like:
+ * - Spawned processes (proxies, child processes)
+ * - Temporary files
+ * - Network connections
+ * - Open file handles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCleanupScope = exports.hasCleanupRun = exports.getCleanupCount = exports.clearCleanup = exports.runCleanup = exports.registerCleanup = void 0;
+/**
+ * Registry of cleanup callbacks
+ * Executed in LIFO order (last registered = first executed)
+ */
+const cleanupCallbacks = [];
+/**
+ * Flag to prevent double execution
+ */
+let cleanupRan = false;
+/**
+ * Register a cleanup callback
+ * Callbacks are executed in LIFO order (stack-like behavior)
+ *
+ * @param fn - Cleanup function to register
+ * @returns Unregister function to remove the callback
+ */
+function registerCleanup(fn) {
+    cleanupCallbacks.push(fn);
+    // Return unregister function
+    return () => {
+        const index = cleanupCallbacks.indexOf(fn);
+        if (index !== -1) {
+            cleanupCallbacks.splice(index, 1);
+        }
+    };
+}
+exports.registerCleanup = registerCleanup;
+/**
+ * Run all registered cleanup callbacks
+ * Executes in LIFO order, catches and logs individual errors
+ * Can only be run once per process
+ */
+function runCleanup() {
+    if (cleanupRan) {
+        return;
+    }
+    cleanupRan = true;
+    const isDebug = process.env['CCS_DEBUG'] === '1' || process.env['CCS_DEBUG'] === 'true';
+    // Execute in reverse order (LIFO)
+    while (cleanupCallbacks.length > 0) {
+        const callback = cleanupCallbacks.pop();
+        if (callback) {
+            try {
+                callback();
+            }
+            catch (error) {
+                // Log cleanup errors in debug mode but don't throw
+                if (isDebug) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    console.error(`[!] Cleanup error: ${message}`);
+                }
+            }
+        }
+    }
+}
+exports.runCleanup = runCleanup;
+/**
+ * Clear all registered cleanup callbacks
+ * Primarily used for testing
+ */
+function clearCleanup() {
+    cleanupCallbacks.length = 0;
+    cleanupRan = false;
+}
+exports.clearCleanup = clearCleanup;
+/**
+ * Get the number of registered cleanup callbacks
+ * Primarily used for testing
+ */
+function getCleanupCount() {
+    return cleanupCallbacks.length;
+}
+exports.getCleanupCount = getCleanupCount;
+/**
+ * Check if cleanup has already run
+ * Primarily used for testing
+ */
+function hasCleanupRun() {
+    return cleanupRan;
+}
+exports.hasCleanupRun = hasCleanupRun;
+/**
+ * Create a cleanup scope for automatic resource management
+ * Resources registered within the scope are cleaned up when done
+ *
+ * @example
+ * ```typescript
+ * const scope = createCleanupScope();
+ * scope.register(() => process.kill());
+ * try {
+ *   // ... do work
+ * } finally {
+ *   scope.cleanup();
+ * }
+ * ```
+ */
+function createCleanupScope() {
+    const scopeCallbacks = [];
+    const unregisters = [];
+    return {
+        register: (fn) => {
+            scopeCallbacks.push(fn);
+            // Also register with global cleanup in case of unexpected exit
+            const unregister = registerCleanup(fn);
+            unregisters.push(unregister);
+        },
+        cleanup: () => {
+            // Unregister from global cleanup first
+            for (const unregister of unregisters) {
+                unregister();
+            }
+            // Execute scope callbacks in LIFO order
+            while (scopeCallbacks.length > 0) {
+                const callback = scopeCallbacks.pop();
+                if (callback) {
+                    try {
+                        callback();
+                    }
+                    catch (_error) {
+                        // Silently ignore scope cleanup errors
+                    }
+                }
+            }
+        },
+    };
+}
+exports.createCleanupScope = createCleanupScope;
+//# sourceMappingURL=cleanup-registry.js.map

package/dist/errors/cleanup-registry.js.map

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

package/dist/errors/error-handler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Centralized error handler for CCS CLI
+ *
+ * Provides unified error handling with:
+ * - Consistent error formatting
+ * - Exit code management
+ * - Cleanup callback execution
+ * - Debug mode support
+ */
+import { ExitCode } from './exit-codes';
+/**
+ * Central error handler
+ * Formats error, runs cleanup, and exits with appropriate code
+ *
+ * @param error - The error to handle
+ * @returns never - Always exits the process
+ */
+export declare function handleError(error: unknown): never;
+/**
+ * Exit with an error message and code
+ * Convenience function for simple error exits
+ *
+ * @param message - Error message to display
+ * @param code - Exit code (defaults to GENERAL_ERROR)
+ * @returns never - Always exits the process
+ */
+export declare function exitWithError(message: string, code?: ExitCode): never;
+/**
+ * Exit with success
+ * Runs cleanup and exits with SUCCESS code
+ *
+ * @param message - Optional success message to display
+ * @returns never - Always exits the process
+ */
+export declare function exitWithSuccess(message?: string): never;
+/**
+ * Create a wrapped error handler for async operations
+ * Wraps an async function to catch and handle errors
+ */
+export declare function withErrorHandling<T extends unknown[]>(fn: (...args: T) => Promise<void>): (...args: T) => Promise<void>;
+/**
+ * Assert a condition, throwing a CCSError if false
+ */
+export declare function assertOrExit(condition: boolean, message: string, code?: ExitCode): asserts condition;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/errors/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/errors/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAA0B,MAAM,cAAc,CAAC;AAsEhE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAejD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,QAAiC,GAAG,KAAK,CAU7F;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAMvD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EACnD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAChC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ/B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAiC,GACtC,OAAO,CAAC,SAAS,CAInB"}

package/dist/errors/error-handler.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Centralized error handler for CCS CLI
+ *
+ * Provides unified error handling with:
+ * - Consistent error formatting
+ * - Exit code management
+ * - Cleanup callback execution
+ * - Debug mode support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertOrExit = exports.withErrorHandling = exports.exitWithSuccess = exports.exitWithError = exports.handleError = void 0;
+const exit_codes_1 = require("./exit-codes");
+const error_types_1 = require("./error-types");
+const cleanup_registry_1 = require("./cleanup-registry");
+/**
+ * Debug mode flag - set via CCS_DEBUG environment variable
+ */
+const isDebugMode = () => {
+    return process.env['CCS_DEBUG'] === '1' || process.env['CCS_DEBUG'] === 'true';
+};
+/**
+ * Format error message for display
+ * Uses ASCII-only formatting per codebase standards (no emojis)
+ */
+function formatErrorMessage(error) {
+    if ((0, error_types_1.isCCSError)(error)) {
+        return `[X] ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `[X] ${error.message}`;
+    }
+    if (typeof error === 'string') {
+        return `[X] ${error}`;
+    }
+    return '[X] An unexpected error occurred';
+}
+/**
+ * Get exit code from error
+ * CCSError types have their own codes, others default to GENERAL_ERROR
+ */
+function getExitCode(error) {
+    if ((0, error_types_1.isCCSError)(error)) {
+        return error.code;
+    }
+    return exit_codes_1.ExitCode.GENERAL_ERROR;
+}
+/**
+ * Log debug information for an error
+ * Only outputs when CCS_DEBUG is enabled
+ */
+function logDebugInfo(error, code) {
+    if (!isDebugMode())
+        return;
+    console.error('');
+    console.error('[i] Debug information:');
+    console.error(`    Exit code: ${code} (${exit_codes_1.EXIT_CODE_DESCRIPTIONS[code] || 'Unknown'})`);
+    if (error instanceof Error) {
+        console.error(`    Error type: ${error.constructor.name}`);
+        if (error.stack) {
+            console.error('    Stack trace:');
+            const stackLines = error.stack.split('\n').slice(1, 6);
+            for (const line of stackLines) {
+                console.error(`      ${line.trim()}`);
+            }
+        }
+    }
+    // Log additional properties for CCSError types
+    if ((0, error_types_1.isCCSError)(error)) {
+        console.error(`    Recoverable: ${error.recoverable}`);
+    }
+}
+/**
+ * Central error handler
+ * Formats error, runs cleanup, and exits with appropriate code
+ *
+ * @param error - The error to handle
+ * @returns never - Always exits the process
+ */
+function handleError(error) {
+    // Run cleanup callbacks first
+    (0, cleanup_registry_1.runCleanup)();
+    const code = getExitCode(error);
+    const message = formatErrorMessage(error);
+    // Output error message to stderr
+    console.error(message);
+    // Log debug info if enabled
+    logDebugInfo(error, code);
+    // Exit with appropriate code
+    process.exit(code);
+}
+exports.handleError = handleError;
+/**
+ * Exit with an error message and code
+ * Convenience function for simple error exits
+ *
+ * @param message - Error message to display
+ * @param code - Exit code (defaults to GENERAL_ERROR)
+ * @returns never - Always exits the process
+ */
+function exitWithError(message, code = exit_codes_1.ExitCode.GENERAL_ERROR) {
+    (0, cleanup_registry_1.runCleanup)();
+    console.error(`[X] ${message}`);
+    if (isDebugMode()) {
+        console.error('');
+        console.error(`[i] Exit code: ${code} (${exit_codes_1.EXIT_CODE_DESCRIPTIONS[code] || 'Unknown'})`);
+    }
+    process.exit(code);
+}
+exports.exitWithError = exitWithError;
+/**
+ * Exit with success
+ * Runs cleanup and exits with SUCCESS code
+ *
+ * @param message - Optional success message to display
+ * @returns never - Always exits the process
+ */
+function exitWithSuccess(message) {
+    (0, cleanup_registry_1.runCleanup)();
+    if (message) {
+        console.log(`[OK] ${message}`);
+    }
+    process.exit(exit_codes_1.ExitCode.SUCCESS);
+}
+exports.exitWithSuccess = exitWithSuccess;
+/**
+ * Create a wrapped error handler for async operations
+ * Wraps an async function to catch and handle errors
+ */
+function withErrorHandling(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    };
+}
+exports.withErrorHandling = withErrorHandling;
+/**
+ * Assert a condition, throwing a CCSError if false
+ */
+function assertOrExit(condition, message, code = exit_codes_1.ExitCode.GENERAL_ERROR) {
+    if (!condition) {
+        exitWithError(message, code);
+    }
+}
+exports.assertOrExit = assertOrExit;
+//# sourceMappingURL=error-handler.js.map

package/dist/errors/error-handler.js.map

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

package/dist/errors/error-types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Custom error types for CCS CLI
+ *
+ * All custom errors extend CCSError which provides:
+ * - Standardized exit codes
+ * - Recoverable flag for retry logic
+ * - Consistent error formatting
+ */
+import { ExitCode } from './exit-codes';
+/**
+ * Base error class for all CCS errors
+ * Extends standard Error with exit code and recovery information
+ */
+export declare class CCSError extends Error {
+    readonly code: ExitCode;
+    readonly recoverable: boolean;
+    constructor(message: string, code?: ExitCode, recoverable?: boolean);
+}
+/**
+ * Configuration-related errors
+ * Examples: missing config file, invalid JSON, corrupt settings
+ */
+export declare class ConfigError extends CCSError {
+    readonly configPath?: string | undefined;
+    constructor(message: string, configPath?: string | undefined);
+}
+/**
+ * Network-related errors
+ * Examples: connection refused, timeout, DNS resolution failure
+ */
+export declare class NetworkError extends CCSError {
+    readonly url?: string | undefined;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, url?: string | undefined, statusCode?: number | undefined);
+}
+/**
+ * Authentication/authorization errors
+ * Examples: invalid API key, expired token, insufficient permissions
+ */
+export declare class AuthError extends CCSError {
+    readonly provider?: string | undefined;
+    constructor(message: string, provider?: string | undefined);
+}
+/**
+ * Binary/executable errors
+ * Examples: Claude CLI not found, corrupted binary, permission denied
+ */
+export declare class BinaryError extends CCSError {
+    readonly binaryPath?: string | undefined;
+    constructor(message: string, binaryPath?: string | undefined);
+}
+/**
+ * Provider-specific errors
+ * Examples: API rate limit, service unavailable, invalid model
+ */
+export declare class ProviderError extends CCSError {
+    readonly provider: string;
+    readonly details?: unknown;
+    constructor(message: string, provider: string, details?: unknown);
+}
+/**
+ * Profile-related errors
+ * Examples: profile not found, invalid profile name, duplicate profile
+ */
+export declare class ProfileError extends CCSError {
+    readonly profileName?: string | undefined;
+    readonly availableProfiles?: string[] | undefined;
+    constructor(message: string, profileName?: string | undefined, availableProfiles?: string[] | undefined);
+}
+/**
+ * Proxy-related errors
+ * Examples: proxy startup failure, port conflict, proxy timeout
+ */
+export declare class ProxyError extends CCSError {
+    readonly port?: number | undefined;
+    constructor(message: string, port?: number | undefined);
+}
+/**
+ * Migration-related errors
+ * Examples: failed to migrate config, backup creation failed
+ */
+export declare class MigrationError extends CCSError {
+    readonly fromVersion?: string | undefined;
+    readonly toVersion?: string | undefined;
+    constructor(message: string, fromVersion?: string | undefined, toVersion?: string | undefined);
+}
+/**
+ * User abort error (Ctrl+C, SIGINT)
+ * Used when user explicitly cancels an operation
+ */
+export declare class UserAbortError extends CCSError {
+    constructor(message?: string);
+}
+/**
+ * Type guard to check if an error is a CCSError
+ */
+export declare function isCCSError(error: unknown): error is CCSError;
+/**
+ * Type guard to check if an error is recoverable
+ */
+export declare function isRecoverableError(error: unknown): boolean;
+//# sourceMappingURL=error-types.d.ts.map

package/dist/errors/error-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-types.d.ts","sourceRoot":"","sources":["../../src/errors/error-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,EAAE,QAAQ;aACd,WAAW,EAAE,OAAO;gBAFpC,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,QAAiC,EACvC,WAAW,GAAE,OAAe;CAS/C;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAQ;aAGrB,UAAU,CAAC;gBAD3B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,oBAAQ;CAKtC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,GAAG,CAAC;aACJ,UAAU,CAAC;gBAF3B,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,oBAAQ,EACZ,UAAU,CAAC,oBAAQ;CAKtC;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aAGnB,QAAQ,CAAC;gBADzB,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,oBAAQ;CAKpC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAQ;aAGrB,UAAU,CAAC;gBAD3B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,oBAAQ;CAKtC;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,QAAQ;aAGvB,QAAQ,EAAE,MAAM;aAChB,OAAO,CAAC;gBAFxB,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,SAAS;CAKpC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,WAAW,CAAC;aACZ,iBAAiB,CAAC;gBAFlC,OAAO,EAAE,MAAM,EACC,WAAW,CAAC,oBAAQ,EACpB,iBAAiB,CAAC,sBAAU;CAK/C;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,QAAQ;aAGpB,IAAI,CAAC;gBADrB,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,oBAAQ;CAKhC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;aAGxB,WAAW,CAAC;aACZ,SAAS,CAAC;gBAF1B,OAAO,EAAE,MAAM,EACC,WAAW,CAAC,oBAAQ,EACpB,SAAS,CAAC,oBAAQ;CAKrC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAAsC;CAI5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D"}