@compass-ai/nova 1.0.72 → 1.0.74

package/dist/types/config.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Type definitions for configuration structures
+ *
+ * This module defines all TypeScript interfaces and types used for configuration
+ * management throughout the Compass CLI application. It includes:
+ * - Main configuration interface (CompassConfig)
+ * - Section-specific configuration interfaces
+ * - Configuration file format
+ * - Source tracking for configuration values
+ */
+import { StatusLineConfig } from './statusline.js';
+/**
+ * Main configuration interface for the Compass CLI application.
+ * Contains all configuration sections organized by functionality.
+ *
+ * NOTE: Token limits are NOT part of user configuration. They are hardcoded
+ * system defaults in src/constants/token-limits.ts and cannot be overridden.
+ */
+export interface CompassConfig {
+    /** Anthropic API configuration */
+    anthropic: AnthropicConfig;
+    /** Ollama API configuration (auto-fetched or manual) */
+    ollama: OllamaConfig;
+    /** Project-specific configuration */
+    project: ProjectConfig;
+    /** Safety and approval configuration */
+    safety: SafetyConfig;
+    /** User interface configuration */
+    ui: UIConfig;
+    /** Session management configuration */
+    session: SessionConfig;
+    /** Auto-update configuration */
+    update: UpdateSettingsConfig;
+    /** Agentic loop configuration */
+    agentic: AgenticConfig;
+}
+/**
+ * Configuration for agentic loop behavior.
+ * Controls iteration limits, cost thresholds, and automatic compaction.
+ */
+export interface AgenticConfig {
+    /** Maximum iterations for the agentic loop (0 = unlimited, token-bound only) */
+    maxIterations: number;
+    /** Maximum iterations per task in plan mode (default: 50) */
+    maxIterationsPerTask: number;
+    /** Cost threshold in USD that triggers a warning (default: 5.0) */
+    costWarningThreshold: number;
+    /** Hard cost cap in USD that stops the loop (0 = no cap) */
+    costHardCap: number;
+    /** Context window usage percentage that triggers auto-compaction (default: 80) */
+    autoCompactAtPercent: number;
+    /** Whether to enable stuck detection for repetitive tool calls */
+    stuckDetectionEnabled: boolean;
+    /** Number of identical consecutive tool calls before stuck detection triggers */
+    stuckDetectionThreshold: number;
+}
+/**
+ * Configuration for auto-update settings.
+ * Controls update checking behavior and notification preferences.
+ */
+export interface UpdateSettingsConfig {
+    /** Whether to automatically check for updates on startup */
+    checkOnStartup: boolean;
+    /** Interval in hours between automatic update checks */
+    checkInterval: number;
+    /** Whether to show update notifications */
+    showNotifications: boolean;
+    /** Notification style: 'banner', 'minimal', 'detailed', or 'silent' */
+    notificationStyle: 'banner' | 'minimal' | 'detailed' | 'silent';
+    /** Whether to include pre-release versions */
+    includePrerelease: boolean;
+}
+/**
+ * Configuration for Anthropic API integration.
+ * Controls model selection, token limits, and API connection settings.
+ */
+export interface AnthropicConfig {
+    /** Anthropic API key (optional, can be set via environment variable) */
+    apiKey?: string;
+    /** Claude model ID to use for API requests */
+    model: string;
+    /** Maximum tokens to generate in responses */
+    maxTokens: number;
+    /** Temperature for response randomness (0-1) */
+    temperature: number;
+    /** Optional custom base URL for API requests */
+    baseUrl?: string;
+}
+/**
+ * Configuration for Ollama API integration.
+ * Controls model selection, endpoint settings, and API connection for Ollama providers.
+ */
+export interface OllamaConfig {
+    /** Ollama API key (optional, from Compass auto-fetch or manual entry) */
+    apiKey?: string;
+    /** Ollama model ID to use for API requests */
+    model: string;
+    /** Ollama server endpoint URL */
+    endpoint: string;
+    /** Maximum tokens to generate in responses */
+    maxTokens: number;
+    /** Temperature for response randomness (0-1) */
+    temperature: number;
+    /** Whether this config was auto-fetched from Compass */
+    autoFetched?: boolean;
+}
+/**
+ * Configuration for project-specific settings.
+ * Controls file indexing, patterns, and project boundaries.
+ */
+export interface ProjectConfig {
+    /** Optional project name for display purposes */
+    name?: string;
+    /** Root directory of the project */
+    rootDir: string;
+    /** Glob patterns for files/directories to ignore during indexing */
+    ignorePatterns: string[];
+    /** Glob patterns for files to include during indexing */
+    includePatterns: string[];
+    /** Maximum file size in bytes for indexing and processing */
+    maxFileSize: number;
+    /** Whether to index the project on startup */
+    indexOnStartup: boolean;
+}
+/**
+ * Configuration for safety features and approval workflow.
+ * Controls file modification approval, blocked patterns, and command execution.
+ */
+export interface SafetyConfig {
+    /** Whether to require user approval for file modifications */
+    requireApproval: boolean;
+    /** Glob patterns for files that can be auto-approved */
+    autoApprovePatterns: string[];
+    /** Glob patterns for files that should never be modified */
+    blockedPatterns: string[];
+    /** Maximum number of files that can be modified in a single operation */
+    maxFilesPerOperation: number;
+    /** Whether to create backups before modifying files */
+    backupBeforeModify: boolean;
+    /** Timeout in milliseconds for shell command execution */
+    shellCommandTimeout: number;
+    /** List of shell commands that are allowed to execute */
+    allowedShellCommands: string[];
+    /** List of shell commands that are blocked from execution */
+    blockedShellCommands: string[];
+}
+/**
+ * Configuration for user interface settings.
+ * Controls display options, themes, and output formatting.
+ */
+export interface UIConfig {
+    /** Status line configuration (optional, disabled by default) */
+    statusLine?: StatusLineConfig;
+}
+/**
+ * Configuration for session management.
+ * Controls auto-save, history limits, and session expiration.
+ */
+export interface SessionConfig {
+    /** Whether to automatically save session state */
+    autoSave: boolean;
+    /** Interval in milliseconds between auto-saves */
+    autoSaveInterval: number;
+    /** Maximum number of messages to retain in conversation history */
+    maxHistoryLength: number;
+    /** Token count threshold that triggers automatic conversation compaction */
+    autoCompactThreshold: number;
+    /** Number of days before session data expires */
+    sessionExpiryDays: number;
+    /** Whether to enable unguarded (unleash) mode — removes safety guardrails from system prompt (default: false) */
+    unleash?: boolean;
+}
+/**
+ * Structure of a configuration file stored on disk.
+ * Includes version information for migration support.
+ */
+export interface ConfigFile {
+    /** Version of the configuration file format */
+    version: string;
+    /** Partial configuration (only includes user-modified values) */
+    config: Partial<CompassConfig>;
+}
+/**
+ * Source of a configuration value.
+ * Used for tracking where configuration values originated.
+ */
+export type ConfigSource = 'default' | 'global' | 'project' | 'env' | 'cli';
+/**
+ * Result of configuration resolution.
+ * Contains the merged configuration and source tracking for each section.
+ */
+export interface ResolvedConfig {
+    /** The fully resolved configuration */
+    config: CompassConfig;
+    /** Map of configuration sections to their sources */
+    sources: Record<keyof CompassConfig, ConfigSource>;
+}
+/**
+ * Type guard to check if an object is a valid CompassConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid CompassConfig
+ */
+export declare function isValidCompassConfig(obj: unknown): obj is CompassConfig;
+/**
+ * Type guard to check if an object is a valid AgenticConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid AgenticConfig
+ */
+export declare function isValidAgenticConfig(obj: unknown): obj is AgenticConfig;
+/**
+ * Type guard to check if an object is a valid AnthropicConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid AnthropicConfig
+ */
+export declare function isValidAnthropicConfig(obj: unknown): obj is AnthropicConfig;
+/**
+ * Type guard to check if an object is a valid OllamaConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid OllamaConfig
+ */
+export declare function isValidOllamaConfig(obj: unknown): obj is OllamaConfig;
+/**
+ * Type guard to check if an object is a valid ProjectConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid ProjectConfig
+ */
+export declare function isValidProjectConfig(obj: unknown): obj is ProjectConfig;
+/**
+ * Type guard to check if an object is a valid SafetyConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid SafetyConfig
+ */
+export declare function isValidSafetyConfig(obj: unknown): obj is SafetyConfig;
+/**
+ * Type guard to check if an object is a valid UIConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid UIConfig
+ */
+export declare function isValidUIConfig(obj: unknown): obj is UIConfig;
+/**
+ * Type guard to check if an object is a valid SessionConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid SessionConfig
+ */
+export declare function isValidSessionConfig(obj: unknown): obj is SessionConfig;
+/**
+ * Type guard to check if an object is a valid UpdateSettingsConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid UpdateSettingsConfig
+ */
+export declare function isValidUpdateSettingsConfig(obj: unknown): obj is UpdateSettingsConfig;
+/**
+ * Type guard to check if an object is a valid ConfigFile.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid ConfigFile
+ */
+export declare function isValidConfigFile(obj: unknown): obj is ConfigFile;
+//# sourceMappingURL=config.d.ts.map

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

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

