@h3ravel/shared 1.29.0-alpha.15 → 2.0.0-alpha.16

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 /// <reference path="./app.globals.d.ts" />
-import { Options, Ora } from "ora";
-import { Separator } from "@inquirer/prompts";
-import { ChoiceOrSeparatorArray, ChoiceOrSeparatorArray as ChoiceOrSeparatorArray$1 } from "inquirer-autocomplete-standalone";
 import { ChalkInstance } from "chalk";
+import { JitiOptions, JitiResolveOptions } from "jiti";
+import { ChoiceOrSeparatorArray, ChoiceOrSeparatorArray as ChoiceOrSeparatorArray$1 } from "inquirer-autocomplete-standalone";
+import { Separator } from "@inquirer/prompts";
+import { Options, Ora } from "ora";
 import { ClassConstructor, IPathName } from "@h3ravel/contracts";
 
 //#region src/Container.d.ts
@@ -398,6 +399,27 @@ declare class FileSystem {
   static resolveModulePath(moduleId: string, pathName: string | string[], cwd?: string): string | undefined;
 }
 //#endregion
+//#region src/Utils/Imports.d.ts
+interface FileImporter {
+  <T = unknown>(filePath: string): Promise<T>;
+  <T = unknown>(filePath: string, userOptions?: JitiOptions): Promise<T>;
+  <T = unknown>(filePath: string, userOptions?: JitiOptions, resolveOptions?: JitiResolveOptions & {
+    default?: true;
+  }): Promise<T>;
+}
+/**
+ *
+ * Dynamically imports a file at the given path with full TypeScript support,
+ * including `tsconfig.json` path aliases.
+ *
+ * @param filePath - The path to the file to import.
+ * @returns The imported module typed as `T`.
+ *
+ * @example
+ * const config = await importFile<AppConfig>('./config/app.ts')
+ */
+declare const importFile: FileImporter;
+//#endregion
 //#region src/Utils/PathLoader.d.ts
 declare class PathLoader {
   private paths;
@@ -569,4 +591,4 @@ declare class TaskManager {
   static advancedTaskRunner<R = any>(info: [[string, string], [string, string]] | [[string, string]], task: (() => Promise<R>) | (() => R)): Promise<R | undefined>;
 }
 //#endregion
-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, Spinner, TaskManager, Trait, UseMagic, baseTsconfig, crc32, internal, isInternal, mainTsconfig, makeMagic, makeStaticMagic, mix, packageJsonScript, trait, use, uses };
+export { Choice, type ChoiceOrSeparatorArray, Choices, Console, Derived, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, FileImporter, FileSystem, Finalizable, GenericWithNullableStringValues, INTERNAL_METHODS, ISeparator, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, Magic, PathLoader, Prompts, Resolver, Spinner, TaskManager, Trait, UseMagic, baseTsconfig, crc32, importFile, internal, isInternal, mainTsconfig, makeMagic, makeStaticMagic, mix, packageJsonScript, trait, use, uses };

package/dist/index.js

@@ -3,6 +3,10 @@ import { access } from "fs/promises";
 import escalade from "escalade/sync";
 import { existsSync } from "fs";
 import path from "path";
+import { createJiti } from "jiti";
+import { existsSync as existsSync$1 } from "node:fs";
+import { pathToFileURL } from "node:url";
+import path$1, { resolve } from "node:path";
 import autocomplete from "inquirer-autocomplete-standalone";
 import { checkbox, confirm, editor, input, password, select } from "@inquirer/prompts";
 import ora from "ora";
@@ -619,6 +623,98 @@ var FileSystem = class {
 	}
 };
 //#endregion
