Georg/ai.interactive.fiction
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Checkpoint Eibenreith ink architecture

Browse Source
This commit is contained in:
Georg Tomitsch
2026-05-24 09:09:41 +02:00
parent beac5a2be3
commit d42540f29d
35 changed files with 12015 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
MARKUP_GUIDELINES.md
+18 -1
View File
@@ -29,6 +29,7 @@ Bare flags are accepted as tags with no value:
```ink
#optional
#auto
```
## Right-Page Glossary Notes
@@ -85,8 +86,24 @@ Implemented choice metadata:
- `#key:x`: reserves keyboard key `X` for the choice.
- `#letter[x]`: older equivalent for reserving keyboard key `X`.
- `#action:group` or `#action[group]`: assigns the choice to an invisible action group.
- `#auto`: hides the choice from the visible list and lets the UI choose it automatically when it is ready.
The current UI renders all choices in one visible list. Choices are first grouped by `#action` in the order each new action group appears in the authored choice list. Choices inside each group are randomized. Choices without `#action` form one final unlabelled group shown after all tagged groups. Explicit keys are assigned before automatic keys; choices without explicit keys receive `1` through `0`, then `A` through `Z` in final visible order while skipping explicit keys. `#optional` choices are displayed italic. Grouping columns, `#gated[...]`, and `#sort[...]` are documented authoring conventions or future metadata, not fully implemented UI behavior yet.
The current UI renders all non-auto choices in one visible list. Choices are first grouped by `#action` in the order each new action group appears in the authored choice list. Choices inside each group are randomized. Choices without `#action` form one final unlabelled group shown after all tagged groups. Explicit keys are assigned before automatic keys; choices without explicit keys receive `1` through `0`, then `A` through `Z` in final visible order while skipping explicit keys. `#optional` choices are displayed italic. Grouping columns, `#gated[...]`, and `#sort[...]` are documented authoring conventions or future metadata, not fully implemented UI behavior yet.
Auto choices are ordinary Ink choices, usually with no visible `[...]` choice text. Ink owns their availability and once-only behavior; the UI owns automatic selection and timing. Supported forms:
```ink
* {condition} #auto
-> event
* {condition} #auto(2)
-> event
* {condition} #auto[tunnel](2)
-> event
```
`#auto` fires as soon as it is the first ready auto choice. `#auto(2)` waits at least two UI choice turns since the previous global auto trigger. `#auto[keyword](2)` waits only against the same keyword, so unrelated auto groups do not throttle each other. Use the global form when two different authored events must not fire immediately after each other.
## Popup And End-State Tags