@digitaldefiance/i18n-lib 1.3.13 → 1.3.15

package/src/language-registry.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Language registry for managing supported languages and their properties
+ */
+import { LanguageDefinition } from './language-definition';
+/**
+ * Static singleton registry for managing supported languages globally
+ */
+export declare class LanguageRegistry {
+    private static languages;
+    private static languagesByCodes;
+    private static defaultLanguageId;
+    private constructor();
+    /**
+     * Register a new language
+     */
+    static registerLanguage(language: LanguageDefinition): void;
+    /**
+     * Register multiple languages at once
+     */
+    static registerLanguages(languages: readonly LanguageDefinition[]): void;
+    /**
+     * Get a language by its ID
+     */
+    static getLanguage(languageId: string): LanguageDefinition | undefined;
+    /**
+     * Get a language by its code
+     */
+    static getLanguageByCode(code: string): LanguageDefinition | undefined;
+    /**
+     * Get all registered languages
+     */
+    static getAllLanguages(): ReadonlyArray<LanguageDefinition>;
+    /**
+     * Get all language IDs
+     */
+    static getLanguageIds(): readonly string[];
+    /**
+     * Get all language codes
+     */
+    static getLanguageCodes(): readonly string[];
+    /**
+     * Check if a language is registered
+     */
+    static hasLanguage(languageId: string): boolean;
+    /**
+     * Check if a language code is registered
+     */
+    static hasLanguageCode(code: string): boolean;
+    /**
+     * Get the default language
+     */
+    static getDefaultLanguage(): LanguageDefinition | null;
+    /**
+     * Get the default language ID
+     */
+    static getDefaultLanguageId(): string | null;
+    /**
+     * Get matching language code with fallback logic:
+     * 1. Try requested code
+     * 2. Fall back to user default
+     * 3. Fall back to site default
+     */
+    static getMatchingLanguageCode(requestedCode?: string, userDefaultCode?: string): string;
+    /**
+     * Set the default language
+     */
+    static setDefaultLanguage(languageId: string): void;
+    /**
+     * Get the number of registered languages
+     */
+    static getLanguageCount(): number;
+    /**
+     * Validate that all required languages are present
+     */
+    static validateRequiredLanguages(requiredLanguages: readonly string[]): LanguageValidationResult;
+    /**
+     * Create a mapping of language IDs to their display names
+     */
+    static getLanguageDisplayNames(): Record<string, string>;
+    /**
+     * Create a mapping of language IDs to their codes
+     */
+    static getLanguageCodeMapping(): Record<string, string>;
+    /**
+     * Find languages by partial name match (case-insensitive)
+     */
+    static findLanguagesByName(partialName: string): readonly LanguageDefinition[];
+    /**
+     * Clear all registered languages (useful for testing)
+     */
+    static clear(): void;
+}
+/**
+ * Validation result for language operations
+ */
+export interface LanguageValidationResult {
+    readonly isValid: boolean;
+    readonly missingLanguages: readonly string[];
+    readonly errors: readonly string[];
+}
+/**
+ * Helper function to create language definitions with type safety
+ */
+export declare function createLanguageDefinition(id: string, name: string, code: string, isDefault?: boolean): LanguageDefinition;
+/**
+ * Helper function to create multiple language definitions
+ */
+export declare function createLanguageDefinitions(languages: Array<{
+    id: string;
+    name: string;
+    code: string;
+    isDefault?: boolean;
+}>): LanguageDefinition[];
+//# sourceMappingURL=language-registry.d.ts.map

