scroll-system 1.0.1 → 1.1.1

package/dist/hooks/useInfiniteScroll.d.ts

@@ -0,0 +1,41 @@
+/**
+ * useInfiniteScroll Hook
+ * ========================================
+ * Enables infinite/loop scroll behavior.
+ * Wraps navigation from last view to first and vice versa.
+ */
+import type { InfiniteScrollConfig } from "../types";
+export interface InfiniteScrollState {
+    /** Whether infinite scroll is enabled */
+    isEnabled: boolean;
+    /** Enable infinite scroll */
+    enable: () => void;
+    /** Disable infinite scroll */
+    disable: () => void;
+    /** Toggle infinite scroll */
+    toggle: () => void;
+    /** Check if can loop forward (at last view) */
+    canLoopForward: boolean;
+    /** Check if can loop backward (at first view) */
+    canLoopBackward: boolean;
+}
+/**
+ * Hook to control infinite scroll behavior.
+ *
+ * @example
+ * ```tsx
+ * // Simple usage - enable infinite scroll
+ * useInfiniteScroll({ enabled: true });
+ *
+ * // With controls
+ * const { isEnabled, toggle } = useInfiniteScroll({ enabled: true });
+ *
+ * return (
+ *   <button onClick={toggle}>
+ *     Loop: {isEnabled ? 'ON' : 'OFF'}
+ *   </button>
+ * );
+ * ```
+ */
+export declare function useInfiniteScroll(config?: boolean | InfiniteScrollConfig): InfiniteScrollState;
+//# sourceMappingURL=useInfiniteScroll.d.ts.map

package/dist/hooks/useInfiniteScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteScroll.d.ts","sourceRoot":"","sources":["../../hooks/useInfiniteScroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAOrD,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,+CAA+C;IAC/C,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,OAAO,GAAG,oBAA4B,GAC7C,mBAAmB,CA4CrB"}

package/dist/hooks/useKeyboardHandler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Scroll System - Keyboard Handler
+ * =========================================
+ * Captures keyboard input and translates it to navigation intentions.
+ *
+ * Supported Keys:
+ * - ArrowUp / ArrowDown: Navigate between views
+ * - PageUp / PageDown: Navigate between views
+ * - Space: Navigate to next view (Shift+Space for previous)
+ * - Home / End: Go to first / last view
+ */
+export interface UseKeyboardHandlerOptions {
+    /** Enable/disable keyboard navigation (default: true) */
+    enabled?: boolean;
+    /** Prevent default behavior for handled keys (default: true) */
+    preventDefault?: boolean;
+}
+export declare function useKeyboardHandler(options?: UseKeyboardHandlerOptions): void;
+export default useKeyboardHandler;
+//# sourceMappingURL=useKeyboardHandler.d.ts.map

package/dist/hooks/useKeyboardHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardHandler.d.ts","sourceRoot":"","sources":["../../hooks/useKeyboardHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,yBAAyB;IACxC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,QA8EzE;AAED,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useMetricsReporter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Scroll System - Metrics Reporter Hook
+ * =============================================
+ * Hook reutilizable para medir y reportar métricas al Store.
+ * Encapsula ResizeObserver y Scroll Listeners.
+ *
+ * Performance: Throttled to ~15fps (66ms) for scroll events.
+ */
+import type { ScrollDirection } from "../types";
+interface UseMetricsReporterOptions {
+    id: string;
+    isActive: boolean;
+    scrollDirection: ScrollDirection;
+    onScrollProgress?: (progress: number) => void;
+    /** Custom throttle interval (default: 66ms / ~15fps) */
+    throttleMs?: number;
+}
+export declare function useMetricsReporter({ id, isActive, scrollDirection, onScrollProgress, throttleMs, }: UseMetricsReporterOptions): {
+    scrollRef: import("react").RefObject<HTMLDivElement>;
+    measureAndReport: () => void;
+};
+export {};
+//# sourceMappingURL=useMetricsReporter.d.ts.map

package/dist/hooks/useMetricsReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMetricsReporter.d.ts","sourceRoot":"","sources":["../../hooks/useMetricsReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,UAAU,CAAC;AAK7D,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,EAAE,EACF,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,UAA+B,GAChC,EAAE,yBAAyB;;;EAiE3B"}

