@engjts/nexus 0.1.0

package/dist/core/store/types.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * ContextStore Types
+ * State management system inspired by Flutter's Provider pattern
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextStore = void 0;
+/**
+ * Base abstract class for ContextStore
+ * Extend this class to create your own stores
+ *
+ * @example
+ * ```typescript
+ * interface UserState {
+ *   users: User[];
+ *   loading: boolean;
+ * }
+ *
+ * class UserStore extends ContextStore<UserState> {
+ *   protected initial(): UserState {
+ *     return { users: [], loading: false };
+ *   }
+ *
+ *   async fetchUsers() {
+ *     this.set({ ...this.state, loading: true });
+ *     const users = await api.getUsers();
+ *     this.set({ users, loading: false });
+ *   }
+ * }
+ * ```
+ */
+class ContextStore {
+    _state;
+    _listeners = new Set();
+    _disposeCallbacks = [];
+    _options;
+    _initialized = false;
+    constructor(options = {}) {
+        this._options = options;
+        this._state = this.initial();
+        this._initialized = true;
+    }
+    /**
+     * Get current state (readonly)
+     */
+    get state() {
+        return this._state;
+    }
+    /**
+     * Get store name for debugging
+     */
+    get name() {
+        return this._options.name || this.constructor.name;
+    }
+    /**
+     * Update state and notify all listeners
+     *
+     * @param newState - New state or partial state update
+     */
+    set(newState) {
+        const prevState = this._state;
+        this._state = newState;
+        if (this._options.debug) {
+            console.log(`[ContextStore:${this.name}] State updated:`, {
+                prev: prevState,
+                next: newState
+            });
+        }
+        // Notify all listeners
+        this._listeners.forEach(listener => {
+            try {
+                listener(this._state, prevState);
+            }
+            catch (error) {
+                console.error(`[ContextStore:${this.name}] Listener error:`, error);
+            }
+        });
+    }
+    /**
+     * Update state partially (merge with current state)
+     * Only works if state is an object
+     *
+     * @param partial - Partial state to merge
+     */
+    update(partial) {
+        if (typeof this._state === 'object' && this._state !== null) {
+            this.set({ ...this._state, ...partial });
+        }
+        else {
+            throw new Error(`[ContextStore:${this.name}] update() only works with object state`);
+        }
+    }
+    /**
+     * Listen to state changes
+     * Returns unsubscribe function
+     *
+     * @param listener - Callback function called on state change
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = store.listen((state, prevState) => {
+     *   console.log('State changed:', state);
+     * });
+     *
+     * // Later: cleanup
+     * unsubscribe();
+     * ```
+     */
+    listen(listener) {
+        this._listeners.add(listener);
+        const unsubscribe = () => {
+            this._listeners.delete(listener);
+        };
+        // Track for auto-dispose
+        this._disposeCallbacks.push(unsubscribe);
+        return unsubscribe;
+    }
+    /**
+     * Get listener count (useful for debugging)
+     */
+    get listenerCount() {
+        return this._listeners.size;
+    }
+    /**
+     * Check if store is initialized
+     */
+    get isInitialized() {
+        return this._initialized;
+    }
+    /**
+     * Reset state to initial value
+     */
+    reset() {
+        this.set(this.initial());
+    }
+    /**
+     * Dispose store and cleanup all listeners
+     * Called automatically when store is removed from registry
+     */
+    dispose() {
+        if (this._options.debug) {
+            console.log(`[ContextStore:${this.name}] Disposing...`);
+        }
+        // Clear all listeners
+        this._listeners.clear();
+        // Call all dispose callbacks
+        this._disposeCallbacks.forEach(cb => {
+            try {
+                cb();
+            }
+            catch (error) {
+                console.error(`[ContextStore:${this.name}] Dispose callback error:`, error);
+            }
+        });
+        this._disposeCallbacks = [];
+        // Call lifecycle hook
+        this.onDispose();
+    }
+    /**
+     * Lifecycle hook: called when store is disposed
+     * Override to add custom cleanup logic
+     */
+    onDispose() {
+        // Override in subclass if needed
+    }
+    /**
+     * Lifecycle hook: called when store is first accessed
+     * Override to add initialization logic (e.g., fetch initial data)
+     */
+    onInit() {
+        // Override in subclass if needed
+    }
+}
+exports.ContextStore = ContextStore;
+//# sourceMappingURL=types.js.map