package/src/language-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-registry.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/language-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAyC;IACjE,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA6B;IAC5D,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAuB;IAEvD,OAAO;IAIP;;OAEG;WACW,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAgClE;;OAEG;WACW,iBAAiB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAM/E;;OAEG;WACW,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI7E;;OAEG;WACW,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAK7E;;OAEG;WACW,eAAe,IAAI,aAAa,CAAC,kBAAkB,CAAC;IAIlE;;OAEG;WACW,cAAc,IAAI,SAAS,MAAM,EAAE;IAIjD;;OAEG;WACW,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAInD;;OAEG;WACW,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAItD;;OAEG;WACW,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpD;;OAEG;WACW,kBAAkB,IAAI,kBAAkB,GAAG,IAAI;IAM7D;;OAEG;WACW,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAInD;;;;;OAKG;WACW,uBAAuB,CACnC,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM;IAwBT;;OAEG;WACW,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAW1D;;OAEG;WACW,gBAAgB,IAAI,MAAM;IAIxC;;OAEG;WACW,yBAAyB,CACrC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,wBAAwB;IAkB3B;;OAEG;WACW,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ/D;;OAEG;WACW,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ9D;;OAEG;WACW,mBAAmB,CAC/B,WAAW,EAAE,MAAM,GAClB,SAAS,kBAAkB,EAAE;IAOhC;;OAEG;WACW,KAAK,IAAI,IAAI;CAK5B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,OAAO,GAClB,kBAAkB,CAOpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC,GACD,kBAAkB,EAAE,CAItB"}

