SLeeLa 3.0 API — session additions
A focused index of the API-visible additions made in this working session,
documented against the SLeeLa 3.0 edition. The generated HTML surfaces
(sleeladoc-api/, docs/api/, api/sleela/3.0/version-014/) were regenerated
from the live /lib tree and now include every new source unit below; this page
also records the language-level additions that are specified in
SLEELA.syntax rather than as a /lib class, which the generator cannot infer.
1. Loop-timing annotations and the sleep built-in (language)
@loopDelay / @loopBudget pace a for / while / do loop, and sleep(ms)
blocks the current thread anywhere.
- Full reference:
LOOP_TIMING_API.md - Specification:
SLEELA.syntax§32 - Opcode:
OP_SLEEP(ISA index 157); source ISA recordSLISASleepinlib/vm/InstructionSet.sleela, rendered on the generatedvmpackage page. - Example:
examples/loop-timing-annotation-demo.sleela
2. Native big-integer multiply (OP_BIGMUL / SLBigInteger.multiply)
A native base-1e9 limb-array multiply bridged to the VM as OP_BIGMUL
(ISA index 156), with the larger SL_MAX_ARRAY_LEN ceiling (2^24) that lets a
multi-million-limb number fit in a single array.
- Source ISA record
SLISABigMulinlib/vm/InstructionSet.sleela(generatedvmpackage page). - Library surface:
SLBigInteger.multiplyinlib/math/SLBigInteger.sleela(generatedmathpackage page).
3. Standalone tools (repository top level, outside /lib)
These are complete programs/folders, not /lib library packages, so they are
documented by their own READMEs rather than the SleelaDoc package pages:
- Local Generator — scaffolds a local SLeeLa project from a blueprint:
local-generator/README.md. - Pi Generator — streams the digits of Pi to a file via a spigot:
pi-generator/README.md.
Generated API surfaces
All three HTML surfaces are produced from the same /lib inventory by
tools/generate-sleeladoc-api.py (make api-docs) and were rebuilt this
session:
| Surface | Entry point |
|---|---|
| Live SleelaDoc site | sleeladoc-api/index.html |
| Contributor site | docs/api/index.html |
| Immutable 3.0 snapshot | api/sleela/3.0/version-014/index.html |