v0.1.0-draft • Open Specification

Configuration woven for humans, compiled cleanly to JSON.

Loom (.loom) eliminates YAML's implicit type traps and TOML's deep-nesting boilerplate. Write strict, comment-rich configs with lightweight @tag types and deterministic @import composition.

$ loom build service.loom -o service.json
# Typed, composable application configuration
@schema "./schemas/service.schema.json"
@import "./defaults/http.loom" as http

service: {
  ...http.server
  name: "billing-gateway"
  port: 8443
  tls_enabled: true
  read_timeout: @dur "15s"
  deployed_at: @instant "2026-11-17T21:00:00Z"
}

routes: [
  { path: "/v1/invoices", rate_limit: 120 }
  { path: "/v1/webhooks", rate_limit: 600 }
]
{
  "service": {
    "host": "0.0.0.0",
    "name": "billing-gateway",
    "port": 8443,
    "tls_enabled": true,
    "read_timeout": "15s",
    "deployed_at": "2026-11-17T21:00:00Z"
  },
  "routes": [
    { "path": "/v1/invoices", "rate_limit": 120 },
    { "path": "/v1/webhooks", "rate_limit": 600 }
  ]
}

Engineered to fix everyday config friction

Designed from first principles for application settings, CLI tools, and deterministic DevOps manifests.

{}

100% JSON-Isomorphic

Every .loom file evaluates to standard JSON objects, arrays, strings, numbers, booleans, and null—zero custom runtime required downstream.

@

Lightweight Type Tags

Annotate durations (@dur "15s"), dates (@date), instants (@instant), and regexes without breaking JSON round-trip compatibility.

...

Bounded Composition

Share presets via relative @import and shallow ...spread overrides without Turing-complete loops, side effects, or network fetches.

#

Lossless CST Edits

A Concrete Syntax Tree (CST) preserves comments, blank lines, and key ordering during both loom fmt and automated CLI mutations.

""

Zero Coercion Surprises

Strings always require quotes. Unquoted no, on, or 3.10 will never silently morph into booleans or truncated floats.

✓

JSON Schema Native

Link any standard JSON Schema with @schema for instant IDE autocomplete, hover docs, and CI validation out of the box.

How Loom compares

Ergonomic authoring without sacrificing strictness or ecosystem compatibility.

Capability Loom (.loom) JSON YAML TOML
Comments (# & /* */) Yes (preserved in CST) No Yes (# only) Yes (# only)
Implicit type coercion traps None (syntax-typed) None Yes (no, on, octal) None
Deeply nested arrays & objects Clean braced blocks Clean Indentation-fragile Verbose [[a.b.c]]
Modular reuse (@import / spread) Built-in & acyclic No Anchors only (same file) No
Domain types (@dur, @instant) JSON-safe tags Plain strings only Implicit timestamps Native dates (non-JSON)