react-native-divkit 1.6.5 → 1.7.0

package/dist/components/pager/DivPager.js

@@ -0,0 +1,269 @@
+import React, { useEffect, useMemo, useRef, useState, useCallback } from 'react';
+import { View, ScrollView, StyleSheet } from 'react-native';
+import { Outer } from '../utilities/Outer';
+import { DivComponent } from '../DivComponent';
+import { useDerivedFromVarsSimple } from '../../hooks/useDerivedFromVars';
+import { useDivKitContext } from '../../context/DivKitContext';
+import { usePagerContextOptional } from '../../context/PagerContext';
+import { wrapError } from '../../utils/wrapError';
+import { DUPLICATES_IN_INFINITE, buildRenderedItems, computeContentPad, computePageSize, isInDuplicateRegion as isInDuplicateRegionFn, isInfiniteEnabled, offsetToPosition, positionToReal as positionToRealFn, realToPosition as realToPositionFn } from './utils';
+const DUPLICATES = DUPLICATES_IN_INFINITE;
+/**
+ * DivPager — horizontal/vertical pager with snap-to-page scrolling.
+ *
+ * Based on Web Pager.svelte. Adapted for React Native:
+ * - Uses ScrollView with snapToInterval for paging behaviour.
+ * - Computes per-page size from layout_mode (fixed neighbour, percentage,
+ *   wrap_content) once container size is known.
+ * - infinite_scroll: renders DUPLICATES extra items at each end; when the user
+ *   lands on a duplicate the scroll position is silently snapped to the
+ *   matching real item (no animation), giving a seamless loop.
+ * - Exposes its current page/size to indicators via PagerContext using the
+ *   same registerPager/listenPager contract as Web. The "currentItem" reported
+ *   to indicators is always the real index in [0, items.length).
+ */
+export function DivPager({ componentContext }) {
+    const { genId } = useDivKitContext();
+    const pagerCtx = usePagerContextOptional();
+    const { json, variables } = componentContext;
+    const orientation = useDerivedFromVarsSimple(json.orientation || 'horizontal', variables || new Map());
+    const layoutMode = useDerivedFromVarsSimple(json.layout_mode, variables || new Map());
+    const itemSpacingObj = useDerivedFromVarsSimple(json.item_spacing, variables || new Map());
+    const paddings = useDerivedFromVarsSimple(json.paddings, variables || new Map());
+    const scrollAxisAlignment = useDerivedFromVarsSimple(json.scroll_axis_alignment || 'center', variables || new Map());
+    const defaultItem = useDerivedFromVarsSimple(typeof json.default_item === 'number' ? json.default_item : 0, variables || new Map());
+    const infiniteScroll = useDerivedFromVarsSimple(json.infinite_scroll, variables || new Map());
+    const isHorizontal = orientation !== 'vertical';
+    const itemSpacing = itemSpacingObj?.value ?? 0;
+    const items = useMemo(() => {
+        return Array.isArray(json.items) ? json.items : [];
+    }, [json.items]);
+    const isInfinite = useMemo(() => isInfiniteEnabled(infiniteScroll, items.length), [infiniteScroll, items.length]);
+    // Pager paddings — applied on the inner ScrollView so we can also use them
+    // for snap math. Outer should NOT also apply them, so we strip them from
+    // the json passed into Outer below.
+    const innerPadStart = useMemo(() => {
+        const p = paddings || {};
+        if (isHorizontal) {
+            return Number(p.start ?? p.left ?? 0) || 0;
+        }
+        return Number(p.top ?? 0) || 0;
+    }, [paddings, isHorizontal]);
+    const innerPadEnd = useMemo(() => {
+        const p = paddings || {};
+        if (isHorizontal) {
+            return Number(p.end ?? p.right ?? 0) || 0;
+        }
+        return Number(p.bottom ?? 0) || 0;
+    }, [paddings, isHorizontal]);
+    const [containerSize, setContainerSize] = useState(0);
+    const scrollRef = useRef(null);
+    const currentItemRef = useRef(0); // real index, always in [0, items.length)
+    const initialScrollDone = useRef(false);
+    const registerDataRef = useRef(null);
+    const pagerInstId = useRef(genId('pager'));
+    const scrollToItemRef = useRef(null);
+    const pageSize = useMemo(() => computePageSize({
+        containerSize,
+        layoutMode,
+        scrollAxisAlignment: scrollAxisAlignment,
+        itemSpacing,
+        innerPadStart,
+        innerPadEnd
+    }), [containerSize, innerPadStart, innerPadEnd, layoutMode, scrollAxisAlignment, itemSpacing]);
+    const snapInterval = pageSize > 0 ? pageSize + itemSpacing : 0;
+    const contentPad = useMemo(() => computeContentPad({
+        containerSize,
+        pageSize,
+        innerPadStart,
+        innerPadEnd,
+        layoutMode,
+        scrollAxisAlignment: scrollAxisAlignment,
+        itemSpacing,
+        isInfinite
+    }), [
+        containerSize,
+        pageSize,
+        innerPadStart,
+        innerPadEnd,
+        layoutMode,
+        scrollAxisAlignment,
+        itemSpacing,
+        isInfinite
+    ]);
+    const realToPosition = useCallback((realIdx) => realToPositionFn(realIdx, isInfinite, DUPLICATES), [isInfinite]);
+    const positionToReal = useCallback((pos) => positionToRealFn(pos, isInfinite, items.length, DUPLICATES), [isInfinite, items.length]);
+    const isInDuplicateRegion = useCallback((pos) => isInDuplicateRegionFn(pos, isInfinite, items.length, DUPLICATES), [isInfinite, items.length]);
+    const runSelectedActions = useCallback((index) => {
+        const item = items[index];
+        const actions = item?.selected_actions;
+        if (Array.isArray(actions) && actions.length > 0) {
+            componentContext.execAnyActions(actions);
+        }
+    }, [items, componentContext]);
+    const pushPagerState = useCallback((item) => {
+        const reg = registerDataRef.current;
+        if (!reg)
+            return;
+        const data = {
+            instId: pagerInstId.current,
+            size: items.length,
+            currentItem: item,
+            scrollToPagerItem: (index) => scrollToItemRef.current?.(index, true)
+        };
+        reg.update(data);
+    }, [items.length]);
+    const scrollToItem = useCallback((realIndex, animated) => {
+        const node = scrollRef.current;
+        if (!node || snapInterval <= 0 || items.length === 0)
+            return;
+        const clampedReal = isInfinite
+            ? ((realIndex % items.length) + items.length) % items.length
+            : Math.max(0, Math.min(items.length - 1, realIndex));
+        const pos = realToPosition(clampedReal);
+        const offset = pos * snapInterval;
+        if (isHorizontal) {
+            node.scrollTo({ x: offset, y: 0, animated });
+        }
+        else {
+            node.scrollTo({ x: 0, y: offset, animated });
+        }
+        if (clampedReal !== currentItemRef.current) {
+            currentItemRef.current = clampedReal;
+            pushPagerState(clampedReal);
+            runSelectedActions(clampedReal);
+        }
+    }, [
+        items.length,
+        snapInterval,
+        isHorizontal,
+        isInfinite,
+        realToPosition,
+        pushPagerState,
+        runSelectedActions
+    ]);
+    useEffect(() => {
+        scrollToItemRef.current = scrollToItem;
+    }, [scrollToItem]);
+    // Register pager in context (so indicators can find it)
+    useEffect(() => {
+        if (!pagerCtx)
+            return;
+        const pagerId = json.id;
+        const reg = pagerCtx.registerPager(pagerId);
+        registerDataRef.current = reg;
+        pushPagerState(currentItemRef.current);
+        return () => {
+            reg.destroy();
+            registerDataRef.current = null;
+        };
+    }, [pagerCtx, json.id, pushPagerState]);
+    // Re-broadcast on items length / scrollToItem changes
+    useEffect(() => {
+        pushPagerState(currentItemRef.current);
+    }, [pushPagerState]);
+    // Initial scroll to default_item once we know page size
+    useEffect(() => {
+        if (initialScrollDone.current)
+            return;
+        if (snapInterval <= 0)
+            return;
+        const initial = Math.max(0, Math.min(items.length - 1, defaultItem ?? 0));
+        currentItemRef.current = initial;
+        const id = setTimeout(() => {
+            scrollToItem(initial, false);
+            initialScrollDone.current = true;
+            pushPagerState(initial);
+        }, 0);
+        return () => clearTimeout(id);
+    }, [snapInterval, defaultItem, items.length, scrollToItem, pushPagerState]);
+    const onScrollEnd = useCallback((event) => {
+        if (snapInterval <= 0)
+            return;
+        const { contentOffset } = event.nativeEvent;
+        const offset = isHorizontal ? contentOffset.x : contentOffset.y;
+        const pos = offsetToPosition(offset, snapInterval);
+        const realIdx = positionToReal(pos);
+        // In infinite mode: silently snap from a duplicate back to the
+        // matching real item without animation.
+        if (isInfinite && isInDuplicateRegion(pos)) {
+            const realPos = realToPosition(realIdx);
+            const node = scrollRef.current;
+            if (node) {
+                const realOffset = realPos * snapInterval;
+                if (isHorizontal) {
+                    node.scrollTo({ x: realOffset, y: 0, animated: false });
+                }
+                else {
+                    node.scrollTo({ x: 0, y: realOffset, animated: false });
+                }
+            }
+        }
+        if (realIdx !== currentItemRef.current) {
+            currentItemRef.current = realIdx;
+            pushPagerState(realIdx);
+            runSelectedActions(realIdx);
+        }
+    }, [
+        snapInterval,
+        isHorizontal,
+        positionToReal,
+        isInDuplicateRegion,
+        isInfinite,
+        realToPosition,
+        pushPagerState,
+        runSelectedActions
+    ]);
+    const onLayout = useCallback((e) => {
+        const size = isHorizontal ? e.nativeEvent.layout.width : e.nativeEvent.layout.height;
+        if (size && Math.abs(size - containerSize) > 0.5) {
+            setContainerSize(size);
+        }
+    }, [containerSize, isHorizontal]);
+    // Strip paddings from Outer — we apply them on the ScrollView ourselves.
+    const outerContext = useMemo(() => {
+        const restJson = { ...json };
+        delete restJson.paddings;
+        return { ...componentContext, json: restJson };
+    }, [componentContext, json]);
+    const renderedItems = useMemo(() => buildRenderedItems(items, isInfinite, DUPLICATES), [items, isInfinite]);
+    if (!json.layout_mode) {
+        componentContext.logError(wrapError(new Error('Empty "layout_mode" prop for div "pager"')));
+        return null;
+    }
+    const renderItems = () => {
+        if (!renderedItems.length || pageSize <= 0)
+            return null;
+        return renderedItems.map((entry, posIndex) => {
+            const childContext = componentContext.produceChildContext(entry.item, {
+                path: posIndex
+            });
+            const isLast = posIndex === renderedItems.length - 1;
+            const itemStyle = isHorizontal
+                ? { width: pageSize, marginRight: isLast ? 0 : itemSpacing }
+                : { height: pageSize, marginBottom: isLast ? 0 : itemSpacing };
+            return (<View key={entry.key} style={[styles.itemWrapper, itemStyle]}>
+                    <DivComponent componentContext={childContext}/>
+                </View>);
+        });
+    };
+    return (<Outer componentContext={outerContext}>
+            <View style={styles.fill} onLayout={onLayout}>
+                {pageSize > 0 ? (<ScrollView ref={scrollRef} horizontal={isHorizontal} showsHorizontalScrollIndicator={false} showsVerticalScrollIndicator={false} decelerationRate="fast" snapToInterval={snapInterval} snapToAlignment="start" disableIntervalMomentum onMomentumScrollEnd={onScrollEnd} onScrollEndDrag={onScrollEnd} scrollEventThrottle={16} contentContainerStyle={isHorizontal
+                ? { paddingLeft: contentPad.start, paddingRight: contentPad.end }
+                : { paddingTop: contentPad.start, paddingBottom: contentPad.end }} style={styles.fill}>
+                        {renderItems()}
+                    </ScrollView>) : null}
+            </View>
+        </Outer>);
+}
+const styles = StyleSheet.create({
+    fill: {
+        flex: 1,
+        alignSelf: 'stretch'
+    },
+    itemWrapper: {
+        overflow: 'hidden'
+    }
+});
+//# sourceMappingURL=DivPager.js.map

