widget · ui.widget
surface
Bounded spatial overview that emits a stable World-cell activation.
ui.surface(kind, aspect, action_id)
- Stable ID
ui.widget.surface- Owner
- app.ScriptUiWidget
- Authority
- presentation
- Timing
- composition
- Availability
- Phase 19Q9E
- Side effects
- Emits a Controls-owned logical action when activated.
- Determinism
- Click coordinates are normalized against Render camera bounds.
- Introduced
- 1.19.0
Usage
Render a bounded spatial overview in panel order and emit the selected World-cell coordinate through the declared logical action.
Parameters
- None
Returns
A stable widget contract consumed by the interface renderer.
Cost
One bounded draw surface and one activation target.
Fields
This symbol has no fields.
Errors
- None
Examples
ui.surface("minimap", 1.6, "ui.action.surface.minimap-select")
API history
- 1.19.0: Spatial surface widget added for Phase 19Q9E.