@pieai/swimmer-ui-kit 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -3,7 +3,19 @@
 All notable changes to `@pieai/swimmer-ui-kit`.
 Format: [Keep a Changelog](https://keepachangelog.com); versioning: semver.
 
-## Unreleased
+## 2.1.0 — 2026-09-02
+
+### Added
+
+- **Opt-in clay scroll surfaces.** Product-owned overflow containers can use
+  `.game-ui-scroll-surface` and the four `--game-ui-scrollbar-*` semantic
+  tokens to share the kit's Firefox and Chromium/WebKit scrollbar treatment.
+
+### Changed
+
+- **Build finalization is cross-platform.** The package build now uses a Node
+  script to copy the optional Tailwind bridge and remove `.DS_Store` files,
+  keeping the release path valid on Windows as well as POSIX hosts.
 
 ## 2.0.0
 

package/README.md

@@ -20,7 +20,7 @@ assets may not be extracted, modified, or redistributed as a standalone pack.
 ```json
 {
   "dependencies": {
-    "@pieai/swimmer-ui-kit": "1.0.0"
+    "@pieai/swimmer-ui-kit": "2.1.0"
   }
 }
 ```
@@ -69,6 +69,10 @@ import '@pieai/swimmer-ui-kit/tailwind.css';
   }
   ```
 
+  Product-owned overflow containers can opt into the kit's cross-browser clay
+  scrollbar treatment with `class="game-ui-scroll-surface"`; tune its size,
+  track, thumb, and hover colors through the `--game-ui-scrollbar-*` tokens.
+
 - **Type**: a HUD scale (`--game-ui-font-xs` … `-xxl`) plus the three things a
   HUD scale does not cover — `--game-ui-font-mono` for code, and
   `--game-ui-font-reading` / `--game-ui-line-reading` /

package/dist/index.d.ts

@@ -422,6 +422,13 @@ export declare const CLAY_RADIUS_TOKENS: {
     readonly modal: "var(--game-ui-radius-modal)";
 };
 
+export declare const CLAY_SCROLLBAR_TOKENS: {
+    readonly size: "var(--game-ui-scrollbar-size)";
+    readonly track: "var(--game-ui-scrollbar-track)";
+    readonly thumb: "var(--game-ui-scrollbar-thumb)";
+    readonly thumbHover: "var(--game-ui-scrollbar-thumb-hover)";
+};
+
 export declare const CLAY_SEMANTIC_TOKENS: {
     readonly background: "var(--game-ui-bg)";
     readonly playfieldScrim: "var(--game-ui-playfield-scrim)";
@@ -582,6 +589,12 @@ export declare const CLAY_UI_TOKENS: {
         readonly panel: "var(--game-ui-radius-panel)";
         readonly modal: "var(--game-ui-radius-modal)";
     };
+    readonly scrollbars: {
+        readonly size: "var(--game-ui-scrollbar-size)";
+        readonly track: "var(--game-ui-scrollbar-track)";
+        readonly thumb: "var(--game-ui-scrollbar-thumb)";
+        readonly thumbHover: "var(--game-ui-scrollbar-thumb-hover)";
+    };
     readonly elevation: {
         readonly button: "var(--game-ui-shadow-button)";
         readonly panel: "var(--game-ui-shadow-panel)";
@@ -1094,6 +1107,10 @@ export declare const GAME_UI_TOKENS: {
     readonly panel: "var(--game-ui-shadow-panel)";
     readonly inset: "var(--game-ui-shadow-inset)";
     readonly stroke: "var(--game-ui-stroke)";
+    readonly scrollbarSize: "var(--game-ui-scrollbar-size)";
+    readonly scrollbarTrack: "var(--game-ui-scrollbar-track)";
+    readonly scrollbarThumb: "var(--game-ui-scrollbar-thumb)";
+    readonly scrollbarThumbHover: "var(--game-ui-scrollbar-thumb-hover)";
     readonly bead: "var(--game-ui-radius-bead)";
     readonly control: "var(--game-ui-radius-control)";
     readonly card: "var(--game-ui-radius-card)";