@legendapp/list 2.0.0-next.2 → 2.0.0-next.4

package/{dist → integrations}/animated.d.mts

@@ -56,7 +56,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     recycleItems?: boolean;
     refScrollView?: React.Ref<react_native.ScrollView>;
     refreshing?: boolean;
-    renderItem?: React$1.ComponentType<_legendapp_list.LegendListRenderItemProps<T>> | ((props: _legendapp_list.LegendListRenderItemProps<T>) => React$1.ReactNode) | undefined;
+    renderItem?: ((props: _legendapp_list.LegendListRenderItemProps<T>) => React$1.ReactNode) | React$1.ComponentType<_legendapp_list.LegendListRenderItemProps<T>> | undefined;
     renderScrollComponent?: (props: react_native.ScrollViewProps) => React.ReactElement<react_native.ScrollViewProps>;
     suggestEstimatedItemSize?: boolean;
     viewabilityConfig?: _legendapp_list.ViewabilityConfig;
@@ -65,6 +65,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<_legendapp_list.LegendListRef>) => React.ReactNode)>;
 
 export { AnimatedLegendList };

package/{dist → integrations}/animated.d.ts

@@ -56,7 +56,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     recycleItems?: boolean;
     refScrollView?: React.Ref<react_native.ScrollView>;
     refreshing?: boolean;
-    renderItem?: React$1.ComponentType<_legendapp_list.LegendListRenderItemProps<T>> | ((props: _legendapp_list.LegendListRenderItemProps<T>) => React$1.ReactNode) | undefined;
+    renderItem?: ((props: _legendapp_list.LegendListRenderItemProps<T>) => React$1.ReactNode) | React$1.ComponentType<_legendapp_list.LegendListRenderItemProps<T>> | undefined;
     renderScrollComponent?: (props: react_native.ScrollViewProps) => React.ReactElement<react_native.ScrollViewProps>;
     suggestEstimatedItemSize?: boolean;
     viewabilityConfig?: _legendapp_list.ViewabilityConfig;
@@ -65,6 +65,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<_legendapp_list.LegendListRef>) => React.ReactNode)>;
 
 export { AnimatedLegendList };

package/{dist → integrations}/animated.js

@@ -1,9 +1,9 @@
 'use strict';
 
-var list = require('@legendapp/list');
 var reactNative = require('react-native');
+var list = require('@legendapp/list');
 
-// src/animated.tsx
+// src/integrations/animated.tsx
 var AnimatedLegendList = reactNative.Animated.createAnimatedComponent(list.LegendList);
 
 exports.AnimatedLegendList = AnimatedLegendList;

package/{dist → integrations}/animated.mjs

@@ -1,7 +1,7 @@
-import { LegendList } from '@legendapp/list';
 import { Animated } from 'react-native';
+import { LegendList } from '@legendapp/list';
 
-// src/animated.tsx
+// src/integrations/animated.tsx
 var AnimatedLegendList = Animated.createAnimatedComponent(LegendList);
 
 export { AnimatedLegendList };

package/{dist → integrations}/keyboard-controller.d.mts

