@juleshry/vue-animejs 0.4.3 → 1.0.0

package/README.md

@@ -1,13 +1,12 @@
 <div align="center">
-  <img src="./docs/src/public/icon.png" alt="vue-animejs" width="120" />
+  <img src="./docs/src/public/icon-animated.svg" alt="vue-animejs" width="120" />
 
   <h1 align="center">vue-animejs</h1>
   <p align="center">Vue 3 composables for <a href="https://animejs.com/">Anime.js</a> v4 — reactive animations that integrate naturally with Vue's reactivity system and component lifecycle.</p>
+  <p align="center"><a href="https://vue-animejs.juleshry.dev">📖 Documentation</a></p>
+  <p align="center"><a href="https://app.netlify.com/projects/vue-animejs/deploys"><img src="https://api.netlify.com/api/v1/badges/8017f5b4-47b7-45e4-a5d6-269d638a71ab/deploy-status" alt="Netlify Status" style="vertical-align: middle" /></a>&nbsp;&nbsp;<a href="https://ko-fi.com/C7O720SP29"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ko-fi" style="vertical-align: middle" /></a></p>
 </div>
 
-> [!WARNING]
-> This library is a work in progress. The API is not stable and may change at any time.
-
 ## 🚀 Overview
 
 **vue-animejs** wraps Anime.js v4 as idiomatic Vue 3 composables. It integrates with Vue's reactivity system — pass a `ref` as a target or option and the animation updates automatically. Lifecycle cleanup is handled for you.
@@ -66,16 +65,20 @@ useAnimate(el, { translateX: 250, duration: 800 })
 
 ## 🦄 Composables
 
-| Composable      | Description                                       |
-|-----------------|---------------------------------------------------|
-| `useAnimate`    | Animate a DOM target with reactive params         |
-| `useTimer`      | Drive a timer with full playback control          |
-| `useTimeline`   | Sequence multiple animations on a shared timeline |
-| `useAnimatable` | Create a reactive animatable object               |
-| `useDraggable`  | Make a DOM element draggable with full control    |
-| `useLayout`     | Animate DOM layout changes (reorder, add, remove) |
-| `useScope`      | Create an Anime.js scope with lifecycle management |
-| `useText`       | Split text into animatable lines, words, and chars |
+| Composable       | Description                                       |
+|------------------|---------------------------------------------------|
+| `useAnimate`     | Animate a DOM target with reactive params         |
+| `useRawAnimate`  | Thin wrapper around Anime.js `animate()` with ref unwrapping |
+| `useTimer`       | Drive a timer with full playback control          |
+| `useTimeline`    | Sequence multiple animations on a shared timeline |
+| `useWaapi`       | Animate via the Web Animations API (WAAPI)        |
+| `useAnimatable`  | Create a reactive animatable object               |
+| `useDraggable`   | Make a DOM element draggable with full control    |
+| `useLayout`      | Animate DOM layout changes (reorder, add, remove) |
+| `useScope`       | Create an Anime.js scope with lifecycle management |
+| `useSvg`         | SVG utilities: morph paths and motion path         |
+| `useSvgDrawable` | Animate SVG stroke drawing with the `draw` property |
+| `useText`        | Split text into animatable lines, words, and chars |
 
 ## 🚀 Usage
 
@@ -132,6 +135,24 @@ play()
 </script>
 ```
 
+### `useRawAnimate`
+
+```vue
+<script setup lang="ts">
+import { useTemplateRef } from 'vue'
+import { useRawAnimate } from '@juleshry/vue-animejs'
+
+const el = useTemplateRef<HTMLElement>('el')
+
+// Returns the raw Anime.js JSAnimation instance directly
+const animation = useRawAnimate(el, { translateX: 250, duration: 800 })
+</script>
+
+<template>
+  <div ref="el" />
+</template>
+```
+
 ### `useAnimatable`
 
 ```vue
