# What changed in blobatar

> 25 changes in blobatar 2 from its official release notes, upgrade guides and advisories: 2 breaking, 21 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/blobatar/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## blobatar 2

### Breaking changes

- Adds an explicit target option; pointer following is not the default, and the default target is null. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Travel is read as an arc rather than a slide; larger values now saturate at the limb instead of leaving the head. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)

### New APIs and options

- Adds a gaze driver for pointer- or target-driven eye movement, with lookAt control and stop teardown. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Adds a separate stylesheet for the gaze layer; importing it without a pointer driver resolves to the identity. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Exports survey and Face, exposing the fitted head geometry and eye marks used by gaze projection. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Lets the gaze driver stand down the idle saccade while a blobatar is being watched. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Sets gaze excursion in viewBox units; larger values saturate at the limb instead of letting the eyes leave the head. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Exports pure projection arithmetic for renderers that need to solve frames out of order. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Exports pure pursuit arithmetic for renderers that need to solve frames out of order. (2.6.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#260)
- Adds a caller-controlled boolean to turn ambient motion on or off; it defaults to false and ramps over 400ms. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- New core entry point exposes idle-loop timing and transform composition for the animated layer. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Adds the _marks export, exposing the figure as drawing primitives for React Native rendering. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Adds the _posed export, exposing pose values as numbers rather than baking them into geometry. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- New React Native and Expo adapter renders blobatars through react-native-svg; size is required and animate is unavailable on the root component. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- New entry point provides React Native components with ambient motion and expression morphing; its optional Reanimated peer dependencies are needed only by this subpath. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Adds hex-color fading support for expression morphing. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Evaluates all seven idle loops as a pure function of elapsed time. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Composes idle loops onto the nesting levels decorated by the stylesheet. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Adds pose interpolation for expression morphing without regenerating path data. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- New React Native component animates expression changes using the stylesheet's clocks and curve, and interrupts from the face's current pose. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Provides one derivation for seeded motion timings used by motionVars and the idle layer, keeping motion offsets aligned across platforms. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Adds pose composition for morphing without regenerating path data. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)
- Optional peer dependency required only by the animated subpath. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)

### Tooling

- Optional peer dependency required only by the animated subpath. (2.5.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#250)

### Fixes and other changes

- The Solid adapter now updates the existing SVG in place on prop changes and preserves the server-rendered element during hydration. (2.7.0) — [release notes](https://github.com/Alain00/blobatar/blob/0542589b8f85a749cd13497b092e2c13c4972b56/packages/blobatar/CHANGELOG.md#270)
