@buenojs/bueno 0.8.10 → 0.8.11

package/dist/config/env.js

@@ -0,0 +1,392 @@
+/**
+ * Environment variable handling for Bueno Framework
+ */
+import { setNestedValue } from "./merge";
+import { ENV_MAPPINGS } from "./types";
+/**
+ * Environment file priority (later files override earlier ones)
+ */
+const ENV_FILE_PRIORITY = [
+    ".env",
+    ".env.local",
+    ".env.development",
+    ".env.production",
+    ".env.test",
+];
+/**
+ * Get the current NODE_ENV
+ */
+export function getNodeEnv() {
+    return Bun.env.NODE_ENV || "development";
+}
+/**
+ * Get environment-specific .env file name
+ */
+export function getEnvFileName() {
+    const nodeEnv = getNodeEnv();
+    switch (nodeEnv) {
+        case "production":
+            return ".env.production";
+        case "test":
+            return ".env.test";
+        default:
+            return ".env.development";
+    }
+}
+/**
+ * Check if a file exists
+ */
+async function fileExists(path) {
+    try {
+        const file = Bun.file(path);
+        return await file.exists();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse .env file content
+ */
+function parseEnvContent(content) {
+    const result = {};
+    const lines = content.split("\n");
+    for (const line of lines) {
+        // Skip empty lines and comments
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        // Parse KEY=value or KEY="value" or KEY='value'
+        const match = trimmed.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
+        if (!match) {
+            continue;
+        }
+        const [, key, rawValue] = match;
+        let value = rawValue;
+        // Handle quoted values
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Load environment variables from a single .env file
+ */
+async function loadEnvFile(filePath) {
+    const exists = await fileExists(filePath);
+    if (!exists) {
+        return { vars: {}, existed: false };
+    }
+    try {
+        const file = Bun.file(filePath);
+        const content = await file.text();
+        const vars = parseEnvContent(content);
+        return { vars, existed: true };
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to load ${filePath}:`, error);
+        return { vars: {}, existed: false };
+    }
+}
+/**
+ * Load environment variables from multiple .env files
+ * Files are loaded in priority order, with later files overriding earlier ones
+ */
+export async function loadEnvFiles(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const files = options?.files ?? [...ENV_FILE_PRIORITY];
+    // Add NODE_ENV-specific file if requested
+    if (options?.loadNodeEnv !== false) {
+        const envFile = getEnvFileName();
+        if (!files.includes(envFile)) {
+            files.push(envFile);
+        }
+    }
+    const result = {};
+    for (const file of files) {
+        const filePath = file.startsWith("/") ? file : `${cwd}/${file}`;
+        const { vars } = await loadEnvFile(filePath);
+        Object.assign(result, vars);
+    }
+    return result;
+}
+// ============= Environment Variable Validation =============
+/**
+ * Validate environment variables before loading
+ *
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export async function validateEnvVars(envVars) {
+    try {
+        const { validateEnvVars } = await import("./env-validation");
+        return validateEnvVars(envVars);
+    }
+    catch (error) {
+        return {
+            success: false,
+            issues: [
+                {
+                    message: `Failed to validate environment variables: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+        };
+    }
+}
+/**
+ * Load and validate environment variables with detailed error reporting
+ *
+ * @param options - Options for loading and validating environment variables
+ * @returns Loaded environment data with validation result
+ */
+export async function loadAndValidateEnv(options) {
+    try {
+        // Load environment variables from files
+        const fileVars = await loadEnvFiles(options);
+        // Validate the environment variables
+        const validationResult = await validateEnvVars(fileVars);
+        // Merge with Bun.env if requested
+        const raw = options?.mergeWithProcess !== false
+            ? {
+                ...fileVars,
+                ...Object.fromEntries(Object.entries(Bun.env).filter(([, v]) => v !== undefined)),
+            }
+            : fileVars;
+        // Transform to config
+        const config = envToConfig(raw, options?.mappings);
+        // Track sources
+        const sources = new Map();
+        for (const [name, value] of Object.entries(raw)) {
+            sources.set(name, {
+                name,
+                value,
+                source: fileVars[name] !== undefined ? ".env file" : "process",
+            });
+        }
+        // Set loaded vars to Bun.env
+        for (const [key, value] of Object.entries(fileVars)) {
+            if (Bun.env[key] === undefined) {
+                Bun.env[key] = value;
+            }
+        }
+        const loaded = { raw, config, sources };
+        if (!validationResult.success) {
+            return {
+                loaded,
+                valid: false,
+                errors: validationResult.issues
+                    .map((issue) => issue.message)
+                    .join("\n"),
+            };
+        }
+        return { loaded, valid: true };
+    }
+    catch (error) {
+        return {
+            loaded: { raw: {}, config: {}, sources: new Map() },
+            valid: false,
+            errors: `Failed to load and validate environment variables: ${error instanceof Error ? error.message : "Unknown error"}`,
+        };
+    }
+}
+/**
+ * Get environment variable value from Bun.env
+ */
+export function getEnvVar(name) {
+    return Bun.env[name];
+}
+/**
+ * Set environment variable in Bun.env
+ */
+export function setEnvVar(name, value) {
+    Bun.env[name] = value;
+}
+/**
+ * Delete environment variable from Bun.env
+ */
+export function deleteEnvVar(name) {
+    delete Bun.env[name];
+}
+/**
+ * Transform environment variables to configuration object
+ */
+export function envToConfig(envVars, mappings = ENV_MAPPINGS) {
+    let config = {};
+    for (const mapping of mappings) {
+        const value = envVars[mapping.envVar];
+        if (value === undefined || value === "") {
+            continue;
+        }
+        const transformedValue = mapping.transform
+            ? mapping.transform(value)
+            : value;
+        config = setNestedValue(config, mapping.configKey, transformedValue);
+    }
+    return config;
+}
+/**
+ * Load environment variables and transform to configuration
+ */
+export async function loadEnv(options) {
+    // Load and validate environment variables
+    const result = await loadAndValidateEnv(options);
+    if (!result.valid) {
+        console.error("Environment variable validation failed:");
+        console.error(result.errors);
+        throw new Error("Environment variable validation failed. Check the error messages above.");
+    }
+    return result.loaded;
+}
+/**
+ * Get all environment variables related to Bueno configuration
+ */
+export function getBuenoEnvVars() {
+    const result = {};
+    for (const mapping of ENV_MAPPINGS) {
+        const value = Bun.env[mapping.envVar];
+        if (value !== undefined) {
+            result[mapping.envVar] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Check if running in development mode
+ */
+export function isDevelopment() {
+    return getNodeEnv() === "development";
+}
+/**
+ * Check if running in production mode
+ */
+export function isProduction() {
+    return getNodeEnv() === "production";
+}
+/**
+ * Check if running in test mode
+ */
+export function isTest() {
+    return getNodeEnv() === "test";
+}
+/**
+ * Create a custom environment variable mapping
+ */
+export function createEnvMapping(envVar, configKey, transform) {
+    return { envVar, configKey, transform };
+}
+/**
+ * Parse a boolean environment variable
+ */
+export function parseEnvBoolean(value) {
+    return value === "true" || value === "1" || value === "yes";
+}
+/**
+ * Parse a number environment variable
+ */
+export function parseEnvNumber(value) {
+    const num = Number.parseInt(value, 10);
+    if (isNaN(num)) {
+        throw new Error(`Invalid number: ${value}`);
+    }
+    return num;
+}
+/**
+ * Parse a JSON environment variable
+ */
+export function parseEnvJSON(value) {
+    return JSON.parse(value);
+}
+/**
+ * Parse an array environment variable (comma-separated)
+ */
+export function parseEnvArray(value) {
+    return value.split(",").map((v) => v.trim());
+}
+/**
+ * Environment config mapping for standard Bueno config
+ */
+export const envConfigMapping = [
+    { envVar: "BUENO_PORT", configKey: "server.port", transform: parseEnvNumber },
+    { envVar: "BUENO_HOST", configKey: "server.host" },
+    {
+        envVar: "BUENO_DEV",
+        configKey: "server.development",
+        transform: parseEnvBoolean,
+    },
+    { envVar: "DATABASE_URL", configKey: "database.url" },
+    {
+        envVar: "DATABASE_POOL_SIZE",
+        configKey: "database.poolSize",
+        transform: parseEnvNumber,
+    },
+    { envVar: "REDIS_URL", configKey: "cache.url" },
+    { envVar: "CACHE_DRIVER", configKey: "cache.driver" },
+    { envVar: "CACHE_TTL", configKey: "cache.ttl", transform: parseEnvNumber },
+    { envVar: "LOG_LEVEL", configKey: "logger.level" },
+    {
+        envVar: "LOG_PRETTY",
+        configKey: "logger.pretty",
+        transform: parseEnvBoolean,
+    },
+    {
+        envVar: "HEALTH_ENABLED",
+        configKey: "health.enabled",
+        transform: parseEnvBoolean,
+    },
+    {
+        envVar: "METRICS_ENABLED",
+        configKey: "metrics.enabled",
+        transform: parseEnvBoolean,
+    },
+    {
+        envVar: "TELEMETRY_ENABLED",
+        configKey: "telemetry.enabled",
+        transform: parseEnvBoolean,
+    },
+    { envVar: "TELEMETRY_SERVICE_NAME", configKey: "telemetry.serviceName" },
+    { envVar: "TELEMETRY_ENDPOINT", configKey: "telemetry.endpoint" },
+    {
+        envVar: "FRONTEND_DEV_SERVER",
+        configKey: "frontend.devServer",
+        transform: parseEnvBoolean,
+    },
+    {
+        envVar: "FRONTEND_HMR",
+        configKey: "frontend.hmr",
+        transform: parseEnvBoolean,
+    },
+    {
+        envVar: "FRONTEND_PORT",
+        configKey: "frontend.port",
+        transform: parseEnvNumber,
+    },
+];
+/**
+ * Get a config value from environment variables using the mapping
+ */
+export function getEnvConfig(mappings = envConfigMapping) {
+    const envVars = {};
+    for (const [key, value] of Object.entries(Bun.env)) {
+        if (value !== undefined) {
+            envVars[key] = value;
+        }
+    }
+    return envToConfig(envVars, mappings);
+}
+/**
+ * Get an environment variable value
+ */
+export function getEnvValue(key, defaultValue) {
+    return Bun.env[key] ?? defaultValue;
+}
+/**
+ * Set an environment variable value
+ */
+export function setEnvValue(key, value) {
+    Bun.env[key] = value;
+}
+//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Configuration System for Bueno Framework
+ *
+ * Provides a comprehensive configuration system supporting:
+ * - `bueno.config.ts` file loading
+ * - Environment variables
+ * - Schema validation
+ * - Deep merging of config sources
+ */
+export type { BuenoConfig, ServerConfig, DatabaseConfig, CacheConfig, LoggerConfig, HealthConfig, MetricsConfig, TelemetryConfig, FrontendConfig, JobsConfig, NotificationConfig, I18nConfig, DeepPartial, UserConfig, UserConfigFn, InferConfig, } from "./types";
+export { deepMerge, mergeConfigs, isObject } from "./merge";
+export { loadEnv, getEnvConfig, getEnvValue, setEnvValue, envConfigMapping, type EnvConfigMapping, } from "./env";
+export { loadConfig, loadConfigFile, loadConfigFiles, findConfigFile, clearConfigCache, getCachedConfig, watchConfig, validateConfigStructure, getConfigPathFromArgs, getConfigPathFromEnv, type LoadedConfig, } from "./loader";
+export { validateConfig, validateConfigSync, validateConfigDefaults, validateWithSchema, assertValidConfig, formatValidationErrors, createConfigError, createCustomValidator, isStandardSchema, type ConfigValidationResult, type ConfigValidationError, type ConfigValidationWarning, } from "./validation";
+import type { StandardSchema } from "../types";
+import type { BuenoConfig, DeepPartial, UserConfig, UserConfigFn } from "./types";
+import { type ConfigValidationResult } from "./validation";
+/**
+ * ConfigManager options
+ */
+export interface ConfigManagerOptions<T extends BuenoConfig = BuenoConfig> {
+    /** Custom config file path */
+    configPath?: string;
+    /** Working directory */
+    cwd?: string;
+    /** Whether to load environment variables */
+    loadEnv?: boolean;
+    /** Whether to use default config */
+    useDefaults?: boolean;
+    /** Custom schema for validation */
+    schema?: StandardSchema<T>;
+    /** Whether to validate config on load */
+    validate?: boolean;
+    /** Additional config to merge */
+    config?: DeepPartial<T>;
+}
+/**
+ * Config change callback
+ */
+export type ConfigChangeCallback<T extends BuenoConfig = BuenoConfig> = (config: T) => void;
+/**
+ * ConfigManager class
+ * Manages configuration loading, merging, validation, and access
+ */
+export declare class ConfigManager<T extends BuenoConfig = BuenoConfig> {
+    private config;
+    private options;
+    private loaded;
+    private filePath?;
+    private watchers;
+    private unwatch?;
+    constructor(options?: ConfigManagerOptions<T>);
+    /**
+     * Load configuration from all sources
+     * Order: defaults → file config → env vars → CLI args → provided config
+     */
+    load(): Promise<T>;
+    /**
+     * Get the entire configuration
+     */
+    getAll(): T;
+    /**
+     * Get a configuration value using dot notation
+     * @example
+     * config.get('server.port') // 3000
+     * config.get('database.url') // 'postgresql://...'
+     */
+    get<K extends keyof T>(key: K): T[K];
+    get<K extends string>(key: K): unknown;
+    /**
+     * Set a configuration value at runtime
+     * @example
+     * config.set('server.port', 4000)
+     */
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    set(key: string, value: unknown): void;
+    /**
+     * Check if a configuration key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Validate the current configuration
+     */
+    validate(schema?: StandardSchema<T>): Promise<ConfigValidationResult>;
+    /**
+     * Validate synchronously (only default rules)
+     */
+    validateSync(): ConfigValidationResult;
+    /**
+     * Watch for configuration changes
+     */
+    watch(callback: ConfigChangeCallback<T>): () => void;
+    /**
+     * Start watching the config file for changes
+     */
+    watchFile(): Promise<void>;
+    /**
+     * Stop watching the config file
+     */
+    unwatchFile(): void;
+    /**
+     * Check if config has been loaded
+     */
+    isLoaded(): boolean;
+    /**
+     * Get the config file path
+     */
+    getFilePath(): string | undefined;
+    /**
+     * Reset configuration to defaults
+     */
+    reset(): void;
+    /**
+     * Merge additional configuration
+     */
+    merge(config: DeepPartial<T>): void;
+    /**
+     * Notify all watchers of a change
+     */
+    private notifyWatchers;
+}
+/**
+ * Define configuration with type safety
+ * @example
+ * export default defineConfig({
+ *   server: { port: 3000 },
+ *   database: { url: process.env.DATABASE_URL },
+ * })
+ */
+export declare function defineConfig<T extends BuenoConfig = BuenoConfig>(config: UserConfig<T>): UserConfig<T>;
+/**
+ * Define configuration with a function
+ * @example
+ * export default defineConfigFn((env) => ({
+ *   server: { port: env.PORT ? parseInt(env.PORT) : 3000 },
+ * }))
+ */
+export declare function defineConfigFn<T extends BuenoConfig = BuenoConfig>(fn: UserConfigFn<T>): UserConfigFn<T>;
+/**
+ * Create a configuration manager
+ * @example
+ * const config = await createConfigManager();
+ * const port = config.get('server.port');
+ */
+export declare function createConfigManager<T extends BuenoConfig = BuenoConfig>(options?: ConfigManagerOptions<T>): Promise<ConfigManager<T>>;
+/**
+ * Create a configuration manager without loading
+ * @example
+ * const config = createConfigManagerSync();
+ * // Later: await config.load();
+ */
+export declare function createConfigManagerSync<T extends BuenoConfig = BuenoConfig>(options?: ConfigManagerOptions<T>): ConfigManager<T>;
+/**
+ * Load configuration and return the config object directly
+ * @example
+ * const config = await loadConfigDirect();
+ * console.log(config.server?.port);
+ */
+export declare function loadConfigDirect<T extends BuenoConfig = BuenoConfig>(options?: ConfigManagerOptions<T>): Promise<T>;
+/**
+ * Get the default configuration manager
+ */
+export declare function getConfigManager(): ConfigManager;
+/**
+ * Set the default configuration manager
+ */
+export declare function setConfigManager(manager: ConfigManager): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG5D,OAAO,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,KAAK,gBAAgB,GACrB,MAAM,OAAO,CAAC;AAGf,OAAO,EACN,UAAU,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,YAAY,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C,OAAO,KAAK,EACX,WAAW,EACX,WAAW,EAEX,UAAU,EACV,YAAY,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,KAAK,sBAAsB,EAI3B,MAAM,cAAc,CAAC;AAoDtB;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACxE,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CACvE,MAAM,EAAE,CAAC,KACL,IAAI,CAAC;AAEV;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC7D,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,OAAO,CAAC,CAAa;gBAEjB,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM;IAYjD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;IAqCxB;;OAEG;IACH,MAAM,IAAI,CAAC;IAIX;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpC,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;IAkBtC;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsBtC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoB3E;;OAEG;IACH,YAAY,IAAI,sBAAsB;IAMtC;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYpD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBhC;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,cAAc;CAStB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC/D,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACnB,UAAU,CAAC,CAAC,CAAC,CAEf;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,GACjB,YAAY,CAAC,CAAC,CAAC,CAEjB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC5E,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAI3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC1E,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,aAAa,CAAC,CAAC,CAAC,CAElB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACzE,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAGZ;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE7D"}