tsdoc

Monorepo for TSDoc extraction and Nuxt consumption of @kagal/* package API documentation.

Packages

Package	Description
@kagal/build-tsdoc	Build-hook adapter for @microsoft/api-extractor. Each entry's rolled declarations get a <entry>.api.json written next to them.
@kagal/nuxt-tsdoc	Nuxt module that consumes *.api.json manifests produced by @kagal/build-tsdoc.

The two packages form a pipeline: @kagal/build-tsdoc extracts documentation at package build time and ships dist/<entry>.api.json alongside the bundle; @kagal/nuxt-tsdoc is the Nuxt consumer for those manifests.

Origin

@kagal/build-tsdoc was extracted from the kagal-dev/pki monorepo so it can be paired with its Nuxt consumer and evolve independently of the PKI codebase.

Common commands

pnpm install
pnpm build              # Build all packages
pnpm clean              # Remove dist/ and node_modules
pnpm dev:prepare        # Stub all packages (unbuild --stub)
pnpm test               # Test all packages
pnpm lint               # Lint all (root + packages)
pnpm type-check         # Type-check root tools + packages
pnpm precommit          # dev:prepare → lint → type-check → build → test
pnpm prepack            # lint:root:check → per-package prepack

Per-package commands via --filter:

pnpm --filter @kagal/build-tsdoc build
pnpm --filter @kagal/build-tsdoc test

Licence

MIT