scroll-system 1.0.1 → 1.1.1

package/dist/index.d.ts

@@ -1,2010 +1,17 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React$1 from 'react';
-import React__default from 'react';
-import * as zustand from 'zustand';
-
 /**
- * Scroll System - Type Definitions
- * ========================================
- * Sistema de scroll tipo TikTok con arquitectura determinística.
- * El Store es la única fuente de verdad.
- */
-/**
- * Capacidad física de scroll de una vista.
- * Distingue si el contenido cabe o no en el viewport.
- */
-type ScrollCapability = "none" | "internal";
-/**
- * Estado de permiso de navegación.
- */
-type NavigationState = "locked" | "unlocked";
-/**
- * Métricas crudas del DOM reportadas por las vistas.
- */
-interface ViewMetrics {
-    scrollHeight: number;
-    clientHeight: number;
-    scrollTop: number;
-}
-type UserIntentionType = "scroll" | "navigate";
-type UserDirection = "up" | "down" | "left" | "right";
-interface UserIntention {
-    type: UserIntentionType;
-    direction: UserDirection;
-    strength: number;
-    origin: "wheel" | "touch" | "keyboard" | "programmatic";
-}
-interface ScrollSystemAPI {
-    goToNext: () => boolean;
-    goToPrev: () => boolean;
-    goTo: (index: number | string) => void;
-    getCurrentIndex: () => number;
-    getProgress: () => number;
-    getActiveViewProgress: () => number;
-    isLocked: () => boolean;
-    canGoNext: boolean;
-    canGoPrev: boolean;
-    activeIndex: number;
-    activeId: string | null;
-    activeViewType: ViewType | null;
-    totalViews: number;
-}
-type ViewType = "full" | "scroll-locked" | "controlled";
-type ScrollDirection = "vertical" | "horizontal" | "none";
-interface BaseViewConfig {
-    id: string;
-    type: ViewType;
-    index?: number;
-    meta?: Record<string, unknown>;
-}
-interface FullViewConfig extends BaseViewConfig {
-    type: "full";
-}
-interface ScrollLockedViewConfig extends BaseViewConfig {
-    type: "scroll-locked";
-    scrollDirection: ScrollDirection;
-    scrollEndThreshold?: number;
-}
-interface ControlledViewConfig extends BaseViewConfig {
-    type: "controlled";
-    scrollDirection?: ScrollDirection;
-    allowInternalScroll?: boolean;
-    allowGoBack?: boolean;
-}
-type ViewConfig = FullViewConfig | ScrollLockedViewConfig | ControlledViewConfig;
-interface ViewState {
-    id: string;
-    index: number;
-    type: ViewType;
-    isActive: boolean;
-    capability: ScrollCapability;
-    navigation: NavigationState;
-    explicitLock: NavigationState | null;
-    progress: number;
-    metrics: ViewMetrics;
-    config: ViewConfig;
-}
-interface ScrollSystemState {
-    views: ViewState[];
-    activeIndex: number;
-    activeId: string | null;
-    totalViews: number;
-    isInitialized: boolean;
-    isTransitioning: boolean;
-    isGlobalLocked: boolean;
-    isDragging: boolean;
-    globalProgress: number;
-}
-interface ScrollSystemActions {
-    initialize: () => void;
-    registerView: (config: ViewConfig) => void;
-    unregisterView: (id: string) => void;
-    processIntention: (intention: UserIntention) => boolean;
-    goToNext: () => void;
-    goToPrevious: () => void;
-    goToView: (indexOrId: number | string) => void;
-    updateViewMetrics: (id: string, metrics: ViewMetrics) => void;
-    setViewExplicitLock: (id: string, lock: NavigationState | null) => void;
-    setGlobalLock: (locked: boolean) => void;
-    setDragging: (dragging: boolean) => void;
-    startTransition: () => void;
-    endTransition: () => void;
-    resetNavigationCooldown: () => void;
-}
-type ScrollSystemStore = ScrollSystemState & ScrollSystemActions;
-interface BaseViewProps {
-    id: string;
-    children: React.ReactNode;
-    className?: string;
-    onActivate?: () => void;
-    onDeactivate?: () => void;
-    /** Called when view starts entering (transition begins) */
-    onEnterStart?: () => void;
-    /** Called when view finishes entering (transition complete) */
-    onEnterEnd?: () => void;
-    /** Called when view starts exiting (transition begins) */
-    onExitStart?: () => void;
-    /** Called when view finishes exiting (transition complete) */
-    onExitEnd?: () => void;
-}
-interface FullViewProps extends BaseViewProps {
-    meta?: Record<string, unknown>;
-}
-interface ScrollLockedViewProps extends BaseViewProps {
-    scrollDirection?: ScrollDirection;
-    scrollEndThreshold?: number;
-    onScrollProgress?: (progress: number) => void;
-}
-interface ControlledViewProps extends BaseViewProps {
-    scrollDirection?: ScrollDirection;
-    allowInternalScroll?: boolean;
-    canProceed?: boolean;
-    allowGoBack?: boolean;
-}
-interface ScrollContainerProps {
-    children: React.ReactNode;
-    className?: string;
-    transitionDuration?: number;
-    transitionEasing?: string;
-    onViewChange?: (fromIndex: number, toIndex: number) => void;
-    onInitialized?: () => void;
-    /** Enable URL hash sync for deep linking (default: false) */
-    enableHashSync?: boolean;
-    /** Use pushState instead of replaceState for hash updates (default: false) */
-    hashPushHistory?: boolean;
-    /** Prefix for hash (e.g., "section-" creates "#section-hero") */
-    hashPrefix?: string;
-    /** Respect prefers-reduced-motion OS setting (default: true) */
-    respectReducedMotion?: boolean;
-    /** Enable focus management for screen readers (default: true) */
-    enableFocusManagement?: boolean;
-    /** Enable 1:1 drag physics for touch devices (default: false) */
-    enableDragPhysics?: boolean;
-    /** Scroll orientation: vertical or horizontal (default: "vertical") */
-    orientation?: "vertical" | "horizontal";
-}
-
-declare function ScrollContainer$1({ children, className, transitionDuration, transitionEasing, onViewChange, onInitialized, enableHashSync, hashPushHistory, hashPrefix, respectReducedMotion, enableFocusManagement, enableDragPhysics, orientation, }: ScrollContainerProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Vista que ocupa el 100% del viewport sin scroll interno.
- * Ideal para hero sections, splash screens, o secciones de impacto visual.
- *
- * @example
- * ```tsx
- * <FullView id="hero">
- *   <h1>Welcome to PABRIX</h1>
- * </FullView>
- * ```
- */
-declare function FullView$1({ id, children, className, meta, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: FullViewProps): react_jsx_runtime.JSX.Element;
-
-declare function ScrollLockedView$1({ id, children, className, scrollDirection, scrollEndThreshold, onScrollProgress, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: ScrollLockedViewProps): react_jsx_runtime.JSX.Element;
-
-declare function ControlledView$1({ id, children, className, scrollDirection, allowInternalScroll, canProceed, allowGoBack, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: ControlledViewProps): react_jsx_runtime.JSX.Element;
-declare function useViewControl$1(viewId: string): {
-    unlock: () => void;
-    lock: () => void;
-    goNext: () => void;
-    goPrev: () => void;
-    goTo: (to: number | string) => void;
-};
-
-/**
- * Scroll System - Debug Overlay
- * ===============================
- * Visual debugging component for the scroll system.
- * Shows internal state in real-time for development.
- *
- * Usage: <ScrollDebugOverlay /> inside ScrollContainer
- */
-interface ScrollDebugOverlayProps {
-    /** Position of the overlay (default: "bottom-left") */
-    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
-    /** Show/hide the overlay (default: true) */
-    visible?: boolean;
-}
-declare function ScrollDebugOverlay$1({ position, visible, }: ScrollDebugOverlayProps): react_jsx_runtime.JSX.Element | null;
-
-/**
- * Scroll System - Aria Live Region
- * ==================================
- * Announces view changes to screen readers.
- */
-interface AriaLiveRegionProps {
-    /** Custom announcement template. Use {viewIndex} and {viewId} as placeholders */
-    template?: string;
-    /** Politeness level for announcements */
-    politeness?: "polite" | "assertive";
-}
-/**
- * Invisible component that announces view changes to screen readers.
- * Place inside ScrollContainer.
- */
-declare function AriaLiveRegion$1({ template, politeness, }: AriaLiveRegionProps): react_jsx_runtime.JSX.Element;
-
-interface LazyViewProps {
-    /** The view ID to track */
-    viewId: string;
-    /** Number of views before/after active to render (default: 1) */
-    buffer?: number;
-    /** Content to render when lazy loading */
-    children: React__default.ReactNode;
-    /** Placeholder to show when not in range */
-    placeholder?: React__default.ReactNode;
-}
-/**
- * Wraps view content to only render when within the active range.
- * Improves performance for apps with many views.
- *
- * @example
- * ```tsx
- * <FullView id="section-3">
- *   <LazyView viewId="section-3">
- *     <HeavyComponent />
- *   </LazyView>
- * </FullView>
- * ```
- */
-declare function LazyView$1({ viewId, buffer, children, placeholder, }: LazyViewProps): react_jsx_runtime.JSX.Element;
-
-/**
- * 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();
- * ```
- */
-declare function useNavigation$1(): {
-    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;
-};
-
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// index.ts
-var index_exports = {};
-__export(index_exports, {
-  AriaLiveRegion: () => AriaLiveRegion,
-  ControlledView: () => ControlledView,
-  DEFAULT_PROGRESS_DEBOUNCE: () => DEFAULT_PROGRESS_DEBOUNCE$1,
-  DEFAULT_TRANSITION_DURATION: () => DEFAULT_TRANSITION_DURATION$1,
-  DEFAULT_TRANSITION_EASING: () => DEFAULT_TRANSITION_EASING$1,
-  FullView: () => FullView,
-  LazyView: () => LazyView,
-  NAVIGATION_COOLDOWN: () => NAVIGATION_COOLDOWN$1,
-  NAV_THRESHOLDS: () => NAV_THRESHOLDS$1,
-  ScrollContainer: () => ScrollContainer,
-  ScrollDebugOverlay: () => ScrollDebugOverlay,
-  ScrollLockedView: () => ScrollLockedView,
-  selectActiveView: () => selectActiveView$1,
-  selectActiveViewProgress: () => selectActiveViewProgress$1,
-  selectCanNavigateNext: () => selectCanNavigateNext$1,
-  selectCanNavigatePrevious: () => selectCanNavigatePrevious$1,
-  useActiveViewProgress: () => useActiveViewProgress$1,
-  useDragHandler: () => useDragHandler$1,
-  useFocusManagement: () => useFocusManagement$1,
-  useHashSync: () => useHashSync$1,
-  useKeyboardHandler: () => useKeyboardHandler$1,
-  useMetricsReporter: () => useMetricsReporter$1,
-  useNavigation: () => useNavigation,
-  useScrollAnalytics: () => useScrollAnalytics$1,
-  useScrollStore: () => useScrollStore$1,
-  useScrollSystem: () => useScrollSystem$1,
-  useTouchHandler: () => useTouchHandler$1,
-  useViewControl: () => useViewControl,
-  useViewProgress: () => useViewProgress$1,
-  useViewRegistration: () => useViewRegistration$1,
-  useWheelHandler: () => useWheelHandler$1
-});
-module.exports = __toCommonJS(index_exports);
-
-// components/ScrollContainer.tsx
-var import_react8 = require("react");
-
-// store/navigation.store.ts
-var import_zustand = require("zustand");
-var import_middleware = require("zustand/middleware");
-
-// constants.ts
-var DEFAULT_TRANSITION_DURATION$1 = 700;
-var DEFAULT_TRANSITION_EASING$1 = "cubic-bezier(0.645, 0.045, 0.355, 1.000)";
-var DEFAULT_PROGRESS_DEBOUNCE$1 = 16;
-var NAVIGATION_COOLDOWN$1 = 500;
-var NAV_THRESHOLDS$1 = {
-  WHEEL: 60,
-  // Acumulado de deltaY para disparar navegación
-  TOUCH: 50
-  // Píxeles de distancia para considerar swipe
-};
-
-// store/navigation.store.ts
-function evaluateStateMachine(capability, progress, viewType, explicitLock) {
-  if (explicitLock) return explicitLock;
-  if (capability === "none") return "unlocked";
-  if (viewType === "full") return "unlocked";
-  if (progress >= 0.99) return "unlocked";
-  return "locked";
-}
-function calculateCapability(metrics) {
-  if (metrics.scrollHeight - metrics.clientHeight <= 1) {
-    return "none";
-  }
-  return "internal";
-}
-function calculateProgress(metrics) {
-  const maxScroll = metrics.scrollHeight - metrics.clientHeight;
-  if (maxScroll <= 1) return 1;
-  return Math.max(0, Math.min(1, metrics.scrollTop / maxScroll));
-}
-var initialState = {
-  views: [],
-  activeIndex: 0,
-  activeId: null,
-  totalViews: 0,
-  isInitialized: false,
-  isTransitioning: false,
-  isGlobalLocked: false,
-  isDragging: false,
-  globalProgress: 0
-};
-var lastNavigationTime = 0;
-var useScrollStore$1 = (0, import_zustand.create)()(
-  (0, import_middleware.subscribeWithSelector)((set, get) => ({
-    ...initialState,
-    initialize: () => {
-      const { views } = get();
-      if (views.length > 0) {
-        set({
-          isInitialized: true,
-          activeId: views[0]?.id ?? null,
-          activeIndex: 0
-        });
-      }
-    },
-    registerView: (config) => {
-      set((state) => {
-        if (state.views.some((v) => v.id === config.id)) return state;
-        const newIndex = state.views.length;
-        const newView = {
-          id: config.id,
-          index: newIndex,
-          type: config.type,
-          isActive: newIndex === 0,
-          capability: "none",
-          navigation: "unlocked",
-          explicitLock: null,
-          progress: 0,
-          metrics: { scrollHeight: 0, clientHeight: 0, scrollTop: 0 },
-          config
-        };
-        const newViews = [...state.views, newView];
-        return {
-          views: newViews,
-          totalViews: newViews.length,
-          activeId: state.activeId ?? newView.id
-        };
-      });
-    },
-    unregisterView: (id) => {
-      set((state) => {
-        const newViews = state.views.filter((v) => v.id !== id).map((v, idx) => ({ ...v, index: idx }));
-        const newActiveIndex = Math.min(state.activeIndex, newViews.length - 1);
-        return {
-          views: newViews,
-          totalViews: newViews.length,
-          activeIndex: Math.max(0, newActiveIndex),
-          activeId: newViews[newActiveIndex]?.id ?? null
-        };
-      });
-    },
-    updateViewMetrics: (id, metrics) => {
-      set((state) => {
-        const viewIndex = state.views.findIndex((v) => v.id === id);
-        if (viewIndex === -1) return state;
-        const view = state.views[viewIndex];
-        const capability = calculateCapability(metrics);
-        const progress = calculateProgress(metrics);
-        const navigation = evaluateStateMachine(capability, progress, view.type, view.explicitLock);
-        if (view.capability === capability && Math.abs(view.progress - progress) < 1e-4 && view.navigation === navigation) {
-          return state;
-        }
-        const newViews = [...state.views];
-        newViews[viewIndex] = {
-          ...view,
-          metrics,
-          capability,
-          progress,
-          navigation
-        };
-        return { views: newViews };
-      });
-    },
-    processIntention: (intention) => {
-      const state = get();
-      if (state.isTransitioning || state.isGlobalLocked) return false;
-      const activeView = state.views[state.activeIndex];
-      if (!activeView) return false;
-      if (intention.type === "navigate") {
-        if (intention.direction === "down") {
-          if (activeView.navigation === "locked") return false;
-          if (state.activeIndex < state.totalViews - 1) {
-            get().goToView(state.activeIndex + 1);
-            return true;
-          }
-        } else if (intention.direction === "up") {
-          const isAtTop = activeView.metrics.scrollTop <= 1;
-          if (activeView.capability === "internal" && !isAtTop) {
-            return false;
-          }
-          if (activeView.type === "controlled") {
-            const config = activeView.config;
-            if (config.allowGoBack === false) {
-              return false;
-            }
-          } else {
-            if (activeView.explicitLock === "locked") return false;
-          }
-          if (state.activeIndex > 0) {
-            get().goToView(state.activeIndex - 1);
-            return true;
-          }
-        }
-      }
-      return false;
-    },
-    goToNext: () => {
-      const state = get();
-      state.goToView(state.activeIndex + 1);
-    },
-    goToPrevious: () => {
-      const state = get();
-      state.goToView(state.activeIndex - 1);
-    },
-    goToView: (indexOrId) => {
-      const state = get();
-      const now = Date.now();
-      if (now - lastNavigationTime < NAVIGATION_COOLDOWN$1) return;
-      lastNavigationTime = now;
-      let targetIndex = typeof indexOrId === "string" ? state.views.findIndex((v) => v.id === indexOrId) : indexOrId;
-      if (targetIndex < 0 || targetIndex >= state.totalViews) return;
-      if (targetIndex === state.activeIndex) return;
-      set((s) => ({
-        ...s,
-        isTransitioning: true,
-        activeIndex: targetIndex,
-        activeId: s.views[targetIndex]?.id ?? null,
-        views: s.views.map((v) => {
-          if (v.index === targetIndex) return { ...v, isActive: true };
-          if (v.index === s.activeIndex) return { ...v, isActive: false };
-          return v;
-        })
-      }));
-    },
-    setViewExplicitLock: (id, lock) => {
-      set((state) => {
-        const index = state.views.findIndex((v) => v.id === id);
-        if (index === -1) return state;
-        const view = state.views[index];
-        const navigation = evaluateStateMachine(view.capability, view.progress, view.type, lock);
-        const newViews = [...state.views];
-        newViews[index] = { ...view, explicitLock: lock, navigation };
-        return { views: newViews };
-      });
-    },
-    setGlobalLock: (locked) => set({ isGlobalLocked: locked }),
-    setDragging: (dragging) => set({ isDragging: dragging }),
-    getViewById: (id) => get().views.find((v) => v.id === id),
-    startTransition: () => set({ isTransitioning: true }),
-    endTransition: () => set({ isTransitioning: false }),
-    resetNavigationCooldown: () => {
-      lastNavigationTime = 0;
-    }
-  }))
-);
-var selectActiveView$1 = (state) => state.views[state.activeIndex];
-var selectActiveViewProgress$1 = (state) => state.views[state.activeIndex]?.progress ?? 0;
-var selectCanNavigateNext$1 = (state) => {
-  if (state.isTransitioning || state.isGlobalLocked) return false;
-  const activeView = state.views[state.activeIndex];
-  if (!activeView) return false;
-  return activeView.navigation === "unlocked";
-};
-var selectCanNavigatePrevious$1 = (state) => {
-  if (state.isTransitioning || state.isGlobalLocked) return false;
-  return state.activeIndex > 0;
-};
-
-// hooks/useWheelHandler.ts
-var import_react = require("react");
-
-// utils/normalizeWheel.ts
-function normalizeWheel(event) {
-  let pixelX = 0;
-  let pixelY = 0;
-  let pixelZ = 0;
-  if ("detail" in event) {
-    pixelY = event.detail;
-  }
-  if ("wheelDelta" in event) {
-    pixelY = -event.wheelDelta / 120;
-  }
-  if ("wheelDeltaY" in event) {
-    pixelY = -event.wheelDeltaY / 120;
-  }
-  if ("wheelDeltaX" in event) {
-    pixelX = -event.wheelDeltaX / 120;
-  }
-  if ("deltaY" in event) {
-    pixelY = event.deltaY;
-  }
-  if ("deltaX" in event) {
-    pixelX = event.deltaX;
-  }
-  if ((event.deltaMode || 0) === 1) {
-    pixelY *= 40;
-    pixelX *= 40;
-  } else if ((event.deltaMode || 0) === 2) {
-    pixelY *= 800;
-    pixelX *= 800;
-  }
-  return { pixelX, pixelY, pixelZ };
-}
-
-// hooks/useWheelHandler.ts
-function useWheelHandler$1() {
-  const scrollAccumulator = (0, import_react.useRef)(0);
-  const lastScrollTime = (0, import_react.useRef)(0);
-  useScrollStore$1((s) => s.isTransitioning);
-  (0, import_react.useEffect)(() => {
-    const handleWheel = (event) => {
-      const state = useScrollStore$1.getState();
-      if (state.isTransitioning || state.isDragging) {
-        event.preventDefault();
-        return;
-      }
-      const normalized = normalizeWheel(event);
-      const delta = normalized.pixelY;
-      scrollAccumulator.current += delta;
-      const now = Date.now();
-      if (now - lastScrollTime.current > 200) {
-        scrollAccumulator.current = delta;
-      }
-      lastScrollTime.current = now;
-      if (Math.abs(scrollAccumulator.current) >= NAV_THRESHOLDS$1.WHEEL) {
-        const direction = scrollAccumulator.current > 0 ? "down" : "up";
-        const intention = {
-          type: "navigate",
-          direction,
-          strength: Math.min(Math.abs(scrollAccumulator.current) / NAV_THRESHOLDS$1.WHEEL, 1),
-          origin: "wheel"
-        };
-        const handled = useScrollStore$1.getState().processIntention(intention);
-        if (handled) {
-          scrollAccumulator.current = 0;
-          event.preventDefault();
-        }
-      }
-    };
-    window.addEventListener("wheel", handleWheel, { passive: false });
-    return () => window.removeEventListener("wheel", handleWheel);
-  }, []);
-}
-
-// hooks/useTouchHandler.ts
-var import_react2 = require("react");
-function useTouchHandler$1(options = {}) {
-  const { enabled = true } = options;
-  const touchStart = (0, import_react2.useRef)(null);
-  const touchStartTime = (0, import_react2.useRef)(0);
-  (0, import_react2.useEffect)(() => {
-    if (!enabled) return;
-    const handleTouchStart = (e) => {
-      touchStart.current = {
-        x: e.touches[0].clientX,
-        y: e.touches[0].clientY
-      };
-      touchStartTime.current = Date.now();
-    };
-    const handleTouchEnd = (e) => {
-      if (!touchStart.current) return;
-      const touchEnd = {
-        x: e.changedTouches[0].clientX,
-        y: e.changedTouches[0].clientY
-      };
-      const deltaY = touchStart.current.y - touchEnd.y;
-      const deltaX = touchStart.current.x - touchEnd.x;
-      const timeElapsed = Date.now() - touchStartTime.current;
-      if (Math.abs(deltaY) > Math.abs(deltaX) && // Vertical
-      Math.abs(deltaY) > NAV_THRESHOLDS$1.TOUCH && // Threshold distancia
-      timeElapsed < 800) {
-        const direction = deltaY > 0 ? "down" : "up";
-        const intention = {
-          type: "navigate",
-          direction,
-          strength: 1,
-          // Swipes son intenciones fuertes
-          origin: "touch"
-        };
-        useScrollStore$1.getState().processIntention(intention);
-      }
-      touchStart.current = null;
-    };
-    window.addEventListener("touchstart", handleTouchStart, { passive: true });
-    window.addEventListener("touchend", handleTouchEnd, { passive: true });
-    return () => {
-      window.removeEventListener("touchstart", handleTouchStart);
-      window.removeEventListener("touchend", handleTouchEnd);
-    };
-  }, [enabled]);
-}
-
-// hooks/useKeyboardHandler.ts
-var import_react3 = require("react");
-function useKeyboardHandler$1(options = {}) {
-  const { enabled = true, preventDefault = true } = options;
-  (0, import_react3.useEffect)(() => {
-    if (!enabled) return;
-    const handleKeyDown = (e) => {
-      const target = e.target;
-      if (target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.isContentEditable) {
-        return;
-      }
-      let intention = null;
-      switch (e.key) {
-        case "ArrowDown":
-        case "PageDown":
-          intention = {
-            type: "navigate",
-            direction: "down",
-            strength: 1,
-            origin: "keyboard"
-          };
-          break;
-        case "ArrowUp":
-        case "PageUp":
-          intention = {
-            type: "navigate",
-            direction: "up",
-            strength: 1,
-            origin: "keyboard"
-          };
-          break;
-        case " ":
-          intention = {
-            type: "navigate",
-            direction: e.shiftKey ? "up" : "down",
-            strength: 1,
-            origin: "keyboard"
-          };
-          break;
-        case "Home":
-          useScrollStore$1.getState().goToView(0);
-          if (preventDefault) e.preventDefault();
-          return;
-        case "End":
-          const totalViews = useScrollStore$1.getState().totalViews;
-          useScrollStore$1.getState().goToView(totalViews - 1);
-          if (preventDefault) e.preventDefault();
-          return;
-        default:
-          return;
-      }
-      if (intention) {
-        if (preventDefault) e.preventDefault();
-        useScrollStore$1.getState().processIntention(intention);
-      }
-    };
-    window.addEventListener("keydown", handleKeyDown);
-    return () => {
-      window.removeEventListener("keydown", handleKeyDown);
-    };
-  }, [enabled, preventDefault]);
-}
-
-// hooks/useHashSync.ts
-var import_react4 = require("react");
-function useHashSync$1(options = {}) {
-  const { enabled = true, pushHistory = false, hashPrefix = "" } = options;
-  const hasInitialized = (0, import_react4.useRef)(false);
-  (0, import_react4.useEffect)(() => {
-    if (!enabled) return;
-    const unsubscribe = useScrollStore$1.subscribe(
-      (state) => state.activeIndex,
-      (activeIndex, prevIndex) => {
-        if (!hasInitialized.current) return;
-        if (activeIndex === prevIndex) return;
-        const views = useScrollStore$1.getState().views;
-        const activeView = views[activeIndex];
-        if (activeView) {
-          const hash = `#${hashPrefix}${activeView.id}`;
-          if (pushHistory) {
-            window.history.pushState(null, "", hash);
-          } else {
-            window.history.replaceState(null, "", hash);
-          }
-        }
-      }
-    );
-    return () => unsubscribe();
-  }, [enabled, pushHistory, hashPrefix]);
-  (0, import_react4.useEffect)(() => {
-    if (!enabled) return;
-    const handlePopState = () => {
-      const hash = window.location.hash.slice(1);
-      if (!hash) return;
-      const viewId = hashPrefix ? hash.replace(hashPrefix, "") : hash;
-      const views = useScrollStore$1.getState().views;
-      const targetIndex = views.findIndex((v) => v.id === viewId);
-      if (targetIndex !== -1) {
-        useScrollStore$1.getState().goToView(targetIndex);
-      }
-    };
-    window.addEventListener("popstate", handlePopState);
-    return () => window.removeEventListener("popstate", handlePopState);
-  }, [enabled, hashPrefix]);
-  (0, import_react4.useEffect)(() => {
-    if (!enabled) return;
-    const checkAndNavigate = () => {
-      const state = useScrollStore$1.getState();
-      if (!state.isInitialized || state.views.length === 0) {
-        setTimeout(checkAndNavigate, 100);
-        return;
-      }
-      const hash = window.location.hash.slice(1);
-      if (!hash) {
-        hasInitialized.current = true;
-        return;
-      }
-      const viewId = hashPrefix ? hash.replace(hashPrefix, "") : hash;
-      const targetIndex = state.views.findIndex((v) => v.id === viewId);
-      if (targetIndex !== -1 && targetIndex !== state.activeIndex) {
-        state.goToView(targetIndex);
-      }
-      hasInitialized.current = true;
-    };
-    checkAndNavigate();
-  }, [enabled, hashPrefix]);
-}
-
-// hooks/useDragHandler.ts
-var import_react5 = require("react");
-var DRAG_THRESHOLD = 50;
-var VELOCITY_THRESHOLD = 0.5;
-var RESISTANCE_FACTOR = 0.4;
-function useDragHandler$1(options = {}) {
-  const { enabled = true, onDragUpdate, onDragEnd } = options;
-  const [dragState, setDragState] = (0, import_react5.useState)({
-    isDragging: false,
-    dragOffset: 0,
-    dragDirection: null
-  });
-  const touchStartRef = (0, import_react5.useRef)(null);
-  const lastMoveRef = (0, import_react5.useRef)(null);
-  const rafRef = (0, import_react5.useRef)(null);
-  const updateDragState = (0, import_react5.useCallback)((newState) => {
-    setDragState((prev) => {
-      const updated = { ...prev, ...newState };
-      onDragUpdate?.(updated);
-      return updated;
-    });
-  }, [onDragUpdate]);
-  (0, import_react5.useEffect)(() => {
-    if (!enabled) return;
-    const handleTouchStart = (e) => {
-      const target = e.target;
-      if (target.closest('[data-scrollable="true"]')) return;
-      touchStartRef.current = {
-        y: e.touches[0].clientY,
-        time: Date.now()
-      };
-      lastMoveRef.current = touchStartRef.current;
-      useScrollStore$1.getState().setDragging(true);
-      updateDragState({ isDragging: true, dragOffset: 0, dragDirection: null });
-    };
-    const handleTouchMove = (e) => {
-      if (!touchStartRef.current) return;
-      const currentY = e.touches[0].clientY;
-      const deltaY = touchStartRef.current.y - currentY;
-      const viewportHeight = window.innerHeight;
-      let offset = deltaY / viewportHeight;
-      const store = useScrollStore$1.getState();
-      const atStart = store.activeIndex === 0 && deltaY < 0;
-      const atEnd = store.activeIndex === store.totalViews - 1 && deltaY > 0;
-      if (atStart || atEnd) {
-        offset = offset * RESISTANCE_FACTOR;
-      }
-      offset = Math.max(-1, Math.min(1, offset));
-      lastMoveRef.current = { y: currentY, time: Date.now() };
-      if (rafRef.current) cancelAnimationFrame(rafRef.current);
-      rafRef.current = requestAnimationFrame(() => {
-        updateDragState({
-          dragOffset: offset,
-          dragDirection: deltaY > 0 ? "down" : deltaY < 0 ? "up" : null
-        });
-      });
-    };
-    const handleTouchEnd = (e) => {
-      if (!touchStartRef.current || !lastMoveRef.current) {
-        updateDragState({ isDragging: false, dragOffset: 0, dragDirection: null });
-        return;
-      }
-      const endY = e.changedTouches[0].clientY;
-      const deltaY = touchStartRef.current.y - endY;
-      const timeDelta = Date.now() - lastMoveRef.current.time;
-      const velocity = timeDelta > 0 ? Math.abs(deltaY) / timeDelta : 0;
-      const store = useScrollStore$1.getState();
-      const atStart = store.activeIndex === 0;
-      const atEnd = store.activeIndex === store.totalViews - 1;
-      const exceedsThreshold = Math.abs(deltaY) > DRAG_THRESHOLD;
-      const hasVelocity = velocity > VELOCITY_THRESHOLD;
-      const direction = deltaY > 0 ? "down" : "up";
-      const canNavigate = direction === "down" && !atEnd || direction === "up" && !atStart;
-      const shouldNavigate = canNavigate && (exceedsThreshold || hasVelocity);
-      onDragEnd?.(shouldNavigate, direction);
-      if (shouldNavigate) {
-        store.processIntention({
-          type: "navigate",
-          direction,
-          strength: Math.min(1, velocity / VELOCITY_THRESHOLD),
-          origin: "touch"
-        });
-      }
-      touchStartRef.current = null;
-      lastMoveRef.current = null;
-      useScrollStore$1.getState().setDragging(false);
-      updateDragState({ isDragging: false, dragOffset: 0, dragDirection: null });
-    };
-    const handleTouchCancel = () => {
-      touchStartRef.current = null;
-      lastMoveRef.current = null;
-      useScrollStore$1.getState().setDragging(false);
-      updateDragState({ isDragging: false, dragOffset: 0, dragDirection: null });
-    };
-    window.addEventListener("touchstart", handleTouchStart, { passive: true });
-    window.addEventListener("touchmove", handleTouchMove, { passive: true });
-    window.addEventListener("touchend", handleTouchEnd, { passive: true });
-    window.addEventListener("touchcancel", handleTouchCancel, { passive: true });
-    return () => {
-      window.removeEventListener("touchstart", handleTouchStart);
-      window.removeEventListener("touchmove", handleTouchMove);
-      window.removeEventListener("touchend", handleTouchEnd);
-      window.removeEventListener("touchcancel", handleTouchCancel);
-      if (rafRef.current) cancelAnimationFrame(rafRef.current);
-    };
-  }, [enabled, updateDragState, onDragEnd]);
-  return dragState;
-}
-
-// hooks/useFocusManagement.ts
-var import_react6 = require("react");
-function useFocusManagement$1(options = {}) {
-  const { enabled = true, focusDelay = 100 } = options;
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const activeId = useScrollStore$1((s) => s.activeId);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  const prevIndexRef = (0, import_react6.useRef)(activeIndex);
-  (0, import_react6.useEffect)(() => {
-    if (!enabled) return;
-    if (activeIndex !== prevIndexRef.current && !isTransitioning && activeId) {
-      const timer = setTimeout(() => {
-        const viewElement = document.getElementById(activeId);
-        if (viewElement) {
-          if (!viewElement.hasAttribute("tabindex")) {
-            viewElement.setAttribute("tabindex", "-1");
-          }
-          viewElement.focus({ preventScroll: true });
-        }
-        prevIndexRef.current = activeIndex;
-      }, focusDelay);
-      return () => clearTimeout(timer);
-    }
-  }, [activeIndex, activeId, isTransitioning, enabled, focusDelay]);
-}
-
-// hooks/useScrollSystem.ts
-var import_react7 = require("react");
-function useScrollSystem$1() {
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const globalProgress = useScrollStore$1((s) => s.globalProgress);
-  const isGlobalLocked = useScrollStore$1((s) => s.isGlobalLocked);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  const isDragging = useScrollStore$1((s) => s.isDragging);
-  const activeId = useScrollStore$1((s) => s.activeId);
-  const totalViews = useScrollStore$1((s) => s.totalViews);
-  const views = useScrollStore$1((s) => s.views);
-  const {
-    goToNext: storeNext,
-    goToPrevious: storePrev,
-    goToView: storeGoTo
-  } = useScrollStore$1();
-  const activeView = views[activeIndex];
-  const activeViewType = activeView?.type ?? null;
-  const activeViewProgress = activeView?.progress ?? 0;
-  const canNavigateNext = useScrollStore$1(selectCanNavigateNext$1);
-  const canNavigatePrevious = useScrollStore$1(selectCanNavigatePrevious$1);
-  const goToNext = (0, import_react7.useCallback)(() => {
-    if (canNavigateNext) {
-      storeNext();
-      return true;
-    }
-    return false;
-  }, [canNavigateNext, storeNext]);
-  const goToPrev = (0, import_react7.useCallback)(() => {
-    if (canNavigatePrevious) {
-      storePrev();
-      return true;
-    }
-    return false;
-  }, [canNavigatePrevious, storePrev]);
-  const getCurrentIndex = (0, import_react7.useCallback)(() => activeIndex, [activeIndex]);
-  const getProgress = (0, import_react7.useCallback)(() => globalProgress, [globalProgress]);
-  const getActiveViewProgress = (0, import_react7.useCallback)(() => activeViewProgress, [activeViewProgress]);
-  const isLocked = (0, import_react7.useCallback)(() => isGlobalLocked || isTransitioning || !canNavigateNext, [isGlobalLocked, isTransitioning, canNavigateNext]);
-  return (0, import_react7.useMemo)(() => ({
-    goToNext,
-    goToPrev,
-    goTo: storeGoTo,
-    getCurrentIndex,
-    getProgress,
-    getActiveViewProgress,
-    isLocked,
-    canGoNext: canNavigateNext,
-    canGoPrev: canNavigatePrevious,
-    // Extended Data for Nav/UI
-    activeIndex,
-    activeId,
-    activeViewType,
-    totalViews,
-    // State Flags (for advanced use)
-    isDragging,
-    isTransitioning
-  }), [
-    goToNext,
-    goToPrev,
-    storeGoTo,
-    getCurrentIndex,
-    getProgress,
-    getActiveViewProgress,
-    isLocked,
-    canNavigateNext,
-    canNavigatePrevious,
-    activeIndex,
-    activeId,
-    activeViewType,
-    totalViews,
-    isDragging,
-    isTransitioning
-  ]);
-}
-
-// utils/index.ts
-function throttle(fn, limit) {
-  let lastCall = 0;
-  let timeoutId = null;
-  return ((...args) => {
-    const now = Date.now();
-    const remaining = limit - (now - lastCall);
-    if (remaining <= 0) {
-      if (timeoutId) {
-        clearTimeout(timeoutId);
-        timeoutId = null;
-      }
-      lastCall = now;
-      fn(...args);
-    } else if (!timeoutId) {
-      timeoutId = setTimeout(() => {
-        lastCall = Date.now();
-        timeoutId = null;
-        fn(...args);
-      }, remaining);
-    }
-  });
-}
-function prefersReducedMotion() {
-  if (typeof window === "undefined") return false;
-  return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
-}
-
-// components/ScrollContainer.tsx
-var import_jsx_runtime = require("react/jsx-runtime");
-function ScrollContainer({
-  children,
-  className = "",
-  transitionDuration = DEFAULT_TRANSITION_DURATION$1,
-  transitionEasing = DEFAULT_TRANSITION_EASING$1,
-  onViewChange,
-  onInitialized,
-  // Deep Linking options
-  enableHashSync = false,
-  hashPushHistory = false,
-  hashPrefix = "",
-  // Accessibility
-  respectReducedMotion = true,
-  enableFocusManagement = true,
-  // Touch Physics
-  enableDragPhysics = false,
-  // Layout
-  orientation = "vertical"
-}) {
-  const containerRef = (0, import_react8.useRef)(null);
-  const isBrowser = typeof window !== "undefined";
-  const [reducedMotion, setReducedMotion] = (0, import_react8.useState)(false);
-  (0, import_react8.useEffect)(() => {
-    if (!isBrowser || !respectReducedMotion) return;
-    setReducedMotion(prefersReducedMotion());
-    const mediaQuery = window.matchMedia("(prefers-reduced-motion: reduce)");
-    const handler = (e) => setReducedMotion(e.matches);
-    mediaQuery.addEventListener("change", handler);
-    return () => mediaQuery.removeEventListener("change", handler);
-  }, [respectReducedMotion, isBrowser]);
-  const effectiveDuration = reducedMotion ? 0 : transitionDuration;
-  const { initialize, endTransition } = useScrollStore$1();
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  useScrollStore$1((s) => s.totalViews);
-  useScrollStore$1((s) => s.isInitialized);
-  const prevIndexRef = (0, import_react8.useRef)(activeIndex);
-  useWheelHandler$1();
-  useTouchHandler$1({ enabled: !enableDragPhysics });
-  useKeyboardHandler$1();
-  const dragState = useDragHandler$1({
-    enabled: enableDragPhysics && !reducedMotion
-  });
-  useHashSync$1({
-    enabled: enableHashSync,
-    pushHistory: hashPushHistory,
-    hashPrefix
-  });
-  useFocusManagement$1({ enabled: enableFocusManagement });
-  (0, import_react8.useEffect)(() => {
-    const timer = setTimeout(() => {
-      initialize();
-      onInitialized?.();
-    }, 50);
-    return () => clearTimeout(timer);
-  }, [initialize, onInitialized]);
-  (0, import_react8.useEffect)(() => {
-    if (prevIndexRef.current !== activeIndex) {
-      onViewChange?.(prevIndexRef.current, activeIndex);
-      const timer = setTimeout(() => {
-        endTransition();
-      }, effectiveDuration);
-      prevIndexRef.current = activeIndex;
-      return () => clearTimeout(timer);
-    }
-  }, [activeIndex, effectiveDuration, onViewChange, endTransition]);
-  const wrapperStyle = (0, import_react8.useMemo)(() => {
-    const baseOffset = activeIndex * 100;
-    const dragOffset = dragState.isDragging ? dragState.dragOffset * 100 : 0;
-    const transformAxis = orientation === "horizontal" ? "X" : "Y";
-    const sizeUnit = orientation === "horizontal" ? "vw" : "vh";
-    return {
-      transform: `translate${transformAxis}(-${baseOffset + dragOffset}${sizeUnit})`,
-      transition: dragState.isDragging ? "none" : effectiveDuration > 0 ? `transform ${effectiveDuration}ms ${transitionEasing}` : "none",
-      height: "100%",
-      width: "100%",
-      display: orientation === "horizontal" ? "flex" : "block",
-      flexDirection: orientation === "horizontal" ? "row" : void 0
-    };
-  }, [activeIndex, effectiveDuration, transitionEasing, dragState, orientation]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-    "div",
-    {
-      ref: containerRef,
-      className: `scroll-container fixed inset-0 overflow-hidden w-screen h-screen ${className}`,
-      role: "main",
-      "aria-label": "Scroll container",
-      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "scroll-wrapper", style: wrapperStyle, children })
-    }
-  );
-}
-
-// components/FullView.tsx
-var import_react10 = require("react");
-
-// hooks/useViewRegistration.ts
-var import_react9 = require("react");
-function useViewRegistration$1({
-  config,
-  onActivate,
-  onDeactivate,
-  onEnterStart,
-  onEnterEnd,
-  onExitStart,
-  onExitEnd
-}) {
-  const registerView = useScrollStore$1((s) => s.registerView);
-  const unregisterView = useScrollStore$1((s) => s.unregisterView);
-  const activeId = useScrollStore$1((s) => s.activeId);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  const callbacksRef = (0, import_react9.useRef)({
-    onActivate,
-    onDeactivate,
-    onEnterStart,
-    onEnterEnd,
-    onExitStart,
-    onExitEnd
-  });
-  callbacksRef.current = {
-    onActivate,
-    onDeactivate,
-    onEnterStart,
-    onEnterEnd,
-    onExitStart,
-    onExitEnd
-  };
-  const wasActiveRef = (0, import_react9.useRef)(false);
-  const wasTransitioningRef = (0, import_react9.useRef)(false);
-  const configRef = (0, import_react9.useRef)(config);
-  if (JSON.stringify(config) !== JSON.stringify(configRef.current)) {
-    configRef.current = config;
-  }
-  (0, import_react9.useEffect)(() => {
-    const currentConfig = configRef.current;
-    registerView(currentConfig);
-    return () => unregisterView(currentConfig.id);
-  }, [registerView, unregisterView, configRef.current]);
-  const viewState = useScrollStore$1((s) => s.views.find((v) => v.id === config.id));
-  const isActive = activeId === config.id;
-  (0, import_react9.useEffect)(() => {
-    if (isActive && !wasActiveRef.current) {
-      callbacksRef.current.onActivate?.();
-    } else if (!isActive && wasActiveRef.current) {
-      callbacksRef.current.onDeactivate?.();
-    }
-    wasActiveRef.current = isActive;
-  }, [isActive]);
-  (0, import_react9.useEffect)(() => {
-    const callbacks = callbacksRef.current;
-    const wasActive = wasActiveRef.current;
-    const wasTransitioning = wasTransitioningRef.current;
-    if (isTransitioning && !wasTransitioning) {
-      if (isActive && !wasActive) {
-        callbacks.onEnterStart?.();
-      } else if (!isActive && wasActive) {
-        callbacks.onExitStart?.();
-      }
-    }
-    if (!isTransitioning && wasTransitioning) {
-      if (isActive) {
-        callbacks.onEnterEnd?.();
-      } else if (wasActive && !isActive) {
-        callbacks.onExitEnd?.();
-      }
-    }
-    wasTransitioningRef.current = isTransitioning;
-  }, [isTransitioning, isActive]);
-  return {
-    isActive,
-    viewState,
-    index: viewState?.index ?? -1,
-    scrollProgress: viewState?.progress ?? 0,
-    navigation: viewState?.navigation ?? "unlocked"
-  };
-}
-
-// components/FullView.tsx
-var import_jsx_runtime2 = require("react/jsx-runtime");
-function FullView({
-  id,
-  children,
-  className = "",
-  meta,
-  onActivate,
-  onDeactivate,
-  onEnterStart,
-  onEnterEnd,
-  onExitStart,
-  onExitEnd
-}) {
-  const config = (0, import_react10.useMemo)(
-    () => ({
-      id,
-      type: "full",
-      meta
-    }),
-    [id, meta]
-  );
-  const { isActive, index } = useViewRegistration$1({
-    config,
-    onActivate,
-    onDeactivate,
-    onEnterStart,
-    onEnterEnd,
-    onExitStart,
-    onExitEnd
-  });
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-    "section",
-    {
-      id,
-      className: `
-        full-view
-        relative
-        w-full h-screen
-        overflow-hidden
-        ${isActive ? "is-active" : ""}
-        ${className}
-      `,
-      "data-view-type": "full",
-      "data-view-index": index,
-      "data-view-active": isActive,
-      "aria-hidden": !isActive,
-      children
-    }
-  );
-}
-
-// hooks/useMetricsReporter.ts
-var import_react11 = require("react");
-var SCROLL_THROTTLE_MS = 66;
-function useMetricsReporter$1({
-  id,
-  isActive,
-  scrollDirection,
-  onScrollProgress,
-  throttleMs = SCROLL_THROTTLE_MS
-}) {
-  const scrollRef = (0, import_react11.useRef)(null);
-  const updateMetrics = useScrollStore$1((s) => s.updateViewMetrics);
-  const measureAndReport = (0, import_react11.useCallback)(() => {
-    const el = scrollRef.current;
-    if (!el) return;
-    const metrics = {
-      scrollHeight: scrollDirection === "vertical" ? el.scrollHeight : el.scrollWidth,
-      clientHeight: scrollDirection === "vertical" ? el.clientHeight : el.clientWidth,
-      scrollTop: scrollDirection === "vertical" ? el.scrollTop : el.scrollLeft
-    };
-    updateMetrics(id, metrics);
-    if (onScrollProgress) {
-      const max = metrics.scrollHeight - metrics.clientHeight;
-      const progress = max > 0 ? metrics.scrollTop / max : 1;
-      onScrollProgress(progress);
-    }
-  }, [id, scrollDirection, updateMetrics, onScrollProgress]);
-  const throttledMeasure = (0, import_react11.useMemo)(
-    () => throttle(measureAndReport, throttleMs),
-    [measureAndReport, throttleMs]
-  );
-  (0, import_react11.useEffect)(() => {
-    const el = scrollRef.current;
-    if (!el) return;
-    const resizeObserver = new ResizeObserver(() => {
-      window.requestAnimationFrame(measureAndReport);
-    });
-    resizeObserver.observe(el);
-    Array.from(el.children).forEach((child) => resizeObserver.observe(child));
-    el.addEventListener("scroll", throttledMeasure, { passive: true });
-    measureAndReport();
-    return () => {
-      resizeObserver.disconnect();
-      el.removeEventListener("scroll", throttledMeasure);
-    };
-  }, [measureAndReport, throttledMeasure]);
-  (0, import_react11.useEffect)(() => {
-    if (isActive) {
-      measureAndReport();
-    }
-  }, [isActive, measureAndReport]);
-  return { scrollRef, measureAndReport };
-}
-
-// components/ScrollLockedView.tsx
-var import_jsx_runtime3 = require("react/jsx-runtime");
-function ScrollLockedView({
-  id,
-  children,
-  className = "",
-  scrollDirection = "vertical",
-  scrollEndThreshold = 0.99,
-  onScrollProgress,
-  onActivate,
-  onDeactivate,
-  onEnterStart,
-  onEnterEnd,
-  onExitStart,
-  onExitEnd
-}) {
-  const { isActive} = useViewRegistration$1({
-    config: {
-      id,
-      type: "scroll-locked",
-      scrollDirection,
-      scrollEndThreshold
-    },
-    onActivate,
-    onDeactivate,
-    onEnterStart,
-    onEnterEnd,
-    onExitStart,
-    onExitEnd
-  });
-  const { scrollRef } = useMetricsReporter$1({
-    id,
-    isActive,
-    scrollDirection,
-    onScrollProgress
-  });
-  const scrollClasses = scrollDirection === "vertical" ? "overflow-y-auto overflow-x-hidden" : "overflow-x-auto overflow-y-hidden";
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-    "section",
-    {
-      id,
-      className: `relative w-full h-screen ${className}`,
-      "data-view-type": "scroll-locked",
-      "data-active": isActive,
-      children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-        "div",
-        {
-          ref: scrollRef,
-          className: `w-full h-full ${scrollClasses} no-scrollbar`,
-          style: { scrollbarWidth: "none" },
-          children
-        }
-      )
-    }
-  );
-}
-
-// components/ControlledView.tsx
-var import_react12 = require("react");
-var import_jsx_runtime4 = require("react/jsx-runtime");
-function ControlledView({
-  id,
-  children,
-  className = "",
-  scrollDirection = "none",
-  allowInternalScroll = false,
-  canProceed = false,
-  allowGoBack = true,
-  onActivate,
-  onDeactivate,
-  onEnterStart,
-  onEnterEnd,
-  onExitStart,
-  onExitEnd
-}) {
-  const setExplicitLock = useScrollStore$1((s) => s.setViewExplicitLock);
-  const config = (0, import_react12.useMemo)(
-    () => ({
-      id,
-      type: "controlled",
-      scrollDirection,
-      allowInternalScroll,
-      allowGoBack
-    }),
-    [id, scrollDirection, allowInternalScroll, allowGoBack]
-  );
-  const { isActive} = useViewRegistration$1({
-    config,
-    onActivate,
-    onDeactivate,
-    onEnterStart,
-    onEnterEnd,
-    onExitStart,
-    onExitEnd
-  });
-  const { scrollRef } = useMetricsReporter$1({
-    id,
-    isActive,
-    scrollDirection: allowInternalScroll ? scrollDirection : "none"
-  });
-  (0, import_react12.useEffect)(() => {
-    const lockState = canProceed ? "unlocked" : "locked";
-    setExplicitLock(id, lockState);
-  }, [id, canProceed, setExplicitLock]);
-  const overflowClasses = (0, import_react12.useMemo)(() => {
-    if (!allowInternalScroll) return "overflow-hidden";
-    switch (scrollDirection) {
-      case "vertical":
-        return "overflow-y-auto overflow-x-hidden";
-      case "horizontal":
-        return "overflow-x-auto overflow-y-hidden";
-      default:
-        return "overflow-auto";
-    }
-  }, [allowInternalScroll, scrollDirection]);
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-    "section",
-    {
-      id,
-      className: `relative w-full h-screen ${isActive ? "z-10" : "z-0"} ${className}`,
-      "data-view-type": "controlled",
-      "data-active": isActive,
-      children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-        "div",
-        {
-          ref: scrollRef,
-          className: `w-full h-full ${overflowClasses}`,
-          children
-        }
-      )
-    }
-  );
-}
-function useViewControl(viewId) {
-  const setExplicitLock = useScrollStore$1((s) => s.setViewExplicitLock);
-  const goToNext = useScrollStore$1((s) => s.goToNext);
-  const goToPrevious = useScrollStore$1((s) => s.goToPrevious);
-  const goToView = useScrollStore$1((s) => s.goToView);
-  return (0, import_react12.useMemo)(
-    () => ({
-      unlock: () => setExplicitLock(viewId, "unlocked"),
-      lock: () => setExplicitLock(viewId, "locked"),
-      // Navegación Programática (Forzada)
-      goNext: () => goToNext(),
-      goPrev: () => goToPrevious(),
-      goTo: (to) => goToView(to)
-    }),
-    [viewId, setExplicitLock, goToNext, goToPrevious, goToView]
-  );
-}
-
-// components/ScrollDebugOverlay.tsx
-var import_jsx_runtime5 = require("react/jsx-runtime");
-function ScrollDebugOverlay({
-  position = "bottom-left",
-  visible = true
-}) {
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const totalViews = useScrollStore$1((s) => s.totalViews);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  const isGlobalLocked = useScrollStore$1((s) => s.isGlobalLocked);
-  const isInitialized = useScrollStore$1((s) => s.isInitialized);
-  const views = useScrollStore$1((s) => s.views);
-  const activeView = views[activeIndex];
-  if (!visible) return null;
-  const positionClasses = {
-    "top-left": "top-4 left-4",
-    "top-right": "top-4 right-4",
-    "bottom-left": "bottom-4 left-4",
-    "bottom-right": "bottom-4 right-4"
-  };
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
-    "div",
-    {
-      className: `fixed ${positionClasses[position]} z-9999 font-mono text-xs bg-black/90 text-green-400 p-3 rounded-lg border border-green-500/30 backdrop-blur-sm max-w-xs`,
-      style: { pointerEvents: "none" },
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "text-green-300 font-bold mb-2 flex items-center gap-2", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "w-2 h-2 rounded-full bg-green-500 animate-pulse" }),
-          "ScrollSystem Debug"
-        ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "space-y-1 mb-3", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "initialized", value: isInitialized }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "activeIndex", value: `${activeIndex} / ${totalViews - 1}` }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "transitioning", value: isTransitioning }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "globalLocked", value: isGlobalLocked })
-        ] }),
-        activeView && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "border-t border-green-500/20 pt-2 mt-2", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "text-green-300/70 mb-1", children: "Active View" }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "id", value: activeView.id }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "type", value: activeView.type }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "capability", value: activeView.capability }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "navigation", value: activeView.navigation }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "progress", value: `${(activeView.progress * 100).toFixed(0)}%` }),
-          activeView.explicitLock && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "explicitLock", value: activeView.explicitLock, highlight: true })
-        ] }),
-        activeView?.metrics && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "border-t border-green-500/20 pt-2 mt-2", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "text-green-300/70 mb-1", children: "Metrics" }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "scrollHeight", value: activeView.metrics.scrollHeight }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "clientHeight", value: activeView.metrics.clientHeight }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Row, { label: "scrollTop", value: Math.round(activeView.metrics.scrollTop) })
-        ] })
-      ]
-    }
-  );
-}
-function Row({
-  label,
-  value,
-  highlight = false
-}) {
-  const displayValue = typeof value === "boolean" ? value ? "\u2713" : "\u2717" : String(value);
-  const valueColor = typeof value === "boolean" ? value ? "text-green-400" : "text-red-400" : highlight ? "text-yellow-400" : "text-white";
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "flex justify-between gap-4", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { className: "text-green-500/70", children: [
-      label,
-      ":"
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: valueColor, children: displayValue })
-  ] });
-}
-
-// components/AriaLiveRegion.tsx
-var import_react13 = require("react");
-var import_jsx_runtime6 = require("react/jsx-runtime");
-function AriaLiveRegion({
-  template = "Navigated to section {viewIndex} of {totalViews}",
-  politeness = "polite"
-}) {
-  const [announcement, setAnnouncement] = (0, import_react13.useState)("");
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const activeId = useScrollStore$1((s) => s.activeId);
-  const totalViews = useScrollStore$1((s) => s.totalViews);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  (0, import_react13.useEffect)(() => {
-    if (!isTransitioning && activeId) {
-      const message = template.replace("{viewIndex}", String(activeIndex + 1)).replace("{viewId}", activeId).replace("{totalViews}", String(totalViews));
-      const timer = setTimeout(() => {
-        setAnnouncement(message);
-      }, 100);
-      return () => clearTimeout(timer);
-    }
-  }, [activeIndex, activeId, totalViews, isTransitioning, template]);
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
-    "div",
-    {
-      role: "status",
-      "aria-live": politeness,
-      "aria-atomic": "true",
-      className: "sr-only",
-      style: {
-        position: "absolute",
-        width: "1px",
-        height: "1px",
-        padding: 0,
-        margin: "-1px",
-        overflow: "hidden",
-        clip: "rect(0, 0, 0, 0)",
-        whiteSpace: "nowrap",
-        border: 0
-      },
-      children: announcement
-    }
-  );
-}
-
-// components/LazyView.tsx
-var import_react14 = require("react");
-var import_jsx_runtime7 = require("react/jsx-runtime");
-function LazyView({
-  viewId,
-  buffer = 1,
-  children,
-  placeholder = null
-}) {
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const views = useScrollStore$1((s) => s.views);
-  const shouldRender = (0, import_react14.useMemo)(() => {
-    const viewIndex = views.findIndex((v) => v.id === viewId);
-    if (viewIndex === -1) return false;
-    const minIndex = Math.max(0, activeIndex - buffer);
-    const maxIndex = Math.min(views.length - 1, activeIndex + buffer);
-    return viewIndex >= minIndex && viewIndex <= maxIndex;
-  }, [viewId, views, activeIndex, buffer]);
-  if (!shouldRender) {
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_jsx_runtime7.Fragment, { children: placeholder });
-  }
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_jsx_runtime7.Fragment, { children });
-}
-
-// hooks/useNavigation.ts
-var import_react15 = require("react");
-function useNavigation() {
-  const goToView = useScrollStore$1((s) => s.goToView);
-  const goToNextAction = useScrollStore$1((s) => s.goToNext);
-  const goToPreviousAction = useScrollStore$1((s) => s.goToPrevious);
-  const setGlobalLock = useScrollStore$1((s) => s.setGlobalLock);
-  const lockScroll = (0, import_react15.useCallback)(() => setGlobalLock(true), [setGlobalLock]);
-  const unlockScroll = (0, import_react15.useCallback)(() => setGlobalLock(false), [setGlobalLock]);
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const activeId = useScrollStore$1((s) => s.activeId);
-  const totalViews = useScrollStore$1((s) => s.totalViews);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  const isScrollLocked = useScrollStore$1((s) => s.isGlobalLocked);
-  const canNavigateNext = useScrollStore$1(selectCanNavigateNext$1);
-  const canNavigatePrevious = useScrollStore$1(selectCanNavigatePrevious$1);
-  const goToNext = (0, import_react15.useCallback)(() => {
-    return goToNextAction();
-  }, [goToNextAction]);
-  const goToPrevious = (0, import_react15.useCallback)(() => {
-    return goToPreviousAction();
-  }, [goToPreviousAction]);
-  const isFirstView = activeIndex === 0;
-  const isLastView = activeIndex === totalViews - 1;
-  const progress = totalViews > 1 ? activeIndex / (totalViews - 1) : 0;
-  return (0, import_react15.useMemo)(
-    () => ({
-      // Acciones de navegación
-      goToView,
-      goToNext,
-      goToPrevious,
-      // Control de bloqueo
-      lockScroll,
-      unlockScroll,
-      // Estado actual
-      activeIndex,
-      activeId,
-      totalViews,
-      // Estados de UI
-      isTransitioning,
-      isScrollLocked,
-      canNavigateNext,
-      canNavigatePrevious,
-      // Utilidades
-      isFirstView,
-      isLastView,
-      progress
-    }),
-    [
-      goToView,
-      goToNext,
-      goToPrevious,
-      lockScroll,
-      unlockScroll,
-      activeIndex,
-      activeId,
-      totalViews,
-      isTransitioning,
-      isScrollLocked,
-      canNavigateNext,
-      canNavigatePrevious,
-      isFirstView,
-      isLastView,
-      progress
-    ]
-  );
-}
-
-// hooks/useViewProgress.ts
-function useViewProgress$1(viewId) {
-  const progress = useScrollStore$1(
-    (s) => s.views.find((v) => v.id === viewId)?.progress ?? 0
-  );
-  const navigation = useScrollStore$1(
-    (s) => s.views.find((v) => v.id === viewId)?.navigation ?? "unlocked"
-  );
-  const isAtStart = progress <= 0.02;
-  const isAtEnd = progress >= 0.99;
-  return {
-    progress,
-    isAtStart,
-    isAtEnd,
-    navigation
-  };
-}
-function useActiveViewProgress$1() {
-  const progress = useScrollStore$1(selectActiveViewProgress$1);
-  const activeView = useScrollStore$1((s) => s.views[s.activeIndex]);
-  const hasInternalScroll = activeView?.capability === "internal";
-  return {
-    progress,
-    hasInternalScroll,
-    viewType: activeView?.type
-  };
-}
-
-// hooks/useScrollAnalytics.ts
-var import_react16 = require("react");
-function useScrollAnalytics$1(options = {}) {
-  const { onViewEnter, onViewExit, enabled = true } = options;
-  const activeIndex = useScrollStore$1((s) => s.activeIndex);
-  const activeId = useScrollStore$1((s) => s.activeId);
-  const isTransitioning = useScrollStore$1((s) => s.isTransitioning);
-  const enterTimeRef = (0, import_react16.useRef)(Date.now());
-  const prevIndexRef = (0, import_react16.useRef)(activeIndex);
-  const prevIdRef = (0, import_react16.useRef)(activeId);
-  const createAnalytics = (0, import_react16.useCallback)((viewId, viewIndex, enterTime, isActive, exitTime = null) => ({
-    viewId,
-    viewIndex,
-    enterTime,
-    exitTime,
-    duration: exitTime ? (exitTime - enterTime) / 1e3 : 0,
-    isActive
-  }), []);
-  (0, import_react16.useEffect)(() => {
-    if (!enabled) return;
-    if (!isTransitioning && (activeIndex !== prevIndexRef.current || activeId !== prevIdRef.current)) {
-      const now = Date.now();
-      if (prevIdRef.current) {
-        const exitAnalytics = createAnalytics(
-          prevIdRef.current,
-          prevIndexRef.current,
-          enterTimeRef.current,
-          false,
-          now
-        );
-        onViewExit?.(exitAnalytics);
-      }
-      if (activeId) {
-        enterTimeRef.current = now;
-        const enterAnalytics = createAnalytics(
-          activeId,
-          activeIndex,
-          now,
-          true
-        );
-        onViewEnter?.(enterAnalytics);
-      }
-      prevIndexRef.current = activeIndex;
-      prevIdRef.current = activeId;
-    }
-  }, [activeIndex, activeId, isTransitioning, enabled, onViewEnter, onViewExit, createAnalytics]);
-  return {
-    currentViewId: activeId,
-    currentViewIndex: activeIndex,
-    viewStartTime: enterTimeRef.current,
-    getTimeInView: () => (Date.now() - enterTimeRef.current) / 1e3
-  };
-}
-
-interface UseViewProgressResult {
-    progress: number;
-    isAtStart: boolean;
-    isAtEnd: boolean;
-    navigation: NavigationState;
-}
-declare function useViewProgress(viewId: string): UseViewProgressResult;
-declare function useActiveViewProgress(): {
-    progress: number;
-    hasInternalScroll: boolean;
-    viewType: undefined;
-};
-
-/**
- * PABRIX Scroll System - Wheel Handler
- * =====================================
- * Determina la INTENCIÓN del usuario basada en eventos de Wheel.
- * Traduce deltaY -> Intention -> Store.processIntention()
- */
-declare function useWheelHandler(): void;
-
-/**
- * Scroll System - Touch Handler
- * =====================================
- * Determina la INTENCIÓN del usuario basada en Gestos Táctiles (Swipe).
- * Traduce Touch Events -> Intention -> Store.processIntention()
- */
-interface UseTouchHandlerOptions {
-    /** Enable/disable the touch handler (default: true) */
-    enabled?: boolean;
-}
-declare function useTouchHandler(options?: UseTouchHandlerOptions): void;
-
-/**
- * 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
- */
-interface UseKeyboardHandlerOptions {
-    /** Enable/disable keyboard navigation (default: true) */
-    enabled?: boolean;
-    /** Prevent default behavior for handled keys (default: true) */
-    preventDefault?: boolean;
-}
-declare function useKeyboardHandler(options?: UseKeyboardHandlerOptions): void;
-
-/**
- * Scroll System - Hash Sync Handler
- * ==========================================
- * Synchronizes active view with URL hash for deep linking.
- *
- * Features:
- * - Updates URL hash when view changes (pushState or replaceState)
- * - Navigates to view when URL hash changes (popstate)
- * - Handles initial load navigation based on hash
- *
- * Usage:
- *   useHashSync({ enabled: true, pushHistory: true })
- */
-interface UseHashSyncOptions {
-    /** Enable/disable hash syncing (default: true) */
-    enabled?: boolean;
-    /** Use pushState (true) or replaceState (false) for hash updates (default: false) */
-    pushHistory?: boolean;
-    /** Prefix for hash (e.g., "view-" creates "#view-0") (default: "") */
-    hashPrefix?: string;
-}
-declare function useHashSync(options?: UseHashSyncOptions): void;
-
-/**
- * Scroll System - Drag Handler (Touch Physics)
- * ==============================================
- * Implements 1:1 direct manipulation for touch devices.
- *
- * Features:
- * - Real-time tracking of finger position
- * - Outputs dragOffset for visual feedback
- * - Spring-based release detection (snap vs. proceed)
- *
- * This hook works alongside useTouchHandler which handles discrete swipes.
- */
-interface DragState {
-    isDragging: boolean;
-    dragOffset: number;
-    dragDirection: "up" | "down" | null;
-}
-interface UseDragHandlerOptions {
-    /** Enable/disable drag handling (default: true) */
-    enabled?: boolean;
-    /** Callback when drag state changes */
-    onDragUpdate?: (state: DragState) => void;
-    /** Callback when drag completes with navigation decision */
-    onDragEnd?: (shouldNavigate: boolean, direction: "up" | "down") => void;
-}
-declare function useDragHandler(options?: UseDragHandlerOptions): DragState;
-
-/**
- * Scroll System - Focus Management Hook
- * ======================================
- * Manages focus when navigating between views.
- * Moves focus to the active view section for screen reader accessibility.
- */
-interface UseFocusManagementOptions {
-    /** Enable/disable focus management (default: true) */
-    enabled?: boolean;
-    /** Delay before moving focus (after transition) */
-    focusDelay?: number;
-}
-/**
- * Hook that manages keyboard focus when views change.
- * Should be called once in ScrollContainer.
- */
-declare function useFocusManagement(options?: UseFocusManagementOptions): void;
-
-/**
- * Scroll System - Analytics Hook
- * ================================
- * Tracks view engagement metrics for analytics.
- */
-interface ViewAnalytics {
-    viewId: string;
-    viewIndex: number;
-    enterTime: number;
-    exitTime: number | null;
-    duration: number;
-    isActive: boolean;
-}
-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 }),
- * });
- * ```
- */
-declare function useScrollAnalytics(options?: UseScrollAnalyticsOptions): {
-    currentViewId: string | null;
-    currentViewIndex: number;
-    viewStartTime: number;
-    getTimeInView: () => number;
-};
-
-interface UseViewRegistrationOptions {
-    config: ViewConfig;
-    onActivate?: () => void;
-    onDeactivate?: () => void;
-    onEnterStart?: () => void;
-    onEnterEnd?: () => void;
-    onExitStart?: () => void;
-    onExitEnd?: () => void;
-}
-declare function useViewRegistration({ config, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: UseViewRegistrationOptions): {
-    isActive: boolean;
-    viewState: undefined | undefined;
-    index: number;
-    scrollProgress: number;
-    navigation: undefined;
-};
-
-/**
- * Scroll System - Public API Hook
- * =======================================
- * Facade principal para el uso de la librería.
- * Expone una API estable y documentada.
- */
-
-/**
- * Hook principal para consumir el sistema de scroll.
- * Retorna la API pública del sistema.
- */
-declare function useScrollSystem(): ScrollSystemAPI & {
-    isDragging: boolean;
-    isTransitioning: boolean;
-};
-
-interface UseMetricsReporterOptions {
-    id: string;
-    isActive: boolean;
-    scrollDirection: ScrollDirection;
-    onScrollProgress?: (progress: number) => void;
-    /** Custom throttle interval (default: 66ms / ~15fps) */
-    throttleMs?: number;
-}
-declare function useMetricsReporter({ id, isActive, scrollDirection, onScrollProgress, throttleMs, }: UseMetricsReporterOptions): {
-    scrollRef: React$1.RefObject<HTMLDivElement>;
-    measureAndReport: () => void;
-};
-
-declare const useScrollStore: zustand.UseBoundStore<Omit<zustand.StoreApi<ScrollSystemStore>, "subscribe"> & {
-    subscribe: {
-        (listener: (selectedState: ScrollSystemStore, previousSelectedState: ScrollSystemStore) => void): () => void;
-        <U>(selector: (state: ScrollSystemStore) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
-            equalityFn?: ((a: U, b: U) => boolean) | undefined;
-            fireImmediately?: boolean;
-        } | undefined): () => void;
-    };
-}>;
-declare const selectActiveView: (state: ScrollSystemStore) => ViewState;
-declare const selectActiveViewProgress: (state: ScrollSystemStore) => number;
-declare const selectCanNavigateNext: (state: ScrollSystemStore) => boolean;
-declare const selectCanNavigatePrevious: (state: ScrollSystemStore) => boolean;
-
-/**
- * PABRIX Scroll System - Constants
- * =================================
- */
-declare const DEFAULT_TRANSITION_DURATION = 700;
-declare const DEFAULT_TRANSITION_EASING = "cubic-bezier(0.645, 0.045, 0.355, 1.000)";
-declare const DEFAULT_PROGRESS_DEBOUNCE = 16;
-declare const NAVIGATION_COOLDOWN = 500;
-declare const NAV_THRESHOLDS: {
-    WHEEL: number;
-    TOUCH: number;
-};
-
-export { AriaLiveRegion$1 as AriaLiveRegion, type BaseViewConfig, type BaseViewProps, ControlledView$1 as ControlledView, type ControlledViewConfig, type ControlledViewProps, DEFAULT_PROGRESS_DEBOUNCE, DEFAULT_TRANSITION_DURATION, DEFAULT_TRANSITION_EASING, FullView$1 as FullView, type FullViewConfig, type FullViewProps, LazyView$1 as LazyView, NAVIGATION_COOLDOWN, NAV_THRESHOLDS, type NavigationState, type ScrollCapability, ScrollContainer$1 as ScrollContainer, type ScrollContainerProps, ScrollDebugOverlay$1 as ScrollDebugOverlay, type ScrollDirection, ScrollLockedView$1 as ScrollLockedView, type ScrollLockedViewConfig, type ScrollLockedViewProps, type ScrollSystemAPI, type ScrollSystemActions, type ScrollSystemState, type ScrollSystemStore, type UserIntention, type ViewConfig, type ViewMetrics, type ViewState, type ViewType, selectActiveView, selectActiveViewProgress, selectCanNavigateNext, selectCanNavigatePrevious, useActiveViewProgress, useDragHandler, useFocusManagement, useHashSync, useKeyboardHandler, useMetricsReporter, useNavigation$1 as useNavigation, useScrollAnalytics, useScrollStore, useScrollSystem, useTouchHandler, useViewControl$1 as useViewControl, useViewProgress, useViewRegistration, useWheelHandler };
+ * Scroll System
+ * ====================
+ * TikTok-style vertical/horizontal scroll system with snap views.
+ *
+ * @packageDocumentation
+ * @module scroll-system
+ */
+export { ScrollContainer, FullView, ScrollLockedView, ControlledView, useViewControl, ScrollDebugOverlay, AriaLiveRegion, LazyView, NestedScrollView, NestedScrollItem, } from "./components";
+export { useNavigation, // Legacy (consider deprecating for useScrollSystem)
+useViewProgress, useActiveViewProgress, useWheelHandler, useTouchHandler, useKeyboardHandler, useHashSync, useDragHandler, useFocusManagement, useScrollAnalytics, useViewRegistration, useScrollSystem, // Main Public API
+useMetricsReporter, } from "./hooks";
+export { useGlobalProgress, useScrollLock, usePreload, useAutoScroll, useParallax, useActiveParallax, useSnapPoints, createSnapPoints, useInfiniteScroll, useGestureConfig, } from "./hooks";
+export { useScrollStore, selectActiveView, selectActiveViewProgress, selectCanNavigateNext, selectCanNavigatePrevious, selectGlobalProgress, selectIsAutoScrolling, } from "./store";
+export type { ViewType, ScrollDirection, NavigationState, ScrollCapability, UserIntention, BaseViewConfig, FullViewConfig, ScrollLockedViewConfig, ControlledViewConfig, NestedViewConfig, ViewConfig, ViewState, ViewMetrics, ScrollSystemState, ScrollSystemActions, ScrollSystemStore, ScrollSystemAPI, BaseViewProps, FullViewProps, ScrollLockedViewProps, ControlledViewProps, NestedScrollViewProps, ScrollContainerProps, GestureConfig, AutoScrollConfig, SnapPoint, SnapPointState, ParallaxConfig, ParallaxState, PreloadConfig, InfiniteScrollConfig, NestedScrollConfig, } from "./types";
+export { DEFAULT_TRANSITION_DURATION, DEFAULT_TRANSITION_EASING, DEFAULT_PROGRESS_DEBOUNCE, NAVIGATION_COOLDOWN, NAV_THRESHOLDS } from "./constants";
+//# sourceMappingURL=index.d.ts.map