@takazudo/zudo-doc 5.18.0 → 5.18.1

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@takazudo/zudo-doc` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [5.18.1] - 2026-09-06
+
+### Bug Fixes
+
+- The page-loading spinner no longer flips colour with the scheme. It previously took `--color-fg` while the scrim is deliberately theme-independent (always dark), which left the ring at only **3.02:1** against the scrim in a light scheme — over the WCAG 1.4.11 non-text 3:1 floor by 0.02. Both spinner declarations now read `var(--color-page-loading-spinner, #fff)`, a new optional host token with a light default: **6.18:1** in a light scheme and **20.13:1** in a dark one. The scrim itself is unchanged. (4fa1651b2)
+- The `prefers-reduced-motion` spinner no longer dims to `opacity: 0.5`. A white ring at 50% composites to **2.85:1** on the light-scheme scrim — still under the floor — so fixing only the colour would have left the ring non-compliant for exactly the users who rely on a static indicator. It now matches the animated ring at 6.18:1 / 20.13:1. (4fa1651b2)
+
+### Other Changes
+
+- **Behavior note for hosts that styled the spinner via `--color-fg`:** that coupling was the defect and is gone. Use the new `--color-page-loading-spinner` token instead, and override it in step with `--color-page-loading-overlay` whenever you retone the scrim, so the pair stays above the contrast floor together. The token is optional and intentionally left undefined in the package — the `#fff` fallback is the fix. (4fa1651b2)
+- `@takazudo/zdtp` peer floor moved to `^0.5.1`. zdtp 0.5.1 bounds its eager-load state-key gate to a new `READABLE_STATE_KEY_SUFFIXES` registry (`-state`, `-state-v2/v3/v4`) instead of accepting any `-state-vN`; this package already delegated to `EAGER_LOAD_GATE_STATE_FAMILY.matchesKey`, so runtime behavior follows upstream with no code change. Stale prose describing the old open-ended numeric family was corrected in the source docblock, `CLAUDE.md`, `API.md`, and the route-injection ADR. (4a72db50d, c9042f3ed, a61722e40)
+
 ## [5.18.0] - 2026-09-06
 
 ### Features

package/dist/compiled.css

@@ -2728,7 +2728,7 @@ a[data-zd-nav-pending], button[data-zd-nav-pending] {
 .page-loading-spinner {
   width: 48px;
   height: 48px;
-  border: 5px solid var(--color-fg, #fff);
+  border: 5px solid var(--color-page-loading-spinner, #fff);
   border-bottom-color: transparent;
   border-radius: 50%;
   display: inline-block;
@@ -2753,8 +2753,7 @@ a[data-zd-nav-pending], button[data-zd-nav-pending] {
 @media (prefers-reduced-motion: reduce) {
   .page-loading-spinner {
     animation: none;
-    border-bottom-color: var(--color-fg, #fff);
-    opacity: 0.5;
+    border-bottom-color: var(--color-page-loading-spinner, #fff);
   }
 }
 header[data-header] {

package/dist/page-loading.css

@@ -16,7 +16,15 @@
  *       host's --color-overlay token.
  *   --color-overlay   Semi-opaque backdrop colour (used by the fallback chain
  *                     above when --color-page-loading-overlay is not set).
- *   --color-fg        Spinner border colour. Falls back to #fff.
+ *   --color-page-loading-spinner
+ *       Spinner border colour. Falls back to #fff.
+ *       Deliberately NOT --color-fg: the scrim above is theme-independent
+ *       (always dark), so a scheme-flipping foreground put the ring at only
+ *       3.02:1 against it in a light scheme — under the WCAG 1.4.11 non-text
+ *       3:1 floor for practical purposes. Pinning the ring light keeps it at
+ *       6.18:1 (light scheme) / 20.13:1 (dark scheme) on the default scrim.
+ *       Override it alongside --color-page-loading-overlay whenever the
+ *       scrim is retoned, so the pair stays above the floor together.
  *   --color-accent    Colour applied to links/buttons with data-zd-nav-pending.
  *   --z-index-modal   Stack level for the overlay. Falls back to 100.
  * ========================================================================== */
@@ -52,7 +60,7 @@ button[data-zd-nav-pending] {
 .page-loading-spinner {
   width: 48px;
   height: 48px;
-  border: 5px solid var(--color-fg, #fff);
+  border: 5px solid var(--color-page-loading-spinner, #fff);
   border-bottom-color: transparent;
   border-radius: 50%;
   display: inline-block;
@@ -76,7 +84,9 @@ button[data-zd-nav-pending] {
 @media (prefers-reduced-motion: reduce) {
   .page-loading-spinner {
     animation: none;
-    border-bottom-color: var(--color-fg, #fff);
-    opacity: 0.5;
+    /* Completes the ring into a static indicator. No opacity reduction: a
+       white ring at 0.5 composites to 2.85:1 on the light-scheme scrim,
+       below the 3:1 non-text floor these users depend on. */
+    border-bottom-color: var(--color-page-loading-spinner, #fff);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.18.0",
+  "version": "5.18.1",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -667,7 +667,7 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@takazudo/zdtp": "^0.5.0",
+    "@takazudo/zdtp": "^0.5.1",
     "@takazudo/zfb": "^2.15.1",
     "@takazudo/zfb-md-wasm": "^2.15.1",
     "@takazudo/zfb-runtime": "^2.15.1",
@@ -720,7 +720,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.18.0"
+    "@takazudo/zudo-doc-history-server": "5.18.1"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",