homebridge-tsvesync 1.0.7 → 1.0.10

package/.cursorrules

@@ -0,0 +1,177 @@
+You are a senior TypeScript programmer with preference for clean programming and design patterns.Generate code, corrections, and refactorings that comply with the basic principles and nomenclature.
+
+TypeScript and Homebridge Plugin Development Guidelines
+
+General TypeScript Guidelines
+
+Core Principles
+	•	Language and Documentation: All code and documentation must be written in English.
+	•	Type Safety: Types must be explicitly declared for all variables and functions, including parameters and return values.
+	•	Avoid any: Refrain from using the any type. Create specific types when necessary to ensure type safety.
+	•	Documentation: Document all public classes and methods using JSDoc to enhance readability and maintainability.
+	•	Code Structure: Maintain a clean code structure without blank lines within functions to ensure concise and readable code.
+	•	Export Strategy: Follow the single export per file principle to promote modularity and clarity.
+
+Naming Conventions
+
+Case Styles
+	•	Classes: Use PascalCase for class names (e.g., LightAccessory).
+	•	Variables, Functions, and Methods: Use camelCase for naming (e.g., isConnected, initializeDevice).
+	•	Files and Directories: Use kebab-case for file and directory names (e.g., light-accessory.ts).
+	•	Environment Variables: Use UPPERCASE for environment variable names (e.g., HOMEKIT_PIN).
+
+Naming Rules
+	•	Avoid Magic Numbers: Replace magic numbers with named constants to improve code clarity (e.g., const DEFAULT_BRIGHTNESS = 100;).
+	•	Function Names: Begin all function names with a verb to indicate action (e.g., getStatus, setBrightness).
+	•	Boolean Variables: Use verb prefixes for boolean variables to clearly indicate their purpose (e.g., isOnline, hasError, canUpdate).
+	•	Use Complete Words: Prefer complete words over abbreviations, except for:
+	•	Standard Terms: Such as API, URL, etc.
+	•	Common Programming Abbreviations:
+	•	i, j for loop iterators
+	•	err for errors
+	•	ctx for contexts
+
+Function Guidelines
+
+General Rules
+	•	Conciseness: Keep functions concise and focused, ideally under 20 instructions.
+	•	Naming: Use verb-noun combinations for function names to clearly describe their actions (e.g., fetchDeviceStatus, updateFirmware).
+	•	Return Type Prefixes:
+	•	Boolean Returns: Use prefixes like isX, hasX, canX (e.g., isConnected).
+	•	Void Returns: Use prefixes like executeX, saveX (e.g., executeCommand).
+
+Best Practices
+	•	Minimize Nesting:
+	•	Utilize early returns and validation checks to reduce nested code blocks.
+	•	Extract utility functions to handle repetitive tasks.
+	•	Higher-Order Functions: Leverage higher-order functions such as map, filter, and reduce for data transformations.
+	•	Arrow Functions: Implement arrow functions for simple operations with fewer than three instructions.
+	•	Named Functions: Use named functions for more complex operations to enhance readability and debuggability.
+	•	Default Parameters: Set default parameter values instead of performing null checks within functions.
+	•	RO-RO Principle:
+	•	Receive Object: Accept objects when a function requires multiple parameters.
+	•	Return Object: Return objects when a function needs to provide multiple values.
+	•	Abstraction Levels: Maintain a single level of abstraction within functions to ensure clarity and simplicity.
+
+Data Management
+	•	Composite Types: Encapsulate data within composite types (e.g., interfaces, classes) rather than using primitive types directly.
+	•	Internal Validation: Use classes with internal validation logic instead of standalone validation functions to ensure data integrity.
+	•	Immutability:
+	•	Use readonly for static properties to prevent modification.
+	•	Use as const for immutable literals to enforce constant values.
+
+Class Design
+
+SOLID Guidelines
+	•	SOLID Principles: Adhere to SOLID principles to create robust and maintainable classes.
+	•	Composition Over Inheritance: Favor composition to build complex functionalities from simpler components rather than relying heavily on inheritance.
+	•	Interface Contracts: Define clear contracts through interfaces to ensure consistent implementation and facilitate testing.
+
+Size Constraints
+	•	Manageable Classes:
+	•	Limit classes to a maximum of 200 instructions to maintain readability.
+	•	Restrict to a maximum of 10 public methods to ensure focused responsibilities.
+	•	Limit to a maximum of 10 properties to avoid complexity.
+
+Error Handling
+	•	Use Exceptions: Employ exceptions for unexpected error scenarios to manage unexpected states gracefully.
+	•	Exception Handling Practices:
+	•	Address anticipated issues with appropriate error messages.
+	•	Provide additional context to errors to aid in debugging.
+	•	Defer to global error handlers when suitable to centralize error management.
+
+Testing Practices
+
+General Testing
+	•	Testing Structure: Organize tests using the Arrange-Act-Assert pattern to ensure clarity and consistency.
+	•	Naming Conventions: Use clear and descriptive variable names in tests, such as inputData, mockDevice, actualResult, expectedOutcome.
+	•	Unit Tests: Write unit tests for all public functions to verify their behavior in isolation.
+	•	Test Doubles: Implement test doubles (mocks, stubs) for dependencies to isolate units under test, except for lightweight third-party dependencies.
+	•	Acceptance Tests: Create acceptance tests per module using the Given-When-Then format to validate end-to-end functionality.
+
+Homebridge Plugin Specific Guidelines
+
+Architectural Structure
+
+Plugin Organization
+	•	Modular Architecture: Implement a modular architecture to separate concerns and enhance maintainability.
+	•	Plugin Structure: Structure your Homebridge plugin with clear directories and files, such as:
+	•	Accessories: Define accessory classes that represent HomeKit accessories.
+	•	Services: Implement services that handle specific functionalities of accessories.
+	•	Types: Define TypeScript types and interfaces for strong type safety.
+	•	Utils: Include utility functions and helpers for common tasks.
+	•	Main Entry Point: Create a single entry point file (e.g., index.ts) that registers the plugin with Homebridge.
+
+Core Components
+	•	Accessory Classes:
+	•	Extend Homebridge’s AccessoryPlugin interface to create custom accessories.
+	•	Implement required methods like getServices to define the services provided by the accessory.
+	•	Service Implementations:
+	•	Utilize Homebridge’s built-in services or create custom services as needed.
+	•	Implement characteristics with appropriate getters and setters to interact with HomeKit.
+	•	Configuration Management:
+	•	Define clear and validated configuration schemas using class-validator or similar libraries.
+	•	Provide default configurations where applicable to simplify setup.
+
+Shared Resources
+	•	Utility Functions: Place common utility functions in a shared directory to promote reusability.
+	•	Common Business Logic: Encapsulate shared business logic in separate modules to avoid duplication and enhance clarity.
+
+Best Practices
+	•	Domain-Specific Modules: Keep modules focused on specific domains or functionalities to maintain clarity and separation of concerns.
+	•	DTO Validation: Implement robust validation at the Data Transfer Object (DTO) level to ensure incoming configurations and data are valid.
+	•	Separation of Concerns: Maintain a clear separation between different parts of the plugin, such as configuration handling, accessory management, and service implementation.
+	•	Dependency Injection: Follow Homebridge’s patterns for dependency injection to manage dependencies efficiently and promote testability.
+	•	Appropriate Decorators: Use TypeScript decorators where applicable to enhance code readability and functionality, such as for dependency injection or metadata definition.
+
+Integration with Homebridge APIs
+	•	Homebridge Interfaces: Utilize Homebridge’s provided interfaces and classes to ensure compatibility and leverage built-in functionalities.
+	•	Event Handling: Implement event listeners for Homebridge events to respond to changes in accessory states or HomeKit interactions.
+	•	Asynchronous Operations: Handle asynchronous operations using async/await to maintain readability and manage promises effectively.
+	•	Logging: Use Homebridge’s logging mechanisms to provide meaningful logs for debugging and monitoring plugin behavior.
+
+Plugin Registration
+	•	Registering Accessories: Ensure all accessories are properly registered with Homebridge using the api.registerAccessory method.
+	•	Plugin Metadata: Define clear and accurate metadata in the package.json file, including name, version, description, and dependencies.
+	•	Compatibility: Ensure compatibility with the latest Homebridge versions and adhere to any API changes or deprecations.
+
+Configuration Handling
+	•	Schema Definitions: Define clear configuration schemas using TypeScript interfaces and validate configurations during plugin initialization.
+	•	Default Values: Provide sensible default values for configuration options to simplify user setup and prevent errors.
+	•	Error Reporting: Report configuration errors clearly to guide users in correcting their setup.
+
+Performance Considerations
+	•	Efficient Code: Write efficient code to minimize the performance impact on Homebridge and ensure responsive interactions with HomeKit.
+	•	Resource Management: Manage resources effectively, such as network connections or file handles, to prevent leaks and ensure stability.
+	•	Asynchronous Operations: Optimize asynchronous operations to prevent blocking the event loop and maintain plugin responsiveness.
+
+Security Practices
+	•	Input Validation: Rigorously validate all inputs and configurations to prevent security vulnerabilities.
+	•	Sensitive Data Handling: Handle sensitive data, such as credentials, securely by using environment variables or secure storage mechanisms.
+	•	Dependency Management: Regularly update dependencies to address security vulnerabilities and maintain plugin integrity.
+
+Example Directory Structure
+
+homebridge-plugin/
+├── src/
+│   ├── accessories/
+│   │   └── LightAccessory.ts
+│   ├── services/
+│   │   └── LightService.ts
+│   ├── types/
+│   │   └── Config.ts
+│   ├── utils/
+│   │   └── logger.ts
+│   └── index.ts
+├── tests/
+│   ├── accessories/
+│   │   └── LightAccessory.test.ts
+│   └── services/
+│       └── LightService.test.ts
+├── package.json
+├── tsconfig.json
+└── README.md
+
+Conclusion
+
+Adhering to these TypeScript and Homebridge plugin development guidelines will ensure the creation of robust, maintainable, and high-quality plugins. Emphasizing type safety, clean code principles, modular architecture, and thorough testing will contribute to a seamless integration with Homebridge and a reliable user experience.

