docs(api): per-symbol pages, fuzzy search, deep token linking, hover cards

Rebuild the API Reference around one page per symbol and richer, verified content.

Pages & navigation
- One HTML page per symbol (kw-*, type-*, phase-*, screen-*, fn-*, annot-*, op-*)
  instead of a single scrolling page; namespace overview pages (ns-screen …
  ns-color) and a searchable index (api.html) with client-side fuzzy search.
- Sticky-header scroll offset (scroll-margin) so a jumped-to entry/param/color is
  never hidden, plus a flash highlight on the scrolled-to target.

Deep linking in every snippet & example
- Namespace members split: `Screen`→namespace page, `fill_rectangle`→method page;
  `Color`→palette page, `Charcoal`→its swatch — separately.
- Named arguments (`width:`) link to that parameter's anchor on the method page.
- Hover any token for a summary card built from the real API data (symbols.json).

Content & coverage
- Full authoritative surface documented from the compiler: every keyword, type,
  the 6 phases (Start/Input/FixedUpdate/Update/LateUpdate/Render, each its own
  page), all 22 annotations, namespace methods with parameter docs, builtins,
  the world_* reflection ABI, networking, operators — 155 symbols.
- Longer, clearer explanations; "model"/"model instance" terminology, not "entity";
  descriptive identifiers in every example (Position{column,row}, Velocity{delta_x,
  delta_y}, Health{current,maximum}, Player/Enemy) — no Pos/Seg/x/dx.
- Accuracy fixes from compiler ground-truth: world_count() takes no arg,
  world_query_next(property, cursor) arg order, event fields bind by name; dropped
  `when` and `module` (not in the self-hosted parser).

Tooling
- inventory.json + check.py: coverage guard (every symbol has a page), duplicate-
  token guard, and broken-link guard — fail CI so docs can't drift.
