aniview 1.0.0

package/dist/aniviewProvider.d.ts

@@ -0,0 +1,93 @@
+import React from 'react';
+import { SharedValue, WithSpringConfig } from 'react-native-reanimated';
+import { AniviewContextType, AniviewHandle } from "./useAniviewContext";
+import { AniviewConfig } from './aniviewConfig';
+export interface AniviewProviderProps {
+    children: React.ReactNode;
+    /** Explicitly provide a config instance (Advanced) */
+    config?: AniviewConfig;
+    /** The grid layout matrix (e.g., [[1, 1, 1, 1]]) - Simple setup */
+    layout?: number[][];
+    /** The source-of-truth origin page */
+    defaultPage?: number;
+    /** Explicitly override page size. Defaults to container size. */
+    pageSize?: {
+        width: number;
+        height: number;
+    };
+    /** Callback when page changes */
+    onPageChange?: (pageId: number | string) => void;
+    /** Imperative active page control (Legacy) - prefer ref.snapToPage */
+    activePage?: number | string;
+    /** Map of semantic names to numeric page IDs */
+    pageMap?: Record<string, number>;
+    /** External ref for the internal PanGesture (for coordination) */
+    gestureRef?: React.RefObject<any>;
+    /** Custom spring physics */
+    springConfig?: WithSpringConfig;
+    /** External events to drive animations */
+    events?: Record<string, SharedValue<number>>;
+    /** Explicit dimensions override */
+    dimensions?: Partial<AniviewContextType['dimensions']>;
+    /** External lockMask for gesture coordination */
+    externalLockMask?: SharedValue<number>;
+    /** External gesture enabled control (simple on/off) */
+    gestureEnabled?: SharedValue<boolean>;
+    /** Simultaneous gesture handlers for coordination */
+    simultaneousHandlers?: any;
+}
+/**
+ * **AniviewProvider** — World Coordinate System & Gesture Controller
+ *
+ * The root provider that establishes the virtual 2D world in which all
+ * child `Aniview` components live. It manages:
+ *
+ * - **The Camera** (`events.x`, `events.y` SharedValues) — the current
+ *   viewport position in world coordinates, driven by gestures or
+ *   programmatic `snapToPage` calls.
+ * - **Pan Gesture** — a RNGH Pan gesture that translates finger movement
+ *   into camera position updates, with axis locking, edge resistance,
+ *   velocity-based snapping, and bitmask-based directional locks.
+ * - **Virtualization** — tracks which pages are "near" the camera and
+ *   provides a `visiblePages` set for child components.
+ * - **Custom Events** — user-supplied SharedValues (e.g., scroll position,
+ *   slider value) that drive event-based keyframe animations.
+ *
+ * ### Sizing behavior
+ *
+ * By default, the provider measures its own container via `onLayout`
+ * and uses that as the page size. Override with `pageSize` or
+ * `dimensions` if you need explicit control (e.g., for offscreen pages
+ * that are larger than the visible container).
+ *
+ * ### Imperative API
+ *
+ * Attach a `ref` to access `snapToPage(pageId)`, `getCurrentPage()`,
+ * and `lock(mask)` for programmatic navigation.
+ *
+ * @param props.config - Pre-built `AniviewConfig` instance (advanced). Mutually exclusive with `layout`.
+ * @param props.layout - Grid matrix (e.g., `[[1, 1, 1]]` for 3 horizontal pages). Creates an `AniviewConfig` internally.
+ * @param props.defaultPage - The initial page ID (default: `0`).
+ * @param props.pageMap - Semantic name → numeric ID mapping (e.g., `{ HOME: 0, SETTINGS: 1 }`).
+ * @param props.pageSize - Explicit page dimensions. If omitted, inferred from container layout.
+ * @param props.onPageChange - Fires when the camera snaps to a new page.
+ * @param props.springConfig - Custom spring physics for snap animations.
+ * @param props.events - Additional SharedValues that drive event-based keyframes.
+ * @param props.externalLockMask - Externally controlled bitmask SharedValue for gesture locking. See {@link useAniviewLock}.
+ * @param props.gestureEnabled - SharedValue to globally enable/disable the pan gesture.
+ * @param props.simultaneousHandlers - RNGH refs for gesture coordination with parent/sibling handlers.
+ * @param props.activePage - (Legacy) Declarative page control. Prefer `ref.snapToPage()`.
+ *
+ * @example
+ * ```tsx
+ * const config = new AniviewConfig([[1, 1, 1]], 0, { HOME: 0, FEED: 1, PROFILE: 2 });
+ * const scrollY = useSharedValue(0);
+ *
+ * <AniviewProvider ref={aniviewRef} config={config} events={{ scrollY }} onPageChange={setPage}>
+ *   <Aniview pageId="HOME">...</Aniview>
+ *   <Aniview pageId="FEED">...</Aniview>
+ * </AniviewProvider>
+ * ```
+ */
+export declare const AniviewProvider: React.ForwardRefExoticComponent<AniviewProviderProps & React.RefAttributes<AniviewHandle>>;
+//# sourceMappingURL=aniviewProvider.d.ts.map

