Skip to content

docs: add comprehensive tsdown vs pkgroll bundler comparison#4

Merged
gander merged 2 commits into
mainfrom
claude/add-bundler-comparison-0jVzJ
Dec 18, 2025
Merged

docs: add comprehensive tsdown vs pkgroll bundler comparison#4
gander merged 2 commits into
mainfrom
claude/add-bundler-comparison-0jVzJ

Conversation

@gander

@gander gander commented Dec 18, 2025

Copy link
Copy Markdown
Member

Add detailed Polish-language comparison covering:

  • Automatic shebang handling differences
  • Performance and technology comparison
  • CLI subcommand configuration examples
  • Library compatibility matrix
  • Bundle size and tree-shaking analysis
  • Standalone binaries preparation (deno, bun, pkg)
  • Developer experience and debugging
  • Critical edge cases for CLI tools
  • Known issues and gotchas
  • Use case recommendations

The comparison provides actionable guidance for choosing between tsdown and pkgroll for TypeScript CLI development, with focus on shebang handling, zero-config vs explicit config, and distribution targets.

Pull Request

Description

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Configuration change
  • Refactoring (no functional changes)
  • Performance improvement
  • Test update

Testing Checklist

  • All existing tests pass (npm test)
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Type checking passes (npm run typecheck)
  • Build succeeds (npm run build)
  • Linting and formatting pass (npm run check)

Documentation Checklist

  • I have updated the documentation accordingly
  • I have added/updated JSDoc comments for new/modified code
  • README has been updated (if needed)
  • CHANGELOG has been updated (if needed, or will be handled by release-please)

Conventional Commits

  • This PR follows Conventional Commits specification
  • Commit messages use proper prefixes: feat:, fix:, docs:, refactor:, perf:, test:, build:, ci:, chore:

Breaking Changes

Does this PR introduce breaking changes?

  • Yes
  • No

Additional Notes


Closes #

Add detailed Polish-language comparison covering:
- Automatic shebang handling differences
- Performance and technology comparison
- CLI subcommand configuration examples
- Library compatibility matrix
- Bundle size and tree-shaking analysis
- Standalone binaries preparation (deno, bun, pkg)
- Developer experience and debugging
- Critical edge cases for CLI tools
- Known issues and gotchas
- Use case recommendations

The comparison provides actionable guidance for choosing between
tsdown and pkgroll for TypeScript CLI development, with focus on
shebang handling, zero-config vs explicit config, and distribution
targets.
@github-actions github-actions Bot added documentation Improvements or additions to documentation size/m labels Dec 18, 2025
Translate comprehensive tsdown vs pkgroll comparison to English:
- Main heading and executive summary
- Automatic shebang handling section
- Technology and performance comparison table
- CLI configuration approaches
- Library compatibility matrix
- Bundle size and tree-shaking analysis
- Standalone binaries preparation
- Developer experience and debugging
- Critical edge cases
- Known issues and gotchas
- Use case recommendations

All technical content now in English for wider accessibility
while maintaining the same depth and technical accuracy.
@gander gander merged commit ffe008d into main Dec 18, 2025
16 checks passed
@gander gander deleted the claude/add-bundler-comparison-0jVzJ branch December 18, 2025 00:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants