ui-style-kit-css 2.7.0 → 2.7.2

package/docs/DEMO-SHOWCASE.md

@@ -4,6 +4,22 @@ The default `index.html` and `demo/index.html` present one shared library showca
 semantic components, overview, color tokens, prefixed components, native HTML,
 the Interactive Surface bridge, and usage examples.
 
+## Interaction contrast
+
+Hover, press, and keyboard focus must preserve readable labels. A filled action
+keeps its paired foreground and background; an inline-link rule must not recolor
+a button or navigation component. Gloss and grain remain decorative rather than
+replacing the label's underlying paint.
+
+The release regressions check 20 presets, 25 named palettes plus native palettes,
+three modes, and five interaction states, including hover on pressed buttons.
+They cover prefixed, semantic, and mixed React class models, anchor buttons,
+native controls, disclosures, navigation, and table labels. The
+contrast probe samples the central label lane and accounts for translucent paint
+and full-face pseudo-elements; positioned dropdown arrows are outside that lane.
+
+Recheck the rendered demo after changing palette values in the workbench.
+
 ## Preview state and palette editing
 
 Use `?ui=tactile&theme=None&mode=dark` to preview a native palette. The `personality`

package/docs/ECOSYSTEM.md

@@ -14,11 +14,11 @@ Before a UI branch or pull request is expected to validate, verify the reviewed
 
 | Library | Current aligned version | Owns |
 |---|---:|---|
-| `ui-style-kit-css@2.7.0` | current release candidate | visual identity, color themes, UI paint, native HTML styling, content wrapping, and bridge tokens |
+| `ui-style-kit-css@2.7.2` | current UI version | visual identity, color themes, UI paint, native HTML styling, content wrapping, and bridge tokens |
 | `interactive-surface-css@1.7.3` | compatible state release | interaction-state primitives, surface behavior, state layers, and input affordances |
 | `layout-style-css@3.2.3` | compatible structural release | structural wrappers, grids, sections, app shells, and layout recipes |
 
-The current combination is `ui-style-kit-css@2.7.0`, `interactive-surface-css@1.7.3`, and `layout-style-css@3.2.3`. UI Style Kit `2.7.0` is the current release candidate; `2.6.1` remains published on npm. The companion versions are reviewed releases. Layout Style `3.2.3` is the compatible structural release. The validated minimum remains `ui-style-kit-css@2.1.0`, `interactive-surface-css@1.5.0`, and `layout-style-css@3.0.0`.
+The current combination is `ui-style-kit-css@2.7.2`, `interactive-surface-css@1.7.3`, and `layout-style-css@3.2.3`. UI Style Kit `2.7.2` is the current UI version. The companion versions are reviewed releases. Layout Style `3.2.3` is the compatible structural release. The validated minimum remains `ui-style-kit-css@2.1.0`, `interactive-surface-css@1.5.0`, and `layout-style-css@3.0.0`.
 
 ## Layout-to-visual pairing matrix
 

package/docs/PUBLISHING.md

@@ -1,10 +1,14 @@
 # Publishing Guide
 
-## 2.7.0 release workflow
+## 2.7.2 focused patch route
 
-The current checkout is a release candidate. [Release preparation notes](RELEASE-2.7.0.md)
+The owner authorized selected affected checks and prohibited CI/full suites for this repair. Follow [the 2.7.2 publication boundary](RELEASE-2.7.2.md) and the reviewed manual publish-select-patch.yml workflow. It requires signed exact source, the merged exact-head STE-Adam review, generated-asset reproduction, package admission and anonymous byte readback. It uses the existing npm publisher credential; no new secret or application deployment is included. Do not dispatch either legacy publisher for this patch. The 2.7.1 procedure below is historical and does not describe current 2.7.2 evidence.
+
+## 2.7.1 release workflow
+
+This guide prepares version `2.7.1`. [Release preparation notes](RELEASE-2.7.1.md)
 record the current local scope and gates; existing visual-QA documents are historical
-evidence, not proof that subsequent edits passed browser validation. The 2.7.0
+evidence, not proof that subsequent edits passed browser validation. The 2.7.1
 changelog entry must carry the approved publication date before tagging.
 
 Update the tracked `wiki/` sources with the README and docs. Publishing those pages
@@ -13,9 +17,9 @@ documentation generator is configured in this package; reusable JavaScript helpe
 use JSDoc-compatible comments, and the checked-in build owns generated CSS, manifests,
 icons, README size measurements, and demo asset hashes.
 
-Prepare `ui-style-kit-css@2.7.0` on its release branch, open a pull request against `main`, and merge only after the fast automated gate is green and any requested manual demo review is complete. The aligned companion releases are `layout-style-css@3.2.3` and `interactive-surface-css@1.7.3`.
+Prepare `ui-style-kit-css@2.7.1` on its release branch, open a pull request against `main`, and merge only after the fast automated gate is green and any requested manual demo review is complete. The aligned companion releases are `layout-style-css@3.2.3` and `interactive-surface-css@1.7.3`.
 
