Component contract
225 Basic + 234 Combined. The two new public 1.3 families are Theme Surface and Accent Colour Picker. All 457 Stable 1.2 families remain present.
FG UI 1.3.0 development roadmap
Theme Composition / Hybrid Theme
FG UI 1.3 is focused on safely composing Light and Dark surfaces in one interface while preserving the natural FGUI identity, accessibility and backwards compatibility.
PHASE 1 COMPLETEPHASE 2D COMPLETEPHASE 3 COMPLETEPHASE 3A COMPLETEPHASE 4 COMPLETE
Roadmap at a glance
1.2.0 remains an immutable historical archive while 1.3 is the clean-break canonical development contract. With no external consumers, historical APIs may be simplified or removed when the current architecture improves.
0
Stable baseline + 1.3 guards
Fork from immutable 1.2.0 Stable and protect its public contract and release archives.
1
Hybrid Foundation
Hybrid mode, Theme Surface family, local Light/Dark scopes, nested composition and the Theme Composition Lab.
2
Component Inheritance Audit
All 459 current development families are covered under local Dark and local Light-inside-Dark surfaces with 10,872 computed checks.
2A
Accent Colour Personalisation
Horizontal-only hue selection, generated accessible Light/Dark recipes, presets, HEX normalisation, persistence and the Accent Personalisation Lab.
2C
Colour API Clean Break
12 public colour roles, numbered shade scales removed, Accent canonical and Progress keeping one deliberate component highlight.
2D
Colour Accessibility Hardening
Standard on-colour roles, stronger controls/muted text, feedback-safe recipes and separate Light/Dark Accent fills verified across all 360 whole-degree hues.
3
Overlay / Portal Theme Context
Carry opener theme context into custom-select panels, menus, tooltips, popovers, modals, drawers, pickers and command/search palettes.
3A
Zero-Flash Theme Startup
Apply site defaults and saved visitor preferences before first paint, including System resolution and reset hierarchy.
4
Hybrid Application Shells + Theme Stress
Five shell recipes, Dark → Light → Dark nested forms/states, responsive stress and live root-overlay Theme/Accent refresh.
4A
Theme Builder + Site Configuration
Configure default mode and Accent, visitor controls, generated setup and safe preview/reset flows.
5
Theme Package Composition + Export / Import
Extend theme packages with supported modes, semantic overrides and optional Hybrid recipes.
6
Public Theme API + Events
Read-only resolved context, unified lifecycle events, filtered subscriptions and target-specific bindings for external integrations.
7
Accessibility + Contrast Hardening
Light/Dark/Hybrid semantic pair audits, forced colours, focus, reduced motion and screen-reader checks.
8
Visual Regression + Real-World Matrix
Hybrid admin shells, nested-surface stress tests, overlay tests and real-world mixed-theme sites.
9
Documentation + Migration
Composition guide, Hybrid design rules, do/don’t examples, package notes and 1.2 → 1.3 upgrade guidance.
10
1.3 Release Hardening
Feature freeze, full matrix gates, Beta/RC packaging, manual sign-off and immutable Stable promotion.
Current checkpoint
Phase 7B platform hardening and manual/cross-engine sign-off are PASS. Phase 8 Visual Regression + Real-World Matrix is complete with 45 frozen screenshot and geometry references. Phase 9 Documentation + Configuration Guidance is next.
Inheritance quality gate
459 local Dark + 459 local Light-inside-Dark specimens, 10,872 computed checks and the full required viewport matrix.
Contrast-safe semantic colour API
Only Accent is user-pickable. Brand stays fixed; feedback and neutral roles remain FGUI-controlled. On-colour foregrounds, stronger control boundaries and dual Light/Dark Accent recipes keep visibility predictable.
Phase 9 complete
Documentation + Configuration Guidance
Beginner-first usage docs, generated public API reference, platform policy and a 476-entry local documentation search are complete. Core runtime is unchanged.
Build FGUI-1.3.0-DEV-P9-DOCS-4AA57A0F7564