package/dist/components/pager/DivPager.js.map

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

package/dist/components/pager/index.d.ts

@@ -0,0 +1,3 @@
+export { DivPager } from './DivPager';
+export type { DivPagerProps } from './DivPager';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/pager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/pager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/pager/index.js

@@ -0,0 +1,2 @@
+export { DivPager } from './DivPager';
+//# sourceMappingURL=index.js.map

package/dist/components/pager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/pager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/pager/utils.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Pure helpers for DivPager. Extracted so they can be unit-tested without
+ * having to render the React tree.
+ */
+export type ScrollAxisAlignment = 'start' | 'center' | 'end';
+export interface LayoutModeFixed {
+    type: 'fixed';
+    neighbour_page_width?: {
+        value?: number;
+    };
+}
+export interface LayoutModePercentage {
+    type: 'percentage';
+    page_width?: {
+        value?: number;
+    };
+}
+export interface LayoutModeWrap {
+    type: 'wrap_content';
+}
+export type AnyLayoutMode = LayoutModeFixed | LayoutModePercentage | LayoutModeWrap | {
+    type?: string;
+    [k: string]: unknown;
+} | null | undefined;
+export interface ComputePageSizeArgs {
+    containerSize: number;
+    layoutMode: AnyLayoutMode;
+    scrollAxisAlignment: ScrollAxisAlignment;
+    itemSpacing: number;
+    innerPadStart: number;
+    innerPadEnd: number;
+}
+/**
+ * Compute the size of a single page along the main axis. Mirrors the Web
+ * Pager.svelte autoSizeVal calculation:
+ * - fixed + center: containerSize − 2·neighbour − 2·spacing
+ * - fixed + start/end: containerSize − neighbour − spacing
+ * - percentage: containerSize · page_width / 100
+ * - wrap_content / unknown: usable area (containerSize − paddings)
+ */
+export declare function computePageSize(args: ComputePageSizeArgs): number;
+export interface ComputeContentPadArgs extends ComputePageSizeArgs {
+    pageSize: number;
+    isInfinite: boolean;
+}
+/**
+ * Compute the contentContainer paddings the inner ScrollView needs so that the
+ * first/last items snap to the right visual position (centre/start/end). In
+ * infinite mode the duplicates take that role and we use zero padding.
+ */
+export declare function computeContentPad(args: ComputeContentPadArgs): {
+    start: number;
+    end: number;
+};
+export declare const DUPLICATES_IN_INFINITE = 2;
+/**
+ * Map a "real" item index (0..size-1) to its rendered position.
+ * In infinite mode the real items live in [DUPLICATES, DUPLICATES + size).
+ */
+export declare function realToPosition(realIdx: number, isInfinite: boolean, duplicates?: number): number;
+/**
+ * Map a rendered position back to the real index. Wraps modulo `size` when
+ * the position lands inside the duplicate region.
+ */
+export declare function positionToReal(pos: number, isInfinite: boolean, size: number, duplicates?: number): number;
+/**
+ * True when `pos` corresponds to one of the duplicate entries (only meaningful
+ * in infinite mode).
+ */
+export declare function isInDuplicateRegion(pos: number, isInfinite: boolean, size: number, duplicates?: number): boolean;
+export interface RenderedItemEntry<T> {
+    item: T;
+    realIndex: number;
+    key: string;
+}
+/**
+ * Build the list of items to render. In infinite mode this prefixes the array
+ * with `duplicates` copies of the last items and suffixes it with `duplicates`
+ * copies of the first items, so the user can swipe past either edge and land
+ * on something visually identical to the wrap-around target.
+ */
+export declare function buildRenderedItems<T extends {
+    id?: string;
+}>(items: T[], isInfinite: boolean, duplicates?: number): RenderedItemEntry<T>[];
+/**
+ * Decide whether infinite_scroll should actually be active.
+ * Mirrors Web's correctBooleanInt + the `items.length >= DUPLICATES_IN_INFINITE`
+ * gate.
+ */
+export declare function isInfiniteEnabled(infiniteValue: unknown, itemsLength: number): boolean;
+/**
+ * Convert a scroll offset (in px) into a snap position (rounded). Returns 0
+ * when snapInterval <= 0.
+ */
+export declare function offsetToPosition(offset: number, snapInterval: number): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/components/pager/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/components/pager/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AACD,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AACD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,cAAc,CAAC;CACxB;AACD,MAAM,MAAM,aAAa,GACnB,eAAe,GACf,oBAAoB,GACpB,cAAc,GACd;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACvC,IAAI,GACJ,SAAS,CAAC;AAEhB,MAAM,WAAW,mBAAmB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,aAAa,CAAC;IAC1B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAoBjE;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAiC7F;AAED,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,SAAyB,GAAG,MAAM,CAEhH;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,SAAyB,GACpC,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,SAAyB,GACpC,OAAO,CAGT;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACxD,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,OAAO,EACnB,UAAU,SAAyB,GACpC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAsBxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAOtF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG7E"}

