docs/language: a page for every keyword and attribute the vocabulary has

Keywords: module uses friend export internal numbers unsafe mut port bind action
reducer registry of as from def open alias component prop view (structure),
shows lasts then loads (scenes), system (ecs), dispatch (control), true false
null (operators). Attributes: @Ref @OneOf @Range @Unit @Asset @Color, @Node /
@Clip / @Material, @Tint @Derived, @Text / @Multiline, @Key, @AppendOnly /
@ByKey, @PerMap / @Chunked, @frame @max, @owns / @creates / @releases,
@deterministic @alloc_ok. Each is in tools/docgen/inventory.json; every fence
that is not marked skip parses (ludicc --fmt). annot-clearcolor's token loses its
quotes, which no reader strips.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Orkun ÇAKILKAYA 2026-09-29 23:59:47 +03:00
parent eb2d6106af
commit e2528c1b10
49 changed files with 746 additions and 7 deletions

View file

@ -0,0 +1,12 @@
---
id: kw-lasts
name: lasts
category: scenes
kind: keyword
tokens: lasts
sig: scene Name lasts N then Next { }
tip: A timed scene: after N seconds it moves on.
order: 52
---
<code>lasts N then Next</code> makes a scene timed - a banner, a splash - that moves to <code>Next</code> by itself once <code>N</code> seconds have passed.

View file

@ -0,0 +1,12 @@
---
id: kw-loads
name: loads
category: scenes
kind: keyword
tokens: loads
sig: scene Name loads then Next { }
tip: A loading scene: pumps the asset queue with a bar, then moves on.
order: 54
---
<code>loads then Next</code> makes a scene the loading screen: the engine pumps the asset queue, draws a progress bar and enters <code>Next</code> when everything queued is ready.

View file

@ -0,0 +1,12 @@
---
id: kw-shows
name: shows
category: scenes
kind: keyword
tokens: shows
sig: scene Name shows Menu { }
tip: The ui this scene opens, renders and closes by itself.
order: 51
---
<code>shows Menu</code> in a scene's header hands a <code>ui</code> to the engine: it is opened when the scene is entered, drawn every frame and closed when it is left, so the scene needs no handler for it.

View file

@ -0,0 +1,12 @@
---
id: kw-then
name: then
category: scenes
kind: keyword
tokens: then
sig: scene Name lasts N then Next / scene Name loads then Next
tip: The scene a timed or loading scene moves on to.
order: 53
---
<code>then</code> names where a scene goes when it is done: after the time of a <code>lasts</code> scene, or once a <code>loads</code> scene's assets are ready.