@vlandoss/run-run 0.6.2-git-74f39bb.0 → 0.6.2-git-a1181c2.0

package/dist/cli.usage.kdl

@@ -0,0 +1,71 @@
+// @generated by @usage-spec/commander from Commander.js metadata
+name rr
+bin rr
+version "0.6.2-git-a1181c2.0"
+usage "[options] <command...>"
+flag --usage help="print KDL spec for this CLI (https://kdl.dev)"
+cmd completion help="print shell completion script 🐚 (usage)" {
+	long_help "Prints a shell completion script for rr. Add to your shell rc file:\n\n  bash: eval \"$(rr completion bash)\"\n  zsh:  eval \"$(rr completion zsh)\"\n  fish: rr completion fish | source"
+	arg <shell> help="target shell" {
+		choices bash zsh fish
+	}
+}
+cmd build:lib help="build a ts library 🏗️ (tsdown)" {
+	long_help "Compiles TypeScript code into JavaScript and generates type declaration files, making it ready for distribution."
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd jsc help="check format and lint 🔍 (biome)" {
+	alias jscheck
+	long_help "Checks the code for formatting and linting issues, ensuring it adheres to the defined style and quality standards."
+	flag --fix help="try to fix issues automatically"
+	flag --fix-staged help="try to fix staged files only"
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd tsc help="check typescript errors 📐 (tsc)" {
+	alias tscheck
+	long_help "Checks the TypeScript code for type errors, ensuring that the code adheres to the defined type constraints and helps catch potential issues before runtime."
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd lint help="check & fix lint errors 🔍 (biome)" {
+	long_help "Checks the code for linting issues and optionally fixes them, ensuring it adheres to the defined quality standards."
+	flag "-c --check" help="check if the code is valid" default=#true
+	flag --fix help="try to fix all the code"
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd format help="check & fix format errors 🎨 (biome)" {
+	long_help "Checks the code for formatting issues and optionally fixes them, ensuring it adheres to the defined style standards."
+	flag --fix help="format all the code"
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd check help="run static checks 🔬 (run-run)" {
+	long_help "Runs static checks, including linting, formatting checks, and TypeScript type checking, to ensure code quality and correctness without executing the code."
+}
+cmd clean help="delete dirty files 🗑️ (rimraf)" {
+	long_help "Deletes generated files and folders such as 'dist', 'node_modules', and lock files to ensure a clean state."
+	flag --only-dist help="delete 'dist' folders only"
+	flag --dry-run help="outputs the paths that would be deleted"
+}
+cmd pkgs help="list affected packages 📦" {
+	long_help "Given a list of files, returns the list of affected packages. Useful to run commands only on affected packages."
+	flag --files help="list of files to check" var=#true {
+		arg <FILES>
+	}
+	flag --decorator help="type of decorator to use" {
+		arg <DECORATOR> {
+			choices turbo
+		}
+	}
+}
+cmd x help="run multiple rr subcommands concurrently" {
+	long_help "Run multiple rr subcommands concurrently (e.g. `rr x jsc tsc`)."
+	arg <cmds>… help="rr subcommands to execute concurrently" var=#true
+}
+cmd config help="display the current config 🛠️" {
+	long_help "Displays the current configuration settings, including their source file path if available."
+}
+cmd tools hide=#true subcommand_required=#true help="expose the internal tools 🛠️" {
+	cmd biome
+	cmd oxfmt
+	cmd oxlint
+	cmd tsdown
+}

package/dist/config.d.mts

@@ -0,0 +1,11 @@
+//#region src/types/config.d.ts
+type UserConfig = {
+  future?: {
+    oxc?: boolean;
+  };
+};
+//#endregion
+//#region src/lib/config.d.ts
+declare function defineConfig(config: UserConfig): UserConfig;
+//#endregion
+export { defineConfig };

package/dist/config.mjs

@@ -0,0 +1,6 @@
+//#region src/lib/config.ts
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+export { defineConfig };

package/dist/run.mjs

@@ -0,0 +1,535 @@
+import path from "node:path";
+import { colorize, createPkg, createShellService, cwd, dirnameOf, isCI, palette, resolvePackageBin, run, text } from "@vlandoss/clibuddy";
+import { Argument, Option, createCommand } from "commander";
+import fs from "node:fs";
+import os from "node:os";
+import { lilconfig } from "lilconfig";
+import { createLoggy } from "@vlandoss/loggy";
+import { glob } from "glob";
+import { rimraf } from "rimraf";
+import memoize from "memoize";
+import { generateToStdout } from "@usage-spec/commander";
+//#region src/services/logger.ts
+const logger = createLoggy({ namespace: "run-run" });
+//#endregion
+//#region src/services/config.ts
+const DEFAULT_CONFIG = { future: { oxc: false } };
+var ConfigService = class {
+	#searcher;
+	constructor() {
+		this.#searcher = lilconfig("run-run", {
+			searchPlaces: ["run-run.config.ts", "run-run.config.mts"],
+			cache: true,
+			stopDir: os.homedir(),
+			loaders: {
+				".ts": (filepath) => import(filepath).then((mod) => mod.default),
+				".mts": (filepath) => import(filepath).then((mod) => mod.default)
+			}
+		});
+	}
+	async load() {
+		const debug = logger.subdebug("load-config");
+		const searchResult = await this.#searcher.search();
+		if (!searchResult || searchResult?.isEmpty) {
+			debug("loaded default config: %O", DEFAULT_CONFIG);
+			return {
+				config: DEFAULT_CONFIG,
+				meta: {
+					isDefault: true,
+					filepath: void 0
+				}
+			};
+		}
+		const config = searchResult.config;
+		debug("loaded config: %O", config);
+		debug("config file: %s", searchResult.filepath);
+		return {
+			config,
+			meta: {
+				isDefault: false,
+				filepath: searchResult.filepath
+			}
+		};
+	}
+};
+//#endregion
+//#region src/services/ctx.ts
+async function createContext(binDir) {
+	const debug = logger.subdebug("create-context");
+	const binPath = fs.realpathSync(binDir);
+	debug("bin path:", binPath);
+	debug("process cwd:", process.cwd());
+	const [appPkg, binPkg] = await Promise.all([createPkg(cwd), createPkg(binPath)]);
+	if (!binPkg) throw new Error("Could not find bin package.json");
+	if (!appPkg) throw new Error("Could not find app package.json");
+	debug("app pkg info: %O", appPkg.info());
+	debug("bin pkg info: %O", binPkg.info());
+	const shell = createShellService();
+	debug("shell service options: %O", shell.options);
+	return {
+		appPkg,
+		binPkg,
+		shell,
+		config: await new ConfigService().load()
+	};
+}
+//#endregion
+//#region src/program/ui.ts
+const CREDITS_TEXT = `\nAcknowledgment:
+- kcd-scripts: for main inspiration
+  ${palette.link("https://github.com/kentcdodds/kcd-scripts")}
+
+- peruvian news: in honor to Run Run
+  ${palette.link("https://es.wikipedia.org/wiki/Run_Run")}`;
+const tsdownColor = colorize("#FF7E18");
+const biomeColor = colorize("#61A5FA");
+const oxlintColor = colorize("#32F3E9");
+const oxfmtColor = colorize("#32F3E9");
+const tscColor = colorize("#3178C6");
+const rimrafColor = colorize("#7C7270");
+const runRunColor = colorize("#E8722A");
+const usageColor = colorize("#24C55E");
+const TOOL_LABELS = {
+	TSDOWN: tsdownColor("tsdown"),
+	BIOME: biomeColor("biome"),
+	OXLINT: oxlintColor("oxlint"),
+	OXFMT: oxfmtColor("oxfmt"),
+	TSC: tscColor("tsc"),
+	RIMRAF: rimrafColor("rimraf"),
+	RUN_RUN: runRunColor("run-run"),
+	USAGE: usageColor("usage")
+};
+function getBannerText(version) {
+	return `
+${runRunColor(`
+██████╗ ██╗   ██╗███╗   ██╗      ██████╗ ██╗   ██╗███╗   ██╗
+██╔══██╗██║   ██║████╗  ██║      ██╔══██╗██║   ██║████╗  ██║
+██████╔╝██║   ██║██╔██╗ ██║█████╗██████╔╝██║   ██║██╔██╗ ██║
+██╔══██╗██║   ██║██║╚██╗██║╚════╝██╔══██╗██║   ██║██║╚██╗██║
+██║  ██║╚██████╔╝██║ ╚████║      ██║  ██║╚██████╔╝██║ ╚████║
+╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝      ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝ ${text.version(version)}
+`.trim())}
+
+🦊 ${palette.italic(palette.muted("The CLI toolbox for"))} ${text.vland}\n`.trimStart();
+}
+//#endregion
+//#region src/services/tool.ts
+var ToolService = class {
+	#shellService;
+	#pkg;
+	#bin;
+	#ui;
+	get bin() {
+		return this.#bin;
+	}
+	get ui() {
+		return this.#ui;
+	}
+	get pkg() {
+		return this.#pkg;
+	}
+	constructor({ pkg, bin, ui, shellService }) {
+		this.#pkg = pkg;
+		this.#bin = bin ?? pkg;
+		this.#ui = ui;
+		this.#shellService = shellService;
+	}
+	async getBinDir() {
+		return resolvePackageBin(this.#pkg, {
+			from: import.meta.url,
+			binName: this.#bin
+		});
+	}
+	async exec(args = []) {
+		return this.#shellService.run(await this.getBinDir(), args, { display: this.#bin });
+	}
+	async doctor() {
+		const output = await this.#shellService.runCaptured(await this.getBinDir(), ["--help"], { throwOnError: false });
+		return {
+			ok: output.exitCode === 0,
+			output: {
+				stdout: output.stdout,
+				stderr: output.stderr,
+				exitCode: output.exitCode
+			}
+		};
+	}
+};
+//#endregion
+//#region src/services/tsdown.ts
+var TsdownService = class extends ToolService {
+	constructor(shellService) {
+		super({
+			pkg: "tsdown",
+			ui: TOOL_LABELS.TSDOWN,
+			shellService
+		});
+	}
+	async buildLib() {
+		await this.exec();
+	}
+};
+//#endregion
+//#region src/program/commands/doctor.ts
+function createDoctorSubcommand(service) {
+	return createCommand("doctor").summary("check if the underlying tool is working correctly").action(async function doctorAction() {
+		const debug = logger.subdebug("doctor");
+		const { ok, output } = await service.doctor();
+		if (ok) {
+			logger.success(`${service.ui} ok`);
+			debug("%O", output);
+		} else {
+			logger.error(`${service.ui} not working`);
+			debug("%O", output);
+			process.exit(output.exitCode ?? 1);
+		}
+	});
+}
+//#endregion
+//#region src/program/commands/build-lib.ts
+function createBuildLibCommand(ctx) {
+	const tsdownService = new TsdownService(ctx.shell);
+	return createCommand("build:lib").summary(`build a ts library 🏗️ (${tsdownService.ui})`).description("Compiles TypeScript code into JavaScript and generates type declaration files, making it ready for distribution.").addCommand(createDoctorSubcommand(tsdownService)).action(async function buildAction() {
+		await tsdownService.buildLib();
+	}).addHelpText("afterAll", `\nUnder the hood, this command uses the ${tsdownService.ui} CLI to build the project.`);
+}
+//#endregion
+//#region src/program/commands/check.ts
+function createCheckCommand(ctx) {
+	return createCommand("check").summary(`run static checks 🔬 (${TOOL_LABELS.RUN_RUN})`).description("Runs static checks, including linting, formatting checks, and TypeScript type checking, to ensure code quality and correctness without executing the code.").action(async function checkAction() {
+		await ctx.shell.run("rr", [
+			"x",
+			"jscheck",
+			"tscheck"
+		]);
+	});
+}
+//#endregion
+//#region src/program/commands/clean.ts
+function createCleanCommand() {
+	return createCommand("clean").summary(`delete dirty files 🗑️ (${TOOL_LABELS.RIMRAF})`).description("Deletes generated files and folders such as 'dist', 'node_modules', and lock files to ensure a clean state.").option("--only-dist", "delete 'dist' folders only").option("--dry-run", "outputs the paths that would be deleted").action(async function cleanCommandAction(options) {
+		async function run(paths, globOptions) {
+			if (options.dryRun) {
+				const toDelete = await glob(paths, globOptions);
+				logger.info("Paths that would be deleted: %O", toDelete);
+				return;
+			}
+			logger.start("Clean started");
+			await rimraf(paths, { glob: globOptions });
+			logger.success("Clean completed");
+		}
+		const BUILD_PATHS = ["**/dist"];
+		const ALL_DIRTY_PATHS = [
+			"**/.turbo",
+			"**/node_modules",
+			"pnpm-lock.yaml",
+			"bun.lock",
+			...BUILD_PATHS
+		];
+		if (options.onlyDist) await run(BUILD_PATHS, {
+			cwd,
+			ignore: ["**/node_modules/**"]
+		});
+		else await run(ALL_DIRTY_PATHS, { cwd });
+	}).addHelpText("afterAll", `\nUnder the hood, this command uses ${TOOL_LABELS.RIMRAF} to delete dirty folders or files.`);
+}
+//#endregion
+//#region src/program/commands/completion.ts
+const SHELLS = [
+	"bash",
+	"zsh",
+	"fish"
+];
+function createCompletionCommand() {
+	return createCommand("completion").summary(`print shell completion script 🐚 (${TOOL_LABELS.USAGE})`).description(`Prints a shell completion script for rr. Add to your shell rc file:
+
+  bash: eval "$(rr completion bash)"
+  zsh:  eval "$(rr completion zsh)"
+  fish: rr completion fish | source`).addArgument(new Argument("<shell>", `target shell`).choices(SHELLS)).addHelpText("afterAll", `\nUnder the hood, this command uses ${TOOL_LABELS.USAGE} (https://usage.jdx.dev).
+Make sure to have it installed and available in your PATH.`);
+}
+//#endregion
+//#region src/program/commands/config.ts
+function createConfigCommand(ctx) {
+	return createCommand("config").summary("display the current config 🛠️").description("Displays the current configuration settings, including their source file path if available.").action(async function configAction() {
+		const { config, meta } = ctx.config;
+		console.log(palette.muted("Config:"));
+		console.log(config);
+		console.log(palette.muted(`Loaded from ${meta.filepath ? palette.link(meta.filepath) : "n/a"}`));
+	});
+}
+//#endregion
+//#region src/services/biome.ts
+const COMMON_FLAGS = ["--colors=force", "--no-errors-on-unmatched"];
+var BiomeService = class extends ToolService {
+	constructor(shellService) {
+		super({
+			pkg: "@biomejs/biome",
+			bin: "biome",
+			ui: TOOL_LABELS.BIOME,
+			shellService
+		});
+	}
+	async format(options) {
+		const args = ["format", ...COMMON_FLAGS];
+		if (options.fix) args.push("--fix");
+		await this.exec(args);
+	}
+	async lint(options) {
+		const args = [
+			"check",
+			...COMMON_FLAGS,
+			"--formatter-enabled=false"
+		];
+		if (options.fix) args.push("--fix", "--unsafe");
+		await this.exec(args);
+	}
+	async check(options) {
+		if (options.fix) await this.exec([
+			"check",
+			...COMMON_FLAGS,
+			"--fix"
+		]);
+		else if (options.fixStaged) await this.exec([
+			"check",
+			...COMMON_FLAGS,
+			"--fix",
+			"--staged"
+		]);
+		else await this.exec([isCI ? "ci" : "check", ...COMMON_FLAGS]);
+	}
+};
+//#endregion
+//#region src/services/oxfmt.ts
+var OxfmtService = class extends ToolService {
+	constructor(shellService) {
+		super({
+			pkg: "oxfmt",
+			ui: TOOL_LABELS.OXFMT,
+			shellService
+		});
+	}
+	async format(options) {
+		await this.exec(["--no-error-on-unmatched-pattern", options.fix ? "--fix" : "--check"]);
+	}
+};
+//#endregion
+//#region src/program/commands/format.ts
+function getToolService$2(ctx) {
+	const { config } = ctx.config;
+	if (config.future?.oxc) return new OxfmtService(ctx.shell);
+	return new BiomeService(ctx.shell);
+}
+function createFormatCommand(ctx) {
+	const toolService = getToolService$2(ctx);
+	return createCommand("format").summary(`check & fix format errors 🎨 (${toolService.ui})`).description("Checks the code for formatting issues and optionally fixes them, ensuring it adheres to the defined style standards.").option("--fix", "format all the code").addCommand(createDoctorSubcommand(toolService)).action(async function formatAction(options) {
+		await toolService.format(options);
+	}).addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolService.ui} CLI to format the code.`);
+}
+//#endregion
+//#region src/program/commands/jscheck.ts
+function createJsCheckCommand(ctx) {
+	const checkerService = new BiomeService(ctx.shell);
+	return createCommand("jsc").alias("jscheck").summary(`check format and lint 🔍 (${checkerService.ui})`).description("Checks the code for formatting and linting issues, ensuring it adheres to the defined style and quality standards.").option("--fix", "try to fix issues automatically").option("--fix-staged", "try to fix staged files only").addCommand(createDoctorSubcommand(checkerService)).action(async function checkAction(options) {
+		await checkerService.check(options);
+	}).addHelpText("afterAll", `\nUnder the hood, this command uses the ${checkerService.ui} CLI to check the code.`);
+}
+//#endregion
+//#region src/services/oxlint.ts
+var OxlintService = class extends ToolService {
+	constructor(shellService) {
+		super({
+			pkg: "oxlint",
+			ui: TOOL_LABELS.OXLINT,
+			shellService
+		});
+	}
+	async lint(options) {
+		await this.exec(["--report-unused-disable-directives", options.fix ? "--fix" : "--check"]);
+	}
+};
+//#endregion
+//#region src/program/commands/lint.ts
+function getToolService$1(ctx) {
+	const { config } = ctx.config;
+	if (config.future?.oxc) return new OxlintService(ctx.shell);
+	return new BiomeService(ctx.shell);
+}
+function createLintCommand(ctx) {
+	const toolService = getToolService$1(ctx);
+	return createCommand("lint").summary(`check & fix lint errors 🔍 (${toolService.ui})`).description("Checks the code for linting issues and optionally fixes them, ensuring it adheres to the defined quality standards.").option("-c, --check", "check if the code is valid", true).option("--fix", "try to fix all the code").addCommand(createDoctorSubcommand(toolService)).action(async function lintAction(options) {
+		await toolService.lint(options);
+	}).addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolService.ui} CLI to lint the code.`);
+}
+//#endregion
+//#region src/program/commands/pkgs.ts
+const decorators = ["turbo"];
+function createPkgsCommand(ctx) {
+	return createCommand("pkgs").summary("list affected packages 📦").description("Given a list of files, returns the list of affected packages. Useful to run commands only on affected packages.").addOption(new Option("--files <files...>", "list of files to check")).addOption(new Option("--decorator [type]", "type of decorator to use").choices(decorators)).action(async function pkgsAction({ files, decorator }, cmd) {
+		const { appPkg } = ctx;
+		if (!appPkg.isMonorepo()) {
+			const cmdName = cmd.parent?.args[0] ?? cmd.args[0] ?? cmd.name();
+			logger.error(`The \`${cmdName}\` command can only be run in a monorepo.`);
+			return process.exit(1);
+		}
+		const projects = await appPkg.getWorkspaceProjects();
+		const getRelativeRootDir = memoize((rootDir) => {
+			const appDir = appPkg.dirPath;
+			if (!path.isAbsolute(rootDir)) return rootDir;
+			return path.relative(appDir, rootDir);
+		});
+		function getPackageForFile(filePath) {
+			for (const project of projects) {
+				const relativeRootDir = getRelativeRootDir(project.rootDir);
+				if (filePath.startsWith(relativeRootDir)) return project;
+			}
+			return null;
+		}
+		const uniquePkgsNames = /* @__PURE__ */ new Set();
+		files.forEach((file) => {
+			const pkg = getPackageForFile(file);
+			if (pkg?.manifest.name) uniquePkgsNames.add(pkg.manifest.name);
+		});
+		if (!uniquePkgsNames.size) return;
+		const pkgsNames = Array.from(uniquePkgsNames);
+		if (decorator === "turbo") console.log(...pkgsNames.map((name) => `--filter=...${name}`));
+		else console.log(...pkgsNames);
+	});
+}
+//#endregion
+//#region src/program/commands/tools.ts
+function getToolService(bin, shell) {
+	switch (bin) {
+		case "biome": return new BiomeService(shell);
+		case "oxfmt": return new OxfmtService(shell);
+		case "oxlint": return new OxlintService(shell);
+		case "tsdown": return new TsdownService(shell);
+		default: throw new Error(`Unknown tool: ${bin}`);
+	}
+}
+function createToolCommand(bin, shell) {
+	const tool = getToolService(bin, shell);
+	return createCommand(tool.bin).helpCommand(false).helpOption(false).allowExcessArguments(true).allowUnknownOption(true).action(async (_, { args }) => {
+		await tool.exec(args);
+	});
+}
+function createToolsCommand(ctx) {
+	return createCommand("tools").description("expose the internal tools 🛠️").passThroughOptions().addCommand(createToolCommand("biome", ctx.shell)).addCommand(createToolCommand("oxfmt", ctx.shell)).addCommand(createToolCommand("oxlint", ctx.shell)).addCommand(createToolCommand("tsdown", ctx.shell));
+}
+//#endregion
+//#region src/services/tsc.ts
+var TscService = class extends ToolService {
+	constructor(shellService) {
+		super({
+			pkg: "typescript",
+			bin: "tsc",
+			ui: TOOL_LABELS.TSC,
+			shellService
+		});
+	}
+};
+//#endregion
+//#region src/program/commands/tscheck.ts
+const getPreScript = (scripts) => scripts?.pretsc ?? scripts?.pretypecheck;
+async function typecheckAt({ dir, scripts, log, shell, run }) {
+	let shellAt;
+	log.debug(`checking types at ${dir}`);
+	if (cwd === dir) shellAt = shell;
+	else {
+		log.debug(`Changing directory to ${dir} for typecheck`);
+		shellAt = shell.at(dir);
+	}
+	try {
+		const preScript = getPreScript(scripts);
+		if (preScript) {
+			log.start(`Running pre-script: ${preScript}`);
+			await shellAt.run(preScript, [], { shell: true });
+			log.success("Pre-script completed");
+		}
+		log.start("Type checking started");
+		await run(shellAt);
+		log.success("Typecheck completed");
+	} catch (error) {
+		log.error("Typecheck failed");
+		throw error;
+	}
+}
+function createTsCheckCommand(ctx) {
+	const { appPkg, shell, config: { config } } = ctx;
+	const toolUi = config.future?.oxc ? TOOL_LABELS.OXLINT : TOOL_LABELS.TSC;
+	const doctorService = config.future?.oxc ? new OxlintService(shell) : new TscService(shell);
+	return createCommand("tsc").alias("tscheck").summary(`check typescript errors 📐 (${toolUi})`).description("Checks the TypeScript code for type errors, ensuring that the code adheres to the defined type constraints and helps catch potential issues before runtime.").addCommand(createDoctorSubcommand(doctorService)).addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolUi} CLI to check the code.`).action(async function typecheckAction() {
+		const isTsProject = (dir) => appPkg.hasFile("tsconfig.json", dir);
+		const runTypecheck = async (shell) => {
+			if (config.future?.oxc) await new OxlintService(shell).exec([
+				"--type-aware",
+				"--type-check",
+				"--report-unused-disable-directives"
+			]);
+			else await new TscService(shell).exec(["--noEmit"]);
+		};
+		if (!appPkg.isMonorepo()) {
+			if (!isTsProject(appPkg.dirPath)) {
+				logger.info("No tsconfig.json found, skipping typecheck");
+				return;
+			}
+			await typecheckAt({
+				shell,
+				run: runTypecheck,
+				dir: appPkg.dirPath,
+				scripts: appPkg.packageJson.scripts,
+				log: logger
+			});
+			return;
+		}
+		const tsProjects = (await appPkg.getWorkspaceProjects()).filter((project) => isTsProject(project.rootDir));
+		if (!tsProjects.length) {
+			logger.warn("No ts projects found in the monorepo, skipping typecheck");
+			return;
+		}
+		await Promise.all(tsProjects.map((p) => typecheckAt({
+			shell,
+			run: runTypecheck,
+			dir: p.rootDir,
+			scripts: p.manifest.scripts,
+			log: logger.child({
+				tag: p.manifest.name,
+				namespace: "typecheck"
+			})
+		})));
+	});
+}
+//#endregion
+//#region src/program/commands/usage.ts
+function addUsage(program) {
+	return program.addOption(new Option("--usage", "print KDL spec for this CLI (https://kdl.dev)")).on("option:usage", () => {
+		generateToStdout(program);
+		process.exit(0);
+	});
+}
+//#endregion
+//#region src/program/commands/x.ts
+function createXCommand(ctx) {
+	return createCommand("x").summary("run multiple rr subcommands concurrently").description("Run multiple rr subcommands concurrently (e.g. `rr x jsc tsc`).").argument("<cmds...>", "rr subcommands to execute concurrently").action(async function runXAction(cmds) {
+		if ((await Promise.allSettled(cmds.map((cmd) => ctx.shell.run("rr", [cmd])))).some((r) => r.status === "rejected")) process.exitCode = 1;
+	});
+}
+//#endregion
+//#region src/program/index.ts
+async function createProgram(options) {
+	const ctx = await createContext(options.binDir);
+	const version = ctx.binPkg.version;
+	return {
+		program: addUsage(createCommand("rr").usage("[options] <command...>").enablePositionalOptions().version(version, "-v, --version").addHelpText("before", getBannerText(version)).addHelpText("after", CREDITS_TEXT).addCommand(createCompletionCommand()).addCommand(createBuildLibCommand(ctx)).addCommand(createJsCheckCommand(ctx)).addCommand(createTsCheckCommand(ctx)).addCommand(createLintCommand(ctx)).addCommand(createFormatCommand(ctx)).addCommand(createCheckCommand(ctx)).addCommand(createCleanCommand()).addCommand(createPkgsCommand(ctx)).addCommand(createXCommand(ctx)).addCommand(createConfigCommand(ctx)).addCommand(createToolsCommand(ctx), { hidden: true })),
+		ctx
+	};
+}
+//#endregion
+//#region src/run.ts
+const BIN_DIR = path.dirname(dirnameOf(import.meta));
+await run(async () => {
+	const { program } = await createProgram({ binDir: BIN_DIR });
+	await program.parseAsync(process.argv, { from: "node" });
+}, logger);
+//#endregion
+export {};

package/dist/tools/tsdown.d.mts

@@ -0,0 +1 @@
+export * from "tsdown";

package/dist/tools/tsdown.mjs

@@ -0,0 +1,2 @@
+export * from "tsdown";
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlandoss/run-run",
-  "version": "0.6.2-git-74f39bb.0",
+  "version": "0.6.2-git-a1181c2.0",
   "description": "The CLI toolbox to fullstack common scripts in Variable Land",
   "homepage": "https://github.com/variableland/dx/tree/main/packages/run-run#readme",
   "bugs": {
@@ -12,10 +12,7 @@
     "directory": "packages/run-run"
   },
   "license": "MIT",
-  "author": {
-    "name": "rcrd",
-    "email": "rcrd@variable.land"
-  },
+  "author": "rcrd <rcrd@variable.land>",
   "type": "module",
   "imports": {
     "#src/*": "./src/*",
@@ -56,8 +53,6 @@
   "dependencies": {
     "@biomejs/biome": "2.4.4",
     "@usage-spec/commander": "1.1.0",
-    "@vlandoss/clibuddy": "0.6.1-git-74f39bb.0",
-    "@vlandoss/loggy": "0.2.1-git-74f39bb.0",
     "commander": "14.0.3",
     "glob": "13.0.6",
     "lilconfig": "3.1.3",
@@ -67,13 +62,13 @@
     "oxlint-tsgolint": "0.15.0",
     "rimraf": "6.1.3",
     "tsdown": "0.22.0",
-    "typescript": "6.0.3"
+    "typescript": "6.0.3",
+    "@vlandoss/loggy": "0.2.1-git-a1181c2.0",
+    "@vlandoss/clibuddy": "0.6.1-git-a1181c2.0"
   },
   "devDependencies": {
     "@vlandoss/tsdown-config": "^0.0.1"
   },
-  "readme": "ERROR: No README data found!",
-  "_id": "@vlandoss/run-run@0.6.1",
   "scripts": {
     "build": "tsdown && pnpm build:kdl",
     "build:kdl": "./bin --usage > dist/cli.usage.kdl",
@@ -82,4 +77,4 @@
     "test:integration": "vitest run --project integration",
     "test:types": "rr tsc"
   }
-}
+}