package/dist/aniviewProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aniviewProvider.d.ts","sourceRoot":"","sources":["../src/aniviewProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgF,MAAM,OAAO,CAAC;AAErG,OAAiB,EAA2C,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3H,OAAO,EAAkB,kBAAkB,EAAE,aAAa,EAAyD,MAAM,qBAAqB,CAAC;AAC/I,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sDAAsD;IACtD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACjD,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kEAAkE;IAClE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAClC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;IACvD,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,uDAAuD;IACvD,cAAc,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,GAAG,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,eAAe,4FAqN1B,CAAC"}

package/dist/aniviewProvider.js

@@ -0,0 +1,229 @@
+import React, { useMemo, useEffect, useRef, useState, useImperativeHandle, forwardRef } from 'react';
+import Animated, { useSharedValue, withSpring, makeMutable } from 'react-native-reanimated';
+import { AniviewContext } from "./useAniviewContext";
+import { AniviewConfig } from './aniviewConfig';
+import { GestureDetector } from 'react-native-gesture-handler';
+import * as AniviewMath from './core/AniviewMath';
+/**
+ * **AniviewProvider** — World Coordinate System & Gesture Controller
+ *
+ * The root provider that establishes the virtual 2D world in which all
+ * child `Aniview` components live. It manages:
+ *
+ * - **The Camera** (`events.x`, `events.y` SharedValues) — the current
+ *   viewport position in world coordinates, driven by gestures or
+ *   programmatic `snapToPage` calls.
+ * - **Pan Gesture** — a RNGH Pan gesture that translates finger movement
+ *   into camera position updates, with axis locking, edge resistance,
+ *   velocity-based snapping, and bitmask-based directional locks.
+ * - **Virtualization** — tracks which pages are "near" the camera and
+ *   provides a `visiblePages` set for child components.
+ * - **Custom Events** — user-supplied SharedValues (e.g., scroll position,
+ *   slider value) that drive event-based keyframe animations.
+ *
+ * ### Sizing behavior
+ *
+ * By default, the provider measures its own container via `onLayout`
+ * and uses that as the page size. Override with `pageSize` or
+ * `dimensions` if you need explicit control (e.g., for offscreen pages
+ * that are larger than the visible container).
+ *
+ * ### Imperative API
+ *
+ * Attach a `ref` to access `snapToPage(pageId)`, `getCurrentPage()`,
+ * and `lock(mask)` for programmatic navigation.
+ *
+ * @param props.config - Pre-built `AniviewConfig` instance (advanced). Mutually exclusive with `layout`.
+ * @param props.layout - Grid matrix (e.g., `[[1, 1, 1]]` for 3 horizontal pages). Creates an `AniviewConfig` internally.
+ * @param props.defaultPage - The initial page ID (default: `0`).
+ * @param props.pageMap - Semantic name → numeric ID mapping (e.g., `{ HOME: 0, SETTINGS: 1 }`).
+ * @param props.pageSize - Explicit page dimensions. If omitted, inferred from container layout.
+ * @param props.onPageChange - Fires when the camera snaps to a new page.
+ * @param props.springConfig - Custom spring physics for snap animations.
+ * @param props.events - Additional SharedValues that drive event-based keyframes.
+ * @param props.externalLockMask - Externally controlled bitmask SharedValue for gesture locking. See {@link useAniviewLock}.
+ * @param props.gestureEnabled - SharedValue to globally enable/disable the pan gesture.
+ * @param props.simultaneousHandlers - RNGH refs for gesture coordination with parent/sibling handlers.
+ * @param props.activePage - (Legacy) Declarative page control. Prefer `ref.snapToPage()`.
+ *
+ * @example
+ * ```tsx
+ * const config = new AniviewConfig([[1, 1, 1]], 0, { HOME: 0, FEED: 1, PROFILE: 2 });
+ * const scrollY = useSharedValue(0);
+ *
+ * <AniviewProvider ref={aniviewRef} config={config} events={{ scrollY }} onPageChange={setPage}>
+ *   <Aniview pageId="HOME">...</Aniview>
+ *   <Aniview pageId="FEED">...</Aniview>
+ * </AniviewProvider>
+ * ```
+ */
+export const AniviewProvider = forwardRef(({ children, config: providedConfig, layout, defaultPage = 0, pageSize, onPageChange, activePage, gestureRef, springConfig, events: externalEvents, pageMap = {}, dimensions: providedDims, externalLockMask, gestureEnabled: externalGestureEnabled, simultaneousHandlers }, ref) => {
+    // --- CONFIG MANAGEMENT ---
+    const config = useMemo(() => {
+        if (providedConfig)
+            return providedConfig;
+        if (layout)
+            return new AniviewConfig(layout, defaultPage, pageMap, {}, {}, {});
+        return new AniviewConfig([[1]], 0, pageMap, {}, {}, {}); // Fallback
+    }, [providedConfig, layout, defaultPage, pageMap]);
+    // --- STATE & PHYSICS ---
+    const x = useSharedValue(0);
+    const y = useSharedValue(0);
+    // Use external lockMask if provided, otherwise create internal one
+    const internalLockMask = useSharedValue(0);
+    const lockMask = externalLockMask || internalLockMask;
+    // Use external gestureEnabled if provided, otherwise create internal one
+    const internalGestureEnabled = useSharedValue(true);
+    const gestureEnabled = externalGestureEnabled || internalGestureEnabled;
+    const lastTargetId = useSharedValue(config.defaultPage);
+    const isMoving = useSharedValue(false);
+    const [dimensions, setDimensions] = useState({
+        width: providedDims?.width ?? pageSize?.width ?? 0,
+        height: providedDims?.height ?? pageSize?.height ?? 0,
+        offsetX: providedDims?.offsetX ?? 0,
+        offsetY: providedDims?.offsetY ?? 0
+    });
+    // --- VIRTUALIZATION STATE ---
+    // Tracks which pages are near the "viewport" on the JS thread
+    // We use a ref and a forced refresh ONLY when absolutely needed to prevent 
+    // every Aniview component from re-rendering on every page traversal.
+    const visiblePagesRef = useRef(new Set([config.resolvePageId(defaultPage)]));
+    const updateVisibility = (centerPage) => {
+        const visible = new Set();
+        const pages = config.getPages();
+        const resolvedCenter = config.resolvePageId(centerPage);
+        const centerPos = AniviewMath.pageIdToMatrixPos(resolvedCenter, config.layout);
+        pages.forEach((p) => {
+            const pPos = AniviewMath.pageIdToMatrixPos(p, config.layout);
+            const rowDist = Math.abs(pPos.r - centerPos.r);
+            const colDist = Math.abs(pPos.c - centerPos.c);
+            if (rowDist <= 1 && colDist <= 1)
+                visible.add(p);
+        });
+        const current = visiblePagesRef.current;
+        if (current.size !== visible.size || ![...visible].every(v => current.has(v))) {
+            visiblePagesRef.current = visible;
+            // Optimization: NO BROADCAST. 
+            // We rely on the native proxy for virtualization checks within worklets.
+        }
+    };
+    // Sync the SharedValue target into the config engine for virtualization worklets
+    useEffect(() => {
+        if (config._setCurrentPageSV) {
+            config._setCurrentPageSV(lastTargetId);
+        }
+    }, [config, lastTargetId]);
+    // --- IMPERATIVE API ---
+    useImperativeHandle(ref, () => ({
+        snapToPage: (pageId) => {
+            const offset = config.getPageOffset(pageId, dimensions);
+            const springConfig = config.getSpringConfig();
+            isMoving.value = true;
+            x.value = withSpring(offset.x, springConfig, (finished) => {
+                if (finished)
+                    isMoving.value = false;
+            });
+            y.value = withSpring(offset.y, springConfig);
+            lastTargetId.value = pageId;
+            updateVisibility(pageId);
+            if (onPageChange)
+                onPageChange(pageId);
+        },
+        getCurrentPage: () => lastTargetId.value,
+        lock: (mask) => { lockMask.value = mask; }
+    }));
+    // --- DYNAMIC UPDATES ---
+    useEffect(() => {
+        if (springConfig)
+            config.updateSpringConfig(springConfig);
+    }, [springConfig, config]);
+    useEffect(() => {
+        config.updateDimensions(dimensions);
+    }, [dimensions, config]);
+    // --- ONLAYOUT AUTO-SIZING ---
+    const onLayout = (e) => {
+        const { width, height, x: layoutX, y: layoutY } = e.nativeEvent.layout;
+        // Only update if dimensions drastically changed (debounce/diff)
+        if (Math.abs(width - dimensions.width) > 1 ||
+            Math.abs(height - dimensions.height) > 1 ||
+            Math.abs(layoutX - dimensions.offsetX) > 1 ||
+            Math.abs(layoutY - dimensions.offsetY) > 1) {
+            setDimensions(prev => ({
+                ...prev,
+                width: providedDims?.width ?? (pageSize?.width || width),
+                height: providedDims?.height ?? (pageSize?.height || height),
+                offsetX: layoutX,
+                offsetY: layoutY
+            }));
+        }
+    };
+    // --- VIRTUALIZATION ---
+    const activationMap = useMemo(() => {
+        const map = {};
+        config.getPages().forEach(id => {
+            map[id] = makeMutable(1);
+        });
+        return map;
+    }, [config]);
+    // --- BOOTSTRAPPING ---
+    useEffect(() => {
+        if (config) {
+            const offset = config.getPageOffset(config.defaultPage, dimensions);
+            x.value = offset.x;
+            y.value = offset.y;
+            lastTargetId.value = config.defaultPage;
+        }
+    }, [config]);
+    // --- LEGACY TAB SYNC ---
+    useEffect(() => {
+        if (config && activePage !== undefined) {
+            if (lastTargetId.value === activePage)
+                return;
+            const offset = config.getPageOffset(activePage, dimensions);
+            const isMoved = Math.abs(x.value - offset.x) > 1 || Math.abs(y.value - offset.y) > 1;
+            if (isMoved) {
+                const physics = config.getSpringConfig();
+                isMoving.value = true;
+                x.value = withSpring(offset.x, physics, (finished) => {
+                    if (finished)
+                        isMoving.value = false;
+                });
+                y.value = withSpring(offset.y, physics);
+                lastTargetId.value = activePage;
+            }
+        }
+    }, [activePage, config]);
+    // --- GESTURE ---
+    // We recreate the gesture when key dependencies change. 
+    // Ideally this should be stable, but config.generateGesture needs latest dims logic if re-run.
+    const panGesture = useMemo(() => {
+        return config.generateGesture(x, y, (pageId) => {
+            lastTargetId.value = pageId;
+            updateVisibility(pageId);
+            if (onPageChange)
+                onPageChange(pageId);
+        }, lockMask, simultaneousHandlers, gestureEnabled, dimensions, isMoving, lastTargetId);
+    }, [config, x, y, lockMask, onPageChange, dimensions, isMoving]); // Force rebuild when dimensions hit bitumen
+    if (gestureRef) {
+        panGesture.ref = gestureRef;
+    }
+    const contextValue = useMemo(() => ({
+        dimensions,
+        events: { x, y, ...(externalEvents || {}) },
+        activationMap,
+        panGesture,
+        config,
+        lock: (mask) => { lockMask.value = mask; },
+        visiblePages: visiblePagesRef.current,
+        isMoving
+    }), [dimensions, x, y, externalEvents, activationMap, config, panGesture, lockMask]);
+    return (<AniviewContext.Provider value={contextValue}>
+      <GestureDetector gesture={panGesture}>
+        {/* The Stage */}
+        <Animated.View style={{ flex: 1 }} onLayout={onLayout}>
+          {children}
+        </Animated.View>
+      </GestureDetector>
+    </AniviewContext.Provider>);
+});
+//# sourceMappingURL=aniviewProvider.js.map

