@vlandoss/run-run 0.0.16-git-474ac67.0 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlandoss/run-run",
-  "version": "0.0.16-git-474ac67.0",
+  "version": "0.0.16",
   "description": "The CLI toolbox to fullstack common scripts in Variable Land",
   "homepage": "https://github.com/variableland/dx/tree/main/packages/run-run#readme",
   "bugs": {
@@ -32,16 +32,17 @@
   "dependencies": {
     "@biomejs/biome": "2.4.4",
     "commander": "14.0.3",
-    "glob": "^13.0.6",
+    "glob": "13.0.6",
     "is-ci": "4.1.0",
-    "lilconfig": "^3.1.3",
-    "memoize": "^10.2.0",
-    "oxfmt": "^0.35.0",
-    "oxlint": "^1.50.0",
-    "oxlint-tsgolint": "^0.15.0",
+    "lilconfig": "3.1.3",
+    "memoize": "10.2.0",
+    "oxfmt": "0.35.0",
+    "oxlint": "1.50.0",
+    "oxlint-tsgolint": "0.15.0",
     "rimraf": "6.1.3",
+    "tsdown": "0.21.0-beta.2",
     "typescript": "5.9.3",
-    "@vlandoss/clibuddy": "0.0.8-git-474ac67.0",
+    "@vlandoss/clibuddy": "0.0.8",
     "@vlandoss/loggy": "0.0.6"
   },
   "publishConfig": {

package/src/program/__tests__/__snapshots__/snapshots.test.ts.snap

@@ -1,37 +1,8 @@
 // Bun Snapshot v1, https://bun.sh/docs/test/snapshots
 
-exports[`should match all root commands: root-command-help 1`] = `
-"🦊 R U N - R U N: The CLI toolbox to fullstack common scripts in Variable Land 👊
-
-Usage: rr|run-run [options] <command...>
-
-Options:
-  -v, --version                output the version number
-  -h, --help                   display help for command
-
-Commands:
-  config|cfg                   display the current config 🛠️
-  check|test:static [options]  check format and lint issues 🔍
-  lint [options]               lint the code 🧹
-  fmt|format [options]         format the code 🎨
-  tsc|typecheck                check if TypeScript code is well typed 🎨
-  clean [options]              delete dirty folders or files such as
-                               node_modules, etc 🗑️
-  pkgs|packages [options]      list unique affected packages from list of files
-                               📦
-  help [command]               display help for command
-
-Acknowledgment:
-- kcd-scripts: for main inspiration
-  https://github.com/kentcdodds/kcd-scripts
-
-- peruvian news: in honor to Run Run
-  https://es.wikipedia.org/wiki/Run_Run
-"
-`;
-
 exports[`should match all root commands: root-command---help 1`] = `
-"🦊 R U N - R U N: The CLI toolbox to fullstack common scripts in Variable Land 👊
+"🦊 R U N - R U N v0.0.0-test
+The CLI toolbox for Variable Land 👊
 
 Usage: rr|run-run [options] <command...>
 
@@ -40,16 +11,15 @@ Options:
   -h, --help                   display help for command
 
 Commands:
-  config|cfg                   display the current config 🛠️
-  check|test:static [options]  check format and lint issues 🔍
-  lint [options]               lint the code 🧹
-  fmt|format [options]         format the code 🎨
-  tsc|typecheck                check if TypeScript code is well typed 🎨
-  clean [options]              delete dirty folders or files such as
-                               node_modules, etc 🗑️
+  build:lib                    build a ts project 🏗️ (tsdown)
+  lint [options]               lint the code 🧹 (biome)
+  fmt|format [options]         format the code 🎨 (biome)
+  check|test:static [options]  check format and lint 🔍 (biome)
+  tsc|typecheck                check if ts code is well typed 🎨 (tsc)
+  clean [options]              delete dirty folders or files 🗑️ (rimraf)
   pkgs|packages [options]      list unique affected packages from list of files
                                📦
-  help [command]               display help for command
+  config|cfg                   display the current config 🛠️
 
 Acknowledgment:
 - kcd-scripts: for main inspiration
@@ -70,45 +40,22 @@ exports[`should match all root commands: root-command--v 1`] = `
 "
 `;
 
-exports[`should match help messages for all commands: help-command-run 1`] = `
-"Usage: rr run [options] <cmds...>
+exports[`should match help messages for all commands: help-command-build:lib 1`] = `
+"Usage: rr build:lib [options]
 
-Arguments:
-  cmds        commands to execute concurrently (e.g. 'check tsc')
+build a ts project 🏗️ (tsdown)
 
 Options:
   -h, --help  display help for command
-"
-`;
-
-exports[`should match help messages for all commands: help-command-config 1`] = `
-"Usage: rr config|cfg [options]
 
-display the current config 🛠️
-
-Options:
-  -h, --help  display help for command
-"
-`;
-
-exports[`should match help messages for all commands: help-command-check 1`] = `
-"Usage: rr check|test:static [options]
-
-check format and lint issues 🔍
-
-Options:
-  -f, --fix     try to fix issues automatically
-  --fix-staged  try to fix staged files only
-  -h, --help    display help for command
-
-Under the hood, this command uses the biome CLI to check the code.
+Under the hood, this command uses the tsdown CLI to build the project.
 "
 `;
 
 exports[`should match help messages for all commands: help-command-lint 1`] = `
 "Usage: rr lint [options]
 
-lint the code 🧹
+lint the code 🧹 (biome)
 
 Options:
   -c, --check  check if the code is valid (default: true)
@@ -122,7 +69,7 @@ Under the hood, this command uses the biome CLI to lint the code.
 exports[`should match help messages for all commands: help-command-fmt 1`] = `
 "Usage: rr fmt|format [options]
 
-format the code 🎨
+format the code 🎨 (biome)
 
 Options:
   -c, --check  check if the code is formatted (default: true)
@@ -133,29 +80,43 @@ Under the hood, this command uses the biome CLI to format the code.
 "
 `;
 
+exports[`should match help messages for all commands: help-command-check 1`] = `
+"Usage: rr check|test:static [options]
+
+check format and lint 🔍 (biome)
+
+Options:
+  -f, --fix     try to fix issues automatically
+  --fix-staged  try to fix staged files only
+  -h, --help    display help for command
+
+Under the hood, this command uses the biome CLI to check the code.
+"
+`;
+
 exports[`should match help messages for all commands: help-command-tsc 1`] = `
 "Usage: rr tsc|typecheck [options]
 
-check if TypeScript code is well typed 🎨
+check if ts code is well typed 🎨 (tsc)
 
 Options:
   -h, --help  display help for command
 
-Under the hood, this command uses the TypeScript CLI to check the code.
+Under the hood, this command uses the tsc CLI to check the code.
 "
 `;
 
 exports[`should match help messages for all commands: help-command-clean 1`] = `
 "Usage: rr clean [options]
 
-delete dirty folders or files such as node_modules, etc 🗑️
+delete dirty folders or files 🗑️ (rimraf)
 
 Options:
   --only-dist  delete 'dist' folders only
   --dry-run    outputs the paths that would be deleted
   -h, --help   display help for command
 
-Under the hood, this command uses the rimraf.js to delete dirty folders or files.
+Under the hood, this command uses rimraf to delete dirty folders or files.
 "
 `;
 
@@ -171,6 +132,27 @@ Options:
 "
 `;
 
+exports[`should match help messages for all commands: help-command-config 1`] = `
+"Usage: rr config|cfg [options]
+
+display the current config 🛠️
+
+Options:
+  -h, --help  display help for command
+"
+`;
+
+exports[`should match help messages for all commands: help-command-run 1`] = `
+"Usage: rr run [options] <cmds...>
+
+Arguments:
+  cmds        commands to execute concurrently (e.g. 'check tsc')
+
+Options:
+  -h, --help  display help for command
+"
+`;
+
 exports[`should match help messages for all commands: help-command-tools 1`] = `
 "Usage: rr tools [options] [command]
 

package/src/program/__tests__/snapshots.test.ts

@@ -4,7 +4,7 @@ import { createTestProgram, execCli, mocked } from "#test/helpers";
 const { program, ctx } = await createTestProgram();
 const $ = ctx.shell.$;
 
-const rootCommands = ["help", "--help", "--version", "-v"];
+const rootCommands = ["--help", "--version", "-v"];
 
 afterEach(() => {
   mocked($).mockClear();

package/src/program/commands/build-lib.ts

@@ -0,0 +1,12 @@
+import { createCommand } from "commander";
+import { TOOL_LABELS } from "#/program/ui";
+import type { Context } from "#/services/ctx";
+
+export function createBuildLibCommand(ctx: Context) {
+  return createCommand("build:lib")
+    .description(`build a ts project 🏗️ (${TOOL_LABELS.TSDOWN})`)
+    .action(async function buildAction() {
+      await ctx.shell.$`tsdown`;
+    })
+    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${TOOL_LABELS.TSDOWN} CLI to build the project.`);
+}

