Reference · quantities

Exact values without invented equivalence.

Decimals are JSON strings. Ratios preserve authored parts. Percentages store percentage points. Unit conversion is explicit and bounded.

Quantity shapes

{ "kind": "measured", "value": "250", "unit": "g" }

{ "kind": "range", "minimum": "20", "maximum": "25", "unit": "Cel" }

{ "kind": "open", "qualifier": "to_taste" }

{ "kind": "measured", "value": "1.5", "unit": "kg" }

Ratios are not decimals

{
  "id": "starter-feed",
  "kind": "ratio",
  "terms": [
    { "input": { "kind": "ingredient", "id": "starter" }, "parts": "1" },
    { "input": { "kind": "ingredient", "id": "flour" }, "parts": "2" },
    { "input": { "kind": "ingredient", "id": "water" }, "parts": "2" }
  ],
  "target": { "kind": "measured", "value": "500", "unit": "g" }
}

Conversion boundary

• Compatible same-dimension UCUM conversions use exact rational arithmetic.
• Temperature conversion is supported.
• Bare regional units such as cup refuse as ambiguous.
• Mass-to-volume conversion refuses without an explicit future physical profile.
• No operation assumes 1 g = 1 mL.