jaredpalmer/tsdx
Tsdx
tsdx is a zero-config command line interface and build tool designed for developing, bundling, and distributing TypeScript libraries. It functions as a project scaffolder and development toolchain that initializes new libraries from templates with standardized folder structures and pre-configured dependencies.
The project specializes in producing dual-format module distributions, simultaneously generating both CommonJS and ES modules to ensure compatibility across different JavaScript environments. It utilizes a Rollup-based bundling system to compile TypeScript source into optimized distribution formats and automatically generate accompanying type declarations.
Beyond bundling, the toolchain manages the broader development lifecycle by automating static type verification, linting, and source code formatting. It includes a development server with file watching and automatic rebuilds, as well as integrated support for unit test execution and continuous integration workflows.
Features
- TypeScript Bundling - Provides a zero-config toolchain for bundling and distributing TypeScript libraries with automated type generation.
- Dual Module Formats - Simultaneously produces both CommonJS and ES module distributions to ensure compatibility across all JavaScript environments.
- Zero-Config Library Packaging - Provides a zero-config CLI that abstracts complex bundler and compiler settings with sensible defaults for library authors.
- TypeScript Declaration Emitters - Produces TypeScript type definition files from source code to ensure consistent data structures for package consumers.
- Project Bootstrapping Templates - Initializes new TypeScript library projects from templates with standardized folder structures and pre-configured dependencies.
- Project Scaffolding - Generates new library projects from templates with a standardized folder structure and pre-configured dependencies.
- TypeScript Declaration Generators - Automatically generates TypeScript declaration files to ensure consumers of the library have full type safety.
- Production Asset Compilation - Compiles source code into optimized, production-ready distribution files through a zero-config build process.
- TypeScript Bundle Compilation - Uses Rollup to compile TypeScript source into optimized distribution formats and type declarations.
- JavaScript and TypeScript Toolchains - Manages linting, formatting, and type checking through a unified command line interface.
- Bundler Entry Points - Maps source files to specific exported paths to generate several distinct output bundles for complex library structures.
- Hot-Reloading Servers - Provides a development server with hot reloading to give immediate feedback during library development.
- Path Mapping Configurations - Maps source files to exported paths via configuration to create distinct output bundles for complex library structures.
- Source Code Formatters - Standardizes code style automatically using a high-speed formatter to maintain consistency across the codebase.
- Static Code Linting - Analyzes code for errors and enforces consistent styling using integrated high-performance linting tools.
- Development Rebuild Triggers - Monitors the filesystem for changes to trigger incremental recompilation and provide immediate developer feedback.
- Source File Watching - Monitors source files for changes and triggers automatic rebuilds to provide a continuous feedback loop.
- Static Type Checkers - Executes a type checker to verify static type safety and catch errors across the entire project codebase.
- Test Suite Execution - Runs unit test suites to validate library functionality with high performance.
