@wolfstar/cli 0.1.0-next-20260904111115

package/dist/prepare-D5NZ0w4t.js

@@ -0,0 +1,68 @@
+import { n as ExitCode, t as CliError } from "./errors-Bket6XFn.js";
+import { i as shouldUseColor } from "./output-mode-ChrOf0LO.js";
+import { n as resolveCwd } from "./args-Ch1KXUMn.js";
+import { displayPath, loadStarsConfig } from "@wolfstar/http-framework/config";
+import { dirname } from "node:path";
+import { createColors } from "colorette";
+import { generateAutoImportsDts } from "@wolfstar/http-framework/auto-imports";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+
+//#region src/lib/tasks/prepare.ts
+/**
+* Generates `imports.dts` (see {@link StarsImportsConfig} in `@wolfstar/http-framework/config`), the way `nuxt
+* prepare` regenerates `.nuxt/imports.d.ts`. Run automatically by `stars dev` and `stars build` before the first
+* build; `--check` fails instead of writing, for CI.
+*/
+async function runPrepare(options) {
+	const stdout = options.stdout ?? process.stdout;
+	const colors = createColors({ useColor: shouldUseColor() && !options.json });
+	const config = await loadStarsConfig({
+		cwd: resolveCwd(options),
+		configFile: options.config
+	});
+	const result = await prepareAutoImports(config, Boolean(options.check));
+	if (options.json) stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+	else if (!result.enabled) stdout.write(`${colors.dim("stars")} nothing to prepare (auto imports are disabled)\n`);
+	else {
+		const paint = result.status === "outdated" ? colors.red : colors.green;
+		stdout.write(`${colors.dim("stars")} imports: ${paint(result.status)} ${displayPath(config.root, result.dts)}\n`);
+	}
+	if (result.status === "outdated") throw new CliError("The auto imports declaration file is out of date, run `stars prepare` to update it.", {
+		code: "PREPARE_OUTDATED",
+		exitCode: ExitCode.Error
+	});
+}
+/**
+* Regenerates `imports.dts` unconditionally, used by `stars dev`/`stars build` before the first build so the
+* declaration file exists (and is current) even when the user never ran `stars prepare` themselves.
+*/
+async function prepareAutoImports(config, check = false) {
+	if (!config.imports.enabled) return {
+		enabled: false,
+		dts: null,
+		status: null
+	};
+	const { dirs, presets, exclude, dts } = config.imports;
+	const content = await generateAutoImportsDts({
+		root: config.root,
+		dirs,
+		presets,
+		exclude
+	});
+	if (check) return {
+		enabled: true,
+		dts,
+		status: await readFile(dts, "utf-8").catch(() => null) === content ? "up-to-date" : "outdated"
+	};
+	await mkdir(dirname(dts), { recursive: true });
+	await writeFile(dts, content);
+	return {
+		enabled: true,
+		dts,
+		status: "written"
+	};
+}
+
+//#endregion
+export { runPrepare as n, prepareAutoImports as t };
+//# sourceMappingURL=prepare-D5NZ0w4t.js.map

