feat(docs): add GitHub Actions workflow for documentation generation and deployment

Author: mceachen

.github/workflows/docs.yml

@@ -0,0 +1,56 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Set up Node.js
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Generate documentation
+        run: npm run docs
+
+      - name: Setup Pages
+        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0
+        with:
+          path: "build/docs"
+
+  # Deploy job
+  deploy:
+    needs: build
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write # to deploy to Pages
+      id-token: write # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5

README.md

@@ -2,9 +2,12 @@
 
 [![npm version](https://img.shields.io/npm/v/@photostructure/sqlite-diskann.svg)](https://www.npmjs.com/package/@photostructure/sqlite-diskann)
 [![CI](https://github.com/photostructure/sqlite-diskann/workflows/CI/badge.svg)](https://github.com/photostructure/sqlite-diskann/actions/workflows/ci.yml)
+[![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://photostructure.github.io/sqlite-diskann/)
 
 SQLite extension for DiskANN approximate nearest neighbor vector search.
 
+📘 **[Full TypeScript API Documentation](https://photostructure.github.io/sqlite-diskann/)**
+
 ## What is this?
 
 A standalone SQLite extension implementing the [DiskANN algorithm](https://github.com/microsoft/DiskANN) for efficient vector similarity search at scale. Extracted from [libSQL's implementation](https://github.com/tursodatabase/libsql) and optimized for use as a standard SQLite extension.
@@ -456,6 +459,21 @@ See [`_research/sqlite-vector-options.md`](./_research/sqlite-vector-options.md)
 
 ## API Reference
 
+### TypeScript API
+
+**📘 [Complete API Documentation](https://photostructure.github.io/sqlite-diskann/)** - Auto-generated from source with TypeDoc
+
+The TypeScript package exports the following functions:
+
+- **`loadDiskAnnExtension(db)`** - Load extension into database
+- **`getExtensionPath()`** - Get platform-specific extension path
+- **`createDiskAnnIndex(db, tableName, options)`** - Create virtual table with configuration
+- **`searchNearest(db, tableName, queryVector, k)`** - Search for k nearest neighbors
+- **`insertVector(db, tableName, rowid, vector)`** - Insert a vector
+- **`deleteVector(db, tableName, rowid)`** - Delete a vector
+
+See the [full API documentation](https://photostructure.github.io/sqlite-diskann/) for detailed usage, parameters, and examples.
+
 ### Virtual Table SQL
 
 ```sql