package/dist/hooks/useNavigation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * PABRIX Scroll System - Navigation Hook
+ * =======================================
+ * Hook principal para interactuar con el sistema de navegación.
+ * Provee una API limpia y tipada para controlar la navegación.
+ */
+/**
+ * Hook para acceder a la API de navegación del sistema de scroll
+ *
+ * @deprecated Use `useScrollSystem` instead. This hook will be removed in future versions.
+ *
+ * @example
+ * ```tsx
+ * const { goToView, goToNext, activeIndex } = useNavigation();
+ *
+ * // Navegar a una vista específica
+ * goToView('hero');
+ * goToView(2);
+ *
+ * // Navegar secuencialmente
+ * goToNext();
+ * goToPrevious();
+ * ```
+ */
+export declare function useNavigation(): {
+    goToView: (indexOrId: number | string) => void;
+    goToNext: () => void;
+    goToPrevious: () => void;
+    lockScroll: () => void;
+    unlockScroll: () => void;
+    activeIndex: number;
+    activeId: string | null;
+    totalViews: number;
+    isTransitioning: boolean;
+    isScrollLocked: boolean;
+    canNavigateNext: boolean;
+    canNavigatePrevious: boolean;
+    isFirstView: boolean;
+    isLastView: boolean;
+    progress: number;
+};
+//# sourceMappingURL=useNavigation.d.ts.map

package/dist/hooks/useNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigation.d.ts","sourceRoot":"","sources":["../../hooks/useNavigation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa;;;;;;;;;;;;;;;;EAmF5B"}

package/dist/hooks/useParallax.d.ts

@@ -0,0 +1,33 @@
+/**
+ * useParallax Hook
+ * ========================================
+ * Enables parallax effects for elements within views.
+ * Calculates transform values based on scroll progress.
+ */
+import type { ParallaxConfig, ParallaxState } from "../types";
+/**
+ * Hook to create parallax effects within views.
+ *
+ * @param viewId - The ID of the view this parallax belongs to
+ * @param config - Parallax configuration
+ *
+ * @example
+ * ```tsx
+ * function HeroSection() {
+ *   const { style } = useParallax("hero", { speed: 0.3 });
+ *
+ *   return (
+ *     <div style={style}>
+ *       <img src="/background.jpg" alt="Background" />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useParallax(viewId: string, config?: ParallaxConfig): ParallaxState;
+/**
+ * Simplified hook for parallax on active view only.
+ * Uses global progress instead of view-specific calculations.
+ */
+export declare function useActiveParallax(config?: ParallaxConfig): ParallaxState;
+//# sourceMappingURL=useParallax.d.ts.map

package/dist/hooks/useParallax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParallax.d.ts","sourceRoot":"","sources":["../../hooks/useParallax.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkB9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,cAAmB,GAC1B,aAAa,CAsDf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,cAAmB,GAAG,aAAa,CAiC5E"}

package/dist/hooks/usePreload.d.ts

@@ -0,0 +1,31 @@
+/**
+ * usePreload Hook
+ * ========================================
+ * Manages view preloading for smoother transitions.
+ * Pre-renders adjacent views based on configuration.
+ */
+import type { PreloadConfig } from "../types";
+export interface PreloadState {
+    /** Whether a specific view should be preloaded */
+    shouldPreload: (viewId: string) => boolean;
+    /** List of view IDs that should be preloaded */
+    preloadedViewIds: string[];
+    /** Check if a view is currently preloaded */
+    isPreloaded: (viewId: string) => boolean;
+}
+/**
+ * Hook to manage view preloading.
+ *
+ * @example
+ * ```tsx
+ * const { shouldPreload, preloadedViewIds } = usePreload({ ahead: 2, behind: 1 });
+ *
+ * // In your view component:
+ * if (!shouldPreload(viewId)) {
+ *   return <Placeholder />;
+ * }
+ * return <ActualContent />;
+ * ```
+ */
+export declare function usePreload(config?: PreloadConfig): PreloadState;
+//# sourceMappingURL=usePreload.d.ts.map

package/dist/hooks/usePreload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreload.d.ts","sourceRoot":"","sources":["../../hooks/usePreload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQ9C,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,aAAkB,GAAG,YAAY,CA8DnE"}

