@wolfstar/http-framework 5.0.0-next-20260919162943 → 5.1.0

package/dist/esm/config.js

@@ -1,872 +1,3 @@
-import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { defineDiagnostics } from "nostics";
+export * from "@wolfstar/schema"
 
-//#region src/lib/config/errors.ts
-/**
-* Structured, stable diagnostic codes for every way a `stars.config.*` can fail to load or validate.
-*
-* This is a plain data error (no exit code or terminal formatting), so nothing here reports anywhere on its own —
-* `reporters` stays empty and each call only builds and returns a `Diagnostic`. That keeps it meaningful outside a
-* CLI, e.g. for a dashboard or test that calls {@link loadStarsConfig} directly; `@wolfstar/cli` is what renders it
-* and picks an exit code (`exitCodeOf`).
-*
-* The `sources` field (populated with the configuration file, when there is one) carries the "which file" grounding
-* `ConfigError` used to expose as `.file`; the "which option" grounding it exposed as `.path` is folded directly into
-* every `why`/`fix` message instead, the way every other diagnostic code already reads.
-*
-* `why` and `fix` are always given the same, fully-typed params object (even when one of them ignores part of it):
-* a bare `() => value` loses nostics' param-type inference (a zero-arg function widens to `unknown` params), so every
-* entry here spells out its shape on both sides instead.
-*/
-const configDiagnostics = defineDiagnostics({
-	docsBase: (code) => `https://stars-components.js.org/docs/config/errors#${code.toLowerCase()}`,
-	reporters: [],
-	codes: {
-		ROOT_NOT_FOUND: {
-			why: (p) => `The project root does not exist: ${p.root}`,
-			fix: (_p) => "Point `root` to an existing directory, relative to the configuration file."
-		},
-		PACKAGE_JSON_INVALID: {
-			why: (p) => `Failed to parse ${p.file}: ${p.message}`,
-			fix: (_p) => "Fix the JSON syntax of the package.json file."
-		},
-		ENTRY_NOT_FOUND: {
-			why: (p) => `The entry file does not exist: ${p.entry}`,
-			fix: (_p) => "Point `entry` to the file that starts the bot, relative to the project root."
-		},
-		ENTRY_DEFAULT_NOT_FOUND: {
-			why: (p) => `Could not find the entry file in ${p.root}`,
-			fix: (p) => `Set \`entry\` in the configuration, or create one of ${p.defaults}.`
-		},
-		INVALID_BUILD_TOOL: {
-			why: (p) => `Unknown build tool "${p.tool}"`,
-			fix: (_p) => "Use one of 'tsdown', 'tsc', 'vite', 'none' or 'auto'."
-		},
-		EXPERIMENTAL_BUILD_TOOL: {
-			why: (p) => `The '${p.tool}' build tool is experimental`,
-			fix: (p) => `Set \`${p.flag}\` to true to use it.`
-		},
-		BUILD_TOOL_REQUIRED: {
-			why: (p) => `The entry ${p.entry} is TypeScript but the build tool is 'none'`,
-			fix: (_p) => "Set `build.tool` to 'tsdown' or 'tsc', or point `entry` to a JavaScript file."
-		},
-		TSCONFIG_EXPLICIT_NOT_FOUND: {
-			why: (p) => `The tsconfig file does not exist: ${p.tsconfig}`,
-			fix: (p) => `Point \`${p.path}\` to an existing tsconfig.json, relative to the project root.`
-		},
-		TSCONFIG_NOT_FOUND: {
-			why: (p) => `Could not find a tsconfig.json in ${p.root}`,
-			fix: (p) => `Create src/tsconfig.json or tsconfig.json, or set \`${p.suggestion}\`.`
-		},
-		TSDOWN_OPTIONS_REQUIRE_TSDOWN: {
-			why: (_p) => "`tsdown` options need the `tsdown` build tool",
-			fix: (p) => `Set \`build.tool\` to 'tsdown', or remove \`tsdown\` (the build tool is '${p.tool}').`
-		},
-		VITE_OPTIONS_REQUIRE_VITE: {
-			why: (_p) => "`vite` options need the `vite` build tool",
-			fix: (p) => `Set \`build.tool\` to 'vite' with \`experimental.enableVite\`, or remove \`vite\` (the build tool is '${p.tool}').`
-		},
-		TSDOWN_CONFIG_FILE_UNSUPPORTED: {
-			why: (p) => `\`${p.file}\` is not used with compatibility version ${p.version}`,
-			fix: (p) => `Move its options into \`tsdown\` here, drop the ${p.file} configuration, or set \`future.compatibilityVersion\` to ${p.legacyVersion}.`
-		},
-		INVALID_TYPE: {
-			why: (p) => `\`${p.path}\` must be ${p.expected}, received ${describeValue(p.value)}`,
-			fix: (p) => p.fix
-		},
-		INVALID_COMPATIBILITY_VERSION: {
-			why: (p) => `Unknown compatibility version ${describeValue(p.value)}`,
-			fix: (p) => `Use ${p.legacyVersion} for the legacy build pipeline or ${p.latestVersion} for today's defaults.`
-		},
-		UNKNOWN_OPTION: {
-			why: (p) => `Unknown option \`${p.path}\``,
-			fix: (p) => `Known options${p.parent ? ` of \`${p.parent}\`` : ""}: ${p.known}.`
-		},
-		EXPERIMENT_REQUIRED: {
-			why: (p) => `\`${p.path}\` needs \`${p.requires}\``,
-			fix: (p) => `Set \`${p.requires}\` to true as well, or drop \`${p.drop}\`.`
-		},
-		IMPORTS_REQUIRE_TSDOWN: {
-			why: (_p) => "`imports` requires the `tsdown` build tool",
-			fix: (_p) => "Set `build.tool` to 'tsdown', or remove `imports`/set it to `false`."
-		},
-		LOCALES_NOT_FOUND: {
-			why: (p) => `The locales directory does not exist: ${p.locales}`,
-			fix: (_p) => "Point `codegen.i18n.locales` to the base locale directory, relative to the project root."
-		},
-		INVALID_URL: {
-			why: (p) => `Invalid URL "${p.url}"`,
-			fix: (p) => p.fix
-		},
-		TUNNEL_URL_NOT_HTTPS: {
-			why: (p) => `The tunnel URL must be https, received "${p.url}"`,
-			fix: (_p) => "Discord only accepts an https interactions endpoint."
-		},
-		INVALID_TYPECHECKER: {
-			why: (p) => `Unknown type checker "${p.checker}"`,
-			fix: (_p) => "Use one of 'tsc', 'golar', 'tsz' or 'auto'."
-		},
-		CONFIG_NOT_FOUND: {
-			why: (p) => `Configuration file not found: ${p.file}`,
-			fix: (p) => `Pass an existing file to --config, or create one of ${p.names} in ${p.cwd}.`
-		},
-		CONFIG_LOAD_FAILED: {
-			why: (p) => `Failed to load the configuration: ${p.message}`,
-			fix: (_p) => "The file must be valid TypeScript/JavaScript and export the configuration as its default export."
-		},
-		CONFIG_NOT_OBJECT: {
-			why: (_p) => "The configuration file must export an object as its default export.",
-			fix: (_p) => "Use `export default defineConfig({ ... })` from '@wolfstar/http-framework/config'."
-		}
-	}
-});
-function describeValue(value) {
-	if (value === null) return "null";
-	if (Array.isArray(value)) return "an array";
-	if (typeof value === "string") return `"${value}"`;
-	return typeof value === "object" ? "an object" : `${typeof value} ${String(value)}`;
-}
-
-//#endregion
-//#region src/lib/config/load.ts
-const CONFIG_EXTENSIONS = [
-	"ts",
-	"mts",
-	"cts",
-	"js",
-	"mjs",
-	"cjs"
-];
-const CONFIG_FILE_NAMES = CONFIG_EXTENSIONS.map((extension) => `stars.config.${extension}`);
-/**
-* Finds the first `stars.config.*` file in `cwd`, in {@link CONFIG_FILE_NAMES} order.
-*/
-function discoverConfigFile(cwd) {
-	for (const name of CONFIG_FILE_NAMES) {
-		const candidate = join(cwd, name);
-		if (isFile$1(candidate)) return candidate;
-	}
-	return null;
-}
-/**
-* Loads the raw configuration object. The loader (`c12`) is imported lazily so
-* commands that never touch the configuration stay fast.
-*/
-async function loadConfigFile(options) {
-	const cwd = resolve(options.cwd);
-	let file;
-	if (options.configFile) {
-		file = resolve(cwd, options.configFile);
-		if (!isFile$1(file)) throw configDiagnostics.CONFIG_NOT_FOUND({
-			file,
-			cwd,
-			names: CONFIG_FILE_NAMES.join(", ")
-		});
-	} else {
-		file = discoverConfigFile(cwd);
-		if (!file) return {
-			configFile: null,
-			config: {}
-		};
-	}
-	const { loadConfig } = await import("c12");
-	let loaded;
-	try {
-		const result = await loadConfig({
-			name: "stars",
-			cwd: dirname(file),
-			configFile: basename(file),
-			rcFile: false,
-			globalRc: false,
-			dotenv: false,
-			packageJson: false,
-			defaults: {}
-		});
-		const layer = result.layers?.find((candidate) => candidate.configFile && resolve(candidate.cwd ?? dirname(file), candidate.configFile) === file);
-		loaded = layer ? layer.config : result.config;
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw configDiagnostics.CONFIG_LOAD_FAILED({
-			message,
-			cause: error,
-			sources: [file]
-		});
-	}
-	if (loaded === null || typeof loaded !== "object" || Array.isArray(loaded)) throw configDiagnostics.CONFIG_NOT_OBJECT({ sources: [file] });
-	return {
-		configFile: file,
-		config: loaded
-	};
-}
-function isFile$1(path) {
-	try {
-		return existsSync(path) && statSync(path).isFile();
-	} catch {
-		return false;
-	}
-}
-
-//#endregion
-//#region src/lib/config/resolve.ts
-const DEFAULT_ENTRIES = [
-	"src/main.ts",
-	"src/main.js",
-	"src/index.ts",
-	"src/index.js"
-];
-const DEFAULT_IGNORE = [
-	"**/node_modules/**",
-	"**/dist/**",
-	"**/.git/**"
-];
-const DEFAULT_DEBOUNCE = 150;
-const DEFAULT_KILL_TIMEOUT = 5e3;
-const DEFAULT_NODE_ARGS = ["--enable-source-maps"];
-const DEFAULT_DEV_PORT = 3e3;
-const DEFAULT_I18N_LOCALES = "src/locales/en-US";
-const DEFAULT_I18N_OUTPUT = "src/@types/i18next.d.ts";
-const DEFAULT_IMPORTS_DIRS = ["src/lib/**", "src/utils/**"];
-const DEFAULT_IMPORTS_PRESETS = ["@wolfstar/http-framework", "@wolfstar/env-utilities"];
-const DEFAULT_IMPORTS_DTS = ".stars/imports.d.ts";
-const DEFAULT_DEV_LOG_FILE = ".stars/dev.log";
-const DEFAULT_TUNNEL_PATH = "/";
-const DEFAULT_COMPATIBILITY_VERSION = 4;
-const LEGACY_COMPATIBILITY_VERSION = 3;
-const LATEST_COMPATIBILITY_VERSION = 4;
-const COMPATIBILITY_VERSIONS = /* @__PURE__ */ new Set([3, 4]);
-const BUILD_TOOLS = /* @__PURE__ */ new Set([
-	"tsdown",
-	"tsc",
-	"none",
-	"vite",
-	"auto"
-]);
-const TYPECHECKERS = /* @__PURE__ */ new Set([
-	"tsc",
-	"golar",
-	"tsz",
-	"auto"
-]);
-const VITE_CONFIG_FILES = [
-	"vite.config.ts",
-	"vite.config.mts",
-	"vite.config.cts",
-	"vite.config.js",
-	"vite.config.mjs",
-	"vite.config.cjs"
-];
-const TSDOWN_CONFIG_FILES = [
-	"tsdown.config.ts",
-	"tsdown.config.mts",
-	"tsdown.config.cts",
-	"tsdown.config.js",
-	"tsdown.config.mjs",
-	"tsdown.config.cjs",
-	"tsdown.config.json"
-];
-const TYPESCRIPT_EXTENSIONS = /* @__PURE__ */ new Set([
-	".ts",
-	".mts",
-	".cts"
-]);
-/**
-* Applies defaults, validates every option and resolves all paths to absolute ones.
-*
-* @throws {Diagnostic} (from `nostics`, via {@link configDiagnostics}) with an actionable `fix` on the first invalid option.
-*/
-function resolveStarsConfig(options) {
-	const cwd = resolve(options.cwd);
-	const env = options.env ?? process.env;
-	const file = options.configFile;
-	const config = options.config;
-	const validator = new Validator(file);
-	validator.knownKeys(config, "", [
-		"root",
-		"entry",
-		"build",
-		"dev",
-		"codegen",
-		"imports",
-		"experimental",
-		"future",
-		"vite",
-		"tsdown"
-	]);
-	const baseDirectory = file ? dirname(file) : cwd;
-	const root = resolve(baseDirectory, validator.string(config.root, "root") ?? ".");
-	if (!isDirectory(root)) throw validator.error(configDiagnostics.ROOT_NOT_FOUND, { root });
-	const packageJson = readPackageJson(root, validator);
-	const experimental = resolveExperimental(config.experimental ?? {}, validator);
-	const future = resolveFuture(config.future ?? {}, validator);
-	const entry = resolveEntry(root, validator.string(config.entry, "entry"), validator);
-	const vite = validator.plainObject(config.vite, "vite") ?? {};
-	const tsdown = validator.plainObject(config.tsdown, "tsdown") ?? {};
-	const build = resolveBuild(root, entry, packageJson, config.build ?? {}, experimental, future, Object.keys(tsdown).length > 0, validator);
-	const dev = resolveDev(root, entry, packageJson, config.dev ?? {}, env, validator);
-	const codegen = resolveCodegen(root, config.codegen ?? {}, validator);
-	const imports = resolveImports(root, build.tool, future, config.imports, validator);
-	if (Object.keys(tsdown).length > 0 && build.tool !== "tsdown") throw validator.error(configDiagnostics.TSDOWN_OPTIONS_REQUIRE_TSDOWN, { tool: build.tool });
-	if (Object.keys(vite).length > 0 && build.tool !== "vite") throw validator.error(configDiagnostics.VITE_OPTIONS_REQUIRE_VITE, { tool: build.tool });
-	return {
-		configFile: file,
-		cwd,
-		root,
-		packageJson,
-		entry,
-		build,
-		dev,
-		codegen,
-		imports,
-		experimental,
-		future,
-		vite,
-		tsdown
-	};
-}
-/**
-* Presents an absolute path relative to `root` when possible, for display purposes.
-*/
-function displayPath(root, path) {
-	const rel = relative(root, path);
-	if (!rel) return ".";
-	return rel.startsWith("..") || isAbsolute(rel) ? path : rel;
-}
-function resolveEntry(root, configured, validator) {
-	if (configured !== void 0) {
-		const entry = resolve(root, configured);
-		if (!isFile(entry)) throw validator.error(configDiagnostics.ENTRY_NOT_FOUND, { entry });
-		return entry;
-	}
-	for (const candidate of DEFAULT_ENTRIES) {
-		const entry = join(root, candidate);
-		if (isFile(entry)) return entry;
-	}
-	throw validator.error(configDiagnostics.ENTRY_DEFAULT_NOT_FOUND, {
-		root,
-		defaults: DEFAULT_ENTRIES.join(", ")
-	});
-}
-function resolveBuild(root, entry, packageJson, config, experimental, future, hasTsdownOptions, validator) {
-	validator.knownKeys(config, "build", [
-		"tool",
-		"outDir",
-		"tsconfig"
-	]);
-	const requested = validator.string(config.tool, "build.tool") ?? "auto";
-	if (!BUILD_TOOLS.has(requested)) throw validator.error(configDiagnostics.INVALID_BUILD_TOOL, { tool: requested });
-	if (requested === "vite" && !experimental.enableVite) throw validator.error(configDiagnostics.EXPERIMENTAL_BUILD_TOOL, {
-		tool: "vite",
-		flag: "experimental.enableVite"
-	});
-	const isTypeScriptEntry = TYPESCRIPT_EXTENSIONS.has(extname(entry));
-	const tool = requested === "auto" ? detectBuildTool(root, packageJson, isTypeScriptEntry, experimental, future, hasTsdownOptions) : requested;
-	if (tool === "none" && isTypeScriptEntry) throw validator.error(configDiagnostics.BUILD_TOOL_REQUIRED, { entry: displayPath(root, entry) });
-	const defaultOutDir = experimental.enableNitro ? ".output" : "dist";
-	const outDir = resolve(root, validator.string(config.outDir, "build.outDir") ?? defaultOutDir);
-	let tsconfig = null;
-	const configuredTsconfig = validator.string(config.tsconfig, "build.tsconfig");
-	if (configuredTsconfig !== void 0) {
-		tsconfig = resolve(root, configuredTsconfig);
-		if (!isFile(tsconfig)) throw validator.error(configDiagnostics.TSCONFIG_EXPLICIT_NOT_FOUND, {
-			tsconfig,
-			path: "build.tsconfig"
-		});
-	} else if (tool === "tsc" || tool === "tsdown") {
-		tsconfig = [join(root, "src", "tsconfig.json"), join(root, "tsconfig.json")].find((candidate) => isFile(candidate)) ?? null;
-		if (!tsconfig && tool === "tsc") throw validator.error(configDiagnostics.TSCONFIG_NOT_FOUND, {
-			root,
-			suggestion: "build.tsconfig"
-		});
-	}
-	const output = experimental.enableNitro ? join(outDir, "server", "index.mjs") : tool === "none" ? entry : resolveBuildOutput(root, entry, outDir, packageJson);
-	let configFile = findConfigFile(root, tool === "tsdown" ? TSDOWN_CONFIG_FILES : tool === "vite" ? VITE_CONFIG_FILES : []);
-	if (tool === "tsdown" && configFile === null && packageJson?.tsdown !== void 0) configFile = join(root, "package.json");
-	if (tool === "tsdown" && configFile !== null && future.compatibilityVersion >= 4) throw validator.error(configDiagnostics.TSDOWN_CONFIG_FILE_UNSUPPORTED, {
-		file: displayPath(root, configFile),
-		version: future.compatibilityVersion,
-		legacyVersion: 3
-	});
-	return {
-		tool,
-		outDir,
-		tsconfig,
-		output,
-		configFile
-	};
-}
-function findConfigFile(root, names) {
-	for (const name of names) {
-		const candidate = join(root, name);
-		if (isFile(candidate)) return candidate;
-	}
-	return null;
-}
-function detectBuildTool(root, packageJson, isTypeScriptEntry, experimental, future, hasTsdownOptions) {
-	if (experimental.enableVite) {
-		if (VITE_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, "vite")) return "vite";
-	}
-	if (hasTsdownOptions) return "tsdown";
-	if (future.compatibilityVersion >= 4) return isTypeScriptEntry ? "tsdown" : "none";
-	if (TSDOWN_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, "tsdown")) return "tsdown";
-	if (isTypeScriptEntry) return "tsc";
-	return "none";
-}
-/**
-* Resolves the Nuxt-style compatibility block. Version 4 is the default; version 3 remains an explicit legacy mode.
-*/
-function resolveFuture(config, validator) {
-	if (config === null || typeof config !== "object" || Array.isArray(config)) throw validator.typeError("future", "an object", config, "Use `{ compatibilityVersion }`.");
-	validator.knownKeys(config, "future", ["compatibilityVersion"]);
-	const version = config.compatibilityVersion;
-	if (version === void 0) return { compatibilityVersion: 4 };
-	if (typeof version !== "number" || !COMPATIBILITY_VERSIONS.has(version)) throw validator.error(configDiagnostics.INVALID_COMPATIBILITY_VERSION, {
-		value: version,
-		legacyVersion: 3,
-		latestVersion: 4
-	});
-	return { compatibilityVersion: version };
-}
-/**
-* Resolves the `experimental` block. Every flag is a boolean defaulting to `false`, the way Nuxt's own experimental
-* flags are declared, and the ones that build on each other are checked here rather than surfacing later as a
-* confusing runtime failure.
-*/
-function resolveExperimental(config, validator) {
-	if (config === null || typeof config !== "object" || Array.isArray(config)) throw validator.typeError("experimental", "an object", config, "Use `{ enableVite, enableExternalVite, enableNitro, nitro }`.");
-	validator.knownKeys(config, "experimental", [
-		"enableVite",
-		"enableExternalVite",
-		"enableNitro",
-		"nitro"
-	]);
-	const enableVite = validator.boolean(config.enableVite, "experimental.enableVite") ?? false;
-	const enableExternalVite = validator.boolean(config.enableExternalVite, "experimental.enableExternalVite") ?? false;
-	const enableNitro = validator.boolean(config.enableNitro, "experimental.enableNitro") ?? false;
-	if (enableExternalVite && !enableVite) throw validator.error(configDiagnostics.EXPERIMENT_REQUIRED, {
-		path: "experimental.enableExternalVite",
-		requires: "experimental.enableVite",
-		drop: "enableExternalVite"
-	});
-	if (enableNitro && !enableVite) throw validator.error(configDiagnostics.EXPERIMENT_REQUIRED, {
-		path: "experimental.enableNitro",
-		requires: "experimental.enableVite",
-		drop: "enableNitro"
-	});
-	const rawNitro = "nitro" in config ? config.nitro : void 0;
-	if (rawNitro !== void 0 && !enableNitro) throw validator.error(configDiagnostics.EXPERIMENT_REQUIRED, {
-		path: "experimental.nitro",
-		requires: "experimental.enableNitro",
-		drop: "nitro"
-	});
-	if (rawNitro !== void 0 && (rawNitro === null || typeof rawNitro !== "object" || Array.isArray(rawNitro))) throw validator.typeError("experimental.nitro", "an object", rawNitro, "Use `{ preset }`.");
-	if (rawNitro) validator.knownKeys(rawNitro, "experimental.nitro", ["preset"]);
-	return {
-		enableVite,
-		enableExternalVite,
-		enableNitro,
-		nitro: { preset: validator.string(rawNitro?.preset, "experimental.nitro.preset") ?? "node-server" }
-	};
-}
-function resolveBuildOutput(root, entry, outDir, packageJson) {
-	if (packageJson?.main) return resolve(root, packageJson.main);
-	const extension = extname(entry);
-	const outputExtension = extension === ".mts" ? ".mjs" : extension === ".cts" ? ".cjs" : ".js";
-	return join(outDir, `${basename(entry, extension)}${outputExtension}`);
-}
-const ENV_PORT_KEYS = ["HTTP_PORT", "PORT"];
-/**
-* Reads the project's environment layers from `src/.env*` and `.env*` into a plain object, the way `stars dev` and
-* `stars commands` need it:
-* these files are only loaded into `process.env` by the bot itself once it starts (see `@wolfstar/env-utilities`),
-* so by the time the CLI runs they are not there yet. This is a minimal line reader, not a full dotenv
-* implementation — quoting is stripped, but expansion (`dotenv-expand`) is not. Earlier files win, matching
-* dotenv's own precedence.
-*/
-function readProjectEnvFiles(root, environment = "development") {
-	const result = {};
-	const files = [
-		`.${environment}.local`,
-		...environment === "test" ? [] : [".local"],
-		`.${environment}`,
-		""
-	].flatMap((suffix) => [join("src", `.env${suffix}`), `.env${suffix}`]);
-	for (const file of files) {
-		const path = join(root, file);
-		if (!isFile(path)) continue;
-		let contents;
-		try {
-			contents = readFileSync(path, "utf-8");
-		} catch {
-			continue;
-		}
-		for (const line of contents.split(/\r?\n/)) {
-			const match = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
-			if (!match) continue;
-			const key = match[1];
-			if (key in result) continue;
-			result[key] = match[2].trim().replace(/^['"]|['"]$/g, "");
-		}
-	}
-	return result;
-}
-function readDevPortFromEnvFile(root, environment) {
-	const values = readProjectEnvFiles(root, environment);
-	for (const key of ENV_PORT_KEYS) if (values[key]) return values[key];
-	return null;
-}
-function resolveDev(root, entry, packageJson, config, env, validator) {
-	validator.knownKeys(config, "dev", [
-		"banner",
-		"watch",
-		"ignore",
-		"debounce",
-		"env",
-		"nodeArgs",
-		"args",
-		"url",
-		"health",
-		"killTimeout",
-		"typecheck",
-		"tunnel",
-		"logFile"
-	]);
-	const watch = (validator.stringArray(config.watch, "dev.watch") ?? [displayPath(root, dirname(entry))]).map((path) => resolve(root, path));
-	const ignore = validator.stringArray(config.ignore, "dev.ignore") ?? [...DEFAULT_IGNORE];
-	const debounce = validator.nonNegativeNumber(config.debounce, "dev.debounce") ?? 150;
-	const devEnv = validator.stringRecord(config.env, "dev.env") ?? {};
-	const nodeArgs = validator.stringArray(config.nodeArgs, "dev.nodeArgs") ?? [...DEFAULT_NODE_ARGS];
-	const args = validator.stringArray(config.args, "dev.args") ?? [];
-	const killTimeout = validator.nonNegativeNumber(config.killTimeout, "dev.killTimeout") ?? 5e3;
-	const health = validator.string(config.health, "dev.health") ?? null;
-	let url = validator.string(config.url, "dev.url") ?? null;
-	if (url !== null) try {
-		new URL(url);
-	} catch {
-		throw validator.error(configDiagnostics.INVALID_URL, {
-			url,
-			fix: "Use an absolute URL such as http://localhost:3000."
-		});
-	}
-	else {
-		const port = devEnv.HTTP_PORT ?? env.HTTP_PORT ?? readDevPortFromEnvFile(root, env.NODE_ENV ?? "development") ?? String(3e3);
-		url = /^\d+$/.test(port) ? `http://localhost:${port}` : `http://localhost:${DEFAULT_DEV_PORT}`;
-	}
-	const typecheck = resolveTypecheck(root, packageJson, config.typecheck, validator);
-	const tunnel = resolveTunnel(config.tunnel, validator);
-	const logFile = config.logFile === false ? null : resolve(root, validator.string(config.logFile, "dev.logFile") ?? ".stars/dev.log");
-	const banner = config.banner === false ? false : typeof config.banner === "string" ? config.banner.split("\n") : validator.stringArray(config.banner, "dev.banner") ?? null;
-	return {
-		watch,
-		ignore,
-		debounce,
-		env: devEnv,
-		nodeArgs,
-		args,
-		url,
-		health,
-		killTimeout,
-		typecheck,
-		tunnel,
-		logFile,
-		banner
-	};
-}
-/**
-* Resolves `dev.typecheck`. The tsconfig is looked up the same way the `tsc` build tool looks up its own, so a
-* project building with `tsdown` still gets `tsc --watch --noEmit` on the right project file.
-*/
-function resolveTypecheck(root, packageJson, config, validator) {
-	if (config === void 0 || config === false) return {
-		enabled: false,
-		tsconfig: null,
-		checker: detectTypechecker(packageJson)
-	};
-	let configured;
-	let requestedChecker = "auto";
-	if (config !== true) {
-		if (config === null || typeof config !== "object" || Array.isArray(config)) throw validator.typeError("dev.typecheck", "a boolean or an object", config, "Use `true` to type-check with the project tsconfig, `{ tsconfig }` to pick one, or `false` to disable it.");
-		validator.knownKeys(config, "dev.typecheck", ["tsconfig", "checker"]);
-		configured = validator.string(config.tsconfig, "dev.typecheck.tsconfig");
-		requestedChecker = validator.string(config.checker, "dev.typecheck.checker") ?? "auto";
-		if (!TYPECHECKERS.has(requestedChecker)) throw validator.error(configDiagnostics.INVALID_TYPECHECKER, { checker: requestedChecker });
-	}
-	const checker = requestedChecker === "auto" ? detectTypechecker(packageJson) : requestedChecker;
-	if (configured !== void 0) {
-		const tsconfig = resolve(root, configured);
-		if (!isFile(tsconfig)) throw validator.error(configDiagnostics.TSCONFIG_EXPLICIT_NOT_FOUND, {
-			tsconfig,
-			path: "dev.typecheck.tsconfig"
-		});
-		return {
-			enabled: true,
-			tsconfig,
-			checker
-		};
-	}
-	const found = [join(root, "src", "tsconfig.json"), join(root, "tsconfig.json")].find((candidate) => isFile(candidate)) ?? null;
-	if (!found) throw validator.error(configDiagnostics.TSCONFIG_NOT_FOUND, {
-		root,
-		suggestion: "dev.typecheck.tsconfig"
-	});
-	return {
-		enabled: true,
-		tsconfig: found,
-		checker
-	};
-}
-/**
-* Picks the type checker when `dev.typecheck.checker` is `auto`: `golar` when the project already depends on it
-* (it wraps TypeScript and is what this repository's own `typecheck` scripts run), `tsc` otherwise. `tsz` is never
-* picked automatically — it is an early, tsc-compatible alternative a project opts into.
-*/
-function detectTypechecker(packageJson) {
-	return hasDependency(packageJson, "golar") ? "golar" : "tsc";
-}
-/**
-* Resolves `dev.tunnel`: `true` (or `{}`) opens a `cloudflared` quick tunnel, a string (or `{ url }`) is an https
-* URL the user already serves and the CLI only checks.
-*/
-function resolveTunnel(config, validator) {
-	if (config === void 0 || config === false) return { mode: "off" };
-	let url;
-	let updateEndpoint = false;
-	let path = "/";
-	if (typeof config === "string") url = config;
-	else if (config !== true) {
-		if (config === null || typeof config !== "object" || Array.isArray(config)) throw validator.typeError("dev.tunnel", "a boolean, an https URL or an object", config, "Use `true` for a cloudflared quick tunnel, an https URL you already serve, or `false` to disable it.");
-		validator.knownKeys(config, "dev.tunnel", [
-			"url",
-			"updateEndpoint",
-			"path"
-		]);
-		url = validator.string(config.url, "dev.tunnel.url");
-		updateEndpoint = validator.boolean(config.updateEndpoint, "dev.tunnel.updateEndpoint") ?? false;
-		path = validator.string(config.path, "dev.tunnel.path") ?? "/";
-	}
-	if (url === void 0) return {
-		mode: "quick",
-		path,
-		updateEndpoint
-	};
-	let parsed;
-	try {
-		parsed = new URL(url);
-	} catch {
-		throw validator.error(configDiagnostics.INVALID_URL, {
-			url,
-			fix: "Use an absolute https URL such as https://bot.example.com."
-		});
-	}
-	if (parsed.protocol !== "https:") throw validator.error(configDiagnostics.TUNNEL_URL_NOT_HTTPS, { url });
-	return {
-		mode: "url",
-		url,
-		path,
-		updateEndpoint
-	};
-}
-function resolveCodegen(root, config, validator) {
-	validator.knownKeys(config, "codegen", ["i18n"]);
-	if (config.i18n === false) return { i18n: null };
-	if (config.i18n === void 0) {
-		const locales = join(root, DEFAULT_I18N_LOCALES);
-		return { i18n: isDirectory(locales) ? {
-			locales,
-			output: join(root, DEFAULT_I18N_OUTPUT)
-		} : null };
-	}
-	if (config.i18n === null || typeof config.i18n !== "object") throw validator.typeError("codegen.i18n", "an object or `false`", config.i18n, "Use `{ locales, output }` to configure it or `false` to disable it.");
-	validator.knownKeys(config.i18n, "codegen.i18n", ["locales", "output"]);
-	const locales = resolve(root, validator.string(config.i18n.locales, "codegen.i18n.locales") ?? "src/locales/en-US");
-	if (!isDirectory(locales)) throw validator.error(configDiagnostics.LOCALES_NOT_FOUND, { locales });
-	return { i18n: {
-		locales,
-		output: resolve(root, validator.string(config.i18n.output, "codegen.i18n.output") ?? "src/@types/i18next.d.ts")
-	} };
-}
-/**
-* The transform that injects auto imports (`@wolfstar/http-framework/auto-imports`) only runs through `tsdown`'s
-* rolldown pipeline, the same way Nuxt's own auto imports only run through its Vite/webpack build: `tsc` and `none`
-* have no transform step to hook into. `tsdown` is picked as `build.tool` first (see {@link detectBuildTool}) for the
-* same reason — it is the only tool this feature, and this build config in general, treats as the default choice.
-*
-* They are on by default from compatibility version 4 on, where `stars` wires the plugin into the build itself. At 3
-* the plugin is the project's to add, so defaulting them on would promise imports that never get injected.
-*/
-function resolveImports(root, buildTool, future, config, validator) {
-	const defaultDirs = DEFAULT_IMPORTS_DIRS.map((dir) => resolve(root, dir));
-	const defaultPresets = [...DEFAULT_IMPORTS_PRESETS];
-	const defaultDts = resolve(root, DEFAULT_IMPORTS_DTS);
-	if (config === false) return {
-		enabled: false,
-		dirs: defaultDirs,
-		presets: defaultPresets,
-		exclude: [],
-		dts: defaultDts
-	};
-	const forcedOn = config === true;
-	const options = forcedOn || config === void 0 ? {} : config;
-	if (typeof options !== "object" || options === null || Array.isArray(options)) throw validator.typeError("imports", "an object, `true` or `false`", options, "Use `{ dirs, presets, exclude, dts }`, `true` to enable with defaults, or `false` to disable.");
-	validator.knownKeys(options, "imports", [
-		"enabled",
-		"dirs",
-		"presets",
-		"exclude",
-		"dts"
-	]);
-	const requestedOn = forcedOn || validator.boolean(options.enabled, "imports.enabled");
-	if (requestedOn && buildTool !== "tsdown") throw validator.error(configDiagnostics.IMPORTS_REQUIRE_TSDOWN, {});
-	const dirs = (validator.stringArray(options.dirs, "imports.dirs") ?? [...DEFAULT_IMPORTS_DIRS]).map((dir) => resolve(root, dir));
-	const presets = validator.stringArray(options.presets, "imports.presets") ?? defaultPresets;
-	const exclude = validator.stringArray(options.exclude, "imports.exclude") ?? [];
-	const dts = resolve(root, validator.string(options.dts, "imports.dts") ?? ".stars/imports.d.ts");
-	const enabledByDefault = buildTool === "tsdown" && future.compatibilityVersion >= 4;
-	return {
-		enabled: requestedOn ?? enabledByDefault,
-		dirs,
-		presets,
-		exclude,
-		dts
-	};
-}
-var Validator = class {
-	constructor(file) {
-		this.file = file;
-	}
-	get sources() {
-		return this.file ? [this.file] : void 0;
-	}
-	error(handle, params) {
-		return handle({
-			...params,
-			sources: this.sources
-		});
-	}
-	knownKeys(value, path, keys) {
-		for (const key of Object.keys(value)) {
-			if (keys.includes(key)) continue;
-			const fullPath = path ? `${path}.${key}` : key;
-			throw this.error(configDiagnostics.UNKNOWN_OPTION, {
-				path: fullPath,
-				parent: path,
-				known: keys.join(", ")
-			});
-		}
-	}
-	string(value, path) {
-		if (value === void 0) return void 0;
-		if (typeof value !== "string" || value.length === 0) throw this.typeError(path, "a non-empty string", value);
-		return value;
-	}
-	boolean(value, path) {
-		if (value === void 0) return void 0;
-		if (typeof value !== "boolean") throw this.typeError(path, "a boolean", value);
-		return value;
-	}
-	/** A plain object passed through as-is (e.g. raw `vite`/`tsdown` config merged into the project's own). */
-	plainObject(value, path) {
-		if (value === void 0) return void 0;
-		if (value === null || typeof value !== "object" || Array.isArray(value)) throw this.typeError(path, "an object", value);
-		return value;
-	}
-	stringArray(value, path) {
-		if (value === void 0) return void 0;
-		if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) throw this.typeError(path, "an array of strings", value);
-		return value;
-	}
-	nonNegativeNumber(value, path) {
-		if (value === void 0) return void 0;
-		if (typeof value !== "number" || !Number.isFinite(value) || value < 0) throw this.typeError(path, "a non-negative number", value);
-		return value;
-	}
-	stringRecord(value, path) {
-		if (value === void 0) return void 0;
-		if (value === null || typeof value !== "object" || Array.isArray(value) || !Object.values(value).every((item) => typeof item === "string")) throw this.typeError(path, "an object of string values", value);
-		return value;
-	}
-	/** A generic "wrong type" diagnostic. `fix` defaults to the standard "set it or remove it" wording. */
-	typeError(path, expected, value, fix) {
-		return this.error(configDiagnostics.INVALID_TYPE, {
-			path,
-			expected,
-			value,
-			fix: fix ?? `Set \`${path}\` to ${expected} or remove it to use the default.`
-		});
-	}
-};
-function hasDependency(packageJson, name) {
-	return Boolean(packageJson?.dependencies?.[name] ?? packageJson?.devDependencies?.[name]);
-}
-function readPackageJson(root, validator) {
-	const file = join(root, "package.json");
-	if (!isFile(file)) return null;
-	try {
-		const parsed = JSON.parse(readFileSync(file, "utf-8"));
-		return parsed !== null && typeof parsed === "object" ? parsed : null;
-	} catch (error) {
-		throw validator.error(configDiagnostics.PACKAGE_JSON_INVALID, {
-			file,
-			message: error instanceof Error ? error.message : String(error),
-			cause: error
-		});
-	}
-}
-function isFile(path) {
-	try {
-		return existsSync(path) && statSync(path).isFile();
-	} catch {
-		return false;
-	}
-}
-function isDirectory(path) {
-	try {
-		return existsSync(path) && statSync(path).isDirectory();
-	} catch {
-		return false;
-	}
-}
-
-//#endregion
-//#region src/lib/config/index.ts
-/**
-* Loads, validates and resolves a project's `stars.config.*`.
-*
-* @throws {Diagnostic} (from `nostics`, via {@link configDiagnostics}) when the configuration file cannot be loaded or contains an invalid option.
-*/
-async function loadStarsConfig(options = {}) {
-	const cwd = options.cwd ?? process.cwd();
-	const loaded = await loadConfigFile({
-		cwd,
-		configFile: options.configFile
-	});
-	return resolveStarsConfig({
-		cwd,
-		configFile: loaded.configFile,
-		config: loaded.config,
-		env: options.env
-	});
-}
-
-//#endregion
-//#region src/config.ts
-/**
-* Typed helper for `stars.config.{ts,mts,cts,js,mjs,cjs}` files.
-*
-* @example
-* ```ts
-* import { defineConfig } from '@wolfstar/http-framework/config';
-*
-* export default defineConfig({
-* 	entry: 'src/main.ts',
-* 	build: { tool: 'tsdown' }
-* });
-* ```
-*/
-function defineConfig(config) {
-	return config;
-}
-
-//#endregion
-export { CONFIG_EXTENSIONS, CONFIG_FILE_NAMES, configDiagnostics, defineConfig, discoverConfigFile, displayPath, loadConfigFile, loadStarsConfig, readProjectEnvFiles, resolveStarsConfig };
-//# sourceMappingURL=config.js.map
+export {  };