Packages
ts-capture is a pnpm monorepo. Most users install @ts-capture/ plus one
integration package matching their stack.
| Package | Use when… | How-to |
|---|---|---|
@ts-capture/ |
You want the engine + CLI (always required) | — |
@ts-capture/ |
You use Vite or Vitest | Use with Vite/Vitest |
@ts-capture/ |
You use SvelteKit or standalone Svelte 5 with Vitest | Use with Svelte |
@ts-capture/ |
Your test runner uses Babel (Jest, Vite-with-Babel, webpack) | Use with Jest (Babel) |
@ts-capture/ |
You bundle with esbuild / tsup | — |
@ts-capture/ |
Zero build-config collection — NODE_OPTIONS='--require @ts-capture/ |
— |
@ts-capture/ |
Your coding agent supports SKILL.-based skills |
— |
How the pieces fit #
coreis the engine: the instrumenter, the type collector/merger, the applier, and thets-captureCLI (CLI reference).- The integration packages (
vite,svelte,babel-plugin,esbuild) exist only to instrument your code inside the build tool you already run, and to supply the runtime collector. They all feed the samecoremerge/apply steps. core/(and the Jest-targetedpreload core/) install the runtime collector without a bundler.setup core/is the engine without Node, for a page that runs it itself:browser instrumentSource,createObserverandapplyInMemory, which applies against a project read through ats.you supply, behind the same type-check gate as the CLI, andSystem typesFromValues. It is experimental and may change in any 0.x release.
Each integration package's README has stack-specific detail; the how-to guides above are the task-focused entry points.
What's supported #
| First-class (CI) | Best-effort | |
|---|---|---|
| Node | 20+ | <20 |
| OS | Linux, macOS | Windows |
| JS-runtime | Node | Bun, Deno |
| Test-runner | Vitest, Jest | Mocha, Tap, AVA |
Versions #
The packages are on npm as 0.x, and the API may change between minor versions. There is no 1.0, and none is scheduled: the version stays below 1.0 until code, API, test coverage and documentation meet a quality bar that respects the first impression. Hobby/research project; best-effort maintenance.