@maltty/cli 1.0.0-rc.0

package/dist/commands/build.js

@@ -0,0 +1,246 @@
+import { i as normalizeCompileOptions, r as createBundler } from "../dist-DW_gRP7_.js";
+import { n as loadConfig } from "../utils-DlIJNGLQ.js";
+import { t as extractConfig } from "../config-helpers-pv_2Spux.js";
+import { command } from "maltty";
+import { relative } from "node:path";
+import { z } from "zod";
+import pc from "picocolors";
+//#region src/commands/build.ts
+/**
+* Build a maltty CLI project for production.
+*
+* Loads the project's `maltty.config.ts`, invokes the bundler, and reports
+* the output entry file and directory on success. When `--compile` or
+* `--targets` is provided (or `compile` is set in config), also compiles
+* to standalone binaries via Bun.
+*/
+const buildCommand = command({
+	options: z.object({
+		clean: z.boolean().optional().describe("Clean build artifacts before bundling (default: true)"),
+		compile: z.boolean().optional().describe("Compile to standalone binaries after bundling"),
+		targets: z.array(z.string()).optional().describe("Compile targets (implies --compile)"),
+		verbose: z.boolean().optional().describe("Show detailed error output on bundle or compile failure")
+	}),
+	description: "Build a maltty CLI project for production",
+	handler: async (ctx) => {
+		const cwd = process.cwd();
+		const startTime = Date.now();
+		const [, configResult] = await loadConfig({ cwd });
+		const config = mergeCleanOption({
+			config: extractConfig(configResult),
+			clean: ctx.args.clean
+		});
+		const shouldCompile = resolveCompileIntent({
+			compileFlag: ctx.args.compile,
+			configCompile: config.compile,
+			targets: ctx.args.targets
+		});
+		const bundler = await createBundler({
+			config: resolveMergedConfig({
+				config,
+				shouldCompile,
+				targets: ctx.args.targets
+			}),
+			cwd,
+			onStepStart: ({ meta }) => ctx.status.spinner.message(`Compiling ${String(meta.label ?? "target")}...`),
+			onStepFinish: ({ meta }) => ctx.status.spinner.message(`Compiled ${String(meta.label ?? "target")}`)
+		});
+		ctx.status.spinner.start("Bundling...");
+		const [buildError, buildOutput] = await bundler.build({ verbose: ctx.args.verbose });
+		if (buildError) {
+			ctx.status.spinner.stop("Bundle failed");
+			return ctx.fail(buildError.message);
+		}
+		if (!shouldCompile) {
+			ctx.status.spinner.stop("Build complete");
+			ctx.log.note(formatBuildNote({
+				cwd,
+				define: buildOutput.define,
+				entryFile: buildOutput.entryFile,
+				outDir: buildOutput.outDir,
+				version: buildOutput.version
+			}), "Bundle");
+			ctx.log.outro(formatOutroSummary({
+				binaries: 0,
+				duration: Date.now() - startTime
+			}));
+			return;
+		}
+		ctx.status.spinner.message("Bundled, compiling binaries...");
+		const [compileError, compileOutput] = await bundler.compile({ verbose: ctx.args.verbose });
+		if (compileError) {
+			ctx.status.spinner.stop("Compile failed");
+			return ctx.fail(compileError.message);
+		}
+		ctx.status.spinner.stop("Build complete");
+		ctx.log.note(formatBuildNote({
+			cwd,
+			define: buildOutput.define,
+			entryFile: buildOutput.entryFile,
+			outDir: buildOutput.outDir,
+			version: buildOutput.version
+		}), "Bundle");
+		ctx.log.note(formatBinariesNote({
+			binaries: compileOutput.binaries,
+			cwd
+		}), "Binaries");
+		ctx.log.outro(formatOutroSummary({
+			binaries: compileOutput.binaries.length,
+			duration: Date.now() - startTime
+		}));
+	}
+});
+/**
+* Apply compile-target overrides to the config when compilation will run.
+*
+* @private
+* @param params - The base config, compile decision, and CLI target overrides.
+* @returns The config to hand to the bundler.
+*/
+function resolveMergedConfig(params) {
+	if (params.shouldCompile) return mergeCompileTargets({
+		config: params.config,
+		targets: params.targets
+	});
+	return params.config;
+}
+/**
+* Determine whether compilation should run based on CLI flags and config.
+*
+* Resolution order:
+* 1. `--targets` provided → compile (implied)
+* 2. `--compile` flag → use its boolean value
+* 3. Fall back to config `compile` field (truthy = compile)
+*
+* @private
+* @param params - The CLI flags and config compile field.
+* @returns Whether to run the compile step.
+*/
+function resolveCompileIntent(params) {
+	if (params.targets && params.targets.length > 0) return true;
+	if (params.compileFlag !== void 0) return params.compileFlag;
+	if (params.configCompile === true) return true;
+	if (typeof params.configCompile === "object") return true;
+	return false;
+}
+/**
+* Merge CLI `--targets` into the config's compile options.
+*
+* @private
+* @param params - The config and optional CLI targets.
+* @returns A config with compile targets merged in.
+*/
+function mergeCompileTargets(params) {
+	if (!params.targets || params.targets.length === 0) return params.config;
+	const existingCompile = normalizeCompileOptions(params.config.compile);
+	return {
+		...params.config,
+		compile: {
+			...existingCompile,
+			targets: params.targets
+		}
+	};
+}
+/**
+* Merge the CLI `--clean` / `--no-clean` flag into the loaded config.
+*
+* @private
+* @param params - The loaded config and optional CLI clean flag.
+* @returns A config with the clean option merged in.
+*/
+function mergeCleanOption(params) {
+	if (params.clean === void 0) return params.config;
+	return {
+		...params.config,
+		build: {
+			...params.config.build,
+			clean: params.clean
+		}
+	};
+}
+/**
+* Format bundle output into a multi-line string for display.
+*
+* @private
+* @param params - The build output paths and working directory.
+* @returns A formatted string with entry and output directory.
+*/
+function formatBuildNote(params) {
+	return [
+		`entry    ${relative(params.cwd, params.entryFile)}`,
+		`output   ${relative(params.cwd, params.outDir)}`,
+		...formatVersionLine(params.version),
+		...formatDefineLines(params.define)
+	].join("\n");
+}
+/**
+* Format a version line for the build note, if a version is available.
+*
+* @private
+* @param version - The version string, or undefined.
+* @returns A single-element array with the formatted line, or an empty array.
+*/
+function formatVersionLine(version) {
+	if (!version) return [];
+	return [`version  ${version}`];
+}
+/**
+* Format define constants into display lines.
+*
+* Omits `__MALTTY_VERSION__` (already shown as `version`) and returns
+* remaining entries as `define   key = value` lines.
+*
+* @private
+* @param define - The resolved define map.
+* @returns An array of formatted lines (empty when no user-defined constants).
+*/
+/**
+* Format the outro summary line with build stats.
+*
+* @private
+* @param params - Build stats for the summary.
+* @returns A formatted inline summary string.
+*/
+function formatOutroSummary(params) {
+	return [...formatBinariesSegment(params.binaries), `finished in ${formatDuration(params.duration)}`].join(pc.gray(" · "));
+}
+/**
+* Build the optional "binaries compiled" segment of the outro summary.
+*
+* @private
+* @param count - The number of compiled binaries.
+* @returns A single-element array describing the count, or an empty array.
+*/
+function formatBinariesSegment(count) {
+	if (count > 0) return [`${count} binaries compiled`];
+	return [];
+}
+/**
+* Format a millisecond duration into a human-readable string.
+*
+* @private
+* @param ms - Duration in milliseconds.
+* @returns A formatted duration string (e.g. "1.2s", "350ms").
+*/
+function formatDuration(ms) {
+	if (ms >= 1e3) return `${(ms / 1e3).toFixed(1)}s`;
+	return `${ms}ms`;
+}
+function formatDefineLines(define) {
+	return Object.entries(define).map(([key, value]) => `build_var ${key} = ${value}`);
+}
+/**
+* Format compiled binaries into an aligned, multi-line string for display.
+*
+* @private
+* @param params - The binaries and working directory for relative path resolution.
+* @returns A formatted string with one line per binary.
+*/
+function formatBinariesNote(params) {
+	const maxLen = Math.max(...params.binaries.map((b) => b.label.length));
+	return params.binaries.map((binary) => `${binary.label.padEnd(maxLen)}  ${relative(params.cwd, binary.path)}`).join("\n");
+}
+//#endregion
+export { buildCommand as default };
+
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","names":[],"sources":["../../src/commands/build.ts"],"sourcesContent":["import { relative } from 'node:path'\n\nimport { createBundler, normalizeCompileOptions } from '@maltty/bundler'\nimport type { CompiledBinary } from '@maltty/bundler'\nimport type { CompileTarget, MalttyConfig } from '@maltty/config'\nimport { loadConfig } from '@maltty/config/utils'\nimport { command } from 'maltty'\nimport type { Command, CommandContext } from 'maltty'\nimport pc from 'picocolors'\nimport { z } from 'zod'\n\nimport { extractConfig } from '../lib/config-helpers.js'\n\nconst options = z.object({\n  clean: z.boolean().optional().describe('Clean build artifacts before bundling (default: true)'),\n  compile: z.boolean().optional().describe('Compile to standalone binaries after bundling'),\n  targets: z.array(z.string()).optional().describe('Compile targets (implies --compile)'),\n  verbose: z\n    .boolean()\n    .optional()\n    .describe('Show detailed error output on bundle or compile failure'),\n})\n\ntype BuildArgs = z.infer<typeof options>\n\n/**\n * Build a maltty CLI project for production.\n *\n * Loads the project's `maltty.config.ts`, invokes the bundler, and reports\n * the output entry file and directory on success. When `--compile` or\n * `--targets` is provided (or `compile` is set in config), also compiles\n * to standalone binaries via Bun.\n */\nconst buildCommand: Command = command({\n  options,\n  description: 'Build a maltty CLI project for production',\n  handler: async (ctx: CommandContext<BuildArgs>) => {\n    const cwd = process.cwd()\n    const startTime = Date.now()\n\n    const [, configResult] = await loadConfig({ cwd })\n    const config = mergeCleanOption({ config: extractConfig(configResult), clean: ctx.args.clean })\n\n    const shouldCompile = resolveCompileIntent({\n      compileFlag: ctx.args.compile,\n      configCompile: config.compile,\n      targets: ctx.args.targets,\n    })\n\n    const mergedConfig = resolveMergedConfig({\n      config,\n      shouldCompile,\n      targets: ctx.args.targets,\n    })\n\n    const bundler = await createBundler({\n      config: mergedConfig,\n      cwd,\n      onStepStart: ({ meta }) =>\n        ctx.status.spinner.message(`Compiling ${String(meta.label ?? 'target')}...`),\n      onStepFinish: ({ meta }) =>\n        ctx.status.spinner.message(`Compiled ${String(meta.label ?? 'target')}`),\n    })\n\n    ctx.status.spinner.start('Bundling...')\n\n    const [buildError, buildOutput] = await bundler.build({ verbose: ctx.args.verbose })\n\n    if (buildError) {\n      ctx.status.spinner.stop('Bundle failed')\n      return ctx.fail(buildError.message)\n    }\n\n    if (!shouldCompile) {\n      ctx.status.spinner.stop('Build complete')\n      ctx.log.note(\n        formatBuildNote({\n          cwd,\n          define: buildOutput.define,\n          entryFile: buildOutput.entryFile,\n          outDir: buildOutput.outDir,\n          version: buildOutput.version,\n        }),\n        'Bundle'\n      )\n      ctx.log.outro(formatOutroSummary({ binaries: 0, duration: Date.now() - startTime }))\n      return\n    }\n\n    ctx.status.spinner.message('Bundled, compiling binaries...')\n\n    const [compileError, compileOutput] = await bundler.compile({\n      verbose: ctx.args.verbose,\n    })\n\n    if (compileError) {\n      ctx.status.spinner.stop('Compile failed')\n      return ctx.fail(compileError.message)\n    }\n\n    ctx.status.spinner.stop('Build complete')\n    ctx.log.note(\n      formatBuildNote({\n        cwd,\n        define: buildOutput.define,\n        entryFile: buildOutput.entryFile,\n        outDir: buildOutput.outDir,\n        version: buildOutput.version,\n      }),\n      'Bundle'\n    )\n    ctx.log.note(formatBinariesNote({ binaries: compileOutput.binaries, cwd }), 'Binaries')\n    ctx.log.outro(\n      formatOutroSummary({\n        binaries: compileOutput.binaries.length,\n        duration: Date.now() - startTime,\n      })\n    )\n  },\n})\n\nexport default buildCommand\n\n// ---------------------------------------------------------------------------\n\n/**\n * Apply compile-target overrides to the config when compilation will run.\n *\n * @private\n * @param params - The base config, compile decision, and CLI target overrides.\n * @returns The config to hand to the bundler.\n */\nfunction resolveMergedConfig(params: {\n  readonly config: MalttyConfig\n  readonly shouldCompile: boolean\n  readonly targets: readonly string[] | undefined\n}): MalttyConfig {\n  if (params.shouldCompile) {\n    return mergeCompileTargets({ config: params.config, targets: params.targets })\n  }\n  return params.config\n}\n\n/**\n * Determine whether compilation should run based on CLI flags and config.\n *\n * Resolution order:\n * 1. `--targets` provided → compile (implied)\n * 2. `--compile` flag → use its boolean value\n * 3. Fall back to config `compile` field (truthy = compile)\n *\n * @private\n * @param params - The CLI flags and config compile field.\n * @returns Whether to run the compile step.\n */\nfunction resolveCompileIntent(params: {\n  readonly targets: readonly string[] | undefined\n  readonly compileFlag: boolean | undefined\n  readonly configCompile: boolean | MalttyConfig['compile']\n}): boolean {\n  if (params.targets && params.targets.length > 0) {\n    return true\n  }\n\n  if (params.compileFlag !== undefined) {\n    return params.compileFlag\n  }\n\n  if (params.configCompile === true) {\n    return true\n  }\n\n  if (typeof params.configCompile === 'object') {\n    return true\n  }\n\n  return false\n}\n\n/**\n * Merge CLI `--targets` into the config's compile options.\n *\n * @private\n * @param params - The config and optional CLI targets.\n * @returns A config with compile targets merged in.\n */\nfunction mergeCompileTargets(params: {\n  readonly config: MalttyConfig\n  readonly targets: readonly string[] | undefined\n}): MalttyConfig {\n  if (!params.targets || params.targets.length === 0) {\n    return params.config\n  }\n\n  const existingCompile = normalizeCompileOptions(params.config.compile)\n\n  return {\n    ...params.config,\n    compile: {\n      ...existingCompile,\n      targets: params.targets as CompileTarget[],\n    },\n  }\n}\n\n/**\n * Merge the CLI `--clean` / `--no-clean` flag into the loaded config.\n *\n * @private\n * @param params - The loaded config and optional CLI clean flag.\n * @returns A config with the clean option merged in.\n */\nfunction mergeCleanOption(params: {\n  readonly config: MalttyConfig\n  readonly clean: boolean | undefined\n}): MalttyConfig {\n  if (params.clean === undefined) {\n    return params.config\n  }\n\n  return {\n    ...params.config,\n    build: {\n      ...params.config.build,\n      clean: params.clean,\n    },\n  }\n}\n\n/**\n * Format bundle output into a multi-line string for display.\n *\n * @private\n * @param params - The build output paths and working directory.\n * @returns A formatted string with entry and output directory.\n */\nfunction formatBuildNote(params: {\n  readonly entryFile: string\n  readonly outDir: string\n  readonly cwd: string\n  readonly version: string | undefined\n  readonly define: Readonly<Record<string, string>>\n}): string {\n  return [\n    `entry    ${relative(params.cwd, params.entryFile)}`,\n    `output   ${relative(params.cwd, params.outDir)}`,\n    ...formatVersionLine(params.version),\n    ...formatDefineLines(params.define),\n  ].join('\\n')\n}\n\n/**\n * Format a version line for the build note, if a version is available.\n *\n * @private\n * @param version - The version string, or undefined.\n * @returns A single-element array with the formatted line, or an empty array.\n */\nfunction formatVersionLine(version: string | undefined): string[] {\n  if (!version) {\n    return []\n  }\n\n  return [`version  ${version}`]\n}\n\n/**\n * Format define constants into display lines.\n *\n * Omits `__MALTTY_VERSION__` (already shown as `version`) and returns\n * remaining entries as `define   key = value` lines.\n *\n * @private\n * @param define - The resolved define map.\n * @returns An array of formatted lines (empty when no user-defined constants).\n */\n/**\n * Format the outro summary line with build stats.\n *\n * @private\n * @param params - Build stats for the summary.\n * @returns A formatted inline summary string.\n */\nfunction formatOutroSummary(params: {\n  readonly binaries: number\n  readonly duration: number\n}): string {\n  const stats = [\n    ...formatBinariesSegment(params.binaries),\n    `finished in ${formatDuration(params.duration)}`,\n  ]\n\n  return stats.join(pc.gray(' · '))\n}\n\n/**\n * Build the optional \"binaries compiled\" segment of the outro summary.\n *\n * @private\n * @param count - The number of compiled binaries.\n * @returns A single-element array describing the count, or an empty array.\n */\nfunction formatBinariesSegment(count: number): readonly string[] {\n  if (count > 0) {\n    return [`${count} binaries compiled`]\n  }\n  return []\n}\n\n/**\n * Format a millisecond duration into a human-readable string.\n *\n * @private\n * @param ms - Duration in milliseconds.\n * @returns A formatted duration string (e.g. \"1.2s\", \"350ms\").\n */\nfunction formatDuration(ms: number): string {\n  if (ms >= 1000) {\n    return `${(ms / 1000).toFixed(1)}s`\n  }\n  return `${ms}ms`\n}\n\nfunction formatDefineLines(define: Readonly<Record<string, string>>): string[] {\n  return Object.entries(define).map(([key, value]) => `build_var ${key} = ${value}`)\n}\n\n/**\n * Format compiled binaries into an aligned, multi-line string for display.\n *\n * @private\n * @param params - The binaries and working directory for relative path resolution.\n * @returns A formatted string with one line per binary.\n */\nfunction formatBinariesNote(params: {\n  readonly binaries: readonly CompiledBinary[]\n  readonly cwd: string\n}): string {\n  const maxLen = Math.max(...params.binaries.map((b) => b.label.length))\n\n  return params.binaries\n    .map((binary) => `${binary.label.padEnd(maxLen)}  ${relative(params.cwd, binary.path)}`)\n    .join('\\n')\n}\n"],"mappings":"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"}