+//#region src/Utils/Imports.ts
+const findProjectRoot = (filePath) => {
+	let directory = path$1.dirname(filePath);
+	while (directory !== path$1.dirname(directory)) {
+		if (existsSync$1(path$1.join(directory, "package.json"))) return directory;
+		directory = path$1.dirname(directory);
+	}
+	return process.cwd();
+};
+const conventionalAliases = (root) => ({
+	src: path$1.join(root, "src"),
+	App: path$1.join(root, "src/app"),
+	root,
+	routes: path$1.join(root, "src/routes"),
+	config: path$1.join(root, "src/config"),
+	resources: path$1.join(root, "src/resources")
+});
+const frameworkModules = [
+	"@h3ravel/arquebus",
+	"@h3ravel/cache",
+	"@h3ravel/collect.js",
+	"@h3ravel/config",
+	"@h3ravel/console",
+	"@h3ravel/contracts",
+	"@h3ravel/core",
+	"@h3ravel/database",
+	"@h3ravel/events",
+	"@h3ravel/filesystem",
+	"@h3ravel/foundation",
+	"@h3ravel/hashing",
+	"@h3ravel/http",
+	"@h3ravel/mail",
+	"@h3ravel/musket",
+	"@h3ravel/queue",
+	"@h3ravel/router",
+	"@h3ravel/session",
+	"@h3ravel/shared",
+	"@h3ravel/support",
+	"@h3ravel/support/facades",
+	"@h3ravel/support/traits",
+	"@h3ravel/url",
+	"@h3ravel/validation",
+	"@h3ravel/view"
+];
+/**
+*
+* Dynamically imports a file at the given path with full TypeScript support,
+* including `tsconfig.json` path aliases.
+*
+* @param filePath - The path to the file to import.
+* @returns The imported module typed as `T`.
+*
+* @example
+* const config = await importFile<AppConfig>('./config/app.ts')
+*/
+const importFile = async (filePath, userOptions, resolveOptions) => {
+	const resolvedPath = resolve(filePath);
+	const parentUrl = pathToFileURL(resolvedPath).href;
+	const extension = path$1.extname(resolvedPath).toLowerCase();
+	if ([
+		".js",
+		".mjs",
+		".cjs"
+	].includes(extension)) return await import(parentUrl);
+	let jiti;
+	try {
+		jiti = createJiti(parentUrl, {
+			...userOptions,
+			interopDefault: false,
+			tryNative: userOptions?.tryNative ?? true,
+			sourceMaps: userOptions?.sourceMaps ?? true,
+			nativeModules: [...frameworkModules, ...userOptions?.nativeModules ?? []],
+			tsconfigPaths: userOptions?.tsconfigPaths ?? true
+		});
+	} catch {
+		const projectRoot = findProjectRoot(resolvedPath);
+		jiti = createJiti(parentUrl, {
+			...userOptions,
+			alias: {
+				...conventionalAliases(projectRoot),
+				...userOptions?.alias
+			},
+			interopDefault: false,
+			tryNative: userOptions?.tryNative ?? true,
+			sourceMaps: userOptions?.sourceMaps ?? true,
+			nativeModules: [...frameworkModules, ...userOptions?.nativeModules ?? []],
+			tsconfigPaths: false
+		});
+	}
+	return await jiti.import(resolvedPath, resolveOptions);
+};
+//#endregion
 //#region src/Utils/PathLoader.ts
 var PathLoader = class {
 	paths = {
@@ -643,12 +739,12 @@ var PathLoader = class {
 	* @returns 
 	*/
 	getPath(name, prefix) {
-		let path$1;
-		if (prefix && name !== "base") path$1 = path.join(prefix, this.paths[name]);
-		else path$1 = this.paths[name];
-		if (name === "public") path$1 = path$1.replace("/public", path.join("/", process.env.DIST_DIR ?? ".h3ravel/serve", "public"));
-		else path$1 = path$1.replace("/src/", `/${process.env.DIST_DIR ?? ".h3ravel/serve"}/`);
-		return path.normalize(path$1);
+		let path$2;
+		if (prefix && name !== "base") path$2 = path.join(prefix, this.paths[name]);
+		else path$2 = this.paths[name];
+		if (process.env.NODE_ENV === "production") if (name === "public") path$2 = path$2.replace("/public", path.join("/", process.env.DIST_DIR ?? ".h3ravel/serve", "public"));
+		else path$2 = path$2.replace("/src/", `/${process.env.DIST_DIR ?? ".h3ravel/serve"}/`);
+		return path.normalize(path$2);
 	}
 	/**
 	* Programatically set the paths.
@@ -657,14 +753,15 @@ var PathLoader = class {
 	* @param path - The new path
 	* @param base - The base path to include to the path
 	*/
-	setPath(name, path$2, base) {
-		if (base && name !== "base") this.paths[name] = path.join(base, path$2);
-		this.paths[name] = path$2;
+	setPath(name, path$3, base) {
+		if (base && name !== "base") this.paths[name] = path.join(base, path$3);
+		this.paths[name] = path$3;
 	}
-	distPath(path$3, skipExt = false) {
-		path$3 = path$3.replace("/src/", `/${process.env.DIST_DIR ?? ".h3ravel/serve"}/`.replace(/([^:]\/)\/+/g, "$1"));
-		if (!skipExt) path$3 = path$3.replace(/\.(ts|tsx|mts|cts)$/, ".js");
-		return path.normalize(path$3);
+	distPath(path$4, skipExt = false) {
+		if (process.env.NODE_ENV !== "production") return path.normalize(path$4);
+		path$4 = path$4.replace("/src/", `/${process.env.DIST_DIR ?? ".h3ravel/serve"}/`.replace(/([^:]\/)\/+/g, "$1"));
+		if (!skipExt) path$4 = path$4.replace(/\.(ts|tsx|mts|cts)$/, ".js");
+		return path.normalize(path$4);
 	}
 };
 //#endregion
@@ -920,4 +1017,4 @@ var TaskManager = class {
 	}
 };
 //#endregion
-export { Console, EnvParser, FileSystem, Finalizable, INTERNAL_METHODS, Logger, Magic, PathLoader, Prompts, Resolver, TaskManager, UseMagic, baseTsconfig, crc32, internal, isInternal, mainTsconfig, makeMagic, makeStaticMagic, mix, packageJsonScript, trait, use, uses };
+export { Console, EnvParser, FileSystem, Finalizable, INTERNAL_METHODS, Logger, Magic, PathLoader, Prompts, Resolver, TaskManager, UseMagic, baseTsconfig, crc32, importFile, internal, isInternal, mainTsconfig, makeMagic, makeStaticMagic, mix, packageJsonScript, trait, use, uses };

package/package.json

@@ -1,11 +1,9 @@
 {
   "name": "@h3ravel/shared",
-  "version": "1.29.0-alpha.15",
+  "version": "2.0.0-alpha.16",
   "description": "Shared Utilities.",
   "type": "module",
-  "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
-  "module": "./dist/index.js",
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -50,17 +48,18 @@
     "escalade": "^3.2.0",
     "h3": "2.0.1-rc.5",
     "inquirer-autocomplete-standalone": "^0.8.1",
+    "jiti": "^2.7.0",
     "ora": "^9.1.0",
     "preferred-pm": "^4.1.1"
   },
   "devDependencies": {
-    "@h3ravel/contracts": "^1.29.0-alpha.15",
+    "@h3ravel/contracts": "^2.0.0-alpha.16",
     "fetchdts": "^0.1.6",
     "pnpm": "^10.14.0"
   },
   "scripts": {
     "build": "tsdown --config-loader unrun",
-    "dev": "tsx watch src/index.ts",
+    "dev": "tsdown --watch --config-loader unrun",
     "start": "node dist/index.js",
     "lint": "eslint . --ext .ts",
     "test": "jest --passWithNoTests",

package/dist/index.cjs

@@ -1,976 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-let chalk = require("chalk");
-chalk = __toESM(chalk, 1);
-let fs_promises = require("fs/promises");
-let escalade_sync = require("escalade/sync");
-escalade_sync = __toESM(escalade_sync, 1);
-let fs = require("fs");
-let path = require("path");
-path = __toESM(path, 1);
-let inquirer_autocomplete_standalone = require("inquirer-autocomplete-standalone");
-inquirer_autocomplete_standalone = __toESM(inquirer_autocomplete_standalone, 1);
-let _inquirer_prompts = require("@inquirer/prompts");
-let ora = require("ora");
-ora = __toESM(ora, 1);
-let crypto = require("crypto");
-crypto = __toESM(crypto, 1);
-let preferred_pm = require("preferred-pm");
-preferred_pm = __toESM(preferred_pm, 1);
-//#region src/Container.ts
-const INTERNAL_METHODS = Symbol("internal_methods");
-/**
-* Decorator to mark class properties as internal
-* 
-* @param target 
-* @param propertyKey 
-*/
-const internal = (target, propertyKey) => {
-	if (!target[INTERNAL_METHODS]) target[INTERNAL_METHODS] = /* @__PURE__ */ new Set();
-	target[INTERNAL_METHODS].add(propertyKey);
-};
-/**
-* Checks if a property is decorated with the &#64;internal decorator
-* 
-* @param instance 
-* @param prop 
-* @returns 
-*/
-const isInternal = (instance, prop) => {
-	return Object.getPrototypeOf(instance)[INTERNAL_METHODS]?.has(prop) ?? false;
-};
-//#endregion
-//#region src/Mixins/MixinSystem.ts
-/**
-* Helper to mix multiple classes into one, this allows extending multiple classes by any single class
-* 
-* @param bases 
-* @returns 
-*/
-const mix = (...bases) => {
-	class Base {
-		constructor(...args) {
-			let instance = this;
-			for (const constructor of bases) {
-				const result = Reflect.construct(constructor, args, new.target);
-				if (result && (typeof result === "object" || typeof result === "function")) {
-					if (result !== instance) {
-						Object.assign(result, instance);
-						instance = result;
-					}
-				}
-			}
-			return instance;
-		}
-	}
-	for (let i = 0; i < bases.length; i++) {
-		const currentBase = bases[i];
-		const nextBase = bases[i + 1];
-		Object.getOwnPropertyNames(currentBase.prototype).forEach((prop) => {
-			if (prop !== "constructor") Object.defineProperty(Base.prototype, prop, Object.getOwnPropertyDescriptor(currentBase.prototype, prop));
-		});
-		Object.getOwnPropertyNames(currentBase).forEach((prop) => {
-			if (![
-				"prototype",
-				"name",
-				"length"
-			].includes(prop)) Object.defineProperty(Base, prop, Object.getOwnPropertyDescriptor(currentBase, prop));
-		});
-		if (nextBase) {
-			Object.setPrototypeOf(currentBase.prototype, nextBase.prototype);
-			Object.setPrototypeOf(currentBase, nextBase);
-		}
-	}
-	Object.setPrototypeOf(Base.prototype, bases[0].prototype);
-	Object.setPrototypeOf(Base, bases[0]);
-	return Base;
-};
-//#endregion
-//#region src/Mixins/TraitSystem.ts
-const crcTable = [];
-for (let n = 0; n < 256; n++) {
-	let c = n;
-	for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
-	crcTable[n] = c;
-}
-const crc32 = (str) => {
-	let crc = -1;
-	for (let i = 0; i < str.length; i++) crc = crc >>> 8 ^ crcTable[(crc ^ str.charCodeAt(i)) & 255];
-	return (crc ^ -1) >>> 0;
-};
-const isCons = (fn) => typeof fn === "function" && !!fn.prototype && !!fn.prototype.constructor;
-const isTypeFactory = (fn) => typeof fn === "function" && !fn.prototype && fn.length === 0;
-function trait(...args) {
-	const factory = args.length === 2 ? args[1] : args[0];
-	const superTraits = args.length === 2 ? args[0] : void 0;
-	return {
-		id: crc32(factory.toString()),
-		symbol: Symbol("trait"),
-		factory,
-		superTraits
-	};
-}
-const extendProperties = (cons, field, value) => Object.defineProperty(cons, field, {
-	value,
-	enumerable: false,
-	writable: false
-});
-const rawTrait = (x) => isTypeFactory(x) ? x() : x;
-const deriveTrait = (trait$, baseClz, derived) => {
-	const trait = rawTrait(trait$);
-	let clz = baseClz;
-	if (!derived.has(trait.id)) {
-		derived.set(trait.id, true);
-		if (trait.superTraits !== void 0) for (const superTrait of reverseTraitList(trait.superTraits)) clz = deriveTrait(superTrait, clz, derived);
-		clz = trait.factory(clz);
-		extendProperties(clz, "id", crc32(trait.factory.toString()));
-		extendProperties(clz, trait.symbol, true);
-	}
-	return clz;
-};
-const reverseTraitList = (traits) => traits.slice().reverse();
-function use(...traits) {
-	if (traits.length === 0) throw new Error("invalid number of parameters (expected one or more traits)");
-	let clz;
-	let lot;
-	const last = traits[traits.length - 1];
-	if (isCons(last) && !isTypeFactory(last)) {
-		clz = last;
-		lot = traits.slice(0, -1);
-	} else {
-		clz = class ROOT {};
-		lot = traits;
-	}
-	const derived = /* @__PURE__ */ new Map();
-	for (const trait of reverseTraitList(lot)) clz = deriveTrait(trait, clz, derived);
-	return clz;
-}
-function uses(instance, trait) {
-	if (typeof instance !== "object" || instance === null) return false;
-	let obj = instance;
-	if (isCons(trait) && !isTypeFactory(trait)) return instance instanceof trait;
-	const idTrait = (isTypeFactory(trait) ? trait() : trait)["id"];
-	while (obj) {
-		if (Object.hasOwn(obj, "constructor")) {
-			if ((obj.constructor["id"] ?? 0) === idTrait) return true;
-		}
-		obj = Object.getPrototypeOf(obj);
-	}
-	return false;
-}
-//#endregion
-//#region src/Mixins/UseFinalizable.ts
-/**
-* the central class instance registry
-*/
-const registry = new FinalizationRegistry((fn) => {
-	if (typeof fn === "function" && !fn.finalized) {
-		fn.finalized = true;
-		fn();
-	}
-});
-/**
-* the API trait "Finalizable<T>"
-*/
-const Finalizable = trait((base) => class Finalizable extends base {
-	constructor(...args) {
-		super(...args);
-		const fn1 = this.$finalize;
-		if (typeof fn1 !== "function") throw new Error("trait Finalizable requires a $finalize method to be defined");
-		const fn2 = () => {
-			fn1(this);
-		};
-		fn2.finalized = false;
-		registry.register(this, fn2, this);
-	}
-});
-//#endregion
-//#region src/Mixins/UseMagic.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 
-*/
-function makeMagic(target) {
-	return new Proxy(target, {
-		/**
-		* Intercepts property access and missing method calls.
-		*/
-		get(obj, prop, receiver) {
-			if (typeof prop === "string") {
-				if (prop in obj) return Reflect.get(obj, prop, receiver);
-				if (obj.__call) return (...args) => obj.__call(prop, args);
-				if (obj.__get) return obj.__get(prop);
-			}
-		},
-		/**
-		* Intercepts property assignment.
-		*/
-		set(obj, prop, value) {
-			if (typeof prop === "string" && obj.__set) {
-				obj.__set(prop, value);
-				return true;
-			}
-			return Reflect.set(obj, prop, value);
-		},
-		/**
-		* Intercepts `in` operator and existence checks.
-		*/
-		has(obj, prop) {
-			if (typeof prop === "string" && obj.__isset) return obj.__isset(prop);
-			return Reflect.has(obj, prop);
-		},
-		/**
-		* Intercepts `delete obj.prop`.
-		*/
-		deleteProperty(obj, prop) {
-			if (typeof prop === "string" && obj.__unset) {
-				obj.__unset(prop);
-				return true;
-			}
-			return Reflect.deleteProperty(obj, prop);
-		}
-	});
-}
-/**
-* 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 
-*/
-function makeStaticMagic(cls) {
-	return new Proxy(cls, {
-		/**
-		* Intercepts static property access and missing static calls.
-		*/
-		get(target, prop) {
-			if (typeof prop === "string") {
-				if (prop in target) return target[prop];
-				if (target.__callStatic) return (...args) => target.__callStatic(prop, args);
-				if (target.__get) return target.__get(prop);
-			}
-		},
-		/**
-		* Intercepts static property assignment.
-		*/
-		set(target, prop, value) {
-			if (typeof prop === "string" && target.__set) {
-				target.__set(prop, value);
-				return true;
-			}
-			return Reflect.set(target, prop, value);
-		},
-		/**
-		* Intercepts `prop in Class`.
-		*/
-		has(target, prop) {
-			if (typeof prop === "string" && target.__isset) return target.__isset(prop);
-			return Reflect.has(target, prop);
-		},
-		/**
-		* Intercepts `delete Class.prop`.
-		*/
-		deleteProperty(target, prop) {
-			if (typeof prop === "string" && target.__unset) {
-				target.__unset(prop);
-				return true;
-			}
-			return Reflect.deleteProperty(target, prop);
-		}
-	});
-}
-/**
-* Base class that enables PHP-style magic methods automatically.
-*
-* Any subclass may implement:
-*  - __call
-*  - __get
-*  - __set
-*  - __isset
-*  - __unset
-*
-* The constructor returns a Proxy transparently.
-*/
-var Magic = class {
-	constructor() {
-		return makeMagic(this);
-	}
-};
-const UseMagic = trait((Base) => {
-	return class Magic extends Base {
-		constructor(...args) {
-			super(...args);
-			return makeMagic(this);
-		}
-	};
-});
-//#endregion
-//#region src/Utils/Logger.ts
-var Logger = class Logger {
-	/**
-	* Global verbosity configuration
-	*/
-	static verbosity = 0;
-	static isQuiet = false;
-	static isSilent = false;
-	/**
-	* Configure global verbosity levels
-	*/
-	static configure(options = {}) {
-		this.verbosity = options.verbosity ?? 0;
-		this.isQuiet = options.quiet ?? false;
-		this.isSilent = options.silent ?? false;
-	}
-	/**
-	* Check if output should be suppressed
-	*/
-	static shouldSuppressOutput(level) {
-		if (this.isSilent) return true;
-		if (this.isQuiet && (level === "info" || level === "success")) return true;
-		if (level === "debug" && this.verbosity < 3) return true;
-		return false;
-	}
-	static twoColumnDetail(name, value, log = true, spacer = ".") {
-		const regex = /\x1b\[\d+m/g;
-		const width = Math.max(process.stdout.columns, 100);
-		const dots = Math.max(width - name.replace(regex, "").length - value.replace(regex, "").length - 10, 0);
-		if (log) return console.log(name, chalk.default.gray(spacer.repeat(dots)), value);
-		else return [
-			name,
-			chalk.default.gray(spacer.repeat(dots)),
-			value
-		];
-	}
-	static describe(name, desc, width = 50, log = true) {
-		width = Math.max(width, 30);
-		const dots = Math.max(width - name.replace(/\x1b\[\d+m/g, "").length, 0);
-		if (log) return console.log(name, " ".repeat(dots), desc);
-		else return [
-			name,
-			" ".repeat(dots),
-			desc
-		];
-	}
-	/**
-	* Logs the message in two columns but allways passing status
-	* 
-	* @param name 
-	* @param value 
-	* @param status 
-	* @param exit 
-	* @param preserveCol 
-	*/
-	static split(name, value, status, exit = false, preserveCol = false, spacer = ".") {
-		status ??= "info";
-		const color = {
-			success: chalk.default.bgGreen,
-			info: chalk.default.bgBlue,
-			error: chalk.default.bgRed
-		};
-		const [_name, dots, val] = this.twoColumnDetail(name, value, false, spacer);
-		console.log(this.textFormat(_name, color[status], preserveCol), dots, val);
-		if (exit) process.exit(0);
-	}
-	/**
-	* Wraps text with chalk
-	* 
-	* @param txt 
-	* @param color 
-	* @param preserveCol 
-	* @returns 
-	*/
-	static textFormat(txt, color, preserveCol = false) {
-		if (txt instanceof Error) {
-			const err = txt;
-			const code = err.code ?? err.statusCode ? ` (${err.code ?? err.statusCode})` : "";
-			const output = [];
-			if (err.message) output.push(this.textFormat(`${err.constructor.name}${code}: ${err.message}`, chalk.default.bgRed, preserveCol));
-			if (err.stack) output.push("    " + chalk.default.white(err.stack.replace(`${err.name}: ${err.message}`, "").trim()));
-			return output.join("\n");
-		}
-		if (Array.isArray(txt)) return txt.map((e) => this.textFormat(e, color, preserveCol)).join("\n");
-		if (typeof txt === "object") return this.textFormat(Object.values(txt), color, preserveCol);
-		if (typeof txt !== "string") return color(txt);
-		const str = String(txt);
-		if (preserveCol) return str;
-		const [first, ...rest] = str.split(":");
-		if (rest.length === 0) return str;
-		return color(` ${first} `) + rest.join(":");
-	}
-	/**
-	* Logs a success message
-	* 
-	* @param msg 
-	* @param exit 
-	* @param preserveCol 
-	*/
-	static success(msg, exit = false, preserveCol = false) {
-		if (!this.shouldSuppressOutput("success")) console.log(chalk.default.green("✓"), this.textFormat(msg, chalk.default.bgGreen, preserveCol));
-		if (exit) process.exit(0);
-	}
-	/**
-	* Logs an informational message
-	* 
-	* @param msg 
-	* @param exit 
-	* @param preserveCol 
-	*/
-	static info(msg, exit = false, preserveCol = false) {
-		if (!this.shouldSuppressOutput("info")) console.log(chalk.default.blue("ℹ"), this.textFormat(msg, chalk.default.bgBlue, preserveCol));
-		if (exit) process.exit(0);
-	}
-	/**
-	* Logs an error message
-	* 
-	* @param msg 
-	* @param exit 
-	* @param preserveCol 
-	*/
-	static error(msg, exit = true, preserveCol = false) {
-		if (!this.shouldSuppressOutput("error")) if (msg instanceof Error) {
-			if (msg.message) console.error(chalk.default.red("✖"), this.textFormat("ERROR:" + msg.message, chalk.default.bgRed, preserveCol));
-			console.error(chalk.default.red(`${msg.detail ? `${msg.detail}\n` : ""}${msg.stack}`));
-		} else console.error(chalk.default.red("✖"), this.textFormat(msg, chalk.default.bgRed, preserveCol));
-		if (exit) process.exit(1);
-	}
-	/**
-	* Logs a warning message
-	* 
-	* @param msg 
-	* @param exit 
-	* @param preserveCol 
-	*/
-	static warn(msg, exit = false, preserveCol = false) {
-		if (!this.shouldSuppressOutput("warn")) console.warn(chalk.default.yellow("⚠"), this.textFormat(msg, chalk.default.bgYellow, preserveCol));
-		if (exit) process.exit(0);
-	}
-	/**
-	* Logs a debug message (only shown with verbosity >= 3)
-	* 
-	* @param msg 
-	* @param exit 
-	* @param preserveCol 
-	*/
-	static debug(msg, exit = false, preserveCol = false) {
-		if (!this.shouldSuppressOutput("debug")) if (Array.isArray(msg)) for (let i = 0; i < msg.length; i++) console.log(chalk.default.gray("🐛"), chalk.default.bgGray(i + 1), this.textFormat(msg[i], chalk.default.bgGray, preserveCol));
-		else console.log(chalk.default.gray("🐛"), this.textFormat(msg, chalk.default.bgGray, preserveCol));
-		if (exit) process.exit(0);
-	}
-	/**
-	* Terminates the process
-	*/
-	static quiet() {
-		process.exit(0);
-	}
-	static chalker(styles) {
-		return (input) => styles.reduce((acc, style) => {
-			if (style in chalk.default) return (typeof style === "function" ? style : chalk.default[style])(acc);
-			return acc;
-		}, input);
-	}
-	static parse(config, joiner = " ", log = true, sc) {
-		const string = config.map(([str, opt]) => {
-			if (Array.isArray(opt)) opt = Logger.chalker(opt);
-			const output = typeof opt === "string" && typeof chalk.default[opt] === "function" ? chalk.default[opt](str) : typeof opt === "function" ? opt(str) : str;
-			if (!sc) return output;
-			return this.textFormat(output, Logger.chalker(Array.isArray(sc) ? sc : [sc]));
-		}).join(joiner);
-		if (log && !this.shouldSuppressOutput("line")) console.log(string);
-		else return string;
-	}
-	/**
-	* Ouput formater object or format the output
-	* 
-	* @returns 
-	*/
-	static log = ((config, joiner, log = true, sc) => {
-		if (typeof config === "string") {
-			const conf = [[config, joiner]];
-			return this.parse(conf, "", log, sc);
-		} else if (Array.isArray(config)) return this.parse(config, String(joiner), log, sc);
-		else if (log && !this.shouldSuppressOutput("line")) return console.log(this.textFormat(config, Logger.chalker(["blue"])));
-		return this;
-	});
-	/**
-	* A simple console like output logger
-	* 
-	* @returns 
-	*/
-	static console() {
-		return Console;
-	}
-};
-//#endregion
-//#region src/Utils/Console.ts
-var Console = class {
-	static log = (...args) => Logger.log(args.map((e) => [e, "white"]));
-	static debug = (...args) => Logger.debug(args, false, true);
-	static warn = (...args) => args.map((e) => Logger.warn(e, false, true));
-	static info = (...args) => args.map((e) => Logger.info(e, false, true));
-	static error = (...args) => args.map((e) => Logger.error(e, false), true);
-};
-//#endregion
-//#region src/Utils/EnvParser.ts
-var EnvParser = class {
-	static parse(initial) {
-		const parsed = { ...initial };
-		for (const key in parsed) {
-			const value = parsed[key];
-			parsed[key] = this.parseValue(value);
-		}
-		return parsed;
-	}
-	static parseValue(value) {
-		/**
-		* Null/undefined stay untouched 
-		*/
-		if (value === null || value === void 0) return value;
-		/**
-		* Convert string "true"/"false" to boolean 
-		*/
-		if (value === "true") return true;
-		if (value === "false") return false;
-		/**
-		*  Convert string numbers to number 
-		*/
-		if (!isNaN(value) && value.trim() !== "") return Number(value);
-		/**
-		* Convert string "null" and "undefined"
-		*/
-		if (value === "null") return null;
-		if (value === "undefined") return void 0;
-		/**
-		* Otherwise return as-is (string)
-		*/
-		return value;
-	}
-};
-//#endregion
-//#region src/Utils/FileSystem.ts
-var FileSystem = class {
-	static findModulePkg(moduleId, cwd) {
-		const parts = moduleId.replace(/\\/g, "/").split("/");
-		let packageName = "";
-		if (parts.length > 0 && parts[0][0] === "@") packageName += parts.shift() + "/";
-		packageName += parts.shift();
-		const packageJson = path.default.join(cwd ?? process.cwd(), "node_modules", packageName);
-		const resolved = this.resolveFileUp("package", ["json"], packageJson);
-		if (!resolved) return;
-		return path.default.join(path.default.dirname(resolved), parts.join("/"));
-	}
-	/**
-	* Check if file exists
-	* 
-	* @param path 
-	* @returns 
-	*/
-	static async fileExists(path$5) {
-		try {
-			await (0, fs_promises.access)(path$5);
-			return true;
-		} catch {
-			return false;
-		}
-	}
-	/**
-	* Recursively find files starting from given cwd
-	* 
-	* @param name 
-	* @param extensions 
-	* @param cwd 
-	* 
-	* @returns 
-	*/
-	static resolveFileUp(name, extensions, cwd) {
-		cwd ??= process.cwd();
-		return (0, escalade_sync.default)(cwd, (dir, filesNames) => {
-			if (typeof extensions === "function") return extensions(dir, filesNames);
-			const candidates = new Set(extensions.map((ext) => `${name}.${ext}`));
-			for (const filename of filesNames) if (candidates.has(filename)) return filename;
-			return false;
-		}) ?? void 0;
-	}
-	/**
-	* Recursively find files starting from given cwd
-	* 
-	* @param name 
-	* @param extensions 
-	* @param cwd 
-	* 
-	* @returns 
-	*/
-	static resolveModulePath(moduleId, pathName, cwd) {
-		pathName = Array.isArray(pathName) ? pathName : [pathName];
-		const module = this.findModulePkg(moduleId, cwd) ?? "";
-		for (const name of pathName) {
-			const file = path.default.join(module, name);
-			if ((0, fs.existsSync)(file)) return file;
-		}
-	}
-};
-//#endregion
-//#region src/Utils/PathLoader.ts
-var PathLoader = class {
-	paths = {
-		app: "/src/app",
-		src: "/src/",
-		base: "",
-		views: "/src/resources/views",
-		assets: "/public/assets",
-		routes: "/src/routes",
-		config: "/src/config",
-		public: "/public",
-		storage: "/storage",
-		database: "/src/database",
-		commands: "/src/app/Console/Commands"
-	};
-	/**
-	* 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, prefix) {
-		let path$2;
-		if (prefix && name !== "base") path$2 = path.default.join(prefix, this.paths[name]);
-		else path$2 = this.paths[name];
-		if (name === "public") path$2 = path$2.replace("/public", path.default.join("/", process.env.DIST_DIR ?? ".h3ravel/serve", "public"));
-		else path$2 = path$2.replace("/src/", `/${process.env.DIST_DIR ?? ".h3ravel/serve"}/`);
-		return path.default.normalize(path$2);
-	}
-	/**
-	* 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, path$3, base) {
-		if (base && name !== "base") this.paths[name] = path.default.join(base, path$3);
-		this.paths[name] = path$3;
-	}
-	distPath(path$4, skipExt = false) {
-		path$4 = path$4.replace("/src/", `/${process.env.DIST_DIR ?? ".h3ravel/serve"}/`.replace(/([^:]\/)\/+/g, "$1"));
-		if (!skipExt) path$4 = path$4.replace(/\.(ts|tsx|mts|cts)$/, ".js");
-		return path.default.normalize(path$4);
-	}
-};
-//#endregion
-//#region src/Utils/Prompts.ts
-var Prompts = class extends Logger {
-	/**
-	* Allows users to pick from a predefined set of choices when asked a question.
-	* 
-	* @param message      Message to display
-	* @param choices      The choices available to the user
-	* @param defaultIndex Item index front of which the cursor will initially appear
-	* @param pageSize     The number of items to show per page
-	* @returns
-	*/
-	static async choice(message, choices, defaultIndex, pageSize) {
-		return (0, _inquirer_prompts.select)({
-			message,
-			choices,
-			default: defaultIndex ? choices.at(defaultIndex) : void 0,
-			pageSize
-		});
-	}
-	/**
-	* Ask the user for a simple "yes or no" confirmation. 
-	* By default, this method returns `false`. However, if the user enters y or yes 
-	* in response to the prompt, the method would return `true`.
-	* 
-	* @param message      Message to display
-	* @param defaultValue The default value
-	*/
-	static async confirm(message, defaultValue) {
-		return (0, _inquirer_prompts.confirm)({
-			message,
-			default: defaultValue
-		});
-	}
-	/**
-	* Prompt the user with the given question, accept their input, 
-	* and then return the user's input back to your command.
-	* 
-	* @param message      Message to display
-	* @param defaultValue The default value
-	* @returns 
-	*/
-	static async ask(message, defaultValue) {
-		return (0, _inquirer_prompts.input)({
-			message,
-			default: defaultValue
-		});
-	}
-	/**
-	* Prompt the user with the given question, accept their input which 
-	* will not be visible to them as they type in the console, 
-	* and then return the user's input back to your command.
-	* 
-	* @param message Message to display
-	* @param mask    Mask the user input
-	* @returns 
-	*/
-	static async secret(message, mask) {
-		return (0, _inquirer_prompts.password)({
-			message,
-			mask
-		});
-	}
-	/**
-	* Provide auto-completion for possible choices. 
-	* The user can still provide any answer, regardless of the auto-completion hints.
-	*/
-	/**
-	* 
-	* @param message      Message to dislpay
-	* @param source       The source of completions
-	* @param defaultValue Set a default value
-	* @param pageSize     The number of items to show per page
-	* @returns 
-	*/
-	static async anticipate(message, source, defaultValue, pageSize) {
-		return (0, inquirer_autocomplete_standalone.default)({
-			message,
-			source: Array.isArray(source) ? async (term) => {
-				return (term ? source.filter((e) => e.includes(term)) : source).map((e) => ({ value: e }));
-			} : source,
-			suggestOnly: true,
-			default: defaultValue,
-			pageSize
-		});
-	}
-	/**
-	* Display a spinner while performing a long task
-	* 
-	* @param options The spinner options
-	* @returns 
-	*/
-	static spinner(options) {
-		return (0, ora.default)(options);
-	}
-	/**
-	* Allows users to select multiple options from a predefined list of choices.
-	* 
-	* @param message  Message to display
-	* @param choices  The choices available to the user
-	* @param required Whether at least one choice is required
-	* @param prefix   Prefix to display before the message
-	* @param pageSize The number of items to show per page
-	* @returns
-	*/
-	static async checkbox(message, choices, required, prefix, pageSize) {
-		return await (0, _inquirer_prompts.checkbox)({
-			message,
-			choices,
-			required,
-			prefix,
-			pageSize
-		});
-	}
-	/**
-	* Open the user's default text editor to accept multi-line input.
-	* 
-	* @param message  Message to display
-	* @param postfix  The postfix of the file being edited [e.g., '.txt', '.md']
-	* @param defaultValue The default value to pre-fill in the editor
-	* @param validate A function to validate the input text
-	* @returns
-	*/
-	static async editor(message, postfix, defaultValue, validate) {
-		return await (0, _inquirer_prompts.editor)({
-			message: message ?? "Please provide your input in the editor below:",
-			postfix,
-			default: defaultValue,
-			validate
-		});
-	}
-};
-//#endregion
-//#region src/Utils/Resolver.ts
-var Resolver = class {
-	static async getPakageInstallCommand(pkg) {
-		const pm = (await (0, preferred_pm.default)(process.cwd()))?.name ?? "pnpm";
-		let cmd = "install ";
-		if (!pkg) if (pm === "npm" || pm === "pnpm" || pm === "bun") cmd = "install";
-		else cmd = "";
-		else if (pm === "yarn" || pm === "pnpm" || pm === "bun") cmd = "add ";
-		return `${pm} ${cmd}${pkg ?? ""}`;
-	}
-	static async getInstallCommand(pkg) {
-		const pm = (await (0, preferred_pm.default)(process.cwd()))?.name ?? "pnpm";
-		let cmd = "install";
-		if (pm === "yarn" || pm === "pnpm") cmd = "add";
-		else if (pm === "bun") cmd = "create";
-		return `${pm} ${cmd} ${pkg}`;
-	}
-	/**
-	* Create a hash for a function or an object
-	* 
-	* @param provider 
-	* @returns 
-	*/
-	static hashObjectOrFunction(provider) {
-		return crypto.default.createHash("sha1").update(provider.toString()).digest("hex");
-	}
-	/**
-	* Checks if a function is asyncronous
-	* 
-	* @param func 
-	* @returns 
-	*/
-	static isAsyncFunction(func) {
-		if (typeof func !== "function") return false;
-		return Object.prototype.toString.call(func) === "[object AsyncFunction]";
-	}
-};
-//#endregion
-//#region src/Utils/scripts.ts
-const mainTsconfig = {
-	extends: "@h3ravel/shared/tsconfig.base.json",
-	compilerOptions: {
-		paths: {
-			"src/*": ["./../src/*"],
-			"App/*": ["./../src/app/*"],
-			"root/*": ["./../*"],
-			"routes/*": ["./../src/routes/*"],
-			"config/*": ["./../src/config/*"],
-			"resources/*": ["./../src/resources/*"]
-		},
-		target: "es2022",
-		module: "es2022",
-		moduleResolution: "bundler",
-		esModuleInterop: true,
-		strict: true,
-		allowJs: true,
-		skipLibCheck: true,
-		resolveJsonModule: true,
-		noEmit: true,
-		experimentalDecorators: true,
-		emitDecoratorMetadata: true
-	},
-	include: ["./**/*.d.ts", "./../**/*"],
-	exclude: [
-		".",
-		"./../**/console/bin",
-		"./../dist",
-		"./../**/dist",
-		"./../**/node_modules",
-		"./../.node_modules",
-		"./../**/node_modules/*",
-		"./../**/public",
-		"./../public",
-		"./../**/storage",
-		"./../storage",
-		"./../**coverage**",
-		"./../eslint.config.js",
-		"./../jest.config.ts",
-		"./../arquebus.config.js"
-	]
-};
-const baseTsconfig = { extends: "./.h3ravel/tsconfig.json" };
-const packageJsonScript = {
-	build: "NODE_ENV=production tsdown --config-loader unrun -c tsdown.default.config.ts",
-	dev: "NODE_ENV=development pnpm tsdown --config-loader unrun -c tsdown.default.config.ts",
-	start: "DIST_DIR=dist node -r source-map-support/register dist/server.js",
-	lint: "eslint . --ext .ts",
-	test: "NODE_NO_WARNINGS=1 NODE_ENV=testing jest --passWithNoTests",
-	postinstall: "pnpm prepare"
-};
-//#endregion
-//#region src/Utils/TaskManager.ts
-var TaskManager = class {
-	static async taskRunner(description, task) {
-		const startTime = process.hrtime();
-		let result = false;
-		try {
-			result = await Promise.all([(task || (() => true))()].flat());
-		} finally {
-			const endTime = process.hrtime(startTime);
-			const duration = (endTime[0] * 1e9 + endTime[1]) / 1e6;
-			Logger.twoColumnDetail(Logger.parse([[description, "green"]], "", false), [Logger.parse([[`${Math.floor(duration)}ms`, "gray"]], "", false), Logger.parse([[result !== false ? "✔" : "✘", result !== false ? "green" : "red"]], "", false)].join(" "));
-		}
-	}
-	static async advancedTaskRunner(info, task) {
-		const startTime = process.hrtime();
-		const [startInfo, stopInfo] = info;
-		if (stopInfo) Logger.twoColumnDetail(startInfo[0], Logger.log(startInfo[1], ["yellow", "bold"], false));
-		try {
-			return await Promise.race([task()]);
-		} catch (e) {
-			Logger.error("ERROR: " + e.message);
-		} finally {
-			const endTime = process.hrtime(startTime);
-			const duration = (endTime[0] * 1e9 + endTime[1]) / 1e6;
-			Logger.twoColumnDetail(stopInfo?.[0] ?? startInfo[0], [Logger.parse([[`${Math.floor(duration)}ms`, "gray"]], "", false), Logger.parse([[`✔ ${stopInfo?.[1] ?? startInfo[1]}`, ["green", "bold"]]], "", false)].join(" "));
-		}
-	}
-};
-//#endregion
-exports.Console = Console;
-exports.EnvParser = EnvParser;
-exports.FileSystem = FileSystem;
-exports.Finalizable = Finalizable;
-exports.INTERNAL_METHODS = INTERNAL_METHODS;
-exports.Logger = Logger;
-exports.Magic = Magic;
-exports.PathLoader = PathLoader;
-exports.Prompts = Prompts;
-exports.Resolver = Resolver;
-exports.TaskManager = TaskManager;
-exports.UseMagic = UseMagic;
-exports.baseTsconfig = baseTsconfig;
-exports.crc32 = crc32;
-exports.internal = internal;
-exports.isInternal = isInternal;
-exports.mainTsconfig = mainTsconfig;
-exports.makeMagic = makeMagic;
-exports.makeStaticMagic = makeStaticMagic;
-exports.mix = mix;
-exports.packageJsonScript = packageJsonScript;
-exports.trait = trait;
-exports.use = use;
-exports.uses = uses;