-Do not push `v2.7.0` before the reviewed release commit is on `main`. A pushed version tag runs Release Version Alignment, which validates the tag/package/changelog contract and creates the GitHub Release; publishing that release triggers the protected npm workflow.
+Do not push `v2.7.1` before the reviewed release commit is on `main`. A pushed version tag runs Release Version Alignment, which validates the tag/package/changelog contract and creates the GitHub Release; publishing that release triggers the protected npm workflow.
 
 Release Version Alignment owns the fast automated release gate: lint, build, unit checks, the tagged Chromium release-smoke Playwright suite, and packed ecosystem preflight with `--skip-clean-install`. The visual-baseline suite, full UI matrix, and clean-install ecosystem matrix are manual escalation tools, not default push or publish blockers. The protected npm workflow intentionally does not rerun browser gates; it revalidates the immutable tag, package contracts, browser-free compatibility checks, companion commit reachability, the explicit release preflight with `--skip-clean-install`, npm token presence, npm owner authorization, and registry state before publishing.
 
@@ -76,7 +80,7 @@ npm run check:ecosystem:packs -- --layout-repo ../Layout-Style-CSS --interactive
 npm publish
 ```
 
-`prepublishOnly` runs `npm run release:verify`, so a direct `npm publish` still has the default fast release gate. For GitHub releases, push or dispatch the matching package tag, such as `v2.7.0`, only after the release PR is merged. The release workflows verify that `package.json`, `package-lock.json`, `CHANGELOG.md`, generated dist banners, and ecosystem pins are aligned before publishing. Dispatch the protected npm workflow from the current `main` workflow file when recovering publication for a release that has already passed Release Version Alignment.
+`prepublishOnly` runs `npm run release:verify`, so a direct `npm publish` still has the default fast release gate. For GitHub releases, push or dispatch the matching package tag, such as `v2.7.1`, only after the release PR is merged. The release workflows verify that `package.json`, `package-lock.json`, `CHANGELOG.md`, generated dist banners, and ecosystem pins are aligned before publishing. Dispatch the protected npm workflow from the current `main` workflow file when recovering publication for a release that has already passed Release Version Alignment.
 
 The repository `NPM_TOKEN` secret must authenticate to npm as a user that appears in `npm owner ls ui-style-kit-css`. If the token belongs to another npm account or lacks package publish rights, npm may report a misleading registry `E404` at publish time.
 
@@ -88,4 +92,4 @@ npm run release:minor
 npm run release:major
 ```
 
-Use patch for compatible fixes, minor for new themes, presets, component capabilities, or browser-support contracts, and major for incompatible public API changes. Version `2.7.0` is a minor candidate because it adds shared component presentation and spacing controls while retaining the existing preset and semantic component APIs. Future feature versioning continues to follow this policy.
+Use patch for compatible fixes, minor for new themes, presets, component capabilities, or browser-support contracts, and major for incompatible public API changes. Version `2.7.1` is a patch release because it repairs interaction paint and contrast while retaining the preset and semantic component APIs. Future feature versioning continues to follow this policy.

package/docs/RELEASE-2.7.1.md

@@ -0,0 +1,21 @@
+# v2.7.1 interaction contrast patch
+
+This compatible patch preserves the 20 presets, 25 named color themes, native palettes, three modes, and existing public entrypoints.
+
+## Corrections
+
+- Neutral hover rules no longer replace filled action backgrounds while retaining their foregrounds.
+- Outlined CTAs retain readable surface ink at rest and their paired primary fill on hover. Neutral defaults exclude these paint-owning modifiers; Clay icon buttons use the control surface beneath their labels.
+- Inline-link presentation excludes prefixed and semantic action classes. The build generates semantic aliases only for selectors that positively select a promoted component; exclusions alone cannot introduce a competing component rule. Variant exclusions also cover mixed prefixed/semantic markup used by React consumers.
+- Primary, danger, warning, and current-navigation labels retain a matched foreground and background. Decorative reflections stay outside the central label lane.
+- Neumorphism table values use readable surface ink, and Bento success and warning badge labels remain readable on translucent tints.
+- Neo Noir warning paint belongs to its skewed face, preserving the component geometry.
+- Y2K cut modifiers preserve primary action paint, and the compact trust seal contains its full number and caption.
+
+## Verification boundary
+
+Focused Chromium regressions cover all presets, native plus named palettes, all modes, and rest, hover, active, keyboard-focus, and pressed-hover states. Fixtures include prefixed buttons, both semantic namespaces, mixed React class models, anchor actions, marketing CTAs, icon actions, native fields, disclosures, navigation, and tables. The React paint check asserts the real theme IDs visited, preventing a repeated native palette from masquerading as named-theme coverage.
+
+Manual demo interaction uses the connected local Opera browser because Gnomie Browser Commander's runtime is unavailable in this session. Local evidence, protected GitHub release checks, npm publication, and live demo verification remain separate gates. No jsdoc2md generator is configured in this CSS package; JSDoc-compatible comments and the repository build maintain the generated artifacts.
+
+Publication follows [PUBLISHING.md](PUBLISHING.md). The aligned companions remain Interactive Surface CSS 1.7.3 and Layout Style CSS 3.2.3.

package/docs/RELEASE-2.7.2.md