- validate.py: compiles every ```ludic example against bin/ludicc (158 compile).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

tools/docgen/assets/item.css

@@ -0,0 +1,139 @@
+  :root{
+    --bg:#0a0d18; --bg2:#0d1122; --panel:#12172b; --panel2:#151b32;
+    --line:#232b47; --line2:#2c3660; --text:#c9d2ea; --head:#f2f5ff; --muted:#8290b4;
+    --mint:#7cf5c4; --coral:#ff5d73; --violet:#c792ea; --blue:#82aaff; --amber:#f6c177;
+    --c-bg:#0b0f20; --c-comment:#5b6788; --c-key:#ff7eb6; --c-type:#7cf5c4;
+    --c-str:#f6c177; --c-num:#a6b8ff; --c-annot:#c792ea; --c-fn:#82aaff; --c-punc:#9aa6cc; --c-arg:#f6c177;
+    --radius:14px; --max:900px; --hdr:64px;
+  }
+  *{box-sizing:border-box}
+  html{scroll-behavior:smooth}
+  body{margin:0;background:
+      radial-gradient(1100px 600px at 82% -8%, rgba(124,245,196,.07), transparent 60%),
+      var(--bg);color:var(--text);
+    font-family:"Space Grotesk",system-ui,-apple-system,Segoe UI,Roboto,sans-serif;line-height:1.65;-webkit-font-smoothing:antialiased}
+  a{color:inherit;text-decoration:none}
+  code,pre,.mono{font-family:"JetBrains Mono",ui-monospace,SFMono-Regular,Menlo,monospace}
+  .wrap{max-width:var(--max);margin:0 auto;padding:0 24px}
+
+  header.nav{position:sticky;top:0;z-index:50;backdrop-filter:blur(10px);
+    background:rgba(10,13,24,.82);border-bottom:1px solid var(--line);height:var(--hdr)}
+  .nav-in{display:flex;align-items:center;gap:22px;height:var(--hdr)}
+  .brand{display:flex;align-items:center;gap:10px;font-weight:700;color:var(--head);font-size:18px}
+  .logo{width:26px;height:26px;border-radius:7px;display:grid;place-items:center;
+    background:linear-gradient(135deg,var(--mint),#3fd7a6);color:#06231a;font-weight:700;font-size:15px}
+  .nav-links{display:flex;gap:22px;margin-left:auto;align-items:center}
+  .nav-links a{color:var(--muted);font-size:14.5px;font-weight:500}
+  .nav-links a:hover{color:var(--head)}
+  .nav-cta{border:1px solid var(--line2);padding:8px 15px;border-radius:9px;color:var(--head)!important;background:var(--panel)}
+  .nav-cta:hover{border-color:var(--mint)}
+  @media(max-width:760px){.nav-links a:not(.nav-cta){display:none}}
+
+  /* code token colors + snippet links */
+  pre{margin:12px 0 0;padding:16px 18px;overflow:auto;font-size:13.5px;line-height:1.72;tab-size:2;
+    background:var(--c-bg);border:1px solid var(--line);border-radius:12px}
+  pre::-webkit-scrollbar{height:8px}
+  pre::-webkit-scrollbar-thumb{background:var(--line2);border-radius:6px}
+  .t-com{color:var(--c-comment);font-style:italic}
+  .t-key{color:var(--c-key)}.t-type{color:var(--c-type)}.t-str{color:var(--c-str)}
+  .t-num{color:var(--c-num)}.t-annot{color:var(--c-annot)}.t-fn{color:var(--c-fn)}
+  .t-punc{color:var(--c-punc)}.t-arg{color:var(--c-arg)}
+  a.tok{border-radius:3px;transition:background .12s,outline-color .12s}
+  a.tok:hover{background:rgba(124,245,196,.15);outline:1px solid rgba(124,245,196,.4)}
+
+  /* ---- item page ---- */
+  main.item{padding:30px 24px 90px;max-width:var(--max)}
+  .crumbs{font-size:13px;color:var(--muted);margin-bottom:20px}
+  .crumbs a:hover{color:var(--mint)}
+  .crumbs span{opacity:.6;margin:0 2px}
+  .crumbs .here{color:var(--text);opacity:1}
+  .item-head{display:flex;align-items:center;gap:12px;flex-wrap:wrap;scroll-margin-top:calc(var(--hdr) + 20px)}
+  .item-head h1{margin:0;font-size:clamp(26px,4vw,38px);color:var(--head);letter-spacing:-.5px;
+    font-family:"JetBrains Mono",monospace;font-weight:700}
+  .kind-badge{font-size:11px;font-weight:600;letter-spacing:1px;text-transform:uppercase;
+    padding:4px 9px;border-radius:7px;border:1px solid var(--line2);color:var(--muted);background:var(--panel)}
+  .kind-keyword{color:var(--c-key);border-color:rgba(255,126,182,.4)}
+  .kind-type{color:var(--c-type);border-color:rgba(124,245,196,.4)}
+  .kind-phase{color:var(--blue);border-color:rgba(130,170,255,.4)}
+  .kind-method,.kind-builtin{color:var(--c-fn);border-color:rgba(130,170,255,.4)}
+  .kind-annotation{color:var(--c-annot);border-color:rgba(199,146,234,.4)}
+  .kind-namespace{color:var(--amber);border-color:rgba(246,193,119,.4)}
+  .kind-operator{color:var(--muted)}
+  .sig{display:inline-block;margin:18px 0 4px;color:var(--c-fn);background:var(--c-bg);
+    border:1px solid var(--line);border-radius:9px;padding:9px 13px;font-size:14px}
+  .desc{margin-top:14px}
+  .desc p{margin:0 0 12px;font-size:16px;color:var(--text);max-width:720px}
+  .desc code{color:var(--amber);background:var(--panel);padding:1px 5px;border-radius:5px;font-size:13px}
+  .desc b{color:var(--head)}
+
+  .params,.examples,.related{margin-top:30px}
+  .params h2,.examples h2,.related h2{font-size:15px;text-transform:uppercase;letter-spacing:1.5px;
+    color:var(--muted);font-weight:600;margin:0 0 12px}
+  .param{display:flex;gap:14px;align-items:baseline;padding:10px 12px;border:1px solid var(--line);
+    border-radius:10px;background:var(--panel);margin-bottom:8px;scroll-margin-top:calc(var(--hdr) + 20px)}
+  .param .pname{color:var(--c-arg);font-size:13.5px;min-width:110px;flex:none}
+  .param .pdesc{color:var(--text);font-size:14.5px}
+  .param code{color:var(--amber);background:var(--c-bg);padding:1px 5px;border-radius:5px;font-size:12.5px}
+  .rel-row{display:flex;flex-wrap:wrap;gap:10px}
+  a.rel{font-family:"JetBrains Mono",monospace;font-size:13px;color:var(--text);background:var(--panel);
+    border:1px solid var(--line);border-radius:9px;padding:7px 12px}
+  a.rel:hover{border-color:var(--mint);color:var(--mint)}
+  a.back{display:inline-block;margin-top:34px;color:var(--muted);font-size:14px}
+  a.back:hover{color:var(--mint)}
+
+  /* namespace overview */
+  .ns-blurb{color:var(--muted);font-size:16px;max-width:720px;margin:14px 0 22px}
+  .ns-blurb code{color:var(--mint);background:rgba(124,245,196,.08);padding:1px 5px;border-radius:5px;font-size:13px}
+  .ns-methods{display:flex;flex-direction:column;gap:8px}
+  a.ns-method{display:flex;flex-direction:column;gap:4px;padding:12px 14px;border:1px solid var(--line);
+    border-radius:11px;background:var(--panel);transition:border-color .14s,transform .14s}
+  a.ns-method:hover{border-color:var(--mint);transform:translateX(2px)}
+  .nm-sig{color:var(--c-fn);font-size:13.5px}
+  .nm-tip{color:var(--muted);font-size:13.5px}
+
+  /* swatches (Color page) */
+  .swatch-group{margin-bottom:22px}
+  .swatch-group h3{margin:0 0 12px;font-size:13px;letter-spacing:1.5px;text-transform:uppercase;color:var(--muted)}
+  .swatch-row{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:10px}
+  .swatch{display:flex;align-items:center;gap:10px;background:var(--panel);border:1px solid var(--line);
+    border-radius:9px;padding:8px 10px;scroll-margin-top:calc(var(--hdr) + 20px)}
+  .chip{width:24px;height:24px;border-radius:6px;flex:none;box-shadow:inset 0 0 0 1px rgba(255,255,255,.12)}
+  .cname{font-family:"JetBrains Mono",monospace;font-size:12px;color:var(--head);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .chex{margin-left:auto;font-family:"JetBrains Mono",monospace;font-size:11px;color:var(--muted)}
+
+  /* ---- api index + search ---- */
+  main.ref{padding:34px 24px 90px}
+  .ref-intro{margin-bottom:30px}
+  .ref-intro .kicker{font-size:13px;font-weight:600;letter-spacing:2px;text-transform:uppercase;color:var(--mint);margin-bottom:12px}
+  .ref-intro h1{font-size:clamp(30px,5vw,46px);margin:0 0 12px;color:var(--head);letter-spacing:-1px}
+  .ref-intro p{font-size:16px;color:var(--muted);max-width:720px;margin:0 0 20px}
+  .search{width:100%;max-width:560px;font-family:"JetBrains Mono",monospace;font-size:15px;color:var(--head);
+    background:var(--panel);border:1px solid var(--line2);border-radius:11px;padding:13px 16px;outline:none}
+  .search:focus{border-color:var(--mint);box-shadow:0 0 0 3px rgba(124,245,196,.12)}
+  .noresults{color:var(--muted);margin-top:16px}
+  .idx-sec{margin-top:40px;scroll-margin-top:calc(var(--hdr) + 20px)}
+  .idx-sec h2{font-size:22px;color:var(--head);margin:0 0 4px;letter-spacing:-.3px}
+  .sec-blurb{color:var(--muted);font-size:14.5px;margin:0 0 16px;max-width:720px}
+  .sec-blurb code{color:var(--mint);background:rgba(124,245,196,.08);padding:1px 5px;border-radius:5px;font-size:12.5px}
+  .idx-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:10px}
+  a.idx-item{display:flex;flex-direction:column;gap:3px;padding:11px 13px;border:1px solid var(--line);
+    border-radius:10px;background:var(--panel);transition:border-color .14s,transform .14s}
+  a.idx-item:hover{border-color:var(--mint);transform:translateY(-2px)}
+  a.idx-item code{color:var(--c-fn);font-size:13.5px}
+  a.idx-item span{color:var(--muted);font-size:13px;line-height:1.5}
+
+  /* ---- hover card ---- */
+  .hovercard{position:fixed;z-index:100;max-width:340px;background:var(--panel2);border:1px solid var(--line2);
+    border-radius:12px;padding:12px 14px;box-shadow:0 20px 50px -18px rgba(0,0,0,.8);pointer-events:none}
+  .hc-top{display:flex;align-items:center;gap:9px;margin-bottom:8px}
+  .hc-name{font-family:"JetBrains Mono",monospace;color:var(--head);font-weight:700;font-size:14px}
+  .hc-sig{display:block;color:var(--c-fn);background:var(--c-bg);border:1px solid var(--line);border-radius:7px;
+    padding:6px 9px;font-size:12px;margin-bottom:8px;white-space:pre-wrap}
+  .hc-tip{color:var(--text);font-size:13.5px;line-height:1.5}
+  .hc-foot{color:var(--muted);font-size:11.5px;margin-top:9px;letter-spacing:.3px}
+
+  /* ---- target flash ---- */
+  @keyframes ludicflash{0%{background:rgba(124,245,196,.28);box-shadow:0 0 0 3px rgba(124,245,196,.28)}
+    100%{background:transparent;box-shadow:0 0 0 3px transparent}}
+  .flash{animation:ludicflash 1.4s ease-out}
+  .item-head.flash h1{color:var(--mint)}