Add TypeDoc API docs and simplify README

- Add TypeDoc with projectDocuments for a detailed Usage Guide
- Move all detailed examples from README into documents/guide.md
- Simplify README to concise overview with links to docs
- Add API Reference link to website navbar
- Update GitHub Pages workflow to build and deploy TypeDoc output

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: chtitux

.github/workflows/pages.yml

@@ -40,6 +40,12 @@ jobs:
         working-directory: ./website
         run: npm run build
 
+      - name: Build API docs with TypeDoc
+        run: npx typedoc
+
+      - name: Copy API docs to website
+        run: cp -r typedoc-out website/dist/docs
+
       - name: Setup Pages
         uses: actions/configure-pages@v4
 

.gitignore

@@ -3,6 +3,7 @@ node_modules/
 
 # Build outputs
 dist/
+typedoc-out/
 *.tsbuildinfo
 
 # Test coverage