@@ -0,0 +1,55 @@
+# v2.7.2 native select affordance patch
+
+This compatible patch restores dropdown cues while retaining the 20 presets,
+25 themes, public entrypoints, native popups and semantic namespaces.
+
+## Corrections
+
+Preset-layer semantic field background shorthands reset the native indicator's
+image, size, position and repetition. The shared fallback restores the existing
+public tokens above generic component paint. The reserved text gutter survives
+compact preset padding. Retro Glass keeps its indicator above its recessed
+material; Neo Noir keeps its browser-owned arrow without duplicate custom paint.
+Tactile hardware arrows and Clay texture layers remain preset-owned.
+
+## Focused evidence
+
+Two individually selected Chromium cases passed. The first visits all 20 presets
+in light, dark and contrast modes with native, canonical `.usk-select`, compatibility
+`.ui-select` and prefixed controls. The second checks keyboard selection, disabled
+and multiple-select semantics, and settled LTR/RTL positioning under reduced
+motion. The selected original single/multiple source contract and new publication
+authority case also passed. The three changed stylesheets pass focused lint.
+Named-theme, Firefox, WebKit and whole-suite results are not claimed here.
+
+The first shared fix exposed Y2K gutter reset and Retro Glass material precedence.
+Generated alias tracing identified Neo Noir's reduced root specificity. Test-only
+corrections distinguish repeating Clay texture from indicators, preserve Tactile's
+hardware end cap, and await computed CSS settlement in a standards-mode fixture.
+
+Gnomie visually inspected the candidate CSS on the retained actual installed SYS
+catalog DOM at desktop and phone widths. Both catalog page-size and language
+controls had bounded arrows without overflow. This diagnostic preview is separate
+from published-package consumer qualification and hosted acceptance.
+
+## Publication boundary
+
+The owner authorized selected affected checks and prohibited CI/full suites for
+this repair. The manual `publish-select-patch.yml` route is restricted to 2.7.2.
+It requires a verified exact source commit, merged PR and STE-Adam's latest
+approval of that head independently of the author. A trusted main controller is
+retained before candidate checkout. It reproduces tracked generated assets, checks
+package contents, packs without lifecycle hooks, uses the existing npm package-owner
+credential and compares anonymous public npm bytes to its SHA-256/SHA-512 receipt.
+The matching GitHub release includes that tarball and receipt. The built-in
+repository token creates its tag/release without starting legacy CI publishers.
+No tests, CI script, new secret, paid resource or application deployment is included.
+
+Default historical publishers and package hooks remain unchanged. This route does
+not assert their suites ran. This CSS repository has no configured jsdoc2md
+generator. The new publisher has a [granular jsdoc2md reference](api/publish-select-patch.md), generated using the existing SYS workspace tool. Professional JSDoc-compatible comments, maintained documentation and
+the normal build preserve the source/generated boundary. Tracked wiki changes do
+not publish the hosted Wiki. SYS must qualify the actual published stable package
+and its integrity before production.
+
+Interactive Surface CSS 1.7.3 and Layout Style CSS 3.2.3 remain aligned companions.

package/docs/api/publish-select-patch.md

@@ -0,0 +1,80 @@
+<!-- Generated with jsdoc2md from scripts/publish-select-patch.mjs; do not edit by hand. -->
+
+## Functions
+
+<dl>
+<dt><a href="#admitFocusedPatch">admitFocusedPatch(evidence)</a> ⇒ <code>string</code></dt>
+<dd><p>Admit only this patch&#39;s verified source and the latest exact-source STE-Adam review.</p>
+</dd>
+<dt><a href="#run">run(program, args)</a> ⇒ <code>string</code></dt>
+<dd><p>Execute a fixed program with argument-array boundaries and no credential output on failure.</p>
+</dd>
+<dt><a href="#api">api(endpoint)</a> ⇒ <code>object</code></dt>
+<dd><p>Read one bounded JSON result from the authenticated repository API.</p>
+</dd>
+<dt><a href="#receipt">receipt()</a> ⇒ <code>object</code></dt>
+<dd><p>Read the immutable checksum receipt produced before publication.</p>
+</dd>
+<dt><a href="#main">main(mode)</a> ⇒ <code>Promise.&lt;void&gt;</code></dt>
+<dd><p>Publish-support commands perform admission, artifact hashing and public byte readback only.
+The workflow owns the explicit npm publication; no tests or lifecycle hooks are dispatched here.</p>
+</dd>
+</dl>
+
+<a name="admitFocusedPatch"></a>
+
+## admitFocusedPatch(evidence) ⇒ <code>string</code>
+Admit only this patch's verified source and the latest exact-source STE-Adam review.
+
+**Kind**: global function  
+**Returns**: <code>string</code> - Exact admitted source commit.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| evidence | <code>object</code> | Authoritative GitHub and checked-out package evidence. |
+
+<a name="run"></a>
+
+## run(program, args) ⇒ <code>string</code>
+Execute a fixed program with argument-array boundaries and no credential output on failure.
+
+**Kind**: global function  
+**Returns**: <code>string</code> - Successful standard output.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| program | <code>string</code> | Fixed executable. |
+| args | <code>Array.&lt;string&gt;</code> | Literal arguments. |
+
+<a name="api"></a>
+
+## api(endpoint) ⇒ <code>object</code>
+Read one bounded JSON result from the authenticated repository API.
+
+**Kind**: global function  
+**Returns**: <code>object</code> - Parsed API result.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| endpoint | <code>string</code> | Fixed repository endpoint with validated scope. |
+
+<a name="receipt"></a>
+
+## receipt() ⇒ <code>object</code>
+Read the immutable checksum receipt produced before publication.
+
+**Kind**: global function  
+**Returns**: <code>object</code> - Exact artifact identity.  
+<a name="main"></a>
+
+## main(mode) ⇒ <code>Promise.&lt;void&gt;</code>
+Publish-support commands perform admission, artifact hashing and public byte readback only.
+The workflow owns the explicit npm publication; no tests or lifecycle hooks are dispatched here.
+
+**Kind**: global function  
+**Returns**: <code>Promise.&lt;void&gt;</code> - Completion after the selected phase verifies its boundary.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| mode | <code>string</code> | Fixed workflow phase. |
+

