@woltz/rich-domain 1.2.0 → 1.2.1

package/dist/entity-changes.js

@@ -0,0 +1,135 @@
+// ============================================================================
+// Entity Changes
+// Changes filtered by entity type
+// ============================================================================
+/**
+ * Represents the changes filtered for a specific entity.
+ *
+ * @example
+ * ```typescript
+ * const changes = user.getChanges();
+ * const postChanges = changes.for('Post');
+ *
+ * if (postChanges.hasCreates()) {
+ *   console.log('Created posts:', postChanges.creates);
+ * }
+ *
+ * if (postChanges.hasUpdates()) {
+ *   postChanges.updates.forEach(({ entity, changed }) => {
+ *     console.log(`Post ${entity.id} has changed:`, changed);
+ *   });
+ * }
+ * ```
+ */
+export class EntityChanges {
+    constructor(operations) {
+        this.operations = operations;
+    }
+    /**
+     * Returns all created entities
+     */
+    get creates() {
+        return this.operations
+            .filter((op) => op.type === "create")
+            .map((op) => op.data);
+    }
+    /**
+     * Returns all updated entities with their changed fields
+     */
+    get updates() {
+        return this.operations
+            .filter((op) => op.type === "update")
+            .map((op) => ({
+            entity: op.data,
+            changed: op.changedFields,
+        }));
+    }
+    /**
+     * Returns all deleted entities
+     */
+    get deletes() {
+        return this.operations
+            .filter((op) => op.type === "delete")
+            .map((op) => op.data);
+    }
+    /**
+     * Returns the IDs of the created entities
+     */
+    get createIds() {
+        return this.operations
+            .filter((op) => op.type === "create")
+            .map((op) => this.extractId(op.data))
+            .filter((id) => id !== undefined);
+    }
+    /**
+     * Returns the IDs of the updated entities
+     */
+    get updateIds() {
+        return this.operations
+            .filter((op) => op.type === "update")
+            .map((op) => op.id);
+    }
+    /**
+     * Returns the IDs of the deleted entities
+     */
+    get deleteIds() {
+        return this.operations
+            .filter((op) => op.type === "delete")
+            .map((op) => op.id);
+    }
+    /**
+     * Checks if there are any creates
+     */
+    hasCreates() {
+        return this.creates.length > 0;
+    }
+    /**
+     * Checks if there are any updates
+     */
+    hasUpdates() {
+        return this.updates.length > 0;
+    }
+    /**
+     * Checks if there are any deletes
+     */
+    hasDeletes() {
+        return this.deletes.length > 0;
+    }
+    /**
+     * Checks if there is any change
+     */
+    hasChanges() {
+        return this.operations.length > 0;
+    }
+    /**
+     * Checks if it is empty (no changes)
+     */
+    isEmpty() {
+        return this.operations.length === 0;
+    }
+    /**
+     * Returns the total number of operations
+     */
+    get count() {
+        return this.operations.length;
+    }
+    /**
+     * Returns the raw operations (for advanced use cases)
+     */
+    get rawOperations() {
+        return [...this.operations];
+    }
+    /**
+     * Extracts the ID from an entity
+     */
+    extractId(entity) {
+        if (!entity)
+            return undefined;
+        if (entity.id?.value)
+            return entity.id.value;
+        if (typeof entity.id === "string")
+            return entity.id;
+        return undefined;
+    }
+}
+//# sourceMappingURL=entity-changes.js.map

package/dist/entity-changes.js.map

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

package/dist/entity-schema-registry.d.ts

