DBYTE 12.0 CANONICAL MANUAL
CURRENT PACKAGE IS 12.2.1 PACKAGING CORRECTION; SEMANTIC CONTRACTS REMAIN 12.2.0 MODERN NATIVE FOUNDATION. THIS PAGE REMAINS THE 12.0 CANONICAL BASE CONTRACT.
AUTHORITY v12.0.0 TAGGED CONTRACT PIPELINE AST -> CANONICAL HIR -> MONO -> PROFILE -> BACKEND LANGUAGE GENERICS / ENUMS / OWNERSHIP / VIEWS / CLOSURES / DEFER HOSTED TREE + BYTECODE VM NATIVE i686 ELF32 OBJECTS / ARCHIVES / LINKER INTEROP i686 CDECL SUBSET SYSTEMS KERNEL + USER PROFILES DEFERRED OWNED STRING / ARRAY / DROP / COLLECTIONS / X86_64 APPS
00 canonical law§
- Parsing is shared; canonical project analysis owns meaning.
- HIR records resolved identity, types, places, ownership actions, layouts and call conventions.
- Monomorphization produces closed concrete HIR before a backend runs.
- Profile validation rejects unavailable capabilities but does not reinterpret valid language semantics.
- Backends adapt representations; they do not resolve names or type-check v12 syntax again.
- Website prose links back to tagged mirrors and executable fixtures; it is not a new specification.
10 start here§
10INSTALL — exact archive identity, extraction, PATH setup and smoke checks.11FIRST PROGRAM — one source executed by tree and VM.12BUILD · RUN · TEST — hosted and native commands plus failure semantics.13RELEASE 12.0.0 — artifact, feature, target and evidence boundary.
20 language semantics§
| Topic | Read for | Representation · rule |
|---|---|---|
| TYPES | Canonical identities and target layout. | Fixed integers, usize, pointers, views, aggregates, enums and callables. |
| FUNCTIONS | Resolved direct/indirect calls. | DByte or C convention recorded in HIR. |
| GENERICS | Symbolic body checks and specialization. | GenericDefId + TypeId list; no runtime dictionary. |
| STRUCTS | Named construction and field identity. | Declaration-order target layout. |
| ENUMS | Payload construction and ABI. | u32 tag plus aligned payload. |
| MATCH | Exhaustiveness and move/borrow modes. | Resolved arms and unreachable default edge. |
| RESULT + ? | Single evaluation and propagation. | Exact Err TypeId plus cleanup path. |
| OWNERSHIP | Copy, move and illegal reuse. | Action annotation on every value use. |
| BORROWING | Lexical aliases and return provenance. | Shared immutable or exclusive mutable. |
| SLICES | Borrowed indexed views. | Two-word non-null pointer + length. |
| STRINGVIEW | Borrowed UTF-8 storage. | const byte pointer + byte length. |
| FUNCTION VALUES | Indirect calls and coercion. | Checked callable shape and convention. |
| CLOSURES | Explicit captures. | Concrete source-order environment. |
| DEFER | Cleanup on every lexical exit. | Explicit LIFO HIR edges. |
| POINTERS | Mutability, arithmetic and dereference. | ptr[T] · const_ptr[T], usize casts only. |
| C ABI | i686 cdecl calls and callbacks. | Scalar ABI plus pointers to repr(C) aggregates. |
30 toolchain manual§
30CLI — command ownership and target/emit combinations.31ELF OBJECTS — ET_REL sections, symbols, metadata and relocations.32STATIC ARCHIVES — canonical Unix ar and fixed-point extraction.33LINKER — symbol resolution, REL addends and entry synthesis.34INSPECT — HIR/layout and binary structure views.35TARGETS — hosted, VM, freestanding/kernel and user capability gates.
40 systems path§
40DBYTE32 — legacy scalar ABI plus additive aggregate rules.41LAYOUTS — normal, repr(C), packed, array and compile-time queries.42INTRINSICS — bounded privileged instruction surface.43INTERRUPTS — classes, frame layouts, stubs and IRETD.44BARE METAL — source-to-object-to-link-to-QEMU path.45USER PROCESS — Ring3/TSS/private CR3/syscall/fault containment.46DBYTEOS — frozen machine-ownership lineage.
50 implementation internals§
50EXECUTABLE HIR — project-level resolved functions, blocks, expressions and places.51MONOMORPHIZATION — roots, worklist, recursion and specialization symbols.52TARGET LAYOUT — explicit pointer/usize and aggregate decisions.53ELF · ARCHIVE WRITERS — bounded deterministic serialization.54LINKER INTERNALS — metadata cross-validation and final image construction.
60 hard reference§
60GRAMMAR61TYPE + LAYOUT RULES62ENUM ABI63DIAGNOSTICS64TARGET MATRIX65FULL TAGGED LANGUAGE CONTRACT66FULL NATIVE COMPILER CONTRACT67FULL NATIVE LINK CONTRACT68FULL RELEASE README
F0 evidence discipline§
SEMANTICS CANONICAL HIR SNAPSHOT + PARITY CORPUS ARTIFACT SHA256 + ELF/ar PARSE + OBJDUMP ABI DISASSEMBLY + CROSS-CALL EXECUTION NATIVE QEMU SERIAL + INTERRUPT/FAULT TRACE STORAGE GUEST WRITES + INDEPENDENT HOST PARSER BOUNDARY NEGATIVE PROFILE TESTS + FORBIDDEN TOKEN GATES DELIVERY SOURCE MIRROR HASH + FIXTURE INJECTION + ZERO JS
70 developer surfaces§
70PLATFORM STATUS — current Windows host distribution, Linux and macOS nonclaims, host-vs-target law.71API + STDLIB CATALOG — one landing map for language, hosted compatibility and systems APIs.72REPRODUCE PROOFS — release verifier, machine-proof classes and evidence-record format.73POST-V12 ROADMAP — v12.1 runtime, v12.2 collections, historical v12.3 modern-native plan (superseded by v12.2); future only.
FF next read§
For the complete hosted-to-machine history, continue to DBYTE ROOT MAP. For artifact identity and the precise release boundary, continue to DBYTE 12.0.0 RELEASE.