@smallcase/bite NPM

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

chalk citty yocto-spinner

3.0.2

3 months ago

3.0.1

3 months ago