angular-movement 0.0.1 → 0.1.0

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "angular-movement",
-  "version": "0.0.1",
+  "version": "0.1.0",
+  "type": "module",
   "description": "Angular animation directives — presets, custom keyframes, spring physics, scroll & parallax.",
   "keywords": [
     "angular",
@@ -16,7 +17,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Andersseen/angular-movement.git"
+    "url": "git+https://github.com/Andersseen/angular-movement.git"
   },
   "homepage": "https://github.com/Andersseen/angular-movement#readme",
   "bugs": {

package/types/angular-movement.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, OnDestroy, OnInit, EnvironmentProviders } from '@angular/core';
 
-type MovePreset = 'fade-up' | 'fade-down' | 'fade-left' | 'fade-right' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'zoom-in' | 'zoom-out' | 'flip-x' | 'flip-y' | 'bounce-in' | 'blur-in' | 'spin' | 'pulse' | 'none';
+type MovePreset = 'fade-up' | 'fade-down' | 'fade-left' | 'fade-right' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'zoom-in' | 'zoom-out' | 'flip-x' | 'flip-y' | 'bounce-in' | 'blur-in' | 'spin' | 'pulse' | 'shake' | 'swing' | 'wobble' | 'rubber-band' | 'heart-beat' | 'tada' | 'jello' | 'light-speed' | 'roll-in' | 'none';
 type MoveValuePair = readonly number[];
 interface MoveSpring {
     stiffness?: number;
@@ -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,89 @@ 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>;
+}
+
+declare class MoveTargetDirective implements OnDestroy {
+    #private;
+    readonly moveTarget: _angular_core.InputSignal<boolean>;
+    readonly moveFrames: _angular_core.InputSignal<MoveKeyframes>;
+    readonly moveDuration: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
+    readonly moveEasing: _angular_core.InputSignal<string | undefined>;
+    readonly moveDelay: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
+    readonly moveSpring: _angular_core.InputSignal<MoveSpring | undefined>;
+    readonly moveDisabled: _angular_core.InputSignal<boolean | undefined>;
+    readonly moveReverseDuration: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
+    readonly moveReverseEasing: _angular_core.InputSignal<string | undefined>;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MoveTargetDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MoveTargetDirective, "[moveTarget]", never, { "moveTarget": { "alias": "moveTarget"; "required": true; "isSignal": true; }; "moveFrames": { "alias": "moveFrames"; "required": true; "isSignal": true; }; "moveDuration": { "alias": "moveDuration"; "required": false; "isSignal": true; }; "moveEasing": { "alias": "moveEasing"; "required": false; "isSignal": true; }; "moveDelay": { "alias": "moveDelay"; "required": false; "isSignal": true; }; "moveSpring": { "alias": "moveSpring"; "required": false; "isSignal": true; }; "moveDisabled": { "alias": "moveDisabled"; "required": false; "isSignal": true; }; "moveReverseDuration": { "alias": "moveReverseDuration"; "required": false; "isSignal": true; }; "moveReverseEasing": { "alias": "moveReverseEasing"; "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;
+/**
+ * Validates MoveSpring configuration and returns sanitized values.
+ * Warns in development mode for invalid values.
+ */
+declare function validateSpring(spring: MoveSpring | undefined): MoveSpring | undefined;
+/**
+ * Validates scroll offset string format "elFraction viewFraction".
+ * Returns true if valid, warns in dev mode if invalid.
+ */
+declare function isValidScrollOffset(offset: string): boolean;
+/**
+ * Validates drag elastic factor. Must be between 0 and 1.
+ */
+declare function validateDragElastic(elastic: number): number;
+
 /**
  * SmoothScrollService — Lenis-inspired smooth scroll for Angular.
  *
@@ -395,25 +481,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 +501,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 +515,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 +528,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, typeof MoveTargetDirective];
 
-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, MoveTargetDirective, MoveTextDirective, MoveVariantsDirective, SmoothScrollService, SpringPlayer, WaapiPlayer, applyInitialStyles, clearInitialStyles, isValidScrollOffset, prefersReducedMotion, provideMovement, resolveMoveFrames, resolveMovementConfig, reverseFrames, validateDragElastic, validateSpring };
+export type { AnimationControls, MoveAnimationConfig, MoveDirectiveInput, MoveDragConstraints, MoveInputOverrides, MoveKeyframeState, MoveKeyframes, MovePhase, MovePresenceChild, MovePresenceProvider, MovePreset, MovePresetDefinition, MoveSpring, MoveStaggerDirection, MoveStaggerProvider, MoveValuePair, MoveVariant, MoveVariantsProvider, MovementConfig, MovementConfigInput, PlayAnimationOptions };