telecop 0.1.28 → 0.1.30

package/dist/animations/core/animator.d.ts

@@ -0,0 +1,75 @@
+export type EasingFunction = (t: number) => number;
+export interface AnimationConfig {
+    duration?: number;
+    delay?: number;
+    easing?: EasingFunction | string;
+    iterations?: number;
+    direction?: 'normal' | 'reverse' | 'alternate' | 'alternate-reverse';
+    fill?: 'none' | 'forwards' | 'backwards' | 'both';
+}
+export interface AnimationKeyframe {
+    [property: string]: string | number;
+}
+/**
+ * 🎬 Animator - المحرك الأساسي للـ Animations
+ * يستخدم Web Animations API (WAAPI)
+ */
+export declare class Animator {
+    private element;
+    private animation;
+    constructor(element: HTMLElement);
+    /**
+     * تشغيل animation باستخدام keyframes
+     */
+    animate(keyframes: AnimationKeyframe[], config?: AnimationConfig): Promise<Animation>;
+    /**
+     * إيقاف الـ animation
+     */
+    stop(): void;
+    /**
+     * Pause الـ animation
+     */
+    pause(): void;
+    /**
+     * Resume الـ animation
+     */
+    resume(): void;
+    /**
+     * Reverse الـ animation
+     */
+    reverse(): void;
+    /**
+     * Get current progress (0 to 1)
+     */
+    getProgress(): number;
+    /**
+     * Check if animation is running
+     */
+    isRunning(): boolean;
+}
+/**
+ * 🎨 Helper function لإنشاء animator
+ */
+export declare function createAnimator(element: HTMLElement): Animator;
+/**
+ * 🎭 Animate multiple elements with stagger
+ */
+export declare function animateGroup(elements: HTMLElement[], keyframes: AnimationKeyframe[], config?: AnimationConfig & {
+    stagger?: number;
+}): Promise<Animation[]>;
+/**
+ * 🎬 Sequence animations (واحد بعد الآخر)
+ */
+export declare function sequence(animations: Array<{
+    element: HTMLElement;
+    keyframes: AnimationKeyframe[];
+    config?: AnimationConfig;
+}>): Promise<Animation[]>;
+/**
+ * 🔄 Parallel animations (كلهم مع بعض)
+ */
+export declare function parallel(animations: Array<{
+    element: HTMLElement;
+    keyframes: AnimationKeyframe[];
+    config?: AnimationConfig;
+}>): Promise<Animation[]>;

package/dist/animations/core/easing.d.ts

