tsdjs/tsd

Health v2 · maintenance only

Adoption not part of the score

2557 stars · 68 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

tsd is a CLI tool and library for testing TypeScript type definitions (.d.ts files). It statically analyzes .test-d.ts files containing assertion constructs like expectType and expectError to verify that type definitions behave as intended.

Use cases

• test my package's .d.ts type definitions
• assert that a function returns an exact TypeScript type
• verify that invalid code produces a type error
• catch regressions in typings before publishing to npm
• run type-level tests in CI

When to choose

• you publish an npm package with TypeScript typings and want to test them
• you need strict type assertions like expectType or expectError
• you want type tests integrated into CI without executing code

When to avoid

• you need runtime unit tests rather than type-level checks
• you want type testing built into the TypeScript compiler itself (consider vitest expectTypeOf or tstyche)
• your project does not ship type definitions

Facets

cli-tool · maturity active

testing type-system cli developer-tools developer-tools testing programming-languages cli cross-platform typescript type-definitions type-testing dts-files static-analysis nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tsdjs/tsd")