@@ -148,6 +169,89 @@ const { animatable } = useAnimatable(el, {
 </script>
 ```
 
+### `useWaapi`
+
+```vue
+<script setup lang="ts">
+import { useTemplateRef } from 'vue'
+import { useWaapi } from '@juleshry/vue-animejs'
+
+const el = useTemplateRef<HTMLElement>('el')
+
+const { play, pause } = useWaapi(el, {
+  translateX: 250,
+  duration: 800,
+  easing: 'easeInOutQuad',
+})
+</script>
+
+<template>
+  <div ref="el" />
+  <button @click="play">Play</button>
+  <button @click="pause">Pause</button>
+</template>
+```
+
+### `useSvg`
+
+> **Note:** `morphTo` requires a live DOM element. Add each target as a hidden `<path>`, pass the ref directly to `morphTo`, and wrap in a `computed` — `useTimeline.add()` accepts `MaybeRef<AnimationParams>` and resolves the computed after mount, when the target elements are available.
+
+```vue
+<script setup lang="ts">
+import { computed, useTemplateRef } from 'vue'
+import { useSvg, useTimeline } from '@juleshry/vue-animejs'
+
+const shape = useTemplateRef<SVGPathElement>('shape')
+const t_circle = useTemplateRef<SVGPathElement>('t-circle')
+const t_diamond = useTemplateRef<SVGPathElement>('t-diamond')
+
+const { morphTo } = useSvg()
+
+const { add } = useTimeline({
+  loop: true,
+  defaults: { duration: 1200, easing: 'easeInOutCubic' },
+  loopDelay: 500,
+})
+
+add(shape, computed(() => ({ d: morphTo(t_circle) })))
+  .add(shape, computed(() => ({ d: morphTo(t_diamond) })), '+=500')
+</script>
+
+<template>
+  <svg viewBox="0 0 100 100">
+    <path ref="shape" d="M 50 15 C 78 8, 95 28, 90 52 C 85 76, 68 90, 50 88 C 32 90, 15 76, 10 52 C 5 28, 22 8, 50 15 Z" />
+    <path ref="t-circle" d="M 50 10 C 72 10, 90 28, 90 50 C 90 72, 72 90, 50 90 C 28 90, 10 72, 10 50 C 10 28, 28 10, 50 10 Z" visibility="hidden" />
+    <path ref="t-diamond" d="M 50 5 C 54 32, 68 32, 95 50 C 68 68, 54 68, 50 95 C 46 68, 32 68, 5 50 C 32 32, 46 32, 50 5 Z" visibility="hidden" />
+  </svg>
+</template>
+```
+
+### `useSvgDrawable`
+
+```vue
+<script setup lang="ts">
+import { useTemplateRef } from 'vue'
+import { useAnimate, useSvgDrawable } from '@juleshry/vue-animejs'
+
+const circle_el = useTemplateRef<SVGCircleElement>('circle')
+
+const { drawable } = useSvgDrawable(circle_el)
+
+// draw values are normalised: 0 = hidden, 1 = fully drawn
+useAnimate(drawable, {
+  draw: ['0 0', '0.5 1', '0 1'],
+  duration: 1200,
+  easing: 'easeInOutQuad',
+})
+</script>
+
+<template>
+  <svg viewBox="0 0 100 100">
+    <circle ref="circle" cx="50" cy="50" r="40" fill="none" stroke="currentColor" stroke-width="4" />
+  </svg>
+</template>
+```
+
 ### `useDraggable`
 
 ```vue
@@ -295,10 +399,10 @@ See the [Contributing Guide](./CONTRIBUTING.md).
 ## 🗺️ TODO
 
 - [ ] Allow reactive refs inside option objects
-- [ ] Publish the first version to `npm`
-- [ ] Write Doc
-- [ ] Deploy the docs website
+- [ ] Finish doc website
+- [ ] Add components
+- [ ] Add directives
 
 ## 📄 License
 
-[MIT](./LICENSE.md) © 2025-present [Jules Hery](https://github.com/juleshry)
+[MIT](./LICENSE.md) © 2025-present [Jules Hery](https://github.com/juleshry)

package/dist/composables/use-animatable.d.ts

@@ -1,8 +1,17 @@
-import { type AnimatableObject, type AnimatableParams, type TargetsParam } from "animejs";
+import { type AnimatableObject, type AnimatableParams } from "animejs";
 import { type DeepReadonly, type MaybeRef, type ShallowRef } from "vue";
+import { type AnimationTargets } from "@src/utils/resolve-target.ts";
 export interface UseAnimatableReturn {
+    /** The underlying Anime.js animatable instance. `undefined` until the target is available. */
     animatable: DeepReadonly<ShallowRef<AnimatableObject | undefined>>;
+    /** Cancels the animatable and restores all animated properties to their original values. */
     revert: () => AnimatableObject | undefined;
 }
-export declare function useAnimatable(targets: MaybeRef<TargetsParam>, options?: MaybeRef<AnimatableParams>): UseAnimatableReturn;
+/**
+ * Wraps Anime.js `createAnimatable()` into a Vue composable. Reactively re-creates the animatable when the target or options change, and reverts it automatically on unmount.
+ *
+ * @param targets - The element(s) to make animatable. Accepts a template ref, a CSS selector, a DOM element, or a reactive ref to any of these.
+ * @param options - Anime.js animatable parameters. Accepts a plain object or a reactive ref / computed. Defaults to `{}`.
+ */
+export declare function useAnimatable(targets: AnimationTargets, options?: MaybeRef<AnimatableParams>): UseAnimatableReturn;
 //# sourceMappingURL=use-animatable.d.ts.map

package/dist/composables/use-animatable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-animatable.d.ts","sourceRoot":"","sources":["../../src/composables/use-animatable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAoB,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3G,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,QAAQ,EAEb,KAAK,UAAU,EAIhB,MAAM,KAAK,CAAA;AAGZ,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAA;IAClE,MAAM,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAA;CAC3C;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,gBAAgB,CAAM,GACvC,mBAAmB,CAkCrB"}
+{"version":3,"file":"use-animatable.d.ts","sourceRoot":"","sources":["../../src/composables/use-animatable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAuC,MAAM,SAAS,CAAA;AAC3G,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,QAAQ,EAEb,KAAK,UAAU,EAIhB,MAAM,KAAK,CAAA;AAEZ,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,8BAA8B,CAAA;AAEnF,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAA;IAClE,4FAA4F;IAC5F,MAAM,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAA;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,QAAQ,CAAC,gBAAgB,CAAM,GACvC,mBAAmB,CAkCrB"}

package/dist/composables/use-animate.d.ts

@@ -1,6 +1,6 @@
 import { type DeepReadonly, type MaybeRef, type ShallowRef } from "vue";
-import { type JSAnimation, type TargetSelector, type AnimationParams } from "animejs";
-import { type MaybeComputedElementRef } from "@vueuse/core";
+import { type JSAnimation, type AnimationParams } from "animejs";
+import { type AnimationTargets } from "@src/utils/resolve-target.ts";
 export interface UseAnimateReturn {
     /** The underlying Anime.js animation instance. `undefined` until the target is available. */
     animation: DeepReadonly<ShallowRef<JSAnimation | undefined>>;
@@ -37,5 +37,5 @@ export interface UseAnimateReturn {
  * @param _target - The element(s) to animate. Accepts a template ref, a CSS selector, a DOM element, or a reactive ref to any of these.
  * @param _options - Anime.js animation parameters. Accepts a plain object or a reactive ref / computed. Defaults to `{}`.
  */
-export declare function useAnimate(_target: MaybeRef<TargetSelector> | MaybeComputedElementRef, _options?: MaybeRef<AnimationParams>): UseAnimateReturn;
+export declare function useAnimate(_target: AnimationTargets, _options?: MaybeRef<AnimationParams>): UseAnimateReturn;
 //# sourceMappingURL=use-animate.d.ts.map

package/dist/composables/use-animate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-animate.d.ts","sourceRoot":"","sources":["../../src/composables/use-animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAA6C,MAAM,KAAK,CAAA;AAClH,OAAO,EAAE,KAAK,WAAW,EAAW,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9F,OAAO,EAAE,KAAK,uBAAuB,EAAgC,MAAM,cAAc,CAAA;AAEzF,MAAM,WAAW,gBAAgB;IAC/B,6FAA6F;IAC7F,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,CAAA;IAC5D,uCAAuC;IACvC,IAAI,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACnC,mCAAmC;IACnC,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACtC,oDAAoD;IACpD,KAAK,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACpC,iDAAiD;IACjD,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACtC,qDAAqD;IACrD,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACxC,mCAAmC;IACnC,MAAM,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACrC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACvC,mEAAmE;IACnE,MAAM,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACrC,2FAA2F;IAC3F,MAAM,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACrC,gHAAgH;IAChH,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,WAAW,GAAG,SAAS,CAAA;IACvD,wCAAwC;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IACpH,sDAAsD;IACtD,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IACzD,uEAAuE;IACvE,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,uBAAuB,EAC3D,QAAQ,GAAE,QAAQ,CAAC,eAAe,CAAM,GACvC,gBAAgB,CAoGlB"}
+{"version":3,"file":"use-animate.d.ts","sourceRoot":"","sources":["../../src/composables/use-animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAA6C,MAAM,KAAK,CAAA;AAClH,OAAO,EAAE,KAAK,WAAW,EAA8B,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE5F,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,8BAA8B,CAAA;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,6FAA6F;IAC7F,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,CAAA;IAC5D,uCAAuC;IACvC,IAAI,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACnC,mCAAmC;IACnC,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACtC,oDAAoD;IACpD,KAAK,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACpC,iDAAiD;IACjD,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACtC,qDAAqD;IACrD,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACxC,mCAAmC;IACnC,MAAM,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACrC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACvC,mEAAmE;IACnE,MAAM,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACrC,2FAA2F;IAC3F,MAAM,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IACrC,gHAAgH;IAChH,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,WAAW,GAAG,SAAS,CAAA;IACvD,wCAAwC;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IACpH,sDAAsD;IACtD,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IACzD,uEAAuE;IACvE,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,GAAE,QAAQ,CAAC,eAAe,CAAM,GAAG,gBAAgB,CAgGhH"}

package/dist/composables/use-draggable.d.ts

@@ -1,17 +1,35 @@
 import { type DeepReadonly, type MaybeRef, type ShallowRef } from "vue";
-import { type Draggable, type DraggableParams, type TargetsParam, type EasingParam } from "animejs";
+import { type Draggable, type DraggableParams, type EasingParam } from "animejs";
+import { type AnimationTargets } from "@src/utils/resolve-target.ts";
 export interface UseDraggableReturn {
+    /** The underlying Anime.js draggable instance. `undefined` until the target is available. */
     draggable: DeepReadonly<ShallowRef<Draggable | undefined>>;
+    /** Disables drag interactions without destroying the instance. */
     disable: () => void;
+    /** Re-enables drag interactions after `disable()`. */
     enable: () => void;
+    /** Moves the draggable to the given x position. Pass `true` to suppress the update callback. */
     setX: (x: number, muteUpdateCallback?: boolean) => void;
+    /** Moves the draggable to the given y position. Pass `true` to suppress the update callback. */
     setY: (y: number, muteUpdateCallback?: boolean) => void;
+    /** Animates the draggable into the visible viewport. */
     animateInView: (duration?: number, gap?: number, ease?: EasingParam) => void;
+    /** Scrolls the draggable into the visible viewport. */
     scrollInView: (duration?: number, gap?: number, ease?: EasingParam) => void;
+    /** Stops any in-progress snap or momentum animation. */
     stop: () => void;
+    /** Resets the draggable position to its initial state. */
     reset: () => void;
+    /** Cancels the draggable and restores the element to its original state. */
     revert: () => void;
+    /** Re-reads the element's size and container bounds. */
     refresh: () => void;
 }
-export declare function useDraggable(targets: MaybeRef<TargetsParam>, options?: MaybeRef<DraggableParams>): UseDraggableReturn;
+/**
+ * Wraps Anime.js `createDraggable()` into a Vue composable. Reactively re-creates the draggable when the target or options change, and reverts it automatically on unmount.
+ *
+ * @param targets - The element(s) to make draggable. Accepts a template ref, a CSS selector, a DOM element, or a reactive ref to any of these.
+ * @param options - Anime.js draggable parameters. Accepts a plain object or a reactive ref / computed. Defaults to `{}`.
+ */
+export declare function useDraggable(targets: AnimationTargets, options?: MaybeRef<DraggableParams>): UseDraggableReturn;
 //# sourceMappingURL=use-draggable.d.ts.map

package/dist/composables/use-draggable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-draggable.d.ts","sourceRoot":"","sources":["../../src/composables/use-draggable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,KAAK,QAAQ,EAAY,KAAK,UAAU,EAA4B,MAAM,KAAK,CAAA;AAElH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAmB,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAA;IAC1D,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAC5E,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAC3E,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,eAAe,CAAM,GACtC,kBAAkB,CA6EpB"}
+{"version":3,"file":"use-draggable.d.ts","sourceRoot":"","sources":["../../src/composables/use-draggable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,KAAK,QAAQ,EAAY,KAAK,UAAU,EAA4B,MAAM,KAAK,CAAA;AAElH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAmB,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,8BAA8B,CAAA;AAEnF,MAAM,WAAW,kBAAkB;IACjC,6FAA6F;IAC7F,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAA;IAC1D,kEAAkE;IAClE,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,sDAAsD;IACtD,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,gGAAgG;IAChG,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,gGAAgG;IAChG,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,wDAAwD;IACxD,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAC5E,uDAAuD;IACvD,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAC3E,wDAAwD;IACxD,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAE,QAAQ,CAAC,eAAe,CAAM,GAAG,kBAAkB,CA6EnH"}

package/dist/composables/use-layout.d.ts

@@ -2,11 +2,22 @@ import { type MaybeComputedElementRef } from "@vueuse/core";
 import { type AutoLayout, type AutoLayoutParams, type DOMTargetSelector, type LayoutAnimationParams, type Timeline } from "animejs";
 import { type DeepReadonly, type MaybeRef, type ShallowRef } from "vue";
 export interface UseLayoutReturn {
+    /** The underlying Anime.js `AutoLayout` instance. `undefined` until the root element is available. */
     layout: DeepReadonly<ShallowRef<AutoLayout | undefined>>;
+    /** Snapshots the current positions of all tracked children so the next layout change can be animated. */
     record: () => void;
+    /** Animates all children from their recorded positions to their new positions. */
     animate: (params?: LayoutAnimationParams) => Timeline | undefined;
+    /** Records, applies the callback (which triggers a layout change), then animates the transition. */
     update: (callback: (layout: AutoLayout) => void, params?: LayoutAnimationParams) => void;
+    /** Cancels the layout watcher and restores all elements to their original state. */
     revert: () => void;
 }
-export declare function useLayout(root: MaybeRef<DOMTargetSelector> | MaybeComputedElementRef, params: MaybeRef<AutoLayoutParams>): UseLayoutReturn;
+/**
+ * Wraps Anime.js `createLayout()` into a Vue composable. Reactively re-creates the layout observer when the root element or params change, and reverts it automatically on unmount.
+ *
+ * @param root - The container element whose children will be tracked. Accepts a template ref, a CSS selector, or a reactive ref to either.
+ * @param params - Anime.js auto-layout parameters. Accepts a plain object or a reactive ref / computed.
+ */
+export declare function useLayout(root: MaybeRef<DOMTargetSelector> | MaybeComputedElementRef, params?: MaybeRef<AutoLayoutParams>): UseLayoutReturn;
 //# sourceMappingURL=use-layout.d.ts.map

package/dist/composables/use-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-layout.d.ts","sourceRoot":"","sources":["../../src/composables/use-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAgC,MAAM,cAAc,CAAA;AACzF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACd,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,KAAK,YAAY,EAAS,KAAK,QAAQ,EAAY,KAAK,UAAU,EAA4B,MAAM,KAAK,CAAA;AAElH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAA;IACxD,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,qBAAqB,KAAK,QAAQ,GAAG,SAAS,CAAA;IACjE,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAA;IACxF,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,uBAAuB,EAC3D,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACjC,eAAe,CA4CjB"}
+{"version":3,"file":"use-layout.d.ts","sourceRoot":"","sources":["../../src/composables/use-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAkB,MAAM,cAAc,CAAA;AAE3E,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACd,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,KAAK,YAAY,EAAS,KAAK,QAAQ,EAAY,KAAK,UAAU,EAA4B,MAAM,KAAK,CAAA;AAElH,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAA;IACxD,yGAAyG;IACzG,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,kFAAkF;IAClF,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,qBAAqB,KAAK,QAAQ,GAAG,SAAS,CAAA;IACjE,oGAAoG;IACpG,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAA;IACxF,oFAAoF;IACpF,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,uBAAuB,EAC3D,MAAM,GAAE,QAAQ,CAAC,gBAAgB,CAAM,GACtC,eAAe,CAyCjB"}

package/dist/composables/use-raw-animate.d.ts

@@ -1,7 +1,14 @@
-import { AnimationParams, TargetSelector } from "animejs";
-import { MaybeRef } from "vue";
-export interface UseRawAnimateReturn {
-    animate: (target: TargetSelector, options: AnimationParams) => void;
-}
-export declare function useRawAnimate(_target: MaybeRef<TargetSelector>, _options?: MaybeRef<AnimationParams>): import("animejs").JSAnimation;
+import { type AnimationParams, type JSAnimation } from "animejs";
+import { type MaybeRef } from "vue";
+import { type AnimationTargets } from "@src/utils/resolve-target.ts";
+/** The Anime.js `JSAnimation` instance returned by `useRawAnimate`. */
+export type UseRawAnimateReturn = JSAnimation;
+/**
+ * Thin wrapper around Anime.js `animate()`. Resolves the target (unwrapping refs and Vue component
+ * refs via `.$el`) and immediately starts the animation.
+ *
+ * @param _target - The element(s) to animate. Accepts a template ref, a Vue component ref, a CSS selector, a DOM element, or a reactive ref to any of these.
+ * @param _options - Anime.js animation parameters. Accepts a plain object or a reactive ref / computed. Defaults to `{}`.
+ */
+export declare function useRawAnimate(_target: AnimationTargets, _options?: MaybeRef<AnimationParams>): UseRawAnimateReturn;
 //# sourceMappingURL=use-raw-animate.d.ts.map

package/dist/composables/use-raw-animate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-raw-animate.d.ts","sourceRoot":"","sources":["../../src/composables/use-raw-animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAS,MAAM,KAAK,CAAA;AAErC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;CACpE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,GAAE,QAAQ,CAAC,eAAe,CAAM,iCAQxG"}
+{"version":3,"file":"use-raw-animate.d.ts","sourceRoot":"","sources":["../../src/composables/use-raw-animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,KAAK,CAAA;AAC1C,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,8BAA8B,CAAA;AAEnF,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAE7C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,GAAE,QAAQ,CAAC,eAAe,CAAM,GACvC,mBAAmB,CAQrB"}

package/dist/composables/use-scope.d.ts

@@ -1,13 +1,27 @@
 import { type Scope, type ScopeMethod, type ScopeParams, type Tickable } from "animejs";
 import { type DeepReadonly, type MaybeRef, type ShallowRef } from "vue";
 export interface UseScopeReturn {
+    /** The underlying Anime.js `Scope` instance. */
     scope: DeepReadonly<ShallowRef<Scope>>;
+    /** Registers an anonymous method on the scope. Queued automatically if called before mount. */
     add: (method: ScopeMethod) => void;
+    /** Registers a named method on the scope so it can be called via `scope.methods[name]()`. Queued automatically if called before mount. */
     registerMethod: (methodName: string, method: ScopeMethod) => void;
+    /** Registers a method that runs exactly once on the scope. Queued automatically if called before mount. */
     addOnce: (method: ScopeMethod) => void;
+    /** Keeps the time of another tickable (animation, timer) in sync with this scope. */
     keepTime: (method: (scope: Scope) => Tickable) => void;
+    /** Cancels the scope and reverts all animations and tickables it owns. */
     revert: () => void;
+    /** Re-reads default values and media-query breakpoints for the scope. */
     refresh: () => void;
 }
+/**
+ * Wraps Anime.js `createScope()` into a Vue composable. Reactively re-creates the scope when params change, replays all registered methods, and reverts it automatically on unmount.
+ *
+ * Methods added before mount are queued and replayed once the component is mounted.
+ *
+ * @param params - Anime.js scope parameters. Accepts a plain object or a reactive ref / computed.
+ */
 export declare function useScope(params: MaybeRef<ScopeParams>): UseScopeReturn;
 //# sourceMappingURL=use-scope.d.ts.map

package/dist/composables/use-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-scope.d.ts","sourceRoot":"","sources":["../../src/composables/use-scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AACpG,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,QAAQ,EAEb,KAAK,UAAU,EAIhB,MAAM,KAAK,CAAA;AAEZ,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACtC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAClC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACjE,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,KAAK,IAAI,CAAA;IACtD,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,cAAc,CAyEtE"}
+{"version":3,"file":"use-scope.d.ts","sourceRoot":"","sources":["../../src/composables/use-scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AACpG,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,QAAQ,EAEb,KAAK,UAAU,EAIhB,MAAM,KAAK,CAAA;AAEZ,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACtC,+FAA+F;IAC/F,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAClC,0IAA0I;IAC1I,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACjE,2GAA2G;IAC3G,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,qFAAqF;IACrF,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,KAAK,IAAI,CAAA;IACtD,0EAA0E;IAC1E,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,cAAc,CAyEtE"}

package/dist/composables/use-svg-drawable.d.ts

@@ -0,0 +1,19 @@
+import { type DrawableSVGGeometry, type DOMTargetSelector } from "animejs";
+import { type MaybeComputedElementRef } from "@vueuse/core";
+import { type MaybeRef, type DeepReadonly, type ShallowRef } from "vue";
+export interface UseSvgDrawableReturn {
+    /**
+     * The Anime.js drawable Proxy for the target element. `undefined` until the element is available.
+     * Pass this ref — not the original template ref — as the `useAnimate` target to animate the `draw` property.
+     */
+    drawable: DeepReadonly<ShallowRef<DrawableSVGGeometry | undefined>>;
+}
+/**
+ * Wraps an SVG geometry element in Anime.js's drawable Proxy. The proxy intercepts `setAttribute('draw', …)` calls and translates normalised `draw` values (`0`–`1`) into the correct `stroke-dasharray` / `stroke-dashoffset` updates. Pass the returned `drawable` ref as the target to `useAnimate`.
+ *
+ * @param target - The SVG element to make drawable. Accepts a template ref, a CSS selector, or a reactive ref to either.
+ * @param start - Initial draw start position (`0`–`1`). Defaults to `0`.
+ * @param end - Initial draw end position (`0`–`1`). Defaults to `0` (fully hidden).
+ */
+export declare function useSvgDrawable(target: MaybeRef<DOMTargetSelector> | MaybeComputedElementRef, start?: MaybeRef<number>, end?: MaybeRef<number>): UseSvgDrawableReturn;
+//# sourceMappingURL=use-svg-drawable.d.ts.map

package/dist/composables/use-svg-drawable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-svg-drawable.d.ts","sourceRoot":"","sources":["../../src/composables/use-svg-drawable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC/E,OAAO,EAAE,KAAK,uBAAuB,EAAkB,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAS,KAAK,QAAQ,EAAY,KAAK,YAAY,EAAE,KAAK,UAAU,EAA4B,MAAM,KAAK,CAAA;AAGlH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC,CAAA;CACpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,uBAAuB,EAC7D,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAK,EAC3B,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAK,GACxB,oBAAoB,CAsBtB"}

package/dist/composables/use-svg.d.ts

@@ -1,9 +1,15 @@
-import { type TargetsParam } from "animejs";
+import { svg, type FunctionValue, type TargetsParam } from "animejs";
 import { type MaybeRef } from "vue";
 export interface UseSvgReturn {
-    morphTo: (path: MaybeRef<TargetsParam>, precision?: MaybeRef<number>) => void;
-    createDrawable: (selector: MaybeRef<TargetsParam>, start?: MaybeRef<number>, end?: MaybeRef<number>) => void;
-    createMotionPath: (path: MaybeRef<TargetsParam>, offset?: MaybeRef<number>) => void;
+    /** Returns a `FunctionValue` that morphs the current path to the given `path`. Pass the result as the `d` property in `useAnimate` options. */
+    morphTo: (path: MaybeRef<TargetsParam>, precision?: MaybeRef<number>) => FunctionValue;
+    /** Creates a motion-path object from an SVG `<path>`. Spread the result into `useAnimate` options to animate `translateX`, `translateY`, and `rotate` along the path. */
+    createMotionPath: (path: MaybeRef<TargetsParam | null>, offset?: MaybeRef<number>) => ReturnType<typeof svg.createMotionPath>;
 }
+/**
+ * Exposes Anime.js SVG utilities (`svg.morphTo`, `svg.createMotionPath`) as a Vue composable, automatically unwrapping reactive refs passed to each helper.
+ *
+ * For drawable stroke animations, use `useSvgDrawable` instead.
+ */
 export declare function useSvg(): UseSvgReturn;
 //# sourceMappingURL=use-svg.d.ts.map

package/dist/composables/use-svg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-svg.d.ts","sourceRoot":"","sources":["../../src/composables/use-svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,KAAK,CAAA;AAE1C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IAC7E,cAAc,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IAC5G,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;CACpF;AAED,wBAAgB,MAAM,IAAI,YAAY,CAkBrC"}
+{"version":3,"file":"use-svg.d.ts","sourceRoot":"","sources":["../../src/composables/use-svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AACpE,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,KAAK,CAAA;AAE1C,MAAM,WAAW,YAAY;IAC3B,+IAA+I;IAC/I,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,aAAa,CAAA;IACtF,yKAAyK;IACzK,gBAAgB,EAAE,CAChB,IAAI,EAAE,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,EACnC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KACtB,UAAU,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAA;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAkBrC"}

package/dist/composables/use-text.d.ts

@@ -2,12 +2,24 @@ import { type TextSplitter, type TextSplitterParams } from "animejs";
 import { type MaybeComputedElementRef } from "@vueuse/core";
 import { type ComputedRef, type DeepReadonly, type MaybeRef, type ShallowRef } from "vue";
 export interface UseTextReturn {
+    /** The underlying Anime.js `TextSplitter` instance. `undefined` until the target is available. */
     splitter: DeepReadonly<ShallowRef<TextSplitter | undefined>>;
+    /** Reactive array of `<span>` elements representing each line after splitting. */
     lines: ComputedRef<HTMLElement[]>;
+    /** Reactive array of `<span>` elements representing each word after splitting. */
     words: ComputedRef<HTMLElement[]>;
+    /** Reactive array of `<span>` elements representing each character after splitting. */
     chars: ComputedRef<HTMLElement[]>;
+    /** Removes all split `<span>` wrappers and restores the original text content. */
     revert: () => void;
+    /** Re-splits the text, updating `lines`, `words`, and `chars` to reflect any DOM or size changes. */
     refresh: () => void;
 }
+/**
+ * Wraps Anime.js `splitText()` into a Vue composable. Reactively re-splits the text when the target or params change, and reverts the DOM automatically on unmount.
+ *
+ * @param _target - The element(s) whose text content should be split. Accepts a template ref, a CSS selector, a DOM element, or a reactive ref to any of these.
+ * @param _params - Anime.js text-splitter parameters. Accepts a plain object or a reactive ref / computed.
+ */
 export declare function useText(_target: MaybeRef<HTMLElement | NodeList | string | HTMLElement[]> | MaybeComputedElementRef, _params?: MaybeRef<TextSplitterParams>): UseTextReturn;
 //# sourceMappingURL=use-text.d.ts.map

package/dist/composables/use-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-text.d.ts","sourceRoot":"","sources":["../../src/composables/use-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC/E,OAAO,EAAE,KAAK,uBAAuB,EAAgC,MAAM,cAAc,CAAA;AACzF,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,KAAK,CAAA;AAEZ,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC,CAAA;IAC5D,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;IACjC,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;IACjC,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;IACjC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,OAAO,CACrB,OAAO,EAAE,QAAQ,CAAC,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC,GAAG,uBAAuB,EAC5F,OAAO,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACrC,aAAa,CAiDf"}
+{"version":3,"file":"use-text.d.ts","sourceRoot":"","sources":["../../src/composables/use-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC/E,OAAO,EAAE,KAAK,uBAAuB,EAAkB,MAAM,cAAc,CAAA;AAE3E,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,KAAK,CAAA;AAEZ,MAAM,WAAW,aAAa;IAC5B,kGAAkG;IAClG,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC,CAAA;IAC5D,kFAAkF;IAClF,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;IACjC,kFAAkF;IAClF,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;IACjC,uFAAuF;IACvF,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;IACjC,kFAAkF;IAClF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,qGAAqG;IACrG,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,QAAQ,CAAC,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC,GAAG,uBAAuB,EAC5F,OAAO,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACrC,aAAa,CA0Cf"}

package/dist/composables/use-timeline.d.ts

@@ -1,22 +1,23 @@
-import { type MaybeRef, type ShallowRef, type DeepReadonly } from "vue";
-import { type AnimationParams, type Callback, type StaggerFunction, type TargetsParam, type Tickable, type Timeline, type TimelineParams, type TimelinePosition, type Timer } from "animejs";
+import { type MaybeRef, type MaybeRefOrGetter, type ShallowRef, type DeepReadonly } from "vue";
+import { type AnimationParams, type Callback, type StaggerFunction, type Tickable, type Timeline, type TimelineParams, type TimelinePosition, type Timer } from "animejs";
+import { type AnimationTargets } from "@src/utils/resolve-target.ts";
 export type TimelineChain = Timeline & {
     /** Adds an animation to the timeline and returns a chainable object. */
-    add: (targets: MaybeRef<TargetsParam>, params: AnimationParams, position?: TimelinePosition | StaggerFunction<number | string>) => TimelineChain;
+    add: (targets: AnimationTargets, params: MaybeRefOrGetter<AnimationParams>, position?: TimelinePosition | StaggerFunction<number | string>) => TimelineChain;
     /** Sets a property to a value at a point in the timeline without animating it, then returns a chainable object. */
-    set: (targets: MaybeRef<TargetsParam>, params: AnimationParams, position?: TimelinePosition) => TimelineChain;
+    set: (targets: AnimationTargets, params: MaybeRefOrGetter<AnimationParams>, position?: TimelinePosition) => TimelineChain;
     /** Removes an animation target (or a specific property) from the timeline and returns a chainable object. */
-    remove: (targets: MaybeRef<TargetsParam>, propertyName?: string) => TimelineChain;
+    remove: (targets: AnimationTargets, propertyName?: string) => TimelineChain;
 };
 export interface UseTimelineReturn {
     /** The underlying Anime.js timeline instance. */
     timeline: DeepReadonly<ShallowRef<Timeline>>;
     /** Adds an animation to the timeline. Accepts a template ref or any valid Anime.js target. Returns a chainable object. */
-    add: (targets: MaybeRef<TargetsParam>, params: AnimationParams, position?: TimelinePosition | StaggerFunction<number | string>) => TimelineChain;
+    add: (targets: AnimationTargets, params: MaybeRefOrGetter<AnimationParams>, position?: TimelinePosition | StaggerFunction<number | string>) => TimelineChain;
     /** Sets a property to a value at a point in the timeline without animating it. Returns a chainable object. */
-    set: (targets: MaybeRef<TargetsParam>, params: AnimationParams, position?: TimelinePosition) => TimelineChain;
+    set: (targets: AnimationTargets, params: MaybeRefOrGetter<AnimationParams>, position?: TimelinePosition) => TimelineChain;
     /** Removes an animation target (or a specific property) from the timeline. Returns a chainable object. */
-    remove: (targets: MaybeRef<TargetsParam>, propertyName?: string) => TimelineChain;
+    remove: (targets: AnimationTargets, propertyName?: string) => TimelineChain;
     /** Synchronises another tickable (animation, timer) into the timeline at the given position. */
     sync: (synced?: Tickable, position?: TimelinePosition) => Timeline;
     /** Adds a named label at a position so it can be referenced by `.add()` or `.seek()`. */

package/dist/composables/use-timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-timeline.d.ts","sourceRoot":"","sources":["../../src/composables/use-timeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-timeline.d.ts","sourceRoot":"","sources":["../../src/composables/use-timeline.ts"],"names":[],"mappings":"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"}

package/dist/composables/use-timer.d.ts

@@ -1,19 +1,37 @@
 import { type Timer, type TimerParams } from "animejs";
 import { type MaybeRef, type ShallowRef, type DeepReadonly } from "vue";
 export interface UseTimerReturn {
+    /** The underlying Anime.js timer instance. */
     timer: DeepReadonly<ShallowRef<Timer>>;
+    /** Starts or resumes the timer. */
     play: () => Timer;
+    /** Reverses the timer's playback direction. */
     reverse: () => Timer;
+    /** Pauses the timer at the current position. */
     pause: () => Timer;
+    /** Restarts the timer from the beginning. */
     restart: () => Timer;
+    /** Toggles between forward and reverse direction. */
     alternate: () => Timer;
+    /** Resumes from a paused state. */
     resume: () => Timer;
+    /** Jumps immediately to the end of the timer duration. */
     complete: () => Timer;
+    /** Resets the timer to its initial state. Pass `true` for a soft reset that preserves the current cycle. */
     reset: (softReset?: boolean) => Timer;
+    /** Stops the timer and removes it from the Anime.js engine. */
     cancel: () => Timer;
+    /** Cancels the timer and restores any associated state to its original values. */
     revert: () => Timer;
+    /** Seeks to a specific time (in ms). */
     seek: (time: number, muteCallbacks?: boolean | number, internalRender?: boolean | number) => Timer;
+    /** Rescales the timer to a new total duration. */
     stretch: (newDuration: number) => Timer;
 }
+/**
+ * Wraps Anime.js `createTimer()` into a Vue composable. Reactively re-creates the timer when options change, and cancels it automatically on unmount.
+ *
+ * @param options - Anime.js timer parameters. Accepts a plain object or a reactive ref / computed. Defaults to `{}`.
+ */
 export declare function useTimer(options?: MaybeRef<TimerParams>): UseTimerReturn;
 //# sourceMappingURL=use-timer.d.ts.map

package/dist/composables/use-timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-timer.d.ts","sourceRoot":"","sources":["../../src/composables/use-timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACnE,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAA4B,KAAK,YAAY,EAAY,MAAM,KAAK,CAAA;AAG3G,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACtC,IAAI,EAAE,MAAM,KAAK,CAAA;IACjB,OAAO,EAAE,MAAM,KAAK,CAAA;IACpB,KAAK,EAAE,MAAM,KAAK,CAAA;IAClB,OAAO,EAAE,MAAM,KAAK,CAAA;IACpB,SAAS,EAAE,MAAM,KAAK,CAAA;IACtB,MAAM,EAAE,MAAM,KAAK,CAAA;IACnB,QAAQ,EAAE,MAAM,KAAK,CAAA;IACrB,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,KAAK,CAAA;IACrC,MAAM,EAAE,MAAM,KAAK,CAAA;IACnB,MAAM,EAAE,MAAM,KAAK,CAAA;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,KAAK,CAAA;IAClG,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,KAAK,CAAA;CACxC;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,QAAQ,CAAC,WAAW,CAAM,GAAG,cAAc,CAgF5E"}
+{"version":3,"file":"use-timer.d.ts","sourceRoot":"","sources":["../../src/composables/use-timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACnE,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAA4B,KAAK,YAAY,EAAY,MAAM,KAAK,CAAA;AAG3G,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACtC,mCAAmC;IACnC,IAAI,EAAE,MAAM,KAAK,CAAA;IACjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,KAAK,CAAA;IACpB,gDAAgD;IAChD,KAAK,EAAE,MAAM,KAAK,CAAA;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,KAAK,CAAA;IACpB,qDAAqD;IACrD,SAAS,EAAE,MAAM,KAAK,CAAA;IACtB,mCAAmC;IACnC,MAAM,EAAE,MAAM,KAAK,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,KAAK,CAAA;IACrB,4GAA4G;IAC5G,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,KAAK,CAAA;IACrC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,KAAK,CAAA;IACnB,kFAAkF;IAClF,MAAM,EAAE,MAAM,KAAK,CAAA;IACnB,wCAAwC;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,KAAK,CAAA;IAClG,kDAAkD;IAClD,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,KAAK,CAAA;CACxC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,QAAQ,CAAC,WAAW,CAAM,GAAG,cAAc,CAgF5E"}

package/dist/composables/use-waapi.d.ts

@@ -2,19 +2,38 @@ import { type MaybeComputedElementRef } from "@vueuse/core";
 import { type WAAPIAnimationParams, type DOMTargetsParam, type WAAPIAnimation, type EasingFunction } from "animejs";
 import { DeepReadonly, type MaybeRef, ShallowRef } from "vue";
 export interface UseWaapiReturn {
+    /** The underlying Anime.js WAAPI animation instance. `undefined` until the target is available. */
     animation: DeepReadonly<ShallowRef<WAAPIAnimation | undefined>>;
+    /** Resumes from a paused state. */
     resume: () => WAAPIAnimation | undefined;
+    /** Pauses the animation at the current position. */
     pause: () => WAAPIAnimation | undefined;
+    /** Toggles between forward and reverse direction. */
     alternate: () => WAAPIAnimation | undefined;
+    /** Starts or resumes the animation. */
     play: () => WAAPIAnimation | undefined;
+    /** Reverses playback direction. */
     reverse: () => WAAPIAnimation | undefined;
+    /** Seeks to a specific time (in ms). Accepts a reactive ref for the time value. */
     seek: (time: MaybeRef<number>, muteCallbacks?: MaybeRef<boolean>) => WAAPIAnimation | undefined;
+    /** Restarts the animation from the beginning. */
     restart: () => WAAPIAnimation | undefined;
+    /** Commits the current animated styles to the element's inline style, then cancels the animation. */
     commitStyles: () => WAAPIAnimation | undefined;
+    /** Jumps immediately to the end of the animation. */
     complete: () => WAAPIAnimation | undefined;
+    /** Stops the animation and removes it from the WAAPI engine. */
     cancel: () => WAAPIAnimation | undefined;
+    /** Cancels the animation and restores all animated properties to their original values. */
     revert: () => WAAPIAnimation | undefined;
+    /** Converts an Anime.js easing function to a CSS `cubic-bezier()` string usable by WAAPI. */
     convertEase: (fn: MaybeRef<EasingFunction>, samples?: MaybeRef<number>) => string;
 }
+/**
+ * Wraps Anime.js `waapi.animate()` into a Vue composable. Reactively re-creates the WAAPI animation when the target or options change, and stops it automatically on unmount.
+ *
+ * @param targets - The DOM element(s) to animate via WAAPI. Accepts a template ref, a CSS selector, a DOM element, or a reactive ref to any of these.
+ * @param options - Anime.js WAAPI animation parameters. Accepts a plain object or a reactive ref / computed. Defaults to `{}`.
+ */
 export declare function useWaapi(targets: MaybeRef<DOMTargetsParam> | MaybeComputedElementRef, options?: MaybeRef<WAAPIAnimationParams>): UseWaapiReturn;
 //# sourceMappingURL=use-waapi.d.ts.map