Changelog

[0.1.5]

Added

• reusable UI shader rendering subsystem with UiRenderService, UiShaderPipeline, UiShaderManager, render commands, layers, and CPU fallback renderers
• shader resources for procedural UI shapes and masked textures under assets/voxelui/shaders/core
• Hero component with hexagonal rendering, masked image slot, accent line, XML support, and showcase examples
• shared shader-based rendering path for Badge
• unit coverage for Hero and the shader pipeline fallback/service flow
• generic render style hooks on UINode for shape, border, fill, accent, mask shape, corner style, and shader variant resolution
• lightweight writable XML bindings through UiWritableBinding, including bidirectional selected-index synchronization for components such as Dropdown, Tabs, and InventoryGrid
• framework-wide reactive state primitives through UiObservableValue<T>, UiWritableValue<T>, and UiState
• node-level invalidation APIs on UINode with invalidateRender(), invalidateLayout(), and invalidateMeasure()
• XML-exposed dialog support, including reactive visible="{{...}}" integration with the existing modal layer
• protected notify(...) helpers on XmlUIScreen for toast-like overlay notifications from XML screen actions
• <if condition="..."> structural XML tag for conditional rendering; wraps its children in a transparent panel whose visibility reacts to the bound condition without rebuilding the layout tree
• optional <else> child inside <if> for a two-branch conditional; the two branches are toggled reactively when the condition changes
• findById(String id) and findById(String id, Class<T> type) methods on XmlUIScreen, backed by a recursive tree search on UINode; removes the need for manual tree traversal in afterBuildUi(...)
• id attribute set on UINode during XML mapping so any node declared with id="foo" in XML is immediately findable via findById
• host-agnostic UiRuntime / UiHost runtime layer shared between UIScreen and global overlays
• global overlay system with GlobalUiOverlayManager, GlobalUiOverlayOptions, and VoxelUiOverlays
• public APIs for global showToast(...), showOverlay(...), showModal(...), close(...), and closeAll()
• demo XML resources for a global overlay and a global modal under assets/voxelui/ui
• client dev commands /voxelui toast, /voxelui overlay, /voxelui modal, /voxelui closeall, and /voxelui reload
• UiOverlayContext and UiXmlDialogController abstractions to keep modals and notifications on one coherent system

Changed

• VoxelUI now compensates for Minecraft gui scale at the screen level so custom UI stays readable without being truncated when the player increases the game GUI scale
• UIScreen now renders the UI in a virtual layout space with consistent mouse coordinate remapping, overlay layering, and centered root layout resolution
• many base components now scale more consistently with the UI system, including Button, Checkbox, Dialog, Divider, Dropdown, Grid, Label, NumberInput, Panel, ProgressBar, ScrollPanel, TextInput, and notifications
• buttons now support dynamic sizing, percentage widths, size presets, and XML-driven width values such as 15%
• the XML mapper now accepts more reusable UI attributes, including button sizing fields and generic render/shader-related style properties
• XML screen action registration now accepts typed handlers, allowing XML events to resolve either Runnable callbacks or Consumer<T> listeners depending on the component event payload
• UIScreen.ensureLayoutCurrent() now reacts to dirty nodes in the existing tree instead of relying only on screen-wide layout dirtiness
• XML bindings can now subscribe directly to observable values and invalidate the mapped component without rebuilding the whole screen
• UiWritableBinding is now aligned with the new observable state API instead of being a standalone binding model
• value-driven updates on Label, TextInput, NumberInput, Checkbox, Slider, Dropdown, Tabs, ProgressBar, and InventoryGrid now use local invalidation rather than full layout reloads
• dialogs declared in XML are now mounted outside the normal layout flow and synchronized automatically with UIScreen.showModal(...)
• Dialog now supports XML-driven custom content without forcing the built-in confirm/cancel button row
• the showcase screen and MCSS demo content were expanded to cover dynamic button sizing and hero visual variants
• the hero rendering geometry was consolidated so the shader, content layout, image placement, and accent line all use the same computed bounds
• UINode now stores its declared id and exposes setId, getId, and findById for programmatic node lookup
• UIScreen now delegates layout, render, notifications, modal management, and input dispatch to the shared UiRuntime
• XmlUIScreen now reuses the shared runtime and synchronizes XML <dialog> nodes through UiXmlDialogController
• Modal and Notification now target a shared overlay context instead of depending directly on UIScreen

Fixed

• UI clipping and inconsistent perceived sizing across higher Minecraft gui scale values
• root layout centering drift that made some screens appear to shift horizontally as the GUI scale changed
• missing and limited XML change-event support on interactive inputs; Dropdown, TextInput, NumberInput, Checkbox, and Slider can now propagate typed values directly from XML-declared handlers
• the previous limitation where common Java state changes required reloadLayout() even for simple value updates; observable bindings can now trigger targeted relayouts on existing nodes
• the previous XML gap where confirmation dialogs required afterBuildUi(...) and manual Java wiring even for simple modal flows
• XML validation gaps for newer component attributes such as button size, height, and percentage width fields
• several hero rendering issues around hexagon proportions, content overlap, internal insets, and top/bottom truncation
• shader/log noise caused by uniforms declared or pushed inconsistently between the pipeline and shader JSON definitions