package/src/program/commands/check.ts

@@ -4,13 +4,14 @@ import { BiomeService } from "#/services/biome";
 import type { Context } from "#/services/ctx";
 
 export function createCheckCommand(ctx: Context) {
+  const biome = new BiomeService(ctx.shell);
+
   return createCommand("check")
     .alias("test:static")
-    .description("check format and lint issues 🔍")
+    .description(`check format and lint 🔍 (${biome.ui})`)
     .option("-f, --fix", "try to fix issues automatically")
     .option("--fix-staged", "try to fix staged files only")
     .action(async function checkAction(options) {
-      const biome = new BiomeService(ctx.shell);
       const toolCmd = (cmd = "check") => `${cmd} --colors=force`;
 
       if (options.fix) {
@@ -21,5 +22,5 @@ export function createCheckCommand(ctx: Context) {
         await biome.exec(`${toolCmd(isCI ? "ci" : "check")}`);
       }
     })
-    .addHelpText("afterAll", "\nUnder the hood, this command uses the biome CLI to check the code.");
+    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${biome.ui} CLI to check the code.`);
 }

package/src/program/commands/clean.ts

@@ -3,6 +3,7 @@ import { createCommand } from "commander";
 import { type GlobOptions, glob } from "glob";
 import { rimraf } from "rimraf";
 import { logger } from "#/services/logger";
+import { TOOL_LABELS } from "../ui";
 
 type Options = {
   onlyDist: boolean;
@@ -11,7 +12,7 @@ type Options = {
 
 export function createCleanCommand() {
   return createCommand("clean")
-    .description("delete dirty folders or files such as node_modules, etc 🗑️")
+    .description(`delete dirty folders or files 🗑️ (${TOOL_LABELS.RIMRAF})`)
     .option("--only-dist", "delete 'dist' folders only")
     .option("--dry-run", "outputs the paths that would be deleted")
     .action(async function cleanCommandAction(options: Options) {
@@ -47,5 +48,5 @@ export function createCleanCommand() {
         });
       }
     })
-    .addHelpText("afterAll", "\nUnder the hood, this command uses the rimraf.js to delete dirty folders or files.");
+    .addHelpText("afterAll", `\nUnder the hood, this command uses ${TOOL_LABELS.RIMRAF} to delete dirty folders or files.`);
 }

package/src/program/commands/config.ts

@@ -1,4 +1,4 @@
-import { colors } from "@vlandoss/clibuddy";
+import { palette } from "@vlandoss/clibuddy";
 import { createCommand } from "commander";
 import type { Context } from "#/services/ctx";
 
@@ -8,8 +8,8 @@ export function createConfigCommand(ctx: Context) {
     .description("display the current config 🛠️")
     .action(async function configAction() {
       const { config, meta } = ctx.config;
-      console.log(colors.muted("Config:"));
+      console.log(palette.muted("Config:"));
       console.log(config);
-      console.log(colors.muted(`Loaded from ${meta.filepath ? colors.link(meta.filepath) : "n/a"}`));
+      console.log(palette.muted(`Loaded from ${meta.filepath ? palette.link(meta.filepath) : "n/a"}`));
     });
 }

package/src/program/commands/format.ts

@@ -24,11 +24,11 @@ export function createFormatCommand(ctx: Context) {
 
   return createCommand("fmt")
     .alias("format")
-    .description("format the code 🎨")
+    .description(`format the code 🎨 (${toolService.ui})`)
     .option("-c, --check", "check if the code is formatted", true)
     .option("-f, --fix", "format all the code")
     .action(async function formatAction(options: ActionOptions) {
       await toolService.format(options);
     })
-    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolService.bin} CLI to format the code.`);
+    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolService.ui} CLI to format the code.`);
 }

package/src/program/commands/lint.ts

@@ -23,11 +23,11 @@ export function createLintCommand(ctx: Context) {
   const toolService = getToolService(ctx);
 
   return createCommand("lint")
-    .description("lint the code 🧹")
+    .description(`lint the code 🧹 (${toolService.ui})`)
     .option("-c, --check", "check if the code is valid", true)
     .option("-f, --fix", "try to fix all the code")
     .action(async function lintAction(options: ActionOptions) {
       await toolService.lint(options);
     })
-    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolService.bin} CLI to lint the code.`);
+    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolService.ui} CLI to lint the code.`);
 }

package/src/program/commands/typecheck.ts

@@ -4,6 +4,7 @@ import { createCommand } from "commander";
 import type { Context } from "#/services/ctx";
 import { logger } from "#/services/logger";
 import { OxlintService } from "#/services/oxlint";
+import { TOOL_LABELS } from "../ui";
 
 type TypecheckAtOptions = {
   dir: string;
@@ -51,13 +52,12 @@ export function createTypecheckCommand(ctx: Context) {
     config: { config },
   } = ctx;
 
+  const toolUi = config.future?.oxc ? TOOL_LABELS.OXLINT : TOOL_LABELS.TSC;
+
   return createCommand("tsc")
     .alias("typecheck")
-    .description("check if TypeScript code is well typed 🎨")
-    .addHelpText(
-      "afterAll",
-      `\nUnder the hood, this command uses the ${config.future?.oxc ? "oxlint" : "TypeScript"} CLI to check the code.`,
-    )
+    .description(`check if ts code is well typed 🎨 (${toolUi})`)
+    .addHelpText("afterAll", `\nUnder the hood, this command uses the ${toolUi} CLI to check the code.`)
     .action(async function typecheckAction() {
       const isTsProject = (dir: string) => appPkg.hasFile("tsconfig.json", dir);
 
@@ -91,7 +91,7 @@ export function createTypecheckCommand(ctx: Context) {
       const tsProjects = projects.filter((project) => isTsProject(project.rootDir));
 
       if (!tsProjects.length) {
-        logger.warn("No TypeScript projects found in the monorepo, skipping typecheck");
+        logger.warn("No ts projects found in the monorepo, skipping typecheck");
         return;
       }
 

package/src/program/index.ts

@@ -1,6 +1,7 @@
 import { getVersion } from "@vlandoss/clibuddy";
 import { createCommand } from "commander";
 import { createContext } from "#/services/ctx";
+import { createBuildLibCommand } from "./commands/build-lib";
 import { createCheckCommand } from "./commands/check";
 import { createCleanCommand } from "./commands/clean";
 import { createConfigCommand } from "./commands/config";
@@ -10,7 +11,7 @@ import { createPkgsCommand } from "./commands/pkgs";
 import { createRunCommand } from "./commands/run";
 import { createToolsCommand } from "./commands/tools";
 import { createTypecheckCommand } from "./commands/typecheck";
-import { BANNER_TEXT, CREDITS_TEXT } from "./ui";
+import { CREDITS_TEXT, getBannerText } from "./ui";
 
 export type Options = {
   binDir: string;
@@ -18,26 +19,30 @@ export type Options = {
 
 export async function createProgram(options: Options) {
   const ctx = await createContext(options.binDir);
+  const version = getVersion(ctx.binPkg);
 
   const program = createCommand("rr")
     .alias("run-run")
     .usage("[options] <command...>")
-    .version(getVersion(ctx.binPkg), "-v, --version")
-    .addHelpText("before", BANNER_TEXT)
+    .helpCommand(false)
+    .version(version, "-v, --version")
+    .addHelpText("before", getBannerText(version))
     .addHelpText("after", CREDITS_TEXT)
-    .addCommand(createRunCommand(ctx), {
-      hidden: true,
-    })
-    .addCommand(createConfigCommand(ctx))
-    .addCommand(createCheckCommand(ctx))
+    // build
+    .addCommand(createBuildLibCommand(ctx))
+    // check
     .addCommand(createLintCommand(ctx))
     .addCommand(createFormatCommand(ctx))
+    .addCommand(createCheckCommand(ctx))
     .addCommand(createTypecheckCommand(ctx))
+    // misc
     .addCommand(createCleanCommand())
     .addCommand(createPkgsCommand(ctx))
-    .addCommand(createToolsCommand(ctx), {
-      hidden: true,
-    });
+    // config
+    .addCommand(createConfigCommand(ctx))
+    // hidden
+    .addCommand(createRunCommand(ctx), { hidden: true })
+    .addCommand(createToolsCommand(ctx), { hidden: true });
 
   return { program, ctx };
 }

package/src/program/ui.ts

@@ -1,14 +1,66 @@
-import { colors } from "@vlandoss/clibuddy";
-
-export const UI_LOGO = `🦊 ${colors.blueBright("R")} ${colors.redBright("U")} ${colors.greenBright("N")} - ${colors.blueBright("R")} ${colors.redBright("U")} ${colors.greenBright("N")}`;
-
-const COMPANY_LOGO = `${colors.redBright("Variable Land")} 👊`;
-
-export const BANNER_TEXT = `${UI_LOGO}: The CLI toolbox to fullstack common scripts in ${COMPANY_LOGO}\n`;
+import { colorIsSupported, colorize, palette } from "@vlandoss/clibuddy";
 
 export const CREDITS_TEXT = `\nAcknowledgment:
 - kcd-scripts: for main inspiration
