@nordsym/apiclaw 1.3.7 → 1.3.8

package/dist/ui/errors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * APIClaw MCP Auto-Setup - Error Handling
+ *
+ * Comprehensive error formatting with actionable help.
+ * Every error includes context, suggestions, and help links.
+ */
+/**
+ * Error codes for APIClaw setup
+ */
+export declare enum ErrorCode {
+    CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    INVALID_JSON = "INVALID_JSON",
+    WRITE_FAILED = "WRITE_FAILED",
+    BACKUP_FAILED = "BACKUP_FAILED",
+    ALREADY_CONFIGURED = "ALREADY_CONFIGURED",
+    INVALID_CONFIG = "INVALID_CONFIG",
+    MERGE_CONFLICT = "MERGE_CONFLICT",
+    CLIENT_NOT_FOUND = "CLIENT_NOT_FOUND",
+    UNSUPPORTED_CLIENT = "UNSUPPORTED_CLIENT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    AUTH_FAILED = "AUTH_FAILED",
+    UNSUPPORTED_OS = "UNSUPPORTED_OS",
+    NODE_VERSION = "NODE_VERSION",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * APIClaw error with rich context
+ */
+export declare class ApiclawError extends Error {
+    readonly code: ErrorCode;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, message: string, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Format an error for terminal output
+ */
+export declare function formatError(error: Error | ApiclawError): string;
+/**
+ * Print an error to stderr
+ */
+export declare function printError(error: Error | ApiclawError): void;
+/**
+ * Create a typed error
+ */
+export declare function createError(code: ErrorCode, message?: string, context?: Record<string, unknown>): ApiclawError;
+/**
+ * Wrap a function with error handling
+ */
+export declare function withErrorHandling<T>(fn: () => Promise<T>, options?: {
+    exitOnError?: boolean;
+}): Promise<T | undefined>;
+/**
+ * Format a warning message
+ */
+export declare function formatWarning(message: string, suggestions?: string[]): string;
+/**
+ * Print a warning to stderr
+ */
+export declare function printWarning(message: string, suggestions?: string[]): void;
+/**
+ * Format an info message
+ */
+export declare function formatInfo(message: string): string;
+/**
+ * Format a success message
+ */
+export declare function formatSuccess(message: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/ui/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ui/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,oBAAY,SAAS;IAEnB,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAG/B,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IAGjC,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IAGzC,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAG3B,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAG7B,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAEnB,IAAI,EAAE,SAAS;aAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,SAAS,EAC/B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAkND;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,CAmD/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,YAAY,CAGd;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAW7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/ui/errors.js

@@ -0,0 +1,334 @@
+/**
+ * APIClaw MCP Auto-Setup - Error Handling
+ *
+ * Comprehensive error formatting with actionable help.
+ * Every error includes context, suggestions, and help links.
+ */
+import { colors, icons, numberedList, command, helpLink } from './colors.js';
+/**
+ * Error codes for APIClaw setup
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // File system errors
+    ErrorCode["CONFIG_NOT_FOUND"] = "CONFIG_NOT_FOUND";
+    ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    ErrorCode["INVALID_JSON"] = "INVALID_JSON";
+    ErrorCode["WRITE_FAILED"] = "WRITE_FAILED";
+    ErrorCode["BACKUP_FAILED"] = "BACKUP_FAILED";
+    // Configuration errors
+    ErrorCode["ALREADY_CONFIGURED"] = "ALREADY_CONFIGURED";
+    ErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    ErrorCode["MERGE_CONFLICT"] = "MERGE_CONFLICT";
+    // Client errors
+    ErrorCode["CLIENT_NOT_FOUND"] = "CLIENT_NOT_FOUND";
+    ErrorCode["UNSUPPORTED_CLIENT"] = "UNSUPPORTED_CLIENT";
+    // Network errors
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    // System errors
+    ErrorCode["UNSUPPORTED_OS"] = "UNSUPPORTED_OS";
+    ErrorCode["NODE_VERSION"] = "NODE_VERSION";
+    // Generic
+    ErrorCode["UNKNOWN"] = "UNKNOWN";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * APIClaw error with rich context
+ */
+export class ApiclawError extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'ApiclawError';
+    }
+}
+/**
+ * Error metadata registry
+ */
+const errorMeta = {
+    [ErrorCode.CONFIG_NOT_FOUND]: {
+        title: 'Config file not found',
+        description: 'The MCP client config file does not exist at the expected location.',
+        suggestions: [
+            'Make sure the MCP client is installed',
+            'The client may not have created its config yet - try opening and closing it',
+            'Use --config to specify a custom path',
+        ],
+        commands: [
+            'npx @nordsym/apiclaw setup --client cursor',
+            'npx @nordsym/apiclaw setup --config /path/to/config.json',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/config-not-found',
+    },
+    [ErrorCode.PERMISSION_DENIED]: {
+        title: 'Permission denied',
+        description: 'Unable to write to the config file due to insufficient permissions.',
+        suggestions: [
+            'The config file may be owned by another user',
+            'You may need elevated permissions',
+            'Check if the file is locked by another process',
+        ],
+        commands: [
+            'sudo npx @nordsym/apiclaw setup',
+            'chmod 644 <config-path>',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/permissions',
+    },
+    [ErrorCode.INVALID_JSON]: {
+        title: 'Invalid JSON in config file',
+        description: 'The existing config file contains malformed JSON.',
+        suggestions: [
+            'Check for trailing commas or missing brackets',
+            'Restore from a backup if available',
+            'Manually fix the JSON syntax errors',
+        ],
+        commands: [
+            'npx @nordsym/apiclaw restore --list',
+            'npx @nordsym/apiclaw restore',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/invalid-json',
+    },
+    [ErrorCode.WRITE_FAILED]: {
+        title: 'Failed to write config file',
+        description: 'An error occurred while writing the updated configuration.',
+        suggestions: [
+            'Check available disk space',
+            'Ensure the config directory exists',
+            'Verify write permissions',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/write-failed',
+    },
+    [ErrorCode.BACKUP_FAILED]: {
+        title: 'Failed to create backup',
+        description: 'Could not create a backup of the existing config.',
+        suggestions: [
+            'Check available disk space',
+            'Verify write permissions in config directory',
+            'Use --no-backup to skip backup (not recommended)',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/backup-failed',
+    },
+    [ErrorCode.ALREADY_CONFIGURED]: {
+        title: 'Already configured',
+        description: 'APIClaw is already configured in this MCP client.',
+        suggestions: [
+            'Use --force to update the existing configuration',
+            'Use npx @nordsym/apiclaw doctor to verify the setup',
+        ],
+        commands: [
+            'npx @nordsym/apiclaw setup --force',
+            'npx @nordsym/apiclaw doctor',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/already-configured',
+    },
+    [ErrorCode.INVALID_CONFIG]: {
+        title: 'Invalid configuration',
+        description: 'The configuration structure is invalid or missing required fields.',
+        suggestions: [
+            'Ensure the config follows the MCP specification',
+            'Check for required fields like "mcpServers"',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/invalid-config',
+    },
+    [ErrorCode.MERGE_CONFLICT]: {
+        title: 'Configuration merge conflict',
+        description: 'Could not safely merge APIClaw into the existing configuration.',
+        suggestions: [
+            'Review the existing config manually',
+            'Use --force to overwrite',
+            'Create a backup and try again',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/merge-conflict',
+    },
+    [ErrorCode.CLIENT_NOT_FOUND]: {
+        title: 'MCP client not found',
+        description: 'The specified MCP client could not be detected on this system.',
+        suggestions: [
+            'Install the MCP client first',
+            'Specify a different client with --client',
+            'Use --config for custom config paths',
+        ],
+        commands: [
+            'npx @nordsym/apiclaw setup --client claude-desktop',
+            'npx @nordsym/apiclaw doctor',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/client-not-found',
+    },
+    [ErrorCode.UNSUPPORTED_CLIENT]: {
+        title: 'Unsupported MCP client',
+        description: 'This MCP client is not yet supported by APIClaw auto-setup.',
+        suggestions: [
+            'Check for updates: npm update @nordsym/apiclaw',
+            'Use --config to manually specify the config path',
+            'Request support at github.com/nordsym/apiclaw',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/supported-clients',
+    },
+    [ErrorCode.NETWORK_ERROR]: {
+        title: 'Network error',
+        description: 'Could not connect to APIClaw services.',
+        suggestions: [
+            'Check your internet connection',
+            'Setup works offline - verify connectivity later',
+            'Check if api.apiclaw.com is reachable',
+        ],
+        commands: [
+            'curl -I https://api.apiclaw.com/health',
+            'npx @nordsym/apiclaw doctor',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/network-error',
+    },
+    [ErrorCode.AUTH_FAILED]: {
+        title: 'Authentication failed',
+        description: 'Could not authenticate with APIClaw.',
+        suggestions: [
+            'Check your workspace ID',
+            'Verify your API key is valid',
+            'Setup works without auth - configure credentials later',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/auth-failed',
+    },
+    [ErrorCode.UNSUPPORTED_OS]: {
+        title: 'Unsupported operating system',
+        description: 'APIClaw auto-setup is not available for this operating system.',
+        suggestions: [
+            'Supported: macOS, Windows 10/11, Linux',
+            'Manual setup instructions available',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/manual',
+    },
+    [ErrorCode.NODE_VERSION]: {
+        title: 'Unsupported Node.js version',
+        description: 'APIClaw requires Node.js 18 or higher.',
+        suggestions: [
+            'Upgrade Node.js to version 18 or later',
+            'Use nvm to manage Node.js versions',
+        ],
+        commands: [
+            'nvm install 18',
+            'nvm use 18',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/setup/node-version',
+    },
+    [ErrorCode.UNKNOWN]: {
+        title: 'Unknown error',
+        description: 'An unexpected error occurred.',
+        suggestions: [
+            'Try running with --verbose for more details',
+            'Check the logs for more information',
+            'Report this issue if it persists',
+        ],
+        commands: [
+            'npx @nordsym/apiclaw setup --verbose',
+        ],
+        helpUrl: 'https://docs.apiclaw.com/support',
+    },
+};
+/**
+ * Format an error for terminal output
+ */
+export function formatError(error) {
+    const code = error instanceof ApiclawError ? error.code : ErrorCode.UNKNOWN;
+    const meta = errorMeta[code];
+    const context = error instanceof ApiclawError ? error.context : undefined;
+    const lines = [];
+    // Header
+    lines.push(`${icons.cross} ${colors.error(`Error: ${meta.title}`)}`);
+    lines.push('');
+    // Description
+    lines.push(colors.secondary(meta.description));
+    // Context (if available)
+    if (context) {
+        lines.push('');
+        for (const [key, value] of Object.entries(context)) {
+            if (value !== undefined) {
+                lines.push(colors.muted(`  ${key}: ${String(value)}`));
+            }
+        }
+    }
+    // Original error message (if different from description)
+    if (error.message && error.message !== meta.description) {
+        lines.push('');
+        lines.push(colors.muted(`Details: ${error.message}`));
+    }
+    // Suggestions
+    lines.push('');
+    lines.push(colors.secondary('This usually means:'));
+    lines.push(numberedList(meta.suggestions, 0));
+    // Commands
+    if (meta.commands && meta.commands.length > 0) {
+        lines.push('');
+        lines.push(colors.secondary('Try:'));
+        for (const cmd of meta.commands) {
+            lines.push(command(cmd));
+        }
+    }
+    // Help link
+    if (meta.helpUrl) {
+        lines.push('');
+        lines.push(`Need help? ${helpLink(meta.helpUrl)}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Print an error to stderr
+ */
+export function printError(error) {
+    console.error(formatError(error));
+}
+/**
+ * Create a typed error
+ */
+export function createError(code, message, context) {
+    const meta = errorMeta[code];
+    return new ApiclawError(code, message || meta.description, context);
+}
+/**
+ * Wrap a function with error handling
+ */
+export async function withErrorHandling(fn, options = {}) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        printError(error instanceof Error ? error : new Error(String(error)));
+        if (options.exitOnError) {
+            process.exit(1);
+        }
+        return undefined;
+    }
+}
+/**
+ * Format a warning message
+ */
+export function formatWarning(message, suggestions) {
+    const lines = [];
+    lines.push(`${icons.warning} ${colors.warning(`Warning: ${message}`)}`);
+    if (suggestions && suggestions.length > 0) {
+        lines.push('');
+        lines.push(numberedList(suggestions, 0));
+    }
+    return lines.join('\n');
+}
+/**
+ * Print a warning to stderr
+ */
+export function printWarning(message, suggestions) {
+    console.error(formatWarning(message, suggestions));
+}
+/**
+ * Format an info message
+ */
+export function formatInfo(message) {
+    return `${icons.info} ${colors.info(message)}`;
+}
+/**
+ * Format a success message
+ */
+export function formatSuccess(message) {
+    return `${icons.check} ${colors.success(message)}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/ui/errors.js.map

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

package/dist/ui/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * APIClaw MCP Auto-Setup - UI Module
+ *
+ * Exports all UI utilities for the CLI.
+ */
+export * from './colors.js';
+export * from './spinner.js';
+export * from './prompts.js';
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAG7B,cAAc,cAAc,CAAC;AAG7B,cAAc,aAAa,CAAC"}

package/dist/ui/index.js

@@ -0,0 +1,14 @@
+/**
+ * APIClaw MCP Auto-Setup - UI Module
+ *
+ * Exports all UI utilities for the CLI.
+ */
+// Color utilities
+export * from './colors.js';
+// Spinner utilities
+export * from './spinner.js';
+// Interactive prompts
+export * from './prompts.js';
+// Error handling
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,cAAc,aAAa,CAAC;AAE5B,oBAAoB;AACpB,cAAc,cAAc,CAAC;AAE7B,sBAAsB;AACtB,cAAc,cAAc,CAAC;AAE7B,iBAAiB;AACjB,cAAc,aAAa,CAAC"}

package/dist/ui/prompts.d.ts

@@ -0,0 +1,88 @@
+/**
+ * APIClaw MCP Auto-Setup - Interactive Prompts
+ *
+ * Inquirer-based prompts for the --wizard mode.
+ * Provides a guided, interactive setup experience.
+ */
+/**
+ * Detected client information
+ */
+export interface DetectedClient {
+    id: string;
+    name: string;
+    detected: boolean;
+    configPath: string;
+    alreadyConfigured: boolean;
+}
+/**
+ * Configuration change preview
+ */
+export interface ConfigChange {
+    clientId: string;
+    clientName: string;
+    configPath: string;
+    action: 'create' | 'update' | 'skip';
+    diff?: string;
+}
+/**
+ * Wizard result
+ */
+export interface WizardResult {
+    selectedClients: string[];
+    workspace?: string;
+    confirmed: boolean;
+    dryRun: boolean;
+}
+/**
+ * Display welcome banner
+ */
+export declare function showWelcome(): void;
+/**
+ * Prompt for client selection
+ */
+export declare function selectClients(clients: DetectedClient[]): Promise<string[]>;
+/**
+ * Prompt for custom config path
+ */
+export declare function promptCustomPath(): Promise<string>;
+/**
+ * Prompt for workspace ID
+ */
+export declare function promptWorkspace(): Promise<string | undefined>;
+/**
+ * Show preview of changes and confirm
+ */
+export declare function confirmChanges(changes: ConfigChange[], options?: {
+    dryRun?: boolean;
+}): Promise<boolean>;
+/**
+ * Prompt for force overwrite
+ */
+export declare function confirmForce(clientName: string): Promise<boolean>;
+/**
+ * Show success message with next steps
+ */
+export declare function showSuccess(configuredClients: string[]): void;
+/**
+ * Show dry-run summary
+ */
+export declare function showDryRunSummary(changes: ConfigChange[]): void;
+/**
+ * Run the full interactive wizard
+ */
+export declare function runWizard(clients: DetectedClient[], options?: {
+    dryRun?: boolean;
+}): Promise<WizardResult>;
+/**
+ * Prompt for restore backup selection
+ */
+export declare function selectBackup(backups: {
+    path: string;
+    date: Date;
+    client: string;
+}[]): Promise<string | null>;
+/**
+ * Confirm uninstall
+ */
+export declare function confirmUninstall(clients: string[]): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ui/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ui/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuDhF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBxD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgCnE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAW/D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAqBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BlH;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAe1E"}