BITE

bite is a CLI tool designed to transform TypeScript (.ts & .tsx) files into JavaScript using Babel while also generating TypeScript declaration files (.d.ts). It supports monorepos, watch mode, caching, and optimized TypeScript compilation.

Features

• Transforms .ts and .tsx files to .js and .jsx using Babel
• Generates TypeScript declaration files (.d.ts)
• Supports a custom Babel and TypeScript configuration
• Watch mode for automatic re-transpilation on file changes
• Cleans the output directory before transpiling (optional)
• Works seamlessly within a monorepo setup
• Lightweight and fast with debounced file watching
• Includes a "witty" mode for fun logging messages

Installation

npm install @smallcase/bite

Usage

Basic Command

bite-tsx-transform --src ./lib --dist ./dist

Options

| Option | Alias | Type | Description | Required | | --------------- | ----- | ------- | ----------------------------------------------- | -------- | | --src | | string | Path to the source directory (default: src/) | ❌ No | | --dist | | string | Path to the output directory (default: dist/) | ❌ No | | --watch | -w | boolean | Enables watch mode | ❌ No | | --clean | | boolean | Cleans the output directory before transpiling | ❌ No | | --tsConfig | | string | Path to custom tsconfig.json | ❌ No | | --babelConfig | | string | Path to custom babel.config.json | ❌ No | | --version | | boolean | Show CLI version | ❌ No | | --witty | | boolean | Enables witty logging messages | ❌ No |

Examples

Transform TypeScript Files

bite-tsx-transform  --src ./src --dist ./build

Transform and Watch for Changes

bite-tsx-transform  --src ./src --dist ./build --watch

Clean Output Directory Before Transpiling

bite-tsx-transform --src ./src --dist ./build --clean

Use Custom TypeScript Config

bite-tsx-transform  --src ./lib --dist ./build --tsConfig ./tsconfig.custom.json

Use Custom Babel Config

bite-tsx-transform --src ./lib --dist ./build --babelConfig ./babel.custom.json

Enable Witty Logging

bite-tsx-transform  --src ./lib --dist ./build --witty

Watch Mode

When using --watch, the CLI will monitor the source directory for changes and automatically recompile files when modifications are detected. The file-watching is debounced to prevent excessive rebuilds.

Logging & Error Handling

• Uses Logger for structured logging.
• Displays errors clearly in case of transformation failure.
• Cleans the output directory if transformation fails.
• Supports an optional witty logging mode (--witty) for fun messages.

License

MIT License.

NOTE - The old command tsx-transform has been deprecated and will be removed in next major version