package/README.md

@@ -118,7 +118,9 @@ Add the following to your Homebridge `config.json`:
             "platform": "TSVESyncPlatform",
             "name": "TSVESync",
             "username": "YOUR_VESYNC_EMAIL",
-            "password": "YOUR_VESYNC_PASSWORD"
+            "password": "YOUR_VESYNC_PASSWORD",
+            "updateInterval": 30,
+            "debug": false
         }
     ]
 }

package/dist/accessories/air-purifier.accessory.d.ts

@@ -0,0 +1,25 @@
+import { PlatformAccessory } from 'homebridge';
+import { BaseAccessory } from './base.accessory';
+import { TSVESyncPlatform } from '../platform';
+import { DeviceCapabilities, VeSyncAirPurifier } from '../types/device.types';
+export declare class AirPurifierAccessory extends BaseAccessory {
+    protected readonly device: VeSyncAirPurifier;
+    constructor(platform: TSVESyncPlatform, accessory: PlatformAccessory, device: VeSyncAirPurifier);
+    protected setupService(): void;
+    protected updateDeviceSpecificStates(details: any): void;
+    protected getDeviceCapabilities(): DeviceCapabilities;
+    private getActive;
+    private setActive;
+    private getCurrentAirPurifierState;
+    private getTargetAirPurifierState;
+    private setTargetAirPurifierState;
+    private getAirQuality;
+    private getPM25Density;
+    private getRotationSpeed;
+    private setRotationSpeed;
+    private getLockPhysicalControls;
+    private setLockPhysicalControls;
+    private getFilterChangeIndication;
+    private getFilterLifeLevel;
+}
+//# sourceMappingURL=air-purifier.accessory.d.ts.map

