tools

TypeScript to ESM compilation via tsdown with opinionated defaults. Sourcemaps, clean dist/, unbundled output, .d.mts types by default, publint publish gate. Flags: --no-dts, --bundle, --minify. Default entry src/**/*.ts. Use when building a package for publish or generating declarations.

Watch mode development using Node --experimental-transform-types. No transpiler needed. Watches ./src/, restarts on changes. Custom entry files supported. Experimental command — may change. Use when running TypeScript in dev mode.

Code formatting via oxfmt with project configuration. Tabs, single quotes, semicolons always, trailing commas, 100-char line width. Use when formatting source files before committing.

Scaffold new Bombshell project from bombshell-dev/template via giget. Replaces $name placeholder in package.json and README.md. Outputs to .temp/. Use when creating a new package in the Bombshell ecosystem.

TDD-driven development workflow for Bombshell projects using bsh CLI. Covers pnpm run as only entry point, command ordering (test→implement→lint→format→build→test), monorepo vs single-package detection with pnpm --filter, human-owned PRs. Use when starting work on any project that depends on @bomb.sh/tools.

Multi-tool linting pipeline: oxlint, knip, and tsgo run in parallel via pnpm run lint (publint gates pnpm run build instead). Covers Bombshell conventions: URL over node:path, max 2 params with options bag, named exports only, import type, prefer node builtins, no console.log, no generic Error. Use when checking code quality or understanding lint violations.

Migrate existing project to bsh toolchain. Remove prettier, biome, eslint, tsup, unbuild, rollup, vitest configs and dependencies. Replace scripts with bsh equivalents. Adopt createMocks and createFixture from @bomb.sh/tools/test-utils. Consolidate to single @bomb.sh/tools devDependency. Migration order: inventory existing tools, add unimplemented commands, replace 1:1 commands, remove configs and deps, adopt test-utils, verify. Use when onboarding a project to the Bombshell ecosystem.

Vitest test runner with colocated .test.ts files and test utilities from @bomb.sh/tools/test-utils. Covers createFixture (temp directories, inline file trees, hfs API), createMocks (env stubbing, MockReadable/MockWritable streams, auto-cleanup), .test-d.ts type-level tests, and auto-loaded vitest config. Use when writing or running tests in Bombshell projects.