@wolfstar/cli 2.1.0 → 2.3.0-next-20261004131917

package/dist/doctor-DkVUwgDd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-DkVUwgDd.js","names":[],"sources":["../src/commands/doctor.ts"],"sourcesContent":["import { displayPath, type ResolvedStarsConfig } from '@wolfstar/schema';\nimport { defineCommand } from 'citty';\nimport { createColors } from 'colorette';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { createServer } from 'node:net';\nimport { delimiter, join } from 'node:path';\nimport { BRIDGE_FRAMEWORK_VERSION, isAtLeast } from '../dev/bridge.js';\nimport { endpointUrl, readDiscordCredentials } from '../dev/tunnel.js';\nimport { projectArgs, resolveCwd, type ProjectArgs } from '../utils/args.js';\nimport { cliDiagnostics } from '../utils/diagnostics.js';\nimport { loadProject, withProjectEnv, applyEnvOptions, type StarsHookable } from '../utils/hooks.js';\nimport { modulesPreloadWarning } from '../utils/modules.js';\nimport { shouldUseColor } from '../utils/output-mode.js';\nimport { readProjectEnv } from '../utils/project-env.js';\nimport { findInstalledVersion } from '../utils/project.js';\nimport { readOwnPackageJson } from '../utils/version.js';\nimport { prepareProject } from './_shared.js';\n\nexport type CheckStatus = 'ok' | 'info' | 'warn' | 'error';\n\nexport interface Check {\n\tname: string;\n\tstatus: CheckStatus;\n\tmessage: string;\n\t/** What to do about it. */\n\tfix?: string;\n}\n\nexport interface DoctorOptions extends ProjectArgs {\n\tjson?: boolean;\n\t/** Also asks Discord whether the token works and where the application's interactions go. */\n\tonline?: boolean;\n\tstdout?: NodeJS.WritableStream;\n\t/** Overrides for tests. */\n\tenv?: NodeJS.ProcessEnv;\n\tnodeVersion?: string;\n\tfetch?: typeof fetch;\n\tisPortFree?: (port: number, host: string) => Promise<boolean>;\n}\n\n/** The Node.js versions `@wolfstar/cli` runs on (`engines.node` of its `package.json`). */\nconst MINIMUM_NODE = 22;\n\n/**\n * Checks what a project needs before `stars dev` can do its job: the runtime, the framework, the credentials, the\n * interactions endpoint and the generated files. Each check says what is wrong and what to do about it; nothing is\n * changed.\n */\nexport async function collectChecks(config: ResolvedStarsConfig, hooks: StarsHookable, options: DoctorOptions = {}): Promise<Check[]> {\n\tconst env = options.env ?? process.env;\n\tconst checks: Check[] = [];\n\tconst show = (path: string) => displayPath(config.root, path);\n\n\tconst node = options.nodeVersion ?? process.version;\n\tconst major = Number.parseInt(node.replace(/^v/, ''), 10);\n\tchecks.push(\n\t\tmajor >= MINIMUM_NODE\n\t\t\t? { name: 'node', status: 'ok', message: `Node.js ${node}` }\n\t\t\t: { name: 'node', status: 'error', message: `Node.js ${node} is too old`, fix: `Use Node.js ${MINIMUM_NODE} or later.` }\n\t);\n\tconst wanted = readEnginesNode(config.root);\n\tconst minimum = wanted === null ? null : /^\\s*>=\\s*(\\d+)/.exec(wanted);\n\tif (minimum && major < Number(minimum[1])) {\n\t\tchecks.push({\n\t\t\tname: 'engines',\n\t\t\tstatus: 'warn',\n\t\t\tmessage: `The project asks for Node.js ${wanted}, this is ${node}`,\n\t\t\tfix: `Use Node.js ${wanted}.`\n\t\t});\n\t}\n\n\tchecks.push({ name: 'config', status: 'ok', message: config.configFile ? show(config.configFile) : 'no stars.config, running on defaults' });\n\tfor (const warning of [...config.warnings, modulesPreloadWarning(config)]) {\n\t\tif (warning) checks.push({ name: 'config', status: 'warn', message: warning.message, ...(warning.fix ? { fix: warning.fix } : {}) });\n\t}\n\n\tconst framework = findInstalledVersion(config.root, '@wolfstar/http-framework');\n\tif (framework === null) {\n\t\tchecks.push({\n\t\t\tname: 'framework',\n\t\t\tstatus: 'error',\n\t\t\tmessage: '@wolfstar/http-framework is not installed',\n\t\t\tfix: 'Install @wolfstar/http-framework in the project.'\n\t\t});\n\t} else if (isAtLeast(framework, BRIDGE_FRAMEWORK_VERSION)) {\n\t\tchecks.push({ name: 'framework', status: 'ok', message: `@wolfstar/http-framework v${framework}` });\n\t} else {\n\t\tchecks.push({\n\t\t\tname: 'framework',\n\t\t\tstatus: 'warn',\n\t\t\tmessage: `@wolfstar/http-framework v${framework} cannot report to the dev UI`,\n\t\t\tfix: `Update to ${BRIDGE_FRAMEWORK_VERSION} or later for the hmr, commands, interactions and http channels.`\n\t\t});\n\t}\n\n\tchecks.push({ name: 'entry', status: 'ok', message: `${show(config.entry)} (${config.build.tool})` });\n\tif (config.build.tool !== 'none' && !existsSync(config.build.output)) {\n\t\tchecks.push({\n\t\t\tname: 'build',\n\t\t\tstatus: 'info',\n\t\t\tmessage: `${show(config.build.output)} is not built yet`,\n\t\t\tfix: 'Run `stars build` (or `stars dev`).'\n\t\t});\n\t}\n\n\tconst values = { ...readProjectEnv(config), ...definedOnly(env), ...config.dev.env };\n\tconst credentials = readDiscordCredentials(config, env);\n\tchecks.push(\n\t\tcredentials\n\t\t\t? { name: 'token', status: 'ok', message: 'DISCORD_TOKEN is set' }\n\t\t\t: {\n\t\t\t\t\tname: 'token',\n\t\t\t\t\tstatus: 'error',\n\t\t\t\t\tmessage: 'DISCORD_TOKEN is not set',\n\t\t\t\t\tfix: 'Set DISCORD_TOKEN in the environment or in the project .env file.'\n\t\t\t\t}\n\t);\n\tchecks.push(\n\t\tvalues.DISCORD_PUBLIC_KEY\n\t\t\t? { name: 'public key', status: 'ok', message: 'DISCORD_PUBLIC_KEY is set' }\n\t\t\t: {\n\t\t\t\t\tname: 'public key',\n\t\t\t\t\tstatus: 'warn',\n\t\t\t\t\tmessage: 'DISCORD_PUBLIC_KEY is not set',\n\t\t\t\t\tfix: 'Set it in the project .env file, unless the bot passes `discordPublicKey` to its Client.'\n\t\t\t\t}\n\t);\n\tif (credentials && !credentials.applicationId) {\n\t\tchecks.push({\n\t\t\tname: 'application',\n\t\t\tstatus: 'warn',\n\t\t\tmessage: 'The Discord application id is not set',\n\t\t\tfix: 'Set DISCORD_APPLICATION_ID for `stars commands`.'\n\t\t});\n\t}\n\n\tif (config.dev.url) {\n\t\tconst url = new URL(config.dev.url);\n\t\tconst port = Number(url.port || (url.protocol === 'https:' ? 443 : 80));\n\t\tconst free = await (options.isPortFree ?? isPortFree)(port, url.hostname);\n\t\tchecks.push(\n\t\t\tfree\n\t\t\t\t? { name: 'port', status: 'ok', message: `${config.dev.url} is free` }\n\t\t\t\t: {\n\t\t\t\t\t\tname: 'port',\n\t\t\t\t\t\tstatus: 'warn',\n\t\t\t\t\t\tmessage: `Something already listens on ${config.dev.url}`,\n\t\t\t\t\t\tfix: 'Stop it, or set another HTTP_PORT, unless it is this bot running.'\n\t\t\t\t\t}\n\t\t);\n\t}\n\n\tconst { tunnel } = config.dev;\n\tif (tunnel.mode === 'off') {\n\t\tchecks.push({\n\t\t\tname: 'tunnel',\n\t\t\tstatus: 'info',\n\t\t\tmessage: 'No tunnel: Discord cannot reach a bot on localhost',\n\t\t\tfix: 'Set `dev.tunnel: true` for a cloudflared quick tunnel, or press t in `stars dev`.'\n\t\t});\n\t} else if (tunnel.mode === 'quick') {\n\t\tchecks.push(\n\t\t\tfindOnPath('cloudflared', env)\n\t\t\t\t? { name: 'tunnel', status: 'ok', message: 'cloudflared quick tunnel' }\n\t\t\t\t: { name: 'tunnel', status: 'info', message: 'cloudflared is not on the PATH: it is downloaded the first time the tunnel opens' }\n\t\t);\n\t} else {\n\t\tchecks.push({ name: 'tunnel', status: 'ok', message: tunnel.url });\n\t}\n\n\ttry {\n\t\tconst prepared = await prepareProject(config, hooks, true);\n\t\tconst stale = [\n\t\t\tprepared.tsconfig.status === 'outdated' ? show(prepared.tsconfig.path) : null,\n\t\t\tprepared.status === 'outdated' ? show(prepared.dts) : null,\n\t\t\tprepared.modules?.status === 'outdated' ? show(prepared.modules.path) : null\n\t\t].filter((path) => path !== null);\n\t\tchecks.push(\n\t\t\tstale.length === 0\n\t\t\t\t? { name: 'prepare', status: 'ok', message: 'The generated files are up to date' }\n\t\t\t\t: { name: 'prepare', status: 'warn', message: `Out of date: ${stale.join(', ')}`, fix: 'Run `stars prepare`.' }\n\t\t);\n\t} catch (error) {\n\t\tchecks.push({ name: 'prepare', status: 'error', message: error instanceof Error ? error.message : String(error) });\n\t}\n\n\tif (options.online && credentials) checks.push(await checkApplication(credentials.token, config, options.fetch ?? fetch));\n\treturn checks;\n}\n\n/** Asks Discord who the token belongs to and where it sends interactions: the one thing only Discord knows. */\nasync function checkApplication(token: string, config: ResolvedStarsConfig, request: typeof fetch): Promise<Check> {\n\ttry {\n\t\tconst response = await request('https://discord.com/api/v10/applications/@me', {\n\t\t\theaders: { authorization: `Bot ${token}` },\n\t\t\tsignal: AbortSignal.timeout(10_000)\n\t\t});\n\t\tif (!response.ok) {\n\t\t\treturn {\n\t\t\t\tname: 'discord',\n\t\t\t\tstatus: 'error',\n\t\t\t\tmessage: `Discord answered ${response.status}`,\n\t\t\t\tfix: response.status === 401 ? 'Check DISCORD_TOKEN.' : 'Try again later.'\n\t\t\t};\n\t\t}\n\n\t\tconst application = (await response.json()) as { name?: string; interactions_endpoint_url?: string | null };\n\t\tconst endpoint = application.interactions_endpoint_url;\n\t\tconst name = application.name ?? 'the application';\n\t\tif (!endpoint) {\n\t\t\treturn {\n\t\t\t\tname: 'discord',\n\t\t\t\tstatus: 'warn',\n\t\t\t\tmessage: `${name} has no interactions endpoint URL`,\n\t\t\t\tfix: 'Set `dev.tunnel.updateEndpoint: true`, or set it in the Discord developer portal.'\n\t\t\t};\n\t\t}\n\n\t\tconst tunnel = config.dev.tunnel;\n\t\t// The whole endpoint: the same origin with another path, or a host that merely starts the same, is elsewhere.\n\t\tconst expected = tunnel.mode === 'url' ? endpointUrl(tunnel.url, tunnel.path) : null;\n\t\tif (expected !== null && normalizeUrl(endpoint) !== normalizeUrl(expected)) {\n\t\t\treturn {\n\t\t\t\tname: 'discord',\n\t\t\t\tstatus: 'warn',\n\t\t\t\tmessage: `${name} sends interactions to ${endpoint}, not to ${expected}`,\n\t\t\t\tfix: 'Set `dev.tunnel.updateEndpoint: true`, or update it in the Discord developer portal.'\n\t\t\t};\n\t\t}\n\n\t\treturn { name: 'discord', status: 'ok', message: `${name} sends interactions to ${endpoint}` };\n\t} catch (error) {\n\t\treturn { name: 'discord', status: 'warn', message: `Could not reach Discord: ${error instanceof Error ? error.message : String(error)}` };\n\t}\n}\n\n/** A URL without the difference a trailing slash makes, or the text itself when it is not one. */\nfunction normalizeUrl(url: string): string {\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\treturn `${parsed.origin}${parsed.pathname.replace(/\\/+$/, '')}${parsed.search}`;\n\t} catch {\n\t\treturn url;\n\t}\n}\n\nfunction readEnginesNode(root: string): string | null {\n\ttry {\n\t\tconst parsed = JSON.parse(readFileSync(join(root, 'package.json'), 'utf-8')) as { engines?: { node?: unknown } };\n\t\treturn typeof parsed.engines?.node === 'string' ? parsed.engines.node : null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction definedOnly(env: NodeJS.ProcessEnv): Record<string, string> {\n\treturn Object.fromEntries(Object.entries(env).filter((entry): entry is [string, string] => entry[1] !== undefined));\n}\n\nfunction findOnPath(binary: string, env: NodeJS.ProcessEnv): boolean {\n\tconst extensions = process.platform === 'win32' ? ['.exe', '.cmd', ''] : [''];\n\treturn (env.PATH ?? '')\n\t\t.split(delimiter)\n\t\t.filter(Boolean)\n\t\t.some((directory) => extensions.some((extension) => existsSync(join(directory, `${binary}${extension}`))));\n}\n\n/** Whether nothing listens on `host:port`: the port is bound for an instant and released. */\nfunction isPortFree(port: number, host: string): Promise<boolean> {\n\treturn new Promise((resolve) => {\n\t\tconst server = createServer();\n\t\tserver.once('error', () => resolve(false));\n\t\tserver.listen({ port, host, exclusive: true }, () => server.close(() => resolve(true)));\n\t});\n}\n\nconst SYMBOLS: Record<CheckStatus, string> = { ok: '✔', info: 'ℹ', warn: '⚠', error: '✖' };\n\nexport function formatChecks(checks: readonly Check[], useColor: boolean): string {\n\tconst colors = createColors({ useColor });\n\tconst paint = { ok: colors.green, info: colors.cyan, warn: colors.yellow, error: colors.red };\n\tconst width = Math.max(...checks.map((check) => check.name.length));\n\tconst lines = checks.flatMap((check) => [\n\t\t`  ${paint[check.status](SYMBOLS[check.status])} ${colors.dim(check.name.padEnd(width))}  ${check.message}`,\n\t\t...(check.fix ? [`    ${' '.repeat(width)}  ${colors.dim(`→ ${check.fix}`)}`] : [])\n\t]);\n\tconst count = (status: CheckStatus) => checks.filter((check) => check.status === status).length;\n\tconst summary = count('error') > 0 ? colors.red(`${count('error')} error(s)`) : colors.green('no errors');\n\treturn [\n\t\tcolors.bold(`stars doctor ${colors.dim(`v${readOwnPackageJson().version}`)}`),\n\t\t...lines,\n\t\t'',\n\t\t`  ${summary}, ${count('warn')} warning(s)`\n\t].join('\\n');\n}\n\nexport async function runDoctor(options: DoctorOptions): Promise<void> {\n\tconst stdout = options.stdout ?? process.stdout;\n\tconst project = await loadProject({ cwd: resolveCwd(options), configFile: options.config });\n\t// What `stars dev` would run with: `env:options` and varlock may change the port and the credentials.\n\tconst config = withProjectEnv(await applyEnvOptions(project.config, project.hooks));\n\tconst checks = await collectChecks(config, project.hooks, options);\n\tconst errors = checks.filter((check) => check.status === 'error').length;\n\n\tstdout.write(`${options.json ? JSON.stringify({ ok: errors === 0, checks }, null, 2) : formatChecks(checks, shouldUseColor())}\\n`);\n\tif (errors > 0) throw cliDiagnostics.DOCTOR_FAILED({ count: errors });\n}\n\nexport default defineCommand({\n\tmeta: {\n\t\tname: 'doctor',\n\t\tdescription: 'Check that the project is ready for `stars dev`: runtime, framework, credentials, endpoint, generated files'\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\tonline: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Also ask Discord whether the token works and where the application sends interactions',\n\t\t\tdefault: false\n\t\t}\n\t},\n\tasync run({ args }) {\n\t\tawait runDoctor({ config: args.config, cwd: args.cwd, json: args.json, online: args.online });\n\t}\n});\n"],"mappings":"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"}

package/dist/{errors-Crt4hu0b.js → errors-COFWKKKw.js}

@@ -16,7 +16,10 @@ const ExitCode = {
 /** Every `stars.config.*` diagnostic code maps to {@link ExitCode.InvalidConfig}; everything else defaults to `Error`. */
 const CONFIG_DIAGNOSTIC_CODES = new Set(Object.keys(configDiagnostics));
 /** CLI-local diagnostic codes whose exit code isn't the default {@link ExitCode.Error}. */
-const CLI_EXIT_CODES = { BUILD_FAILED: ExitCode.BuildFailed };
+const CLI_EXIT_CODES = {
+	BUILD_FAILED: ExitCode.BuildFailed,
+	MODULE_FAILED: ExitCode.InvalidConfig
+};
 /**
 * Formats an error for the terminal: a `Diagnostic` (from `stars.config.*` validation, via
 * `@wolfstar/schema`'s `configDiagnostics`, or from the CLI's own `cliDiagnostics`) renders through
@@ -53,4 +56,4 @@ function exitCodeOf(error) {
 
 //#endregion
 export { renderCrashReport as i, exitCodeOf as n, formatError as r, ExitCode as t };
-//# sourceMappingURL=errors-Crt4hu0b.js.map
+//# sourceMappingURL=errors-COFWKKKw.js.map

package/dist/errors-COFWKKKw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-COFWKKKw.js","names":[],"sources":["../src/utils/errors.ts"],"sourcesContent":["import { configDiagnostics } from '@wolfstar/schema';\nimport { createColors } from 'colorette';\nimport { Diagnostic } from 'nostics';\nimport { ansiFormatter } from 'nostics/formatters/ansi';\nimport { shouldUseColor } from './output-mode.js';\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\n/** Every `stars.config.*` diagnostic code maps to {@link ExitCode.InvalidConfig}; everything else defaults to `Error`. */\nconst CONFIG_DIAGNOSTIC_CODES = new Set<string>(Object.keys(configDiagnostics));\n\n/** CLI-local diagnostic codes whose exit code isn't the default {@link ExitCode.Error}. */\nconst CLI_EXIT_CODES: Partial<Record<string, ExitCode>> = {\n\tBUILD_FAILED: ExitCode.BuildFailed,\n\tMODULE_FAILED: ExitCode.InvalidConfig\n};\n\n/**\n * Formats an error for the terminal: a `Diagnostic` (from `stars.config.*` validation, via\n * `@wolfstar/schema`'s `configDiagnostics`, or from the CLI's own `cliDiagnostics`) renders through\n * nostics' own ANSI formatter — message, `fix`, `sources` and `docs` — everything else falls back to a crash report.\n */\nexport async function formatError(error: unknown): Promise<string> {\n\tif (error instanceof Diagnostic) {\n\t\tconst colors = createColors({ useColor: shouldUseColor() });\n\t\treturn ansiFormatter(colors)(error);\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 renderCrashReport(error);\n\treturn String(error);\n}\n\n/**\n * Renders an unexpected error (a bug, not something the CLI already explains through a `Diagnostic`) as a\n * sourcemapped, syntax-highlighted report — frames and a snippet of the original source instead of a stack trace\n * pointing into the bundled `dist/cli.js`.\n */\nexport async function renderCrashReport(error: unknown, cwd: string = process.cwd()): Promise<string> {\n\tconst { createReport, fsLoader, renderAnsi } = await import('my-bad');\n\tconst report = await createReport(error, { cwd, loaders: [fsLoader()] });\n\treturn renderAnsi(report, { cwd });\n}\n\nexport function exitCodeOf(error: unknown): ExitCode {\n\tif (error instanceof Diagnostic) {\n\t\tif (CONFIG_DIAGNOSTIC_CODES.has(error.code)) return ExitCode.InvalidConfig;\n\t\treturn CLI_EXIT_CODES[error.code] ?? ExitCode.Error;\n\t}\n\n\treturn ExitCode.Error;\n}\n"],"mappings":";;;;;;;AAMA,MAAa,WAAW;CACvB,IAAI;CACJ,OAAO;CACP,eAAe;CACf,aAAa;CACb,aAAa;CACb,YAAY;AACb;;AAKA,MAAM,0BAA0B,IAAI,IAAY,OAAO,KAAK,iBAAiB,CAAC;;AAG9E,MAAM,iBAAoD;CACzD,cAAc,SAAS;CACvB,eAAe,SAAS;AACzB;;;;;;AAOA,eAAsB,YAAY,OAAiC;CAClE,IAAI,iBAAiB,YAAY;EAChC,MAAM,SAAS,aAAa,EAAE,UAAU,eAAe,EAAE,CAAC;EAC1D,OAAO,cAAc,MAAM,CAAC,CAAC,KAAK;CACnC;CAGA,IAAI,iBAAiB,SAAS,MAAM,SAAS,YAAY,OAAO,MAAM;CACtE,IAAI,iBAAiB,OAAO,OAAO,kBAAkB,KAAK;CAC1D,OAAO,OAAO,KAAK;AACpB;;;;;;AAOA,eAAsB,kBAAkB,OAAgB,MAAc,QAAQ,IAAI,GAAoB;CACrG,MAAM,EAAE,cAAc,UAAU,eAAe,MAAM,OAAO;CAE5D,OAAO,WAAW,MADG,aAAa,OAAO;EAAE;EAAK,SAAS,CAAC,SAAS,CAAC;CAAE,CAAC,GAC7C,EAAE,IAAI,CAAC;AAClC;AAEA,SAAgB,WAAW,OAA0B;CACpD,IAAI,iBAAiB,YAAY;EAChC,IAAI,wBAAwB,IAAI,MAAM,IAAI,GAAG,OAAO,SAAS;EAC7D,OAAO,eAAe,MAAM,SAAS,SAAS;CAC/C;CAEA,OAAO,SAAS;AACjB"}

package/dist/hooks-Cy6F2bhH.js

@@ -0,0 +1,332 @@
+import { t as readOwnPackageJson } from "./version-BzclCE19.js";
+import { t as cliDiagnostics } from "./diagnostics-BysbNnPD.js";
+import { i as resolveFromProject, r as resolveBinary, t as findInstalledVersion } from "./project-zlQStwsf.js";
+import { isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { loadConfigFile, readProjectEnvFiles, resolveStarsConfig } from "@wolfstar/schema";
+import { envModuleSource, modulesModuleSource } from "@wolfstar/vite-server/internal";
+import { execFileSync } from "node:child_process";
+import { resolve as resolve$1, resolveSync } from "mlly";
+import { createHooks } from "hookable";
+import { ModuleError, setupModules } from "@wolfstar/kit";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+
+//#region src/utils/args.ts
+/**
+* Arguments shared by every command that reads the project configuration.
+*/
+const projectArgs = {
+	config: {
+		type: "string",
+		alias: "c",
+		description: "Path to the configuration file (defaults to stars.config.* in the working directory)"
+	},
+	cwd: {
+		type: "string",
+		description: "Working directory to run from (defaults to the current directory)"
+	}
+};
+/**
+* Every value of a flag given more than once (`--channel a --channel=b`). citty keeps only the last one of a
+* repeated string flag, so a repeatable flag reads the raw arguments.
+*/
+function collectFlag(rawArgs, name) {
+	const values = [];
+	for (const [index, argument] of rawArgs.entries()) {
+		if (argument === "--") break;
+		if (argument.startsWith(`--${name}=`)) values.push(argument.slice(name.length + 3));
+		else if (argument === `--${name}`) {
+			const next = rawArgs[index + 1];
+			if (next !== void 0 && !next.startsWith("-")) values.push(next);
+		}
+	}
+	return values;
+}
+function resolveCwd(args) {
+	return args.cwd ? resolve(process.cwd(), args.cwd) : process.cwd();
+}
+
+//#endregion
+//#region src/utils/env-import.ts
+/** Build tools whose output never passes through the entry transform that registers `env`. */
+const UNTRANSFORMED_TOOLS = /* @__PURE__ */ new Set(["none", "tsc"]);
+/**
+* `node` arguments that register `env` before the entry runs, for the build tools the entry transform cannot reach.
+* The preload is a `data:` URL, so `.stars/` gets no generated runtime file; a `data:` URL cannot resolve bare
+* specifiers, so `@wolfstar/env-utilities` is resolved from the project first. When it cannot be resolved nothing is
+* preloaded, and the bot's own import of it reports the missing install.
+*/
+function envImportArgs(config) {
+	if (!config.env.enabled || !UNTRANSFORMED_TOOLS.has(config.build.tool)) return [];
+	const resolved = resolveFromProject(config.root, "@wolfstar/env-utilities");
+	if (resolved === null) return [];
+	const source = envModuleSource(config.env.options, pathToFileURL(resolved).href);
+	return ["--import", `data:text/javascript,${encodeURIComponent(source)}`];
+}
+/**
+* `node` arguments that register the runtime plugins of the installed modules (`ctx.addPlugin`) before the entry
+* runs, for the build tools the entry transform cannot reach. `@wolfstar/http-framework` and every plugin are resolved
+* from the project first, with the `import` condition (both are ESM), because a `data:` URL cannot resolve bare
+* specifiers; the framework is the bot's own copy, so `Client.use` reaches the `Client` the bot constructs. When the
+* framework is not installed nothing is preloaded, and the bot's own import of it reports the missing install.
+*/
+function moduleImportArgs(config) {
+	const plugins = config.runtime?.plugins ?? [];
+	if (plugins.length === 0 || !UNTRANSFORMED_TOOLS.has(config.build.tool)) return [];
+	const url = pathToFileURL(`${config.root}/package.json`).href;
+	let framework;
+	try {
+		framework = resolveSync("@wolfstar/http-framework", { url });
+	} catch {
+		return [];
+	}
+	const source = modulesModuleSource(plugins, {
+		framework,
+		resolve: (from) => {
+			if (from.startsWith("file:")) return from;
+			if (isAbsolute(from)) return pathToFileURL(from).href;
+			try {
+				return resolveSync(from, { url });
+			} catch {
+				throw cliDiagnostics.DEPENDENCY_MISSING({
+					name: from,
+					root: config.root,
+					hint: "Install the package of the module that registers this plugin."
+				});
+			}
+		}
+	});
+	return ["--import", `data:text/javascript,${encodeURIComponent(source)}`];
+}
+
+//#endregion
+//#region src/utils/modules.ts
+/**
+* Where a module specifier is imported from: a relative or absolute path is a file of the project, a `file:` URL is
+* itself, anything else is a package resolved from the project root — with `mlly`, honouring the `import` condition,
+* because installed modules are ESM-only packages a CommonJS `require.resolve` cannot see.
+*/
+async function resolveSpecifier(root, specifier) {
+	if (specifier.startsWith("file:")) return specifier;
+	if (specifier.startsWith(".") || isAbsolute(specifier)) return pathToFileURL(resolve(root, specifier)).href;
+	return resolve$1(specifier, { url: pathToFileURL(`${root}/package.json`).href });
+}
+/**
+* Runs `setup` of every module in `modules` (see `@wolfstar/kit`) and returns the configuration carrying what they
+* contributed: `runtime`, and `imports.presets` extended by `ctx.addImports`. Without modules the configuration is
+* returned as it is.
+*/
+async function installModules(config, hooks) {
+	if (config.modules.length === 0) return config;
+	try {
+		const runtime = await setupModules({
+			config,
+			hooks,
+			versions: {
+				framework: findInstalledVersion(config.root, "@wolfstar/http-framework"),
+				stars: readOwnPackageJson().version
+			},
+			load: async (specifier) => import(await resolveSpecifier(config.root, specifier))
+		});
+		const presets = [...config.imports.presets, ...runtime.imports.filter((preset) => !config.imports.presets.includes(preset))];
+		return {
+			...config,
+			runtime,
+			imports: {
+				...config.imports,
+				presets
+			}
+		};
+	} catch (error) {
+		if (error instanceof ModuleError) throw cliDiagnostics.MODULE_FAILED({
+			module: error.moduleName,
+			reason: error.code,
+			message: error.message,
+			cause: error
+		});
+		throw error;
+	}
+}
+/**
+* The warning for a project whose runtime plugins reach production only through a `node --import` preload, `null`
+* otherwise. It is not one of `config.warnings`: `stars dev` preloads the plugins itself, so there it would be noise
+* on every start. `stars build` and `stars prepare` report it.
+*/
+function modulesPreloadWarning(config) {
+	if (!needsPreload(config)) return null;
+	return cliDiagnostics.MODULES_PRELOAD_REQUIRED({
+		tool: config.build.tool,
+		plugins: [...new Set(config.runtime.plugins.map((plugin) => plugin.module))].join(", ")
+	});
+}
+/** A build tool the entry transform cannot reach, with runtime plugins to register: they need a `node --import` preload. */
+function needsPreload(config) {
+	return UNTRANSFORMED_TOOLS.has(config.build.tool) && (config.runtime?.plugins.length ?? 0) > 0;
+}
+/**
+* Writes `.stars/modules.mjs`, the production counterpart of the preload `stars dev` passes to `node`: `node --import
+* ./.stars/modules.mjs <entry>` registers the runtime plugins of the installed modules for the build tools whose entry
+* cannot be transformed (`tsc`, `none`). Its specifiers are bare, so they resolve from the project's `node_modules`
+* like the bot's own imports. `null` when there is nothing to register.
+*
+* With `env` enabled it is preceded by `.stars/env.mjs`, a separate module imported first: imports of one module are
+* all evaluated before its body runs, so the environment could not be loaded ahead of the plugins from the same file,
+* and a plugin reading `process.env` while it is imported would see nothing.
+*/
+async function prepareModulesPreload(config, check = false) {
+	if (!needsPreload(config)) return null;
+	const directory = join(config.root, ".stars");
+	const path = join(directory, "modules.mjs");
+	const withEnv = config.env?.enabled === true;
+	const plugins = modulesModuleSource(config.runtime.plugins, { resolve: (from) => isAbsolute(from) ? pathToFileURL(from).href : from });
+	const files = [{
+		path,
+		content: withEnv ? `import "./env.mjs";\n${plugins}` : plugins
+	}, ...withEnv ? [{
+		path: join(directory, "env.mjs"),
+		content: envModuleSource(config.env.options)
+	}] : []];
+	if (check) return {
+		path,
+		status: (await Promise.all(files.map(async (file) => await readFile(file.path, "utf-8").catch(() => null) === file.content))).every(Boolean) ? "up-to-date" : "outdated"
+	};
+	await mkdir(directory, { recursive: true });
+	await Promise.all(files.map((file) => writeFile(file.path, file.content)));
+	return {
+		path,
+		status: "written"
+	};
+}
+
+//#endregion
+//#region src/utils/project-env.ts
+/**
+* The variables the bot will load, for the CLI's own lookups (Discord credentials for the tunnel). With the default
+* loader these are the project's env files, read from `env.path`/`env.env`. With `loader: 'varlock'` they are what
+* `varlock load` resolves from the project's `.env.schema` — a dotenv file may be stale or absent there — and nothing
+* when varlock cannot be run, rather than values the bot never sees.
+*/
+function readProjectEnv(config) {
+	const { path, env = "development", loader } = config.env.options;
+	if (loader !== "varlock") return readProjectEnvFiles(config.root, env, { path });
+	const binary = resolveBinary(config.root, "varlock", "varlock");
+	if (binary === null) return {};
+	try {
+		const output = execFileSync(process.execPath, [
+			binary,
+			"load",
+			"--format",
+			"json"
+		], {
+			cwd: config.root,
+			env: {
+				...process.env,
+				...config.dev.env,
+				NODE_ENV: "development"
+			},
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			],
+			timeout: 3e4
+		});
+		const values = JSON.parse(output);
+		return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => [key, String(value)]));
+	} catch {
+		return {};
+	}
+}
+
+//#endregion
+//#region src/utils/hooks.ts
+/** What each configuration loaded by {@link loadProject} was resolved from, so `env:options` can re-resolve it. */
+const sources = /* @__PURE__ */ new WeakMap();
+/** Registers the `hooks` of `stars.config` on a fresh `hookable` instance. */
+function createStarsHooks(config) {
+	const hooks = createHooks();
+	for (const [name, callbacks] of Object.entries(config.hooks)) for (const callback of callbacks) hooks.hook(name, callback);
+	return hooks;
+}
+/** Loads `stars.config`, registers its hooks and runs `config:resolved`. */
+async function loadProject(options) {
+	const cwd = options.cwd ?? process.cwd();
+	const loaded = await loadConfigFile({
+		cwd,
+		configFile: options.configFile
+	});
+	const source = {
+		cwd,
+		configFile: loaded.configFile,
+		config: loaded.config,
+		env: options.env
+	};
+	const resolved = resolveStarsConfig(source);
+	const hooks = createStarsHooks(resolved);
+	const config = await installModules(resolved, hooks);
+	sources.set(config, source);
+	await hooks.callHook("config:resolved", config);
+	return {
+		config,
+		hooks
+	};
+}
+/**
+* Runs `env:options` on a copy of the resolved `env` options and returns a configuration carrying the result, which
+* is what the builders write into the entry. The resolved configuration itself is left untouched.
+*
+* When the hook changes the options, the configuration is resolved again with them, so everything read from the env
+* files — the default `dev.url` port above all — matches what the bot will load.
+*/
+async function applyEnvOptions(config, hooks) {
+	if (!config.env.enabled) return config;
+	const options = { ...config.env.options };
+	await hooks.callHook("env:options", options, config);
+	const source = sources.get(config);
+	if (source === void 0 || JSON.stringify(options) === JSON.stringify(config.env.options)) return {
+		...config,
+		env: {
+			...config.env,
+			options
+		}
+	};
+	return reresolve(config, source, { config: {
+		...source.config,
+		env: {
+			...options,
+			enabled: true
+		}
+	} });
+}
+/**
+* With `loader: 'varlock'`, resolves the configuration again with the variables `varlock load` returns, so the
+* defaults `stars.config` derives from the environment — the `dev.url` port — match what the bot loads. Every other
+* configuration is returned as-is: the schema reads its env files directly.
+*/
+function withProjectEnv(config) {
+	const source = sources.get(config);
+	if (source === void 0 || !config.env.enabled || config.env.options.loader !== "varlock") return config;
+	return reresolve(config, source, { projectEnv: readProjectEnv(config) });
+}
+function reresolve(previous, source, change) {
+	const next = {
+		...source,
+		...change
+	};
+	const resolved = resolveStarsConfig(next);
+	const config = {
+		...resolved,
+		runtime: previous.runtime,
+		imports: {
+			...resolved.imports,
+			presets: previous.imports.presets
+		}
+	};
+	sources.set(config, next);
+	return config;
+}
+
+//#endregion
+export { modulesPreloadWarning as a, moduleImportArgs as c, resolveCwd as d, readProjectEnv as i, collectFlag as l, loadProject as n, prepareModulesPreload as o, withProjectEnv as r, envImportArgs as s, applyEnvOptions as t, projectArgs as u };
+//# sourceMappingURL=hooks-Cy6F2bhH.js.map

package/dist/hooks-Cy6F2bhH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-Cy6F2bhH.js","names":["resolveModule"],"sources":["../src/utils/args.ts","../src/utils/env-import.ts","../src/utils/modules.ts","../src/utils/project-env.ts","../src/utils/hooks.ts"],"sourcesContent":["import type { ArgsDef } from 'citty';\nimport { resolve } from 'node:path';\n\n/**\n * Arguments shared by every command that reads the project configuration.\n */\nexport const projectArgs = {\n\tconfig: {\n\t\ttype: 'string',\n\t\talias: 'c',\n\t\tdescription: 'Path to the configuration file (defaults to stars.config.* in the working directory)'\n\t},\n\tcwd: {\n\t\ttype: 'string',\n\t\tdescription: 'Working directory to run from (defaults to the current directory)'\n\t}\n} as const satisfies ArgsDef;\n\nexport interface ProjectArgs {\n\tconfig?: string;\n\tcwd?: string;\n}\n\n/**\n * Every value of a flag given more than once (`--channel a --channel=b`). citty keeps only the last one of a\n * repeated string flag, so a repeatable flag reads the raw arguments.\n */\nexport function collectFlag(rawArgs: readonly string[], name: string): string[] {\n\tconst values: string[] = [];\n\tfor (const [index, argument] of rawArgs.entries()) {\n\t\tif (argument === '--') break;\n\t\tif (argument.startsWith(`--${name}=`)) values.push(argument.slice(name.length + 3));\n\t\telse if (argument === `--${name}`) {\n\t\t\tconst next = rawArgs[index + 1];\n\t\t\tif (next !== undefined && !next.startsWith('-')) values.push(next);\n\t\t}\n\t}\n\n\treturn values;\n}\n\nexport function resolveCwd(args: ProjectArgs): string {\n\treturn args.cwd ? resolve(process.cwd(), args.cwd) : process.cwd();\n}\n","import type { ResolvedStarsConfig } from '@wolfstar/schema';\nimport { envModuleSource, modulesModuleSource } from '@wolfstar/vite-server/internal';\nimport { resolveSync } from 'mlly';\nimport { isAbsolute } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { cliDiagnostics } from './diagnostics.js';\nimport { resolveFromProject } from './project.js';\n\n/** Build tools whose output never passes through the entry transform that registers `env`. */\nexport const UNTRANSFORMED_TOOLS = new Set<string>(['none', 'tsc']);\n\n/**\n * `node` arguments that register `env` before the entry runs, for the build tools the entry transform cannot reach.\n * The preload is a `data:` URL, so `.stars/` gets no generated runtime file; a `data:` URL cannot resolve bare\n * specifiers, so `@wolfstar/env-utilities` is resolved from the project first. When it cannot be resolved nothing is\n * preloaded, and the bot's own import of it reports the missing install.\n */\nexport function envImportArgs(config: ResolvedStarsConfig): string[] {\n\tif (!config.env.enabled || !UNTRANSFORMED_TOOLS.has(config.build.tool)) return [];\n\n\tconst resolved = resolveFromProject(config.root, '@wolfstar/env-utilities');\n\tif (resolved === null) return [];\n\n\tconst source = envModuleSource(config.env.options, pathToFileURL(resolved).href);\n\treturn ['--import', `data:text/javascript,${encodeURIComponent(source)}`];\n}\n\n/**\n * `node` arguments that register the runtime plugins of the installed modules (`ctx.addPlugin`) before the entry\n * runs, for the build tools the entry transform cannot reach. `@wolfstar/http-framework` and every plugin are resolved\n * from the project first, with the `import` condition (both are ESM), because a `data:` URL cannot resolve bare\n * specifiers; the framework is the bot's own copy, so `Client.use` reaches the `Client` the bot constructs. When the\n * framework is not installed nothing is preloaded, and the bot's own import of it reports the missing install.\n */\nexport function moduleImportArgs(config: ResolvedStarsConfig): string[] {\n\tconst plugins = config.runtime?.plugins ?? [];\n\tif (plugins.length === 0 || !UNTRANSFORMED_TOOLS.has(config.build.tool)) return [];\n\n\tconst url = pathToFileURL(`${config.root}/package.json`).href;\n\tlet framework: string;\n\ttry {\n\t\tframework = resolveSync('@wolfstar/http-framework', { url });\n\t} catch {\n\t\treturn [];\n\t}\n\n\tconst source = modulesModuleSource(plugins, {\n\t\tframework,\n\t\tresolve: (from) => {\n\t\t\tif (from.startsWith('file:')) return from;\n\t\t\tif (isAbsolute(from)) return pathToFileURL(from).href;\n\t\t\ttry {\n\t\t\t\treturn resolveSync(from, { url });\n\t\t\t} catch {\n\t\t\t\tthrow cliDiagnostics.DEPENDENCY_MISSING({\n\t\t\t\t\tname: from,\n\t\t\t\t\troot: config.root,\n\t\t\t\t\thint: 'Install the package of the module that registers this plugin.'\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t});\n\treturn ['--import', `data:text/javascript,${encodeURIComponent(source)}`];\n}\n","import { ModuleError, setupModules } from '@wolfstar/kit';\nimport type { ResolvedStarsConfig } from '@wolfstar/schema';\nimport { envModuleSource, modulesModuleSource } from '@wolfstar/vite-server/internal';\nimport { resolve as resolveModule } from 'mlly';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport type { Diagnostic } from 'nostics';\nimport { isAbsolute, join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { cliDiagnostics } from './diagnostics.js';\nimport { UNTRANSFORMED_TOOLS } from './env-import.js';\nimport type { StarsHookable } from './hooks.js';\nimport { findInstalledVersion } from './project.js';\nimport { readOwnPackageJson } from './version.js';\n\n/**\n * Where a module specifier is imported from: a relative or absolute path is a file of the project, a `file:` URL is\n * itself, anything else is a package resolved from the project root — with `mlly`, honouring the `import` condition,\n * because installed modules are ESM-only packages a CommonJS `require.resolve` cannot see.\n */\nasync function resolveSpecifier(root: string, specifier: string): Promise<string> {\n\tif (specifier.startsWith('file:')) return specifier;\n\tif (specifier.startsWith('.') || isAbsolute(specifier)) return pathToFileURL(resolve(root, specifier)).href;\n\treturn resolveModule(specifier, { url: pathToFileURL(`${root}/package.json`).href });\n}\n\n/**\n * Runs `setup` of every module in `modules` (see `@wolfstar/kit`) and returns the configuration carrying what they\n * contributed: `runtime`, and `imports.presets` extended by `ctx.addImports`. Without modules the configuration is\n * returned as it is.\n */\nexport async function installModules(config: ResolvedStarsConfig, hooks: StarsHookable): Promise<ResolvedStarsConfig> {\n\tif (config.modules.length === 0) return config;\n\n\ttry {\n\t\tconst runtime = await setupModules({\n\t\t\tconfig,\n\t\t\thooks,\n\t\t\tversions: { framework: findInstalledVersion(config.root, '@wolfstar/http-framework'), stars: readOwnPackageJson().version },\n\t\t\tload: async (specifier) => import(await resolveSpecifier(config.root, specifier))\n\t\t});\n\n\t\tconst presets = [...config.imports.presets, ...runtime.imports.filter((preset) => !config.imports.presets.includes(preset))];\n\t\treturn { ...config, runtime, imports: { ...config.imports, presets } };\n\t} catch (error) {\n\t\tif (error instanceof ModuleError) {\n\t\t\tthrow cliDiagnostics.MODULE_FAILED({ module: error.moduleName, reason: error.code, message: error.message, cause: error });\n\t\t}\n\n\t\tthrow error;\n\t}\n}\n\n/**\n * The warning for a project whose runtime plugins reach production only through a `node --import` preload, `null`\n * otherwise. It is not one of `config.warnings`: `stars dev` preloads the plugins itself, so there it would be noise\n * on every start. `stars build` and `stars prepare` report it.\n */\nexport function modulesPreloadWarning(config: ResolvedStarsConfig): Diagnostic | null {\n\tif (!needsPreload(config)) return null;\n\treturn cliDiagnostics.MODULES_PRELOAD_REQUIRED({\n\t\ttool: config.build.tool,\n\t\tplugins: [...new Set(config.runtime.plugins.map((plugin) => plugin.module))].join(', ')\n\t});\n}\n\n/** A build tool the entry transform cannot reach, with runtime plugins to register: they need a `node --import` preload. */\nfunction needsPreload(config: ResolvedStarsConfig): boolean {\n\treturn UNTRANSFORMED_TOOLS.has(config.build.tool) && (config.runtime?.plugins.length ?? 0) > 0;\n}\n\nexport interface ModulesPreloadResult {\n\t/** Absolute path of the preload file. */\n\tpath: string;\n\tstatus: 'written' | 'up-to-date' | 'outdated';\n}\n\n/**\n * Writes `.stars/modules.mjs`, the production counterpart of the preload `stars dev` passes to `node`: `node --import\n * ./.stars/modules.mjs <entry>` registers the runtime plugins of the installed modules for the build tools whose entry\n * cannot be transformed (`tsc`, `none`). Its specifiers are bare, so they resolve from the project's `node_modules`\n * like the bot's own imports. `null` when there is nothing to register.\n *\n * With `env` enabled it is preceded by `.stars/env.mjs`, a separate module imported first: imports of one module are\n * all evaluated before its body runs, so the environment could not be loaded ahead of the plugins from the same file,\n * and a plugin reading `process.env` while it is imported would see nothing.\n */\nexport async function prepareModulesPreload(config: ResolvedStarsConfig, check = false): Promise<ModulesPreloadResult | null> {\n\tif (!needsPreload(config)) return null;\n\n\tconst directory = join(config.root, '.stars');\n\tconst path = join(directory, 'modules.mjs');\n\tconst withEnv = config.env?.enabled === true;\n\t// An absolute path is a `file:` URL in the import, like in `moduleImportArgs`: Node rejects a Windows path there.\n\tconst plugins = modulesModuleSource(config.runtime.plugins, { resolve: (from) => (isAbsolute(from) ? pathToFileURL(from).href : from) });\n\tconst files = [\n\t\t{ path, content: withEnv ? `import \"./env.mjs\";\\n${plugins}` : plugins },\n\t\t...(withEnv ? [{ path: join(directory, 'env.mjs'), content: envModuleSource(config.env.options) }] : [])\n\t];\n\n\tif (check) {\n\t\tconst current = await Promise.all(files.map(async (file) => (await readFile(file.path, 'utf-8').catch(() => null)) === file.content));\n\t\treturn { path, status: current.every(Boolean) ? 'up-to-date' : 'outdated' };\n\t}\n\n\tawait mkdir(directory, { recursive: true });\n\tawait Promise.all(files.map((file) => writeFile(file.path, file.content)));\n\treturn { path, status: 'written' };\n}\n","import { readProjectEnvFiles, type ResolvedStarsConfig } from '@wolfstar/schema';\nimport { execFileSync } from 'node:child_process';\nimport { resolveBinary } from './project.js';\n\n/**\n * The variables the bot will load, for the CLI's own lookups (Discord credentials for the tunnel). With the default\n * loader these are the project's env files, read from `env.path`/`env.env`. With `loader: 'varlock'` they are what\n * `varlock load` resolves from the project's `.env.schema` — a dotenv file may be stale or absent there — and nothing\n * when varlock cannot be run, rather than values the bot never sees.\n */\nexport function readProjectEnv(config: ResolvedStarsConfig): Record<string, string> {\n\tconst { path, env = 'development', loader } = config.env.options;\n\tif (loader !== 'varlock') return readProjectEnvFiles(config.root, env, { path });\n\n\tconst binary = resolveBinary(config.root, 'varlock', 'varlock');\n\tif (binary === null) return {};\n\n\ttry {\n\t\t// The way the bot loads it: `@wolfstar/env-utilities` runs `varlock/auto-load` with no `--env` (it ignores\n\t\t// `env.env` with varlock), in the environment `stars dev` gives the bot.\n\t\tconst output = execFileSync(process.execPath, [binary, 'load', '--format', 'json'], {\n\t\t\tcwd: config.root,\n\t\t\t// Same order as `createSupervisor`: `NODE_ENV` is forced to development after `dev.env`, so it can't differ.\n\t\t\tenv: { ...process.env, ...config.dev.env, NODE_ENV: 'development' },\n\t\t\tencoding: 'utf8',\n\t\t\tstdio: ['ignore', 'pipe', 'ignore'],\n\t\t\ttimeout: 30_000\n\t\t});\n\t\tconst values = JSON.parse(output) as Record<string, unknown>;\n\t\treturn Object.fromEntries(\n\t\t\tObject.entries(values)\n\t\t\t\t.filter(([, value]) => value !== undefined && value !== null)\n\t\t\t\t.map(([key, value]) => [key, String(value)])\n\t\t);\n\t} catch {\n\t\treturn {};\n\t}\n}\n","import {\n\tloadConfigFile,\n\tresolveStarsConfig,\n\ttype LoadStarsConfigOptions,\n\ttype ResolveConfigOptions,\n\ttype ResolvedStarsConfig,\n\ttype StarsHookName,\n\ttype StarsHooks\n} from '@wolfstar/schema';\nimport { createHooks, type Hookable } from 'hookable';\nimport { installModules } from './modules.js';\nimport { readProjectEnv } from './project-env.js';\n\nexport type StarsHookable = Hookable<StarsHooks>;\n\n/** What each configuration loaded by {@link loadProject} was resolved from, so `env:options` can re-resolve it. */\nconst sources = new WeakMap<ResolvedStarsConfig, ResolveConfigOptions>();\n\n/** Registers the `hooks` of `stars.config` on a fresh `hookable` instance. */\nexport function createStarsHooks(config: ResolvedStarsConfig): StarsHookable {\n\tconst hooks = createHooks<StarsHooks>();\n\tfor (const [name, callbacks] of Object.entries(config.hooks) as [StarsHookName, readonly StarsHooks[StarsHookName][]][]) {\n\t\tfor (const callback of callbacks) hooks.hook(name, callback);\n\t}\n\n\treturn hooks;\n}\n\n/** Loads `stars.config`, registers its hooks and runs `config:resolved`. */\nexport async function loadProject(options: LoadStarsConfigOptions): Promise<{ config: ResolvedStarsConfig; hooks: StarsHookable }> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst loaded = await loadConfigFile({ cwd, configFile: options.configFile });\n\tconst source: ResolveConfigOptions = { cwd, configFile: loaded.configFile, config: loaded.config, env: options.env };\n\tconst resolved = resolveStarsConfig(source);\n\tconst hooks = createStarsHooks(resolved);\n\t// Modules install before `config:resolved`, so that hook already sees what they contributed.\n\tconst config = await installModules(resolved, hooks);\n\tsources.set(config, source);\n\n\tawait hooks.callHook('config:resolved', config);\n\treturn { config, hooks };\n}\n\n/**\n * Runs `env:options` on a copy of the resolved `env` options and returns a configuration carrying the result, which\n * is what the builders write into the entry. The resolved configuration itself is left untouched.\n *\n * When the hook changes the options, the configuration is resolved again with them, so everything read from the env\n * files — the default `dev.url` port above all — matches what the bot will load.\n */\nexport async function applyEnvOptions(config: ResolvedStarsConfig, hooks: StarsHookable): Promise<ResolvedStarsConfig> {\n\tif (!config.env.enabled) return config;\n\n\tconst options = { ...config.env.options };\n\tawait hooks.callHook('env:options', options, config);\n\n\tconst source = sources.get(config);\n\tif (source === undefined || JSON.stringify(options) === JSON.stringify(config.env.options)) {\n\t\treturn { ...config, env: { ...config.env, options } };\n\t}\n\n\treturn reresolve(config, source, { config: { ...source.config, env: { ...options, enabled: true } } });\n}\n\n/**\n * With `loader: 'varlock'`, resolves the configuration again with the variables `varlock load` returns, so the\n * defaults `stars.config` derives from the environment — the `dev.url` port — match what the bot loads. Every other\n * configuration is returned as-is: the schema reads its env files directly.\n */\nexport function withProjectEnv(config: ResolvedStarsConfig): ResolvedStarsConfig {\n\tconst source = sources.get(config);\n\tif (source === undefined || !config.env.enabled || config.env.options.loader !== 'varlock') return config;\n\treturn reresolve(config, source, { projectEnv: readProjectEnv(config) });\n}\n\nfunction reresolve(previous: ResolvedStarsConfig, source: ResolveConfigOptions, change: Partial<ResolveConfigOptions>): ResolvedStarsConfig {\n\tconst next = { ...source, ...change };\n\tconst resolved = resolveStarsConfig(next);\n\t// Modules ran once, against the first resolution: what they contributed carries over to the new one.\n\tconst config = { ...resolved, runtime: previous.runtime, imports: { ...resolved.imports, presets: previous.imports.presets } };\n\tsources.set(config, next);\n\treturn config;\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -76,6 +76,41 @@ export declare const cliDiagnostics: import("nostics").Diagnostics<{
     why: (_p: {}) => string;
     fix: (_p: {}) => string;
   };
+  readonly DEPLOY_CONFIRMATION_REQUIRED: {
+    why: (_p: {}) => string;
+    fix: (_p: {}) => string;
+  };
+  readonly COMMANDS_DIFFER: {
+    why: (p: {
+      count: number;
+    }) => string;
+    fix: (_p: {
+      count: number;
+    }) => string;
+  };
+  readonly LOCAL_COMMANDS_UNAVAILABLE: {
+    why: (p: {
+      reason: string;
+      fix: string;
+    }) => string;
+    fix: (p: {
+      reason: string;
+      fix: string;
+    }) => string;
+  };
+  readonly DOCTOR_FAILED: {
+    why: (p: {
+      count: number;
+    }) => string;
+  };
+  readonly UNKNOWN_SHELL: {
+    why: (p: {
+      shell: string;
+    }) => string;
+    fix: (_p: {
+      shell: string;
+    }) => string;
+  };
   readonly INVALID_THEME: {
     why: (p: {
       theme: string;
@@ -86,6 +121,18 @@ export declare const cliDiagnostics: import("nostics").Diagnostics<{
       themes: string;
     }) => string;
   };
+  readonly INVALID_OPTION: {
+    why: (p: {
+      option: string;
+      value: string;
+      allowed: string;
+    }) => string;
+    fix: (p: {
+      option: string;
+      value: string;
+      allowed: string;
+    }) => string;
+  };
   readonly CODEGEN_OUTDATED: {
     why: (_p: {}) => string;
   };
@@ -101,6 +148,28 @@ export declare const cliDiagnostics: import("nostics").Diagnostics<{
       hint: string;
     }) => string;
   };
+  readonly MODULE_FAILED: {
+    why: (p: {
+      module: string;
+      reason: string;
+      message: string;
+    }) => string;
+    fix: (p: {
+      module: string;
+      reason: string;
+      message: string;
+    }) => string;
+  };
+  readonly MODULES_PRELOAD_REQUIRED: {
+    why: (p: {
+      tool: string;
+      plugins: string;
+    }) => string;
+    fix: (_p: {
+      tool: string;
+      plugins: string;
+    }) => string;
+  };
   readonly CODEGEN_FAILED: {
     why: (p: {
       code: number | null;
@@ -160,6 +229,12 @@ interface Theme {
   success: string;
   warning: string;
   error: string;
+  /** The `info`, `debug` and `trace` level badges of the dashboard's log stream. */
+  info: string;
+  debug: string;
+  trace: string;
+  /** Names worth finding in a log line: a command, a piece, a channel that is switched on. */
+  accent: string;
   text: string | undefined;
   /** Foreground of a badge painted on `success`, `warning` or `busy`. */
   onBright: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/run.ts","../src/utils/errors.ts","../src/utils/diagnostics.ts","../src/utils/output-mode.ts","../src/utils/theme.ts"],"mappings":";;wBA8BsB,QAAQ,kBAAyC;;;qBCxB1D;WACZ;WACA;WACA;WACA;WACA;WACA;;YAGW,mBAAmB,uBAAuB;;;;;;wBAehC,YAAY,iBAAiB;wBAuBnC,WAAW,iBAAiB;;;;;;;;;;;;;;;;qBCtC/B,kCAAc;;IAKxB,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;MAAQ;MAAgB;;IAC3B,MAAG;MAAQ;MAAgB;;;;IAI3B,MAAG;MAAQ;;;;IAGX,MAAG;MAAQ;;IACX,MAAG;MAAS;;;;IAGZ,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;MAAQ;MAAe;;IAC1B,MAAG;MAAQ;MAAe;;;;IAG1B,MAAG;;;IAGH,MAAG;MAAQ;MAAc;MAAc;;IACvC,MAAG;MAAQ;MAAc;MAAc;;;;IAGvC,MAAG;MAAQ;MAAqB;;;;KAKvB,iCAAiC;;;KClEjC;UAEK;;EAEhB;EACA,MAAM,OAAO;;EAEb;;EAEA;EACA;EACA;;EAEA;;;;;;;wBAUe,kBAAkB,UAAS,2BAAgC;wBAkB3D,gBAAgB,MAAK,OAAO;;;;wBAU5B,eAAe,MAAK,OAAO,YAA0B;;;;wBASrD,qBAAqB,MAAK,OAAO;;;;qBCvDpC;KACD,uBAAuB;KACvB,YAAY,QAAQ;;;;;UAMf;;EAEhB;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;;KAGW,mBAAmB;qBAElB,QAAQ,SAAS,OAAO,WAAW;wBA4FhC,aAAa,SAAS,cAAc,MAAK,OAAO,aAA2B;UAI1E;;EAEhB;EACA,MAAM,OAAO;;EAEb,QAAQ;;;;;;wBAOO,sBAAsB,MAAM,KAAmB,SAAS,sBAAsB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/run.ts","../src/utils/errors.ts","../src/utils/diagnostics.ts","../src/utils/output-mode.ts","../src/utils/theme.ts"],"mappings":";;wBA8BsB,QAAQ,kBAAyC;;;qBCxB1D;WACZ;WACA;WACA;WACA;WACA;WACA;;YAGW,mBAAmB,uBAAuB;;;;;;wBAgBhC,YAAY,iBAAiB;wBAuBnC,WAAW,iBAAiB;;;;;;;;;;;;;;;;qBCvC/B,kCAAc;;IAKxB,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;MAAQ;MAAgB;;IAC3B,MAAG;MAAQ;MAAgB;;;;IAI3B,MAAG;MAAQ;;;;IAGX,MAAG;MAAQ;;IACX,MAAG;MAAS;;;;IAGZ,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;IACH,MAAG;;;IAGH,MAAG;MAAQ;;IACX,MAAG;MAAS;;;;IAGZ,MAAG;MAAQ;MAAgB;;IAC3B,MAAG;MAAQ;MAAgB;;;;IAG3B,MAAG;MAAQ;;;;IAGX,MAAG;MAAQ;;IACX,MAAG;MAAS;;;;IAGZ,MAAG;MAAQ;MAAe;;IAC1B,MAAG;MAAQ;MAAe;;;;IAG1B,MAAG;MAAQ;MAAgB;MAAe;;IAC1C,MAAG;MAAQ;MAAgB;MAAe;;;;IAG1C,MAAG;;;IAGH,MAAG;MAAQ;MAAc;MAAc;;IACvC,MAAG;MAAQ;MAAc;MAAc;;;;IAGvC,MAAG;MAAQ;MAAgB;MAAgB;;IAC3C,MAAG;MAAQ;MAAgB;MAAgB;;;;IAgB3C,MAAG;MAAQ;MAAc;;IAEzB,MAAG;MAAS;MAAc;;;;IAI1B,MAAG;MAAQ;MAAqB;;;;KAKvB,iCAAiC;;;KChHjC;UAEK;;EAEhB;EACA,MAAM,OAAO;;EAEb;;EAEA;EACA;EACA;;EAEA;;;;;;;wBAUe,kBAAkB,UAAS,2BAAgC;wBAkB3D,gBAAgB,MAAK,OAAO;;;;wBAU5B,eAAe,MAAK,OAAO,YAA0B;;;;wBASrD,qBAAqB,MAAK,OAAO;;;;qBCvDpC;KACD,uBAAuB;KACvB,YAAY,QAAQ;;;;;UAMf;;EAEhB;EACA;EACA;;EAEA;EACA;EACA;EACA;;EAEA;EACA;EACA;;EAEA;EACA;;EAEA;;EAEA;;KAGW,mBAAmB;qBAElB,QAAQ,SAAS,OAAO,WAAW;wBAoHhC,aAAa,SAAS,cAAc,MAAK,OAAO,aAA2B;UAI1E;;EAEhB;EACA,MAAM,OAAO;;EAEb,QAAQ;;;;;;wBAOO,sBAAsB,MAAM,KAAmB,SAAS,sBAAsB"}

package/dist/index.js

@@ -1,8 +1,8 @@
-import { t as runMain } from "./run-Ddwrxe1O.js";
+import { t as runMain } from "./run-DMM2YlP3.js";
 import { i as shouldUseColor, n as prefersReducedMotion, r as resolveOutputMode, t as isCIEnvironment } from "./output-mode-Bp7Da8vJ.js";
-import { n as exitCodeOf, r as formatError, t as ExitCode } from "./errors-Crt4hu0b.js";
-import { t as cliDiagnostics } from "./diagnostics-CZBVxlpj.js";
-import { n as THEME_SETTINGS, o as resolveTheme, s as resolveThemeSetting, t as THEMES } from "./theme-3Fc_LI-2.js";
+import { n as exitCodeOf, r as formatError, t as ExitCode } from "./errors-COFWKKKw.js";
+import { t as cliDiagnostics } from "./diagnostics-BysbNnPD.js";
+import { n as THEME_SETTINGS, o as resolveTheme, s as resolveThemeSetting, t as THEMES } from "./theme-yS2h5dd_.js";
 import { configDiagnostics, loadStarsConfig } from "@wolfstar/schema";
 
 export { ExitCode, THEMES, THEME_SETTINGS, cliDiagnostics, configDiagnostics, exitCodeOf, formatError, isCIEnvironment, loadStarsConfig, prefersReducedMotion, resolveOutputMode, resolveTheme, resolveThemeSetting, runMain, shouldUseColor };

package/dist/{info-CdiQajgn.js → info-CKJVMWIT.js}

@@ -1,7 +1,7 @@
 import { t as readOwnPackageJson } from "./version-BzclCE19.js";
 import { i as shouldUseColor, r as resolveOutputMode } from "./output-mode-Bp7Da8vJ.js";
-import { t as findInstalledVersion } from "./project-MD4dIo2X.js";
-import { a as projectArgs, n as loadProject, o as resolveCwd, t as applyEnvOptions } from "./hooks-H9kjLCMk.js";
+import { t as findInstalledVersion } from "./project-zlQStwsf.js";
+import { a as modulesPreloadWarning, d as resolveCwd, n as loadProject, t as applyEnvOptions, u as projectArgs } from "./hooks-Cy6F2bhH.js";
 import { defineCommand } from "citty";
 import { relative } from "node:path";
 import { displayPath } from "@wolfstar/schema";
@@ -34,7 +34,11 @@ function collectInfo(config) {
 		future: config.future,
 		env: config.env,
 		hooks: Object.keys(config.hooks),
-		warnings: config.warnings.map((warning) => `${warning.code}: ${warning.message}`),
+		modules: {
+			installed: (config.runtime?.modules ?? []).map((module) => module.name),
+			plugins: (config.runtime?.plugins ?? []).map((plugin) => `${plugin.module} → ${plugin.export} from ${plugin.from}`)
+		},
+		warnings: [...config.warnings, modulesPreloadWarning(config)].filter((warning) => warning !== null).map((warning) => `${warning.code}: ${warning.message}`),
 		options: {
 			tsdown: Object.keys(config.tsdown),
 			vite: Object.keys(config.vite)
@@ -77,12 +81,19 @@ function formatInfo(info, useColor) {
 			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"))
+			row("log file", info.dev.logFile ? show(info.dev.logFile) : colors.dim("disabled")),
+			row("log dir", info.dev.logs.dir ? `${show(info.dev.logs.dir)} (keeps ${info.dev.logs.keep})` : colors.dim("disabled")),
+			row("layout", info.dev.layout),
+			row("channels", info.dev.logs.channels?.join(", ") ?? colors.dim("all")),
+			row("levels", info.dev.logs.levels.join(", ")),
+			row("commands", `refresh: ${info.dev.commands.refresh}`),
+			row("hmr", info.dev.hmr ? "left to the bot when it hot reloads" : colors.dim("always restart"))
 		]),
 		section("Codegen", [row("i18n", info.codegen.i18n ? `${show(info.codegen.i18n.locales)} → ${show(info.codegen.i18n.output)}` : colors.dim("disabled"))]),
 		section("Future", [row("compat", `v${info.future.compatibilityVersion} defaults`), ...info.warnings.map((warning) => row("warning", colors.yellow(warning)))]),
 		section("Env", [row("register", info.env.enabled ? colors.green(describeEnvOptions(info.env.options)) : colors.dim("disabled"))]),
 		section("Hooks", [row("registered", info.hooks.join(", ") || colors.dim("none"))]),
+		section("Modules", [row("installed", info.modules.installed.join(", ") || colors.dim("none")), ...info.modules.plugins.map((plugin) => row("plugin", plugin))]),
 		section("Experimental", [
 			row("vite", flag(info.experimental.enableVite, colors)),
 			row("nitro", flag(info.experimental.enableNitro, colors)),
@@ -148,4 +159,4 @@ var info_default = defineCommand({
 
 //#endregion
 export { info_default as default };
-//# sourceMappingURL=info-CdiQajgn.js.map
+//# sourceMappingURL=info-CKJVMWIT.js.map