package/dist/accessories/air-purifier.accessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"air-purifier.accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/air-purifier.accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;gBAG3C,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,iBAAiB;IAM3B,SAAS,CAAC,YAAY,IAAI,IAAI;IAmF9B,SAAS,CAAC,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IA0DxD,SAAS,CAAC,qBAAqB,IAAI,kBAAkB;YAcvC,SAAS;YAIT,SAAS;YAeT,0BAA0B;YAI1B,yBAAyB;YAIzB,yBAAyB;YAezB,aAAa;YAMb,cAAc;YAMd,gBAAgB;YAOhB,gBAAgB;YAehB,uBAAuB;YAIvB,uBAAuB;YAmBvB,yBAAyB;YAIzB,kBAAkB;CAGjC"}

package/dist/accessories/air-purifier.accessory.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirPurifierAccessory = void 0;
+const base_accessory_1 = require("./base.accessory");
+class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
+    constructor(platform, accessory, device) {
+        super(platform, accessory, device);
+        this.device = device;
+    }
+    setupService() {
+        // Get or create the air purifier service
+        this.service = this.accessory.getService(this.platform.Service.AirPurifier) ||
+            this.accessory.addService(this.platform.Service.AirPurifier);
+        // Set up required characteristics
+        this.setupCharacteristic(this.platform.Characteristic.Active, this.getActive.bind(this), this.setActive.bind(this));
+        this.setupCharacteristic(this.platform.Characteristic.CurrentAirPurifierState, this.getCurrentAirPurifierState.bind(this));
+        this.setupCharacteristic(this.platform.Characteristic.TargetAirPurifierState, this.getTargetAirPurifierState.bind(this), this.setTargetAirPurifierState.bind(this));
+        // Set up optional characteristics based on device capabilities
+        const capabilities = this.getDeviceCapabilities();
+        if (capabilities.hasAirQuality) {
+            // Create a separate Air Quality service for air quality characteristics
+            const airQualityService = this.accessory.getService(this.platform.Service.AirQualitySensor) ||
+                this.accessory.addService(this.platform.Service.AirQualitySensor);
+            // Add air quality characteristics to the Air Quality service
+            this.setupCharacteristic(this.platform.Characteristic.AirQuality, this.getAirQuality.bind(this), undefined, undefined, airQualityService);
+            this.setupCharacteristic(this.platform.Characteristic.PM2_5Density, this.getPM25Density.bind(this), undefined, undefined, airQualityService);
+        }
+        if (capabilities.hasSpeed) {
+            this.setupCharacteristic(this.platform.Characteristic.RotationSpeed, this.getRotationSpeed.bind(this), this.setRotationSpeed.bind(this));
+        }
+        if (capabilities.hasChildLock) {
+            this.setupCharacteristic(this.platform.Characteristic.LockPhysicalControls, this.getLockPhysicalControls.bind(this), this.setLockPhysicalControls.bind(this));
+        }
+        // Add filter maintenance characteristics
+        this.setupCharacteristic(this.platform.Characteristic.FilterChangeIndication, this.getFilterChangeIndication.bind(this));
+        this.setupCharacteristic(this.platform.Characteristic.FilterLifeLevel, this.getFilterLifeLevel.bind(this));
+        // Add Name characteristic
+        this.setupCharacteristic(this.platform.Characteristic.Name, async () => this.device.deviceName);
+    }
+    updateDeviceSpecificStates(details) {
+        const capabilities = this.getDeviceCapabilities();
+        if (capabilities.hasAirQuality) {
+            const airQualityService = this.accessory.getService(this.platform.Service.AirQualitySensor);
+            if (airQualityService && details.airQuality !== undefined && details.airQuality !== null) {
+                airQualityService.updateCharacteristic(this.platform.Characteristic.AirQuality, this.convertAirQualityToHomeKit(details.airQuality));
+                airQualityService.updateCharacteristic(this.platform.Characteristic.PM2_5Density, details.airQuality);
+            }
+        }
+        if (capabilities.hasSpeed && details.speed !== undefined && details.speed !== null) {
+            const normalizedSpeed = Math.min(Math.max((details.speed / (this.device.maxSpeed || 1)) * 100, 0), 100);
+            this.updateCharacteristicValue(this.platform.Characteristic.RotationSpeed, normalizedSpeed);
+        }
+        if (capabilities.hasChildLock && details.childLock !== undefined) {
+            this.updateCharacteristicValue(this.platform.Characteristic.LockPhysicalControls, details.childLock ? 1 : 0);
+        }
+        if (details.filterLife !== undefined && details.filterLife !== null) {
+            this.updateCharacteristicValue(this.platform.Characteristic.FilterChangeIndication, details.filterLife <= 20 ? 1 : 0);
+            this.updateCharacteristicValue(this.platform.Characteristic.FilterLifeLevel, details.filterLife);
+        }
+        // Update air purifier state
+        const isActive = details.deviceStatus === 'on';
+        this.updateCharacteristicValue(this.platform.Characteristic.Active, isActive ? 1 : 0);
+        this.updateCharacteristicValue(this.platform.Characteristic.CurrentAirPurifierState, isActive ? 2 : 0 // 0 = INACTIVE, 2 = PURIFYING_AIR
+        );
+    }
+    getDeviceCapabilities() {
+        return {
+            hasBrightness: false,
+            hasColorTemp: false,
+            hasColor: false,
+            hasSpeed: true,
+            hasHumidity: false,
+            hasAirQuality: true,
+            hasWaterLevel: false,
+            hasChildLock: true,
+            hasSwingMode: false,
+        };
+    }
+    async getActive() {
+        return this.device.deviceStatus === 'on' ? 1 : 0;
+    }
+    async setActive(value) {
+        try {
+            const isOn = value === 1;
+            const success = isOn ? await this.device.turnOn() : await this.device.turnOff();
+            if (!success) {
+                throw new Error(`Failed to turn ${isOn ? 'on' : 'off'} device`);
+            }
+            await this.persistDeviceState('deviceStatus', isOn ? 'on' : 'off');
+        }
+        catch (error) {
+            this.handleDeviceError('set active state', error);
+        }
+    }
+    async getCurrentAirPurifierState() {
+        return this.device.deviceStatus === 'on' ? 2 : 0; // 0 = INACTIVE, 2 = PURIFYING_AIR
+    }
+    async getTargetAirPurifierState() {
+        return this.device.mode === 'auto' ? 1 : 0; // 0 = MANUAL, 1 = AUTO
+    }
+    async setTargetAirPurifierState(value) {
+        try {
+            const mode = value === 1 ? 'auto' : 'manual';
+            const success = await this.device.setMode(mode);
+            if (!success) {
+                throw new Error(`Failed to set mode to ${mode}`);
+            }
+            await this.persistDeviceState('mode', mode);
+        }
+        catch (error) {
+            this.handleDeviceError('set target state', error);
+        }
+    }
+    async getAirQuality() {
+        return this.device.airQuality !== undefined && this.device.airQuality !== null
+            ? this.convertAirQualityToHomeKit(this.device.airQuality)
+            : 0;
+    }
+    async getPM25Density() {
+        return this.device.airQuality !== undefined && this.device.airQuality !== null
+            ? this.device.airQuality
+            : 0;
+    }
+    async getRotationSpeed() {
+        if (this.device.speed === undefined || this.device.speed === null || !this.device.maxSpeed) {
+            return 0;
+        }
+        return Math.min(Math.max((this.device.speed / this.device.maxSpeed) * 100, 0), 100);
+    }
+    async setRotationSpeed(value) {
+        try {
+            const speed = Math.round((value / 100) * this.device.maxSpeed);
+            const success = await this.device.setSpeed(speed);
+            if (!success) {
+                throw new Error(`Failed to set speed to ${speed}`);
+            }
+            await this.persistDeviceState('speed', speed);
+        }
+        catch (error) {
+            this.handleDeviceError('set rotation speed', error);
+        }
+    }
+    async getLockPhysicalControls() {
+        return this.device.childLock ? 1 : 0;
+    }
+    async setLockPhysicalControls(value) {
+        try {
+            if (!this.device.setChildLock) {
+                throw new Error('Device does not support child lock');
+            }
+            const enabled = value === 1;
+            const success = await this.device.setChildLock(enabled);
+            if (!success) {
+                throw new Error(`Failed to ${enabled ? 'enable' : 'disable'} child lock`);
+            }
+            await this.persistDeviceState('childLock', enabled);
+        }
+        catch (error) {
+            this.handleDeviceError('set child lock', error);
+        }
+    }
+    async getFilterChangeIndication() {
+        return this.device.filterLife <= 20 ? 1 : 0;
+    }
+    async getFilterLifeLevel() {
+        return this.device.filterLife;
+    }
+}
+exports.AirPurifierAccessory = AirPurifierAccessory;
+//# sourceMappingURL=air-purifier.accessory.js.map