-  https://github.com/kentcdodds/kcd-scripts
+  ${palette.link("https://github.com/kentcdodds/kcd-scripts")}
 
 - peruvian news: in honor to Run Run
-  https://es.wikipedia.org/wiki/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");
+
+export const TOOL_LABELS = {
+  TSDOWN: tsdownColor("tsdown"),
+  BIOME: biomeColor("biome"),
+  OXLINT: oxlintColor("oxlint"),
+  OXFMT: oxfmtColor("oxfmt"),
+  TSC: tscColor("tsc"),
+  RIMRAF: rimrafColor("rimraf"),
+};
+
+export function getBannerText(version: string) {
+  const uiLogo = `🦊 ${palette.bold("R")} ${palette.bold("U")} ${palette.bold("N")} - ${palette.bold("R")} ${palette.bold("U")} ${palette.bold("N")}`;
+  const vlandLogo = `${palette.vland("Variable Land")} 👊`;
+
+  const title = `${uiLogo} ${palette.muted(`v${version}`)}`;
+  const subtitle = `${palette.italic(palette.muted("The CLI toolbox for"))} ${vlandLogo}`;
+
+  if (!colorIsSupported()) {
+    return `${title}\n${subtitle}\n`;
+  }
+
+  const FOX_COLORS = {
+    BLACK: colorize("#39393A"),
+    ORANGE: colorize("FC7A1e"),
+    WHITE: colorize("#FFFFFF"),
+  };
+
+  const _ = "  "; // hole
+  const B = FOX_COLORS.BLACK("██"); // black
+  const O = FOX_COLORS.ORANGE("██"); // orange
+  const W = FOX_COLORS.WHITE("██"); // white
+
+  const grid = [
+    [_, B, _, _, _, _, _, B, _],
+    [_, O, W, _, _, _, W, O, _],
+    [_, O, W, O, _, O, W, O, _],
+    [B, O, O, O, O, O, O, O, B],
+    [O, O, O, O, O, O, O, O, O],
+    [W, O, B, O, O, O, B, O, W],
+    [_, W, W, O, O, O, W, W, _],
+    [_, _, W, W, B, W, W, _, _],
+    [_, _, _, W, W, W, _, _, _],
+  ];
+
+  const lines = grid.map((row) => row.join(""));
+
+  lines[3] += `    ${title}`;
+  lines[4] += `    ${subtitle}`;
+
+  return `${lines.join("\n")}\n`;
+}