package/dist/aniviewProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aniviewProvider.js","sourceRoot":"","sources":["../src/aniviewProvider.tsx"],"names":[],"mappings":"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"}

package/dist/core/AniviewLock.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Valid directions for locking Aniview gestures.
+ */
+export type AniviewAxisLock = {
+    left?: boolean;
+    right?: boolean;
+    up?: boolean;
+    down?: boolean;
+};
+/**
+ * Utility to generate Aniview lock bitmasks.
+ */
+export declare const AniviewLock: {
+    mask: (directions: AniviewAxisLock) => number;
+};
+//# sourceMappingURL=AniviewLock.d.ts.map

package/dist/core/AniviewLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AniviewLock.d.ts","sourceRoot":"","sources":["../../src/core/AniviewLock.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;uBACD,eAAe;CAQrC,CAAC"}

package/dist/core/AniviewLock.js

@@ -0,0 +1,18 @@
+/**
+ * Utility to generate Aniview lock bitmasks.
+ */
+export const AniviewLock = {
+    mask: (directions) => {
+        let mask = 0;
+        if (directions.left)
+            mask |= 1;
+        if (directions.right)
+            mask |= 2;
+        if (directions.up)
+            mask |= 4;
+        if (directions.down)
+            mask |= 8;
+        return mask;
+    }
+};
+//# sourceMappingURL=AniviewLock.js.map