package/dist/core/store/types.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,470 @@
+/**
+ * Core type definitions for the Nexus Framework
+ * Provides type-safe interfaces for requests, responses, middleware, and routing
+ */
+import { IncomingMessage, ServerResponse } from 'http';
+import { ZodSchema } from 'zod';
+import { Application } from './application';
+import { ContextStore, StoreConstructor, RequestStore, RequestStoreConstructor } from './store';
+/**
+ * HTTP methods supported by the framework
+ */
+export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+/**
+ * HTTP headers type-safe wrapper
+ */
+export interface Headers {
+    [key: string]: string | string[] | undefined;
+}
+/**
+ * Cookie parser and manager
+ */
+export interface Cookies {
+    get(name: string): string | undefined;
+    set(name: string, value: string, options?: CookieOptions): void;
+    delete(name: string): void;
+}
+/**
+ * Cookie configuration options
+ */
+export interface CookieOptions {
+    maxAge?: number;
+    expires?: Date;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+/**
+ * Response builder for fluent API
+ */
+export interface ResponseBuilder {
+    status(code: number): ResponseBuilder;
+    header(name: string, value: string): ResponseBuilder;
+    json<T>(data: T): Response;
+    html(content: string): Response;
+    text(content: string): Response;
+    redirect(url: string, status?: number): Response;
+    stream(readable: NodeJS.ReadableStream): Response;
+}
+/**
+ * Framework response object
+ */
+export interface Response {
+    statusCode: number;
+    headers: Headers;
+    body: any;
+    stream?: NodeJS.ReadableStream;
+}
+/**
+ * Unified context object containing request and response data
+ * This replaces the traditional req/res pattern with an immutable context
+ */
+export interface Context {
+    method: HTTPMethod;
+    path: string;
+    url: URL;
+    params: Record<string, string>;
+    query: Record<string, any>;
+    body: any;
+    headers: Headers;
+    cookies: Cookies;
+    raw: {
+        req: IncomingMessage;
+        res: ServerResponse;
+    };
+    response: ResponseBuilder;
+    /** Access a registered global store by its class (singleton, persist across requests) */
+    store<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): T;
+    /** Access a request-scoped store by its class (per-request, disposed after response) */
+    requestStore<T extends RequestStore<any>>(StoreClass: RequestStoreConstructor<T>): T;
+    /** Set a value in request-scoped storage */
+    set<T = any>(key: string, value: T): void;
+    /** Get a value from request-scoped storage */
+    get<T = any>(key: string): T | undefined;
+    json<T>(data: T, status?: number): Response;
+    html(content: string, status?: number): Response;
+    text(content: string, status?: number): Response;
+    redirect(url: string, status?: number): Response;
+    stream(readable: NodeJS.ReadableStream): Response;
+    [key: string]: any;
+}
+/**
+ * Next function for middleware chain
+ */
+export type Next<TContext = Context> = (ctx: TContext) => Promise<Response>;
+/**
+ * Middleware function signature
+ * Middleware can transform the context and pass it to the next handler
+ * Now supports optional dependency injection as the third parameter.
+ *
+ * @template TIn - Input context type
+ * @template TOut - Output context type (after transformation)
+ * @template TDeps - Dependencies type (injected from app.provide())
+ *
+ * @example
+ * ```typescript
+ * // Simple middleware (no deps)
+ * const loggerMiddleware: Middleware = async (ctx, next) => {
+ *   console.log(`${ctx.method} ${ctx.path}`);
+ *   return next(ctx);
+ * };
+ *
+ * // Middleware with dependencies
+ * const authMiddleware: Middleware<Context, Context, { jwt: JWTService; db: Database }> =
+ *   async (ctx, next, { jwt, db }) => {
+ *     const token = ctx.headers.authorization?.replace('Bearer ', '');
+ *     const payload = await jwt.verify(token);
+ *     ctx.user = await db.findUser(payload.userId);
+ *     return next(ctx);
+ *   };
+ * ```
+ */
+export type Middleware<TIn = Context, TOut = Context, TDeps = any> = (ctx: TIn, next: Next<TOut>, deps: TDeps) => Promise<Response>;
+/**
+ * Route handler function signature
+ * Handlers can return data directly or a Response object
+ */
+export type Handler<TContext = Context, TDeps = any> = (ctx: TContext, deps: TDeps) => Promise<Response | any>;
+/**
+ * Dependency container type
+ * Maps dependency names to their instances
+ */
+export type DependencyContainer = Record<string, any>;
+/**
+ * Extract dependency types from container
+ */
+export type ExtractDeps<T extends DependencyContainer, K extends keyof T> = {
+    [P in K]: T[P];
+};
+/**
+ * Route configuration with dependency injection
+ */
+export interface InjectedRouteConfig<TContext = Context, TDeps extends DependencyContainer = DependencyContainer, TKeys extends keyof TDeps = keyof TDeps> {
+    /** Dependencies to inject into handler */
+    inject?: TKeys[];
+    /** Route handler with injected dependencies */
+    handler: (ctx: TContext, deps: Pick<TDeps, TKeys>) => Promise<Response | any>;
+    /** Middleware chain */
+    middlewares?: Middleware<any, any>[];
+    /** Schema validation */
+    schema?: SchemaConfig;
+    /** Route metadata */
+    meta?: RouteMeta;
+}
+/**
+ * Validation error detail from Zod
+ */
+export interface ValidationErrorDetail {
+    path: (string | number)[];
+    message: string;
+    code: string;
+}
+/**
+ * Custom validation error handler
+ */
+export type ValidationErrorHandler = (errors: ValidationErrorDetail[], ctx: Context) => Response | any;
+/**
+ * Schema validation configuration
+ */
+export interface SchemaConfig {
+    params?: ZodSchema;
+    query?: ZodSchema;
+    body?: ZodSchema;
+    headers?: ZodSchema;
+    onValidationError?: ValidationErrorHandler;
+}
+/**
+ * Route metadata for documentation and API generation
+ */
+export interface RouteMeta {
+    description?: string;
+    tags?: string[];
+    responses?: Record<number, string>;
+    deprecated?: boolean;
+    summary?: string;
+    example?: string;
+}
+/**
+ * Route configuration object
+ */
+export interface RouteConfig<TContext = Context> {
+    method: HTTPMethod;
+    path: string;
+    handler: Handler<TContext>;
+    middlewares?: Middleware<any, any>[];
+    schema?: SchemaConfig;
+    meta?: RouteMeta;
+}
+/**
+ * Route match result from router
+ */
+export interface RouteMatch {
+    handler: Handler;
+    params: Record<string, string>;
+    middlewares: Middleware[];
+    schema?: SchemaConfig;
+}
+/**
+ * Error handler function signature
+ */
+export type ErrorHandler = (error: Error, ctx: Context) => Response | Promise<Response>;
+/**
+ * Application configuration options
+ */
+export interface AppConfig {
+    contextPoolSize?: number;
+    enableJIT?: boolean;
+    onError?: ErrorHandler;
+    debug?: boolean;
+    logRequests?: boolean;
+}
+/**
+ * Plugin interface for extensibility
+ */
+export interface Plugin {
+    name: string;
+    version: string;
+    install: (app: Application) => void | Promise<void>;
+}
+/**
+ * Base interface for class-based route definitions
+ *
+ * @example
+ * ```typescript
+ * class UserRegister implements RouteBase {
+ *   pathName = '/api/users/register';
+ *
+ *   schema() {
+ *     return { body: z.object({ email: z.string().email() }) };
+ *   }
+ *
+ *   meta() {
+ *     return { summary: 'Register user', tags: ['Users'] };
+ *   }
+ *
+ *   async handler(ctx: Context) {
+ *     return { success: true };
+ *   }
+ * }
+ *
+ * app.post(new UserRegister());
+ * ```
+ */
+export interface RouteBase<TContext = Context> {
+    /** The route path (e.g., '/api/users/:id') - Optional for file-based routing */
+    pathName?: string;
+    /**
+     * HTTP method(s) this route handles - Optional for file-based routing
+     * When using file-based routing, you can define method handlers (GET, POST, etc.) as methods
+     */
+    method?: HTTPMethod | HTTPMethod[];
+    /** Optional schema validation */
+    schema?: () => SchemaConfig;
+    /** Optional route metadata for documentation */
+    meta?: () => RouteMeta;
+    /** Optional route-specific middlewares */
+    middlewares?: () => Middleware<any, any>[];
+    /** The route handler (can be omitted if using method-named handlers like GET, POST, etc.) */
+    handler?: Handler<TContext>;
+    /** Method-specific handlers for file-based routing */
+    GET?: Handler<TContext>;
+    POST?: Handler<TContext>;
+    PUT?: Handler<TContext>;
+    DELETE?: Handler<TContext>;
+    PATCH?: Handler<TContext>;
+    HEAD?: Handler<TContext>;
+    OPTIONS?: Handler<TContext>;
+}
+/**
+ * Abstract base class for class-based routes with REQUIRED handler implementation.
+ * Use this when you want TypeScript to enforce that the handler method is implemented.
+ * Also provides lifecycle hooks for request processing and dependency injection.
+ *
+ * @example
+ * ```typescript
+ * // With dependency injection
+ * class UserRegister extends Route<Context, { db: Database; cache: Redis }> {
+ *   pathName = '/api/users/register';
+ *
+ *   // Optional: run before handler (with deps)
+ *   async onBefore(ctx: Context, { db }: { db: Database }) {
+ *     console.log('Before handler, db connected:', db.isConnected);
+ *   }
+ *
+ *   // Optional: transform response after handler (with deps)
+ *   async onAfter(ctx: Context, result: any, { cache }: { cache: Redis }) {
+ *     await cache.set('last-register', JSON.stringify(result));
+ *     return { ...result, timestamp: Date.now() };
+ *   }
+ *
+ *   // Optional: custom error handling (with deps)
+ *   async onError(ctx: Context, error: Error, deps) {
+ *     return { error: error.message, code: 'CUSTOM_ERROR' };
+ *   }
+ *
+ *   // REQUIRED: handler with dependencies
+ *   async handler(ctx: Context, { db, cache }) {
+ *     const user = await db.query('INSERT INTO users...');
+ *     await cache.set(`user:${user.id}`, user);
+ *     return { success: true, user };
+ *   }
+ * }
+ *
+ * app.provide({ db, cache }).post(new UserRegister());
+ * ```
+ */
+export declare abstract class Route<TContext = Context, TDeps = any> {
+    pathName?: string;
+    /**
+     * The main route handler - REQUIRED!
+     * TypeScript will enforce this is implemented.
+     * @param ctx - Request context
+     * @param deps - Injected dependencies from app.provide()
+     */
+    abstract handler(ctx: TContext, deps: TDeps): Promise<any> | any;
+    /**
+     * Return a successful JSON response
+     * @param data - The response data to send
+     * @returns Object with success: true merged with data
+     *
+     * @example
+     * ```typescript
+     * return this.ok({ user: { id: 1, name: 'John' } });
+     * // Returns: { success: true, user: { id: 1, name: 'John' } }
+     * ```
+     */
+    protected ok<T extends Record<string, any>>(data: T): {
+        success: true;
+    } & T;
+    /**
+     * Return a failed JSON response with status code
+     * @param ctx - The request context
+     * @param status - HTTP status code (e.g., 400, 404, 500)
+     * @param message - Error message
+     * @param data - Optional additional error data
+     * @returns Response object with error details
+     *
+     * @example
+     * ```typescript
+     * return this.fail(ctx, 404, 'User not found');
+     * // Returns 404 with: { success: false, message: 'User not found' }
+     *
+     * return this.fail(ctx, 400, 'Validation failed', { errors: [...] });
+     * // Returns 400 with: { success: false, message: 'Validation failed', data: { errors: [...] } }
+     * ```
+     */
+    protected fail(ctx: TContext, status: number, message: string, data?: any): Response;
+    /**
+     * HTTP method(s) this route handles - Optional
+     * When using file-based routing, you can also define method handlers (GET, POST, etc.)
+     */
+    method?: HTTPMethod | HTTPMethod[];
+    /**
+     * Hook: Called BEFORE the handler.
+     * - Return undefined/void to continue to handler
+     * - Return a value to skip handler and use that as response
+     * - Throw an error to trigger onError
+     * @param ctx - Request context
+     * @param deps - Injected dependencies from app.provide()
+     */
+    onBefore?(ctx: TContext, deps: TDeps): Promise<any | void> | any | void;
+    /**
+     * Hook: Called AFTER the handler completes successfully.
+     * - Receives the handler result
+     * - Can transform/modify the response
+     * - Return the (modified) result
+     * @param ctx - Request context
+     * @param result - Handler result
+     * @param deps - Injected dependencies from app.provide()
+     */
+    onAfter?(ctx: TContext, result: any, deps: TDeps): Promise<any> | any;
+    /**
+     * Hook: Called when handler or onBefore throws an error.
+     * - Can return a custom error response
+     * - If not defined, error propagates to global error handler
+     * @param ctx - Request context
+     * @param error - Error thrown
+     * @param deps - Injected dependencies from app.provide()
+     */
+    onError?(ctx: TContext, error: Error, deps: TDeps): Promise<any> | any;
+    /** Optional schema validation */
+    schema?(): SchemaConfig;
+    /** Optional route metadata for documentation */
+    meta?(): RouteMeta;
+    /** Optional route-specific middlewares */
+    middlewares?(): Middleware<any, any>[];
+}
+/**
+ * Type guard to check if a route is a Route class instance (with hooks support)
+ */
+export declare function isRouteClass(route: RouteBase | Route): route is Route;
+/**
+ * Lifecycle hooks for request processing
+ *
+ * @example
+ * ```typescript
+ * app.hooks({
+ *   onRequest: async (ctx) => {
+ *     ctx.requestId = crypto.randomUUID();
+ *   },
+ *   beforeHandler: async (ctx) => {
+ *     ctx.user = await getUser(ctx.headers.authorization);
+ *   },
+ *   afterHandler: async (ctx, result) => {
+ *     return { ...result, timestamp: Date.now() };
+ *   },
+ *   onError: async (ctx, error) => {
+ *     await logToSentry(error);
+ *   }
+ * });
+ * ```
+ */
+export interface LifecycleHooks {
+    /** Called when request is received, before any processing */
+    onRequest?: (ctx: Context) => Promise<void | Response> | void | Response;
+    /** Called before schema validation */
+    beforeValidation?: (ctx: Context) => Promise<void | Response> | void | Response;
+    /** Called after schema validation succeeds (ctx.body, ctx.query, ctx.params are validated) */
+    afterValidation?: (ctx: Context) => Promise<void | Response> | void | Response;
+    /** Called before route handler executes */
+    beforeHandler?: (ctx: Context) => Promise<void | Response> | void | Response;
+    /** Called after handler, can transform result. Return new result to override */
+    afterHandler?: (ctx: Context, result: any) => Promise<any> | any;
+    /** Called when an error occurs. Can return Response to handle error */
+    onError?: (ctx: Context, error: Error) => Promise<void | Response> | void | Response;
+    /** Called before response is sent (after all processing) */
+    onResponse?: (ctx: Context, response: Response) => Promise<void | Response> | void | Response;
+}
+/**
+ * Versioning strategy types
+ */
+export type VersioningStrategy = 'path' | 'header' | 'query';
+/**
+ * Versioning configuration for API versioning
+ *
+ * @example
+ * ```typescript
+ * app.configVersions({
+ *   strategies: ['header', 'query'],
+ *   header: 'api-version',
+ *   queryParam: 'v',
+ *   defaultVersion: 'v1',
+ *   register: ['v1', 'v2']
+ * });
+ * ```
+ */
+export interface VersioningConfig {
+    /** Versioning strategies to use */
+    strategies: VersioningStrategy[];
+    /** Header name for version (default: 'api-version') */
+    header?: string;
+    /** Query param name for version (default: 'v') */
+    queryParam?: string;
+    /** Default version when not specified */
+    defaultVersion: string;
+    /** List of versions to register */
+    register: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAiB,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE/G;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;IACrD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjD,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,GAAG,QAAQ,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IAEpB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IAGT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IAGjB,GAAG,EAAE;QACD,GAAG,EAAE,eAAe,CAAC;QACrB,GAAG,EAAE,cAAc,CAAC;KACvB,CAAC;IAGF,QAAQ,EAAE,eAAe,CAAC;IAG1B,yFAAyF;IACzF,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEvE,wFAAwF;IACxF,YAAY,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAGrF,4CAA4C;IAC5C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAE1C,8CAA8C;IAC9C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAGzC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjD,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,GAAG,QAAQ,CAAC;IAGlD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,UAAU,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE,KAAK,GAAG,GAAG,IAAI,CACjE,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAChB,IAAI,EAAE,KAAK,KACV,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,GAAG,IAAI,CACnD,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,KAAK,KACV,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;AAE7B;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,mBAAmB,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI;KACvE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAChC,QAAQ,GAAG,OAAO,EAClB,KAAK,SAAS,mBAAmB,GAAG,mBAAmB,EACvD,KAAK,SAAS,MAAM,KAAK,GAAG,MAAM,KAAK;IAEvC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,+CAA+C;IAC/C,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IAC9E,uBAAuB;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,qBAAqB;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACjC,MAAM,EAAE,qBAAqB,EAAE,EAC/B,GAAG,EAAE,OAAO,KACX,QAAQ,GAAG,GAAG,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC3C,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,WAAW,CAAC,EAAE,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACvB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,OAAO,KACX,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,SAAS;IAEtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,OAAO,CAAC,EAAE,YAAY,CAAC;IAGvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS,CAAC,QAAQ,GAAG,OAAO;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IAEnC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;IAE5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;IAEvB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAE3C,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5B,sDAAsD;IACtD,GAAG,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,8BAAsB,KAAK,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,GAAG;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG;IAMhE;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,GAAG,CAAC;IAI3E;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,QAAQ;IAMpF;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IAEnC;;;;;;;OAOG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI;IAEvE;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG;IAErE;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG;IAEtE,iCAAiC;IACjC,MAAM,CAAC,IAAI,YAAY;IAEvB,gDAAgD;IAChD,IAAI,CAAC,IAAI,SAAS;IAElB,0CAA0C;IAC1C,WAAW,CAAC,IAAI,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;CACzC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,IAAI,KAAK,CAOrE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;IAEzE,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;IAEhF,8FAA8F;IAC9F,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;IAE/E,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;IAE7E,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAEjE,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;IAErF,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;CACjG;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC7B,mCAAmC;IACnC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB"}