package/dist/accessories/air-purifier.accessory.js.map

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

package/dist/accessories/base.accessory.d.ts

@@ -0,0 +1,78 @@
+import { CharacteristicValue, PlatformAccessory, Service } from 'homebridge';
+import { TSVESyncPlatform } from '../platform';
+import { DeviceCapabilities, VeSyncDeviceWithPower } from '../types/device.types';
+export declare abstract class BaseAccessory {
+    protected service: Service;
+    protected readonly platform: TSVESyncPlatform;
+    protected readonly accessory: PlatformAccessory;
+    protected readonly device: VeSyncDeviceWithPower;
+    private readonly pollingManager;
+    private readonly retryManager;
+    private readonly logger;
+    constructor(platform: TSVESyncPlatform, accessory: PlatformAccessory, device: VeSyncDeviceWithPower);
+    /**
+     * Get base context for logging
+     */
+    private getLogContext;
+    /**
+     * Execute an operation with retry logic
+     */
+    protected withRetry<T>(operation: () => Promise<T>, operationName: string): Promise<T>;
+    /**
+     * Set up the device-specific service
+     */
+    protected abstract setupService(): void;
+    /**
+     * Update device-specific states
+     */
+    protected abstract updateDeviceSpecificStates(details: any): void;
+    /**
+     * Get device capabilities
+     */
+    protected abstract getDeviceCapabilities(): DeviceCapabilities;
+    /**
+     * Get the device type for polling configuration
+     */
+    protected getDeviceType(): string;
+    /**
+     * Set up the accessory services and start polling
+     */
+    private setupAccessory;
+    /**
+     * Start polling for device updates
+     */
+    protected startPolling(): void;
+    /**
+     * Stop polling for device updates
+     */
+    protected stopPolling(): void;
+    /**
+     * Update the polling manager with the device's active state
+     */
+    protected updatePollingState(isActive: boolean): void;
+    /**
+     * Sync the device state with VeSync
+     */
+    protected syncDeviceState(): Promise<void>;
+    /**
+     * Helper method to convert air quality values to HomeKit format
+     */
+    protected convertAirQualityToHomeKit(pm25: number): number;
+    /**
+     * Helper method to set up a characteristic with get/set handlers
+     */
+    protected setupCharacteristic(characteristic: any, onGet?: () => Promise<CharacteristicValue>, onSet?: (value: CharacteristicValue) => Promise<void>, props?: Record<string, any>, service?: Service): void;
+    /**
+     * Helper method to update a characteristic value
+     */
+    protected updateCharacteristicValue(characteristic: any, value: CharacteristicValue): void;
+    /**
+     * Persist device state to accessory context
+     */
+    protected persistDeviceState(key: string, value: unknown): Promise<void>;
+    /**
+     * Handle device errors consistently
+     */
+    protected handleDeviceError(operation: string, error: unknown): void;
+}
+//# sourceMappingURL=base.accessory.d.ts.map

package/dist/accessories/base.accessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/base.accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAKlF,8BAAsB,aAAa;IACjC,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC;IAC5B,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAChD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGpC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,qBAAqB;IA6B/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;cACa,SAAS,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IAEvC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAEjE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,qBAAqB,IAAI,kBAAkB;IAE9D;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM;IAgBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAM9B;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,IAAI;IAI7B;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIrD;;OAEG;cACa,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAkChD;;OAEG;IACH,SAAS,CAAC,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ1D;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAC3B,cAAc,EAAE,GAAG,EACnB,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAC1C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IAwDP;;OAEG;IACH,SAAS,CAAC,yBAAyB,CACjC,cAAc,EAAE,GAAG,EACnB,KAAK,EAAE,mBAAmB,GACzB,IAAI;IAUP;;OAEG;cACa,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9E;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;CASrE"}