devports 0.0.1 → 1.0.0

package/dist/services/validation-service.js

@@ -0,0 +1,267 @@
+/**
+ * Consolidated validation service - eliminates duplication in validation logic
+ * Implements configurable validation patterns for DRY compliance
+ */
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Common validation patterns
+ */
+export const ValidationPatterns = {
+    PROJECT_SERVICE: /^[a-zA-Z0-9._-]+$/,
+    BRANCH_NAME: /^[a-zA-Z0-9._/-]+$/,
+    SAFE_PATH: /^[a-zA-Z0-9._/-]+$/,
+    SHELL_DANGEROUS: /[;|&$`<>(){}[\]"'\\*?~]/,
+};
+/**
+ * Predefined validation configurations for common use cases
+ */
+export const ValidationConfigs = {
+    PROJECT_NAME: {
+        name: 'Project name',
+        maxLength: 50,
+        pattern: ValidationPatterns.PROJECT_SERVICE,
+        disallowedPrefixes: ['.', '-'],
+        required: true,
+    },
+    SERVICE_NAME: {
+        name: 'Service name',
+        maxLength: 30,
+        pattern: ValidationPatterns.PROJECT_SERVICE,
+        disallowedPrefixes: ['.', '-'],
+        required: true,
+    },
+    BRANCH_NAME: {
+        name: 'Branch name',
+        maxLength: 100,
+        pattern: ValidationPatterns.BRANCH_NAME,
+        required: true,
+    },
+    PORT_NUMBER: {
+        name: 'Port number',
+        min: 1024,
+        max: 65535,
+        integer: true,
+        required: true,
+    },
+    TEMPLATE_PATH: {
+        name: 'Template path',
+        allowedExtensions: ['.devports'],
+        maxLength: 500,
+        allowRelative: true,
+    },
+    WORKTREE_PATH: {
+        name: 'Worktree path',
+        maxLength: 500,
+        allowRelative: true,
+    },
+    OUTPUT_PATH: {
+        name: 'Output path',
+        maxLength: 500,
+        allowRelative: true,
+    },
+};
+/**
+ * Centralized validation service with configurable validators
+ */
+export class ValidationService {
+    /**
+     * Validate a string value with configurable rules
+     */
+    static validateString(value, config) {
+        // Required check
+        if (config.required && (!value || typeof value !== 'string')) {
+            throw new ValidationError(config.customErrorMessage ?? `${config.name} is required`);
+        }
+        if (!value) {
+            return '';
+        }
+        // Length validation
+        if (config.maxLength && value.length > config.maxLength) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} must be ${config.maxLength} characters or less`);
+        }
+        if (config.minLength && value.length < config.minLength) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} must be at least ${config.minLength} characters`);
+        }
+        // Pattern validation
+        if (config.pattern && !config.pattern.test(value)) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} can only contain letters, numbers, dots, underscores, and hyphens`);
+        }
+        // Prefix validation
+        if (config.disallowedPrefixes) {
+            for (const prefix of config.disallowedPrefixes) {
+                if (value.startsWith(prefix)) {
+                    throw new ValidationError(config.customErrorMessage ??
+                        `${config.name} cannot start with "${prefix}"`);
+                }
+            }
+        }
+        return value.trim();
+    }
+    /**
+     * Validate a numeric value with configurable rules
+     */
+    static validateNumber(value, config) {
+        // Required check
+        if (config.required &&
+            (value === undefined || value === null || value === '')) {
+            throw new ValidationError(config.customErrorMessage ?? `${config.name} is required`);
+        }
+        const numValue = typeof value === 'string' ? parseFloat(value) : value;
+        if (isNaN(numValue)) {
+            throw new ValidationError(config.customErrorMessage ?? `${config.name} must be a valid number`);
+        }
+        // Integer check
+        if (config.integer && !Number.isInteger(numValue)) {
+            throw new ValidationError(config.customErrorMessage ?? `${config.name} must be an integer`);
+        }
+        // Range validation
+        if (config.min !== undefined && numValue < config.min) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} must be at least ${config.min}`);
+        }
+        if (config.max !== undefined && numValue > config.max) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} must be at most ${config.max}`);
+        }
+        return numValue;
+    }
+    /**
+     * Validate a path with configurable rules
+     */
+    static validatePath(value, config) {
+        if (!value || typeof value !== 'string') {
+            throw new ValidationError(config.customErrorMessage ?? `${config.name} is required`);
+        }
+        // Length validation
+        if (config.maxLength && value.length > config.maxLength) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} must be ${config.maxLength} characters or less`);
+        }
+        // Extension validation
+        if (config.allowedExtensions && config.allowedExtensions.length > 0) {
+            const hasValidExtension = config.allowedExtensions.some((ext) => value.endsWith(ext));
+            if (!hasValidExtension) {
+                throw new ValidationError(config.customErrorMessage ??
+                    `${config.name} must have one of these extensions: ${config.allowedExtensions.join(', ')}`);
+            }
+        }
+        // Shell metacharacter check for security
+        if (ValidationPatterns.SHELL_DANGEROUS.test(value)) {
+            throw new ValidationError(config.customErrorMessage ??
+                `${config.name} contains dangerous characters that could be used for shell injection`);
+        }
+        return value.trim();
+    }
+    /**
+     * Convenience methods using predefined configurations
+     */
+    static validateProjectName(value) {
+        return this.validateString(value, ValidationConfigs.PROJECT_NAME);
+    }
+    static validateServiceName(value) {
+        return this.validateString(value, ValidationConfigs.SERVICE_NAME);
+    }
+    static validateBranchName(value) {
+        return this.validateString(value, ValidationConfigs.BRANCH_NAME);
+    }
+    static validatePort(value) {
+        return this.validateNumber(value, ValidationConfigs.PORT_NUMBER);
+    }
+    static validateTemplatePath(value) {
+        return this.validatePath(value, ValidationConfigs.TEMPLATE_PATH);
+    }
+    static validateWorktreePath(value) {
+        return this.validatePath(value, ValidationConfigs.WORKTREE_PATH);
+    }
+    static validateOutputPath(value) {
+        return this.validatePath(value, ValidationConfigs.OUTPUT_PATH);
+    }
+    /**
+     * Validate service type against allowed types
+     */
+    static validateServiceType(type) {
+        if (!type || typeof type !== 'string') {
+            throw new ValidationError('Service type is required');
+        }
+        const validTypes = ['postgres', 'mysql', 'redis', 'api', 'app', 'custom'];
+        const normalizedType = type.toLowerCase().trim();
+        if (!validTypes.includes(normalizedType)) {
+            throw new ValidationError(`Invalid service type. Must be one of: ${validTypes.join(', ')}`);
+        }
+        return normalizedType;
+    }
+    /**
+     * Validate script file path for post-hooks and similar
+     */
+    static validateScriptPath(path) {
+        // Uses the same validation logic as template paths but with script-specific extensions
+        return this.validatePath(path, {
+            name: 'script path',
+            maxLength: 200,
+            mustExist: true,
+            allowRelative: true,
+            allowedExtensions: [
+                '.sh',
+                '.bash',
+                '.zsh',
+                '.js',
+                '.mjs',
+                '.ts',
+                '.py',
+                '.rb',
+            ],
+        });
+    }
+    /**
+     * Validate an array of service definitions in "service" or "service:type" format
+     */
+    static validateServices(services) {
+        if (!Array.isArray(services)) {
+            throw new ValidationError('Services must be an array');
+        }
+        return services.map((serviceStr, index) => {
+            if (!serviceStr || typeof serviceStr !== 'string') {
+                throw new ValidationError(`Service at index ${index} is invalid`);
+            }
+            const trimmed = serviceStr.trim();
+            const parts = trimmed.split(':');
+            if (parts.length === 1) {
+                // Format: service (use same name for type)
+                const service = this.validateServiceName(parts[0]);
+                const type = this.validateServiceType(parts[0]);
+                return { service, type };
+            }
+            else if (parts.length === 2) {
+                // Format: service:type
+                const service = this.validateServiceName(parts[0]);
+                const type = this.validateServiceType(parts[1]);
+                return { service, type };
+            }
+            else {
+                throw new ValidationError(`Invalid service format at index ${index}. Use 'service' or 'service:type'`);
+            }
+        });
+    }
+    /**
+     * Sanitize string for safe display/logging, removing dangerous characters
+     */
+    static sanitizeForDisplay(input, maxLength = 100) {
+        if (!input || typeof input !== 'string') {
+            return '';
+        }
+        // Remove control characters and limit length
+        return (input
+            // eslint-disable-next-line no-control-regex
+            .replace(/[\x00-\x1F\x7F]/g, '') // Remove control characters
+            .substring(0, maxLength));
+    }
+}
+//# sourceMappingURL=validation-service.js.map

package/dist/services/validation-service.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Secure setup operations with input validation and safe command execution
+ */
+export interface SetupOptions {
+    template?: string;
+    services?: string[];
+    force?: boolean;
+    skipRender?: boolean;
+    postHook?: string;
+}
+export interface SetupResult {
+    projectName: string;
+    allocatedPorts: Record<string, number>;
+    renderedFiles: string[];
+}
+/**
+ * Secure version of setupCurrentDirectory with input validation and safe execution
+ */
+export declare function setupCurrentDirectory(options?: SetupOptions): Promise<SetupResult>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqKtB"}

package/dist/setup.js

@@ -0,0 +1,243 @@
+/**
+ * Secure setup operations with input validation and safe command execution
+ */
+import { existsSync, readFileSync, writeFileSync, statSync } from 'fs';
+import { basename, join } from 'path';
+import { glob } from 'glob';
+import { allocatePort } from './port-manager.js';
+import { detectServicesFromTemplate, extractProjectNameFromTemplate, makeUrlSafe, processTemplate, } from './render.js';
+import { safeScriptExecution } from './execution.js';
+import { validateServices, validateTemplatePath, validateScriptPath, } from './validation.js';
+/**
+ * Secure version of setupCurrentDirectory with input validation and safe execution
+ */
+export async function setupCurrentDirectory(options = {}) {
+    // Safety check: ensure we're in a main clone, not a worktree
+    if (!isMainClone()) {
+        throw new Error('Setup can only be run in the main repository clone. ' +
+            'Use "devports worktree add" to create worktrees with port allocation.');
+    }
+    // Validate all inputs first (but don't check template existence yet - handled later)
+    const validatedTemplate = options.template;
+    const validatedPostHook = options.postHook
+        ? validateScriptPath(options.postHook)
+        : undefined;
+    let validatedServices;
+    if (options.services) {
+        const validatedServiceList = validateServices(options.services);
+        validatedServices = validatedServiceList.map((s) => `${s.service}:${s.type}`);
+    }
+    const currentDir = process.cwd();
+    const envPath = join(currentDir, '.env');
+    const backupPath = join(currentDir, '.env.backup');
+    // Check if .env already exists
+    if (existsSync(envPath) && !options.force) {
+        throw new Error('.env file already exists. Use --force to overwrite (this will create .env.backup).');
+    }
+    // Backup existing .env if using --force
+    if (existsSync(envPath) && options.force) {
+        writeFileSync(backupPath, readFileSync(envPath, 'utf-8'));
+        console.log(`📋 Backed up existing .env to .env.backup`);
+    }
+    // Determine template and extract project info
+    const templatePath = validatedTemplate
+        ? validatedTemplate.startsWith('/')
+            ? validatedTemplate
+            : join(currentDir, validatedTemplate)
+        : join(currentDir, '.env.devports');
+    let templateContent = null;
+    let projectName = null;
+    let services;
+    if (existsSync(templatePath)) {
+        // Validate template path if it exists
+        if (validatedTemplate) {
+            validateTemplatePath(templatePath);
+        }
+        try {
+            templateContent = readFileSync(templatePath, 'utf-8');
+            services =
+                validatedServices ??
+                    detectServicesFromTemplate(templateContent, templatePath);
+            // If no services detected from template, fall back to default
+            if (!validatedServices && services.length === 0) {
+                services = detectServicesFromEnv();
+            }
+            projectName = extractProjectNameFromTemplate(templateContent);
+        }
+        catch {
+            console.warn(`⚠️  Could not read template ${templatePath}, falling back to detection`);
+            services = validatedServices ?? detectServicesFromEnv();
+        }
+    }
+    else if (validatedServices) {
+        services = validatedServices;
+    }
+    else {
+        services = detectServicesFromEnv();
+    }
+    // Use project name from template or directory name
+    const finalProjectName = projectName ?? basename(process.cwd());
+    const urlSafeProjectName = makeUrlSafe(finalProjectName);
+    console.log(`✅ Setting up ${finalProjectName}...`);
+    if (services.length > 0) {
+        console.log(`📍 Detected services: ${services.map((s) => s.split(':')[0]).join(', ')}`);
+    }
+    // Allocate ports for each service
+    const allocatedPorts = {};
+    const serviceTypes = {};
+    for (const service of services) {
+        const [serviceName, serviceType] = service.split(':');
+        const port = await allocatePort(urlSafeProjectName, serviceName, serviceType);
+        allocatedPorts[serviceName] = port;
+        serviceTypes[serviceName] = serviceType;
+    }
+    if (Object.keys(allocatedPorts).length > 0) {
+        console.log('🔌 Allocated ports:');
+        for (const [service, port] of Object.entries(allocatedPorts)) {
+            const type = serviceTypes[service];
+            console.log(`   ${service}: ${port} (${type})`);
+        }
+    }
+    // Generate .env file
+    if (templateContent) {
+        const processedContent = processTemplate(templateContent, allocatedPorts, urlSafeProjectName, templatePath);
+        writeFileSync(envPath, processedContent);
+        console.log(`📝 Generated .env from ${basename(templatePath)}`);
+    }
+    else if (Object.keys(allocatedPorts).length > 0) {
+        // Create basic .env with just port variables
+        const envContent = `${[
+            '# Generated by devports setup',
+            `DEVPORTS_PROJECT_NAME=${finalProjectName}`,
+            '',
+            ...Object.entries(allocatedPorts).map(([serviceName, port]) => `${serviceName.toUpperCase()}_PORT=${port}`),
+        ].join('\n')}\n`;
+        writeFileSync(envPath, envContent);
+        console.log('📝 Generated basic .env with allocated ports');
+    }
+    // Auto-render *.devports files
+    const renderedFiles = [];
+    if (!options.skipRender) {
+        const rendered = await autoRenderDevportsFiles(process.cwd(), allocatedPorts, urlSafeProjectName);
+        renderedFiles.push(...rendered);
+    }
+    // Run post-hook if available
+    if (validatedPostHook || existsSync('.devports/hooks/post-setup')) {
+        await runPostHook(process.cwd(), allocatedPorts, urlSafeProjectName, validatedPostHook);
+    }
+    console.log('✅ Setup complete!');
+    return {
+        projectName: finalProjectName,
+        allocatedPorts,
+        renderedFiles,
+    };
+}
+/**
+ * Check if we're in the main clone (not a worktree)
+ */
+function isMainClone() {
+    try {
+        // In main clone, .git is a directory
+        // In worktree, .git is a file containing path to main .git
+        const gitPath = join(process.cwd(), '.git');
+        return existsSync(gitPath) && statSync(gitPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect services from existing .env file in current directory
+ */
+function detectServicesFromEnv() {
+    const services = [];
+    const envPath = join(process.cwd(), '.env');
+    if (existsSync(envPath)) {
+        const envContent = readFileSync(envPath, 'utf-8');
+        const portPatterns = [
+            { regex: /DATABASE_PORT|POSTGRES_PORT/i, service: 'postgres:postgres' },
+            { regex: /MYSQL_PORT/i, service: 'mysql:mysql' },
+            { regex: /REDIS_PORT/i, service: 'redis:redis' },
+            { regex: /API_PORT/i, service: 'api:api' },
+            { regex: /APP_PORT|WEB_PORT/i, service: 'app:app' },
+        ];
+        for (const pattern of portPatterns) {
+            if (pattern.regex.test(envContent) &&
+                !services.includes(pattern.service)) {
+                services.push(pattern.service);
+            }
+        }
+    }
+    // Default to postgres if nothing detected
+    if (services.length === 0) {
+        services.push('postgres:postgres');
+    }
+    return services;
+}
+/**
+ * Auto-render any *.devports files found in the current directory
+ */
+async function autoRenderDevportsFiles(currentPath, allocatedPorts, projectName) {
+    try {
+        const devportsFiles = await glob('**/*.devports', {
+            cwd: currentPath,
+            ignore: ['node_modules/**', '.git/**'],
+        });
+        if (devportsFiles.length === 0) {
+            return [];
+        }
+        console.log(`🔄 Auto-rendering ${devportsFiles.length} *.devports files...`);
+        const renderedFiles = [];
+        for (const devportsFile of devportsFiles) {
+            const fullDevportsPath = join(currentPath, devportsFile);
+            const outputPath = join(currentPath, devportsFile.replace(/\.devports$/, ''));
+            try {
+                const templateContent = readFileSync(fullDevportsPath, 'utf-8');
+                const processedContent = processTemplate(templateContent, allocatedPorts, projectName, devportsFile);
+                writeFileSync(outputPath, processedContent);
+                const outputFileName = devportsFile.replace(/\.devports$/, '');
+                console.log(`   ${outputFileName} (from ${devportsFile})`);
+                renderedFiles.push(outputFileName);
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to render ${devportsFile}: ${error.message}`);
+            }
+        }
+        return renderedFiles;
+    }
+    catch (error) {
+        console.warn(`⚠️  Error during auto-rendering: ${error.message}`);
+        return [];
+    }
+}
+/**
+ * Run post-setup hook if available (secure version)
+ */
+async function runPostHook(currentPath, allocatedPorts, projectName, customHook) {
+    const hookScript = customHook ?? '.devports/hooks/post-setup';
+    if (!existsSync(hookScript)) {
+        return;
+    }
+    try {
+        console.log('🔗 Running post-setup hook...');
+        // Prepare environment variables
+        const hookEnv = {
+            DEVPORTS_PROJECT_NAME: projectName,
+            DEVPORTS_SETUP_PATH: currentPath,
+        };
+        // Add all port variables
+        for (const [service, port] of Object.entries(allocatedPorts)) {
+            const varName = `${service.toUpperCase().replace(/-/g, '_')}_PORT`;
+            hookEnv[varName] = port.toString();
+        }
+        // Execute hook script safely
+        await safeScriptExecution(hookScript, hookEnv, {
+            cwd: currentPath,
+        });
+        console.log('✅ Post-setup hook completed');
+    }
+    catch (error) {
+        console.warn(`⚠️  Post-setup hook failed: ${error.message}`);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+export interface PortRange {
+    start: number;
+    end: number;
+}
+export interface Config {
+    ranges: Record<string, PortRange>;
+    registryPath: string;
+}
+export interface PortAllocation {
+    port: number;
+    project: string;
+    service: string;
+    type: string;
+    allocatedAt: string;
+    note?: string;
+}
+export interface Registry {
+    allocations: PortAllocation[];
+    reservations: {
+        port: number;
+        reason: string;
+        reservedAt: string;
+    }[];
+}
+export declare const VALID_PORT_TYPES: readonly ["postgres", "mysql", "redis", "api", "app", "custom"];
+export type PortType = (typeof VALID_PORT_TYPES)[number];
+export declare function isValidPortType(type: string): type is PortType;
+export declare function getValidPortTypes(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;CACL;AAGD,eAAO,MAAM,gBAAgB,iEAOnB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,QAAQ,CAE9D;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/types.js

@@ -0,0 +1,18 @@
+// Valid port types - exported for validation
+export const VALID_PORT_TYPES = [
+    'postgres',
+    'mysql',
+    'redis',
+    'api',
+    'app',
+    'custom',
+];
+// Helper to validate port type
+export function isValidPortType(type) {
+    return VALID_PORT_TYPES.includes(type);
+}
+// Helper to get valid types as string
+export function getValidPortTypes() {
+    return VALID_PORT_TYPES.join(', ');
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4BA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,OAAO;IACP,OAAO;IACP,KAAK;IACL,KAAK;IACL,QAAQ;CACA,CAAC;AAIX,+BAA+B;AAC/B,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;AACrD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}