[ { "path": ".changeset/README.md", "content": "# Changesets\n\nHello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works\nwith multi-package repos, or single-package repos to help you version and publish your code. You can\nfind the full documentation for it [in our repository](https://github.com/changesets/changesets)\n\nWe have a quick list of common questions to get you started engaging with this project in\n[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)\n" }, { "path": ".changeset/config.json", "content": "{\n \"$schema\": \"https://unpkg.com/@changesets/config@3.0.0/schema.json\",\n \"changelog\": [\n \"@changesets/changelog-github\",\n { \"repo\": \"jaredpalmer/tsdx\" }\n ],\n \"commit\": false,\n \"fixed\": [],\n \"linked\": [],\n \"access\": \"public\",\n \"baseBranch\": \"main\",\n \"updateInternalDependencies\": \"patch\",\n \"ignore\": []\n}\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: Bug report\nabout: Create a report to help us improve\ntitle: ''\nlabels: bug\nassignees: ''\n\n---\n\n### Describe the Bug\n\nA clear and concise description of what the bug is.\n\n### Steps to Reproduce\n\n1. Run `tsdx create mylib`\n2. ...\n3. See error\n\n### Expected Behavior\n\nWhat you expected to happen.\n\n### Actual Behavior\n\nWhat actually happened.\n\n### Screenshots/Logs\n\nIf applicable, add screenshots or error logs.\n\n```\nPaste error output here\n```\n\n### Environment\n\n```\nTSDX version:\nNode version:\nBun version:\nOS:\nTemplate used:\n```\n\nRun this to get versions:\n```bash\necho \"TSDX: $(bunx tsdx --version 2>/dev/null || echo 'not installed')\"\necho \"Node: $(node --version)\"\necho \"Bun: $(bun --version)\"\necho \"OS: $(uname -a)\"\n```\n\n### Additional Context\n\nAdd any other context about the problem here.\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: false\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.md", "content": "---\nname: Feature request\nabout: Suggest an idea for this project\ntitle: ''\nlabels: enhancement\nassignees: ''\n\n---\n\n### Problem Statement\n\nWhat problem are you trying to solve? What's the current behavior?\n\n### Proposed Solution\n\nDescribe the solution you'd like. Be specific about the API or behavior.\n\n### Alternatives Considered\n\nWhat alternative solutions or features have you considered?\n\n### Who Benefits?\n\nWho is this for? All users? Specific use cases?\n\n### Additional Context\n\nAdd any other context, screenshots, or examples about the feature request here.\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\n\nupdates:\n - package-ecosystem: npm\n directory: '/'\n schedule:\n interval: weekly\n commit-message:\n prefix: 'deps:'\n versioning-strategy: increase-if-necessary\n allow:\n - dependency-name: '*'\n dependency-type: production\n open-pull-requests-limit: 5\n" }, { "path": ".github/stale.yml", "content": "# Number of days of inactivity before an issue becomes stale\ndaysUntilStale: 60\n# Number of days of inactivity before a stale issue is closed\ndaysUntilClose: 3600\n# Issues with these labels will never be considered stale\nexemptLabels:\n - enhancement\n - pinned\n - RFC\n - bug\n - in progress\n - 2.0\n# Label to use when marking an issue as stale\nstaleLabel: stale\n# Comment to post when marking an issue as stale. Set to `false` to disable\nmarkComment: false\n# Comment to post when closing a stale issue. Set to `false` to disable\ncloseComment: false\n" }, { "path": ".github/workflows/nodejs.yml", "content": "name: CI\n\non:\n push:\n branches: [main, master]\n pull_request:\n branches: [main, master]\n\njobs:\n build:\n name: Build, lint, and test on Node ${{ matrix.node }} and ${{ matrix.os }}\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n node: ['20', '22']\n os: [ubuntu-latest, windows-latest, macos-latest]\n\n steps:\n - name: Checkout repo\n uses: actions/checkout@v4\n\n - name: Setup Bun\n uses: oven-sh/setup-bun@v2\n with:\n bun-version: latest\n\n - name: Setup Node.js ${{ matrix.node }}\n uses: actions/setup-node@v4\n with:\n node-version: ${{ matrix.node }}\n\n - name: Install dependencies\n run: bun install\n\n - name: Lint\n run: bun run lint\n\n - name: Type check\n run: bun run typecheck\n\n - name: Build\n run: bun run build\n\n - name: Test\n run: bun run test\n" }, { "path": ".github/workflows/release.yml", "content": "name: Release\n\non:\n push:\n branches:\n - master\n\nconcurrency: ${{ github.workflow }}-${{ github.ref }}\n\njobs:\n release:\n name: Release\n runs-on: ubuntu-latest\n permissions:\n contents: write\n pull-requests: write\n id-token: write\n steps:\n - name: Checkout repo\n uses: actions/checkout@v4\n\n - name: Setup Bun\n uses: oven-sh/setup-bun@v2\n with:\n bun-version: latest\n\n - name: Setup Node.js\n uses: actions/setup-node@v4\n with:\n node-version: 20\n registry-url: 'https://registry.npmjs.org'\n\n - name: Install dependencies\n run: bun install\n\n - name: Build\n run: bun run build\n\n - name: Create Release Pull Request or Publish\n id: changesets\n uses: changesets/action@v1\n with:\n version: bun run changeset version\n publish: bun run release\n title: 'chore: release package'\n commit: 'chore: release package'\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}\n NPM_CONFIG_PROVENANCE: true\n" }, { "path": ".gitignore", "content": "# Dependencies\nnode_modules\n.pnp\n.pnp.js\n\n# Build output\ndist\n*.tsbuildinfo\n\n# Bun\nbun.lockb\n\n# IDE\n.idea\n.vscode\n*.swp\n*.swo\n\n# OS\n.DS_Store\nThumbs.db\n\n# Logs\n*.log\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n\n# Testing\ncoverage\n\n# Misc\n.env\n.env.local\n.netlify\n\n# Test directories\ntester\ntester-react\n" }, { "path": "CHANGELOG.md", "content": "# tsdx\n\n## 2.0.0\n\n### Major Changes\n\n- [#1202](https://github.com/jaredpalmer/tsdx/pull/1202) [`6fcfef1`](https://github.com/jaredpalmer/tsdx/commit/6fcfef1dcb1c1d7f9f2c04969ee208a702876140) Thanks [@jaredpalmer](https://github.com/jaredpalmer)! - Initial 2.0.0 release - complete rewrite with modern Rust-based tooling\n\n - Bundling with bunchee\n - Testing with vitest\n - Linting with oxlint\n - Formatting with oxfmt\n - Project scaffolding with basic and react templates\n" }, { "path": "CLAUDE.md", "content": "# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\nTSDX is a zero-config CLI for TypeScript package development. Version 2.0 is a complete rewrite using modern Rust-based tooling: bunchee (bundling), vitest (testing), oxlint (linting), and oxfmt (formatting).\n\n## Development Commands\n\n```bash\nbun install # Install dependencies\nbun run build # Build CLI with bunchee\nbun run dev # Watch mode (rebuilds on changes)\nbun run test # Run all tests with vitest\nbun run test:watch # Run tests in watch mode\nbun run test test/cli.test.ts # Run a specific test file\nbun run lint # Lint with oxlint\nbun run typecheck # TypeScript type checking\nbun run format # Format with oxfmt\nbun run format:check # Check formatting\n```\n\n## Testing Notes\n\nTests require a build first since they test the compiled CLI:\n```bash\nbun run build && bun run test\n```\n\nThe e2e tests create projects in temp directories and have longer timeouts (60s).\n\n## Architecture\n\n**Single CLI Entry Point**: `src/index.ts` contains all CLI commands using Commander.js:\n- `create` - scaffolds projects from templates, installs deps with bun\n- `build/dev` - wraps bunchee\n- `test` - wraps vitest\n- `lint` - wraps oxlint\n- `format` - wraps oxfmt\n- `typecheck` - wraps tsc\n- `init` - adds tsdx config to existing project\n\n**Templates**: `templates/basic/` and `templates/react/` are copied directly during `create`. Template `gitignore` files are renamed to `.gitignore` post-copy. `` and `` placeholders in LICENSE are replaced.\n\n## Adding a New Template\n\n1. Create directory in `templates/`\n2. Register in `src/index.ts` in the `templates` object\n3. Include: package.json, tsconfig.json, vitest.config.ts, src/, test/, gitignore (not .gitignore), LICENSE with `` and `` placeholders\n\n## Documentation Website\n\nThe documentation site is in `./website/` and built with:\n- **Next.js 16** - React framework\n- **Fumadocs** - Documentation framework (fumadocs-core, fumadocs-mdx, fumadocs-ui)\n- **Tailwind CSS v4** - CSS-first configuration\n- **IBM Plex Sans/Mono** - Typography via next/font/google\n\n### Website Commands\n\n```bash\ncd website\nbun install # Install dependencies\nbun run dev # Start dev server\nbun run build # Build for production\n```\n\n### Content Structure\n\n- `content/docs/` - MDX documentation files\n- `content/docs/meta.json` - Sidebar navigation structure\n- `app/` - Next.js App Router pages\n- `app/layout.config.tsx` - Navigation and logo configuration\n\n### Adding Documentation Pages\n\n1. Create `.mdx` file in `content/docs/`\n2. Add frontmatter with `title` and `description`\n3. Add page to `content/docs/meta.json` in desired position\n4. Use `---Section Name---` syntax in meta.json for sidebar sections\n\n## Commit Convention\n\nUses Conventional Commits: `feat:`, `fix:`, `docs:`, `test:`, `refactor:`, `chore:`\n\n## Release Process\n\nUses [changesets](https://github.com/changesets/changesets) for version management and npm publishing.\n\n### Creating a Changeset\n\nWhen making changes that should be released:\n```bash\nbun run changeset\n```\nFollow the prompts to select version bump type (patch/minor/major) and describe the change.\n\n### Release Workflow\n\n1. Create a changeset with your PR\n2. Merge PR to main\n3. GitHub Action creates a \"Release\" PR with version bumps\n4. Merge the Release PR to publish to npm\n\n### Manual Release\n\n```bash\nbun run changeset version # Apply version bumps from changesets\nbun run release # Build and publish to npm\n```\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as\ncontributors and maintainers pledge to making participation in our project and\nour community a harassment-free experience for everyone, regardless of age, body\nsize, disability, ethnicity, sex characteristics, gender identity and expression,\nlevel of experience, education, socio-economic status, nationality, personal\nappearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment\ninclude:\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or\n advances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic\n address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable\nbehavior and are expected to take appropriate and fair corrective action in\nresponse to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or\nreject comments, commits, code, wiki edits, issues, and other contributions\nthat are not aligned to this Code of Conduct, or to ban temporarily or\npermanently any contributor for other behaviors that they deem inappropriate,\nthreatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces\nwhen an individual is representing the project or its community. Examples of\nrepresenting a project or community include using an official project e-mail\naddress, posting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event. Representation of a project may be\nfurther defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported by contacting the project team at hello@formium.io. All\ncomplaints will be reviewed and investigated and will result in a response that\nis deemed necessary and appropriate to the circumstances. The project team is\nobligated to maintain confidentiality with regard to the reporter of an incident.\nFurther details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good\nfaith may face temporary or permanent repercussions as determined by other\nmembers of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,\navailable at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html\n\n[homepage]: https://www.contributor-covenant.org\n\nFor answers to common questions about this code of conduct, see\nhttps://www.contributor-covenant.org/faq\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing to TSDX\n\nThanks for your interest in TSDX! Contributions are welcome.\n\nIf you're proposing a new feature, please [open an issue](https://github.com/jaredpalmer/tsdx/issues/new/choose) first to discuss it.\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) 20+ (LTS)\n- [Bun](https://bun.sh/) (latest version)\n\n### Installing Bun\n\n```bash\n# macOS/Linux\ncurl -fsSL https://bun.sh/install | bash\n\n# Windows\npowershell -c \"irm bun.sh/install.ps1 | iex\"\n```\n\n## Setup\n\n1. Fork this repository to your own GitHub account and clone it:\n\n ```bash\n git clone https://github.com/your-username/tsdx.git\n cd tsdx\n ```\n\n2. Install dependencies:\n\n ```bash\n bun install\n ```\n\n3. Build the CLI:\n\n ```bash\n bun run build\n ```\n\n4. Link for local development:\n\n ```bash\n bun link\n ```\n\n Now you can use `tsdx` commands globally and they'll run your local version.\n\n## Development Workflow\n\n### Building\n\n```bash\n# Build once\nbun run build\n\n# Watch mode (rebuilds on changes)\nbun run dev\n```\n\n### Testing\n\n```bash\n# Run all tests\nbun run test\n\n# Watch mode\nbun run test:watch\n\n# Run specific test file\nbun run test test/cli.test.ts\n```\n\n### Linting\n\n```bash\n# Lint the codebase\nbun run lint\n\n# Auto-fix issues\nbun run lint --fix\n```\n\n### Type Checking\n\n```bash\nbun run typecheck\n```\n\n### Formatting\n\n```bash\n# Format all files\nbun run format\n\n# Check formatting\nbun run format:check\n```\n\n## Testing Your Changes\n\n### Testing the CLI\n\nAfter building, test your changes by creating a new project:\n\n```bash\n# Create a test project\ncd /tmp\ntsdx create test-project --template basic\ncd test-project\n\n# Verify it works\nbun run build\nbun run test\n```\n\n### Testing Templates\n\nTemplates are in the `templates/` directory. After modifying a template:\n\n1. Build tsdx: `bun run build`\n2. Create a new project: `tsdx create test-project --template `\n3. Verify the generated project works correctly\n\n## Project Structure\n\n```\ntsdx/\n├── src/\n│ └── index.ts # CLI entry point\n├── templates/\n│ ├── basic/ # Basic TypeScript template\n│ └── react/ # React component template\n├── test/\n│ ├── cli.test.ts # CLI unit tests\n│ └── e2e.test.ts # End-to-end tests\n├── package.json\n├── tsconfig.json\n└── vitest.config.ts\n```\n\n## Submitting a PR\n\n1. Create a feature branch:\n ```bash\n git checkout -b feature/my-feature\n ```\n\n2. Make your changes\n\n3. Run all checks:\n ```bash\n bun run lint\n bun run typecheck\n bun run test\n bun run build\n ```\n\n4. Commit your changes with a descriptive message:\n ```bash\n git commit -m \"feat: add new feature\"\n ```\n\n5. Push and create a pull request:\n ```bash\n git push origin feature/my-feature\n ```\n\n### Commit Message Guidelines\n\nWe follow [Conventional Commits](https://www.conventionalcommits.org/):\n\n- `feat:` - New features\n- `fix:` - Bug fixes\n- `docs:` - Documentation changes\n- `test:` - Test changes\n- `refactor:` - Code refactoring\n- `chore:` - Maintenance tasks\n\n## Adding a New Template\n\n1. Create a new directory in `templates/`:\n ```bash\n mkdir templates/my-template\n ```\n\n2. Add the template files (use `basic` as reference)\n\n3. Register the template in `src/index.ts`:\n ```typescript\n const templates = {\n basic: { ... },\n react: { ... },\n 'my-template': {\n name: 'my-template',\n description: 'Description of my template',\n },\n };\n ```\n\n4. Add tests for the new template\n\n5. Update the README to document the new template\n\n## Questions?\n\nFeel free to [open an issue](https://github.com/jaredpalmer/tsdx/issues) if you have questions or need help.\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2019 Jared Palmer https://jaredpalmer.com\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE." }, { "path": "MIGRATION.md", "content": "# Migration Guide: TSDX v0.x to v2.0\n\nThis guide helps you migrate from the original TSDX (v0.x) to the modern TSDX 2.0.\n\n## What's Changed\n\nTSDX 2.0 is a complete rewrite that replaces the original toolchain with modern, high-performance alternatives:\n\n| Old (v0.x) | New (v2.0) | Why |\n|------------|------------|-----|\n| Rollup + Babel | [bunchee](https://github.com/huozhi/bunchee) | Zero-config, SWC-powered, faster |\n| Jest | [vitest](https://vitest.dev/) | Vite-native, faster, Jest-compatible |\n| ESLint | [oxlint](https://oxc.rs/) | 50-100x faster, Rust-powered |\n| Prettier | [oxfmt](https://oxc.rs/) | 35x faster, Rust-powered |\n| yarn/npm | [bun](https://bun.sh/) | Faster installs and execution |\n| Node 10+ | Node 20+ | LTS only |\n\n## Quick Migration\n\nFor most projects, follow these steps:\n\n### 1. Install Bun\n\n```bash\n# macOS/Linux\ncurl -fsSL https://bun.sh/install | bash\n\n# Windows\npowershell -c \"irm bun.sh/install.ps1 | iex\"\n```\n\n### 2. Update package.json\n\nReplace your scripts:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"tsdx dev\",\n \"build\": \"tsdx build\",\n \"test\": \"tsdx test\",\n \"lint\": \"tsdx lint\",\n \"format\": \"tsdx format\",\n \"typecheck\": \"tsdx typecheck\",\n \"prepublishOnly\": \"bun run build\"\n }\n}\n```\n\n### 3. Update Dependencies\n\nRemove old dependencies and add new ones:\n\n```bash\n# Remove old dependencies\nbun remove tsdx rollup @rollup/plugin-* babel-* @babel/* jest ts-jest eslint @typescript-eslint/* prettier husky lint-staged\n\n# Add new tsdx\nbun add -D tsdx typescript\n```\n\n### 4. Replace Jest with Vitest\n\nCreate `vitest.config.ts`:\n\n```typescript\nimport { defineConfig } from 'vitest/config';\n\nexport default defineConfig({\n test: {\n globals: true,\n environment: 'node', // or 'jsdom' for React/DOM testing\n },\n});\n```\n\nUpdate test files:\n- Change `import { describe, it, expect } from 'jest'` to `import { describe, it, expect } from 'vitest'`\n- Or use `globals: true` in vitest.config.ts to avoid imports\n\n**Jest to Vitest Cheatsheet:**\n\n| Jest | Vitest |\n|------|--------|\n| `jest.fn()` | `vi.fn()` |\n| `jest.mock()` | `vi.mock()` |\n| `jest.spyOn()` | `vi.spyOn()` |\n| `jest.useFakeTimers()` | `vi.useFakeTimers()` |\n| `beforeAll/afterAll` | Same |\n| `beforeEach/afterEach` | Same |\n| `describe/it/test` | Same |\n| `expect()` | Same |\n\n### 5. Remove Old Config Files\n\nDelete these files (they're no longer needed):\n\n```bash\nrm -f tsdx.config.js\nrm -f jest.config.js\nrm -f .babelrc babel.config.js babel.config.json\nrm -f .eslintrc .eslintrc.js .eslintrc.json .eslintignore\nrm -f .prettierrc .prettierrc.js .prettierrc.json .prettierignore\nrm -f rollup.config.js\nrm -f yarn.lock package-lock.json\n```\n\n### 6. Update tsconfig.json\n\nUpdate to modern settings:\n\n```json\n{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"lib\": [\"ES2022\", \"DOM\"],\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n \"declaration\": true,\n \"declarationMap\": true,\n \"outDir\": \"./dist\",\n \"rootDir\": \"./src\",\n \"resolveJsonModule\": true,\n \"isolatedModules\": true,\n \"noEmit\": true\n },\n \"include\": [\"src\"],\n \"exclude\": [\"node_modules\", \"dist\"]\n}\n```\n\n### 7. Update package.json Exports\n\nEnsure your package.json has modern exports:\n\n```json\n{\n \"type\": \"module\",\n \"main\": \"./dist/index.cjs\",\n \"module\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": {\n \"types\": \"./dist/index.d.ts\",\n \"default\": \"./dist/index.js\"\n },\n \"require\": {\n \"types\": \"./dist/index.d.cts\",\n \"default\": \"./dist/index.cjs\"\n }\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\"dist\", \"src\"],\n \"engines\": {\n \"node\": \">=20\"\n }\n}\n```\n\n### 8. Install and Test\n\n```bash\n# Install dependencies\nbun install\n\n# Run tests\nbun run test\n\n# Build\nbun run build\n\n# Lint\nbun run lint\n```\n\n## Detailed Migration\n\n### Build Configuration\n\n**Old TSDX (tsdx.config.js):**\n```javascript\nmodule.exports = {\n rollup(config, options) {\n // Custom rollup config\n return config;\n },\n};\n```\n\n**New TSDX:** No configuration needed! bunchee reads your `package.json` exports field.\n\nFor advanced customization, create `bunchee.config.ts`:\n```typescript\nimport { BuncheeConfig } from 'bunchee';\n\nexport default {\n // See bunchee documentation\n} satisfies BuncheeConfig;\n```\n\n### Testing\n\n**Old Jest test:**\n```typescript\nimport { sum } from './index';\n\ndescribe('sum', () => {\n it('adds numbers', () => {\n expect(sum(1, 2)).toBe(3);\n });\n});\n```\n\n**New Vitest test (same syntax!):**\n```typescript\nimport { describe, it, expect } from 'vitest';\nimport { sum } from './index';\n\ndescribe('sum', () => {\n it('adds numbers', () => {\n expect(sum(1, 2)).toBe(3);\n });\n});\n```\n\nOr with `globals: true` in vitest.config.ts:\n```typescript\nimport { sum } from './index';\n\ndescribe('sum', () => {\n it('adds numbers', () => {\n expect(sum(1, 2)).toBe(3);\n });\n});\n```\n\n### React Testing\n\n**Old (enzyme/react-testing-library with Jest):**\n```typescript\nimport { render, screen } from '@testing-library/react';\nimport { MyComponent } from './MyComponent';\n\ntest('renders', () => {\n render();\n expect(screen.getByText('Hello')).toBeInTheDocument();\n});\n```\n\n**New (same, just with Vitest!):**\n```typescript\nimport { describe, it, expect } from 'vitest';\nimport { render, screen } from '@testing-library/react';\nimport { MyComponent } from './MyComponent';\n\ndescribe('MyComponent', () => {\n it('renders', () => {\n render();\n expect(screen.getByText('Hello')).toBeDefined();\n });\n});\n```\n\nNote: Replace `toBeInTheDocument()` with `toBeDefined()` or add `@testing-library/jest-dom` and configure in vitest setup.\n\n### Linting\n\n**Old ESLint (.eslintrc.js):**\n```javascript\nmodule.exports = {\n extends: ['react-app', 'prettier'],\n rules: {\n 'no-unused-vars': 'warn',\n },\n};\n```\n\n**New oxlint (.oxlintrc.json) - optional:**\n```json\n{\n \"rules\": {\n \"no-unused-vars\": \"warn\"\n }\n}\n```\n\nMost ESLint rules have equivalents in oxlint. Check [oxlint rules documentation](https://oxc.rs/docs/guide/usage/linter/rules.html).\n\n### Formatting\n\n**Old Prettier (.prettierrc):**\n```json\n{\n \"semi\": true,\n \"singleQuote\": true,\n \"tabWidth\": 2\n}\n```\n\n**New oxfmt (.oxfmtrc.json) - optional:**\n```json\n{\n \"indentWidth\": 2,\n \"lineWidth\": 100\n}\n```\n\n### GitHub Actions\n\n**Old workflow:**\n```yaml\njobs:\n build:\n runs-on: ubuntu-latest\n strategy:\n matrix:\n node: [12, 14, 16]\n steps:\n - uses: actions/checkout@v3\n - uses: actions/setup-node@v3\n with:\n node-version: ${{ matrix.node }}\n - run: yarn install\n - run: yarn build\n - run: yarn test\n```\n\n**New workflow:**\n```yaml\njobs:\n build:\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n node: ['20', '22']\n os: [ubuntu-latest, windows-latest, macos-latest]\n steps:\n - uses: actions/checkout@v4\n - uses: oven-sh/setup-bun@v2\n with:\n bun-version: latest\n - uses: actions/setup-node@v4\n with:\n node-version: ${{ matrix.node }}\n - run: bun install\n - run: bun run lint\n - run: bun run typecheck\n - run: bun run build\n - run: bun run test\n```\n\n## Breaking Changes\n\n### Removed Features\n\n1. **Storybook template** - Use [Storybook CLI](https://storybook.js.org/docs/get-started/install) directly\n2. **Custom Rollup config** - Use bunchee config or raw rollup if needed\n3. **tsdx lint** - Now wraps oxlint instead of ESLint\n4. **Node.js < 20** - Only Node.js 20+ (LTS) is supported\n\n### Changed Behavior\n\n1. **Build output** - Slightly different but compatible\n2. **Watch mode** - Now uses bunchee's watch, may have different behavior\n3. **Test runner** - Vitest instead of Jest (mostly compatible API)\n4. **Default branch** - Uses `main` instead of `master` in templates\n\n## Compatibility\n\n### Your Library Consumers\n\n**No changes needed!** The build output format is compatible:\n- ESM and CommonJS dual publish\n- TypeScript declarations\n- Same export patterns\n\n### Your Development Workflow\n\n| Task | Old Command | New Command |\n|------|-------------|-------------|\n| Create project | `npx tsdx create mylib` | `bunx tsdx create mylib` |\n| Development | `yarn start` | `bun run dev` |\n| Build | `yarn build` | `bun run build` |\n| Test | `yarn test` | `bun run test` |\n| Lint | `yarn lint` | `bun run lint` |\n| Format | `yarn prettier --write .` | `bun run format` |\n\n## Troubleshooting\n\n### \"bun: command not found\"\n\nInstall bun:\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n### Tests fail with \"vi is not defined\"\n\nAdd vitest imports:\n```typescript\nimport { describe, it, expect, vi } from 'vitest';\n```\n\nOr enable globals in `vitest.config.ts`:\n```typescript\nexport default defineConfig({\n test: {\n globals: true,\n },\n});\n```\n\n### TypeScript errors with moduleResolution\n\nUpdate tsconfig.json:\n```json\n{\n \"compilerOptions\": {\n \"moduleResolution\": \"bundler\"\n }\n}\n```\n\n### ESM/CJS interop issues\n\nEnsure your package.json has:\n```json\n{\n \"type\": \"module\"\n}\n```\n\n### \"Cannot find module\" in tests\n\nCheck your vitest.config.ts has correct paths:\n```typescript\nexport default defineConfig({\n test: {\n include: ['test/**/*.test.ts'],\n },\n});\n```\n\n## Getting Help\n\n- [TSDX GitHub Issues](https://github.com/jaredpalmer/tsdx/issues)\n- [Vitest Documentation](https://vitest.dev/)\n- [bunchee Documentation](https://github.com/huozhi/bunchee)\n- [oxlint Documentation](https://oxc.rs/docs/guide/usage/linter.html)\n- [Bun Documentation](https://bun.sh/docs)\n" }, { "path": "README.md", "content": "# TSDX\n\nZero-config CLI for TypeScript package development.\n\n[![CI](https://github.com/jaredpalmer/tsdx/actions/workflows/nodejs.yml/badge.svg)](https://github.com/jaredpalmer/tsdx/actions/workflows/nodejs.yml)\n[![npm](https://img.shields.io/npm/v/tsdx.svg)](https://www.npmjs.com/package/tsdx)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nModern TypeScript library development, simplified. TSDX provides a zero-config CLI that helps you develop, test, and publish TypeScript packages with ease.\n\n> **TSDX 2.0** is a complete rewrite using modern, high-performance Rust-based tooling. See the [Migration Guide](./MIGRATION.md) if upgrading from v0.x\n\n## Features\n\n- **Zero config** - Sensible defaults, just start coding\n- **Modern tooling** - Built on [bunchee](https://github.com/huozhi/bunchee), [vitest](https://vitest.dev/), [oxlint](https://oxc.rs/docs/guide/usage/linter.html), and [oxfmt](https://oxc.rs/docs/guide/usage/formatter)\n- **Dual ESM/CJS** - Automatic dual module builds with proper exports\n- **TypeScript first** - Full TypeScript support with declaration generation\n- **Lightning fast** - Rust-powered linting (50-100x faster than ESLint) and formatting (35x faster than Prettier)\n- **Bun-native** - Uses bun for package management\n- **Modern Node.js** - Supports Node.js 20+ (LTS)\n\n## Quick Start\n\n```bash\n# Create a new package\nbunx tsdx create mylib\n\n# Navigate to the project\ncd mylib\n\n# Start development\nbun run dev\n```\n\nThat's it! Start editing `src/index.ts` and build your library.\n\n## Installation\n\n### Global Installation (recommended for creating projects)\n\n```bash\nbun add -g tsdx\n```\n\n### Per-Project Installation\n\n```bash\nbun add -D tsdx\n```\n\n## Commands\n\n### `tsdx create `\n\nCreate a new TypeScript package from a template.\n\n```bash\n# Interactive template selection\nbunx tsdx create mylib\n\n# Specify template directly\nbunx tsdx create mylib --template react\n```\n\n**Available Templates:**\n\n| Template | Description |\n|----------|-------------|\n| `basic` | A basic TypeScript library with vitest |\n| `react` | A React component library with Testing Library |\n\n### `tsdx build`\n\nBuild the package for production using [bunchee](https://github.com/huozhi/bunchee).\n\n```bash\ntsdx build\n\n# Skip cleaning dist folder\ntsdx build --no-clean\n```\n\nOutputs ESM and CommonJS formats with TypeScript declarations.\n\n### `tsdx dev` / `tsdx watch`\n\nStart development mode with file watching.\n\n```bash\ntsdx dev\n```\n\nRebuilds automatically when files change.\n\n### `tsdx test`\n\nRun tests using [vitest](https://vitest.dev/).\n\n```bash\n# Run tests once\ntsdx test\n\n# Watch mode\ntsdx test --watch\n\n# With coverage\ntsdx test --coverage\n\n# Update snapshots\ntsdx test --update\n```\n\n### `tsdx lint`\n\nLint the codebase using [oxlint](https://oxc.rs/docs/guide/usage/linter.html).\n\n```bash\n# Lint src and test directories (default)\ntsdx lint\n\n# Lint specific paths\ntsdx lint src lib\n\n# Auto-fix issues\ntsdx lint --fix\n\n# Use custom config\ntsdx lint --config .oxlintrc.json\n```\n\n### `tsdx format`\n\nFormat the codebase using [oxfmt](https://oxc.rs/docs/guide/usage/formatter).\n\n```bash\n# Format all files\ntsdx format\n\n# Check formatting without changes\ntsdx format --check\n\n# Format specific paths\ntsdx format src test\n```\n\n### `tsdx typecheck`\n\nRun TypeScript type checking.\n\n```bash\ntsdx typecheck\n\n# Watch mode\ntsdx typecheck --watch\n```\n\n### `tsdx init`\n\nInitialize tsdx configuration in an existing project.\n\n```bash\nbunx tsdx init\n```\n\nThis adds the necessary configuration to your `package.json`, creates `tsconfig.json` and `vitest.config.ts` if they don't exist.\n\n## Project Structure\n\nProjects created with tsdx follow this structure:\n\n```\nmylib/\n├── src/\n│ └── index.ts # Library entry point\n├── test/\n│ └── index.test.ts # Tests (vitest)\n├── dist/ # Build output (generated)\n│ ├── index.js # ESM\n│ ├── index.cjs # CommonJS\n│ └── index.d.ts # TypeScript declarations\n├── .github/\n│ └── workflows/ # CI/CD workflows\n├── package.json\n├── tsconfig.json\n├── vitest.config.ts\n├── LICENSE\n└── README.md\n```\n\n### React Template Additional Structure\n\n```\nmylib/\n├── src/\n│ └── index.tsx # React component entry\n├── test/\n│ └── index.test.tsx # Tests with Testing Library\n├── example/ # Demo app (Vite-powered)\n│ ├── index.tsx\n│ ├── index.html\n│ ├── package.json\n│ └── vite.config.ts\n└── ...\n```\n\n## Module Formats\n\nTSDX outputs both ESM and CommonJS formats:\n\n| File | Format | Usage |\n|------|--------|-------|\n| `dist/index.js` | ESM | Modern bundlers, Node.js with `type: \"module\"` |\n| `dist/index.cjs` | CommonJS | Legacy Node.js, older bundlers |\n| `dist/index.d.ts` | TypeScript | Type definitions |\n| `dist/index.d.cts` | TypeScript | CJS type definitions |\n\nThe `package.json` exports field is configured automatically:\n\n```json\n{\n \"type\": \"module\",\n \"main\": \"./dist/index.cjs\",\n \"module\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": {\n \"types\": \"./dist/index.d.ts\",\n \"default\": \"./dist/index.js\"\n },\n \"require\": {\n \"types\": \"./dist/index.d.cts\",\n \"default\": \"./dist/index.cjs\"\n }\n },\n \"./package.json\": \"./package.json\"\n }\n}\n```\n\n## Tool Stack\n\nTSDX 2.0 uses modern, high-performance tools:\n\n| Tool | Purpose | Performance |\n|------|---------|-------------|\n| [bunchee](https://github.com/huozhi/bunchee) | Bundling | Zero-config, built on Rollup + SWC |\n| [vitest](https://vitest.dev/) | Testing | Vite-native, Jest-compatible API |\n| [oxlint](https://oxc.rs/docs/guide/usage/linter.html) | Linting | 50-100x faster than ESLint |\n| [oxfmt](https://oxc.rs/docs/guide/usage/formatter) | Formatting | 35x faster than Prettier |\n| [bun](https://bun.sh/) | Package Management | Native speed, npm-compatible |\n\n## Configuration\n\n### TypeScript (`tsconfig.json`)\n\nTSDX creates a modern TypeScript configuration:\n\n```json\n{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"strict\": true,\n \"declaration\": true,\n \"declarationMap\": true\n }\n}\n```\n\n### Vitest (`vitest.config.ts`)\n\nDefault test configuration:\n\n```typescript\nimport { defineConfig } from 'vitest/config';\n\nexport default defineConfig({\n test: {\n globals: true,\n environment: 'node', // or 'jsdom' for React\n },\n});\n```\n\n### Linting (`.oxlintrc.json`)\n\nOptional oxlint configuration:\n\n```json\n{\n \"rules\": {\n \"no-unused-vars\": \"warn\"\n }\n}\n```\n\n### Formatting (`.oxfmtrc.json`)\n\nOptional oxfmt configuration:\n\n```json\n{\n \"indentWidth\": 2,\n \"lineWidth\": 100\n}\n```\n\n## Requirements\n\n- **Node.js**: 20+ (LTS)\n- **Bun**: Latest version\n\n### Installing Bun\n\n```bash\n# macOS/Linux\ncurl -fsSL https://bun.sh/install | bash\n\n# Windows\npowershell -c \"irm bun.sh/install.ps1 | iex\"\n\n# npm (alternative)\nnpm install -g bun\n```\n\n## Migrating from TSDX v0.x\n\nSee the [Migration Guide](./MIGRATION.md) for detailed instructions on upgrading from the original TSDX.\n\n**Quick summary:**\n1. Install bun\n2. Update `package.json` scripts to use tsdx commands\n3. Replace Jest with vitest\n4. Replace ESLint with oxlint (optional)\n5. Replace Prettier with oxfmt (optional)\n6. Run `bun install`\n\n## Publishing\n\n```bash\n# Build the package\nbun run build\n\n# Publish to npm\nnpm publish\n```\n\nWe recommend using [np](https://github.com/sindresorhus/np) or [changesets](https://github.com/changesets/changesets) for publishing.\n\n## FAQ\n\n### Why bun?\n\nBun provides significantly faster package installation and script execution. It's compatible with npm packages and the Node.js ecosystem.\n\n### Can I still use npm/yarn/pnpm?\n\nThe generated projects use bun for package management, but the built packages are compatible with any package manager. Your library consumers can use npm, yarn, pnpm, or bun.\n\n### Why oxlint instead of ESLint?\n\noxlint is 50-100x faster than ESLint while catching the most important issues. For comprehensive linting, you can still use ESLint alongside oxlint.\n\n### Is this compatible with the old TSDX?\n\nThe build output format is fully compatible. Your library consumers won't notice any difference. However, the development workflow and configuration are different.\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n## Acknowledgments\n\nTSDX 2.0 is built on the shoulders of giants:\n\n- [bunchee](https://github.com/huozhi/bunchee) by Jiachi Liu\n- [vitest](https://vitest.dev/) by the Vitest team\n- [oxc](https://oxc.rs/) by the OXC team\n- [bun](https://bun.sh/) by the Bun team\n\n## Author\n\n- [Jared Palmer](https://twitter.com/jaredpalmer)\n\n## License\n\n[MIT](./LICENSE)\n" }, { "path": "package.json", "content": "{\n \"name\": \"tsdx\",\n \"version\": \"2.0.0\",\n \"author\": \"Jared Palmer \",\n \"description\": \"Zero-config TypeScript package development\",\n \"license\": \"MIT\",\n \"homepage\": \"https://github.com/jaredpalmer/tsdx\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/jaredpalmer/tsdx.git\"\n },\n \"keywords\": [\n \"typescript\",\n \"bundle\",\n \"bunchee\",\n \"vitest\",\n \"oxlint\"\n ],\n \"bugs\": {\n \"url\": \"https://github.com/jaredpalmer/tsdx/issues\"\n },\n \"type\": \"module\",\n \"bin\": {\n \"tsdx\": \"./dist/index.js\"\n },\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\"\n }\n },\n \"scripts\": {\n \"build\": \"bunchee\",\n \"dev\": \"bunchee --watch\",\n \"lint\": \"oxlint\",\n \"format\": \"oxfmt --write .\",\n \"format:check\": \"oxfmt --check .\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"typecheck\": \"tsc --noEmit\",\n \"prepare\": \"bun run build\",\n \"changeset\": \"changeset\",\n \"release\": \"bun run build && changeset publish\"\n },\n \"files\": [\n \"dist\",\n \"templates\"\n ],\n \"engines\": {\n \"node\": \">=20\"\n },\n \"dependencies\": {\n \"commander\": \"^13.0.0\",\n \"enquirer\": \"^2.4.1\",\n \"execa\": \"^9.5.2\",\n \"fs-extra\": \"^11.2.0\",\n \"ora\": \"^8.1.1\",\n \"picocolors\": \"^1.1.1\"\n },\n \"devDependencies\": {\n \"@changesets/changelog-github\": \"^0.5.2\",\n \"@changesets/cli\": \"^2.29.8\",\n \"@types/fs-extra\": \"^11.0.4\",\n \"@types/node\": \"^22.10.2\",\n \"bunchee\": \"^6.4.0\",\n \"oxlint\": \"^0.16.0\",\n \"typescript\": \"^5.7.2\",\n \"vitest\": \"^2.1.8\"\n }\n}\n" }, { "path": "src/index.ts", "content": "#!/usr/bin/env node\n\nimport { program } from 'commander';\nimport pc from 'picocolors';\nimport fs from 'fs-extra';\nimport path from 'path';\nimport { execa, execaCommand } from 'execa';\nimport ora from 'ora';\nimport Enquirer from 'enquirer';\n\nconst { Select, Input } = Enquirer as unknown as {\n Select: new (options: { message: string; choices: { name: string; message: string }[] }) => { run: () => Promise };\n Input: new (options: { message: string; initial?: string }) => { run: () => Promise };\n};\n\n// Read package.json for version\nconst pkgPath = path.resolve(__dirname, '../package.json');\nconst pkg = fs.readJSONSync(pkgPath);\n\n// Path constants\nconst paths = {\n appRoot: process.cwd(),\n appPackageJson: path.resolve(process.cwd(), 'package.json'),\n appDist: path.resolve(process.cwd(), 'dist'),\n appSrc: path.resolve(process.cwd(), 'src'),\n};\n\n// Template definitions\nconst templates = {\n basic: {\n name: 'basic',\n description: 'A basic TypeScript library',\n },\n react: {\n name: 'react',\n description: 'A React component library',\n },\n} as const;\n\ntype TemplateName = keyof typeof templates;\n\n// ASCII banner\nconst banner = `\n${pc.cyan('████████╗███████╗██████╗ ██╗ ██╗')}\n${pc.cyan('╚══██╔══╝██╔════╝██╔══██╗╚██╗██╔╝')}\n${pc.cyan(' ██║ ███████╗██║ ██║ ╚███╔╝ ')}\n${pc.cyan(' ██║ ╚════██║██║ ██║ ██╔██╗ ')}\n${pc.cyan(' ██║ ███████║██████╔╝██╔╝ ██╗')}\n${pc.cyan(' ╚═╝ ╚══════╝╚═════╝ ╚═╝ ╚═╝')}\n${pc.dim('Zero-config TypeScript package development')}\n${pc.dim('Powered by bunchee, oxlint, vitest')}\n`;\n\nprogram\n .name('tsdx')\n .description('Zero-config TypeScript package development')\n .version(pkg.version);\n\n// CREATE command\nprogram\n .command('create ')\n .description('Create a new TypeScript package')\n .option('-t, --template