@leonsilicon/react-native-reanimated-carousel 0.0.0

package/lib/typescript/utils/size-resolver.d.ts

@@ -0,0 +1,87 @@
+import type { SharedValue } from "react-native-reanimated";
+/**
+ * Worklet-safe abstraction over per-item sizes. Lets every position-math site
+ * read `offsetAt(i)` / `indexAt(offset)` instead of multiplying by a scalar
+ * `size`. Two implementations:
+ *
+ * - Uniform: backed by a single scalar; O(1) for every operation.
+ * - Variable: backed by a prefix-sum SharedValue<number[]>; O(log n) for
+ *   `indexAt`, with a cached-hint fast path for sequential scrolls.
+ */
+export interface SizeResolver {
+    /**
+     * `true` when sizes vary per item (variable mode). UI-thread reads should be
+     * cheap — this flag lives outside SharedValues so worklets can branch on it.
+     */
+    readonly variable: boolean;
+    /** Total span across all items: sum of every item's size. */
+    readonly total: SharedValue<number>;
+    /** Number of items (must equal `prefix.length - 1` in variable mode). */
+    readonly count: SharedValue<number>;
+    /** Size of item at `index`. Worklet-safe. */
+    itemSize: (index: number) => number;
+    /** Start offset of item at `index` (sum of sizes of items [0, index)). Worklet-safe. */
+    offsetAt: (index: number) => number;
+    /** Index of the item that contains pixel `offset` from the start. Worklet-safe. */
+    indexAt: (offset: number) => number;
+    /** Center offset of item at `index`: `offsetAt(index) + itemSize(index) / 2`. Worklet-safe. */
+    midpointOf: (index: number) => number;
+}
+/**
+ * Binary search the prefix-sum array for the index `i` such that
+ * `prefix[i] <= target < prefix[i+1]`. Clamps to `[0, length-1]`.
+ *
+ * Worklet-callable. `prefix` should have `length === itemCount + 1` so that
+ * `prefix[itemCount]` equals the total span.
+ */
+export declare function binarySearchPrefix(prefix: number[], target: number): number;
+/**
+ * Cached-hint variant: checks `hint`, `hint+1`, `hint-1` before falling back to
+ * full binary search. The common case during a single gesture is that the
+ * answer either stays the same or moves by ±1, so this keeps amortized cost at
+ * O(1) for typical scroll patterns.
+ */
+export declare function binarySearchPrefixCached(prefix: number[], target: number, hint: number): number;
+/**
+ * Creates a resolver for the uniform-size case. The scalar `size` is read on
+ * every call so callers always get the latest value. The owner is responsible
+ * for keeping `total` in sync with `size * count` (typically via
+ * `useAnimatedReaction`).
+ *
+ * `size` may be `SharedValue<number | null>` — `null` is treated as 0, which
+ * lets callers pass `common.resolvedSize` directly without a cast.
+ */
+export declare function createUniformSizeResolver(opts: {
+    size: SharedValue<number | null> | SharedValue<number>;
+    count: SharedValue<number>;
+    total: SharedValue<number>;
+}): SizeResolver;
+/**
+ * Creates a resolver backed by a prefix-sum array. `prefix[i]` is the sum of
+ * sizes of items `[0, i)`, so `prefix[0] === 0` and `prefix[count] === total`.
+ * `sizes` is `[size(0), size(1), ..., size(count-1)]`.
+ *
+ * `hint` is an optional SharedValue used as the seed for `indexAt`'s cached
+ * binary search; passing the previous result keeps lookups O(1) during
+ * continuous scrolls.
+ */
+export declare function createVariableSizeResolver(opts: {
+    sizes: SharedValue<number[]>;
+    prefix: SharedValue<number[]>;
+    total: SharedValue<number>;
+    count: SharedValue<number>;
+    hint?: SharedValue<number>;
+}): SizeResolver;
+/**
+ * Builds a `(sizes, prefix, total)` tuple from a `getItemSize(index)` getter.
+ * JS-thread, O(n). Returns plain arrays — callers ferry them into SharedValues.
+ *
+ * Guards against non-finite or non-positive sizes by treating them as 0 so the
+ * carousel doesn't NaN-out. `usePropsErrorBoundary` warns the user separately.
+ */
+export declare function buildPrefixSum(count: number, getItemSize: (index: number) => number): {
+    sizes: number[];
+    prefix: number[];
+    total: number;
+};
+//# sourceMappingURL=size-resolver.d.ts.map

package/lib/typescript/utils/size-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-resolver.d.ts","sourceRoot":"","sources":["../../../src/utils/size-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,wFAAwF;IACxF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,mFAAmF;IACnF,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,+FAA+F;IAC/F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkB3E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAe/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACvD,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG,YAAY,CAiCf;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG,YAAY,CA8Cf;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAatD"}

package/package.json

