@onlynative/inertia 0.0.1-alpha.6 → 0.0.1-alpha.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/llms.txt +7 -4
- package/package.json +1 -1
package/llms.txt
CHANGED
|
@@ -46,6 +46,7 @@ import { MotionScrollView } from '@onlynative/inertia/scroll-view'
|
|
|
46
46
|
- `useTransform(value, inputRange, outputRange, options?)` / `useTransform(transformer)` — interpolate a numeric shared value onto a number or color range, or derive any value from any number of shared values via a worklet. Non-worklet transformers are auto-wrapped.
|
|
47
47
|
- `useScroll()` — returns `{ scrollX, scrollY, onScroll }` for use with `Motion.ScrollView`. Scroll events fire on the UI thread.
|
|
48
48
|
- `createMotionComponent<C>(C)` — wrap any component with the same Motion prop surface, inferring style from `C`.
|
|
49
|
+
- `buildReleaseAnimation(transition, toValue)` — worklet-safe single-step animation builder (spring / timing / decay / no-animation). For assigning Inertia-resolved animations to shared values from inside a gesture worklet. Used internally by `@onlynative/inertia-gestures`'s `useDrag({ onRelease })`.
|
|
49
50
|
|
|
50
51
|
## Motion props
|
|
51
52
|
|
|
@@ -58,7 +59,7 @@ import { MotionScrollView } from '@onlynative/inertia/scroll-view'
|
|
|
58
59
|
| `type` | Public config | Default? |
|
|
59
60
|
| ---------------- | ---------------------------------------------------------------- | -------- |
|
|
60
61
|
| `'spring'` | `tension`, `friction`, `mass`, `velocity`, `delay`, `repeat` | yes |
|
|
61
|
-
| `'timing'` | `duration`, `easing
|
|
62
|
+
| `'timing'` | `duration`, `easing` (`EasingFunction` or Reanimated 4 `EasingFunctionFactory` — `Easing.bezier(...)` works directly, no `.factory()` call needed), `delay`, `repeat` | |
|
|
62
63
|
| `'decay'` | `velocity`, `deceleration`, `clamp`, `delay` | |
|
|
63
64
|
| `'no-animation'` | — | |
|
|
64
65
|
|
|
@@ -111,9 +112,11 @@ transition={{
|
|
|
111
112
|
|
|
112
113
|
## Animatable properties (alpha)
|
|
113
114
|
|
|
114
|
-
Numeric: `opacity`, `translateX`, `translateY`, `scale`, `scaleX`, `scaleY`, `rotate`, `rotateX`, `rotateY`, `width`, `height`, `borderRadius`. Rotation values are degrees; the factory wraps them as `'${value}deg'`. `rotateX` / `rotateY` need a sibling `perspective` style entry to render in 3D.
|
|
115
|
+
Numeric: `opacity`, `translateX`, `translateY`, `scale`, `scaleX`, `scaleY`, `rotate`, `rotateX`, `rotateY`, `width`, `height`, `borderRadius`, `shadowOpacity`, `shadowRadius`, `elevation`. Rotation values are degrees; the factory wraps them as `'${value}deg'`. `rotateX` / `rotateY` need a sibling `perspective` style entry to render in 3D.
|
|
115
116
|
|
|
116
|
-
Color: `backgroundColor`, `borderColor`, `color`, `tintColor` (Image only)
|
|
117
|
+
Color: `backgroundColor`, `borderColor`, `color`, `tintColor` (Image only), `shadowColor`. Hex, `rgb()` / `rgba()`, `hsl()` / `hsla()`, and named colors all work; the target string is forwarded straight through `withSpring` / `withTiming` and Reanimated handles RGBA interpolation natively.
|
|
118
|
+
|
|
119
|
+
Nested object: `shadowOffset: { width, height }`. The only nested-object style on the surface — internally decomposes into two synthetic axis SVs that the worklet recomposes into a single `shadowOffset` prop. v0.1 supports the **single-value form only** (`{ width: 0, height: 4 }`); sequences / array keyframes / per-axis transition splits are out of scope, drop to `useMotionValue` for those.
|
|
117
120
|
|
|
118
121
|
Auto-layout transitions ship via the `layout` prop (`true` / `TransitionConfig`) on every `Motion.*` primitive — see Layout. Shared element transitions (`layoutId`) are deferred: Reanimated 4 dropped the `sharedTransitionTag` API the previous design relied on.
|
|
119
122
|
|
|
@@ -121,7 +124,7 @@ Auto-layout transitions ship via the `layout` prop (`true` / `TransitionConfig`)
|
|
|
121
124
|
|
|
122
125
|
- `@onlynative/inertia-gradients` — `MotionLinearGradient` over `expo-linear-gradient`. Animatable: `colors`, `start`, `end`, `locations`.
|
|
123
126
|
- `@onlynative/inertia-svg` — `MotionPath` over `react-native-svg`. Animatable: `d` (path morphing on structurally-compatible paths), `fill`, `stroke`, `strokeWidth`, opacities, `strokeDashoffset`. Source and target paths must share the same command sequence after implicit-repeat expansion; remount with `key` to switch shape.
|
|
124
|
-
- `@onlynative/inertia-gestures` — `useDrag`, `useSwipe`, `usePan` over `react-native-gesture-handler`.
|
|
127
|
+
- `@onlynative/inertia-gestures` — `useDrag`, `useSwipe`, `usePan` over `react-native-gesture-handler`. `useDrag` accepts an `onRelease` worklet that returns per-axis Inertia release transitions (snap-to-tick spring, decay with bounds, etc.) — the release velocity stays on the UI thread, no JS round-trip.
|
|
125
128
|
|
|
126
129
|
## Docs
|
|
127
130
|
|
package/package.json
CHANGED