@h3ravel/shared 0.27.7 → 0.28.1

package/dist/index.d.ts

@@ -1,1106 +1,55 @@
 /// <reference path="./app.globals.d.ts" />
-import { H3, H3Event, HTTPResponse, Middleware, MiddlewareOptions, serve } from "h3";
-import { Edge } from "edge.js";
-import { DotNestedKeys as DotNestedKeys$1, DotNestedValue as DotNestedValue$1 } from "@h3ravel/shared";
 import { Separator } from "@inquirer/prompts";
 import { ChoiceOrSeparatorArray, ChoiceOrSeparatorArray as ChoiceOrSeparatorArray$1 } from "inquirer-autocomplete-standalone";
 import { ChalkInstance } from "chalk";
+import { ClassConstructor, IPathName } from "@h3ravel/contracts";
 
-//#region src/Contracts/ObjContract.d.ts
-/**
- * Adds a dot prefix to nested keys
- */
-type DotPrefix<T extends string, U extends string> = T extends '' ? U : `${T}.${U}`;
-/**
- * Converts a union of objects into a single merged object
- */
-type MergeUnion<T> = (T extends any ? (k: T) => void : never) extends ((k: infer I) => void) ? { [K in keyof I]: I[K] } : never;
-/**
- * Flattens nested objects into dotted keys
- */
-type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{ [K in keyof T & string]: T[K] extends Record<string, any> ? DotFlatten<T[K], DotPrefix<Prefix, K>> : { [P in DotPrefix<Prefix, K>]: T[K] } }[keyof T & string]>;
-/**
- * Builds "nested.key" paths for autocompletion
- */
-type DotNestedKeys<T> = { [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}` }[keyof T & string];
-/**
- * Retrieves type at a given dot-path
- */
-type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
-/**
- * A generic object type that supports nullable string values
- */
-interface GenericWithNullableStringValues {
-  [name: string]: string | undefined;
-}
-//#endregion
-//#region src/Contracts/IContainer.d.ts
-/**
- * Interface for the Container contract, defining methods for dependency injection and service resolution.
- */
-interface IContainer {
-  /**
-   * Binds a transient service to the container.
-   * @param key - The key or constructor for the service.
-   * @param factory - The factory function to create the service instance.
-   */
-  bind<T>(key: new (...args: any[]) => T, factory: () => T): void;
-  bind<T extends UseKey>(key: T, factory: () => Bindings[T]): void;
-  /**
-   * Binds a singleton service to the container.
-   * @param key - The key or constructor for the service.
-   * @param factory - The factory function to create the singleton instance.
-   */
-  singleton<T extends UseKey>(key: T | (new (...args: any[]) => Bindings[T]), factory: () => Bindings[T]): void;
-  /**
-   * Resolves a service from the container.
-   * @param key - The key or constructor for the service.
-   * @returns The resolved service instance.
-   */
-  make<T extends UseKey, X = undefined>(key: T | (new (..._args: any[]) => Bindings[T])): X extends undefined ? Bindings[T] : X;
-  /**
-   * Checks if a service is registered in the container.
-   * @param key - The key to check.
-   * @returns True if the service is registered, false otherwise.
-   */
-  has(key: UseKey): boolean;
-}
-//#endregion
-//#region src/Contracts/IServiceProvider.d.ts
-interface IServiceProvider {
-  /**
-   * Unique Identifier for service providers
-   */
-  uid?: number;
-  /**
-   * Sort order
-   */
-  order?: `before:${string}` | `after:${string}` | string | undefined;
-  /**
-   * Sort priority
-   */
-  priority?: number;
-  /**
-   * Indicate that this service provider only runs in console
-   */
-  runsInConsole?: boolean;
-  /**
-   * List of registered console commands
-   */
-  registeredCommands?: (new (app: IApplication, kernel: any) => any)[];
-  /**
-   * An array of console commands to register.
-   */
-  commands?(commands: (new (app: IApplication, kernel: any) => any)[]): void;
-  /**
-   * Register bindings to the container.
-   * Runs before boot().
-   */
-  register?(...app: unknown[]): void | Promise<void>;
-  /**
-   * Perform post-registration booting of services.
-   * Runs after all providers have been registered.
-   */
-  boot?(...app: unknown[]): void | Promise<void>;
-}
-//#endregion
-//#region src/Contracts/IApplication.d.ts
-type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config' | 'database';
-interface IApplication extends IContainer {
-  /**
-   * Registers configured service providers.
-   */
-  registerConfiguredProviders(): Promise<void>;
-  /**
-   * Registers an array of external service provider classes.
-   * @param providers - Array of service provider constructor functions.
-   */
-  registerProviders(providers: Array<(new <A = IApplication, S = IServiceProvider>(app: A) => S)>): void;
-  /**
-   * Registers a single service provider.
-   * @param provider - The service provider instance to register.
-   */
-  /**
-   * Boots all registered providers.
-   */
-  boot(): Promise<this>;
-  /**
-   * Gets the base path of the application.
-   * @returns The base path as a string.
-   */
-  getBasePath(): string;
-  /**
-   * Retrieves a path by name, optionally appending a sub-path.
-   * @param name - The name of the path property.
-   * @param pth - Optional sub-path to append.
-   * @returns The resolved path as a string.
-   */
-  getPath(name: string, pth?: string): string;
-  /**
-   * Sets a path for a given name.
-   * @param name - The name of the path property.
-   * @param path - The path to set.
-   * @returns
-   */
-  setPath(name: IPathName, path: string): void;
-  /**
-   * Gets the version of the application or TypeScript.
-   * @param key - The key to retrieve ('app' or 'ts').
-   * @returns The version string or undefined.
-   */
-  getVersion(key: string): string | undefined;
-}
-//#endregion
-//#region src/Contracts/IHttpResponse.d.ts
-/**
- * Interface for the Response contract, defining methods for handling HTTP responses.
- */
-interface IHttpResponse {
-  /**
-   * Set HTTP status code.
-   */
-  setStatusCode(code: number, text?: string): this;
-  /**
-   * Retrieves the status code for the current web response.
-   */
-  getStatusCode(): number;
-  /**
-   * Sets the response charset.
-   */
-  setCharset(charset: string): this;
-  /**
-   * Retrieves the response charset.
-   */
-  getCharset(): string | undefined;
-  /**
-   * Returns true if the response may safely be kept in a shared (surrogate) cache.
-   *
-   * Responses marked "private" with an explicit Cache-Control directive are
-   * considered uncacheable.
-   *
-   * Responses with neither a freshness lifetime (Expires, max-age) nor cache
-   * validator (Last-Modified, ETag) are considered uncacheable because there is
-   * no way to tell when or how to remove them from the cache.
-   *
-   * Note that RFC 7231 and RFC 7234 possibly allow for a more permissive implementation,
-   * for example "status codes that are defined as cacheable by default [...]
-   * can be reused by a cache with heuristic expiration unless otherwise indicated"
-   * (https://tools.ietf.org/html/rfc7231#section-6.1)
-   *
-   * @final
-   */
-  isCacheable(): boolean;
-  /**
-   * Returns true if the response is "fresh".
-   *
-   * Fresh responses may be served from cache without any interaction with the
-   * origin. A response is considered fresh when it includes a Cache-Control/max-age
-   * indicator or Expires header and the calculated age is less than the freshness lifetime.
-   */
-  isFresh(): boolean;
-  /**
-   * Returns true if the response includes headers that can be used to validate
-   * the response with the origin server using a conditional GET request.
-   */
-  isValidateable(): boolean;
-  /**
-   * Sets the response content.
-   */
-  setContent(content?: any): this;
-  /**
-   * Gets the current response content.
-   */
-  getContent(): any;
-  /**
-   * Set a header.
-   */
-  setHeader(name: string, value: string): this;
-  /**
-   * Sets the HTTP protocol version (1.0 or 1.1).
-   */
-  setProtocolVersion(version: string): this;
-  /**
-   * Gets the HTTP protocol version.
-   */
-  getProtocolVersion(): string;
-  /**
-   * Marks the response as "private".
-   *
-   * It makes the response ineligible for serving other clients.
-   */
-  setPrivate(): this;
-  /**
-   * Marks the response as "public".
-   *
-   * It makes the response eligible for serving other clients.
-   */
-  setPublic(): this;
-  /**
-   * Returns the Date header as a DateTime instance.
-   * @throws {RuntimeException} When the header is not parseable
-   */
-  getDate(): any;
-  /**
-   * Returns the age of the response in seconds.
-   *
-   * @final
-   */
-  getAge(): number;
-  /**
-   * Marks the response stale by setting the Age header to be equal to the maximum age of the response.
-   */
-  expire(): this;
-  /**
-   * Returns the value of the Expires header as a DateTime instance.
-   *
-   * @final
-   */
-  getExpires(): any;
-  /**
-   * Returns the number of seconds after the time specified in the response's Date
-   * header when the response should no longer be considered fresh.
-   *
-   * First, it checks for a s-maxage directive, then a max-age directive, and then it falls
-   * back on an expires header. It returns null when no maximum age can be established.
-   */
-  getMaxAge(): number | undefined;
-  /**
-   * Sets the number of seconds after which the response should no longer be considered fresh.
-   *
-   * This method sets the Cache-Control max-age directive.
-   */
-  setMaxAge(value: number): this;
-  /**
-   * Sets the number of seconds after which the response should no longer be returned by shared caches when backend is down.
-   *
-   * This method sets the Cache-Control stale-if-error directive.
-   */
-  setStaleIfError(value: number): this;
-  /**
-   * Sets the number of seconds after which the response should no longer return stale content by shared caches.
-   *
-   * This method sets the Cache-Control stale-while-revalidate directive.
-   */
-  setStaleWhileRevalidate(value: number): this;
-  /**
-   * Returns the response's time-to-live in seconds.
-   *
-   * It returns null when no freshness information is present in the response.
-   *
-   * When the response's TTL is 0, the response may not be served from cache without first
-   * revalidating with the origin.
-   *
-   * @final
-   */
-  getTtl(): number | undefined;
-  /**
-   * Sets the response's time-to-live for shared caches in seconds.
-   *
-   * This method adjusts the Cache-Control/s-maxage directive.
-   */
-  setTtl(seconds: number): this;
-  /**
-   * Sets the response's time-to-live for private/client caches in seconds.
-   *
-   * This method adjusts the Cache-Control/max-age directive.
-   */
-  setClientTtl(seconds: number): this;
-  /**
-   * Sets the number of seconds after which the response should no longer be considered fresh by shared caches.
-   *
-   * This method sets the Cache-Control s-maxage directive.
-   */
-  setSharedMaxAge(value: number): this;
-  /**
-   * Returns the Last-Modified HTTP header as a DateTime instance.
-   *
-   * @throws \RuntimeException When the HTTP header is not parseable
-   *
-   * @final
-   */
-  getLastModified(): any;
-  /**
-   * Sets the Last-Modified HTTP header with a DateTime instance.
-   *
-   * Passing null as value will remove the header.
-   *
-   * @return $this
-   *
-   * @final
-   */
-  setLastModified(date?: any): this;
-  /**
-   * Returns the literal value of the ETag HTTP header.
-   */
-  getEtag(): string | null;
-  /**
-   * Sets the ETag value.
-   *
-   * @param etag The ETag unique identifier or null to remove the header
-   * @param weak Whether you want a weak ETag or not
-   */
-  setEtag(etag?: string, weak?: boolean): this;
-  /**
-   * Sets the response's cache headers (validation and/or expiration).
-   *
-   * Available options are: must_revalidate, no_cache, no_store, no_transform, public, private, proxy_revalidate, max_age, s_maxage, immutable, last_modified and etag.
-   *
-   * @throws {InvalidArgumentException}
-   */
-  setCache(options: any): this;
-  /**
-   * Modifies the response so that it conforms to the rules defined for a 304 status code.
-   *
-   * This sets the status, removes the body, and discards any headers
-   * that MUST NOT be included in 304 responses.
-   * @see https://tools.ietf.org/html/rfc2616#section-10.3.5
-   */
-  setNotModified(): this;
-  /**
-   * Add an array of headers to the response.
-   *
-   */
-  withHeaders(headers: any): this;
-  /**
-   * Set the exception to attach to the response.
-   */
-  withException(e: Error): this;
-  /**
-   * Throws the response in a HttpResponseException instance.
-   *
-   * @throws {HttpResponseException}
-   */
-  throwResponse(): void;
-  /**
-   * Is response invalid?
-   *
-   * @see https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
-   */
-  isInvalid(): boolean;
-  /**
-   * Is response informative?
-   */
-  isInformational(): boolean;
-  /**
-   * Is response successful?
-   */
-  isSuccessful(): boolean;
-  /**
-   * Is the response a redirect?
-   */
-  isRedirection(): boolean;
-  /**
-   * Is there a client error?
-   */
-  isClientError(): boolean;
-  /**
-   * Was there a server side error?
-   */
-  isServerError(): boolean;
-  /**
-   * Is the response OK?
-   */
-  isOk(): boolean;
-  /**
-   * Is the response forbidden?
-   */
-  isForbidden(): boolean;
-  /**
-   * Is the response a not found error?
-   */
-  isNotFound(): boolean;
-  /**
-   * Is the response a redirect of some form?
-   */
-  isRedirect(location?: string | null): boolean;
-  /**
-   * Is the response empty?
-   */
-  isEmpty(): boolean;
-  /**
-   * Apply headers before sending response.
-   */
-  sendHeaders(statusCode?: number): this;
-  /**
-   * Prepares the Response before it is sent to the client.
-   *
-   * This method tweaks the Response to ensure that it is
-   * compliant with RFC 2616. Most of the changes are based on
-   * the Request that is "associated" with this Response.
-   **/
-  prepare(request: IRequest): this;
-}
-//#endregion
-//#region src/Contracts/IResponse.d.ts
-/**
- * Interface for the Response contract, defining methods for handling HTTP responses.
- */
-interface IResponse extends IHttpResponse {
-  /**
-   * The current app instance
-   */
-  app: IApplication;
-  /**
-   * Sends content for the current web response.
-   */
-  sendContent(type?: 'html' | 'json' | 'text' | 'xml', parse?: boolean): unknown;
-  /**
-   * Sends content for the current web response.
-   */
-  send(type?: 'html' | 'json' | 'text' | 'xml'): unknown;
-  /**
-   *
-   * @param content The content to serve
-   * @param send if set to true, the content will be returned, instead of the Response instance
-   * @returns
-   */
-  html(content?: string): this;
-  html(content: string, parse: boolean): HTTPResponse;
-  /**
-   * Send a JSON response.
-   */
-  json<T = unknown>(data?: T): this;
-  json<T = unknown>(data: T, parse: boolean): T;
-  /**
-   * Send plain text.
-   */
-  text(content?: string): this;
-  text(content: string, parse: boolean): HTTPResponse;
-  /**
-   * Send plain xml.
-   */
-  xml(data?: string): this;
-  xml(data: string, parse: boolean): HTTPResponse;
-  /**
-   * Redirect to another URL.
-   */
-  redirect(location: string, status?: number, statusText?: string | undefined): HTTPResponse;
-  /**
-   * Dump the response.
-   */
-  dump(): this;
-  /**
-   * Get the base event
-   */
-  getEvent(): H3Event;
-  getEvent<K$1 extends DotNestedKeys$1<H3Event>>(key: K$1): DotNestedValue$1<H3Event, K$1>;
-}
-//#endregion
-//#region src/Contracts/IHttp.d.ts
-type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'patch' | 'apiResource' | 'group' | 'route';
-type RequestMethod = 'HEAD' | 'GET' | 'PUT' | 'DELETE' | 'TRACE' | 'OPTIONS' | 'PURGE' | 'POST' | 'CONNECT' | 'PATCH';
-type RequestObject = Record<string, any>;
-type ResponseObject = Record<string, any>;
-type ExtractControllerMethods<T> = { [K in keyof T]: T[K] extends ((...args: any[]) => any) ? K : never }[keyof T];
-/**
- * Interface for the Router contract, defining methods for HTTP routing.
- */
-declare class IRouter {
-  /**
-   * Registers a GET route.
-   * @param path - The route path.
-   * @param definition - The handler function or [controller class, method] array.
-   * @param name - Optional route name.
-   * @param middleware - Optional middleware array.
-   */
-  get<C extends new (...args: any) => any>(path: string, definition: EventHandler | [C, methodName: ExtractControllerMethods<InstanceType<C>>], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
-  /**
-   * Registers a POST route.
-   * @param path - The route path.
-   * @param definition - The handler function or [controller class, method] array.
-   * @param name - Optional route name.
-   * @param middleware - Optional middleware array.
-   */
-  post<C extends new (...args: any) => any>(path: string, definition: EventHandler | [C, methodName: ExtractControllerMethods<InstanceType<C>>], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
-  /**
-   * Registers a PUT route.
-   * @param path - The route path.
-   * @param definition - The handler function or [controller class, method] array.
-   * @param name - Optional route name.
-   * @param middleware - Optional middleware array.
-   */
-  put<C extends new (...args: any) => any>(path: string, definition: EventHandler | [C, methodName: ExtractControllerMethods<InstanceType<C>>], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
-  /**
-   * Registers a route that responds to HTTP PATCH requests.
-   *
-   * @param path        The URL pattern to match (can include parameters, e.g., '/users/:id').
-   * @param definition  Either:
-   *                      - An EventHandler function
-   *                      - A tuple: [ControllerClass, methodName]
-   * @param name        Optional route name (for URL generation or referencing).
-   * @param middleware  Optional array of middleware functions to execute before the handler.
-   */
-  patch<C extends new (...args: any) => any>(path: string, definition: EventHandler | [C, methodName: ExtractControllerMethods<InstanceType<C>>], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
-  /**
-   * Registers a DELETE route.
-   * @param path - The route path.
-   * @param definition - The handler function or [controller class, method] array.
-   * @param name - Optional route name.
-   * @param middleware - Optional middleware array.
-   */
-  delete<C extends new (...args: any) => any>(path: string, definition: EventHandler | [C, methodName: ExtractControllerMethods<InstanceType<C>>], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
-  /**
-   * Registers an API resource with standard CRUD routes.
-   * @param path - The base path for the resource.
-   * @param controller - The controller class handling the resource.
-   * @param middleware - Optional middleware array.
-   */
-  apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): Omit<this, RouterEnd | 'name'>;
-  /**
-   * Generates a URL for a named route.
-   * @param name - The name of the route.
-   * @param params - Optional parameters to replace in the route path.
-   * @returns The generated URL or undefined if the route is not found.
-   */
-  route(name: string, params?: Record<string, string>): string | undefined;
-  /**
-   * Set the name of the current route
-   *
-   * @param name
-   */
-  name(name: string): this;
-  /**
-   * Groups routes with shared prefix or middleware.
-   * @param options - Configuration for prefix or middleware.
-   * @param callback - Callback function defining grouped routes.
-   */
-  group(options: {
-    prefix?: string;
-    middleware?: EventHandler[];
-  }, callback: () => this): this;
-  /**
-   * Registers middleware for a specific path.
-   * @param path - The path to apply the middleware.
-   * @param handler - The middleware handler.
-   * @param opts - Optional middleware options.
-   */
-  middleware(path: Middleware, opts?: Middleware | MiddlewareOptions): this;
-  middleware(path: string | IMiddleware[] | Middleware, handler: Middleware | MiddlewareOptions, opts?: MiddlewareOptions): this;
-}
+//#region src/Container.d.ts
+declare const INTERNAL_METHODS: unique symbol;
 /**
- * Represents the HTTP context for a single request lifecycle.
- * Encapsulates the application instance, request, and response objects.
- */
-declare class HttpContext {
-  app: IApplication;
-  request: IRequest;
-  response: IResponse;
-  private static contexts;
-  constructor(app: IApplication, request: IRequest, response: IResponse);
-  /**
-   * Factory method to create a new HttpContext instance from a context object.
-   * @param ctx - Object containing app, request, and response
-   * @returns A new HttpContext instance
-   */
-  static init(ctx: {
-    app: IApplication;
-    request: IRequest;
-    response: IResponse;
-  }, event?: unknown): HttpContext;
-  /**
-   * Retrieve an existing HttpContext instance for an event, if any.
-   */
-  static get(event: unknown): HttpContext | undefined;
-  /**
-   * Delete the cached context for a given event (optional cleanup).
-   */
-  static forget(event: unknown): void;
-}
-/**
- * Type for EventHandler, representing a function that handles an H3 event.
- */
-type EventHandler = (ctx: HttpContext) => any;
-type RouteEventHandler = (...args: any[]) => any;
-/**
- * Defines the contract for all controllers.
- * Any controller implementing this must define these methods.
+ * Decorator to mark class properties as internal
+ *
+ * @param target
+ * @param propertyKey
  */
-declare class IController {
-  show?(...ctx: any[]): any;
-  index?(...ctx: any[]): any;
-  store?(...ctx: any[]): any;
-  update?(...ctx: any[]): any;
-  destroy?(...ctx: any[]): any;
-}
+declare const internal: (target: any, propertyKey: string) => void;
 /**
- * Defines the contract for all middlewares.
- * Any middleware implementing this must define these methods.
- */
-declare class IMiddleware {
-  handle(context: HttpContext, next: () => Promise<any>): Promise<any>;
-}
-//#endregion
-//#region src/Contracts/IParamBag.d.ts
-declare class IParamBag implements Iterable<[string, any]> {
-  /**
-   * The current H3 H3Event instance
-   */
-  readonly event: H3Event;
-  constructor(parameters: RequestObject | undefined,
-  /**
-   * The current H3 H3Event instance
-   */
-  event: H3Event);
-  /**
-   * Returns the parameters.
-   * @
-   * @param key The name of the parameter to return or null to get them all
-   *
-   * @throws BadRequestException if the value is not an array
-   */
-  all(key?: string): any;
-  get(key: string, defaultValue?: any): any;
-  set(key: string, value: any): void;
-  /**
-   * Returns true if the parameter is defined.
-   *
-   * @param key
-   */
-  has(key: string): boolean;
-  /**
-   * Removes a parameter.
-   *
-   * @param key
-   */
-  remove(key: string): void;
-  /**
-   *
-   * Returns the parameter as string.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to string
-   * @returns
-   */
-  getString(key: string, defaultValue?: string): string;
-  /**
-   * Returns the parameter value converted to integer.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to integer
-   */
-  getInt(key: string, defaultValue?: number): number;
-  /**
-   * Returns the parameter value converted to boolean.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to a boolean
-   */
-  getBoolean(key: string, defaultValue?: boolean): boolean;
-  /**
-   * Returns the alphabetic characters of the parameter value.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to string
-   */
-  getAlpha(key: string, defaultValue?: string): string;
-  /**
-   * Returns the alphabetic characters and digits of the parameter value.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to string
-   */
-  getAlnum(key: string, defaultValue?: string): string;
-  /**
-   * Returns the digits of the parameter value.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to string
-   * @returns
-   **/
-  getDigits(key: string, defaultValue?: string): string;
-  /**
-   * Returns the parameter keys.
-   */
-  keys(): string[];
-  /**
-   * Replaces the current parameters by a new set.
-   */
-  replace(parameters?: RequestObject): void;
-  /**
-   * Adds parameters.
-   */
-  add(parameters?: RequestObject): void;
-  /**
-   * Returns the number of parameters.
-   */
-  count(): number;
-  /**
-   * Returns an iterator for parameters.
-   *
-   * @returns
-   */
-  [Symbol.iterator](): ArrayIterator<[string, any]>;
-}
-//#endregion
-//#region src/Contracts/IUploadedFile.d.ts
-declare class IUploadedFile {
-  originalName: string;
-  mimeType: string;
-  size: number;
-  content: File;
-  constructor(originalName: string, mimeType: string, size: number, content: File);
-  static createFromBase(file: File): IUploadedFile;
-  /**
-   * Save to disk (Node environment only)
-   */
-  moveTo(destination: string): Promise<void>;
-}
+ * Checks if a property is decorated with the &#64;internal decorator
+ *
+ * @param instance
+ * @param prop
+ * @returns
+ */
+declare const isInternal: (instance: any, prop: string) => boolean;
 //#endregion
-//#region src/Contracts/IRequest.d.ts
-type RequestObject$1 = Record<string, any>;
+//#region src/Contracts/ObjContract.d.ts
 /**
- * Interface for the Request contract, defining methods for handling HTTP request data.
+ * Adds a dot prefix to nested keys
  */
-declare class IRequest {
-  /**
-   * The current app instance
-   */
-  app: IApplication;
-  /**
-   * Parsed request body
-   */
-  body: unknown;
-  /**
-   * Gets route parameters.
-   * @returns An object containing route parameters.
-   */
-  params: NonNullable<H3Event['context']['params']>;
-  /**
-   * Uploaded files (FILES).
-   */
-  constructor(
-  /**
-   * The current H3 H3Event instance
-   */
-  event: H3Event,
-  /**
-   * The current app instance
-   */
-  app: IApplication);
-  /**
-   * Factory method to create a Request instance from an H3Event.
-   */
-  static create(
-  /**
-   * The current H3 H3Event instance
-   */
-  event: H3Event,
-  /**
-   * The current app instance
-   */
-  app: IApplication): Promise<Request>;
-  /**
-   * Sets the parameters for this request.
-   *
-   * This method also re-initializes all properties.
-   *
-   * @param attributes
-   * @param cookies    The COOKIE parameters
-   * @param files      The FILES parameters
-   * @param server     The SERVER parameters
-   * @param content    The raw body data
-   */
-  initialize(): Promise<void>;
-  /**
-   * Retrieve all data from the instance (query + body).
-   */
-  all<T = Record<string, any>>(keys?: string | string[]): T;
-  /**
-   * Retrieve an input item from the request.
-   *
-   * @param key
-   * @param defaultValue
-   * @returns
-   */
-  input<K$1 extends string | undefined>(key?: K$1, defaultValue?: any): K$1 extends undefined ? RequestObject$1 : any;
-  /**
-   * Retrieve a file from the request.
-   *
-   * By default a single `UploadedFile` instance will always be returned by
-   * the method (first file in property when there are multiple), unless
-   * the `expectArray` parameter is set to true, in which case, the method
-   * returns an `UploadedFile[]` array.
-   *
-   * @param key
-   * @param defaultValue
-   * @param expectArray set to true to return an `UploadedFile[]` array.
-   * @returns
-   */
-  file<K$1 extends string | undefined = undefined, E extends boolean | undefined = undefined>(key?: K$1, defaultValue?: any, expectArray?: E): K$1 extends undefined ? Record<string, E extends true ? IUploadedFile[] : IUploadedFile> : E extends true ? IUploadedFile[] : IUploadedFile;
-  /**
-   * Determine if the uploaded data contains a file.
-   *
-   * @param  key
-   * @return boolean
-   */
-  hasFile(key: string): boolean;
-  /**
-   * Get an object with all the files on the request.
-   */
-  allFiles(): Record<string, IUploadedFile | IUploadedFile[]>;
-  /**
-     * Extract and convert uploaded files from FormData.
-     */
-  convertUploadedFiles(files: Record<string, IUploadedFile | IUploadedFile[]>): Record<string, IUploadedFile | IUploadedFile[]>;
-  /**
-   * Determine if the data contains a given key.
-   *
-   * @param keys
-   * @returns
-   */
-  has(keys: string[] | string): boolean;
-  /**
-   * Determine if the instance is missing a given key.
-   */
-  missing(key: string | string[]): boolean;
-  /**
-   * Get a subset containing the provided keys with values from the instance data.
-   *
-   * @param keys
-   * @returns
-   */
-  only<T = Record<string, any>>(keys: string[]): T;
-  /**
-   * Get all of the data except for a specified array of items.
-   *
-   * @param keys
-   * @returns
-   */
-  except<T = Record<string, any>>(keys: string[]): T;
-  /**
-   * Merges new input data into the current request's input source.
-   *
-   * @param input - An object containing key-value pairs to merge.
-   * @returns this - For fluent chaining.
-   */
-  merge(input: Record<string, any>): this;
-  /**
-   * Merge new input into the request's input, but only when that key is missing from the request.
-   *
-   * @param input
-   */
-  mergeIfMissing(input: Record<string, any>): this;
-  /**
-   * Get the keys for all of the input and files.
-   */
-  keys(): string[];
-  /**
-   * Determine if the request is sending JSON.
-   *
-   * @return bool
-   */
-  isJson(): boolean;
-  /**
-   * Determine if the current request probably expects a JSON response.
-   *
-   * @returns
-   */
-  expectsJson(): boolean;
-  /**
-   * Determine if the current request is asking for JSON.
-   *
-   * @returns
-   */
-  wantsJson(): boolean;
-  /**
-   * Gets a list of content types acceptable by the client browser in preferable order.
-   * @returns {string[]}
-   */
-  getAcceptableContentTypes(): string[];
-  /**
-   * Determine if the request is the result of a PJAX call.
-   *
-   * @return bool
-   */
-  pjax(): boolean;
-  /**
-   * Returns true if the request is an XMLHttpRequest (AJAX).
-   *
-   * @alias isXmlHttpRequest()
-   * @returns {boolean}
-   */
-  ajax(): boolean;
-  /**
-   * Returns true if the request is an XMLHttpRequest (AJAX).
-   */
-  isXmlHttpRequest(): boolean;
-  /**
-   * Returns the value of the requested header.
-   */
-  getHeader(name: string): string | undefined | null;
-  /**
-   * Checks if the request method is of specified type.
-   *
-   * @param method Uppercase request method (GET, POST etc)
-   */
-  isMethod(method: string): boolean;
-  /**
-   * Checks whether or not the method is safe.
-   *
-   * @see https://tools.ietf.org/html/rfc7231#section-4.2.1
-   */
-  isMethodSafe(): boolean;
-  /**
-   * Checks whether or not the method is idempotent.
-   */
-  isMethodIdempotent(): boolean;
-  /**
-   * Checks whether the method is cacheable or not.
-   *
-   * @see https://tools.ietf.org/html/rfc7231#section-4.2.3
-   */
-  isMethodCacheable(): boolean;
-  /**
-   * Gets the request "intended" method.
-   *
-   * If the X-HTTP-Method-Override header is set, and if the method is a POST,
-   * then it is used to determine the "real" intended HTTP method.
-   *
-   * The _method request parameter can also be used to determine the HTTP method,
-   * but only if enableHttpMethodParameterOverride() has been called.
-   *
-   * The method is always an uppercased string.
-   *
-   * @see getRealMethod()
-   */
-  getMethod(): RequestMethod;
-  /**
-   * Gets the "real" request method.
-   *
-   * @see getMethod()
-   */
-  getRealMethod(): RequestMethod;
-  /**
-   * Get the client IP address.
-   */
-  ip(): string | undefined;
-  /**
-   * Get a URI instance for the request.
-   */
-  uri(): unknown;
-  /**
-   * Get the full URL for the request.
-   */
-  fullUrl(): string;
-  /**
-   * Return the Request instance.
-   */
-  instance(): this;
-  /**
-   * Get the request method.
-   */
-  method(): RequestMethod;
-  /**
-   * Get the JSON payload for the request.
-   *
-   * @param  key
-   * @param  defaultValue
-   * @return {InputBag}
-   */
-  json<K$1 extends string | undefined = undefined>(key?: string, defaultValue?: any): K$1 extends undefined ? IParamBag : any;
-  /**
-   * Returns the request body content.
-   *
-   * @param asStream If true, returns a ReadableStream instead of the parsed string
-   * @return {string | ReadableStream | Promise<string | ReadableStream>}
-   */
-  getContent(asStream?: boolean): string | ReadableStream;
-  /**
-   * Gets a "parameter" value from any bag.
-   *
-   * This method is mainly useful for libraries that want to provide some flexibility. If you don't need the
-   * flexibility in controllers, it is better to explicitly get request parameters from the appropriate
-   * public property instead (attributes, query, request).
-   *
-   * Order of precedence: PATH (routing placeholders or custom attributes), GET, POST
-   *
-   * @internal use explicit input sources instead
-   */
-  get(key: string, defaultValue?: any): any;
-  /**
-   * Enables support for the _method request parameter to determine the intended HTTP method.
-   *
-   * Be warned that enabling this feature might lead to CSRF issues in your code.
-   * Check that you are using CSRF tokens when required.
-   * If the HTTP method parameter override is enabled, an html-form with method "POST" can be altered
-   * and used to send a "PUT" or "DELETE" request via the _method request parameter.
-   * If these methods are not protected against CSRF, this presents a possible vulnerability.
-   *
-   * The HTTP method can only be overridden when the real HTTP method is POST.
-   */
-  static enableHttpMethodParameterOverride(): void;
-  /**
-   * Checks whether support for the _method request parameter is enabled.
-   */
-  static getHttpMethodParameterOverride(): boolean;
-  /**
-   * Dump the items.
-   *
-   * @param  keys
-   * @return this
-   */
-  dump(...keys: any[]): this;
-  /**
-   * Get the base event
-   */
-  getEvent(): H3Event;
-  getEvent<K$1 extends DotNestedKeys<H3Event>>(key: K$1): DotNestedValue<H3Event, K$1>;
-}
-//#endregion
-//#region src/Utils/PathLoader.d.ts
-declare class PathLoader {
-  private paths;
-  /**
-   * Dynamically retrieves a path property from the class.
-   * Any property ending with "Path" is accessible automatically.
-   *
-   * @param name - The base name of the path property
-   * @param prefix - The base path to prefix to the path
-   * @returns
-   */
-  getPath(name: IPathName, prefix?: string): string;
-  /**
-   * Programatically set the paths.
-   *
-   * @param name - The base name of the path property
-   * @param path - The new path
-   * @param base - The base path to include to the path
-   */
-  setPath(name: IPathName, path: string, base?: string): void;
+type DotPrefix<T extends string, U extends string> = T extends '' ? U : `${T}.${U}`;
+/**
+ * Converts a union of objects into a single merged object
+ */
+type MergeUnion<T> = (T extends any ? (k: T) => void : never) extends ((k: infer I) => void) ? { [K in keyof I]: I[K] } : never;
+/**
+ * Flattens nested objects into dotted keys
+ */
+type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{ [K in keyof T & string]: T[K] extends Record<string, any> ? DotFlatten<T[K], DotPrefix<Prefix, K>> : { [P in DotPrefix<Prefix, K>]: T[K] } }[keyof T & string]>;
+/**
+ * Builds "nested.key" paths for autocompletion
+ */
+type DotNestedKeys<T> = { [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}` }[keyof T & string];
+/**
+ * Retrieves type at a given dot-path
+ */
+type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
+/**
+ * A generic object type that supports nullable string values
+ */
+interface GenericWithNullableStringValues {
+  [name: string]: string | undefined;
 }
 //#endregion
