@goodie-ts/cli

CLI for goodie-ts compile-time dependency injection.

Install

pnpm add -D @goodie-ts/cli

Requires Node.js >= 22.13 (for recursive fs.watch on Linux).

Overview

Runs the goodie-ts transformer from the command line. Use it as a standalone code generation step, or with --watch for continuous rebuilds during development. This is the recommended way to integrate goodie-ts into non-Vite projects.

Usage

# One-shot generation (defaults: tsconfig.json -> src/AppContext.generated.ts)
goodie generate

# Custom paths
goodie generate --tsconfig tsconfig.app.json --output src/generated/Context.ts

# Watch mode — rebuild on .ts changes
goodie generate --watch

# Watch a specific directory
goodie generate --watch --watch-dir src

Options

| Flag | Default | Description | |------|---------|-------------| | --tsconfig | tsconfig.json | Path to tsconfig.json | | --output | src/AppContext.generated.ts | Output file path | | --watch | false | Watch for changes and rebuild | | --watch-dir | . (cwd) | Directory to watch (recursive) |

Programmatic API

import { runTransform, logOutcome, watchAndRebuild } from '@goodie-ts/cli';

// One-shot
const outcome = runTransform({
  tsConfigPath: './tsconfig.json',
  outputPath: './src/AppContext.generated.ts',
});
logOutcome(outcome);

// Watch
const handle = watchAndRebuild({
  tsConfigPath: './tsconfig.json',
  outputPath: './src/AppContext.generated.ts',
  watchDir: './src',
});
// handle.close() to stop

package.json integration

{
  "scripts": {
    "generate": "goodie generate",
    "generate:watch": "goodie generate --watch"
  }
}

License

MIT