package/dist/commands/commands.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "maltty";
+
+//#region src/commands/commands.d.ts
+/**
+* Display the command tree for a maltty CLI project.
+*
+* Loads the project's `maltty.config.ts` to locate the commands directory,
+* scans it with the autoloader, and prints an ASCII tree of all discovered
+* commands and subcommands.
+*/
+declare const commandsCommand: Command;
+//#endregion
+export { commandsCommand as default };
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","names":[],"sources":["../../src/commands/commands.ts"],"mappings":";;;;;AAK8D;;;;;cAoBxD,eAAA,EAAiB,OAAA"}

package/dist/commands/commands.js

@@ -0,0 +1,189 @@
+import { r as fs_exports } from "../node-C91xGGqn.js";
+import { n as loadConfig } from "../utils-DlIJNGLQ.js";
+import { t as extractConfig } from "../config-helpers-pv_2Spux.js";
+import { autoload, command } from "maltty";
+import { join } from "node:path";
+//#region src/commands/commands.ts
+/**
+* Display the command tree for a maltty CLI project.
+*
+* Loads the project's `maltty.config.ts` to locate the commands directory,
+* scans it with the autoloader, and prints an ASCII tree of all discovered
+* commands and subcommands.
+*/
+const commandsCommand = command({
+	description: "Display the command tree for a maltty CLI project",
+	handler: async (ctx) => {
+		const cwd = process.cwd();
+		const [, configResult] = await loadConfig({ cwd });
+		const commandsDir = join(cwd, extractConfig(configResult).commands ?? "commands");
+		if (!await fs_exports.exists(commandsDir)) return ctx.fail(`Commands directory not found: ${commandsDir}`);
+		ctx.status.spinner.start("Scanning commands...");
+		const tree = await buildTree(await autoload({ dir: commandsDir }));
+		ctx.status.spinner.stop("Commands");
+		if (tree.length === 0) {
+			ctx.log.raw("No commands found");
+			return;
+		}
+		ctx.log.raw(renderTree(tree));
+	}
+});
+/**
+* Resolve a command's subcommands field, which may be a Promise, a map, or undefined.
+*
+* @private
+* @param commands - The raw subcommands value from a Command object.
+* @returns The resolved CommandMap, or an empty object when none exist.
+*/
+async function resolveSubcommands(commands) {
+	if (!commands) return {};
+	if (commands instanceof Promise) return commands;
+	return commands;
+}
+/**
+* Recursively build a sorted tree of entries from a CommandMap.
+*
+* Commands listed in the order array appear first in the specified order;
+* omitted commands fall back to alphabetical sort.
+*
+* @private
+* @param commandMap - The map of command names to Command objects.
+* @param order - Optional array of command names defining display order.
+* @returns A sorted array of TreeEntry nodes.
+*/
+async function buildTree(commandMap, order) {
+	const entries = sortEntries({
+		entries: Object.entries(commandMap),
+		order
+	});
+	return Promise.all(entries.map(async ([name, cmd]) => {
+		return {
+			children: await buildTree(await resolveSubcommands(cmd.commands), cmd.help?.order),
+			description: cmd.description ?? "",
+			name
+		};
+	}));
+}
+/**
+* Sort command entries with ordered names first (in specified order),
+* remaining names alphabetically.
+*
+* Validates the order array against available command names and logs a
+* warning for unknown or duplicate entries rather than failing silently.
+*
+* @private
+* @param params - The command entries and optional order array.
+* @returns Sorted array of entries.
+*/
+function sortEntries(params) {
+	const { entries, order } = params;
+	if (!order || order.length === 0) return entries.toSorted(([a], [b]) => a.localeCompare(b));
+	const validOrder = validateOrder({
+		commandNames: entries.map(([name]) => name),
+		order
+	});
+	const entryMap = new Map(entries);
+	const orderedSet = new Set(validOrder);
+	const ordered = validOrder.filter((name) => entryMap.has(name)).map((name) => [name, entryMap.get(name)]);
+	const remaining = entries.filter(([name]) => !orderedSet.has(name)).toSorted(([a], [b]) => a.localeCompare(b));
+	return [...ordered, ...remaining];
+}
+/**
+* Validate the order array by filtering out unknown and duplicate names.
+*
+* Logs warnings for invalid entries so developers see the mismatch
+* during `maltty commands` introspection, matching the runtime behaviour.
+*
+* @private
+* @param params - The order array and available command names.
+* @returns A deduplicated array of valid order names.
+*/
+function validateOrder(params) {
+	const { commandNames, order } = params;
+	const nameSet = new Set(commandNames);
+	const { valid } = order.reduce((acc, name) => {
+		if (acc.seen.has(name)) {
+			console.warn(`Warning: duplicate command name "${name}" in order array`);
+			return acc;
+		}
+		if (!nameSet.has(name)) {
+			console.warn(`Warning: unknown command "${name}" in order array`);
+			return {
+				seen: new Set([...acc.seen, name]),
+				valid: acc.valid
+			};
+		}
+		return {
+			seen: new Set([...acc.seen, name]),
+			valid: [...acc.valid, name]
+		};
+	}, {
+		seen: /* @__PURE__ */ new Set(),
+		valid: []
+	});
+	return valid;
+}
+/**
+* Render a tree of entries into an ASCII tree string.
+*
+* @private
+* @param entries - The top-level tree entries to render.
+* @returns The formatted tree string.
+*/
+function renderTree(entries) {
+	return renderEntries(entries, "").join("\n");
+}
+/**
+* Recursively render tree entries with proper box-drawing connectors.
+*
+* @private
+* @param entries - The entries at this level.
+* @param prefix - The prefix string for indentation.
+* @returns An array of formatted lines.
+*/
+function renderEntries(entries, prefix) {
+	return entries.flatMap((entry, index) => {
+		const isLast = index === entries.length - 1;
+		const connector = resolveConnector(isLast);
+		const childPrefix = resolveChildPrefix(isLast);
+		return [`${prefix}${connector}${formatLabel(entry.name, entry.description)}`, ...renderEntries(entry.children, `${prefix}${childPrefix}`)];
+	});
+}
+/**
+* Get the box-drawing connector for a tree entry.
+*
+* @private
+* @param isLast - Whether this is the last entry at its level.
+* @returns The connector string.
+*/
+function resolveConnector(isLast) {
+	if (isLast) return "└── ";
+	return "├── ";
+}
+/**
+* Get the indentation prefix for children of a tree entry.
+*
+* @private
+* @param isLast - Whether the parent is the last entry at its level.
+* @returns The child prefix string.
+*/
+function resolveChildPrefix(isLast) {
+	if (isLast) return "    ";
+	return "│   ";
+}
+/**
+* Format a command name and description into a tree label.
+*
+* @private
+* @param name - The command name.
+* @param description - The command description (may be empty).
+* @returns The formatted label string.
+*/
+function formatLabel(name, description) {
+	if (description) return `${name} — ${description}`;
+	return name;
+}
+//#endregion
+export { commandsCommand as default };
+
+//# sourceMappingURL=commands.js.map

