docs: Add autogenerated API for React Native ExecuTorch documentation (#748)

## Description
This PR adds auto-generated API into documentation. This is based on
typedoc comments in TypeScript code which are also added here. During
creating this documentation I caught many smaller errors. They are fixed
here as well.

### Introduces a breaking change?

- [x] Yes
- [ ] No
* This PR remove constant for vertical OCR. All constants that started
with `VERTICAL_OCR_*` are now removed. From now, only `OCR_*` constants
should be used for both OCR and vertical OCR.
* Passing `number[]` in Speech to Text is now not supported anymore.
* Aligned docs with another breaking change, `LLMModule` not does not
take responseCallback`


### Type of change

- [ ] Bug fix (change which fixes an issue)
- [ ] New feature (change which adds functionality)
- [x] Documentation update (improves or adds clarity to existing
documentation)
- [x] Other (chores, tests, code style improvements etc.)

### Tested on

- [x] iOS
- [ ] Android

### Testing instructions

* Build documentation from this PR (`cd docs & yarn & yarn build & yarn
serve`)
* Check if API of our library is visible in the sidebar to the left (at
the very bottom of it)
* Then, Scan through the all API Reference and check if all the sections
are correctly filled
* Check if in the sections with Hooks and TypeScript API all the hand
written tables with signatures etc. are removed, now API Reference is a
source of truth. You should also check that the links the these section
redirects to correct sections. The link themselves are correct (checked
in building process), just the site where they pointing might be
incorrect.
* Check other changed sections of documentation for correctness
* Check all the files with code that were changed if the changes are
correct.

Please **do not** review files in directory `06-api-reference`, they are
generated automatically.
Also you don't need to check any `*.md` files manually, you can test
them all by clicking through the built documentation ;)

### Screenshots

<!-- Add screenshots here, if applicable -->

### Related issues

#772
#752
#746 
#612 
#410

### Checklist

- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have updated the documentation accordingly
- [x] My changes generate no new warnings

### Additional notes

<!-- Include any additional information, assumptions, or context that
reviewers might need to understand this PR. -->

---------

Co-authored-by: Jakub Chmura <92989966+chmjkb@users.noreply.github.com>

Author: msluszniak

.cspell-wordlist.txt

@@ -98,4 +98,9 @@ ocurred
 libfbjni
 libc
 gradlew
+AEROPLANE
+DININGTABLE
+POTTEDPLANT
+TVMONITOR
+sublist
 TTFT

RELEASE.md

@@ -10,7 +10,7 @@ The release process of new minor version consists of the following steps:
 4. Create a new release branch `release/{MAJOR}.{MINOR}`and push it to the remote.
 5. Stability tests are performed on the release branch and all fixes to the new-found issues are pushed into the main branch and cherry-picked into the release branch. This allows for further development on the main branch without interfering with the release process.
 6. Once all tests are passed, tag the release branch with proper version tag `v{MAJOR}.{MINOR}.0` and run `npm publish`.
-7. Create versioned docs by running from repo root `(cd docs && yarn docusaurus docs:version {MAJOR}.{MINOR}.x)` (the 'x' part is intentional and is not to be substituted).
+7. Create versioned docs by running from repo root `(cd docs && yarn docusaurus docs:version {MAJOR}.{MINOR}.x)` (the 'x' part is intentional and is not to be substituted). Also, make sure that all the links in `api-reference` are not broken.
 8. Create a PR with the updated docs.
 9. Create the release notes on GitHub.
 10. Update README.md with release video, if available.

apps/computer-vision/app/ocr_vertical/index.tsx

@@ -1,7 +1,7 @@
 import Spinner from '../../components/Spinner';
 import { BottomBar } from '../../components/BottomBar';
 import { getImage } from '../../utils';
-import { useVerticalOCR, VERTICAL_OCR_ENGLISH } from 'react-native-executorch';
+import { useVerticalOCR, OCR_ENGLISH } from 'react-native-executorch';
 import { View, StyleSheet, Image, Text, ScrollView } from 'react-native';
 import ImageWithBboxes2 from '../../components/ImageWithOCRBboxes';
 import React, { useContext, useEffect, useState } from 'react';
@@ -16,7 +16,7 @@ export default function VerticalOCRScree() {
     height: number;
   }>();
   const model = useVerticalOCR({
-    model: VERTICAL_OCR_ENGLISH,
+    model: OCR_ENGLISH,
     independentCharacters: true,
   });
   const { setGlobalGenerating } = useContext(GeneratingContext);

docs/README.md

@@ -1,41 +1,112 @@
-# Website
+# React Native ExecuTorch Documentation
 
-This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+This directory contains the source code for the documentation website of React Native ExecuTorch, built with [Docusaurus](https://docusaurus.io/).
 
-### Installation
+## Getting Started
 
-```
-$ yarn
-```
+### Prerequisites
 
-### Local Development
+- Node.js (v20+)
+- Yarn
 
-```
-$ yarn start
+### Installation
+
+Navigate to the `docs` directory and install dependencies:
+
+```bash
+cd docs
+yarn install
 ```
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+### Running Locally
 
-### Build
+Start the development server. **Note:** This command automatically generates the API reference from the TypeScript source before starting the site.
 
+```bash
+yarn start
 ```
-$ yarn build
-```
+The site will open at `http://localhost:3000/react-native-executorch/`.
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+## Building
+To build the static files for production:
+
+```bash
+yarn build
+```
+The output will be generated in the `build/` directory.
 
-### Deployment
+## Deployment
 
 Using SSH:
 
-```
+```bash
 $ USE_SSH=true yarn deploy
 ```
 
 Not using SSH:
 
-```
+```bash
 $ GIT_USER=<Your GitHub username> yarn deploy
 ```
 
 If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+
+## How API Reference Generation Works
+
+We use `docusaurus-plugin-typedoc` to automatically generate documentation from the TypeScript source code.
+
+1. **Source:** The plugin reads `../packages/react-native-executorch/src/index.ts`.
+
+2. **Generation:** On `yarn start` or `yarn build`, it generates Markdown files into `docs/06-api-reference`.
+
+3. **Sidebar Integration:** Docusaurus strips the number prefix (`06-`) from URLs but requires the folder name for configuration. We use a specific sidebar setup to ensure breadcrumbs work while keeping the UI clean.
+
+### Sidebar Configuration (`sidebars.js`)
+The "API Reference" section is configured with specific settings to handle breadcrumbs correctly:
+
+- `collapsed: true`: Keeps the huge list of API files closed by default.
+
+- **`link` property**: Points to `api-reference/index`. This ensures clicking the text "API Reference" redirects to the Overview page.
+
+- **`items` array**: We nest the autogenerated items inside. This is **critical** because it creates the parent-child relationship needed for breadcrumbs (e.g., `Home > API Reference > LLMType`).
+
+### Troubleshooting Sidebar: 
+
+If you change the folder structure, ensure `dirName` matches the physical folder (`06-api-reference`), but `id` uses the Docusaurus ID (`api-reference/index`).
+
+## Releasing & Versioning
+
+We use Docusaurus versioning to "freeze" documentation for older releases.
+
+### Creating a New Version
+
+When you release a new npm version (e.g., `1.0.0`), you must snapshot the documentation. Run this command from the `docs/` folder:
+
+```bash
+yarn docusaurus docs:version 1.0.0
+```
+### Why is this important?
+
+1. It copies the current contents of `docs/` (including the **currently generated API reference**) into `versioned_docs/version-1.0.0`.
+2. This ensures that if the TypeScript API changes in the future, the docs for v1.0.0 remain accurate to that version.
+
+### Working on "Next"
+
+Edit files in `docs/` as usual. These changes appear in the "Next" version of the site (the default view), reflecting the current `main` branch.
+
+## Troubleshooting
+
+### "Duplicate ID" Errors
+If you see build errors about duplicate IDs, it usually means an old generation artifact is conflicting with a new one. Run:
+
+```bash
+yarn clear
+```
+This deletes the `.docusaurus` cache and `build` folder.
+
+### API Docs Not Updating
+
+TypeDoc runs strictly at startup. If you modify comments in the TypeScript package:
+
+1. Stop the server.
+2. Run `yarn start` again to regenerate the Markdown files.

docs/docs/01-fundamentals/01-getting-started.md

@@ -105,6 +105,5 @@ Adding new functionality to the library follows a consistent three-step integrat
 If you want to dive deeper into ExecuTorch or our previous work with the framework, we highly encourage you to check out the following resources:
 
 - [ExecuTorch docs](https://pytorch.org/executorch/stable/index.html)
-- [Native code for iOS](https://medium.com/swmansion/bringing-native-ai-to-your-mobile-apps-with-executorch-part-i-ios-f1562a4556e8?source=user_profile_page---------0-------------250189c98ccf---------------)
-- [Native code for Android](https://medium.com/swmansion/bringing-native-ai-to-your-mobile-apps-with-executorch-part-ii-android-29431b6b9f7f?source=user_profile_page---------2-------------b8e3a5cb1c63---------------)
-- [Exporting to Android with XNNPACK](https://medium.com/swmansion/exporting-ai-models-on-android-with-xnnpack-and-executorch-3e70cff51c59?source=user_profile_page---------1-------------b8e3a5cb1c63---------------)
+- [React Native RAG](https://blog.swmansion.com/introducing-react-native-rag-fbb62efa4991)
+- [Offline Text Recognition on Mobile: How We Brought EasyOCR to React Native ExecuTorch](https://blog.swmansion.com/bringing-easyocr-to-react-native-executorch-2401c09c2d0c)

docs/docs/01-fundamentals/02-loading-models.md

@@ -36,6 +36,10 @@ useExecutorchModule({
 The downloaded files are stored in documents directory of your application.
 :::
 
+## Predefined Models
+
+Our library offers out-of-the-box support for multiple models. To make things easier, we created aliases for our model exported to `pte` format. For full list of aliases, check out: [API Reference](../06-api-reference/index.md#models---classification)
+
 ## Example
 
 The following code snippet demonstrates how to load model and tokenizer files using `useLLM` hook:

docs/docs/01-fundamentals/03-frequently-asked-questions.md

@@ -10,7 +10,18 @@ Each hook documentation subpage (useClassification, useLLM, etc.) contains a sup
 
 ### How can I run my own AI model?
 
-To run your own model, you need to directly access the underlying [ExecuTorch Module API](https://pytorch.org/executorch/stable/extension-module.html). We provide an experimental [React hook](../03-hooks/03-executorch-bindings/useExecutorchModule.md) along with a [TypeScript alternative](../04-typescript-api/03-executorch-bindings/ExecutorchModule.md), which serve as a way to use the aforementioned API without the need of diving into native code. In order to get a model in a format runnable by the runtime, you'll need to get your hands dirty with some ExecuTorch knowledge. For more guides on exporting models, please refer to the [ExecuTorch tutorials](https://pytorch.org/executorch/stable/tutorials/export-to-executorch-tutorial.html). Once you obtain your model in a `.pte` format, you can run it with `useExecuTorchModule` and `ExecuTorchModule`.
+To run your own model, you need to directly access the underlying [ExecuTorch Module API](https://pytorch.org/executorch/stable/extension-module.html). We provide [React hook](../03-hooks/03-executorch-bindings/useExecutorchModule.md) along with a [TypeScript alternative](../04-typescript-api/03-executorch-bindings/ExecutorchModule.md), which serve as a way to use the aforementioned API without the need of diving into native code. In order to get a model in a format runnable by the runtime, you'll need to get your hands dirty with some ExecuTorch knowledge. For more guides on exporting models, please refer to the [ExecuTorch tutorials](https://pytorch.org/executorch/stable/tutorials/export-to-executorch-tutorial.html). Once you obtain your model in a `.pte` format, you can run it with `useExecuTorchModule` and `ExecuTorchModule`.
+
+### How React Native ExecuTorch works under the hood?
+
+The general workflow for each functionality in our library goes like this:
+
+- You call a functionality from TypeScript
+- TypeScript calls C++ function like model inference or data processing via JSI
+- C++ returns result to TypeScript back via JSI
+- You get results in TypeScript
+
+Using JSI enables us using **zero-copy data transfer** and **fast, low-level C++**.
 
 ### Can you do function calling with useLLM?