docs: regenerate site from f094acfdb5

annot-computed.html

@@ -0,0 +1,46 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>@Computed — Ludic</title>
+<meta name="description" content="A derived field expanded inline wherever it is read, never stored.">
+<link rel="stylesheet" href="base.css">
+<link rel="stylesheet" href="docs.css">
+</head>
+<body>
+<header class="nav"><div class="wrap nav-in"><a class="brand" href="index.html"><span class="logo">L</span> Ludic</a><button class="nav-toggle" aria-label="Toggle menu" aria-expanded="false">☰</button><nav class="nav-links"><a href="index.html">Home</a><a href="api.html">API Reference</a><a class="nav-cta" href="https://git.workshopsoft.io/workshopsoft/ludic">Source ↗</a></nav></div></header>
+<main class="wrap item">
+  <div class="crumbs"><a href="api.html">API Reference</a> <span>›</span> <a href="api.html#annotations">Annotations</a> <span>›</span> <span class="here">@Computed</span></div>
+  <div class="item-head">
+    <span class="kind-badge kind-annotation">annotation</span>
+    <h1 id="top">@Computed</h1>
+  </div>
+  <code class="sig">@Computed on a property field</code>
+  <div class="desc"><p><code>@Computed</code> marks a property field as <b>derived</b>: instead of occupying a slot in the world, its expression is expanded inline at every site that reads it, so it is recomputed on demand and never takes storage. Use it for values that are a pure function of other fields — a total, a midpoint, a scaled amount — where storing them would risk going stale. Because a computed field has no backing storage it cannot be assigned to, and it is not something you replicate: it costs nothing on the wire and is simply recomputed on each peer. Reach for it when a value should always be consistent with its inputs and you would otherwise have to remember to recompute it by hand.</p></div>
+  
+  <div class="examples"><h2>Example</h2><pre data-lang="ludic">program DerivedStats {
+  property Health {
+    current: int = 100,
+    maximum: int = 100,
+    @Computed missing: int = maximum - current    # never stored; expanded where read
+  }
+  model Player { Health }
+
+  handler ReportDamage phase Update {
+    for (Health) in query [Health] {
+      Health.current = 70
+      print(Health.missing)                        # 30 — recomputed from current and maximum
+    }
+  }
+
+  handler SpawnPlayer phase Start {
+    spawn Player { Health { current: 100, maximum: 100 } }
+  }
+}</pre></div>
+  
+  <a class="back" href="api.html">← All symbols</a>
+</main>
+<script src="ludic-highlight.js"></script>
+<script>Ludic.highlightAll(); Ludic.installCards(); Ludic.flashTarget();</script>
+</body></html>