package/dist/hooks/useScrollAnalytics.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Scroll System - Analytics Hook
+ * ================================
+ * Tracks view engagement metrics for analytics.
+ */
+export interface ViewAnalytics {
+    viewId: string;
+    viewIndex: number;
+    enterTime: number;
+    exitTime: number | null;
+    duration: number;
+    isActive: boolean;
+}
+export interface UseScrollAnalyticsOptions {
+    /** Callback when user enters a view */
+    onViewEnter?: (analytics: ViewAnalytics) => void;
+    /** Callback when user exits a view */
+    onViewExit?: (analytics: ViewAnalytics) => void;
+    /** Enable/disable tracking (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for tracking view engagement analytics.
+ *
+ * @example
+ * ```tsx
+ * useScrollAnalytics({
+ *   onViewEnter: (data) => analytics.track("view_enter", data),
+ *   onViewExit: (data) => analytics.track("view_exit", { ...data, duration: data.duration }),
+ * });
+ * ```
+ */
+export declare function useScrollAnalytics(options?: UseScrollAnalyticsOptions): {
+    currentViewId: string | null;
+    currentViewIndex: number;
+    viewStartTime: number;
+    getTimeInView: () => number;
+};
+export default useScrollAnalytics;
+//# sourceMappingURL=useScrollAnalytics.d.ts.map

package/dist/hooks/useScrollAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollAnalytics.d.ts","sourceRoot":"","sources":["../../hooks/useScrollAnalytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,sCAAsC;IACtC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B;;;;;EAsEzE;AAED,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useScrollLock.d.ts

@@ -0,0 +1,40 @@
+/**
+ * useScrollLock Hook
+ * ========================================
+ * Programmatic control for locking/unlocking scroll navigation.
+ * Useful for modals, forms, or any scenario requiring temporary navigation prevention.
+ */
+export interface ScrollLockState {
+    /** Whether global navigation is currently locked */
+    isLocked: boolean;
+    /** Lock global navigation */
+    lock: () => void;
+    /** Unlock global navigation */
+    unlock: () => void;
+    /** Toggle lock state */
+    toggle: () => void;
+    /** Lock a specific view by ID */
+    lockView: (viewId: string) => void;
+    /** Unlock a specific view by ID */
+    unlockView: (viewId: string) => void;
+}
+/**
+ * Hook for programmatic control of scroll navigation locking.
+ *
+ * @example
+ * ```tsx
+ * const { lock, unlock, isLocked } = useScrollLock();
+ *
+ * const openModal = () => {
+ *   lock();
+ *   setModalOpen(true);
+ * };
+ *
+ * const closeModal = () => {
+ *   unlock();
+ *   setModalOpen(false);
+ * };
+ * ```
+ */
+export declare function useScrollLock(): ScrollLockState;
+//# sourceMappingURL=useScrollLock.d.ts.map

package/dist/hooks/useScrollLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollLock.d.ts","sourceRoot":"","sources":["../../hooks/useScrollLock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,wBAAwB;IACxB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,mCAAmC;IACnC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAiC/C"}

package/dist/hooks/useScrollSystem.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Scroll System - Public API Hook
+ * =======================================
+ * Facade principal para el uso de la librería.
+ * Expone una API estable y documentada.
+ */
+import type { ScrollSystemAPI } from "../types";
+/**
+ * Hook principal para consumir el sistema de scroll.
+ * Retorna la API pública del sistema.
+ */
+export declare function useScrollSystem(): ScrollSystemAPI & {
+    isDragging: boolean;
+    isTransitioning: boolean;
+};
+//# sourceMappingURL=useScrollSystem.d.ts.map

package/dist/hooks/useScrollSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollSystem.d.ts","sourceRoot":"","sources":["../../hooks/useScrollSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,eAAe,GAAG;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAqFrG"}

package/dist/hooks/useSnapPoints.d.ts

@@ -0,0 +1,77 @@
+/**
+ * useSnapPoints Hook
+ * ========================================
+ * Manages snap points within views for sub-view navigation.
+ * Enables multiple "stops" within a single scrollable view.
+ */
+import type { SnapPoint } from "../types";
+export interface UseSnapPointsOptions {
+    /** The view ID this snap points system belongs to */
+    viewId: string;
+    /** Array of snap points */
+    points: SnapPoint[];
+    /** Threshold for snapping (0-1, default: 0.1) */
+    snapThreshold?: number;
+    /** Enable smooth scrolling to snap points */
+    smoothScroll?: boolean;
+}
+export interface SnapPointsState {
+    /** Current active snap point */
+    activePoint: SnapPoint | null;
+    /** Index of the active snap point */
+    activeIndex: number;
+    /** Navigate to a specific snap point */
+    goToPoint: (pointId: string) => void;
+    /** Navigate to next snap point */
+    goToNextPoint: () => void;
+    /** Navigate to previous snap point */
+    goToPrevPoint: () => void;
+    /** All snap points with active state */
+    points: (SnapPoint & {
+        isActive: boolean;
+    })[];
+    /** Current progress within snap points (0-1) */
+    progress: number;
+}
+/**
+ * Hook to manage snap points within a view.
+ *
+ * @example
+ * ```tsx
+ * const snapPoints = [
+ *   { id: 'intro', position: 0, label: 'Introduction' },
+ *   { id: 'features', position: 0.33, label: 'Features' },
+ *   { id: 'pricing', position: 0.66, label: 'Pricing' },
+ *   { id: 'cta', position: 1, label: 'Get Started' },
+ * ];
+ *
+ * function LongView() {
+ *   const { activePoint, goToNextPoint } = useSnapPoints({
+ *     viewId: 'landing',
+ *     points: snapPoints,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <nav>
+ *         {snapPoints.map(p => (
+ *           <button key={p.id} className={activePoint?.id === p.id ? 'active' : ''}>
+ *             {p.label}
+ *           </button>
+ *         ))}
+ *       </nav>
+ *       <button onClick={goToNextPoint}>Next Section</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useSnapPoints(options: UseSnapPointsOptions): SnapPointsState;
+/**
+ * Utility to create snap points from an array of positions.
+ */
+export declare function createSnapPoints(positions: number[], options?: {
+    prefix?: string;
+    labels?: string[];
+}): SnapPoint[];
+//# sourceMappingURL=useSnapPoints.d.ts.map

package/dist/hooks/useSnapPoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSnapPoints.d.ts","sourceRoot":"","sources":["../../hooks/useSnapPoints.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,UAAU,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,kCAAkC;IAClC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,sCAAsC;IACtC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,wCAAwC;IACxC,MAAM,EAAE,CAAC,SAAS,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,EAAE,CAAC;IAC9C,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CA+H5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/C,SAAS,EAAE,CAQb"}

package/dist/hooks/useTouchHandler.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Scroll System - Touch Handler
+ * =====================================
+ * Determina la INTENCIÓN del usuario basada en Gestos Táctiles (Swipe).
+ * Traduce Touch Events -> Intention -> Store.processIntention()
+ */
+export interface UseTouchHandlerOptions {
+    /** Enable/disable the touch handler (default: true) */
+    enabled?: boolean;
+}
+export declare function useTouchHandler(options?: UseTouchHandlerOptions): void;
+//# sourceMappingURL=useTouchHandler.d.ts.map

package/dist/hooks/useTouchHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTouchHandler.d.ts","sourceRoot":"","sources":["../../hooks/useTouchHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,QA6DnE"}

package/dist/hooks/useViewProgress.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PABRIX Scroll System - View Progress Hook (Read Only)
+ * ======================================================
+ * Hook para obtener el progreso de scroll de una vista desde el Store.
+ * NOTA: Ya no actualiza el progreso, solo lo lee.
+ * Las actualizaciones ocurren vía useMetricsReporter.
+ */
+import type { NavigationState } from "../types";
+interface UseViewProgressResult {
+    progress: number;
+    isAtStart: boolean;
+    isAtEnd: boolean;
+    navigation: NavigationState;
+}
+export declare function useViewProgress(viewId: string): UseViewProgressResult;
+export declare function useActiveViewProgress(): {
+    progress: number;
+    hasInternalScroll: boolean;
+    viewType: import("..").ViewType;
+};
+export {};
+//# sourceMappingURL=useViewProgress.d.ts.map

package/dist/hooks/useViewProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewProgress.d.ts","sourceRoot":"","sources":["../../hooks/useViewProgress.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAmBrE;AAED,wBAAgB,qBAAqB;;;;EAWpC"}

package/dist/hooks/useViewRegistration.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Scroll System - View Registration Hook
+ * ==============================================
+ * Hook para registrar vistas en el sistema.
+ * Maneja el ciclo de vida de registro/des-registro.
+ */
+import type { ViewConfig } from "../types";
+interface UseViewRegistrationOptions {
+    config: ViewConfig;
+    onActivate?: () => void;
+    onDeactivate?: () => void;
+    onEnterStart?: () => void;
+    onEnterEnd?: () => void;
+    onExitStart?: () => void;
+    onExitEnd?: () => void;
+}
+export declare function useViewRegistration({ config, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: UseViewRegistrationOptions): {
+    isActive: boolean;
+    viewState: import("..").ViewState | undefined;
+    index: number;
+    scrollProgress: number;
+    navigation: import("..").NavigationState;
+};
+export {};
+//# sourceMappingURL=useViewRegistration.d.ts.map

package/dist/hooks/useViewRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewRegistration.d.ts","sourceRoot":"","sources":["../../hooks/useViewRegistration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,UAAU,0BAA0B;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAE1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACV,EAAE,0BAA0B;;;;;;EAsF5B"}

package/dist/hooks/useWheelHandler.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PABRIX Scroll System - Wheel Handler
+ * =====================================
+ * Determina la INTENCIÓN del usuario basada en eventos de Wheel.
+ * Traduce deltaY -> Intention -> Store.processIntention()
+ */
+export declare function useWheelHandler(): void;
+//# sourceMappingURL=useWheelHandler.d.ts.map

package/dist/hooks/useWheelHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWheelHandler.d.ts","sourceRoot":"","sources":["../../hooks/useWheelHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,eAAe,SA2F9B"}