@cleocode/core 2026.3.38 → 2026.3.40

package/dist/hooks/registry.d.ts

@@ -1,111 +0,0 @@
-/**
- * Hook Registry System - Phase 2C of T5237
- *
- * Central registry for managing hook handlers with priority-based execution,
- * async dispatch, and best-effort error handling. Integrates with CAAMP 1.6.0
- * event definitions while providing CLEO's execution engine.
- *
- * @module @cleocode/cleo/hooks/registry
- */
-import type { HookConfig, HookEvent, HookPayload, HookRegistration } from './types.js';
-/**
- * Central registry for hook handlers.
- *
- * Manages registration, priority-based ordering, and async dispatch
- * of hook handlers. Provides best-effort execution where errors in
- * one handler do not block others.
- */
-export declare class HookRegistry {
-    private handlers;
-    private config;
-    /**
-     * Register a hook handler for a specific event.
-     *
-     * Handlers are sorted by priority (highest first) and executed
-     * in parallel when the event is dispatched.
-     *
-     * @param registration - The hook registration containing event, handler, priority, and ID
-     * @returns A function to unregister the handler
-     *
-     * @example
-     * ```typescript
-     * const unregister = hooks.register({
-     *   id: 'my-handler',
-     *   event: 'onSessionStart',
-     *   handler: async (root, payload) => { console.log('Session started'); },
-     *   priority: 100
-     * });
-     *
-     * // Later: unregister()
-     * ```
-     */
-    register<T extends HookPayload>(registration: HookRegistration<T>): () => void;
-    /**
-     * Dispatch an event to all registered handlers.
-     *
-     * Executes handlers in parallel using Promise.allSettled for best-effort
-     * execution. Errors in individual handlers are logged but do not block
-     * other handlers or propagate to the caller.
-     *
-     * @param event - The CAAMP hook event to dispatch
-     * @param projectRoot - The project root directory path
-     * @param payload - The event payload (typed by event)
-     * @returns Promise that resolves when all handlers have completed
-     *
-     * @example
-     * ```typescript
-     * await hooks.dispatch('onSessionStart', '/project', {
-     *   timestamp: new Date().toISOString(),
-     *   sessionId: 'sess-123',
-     *   name: 'My Session',
-     *   scope: 'feature'
-     * });
-     * ```
-     */
-    dispatch<T extends HookPayload>(event: HookEvent, projectRoot: string, payload: T): Promise<void>;
-    /**
-     * Check if a specific event is currently enabled.
-     *
-     * Both the global enabled flag and the per-event flag must be true.
-     *
-     * @param event - The CAAMP hook event to check
-     * @returns True if the event is enabled
-     */
-    isEnabled(event: HookEvent): boolean;
-    /**
-     * Update the hook system configuration.
-     *
-     * Merges the provided config with the existing config.
-     *
-     * @param config - Partial configuration to apply
-     *
-     * @example
-     * ```typescript
-     * hooks.setConfig({ enabled: false }); // Disable all hooks
-     * hooks.setConfig({ events: { onError: false } }); // Disable specific event
-     * ```
-     */
-    setConfig(config: Partial<HookConfig>): void;
-    /**
-     * Get the current hook configuration.
-     *
-     * @returns A copy of the current configuration
-     */
-    getConfig(): HookConfig;
-    /**
-     * List all registered handlers for a specific event.
-     *
-     * Returns handlers in priority order (highest first).
-     *
-     * @param event - The CAAMP hook event
-     * @returns Array of hook registrations
-     */
-    listHandlers(event: HookEvent): HookRegistration[];
-}
-/**
- * Singleton instance of the HookRegistry.
- *
- * Use this instance for all hook operations throughout the application.
- */
-export declare const hooks: HookRegistry;
-//# sourceMappingURL=registry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyBvF;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,MAAM,CAAmC;IAEjD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,CAAC,SAAS,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAiB9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,QAAQ,CAAC,CAAC,SAAS,WAAW,EAClC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIpC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAI5C;;;;OAIG;IACH,SAAS,IAAI,UAAU;IAIvB;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,EAAE;CAGnD;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,cAAqB,CAAC"}