@@ -0,0 +1,86 @@
+export type EasingFunction = (t: number) => number;
+/**
+ * 🎨 Easing Functions Collection
+ * t = progress (0 to 1)
+ * Returns eased value (0 to 1)
+ */
+export declare const linear: EasingFunction;
+export declare const easeInCubic: EasingFunction;
+export declare const easeOutCubic: EasingFunction;
+export declare const easeInOutCubic: EasingFunction;
+export declare const easeInQuad: EasingFunction;
+export declare const easeOutQuad: EasingFunction;
+export declare const easeInOutQuad: EasingFunction;
+export declare const easeInQuart: EasingFunction;
+export declare const easeOutQuart: EasingFunction;
+export declare const easeInOutQuart: EasingFunction;
+export declare const easeInQuint: EasingFunction;
+export declare const easeOutQuint: EasingFunction;
+export declare const easeInOutQuint: EasingFunction;
+export declare const easeInExpo: EasingFunction;
+export declare const easeOutExpo: EasingFunction;
+export declare const easeInOutExpo: EasingFunction;
+export declare const easeInBack: EasingFunction;
+export declare const easeOutBack: EasingFunction;
+export declare const easeInOutBack: EasingFunction;
+export declare const easeInElastic: EasingFunction;
+export declare const easeOutElastic: EasingFunction;
+export declare const easeInOutElastic: EasingFunction;
+export declare const easeOutBounce: EasingFunction;
+export declare const easeInBounce: EasingFunction;
+export declare const easeInOutBounce: EasingFunction;
+export declare const easeInSine: EasingFunction;
+export declare const easeOutSine: EasingFunction;
+export declare const easeInOutSine: EasingFunction;
+export declare const easeInCirc: EasingFunction;
+export declare const easeOutCirc: EasingFunction;
+export declare const easeInOutCirc: EasingFunction;
+/**
+ * 📦 Map of all easing functions
+ */
+export declare const easings: {
+    readonly linear: EasingFunction;
+    readonly easeInCubic: EasingFunction;
+    readonly easeOutCubic: EasingFunction;
+    readonly easeInOutCubic: EasingFunction;
+    readonly easeInQuad: EasingFunction;
+    readonly easeOutQuad: EasingFunction;
+    readonly easeInOutQuad: EasingFunction;
+    readonly easeInQuart: EasingFunction;
+    readonly easeOutQuart: EasingFunction;
+    readonly easeInOutQuart: EasingFunction;
+    readonly easeInQuint: EasingFunction;
+    readonly easeOutQuint: EasingFunction;
+    readonly easeInOutQuint: EasingFunction;
+    readonly easeInExpo: EasingFunction;
+    readonly easeOutExpo: EasingFunction;
+    readonly easeInOutExpo: EasingFunction;
+    readonly easeInBack: EasingFunction;
+    readonly easeOutBack: EasingFunction;
+    readonly easeInOutBack: EasingFunction;
+    readonly easeInElastic: EasingFunction;
+    readonly easeOutElastic: EasingFunction;
+    readonly easeInOutElastic: EasingFunction;
+    readonly easeInBounce: EasingFunction;
+    readonly easeOutBounce: EasingFunction;
+    readonly easeInOutBounce: EasingFunction;
+    readonly easeInSine: EasingFunction;
+    readonly easeOutSine: EasingFunction;
+    readonly easeInOutSine: EasingFunction;
+    readonly easeInCirc: EasingFunction;
+    readonly easeOutCirc: EasingFunction;
+    readonly easeInOutCirc: EasingFunction;
+};
+export type EasingName = keyof typeof easings;
+/**
+ * 🔍 Get easing function by name
+ */
+export declare function getEasing(name: EasingName | EasingFunction): EasingFunction;
+/**
+ * 🌊 Create custom spring easing
+ */
+export declare function spring(stiffness?: number, damping?: number, mass?: number): EasingFunction;
+/**
+ * 📈 Create cubic bezier easing
+ */
+export declare function bezier(x1: number, y1: number, x2: number, y2: number): EasingFunction;

package/dist/animations/core/observer.d.ts

@@ -0,0 +1,48 @@
+export interface ObserverOptions {
+    threshold?: number | number[];
+    rootMargin?: string;
+    triggerOnce?: boolean;
+    onEnter?: (entry: IntersectionObserverEntry) => void;
+    onExit?: (entry: IntersectionObserverEntry) => void;
+}
+/**
+ * 👁️ ScrollObserver - لتتبع ظهور العناصر في الشاشة
+ * يستخدم IntersectionObserver API
+ */
+export declare class ScrollObserver {
+    private observer;
+    private elements;
+    constructor();
+    /**
+     * مراقبة عنصر
+     */
+    observe(element: Element, options?: ObserverOptions): void;
+    /**
+     * إيقاف مراقبة عنصر
+     */
+    unobserve(element: Element): void;
+    /**
+     * إيقاف كل المراقبة
+     */
+    disconnect(): void;
+}
+/**
+ * 🎯 Helper: مراقبة عنصر واحد
+ */
+export declare function observeElement(element: Element, options: ObserverOptions): () => void;
+/**
+ * 📊 Helper: مراقبة مجموعة عناصر
+ */
+export declare function observeElements(elements: Element[], options: ObserverOptions): () => void;
+/**
+ * 🎬 Helper: تشغيل animation عند الظهور
+ */
+export declare function animateOnScroll(element: HTMLElement, animationCallback: () => void | Promise<void>, options?: Omit<ObserverOptions, 'onEnter'>): () => void;
+/**
+ * 📈 Get scroll progress (0 to 1)
+ */
+export declare function getScrollProgress(element: Element): number;
+/**
+ * 🎯 Check if element is in viewport
+ */
+export declare function isInViewport(element: Element, threshold?: number): boolean;

package/dist/animations/presets/attention.d.ts

