# amarokice/wolftailui architecture

> Architecture diagram of the GitHub repository amarokice/wolftailui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amarokice/wolftailui
- Repository: https://github.com/amarokice/wolftailui

## Overview

WolfTailUI is a Minecraft 1.7.10 Forge UI library. A mod developer creates a screen and adds widgets; the screen renders and dispatches input to them using shared styles and positions. Separately, callers enqueue toast notifications, which the mod tick handler renders with toast styles and icons. The README also describes reusable color schemes and toasts; the tree contains style and JSON-related modules, though the README lists JSON style packs as TODO. Connections for unsampled modules rely only on SOURCE INDEX references.

Main entry points: [`src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt) (Screen Controller), [`src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt`](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt) (Mod Entry Point), [`src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt`](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt) (Style Builder), [`src/main/kotlin/club/someoneice/wolftail/ui/widget`](https://github.com/amarokice/wolftailui/tree/main/src/main/kotlin/club/someoneice/wolftail/ui/widget) (Widget Set)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Mod Runtime"]
  node_wolf["Mod Entry Point<br/>[WolfTailUI.kt]"]
  node_debug["Debug Utilities<br/>[DebugHelper.kt]"]
end

subgraph group_screens["Screens &amp; Widgets"]
  node_screen["Screen Controller<br/>[WScreen.kt]"]
  node_widget_api["Widget Contracts<br/>[IWidget.kt]"]
  node_widget_impl["Widget Set"]
  node_event_api["Input Contracts"]
  node_keyboard_api["Keyboard Contract"]
  node_position["UI Geometry<br/>[UIPos.kt]"]
end

subgraph group_styling["Styles &amp; Resources"]
  node_style_api["Style Contracts<br/>[IStyle.kt]"]
  node_ui_style_api["Screen Style Contract<br/>[IUIStyle.kt]"]
  node_style_impl["Style Implementations"]
  node_font_style["Font Rendering<br/>[StyleFont.kt]"]
  node_font_manager["Font Manager<br/>[FontManager.kt]"]
  node_texture_manager["Texture Manager"]
end

subgraph group_toast["Toast Notifications"]
  node_toast_queue["Toast Queue<br/>[Toasts.kt]"]
  node_toast_api["Toast API<br/>[IToast.kt]"]
  node_toast_renderer["Toast Renderer<br/>[GuiWToast.kt]"]
  node_toast_style["Toast Styles<br/>[StyleToast.kt]"]
  node_default_toast["Built-in Toasts"]
end

subgraph group_extension["Style Extensions"]
  node_style_builder["Style Builder<br/>[StyleBuilder.kt]"]
  node_json_register["JSON Registration<br/>[JsonRegister.kt]"]
  node_style_type["Style Registry Types<br/>[StyleType.kt]"]
end

node_developer(("Mod Developer"))
node_forge(("Forge Events"))

node_developer -->|"creates screens"| node_screen
node_developer -->|"adds toasts"| node_toast_queue
node_forge -->|"dispatches ticks"| node_wolf
node_wolf -->|"ticks queue"| node_toast_queue
node_wolf -->|"renders toasts"| node_toast_renderer
node_wolf -->|"opens debug"| node_debug
node_toast_queue -->|"accepts toast"| node_toast_api
node_toast_renderer -->|"renders content"| node_toast_api
node_toast_renderer -->|"renders with style"| node_toast_style
node_default_toast -->|"registers styles"| node_style_type
node_default_toast -->|"instantiates styles"| node_toast_style
node_screen -->|"renders widgets"| node_widget_impl
node_screen -->|"dispatches mouse input"| node_event_api
node_screen -->|"tracks keyboard listeners"| node_keyboard_api
node_screen -->|"positions content"| node_position
node_widget_impl -->|"implements contracts"| node_widget_api
node_widget_impl -->|"uses geometry"| node_position
node_widget_impl -->|"uses styles"| node_style_api
node_screen -->|"renders screen style"| node_ui_style_api
node_style_impl -->|"implements styles"| node_style_api
node_style_impl -->|"adapts screen style"| node_ui_style_api
node_style_impl -->|"uses geometry"| node_position
node_font_style -->|"extends adapter"| node_style_impl
node_toast_style -->|"draws text with"| node_font_style
node_font_manager -.->|"uses resource locations"| node_position
node_style_builder -->|"builds styles"| node_style_api
node_style_builder -->|"loads textures"| node_texture_manager
node_style_builder -->|"configures fonts"| node_font_style
node_style_builder -->|"configures toasts"| node_toast_style
node_json_register -->|"registers style types"| node_style_type
node_json_register -->|"uses mod entry"| node_wolf

click node_wolf "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt"
click node_toast_queue "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/dev/Toasts.kt"
click node_toast_api "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IToast.kt"
click node_toast_renderer "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/ui/GuiWToast.kt"
click node_toast_style "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/style/StyleToast.kt"
click node_default_toast "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/constant/DefaultStyleToast.kt"
click node_screen "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt"
click node_widget_api "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IWidget.kt"
click node_widget_impl "https://github.com/amarokice/wolftailui/tree/main/src/main/kotlin/club/someoneice/wolftail/ui/widget"
click node_event_api "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IMouseEventListener.kt"
click node_keyboard_api "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IKeyboardEventListener.kt"
click node_position "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/util/UIPos.kt"
click node_style_api "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IStyle.kt"
click node_ui_style_api "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IUIStyle.kt"
click node_style_impl "https://github.com/amarokice/wolftailui/tree/main/src/main/kotlin/club/someoneice/wolftail/style"
click node_font_style "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/style/StyleFont.kt"
click node_font_manager "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/dev/FontManager.kt"
click node_texture_manager "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/dev/ResourceTextureManager.kt"
click node_style_builder "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt"
click node_json_register "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/json/JsonRegister.kt"
click node_style_type "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/StyleType.kt"
click node_debug "https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/debug/DebugHelper.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_wolf,node_debug toneBlue
class node_screen,node_widget_api,node_widget_impl,node_event_api,node_keyboard_api,node_position toneAmber
class node_style_api,node_ui_style_api,node_style_impl,node_font_style,node_font_manager,node_texture_manager toneMint
class node_toast_queue,node_toast_api,node_toast_renderer,node_toast_style,node_default_toast toneRose
class node_style_builder,node_json_register,node_style_type,node_developer,node_forge toneIndigo
```

## Components

### Mod Runtime

- [Mod Entry Point](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt): `src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt`
- [Debug Utilities](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/debug/DebugHelper.kt): `src/main/kotlin/club/someoneice/wolftail/debug/DebugHelper.kt`

### Screens & Widgets

- [Screen Controller](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt): `src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`
- [Widget Contracts](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IWidget.kt): `src/main/kotlin/club/someoneice/wolftail/api/IWidget.kt`
- [Widget Set](https://github.com/amarokice/wolftailui/tree/main/src/main/kotlin/club/someoneice/wolftail/ui/widget): `src/main/kotlin/club/someoneice/wolftail/ui/widget`
- [Input Contracts](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IMouseEventListener.kt): `src/main/kotlin/club/someoneice/wolftail/api/IMouseEventListener.kt`
- [Keyboard Contract](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IKeyboardEventListener.kt): `src/main/kotlin/club/someoneice/wolftail/api/IKeyboardEventListener.kt`
- [UI Geometry](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/util/UIPos.kt): `src/main/kotlin/club/someoneice/wolftail/util/UIPos.kt`

### Styles & Resources

- [Style Contracts](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IStyle.kt): `src/main/kotlin/club/someoneice/wolftail/api/IStyle.kt`
- [Screen Style Contract](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IUIStyle.kt): `src/main/kotlin/club/someoneice/wolftail/api/IUIStyle.kt`
- [Style Implementations](https://github.com/amarokice/wolftailui/tree/main/src/main/kotlin/club/someoneice/wolftail/style): `src/main/kotlin/club/someoneice/wolftail/style`
- [Font Rendering](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/style/StyleFont.kt): `src/main/kotlin/club/someoneice/wolftail/style/StyleFont.kt`
- [Font Manager](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/dev/FontManager.kt): `src/main/kotlin/club/someoneice/wolftail/dev/FontManager.kt`
- [Texture Manager](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/dev/ResourceTextureManager.kt): `src/main/kotlin/club/someoneice/wolftail/dev/ResourceTextureManager.kt`

### Toast Notifications

- [Toast Queue](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/dev/Toasts.kt): `src/main/kotlin/club/someoneice/wolftail/dev/Toasts.kt`
- [Toast API](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/IToast.kt): `src/main/kotlin/club/someoneice/wolftail/api/IToast.kt`
- [Toast Renderer](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/ui/GuiWToast.kt): `src/main/kotlin/club/someoneice/wolftail/ui/GuiWToast.kt`
- [Toast Styles](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/style/StyleToast.kt): `src/main/kotlin/club/someoneice/wolftail/style/StyleToast.kt`
- [Built-in Toasts](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/constant/DefaultStyleToast.kt): `src/main/kotlin/club/someoneice/wolftail/constant/DefaultStyleToast.kt`

### Style Extensions

- [Style Builder](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt): `src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt`
- [JSON Registration](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/json/JsonRegister.kt): `src/main/kotlin/club/someoneice/wolftail/json/JsonRegister.kt`
- [Style Registry Types](https://github.com/amarokice/wolftailui/blob/main/src/main/kotlin/club/someoneice/wolftail/api/StyleType.kt): `src/main/kotlin/club/someoneice/wolftail/api/StyleType.kt`

### Other components

- **Mod Developer**
- **Forge Events**

## Connections

- Mod Developer → Screen Controller: creates screens (evidence: `README.md`)
- Mod Developer → Toast Queue: adds toasts (evidence: `README.md`)
- Forge Events → Mod Entry Point: dispatches ticks (evidence: `src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt`)
- Mod Entry Point → Toast Queue: ticks queue (evidence: `src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt`)
- Mod Entry Point → Toast Renderer: renders toasts (evidence: `src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt`)
- Mod Entry Point → Debug Utilities: opens debug (evidence: `src/main/kotlin/club/someoneice/wolftail/WolfTailUI.kt`)
- Toast Queue → Toast API: accepts toast (evidence: `src/main/kotlin/club/someoneice/wolftail/dev/Toasts.kt`)
- Toast Renderer → Toast API: renders content (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/GuiWToast.kt`)
- Toast Renderer → Toast Styles: renders with style (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/GuiWToast.kt`)
- Built-in Toasts → Style Registry Types: registers styles (evidence: `src/main/kotlin/club/someoneice/wolftail/constant/DefaultStyleToast.kt`)
- Built-in Toasts → Toast Styles: instantiates styles (evidence: `src/main/kotlin/club/someoneice/wolftail/constant/DefaultStyleToast.kt`)
- Screen Controller → Widget Set: renders widgets (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`)
- Screen Controller → Input Contracts: dispatches mouse input (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`)
- Screen Controller → Keyboard Contract: tracks keyboard listeners (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`)
- Screen Controller → UI Geometry: positions content (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`)
- Widget Set → Widget Contracts: implements contracts (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/widget/WScrollContainer.kt`)
- Widget Set → UI Geometry: uses geometry (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/widget/WScrollContainer.kt`)
- Widget Set → Style Contracts: uses styles (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/widget/WScrollContainer.kt`)
- Screen Controller → Screen Style Contract: renders screen style (evidence: `src/main/kotlin/club/someoneice/wolftail/ui/core/WScreen.kt`)
- Style Implementations → Style Contracts: implements styles (evidence: `src/main/kotlin/club/someoneice/wolftail/style/StyleAdapter.kt`)
- Style Implementations → Screen Style Contract: adapts screen style (evidence: `src/main/kotlin/club/someoneice/wolftail/style/StyleAdapter.kt`)
- Style Implementations → UI Geometry: uses geometry (evidence: `src/main/kotlin/club/someoneice/wolftail/style/StyleAdapter.kt`)
- Font Rendering → Style Implementations: extends adapter (evidence: `src/main/kotlin/club/someoneice/wolftail/style/StyleFont.kt`)
- Toast Styles → Font Rendering: draws text with (evidence: `src/main/kotlin/club/someoneice/wolftail/style/StyleToast.kt`)
- Font Manager → UI Geometry: uses resource locations
- Style Builder → Style Contracts: builds styles (evidence: `src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt`)
- Style Builder → Texture Manager: loads textures (evidence: `src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt`)
- Style Builder → Font Rendering: configures fonts (evidence: `src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt`)
- Style Builder → Toast Styles: configures toasts (evidence: `src/main/kotlin/club/someoneice/wolftail/json/StyleBuilder.kt`)
- JSON Registration → Style Registry Types: registers style types (evidence: `src/main/kotlin/club/someoneice/wolftail/json/JsonRegister.kt`)
- JSON Registration → Mod Entry Point: uses mod entry (evidence: `src/main/kotlin/club/someoneice/wolftail/json/JsonRegister.kt`)
