@hiveforge/hivemind-mcp 2.2.0 → 2.3.0

package/dist/templates/folder-mapper.js

@@ -0,0 +1,148 @@
+/**
+ * Folder-to-type mapping utility.
+ *
+ * Infers entity types from file paths based on folder names.
+ * Used by the CLI 'fix' command and Obsidian plugin to auto-suggest
+ * entity types for files without frontmatter.
+ */
+/**
+ * Default folder-to-type mappings for common worldbuilding folder structures.
+ *
+ * Supports multiple naming conventions (e.g., 'characters', 'people', 'npcs')
+ * mapping to the same entity type.
+ */
+export const DEFAULT_FOLDER_MAPPINGS = [
+    // Character mappings
+    { pattern: 'characters', entityType: 'character' },
+    { pattern: 'people', entityType: 'character' },
+    { pattern: 'npcs', entityType: 'character' },
+    { pattern: 'pcs', entityType: 'character' },
+    { pattern: 'cast', entityType: 'character' },
+    // Location mappings
+    { pattern: 'locations', entityType: 'location' },
+    { pattern: 'places', entityType: 'location' },
+    { pattern: 'geography', entityType: 'location' },
+    { pattern: 'world', entityType: 'location' },
+    { pattern: 'regions', entityType: 'location' },
+    { pattern: 'cities', entityType: 'location' },
+    { pattern: 'towns', entityType: 'location' },
+    // Event mappings
+    { pattern: 'events', entityType: 'event' },
+    { pattern: 'timeline', entityType: 'event' },
+    { pattern: 'history', entityType: 'event' },
+    { pattern: 'sessions', entityType: 'event' },
+    // Faction mappings
+    { pattern: 'factions', entityType: 'faction' },
+    { pattern: 'organizations', entityType: 'faction' },
+    { pattern: 'groups', entityType: 'faction' },
+    { pattern: 'guilds', entityType: 'faction' },
+    { pattern: 'houses', entityType: 'faction' },
+    // Lore mappings
+    { pattern: 'lore', entityType: 'lore' },
+    { pattern: 'mythology', entityType: 'lore' },
+    { pattern: 'magic', entityType: 'lore' },
+    { pattern: 'culture', entityType: 'lore' },
+    { pattern: 'religion', entityType: 'lore' },
+    // Asset mappings
+    { pattern: 'assets', entityType: 'asset' },
+    { pattern: 'images', entityType: 'asset' },
+    { pattern: 'media', entityType: 'asset' },
+    // Reference mappings
+    { pattern: 'references', entityType: 'reference' },
+    { pattern: 'sources', entityType: 'reference' },
+    { pattern: 'inspiration', entityType: 'reference' },
+    { pattern: 'notes', entityType: 'reference' },
+    { pattern: 'meta', entityType: 'reference' },
+];
+/**
+ * FolderMapper infers entity types from file paths.
+ *
+ * Checks each path segment against folder mappings to determine
+ * the most likely entity type for a file.
+ */
+export class FolderMapper {
+    mappings;
+    /**
+     * Create a FolderMapper with optional custom mappings.
+     *
+     * @param customMappings - Additional or override mappings.
+     *                         Custom mappings take precedence over defaults.
+     */
+    constructor(customMappings = []) {
+        this.mappings = new Map();
+        // Add default mappings first
+        for (const mapping of DEFAULT_FOLDER_MAPPINGS) {
+            this.mappings.set(mapping.pattern.toLowerCase(), mapping.entityType);
+        }
+        // Override with custom mappings
+        for (const mapping of customMappings) {
+            this.mappings.set(mapping.pattern.toLowerCase(), mapping.entityType);
+        }
+    }
+    /**
+     * Infer entity type from a file path.
+     *
+     * Checks each folder in the path against mappings.
+     * Returns the first match found, or null if no match.
+     *
+     * @param filePath - Relative or absolute file path
+     * @returns Inferred entity type name, or null if no match
+     */
+    inferType(filePath) {
+        // Split on both forward and back slashes
+        const parts = filePath.toLowerCase().split(/[/\\]/);
+        // Check each path part against mappings
+        for (const part of parts) {
+            // Exact match
+            const exactMatch = this.mappings.get(part);
+            if (exactMatch) {
+                return exactMatch;
+            }
+            // Prefix match (e.g., 'characters-main' matches 'characters')
+            for (const [pattern, entityType] of this.mappings) {
+                if (part.startsWith(pattern)) {
+                    return entityType;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Infer types for multiple file paths.
+     *
+     * @param filePaths - Array of file paths
+     * @returns Map of file path to inferred type (or null)
+     */
+    inferTypes(filePaths) {
+        const results = new Map();
+        for (const path of filePaths) {
+            results.set(path, this.inferType(path));
+        }
+        return results;
+    }
+    /**
+     * Get all registered mappings.
+     *
+     * @returns Array of folder mappings
+     */
+    getMappings() {
+        return Array.from(this.mappings.entries()).map(([pattern, entityType]) => ({
+            pattern,
+            entityType,
+        }));
+    }
+    /**
+     * Add a new mapping.
+     *
+     * @param pattern - Folder name pattern
+     * @param entityType - Entity type to assign
+     */
+    addMapping(pattern, entityType) {
+        this.mappings.set(pattern.toLowerCase(), entityType);
+    }
+}
+/**
+ * Singleton instance for convenience.
+ */
+export const folderMapper = new FolderMapper();
+//# sourceMappingURL=folder-mapper.js.map

package/dist/templates/folder-mapper.js.map

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

package/dist/templates/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template system for pluggable entity type definitions.
+ *
+ * This module enables users to define custom entity types via config
+ * without writing code.
+ */
+export * from './types.js';
+export * from './schema-factory.js';
+export * from './validator.js';
+export * from './registry.js';
+export * from './loader.js';
+export * from './detector.js';
+export * from './folder-mapper.js';
+export * from './builtin/worldbuilding.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,15 @@
+/**
+ * Template system for pluggable entity type definitions.
+ *
+ * This module enables users to define custom entity types via config
+ * without writing code.
+ */
+export * from './types.js';
+export * from './schema-factory.js';
+export * from './validator.js';
+export * from './registry.js';
+export * from './loader.js';
+export * from './detector.js';
+export * from './folder-mapper.js';
+export * from './builtin/worldbuilding.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/templates/loader.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Template configuration loader.
+ *
+ * Provides functions to:
+ * 1. Load template configuration from config.json
+ * 2. Register built-in templates
+ * 3. Validate and register user-defined templates
+ * 4. Activate the selected template
+ * 5. Pre-generate schemas for performance
+ */
+import type { TemplateConfig } from './types.js';
+/**
+ * Find the config.json file.
+ *
+ * Searches in:
+ * 1. Provided path (if given)
+ * 2. Current working directory
+ * 3. Module directory (for development)
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Path to config.json if found, null otherwise
+ */
+export declare function findConfigFile(configPath?: string): string | null;
+/**
+ * Load template configuration from config.json.
+ *
+ * Searches for config.json in multiple locations and extracts the template
+ * section. Returns defaults if config file not found or template section missing.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Template configuration object
+ * @throws {Error} If config file is found but contains invalid template config
+ */
+export declare function loadTemplateConfig(configPath?: string): TemplateConfig;
+/**
+ * Register all built-in templates.
+ *
+ * Currently includes:
+ * - worldbuilding: Characters, locations, events, factions, lore, assets
+ *
+ * This function should be called before loading user templates to ensure
+ * built-in templates can be referenced by ID.
+ */
+export declare function registerBuiltinTemplates(): void;
+/**
+ * Register user-defined templates from config.
+ *
+ * Validates each template and registers it in the registry.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If any user template fails validation or has duplicate ID
+ */
+export declare function registerUserTemplates(config: TemplateConfig): void;
+/**
+ * Activate the selected template.
+ *
+ * Sets the active template in the registry based on the activeTemplate field
+ * in the config.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If the specified template is not registered
+ */
+export declare function activateTemplate(config: TemplateConfig): void;
+/**
+ * Pre-generate schemas for all entity types in the active template.
+ *
+ * Caches schemas in the schema factory for fast runtime access.
+ * This improves performance for note parsing and validation.
+ *
+ * @throws {Error} If no template is active
+ */
+export declare function pregenerateSchemas(): void;
+/**
+ * Full initialization sequence for template system.
+ *
+ * Performs complete setup:
+ * 1. Register built-in templates
+ * 2. Load config from file
+ * 3. Register user-defined templates
+ * 4. Activate selected template
+ * 5. Pre-generate schemas
+ *
+ * This is the main entry point for template system initialization.
+ * Call this at application startup before using any template features.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns The loaded template configuration
+ * @throws {Error} If initialization fails at any step
+ *
+ * @example
+ * ```ts
+ * // At application startup
+ * const config = initializeTemplates();
+ * console.log(`Loaded template: ${config.activeTemplate}`);
+ * ```
+ */
+export declare function initializeTemplates(configPath?: string): TemplateConfig;
+/**
+ * Convenience function to get an entity schema by name.
+ *
+ * Retrieves the entity type config from the active template and returns
+ * the corresponding Zod schema.
+ *
+ * @param entityTypeName - Name of the entity type (e.g., "character", "location")
+ * @returns Zod schema for the entity type
+ * @throws {Error} If no template is active or entity type not found
+ *
+ * @example
+ * ```ts
+ * const characterSchema = getEntitySchema('character');
+ * const validated = characterSchema.parse(frontmatter);
+ * ```
+ */
+export declare function getEntitySchema(entityTypeName: string): import("zod").ZodObject<any, import("zod/v4/core").$strip>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/templates/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/templates/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CA8BtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAiBvE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,8DAWrD"}

package/dist/templates/loader.js

@@ -0,0 +1,202 @@
+/**
+ * Template configuration loader.
+ *
+ * Provides functions to:
+ * 1. Load template configuration from config.json
+ * 2. Register built-in templates
+ * 3. Validate and register user-defined templates
+ * 4. Activate the selected template
+ * 5. Pre-generate schemas for performance
+ */
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { validateTemplateConfig } from './validator.js';
+import { templateRegistry } from './registry.js';
+import { schemaFactory } from './schema-factory.js';
+import { worldbuildingTemplate } from './builtin/worldbuilding.js';
+/**
+ * Find the config.json file.
+ *
+ * Searches in:
+ * 1. Provided path (if given)
+ * 2. Current working directory
+ * 3. Module directory (for development)
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Path to config.json if found, null otherwise
+ */
+export function findConfigFile(configPath) {
+    // If explicit path provided, use it
+    if (configPath) {
+        return existsSync(configPath) ? resolve(configPath) : null;
+    }
+    // Try current working directory
+    const cwdConfig = resolve(process.cwd(), 'config.json');
+    if (existsSync(cwdConfig)) {
+        return cwdConfig;
+    }
+    // Try module directory (for development/testing)
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    const moduleConfig = resolve(moduleDir, '../../config.json');
+    if (existsSync(moduleConfig)) {
+        return moduleConfig;
+    }
+    return null;
+}
+/**
+ * Load template configuration from config.json.
+ *
+ * Searches for config.json in multiple locations and extracts the template
+ * section. Returns defaults if config file not found or template section missing.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Template configuration object
+ * @throws {Error} If config file is found but contains invalid template config
+ */
+export function loadTemplateConfig(configPath) {
+    const configFilePath = findConfigFile(configPath);
+    // If no config file found, return defaults
+    if (!configFilePath) {
+        return {
+            activeTemplate: 'worldbuilding',
+            templates: [],
+        };
+    }
+    // Read and parse config file
+    let configContent;
+    try {
+        const fileContent = readFileSync(configFilePath, 'utf-8');
+        configContent = JSON.parse(fileContent);
+    }
+    catch (err) {
+        throw new Error(`Failed to read or parse config file at ${configFilePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Extract template section (use defaults if missing)
+    const templateConfig = configContent.template || {
+        activeTemplate: 'worldbuilding',
+        templates: [],
+    };
+    // Validate the template config
+    return validateTemplateConfig(templateConfig);
+}
+/**
+ * Register all built-in templates.
+ *
+ * Currently includes:
+ * - worldbuilding: Characters, locations, events, factions, lore, assets
+ *
+ * This function should be called before loading user templates to ensure
+ * built-in templates can be referenced by ID.
+ */
+export function registerBuiltinTemplates() {
+    templateRegistry.register(worldbuildingTemplate, 'builtin');
+}
+/**
+ * Register user-defined templates from config.
+ *
+ * Validates each template and registers it in the registry.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If any user template fails validation or has duplicate ID
+ */
+export function registerUserTemplates(config) {
+    if (!config.templates || config.templates.length === 0) {
+        return;
+    }
+    for (const template of config.templates) {
+        // Template already validated by loadTemplateConfig
+        templateRegistry.register(template, 'config');
+    }
+}
+/**
+ * Activate the selected template.
+ *
+ * Sets the active template in the registry based on the activeTemplate field
+ * in the config.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If the specified template is not registered
+ */
+export function activateTemplate(config) {
+    templateRegistry.activate(config.activeTemplate);
+}
+/**
+ * Pre-generate schemas for all entity types in the active template.
+ *
+ * Caches schemas in the schema factory for fast runtime access.
+ * This improves performance for note parsing and validation.
+ *
+ * @throws {Error} If no template is active
+ */
+export function pregenerateSchemas() {
+    const activeTemplate = templateRegistry.getActive();
+    if (!activeTemplate) {
+        throw new Error('Cannot pregenerate schemas: no active template');
+    }
+    // Generate schemas for all entity types
+    schemaFactory.generateSchemas(activeTemplate.entityTypes);
+}
+/**
+ * Full initialization sequence for template system.
+ *
+ * Performs complete setup:
+ * 1. Register built-in templates
+ * 2. Load config from file
+ * 3. Register user-defined templates
+ * 4. Activate selected template
+ * 5. Pre-generate schemas
+ *
+ * This is the main entry point for template system initialization.
+ * Call this at application startup before using any template features.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns The loaded template configuration
+ * @throws {Error} If initialization fails at any step
+ *
+ * @example
+ * ```ts
+ * // At application startup
+ * const config = initializeTemplates();
+ * console.log(`Loaded template: ${config.activeTemplate}`);
+ * ```
+ */
+export function initializeTemplates(configPath) {
+    // 1. Register built-in templates
+    registerBuiltinTemplates();
+    // 2. Load config
+    const config = loadTemplateConfig(configPath);
+    // 3. Register user templates
+    registerUserTemplates(config);
+    // 4. Activate selected template
+    activateTemplate(config);
+    // 5. Pre-generate schemas
+    pregenerateSchemas();
+    return config;
+}
+/**
+ * Convenience function to get an entity schema by name.
+ *
+ * Retrieves the entity type config from the active template and returns
+ * the corresponding Zod schema.
+ *
+ * @param entityTypeName - Name of the entity type (e.g., "character", "location")
+ * @returns Zod schema for the entity type
+ * @throws {Error} If no template is active or entity type not found
+ *
+ * @example
+ * ```ts
+ * const characterSchema = getEntitySchema('character');
+ * const validated = characterSchema.parse(frontmatter);
+ * ```
+ */
+export function getEntitySchema(entityTypeName) {
+    const entityType = templateRegistry.getEntityType(entityTypeName);
+    if (!entityType) {
+        const activeTemplate = templateRegistry.getActive();
+        const availableTypes = activeTemplate?.entityTypes.map((t) => t.name).join(', ') || 'none';
+        throw new Error(`Entity type "${entityTypeName}" not found in active template. Available types: ${availableTypes}`);
+    }
+    return schemaFactory.getSchema(entityType);
+}
+//# sourceMappingURL=loader.js.map

package/dist/templates/loader.js.map

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

package/dist/templates/registry.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Template registry for managing template lifecycle.
+ *
+ * Provides centralized template management with O(1) lookups
+ * and validation on registration.
+ */
+import type { TemplateDefinition, TemplateRegistryEntry, EntityTypeConfig } from './types.js';
+/**
+ * Source of a template registration.
+ */
+type TemplateSource = 'builtin' | 'config';
+/**
+ * Manages registered templates with fast lookups.
+ *
+ * Singleton pattern ensures consistent state across the application.
+ * Validates templates on registration and provides O(1) entity type lookups.
+ */
+export declare class TemplateRegistry {
+    /** Map from template ID to registry entry */
+    private templates;
+    /** ID of the currently active template */
+    private activeTemplateId;
+    /**
+     * Registers a template in the registry.
+     *
+     * Validates the template definition and creates optimized lookup maps.
+     *
+     * @param template - Template definition to register
+     * @param source - Source of the template (builtin or config)
+     * @throws {Error} If template with this ID is already registered
+     */
+    register(template: TemplateDefinition, source: TemplateSource): void;
+    /**
+     * Sets the active template by ID.
+     *
+     * @param templateId - ID of template to activate
+     * @throws {Error} If template ID is not registered
+     */
+    activate(templateId: string): void;
+    /**
+     * Gets the currently active template.
+     *
+     * @returns Active template entry, or null if no template is active
+     */
+    getActive(): TemplateRegistryEntry | null;
+    /**
+     * Gets a template by ID.
+     *
+     * @param templateId - Template ID to retrieve
+     * @returns Template entry if found, undefined otherwise
+     */
+    get(templateId: string): TemplateRegistryEntry | undefined;
+    /**
+     * Checks if a template is registered.
+     *
+     * @param templateId - Template ID to check
+     * @returns True if template exists in registry
+     */
+    has(templateId: string): boolean;
+    /**
+     * Lists all registered template IDs.
+     *
+     * @returns Array of template IDs
+     */
+    listTemplates(): string[];
+    /**
+     * Gets an entity type config from the active template.
+     *
+     * O(1) lookup using the entity type map.
+     *
+     * @param name - Entity type name to retrieve
+     * @returns Entity type config if found, undefined otherwise
+     * @throws {Error} If no template is active
+     */
+    getEntityType(name: string): EntityTypeConfig | undefined;
+    /**
+     * Gets all entity type configs from the active template.
+     *
+     * @returns Array of entity type configs
+     * @throws {Error} If no template is active
+     */
+    getEntityTypes(): EntityTypeConfig[];
+    /**
+     * Clears all registered templates and resets active template.
+     *
+     * Primarily for testing purposes.
+     */
+    clear(): void;
+}
+/**
+ * Singleton instance of the template registry.
+ *
+ * Use this throughout the application for consistent template state.
+ */
+export declare const templateRegistry: TemplateRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,KAAK,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3C;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAA4C;IAE7D,0CAA0C;IAC1C,OAAO,CAAC,gBAAgB,CAAuB;IAE/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAyBpE;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAUlC;;;;OAIG;IACH,SAAS,IAAI,qBAAqB,GAAG,IAAI;IAOzC;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI1D;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;;;OAIG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;;;;;;;OAQG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAQzD;;;;;OAKG;IACH,cAAc,IAAI,gBAAgB,EAAE;IAQpC;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}