package/manifest.json

@@ -5,7 +5,7 @@
     "breakingChange": "increment-schemaVersion-before-removing-or-renaming-fields"
   },
   "name": "ui-style-kit-css",
-  "version": "2.7.0",
+  "version": "2.7.2",
   "cascadeLayers": [
     "ui-style-kit.theme_colors",
     "ui-style-kit.native_elements",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-style-kit-css",
-  "version": "2.7.0",
+  "version": "2.7.2",
   "description": "CSS theme and UI style preset library for accessible websites, dashboards, admin interfaces, and client-facing pages.",
   "style": "dist/ui-style-kit.css",
   "main": "dist/ui-style-kit.css",

package/styles/art-deco.css

@@ -438,7 +438,8 @@
 .deco-card, .deco-panel { background: var(--deco-card-bg); }
 .deco-toolbar, .deco-table-wrap { background: var(--deco-control-bg); }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-.deco-button:where(:not([data-ui-variant])):not(.deco-button-primary):not(.deco-button-secondary):not(.deco-button-danger):not(.deco-button-warning):not(.deco-button-ghost), .deco-icon-button { background: var(--deco-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.deco-button:where(:not([data-ui-variant])):not(.deco-button-primary):not(.deco-button-secondary):not(.deco-button-danger):not(.deco-button-warning):not(.deco-button-ghost):not(.deco-button-outline-heavy), .deco-icon-button { background: var(--deco-control-bg); }
 .deco-button, .deco-icon-button, .deco-badge, .deco-nav-link { font-family: var(--deco-font-control); }
 
 
@@ -630,7 +631,7 @@
 .deco-button.deco-button-outline-heavy,
 .deco-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--deco-primary));
+  color: var(--usk-primary-ink, var(--deco-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--deco-primary);
@@ -1058,6 +1059,12 @@
   }
 }
 
