Sleela
Sleela is a Java-like programming language that runs on a Turing-complete, thread-friendly C/C++ execution core, with Nordshrift — a .sst transpiler driver (spec NS-SST-0001) — layered on top to drive a triplet of targets: Java, Sleela, and C.
A Sleela source file (.sleela) is a Wrapper™ — the program unit governed by the Sleela Language Metadocument (SL-META-0001).
Current versions: Sleelvac™ compiler (supported
.sleelasyntax 1.3 – 1.6, default 1.6) · Nordshrift 2.0 driver.
Quick start
cd impl && make
./build/sleela run examples/hello.sleela
./build/nordshrift build nordshrift/examples/demo/build.sst
make produces two binaries: build/sleela (compiler/runtime) and build/nordshrift (the .sst driver).
Wiki contents
- Language Reference — syntax, types, the
.sleelaWrapper™, conducted methods, native modules - Nordshrift Sheet Reference — every
.sstsection, the triplet, the component manifest, diagnostics - Writing a Subject — the 2.0 semantic subject model, end to end
Below is the map of the rest of the system.
The Sleela Language
Java-like: a program is one or more class declarations; execution begins at a main() method. Top-level statements are not allowed — everything lives inside a class.
class Hello {
void main() {
print("Hello, Sleela!");
}
}
./build/sleela run examples/hello.sleela # compile + run on the core
./build/sleela check examples/hello.sleela # parse/validate only
./build/sleela compile examples/hello.sleela -o hello.sleela # persistent Core artifact
Bundled examples: hello, fizzbuzz, factorial, fibonacci, conduct, threads, network_echo, chemistry_presumed, financial, versioned, bestof_route.
The language is a broad Java-like surface: classes, structs, T[] arrays, the full statement set (if/else, while, do/while, for, switch, try/catch/finally, break/continue, throw, assert, synchronized), short-circuit &&/||, ternary ?:, instanceof, and casts. run/compile accept multiple .sleela files merged into one program. See Language Reference, plus COMPILER.md, SOURCE.md, STRUCTS.md, VERSION.md.
The Execution Core
A Turing-complete C/C++ VM (impl/core/) with a tagged value model, threading, and networking. Sleela lowers to core opcodes; the sleela target compiles to a persistent, runnable .sleela Core artifact. Networking exposes LISTEN / ACCEPT / CONNECT / SOCKREAD / SOCKWRITE / SOCKCLOSE. The core can also ingest .xclass (SecureJDK 28 structural class metadata).
Nordshrift & the .sst Sheet
Nordshrift reads a .sst control sheet (indentation-significant, pragma-first) and drives transpilation to the selected triplet target. The .sst file is a build-control surface, not a program.
nordshrift check <sheet.sst> # validate; print diagnostics
nordshrift build <sheet.sst> # compile the sheet's sources to its target
nordshrift objects # list the SHEET.sheet object compatibility list
nordshrift relevance --target=c [Object]
nordshrift version
See Nordshrift Sheet Reference, plus NORDSHRIFT.md, SST.model (1.0), SST-2.0.model (2.0 normative).
Component Series: Network & Finance
An .sst sheet can declare two closed component series that become a build artifact (a component manifest — Java class / C arrays / Sleela class):
network:
objects: [ Endpoint, NIC, Link, Router, Gateway, LoadBalancer, Service, TLS, DNS ]
transports: [ tcp, tls, quic ]
address-family: dual
tls: true
finance:
objects: [ PresentValue, NetPresentValue, BondPrice, CAPM, WACC, Ratio ]
currency: USD
period: annual
discounting: discrete
Unknown members are rejected (NSS-E-NET-00x / NSS-E-FIN-00x). Every object also lives in SHEET.sheet. See SST.NETWORK.md, SST.FINANCE.md.
Semantic Subjects (Nordshrift 2.0)
The 2.0 layer makes the meaning of a computation explicit via subject: blocks, following the canonical chain:
Subject → Quantity → Unit → Assumption → Relation → Formula → Transformation → Result → ComparativeNorm → Evidence → Explanation → Validation
Evidence status is one of observed · specified · derived · modeled · inferred · assumed — so a number is not silently promoted to an observation. See Writing a Subject and SST.SUBJECT.md.
Subject Libraries
First-class domain layers above the core (impl/subjects/):
| Subject | Reference | What it adds |
|---|---|---|
| Math | MATH.md | foundational numerical layer |
| Physics | PHYSICS.md | constants + mechanics, relativity, EM, gases, waves |
| Economics | ECONOMICS.md | time-value, elasticity, rates, macro identities |
| Chemistry | CHEMISTRY.md | composition, valence/bonds, symmetry, qualified inference |
| Financial | FINANCIAL.md | TVM, NPV, bonds, CAPM, WACC, 2×2 systems, quadratics |
Math is foundational; the others may explicitly depend on it.
SHEET.sheet — the Object Catalog
SHEET.sheet is the machine-readable catalog of common system objects that backs both Sleela's conducted methods and Nordshrift's object-compatibility list. It carries 129 objects across 16 role categories, rooted at System (depth 3024). Nordshrift converts each object to a per-target relevance: direct · model · none. (The repo is authoritative — see README.md / SUMMARY.md.)
Application subsystems
Beyond the core toolchain, SLeeLa ships standalone application subsystems in which SLeeLa is authoritative and any GUI is a thin presentation layer (JavaFX presents; SLeeLa decides — see JavaFX.md):
| Subsystem | Folder | What it does |
|---|---|---|
| Website Generator | website-generator/ | Build sites from a design (theme, palette, "energy" dial) + ordered signs (hero, feature, cta, …); JavaFX Website Studio under gui/. |
| AutoCAD Renderer | autocad/ | Turn descriptions, dimensions, plans, and notes into an AutoCAD DXF drawing; JavaFX studio under gui/. |
| Codecs | codecs/ | Individual codec plugins (C + C++) behind a Codec Loader / Manager that SLeeLa calls; native PCM/WAV, AIFF, G.711, pluggable backends for the rest. |
| Languages | languages/ | Localize SLeeLa's outputs/prompts into 12 languages (incl. RTL Arabic), selected via settings.conf; lib/languages resolves the active locale. |
| Audio / Video | audio/ | Synchronized native mixer with a JavaFX A/V GUI. |
The Constitution
Ordained constraints the system honors (from SHEET.sheet invariants + NS-SST-0001 diagnostics):
- Article I — System invariants: depth ≤ 3024; up to 3024 congruent-linear systems; complexity degree ≤ 4 (
1direct,2mediated,3brokered,4federated);connect(n)permitted iffn ≤ 3024 AND degree ≤ 4. - Article II — Congrains: Invariant, Precondition, Postcondition, Constraint, Dependency, Coupling, Congruence, Contract.
- Article III — Limits: Bound, Quota, RateLimit, Timeout, Capacity, Threshold, DepthLimit, ComplexityDegree.
- Article IV — Health (system-health metrics) and Article V — IQ (system insight/quality — not psychometric).
Reference Index
| Doc | Topic |
|---|---|
README.md | project overview |
SLEELA.md | the .sleela Wrapper™, Sigil QR, steganographic frame |
COMPILER.md / SOURCE.md / VERSION.md | compiler, source file, versions |
NORDSHRIFT.md | .sst driver + 2.0 semantic layer |
SST.model / SST-2.0.model | NS-SST-0001 1.0 / 2.0 specs |
impl/nordshrift/SST.NETWORK.md / SST.FINANCE.md / SST.SUBJECT.md | series & subject specs |
MATH/PHYSICS/ECONOMICS/CHEMISTRY/FINANCIAL.md | subject libraries |
SHEET.sheet | object catalog |
GLOSSARY.md | terms (Part A science/engineering · Part B US evidentiary method) |
SUMMARY.md | whole-repo accounting |
impl/README.md / impl/DESIGN.md | implementation guide + architecture |
This wiki mirrors the repository docs; the repo is authoritative. See Reference Index.