@pieai/swimmer-ui-kit 1.10.0 → 1.11.0

package/donors-individual.md

@@ -23,29 +23,40 @@ never a checkout from `_donors-individual/for_SwimmerUIKit/`.
 
 ### Review and adoption boundary
 
-The current SwimmerUIKit implementation is local code; its Move physics is
-adapted into `src/liquidGooeyMove.ts`; no upstream files are vendored or imported
-at runtime. The reviewed scope is the donor
+The current SwimmerUIKit implementation is local code; no upstream files are
+vendored or imported at runtime. The reviewed scope is the donor
 package's `README.md`, `package.json`, `LICENSE`, and `src/**` so the kit can
-trace the morph design and implementation patterns that informed
-`src/LiquidGroup.tsx` and its supporting modules.
+trace the retained implementation in `src/LiquidGroup.tsx` and its supporting
+modules.
 
 Patterns retained in the local implementation are the SVG
 silhouette/content split, Gaussian blur plus alpha color-matrix filtering,
 rounded-rectangle geometry, token-compatible shadow passes, spring-to-easing
 compilation, and the donor's Move center/stretch/tail physics. SwimmerUIKit
-adopted only the donor's Move physics for the selected indicator and progress
-leading edge; it deliberately did not take the donor's Melt, Bend, or dissolve
-systems, general observer, or image-melt engine. The
-local implementation now also adopts the donor's group-level `waviness` and
-`wavinessFreq` filter pass as a static, fixed-seed surface texture. These two
-capabilities were previously missing from both the retained list and the
-rejected list: that was an omission in the review record, not a decision to
-reject them. The kit keeps its own token-driven values, process-wide animation
-and filter-area budgets, an idle-sleeping shared animation clock, and its own
-interaction boundary; see `NOTICE` for the legal attribution. The static
-texture never adds an ambient clock, and its maximum displacement is included
-in the filter-area budget.
+adopted those Move physics for the selected indicator and progress leading
+edge, and now directly adapts the donor's Morph shape evolution,
+`contentBlur` content-layer cross-blur, Bend's velocity-bowed path plus
+`--lg-bend-x` / `--lg-bend-y` / `--lg-bend-xn` / `--lg-bend-yn` CSS-variable
+outlet, and the donor's group-level `waviness` and `wavinessFreq` filter pass as
+a static, fixed-seed surface texture.
+
+SwimmerUIKit also adapts the donor's pairwise image-melt engine into
+`src/liquidGooeyImageMelt.tsx`. That module carries the first two
+`effect="melt"` images, the two-palette colour/marbling pass, and the
+image-only contact `dissolve` layer. The dissolve math is a scoped adaptation
+of the donor's contact-observer behavior; it is not a transplant of the
+donor's observer. Morph shape is deliberately token-on so the adopted default
+is visible; callers can pass `morph={{ shape: false }}` to opt out.
+
+Morph content blur, Bend's maximum deformation, Melt marbling, and dissolve
+displacement are included in the filter-area accounting. No retained effect
+adds an ambient clock. The donor's general observer remains outside the
+imported scope because SwimmerUIKit already has its own process-wide
+animation/filter-area budgets and a shared requestAnimationFrame loop that
+sleeps when idle. Replacing that loop would lose the kit's explicit budget and
+idle-sleep guarantees. The local implementation keeps its own interaction
+boundary, token-driven values, graceful budget degradation, and one-time
+development warning; see `NOTICE` for legal attribution.
 
 ### Update policy
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/swimmer-ui-kit",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Token-driven React game UI kit for web and wrapped PieAI game surfaces.",
   "keywords": [
     "design-system",