Seen Language Documentation

Seen is a self-hosted systems programming language with multi-language keywords, package support, region-oriented runtime APIs, and LLVM-powered compilation.

fun main() {
    let names = ["Alice", "Bob", "Charlie"]
    for name in names {
        println("Hello, {name}!")
    }
}

Key Features

• Self-hosted compiler -- the compiler is written in Seen and verified through staged bootstrap
• Multi-language keywords -- write code in English, Arabic, Spanish, Russian, Chinese, or Japanese
• LLVM backend -- native code generation, optimization, cross-target support, and package artifact linking
• Packages -- source registry packages plus local prebuilt artifacts with interface indexes
• Tooling -- built-in LSP, VS Code extension, C import generation, platform packaging helpers
• GPU/SIMD APIs -- stdlib and runtime surfaces for graphics, compute, and vectorized code paths

Documentation

Getting Started

• Getting Started -- installation, first program, project setup
• Language Guide -- complete syntax and semantics reference
• CLI Reference -- every command and flag

Core Concepts

• Memory Model -- regions, ownership, borrowing, defer
• Concurrency -- async/await, parallel_for, sync primitives
• Metaprogramming -- comptime, decorators, derive macros, reflection

Specialized Topics

• SIMD and GPU -- vector types and GPU compute shaders
• Multi-Language Support -- keyword translations and adding languages
• FFI -- C interop, extern functions, linking
• Tooling -- VS Code extension, LSP, formatting, debugging
• Compilation Targets -- native and cross-target names, triples, RISC-V/QEMU verification

Project & Build

• Project Configuration -- Seen.toml format and project structure
• Packaging -- static registry layout, publishing, and hosting
• Compiler Architecture -- frontend, codegen, backend, and bootstrap internals
• Bootstrap System -- self-hosting verification and safe rebuilds
• Known Limitations -- current bugs and workarounds

API Reference

• API Reference Index -- standard library and runtime overview
• Core Types -- Option, Result, Unit, Ordering
• Strings -- String, StringBuilder
• Collections -- Array, Vec, HashMap, BTreeMap, etc.
• Math -- math functions and constants
• I/O -- File, stdin/stdout, reading and writing
• Process -- Command execution, environment
• Synchronization -- Mutex, RwLock, Channel, AtomicInt
• Random -- random number generators
• Bitfield -- bit manipulation types
• Binary -- serialization and compression
• JSON -- JSON derive and parsing
• Reflection -- runtime type information
• GPU -- GPU types and runtime functions
• Full Module Index -- every seen_std/src module family