@@ -66,6 +66,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -128,6 +129,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React.Ref<LegendListRef>;
 }) => React.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -192,6 +194,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -254,6 +257,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & {
     LegendList?: ListT;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode;

package/{dist → integrations}/keyboard-controller.d.ts

@@ -66,6 +66,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -128,6 +129,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React.Ref<LegendListRef>;
 }) => React.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -192,6 +194,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -254,6 +257,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & {
     LegendList?: ListT;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode;

package/{dist → integrations}/keyboard-controller.js

@@ -1,10 +1,10 @@
 'use strict';
 
-var list = require('@legendapp/list');
 var React = require('react');
 var reactNative = require('react-native');
 var reactNativeKeyboardController = require('react-native-keyboard-controller');
 var reactNativeReanimated = require('react-native-reanimated');
+var list = require('@legendapp/list');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -26,7 +26,7 @@ function _interopNamespace(e) {
 
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
-// src/keyboard-controller.tsx
+// src/integrations/keyboard-controller.tsx
 var typedForwardRef = React.forwardRef;
 var LegendList = typedForwardRef(function LegendList2(props, forwardedRef) {
   const {
@@ -59,8 +59,8 @@ var LegendList = typedForwardRef(function LegendList2(props, forwardedRef) {
       {
         ...rest,
         contentContainerStyle,
-        scrollIndicatorInsets,
-        ref: forwardedRef
+        ref: forwardedRef,
+        scrollIndicatorInsets
       }
     )
   );

package/{dist → integrations}/keyboard-controller.mjs

@@ -1,11 +1,11 @@
-import { LegendList as LegendList$1 } from '@legendapp/list';
 import * as React from 'react';
 import { useState, forwardRef } from 'react';
 import { StyleSheet } from 'react-native';
 import { useKeyboardHandler } from 'react-native-keyboard-controller';
 import { runOnJS } from 'react-native-reanimated';
+import { LegendList as LegendList$1 } from '@legendapp/list';
 
-// src/keyboard-controller.tsx
+// src/integrations/keyboard-controller.tsx
 var typedForwardRef = forwardRef;
 var LegendList = typedForwardRef(function LegendList2(props, forwardedRef) {
   const {
@@ -38,8 +38,8 @@ var LegendList = typedForwardRef(function LegendList2(props, forwardedRef) {
       {
         ...rest,
         contentContainerStyle,
-        scrollIndicatorInsets,
-        ref: forwardedRef
+        ref: forwardedRef,
+        scrollIndicatorInsets
       }
     )
   );

package/{dist → integrations}/reanimated.js

@@ -1,22 +1,22 @@
 'use strict';
 
-var list = require('@legendapp/list');
 var React = require('react');
 var Animated = require('react-native-reanimated');
+var list = require('@legendapp/list');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var React__default = /*#__PURE__*/_interopDefault(React);
 var Animated__default = /*#__PURE__*/_interopDefault(Animated);
 
-// src/reanimated.tsx
+// src/integrations/reanimated.tsx
 
-// src/helpers.ts
+// src/utils/helpers.ts
 function isFunction(obj) {
   return typeof obj === "function";
 }
 
-// src/useCombinedRef.ts
+// src/hooks/useCombinedRef.ts
 var useCombinedRef = (...refs) => {
   const callback = React.useCallback((element) => {
     for (const ref of refs) {
@@ -33,16 +33,16 @@ var useCombinedRef = (...refs) => {
   return callback;
 };
 
-// src/reanimated.tsx
+// src/integrations/reanimated.tsx
 var LegendListForwardedRef = React__default.default.forwardRef(function LegendListForwardedRef2(props, ref) {
   const { refLegendList, ...rest } = props;
   return /* @__PURE__ */ React__default.default.createElement(
     list.LegendList,
     {
-      refScrollView: ref,
       ref: (r) => {
         refLegendList(r);
       },
+      refScrollView: ref,
       ...rest
     }
   );
@@ -52,7 +52,7 @@ var AnimatedLegendList = React__default.default.forwardRef(function AnimatedLege
   const { refScrollView, ...rest } = props;
   const refLegendList = React__default.default.useRef(null);
   const combinedRef = useCombinedRef(refLegendList, ref);
-  return /* @__PURE__ */ React__default.default.createElement(AnimatedLegendListComponent, { refLegendList: combinedRef, ref: refScrollView, ...rest });
+  return /* @__PURE__ */ React__default.default.createElement(AnimatedLegendListComponent, { ref: refScrollView, refLegendList: combinedRef, ...rest });
 });
 
 exports.AnimatedLegendList = AnimatedLegendList;

package/{dist → integrations}/reanimated.mjs

@@ -1,15 +1,15 @@
-import { LegendList } from '@legendapp/list';
 import React, { useCallback } from 'react';
 import Animated from 'react-native-reanimated';
+import { LegendList } from '@legendapp/list';
 
-// src/reanimated.tsx
+// src/integrations/reanimated.tsx
 
-// src/helpers.ts
+// src/utils/helpers.ts
 function isFunction(obj) {
   return typeof obj === "function";
 }
 
-// src/useCombinedRef.ts
+// src/hooks/useCombinedRef.ts
 var useCombinedRef = (...refs) => {
   const callback = useCallback((element) => {
     for (const ref of refs) {
@@ -26,16 +26,16 @@ var useCombinedRef = (...refs) => {
   return callback;
 };
 
-// src/reanimated.tsx
+// src/integrations/reanimated.tsx
 var LegendListForwardedRef = React.forwardRef(function LegendListForwardedRef2(props, ref) {
   const { refLegendList, ...rest } = props;
   return /* @__PURE__ */ React.createElement(
     LegendList,
     {
-      refScrollView: ref,
       ref: (r) => {
         refLegendList(r);
       },
+      refScrollView: ref,
       ...rest
     }
   );
@@ -45,7 +45,7 @@ var AnimatedLegendList = React.forwardRef(function AnimatedLegendList2(props, re
   const { refScrollView, ...rest } = props;
   const refLegendList = React.useRef(null);
   const combinedRef = useCombinedRef(refLegendList, ref);
-  return /* @__PURE__ */ React.createElement(AnimatedLegendListComponent, { refLegendList: combinedRef, ref: refScrollView, ...rest });
+  return /* @__PURE__ */ React.createElement(AnimatedLegendListComponent, { ref: refScrollView, refLegendList: combinedRef, ...rest });
 });
 
 export { AnimatedLegendList };

package/package.json

@@ -1,89 +1,35 @@
 {
-    "name": "@legendapp/list",
-    "version": "2.0.0-next.2",
-    "description": "Legend List is a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
-    "sideEffects": false,
-    "private": false,
-    "main": "./index.js",
-    "module": "./index.mjs",
-    "types": "./index.d.ts",
-    "files": [
-        "**"
-    ],
-    "exports": {
-        "./package.json": "./package.json",
-        ".": {
-            "types": "./index.d.ts",
-            "import": "./index.mjs",
-            "require": "./index.js"
-        },
-        "./animated": {
-            "types": "./animated.d.ts",
-            "import": "./animated.mjs",
-            "require": "./animated.js"
-        },
-        "./reanimated": {
-            "types": "./reanimated.d.ts",
-            "import": "./reanimated.mjs",
-            "require": "./reanimated.js"
-        },
-        "./keyboard-controller": {
-            "types": "./keyboard-controller.d.ts",
-            "import": "./keyboard-controller.mjs",
-            "require": "./keyboard-controller.js"
-        }
-    },
-    "engines": {
-        "node": ">=16.6.0",
-        "npm": ">=8.11.0"
-    },
-    "scripts": {
-        "build": "tsup && bun run posttsup.ts",
-        "publish": "bun run build && cd dist && npm publish",
-        "publish:next": "bun run build && cd dist && npm publish --tag next",
-        "publish:beta": "bun run build && cd dist && npm publish --tag beta",
-        "lint": "bunx biome check ./src && bunx biome format ./src && bun run lint:example",
-        "lint:example": "bunx biome check ./example/app && bunx biome format ./example/app",
-        "lint:fix": "bunx biome lint --write ./src && bunx biome format --write ./src && bunx biome check --write ./src && bun run lint:fix:example",
-        "lint:fix:example": "bunx biome lint --write ./example/app && bunx biome format --write ./example/app && bunx biome check --write ./example/app"
-    },
-    "peerDependencies": {
-        "react": "*",
-        "react-native": "*"
-    },
-    "devDependencies": {
-        "@biomejs/biome": "^1.9.4",
-        "@types/bun": "^1.1.13",
-        "@types/react": "^18.3.12",
-        "@types/use-sync-external-store": "^1.5.0",
-        "react": "^18.3.1",
-        "react-native": "^0.76.2",
-        "react-native-keyboard-controller": "^1.17.0",
-        "react-native-reanimated": "^3.16.6",
-        "tsup": "^8.3.5",
-        "typescript": "^5.8.3"
-    },
-    "author": "Legend <contact@legendapp.com> (https://github.com/LegendApp)",
-    "keywords": [
-        "react",
-        "react-native",
-        "list"
-    ],
-    "repository": "github:LegendApp/legend-list",
-    "license": "MIT",
-    "bugs": {
-        "url": "https://github.com/LegendApp/legend-list/issues"
-    },
-    "homepage": "https://github.com/LegendApp/legend-list#readme",
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/"
-    },
-    "commitlint": {
-        "extends": [
-            "@commitlint/config-conventional"
-        ]
-    },
-    "dependencies": {
-        "use-sync-external-store": "^1.5.0"
-    }
-}
+  "name": "@legendapp/list",
+  "version": "2.0.0-next.4",
+  "description": "Legend List is a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
+  "sideEffects": false,
+  "private": false,
+  "main": "./index.js",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "files": [
+    "**"
+  ],
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "author": "Legend <contact@legendapp.com> (https://github.com/LegendApp)",
+  "keywords": [
+    "react",
+    "react-native",
+    "list"
+  ],
+  "repository": "github:LegendApp/legend-list",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/LegendApp/legend-list/issues"
+  },
+  "homepage": "https://github.com/LegendApp/legend-list#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "use-sync-external-store": "^1.5.0"
+  }
+}

package/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(bun run:*)"
-    ],
-    "deny": []
-  }
-}

package/.cursor/rules/changelog.mdc

@@ -1,60 +0,0 @@
----
-description:
-globs: CHANGELOG.md
-alwaysApply: false
----
-# Changelog Update Rules
-
-## Process for Adding Git Changes to Changelog
-
-When updating the changelog with recent git commits, follow these guidelines:
-
-### 1. Identify Relevant Commits
-- Get all commits since the last version using: `git log --oneline --since="$(git log --grep="X.X.X" --format="%cd" --date=iso | head -1)" --reverse`
-- Exclude non-user-facing commits like:
-  - "Update changelog"
-  - "chore:" commits
-  - Internal refactoring that doesn't affect API
-  - "Refactor*" commits
-
-### 2. Categorize Changes
-Organize changes by type with these prefixes, in this order:
-- **Feat:** New features and capabilities
-- **Fix:** Bug fixes and corrections
-- **Perf:** Performance improvements
-- **Improvement:** Enhancements to existing functionality
-
-Skip **Refactor:**, they don't need to be in the changelog
-
-### 3. Format Guidelines
-- Write user-friendly descriptions, not raw commit messages
-- Focus on the impact/benefit to users
-- Be concise but descriptive
-- Use present tense ("Fix X" not "Fixed X")
-- Group similar changes together when possible
-
-### 4. Version Organization
-- Add changes to the current version in package.json
-- If significant changes warrant a new version, bump version first
-- List most important changes (breaking changes, major features) first
-- Group fixes and minor improvements at the end
-
-### 5. Example Format
-```markdown
-## X.X.X
-- Fix: [Issue description and impact]
-- Fix: [Another bug fix]
-- Feat: [New feature description]
-- Refactor: [API change description]
-- Perf: [Performance improvement description]
-- Improvement: [Enhancement description]
-```
-
-### 6. Quality Check
-- Ensure all user-facing changes are documented
-- Verify technical accuracy of descriptions
-- Check that breaking changes are clearly marked
-- Review for consistency in tone and format
-
-### 7. Update package version
-If a specific version number is requested and it is newer than the version in package.json, update package.json

package/.github/FUNDING.yml

@@ -1,15 +0,0 @@
-# These are supported funding model platforms
-
-github: [jmeistrich]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
-polar: # Replace with a single Polar username
-buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
-thanks_dev: # Replace with a single thanks.dev username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

package/.gitignore

@@ -1,5 +0,0 @@
-node_modules
-dist
-example/android
-example/ios
-legendapp-list.tgz

package/.prettierrc.json

@@ -1,5 +0,0 @@
-{
-    "tabWidth": 4,
-    "printWidth": 120,
-    "singleQuote": true
-}

package/.vscode/settings.json

@@ -1,14 +0,0 @@
-{
-    "editor.codeActionsOnSave": {
-        "source.organizeImports.biome": "explicit",
-        "quickfix.biome": "explicit"
-    },
-    "editor.defaultFormatter": "biomejs.biome",
-    "[typescriptreact]": {
-        "editor.defaultFormatter": "biomejs.biome"
-    },
-    "[typescript]": {
-        "editor.defaultFormatter": "biomejs.biome"
-    },
-    "editor.formatOnSave": true
-}

package/CLAUDE.md

@@ -1,126 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Development Commands
-
-### Build and Development
-- `bun run build` - Build the package using tsup and run post-build script
-- `bun run publish:manual` - Build and publish to npm manually
-- `bun run lint` - Check code formatting with Biome for src and example
-- `bun run lint:fix` - Auto-fix formatting issues with Biome for src and example
-
-### Example App Development
-The repository includes a React Native example app in the `example/` directory:
-- `cd example && bun i && bun run ios` - Run the example app on iOS
-- Example app uses Expo and demonstrates various Legend List features
-
-### Build Process
-- Uses tsup for TypeScript compilation with multiple entry points:
-  - `src/index.ts` (main export)
-  - `src/animated.tsx` (animated variant)
-  - `src/reanimated.tsx` (reanimated variant)
-  - `src/keyboard-controller.tsx` (keyboard integration)
-- Post-build script (`posttsup.ts`) copies LICENSE, CHANGELOG.md, README.md to dist and modifies package.json for publishing
-- Builds to both CommonJS and ESM formats with TypeScript declarations
-
-## Architecture Overview
-
-Legend List is a high-performance React Native list component designed as a drop-in replacement for FlatList with better performance, especially for dynamically sized items.
-
-### Core Components
-
-**LegendList** (`src/LegendList.tsx`): Main component that wraps functionality in a StateProvider
-- Handles virtualization logic, scroll management, and item positioning
-- Manages anchor elements for `maintainVisibleContentPosition`
-- Implements advanced scroll adjustment and jump prevention
-- Uses container recycling for optimal performance
-
-**State Management** (`src/state.tsx`): Global state management using observable patterns
-- Manages container positions, item data, and scroll state
-- Provides reactive updates to child components
-
-**Container System** (`src/Container.tsx`, `src/Containers.tsx`): Manages item rendering containers
-- Implements container recycling when `recycleItems` is enabled
-- Handles absolute positioning of list items
-- Manages container allocation and deallocation
-
-**Scroll Adjustment** (`src/ScrollAdjustHandler.ts`): Handles complex scroll position adjustments
-- Prevents scroll jumps when items are added/removed
-- Manages scroll position during layout changes
-
-### Key Features Architecture
-
-**Dynamic Item Sizing**: Items can have varying heights without performance penalties
-- Uses `getEstimatedItemSize` or `estimatedItemSize` for initial estimates
-- Measures actual sizes on layout and adjusts total size calculations
-- Maintains position accuracy through size change events
-
-**Bidirectional Infinite Lists**: Supports infinite scrolling in both directions
-- `onStartReached` and `onEndReached` callbacks with configurable thresholds
-- Maintains scroll position when items are added to the beginning
-
-**Chat UI Support**: 
-- `alignItemsAtEnd` aligns content to bottom for chat interfaces
-- `maintainScrollAtEnd` automatically scrolls to end when new items are added
-- Avoids need for inverted lists which cause animation issues
-
-**Column Support**: Multi-column layouts via `numColumns` prop
-- Manages row heights when items have different sizes within the same row
-- Handles column-aware positioning and gap calculations via `columnWrapperStyle`
-
-### Performance Optimizations
-
-**Virtualization**: Only renders items in the visible area plus buffer zones
-- `drawDistance` controls how far ahead/behind to render items
-- Dynamic buffer adjustment based on scroll velocity
-- Container recycling to minimize React element creation/destruction
-
-**Scroll Jump Prevention**: Sophisticated system to prevent visual jumps
-- Anchor element tracking for `maintainVisibleContentPosition`
-- Scroll history tracking for velocity calculations
-- Position adjustment when item sizes change
-
-**Batched Updates**: Groups layout calculations to reduce renders
-- Uses `requestAnimationFrame` for batching size change calculations
-- Optimizes container position updates
-
-## Integration Patterns
-
-### Basic Usage
-Legend List is designed as a drop-in FlatList replacement:
-```typescript
-<LegendList
-  data={data}
-  renderItem={renderItem}
-  keyExtractor={(item) => item.id}
-  recycleItems={true}
-/>
-```
-
-### Optional Integrations
-- **Animated**: `@legendapp/list/animated` - Works with React Native Animated
-- **Reanimated**: `@legendapp/list/reanimated` - Works with React Native Reanimated
-- **Keyboard Controller**: `@legendapp/list/keyboard-controller` - Integrates with react-native-keyboard-controller
-
-### Viewability Tracking
-Supports advanced viewability detection:
-- Compatible with FlatList's `viewabilityConfig` and `onViewableItemsChanged`
-- Custom hooks available: `useViewability`, `useViewabilityAmount`
-
-## Important Development Notes
-
-- When working with container recycling (`recycleItems={true}`), be cautious about local state in item components
-- The `keyExtractor` is crucial for performance and correct behavior when data changes
-- Use `getEstimatedItemSize` for better performance with varying item sizes
-- The component uses advanced scroll position management that should not be interfered with directly
-
-## Configuration Files
-
-- **Biome** (`biome.json`): Used for linting and formatting with specific rules for the project
-- **TypeScript** (`tsconfig.json`): Configured for React Native with path mappings for internal imports
-- **Cursor Rules**: `.cursor/rules/changelog.mdc` contains guidelines for maintaining the changelog
-
-## Testing the Library
-
-To test changes, use the comprehensive example app which demonstrates various scenarios including dynamic sizing, infinite loading, chat interfaces, and performance comparisons with FlatList.