package/dist/core/AniviewLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AniviewLock.js","sourceRoot":"","sources":["../../src/core/AniviewLock.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,IAAI,EAAE,CAAC,UAA2B,EAAE,EAAE;QAClC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,UAAU,CAAC,IAAI;YAAE,IAAI,IAAI,CAAC,CAAC;QAC/B,IAAI,UAAU,CAAC,KAAK;YAAE,IAAI,IAAI,CAAC,CAAC;QAChC,IAAI,UAAU,CAAC,EAAE;YAAE,IAAI,IAAI,CAAC,CAAC;QAC7B,IAAI,UAAU,CAAC,IAAI;YAAE,IAAI,IAAI,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAC"}

package/dist/core/AniviewMath.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ANIVIEW MATH CORE
+ *
+ * Pure functional implementation of Aniview's spatial logic.
+ */
+export interface MatrixPos {
+    r: number;
+    c: number;
+}
+export interface WorldBounds {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+}
+/**
+ * Converts a linear PageID to a (Row, Column) matrix position.
+ */
+export declare function pageIdToMatrixPos(pageId: number, layout: number[][]): MatrixPos;
+/**
+ * Calculates the displacement between two indices on an axis, accounting for overlaps.
+ */
+export declare function calculateAxisOffset(from: number, to: number, size: number, overlaps: number[]): number;
+/**
+ * Calculates the (x, y) coordinates of a page relative to a default origin page.
+ */
+export declare function getPageOffset(pageId: number, layout: number[][], contextDims: {
+    width: number;
+    height: number;
+}, defaultPage: number, rowOverlaps: number[], colOverlaps: number[]): {
+    x: number;
+    y: number;
+};
+/**
+ * Calculates the absolute boundaries of the virtual world.
+ */
+export declare function getWorldBounds(pages: number[], layout: number[][], contextDims: {
+    width: number;
+    height: number;
+}, defaultPage: number, rowOverlaps: number[], colOverlaps: number[]): WorldBounds;
+//# sourceMappingURL=AniviewMath.d.ts.map

