@pieai/swimmer-ui-kit 1.11.3 → 2.1.0

package/CHANGELOG.md

@@ -3,7 +3,64 @@
 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
+
+Major, not minor. The release removes a member from a public union type, so a
+consumer inside a `^1` range would have broken at compile time on an automatic
+update — the exact failure semver's major bump exists to prevent. That the
+removed member never worked makes the removal correct, not non-breaking.
+
+### Breaking
+
+- **`LiquidGroup.Item` no longer accepts `effect="move"`.** The public union
+  listed `'move'` but the engine only understands Morph and Bend. Passing it
+  silently rendered Morph. Move already lives on the group as
+  `motion="follow"` (the selected indicator and progress leading edge). An API
+  that accepts a parameter and does nothing is worse than no API, so the
+  dead member is gone rather than implemented as a second Move entry. TypeScript
+  consumers who followed the donor README now get a type error. A leftover
+  string at runtime still warns, and `dissolve` on that leftover is still
+  ignored.
+
+### Fixed
+
+- **Outer drop shadows left the SVG filter.** `--game-ui-shadow-button`'s
+  `0 13px 26px` layer was a full-region `feGaussianBlur` whose radius also
+  inflated the filter pad. The donor had already moved that class of shadow to
+  CSS `drop-shadow()` on the compositor (same math: blur-radius = 2σ) because
+  WebKit CPU-rasterises large SVG blurs. Inset and spread stay in SVG; they
+  are not expressible as `drop-shadow()` and they are cheap. The pad no longer
+  reserves the outer blur. Visual comparison of the segmented indicator and
+  the merged-blob story is in `SHADOW-COST.md`.
+
+- **Two authoring warnings were still dead in the published bundle.** 1.11.2
+  unblocked the budget warnings; `LiquidGroup.Item` children-with-border and
+  dissolve-on-move were still gated on `import.meta.env.DEV`, which is false
+  in this package's build. `scripts/check-warnings-survive-build.mjs` now
+  covers those two messages and names which one is missing. Verified by
+  reintroducing the DEV gate and watching the check fail on `[item-border]`
+  and `[dissolve-on-move]`.
+
+### Changed
+
+- `donors-individual.md` now records the compositor shadow split as adopted,
+  and lists the remaining missed donor capabilities as missed — not as if they
+  had been rejected. `will-change: filter, transform` on the silhouette is
+  included with the split.
 
 ## 1.11.3
 

package/NOTICE

@@ -57,8 +57,11 @@ NOTICE pointer. We also adapted the donor's Move center spring, velocity-axis
 stretch, and lagging tail/mid-droplet physics for the selected segmented
 indicator and progress leading edge. This package directly adapts the donor's
 group-level `waviness` / `wavinessFreq` filter pass: a fixed-seed `feTurbulence`
-field and `feDisplacementMap` move the silhouette before its shadow passes
-consume it, so the shadow follows the same edge.
+field and `feDisplacementMap` move the silhouette before its remaining SVG
+shadow passes consume it. Blurred outer shadows without spread follow the
+donor's compositor split: they are CSS `drop-shadow()` on the silhouette
+element, so they are not in the SVG filter region or its pad. Inset and
+spread layers remain SVG-resident.
 
 The local implementation also adapts the donor's pairwise image-melt engine in
 `src/liquidGooeyImageMelt.tsx`, including the two-item pairing, measured image

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)";
@@ -2415,8 +2432,11 @@ export declare interface LiquidItemProps extends Omit<HTMLAttributes<HTMLDivElem
     delay?: number;
     /** Override the measured content border radius for the silhouette. */
     radius?: number | CornerRadii;
-    /** Select the adopted item surface behavior. Bend follows child geometry. */
-    effect?: 'morph' | 'move' | 'melt' | 'bend';
+    /**
+     * Select the adopted item surface behavior. Bend follows child geometry.
+     * Move is a group gesture (`motion="follow"`), not an item effect.
+     */
+    effect?: 'morph' | 'melt' | 'bend';
     /** Morph shape, tempo, bounce, and content cross-blur tuning. */
     morph?: MorphTuning;
     /** Bend strengths for vertical bow and horizontal cap deformation. */