playlist-data-engine 1.1.0

package/dist/core/features/FeatureQuery.d.ts

@@ -0,0 +1,368 @@
+/**
+ * FeatureQuery
+ *
+ * Central query interface for class features and racial traits.
+ * Provides default and custom features with prerequisite validation.
+ *
+ * **Design:** FeatureQuery provides query methods that read from ExtensionManager.
+ * All feature registration is done via ExtensionManager.register().
+ *
+ * This class provides:
+ * - Query methods with caching for performance
+ * - Feature-related helper methods
+ * - Prerequisite validation
+ *
+ * No duplicate storage - all data lives in ExtensionManager.
+ *
+ * **Note:** Both class features and racial traits read from ExtensionManager.
+ * To register new features, use ExtensionManager.register() directly.
+ */
+import type { ClassFeature, RacialTrait, ValidationResult } from './FeatureTypes.js';
+import type { Class, Race } from '../types/Character.js';
+import type { CharacterSheet } from '../types/Character.js';
+/**
+ * FeatureQuery - Singleton class for querying features and traits
+ *
+ * This is a query interface that reads from ExtensionManager.
+ * All class features and racial traits are stored in ExtensionManager; FeatureQuery provides:
+ * - Query methods with caching for performance
+ * - Feature-related helper methods
+ * - Prerequisite validation
+ *
+ * Design principle: No duplicate storage. All feature data lives in ExtensionManager.
+ * To register new features, use ExtensionManager.register() directly.
+ */
+export declare class FeatureQuery {
+    private static instance;
+    private manager;
+    private allClassFeaturesCache;
+    private classFeaturesIndex;
+    private allRacialTraitsCache;
+    private racialTraitsIndex;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): FeatureQuery;
+    /**
+     * Invalidate all caches
+     *
+     * This method is primarily for internal use and advanced scenarios.
+     *
+     * Call this method after directly manipulating ExtensionManager's data
+     * (e.g., after calling ExtensionManager.resetAll()).
+     *
+     * This ensures that FeatureQuery's cached data is refreshed to reflect
+     * the current state of ExtensionManager.
+     */
+    invalidateCache(): void;
+    /**
+     * Get all class features as an array
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @returns Array of all class features
+     */
+    private getAllClassFeaturesArray;
+    /**
+     * Get all racial traits as an array
+     *
+     * Reads from ExtensionManager with caching.
+     * Aggregates traits from both the general 'racialTraits' category and
+     * all race-specific categories (e.g., 'racialTraits.Elf', 'racialTraits.Dragonkin').
+     *
+     * @returns Array of all racial traits
+     */
+    private getAllRacialTraitsArray;
+    /**
+     * Get all features for a class at a specific level
+     *
+     * Returns all features the character would have at the given level,
+     * including features from lower levels.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param className - Class to get features for
+     * @param level - Character level (1-20)
+     * @returns Array of class features
+     */
+    getClassFeatures(className: Class, level: number): ClassFeature[];
+    /**
+     * Get features gained at a specific level for a class
+     *
+     * Returns only the features gained at exactly this level.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param className - Class to get features for
+     * @param level - Level to check
+     * @returns Array of class features
+     */
+    getFeaturesForLevel(className: Class, level: number): ClassFeature[];
+    /**
+     * Alias for getFeaturesForLevel for API compatibility
+     *
+     * @param className - Class to get features for
+     * @param level - Level to check
+     * @returns Array of class features
+     */
+    getClassFeaturesForLevel(className: Class, level: number): ClassFeature[];
+    /**
+     * Get a single class feature by ID
+     *
+     * Reads from ExtensionManager.
+     *
+     * @param featureId - Feature ID to look up
+     * @returns Class feature or undefined if not found
+     */
+    getClassFeatureById(featureId: string): ClassFeature | undefined;
+    /**
+     * Get all class features organized by class
+     *
+     * Returns a Map where keys are class names and values are arrays
+     * of all features for that class.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @returns Map of class names to their features
+     */
+    getAllClassFeatures(): Map<string, ClassFeature[]>;
+    /**
+     * Get all racial traits for a race
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param race - Race to get traits for
+     * @returns Array of racial traits
+     */
+    getRacialTraits(race: Race): RacialTrait[];
+    /**
+     * Get only base racial traits (excluding subrace-specific traits)
+     *
+     * Returns traits that apply to all members of a race, regardless of subrace.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param race - Race to get base traits for
+     * @returns Array of base racial traits
+     */
+    getBaseRacialTraits(race: Race): RacialTrait[];
+    /**
+     * Get racial traits for a specific subrace
+     *
+     * Returns base traits for the race plus subrace-specific traits.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param race - Base race
+     * @param subrace - Subrace name
+     * @returns Array of racial traits for the subrace
+     */
+    getRacialTraitsForSubrace(race: Race, subrace: string): RacialTrait[];
+    /**
+     * Get only subrace-specific traits
+     *
+     * Returns only traits that specifically apply to the given subrace.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param race - Base race
+     * @param subrace - Subrace name
+     * @returns Array of subrace-specific traits
+     */
+    getSubraceTraits(race: Race, subrace: string): RacialTrait[];
+    /**
+     * Get all available subraces for a race
+     *
+     * Returns a unique list of subrace names for the given race.
+     * First checks RACE_DATA for a defined subraces list, then falls back
+     * to deriving subraces from registered racial traits (for custom content).
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @param race - Race to get subraces for
+     * @returns Array of unique subrace names
+     */
+    getAvailableSubraces(race: Race): string[];
+    /**
+     * Find the race associated with a given subrace
+     *
+     * Searches through all registered racial traits to find which race
+     * has traits with the specified subrace. Returns undefined if the
+     * subrace is not found in any race's traits.
+     *
+     * Reads from ExtensionManager.
+     *
+     * @param subrace - Subrace name to look up
+     * @returns Race that has this subrace, or undefined if not found
+     */
+    getRaceForSubrace(subrace: string): Race | undefined;
+    /**
+     * Get a single racial trait by ID
+     *
+     * Reads from ExtensionManager.
+     *
+     * @param traitId - Trait ID to look up
+     * @returns Racial trait or undefined if not found
+     */
+    getRacialTraitById(traitId: string): RacialTrait | undefined;
+    /**
+     * Get all racial traits organized by race
+     *
+     * Returns a Map where keys are race names and values are arrays
+     * of all traits for that race.
+     *
+     * Reads from ExtensionManager with caching.
+     *
+     * @returns Map of race names to their traits
+     */
+    getAllRacialTraits(): Map<string, RacialTrait[]>;
+    /**
+     * Validate feature prerequisites against a character
+     *
+     * Checks if the character meets all requirements for a feature or trait.
+     *
+     * @param feature - Feature or trait to validate
+     * @param character - Character sheet to validate against
+     * @returns Validation result with unmet prerequisites if any
+     */
+    validatePrerequisites(feature: ClassFeature | RacialTrait, character: CharacterSheet): ValidationResult;
+    /**
+     * Validate class feature prerequisites against a character
+     *
+     * Alias for validatePrerequisites with type safety for ClassFeature.
+     *
+     * @param feature - Class feature to validate
+     * @param character - Character sheet to validate against
+     * @returns Validation result with unmet prerequisites if any
+     */
+    validateFeaturePrerequisites(feature: ClassFeature, character: CharacterSheet): ValidationResult;
+    /**
+     * Validate racial trait prerequisites against a character
+     *
+     * Alias for validatePrerequisites with type safety for RacialTrait.
+     *
+     * @param trait - Racial trait to validate
+     * @param character - Character sheet to validate against
+     * @returns Validation result with unmet prerequisites if any
+     */
+    validateTraitPrerequisites(trait: RacialTrait, character: CharacterSheet): ValidationResult;
+    /**
+     * Get all feature IDs a character currently has
+     *
+     * Helper method for prerequisite validation.
+     *
+     * @param character - Character sheet
+     * @returns Array of feature IDs
+     */
+    private getCharacterFeatureIds;
+    /**
+     * Check if a character can gain a feature
+     *
+     * Convenience method that validates prerequisites and returns boolean.
+     *
+     * @param feature - Feature or trait to check
+     * @param character - Character sheet
+     * @returns True if character meets all prerequisites
+     */
+    canGainFeature(feature: ClassFeature | RacialTrait, character: CharacterSheet): boolean;
+    /**
+     * Check if a character meets the prerequisites for a feature
+     *
+     * Alias for canGainFeature() for API compatibility with documentation.
+     *
+     * @param feature - Feature or trait to check
+     * @param character - Character sheet
+     * @returns True if character meets all prerequisites
+     */
+    meetsPrerequisites(feature: ClassFeature | RacialTrait, character: CharacterSheet): boolean;
+    /**
+     * Get all classes that have features registered
+     *
+     * Reads from ExtensionManager.
+     *
+     * @returns Array of class names
+     */
+    getRegisteredClasses(): Class[];
+    /**
+     * Get all races that have traits registered
+     *
+     * Reads from ExtensionManager.
+     *
+     * @returns Array of race names
+     */
+    getRegisteredRaces(): Race[];
+    /**
+     * Get total count of registered features
+     *
+     * Reads from ExtensionManager for both class features and racial traits.
+     *
+     * @returns Object with counts
+     */
+    getQueryStats(): {
+        totalClassFeatures: number;
+        totalRacialTraits: number;
+        classesWithFeatures: number;
+        racesWithTraits: number;
+    };
+    /**
+     * Clear the query cache and reset ExtensionManager data
+     *
+     * Clears all registered features and traits from ExtensionManager.
+     * Useful for testing or reinitialization.
+     */
+    clearQueryCache(): void;
+    /**
+     * Check if the registry has been initialized
+     *
+     * Checks ExtensionManager for racial traits data.
+     *
+     * @returns True if initialized with defaults
+     */
+    isInitialized(): boolean;
+    /**
+     * Get features granted by equipment
+     *
+     * Equipment features are features that can be granted by equipping items.
+     * Features with spawnWeight: 0 are still valid for equipment use.
+     *
+     * Note: This method returns all features that can be granted by equipment.
+     * To get features for a specific equipment item, use ExtensionManager
+     * to retrieve the equipment definition and check its grantsFeatures property.
+     *
+     * @param equipmentName - Name of the equipment piece (reserved for future use)
+     * @returns Array of features that can be granted by equipment
+     */
+    static getEquipmentFeatures(equipmentName: string): ClassFeature[];
+    /**
+     * Check if a feature can be granted by equipment
+     *
+     * Features with spawnWeight: 0 are still valid for equipment.
+     * This method checks if a feature ID exists in the registry and can be
+     * referenced by equipment definitions.
+     *
+     * @param featureId - Feature ID to check
+     * @returns True if the feature exists and can be granted by equipment
+     */
+    static isValidEquipmentFeature(featureId: string): boolean;
+    /**
+     * Get all racial traits as a plain object (for debugging/serialization)
+     *
+     * Note: For both class features and racial traits, use ExtensionManager.get() directly.
+     * This method is kept for API compatibility.
+     *
+     * Reads from ExtensionManager.
+     *
+     * @returns Object mapping race names to their traits
+     */
+    exportRacialTraits(): Record<string, RacialTrait[]>;
+}
+/**
+ * Get the global FeatureQuery instance
+ *
+ * Convenience function for accessing the singleton.
+ *
+ * @returns FeatureQuery instance
+ */
+export declare function getFeatureQuery(): FeatureQuery;
+//# sourceMappingURL=FeatureQuery.d.ts.map

