devskill 2.0.2

package/skills/tsdown/references/option-entry.md

@@ -0,0 +1,211 @@
+# Entry Points
+
+Configure which files to bundle as entry points.
+
+## Overview
+
+Entry points are the starting files for the bundling process. Each entry point generates a separate bundle.
+
+## Usage Patterns
+
+### CLI
+
+```bash
+# Single entry
+tsdown src/index.ts
+
+# Multiple entries
+tsdown src/index.ts src/cli.ts
+
+# Glob patterns
+tsdown 'src/*.ts'
+```
+
+### Config File
+
+#### Single Entry
+
+```ts
+export default defineConfig({
+  entry: 'src/index.ts',
+})
+```
+
+#### Multiple Entries (Array)
+
+```ts
+export default defineConfig({
+  entry: ['src/entry1.ts', 'src/entry2.ts'],
+})
+```
+
+#### Named Entries (Object)
+
+```ts
+export default defineConfig({
+  entry: {
+    main: 'src/index.ts',
+    utils: 'src/utils.ts',
+    cli: 'src/cli.ts',
+  },
+})
+```
+
+Output files will match the keys:
+- `dist/main.mjs`
+- `dist/utils.mjs`
+- `dist/cli.mjs`
+
+## Glob Patterns
+
+Match multiple files dynamically using glob patterns:
+
+### All TypeScript Files
+
+```ts
+export default defineConfig({
+  entry: 'src/**/*.ts',
+})
+```
+
+### Exclude Test Files
+
+```ts
+export default defineConfig({
+  entry: ['src/*.ts', '!src/*.test.ts'],
+})
+```
+
+### Object Entries with Glob Patterns
+
+Use glob wildcards (`*`) in both keys and values. The `*` in the key acts as a placeholder replaced with the matched file name (without extension):
+
+```ts
+export default defineConfig({
+  entry: {
+    // Maps src/foo.ts → dist/lib/foo.js, src/bar.ts → dist/lib/bar.js
+    'lib/*': 'src/*.ts',
+  },
+})
+```
+
+#### Negation Patterns in Object Entries
+
+Values can be an array with negation patterns (`!`):
+
+```ts
+export default defineConfig({
+  entry: {
+    'hooks/*': ['src/hooks/*.ts', '!src/hooks/index.ts'],
+  },
+})
+```
+
+Multiple positive and negation patterns:
+
+```ts
+export default defineConfig({
+  entry: {
+    'utils/*': [
+      'src/utils/*.ts',
+      'src/utils/*.tsx',
+      '!src/utils/index.ts',
+      '!src/utils/internal.ts',
+    ],
+  },
+})
+```
+
+**Warning:** Multiple positive patterns in an array value must share the same base directory.
+
+### Mixed Entries
+
+Mix strings, glob patterns, and object entries in an array:
+
+```ts
+export default defineConfig({
+  entry: [
+    'src/*',
+    '!src/foo.ts',
+    { main: 'index.ts' },
+    { 'lib/*': ['src/*.ts', '!src/bar.ts'] },
+  ],
+})
+```
+
+Object entries take precedence when output names conflict.
+
+### Windows Compatibility
+
+Use forward slashes `/` instead of backslashes `\` on Windows:
+
+```ts
+// ✅ Correct
+entry: 'src/utils/*.ts'
+
+// ❌ Wrong on Windows
+entry: 'src\\utils\\*.ts'
+```
+
+## Common Patterns
+
+### Library with Main Export
+
+```ts
+export default defineConfig({
+  entry: 'src/index.ts',
+  format: ['esm', 'cjs'],
+  dts: true,
+})
+```
+
+### Library with Multiple Exports
+
+```ts
+export default defineConfig({
+  entry: {
+    index: 'src/index.ts',
+    client: 'src/client.ts',
+    server: 'src/server.ts',
+  },
+  format: ['esm', 'cjs'],
+  dts: true,
+})
+```
+
+### CLI Tool
+
+```ts
+export default defineConfig({
+  entry: {
+    cli: 'src/cli.ts',
+  },
+  format: ['esm'],
+  platform: 'node',
+})
+```
+
+### Preserve Directory Structure
+
+Use with `unbundle: true` to keep file structure:
+
+```ts
+export default defineConfig({
+  entry: ['src/**/*.ts', '!**/*.test.ts'],
+  unbundle: true,
+  format: ['esm'],
+  dts: true,
+})
+```
+
+This will output files matching the source structure:
+- `src/index.ts` → `dist/index.mjs`
+- `src/utils/helper.ts` → `dist/utils/helper.mjs`
+
+## Tips
+
+1. **Use glob patterns** for multiple related files
+2. **Use object syntax** for custom output names
+3. **Exclude test files** with negation patterns `!**/*.test.ts`
+4. **Combine with unbundle** to preserve directory structure
+5. **Use named entries** for better control over output filenames

package/skills/tsdown/references/option-exe.md

@@ -0,0 +1,120 @@
+# Executable - `exe`
+
+**[experimental]** Bundle as a standalone executable using [Node.js Single Executable Applications](https://nodejs.org/api/single-executable-applications.html).
+
+## Requirements
+
+- Node.js >= 25.5.0 (ESM support requires >= 25.7.0)
+- Not supported in Bun or Deno
+
+## Basic Usage
+
+```ts
+export default defineConfig({
+  entry: ['src/cli.ts'],
+  exe: true,
+})
+```
+
+## Behavior When Enabled
+
+- Default output format changes from `esm` to `cjs` (unless Node.js >= 25.7.0)
+- Declaration file generation (`dts`) is disabled by default
+- Code splitting is disabled
+- Only single entry points are supported
+- Legacy CJS warnings are suppressed
+
+## Advanced Configuration
+
+```ts
+export default defineConfig({
+  entry: ['src/cli.ts'],
+  exe: {
+    fileName: 'my-tool',
+    seaConfig: {
+      disableExperimentalSEAWarning: true,
+      useCodeCache: true,
+      useSnapshot: false,
+    },
+  },
+})
+```
+
+## `ExeOptions`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `seaConfig` | `Omit<SeaConfig, 'main' \| 'output' \| 'mainFormat'>` | Node.js configuration options |
+| `fileName` | `string \| ((chunk) => string)` | Custom output file name (without `.exe` or platform suffixes) |
+| `targets` | `ExeTarget[]` | Cross-platform build targets (requires `@tsdown/exe`) |
+
+## `SeaConfig`
+
+See [Node.js Single Executable Applications documentation](https://nodejs.org/api/single-executable-applications.html).
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `disableExperimentalSEAWarning` | `boolean` | `true` | Disable the experimental warning |
+| `useSnapshot` | `boolean` | `false` | Use V8 snapshot |
+| `useCodeCache` | `boolean` | `false` | Use V8 code cache |
+| `execArgv` | `string[]` | - | Extra Node.js arguments |
+| `execArgvExtension` | `'none' \| 'env' \| 'cli'` | `'env'` | How to extend execArgv |
+| `assets` | `Record<string, string>` | - | Assets to embed |
+
+## Cross-Platform Builds
+
+Install `@tsdown/exe` to build executables for multiple platforms from a single machine:
+
+```bash
+pnpm add -D @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' },
+    ],
+  },
+})
+```
+
+This downloads the target platform's Node.js binary, caches it locally, and produces platform-suffixed output:
+
+```
+dist/
+  cli-linux-x64
+  cli-darwin-arm64
+  cli-win-x64.exe
+```
+
+### `ExeTarget`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `platform` | `'win' \| 'darwin' \| 'linux'` | Target OS (nodejs.org naming) |
+| `arch` | `'x64' \| 'arm64'` | Target CPU architecture |
+| `nodeVersion` | `string` | Node.js version (must be `>=25.7.0`) |
+
+### Caching
+
+Downloaded Node.js binaries are cached in system cache directories:
+- **macOS:** `~/Library/Caches/tsdown/node/`
+- **Linux:** `~/.cache/tsdown/node/`
+- **Windows:** `%LOCALAPPDATA%/tsdown/Caches/node/`
+
+## Platform Notes
+
+- On macOS, the executable is automatically codesigned (ad-hoc) for Gatekeeper compatibility
+- On Windows, the `.exe` extension is automatically appended
+- When `targets` is specified, `seaConfig.executable` is ignored
+
+## CLI
+
+```bash
+tsdown --exe
+tsdown src/cli.ts --exe
+```

package/skills/tsdown/references/option-lint.md

@@ -0,0 +1,127 @@
+# Package Validation (publint & attw)
+
+Validate your package configuration and type declarations before publishing.
+
+## Overview
+
+tsdown integrates with [publint](https://publint.dev/) and [Are the types wrong?](https://arethetypeswrong.github.io/) (attw) to catch common packaging issues. Both are optional dependencies.
+
+## Installation
+
+```bash
+# publint only
+npm install -D publint
+
+# attw only
+npm install -D @arethetypeswrong/core
+
+# both
+npm install -D publint @arethetypeswrong/core
+```
+
+## publint
+
+Checks that `package.json` fields (`exports`, `main`, `module`, `types`) match your actual output files.
+
+### Enable
+
+```ts
+export default defineConfig({
+  publint: true,
+})
+```
+
+### Configuration
+
+```ts
+export default defineConfig({
+  publint: {
+    level: 'error', // 'warning' | 'error' | 'suggestion'
+  },
+})
+```
+
+### CLI
+
+```bash
+tsdown --publint
+```
+
+## attw (Are the types wrong?)
+
+Verifies TypeScript declarations are correct across different module resolution strategies (`node10`, `node16`, `bundler`).
+
+### Enable
+
+```ts
+export default defineConfig({
+  attw: true,
+})
+```
+
+### Configuration
+
+```ts
+export default defineConfig({
+  attw: {
+    profile: 'node16',   // 'strict' | 'node16' | 'esm-only'
+    level: 'error',       // 'warn' | 'error'
+    ignoreRules: ['false-cjs', 'cjs-resolves-to-esm'],
+  },
+})
+```
+
+### Profiles
+
+| Profile | Description |
+|---------|-------------|
+| `strict` | Requires all resolutions to pass (default) |
+| `node16` | Ignores `node10` resolution failures |
+| `esm-only` | Ignores `node10` and `node16-cjs` resolution failures |
+
+### Ignore Rules
+
+Suppress specific problem types with `ignoreRules`:
+
+| Rule | Description |
+|------|-------------|
+| `no-resolution` | Module could not be resolved |
+| `untyped-resolution` | Resolution succeeded but has no types |
+| `false-cjs` | Types indicate CJS but implementation is ESM |
+| `false-esm` | Types indicate ESM but implementation is CJS |
+| `cjs-resolves-to-esm` | CJS resolution points to an ESM module |
+| `fallback-condition` | A fallback/wildcard condition was used |
+| `cjs-only-exports-default` | CJS module only exports a default |
+| `named-exports` | Named exports mismatch between types and implementation |
+| `false-export-default` | Types declare a default export that doesn't exist |
+| `missing-export-equals` | Types are missing `export =` for CJS |
+| `unexpected-module-syntax` | File uses unexpected module syntax |
+| `internal-resolution-error` | Internal resolution error in type checking |
+
+### CLI
+
+```bash
+tsdown --attw
+```
+
+## CI Integration
+
+Both tools support CI-aware options:
+
+```ts
+export default defineConfig({
+  publint: 'ci-only',
+  attw: {
+    enabled: 'ci-only',
+    profile: 'node16',
+    level: 'error',
+  },
+})
+```
+
+Both tools require a `package.json` in your project directory.
+
+## Related Options
+
+- [CI Environment](advanced-ci.md) - CI-aware option details
+- [Package Exports](option-package-exports.md) - Auto-generate exports field

package/skills/tsdown/references/option-log-level.md

@@ -0,0 +1,91 @@
+# Log Level
+
+Control the verbosity of build output.
+
+## Overview
+
+The `logLevel` option controls how much information tsdown displays during the build process.
+
+## Type
+
+```ts
+logLevel?: 'silent' | 'error' | 'warn' | 'info'
+```
+
+**Default:** `'info'`
+
+## Basic Usage
+
+### CLI
+
+```bash
+# Suppress all output
+tsdown --log-level silent
+
+# Only show errors
+tsdown --log-level error
+
+# Show warnings and errors
+tsdown --log-level warn
+
+# Show all info (default)
+tsdown --log-level info
+```
+
+### Config File
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  logLevel: 'error',
+})
+```
+
+## Available Levels
+
+| Level | Shows | Use Case |
+|-------|-------|----------|
+| `silent` | Nothing | CI/CD pipelines, scripting |
+| `error` | Errors only | Minimal output |
+| `warn` | Warnings + errors | Standard CI/CD |
+| `info` | All messages | Development (default) |
+
+## Common Patterns
+
+### CI/CD Pipeline
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  logLevel: 'error',  // Only show errors in CI
+})
+```
+
+### Scripting
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  logLevel: 'silent',  // No output for automation
+})
+```
+
+## Fail on Warnings
+
+The `failOnWarn` option controls whether warnings cause the build to exit with a non-zero code. Defaults to `false` — warnings never fail the build.
+
+```ts
+export default defineConfig({
+  failOnWarn: false,     // Default: never fail on warnings
+  // failOnWarn: true,   // Always fail on warnings
+  // failOnWarn: 'ci-only', // Fail on warnings only in CI
+})
+```
+
+See [CI Environment](advanced-ci.md) for more about CI-aware options.
+
+## Related Options
+
+- [CI Environment](advanced-ci.md) - CI-aware option details
+- [CLI Reference](reference-cli.md) - All CLI options
+- [Config File](option-config-file.md) - Configuration setup

package/skills/tsdown/references/option-minification.md

@@ -0,0 +1,177 @@
+# Minification
+
+Compress code to reduce bundle size.
+
+## Overview
+
+Minification removes unnecessary characters (whitespace, comments) and optimizes code for production, reducing bundle size and improving load times.
+
+**Note:** Uses [Oxc minifier](https://oxc.rs/docs/contribute/minifier) internally. The minifier is currently in alpha.
+
+## Type
+
+```ts
+minify?: boolean | 'dce-only' | MinifyOptions
+```
+
+- `true` — Enable full minification (whitespace removal, mangling, compression)
+- `false` — Disable minification (default)
+- `'dce-only'` — Only perform dead code elimination without full minification
+- `MinifyOptions` — Pass detailed options to the Oxc minifier
+
+## Basic Usage
+
+### CLI
+
+```bash
+# Enable minification
+tsdown --minify
+
+# Disable minification
+tsdown --no-minify
+```
+
+**Note:** The CLI `--minify` flag is a boolean toggle. For `'dce-only'` mode or advanced options, use the config file.
+
+### Config File
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  minify: true,
+})
+```
+
+### DCE-Only Mode
+
+Remove dead code without full minification (keeps readable output):
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  minify: 'dce-only',
+})
+```
+
+## Example Output
+
+### Without Minification
+
+```js
+// dist/index.mjs
+const x = 1
+
+function hello(x$1) {
+  console.log('Hello World')
+  console.log(x$1)
+}
+
+hello(x)
+```
+
+### With Minification
+
+```js
+// dist/index.mjs
+const e=1;function t(e){console.log(`Hello World`),console.log(e)}t(e);
+```
+
+## Common Patterns
+
+### Production Build
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  minify: true,
+  clean: true,
+})
+```
+
+### Conditional Minification
+
+```ts
+export default defineConfig((options) => ({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  minify: !options.watch,  // Only minify in production
+}))
+```
+
+### Browser Library
+
+```ts
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['iife'],
+  platform: 'browser',
+  globalName: 'MyLib',
+  minify: true,
+})
+```
+
+### Multiple Builds
+
+```ts
+export default defineConfig([
+  // Development build
+  {
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    minify: false,
+    outDir: 'dist/dev',
+  },
+  // Production build
+  {
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    minify: true,
+    outDir: 'dist/prod',
+  },
+])
+```
+
+## CLI Examples
+
+```bash
+# Production build with minification
+tsdown --minify --clean
+
+# Multiple formats with minification
+tsdown --format esm --format cjs --minify
+
+# Conditional minification (only when not watching)
+tsdown --minify  # Or omit --watch
+```
+
+## Tips
+
+1. **Use `minify: true`** for production builds
+2. **Use `'dce-only'`** to remove dead code while keeping output readable
+3. **Skip minification** during development for faster rebuilds
+4. **Combine with tree shaking** for best results
+5. **Test minified output** thoroughly (Oxc minifier is in alpha)
+
+## Troubleshooting
+
+### Minified Code Has Bugs
+
+Oxc minifier is in alpha and may have issues:
+
+1. **Use DCE-only mode**: `minify: 'dce-only'`
+2. **Report bug** to [Oxc project](https://github.com/oxc-project/oxc/issues)
+3. **Disable minification**: `minify: false`
+
+### Unexpected Output
+
+- **Test unminified** first to isolate issue
+- **Check source maps** for debugging
+- **Verify target compatibility**
+
+## Related Options
+
+- [Tree Shaking](option-tree-shaking.md) - Remove unused code
+- [Target](option-target.md) - Syntax transformations
+- [Output Format](option-output-format.md) - Module formats
+- [Sourcemap](option-sourcemap.md) - Debug information