ts-library
/ts-library
Prowadzi przez tworzenie bibliotek TypeScript i pakietów npm: konfigurację, exports, budowanie, testy i publikację.
- Autor
- samplexbro ↗
- Repozytorium
- agentsmesh ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 24.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 19
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 24.09.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi przez tworzenie bibliotek TypeScript i pakietów npm: konfigurację, exports, budowanie, testy i publikację.
Oryginalny opis (EN)
Use when authoring TypeScript libraries or npm packages - covers project setup, package.json exports, build tooling (tsdown/unbuild), API design patterns, type inference tricks, testing, and publishing to npm. Use when bundling, configuring dual CJS/ESM output, or setting up release workflows.
Jak działa
- Purpose
- When to Use
- Quick Reference
- Loading Files
- New Library Workflow
- Quick Start
- Key Principles
Podgląd SKILL.md
---
name: ts-library
description: Use when authoring TypeScript libraries or npm packages - covers project setup, package.json exports, build tooling (tsdown/unbuild), API design patterns, type inference tricks, testing, and publishing to npm. Use when bundling, configuring dual CJS/ESM output, or setting up release workflows.
---
## Purpose
# TypeScript Library Development
Patterns for authoring high-quality TypeScript libraries, extracted from studying unocss, shiki, unplugin, vite, vitest, vueuse, zod, trpc, drizzle-orm, and more.
## When to Use
- Starting a new TypeScript library (single or monorepo)
- Setting up package.json exports for dual CJS/ESM
- Configuring tsconfig for library development
- Choosing build tools (tsdown, unbuild)
- Designing type-safe APIs (builder, factory, plugin patterns)
- Writing advanced TypeScript types
- Setting up vitest for library testing
- Configuring release workflow and CI
**For Nuxt module development:** use `nuxt-modules` skill
## Quick Reference
| Working on... | Load file |
| --------------------- |-------------------------------------------------------------------------------------------------------------------------------|
| New project setup | [./references/project-setup.md](./references/project-setup.md) |
| Package exports | [./references/package-exports.md](./references/package-exports.md) |
| tsconfig options | [./references/typescript-config.md](./references/typescript-config.md) |
| Build configuration | [./references/build-tooling.md](./references/build-tooling.md) |
| ESLint config | [./references/eslint-config.md](./references/eslint-config.md) |
| API design patterns | [./references/api-design.md](./references/api-design.md) |
| Type inference tricks | [./references/type-patterns.md](./references/type-patterns.md) |
| Testing setup | [./references/testing.md](./references/testing.md) |
| Release workflow | [./references/release.md](./references/release.md) |
| CI/CD setup | [./references/ci-workflows.md](./references/ci-workflows.md) |
## Loading Files
**Consider loading these reference files based on your task:**
- [ ] [./references/project-setup.md](./references/project-setup.md) - if starting a new TypeScript library project
- [ ] [./references/package-exports.md](./references/package-exports.md) - if configuring package.json exports or dual CJS/ESM
- [ ] [./references/typescript-config.md](./references/typescript-config.md) - if setting up or modifying tsconfig.json
- [ ] [./references/build-tooling.md](./references/build-tooling.md) - if configuring tsdown, unbuild, or build scripts
- [ ] [./references/eslint-config.md](./references/eslint-config.md) - if setting up ESLint for library development
- [ ] [./references/api-design.md](./references/api-design.md) - if designing public APIs, builder patterns, or plugin systems
- [ ] [./references/type-patterns.md](./references/type-patterns.md) - if working with advanced TypeScript types or type inference
- [ ] [./references/testing.md](./references/testing.md) - if setting up vitest or writing tests for library code
- [ ] [./references/release.md](./references/release.md) - if configuring release workflow or versioning
- [ ] [./references/ci-workflows.md](./references/ci-workflows.md) - if setting up GitHub Actions or CI/CD pipelines
**DO NOT load all files at once.** Load only what's relevant to your current task.
## New Library Workflow
1. Create project structure → load [./references/project-setup.md](./references/project-setup.md)
2. Configure `package.json` exports → load [./references/package-exports.md](./references/package-exports.md)
3. Set up build with tsdown → load [./references/build-tooling.md](./references/build-tooling.md)
4. Verify build: `pnpm build && pnpm pack --dry-run` — check output includes `.mjs`, `.cjs`, `.d.ts`
5. Add tests → load [./references/testing.md](./references/testing.md)
6. Configure release → load [./references/release.md](./references/release.md)
## Quick Start
```json
// package.json (minimal)
{
"name": "my-lib",
"type": "module",
"exports": {
".": {
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
}
},
"main": "./dist/index.cjs",
"module": "./dist/index.mjs",
"types": "./dist/index.d.ts",
"files": ["dist"]
}
```
```ts
// tsdown.config.ts
import { defineConfig } from 'tsdown'
export default defineConfig({
entry: ['src/index.ts'],
format: ['esm', 'cjs'],
dts: true,
})
```
## Key Principles
- ESM-first: `"type": "module"` with `.mjs` outputs
- Dual format: always support both CJS and ESM consumers
- `moduleResolution: "Bundler"` for modern TypeScript
- tsdown for most builds, unbuild for complex cases
- Smart defaults: detect environment, don't force config
- Tree-shakeable: lazy getters, proper `sideEffects: false`
_Token efficiency: Main skill ~300 tokens, each reference ~800-1200 tokens_
Pliki w paczce (19)
- SKILL.md 5 KB
- patterns/api.md 4 KB
- patterns/types.md 4 KB
- references/api-design.md 4 KB
- references/build-tooling.md 3 KB
- references/ci-workflows.md 6 KB
- references/eslint-config.md 3 KB
- references/package-exports.md 3 KB
- references/project-setup.md 3 KB
- references/release.md 3 KB
- references/testing.md 4 KB
- references/type-patterns.md 4 KB
- references/typescript-config.md 3 KB
- setup/exports.md 3 KB
- setup/project.md 3 KB
- setup/tsconfig.md 3 KB
- workflows/ci.md 6 KB
- workflows/release.md 3 KB
- workflows/testing.md 4 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · samplexbro/agentsmesh | 100 | MIT |
| samplexbro/agentsmesh | 100 | MIT |
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki aa25e067621f (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 1 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100sdk-development
Buduje SDK w TypeScript: typowane klienty, obsługę błędów, pakiety ESM, CJS i przeglądarkowe oraz publikację na npm. - 95ts-sdk-author
Projektuje, buduje, weryfikuje i publikuje SDK w TypeScript jako pakiety npm w monorepo pnpm, z tsdown, exports i changesets. - 100ts-packaging
Pomaga publikować bibliotekę TypeScript: mapa exports, JSR czy npm, podwójny ESM i CJS, walidacja typów i provenance. - 100tsup
Pakuje biblioteki TypeScript w tsup, opartym na esbuild bez konfiguracji: podwójne wyjście ESM i CJS, pliki deklaracji, tree-shaking i publikacja do npm. - 90arch-tsdown
Zakłada bibliotekę TypeScript na tsdown, z pnpm, Vitest i publikacją przez npm Trusted Publisher. - 90npm-publishing
Publikuje pakiet npm, który poprawnie się instaluje i importuje: właściwa mapa exports, formaty dual, typy i semver.