Idƴl Documentation

⟡ Idƴl — Documentation

Welcome to the Idƴl language documentation.

Idƴl is a functional, time-aware language for scheduling, composition, and reactive behavior. These pages walk through every feature of the language, from first install to the internals of the engine.

Table of contents

Getting started

  1. Installation & first run — build from source, run a file, CLI options

Language guide

  1. Language fundamentals — comments, types, constants, time literals
  2. Functions — pure functions, parameters, defaults, composition
  3. Time & temporal functions — lambda blocks, dt, triggers, state, the |> operator
  4. Flows — sequences, generators, multi-member flows, access patterns
  5. Control flow & operators — ternary selection, arithmetic, comparison, bitwise
  6. Emit & catch — side-channel output, the :: accessor, event handling
  7. Clock & tempo — clock hierarchy, tempo propagation, bpm literal
  8. Process blocks — entry points, naming, duration, listen mode

Integration

  1. Modules & libraries — OSC, module(), import(), namespaces

Internals

  1. Architecture & engine — pipeline, semantic analysis, evaluator, scheduler

Building the HTML version

A build script is provided to convert this documentation to a set of linked HTML pages. It requires Pandoc (≥ 2.11).

cd doc/
./build_html.sh          # generates html/ directory
open html/index.html     # or xdg-open on Linux

See build_html.sh for details.

Version

This documentation covers Idƴl pre-alpha v0.2 (April 2026).