opkg 0.6.1 → 0.7.0

package/dist/core/install/marketplace-handler.js

@@ -0,0 +1,221 @@
+import { join } from 'path';
+import { readTextFile, exists } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { ValidationError } from '../../utils/errors.js';
+import { runPathInstallPipeline } from './path-install-pipeline.js';
+import { detectPluginType, validatePluginManifest } from './plugin-detector.js';
+import prompts from 'prompts';
+/**
+ * Parse and validate a marketplace manifest.
+ *
+ * @param manifestPath - Path to marketplace.json file
+ * @returns Parsed marketplace manifest
+ */
+export async function parseMarketplace(manifestPath) {
+    logger.debug('Parsing marketplace manifest', { manifestPath });
+    try {
+        const content = await readTextFile(manifestPath);
+        const manifest = JSON.parse(content);
+        // Validate required fields
+        if (!manifest.name) {
+            throw new ValidationError('Marketplace manifest missing required field: name');
+        }
+        if (!manifest.plugins || !Array.isArray(manifest.plugins)) {
+            throw new ValidationError('Marketplace manifest missing or invalid plugins array');
+        }
+        if (manifest.plugins.length === 0) {
+            throw new ValidationError('Marketplace contains no plugins');
+        }
+        // Validate each plugin entry
+        for (const plugin of manifest.plugins) {
+            if (!plugin.name) {
+                throw new ValidationError('Marketplace plugin entry missing required field: name');
+            }
+            // Accept either subdirectory (opkg) or source (Claude Code) field
+            if (!plugin.subdirectory && !plugin.source) {
+                throw new ValidationError(`Plugin '${plugin.name}' missing required field: subdirectory or source`);
+            }
+            // Normalize: if source is provided but not subdirectory, use source as subdirectory
+            if (!plugin.subdirectory && plugin.source) {
+                plugin.subdirectory = plugin.source;
+            }
+        }
+        logger.info('Parsed marketplace manifest', {
+            name: manifest.name,
+            pluginCount: manifest.plugins.length
+        });
+        return manifest;
+    }
+    catch (error) {
+        if (error instanceof ValidationError) {
+            throw error;
+        }
+        throw new ValidationError(`Failed to parse marketplace manifest at ${manifestPath}: ${error}`);
+    }
+}
+/**
+ * Display interactive plugin selection prompt.
+ *
+ * @param marketplace - Parsed marketplace manifest
+ * @returns Array of selected plugin names (empty if user cancelled)
+ */
+export async function promptPluginSelection(marketplace) {
+    console.log(`\n📦 Marketplace: ${marketplace.name}`);
+    if (marketplace.description) {
+        console.log(`   ${marketplace.description}`);
+    }
+    console.log(`\n${marketplace.plugins.length} plugin${marketplace.plugins.length === 1 ? '' : 's'} available:\n`);
+    const choices = marketplace.plugins.map(plugin => ({
+        title: plugin.name,
+        value: plugin.name,
+        description: plugin.description || '',
+        selected: false
+    }));
+    const response = await prompts({
+        type: 'multiselect',
+        name: 'plugins',
+        message: 'Select plugins to install (space to select, enter to confirm):',
+        choices,
+        min: 1,
+        hint: '- Use arrow keys to navigate, space to select/deselect, enter to confirm'
+    });
+    if (!response.plugins || response.plugins.length === 0) {
+        logger.info('User cancelled plugin selection');
+        return [];
+    }
+    logger.info('User selected plugins', { selected: response.plugins });
+    return response.plugins;
+}
+/**
+ * Install selected plugins from a marketplace.
+ *
+ * @param marketplaceDir - Absolute path to cloned marketplace repository root
+ * @param marketplace - Parsed marketplace manifest
+ * @param selectedNames - Names of plugins to install
+ * @param gitUrl - Git URL of the marketplace repository
+ * @param gitRef - Git ref (branch/tag/sha) if specified
+ * @param options - Install options
+ */
+export async function installMarketplacePlugins(marketplaceDir, marketplace, selectedNames, gitUrl, gitRef, options) {
+    logger.info('Installing marketplace plugins', {
+        marketplace: marketplace.name,
+        plugins: selectedNames
+    });
+    const results = [];
+    for (const pluginName of selectedNames) {
+        const pluginEntry = marketplace.plugins.find(p => p.name === pluginName);
+        if (!pluginEntry) {
+            logger.error(`Plugin '${pluginName}' not found in marketplace`, { marketplace: marketplace.name });
+            results.push({
+                name: pluginName,
+                success: false,
+                error: `Plugin not found in marketplace`
+            });
+            continue;
+        }
+        const pluginSubdir = pluginEntry.subdirectory || pluginEntry.source;
+        if (!pluginSubdir) {
+            logger.error(`Plugin entry missing both subdirectory and source fields`, { plugin: pluginName });
+            results.push({
+                name: pluginName,
+                success: false,
+                error: `Plugin entry missing subdirectory/source field`
+            });
+            continue;
+        }
+        const pluginDir = join(marketplaceDir, pluginSubdir);
+        // Validate plugin subdirectory exists
+        if (!(await exists(pluginDir))) {
+            logger.error(`Plugin subdirectory does not exist`, {
+                plugin: pluginName,
+                subdirectory: pluginSubdir,
+                fullPath: pluginDir
+            });
+            results.push({
+                name: pluginName,
+                success: false,
+                error: `Subdirectory '${pluginSubdir}' does not exist`
+            });
+            continue;
+        }
+        // Validate plugin structure
+        const detection = await detectPluginType(pluginDir);
+        if (!detection.isPlugin || detection.type !== 'individual') {
+            logger.error(`Subdirectory is not a valid plugin`, {
+                plugin: pluginName,
+                subdirectory: pluginSubdir
+            });
+            results.push({
+                name: pluginName,
+                success: false,
+                error: `Subdirectory does not contain a valid plugin (missing .claude-plugin/plugin.json)`
+            });
+            continue;
+        }
+        // Validate plugin manifest is parseable
+        if (!(await validatePluginManifest(detection.manifestPath))) {
+            results.push({
+                name: pluginName,
+                success: false,
+                error: `Invalid plugin manifest (cannot parse JSON)`
+            });
+            continue;
+        }
+        // Install the plugin
+        console.log(`\n📦 Installing plugin: ${pluginName}...`);
+        try {
+            await runPathInstallPipeline({
+                ...options,
+                sourcePath: pluginDir,
+                sourceType: 'directory',
+                targetDir: '.',
+                gitUrl,
+                gitRef,
+                gitSubdirectory: pluginSubdir
+            });
+            results.push({ name: pluginName, success: true });
+            console.log(`✓ Successfully installed ${pluginName}`);
+        }
+        catch (error) {
+            logger.error(`Failed to install plugin`, { plugin: pluginName, error });
+            results.push({
+                name: pluginName,
+                success: false,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            console.error(`✗ Failed to install ${pluginName}: ${error}`);
+        }
+    }
+    // Display summary
+    console.log('\n' + '='.repeat(60));
+    console.log('Installation Summary:');
+    console.log('='.repeat(60));
+    const successful = results.filter(r => r.success);
+    const failed = results.filter(r => !r.success);
+    if (successful.length > 0) {
+        console.log(`\n✓ Successfully installed (${successful.length}):`);
+        for (const result of successful) {
+            console.log(`  • ${result.name}`);
+        }
+    }
+    if (failed.length > 0) {
+        console.log(`\n✗ Failed to install (${failed.length}):`);
+        for (const result of failed) {
+            console.log(`  • ${result.name}: ${result.error}`);
+        }
+    }
+    console.log('');
+    // Return success if at least one plugin was installed
+    if (successful.length > 0) {
+        return {
+            success: true
+        };
+    }
+    else {
+        return {
+            success: false,
+            error: 'Failed to install any plugins from marketplace'
+        };
+    }
+}
+//# sourceMappingURL=marketplace-handler.js.map

package/dist/core/install/marketplace-handler.js.map

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

package/dist/core/install/path-install-pipeline.js

@@ -0,0 +1,241 @@
+import { displayDependencyTree } from '../dependency-resolver.js';
+import { ensureRegistryDirectories } from '../directory.js';
+import { prepareInstallEnvironment, processConflictResolution, performIndexBasedInstallationPhases, VersionResolutionAbortError } from './install-flow.js';
+import { handleDryRunMode } from './dry-run.js';
+import { displayInstallationResults, formatSelectionSummary } from './install-reporting.js';
+import { resolvePlatforms } from './platform-resolution.js';
+import { getLocalPackageYmlPath, getInstallRootDir, isRootPackage } from '../../utils/paths.js';
+import { exists } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { PackageNotFoundError } from '../../utils/errors.js';
+import { normalizePathForProcessing } from '../../utils/path-normalization.js';
+import { loadPackageFromPath } from './path-package-loader.js';
+import { createWorkspacePackageYml, addPackageToYml, } from '../../utils/package-management.js';
+import { determineResolutionMode } from './install-pipeline.js';
+/**
+ * Install a package from a local directory or tarball path.
+ *
+ * Flow:
+ * 1. Load package from path
+ * 2. Resolve dependencies recursively (handles path-based deps)
+ * 3. Copy to workspace .openpackage/packages/ for consistency
+ * 4. Install to workspace platforms
+ * 5. Update workspace openpackage.yml with path field
+ */
+export async function runPathInstallPipeline(options) {
+    const cwd = process.cwd();
+    const resolutionMode = determineResolutionMode(options);
+    const dryRun = Boolean(options.dryRun);
+    const warnings = [];
+    const warnedPackages = new Set();
+    // Load package from path
+    logger.debug(`Loading package from ${options.sourceType}: ${options.sourcePath}`);
+    let sourcePackage;
+    let isPlugin = false;
+    try {
+        // Check if this is a Claude Code plugin
+        const { detectPluginType } = await import('./plugin-detector.js');
+        const pluginDetection = await detectPluginType(options.sourcePath);
+        if (pluginDetection.isPlugin && pluginDetection.type === 'individual') {
+            isPlugin = true;
+            console.log(`\n🔌 Detected Claude Code plugin`);
+        }
+        sourcePackage = await loadPackageFromPath(options.sourcePath);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to load package from ${options.sourceType} '${options.sourcePath}': ${error}`
+        };
+    }
+    const packageName = sourcePackage.metadata.name;
+    const packageVersion = sourcePackage.metadata.version || '0.0.0';
+    if (isPlugin) {
+        console.log(`📦 Installing plugin: ${packageName}@${packageVersion}`);
+    }
+    // Check for root package conflict
+    if (await isRootPackage(cwd, packageName)) {
+        console.log(`⚠️  Cannot install ${packageName} - it matches your project's root package name`);
+        console.log(`   This would create a circular dependency.`);
+        return {
+            success: true,
+            data: {
+                packageName,
+                targetDir: getInstallRootDir(cwd),
+                resolvedPackages: [],
+                totalPackages: 0,
+                installed: 0,
+                skipped: 1,
+                totalOpenPackageFiles: 0,
+                sourcePath: options.sourcePath,
+                sourceType: options.sourceType
+            }
+        };
+    }
+    await ensureRegistryDirectories();
+    await createWorkspacePackageYml(cwd);
+    // Resolve dependencies (this will handle path-based dependencies recursively)
+    const resolveDependenciesOutcome = async () => {
+        try {
+            // First, add the source package to resolved packages
+            const resolvedPackages = new Map();
+            resolvedPackages.set(packageName, {
+                name: packageName,
+                version: packageVersion,
+                pkg: sourcePackage,
+                isRoot: true,
+                source: 'path',
+                contentRoot: options.sourcePath // Store the source path for installation phase
+            });
+            // Resolve dependencies from the source package
+            // We need to manually resolve dependencies since resolveDependenciesForInstall expects a registry package
+            const { resolveDependencies } = await import('../dependency-resolver.js');
+            const { gatherGlobalVersionConstraints, gatherRootVersionConstraints } = await import('../openpackage.js');
+            const globalConstraints = await gatherGlobalVersionConstraints(cwd);
+            const rootConstraints = await gatherRootVersionConstraints(cwd);
+            const rootOverrides = new Map(rootConstraints);
+            const resolverOptions = {
+                mode: resolutionMode,
+                profile: options.profile,
+                apiKey: options.apiKey,
+                onWarning: (message) => {
+                    warnings.push(message);
+                    console.log(`⚠️  ${message}`);
+                }
+            };
+            // Resolve dependencies, passing the source path for relative resolution
+            const depResult = await resolveDependencies(packageName, cwd, true, new Set(), // Empty visitedStack - resolveDependencies manages this internally
+            resolvedPackages, packageVersion, new Map(), globalConstraints, rootOverrides, resolverOptions, new Map(), options.sourcePath // Pass source path for relative dependency resolution
+            );
+            return {
+                success: true,
+                data: {
+                    resolvedPackages: Array.from(resolvedPackages.values()),
+                    missingPackages: Array.from(depResult.missingPackages),
+                    remoteOutcomes: depResult.remoteOutcomes,
+                    warnings: warnings.length > 0 ? warnings : undefined
+                }
+            };
+        }
+        catch (error) {
+            if (error instanceof VersionResolutionAbortError) {
+                return {
+                    success: false,
+                    commandResult: { success: false, error: error.message }
+                };
+            }
+            if (error instanceof PackageNotFoundError ||
+                (error instanceof Error &&
+                    (error.message.includes('not available in local registry') ||
+                        (error.message.includes('Package') && error.message.includes('not found'))))) {
+                console.log('❌ Package not found');
+                return { success: false, commandResult: { success: false, error: 'Package not found' } };
+            }
+            throw error;
+        }
+    };
+    const initialResolution = await resolveDependenciesOutcome();
+    if (!initialResolution.success) {
+        return initialResolution.commandResult;
+    }
+    let resolvedPackages = initialResolution.data.resolvedPackages;
+    let missingPackages = initialResolution.data.missingPackages;
+    const remoteOutcomes = initialResolution.data.remoteOutcomes || {};
+    if (missingPackages.length > 0) {
+        const missingSummary = `Missing packages: ${Array.from(new Set(missingPackages)).join(', ')}`;
+        console.log(`⚠️  ${missingSummary}`);
+        warnings.push(missingSummary);
+    }
+    // Display selection summary
+    console.log(formatSelectionSummary('path', packageName, packageVersion));
+    const { specifiedPlatforms } = await prepareInstallEnvironment(cwd, options);
+    const conflictProcessing = await processConflictResolution(resolvedPackages, options);
+    if ('cancelled' in conflictProcessing) {
+        console.log(`Installation cancelled by user`);
+        return {
+            success: true,
+            data: {
+                packageName,
+                targetDir: getInstallRootDir(cwd),
+                resolvedPackages: [],
+                totalPackages: 0,
+                installed: 0,
+                skipped: 1,
+                totalOpenPackageFiles: 0,
+                sourcePath: options.sourcePath,
+                sourceType: options.sourceType
+            }
+        };
+    }
+    const { finalResolvedPackages, conflictResult } = conflictProcessing;
+    displayDependencyTree(finalResolvedPackages, true);
+    const packageYmlPath = getLocalPackageYmlPath(cwd);
+    const packageYmlExists = await exists(packageYmlPath);
+    if (dryRun) {
+        // For dry run, we still need to write the package to workspace for consistency
+        // but we'll use the standard dry run handler
+        return await handleDryRunMode(finalResolvedPackages, packageName, options.targetDir, options, packageYmlExists);
+    }
+    const canPromptForPlatforms = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const finalPlatforms = options.resolvedPlatforms && options.resolvedPlatforms.length > 0
+        ? options.resolvedPlatforms
+        : await resolvePlatforms(cwd, specifiedPlatforms, { interactive: canPromptForPlatforms });
+    // TODO: Removed manual source copy to .openpackage/packages/ as redundant with index-based install
+    // Source files handled via installPackageByIndex; index tracks mappings
+    // If local cache needed for path sources, register to registry minimally instead
+    const { getLocalPackageDir } = await import('../../utils/paths.js'); // Keep import if needed elsewhere
+    logger.debug('Skipped manual source package copy to local packages dir', { packageName, sourcePath: options.sourcePath });
+    // Install to workspace platforms
+    const installationOutcome = await performIndexBasedInstallationPhases({
+        cwd,
+        packages: finalResolvedPackages,
+        platforms: finalPlatforms,
+        conflictResult,
+        options,
+        targetDir: options.targetDir,
+        fileFilters: undefined // Full install for path-based packages
+    });
+    // Update workspace openpackage.yml with path-based dependency
+    const mainPackage = finalResolvedPackages.find(pkg => pkg.isRoot);
+    if (packageYmlExists && mainPackage) {
+        // Store relative path if possible, otherwise absolute
+        const relativePath = normalizePathForProcessing(options.sourcePath);
+        const pathToStore = relativePath.startsWith('..') || relativePath.startsWith('/')
+            ? relativePath
+            : `./${relativePath}`;
+        await addPackageToYml(cwd, packageName, packageVersion, options.dev ?? false, undefined, // No range for path-based packages
+        true, undefined, // No include filter
+        options.gitUrl ? undefined : pathToStore, // Store the path when not git
+        options.gitUrl, options.gitRef, options.gitSubdirectory);
+    }
+    displayInstallationResults(packageName, finalResolvedPackages, { platforms: finalPlatforms, created: [] }, options, mainPackage, installationOutcome.allAddedFiles, installationOutcome.allUpdatedFiles, installationOutcome.rootFileResults, missingPackages, remoteOutcomes, installationOutcome.errorCount, installationOutcome.errors);
+    // Check if installation actually failed
+    const hadErrors = installationOutcome.errorCount > 0;
+    const installedAnyFiles = installationOutcome.allAddedFiles.length > 0 ||
+        installationOutcome.allUpdatedFiles.length > 0 ||
+        installationOutcome.rootFileResults.installed.length > 0 ||
+        installationOutcome.rootFileResults.updated.length > 0;
+    if (hadErrors && !installedAnyFiles) {
+        // Complete failure - return error
+        return {
+            success: false,
+            error: `Failed to install ${packageName}: ${installationOutcome.errors?.join('; ')}`,
+        };
+    }
+    return {
+        success: true,
+        data: {
+            packageName,
+            targetDir: getInstallRootDir(cwd),
+            resolvedPackages: finalResolvedPackages,
+            totalPackages: finalResolvedPackages.length,
+            installed: installationOutcome.installedCount,
+            skipped: installationOutcome.skippedCount,
+            totalOpenPackageFiles: installationOutcome.totalOpenPackageFiles,
+            sourcePath: options.sourcePath,
+            sourceType: options.sourceType
+        },
+        warnings: warnings.length > 0 ? Array.from(new Set(warnings)) : undefined
+    };
+}
+//# sourceMappingURL=path-install-pipeline.js.map

package/dist/core/install/path-install-pipeline.js.map

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

package/dist/core/install/path-package-loader.js

@@ -0,0 +1,116 @@
+import { relative, basename } from 'path';
+import { readFile } from 'fs/promises';
+import { loadPackageConfig } from '../package-context.js';
+import { extractPackageFromTarball } from '../../utils/tarball.js';
+import { walkFiles, readTextFile } from '../../utils/fs.js';
+import { isJunk } from 'junk';
+import { logger } from '../../utils/logger.js';
+import { ValidationError } from '../../utils/errors.js';
+import { FILE_PATTERNS, PACKAGE_PATHS } from '../../constants/index.js';
+import { detectPluginType } from './plugin-detector.js';
+import { transformPluginToPackage } from './plugin-transformer.js';
+/**
+ * Infer the source type from a path string.
+ */
+export function inferSourceType(path) {
+    return path.endsWith('.tgz') || path.endsWith('.tar.gz') ? 'tarball' : 'directory';
+}
+/**
+ * Load a package from a local directory.
+ * Reads all files from the directory and loads openpackage.yml.
+ *
+ * If the directory is a Claude Code plugin, transforms it to OpenPackage format.
+ */
+export async function loadPackageFromDirectory(dirPath) {
+    logger.debug(`Loading package from directory: ${dirPath}`);
+    // Check if this is a Claude Code plugin
+    const pluginDetection = await detectPluginType(dirPath);
+    if (pluginDetection.isPlugin && pluginDetection.type === 'individual') {
+        logger.info('Detected Claude Code plugin, transforming to OpenPackage format', { dirPath });
+        return await transformPluginToPackage(dirPath);
+    }
+    // If it's a marketplace, we need to handle plugin selection (done upstream in install command)
+    if (pluginDetection.isPlugin && pluginDetection.type === 'marketplace') {
+        throw new ValidationError(`Directory '${dirPath}' is a Claude Code plugin marketplace. ` +
+            `Marketplace installation requires plugin selection and should be handled by the install command.`);
+    }
+    // Load openpackage.yml for regular packages
+    const config = await loadPackageConfig(dirPath);
+    if (!config) {
+        throw new ValidationError(`Directory '${dirPath}' is not a valid OpenPackage directory or Claude Code plugin. ` +
+            `Missing ${FILE_PATTERNS.OPENPACKAGE_YML} or .claude-plugin/plugin.json`);
+    }
+    // Discover all files in the directory
+    const files = [];
+    try {
+        for await (const fullPath of walkFiles(dirPath)) {
+            const relativePath = relative(dirPath, fullPath);
+            // Filter out junk files
+            if (isJunk(basename(relativePath))) {
+                continue;
+            }
+            const content = await readTextFile(fullPath);
+            files.push({
+                path: relativePath,
+                content,
+                encoding: 'utf8'
+            });
+        }
+        logger.debug(`Loaded ${files.length} files from directory: ${dirPath}`);
+        return {
+            metadata: config,
+            files
+        };
+    }
+    catch (error) {
+        logger.error(`Failed to load package from directory: ${dirPath}`, { error });
+        throw new ValidationError(`Failed to load package from directory: ${error}`);
+    }
+}
+/**
+ * Load a package from a tarball file.
+ * Extracts to a temporary location, reads files, then cleans up.
+ */
+export async function loadPackageFromTarball(tarballPath) {
+    logger.debug(`Loading package from tarball: ${tarballPath}`);
+    // Read tarball file
+    let tarballBuffer;
+    try {
+        tarballBuffer = await readFile(tarballPath);
+    }
+    catch (error) {
+        throw new ValidationError(`Failed to read tarball file '${tarballPath}': ${error}`);
+    }
+    // Extract tarball
+    const extracted = await extractPackageFromTarball(tarballBuffer);
+    // Find openpackage.yml in extracted files
+    const packageYmlFile = extracted.files.find(f => f.path === PACKAGE_PATHS.MANIFEST_RELATIVE || f.path === 'openpackage.yml');
+    if (!packageYmlFile) {
+        throw new ValidationError(`Tarball '${tarballPath}' does not contain a valid ${FILE_PATTERNS.OPENPACKAGE_YML} file`);
+    }
+    // Parse openpackage.yml content
+    const yaml = await import('js-yaml');
+    const config = yaml.load(packageYmlFile.content);
+    if (!config.name) {
+        throw new ValidationError(`Tarball '${tarballPath}' contains invalid ${FILE_PATTERNS.OPENPACKAGE_YML}: missing name field`);
+    }
+    logger.debug(`Loaded package ${config.name}@${config.version} from tarball: ${tarballPath}`);
+    return {
+        metadata: config,
+        files: extracted.files
+    };
+}
+/**
+ * Load a package from either a directory or tarball path.
+ * Automatically detects the source type.
+ */
+export async function loadPackageFromPath(path) {
+    const sourceType = inferSourceType(path);
+    if (sourceType === 'tarball') {
+        return await loadPackageFromTarball(path);
+    }
+    else {
+        return await loadPackageFromDirectory(path);
+    }
+}
+//# sourceMappingURL=path-package-loader.js.map

package/dist/core/install/path-package-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-package-loader.js","sourceRoot":"","sources":["../../../src/core/install/path-package-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAInE;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAe;IAC5D,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;IAE3D,wCAAwC;IACxC,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,iEAAiE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5F,OAAO,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,+FAA+F;IAC/F,IAAI,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACvE,MAAM,IAAI,eAAe,CACvB,cAAc,OAAO,yCAAyC;YAC9D,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,eAAe,CACvB,cAAc,OAAO,gEAAgE;YACrF,WAAW,aAAa,CAAC,eAAe,gCAAgC,CACzE,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEjD,wBAAwB;YACxB,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE7C,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,YAAY;gBAClB,OAAO;gBACP,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,MAAM,0BAA0B,OAAO,EAAE,CAAC,CAAC;QAExE,OAAO;YACL,QAAQ,EAAE,MAAM;YAChB,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0CAA0C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAI,eAAe,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAmB;IAC9D,MAAM,CAAC,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;IAE7D,oBAAoB;IACpB,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,gCAAgC,WAAW,MAAM,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,kBAAkB;IAClB,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAEjE,0CAA0C;IAC1C,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,iBAAiB,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAChF,CAAC;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,YAAY,WAAW,8BAA8B,aAAa,CAAC,eAAe,OAAO,CAC1F,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAe,CAAC;IAE/D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,eAAe,CACvB,YAAY,WAAW,sBAAsB,aAAa,CAAC,eAAe,sBAAsB,CACjG,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,kBAAkB,WAAW,EAAE,CAAC,CAAC;IAE7F,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,SAAS,CAAC,KAAK;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}