package/dist/components/pager/utils.js

@@ -0,0 +1,142 @@
+/**
+ * Pure helpers for DivPager. Extracted so they can be unit-tested without
+ * having to render the React tree.
+ */
+/**
+ * Compute the size of a single page along the main axis. Mirrors the Web
+ * Pager.svelte autoSizeVal calculation:
+ * - fixed + center: containerSize − 2·neighbour − 2·spacing
+ * - fixed + start/end: containerSize − neighbour − spacing
+ * - percentage: containerSize · page_width / 100
+ * - wrap_content / unknown: usable area (containerSize − paddings)
+ */
+export function computePageSize(args) {
+    const { containerSize, layoutMode, scrollAxisAlignment, itemSpacing, innerPadStart, innerPadEnd } = args;
+    if (containerSize <= 0)
+        return 0;
+    const usable = containerSize - innerPadStart - innerPadEnd;
+    const lm = layoutMode;
+    if (lm && lm.type === 'fixed') {
+        const neighbourW = lm.neighbour_page_width?.value ?? 0;
+        if (scrollAxisAlignment === 'center') {
+            return Math.max(0, containerSize - 2 * neighbourW - 2 * itemSpacing);
+        }
+        return Math.max(0, containerSize - neighbourW - itemSpacing);
+    }
+    if (lm && lm.type === 'percentage') {
+        const pageW = lm.page_width?.value ?? 100;
+        return Math.max(0, (containerSize * pageW) / 100);
+    }
+    return Math.max(0, usable);
+}
+/**
+ * Compute the contentContainer paddings the inner ScrollView needs so that the
+ * first/last items snap to the right visual position (centre/start/end). In
+ * infinite mode the duplicates take that role and we use zero padding.
+ */
+export function computeContentPad(args) {
+    const { containerSize, pageSize, innerPadStart, innerPadEnd, layoutMode, scrollAxisAlignment, itemSpacing, isInfinite } = args;
+    if (containerSize <= 0 || pageSize <= 0) {
+        return { start: innerPadStart, end: innerPadEnd };
+    }
+    if (isInfinite) {
+        return { start: 0, end: 0 };
+    }
+    const lm = layoutMode;
+    if (lm && lm.type === 'fixed') {
+        const neighbourW = lm.neighbour_page_width?.value ?? 0;
+        if (scrollAxisAlignment === 'center') {
+            const pad = neighbourW + itemSpacing;
+            return { start: pad, end: pad };
+        }
+        if (scrollAxisAlignment === 'start') {
+            return { start: innerPadStart, end: neighbourW + itemSpacing + innerPadEnd };
+        }
+        if (scrollAxisAlignment === 'end') {
+            return { start: neighbourW + itemSpacing + innerPadStart, end: innerPadEnd };
+        }
+    }
+    return { start: innerPadStart, end: innerPadEnd };
+}
+export const DUPLICATES_IN_INFINITE = 2;
+/**
+ * Map a "real" item index (0..size-1) to its rendered position.
+ * In infinite mode the real items live in [DUPLICATES, DUPLICATES + size).
+ */
+export function realToPosition(realIdx, isInfinite, duplicates = DUPLICATES_IN_INFINITE) {
+    return isInfinite ? duplicates + realIdx : realIdx;
+}
+/**
+ * Map a rendered position back to the real index. Wraps modulo `size` when
+ * the position lands inside the duplicate region.
+ */
+export function positionToReal(pos, isInfinite, size, duplicates = DUPLICATES_IN_INFINITE) {
+    if (size <= 0)
+        return 0;
+    if (!isInfinite) {
+        return Math.max(0, Math.min(size - 1, pos));
+    }
+    const inner = pos - duplicates;
+    return ((inner % size) + size) % size;
+}
+/**
+ * True when `pos` corresponds to one of the duplicate entries (only meaningful
+ * in infinite mode).
+ */
+export function isInDuplicateRegion(pos, isInfinite, size, duplicates = DUPLICATES_IN_INFINITE) {
+    if (!isInfinite)
+        return false;
+    return pos < duplicates || pos >= duplicates + size;
+}
+/**
+ * Build the list of items to render. In infinite mode this prefixes the array
+ * with `duplicates` copies of the last items and suffixes it with `duplicates`
+ * copies of the first items, so the user can swipe past either edge and land
+ * on something visually identical to the wrap-around target.
+ */
+export function buildRenderedItems(items, isInfinite, duplicates = DUPLICATES_IN_INFINITE) {
+    if (!items.length)
+        return [];
+    if (!isInfinite) {
+        return items.map((item, index) => ({ item, realIndex: index, key: `r-${index}` }));
+    }
+    const size = items.length;
+    const head = [];
+    const tail = [];
+    for (let i = 0; i < duplicates; i++) {
+        const realIdx = (size - duplicates + i + size) % size;
+        head.push({ item: items[realIdx], realIndex: realIdx, key: `dup-h-${i}` });
+    }
+    for (let i = 0; i < duplicates; i++) {
+        const realIdx = i % size;
+        tail.push({ item: items[realIdx], realIndex: realIdx, key: `dup-t-${i}` });
+    }
+    const real = items.map((item, index) => ({
+        item,
+        realIndex: index,
+        key: `r-${index}`
+    }));
+    return [...head, ...real, ...tail];
+}
+/**
+ * Decide whether infinite_scroll should actually be active.
+ * Mirrors Web's correctBooleanInt + the `items.length >= DUPLICATES_IN_INFINITE`
+ * gate.
+ */
+export function isInfiniteEnabled(infiniteValue, itemsLength) {
+    const truthy = infiniteValue === true ||
+        infiniteValue === 1 ||
+        infiniteValue === '1' ||
+        infiniteValue === 'true';
+    return truthy && itemsLength >= DUPLICATES_IN_INFINITE;
+}
+/**
+ * Convert a scroll offset (in px) into a snap position (rounded). Returns 0
+ * when snapInterval <= 0.
+ */
+export function offsetToPosition(offset, snapInterval) {
+    if (snapInterval <= 0)
+        return 0;
+    return Math.round(offset / snapInterval);
+}
+//# sourceMappingURL=utils.js.map