package/dist/core/features/FeatureQuery.d.ts.map

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

package/dist/core/features/FeatureTypes.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Feature Type Definitions
+ *
+ * Defines the interfaces for custom class features and racial traits.
+ *
+ * These interfaces allow for:
+ * - Extensible feature definitions with prerequisites
+ * - Feature effects (stat bonuses, skill proficiencies, ability unlocks)
+ * - Integration with FeatureQuery for runtime customization
+ */
+import type { Class, Race, Ability } from '../types/Character.js';
+/**
+ * Feature effect types that modify character capabilities
+ *
+ * - stat_bonus: Add to an ability score (e.g., +1 STR)
+ * - skill_proficiency: Grant proficiency or expertise in a skill
+ * - ability_unlock: Unlock a new ability (e.g., flight, darkvision)
+ * - passive_modifier: Add a constant modifier to rolls (e.g., +1 damage)
+ * - resource_grant: Grant a resource pool (e.g., rage counts, ki points)
+ * - spell_slot_bonus: Grant additional spell slots
+ */
+export type FeatureEffectType = 'stat_bonus' | 'skill_proficiency' | 'ability_unlock' | 'passive_modifier' | 'resource_grant' | 'spell_slot_bonus';
+/**
+ * Feature effect that applies a mechanical benefit
+ *
+ * Effects are applied when a character gains a feature or trait.
+ * Multiple effects can be combined for complex features.
+ */
+export interface FeatureEffect {
+    /** Type of effect to apply */
+    type: FeatureEffectType;
+    /** Target stat, skill, or ability this affects */
+    target: string;
+    /** Value to apply (number for bonuses, string for unlocks, boolean for flags) */
+    value: number | string | boolean;
+    /** Optional condition for when this effect applies (e.g., "while raging") */
+    condition?: string;
+    /** Optional description of this specific effect */
+    description?: string;
+}
+/**
+ * Prerequisites for gaining a feature or trait
+ *
+ * Features can require:
+ * - A minimum character level
+ * - Other features to be learned first (chains)
+ * - Minimum ability scores
+ * - Specific class or race
+ * - Skills that must be proficient first
+ * - Spells that must be known first
+ * - Custom conditions
+ */
+export interface FeaturePrerequisite {
+    /** Minimum level required (default: 1) */
+    level?: number;
+    /** Features that must be learned first (by ID) */
+    features?: string[];
+    /** Minimum ability scores required */
+    abilities?: Partial<Record<Ability, number>>;
+    /** Specific class required (for multi-class features) */
+    class?: Class;
+    /** Specific race required */
+    race?: Race;
+    /** Specific subrace required (e.g., 'High Elf', 'Hill Dwarf') */
+    subrace?: string;
+    /** Skills that must be proficient first (by skill ID) */
+    skills?: string[];
+    /** Spells that must be known first (by spell name) */
+    spells?: string[];
+    /** Custom condition description (for manual validation) */
+    custom?: string;
+}
+/**
+ * Feature type classification
+ *
+ * - passive: Always active, no action required (e.g., damage resistance)
+ * - active: Requires an action or bonus action to use (e.g., Second Wind)
+ * - resource: Grants a resource pool to spend (e.g., Ki Points, Rage)
+ * - trigger: Automatic but conditional (e.g., Sneak Attack when conditions met)
+ */
+export type FeatureType = 'passive' | 'active' | 'resource' | 'trigger';
+/**
+ * Source of the feature definition
+ *
+ * - default: Built-in D&D 5e feature from the base game
+ * - custom: User-created or expansion pack content
+ */
+export type FeatureSource = 'default' | 'custom';
+/**
+ * Complete definition of a class feature
+ *
+ * Features are abilities gained as a character levels up in their class.
+ * Examples: Rage, Extra Attack, Metamagic, Unleash Incarnation
+ */
+export interface ClassFeature {
+    /** Unique identifier for this feature (e.g., 'barbarian_rage', 'fighter_action_surge') */
+    id: string;
+    /** Display name shown to players */
+    name: string;
+    /** Detailed description of what the feature does */
+    description: string;
+    /** Type of feature (determines how it's used) */
+    type: FeatureType;
+    /** Character class this feature belongs to */
+    class: Class;
+    /** Level at which this feature is gained */
+    level: number;
+    /** Prerequisites that must be met to gain this feature */
+    prerequisites?: FeaturePrerequisite;
+    /** Effects applied when this feature is gained */
+    effects?: FeatureEffect[];
+    /** Whether this feature is built-in or custom */
+    source: FeatureSource;
+    /** Optional tags for filtering/categorizing (e.g., ['melee', 'damage']) */
+    tags?: string[];
+    /** Optional flavor text or lore */
+    lore?: string;
+    /** Optional icon URL for small UI display */
+    icon?: string;
+    /** Optional image URL for larger display */
+    image?: string;
+}
+/**
+ * Complete definition of a racial trait
+ *
+ * Traits are innate abilities granted by a character's race.
+ * Examples: Darkvision, Fey Ancestry, Bravery, Stonecunning
+ */
+export interface RacialTrait {
+    /** Unique identifier for this trait (e.g., 'elf_darkvision', 'dwarf_dwarven_resilience') */
+    id: string;
+    /** Display name shown to players */
+    name: string;
+    /** Detailed description of what the trait does */
+    description: string;
+    /** Race this trait belongs to */
+    race: Race;
+    /** Optional subrace requirement (e.g., 'High Elf', 'Hill Dwarf') */
+    subrace?: string;
+    /** Prerequisites that must be met */
+    prerequisites?: FeaturePrerequisite;
+    /** Effects applied when this trait is gained (usually at character creation) */
+    effects?: FeatureEffect[];
+    /** Whether this trait is built-in or custom */
+    source: FeatureSource;
+    /** Optional tags for filtering/categorizing */
+    tags?: string[];
+    /** Optional flavor text or lore */
+    lore?: string;
+    /** Optional icon URL for small UI display */
+    icon?: string;
+    /** Optional image URL for larger display */
+    image?: string;
+}
+/**
+ * Feature entry for character storage
+ *
+ * When stored on a CharacterSheet, features are tracked by ID
+ * along with any dynamic state (uses remaining, choices made, etc.)
+ */
+export interface CharacterFeature {
+    /** ID of the feature from the registry */
+    featureId: string;
+    /** Display name (cached for quick access) */
+    name: string;
+    /** Level at which this feature was gained */
+    gainedAtLevel: number;
+    /** Source of the feature */
+    source: FeatureSource;
+    /** Dynamic state for resource features (e.g., { uses: 3, maxUses: 3 }) */
+    state?: Record<string, number | boolean | string>;
+    /** Choices made for features with options (e.g., chosen Fighting Style) */
+    choices?: Record<string, string | number | boolean>;
+}
+/**
+ * Trait entry for character storage
+ *
+ * Similar to CharacterFeature but for racial traits
+ */
+export interface CharacterTrait {
+    /** ID of the trait from the registry */
+    traitId: string;
+    /** Display name (cached for quick access) */
+    name: string;
+    /** Whether this is a default trait or custom */
+    source: FeatureSource;
+}
+/**
+ * Validation result for feature prerequisites
+ */
+export interface ValidationResult {
+    /** Whether all prerequisites are met */
+    valid: boolean;
+    /** Array of prerequisite descriptions that are not met */
+    unmet?: string[];
+    /** Detailed error messages */
+    errors?: string[];
+}
+//# sourceMappingURL=FeatureTypes.d.ts.map

package/dist/core/features/FeatureTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureTypes.d.ts","sourceRoot":"","sources":["../../../src/core/features/FeatureTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GACvB,YAAY,GACZ,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IAExB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IAEf,iFAAiF;IACjF,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAEjC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAChC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7C,yDAAyD;IACzD,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,6BAA6B;IAC7B,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAExE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,0FAA0F;IAC1F,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,IAAI,EAAE,WAAW,CAAC;IAElB,8CAA8C;IAC9C,KAAK,EAAE,KAAK,CAAC;IAEb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IAEd,0DAA0D;IAC1D,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,kDAAkD;IAClD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAE1B,iDAAiD;IACjD,MAAM,EAAE,aAAa,CAAC;IAEtB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,4FAA4F;IAC5F,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,IAAI,EAAE,IAAI,CAAC;IAEX,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,gFAAgF;IAChF,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAE1B,+CAA+C;IAC/C,MAAM,EAAE,aAAa,CAAC;IAEtB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IAEtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAElD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,gDAAgD;IAChD,MAAM,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IAEf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}