1.0.0

• Initial release.

1.1.0

• Allow settings screens to render one page without a navigation rail
• Allow to place multi-page navigation in a horizontal, scrollable top bar.

1.2.0

• Provide shimmer-enabled text, switch, slider, and button controls through MuiWidgetFactory.shimmer().
• Add MuiTheme.withOnPrimary() for customizing filled-button text color and document the new factory.

1.3.0

• Add a configurable background controller with image and folder pickers, slideshow settings, crop support, and pluggable persistence.
• Expose screen-host services for overlays and page refreshes.

1.4.0

• Huge refactor and re-design.

1.4.1

• Add page-wide shimmer defaults for headers and content, plus supplier-backed sliders with descriptions.
• Update chip theming and separate the logo glyph from its shimmering background

1.5.0

• Add fixed action bars, guarded close handling, lazy page construction, scrollable navigation, and searchable rows.
• Add field validation for text, numbers, and list entries, with validation hints, and document the new APIs.

1.5.1

• Add dialogs, collapsible sections, tooltips, dynamic navigation sizing, and runtime row enablement.
• Parse legacy text formatting and improve screen lifecycle, resize handling, and list-editor commits.

1.6.0

• Add description-free overloads for section number, long number, decimal, dropdown, choice grid, list and text field rows, mirrored in MuiControls and MuiPageContext.
• Add three-argument page overloads and navigation-label based initial-page selection to the high-level and low-level screen builders.
• Add default-marker checkbox, radio button and progress bar factories, a filled button overload, fluent padding, margin, text and heading helpers, and decimal/long value rows.
• Add expanded-by-default collapsible section helpers, default image/slideshow background factories, shorter file-picker calls, and a decimal number field factory without an explicit scale. 1.7.

1.7.0

• Add page-switch transitions through MuiPageTransition (FADE default, SLIDE_UP, SLIDE_DOWN, SLIDE_AUTO) and the matching pageTransition(...) / pageTransitionDuration(...) builder methods on both screen builders. Use pageTransitionDuration(0) for an instant switch.
• Skip transitions on the initial page, page reloads and resize rebuilds, and cancel a running transition when another switch starts or the view is destroyed.

1.7.1

• Add MuiColorBand and MuiColorBands, a public OKLab two-color band API with a nine-stop mirrored ramp.
• Add MuiColorBandField and MuiColorBandPreview widgets: live ramp preview, two color fields, picker hooks and per-field labels.
• Document the band API in the API tutorial.

1.7.2

• Add themeProvider(Function<Context, MuiTheme>) to both screen builders for context-aware, live themes.
• Add MuiConfigFragment.reloadTheme(): rebuild the rail, navigation highlight, headings and widgets while keeping the selected page.

1.7.3

• Add MuiShimmerRamps, a public light/core/deep nine-stop ramp generator with sampling.
• Add MuiColorBandField.rampProvider(...) so core/deep band fields can preview a richer ramp than the default two-color band.

1.8.0

• Add MuiColorScheme, MuiThemePalette, MuiHudPalette and MuiColorSchemes, a shared catalog of UI + HUD color schemes with a registry.
• Add built-in Naruto, Classic, Jade, Azure, Sakura and Graphite schemes with translated names.
• A scheme registered by NarutoUI or another mod automatically appears in every consumer that iterates the catalog.

1.8.1

• Add MuiTextView, which translates Minecraft legacy § formatting codes on every text update instead of only when the view is created. Supplier-backed labels such as slider values no longer fall back to raw codes on their periodic refresh.
• Carry a single legacy color through setTextColor and keep per-part colors as spans, including reset (§r) and bold/italic/underline/strikethrough codes.
• Use the formatted text view for factory text, chips and validation hints, honor codes in shimmer text and button labels, and render the dropdown header with its original colors instead of stripping them.

1.8.2

• Support the 1.16+ hexadecimal color form §x§R§R§G§G§B§B alongside the 16 legacy colors, including uppercase digits, mixed hex/legacy labels and solidColor.
• Dim per-part span colors when a dropdown header or option row is disabled, instead of keeping the colors at full strength.
• Skip the parse/layout path when a supplier-backed label is refreshed with unchanged text, so the 100 ms refresh only re-applies the colour.
• Document that §k is rendered as its readable characters instead of per-frame randomisation: configuration labels must stay readable and keep a stable width.

1.9.0

• Generate the built-in schemes instead of listing them: MuiColorScheme.of(...) takes one brand color plus a surface tint, HUD preset and ramp style, and MuiSchemeGenerator derives the other 26 values in OKLCH. The six built-ins went from 162 hand-written colors to six brand colors plus one named overlay preset.
• Add MuiOklch and MuiColorMath: public OKLCH conversion with sRGB gamut mapping, WCAG contrast, OKLab distance, and a contrast-floor helper that only moves lightness so hue and role survive.
• Add MuiSurfaceTint, MuiHudPreset and MuiRampStyle so a scheme states its intent instead of spelling out colors.
• MuiColorScheme is no longer a record and no longer has a public constructor; use the of(...) factories. id, nameKey, theme, hud, shimmerRamp and accent are unchanged.
• MuiColorScheme.of(id, nameKey, brand, tint, hud, ramp, surface) honours a caller-chosen surface and derives every contrast floor from it, so a light surface gets dark text instead of unreadable light text.
• Reproduce the signature Naruto shimmer ramp from the HUD status colors ordered bright to deep, instead of a second hand-written array.
• Add MuiRampStyle.HUE_SWEEP and MuiRampAnchor: a ramp now spans a highlight anchor to a deep anchor, the way Naruto's own ramp travels from yellow through gold to red, instead of fading into the scheme's own low-chroma divider. The light end is a pale tint because a saturated cyan or lime at high lightness reads as neon, and the deep end keeps full chroma so the trough of the wave stays colored. Jade runs pale water through jade to deep green, Azure pale steel to deep blue, Sakura pale rose to blood red, Graphite pale blue to deep teal.
• MuiTheme.modern() now falls back to the catalog's Naruto palette instead of its own copy of the same nine values, and MuiShimmerConfig.ramp() defaults to the Naruto scheme's ramp.
• MuiShimmerRamps and MuiColorBands now interpolate in OKLab, so shimmer mid-tones and band previews no longer wash out toward gray.