Home /Modules/wiki/Home.md

Home.md

wiki/Home.md · 177 line(s) · markdown

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 .sleela syntax 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

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/):

SubjectReferenceWhat it adds
MathMATH.mdfoundational numerical layer
PhysicsPHYSICS.mdconstants + mechanics, relativity, EM, gases, waves
EconomicsECONOMICS.mdtime-value, elasticity, rates, macro identities
ChemistryCHEMISTRY.mdcomposition, valence/bonds, symmetry, qualified inference
FinancialFINANCIAL.mdTVM, 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):

SubsystemFolderWhat it does
Website Generatorwebsite-generator/Build sites from a design (theme, palette, "energy" dial) + ordered signs (hero, feature, cta, …); JavaFX Website Studio under gui/.
AutoCAD Rendererautocad/Turn descriptions, dimensions, plans, and notes into an AutoCAD DXF drawing; JavaFX studio under gui/.
Codecscodecs/Individual codec plugins (C + C++) behind a Codec Loader / Manager that SLeeLa calls; native PCM/WAV, AIFF, G.711, pluggable backends for the rest.
Languageslanguages/Localize SLeeLa's outputs/prompts into 12 languages (incl. RTL Arabic), selected via settings.conf; lib/languages resolves the active locale.
Audio / Videoaudio/Synchronized native mixer with a JavaFX A/V GUI.

The Constitution

Ordained constraints the system honors (from SHEET.sheet invariants + NS-SST-0001 diagnostics):


Reference Index

DocTopic
README.mdproject overview
SLEELA.mdthe .sleela Wrapper™, Sigil QR, steganographic frame
COMPILER.md / SOURCE.md / VERSION.mdcompiler, source file, versions
NORDSHRIFT.md.sst driver + 2.0 semantic layer
SST.model / SST-2.0.modelNS-SST-0001 1.0 / 2.0 specs
impl/nordshrift/SST.NETWORK.md / SST.FINANCE.md / SST.SUBJECT.mdseries & subject specs
MATH/PHYSICS/ECONOMICS/CHEMISTRY/FINANCIAL.mdsubject libraries
SHEET.sheetobject catalog
GLOSSARY.mdterms (Part A science/engineering · Part B US evidentiary method)
SUMMARY.mdwhole-repo accounting
impl/README.md / impl/DESIGN.mdimplementation guide + architecture

This wiki mirrors the repository docs; the repo is authoritative. See Reference Index.