package/dist/core/AniviewMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AniviewMath.d.ts","sourceRoot":"","sources":["../../src/core/AniviewMath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,CAc/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAS1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB,WAAW,CAgBb"}

package/dist/core/AniviewMath.js

@@ -0,0 +1,69 @@
+/**
+ * ANIVIEW MATH CORE
+ *
+ * Pure functional implementation of Aniview's spatial logic.
+ */
+/**
+ * Converts a linear PageID to a (Row, Column) matrix position.
+ */
+export function pageIdToMatrixPos(pageId, layout) {
+    'worklet';
+    const rowLength = Math.max(1, layout[0]?.length || 0);
+    const numRows = layout.length;
+    const maxPage = numRows * rowLength - 1;
+    if (pageId < 0 || pageId > maxPage) {
+        return { r: 9999, c: 9999 };
+    }
+    return {
+        r: Math.floor(pageId / rowLength),
+        c: pageId % rowLength
+    };
+}
+/**
+ * Calculates the displacement between two indices on an axis, accounting for overlaps.
+ */
+export function calculateAxisOffset(from, to, size, overlaps) {
+    'worklet';
+    if (from === to)
+        return 0;
+    const direction = to > from ? 1 : -1;
+    let totalOffset = 0;
+    const start = Math.min(from, to);
+    const end = Math.max(from, to);
+    for (let i = start; i < end; i++) {
+        const overlapRatio = overlaps[i] || 0;
+        totalOffset += size * (1 - overlapRatio);
+    }
+    return totalOffset * direction;
+}
+/**
+ * Calculates the (x, y) coordinates of a page relative to a default origin page.
+ */
+export function getPageOffset(pageId, layout, contextDims, defaultPage, rowOverlaps, colOverlaps) {
+    'worklet';
+    const target = pageIdToMatrixPos(pageId, layout);
+    const origin = pageIdToMatrixPos(defaultPage, layout);
+    return {
+        x: calculateAxisOffset(origin.c, target.c, contextDims.width, colOverlaps),
+        y: calculateAxisOffset(origin.r, target.r, contextDims.height, rowOverlaps)
+    };
+}
+/**
+ * Calculates the absolute boundaries of the virtual world.
+ */
+export function getWorldBounds(pages, layout, contextDims, defaultPage, rowOverlaps, colOverlaps) {
+    'worklet';
+    if (pages.length === 0)
+        return { minX: 0, maxX: 0, minY: 0, maxY: 0 };
+    const firstOffset = getPageOffset(pages[0], layout, contextDims, defaultPage, rowOverlaps, colOverlaps);
+    let minX = firstOffset.x, maxX = firstOffset.x, minY = firstOffset.y, maxY = firstOffset.y;
+    for (let i = 1; i < pages.length; i++) {
+        const offset = getPageOffset(pages[i], layout, contextDims, defaultPage, rowOverlaps, colOverlaps);
+        minX = Math.min(minX, offset.x);
+        maxX = Math.max(maxX, offset.x);
+        minY = Math.min(minY, offset.y);
+        maxY = Math.max(maxY, offset.y);
+    }
+    return { minX, maxX, minY, maxY };
+}
+//# sourceMappingURL=AniviewMath.js.map