package/dist/commands/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":["fs"],"sources":["../../src/commands/commands.ts"],"sourcesContent":["import { join } from 'node:path'\n\nimport { loadConfig } from '@maltty/config/utils'\nimport { fs } from '@maltty/utils/node'\nimport { autoload, command } from 'maltty'\nimport type { Command as MalttyCommand, CommandContext } from 'maltty'\n\nimport { extractConfig } from '../lib/config-helpers.js'\n\n/**\n * A single node in the rendered command tree.\n */\ninterface TreeEntry {\n  readonly name: string\n  readonly description: string\n  readonly children: readonly TreeEntry[]\n}\n\n/**\n * Display the command tree for a maltty CLI project.\n *\n * Loads the project's `maltty.config.ts` to locate the commands directory,\n * scans it with the autoloader, and prints an ASCII tree of all discovered\n * commands and subcommands.\n */\nconst commandsCommand: MalttyCommand = command({\n  description: 'Display the command tree for a maltty CLI project',\n  handler: async (ctx: CommandContext) => {\n    const cwd = process.cwd()\n\n    const [, configResult] = await loadConfig({ cwd })\n    const config = extractConfig(configResult)\n\n    const commandsDir = join(cwd, config.commands ?? 'commands')\n\n    if (!(await fs.exists(commandsDir))) {\n      return ctx.fail(`Commands directory not found: ${commandsDir}`)\n    }\n\n    ctx.status.spinner.start('Scanning commands...')\n\n    const commandMap = await autoload({ dir: commandsDir })\n    const tree = await buildTree(commandMap)\n\n    ctx.status.spinner.stop('Commands')\n\n    if (tree.length === 0) {\n      ctx.log.raw('No commands found')\n      return\n    }\n\n    ctx.log.raw(renderTree(tree))\n  },\n})\n\nexport default commandsCommand\n\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve a command's subcommands field, which may be a Promise, a map, or undefined.\n *\n * @private\n * @param commands - The raw subcommands value from a Command object.\n * @returns The resolved CommandMap, or an empty object when none exist.\n */\nasync function resolveSubcommands(\n  commands: Record<string, MalttyCommand> | Promise<Record<string, MalttyCommand>> | undefined\n): Promise<Record<string, MalttyCommand>> {\n  if (!commands) {\n    return {}\n  }\n\n  if (commands instanceof Promise) {\n    return commands\n  }\n\n  return commands\n}\n\n/**\n * Recursively build a sorted tree of entries from a CommandMap.\n *\n * Commands listed in the order array appear first in the specified order;\n * omitted commands fall back to alphabetical sort.\n *\n * @private\n * @param commandMap - The map of command names to Command objects.\n * @param order - Optional array of command names defining display order.\n * @returns A sorted array of TreeEntry nodes.\n */\nasync function buildTree(\n  commandMap: Record<string, MalttyCommand>,\n  order?: readonly string[]\n): Promise<readonly TreeEntry[]> {\n  const entries = sortEntries({ entries: Object.entries(commandMap), order })\n\n  return Promise.all(\n    entries.map(async ([name, cmd]): Promise<TreeEntry> => {\n      const subMap = await resolveSubcommands(cmd.commands)\n      const children = await buildTree(subMap, cmd.help?.order)\n\n      return {\n        children,\n        description: cmd.description ?? '',\n        name,\n      }\n    })\n  )\n}\n\n/**\n * Sort command entries with ordered names first (in specified order),\n * remaining names alphabetically.\n *\n * Validates the order array against available command names and logs a\n * warning for unknown or duplicate entries rather than failing silently.\n *\n * @private\n * @param params - The command entries and optional order array.\n * @returns Sorted array of entries.\n */\nfunction sortEntries(params: {\n  readonly entries: [string, MalttyCommand][]\n  readonly order?: readonly string[]\n}): [string, MalttyCommand][] {\n  const { entries, order } = params\n\n  if (!order || order.length === 0) {\n    return entries.toSorted(([a], [b]) => a.localeCompare(b))\n  }\n\n  const commandNames = entries.map(([name]) => name)\n  const validOrder = validateOrder({ commandNames, order })\n\n  const entryMap = new Map(entries)\n  const orderedSet = new Set(validOrder)\n\n  const ordered = validOrder\n    .filter((name) => entryMap.has(name))\n    .map((name): [string, MalttyCommand] => [name, entryMap.get(name) as MalttyCommand])\n\n  const remaining = entries\n    .filter(([name]) => !orderedSet.has(name))\n    .toSorted(([a], [b]) => a.localeCompare(b))\n\n  return [...ordered, ...remaining]\n}\n\n/**\n * Validate the order array by filtering out unknown and duplicate names.\n *\n * Logs warnings for invalid entries so developers see the mismatch\n * during `maltty commands` introspection, matching the runtime behaviour.\n *\n * @private\n * @param params - The order array and available command names.\n * @returns A deduplicated array of valid order names.\n */\nfunction validateOrder(params: {\n  readonly commandNames: readonly string[]\n  readonly order: readonly string[]\n}): readonly string[] {\n  const { commandNames, order } = params\n  const nameSet = new Set(commandNames)\n\n  const { valid } = order.reduce<{\n    readonly seen: ReadonlySet<string>\n    readonly valid: readonly string[]\n  }>(\n    (acc, name) => {\n      if (acc.seen.has(name)) {\n        console.warn(`Warning: duplicate command name \"${name}\" in order array`)\n        return acc\n      }\n\n      if (!nameSet.has(name)) {\n        console.warn(`Warning: unknown command \"${name}\" in order array`)\n        return { seen: new Set([...acc.seen, name]), valid: acc.valid }\n      }\n\n      return { seen: new Set([...acc.seen, name]), valid: [...acc.valid, name] }\n    },\n    { seen: new Set<string>(), valid: [] }\n  )\n\n  return valid\n}\n\n/**\n * Render a tree of entries into an ASCII tree string.\n *\n * @private\n * @param entries - The top-level tree entries to render.\n * @returns The formatted tree string.\n */\nfunction renderTree(entries: readonly TreeEntry[]): string {\n  return renderEntries(entries, '').join('\\n')\n}\n\n/**\n * Recursively render tree entries with proper box-drawing connectors.\n *\n * @private\n * @param entries - The entries at this level.\n * @param prefix - The prefix string for indentation.\n * @returns An array of formatted lines.\n */\nfunction renderEntries(entries: readonly TreeEntry[], prefix: string): readonly string[] {\n  return entries.flatMap((entry, index) => {\n    const isLast = index === entries.length - 1\n    const connector = resolveConnector(isLast)\n    const childPrefix = resolveChildPrefix(isLast)\n    const label = formatLabel(entry.name, entry.description)\n    const line = `${prefix}${connector}${label}`\n    const childLines = renderEntries(entry.children, `${prefix}${childPrefix}`)\n\n    return [line, ...childLines]\n  })\n}\n\n/**\n * Get the box-drawing connector for a tree entry.\n *\n * @private\n * @param isLast - Whether this is the last entry at its level.\n * @returns The connector string.\n */\nfunction resolveConnector(isLast: boolean): string {\n  if (isLast) {\n    return '└── '\n  }\n\n  return '├── '\n}\n\n/**\n * Get the indentation prefix for children of a tree entry.\n *\n * @private\n * @param isLast - Whether the parent is the last entry at its level.\n * @returns The child prefix string.\n */\nfunction resolveChildPrefix(isLast: boolean): string {\n  if (isLast) {\n    return '    '\n  }\n\n  return '│   '\n}\n\n/**\n * Format a command name and description into a tree label.\n *\n * @private\n * @param name - The command name.\n * @param description - The command description (may be empty).\n * @returns The formatted label string.\n */\nfunction formatLabel(name: string, description: string): string {\n  if (description) {\n    return `${name} — ${description}`\n  }\n\n  return name\n}\n"],"mappings":"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"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "maltty";
+
+//#region src/commands/dev.d.ts
+/**
+* Start a maltty CLI project in development mode with file watching.
+*
+* Loads the project's `maltty.config.ts`, starts the bundler in watch mode, and
+* logs rebuild status on each successful build.
+*/
+declare const devCommand: Command;
+//#endregion
+export { devCommand as default };
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","names":[],"sources":["../../src/commands/dev.ts"],"mappings":";;;;;AAG6C;;;;cAUvC,UAAA,EAAY,OAAA"}

