@hypercli/gen 0.1.1

package/dist/recipe-engine/group-executor.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Group Executor
+ *
+ * Discovers recipes in a directory, builds a dependency graph based on
+ * `provides` / required variables, resolves execution order via topological
+ * sort, and executes batches — piping providedValues between recipes.
+ */
+import type { RecipeEngine, RecipeExecutionOptions, RecipeExecutionResult } from "./recipe-engine.js";
+import type { RecipeConfig } from "./types.js";
+/**
+ * A recipe discovered within a group directory
+ */
+export interface GroupRecipeEntry {
+    /** Recipe name (directory name) */
+    name: string;
+    /** Path to recipe.yml */
+    recipeYmlPath: string;
+    /** Parsed recipe config (loaded lazily) */
+    config?: RecipeConfig;
+}
+/**
+ * A group of recipes in a directory
+ */
+export interface RecipeGroup {
+    /** Directory path */
+    dirPath: string;
+    /** Discovered recipes */
+    recipes: GroupRecipeEntry[];
+}
+/**
+ * Result of a group execution
+ */
+export interface GroupExecutionResult {
+    /** Overall success */
+    success: boolean;
+    /** Per-recipe results, in execution order */
+    recipeResults: Array<{
+        name: string;
+        result: RecipeExecutionResult;
+    }>;
+    /** Accumulated provided values from all recipes */
+    providedValues: Record<string, any>;
+    /** Total execution duration in ms */
+    duration: number;
+    /** Errors across all recipes */
+    errors: string[];
+    /** Recipes that require external parameters (not provided by siblings) */
+    externalParams: string[];
+}
+export declare class GroupExecutor {
+    private readonly recipeEngine;
+    constructor(recipeEngine: RecipeEngine);
+    /**
+     * Discover all recipes in a directory.
+     *
+     * Rules:
+     * - Scan immediate subdirectories
+     * - If a subdirectory has recipe.yml → include it, stop recursion
+     * - If a subdirectory has NO recipe.yml → recurse into it
+     */
+    discoverGroup(dirPath: string): Promise<RecipeGroup>;
+    /**
+     * Load all recipe configs in a group.
+     */
+    loadGroupConfigs(group: RecipeGroup): Promise<void>;
+    /**
+     * Build a dependency graph from provides/requires relationships.
+     *
+     * Returns:
+     * - depGraph: Map<recipeName, Set<recipeName it depends on>>
+     * - providesMap: Map<varName, recipeName that provides it>
+     */
+    buildDependencyGraph(recipes: GroupRecipeEntry[]): {
+        depGraph: Map<string, Set<string>>;
+        providesMap: Map<string, string>;
+        errors: string[];
+    };
+    /**
+     * Topological sort — returns batches of recipes that can run in parallel.
+     */
+    topologicalSort(depGraph: Map<string, Set<string>>): string[][];
+    /**
+     * Execute all recipes in a group with dependency resolution.
+     */
+    executeGroup(group: RecipeGroup, baseVars: Record<string, any>, options?: RecipeExecutionOptions): Promise<GroupExecutionResult>;
+    /**
+     * Compute parameters required by the group but not provided by any sibling.
+     * These must come from CLI args or user prompts.
+     */
+    private computeExternalParams;
+    /**
+     * Detect circular dependencies via DFS.
+     * Returns the cycle path if found, null otherwise.
+     */
+    private detectCycle;
+}
+//# sourceMappingURL=group-executor.d.ts.map

package/dist/recipe-engine/group-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-executor.d.ts","sourceRoot":"","sources":["../../src/recipe-engine/group-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACX,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,aAAa,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,qBAAqB,CAAC;KAC9B,CAAC,CAAC;IACH,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,aAAa;IACb,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEvD;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+B1D;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG;QAClD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,MAAM,EAAE,CAAC;KACjB;IA8CD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,EAAE;IAoC/D;;OAEG;IACG,YAAY,CACjB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,OAAO,GAAE,sBAA2B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IA+GhC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;OAGG;IACH,OAAO,CAAC,WAAW;CA8BnB"}