@@ -0,0 +1,12 @@
+import { PresetAnimation } from './fade';
+export declare const shake: PresetAnimation;
+export declare const shakeY: PresetAnimation;
+export declare const pulse: PresetAnimation;
+export declare const pulseLoop: PresetAnimation;
+export declare const heartbeat: PresetAnimation;
+export declare const flash: PresetAnimation;
+export declare const rubberBand: PresetAnimation;
+export declare const jello: PresetAnimation;
+export declare const swing: PresetAnimation;
+export declare const wobble: PresetAnimation;
+export declare const tada: PresetAnimation;

package/dist/animations/presets/bounce.d.ts

@@ -0,0 +1,9 @@
+import { PresetAnimation } from './fade';
+export declare const bounceIn: PresetAnimation;
+export declare const bounceInUp: PresetAnimation;
+export declare const bounceInDown: PresetAnimation;
+export declare const bounceInLeft: PresetAnimation;
+export declare const bounceInRight: PresetAnimation;
+export declare const bounceOut: PresetAnimation;
+export declare const bounce: PresetAnimation;
+export declare const bounceLoop: PresetAnimation;

package/dist/animations/presets/fade.d.ts

@@ -0,0 +1,15 @@
+import { AnimationKeyframe, AnimationConfig } from '../core/animator';
+export interface PresetAnimation {
+    keyframes: AnimationKeyframe[];
+    config?: AnimationConfig;
+}
+export declare const fadeIn: PresetAnimation;
+export declare const fadeInUp: PresetAnimation;
+export declare const fadeInDown: PresetAnimation;
+export declare const fadeInLeft: PresetAnimation;
+export declare const fadeInRight: PresetAnimation;
+export declare const fadeOut: PresetAnimation;
+export declare const fadeOutUp: PresetAnimation;
+export declare const fadeOutDown: PresetAnimation;
+export declare const fadeOutLeft: PresetAnimation;
+export declare const fadeOutRight: PresetAnimation;

package/dist/animations/presets/index.d.ts

