HQL Docs
HQL is a Lisp-shaped language that compiles to JavaScript and TypeScript. Start with the guide, then use the workflow and reference pages as you build real projects.
Reading Paths
| Goal | Read |
|---|---|
| Learn the language | Guide |
| Look up syntax and semantics | Language |
| Run or compile code | CLI |
| Publish or consume packages | Packages |
| Use HQL in browsers, web apps, or mobile apps | Browser, Web, And Mobile |
| Call JavaScript and TypeScript | JavaScript Interop |
| Use checked pure/effectful code | Pure Mode |
| Look up functions | Stdlib |
| Understand diagnostics | Errors |
Short Path
echo '(print "Hello, HQL")' > hello.hql
hql run hello.hql
Then read Guide and keep Stdlib open as a reference.
Source Authority
- Syntax and semantics:
hql/docs/hql/LANGUAGE.mdplus feature specs. - Stdlib reference: generated from
src/hql/lib/stdlib/stdlib.hql,packages/*/mod.hql, and verified examples. - CLI behavior:
hql/src/hql/cli.ts, checked against public docs.