scroll-system 1.0.1 → 1.1.0

package/dist/store/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigation.store";
+//# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../store/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/store/navigation.store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Scroll System - Navigation Store
+ * ========================================
+ * Store principal de Zustand con Arquitectura Determinística.
+ * Implementa State Machine explícita y Modelo de Intención.
+ */
+import type { ScrollSystemStore, ViewState } from "../types";
+export declare const useScrollStore: import("zustand").UseBoundStore<Omit<import("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;
+    };
+}>;
+export declare const selectActiveView: (state: ScrollSystemStore) => ViewState;
+export declare const selectActiveViewProgress: (state: ScrollSystemStore) => number;
+export declare const selectCanNavigateNext: (state: ScrollSystemStore) => boolean;
+export declare const selectCanNavigatePrevious: (state: ScrollSystemStore) => boolean;
+export declare const selectGlobalProgress: (state: ScrollSystemStore) => number;
+export declare const selectIsAutoScrolling: (state: ScrollSystemStore) => boolean;
+//# sourceMappingURL=navigation.store.d.ts.map

package/dist/store/navigation.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.store.d.ts","sourceRoot":"","sources":["../../store/navigation.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGjB,SAAS,EAKV,MAAM,UAAU,CAAC;AA6DlB,eAAO,MAAM,cAAc;;;;;;;;EAmR1B,CAAC;AAMF,eAAO,MAAM,gBAAgB,GAAI,OAAO,iBAAiB,cACzB,CAAC;AAEjC,eAAO,MAAM,wBAAwB,GAAI,OAAO,iBAAiB,WAClB,CAAC;AAEhD,eAAO,MAAM,qBAAqB,GAAI,OAAO,iBAAiB,YAM7D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,iBAAiB,YAIjE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,iBAAiB,WACvC,CAAC;AAEvB,eAAO,MAAM,qBAAqB,GAAI,OAAO,iBAAiB,YACV,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,315 @@
+/**
+ * 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.
+ */
+export type ScrollCapability = "none" | "internal";
+/**
+ * Estado de permiso de navegación.
+ */
+export type NavigationState = "locked" | "unlocked";
+/**
+ * Métricas crudas del DOM reportadas por las vistas.
+ */
+export interface ViewMetrics {
+    scrollHeight: number;
+    clientHeight: number;
+    scrollTop: number;
+}
+export type UserIntentionType = "scroll" | "navigate";
+export type UserDirection = "up" | "down" | "left" | "right";
+export interface UserIntention {
+    type: UserIntentionType;
+    direction: UserDirection;
+    strength: number;
+    origin: "wheel" | "touch" | "keyboard" | "programmatic";
+}
+/**
+ * Configuration for gesture sensitivity and behavior.
+ */
+export interface GestureConfig {
+    /** Minimum distance in px to trigger a swipe (default: 50) */
+    swipeThreshold?: number;
+    /** Minimum velocity in px/ms to trigger a swipe (default: 0.5) */
+    swipeVelocity?: number;
+    /** Resistance factor when dragging at boundaries 0-1 (default: 0.3) */
+    dragResistance?: number;
+    /** Enable/disable wheel navigation (default: true) */
+    enableWheel?: boolean;
+    /** Enable/disable touch navigation (default: true) */
+    enableTouch?: boolean;
+    /** Enable/disable keyboard navigation (default: true) */
+    enableKeyboard?: boolean;
+}
+/**
+ * Configuration for automatic view advancement.
+ */
+export interface AutoScrollConfig {
+    /** Enable auto-scroll functionality */
+    enabled: boolean;
+    /** Interval between transitions in ms */
+    interval: number;
+    /** Pause auto-scroll when user interacts (default: true) */
+    pauseOnInteraction?: boolean;
+    /** Resume delay after interaction in ms (default: 3000) */
+    resumeDelay?: number;
+    /** Direction of auto-scroll (default: 'forward') */
+    direction?: "forward" | "backward";
+    /** Stop at last view or loop (requires infiniteScroll) */
+    stopAtEnd?: boolean;
+}
+/**
+ * A snap point within a view for sub-view navigation.
+ */
+export interface SnapPoint {
+    /** Unique identifier for the snap point */
+    id: string;
+    /** Position within the view as percentage 0-1 */
+    position: number;
+    /** Optional label for accessibility */
+    label?: string;
+    /** Callback when this snap point is reached */
+    onReach?: () => void;
+    /** Callback when leaving this snap point */
+    onLeave?: () => void;
+}
+/**
+ * State of snap points within a view.
+ */
+export interface SnapPointState {
+    viewId: string;
+    points: SnapPoint[];
+    activePointId: string | null;
+    activePointIndex: number;
+}
+/**
+ * Configuration for parallax effects.
+ */
+export interface ParallaxConfig {
+    /** Speed multiplier (1 = normal, <1 = slower, >1 = faster). Default: 0.5 */
+    speed?: number;
+    /** Direction of parallax effect (default: matches container orientation) */
+    direction?: "vertical" | "horizontal";
+    /** Initial offset in pixels */
+    offset?: number;
+    /** Easing function for the effect */
+    easing?: "linear" | "easeOut" | "easeInOut";
+}
+/**
+ * Return type for useParallax hook.
+ */
+export interface ParallaxState {
+    /** Current transform value in pixels */
+    transform: number;
+    /** CSS transform string ready to use */
+    style: React.CSSProperties;
+    /** Current progress 0-1 based on view visibility */
+    progress: number;
+}
+/**
+ * Configuration for view preloading.
+ */
+export interface PreloadConfig {
+    /** Number of views to preload ahead (default: 1) */
+    ahead?: number;
+    /** Number of views to preload behind (default: 1) */
+    behind?: number;
+    /** Delay before preloading starts in ms (default: 100) */
+    delay?: number;
+}
+/**
+ * Configuration for infinite/loop scroll behavior.
+ */
+export interface InfiniteScrollConfig {
+    /** Enable infinite scroll (loop from last to first) */
+    enabled: boolean;
+    /** Direction(s) to loop (default: 'both') */
+    loopDirection?: "forward" | "backward" | "both";
+}
+/**
+ * Configuration for nested scroll areas.
+ */
+export interface NestedScrollConfig {
+    /** Direction of nested scroll (perpendicular to main) */
+    direction: "horizontal" | "vertical";
+    /** Enable snap behavior within nested scroll */
+    enableSnap?: boolean;
+    /** Number of items/sections in nested scroll */
+    itemCount?: number;
+    /** Current active item index */
+    activeItem?: number;
+    /** Callback when nested item changes */
+    onItemChange?: (index: number) => void;
+}
+export 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;
+    isAutoScrolling?: boolean;
+    pauseAutoScroll?: () => void;
+    resumeAutoScroll?: () => void;
+}
+export type ViewType = "full" | "scroll-locked" | "controlled" | "nested";
+export type ScrollDirection = "vertical" | "horizontal" | "none";
+export interface BaseViewConfig {
+    id: string;
+    type: ViewType;
+    index?: number;
+    meta?: Record<string, unknown>;
+    /** Snap points within this view (NEW) */
+    snapPoints?: SnapPoint[];
+}
+export interface FullViewConfig extends BaseViewConfig {
+    type: "full";
+}
+export interface ScrollLockedViewConfig extends BaseViewConfig {
+    type: "scroll-locked";
+    scrollDirection: ScrollDirection;
+    scrollEndThreshold?: number;
+}
+export interface ControlledViewConfig extends BaseViewConfig {
+    type: "controlled";
+    scrollDirection?: ScrollDirection;
+    allowInternalScroll?: boolean;
+    allowGoBack?: boolean;
+}
+export interface NestedViewConfig extends BaseViewConfig {
+    type: "nested";
+    nestedConfig: NestedScrollConfig;
+}
+export type ViewConfig = FullViewConfig | ScrollLockedViewConfig | ControlledViewConfig | NestedViewConfig;
+export interface ViewState {
+    id: string;
+    index: number;
+    type: ViewType;
+    isActive: boolean;
+    /** NEW: Is this view preloaded */
+    isPreloaded: boolean;
+    capability: ScrollCapability;
+    navigation: NavigationState;
+    explicitLock: NavigationState | null;
+    progress: number;
+    metrics: ViewMetrics;
+    config: ViewConfig;
+    /** NEW: Active snap point within this view */
+    activeSnapPointId: string | null;
+}
+export interface ScrollSystemState {
+    views: ViewState[];
+    activeIndex: number;
+    activeId: string | null;
+    totalViews: number;
+    isInitialized: boolean;
+    isTransitioning: boolean;
+    isGlobalLocked: boolean;
+    isDragging: boolean;
+    globalProgress: number;
+    /** NEW: AutoScroll state */
+    isAutoScrolling: boolean;
+    isAutoScrollPaused: boolean;
+    /** NEW: Infinite scroll enabled */
+    infiniteScrollEnabled: boolean;
+}
+export 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;
+    setAutoScrolling: (enabled: boolean) => void;
+    setAutoScrollPaused: (paused: boolean) => void;
+    setInfiniteScrollEnabled: (enabled: boolean) => void;
+    setViewPreloaded: (id: string, preloaded: boolean) => void;
+    setActiveSnapPoint: (viewId: string, snapPointId: string | null) => void;
+    resetNavigationCooldown: () => void;
+}
+export type ScrollSystemStore = ScrollSystemState & ScrollSystemActions;
+export interface BaseViewProps {
+    id: string;
+    children: React.ReactNode;
+    className?: string;
+    onActivate?: () => void;
+    onDeactivate?: () => void;
+    onEnterStart?: () => void;
+    onEnterEnd?: () => void;
+    onExitStart?: () => void;
+    onExitEnd?: () => void;
+    /** NEW: Snap points within this view */
+    snapPoints?: SnapPoint[];
+    /** NEW: Callback when snap point changes */
+    onSnapPointChange?: (snapPointId: string | null) => void;
+}
+export interface FullViewProps extends BaseViewProps {
+    meta?: Record<string, unknown>;
+}
+export interface ScrollLockedViewProps extends BaseViewProps {
+    scrollDirection?: ScrollDirection;
+    scrollEndThreshold?: number;
+    onScrollProgress?: (progress: number) => void;
+}
+export interface ControlledViewProps extends BaseViewProps {
+    scrollDirection?: ScrollDirection;
+    allowInternalScroll?: boolean;
+    canProceed?: boolean;
+    allowGoBack?: boolean;
+}
+/** NEW: Props for NestedScrollView component */
+export interface NestedScrollViewProps extends BaseViewProps {
+    /** Direction of nested scroll (perpendicular to main) */
+    nestedDirection?: "horizontal" | "vertical";
+    /** Enable snap behavior within nested scroll */
+    enableSnap?: boolean;
+    /** Callback when nested item changes */
+    onItemChange?: (index: number) => void;
+}
+export interface ScrollContainerProps {
+    children: React.ReactNode;
+    className?: string;
+    transitionDuration?: number;
+    transitionEasing?: string;
+    onViewChange?: (fromIndex: number, toIndex: number) => void;
+    onInitialized?: () => void;
+    enableHashSync?: boolean;
+    hashPushHistory?: boolean;
+    hashPrefix?: string;
+    respectReducedMotion?: boolean;
+    enableFocusManagement?: boolean;
+    enableDragPhysics?: boolean;
+    orientation?: "vertical" | "horizontal";
+    /** Skip the initial animation when mounting (default: false) */
+    skipInitialAnimation?: boolean;
+    /** Callback reporting global scroll progress 0-1 */
+    onProgress?: (progress: number) => void;
+    /** Custom gesture sensitivity and behavior */
+    gestureConfig?: GestureConfig;
+    /** Enable automatic view advancement */
+    autoScroll?: AutoScrollConfig;
+    /** Enable looping from last to first view */
+    infiniteScroll?: boolean | InfiniteScrollConfig;
+    /** Configure view preloading */
+    preload?: boolean | PreloadConfig;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Scroll System - Utility Functions
+ * =========================================
+ * Performance utilities for the scroll system.
+ */
+/**
+ * Creates a throttled version of a function.
+ * The function will only be called at most once per `limit` milliseconds.
+ */
+export declare function throttle<T extends (...args: unknown[]) => void>(fn: T, limit: number): T;
+/**
+ * Check if user prefers reduced motion.
+ * Returns true if the user has enabled "Reduce motion" in their OS settings.
+ */
+export declare function prefersReducedMotion(): boolean;
+/**
+ * Get transition duration respecting reduced motion preference.
+ * Returns 0 if user prefers reduced motion, otherwise returns the provided duration.
+ */
+export declare function getTransitionDuration(duration: number): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAC7D,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,CAyBH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/utils/normalizeWheel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Normaliza eventos de rueda (mouse wheel) entre navegadores.
+ * Retorna pixelY consistente.
+ */
+export declare function normalizeWheel(event: any): {
+    pixelX: number;
+    pixelY: number;
+    pixelZ: number;
+};
+//# sourceMappingURL=normalizeWheel.d.ts.map

package/dist/utils/normalizeWheel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeWheel.d.ts","sourceRoot":"","sources":["../../utils/normalizeWheel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG;;;;EAyCxC"}

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "scroll-system",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "TikTok-style vertical scroll system with snap views, touch physics, and accessibility features",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "tsup index.ts --format cjs,esm --dts",
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist",
+    "build:js": "tsup",
+    "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
     "test": "vitest",
     "test:run": "vitest run",
     "prepublishOnly": "npm run test:run && npm run build"