@@ -0,0 +1,80 @@
+export type { PresetAnimation } from './fade';
+export { fadeIn, fadeInUp, fadeInDown, fadeInLeft, fadeInRight, fadeOut, fadeOutUp, fadeOutDown, fadeOutLeft, fadeOutRight, } from './fade';
+export { slideInUp, slideInDown, slideInLeft, slideInRight, slideOutUp, slideOutDown, slideOutLeft, slideOutRight, } from './slide';
+export { zoomIn, zoomInUp, zoomInDown, zoomInLeft, zoomInRight, zoomOut, zoomOutUp, zoomOutDown, zoomInBig, zoomInBounce, } from './zoom';
+export { rotateIn, rotateInUpLeft, rotateInUpRight, rotateInDownLeft, rotateInDownRight, rotateOut, spin, spinReverse, spinSlow, spinFast, } from './rotate';
+export { bounceIn, bounceInUp, bounceInDown, bounceInLeft, bounceInRight, bounceOut, bounce, bounceLoop, } from './bounce';
+export { shake, shakeY, pulse, pulseLoop, heartbeat, flash, rubberBand, jello, swing, wobble, tada, } from './attention';
+import * as fade from './fade';
+export declare const presets: {
+    readonly fadeIn: fade.PresetAnimation;
+    readonly fadeInUp: fade.PresetAnimation;
+    readonly fadeInDown: fade.PresetAnimation;
+    readonly fadeInLeft: fade.PresetAnimation;
+    readonly fadeInRight: fade.PresetAnimation;
+    readonly fadeOut: fade.PresetAnimation;
+    readonly fadeOutUp: fade.PresetAnimation;
+    readonly fadeOutDown: fade.PresetAnimation;
+    readonly fadeOutLeft: fade.PresetAnimation;
+    readonly fadeOutRight: fade.PresetAnimation;
+    readonly slideInUp: fade.PresetAnimation;
+    readonly slideInDown: fade.PresetAnimation;
+    readonly slideInLeft: fade.PresetAnimation;
+    readonly slideInRight: fade.PresetAnimation;
+    readonly slideOutUp: fade.PresetAnimation;
+    readonly slideOutDown: fade.PresetAnimation;
+    readonly slideOutLeft: fade.PresetAnimation;
+    readonly slideOutRight: fade.PresetAnimation;
+    readonly zoomIn: fade.PresetAnimation;
+    readonly zoomInUp: fade.PresetAnimation;
+    readonly zoomInDown: fade.PresetAnimation;
+    readonly zoomInLeft: fade.PresetAnimation;
+    readonly zoomInRight: fade.PresetAnimation;
+    readonly zoomOut: fade.PresetAnimation;
+    readonly zoomOutUp: fade.PresetAnimation;
+    readonly zoomOutDown: fade.PresetAnimation;
+    readonly zoomInBig: fade.PresetAnimation;
+    readonly zoomInBounce: fade.PresetAnimation;
+    readonly rotateIn: fade.PresetAnimation;
+    readonly rotateInUpLeft: fade.PresetAnimation;
+    readonly rotateInUpRight: fade.PresetAnimation;
+    readonly rotateInDownLeft: fade.PresetAnimation;
+    readonly rotateInDownRight: fade.PresetAnimation;
+    readonly rotateOut: fade.PresetAnimation;
+    readonly spin: fade.PresetAnimation;
+    readonly spinReverse: fade.PresetAnimation;
+    readonly spinSlow: fade.PresetAnimation;
+    readonly spinFast: fade.PresetAnimation;
+    readonly bounceIn: fade.PresetAnimation;
+    readonly bounceInUp: fade.PresetAnimation;
+    readonly bounceInDown: fade.PresetAnimation;
+    readonly bounceInLeft: fade.PresetAnimation;
+    readonly bounceInRight: fade.PresetAnimation;
+    readonly bounceOut: fade.PresetAnimation;
+    readonly bounce: fade.PresetAnimation;
+    readonly bounceLoop: fade.PresetAnimation;
+    readonly shake: fade.PresetAnimation;
+    readonly shakeY: fade.PresetAnimation;
+    readonly pulse: fade.PresetAnimation;
+    readonly pulseLoop: fade.PresetAnimation;
+    readonly heartbeat: fade.PresetAnimation;
+    readonly flash: fade.PresetAnimation;
+    readonly rubberBand: fade.PresetAnimation;
+    readonly jello: fade.PresetAnimation;
+    readonly swing: fade.PresetAnimation;
+    readonly wobble: fade.PresetAnimation;
+    readonly tada: fade.PresetAnimation;
+};
+export type PresetName = keyof typeof presets;
+/**
+ * Get preset animation by name
+ */
+export declare function getPreset(name: PresetName): fade.PresetAnimation;
+/**
+ * Get all preset names
+ */
+export declare function getPresetNames(): PresetName[];
+/**
+ * Get presets by category
+ */
+export declare function getPresetsByCategory(category: 'fade' | 'slide' | 'zoom' | 'rotate' | 'bounce' | 'attention'): PresetName[];

package/dist/animations/presets/rotate.d.ts

@@ -0,0 +1,11 @@
+import { PresetAnimation } from './fade';
+export declare const rotateIn: PresetAnimation;
+export declare const rotateInUpLeft: PresetAnimation;
+export declare const rotateInUpRight: PresetAnimation;
+export declare const rotateInDownLeft: PresetAnimation;
+export declare const rotateInDownRight: PresetAnimation;
+export declare const rotateOut: PresetAnimation;
+export declare const spin: PresetAnimation;
+export declare const spinReverse: PresetAnimation;
+export declare const spinSlow: PresetAnimation;
+export declare const spinFast: PresetAnimation;

package/dist/animations/presets/slide.d.ts

@@ -0,0 +1,9 @@
+import { PresetAnimation } from './fade';
+export declare const slideInUp: PresetAnimation;
+export declare const slideInDown: PresetAnimation;
+export declare const slideInLeft: PresetAnimation;
+export declare const slideInRight: PresetAnimation;
+export declare const slideOutUp: PresetAnimation;
+export declare const slideOutDown: PresetAnimation;
+export declare const slideOutLeft: PresetAnimation;
+export declare const slideOutRight: PresetAnimation;

package/dist/animations/presets/zoom.d.ts

@@ -0,0 +1,11 @@
+import { PresetAnimation } from './fade';
+export declare const zoomIn: PresetAnimation;
+export declare const zoomInUp: PresetAnimation;
+export declare const zoomInDown: PresetAnimation;
+export declare const zoomInLeft: PresetAnimation;
+export declare const zoomInRight: PresetAnimation;
+export declare const zoomOut: PresetAnimation;
+export declare const zoomOutUp: PresetAnimation;
+export declare const zoomOutDown: PresetAnimation;
+export declare const zoomInBig: PresetAnimation;
+export declare const zoomInBounce: PresetAnimation;

