angular-movement 0.0.1 → 0.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-movement",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Angular animation directives — presets, custom keyframes, spring physics, scroll & parallax.",
   "keywords": [
     "angular",

package/types/angular-movement.d.ts

@@ -20,6 +20,7 @@ interface MoveKeyframes {
     rotateX?: MoveValuePair;
     rotateY?: MoveValuePair;
     blur?: MoveValuePair;
+    [key: string]: MoveValuePair | undefined;
 }
 type MoveVariant = MoveKeyframes & {
     spring?: MoveSpring;
@@ -30,6 +31,7 @@ type MoveVariant = MoveKeyframes & {
 interface MovePresetDefinition {
     enter: MoveKeyframes;
     leave: MoveKeyframes;
+    loop?: MoveKeyframes;
 }
 interface MoveKeyframeState {
     opacity?: number;
@@ -42,6 +44,7 @@ interface MoveKeyframeState {
     rotateX?: number;
     rotateY?: number;
     blur?: number;
+    [key: string]: number | undefined;
 }
 interface MoveAnimationConfig {
     initial?: MoveKeyframeState;
@@ -348,6 +351,59 @@ declare class MoveParallaxDirective implements OnInit, OnDestroy {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MoveParallaxDirective, "[moveParallax]", ["moveParallax"], { "moveParallax": { "alias": "moveParallax"; "required": false; "isSignal": true; }; "moveParallaxAxis": { "alias": "moveParallaxAxis"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class MoveLoopDirective implements OnDestroy, OnInit {
+    #private;
+    readonly moveLoop: _angular_core.InputSignal<MovePreset | MoveKeyframes>;
+    readonly moveDuration: _angular_core.InputSignal<number | undefined>;
+    readonly moveEasing: _angular_core.InputSignal<string | undefined>;
+    readonly moveDelay: _angular_core.InputSignal<number | undefined>;
+    readonly moveDisabled: _angular_core.InputSignal<boolean | undefined>;
+    readonly moveSpring: _angular_core.InputSignal<MoveSpring | undefined>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MoveLoopDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MoveLoopDirective, "[moveLoop]", never, { "moveLoop": { "alias": "moveLoop"; "required": false; "isSignal": true; }; "moveDuration": { "alias": "moveDuration"; "required": false; "isSignal": true; }; "moveEasing": { "alias": "moveEasing"; "required": false; "isSignal": true; }; "moveDelay": { "alias": "moveDelay"; "required": false; "isSignal": true; }; "moveDisabled": { "alias": "moveDisabled"; "required": false; "isSignal": true; }; "moveSpring": { "alias": "moveSpring"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface MovementConfig {
+    duration: number;
+    easing: string;
+    delay: number;
+    disabled: boolean;
+    iterations?: number;
+}
+declare const MOVEMENT_DEFAULTS: MovementConfig;
+declare const MOVEMENT_CONFIG: InjectionToken<MovementConfig>;
+
+type MovePhase = 'enter' | 'leave' | 'loop';
+type MoveDirectiveInput = MovePreset | MoveKeyframes;
+interface MoveInputOverrides {
+    duration?: number;
+    easing?: string;
+    delay?: number;
+    disabled?: boolean;
+    iterations?: number;
+}
+declare function resolveMovementConfig(defaults: MovementConfig, overrides: MoveInputOverrides, reducedMotion: boolean): MovementConfig;
+declare function resolveMoveFrames(value: MoveDirectiveInput, phase: MovePhase): MoveKeyframes;
+declare function prefersReducedMotion(documentRef: Document): boolean;
+/**
+ * Reverses all keyframe value arrays in a MoveKeyframes object.
+ * Used by hover and tap directives to animate back to the original state.
+ */
+declare function reverseFrames(frames: MoveKeyframes): MoveKeyframes;
+/**
+ * Applies the first keyframe values as inline styles to an element.
+ * Used by in-view and text directives to set the initial (hidden) state
+ * before the IntersectionObserver triggers the animation.
+ */
+declare function applyInitialStyles(el: HTMLElement, frames: MoveKeyframes): void;
+/**
+ * Clears all inline styles set by `applyInitialStyles`.
+ * Called just before WAAPI animates so it can take full control.
+ */
+declare function clearInitialStyles(el: HTMLElement): void;
+
 /**
  * SmoothScrollService — Lenis-inspired smooth scroll for Angular.
  *
@@ -395,25 +451,17 @@ interface AnimationControls {
     readonly finished: Promise<void>;
 }
 
-interface MovementConfig {
-    duration: number;
-    easing: string;
-    delay: number;
-    disabled: boolean;
-}
-declare const MOVEMENT_DEFAULTS: MovementConfig;
-declare const MOVEMENT_CONFIG: InjectionToken<MovementConfig>;
-
 interface PlayAnimationOptions {
     config?: MovementConfig;
     spring?: MoveSpring;
     delay?: number;
     disabled?: boolean;
+    iterations?: number;
     onDone?: () => void;
 }
 declare class AnimationEngine {
     #private;
-    play(host: HTMLElement, frames: MoveKeyframes, options?: PlayAnimationOptions): AnimationControls | null;
+    play(host: Element, frames: MoveKeyframes, options?: PlayAnimationOptions): AnimationControls | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AnimationEngine, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AnimationEngine>;
 }
@@ -423,9 +471,10 @@ declare class SpringPlayer implements AnimationControls {
     private readonly host;
     private readonly frames;
     private readonly delay;
+    private readonly iterations;
     private readonly onDone?;
     readonly finished: Promise<void>;
-    constructor(host: HTMLElement, frames: MoveKeyframes, userConfig: MoveSpring, delay: number, onDone?: (() => void) | undefined);
+    constructor(host: Element, frames: MoveKeyframes, userConfig: MoveSpring, delay: number, iterations?: number, onDone?: (() => void) | undefined);
     play(): void;
     pause(): void;
     cancel(): void;
@@ -436,7 +485,7 @@ declare class SpringPlayer implements AnimationControls {
 declare class WaapiPlayer implements AnimationControls {
     #private;
     readonly finished: Promise<void>;
-    constructor(host: HTMLElement, frames: MoveKeyframes, config: MovementConfig, onDone?: () => void);
+    constructor(host: Element, frames: MoveKeyframes, config: MovementConfig, onDone?: () => void);
     play(): void;
     pause(): void;
     cancel(): void;
@@ -449,7 +498,7 @@ declare const MOVE_PRESETS: Record<MovePreset, MovePresetDefinition>;
 type MovementConfigInput = Partial<MovementConfig>;
 declare function provideMovement(config?: MovementConfigInput): EnvironmentProviders;
 
-declare const MOVEMENT_DIRECTIVES: readonly [typeof MoveEnterDirective, typeof MoveLeaveDirective, typeof MoveAnimateDirective, typeof MoveHoverDirective, typeof MoveTapDirective, typeof MoveVariantsDirective, typeof MoveStaggerDirective, typeof MoveLayoutDirective, typeof MoveScrollDirective, typeof MovePresenceDirective, typeof MoveDragDirective, typeof MoveInViewDirective, typeof MoveTextDirective, typeof MoveSmoothScrollDirective, typeof MoveFocusDirective, typeof MoveParallaxDirective, typeof MoveAnimationDirective];
+declare const MOVEMENT_DIRECTIVES: readonly [typeof MoveEnterDirective, typeof MoveLeaveDirective, typeof MoveAnimateDirective, typeof MoveHoverDirective, typeof MoveTapDirective, typeof MoveVariantsDirective, typeof MoveStaggerDirective, typeof MoveLayoutDirective, typeof MoveScrollDirective, typeof MovePresenceDirective, typeof MoveDragDirective, typeof MoveInViewDirective, typeof MoveTextDirective, typeof MoveSmoothScrollDirective, typeof MoveFocusDirective, typeof MoveParallaxDirective, typeof MoveAnimationDirective, typeof MoveLoopDirective];
 
-export { AnimationEngine, MOVEMENT_CONFIG, MOVEMENT_DEFAULTS, MOVEMENT_DIRECTIVES, MOVE_PRESENCE_PARENT, MOVE_PRESETS, MOVE_STAGGER_PARENT, MOVE_VARIANTS_PARENT, MoveAnimateDirective, MoveAnimationDirective, MoveDragDirective, MoveEnterDirective, MoveFocusDirective, MoveHoverDirective, MoveInViewDirective, MoveLayoutDirective, MoveLeaveDirective, MoveParallaxDirective, MovePresenceDirective, MoveScrollDirective, MoveSmoothScrollDirective, MoveStaggerDirective, MoveTapDirective, MoveTextDirective, MoveVariantsDirective, SmoothScrollService, SpringPlayer, WaapiPlayer, provideMovement };
-export type { AnimationControls, MoveAnimationConfig, MoveDragConstraints, MoveKeyframeState, MoveKeyframes, MovePresenceChild, MovePresenceProvider, MovePreset, MovePresetDefinition, MoveSpring, MoveStaggerDirection, MoveStaggerProvider, MoveValuePair, MoveVariant, MoveVariantsProvider, MovementConfig, MovementConfigInput, PlayAnimationOptions };
+export { AnimationEngine, MOVEMENT_CONFIG, MOVEMENT_DEFAULTS, MOVEMENT_DIRECTIVES, MOVE_PRESENCE_PARENT, MOVE_PRESETS, MOVE_STAGGER_PARENT, MOVE_VARIANTS_PARENT, MoveAnimateDirective, MoveAnimationDirective, MoveDragDirective, MoveEnterDirective, MoveFocusDirective, MoveHoverDirective, MoveInViewDirective, MoveLayoutDirective, MoveLeaveDirective, MoveLoopDirective, MoveParallaxDirective, MovePresenceDirective, MoveScrollDirective, MoveSmoothScrollDirective, MoveStaggerDirective, MoveTapDirective, MoveTextDirective, MoveVariantsDirective, SmoothScrollService, SpringPlayer, WaapiPlayer, applyInitialStyles, clearInitialStyles, prefersReducedMotion, provideMovement, resolveMoveFrames, resolveMovementConfig, reverseFrames };
+export type { AnimationControls, MoveAnimationConfig, MoveDirectiveInput, MoveDragConstraints, MoveInputOverrides, MoveKeyframeState, MoveKeyframes, MovePhase, MovePresenceChild, MovePresenceProvider, MovePreset, MovePresetDefinition, MoveSpring, MoveStaggerDirection, MoveStaggerProvider, MoveValuePair, MoveVariant, MoveVariantsProvider, MovementConfig, MovementConfigInput, PlayAnimationOptions };