Files

T

fargo 1a822493ba format: apply repo prettier (3.8.1) to the folded skills tree

963 markdown files reformatted with the repository's pinned prettier so
pnpm format:check covers the folded tree like every other repo file.

The formatter's embedded-language pass also normalized code fences
(TS semicolons, closed HTML tags in examples, lowercased CSS hex colors,
one renumbered list that skipped an index). Alphanumeric token deltas vs
the fold commit were audited file-by-file; all are formatter-equivalent
markup normalizations plus the four sanitized skills.

2026-08-19 14:37:17 -05:00

4.6 KiB

Raw Blame History

tsdown Skill References

This directory contains detailed reference documentation for the tsdown skill.

Created Files (31 total)

Core Guides (2)

✅ guide-getting-started.md - Installation, first bundle, CLI basics
✅ guide-migrate-from-tsup.md - Migration guide from tsup

Configuration Options (20)

✅ option-config-file.md - Config file formats, loaders, workspace
✅ option-entry.md - Entry point configuration with globs
✅ option-output-format.md - Output formats (ESM, CJS, IIFE, UMD)
✅ option-output-directory.md - Output directory and extensions
✅ option-dts.md - TypeScript declaration generation
✅ option-target.md - Target environment (ES2020, ESNext, etc.)
✅ option-platform.md - Platform (node, browser, neutral)
✅ option-dependencies.md - External and inline dependencies
✅ option-sourcemap.md - Source map generation
✅ option-minification.md - Minification (boolean | 'dce-only' | MinifyOptions)
✅ option-tree-shaking.md - Tree shaking configuration
✅ option-cleaning.md - Output directory cleaning
✅ option-watch-mode.md - Watch mode configuration
✅ option-shims.md - ESM/CJS compatibility shims
✅ option-package-exports.md - Auto-generate package.json exports
✅ option-css.md - CSS handling (experimental, stub only)
✅ option-unbundle.md - Preserve directory structure
✅ option-cjs-default.md - CommonJS default export handling
✅ option-log-level.md - Logging configuration
✅ option-lint.md - Package validation (publint & attw)

Advanced Topics (5)

✅ advanced-plugins.md - Rolldown, Rollup, Unplugin support
✅ advanced-hooks.md - Lifecycle hooks system
✅ advanced-programmatic.md - Node.js API usage
✅ advanced-rolldown-options.md - Pass options to Rolldown
✅ advanced-ci.md - CI environment detection and CI-aware options

Framework Recipes (3)

✅ recipe-react.md - React library setup with JSX
✅ recipe-vue.md - Vue library setup with SFC
✅ recipe-wasm.md - WASM module support

Reference (1)

✅ reference-cli.md - Complete CLI command reference

Coverage Status

Created: 31 files (97% complete) Remaining: 3 files (low priority, not referenced from SKILL.md)

Remaining Files (Lower Priority)

These files can be added as needed:

guide-introduction.md - Covered in main SKILL.md
guide-faq.md - FAQ (stub mode, etc.)
advanced-benchmark.md - Performance data

Current Skill Features

The tsdown skill now includes comprehensive coverage of:

✅ Core Functionality

Getting started and installation
Entry points and glob patterns
Output formats (ESM, CJS, IIFE, UMD)
TypeScript declarations
Configuration file setup
CLI reference

✅ Build Options

Target environment configuration
Platform selection
Dependency management
Source maps
Minification
Tree shaking
Output cleaning
Watch mode

✅ Advanced Features

Plugins (Rolldown, Rollup, Unplugin)
Lifecycle hooks
ESM/CJS shims
Package exports generation
Package validation (publint, attw)
Programmatic API (Node.js)
Output directory customization
CSS handling and modules
Unbundle mode
CI environment detection and CI-aware options

✅ Framework & Runtime Support

React with JSX/TSX
React Compiler integration
Vue with SFC support
Vue type generation (vue-tsc)
WASM module bundling (rolldown-plugin-wasm)

✅ Migration

Complete migration guide from tsup
Compatibility notes

Usage

The skill is now ready for use with comprehensive coverage of core features. Additional files can be added incrementally as needed.

File Naming Convention

Files are prefixed by category:

guide-* - Getting started guides and tutorials
option-* - Configuration options
advanced-* - Advanced topics (plugins, hooks, programmatic API)
recipe-* - Framework-specific recipes
reference-* - CLI and API reference

Creating New Reference Files

When creating new reference files:

Read source documentation from /docs directory
Simplify for AI consumption - concise, actionable content
Include code examples - practical, copy-paste ready
Add cross-references - link to related options
Follow naming convention - use appropriate prefix
Keep it focused - one topic per file

Updating Existing Files

When documentation changes:

Check git diff: git diff <sha>..HEAD -- docs/
Update affected reference files
Update SKILL.md if needed
Update GENERATION.md with new SHA

See skills/GENERATION.md for detailed update instructions.

4.6 KiB Raw Blame History