@cyberskill/design 2.8.0 → 2.9.0

package/docs/release-notes.md

@@ -1,6 +1,6 @@
 # Release Notes
 
-Curated product highlights for operators. This is **not** a git log and **not** a `CHANGELOG.md` — the design system does not maintain a changelog file. source checkout VERSION **<!-- cs-source-version:checkout -->2.8.0<!-- /cs-source-version -->** identifies the repository version. This page supplies Storybook **Release Notes**; local edits do not establish what is deployed at `design.cyberskill.world`.
+Curated product highlights for operators. This is **not** a git log and **not** a `CHANGELOG.md` — the design system does not maintain a changelog file. source checkout VERSION **<!-- cs-source-version:checkout -->2.9.0<!-- /cs-source-version -->** identifies the repository version. This page supplies Storybook **Release Notes**; local edits do not establish what is deployed at `design.cyberskill.world`.
 
 ## Unreleased revision — local implementation, acceptance pending
 
@@ -18,6 +18,10 @@ These changes belong to the current revision working tree. They are not a publis
 
 - Destructive AlertDialogs initially focus Cancel; ordinary confirmations initially focus Confirm. The existing `tone`/`variant` precedence, callbacks, Escape dismissal and focus return are retained. This operator-approved policy still requires its current browser and assistive-technology evidence.
 - Custom popup form controls (`Combobox`, `DatePicker`, `TimePicker`, `ColorPicker`, `Cascader`, and `TreeSelect`) accept `"aria-labelledby"` on both the trigger control and open popup surface so external field headings can name them without duplicate `aria-label` strings.
+- Pre-`2.9.0` visual-harmony and contrast remediation across foundations, components, templates, guideline cards, UI kits, and exports:
+  - **Warm neutral & elemental hierarchy (`tokens/colors.css`, `tokens/elevation.css`, `tokens/elements.css`, `scripts/generate-element-packs.mjs`, `scripts/lib/theme-resolver.mjs`):** Calibrates Light `--cs-color-text-muted` to `#5E4436` (`APCA Lc 84.3` on `#FFFDF8`) for clearer separation from primary `#45210E` Umber (`Lc 100.3`), rotates Thổ Light `--cs-accent-strong` (`#A4631E` studio/sand, `#7D480C` clay) onto warm ochre-amber `62°` hue, warms Light `md`/`xl` shadows to `#45210E` Umber, and aligns always-dark `CodeBlock` (`--cs-code-muted`) and `Terminal` (`--cs-term-muted`) muted ink plus native sample constants to `#E9D6C2` (`APCA Lc >= 81.2`) with `color-scheme: dark`.
+  - **Style-pack separation, form-picker borders, touch clearance & navigation contrast (`base/glass.css`, `base/forms.css`, `base/controls.css`, `base/navigation.css`, `base/ai.css`, `base/data.css`, `tokens/viewer.html`, `ui_kits/`):** Enforces zero `backdrop-filter` blur and flat paper fills under `[data-cs-style="matte-paper"]` across `.cs-glass-*` and kit navbars/composer chrome, aligns `Select`, `NativeSelect`, `DatePicker`, `TimePicker`, `ColorPicker`, `Cascader`, `TreeSelect`, and `PromptInput` resting borders to `--cs-component-textfield-border-default` (`2.33:1` in Light), raises `Breadcrumb` `/` separators (`.cs-breadcrumb__sep`) to `--cs-color-text-muted` (`APCA Lc >= 77` in Light and Dark), and adds `20px` bottom scroll clearance on `tokens/viewer.html` `#tablePanel` so `44px` copy buttons clear narrow-viewport horizontal scrollbars.
+  - **Dark guideline/specimen cards, email CTA/VML parity & DOCX `<br>` line breaks (`guidelines/*.html`, `components/data/data.card.html`, `templates/email/Email-VN-standalone.html`, `templates/email-safe/email-*.html`, `templates/_vendor/doc-export.js`):** Replaces fixed white/Umber hex overrides, sub-floor Dark ochre text, and neutral-root `--cs-accent-tint` specimen fills in Dark-mode guideline/component cards with adaptive tokens, aligns `Email-VN-standalone.html` CTAs (`--cs-accent-strong` / `--cs-accent-on-strong`) and standalone VML `email-safe` Light (`#5E4436`) / Dark (`#E9D6C2`) `.muted` copy to clear `APCA Lc >= 75`, and serializes HTML `<br>` elements to OpenXML `<w:r><w:br/></w:r>` runs in DOCX exports. Automated checks and Linux `909×540` pixel baselines do not establish human visual acceptance or manual assistive-technology sign-off.
 
 ### Before adopting this revision
 
@@ -28,11 +32,23 @@ These changes belong to the current revision working tree. They are not a publis
 
 Release remains pending human visual acceptance, required native/manual assistive-technology checks, provenance decisions, and acceptance of changed pilot artifacts. Changed support evidence requires fresh review in `components/lifecycle.json`. EN/VI is the intended language scope; Japanese remains a partial spike. No support expansion, deprecation or removal is authorized by this note.
 
