@veloxts/cli 0.4.1 → 0.4.3

package/dist/seeding/factory.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Factory System
+ *
+ * Base factory class and registry for generating fake data.
+ */
+import type { Factory, FactoryRegistry, PrismaClientLike, StateModifier } from './types.js';
+/**
+ * Abstract base class for model factories.
+ *
+ * Provides a fluent API for creating model instances with fake data
+ * and named state variations.
+ *
+ * @template TInput - The input type for creating records
+ * @template TOutput - The output type returned from database (defaults to TInput)
+ *
+ * @example
+ * ```typescript
+ * import { BaseFactory } from '@veloxts/cli';
+ * import { faker } from '@faker-js/faker';
+ *
+ * interface UserInput {
+ *   email: string;
+ *   name: string;
+ *   role: 'admin' | 'user';
+ * }
+ *
+ * export class UserFactory extends BaseFactory<UserInput> {
+ *   modelName = 'user';
+ *
+ *   definition(): UserInput {
+ *     return {
+ *       email: faker.internet.email(),
+ *       name: faker.person.fullName(),
+ *       role: 'user',
+ *     };
+ *   }
+ *
+ *   admin(): this {
+ *     return this.state('admin');
+ *   }
+ *
+ *   constructor(prisma: PrismaClientLike) {
+ *     super(prisma);
+ *     this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseFactory<TInput extends Record<string, unknown>, TOutput = TInput> implements Factory<TInput, TOutput> {
+    /** Map of registered state modifiers */
+    protected states: Map<string, StateModifier<TInput>>;
+    /** Currently active state names */
+    protected activeStates: string[];
+    /** Prisma client for database operations */
+    protected readonly prisma: PrismaClientLike;
+    /**
+     * Model name for Prisma operations (e.g., 'user', 'post').
+     * Must match the lowercase model name in your Prisma schema.
+     */
+    abstract readonly modelName: string;
+    /**
+     * Define default attributes for new instances.
+     * Override this method to provide fake data generation.
+     */
+    abstract definition(): TInput;
+    constructor(prisma: PrismaClientLike);
+    /**
+     * Register a named state modifier.
+     *
+     * @param name - State name (e.g., 'admin', 'verified')
+     * @param modifier - Function that modifies attributes
+     * @returns this for chaining during construction
+     *
+     * @example
+     * ```typescript
+     * constructor(prisma: PrismaClientLike) {
+     *   super(prisma);
+     *   this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+     *   this.registerState('unverified', (attrs) => ({ ...attrs, emailVerified: null }));
+     * }
+     * ```
+     */
+    protected registerState(name: string, modifier: StateModifier<TInput>): this;
+    /**
+     * Apply a named state modifier.
+     * Returns a new factory instance with the state applied.
+     *
+     * @param name - State name to apply
+     * @returns New factory instance with state active (preserves subclass type)
+     *
+     * @example
+     * ```typescript
+     * // Create an admin user
+     * await factory.get(UserFactory).state('admin').create();
+     *
+     * // Chain multiple states
+     * await factory.get(UserFactory).state('admin').state('verified').create();
+     *
+     * // Subclass methods preserved after state()
+     * const factory = new UserFactory(prisma);
+     * await factory.state('verified').admin().create(); // admin() still accessible
+     * ```
+     */
+    state(name: string): this;
+    /**
+     * Get list of available state names.
+     */
+    getAvailableStates(): ReadonlyArray<string>;
+    /**
+     * Make a single instance without persisting to database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Generated attributes
+     */
+    make(overrides?: Partial<TInput>): TInput;
+    /**
+     * Make multiple instances without persisting to database.
+     *
+     * @param count - Number of instances to make
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of generated attributes
+     */
+    makeMany(count: number, overrides?: Partial<TInput>): TInput[];
+    /**
+     * Create a single instance in the database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Created database record
+     */
+    create(overrides?: Partial<TInput>): Promise<TOutput>;
+    /**
+     * Create multiple instances in the database.
+     *
+     * @param count - Number of instances to create
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of created database records
+     */
+    createMany(count: number, overrides?: Partial<TInput>): Promise<TOutput[]>;
+    /**
+     * Build attributes by applying definition, states, and overrides.
+     */
+    private buildAttributes;
+}
+/**
+ * Create a factory registry for managing factory instances.
+ *
+ * The registry caches factory instances and provides type-safe access.
+ *
+ * @param prisma - Prisma client to inject into factories
+ * @returns Factory registry instance
+ *
+ * @example
+ * ```typescript
+ * const registry = createFactoryRegistry(prisma);
+ *
+ * // Get or create factory instance
+ * const userFactory = registry.get(UserFactory);
+ * await userFactory.create();
+ * ```
+ */
+export declare function createFactoryRegistry(prisma: PrismaClientLike): FactoryRegistry;
+//# sourceMappingURL=factory.d.ts.map