@@ -0,0 +1,151 @@
+{
+	"name": "@leonsilicon/react-native-reanimated-carousel",
+	"version": "0.0.0",
+	"packageManager": "yarn@4.0.2",
+	"description": "Simple carousel component.fully implemented using Reanimated 2.Infinitely scrolling, very smooth.",
+	"author": "Doho <zhaodonghao586@outlook.com> (https://github.com/dohooo)",
+	"license": "MIT",
+	"homepage": "https://rn-carousel.dev/",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/dohooo/react-native-reanimated-carousel.git"
+	},
+	"bugs": {
+		"url": "https://github.com/dohooo/react-native-reanimated-carousel/issues"
+	},
+	"keywords": [
+		"react-native",
+		"ios",
+		"android"
+	],
+	"main": "lib/commonjs/index",
+	"module": "lib/module/index",
+	"react-native": "src/index.tsx",
+	"types": "lib/typescript/index.d.ts",
+	"source": "src/index",
+	"files": [
+		"lib",
+		"src"
+	],
+	"scripts": {
+		"gif": "node scripts/makegif.js ./scripts/gif-works-directory",
+		"test": "jest",
+		"test:watch": "jest --watch",
+		"test:coverage": "jest --coverage",
+		"test:ci": "jest --coverage --ci --runInBand --reporters=default --reporters=jest-junit",
+		"types": "tsc --noEmit",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"format": "biome format .",
+		"format:fix": "biome format --write .",
+		"dev": "watch 'yarn prepare' ./src",
+		"prepare": "bob build",
+		"clean": "del-cli lib",
+		"version": "changeset version",
+		"precommit": "yarn lint:fix && yarn format:fix",
+		"e2e": "APP_ID=${APP_ID:-com.react-native-reanimated-carousel.example} maestro test example/app/app/demos/",
+		"e2e:comprehensive": "APP_ID=${APP_ID:-com.react-native-reanimated-carousel.example} maestro test e2e/",
+		"changeset:check": "node scripts/check-changeset-style.mjs"
+	},
+	"resolutions": {
+		"@babel/plugin-transform-block-scoping": "7.28.4"
+	},
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/"
+	},
+	"peerDependencies": {
+		"react": ">=18.0.0",
+		"react-native": ">=0.80.0",
+		"react-native-gesture-handler": ">=2.9.0",
+		"react-native-reanimated": ">=4.0.0",
+		"react-native-worklets": ">=0.5.0"
+	},
+	"devDependencies": {
+		"@babel/core": "^7.28.4",
+		"@babel/plugin-proposal-class-properties": "^7.18.6",
+		"@babel/plugin-proposal-private-methods": "^7.18.6",
+		"@babel/plugin-syntax-dynamic-import": "^7.8.3",
+		"@babel/plugin-syntax-typescript": "^7.27.1",
+		"@babel/plugin-transform-block-scoping": "7.28.4",
+		"@babel/preset-typescript": "^7.27.1",
+		"@biomejs/biome": "^1.9.4",
+		"@changesets/changelog-github": "^0.5.0",
+		"@changesets/cli": "latest",
+		"@commitlint/config-conventional": "^11.0.0",
+		"@react-native/babel-preset": "0.81.1",
+		"@testing-library/jest-native": "^4.0.4",
+		"@testing-library/react-hooks": "^8.0.0",
+		"@testing-library/react-native": "^13.3.3",
+		"@types/jest": "^29.2.5",
+		"@types/react": "^19.1.10",
+		"@types/react-native": "^0.66.16",
+		"@types/react-test-renderer": "^19.1.0",
+		"babel-plugin-module-resolver": "^5.0.2",
+		"commitlint": "^11.0.0",
+		"cz-conventional-changelog": "^3.3.0",
+		"del-cli": "^5.0.0",
+		"gifify": "^2.4.3",
+		"husky": "^4.2.5",
+		"jest": "^29.3.1",
+		"jest-junit": "^16.0.0",
+		"pod-install": "^0.1.0",
+		"react": "19.1.0",
+		"react-dom": "19.1.0",
+		"react-native": "0.81.4",
+		"react-native-builder-bob": "0.39.1",
+		"react-native-gesture-handler": "~2.28.0",
+		"react-native-reanimated": "^4.1.0",
+		"react-native-web": "~0.19.10",
+		"react-native-worklets": "0.5.2",
+		"react-test-renderer": "19.1.0",
+		"sponsorkit": "^0.1.3",
+		"typescript": "^5.5.4",
+		"watch": "^1.0.2"
+	},
+	"husky": {
+		"hooks": {
+			"pre-commit": "yarn precommit",
+			"commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
+		}
+	},
+	"commitlint": {
+		"extends": [
+			"@commitlint/config-conventional"
+		],
+		"rules": {
+			"subject-case": [
+				0
+			],
+			"type-case": [
+				0
+			]
+		}
+	},
+	"react-native-builder-bob": {
+		"source": "src",
+		"output": "lib",
+		"targets": [
+			[
+				"commonjs",
+				{
+					"babelrc": false,
+					"configFile": "./babel.config.js"
+				}
+			],
+			[
+				"module",
+				{
+					"babelrc": false,
+					"configFile": "./babel.config.js"
+				}
+			],
+			"typescript"
+		],
+		"exclude": "**/*.test.{ts,tsx}"
+	},
+	"config": {
+		"commitizen": {
+			"path": "./node_modules/cz-conventional-changelog"
+		}
+	}
+}