steroids-cli 0.4.47

package/dist/hooks/integration.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Hook Integration
+ *
+ * Helper functions to trigger hooks from CLI commands.
+ * Loads and merges global/project hooks, then executes them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.triggerTaskCreated = triggerTaskCreated;
+exports.triggerTaskUpdated = triggerTaskUpdated;
+exports.triggerTaskCompleted = triggerTaskCompleted;
+exports.triggerTaskFailed = triggerTaskFailed;
+exports.triggerSectionCompleted = triggerSectionCompleted;
+exports.triggerProjectCompleted = triggerProjectCompleted;
+exports.shouldSkipHooks = shouldSkipHooks;
+exports.triggerHooksSafely = triggerHooksSafely;
+const node_path_1 = require("node:path");
+const loader_js_1 = require("../config/loader.js");
+const merge_js_1 = require("./merge.js");
+const orchestrator_js_1 = require("./orchestrator.js");
+const payload_js_1 = require("./payload.js");
+/**
+ * Load and merge hooks from global and project configs
+ */
+async function loadHooks(projectPath) {
+    const globalConfigPath = (0, loader_js_1.getGlobalConfigPath)();
+    const projectConfigPath = (0, loader_js_1.getProjectConfigPath)(projectPath);
+    let globalHooks = [];
+    let projectHooks = [];
+    try {
+        const globalConfig = (0, loader_js_1.loadConfigFile)(globalConfigPath);
+        globalHooks = globalConfig.hooks || [];
+    }
+    catch {
+        // Global config might not exist
+    }
+    try {
+        const projectConfig = (0, loader_js_1.loadConfigFile)(projectConfigPath);
+        projectHooks = projectConfig.hooks || [];
+    }
+    catch {
+        // Project config might not exist
+    }
+    return (0, merge_js_1.mergeHooks)(globalHooks, projectHooks);
+}
+/**
+ * Get project context for current directory
+ */
+function getProjectContext(projectPath) {
+    const path = projectPath || process.cwd();
+    return {
+        name: (0, node_path_1.basename)(path),
+        path,
+    };
+}
+/**
+ * Convert database task to payload task data
+ */
+function taskToPayloadData(task) {
+    return {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+        section: null, // Task interface doesn't have section_name
+        sectionId: task.section_id || null,
+        sourceFile: task.source_file || null,
+        rejectionCount: task.rejection_count || 0,
+    };
+}
+/**
+ * Execute hooks for an event
+ */
+async function executeHooks(event, payload, options = {}) {
+    const hooks = await loadHooks(payload.project.path);
+    const orchestrator = new orchestrator_js_1.HookOrchestrator(hooks, {
+        verbose: options.verbose ?? false,
+        continueOnError: options.continueOnError ?? true,
+    });
+    return await orchestrator.executeHooksForEvent(event, payload);
+}
+/**
+ * Trigger task.created hooks
+ */
+async function triggerTaskCreated(task, options = {}) {
+    const project = getProjectContext(options.projectPath);
+    const taskData = taskToPayloadData(task);
+    const payload = (0, payload_js_1.createTaskCreatedPayload)(taskData, project);
+    return await executeHooks('task.created', payload, options);
+}
+/**
+ * Trigger task.updated hooks
+ */
+async function triggerTaskUpdated(task, previousStatus, options = {}) {
+    const project = getProjectContext(options.projectPath);
+    const taskData = taskToPayloadData(task);
+    if (previousStatus) {
+        taskData.previousStatus = previousStatus;
+    }
+    const payload = (0, payload_js_1.createTaskUpdatedPayload)(taskData, project);
+    return await executeHooks('task.updated', payload, options);
+}
+/**
+ * Trigger task.completed hooks
+ */
+async function triggerTaskCompleted(task, options = {}) {
+    const project = getProjectContext(options.projectPath);
+    const taskData = taskToPayloadData(task);
+    const payload = (0, payload_js_1.createTaskCompletedPayload)(taskData, project);
+    return await executeHooks('task.completed', payload, options);
+}
+/**
+ * Trigger task.failed hooks
+ */
+async function triggerTaskFailed(task, maxRejections, options = {}) {
+    const project = getProjectContext(options.projectPath);
+    const taskData = taskToPayloadData(task);
+    const payload = (0, payload_js_1.createTaskFailedPayload)(taskData, project, maxRejections);
+    return await executeHooks('task.failed', payload, options);
+}
+/**
+ * Trigger section.completed hooks
+ */
+async function triggerSectionCompleted(section, tasks, options = {}) {
+    const project = getProjectContext(options.projectPath);
+    const payload = (0, payload_js_1.createSectionCompletedPayload)(section, tasks, project);
+    return await executeHooks('section.completed', payload, options);
+}
+/**
+ * Trigger project.completed hooks
+ */
+async function triggerProjectCompleted(summary, options = {}) {
+    const project = getProjectContext(options.projectPath);
+    const payload = (0, payload_js_1.createProjectCompletedPayload)(project, summary);
+    return await executeHooks('project.completed', payload, options);
+}
+/**
+ * Check if hooks should be skipped
+ *
+ * Checks environment variable and CLI flags
+ */
+function shouldSkipHooks(flags) {
+    // Check flag
+    if (flags?.noHooks) {
+        return true;
+    }
+    // Check environment variable
+    const envVar = process.env.STEROIDS_NO_HOOKS;
+    if (envVar && (envVar === '1' || envVar.toLowerCase() === 'true')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Silently trigger hooks (don't throw on failure)
+ *
+ * Logs errors but doesn't block the main operation
+ */
+async function triggerHooksSafely(triggerFn, options = {}) {
+    try {
+        const results = await triggerFn();
+        // Log failures if verbose
+        if (options.verbose) {
+            const failed = results.filter((r) => !r.success);
+            if (failed.length > 0) {
+                console.error(`Warning: ${failed.length} hook(s) failed:`);
+                for (const result of failed) {
+                    console.error(`  - ${result.hookName}: ${result.error}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Silently fail - don't block main operation
+        if (options.verbose) {
+            console.error(`Warning: Hook execution failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=integration.js.map

package/dist/hooks/integration.js.map

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

package/dist/hooks/merge.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Hook Configuration Merge
+ *
+ * Merges global hooks (~/.steroids/config.yaml) with project hooks (.steroids/config.yaml).
+ * Project hooks can override global hooks by name or disable them with enabled: false.
+ */
+import type { HookEvent } from './events.js';
+import type { ScriptHookConfig } from './script-runner.js';
+import type { WebhookHookConfig } from './webhook-runner.js';
+/**
+ * Hook type discriminator
+ */
+export type HookType = 'script' | 'webhook';
+/**
+ * Base hook configuration (common fields)
+ */
+export interface BaseHookConfig {
+    /** Unique hook name */
+    name: string;
+    /** Event that triggers this hook */
+    event: HookEvent;
+    /** Hook type */
+    type: HookType;
+    /** Enable/disable this hook */
+    enabled?: boolean;
+}
+/**
+ * Script hook configuration (from config.yaml)
+ */
+export interface ScriptHookYaml extends BaseHookConfig {
+    type: 'script';
+    command: string;
+    args?: string[];
+    cwd?: string;
+    timeout?: number | string;
+    async?: boolean;
+}
+/**
+ * Webhook hook configuration (from config.yaml)
+ */
+export interface WebhookHookYaml extends BaseHookConfig {
+    type: 'webhook';
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: Record<string, unknown> | string;
+    timeout?: number | string;
+    retry?: number;
+}
+/**
+ * Union of all hook configurations
+ */
+export type HookConfig = ScriptHookYaml | WebhookHookYaml;
+/**
+ * Merge global and project hooks
+ *
+ * Rules:
+ * 1. Project hooks with same name as global hooks override them completely
+ * 2. Project hooks with enabled: false disable global hooks with same name
+ * 3. All other hooks are included
+ *
+ * @param globalHooks - Hooks from ~/.steroids/config.yaml
+ * @param projectHooks - Hooks from .steroids/config.yaml
+ * @returns Merged list of enabled hooks
+ */
+export declare function mergeHooks(globalHooks?: HookConfig[], projectHooks?: HookConfig[]): HookConfig[];
+/**
+ * Filter hooks by event
+ *
+ * @param hooks - List of hooks
+ * @param event - Event name to filter by
+ * @returns Hooks matching the event
+ */
+export declare function filterHooksByEvent(hooks: HookConfig[], event: HookEvent): HookConfig[];
+/**
+ * Find hook by name
+ *
+ * @param hooks - List of hooks
+ * @param name - Hook name
+ * @returns Hook if found, undefined otherwise
+ */
+export declare function findHookByName(hooks: HookConfig[], name: string): HookConfig | undefined;
+/**
+ * Validate hook configuration
+ *
+ * @param hook - Hook configuration
+ * @returns Validation result with errors
+ */
+export declare function validateHook(hook: HookConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Convert script hook config from YAML format to runner format
+ */
+export declare function toScriptRunnerConfig(hook: ScriptHookYaml): ScriptHookConfig;
+/**
+ * Convert webhook hook config from YAML format to runner format
+ */
+export declare function toWebhookRunnerConfig(hook: WebhookHookYaml): WebhookHookConfig;
+/**
+ * Group hooks by event
+ *
+ * @param hooks - List of hooks
+ * @returns Map of event -> hooks
+ */
+export declare function groupHooksByEvent(hooks: HookConfig[]): Map<HookEvent, HookConfig[]>;
+/**
+ * Get all unique events that have hooks registered
+ *
+ * @param hooks - List of hooks
+ * @returns Array of unique event names
+ */
+export declare function getEventsWithHooks(hooks: HookConfig[]): HookEvent[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/hooks/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/hooks/merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,WAAW,GAAE,UAAU,EAAO,EAC9B,YAAY,GAAE,UAAU,EAAO,GAC9B,UAAU,EAAE,CAsBd;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,EAAE,CAEtF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA+BnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAS3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAYnF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,CAUnE"}

package/dist/hooks/merge.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Hook Configuration Merge
+ *
+ * Merges global hooks (~/.steroids/config.yaml) with project hooks (.steroids/config.yaml).
+ * Project hooks can override global hooks by name or disable them with enabled: false.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeHooks = mergeHooks;
+exports.filterHooksByEvent = filterHooksByEvent;
+exports.findHookByName = findHookByName;
+exports.validateHook = validateHook;
+exports.toScriptRunnerConfig = toScriptRunnerConfig;
+exports.toWebhookRunnerConfig = toWebhookRunnerConfig;
+exports.groupHooksByEvent = groupHooksByEvent;
+exports.getEventsWithHooks = getEventsWithHooks;
+/**
+ * Merge global and project hooks
+ *
+ * Rules:
+ * 1. Project hooks with same name as global hooks override them completely
+ * 2. Project hooks with enabled: false disable global hooks with same name
+ * 3. All other hooks are included
+ *
+ * @param globalHooks - Hooks from ~/.steroids/config.yaml
+ * @param projectHooks - Hooks from .steroids/config.yaml
+ * @returns Merged list of enabled hooks
+ */
+function mergeHooks(globalHooks = [], projectHooks = []) {
+    const merged = new Map();
+    // Add all global hooks first
+    for (const hook of globalHooks) {
+        if (hook.enabled !== false) {
+            merged.set(hook.name, hook);
+        }
+    }
+    // Process project hooks
+    for (const hook of projectHooks) {
+        if (hook.enabled === false) {
+            // Explicitly disabled - remove from merged
+            merged.delete(hook.name);
+        }
+        else {
+            // Override global hook with same name, or add new hook
+            merged.set(hook.name, hook);
+        }
+    }
+    return Array.from(merged.values());
+}
+/**
+ * Filter hooks by event
+ *
+ * @param hooks - List of hooks
+ * @param event - Event name to filter by
+ * @returns Hooks matching the event
+ */
+function filterHooksByEvent(hooks, event) {
+    return hooks.filter((hook) => hook.event === event && hook.enabled !== false);
+}
+/**
+ * Find hook by name
+ *
+ * @param hooks - List of hooks
+ * @param name - Hook name
+ * @returns Hook if found, undefined otherwise
+ */
+function findHookByName(hooks, name) {
+    return hooks.find((hook) => hook.name === name);
+}
+/**
+ * Validate hook configuration
+ *
+ * @param hook - Hook configuration
+ * @returns Validation result with errors
+ */
+function validateHook(hook) {
+    const errors = [];
+    if (!hook.name) {
+        errors.push('Missing required field: name');
+    }
+    if (!hook.event) {
+        errors.push('Missing required field: event');
+    }
+    if (!hook.type) {
+        errors.push('Missing required field: type');
+    }
+    if (hook.type === 'script') {
+        if (!hook.command) {
+            errors.push('Missing required field for script hook: command');
+        }
+    }
+    if (hook.type === 'webhook') {
+        if (!hook.url) {
+            errors.push('Missing required field for webhook hook: url');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Convert script hook config from YAML format to runner format
+ */
+function toScriptRunnerConfig(hook) {
+    return {
+        name: hook.name,
+        command: hook.command,
+        args: hook.args,
+        cwd: hook.cwd,
+        timeout: hook.timeout,
+        async: hook.async,
+    };
+}
+/**
+ * Convert webhook hook config from YAML format to runner format
+ */
+function toWebhookRunnerConfig(hook) {
+    return {
+        name: hook.name,
+        url: hook.url,
+        method: hook.method,
+        headers: hook.headers,
+        body: hook.body,
+        timeout: hook.timeout,
+        retry: hook.retry,
+    };
+}
+/**
+ * Group hooks by event
+ *
+ * @param hooks - List of hooks
+ * @returns Map of event -> hooks
+ */
+function groupHooksByEvent(hooks) {
+    const grouped = new Map();
+    for (const hook of hooks) {
+        if (hook.enabled === false)
+            continue;
+        const existing = grouped.get(hook.event) || [];
+        existing.push(hook);
+        grouped.set(hook.event, existing);
+    }
+    return grouped;
+}
+/**
+ * Get all unique events that have hooks registered
+ *
+ * @param hooks - List of hooks
+ * @returns Array of unique event names
+ */
+function getEventsWithHooks(hooks) {
+    const events = new Set();
+    for (const hook of hooks) {
+        if (hook.enabled !== false) {
+            events.add(hook.event);
+        }
+    }
+    return Array.from(events);
+}
+//# sourceMappingURL=merge.js.map

package/dist/hooks/merge.js.map

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

package/dist/hooks/orchestrator.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Hook Orchestrator
+ *
+ * Coordinates hook execution by:
+ * 1. Loading hooks from config
+ * 2. Matching events to hooks
+ * 3. Executing matching hooks (script or webhook)
+ * 4. Logging execution results
+ * 5. Handling failures gracefully (non-blocking)
+ */
+import type { HookEvent } from './events.js';
+import type { HookPayload } from './payload.js';
+import type { HookConfig } from './merge.js';
+import { type ScriptResult } from './script-runner.js';
+import { type WebhookResult } from './webhook-runner.js';
+/**
+ * Hook execution result
+ */
+export interface HookExecutionResult {
+    /** Hook name */
+    hookName: string;
+    /** Hook type */
+    hookType: 'script' | 'webhook';
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Execution duration in milliseconds */
+    duration: number;
+    /** Error message if failed */
+    error?: string;
+    /** Script-specific result */
+    scriptResult?: ScriptResult;
+    /** Webhook-specific result */
+    webhookResult?: WebhookResult;
+}
+/**
+ * Hook orchestrator configuration
+ */
+export interface OrchestratorConfig {
+    /** Whether to log hook execution details */
+    verbose?: boolean;
+    /** Whether to continue on hook failure (default true) */
+    continueOnError?: boolean;
+}
+/**
+ * Hook Orchestrator
+ *
+ * Manages hook lifecycle and execution
+ */
+export declare class HookOrchestrator {
+    private hooks;
+    private config;
+    constructor(hooks?: HookConfig[], config?: OrchestratorConfig);
+    /**
+     * Load hooks from configuration
+     */
+    setHooks(hooks: HookConfig[]): void;
+    /**
+     * Get all loaded hooks
+     */
+    getHooks(): HookConfig[];
+    /**
+     * Get hooks for a specific event
+     */
+    getHooksForEvent(event: HookEvent): HookConfig[];
+    /**
+     * Execute all hooks for an event
+     *
+     * @param event - Event name
+     * @param payload - Event payload
+     * @returns Array of execution results
+     */
+    executeHooksForEvent(event: HookEvent, payload: HookPayload): Promise<HookExecutionResult[]>;
+    /**
+     * Execute a single hook
+     */
+    private executeHook;
+    /**
+     * Execute a script hook
+     */
+    private executeScriptHook;
+    /**
+     * Execute a webhook hook
+     */
+    private executeWebhookHook;
+    /**
+     * Validate all loaded hooks
+     *
+     * @returns Validation results for each hook
+     */
+    validateAllHooks(): Array<{
+        hook: string;
+        valid: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Get statistics about loaded hooks
+     */
+    getStats(): {
+        total: number;
+        enabled: number;
+        disabled: number;
+        byType: Record<string, number>;
+        byEvent: Record<string, number>;
+    };
+}
+/**
+ * Create a hook orchestrator from global and project hooks
+ *
+ * @param globalHooks - Hooks from ~/.steroids/config.yaml
+ * @param projectHooks - Hooks from .steroids/config.yaml
+ * @param config - Orchestrator configuration
+ * @returns Configured hook orchestrator
+ */
+export declare function createOrchestrator(globalHooks: HookConfig[], projectHooks: HookConfig[], config?: OrchestratorConfig): HookOrchestrator;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/hooks/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/hooks/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAmC,MAAM,YAAY,CAAC;AAO9E,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,8BAA8B;IAC9B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAqB;gBAEvB,KAAK,GAAE,UAAU,EAAO,EAAE,MAAM,GAAE,kBAAuB;IAQrE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAInC;;OAEG;IACH,QAAQ,IAAI,UAAU,EAAE;IAIxB;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,EAAE;IAIhD;;;;;;OAMG;IACG,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4ElG;;OAEG;YACW,WAAW;IAkBzB;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;YACW,kBAAkB;IAiBhC;;;;OAIG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAW7E;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC;CAsBF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,UAAU,EAAE,EACzB,YAAY,EAAE,UAAU,EAAE,EAC1B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,gBAAgB,CAIlB"}