package/dist/types/config.js

@@ -0,0 +1,188 @@
+/**
+ * Type definitions for configuration structures
+ *
+ * This module defines all TypeScript interfaces and types used for configuration
+ * management throughout the Compass CLI application. It includes:
+ * - Main configuration interface (CompassConfig)
+ * - Section-specific configuration interfaces
+ * - Configuration file format
+ * - Source tracking for configuration values
+ */
+/**
+ * Type guard to check if an object is a valid CompassConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid CompassConfig
+ */
+export function isValidCompassConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.anthropic === 'object' &&
+        config.anthropic !== null &&
+        typeof config.ollama === 'object' &&
+        config.ollama !== null &&
+        typeof config.project === 'object' &&
+        config.project !== null &&
+        typeof config.safety === 'object' &&
+        config.safety !== null &&
+        typeof config.ui === 'object' &&
+        config.ui !== null &&
+        typeof config.session === 'object' &&
+        config.session !== null &&
+        typeof config.update === 'object' &&
+        config.update !== null &&
+        typeof config.agentic === 'object' &&
+        config.agentic !== null);
+}
+/**
+ * Type guard to check if an object is a valid AgenticConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid AgenticConfig
+ */
+export function isValidAgenticConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.maxIterations === 'number' &&
+        typeof config.costWarningThreshold === 'number' &&
+        typeof config.costHardCap === 'number' &&
+        typeof config.autoCompactAtPercent === 'number' &&
+        typeof config.stuckDetectionEnabled === 'boolean' &&
+        typeof config.stuckDetectionThreshold === 'number');
+}
+/**
+ * Type guard to check if an object is a valid AnthropicConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid AnthropicConfig
+ */
+export function isValidAnthropicConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.model === 'string' &&
+        typeof config.maxTokens === 'number' &&
+        typeof config.temperature === 'number');
+}
+/**
+ * Type guard to check if an object is a valid OllamaConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid OllamaConfig
+ */
+export function isValidOllamaConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.model === 'string' &&
+        typeof config.endpoint === 'string' &&
+        typeof config.maxTokens === 'number' &&
+        typeof config.temperature === 'number');
+}
+/**
+ * Type guard to check if an object is a valid ProjectConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid ProjectConfig
+ */
+export function isValidProjectConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.rootDir === 'string' &&
+        Array.isArray(config.ignorePatterns) &&
+        Array.isArray(config.includePatterns) &&
+        typeof config.maxFileSize === 'number' &&
+        typeof config.indexOnStartup === 'boolean');
+}
+/**
+ * Type guard to check if an object is a valid SafetyConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid SafetyConfig
+ */
+export function isValidSafetyConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.requireApproval === 'boolean' &&
+        Array.isArray(config.autoApprovePatterns) &&
+        Array.isArray(config.blockedPatterns) &&
+        typeof config.maxFilesPerOperation === 'number' &&
+        typeof config.backupBeforeModify === 'boolean' &&
+        typeof config.shellCommandTimeout === 'number' &&
+        Array.isArray(config.allowedShellCommands) &&
+        Array.isArray(config.blockedShellCommands));
+}
+/**
+ * Type guard to check if an object is a valid UIConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid UIConfig
+ */
+export function isValidUIConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return typeof config === 'object' && config !== null;
+}
+/**
+ * Type guard to check if an object is a valid SessionConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid SessionConfig
+ */
+export function isValidSessionConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.autoSave === 'boolean' &&
+        typeof config.autoSaveInterval === 'number' &&
+        typeof config.maxHistoryLength === 'number' &&
+        typeof config.autoCompactThreshold === 'number' &&
+        typeof config.sessionExpiryDays === 'number');
+}
+/**
+ * Type guard to check if an object is a valid UpdateSettingsConfig.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid UpdateSettingsConfig
+ */
+export function isValidUpdateSettingsConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    return (typeof config.checkOnStartup === 'boolean' &&
+        typeof config.checkInterval === 'number' &&
+        typeof config.showNotifications === 'boolean' &&
+        typeof config.notificationStyle === 'string' &&
+        ['banner', 'minimal', 'detailed', 'silent'].includes(config.notificationStyle) &&
+        typeof config.includePrerelease === 'boolean');
+}
+/**
+ * Type guard to check if an object is a valid ConfigFile.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid ConfigFile
+ */
+export function isValidConfigFile(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const file = obj;
+    return (typeof file.version === 'string' &&
+        typeof file.config === 'object' &&
+        file.config !== null);
+}
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

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