+/** Named palettes preserve their tested primary paint pair instead of tempering only the fill. */
+[data-ui="art-deco"][data-theme][data-mode] :is(.deco-button-primary, .deco-nav-link[aria-current="page"], .deco-nav-link.is-active) {
+  background-color: var(--deco-primary);
+  color: var(--deco-on-primary);
+}
+
 /**
  * Lets explicit runtime token edits render exact user-supplied action colors
  * while untouched shared themes keep the tempered Art Deco jewel paint.
@@ -1524,7 +1531,9 @@
   text-indent: 0;
 }
 
-.deco-button:where(:not([data-ui-variant])):not(.deco-button-primary):not(.deco-button-secondary):not(.deco-button-danger):not(.deco-button-warning):not(.deco-button-ghost),
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+
+.deco-button:where(:not([data-ui-variant])):not(.deco-button-primary):not(.deco-button-secondary):not(.deco-button-danger):not(.deco-button-warning):not(.deco-button-ghost):not(.deco-button-outline-heavy),
 .deco-icon-button {
   background-color: var(--deco-surface-strong);
   background-image: none;

package/styles/bauhaus.css

@@ -464,7 +464,8 @@
 .bau-card, .bau-panel { background: var(--bau-card-bg); }
 .bau-toolbar, .bau-table-wrap { background: var(--bau-control-bg); }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-.bau-button:where(:not([data-ui-variant])):not(.bau-button-primary):not(.bau-button-secondary):not(.bau-button-danger):not(.bau-button-warning):not(.bau-button-ghost):not(.is-primary):not(.is-secondary):not(.is-danger):not(.is-ghost):not(.is-busy):not(.is-hover), .bau-icon-button { background: var(--bau-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.bau-button:where(:not([data-ui-variant])):not(.bau-button-primary):not(.bau-button-secondary):not(.bau-button-danger):not(.bau-button-warning):not(.bau-button-ghost):not(.bau-button-outline-heavy):not(.is-primary):not(.is-secondary):not(.is-danger):not(.is-ghost):not(.is-busy):not(.is-hover), .bau-icon-button { background: var(--bau-control-bg); }
 .bau-button, .bau-icon-button, .bau-badge, .bau-nav-link { font-family: var(--bau-font-control); }
 
 
@@ -662,7 +663,7 @@
 .bau-button.bau-button-outline-heavy,
 .bau-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--bau-primary));
+  color: var(--usk-primary-ink, var(--bau-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--bau-primary);
@@ -950,7 +951,8 @@
 .bau-button-primary { background: var(--bau-primary); color: var(--bau-on-primary); border-color: var(--bau-primary); }
 .bau-button-secondary { background: var(--bau-secondary); color: var(--bau-on-secondary); border-color: var(--bau-secondary); }
 .bau-button-danger { background: var(--bau-danger); color: var(--bau-on-danger); border-color: var(--bau-danger); }
-.bau-button-ghost { background: transparent; color: var(--usk-primary-ink, var(--bau-primary)); border-color: transparent; }
+/** Native palettes need surface ink when the primary fill is too dark for an unfilled action. */
+.bau-button-ghost { background: transparent; color: var(--usk-primary-ink, var(--bau-text)); border-color: transparent; }
 }
 
 @layer ui-style-kit.bauhaus {

package/styles/bento.css

@@ -454,7 +454,8 @@
 /* Theme-responsive component defaults */
 .bento-card, .bento-panel { background: var(--bento-card-bg); }
 .bento-toolbar, .bento-table-wrap { background: var(--bento-control-bg); }
-.bento-button:where(:not(.bento-button-primary):not(.bento-button-secondary):not(.bento-button-danger):not(.bento-button-warning):not(.bento-button-ghost):not(.is-primary):not(.is-secondary):not(.is-danger):not(.is-ghost):not(.is-hover):not(.is-busy)), .bento-icon-button { background: var(--bento-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.bento-button:where(:not(.bento-button-primary):not(.bento-button-secondary):not(.bento-button-danger):not(.bento-button-warning):not(.bento-button-ghost):not(.bento-button-outline-heavy):not(.is-primary):not(.is-secondary):not(.is-danger):not(.is-ghost):not(.is-hover):not(.is-busy)), .bento-icon-button { background: var(--bento-control-bg); }
 .bento-button, .bento-icon-button, .bento-badge, .bento-nav-link { font-family: var(--bento-font-control); }
 
 
@@ -500,8 +501,9 @@
 .bento-badge { display: inline-flex; align-items: center; gap: var(--bento-space-1); min-height: 1.75rem; padding: .38rem .72rem; background: var(--bento-tile-secondary-bg); color: var(--bento-text); border: 1px solid var(--bento-tile-edge); border-radius: var(--bento-radius-sm); box-shadow: inset 0 1px 0 rgb(var(--bento-surface-strong-rgb) / .62); font-size: .8125rem; font-weight: 800; line-height: 1; }
 .bento-badge-primary { background: var(--bento-primary); color: var(--bento-on-primary); border-color: var(--bento-primary); }
 .bento-badge-secondary { background: rgb(var(--bento-primary-rgb) / .10); color: var(--usk-primary-ink, var(--bento-primary)); border-color: transparent; }
-.bento-badge-success { background: rgb(var(--bento-success-rgb) / .14); color: var(--bento-success); border-color: transparent; }
-.bento-badge-warning { background: rgb(var(--bento-warning-rgb) / .14); color: var(--bento-warning); border-color: transparent; }
+/** Warning and success tints use surface text rather than their solid signal fill as ink. */
+.bento-badge-success { background: rgb(var(--bento-success-rgb) / .14); color: var(--bento-text); border-color: transparent; }
+.bento-badge-warning { background: rgb(var(--bento-warning-rgb) / .14); color: var(--bento-text); border-color: transparent; }
 .bento-badge-danger { background: rgb(var(--bento-danger-rgb) / .14); color: var(--bento-danger); border-color: transparent; }
 
 .bento-nav { display: flex; flex-wrap: wrap; align-items: center; gap: var(--bento-space-2); padding: var(--bento-space-2); background: var(--bento-card-bg); border: 1px solid var(--bento-tile-edge); border-radius: var(--bento-tile-radius); box-shadow: var(--bento-tile-shadow); }
@@ -674,7 +676,7 @@
 .bento-button.bento-button-outline-heavy,
 .bento-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--bento-primary));
+  color: var(--usk-primary-ink, var(--bento-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--bento-primary);
@@ -817,7 +819,7 @@
 }
 .bento-button.bento-button-outline-heavy, .bento-button-outline-heavy {
   background: rgb(var(--bento-surface-strong-rgb) / var(--bento-panel-alpha));
-  color: var(--usk-primary-ink, var(--bento-primary));
+  color: var(--usk-primary-ink, var(--bento-text));
   border-width: 1px;
   border-color: rgb(var(--bento-primary-rgb) / .32);
   border-radius: var(--bento-control-radius);
@@ -1210,7 +1212,6 @@
 
 [data-ui=bento][data-mode] :is(.bento-button, .bento-icon-button) {
   align-items: center;
-  background: var(--bento-mosaic-panel-soft);
   border: 1px solid var(--bento-mosaic-line);
   border-radius: 8px;
   display: inline-flex;
@@ -1221,6 +1222,8 @@
   padding: 0 16px;
   transition: background-color 150ms ease, border-color 150ms ease, box-shadow 150ms ease, transform 150ms ease;
 }
+/** Mosaic neutral paint yields to the outlined CTA's paired hover fill. */
+[data-ui=bento][data-mode] :is(.bento-button, .bento-icon-button):where(:not(.bento-button-outline-heavy)) { background: var(--bento-mosaic-panel-soft); }
 [data-ui=bento][data-mode] .bento-button:hover:not(:disabled) { transform: translateY(-1px); }
 [data-ui=bento][data-mode] .bento-button:active:not(:disabled) { transform: translateY(1px); }
 [data-ui=bento][data-mode] .bento-button.is-primary,
@@ -1595,7 +1598,8 @@
 [data-ui=bento][data-mode] .bento-card, [data-ui=bento][data-mode] .bento-panel { padding: 16px; }
 [data-ui=bento][data-mode] .bento-button, [data-ui=bento][data-mode] .bento-icon-button { border-radius: 8px; box-shadow: none; font-weight: 750; text-shadow: none; }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-[data-ui=bento][data-mode] .bento-button:where(:not([data-ui-variant])):not(.bento-button-primary):not(.bento-button-secondary):not(.bento-button-danger):not(.bento-button-warning):not(.bento-button-ghost):not(.is-primary):not(.is-secondary):not(.is-danger):not(.is-ghost):not(.is-busy):not(.is-hover) { background: var(--bento-surface-soft); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+[data-ui=bento][data-mode] .bento-button:where(:not([data-ui-variant])):not(.bento-button-primary):not(.bento-button-secondary):not(.bento-button-danger):not(.bento-button-warning):not(.bento-button-ghost):not(.bento-button-outline-heavy):not(.is-primary):not(.is-secondary):not(.is-danger):not(.is-ghost):not(.is-busy):not(.is-hover) { background: var(--bento-surface-soft); }
 [data-ui=bento][data-mode] .bento-button.bento-button-primary, [data-ui=bento][data-mode] .bento-button.is-primary, [data-ui=bento][data-mode] .bento-button.is-busy { background: var(--bento-primary); color: var(--bento-on-primary); border-color: var(--bento-primary); }
 [data-ui=bento][data-mode] .bento-button.bento-button-secondary, [data-ui=bento][data-mode] .bento-button.is-secondary { background: transparent; color: var(--bento-link); border-color: var(--bento-primary); }
 [data-ui=bento][data-mode] .bento-button.bento-button-danger, [data-ui=bento][data-mode] .bento-button.is-danger { background: var(--bento-mosaic-danger-soft); color: var(--bento-text); border-color: var(--bento-danger); }

package/styles/brutalism.css

@@ -432,7 +432,8 @@
 
 [data-ui="brutalism"][data-mode] { background: var(--brutal-theme-bg); background-size: var(--brutal-theme-bg-size); }
 
-[data-ui="brutalism"] a { color: var(--brutal-link); text-decoration-thickness: 0.14em; text-underline-offset: 0.16em; font-weight: 800; }
+/** Inline-link ink must not override the foreground paired with an action surface. */
+[data-ui="brutalism"] a:where(:not(.brutal-button):not(.brutal-icon-button)) { color: var(--brutal-link); text-decoration-thickness: 0.14em; text-underline-offset: 0.16em; font-weight: 800; }
 [data-ui="brutalism"] ::selection { background: var(--brutal-primary); color: var(--brutal-on-primary); }
 
 /* Spinner geometry follows the brutalism preset's blunt mechanical edges. */
@@ -525,7 +526,8 @@
 .brutal-card, .brutal-panel { background: var(--brutal-card-bg); }
 .brutal-toolbar, .brutal-table-wrap { background: var(--brutal-control-bg); }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-.brutal-button:where(:not([data-ui-variant])):not(.brutal-button-primary):not(.brutal-button-secondary):not(.brutal-button-danger):not(.brutal-button-warning):not(.brutal-button-ghost), .brutal-icon-button { background: var(--brutal-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.brutal-button:where(:not([data-ui-variant])):not(.brutal-button-primary):not(.brutal-button-secondary):not(.brutal-button-danger):not(.brutal-button-warning):not(.brutal-button-ghost):not(.brutal-button-outline-heavy), .brutal-icon-button { background: var(--brutal-control-bg); }
 .brutal-button, .brutal-icon-button, .brutal-badge, .brutal-nav-link { font-family: var(--brutal-font-control); }
 
 
@@ -639,7 +641,7 @@
 .brutal-button.brutal-button-outline-heavy,
 .brutal-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--brutal-primary));
+  color: var(--usk-primary-ink, var(--brutal-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--brutal-primary);

package/styles/clay.css

@@ -446,7 +446,8 @@
 .clay-card, .clay-panel { background: var(--clay-card-bg); }
 .clay-toolbar, .clay-table-wrap { background: var(--clay-control-bg); }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-.clay-button:where(:not([data-ui-variant])):not(.clay-button-primary):not(.clay-button-secondary):not(.clay-button-danger):not(.clay-button-warning):not(.clay-button-ghost), .clay-icon-button { background: var(--clay-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.clay-button:where(:not([data-ui-variant])):not(.clay-button-primary):not(.clay-button-secondary):not(.clay-button-danger):not(.clay-button-warning):not(.clay-button-ghost):not(.clay-button-outline-heavy), .clay-icon-button { background: var(--clay-control-bg); }
 .clay-button, .clay-icon-button, .clay-badge, .clay-nav-link { font-family: var(--clay-font-control); }
 
 
@@ -638,7 +639,7 @@
 .clay-button.clay-button-outline-heavy,
 .clay-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--clay-primary));
+  color: var(--usk-primary-ink, var(--clay-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--clay-primary);
@@ -895,7 +896,8 @@
   --clay-molded-track: var(--clay-grain-image), linear-gradient(180deg, var(--clay-material-contact), transparent 46%), var(--clay-material-inset);
   --clay-molded-raised: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), var(--clay-material-raised);
   --clay-molded-thumb: var(--clay-grain-image), radial-gradient(circle at 34% 24%, var(--clay-material-highlight), transparent 46%), linear-gradient(176deg, var(--clay-material-highlight), transparent 44%), var(--clay-thumb-material);
-  --clay-molded-primary: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), var(--clay-pigment-primary);
+  /** Raised highlights stay above the label, preserving the pigment's paired ink. */
+  --clay-molded-primary: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 20%), var(--clay-pigment-primary);
   --clay-molded-success: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), var(--clay-pigment-success);
   --clay-molded-warning: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), var(--clay-pigment-warning);
   --clay-molded-danger: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), var(--clay-pigment-danger);