package/src/language-registry.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Language registry for managing supported languages and their properties
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LanguageRegistry = void 0;
+exports.createLanguageDefinition = createLanguageDefinition;
+exports.createLanguageDefinitions = createLanguageDefinitions;
+const registry_error_1 = require("./registry-error");
+const registry_error_type_1 = require("./registry-error-type");
+/**
+ * Static singleton registry for managing supported languages globally
+ */
+class LanguageRegistry {
+    static languages = new Map();
+    static languagesByCodes = new Map();
+    static defaultLanguageId = null;
+    constructor() {
+        // Private constructor - use static methods
+    }
+    /**
+     * Register a new language
+     */
+    static registerLanguage(language) {
+        const languageId = language.id;
+        // Check for duplicate language ID
+        if (LanguageRegistry.languages.has(languageId)) {
+            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.DuplicateLanguage, `Language '${languageId}' is already registered`, { languageId });
+        }
+        // Check for duplicate language code
+        if (LanguageRegistry.languagesByCodes.has(language.code)) {
+            const existingLanguageId = LanguageRegistry.languagesByCodes.get(language.code);
+            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.DuplicateLanguage, `Language code '${language.code}' is already used by language '${existingLanguageId}'`, { languageId, code: language.code, existingLanguageId });
+        }
+        // Register the language
+        LanguageRegistry.languages.set(languageId, language);
+        LanguageRegistry.languagesByCodes.set(language.code, languageId);
+        // Set as default if specified or if it's the first language
+        if (language.isDefault || LanguageRegistry.defaultLanguageId === null) {
+            LanguageRegistry.defaultLanguageId = languageId;
+        }
+    }
+    /**
+     * Register multiple languages at once
+     */
+    static registerLanguages(languages) {
+        for (const language of languages) {
+            LanguageRegistry.registerLanguage(language);
+        }
+    }
+    /**
+     * Get a language by its ID
+     */
+    static getLanguage(languageId) {
+        return LanguageRegistry.languages.get(languageId);
+    }
+    /**
+     * Get a language by its code
+     */
+    static getLanguageByCode(code) {
+        const languageId = LanguageRegistry.languagesByCodes.get(code);
+        return languageId ? LanguageRegistry.languages.get(languageId) : undefined;
+    }
+    /**
+     * Get all registered languages
+     */
+    static getAllLanguages() {
+        return Array.from(LanguageRegistry.languages.values());
+    }
+    /**
+     * Get all language IDs
+     */
+    static getLanguageIds() {
+        return Array.from(LanguageRegistry.languages.keys());
+    }
+    /**
+     * Get all language codes
+     */
+    static getLanguageCodes() {
+        return Array.from(LanguageRegistry.languagesByCodes.keys());
+    }
+    /**
+     * Check if a language is registered
+     */
+    static hasLanguage(languageId) {
+        return LanguageRegistry.languages.has(languageId);
+    }
+    /**
+     * Check if a language code is registered
+     */
+    static hasLanguageCode(code) {
+        return LanguageRegistry.languagesByCodes.has(code);
+    }
+    /**
+     * Get the default language
+     */
+    static getDefaultLanguage() {
+        return LanguageRegistry.defaultLanguageId
+            ? LanguageRegistry.languages.get(LanguageRegistry.defaultLanguageId) || null
+            : null;
+    }
+    /**
+     * Get the default language ID
+     */
+    static getDefaultLanguageId() {
+        return LanguageRegistry.defaultLanguageId;
+    }
+    /**
+     * Get matching language code with fallback logic:
+     * 1. Try requested code
+     * 2. Fall back to user default
+     * 3. Fall back to site default
+     */
+    static getMatchingLanguageCode(requestedCode, userDefaultCode) {
+        // Try requested code first
+        if (requestedCode && LanguageRegistry.hasLanguageCode(requestedCode)) {
+            return requestedCode;
+        }
+        // Try user default
+        if (userDefaultCode && LanguageRegistry.hasLanguageCode(userDefaultCode)) {
+            return userDefaultCode;
+        }
+        // Fall back to site default
+        const defaultLanguage = LanguageRegistry.getDefaultLanguage();
+        if (!defaultLanguage) {
+            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.LanguageNotFound, 'No default language configured', {});
+        }
+        return defaultLanguage.code;
+    }
+    /**
+     * Set the default language
+     */
+    static setDefaultLanguage(languageId) {
+        if (!LanguageRegistry.languages.has(languageId)) {
+            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.LanguageNotFound, `Language '${languageId}' not found`, { languageId });
+        }
+        LanguageRegistry.defaultLanguageId = languageId;
+    }
+    /**
+     * Get the number of registered languages
+     */
+    static getLanguageCount() {
+        return LanguageRegistry.languages.size;
+    }
+    /**
+     * Validate that all required languages are present
+     */
+    static validateRequiredLanguages(requiredLanguages) {
+        const missingLanguages = [];
+        const errors = [];
+        for (const languageId of requiredLanguages) {
+            if (!LanguageRegistry.languages.has(languageId)) {
+                missingLanguages.push(languageId);
+                errors.push(`Required language '${languageId}' is not registered`);
+            }
+        }
+        return {
+            isValid: missingLanguages.length === 0,
+            missingLanguages,
+            errors,
+        };
+    }
+    /**
+     * Create a mapping of language IDs to their display names
+     */
+    static getLanguageDisplayNames() {
+        const result = {};
+        for (const [languageId, language] of LanguageRegistry.languages) {
+            result[languageId] = language.name;
+        }
+        return result;
+    }
+    /**
+     * Create a mapping of language IDs to their codes
+     */
+    static getLanguageCodeMapping() {
+        const result = {};
+        for (const [languageId, language] of LanguageRegistry.languages) {
+            result[languageId] = language.code;
+        }
+        return result;
+    }
+    /**
+     * Find languages by partial name match (case-insensitive)
+     */
+    static findLanguagesByName(partialName) {
+        const searchTerm = partialName.toLowerCase();
+        return Array.from(LanguageRegistry.languages.values()).filter((language) => language.name.toLowerCase().includes(searchTerm));
+    }
+    /**
+     * Clear all registered languages (useful for testing)
+     */
+    static clear() {
+        LanguageRegistry.languages.clear();
+        LanguageRegistry.languagesByCodes.clear();
+        LanguageRegistry.defaultLanguageId = null;
+    }
+}
+exports.LanguageRegistry = LanguageRegistry;
+/**
+ * Helper function to create language definitions with type safety
+ */
+function createLanguageDefinition(id, name, code, isDefault) {
+    return {
+        id,
+        name,
+        code,
+        isDefault: isDefault || false,
+    };
+}
+/**
+ * Helper function to create multiple language definitions
+ */
+function createLanguageDefinitions(languages) {
+    return languages.map((lang) => createLanguageDefinition(lang.id, lang.name, lang.code, lang.isDefault));
+}
+//# sourceMappingURL=language-registry.js.map

package/src/language-registry.js.map

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