@@ -0,0 +1,148 @@
+import { Entity } from "./entity";
+import { ValueObject } from "./value-object";
+/**
+ * Mapping schema for a domain entity.
+ */
+export interface EntitySchema {
+    /** Entity name in the domain (e.g., 'User', 'Post') */
+    entity: string;
+    /** Table name in the database (e.g., 'users', 'blog_posts') */
+    table: string;
+    /**
+     * Field mapping: domain → database.
+     * Only include fields with different names.
+     * @example { email: 'user_email', createdAt: 'created_at' }
+     */
+    fields?: Record<string, string>;
+    /**
+     * FK configuration for parent relation.
+     */
+    parentFk?: {
+        /** Name of the FK field in the database (e.g., 'author_id') */
+        field: string;
+        /** Name of the parent entity (e.g., 'User') */
+        parentEntity: string;
+    };
+}
+/**
+ * Result of entity mapping.
+ */
+export interface MappedEntityData {
+    [key: string]: any;
+}
+/**
+ * Registry for mapping domain entities to database tables and fields.
+ *
+ * @example
+ * ```typescript
+ * const registry = new EntitySchemaRegistry()
+ *   .register({
+ *     entity: 'User',
+ *     table: 'users',
+ *     fields: { email: 'user_email', name: 'user_name' },
+ *   })
+ *   .register({
+ *     entity: 'Post',
+ *     table: 'blog_posts',
+ *     fields: { content: 'post_content' },
+ *     parentFk: { field: 'author_id', parentEntity: 'User' },
+ *   });
+ *
+ * const table = registry.getTable('Post'); // 'blog_posts'
+ * const mapped = registry.mapFields('User', { email: 'test@test.com' });
+ * // { user_email: 'test@test.com' }
+ * ```
+ */
+export declare class EntitySchemaRegistry {
+    private schemas;
+    /**
+     * Registers an entity schema.
+     * @param schema - Schema to be registered.
+     * @returns this (for chaining)
+     */
+    register(schema: EntitySchema): this;
+    /**
+     * Registers multiple schemas at once.
+     * @param schemas - Array of schemas.
+     * @returns this (for chaining)
+     */
+    registerAll(schemas: EntitySchema[]): this;
+    /**
+     * Gets the schema of an entity.
+     * @param entity - Entity name.
+     * @throws Error if the entity is not registered.
+     */
+    getSchema(entity: string): EntitySchema;
+    /**
+     * Checks if an entity is registered.
+     * @param entity - Entity name.
+     */
+    has(entity: string): boolean;
+    /**
+     * Gets the table name for an entity.
+     * @param entity - Entity name.
+     */
+    getTable(entity: string): string;
+    /**
+     * Gets the field mapping for an entity.
+     * @param entity - Entity name.
+     */
+    getFieldsMap(entity: string): Record<string, string>;
+    /**
+     * Maps a domain field name to the database field name.
+     * @param entity - Entity name.
+     * @param fieldName - Domain field name.
+     */
+    mapFieldName(entity: string, fieldName: string): string;
+    /**
+     * Maps fields of a domain object to database field names.
+     * Ignores values that are Entity, ValueObject, or Arrays.
+     *
+     * @param entity - Entity name.
+     * @param data - Data to be mapped.
+     */
+    mapFields(entity: string, data: Record<string, any>): MappedEntityData;
+    /**
+     * Maps a complete domain entity to database data.
+     * Used for CREATE operations.
+     *
+     * @param entity - Entity name.
+     * @param domainEntity - Domain entity instance.
+     */
+    mapEntity(entity: string, domainEntity: Entity<any> | ValueObject<any>): MappedEntityData;
+    /**
+     * Gets the FK object to relate with the parent.
+     *
+     * @param entity - Entity name.
+     * @param parentId - Parent ID.
+     * @returns Object with the FK field or null if there is no parent.
+     */
+    getParentFk(entity: string, parentId: string): Record<string, string> | null;
+    /**
+     * Gets the name of the parent entity.
+     * @param entity - Entity name.
+     */
+    getParentEntity(entity: string): string | null;
+    /**
+     * Gets the FK field name.
+     * @param entity - Entity name.
+     */
+    getParentFkField(entity: string): string | null;
+    /**
+     * Lists all registered entities.
+     */
+    getRegisteredEntities(): string[];
+    /**
+     * Clears all registered schemas.
+     */
+    clear(): void;
+    /**
+     * Checks if a value is Entity, ValueObject, or Array.
+     */
+    private isEntityOrCollection;
+    /**
+     * Normalizes a value for persistence.
+     */
+    private normalizeValue;
+}
+//# sourceMappingURL=entity-schema-registry.d.ts.map

