diff --git a/components/ui-theme/RELEASE-DECISION.md b/components/ui-theme/RELEASE-DECISION.md new file mode 100644 index 0000000..3495fff --- /dev/null +++ b/components/ui-theme/RELEASE-DECISION.md @@ -0,0 +1,38 @@ +# Accessible Technical-Light release decision + +Recorded November 13, 2026, on `codex/scada-ui-consistency`, after GB acceptance commit `99f22b4`. The source tree was clean after acceptance; no UI source had changed. Managed scadaproj worktree and explicitly authorized sister branches remain the execution locations. + +## Version and compatibility + +Select **THEME_VERSION = 1.0.0** for the coordinated accessible Theme release. Current source is 0.5.3. The configured Gitea package index was checked on November 13 and contains 0.2.0, 0.2.1, 0.3.0, 0.3.1, 0.4.0, 0.4.1, 0.5.0 and 0.5.3; 1.0.0 is absent. Recheck immediately before publication; never overwrite an existing immutable version. + +The token policy requires a major release for renaming/removing tokens. Although this release preserves names, its coordinated semantic text treatment and accent contract warrant the conservative major boundary specified in the approved plan. No policy weakening is needed. New component parameters are additive. Existing signal tokens stay unchanged; small text adopts deeper semantic inks. No backend, protocol, schema, authentication or data-ownership behavior changes belong in this release. + +## Post-GB baseline + +From `ZB.MOM.WW.Theme`, Release solution build succeeded with zero warnings/errors and the full suite passed **70/70, zero skips**, using bUnit 2.7.2 / AngleSharp 1.5.2. Commands: `dotnet build ZB.MOM.WW.Theme.slnx -c Release` then `dotnet test tests/ZB.MOM.WW.Theme.Tests/ZB.MOM.WW.Theme.Tests.csproj -c Release --no-build`. GB raw evidence remains under `validation/bunit-2.7.2/`. + +## Adoption baseline + +| Consumer | Authored Theme pin | Delivery | +|---|---|---| +| Overview | 0.5.0 | RCL package | +| ScadaBridge Host/CentralUI | 0.5.3 central | RCL package | +| OtOpcUa AdminUI | 0.5.0 central | RCL package | +| MxAccessGateway Server | 0.5.0 | RCL package | +| HistorianGateway Server | 0.5.0 | RCL package | +| BTDB Manager | 0.4.1 | RCL package | +| ignitionoee router Host/UI | 0.5.0 central | RCL package | +| ignitionoee registry/Perspective | no private Theme dependency | Exact package-derived static export/native mapping | + +Existing package/runtime graphs are retained in GB evidence. Each consumer must verify 1.0.0 resolution during its own adoption. Authored Bootstrap button usages include primary/link variants; Bootstrap's component variables must be bound in their actual selector scope. Consumer sizing overrides need individual review; vendor Bootstrap files are not application-owned overrides. + +## Design and behavior boundary + +Preserve IBM Plex, warm paper, white surfaces, compact tabular type, 8px panels, 220px desktop rail, mobile disclosure, nav persistence, ScrollNav, button sizing/group seams and caller-owned TreeTable data. Operate mode applies. Blue is the default; existing Historian green, BTDB teal and Overview purple remain deliberate product accents. Deep/tint/border/focus values must be documented and contrast/computed-state verified before adoption; semantic info stays independent blue. + +Light is the shared supported scheme. Preserve ScadaBridge's existing supported dark scheme with explicit readable semantic aliases when it adopts; this release does not promise a family-wide dark mode. + +## Release gates + +Implement and verify token, field, accent, busy, focus/motion and interaction contracts before packing. Commit reviewed source/version first; record exact revision, package and export hashes. Run Overview and ScadaBridge local canaries from that package. Publication and independent feed verification remain TH-09; this decision does not claim a package was built, published or deployed. Rollback is the exact prior per-consumer package/artifact, not an overwritten feed version.