@sigx/lynx-motion 0.1.0 → 0.1.2

package/README.md

@@ -1,8 +1,8 @@
 # @sigx/lynx-motion
 
-Spring and tween animation drivers for [SignalX](https://github.com/signalxjs) on Lynx, built directly on `SharedValue` from [`@sigx/lynx`](../lynx). One customer of the cross-thread bridge alongside gestures and scroll.
+Spring and tween animation drivers for [SignalX](https://github.com/signalxjs) on Lynx, built directly on `SharedValue` from [`@sigx/lynx`](https://github.com/signalxjs/lynx/tree/main/packages/lynx). One customer of the cross-thread bridge alongside gestures and scroll.
 
-The differentiator: animation progress is **observable from the background thread** for free. Mutate a `SharedValue` on MT via `withSpring(sv, target)` — the existing diff/publish bridge ships every frame to a BG-side sigx `signal`, so `effect(() => sv.value)` re-runs reactively. Neither `framer-motion` nor `@lynx-js/motion` offers this today; their value primitives are MT-only.
+The differentiator: animation progress is **observable from the background thread** for free. Mutate a `SharedValue` on MT via `withSpring(sv, target)` — the existing diff/publish bridge ships every frame to a BG-side sigx `signal`, so `effect(() => sv.value)` re-runs reactively.
 
 ## Installation
 
@@ -48,7 +48,7 @@ const App = component(() => {
 });
 ```
 
-`useAnimatedStyle(elRef, sv, 'translateX')` is required for the bound element to actually move — `withSpring` only writes the SharedValue; the style binding registry (Phase 2.5) is what applies the transform.
+`useAnimatedStyle(elRef, sv, 'translateX')` is required for the bound element to actually move — `withSpring` only writes the SharedValue; the style binding registry is what applies the transform.
 
 ## API
 
@@ -148,7 +148,7 @@ Underneath `animate()`. Exposed for advanced use (driving non-SharedValue values
 
 Built-in: `linear`, `easeIn`, `easeOut`, `easeInOut`, `circIn`, `circOut`, `circInOut`, `backIn`, `backOut`, `backInOut`, `anticipate`. Plus `cubicBezier(x1, y1, x2, y2)` and the `mirrorEasing` / `reverseEasing` modifiers.
 
-Tween animations always use the built-in `easeOut`. Custom easing functions can't be passed directly: function references don't survive the worklet `_c` capture across the MT/BG bridge — they'd arrive on MT as `undefined`. If you need a non-built-in curve, either pick a different built-in or wait for `registerEasing(name, fn)` (filed as a follow-up in `NEXT-STEPS.md`).
+Tween animations always use the built-in `easeOut`. Custom easing functions can't be passed directly: function references don't survive the worklet `_c` capture across the MT/BG bridge — they'd arrive on MT as `undefined`. If you need a non-built-in curve, pick a different built-in.
 
 ## Cancellation behavior
 
@@ -165,17 +165,11 @@ Animations tick via `requestAnimationFrame`. Lynx's worklet runtime installs `gl
 - **Scalar `SharedValue<number>` only** for v0.1. 2D values (`{x, y}`) need parallel `animate()` calls (one per axis) for now.
 - **No velocity-carry across animations.** When a new `animate()` cancels an in-flight one, the new one starts at velocity 0. Motion's `MotionValue` tracks velocity to support seamless gesture-to-spring handoff; sigx's `SharedValue` doesn't yet (would require extending `SharedValueState<T>` from `{ value }` to `{ value, velocity }`). Add iff a real use case needs it.
 - **No duration→physics resolution** (motion's `findSpring`). Spring options are physics-only (stiffness/damping/mass). `{ duration, bounce }` not supported. Add iff users want it.
-- **No keyframes / sequences / stagger.** Spring + tween cover gesture-driven UI. The richer orchestration surface (variants, layout, presence, scroll-driven) lives in upstream `@lynx-js/motion` if you need it.
-
-## Why we ported instead of using upstream
-
-`@lynx-js/motion` ships two entry points: `.` (full, ~200 LOC of thin wrappers around `framer-motion` + `motion-dom`) and `./mini` (lean, ~250 LOC self-contained). Phase 2.6 spiked hosting motion-mini directly on top of sigx via a shim and reverted because the bring-up required eight cumulative pipeline concessions, two with silent-fragility risk (semantic-approximation `useEffect`/`useMemo` shims and an rspack `sideEffects` override of motion's metadata).
-
-Porting motion-mini's algorithmic content (spring solver, easings, animate orchestration — ~250 LOC of Apache-2.0 math) was the cleaner path: faithful semantics we own, a sigx-shaped API, and the BG-observable `SharedValue` integration becomes first-class. See `PHASE-2.6-LAYERING-PLAN.md` "What we tried and reverted" for the spike write-up and `PHASE-2.7-MOTION-PLAN.md` "Why mini, not full motion" for the design rationale.
+- **No keyframes / sequences / stagger.** Spring + tween cover gesture-driven UI today.
 
 ## Attribution
 
-Spring solver and easing functions are ported from [`@lynx-js/motion`](https://github.com/lynx-family/lynx-stack/tree/main/packages/motion) v0.0.3, [`motion-dom`](https://github.com/motiondivision/motion/tree/main/packages/motion-dom) v12.23.12, and [`motion-utils`](https://github.com/motiondivision/motion/tree/main/packages/motion-utils) v12.23.6 — all Apache-2.0. The cubic bezier code is in turn modified from Gaëtan Renaudeau's [`bezier-easing`](https://github.com/gre/bezier-easing) (MIT). Full attribution in [`THIRD_PARTY_NOTICES.md`](../../THIRD_PARTY_NOTICES.md).
+Spring solver and easing functions are ported from [`@lynx-js/motion`](https://github.com/lynx-family/lynx-stack/tree/main/packages/motion) v0.0.3, [`motion-dom`](https://github.com/motiondivision/motion/tree/main/packages/motion-dom) v12.23.12, and [`motion-utils`](https://github.com/motiondivision/motion/tree/main/packages/motion-utils) v12.23.6 — all Apache-2.0. The cubic bezier code is in turn modified from Gaëtan Renaudeau's [`bezier-easing`](https://github.com/gre/bezier-easing) (MIT).
 
 ## License
 

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@sigx/lynx-motion",
-  "version": "0.1.0",
-  "description": "Animation primitives for sigx-lynx — spring/tween drivers built on AnimatedValue",
+  "version": "0.1.2",
+  "description": "Animation primitives for sigx-lynx — spring/tween drivers built on SharedValue",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
   "files": [
     "src",
@@ -21,7 +24,7 @@
     "motion"
   ],
   "author": "Andreas Ekdahl",
-  "license": "MIT",
+  "license": "(MIT AND Apache-2.0)",
   "dependencies": {
     "@sigx/lynx": "^0.1.4"
   },
@@ -29,8 +32,8 @@
     "@lynx-js/react": "^0.119.0",
     "typescript": "^6.0.3",
     "vite": "^8.0.12",
-    "@sigx/lynx-plugin": "^0.2.7",
-    "@sigx/lynx-runtime-main": "^0.2.7"
+    "@sigx/lynx-runtime-main": "^0.2.7",
+    "@sigx/lynx-plugin": "^0.2.7"
   },
   "repository": {
     "type": "git",