package/dist/recipe-engine/group-executor.js

@@ -0,0 +1,293 @@
+/**
+ * Group Executor
+ *
+ * Discovers recipes in a directory, builds a dependency graph based on
+ * `provides` / required variables, resolves execution order via topological
+ * sort, and executes batches — piping providedValues between recipes.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import createDebug from "debug";
+const debug = createDebug("hyper:recipe:group-executor");
+export class GroupExecutor {
+    recipeEngine;
+    constructor(recipeEngine) {
+        this.recipeEngine = recipeEngine;
+    }
+    /**
+     * Discover all recipes in a directory.
+     *
+     * Rules:
+     * - Scan immediate subdirectories
+     * - If a subdirectory has recipe.yml → include it, stop recursion
+     * - If a subdirectory has NO recipe.yml → recurse into it
+     */
+    async discoverGroup(dirPath) {
+        const recipes = [];
+        const scanDir = (dir) => {
+            if (!fs.existsSync(dir))
+                return;
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const subDir = path.join(dir, entry.name);
+                const recipeYml = path.join(subDir, "recipe.yml");
+                if (fs.existsSync(recipeYml)) {
+                    recipes.push({
+                        name: entry.name,
+                        recipeYmlPath: recipeYml,
+                    });
+                }
+                else {
+                    // Recurse — this might be a subgroup
+                    scanDir(subDir);
+                }
+            }
+        };
+        scanDir(dirPath);
+        debug("Discovered %d recipes in group: %s", recipes.length, dirPath);
+        return { dirPath, recipes };
+    }
+    /**
+     * Load all recipe configs in a group.
+     */
+    async loadGroupConfigs(group) {
+        for (const entry of group.recipes) {
+            if (!entry.config) {
+                const loadResult = await this.recipeEngine.loadRecipe({
+                    type: "file",
+                    path: entry.recipeYmlPath,
+                });
+                entry.config = loadResult.recipe;
+            }
+        }
+    }
+    /**
+     * Build a dependency graph from provides/requires relationships.
+     *
+     * Returns:
+     * - depGraph: Map<recipeName, Set<recipeName it depends on>>
+     * - providesMap: Map<varName, recipeName that provides it>
+     */
+    buildDependencyGraph(recipes) {
+        const providesMap = new Map();
+        const depGraph = new Map();
+        const errors = [];
+        // Collect all provides
+        for (const entry of recipes) {
+            depGraph.set(entry.name, new Set());
+            if (!entry.config?.provides)
+                continue;
+            for (const p of entry.config.provides) {
+                if (providesMap.has(p.name)) {
+                    errors.push(`Variable '${p.name}' is provided by both '${providesMap.get(p.name)}' and '${entry.name}'`);
+                }
+                else {
+                    providesMap.set(p.name, entry.name);
+                }
+            }
+        }
+        // Build edges: if a recipe requires a variable that another provides, add a dependency
+        for (const entry of recipes) {
+            if (!entry.config?.variables)
+                continue;
+            for (const [varName, varDef] of Object.entries(entry.config.variables)) {
+                if (!varDef.required || varDef.default !== undefined)
+                    continue;
+                const provider = providesMap.get(varName);
+                if (provider && provider !== entry.name) {
+                    depGraph.get(entry.name)?.add(provider);
+                    debug("Dependency: %s depends on %s (via %s)", entry.name, provider, varName);
+                }
+            }
+        }
+        // Detect circular dependencies
+        const cycle = this.detectCycle(depGraph);
+        if (cycle) {
+            errors.push(`Circular dependency detected: ${cycle.join(" -> ")}`);
+        }
+        return { depGraph, providesMap, errors };
+    }
+    /**
+     * Topological sort — returns batches of recipes that can run in parallel.
+     */
+    topologicalSort(depGraph) {
+        const batches = [];
+        const resolved = new Set();
+        const remaining = new Set(depGraph.keys());
+        while (remaining.size > 0) {
+            const batch = [];
+            for (const name of remaining) {
+                const deps = depGraph.get(name);
+                const allDepsResolved = [...deps].every((d) => resolved.has(d));
+                if (allDepsResolved) {
+                    batch.push(name);
+                }
+            }
+            if (batch.length === 0) {
+                // Remaining recipes have unresolvable deps — break to avoid infinite loop
+                debug("Unresolvable dependencies for: %o", [...remaining]);
+                break;
+            }
+            // Sort batch alphabetically for deterministic ordering
+            batch.sort();
+            batches.push(batch);
+            for (const name of batch) {
+                resolved.add(name);
+                remaining.delete(name);
+            }
+        }
+        return batches;
+    }
+    /**
+     * Execute all recipes in a group with dependency resolution.
+     */
+    async executeGroup(group, baseVars, options = {}) {
+        const startTime = Date.now();
+        const recipeResults = [];
+        const accumulatedVars = { ...baseVars };
+        const errors = [];
+        // Load all configs
+        await this.loadGroupConfigs(group);
+        // Build dependency graph
+        const { depGraph, providesMap, errors: graphErrors } = this.buildDependencyGraph(group.recipes);
+        errors.push(...graphErrors);
+        if (graphErrors.length > 0) {
+            return {
+                success: false,
+                recipeResults,
+                providedValues: {},
+                duration: Date.now() - startTime,
+                errors,
+                externalParams: [],
+            };
+        }
+        // Compute external params (required by group but not provided by any sibling)
+        const externalParams = this.computeExternalParams(group.recipes, providesMap);
+        // Topological sort
+        const batches = this.topologicalSort(depGraph);
+        debug("Execution batches: %o", batches);
+        // Create a lookup map
+        const recipeMap = new Map(group.recipes.map((r) => [r.name, r]));
+        // Execute batches
+        for (const batch of batches) {
+            debug("Executing batch: %o", batch);
+            // Within a batch, recipes are independent — run them in parallel
+            const batchPromises = batch.map(async (recipeName) => {
+                const entry = recipeMap.get(recipeName);
+                try {
+                    const result = await this.recipeEngine.executeRecipe({ type: "file", path: entry.recipeYmlPath }, {
+                        ...options,
+                        variables: { ...accumulatedVars, ...options.variables },
+                    });
+                    // Collect provided values
+                    if (result.metadata.providedValues) {
+                        Object.assign(accumulatedVars, result.metadata.providedValues);
+                    }
+                    return { name: recipeName, result };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    errors.push(`Recipe '${recipeName}' failed: ${errorMsg}`);
+                    return {
+                        name: recipeName,
+                        result: {
+                            executionId: "",
+                            recipe: entry.config,
+                            success: false,
+                            stepResults: [],
+                            duration: 0,
+                            filesCreated: [],
+                            filesModified: [],
+                            filesDeleted: [],
+                            errors: [errorMsg],
+                            warnings: [],
+                            variables: accumulatedVars,
+                            metadata: {
+                                startTime: new Date(),
+                                endTime: new Date(),
+                                workingDir: options.workingDir || process.cwd(),
+                                totalSteps: 0,
+                                completedSteps: 0,
+                                failedSteps: 0,
+                                skippedSteps: 0,
+                            },
+                        },
+                    };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            recipeResults.push(...batchResults);
+            // Check for failures
+            const failures = batchResults.filter((r) => !r.result.success);
+            if (failures.length > 0 && !options.continueOnError) {
+                debug("Batch had failures, stopping: %o", failures.map((f) => f.name));
+                break;
+            }
+        }
+        return {
+            success: errors.length === 0 && recipeResults.every((r) => r.result.success),
+            recipeResults,
+            providedValues: accumulatedVars,
+            duration: Date.now() - startTime,
+            errors,
+            externalParams,
+        };
+    }
+    /**
+     * Compute parameters required by the group but not provided by any sibling.
+     * These must come from CLI args or user prompts.
+     */
+    computeExternalParams(recipes, providesMap) {
+        const allRequired = new Set();
+        for (const entry of recipes) {
+            if (!entry.config?.variables)
+                continue;
+            for (const [varName, varDef] of Object.entries(entry.config.variables)) {
+                if (varDef.required && varDef.default === undefined) {
+                    allRequired.add(varName);
+                }
+            }
+        }
+        // Remove those that are provided by siblings
+        for (const provided of providesMap.keys()) {
+            allRequired.delete(provided);
+        }
+        return [...allRequired];
+    }
+    /**
+     * Detect circular dependencies via DFS.
+     * Returns the cycle path if found, null otherwise.
+     */
+    detectCycle(depGraph) {
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (node, path) => {
+            if (visiting.has(node)) {
+                return [...path, node];
+            }
+            if (visited.has(node))
+                return null;
+            visiting.add(node);
+            const deps = depGraph.get(node);
+            if (deps) {
+                for (const dep of deps) {
+                    const cycle = visit(dep, [...path, node]);
+                    if (cycle)
+                        return cycle;
+                }
+            }
+            visiting.delete(node);
+            visited.add(node);
+            return null;
+        };
+        for (const node of depGraph.keys()) {
+            const cycle = visit(node, []);
+            if (cycle)
+                return cycle;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=group-executor.js.map

package/dist/recipe-engine/group-executor.js.map

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

package/dist/recipe-engine/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Recipe Engine - Complete Recipe Step System
+ *
+ * Central export point for the entire Recipe Step System including:
+ * - Recipe Engine (main orchestrator and entry point)
+ * - Step Executor (orchestration engine)
+ * - Tool Framework (template, action, codemod, recipe tools)
+ * - Type System (comprehensive TypeScript definitions)
+ * - Registry System (tool management)
+ */
+export { RecipeEngine, createRecipeEngine, executeRecipe, loadRecipe, validateRecipe, type RecipeSource, type RecipeExecutionOptions, type RecipeExecutionResult, type RecipeLoadResult, } from "./recipe-engine.js";
+export { StepExecutor, type StepExecutorConfig, type StepExecutionMetrics, type StepExecutionProgress, } from "./step-executor.js";
+export * from "./tools/index.js";
+export * from "./types.js";
+export { isTemplateStep, isActionStep, isCodeModStep, isRecipeStep, isAIStep, isInstallStep, isQueryStep, isPatchStep, isEnsureDirsStep, StepExecutionError, RecipeDependencyError, CircularDependencyError, } from "./types.js";
+export declare const RECIPE_ENGINE_VERSION = "8.0.0";
+/**
+ * Supported recipe features in this version
+ */
+export declare const RECIPE_ENGINE_FEATURES: readonly ["step-orchestration", "dependency-management", "parallel-execution", "conditional-logic", "error-handling", "progress-tracking", "metrics-collection", "tool-registry", "action-pipelines", "codemod-transformations", "sub-recipe-execution"];
+export type RecipeEngineFeature = (typeof RECIPE_ENGINE_FEATURES)[number];
+/**
+ * Recipe Engine initialization configuration
+ */
+export interface RecipeEngineConfig {
+    /** Step executor configuration */
+    stepExecutor?: Partial<import("./step-executor.js").StepExecutorConfig>;
+    /** Enable debug logging */
+    enableDebugLogging?: boolean;
+    /** Features to enable (all enabled by default) */
+    enabledFeatures?: RecipeEngineFeature[];
+}
+/**
+ * Initialize the Recipe Engine with all components
+ *
+ * This is the main entry point for setting up the complete Recipe Step System.
+ * Call this once during application startup to configure all components.
+ */
+export declare function initializeRecipeEngine(config?: RecipeEngineConfig): {
+    stepExecutor: import("./step-executor.js").StepExecutor;
+    toolRegistry: import("./tools/registry.js").ToolRegistry;
+    version: string;
+    features: readonly RecipeEngineFeature[];
+};
+/**
+ * Quick setup for common Recipe Engine use cases
+ */
+export declare const RecipeEnginePresets: {
+    /**
+     * Development preset - optimized for fast feedback
+     */
+    readonly development: () => RecipeEngineConfig;
+    /**
+     * Production preset - optimized for reliability and performance
+     */
+    readonly production: () => RecipeEngineConfig;
+    /**
+     * Testing preset - optimized for test isolation and debugging
+     */
+    readonly testing: () => RecipeEngineConfig;
+    /**
+     * High performance preset - optimized for speed
+     */
+    readonly performance: () => RecipeEngineConfig;
+};
+/**
+ * Recipe Engine health check utility
+ */
+export declare function checkRecipeEngineHealth(): {
+    healthy: boolean;
+    version: string;
+    issues: string[];
+    components: {
+        stepExecutor: boolean;
+        toolRegistry: boolean;
+    };
+    toolRegistryHealth: ReturnType<typeof import("./tools/index.js").checkRegistryHealth>;
+};
+/**
+ * Development utilities for Recipe Engine
+ */
+export declare const RecipeEngineDevUtils: {
+    /**
+     * Create a minimal step executor for testing
+     */
+    readonly createTestStepExecutor: (config?: Partial<import("./step-executor.js").StepExecutorConfig>) => any;
+    /**
+     * Reset all Recipe Engine components for testing
+     */
+    readonly resetForTesting: () => void;
+    /**
+     * Get comprehensive debug information
+     */
+    readonly getDebugInfo: () => {
+        engine: {
+            version: string;
+            features: readonly ["step-orchestration", "dependency-management", "parallel-execution", "conditional-logic", "error-handling", "progress-tracking", "metrics-collection", "tool-registry", "action-pipelines", "codemod-transformations", "sub-recipe-execution"];
+            health: {
+                healthy: boolean;
+                version: string;
+                issues: string[];
+                components: {
+                    stepExecutor: boolean;
+                    toolRegistry: boolean;
+                };
+                toolRegistryHealth: ReturnType<typeof import("./tools/index.js").checkRegistryHealth>;
+            };
+        };
+        toolFramework: any;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/recipe-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recipe-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACN,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,YAAY,CAAC;AAG3B,OAAO,EACN,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GACvB,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,0PAYzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IAExE,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,kDAAkD;IAClD,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,kBAAuB,GAAG;IACxE,YAAY,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;IACxD,YAAY,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzC,CA0BA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC/B;;OAEG;gCACc,kBAAkB;IAWnC;;OAEG;+BACa,kBAAkB;IAWlC;;OAEG;4BACU,kBAAkB;IAW/B;;OAEG;gCACc,kBAAkB;CAU1B,CAAC;AAEX;;GAEG;AACH,wBAAgB,uBAAuB,IAAI;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE;QACX,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,kBAAkB,EAAE,UAAU,CAAC,cAAc,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;CACtF,CA4DA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAChC;;OAEG;+CAEM,OAAO,CAAC,OAAO,oBAAoB,EAAE,kBAAkB,CAAC;IAYjE;;OAEG;;IAMH;;OAEG;;;;;;yBApGM,OAAO;yBACP,MAAM;wBACP,MAAM,EAAE;4BACJ;oBACX,YAAY,EAAE,OAAO,CAAC;oBACtB,YAAY,EAAE,OAAO,CAAC;iBACtB;oCACmB,UAAU,CAAC,cAAc,kBAAkB,EAAE,mBAAmB,CAAC;;;;;CA4G5E,CAAC"}