@orbytautomation/engine 0.1.0

package/dist/hooks/HookManager.js

@@ -0,0 +1,187 @@
+/**
+ * HookManager - Manages and executes lifecycle hooks
+ *
+ * Responsibilities:
+ * - Register user-defined hooks
+ * - Execute hooks at appropriate lifecycle moments
+ * - Handle hook errors gracefully
+ * - Maintain hook execution order
+ *
+ * Design principles:
+ * - Hooks run sequentially (not parallel) for predictability
+ * - Hook errors are isolated - one failing hook doesn't break the workflow
+ * - Hooks can be async (awaited)
+ * - Hook failures are logged but don't stop execution (unless configured)
+ *
+ * @example
+ * ```ts
+ * const manager = new HookManager();
+ *
+ * manager.register({
+ *   async afterStep(ctx) {
+ *     console.log('Step done:', ctx.stepName);
+ *   }
+ * });
+ *
+ * await manager.run('afterStep', stepContext);
+ * ```
+ */
+export class HookManager {
+    hooks = [];
+    failOnHookError = false;
+    constructor(options) {
+        this.failOnHookError = options?.failOnHookError ?? false;
+    }
+    /**
+     * Register a lifecycle hook
+     *
+     * @param hook - The hook implementation
+     */
+    register(hook) {
+        this.hooks.push(hook);
+    }
+    /**
+     * Register multiple hooks at once
+     *
+     * @param hooks - Array of hook implementations
+     */
+    registerMany(hooks) {
+        this.hooks.push(...hooks);
+    }
+    /**
+     * Remove a specific hook
+     *
+     * @param hook - The hook to remove
+     */
+    unregister(hook) {
+        const index = this.hooks.indexOf(hook);
+        if (index !== -1) {
+            this.hooks.splice(index, 1);
+        }
+    }
+    /**
+     * Clear all registered hooks
+     */
+    clear() {
+        this.hooks = [];
+    }
+    /**
+     * Execute a specific hook type for all registered hooks
+     *
+     * @param type - The hook method name to execute
+     * @param ctx - Context to pass to the hook
+     * @param error - Optional error (for onError hook)
+     * @returns Array of hook results
+     */
+    async run(type, ctx, error) {
+        const results = [];
+        for (const hook of this.hooks) {
+            const hookFn = hook[type];
+            if (!hookFn) {
+                continue;
+            }
+            try {
+                // Execute hook with appropriate arguments
+                if (type === 'onError') {
+                    await hookFn(ctx, error);
+                }
+                else if (type === 'onRetry' && 'attempt' in ctx) {
+                    const stepCtx = ctx;
+                    await hookFn(ctx, stepCtx.attempt, 3); // TODO: get maxAttempts from config
+                }
+                else {
+                    await hookFn(ctx);
+                }
+                results.push({ success: true });
+            }
+            catch (err) {
+                const hookError = err instanceof Error ? err : new Error(String(err));
+                results.push({
+                    success: false,
+                    error: hookError,
+                    hookName: hook.constructor?.name || 'AnonymousHook',
+                });
+                console.error(`[HookManager] Hook '${type}' failed:`, hookError);
+                // If configured to fail on hook errors, rethrow
+                if (this.failOnHookError) {
+                    throw new Error(`Hook '${type}' failed: ${hookError.message}`, { cause: hookError });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute beforeWorkflow hooks
+     */
+    async runBeforeWorkflow(ctx) {
+        return this.run('beforeWorkflow', ctx);
+    }
+    /**
+     * Execute afterWorkflow hooks
+     */
+    async runAfterWorkflow(ctx) {
+        return this.run('afterWorkflow', ctx);
+    }
+    /**
+     * Execute beforeStep hooks
+     */
+    async runBeforeStep(ctx) {
+        return this.run('beforeStep', ctx);
+    }
+    /**
+     * Execute afterStep hooks
+     */
+    async runAfterStep(ctx) {
+        return this.run('afterStep', ctx);
+    }
+    /**
+     * Execute onError hooks
+     */
+    async runOnError(ctx, error) {
+        return this.run('onError', ctx, error);
+    }
+    /**
+     * Execute onRetry hooks
+     */
+    async runOnRetry(ctx) {
+        return this.run('onRetry', ctx);
+    }
+    /**
+     * Execute onPause hooks
+     */
+    async runOnPause(ctx) {
+        return this.run('onPause', ctx);
+    }
+    /**
+     * Execute onResume hooks
+     */
+    async runOnResume(ctx) {
+        return this.run('onResume', ctx);
+    }
+    /**
+     * Get count of registered hooks
+     */
+    count() {
+        return this.hooks.length;
+    }
+    /**
+     * Check if any hooks are registered
+     */
+    hasHooks() {
+        return this.hooks.length > 0;
+    }
+    /**
+     * Get list of hook types that have implementations
+     *
+     * @returns Array of hook type names that are implemented
+     */
+    getImplementedHooks() {
+        const implemented = new Set();
+        for (const hook of this.hooks) {
+            const keys = Object.keys(hook);
+            keys.forEach((key) => implemented.add(key));
+        }
+        return Array.from(implemented);
+    }
+}
+//# sourceMappingURL=HookManager.js.map

package/dist/hooks/HookManager.js.map

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

package/dist/hooks/LifecycleHooks.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Lifecycle Hooks - User-level extensibility points
+ *
+ * While EventBus is for engine-internal communication and observability,
+ * hooks provide user-facing extensibility to inject custom logic into
+ * the workflow execution lifecycle.
+ *
+ * Difference between Events and Hooks:
+ *
+ * Events (Engine-level):
+ * - Emitted by engine components
+ * - For observability, logging, metrics
+ * - Multiple independent listeners
+ * - Fire-and-forget
+ *
+ * Hooks (User-level):
+ * - Registered by users/plugins
+ * - For extending behavior
+ * - Sequential execution
+ * - Can modify context or interrupt flow
+ */
+/**
+ * Context passed to workflow-level hooks
+ */
+export interface WorkflowHookContext {
+    workflowId: string;
+    workflowName: string;
+    runId: string;
+    triggeredBy?: string;
+    inputs?: Record<string, any>;
+    env?: Record<string, string>;
+    metadata?: Record<string, any>;
+    startTime: number;
+}
+/**
+ * Context passed to step-level hooks
+ */
+export interface StepHookContext {
+    workflowId: string;
+    workflowName: string;
+    runId: string;
+    stepId: string;
+    stepName: string;
+    adapterType: string;
+    attempt: number;
+    inputs?: Record<string, any>;
+    outputs?: Record<string, any>;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+}
+/**
+ * Lifecycle hook interface
+ *
+ * All methods are optional - implement only what you need.
+ * All methods are async to support I/O operations.
+ *
+ * @example
+ * ```ts
+ * const loggingHook: LifecycleHook = {
+ *   async afterStep(ctx) {
+ *     console.log(`Step ${ctx.stepName} completed`);
+ *   }
+ * };
+ *
+ * const notificationHook: LifecycleHook = {
+ *   async afterWorkflow(ctx) {
+ *     await sendSlackMessage(`Workflow ${ctx.workflowName} done!`);
+ *   },
+ *   async onError(ctx, error) {
+ *     await sendAlert(`Workflow failed: ${error.message}`);
+ *   }
+ * };
+ * ```
+ */
+export interface LifecycleHook {
+    /**
+     * Called before workflow execution begins
+     * Use for: validation, setup, initialization
+     */
+    beforeWorkflow?(ctx: WorkflowHookContext): Promise<void> | void;
+    /**
+     * Called after workflow completes successfully
+     * Use for: cleanup, notifications, reporting
+     */
+    afterWorkflow?(ctx: WorkflowHookContext): Promise<void> | void;
+    /**
+     * Called before each step executes
+     * Use for: logging, metrics, preparation
+     */
+    beforeStep?(ctx: StepHookContext): Promise<void> | void;
+    /**
+     * Called after each step completes successfully
+     * Use for: logging, metrics, validation
+     */
+    afterStep?(ctx: StepHookContext): Promise<void> | void;
+    /**
+     * Called when a workflow or step fails
+     * Use for: error handling, alerts, recovery
+     */
+    onError?(ctx: WorkflowHookContext | StepHookContext, error: Error): Promise<void> | void;
+    /**
+     * Called when a step is retrying
+     * Use for: logging retry attempts, backoff notifications
+     */
+    onRetry?(ctx: StepHookContext, attempt: number, maxAttempts: number): Promise<void> | void;
+    /**
+     * Called when a workflow is paused
+     * Use for: state persistence, notifications
+     */
+    onPause?(ctx: WorkflowHookContext): Promise<void> | void;
+    /**
+     * Called when a workflow is resumed
+     * Use for: state restoration, notifications
+     */
+    onResume?(ctx: WorkflowHookContext): Promise<void> | void;
+}
+/**
+ * Hook execution result
+ */
+export interface HookResult {
+    success: boolean;
+    error?: Error;
+    hookName?: string;
+}
+//# sourceMappingURL=LifecycleHooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleHooks.d.ts","sourceRoot":"","sources":["../../src/hooks/LifecycleHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,cAAc,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhE;;;OAGG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE/D;;;OAGG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExD;;;OAGG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvD;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzF;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE3F;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzD;;;OAGG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/hooks/LifecycleHooks.js

@@ -0,0 +1,23 @@
+/**
+ * Lifecycle Hooks - User-level extensibility points
+ *
+ * While EventBus is for engine-internal communication and observability,
+ * hooks provide user-facing extensibility to inject custom logic into
+ * the workflow execution lifecycle.
+ *
+ * Difference between Events and Hooks:
+ *
+ * Events (Engine-level):
+ * - Emitted by engine components
+ * - For observability, logging, metrics
+ * - Multiple independent listeners
+ * - Fire-and-forget
+ *
+ * Hooks (User-level):
+ * - Registered by users/plugins
+ * - For extending behavior
+ * - Sequential execution
+ * - Can modify context or interrupt flow
+ */
+export {};
+//# sourceMappingURL=LifecycleHooks.js.map

package/dist/hooks/LifecycleHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleHooks.js","sourceRoot":"","sources":["../../src/hooks/LifecycleHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './HookManager.js';
+export * from './LifecycleHooks.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,3 @@
+export * from './HookManager.js';
+export * from './LifecycleHooks.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Orbyt Engine - Universal Workflow Automation
+ *
+ * @example
+ * ```ts
+ * import { OrbytEngine } from '@orbytautomation/engine';
+ *
+ * const engine = new OrbytEngine();
+ * const result = await engine.run('./workflow.yaml');
+ * ```
+ */
+export { OrbytEngine } from './core/OrbytEngine.js';
+export type { WorkflowRunOptions, WorkflowLoadOptions } from './core/OrbytEngine.js';
+export type { OrbytEngineConfig, LogLevel, ExecutionMode } from './core/EngineConfig.js';
+export type { WorkflowResult, ExecutionOptions } from './execution/WorkflowExecutor.js';
+export type { ParsedWorkflow } from './parser/WorkflowParser.js';
+export type { EngineContext } from './core/EngineContext.js';
+export * from './adapters/index.js';
+export * from './events/index.js';
+export * from './hooks/index.js';
+export type { StepResult } from './execution/StepExecutor.js';
+export type { ExecutionPlan } from './execution/ExecutionPlan.js';
+export * from './parser/index.js';
+export * from './state/index.js';
+export * from './context/index.js';
+export * from './automation/index.js';
+export * from './queue/index.js';
+export * from './scheduling/index.js';
+export * from './errors/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,aAAa,EACd,MAAM,yBAAyB,CAAC;AAOjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * Orbyt Engine - Universal Workflow Automation
+ *
+ * @example
+ * ```ts
+ * import { OrbytEngine } from '@orbytautomation/engine';
+ *
+ * const engine = new OrbytEngine();
+ * const result = await engine.run('./workflow.yaml');
+ * ```
+ */
+// ============================================================================
+// PRIMARY EXPORT - Start here!
+// ============================================================================
+export { OrbytEngine } from './core/OrbytEngine.js';
+// ============================================================================
+// ADVANCED - For power users and adapter developers
+// ============================================================================
+// Adapters
+export * from './adapters/index.js';
+// Events
+export * from './events/index.js';
+// Hooks
+export * from './hooks/index.js';
+// Parser (for validation and custom tooling)
+export * from './parser/index.js';
+// State management
+export * from './state/index.js';
+// Context utilities
+export * from './context/index.js';
+// Automation policies
+export * from './automation/index.js';
+// Queue and scheduling (for distributed setups)
+export * from './queue/index.js';
+export * from './scheduling/index.js';
+// Errors (for error handling)
+export * from './errors/index.js';
+// export * from './workflow/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA8BpD,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAMjC,6CAA6C;AAC7C,cAAc,mBAAmB,CAAC;AAElC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,sBAAsB;AACtB,cAAc,uBAAuB,CAAC;AAEtC,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAElC,uCAAuC"}

package/dist/lifecycle/EngineLifecycle.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Engine Lifecycle Manager
+ *
+ * Manages engine startup, runtime, and shutdown phases.
+ * Coordinates initialization and cleanup of all engine components.
+ *
+ * @module lifecycle
+ */
+/**
+ * Engine lifecycle state
+ */
+export declare enum EngineState {
+    STOPPED = "stopped",
+    STARTING = "starting",
+    RUNNING = "running",
+    STOPPING = "stopping",
+    ERROR = "error"
+}
+/**
+ * Lifecycle event
+ */
+export interface LifecycleEvent {
+    state: EngineState;
+    timestamp: Date;
+    details?: string;
+    error?: Error;
+}
+/**
+ * Lifecycle event listener
+ */
+export type LifecycleListener = (event: LifecycleEvent) => void;
+/**
+ * Component that requires lifecycle management
+ */
+export interface LifecycleComponent {
+    name: string;
+    /**
+     * Initialize component
+     */
+    start?(): Promise<void>;
+    /**
+     * Cleanup component
+     */
+    stop?(): Promise<void>;
+}
+/**
+ * Engine lifecycle manager
+ */
+export declare class EngineLifecycle {
+    private state;
+    private components;
+    private listeners;
+    private stateHistory;
+    /**
+     * Register a lifecycle component
+     *
+     * @param component - Component to register
+     */
+    registerComponent(component: LifecycleComponent): void;
+    /**
+     * Register multiple components
+     *
+     * @param components - Components to register
+     */
+    registerComponents(components: LifecycleComponent[]): void;
+    /**
+     * Add state change listener
+     *
+     * @param listener - Listener function
+     */
+    on(listener: LifecycleListener): void;
+    /**
+     * Remove state change listener
+     *
+     * @param listener - Listener to remove
+     */
+    off(listener: LifecycleListener): void;
+    /**
+     * Start the engine
+     *
+     * Initializes all registered components in order.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the engine
+     *
+     * Cleanly shuts down all components in reverse order.
+     */
+    stop(): Promise<void>;
+    /**
+     * Graceful shutdown with timeout
+     *
+     * @param timeoutMs - Maximum time to wait for shutdown
+     */
+    gracefulShutdown(timeoutMs?: number): Promise<void>;
+    /**
+     * Get current engine state
+     */
+    getState(): EngineState;
+    /**
+     * Check if engine is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get state history
+     */
+    getHistory(): LifecycleEvent[];
+    /**
+     * Get registered components
+     */
+    getComponents(): LifecycleComponent[];
+    /**
+     * Set engine state and notify listeners
+     */
+    private setState;
+    /**
+     * Emit log message to console
+     */
+    private emit;
+}
+//# sourceMappingURL=EngineLifecycle.d.ts.map

package/dist/lifecycle/EngineLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineLifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle/EngineLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,YAAY,CAAwB;IAE5C;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAUtD;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAM1D;;;;OAIG;IACH,EAAE,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIrC;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAOtC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC3B;;;;OAIG;IACG,gBAAgB,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhE;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,UAAU,IAAI,cAAc,EAAE;IAI9B;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAIrC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAyBhB;;OAEG;IACH,OAAO,CAAC,IAAI;CAIb"}