@@ -1073,11 +1075,12 @@
 }
 
 /** Gives every button the shallow relief and debossed lettering shown in the reference. */
+/** Action and icon labels use the control surface; thumb pigment belongs to movable parts. */
 .clay-button, .clay-icon-button,
 [data-ui="clay"][data-mode] :where(button:not([class]), input[type="button"]:not([class]), input[type="submit"]:not([class]), input[type="reset"]:not([class])) {
   min-height: 2rem;
   padding: .34rem .64rem;
-  background-color: var(--clay-thumb-material);
+  background-color: var(--clay-control-bg);
   background-image: var(--clay-grain-image), linear-gradient(174deg, var(--clay-material-highlight), transparent 34%);
   background-size: var(--clay-grain-size), auto;
   border: 1px solid var(--clay-material-seam);
@@ -1102,7 +1105,8 @@
   text-shadow: var(--clay-label-relief);
 }
 .clay-button-primary { background: var(--clay-molded-primary); color: var(--clay-pigment-ink); border-color: var(--clay-pigment-primary); }
-.clay-button-primary:hover { background-color: var(--clay-pigment-primary-hover); border-color: var(--clay-pigment-primary-hover); }
+/** Hover changes the relief and edge without lightening the pigment beneath its label. */
+.clay-button-primary:hover { background: var(--clay-molded-primary); border-color: var(--clay-pigment-primary-hover); }
 .clay-button-secondary { background: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), var(--clay-pigment-secondary); color: var(--clay-on-secondary); border-color: var(--clay-pigment-secondary); }
 .clay-button-secondary:hover { background-color: var(--clay-pigment-secondary); border-color: var(--clay-pigment-secondary); }
 .clay-button-danger { background: var(--clay-molded-danger); color: rgb(var(--clay-danger-text-rgb)); border-color: var(--clay-pigment-danger); }