package/src/services/biome.ts

@@ -1,10 +1,11 @@
 import type { ShellService } from "@vlandoss/clibuddy";
+import { TOOL_LABELS } from "#/program/ui";
 import type { FormatOptions, Formatter, Linter, LintOptions } from "#/types/tool";
 import { ToolService } from "./tool";
 
 export class BiomeService extends ToolService implements Formatter, Linter {
   constructor(shellService: ShellService) {
-    super({ bin: "biome", shellService });
+    super({ bin: "biome", ui: TOOL_LABELS.BIOME, shellService });
   }
 
   getBinDir() {

package/src/services/oxfmt.ts

@@ -1,10 +1,11 @@
 import type { ShellService } from "@vlandoss/clibuddy";
+import { TOOL_LABELS } from "#/program/ui";
 import type { FormatOptions, Formatter } from "#/types/tool";
 import { ToolService } from "./tool";
 
 export class OxfmtService extends ToolService implements Formatter {
   constructor(shellService: ShellService) {
-    super({ bin: "oxfmt", shellService });
+    super({ bin: "oxfmt", ui: TOOL_LABELS.OXFMT, shellService });
   }
 
   getBinDir() {

package/src/services/oxlint.ts

@@ -1,10 +1,11 @@
 import type { ShellService } from "@vlandoss/clibuddy";
+import { TOOL_LABELS } from "#/program/ui";
 import type { Linter, LintOptions } from "#/types/tool";
 import { ToolService } from "./tool";
 
 export class OxlintService extends ToolService implements Linter {
   constructor(shellService: ShellService) {
-    super({ bin: "oxlint", shellService });
+    super({ bin: "oxlint", ui: TOOL_LABELS.OXLINT, shellService });
   }
 
   getBinDir() {

package/src/services/tool.ts

@@ -4,15 +4,18 @@ import { gracefullBinDir } from "#/utils/gracefullBinDir";
 
 type CreateOptions = {
   bin: string;
+  ui?: string;
   shellService: ShellService;
 };
 
 export abstract class ToolService {
   #shellService: ShellService;
   #bin: string;
+  #ui: string;
 
-  constructor({ bin: cmd, shellService }: CreateOptions) {
-    this.#bin = cmd;
+  constructor({ bin, ui, shellService }: CreateOptions) {
+    this.#bin = bin;
+    this.#ui = ui ?? bin;
     this.#shellService = shellService;
   }
 
@@ -37,4 +40,8 @@ export abstract class ToolService {
   get bin() {
     return this.#bin;
   }
+
+  get ui() {
+    return this.#ui;
+  }
 }

package/src/types/tool.ts

@@ -10,10 +10,12 @@ export type LintOptions = {
 
 export type Formatter = {
   bin: string;
+  ui: string;
   format(options: FormatOptions): Promise<void>;
 };
 
 export type Linter = {
   bin: string;
+  ui: string;
   lint(options: LintOptions): Promise<void>;
 };