@wolfstar/cli 2.6.0-next-20261007152629 → 2.6.0

package/dist/info-C_YDcVul.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-C_YDcVul.js","names":[],"sources":["../src/commands/info.ts"],"sourcesContent":["import { displayPath, type ResolvedStarsConfig, type StarsEnvSetupOptions } from '@wolfstar/schema';\nimport { defineCommand } from 'citty';\nimport { createColors } from 'colorette';\nimport { arch, platform } from 'node:os';\nimport { relative } from 'node:path';\nimport { projectArgs, resolveCwd, type ProjectArgs } from '../utils/args.js';\nimport { applyEnvOptions, loadProject } from '../utils/hooks.js';\nimport { modulesPreloadWarning } from '../utils/modules.js';\nimport { resolveOutputMode, shouldUseColor } from '../utils/output-mode.js';\nimport { findInstalledVersion } from '../utils/project.js';\nimport { readOwnPackageJson } from '../utils/version.js';\n\nexport interface InfoOptions extends ProjectArgs {\n\tjson?: boolean;\n\tstdout?: NodeJS.WritableStream;\n}\n\nexport interface ProjectInfo {\n\tcli: { version: string; node: string; platform: string; outputMode: 'tui' | 'plain' };\n\tproject: {\n\t\tcwd: string;\n\t\troot: string;\n\t\tconfigFile: string | null;\n\t\tname: string | null;\n\t\tversion: string | null;\n\t\tentry: string;\n\t\tframeworkVersion: string | null;\n\t};\n\tbuild: ResolvedStarsConfig['build'];\n\tdev: ResolvedStarsConfig['dev'];\n\tcodegen: ResolvedStarsConfig['codegen'];\n\timports: ResolvedStarsConfig['imports'];\n\texperimental: ResolvedStarsConfig['experimental'];\n\tfuture: ResolvedStarsConfig['future'];\n\tenv: ResolvedStarsConfig['env'];\n\t/** The names of the hooks registered in `stars.config`, flattened (`build:done`). */\n\thooks: string[];\n\t/** The installed modules, and the runtime plugins they registered (`module → export from package`). */\n\tmodules: { installed: string[]; plugins: string[] };\n\t/** Non-fatal configuration diagnostics, as `CODE: message`. */\n\twarnings: string[];\n\t/**\n\t * The option names set in the `tsdown`/`vite` blocks. Only the names: the values hold plugins and callbacks,\n\t * which neither serialize to JSON nor read usefully on a terminal.\n\t */\n\toptions: { tsdown: string[]; vite: string[] };\n}\n\nexport function collectInfo(config: ResolvedStarsConfig): ProjectInfo {\n\treturn {\n\t\tcli: {\n\t\t\tversion: readOwnPackageJson().version,\n\t\t\tnode: process.version,\n\t\t\tplatform: `${platform()} ${arch()}`,\n\t\t\toutputMode: resolveOutputMode()\n\t\t},\n\t\tproject: {\n\t\t\tcwd: config.cwd,\n\t\t\troot: config.root,\n\t\t\tconfigFile: config.configFile,\n\t\t\tname: config.packageJson?.name ?? null,\n\t\t\tversion: config.packageJson?.version ?? null,\n\t\t\tentry: config.entry,\n\t\t\tframeworkVersion: findInstalledVersion(config.root, '@wolfstar/http-framework')\n\t\t},\n\t\tbuild: config.build,\n\t\tdev: config.dev,\n\t\tcodegen: config.codegen,\n\t\timports: config.imports,\n\t\texperimental: config.experimental,\n\t\tfuture: config.future,\n\t\tenv: config.env,\n\t\thooks: Object.keys(config.hooks),\n\t\tmodules: {\n\t\t\tinstalled: (config.runtime?.modules ?? []).map((module) => module.name),\n\t\t\tplugins: (config.runtime?.plugins ?? []).map((plugin) => `${plugin.module} → ${plugin.export} from ${plugin.from}`)\n\t\t},\n\t\twarnings: [...config.warnings, modulesPreloadWarning(config)]\n\t\t\t.filter((warning) => warning !== null)\n\t\t\t.map((warning) => `${warning.code}: ${warning.message}`),\n\t\toptions: { tsdown: Object.keys(config.tsdown), vite: Object.keys(config.vite) }\n\t};\n}\n\nexport function formatInfo(info: ProjectInfo, useColor: boolean): string {\n\tconst colors = createColors({ useColor });\n\tconst { root } = info.project;\n\tconst show = (path: string | null) => (path === null ? colors.dim('none') : displayPath(root, path));\n\tconst row = (label: string, value: string) => `  ${colors.dim(label.padEnd(12))}${value}`;\n\tconst section = (title: string, rows: string[]) => [colors.bold(title), ...rows].join('\\n');\n\n\treturn [\n\t\tsection(`stars ${colors.green(`v${info.cli.version}`)}`, [\n\t\t\trow('node', info.cli.node),\n\t\t\trow('platform', info.cli.platform),\n\t\t\trow('output', info.cli.outputMode),\n\t\t\trow(\n\t\t\t\t'framework',\n\t\t\t\tinfo.project.frameworkVersion\n\t\t\t\t\t? `@wolfstar/http-framework v${info.project.frameworkVersion}`\n\t\t\t\t\t: colors.yellow('@wolfstar/http-framework not installed')\n\t\t\t)\n\t\t]),\n\t\tsection('Project', [\n\t\t\trow(\n\t\t\t\t'name',\n\t\t\t\tinfo.project.name\n\t\t\t\t\t? `${info.project.name}${info.project.version ? colors.dim(` v${info.project.version}`) : ''}`\n\t\t\t\t\t: colors.dim('unnamed')\n\t\t\t),\n\t\t\trow('root', root),\n\t\t\trow(\n\t\t\t\t'config',\n\t\t\t\tinfo.project.configFile ? relative(root, info.project.configFile) || info.project.configFile : colors.dim('none (defaults)')\n\t\t\t),\n\t\t\trow('entry', show(info.project.entry))\n\t\t]),\n\t\tsection('Build', [\n\t\t\trow('tool', info.build.tool),\n\t\t\t// Which file the build tool is configured from: its own, or this project's `stars.config`.\n\t\t\trow('config', info.build.configFile ? show(info.build.configFile) : colors.dim('stars.config')),\n\t\t\trow('options', describeOptions(info, colors)),\n\t\t\trow('outDir', show(info.build.outDir)),\n\t\t\trow('tsconfig', show(info.build.tsconfig)),\n\t\t\t// Everything `stars typecheck` checks: the generated app and node projects from compatibility version 6 (a `tsc`\n\t\t\t// or `none` project keeps its own tsconfig for the bot and gets the node one on top).\n\t\t\trow('typechecks', info.dev.typecheck.projects.length > 0 ? info.dev.typecheck.projects.map(show).join(', ') : colors.dim('none')),\n\t\t\trow('runs', show(info.build.output))\n\t\t]),\n\t\tsection('Dev', [\n\t\t\trow('watch', info.dev.watch.map(show).join(', ')),\n\t\t\trow('debounce', `${info.dev.debounce}ms`),\n\t\t\trow('node args', info.dev.nodeArgs.join(' ') || colors.dim('none')),\n\t\t\trow('args', info.dev.args.join(' ') || colors.dim('none')),\n\t\t\trow('url', info.dev.url ?? colors.dim('unknown, set dev.url or HTTP_PORT')),\n\t\t\trow('health', info.dev.health ?? colors.dim('none')),\n\t\t\trow(\n\t\t\t\t'typecheck',\n\t\t\t\tinfo.dev.typecheck.enabled ? `${info.dev.typecheck.checker} → ${show(info.dev.typecheck.tsconfig)}` : colors.dim('disabled')\n\t\t\t),\n\t\t\trow('tunnel', describeTunnel(info.dev.tunnel, colors)),\n\t\t\trow('log file', info.dev.logFile ? show(info.dev.logFile) : colors.dim('disabled')),\n\t\t\trow('log dir', info.dev.logs.dir ? `${show(info.dev.logs.dir)} (keeps ${info.dev.logs.keep})` : colors.dim('disabled')),\n\t\t\trow('layout', info.dev.layout),\n\t\t\trow('mouse', info.dev.mouse ? 'clickable dashboard' : colors.dim('left to the terminal')),\n\t\t\trow('channels', info.dev.logs.channels?.join(', ') ?? colors.dim('all')),\n\t\t\trow('levels', info.dev.logs.levels.join(', ')),\n\t\t\trow('commands', `refresh: ${info.dev.commands.refresh}`),\n\t\t\trow('hmr', info.dev.hmr ? 'left to the bot when it hot reloads' : colors.dim('always restart'))\n\t\t]),\n\t\tsection('Codegen', [\n\t\t\trow('i18n', info.codegen.i18n ? `${show(info.codegen.i18n.locales)} → ${show(info.codegen.i18n.output)}` : colors.dim('disabled')),\n\t\t\trow('commands', info.codegen.commands ? show(info.codegen.commands.output) : colors.dim('disabled'))\n\t\t]),\n\t\tsection('Future', [\n\t\t\trow('compat', `v${info.future.compatibilityVersion} defaults`),\n\t\t\t...info.warnings.map((warning) => row('warning', colors.yellow(warning)))\n\t\t]),\n\t\tsection('Env', [row('register', info.env.enabled ? colors.green(describeEnvOptions(info.env.options)) : colors.dim('disabled'))]),\n\t\tsection('Hooks', [row('registered', info.hooks.join(', ') || colors.dim('none'))]),\n\t\tsection('Modules', [\n\t\t\trow('installed', info.modules.installed.join(', ') || colors.dim('none')),\n\t\t\t...info.modules.plugins.map((plugin) => row('plugin', plugin))\n\t\t]),\n\t\tsection('Experimental', [\n\t\t\trow('vite', flag(info.experimental.enableVite, colors)),\n\t\t\trow('nitro', flag(info.experimental.enableNitro, colors)),\n\t\t\t...(info.experimental.enableNitro ? [row('nitro preset', info.experimental.nitro.preset)] : []),\n\t\t\trow('external', flag(info.experimental.enableExternalVite, colors))\n\t\t]),\n\t\tsection('Imports', [\n\t\t\trow('auto', info.imports.enabled ? colors.green('enabled') : colors.dim('disabled')),\n\t\t\trow('dirs', info.imports.dirs.map(show).join(', ')),\n\t\t\trow('presets', info.imports.presets.join(', ') || colors.dim('none')),\n\t\t\trow('dts', show(info.imports.dts))\n\t\t])\n\t].join('\\n\\n');\n}\n\nfunction describeOptions(info: ProjectInfo, colors: ReturnType<typeof createColors>): string {\n\tconst names = info.build.tool === 'vite' ? info.options.vite : info.options.tsdown;\n\treturn names.length > 0 ? names.join(', ') : colors.dim('none');\n}\n\nfunction describeEnvOptions(options: Readonly<StarsEnvSetupOptions>): string {\n\tconst entries = Object.entries(options).map(([key, value]) => `${key} ${String(value)}`);\n\treturn entries.length > 0 ? `enabled (${entries.join(', ')})` : 'enabled';\n}\n\nfunction flag(enabled: boolean, colors: ReturnType<typeof createColors>): string {\n\treturn enabled ? colors.green('enabled') : colors.dim('disabled');\n}\n\nfunction describeTunnel(tunnel: ResolvedStarsConfig['dev']['tunnel'], colors: ReturnType<typeof createColors>): string {\n\tswitch (tunnel.mode) {\n\t\tcase 'quick':\n\t\t\treturn 'cloudflared quick tunnel';\n\t\tcase 'url':\n\t\t\treturn tunnel.url;\n\t\tdefault:\n\t\t\treturn colors.dim('disabled');\n\t}\n}\n\nexport async function runInfo(options: InfoOptions): Promise<void> {\n\tconst stdout = options.stdout ?? process.stdout;\n\tconst project = await loadProject({ cwd: resolveCwd(options), configFile: options.config });\n\t// What the build would use: `env:options` may change the env files.\n\tconst config = await applyEnvOptions(project.config, project.hooks);\n\tconst info = collectInfo(config);\n\tstdout.write(`${options.json ? JSON.stringify(info, null, 2) : formatInfo(info, shouldUseColor())}\\n`);\n}\n\nexport default defineCommand({\n\tmeta: {\n\t\tname: 'info',\n\t\tdescription: 'Print the resolved project configuration and environment'\n\t},\n\targs: {\n\t\t...projectArgs,\n\t\tjson: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Print machine-readable JSON',\n\t\t\tdefault: false\n\t\t}\n\t},\n\tasync run({ args }) {\n\t\tawait runInfo({ config: args.config, cwd: args.cwd, json: args.json });\n\t}\n});\n"],"mappings":"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"}

package/dist/{run-DlNY1QM1.js → run-BkfjbY7l.js}

@@ -1,4 +1,4 @@
-import { t as commands } from "./commands-3Tgwy6cj.js";
+import { t as commands } from "./commands-BiY_99sF.js";
 import { t as readOwnPackageJson } from "./version-BzclCE19.js";
 import { n as exitCodeOf, r as formatError } from "./errors-COFWKKKw.js";
 import { defineCommand, renderUsage, runCommand } from "citty";
@@ -52,4 +52,4 @@ async function runMain(argv = process.argv.slice(2)) {
 
 //#endregion
 export { runMain as t };
-//# sourceMappingURL=run-DlNY1QM1.js.map
+//# sourceMappingURL=run-BkfjbY7l.js.map

package/dist/{run-DlNY1QM1.js.map → run-BkfjbY7l.js.map}

@@ -1 +1 @@
-{"version":3,"file":"run-DlNY1QM1.js","names":["_runCommand"],"sources":["../src/main.ts","../src/run.ts"],"sourcesContent":["import { defineCommand, type CommandDef } from 'citty';\nimport { commands } from './commands/index.js';\nimport { readOwnPackageJson } from './utils/version.js';\n\n// citty types each command by its own arguments; the registry needs the erased form.\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyCommand = CommandDef<any>;\n\nconst packageJson = readOwnPackageJson();\n\nexport const main = defineCommand({\n\tmeta: {\n\t\tname: 'stars',\n\t\tversion: packageJson.version,\n\t\tdescription: packageJson.description\n\t},\n\tsubCommands: commands\n}) as AnyCommand;\n","import { renderUsage, runCommand as _runCommand, type CommandDef } from 'citty';\nimport process from 'node:process';\nimport { commands } from './commands/index.js';\nimport { main } from './main.js';\nimport { exitCodeOf, formatError } from './utils/errors.js';\nimport { readOwnPackageJson } from './utils/version.js';\n\n// citty types each command by its own arguments; the registry needs the erased form.\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyCommand = CommandDef<any>;\n\n/**\n * Walks the command names of `stars <command> [<subcommand>] --help` so nested commands (`stars commands clean`)\n * render their own usage instead of their parent's.\n */\nasync function resolveHelpTarget(names: string[]): Promise<AnyCommand | null> {\n\tconst [first, ...rest] = names;\n\tif (!first || !Object.hasOwn(commands, first)) return null;\n\n\tlet command = await commands[first]!();\n\tfor (const name of rest) {\n\t\tconst resolved = typeof command.subCommands === 'function' ? await command.subCommands() : await command.subCommands;\n\t\tconst child: unknown = (resolved as Record<string, unknown> | undefined)?.[name];\n\t\tif (!child) break;\n\t\tcommand = (typeof child === 'function' ? await child() : child) as AnyCommand;\n\t}\n\n\treturn command;\n}\n\nexport async function runMain(argv: string[] = process.argv.slice(2)): Promise<void> {\n\tif (argv.includes('--version') || argv.includes('-V')) {\n\t\tconsole.log(readOwnPackageJson().version);\n\t\tprocess.exit(0);\n\t}\n\n\tif (argv.length === 0 || argv.includes('--help') || argv.includes('-h')) {\n\t\t// citty's showUsage logs through consola, which is muted in some environments; render and print directly.\n\t\tconst command = await resolveHelpTarget(argv.filter((argument) => !argument.startsWith('-')));\n\t\tconsole.log(await (command ? renderUsage(command, main) : renderUsage(main)));\n\t\tprocess.exit(0);\n\t}\n\n\ttry {\n\t\tawait _runCommand(main, { rawArgs: argv });\n\t} catch (error) {\n\t\tconsole.error(await formatError(error));\n\t\tprocess.exit(exitCodeOf(error));\n\t}\n}\n"],"mappings":";;;;;;;AAQA,MAAM,cAAc,mBAAmB;AAEvC,MAAa,OAAO,cAAc;CACjC,MAAM;EACL,MAAM;EACN,SAAS,YAAY;EACrB,aAAa,YAAY;CAC1B;CACA,aAAa;AACd,CAAC;;;;;;;;ACFD,eAAe,kBAAkB,OAA6C;CAC7E,MAAM,CAAC,OAAO,GAAG,QAAQ;CACzB,IAAI,CAAC,SAAS,CAAC,OAAO,OAAO,UAAU,KAAK,GAAG,OAAO;CAEtD,IAAI,UAAU,MAAM,SAAS,MAAM,CAAE;CACrC,KAAK,MAAM,QAAQ,MAAM;EAExB,MAAM,SADW,OAAO,QAAQ,gBAAgB,aAAa,MAAM,QAAQ,YAAY,IAAI,MAAM,QAAQ,YACzE,GAA2C;EAC3E,IAAI,CAAC,OAAO;EACZ,UAAW,OAAO,UAAU,aAAa,MAAM,MAAM,IAAI;CAC1D;CAEA,OAAO;AACR;AAEA,eAAsB,QAAQ,OAAiB,QAAQ,KAAK,MAAM,CAAC,GAAkB;CACpF,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,IAAI,GAAG;EACtD,QAAQ,IAAI,mBAAmB,CAAC,CAAC,OAAO;EACxC,QAAQ,KAAK,CAAC;CACf;CAEA,IAAI,KAAK,WAAW,KAAK,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;EAExE,MAAM,UAAU,MAAM,kBAAkB,KAAK,QAAQ,aAAa,CAAC,SAAS,WAAW,GAAG,CAAC,CAAC;EAC5F,QAAQ,IAAI,OAAO,UAAU,YAAY,SAAS,IAAI,IAAI,YAAY,IAAI,EAAE;EAC5E,QAAQ,KAAK,CAAC;CACf;CAEA,IAAI;EACH,MAAMA,WAAY,MAAM,EAAE,SAAS,KAAK,CAAC;CAC1C,SAAS,OAAO;EACf,QAAQ,MAAM,MAAM,YAAY,KAAK,CAAC;EACtC,QAAQ,KAAK,WAAW,KAAK,CAAC;CAC/B;AACD"}
+{"version":3,"file":"run-BkfjbY7l.js","names":["_runCommand"],"sources":["../src/main.ts","../src/run.ts"],"sourcesContent":["import { defineCommand, type CommandDef } from 'citty';\nimport { commands } from './commands/index.js';\nimport { readOwnPackageJson } from './utils/version.js';\n\n// citty types each command by its own arguments; the registry needs the erased form.\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyCommand = CommandDef<any>;\n\nconst packageJson = readOwnPackageJson();\n\nexport const main = defineCommand({\n\tmeta: {\n\t\tname: 'stars',\n\t\tversion: packageJson.version,\n\t\tdescription: packageJson.description\n\t},\n\tsubCommands: commands\n}) as AnyCommand;\n","import { renderUsage, runCommand as _runCommand, type CommandDef } from 'citty';\nimport process from 'node:process';\nimport { commands } from './commands/index.js';\nimport { main } from './main.js';\nimport { exitCodeOf, formatError } from './utils/errors.js';\nimport { readOwnPackageJson } from './utils/version.js';\n\n// citty types each command by its own arguments; the registry needs the erased form.\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyCommand = CommandDef<any>;\n\n/**\n * Walks the command names of `stars <command> [<subcommand>] --help` so nested commands (`stars commands clean`)\n * render their own usage instead of their parent's.\n */\nasync function resolveHelpTarget(names: string[]): Promise<AnyCommand | null> {\n\tconst [first, ...rest] = names;\n\tif (!first || !Object.hasOwn(commands, first)) return null;\n\n\tlet command = await commands[first]!();\n\tfor (const name of rest) {\n\t\tconst resolved = typeof command.subCommands === 'function' ? await command.subCommands() : await command.subCommands;\n\t\tconst child: unknown = (resolved as Record<string, unknown> | undefined)?.[name];\n\t\tif (!child) break;\n\t\tcommand = (typeof child === 'function' ? await child() : child) as AnyCommand;\n\t}\n\n\treturn command;\n}\n\nexport async function runMain(argv: string[] = process.argv.slice(2)): Promise<void> {\n\tif (argv.includes('--version') || argv.includes('-V')) {\n\t\tconsole.log(readOwnPackageJson().version);\n\t\tprocess.exit(0);\n\t}\n\n\tif (argv.length === 0 || argv.includes('--help') || argv.includes('-h')) {\n\t\t// citty's showUsage logs through consola, which is muted in some environments; render and print directly.\n\t\tconst command = await resolveHelpTarget(argv.filter((argument) => !argument.startsWith('-')));\n\t\tconsole.log(await (command ? renderUsage(command, main) : renderUsage(main)));\n\t\tprocess.exit(0);\n\t}\n\n\ttry {\n\t\tawait _runCommand(main, { rawArgs: argv });\n\t} catch (error) {\n\t\tconsole.error(await formatError(error));\n\t\tprocess.exit(exitCodeOf(error));\n\t}\n}\n"],"mappings":";;;;;;;AAQA,MAAM,cAAc,mBAAmB;AAEvC,MAAa,OAAO,cAAc;CACjC,MAAM;EACL,MAAM;EACN,SAAS,YAAY;EACrB,aAAa,YAAY;CAC1B;CACA,aAAa;AACd,CAAC;;;;;;;;ACFD,eAAe,kBAAkB,OAA6C;CAC7E,MAAM,CAAC,OAAO,GAAG,QAAQ;CACzB,IAAI,CAAC,SAAS,CAAC,OAAO,OAAO,UAAU,KAAK,GAAG,OAAO;CAEtD,IAAI,UAAU,MAAM,SAAS,MAAM,CAAE;CACrC,KAAK,MAAM,QAAQ,MAAM;EAExB,MAAM,SADW,OAAO,QAAQ,gBAAgB,aAAa,MAAM,QAAQ,YAAY,IAAI,MAAM,QAAQ,YACzE,GAA2C;EAC3E,IAAI,CAAC,OAAO;EACZ,UAAW,OAAO,UAAU,aAAa,MAAM,MAAM,IAAI;CAC1D;CAEA,OAAO;AACR;AAEA,eAAsB,QAAQ,OAAiB,QAAQ,KAAK,MAAM,CAAC,GAAkB;CACpF,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,IAAI,GAAG;EACtD,QAAQ,IAAI,mBAAmB,CAAC,CAAC,OAAO;EACxC,QAAQ,KAAK,CAAC;CACf;CAEA,IAAI,KAAK,WAAW,KAAK,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;EAExE,MAAM,UAAU,MAAM,kBAAkB,KAAK,QAAQ,aAAa,CAAC,SAAS,WAAW,GAAG,CAAC,CAAC;EAC5F,QAAQ,IAAI,OAAO,UAAU,YAAY,SAAS,IAAI,IAAI,YAAY,IAAI,EAAE;EAC5E,QAAQ,KAAK,CAAC;CACf;CAEA,IAAI;EACH,MAAMA,WAAY,MAAM,EAAE,SAAS,KAAK,CAAC;CAC1C,SAAS,OAAO;EACf,QAAQ,MAAM,MAAM,YAAY,KAAK,CAAC;EACtC,QAAQ,KAAK,WAAW,KAAK,CAAC;CAC/B;AACD"}

package/dist/{tui-CB_qk2Z1.js → tui-BOkOx13K.js}

@@ -9,6 +9,7 @@ import { stripVTControlCharacters } from "node:util";
 import { Box, Text, render, useInput, useWindowSize } from "ink";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { PassThrough } from "node:stream";
 import { StringDecoder } from "node:string_decoder";
 
 //#region src/dev/tui/ink/hooks/useLogVersion.ts
@@ -364,6 +365,13 @@ function useUptime(startedAt) {
 
 //#endregion
 //#region src/dev/tui/ink/components/Sidebar.tsx
+/** The region of the sidebar at a cell, if a click there does something. */
+function findSidebarRegion(regions, row, column) {
+	return regions.find((region) => region.row === row && (region.kind !== "item" || column >= region.start && column < region.end)) ?? null;
+}
+/** The padding of the sidebar, then the indentation of the lines of a group. */
+const PADDING = 1;
+const INDENT = 2;
 const LEVEL_TOKENS = {
 	error: "error",
 	warn: "warning",
@@ -411,7 +419,7 @@ function readFrameworkVersion(root) {
 * short terminal the key help goes first, then the filters' own hints: the status and the filters are what it is for.
 */
 function Sidebar(props) {
-	const { status, config, counters, filter, channels, focus, collapsed, live, grouped, frame, elapsedMs, width, height, confirmQuit } = props;
+	const { status, config, counters, filter, channels, focus, collapsed, live, grouped, frame, elapsedMs, width, height, confirmQuit, onRegions } = props;
 	const paint = usePaint();
 	const uptime = useUptime(status.startedAt);
 	const state = describeBadge(status);
@@ -556,10 +564,28 @@ function Sidebar(props) {
 	};
 	const budget = Math.max(1, height - 1);
 	const labelWidth = Math.max(1, inner - 2);
-	const lines = (group, labels, nodes, range = [0, Infinity]) => wrapLabels(labels, labelWidth).slice(...range).map((line, index) => /* @__PURE__ */ jsxs(Text, {
-		wrap: "truncate-end",
-		children: ["  ", line.flatMap((label, position) => position > 0 ? [" ", nodes[label]] : [nodes[label]])]
-	}, `${group}-${index}`));
+	const lines = (group, labels, nodes, range = [0, Infinity]) => wrapLabels(labels, labelWidth).slice(...range).map((line, index) => {
+		let column = 3;
+		return {
+			hit: {
+				kind: "items",
+				group,
+				items: line.map((label) => {
+					const start = column;
+					column += labels[label].length + 1;
+					return {
+						index: label,
+						start,
+						end: column - 1
+					};
+				})
+			},
+			node: /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [" ".repeat(INDENT), line.flatMap((label, position) => position > 0 ? [" ", nodes[label]] : [nodes[label]])]
+			}, `${group}-${index}`)
+		};
+	});
 	const levelNodes = VIEW_LEVELS.map((level, index) => item("levels", index, level, filter.levels.has(level), LEVEL_TOKENS[level]));
 	const levelLines = collapsed.levels ? [] : lines("levels", VIEW_LEVELS, levelNodes);
 	const channelNodes = channels.map((channel, index) => item("channels", index, channel, isChannelVisible(filter, channel), channelToken(channel)));
@@ -568,46 +594,80 @@ function Sidebar(props) {
 	const range = windowAround(channelLayout.length, focusedLine, Math.max(1, budget - head.length - 3 - levelLines.length));
 	const hiddenChannels = channelLayout.length - (range[1] - range[0]);
 	const filters = [
-		/* @__PURE__ */ jsx(Text, { children: " " }, "gap-filters"),
-		groupHeader("channels", !collapsed.channels && hiddenChannels > 0 ? ` · ${range[0] + 1}-${range[1]}/${channelLayout.length}` : ""),
+		{ node: /* @__PURE__ */ jsx(Text, { children: " " }, "gap-filters") },
+		{
+			hit: {
+				kind: "header",
+				group: "channels"
+			},
+			node: groupHeader("channels", !collapsed.channels && hiddenChannels > 0 ? ` · ${range[0] + 1}-${range[1]}/${channelLayout.length}` : "")
+		},
 		...collapsed.channels ? [] : lines("channels", channels, channelNodes, range),
-		groupHeader("levels"),
+		{
+			hit: {
+				kind: "header",
+				group: "levels"
+			},
+			node: groupHeader("levels")
+		},
 		...levelLines
 	];
-	const keys = KEYS$1.map((section, sectionIndex) => [/* @__PURE__ */ jsx(Text, { children: " " }, `gap-keys-${sectionIndex}`), ...section.map(([key, label]) => /* @__PURE__ */ jsxs(Text, {
-		wrap: "truncate-end",
-		children: [
-			/* @__PURE__ */ jsx(Text, {
-				bold: true,
-				color: paint("url"),
-				children: key
-			}),
-			" ",
-			/* @__PURE__ */ jsx(Text, {
-				dimColor: true,
-				children: label
-			})
-		]
-	}, key))]);
+	const keys = KEYS$1.map((section, sectionIndex) => [{ node: /* @__PURE__ */ jsx(Text, { children: " " }, `gap-keys-${sectionIndex}`) }, ...section.map(([key, label]) => ({
+		hit: {
+			kind: "key",
+			key
+		},
+		node: /* @__PURE__ */ jsxs(Text, {
+			wrap: "truncate-end",
+			children: [
+				/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: paint("url"),
+					children: key
+				}),
+				" ",
+				/* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: label
+				})
+			]
+		}, key)
+	}))]);
+	const statusRows = head.map((node) => ({ node }));
 	let body = [
-		...head,
+		...statusRows,
 		...filters,
 		...keys.flat()
 	];
 	if (body.length > budget) body = [
-		...head,
+		...statusRows,
 		...filters,
 		...keys[1]
 	];
-	if (body.length > budget) body = [...head, ...filters];
+	if (body.length > budget) body = [...statusRows, ...filters];
 	body = body.slice(0, budget);
+	const regions = body.flatMap(({ hit }, row) => {
+		if (hit === void 0) return [];
+		if (hit.kind === "items") return hit.items.map((item) => ({
+			kind: "item",
+			group: hit.group,
+			row,
+			...item
+		}));
+		return [{
+			...hit,
+			row
+		}];
+	});
+	const regionsKey = JSON.stringify(regions);
+	useEffect(() => onRegions?.(regions), [regionsKey, onRegions]);
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		width,
 		height,
-		paddingX: 1,
+		paddingX: PADDING,
 		children: [
-			body.map((node, index) => /* @__PURE__ */ jsx(Box, {
+			body.map(({ node }, index) => /* @__PURE__ */ jsx(Box, {
 				height: 1,
 				width: inner,
 				children: node
@@ -638,6 +698,17 @@ function Sidebar(props) {
 
 //#endregion
 //#region src/dev/tui/ink/components/Dashboard.tsx
+/** How many rows a notch of the wheel scrolls. */
+const WHEEL_ROWS = 3;
+/** Two clicks on the same entry within this many milliseconds are a double click. */
+const DOUBLE_CLICK_MS = 400;
+const NO_KEY = {};
+/** The keys of the sidebar a click can press, by how the sidebar writes them: the others stand for several keys. */
+const HINT_KEYS = {
+	tab: ["", { tab: true }],
+	space: [" ", {}],
+	s: ["s", {}]
+};
 /** The sidebar takes about a quarter of the terminal, within what its longest lines need and can spare. */
 function sidebarWidth(columns) {
 	return Math.max(24, Math.min(34, Math.floor(columns * .26)));
@@ -648,7 +719,7 @@ function sidebarWidth(columns) {
 * here only change what is looked at.
 */
 function Dashboard(props) {
-	const { service, status, counters, frame, elapsedMs, width, height, confirmQuit, initialFilter, active, onCapture } = props;
+	const { service, status, counters, frame, elapsedMs, width, height, confirmQuit, initialFilter, active, onCapture, mouse, onKey } = props;
 	const paint = usePaint();
 	const [filter, setFilter] = useState(initialFilter);
 	const [focus, setFocus] = useState({
@@ -664,6 +735,11 @@ function Dashboard(props) {
 	const [pinned, setPinned] = useState(null);
 	const [marked, setMarked] = useState(null);
 	const version = useLogVersion(service.logs);
+	const regions = useRef([]);
+	const lastClick = useRef(null);
+	const onRegions = useCallback((next) => {
+		regions.current = next;
+	}, []);
 	const channels = useMemo(() => [.../* @__PURE__ */ new Set([...initialFilter.allow ?? [], ...service.logs.channels()])].sort(), [
 		service,
 		initialFilter,
@@ -694,7 +770,7 @@ function Dashboard(props) {
 	const scroll = (delta) => {
 		setPinned(pinAt(rows, Math.max(Math.min(paneHeight, rows.length), end + delta)));
 	};
-	useInput((input, key) => {
+	const handleKey = (input, key) => {
 		if (key.ctrl || confirmQuit) return;
 		if (searching) {
 			if (key.escape) {
@@ -770,7 +846,64 @@ function Dashboard(props) {
 			setMarked(row.kind === "entry" ? row.entry.id : null);
 			setPinned(pinAt(rows, Math.max(paneHeight, index + Math.ceil(paneHeight / 2))));
 		}
-	}, { isActive: active });
+	};
+	useInput(handleKey, { isActive: active });
+	const select = (from, group, index, solo) => {
+		const target = (group === "channels" ? channels : VIEW_LEVELS)[index];
+		if (target === void 0) return;
+		setFocus({
+			group,
+			index
+		});
+		if (group === "channels") return change(solo ? soloChannel(from, target) : toggleChannel(from, target));
+		const level = target;
+		return change(solo ? soloLevel(from, level) : toggleLevel(from, level));
+	};
+	const handleMouse = (event) => {
+		if (confirmQuit) return;
+		if (event.kind === "wheel") {
+			if (event.column >= side) scroll(event.wheel * WHEEL_ROWS);
+			return;
+		}
+		if (event.kind !== "press" || event.button !== "left" || event.column >= side) return;
+		const region = findSidebarRegion(regions.current, event.row, event.column);
+		if (region === null) return;
+		if (region.kind === "header") {
+			setFocus((current) => current.group === region.group ? current : {
+				group: region.group,
+				index: 0
+			});
+			return setCollapsed((current) => ({
+				...current,
+				[region.group]: !current[region.group]
+			}));
+		}
+		if (region.kind === "key") {
+			if (searching) return;
+			const own = HINT_KEYS[region.key];
+			return own ? handleKey(own[0], {
+				...NO_KEY,
+				...own[1]
+			}) : onKey(region.key);
+		}
+		const now = Date.now();
+		const previous = lastClick.current;
+		const double = previous !== null && previous.group === region.group && previous.index === region.index && now - previous.at <= DOUBLE_CLICK_MS;
+		lastClick.current = double ? null : {
+			group: region.group,
+			index: region.index,
+			at: now,
+			filter
+		};
+		if (double) return select(previous.filter, region.group, region.index, true);
+		return select(filter, region.group, region.index, event.alt || event.ctrl);
+	};
+	const mouseHandler = useRef(handleMouse);
+	mouseHandler.current = handleMouse;
+	useEffect(() => {
+		if (!mouse || !active) return void 0;
+		return mouse.subscribe((event) => mouseHandler.current(event));
+	}, [mouse, active]);
 	return /* @__PURE__ */ jsxs(Box, {
 		width,
 		height,
@@ -788,7 +921,8 @@ function Dashboard(props) {
 			elapsedMs,
 			width: side,
 			height,
-			confirmQuit
+			confirmQuit,
+			onRegions
 		}), /* @__PURE__ */ jsxs(Box, {
 			flexDirection: "column",
 			width: mainWidth + 1,
@@ -1587,7 +1721,8 @@ function resolveLayout(layout, columns, rows) {
 * the bottom of the normal buffer with the logs folded away, and is what a small terminal gets. The browsable
 * overlays use the alternate buffer from either, preserving the terminal's history and the panel when they close.
 */
-function DevApp({ service, color, theme, reducedMotion, layout = "auto", filter, onQuit, onViewChange, onCopy, onThemeSave }) {
+function DevApp(props) {
+	const { service, color, theme, reducedMotion, layout = "auto", filter, onQuit, onViewChange, onCopy, onThemeSave, mouse, onMouseChange } = props;
 	const { columns, rows } = useWindowSize();
 	const [overlay, setOverlay] = useState(null);
 	const [chosen, setChosen] = useState(layout);
@@ -1620,18 +1755,13 @@ function DevApp({ service, color, theme, reducedMotion, layout = "auto", filter,
 		onViewChange(fullScreen);
 		repaint((count) => count + 1);
 	}, [fullScreen, onViewChange]);
+	const takesMouse = base === "dashboard" && overlay === null;
+	useEffect(() => {
+		onMouseChange?.(takesMouse);
+	}, [takesMouse, onMouseChange]);
 	const onCapture = useCallback((capturing) => setCaptured(capturing), []);
-	useInput((input, key) => {
-		if (key.ctrl && input === "c") return onQuit();
-		if (key.ctrl && input === "l") return service.clearLogs();
-		if (overlay !== null || captured) return;
-		if (confirmQuit) {
-			if (input === "y") return onQuit();
-			return setConfirmQuit(false);
-		}
-		if (key.ctrl && input === "r") return void service.restart("manual");
-		if (key.ctrl && input === "d") return busy ? setConfirmQuit(true) : onQuit();
-		if (status.prompt && (input === "y" || input === "n")) return service.answerPrompt(input === "y");
+	/** The keys that act on the session or change the view; also what a click on their hint in the sidebar runs. */
+	const runKey = (input) => {
 		switch (input) {
 			case "q": return busy ? setConfirmQuit(true) : onQuit();
 			case "r":
@@ -1655,6 +1785,19 @@ function DevApp({ service, color, theme, reducedMotion, layout = "auto", filter,
 			case "h":
 			case "?": return show("help");
 		}
+	};
+	useInput((input, key) => {
+		if (key.ctrl && input === "c") return onQuit();
+		if (key.ctrl && input === "l") return service.clearLogs();
+		if (overlay !== null || captured) return;
+		if (confirmQuit) {
+			if (input === "y") return onQuit();
+			return setConfirmQuit(false);
+		}
+		if (key.ctrl && input === "r") return void service.restart("manual");
+		if (key.ctrl && input === "d") return busy ? setConfirmQuit(true) : onQuit();
+		if (status.prompt && (input === "y" || input === "n")) return service.answerPrompt(input === "y");
+		runKey(input);
 	});
 	return /* @__PURE__ */ jsx(ThemeProvider, {
 		color,
@@ -1712,7 +1855,9 @@ function DevApp({ service, color, theme, reducedMotion, layout = "auto", filter,
 						confirmQuit,
 						initialFilter,
 						active: overlay === null,
-						onCapture
+						onCapture,
+						mouse,
+						onKey: runKey
 					})
 				}),
 				base === "panel" && overlay === null && /* @__PURE__ */ jsx(Panel, {
@@ -1729,6 +1874,113 @@ function DevApp({ service, color, theme, reducedMotion, layout = "auto", filter,
 	});
 }
 
+//#endregion
+//#region src/dev/tui/mouse.ts
+/**
+* Asks the terminal to report button presses and the wheel (`1000`), with coordinates in the SGR form (`1006`),
+* which is not limited to 223 columns. Motion is left off: nothing here reacts to a hover, and it is one sequence
+* per cell the pointer crosses. A terminal that knows neither ignores both.
+*/
+const ENABLE_MOUSE = "\x1B[?1000h\x1B[?1006h";
+const DISABLE_MOUSE = "\x1B[?1006l\x1B[?1000l";
+const SGR_MOUSE = /\u001B\[<(\d+);(\d+);(\d+)([Mm])/g;
+/** The start of a report whose end has not arrived yet, at the end of a chunk. */
+const PARTIAL_SGR_MOUSE = /\u001B(?:\[(?:<[\d;]*)?)?$/;
+const BUTTONS = [
+	"left",
+	"middle",
+	"right",
+	"none"
+];
+/**
+* Splits what the terminal sent into the mouse reports and everything else.
+*
+* @param chunk - A chunk read from the terminal.
+* @returns The mouse events of the chunk, and the chunk without their sequences: the keys the user typed.
+*/
+function parseMouse(chunk) {
+	const events = [];
+	return {
+		events,
+		rest: chunk.replace(SGR_MOUSE, (_match, code, column, row, final) => {
+			const bits = Number(code);
+			if ((bits & 32) !== 0 || (bits & 128) !== 0) return "";
+			const wheel = (bits & 64) !== 0;
+			if (wheel && (bits & 2) !== 0) return "";
+			const event = {
+				column: Number(column) - 1,
+				row: Number(row) - 1,
+				shift: (bits & 4) !== 0,
+				alt: (bits & 8) !== 0,
+				ctrl: (bits & 16) !== 0
+			};
+			if (wheel) events.push({
+				...event,
+				kind: "wheel",
+				button: "none",
+				wheel: (bits & 1) === 0 ? -1 : 1
+			});
+			else events.push({
+				...event,
+				kind: final === "M" ? "press" : "release",
+				button: BUTTONS[bits & 3],
+				wheel: 0
+			});
+			return "";
+		})
+	};
+}
+/**
+* Reads the terminal's input ahead of the UI, so that a mouse report is never taken for typed text: Ink would
+* otherwise hand `ESC[<0;12;5M` to its key handlers, and a click while searching would type it into the query.
+*
+* @param source - The terminal's input.
+*/
+function createMouseInput(source) {
+	const filtered = new PassThrough();
+	const listeners = /* @__PURE__ */ new Set();
+	const decoder = new StringDecoder("utf8");
+	let pending = "";
+	const onData = (data) => {
+		const { events, rest } = parseMouse(pending + (typeof data === "string" ? data : decoder.write(data)));
+		const partial = rest.length > 1 ? PARTIAL_SGR_MOUSE.exec(rest) : null;
+		const held = partial && partial[0].length > 1 ? partial[0] : "";
+		pending = held;
+		const keys = held ? rest.slice(0, -held.length) : rest;
+		if (keys) filtered.write(keys);
+		for (const event of events) for (const listener of listeners) listener(event);
+	};
+	source.on("data", onData);
+	const stdin = Object.assign(filtered, {
+		isTTY: source.isTTY,
+		setRawMode(mode) {
+			source.setRawMode?.(mode);
+			return stdin;
+		},
+		ref() {
+			source.ref?.();
+			return stdin;
+		},
+		unref() {
+			source.unref?.();
+			return stdin;
+		}
+	});
+	return {
+		stdin,
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		dispose() {
+			source.off("data", onData);
+			source.pause?.();
+			listeners.clear();
+			filtered.end();
+		}
+	};
+}
+
 //#endregion
 //#region src/dev/tui/capture-output.ts
 /** Capture third-party writes before build plugins run. Ink writes through a separate, unpatched sink. */
@@ -1781,6 +2033,13 @@ function createTuiRenderer(service, options = {}) {
 	const restoreOutput = stdout === process.stdout ? [captureOutput(service, process.stdout, "info"), captureOutput(service, process.stderr, "warn")] : [];
 	const layout = options.layout ?? service.config.dev.layout ?? "auto";
 	let alternate = resolveLayout(layout, stdout.columns ?? 80, stdout.rows ?? 24) === "dashboard";
+	const mouse = options.mouse ?? service.config.dev.mouse ? createMouseInput(stdin) : null;
+	let reporting = false;
+	const reportMouse = (wanted) => {
+		if (!mouse || wanted === reporting) return;
+		reporting = wanted;
+		write(wanted ? ENABLE_MOUSE : DISABLE_MOUSE);
+	};
 	if (alternate) write("\x1B[?1049h\x1B[H");
 	let stopped = false;
 	const switchView = (fullScreen) => {
@@ -1804,10 +2063,14 @@ function createTuiRenderer(service, options = {}) {
 		filter: options.filter,
 		onQuit: quit,
 		onViewChange: switchView,
-		onCopy: (text) => write(`\u001B]52;c;${Buffer.from(text.slice(0, 65536)).toString("base64")}\u0007`)
+		onCopy: (text) => write(`\u001B]52;c;${Buffer.from(text.slice(0, 65536)).toString("base64")}\u0007`),
+		mouse: mouse ?? void 0,
+		onMouseChange: (wanted) => {
+			if (!stopped) reportMouse(wanted);
+		}
 	}), {
 		stdout: sink,
-		stdin,
+		stdin: mouse?.stdin ?? stdin,
 		exitOnCtrlC: false,
 		patchConsole: false,
 		interactive: true,
@@ -1823,7 +2086,9 @@ function createTuiRenderer(service, options = {}) {
 			service.promptable = false;
 			if (alternate) instance.clear();
 			instance.unmount();
+			reportMouse(false);
 			if (alternate) write("\x1B[?1049l");
+			mouse?.dispose();
 			write("\x1B[?25h");
 			for (const restore of restoreOutput) restore();
 			if (service.status.progress.readyMs === null) {
@@ -1837,4 +2102,4 @@ function createTuiRenderer(service, options = {}) {
 
 //#endregion
 export { createTuiRenderer };
-//# sourceMappingURL=tui-CB_qk2Z1.js.map
+//# sourceMappingURL=tui-BOkOx13K.js.map