package/dist/components/pager/utils.js.map

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

package/dist/components/utilities/Outer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Outer.d.ts","sourceRoot":"","sources":["../../../src/components/utilities/Outer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAgC,MAAM,OAAO,CAAC;AACvE,OAAO,EAA6B,SAAS,EAAsC,MAAM,cAAc,CAAC;AACxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAqGpD,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC3D,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACvD,gBAAgB,EAChB,QAAQ,EACR,KAAK,EAAE,WAAW,EACrB,EAAE,UAAU,CAAC,CAAC,CAAC,4BAuaf"}
+{"version":3,"file":"Outer.d.ts","sourceRoot":"","sources":["../../../src/components/utilities/Outer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAgC,MAAM,OAAO,CAAC;AACvE,OAAO,EAA6B,SAAS,EAAsC,MAAM,cAAc,CAAC;AACxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAqGpD,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC3D,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACvD,gBAAgB,EAChB,QAAQ,EACR,KAAK,EAAE,WAAW,EACrB,EAAE,UAAU,CAAC,CAAC,CAAC,4BAyaf"}

package/dist/components/utilities/Outer.js

@@ -85,6 +85,7 @@ export function Outer({ componentContext, children, style: customStyle }) {
     const { direction } = useDivKitContext();
     const layoutParams = useLayoutParams();
     const { json, variables } = componentContext;
+    const testID = json.id;
     // Only use reactive hooks for truly dynamic properties (visibility, alpha)
     const visibility = useDerivedFromVarsSimple(json.visibility || 'visible', variables || new Map());
     const alpha = useDerivedFromVarsSimple(json.alpha !== undefined ? json.alpha : 1, variables || new Map());
@@ -469,19 +470,19 @@ export function Outer({ componentContext, children, style: customStyle }) {
                 const existingTransform = animatedStyle.transform || [];
                 animatedStyle.transform = [...existingTransform, { scale: animScale }];
             }
-            return (<Pressable onPress={handlePress} onPressIn={onPressIn} onPressOut={onPressOut} style={outerStyle}>
+            return (<Pressable onPress={handlePress} onPressIn={onPressIn} onPressOut={onPressOut} style={outerStyle} testID={testID}>
                     <Animated.View style={animatedStyle}>
                         <Background layers={background} style={borderStyle}/>
                         {children}
                     </Animated.View>
                 </Pressable>);
         }
-        return (<Pressable onPress={handlePress} style={finalStyle}>
+        return (<Pressable onPress={handlePress} style={finalStyle} testID={testID}>
                 <Background layers={background} style={borderStyle}/>
                 {children}
             </Pressable>);
     }
-    return (<View style={finalStyle}>
+    return (<View style={finalStyle} testID={testID}>
             <Background layers={background} style={borderStyle}/>
             {children}
         </View>);