@@ -1127,7 +1131,7 @@
 }
 .clay-button.clay-button-outline-heavy, .clay-button-outline-heavy {
   background-color: var(--clay-material-raised);
-  color: var(--usk-primary-ink, var(--clay-primary));
+  color: var(--usk-primary-ink, var(--clay-text));
   border: 2px solid var(--clay-primary);
   clip-path: var(--clay-chip-clip);
 }
@@ -1229,7 +1233,8 @@
   .clay-badge-danger { background: var(--clay-grain-image), linear-gradient(176deg, var(--clay-material-highlight), transparent 42%), color-mix(in srgb, var(--clay-pigment-danger) 28%, var(--clay-material-raised)); color: var(--clay-material-ink); border-color: color-mix(in srgb, var(--clay-pigment-danger), var(--clay-material-seam) 52%); }
 }
 .clay-nav { gap: 0; padding: .18rem; background: var(--clay-material-inset); border-color: var(--clay-material-seam); border-radius: .48rem .6rem .52rem .56rem; box-shadow: var(--clay-carved-shadow); clip-path: var(--clay-control-clip); filter: var(--clay-edge-filter); }
-.clay-nav-link { min-height: 2.1rem; padding: .42rem .62rem; border-radius: .3rem .38rem .32rem .36rem; clip-path: var(--clay-control-clip); font-weight: 500; text-shadow: var(--clay-label-relief); }
+/** Navigation labels retain full surface ink over the textured clay slab. */
+.clay-nav-link { min-height: 2.1rem; padding: .42rem .62rem; border-radius: .3rem .38rem .32rem .36rem; clip-path: var(--clay-control-clip); font-weight: 500; color: var(--clay-text); text-shadow: var(--clay-label-relief); }
 .clay-nav-link[aria-current="page"], .clay-nav-link.is-active { background: var(--clay-molded-primary); color: var(--clay-pigment-ink); box-shadow: var(--clay-filled-shadow); clip-path: var(--clay-control-clip); filter: var(--clay-edge-filter); }
 
 .clay-alert { padding: .7rem .82rem; background-color: var(--clay-material-raised); background-image: var(--clay-grain-image), linear-gradient(170deg, var(--clay-material-highlight), transparent 42%); background-size: var(--clay-grain-size), auto; border: 1px solid var(--clay-material-seam); border-inline-start-width: .28rem; border-radius: .42rem .55rem .46rem .52rem; box-shadow: var(--clay-relief-shadow); clip-path: var(--clay-control-clip); filter: var(--clay-edge-filter); }

package/styles/cyberpunk.css

@@ -427,7 +427,8 @@
 }
 [data-ui="cyberpunk"] *, [data-ui="cyberpunk"] *::before, [data-ui="cyberpunk"] *::after { box-sizing: border-box; }
 [data-ui="cyberpunk"][data-mode] { background: var(--cyber-theme-bg); background-size: var(--cyber-theme-bg-size); }
-[data-ui="cyberpunk"] a { color: var(--cyber-link); text-decoration-color: rgb(var(--cyber-primary-rgb) / 0.6); text-underline-offset: 0.18em; }
+/** Inline-link ink must not override the foreground paired with an action surface. */
+[data-ui="cyberpunk"] a:where(:not(.cyber-button):not(.cyber-icon-button)) { color: var(--cyber-link); text-decoration-color: rgb(var(--cyber-primary-rgb) / 0.6); text-underline-offset: 0.18em; }
 [data-ui="cyberpunk"] ::selection { background: var(--cyber-primary); color: var(--cyber-on-primary); }
 
 .cyber-page { position: relative; min-height: 100vh; padding: clamp(1rem, 4vw, 3rem); }
