Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Crate Overview

Ling is written in Rust and split into a workspace of crates. The main crate, ling-lang, contains the compiler front end, the interpreter, the JIT driver and the ling command; the crates below supply the language pieces and the builtin libraries. You only need this page if you want to use these crates from your own Rust code, or to understand which crate backs which builtins.

The versions below are the ones in the repository at the time of writing. Most crates follow Ling’s 2030.x numbering; ling-http and ling-web have their own.

The main crate

CrateVersionWhat it is
ling-lang2030.1.53The language: lexer, parser, interpreter, Cranelift JIT and AOT, and the builtins. Library name ling; binaries ling, lingc, lx, ling-repl.
lingfu (crates/ling-fu)2030.1.19The project manager: lingfu new, run, build, normalize and more. See lingfu.

Compiler

CrateVersionWhat it is
ling-core2030.0.9Core types, errors and compiler infrastructure.
ling-lex2030.0.8Lexical analysis and polyglot tokenization.
ling-ast2030.0.8Abstract syntax tree types.
ling-polyglot2030.0.8The lexicon system for keywords and builtins in 16+ human languages.
ling-mir2030.0.12Mid-level intermediate representation for the code generators.
ling-codegen2030.0.13Code generation backends (bytecode, WASM, native).
ling-macro2030.0.8Procedural macros for the Ling ecosystem.
ling-runtime2030.0.8Runtime support: garbage collector, allocator, standard library.
ling-wasm2030.0.16The WebGL2 WebAssembly runtime used by ling build --platform web.

Graphics, UI and input

CrateVersionWhat it is
ling-graphics2030.0.133D/4D rendering, geometry, animation and font tools.
ling-gl2030.0.10GPU rasteriser for projected scenes (wgpu: Vulkan, Metal, DX12; WebGL2 on wasm).
ling-gpu2030.0.10GPU compute (CUDA via cudarc, with a CPU fallback).
ling-ui2030.0.9Retained-mode widgets and flex layout (ui_*).
ling-animation2030.0.8Anima, the unified animation system: one rig, any target.
ling-input2030.0.9Sensorium: gamepads, joysticks, haptics, motion, XR controllers, touch controls.
ling-paint2030.0.1LingAnime paint engine: layers, brushes, vectors, halftone, 2.5D rigs, pen tablets (art_*).
ling-icon2030.0.9Rasterizes SVG/PNG icons to multi-resolution .ico and embeds them in Windows executables (ling build --icon).

Games and physics

CrateVersionWhat it is
ling-game2030.1.9Game engine: ECS, physics and scene management.
ling-physics2030.1.18Physics, world generation, hyperbolic geometry, glTF loading.
ling-body2030.0.2Acoustic bodies: humanoid SDF scaffolds, FDTD wave solver, membranes, mesh and WAV codecs.
ling-emu2030.0.1Console-emulation host (emu_*): SNES and N64 cores.

Audio and music

CrateVersionWhat it is
ling-audio2030.0.134D positional audio synthesis and WAV background music.
ling-music2030.0.9Music decoding, BPM and key analysis, synthesis, rhythm-game and karaoke tools.
ling-mic2030.0.12Microphone input and real-time audio capture.
ling-daw2030.0.2DAW engine behind LingStationX: synth, drums, effects, mixer, sequencer.
ling-osdaw2030.0.2LingStation for LingOS: a no_std tracker sequencer and synthesizer.

Network, web and security

CrateVersionWhat it is
ling-http0.1.8HTTPS/JSON/SQLite framework on axum. Ling’s http_serve runs on it. See ling-http and ling-web.
ling-web0.1.9The Flask-style layer on ling-http: sessions, flash messages, templates, static files, blueprints, CSRF.
ling-net2030.0.9Async networking: HTTP, WebSocket, QUIC and peer-to-peer.
ling-crypto2030.1.13Post-quantum and classical cryptography: ML-KEM-768, hybrid KEM, AES-GCM, XChaCha20, BLAKE3, SHA-3, Argon2id, Shamir, Schnorr ZKP, VRF. no_std-capable.

AI

CrateVersionWhat it is
ling-ai2030.0.10Tensors, neural networks and LLM inference.
ling-llm2030.0.2A no_std GGUF inference engine for Qwen3 that runs on the CPU without an operating system (for LingOS).
ling-diffusion2030.0.1In-process Stable Diffusion (SD 1.x / SDXL) behind the sd_* builtins.

LingOS

CrateVersionWhat it is
ling-kernel2030.1.37Minimal kernel runtime: no_std CPU intrinsics, VGA, serial, boot.
ling-user2030.1.4Userland runtime for Ling programs on LingOS.

Bindings

CrateVersionWhat it is
ling-py2030.0.8Python bindings for ling-audio, ling-physics and ling-net.

Which profile pulls in which crate

The install profiles decide which of these crates are compiled into ling:

ProfileCrates
webling-http, ling-crypto, ling-icon, lingfu
privacyweb plus ling-net, ling-ui
gameling-physics, ling-gpu, ling-game, ling-animation, ling-input, ling-body, ling-ui, ling-icon
ailing-ai, ling-music
audioling-audio, ling-music, ling-mic, ling-daw
art (in full)ling-paint