npm / blobatar
blobatar
What changed in blobatar 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-28.
2 breaking21 new APIs and options1 tooling1 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initblobatar 225 changes
Breaking changes 2
Adds an explicit target option; pointer following is not the default, and the default target is null.
Travel is read as an arc rather than a slide; larger values now saturate at the limb instead of leaving the head.
New APIs and options 21
Adds a gaze driver for pointer- or target-driven eye movement, with lookAt control and stop teardown.
Adds a separate stylesheet for the gaze layer; importing it without a pointer driver resolves to the identity.
Exports survey and Face, exposing the fitted head geometry and eye marks used by gaze projection.
Lets the gaze driver stand down the idle saccade while a blobatar is being watched.
Sets gaze excursion in viewBox units; larger values saturate at the limb instead of letting the eyes leave the head.
Exports pure projection arithmetic for renderers that need to solve frames out of order.
Exports pure pursuit arithmetic for renderers that need to solve frames out of order.
Adds a caller-controlled boolean to turn ambient motion on or off; it defaults to false and ramps over 400ms.
New core entry point exposes idle-loop timing and transform composition for the animated layer.
Adds the _marks export, exposing the figure as drawing primitives for React Native rendering.
Adds the _posed export, exposing pose values as numbers rather than baking them into geometry.
New React Native and Expo adapter renders blobatars through react-native-svg; size is required and animate is unavailable on the root component.
New entry point provides React Native components with ambient motion and expression morphing; its optional Reanimated peer dependencies are needed only by this subpath.
Adds hex-color fading support for expression morphing.
Evaluates all seven idle loops as a pure function of elapsed time.
Composes idle loops onto the nesting levels decorated by the stylesheet.
Adds pose interpolation for expression morphing without regenerating path data.
New React Native component animates expression changes using the stylesheet's clocks and curve, and interrupts from the face's current pose.
Provides one derivation for seeded motion timings used by motionVars and the idle layer, keeping motion offsets aligned across platforms.
Adds pose composition for morphing without regenerating path data.
Optional peer dependency required only by the animated subpath.
Tooling 1
Optional peer dependency required only by the animated subpath.
Fixes and other changes 1
The Solid adapter now updates the existing SVG in place on prop changes and preserves the server-rendered element during hydration.