@@ -478,7 +479,8 @@
 .cyber-card, .cyber-panel { background: var(--cyber-card-bg); }
 .cyber-toolbar, .cyber-table-wrap { background: var(--cyber-control-bg); }
 /** Semantic variant attributes take precedence over the legacy neutral-control fallback. */
-.cyber-button:where(:not([data-ui-variant])):not(.cyber-button-primary):not(.cyber-button-secondary):not(.cyber-button-danger):not(.cyber-button-warning):not(.cyber-button-ghost), .cyber-icon-button { background: var(--cyber-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.cyber-button:where(:not([data-ui-variant])):not(.cyber-button-primary):not(.cyber-button-secondary):not(.cyber-button-danger):not(.cyber-button-warning):not(.cyber-button-ghost):not(.cyber-button-outline-heavy), .cyber-icon-button { background: var(--cyber-control-bg); }
 .cyber-button, .cyber-icon-button, .cyber-badge, .cyber-nav-link { font-family: var(--cyber-font-control); }
 
 /* Spinner geometry follows the cyberpunk preset's clipped neon readouts. */
@@ -580,7 +582,7 @@
 .cyber-button.cyber-button-outline-heavy,
 .cyber-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--cyber-primary));
+  color: var(--usk-primary-ink, var(--cyber-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--cyber-primary);
@@ -1047,7 +1049,7 @@
 .cyber-button:hover,
 .cyber-icon-button:hover {
   border-color: var(--cyber-primary);
-  color: var(--usk-primary-ink, var(--cyber-primary));
+  color: var(--usk-primary-ink, var(--cyber-text));
   box-shadow: 0 0 .75rem rgb(var(--cyber-primary-rgb) / .2);
 }
 
@@ -1618,7 +1620,8 @@
   border-color: transparent;
   background-color: transparent;
   background-image: none;
-  color: var(--usk-primary-ink, var(--cyber-primary));
+  /** Unfilled native controls use readable surface ink rather than neon fill pigment. */
+  color: var(--usk-primary-ink, var(--cyber-text));
   box-shadow: none;
 }
 
@@ -1627,7 +1630,8 @@
   border-color: var(--cyber-danger);
   background-color: rgb(var(--cyber-danger-rgb) / .12);
   background-image: linear-gradient(135deg, rgb(var(--cyber-danger-rgb) / .16), transparent 62%);
-  color: var(--cyber-danger);
+  /** The signal tint is decorative; its label uses the contrasting surface foreground. */
+  color: var(--cyber-text);
   box-shadow: var(--cyber-template-danger-glow);
 }
 

package/styles/data-terminal.css

@@ -438,7 +438,9 @@
 .terminal-card, .terminal-panel { background: var(--terminal-card-bg); }
 .terminal-toolbar, .terminal-table-wrap { background: var(--terminal-control-bg); }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-.terminal-button:where(:not([data-ui-variant])):not(.terminal-button-primary):not(.terminal-button-secondary):not(.terminal-button-danger):not(.terminal-button-warning):not(.terminal-button-ghost):not(.is-active):not([aria-pressed="true"]),
+/** Native press state bypasses the neutral fallback just like persistent pressed hooks. */
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.terminal-button:where(:not([data-ui-variant])):not(.terminal-button-primary):not(.terminal-button-secondary):not(.terminal-button-danger):not(.terminal-button-warning):not(.terminal-button-ghost):not(.terminal-button-outline-heavy):not(.is-active):not([aria-pressed="true"]):not(:active),
 .terminal-icon-button:not(.is-active):not([aria-pressed="true"]) { background: var(--terminal-control-bg); }
 .terminal-button, .terminal-icon-button, .terminal-badge, .terminal-nav-link { font-family: var(--terminal-font-control); }
 
@@ -631,7 +633,7 @@
 .terminal-button.terminal-button-outline-heavy,
 .terminal-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--terminal-primary));
+  color: var(--usk-primary-ink, var(--terminal-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--terminal-primary);

package/styles/editorial-luxe.css

@@ -438,7 +438,8 @@
 .luxe-card, .luxe-panel { background: var(--luxe-card-bg); }
 .luxe-toolbar, .luxe-table-wrap { background: var(--luxe-control-bg); }
 /** Attribute-selected variants bypass the legacy neutral-only paint fallback. */
-.luxe-button:where(:not([data-ui-variant])):not(.luxe-button-primary):not(.luxe-button-secondary):not(.luxe-button-danger):not(.luxe-button-warning):not(.luxe-button-ghost), .luxe-icon-button { background: var(--luxe-control-bg); }
+/** Neutral defaults exclude outlined actions so their hover fill and ink remain paired. */
+.luxe-button:where(:not([data-ui-variant])):not(.luxe-button-primary):not(.luxe-button-secondary):not(.luxe-button-danger):not(.luxe-button-warning):not(.luxe-button-ghost):not(.luxe-button-outline-heavy), .luxe-icon-button { background: var(--luxe-control-bg); }
 .luxe-button, .luxe-icon-button, .luxe-badge, .luxe-nav-link { font-family: var(--luxe-font-control); }
 
 
@@ -630,7 +631,7 @@
 .luxe-button.luxe-button-outline-heavy,
 .luxe-button-outline-heavy {
   background: transparent;
-  color: var(--usk-primary-ink, var(--luxe-primary));
+  color: var(--usk-primary-ink, var(--luxe-text));
   border-style: solid;
   border-width: 2px;
   border-color: var(--luxe-primary);