@motion.page/sdk 1.1.2 → 1.1.4

package/dist/core/Timeline.d.ts

@@ -168,14 +168,20 @@ export declare class Timeline {
     /**
      * Find animation targets that "belong" to a container in each-mode.
      *
-     * Strategy 1 (preferred): descendants of the container.
+     * Strategy 1 (preferred): the container itself (when it's also an animation
+     *   target) and/or its descendants. Covers the most common Builder workflow
+     *   where the trigger target IS the animation target (e.g.
+     *   `.onScroll({ target: '.fade-up', each: true })` animating `.fade-up`),
+     *   as well as parent-child setups (e.g. `.section-header` containing
+     *   `.eyebrow`/`.subtitle`).
      * Strategy 2 (sibling fallback): anim targets sharing the container's parent
      *   that aren't owned by another container.
      *
      * Returns [] when neither strategy yields targets — the caller skips this
      * container, dropping the orphaned anim targets entirely. This matches the
      * documented behaviour: when each:true + explicit target is set, only anim
-     * targets associated with a container (descendant or sibling) are animated.
+     * targets associated with a container (self, descendant, or sibling) are
+     * animated.
      */
     private _findScopedTargetsForContainer;
     /**