package/dist/prepare-D5NZ0w4t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-D5NZ0w4t.js","names":[],"sources":["../src/lib/tasks/prepare.ts"],"sourcesContent":["import { generateAutoImportsDts } from '@wolfstar/http-framework/auto-imports';\nimport { displayPath, loadStarsConfig, type ResolvedStarsConfig } from '@wolfstar/http-framework/config';\nimport { createColors } from 'colorette';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport type { ProjectArgs } from '../args.js';\nimport { resolveCwd } from '../args.js';\nimport { CliError, ExitCode } from '../errors.js';\nimport { shouldUseColor } from '../output-mode.js';\n\nexport interface PrepareTaskOptions extends ProjectArgs {\n\tcheck?: boolean;\n\tjson?: boolean;\n\tstdout?: NodeJS.WritableStream;\n}\n\nexport type PrepareResult =\n\t| { enabled: false; dts: null; status: null }\n\t| { enabled: true; dts: string; status: 'written' | 'up-to-date' | 'outdated' };\n\n/**\n * Generates `imports.dts` (see {@link StarsImportsConfig} in `@wolfstar/http-framework/config`), the way `nuxt\n * prepare` regenerates `.nuxt/imports.d.ts`. Run automatically by `stars dev` and `stars build` before the first\n * build; `--check` fails instead of writing, for CI.\n */\nexport async function runPrepare(options: PrepareTaskOptions): Promise<void> {\n\tconst stdout = options.stdout ?? process.stdout;\n\tconst colors = createColors({ useColor: shouldUseColor() && !options.json });\n\tconst config = await loadStarsConfig({ cwd: resolveCwd(options), configFile: options.config });\n\tconst result = await prepareAutoImports(config, Boolean(options.check));\n\n\tif (options.json) {\n\t\tstdout.write(`${JSON.stringify(result, null, 2)}\\n`);\n\t} else if (!result.enabled) {\n\t\tstdout.write(`${colors.dim('stars')} nothing to prepare (auto imports are disabled)\\n`);\n\t} else {\n\t\tconst paint = result.status === 'outdated' ? colors.red : colors.green;\n\t\tstdout.write(`${colors.dim('stars')} imports: ${paint(result.status)} ${displayPath(config.root, result.dts)}\\n`);\n\t}\n\n\tif (result.status === 'outdated') {\n\t\tthrow new CliError('The auto imports declaration file is out of date, run `stars prepare` to update it.', {\n\t\t\tcode: 'PREPARE_OUTDATED',\n\t\t\texitCode: ExitCode.Error\n\t\t});\n\t}\n}\n\n/**\n * Regenerates `imports.dts` unconditionally, used by `stars dev`/`stars build` before the first build so the\n * declaration file exists (and is current) even when the user never ran `stars prepare` themselves.\n */\nexport async function prepareAutoImports(config: ResolvedStarsConfig, check = false): Promise<PrepareResult> {\n\tif (!config.imports.enabled) return { enabled: false, dts: null, status: null };\n\n\tconst { dirs, presets, exclude, dts } = config.imports;\n\tconst content = await generateAutoImportsDts({ root: config.root, dirs, presets, exclude });\n\n\tif (check) {\n\t\tconst existing = await readFile(dts, 'utf-8').catch(() => null);\n\t\treturn { enabled: true, dts, status: existing === content ? 'up-to-date' : 'outdated' };\n\t}\n\n\tawait mkdir(dirname(dts), { recursive: true });\n\tawait writeFile(dts, content);\n\treturn { enabled: true, dts, status: 'written' };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyBA,eAAsB,WAAW,SAA4C;CAC5E,MAAM,SAAS,QAAQ,UAAU,QAAQ;CACzC,MAAM,SAAS,aAAa,EAAE,UAAU,eAAe,KAAK,CAAC,QAAQ,KAAK,CAAC;CAC3E,MAAM,SAAS,MAAM,gBAAgB;EAAE,KAAK,WAAW,OAAO;EAAG,YAAY,QAAQ;CAAO,CAAC;CAC7F,MAAM,SAAS,MAAM,mBAAmB,QAAQ,QAAQ,QAAQ,KAAK,CAAC;CAEtE,IAAI,QAAQ,MACX,OAAO,MAAM,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,GAAG;MAC7C,IAAI,CAAC,OAAO,SAClB,OAAO,MAAM,GAAG,OAAO,IAAI,OAAO,EAAE,kDAAkD;MAChF;EACN,MAAM,QAAQ,OAAO,WAAW,aAAa,OAAO,MAAM,OAAO;EACjE,OAAO,MAAM,GAAG,OAAO,IAAI,OAAO,EAAE,YAAY,MAAM,OAAO,MAAM,EAAE,GAAG,YAAY,OAAO,MAAM,OAAO,GAAG,EAAE,GAAG;CACjH;CAEA,IAAI,OAAO,WAAW,YACrB,MAAM,IAAI,SAAS,uFAAuF;EACzG,MAAM;EACN,UAAU,SAAS;CACpB,CAAC;AAEH;;;;;AAMA,eAAsB,mBAAmB,QAA6B,QAAQ,OAA+B;CAC5G,IAAI,CAAC,OAAO,QAAQ,SAAS,OAAO;EAAE,SAAS;EAAO,KAAK;EAAM,QAAQ;CAAK;CAE9E,MAAM,EAAE,MAAM,SAAS,SAAS,QAAQ,OAAO;CAC/C,MAAM,UAAU,MAAM,uBAAuB;EAAE,MAAM,OAAO;EAAM;EAAM;EAAS;CAAQ,CAAC;CAE1F,IAAI,OAEH,OAAO;EAAE,SAAS;EAAM;EAAK,QAAQ,MADd,SAAS,KAAK,OAAO,CAAC,CAAC,YAAY,IAAI,MACZ,UAAU,eAAe;CAAW;CAGvF,MAAM,MAAM,QAAQ,GAAG,GAAG,EAAE,WAAW,KAAK,CAAC;CAC7C,MAAM,UAAU,KAAK,OAAO;CAC5B,OAAO;EAAE,SAAS;EAAM;EAAK,QAAQ;CAAU;AAChD"}

package/dist/process-supervisor-CJOdmp0W.js

@@ -0,0 +1,128 @@
+import { EventEmitter } from "node:events";
+import { spawn } from "node:child_process";
+
+//#region src/lib/process-supervisor.ts
+/**
+* Owns a single child process: starts it, streams its output line by line and stops it gracefully.
+*/
+var ProcessSupervisor = class extends EventEmitter {
+	options;
+	#child = null;
+	#state = "idle";
+	#startedAt = null;
+	#stopping = null;
+	constructor(options) {
+		super();
+		this.options = options;
+	}
+	get state() {
+		return this.#state;
+	}
+	get pid() {
+		return this.#child?.pid ?? null;
+	}
+	get startedAt() {
+		return this.#startedAt;
+	}
+	get running() {
+		return this.#state === "starting" || this.#state === "running";
+	}
+	start() {
+		if (this.#child) throw new Error("The process is already running, call stop() or restart() first.");
+		const { command, args, cwd, env } = this.options;
+		this.#setState("starting");
+		const child = spawn(command, args, {
+			cwd,
+			env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			windowsHide: true
+		});
+		this.#child = child;
+		this.#startedAt = Date.now();
+		let requested = false;
+		const stdout = createLineSplitter((line) => this.emit("stdout", line));
+		const stderr = createLineSplitter((line) => this.emit("stderr", line));
+		child.stdout?.on("data", stdout.push);
+		child.stderr?.on("data", stderr.push);
+		child.once("spawn", () => {
+			if (this.#child === child) this.#setState("running");
+		});
+		child.once("error", (error) => {
+			this.emit("error", error);
+		});
+		child.once("exit", (code, signal) => {
+			stdout.flush();
+			stderr.flush();
+			requested = this.#state === "stopping";
+			this.#child = null;
+			this.#startedAt = null;
+			this.#setState(requested || code === 0 ? "stopped" : "crashed");
+			this.emit("exit", {
+				code,
+				signal,
+				requested
+			});
+		});
+	}
+	/**
+	* Sends `SIGTERM`, escalates to `SIGKILL` after `killTimeout` and resolves once the process exited.
+	*/
+	stop() {
+		const child = this.#child;
+		if (!child) return Promise.resolve();
+		if (this.#stopping) return this.#stopping;
+		this.#setState("stopping");
+		this.#stopping = new Promise((resolve) => {
+			const timer = setTimeout(() => {
+				if (child.exitCode === null && child.signalCode === null) child.kill("SIGKILL");
+			}, this.options.killTimeout);
+			timer.unref();
+			child.once("exit", () => {
+				clearTimeout(timer);
+				this.#stopping = null;
+				resolve();
+			});
+			if (!child.kill("SIGTERM")) {
+				clearTimeout(timer);
+				this.#stopping = null;
+				resolve();
+			}
+		});
+		return this.#stopping;
+	}
+	async restart() {
+		await this.stop();
+		this.start();
+	}
+	#setState(state) {
+		if (this.#state === state) return;
+		this.#state = state;
+		this.emit("state", state);
+	}
+};
+/**
+* Splits a byte stream into complete lines, keeping the trailing partial line until the next chunk.
+*/
+function createLineSplitter(onLine) {
+	let remainder = "";
+	return {
+		push(chunk) {
+			remainder += chunk.toString();
+			const lines = remainder.split(/\r?\n/);
+			remainder = lines.pop() ?? "";
+			for (const line of lines) onLine(line);
+		},
+		flush() {
+			if (remainder.length > 0) onLine(remainder);
+			remainder = "";
+		}
+	};
+}
+
+//#endregion
+export { createLineSplitter as n, ProcessSupervisor as t };
+//# sourceMappingURL=process-supervisor-CJOdmp0W.js.map

package/dist/process-supervisor-CJOdmp0W.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-supervisor-CJOdmp0W.js","names":["#state","#child","#startedAt","#setState","#stopping"],"sources":["../src/lib/process-supervisor.ts"],"sourcesContent":["import { spawn, type ChildProcess } from 'node:child_process';\nimport { EventEmitter } from 'node:events';\n\nexport type ProcessState = 'idle' | 'starting' | 'running' | 'stopping' | 'stopped' | 'crashed';\n\nexport interface ProcessExit {\n\tcode: number | null;\n\tsignal: NodeJS.Signals | null;\n\t/** Whether the exit was requested through {@link ProcessSupervisor.stop}. */\n\trequested: boolean;\n}\n\nexport interface ProcessSupervisorOptions {\n\tcommand: string;\n\targs: readonly string[];\n\tcwd: string;\n\tenv: NodeJS.ProcessEnv;\n\t/** Milliseconds to wait after `SIGTERM` before sending `SIGKILL`. */\n\tkillTimeout: number;\n}\n\nexport interface ProcessSupervisorEvents {\n\tstate: [state: ProcessState];\n\tstdout: [line: string];\n\tstderr: [line: string];\n\texit: [exit: ProcessExit];\n\terror: [error: Error];\n}\n\n/**\n * Owns a single child process: starts it, streams its output line by line and stops it gracefully.\n */\nexport class ProcessSupervisor extends EventEmitter<ProcessSupervisorEvents> {\n\t#child: ChildProcess | null = null;\n\t#state: ProcessState = 'idle';\n\t#startedAt: number | null = null;\n\t#stopping: Promise<void> | null = null;\n\n\tpublic constructor(private readonly options: ProcessSupervisorOptions) {\n\t\tsuper();\n\t}\n\n\tpublic get state(): ProcessState {\n\t\treturn this.#state;\n\t}\n\n\tpublic get pid(): number | null {\n\t\treturn this.#child?.pid ?? null;\n\t}\n\n\tpublic get startedAt(): number | null {\n\t\treturn this.#startedAt;\n\t}\n\n\tpublic get running(): boolean {\n\t\treturn this.#state === 'starting' || this.#state === 'running';\n\t}\n\n\tpublic start(): void {\n\t\tif (this.#child) throw new Error('The process is already running, call stop() or restart() first.');\n\n\t\tconst { command, args, cwd, env } = this.options;\n\t\tthis.#setState('starting');\n\n\t\tconst child = spawn(command, args, { cwd, env, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });\n\t\tthis.#child = child;\n\t\tthis.#startedAt = Date.now();\n\n\t\tlet requested = false;\n\t\tconst stdout = createLineSplitter((line) => this.emit('stdout', line));\n\t\tconst stderr = createLineSplitter((line) => this.emit('stderr', line));\n\t\tchild.stdout?.on('data', stdout.push);\n\t\tchild.stderr?.on('data', stderr.push);\n\n\t\tchild.once('spawn', () => {\n\t\t\tif (this.#child === child) this.#setState('running');\n\t\t});\n\n\t\tchild.once('error', (error) => {\n\t\t\tthis.emit('error', error);\n\t\t});\n\n\t\tchild.once('exit', (code, signal) => {\n\t\t\tstdout.flush();\n\t\t\tstderr.flush();\n\t\t\trequested = this.#state === 'stopping';\n\t\t\tthis.#child = null;\n\t\t\tthis.#startedAt = null;\n\t\t\tthis.#setState(requested || code === 0 ? 'stopped' : 'crashed');\n\t\t\tthis.emit('exit', { code, signal, requested });\n\t\t});\n\t}\n\n\t/**\n\t * Sends `SIGTERM`, escalates to `SIGKILL` after `killTimeout` and resolves once the process exited.\n\t */\n\tpublic stop(): Promise<void> {\n\t\tconst child = this.#child;\n\t\tif (!child) return Promise.resolve();\n\t\tif (this.#stopping) return this.#stopping;\n\n\t\tthis.#setState('stopping');\n\t\tthis.#stopping = new Promise<void>((resolve) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tif (child.exitCode === null && child.signalCode === null) child.kill('SIGKILL');\n\t\t\t}, this.options.killTimeout);\n\t\t\ttimer.unref();\n\n\t\t\tchild.once('exit', () => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tthis.#stopping = null;\n\t\t\t\tresolve();\n\t\t\t});\n\n\t\t\tif (!child.kill('SIGTERM')) {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tthis.#stopping = null;\n\t\t\t\tresolve();\n\t\t\t}\n\t\t});\n\n\t\treturn this.#stopping;\n\t}\n\n\tpublic async restart(): Promise<void> {\n\t\tawait this.stop();\n\t\tthis.start();\n\t}\n\n\t#setState(state: ProcessState): void {\n\t\tif (this.#state === state) return;\n\t\tthis.#state = state;\n\t\tthis.emit('state', state);\n\t}\n}\n\n/**\n * Splits a byte stream into complete lines, keeping the trailing partial line until the next chunk.\n */\nexport function createLineSplitter(onLine: (line: string) => void) {\n\tlet remainder = '';\n\treturn {\n\t\tpush(chunk: Buffer | string) {\n\t\t\tremainder += chunk.toString();\n\t\t\tconst lines = remainder.split(/\\r?\\n/);\n\t\t\tremainder = lines.pop() ?? '';\n\t\t\tfor (const line of lines) onLine(line);\n\t\t},\n\t\tflush() {\n\t\t\tif (remainder.length > 0) onLine(remainder);\n\t\t\tremainder = '';\n\t\t}\n\t};\n}\n"],"mappings":"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"}

package/dist/project-DHF3qdm-.js

@@ -0,0 +1,66 @@
+import { t as CliError } from "./errors-Bket6XFn.js";
+import { createRequire } from "node:module";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+//#region src/lib/project.ts
+/**
+* Resolves a module id from the project root, the way the project itself would.
+*/
+function resolveFromProject(root, id) {
+	try {
+		return createRequire(join(root, "package.json")).resolve(id);
+	} catch {
+		return null;
+	}
+}
+/**
+* Imports a module from the project root, failing with an actionable error when it is not installed.
+*/
+async function importFromProject(root, id, hint) {
+	const resolved = resolveFromProject(root, id);
+	if (!resolved) throw new CliError(`"${id}" is not installed in ${root}`, {
+		code: "DEPENDENCY_MISSING",
+		hint
+	});
+	return await import(pathToFileURL(resolved).href);
+}
+/**
+* Resolves an executable a package declares in its `package.json#bin`, from the project's own `node_modules`.
+*
+* Going through `bin` rather than a hardcoded path is what makes this work across layouts: TypeScript 7 hides
+* `lib/tsc.js` behind its `exports` map, and packages move their entry points between releases.
+*/
+function resolveBinary(root, packageName, binName) {
+	const packageJsonPath = resolveFromProject(root, `${packageName}/package.json`);
+	if (!packageJsonPath) return null;
+	try {
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+		const bin = typeof packageJson.bin === "string" ? packageJson.bin : packageJson.bin?.[binName];
+		return bin ? join(dirname(packageJsonPath), bin) : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Finds the version of an installed package by walking `node_modules` up from `root`.
+*/
+function findInstalledVersion(root, name) {
+	let directory = root;
+	for (;;) {
+		const file = join(directory, "node_modules", name, "package.json");
+		if (existsSync(file)) try {
+			return JSON.parse(readFileSync(file, "utf-8")).version ?? null;
+		} catch {
+			return null;
+		}
+		const parent = dirname(directory);
+		if (parent === directory) return null;
+		directory = parent;
+	}
+}
+
+//#endregion
+export { resolveFromProject as i, importFromProject as n, resolveBinary as r, findInstalledVersion as t };
+//# sourceMappingURL=project-DHF3qdm-.js.map

package/dist/project-DHF3qdm-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-DHF3qdm-.js","names":[],"sources":["../src/lib/project.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { CliError } from './errors.js';\n\n/**\n * Resolves a module id from the project root, the way the project itself would.\n */\nexport function resolveFromProject(root: string, id: string): string | null {\n\ttry {\n\t\treturn createRequire(join(root, 'package.json')).resolve(id);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Imports a module from the project root, failing with an actionable error when it is not installed.\n */\nexport async function importFromProject<T>(root: string, id: string, hint: string): Promise<T> {\n\tconst resolved = resolveFromProject(root, id);\n\tif (!resolved) {\n\t\tthrow new CliError(`\"${id}\" is not installed in ${root}`, { code: 'DEPENDENCY_MISSING', hint });\n\t}\n\n\treturn (await import(pathToFileURL(resolved).href)) as T;\n}\n\n/**\n * Resolves an executable a package declares in its `package.json#bin`, from the project's own `node_modules`.\n *\n * Going through `bin` rather than a hardcoded path is what makes this work across layouts: TypeScript 7 hides\n * `lib/tsc.js` behind its `exports` map, and packages move their entry points between releases.\n */\nexport function resolveBinary(root: string, packageName: string, binName: string): string | null {\n\tconst packageJsonPath = resolveFromProject(root, `${packageName}/package.json`);\n\tif (!packageJsonPath) return null;\n\n\ttry {\n\t\tconst packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as { bin?: string | Record<string, string> };\n\t\tconst bin = typeof packageJson.bin === 'string' ? packageJson.bin : packageJson.bin?.[binName];\n\t\treturn bin ? join(dirname(packageJsonPath), bin) : null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Finds the version of an installed package by walking `node_modules` up from `root`.\n */\nexport function findInstalledVersion(root: string, name: string): string | null {\n\tlet directory = root;\n\tfor (;;) {\n\t\tconst file = join(directory, 'node_modules', name, 'package.json');\n\t\tif (existsSync(file)) {\n\t\t\ttry {\n\t\t\t\tconst parsed = JSON.parse(readFileSync(file, 'utf-8')) as { version?: string };\n\t\t\t\treturn parsed.version ?? null;\n\t\t\t} catch {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t}\n\n\t\tconst parent = dirname(directory);\n\t\tif (parent === directory) return null;\n\t\tdirectory = parent;\n\t}\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,IAA2B;CAC3E,IAAI;EACH,OAAO,cAAc,KAAK,MAAM,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,QAAQ;EACP,OAAO;CACR;AACD;;;;AAKA,eAAsB,kBAAqB,MAAc,IAAY,MAA0B;CAC9F,MAAM,WAAW,mBAAmB,MAAM,EAAE;CAC5C,IAAI,CAAC,UACJ,MAAM,IAAI,SAAS,IAAI,GAAG,wBAAwB,QAAQ;EAAE,MAAM;EAAsB;CAAK,CAAC;CAG/F,OAAQ,MAAM,OAAO,cAAc,QAAQ,CAAC,CAAC;AAC9C;;;;;;;AAQA,SAAgB,cAAc,MAAc,aAAqB,SAAgC;CAChG,MAAM,kBAAkB,mBAAmB,MAAM,GAAG,YAAY,cAAc;CAC9E,IAAI,CAAC,iBAAiB,OAAO;CAE7B,IAAI;EACH,MAAM,cAAc,KAAK,MAAM,aAAa,iBAAiB,OAAO,CAAC;EACrE,MAAM,MAAM,OAAO,YAAY,QAAQ,WAAW,YAAY,MAAM,YAAY,MAAM;EACtF,OAAO,MAAM,KAAK,QAAQ,eAAe,GAAG,GAAG,IAAI;CACpD,QAAQ;EACP,OAAO;CACR;AACD;;;;AAKA,SAAgB,qBAAqB,MAAc,MAA6B;CAC/E,IAAI,YAAY;CAChB,SAAS;EACR,MAAM,OAAO,KAAK,WAAW,gBAAgB,MAAM,cAAc;EACjE,IAAI,WAAW,IAAI,GAClB,IAAI;GAEH,OADe,KAAK,MAAM,aAAa,MAAM,OAAO,CACxC,CAAC,CAAC,WAAW;EAC1B,QAAQ;GACP,OAAO;EACR;EAGD,MAAM,SAAS,QAAQ,SAAS;EAChC,IAAI,WAAW,WAAW,OAAO;EACjC,YAAY;CACb;AACD"}

package/dist/tsc-BqZfDTD0.js

@@ -0,0 +1,133 @@
+import { t as CliError } from "./errors-Bket6XFn.js";
+import { n as createLineSplitter } from "./process-supervisor-CJOdmp0W.js";
+import { r as resolveBinary } from "./project-DHF3qdm-.js";
+import { EventEmitter } from "node:events";
+import { spawn } from "node:child_process";
+
+//#region src/lib/builders/tsc.ts
+const INSTALL_HINT = "Install it with `pnpm add -D typescript`, or set `build.tool` to 'tsdown' or 'none'.";
+const WATCH_START = /Starting (incremental )?compilation/;
+const WATCH_DONE = /Found (\d+) errors?\. Watching for file changes/;
+const ERROR_LINE = /error TS\d+:/;
+/**
+* Builds through the project's `tsc -b`, parsing its output to report progress.
+*/
+var TscBuilder = class extends EventEmitter {
+	config;
+	tool = "tsc";
+	#child = null;
+	#startedAt = 0;
+	#firstError = null;
+	constructor(config) {
+		super();
+		this.config = config;
+	}
+	build() {
+		const child = this.#spawn([]);
+		this.#begin();
+		return new Promise((resolve) => {
+			child.once("exit", (code) => {
+				this.#child = null;
+				resolve(this.#finish(code === 0 ? null : this.#firstError ?? `tsc exited with code ${code}`));
+			});
+		});
+	}
+	watch() {
+		this.#spawn(["--watch", "--preserveWatchOutput"]);
+		this.#begin();
+		return Promise.resolve();
+	}
+	close() {
+		const child = this.#child;
+		this.#child = null;
+		if (!child || child.exitCode !== null) return Promise.resolve();
+		return new Promise((resolve) => {
+			child.once("exit", () => resolve());
+			child.kill();
+		});
+	}
+	#spawn(extraArgs) {
+		const tsc = resolveTscBinary(this.config.root);
+		if (!tsc) throw new CliError(`"typescript" is not installed in ${this.config.root}`, {
+			code: "DEPENDENCY_MISSING",
+			hint: INSTALL_HINT
+		});
+		const child = spawn(process.execPath, [
+			tsc,
+			"-b",
+			this.config.build.tsconfig,
+			"--pretty",
+			"false",
+			...extraArgs
+		], {
+			cwd: this.config.root,
+			env: process.env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			windowsHide: true
+		});
+		this.#child = child;
+		const handleLine = (line) => this.#handleLine(line);
+		const stdout = createLineSplitter(handleLine);
+		const stderr = createLineSplitter(handleLine);
+		child.stdout?.on("data", stdout.push);
+		child.stderr?.on("data", stderr.push);
+		child.once("exit", () => {
+			stdout.flush();
+			stderr.flush();
+		});
+		child.once("error", (error) => this.emit("log", "error", error.message));
+		return child;
+	}
+	#handleLine(line) {
+		const text = line.trim();
+		if (text.length === 0) return;
+		if (WATCH_START.test(text)) {
+			if (this.#startedAt === 0) this.#begin();
+			return;
+		}
+		if (ERROR_LINE.test(text)) {
+			this.#firstError ??= text;
+			this.emit("log", "error", text);
+			return;
+		}
+		const done = WATCH_DONE.exec(text);
+		if (done) {
+			const errors = Number(done[1]);
+			this.emit("log", errors === 0 ? "success" : "error", text);
+			this.#finish(errors === 0 ? null : this.#firstError ?? text);
+			return;
+		}
+		this.emit("log", "info", text);
+	}
+	#begin() {
+		this.#firstError = null;
+		this.#startedAt = performance.now();
+		this.emit("start");
+	}
+	#finish(message) {
+		const outcome = {
+			ok: message === null,
+			durationMs: Math.round(performance.now() - this.#startedAt),
+			message
+		};
+		this.#startedAt = 0;
+		this.emit(outcome.ok ? "success" : "failure", outcome);
+		return outcome;
+	}
+};
+/**
+* Locates the `tsc` script of the project's TypeScript through its `package.json#bin`, which works for both the
+* classic `lib/tsc.js` layout (TypeScript ≤ 6) and the native `bin/tsc` launcher (TypeScript 7, whose `exports` map
+* hides `lib/`).
+*/
+function resolveTscBinary(root) {
+	return resolveBinary(root, "typescript", "tsc");
+}
+
+//#endregion
+export { resolveTscBinary as n, TscBuilder as t };
+//# sourceMappingURL=tsc-BqZfDTD0.js.map

package/dist/tsc-BqZfDTD0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsc-BqZfDTD0.js","names":["#spawn","#begin","#child","#finish","#firstError","#handleLine","#startedAt"],"sources":["../src/lib/builders/tsc.ts"],"sourcesContent":["import { spawn, type ChildProcess } from 'node:child_process';\nimport { EventEmitter } from 'node:events';\nimport type { ResolvedStarsConfig } from '@wolfstar/http-framework/config';\nimport { CliError } from '../errors.js';\nimport { createLineSplitter } from '../process-supervisor.js';\nimport { resolveBinary } from '../project.js';\nimport type { Builder, BuilderEvents, BuildOutcome } from './types.js';\n\nconst INSTALL_HINT = \"Install it with `pnpm add -D typescript`, or set `build.tool` to 'tsdown' or 'none'.\";\nconst WATCH_START = /Starting (incremental )?compilation/;\nconst WATCH_DONE = /Found (\\d+) errors?\\. Watching for file changes/;\nconst ERROR_LINE = /error TS\\d+:/;\n\n/**\n * Builds through the project's `tsc -b`, parsing its output to report progress.\n */\nexport class TscBuilder extends EventEmitter<BuilderEvents> implements Builder {\n\tpublic readonly tool = 'tsc' as const;\n\t#child: ChildProcess | null = null;\n\t#startedAt = 0;\n\t#firstError: string | null = null;\n\n\tpublic constructor(private readonly config: ResolvedStarsConfig) {\n\t\tsuper();\n\t}\n\n\tpublic build(): Promise<BuildOutcome> {\n\t\tconst child = this.#spawn([]);\n\t\tthis.#begin();\n\n\t\treturn new Promise((resolve) => {\n\t\t\tchild.once('exit', (code) => {\n\t\t\t\tthis.#child = null;\n\t\t\t\tresolve(this.#finish(code === 0 ? null : (this.#firstError ?? `tsc exited with code ${code}`)));\n\t\t\t});\n\t\t});\n\t}\n\n\tpublic watch(): Promise<void> {\n\t\tthis.#spawn(['--watch', '--preserveWatchOutput']);\n\t\tthis.#begin();\n\t\treturn Promise.resolve();\n\t}\n\n\tpublic close(): Promise<void> {\n\t\tconst child = this.#child;\n\t\tthis.#child = null;\n\t\tif (!child || child.exitCode !== null) return Promise.resolve();\n\n\t\treturn new Promise((resolve) => {\n\t\t\tchild.once('exit', () => resolve());\n\t\t\tchild.kill();\n\t\t});\n\t}\n\n\t#spawn(extraArgs: string[]): ChildProcess {\n\t\tconst tsc = resolveTscBinary(this.config.root);\n\t\tif (!tsc) throw new CliError(`\"typescript\" is not installed in ${this.config.root}`, { code: 'DEPENDENCY_MISSING', hint: INSTALL_HINT });\n\n\t\tconst child = spawn(process.execPath, [tsc, '-b', this.config.build.tsconfig!, '--pretty', 'false', ...extraArgs], {\n\t\t\tcwd: this.config.root,\n\t\t\tenv: process.env,\n\t\t\tstdio: ['ignore', 'pipe', 'pipe'],\n\t\t\twindowsHide: true\n\t\t});\n\t\tthis.#child = child;\n\n\t\tconst handleLine = (line: string) => this.#handleLine(line);\n\t\tconst stdout = createLineSplitter(handleLine);\n\t\tconst stderr = createLineSplitter(handleLine);\n\t\tchild.stdout?.on('data', stdout.push);\n\t\tchild.stderr?.on('data', stderr.push);\n\t\tchild.once('exit', () => {\n\t\t\tstdout.flush();\n\t\t\tstderr.flush();\n\t\t});\n\t\tchild.once('error', (error) => this.emit('log', 'error', error.message));\n\n\t\treturn child;\n\t}\n\n\t#handleLine(line: string): void {\n\t\tconst text = line.trim();\n\t\tif (text.length === 0) return;\n\n\t\tif (WATCH_START.test(text)) {\n\t\t\tif (this.#startedAt === 0) this.#begin();\n\t\t\treturn;\n\t\t}\n\n\t\tif (ERROR_LINE.test(text)) {\n\t\t\tthis.#firstError ??= text;\n\t\t\tthis.emit('log', 'error', text);\n\t\t\treturn;\n\t\t}\n\n\t\tconst done = WATCH_DONE.exec(text);\n\t\tif (done) {\n\t\t\tconst errors = Number(done[1]);\n\t\t\tthis.emit('log', errors === 0 ? 'success' : 'error', text);\n\t\t\tthis.#finish(errors === 0 ? null : (this.#firstError ?? text));\n\t\t\treturn;\n\t\t}\n\n\t\tthis.emit('log', 'info', text);\n\t}\n\n\t#begin(): void {\n\t\tthis.#firstError = null;\n\t\tthis.#startedAt = performance.now();\n\t\tthis.emit('start');\n\t}\n\n\t#finish(message: string | null): BuildOutcome {\n\t\tconst outcome: BuildOutcome = { ok: message === null, durationMs: Math.round(performance.now() - this.#startedAt), message };\n\t\tthis.#startedAt = 0;\n\t\tthis.emit(outcome.ok ? 'success' : 'failure', outcome);\n\t\treturn outcome;\n\t}\n}\n\n/**\n * Locates the `tsc` script of the project's TypeScript through its `package.json#bin`, which works for both the\n * classic `lib/tsc.js` layout (TypeScript ≤ 6) and the native `bin/tsc` launcher (TypeScript 7, whose `exports` map\n * hides `lib/`).\n */\nexport function resolveTscBinary(root: string): string | null {\n\treturn resolveBinary(root, 'typescript', 'tsc');\n}\n"],"mappings":"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"}

package/dist/tsc-CovVAtfo.js

@@ -0,0 +1,3 @@
+import { n as resolveTscBinary, t as TscBuilder } from "./tsc-BqZfDTD0.js";
+
+export { TscBuilder };

package/dist/tsdown-DlAs0rSI.js

@@ -0,0 +1,104 @@
+import { n as importFromProject } from "./project-DHF3qdm-.js";
+import { EventEmitter } from "node:events";
+
+//#region src/lib/builders/tsdown.ts
+const INSTALL_HINT = "Install it with `pnpm add -D tsdown`, or set `build.tool` to 'tsc' or 'none'.";
+/**
+* Builds through the project's own `tsdown`, honouring its `tsdown.config.*`.
+*/
+var TsdownBuilder = class extends EventEmitter {
+	config;
+	tool = "tsdown";
+	#bundles = [];
+	#hadError = false;
+	#startedAt = 0;
+	constructor(config) {
+		super();
+		this.config = config;
+	}
+	async build() {
+		const tsdown = await this.#load();
+		this.#begin();
+		try {
+			this.#bundles = await tsdown.build({
+				cwd: this.config.root,
+				customLogger: this.#logger()
+			});
+			return this.#finish(this.#hadError ? "The build reported errors" : null);
+		} catch (error) {
+			return this.#finish(error instanceof Error ? error.message : String(error));
+		}
+	}
+	async watch() {
+		const tsdown = await this.#load();
+		this.#begin();
+		this.#bundles = await tsdown.build({
+			cwd: this.config.root,
+			watch: true,
+			customLogger: this.#logger(),
+			hooks: { "build:prepare": () => {
+				if (this.#startedAt === 0) this.#begin();
+			} },
+			onSuccess: () => {
+				this.#finish(null);
+			}
+		});
+	}
+	async close() {
+		const bundles = this.#bundles;
+		this.#bundles = [];
+		await Promise.allSettled(bundles.map((bundle) => bundle[Symbol.asyncDispose]()));
+	}
+	#load() {
+		return importFromProject(this.config.root, "tsdown", INSTALL_HINT);
+	}
+	#begin() {
+		this.#hadError = false;
+		this.#startedAt = performance.now();
+		this.emit("start");
+	}
+	#finish(message) {
+		const outcome = {
+			ok: message === null && !this.#hadError,
+			durationMs: Math.round(performance.now() - this.#startedAt),
+			message
+		};
+		this.#startedAt = 0;
+		this.emit(outcome.ok ? "success" : "failure", outcome);
+		return outcome;
+	}
+	#logger() {
+		const log = (level, args) => {
+			const text = args.filter((argument) => argument !== void 0 && argument !== null && argument !== false && argument !== "").map((argument) => argument instanceof Error ? argument.stack ?? argument.message : String(argument)).join(" ");
+			this.emit("log", level, text);
+		};
+		const warned = /* @__PURE__ */ new Set();
+		return {
+			level: "info",
+			info: (...args) => log("info", args),
+			warn: (...args) => log("warn", args),
+			warnOnce: (...args) => {
+				const key = args.map(String).join(" ");
+				if (warned.has(key)) return;
+				warned.add(key);
+				log("warn", args);
+			},
+			error: (...args) => {
+				this.#hadError = true;
+				log("error", args);
+				if (this.#startedAt !== 0 && this.#bundles.length > 0) this.#finish(errorSummary(args));
+			},
+			success: (...args) => log("success", args),
+			clearScreen: () => {}
+		};
+	}
+};
+function errorSummary(args) {
+	const first = args[0];
+	if (first instanceof Error) return first.message.split("\n")[0] ?? "Build failed";
+	return String(first ?? "Build failed").split("\n")[0] ?? "Build failed";
+}
+
+//#endregion
+export { TsdownBuilder };
+//# sourceMappingURL=tsdown-DlAs0rSI.js.map

package/dist/tsdown-DlAs0rSI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdown-DlAs0rSI.js","names":["#load","#begin","#bundles","#logger","#finish","#hadError","#startedAt"],"sources":["../src/lib/builders/tsdown.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { ResolvedStarsConfig } from '@wolfstar/http-framework/config';\nimport { importFromProject } from '../project.js';\nimport type { Builder, BuilderEvents, BuildOutcome } from './types.js';\n\ntype TsdownModule = typeof import('tsdown');\ntype TsdownLogger = import('tsdown').Logger;\ntype TsdownBundle = import('tsdown').TsdownBundle;\n\nconst INSTALL_HINT = \"Install it with `pnpm add -D tsdown`, or set `build.tool` to 'tsc' or 'none'.\";\n\n/**\n * Builds through the project's own `tsdown`, honouring its `tsdown.config.*`.\n */\nexport class TsdownBuilder extends EventEmitter<BuilderEvents> implements Builder {\n\tpublic readonly tool = 'tsdown' as const;\n\t#bundles: TsdownBundle[] = [];\n\t#hadError = false;\n\t#startedAt = 0;\n\n\tpublic constructor(private readonly config: ResolvedStarsConfig) {\n\t\tsuper();\n\t}\n\n\tpublic async build(): Promise<BuildOutcome> {\n\t\tconst tsdown = await this.#load();\n\t\tthis.#begin();\n\n\t\ttry {\n\t\t\tthis.#bundles = await tsdown.build({ cwd: this.config.root, customLogger: this.#logger() });\n\t\t\treturn this.#finish(this.#hadError ? 'The build reported errors' : null);\n\t\t} catch (error) {\n\t\t\treturn this.#finish(error instanceof Error ? error.message : String(error));\n\t\t}\n\t}\n\n\tpublic async watch(): Promise<void> {\n\t\tconst tsdown = await this.#load();\n\n\t\tthis.#begin();\n\t\tthis.#bundles = await tsdown.build({\n\t\t\tcwd: this.config.root,\n\t\t\twatch: true,\n\t\t\tcustomLogger: this.#logger(),\n\t\t\thooks: {\n\t\t\t\t'build:prepare': () => {\n\t\t\t\t\tif (this.#startedAt === 0) this.#begin();\n\t\t\t\t}\n\t\t\t},\n\t\t\tonSuccess: () => {\n\t\t\t\tthis.#finish(null);\n\t\t\t}\n\t\t});\n\t}\n\n\tpublic async close(): Promise<void> {\n\t\tconst bundles = this.#bundles;\n\t\tthis.#bundles = [];\n\t\tawait Promise.allSettled(bundles.map((bundle) => bundle[Symbol.asyncDispose]()));\n\t}\n\n\t#load(): Promise<TsdownModule> {\n\t\treturn importFromProject<TsdownModule>(this.config.root, 'tsdown', INSTALL_HINT);\n\t}\n\n\t#begin(): void {\n\t\tthis.#hadError = false;\n\t\tthis.#startedAt = performance.now();\n\t\tthis.emit('start');\n\t}\n\n\t#finish(message: string | null): BuildOutcome {\n\t\tconst outcome: BuildOutcome = {\n\t\t\tok: message === null && !this.#hadError,\n\t\t\tdurationMs: Math.round(performance.now() - this.#startedAt),\n\t\t\tmessage\n\t\t};\n\t\tthis.#startedAt = 0;\n\t\tthis.emit(outcome.ok ? 'success' : 'failure', outcome);\n\t\treturn outcome;\n\t}\n\n\t#logger(): TsdownLogger {\n\t\tconst log = (level: 'info' | 'warn' | 'error' | 'success', args: unknown[]) => {\n\t\t\t// tsdown passes its (possibly undefined) name label and other blanks as separate arguments.\n\t\t\tconst text = args\n\t\t\t\t.filter((argument) => argument !== undefined && argument !== null && argument !== false && argument !== '')\n\t\t\t\t.map((argument) => (argument instanceof Error ? (argument.stack ?? argument.message) : String(argument)))\n\t\t\t\t.join(' ');\n\t\t\tthis.emit('log', level, text);\n\t\t};\n\n\t\tconst warned = new Set<string>();\n\t\treturn {\n\t\t\tlevel: 'info',\n\t\t\tinfo: (...args) => log('info', args),\n\t\t\twarn: (...args) => log('warn', args),\n\t\t\twarnOnce: (...args) => {\n\t\t\t\tconst key = args.map(String).join(' ');\n\t\t\t\tif (warned.has(key)) return;\n\t\t\t\twarned.add(key);\n\t\t\t\tlog('warn', args);\n\t\t\t},\n\t\t\terror: (...args) => {\n\t\t\t\tthis.#hadError = true;\n\t\t\t\tlog('error', args);\n\t\t\t\t// In watch mode tsdown never calls `onSuccess` after an error, report the failure now.\n\t\t\t\tif (this.#startedAt !== 0 && this.#bundles.length > 0) this.#finish(errorSummary(args));\n\t\t\t},\n\t\t\tsuccess: (...args) => log('success', args),\n\t\t\tclearScreen: () => {}\n\t\t};\n\t}\n}\n\nfunction errorSummary(args: unknown[]): string {\n\tconst first = args[0];\n\tif (first instanceof Error) return first.message.split('\\n')[0] ?? 'Build failed';\n\treturn String(first ?? 'Build failed').split('\\n')[0] ?? 'Build failed';\n}\n"],"mappings":"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"}