a reactive (signals based) hypermedia web framework (wip) stormlightlabs.github.io/volt
hypermedia frontend signals
README.md

Volt Developer CLI #

Development tools for the Volt.js project. Uses:

  • commander for command-line parsing
  • chalk for colored output
  • TypeScript Compiler API for parsing source files

Installation #

From the project root:

pnpm install

The volt command will be available after installation.

Commands #

volt docs #

Generates API documentation from TypeScript source files.

  • Scans all .ts files in src/
  • Extracts JSDoc comments and type signatures
  • Outputs markdown files to docs/api/
  • Supports @example tags in JSDoc

Generated documentation includes:

  • Function signatures and descriptions
  • Interface definitions and members
  • Type aliases
  • Code examples from @example tags

volt stats #

Displays lines of code statistics.

  • Default: counts code in src/ only
  • Excludes JSDoc comments, single-line comments, and empty lines
  • Use --full to include test files

Outputs:

  • Total files
  • Total lines (including comments)
  • Code lines (excluding docs/comments)
  • Documentation/comment lines

Development #

Build #

pnpm build

Compiles TypeScript to dist/ using tsdown.

Test #

pnpm test           # Watch mode
pnpm test:run       # Single run

Type Check #

pnpm typecheck