5.0 KiB
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.
Accent text contrast refinement
Token math found the existing green #2f855a and teal #1b7f8e readable with white primary-button labels (4.54:1 and 4.69:1), but insufficient as small link text on paper (4.12:1 and 4.26:1). Preserve those product colors for primary surfaces/signals and use the authored deep accent for links/ghost text. This refines TH-04's minimum mapping to satisfy the shared contrast requirement without changing the existing brand colors. Actual browser selector/opacity verification remains required.
| Family | Accent | Deep / focus | Tint | Border |
|---|---|---|---|---|
| Default | #2f5fd0 |
#1e3f99 |
#eef2fc |
#cdd9f7 |
| Historian | #2f855a |
#1c6540 |
#edf5f0 |
#bddbc9 |
| BTDB | #1b7f8e |
#125764 |
#eaf5f6 |
#b7d9dd |
| Overview | #6d28d9 |
#4c1d95 |
#f2ecfc |
#d7c5f2 |
These complete authored families are the candidate adoption values, pending canary computed-style acceptance. Focus uses the deep value in each family. Do not substitute branded color into semantic info.
Current common adoption target
Exact 1.0.1 is published and independently delivery-verified. See patch acceptance and release record. The original1.0.0 major-version decision and G1 evidence remain historical; current consumer migrations converge on1.0.1.