19. GUI (Dear ImGui)

dasImgui — the daslang binding for Dear ImGui, organised by area: the boost macro spine, builtin widgets, hot-reload + transport, and the testing toolkit. Built-in Dear ImGui functions (imgui::*) are not duplicated here; consult the upstream Dear ImGui documentation for the C++ surface. This documents the v2 surface — the legacy imgui/imgui_boost (v1) module is registered but undocumented.

Start with Application lifecycle: one application structure for standalone, live-reload, and headless execution.

• 19.1. Boost macro layer
  • 19.1.1. Boost macro layer — DSL for declarative widget composition
    • 19.1.1.1. Function annotations
    • 19.1.1.2. Classes
  • 19.1.2. Boost runtime — widget state structs, registry, and dispatcher
    • 19.1.2.1. Type aliases
    • 19.1.2.2. Structures
    • 19.1.2.3. Per-frame registry
    • 19.1.2.4. Path machinery
    • 19.1.2.5. Coroutines
    • 19.1.2.6. Window control
    • 19.1.2.7. Live commands
    • 19.1.2.8. Synthetic input
    • 19.1.2.9. Debug logging
    • 19.1.2.10. Memory debugging
    • 19.1.2.11. Snapshot transform
    • 19.1.2.12. JSON serialization
      • 19.1.2.12.1. JV
• 19.2. Builtin widgets
  • 19.2.1. Built-in widgets — inputs, selection, color, plots, output
    • 19.2.1.1. Call macros
    • 19.2.1.2. Images
    • 19.2.1.3. Selection
    • 19.2.1.4. Focus & scrolling
    • 19.2.1.5. Logging
    • 19.2.1.6. Status queries
  • 19.2.2. Built-in containers — windows, child regions, tabs, menus, popups
    • 19.2.2.1. Call macros
    • 19.2.2.2. Windows
    • 19.2.2.3. Tabs
    • 19.2.2.4. Popups
      • 19.2.2.4.1. close_current_popup
      • 19.2.2.4.2. open_popup
      • 19.2.2.4.3. open_popup_on_item_click
  • 19.2.3. ID stack — push/pop, scoped, hashing
    • 19.2.3.1. ID stack
  • 19.2.4. Layout helpers — splits, columns, docking, spacing
    • 19.2.4.1. Call macros
    • 19.2.4.2. Columns
    • 19.2.4.3. Trees
    • 19.2.4.4. List clipping
  • 19.2.5. Style helpers — colors, vars, push/pop, themes
    • 19.2.5.1. Call macros
    • 19.2.5.2. Push/pop
      • 19.2.5.2.1. push_style_one
  • 19.2.6. Icon set
    • 19.2.6.1. Transport
    • 19.2.6.2. Edit
    • 19.2.6.3. Visualize
    • 19.2.6.4. Mix
    • 19.2.6.5. Organize
    • 19.2.6.6. Synth
    • 19.2.6.7. Scene tools
    • 19.2.6.8. Scene objects
    • 19.2.6.9. Arrange
    • 19.2.6.10. Editor transport
    • 19.2.6.11. View
    • 19.2.6.12. File
    • 19.2.6.13. General
    • 19.2.6.14. API
• 19.3. Live reload and transport
  • 19.3.1. Live-reload lifecycle and synthetic-IO bypass driver
    • 19.3.1.1. Structures
    • 19.3.1.2. Lifecycle
    • 19.3.1.3. Synth IO drivers
    • 19.3.1.4. Event timelines
    • 19.3.1.5. Status / introspection
  • 19.3.2. Transport — pluggable lambda-based IPC for imgui commands
    • 19.3.2.1. Type aliases
    • 19.3.2.2. Constants
    • 19.3.2.3. Structures
    • 19.3.2.4. Transport construction
    • 19.3.2.5. Send / receive
    • 19.3.2.6. Awaiting
    • 19.3.2.7. Raw HTTP
• 19.4. Testing toolkit
  • 19.4.1. Playwright — block-form test harness for daslang-live + dasImgui apps
    • 19.4.1.1. Constants
    • 19.4.1.2. Structures
    • 19.4.1.3. App lifecycle
      • 19.4.1.3.1. with_imgui_app
      • 19.4.1.3.2. with_recording_app
    • 19.4.1.4. Locators / queries
    • 19.4.1.5. Actions
    • 19.4.1.6. Recording / narration
      • 19.4.1.6.1. say
      • 19.4.1.6.2. say_begin
    • 19.4.1.7. Content-time gating
    • 19.4.1.8. Snapshots
    • 19.4.1.9. Polling / await
    • 19.4.1.10. Pause control
    • 19.4.1.11. Transport plumbing
  • 19.4.2. Visual aids — tutorial-mode overlays, mouse trail, narration, key HUD
    • 19.4.2.1. Constants
    • 19.4.2.2. Structures
    • 19.4.2.3. Highlight overlay
    • 19.4.2.4. Mouse trail
    • 19.4.2.5. Narration
      • 19.4.2.5.1. narrate
    • 19.4.2.6. HUD
    • 19.4.2.7. Cursor sprite
    • 19.4.2.8. Override hooks
    • 19.4.2.9. Memory debugging
    • 19.4.2.10. Color utilities
    • 19.4.2.11. Serve / lifecycle
• 19.5. External types
  • 19.5.1. imgui::ImGuiCol
  • 19.5.2. imgui::ImGui*Flags
  • 19.5.3. imgui::ImGuiCond
  • 19.5.4. imgui::ImVec2 / imgui::ImVec4 / imgui::ImColor
  • 19.5.5. imgui::ImGuiViewport
  • 19.5.6. imgui::ImGuiSizeCallbackData
  • 19.5.7. glfw::GLFWwindow
  • 19.5.8. imgui::ImTextureRef
  • 19.5.9. imgui::ImGuiTextFilter
• 19.6. Internal binding families
  • 19.6.1. Render helpers
  • 19.6.2. Vertex shading
  • 19.6.3. Layout & item sizing
  • 19.6.4. Item hit-test & geometry
  • 19.6.5. Item assembly (ItemAdd + ButtonBehavior)
  • 19.6.6. Behavior-flag buttons
  • 19.6.7. Axis layout primitives (splitter & scrollbar)
  • 19.6.8. Tree-node behavior
  • 19.6.9. Separator & low-level text
  • 19.6.10. Combo internals
  • 19.6.11. Popups, tooltips & menus
  • 19.6.12. ID stack seed & override
  • 19.6.13. Focus scope & activation
  • 19.6.14. Item flags
  • 19.6.15. Logging & capture