package/dist/core/AniviewMath.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { default as Aniview } from './Aniview';
+export { AniviewProvider } from './aniviewProvider';
+export { AniviewConfig } from './aniviewConfig';
+export { useAniview } from './useAniview';
+export { useAniviewLock, AniviewLock } from './useAniviewLock';
+export * from './useAniviewContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { default as Aniview } from './Aniview';
+export { AniviewProvider } from './aniviewProvider';
+export { AniviewConfig } from './aniviewConfig';
+export { useAniview } from './useAniview';
+export { useAniviewLock, AniviewLock } from './useAniviewLock';
+export * from './useAniviewContext';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,cAAc,qBAAqB,CAAC"}

package/dist/useAniview.d.ts

@@ -0,0 +1,39 @@
+import { AniviewProps, AniviewLogic, AniviewContextType } from "./useAniviewContext";
+/**
+ * **useAniview** — Access the Aniview world context
+ *
+ * This hook has two overloads:
+ *
+ * **1. Context-only** (`useAniview()`) — Returns the raw {@link AniviewContextType}
+ * containing the camera SharedValues, config, dimensions, and gesture state.
+ * Use this when you need to read the camera position or react to page changes
+ * without being an animated component yourself.
+ *
+ * **2. Per-component** (`useAniview(props)`) — Used internally by `Aniview`
+ * components. Registers the component's `pageId` with the config engine and
+ * returns an {@link AniviewLogic} object containing the resolved registration,
+ * activation value, and keyframes. You rarely need this overload directly.
+ *
+ * @returns When called without arguments: `{ dimensions, events, config, activationMap, panGesture, visiblePages, isMoving }`
+ * @returns When called with props: `AniviewLogic` with additional `registration`, `activationValue`, and `keyframes`
+ *
+ * @throws Error if called outside of an `<AniviewProvider />`
+ *
+ * @example
+ * ```tsx
+ * // Read camera position from any child
+ * function CameraDebug() {
+ *   const { events } = useAniview();
+ *   // events.x.value, events.y.value are the camera world coordinates
+ * }
+ *
+ * // React to custom events
+ * function ScrollReactor() {
+ *   const { events } = useAniview();
+ *   // events.scrollY?.value (if parent passed events={{ scrollY }})
+ * }
+ * ```
+ */
+export declare function useAniview(): AniviewContextType;
+export declare function useAniview(props: AniviewProps): AniviewLogic;
+//# sourceMappingURL=useAniview.d.ts.map