+## Release — `@cyberskill/design@2.8.0`
+
+Published stable minor release recorded in `_audit/ci/fixtures/npm-published-release.json` (observed `2026-11-10T13:04:18.764Z`, tag `v2.8.0` at commit `5e7fdc7fc0ca49844d476a101205c8893591cae2`).
+
+- **Gen-2 AI Benchmark Patterns & Token Alias Hardening (`tokens/variables.css`, `tokens/theme-dark.css`, `base/glass.css`, `base/shell.css`, `base/layout.css`, `base/controls.css`, `base/components.css`, `base/data.css`, `base/ai.css`, `DESIGN.md`):** Adds defensive token aliases (`--cs-glass-card-bg`, `--cs-glass-card-border`, `--cs-color-bg-elevated`, `--cs-color-bg-glass`, `--cs-shadow-glow`), responsive mobile `.cs-sidebar` auto-collapsing and `.cs-theme-toggle` pill auto-sizing, plus `.cs-app-shell--topnav`, `.cs-grid-kpi`, `.cs-canvas`, `.cs-SplitPane`, `.cs-code-editor`, `.cs-checklist`, `.cs-file-dropzone`, `.cs-photo-grid`, `.cs-signature-pad`, `.cs-bottom-bar`, `.cs-sync-banner`, `.cs-table-toolbar`, and `.cs-status-dot--live`.
+- **20-Dimension Live Browser Benchmark Suite & Audit Cleanup (`_audit/ci/verify-audit-benchmarks-browser.mjs`, `_audit/ci/lib/benchmark-checks.mjs`, `_audit/ci/fixtures/benchmark-20d.html`, `_audit/ci/fixtures/benchmark-gen2.html`):** Expands the automated live browser audit to **20 dimensions (`129/129` checks at `10.0 / 10`, `0 watch` items + `64/64` baseline checks = `193/193` total live browser assertions)** with 3 Gen-2 complex product stress-test screens, while retiring legacy `audit/` and `_audit/remediation/` snapshots.
+- **GitHub Pages Native Deployment Pipeline (`.github/workflows/pages.yml`, `scripts/vercel-static-output.mjs`, `docs/deploy.md`):** Emits `.nojekyll` and `CNAME` (`design.cyberskill.world`) into `.vercel-static/` and deploys the classified static webroot directly to GitHub Pages via `actions/upload-pages-artifact` and `actions/deploy-pages`.
+
+```bash
+npm install @cyberskill/design@2.8.0
+```
+
 ## Release — `@cyberskill/design@2.7.0`
 
 Published stable minor release recorded in `_audit/ci/fixtures/npm-published-release.json` (observed `2026-11-09T20:01:08.112Z`, tag `v2.7.0` at commit `d951d7d74077913d5d957f75c9d50d873b9dd937`).
 
-- **20-Dimension Live Browser Benchmark Suite (`_audit/ci/verify-audit-benchmarks-browser.mjs`, `_audit/ci/lib/benchmark-checks.mjs`, `_audit/ci/fixtures/benchmark-20d.html`, `_audit/ci/fixtures/benchmark-gen2.html`):** Expands the automated live browser audit to **20 dimensions (`129/129` checks at `10.0 / 10`, `0 watch` items + `64/64` baseline checks = `193/193` total live browser assertions)** adding `D11` (APCA $L_c \ge 75$ body text & typographic rhythm), `D12` (7-tier `--cs-depth-*` z-index ladder & overlay scroll containment), `D13` (responsive container queries, safe areas & table reflow), `D14` (RTL logical properties, disabled/read-only hygiene & reduced-motion skeleton suppression), `D15` (`@media print`, `@media (forced-colors: active)` WHCM & brand immutables), `D16` (5-axis `Theme × Element × Density × Contrast × Style` orthogonality & surface elevation physics), `D17` (3-browser keyboard & Vietnamese IME focus parity), `D18` (20-family state-machine determinism), `D19` (exportable document/template geometry & table column conservation), and `D20` (production bundle closure, SHA-256 integrity & zero console errors).
+- **16-Dimension Live Browser Benchmark Suite (`_audit/ci/verify-audit-benchmarks-browser.mjs`, `_audit/ci/lib/benchmark-checks.mjs`, `_audit/ci/fixtures/benchmark-20d.html`, `_audit/ci/fixtures/benchmark-gen2.html`):** Expands the automated live browser audit to **16 dimensions (`105/105` checks at `10.0 / 10`, `0 watch` items + `64/64` baseline checks = `169/169` total live browser assertions)** adding `D11` (APCA $L_c \ge 75$ body text & typographic rhythm), `D12` (7-tier `--cs-depth-*` z-index ladder & overlay scroll containment), `D13` (responsive container queries, safe areas & table reflow), `D14` (RTL logical properties, disabled/read-only hygiene & reduced-motion skeleton suppression), `D15` (`@media print`, `@media (forced-colors: active)` WHCM & brand immutables), and `D16` (5-axis `Theme × Element × Density × Contrast × Style` orthogonality & surface elevation physics).
 - **3-Engine Picker Focus Restoration & Vietnamese IME Guard Suite (`components/forms/TreeSelect.jsx`, `components/forms/Cascader.jsx`, `components/forms/ColorPicker.jsx`, `components/forms/SearchField.jsx`, `_audit/ci/test-picker-focus-ime-browser.mjs`):** Restores trigger focus across Chromium, Firefox, and WebKit when closing `DatePicker`, `TreeSelect`, `Cascader`, and `ColorPicker` via selection or `Escape` or clearing `SearchField`, and verifies `isComposing` IME Enter-key guards across `Combobox`, `TagInput`, `Mentions`, `PromptInput`, and `SearchField`.
 - **State-Machine Census & `fast-gates` Local `act` Attestation (`scripts/generate-state-inventory.mjs`, `_audit/state-machines.*`, `scripts/run-act-ci.mjs`, `scripts/verify-ci-checks.mjs`, `.github/workflows/design-system-gates.yml`):** Adds source-derived state-machine discovery with `InlineEdit` transition browser verification and extends commit/tree-bound local `act` attestation to `ci/act/fast-gates`.