package/dist/commands/dev.js

@@ -0,0 +1,58 @@
+import { r as createBundler } from "../dist-DW_gRP7_.js";
+import { n as loadConfig } from "../utils-DlIJNGLQ.js";
+import { t as extractConfig } from "../config-helpers-pv_2Spux.js";
+import { command } from "maltty";
+//#region src/commands/dev.ts
+/**
+* Start a maltty CLI project in development mode with file watching.
+*
+* Loads the project's `maltty.config.ts`, starts the bundler in watch mode, and
+* logs rebuild status on each successful build.
+*/
+const devCommand = command({
+	description: "Start a maltty CLI project in development mode",
+	handler: async (ctx) => {
+		const cwd = process.cwd();
+		const [, configResult] = await loadConfig({ cwd });
+		const config = extractConfig(configResult);
+		ctx.status.spinner.start("Starting dev server...");
+		const bundler = await createBundler({
+			config,
+			cwd
+		});
+		const onSuccess = createOnSuccess(ctx);
+		const [watchError] = await bundler.watch({ onSuccess });
+		if (watchError) {
+			ctx.status.spinner.stop("Watch failed");
+			return ctx.fail(watchError.message);
+		}
+	}
+});
+/**
+* Create an onSuccess callback that tracks first-build state.
+*
+* On the first invocation the spinner is stopped and a "watching" message is
+* logged. Subsequent invocations log a "rebuilt" message instead.
+*
+* Uses a mutable container object inside the closure to track build count
+* without `let` reassignment.
+*
+* @private
+* @param ctx - The command context for logging and spinner access.
+* @returns A callback suitable for the watch `onSuccess` parameter.
+*/
+function createOnSuccess(ctx) {
+	const state = { buildCount: 0 };
+	return () => {
+		if (state.buildCount === 0) {
+			state.buildCount = 1;
+			ctx.status.spinner.stop("Watching for changes...");
+			return;
+		}
+		ctx.log.success("Rebuilt successfully");
+	};
+}
+//#endregion
+export { devCommand as default };
+
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","names":[],"sources":["../../src/commands/dev.ts"],"sourcesContent":["import { createBundler } from '@maltty/bundler'\nimport { loadConfig } from '@maltty/config/utils'\nimport { command } from 'maltty'\nimport type { Command, CommandContext } from 'maltty'\n\nimport { extractConfig } from '../lib/config-helpers.js'\n\n/**\n * Start a maltty CLI project in development mode with file watching.\n *\n * Loads the project's `maltty.config.ts`, starts the bundler in watch mode, and\n * logs rebuild status on each successful build.\n */\nconst devCommand: Command = command({\n  description: 'Start a maltty CLI project in development mode',\n  handler: async (ctx: CommandContext) => {\n    const cwd = process.cwd()\n\n    const [, configResult] = await loadConfig({ cwd })\n    const config = extractConfig(configResult)\n\n    ctx.status.spinner.start('Starting dev server...')\n\n    const bundler = await createBundler({ config, cwd })\n    const onSuccess = createOnSuccess(ctx)\n\n    const [watchError] = await bundler.watch({ onSuccess })\n\n    if (watchError) {\n      ctx.status.spinner.stop('Watch failed')\n      return ctx.fail(watchError.message)\n    }\n  },\n})\n\nexport default devCommand\n\n// ---------------------------------------------------------------------------\n\n/**\n * Create an onSuccess callback that tracks first-build state.\n *\n * On the first invocation the spinner is stopped and a \"watching\" message is\n * logged. Subsequent invocations log a \"rebuilt\" message instead.\n *\n * Uses a mutable container object inside the closure to track build count\n * without `let` reassignment.\n *\n * @private\n * @param ctx - The command context for logging and spinner access.\n * @returns A callback suitable for the watch `onSuccess` parameter.\n */\nfunction createOnSuccess(ctx: CommandContext): () => void {\n  const state = { buildCount: 0 }\n\n  return () => {\n    if (state.buildCount === 0) {\n      state.buildCount = 1\n      ctx.status.spinner.stop('Watching for changes...')\n      return\n    }\n\n    ctx.log.success('Rebuilt successfully')\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,MAAM,aAAsB,QAAQ;CAClC,aAAa;CACb,SAAS,OAAO,QAAwB;EACtC,MAAM,MAAM,QAAQ,KAAK;EAEzB,MAAM,GAAG,gBAAgB,MAAM,WAAW,EAAE,KAAK,CAAC;EAClD,MAAM,SAAS,cAAc,aAAa;AAE1C,MAAI,OAAO,QAAQ,MAAM,yBAAyB;EAElD,MAAM,UAAU,MAAM,cAAc;GAAE;GAAQ;GAAK,CAAC;EACpD,MAAM,YAAY,gBAAgB,IAAI;EAEtC,MAAM,CAAC,cAAc,MAAM,QAAQ,MAAM,EAAE,WAAW,CAAC;AAEvD,MAAI,YAAY;AACd,OAAI,OAAO,QAAQ,KAAK,eAAe;AACvC,UAAO,IAAI,KAAK,WAAW,QAAQ;;;CAGxC,CAAC;;;;;;;;;;;;;;AAmBF,SAAS,gBAAgB,KAAiC;CACxD,MAAM,QAAQ,EAAE,YAAY,GAAG;AAE/B,cAAa;AACX,MAAI,MAAM,eAAe,GAAG;AAC1B,SAAM,aAAa;AACnB,OAAI,OAAO,QAAQ,KAAK,0BAA0B;AAClD;;AAGF,MAAI,IAAI,QAAQ,uBAAuB"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "maltty";
+
+//#region src/commands/doctor.d.ts
+/**
+* Diagnose common maltty project issues.
+*
+* Validates config, checks package.json setup, verifies entry points exist,
+* and catches anything that could cause build or runtime failures.
+*/
+declare const doctorCommand: Command;
+//#endregion
+export { doctorCommand as default };
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","names":[],"sources":["../../src/commands/doctor.ts"],"mappings":";;;;;AAI6C;;;;cAmBvC,aAAA,EAAe,OAAA"}