@nathanvale/chatline 0.0.1 → 0.0.2-next.0

package/dist/config/loader.js

@@ -1,251 +0,0 @@
-/**
- * Configuration Loader for iMessage Timeline
- *
- * Implements CONFIG--T02: Implement Config Loader
- * Loads config from YAML/JSON files with env var substitution and precedence
- */
-import { constants } from 'node:fs';
-import { access, readFile } from 'node:fs/promises';
-import yaml from 'js-yaml';
-import { detectConfigFormat, validateConfig } from './schema.js';
-/**
- * In-memory cache for loaded configurations
- * CONFIG-T02-AC05: Cache loaded config to avoid repeated file reads
- */
-let configCache = null;
-let configCachePath = null;
-/**
- * CONFIG-T02-AC01: Discover config file in directory
- *
- * Checks files in order:
- * 1. imessage-config.yaml
- * 2. imessage-config.yml
- * 3. imessage-config.json
- *
- * @param baseDir - Directory to search in (defaults to current directory)
- * @returns Path to first existing config file, or null if none found
- */
-export async function discoverConfigFile(baseDir = process.cwd()) {
-    const fileNames = [
-        'imessage-config.yaml',
-        'imessage-config.yml',
-        'imessage-config.json',
-    ];
-    for (const fileName of fileNames) {
-        const filePath = baseDir.startsWith('/')
-            ? `${baseDir}/${fileName}`
-            : `./${baseDir}/${fileName}`.replace(/\/\.\//g, '/');
-        try {
-            await access(filePath, constants.R_OK);
-            return filePath;
-        }
-        catch {
-            // File doesn't exist or not readable, try next
-        }
-    }
-    return null;
-}
-/**
- * CONFIG-T02-AC01: Load and parse config file
- *
- * Supports JSON and YAML formats with auto-detection
- *
- * @param filePath - Path to config file
- * @returns Parsed config object (unvalidated)
- * @throws Error if file cannot be read or parsed
- */
-export async function loadConfigFile(filePath) {
-    const content = await readFile(filePath, 'utf-8');
-    const format = detectConfigFormat(filePath);
-    if (format === 'json') {
-        try {
-            return JSON.parse(content);
-        }
-        catch (error) {
-            throw new Error(`Failed to parse JSON config file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    else if (format === 'yaml') {
-        try {
-            // js-yaml v4+ is safe by default - use JSON_SCHEMA for extra safety
-            return yaml.load(content, { schema: yaml.JSON_SCHEMA });
-        }
-        catch (error) {
-            throw new Error(`Failed to parse YAML config file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    throw new Error(`Unsupported config format: ${filePath}`);
-}
-/**
- * CONFIG-T02-AC03: Substitute environment variables in config
- *
- * Recursively replaces ${VAR_NAME} patterns with environment variable values
- *
- * @param obj - Config object (or primitive)
- * @returns Object with env vars substituted
- *
- * @example
- * ```typescript
- * // With process.env.GEMINI_API_KEY = 'secret123'
- * substituteEnvVars({ apiKey: '${GEMINI_API_KEY}' })
- * // => { apiKey: 'secret123' }
- * ```
- */
-export function substituteEnvVars(obj) {
-    // Handle strings - replace ${VAR} patterns
-    if (typeof obj === 'string') {
-        return obj.replace(/\$\{(\w+)\}/g, (_match, envVar) => {
-            const value = process.env[envVar];
-            if (value === undefined) {
-                throw new Error(`Environment variable ${envVar} is not set but referenced in config`);
-            }
-            return value;
-        });
-    }
-    // Handle arrays - recursively substitute each element
-    if (Array.isArray(obj)) {
-        return obj.map(substituteEnvVars);
-    }
-    // Handle objects - recursively substitute each value
-    if (typeof obj === 'object' && obj !== null) {
-        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
-            key,
-            substituteEnvVars(value),
-        ]));
-    }
-    // Primitives (numbers, booleans, null) pass through unchanged
-    return obj;
-}
-/**
- * CONFIG-T02-AC02: Merge configuration with precedence
- *
- * Precedence (highest to lowest):
- * 1. CLI options
- * 2. Config file
- * 3. Defaults (applied by Zod schema)
- *
- * @param fileConfig - Config loaded from file
- * @param cliOptions - Options from CLI flags
- * @returns Merged config object
- */
-export function mergeConfig(fileConfig, cliOptions = {}) {
-    // Deep merge: CLI options override file config
-    // Note: Zod schema will apply defaults for missing fields
-    const merged = {
-        ...fileConfig,
-        ...cliOptions,
-    };
-    // Deep merge nested objects if they exist
-    if (fileConfig.gemini || cliOptions.gemini) {
-        merged.gemini = {
-            ...fileConfig.gemini,
-            ...cliOptions.gemini,
-            // biome-ignore lint/suspicious/noExplicitAny: Zod schema mismatch with spread
-        };
-    }
-    if (cliOptions.firecrawl !== undefined) {
-        merged.firecrawl = cliOptions.firecrawl;
-    }
-    else if (fileConfig.firecrawl !== undefined) {
-        merged.firecrawl = fileConfig.firecrawl;
-    }
-    if (fileConfig.enrichment || cliOptions.enrichment) {
-        merged.enrichment = {
-            ...fileConfig.enrichment,
-            ...cliOptions.enrichment,
-            // biome-ignore lint/suspicious/noExplicitAny: Zod schema mismatch with spread
-        };
-    }
-    if (fileConfig.render || cliOptions.render) {
-        merged.render = {
-            ...fileConfig.render,
-            ...cliOptions.render,
-            // biome-ignore lint/suspicious/noExplicitAny: Zod schema mismatch with spread
-        };
-    }
-    return merged;
-}
-/**
- * CONFIG-T02: Main config loading function
- *
- * Loads configuration with the following precedence:
- * 1. CLI options (highest priority)
- * 2. Config file
- * 3. Defaults from schema (lowest priority)
- *
- * @param options - Loading options
- * @param options.configPath - Explicit config file path (optional)
- * @param options.cliOptions - CLI options to merge (optional)
- * @param options.skipCache - Force reload even if cached (optional)
- * @returns Validated and merged configuration
- * @throws Error if config is invalid or cannot be loaded
- *
- * @example
- * ```typescript
- * // Load with auto-discovery
- * const config = await loadConfig()
- *
- * // Load specific file
- * const config = await loadConfig({ configPath: './custom-config.yaml' })
- *
- * // Override with CLI options
- * const config = await loadConfig({
- *   cliOptions: {
- *     gemini: { apiKey: 'override-key' }
- *   }
- * })
- * ```
- */
-export async function loadConfig(options = {}) {
-    const { configPath, cliOptions = {}, skipCache = false } = options;
-    // CONFIG-T02-AC05: Return cached config if available
-    if (!skipCache && configCache && configCachePath === configPath) {
-        return configCache;
-    }
-    // 1. Discover or use provided config file path
-    const filePath = configPath || (await discoverConfigFile());
-    // 2. Load config from file (if exists)
-    let fileConfig = {};
-    if (filePath) {
-        try {
-            const rawConfig = await loadConfigFile(filePath);
-            // 3. CONFIG-T02-AC03: Substitute environment variables
-            const withEnvVars = substituteEnvVars(rawConfig);
-            fileConfig = withEnvVars;
-        }
-        catch (error) {
-            throw new Error(`Failed to load config from ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    // 4. CONFIG-T02-AC02: Merge with CLI options (CLI > file)
-    const merged = mergeConfig(fileConfig, cliOptions);
-    // 5. CONFIG-T02-AC04: Validate with schema and apply defaults
-    try {
-        const validated = validateConfig(merged);
-        // Cache the result
-        configCache = validated;
-        configCachePath = configPath || null;
-        return validated;
-    }
-    catch (error) {
-        throw new Error(`Config validation failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * Clear the config cache
- *
- * Useful for testing or when config needs to be reloaded
- */
-export function clearConfigCache() {
-    configCache = null;
-    configCachePath = null;
-}
-/**
- * Check if a config is currently cached
- *
- * @returns True if config is cached
- */
-export function isConfigCached() {
-    return configCache !== null;
-}
-//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/schema.d.ts

@@ -1,107 +0,0 @@
-/**
- * Configuration Schema for iMessage Timeline
- *
- * Implements CONFIG--T01: Define Config Schema
- * Supports both JSON and YAML formats with Zod validation
- */
-import { z } from 'zod';
-/**
- * TypeScript type for the full configuration
- * Explicitly defined for DTS generation compatibility
- */
-export type Config = {
-    version: string;
-    attachmentRoots: string[];
-    gemini: {
-        apiKey: string;
-        model: string;
-        rateLimitDelay: number;
-        maxRetries: number;
-    };
-    firecrawl?: {
-        apiKey?: string;
-        enabled: boolean;
-    };
-    enrichment: {
-        enableVisionAnalysis: boolean;
-        enableAudioTranscription: boolean;
-        enableLinkEnrichment: boolean;
-        imageCacheDir: string;
-        checkpointInterval: number;
-        forceRefresh: boolean;
-    };
-    render: {
-        groupByTimeOfDay: boolean;
-        renderRepliesAsNested: boolean;
-        renderTapbacksAsEmoji: boolean;
-        maxNestingDepth: number;
-    };
-};
-/**
- * CONFIG-T01-AC01: Main configuration schema
- *
- * Supports:
- * - CONFIG-T01-AC02: JSON and YAML formats
- * - CONFIG-T01-AC03: Environment variable interpolation via ${ENV_VAR}
- * - CONFIG-T01-AC05: Validation errors with field paths
- */
-export declare const ConfigSchema: z.ZodType<Config, z.ZodTypeDef, unknown>;
-/**
- * CONFIG-T01-AC05: Validate config with detailed error messages
- *
- * @param config - Raw config object (parsed from JSON/YAML)
- * @returns Validated and typed config object
- * @throws ZodError with field paths and expected types
- *
- * @example
- * ```typescript
- * try {
- *   const config = validateConfig(rawConfig)
- * } catch (error) {
- *   if (error instanceof z.ZodError) {
- *     error.errors.forEach(err => {
- *       console.error(`${err.path.join('.')}: ${err.message}`)
- *     })
- *   }
- * }
- * ```
- */
-export declare function validateConfig(config: unknown): Config;
-/**
- * Validate config and return result with detailed errors
- *
- * @param config - Raw config object
- * @returns Validation result with success flag and data/errors
- */
-export declare function validateConfigSafe(config: unknown): {
-    success: boolean;
-    data?: Config;
-    errors?: Array<{
-        path: string;
-        message: string;
-    }>;
-};
-/**
- * Default configuration values
- *
- * Used as fallback when no config file is present
- */
-export declare const DEFAULT_CONFIG: Partial<Config>;
-/**
- * CONFIG-T01-AC04: Config file discovery patterns
- *
- * Checked in order:
- * 1. ./imessage-config.yaml
- * 2. ./imessage-config.yml
- * 3. ./imessage-config.json
- */
-export declare const CONFIG_FILE_PATTERNS: readonly ["./imessage-config.yaml", "./imessage-config.yml", "./imessage-config.json"];
-/**
- * CONFIG-T01-AC02: Supported config file formats
- */
-export type ConfigFormat = 'json' | 'yaml';
-/**
- * Detect config file format from file extension
- */
-export declare function detectConfigFormat(filePath: string): ConfigFormat;
-//# sourceMappingURL=schema.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8CvB;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,SAAS,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,OAAO,CAAA;KAChB,CAAA;IACD,UAAU,EAAE;QACX,oBAAoB,EAAE,OAAO,CAAA;QAC7B,wBAAwB,EAAE,OAAO,CAAA;QACjC,oBAAoB,EAAE,OAAO,CAAA;QAC7B,aAAa,EAAE,MAAM,CAAA;QACrB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,YAAY,EAAE,OAAO,CAAA;KACrB,CAAA;IACD,MAAM,EAAE;QACP,gBAAgB,EAAE,OAAO,CAAA;QACzB,qBAAqB,EAAE,OAAO,CAAA;QAC9B,qBAAqB,EAAE,OAAO,CAAA;QAC9B,eAAe,EAAE,MAAM,CAAA;KACvB,CAAA;CACD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAsBhE,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG;IACpD,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjD,CAcA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAiB1C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,wFAIvB,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAA;AAE1C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAWjE"}

package/dist/config/schema.js

@@ -1,169 +0,0 @@
-/**
- * Configuration Schema for iMessage Timeline
- *
- * Implements CONFIG--T01: Define Config Schema
- * Supports both JSON and YAML formats with Zod validation
- */
-import { z } from 'zod';
-/**
- * CONFIG-T01-AC01: Config schema with Zod validation
- *
- * Gemini API configuration for AI-powered enrichment
- */
-const GeminiConfigSchema = z.object({
-    apiKey: z.string().min(1, 'Gemini API key is required'),
-    model: z.string().default('gemini-1.5-pro'),
-    rateLimitDelay: z.number().min(0).default(1000),
-    maxRetries: z.number().min(0).max(10).default(3),
-});
-/**
- * Firecrawl API configuration for link enrichment (optional)
- */
-const FirecrawlConfigSchema = z
-    .object({
-    apiKey: z.string().optional(),
-    enabled: z.boolean().default(true),
-})
-    .optional();
-/**
- * Enrichment pipeline configuration
- */
-const EnrichmentConfigSchema = z.object({
-    enableVisionAnalysis: z.boolean().default(true),
-    enableAudioTranscription: z.boolean().default(true),
-    enableLinkEnrichment: z.boolean().default(true),
-    imageCacheDir: z.string().default('./.cache/images'),
-    checkpointInterval: z.number().min(1).max(10000).default(100),
-    forceRefresh: z.boolean().default(false),
-});
-/**
- * Markdown rendering configuration
- */
-const RenderConfigSchema = z.object({
-    groupByTimeOfDay: z.boolean().default(true),
-    renderRepliesAsNested: z.boolean().default(true),
-    renderTapbacksAsEmoji: z.boolean().default(true),
-    maxNestingDepth: z.number().min(1).max(100).default(10),
-});
-/**
- * CONFIG-T01-AC01: Main configuration schema
- *
- * Supports:
- * - CONFIG-T01-AC02: JSON and YAML formats
- * - CONFIG-T01-AC03: Environment variable interpolation via ${ENV_VAR}
- * - CONFIG-T01-AC05: Validation errors with field paths
- */
-export const ConfigSchema = z.object({
-    version: z.string().default('1.0'),
-    attachmentRoots: z
-        .array(z.string().min(1, 'Attachment root path cannot be empty'))
-        .min(1, 'At least one attachment root is required')
-        .default(['~/Library/Messages/Attachments']),
-    gemini: GeminiConfigSchema,
-    firecrawl: FirecrawlConfigSchema,
-    enrichment: EnrichmentConfigSchema.default({
-        enableVisionAnalysis: true,
-        enableAudioTranscription: true,
-        enableLinkEnrichment: true,
-        imageCacheDir: './.cache/images',
-        checkpointInterval: 100,
-        forceRefresh: false,
-    }),
-    render: RenderConfigSchema.default({
-        groupByTimeOfDay: true,
-        renderRepliesAsNested: true,
-        renderTapbacksAsEmoji: true,
-        maxNestingDepth: 10,
-    }),
-});
-/**
- * CONFIG-T01-AC05: Validate config with detailed error messages
- *
- * @param config - Raw config object (parsed from JSON/YAML)
- * @returns Validated and typed config object
- * @throws ZodError with field paths and expected types
- *
- * @example
- * ```typescript
- * try {
- *   const config = validateConfig(rawConfig)
- * } catch (error) {
- *   if (error instanceof z.ZodError) {
- *     error.errors.forEach(err => {
- *       console.error(`${err.path.join('.')}: ${err.message}`)
- *     })
- *   }
- * }
- * ```
- */
-export function validateConfig(config) {
-    return ConfigSchema.parse(config);
-}
-/**
- * Validate config and return result with detailed errors
- *
- * @param config - Raw config object
- * @returns Validation result with success flag and data/errors
- */
-export function validateConfigSafe(config) {
-    const result = ConfigSchema.safeParse(config);
-    if (result.success) {
-        return { success: true, data: result.data };
-    }
-    return {
-        success: false,
-        errors: result.error.errors.map((err) => ({
-            path: err.path.join('.'),
-            message: err.message,
-        })),
-    };
-}
-/**
- * Default configuration values
- *
- * Used as fallback when no config file is present
- */
-export const DEFAULT_CONFIG = {
-    version: '1.0',
-    attachmentRoots: ['~/Library/Messages/Attachments'],
-    enrichment: {
-        enableVisionAnalysis: true,
-        enableAudioTranscription: true,
-        enableLinkEnrichment: true,
-        imageCacheDir: './.cache/images',
-        checkpointInterval: 100,
-        forceRefresh: false,
-    },
-    render: {
-        groupByTimeOfDay: true,
-        renderRepliesAsNested: true,
-        renderTapbacksAsEmoji: true,
-        maxNestingDepth: 10,
-    },
-};
-/**
- * CONFIG-T01-AC04: Config file discovery patterns
- *
- * Checked in order:
- * 1. ./imessage-config.yaml
- * 2. ./imessage-config.yml
- * 3. ./imessage-config.json
- */
-export const CONFIG_FILE_PATTERNS = [
-    './imessage-config.yaml',
-    './imessage-config.yml',
-    './imessage-config.json',
-];
-/**
- * Detect config file format from file extension
- */
-export function detectConfigFormat(filePath) {
-    if (filePath.endsWith('.json')) {
-        return 'json';
-    }
-    if (filePath.endsWith('.yaml') || filePath.endsWith('.yml')) {
-        return 'yaml';
-    }
-    throw new Error(`Unsupported config file format: ${filePath}. Supported formats: .json, .yaml, .yml`);
-}
-//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/enrich/audio-transcription.d.ts

@@ -1,77 +0,0 @@
-/**
- * Audio Transcription Module (ENRICH--T02)
- *
- * Implements audio transcription with structured output:
- * - AC01: Structured prompt requesting timestamps and speaker identification
- * - AC02: Extract speaker labels (Speaker 1, Speaker 2, etc.)
- * - AC03: Generate short description (1-2 sentences)
- * - AC04: Store under media.enrichment with kind='transcription'
- * - AC05: Handle long audio files (>10min) with streaming/chunking
- *
- * Architecture:
- * - transcribeAudioChunk: Transcribe single chunk with Gemini API
- * - handleLongAudio: Split large files and process chunks
- * - transcribeAudio: Call Gemini Audio API with structured prompt
- * - analyzeAudio: Main entry point, handles single message enrichment
- * - analyzeAudios: Batch processing wrapper
- *
- * Error Handling:
- * - Non-fatal errors are logged and original message is returned
- * - Transcription failures don't block enrichment pipeline
- * - Pipeline never crashes on enrichment errors
- */
-import type { MediaEnrichment, Message } from '#schema/message';
-type AudioTranscriptionConfig = {
-    enableAudioTranscription: boolean;
-    geminiApiKey: string;
-    geminiModel?: string;
-    maxAudioChunkDuration?: number;
-    rateLimitDelay?: number;
-    maxRetries?: number;
-};
-type TranscriptionData = {
-    transcription: string;
-    speakers: string[];
-    timestamps: Array<{
-        time: string;
-        speaker: string;
-        content: string;
-    }>;
-    shortDescription: string;
-};
-/**
- * AC01: Call Gemini Audio API with structured prompt for single chunk
- * AC02, AC03: Parse response into transcription, speakers, and description
- * AC04: Create enrichment with provenance
- */
-export declare function transcribeAudioChunk(audioPath: string, chunkIndex: number, config: Partial<AudioTranscriptionConfig>): Promise<TranscriptionData>;
-/**
- * AC05: Handle long audio files by splitting and processing chunks
- * Merges results from all chunks into single transcription
- */
-export declare function handleLongAudio(audioPath: string, durationSeconds: number, config: Partial<AudioTranscriptionConfig>): Promise<TranscriptionData>;
-/**
- * AC01-AC05: Main transcription orchestrator
- * Handles chunk detection, API calls, and response parsing
- */
-export declare function transcribeAudio(audioPath: string, config: Partial<AudioTranscriptionConfig>): Promise<MediaEnrichment>;
-/**
- * Main entry point - analyze audio media message and enrich it
- * Handles all ACs (AC01-AC05) through helper functions
- *
- * Responsibilities:
- * 1. Check if media is audio type (skip non-audio)
- * 2. Check if path is available
- * 3. Call transcription with chunking support (AC05)
- * 4. Parse response and extract data (AC01-AC03)
- * 5. Add enrichment with provenance (AC04)
- */
-export declare function analyzeAudio(message: Message, config: Partial<AudioTranscriptionConfig>): Promise<Message>;
-/**
- * Batch analyze multiple messages
- * Useful for enrichment stage that processes arrays of messages
- * Each message is processed independently; errors don't stop the batch
- */
-export declare function analyzeAudios(messages: Message[], config: Partial<AudioTranscriptionConfig>): Promise<Message[]>;
-export {};
-//# sourceMappingURL=audio-transcription.d.ts.map

package/dist/enrich/audio-transcription.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-transcription.d.ts","sourceRoot":"","sources":["../../src/enrich/audio-transcription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAa,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAI1E,KAAK,wBAAwB,GAAG;IAC/B,wBAAwB,EAAE,OAAO,CAAA;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,KAAK,iBAAiB,GAAG;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrE,gBAAgB,EAAE,MAAM,CAAA;CACxB,CAAA;AA6DD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC,CA6F5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC,CA6D5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACvC,OAAO,CAAC,eAAe,CAAC,CA4C1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACvC,OAAO,CAAC,OAAO,CAAC,CA+ElB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACvC,OAAO,CAAC,OAAO,EAAE,CAAC,CAsCpB"}