ads-fe 0.0.1

package/skills/tsdown/SKILL.md

@@ -0,0 +1,416 @@
+---
+name: tsdown
+description: Bundle TypeScript and JavaScript libraries with blazing-fast speed powered by Rolldown. Use when building libraries, generating type declarations, bundling for multiple formats, or migrating from tsup.
+---
+
+# tsdown - The Elegant Library Bundler
+
+Blazing-fast bundler for TypeScript/JavaScript libraries powered by Rolldown and Oxc.
+
+## Runtime Requirement
+
+`tsdown` requires **Node.js 22.18.0 or higher to run** (build-time only). However, the bundled output can target much lower Node.js versions via the [`target`](references/option-target.md) option, so libraries built with tsdown are **not locked to Node.js 22+ at runtime**.
+
+If your package needs to support Node.js 18 / 20:
+
+- **Build with Node.js 22+ in CI** (e.g. set `target: 'node18'` or `target: 'node20'`).
+- **Test the built output (or the packed tarball) on the lower Node.js versions** you intend to support — e.g. using a matrix job that runs the published package's tests on Node.js 18 / 20 / 22.
+
+## When to Use
+
+- Building TypeScript/JavaScript libraries for npm
+- Generating TypeScript declaration files (.d.ts)
+- Bundling for multiple formats (ESM, CJS, IIFE, UMD)
+- Optimizing bundles with tree shaking and minification
+- Migrating from tsup with minimal changes
+- Building React, Vue, Solid, or Svelte component libraries
+
+## Quick Start
+
+```bash
+# Install
+pnpm add -D tsdown
+
+# Basic usage
+npx tsdown
+
+# With config file
+npx tsdown --config tsdown.config.ts
+
+# Watch mode
+npx tsdown --watch
+
+# Migrate from tsup
+npx tsdown-migrate
+```
+
+## Basic Configuration
+
+```ts
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['./src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  clean: true,
+})
+```
+
+## Core References
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Getting Started | Installation, first bundle, CLI basics | [guide-getting-started](references/guide-getting-started.md) |
+| Configuration File | Config file formats, multiple configs, workspace | [option-config-file](references/option-config-file.md) |
+| CLI Reference | All CLI commands and options | [reference-cli](references/reference-cli.md) |
+| Migrate from tsup | Migration guide and compatibility notes | [guide-migrate-from-tsup](references/guide-migrate-from-tsup.md) |
+| Plugins | Rolldown, Rollup, Unplugin support | [advanced-plugins](references/advanced-plugins.md) |
+
+> For comprehensive migration assistance with complete option mappings, install the dedicated [`tsdown-migrate`](../tsdown-migrate/SKILL.md) skill: `npx skills add rolldown/tsdown --skill tsdown-migrate`
+| Hooks | Lifecycle hooks for custom logic | [advanced-hooks](references/advanced-hooks.md) |
+| Programmatic API | Build from Node.js scripts | [advanced-programmatic](references/advanced-programmatic.md) |
+| Rolldown Options | Pass options directly to Rolldown | [advanced-rolldown-options](references/advanced-rolldown-options.md) |
+| CI Environment | CI detection, `'ci-only'` / `'local-only'` values | [advanced-ci](references/advanced-ci.md) |
+
+## Build Options
+
+| Option | Usage | Reference |
+|--------|-------|-----------|
+| Entry points | `entry: ['src/*.ts', '!**/*.test.ts']` | [option-entry](references/option-entry.md) |
+| Output formats | `format: ['esm', 'cjs', 'iife', 'umd']` | [option-output-format](references/option-output-format.md) |
+| Output directory | `outDir: 'dist'`, `outExtensions` | [option-output-directory](references/option-output-directory.md) |
+| Type declarations | `dts: true`, `dts: { sourcemap, compilerOptions, vue }` | [option-dts](references/option-dts.md) |
+| Target environment | `target: 'es2020'`, `target: 'esnext'` | [option-target](references/option-target.md) |
+| Platform | `platform: 'node'`, `platform: 'browser'` | [option-platform](references/option-platform.md) |
+| Tree shaking | `treeshake: true`, custom options | [option-tree-shaking](references/option-tree-shaking.md) |
+| Minification | `minify: true`, `minify: 'dce-only'` | [option-minification](references/option-minification.md) |
+| Source maps | `sourcemap: true`, `'inline'`, `'hidden'` | [option-sourcemap](references/option-sourcemap.md) |
+| Watch mode | `watch: true`, watch options | [option-watch-mode](references/option-watch-mode.md) |
+| Cleaning | `clean: true`, clean patterns | [option-cleaning](references/option-cleaning.md) |
+| Log level | `logLevel: 'silent'`, `failOnWarn: false` | [option-log-level](references/option-log-level.md) |
+
+## Dependency Handling
+
+| Feature | Usage | Reference |
+|---------|-------|-----------|
+| Never bundle | `deps: { neverBundle: ['react', /^@myorg\//] }` | [option-dependencies](references/option-dependencies.md) |
+| Always bundle | `deps: { alwaysBundle: ['dep-to-bundle'] }` | [option-dependencies](references/option-dependencies.md) |
+| Only bundle | `deps: { onlyBundle: ['cac', 'bumpp'] }` - Whitelist | [option-dependencies](references/option-dependencies.md) |
+| Skip node_modules | `deps: { skipNodeModulesBundle: true }` | [option-dependencies](references/option-dependencies.md) |
+| Auto external | Automatic dependency/peer/optional externalization | [option-dependencies](references/option-dependencies.md) |
+
+## Output Enhancement
+
+| Feature | Usage | Reference |
+|---------|-------|-----------|
+| Shims | `shims: true` - Add ESM/CJS compatibility | [option-shims](references/option-shims.md) |
+| CJS default | `cjsDefault: true` (default) / `false` | [option-cjs-default](references/option-cjs-default.md) |
+| Package exports | `exports: true` - Auto-generate exports field | [option-package-exports](references/option-package-exports.md) |
+| CSS handling | **[experimental]** `css: { ... }` — full pipeline with preprocessors, Lightning CSS, PostCSS, CSS modules, code splitting; requires `@tsdown/css` | [option-css](references/option-css.md) |
+| CSS modules | `css: { modules: { localsConvention: 'camelCase' } }` — scoped class names for `.module.css` files | [option-css](references/option-css.md) |
+| CSS inject | `css: { inject: true }` — preserve CSS imports in JS output | [option-css](references/option-css.md) |
+| Unbundle mode | `unbundle: true` - Preserve directory structure | [option-unbundle](references/option-unbundle.md) |
+| Root directory | `root: 'src'` - Control output directory mapping | [option-root](references/option-root.md) |
+| Executable | **[experimental]** `exe: true` - Bundle as standalone executable, cross-platform via `@tsdown/exe` | [option-exe](references/option-exe.md) |
+| Package validation | `publint: true`, `attw: true` - Validate package | [option-lint](references/option-lint.md) |
+
+## Framework & Runtime Support
+
+| Framework | Guide | Reference |
+|-----------|-------|-----------|
+| React | JSX transform, React Compiler | [recipe-react](references/recipe-react.md) |
+| Vue | SFC support, JSX | [recipe-vue](references/recipe-vue.md) |
+| Solid | SolidJS JSX transform | [recipe-solid](references/recipe-solid.md) |
+| Svelte | Svelte component libraries (source distribution recommended) | [recipe-svelte](references/recipe-svelte.md) |
+| WASM | WebAssembly modules via `rolldown-plugin-wasm` | [recipe-wasm](references/recipe-wasm.md) |
+
+## Common Patterns
+
+### Basic Library Bundle
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  clean: true,
+})
+```
+
+### Multiple Entry Points
+
+```ts
+export default defineConfig({
+  entry: {
+    index: 'src/index.ts',
+    utils: 'src/utils.ts',
+    cli: 'src/cli.ts',
+  },
+  format: ['esm', 'cjs'],
+  dts: true,
+})
+```
+
+### Browser Library (IIFE/UMD)
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['iife'],
+  globalName: 'MyLib',
+  platform: 'browser',
+  minify: true,
+})
+```
+
+### React Component Library
+
+```ts
+export default defineConfig({
+  entry: ['src/index.tsx'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  deps: {
+    neverBundle: ['react', 'react-dom'],
+  },
+  inputOptions: {
+    jsx: { runtime: 'automatic' },
+  },
+})
+```
+
+### Preserve Directory Structure
+
+```ts
+export default defineConfig({
+  entry: ['src/**/*.ts', '!**/*.test.ts'],
+  unbundle: true, // Preserve file structure
+  format: ['esm'],
+  dts: true,
+})
+```
+
+### CI-Aware Configuration
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  failOnWarn: 'ci-only',  // opt-in: fail on warnings in CI
+  publint: 'ci-only',
+  attw: 'ci-only',
+})
+```
+
+### WASM Support
+
+```ts
+import { wasm } from 'rolldown-plugin-wasm'
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  plugins: [wasm()],
+})
+```
+
+### Library with CSS and Sass
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  target: 'chrome100',
+  css: {
+    preprocessorOptions: {
+      scss: {
+        additionalData: `@use "src/styles/variables" as *;`,
+      },
+    },
+  },
+})
+```
+
+### Standalone Executable
+
+```ts
+export default defineConfig({
+  entry: ['src/cli.ts'],
+  exe: true,
+})
+```
+
+### Cross-Platform Executable (requires `@tsdown/exe`)
+
+```ts
+export default defineConfig({
+  entry: ['src/cli.ts'],
+  exe: {
+    targets: [
+      { platform: 'linux', arch: 'x64', nodeVersion: '25.7.0' },
+      { platform: 'darwin', arch: 'arm64', nodeVersion: '25.7.0' },
+      { platform: 'win', arch: 'x64', nodeVersion: '25.7.0' },
+    ],
+  },
+})
+```
+
+### Advanced with Hooks
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  hooks: {
+    'build:before': async (context) => {
+      console.log('Building...')
+    },
+    'build:done': async (context) => {
+      console.log('Build complete!')
+    },
+  },
+})
+```
+
+## Configuration Features
+
+### Multiple Configs
+
+Export an array for multiple build configurations:
+
+```ts
+export default defineConfig([
+  {
+    entry: ['src/index.ts'],
+    format: ['esm', 'cjs'],
+    dts: true,
+  },
+  {
+    entry: ['src/cli.ts'],
+    format: ['esm'],
+    platform: 'node',
+  },
+])
+```
+
+### Conditional Config
+
+Use functions for dynamic configuration:
+
+```ts
+export default defineConfig((options) => {
+  const isDev = options.watch
+  return {
+    entry: ['src/index.ts'],
+    format: ['esm', 'cjs'],
+    minify: !isDev,
+    sourcemap: isDev,
+  }
+})
+```
+
+### Workspace/Monorepo
+
+Use glob patterns to build multiple packages:
+
+```ts
+export default defineConfig({
+  workspace: 'packages/*',
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+})
+```
+
+## CLI Quick Reference
+
+```bash
+# Basic commands
+tsdown                          # Build once
+tsdown --watch                  # Watch mode
+tsdown --config custom.ts       # Custom config
+npx tsdown-migrate              # Migrate from tsup
+
+# Output options
+tsdown --format esm,cjs        # Multiple formats
+tsdown -d lib                  # Custom output directory (--out-dir)
+tsdown --minify                # Enable minification
+tsdown --dts                   # Generate declarations
+tsdown --exe                   # Bundle as standalone executable
+tsdown --unbundle              # Bundleless mode
+
+# Entry options
+tsdown src/index.ts            # Single entry
+tsdown src/*.ts                # Glob patterns
+tsdown src/a.ts src/b.ts       # Multiple entries
+
+# Workspace / Monorepo
+tsdown -W                      # Enable workspace mode
+tsdown -W -F my-package        # Filter specific package
+tsdown --filter /^pkg-/        # Filter by regex
+
+# Development
+tsdown --watch                 # Watch mode
+tsdown --sourcemap             # Generate source maps
+tsdown --clean                 # Clean output directory
+tsdown --from-vite             # Reuse Vite config
+tsdown --tsconfig tsconfig.build.json  # Custom tsconfig
+```
+
+## Best Practices
+
+1. **Always generate type declarations** for TypeScript libraries:
+   ```ts
+   { dts: true }
+   ```
+
+2. **Externalize dependencies** to avoid bundling unnecessary code:
+   ```ts
+   { deps: { neverBundle: [/^react/, /^@myorg\//] } }
+   ```
+
+3. **Use tree shaking** for optimal bundle size:
+   ```ts
+   { treeshake: true }
+   ```
+
+4. **Enable minification** for production builds:
+   ```ts
+   { minify: true }
+   ```
+
+5. **Add shims** for better ESM/CJS compatibility:
+   ```ts
+   { shims: true }  // Adds __dirname, __filename, etc.
+   ```
+
+6. **Auto-generate package.json exports**:
+   ```ts
+   { exports: true }  // Creates proper exports field
+   ```
+
+7. **Use watch mode** during development:
+   ```bash
+   tsdown --watch
+   ```
+
+8. **Preserve structure** for utilities with many files:
+   ```ts
+   { unbundle: true }  // Keep directory structure
+   ```
+
+9. **Validate packages** in CI before publishing:
+   ```ts
+   { publint: 'ci-only', attw: 'ci-only' }
+   ```
+
+## Resources
+
+- Documentation: https://tsdown.dev
+- GitHub: https://github.com/rolldown/tsdown
+- Rolldown: https://rolldown.rs
+- Migration Guide: https://tsdown.dev/guide/migrate-from-tsup

package/skills/tsdown/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- Source: `vendor/tsdown/skills/tsdown`
+- Git SHA: `937f2535866cb3cf72b3de2b195ba20a167b0ecb`
+- Synced: 2026-05-21

package/skills/tsdown/references/README.md

@@ -0,0 +1,139 @@
+# tsdown Skill References
+
+This directory contains detailed reference documentation for the tsdown skill.
+
+## Created Files (35 total)
+
+### Core Guides (3)
+- ✅ `guide-getting-started.md` - Installation, first bundle, CLI basics
+- ✅ `guide-migrate-from-tsup.md` - Migration guide from tsup
+- ✅ `guide-introduction.md` - Introduction and key features
+
+### 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, full pipeline: preprocessors, Lightning CSS, PostCSS, code splitting)
+- ✅ `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)
+
+### Executable (1)
+- ✅ `option-exe.md` - Standalone executable bundling (Node.js SEA)
+
+### Advanced Topics (6)
+- ✅ `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
+
+### Advanced (continued)
+- ✅ `advanced-benchmark.md` - Performance benchmarks
+
+### Framework Recipes (5)
+- ✅ `recipe-react.md` - React library setup with JSX
+- ✅ `recipe-vue.md` - Vue library setup with SFC
+- ✅ `recipe-solid.md` - Solid.js library setup
+- ✅ `recipe-svelte.md` - Svelte component libraries
+- ✅ `recipe-wasm.md` - WASM module support
+
+### Reference (1)
+- ✅ `reference-cli.md` - Complete CLI command reference
+
+## Coverage Status
+
+**Created:** 35 files (100% complete)
+
+## 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:
+
+1. **Read source documentation** from `/docs` directory
+2. **Simplify for AI consumption** - concise, actionable content
+3. **Include code examples** - practical, copy-paste ready
+4. **Add cross-references** - link to related options
+5. **Follow naming convention** - use appropriate prefix
+6. **Keep it focused** - one topic per file
+
+## Updating Existing Files
+
+When documentation changes:
+
+1. Check git diff: `git diff <sha>..HEAD -- docs/`
+2. Update affected reference files
+3. Update SKILL.md if needed
+4. Update GENERATION.md with new SHA
+
+See `skills/GENERATION.md` for detailed update instructions.

package/skills/tsdown/references/advanced-benchmark.md

@@ -0,0 +1,8 @@
+# Benchmark
+
+tsdown delivers exceptional performance:
+
+- **~2x faster** than tsup for standard builds
+- **Up to 8x faster** for TypeScript declaration generation
+
+For detailed comparisons, see [bundler-benchmark](https://gugustinette.github.io/bundler-benchmark/).

package/skills/tsdown/references/advanced-ci.md

@@ -0,0 +1,89 @@
+# CI Environment Support
+
+Automatically detect CI environments and toggle features based on local vs CI builds.
+
+## Overview
+
+tsdown uses the [`is-in-ci`](https://www.npmjs.com/package/is-in-ci) package to detect CI environments. This covers GitHub Actions, GitLab CI, Jenkins, CircleCI, Travis CI, and more.
+
+## CI-Aware Values
+
+Several options accept CI-aware string values:
+
+| Value | Behavior |
+|-------|----------|
+| `true` | Always enabled |
+| `false` | Always disabled |
+| `'ci-only'` | Enabled only in CI, disabled locally |
+| `'local-only'` | Enabled only locally, disabled in CI |
+
+## Supported Options
+
+These options accept CI-aware values:
+
+- `dts` - TypeScript declaration file generation
+- `publint` - Package lint validation
+- `attw` - "Are the types wrong" validation
+- `report` - Bundle size reporting
+- `exports` - Auto-generate `package.json` exports
+- `unused` - Unused dependency check
+- `devtools` - DevTools integration
+- `failOnWarn` - Fail on warnings (defaults to `false`)
+
+## Usage
+
+### String Form
+
+```ts
+export default defineConfig({
+  dts: 'local-only',        // Skip DTS in CI for faster builds
+  publint: 'ci-only',       // Only run publint in CI
+  failOnWarn: 'ci-only',    // Fail on warnings in CI only (opt-in)
+})
+```
+
+### Object Form
+
+When an option takes a configuration object, set `enabled` to a CI-aware value:
+
+```ts
+export default defineConfig({
+  publint: {
+    enabled: 'ci-only',
+    level: 'error',
+  },
+  attw: {
+    enabled: 'ci-only',
+    profile: 'node16',
+  },
+})
+```
+
+### Config Function
+
+The config function receives a `ci` boolean in its context:
+
+```ts
+export default defineConfig((_, { ci }) => ({
+  minify: ci,
+  sourcemap: !ci,
+}))
+```
+
+## Typical CI Configuration
+
+```ts
+export default defineConfig({
+  entry: 'src/index.ts',
+  format: ['esm', 'cjs'],
+  dts: true,
+  failOnWarn: 'ci-only',
+  publint: 'ci-only',
+  attw: 'ci-only',
+})
+```
+
+## Related Options
+
+- [Package Validation](option-lint.md) - publint and attw configuration
+- [Log Level](option-log-level.md) - `failOnWarn` option details