package/dist/useAniview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAniview.d.ts","sourceRoot":"","sources":["../src/useAniview.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkB,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,CAAC;AACjD,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAAC"}

package/dist/useAniview.js

@@ -0,0 +1,32 @@
+import { useContext } from 'react';
+import { AniviewContext } from "./useAniviewContext";
+export function useAniview(props) {
+    const context = useContext(AniviewContext);
+    if (!context) {
+        throw new Error('Aniview components must be wrapped in an <AniviewProvider />');
+    }
+    // If no props provided, just return the raw context
+    if (!props || typeof props !== 'object')
+        return context;
+    const pageId = props.pageId;
+    const registration = context.config ? context.config.registerPage(pageId, context.dimensions) : {
+        offset: { x: 0, y: 0 },
+        dimensions: context.dimensions
+    };
+    const activationValue = (context.activationMap && pageId !== undefined) ? context.activationMap[pageId] : null;
+    const logic = {
+        dimensions: context.dimensions,
+        events: context.events,
+        activationMap: context.activationMap,
+        panGesture: context.panGesture,
+        config: context.config,
+        registration: registration,
+        activationValue: activationValue,
+        keyframes: props.frames,
+        lock: context.lock,
+        visiblePages: context.visiblePages,
+        isMoving: context.isMoving,
+    };
+    return logic;
+}
+//# sourceMappingURL=useAniview.js.map

package/dist/useAniview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAniview.js","sourceRoot":"","sources":["../src/useAniview.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAAkD,MAAM,qBAAqB,CAAC;AAuCrG,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAExD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAE5B,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAE,OAAO,CAAC,aAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExH,MAAM,KAAK,GAAiB;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,YAAmB;QACjC,eAAe,EAAE,eAAsB;QACvC,SAAS,EAAE,KAAK,CAAC,MAAa;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}