How labpics-team/lab-colors works
Lab Colors is a color-contract compiler and runtime: an application declares a physical color graph and constraints, then the runtime evaluates it against observed conditions and returns allowed outputs. The main path is the JavaScript package’s compile/update/read workflow, backed by Rust/WASM; a Rust evaluation CLI is an alternate entry point. Core internals cover graph compilation, color-space and constraint evaluation, and revision-bound observations. The README documents the public workflow; internal links below rely on sampled references, so unsampled wiring is omitted.
Main entry points: program_session.rs Program evaluation · program.rs Program compiler · index.js JS package API · lib.rs WASM API
Components 21
Client interfaces
- JS package API
packages/colors/index.js - Program wire ABI
packages/colors/program-wire/abi-v1.js - WASM API
crates/labcolors-wasm/src/lib.rs - Evaluation CLI
crates/labcolors-evaluate-cli/src/app.rs - Transport CLI
crates/labcolors-transport-cli/src/app.rs - Transport envelopes
crates/labcolors-core/src/certificate.rs
Program runtime
- Program compiler
crates/labcolors-core/src/program.rs - Program evaluation
crates/labcolors-core/src/program_session.rs - Output attachment
crates/labcolors-core/src/program/attachment.rs - Certificates
crates/labcolors-core/src/certificate.rs
Color evaluation
- Color composition
crates/labcolors-core/src/composition.rs - Render graph
crates/labcolors-core/src/appearance.rs - Constraint evaluation
crates/labcolors-core/src/constraints/mod.rs - WCAG 2.2
crates/labcolors-core/src/wcag22.rs - Color-space math
crates/labcolors-core/src/lcs_occurrence.rs - Color families
crates/labcolors-core/src/family.rs - Family artifacts
crates/labcolors-core/src/family_artifact.rs
Observation lifecycle
- Observation admission
crates/labcolors-core/src/observation.rs - Session lifecycle
crates/labcolors-core/src/session.rs - Field effects
crates/labcolors-core/src/field_effect.rs
Other components
- Application
Connections 25
- Application → JS package API: declares program
README.md - JS package API → Program wire ABI: encodes wire
- JS package API → WASM API: calls runtime
README.md - Application → Evaluation CLI: submits request
README.md - Application → Transport CLI: inspects envelope
README.md - WASM API → Program compiler: compiles program
- WASM API → Program evaluation: updates observations
- Evaluation CLI → Program evaluation: evaluates request
- Program evaluation → Program compiler: uses compiler model
crates/labcolors-core/src/program_session.rs - Program compiler → Render graph: uses render graph
crates/labcolors-core/src/program.rs - Program compiler → Color composition: uses composition
crates/labcolors-core/src/program.rs - Program compiler → Constraint evaluation: uses evaluators
crates/labcolors-core/src/program.rs - Program evaluation → Constraint evaluation: assesses constraints
crates/labcolors-core/src/program_session.rs - Program evaluation → WCAG 2.2: evaluates WCAG
crates/labcolors-core/src/program_session.rs - Program evaluation → Color families: checks family
crates/labcolors-core/src/program_session.rs - Program evaluation → Family artifacts: loads artifacts
crates/labcolors-core/src/program_session.rs - Program evaluation → Color-space math: derives occurrences
crates/labcolors-core/src/program_session.rs - Program evaluation → Session lifecycle: runs session
crates/labcolors-core/src/program_session.rs - Session lifecycle → Observation admission: admits updates
crates/labcolors-core/src/session.rs - Program evaluation → Observation admission: binds observations
crates/labcolors-core/src/program_session.rs - Program evaluation → Field effects: evaluates effects
crates/labcolors-core/src/program_session.rs - Program evaluation → Output attachment: attaches outputs
crates/labcolors-core/src/program_session.rs - Output attachment → Session lifecycle: owns lifecycle
crates/labcolors-core/src/program/attachment.rs - Program evaluation → Certificates: produces evidence
- Transport CLI → Transport envelopes: parses envelopes
crates/labcolors-transport-cli/src/app.rs