package/dist/hooks/registry.js

@@ -1,176 +0,0 @@
-/**
- * Hook Registry System - Phase 2C of T5237
- *
- * Central registry for managing hook handlers with priority-based execution,
- * async dispatch, and best-effort error handling. Integrates with CAAMP 1.6.0
- * event definitions while providing CLEO's execution engine.
- *
- * @module @cleocode/cleo/hooks/registry
- */
-import { getLogger } from '../logger.js';
-/**
- * Default configuration for the hook system.
- * All events are enabled by default.
- */
-const DEFAULT_HOOK_CONFIG = {
-    enabled: true,
-    events: {
-        onSessionStart: true,
-        onSessionEnd: true,
-        onToolStart: true,
-        onToolComplete: true,
-        onFileChange: true,
-        onError: true,
-        onPromptSubmit: true,
-        onResponseComplete: true,
-        onWorkAvailable: true,
-        onAgentSpawn: true,
-        onAgentComplete: true,
-        onCascadeStart: true,
-        onPatrol: true,
-    },
-};
-/**
- * Central registry for hook handlers.
- *
- * Manages registration, priority-based ordering, and async dispatch
- * of hook handlers. Provides best-effort execution where errors in
- * one handler do not block others.
- */
-export class HookRegistry {
-    handlers = new Map();
-    config = DEFAULT_HOOK_CONFIG;
-    /**
-     * Register a hook handler for a specific event.
-     *
-     * Handlers are sorted by priority (highest first) and executed
-     * in parallel when the event is dispatched.
-     *
-     * @param registration - The hook registration containing event, handler, priority, and ID
-     * @returns A function to unregister the handler
-     *
-     * @example
-     * ```typescript
-     * const unregister = hooks.register({
-     *   id: 'my-handler',
-     *   event: 'onSessionStart',
-     *   handler: async (root, payload) => { console.log('Session started'); },
-     *   priority: 100
-     * });
-     *
-     * // Later: unregister()
-     * ```
-     */
-    register(registration) {
-        const list = this.handlers.get(registration.event) || [];
-        list.push(registration);
-        // Sort by priority (highest first)
-        list.sort((a, b) => b.priority - a.priority);
-        this.handlers.set(registration.event, list);
-        // Return unregister function
-        return () => {
-            const handlers = this.handlers.get(registration.event);
-            if (handlers) {
-                const idx = handlers.findIndex((h) => h.id === registration.id);
-                if (idx !== -1)
-                    handlers.splice(idx, 1);
-            }
-        };
-    }
-    /**
-     * Dispatch an event to all registered handlers.
-     *
-     * Executes handlers in parallel using Promise.allSettled for best-effort
-     * execution. Errors in individual handlers are logged but do not block
-     * other handlers or propagate to the caller.
-     *
-     * @param event - The CAAMP hook event to dispatch
-     * @param projectRoot - The project root directory path
-     * @param payload - The event payload (typed by event)
-     * @returns Promise that resolves when all handlers have completed
-     *
-     * @example
-     * ```typescript
-     * await hooks.dispatch('onSessionStart', '/project', {
-     *   timestamp: new Date().toISOString(),
-     *   sessionId: 'sess-123',
-     *   name: 'My Session',
-     *   scope: 'feature'
-     * });
-     * ```
-     */
-    async dispatch(event, projectRoot, payload) {
-        // Check if hooks enabled globally
-        if (!this.config.enabled)
-            return;
-        // Check if this event enabled
-        if (!this.config.events[event])
-            return;
-        const handlers = this.handlers.get(event);
-        if (!handlers || handlers.length === 0)
-            return;
-        // Execute all handlers in parallel (best-effort)
-        await Promise.allSettled(handlers.map(async (reg) => {
-            try {
-                await reg.handler(projectRoot, payload);
-            }
-            catch (error) {
-                // Hooks are best-effort - log but don't throw
-                getLogger('hooks').warn({ err: error, hookId: reg.id, event }, 'Hook handler failed');
-            }
-        }));
-    }
-    /**
-     * Check if a specific event is currently enabled.
-     *
-     * Both the global enabled flag and the per-event flag must be true.
-     *
-     * @param event - The CAAMP hook event to check
-     * @returns True if the event is enabled
-     */
-    isEnabled(event) {
-        return this.config.enabled && this.config.events[event];
-    }
-    /**
-     * Update the hook system configuration.
-     *
-     * Merges the provided config with the existing config.
-     *
-     * @param config - Partial configuration to apply
-     *
-     * @example
-     * ```typescript
-     * hooks.setConfig({ enabled: false }); // Disable all hooks
-     * hooks.setConfig({ events: { onError: false } }); // Disable specific event
-     * ```
-     */
-    setConfig(config) {
-        this.config = { ...this.config, ...config };
-    }
-    /**
-     * Get the current hook configuration.
-     *
-     * @returns A copy of the current configuration
-     */
-    getConfig() {
-        return { ...this.config };
-    }
-    /**
-     * List all registered handlers for a specific event.
-     *
-     * Returns handlers in priority order (highest first).
-     *
-     * @param event - The CAAMP hook event
-     * @returns Array of hook registrations
-     */
-    listHandlers(event) {
-        return [...(this.handlers.get(event) || [])];
-    }
-}
-/**
- * Singleton instance of the HookRegistry.
- *
- * Use this instance for all hook operations throughout the application.
- */
-export const hooks = new HookRegistry();
-//# sourceMappingURL=registry.js.map