package/src/plugin-i18n-engine.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Plugin-based internationalization engine with component and language registration
+ */
+import { ComponentDefinition } from './component-definition';
+import { ComponentRegistration } from './component-registration';
+import { ComponentRegistry } from './component-registry';
+import { EnumTranslationRegistry } from './enum-registry';
+import { IActiveContext } from './active-context';
+import { LanguageDefinition } from './language-definition';
+import { RegistryConfig } from './registry-config';
+import { TranslationResponse } from './translation-response';
+import { EnumLanguageTranslation } from './types';
+/**
+ * Plugin-based I18n Engine with registration capabilities
+ */
+export declare class PluginI18nEngine<TLanguages extends string> {
+    private readonly componentRegistry;
+    private readonly enumRegistry;
+    private readonly config;
+    private contextKey;
+    /**
+     * Default template processor instance
+     */
+    readonly t: (str: string, language?: TLanguages, ...otherVars: Record<string, string | number>[]) => string;
+    /**
+     * Static instances for semi-singleton pattern
+     */
+    private static _instances;
+    private static _defaultKey;
+    protected static readonly DefaultInstanceKey = "default";
+    constructor(initialLanguages: readonly LanguageDefinition[], config?: Partial<RegistryConfig<TLanguages>>, options?: {
+        instanceKey?: string;
+        registerInstance?: boolean;
+        setAsDefault?: boolean;
+    });
+    /**
+     * Create a new instance with a specific key
+     */
+    static createInstance<TLangs extends string>(key: string, initialLanguages: readonly LanguageDefinition[], config?: Partial<RegistryConfig<TLangs>>): PluginI18nEngine<TLangs>;
+    /**
+     * Get an existing instance by key
+     */
+    static getInstance<TLangs extends string>(key?: string): PluginI18nEngine<TLangs>;
+    /**
+     * Register a new language (updates static registry)
+     */
+    registerLanguage(language: LanguageDefinition): void;
+    /**
+     * Register multiple languages (updates static registry)
+     */
+    registerLanguages(languages: readonly LanguageDefinition[]): void;
+    /**
+     * Register a component with its translations
+     */
+    registerComponent<TStringKeys extends string>(registration: ComponentRegistration<TStringKeys, TLanguages>): import("./validation-result").ValidationResult;
+    /**
+     * Update strings for an existing component
+     */
+    updateComponentStrings<TStringKeys extends string>(componentId: string, strings: Parameters<ComponentRegistry<TLanguages>['updateComponentStrings']>[1]): import("./validation-result").ValidationResult;
+    /**
+     * Register an enum with translations
+     */
+    registerEnum<TEnum extends string | number>(enumObj: Record<string, TEnum>, translations: EnumLanguageTranslation<TEnum, TLanguages>, enumName: string): void;
+    /**
+     * Translate a string for a component
+     */
+    translate<TStringKeys extends string>(componentId: string, stringKey: TStringKeys, variables?: Record<string, string | number>, language?: TLanguages): string;
+    /**
+     * Safe translate that returns a placeholder if translation fails
+     */
+    safeTranslate(componentId: string, stringKey: string, variables?: Record<string, string | number>, language?: TLanguages): string;
+    /**
+     * Translate an enum value
+     */
+    translateEnum<TEnum extends string | number>(enumObj: Record<string, TEnum>, value: TEnum, language?: TLanguages): string;
+    /**
+     * Get detailed translation response
+     */
+    getTranslationDetails<TStringKeys extends string>(componentId: string, stringKey: TStringKeys, variables?: Record<string, string | number>, language?: TLanguages): TranslationResponse;
+    /**
+     * Get current context
+     */
+    getContext(): IActiveContext<TLanguages>;
+    /**
+     * Update context
+     */
+    updateContext(updates: Partial<IActiveContext<TLanguages>>): void;
+    /**
+     * Get current language from global context
+     * Respects language context space (admin vs user)
+     */
+    private getCurrentLanguage;
+    /**
+     * Set current language
+     */
+    setLanguage(language: TLanguages): void;
+    /**
+     * Get available languages from static registry
+     */
+    getLanguages(): readonly LanguageDefinition[];
+    /**
+     * Get registered components
+     */
+    getComponents(): ReadonlyArray<ComponentDefinition<any>>;
+    /**
+     * Check if a component is registered
+     */
+    hasComponent(componentId: string): boolean;
+    /**
+     * Check if a language is registered in static registry
+     */
+    hasLanguage(language: TLanguages): boolean;
+    /**
+     * Get language by code from static registry
+     */
+    getLanguageByCode(code: string): LanguageDefinition | undefined;
+    /**
+     * Get component registry for direct access
+     */
+    getComponentRegistry(): ComponentRegistry<TLanguages>;
+    /**
+     * Get enum registry for direct access
+     */
+    getEnumRegistry(): EnumTranslationRegistry<string, TLanguages>;
+    /**
+     * Validate that all components have complete translations
+     */
+    validateAllComponents(): {
+        isValid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Clear all component registrations for this instance (useful for testing)
+     */
+    clearAllComponents(): void;
+    /**
+     * Remove a specific named instance
+     */
+    static removeInstance(key?: string): boolean;
+    /**
+     * Check if an instance exists
+     */
+    static hasInstance(key?: string): boolean;
+    /**
+     * Reset all plugin engines and clear component registrations
+     * Useful for test cleanup
+     */
+    static resetAll(): void;
+}
+//# sourceMappingURL=plugin-i18n-engine.d.ts.map

package/src/plugin-i18n-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-i18n-engine.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/plugin-i18n-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,qBAAa,gBAAgB,CAAC,UAAU,SAAS,MAAM;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAClE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAS;IAE3B;;OAEG;IACH,SAAgB,CAAC,EAAE,CACjB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,UAAU,EACrB,GAAG,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,KAC5C,MAAM,CAAC;IAIZ;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4C;IACrE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAuB;IACjD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,aAAa;gBAGvD,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,EAC/C,MAAM,GAAE,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAM,EAChD,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;IAkGH;;OAEG;WACW,cAAc,CAAC,MAAM,SAAS,MAAM,EAChD,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,EAC/C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GACvC,gBAAgB,CAAC,MAAM,CAAC;IAoC3B;;OAEG;WACW,WAAW,CAAC,MAAM,SAAS,MAAM,EAC7C,GAAG,CAAC,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,CAAC;IAkB3B;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAU3D;;OAEG;IACI,iBAAiB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAMxE;;OAEG;IACI,iBAAiB,CAAC,WAAW,SAAS,MAAM,EACjD,YAAY,EAAE,qBAAqB,CAAC,WAAW,EAAE,UAAU,CAAC;IAK9D;;OAEG;IACI,sBAAsB,CAAC,WAAW,SAAS,MAAM,EACtD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,CACjB,iBAAiB,CAAC,UAAU,CAAC,CAAC,wBAAwB,CAAC,CACxD,CAAC,CAAC,CAAC;IAKN;;OAEG;IACI,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9B,YAAY,EAAE,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC,EACxD,QAAQ,EAAE,MAAM,GACf,IAAI;IAIP;;OAEG;IACI,SAAS,CAAC,WAAW,SAAS,MAAM,EACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,WAAW,EACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,UAAU,GACpB,MAAM;IAYT;;OAEG;IACI,aAAa,CAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,UAAU,GACpB,MAAM;IAST;;OAEG;IACI,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,UAAU,GACpB,MAAM;IAQT;;OAEG;IACI,qBAAqB,CAAC,WAAW,SAAS,MAAM,EACrD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,WAAW,EACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,UAAU,GACpB,mBAAmB;IAWtB;;OAEG;IACI,UAAU,IAAI,cAAc,CAAC,UAAU,CAAC;IAK/C;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI;IAWxE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAY9C;;OAEG;IACI,YAAY,IAAI,SAAS,kBAAkB,EAAE;IAIpD;;OAEG;IACI,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAI/D;;OAEG;IACI,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO;IAIjD;;OAEG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAItE;;OAEG;IACI,oBAAoB,IAAI,iBAAiB,CAAC,UAAU,CAAC;IAI5D;;OAEG;IACI,eAAe,IAAI,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC;IAIrE;;OAEG;IACI,qBAAqB,IAAI;QAC9B,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;IA2CD;;OAEG;IACI,kBAAkB,IAAI,IAAI;IAIjC;;OAEG;WACW,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAYnD;;OAEG;WACW,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAKhD;;;OAGG;WACW,QAAQ,IAAI,IAAI;CAU/B"}