@miiajs/core 0.1.0

package/dist/exceptions.js

@@ -0,0 +1,67 @@
+const STATUS_TEXT = {
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    405: 'Method Not Allowed',
+    409: 'Conflict',
+    422: 'Unprocessable Entity',
+    429: 'Too Many Requests',
+    500: 'Internal Server Error',
+    502: 'Bad Gateway',
+    503: 'Service Unavailable',
+};
+export class HttpException extends Error {
+    statusCode;
+    details;
+    constructor(statusCode, message, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = this.constructor.name;
+    }
+    toJSON() {
+        return {
+            statusCode: this.statusCode,
+            error: STATUS_TEXT[this.statusCode] ?? 'Error',
+            message: this.message,
+            ...(this.details ? { details: this.details } : {}),
+        };
+    }
+}
+export class BadRequestException extends HttpException {
+    constructor(message = 'Bad Request', details) {
+        super(400, message, details);
+    }
+}
+export class UnauthorizedException extends HttpException {
+    constructor(message = 'Unauthorized', details) {
+        super(401, message, details);
+    }
+}
+export class ForbiddenException extends HttpException {
+    constructor(message = 'Forbidden', details) {
+        super(403, message, details);
+    }
+}
+export class NotFoundException extends HttpException {
+    constructor(message = 'Not Found', details) {
+        super(404, message, details);
+    }
+}
+export class ConflictException extends HttpException {
+    constructor(message = 'Conflict', details) {
+        super(409, message, details);
+    }
+}
+export class UnprocessableException extends HttpException {
+    constructor(message = 'Unprocessable Entity', details) {
+        super(422, message, details);
+    }
+}
+export class InternalServerException extends HttpException {
+    constructor(message = 'Internal Server Error', details) {
+        super(500, message, details);
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,qBAAqB;CAC3B,CAAA;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE7B;IAEA;IAHT,YACS,UAAkB,EACzB,OAAe,EACR,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAA;QAJP,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IACnC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,OAAO;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAO,GAAG,aAAa,EAAE,OAAiB;QACpD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAO,GAAG,cAAc,EAAE,OAAiB;QACrD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAO,GAAG,WAAW,EAAE,OAAiB;QAClD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAO,GAAG,WAAW,EAAE,OAAiB;QAClD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAO,GAAG,UAAU,EAAE,OAAiB;QACjD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,YAAY,OAAO,GAAG,sBAAsB,EAAE,OAAiB;QAC7D,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,OAAO,GAAG,uBAAuB,EAAE,OAAiB;QAC9D,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import './polyfill.js';
+export { Miia } from './app/index.js';
+export type { MiiaOptions } from './app/index.js';
+export { LogLevel, Logger, ConsoleLogger } from './logger.js';
+export type { LoggerService, LoggerConfig } from './logger.js';
+export { Container, inject, injectOptional, runInContainerContext } from './di-container.js';
+export { Resolver } from './resolver.js';
+export { DiscoveryService } from './discovery/index.js';
+export type { DiscoveredMethod, DiscoverableMethodMeta } from './discovery/index.js';
+export { Injectable, Controller, Module } from './decorators/index.js';
+export type { InjectableOptions } from './decorators/index.js';
+export { Get, Post, Put, Patch, Delete, Head, Options } from './decorators/index.js';
+export { Use, UseGuard, SkipGuard, ValidateBody, ValidateQuery, ValidateParams, Status } from './decorators/index.js';
+export { createClassDecorator, createMethodDecorator, createFieldDecorator, createDecorator, applyDecorators, } from './decorators/index.js';
+export { getMeta, setMeta, pushMeta, addToMapMeta, setInMapMeta, INJECTABLE, MODULE, PREFIX, RESOLVED_PREFIX, ROUTES, CLASS_MW, METHOD_MW, STATUSES, CLASS_GUARDS, METHOD_GUARDS, SKIP_GUARDS, GUARD_FACTORY, BODY_SCHEMAS, QUERY_SCHEMAS, PARAMS_SCHEMAS, } from './decorators/index.js';
+export { Router } from './router.js';
+export { compose } from './middleware.js';
+export { HttpException, BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, ConflictException, UnprocessableException, InternalServerException, } from './exceptions.js';
+export { ResponseBuilder } from './response.js';
+export { cors } from './cors.js';
+export { resolveOptions } from './utils/index.js';
+export type { OptionsOrFactory } from './utils/index.js';
+export type { Constructor, Resolve, Scope, Middleware, CanActivate, Guard, FactoryProvider, ProviderDefinition, ModuleOptions, ConfiguredModule, ZodLike, ZodLikeIssue, HttpMethod, RouteDefinition, RequestContext, ListenInfo, ServerHandle, ListenAdapter, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAA;AAGtB,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC7D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGpF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACrH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,MAAM,EACN,MAAM,EACN,eAAe,EACf,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAGzC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGxD,YAAY,EACV,WAAW,EACX,OAAO,EACP,KAAK,EACL,UAAU,EACV,WAAW,EACX,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,31 @@
+// @miiajs/core - public API
+// Polyfill must be first - decorators execute at module load time
+import './polyfill.js';
+// Application
+export { Miia } from './app/index.js';
+// Logger
+export { LogLevel, Logger, ConsoleLogger } from './logger.js';
+// DI Container
+export { Container, inject, injectOptional, runInContainerContext } from './di-container.js';
+export { Resolver } from './resolver.js';
+// Discovery
+export { DiscoveryService } from './discovery/index.js';
+// Decorators
+export { Injectable, Controller, Module } from './decorators/index.js';
+export { Get, Post, Put, Patch, Delete, Head, Options } from './decorators/index.js';
+export { Use, UseGuard, SkipGuard, ValidateBody, ValidateQuery, ValidateParams, Status } from './decorators/index.js';
+export { createClassDecorator, createMethodDecorator, createFieldDecorator, createDecorator, applyDecorators, } from './decorators/index.js';
+export { getMeta, setMeta, pushMeta, addToMapMeta, setInMapMeta, INJECTABLE, MODULE, PREFIX, RESOLVED_PREFIX, ROUTES, CLASS_MW, METHOD_MW, STATUSES, CLASS_GUARDS, METHOD_GUARDS, SKIP_GUARDS, GUARD_FACTORY, BODY_SCHEMAS, QUERY_SCHEMAS, PARAMS_SCHEMAS, } from './decorators/index.js';
+// Router
+export { Router } from './router.js';
+// Middleware
+export { compose } from './middleware.js';
+// Exceptions
+export { HttpException, BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, ConflictException, UnprocessableException, InternalServerException, } from './exceptions.js';
+// Response
+export { ResponseBuilder } from './response.js';
+// Built-in Middleware
+export { cors } from './cors.js';
+// Utilities
+export { resolveOptions } from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,kEAAkE;AAClE,OAAO,eAAe,CAAA;AAEtB,cAAc;AACd,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAGrC,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG7D,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGvD,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEtE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACrH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,MAAM,EACN,MAAM,EACN,eAAe,EACf,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAA;AAE9B,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC,aAAa;AACb,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAExB,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,sBAAsB;AACtB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,43 @@
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    LOG = 2,
+    DEBUG = 3
+}
+export interface LoggerService {
+    log(message: string, context?: string): void;
+    error(message: string, trace?: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    debug?(message: string, context?: string): void;
+}
+export interface LoggerConfig {
+    level?: LogLevel;
+    json?: boolean;
+    appName?: string;
+}
+export declare class ConsoleLogger implements LoggerService {
+    private level;
+    private json;
+    private appName;
+    private lastTimestamp;
+    constructor(config?: LoggerConfig);
+    log(message: string, context?: string): void;
+    error(message: string, trace?: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    debug(message: string, context?: string): void;
+    private printError;
+    private print;
+    private printJson;
+}
+export declare class Logger implements LoggerService {
+    private context?;
+    private static instance;
+    constructor(context?: string | undefined);
+    log(message: string, context?: string): void;
+    error(message: string, trace?: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    debug(message: string, context?: string): void;
+    static setLogger(logger: LoggerService): void;
+    static getLogger(): LoggerService;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,GAAG,IAAI;IACP,KAAK,IAAI;CACV;AAID,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7C,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChD;AAID,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAkBD,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAa;gBAEtB,MAAM,CAAC,EAAE,YAAY;IAMjC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAK5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9C,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,KAAK;IA+Bb,OAAO,CAAC,SAAS;CAalB;AAID,qBAAa,MAAO,YAAW,aAAa;IAG9B,OAAO,CAAC,OAAO,CAAC;IAF5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;gBAExC,OAAO,CAAC,EAAE,MAAM,YAAA;IAEpC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9C,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAI7C,MAAM,CAAC,SAAS,IAAI,aAAa;CAGlC"}

package/dist/logger.js

@@ -0,0 +1,123 @@
+// ─── Log Levels ─────────────────────────────────────────────────
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["LOG"] = 2] = "LOG";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (LogLevel = {}));
+// ─── ANSI Colors ─────────────────────────────────────────────────
+const color = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    white: '\x1b[37m',
+};
+// ─── Default Console Logger (colored format) ────────────────────
+export class ConsoleLogger {
+    level;
+    json;
+    appName;
+    lastTimestamp = Date.now();
+    constructor(config) {
+        this.level = config?.level ?? LogLevel.LOG;
+        this.json = config?.json ?? false;
+        this.appName = config?.appName ?? 'Miia';
+    }
+    log(message, context) {
+        if (LogLevel.LOG > this.level)
+            return;
+        this.json ? this.printJson('LOG', message, context) : this.print('LOG', message, context, color.green);
+    }
+    error(message, trace, context) {
+        if (LogLevel.ERROR > this.level)
+            return;
+        this.json ? this.printJson('ERROR', message, context, trace) : this.printError(message, trace, context);
+    }
+    warn(message, context) {
+        if (LogLevel.WARN > this.level)
+            return;
+        this.json ? this.printJson('WARN', message, context) : this.print('WARN', message, context, color.yellow);
+    }
+    debug(message, context) {
+        if (LogLevel.DEBUG > this.level)
+            return;
+        this.json ? this.printJson('DEBUG', message, context) : this.print('DEBUG', message, context, color.magenta);
+    }
+    printError(message, trace, context) {
+        this.print('ERROR', message, context, color.red);
+        if (trace)
+            console.error(`${color.red}${trace}${color.reset}`);
+    }
+    print(level, message, context, levelColor = '') {
+        const pid = typeof process !== 'undefined' ? process.pid : 0;
+        const now = Date.now();
+        const d = new Date(now);
+        const yyyy = d.getFullYear();
+        const MM = String(d.getMonth() + 1).padStart(2, '0');
+        const dd = String(d.getDate()).padStart(2, '0');
+        let hh = d.getHours();
+        const ampm = hh >= 12 ? 'PM' : 'AM';
+        hh = hh % 12 || 12;
+        const mm = String(d.getMinutes()).padStart(2, '0');
+        const ss = String(d.getSeconds()).padStart(2, '0');
+        const ms = String(d.getMilliseconds()).padStart(3, '0');
+        const timestamp = `${yyyy}-${MM}-${dd} ${String(hh).padStart(2, '0')}:${mm}:${ss}.${ms} ${ampm}`;
+        const delta = now - this.lastTimestamp;
+        this.lastTimestamp = now;
+        const deltaStr = delta >= 1000 ? `+${(delta / 1000).toFixed(1)}s` : `+${delta}ms`;
+        const ctx = context ? `${color.yellow}[${context}]${color.reset} ` : '';
+        const method = level === 'ERROR' ? console.error : level === 'WARN' ? console.warn : console.log;
+        method(`${levelColor}[${this.appName}]${color.reset} ` +
+            `${pid} ${timestamp} ` +
+            `${levelColor}${level.padEnd(5)}${color.reset} ` +
+            `${ctx}` +
+            `${levelColor}${message}${color.reset} ` +
+            `${color.yellow}${deltaStr}${color.reset}`);
+    }
+    printJson(level, message, context, trace) {
+        const entry = {
+            app: this.appName,
+            level,
+            message,
+            ...(context && { context }),
+            ...(trace && { trace }),
+            timestamp: new Date().toISOString(),
+            pid: typeof process !== 'undefined' ? process.pid : 0,
+        };
+        const method = level === 'ERROR' ? console.error : level === 'WARN' ? console.warn : console.log;
+        method(JSON.stringify(entry));
+    }
+}
+// ─── Logger (for use in services/controllers) ────────────────────
+export class Logger {
+    context;
+    static instance = new ConsoleLogger();
+    constructor(context) {
+        this.context = context;
+    }
+    log(message, context) {
+        Logger.instance.log(message, context ?? this.context);
+    }
+    error(message, trace, context) {
+        Logger.instance.error(message, trace, context ?? this.context);
+    }
+    warn(message, context) {
+        Logger.instance.warn(message, context ?? this.context);
+    }
+    debug(message, context) {
+        Logger.instance.debug?.(message, context ?? this.context);
+    }
+    static setLogger(logger) {
+        Logger.instance = logger;
+    }
+    static getLogger() {
+        return Logger.instance;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/middleware.d.ts

@@ -0,0 +1,4 @@
+import type { Middleware, RequestContext } from './types.js';
+export declare function compose(middlewares: Middleware[]): Middleware;
+export declare function guardToMiddleware(fn: (ctx: RequestContext) => boolean | Promise<boolean>): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAK5D,wBAAgB,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAiB7D;AAID,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,UAAU,CAYrG"}

package/dist/middleware.js

@@ -0,0 +1,36 @@
+import { ForbiddenException } from './exceptions.js';
+// ─── Compose (Koa-style onion model) ────────────────────────────
+export function compose(middlewares) {
+    return async (ctx, next) => {
+        let index = -1;
+        async function dispatch(i) {
+            if (i <= index)
+                throw new Error('next() called multiple times');
+            index = i;
+            if (i < middlewares.length) {
+                await middlewares[i](ctx, () => dispatch(i + 1));
+            }
+            else {
+                await next();
+            }
+        }
+        await dispatch(0);
+    };
+}
+// ─── Guard → Middleware conversion (internal) ────────────────────
+export function guardToMiddleware(fn) {
+    return (ctx, next) => {
+        const result = fn(ctx);
+        if (result instanceof Promise) {
+            return result.then((allowed) => {
+                if (!allowed)
+                    throw new ForbiddenException();
+                return next();
+            });
+        }
+        if (!result)
+            throw new ForbiddenException();
+        return next();
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,mEAAmE;AAEnE,MAAM,UAAU,OAAO,CAAC,WAAyB;IAC/C,OAAO,KAAK,EAAE,GAAmB,EAAE,IAAyB,EAAE,EAAE;QAC9D,IAAI,KAAK,GAAG,CAAC,CAAC,CAAA;QAEd,KAAK,UAAU,QAAQ,CAAC,CAAS;YAC/B,IAAI,CAAC,IAAI,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;YAC/D,KAAK,GAAG,CAAC,CAAA;YAET,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC3B,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAClD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,EAAE,CAAA;YACd,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CAAA;AACH,CAAC;AAED,oEAAoE;AAEpE,MAAM,UAAU,iBAAiB,CAAC,EAAuD;IACvF,OAAO,CAAC,GAAmB,EAAE,IAAyB,EAAE,EAAE;QACxD,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,kBAAkB,EAAE,CAAA;gBAC5C,OAAO,IAAI,EAAE,CAAA;YACf,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,kBAAkB,EAAE,CAAA;QAC3C,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}

package/dist/polyfill.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=polyfill.d.ts.map

package/dist/polyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfill.d.ts","sourceRoot":"","sources":["../src/polyfill.ts"],"names":[],"mappings":""}

package/dist/polyfill.js

@@ -0,0 +1,6 @@
+// Polyfill Symbol.metadata for runtimes that don't support it natively.
+// Must be imported before any decorator usage.
+;
+Symbol.metadata ??= Symbol.for('Symbol.metadata');
+export {};
+//# sourceMappingURL=polyfill.js.map

package/dist/polyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfill.js","sourceRoot":"","sources":["../src/polyfill.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,+CAA+C;AAC/C,CAAC;AAAC,MAAc,CAAC,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA"}

package/dist/resolver.d.ts

@@ -0,0 +1,36 @@
+import type { Container } from './di-container.js';
+import type { Constructor } from './types.js';
+/**
+ * Public DI lookup API. Wraps `Container` with a narrowed surface: only the
+ * read operations user code legitimately needs (`has`, `resolve`,
+ * `resolveOptional`). Mutations (`register`, `destroyAll`) stay internal -
+ * `Container` itself is not registered as a public DI token.
+ *
+ * **Prefer `inject(Token)` over `resolver.resolve(Token)` when possible.**
+ * Field-init `inject()` is the idiomatic MiiaJS pattern - it composes with
+ * lifecycle hooks and keeps deps explicit at the class level. Reach for
+ * `Resolver` only for runtime inspection: plugin systems, conditional
+ * resolution, or when the token is not known until runtime.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * class PluginRegistry {
+ *   private resolver = inject(Resolver)
+ *
+ *   load(name: string) {
+ *     const token = `plugin:${name}`
+ *     if (!this.resolver.has(token)) throw new Error(`unknown plugin: ${name}`)
+ *     return this.resolver.resolve(token)
+ *   }
+ * }
+ * ```
+ */
+export declare class Resolver {
+    private container;
+    constructor(container: Container);
+    has(token: Constructor | string): boolean;
+    resolve<T>(token: Constructor<T> | string): T;
+    resolveOptional<T>(token: Constructor<T> | string): T | null;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAExC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO;IAIzC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC;IAI7C,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,IAAI;CAG7D"}

package/dist/resolver.js

@@ -0,0 +1,42 @@
+/**
+ * Public DI lookup API. Wraps `Container` with a narrowed surface: only the
+ * read operations user code legitimately needs (`has`, `resolve`,
+ * `resolveOptional`). Mutations (`register`, `destroyAll`) stay internal -
+ * `Container` itself is not registered as a public DI token.
+ *
+ * **Prefer `inject(Token)` over `resolver.resolve(Token)` when possible.**
+ * Field-init `inject()` is the idiomatic MiiaJS pattern - it composes with
+ * lifecycle hooks and keeps deps explicit at the class level. Reach for
+ * `Resolver` only for runtime inspection: plugin systems, conditional
+ * resolution, or when the token is not known until runtime.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * class PluginRegistry {
+ *   private resolver = inject(Resolver)
+ *
+ *   load(name: string) {
+ *     const token = `plugin:${name}`
+ *     if (!this.resolver.has(token)) throw new Error(`unknown plugin: ${name}`)
+ *     return this.resolver.resolve(token)
+ *   }
+ * }
+ * ```
+ */
+export class Resolver {
+    container;
+    constructor(container) {
+        this.container = container;
+    }
+    has(token) {
+        return this.container.has(token);
+    }
+    resolve(token) {
+        return this.container.resolve(token);
+    }
+    resolveOptional(token) {
+        return this.container.resolveOptional(token);
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,QAAQ;IACC;IAApB,YAAoB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAE5C,GAAG,CAAC,KAA2B;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,OAAO,CAAI,KAA8B;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAI,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,eAAe,CAAI,KAA8B;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAI,KAAK,CAAC,CAAA;IACjD,CAAC;CACF"}

package/dist/response.d.ts

@@ -0,0 +1,19 @@
+export declare class ResponseBuilder {
+    private _status;
+    private _headers;
+    private _body;
+    /** @internal */
+    _modified: boolean;
+    private ensureHeaders;
+    status(code: number): this;
+    header(name: string, value: string): this;
+    json(data: unknown): this;
+    text(data: string): this;
+    html(data: string): this;
+    redirect(url: string, status?: number): this;
+    stream(readable: ReadableStream): this;
+    build(): Response;
+    getStatus(): number;
+    getHeaders(): Headers;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAAwB;IACrC,gBAAgB;IAChB,SAAS,UAAQ;IAEjB,OAAO,CAAC,aAAa;IAIrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMzC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAOzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,IAAI;IAOzC,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAMtC,KAAK,IAAI,QAAQ;IAOjB,SAAS,IAAI,MAAM;IAInB,UAAU,IAAI,OAAO;CAGtB"}

package/dist/response.js

@@ -0,0 +1,62 @@
+export class ResponseBuilder {
+    _status = 200;
+    _headers = null;
+    _body = null;
+    /** @internal */
+    _modified = false;
+    ensureHeaders() {
+        return (this._headers ??= new Headers());
+    }
+    status(code) {
+        this._modified = true;
+        this._status = code;
+        return this;
+    }
+    header(name, value) {
+        this._modified = true;
+        this.ensureHeaders().set(name, value);
+        return this;
+    }
+    json(data) {
+        this._modified = true;
+        this.ensureHeaders().set('Content-Type', 'application/json');
+        this._body = JSON.stringify(data);
+        return this;
+    }
+    text(data) {
+        this._modified = true;
+        this.ensureHeaders().set('Content-Type', 'text/plain');
+        this._body = data;
+        return this;
+    }
+    html(data) {
+        this._modified = true;
+        this.ensureHeaders().set('Content-Type', 'text/html');
+        this._body = data;
+        return this;
+    }
+    redirect(url, status = 302) {
+        this._modified = true;
+        this._status = status;
+        this.ensureHeaders().set('Location', url);
+        return this;
+    }
+    stream(readable) {
+        this._modified = true;
+        this._body = readable;
+        return this;
+    }
+    build() {
+        return new Response(this._body, {
+            status: this._status,
+            headers: this._headers ?? undefined,
+        });
+    }
+    getStatus() {
+        return this._status;
+    }
+    getHeaders() {
+        return this.ensureHeaders();
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IAClB,OAAO,GAAG,GAAG,CAAA;IACb,QAAQ,GAAmB,IAAI,CAAA;IAC/B,KAAK,GAAoB,IAAI,CAAA;IACrC,gBAAgB;IAChB,SAAS,GAAG,KAAK,CAAA;IAET,aAAa;QACnB,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,OAAO,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACrC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,IAAa;QAChB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;QAC5D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAA;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,GAAW,EAAE,MAAM,GAAG,GAAG;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,QAAwB;QAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK;QACH,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE;YAC9B,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;SACpC,CAAC,CAAA;IACJ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,EAAE,CAAA;IAC7B,CAAC;CACF"}

package/dist/router.d.ts

@@ -0,0 +1,35 @@
+import type { HttpMethod, Middleware, RequestContext } from './types.js';
+export interface MatchResult {
+    handler: (ctx: RequestContext) => unknown;
+    params: Record<string, string>;
+    compiledPipeline?: Middleware;
+}
+export interface AddRouteOptions {
+    middlewares?: Middleware[];
+    /**
+     * Skip all globally-registered guards (via `app.useGuard()`) for this route.
+     * Global middleware from `app.use()` still applies - this opts out of guards only.
+     * Used by @miiajs/swagger so UI stays reachable when the app has global auth.
+     */
+    skipGlobalGuards?: boolean;
+    /**
+     * Specific global guard classes to skip for this route. Populated from `@SkipGuard`
+     * metadata by RouterExplorer. Routes with `skipGlobalGuards: true` ignore this set
+     * (they skip everything).
+     */
+    skippedGuardClasses?: Set<unknown> | null;
+}
+export interface GlobalGuardBinding {
+    guardClass: unknown;
+    middleware: Middleware;
+}
+export declare class Router {
+    private staticRoutes;
+    private tries;
+    private allEntries;
+    add(method: HttpMethod, pattern: string, handler: (ctx: RequestContext) => unknown, options?: AddRouteOptions): void;
+    match(method: string, pathname: string): MatchResult | null;
+    compileAll(globalGuards: GlobalGuardBinding[]): void;
+    private matchTrie;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAYxE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,gBAAgB,CAAC,EAAE,UAAU,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;CACvB;AAiBD,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,UAAU,CAAmB;IAErC,GAAG,CACD,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,EACzC,OAAO,GAAE,eAAoB,GAC5B,IAAI;IAmDP,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IA8C3D,UAAU,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAqBpD,OAAO,CAAC,SAAS;CAgDlB"}