package/dist/animations/react/TeleMotion.d.ts

@@ -0,0 +1,18 @@
+import { default as React, ReactNode } from 'react';
+import { PresetName } from '../presets';
+export interface TeleMotionProps {
+    children: ReactNode;
+    preset?: PresetName;
+    duration?: number;
+    delay?: number;
+    easing?: string;
+    iterations?: number;
+    trigger?: 'mount' | 'hover' | 'click' | 'scroll';
+    threshold?: number;
+    triggerOnce?: boolean;
+    onAnimationStart?: () => void;
+    onAnimationEnd?: () => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare const TeleMotion: React.FC<TeleMotionProps>;

package/dist/animations/react/hooks.d.ts

@@ -0,0 +1,21 @@
+import { RefObject } from 'react';
+import { AnimationConfig, AnimationKeyframe } from '../core/animator';
+import { PresetName } from '../presets';
+export declare function useAnimator<T extends HTMLElement = HTMLDivElement>(): [
+    RefObject<T>,
+    (keyframes: AnimationKeyframe[], config?: AnimationConfig) => Promise<void>
+];
+export declare function usePresetAnimation<T extends HTMLElement = HTMLDivElement>(preset: PresetName, config?: AnimationConfig & {
+    trigger?: 'mount' | 'manual';
+}): [RefObject<T>, () => Promise<void>];
+export declare function useScrollAnimation<T extends HTMLElement = HTMLDivElement>(preset: PresetName, options?: {
+    threshold?: number;
+    triggerOnce?: boolean;
+    config?: AnimationConfig;
+}): RefObject<T>;
+export declare function useStagger<T extends HTMLElement = HTMLDivElement>(preset: PresetName, staggerDelay?: number, config?: AnimationConfig): [RefObject<T>, () => Promise<void>];
+export declare function useHoverAnimation<T extends HTMLElement = HTMLDivElement>(preset: PresetName, config?: AnimationConfig): [RefObject<T>, {
+    onMouseEnter: () => void;
+    onMouseLeave: () => void;
+}];
+export declare function useInView<T extends HTMLElement = HTMLDivElement>(threshold?: number): [RefObject<T>, boolean];

package/dist/animations/react/index.d.ts

@@ -0,0 +1,3 @@
+export { TeleMotion } from './TeleMotion';
+export type { TeleMotionProps } from './TeleMotion';
+export { useAnimator, usePresetAnimation, useScrollAnimation, useStagger, useHoverAnimation, useInView, } from './hooks';

package/dist/animations/test.d.ts

@@ -0,0 +1 @@
+export declare function testAnimations(): boolean;

package/dist/index.d.ts

@@ -12,3 +12,14 @@ export { Container, ContainerImage, ContainerContent, ContainerButton } from './
 export type { ContainerProps, ContainerImageProps, ContainerContentProps, ContainerButtonProps, ContainerLayout, ContainerSize, ContainerTheme } from './components/Container/types';
 export { FeatureCard, ProductCard, StatCard } from './components/Cards';
 export type { FeatureCardProps, ProductCardProps, StatCardProps, CardVariant } from './components/Cards';
+export { Animator, createAnimator, animateGroup, sequence, parallel } from './animations/core/animator';
+export type { AnimationConfig, AnimationKeyframe, EasingFunction } from './animations/core/animator';
+export { easings, getEasing, spring, bezier } from './animations/core/easing';
+export type { EasingName } from './animations/core/easing';
+export { ScrollObserver, observeElement, observeElements, animateOnScroll, getScrollProgress, isInViewport } from './animations/core/observer';
+export type { ObserverOptions } from './animations/core/observer';
+export { presets, getPreset, getPresetNames, getPresetsByCategory } from './animations/presets';
+export type { PresetAnimation, PresetName } from './animations/presets';
+export { TeleMotion } from './animations/react';
+export type { TeleMotionProps } from './animations/react';
+export { useAnimator, usePresetAnimation, useScrollAnimation, useStagger, useHoverAnimation, useInView } from './animations/react';