bindra 2.0.0

package/dist/core/errors.js

@@ -0,0 +1,149 @@
+/**
+ * Custom error classes for Bindra
+ *
+ * Provides structured error handling with error codes and details
+ */
+/**
+ * Base error class for all Bindra errors
+ *
+ * @example
+ * ```typescript
+ * throw new BindraError('Something went wrong', 'GENERAL_ERROR', { detail: 'info' });
+ * ```
+ */
+export class BindraError extends Error {
+    /**
+     * Creates a new BindraError
+     *
+     * @param message - Human-readable error message
+     * @param code - Machine-readable error code
+     * @param details - Additional error details
+     */
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'BindraError';
+        // Maintains proper stack trace for where error was thrown (only available on V8)
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, BindraError);
+        }
+    }
+}
+/**
+ * Network-related errors (HTTP, fetch failures, etc.)
+ *
+ * @example
+ * ```typescript
+ * throw new NetworkError('Failed to fetch data', 404);
+ * ```
+ */
+export class NetworkError extends BindraError {
+    /**
+     * Creates a new NetworkError
+     *
+     * @param message - Human-readable error message
+     * @param statusCode - HTTP status code (optional)
+     * @param response - Response body or additional info (optional)
+     */
+    constructor(message, statusCode, response) {
+        super(message, 'NETWORK_ERROR', { statusCode, response });
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Validation errors for invalid data
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationError('Validation failed', {
+ *   email: 'Invalid email format',
+ *   age: 'Must be a positive number'
+ * });
+ * ```
+ */
+export class ValidationError extends BindraError {
+    /**
+     * Creates a new ValidationError
+     *
+     * @param message - Human-readable error message
+     * @param fields - Map of field names to error messages (optional)
+     */
+    constructor(message, fields) {
+        super(message, 'VALIDATION_ERROR', { fields });
+        this.fields = fields;
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Permission/authorization errors
+ *
+ * @example
+ * ```typescript
+ * throw new PermissionError('Insert operation not allowed');
+ * ```
+ */
+export class PermissionError extends BindraError {
+    /**
+     * Creates a new PermissionError
+     *
+     * @param message - Human-readable error message
+     * @param operation - The operation that was denied (optional)
+     */
+    constructor(message, operation) {
+        super(message, 'PERMISSION_DENIED', { operation });
+        this.operation = operation;
+        this.name = 'PermissionError';
+    }
+}
+/**
+ * Configuration errors
+ *
+ * @example
+ * ```typescript
+ * throw new ConfigurationError('Invalid DataSource configuration');
+ * ```
+ */
+export class ConfigurationError extends BindraError {
+    /**
+     * Creates a new ConfigurationError
+     *
+     * @param message - Human-readable error message
+     * @param config - The invalid configuration (optional)
+     */
+    constructor(message, config) {
+        super(message, 'CONFIGURATION_ERROR', { config });
+        this.config = config;
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Type guard to check if an error is a BindraError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a BindraError
+ */
+export function isBindraError(error) {
+    return error instanceof BindraError;
+}
+/**
+ * Type guard to check if an error is a NetworkError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a NetworkError
+ */
+export function isNetworkError(error) {
+    return error instanceof NetworkError;
+}
+/**
+ * Type guard to check if an error is a ValidationError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a ValidationError
+ */
+export function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC;;;;;;OAMG;IACH,YACE,OAAe,EACR,IAAY,EACZ,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAE1B,iFAAiF;QACjF,IAAI,OAAQ,KAAa,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC1D,KAAa,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;OAMG;IACH,YACE,OAAe,EACR,UAAmB,EACnB,QAAc;QAErB,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAHnD,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAM;QAGrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;OAKG;IACH,YACE,OAAe,EACR,MAA+B;QAEtC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAFxC,WAAM,GAAN,MAAM,CAAyB;QAGtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;OAKG;IACH,YACE,OAAe,EACR,SAAkB;QAEzB,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAF5C,cAAS,GAAT,SAAS,CAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD;;;;;OAKG;IACH,YACE,OAAe,EACR,MAAY;QAEnB,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAF3C,WAAM,GAAN,MAAM,CAAM;QAGnB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAC;AAC1C,CAAC"}

package/dist/core/validation.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Field validation rules
+ */
+export interface FieldValidation<T extends Record<string, any>> {
+    /** Whether the field is required */
+    required?: boolean;
+    /** Data type validation */
+    type?: 'string' | 'number' | 'boolean' | 'date' | 'email' | 'url' | 'array' | 'object';
+    /** Minimum value (for numbers) or length (for strings/arrays) */
+    min?: number;
+    /** Maximum value (for numbers) or length (for strings/arrays) */
+    max?: number;
+    /** RegEx pattern for string validation */
+    pattern?: RegExp;
+    /** Custom validation function. Return true for valid, false or error message for invalid */
+    custom?: (value: any, record: Partial<T>) => boolean | string | Promise<boolean | string>;
+    /** Error message override */
+    message?: string;
+}
+/**
+ * Field configuration with validation
+ */
+export interface FieldConfig<T extends Record<string, any>> {
+    /** Field name */
+    name: keyof T;
+    /** Display label */
+    label?: string;
+    /** Validation rules */
+    validation?: FieldValidation<T>;
+    /** Default value */
+    defaultValue?: any;
+    /** Computed field function */
+    computed?: (record: T) => any;
+    /** Read-only field (won't be validated or saved) */
+    readOnly?: boolean;
+    /** Transform value before validation */
+    transform?: (value: any) => any;
+}
+/**
+ * Validation utility class
+ */
+export declare class Validator<T extends Record<string, any>> {
+    private fields;
+    constructor(fields: FieldConfig<T>[]);
+    /**
+     * Validate a single field value
+     *
+     * @param fieldName - Name of the field to validate
+     * @param value - Value to validate
+     * @param record - Full record for context (used in custom validators)
+     * @returns Error message if invalid, null if valid
+     */
+    validateField(fieldName: keyof T, value: any, record?: Partial<T>): Promise<string | null>;
+    /**
+     * Validate a complete record
+     *
+     * @param record - Record to validate
+     * @param options - Validation options
+     * @returns Object with field errors, or null if valid
+     */
+    validateRecord(record: Partial<T>, options?: {
+        skipReadOnly?: boolean;
+        skipComputed?: boolean;
+    }): Promise<Record<string, string> | null>;
+    /**
+     * Apply default values to a record
+     *
+     * @param record - Partial record to apply defaults to
+     * @returns Record with defaults applied
+     */
+    applyDefaults(record: Partial<T>): Partial<T>;
+    /**
+     * Apply computed fields to a record
+     *
+     * @param record - Record to compute fields for
+     * @returns Record with computed fields
+     */
+    applyComputed(record: T): T;
+    /**
+     * Check if a value is empty
+     */
+    private isEmpty;
+    /**
+     * Validate type
+     */
+    private validateType;
+    /**
+     * Validate range (min/max)
+     */
+    private validateRange;
+    /**
+     * Get field configuration by name
+     */
+    getField(name: keyof T): FieldConfig<T> | undefined;
+    /**
+     * Check if a field exists
+     */
+    hasField(name: keyof T): boolean;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5D,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEvF,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAE1F,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACxD,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC,CAAC;IAEd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,UAAU,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAEhC,oBAAoB;IACpB,YAAY,CAAC,EAAE,GAAG,CAAC;IAEnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,GAAG,CAAC;IAE9B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACtC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE;IAE5C;;;;;;;OAOG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,CAAC,EAClB,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqDzB;;;;;;OAMG;IACG,cAAc,CAClB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAC/D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAsBzC;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY7C;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC;IAY3B;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,YAAY;IAgEpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAInD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO;CAGjC"}

package/dist/core/validation.js

@@ -0,0 +1,217 @@
+/**
+ * Validation utility class
+ */
+export class Validator {
+    constructor(fields) {
+        this.fields = fields;
+    }
+    /**
+     * Validate a single field value
+     *
+     * @param fieldName - Name of the field to validate
+     * @param value - Value to validate
+     * @param record - Full record for context (used in custom validators)
+     * @returns Error message if invalid, null if valid
+     */
+    async validateField(fieldName, value, record) {
+        const field = this.fields.find(f => f.name === fieldName);
+        if (!field?.validation)
+            return null;
+        const v = field.validation;
+        const fieldLabel = field.label || String(fieldName);
+        // Transform value if transformer provided
+        if (field.transform) {
+            value = field.transform(value);
+        }
+        // Required check
+        if (v.required && this.isEmpty(value)) {
+            return v.message || `${fieldLabel} is required`;
+        }
+        // If value is empty and not required, skip other validations
+        if (this.isEmpty(value) && !v.required) {
+            return null;
+        }
+        // Type validation
+        if (v.type) {
+            const typeError = this.validateType(fieldLabel, value, v.type);
+            if (typeError)
+                return v.message || typeError;
+        }
+        // Min/Max validation
+        if (v.min !== undefined || v.max !== undefined) {
+            const rangeError = this.validateRange(fieldLabel, value, v.min, v.max);
+            if (rangeError)
+                return v.message || rangeError;
+        }
+        // Pattern validation
+        if (v.pattern && typeof value === 'string') {
+            if (!v.pattern.test(value)) {
+                return v.message || `${fieldLabel} format is invalid`;
+            }
+        }
+        // Custom validation
+        if (v.custom) {
+            const result = await v.custom(value, record || {});
+            if (typeof result === 'string')
+                return result;
+            if (result === false) {
+                return v.message || `${fieldLabel} validation failed`;
+            }
+        }
+        return null;
+    }
+    /**
+     * Validate a complete record
+     *
+     * @param record - Record to validate
+     * @param options - Validation options
+     * @returns Object with field errors, or null if valid
+     */
+    async validateRecord(record, options = {}) {
+        const errors = {};
+        const { skipReadOnly = true, skipComputed = true } = options;
+        // Validate each field
+        const validationPromises = this.fields.map(async (field) => {
+            // Skip read-only and computed fields
+            if ((skipReadOnly && field.readOnly) || (skipComputed && field.computed)) {
+                return;
+            }
+            const error = await this.validateField(field.name, record[field.name], record);
+            if (error) {
+                errors[String(field.name)] = error;
+            }
+        });
+        await Promise.all(validationPromises);
+        return Object.keys(errors).length > 0 ? errors : null;
+    }
+    /**
+     * Apply default values to a record
+     *
+     * @param record - Partial record to apply defaults to
+     * @returns Record with defaults applied
+     */
+    applyDefaults(record) {
+        const result = { ...record };
+        for (const field of this.fields) {
+            if (field.defaultValue !== undefined && result[field.name] === undefined) {
+                result[field.name] = field.defaultValue;
+            }
+        }
+        return result;
+    }
+    /**
+     * Apply computed fields to a record
+     *
+     * @param record - Record to compute fields for
+     * @returns Record with computed fields
+     */
+    applyComputed(record) {
+        const result = { ...record };
+        for (const field of this.fields) {
+            if (field.computed) {
+                result[field.name] = field.computed(record);
+            }
+        }
+        return result;
+    }
+    /**
+     * Check if a value is empty
+     */
+    isEmpty(value) {
+        return (value === null ||
+            value === undefined ||
+            value === '' ||
+            (Array.isArray(value) && value.length === 0));
+    }
+    /**
+     * Validate type
+     */
+    validateType(fieldLabel, value, type) {
+        switch (type) {
+            case 'string':
+                if (typeof value !== 'string') {
+                    return `${fieldLabel} must be a string`;
+                }
+                break;
+            case 'number':
+                if (typeof value !== 'number' || isNaN(value)) {
+                    return `${fieldLabel} must be a number`;
+                }
+                break;
+            case 'boolean':
+                if (typeof value !== 'boolean') {
+                    return `${fieldLabel} must be a boolean`;
+                }
+                break;
+            case 'date':
+                const date = new Date(value);
+                if (isNaN(date.getTime())) {
+                    return `${fieldLabel} must be a valid date`;
+                }
+                break;
+            case 'email':
+                if (typeof value !== 'string' || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+                    return `${fieldLabel} must be a valid email`;
+                }
+                break;
+            case 'url':
+                if (typeof value !== 'string') {
+                    return `${fieldLabel} must be a valid URL`;
+                }
+                try {
+                    new URL(value);
+                }
+                catch {
+                    return `${fieldLabel} must be a valid URL`;
+                }
+                break;
+            case 'array':
+                if (!Array.isArray(value)) {
+                    return `${fieldLabel} must be an array`;
+                }
+                break;
+            case 'object':
+                if (typeof value !== 'object' || Array.isArray(value) || value === null) {
+                    return `${fieldLabel} must be an object`;
+                }
+                break;
+        }
+        return null;
+    }
+    /**
+     * Validate range (min/max)
+     */
+    validateRange(fieldLabel, value, min, max) {
+        if (typeof value === 'number') {
+            if (min !== undefined && value < min) {
+                return `${fieldLabel} must be at least ${min}`;
+            }
+            if (max !== undefined && value > max) {
+                return `${fieldLabel} must be at most ${max}`;
+            }
+        }
+        else if (typeof value === 'string' || Array.isArray(value)) {
+            const length = value.length;
+            if (min !== undefined && length < min) {
+                return `${fieldLabel} must have at least ${min} ${Array.isArray(value) ? 'items' : 'characters'}`;
+            }
+            if (max !== undefined && length > max) {
+                return `${fieldLabel} must have at most ${max} ${Array.isArray(value) ? 'items' : 'characters'}`;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get field configuration by name
+     */
+    getField(name) {
+        return this.fields.find(f => f.name === name);
+    }
+    /**
+     * Check if a field exists
+     */
+    hasField(name) {
+        return this.fields.some(f => f.name === name);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/examples.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Bindra TypeScript Usage Examples
+ *
+ * This file demonstrates how to use Bindra with TypeScript for type-safe
+ * reactive data management.
+ */
+import { DataSource } from './index';
+import type { Signal } from './index';
+interface User {
+    id: number;
+    name: string;
+    email: string;
+    age: number;
+    isActive?: boolean;
+}
+declare const usersDS: DataSource<User>;
+declare function crudExample(): Promise<void>;
+interface Product {
+    id: number;
+    name: string;
+    price: number;
+    category: string;
+    inStock: boolean;
+}
+declare const productsDS: DataSource<Product>;
+declare function remoteExample(): Promise<void>;
+declare class UserForm {
+    private ds;
+    private unsubscribers;
+    constructor(dataSource: DataSource<User>);
+    private bindToCurrentRecord;
+    private populateForm;
+    save(formData: Partial<User>): Promise<void>;
+    cleanup(): void;
+}
+interface Task {
+    id: number;
+    title: string;
+    completed: boolean;
+    priority: 'low' | 'medium' | 'high';
+    dueDate: Date;
+}
+declare const tasksDS: DataSource<Task>;
+declare const taskStats: {
+    total: Signal<number>;
+    completed: Signal<number>;
+    pending: Signal<number>;
+    highPriority: Signal<number>;
+};
+declare function isValidUser(obj: any): obj is User;
+export { usersDS, productsDS, tasksDS, crudExample, remoteExample, UserForm, isValidUser, taskStats };
+//# sourceMappingURL=examples.d.ts.map

package/dist/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAoB,MAAM,SAAS,CAAC;AAMxD,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,QAAA,MAAM,OAAO,kBAMX,CAAC;AAoBH,iBAAe,WAAW,kBA4BzB;AAwHD,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,QAAA,MAAM,UAAU,qBAA0C,CAAC;AAG3D,iBAAe,aAAa,kBAmB3B;AAMD,cAAM,QAAQ;IACZ,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,aAAa,CAAyB;gBAElC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC;IAKxC,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,YAAY;IAMd,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,OAAO,IAAI,IAAI;CAGhB;AAUD,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,QAAA,MAAM,OAAO,kBAKX,CAAC;AAGH,QAAA,MAAM,SAAS;;;;;CAKd,CAAC;AAqBF,iBAAS,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,IAAI,CAQ1C;AAgBD,OAAO,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,SAAS,EACV,CAAC"}