package/dist/hooks/registry.js.map

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

package/dist/hooks/types.d.ts

@@ -1,299 +0,0 @@
-/**
- * Universal Hooks Core Types - Phase 2B of T5237
- *
- * This module defines the core type system for CLEO's Universal Hooks
- * integration with CAAMP 1.6.0. CLEO builds the hook registry and
- * execution system while CAAMP provides the event definitions.
- *
- * @module @cleocode/cleo/hooks/types
- */
-import type { HookEvent as CAAMPHookEvent } from '@cleocode/caamp';
-export { getCommonHookEvents, getProvidersByHookEvent } from '@cleocode/caamp';
-/**
- * CAAMP-defined hook events supported by provider capability discovery.
- */
-export type ProviderHookEvent = CAAMPHookEvent;
-/**
- * CLEO-local coordination events used by the autonomous runtime.
- *
- * These are internal lifecycle signals for worker orchestration and are not
- * surfaced through CAAMP's provider capability registry.
- */
-export declare const INTERNAL_HOOK_EVENTS: readonly ["onWorkAvailable", "onAgentSpawn", "onAgentComplete", "onCascadeStart", "onPatrol"];
-export type InternalHookEvent = (typeof INTERNAL_HOOK_EVENTS)[number];
-/**
- * Full CLEO hook event union.
- *
- * CAAMP defines provider-facing events; CLEO extends the registry with local
- * coordination events for autonomous execution.
- */
-export type HookEvent = ProviderHookEvent | InternalHookEvent;
-/**
- * Type guard for CAAMP/provider-discoverable hook events.
- */
-export declare function isProviderHookEvent(event: HookEvent): event is ProviderHookEvent;
-/**
- * Type guard for CLEO-local coordination hook events.
- */
-export declare function isInternalHookEvent(event: HookEvent): event is InternalHookEvent;
-/**
- * Base interface for all hook payloads
- * Provides common fields available across all hook events
- */
-export interface HookPayload {
-    /** ISO 8601 timestamp when the hook fired */
-    timestamp: string;
-    /** Optional session ID if firing within a session context */
-    sessionId?: string;
-    /** Optional task ID if firing within a task context */
-    taskId?: string;
-    /** Optional provider ID that triggered the hook */
-    providerId?: string;
-    /** Optional metadata for extensibility */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Payload for onSessionStart hook
- * Fired when a CLEO session begins
- */
-export interface OnSessionStartPayload extends HookPayload {
-    /** Session identifier (required for session events) */
-    sessionId: string;
-    /** Human-readable session name */
-    name: string;
-    /** Session scope/area of work */
-    scope: string;
-    /** Optional agent identifier */
-    agent?: string;
-}
-/**
- * Payload for onSessionEnd hook
- * Fired when a CLEO session ends
- */
-export interface OnSessionEndPayload extends HookPayload {
-    /** Session identifier */
-    sessionId: string;
-    /** Session duration in seconds */
-    duration: number;
-    /** Array of task IDs completed during this session */
-    tasksCompleted: string[];
-}
-/**
- * Payload for onToolStart hook
- * Fired when a task/tool operation begins
- */
-export interface OnToolStartPayload extends HookPayload {
-    /** Task identifier */
-    taskId: string;
-    /** Human-readable task title */
-    taskTitle: string;
-    /** Optional ID of the previous task if sequential */
-    previousTask?: string;
-}
-/**
- * Payload for onToolComplete hook
- * Fired when a task/tool operation completes
- */
-export interface OnToolCompletePayload extends HookPayload {
-    /** Task identifier */
-    taskId: string;
-    /** Human-readable task title */
-    taskTitle: string;
-    /** Final status of the completed task */
-    status: 'done' | 'archived' | 'cancelled';
-}
-/**
- * Handler function type for hook events
- * Handlers receive project root and typed payload
- */
-export type HookHandler<T extends HookPayload = HookPayload> = (projectRoot: string, payload: T) => Promise<void> | void;
-/**
- * Hook registration metadata
- * Tracks registered handlers with priority and event binding
- */
-export interface HookRegistration<T extends HookPayload = HookPayload> {
-    /** Unique identifier for this registration */
-    id: string;
-    /** CAAMP hook event this handler listens for */
-    event: HookEvent;
-    /** Handler function to execute when event fires */
-    handler: HookHandler<T>;
-    /** Priority for execution order (higher = earlier) */
-    priority: number;
-}
-/**
- * Configuration for the hook system
- * Controls which events are enabled/disabled
- */
-export interface HookConfig {
-    /** Master switch for hook system */
-    enabled: boolean;
-    /** Per-event enable/disable configuration */
-    events: Record<HookEvent, boolean>;
-}
-/**
- * Payload for onFileChange hook
- * Fired when a tracked file is written, created, or deleted
- */
-export interface OnFileChangePayload extends HookPayload {
-    /** Absolute or project-relative path of the changed file */
-    filePath: string;
-    /** Kind of filesystem change */
-    changeType: 'write' | 'create' | 'delete';
-    /** File size in bytes after the change (absent for deletes) */
-    sizeBytes?: number;
-}
-/**
- * Payload for onError hook
- * Fired when an operation fails with a structured error
- */
-export interface OnErrorPayload extends HookPayload {
-    /** Numeric exit code or string error code */
-    errorCode: number | string;
-    /** Human-readable error message */
-    message: string;
-    /** Domain where the error occurred */
-    domain?: string;
-    /** Operation that failed */
-    operation?: string;
-    /** Gateway (query / mutate) that received the error */
-    gateway?: string;
-    /** Optional stack trace */
-    stack?: string;
-}
-/**
- * Payload for onPromptSubmit hook
- * Fired when an agent submits a prompt through a gateway
- */
-export interface OnPromptSubmitPayload extends HookPayload {
-    /** Gateway that received the prompt (query / mutate) */
-    gateway: string;
-    /** Target domain */
-    domain: string;
-    /** Target operation */
-    operation: string;
-    /** Optional source identifier (e.g. agent name) */
-    source?: string;
-}
-/**
- * Payload for onResponseComplete hook
- * Fired when a gateway operation finishes (success or failure)
- */
-export interface OnResponseCompletePayload extends HookPayload {
-    /** Gateway that handled the operation */
-    gateway: string;
-    /** Target domain */
-    domain: string;
-    /** Target operation */
-    operation: string;
-    /** Whether the operation succeeded */
-    success: boolean;
-    /** Wall-clock duration in milliseconds */
-    durationMs?: number;
-    /** Error code if the operation failed */
-    errorCode?: string;
-}
-/**
- * Payload for onWorkAvailable hook
- * Fired when the system detects ready work on a Loom/Tapestry
- */
-export interface OnWorkAvailablePayload extends HookPayload {
-    /** IDs of tasks now ready for execution */
-    taskIds: string[];
-    /** Optional epic / Loom identifier */
-    epicId?: string;
-    /** Optional chain or tessera instance identifier */
-    chainId?: string;
-    /** Why the work became available */
-    reason?: 'dependency-cleared' | 'new-task' | 'retry' | 'manual' | 'patrol';
-}
-/**
- * Payload for onAgentSpawn hook
- * Fired when a worker session/process is launched
- */
-export interface OnAgentSpawnPayload extends HookPayload {
-    /** Worker or session identifier */
-    agentId: string;
-    /** Worker role / archetype name */
-    role: string;
-    /** Provider or adapter used to launch the worker */
-    adapterId?: string;
-    /** Optional task assignment at spawn time */
-    taskId?: string;
-}
-/**
- * Payload for onAgentComplete hook
- * Fired when a worker finishes its assigned run
- */
-export interface OnAgentCompletePayload extends HookPayload {
-    /** Worker or session identifier */
-    agentId: string;
-    /** Worker role / archetype name */
-    role: string;
-    /** Completion status for the run */
-    status: 'complete' | 'partial' | 'blocked' | 'failed';
-    /** Optional task assignment that was completed */
-    taskId?: string;
-    /** Optional summary or manifest reference */
-    summary?: string;
-}
-/**
- * Payload for onCascadeStart hook
- * Fired when autonomous execution begins flowing through a chain or wave
- */
-export interface OnCascadeStartPayload extends HookPayload {
-    /** Identifier for the cascade / execution wave */
-    cascadeId: string;
-    /** Optional chain identifier */
-    chainId?: string;
-    /** Optional tessera template / instance identifier */
-    tesseraId?: string;
-    /** Task IDs participating in the cascade */
-    taskIds?: string[];
-}
-/**
- * Payload for onPatrol hook
- * Fired when a watcher performs a periodic health/sweep cycle
- */
-export interface OnPatrolPayload extends HookPayload {
-    /** Watcher / patrol identifier */
-    watcherId: string;
-    /** Patrol category */
-    patrolType: 'health' | 'sweep' | 'refinery' | 'watcher' | 'custom';
-    /** Optional scope being patrolled */
-    scope?: string;
-}
-/**
- * Mapping from CLEO internal lifecycle events to CAAMP hook events
- * This is where CLEO connects its lifecycle to CAAMP's event definitions
- */
-export declare const CLEO_TO_CAAMP_HOOK_MAP: {
-    readonly 'session.start': "onSessionStart";
-    readonly 'session.end': "onSessionEnd";
-    readonly 'task.start': "onToolStart";
-    readonly 'task.complete': "onToolComplete";
-    readonly 'file.change': "onFileChange";
-    readonly 'system.error': "onError";
-    readonly 'prompt.submit': "onPromptSubmit";
-    readonly 'response.complete': "onResponseComplete";
-};
-/**
- * Internal CLEO lifecycle events that drive autonomous coordination.
- */
-export declare const CLEO_INTERNAL_HOOK_MAP: {
-    readonly 'agent.work.available': "onWorkAvailable";
-    readonly 'agent.spawn': "onAgentSpawn";
-    readonly 'agent.complete': "onAgentComplete";
-    readonly 'cascade.start': "onCascadeStart";
-    readonly 'watcher.patrol': "onPatrol";
-};
-/**
- * Type for CLEO lifecycle event names
- * These are the internal events CLEO fires that get mapped to CAAMP events
- */
-export type CLEOLifecycleEvent = keyof typeof CLEO_TO_CAAMP_HOOK_MAP;
-/**
- * Type for autonomous CLEO lifecycle events.
- */
-export type CLEOAutonomousLifecycleEvent = keyof typeof CLEO_INTERNAL_HOOK_MAP;
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/hooks/types.js

@@ -1,62 +0,0 @@
-/**
- * Universal Hooks Core Types - Phase 2B of T5237
- *
- * This module defines the core type system for CLEO's Universal Hooks
- * integration with CAAMP 1.6.0. CLEO builds the hook registry and
- * execution system while CAAMP provides the event definitions.
- *
- * @module @cleocode/cleo/hooks/types
- */
-// Re-export CAAMP provider query functions for hook capability discovery
-export { getCommonHookEvents, getProvidersByHookEvent } from '@cleocode/caamp';
-/**
- * CLEO-local coordination events used by the autonomous runtime.
- *
- * These are internal lifecycle signals for worker orchestration and are not
- * surfaced through CAAMP's provider capability registry.
- */
-export const INTERNAL_HOOK_EVENTS = [
-    'onWorkAvailable',
-    'onAgentSpawn',
-    'onAgentComplete',
-    'onCascadeStart',
-    'onPatrol',
-];
-const INTERNAL_HOOK_EVENT_SET = new Set(INTERNAL_HOOK_EVENTS);
-/**
- * Type guard for CAAMP/provider-discoverable hook events.
- */
-export function isProviderHookEvent(event) {
-    return !INTERNAL_HOOK_EVENT_SET.has(event);
-}
-/**
- * Type guard for CLEO-local coordination hook events.
- */
-export function isInternalHookEvent(event) {
-    return INTERNAL_HOOK_EVENT_SET.has(event);
-}
-/**
- * Mapping from CLEO internal lifecycle events to CAAMP hook events
- * This is where CLEO connects its lifecycle to CAAMP's event definitions
- */
-export const CLEO_TO_CAAMP_HOOK_MAP = {
-    'session.start': 'onSessionStart',
-    'session.end': 'onSessionEnd',
-    'task.start': 'onToolStart',
-    'task.complete': 'onToolComplete',
-    'file.change': 'onFileChange',
-    'system.error': 'onError',
-    'prompt.submit': 'onPromptSubmit',
-    'response.complete': 'onResponseComplete',
-};
-/**
- * Internal CLEO lifecycle events that drive autonomous coordination.
- */
-export const CLEO_INTERNAL_HOOK_MAP = {
-    'agent.work.available': 'onWorkAvailable',
-    'agent.spawn': 'onAgentSpawn',
-    'agent.complete': 'onAgentComplete',
-    'cascade.start': 'onCascadeStart',
-    'watcher.patrol': 'onPatrol',
-};
-//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAO/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB;IACjB,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,UAAU;CACF,CAAC;AAYX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,oBAAoB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAwSD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,aAAa;IAC3B,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,gBAAgB;IACjC,mBAAmB,EAAE,oBAAoB;CACjC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,sBAAsB,EAAE,iBAAiB;IACzC,aAAa,EAAE,cAAc;IAC7B,gBAAgB,EAAE,iBAAiB;IACnC,eAAe,EAAE,gBAAgB;IACjC,gBAAgB,EAAE,UAAU;CACpB,CAAC"}