-//#region src/Contracts/BindingsContract.d.ts
-type RemoveIndexSignature<T> = { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K] };
-type Bindings = {
-  [key: string]: any;
-  [key: `app.${string}`]: any;
-  env(): NodeJS.ProcessEnv;
-  env<T extends string>(key: T, def?: any): any;
-  view(viewPath: string, params?: Record<string, any>): Promise<HTTPResponse>;
-  edge: Edge;
-  asset(key: string, def?: string): string;
-  router: IRouter;
-  config: {
-    get<X extends Record<string, any>>(): X;
-    get<X extends Record<string, any>, T extends Extract<keyof X, string>>(key: T, def?: any): X[T];
-    set<T extends string>(key: T, value: any): void;
-    load?(): any;
-  };
-  'http.app': H3;
-  'path.base': string;
-  'load.paths': PathLoader;
-  'http.serve': typeof serve;
-  'http.request': IRequest;
-  'http.response': IResponse;
-};
-type UseKey = keyof RemoveIndexSignature<Bindings>;
-//#endregion
 //#region src/Contracts/PromptsContract.d.ts
 type Choice<Value> = {
   value: Value;
@@ -1113,14 +62,13 @@ type Choice<Value> = {
 type ISeparator = Separator;
 type Choices = readonly (string | Separator)[] | readonly (Separator | Choice<string>)[];
 //#endregion
-//#region src/Contracts/Router.d.ts
-type RouteMethod = 'get' | 'head' | 'put' | 'patch' | 'post' | 'delete';
-interface RouteDefinition {
-  method: RouteMethod;
-  path: string;
-  name?: string | undefined;
-  handler: EventHandler;
-  signature: [string, string | undefined];
+//#region src/Utils/Console.d.ts
+declare class Console {
+  static log: (...args: any[]) => string | void;
+  static debug: (...args: any[]) => void;
+  static warn: (...args: any[]) => void[];
+  static info: (...args: any[]) => void[];
+  static error: (...args: any[]) => void[];
 }
 //#endregion
 //#region src/Utils/Logger.d.ts
@@ -1182,7 +130,7 @@ declare class Logger {
    * @param preserveCol
    * @returns
    */
-  static textFormat(txt: unknown, color: (txt: string) => string, preserveCol?: boolean): string;
+  static textFormat(txt: unknown | unknown[], color: (...text: unknown[]) => string, preserveCol?: boolean): string;
   /**
    * Logs a success message
    *
@@ -1206,9 +154,7 @@ declare class Logger {
    * @param exit
    * @param preserveCol
    */
-  static error(msg: string | string[] | Error & {
-    detail?: string;
-  }, exit?: boolean, preserveCol?: boolean): void;
+  static error(msg: any, exit?: boolean, preserveCol?: boolean): void;
   /**
    * Logs a warning message
    *
@@ -1246,6 +192,12 @@ declare class Logger {
    * @returns
    */
   static log: LoggerLog;
+  /**
+   * A simple console like output logger
+   *
+   * @returns
+   */
+  static console(): typeof Console;
 }
 //#endregion
 //#region src/Contracts/Utils.d.ts
@@ -1268,6 +220,142 @@ interface LoggerLog {
   <L extends boolean>(config?: LoggerParseSignature, joiner?: string, log?: L, sc?: LoggerChalk): L extends true ? void : string | Logger;
 }
 //#endregion
+//#region src/Mixins/MixinSystem.d.ts
+/**
+ * Helper to convert a Union (A | B) into an Intersection (A & B)
+ */
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+/**
+ * Infers the mixed type of all base classes provided
+ */
+type MixedClass<T extends ClassConstructor[]> = UnionToIntersection<T[number]> & (new (...args: any[]) => UnionToIntersection<InstanceType<T[number]>>);
+/**
+ * Helper to mix multiple classes into one, this allows extending multiple classes by any single class
+ *
+ * @param bases
+ * @returns
+ */
+declare const mix: <T extends ClassConstructor[]>(...bases: T) => MixedClass<T>;
+//#endregion
+//#region src/Mixins/TraitSystem.d.ts
+declare const crc32: (str: string) => number;
+type ResolveTraitLike<T extends Trait | TypeFactory<Trait>> = T extends TypeFactory<Trait> ? ExtractFactory<ReturnType<T>> : T extends Trait ? ExtractFactory<T> : unknown;
+type Combine<T extends any[]> = T extends [infer Head, ...infer Tail] ? Head & Combine<Tail> : object;
+type MapClassesToPrototypes<T extends Array<(new () => any) & {
+  prototype: any;
+}>> = { [K in keyof T]: T[K]['prototype'] };
+type MapClassesToInstances<T extends Array<(new () => any) & {
+  prototype: any;
+}>> = { [K in keyof T]: InstanceType<T[K]> };
+type CombineClasses<T extends Array<(new () => any) & {
+  prototype: any;
+}>> = (new () => Combine<MapClassesToInstances<T>>) & {
+  prototype: Combine<MapClassesToPrototypes<T>>;
+};
+type ResolveTraitLikeArray<T extends Array<Trait | TypeFactory<Trait>>> = CombineClasses<{ [K in keyof T]: ResolveTraitLike<T[K]> }>;
+type Cons<T = any> = new (...args: any[]) => T;
+type ConsFactory<T extends Cons = Cons, B = any> = (base: B) => T;
+type TypeFactory<T = any> = () => T;
+type Explode<T = any> = { [P in keyof T]: T[P] };
+type MixParams<T1 extends any[], T2 extends any[]> = T1 extends [] ? (T2 extends [] ? [] : T2) : (T2 extends [] ? T1 : (T1 extends [infer H1, ...infer R1] ? (T2 extends [infer H2, ...infer R2] ? [H1 & H2, ...MixParams<R1, R2>] : []) : []));
+type TraitDefTypeT = ConsFactory<Cons>;
+type TraitDefTypeST = (Trait | TypeFactory<Trait>)[] | undefined;
+type Trait<T extends TraitDefTypeT = TraitDefTypeT, ST$1 extends TraitDefTypeST = TraitDefTypeST> = {
+  id: number;
+  symbol: symbol;
+  factory: T;
+  superTraits: ST$1;
+};
+declare function trait<T extends ConsFactory<Cons>>(factory: T): Trait<T, undefined>;
+declare function trait<const ST$1 extends (Trait | TypeFactory<Trait>)[], T extends ConsFactory<Cons, ResolveTraitLikeArray<ST$1>>>(superTraits: ST$1, factory: T): Trait<T, ST$1>;
+type ExtractFactory<T extends Trait> = T extends Trait<ConsFactory<infer C>, TraitDefTypeST> ? C : never;
+type ExtractSuperTrait<T extends Trait> = T extends Trait<TraitDefTypeT, infer ST extends TraitDefTypeST> ? ST : never;
+type DeriveTraitsConsConsMerge<A extends Cons, B extends Cons> = A extends (new (...args: infer ArgsA) => infer RetA) ? (B extends (new (...args: infer ArgsB) => infer RetB) ? (new (...args: MixParams<ArgsA, ArgsB>) => RetA & RetB) : never) : never;
+type DeriveTraitsConsCons<T extends Cons> = new (...args: ConstructorParameters<T>) => InstanceType<T>;
+type DeriveTraitsConsTraitParts<C$1 extends Cons, ST$1 extends ((Trait | TypeFactory<Trait>)[] | undefined)> = ST$1 extends undefined ? DeriveTraitsConsCons<C$1> : ST$1 extends [] ? DeriveTraitsConsCons<C$1> : DeriveTraitsConsConsMerge<DeriveTraitsConsCons<C$1>, DeriveTraitsConsAll<ST$1>>;
+type DeriveTraitsConsTrait<T extends Trait> = DeriveTraitsConsTraitParts<ExtractFactory<T>, ExtractSuperTrait<T>>;
+type DeriveTraitsConsOne<T extends (Trait | TypeFactory<Trait>)> = T extends Trait ? DeriveTraitsConsTrait<T> : T extends TypeFactory<Trait> ? DeriveTraitsConsTrait<ReturnType<T>> : never;
+type DeriveTraitsConsAll<T extends (((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], Cons]) | undefined)> = T extends [...infer Others extends (Trait | TypeFactory<Trait>)[], infer Last extends Cons] ? (DeriveTraitsConsConsMerge<DeriveTraitsConsAll<Others>, /* RECURSION */DeriveTraitsConsCons<Last>>) : T extends (Trait | TypeFactory<Trait>)[] ? (T extends [infer First extends (Trait | TypeFactory<Trait>)] ? (DeriveTraitsConsOne<First>) : (T extends [infer First extends (Trait | TypeFactory<Trait>), ...infer Rest extends (Trait | TypeFactory<Trait>)[]] ? (DeriveTraitsConsConsMerge<DeriveTraitsConsOne<First>, DeriveTraitsConsAll<Rest>>) : never)) : never;
+type DeriveTraitsCons<T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], Cons])> = DeriveTraitsConsAll<T>;
+type DeriveTraitsStatsConsMerge<T1 extends object, T2 extends object> = T1 & T2;
+type DeriveTraitsStatsCons<T extends Cons> = Explode<T>;
+type DeriveTraitsStatsTraitParts<C$1 extends Cons, ST$1 extends ((Trait | TypeFactory<Trait>)[] | undefined)> = ST$1 extends undefined ? DeriveTraitsStatsCons<C$1> : ST$1 extends [] ? DeriveTraitsStatsCons<C$1> : DeriveTraitsStatsConsMerge<DeriveTraitsStatsCons<C$1>, DeriveTraitsStatsAll<ST$1>>;
+type DeriveTraitsStatsTrait<T extends Trait> = DeriveTraitsStatsTraitParts<ExtractFactory<T>, ExtractSuperTrait<T>>;
+type DeriveTraitsStatsOne<T extends (Trait | TypeFactory<Trait>)> = T extends Trait ? DeriveTraitsStatsTrait<T> : T extends TypeFactory<Trait> ? DeriveTraitsStatsTrait<ReturnType<T>> : never;
+type DeriveTraitsStatsAll<T extends (((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], Cons]) | undefined)> = T extends [...infer Others extends (Trait | TypeFactory<Trait>)[], infer Last extends Cons] ? (DeriveTraitsStatsConsMerge<DeriveTraitsStatsAll<Others>, /* RECURSION */DeriveTraitsStatsCons<Last>>) : T extends (Trait | TypeFactory<Trait>)[] ? (T extends [infer First extends (Trait | TypeFactory<Trait>)] ? (DeriveTraitsStatsOne<First>) : (T extends [infer First extends (Trait | TypeFactory<Trait>), ...infer Rest extends (Trait | TypeFactory<Trait>)[]] ? (DeriveTraitsStatsConsMerge<DeriveTraitsStatsOne<First>, DeriveTraitsStatsAll<Rest>>) : never)) : never;
+type DeriveTraitsStats<T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], Cons])> = DeriveTraitsStatsAll<T>;
+type DeriveTraits<T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], Cons])> = DeriveTraitsCons<T> & DeriveTraitsStats<T>;
+declare function use<T extends ([Trait | TypeFactory<Trait>, ...(Trait | TypeFactory<Trait>)[]] | [...(Trait | TypeFactory<Trait>)[], Cons])>(...traits: T): DeriveTraits<T>;
+type DerivedType<T extends Trait> = InstanceType<ExtractFactory<T>>;
+type Derived<T extends (Trait | TypeFactory<Trait> | Cons)> = T extends TypeFactory<Trait> ? DerivedType<ReturnType<T>> : T extends Trait ? DerivedType<T> : T extends Cons ? T : never;
+declare function uses<T extends (Trait | TypeFactory<Trait> | Cons)>(instance: unknown, trait: T): instance is Derived<T>;
+//#endregion
+//#region src/Mixins/UseFinalizable.d.ts
+/**
+ * the API trait "Finalizable<T>"
+ */
+declare const Finalizable: Trait<(base: any) => {
+  new (...args: any[]): {
+    [x: string]: any;
+  };
+  [x: string]: any;
+}, undefined>;
+//#endregion
+//#region src/Mixins/UseMagic.d.ts
+/**
+ * Wraps an object in a Proxy to emulate PHP magic methods.
+ *
+ * Supported:
+ *  - __call(method, args)
+ *  - __get(property)
+ *  - __set(property, value)
+ *  - __isset(property)
+ *  - __unset(property)
+ *
+ * Called automatically by Magic's constructor.
+ *
+ * Return in any class constructor to use
+ *
+ * @param target
+ * @returns
+ */
+declare function makeMagic<T extends object>(target: T): T;
+/**
+ * Wraps a class constructor in a Proxy to emulate static PHP magic methods.
+ *
+ * Supported:
+ *  - __callStatic(method, args)
+ *  - static __get(property)
+ *  - static __set(property, value)
+ *  - static __isset(property)
+ *  - static __unset(property)
+ *
+ * @param cls
+ * @returns
+ */
+declare function makeStaticMagic<T extends ((...args: any[]) => any) | (abstract new (...args: any[]) => any)>(cls: T): T;
+/**
+ * Base class that enables PHP-style magic methods automatically.
+ *
+ * Any subclass may implement:
+ *  - __call
+ *  - __get
+ *  - __set
+ *  - __isset
+ *  - __unset
+ *
+ * The constructor returns a Proxy transparently.
+ */
+declare abstract class Magic {
+  constructor();
+}
+declare const UseMagic: Trait<(Base: any) => {
+  new (...args: any[]): {
+    [x: string]: any;
+  };
+  [x: string]: any;
+}, undefined>;
+//#endregion
 //#region src/Utils/EnvParser.d.ts
 declare class EnvParser {
   static parse(initial: GenericWithNullableStringValues): {
@@ -1296,6 +384,39 @@ declare class FileSystem {
    * @returns
    */
   static resolveFileUp(name: string, extensions: string[] | ((dir: string, filesNames: string[]) => string | false), cwd?: string): string | undefined;
+  /**
+   * Recursively find files starting from given cwd
+   *
+   * @param name
+   * @param extensions
+   * @param cwd
+   *
+   * @returns
+   */
+  static resolveModulePath(moduleId: string, pathName: string | string[], cwd?: string): string | undefined;
+}
+//#endregion
+//#region src/Utils/PathLoader.d.ts
+declare class PathLoader {
+  private paths;
+  /**
+   * Dynamically retrieves a path property from the class.
+   * Any property ending with "Path" is accessible automatically.
+   *
+   * @param name - The base name of the path property
+   * @param prefix - The base path to prefix to the path
+   * @returns
+   */
+  getPath(name: IPathName, prefix?: string): string;
+  /**
+   * Programatically set the paths.
+   *
+   * @param name - The base name of the path property
+   * @param path - The new path
+   * @param base - The base path to include to the path
+   */
+  setPath(name: IPathName, path: string, base?: string): void;
+  distPath(path: string, skipExt?: boolean): string;
 }
 //#endregion
 //#region src/Utils/Prompts.d.ts
@@ -1445,5 +566,5 @@ declare class TaskManager {
   static advancedTaskRunner<R = any>(info: [[string, string], [string, string]] | [[string, string]], task: (() => Promise<R>) | (() => R)): Promise<R | undefined>;
 }
 //#endregion
-export { Bindings, Choice, type ChoiceOrSeparatorArray, Choices, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, EventHandler, ExtractControllerMethods, FileSystem, GenericWithNullableStringValues, HttpContext, IApplication, IContainer, IController, IHttpResponse, IMiddleware, IParamBag, IPathName, IRequest, IResponse, IRouter, ISeparator, IServiceProvider, IUploadedFile, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, PathLoader, Prompts, RequestMethod, RequestObject, Resolver, ResponseObject, RouteDefinition, RouteEventHandler, RouteMethod, RouterEnd, TaskManager, UseKey, baseTsconfig, mainTsconfig, packageJsonScript };
+export { Choice, type ChoiceOrSeparatorArray, Choices, Console, Derived, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, FileSystem, Finalizable, GenericWithNullableStringValues, INTERNAL_METHODS, ISeparator, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, Magic, PathLoader, Prompts, Resolver, TaskManager, Trait, UseMagic, baseTsconfig, crc32, internal, isInternal, mainTsconfig, makeMagic, makeStaticMagic, mix, packageJsonScript, trait, use, uses };
 //# sourceMappingURL=index.d.ts.map