@pieai/swimmer-ui-kit 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -3,6 +3,51 @@
 All notable changes to `@pieai/swimmer-ui-kit`.
 Format: [Keep a Changelog](https://keepachangelog.com); versioning: semver.
 
+## 2.3.0 — 2026-09-11
+
+Minor: additive, plus one token value change on the default liquid fill.
+
+### Added
+
+- **`scaleY` on `LiquidGroup.Item`.** The two scale axes can now disagree, which
+  is what squash and stretch needs. A body that spreads sideways as it is pushed
+  down is made of something; one that scales uniformly is a thing getting
+  smaller.
+
+- **`wobbly` transition preset.** Damping ratio 0.24 against `bouncy`'s 0.48, so
+  a pressed body crosses its rest shape three or four times instead of once —
+  the difference between 「it bounced」 and 「it is made of something」. `press`
+  and `settle` use it.
+
+- **A Liquid surface section in `GameUiPreview`.** The showcase had a section
+  for the WebGL metal CTA, which no product uses, and none for the surface that
+  actually ships — so the only way to see a liquid button was to know which
+  screen of which product happened to render one.
+
+### Changed
+
+- **The default liquid fill is `--game-ui-accent-pale`, not
+  `--game-ui-surface-raised`.** `surface-raised` is the right fill for a flat
+  secondary button and the wrong one for a liquid body: the whole point of this
+  surface is a shape you can see, and a near-white shape on a cream panel has no
+  shape at all. It was invisible next to its own flat twin while every coloured
+  tone read clearly. A product that wants the old fill sets
+  `--game-ui-liquid-surface-fill` back.
+
+- **The button lip is shallower at compact density.** Height reads as height
+  because there is room around it; four solid bands stacked close together in a
+  34px row read as ruled lines instead of as four keys.
+
+### Not shipped
+
+A jelly material — four lighting terms, hue-preserving sheen, luminance-scaled
+headroom — was built, reviewed against the 2.2.0 look, and rejected: it read as
+too abrupt on a coloured body, and the existing single specular pass was better.
+The motion from that work is what shipped. The material is in the history at
+`ab3d706` if a surface ever wants it, and the two measured dead ends behind it
+are worth keeping: multiplying the fill by a diffuse term darkens a brand colour
+to ceramic, and adding white light at gel strength desaturates it to cream.
+
 ## 2.2.0 — 2026-09-11
 
 Minor, not major: nothing published is removed or renamed, and no `--game-ui-*`

package/dist/index.d.ts

@@ -2503,6 +2503,12 @@ export declare interface LiquidItemProps extends Omit<HTMLAttributes<HTMLDivElem
     x?: number;
     y?: number;
     scale?: number;
+    /**
+     * Vertical scale, when it should differ from `scale`. A body that squashes
+     * wider as it gets shorter reads as jelly; one that scales uniformly reads
+     * as a thing getting smaller.
+     */
+    scaleY?: number;
     /** Spring preset/config or an explicit duration/easing pair. */
     transition?: Transition;
     /** Delay before this item starts its group-clock transition, in ms. */
@@ -2649,6 +2655,6 @@ declare type Transition = TransitionPreset | SpringConfig | {
     ease?: string;
 };
 
-declare type TransitionPreset = 'snappy' | 'smooth' | 'bouncy';
+declare type TransitionPreset = 'snappy' | 'smooth' | 'bouncy' | 'wobbly';
 
 export { }