doc: add doc on nbOfRenderedItems

docs/api.md

@@ -240,7 +240,7 @@ It also ensures that the scroll event is propagated properly to parent ScrollVie
 | `data`                             | `Array<T>`                                               | The array of data items to render. ⚠️ You should memoize this array for maximum performance. A costly memo depends on it.                                                                                                                                                                                                                                            |
 | `renderItem`                       | `(args: { item: T }) => JSX.Element`                     | A function that returns the JSX element to render for each item in the data array. The function receives an object with the item as a parameter.                                                                                                                                                                                                                    |
 | `itemSize`                         | `number \| ((item: T) => number)`                        | In case you specify a number it will behave like this : ff vertical, the height of an item; otherwise, the width. You can also specify a function which needs to return for each item of `data` its size in pixel in order for the list to handle various item sizes. ⚠️ You should memoize this function for maximal performances. An important memo depends on it. |
-| `numberOfRenderedItems`            | `number`                                                 | The number of items to be rendered (virtualization size).                                                                                                                                                                                                                                                                                                           |
+| `numberOfRenderedItems`            | `number`                                                 | The number of items to be rendered (virtualization size). ⚠️ It must be at least equal to `numberOfItemsVisibleOnScreen +2` or when using jump-on-scroll : `(2 * numberOfItemsVisibleOnScreen) + 1` to ensure  correct rendering.                                                                                                                                                                                                                                                                                                          |
 | `numberOfItemsVisibleOnScreen`     | `number`                                                 | The number of items visible on the screen. This helps determine how to slice the data and when to stop the scroll at the end of the list.                                                                                                                                                                                                                           |
 | `onEndReached`                     | `() => void`                                             | An optional callback function that is called when the user reaches the end of the list. Helps with pagination.                                                                                                                                                                                                                                                      |
 | `onEndReachedThresholdItemsNumber` | `number`                                                 | The number of items left to display before triggering the `onEndReached` callback. Defaults to 3.                                                                                                                                                                                                                                                                   |