Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

ts-library

/ts-library

Prowadzi przez tworzenie bibliotek TypeScript i pakietów npm: konfigurację, exports, budowanie, testy i publikację.

Repozytorium
agentsmesh ↗
Licencja
MIT
Ostatnia zmiana repozytorium
24.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
19
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Purpose
  2. When to Use
  3. Quick Reference
  4. Loading Files
  5. New Library Workflow
  6. Quick Start
  7. Key Principles
Sekcje z nagłówków SKILL.md, w oryginale · 102 linii, 489 słów
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

RepozytoriumWynikLicencja
Ta strona · samplexbro/agentsmesh100MIT
samplexbro/agentsmesh100MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.