package/dist/types/consent.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Type definitions for consent management (GDPR compliance)
+ *
+ * This module defines all TypeScript interfaces and types related to consent management
+ * for the Compass CLI application. It ensures GDPR compliance by providing:
+ * - Granular consent options for different data processing activities
+ * - Consent versioning for policy update tracking
+ * - Consent history for audit purposes
+ * - Status tracking for validity and expiration
+ */
+/**
+ * Represents the individual consent settings for different data processing activities.
+ * Each property corresponds to a specific type of data collection or processing.
+ */
+export interface Consent {
+    /**
+     * Consent for local data collection (conversation history, session data, configuration).
+     * This is required for Compass to function properly.
+     */
+    dataCollection: boolean;
+    /**
+     * Consent for anonymous telemetry collection.
+     * Helps improve Compass by sending anonymous usage statistics.
+     * This is optional.
+     */
+    telemetry: boolean;
+    /**
+     * Consent for analytics data collection.
+     * Allows collection of feature usage patterns to improve the product.
+     * This is optional.
+     */
+    analytics: boolean;
+    /**
+     * Consent for automatic error reporting.
+     * Automatically sends error reports to help fix bugs.
+     * This is optional but recommended.
+     */
+    errorReporting: boolean;
+}
+/**
+ * Represents a single consent record with full metadata.
+ * Each time consent is granted or updated, a new record is created.
+ */
+export interface ConsentRecord {
+    /**
+     * Unique identifier for this consent record (UUID v4)
+     */
+    id: string;
+    /**
+     * Version of the consent policy that was agreed to.
+     * Used to determine if re-consent is needed after policy updates.
+     */
+    version: string;
+    /**
+     * The actual consent settings that were granted
+     */
+    consent: Consent;
+    /**
+     * ISO-8601 timestamp when consent was granted
+     */
+    grantedAt: string;
+    /**
+     * ISO-8601 timestamp when this consent expires and needs renewal
+     */
+    expiresAt: string;
+    /**
+     * Optional hash of the user's IP address for audit purposes
+     * (not currently used, reserved for future compliance needs)
+     */
+    ipHash?: string;
+    /**
+     * Optional user agent string for audit purposes
+     * (not currently used, reserved for future compliance needs)
+     */
+    userAgent?: string;
+}
+/**
+ * Represents the complete consent history for a user.
+ * Maintains all consent records for audit purposes and tracks the current active consent.
+ */
+export interface ConsentHistory {
+    /**
+     * Array of all consent records, ordered chronologically
+     */
+    records: ConsentRecord[];
+    /**
+     * ID of the currently active consent record, or null if no valid consent exists
+     */
+    currentRecordId: string | null;
+}
+/**
+ * Represents the current consent status with computed properties.
+ * Used for quick status checks without needing to parse the full history.
+ */
+export interface ConsentStatus {
+    /**
+     * Whether the current consent is valid (not expired and version matches)
+     */
+    isValid: boolean;
+    /**
+     * The current consent settings, or null if no valid consent exists
+     */
+    consent: Consent | null;
+    /**
+     * ISO-8601 timestamp when current consent was granted, or null if none
+     */
+    grantedAt: string | null;
+    /**
+     * ISO-8601 timestamp when current consent expires, or null if none
+     */
+    expiresAt: string | null;
+    /**
+     * Number of days until consent expires, or null if no valid consent.
+     * Returns 0 if already expired.
+     */
+    daysUntilExpiry: number | null;
+    /**
+     * Whether consent needs to be renewed (expired or version mismatch)
+     */
+    needsRenewal: boolean;
+    /**
+     * Version of the current consent policy, or null if no consent exists
+     */
+    version: string | null;
+}
+/**
+ * Represents a consent prompt configuration for the setup wizard.
+ * Defines how each consent option should be presented to the user.
+ */
+export interface ConsentPrompt {
+    /**
+     * Display title for the consent option
+     */
+    title: string;
+    /**
+     * Detailed description explaining what this consent covers
+     */
+    description: string;
+    /**
+     * Whether this consent is required for the application to function
+     */
+    required: boolean;
+    /**
+     * Default value to suggest to the user
+     */
+    defaultValue: boolean;
+}
+/**
+ * Current version of the consent policy.
+ * Increment this when the consent terms change to trigger re-consent.
+ */
+export declare const CONSENT_VERSION = "1.0.0";
+/**
+ * Configuration for all consent prompts shown during setup.
+ * Maps consent property names to their display configuration.
+ */
+export declare const CONSENT_PROMPTS: Record<keyof Consent, ConsentPrompt>;
+/**
+ * Type guard to check if an object is a valid Consent object.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid Consent
+ */
+export declare function isValidConsent(obj: unknown): obj is Consent;
+/**
+ * Type guard to check if an object is a valid ConsentRecord.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid ConsentRecord
+ */
+export declare function isValidConsentRecord(obj: unknown): obj is ConsentRecord;
+/**
+ * Creates a default consent object with all options disabled except required ones.
+ *
+ * @returns Default Consent object
+ */
+export declare function createDefaultConsent(): Consent;
+/**
+ * Creates a consent object with all options enabled.
+ * Useful for testing or when user opts into everything.
+ *
+ * @returns Consent object with all options enabled
+ */
+export declare function createFullConsent(): Consent;
+/**
+ * Creates a minimal consent object with only required options enabled.
+ *
+ * @returns Consent object with only required options
+ */
+export declare function createMinimalConsent(): Consent;
+//# sourceMappingURL=consent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/types/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;IAEzB;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,aAAa,CA2BhE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAa3D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAcvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C"}