package/dist/entity-schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schema-registry.d.ts","sourceRoot":"","sources":["../src/entity-schema-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,+DAA+D;QAC/D,KAAK,EAAE,MAAM,CAAC;QACd,+CAA+C;QAC/C,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAmC;IAElD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAUpC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAK1C;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAWvC;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAKvD;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,gBAAgB;IAetE;;;;;;OAMG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAC3C,gBAAgB;IA0BnB;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAO5E;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK9C;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK/C;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,cAAc;CAUvB"}

package/dist/entity-schema-registry.js

@@ -0,0 +1,219 @@
+import { Entity } from "./entity";
+import { ValueObject } from "./value-object";
+import { Id } from "./id";
+/**
+ * Registry for mapping domain entities to database tables and fields.
+ *
+ * @example
+ * ```typescript
+ * const registry = new EntitySchemaRegistry()
+ *   .register({
+ *     entity: 'User',
+ *     table: 'users',
+ *     fields: { email: 'user_email', name: 'user_name' },
+ *   })
+ *   .register({
+ *     entity: 'Post',
+ *     table: 'blog_posts',
+ *     fields: { content: 'post_content' },
+ *     parentFk: { field: 'author_id', parentEntity: 'User' },
+ *   });
+ *
+ * const table = registry.getTable('Post'); // 'blog_posts'
+ * const mapped = registry.mapFields('User', { email: 'test@test.com' });
+ * // { user_email: 'test@test.com' }
+ * ```
+ */
+export class EntitySchemaRegistry {
+    constructor() {
+        this.schemas = new Map();
+    }
+    /**
+     * Registers an entity schema.
+     * @param schema - Schema to be registered.
+     * @returns this (for chaining)
+     */
+    register(schema) {
+        if (this.schemas.has(schema.entity)) {
+            console.warn(`EntitySchemaRegistry: Schema for '${schema.entity}' is being overwritten`);
+        }
+        this.schemas.set(schema.entity, schema);
+        return this;
+    }
+    /**
+     * Registers multiple schemas at once.
+     * @param schemas - Array of schemas.
+     * @returns this (for chaining)
+     */
+    registerAll(schemas) {
+        schemas.forEach((schema) => this.register(schema));
+        return this;
+    }
+    /**
+     * Gets the schema of an entity.
+     * @param entity - Entity name.
+     * @throws Error if the entity is not registered.
+     */
+    getSchema(entity) {
+        const schema = this.schemas.get(entity);
+        if (!schema) {
+            throw new Error(`EntitySchemaRegistry: No schema registered for entity '${entity}'. ` +
+                `Available entities: ${Array.from(this.schemas.keys()).join(", ") || "none"}`);
+        }
+        return schema;
+    }
+    /**
+     * Checks if an entity is registered.
+     * @param entity - Entity name.
+     */
+    has(entity) {
+        return this.schemas.has(entity);
+    }
+    /**
+     * Gets the table name for an entity.
+     * @param entity - Entity name.
+     */
+    getTable(entity) {
+        return this.getSchema(entity).table;
+    }
+    /**
+     * Gets the field mapping for an entity.
+     * @param entity - Entity name.
+     */
+    getFieldsMap(entity) {
+        return this.getSchema(entity).fields || {};
+    }
+    /**
+     * Maps a domain field name to the database field name.
+     * @param entity - Entity name.
+     * @param fieldName - Domain field name.
+     */
+    mapFieldName(entity, fieldName) {
+        const fields = this.getFieldsMap(entity);
+        return fields[fieldName] ?? fieldName;
+    }
+    /**
+     * Maps fields of a domain object to database field names.
+     * Ignores values that are Entity, ValueObject, or Arrays.
+     *
+     * @param entity - Entity name.
+     * @param data - Data to be mapped.
+     */
+    mapFields(entity, data) {
+        const fields = this.getFieldsMap(entity);
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (this.isEntityOrCollection(value)) {
+                continue;
+            }
+            const mappedKey = fields[key] ?? key;
+            result[mappedKey] = this.normalizeValue(value);
+        }
+        return result;
+    }
+    /**
+     * Maps a complete domain entity to database data.
+     * Used for CREATE operations.
+     *
+     * @param entity - Entity name.
+     * @param domainEntity - Domain entity instance.
+     */
+    mapEntity(entity, domainEntity) {
+        const fields = this.getFieldsMap(entity);
+        const result = {};
+        // Map ID if it is an Entity or has entity-like structure
+        const hasId = domainEntity.id;
+        if (hasId) {
+            // Extract id value
+            const idValue = hasId.value ?? hasId;
+            result["id"] = idValue;
+        }
+        // Get props
+        const props = domainEntity.props || domainEntity;
+        for (const [key, value] of Object.entries(props)) {
+            if (key === "id")
+                continue; // ID already mapped
+            if (this.isEntityOrCollection(value))
+                continue;
+            const mappedKey = fields[key] ?? key;
+            result[mappedKey] = this.normalizeValue(value);
+        }
+        return result;
+    }
+    /**
+     * Gets the FK object to relate with the parent.
+     *
+     * @param entity - Entity name.
+     * @param parentId - Parent ID.
+     * @returns Object with the FK field or null if there is no parent.
+     */
+    getParentFk(entity, parentId) {
+        const schema = this.getSchema(entity);
+        if (!schema.parentFk)
+            return null;
+        return { [schema.parentFk.field]: parentId };
+    }
+    /**
+     * Gets the name of the parent entity.
+     * @param entity - Entity name.
+     */
+    getParentEntity(entity) {
+        const schema = this.getSchema(entity);
+        return schema.parentFk?.parentEntity ?? null;
+    }
+    /**
+     * Gets the FK field name.
+     * @param entity - Entity name.
+     */
+    getParentFkField(entity) {
+        const schema = this.getSchema(entity);
+        return schema.parentFk?.field ?? null;
+    }
+    /**
+     * Lists all registered entities.
+     */
+    getRegisteredEntities() {
+        return Array.from(this.schemas.keys());
+    }
+    /**
+     * Clears all registered schemas.
+     */
+    clear() {
+        this.schemas.clear();
+    }
+    /**
+     * Checks if a value is Entity, ValueObject, or Array.
+     */
+    isEntityOrCollection(value) {
+        if (value === null || value === undefined)
+            return false;
+        if (Array.isArray(value))
+            return true;
+        if (value instanceof Entity)
+            return true;
+        if (value instanceof ValueObject)
+            return true;
+        // Checks if it has the structure of an Entity (object with 'id' that has 'value')
+        if (typeof value === 'object' && value.id && typeof value.id === 'object' && 'value' in value.id) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Normalizes a value for persistence.
+     */
+    normalizeValue(value) {
+        if (value === null || value === undefined)
+            return value;
+        if (value instanceof Id)
+            return value.value;
+        if (value instanceof Date)
+            return value;
+        if (typeof value === "object" && "value" in value) {
+            // Might be an ID or other wrapper
+            return value.value;
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=entity-schema-registry.js.map

package/dist/entity-schema-registry.js.map

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

package/dist/history-tracker.d.ts

@@ -0,0 +1,97 @@
+import { HistoryEntry } from "./types";
+import { AggregateChanges } from "./aggregate-changes";
+/**
+ * Callback for validation on property change.
+ * Return false to reject the change, or throw an error.
+ */
+export type OnChangeValidator = (path: string, oldValue: any, newValue: any) => boolean | void;
+/**
+ * Tracks changes in Aggregates using Proxy.
+ *
+ * Features:
+ * - Tracks changes in primitive properties
+ * - Tracks changes in nested entities (1:1)
+ * - Tracks changes in collections (1:N)
+ * - Supports Value Objects with identityKey
+ * - Calculates depth automatically
+ * - Generates AggregateChanges for persistence
+ * - Supports validation on change via onChangeValidator
+ */
+export declare class HistoryTracker {
+    private target;
+    private rootEntityName;
+    private path;
+    private depth;
+    private parentId?;
+    private parentEntity?;
+    private rootTracker?;
+    private history;
+    private originalValues;
+    private trackedArrays;
+    private trackedEntities;
+    private onChangeValidator?;
+    constructor(target: any, rootEntityName: string, path?: string, depth?: number, parentId?: string | undefined, parentEntity?: string | undefined, rootTracker?: HistoryTracker | undefined);
+    /**
+     * Sets a validator callback that will be called on every property change.
+     * The validator can:
+     * - Return false to reject the change (value will be reverted)
+     * - Throw an error to reject the change with an error
+     * - Return true/undefined to accept the change
+     */
+    setOnChangeValidator(validator: OnChangeValidator): void;
+    private captureInitialState;
+    private captureEntityState;
+    private captureArrayState;
+    createProxy(): any;
+    private createArrayProxy;
+    /**
+     * Returns all detected changes as AggregateChanges.
+     */
+    getChanges<TEntityMap = Record<string, any>>(): AggregateChanges<TEntityMap>;
+    private analyzeRootChanges;
+    private analyzeCollectionChanges;
+    /**
+     * Recursively marks all nested items as created when a parent is created.
+     */
+    private markNestedItemsAsCreated;
+    /**
+     * Recursively marks all nested items as deleted when a parent is deleted.
+     * Uses the original captured state to find nested items.
+     */
+    private markNestedItemsAsDeleted;
+    /**
+     * Recursively marks nested items as deleted from a JSON object.
+     * This is used when processing cloned (JSON) state.
+     */
+    private markNestedJsonItemAsDeleted;
+    /**
+     * Extracts identity key from a JSON object by looking at the original ValueObject instances.
+     */
+    private extractIdentityKeyFromJson;
+    private collectNestedArrays;
+    private analyzeEntityChanges;
+    private detectEntityChangeState;
+    private detectArrayChanges;
+    private detectChangedFields;
+    private handleArrayAssignment;
+    private handleEntityChange;
+    private getRootTracker;
+    private buildPath;
+    private shouldSkipProperty;
+    private getValueAtPath;
+    private getItemKey;
+    private getEntityId;
+    private getEntityName;
+    private isEntityOrVO;
+    private isEqual;
+    private deepEqual;
+    private hasChanged;
+    private cloneArray;
+    private deepClone;
+    private normalizeAndStringify;
+    getHistory(): HistoryEntry[];
+    clearHistory(): void;
+    markAsClean(): void;
+    getTarget(): any;
+}
+//# sourceMappingURL=history-tracker.d.ts.map

package/dist/history-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-tracker.d.ts","sourceRoot":"","sources":["../src/history-tracker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,YAAY,EAAe,MAAM,SAAS,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,GAAG,KACV,OAAO,GAAG,IAAI,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IAQvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ,CAAC;IACjB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,WAAW,CAAC;IAbtB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,iBAAiB,CAAC,CAAoB;gBAGpC,MAAM,EAAE,GAAG,EACX,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,MAAW,EACjB,KAAK,GAAE,MAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,WAAW,CAAC,EAAE,cAAc,YAAA;IAQtC;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAQxD,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,iBAAiB;IAwCzB,WAAW,IAAI,GAAG;IA6FlB,OAAO,CAAC,gBAAgB;IA0HxB;;OAEG;IACH,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,gBAAgB,CAAC,UAAU,CAAC;IAW5E,OAAO,CAAC,kBAAkB;IAgC1B,OAAO,CAAC,wBAAwB;IAuEhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwChC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAyChC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAoDnC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAuBlC,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,oBAAoB;IA4E5B,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,kBAAkB;IA2C1B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,SAAS;IA4CjB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAkCjB,OAAO,CAAC,qBAAqB;IAkB7B,UAAU,IAAI,YAAY,EAAE;IAI5B,YAAY,IAAI,IAAI;IASpB,WAAW,IAAI,IAAI;IAInB,SAAS,IAAI,GAAG;CAGjB"}