package/dist/seeding/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/seeding/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AA2BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,8BAAsB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CACxF,YAAW,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAa;IAEjE,mCAAmC;IACnC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAM;IAEtC,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,IAAI,MAAM;gBAEjB,MAAM,EAAE,gBAAgB;IAQpC;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAK5E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAazB;;OAEG;IACH,kBAAkB,IAAI,aAAa,CAAC,MAAM,CAAC;IAQ3C;;;;;OAKG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAIzC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAQ9D;;;;;OAKG;IACG,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB3D;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiBhF;;OAEG;IACH,OAAO,CAAC,eAAe;CAmBxB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAyB/E"}

package/dist/seeding/factory.js

@@ -0,0 +1,250 @@
+/**
+ * Factory System
+ *
+ * Base factory class and registry for generating fake data.
+ */
+import { factoryCreateFailed, stateNotFound } from './errors.js';
+// ============================================================================
+// Base Factory
+// ============================================================================
+/**
+ * Abstract base class for model factories.
+ *
+ * Provides a fluent API for creating model instances with fake data
+ * and named state variations.
+ *
+ * @template TInput - The input type for creating records
+ * @template TOutput - The output type returned from database (defaults to TInput)
+ *
+ * @example
+ * ```typescript
+ * import { BaseFactory } from '@veloxts/cli';
+ * import { faker } from '@faker-js/faker';
+ *
+ * interface UserInput {
+ *   email: string;
+ *   name: string;
+ *   role: 'admin' | 'user';
+ * }
+ *
+ * export class UserFactory extends BaseFactory<UserInput> {
+ *   modelName = 'user';
+ *
+ *   definition(): UserInput {
+ *     return {
+ *       email: faker.internet.email(),
+ *       name: faker.person.fullName(),
+ *       role: 'user',
+ *     };
+ *   }
+ *
+ *   admin(): this {
+ *     return this.state('admin');
+ *   }
+ *
+ *   constructor(prisma: PrismaClientLike) {
+ *     super(prisma);
+ *     this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+ *   }
+ * }
+ * ```
+ */
+export class BaseFactory {
+    /** Map of registered state modifiers */
+    states = new Map();
+    /** Currently active state names */
+    activeStates = [];
+    /** Prisma client for database operations */
+    prisma;
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    // ==========================================================================
+    // State Management
+    // ==========================================================================
+    /**
+     * Register a named state modifier.
+     *
+     * @param name - State name (e.g., 'admin', 'verified')
+     * @param modifier - Function that modifies attributes
+     * @returns this for chaining during construction
+     *
+     * @example
+     * ```typescript
+     * constructor(prisma: PrismaClientLike) {
+     *   super(prisma);
+     *   this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+     *   this.registerState('unverified', (attrs) => ({ ...attrs, emailVerified: null }));
+     * }
+     * ```
+     */
+    registerState(name, modifier) {
+        this.states.set(name, modifier);
+        return this;
+    }
+    /**
+     * Apply a named state modifier.
+     * Returns a new factory instance with the state applied.
+     *
+     * @param name - State name to apply
+     * @returns New factory instance with state active (preserves subclass type)
+     *
+     * @example
+     * ```typescript
+     * // Create an admin user
+     * await factory.get(UserFactory).state('admin').create();
+     *
+     * // Chain multiple states
+     * await factory.get(UserFactory).state('admin').state('verified').create();
+     *
+     * // Subclass methods preserved after state()
+     * const factory = new UserFactory(prisma);
+     * await factory.state('verified').admin().create(); // admin() still accessible
+     * ```
+     */
+    state(name) {
+        if (!this.states.has(name)) {
+            throw stateNotFound(this.constructor.name, name, Array.from(this.states.keys()));
+        }
+        // Create a shallow clone with the state added
+        const clone = Object.create(Object.getPrototypeOf(this));
+        Object.assign(clone, this);
+        clone.states = new Map(this.states);
+        clone.activeStates = [...this.activeStates, name];
+        return clone;
+    }
+    /**
+     * Get list of available state names.
+     */
+    getAvailableStates() {
+        return Array.from(this.states.keys());
+    }
+    // ==========================================================================
+    // Make (without persisting)
+    // ==========================================================================
+    /**
+     * Make a single instance without persisting to database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Generated attributes
+     */
+    make(overrides) {
+        return this.buildAttributes(overrides);
+    }
+    /**
+     * Make multiple instances without persisting to database.
+     *
+     * @param count - Number of instances to make
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of generated attributes
+     */
+    makeMany(count, overrides) {
+        return Array.from({ length: count }, () => this.buildAttributes(overrides));
+    }
+    // ==========================================================================
+    // Create (persist to database)
+    // ==========================================================================
+    /**
+     * Create a single instance in the database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Created database record
+     */
+    async create(overrides) {
+        const data = this.buildAttributes(overrides);
+        try {
+            // Access Prisma model dynamically with type-safe casting
+            // We use unknown as intermediate to avoid any, then cast to our defined type
+            const prismaWithModels = this.prisma;
+            const model = prismaWithModels[this.modelName];
+            if (!model || typeof model.create !== 'function') {
+                throw new Error(`Model '${this.modelName}' not found on Prisma client`);
+            }
+            return await model.create({ data });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            throw factoryCreateFailed(this.modelName, err);
+        }
+    }
+    /**
+     * Create multiple instances in the database.
+     *
+     * @param count - Number of instances to create
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of created database records
+     */
+    async createMany(count, overrides) {
+        const results = [];
+        // Create individually to get all returned records
+        // (createMany doesn't return created records in some databases)
+        for (let i = 0; i < count; i++) {
+            const record = await this.create(overrides);
+            results.push(record);
+        }
+        return results;
+    }
+    // ==========================================================================
+    // Private Helpers
+    // ==========================================================================
+    /**
+     * Build attributes by applying definition, states, and overrides.
+     */
+    buildAttributes(overrides) {
+        // Start with definition
+        let attrs = this.definition();
+        // Apply active states in order
+        for (const stateName of this.activeStates) {
+            const modifier = this.states.get(stateName);
+            if (modifier) {
+                attrs = { ...attrs, ...modifier(attrs) };
+            }
+        }
+        // Apply overrides last
+        if (overrides) {
+            attrs = { ...attrs, ...overrides };
+        }
+        return attrs;
+    }
+}
+// ============================================================================
+// Factory Registry
+// ============================================================================
+/**
+ * Create a factory registry for managing factory instances.
+ *
+ * The registry caches factory instances and provides type-safe access.
+ *
+ * @param prisma - Prisma client to inject into factories
+ * @returns Factory registry instance
+ *
+ * @example
+ * ```typescript
+ * const registry = createFactoryRegistry(prisma);
+ *
+ * // Get or create factory instance
+ * const userFactory = registry.get(UserFactory);
+ * await userFactory.create();
+ * ```
+ */
+export function createFactoryRegistry(prisma) {
+    // Use unknown for type-erased storage, similar to AnyGenerator pattern
+    const instances = new Map();
+    return {
+        get(FactoryClass) {
+            // Check cache first
+            let instance = instances.get(FactoryClass);
+            if (!instance) {
+                // Create new instance
+                instance = new FactoryClass(prisma);
+                instances.set(FactoryClass, instance);
+            }
+            // Type safety is maintained by the generic constraints on FactoryClass
+            return instance;
+        },
+        clear() {
+            instances.clear();
+        },
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/seeding/factory.js.map

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

package/dist/seeding/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @veloxts/cli - Database Seeding Module
+ *
+ * Laravel-inspired database seeding system with factories and seeders.
+ *
+ * @example
+ * ```typescript
+ * // In a seeder file (src/database/seeders/UserSeeder.ts)
+ * import type { Seeder, SeederContext } from '@veloxts/cli';
+ * import { UserFactory } from '../factories/UserFactory.js';
+ *
+ * export const UserSeeder: Seeder = {
+ *   name: 'UserSeeder',
+ *   dependencies: [],
+ *
+ *   async run({ db, factory, log }) {
+ *     await factory.get(UserFactory).createMany(10);
+ *     log.success('Created 10 users');
+ *   },
+ * };
+ * ```
+ *
+ * @module @veloxts/cli/seeding
+ */
+export type { BatchSeederResult, Environment, Factory, FactoryConstructor, FactoryRegistry, LoadedSeeder, PrismaClientLike, SeedCommandOptions, Seeder, SeederContext, SeederLoadResult, SeederLogger, SeederResult, SeederRunOptions, StateModifier, } from './types.js';
+export { circularDependency, dependencyNotFound, executionFailed, FactoryError, factoryCreateFailed, factoryNotFound, filesystemError, invalidExport, noSeedersFound, SeederError, SeederErrorCode, seederDatabaseError, seederNotFound, stateNotFound, truncationFailed, } from './errors.js';
+export { BaseFactory, createFactoryRegistry } from './factory.js';
+export { loadSeeders, seedersDirectoryExists } from './loader.js';
+export { SeederRegistry } from './registry.js';
+export { SeederRunner } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/seeding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seeding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,YAAY,EACV,iBAAiB,EAEjB,WAAW,EAEX,OAAO,EACP,kBAAkB,EAClB,eAAe,EAEf,YAAY,EAEZ,gBAAgB,EAEhB,kBAAkB,EAElB,MAAM,EACN,aAAa,EACb,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB,EAEnB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMlE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/seeding/index.js

@@ -0,0 +1,41 @@
+/**
+ * @veloxts/cli - Database Seeding Module
+ *
+ * Laravel-inspired database seeding system with factories and seeders.
+ *
+ * @example
+ * ```typescript
+ * // In a seeder file (src/database/seeders/UserSeeder.ts)
+ * import type { Seeder, SeederContext } from '@veloxts/cli';
+ * import { UserFactory } from '../factories/UserFactory.js';
+ *
+ * export const UserSeeder: Seeder = {
+ *   name: 'UserSeeder',
+ *   dependencies: [],
+ *
+ *   async run({ db, factory, log }) {
+ *     await factory.get(UserFactory).createMany(10);
+ *     log.success('Created 10 users');
+ *   },
+ * };
+ * ```
+ *
+ * @module @veloxts/cli/seeding
+ */
+// ============================================================================
+// Errors
+// ============================================================================
+export { circularDependency, dependencyNotFound, executionFailed, FactoryError, factoryCreateFailed, factoryNotFound, filesystemError, invalidExport, noSeedersFound, SeederError, SeederErrorCode, seederDatabaseError, 
+// Error factory functions
+seederNotFound, stateNotFound, truncationFailed, } from './errors.js';
+// ============================================================================
+// Factory System
+// ============================================================================
+export { BaseFactory, createFactoryRegistry } from './factory.js';
+// ============================================================================
+// Seeder Infrastructure
+// ============================================================================
+export { loadSeeders, seedersDirectoryExists } from './loader.js';
+export { SeederRegistry } from './registry.js';
+export { SeederRunner } from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/seeding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seeding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA+BH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB;AACnB,0BAA0B;AAC1B,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAElE,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/seeding/loader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Seeder Loader
+ *
+ * Load seeder files from the filesystem.
+ */
+import type { Seeder, SeederLoadResult } from './types.js';
+/**
+ * Default path for seeders relative to project root
+ */
+export declare const DEFAULT_SEEDERS_PATH = "src/database/seeders";
+/**
+ * Check if seeders directory exists.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ */
+export declare function seedersDirectoryExists(cwd: string, seedersPath?: string): Promise<boolean>;
+/**
+ * Load all seeders from the filesystem.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ * @returns Load result with seeders and any errors
+ */
+export declare function loadSeeders(cwd: string, seedersPath?: string): Promise<SeederLoadResult>;
+/**
+ * Load the main DatabaseSeeder entry point.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ * @returns DatabaseSeeder if found, null otherwise
+ */
+export declare function loadDatabaseSeeder(cwd: string, seedersPath?: string): Promise<Seeder | null>;
+/**
+ * Get all seeder file paths from directory.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ */
+export declare function getSeederFiles(cwd: string, seedersPath?: string): Promise<string[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/seeding/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/seeding/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAgB,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMzE;;GAEG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAgB3D;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,gBAAgB,CAAC,CA0C3B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAiGD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB"}