@wolfstar/cli 0.1.0-next-20260904111115

package/dist/dev-QUxuLcXj.js

@@ -0,0 +1,30 @@
+import { t as projectArgs } from "./args-Ch1KXUMn.js";
+import { defineCommand } from "citty";
+
+//#region src/commands/dev.ts
+var dev_default = defineCommand({
+	meta: {
+		name: "dev",
+		description: "Build, run and restart the bot on changes"
+	},
+	args: {
+		...projectArgs,
+		tui: {
+			type: "boolean",
+			description: "Interactive terminal UI; use --no-tui (or STARS_TUI=plain) for plain line output",
+			default: true
+		}
+	},
+	async run({ args }) {
+		const { runDev } = await import("./dev-DWg8l23a.js");
+		await runDev({
+			config: args.config,
+			cwd: args.cwd,
+			tui: args.tui ? void 0 : false
+		});
+	}
+});
+
+//#endregion
+export { dev_default as default };
+//# sourceMappingURL=dev-QUxuLcXj.js.map

package/dist/dev-QUxuLcXj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-QUxuLcXj.js","names":[],"sources":["../src/commands/dev.ts"],"sourcesContent":["import { defineCommand } from 'citty';\nimport { projectArgs } from '../lib/args.js';\n\nexport default defineCommand({\n\tmeta: {\n\t\tname: 'dev',\n\t\tdescription: 'Build, run and restart the bot on changes'\n\t},\n\targs: {\n\t\t...projectArgs,\n\t\ttui: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Interactive terminal UI; use --no-tui (or STARS_TUI=plain) for plain line output',\n\t\t\tdefault: true\n\t\t}\n\t},\n\tasync run({ args }) {\n\t\tconst { runDev } = await import('../lib/tasks/dev.js');\n\t\tawait runDev({ config: args.config, cwd: args.cwd, tui: args.tui ? undefined : false });\n\t}\n});\n"],"mappings":";;;;AAGA,kBAAe,cAAc;CAC5B,MAAM;EACL,MAAM;EACN,aAAa;CACd;CACA,MAAM;EACL,GAAG;EACH,KAAK;GACJ,MAAM;GACN,aAAa;GACb,SAAS;EACV;CACD;CACA,MAAM,IAAI,EAAE,QAAQ;EACnB,MAAM,EAAE,WAAW,MAAM,OAAO;EAChC,MAAM,OAAO;GAAE,QAAQ,KAAK;GAAQ,KAAK,KAAK;GAAK,KAAK,KAAK,MAAM,SAAY;EAAM,CAAC;CACvF;AACD,CAAC"}

package/dist/errors-Bket6XFn.js

@@ -0,0 +1,50 @@
+import { ConfigError } from "@wolfstar/http-framework/config";
+
+//#region src/lib/errors.ts
+const ExitCode = {
+	Ok: 0,
+	Error: 1,
+	InvalidConfig: 2,
+	BuildFailed: 3,
+	Interrupted: 130,
+	Terminated: 143
+};
+/**
+* An error the CLI reports to the user without a stack trace.
+*/
+var CliError = class extends Error {
+	code;
+	hint;
+	exitCode;
+	constructor(message, options) {
+		super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+		this.name = "CliError";
+		this.code = options.code;
+		this.hint = options.hint ?? null;
+		this.exitCode = options.exitCode ?? ExitCode.Error;
+	}
+};
+/**
+* Formats an error for the terminal: message, optional location and hint.
+*
+* `ConfigError` comes from `@wolfstar/http-framework/config`: the framework validates `stars.config.*` and throws a
+* plain data error, the CLI decides how it looks on a terminal and which exit code it gets ({@link exitCodeOf}).
+*/
+function formatError(error) {
+	if (error instanceof ConfigError) {
+		const location = [error.file, error.path ? `option \`${error.path}\`` : null].filter(Boolean).join(" › ");
+		return [`${error.message}${location ? ` (${location})` : ""}`, error.hint ? `  hint: ${error.hint}` : null].filter(Boolean).join("\n");
+	}
+	if (error instanceof CliError) return [error.message, error.hint ? `  hint: ${error.hint}` : null].filter(Boolean).join("\n");
+	if (error instanceof Error && error.name === "CLIError") return error.message;
+	if (error instanceof Error) return error.stack ?? error.message;
+	return String(error);
+}
+function exitCodeOf(error) {
+	if (error instanceof ConfigError) return ExitCode.InvalidConfig;
+	return error instanceof CliError ? error.exitCode : ExitCode.Error;
+}
+
+//#endregion
+export { formatError as i, ExitCode as n, exitCodeOf as r, CliError as t };
+//# sourceMappingURL=errors-Bket6XFn.js.map

package/dist/errors-Bket6XFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-Bket6XFn.js","names":[],"sources":["../src/lib/errors.ts"],"sourcesContent":["import { ConfigError } from '@wolfstar/http-framework/config';\n\nexport const ExitCode = {\n\tOk: 0,\n\tError: 1,\n\tInvalidConfig: 2,\n\tBuildFailed: 3,\n\tInterrupted: 130,\n\tTerminated: 143\n} as const;\n\nexport type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];\n\nexport interface CliErrorOptions {\n\t/** A stable, machine readable code. */\n\tcode: string;\n\t/** A short, actionable suggestion. */\n\thint?: string;\n\texitCode?: ExitCode;\n\tcause?: unknown;\n}\n\n/**\n * An error the CLI reports to the user without a stack trace.\n */\nexport class CliError extends Error {\n\tpublic readonly code: string;\n\tpublic readonly hint: string | null;\n\tpublic readonly exitCode: ExitCode;\n\n\tpublic constructor(message: string, options: CliErrorOptions) {\n\t\tsuper(message, options.cause === undefined ? undefined : { cause: options.cause });\n\t\tthis.name = 'CliError';\n\t\tthis.code = options.code;\n\t\tthis.hint = options.hint ?? null;\n\t\tthis.exitCode = options.exitCode ?? ExitCode.Error;\n\t}\n}\n\n/**\n * Formats an error for the terminal: message, optional location and hint.\n *\n * `ConfigError` comes from `@wolfstar/http-framework/config`: the framework validates `stars.config.*` and throws a\n * plain data error, the CLI decides how it looks on a terminal and which exit code it gets ({@link exitCodeOf}).\n */\nexport function formatError(error: unknown): string {\n\tif (error instanceof ConfigError) {\n\t\tconst location = [error.file, error.path ? `option \\`${error.path}\\`` : null].filter(Boolean).join(' › ');\n\t\treturn [`${error.message}${location ? ` (${location})` : ''}`, error.hint ? `  hint: ${error.hint}` : null].filter(Boolean).join('\\n');\n\t}\n\n\tif (error instanceof CliError) {\n\t\treturn [error.message, error.hint ? `  hint: ${error.hint}` : null].filter(Boolean).join('\\n');\n\t}\n\n\t// citty's CLIError (unknown command, missing argument): the message is enough.\n\tif (error instanceof Error && error.name === 'CLIError') return error.message;\n\tif (error instanceof Error) return error.stack ?? error.message;\n\treturn String(error);\n}\n\nexport function exitCodeOf(error: unknown): ExitCode {\n\tif (error instanceof ConfigError) return ExitCode.InvalidConfig;\n\treturn error instanceof CliError ? error.exitCode : ExitCode.Error;\n}\n"],"mappings":";;;AAEA,MAAa,WAAW;CACvB,IAAI;CACJ,OAAO;CACP,eAAe;CACf,aAAa;CACb,aAAa;CACb,YAAY;AACb;;;;AAgBA,IAAa,WAAb,cAA8B,MAAM;CACnC,AAAgB;CAChB,AAAgB;CAChB,AAAgB;CAEhB,AAAO,YAAY,SAAiB,SAA0B;EAC7D,MAAM,SAAS,QAAQ,UAAU,SAAY,SAAY,EAAE,OAAO,QAAQ,MAAM,CAAC;EACjF,KAAK,OAAO;EACZ,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO,QAAQ,QAAQ;EAC5B,KAAK,WAAW,QAAQ,YAAY,SAAS;CAC9C;AACD;;;;;;;AAQA,SAAgB,YAAY,OAAwB;CACnD,IAAI,iBAAiB,aAAa;EACjC,MAAM,WAAW,CAAC,MAAM,MAAM,MAAM,OAAO,YAAY,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;EACxG,OAAO,CAAC,GAAG,MAAM,UAAU,WAAW,KAAK,SAAS,KAAK,MAAM,MAAM,OAAO,WAAW,MAAM,SAAS,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CACtI;CAEA,IAAI,iBAAiB,UACpB,OAAO,CAAC,MAAM,SAAS,MAAM,OAAO,WAAW,MAAM,SAAS,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CAI9F,IAAI,iBAAiB,SAAS,MAAM,SAAS,YAAY,OAAO,MAAM;CACtE,IAAI,iBAAiB,OAAO,OAAO,MAAM,SAAS,MAAM;CACxD,OAAO,OAAO,KAAK;AACpB;AAEA,SAAgB,WAAW,OAA0B;CACpD,IAAI,iBAAiB,aAAa,OAAO,SAAS;CAClD,OAAO,iBAAiB,WAAW,MAAM,WAAW,SAAS;AAC9D"}

package/dist/external-Bk4EESdT.js

@@ -0,0 +1,59 @@
+import { displayPath } from "@wolfstar/http-framework/config";
+import { dirname } from "node:path";
+import { EventEmitter } from "node:events";
+
+//#region src/lib/builders/external.ts
+/**
+* Runs no build of its own: the project drives one itself (`vite dev`, `vite build --watch`, a task runner, …) and
+* this only watches what that build writes, restarting the bot whenever the output changes.
+*
+* This is what `experimental.enableExternalVite` selects — the CLI stays out of the build's way but keeps the rest
+* of `stars dev` (restarts, health, tunnel, type checking, the panel) working.
+*/
+var ExternalBuilder = class extends EventEmitter {
+	config;
+	tool;
+	#watcher = null;
+	constructor(config) {
+		super();
+		this.config = config;
+		this.tool = config.build.tool;
+	}
+	build() {
+		this.emit("start");
+		const outcome = {
+			ok: true,
+			durationMs: 0,
+			message: null
+		};
+		this.emit("success", outcome);
+		return Promise.resolve(outcome);
+	}
+	async watch() {
+		const { watch } = await import("chokidar");
+		const target = dirname(this.config.build.output);
+		this.emit("log", "info", `Watching ${displayPath(this.config.root, target)} for an external build`);
+		const watcher = watch(target, {
+			ignored: [...this.config.dev.ignore],
+			ignoreInitial: true,
+			cwd: this.config.root
+		});
+		this.#watcher = watcher;
+		watcher.on("all", (event, path) => {
+			this.emit("log", "info", `${event}: ${path}`);
+			this.build();
+		});
+		watcher.on("error", (error) => this.emit("log", "error", error instanceof Error ? error.message : String(error)));
+		await new Promise((resolve) => watcher.once("ready", resolve));
+		await this.build();
+	}
+	async close() {
+		const watcher = this.#watcher;
+		this.#watcher = null;
+		await watcher?.close();
+	}
+};
+
+//#endregion
+export { ExternalBuilder };
+//# sourceMappingURL=external-Bk4EESdT.js.map

package/dist/external-Bk4EESdT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-Bk4EESdT.js","names":["#watcher"],"sources":["../src/lib/builders/external.ts"],"sourcesContent":["import type { ResolvedStarsConfig, StarsBuildTool } from '@wolfstar/http-framework/config';\nimport { dirname } from 'node:path';\nimport { EventEmitter } from 'node:events';\nimport { displayPath } from '@wolfstar/http-framework/config';\nimport type { Builder, BuilderEvents, BuildOutcome } from './types.js';\n\n/**\n * Runs no build of its own: the project drives one itself (`vite dev`, `vite build --watch`, a task runner, …) and\n * this only watches what that build writes, restarting the bot whenever the output changes.\n *\n * This is what `experimental.enableExternalVite` selects — the CLI stays out of the build's way but keeps the rest\n * of `stars dev` (restarts, health, tunnel, type checking, the panel) working.\n */\nexport class ExternalBuilder extends EventEmitter<BuilderEvents> implements Builder {\n\tpublic readonly tool: StarsBuildTool;\n\t#watcher: { close(): Promise<void> } | null = null;\n\n\tpublic constructor(private readonly config: ResolvedStarsConfig) {\n\t\tsuper();\n\t\tthis.tool = config.build.tool;\n\t}\n\n\tpublic build(): Promise<BuildOutcome> {\n\t\tthis.emit('start');\n\t\tconst outcome: BuildOutcome = { ok: true, durationMs: 0, message: null };\n\t\tthis.emit('success', outcome);\n\t\treturn Promise.resolve(outcome);\n\t}\n\n\tpublic async watch(): Promise<void> {\n\t\tconst { watch } = await import('chokidar');\n\t\tconst target = dirname(this.config.build.output);\n\t\tthis.emit('log', 'info', `Watching ${displayPath(this.config.root, target)} for an external build`);\n\n\t\tconst watcher = watch(target, { ignored: [...this.config.dev.ignore], ignoreInitial: true, cwd: this.config.root });\n\t\tthis.#watcher = watcher;\n\n\t\twatcher.on('all', (event, path) => {\n\t\t\tthis.emit('log', 'info', `${event}: ${path}`);\n\t\t\tvoid this.build();\n\t\t});\n\t\twatcher.on('error', (error) => this.emit('log', 'error', error instanceof Error ? error.message : String(error)));\n\n\t\tawait new Promise<void>((resolve) => watcher.once('ready', resolve));\n\t\tawait this.build();\n\t}\n\n\tpublic async close(): Promise<void> {\n\t\tconst watcher = this.#watcher;\n\t\tthis.#watcher = null;\n\t\tawait watcher?.close();\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,kBAAb,cAAqC,aAA+C;CAI/C;CAHpC,AAAgB;CAChB,WAA8C;CAE9C,AAAO,YAAY,AAAiB,QAA6B;EAChE,MAAM;EAD6B;EAEnC,KAAK,OAAO,OAAO,MAAM;CAC1B;CAEA,AAAO,QAA+B;EACrC,KAAK,KAAK,OAAO;EACjB,MAAM,UAAwB;GAAE,IAAI;GAAM,YAAY;GAAG,SAAS;EAAK;EACvE,KAAK,KAAK,WAAW,OAAO;EAC5B,OAAO,QAAQ,QAAQ,OAAO;CAC/B;CAEA,MAAa,QAAuB;EACnC,MAAM,EAAE,UAAU,MAAM,OAAO;EAC/B,MAAM,SAAS,QAAQ,KAAK,OAAO,MAAM,MAAM;EAC/C,KAAK,KAAK,OAAO,QAAQ,YAAY,YAAY,KAAK,OAAO,MAAM,MAAM,EAAE,uBAAuB;EAElG,MAAM,UAAU,MAAM,QAAQ;GAAE,SAAS,CAAC,GAAG,KAAK,OAAO,IAAI,MAAM;GAAG,eAAe;GAAM,KAAK,KAAK,OAAO;EAAK,CAAC;EAClH,KAAKA,WAAW;EAEhB,QAAQ,GAAG,QAAQ,OAAO,SAAS;GAClC,KAAK,KAAK,OAAO,QAAQ,GAAG,MAAM,IAAI,MAAM;GAC5C,AAAK,KAAK,MAAM;EACjB,CAAC;EACD,QAAQ,GAAG,UAAU,UAAU,KAAK,KAAK,OAAO,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,CAAC;EAEhH,MAAM,IAAI,SAAe,YAAY,QAAQ,KAAK,SAAS,OAAO,CAAC;EACnE,MAAM,KAAK,MAAM;CAClB;CAEA,MAAa,QAAuB;EACnC,MAAM,UAAU,KAAKA;EACrB,KAAKA,WAAW;EAChB,MAAM,SAAS,MAAM;CACtB;AACD"}

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import { ConfigError, ConfigErrorOptions, ResolvedStarsConfig, loadStarsConfig } from "@wolfstar/http-framework/config";
+//#region src/lib/errors.d.ts
+declare const ExitCode: {
+  readonly Ok: 0;
+  readonly Error: 1;
+  readonly InvalidConfig: 2;
+  readonly BuildFailed: 3;
+  readonly Interrupted: 130;
+  readonly Terminated: 143;
+};
+type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+interface CliErrorOptions {
+  /** A stable, machine readable code. */
+  code: string;
+  /** A short, actionable suggestion. */
+  hint?: string;
+  exitCode?: ExitCode;
+  cause?: unknown;
+}
+/**
+ * An error the CLI reports to the user without a stack trace.
+ */
+declare class CliError extends Error {
+  readonly code: string;
+  readonly hint: string | null;
+  readonly exitCode: ExitCode;
+  constructor(message: string, options: CliErrorOptions);
+}
+/**
+ * Formats an error for the terminal: message, optional location and hint.
+ *
+ * `ConfigError` comes from `@wolfstar/http-framework/config`: the framework validates `stars.config.*` and throws a
+ * plain data error, the CLI decides how it looks on a terminal and which exit code it gets ({@link exitCodeOf}).
+ */
+declare function formatError(error: unknown): string;
+declare function exitCodeOf(error: unknown): ExitCode;
+//#endregion
+//#region src/lib/output-mode.d.ts
+type OutputMode = 'tui' | 'plain';
+interface ResolveOutputModeOptions {
+  /** `--no-tui` (`tui: false`) or `--tui` (`tui: true`) from the command line. */
+  tui?: boolean;
+  env?: NodeJS.ProcessEnv;
+  /** Whether stdout is an interactive terminal. */
+  isTTY?: boolean;
+  /** Whether the process runs in a CI environment. */
+  isCI?: boolean;
+}
+/**
+ * Decides between the interactive TUI and plain line output.
+ *
+ * Precedence: `--no-tui` › `STARS_TUI=plain` › non-interactive stdout, CI or `TERM=dumb`.
+ */
+declare function resolveOutputMode(options?: ResolveOutputModeOptions): OutputMode;
+declare function isCIEnvironment(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Whether colours should be emitted, honouring `NO_COLOR` and `FORCE_COLOR`.
+ */
+declare function shouldUseColor(env?: NodeJS.ProcessEnv, isTTY?: boolean): boolean;
+/**
+ * Whether animations (spinners, blinking status) should be avoided.
+ */
+declare function prefersReducedMotion(env?: NodeJS.ProcessEnv): boolean;
+//#endregion
+export { CliError, type CliErrorOptions, ConfigError, type ConfigErrorOptions, ExitCode, type OutputMode, type ResolveOutputModeOptions, type ResolvedStarsConfig, exitCodeOf, formatError, isCIEnvironment, loadStarsConfig, prefersReducedMotion, resolveOutputMode, shouldUseColor };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/lib/errors.ts","../src/lib/output-mode.ts"],"mappings":";;cAEa;WACZ;WACA;WACA;WACA;WACA;WACA;;KAGW,mBAAmB,uBAAuB;UAErC;;EAEhB;;EAEA;EACA,WAAW;EACX;;;;;cAMY,iBAAiB;WACb;WACA;WACA,UAAU;EAE1B,YAAmB,iBAAiB,SAAS;;;;;;;;iBAe9B,YAAY;iBAgBZ,WAAW,iBAAiB;;;KC7DhC;UAEK;;EAEhB;EACA,MAAM,OAAO;;EAEb;;EAEA;;;;;;;iBAUe,kBAAkB,UAAS,2BAAgC;iBAgB3D,gBAAgB,MAAK,OAAO;;;;iBAU5B,eAAe,MAAK,OAAO,YAA0B;;;;iBASrD,qBAAqB,MAAK,OAAO"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { i as formatError, n as ExitCode, r as exitCodeOf, t as CliError } from "./errors-Bket6XFn.js";
+import { i as shouldUseColor, n as prefersReducedMotion, r as resolveOutputMode, t as isCIEnvironment } from "./output-mode-ChrOf0LO.js";
+import { ConfigError, loadStarsConfig } from "@wolfstar/http-framework/config";
+
+export { CliError, ConfigError, ExitCode, exitCodeOf, formatError, isCIEnvironment, loadStarsConfig, prefersReducedMotion, resolveOutputMode, shouldUseColor };

package/dist/info-B-8rAIn6.js

@@ -0,0 +1,106 @@
+import { t as readOwnPackageJson } from "./version-DN6Uho-Y.js";
+import { i as shouldUseColor, r as resolveOutputMode } from "./output-mode-ChrOf0LO.js";
+import { n as resolveCwd } from "./args-Ch1KXUMn.js";
+import { t as findInstalledVersion } from "./project-DHF3qdm-.js";
+import { displayPath, loadStarsConfig } from "@wolfstar/http-framework/config";
+import { relative } from "node:path";
+import { createColors } from "colorette";
+import { arch, platform } from "node:os";
+
+//#region src/lib/tasks/info.ts
+function collectInfo(config) {
+	return {
+		cli: {
+			version: readOwnPackageJson().version,
+			node: process.version,
+			platform: `${platform()} ${arch()}`,
+			outputMode: resolveOutputMode()
+		},
+		project: {
+			cwd: config.cwd,
+			root: config.root,
+			configFile: config.configFile,
+			name: config.packageJson?.name ?? null,
+			version: config.packageJson?.version ?? null,
+			entry: config.entry,
+			frameworkVersion: findInstalledVersion(config.root, "@wolfstar/http-framework")
+		},
+		build: config.build,
+		dev: config.dev,
+		codegen: config.codegen,
+		imports: config.imports,
+		experimental: config.experimental
+	};
+}
+function formatInfo(info, useColor) {
+	const colors = createColors({ useColor });
+	const { root } = info.project;
+	const show = (path) => path === null ? colors.dim("none") : displayPath(root, path);
+	const row = (label, value) => `  ${colors.dim(label.padEnd(12))}${value}`;
+	const section = (title, rows) => [colors.bold(title), ...rows].join("\n");
+	return [
+		section(`stars ${colors.green(`v${info.cli.version}`)}`, [
+			row("node", info.cli.node),
+			row("platform", info.cli.platform),
+			row("output", info.cli.outputMode),
+			row("framework", info.project.frameworkVersion ? `@wolfstar/http-framework v${info.project.frameworkVersion}` : colors.yellow("@wolfstar/http-framework not installed"))
+		]),
+		section("Project", [
+			row("name", info.project.name ? `${info.project.name}${info.project.version ? colors.dim(` v${info.project.version}`) : ""}` : colors.dim("unnamed")),
+			row("root", root),
+			row("config", info.project.configFile ? relative(root, info.project.configFile) || info.project.configFile : colors.dim("none (defaults)")),
+			row("entry", show(info.project.entry))
+		]),
+		section("Build", [
+			row("tool", info.build.tool),
+			row("outDir", show(info.build.outDir)),
+			row("tsconfig", show(info.build.tsconfig)),
+			row("runs", show(info.build.output))
+		]),
+		section("Dev", [
+			row("watch", info.dev.watch.map(show).join(", ")),
+			row("debounce", `${info.dev.debounce}ms`),
+			row("node args", info.dev.nodeArgs.join(" ") || colors.dim("none")),
+			row("args", info.dev.args.join(" ") || colors.dim("none")),
+			row("url", info.dev.url ?? colors.dim("unknown, set dev.url or HTTP_PORT")),
+			row("health", info.dev.health ?? colors.dim("none")),
+			row("typecheck", info.dev.typecheck.enabled ? `${info.dev.typecheck.checker} → ${show(info.dev.typecheck.tsconfig)}` : colors.dim("disabled")),
+			row("tunnel", describeTunnel(info.dev.tunnel, colors)),
+			row("log file", info.dev.logFile ? show(info.dev.logFile) : colors.dim("disabled"))
+		]),
+		section("Codegen", [row("i18n", info.codegen.i18n ? `${show(info.codegen.i18n.locales)} → ${show(info.codegen.i18n.output)}` : colors.dim("disabled"))]),
+		section("Experimental", [
+			row("vite", flag(info.experimental.enableVite, colors)),
+			row("nitro", flag(info.experimental.enableNitro, colors)),
+			row("external", flag(info.experimental.enableExternalVite, colors))
+		]),
+		section("Imports", [
+			row("auto", info.imports.enabled ? colors.green("enabled") : colors.dim("disabled")),
+			row("dirs", info.imports.dirs.map(show).join(", ")),
+			row("presets", info.imports.presets.join(", ") || colors.dim("none")),
+			row("dts", show(info.imports.dts))
+		])
+	].join("\n\n");
+}
+function flag(enabled, colors) {
+	return enabled ? colors.green("enabled") : colors.dim("disabled");
+}
+function describeTunnel(tunnel, colors) {
+	switch (tunnel.mode) {
+		case "quick": return "cloudflared quick tunnel";
+		case "url": return tunnel.url;
+		default: return colors.dim("disabled");
+	}
+}
+async function runInfo(options) {
+	const stdout = options.stdout ?? process.stdout;
+	const info = collectInfo(await loadStarsConfig({
+		cwd: resolveCwd(options),
+		configFile: options.config
+	}));
+	stdout.write(`${options.json ? JSON.stringify(info, null, 2) : formatInfo(info, shouldUseColor())}\n`);
+}
+
+//#endregion
+export { runInfo };
+//# sourceMappingURL=info-B-8rAIn6.js.map

package/dist/info-B-8rAIn6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-B-8rAIn6.js","names":[],"sources":["../src/lib/tasks/info.ts"],"sourcesContent":["import { createColors } from 'colorette';\nimport { arch, platform } from 'node:os';\nimport { relative } from 'node:path';\nimport type { ProjectArgs } from '../args.js';\nimport { resolveCwd } from '../args.js';\nimport { loadStarsConfig } from '@wolfstar/http-framework/config';\nimport { displayPath, type ResolvedStarsConfig } from '@wolfstar/http-framework/config';\nimport { resolveOutputMode, shouldUseColor } from '../output-mode.js';\nimport { findInstalledVersion } from '../project.js';\nimport { readOwnPackageJson } from '../version.js';\n\nexport interface InfoOptions extends ProjectArgs {\n\tjson?: boolean;\n\tstdout?: NodeJS.WritableStream;\n}\n\nexport interface ProjectInfo {\n\tcli: { version: string; node: string; platform: string; outputMode: 'tui' | 'plain' };\n\tproject: {\n\t\tcwd: string;\n\t\troot: string;\n\t\tconfigFile: string | null;\n\t\tname: string | null;\n\t\tversion: string | null;\n\t\tentry: string;\n\t\tframeworkVersion: string | null;\n\t};\n\tbuild: ResolvedStarsConfig['build'];\n\tdev: ResolvedStarsConfig['dev'];\n\tcodegen: ResolvedStarsConfig['codegen'];\n\timports: ResolvedStarsConfig['imports'];\n\texperimental: ResolvedStarsConfig['experimental'];\n}\n\nexport function collectInfo(config: ResolvedStarsConfig): ProjectInfo {\n\treturn {\n\t\tcli: {\n\t\t\tversion: readOwnPackageJson().version,\n\t\t\tnode: process.version,\n\t\t\tplatform: `${platform()} ${arch()}`,\n\t\t\toutputMode: resolveOutputMode()\n\t\t},\n\t\tproject: {\n\t\t\tcwd: config.cwd,\n\t\t\troot: config.root,\n\t\t\tconfigFile: config.configFile,\n\t\t\tname: config.packageJson?.name ?? null,\n\t\t\tversion: config.packageJson?.version ?? null,\n\t\t\tentry: config.entry,\n\t\t\tframeworkVersion: findInstalledVersion(config.root, '@wolfstar/http-framework')\n\t\t},\n\t\tbuild: config.build,\n\t\tdev: config.dev,\n\t\tcodegen: config.codegen,\n\t\timports: config.imports,\n\t\texperimental: config.experimental\n\t};\n}\n\nexport function formatInfo(info: ProjectInfo, useColor: boolean): string {\n\tconst colors = createColors({ useColor });\n\tconst { root } = info.project;\n\tconst show = (path: string | null) => (path === null ? colors.dim('none') : displayPath(root, path));\n\tconst row = (label: string, value: string) => `  ${colors.dim(label.padEnd(12))}${value}`;\n\tconst section = (title: string, rows: string[]) => [colors.bold(title), ...rows].join('\\n');\n\n\treturn [\n\t\tsection(`stars ${colors.green(`v${info.cli.version}`)}`, [\n\t\t\trow('node', info.cli.node),\n\t\t\trow('platform', info.cli.platform),\n\t\t\trow('output', info.cli.outputMode),\n\t\t\trow(\n\t\t\t\t'framework',\n\t\t\t\tinfo.project.frameworkVersion\n\t\t\t\t\t? `@wolfstar/http-framework v${info.project.frameworkVersion}`\n\t\t\t\t\t: colors.yellow('@wolfstar/http-framework not installed')\n\t\t\t)\n\t\t]),\n\t\tsection('Project', [\n\t\t\trow(\n\t\t\t\t'name',\n\t\t\t\tinfo.project.name\n\t\t\t\t\t? `${info.project.name}${info.project.version ? colors.dim(` v${info.project.version}`) : ''}`\n\t\t\t\t\t: colors.dim('unnamed')\n\t\t\t),\n\t\t\trow('root', root),\n\t\t\trow(\n\t\t\t\t'config',\n\t\t\t\tinfo.project.configFile ? relative(root, info.project.configFile) || info.project.configFile : colors.dim('none (defaults)')\n\t\t\t),\n\t\t\trow('entry', show(info.project.entry))\n\t\t]),\n\t\tsection('Build', [\n\t\t\trow('tool', info.build.tool),\n\t\t\trow('outDir', show(info.build.outDir)),\n\t\t\trow('tsconfig', show(info.build.tsconfig)),\n\t\t\trow('runs', show(info.build.output))\n\t\t]),\n\t\tsection('Dev', [\n\t\t\trow('watch', info.dev.watch.map(show).join(', ')),\n\t\t\trow('debounce', `${info.dev.debounce}ms`),\n\t\t\trow('node args', info.dev.nodeArgs.join(' ') || colors.dim('none')),\n\t\t\trow('args', info.dev.args.join(' ') || colors.dim('none')),\n\t\t\trow('url', info.dev.url ?? colors.dim('unknown, set dev.url or HTTP_PORT')),\n\t\t\trow('health', info.dev.health ?? colors.dim('none')),\n\t\t\trow(\n\t\t\t\t'typecheck',\n\t\t\t\tinfo.dev.typecheck.enabled ? `${info.dev.typecheck.checker} → ${show(info.dev.typecheck.tsconfig)}` : colors.dim('disabled')\n\t\t\t),\n\t\t\trow('tunnel', describeTunnel(info.dev.tunnel, colors)),\n\t\t\trow('log file', info.dev.logFile ? show(info.dev.logFile) : colors.dim('disabled'))\n\t\t]),\n\t\tsection('Codegen', [\n\t\t\trow('i18n', info.codegen.i18n ? `${show(info.codegen.i18n.locales)} → ${show(info.codegen.i18n.output)}` : colors.dim('disabled'))\n\t\t]),\n\t\tsection('Experimental', [\n\t\t\trow('vite', flag(info.experimental.enableVite, colors)),\n\t\t\trow('nitro', flag(info.experimental.enableNitro, colors)),\n\t\t\trow('external', flag(info.experimental.enableExternalVite, colors))\n\t\t]),\n\t\tsection('Imports', [\n\t\t\trow('auto', info.imports.enabled ? colors.green('enabled') : colors.dim('disabled')),\n\t\t\trow('dirs', info.imports.dirs.map(show).join(', ')),\n\t\t\trow('presets', info.imports.presets.join(', ') || colors.dim('none')),\n\t\t\trow('dts', show(info.imports.dts))\n\t\t])\n\t].join('\\n\\n');\n}\n\nfunction flag(enabled: boolean, colors: ReturnType<typeof createColors>): string {\n\treturn enabled ? colors.green('enabled') : colors.dim('disabled');\n}\n\nfunction describeTunnel(tunnel: ResolvedStarsConfig['dev']['tunnel'], colors: ReturnType<typeof createColors>): string {\n\tswitch (tunnel.mode) {\n\t\tcase 'quick':\n\t\t\treturn 'cloudflared quick tunnel';\n\t\tcase 'url':\n\t\t\treturn tunnel.url;\n\t\tdefault:\n\t\t\treturn colors.dim('disabled');\n\t}\n}\n\nexport async function runInfo(options: InfoOptions): Promise<void> {\n\tconst stdout = options.stdout ?? process.stdout;\n\tconst config = await loadStarsConfig({ cwd: resolveCwd(options), configFile: options.config });\n\tconst info = collectInfo(config);\n\tstdout.write(`${options.json ? JSON.stringify(info, null, 2) : formatInfo(info, shouldUseColor())}\\n`);\n}\n"],"mappings":"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"}

package/dist/info-DRTYYvVB.js

@@ -0,0 +1,30 @@
+import { t as projectArgs } from "./args-Ch1KXUMn.js";
+import { defineCommand } from "citty";
+
+//#region src/commands/info.ts
+var info_default = defineCommand({
+	meta: {
+		name: "info",
+		description: "Print the resolved project configuration and environment"
+	},
+	args: {
+		...projectArgs,
+		json: {
+			type: "boolean",
+			description: "Print machine-readable JSON",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const { runInfo } = await import("./info-B-8rAIn6.js");
+		await runInfo({
+			config: args.config,
+			cwd: args.cwd,
+			json: args.json
+		});
+	}
+});
+
+//#endregion
+export { info_default as default };
+//# sourceMappingURL=info-DRTYYvVB.js.map

package/dist/info-DRTYYvVB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-DRTYYvVB.js","names":[],"sources":["../src/commands/info.ts"],"sourcesContent":["import { defineCommand } from 'citty';\nimport { projectArgs } from '../lib/args.js';\n\nexport default defineCommand({\n\tmeta: {\n\t\tname: 'info',\n\t\tdescription: 'Print the resolved project configuration and environment'\n\t},\n\targs: {\n\t\t...projectArgs,\n\t\tjson: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Print machine-readable JSON',\n\t\t\tdefault: false\n\t\t}\n\t},\n\tasync run({ args }) {\n\t\tconst { runInfo } = await import('../lib/tasks/info.js');\n\t\tawait runInfo({ config: args.config, cwd: args.cwd, json: args.json });\n\t}\n});\n"],"mappings":";;;;AAGA,mBAAe,cAAc;CAC5B,MAAM;EACL,MAAM;EACN,aAAa;CACd;CACA,MAAM;EACL,GAAG;EACH,MAAM;GACL,MAAM;GACN,aAAa;GACb,SAAS;EACV;CACD;CACA,MAAM,IAAI,EAAE,QAAQ;EACnB,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,MAAM,QAAQ;GAAE,QAAQ,KAAK;GAAQ,KAAK,KAAK;GAAK,MAAM,KAAK;EAAK,CAAC;CACtE;AACD,CAAC"}

package/dist/none-DEo7zEr9.js

@@ -0,0 +1,50 @@
+import { EventEmitter } from "node:events";
+
+//#region src/lib/builders/none.ts
+/**
+* No build step: watches the configured paths and reports every change as an instant successful "build".
+*/
+var NoneBuilder = class extends EventEmitter {
+	config;
+	tool = "none";
+	#watcher = null;
+	constructor(config) {
+		super();
+		this.config = config;
+	}
+	build() {
+		this.emit("start");
+		const outcome = {
+			ok: true,
+			durationMs: 0,
+			message: null
+		};
+		this.emit("success", outcome);
+		return Promise.resolve(outcome);
+	}
+	async watch() {
+		const { watch } = await import("chokidar");
+		const watcher = watch([...this.config.dev.watch], {
+			ignored: [...this.config.dev.ignore],
+			ignoreInitial: true,
+			cwd: this.config.root
+		});
+		this.#watcher = watcher;
+		watcher.on("all", (event, path) => {
+			this.emit("log", "info", `${event}: ${path}`);
+			this.build();
+		});
+		watcher.on("error", (error) => this.emit("log", "error", error instanceof Error ? error.message : String(error)));
+		await new Promise((resolve) => watcher.once("ready", resolve));
+		await this.build();
+	}
+	async close() {
+		const watcher = this.#watcher;
+		this.#watcher = null;
+		await watcher?.close();
+	}
+};
+
+//#endregion
+export { NoneBuilder };
+//# sourceMappingURL=none-DEo7zEr9.js.map

package/dist/none-DEo7zEr9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"none-DEo7zEr9.js","names":["#watcher"],"sources":["../src/lib/builders/none.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { ResolvedStarsConfig } from '@wolfstar/http-framework/config';\nimport type { Builder, BuilderEvents, BuildOutcome } from './types.js';\n\n/**\n * No build step: watches the configured paths and reports every change as an instant successful \"build\".\n */\nexport class NoneBuilder extends EventEmitter<BuilderEvents> implements Builder {\n\tpublic readonly tool = 'none' as const;\n\t#watcher: { close(): Promise<void> } | null = null;\n\n\tpublic constructor(private readonly config: ResolvedStarsConfig) {\n\t\tsuper();\n\t}\n\n\tpublic build(): Promise<BuildOutcome> {\n\t\tthis.emit('start');\n\t\tconst outcome: BuildOutcome = { ok: true, durationMs: 0, message: null };\n\t\tthis.emit('success', outcome);\n\t\treturn Promise.resolve(outcome);\n\t}\n\n\tpublic async watch(): Promise<void> {\n\t\tconst { watch } = await import('chokidar');\n\t\tconst watcher = watch([...this.config.dev.watch], {\n\t\t\tignored: [...this.config.dev.ignore],\n\t\t\tignoreInitial: true,\n\t\t\tcwd: this.config.root\n\t\t});\n\t\tthis.#watcher = watcher;\n\n\t\twatcher.on('all', (event, path) => {\n\t\t\tthis.emit('log', 'info', `${event}: ${path}`);\n\t\t\tvoid this.build();\n\t\t});\n\t\twatcher.on('error', (error) => this.emit('log', 'error', error instanceof Error ? error.message : String(error)));\n\n\t\tawait new Promise<void>((resolve) => watcher.once('ready', resolve));\n\t\tawait this.build();\n\t}\n\n\tpublic async close(): Promise<void> {\n\t\tconst watcher = this.#watcher;\n\t\tthis.#watcher = null;\n\t\tawait watcher?.close();\n\t}\n}\n"],"mappings":";;;;;;AAOA,IAAa,cAAb,cAAiC,aAA+C;CAI3C;CAHpC,AAAgB,OAAO;CACvB,WAA8C;CAE9C,AAAO,YAAY,AAAiB,QAA6B;EAChE,MAAM;EAD6B;CAEpC;CAEA,AAAO,QAA+B;EACrC,KAAK,KAAK,OAAO;EACjB,MAAM,UAAwB;GAAE,IAAI;GAAM,YAAY;GAAG,SAAS;EAAK;EACvE,KAAK,KAAK,WAAW,OAAO;EAC5B,OAAO,QAAQ,QAAQ,OAAO;CAC/B;CAEA,MAAa,QAAuB;EACnC,MAAM,EAAE,UAAU,MAAM,OAAO;EAC/B,MAAM,UAAU,MAAM,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,GAAG;GACjD,SAAS,CAAC,GAAG,KAAK,OAAO,IAAI,MAAM;GACnC,eAAe;GACf,KAAK,KAAK,OAAO;EAClB,CAAC;EACD,KAAKA,WAAW;EAEhB,QAAQ,GAAG,QAAQ,OAAO,SAAS;GAClC,KAAK,KAAK,OAAO,QAAQ,GAAG,MAAM,IAAI,MAAM;GAC5C,AAAK,KAAK,MAAM;EACjB,CAAC;EACD,QAAQ,GAAG,UAAU,UAAU,KAAK,KAAK,OAAO,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,CAAC;EAEhH,MAAM,IAAI,SAAe,YAAY,QAAQ,KAAK,SAAS,OAAO,CAAC;EACnE,MAAM,KAAK,MAAM;CAClB;CAEA,MAAa,QAAuB;EACnC,MAAM,UAAU,KAAKA;EACrB,KAAKA,WAAW;EAChB,MAAM,SAAS,MAAM;CACtB;AACD"}

package/dist/output-mode-ChrOf0LO.js

@@ -0,0 +1,46 @@
+//#region src/lib/output-mode.ts
+const truthy = /* @__PURE__ */ new Set([
+	"1",
+	"true",
+	"yes",
+	"on"
+]);
+/**
+* Decides between the interactive TUI and plain line output.
+*
+* Precedence: `--no-tui` › `STARS_TUI=plain` › non-interactive stdout, CI or `TERM=dumb`.
+*/
+function resolveOutputMode(options = {}) {
+	const env = options.env ?? process.env;
+	const isTTY = options.isTTY ?? Boolean(process.stdout.isTTY);
+	const isCI = options.isCI ?? isCIEnvironment(env);
+	if (options.tui === false) return "plain";
+	const forced = env.STARS_TUI?.trim().toLowerCase();
+	if (forced === "plain" || forced === "0" || forced === "false" || forced === "off") return "plain";
+	if (forced === "tui" || forced && truthy.has(forced)) return isTTY ? "tui" : "plain";
+	if (options.tui === true) return isTTY ? "tui" : "plain";
+	if (!isTTY || isCI || env.TERM === "dumb") return "plain";
+	return "tui";
+}
+function isCIEnvironment(env = process.env) {
+	return Boolean(env.CI && !["false", "0"].includes(env.CI.toLowerCase())) || Boolean(env.GITHUB_ACTIONS || env.GITLAB_CI || env.BUILDKITE || env.CIRCLECI);
+}
+/**
+* Whether colours should be emitted, honouring `NO_COLOR` and `FORCE_COLOR`.
+*/
+function shouldUseColor(env = process.env, isTTY = Boolean(process.stdout.isTTY)) {
+	if (env.NO_COLOR !== void 0 && env.NO_COLOR !== "") return false;
+	if (env.FORCE_COLOR !== void 0) return env.FORCE_COLOR !== "0";
+	return isTTY && env.TERM !== "dumb";
+}
+/**
+* Whether animations (spinners, blinking status) should be avoided.
+*/
+function prefersReducedMotion(env = process.env) {
+	const value = env.STARS_REDUCED_MOTION ?? env.REDUCED_MOTION;
+	return value !== void 0 && value !== "" && value !== "0" && value.toLowerCase() !== "false";
+}
+
+//#endregion
+export { shouldUseColor as i, prefersReducedMotion as n, resolveOutputMode as r, isCIEnvironment as t };
+//# sourceMappingURL=output-mode-ChrOf0LO.js.map

package/dist/output-mode-ChrOf0LO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-mode-ChrOf0LO.js","names":[],"sources":["../src/lib/output-mode.ts"],"sourcesContent":["export type OutputMode = 'tui' | 'plain';\n\nexport interface ResolveOutputModeOptions {\n\t/** `--no-tui` (`tui: false`) or `--tui` (`tui: true`) from the command line. */\n\ttui?: boolean;\n\tenv?: NodeJS.ProcessEnv;\n\t/** Whether stdout is an interactive terminal. */\n\tisTTY?: boolean;\n\t/** Whether the process runs in a CI environment. */\n\tisCI?: boolean;\n}\n\nconst truthy = new Set(['1', 'true', 'yes', 'on']);\n\n/**\n * Decides between the interactive TUI and plain line output.\n *\n * Precedence: `--no-tui` › `STARS_TUI=plain` › non-interactive stdout, CI or `TERM=dumb`.\n */\nexport function resolveOutputMode(options: ResolveOutputModeOptions = {}): OutputMode {\n\tconst env = options.env ?? process.env;\n\tconst isTTY = options.isTTY ?? Boolean(process.stdout.isTTY);\n\tconst isCI = options.isCI ?? isCIEnvironment(env);\n\n\tif (options.tui === false) return 'plain';\n\n\tconst forced = env.STARS_TUI?.trim().toLowerCase();\n\tif (forced === 'plain' || forced === '0' || forced === 'false' || forced === 'off') return 'plain';\n\tif (forced === 'tui' || (forced && truthy.has(forced))) return isTTY ? 'tui' : 'plain';\n\n\tif (options.tui === true) return isTTY ? 'tui' : 'plain';\n\tif (!isTTY || isCI || env.TERM === 'dumb') return 'plain';\n\treturn 'tui';\n}\n\nexport function isCIEnvironment(env: NodeJS.ProcessEnv = process.env): boolean {\n\treturn (\n\t\tBoolean(env.CI && !['false', '0'].includes(env.CI.toLowerCase())) ||\n\t\tBoolean(env.GITHUB_ACTIONS || env.GITLAB_CI || env.BUILDKITE || env.CIRCLECI)\n\t);\n}\n\n/**\n * Whether colours should be emitted, honouring `NO_COLOR` and `FORCE_COLOR`.\n */\nexport function shouldUseColor(env: NodeJS.ProcessEnv = process.env, isTTY = Boolean(process.stdout.isTTY)): boolean {\n\tif (env.NO_COLOR !== undefined && env.NO_COLOR !== '') return false;\n\tif (env.FORCE_COLOR !== undefined) return env.FORCE_COLOR !== '0';\n\treturn isTTY && env.TERM !== 'dumb';\n}\n\n/**\n * Whether animations (spinners, blinking status) should be avoided.\n */\nexport function prefersReducedMotion(env: NodeJS.ProcessEnv = process.env): boolean {\n\tconst value = env.STARS_REDUCED_MOTION ?? env.REDUCED_MOTION;\n\treturn value !== undefined && value !== '' && value !== '0' && value.toLowerCase() !== 'false';\n}\n"],"mappings":";AAYA,MAAM,yBAAS,IAAI,IAAI;CAAC;CAAK;CAAQ;CAAO;AAAI,CAAC;;;;;;AAOjD,SAAgB,kBAAkB,UAAoC,CAAC,GAAe;CACrF,MAAM,MAAM,QAAQ,OAAO,QAAQ;CACnC,MAAM,QAAQ,QAAQ,SAAS,QAAQ,QAAQ,OAAO,KAAK;CAC3D,MAAM,OAAO,QAAQ,QAAQ,gBAAgB,GAAG;CAEhD,IAAI,QAAQ,QAAQ,OAAO,OAAO;CAElC,MAAM,SAAS,IAAI,WAAW,KAAK,CAAC,CAAC,YAAY;CACjD,IAAI,WAAW,WAAW,WAAW,OAAO,WAAW,WAAW,WAAW,OAAO,OAAO;CAC3F,IAAI,WAAW,SAAU,UAAU,OAAO,IAAI,MAAM,GAAI,OAAO,QAAQ,QAAQ;CAE/E,IAAI,QAAQ,QAAQ,MAAM,OAAO,QAAQ,QAAQ;CACjD,IAAI,CAAC,SAAS,QAAQ,IAAI,SAAS,QAAQ,OAAO;CAClD,OAAO;AACR;AAEA,SAAgB,gBAAgB,MAAyB,QAAQ,KAAc;CAC9E,OACC,QAAQ,IAAI,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,GAAG,YAAY,CAAC,CAAC,KAChE,QAAQ,IAAI,kBAAkB,IAAI,aAAa,IAAI,aAAa,IAAI,QAAQ;AAE9E;;;;AAKA,SAAgB,eAAe,MAAyB,QAAQ,KAAK,QAAQ,QAAQ,QAAQ,OAAO,KAAK,GAAY;CACpH,IAAI,IAAI,aAAa,UAAa,IAAI,aAAa,IAAI,OAAO;CAC9D,IAAI,IAAI,gBAAgB,QAAW,OAAO,IAAI,gBAAgB;CAC9D,OAAO,SAAS,IAAI,SAAS;AAC9B;;;;AAKA,SAAgB,qBAAqB,MAAyB,QAAQ,KAAc;CACnF,MAAM,QAAQ,IAAI,wBAAwB,IAAI;CAC9C,OAAO,UAAU,UAAa,UAAU,MAAM,UAAU,OAAO,MAAM,YAAY,MAAM;AACxF"}

package/dist/plain-CEe4X_Cz.js

@@ -0,0 +1,43 @@
+import { createColors } from "colorette";
+
+//#region src/renderers/plain.ts
+/**
+* Line-oriented renderer for non-interactive terminals, CI and redirected output.
+*/
+function createPlainRenderer(service, options = {}) {
+	const stdout = options.stdout ?? process.stdout;
+	const colors = createColors({ useColor: options.color ?? false });
+	const write = (text) => stdout.write(`${text}\n`);
+	const prefixes = {
+		stars: colors.cyan("stars"),
+		build: colors.magenta("build"),
+		tsc: colors.blue("tsc"),
+		tunnel: colors.yellow("tunnel"),
+		app: null
+	};
+	const onEntry = (entry) => {
+		const prefix = prefixes[entry.source];
+		if (!prefix) {
+			write(entry.text);
+			return;
+		}
+		const paint = entry.level === "error" ? colors.red : entry.level === "warn" ? colors.yellow : entry.level === "success" ? colors.green : (value) => value;
+		write(`${prefix} ${paint(entry.text)}`);
+	};
+	const onClear = () => write(`${prefixes.stars} logs cleared`);
+	return {
+		start() {
+			service.logs.on("entry", onEntry);
+			service.logs.on("clear", onClear);
+			return new Promise(() => {});
+		},
+		stop() {
+			service.logs.off("entry", onEntry);
+			service.logs.off("clear", onClear);
+		}
+	};
+}
+
+//#endregion
+export { createPlainRenderer };
+//# sourceMappingURL=plain-CEe4X_Cz.js.map

package/dist/plain-CEe4X_Cz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-CEe4X_Cz.js","names":[],"sources":["../src/renderers/plain.ts"],"sourcesContent":["import { createColors } from 'colorette';\nimport type { DevService } from '../lib/dev-service.js';\nimport type { LogEntry } from '../lib/log-buffer.js';\n\nexport interface PlainRendererOptions {\n\tstdout?: NodeJS.WritableStream;\n\tcolor?: boolean;\n\t/** Whether to attach process signal handlers. */\n\tsignals?: boolean;\n}\n\nexport interface Renderer {\n\t/** Starts rendering. Resolves when the user asks to quit (or never, in plain mode without signals). */\n\tstart(): Promise<void>;\n\t/** Stops rendering and restores the terminal. */\n\tstop(): void;\n}\n\n/**\n * Line-oriented renderer for non-interactive terminals, CI and redirected output.\n */\nexport function createPlainRenderer(service: DevService, options: PlainRendererOptions = {}): Renderer {\n\tconst stdout = options.stdout ?? process.stdout;\n\tconst colors = createColors({ useColor: options.color ?? false });\n\tconst write = (text: string) => stdout.write(`${text}\\n`);\n\n\tconst prefixes = {\n\t\tstars: colors.cyan('stars'),\n\t\tbuild: colors.magenta('build'),\n\t\ttsc: colors.blue('tsc'),\n\t\ttunnel: colors.yellow('tunnel'),\n\t\tapp: null\n\t} as const;\n\n\tconst onEntry = (entry: LogEntry) => {\n\t\tconst prefix = prefixes[entry.source];\n\t\tif (!prefix) {\n\t\t\twrite(entry.text);\n\t\t\treturn;\n\t\t}\n\n\t\tconst paint =\n\t\t\tentry.level === 'error'\n\t\t\t\t? colors.red\n\t\t\t\t: entry.level === 'warn'\n\t\t\t\t\t? colors.yellow\n\t\t\t\t\t: entry.level === 'success'\n\t\t\t\t\t\t? colors.green\n\t\t\t\t\t\t: (value: string) => value;\n\t\twrite(`${prefix} ${paint(entry.text)}`);\n\t};\n\n\tconst onClear = () => write(`${prefixes.stars} logs cleared`);\n\n\treturn {\n\t\tstart() {\n\t\t\tservice.logs.on('entry', onEntry);\n\t\t\tservice.logs.on('clear', onClear);\n\t\t\treturn new Promise<void>(() => {});\n\t\t},\n\t\tstop() {\n\t\t\tservice.logs.off('entry', onEntry);\n\t\t\tservice.logs.off('clear', onClear);\n\t\t}\n\t};\n}\n"],"mappings":";;;;;;AAqBA,SAAgB,oBAAoB,SAAqB,UAAgC,CAAC,GAAa;CACtG,MAAM,SAAS,QAAQ,UAAU,QAAQ;CACzC,MAAM,SAAS,aAAa,EAAE,UAAU,QAAQ,SAAS,MAAM,CAAC;CAChE,MAAM,SAAS,SAAiB,OAAO,MAAM,GAAG,KAAK,GAAG;CAExD,MAAM,WAAW;EAChB,OAAO,OAAO,KAAK,OAAO;EAC1B,OAAO,OAAO,QAAQ,OAAO;EAC7B,KAAK,OAAO,KAAK,KAAK;EACtB,QAAQ,OAAO,OAAO,QAAQ;EAC9B,KAAK;CACN;CAEA,MAAM,WAAW,UAAoB;EACpC,MAAM,SAAS,SAAS,MAAM;EAC9B,IAAI,CAAC,QAAQ;GACZ,MAAM,MAAM,IAAI;GAChB;EACD;EAEA,MAAM,QACL,MAAM,UAAU,UACb,OAAO,MACP,MAAM,UAAU,SACf,OAAO,SACP,MAAM,UAAU,YACf,OAAO,SACN,UAAkB;EACzB,MAAM,GAAG,OAAO,GAAG,MAAM,MAAM,IAAI,GAAG;CACvC;CAEA,MAAM,gBAAgB,MAAM,GAAG,SAAS,MAAM,cAAc;CAE5D,OAAO;EACN,QAAQ;GACP,QAAQ,KAAK,GAAG,SAAS,OAAO;GAChC,QAAQ,KAAK,GAAG,SAAS,OAAO;GAChC,OAAO,IAAI,cAAoB,CAAC,CAAC;EAClC;EACA,OAAO;GACN,QAAQ,KAAK,IAAI,SAAS,OAAO;GACjC,QAAQ,KAAK,IAAI,SAAS,OAAO;EAClC;CACD;AACD"}

package/dist/prepare-BXcm2Ukp.js

@@ -0,0 +1,3 @@
+import { n as runPrepare, t as prepareAutoImports } from "./prepare-D5NZ0w4t.js";
+
+export { runPrepare };

package/dist/prepare-CVf88_Or.js

@@ -0,0 +1,36 @@
+import { t as projectArgs } from "./args-Ch1KXUMn.js";
+import { defineCommand } from "citty";
+
+//#region src/commands/prepare.ts
+var prepare_default = defineCommand({
+	meta: {
+		name: "prepare",
+		description: "Generate the auto imports declaration file (imports.dts)"
+	},
+	args: {
+		...projectArgs,
+		check: {
+			type: "boolean",
+			description: "Fail when the generated file is out of date instead of writing it",
+			default: false
+		},
+		json: {
+			type: "boolean",
+			description: "Print machine-readable JSON",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const { runPrepare } = await import("./prepare-BXcm2Ukp.js");
+		await runPrepare({
+			config: args.config,
+			cwd: args.cwd,
+			check: args.check,
+			json: args.json
+		});
+	}
+});
+
+//#endregion
+export { prepare_default as default };
+//# sourceMappingURL=prepare-CVf88_Or.js.map

package/dist/prepare-CVf88_Or.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-CVf88_Or.js","names":[],"sources":["../src/commands/prepare.ts"],"sourcesContent":["import { defineCommand } from 'citty';\nimport { projectArgs } from '../lib/args.js';\n\nexport default defineCommand({\n\tmeta: {\n\t\tname: 'prepare',\n\t\tdescription: 'Generate the auto imports declaration file (imports.dts)'\n\t},\n\targs: {\n\t\t...projectArgs,\n\t\tcheck: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Fail when the generated file is out of date instead of writing it',\n\t\t\tdefault: false\n\t\t},\n\t\tjson: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Print machine-readable JSON',\n\t\t\tdefault: false\n\t\t}\n\t},\n\tasync run({ args }) {\n\t\tconst { runPrepare } = await import('../lib/tasks/prepare.js');\n\t\tawait runPrepare({ config: args.config, cwd: args.cwd, check: args.check, json: args.json });\n\t}\n});\n"],"mappings":";;;;AAGA,sBAAe,cAAc;CAC5B,MAAM;EACL,MAAM;EACN,aAAa;CACd;CACA,MAAM;EACL,GAAG;EACH,OAAO;GACN,MAAM;GACN,aAAa;GACb,SAAS;EACV;EACA,MAAM;GACL,MAAM;GACN,aAAa;GACb,SAAS;EACV;CACD;CACA,MAAM,IAAI,EAAE,QAAQ;EACnB,MAAM,EAAE,eAAe,MAAM,OAAO;EACpC,MAAM,WAAW;GAAE,QAAQ,KAAK;GAAQ,KAAK,KAAK;GAAK,OAAO,KAAK;GAAO,MAAM,KAAK;EAAK,CAAC;CAC5F;AACD,CAAC"}