pnpm install
pnpm build # required before typecheck (cross-package dependencies)
pnpm typecheck
pnpm test
pnpm lintpackages/core— framework-agnostic HTTP client (zero deps)packages/visualizer-core— vanilla JS viewers (Cosmograph 2D + 3D)packages/react,packages/svelte— framework bindings (peer-deps only)tests/— vitest suites (usenodeenvironment)skill/SKILL.md— canonical AI-agent integration file
- Open an issue describing the change before sending a PR (especially for new public API).
- All four commands above must pass.
- Use Conventional Commits (
feat:,fix:,docs:,chore:). - Update
CHANGELOG.mdunder the unreleased section. - Add tests for new behavior. Pure-function tests live in
tests/visualizer.test.ts; HTTP behavior tests live intests/http.test.tsand usevi.stubGlobal("fetch", ...).
Maintainers only. Update version across all packages/*/package.json to match, tag vX.Y.Z, push tag.