Developer Documentation

Thu, 01 Oct 2026 22:30:00 +0000

Last verified against commit 109a89e (2026-06-26).

# 1. Executive Summary

Tyu is a concatenative, stack-based systems language and toolchain for embedded and simulation targets. This repository contains the compiler front end, semantic checker, IR, target-specific code generators, module packer/signing/encryption tools, loader/runtime support, and the tyu project driver that orchestrates build, run, test, and deploy workflows.

It solves a fairly specific problem: building small, verifiable system images from .mod sources, linking them with a target runtime, packaging them into .lmod containers, and then loading or executing them under a trust model that can range from fully trusted firmware to re-derived untrusted modules.

Glossary

Mon, 26 Oct 2026 21:09:46 +0000

This glossary defines the terms used by the tracked docs and the compiler/runtime code.

# Word

A Tyu word is a named stack transformer with declared inputs, outputs, and optional contracts. See crates/frontend/src/parse/decl.rs, crates/ir/src/lib.rs, and crates/semantics/src/types.rs for the code representation.

# Module

A .mod file is a compilation unit. A .def file is the interface record used for separate compilation. See crates/frontend/src/parse/mod.rs, crates/langc/src/iface.rs, and sysroot/Core.def.

Reference on The Tyu Programming Language

Developer Documentation

# 1. Executive Summary

Glossary

# Word

# Module