diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..f5facc94
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,128 @@
+name: Documentation
+
+on:
+  pull_request:
+    paths:
+      - 'docs/**'
+      - 'API/**'
+      - 'Client/**'
+      - 'extension-recorder/**'
+      - 'extension-collector/**'
+      - 'README.md'
+      - '.github/workflows/docs.yml'
+  push:
+    branches: [master]
+    paths:
+      - 'docs/**'
+      - 'API/**'
+      - 'Client/**'
+      - 'extension-recorder/**'
+      - 'extension-collector/**'
+      - 'README.md'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+  schedule:
+    - cron: '17 6 * * *'
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docs-${{ github.ref }}
+  # A newer pull-request push replaces the running check. Master pushes and scheduled runs share the
+  # refs/heads/master group and queue instead, so neither cancels the other's deploy mid-upload.
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  upstream:
+    runs-on: ubuntu-latest
+    env:
+      # The scheduled build exists only to deploy; a repository without the Cloudflare secrets skips it.
+      DEPLOY_ENABLED: ${{ secrets.CLOUDFLARE_API_TOKEN != '' }}
+    outputs:
+      has_docs: ${{ steps.probe.outputs.has_docs }}
+    steps:
+      - name: Check whether upstream carries the documentation
+        id: probe
+        env:
+          GH_TOKEN: ${{ github.token }}
+        # A scheduled run builds upstream master, which has nothing to build until docs/ is merged there.
+        # Only a 404 means "no docs"; any other failure to answer is reported, not treated as a skip.
+        run: |
+          if [ "$GITHUB_EVENT_NAME" != "schedule" ]; then
+            echo "has_docs=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          if [ "$DEPLOY_ENABLED" != "true" ]; then
+            echo "::notice::The Cloudflare deploy secrets are absent; skipping the scheduled build, which exists only to deploy."
+            echo "has_docs=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          status=$(curl -sS -o /dev/null -w '%{http_code}' \
+            -H "Authorization: Bearer $GH_TOKEN" -H "Accept: application/vnd.github+json" \
+            https://api.github.com/repos/jwdeveloper/TikTokLiveJava/contents/docs/package.json) || status="curl exit $?"
+          case "$status" in
+            200)
+              echo "has_docs=true" >> "$GITHUB_OUTPUT"
+              ;;
+            404)
+              echo "::notice::jwdeveloper/TikTokLiveJava has no docs/package.json yet; skipping the scheduled build."
+              echo "has_docs=false" >> "$GITHUB_OUTPUT"
+              ;;
+            *)
+              echo "::error::Could not check jwdeveloper/TikTokLiveJava for docs/package.json: HTTP $status"
+              exit 1
+              ;;
+          esac
+
+  build:
+    needs: upstream
+    if: needs.upstream.outputs.has_docs == 'true'
+    runs-on: ubuntu-latest
+    env:
+      # Deployment runs only where the Cloudflare secrets exist; forks and pull requests skip it.
+      DEPLOY_ENABLED: ${{ secrets.CLOUDFLARE_API_TOKEN != '' }}
+    steps:
+      - name: Check out upstream master
+        if: github.event_name == 'schedule'
+        uses: actions/checkout@v4
+        with:
+          repository: jwdeveloper/TikTokLiveJava
+          ref: master
+      - name: Check out the repository
+        if: github.event_name != 'schedule'
+        uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+          cache: maven
+      - name: Build the library
+        run: mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests package
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+      - name: Install pnpm
+        run: npm install --global pnpm@10.34.2
+      - name: Install documentation dependencies
+        run: pnpm --dir docs install --frozen-lockfile
+      - name: Test the documentation scripts
+        run: pnpm --dir docs test
+      - name: Validate and build documentation
+        run: pnpm --dir docs build
+      - name: Verify SEO invariants
+        run: pnpm --dir docs run seo
+      - name: Upload site for review
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation
+          path: docs/dist
+      - name: Deploy to Cloudflare Workers
+        if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/master' || github.event_name == 'schedule') && env.DEPLOY_ENABLED == 'true'
+        uses: cloudflare/wrangler-action@v4
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          workingDirectory: docs
+          packageManager: pnpm
+          command: deploy
diff --git a/.gitignore b/.gitignore
index 6265f1e2..63317ab6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -246,4 +246,12 @@ $RECYCLE.BIN/
 
 # End of https://www.gitignore.io/api/osx,linux,python,windows,pycharm,visualstudiocode
 /python-app-backend/samconfig.toml
-/java-app-backend/BackendFunction/dependency-reduced-pom.xml
\ No newline at end of file
+/java-app-backend/BackendFunction/dependency-reduced-pom.xml
+
+# Starlight documentation site (docs/)
+docs/node_modules/
+docs/.astro/
+docs/dist/
+docs/src/content/docs/api/
+docs/src/content/docs/schema/
+docs/tools/target/
diff --git a/README.md b/README.md
index 86f91dcf..4860e299 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,7 @@ A Java library inspired by [TikTokLive](https://github.com/isaackogan/TikTokLive
 The library includes a wrapper that connects to the WebCast service using just the username (`uniqueId`). This allows you to connect to your own live chat as well as the live chat of other streamers.
 No credentials are required. Events such as [Members Joining](#member), [Gifts](#gift), [Subscriptions](#subscribe), [Viewers](#roomuser), [Follows](#social), [Shares](#social), [Questions](#questionnew), [Likes](#like) and [Battles](#linkmicbattle) can be tracked.
 
+Full documentation, guides and the complete event reference: [ttlj.docs.isaackogan.com](https://ttlj.docs.isaackogan.com/)
 
 
 <div align="center">
@@ -38,7 +39,7 @@ No credentials are required. Events such as [Members Joining](#member), [Gifts](
 Join the support [discord](https://discord.gg/e2XwPNTBBr) and visit the `#java-support` channel for questions, contributions and ideas. Feel free to make pull requests with missing/new features, fixes, etc
 
 Do you prefer other programming languages?
-- **Node** orginal: [TikTok-Live-Connector](https://github.com/isaackogan/TikTok-Live-Connector) by [@zerodytrash](https://github.com/zerodytrash)
+- **Node** orginal: [TikTok-Live-Connector](https://github.com/zerodytrash/TikTok-Live-Connector) by [@zerodytrash](https://github.com/zerodytrash)
 - **Rust** rewrite: [TikTokLiveRust](https://github.com/jwdeveloper/TikTokLiveRust)
 - **Python** rewrite: [TikTokLive](https://github.com/isaackogan/TikTokLive) by [@isaackogan](https://github.com/isaackogan)
 - **Go** rewrite: [GoTikTokLive](https://github.com/Davincible/gotiktoklive) by [@Davincible](https://github.com/Davincible)
@@ -151,7 +152,7 @@ TikTokLive.newClient("bangbetmenygy")
                     settings.setRetryConnectionTimeout(Duration.ofSeconds(1)); // Timeout before next reconnection
 
                     //Optional: Sometimes not every message from chat are send to TikTokLiveJava to fix this issue you can set sessionId
-                    // documentation how to obtain sessionId https://github.com/isaackogan/TikTok-Live-Connector#send-chat-messages
+                    // documentation how to obtain sessionId https://github.com/zerodytrash/TikTok-Live-Connector#send-chat-messages
                     settings.setSessionId("86c3c8bf4b17ebb2d74bb7fa66fd0000");
 
                     //Optional:
@@ -172,42 +173,46 @@ TikTokLive.newClient("bangbetmenygy")
 
 
 
+- [Documentation](https://ttlj.docs.isaackogan.com/)
+
 **Control**:
 
-- [onReconnecting](#onreconnecting-tiktokreconnectingevent)
-- [onError](#onerror-tiktokerrorevent)
-- [onConnected](#onconnected-tiktokconnectedevent)
-- [onDisconnected](#ondisconnected-tiktokdisconnectedevent)
+- [onReconnecting](#onreconnecting-tiktokreconnectingevent) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokreconnectingevent)
+- [onError](#onerror-tiktokerrorevent) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokerrorevent)
+- [onConnected](#onconnected-tiktokconnectedevent) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokconnectedevent)
+- [onDisconnected](#ondisconnected-tiktokdisconnectedevent) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokdisconnectedevent)
 
 **Message**:
 
-- [onEvent](#onevent-tiktokevent)
-- [onEvent](#onevent-tiktokevent)
-- [onComment](#oncomment-tiktokcommentevent)
-- [onRoomInfo](#onroominfo-tiktokroominfoevent)
-- [onGift](#ongift-tiktokgiftevent)
-- [onSubscribe](#onsubscribe-tiktoksubscribeevent)
-- [onFollow](#onfollow-tiktokfollowevent)
-- [onGiftCombo](#ongiftcombo-tiktokgiftcomboevent)
-- [onLiveEnded](#onliveended-tiktokliveendedevent)
-- [onQuestion](#onquestion-tiktokquestionevent)
-- [onShare](#onshare-tiktokshareevent)
-- [onLiveUnpaused](#onliveunpaused-tiktokliveunpausedevent)
-- [onEmote](#onemote-tiktokemoteevent)
-- [onJoin](#onjoin-tiktokjoinevent)
-- [onLike](#onlike-tiktoklikeevent)
-- [onLivePaused](#onlivepaused-tiktoklivepausedevent)
+- [onEvent](#onevent-tiktokevent) · [docs](https://ttlj.docs.isaackogan.com/events/)
+- [onEvent](#onevent-tiktokevent) · [docs](https://ttlj.docs.isaackogan.com/events/)
+- [onComment](#oncomment-tiktokcommentevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokcommentevent)
+- [onRoomInfo](#onroominfo-tiktokroominfoevent) · [docs](https://ttlj.docs.isaackogan.com/events/room-and-display/#tiktokroominfoevent)
+- [onGift](#ongift-tiktokgiftevent) · [docs](https://ttlj.docs.isaackogan.com/events/gifts-and-goals/#tiktokgiftevent)
+- [onSubscribe](#onsubscribe-tiktoksubscribeevent) · [docs](https://ttlj.docs.isaackogan.com/events/subscriptions-and-fans/#tiktoksubscribeevent)
+- [onFollow](#onfollow-tiktokfollowevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokfollowevent)
+- [onGiftCombo](#ongiftcombo-tiktokgiftcomboevent) · [docs](https://ttlj.docs.isaackogan.com/events/gifts-and-goals/#tiktokgiftcomboevent)
+- [onLiveEnded](#onliveended-tiktokliveendedevent) · [docs](https://ttlj.docs.isaackogan.com/events/stream-control/#tiktokliveendedevent)
+- [onQuestion](#onquestion-tiktokquestionevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokquestionevent)
+- [onShare](#onshare-tiktokshareevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokshareevent)
+- [onLiveUnpaused](#onliveunpaused-tiktokliveunpausedevent) · [docs](https://ttlj.docs.isaackogan.com/events/stream-control/#tiktokliveunpausedevent)
+- [onEmote](#onemote-tiktokemoteevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokemoteevent)
+- [onJoin](#onjoin-tiktokjoinevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokjoinevent)
+- [onLike](#onlike-tiktoklikeevent) · [docs](https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktoklikeevent)
+- [onLivePaused](#onlivepaused-tiktoklivepausedevent) · [docs](https://ttlj.docs.isaackogan.com/events/stream-control/#tiktoklivepausedevent)
 
 **Debug**:
 
-- [onWebsocketResponse](#onwebsocketresponse-tiktokwebsocketresponseevent)
-- [onWebsocketUnhandledMessage](#onwebsocketunhandledmessage-tiktokwebsocketunhandledmessageevent)
-- [onHttpResponse](#onhttpresponse-tiktokhttpresponseevent)
-- [onWebsocketMessage](#onwebsocketmessage-tiktokwebsocketmessageevent)
+- [onWebsocketResponse](#onwebsocketresponse-tiktokwebsocketresponseevent) · [docs](https://ttlj.docs.isaackogan.com/events/debugging/#tiktokwebsocketresponseevent)
+- [onWebsocketUnhandledMessage](#onwebsocketunhandledmessage-tiktokwebsocketunhandledmessageevent) · [docs](https://ttlj.docs.isaackogan.com/events/debugging/#tiktokwebsocketunhandledmessageevent)
+- [onHttpResponse](#onhttpresponse-tiktokhttpresponseevent) · [docs](https://ttlj.docs.isaackogan.com/events/debugging/#tiktokhttpresponseevent)
+- [onWebsocketMessage](#onwebsocketmessage-tiktokwebsocketmessageevent) · [docs](https://ttlj.docs.isaackogan.com/events/debugging/#tiktokwebsocketmessageevent)
 # Examples
 <br>
 
-## onReconnecting [TikTokReconnectingEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokReconnectingEvent.java)
+## onReconnecting [TikTokReconnectingEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokReconnectingEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/control/#tiktokreconnectingevent
 
 
 
@@ -224,7 +229,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onError [TikTokErrorEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokErrorEvent.java)
+## onError [TikTokErrorEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokErrorEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/control/#tiktokerrorevent
 
 
 General error event. You should handle this.
@@ -243,7 +250,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onConnected [TikTokConnectedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokConnectedEvent.java)
+## onConnected [TikTokConnectedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokConnectedEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/control/#tiktokconnectedevent
 
 
 Triggered when the connection is successfully established.
@@ -262,7 +271,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onDisconnected [TikTokDisconnectedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokDisconnectedEvent.java)
+## onDisconnected [TikTokDisconnectedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokDisconnectedEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/control/#tiktokdisconnectedevent
 
 
 Triggered when the connection gets disconnected. In that case you can call connect() again to have a reconnect logic.
@@ -282,7 +293,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onEvent [TikTokEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/common/TikTokEvent.java)
+## onEvent [TikTokEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/common/TikTokEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/
 
 
 Base class for all events
@@ -301,7 +314,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onEvent [TikTokEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/common/TikTokEvent.java)
+## onEvent [TikTokEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/common/TikTokEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/
 
 
 Base class for all events
@@ -320,7 +335,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onComment [TikTokCommentEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokCommentEvent.java)
+## onComment [TikTokCommentEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokCommentEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokcommentevent
 
 
 Triggered every time a new chat comment arrives.
@@ -339,7 +356,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onRoomInfo [TikTokRoomInfoEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/room/TikTokRoomInfoEvent.java)
+## onRoomInfo [TikTokRoomInfoEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/room/TikTokRoomInfoEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/room-and-display/#tiktokroominfoevent
 
 
 Triggered when LiveRoomInfo got updated such as likes, viewers, ranking ....
@@ -358,7 +377,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onGift [TikTokGiftEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/gift/TikTokGiftEvent.java)
+## onGift [TikTokGiftEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/gift/TikTokGiftEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/gifts-and-goals/#tiktokgiftevent
 
 
 Triggered when user sends gifts that has
@@ -379,7 +400,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onSubscribe [TikTokSubscribeEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokSubscribeEvent.java)
+## onSubscribe [TikTokSubscribeEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokSubscribeEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/subscriptions-and-fans/#tiktoksubscribeevent
 
 
 Triggers when a user creates a subscription.
@@ -398,7 +421,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onFollow [TikTokFollowEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/social/TikTokFollowEvent.java)
+## onFollow [TikTokFollowEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/social/TikTokFollowEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokfollowevent
 
 
 Triggers when a user follows the streamer. Based on social event.
@@ -417,7 +442,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onGiftCombo [TikTokGiftComboEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/gift/TikTokGiftComboEvent.java)
+## onGiftCombo [TikTokGiftComboEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/gift/TikTokGiftComboEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/gifts-and-goals/#tiktokgiftcomboevent
 
 
 Triggered every time gift is sent
@@ -446,7 +473,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onLiveEnded [TikTokLiveEndedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokLiveEndedEvent.java)
+## onLiveEnded [TikTokLiveEndedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokLiveEndedEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/stream-control/#tiktokliveendedevent
 
 
 Triggered when the live stream gets terminated by the host. Will also trigger the TikTokDisconnectedEvent event.
@@ -465,7 +494,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onQuestion [TikTokQuestionEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokQuestionEvent.java)
+## onQuestion [TikTokQuestionEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokQuestionEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokquestionevent
 
 
 Triggered every time someone asks a new question via the question feature.
@@ -484,7 +515,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onShare [TikTokShareEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/social/TikTokShareEvent.java)
+## onShare [TikTokShareEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/social/TikTokShareEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokshareevent
 
 
 Triggers when a user shares the stream. Based on social event.
@@ -503,7 +536,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onLiveUnpaused [TikTokLiveUnpausedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokLiveUnpausedEvent.java)
+## onLiveUnpaused [TikTokLiveUnpausedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokLiveUnpausedEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/stream-control/#tiktokliveunpausedevent
 
 
 
@@ -520,7 +555,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onEmote [TikTokEmoteEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokEmoteEvent.java)
+## onEmote [TikTokEmoteEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokEmoteEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokemoteevent
 
 
 Triggered every time a subscriber sends an emote (sticker).
@@ -539,7 +576,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onJoin [TikTokJoinEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/social/TikTokJoinEvent.java)
+## onJoin [TikTokJoinEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/social/TikTokJoinEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktokjoinevent
 
 
 
@@ -556,7 +595,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onLike [TikTokLikeEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/social/TikTokLikeEvent.java)
+## onLike [TikTokLikeEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/social/TikTokLikeEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/chat-and-audience/#tiktoklikeevent
 
 
 Triggered when a viewer sends likes to the streamer. For streams with many viewers, this event is not always triggered by TikTok.
@@ -575,7 +616,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onLivePaused [TikTokLivePausedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/TikTokLivePausedEvent.java)
+## onLivePaused [TikTokLivePausedEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/TikTokLivePausedEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/stream-control/#tiktoklivepausedevent
 
 
 
@@ -592,7 +635,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onWebsocketResponse [TikTokWebsocketResponseEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/websocket/TikTokWebsocketResponseEvent.java)
+## onWebsocketResponse [TikTokWebsocketResponseEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/websocket/TikTokWebsocketResponseEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/debugging/#tiktokwebsocketresponseevent
 
 
 
@@ -609,7 +654,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onWebsocketUnhandledMessage [TikTokWebsocketUnhandledMessageEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/websocket/TikTokWebsocketUnhandledMessageEvent.java)
+## onWebsocketUnhandledMessage [TikTokWebsocketUnhandledMessageEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/websocket/TikTokWebsocketUnhandledMessageEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/debugging/#tiktokwebsocketunhandledmessageevent
 
 
 Triggered every time a protobuf encoded webcast message arrives. You can deserialize the binary object depending on the use case.
@@ -628,7 +675,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onHttpResponse [TikTokHttpResponseEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/http/TikTokHttpResponseEvent.java)
+## onHttpResponse [TikTokHttpResponseEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/http/TikTokHttpResponseEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/debugging/#tiktokhttpresponseevent
 
 
 
@@ -645,7 +694,9 @@ TikTokLive.newClient("host-name")
 
 <br>
 
-## onWebsocketMessage [TikTokWebsocketMessageEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/data/events/websocket/TikTokWebsocketMessageEvent.java)
+## onWebsocketMessage [TikTokWebsocketMessageEvent](https://github.com/jwdeveloper/TikTokLiveJava/blob/master/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/websocket/TikTokWebsocketMessageEvent.java)
+
+Documentation: https://ttlj.docs.isaackogan.com/events/debugging/#tiktokwebsocketmessageevent
 
 
 Triggered every time TikTok sends data. Data incoming as protobuf message.
diff --git a/collaboration.md b/collaboration.md
index 42de7242..f61fdf29 100644
--- a/collaboration.md
+++ b/collaboration.md
@@ -200,4 +200,32 @@ need to also include it to interface `EventsBuilder`
 
 Finally we are good to go, our event has been included!
 
-![image](https://github.com/jwdeveloper/TikTokLiveJava/assets/79764581/36ad6f1f-b38c-4cf7-93bd-b4cc0638cba0)
\ No newline at end of file
+![image](https://github.com/jwdeveloper/TikTokLiveJava/assets/79764581/36ad6f1f-b38c-4cf7-93bd-b4cc0638cba0)
+
+
+### Documentation
+
+The documentation site at https://ttlj.docs.isaackogan.com/ is built from the `docs/` directory
+of this repository: a Starlight project whose reference pages (`api/`, `schema/`) are generated
+from the `API` and `Client` sources and the `.proto` files, and whose authored pages are Markdown
+under `docs/src/content/docs/`. It needs JDK 17 or newer, Maven, Node.js 24, and pnpm 10.34.2.
+From the repository root:
+
+```sh
+npx -y pnpm@10.34.2 --dir docs install --frozen-lockfile
+npx -y pnpm@10.34.2 --dir docs build
+```
+
+`build` builds the library modules, packages the tool under `docs/tools/`, runs the content
+check, generates the reference pages, and builds the site; `pnpm --dir docs dev` serves it
+locally after `pnpm --dir docs lib:build`, `pnpm --dir docs tools:build`, and
+`pnpm --dir docs generate`. The content check fails the build when an event,
+settings field, builder handler, exception, or extension is not named on a page, when a page
+links to Discord, when the README's events list and the `EventsBuilder` handlers disagree, or
+when a Java example does not compile. So when you add an event as described above, also add its
+catalog row on `docs/src/content/docs/events/index.md` and a section on the grouped event page.
+Never commit the generated `api/` and `schema/` directories; they are ignored by Git.
+
+The full rules are on the site's contributing page, https://ttlj.docs.isaackogan.com/contributing/,
+and `docs/README.md` lists the commands. The site is deployed to Cloudflare Workers by
+`.github/workflows/docs.yml`; see https://ttlj.docs.isaackogan.com/hosting/.
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..2245d876
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,44 @@
+# Documentation
+
+The site uses Astro Starlight, with reference pages generated from the library sources and the `.proto` files by the Maven tool under `tools/`, and internal links validated by Starlight Links Validator. Its Node dependencies are isolated from the library build.
+
+Use JDK 17 or newer, Maven, Node.js 24, and pnpm 10.34.2 (`npx -y pnpm@10.34.2` runs the pinned version without a global install). From the repository root:
+
+```sh
+npx -y pnpm@10.34.2 --dir docs install --frozen-lockfile
+pnpm --dir docs lib:build
+pnpm --dir docs tools:build
+pnpm --dir docs generate
+pnpm --dir docs dev
+```
+
+`lib:build` builds the `API`, `Client`, `extension-recorder`, and `extension-collector` modules and writes their classpaths (`mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests install dependency:build-classpath -Dmdep.outputFile=target/classpath.txt`); the content check compiles every Java example against them. `tools:build` packages the tool as `tools/target/docs-tools.jar`.
+
+Validate and build:
+
+```sh
+pnpm --dir docs check
+pnpm --dir docs build
+pnpm --dir docs preview
+pnpm --dir docs test
+mvn -q -f docs/tools/pom.xml test
+```
+
+Authored pages live in `src/content/docs/`. The `api/` and `schema/` directories there are generated on every build from the `API` and `Client` sources and from `API/src/main/proto`; they are ignored by Git. Do not edit the generated Markdown; change the Javadoc at the source declaration or the `.proto` file instead.
+
+`check` runs the tool's content check, which compares the pages with the code in eight sections (`events`, `settings`, `builder`, `exceptions`, `extensions`, `discord`, `readme`, `examples`) and compiles every Java fence: a fence with a top-level type declaration as its own file, any other fence as a fragment wrapped in a method with wildcard imports of the library packages. `generate` writes the reference pages. `build` runs `lib:build`, `tools:build`, `check`, `generate`, then `astro build`, which validates links and builds the search index.
+
+Facts come from the library source first, then the README, then `examples/`. Java fences must compile, shell commands use `sh` fences, pages carry no Discord links, links to Euler Stream are plain Markdown links, and the generated directories are never committed. See the site's contributing page for the full rules.
+
+## Hosting
+
+The site is served from Cloudflare Workers static assets at <https://ttlj.docs.isaackogan.com/>. `wrangler.jsonc` in this directory declares the asset directory and the HTML handling for the `tiktoklivejava-docs` Worker; there is no Worker script and no `routes` block, because a maintainer attached the custom domain to the Worker once and it survives deploys. The GitHub workflow `.github/workflows/docs.yml` validates every pull request, runs the SEO gate (`pnpm --dir docs run seo`, which runs `scripts/verify-seo.mjs` over `dist`), and on pushes to `master` redeploys the existing Worker when the repository has the `CLOUDFLARE_API_TOKEN` secret, a token scoped to Editor on that Worker only; the deploy also needs `CLOUDFLARE_ACCOUNT_ID`. A daily scheduled run checks out the upstream repository's `master` and deploys it, so the hosted site tracks upstream from the fork that holds the secrets, and a change pushed only to the fork's `master` is overwritten by it until merged upstream; until upstream carries `docs/`, the workflow's `upstream` job detects that (a `404` from the GitHub API; any other failure fails the job) and the build is skipped, as it is for a scheduled run in a repository without the deploy secrets.
+
+To deploy from a checkout after the installs above:
+
+```sh
+pnpm --dir docs build
+pnpm --dir docs run deploy:cloudflare
+```
+
+Wrangler uploads to the existing Worker and prints `No targets deployed`, which is expected: the config declares no routes and the custom domain stays attached. See [Hosting](src/content/docs/hosting.md) for the configuration, the one-time domain attachment, the secrets, and the verification steps. `DOCS_SITE` defaults to the custom domain and `DOCS_BASE` to `/`; neither needs to be set.
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
new file mode 100644
index 00000000..b51bdbb9
--- /dev/null
+++ b/docs/astro.config.mjs
@@ -0,0 +1,69 @@
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+import starlightLinksValidator from 'starlight-links-validator';
+import lucode from 'lucode-starlight';
+import { visit } from 'unist-util-visit';
+import { unified } from '@astrojs/markdown-remark';
+
+const base = `/${(process.env.DOCS_BASE || '').replace(/^\/+|\/+$/g, '')}/`.replace('//', '/');
+
+// Authored Markdown uses root-relative links; prefix them with the deploy base (a no-op when base is '/').
+function prefixLinks() {
+  return (tree) => visit(tree, 'link', (node) => {
+    if (node.url.startsWith('/') && !node.url.startsWith('//') && !node.url.startsWith(base)) {
+      node.url = `${base}${node.url.slice(1)}`;
+    }
+  });
+}
+
+export default defineConfig({
+  site: process.env.DOCS_SITE || 'https://ttlj.docs.isaackogan.com',
+  base,
+  trailingSlash: 'always',
+  markdown: { processor: unified({ remarkPlugins: [prefixLinks] }) },
+  integrations: [
+    starlight({
+      title: 'TikTokLiveJava',
+      description: 'Unofficial TikTok LIVE API for Java. Guides, events, and generated API reference.',
+      favicon: '/favicon.png',
+      head: [
+        // public/og-image.png is tools-readme/src/main/resources/logo.svg rendered with sharp: resize(542, 542, { fit: 'contain' }) at density 144, composited centred on a white 1200x630 canvas, then flatten() to drop alpha
+        { tag: 'meta', attrs: { property: 'og:image', content: 'https://ttlj.docs.isaackogan.com/og-image.png' } },
+        { tag: 'meta', attrs: { property: 'og:image:alt', content: 'TikTokLiveJava, TikTok LIVE API for Java' } },
+        { tag: 'meta', attrs: { name: 'twitter:card', content: 'summary_large_image' } },
+      ],
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/jwdeveloper/TikTokLiveJava' },
+        { icon: 'discord', label: 'Discord', href: 'https://discord.gg/e2XwPNTBBr' },
+      ],
+      editLink: { baseUrl: 'https://github.com/jwdeveloper/TikTokLiveJava/edit/master/docs/' },
+      sidebar: [
+        { label: 'Start here', items: [
+          { label: 'Getting Started', slug: '' },
+          { label: 'Install', slug: 'getting-started/install' },
+          { label: 'Connection lifecycle', slug: 'getting-started/connection' },
+        ] },
+        { label: 'Configuration', items: [{ autogenerate: { directory: 'configuration' } }] },
+        { label: 'Guides', items: [{ autogenerate: { directory: 'guides' } }] },
+        { label: 'Events', items: [{ autogenerate: { directory: 'events' } }], collapsed: true },
+        { label: 'Advanced', items: [{ autogenerate: { directory: 'advanced' } }], collapsed: true },
+        { label: 'Troubleshooting', slug: 'troubleshooting' },
+        { label: 'Contributing to the docs', slug: 'contributing' },
+        { label: 'Hosting', slug: 'hosting' },
+        { label: 'API reference', items: [{ autogenerate: { directory: 'api' } }], collapsed: true },
+        { label: 'Protobuf schema', items: [{ autogenerate: { directory: 'schema' } }], collapsed: true },
+      ],
+      plugins: [
+        lucode({
+          navLinks: [
+            { label: 'Docs', link: base },
+            { label: 'Events', link: `${base}events/` },
+            { label: 'API', link: `${base}api/` },
+          ],
+          footerText: 'Unofficial project, not affiliated with TikTok or ByteDance Ltd. Signing by [Euler Stream](https://www.eulerstream.com/). Source on [GitHub](https://github.com/jwdeveloper/TikTokLiveJava).',
+        }),
+        starlightLinksValidator(),
+      ],
+    }),
+  ],
+});
diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 00000000..72a000e2
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,31 @@
+{
+  "name": "tiktoklivejava-docs",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.34.2",
+  "engines": {
+    "node": ">=22.22.0"
+  },
+  "scripts": {
+    "dev": "astro dev --host 127.0.0.1",
+    "lib:build": "cd .. && mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests install dependency:build-classpath -Dmdep.outputFile=target/classpath.txt",
+    "tools:build": "mvn -q -f tools/pom.xml -DskipTests package",
+    "check": "java -jar tools/target/docs-tools.jar check ..",
+    "generate": "java -jar tools/target/docs-tools.jar generate ..",
+    "build": "pnpm run lib:build && pnpm run tools:build && pnpm run check && pnpm run generate && astro build",
+    "preview": "astro preview --host 127.0.0.1",
+    "deploy:cloudflare": "wrangler deploy",
+    "seo": "node scripts/verify-seo.mjs dist",
+    "test": "node --test \"scripts/**/*.test.mjs\""
+  },
+  "devDependencies": {
+    "@astrojs/markdown-remark": "7.3.3",
+    "@astrojs/starlight": "0.42.6",
+    "astro": "7.4.1",
+    "lucode-starlight": "1.0.0",
+    "starlight-links-validator": "0.27.0",
+    "typescript": "5.9.3",
+    "unist-util-visit": "5.0.0",
+    "wrangler": "4.151.2"
+  }
+}
diff --git a/docs/pnpm-lock.yaml b/docs/pnpm-lock.yaml
new file mode 100644
index 00000000..2a0ad29c
--- /dev/null
+++ b/docs/pnpm-lock.yaml
@@ -0,0 +1,4733 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      '@astrojs/markdown-remark':
+        specifier: 7.3.3
+        version: 7.3.3
+      '@astrojs/starlight':
+        specifier: 0.42.6
+        version: 0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3)
+      astro:
+        specifier: 7.4.1
+        version: 7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+      lucode-starlight:
+        specifier: 1.0.0
+        version: 1.0.0(@astrojs/starlight@0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3))
+      starlight-links-validator:
+        specifier: 0.27.0
+        version: 0.27.0(@astrojs/starlight@0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3))(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))
+      typescript:
+        specifier: 5.9.3
+        version: 5.9.3
+      unist-util-visit:
+        specifier: 5.0.0
+        version: 5.0.0
+      wrangler:
+        specifier: 4.151.2
+        version: 4.151.2(@types/node@24.19.2)
+
+packages:
+
+  '@astrojs/compiler-binding-android-arm64@0.5.2':
+    resolution: {integrity: sha512-kckIxon6Rm/Bxzh9mGPYpRRqUbToUQoHptCmpMmE+Yt0Xumq8CqrKUidyYhrBsrHVO7bxuRzzWUUqvpf+iYceQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [android]
+
+  '@astrojs/compiler-binding-darwin-arm64@0.5.2':
+    resolution: {integrity: sha512-1ZG5Ar3dD8HtodX9XH1mRmE0qBXZlvjYXSFfpgFwocqfWnvhFuqtGUNseL8wgfImiRMztIjpQqlogQFQQtgiag==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@astrojs/compiler-binding-darwin-x64@0.5.2':
+    resolution: {integrity: sha512-+kl35S7hiHJ2cb7eujwEsPFYYuSgE11uEE2Z20lAJ+undpgulMcW+weQqFPOSSZccEKHOiLIY+kQHkb4e4092w==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [darwin]
+
+  '@astrojs/compiler-binding-linux-arm64-gnu@0.5.2':
+    resolution: {integrity: sha512-BqlR0EHNQLPLwgL9+xogjsAc7zGf0cHho2CPdhv0P1yqbVMwGVaGAqrANP6VYAXCqSC43AF4Czcxc2n+oqdesg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@astrojs/compiler-binding-linux-arm64-musl@0.5.2':
+    resolution: {integrity: sha512-GRGyby3AZWw5d6JQzidyxPyvGgHWsSusrpgKyFVpDTKctABF7L3Pd5V1cRJbV36/rcu+Eh292/wL7pF7MkmGkQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@astrojs/compiler-binding-linux-x64-gnu@0.5.2':
+    resolution: {integrity: sha512-9XAqGTMQAtIslMsjK3xdyY6OI9d59OZqcLBB6pvD/DcoR0daYswfrKx2azdDERDY4AqAnWPC7odVM1BmxYv3Vw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@astrojs/compiler-binding-linux-x64-musl@0.5.2':
+    resolution: {integrity: sha512-jOViewGeTh9bSfS8vK72ECxoy2yvmA+Pd/ZcEvBI5c7+7IcfHwZ5qA4L9fRYuOhSrAifvQ2dV4vm1XAtloaWBw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@astrojs/compiler-binding-wasm32-wasi@0.5.2':
+    resolution: {integrity: sha512-Z7p64doar1uvR5C9Xs6j1CV9lGlPVQX7OQ2aAtZ/xKC5aGS6GB13nyc2UfQXTQLvZrvVwsyaflTQy6ziY5Bekw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [wasm32]
+
+  '@astrojs/compiler-binding-win32-arm64-msvc@0.5.2':
+    resolution: {integrity: sha512-Tr13bh+ahTWsjXjzctK7pFpWV+dUU4FtBfETlR7gO+ueex0F+RDch7eRr0YfKysaRhk9tWm14lsCJ5uWyFPNHQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [win32]
+
+  '@astrojs/compiler-binding-win32-x64-msvc@0.5.2':
+    resolution: {integrity: sha512-SfKkI+jOQYLh6wojPvVPV0lFfQnxisweN9B+qCzRvZp7DHAuGif8Y0WcC5PUgN4jb8VKy57LggQDtggR46Du1g==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [win32]
+
+  '@astrojs/compiler-binding@0.5.2':
+    resolution: {integrity: sha512-lEn76+0JcMQ5RDXU0wSMWJg2ZppiZvSULpghC29cfv4o9bhvWFDbQjsCtvjjXN9iVLFQ7fL3wTR2L2UU13mP8g==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+
+  '@astrojs/compiler-rs@0.5.2':
+    resolution: {integrity: sha512-IvwYLB8t1M86rKO4oPdBi9GP4gzXcgrVlNgocjwos1jeeUuEIV8d9Crn1PvYD/5IKteWOxpIHomf7e8iYlkE+Q==}
+    engines: {node: '>=22.12.0'}
+
+  '@astrojs/internal-helpers@0.13.0':
+    resolution: {integrity: sha512-20jxQqnSmpskcGyad7N5l6Xf1gz0UCa6lNde44bEBdaXGpncEYfAZJ142r2ZgzBaG4dUyzGmhqZWv1INU2eiHQ==}
+
+  '@astrojs/markdown-remark@7.3.3':
+    resolution: {integrity: sha512-yC7XCJtRztiR3GiP8e0WwUAGJeKm5goMDDzcZykfbOOpQUDztBWG66fBeIOfl1uVxvhdI0iLzkeaHgqPhaRfUg==}
+
+  '@astrojs/markdown-satteri@0.4.4':
+    resolution: {integrity: sha512-Byhe9CAiGFJrhMACKpgN/FPf4lcwapqwFQAB7E1sPELTEJINfBIpgnEYOBTXzr//fvSSNhfp/X3AqN4mUV9p+A==}
+
+  '@astrojs/mdx@8.1.0':
+    resolution: {integrity: sha512-xzrlXrjpBYvC27MTkP+2NMiJG4Jjl2DcoNc/EF9RNxAp0dwhvXC3b22+7OO4kHJQKfISk2uy38HYp1UxX7JfSg==}
+    engines: {node: '>=22.22.0'}
+    peerDependencies:
+      '@astrojs/markdown-remark': ^7.3.0
+      '@astrojs/markdown-satteri': ^0.4.0
+      astro: ^7.2.10
+    peerDependenciesMeta:
+      '@astrojs/markdown-remark':
+        optional: true
+
+  '@astrojs/prism@4.1.0':
+    resolution: {integrity: sha512-zvRaL3MKTAXWfVQrHAlYtocRZWXBM6ruF3Bl7Lc7QgFHLRTfwMKo33KczlkvkXDY+qcytKhAWOT9dwUUYLUxAw==}
+    engines: {node: '>=22.22.0'}
+
+  '@astrojs/sitemap@3.7.4':
+    resolution: {integrity: sha512-LbKNC24bdUWcQf/pThB6qLlSqHojxGjZDURIzFocY8rlWnAn2t74nnhnK6S5x0NHriHoAduLEpVjRykmeGiVvA==}
+
+  '@astrojs/starlight@0.42.6':
+    resolution: {integrity: sha512-Cfs7GdgzgNRCauDxQVsFUVL1thrGHK/rQdbv/SURv/xhGBXx+j5ypOHW9ENPraQxbIzUC8KAnJV7L9mvEVRuyQ==}
+    peerDependencies:
+      '@astrojs/markdown-remark': ^7.3.0
+      astro: ^7.2.10
+    peerDependenciesMeta:
+      '@astrojs/markdown-remark':
+        optional: true
+
+  '@astrojs/telemetry@3.4.0':
+    resolution: {integrity: sha512-Qt2T6RGtYacyV8OZU3IcyFbsp69s6qIcnWvQvn7/p9MKebPCpEswP5Ji4RhifG3DfeBX7e07Pjj5smkd+Tfp7Q==}
+    engines: {node: '>=22.22.0'}
+
+  '@babel/helper-string-parser@7.29.7':
+    resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-validator-identifier@7.29.7':
+    resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/parser@7.29.9':
+    resolution: {integrity: sha512-CjXrNHTnvqBVqHgdBysY3vk2T8tpJHb5/RMeHJBTyVa9xgugCB0CJTx/3oO8RV2QRQP391RWpB7D6hLjm8V9uA==}
+    engines: {node: '>=6.0.0'}
+    hasBin: true
+
+  '@babel/types@7.29.8':
+    resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==}
+    engines: {node: '>=6.9.0'}
+
+  '@bruits/satteri-darwin-arm64@0.10.5':
+    resolution: {integrity: sha512-27KTVl4TJkVahMy/ohyA7qd4938G5UNneFUz/PsScYfpIhj0IVAS23mpcJXdPF44sa6nva198lmV/cKIb2YPyA==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@bruits/satteri-darwin-x64@0.10.5':
+    resolution: {integrity: sha512-IjnLe3nKspq6qaeqGgjT7MT8VrTV74yWRlaag7ZdNsI8TDAYZ0iPxMCo+9KQZHUk5EyVB+reBI/PFWL5KuFw9Q==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@bruits/satteri-linux-arm64-gnu@0.10.5':
+    resolution: {integrity: sha512-glkYXZCJywjP13v67eAyAMSJdF+ncvEbYvgi/wOtffL9tQ27lr/zsyzUfgs+ovjJ9d8JNQKiXeiArJcX8PJL9w==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@bruits/satteri-linux-arm64-musl@0.10.5':
+    resolution: {integrity: sha512-yWdgG1g17Nh2QyGVlFUxGRa3FEFwiMcpZEyMNWkbM3deC94cmVc+/i9OuyFpdKuWo3GkgoCtYVOoxk1uCnCZIA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@bruits/satteri-linux-x64-gnu@0.10.5':
+    resolution: {integrity: sha512-FVaLoPT1fBgGl0J+AYebyyXJYBachGl8Oyyrf1lye4RTqCB4S0Gwkj1uM9RJyThUOvx5VUmAT1CnNh1SFHA+kw==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@bruits/satteri-linux-x64-musl@0.10.5':
+    resolution: {integrity: sha512-EHpVAx2bqW3GINHTKkljtxVfQmVDGWIuwOYOP5YghTj+0PkBa2o8oKPRtQ9Kbsr1Fye8jtUcDjhwj2jMNugZKg==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@bruits/satteri-wasm32-wasi@0.10.5':
+    resolution: {integrity: sha512-ypz8c/Zmipxp4IoeDa228Gstv6TLzVmNs3yC6wKCoNSOjx1iwpgzu87Y3hTkXFdwChVGU85qeUDuOIarGUZQLw==}
+    engines: {node: '>=14.0.0'}
+    cpu: [wasm32]
+
+  '@bruits/satteri-win32-arm64-msvc@0.10.5':
+    resolution: {integrity: sha512-siTV88nb0LRqNpkL2gXboqCwVdq95sLtzMHS1/3eONV2gLbB3NAK46wmSMvCO/yquBvI2lvaFIfd8P12ecsxBw==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@bruits/satteri-win32-x64-msvc@0.10.5':
+    resolution: {integrity: sha512-C3IfPvfvMXmlzBxaMPKFS1XiuV9pu2mC7YqkPk7PSvTgPZ8gbdASIpHpztDLvTTQjqZ0z1Ol8tK5X+V6XXC0wQ==}
+    cpu: [x64]
+    os: [win32]
+
+  '@capsizecss/unpack@4.0.1':
+    resolution: {integrity: sha512-CuNiSqg7+e1cO/GjffyMOm5Tt2jUF9CWHHnvQ/UkqvtkGfHdgwEC0wpmq7fkN3gxwpRnrAN0WzO3vREKmNolMQ==}
+    engines: {node: '>=18'}
+
+  '@clack/core@1.5.1':
+    resolution: {integrity: sha512-iHTrHA8MtVuLl2TfZySmcKv1qO2PoyC9Z7pfSDozEuV5vtY3/wcOPKJXlqJ5Oq2Cx5DDGQGAMVx6HZfRRoVEbQ==}
+    engines: {node: '>= 20.12.0'}
+
+  '@clack/prompts@1.8.1':
+    resolution: {integrity: sha512-dlT1m5e/0yUL0kRNcQn7yGLVThkgbB0Ga/1AmfDDC/8ik6AIiSf2QLQO2zPYvefsHP0aFgxO93cVLCCfDp7kzQ==}
+    engines: {node: '>= 20.12.0'}
+
+  '@cloudflare/kv-asset-handler@0.5.0':
+    resolution: {integrity: sha512-jxQYkj8dSIzc0cD6cMMNdOc1UVjqSqu8BZdor5s8cGjW2I8BjODt/kWPVdY+u9zj3ms75Q5qaZgnxUad83+eAg==}
+    engines: {node: '>=22.0.0'}
+
+  '@cloudflare/unenv-preset@2.16.2':
+    resolution: {integrity: sha512-JBP1+Z7ZSNG/d4mRP+y8VC5dka3tZVMLEZRvS+rzQ4DGV1EoxRFQckcJTTkXbHSQiTj0DtNI01Zwb/V2fX0mvQ==}
+    peerDependencies:
+      unenv: 2.0.0-rc.24
+      workerd: '>1.20260305.0 <2.0.0-0'
+    peerDependenciesMeta:
+      workerd:
+        optional: true
+
+  '@cloudflare/workerd-darwin-64@1.20261019.1':
+    resolution: {integrity: sha512-5ZILbAta/fBQvhmAYeCE7dKMMYIr7N9wJEX50fEGLKSIwGtvT0HzSfHNIK/O7cBQ4gHQ2WfIiPClvwcye6E0fA==}
+    engines: {node: '>=16'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@cloudflare/workerd-darwin-arm64@1.20261019.1':
+    resolution: {integrity: sha512-cww2Ab6lVMxpTiEEjKmPI58p5EMo0vYTZSH+3WkqXJdQgc3ES66GuL247+U2B2YWajhhu2tqj7jySrXneU749g==}
+    engines: {node: '>=16'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@cloudflare/workerd-linux-64@1.20261019.1':
+    resolution: {integrity: sha512-4++VRi9vkQROYqrpZYOixIJuVDmujkwrT4kszsxNFlvcmsX6Mr2GumvxIN3gIixS3vJUh3Umdtkthqj5X0S3Xw==}
+    engines: {node: '>=16'}
+    cpu: [x64]
+    os: [linux]
+
+  '@cloudflare/workerd-linux-arm64@1.20261019.1':
+    resolution: {integrity: sha512-75PVtJOwfjScQ53sbLtQXI7D8yP1c21t+WEUPaYbqkzaz4ZqfR5wAd+zuWs8G5Q7kOj2SQIvEfY5Sn8Y+UVrnA==}
+    engines: {node: '>=16'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@cloudflare/workerd-windows-64@1.20261019.1':
+    resolution: {integrity: sha512-z49fvKTETMCnG6wnMcQwxx9CpryFceiKz04FRjq26EkhCyzRNJ6c3UXhyZz3r5f1CXnnBZc5DcU8ZouPkUJCqw==}
+    engines: {node: '>=16'}
+    cpu: [x64]
+    os: [win32]
+
+  '@cspotcode/source-map-support@0.8.1':
+    resolution: {integrity: sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==}
+    engines: {node: '>=12'}
+
+  '@ctrl/tinycolor@4.2.1':
+    resolution: {integrity: sha512-Vh5uy9Y1JBMId6J1f68TMXnZrTCvNdo9Fu2k0d1YnJngR+sM5kWTKl441c/3TFs+cG0NWOjRWgQ/iaWhbYx+7A==}
+    engines: {node: '>=14'}
+
+  '@emnapi/core@1.11.1':
+    resolution: {integrity: sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==}
+
+  '@emnapi/core@1.11.3':
+    resolution: {integrity: sha512-zLpS5asjEb7lq8jYLq37N6XKaE41DIexlY1rF/z4/tIl3wo13Sqm28fRyfIsKZD+NZ8mM5RoKkpW/rBcuoSZSg==}
+
+  '@emnapi/runtime@1.11.1':
+    resolution: {integrity: sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==}
+
+  '@emnapi/runtime@1.11.3':
+    resolution: {integrity: sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==}
+
+  '@emnapi/wasi-threads@1.2.2':
+    resolution: {integrity: sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==}
+
+  '@emnapi/wasi-threads@1.2.3':
+    resolution: {integrity: sha512-ELEBe8PsLvvJ6QMr0zLt8ffvOHW/dc1m3CEzNMg7aJUv3bMaoDtw2TXyDAwkYBuroxxuHEwhRTLJSe5sya547g==}
+
+  '@esbuild/aix-ppc64@0.28.2':
+    resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.28.2':
+    resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.28.2':
+    resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.28.2':
+    resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.28.2':
+    resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.28.2':
+    resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.28.2':
+    resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.28.2':
+    resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.28.2':
+    resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.28.2':
+    resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.28.2':
+    resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.28.2':
+    resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.28.2':
+    resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.28.2':
+    resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.28.2':
+    resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.28.2':
+    resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.28.2':
+    resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.28.2':
+    resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.28.2':
+    resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.28.2':
+    resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.28.2':
+    resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.28.2':
+    resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.28.2':
+    resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.28.2':
+    resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.28.2':
+    resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.28.2':
+    resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@expressive-code/core@0.44.2':
+    resolution: {integrity: sha512-Yw5KonQCD1HoOO2P89y4wifqS9qrJcGVY0LkVMUsVZjhi++bhz4WwQ37inenKFNOEVo50P7cjoVsCdaVnUbq8w==}
+
+  '@expressive-code/plugin-frames@0.44.2':
+    resolution: {integrity: sha512-gVLm6TQMNIRWIaM7o+mCtxkGNjLZY5/2faSTLoXeo9wv/Pkj/0QAtZyXPVPrRsPARqiipATNFmfvQFLJudxPHQ==}
+
+  '@expressive-code/plugin-shiki@0.44.2':
+    resolution: {integrity: sha512-ebWIvCDzXvjyD8rH6T6DfytYJw1GoArLR4nusIAE4VxXrCQf3d+owytiv010KU/dUg+SRLZskDn0N+HaFXeuSg==}
+
+  '@expressive-code/plugin-text-markers@0.44.2':
+    resolution: {integrity: sha512-SNI7EgUSiADqbqUzzMbj1ZeC/r2pa5eg3KyFOGAd3a7EsIA4qzjXQLp+ODWQtHVDKFCdGs4J3ovSJUqvKIK96g==}
+
+  '@img/colour@1.1.0':
+    resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==}
+    engines: {node: '>=18'}
+
+  '@img/sharp-darwin-arm64@0.35.5':
+    resolution: {integrity: sha512-QRUlFQ0WxvdWyqqG/WtI3iupfD5rBzmCHXSdPsY91sAtVtTo7Q4cb6zOccZ3gqEqkr0f1As1ehLqmEpDsRf+lg==}
+    engines: {node: '>=20.9.0'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@img/sharp-darwin-x64@0.35.5':
+    resolution: {integrity: sha512-+BR255RhDlpygUpOc/Jdt1nT6DQ3XG/ERo5wbcdOf5Q320dKtPCKPLR1LJs9VGXRaMa8l1uUa0tkCNOXiAxZUw==}
+    engines: {node: '>=20.9.0'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@img/sharp-freebsd-wasm32@0.35.5':
+    resolution: {integrity: sha512-Y/z91nEZ4uIBX5X3nfTovjU9lHNKFYbL2lpHCLVNmXQK03VIZvXBBt0KxbPGp2SdGSF+2mQU4e+hQaWOt86iAw==}
+    engines: {node: '>=20.9.0'}
+    os: [freebsd]
+
+  '@img/sharp-libvips-darwin-arm64@1.3.4':
+    resolution: {integrity: sha512-5R89nBYiRdUlSWJxPhO+GVtaXzXSxKnRu/xqMn3KTA3L9EB9Oy/P+Nn2f2vlhPuUdy/Zusb2DarbyTpGCfEDuw==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@img/sharp-libvips-darwin-x64@1.3.4':
+    resolution: {integrity: sha512-iR2OKH80yi0U+dUplyh3/xdpFvps6YkCwsXenIJxqxR1v9o+xtKTGbS9H7cps+2Vxjc8B1j96p75NmTGjIhtpQ==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@img/sharp-libvips-linux-arm64@1.3.4':
+    resolution: {integrity: sha512-Y3dgX/6lE2QhQb+Gxy0WZxfg9MEm/JBjamZpS2IklP7xIQoKN4hzAm7KcMVGtaVDt3neE9OKBC7vAfonA/Lr1A==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-libvips-linux-arm@1.3.4':
+    resolution: {integrity: sha512-LmRtTsOHuvM2+wlO2Db37dx5MiZhB0FvSunciw48YjdOkZz9KAiRbm8ujeMOA1INqmei5NapFxYEK1D1ZSidmw==}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-libvips-linux-ppc64@1.3.4':
+    resolution: {integrity: sha512-Le6boB8Tai0Nis+gIxIpKx68UDVVIqdR8Tin5Yf1z2LJJQLDJvCDRqRu+jC2qCoD+eIomonmOwB4smBRxfVpYQ==}
+    cpu: [ppc64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-libvips-linux-riscv64@1.3.4':
+    resolution: {integrity: sha512-aHkkIEHPRdQEegJN20MLmGtxYD9R2wQr3Cwpddnu5+YKMt6Uzax7S9h5gpZTo8wyrGuZSlfQ63OevL5mTyOC7Q==}
+    cpu: [riscv64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-libvips-linux-s390x@1.3.4':
+    resolution: {integrity: sha512-ra/mB6MikESDUO7Yg+Mi95bFBb9GsObURuhnOv3OqknjGe9sZrG8tCe9q0xSIGrtLgvgw0gKnFWcK4blSgQOuQ==}
+    cpu: [s390x]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-libvips-linux-x64@1.3.4':
+    resolution: {integrity: sha512-GJ//SSXbnwSDes02umB3nDJLFcQzw8a18V8fyhqr6tV515tOEMdImjjxj1AoafMRz56F3PHgftnj1QEKSU1zkw==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-libvips-linuxmusl-arm64@1.3.4':
+    resolution: {integrity: sha512-hvulFwtjUcagsis6BBxHwGFwWoNZjgYmULGVrZcyfNbjA8hKILbRxGg15/7w5HDyXHXUos/j6baAWqnCyQ2DWA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@img/sharp-libvips-linuxmusl-x64@1.3.4':
+    resolution: {integrity: sha512-6zXKeE/p39I1AmA3cJG35eyBGNqNddLnUXjhwBnsGjFPWqf5VKkDBEqaEkPDoTEtkxwi2vv8Tcr2mDyP4So7Fg==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@img/sharp-linux-arm64@0.35.5':
+    resolution: {integrity: sha512-LYVx5JTsOM2CBzmxreh+nl64/3H6Xb09iSLknqH47z2T2DFFxDeFLP5y4dJwe6H7uGQlHPyEEtIqyo3DYsRwdQ==}
+    engines: {node: '>=20.9.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-linux-arm@0.35.5':
+    resolution: {integrity: sha512-LEaXK2WdXVK5ykcw0buWyPMsmLLL2vpHLD6yrNSW+JGEL3BZPA4tpKN6iaMc4AxTTAoaX/sU1rOL51lcIz48ZQ==}
+    engines: {node: '>=20.9.0'}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-linux-ppc64@0.35.5':
+    resolution: {integrity: sha512-QVxAAq8evVRI9ia2vqgwrmWucn5Dfv+JdWzj75pD8omHLPSP7f8p20O8jxzjCcuCEQEOtYOZUmX1hkiZ0kdevA==}
+    engines: {node: '>=20.9.0'}
+    cpu: [ppc64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-linux-riscv64@0.35.5':
+    resolution: {integrity: sha512-LtdreXguaavKODPIfzJ4kffx7UNt1omwtK0rch4EBbbSTXPnxWmYSayXdLJw0fJzQ97kHt1gL/yh4tvU+nCyRQ==}
+    engines: {node: '>=20.9.0'}
+    cpu: [riscv64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-linux-s390x@0.35.5':
+    resolution: {integrity: sha512-UZasTOFiYzotTsGOCu42BfUzP6Tu6Do/947iRm1RsLKvlllxwGcn4RN27LibGWceix4Y+Pmw3jsnTcCQIgWjqA==}
+    engines: {node: '>=20.9.0'}
+    cpu: [s390x]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-linux-x64@0.35.5':
+    resolution: {integrity: sha512-SxFtLTeJInhAA9Q836kux2vZNeOBQEx658qvbboZScr0wIARym3IcGmW7KpVD5sbVg0Ojy+udFQdayYIZyoNog==}
+    engines: {node: '>=20.9.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@img/sharp-linuxmusl-arm64@0.35.5':
+    resolution: {integrity: sha512-9HbMclmI1zlNkFRs3z9/eBtDjfD0sGlrX1z6b1qwmiFY5ElDLh4BC0LPBdVp7z1DXFiKlIcznf+ZlsuZzLxQqg==}
+    engines: {node: '>=20.9.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@img/sharp-linuxmusl-x64@0.35.5':
+    resolution: {integrity: sha512-4KOphqB035HrVdqLZfCgMzzERrQkkzOwRhl4OAkRO1YCldbaFjySXMaK534Mo0V+LndnlJk+sbUyLeU0ULyD1A==}
+    engines: {node: '>=20.9.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@img/sharp-wasm32@0.35.5':
+    resolution: {integrity: sha512-Ptsga1su4tQx+LLF1ECS9U6nz5kmrXKo6XVbtR48Ke3ZRxxgaWBu7IDtEe1quo8hiupwm6WFqxVlXaSf7IINGQ==}
+    engines: {node: '>=20.9.0'}
+
+  '@img/sharp-webcontainers-wasm32@0.35.5':
+    resolution: {integrity: sha512-hfhF/FmoQyTUkA0bIKFOtw536BQSeBMe6BF6QyWlrPxT754+TFLaZ7sKKTfvvM0yJgKgaYTwnFCIZ/GuDw5SUA==}
+    engines: {node: '>=20.9.0'}
+    cpu: [wasm32]
+
+  '@img/sharp-win32-arm64@0.35.5':
+    resolution: {integrity: sha512-X4t7g+7ZA5DKblCBEXGjUqqemj4vczING/5viFwAL8h4N3qYeyjwdCvRLHi4EdOUI+2Z7UFlp1VM+p/AuEtm6Q==}
+    engines: {node: '>=20.9.0'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@img/sharp-win32-ia32@0.35.5':
+    resolution: {integrity: sha512-5Zm82LoBc43nhwNybZlG7Y1KO//Zhsn306fQl29ZOuStHLGTo3BWL83q3cznX0poxSAMuYL1On/BHBxkBeKr6A==}
+    engines: {node: ^20.9.0}
+    cpu: [ia32]
+    os: [win32]
+
+  '@img/sharp-win32-x64@0.35.5':
+    resolution: {integrity: sha512-x76eH0vEiHlcMQu8Y8IenntaACtddpT6W0wmXtWrnKcnKI7ME5DdgqhAD6SEWOEl1v2zDvkZDhFA9KnURwpfqg==}
+    engines: {node: '>=20.9.0'}
+    cpu: [x64]
+    os: [win32]
+
+  '@jridgewell/resolve-uri@3.1.2':
+    resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==}
+    engines: {node: '>=6.0.0'}
+
+  '@jridgewell/sourcemap-codec@1.6.0':
+    resolution: {integrity: sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==}
+
+  '@jridgewell/trace-mapping@0.3.9':
+    resolution: {integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==}
+
+  '@mdx-js/mdx@3.1.1':
+    resolution: {integrity: sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==}
+
+  '@napi-rs/wasm-runtime@1.2.5':
+    resolution: {integrity: sha512-HshSvXzmBxNzqejd3k/KemgQ3hdREUYFRRrgxOZ+gPljDIsO2SDZrVZMd4Z/HsxudQbE62OVyVFE8z9BCurfjA==}
+    engines: {node: ^20.19.0 || ^22.13.0 || >=23.5.0}
+    peerDependencies:
+      '@emnapi/core': ^1.7.1 || ^2.0.0-alpha.4
+      '@emnapi/runtime': ^1.7.1 || ^2.0.0-alpha.4
+
+  '@oslojs/encoding@1.1.0':
+    resolution: {integrity: sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==}
+
+  '@oxc-project/types@0.154.0':
+    resolution: {integrity: sha512-KYOUGQFlLWR+s4QMV2Q9ko38TZm7EdO87Qm7rvZLqk/webse/cDjtyxKhg/47l0byCbs/k46LT8qc4PKjAikzA==}
+
+  '@pagefind/darwin-arm64@1.5.2':
+    resolution: {integrity: sha512-MXpI+7HsAdPkvJ0gk9xj9g541BCqBZOBbdwj9g6lB5LCj6kSV6nqDSjzcAJwvOsfu0fjwvC8hQU+ecfhp+MpiQ==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@pagefind/darwin-x64@1.5.2':
+    resolution: {integrity: sha512-IojxFWMEJe0RQ7PQ3KXQsPIImNsbpPYpoZ+QUDrL8fAl/O27IX+LVLs74/UzEZy5uA2LD8Nz1AiwKr72vrkZQw==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@pagefind/default-ui@1.5.2':
+    resolution: {integrity: sha512-pm1LMnQg8N2B3n2TnjKlhaFihpz6zTiA4HiGQ6/slKO/+8K9CAU5kcjdSSPgpuk1PMuuN4hxLipUIifnrkl3Sg==}
+
+  '@pagefind/freebsd-x64@1.5.2':
+    resolution: {integrity: sha512-7EVzo9+0w+2cbe671BtMj10UlNo83I+HrLVLfRxO731svHRJKUfJ/mo05gU14pe9PCfpKNQT8FS3Xc/oDN6pOA==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@pagefind/linux-arm64@1.5.2':
+    resolution: {integrity: sha512-Ovt9+K35sqzn8H3ZMXGwls4TD/wMJuvRtShHIsmUQREmaxjrDEX7gHckRCrwYJ4XE1H1p6HkLz3wukrAnsfXQw==}
+    cpu: [arm64]
+    os: [linux]
+
+  '@pagefind/linux-x64@1.5.2':
+    resolution: {integrity: sha512-V+tFqHKXhQKq/WqPBD67AFy7scn1/aZID00ws4fSDd+1daSi5UHR9VVlRrOUYKxn3VuFQYRD7lYXdZK1WED1YA==}
+    cpu: [x64]
+    os: [linux]
+
+  '@pagefind/windows-arm64@1.5.2':
+    resolution: {integrity: sha512-hN9Nh90fNW61nNRCW9ZyQrAj/mD0eRvmJ8NlTUzkbuW8kIzGJUi3cxjFkEcMZ5h/8FsKWD/VcouZl4yo1F7B6g==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@pagefind/windows-x64@1.5.2':
+    resolution: {integrity: sha512-Fa2Iyw7kaDRzGMfNYNUXNW2zbL5FQVDgSOcbDHdzBrDEdpqOqg8TcZ68F22ol6NJ9IGzvUdmeyZypLW5dyhqsg==}
+    cpu: [x64]
+    os: [win32]
+
+  '@poppinss/colors@4.1.6':
+    resolution: {integrity: sha512-H9xkIdFswbS8n1d6vmRd8+c10t2Qe+rZITbbDHHkQixH5+2x1FDGmi/0K+WgWiqQFKPSlIYB7jlH6Kpfn6Fleg==}
+
+  '@poppinss/dumper@0.6.5':
+    resolution: {integrity: sha512-NBdYIb90J7LfOI32dOewKI1r7wnkiH6m920puQ3qHUeZkxNkQiFnXVWoE6YtFSv6QOiPPf7ys6i+HWWecDz7sw==}
+
+  '@poppinss/exception@1.2.3':
+    resolution: {integrity: sha512-dCED+QRChTVatE9ibtoaxc+WkdzOSjYTKi/+uacHWIsfodVfpsueo3+DKpgU5Px8qXjgmXkSvhXvSCz3fnP9lw==}
+
+  '@rolldown/binding-android-arm-eabi@1.2.14':
+    resolution: {integrity: sha512-aWR+XKH9+rW7m5fWq/5360J3mHycrx/o6xZM2DQFdJnTMdyP7/WzxPjhtLbVWdKo2y612/4U1bWqb3HQhiF7vg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [android]
+
+  '@rolldown/binding-android-arm64@1.2.14':
+    resolution: {integrity: sha512-QiVxHofl6A8lQU7WAtOUY4QMVZXohxwz7WJJoeh8NBEUyKfIkMRKhYyq8az/1RypNiIXzNTtiS6KwHz0erxYRQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [android]
+
+  '@rolldown/binding-darwin-arm64@1.2.14':
+    resolution: {integrity: sha512-lTQOzHuBIooh3jIr5XINQkjPGEuGy+Dsy0meXDr6Sjty0b99kYgGh4uBC/8mJX1T0kC8d6S0aPP1Y+bHkh6aBw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@rolldown/binding-darwin-x64@1.2.14':
+    resolution: {integrity: sha512-hyMKEGatjmBYCs/Q4sbIcL/GqpFEqsX3wc+HYVQ/85A4rxc1o7rPm4DUI4GV4k/h0ITddwFSGpqQunI14GXjTA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [darwin]
+
+  '@rolldown/binding-freebsd-x64@1.2.14':
+    resolution: {integrity: sha512-u371GbXoVXrEgP20PwzoGNOdAOqAMhzo19JzzY+V4YmmnC+DTOoqdbMu+O+54emM59Mik/UdrtWgcuEDKWRPKA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.14':
+    resolution: {integrity: sha512-BqwKsdZQf6EqVWr8fv2MrDYzAvOZ7+NYFSJESRGs87fkseEhs0TU9TXgRJTkZoRRkxTizyEg1LKUXfU3/78uqg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [linux]
+
+  '@rolldown/binding-linux-arm64-gnu@1.2.14':
+    resolution: {integrity: sha512-SD9kY8M009x/7s57Z1dgUVlP5+uYBgKQK0Tkr1WIWngrtUJmRCW1RJFMY7QDla2khXhmg2i5Io7MUjcmZNZ/KQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rolldown/binding-linux-arm64-musl@1.2.14':
+    resolution: {integrity: sha512-BJ2CL19M6uuWesMgnqJzgxoI+N+eV7b0A9O9vLV42y+gitC41fNa8KElau1tHVzuLWX5GzEuxMPhAO0tQXQMkg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@rolldown/binding-linux-ppc64-gnu@1.2.14':
+    resolution: {integrity: sha512-4+Kl8daPV8NDHaD7mfCcc1pRM+Qg7ab8DyMm5FG5WoZgv4h2i3KFN1CybYBNbQqmuYm7ftJLvmMI1eHYJ22S/Q==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [ppc64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rolldown/binding-linux-s390x-gnu@1.2.14':
+    resolution: {integrity: sha512-V/h8ePq1fKDrmtFMz6xcCN3DKvuvMRrwwD1q0PkBeeo4DpK64biaKvqWGVxqCeYKqeRk7gE7/iKPxLCn08O97A==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [s390x]
+    os: [linux]
+    libc: [glibc]
+
+  '@rolldown/binding-linux-x64-gnu@1.2.14':
+    resolution: {integrity: sha512-WxalXzgrLVpKC93xfpaJ3gCXUWzeCr+FRCbDVD2mUAy4L6Vo3lNVz0epUEUpxPWJkLNYUwM4OSIikv36OJ9mLg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rolldown/binding-linux-x64-musl@1.2.14':
+    resolution: {integrity: sha512-3G3tnAmTpdk9jO3GQtyHXqeFD2SlecfTws/Y3M2mmj9nMBwwuLT4kur8sZKeu7ENUHSpVO3cIsm5A52LEWWwlg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@rolldown/binding-openharmony-arm64@1.2.14':
+    resolution: {integrity: sha512-qyr5XiNGxm2ytx17vvtcJ9nXn6v1gENETi503bJx3OGwZ1tSonj7BosxbMa/xeAfSl5iS9X6KjEWYXLu6v1L7Q==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@rolldown/binding-win32-arm64-msvc@1.2.14':
+    resolution: {integrity: sha512-oA4o5o0S2yB199YyYXDzKUv1Z56Rc+mgOjwm7Z/vJ9Z8igiDPYvoOuDyo6g7AK/ZaF09nPhDKVnGBcYHO11GXA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [win32]
+
+  '@rolldown/binding-win32-x64-msvc@1.2.14':
+    resolution: {integrity: sha512-9mE94bf2GZUaR/fUSXCMpBoWkctu421Mi0ORpm4zqfbkjKep7RxzPFa5etcGs5h+2KApoWBOA/hAJa/7saGgEQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [win32]
+
+  '@rolldown/pluginutils@1.0.1':
+    resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
+
+  '@shikijs/core@4.5.0':
+    resolution: {integrity: sha512-6CIgwq+bt2JZ3OSjb/nBkkwEf/CfpHcbam+Mg5Pllco7HAGRQ2/EFhZrrJtbyNTgKwknfVS+llsXGygiDGwJWw==}
+    engines: {node: '>=20'}
+
+  '@shikijs/engine-javascript@4.5.0':
+    resolution: {integrity: sha512-Ed6UdEj84LyYkwnxM5CvSMWAD+id9ExTYri0/+x41U9zrgNifPSS9lZm0JqBP0VfYI8yr8tY5nbNq9+p9R0kFA==}
+    engines: {node: '>=20'}
+
+  '@shikijs/engine-oniguruma@4.5.0':
+    resolution: {integrity: sha512-dKVmbJecVdB9recl8a/CU4jdpNXyjJQrIcesIkpS70s5HS02ohpnCSpMUbotPnEUzbAcLQ+S4hwZYbkBBiTcJw==}
+    engines: {node: '>=20'}
+
+  '@shikijs/langs@4.5.0':
+    resolution: {integrity: sha512-wwBTqwduXSz0X4v9Qa2EWeFaYJEw1clCncWjoRNQRbVDu3SPRTRWucnouYapKj3b8Q+sk/41Vbc4B5c8nuYzLA==}
+    engines: {node: '>=20'}
+
+  '@shikijs/primitive@4.5.0':
+    resolution: {integrity: sha512-UM7ShlA8oz0OWxLLO8BmO9Ip6fVqdkt8yF0EH7nOCqHfrx1eEAzF0ZUVK7L+I8NEgeu1PEWSRlxaiPPeCb4iDg==}
+    engines: {node: '>=20'}
+
+  '@shikijs/themes@4.5.0':
+    resolution: {integrity: sha512-zGb87H3UBbpuI4yoh5UguB1XbU+2BDU3kflM7UfZ+Cy2hWo9lBtqjSVK20gmLY6ukYl040hAypGXMgud9vul8Q==}
+    engines: {node: '>=20'}
+
+  '@shikijs/types@4.5.0':
+    resolution: {integrity: sha512-drtPrtD8N0DENyD2cyt6Ajy+IWsiCLgMxODwLTpvH1UsN6a9jf90tNTPjqwHvA+0Lzu9e0txk8DjfqH1p9UJRw==}
+    engines: {node: '>=20'}
+
+  '@shikijs/vscode-textmate@10.1.0':
+    resolution: {integrity: sha512-cVBuhDQjBZaNMTwBquYfPydrUP+E3hE6oYGasx8h6ZrODIM7/r+gxLDXdd66oszbrggZHEntdE6j+5gYIVyMWQ==}
+
+  '@sindresorhus/is@7.2.0':
+    resolution: {integrity: sha512-P1Cz1dWaFfR4IR+U13mqqiGsLFf1KbayybWwdd2vfctdV6hDpUkgCY0nKOLLTMSoRd/jJNjtbqzf13K8DCCXQw==}
+    engines: {node: '>=18'}
+
+  '@speed-highlight/core@1.2.24':
+    resolution: {integrity: sha512-qeW2e1l78afw8VhRPfPQ1Gjj+KU5XFQ/OFV5ti6eTa9bruO7mJyZtA4vw0ofqmA3tKCkROE9xLk3VZoeRc98nw==}
+
+  '@tybys/wasm-util@0.10.4':
+    resolution: {integrity: sha512-W3c4gRigFS0T/Ma4qIYF3GDAc5AQdHb1yL5znJT1Zv1YaD9Kitx656wBjvr19qbiosmZT8lWDM5BEMynUqX65A==}
+
+  '@types/debug@4.1.13':
+    resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
+
+  '@types/estree-jsx@1.0.5':
+    resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
+
+  '@types/estree@1.0.9':
+    resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
+
+  '@types/hast@3.0.5':
+    resolution: {integrity: sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==}
+
+  '@types/js-yaml@4.0.9':
+    resolution: {integrity: sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==}
+
+  '@types/mdast@4.0.4':
+    resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
+  '@types/mdx@2.0.14':
+    resolution: {integrity: sha512-T48PeuJtvLosNTPVhfnIp3i/n3a4g4Bad7YCq5k64D4u7NwDrAotikQ+5+sjtUvBmxCMlbo3dVL+C2dP0rWHzg==}
+
+  '@types/ms@2.1.0':
+    resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
+
+  '@types/nlcst@2.0.3':
+    resolution: {integrity: sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==}
+
+  '@types/node@24.19.2':
+    resolution: {integrity: sha512-93d49wCWJkCyN87MxLpNN6KXPCwFw7bVUg79mGUV1OS40JGWwVCr8n61DXCSqz7CV6/VfPkb7xec7uP2M+QHWQ==}
+
+  '@types/sax@1.2.7':
+    resolution: {integrity: sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==}
+
+  '@types/unist@2.0.11':
+    resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
+
+  '@types/unist@3.0.3':
+    resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
+  '@ungap/structured-clone@1.4.0':
+    resolution: {integrity: sha512-1mEZtMKPM09vDmQt5y7YvmN2+DFTP7Tg0EWXdic8/C6VRnpb33e4ghisCIE3WZjsE2N8mf+QV1Zqh7ZFYLWInQ==}
+
+  acorn-jsx@5.3.2:
+    resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==}
+    peerDependencies:
+      acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  acorn@8.19.0:
+    resolution: {integrity: sha512-oJlA3XiRm7Cyk6qFD2Jn8ak9B7jSy0qy00ADO3+8dpT0LSjFihQYv4C02LFCSYJV3Q37xYwwRy5m+IpIiUzqWw==}
+    engines: {node: '>=0.4.0'}
+    hasBin: true
+
+  am-i-vibing@0.5.0:
+    resolution: {integrity: sha512-KLcsDhqf1XRrJmJr+9I/C0EX2K+sGrAGZFgkmd84c8TJO9zJBu+/kFInjazu1KfJWFhWDKdRWkpBzEs7s35DVA==}
+    hasBin: true
+
+  ansi-escapes@7.3.0:
+    resolution: {integrity: sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==}
+    engines: {node: '>=18'}
+
+  anymatch@3.1.3:
+    resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==}
+    engines: {node: '>= 8'}
+
+  arg@5.0.2:
+    resolution: {integrity: sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==}
+
+  argparse@2.0.1:
+    resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
+
+  aria-query@5.3.2:
+    resolution: {integrity: sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==}
+    engines: {node: '>= 0.4'}
+
+  array-iterate@2.0.1:
+    resolution: {integrity: sha512-I1jXZMjAgCMmxT4qxXfPXa6SthSoE8h6gkSI9BGGNv8mP8G/v0blc+qFnZu6K42vTOiuME596QaLO0TP3Lk0xg==}
+
+  astring@1.9.0:
+    resolution: {integrity: sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==}
+    hasBin: true
+
+  astro-expressive-code@0.44.2:
+    resolution: {integrity: sha512-avop7nZcRwC7quvIxVguhwEZ9Tp6IoTzKUCLwP30Fb7+er+pWQgcysP01dcuzRIJo81kLGg30q/YAI2Yb1Sdzg==}
+    peerDependencies:
+      astro: ^4.0.0-beta || ^5.0.0-beta || ^3.3.0 || ^6.0.0-beta || ^7.0.0
+
+  astro@7.4.1:
+    resolution: {integrity: sha512-mzWNEWSef1VQDgFku6Gp0v8Qx53NOkNlOIDQcX9ovxAZ1QXic6cks/FFo+gxPM9anXuat4X1FhB61KTk3XFvgg==}
+    engines: {node: '>=22.22.0', npm: '>=9.6.5', pnpm: '>=7.1.0'}
+    hasBin: true
+    peerDependencies:
+      '@astrojs/markdown-remark': ^7.3.0
+    peerDependenciesMeta:
+      '@astrojs/markdown-remark':
+        optional: true
+
+  axobject-query@4.1.0:
+    resolution: {integrity: sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==}
+    engines: {node: '>= 0.4'}
+
+  bail@2.0.2:
+    resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
+
+  bcp-47-match@2.0.3:
+    resolution: {integrity: sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ==}
+
+  bcp-47@2.1.1:
+    resolution: {integrity: sha512-KLw+H/gd2p4zly1X7Yh/qziuyae5/w/QFnvTng9eZL5fvszL7Whl3MBoWF8yxL7ksUjBfOD+OxkytiqbBpG+Fw==}
+
+  blake3-wasm@2.1.5:
+    resolution: {integrity: sha512-F1+K8EbfOZE49dtoPtmxUQrpXaBIl3ICvasLh+nJta0xkz+9kF/7uet9fLnwKqhDrmj6g+6K3Tw9yQPUg2ka5g==}
+
+  boolbase@1.0.0:
+    resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==}
+
+  ccount@2.0.1:
+    resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==}
+
+  character-entities-html4@2.1.0:
+    resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
+
+  character-entities-legacy@3.0.0:
+    resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
+
+  character-entities@2.0.2:
+    resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==}
+
+  character-reference-invalid@2.0.1:
+    resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
+
+  chokidar@5.0.0:
+    resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==}
+    engines: {node: '>= 20.19.0'}
+
+  ci-info@4.4.0:
+    resolution: {integrity: sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==}
+    engines: {node: '>=8'}
+
+  clsx@2.1.1:
+    resolution: {integrity: sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==}
+    engines: {node: '>=6'}
+
+  collapse-white-space@2.1.0:
+    resolution: {integrity: sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==}
+
+  comma-separated-tokens@2.0.3:
+    resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
+
+  commander@11.1.0:
+    resolution: {integrity: sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==}
+    engines: {node: '>=16'}
+
+  common-ancestor-path@2.0.0:
+    resolution: {integrity: sha512-dnN3ibLeoRf2HNC+OlCiNc5d2zxbLJXOtiZUudNFSXZrNSydxcCsSpRzXwfu7BBWCIfHPw+xTayeBvJCP/D8Ng==}
+    engines: {node: '>= 18'}
+
+  cookie-es@1.2.3:
+    resolution: {integrity: sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==}
+
+  cookie@1.1.1:
+    resolution: {integrity: sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==}
+    engines: {node: '>=18'}
+
+  cookie@2.0.1:
+    resolution: {integrity: sha512-yuToqVvRrj6pfDXREyQAAv8SkAEk/8GS3jQRTiUMm66TVtBYmqQeoEjL2Lmq8Rpo6271vH76InTChTitEAm65w==}
+    engines: {node: '>=22'}
+
+  crossws@0.3.5:
+    resolution: {integrity: sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==}
+
+  css-select@6.0.0:
+    resolution: {integrity: sha512-rZZVSLle8v0+EY8QAkDWrKhpgt6SA5OtHsgBnsj6ZaLb5dmDVOWUDtQitd9ydxxvEjhewNudS6eTVU7uOyzvXw==}
+
+  css-selector-parser@3.3.0:
+    resolution: {integrity: sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g==}
+
+  css-tree@2.2.1:
+    resolution: {integrity: sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==}
+    engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'}
+
+  css-tree@3.2.1:
+    resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==}
+    engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0}
+
+  css-what@7.0.0:
+    resolution: {integrity: sha512-wD5oz5xibMOPHzy13CyGmogB3phdvcDaB5t0W/Nr5Z2O/agcB8YwOz6e2Lsp10pNDzBoDO9nVa3RGs/2BttpHQ==}
+    engines: {node: '>= 6'}
+
+  cssesc@3.0.0:
+    resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==}
+    engines: {node: '>=4'}
+    hasBin: true
+
+  csso@5.0.5:
+    resolution: {integrity: sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==}
+    engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'}
+
+  debug@4.4.3:
+    resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+
+  decode-named-character-reference@1.3.0:
+    resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
+
+  defu@6.1.7:
+    resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==}
+
+  dequal@2.0.3:
+    resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==}
+    engines: {node: '>=6'}
+
+  destr@2.0.5:
+    resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==}
+
+  detect-libc@2.1.2:
+    resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
+    engines: {node: '>=8'}
+
+  devalue@6.0.3:
+    resolution: {integrity: sha512-3woMEITftG1wKeO/4d/QXH1DVKctTSZg3jNGPpjp9hNr5Hos8MCFF5McTML5ZtgKDObm2R591B0spRp2IVernA==}
+    engines: {node: '>=18'}
+
+  devlop@1.1.0:
+    resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
+
+  diff@9.0.0:
+    resolution: {integrity: sha512-svtcdpS8CgJyqAjEQIXdb3OjhFVVYjzGAPO8WGCmRbrml64SPw/jJD4GoE98aR7r25A0XcgrK3F02yw9R/vhQw==}
+    engines: {node: '>=0.3.1'}
+
+  direction@2.0.1:
+    resolution: {integrity: sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA==}
+    hasBin: true
+
+  dom-serializer@2.0.0:
+    resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==}
+
+  domelementtype@2.3.0:
+    resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==}
+
+  domhandler@5.0.3:
+    resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==}
+    engines: {node: '>= 4'}
+
+  domutils@3.2.2:
+    resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==}
+
+  dset@3.1.4:
+    resolution: {integrity: sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==}
+    engines: {node: '>=4'}
+
+  entities@4.5.0:
+    resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
+    engines: {node: '>=0.12'}
+
+  entities@6.0.1:
+    resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+    engines: {node: '>=0.12'}
+
+  environment@1.1.0:
+    resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==}
+    engines: {node: '>=18'}
+
+  error-stack-parser-es@1.0.5:
+    resolution: {integrity: sha512-5qucVt2XcuGMcEGgWI7i+yZpmpByQ8J1lHhcL7PwqCwu9FPP3VUXzT4ltHe5i2z9dePwEHcDVOAfSnHsOlCXRA==}
+
+  es-module-lexer@3.0.4:
+    resolution: {integrity: sha512-BldNY5mwkVu+cQ5Ymn3e6hB9Sx8XHx4ZevWbiUyZbfKxJxYO27Hf0wfzkxIaD5CAJMaGl3YspKELj0ff/7nCMA==}
+
+  esast-util-from-estree@2.0.0:
+    resolution: {integrity: sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==}
+
+  esast-util-from-js@2.0.1:
+    resolution: {integrity: sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==}
+
+  esbuild@0.28.2:
+    resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  escape-string-regexp@5.0.0:
+    resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+    engines: {node: '>=12'}
+
+  estree-util-attach-comments@3.0.0:
+    resolution: {integrity: sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==}
+
+  estree-util-build-jsx@3.0.1:
+    resolution: {integrity: sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==}
+
+  estree-util-is-identifier-name@3.0.0:
+    resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
+
+  estree-util-scope@1.0.1:
+    resolution: {integrity: sha512-B0np3dcdxqILX5e9nEi5/Fr4K7gL4oYFVPV1zRa2e9wRCbQoZZNWOZFYyoInvXUPJXBXjss+QXlWLJChDEHDkA==}
+
+  estree-util-to-js@2.0.0:
+    resolution: {integrity: sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==}
+
+  estree-util-visit@2.0.0:
+    resolution: {integrity: sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==}
+
+  estree-walker@3.0.3:
+    resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
+
+  eventemitter3@5.0.4:
+    resolution: {integrity: sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==}
+
+  expressive-code@0.44.2:
+    resolution: {integrity: sha512-MLNghkvhyFgVW4oCD5DxBuYnnTXIf0PygzGmfT6OZeOOYWh/D4sH1j931biElkA5RG/J9wY/iuSMGAPF5vzHOg==}
+
+  extend@3.0.2:
+    resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
+
+  fast-string-truncated-width@3.0.3:
+    resolution: {integrity: sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==}
+
+  fast-string-width@3.0.2:
+    resolution: {integrity: sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==}
+
+  fast-wrap-ansi@0.2.2:
+    resolution: {integrity: sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==}
+
+  fdir@6.5.0:
+    resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
+    engines: {node: '>=12.0.0'}
+    peerDependencies:
+      picomatch: ^3 || ^4
+    peerDependenciesMeta:
+      picomatch:
+        optional: true
+
+  flattie@1.1.1:
+    resolution: {integrity: sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==}
+    engines: {node: '>=8'}
+
+  fnv1a-64@0.1.2:
+    resolution: {integrity: sha512-mJbcILTPybAR1jdOwt/lVv8N2cffeJFFP+gVbSAwLEx1ujXH27RpPd8Rokec/KX9c76UYIB6Co+H4lQzxPnJfA==}
+
+  fontace@0.4.1:
+    resolution: {integrity: sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw==}
+
+  fontkitten@1.0.3:
+    resolution: {integrity: sha512-Wp1zXWPVUPBmfoa3Cqc9ctaKuzKAV6uLstRqlR56kSjplf5uAce+qeyYym7F+PHbGTk+tCEdkCW6RD7DX/gBZw==}
+    engines: {node: '>=20'}
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  get-tsconfig@5.0.0-beta.6:
+    resolution: {integrity: sha512-X6fBC0pmImC70gvX2zm56go9hx0MyoGVdG0tUCkg/D+Xnh5TJsOZ7iDbOdI3PvmtrDxnu1YdDufpK2QJX1Meqw==}
+    engines: {node: '>=20.20.0'}
+
+  github-slugger@2.0.0:
+    resolution: {integrity: sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==}
+
+  h3@1.15.11:
+    resolution: {integrity: sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==}
+
+  has-flag@5.0.1:
+    resolution: {integrity: sha512-CsNUt5x9LUdx6hnk/E2SZLsDyvfqANZSUq4+D3D8RzDJ2M+HDTIkF60ibS1vHaK55vzgiZw1bEPFG9yH7l33wA==}
+    engines: {node: '>=12'}
+
+  hast-util-embedded@3.0.0:
+    resolution: {integrity: sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA==}
+
+  hast-util-format@1.1.0:
+    resolution: {integrity: sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==}
+
+  hast-util-from-html@2.0.3:
+    resolution: {integrity: sha512-CUSRHXyKjzHov8yKsQjGOElXy/3EKpyX56ELnkHH34vDVw1N1XSQ1ZcAvTyAPtGqLTuKP/uxM+aLkSPqF/EtMw==}
+
+  hast-util-from-parse5@8.0.3:
+    resolution: {integrity: sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==}
+
+  hast-util-has-property@3.0.0:
+    resolution: {integrity: sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==}
+
+  hast-util-is-body-ok-link@3.0.1:
+    resolution: {integrity: sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ==}
+
+  hast-util-is-element@3.0.0:
+    resolution: {integrity: sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==}
+
+  hast-util-minify-whitespace@1.0.1:
+    resolution: {integrity: sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw==}
+
+  hast-util-parse-selector@4.0.0:
+    resolution: {integrity: sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==}
+
+  hast-util-phrasing@3.0.1:
+    resolution: {integrity: sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ==}
+
+  hast-util-raw@9.1.0:
+    resolution: {integrity: sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==}
+
+  hast-util-select@6.0.4:
+    resolution: {integrity: sha512-RqGS1ZgI0MwxLaKLDxjprynNzINEkRHY2i8ln4DDjgv9ZhcYVIHN9rlpiYsqtFwrgpYU361SyWDQcGNIBVu3lw==}
+
+  hast-util-to-estree@3.1.3:
+    resolution: {integrity: sha512-48+B/rJWAp0jamNbAAf9M7Uf//UVqAoMmgXhBdxTDJLGKY+LRnZ99qcG+Qjl5HfMpYNzS5v4EAwVEF34LeAj7w==}
+
+  hast-util-to-html@9.0.5:
+    resolution: {integrity: sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==}
+
+  hast-util-to-jsx-runtime@2.3.6:
+    resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==}
+
+  hast-util-to-parse5@8.0.1:
+    resolution: {integrity: sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==}
+
+  hast-util-to-string@3.0.1:
+    resolution: {integrity: sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==}
+
+  hast-util-to-text@4.0.2:
+    resolution: {integrity: sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==}
+
+  hast-util-whitespace@3.0.0:
+    resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
+
+  hastscript@9.0.1:
+    resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==}
+
+  html-escaper@3.0.3:
+    resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==}
+
+  html-void-elements@3.0.0:
+    resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
+
+  html-whitespace-sensitive-tag-names@3.0.1:
+    resolution: {integrity: sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA==}
+
+  http-cache-semantics@4.3.0:
+    resolution: {integrity: sha512-M5t5LlJpS1UHMjvwRQVdFHvPISGeLAxNcrWuJkeGh0KxsqCHZ1O3NXZU/8x7cD0BDcGW8kapxMKTvwlqrNkHkA==}
+
+  i18next@26.5.3:
+    resolution: {integrity: sha512-6pRwOwJ6lBCBB66fqNZaSoUmvsALHMord7FL6GsDhubT1CrPabTMEJIqddm0nn2YEbKofdI/3VAtGrQPuztY1Q==}
+    peerDependencies:
+      typescript: ^5 || ^6 || ^7
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  inline-style-parser@0.2.7:
+    resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==}
+
+  iron-webcrypto@1.2.1:
+    resolution: {integrity: sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==}
+
+  is-absolute-url@5.0.0:
+    resolution: {integrity: sha512-sdJyNpBnQHuVnBunfzjAecOhZr2+A30ywfFvu3EnxtKLUWfwGgyWUmqHbGZiU6vTfHpCPm5GvLe4BAvlU9n8VQ==}
+    engines: {node: '>=20'}
+
+  is-alphabetical@2.0.1:
+    resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
+
+  is-alphanumerical@2.0.1:
+    resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
+
+  is-decimal@2.0.1:
+    resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
+  is-docker@4.0.0:
+    resolution: {integrity: sha512-LHE+wROyG/Y/0ZnbktRCoTix2c1RhgWaZraMZ8o1Q7zCh0VSrICJQO5oqIIISrcSBtrXv0o233w1IYwsWCjTzA==}
+    engines: {node: '>=20'}
+    hasBin: true
+
+  is-hexadecimal@2.0.1:
+    resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
+
+  is-plain-obj@4.1.0:
+    resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==}
+    engines: {node: '>=12'}
+
+  js-yaml@4.3.2:
+    resolution: {integrity: sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==}
+    hasBin: true
+
+  jsonc-parser@3.3.1:
+    resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==}
+
+  kleur@4.1.5:
+    resolution: {integrity: sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==}
+    engines: {node: '>=6'}
+
+  klona@2.0.6:
+    resolution: {integrity: sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==}
+    engines: {node: '>= 8'}
+
+  lightningcss-android-arm64@1.33.0:
+    resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [android]
+
+  lightningcss-darwin-arm64@1.33.0:
+    resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [darwin]
+
+  lightningcss-darwin-x64@1.33.0:
+    resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [darwin]
+
+  lightningcss-freebsd-x64@1.33.0:
+    resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [freebsd]
+
+  lightningcss-linux-arm-gnueabihf@1.33.0:
+    resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm]
+    os: [linux]
+
+  lightningcss-linux-arm64-gnu@1.33.0:
+    resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  lightningcss-linux-arm64-musl@1.33.0:
+    resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  lightningcss-linux-x64-gnu@1.33.0:
+    resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  lightningcss-linux-x64-musl@1.33.0:
+    resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  lightningcss-win32-arm64-msvc@1.33.0:
+    resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [win32]
+
+  lightningcss-win32-x64-msvc@1.33.0:
+    resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [win32]
+
+  lightningcss@1.33.0:
+    resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==}
+    engines: {node: '>= 12.0.0'}
+
+  longest-streak@3.1.0:
+    resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==}
+
+  lru-cache@11.5.3:
+    resolution: {integrity: sha512-U4N8FgzmWxc8k1VH8Kr6lQg18U7Fjvby6wXHVRX/ZZ7IwWbRMgrRbP0Wrb5q5NVinryp4SQampHKdvtecItxUg==}
+    engines: {node: 20 || >=22}
+
+  lucode-starlight@1.0.0:
+    resolution: {integrity: sha512-VOWIUFZnbfdXm45MbjnbJ79KlKqcNr66ADpb67meesw6lUZOKDjpkzF8Gb4oZE8gY8UhS1d2qRzDN7KBRqzmIA==}
+    peerDependencies:
+      '@astrojs/starlight': '>=0.41.4'
+
+  magic-string@1.4.3:
+    resolution: {integrity: sha512-z12OxmaPGE0F4xlpGdjuAUckipLpQlTAuAmyGhNoD7ODpYUzvDfvtxUbjM/jwznyP178oju/KDdyi220wNJ0RQ==}
+
+  magicast@0.5.5:
+    resolution: {integrity: sha512-UicdXN8zQ3JHlxVq+28afMXPr1z7WNY6+7EJnzTdQWkTAlMLF5fNCCKxJHBQwGaNGR11581EiQmQzx73+MvszA==}
+
+  markdown-extensions@2.0.0:
+    resolution: {integrity: sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==}
+    engines: {node: '>=16'}
+
+  markdown-table@3.0.4:
+    resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
+
+  marked@18.1.1:
+    resolution: {integrity: sha512-zEGgrtUG8crk+TrMacJSVABU4DYDDkS8uqgU3ohrn/2fW9C2AEfUrO3m6IhpIpQpl7YcVpiXXC9cSMWDANT3dg==}
+    engines: {node: '>= 20'}
+    hasBin: true
+
+  mdast-util-definitions@6.0.0:
+    resolution: {integrity: sha512-scTllyX6pnYNZH/AIp/0ePz6s4cZtARxImwoPJ7kS42n+MnVsI4XbnG6d4ibehRIldYMWM2LD7ImQblVhUejVQ==}
+
+  mdast-util-directive@3.1.1:
+    resolution: {integrity: sha512-Gqpa3MHorXYEZ0VfbroyvBlVKUfz371V6mIERqOYMcb0W1D3LwmFq1ZW4O2TDrbn+4ZmGLwMWeFRJgYZ+bc5fQ==}
+
+  mdast-util-find-and-replace@3.0.3:
+    resolution: {integrity: sha512-xPgpDNl0/OXHsI7TlaIs22lWnH3KlpvZdXG1ET/m/YT2Hhdkx8lJV4kLphE6l9simyM4KPDFBwas08BgEob6Jw==}
+
+  mdast-util-from-markdown@2.1.0:
+    resolution: {integrity: sha512-KRLgmPaP2H1ul2bpoJkOS+9pAcDAAj9Nu1mqLnh8NLeJG5tlvj42TH80PIGBpROWlRXLk0lDrWNuZCFy/tsB4A==}
+
+  mdast-util-gfm-autolink-literal@2.0.1:
+    resolution: {integrity: sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==}
+
+  mdast-util-gfm-footnote@2.1.0:
+    resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==}
+
+  mdast-util-gfm-strikethrough@2.0.1:
+    resolution: {integrity: sha512-OuJHqvr455pwu2OaOrir7dbzqs4jlWKOtlu9L6GjcIjjQwNyw02VntQsr/Ek6/A13vgnXfUhBekWRUP1OkNivw==}
+
+  mdast-util-gfm-table@2.0.0:
+    resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==}
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==}
+
+  mdast-util-gfm@3.1.0:
+    resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==}
+
+  mdast-util-mdx-expression@2.0.1:
+    resolution: {integrity: sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==}
+
+  mdast-util-mdx-jsx@3.2.0:
+    resolution: {integrity: sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==}
+
+  mdast-util-mdx@3.0.0:
+    resolution: {integrity: sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==}
+
+  mdast-util-mdxjs-esm@2.0.1:
+    resolution: {integrity: sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==}
+
+  mdast-util-phrasing@4.1.0:
+    resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
+
+  mdast-util-to-hast@13.2.1:
+    resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
+
+  mdast-util-to-markdown@2.2.0:
+    resolution: {integrity: sha512-2Jn/ADrHFFyyniBMi0bncTbJqU78K3/TEYvzvwrWWzD9MYPUa/Gm4r3nOeKFQg/PDM5BsbDYdc8ackW4NTY6NA==}
+
+  mdast-util-to-string@4.0.0:
+    resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==}
+
+  mdn-data@2.0.28:
+    resolution: {integrity: sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==}
+
+  mdn-data@2.27.1:
+    resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==}
+
+  micromark-core-commonmark@2.0.4:
+    resolution: {integrity: sha512-wxEeE8v8XVvOrxn1TZj74qYhAtTQsSqufHVS3uNVyT1MupXxhyaHk8/9xDNPh9BmL77QNDgWTkZ3RsYHB2ry7w==}
+
+  micromark-extension-directive@4.0.0:
+    resolution: {integrity: sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==}
+
+  micromark-extension-gfm-autolink-literal@2.1.0:
+    resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==}
+
+  micromark-extension-gfm-footnote@2.1.0:
+    resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==}
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==}
+
+  micromark-extension-gfm-table@2.1.2:
+    resolution: {integrity: sha512-pRzm4kDTu0MjlmBkxmS9yYhw60nncfcEwu9NNdPFSQEFXS95ZKyIIyTSHu/o3ReBUrLKYEq+7YaXCRn/bPB4MA==}
+
+  micromark-extension-gfm-tagfilter@2.0.0:
+    resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==}
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==}
+
+  micromark-extension-gfm@3.0.0:
+    resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==}
+
+  micromark-extension-mdx-expression@3.0.1:
+    resolution: {integrity: sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==}
+
+  micromark-extension-mdx-jsx@3.0.2:
+    resolution: {integrity: sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==}
+
+  micromark-extension-mdx-md@2.0.0:
+    resolution: {integrity: sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==}
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    resolution: {integrity: sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==}
+
+  micromark-extension-mdxjs@3.0.0:
+    resolution: {integrity: sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==}
+
+  micromark-factory-destination@2.0.1:
+    resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
+
+  micromark-factory-label@2.0.1:
+    resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
+
+  micromark-factory-mdx-expression@2.0.3:
+    resolution: {integrity: sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==}
+
+  micromark-factory-space@2.1.0:
+    resolution: {integrity: sha512-fS8hnLIjnjvdQIj39Geug8wWsR0HrYZ43KShKxNfwT7t2LOHo/LbWZEzEaSOjwtjdCsjoE6syHhonEzW0zv0+Q==}
+
+  micromark-factory-title@2.0.1:
+    resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==}
+
+  micromark-factory-whitespace@2.0.1:
+    resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==}
+
+  micromark-util-character@2.1.1:
+    resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==}
+
+  micromark-util-chunked@2.0.1:
+    resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==}
+
+  micromark-util-classify-character@2.0.1:
+    resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==}
+
+  micromark-util-combine-extensions@2.0.1:
+    resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==}
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==}
+
+  micromark-util-decode-string@2.0.1:
+    resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==}
+
+  micromark-util-edit-map@1.0.0:
+    resolution: {integrity: sha512-Pa2ljlsEL6sVwFaYeyrOLSYbQt73JvGbPOYFq+9AElXiSnfI5Q4465RRZ1sHv7lDjDOnGRDDaqPXqClqWK/q1Q==}
+
+  micromark-util-encode@2.0.1:
+    resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
+
+  micromark-util-events-to-acorn@2.0.3:
+    resolution: {integrity: sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==}
+
+  micromark-util-html-tag-name@2.0.1:
+    resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
+
+  micromark-util-normalize-identifier@2.0.1:
+    resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==}
+
+  micromark-util-resolve-all@2.0.1:
+    resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==}
+
+  micromark-util-sanitize-uri@2.0.1:
+    resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==}
+
+  micromark-util-subtokenize@2.1.0:
+    resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==}
+
+  micromark-util-symbol@2.0.1:
+    resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==}
+
+  micromark-util-types@2.0.3:
+    resolution: {integrity: sha512-oxB2Ik03hI0gv+VNn9tnh1t1YEe9MDPptViAEgfdf3YQHsn0pzGTgCdlSCJXcwhqm8phaEuM7zeEu3QQzVBrPg==}
+
+  micromark@4.0.3:
+    resolution: {integrity: sha512-oGYfQzHSG5dOMovQcJ3fyTmZlWAWpi0XA0sJwJs+i6OT88o1+Jtw/8z0CmdowSLxGhhFK89rQ/oXph/wN02PNw==}
+
+  miniflare@5.20261019.0-beta:
+    resolution: {integrity: sha512-NmE6Yz7MSdjrfr3lMaMAVO55rIm3+6YXllOkJOMy6pPQITDuDeo0PYRedp7pju2olNWmrAlf1i1LIWYfGQvvuw==}
+    engines: {node: '>=22.0.0'}
+
+  mrmime@2.0.1:
+    resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
+    engines: {node: '>=10'}
+
+  ms@2.1.3:
+    resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+
+  nanoid@3.3.20:
+    resolution: {integrity: sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==}
+    engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+    hasBin: true
+
+  neotraverse@1.0.1:
+    resolution: {integrity: sha512-WmmLty1YWwJl9yZi77v2dVIV6X2kuYV8YYBI/G3LWGKdGHmHUvL1z7FW0iDvEvGAwNEoc5x1tOOOyDnf5jJw/w==}
+    engines: {node: '>= 10'}
+
+  nlcst-to-string@4.0.0:
+    resolution: {integrity: sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==}
+
+  node-fetch-native@1.6.7:
+    resolution: {integrity: sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==}
+
+  node-mock-http@1.0.5:
+    resolution: {integrity: sha512-KQyt/wLjG3TAc7DOUhpqWzgd4ERxR80JOlTK5VE5R1S12IaPVN5qkj4klBce9HPG1Njuup4Sb5bljaT34lIyjw==}
+
+  normalize-path@3.0.0:
+    resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
+    engines: {node: '>=0.10.0'}
+
+  nth-check@2.1.1:
+    resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==}
+
+  obug@3.0.0:
+    resolution: {integrity: sha512-5vvB5+W7ePv+p3uqxi+RcW1XAzLW0/hxt3/4X4Lc4qHudzOhmBiBwOY6DRob4WnanAEGvNcLjF+KNOufrUoEQw==}
+    engines: {node: '>=12.20.0'}
+
+  ofetch@1.5.1:
+    resolution: {integrity: sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==}
+
+  oniguruma-parser@0.12.2:
+    resolution: {integrity: sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==}
+
+  oniguruma-to-es@4.3.6:
+    resolution: {integrity: sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==}
+
+  p-limit@7.3.3:
+    resolution: {integrity: sha512-SKgVvDU5TNIxQ4r30U75BNLC6a+6GOEjngrk/ysM5+Zu3oJuk1SC5ApzIzY/7PjCEjoVPMWJ0zho/4QUiEB7TQ==}
+    engines: {node: '>=20'}
+
+  p-queue@9.3.5:
+    resolution: {integrity: sha512-Lki/zhXFVmDhesBUn/yHRLW9Bte7mE7xoFHzTR8sIomV7a2z+LxYAPkGvdfidNiu4fKSfjtawixxSHcZci5QcQ==}
+    engines: {node: '>=20'}
+
+  p-timeout@7.0.2:
+    resolution: {integrity: sha512-prbX4Z3YszrFNgH+MW5Zoeq3baXrMtP/MQnFeET90UB/GtGcGDQ5Usg9OCy6ETjTTntOw1SL2z9fMPUppN3Guw==}
+    engines: {node: '>=20'}
+
+  package-manager-detector@1.9.0:
+    resolution: {integrity: sha512-zAMfbta9nPA8AKkA4WdmNAT8R8s6Dk0/xwPsqNnRidMFcLo1YkLuPDTgs2f64XdzS8vbLNnoJ+uUIkgbz7oRHA==}
+
+  pagefind@1.5.2:
+    resolution: {integrity: sha512-XTUaK0hXMCu2jszWE584JGQT7y284TmMV9l/HX3rnG5uo3rHI/uHU56XTyyyPFjeWEBxECbAi0CaFDJOONtG0Q==}
+    hasBin: true
+
+  parse-entities@4.0.2:
+    resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
+
+  parse-latin@7.0.0:
+    resolution: {integrity: sha512-mhHgobPPua5kZ98EF4HWiH167JWBfl4pvAIXXdbaVohtK7a6YBOy56kvhCqduqyo/f3yrHFWmqmiMg/BkBkYYQ==}
+
+  parse5@7.3.0:
+    resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+
+  path-to-regexp@6.3.0:
+    resolution: {integrity: sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==}
+
+  pathe@2.0.3:
+    resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
+
+  piccolore@0.1.3:
+    resolution: {integrity: sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==}
+
+  picocolors@1.1.1:
+    resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
+
+  picomatch@2.3.2:
+    resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==}
+    engines: {node: '>=8.6'}
+
+  picomatch@4.0.7:
+    resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==}
+    engines: {node: '>=12'}
+
+  postcss-nested@6.2.0:
+    resolution: {integrity: sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==}
+    engines: {node: '>=12.0'}
+    peerDependencies:
+      postcss: ^8.2.14
+
+  postcss-selector-parser@6.1.5:
+    resolution: {integrity: sha512-TEHFzb5KRDKaOgJ4TYE+0jyJtFbjLvkdVOu0fZ2b6MTWzoqZd4Le+61aEppWkvTlYePgOX4ATL1wsAIPMLTw6Q==}
+    engines: {node: '>=4'}
+
+  postcss@8.5.31:
+    resolution: {integrity: sha512-YUbWYCgErwnMAVkjUnYa+KlMBzGpHwiIt/DE7f0G33AuX2LH9UcTk6KgWxd3zRU+pN3u/C+Xl3EnMLM4Hea7Sg==}
+    engines: {node: ^10 || ^12 || >=14}
+
+  prismjs@1.30.0:
+    resolution: {integrity: sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==}
+    engines: {node: '>=6'}
+
+  process-ancestry@0.1.0:
+    resolution: {integrity: sha512-tGqJW/UnclpYASFcM6Xh8D8l/BMtaQ9+CSG0vlJSJTcdMM4lDRv4c6H0Pdcsfted+bVczdYSfk2fdukg2gQkZg==}
+    engines: {node: '>=18.0.0'}
+
+  property-information@7.2.0:
+    resolution: {integrity: sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==}
+
+  radix3@1.1.2:
+    resolution: {integrity: sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==}
+
+  readdirp@5.1.1:
+    resolution: {integrity: sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==}
+    engines: {node: '>= 20.19.0'}
+
+  recma-build-jsx@1.0.0:
+    resolution: {integrity: sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==}
+
+  recma-jsx@1.0.1:
+    resolution: {integrity: sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==}
+    peerDependencies:
+      acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  recma-parse@1.0.0:
+    resolution: {integrity: sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==}
+
+  recma-stringify@1.0.0:
+    resolution: {integrity: sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==}
+
+  regex-recursion@6.0.2:
+    resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==}
+
+  regex-utilities@2.3.0:
+    resolution: {integrity: sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==}
+
+  regex@6.1.0:
+    resolution: {integrity: sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==}
+
+  rehype-expressive-code@0.44.2:
+    resolution: {integrity: sha512-jvjQpsfWKBquDrEl5YQA3CJybRRIuDOYsui1BJTs5oKDUK8pPkJSSxY8FjxNlIFIdtgrTjC1zuahuY4Cc1j9SQ==}
+
+  rehype-raw@7.0.0:
+    resolution: {integrity: sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==}
+
+  rehype-recma@1.0.0:
+    resolution: {integrity: sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==}
+
+  rehype-stringify@10.0.1:
+    resolution: {integrity: sha512-k9ecfXHmIPuFVI61B9DeLPN0qFHfawM6RsuX48hoqlaKSF61RskNjSm1lI8PhBEM0MRdLxVVm4WmTqJQccH9mA==}
+
+  remark-directive@4.0.0:
+    resolution: {integrity: sha512-7sxn4RfF1o3izevPV1DheyGDD6X4c9hrGpfdUpm7uC++dqrnJxIZVkk7CoKqcLm0VUMAuOol7Mno3m6g8cfMuA==}
+
+  remark-gfm@4.0.1:
+    resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
+
+  remark-mdx@3.1.1:
+    resolution: {integrity: sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==}
+
+  remark-parse@11.0.0:
+    resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
+
+  remark-rehype@11.1.2:
+    resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==}
+
+  remark-smartypants@3.0.3:
+    resolution: {integrity: sha512-gCaK+ndZ0hYezlqFegHFCVh2CQemsi0Npdh1qVM9bxlUFknjkbP6VmojWhddOCrbK0PbbacmYLWfTULRiT1eWA==}
+    engines: {node: '>=16.0.0'}
+
+  remark-stringify@11.0.0:
+    resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==}
+
+  resolve-pkg-maps@1.0.0:
+    resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
+  retext-latin@4.0.0:
+    resolution: {integrity: sha512-hv9woG7Fy0M9IlRQloq/N6atV82NxLGveq+3H2WOi79dtIYWN8OaxogDm77f8YnVXJL2VD3bbqowu5E3EMhBYA==}
+
+  retext-smartypants@6.2.0:
+    resolution: {integrity: sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==}
+
+  retext-stringify@4.0.0:
+    resolution: {integrity: sha512-rtfN/0o8kL1e+78+uxPTqu1Klt0yPzKuQ2BfWwwfgIUSayyzxpM1PJzkKt4V8803uB9qSy32MvI7Xep9khTpiA==}
+
+  retext@9.0.0:
+    resolution: {integrity: sha512-sbMDcpHCNjvlheSgMfEcVrZko3cDzdbe1x/e7G66dFp0Ff7Mldvi2uv6JkJQzdRcvLYE8CA8Oe8siQx8ZOgTcA==}
+
+  rolldown@1.2.14:
+    resolution: {integrity: sha512-eTBTTqMR6uHKLgcUqpJP8ntzDI6V4LYA8negAMBEI7gkgVvOdrx6VsvS2Ym+83KhOPdLCHWJu0w7UQFJZhHKNw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    hasBin: true
+
+  satteri@0.10.5:
+    resolution: {integrity: sha512-Ao1LKpAEa9Wdg0otgbVKViZHEq9ebdXe4DMrp3s9vQAU0HNIuHnFEuMuOcm0ZIXyV0Yzxj91NvhLpvXZJO/5ZQ==}
+
+  sax@1.6.1:
+    resolution: {integrity: sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==}
+    engines: {node: '>=11.0.0'}
+
+  semver@7.8.5:
+    resolution: {integrity: sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==}
+    engines: {node: '>=10'}
+    hasBin: true
+
+  sharp@0.35.5:
+    resolution: {integrity: sha512-Ywn4OnzGukp7CDMrp08RQ50YKmuwG47brZgIVPTvBaaAfQlRlygrRqSrxdCiL9M+LlzLBiJ68IR1QqvzHyjC7g==}
+    engines: {node: '>=20.9.0'}
+    peerDependencies:
+      '@types/node': '*'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  shiki@4.5.0:
+    resolution: {integrity: sha512-OcRW72ngQvc+MSVWBRIovC/BTW589iUE/Vxav7VeM4RcY9MUjqB+IR6ILG1k9nuW6LiG/nct9uma4/MBtnZbmQ==}
+    engines: {node: '>=20'}
+
+  sisteransi@1.0.5:
+    resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==}
+
+  sitemap@9.0.1:
+    resolution: {integrity: sha512-S6hzjGJSG3d6if0YoF5kTyeRJvia6FSTBroE5fQ0bu1QNxyJqhhinfUsXi9fH3MgtXODWvwo2BDyQSnhPQ88uQ==}
+    engines: {node: '>=20.19.5', npm: '>=10.8.2'}
+    hasBin: true
+
+  smol-toml@1.9.1:
+    resolution: {integrity: sha512-j7WyPdf0CJoutMzMoPLF/bVXHtKZIT9Rb4eGeEbWw8X2t5oirjPgpL+OpaENZrILYaXqYwnVH+qgUwVbl+pUJQ==}
+    engines: {node: '>= 18'}
+
+  source-map-js@1.2.2:
+    resolution: {integrity: sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==}
+    engines: {node: '>=0.10.0'}
+
+  source-map@0.7.6:
+    resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
+    engines: {node: '>= 12'}
+
+  source-map@0.8.0:
+    resolution: {integrity: sha512-d8EqvL+k/SOXCreS/SUzg2ciyHqBBLcN/yuRjFsbvVhHTE2pgei7oAhmPM7kWFbkX6OSMQfUq4KbkF3au9lhYQ==}
+    engines: {node: '>= 12'}
+
+  space-separated-tokens@2.0.2:
+    resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
+
+  starlight-links-validator@0.27.0:
+    resolution: {integrity: sha512-UvPl8L9hfWR+yWbLOEtljLmpJCGcM6AVseVy5IO9dmqdOjW4R+Y8FaYyVA5axCC8RvxM5xU7M1WTerpwU8rYbw==}
+    peerDependencies:
+      '@astrojs/starlight': '>=0.42.0'
+      astro: '>=7.2.10'
+
+  std-env@4.3.0:
+    resolution: {integrity: sha512-OtU/EgQ1kIm5KwqQpBC6ZEMXrZRui11w8zgfTWp8cdO9B8OaPsbA8bTHO2P+HNo1VlUTGMVBwPhydu6poeXiag==}
+
+  stringify-entities@4.0.4:
+    resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
+
+  style-to-js@1.1.21:
+    resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==}
+
+  style-to-object@1.0.14:
+    resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
+
+  supports-color@10.2.2:
+    resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
+    engines: {node: '>=18'}
+
+  supports-hyperlinks@4.6.0:
+    resolution: {integrity: sha512-FL/q/YePS4tFFTNiBOR+zPk2ZrKheqNtmTJ/9OUZ4e1wKHJofDbGQSmSsxS0XNnabSkqexryCaXGvEKz1vf9UQ==}
+    engines: {node: '>=20'}
+
+  svgo@4.1.0:
+    resolution: {integrity: sha512-bkxnTg1kSU0guhIBmibA6UUhrQmPVA1XsQLN+ylCd+UWzbnLkySOcXpyk1mrl05f+pcaCx2eHb+sp6BgMZWX+Q==}
+    engines: {node: '>=16'}
+    hasBin: true
+
+  terminal-link@5.0.0:
+    resolution: {integrity: sha512-qFAy10MTMwjzjU8U16YS4YoZD+NQLHzLssFMNqgravjbvIPNiqkGFR4yjhJfmY9R5OFU7+yHxc6y+uGHkKwLRA==}
+    engines: {node: '>=20'}
+
+  tiny-inflate@1.0.3:
+    resolution: {integrity: sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==}
+
+  tinyclip@1.0.3:
+    resolution: {integrity: sha512-nTv2raKFMzGG6JJp0lpNDsRPdfFE6UHlu2rVEjXo8vkx1ZS3LW2CVXqIaLu8xZlu+6tbFs9V58Qc/Jmk/Ii7wA==}
+    engines: {node: ^16.14.0 || >= 17.3.0}
+
+  tinyexec@1.3.1:
+    resolution: {integrity: sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==}
+    engines: {node: '>=18'}
+
+  tinyglobby@0.2.17:
+    resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
+    engines: {node: '>=12.0.0'}
+
+  tinyps@0.5.0:
+    resolution: {integrity: sha512-Llu7nEtVOGHh7jok32l6+udlu+4Np5vsYVB7zeTK614coSsro2qjwte7MFt/ouLM/h4kXqbGXktSMMvMsttSDw==}
+
+  trim-lines@3.0.1:
+    resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
+
+  trough@2.2.0:
+    resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
+
+  tslib@2.8.1:
+    resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  ufo@1.6.4:
+    resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==}
+
+  ultrahtml@1.7.0:
+    resolution: {integrity: sha512-2xRd0VHoAQE4M+vF/DvFFB7pUV0ZxTW1TLi7lHQWnF/Sb5TPeEUV/l+hxcNnGO00ZXGnR0voCMmYRKQf+rvJ2g==}
+
+  uncrypto@0.1.3:
+    resolution: {integrity: sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==}
+
+  undici-types@7.24.6:
+    resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==}
+
+  undici@7.29.1:
+    resolution: {integrity: sha512-RYONW2MeafgYlkVOKYKkA/Ag7BmXqgIWCa8t1m0JcxrQg9pI9lEqRhAOruOBCbAohOa/gkCF+iPi9hrgvTzu6Q==}
+    engines: {node: '>=20.18.1'}
+
+  undici@8.12.3:
+    resolution: {integrity: sha512-+fdndUTwBP86cVjihTp21hZHo7d6oj1c/47XPA3lL8mM0XHs+C4EkcjmgRsFnFk2f/UONGDy9ItBItmXsLOQHw==}
+    engines: {node: '>=22.19.0'}
+
+  unenv@2.0.0-rc.24:
+    resolution: {integrity: sha512-i7qRCmY42zmCwnYlh9H2SvLEypEFGye5iRmEMKjcGi7zk9UquigRjFtTLz0TYqr0ZGLZhaMHl/foy1bZR+Cwlw==}
+
+  unified@11.0.5:
+    resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
+
+  unifont@1.0.3:
+    resolution: {integrity: sha512-XGnEwj5sWdCbiBX01mWLSBncS0yMRjnLygau3IfdOlfjMacNIQvTGW4VH7pWBq+gGWArfSef/CensMLjMmIr/A==}
+
+  unist-util-find-after@5.0.0:
+    resolution: {integrity: sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==}
+
+  unist-util-is@6.0.1:
+    resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
+
+  unist-util-modify-children@4.0.0:
+    resolution: {integrity: sha512-+tdN5fGNddvsQdIzUF3Xx82CU9sMM+fA0dLgR9vOmT0oPT2jH+P1nd5lSqfCfXAw+93NhcXNY2qqvTUtE4cQkw==}
+
+  unist-util-position-from-estree@2.0.0:
+    resolution: {integrity: sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==}
+
+  unist-util-position@5.0.0:
+    resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
+
+  unist-util-remove-position@5.0.0:
+    resolution: {integrity: sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==}
+
+  unist-util-stringify-position@4.0.0:
+    resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
+
+  unist-util-visit-children@3.0.0:
+    resolution: {integrity: sha512-RgmdTfSBOg04sdPcpTSD1jzoNBjt9a80/ZCzp5cI9n1qPzLZWF9YdvWGN2zmTumP1HWhXKdUWexjy/Wy/lJ7tA==}
+
+  unist-util-visit-parents@6.0.2:
+    resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
+
+  unist-util-visit@5.0.0:
+    resolution: {integrity: sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg==}
+
+  unist-util-visit@5.1.0:
+    resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
+
+  unstorage@1.17.6:
+    resolution: {integrity: sha512-gjKtcmn/KwZuJZO9o2sc0esAQnhmTw0LviDHwevTXbJMYs0dRTp8ZEEWXHU0vTpzbN3cA0yxlTeyXssMp3zDqw==}
+    peerDependencies:
+      '@azure/app-configuration': ^1.8.0
+      '@azure/cosmos': ^4.2.0
+      '@azure/data-tables': ^13.3.0
+      '@azure/identity': ^4.6.0
+      '@azure/keyvault-secrets': ^4.9.0
+      '@azure/storage-blob': ^12.26.0
+      '@capacitor/preferences': ^6 || ^7 || ^8
+      '@deno/kv': '>=0.9.0'
+      '@netlify/blobs': ^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0 || ^11.0.0
+      '@planetscale/database': ^1.19.0
+      '@upstash/redis': ^1.34.3
+      '@vercel/blob': '>=0.27.1'
+      '@vercel/functions': ^2.2.12 || ^3.0.0
+      '@vercel/kv': ^1 || ^2 || ^3
+      aws4fetch: ^1.0.20
+      db0: '>=0.2.1'
+      idb-keyval: ^6.2.1
+      ioredis: ^5.4.2
+      uploadthing: ^7.4.4
+    peerDependenciesMeta:
+      '@azure/app-configuration':
+        optional: true
+      '@azure/cosmos':
+        optional: true
+      '@azure/data-tables':
+        optional: true
+      '@azure/identity':
+        optional: true
+      '@azure/keyvault-secrets':
+        optional: true
+      '@azure/storage-blob':
+        optional: true
+      '@capacitor/preferences':
+        optional: true
+      '@deno/kv':
+        optional: true
+      '@netlify/blobs':
+        optional: true
+      '@planetscale/database':
+        optional: true
+      '@upstash/redis':
+        optional: true
+      '@vercel/blob':
+        optional: true
+      '@vercel/functions':
+        optional: true
+      '@vercel/kv':
+        optional: true
+      aws4fetch:
+        optional: true
+      db0:
+        optional: true
+      idb-keyval:
+        optional: true
+      ioredis:
+        optional: true
+      uploadthing:
+        optional: true
+
+  url-extras@0.1.0:
+    resolution: {integrity: sha512-8tzwTeXFPuX/5PHuCDQE5Dd9Ts4rwoq2t9aIT+HS4iAVpmj5l4Ao7Q+BuuFjvWRqrLswBhQDk8O96ZicgCqQqw==}
+    engines: {node: '>=20'}
+
+  util-deprecate@1.0.2:
+    resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
+
+  verkit@0.5.0:
+    resolution: {integrity: sha512-u4J1hr6Y+C/hit34GwL3eIcUf3wngT8TlYUjK7tk0jxydKLAq3sYvifjdTDA6U3KCKRcQCQDGf/srjxfZF3l7g==}
+    engines: {node: '>=18.12.0'}
+
+  vfile-location@5.0.3:
+    resolution: {integrity: sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==}
+
+  vfile-message@4.0.3:
+    resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+  vfile@6.0.3:
+    resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
+  vite@8.3.4:
+    resolution: {integrity: sha512-IftLE8phJhdNRIGNEV4JCCvfNScoZQVfcXaN8TQropWGJtOHcu+iAB9pHcuGvmEb/kddw0LBe/jS8ztdC6xdiQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    hasBin: true
+    peerDependencies:
+      '@types/node': ^20.19.0 || >=22.12.0
+      '@vitejs/devtools': ^0.7.1
+      esbuild: ^0.27.0 || ^0.28.0
+      jiti: '>=1.21.0'
+      less: ^4.0.0
+      sass: ^1.70.0
+      sass-embedded: ^1.70.0
+      stylus: '>=0.54.8'
+      sugarss: ^5.0.0
+      terser: ^5.16.0
+      tsx: ^4.8.1
+      yaml: ^2.4.2
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      '@vitejs/devtools':
+        optional: true
+      esbuild:
+        optional: true
+      jiti:
+        optional: true
+      less:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+      tsx:
+        optional: true
+      yaml:
+        optional: true
+
+  vitefu@1.1.3:
+    resolution: {integrity: sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==}
+    peerDependencies:
+      vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
+    peerDependenciesMeta:
+      vite:
+        optional: true
+
+  web-namespaces@2.0.1:
+    resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==}
+
+  workerd@1.20261019.1:
+    resolution: {integrity: sha512-UUYRUq/7DmeCl11YriNbcVbjUZVLtt8uuCXFu+nz77hGFf8d4DEVXoCYtnA+MlBatE4+wxoj47DVqzK3xGBAiw==}
+    engines: {node: '>=16'}
+    hasBin: true
+
+  wrangler@4.151.2:
+    resolution: {integrity: sha512-yIT5Q08eVP2ZSE4XHGZ81Y+Y1b25uzp7LANwV2siaEt/O7TpeiFiEih/xHwARHGQo8sufs2ZaILGxCccHgjQPg==}
+    engines: {node: '>=22.0.0'}
+    hasBin: true
+    peerDependencies:
+      '@cloudflare/workers-types': ^5.20261019.1
+    peerDependenciesMeta:
+      '@cloudflare/workers-types':
+        optional: true
+
+  ws@8.21.0:
+    resolution: {integrity: sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g==}
+    engines: {node: '>=10.0.0'}
+    peerDependencies:
+      bufferutil: ^4.0.1
+      utf-8-validate: '>=5.0.2'
+    peerDependenciesMeta:
+      bufferutil:
+        optional: true
+      utf-8-validate:
+        optional: true
+
+  xxhash-wasm@1.1.0:
+    resolution: {integrity: sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==}
+
+  yaml@2.9.1:
+    resolution: {integrity: sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==}
+    engines: {node: '>= 14.6'}
+    hasBin: true
+
+  yargs-parser@22.0.0:
+    resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==}
+    engines: {node: ^20.19.0 || ^22.12.0 || >=23}
+
+  yocto-queue@1.2.2:
+    resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==}
+    engines: {node: '>=12.20'}
+
+  youch-core@0.3.3:
+    resolution: {integrity: sha512-ho7XuGjLaJ2hWHoK8yFnsUGy2Y5uDpqSTq1FkHLK4/oqKtyUU1AFbOOxY4IpC9f0fTLjwYbslUz0Po5BpD1wrA==}
+
+  youch@4.1.0-beta.10:
+    resolution: {integrity: sha512-rLfVLB4FgQneDr0dv1oddCVZmKjcJ6yX6mS4pU82Mq/Dt9a3cLZQ62pDBL4AUO+uVrCvtWz3ZFUL2HFAFJ/BXQ==}
+
+  zod@4.6.7:
+    resolution: {integrity: sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==}
+
+  zwitch@2.0.4:
+    resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
+
+snapshots:
+
+  '@astrojs/compiler-binding-android-arm64@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-darwin-arm64@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-darwin-x64@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-linux-arm64-gnu@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-linux-arm64-musl@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-linux-x64-gnu@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-linux-x64-musl@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-wasm32-wasi@0.5.2':
+    dependencies:
+      '@emnapi/core': 1.11.3
+      '@emnapi/runtime': 1.11.3
+      '@napi-rs/wasm-runtime': 1.2.5(@emnapi/core@1.11.3)(@emnapi/runtime@1.11.3)
+    optional: true
+
+  '@astrojs/compiler-binding-win32-arm64-msvc@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding-win32-x64-msvc@0.5.2':
+    optional: true
+
+  '@astrojs/compiler-binding@0.5.2':
+    optionalDependencies:
+      '@astrojs/compiler-binding-android-arm64': 0.5.2
+      '@astrojs/compiler-binding-darwin-arm64': 0.5.2
+      '@astrojs/compiler-binding-darwin-x64': 0.5.2
+      '@astrojs/compiler-binding-linux-arm64-gnu': 0.5.2
+      '@astrojs/compiler-binding-linux-arm64-musl': 0.5.2
+      '@astrojs/compiler-binding-linux-x64-gnu': 0.5.2
+      '@astrojs/compiler-binding-linux-x64-musl': 0.5.2
+      '@astrojs/compiler-binding-wasm32-wasi': 0.5.2
+      '@astrojs/compiler-binding-win32-arm64-msvc': 0.5.2
+      '@astrojs/compiler-binding-win32-x64-msvc': 0.5.2
+
+  '@astrojs/compiler-rs@0.5.2':
+    dependencies:
+      '@astrojs/compiler-binding': 0.5.2
+
+  '@astrojs/internal-helpers@0.13.0':
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      picomatch: 4.0.7
+      retext-smartypants: 6.2.0
+      shiki: 4.5.0
+      smol-toml: 1.9.1
+      unified: 11.0.5
+      yaml: 2.9.1
+
+  '@astrojs/markdown-remark@7.3.3':
+    dependencies:
+      '@astrojs/internal-helpers': 0.13.0
+      '@astrojs/prism': 4.1.0
+      '@mdx-js/mdx': 3.1.1
+      acorn: 8.19.0
+      estree-util-visit: 2.0.0
+      github-slugger: 2.0.0
+      hast-util-from-html: 2.0.3
+      hast-util-to-html: 9.0.5
+      hast-util-to-text: 4.0.2
+      mdast-util-definitions: 6.0.0
+      rehype-raw: 7.0.0
+      rehype-stringify: 10.0.1
+      remark-gfm: 4.0.1
+      remark-parse: 11.0.0
+      remark-rehype: 11.1.2
+      remark-smartypants: 3.0.3
+      source-map: 0.8.0
+      unified: 11.0.5
+      unist-util-remove-position: 5.0.0
+      unist-util-visit: 5.1.0
+      unist-util-visit-parents: 6.0.2
+      vfile: 6.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@astrojs/markdown-satteri@0.4.4':
+    dependencies:
+      '@astrojs/internal-helpers': 0.13.0
+      '@astrojs/prism': 4.1.0
+      github-slugger: 2.0.0
+      satteri: 0.10.5
+
+  '@astrojs/mdx@8.1.0(@astrojs/markdown-remark@7.3.3)(@astrojs/markdown-satteri@0.4.4)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))':
+    dependencies:
+      '@astrojs/internal-helpers': 0.13.0
+      '@astrojs/markdown-satteri': 0.4.4
+      astro: 7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+      es-module-lexer: 3.0.4
+    optionalDependencies:
+      '@astrojs/markdown-remark': 7.3.3
+
+  '@astrojs/prism@4.1.0':
+    dependencies:
+      prismjs: 1.30.0
+
+  '@astrojs/sitemap@3.7.4':
+    dependencies:
+      sitemap: 9.0.1
+      zod: 4.6.7
+
+  '@astrojs/starlight@0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3)':
+    dependencies:
+      '@astrojs/markdown-satteri': 0.4.4
+      '@astrojs/mdx': 8.1.0(@astrojs/markdown-remark@7.3.3)(@astrojs/markdown-satteri@0.4.4)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))
+      '@astrojs/sitemap': 3.7.4
+      '@pagefind/default-ui': 1.5.2
+      '@types/hast': 3.0.5
+      '@types/js-yaml': 4.0.9
+      '@types/mdast': 4.0.4
+      astro: 7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+      astro-expressive-code: 0.44.2(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))
+      bcp-47: 2.1.1
+      hast-util-format: 1.1.0
+      hast-util-select: 6.0.4
+      hast-util-to-html: 9.0.5
+      hast-util-to-string: 3.0.1
+      hastscript: 9.0.1
+      i18next: 26.5.3(typescript@5.9.3)
+      js-yaml: 4.3.2
+      klona: 2.0.6
+      magic-string: 1.4.3
+      mdast-util-directive: 3.1.1
+      mdast-util-to-markdown: 2.2.0
+      mdast-util-to-string: 4.0.0
+      pagefind: 1.5.2
+      remark-directive: 4.0.0
+      satteri: 0.10.5
+      ultrahtml: 1.7.0
+      unified: 11.0.5
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+    optionalDependencies:
+      '@astrojs/markdown-remark': 7.3.3
+    transitivePeerDependencies:
+      - supports-color
+      - typescript
+
+  '@astrojs/telemetry@3.4.0':
+    dependencies:
+      ci-info: 4.4.0
+      dset: 3.1.4
+      is-docker: 4.0.0
+      package-manager-detector: 1.9.0
+
+  '@babel/helper-string-parser@7.29.7': {}
+
+  '@babel/helper-validator-identifier@7.29.7': {}
+
+  '@babel/parser@7.29.9':
+    dependencies:
+      '@babel/types': 7.29.8
+
+  '@babel/types@7.29.8':
+    dependencies:
+      '@babel/helper-string-parser': 7.29.7
+      '@babel/helper-validator-identifier': 7.29.7
+
+  '@bruits/satteri-darwin-arm64@0.10.5':
+    optional: true
+
+  '@bruits/satteri-darwin-x64@0.10.5':
+    optional: true
+
+  '@bruits/satteri-linux-arm64-gnu@0.10.5':
+    optional: true
+
+  '@bruits/satteri-linux-arm64-musl@0.10.5':
+    optional: true
+
+  '@bruits/satteri-linux-x64-gnu@0.10.5':
+    optional: true
+
+  '@bruits/satteri-linux-x64-musl@0.10.5':
+    optional: true
+
+  '@bruits/satteri-wasm32-wasi@0.10.5':
+    dependencies:
+      '@emnapi/core': 1.11.1
+      '@emnapi/runtime': 1.11.1
+      '@napi-rs/wasm-runtime': 1.2.5(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)
+    optional: true
+
+  '@bruits/satteri-win32-arm64-msvc@0.10.5':
+    optional: true
+
+  '@bruits/satteri-win32-x64-msvc@0.10.5':
+    optional: true
+
+  '@capsizecss/unpack@4.0.1':
+    dependencies:
+      fontkitten: 1.0.3
+
+  '@clack/core@1.5.1':
+    dependencies:
+      fast-wrap-ansi: 0.2.2
+      sisteransi: 1.0.5
+
+  '@clack/prompts@1.8.1':
+    dependencies:
+      '@clack/core': 1.5.1
+      fast-string-width: 3.0.2
+      fast-wrap-ansi: 0.2.2
+      sisteransi: 1.0.5
+
+  '@cloudflare/kv-asset-handler@0.5.0': {}
+
+  '@cloudflare/unenv-preset@2.16.2(unenv@2.0.0-rc.24)(workerd@1.20261019.1)':
+    dependencies:
+      unenv: 2.0.0-rc.24
+    optionalDependencies:
+      workerd: 1.20261019.1
+
+  '@cloudflare/workerd-darwin-64@1.20261019.1':
+    optional: true
+
+  '@cloudflare/workerd-darwin-arm64@1.20261019.1':
+    optional: true
+
+  '@cloudflare/workerd-linux-64@1.20261019.1':
+    optional: true
+
+  '@cloudflare/workerd-linux-arm64@1.20261019.1':
+    optional: true
+
+  '@cloudflare/workerd-windows-64@1.20261019.1':
+    optional: true
+
+  '@cspotcode/source-map-support@0.8.1':
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.9
+
+  '@ctrl/tinycolor@4.2.1': {}
+
+  '@emnapi/core@1.11.1':
+    dependencies:
+      '@emnapi/wasi-threads': 1.2.2
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/core@1.11.3':
+    dependencies:
+      '@emnapi/wasi-threads': 1.2.3
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/runtime@1.11.1':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/runtime@1.11.3':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/wasi-threads@1.2.2':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@emnapi/wasi-threads@1.2.3':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@esbuild/aix-ppc64@0.28.2':
+    optional: true
+
+  '@esbuild/android-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/android-arm@0.28.2':
+    optional: true
+
+  '@esbuild/android-x64@0.28.2':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/darwin-x64@0.28.2':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-arm@0.28.2':
+    optional: true
+
+  '@esbuild/linux-ia32@0.28.2':
+    optional: true
+
+  '@esbuild/linux-loong64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.28.2':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.28.2':
+    optional: true
+
+  '@esbuild/linux-s390x@0.28.2':
+    optional: true
+
+  '@esbuild/linux-x64@0.28.2':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.28.2':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.28.2':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/sunos-x64@0.28.2':
+    optional: true
+
+  '@esbuild/win32-arm64@0.28.2':
+    optional: true
+
+  '@esbuild/win32-ia32@0.28.2':
+    optional: true
+
+  '@esbuild/win32-x64@0.28.2':
+    optional: true
+
+  '@expressive-code/core@0.44.2':
+    dependencies:
+      '@ctrl/tinycolor': 4.2.1
+      hast-util-select: 6.0.4
+      hast-util-to-html: 9.0.5
+      hast-util-to-text: 4.0.2
+      hastscript: 9.0.1
+      postcss: 8.5.31
+      postcss-nested: 6.2.0(postcss@8.5.31)
+      unist-util-visit: 5.0.0
+      unist-util-visit-parents: 6.0.2
+
+  '@expressive-code/plugin-frames@0.44.2':
+    dependencies:
+      '@expressive-code/core': 0.44.2
+
+  '@expressive-code/plugin-shiki@0.44.2':
+    dependencies:
+      '@expressive-code/core': 0.44.2
+      shiki: 4.5.0
+
+  '@expressive-code/plugin-text-markers@0.44.2':
+    dependencies:
+      '@expressive-code/core': 0.44.2
+
+  '@img/colour@1.1.0': {}
+
+  '@img/sharp-darwin-arm64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-darwin-arm64': 1.3.4
+    optional: true
+
+  '@img/sharp-darwin-x64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-darwin-x64': 1.3.4
+    optional: true
+
+  '@img/sharp-freebsd-wasm32@0.35.5':
+    dependencies:
+      '@img/sharp-wasm32': 0.35.5
+    optional: true
+
+  '@img/sharp-libvips-darwin-arm64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-darwin-x64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linux-arm64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linux-arm@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linux-ppc64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linux-riscv64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linux-s390x@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linux-x64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linuxmusl-arm64@1.3.4':
+    optional: true
+
+  '@img/sharp-libvips-linuxmusl-x64@1.3.4':
+    optional: true
+
+  '@img/sharp-linux-arm64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linux-arm64': 1.3.4
+    optional: true
+
+  '@img/sharp-linux-arm@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linux-arm': 1.3.4
+    optional: true
+
+  '@img/sharp-linux-ppc64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linux-ppc64': 1.3.4
+    optional: true
+
+  '@img/sharp-linux-riscv64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linux-riscv64': 1.3.4
+    optional: true
+
+  '@img/sharp-linux-s390x@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linux-s390x': 1.3.4
+    optional: true
+
+  '@img/sharp-linux-x64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linux-x64': 1.3.4
+    optional: true
+
+  '@img/sharp-linuxmusl-arm64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linuxmusl-arm64': 1.3.4
+    optional: true
+
+  '@img/sharp-linuxmusl-x64@0.35.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linuxmusl-x64': 1.3.4
+    optional: true
+
+  '@img/sharp-wasm32@0.35.5':
+    dependencies:
+      '@emnapi/runtime': 1.11.3
+    optional: true
+
+  '@img/sharp-webcontainers-wasm32@0.35.5':
+    dependencies:
+      '@img/sharp-wasm32': 0.35.5
+    optional: true
+
+  '@img/sharp-win32-arm64@0.35.5':
+    optional: true
+
+  '@img/sharp-win32-ia32@0.35.5':
+    optional: true
+
+  '@img/sharp-win32-x64@0.35.5':
+    optional: true
+
+  '@jridgewell/resolve-uri@3.1.2': {}
+
+  '@jridgewell/sourcemap-codec@1.6.0': {}
+
+  '@jridgewell/trace-mapping@0.3.9':
+    dependencies:
+      '@jridgewell/resolve-uri': 3.1.2
+      '@jridgewell/sourcemap-codec': 1.6.0
+
+  '@mdx-js/mdx@3.1.1':
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdx': 2.0.14
+      acorn: 8.19.0
+      collapse-white-space: 2.1.0
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      estree-util-scope: 1.0.1
+      estree-walker: 3.0.3
+      hast-util-to-jsx-runtime: 2.3.6
+      markdown-extensions: 2.0.0
+      recma-build-jsx: 1.0.0
+      recma-jsx: 1.0.1(acorn@8.19.0)
+      recma-stringify: 1.0.0
+      rehype-recma: 1.0.0
+      remark-mdx: 3.1.1
+      remark-parse: 11.0.0
+      remark-rehype: 11.1.2
+      source-map: 0.7.6
+      unified: 11.0.5
+      unist-util-position-from-estree: 2.0.0
+      unist-util-stringify-position: 4.0.0
+      unist-util-visit: 5.0.0
+      vfile: 6.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@napi-rs/wasm-runtime@1.2.5(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)':
+    dependencies:
+      '@emnapi/core': 1.11.1
+      '@emnapi/runtime': 1.11.1
+      '@tybys/wasm-util': 0.10.4
+    optional: true
+
+  '@napi-rs/wasm-runtime@1.2.5(@emnapi/core@1.11.3)(@emnapi/runtime@1.11.3)':
+    dependencies:
+      '@emnapi/core': 1.11.3
+      '@emnapi/runtime': 1.11.3
+      '@tybys/wasm-util': 0.10.4
+    optional: true
+
+  '@oslojs/encoding@1.1.0': {}
+
+  '@oxc-project/types@0.154.0': {}
+
+  '@pagefind/darwin-arm64@1.5.2':
+    optional: true
+
+  '@pagefind/darwin-x64@1.5.2':
+    optional: true
+
+  '@pagefind/default-ui@1.5.2': {}
+
+  '@pagefind/freebsd-x64@1.5.2':
+    optional: true
+
+  '@pagefind/linux-arm64@1.5.2':
+    optional: true
+
+  '@pagefind/linux-x64@1.5.2':
+    optional: true
+
+  '@pagefind/windows-arm64@1.5.2':
+    optional: true
+
+  '@pagefind/windows-x64@1.5.2':
+    optional: true
+
+  '@poppinss/colors@4.1.6':
+    dependencies:
+      kleur: 4.1.5
+
+  '@poppinss/dumper@0.6.5':
+    dependencies:
+      '@poppinss/colors': 4.1.6
+      '@sindresorhus/is': 7.2.0
+      supports-color: 10.2.2
+
+  '@poppinss/exception@1.2.3': {}
+
+  '@rolldown/binding-android-arm-eabi@1.2.14':
+    optional: true
+
+  '@rolldown/binding-android-arm64@1.2.14':
+    optional: true
+
+  '@rolldown/binding-darwin-arm64@1.2.14':
+    optional: true
+
+  '@rolldown/binding-darwin-x64@1.2.14':
+    optional: true
+
+  '@rolldown/binding-freebsd-x64@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-arm64-gnu@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-arm64-musl@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-ppc64-gnu@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-s390x-gnu@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-x64-gnu@1.2.14':
+    optional: true
+
+  '@rolldown/binding-linux-x64-musl@1.2.14':
+    optional: true
+
+  '@rolldown/binding-openharmony-arm64@1.2.14':
+    optional: true
+
+  '@rolldown/binding-win32-arm64-msvc@1.2.14':
+    optional: true
+
+  '@rolldown/binding-win32-x64-msvc@1.2.14':
+    optional: true
+
+  '@rolldown/pluginutils@1.0.1': {}
+
+  '@shikijs/core@4.5.0':
+    dependencies:
+      '@shikijs/primitive': 4.5.0
+      '@shikijs/types': 4.5.0
+      '@shikijs/vscode-textmate': 10.1.0
+      '@types/hast': 3.0.5
+      hast-util-to-html: 9.0.5
+
+  '@shikijs/engine-javascript@4.5.0':
+    dependencies:
+      '@shikijs/types': 4.5.0
+      '@shikijs/vscode-textmate': 10.1.0
+      oniguruma-to-es: 4.3.6
+
+  '@shikijs/engine-oniguruma@4.5.0':
+    dependencies:
+      '@shikijs/types': 4.5.0
+      '@shikijs/vscode-textmate': 10.1.0
+
+  '@shikijs/langs@4.5.0':
+    dependencies:
+      '@shikijs/types': 4.5.0
+
+  '@shikijs/primitive@4.5.0':
+    dependencies:
+      '@shikijs/types': 4.5.0
+      '@shikijs/vscode-textmate': 10.1.0
+      '@types/hast': 3.0.5
+
+  '@shikijs/themes@4.5.0':
+    dependencies:
+      '@shikijs/types': 4.5.0
+
+  '@shikijs/types@4.5.0':
+    dependencies:
+      '@shikijs/vscode-textmate': 10.1.0
+      '@types/hast': 3.0.5
+
+  '@shikijs/vscode-textmate@10.1.0': {}
+
+  '@sindresorhus/is@7.2.0': {}
+
+  '@speed-highlight/core@1.2.24': {}
+
+  '@tybys/wasm-util@0.10.4':
+    dependencies:
+      tslib: 2.8.1
+    optional: true
+
+  '@types/debug@4.1.13':
+    dependencies:
+      '@types/ms': 2.1.0
+
+  '@types/estree-jsx@1.0.5':
+    dependencies:
+      '@types/estree': 1.0.9
+
+  '@types/estree@1.0.9': {}
+
+  '@types/hast@3.0.5':
+    dependencies:
+      '@types/unist': 3.0.3
+
+  '@types/js-yaml@4.0.9': {}
+
+  '@types/mdast@4.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
+  '@types/mdx@2.0.14': {}
+
+  '@types/ms@2.1.0': {}
+
+  '@types/nlcst@2.0.3':
+    dependencies:
+      '@types/unist': 3.0.3
+
+  '@types/node@24.19.2':
+    dependencies:
+      undici-types: 7.24.6
+
+  '@types/sax@1.2.7':
+    dependencies:
+      '@types/node': 24.19.2
+
+  '@types/unist@2.0.11': {}
+
+  '@types/unist@3.0.3': {}
+
+  '@ungap/structured-clone@1.4.0': {}
+
+  acorn-jsx@5.3.2(acorn@8.19.0):
+    dependencies:
+      acorn: 8.19.0
+
+  acorn@8.19.0: {}
+
+  am-i-vibing@0.5.0:
+    dependencies:
+      process-ancestry: 0.1.0
+
+  ansi-escapes@7.3.0:
+    dependencies:
+      environment: 1.1.0
+
+  anymatch@3.1.3:
+    dependencies:
+      normalize-path: 3.0.0
+      picomatch: 2.3.2
+
+  arg@5.0.2: {}
+
+  argparse@2.0.1: {}
+
+  aria-query@5.3.2: {}
+
+  array-iterate@2.0.1: {}
+
+  astring@1.9.0: {}
+
+  astro-expressive-code@0.44.2(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)):
+    dependencies:
+      astro: 7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+      rehype-expressive-code: 0.44.2
+      url-extras: 0.1.0
+
+  astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1):
+    dependencies:
+      '@astrojs/compiler-rs': 0.5.2
+      '@astrojs/internal-helpers': 0.13.0
+      '@astrojs/markdown-satteri': 0.4.4
+      '@astrojs/telemetry': 3.4.0
+      '@capsizecss/unpack': 4.0.1
+      '@clack/prompts': 1.8.1
+      '@oslojs/encoding': 1.1.0
+      am-i-vibing: 0.5.0
+      aria-query: 5.3.2
+      axobject-query: 4.1.0
+      ci-info: 4.4.0
+      clsx: 2.1.1
+      common-ancestor-path: 2.0.0
+      cookie: 2.0.1
+      devalue: 6.0.3
+      diff: 9.0.0
+      dset: 3.1.4
+      es-module-lexer: 3.0.4
+      flattie: 1.1.1
+      fontace: 0.4.1
+      get-tsconfig: 5.0.0-beta.6
+      github-slugger: 2.0.0
+      html-escaper: 3.0.3
+      http-cache-semantics: 4.3.0
+      jsonc-parser: 3.3.1
+      magic-string: 1.4.3
+      magicast: 0.5.5
+      mrmime: 2.0.1
+      neotraverse: 1.0.1
+      obug: 3.0.0
+      p-limit: 7.3.3
+      p-queue: 9.3.5
+      package-manager-detector: 1.9.0
+      piccolore: 0.1.3
+      picomatch: 4.0.7
+      rolldown: 1.2.14
+      shiki: 4.5.0
+      smol-toml: 1.9.1
+      svgo: 4.1.0
+      tinyclip: 1.0.3
+      tinyexec: 1.3.1
+      tinyglobby: 0.2.17
+      tinyps: 0.5.0
+      ultrahtml: 1.7.0
+      unifont: 1.0.3
+      unstorage: 1.17.6
+      verkit: 0.5.0
+      vite: 8.3.4(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+      vitefu: 1.1.3(vite@8.3.4(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))
+      xxhash-wasm: 1.1.0
+      yargs-parser: 22.0.0
+      zod: 4.6.7
+    optionalDependencies:
+      '@astrojs/markdown-remark': 7.3.3
+      sharp: 0.35.5(@types/node@24.19.2)
+    transitivePeerDependencies:
+      - '@azure/app-configuration'
+      - '@azure/cosmos'
+      - '@azure/data-tables'
+      - '@azure/identity'
+      - '@azure/keyvault-secrets'
+      - '@azure/storage-blob'
+      - '@capacitor/preferences'
+      - '@deno/kv'
+      - '@netlify/blobs'
+      - '@planetscale/database'
+      - '@types/node'
+      - '@upstash/redis'
+      - '@vercel/blob'
+      - '@vercel/functions'
+      - '@vercel/kv'
+      - '@vitejs/devtools'
+      - aws4fetch
+      - db0
+      - esbuild
+      - idb-keyval
+      - ioredis
+      - jiti
+      - less
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - terser
+      - tsx
+      - uploadthing
+      - yaml
+
+  axobject-query@4.1.0: {}
+
+  bail@2.0.2: {}
+
+  bcp-47-match@2.0.3: {}
+
+  bcp-47@2.1.1:
+    dependencies:
+      is-alphabetical: 2.0.1
+      is-alphanumerical: 2.0.1
+      is-decimal: 2.0.1
+
+  blake3-wasm@2.1.5: {}
+
+  boolbase@1.0.0: {}
+
+  ccount@2.0.1: {}
+
+  character-entities-html4@2.1.0: {}
+
+  character-entities-legacy@3.0.0: {}
+
+  character-entities@2.0.2: {}
+
+  character-reference-invalid@2.0.1: {}
+
+  chokidar@5.0.0:
+    dependencies:
+      readdirp: 5.1.1
+
+  ci-info@4.4.0: {}
+
+  clsx@2.1.1: {}
+
+  collapse-white-space@2.1.0: {}
+
+  comma-separated-tokens@2.0.3: {}
+
+  commander@11.1.0: {}
+
+  common-ancestor-path@2.0.0: {}
+
+  cookie-es@1.2.3: {}
+
+  cookie@1.1.1: {}
+
+  cookie@2.0.1: {}
+
+  crossws@0.3.5:
+    dependencies:
+      uncrypto: 0.1.3
+
+  css-select@6.0.0:
+    dependencies:
+      boolbase: 1.0.0
+      css-what: 7.0.0
+      domhandler: 5.0.3
+      domutils: 3.2.2
+      nth-check: 2.1.1
+
+  css-selector-parser@3.3.0: {}
+
+  css-tree@2.2.1:
+    dependencies:
+      mdn-data: 2.0.28
+      source-map-js: 1.2.2
+
+  css-tree@3.2.1:
+    dependencies:
+      mdn-data: 2.27.1
+      source-map-js: 1.2.2
+
+  css-what@7.0.0: {}
+
+  cssesc@3.0.0: {}
+
+  csso@5.0.5:
+    dependencies:
+      css-tree: 2.2.1
+
+  debug@4.4.3:
+    dependencies:
+      ms: 2.1.3
+
+  decode-named-character-reference@1.3.0:
+    dependencies:
+      character-entities: 2.0.2
+
+  defu@6.1.7: {}
+
+  dequal@2.0.3: {}
+
+  destr@2.0.5: {}
+
+  detect-libc@2.1.2: {}
+
+  devalue@6.0.3: {}
+
+  devlop@1.1.0:
+    dependencies:
+      dequal: 2.0.3
+
+  diff@9.0.0: {}
+
+  direction@2.0.1: {}
+
+  dom-serializer@2.0.0:
+    dependencies:
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+      entities: 4.5.0
+
+  domelementtype@2.3.0: {}
+
+  domhandler@5.0.3:
+    dependencies:
+      domelementtype: 2.3.0
+
+  domutils@3.2.2:
+    dependencies:
+      dom-serializer: 2.0.0
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+
+  dset@3.1.4: {}
+
+  entities@4.5.0: {}
+
+  entities@6.0.1: {}
+
+  environment@1.1.0: {}
+
+  error-stack-parser-es@1.0.5: {}
+
+  es-module-lexer@3.0.4: {}
+
+  esast-util-from-estree@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      unist-util-position-from-estree: 2.0.0
+
+  esast-util-from-js@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      acorn: 8.19.0
+      esast-util-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  esbuild@0.28.2:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.28.2
+      '@esbuild/android-arm': 0.28.2
+      '@esbuild/android-arm64': 0.28.2
+      '@esbuild/android-x64': 0.28.2
+      '@esbuild/darwin-arm64': 0.28.2
+      '@esbuild/darwin-x64': 0.28.2
+      '@esbuild/freebsd-arm64': 0.28.2
+      '@esbuild/freebsd-x64': 0.28.2
+      '@esbuild/linux-arm': 0.28.2
+      '@esbuild/linux-arm64': 0.28.2
+      '@esbuild/linux-ia32': 0.28.2
+      '@esbuild/linux-loong64': 0.28.2
+      '@esbuild/linux-mips64el': 0.28.2
+      '@esbuild/linux-ppc64': 0.28.2
+      '@esbuild/linux-riscv64': 0.28.2
+      '@esbuild/linux-s390x': 0.28.2
+      '@esbuild/linux-x64': 0.28.2
+      '@esbuild/netbsd-arm64': 0.28.2
+      '@esbuild/netbsd-x64': 0.28.2
+      '@esbuild/openbsd-arm64': 0.28.2
+      '@esbuild/openbsd-x64': 0.28.2
+      '@esbuild/openharmony-arm64': 0.28.2
+      '@esbuild/sunos-x64': 0.28.2
+      '@esbuild/win32-arm64': 0.28.2
+      '@esbuild/win32-ia32': 0.28.2
+      '@esbuild/win32-x64': 0.28.2
+
+  escape-string-regexp@5.0.0: {}
+
+  estree-util-attach-comments@3.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+
+  estree-util-build-jsx@3.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      estree-walker: 3.0.3
+
+  estree-util-is-identifier-name@3.0.0: {}
+
+  estree-util-scope@1.0.1:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+
+  estree-util-to-js@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      astring: 1.9.0
+      source-map: 0.7.6
+
+  estree-util-visit@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/unist': 3.0.3
+
+  estree-walker@3.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+
+  eventemitter3@5.0.4: {}
+
+  expressive-code@0.44.2:
+    dependencies:
+      '@expressive-code/core': 0.44.2
+      '@expressive-code/plugin-frames': 0.44.2
+      '@expressive-code/plugin-shiki': 0.44.2
+      '@expressive-code/plugin-text-markers': 0.44.2
+
+  extend@3.0.2: {}
+
+  fast-string-truncated-width@3.0.3: {}
+
+  fast-string-width@3.0.2:
+    dependencies:
+      fast-string-truncated-width: 3.0.3
+
+  fast-wrap-ansi@0.2.2:
+    dependencies:
+      fast-string-width: 3.0.2
+
+  fdir@6.5.0(picomatch@4.0.7):
+    optionalDependencies:
+      picomatch: 4.0.7
+
+  flattie@1.1.1: {}
+
+  fnv1a-64@0.1.2: {}
+
+  fontace@0.4.1:
+    dependencies:
+      fontkitten: 1.0.3
+
+  fontkitten@1.0.3:
+    dependencies:
+      tiny-inflate: 1.0.3
+
+  fsevents@2.3.3:
+    optional: true
+
+  get-tsconfig@5.0.0-beta.6:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
+  github-slugger@2.0.0: {}
+
+  h3@1.15.11:
+    dependencies:
+      cookie-es: 1.2.3
+      crossws: 0.3.5
+      defu: 6.1.7
+      destr: 2.0.5
+      iron-webcrypto: 1.2.1
+      node-mock-http: 1.0.5
+      radix3: 1.1.2
+      ufo: 1.6.4
+      uncrypto: 0.1.3
+
+  has-flag@5.0.1: {}
+
+  hast-util-embedded@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+      hast-util-is-element: 3.0.0
+
+  hast-util-format@1.1.0:
+    dependencies:
+      '@types/hast': 3.0.5
+      hast-util-embedded: 3.0.0
+      hast-util-minify-whitespace: 1.0.1
+      hast-util-phrasing: 3.0.1
+      hast-util-whitespace: 3.0.0
+      html-whitespace-sensitive-tag-names: 3.0.1
+      unist-util-visit-parents: 6.0.2
+
+  hast-util-from-html@2.0.3:
+    dependencies:
+      '@types/hast': 3.0.5
+      devlop: 1.1.0
+      hast-util-from-parse5: 8.0.3
+      parse5: 7.3.0
+      vfile: 6.0.3
+      vfile-message: 4.0.3
+
+  hast-util-from-parse5@8.0.3:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      devlop: 1.1.0
+      hastscript: 9.0.1
+      property-information: 7.2.0
+      vfile: 6.0.3
+      vfile-location: 5.0.3
+      web-namespaces: 2.0.1
+
+  hast-util-has-property@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+
+  hast-util-is-body-ok-link@3.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+
+  hast-util-is-element@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+
+  hast-util-minify-whitespace@1.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      hast-util-embedded: 3.0.0
+      hast-util-is-element: 3.0.0
+      hast-util-whitespace: 3.0.0
+      unist-util-is: 6.0.1
+
+  hast-util-parse-selector@4.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+
+  hast-util-phrasing@3.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      hast-util-embedded: 3.0.0
+      hast-util-has-property: 3.0.0
+      hast-util-is-body-ok-link: 3.0.1
+      hast-util-is-element: 3.0.0
+
+  hast-util-raw@9.1.0:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      '@ungap/structured-clone': 1.4.0
+      hast-util-from-parse5: 8.0.3
+      hast-util-to-parse5: 8.0.1
+      html-void-elements: 3.0.0
+      mdast-util-to-hast: 13.2.1
+      parse5: 7.3.0
+      unist-util-position: 5.0.0
+      unist-util-visit: 5.0.0
+      vfile: 6.0.3
+      web-namespaces: 2.0.1
+      zwitch: 2.0.4
+
+  hast-util-select@6.0.4:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      bcp-47-match: 2.0.3
+      comma-separated-tokens: 2.0.3
+      css-selector-parser: 3.3.0
+      devlop: 1.1.0
+      direction: 2.0.1
+      hast-util-has-property: 3.0.0
+      hast-util-to-string: 3.0.1
+      hast-util-whitespace: 3.0.0
+      nth-check: 2.1.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      unist-util-visit: 5.0.0
+      zwitch: 2.0.4
+
+  hast-util-to-estree@3.1.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      estree-util-attach-comments: 3.0.0
+      estree-util-is-identifier-name: 3.0.0
+      hast-util-whitespace: 3.0.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      style-to-js: 1.1.21
+      unist-util-position: 5.0.0
+      zwitch: 2.0.4
+    transitivePeerDependencies:
+      - supports-color
+
+  hast-util-to-html@9.0.5:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      comma-separated-tokens: 2.0.3
+      hast-util-whitespace: 3.0.0
+      html-void-elements: 3.0.0
+      mdast-util-to-hast: 13.2.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      stringify-entities: 4.0.4
+      zwitch: 2.0.4
+
+  hast-util-to-jsx-runtime@2.3.6:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      hast-util-whitespace: 3.0.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      style-to-js: 1.1.21
+      unist-util-position: 5.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  hast-util-to-parse5@8.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      web-namespaces: 2.0.1
+      zwitch: 2.0.4
+
+  hast-util-to-string@3.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+
+  hast-util-to-text@4.0.2:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      hast-util-is-element: 3.0.0
+      unist-util-find-after: 5.0.0
+
+  hast-util-whitespace@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+
+  hastscript@9.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      comma-separated-tokens: 2.0.3
+      hast-util-parse-selector: 4.0.0
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+
+  html-escaper@3.0.3: {}
+
+  html-void-elements@3.0.0: {}
+
+  html-whitespace-sensitive-tag-names@3.0.1: {}
+
+  http-cache-semantics@4.3.0: {}
+
+  i18next@26.5.3(typescript@5.9.3):
+    optionalDependencies:
+      typescript: 5.9.3
+
+  inline-style-parser@0.2.7: {}
+
+  iron-webcrypto@1.2.1: {}
+
+  is-absolute-url@5.0.0: {}
+
+  is-alphabetical@2.0.1: {}
+
+  is-alphanumerical@2.0.1:
+    dependencies:
+      is-alphabetical: 2.0.1
+      is-decimal: 2.0.1
+
+  is-decimal@2.0.1: {}
+
+  is-docker@4.0.0: {}
+
+  is-hexadecimal@2.0.1: {}
+
+  is-plain-obj@4.1.0: {}
+
+  js-yaml@4.3.2:
+    dependencies:
+      argparse: 2.0.1
+
+  jsonc-parser@3.3.1: {}
+
+  kleur@4.1.5: {}
+
+  klona@2.0.6: {}
+
+  lightningcss-android-arm64@1.33.0:
+    optional: true
+
+  lightningcss-darwin-arm64@1.33.0:
+    optional: true
+
+  lightningcss-darwin-x64@1.33.0:
+    optional: true
+
+  lightningcss-freebsd-x64@1.33.0:
+    optional: true
+
+  lightningcss-linux-arm-gnueabihf@1.33.0:
+    optional: true
+
+  lightningcss-linux-arm64-gnu@1.33.0:
+    optional: true
+
+  lightningcss-linux-arm64-musl@1.33.0:
+    optional: true
+
+  lightningcss-linux-x64-gnu@1.33.0:
+    optional: true
+
+  lightningcss-linux-x64-musl@1.33.0:
+    optional: true
+
+  lightningcss-win32-arm64-msvc@1.33.0:
+    optional: true
+
+  lightningcss-win32-x64-msvc@1.33.0:
+    optional: true
+
+  lightningcss@1.33.0:
+    dependencies:
+      detect-libc: 2.1.2
+    optionalDependencies:
+      lightningcss-android-arm64: 1.33.0
+      lightningcss-darwin-arm64: 1.33.0
+      lightningcss-darwin-x64: 1.33.0
+      lightningcss-freebsd-x64: 1.33.0
+      lightningcss-linux-arm-gnueabihf: 1.33.0
+      lightningcss-linux-arm64-gnu: 1.33.0
+      lightningcss-linux-arm64-musl: 1.33.0
+      lightningcss-linux-x64-gnu: 1.33.0
+      lightningcss-linux-x64-musl: 1.33.0
+      lightningcss-win32-arm64-msvc: 1.33.0
+      lightningcss-win32-x64-msvc: 1.33.0
+
+  longest-streak@3.1.0: {}
+
+  lru-cache@11.5.3: {}
+
+  lucode-starlight@1.0.0(@astrojs/starlight@0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3)):
+    dependencies:
+      '@astrojs/starlight': 0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3)
+      '@pagefind/default-ui': 1.5.2
+      marked: 18.1.1
+
+  magic-string@1.4.3:
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.6.0
+
+  magicast@0.5.5:
+    dependencies:
+      '@babel/parser': 7.29.9
+      '@babel/types': 7.29.8
+      source-map-js: 1.2.2
+
+  markdown-extensions@2.0.0: {}
+
+  markdown-table@3.0.4: {}
+
+  marked@18.1.1: {}
+
+  mdast-util-definitions@6.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      unist-util-visit: 5.0.0
+
+  mdast-util-directive@3.1.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+      micromark-util-character: 2.1.1
+      parse-entities: 4.0.2
+      stringify-entities: 4.0.4
+      unist-util-visit-parents: 6.0.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-find-and-replace@3.0.3:
+    dependencies:
+      '@types/mdast': 4.0.4
+      escape-string-regexp: 5.0.0
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
+  mdast-util-from-markdown@2.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      mdast-util-to-string: 4.0.0
+      micromark: 4.0.3
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-decode-string: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+      unist-util-stringify-position: 4.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-autolink-literal@2.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-find-and-replace: 3.0.3
+      micromark-util-character: 2.1.1
+
+  mdast-util-gfm-footnote@2.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+      micromark-util-normalize-identifier: 2.0.1
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-strikethrough@2.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-table@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      markdown-table: 3.0.4
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm@3.1.0:
+    dependencies:
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-gfm-autolink-literal: 2.0.1
+      mdast-util-gfm-footnote: 2.1.0
+      mdast-util-gfm-strikethrough: 2.0.1
+      mdast-util-gfm-table: 2.0.0
+      mdast-util-gfm-task-list-item: 2.0.0
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-expression@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-jsx@3.2.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+      parse-entities: 4.0.2
+      stringify-entities: 4.0.4
+      unist-util-stringify-position: 4.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx@3.0.0:
+    dependencies:
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdxjs-esm@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.1.0
+      mdast-util-to-markdown: 2.2.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-phrasing@4.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      unist-util-is: 6.0.1
+
+  mdast-util-to-hast@13.2.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      '@ungap/structured-clone': 1.4.0
+      devlop: 1.1.0
+      micromark-util-sanitize-uri: 2.0.1
+      trim-lines: 3.0.1
+      unist-util-position: 5.0.0
+      unist-util-visit: 5.0.0
+      vfile: 6.0.3
+
+  mdast-util-to-markdown@2.2.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      longest-streak: 3.1.0
+      mdast-util-phrasing: 4.1.0
+      mdast-util-to-string: 4.0.0
+      micromark-util-character: 2.1.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-decode-string: 2.0.1
+      micromark-util-html-tag-name: 2.0.1
+      unist-util-visit: 5.0.0
+      zwitch: 2.0.4
+
+  mdast-util-to-string@4.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+
+  mdn-data@2.0.28: {}
+
+  mdn-data@2.27.1: {}
+
+  micromark-core-commonmark@2.0.4:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-factory-destination: 2.0.1
+      micromark-factory-label: 2.0.1
+      micromark-factory-space: 2.1.0
+      micromark-factory-title: 2.0.1
+      micromark-factory-whitespace: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-edit-map: 1.0.0
+      micromark-util-html-tag-name: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-directive@4.0.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.1.0
+      micromark-factory-whitespace: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+      parse-entities: 4.0.2
+
+  micromark-extension-gfm-autolink-literal@2.1.0:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-gfm-footnote@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.4
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-gfm-table@2.1.2:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-gfm-tagfilter@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.3
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-gfm@3.0.0:
+    dependencies:
+      micromark-extension-gfm-autolink-literal: 2.1.0
+      micromark-extension-gfm-footnote: 2.1.0
+      micromark-extension-gfm-strikethrough: 2.1.0
+      micromark-extension-gfm-table: 2.1.2
+      micromark-extension-gfm-tagfilter: 2.0.0
+      micromark-extension-gfm-task-list-item: 2.1.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-mdx-expression@3.0.1:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-extension-mdx-jsx@3.0.2:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+      vfile-message: 4.0.3
+
+  micromark-extension-mdx-md@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.3
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.4
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-extension-mdxjs@3.0.0:
+    dependencies:
+      acorn: 8.19.0
+      acorn-jsx: 5.3.2(acorn@8.19.0)
+      micromark-extension-mdx-expression: 3.0.1
+      micromark-extension-mdx-jsx: 3.0.2
+      micromark-extension-mdx-md: 2.0.0
+      micromark-extension-mdxjs-esm: 3.0.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-factory-destination@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-factory-label@2.0.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-factory-mdx-expression@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-factory-space@2.1.0:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-types: 2.0.3
+
+  micromark-factory-title@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-factory-whitespace@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-util-character@2.1.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-util-chunked@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-classify-character@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-util-combine-extensions@2.0.1:
+    dependencies:
+      micromark-util-chunked: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-decode-string@2.0.1:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      micromark-util-character: 2.1.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-edit-map@1.0.0:
+    dependencies:
+      micromark-util-types: 2.0.3
+
+  micromark-util-encode@2.0.1: {}
+
+  micromark-util-events-to-acorn@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/unist': 3.0.3
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+      vfile-message: 4.0.3
+
+  micromark-util-html-tag-name@2.0.1: {}
+
+  micromark-util-normalize-identifier@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-resolve-all@2.0.1:
+    dependencies:
+      micromark-util-types: 2.0.3
+
+  micromark-util-sanitize-uri@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-encode: 2.0.1
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-subtokenize@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+
+  micromark-util-symbol@2.0.1: {}
+
+  micromark-util-types@2.0.3: {}
+
+  micromark@4.0.3:
+    dependencies:
+      '@types/debug': 4.1.13
+      debug: 4.4.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.4
+      micromark-factory-space: 2.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-edit-map: 1.0.0
+      micromark-util-encode: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  miniflare@5.20261019.0-beta(@types/node@24.19.2):
+    dependencies:
+      '@cspotcode/source-map-support': 0.8.1
+      sharp: 0.35.5(@types/node@24.19.2)
+      undici: 7.29.1
+      workerd: 1.20261019.1
+      ws: 8.21.0
+      youch: 4.1.0-beta.10
+    transitivePeerDependencies:
+      - '@types/node'
+      - bufferutil
+      - utf-8-validate
+
+  mrmime@2.0.1: {}
+
+  ms@2.1.3: {}
+
+  nanoid@3.3.20: {}
+
+  neotraverse@1.0.1: {}
+
+  nlcst-to-string@4.0.0:
+    dependencies:
+      '@types/nlcst': 2.0.3
+
+  node-fetch-native@1.6.7: {}
+
+  node-mock-http@1.0.5: {}
+
+  normalize-path@3.0.0: {}
+
+  nth-check@2.1.1:
+    dependencies:
+      boolbase: 1.0.0
+
+  obug@3.0.0: {}
+
+  ofetch@1.5.1:
+    dependencies:
+      destr: 2.0.5
+      node-fetch-native: 1.6.7
+      ufo: 1.6.4
+
+  oniguruma-parser@0.12.2: {}
+
+  oniguruma-to-es@4.3.6:
+    dependencies:
+      oniguruma-parser: 0.12.2
+      regex: 6.1.0
+      regex-recursion: 6.0.2
+
+  p-limit@7.3.3:
+    dependencies:
+      yocto-queue: 1.2.2
+
+  p-queue@9.3.5:
+    dependencies:
+      eventemitter3: 5.0.4
+      p-timeout: 7.0.2
+
+  p-timeout@7.0.2: {}
+
+  package-manager-detector@1.9.0: {}
+
+  pagefind@1.5.2:
+    optionalDependencies:
+      '@pagefind/darwin-arm64': 1.5.2
+      '@pagefind/darwin-x64': 1.5.2
+      '@pagefind/freebsd-x64': 1.5.2
+      '@pagefind/linux-arm64': 1.5.2
+      '@pagefind/linux-x64': 1.5.2
+      '@pagefind/windows-arm64': 1.5.2
+      '@pagefind/windows-x64': 1.5.2
+
+  parse-entities@4.0.2:
+    dependencies:
+      '@types/unist': 2.0.11
+      character-entities-legacy: 3.0.0
+      character-reference-invalid: 2.0.1
+      decode-named-character-reference: 1.3.0
+      is-alphanumerical: 2.0.1
+      is-decimal: 2.0.1
+      is-hexadecimal: 2.0.1
+
+  parse-latin@7.0.0:
+    dependencies:
+      '@types/nlcst': 2.0.3
+      '@types/unist': 3.0.3
+      nlcst-to-string: 4.0.0
+      unist-util-modify-children: 4.0.0
+      unist-util-visit-children: 3.0.0
+      vfile: 6.0.3
+
+  parse5@7.3.0:
+    dependencies:
+      entities: 6.0.1
+
+  path-to-regexp@6.3.0: {}
+
+  pathe@2.0.3: {}
+
+  piccolore@0.1.3: {}
+
+  picocolors@1.1.1: {}
+
+  picomatch@2.3.2: {}
+
+  picomatch@4.0.7: {}
+
+  postcss-nested@6.2.0(postcss@8.5.31):
+    dependencies:
+      postcss: 8.5.31
+      postcss-selector-parser: 6.1.5
+
+  postcss-selector-parser@6.1.5:
+    dependencies:
+      cssesc: 3.0.0
+      util-deprecate: 1.0.2
+
+  postcss@8.5.31:
+    dependencies:
+      nanoid: 3.3.20
+      picocolors: 1.1.1
+      source-map-js: 1.2.2
+
+  prismjs@1.30.0: {}
+
+  process-ancestry@0.1.0: {}
+
+  property-information@7.2.0: {}
+
+  radix3@1.1.2: {}
+
+  readdirp@5.1.1: {}
+
+  recma-build-jsx@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      estree-util-build-jsx: 3.0.1
+      vfile: 6.0.3
+
+  recma-jsx@1.0.1(acorn@8.19.0):
+    dependencies:
+      acorn: 8.19.0
+      acorn-jsx: 5.3.2(acorn@8.19.0)
+      estree-util-to-js: 2.0.0
+      recma-parse: 1.0.0
+      recma-stringify: 1.0.0
+      unified: 11.0.5
+
+  recma-parse@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      esast-util-from-js: 2.0.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  recma-stringify@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      estree-util-to-js: 2.0.0
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  regex-recursion@6.0.2:
+    dependencies:
+      regex-utilities: 2.3.0
+
+  regex-utilities@2.3.0: {}
+
+  regex@6.1.0:
+    dependencies:
+      regex-utilities: 2.3.0
+
+  rehype-expressive-code@0.44.2:
+    dependencies:
+      expressive-code: 0.44.2
+
+  rehype-raw@7.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+      hast-util-raw: 9.1.0
+      vfile: 6.0.3
+
+  rehype-recma@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/hast': 3.0.5
+      hast-util-to-estree: 3.1.3
+    transitivePeerDependencies:
+      - supports-color
+
+  rehype-stringify@10.0.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      hast-util-to-html: 9.0.5
+      unified: 11.0.5
+
+  remark-directive@4.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-directive: 3.1.1
+      micromark-extension-directive: 4.0.0
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-gfm@4.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-gfm: 3.1.0
+      micromark-extension-gfm: 3.0.0
+      remark-parse: 11.0.0
+      remark-stringify: 11.0.0
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-mdx@3.1.1:
+    dependencies:
+      mdast-util-mdx: 3.0.0
+      micromark-extension-mdxjs: 3.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-parse@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.1.0
+      micromark-util-types: 2.0.3
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-rehype@11.1.2:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      mdast-util-to-hast: 13.2.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  remark-smartypants@3.0.3:
+    dependencies:
+      retext: 9.0.0
+      retext-smartypants: 6.2.0
+      unified: 11.0.5
+      unist-util-visit: 5.0.0
+
+  remark-stringify@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-to-markdown: 2.2.0
+      unified: 11.0.5
+
+  resolve-pkg-maps@1.0.0: {}
+
+  retext-latin@4.0.0:
+    dependencies:
+      '@types/nlcst': 2.0.3
+      parse-latin: 7.0.0
+      unified: 11.0.5
+
+  retext-smartypants@6.2.0:
+    dependencies:
+      '@types/nlcst': 2.0.3
+      nlcst-to-string: 4.0.0
+      unist-util-visit: 5.0.0
+
+  retext-stringify@4.0.0:
+    dependencies:
+      '@types/nlcst': 2.0.3
+      nlcst-to-string: 4.0.0
+      unified: 11.0.5
+
+  retext@9.0.0:
+    dependencies:
+      '@types/nlcst': 2.0.3
+      retext-latin: 4.0.0
+      retext-stringify: 4.0.0
+      unified: 11.0.5
+
+  rolldown@1.2.14:
+    dependencies:
+      '@oxc-project/types': 0.154.0
+      '@rolldown/pluginutils': 1.0.1
+    optionalDependencies:
+      '@rolldown/binding-android-arm-eabi': 1.2.14
+      '@rolldown/binding-android-arm64': 1.2.14
+      '@rolldown/binding-darwin-arm64': 1.2.14
+      '@rolldown/binding-darwin-x64': 1.2.14
+      '@rolldown/binding-freebsd-x64': 1.2.14
+      '@rolldown/binding-linux-arm-gnueabihf': 1.2.14
+      '@rolldown/binding-linux-arm64-gnu': 1.2.14
+      '@rolldown/binding-linux-arm64-musl': 1.2.14
+      '@rolldown/binding-linux-ppc64-gnu': 1.2.14
+      '@rolldown/binding-linux-s390x-gnu': 1.2.14
+      '@rolldown/binding-linux-x64-gnu': 1.2.14
+      '@rolldown/binding-linux-x64-musl': 1.2.14
+      '@rolldown/binding-openharmony-arm64': 1.2.14
+      '@rolldown/binding-win32-arm64-msvc': 1.2.14
+      '@rolldown/binding-win32-x64-msvc': 1.2.14
+
+  satteri@0.10.5:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+    optionalDependencies:
+      '@bruits/satteri-darwin-arm64': 0.10.5
+      '@bruits/satteri-darwin-x64': 0.10.5
+      '@bruits/satteri-linux-arm64-gnu': 0.10.5
+      '@bruits/satteri-linux-arm64-musl': 0.10.5
+      '@bruits/satteri-linux-x64-gnu': 0.10.5
+      '@bruits/satteri-linux-x64-musl': 0.10.5
+      '@bruits/satteri-wasm32-wasi': 0.10.5
+      '@bruits/satteri-win32-arm64-msvc': 0.10.5
+      '@bruits/satteri-win32-x64-msvc': 0.10.5
+
+  sax@1.6.1: {}
+
+  semver@7.8.5: {}
+
+  sharp@0.35.5(@types/node@24.19.2):
+    dependencies:
+      '@img/colour': 1.1.0
+      detect-libc: 2.1.2
+      semver: 7.8.5
+    optionalDependencies:
+      '@img/sharp-darwin-arm64': 0.35.5
+      '@img/sharp-darwin-x64': 0.35.5
+      '@img/sharp-freebsd-wasm32': 0.35.5
+      '@img/sharp-libvips-darwin-arm64': 1.3.4
+      '@img/sharp-libvips-darwin-x64': 1.3.4
+      '@img/sharp-libvips-linux-arm': 1.3.4
+      '@img/sharp-libvips-linux-arm64': 1.3.4
+      '@img/sharp-libvips-linux-ppc64': 1.3.4
+      '@img/sharp-libvips-linux-riscv64': 1.3.4
+      '@img/sharp-libvips-linux-s390x': 1.3.4
+      '@img/sharp-libvips-linux-x64': 1.3.4
+      '@img/sharp-libvips-linuxmusl-arm64': 1.3.4
+      '@img/sharp-libvips-linuxmusl-x64': 1.3.4
+      '@img/sharp-linux-arm': 0.35.5
+      '@img/sharp-linux-arm64': 0.35.5
+      '@img/sharp-linux-ppc64': 0.35.5
+      '@img/sharp-linux-riscv64': 0.35.5
+      '@img/sharp-linux-s390x': 0.35.5
+      '@img/sharp-linux-x64': 0.35.5
+      '@img/sharp-linuxmusl-arm64': 0.35.5
+      '@img/sharp-linuxmusl-x64': 0.35.5
+      '@img/sharp-webcontainers-wasm32': 0.35.5
+      '@img/sharp-win32-arm64': 0.35.5
+      '@img/sharp-win32-ia32': 0.35.5
+      '@img/sharp-win32-x64': 0.35.5
+      '@types/node': 24.19.2
+
+  shiki@4.5.0:
+    dependencies:
+      '@shikijs/core': 4.5.0
+      '@shikijs/engine-javascript': 4.5.0
+      '@shikijs/engine-oniguruma': 4.5.0
+      '@shikijs/langs': 4.5.0
+      '@shikijs/themes': 4.5.0
+      '@shikijs/types': 4.5.0
+      '@shikijs/vscode-textmate': 10.1.0
+      '@types/hast': 3.0.5
+
+  sisteransi@1.0.5: {}
+
+  sitemap@9.0.1:
+    dependencies:
+      '@types/node': 24.19.2
+      '@types/sax': 1.2.7
+      arg: 5.0.2
+      sax: 1.6.1
+
+  smol-toml@1.9.1: {}
+
+  source-map-js@1.2.2: {}
+
+  source-map@0.7.6: {}
+
+  source-map@0.8.0: {}
+
+  space-separated-tokens@2.0.2: {}
+
+  starlight-links-validator@0.27.0(@astrojs/starlight@0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3))(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)):
+    dependencies:
+      '@astrojs/markdown-satteri': 0.4.4
+      '@astrojs/starlight': 0.42.6(@astrojs/markdown-remark@7.3.3)(astro@7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1))(typescript@5.9.3)
+      astro: 7.4.1(@astrojs/markdown-remark@7.3.3)(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+      github-slugger: 2.0.0
+      hast-util-from-html: 2.0.3
+      is-absolute-url: 5.0.0
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-to-hast: 13.2.1
+      picomatch: 4.0.7
+      satteri: 0.10.5
+      terminal-link: 5.0.0
+      unist-util-visit: 5.1.0
+      yaml: 2.9.1
+    transitivePeerDependencies:
+      - supports-color
+
+  std-env@4.3.0: {}
+
+  stringify-entities@4.0.4:
+    dependencies:
+      character-entities-html4: 2.1.0
+      character-entities-legacy: 3.0.0
+
+  style-to-js@1.1.21:
+    dependencies:
+      style-to-object: 1.0.14
+
+  style-to-object@1.0.14:
+    dependencies:
+      inline-style-parser: 0.2.7
+
+  supports-color@10.2.2: {}
+
+  supports-hyperlinks@4.6.0:
+    dependencies:
+      has-flag: 5.0.1
+      supports-color: 10.2.2
+
+  svgo@4.1.0:
+    dependencies:
+      commander: 11.1.0
+      css-select: 6.0.0
+      css-tree: 3.2.1
+      css-what: 7.0.0
+      csso: 5.0.5
+      picocolors: 1.1.1
+      sax: 1.6.1
+
+  terminal-link@5.0.0:
+    dependencies:
+      ansi-escapes: 7.3.0
+      supports-hyperlinks: 4.6.0
+
+  tiny-inflate@1.0.3: {}
+
+  tinyclip@1.0.3: {}
+
+  tinyexec@1.3.1: {}
+
+  tinyglobby@0.2.17:
+    dependencies:
+      fdir: 6.5.0(picomatch@4.0.7)
+      picomatch: 4.0.7
+
+  tinyps@0.5.0: {}
+
+  trim-lines@3.0.1: {}
+
+  trough@2.2.0: {}
+
+  tslib@2.8.1:
+    optional: true
+
+  typescript@5.9.3: {}
+
+  ufo@1.6.4: {}
+
+  ultrahtml@1.7.0: {}
+
+  uncrypto@0.1.3: {}
+
+  undici-types@7.24.6: {}
+
+  undici@7.29.1: {}
+
+  undici@8.12.3: {}
+
+  unenv@2.0.0-rc.24:
+    dependencies:
+      pathe: 2.0.3
+
+  unified@11.0.5:
+    dependencies:
+      '@types/unist': 3.0.3
+      bail: 2.0.2
+      devlop: 1.1.0
+      extend: 3.0.2
+      is-plain-obj: 4.1.0
+      trough: 2.2.0
+      vfile: 6.0.3
+
+  unifont@1.0.3:
+    dependencies:
+      css-tree: 3.2.1
+      fnv1a-64: 0.1.2
+      std-env: 4.3.0
+      undici: 8.12.3
+
+  unist-util-find-after@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+
+  unist-util-is@6.0.1:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-modify-children@4.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      array-iterate: 2.0.1
+
+  unist-util-position-from-estree@2.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-remove-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-visit: 5.0.0
+
+  unist-util-stringify-position@4.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-visit-children@3.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-visit-parents@6.0.2:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+
+  unist-util-visit@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
+  unist-util-visit@5.1.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
+  unstorage@1.17.6:
+    dependencies:
+      anymatch: 3.1.3
+      chokidar: 5.0.0
+      destr: 2.0.5
+      h3: 1.15.11
+      lru-cache: 11.5.3
+      node-fetch-native: 1.6.7
+      ofetch: 1.5.1
+      ufo: 1.6.4
+
+  url-extras@0.1.0: {}
+
+  util-deprecate@1.0.2: {}
+
+  verkit@0.5.0: {}
+
+  vfile-location@5.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      vfile: 6.0.3
+
+  vfile-message@4.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-stringify-position: 4.0.0
+
+  vfile@6.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      vfile-message: 4.0.3
+
+  vite@8.3.4(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1):
+    dependencies:
+      lightningcss: 1.33.0
+      picomatch: 4.0.7
+      postcss: 8.5.31
+      rolldown: 1.2.14
+      tinyglobby: 0.2.17
+    optionalDependencies:
+      '@types/node': 24.19.2
+      esbuild: 0.28.2
+      fsevents: 2.3.3
+      yaml: 2.9.1
+
+  vitefu@1.1.3(vite@8.3.4(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)):
+    optionalDependencies:
+      vite: 8.3.4(@types/node@24.19.2)(esbuild@0.28.2)(yaml@2.9.1)
+
+  web-namespaces@2.0.1: {}
+
+  workerd@1.20261019.1:
+    optionalDependencies:
+      '@cloudflare/workerd-darwin-64': 1.20261019.1
+      '@cloudflare/workerd-darwin-arm64': 1.20261019.1
+      '@cloudflare/workerd-linux-64': 1.20261019.1
+      '@cloudflare/workerd-linux-arm64': 1.20261019.1
+      '@cloudflare/workerd-windows-64': 1.20261019.1
+
+  wrangler@4.151.2(@types/node@24.19.2):
+    dependencies:
+      '@cloudflare/kv-asset-handler': 0.5.0
+      '@cloudflare/unenv-preset': 2.16.2(unenv@2.0.0-rc.24)(workerd@1.20261019.1)
+      blake3-wasm: 2.1.5
+      esbuild: 0.28.2
+      miniflare: 5.20261019.0-beta(@types/node@24.19.2)
+      path-to-regexp: 6.3.0
+      unenv: 2.0.0-rc.24
+      workerd: 1.20261019.1
+    optionalDependencies:
+      fsevents: 2.3.3
+    transitivePeerDependencies:
+      - '@types/node'
+      - bufferutil
+      - utf-8-validate
+
+  ws@8.21.0: {}
+
+  xxhash-wasm@1.1.0: {}
+
+  yaml@2.9.1: {}
+
+  yargs-parser@22.0.0: {}
+
+  yocto-queue@1.2.2: {}
+
+  youch-core@0.3.3:
+    dependencies:
+      '@poppinss/exception': 1.2.3
+      error-stack-parser-es: 1.0.5
+
+  youch@4.1.0-beta.10:
+    dependencies:
+      '@poppinss/colors': 4.1.6
+      '@poppinss/dumper': 0.6.5
+      '@speed-highlight/core': 1.2.24
+      cookie: 1.1.1
+      youch-core: 0.3.3
+
+  zod@4.6.7: {}
+
+  zwitch@2.0.4: {}
diff --git a/docs/pnpm-workspace.yaml b/docs/pnpm-workspace.yaml
new file mode 100644
index 00000000..577ec00c
--- /dev/null
+++ b/docs/pnpm-workspace.yaml
@@ -0,0 +1,7 @@
+packages:
+  - .
+
+onlyBuiltDependencies:
+  - esbuild
+  - sharp
+  - workerd
diff --git a/docs/public/favicon.png b/docs/public/favicon.png
new file mode 100644
index 00000000..f862c44d
Binary files /dev/null and b/docs/public/favicon.png differ
diff --git a/docs/public/og-image.png b/docs/public/og-image.png
new file mode 100644
index 00000000..3e65ca60
Binary files /dev/null and b/docs/public/og-image.png differ
diff --git a/docs/public/robots.txt b/docs/public/robots.txt
new file mode 100644
index 00000000..b2d2628e
--- /dev/null
+++ b/docs/public/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://ttlj.docs.isaackogan.com/sitemap-index.xml
diff --git a/docs/scripts/verify-seo.mjs b/docs/scripts/verify-seo.mjs
new file mode 100644
index 00000000..3d38ec9b
--- /dev/null
+++ b/docs/scripts/verify-seo.mjs
@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+// Assert the SEO invariants of the built documentation.
+//
+// Run against a built Starlight site from the docs directory:
+//
+//   node scripts/verify-seo.mjs dist        (pnpm run seo)
+//
+// Prints one PASS/FAIL line per check and exits 1 if any check fails, so an
+// SEO regression fails the CI build instead of silently degrading rankings.
+// The gate only reads the build output; nothing here ships with the site.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export const BASE_URL = 'https://ttlj.docs.isaackogan.com/';
+const EULER_HOST = 'eulerstream.com';
+const SITEMAP_INDEX = 'sitemap-index.xml';
+const SITEMAP_PAGES = 'sitemap-0.xml';
+
+// The lucode theme renders the sidebar as <ul class="sidebar-entries ...">.
+// A theme or Starlight upgrade that restructures the sidebar would silently
+// delete site navigation while every other check still passed, so every page
+// must carry this marker.
+const NAV_MARKER = 'class="sidebar-entries';
+
+// One sitewide footer link is the floor; the homepage must also vary its
+// anchor text so the link profile does not read as a single repeated anchor.
+const MIN_HOMEPAGE_ANCHORS = 3;
+
+const ANCHOR_TAG = /<a\b[^>]*>/gi;
+const CANONICAL_TAG = /<link\b[^>]*\brel="canonical"[^>]*>/gi;
+const HREF = /\bhref="([^"]*)"/i;
+const EULER_ANCHOR = new RegExp(
+  `<a\\b[^>]*href="[^"]*${EULER_HOST.replace(/\./g, '\\.')}[^"]*"[^>]*>([\\s\\S]*?)</a>`,
+  'gi',
+);
+
+function read(file) {
+  return fs.readFileSync(file, 'utf8');
+}
+
+function isFile(file) {
+  return fs.existsSync(file) && fs.statSync(file).isFile();
+}
+
+/** Astro emits one index.html per route plus a root 404.html; nothing else is a page. */
+function findPages(root) {
+  const pages = fs
+    .readdirSync(root, { recursive: true, withFileTypes: true })
+    .filter((entry) => entry.isFile() && entry.name === 'index.html')
+    .map((entry) => path.relative(root, path.join(entry.parentPath, entry.name)).split(path.sep).join('/'))
+    .sort();
+  if (isFile(path.join(root, '404.html'))) pages.push('404.html');
+  return new Map(pages.map((name) => [name, read(path.join(root, name))]));
+}
+
+/** The URL a built page must declare as canonical: `BASE_URL + dir + '/'`, `404.html` → `404/`. */
+function expectedUrl(name) {
+  const route = name === 'index.html'
+    ? ''
+    : name.endsWith('/index.html') ? name.slice(0, -'index.html'.length) : `${name.replace(/\.html$/, '')}/`;
+  return BASE_URL + route;
+}
+
+function eulerAnchorTexts(html) {
+  const texts = new Set();
+  for (const [, inner] of html.matchAll(EULER_ANCHOR)) {
+    const text = inner.replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim().toLowerCase();
+    if (text) texts.add(text);
+  }
+  return texts;
+}
+
+const sample = (list, n) => JSON.stringify(list.slice(0, n));
+
+/**
+ * Run every check against a built site.
+ * @param {string} buildDir directory holding the Astro build output
+ * @param {{ log?: (line: string) => void }} [options] `log` receives each PASS/FAIL line as it is decided
+ * @returns {{ passes: string[], failures: string[] }} check names, in the order they ran
+ */
+export function verifySeo(buildDir, { log = () => {} } = {}) {
+  const passes = [];
+  const failures = [];
+  const check = (name, ok, detail = '') => {
+    (ok ? passes : failures).push(name);
+    log(`${ok ? 'PASS' : 'FAIL'}  ${name}${!ok && detail ? ` :: ${detail}` : ''}`);
+  };
+
+  const root = path.resolve(buildDir);
+  if (!fs.existsSync(root) || !fs.statSync(root).isDirectory()) {
+    check(`build directory exists: ${buildDir}`, false, 'run the build first');
+    return { passes, failures };
+  }
+
+  const indexExists = isFile(path.join(root, 'index.html'));
+  check('index.html exists', indexExists);
+  if (!indexExists) return { passes, failures };
+
+  const pages = findPages(root);
+  const indexHtml = pages.get('index.html');
+  const pageNames = [...pages.keys()];
+
+  // -- Title ---------------------------------------------------------------
+  const titleText = (indexHtml.match(/<title>([\s\S]*?)<\/title>/)?.[1] ?? '').trim();
+  check("homepage title contains 'TikTok LIVE API'", titleText.toLowerCase().includes('tiktok live api'), titleText);
+
+  // -- Canonical -----------------------------------------------------------
+  const wrongCanonical = pageNames.filter((name) => {
+    const hrefs = [...pages.get(name).matchAll(CANONICAL_TAG)].map((m) => m[0].match(HREF)?.[1]);
+    return !hrefs.includes(expectedUrl(name));
+  });
+  check('every page has rel=canonical pointing at its own URL', wrongCanonical.length === 0,
+    `${wrongCanonical.length} wrong or missing, e.g. ${sample(wrongCanonical, 3)}`);
+
+  // -- Open Graph + meta description ---------------------------------------
+  check('homepage has og:title', indexHtml.includes('property="og:title"'));
+  check('homepage has og:description', indexHtml.includes('property="og:description"'));
+  check('homepage has og:image', indexHtml.includes('property="og:image"'));
+  check('homepage has meta description', indexHtml.includes('name="description"'));
+
+  // -- Sitemap -------------------------------------------------------------
+  const sitemapIndex = path.join(root, SITEMAP_INDEX);
+  check(`${SITEMAP_INDEX} exists`, isFile(sitemapIndex));
+  if (isFile(sitemapIndex)) {
+    check(`${SITEMAP_INDEX} references ${SITEMAP_PAGES}`,
+      read(sitemapIndex).includes(`<loc>${BASE_URL}${SITEMAP_PAGES}</loc>`));
+  }
+
+  const sitemapPages = path.join(root, SITEMAP_PAGES);
+  check(`${SITEMAP_PAGES} exists`, isFile(sitemapPages));
+  if (isFile(sitemapPages)) {
+    const xml = read(sitemapPages);
+    const locs = (xml.match(/<loc>/g) ?? []).length;
+    check(`${SITEMAP_PAGES} uses the canonical base URL`, xml.includes(BASE_URL));
+    check(`${SITEMAP_PAGES} lists more than one URL`, locs > 1, `${locs} <loc> entries`);
+  }
+
+  // -- robots.txt ----------------------------------------------------------
+  const robots = path.join(root, 'robots.txt');
+  const sitemapLine = `Sitemap: ${BASE_URL}${SITEMAP_INDEX}`;
+  check('robots.txt points at the sitemap index',
+    isFile(robots) && read(robots).includes(sitemapLine),
+    isFile(robots) ? `no '${sitemapLine}' line` : 'robots.txt missing');
+
+  // -- Dofollow link profile -----------------------------------------------
+  const nofollowed = [];
+  const withoutEuler = [];
+  for (const [name, html] of pages) {
+    const eulerAnchors = (html.match(ANCHOR_TAG) ?? []).filter((a) => a.includes(EULER_HOST));
+    if (eulerAnchors.length === 0) withoutEuler.push(name);
+    for (const a of eulerAnchors) {
+      if (a.toLowerCase().includes('nofollow')) nofollowed.push(`${name}: ${a.slice(0, 90)}`);
+    }
+  }
+  check('no eulerstream.com link is nofollowed', nofollowed.length === 0,
+    `${nofollowed.length} nofollowed, e.g. ${sample(nofollowed, 2)}`);
+  check('eulerstream.com linked from every page', withoutEuler.length === 0,
+    `${withoutEuler.length}/${pages.size} pages missing, e.g. ${sample(withoutEuler, 3)}`);
+
+  // -- Anchor diversity ----------------------------------------------------
+  const anchors = eulerAnchorTexts(indexHtml);
+  check(`homepage uses >= ${MIN_HOMEPAGE_ANCHORS} distinct eulerstream anchor texts`,
+    anchors.size >= MIN_HOMEPAGE_ANCHORS, `${anchors.size} distinct: ${sample([...anchors].sort(), 5)}`);
+
+  // -- Navigation integrity ------------------------------------------------
+  const missingNav = pageNames.filter((name) => !pages.get(name).includes(NAV_MARKER));
+  check('every page retains sidebar navigation', missingNav.length === 0,
+    `${missingNav.length} missing '${NAV_MARKER}', e.g. ${sample(missingNav, 3)}`);
+
+  return { passes, failures };
+}
+
+function main(buildDir = 'dist') {
+  const { passes, failures } = verifySeo(buildDir, { log: console.log });
+  console.log(`\n${passes.length} passed, ${failures.length} failed`);
+  return failures.length > 0 ? 1 : 0;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  process.exitCode = main(process.argv[2]);
+}
diff --git a/docs/scripts/verify-seo.test.mjs b/docs/scripts/verify-seo.test.mjs
new file mode 100644
index 00000000..6ac0e25e
--- /dev/null
+++ b/docs/scripts/verify-seo.test.mjs
@@ -0,0 +1,132 @@
+// Unit tests for the SEO gate. Each test writes a minimal built site into a
+// temporary directory and runs verifySeo against it, so the gate's checks are
+// exercised without a real Astro build.
+//
+//   pnpm run test            (node --test "scripts/**/*.test.mjs")
+
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { test } from 'node:test';
+
+import { BASE_URL, verifySeo } from './verify-seo.mjs';
+
+/** Render one fixture page. `route` is the path under BASE_URL ('' for the homepage). */
+function pageHtml({
+  route,
+  title = 'Guide',
+  canonical = BASE_URL + route,
+  eulerLinks = ['Euler Stream'],
+  openGraph = false,
+  sidebar = true,
+} = {}) {
+  const og = openGraph
+    ? [
+        '<meta property="og:title" content="Getting Started"/>',
+        '<meta property="og:description" content="Install TikTokLiveJava."/>',
+        '<meta property="og:image" content="https://ttlj.docs.isaackogan.com/og-image.png"/>',
+        '<meta name="description" content="Install TikTokLiveJava."/>',
+      ].join('\n')
+    : '';
+  const links = eulerLinks
+    .map((text) => `<a href="https://www.eulerstream.com/">${text}</a>`)
+    .join('\n');
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8"/>
+<title>${title}</title>
+<link rel="canonical" href="${canonical}"/>
+${og}
+</head>
+<body>
+<nav>${sidebar ? '<ul class="sidebar-entries sl-sidebar"><li><a href="/">Home</a></li></ul>' : ''}</nav>
+<main><h1>${title}</h1><p>Body text.</p></main>
+<footer>${links}</footer>
+</body>
+</html>
+`;
+}
+
+function defaultFiles() {
+  return {
+    'index.html': pageHtml({
+      route: '',
+      title: 'TikTok LIVE API for Java: TikTokLiveJava Documentation',
+      openGraph: true,
+      eulerLinks: ['Euler Stream', 'TikTok LIVE signing API', "Euler Stream's documentation"],
+    }),
+    'guide/index.html': pageHtml({ route: 'guide/' }),
+    'guide/nested/index.html': pageHtml({ route: 'guide/nested/' }),
+    '404.html': pageHtml({ route: '404/', title: 'Page not found' }),
+    'sitemap-index.xml':
+      '<?xml version="1.0" encoding="UTF-8"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">' +
+      `<sitemap><loc>${BASE_URL}sitemap-0.xml</loc></sitemap></sitemapindex>`,
+    'sitemap-0.xml':
+      '<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">' +
+      `<url><loc>${BASE_URL}</loc></url><url><loc>${BASE_URL}guide/</loc></url>` +
+      `<url><loc>${BASE_URL}guide/nested/</loc></url></urlset>`,
+    'robots.txt': `User-agent: *\nAllow: /\n\nSitemap: ${BASE_URL}sitemap-index.xml\n`,
+  };
+}
+
+/**
+ * Write a minimal built site into `dir`. `overrides` maps a relative path to
+ * its content; a `null` value omits that file from the fixture.
+ */
+function writeFixtureSite(dir, overrides = {}) {
+  const files = { ...defaultFiles(), ...overrides };
+  for (const [relative, content] of Object.entries(files)) {
+    if (content === null) continue;
+    const target = path.join(dir, relative);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, content, 'utf8');
+  }
+  return dir;
+}
+
+function fixtureDir(t) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'verify-seo-'));
+  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
+  return dir;
+}
+
+test('gatePassesOnFixtureSite', (t) => {
+  const dir = writeFixtureSite(fixtureDir(t));
+
+  const { passes, failures } = verifySeo(dir);
+
+  assert.deepEqual(failures, []);
+  assert.equal(passes.length, 17, `every check runs once on the fixture, got ${passes.length}`);
+});
+
+test('failsWhenNestedPageLacksEulerLink', (t) => {
+  const dir = writeFixtureSite(fixtureDir(t), {
+    'guide/nested/index.html': pageHtml({ route: 'guide/nested/', eulerLinks: [] }),
+  });
+
+  const { failures } = verifySeo(dir);
+
+  assert.deepEqual(failures, ['eulerstream.com linked from every page']);
+});
+
+test('failsWhenRobotsHasNoSitemap', (t) => {
+  const dir = writeFixtureSite(fixtureDir(t), {
+    'robots.txt': 'User-agent: *\nAllow: /\n',
+  });
+
+  const { failures } = verifySeo(dir);
+
+  assert.deepEqual(failures, ['robots.txt points at the sitemap index']);
+});
+
+test('failsWhenCanonicalPointsAtAnotherPage', (t) => {
+  const dir = writeFixtureSite(fixtureDir(t), {
+    'guide/nested/index.html': pageHtml({ route: 'guide/nested/', canonical: BASE_URL + 'guide/' }),
+  });
+
+  const { failures } = verifySeo(dir);
+
+  assert.deepEqual(failures, ['every page has rel=canonical pointing at its own URL']);
+});
diff --git a/docs/src/content.config.ts b/docs/src/content.config.ts
new file mode 100644
index 00000000..6226f384
--- /dev/null
+++ b/docs/src/content.config.ts
@@ -0,0 +1,8 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
+import { ExtendDocsSchema } from 'lucode-starlight/schema';
+
+export const collections = {
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema({ extend: ExtendDocsSchema }) }),
+};
diff --git a/docs/src/content/docs/404.md b/docs/src/content/docs/404.md
new file mode 100644
index 00000000..c6fb5293
--- /dev/null
+++ b/docs/src/content/docs/404.md
@@ -0,0 +1,8 @@
+---
+title: Page not found
+description: Find the documentation page you need.
+sidebar:
+  hidden: true
+---
+
+This page is not available in this documentation build. Use search, return to [Getting Started](/), or browse the [event catalog](/events/).
diff --git a/docs/src/content/docs/advanced/http-client.md b/docs/src/content/docs/advanced/http-client.md
new file mode 100644
index 00000000..cbda4bad
--- /dev/null
+++ b/docs/src/content/docs/advanced/http-client.md
@@ -0,0 +1,105 @@
+---
+title: HTTP client and mappers
+description: The requests TikTokLiveJava makes to TikTok and to the signing provider, how each request is built and retried, the response mappers, and the message-mapping layer that turns Webcast messages into events.
+sidebar:
+  order: 1
+---
+
+Two layers sit between the socket and your handlers. `LiveHttpClient`, implemented by `TikTokLiveHttpClient`, makes the HTTP requests: the creator's user data, the room information, the gift list, the signing request to [Euler Stream](https://www.eulerstream.com/), and the chat endpoint. `LiveMapper`, implemented by `TikTokLiveMapper`, turns each Webcast message into events. `connect()` drives both in a fixed order, described on the [connection page](/getting-started/connection/#the-connect-sequence); this page describes what they do so you can call them yourself or change what they produce.
+
+## The requests
+
+`TikTokLive.requests()` returns a `LiveHttpClient` with default settings, and `TikTokLive.requests(Consumer<LiveClientSettings>)` one configured the way a client is, so the requests go through your proxy, headers, and timeout; see [HTTP settings](/configuration/http-settings/#requests-outside-a-client). The interface has a `String` overload and a `Request` overload for each of the three TikTok requests.
+
+| Method | Request | Returns |
+| --- | --- | --- |
+| `fetchLiveUserData(userName)` | `GET https://www.tiktok.com/api-live/user/room` with `uniqueId` and `sourceType=54`, plus the `sessionid` and `tt-target-idc` cookies when set | `LiveUserData.Response`: `getUserStatus()` (`Live`, `LivePaused`, `Offline`, `NotFound`), `getRoomInfo()` with the room id, title, start time, viewer counts, age restriction, and host, `isLiveOnline()`, `isHostNameValid()`, and `getJson()` |
+| `fetchLiveData(roomId)` | `GET https://webcast.tiktok.com/webcast/room/info` with `room_id` and the same cookies | `LiveData.Response`: `getLiveStatus()` (`HostOnline`, `HostPaused`, `HostOffline`, `HostNotFound`), `isAgeRestricted()`, `getTitle()`, `getLikes()`, `getViewers()`, `getTotalViewers()`, `getHost()`, `getLiveType()` (`SOLO`, `BOX`, `CO_HOST`, `BATTLE`), and `getJson()` |
+| `fetchRoomGiftsData(roomId)` | `GET https://webcast.tiktok.com/webcast/gift/list/` with `room_id`, no cookies | `GiftsData.Response`: `getGifts()`, a `List<Gift>` with id, name, diamond cost, picture, and the gift's JSON object, and `getJson()`; a body without `data.gifts` gives an empty list |
+| `fetchLiveConnectionData(roomId)` | `GET https://tiktok.eulerstream.com/webcast/fetch` with `client=ttlive-java`, `room_id`, `session_id` when set, and the `x-api-key` header when set | `LiveConnectionData.Response`: `getWebsocketCookies()`, the `x-set-tt-cookie` header; `getWebsocketUrl()`, built from the response's push server, `room_id`, `cursor`, `resp_content_type=protobuf`, `internal_ext`, and the route parameters; `getWebcastResponse()`, the parsed `ProtoMessageFetchResult` |
+| `sendChat(roomInfo, content, sessionId, ttTargetIdc)` | `POST https://tiktok.eulerstream.com/webcast/chat` with a JSON body of `content`, `sessionId`, `ttTargetIdc`, and `roomId`, and the `x-api-key` header when set | `true` when the provider answered 200; `false` otherwise, without an exception |
+
+With `useEulerstreamEnterprise` the two provider requests go to `tiktok.enterprise.eulerstream.com` instead; see [signing](/configuration/signing/#enterprise-endpoints). Every request carries the parameters, headers, and cookies of the [HTTP settings](/configuration/http-settings/), so `app_language`, `aid`, the `User-Agent`, and the rest of TikTok's web-client parameters are on each URL and request.
+
+```java
+var requests = TikTokLive.requests(settings -> settings.getHttpSettings().setTimeout(Duration.ofSeconds(10)));
+var userData = requests.fetchLiveUserData("isaackogz");
+System.out.println("Status: " + userData.getUserStatus());
+
+if (userData.getUserStatus() == LiveUserData.UserStatus.Live) {
+    var roomId = userData.getRoomInfo().getRoomId();
+    var liveData = requests.fetchLiveData(roomId);
+    System.out.println(liveData.getTitle() + " (" + liveData.getLiveType() + "): " + liveData.getViewers() + " viewers");
+
+    var gifts = requests.fetchRoomGiftsData(roomId);
+    System.out.println(gifts.getGifts().size() + " gifts in the room's list");
+}
+```
+
+### Errors
+
+A TikTok request that answers with a status other than 200, or that fails in transport, throws `TikTokLiveRequestException`; the signing request throws `TikTokSignServerException`, a subclass, for a non-200 status, a response without the `x-set-tt-cookie` header, or a body that is not a `ProtoMessageFetchResult`. The message carries the status and a note chosen by the status code: `429` reads `Sign server rate limit reached`, with the wait computed from the `ratelimit-reset` header when present; `420` reads `IP Cloudflare Blocked`; `500` to `503` read `Sign server Error`; `504` reads `Sign server Timeout`. The notes are chosen in the shared `HttpClient`, so a 429 from TikTok's own API carries the same `Sign server` wording as one from the provider. The status table is on the [signing page](/configuration/signing/#rate-limits-and-provider-errors).
+
+The response mappers add their own failures. `LiveUserDataMapper` throws `TikTokLiveRequestException` when TikTok answers `params_error`, returns `NotFound` with a `null` room info when it answers `user_not_found` or with no `data`, and, when the body is not the JSON it expects, logs `Malformed Json` at `WARNING` and returns `NotFound` as well; a captcha or block page therefore surfaces as an unknown host. `LiveDataMapper` throws `TikTokLiveRequestException` when the body is not a JSON object or has no `data` section. The [troubleshooting page](/troubleshooting/) lists every exception.
+
+### Proxies
+
+Each `fetch` method and `sendChat` wrap their request in a loop: while the proxy list is not empty, send through the next endpoint and, on `TikTokProxyRequestException`, try again; after the loop, send once without a proxy. The signing request also repeats on `TikTokSignServerException`. Inside one attempt, `HttpProxyClient` handles the endpoint selection, the discard of failed endpoints, and the fallback; with `type` `HTTP` or `DIRECT`, a response other than 200 moves on to the next endpoint without removing the current one, so a provider that keeps answering 429 through working proxies is retried in rotation until the list empties or the response changes. See [proxies and host](/configuration/proxies-and-host/#how-a-request-uses-the-list).
+
+## How a request is built
+
+`HttpClientFactory` holds the client's `LiveClientSettings` and the one `java.net.http.HttpClient` behind every request. `client(url)` returns an `HttpClientBuilder` over a `clone()` of the HTTP settings; `withParam`, `withParams`, `withHeader`, `withHeaders`, `withCookie` (which skips a `null` name or value), `withBody`, `withUrl`, and `withHttpClientSettings` edit that copy, and `build()` returns an `HttpProxyClient` when proxies are enabled and the list is not empty, otherwise an `HttpClient`.
+
+`HttpClient.prepareRequest()` assembles the `HttpRequest`: `POST` when a body was given, the URL with the parameters URL-encoded and sorted as its query string (`toUri()`), the settings' `timeout` as the request timeout, the cookies joined into one `Cookie` header when the map is not empty, every header, and finally the `onRequestCreating` hook. `toHttpResponse(handler)` sends it and wraps the response in an `ActionResult`, a success for status 200 and a failure with the note above for anything else; `toJsonResponse()` and `toBinaryResponse()` are the `String` and `byte[]` forms. The JDK client itself is created once, on the first request: it follows redirects, keeps cookies in a `CookieManager`, uses `timeout` as its connect timeout, installs a `RotatingProxySelector` when proxies are enabled with a type other than `SOCKS`, and runs the `onClientCreating` hook. The selector binds the endpoint chosen for a request to the sending thread for the duration of that one `send`, which is how a single JDK client rotates proxies per request.
+
+These classes are public in `io.github.jwdeveloper.tiktok.client.http`, so a request the client does not make can use the same machinery:
+
+```java
+import io.github.jwdeveloper.tiktok.client.http.HttpClientBuilder;
+
+var settings = LiveClientSettings.createDefault().getHttpSettings();
+var result = new HttpClientBuilder("https://www.tiktok.com/api-live/user/room", settings)
+        .withParam("uniqueId", "isaackogz")
+        .withParam("sourceType", "54")
+        .build()
+        .toJsonResponse();
+
+if (result.isSuccess()) {
+    System.out.println(result.getContent());
+} else {
+    System.out.println("Failed: " + result);
+}
+```
+
+`new HttpClientBuilder(url)` without settings starts from an empty `HttpClientSettings`, with no parameters and no headers; `LiveClientSettings.createDefault().getHttpSettings()` gives the client's defaults.
+
+## Response mappers
+
+The JSON bodies are turned into the response objects by static methods in `io.github.jwdeveloper.tiktok.client.http.mappers`: `LiveUserDataMapper.map` reads the user, status, and `liveRoom` sections of the user request, `LiveDataMapper.map` reads the room information (its `getUser` builds the host as a `User` with the `LiveHost` attribute), and `GiftsDataMapper.mapRoom` reads the gift list, replacing a `.webp` picture URL with `.png`. `HttpRequestJsonMapper` and `HttpResponseJsonMapper` are Gson serializers for the JDK's `HttpRequest` and `HttpResponse`, for printing a request as JSON.
+
+`LiveUserDataMapper.mapEulerstream` is the mapper of the Euler Stream WebSocket's `roomInfo` message. It fills the room id, title, start time, viewer count, and host, and reads the host's id, username, nickname, signature, avatar, and follower counts; it sets no total viewer count and no age restriction, and it writes the message's `totalViewers` into the viewer count as well. The [WebSocket page](/advanced/websocket/#the-euler-stream-socket) describes when it runs.
+
+## The message mappers
+
+Once the socket delivers a batch, `TikTokLiveMessageHandler` publishes `TikTokWebsocketResponseEvent` with the whole `ProtoMessageFetchResult` and handles each message in turn. A message whose `method` has no registered mapping is published as `TikTokWebsocketUnhandledMessageEvent`; a registered one goes through `LiveMapper.handleMapping(name, bytes)`, and each event it returns is published after a `TikTokWebsocketMessageEvent` that wraps it. An exception during one message is caught, wrapped in `TikTokLiveMessageException` with the message and the batch, and published as `TikTokErrorEvent`; the handler then continues with the next message. `publishMessage` on the client calls the same single-message path without a batch event and lets the exception propagate.
+
+Three interfaces in `io.github.jwdeveloper.tiktok.api.mappers` make up the layer:
+
+- `LiveMapper` keeps one `TikTokMapperModel` per message name. `forMessage(name)` or `forMessage(WebcastXMessage.class)` creates or returns the model, keyed by the class's simple name; the overloads with a `MappingAction` or a `Function<byte[], TikTokEvent>` set its mapping at the same time. `forAnyMessage()` returns the global model, `isRegistered` says whether a name has a model, and `handleMapping` runs the pipeline below.
+- `TikTokMapperModel` has three hooks: `onBeforeMapping(MappingAction<byte[]>)` receives the bytes and returns the bytes to map; `onMapping(MappingAction<MappingResult>)` deserialises and builds the events; `onAfterMapping(Function<MappingResult, List<TikTokEvent>>)` receives the result and returns the events to publish. `getSourceMessageName()` is the key. A `MappingAction` receives the bytes, the message name, and the helper.
+- `LiveMapperHelper` deserialises: `bytesToWebcastObject(bytes, WebcastXMessage.class)` and `bytesToWebcastObject(bytes, name)`, which looks the class up in `io.github.jwdeveloper.tiktok.api.messages.webcast`; `isMessageHasProtoClass(name)`; `bytesToProtoBufferStructure(bytes)`, which decodes any payload into a `ProtoBufferObject` without a schema; and `toJson(object)`.
+
+`handleMapping` runs, in order, the message's `onBeforeMapping`, the global `onBeforeMapping`, the message's `onMapping`, the global `onMapping` only when the message's returned `null`, the message's `onAfterMapping`, and the global `onAfterMapping`. A model created by `forMessage(name)` alone maps to no events until `onMapping` is set, and the defaults of the hooks pass the bytes and the result through unchanged.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .mappings(mapper -> mapper.forAnyMessage().onBeforeMapping((bytes, messageName, helper) -> {
+            System.out.println(messageName + ": " + bytes.length + " bytes");
+            return bytes;
+        }))
+        .buildAndConnect();
+```
+
+The implementations live in `io.github.jwdeveloper.tiktok.client.mappers`. `MessagesMapperFactory.create` registers the default mappings: the control, poll, and pin messages go to `TikTokCommonEventHandler`, the live-intro, room-user, like, and member messages to `TikTokRoomInfoEventHandler`, the gift message to `TikTokGiftEventHandler`, the social message to `TikTokSocialMediaEventHandler`, and the chat, caption, subscription, emote, question, barrage, battle, and link messages are mapped inline, the link message by a `switch` on its type. The registrations of several other messages are commented out in the factory or absent, and that `switch` has no case for the apply and reply types, which is why the default client never produces the sixteen [unmapped events](/events/#unmapped-events). `mappings(mapper -> ...)` on the builder runs after the factory, so it can add to or replace any of them; see [custom events and mappings](/guides/custom-events/).
+
+`TikTokLiveMapperHelper` is the helper; it throws `TikTokMessageMappingException` when a class has no `parseFrom` method or the bytes do not parse (the message reads `can't find parsing method` in both cases) and when a name has no class in the webcast package. `TikTokGenericEventMapper`, which it uses to look up `parseFrom`, also has a `mapToEvent(messageClass, eventClass, bytes)` method that finds the event constructor taking the message by reflection; nothing in this release calls it, so there is no name-based fallback from `WebcastXMessage` to `TikTokXEvent`.
diff --git a/docs/src/content/docs/advanced/protocol.md b/docs/src/content/docs/advanced/protocol.md
new file mode 100644
index 00000000..aa47db32
--- /dev/null
+++ b/docs/src/content/docs/advanced/protocol.md
@@ -0,0 +1,77 @@
+---
+title: Protocol
+description: The Webcast protobuf schema TikTokLiveJava is built from, the transport messages, how a message name becomes an event class, how to decode and replay a payload, and the difference between a schema definition and verified behaviour.
+sidebar:
+  order: 3
+---
+
+TikTok's Webcast protocol is not documented by TikTok. TikTokLiveJava carries its own description of it as three proto3 files in `API/src/main/proto/`, and the `API` module's Maven build generates the Java classes from them with `protoc` (`protoc-jar-maven-plugin`, protoc 4.26.1), so the classes are in `API/target/generated-sources` rather than in `src/`. The [schema reference](/schema/) is generated from the same files on every documentation build.
+
+| File | Contents | Java package |
+| --- | --- | --- |
+| `webcast.proto` | 39 top-level messages: the transport messages below and the `Webcast*` messages that become events; imports the other two files | `io.github.jwdeveloper.tiktok.api.messages.webcast` |
+| `data.proto` | 100 messages for the nested data: `User`, `CommonMessageData`, `GiftStruct`, the battle, link, and badge structures | `io.github.jwdeveloper.tiktok.api.messages.data` |
+| `enums.proto` | 94 enums | `io.github.jwdeveloper.tiktok.api.messages.enums` |
+
+Each file sets `java_multiple_files`, so every message is its own class, and nested messages are inner classes: `ProtoMessageFetchResult.BaseProtoMessage`, `WebcastBarrageMessage.BarrageType`.
+
+## Transport messages
+
+Three messages carry everything else. The [WebSocket page](/advanced/websocket/#frames) describes when each is sent and received.
+
+| Message | Fields | Role |
+| --- | --- | --- |
+| [`WebcastPushFrame`](/schema/webcast/webcastpushframe/) | `SeqId`, `LogId`, `Service`, `Method`, `headers`, `PayloadEncoding`, `PayloadType`, `Payload` | One WebSocket message in either direction. Incoming frames carry a batch in `Payload`; the client sends `ack` frames and `hb` heartbeats as frames with no batch. |
+| [`ProtoMessageFetchResult`](/schema/webcast/protomessagefetchresult/) | `messages`, `cursor`, `fetchInterval`, `now`, `internalExt`, `fetchType`, `routeParamsMap`, `heartBeatDuration`, `needsAck`, `pushServer`, `isFirst`, `historyCommentCursor`, `historyNoMore` | A batch of messages: the body of the signing response from [Euler Stream](https://www.eulerstream.com/), whose `pushServer`, `cursor`, `internalExt`, and `routeParamsMap` build the WebSocket URL, and the payload of every incoming frame. `TikTokWebsocketResponseEvent.getResponse()` is one of these. |
+| [`BaseProtoMessage`](/schema/webcast/protomessagefetchresult-baseprotomessage/) | `method`, `payload`, `msgId`, `msgType`, `offset`, `isHistory` | One message in a batch: the name of its type and its serialized bytes. `TikTokWebsocketMessageEvent.getMessage()` and `TikTokWebsocketUnhandledMessageEvent.getMessage()` are these. |
+
+## From a message to an event
+
+`method` is the name of a message type, `WebcastGiftMessage` for example, and `payload` is that message serialized. The name matches the generated class in the webcast package, which is how `LiveMapperHelper.bytesToWebcastObject(bytes, name)` finds a class for a name and how `isMessageHasProtoClass` answers. The mappings `MessagesMapperFactory` registers are keyed by the same names; a message whose name has no mapping is published as `TikTokWebsocketUnhandledMessageEvent` with the raw `BaseProtoMessage`, which is where a type the library does not know, or one of the sixteen [unmapped events](/events/#unmapped-events), ends up. The [HTTP client and mappers page](/advanced/http-client/#the-message-mappers) describes the pipeline.
+
+An event class wraps its message: `TikTokGiftEvent` is constructed from a `WebcastGiftMessage`, `TikTokCommentEvent` from a `WebcastChatMessage`, and so on, and the `Webcast*` messages that become events share a `CommonMessageData common = 1` field, from which `TikTokHeaderEvent` takes `getMessageId()` (`msgId`), `getRoomId()`, and `getTimeStamp()` (`createTime`). The event's other getters read the message's fields and convert the nested protobuf objects, such as the `User` and `GiftStruct` messages, into the library's own `User` and `Gift` models. The [event catalog](/events/) names the message behind each event and links its schema page; the generated [API reference](/api/) has every event's getters.
+
+## Decode a message
+
+The generated classes have the standard protobuf-java API: `parseFrom(byte[])` and `parseFrom(ByteString)` decode, `toByteArray()` encodes, and `newBuilder()` builds a message by hand. An event class takes the decoded message, so a payload can be turned into the same event the client would publish. For bytes whose type the library has no class for, `ProtocolUtils.getProtocolBufferStructure(bytes)` decodes the wire format without a schema into a `ProtoBufferObject`, whose `toJson()` lists field numbers, wire types, and values and whose `toProtoFile()` drafts a `.proto` definition.
+
+```java
+import com.google.protobuf.InvalidProtocolBufferException;
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastChatMessage;
+
+var message = WebcastChatMessage.newBuilder().setContent("hello").build();
+byte[] payload = message.toByteArray();
+
+try {
+    var decoded = WebcastChatMessage.parseFrom(payload);
+    var event = new TikTokCommentEvent(decoded);
+    System.out.println(event.getText() + " from user id " + event.getUser().getId());
+    System.out.println(ProtocolUtils.getProtocolBufferStructure(payload).toJson());
+} catch (InvalidProtocolBufferException e) {
+    System.err.println("Not a WebcastChatMessage: " + e.getMessage());
+}
+```
+
+A payload captured from a live session is handled the same way. `ProtocolUtils.toBase64(bytes)` and `fromBase64(text)` convert payloads for a report or a fixture, `toBase64(BaseProtoMessage)` encodes a whole message with its name, and `fromBase64ToMessage(text)` reads one back. `publishMessage(name, payloadBase64)` on any client, including an offline one, runs a payload through the mapping as if it had arrived on the socket; see [replay recorded messages](/guides/offline-testing/#replay-recorded-messages) and the [debugging guide](/guides/debugging/#decode-a-payload) for capturing them.
+
+Fields keep their protobuf types and defaults: an absent nested message reads as its default instance, not `null`, an absent string is empty, and an absent number is zero. The event models convert on top of that, so a user TikTok did not send has id `0` and an empty name. Enums are the generated enum classes, such as `ControlAction` on `WebcastControlMessage`; read them by name rather than by number in your own code, since the schema can be renumbered between releases.
+
+## Schema definitions and verified behaviour
+
+A message in the schema proves that TikTok's protocol can carry it and that this version can decode it. It does not prove that every room, region, or stream type sends it, that it arrives at the moment its name suggests, or what an undocumented integer field means. The schema defines messages for which no event exists, and event classes exist for messages the default mapper never registers; the grouped event pages say what each mapping produces, and a field that is always empty in your rooms may be filled elsewhere. Two mappings in the source carry a `not working` note from the maintainers, the poll events and `TikTokShopEvent`; see [room and display](/events/room-and-display/) and [games and commerce](/events/games-and-commerce/).
+
+TikTok changes the protocol without notice. When a message stops arriving, a field moves, or a new name shows up in `TikTokWebsocketUnhandledMessageEvent`, compare with the latest release before assuming a bug in your code, and read the schema page of the message rather than the README for the current field list.
+
+## Report a protocol issue
+
+For a message the library does not know, or one it decodes wrongly, open an issue on the [TikTokLiveJava repository](https://github.com/jwdeveloper/TikTokLiveJava/issues) with the message's `method`, one or more Base64 payloads, the library version (`1.13.1-Release` for these pages), and what was happening in the stream. The payload is what lets the message be decoded and a schema written; a name alone is not enough. This handler prints both for every unmapped message:
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onWebsocketUnhandledMessage((client, event) ->
+                System.out.println(event.getMessage().getMethod() + " "
+                        + ProtocolUtils.toBase64(event.getMessage().getPayload().toByteArray())))
+        .buildAndConnect();
+```
+
+Base64 is an encoding, not anonymization: a payload can contain usernames, ids, and other personal data, so review it before posting. See [troubleshooting](/troubleshooting/#report-a-reproducible-issue) for what else a report needs.
diff --git a/docs/src/content/docs/advanced/websocket.md b/docs/src/content/docs/advanced/websocket.md
new file mode 100644
index 00000000..fe404cf4
--- /dev/null
+++ b/docs/src/content/docs/advanced/websocket.md
@@ -0,0 +1,122 @@
+---
+title: WebSocket layer
+description: The socket clients behind connect(), how the signed URL becomes a connection, the push frames, acknowledgements, and heartbeats, how a connection ends, the Euler Stream and offline sockets, and reading the frames without the client.
+sidebar:
+  order: 2
+---
+
+`LiveSocketClient` is the interface `TikTokLiveClient` drives: `start(connectionData, liveClient)` opens the connection, `stop(LiveClientStopType)` closes it, and `isConnected()` reports whether the socket is open. `build()` picks the implementation from the settings: `TikTokWebSocketClient` by default, `TikTokWebSocketEulerClient` with `useEulerstreamWebsocket`, and `TikTokWebSocketOfflineClient` with `offline`. The sockets are [Java-WebSocket](https://github.com/TooTallNate/Java-WebSocket) 1.5.5 clients, a compile-scope dependency of the `Client` module.
+
+## Connection sequence
+
+`TikTokWebSocketClient.start` runs on the thread that called `connect()`, after the signing request to [Euler Stream](https://www.eulerstream.com/) has returned a `LiveConnectionData.Response`:
+
+1. `stop(LiveClientStopType.NORMAL)` closes any socket the client still holds, so a second `start` replaces the first.
+2. The messages already in the signing response are handed to the message handler, so handlers registered before `connect()` receive them before the socket exists.
+3. A `TikTokWebSocketListener` is created for the signed URL with the HTTP settings' headers plus a `Cookie` header holding the cookies from the signing response, and the `timeout` of the HTTP settings as its connect timeout, after `toMillisPart()`: a whole-second timeout, such as the default, gives `0`, which is no timeout. See [the timeout and sub-second parts](/configuration/http-settings/#the-timeout-and-sub-second-parts).
+4. With proxies enabled and `allowWebsocket` left `true`, the listener connects through the proxy list, as the [proxies page](/configuration/proxies-and-host/#the-websocket) describes; otherwise it connects directly. Java-WebSocket's `connect()` starts a thread named `WebSocketConnectReadThread-<id>` and returns at once. The library sets no daemon flag on it, so the thread inherits the flag of the thread that called `connect()`: a user thread when you call `connect()` or `buildAndConnect()` from your main thread, which then keeps the process alive while the socket is open; a daemon thread when you use `connectAsync()` or `buildAndConnectAsync()`, which run `connect()` on the common pool, so the process ends with your last non-daemon thread unless you keep one alive.
+5. `connect()` sets the state to `CONNECTED` and publishes `TikTokRoomInfoEvent` without waiting for the handshake. `TikTokConnectedEvent` is published from the socket thread when the handshake completes.
+
+A handshake that fails is reported on the socket thread rather than thrown from `connect()`. When the host does not resolve or the TCP or TLS connection fails, the listener's `onError` publishes `TikTokErrorEvent` with the exception, then its `onClose` runs with code `-1`, the client's state goes to `DISCONNECTED`, and `TikTokDisconnectedEvent` is published with that code, for which `isUnknownCloseCode()` is `true`. When TikTok answers the upgrade request with an HTTP error instead, Java-WebSocket closes with its protocol-error code `1002` through the same `onClose` path. `connect()` has already returned normally in both cases.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onError((client, event) -> System.err.println("Socket error: " + event.getException()))
+        .onDisconnected((client, event) -> {
+            if (event.isUnknownCloseCode()) {
+                System.err.println("The connection never opened or the connect attempt failed: " + event.getReason());
+            } else {
+                System.out.println("Closed with code " + event.getCode());
+            }
+        })
+        .buildAndConnect();
+```
+
+## Frames
+
+Every binary message from TikTok is a [`WebcastPushFrame`](/schema/webcast/webcastpushframe/), whose `Payload` is a [`ProtoMessageFetchResult`](/schema/webcast/protomessagefetchresult/), the same batch type the signing response carries. The listener parses the frame, drops frames with an empty payload, parses the batch, and hands it to the message handler. A frame or payload that does not parse throws `TikTokProtocolBufferException`, which carries the bytes in `getBytes()`; `onMessage` catches it and every other exception from handling and publishes `TikTokErrorEvent`. There is no decompression step: frames are parsed as received.
+
+When a batch has `needsAck` set, the listener sends an acknowledgement before handling it: a `WebcastPushFrame` with `PayloadType` `ack`, the incoming frame's `LogId`, and the batch's `internalExt` as the payload. After every message, after the handshake, and after an error the listener also sends a WebSocket ping frame through Java-WebSocket's `sendPing()`, when the socket is open. Text frames are ignored on the TikTok socket.
+
+## Heartbeats
+
+`WebSocketHeartbeatTask` sends the heartbeat. `onOpen` starts it with `pingInterval` from the client settings, `10000` milliseconds by default and at least `250`: a task on the daemon `heartbeat-pool` scheduler sends a fixed frame at once and then at that interval while the socket is open. The frame is the eight bytes `MgJwYjoCaGI=` in Base64, a `WebcastPushFrame` with `PayloadEncoding` `pb` and `PayloadType` `hb` and no payload. The task stops when the socket is no longer open, when `stop` is called, and when the socket closes; `start` replaces it with the new socket's task. The Euler Stream socket does not run it.
+
+## How a connection ends
+
+`stop(type)` cancels the heartbeat and detaches the socket from the client before closing it, so the close that follows is not treated as the current socket's. A socket whose handshake has not completed is closed with code `1000` without waiting. An open socket is closed according to the type: `NORMAL` (what `disconnect()` uses) starts the close handshake and returns; `CLOSE_BLOCKING` waits for it, and throws `TikTokLiveException` with the message `Failed to stop the websocket` if the wait is interrupted; `DISCONNECT` drops the connection with no handshake. The types are on the [connection page](/getting-started/connection/#disconnect).
+
+When the socket reports its close, the listener's `onClose` checks the socket against the client's. If it is still the client's, the client's `disconnect()` runs, which sets the state to `DISCONNECTED`, and `TikTokDisconnectedEvent` is published with the close code and reason. If `stop` had already detached it, your own `disconnect()` for instance, the event is published without a second `disconnect()`. A socket replaced by a newer `start` publishes nothing. The code is `1000` after a normal close from either side, `1006` when the connection dropped without a close frame, `1002` when TikTok rejected the handshake, and `-1` when the connection never opened. The client does not reconnect on its own; the [retry section](/getting-started/connection/#retry-when-the-creator-is-offline) shows a loop that does. `TikTokLiveEndedEvent` is a message, not a close: the socket stays open until you call `disconnect()` or TikTok closes it, see [stream control](/events/stream-control/).
+
+## The Euler Stream socket
+
+With `useEulerstreamWebsocket`, `TikTokWebSocketEulerClient.start` ignores the connection data, which is `null` on that path, and opens `wss://ws.eulerstream.com?uniqueId=<hostName>&apiKey=<apiKey>&features.rawMessages=true`, plus `&features.useEnterpriseApi=true` with `useEulerstreamEnterprise`, with the HTTP settings' headers and the same `toMillisPart()` timeout. It uses no proxy and no heartbeat task. The listener is a `TikTokWebSocketEulerListener`, which inherits the binary-frame handling above and adds text frames: a JSON object whose `messages` array holds a `workerInfo` message, logged at `INFO`, and a `roomInfo` message, mapped with `LiveUserDataMapper.mapEulerstream`, copied into `getRoomInfo()`, and published as the first `TikTokRoomInfoEvent`. A text frame that is not a JSON object, or that does not parse, is reported as `TikTokErrorEvent`; a JSON object without a `messages` array, or a message of another type, is ignored. These two messages arrive after the handshake, so `getRoomInfo()` is empty when `TikTokConnectedEvent` fires on this path; the fields the message fills are listed on the [HTTP client page](/advanced/http-client/#response-mappers).
+
+`stop` on this client closes the socket only when it is already open; a socket still in its handshake is dropped from the client without being closed. The Euler path is described from the settings side on the [signing page](/configuration/signing/#euler-stream-websocket).
+
+## The offline socket
+
+With `offline`, `TikTokWebSocketOfflineClient.start` publishes `TikTokConnectedEvent` at once and `stop` publishes `TikTokDisconnectedEvent` with the reason `Stopping` and code `-1`, but only once `start` has given it the client; `isConnected()` is always `false`. In this release `connect()` fails before `start` is reached, see [offline mode](/configuration/client-settings/#offline-mode), so `stop` has no client and `disconnect()` publishes nothing: on an offline client these two events come only from your own `publishEvent`. The exception is `offline` together with `useEulerstreamWebsocket`: that path makes no HTTP request, so `start` runs, `connect()` succeeds, and `disconnect()` publishes the `Stopping` event. The [offline testing guide](/guides/offline-testing/) covers what the mode is for.
+
+## Read the frames without the client
+
+The pieces are public, so a program can fetch the connection data with `TikTokLive.requests()` and open the signed URL with a Java-WebSocket client of its own, which shows the raw batches without any mapping. This reader prints the method name of every message, first from the signing response and then from each frame:
+
+```java
+import com.google.protobuf.InvalidProtocolBufferException;
+import io.github.jwdeveloper.tiktok.api.messages.webcast.ProtoMessageFetchResult;
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastPushFrame;
+import org.java_websocket.client.WebSocketClient;
+import org.java_websocket.handshake.ServerHandshake;
+
+import java.nio.ByteBuffer;
+
+var requests = TikTokLive.requests();
+var userData = requests.fetchLiveUserData("isaackogz");
+var connection = requests.fetchLiveConnectionData(userData.getRoomInfo().getRoomId());
+
+for (var message : connection.getWebcastResponse().getMessagesList()) {
+    System.out.println("initial " + message.getMethod());
+}
+
+var headers = new HashMap<>(LiveClientSettings.DefaultRequestHeaders());
+headers.put("Cookie", connection.getWebsocketCookies());
+
+var socket = new WebSocketClient(connection.getWebsocketUrl(), headers) {
+    @Override
+    public void onOpen(ServerHandshake handshake) {
+        System.out.println("Open");
+    }
+
+    @Override
+    public void onMessage(String text) {
+    }
+
+    @Override
+    public void onMessage(ByteBuffer bytes) {
+        try {
+            var frame = WebcastPushFrame.parseFrom(bytes.array());
+            var batch = ProtoMessageFetchResult.parseFrom(frame.getPayload());
+            for (var message : batch.getMessagesList()) {
+                System.out.println(message.getMethod());
+            }
+        } catch (InvalidProtocolBufferException e) {
+            System.err.println("Not a push frame: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public void onClose(int code, String reason, boolean remote) {
+        System.out.println("Closed " + code + " " + reason);
+    }
+
+    @Override
+    public void onError(Exception e) {
+        e.printStackTrace();
+    }
+};
+
+socket.connect();
+```
+
+`fetchLiveUserData` throws for an unknown creator and returns `NotFound` with a `null` room info for a malformed answer, so check `getUserStatus()` before reading the room id in anything but a sketch. The reader sends neither the `ack` frames nor the heartbeat the client sends; add both for anything beyond a look at the traffic. What the batches contain, and how a message becomes an event, is on the [protocol page](/advanced/protocol/).
diff --git a/docs/src/content/docs/configuration/authentication.md b/docs/src/content/docs/configuration/authentication.md
new file mode 100644
index 00000000..5347fc34
--- /dev/null
+++ b/docs/src/content/docs/configuration/authentication.md
@@ -0,0 +1,76 @@
+---
+title: Authentication
+description: When a TikTok session is needed, how to give the client your sessionId and ttTargetIdc cookies, where the client sends them, how sendChat and throwOnAgeRestriction use them, and the risks.
+sidebar:
+  order: 4
+---
+
+Reading a public livestream needs no TikTok account. The client's session settings are for:
+
+- `sendChat`, which posts as the account the session belongs to.
+- Age-restricted rooms. The settings' Javadoc describes a session as the way to receive 18+ content; `throwOnAgeRestriction`, below, decides what `connect()` does with such a room.
+- Chat completeness. The `sessionId` Javadoc notes that TikTok does not always send every chat message to a logged-out client, and the signing request forwards `sessionId`; the code comment there says this allows receiving all comments and subscribe events.
+
+## Session cookies
+
+TikTok identifies a logged-in session by the `sessionid` cookie together with `tt-target-idc`, the data center that holds the account. Copy both from your browser's cookies for `tiktok.com` while logged in and set `sessionId` and `ttTargetIdc` in `configure`. Set both: the Javadoc notes that `sessionId` is effective only with a correct `ttTargetIdc`.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setSessionId(System.getenv("TIKTOK_SESSION_ID"));
+            settings.setTtTargetIdc(System.getenv("TIKTOK_TARGET_IDC"));
+        })
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+`TIKTOK_SESSION_ID` and `TIKTOK_TARGET_IDC` are names this example reads itself; the library reads no environment variables.
+
+## Where the session goes
+
+While the two settings are set, the client sends them with these requests and nowhere else:
+
+| Request | Destination | What is sent |
+| --- | --- | --- |
+| Creator's user data, `api-live/user/room` | `www.tiktok.com` | `sessionid` and `tt-target-idc` as cookies |
+| Room info, `webcast/room/info` | `webcast.tiktok.com` | `sessionid` and `tt-target-idc` as cookies |
+| Signing request | The signing provider | `sessionid` as the `session_id` query parameter |
+| `sendChat` | The provider's chat endpoint | `sessionId`, `ttTargetIdc`, `roomId`, and `content` as a JSON body |
+
+The gift list request carries no session, the WebSocket handshake sends the cookies from the signing response, and the Euler Stream WebSocket URL carries the `apiKey` only. A `null` value is skipped, so with no session the cookies are not sent at all. See [signing](/configuration/signing/) for the rest of the signing request.
+
+## Sending chat messages
+
+`client.sendChat(content)` posts a message to the connected room with the `sessionId` and `ttTargetIdc` from the settings; `sendChat(content, sessionId, ttTargetIdc)` takes them per call. The request goes to the provider's chat endpoint with the client's `roomId`, so call it after `connect()` has filled the room info, and it carries the `x-api-key` header when `apiKey` is set. The method returns `true` when the provider answers HTTP 200. The interface's Javadoc warns that it is known to return `true` for some session ids although the message was not posted, a TikTok-side behaviour the library cannot detect. In [offline mode](/configuration/client-settings/#offline-mode) it returns `false`.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setSessionId(System.getenv("TIKTOK_SESSION_ID"));
+            settings.setTtTargetIdc(System.getenv("TIKTOK_TARGET_IDC"));
+        })
+        .buildAndConnect();
+
+boolean accepted = client.sendChat("Hello from TikTokLiveJava");
+System.out.println(accepted ? "Sent" : "Rejected");
+```
+
+## Age-restricted rooms
+
+`throwOnAgeRestriction` is `false` by default. When it is `true`, `connect()` throws `TikTokLiveException` with the message `Livestream for <hostName> is 18+ or age restricted!` as soon as the room info reports the restriction, before `TikTokPreConnectionEvent` and before any signing request. When it is `false`, the connection continues; `getRoomInfo().isAgeRestricted()` and `TikTokPreConnectionEvent.getRoomData().isAgeRestricted()` report the restriction, and a pre-connection handler can cancel the connection itself, as shown on the [connection lifecycle](/getting-started/connection/#lifecycle-events) page.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setThrowOnAgeRestriction(true))
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+## Risks
+
+A TikTok session id grants full access to the account it belongs to.
+
+- It leaves your machine. Every request in the table above sends it, to TikTok and to the signing provider; the provider receives it with each signing request while the setting is set. How the provider handles it is described in [Euler Stream's documentation](https://www.eulerstream.com/docs), not here.
+- Keep it out of source control and logs. Read it from the environment or a secret store, as the examples above do, and clear the settings when a client no longer needs them.
+- Prefer a secondary account over your own, and do not set a session unless you need one of the three uses above.
diff --git a/docs/src/content/docs/configuration/client-settings.md b/docs/src/content/docs/configuration/client-settings.md
new file mode 100644
index 00000000..0611664e
--- /dev/null
+++ b/docs/src/content/docs/configuration/client-settings.md
@@ -0,0 +1,74 @@
+---
+title: Client settings
+description: Every field of LiveClientSettings, its type, default, and effect, how configure applies them, what build validates, and offline mode for tests.
+sidebar:
+  order: 1
+---
+
+`LiveClientSettings` holds the configuration of one client. `TikTokLive.newClient(hostName)` starts from `LiveClientSettings.createDefault()` with `hostName` set, and the builder's `configure(Consumer<LiveClientSettings>)` hands you that object to change. Each `configure` call runs at once and can be repeated; `build()` validates the result and shares the same object with the built client, so set everything before building.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setFetchGifts(true);
+            settings.setClientLanguage("de-DE");
+            settings.setPingInterval(5000);
+        })
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+The fields are Lombok properties: `fetchGifts` is read with `isFetchGifts()` and written with `setFetchGifts(boolean)`, `logLevel` with `getLogLevel()` and `setLogLevel(Level)`. `TikTokLive.requests(Consumer<LiveClientSettings>)` accepts the same settings for a standalone `LiveHttpClient`, the kind of client behind `isLiveOnline`; see [HTTP settings](/configuration/http-settings/).
+
+## Fields
+
+The defaults are the values after `TikTokLive.newClient`, which calls `createDefault()`. One of them, `printToConsole`, differs from the field initialiser, as noted; the other such default, the HTTP `timeout`, is on the [HTTP settings](/configuration/http-settings/) page.
+
+| Field | Type | Default | Effect |
+| --- | --- | --- | --- |
+| `offline` | `boolean` | `false` | Replaces the HTTP and WebSocket clients with stand-ins that send nothing to TikTok or the signing provider. See [Offline mode](#offline-mode). |
+| `fetchGifts` | `boolean` | `false` | When `true`, `connect()` downloads the room's gift list after `TikTokPreConnectionEvent`, so `getGiftManager()` knows every gift before the first `TikTokGiftEvent`. When `false`, the manager starts empty and adds each gift from the first message that carries it. See [gifts](/guides/gifts/). |
+| `clientLanguage` | `String` | `"en-US"` | Sent to TikTok as the `app_language` and `webcast_language` request parameters. `build()` replaces `null` or an empty string with `"en"`. |
+| `retryOnConnectionFailure` | `boolean` | `false` | Call `connect()` again when the creator is offline. See [connection lifecycle](/getting-started/connection/#retry-when-the-creator-is-offline). |
+| `retryConnectionTimeout` | `Duration` | 1 second | The wait before each retry. See [connection lifecycle](/getting-started/connection/#retry-when-the-creator-is-offline). |
+| `printToConsole` | `boolean` | `false` | When `false`, the client's logger is set to `Level.OFF`. The field initialiser is `true`; `createDefault()` sets `false`. See [logging](/configuration/logging/). |
+| `logLevel` | `java.util.logging.Level` | `Level.ALL` | The level of the client's logger when `printToConsole` is `true`. See [logging](/configuration/logging/). |
+| `hostName` | `String` | The `newClient` argument | The creator's username. `build()` removes a leading `@` and throws `TikTokLiveException` when it is `null` or empty. See [proxies and host](/configuration/proxies-and-host/). |
+| `httpSettings` | `HttpClientSettings` | TikTok's web-client parameters and headers, a 3-second timeout, no proxy | Parameters, headers, cookies, timeout, proxies, and transport hooks for every HTTP request and the WebSocket handshake. See [HTTP settings](/configuration/http-settings/). |
+| `pingInterval` | `long` | `10000` | Milliseconds between heartbeats once the socket is open. `build()` throws `TikTokLiveException` for a value under `250`. Not used on the Euler Stream WebSocket path. |
+| `throwOnAgeRestriction` | `boolean` | `false` | When `true`, `connect()` throws `TikTokLiveException` for an age-restricted room instead of connecting. See [authentication](/configuration/authentication/). |
+| `useEulerstreamWebsocket` | `boolean` | `false` | Receive events from Euler Stream's WebSocket instead of connecting to TikTok. Needs `apiKey`. See [signing](/configuration/signing/). |
+| `useEulerstreamEnterprise` | `boolean` | `false` | Use Euler Stream's enterprise endpoints for signing, chat, and the WebSocket. See [signing](/configuration/signing/). |
+| `sessionId` | `String` | `null` | Your TikTok `sessionid` cookie. Sent with TikTok's user and room requests, the signing request, and `sendChat`. See [authentication](/configuration/authentication/). |
+| `ttTargetIdc` | `String` | `null` | Your TikTok `tt-target-idc` cookie, needed with `sessionId`. See [authentication](/configuration/authentication/). |
+| `roomId` | `String` | `null` | Not read by the client in this checkout: `connect()` always takes the room id from the creator's user data. Setting it has no effect. |
+| `apiKey` | `String` | `null` | Your Euler Stream API key. Sent as the `x-api-key` header of the signing and chat requests and in the Euler Stream WebSocket URL. See [signing](/configuration/signing/). |
+
+## What `build()` validates
+
+`build()` runs these checks and adjustments before wiring the client, in this order:
+
+1. An empty or `null` `clientLanguage` becomes `"en"`.
+2. An empty or `null` `hostName` throws `TikTokLiveException` with the message `HostName can not be null`; a leading `@` is removed.
+3. A `pingInterval` under `250` throws `TikTokLiveException` with the message `Minimum allowed ping interval is 250 milliseconds`.
+4. `clientLanguage` is written into the HTTP parameters `app_language` and `webcast_language`.
+
+Nothing else is validated: an `apiKey` or a session is checked only by the server that receives it.
+
+## Offline mode
+
+With `offline` set to `true`, `build()` wires `TikTokLiveHttpOfflineClient` and `TikTokWebSocketOfflineClient` in place of the real clients. No request leaves the process, and `sendChat` returns `false`. Use it to test handlers with `publishEvent`, which dispatches an event object to your handlers, and `publishMessage`, which runs a raw Webcast message through the same mapping as a socket message; both work whether or not the client is connected.
+
+In this checkout, `connect()` in offline mode stops with a logged `NullPointerException` before the stand-in socket starts, because the offline HTTP client returns no room info. `connect()` does not throw; it logs `Unhandled exception`, prints the stack trace, and sets the state back to `DISCONNECTED` without publishing `TikTokConnectedEvent`. The one exception is `useEulerstreamWebsocket` set as well, which skips the HTTP requests, so `connect()` reaches the stand-in socket and succeeds. `build()` and `publishEvent` are enough for a test, so skip `connect()`.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setOffline(true))
+        .onComment((liveClient, event) ->
+                System.out.println(event.getUser().getProfileName() + ": " + event.getText()))
+        .build();
+
+client.publishEvent(TikTokCommentEvent.of("Mark", "Hello world"));
+```
+
+The event classes have `of` factories for tests: `TikTokCommentEvent.of(userName, message)`, `TikTokGiftEvent.of(gift)`, `TikTokLikeEvent.of(userName, likes)`, `TikTokFollowEvent.of(userName)`, among others. The repository's `Events_And_Gifts_Testing_Example` also shows `publishMessage` with a Base64 `WebcastLikeMessage` payload.
diff --git a/docs/src/content/docs/configuration/http-settings.md b/docs/src/content/docs/configuration/http-settings.md
new file mode 100644
index 00000000..9e6bfb19
--- /dev/null
+++ b/docs/src/content/docs/configuration/http-settings.md
@@ -0,0 +1,59 @@
+---
+title: HTTP settings
+description: Every field of HttpClientSettings, request parameters, headers, cookies, timeout, proxy settings, and the hooks on the HTTP transport and on each request.
+sidebar:
+  order: 2
+---
+
+`HttpClientSettings` is the `httpSettings` field of `LiveClientSettings`, reached in `configure` with `settings.getHttpSettings()`. It shapes every HTTP request the client sends, the user, room, and gift requests to TikTok and the signing and chat requests to the provider, and it supplies the headers and connect timeout of the WebSocket handshake.
+
+Each request starts from a `clone()` of the settings, so the values you set are the baseline for every request and nothing one request adds to the maps leaks into the next. The `java.net.http.HttpClient` behind the requests is created once per client, on its first request, from the settings at that moment.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            var http = settings.getHttpSettings();
+            http.setTimeout(Duration.ofSeconds(10));
+            http.getHeaders().put("Accept-Language", "fr-FR,fr;q=0.9");
+            http.getParams().put("tz_name", "Europe/Paris");
+            http.onRequestCreating(request -> request.header("X-Request-Source", "my-bot"));
+        })
+        .buildAndConnect();
+```
+
+## Fields
+
+| Field | Type | Default | Effect |
+| --- | --- | --- | --- |
+| `params` | `Map<String, Object>` | `LiveClientSettings.DefaultClientParams()`: `aid`, `app_name`, `browser_name`, `browser_version`, `device_platform`, `screen_width`, `tz_name`, and the other parameters of TikTok's web client | Appended to every request URL as its URL-encoded query string. The map is a `TreeMap`, so the parameters are sent sorted by name. `build()` sets `app_language` and `webcast_language` from `clientLanguage`. |
+| `headers` | `Map<String, String>` | `LiveClientSettings.DefaultRequestHeaders()`: `User-Agent`, `Referer`, `Origin`, `Accept`, `Accept-Language`, `Cache-Control`, `authority` | Set on every request, and sent in the WebSocket handshake on both the TikTok socket and the Euler Stream socket. |
+| `cookies` | `Map<String, String>` | Empty | Joined into one `Cookie` header, `name=value; name=value`, when the map is not empty. The client adds `sessionid` and `tt-target-idc` from `LiveClientSettings` to TikTok's user and room requests. The WebSocket handshake sends the cookies from the signing response, not this map. |
+| `proxyClientSettings` | `ProxyClientSettings` | Disabled, no proxies | Proxy list, type, rotation, and failure handling; `configureProxy` enables it. See [proxies and host](/configuration/proxies-and-host/). |
+| `onClientCreating` | `Consumer<HttpClient.Builder>` | No-op | Called once, when the client's `java.net.http.HttpClient` is created on the first request, after redirect following, a `CookieManager`, the connect timeout, and the proxy selector are set. Set it with `onClientCreating(Consumer)`. |
+| `onRequestCreating` | `Consumer<HttpRequest.Builder>` | No-op | Called for every request after the URI, timeout, and headers are set and before the request is built. Set it with `onRequestCreating(Consumer)`. |
+| `timeout` | `Duration` | 3 seconds | The connect timeout of the HTTP transport and the timeout of each request. The constructor's own default is 2 seconds; `createDefault()` sets 3. See [the timeout and sub-second parts](#the-timeout-and-sub-second-parts). |
+
+`params`, `headers`, and `cookies` are final maps with getters only: change their entries with `put` and `remove`. `proxyClientSettings` and `timeout` have setters; the two hooks are set through the methods named after them.
+
+## The timeout and sub-second parts
+
+The HTTP transport and each request receive the whole `Duration`. The WebSocket handshake, and the SOCKS proxy path, receive `timeout.toMillisPart()`, the millisecond fraction of the duration (0 to 999), as a connect timeout in milliseconds, and the SOCKS path uses the same value as its read timeout. With a whole-second value such as the default that is `0`, which `Socket.connect` treats as no timeout. `Duration.ofMillis(2500)` gives the HTTP requests 2.5 seconds and the WebSocket handshake 500 milliseconds.
+
+## Default parameters and headers
+
+The defaults present the client as TikTok's web client in Chrome 102 on Windows: the `User-Agent` header and the `browser_version` parameter carry that string, `aid` is `1988`, `app_name` is `tiktok_web`, and `tz_name` is `Europe/Berlin`. `DefaultClientParams()` and `DefaultRequestHeaders()` are public static methods of `LiveClientSettings`, so you can print the full lists:
+
+```java
+LiveClientSettings.DefaultClientParams().forEach((name, value) -> System.out.println(name + "=" + value));
+LiveClientSettings.DefaultRequestHeaders().forEach((name, value) -> System.out.println(name + ": " + value));
+```
+
+## Requests outside a client
+
+`TikTokLive.requests(Consumer<LiveClientSettings>)` returns the `LiveHttpClient` the static checks use, configured with the same settings, so a live check can go through your proxy or carry your headers. `TikTokLive.isLiveOnline` and `isHostNameValid` use the defaults.
+
+```java
+var requests = TikTokLive.requests(settings -> settings.getHttpSettings().setTimeout(Duration.ofSeconds(10)));
+var userData = requests.fetchLiveUserData(new LiveUserData.Request("isaackogz"));
+System.out.println(userData.isLiveOnline());
+```
diff --git a/docs/src/content/docs/configuration/logging.md b/docs/src/content/docs/configuration/logging.md
new file mode 100644
index 00000000..2e8f8811
--- /dev/null
+++ b/docs/src/content/docs/configuration/logging.md
@@ -0,0 +1,63 @@
+---
+title: Logging
+description: The client's java.util.logging logger, the printToConsole and logLevel settings, what the client logs, and how to route the log to your own handler.
+sidebar:
+  order: 6
+---
+
+Each client logs through a `java.util.logging.Logger` named after its `hostName`, returned by `client.getLogger()`. The client is silent by default: `printToConsole` is `false` after `TikTokLive.newClient`, and that sets the logger to `Level.OFF`.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setPrintToConsole(true);
+            settings.setLogLevel(Level.INFO);
+        })
+        .onConnected((client, event) ->
+                client.getLogger().info("Connected to " + client.getRoomInfo().getHostName()))
+        .buildAndConnect();
+```
+
+## Settings
+
+| Field | Type | Default | Effect |
+| --- | --- | --- | --- |
+| `printToConsole` | `boolean` | `false` | When `false`, the logger's level is set to `Level.OFF` and nothing is logged. The field initialiser is `true`; `createDefault()` sets `false`. |
+| `logLevel` | `java.util.logging.Level` | `Level.ALL` | The logger's level when `printToConsole` is `true`. |
+
+Both are read once, when `build()` creates the logger. If a logger with that name already has a handler, from an earlier client for the same `hostName` in the same JVM, `build()` reuses it as it is and both settings of the new client are ignored.
+
+## The console handler
+
+When `build()` creates the logger, it adds a `ConsoleHandler`, which writes to `System.err`, with a formatter that prints `[hostName] [LEVEL]: message` in ANSI colours, and it stops the record from reaching the parent loggers, so the root logger's configuration does not apply. The handler keeps the JDK's default handler level, `INFO`: with `logLevel` at `Level.ALL`, records below `INFO` reach the logger but the handler drops them. Lower the handler's level to see them.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setPrintToConsole(true))
+        .build();
+
+for (var handler : client.getLogger().getHandlers()) {
+    handler.setLevel(Level.ALL);
+}
+```
+
+## What the client logs
+
+At `INFO`: every state change as `TikTokLive client state: CONNECTING`, `CONNECTED`, or `DISCONNECTED`; `Reconnecting` before each retry; the `workerInfo` message on the Euler Stream WebSocket path. At `WARNING`: the signing response's headers when it lacks the `x-set-tt-cookie` header, and malformed JSON in the creator's user data, whether from TikTok or from the Euler Stream `roomInfo` message, with the exception attached. The HTTP client logs through a second logger named `HttpClient-<hash>`, created with the same settings.
+
+Exceptions thrown by a handler, by the socket, or by the connect sequence are published as `TikTokErrorEvent` rather than logged; register `onError` to see them, see [connection lifecycle](/getting-started/connection/#lifecycle-events). An unexpected exception in `connect()` that is not a `TikTokLiveException` logs `Unhandled exception` at `INFO` and prints its stack trace to `System.err` regardless of the settings.
+
+## Your own handler
+
+The logger is a standard `java.util.logging.Logger`: remove the console handler and add your own, or forward it to a bridge for another logging framework. Set the logger's level too, because it is `Level.OFF` while `printToConsole` is `false`.
+
+```java
+var client = TikTokLive.newClient("isaackogz").build();
+var logger = client.getLogger();
+
+for (var handler : logger.getHandlers()) {
+    logger.removeHandler(handler);
+}
+logger.addHandler(new FileHandler("tiktok-live.log", true));
+logger.setLevel(Level.INFO);
+```
diff --git a/docs/src/content/docs/configuration/proxies-and-host.md b/docs/src/content/docs/configuration/proxies-and-host.md
new file mode 100644
index 00000000..43b99171
--- /dev/null
+++ b/docs/src/content/docs/configuration/proxies-and-host.md
@@ -0,0 +1,71 @@
+---
+title: Proxies and host
+description: The hostName setting, and ProxyClientSettings, the proxy list, type, rotation, discard and fallback behaviour, and how the HTTP requests and the WebSocket use it.
+sidebar:
+  order: 5
+---
+
+## Host name
+
+`hostName` is the creator's username, the part after `@` in `https://www.tiktok.com/@isaackogz/live`. `TikTokLive.newClient(hostName)` sets it, and `setHostName` in `configure` replaces it. `build()` removes a leading `@` and throws `TikTokLiveException` with the message `HostName can not be null` when the value is `null` or empty. The built client reports it as `getRoomInfo().getHostName()`, names its logger after it, and sends it as `uniqueId` to TikTok's user-data request and to the Euler Stream WebSocket.
+
+```java
+var client = TikTokLive.newClient("@isaackogz").build();
+System.out.println(client.getRoomInfo().getHostName());
+```
+
+`TikTokLive.isHostNameValid(hostName)` asks TikTok whether a username exists; see [connection lifecycle](/getting-started/connection/#check-whether-a-creator-is-live).
+
+## Proxies
+
+`ProxyClientSettings` is the `proxyClientSettings` field of the [HTTP settings](/configuration/http-settings/). `configureProxy(Consumer<ProxyClientSettings>)` on `HttpClientSettings` sets `enabled` to `true` and runs your consumer; with `enabled` left `false`, the other fields have no effect.
+
+```java
+import java.net.Proxy;
+
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.getHttpSettings().configureProxy(proxy -> {
+            proxy.setType(Proxy.Type.HTTP);
+            proxy.addProxy("203.0.113.10:8080");
+            proxy.addProxy("203.0.113.11", 8080);
+            proxy.setRotation(ProxyClientSettings.Rotation.RANDOM);
+            proxy.setOnProxyUpdated(proxyData ->
+                    System.out.println("Using " + proxyData.getAddress() + ":" + proxyData.getPort()));
+        }))
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+### Fields
+
+| Field | Type | Default | Effect |
+| --- | --- | --- | --- |
+| `enabled` | `boolean` | `false` | Whether requests use the proxy list. `configureProxy` sets it. |
+| `type` | `java.net.Proxy.Type` | `DIRECT` | `HTTP`, and `DIRECT` once proxies are enabled, send requests through the JDK HTTP client with the selected endpoint as an HTTP proxy. `SOCKS` opens an `HttpsURLConnection` through the endpoint as a SOCKS proxy; see [SOCKS and certificates](#socks-and-certificates). |
+| `proxyList` | `List<ProxyData>` | Empty | The endpoints. Add them with `addProxy("host:port")`, `addProxy(host, port)`, `addProxy(InetSocketAddress)`, or `addProxies(List<String>)`. `getProxiesSnapshot()` returns a copy for iteration. |
+| `rotation` | `Rotation` | `CONSECUTIVE` | How `next()` picks an endpoint: `CONSECUTIVE` walks the list in order and wraps, `RANDOM` picks any entry, `NONE` stays on `index`. |
+| `index` | `int` | `0` | The current position in the list. `setIndex` throws `IndexOutOfBoundsException` for a value outside the list. |
+| `autoDiscard` | `boolean` | `true` | Remove an endpoint from the list when a connection through it fails. |
+| `fallback` | `boolean` | `true` | When a request through a proxy fails with an `IOException` whose message contains `503`, send it again without a proxy. |
+| `allowWebsocket` | `boolean` | `true` | Whether the WebSocket also connects through the proxy list. |
+| `onProxyUpdated` | `Consumer<ProxyData>` | No-op | Called with each endpoint `next()` selects. |
+
+`ProxyData` holds an `address` and a `port` and nothing else; there is no field for proxy credentials. `addProxy("host:port")` parses with `ProxyData.map`, which throws `IllegalArgumentException` when the port is not an integer or the address does not resolve, and `IndexOutOfBoundsException` when the port is outside 0 to 65535.
+
+### How a request uses the list
+
+For each HTTP request, the client builds `HttpProxyClient` when proxies are enabled and the list is not empty, and the plain `HttpClient` otherwise. `HttpProxyClient` selects an endpoint with `next()` and sends the request through it:
+
+- With `HTTP` or `DIRECT`, a response other than 200 moves on to the next endpoint; `hasNext()` is `true` while the list is not empty, so endpoints that answer with another status are tried again in rotation. A connect timeout or `ConnectException` removes the endpoint when `autoDiscard` is `true` and throws `TikTokProxyRequestException`; the client's `fetch` methods catch that and start the request again while endpoints remain, then make one last attempt without a proxy. Any other `IOException` throws it too, unless `fallback` applies.
+- With `SOCKS`, one endpoint is tried per attempt; an `IOException` removes it when `autoDiscard` is `true` and throws `TikTokProxyRequestException`, with the same retry by the `fetch` methods.
+- `TikTokLiveRequestException` with the message `No more proxies available!` is raised when the list runs empty inside one attempt. The `HTTP` and `DIRECT` path throws it; the `SOCKS` path catches it, prints its stack trace, and returns a failed result instead.
+
+The signing request is repeated on `TikTokSignServerException` as well as on `TikTokProxyRequestException`, while endpoints remain and then once without a proxy; see [signing](/configuration/signing/).
+
+### The WebSocket
+
+When proxies are enabled and `allowWebsocket` is `true`, the socket to TikTok connects through the list: the client walks the endpoints with `next()`, sets each as the socket's `java.net.Proxy` of the configured `type`, and tries to connect; a failure removes the endpoint when `autoDiscard` is `true`. When the list runs empty, `connect()` throws `TikTokLiveException` with the message `Failed to connect to the websocket`. The Euler Stream WebSocket (`useEulerstreamWebsocket`) does not use the proxy settings; the HTTP requests of that client, such as `sendChat`, still do.
+
+### SOCKS and certificates
+
+With `type` set to `SOCKS`, both the HTTP requests and the WebSocket install an SSL context whose trust manager accepts every certificate, so the TLS connections made through a SOCKS proxy are not verified against the server's certificate chain. Use `HTTP` proxies when that matters.
diff --git a/docs/src/content/docs/configuration/signing.md b/docs/src/content/docs/configuration/signing.md
new file mode 100644
index 00000000..864a6dd0
--- /dev/null
+++ b/docs/src/content/docs/configuration/signing.md
@@ -0,0 +1,76 @@
+---
+title: Signing
+description: How TikTokLiveJava obtains its WebSocket connection from Euler Stream, what the apiKey setting does, how rate limits and provider errors surface, and the useEulerstreamWebsocket and useEulerstreamEnterprise paths.
+sidebar:
+  order: 3
+---
+
+TikTokLiveJava does not build the Webcast WebSocket URL itself. During `connect()`, after the room data is fetched, it asks a signing provider for the first fetch result and the signed WebSocket URL. The provider is [Euler Stream](https://www.eulerstream.com/), reached at `https://tiktok.eulerstream.com/webcast/fetch`; the URL is a constant of `TikTokLiveHttpClient`, and there is no setting for another provider. Signing works without an account; an API key raises the limits that apply to you. Plans, limits, and endpoint permissions are set by the provider and described in [Euler Stream's documentation](https://www.eulerstream.com/docs), not here.
+
+## What is sent to the provider
+
+Each connection attempt makes a GET request to the provider. It carries the default [HTTP settings](/configuration/http-settings/) parameters and headers, including the `User-Agent`, plus:
+
+- `client=ttlive-java` and `room_id` as query parameters.
+- `session_id`, only when `sessionId` is set; see [authentication](/configuration/authentication/).
+- The `x-api-key` header, only when `apiKey` is set.
+
+The response's `x-set-tt-cookie` header holds the cookies the WebSocket handshake sends to TikTok. Its body is a `ProtoMessageFetchResult`: the client builds the WebSocket URL from its push server, cursor, internal ext, and route parameters, and dispatches the messages it already contains to your handlers before the socket opens.
+
+The requests to TikTok's own API, the creator's user data at `www.tiktok.com`, and the room info and the gift list at `webcast.tiktok.com`, are not signed and do not touch the provider. `sendChat` is the other request that does: it posts to the provider's chat endpoint, `https://tiktok.eulerstream.com/webcast/chat`.
+
+## API key
+
+Set `apiKey` in `configure`. The client sends it as the `x-api-key` header of the signing and chat requests and as the `apiKey` query parameter of the Euler Stream WebSocket URL. The library reads no environment variable itself; the example reads one and passes it on.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setApiKey(System.getenv("EULER_API_KEY")))
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+## Rate limits and provider errors
+
+The signing request must answer HTTP 200. Any other status makes `connect()` throw `TikTokSignServerException`, whose message starts with `Unable to get websocket connection credentials` and carries the status code and one of these notes:
+
+| Status | Note |
+| --- | --- |
+| `429` | `Sign server rate limit reached. Try again in mm:ss.`, computed from the `ratelimit-reset` header in seconds, or `Try again later.` when the header is missing. |
+| `420` | `IP Cloudflare Blocked.` |
+| `500` to `503` | `Sign server Error. Try again later.` |
+| `504` | `Sign server Timeout. Try again later.` |
+| Any other | The status code alone. |
+
+`TikTokSignServerException` is also thrown when a 200 response has no `x-set-tt-cookie` header, after the client logs the response headers at `WARNING`, and when its body is not a valid `ProtoMessageFetchResult`. Without proxies, the client does not retry a failed signing request; `retryOnConnectionFailure` covers an offline creator only, see [connection lifecycle](/getting-started/connection/#retry-when-the-creator-is-offline). Each connection attempt spends one signing request, so poll with `TikTokLive.isLiveOnline`, which asks TikTok directly, rather than by connecting.
+
+```java
+try {
+    TikTokLive.newClient("isaackogz").buildAndConnect();
+} catch (TikTokSignServerException e) {
+    System.err.println("Signing failed: " + e.getMessage());
+}
+```
+
+With proxies enabled, the signing request is repeated through the proxy list on `TikTokProxyRequestException` and `TikTokSignServerException` while endpoints remain, then once without a proxy; see [proxies and host](/configuration/proxies-and-host/).
+
+## Euler Stream WebSocket
+
+With `useEulerstreamWebsocket` set to `true`, the client receives its events from the managed [TikTok LIVE WebSocket API](https://www.eulerstream.com/websockets) instead of connecting to TikTok. `connect()` publishes `TikTokConnectingEvent`, opens `wss://ws.eulerstream.com` with `uniqueId` set to `hostName`, `apiKey` set to your key, and `features.rawMessages=true`, sends the HTTP settings' headers in the handshake, and sets the state to `CONNECTED`. On this path the client makes no request to TikTok and no signing request, publishes no `TikTokPreConnectionEvent`, downloads no gift list, starts no `pingInterval` heartbeat (the socket listener answers each message with a ping instead), and ignores the proxy settings. An `apiKey` is required; without one the URL carries `apiKey=null`.
+
+The first two messages are JSON: `workerInfo`, which the client logs at `INFO`, and `roomInfo`, which fills `getRoomInfo()` and publishes the first `TikTokRoomInfoEvent`. Binary frames go through the same message handler as on the TikTok socket, so your handlers receive the same events. See [connection lifecycle](/getting-started/connection/#the-connect-sequence) for what differs in the lifecycle.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setApiKey(System.getenv("EULER_API_KEY"));
+            settings.setUseEulerstreamWebsocket(true);
+        })
+        .onRoomInfo((client, event) -> System.out.println("Room " + event.getRoomInfo().getRoomId()))
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+## Enterprise endpoints
+
+With `useEulerstreamEnterprise` set to `true`, the signing request goes to `https://tiktok.enterprise.eulerstream.com/webcast/fetch`, `sendChat` posts to `https://tiktok.enterprise.eulerstream.com/webcast/chat`, and the Euler Stream WebSocket URL gains `features.useEnterpriseApi=true`. The setting's Javadoc notes that it requires an API key; what that key must be entitled to is decided by the provider.
diff --git a/docs/src/content/docs/contributing.md b/docs/src/content/docs/contributing.md
new file mode 100644
index 00000000..9343e51e
--- /dev/null
+++ b/docs/src/content/docs/contributing.md
@@ -0,0 +1,88 @@
+---
+title: Contributing to the docs
+description: Build, check, and maintain the documentation site alongside the library source, with the authoring rules the build enforces.
+---
+
+## Run locally
+
+The documentation is a Starlight project under `docs/`, with its own `package.json` and lockfile. The reference generator and the content check are a small Maven project under `docs/tools/` that reads the library's sources, and the content check compiles every Java example against the built library, so the site is built from a checkout of the repository with the library built.
+
+Prerequisites:
+
+- JDK 17 or newer and Maven. The library targets Java 16; the documentation tool compiles with `--release 17`, and the content check needs a JDK rather than a JRE for its compiler. CI uses Temurin 17.
+- Node.js 24 and pnpm 10.34.2. `npx -y pnpm@10.34.2` runs the pinned pnpm without a global install.
+
+From the repository root:
+
+```sh
+npx -y pnpm@10.34.2 --dir docs install --frozen-lockfile
+npx -y pnpm@10.34.2 --dir docs build
+```
+
+| Command | What it does |
+| --- | --- |
+| `pnpm --dir docs lib:build` | Builds the `API`, `Client`, `extension-recorder`, and `extension-collector` modules and writes each module's classpath to `target/classpath.txt`: `mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests install dependency:build-classpath -Dmdep.outputFile=target/classpath.txt`. About a minute; the example compiler needs it. |
+| `pnpm --dir docs tools:build` | Packages the documentation tool as `docs/tools/target/docs-tools.jar`. |
+| `pnpm --dir docs check` | Runs the tool's `check` command: the content check described below. Needs both builds above. |
+| `pnpm --dir docs generate` | Runs the tool's `generate` command: writes the `api/` and `schema/` reference pages. |
+| `pnpm --dir docs build` | `lib:build`, `tools:build`, `check`, `generate`, then `astro build` with link validation. This is what CI runs. |
+| `pnpm --dir docs dev` | Starts the Astro dev server on `127.0.0.1`. Run `generate` once first so the reference sections exist. |
+| `pnpm --dir docs preview` | Serves the last build from `docs/dist`. |
+| `pnpm --dir docs test` | The SEO gate's own tests, with `node --test`. |
+| `pnpm --dir docs run seo` | The SEO gate over `docs/dist`, see [hosting](/hosting/#seo-gate). |
+| `mvn -q -f docs/tools/pom.xml test` | The documentation tool's JUnit tests: the generator, the proto parser, the content check, and the example compiler. |
+
+With `npx` in place of a global pnpm: `npx -y pnpm@10.34.2 --dir docs check`.
+
+## Where to edit
+
+- Authored pages are Markdown under `docs/src/content/docs/`: the start-here pages, `configuration/`, `guides/`, `events/`, `advanced/`, and the top-level pages.
+- `api/` and `schema/` inside that directory are generated on every build from the `API` and `Client` sources and the `.proto` files, and are ignored by Git. Never edit or commit them. To change a reference page, edit the Javadoc or the signature at the source declaration; to change a schema page, edit the `.proto` file.
+- The event catalog on `events/index.md` and the grouped event pages are authored. A catalog row's type cell is compared with the event class's `@EventMeta` category, and the README's events list is compared with the `EventsBuilder` handlers, so a new event needs its class, its handler, its catalog row, and its section.
+- The sidebar, the site title and description, the header links, and the footer are in `docs/astro.config.mjs`.
+- The tool is in `docs/tools/src/main/java/docs/`, with tests in `docs/tools/src/test/java/docs/`: `ApiPages` and `SchemaPages` generate, `ContentCheck` and `ExampleCompiler` check.
+
+## Authoring rules
+
+The build enforces these; a page that breaks one fails `pnpm --dir docs build`.
+
+- Every ```` ```java ```` fence compiles against the built library. A fence that declares a top-level `class`, `interface`, `record`, or `enum` is compiled as its own file with the imports it carries, so a listener class or a `main` example is written complete. Any other fence is a fragment: its statements are placed in a method body, `void run() throws Exception`, with a wildcard import of every package of the `API` and `Client` sources and of `java.util`, `java.time`, `java.util.function`, `java.util.logging`, and `java.io`, and `import` lines inside the fragment are hoisted above the class. The generated protobuf packages are not wildcard-imported, so a fragment that names `WebcastChatMessage` or another message class carries its own `import` line. Checked exceptions need no handling in a fragment; a lambda parameter must not reuse the name of a local variable. A snippet that should not compile goes in prose or in another fence language.
+- Shell commands use ```` ```sh ```` fences; Maven coordinates use ```` ```xml ````, Gradle ```` ```groovy ````. Only Java fences are compiled.
+- No Discord links in page text. The header button is the one Discord link on the site, and the report channel named on pages is GitHub issues.
+- Links to [Euler Stream](https://www.eulerstream.com/) are plain Markdown links, dofollow, with no `rel` attribute. Every page carries at least one; the SEO gate described on the [hosting page](/hosting/) checks it.
+- Internal links are site-relative with a trailing slash, `/configuration/signing/`, and point at pages that exist; the build validates them. Event anchors are the lowercase class name on the grouped page, `/events/gifts-and-goals/#tiktokgiftevent`.
+- Frontmatter has `title` and `description`; pages in an autogenerated sidebar group also set `sidebar.order`.
+- An event, settings field, handler, exception, or extension name counts as documented only as its own code span: `` `onComment` `` counts, `` `client.onComment(...)` `` does not.
+
+## Where facts come from
+
+Describe the library as it is in the checkout, not as the README or an older page says it was. In order:
+
+1. The library source: `API/src/main/java` for the interfaces, events, settings, and exceptions, `Client/src/main/java` for the client, the HTTP and WebSocket layers, and the mappers, and `API/src/main/proto` for the schema. A signature, a default, an exception, or a published event is what the code does.
+2. The README, for the event descriptions and the wording of the landing page.
+3. `examples/src/main/java`, which shows the intended use of each feature; where an example disagrees with the code, the code wins and the guide says so.
+
+When a behaviour cannot be read from the code, run it against a live room and say what was observed rather than what the schema allows; see [protocol](/advanced/protocol/#schema-definitions-and-verified-behaviour). When the code has a bug, describe the behaviour as it is and work around it in the example, as the [troubleshooting page](/troubleshooting/#known-limitations-in-this-release) does for this release.
+
+## The content check
+
+`check` runs first in every build. It parses the `API` and `Client` sources with JavaParser, reads the authored pages, skips `api/` and `schema/`, and prints `PASS` or `FAIL` for eight sections in this order, then a `Checked ... pages` summary line:
+
+| Section | Passes when |
+| --- | --- |
+| `events` | Every concrete event class under `api/data/events` is named in backticks on some page, has a catalog row on `events/index.md` whose type cell equals its `@EventMeta` category (`Control`, `Message`, `Debug`, or `none`), and has a `## <EventClassName>` section on a grouped page under `events/` other than the catalog, which is what the README's hosted anchors point at. |
+| `settings` | Every field of `LiveClientSettings` and `HttpClientSettings` is named in backticks on some page. |
+| `builder` | Every public `on*` handler of `EventsBuilder` and every public method of `LiveClient` is named in backticks on some page. |
+| `exceptions` | Every class under `api/exceptions` is named in backticks on some page. |
+| `extensions` | `TikTokLiveRecorder` and `TikTokLiveCollector` are named in backticks on some page. |
+| `discord` | No page contains a Discord link domain. |
+| `readme` | Every `- [onX](#anchor)` item of the README's events list names an event class, the anchor's last segment, and an `EventsBuilder` handler; and every `https://ttlj.docs.isaackogan.com/...` link in the README resolves to an authored page and, with a fragment, to a heading on it whose slug (lowercase, non-alphanumerics as hyphens) equals the fragment. |
+| `examples` | Every Java fence compiles as described above, and no fence on any page is left unclosed; a deliberately wrong canary must fail, so an empty classpath cannot pass the section. |
+
+A failing section prints its first three failures with the offending name. The check tells you what is missing; it cannot tell whether a sentence is true, so verify behaviour in the source before describing it.
+
+## Deployment
+
+`.github/workflows/docs.yml` runs the tests, the full build, and the SEO gate on every pull request that touches the docs or the library, uploads the built site as a review artifact, and on pushes to `master` redeploys the existing `tiktoklivejava-docs` Worker at `https://ttlj.docs.isaackogan.com/` where the repository holds a token scoped to that Worker; a daily scheduled run, where the deploy secrets exist, builds and deploys the upstream repository's `master` once it carries `docs/`, and until then its `upstream` probe job skips the build. See [hosting](/hosting/) for the Worker configuration, the one-time domain attachment, the secrets, and how to deploy from a checkout.
+
+`DOCS_SITE` sets the public origin and defaults to the custom domain; `DOCS_BASE` sets the deployment subpath and defaults to `/`. Neither needs to be set for a normal build.
diff --git a/docs/src/content/docs/events/battles-and-cohosting.md b/docs/src/content/docs/events/battles-and-cohosting.md
new file mode 100644
index 00000000..96f1d098
--- /dev/null
+++ b/docs/src/content/docs/events/battles-and-cohosting.md
@@ -0,0 +1,177 @@
+---
+title: Battles and cohosting
+description: Battles and their points, the Power-Up card notice, and every link-mic event the client derives from WebcastLinkMessage, with the fields each one carries.
+sidebar:
+  order: 4
+---
+
+A battle is two or more hosts competing for gift points; link-mic is the signalling behind cohosting and multi-guest sessions. `TikTokLinkMicBattleEvent` and `TikTokLinkMicArmiesEvent` have their own messages. The `TikTokLink*` events share one message, [`WebcastLinkMessage`](/schema/webcast/webcastlinkmessage/): the client reads its [`LinkMessageType`](/schema/enums/linkmessagetype/) and builds the matching subclass of `TikTokLinkEvent`, or `TikTokLinkEvent` itself for a type with no subclass. A subclass that needs the message's content throws when it is absent, and the client publishes that as `TikTokErrorEvent`.
+
+None of these events has a builder method; register them with `onEvent(TikTokXEvent.class, handler)`. Each section names the Webcast message and links its schema page. Replace `isaackogz` with a creator who is live.
+
+## TikTokLinkMicBattleEvent
+
+A battle started or finished, with its teams, hosts, and final scores. Message: [`WebcastLinkMicBattle`](/schema/webcast/webcastlinkmicbattle/).
+
+Key fields: `getBattleId()`; `isFinished()`, `true` when the message's [`BattleAction`](/schema/enums/battleaction/) is `BATTLE_ACTION_FINISH`; `getBattleType()`, a [`BattleType`](/schema/enums/battletype/), with the helpers `is1v1()`, `is2v2()`, `isIndividual()` (1v1v1 or 1v1v1v1), and `isMultiTeam()` (1 against many); and `getTeams()`, a list of `Team` with `getTeamId()`, `getHosts()`, `getTotalPoints()` (`-1` until the battle has finished), `getWinStreak()` (the host's combo count in a 1v1 battle, otherwise `-1`), and `getViewers()`, the contributors and their points, filled when the battle has finished. `isTie()` compares the finished teams' points, and `getTeam(hostName)`, `getOpponentTeams(hostName)`, and `getTeams(hostName)` pick teams by a host's username. For a 1-against-many battle the teams list stays empty: the source notes that no data has been collected for it yet.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onEvent(TikTokLinkMicBattleEvent.class, (client, event) -> {
+            if (!event.isFinished()) {
+                System.out.println("Battle " + event.getBattleId() + " started with " + event.getTeams().size() + " teams");
+                return;
+            }
+            for (var team : event.getTeams()) {
+                var hosts = team.getHosts().stream().map(host -> host.getName()).toList();
+                System.out.println(hosts + ": " + team.getTotalPoints() + " points");
+            }
+        })
+        .buildAndConnect();
+```
+
+## TikTokLinkMicArmiesEvent
+
+A battle's points were updated, per host or team with the top contributors. Message: [`WebcastLinkMicArmies`](/schema/webcast/webcastlinkmicarmies/).
+
+Key fields: `getBattleId()`; `isFinished()`, `true` when the message's [`TriggerReason`](/schema/enums/triggerreason/) is the battle's end; `getPicture()`, the animated icon; `getBattleType()`; and `getArmies()`, a map from the host's id in a 1v1 battle or the team's id otherwise to a `LinkMicArmy` with `getArmyId()`, `getTotalPoints()`, and `getArmies()`, the contributors as `User` objects mapped to their points. The map stays empty for a 1-against-many battle.
+
+## TikTokLinkMicBattleItemCard
+
+A battle Power-Up card notice; the event carries only the message header. Message: [`WebcastLinkMicBattleItemCard`](/schema/webcast/webcastlinkmicbattleitemcard/). The class name has no `Event` suffix.
+
+## TikTokLinkMicFanTicketEvent
+
+A fan-ticket notice of a link-mic session; the event carries only the message header. Message: [`WebcastLinkMicFanTicketMethod`](/schema/webcast/webcastlinkmicfanticketmethod/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+## TikTokLinkMicMethodEvent
+
+Link-mic signalling between hosts; the event carries only the message header. Message: [`WebcastLinkMicMethod`](/schema/webcast/webcastlinkmicmethod/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+## TikTokLinkLayerEvent
+
+A link layer change; the event carries only the message header. Message: [`WebcastLinkLayerMessage`](/schema/webcast/webcastlinklayermessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+## TikTokLinkEvent
+
+A link message of a type with no dedicated event, and the base class of the events below. Message: [`WebcastLinkMessage`](/schema/webcast/webcastlinkmessage/) with a `LinkMessageType` the mapping has no case for, among them `TYPE_LINKER_APPLY`, `TYPE_LINKER_REPLY`, `TYPE_LINKER_PERMIT`, and `TYPE_LINKER_LEAVE_V2`.
+
+Key fields, inherited by every subclass: `getExtra()` and `getTransferExtra()`, the message's extra strings, and `getExpireTimestamp()`. A handler registered for `TikTokLinkEvent.class` receives only these generic events, not the subclasses.
+
+## TikTokLinkAcceptNoticeEvent
+
+An invitation was accepted. Message type `TYPE_LINKER_ACCEPT_NOTICE`.
+
+Key fields: `getFromUserId()`, `getFromRoomId()`, and `getToUserId()`.
+
+## TikTokLinkApplyEvent
+
+A guest applied to join. Message type `TYPE_LINKER_APPLY`. Not produced by the default mapper, whose switch has no case for this type, so an application arrives as `TikTokLinkEvent`; see [unmapped events](/events/#unmapped-events). The class adds no fields.
+
+## TikTokLinkCancelEvent
+
+An invitation or application was cancelled. Message types `TYPE_LINKER_CANCEL_INVITE` and `TYPE_LINKER_CANCEL_APPLY`.
+
+Key fields: `getFromUserId()`, `getToUserId()`, `getCancelType()`, and `getActionId()`.
+
+## TikTokLinkCloseEvent
+
+The link session was closed. Message type `TYPE_LINKER_CLOSE`. The class adds no fields.
+
+## TikTokLinkCohostListChangeEvent
+
+The cohost list changed. Message type `TYPE_LINKER_COHOST_LIST_CHANGE`. The class adds no fields.
+
+## TikTokLinkCreateEvent
+
+A link session was created. Message type `TYPE_LINKER_CREATE`.
+
+Key fields: `getHostId()`, the owner; `getRoomId()`, the owner's room, which on this class replaces the header's room id; and `getLinkType()`.
+
+## TikTokLinkEnterEvent
+
+Users entered the link session, with the linked users list. Message type `TYPE_LINKER_ENTER`.
+
+Key fields: `getListUsers()`, a list of `ListUser` with `getUser()`, `getLinkType()`, `getLinkMicId()`, `getLinkStatus()`, `getModifyTime()`, `getLinkerId()`, `getUserPosition()`, `getSilenceStatus()`, and `getRoleType()`; and `getAnchorMultiLiveEnum()`, a [`LinkmicMultiLiveEnum`](/schema/enums/linkmicmultiliveenum/).
+
+## TikTokLinkInviteEvent
+
+A host invited another host. Message type `TYPE_LINKER_INVITE`.
+
+Key fields: `getInviter()`, a `User`, and `getRoomId()`, the inviter's room, which on this class replaces the header's room id.
+
+## TikTokLinkKickOutEvent
+
+A guest was removed, with the reason. Message type `TYPE_LINKER_KICK_OUT`.
+
+Key fields: `getFromUserId()` and `getKickOutReason()`, the nested enum `TikTokLinkKickOutEvent.KickOutReason`: `KICKOUT_REASON_UNKNOWN`, `KICKOUT_REASON_FIRST_FRAME_TIMEOUT`, `KICKOUT_REASON_BY_HOST`, `KICKOUT_REASON_RTC_LOST_CONNECTION`, `KICKOUT_REASON_BY_PUNISH`, `KICKOUT_REASON_BY_ADMIN`, or `KICKOUT_REASON_HOST_REMOVE_ALL_GUESTS`, in the order of the schema's [`KickOutReason`](/schema/enums/kickoutreason/).
+
+## TikTokLinkLeaveEvent
+
+A guest left. Message type `TYPE_LINKER_LEAVE`.
+
+Key fields: `getUserId()`, `getSendLeaveUid()`, `getLeaveReason()`, and `getLinkmicIdStr()`.
+
+## TikTokLinkLinkedListChangeEvent
+
+The linked users list changed, first version of the message. Message type `TYPE_LINKER_LINKED_LIST_CHANGE`. The class adds no fields; the second version, `TYPE_LINKER_LINKED_LIST_CHANGE_V2`, carries the lists and becomes `TikTokLinkListChangeEvent`.
+
+## TikTokLinkListChangeEvent
+
+The linked, applied, and connecting user lists changed. Message type `TYPE_LINKER_LINKED_LIST_CHANGE_V2`.
+
+Key fields: `getLinkedUsers()`, `getAppliedUsers()`, and `getConnectingUsers()`, each a list of `ListUser` as on `TikTokLinkEnterEvent`.
+
+## TikTokLinkMediaChangeEvent
+
+A guest's microphone or camera was opened or closed. Message type `TYPE_LINKER_MEDIA_CHANGE`.
+
+Key fields: `getOp()`, a [`GuestMicCameraManageOp`](/schema/enums/guestmiccameramanageop/); `getToUserId()`; `getAnchorId()`; `getRoomId()`, which on this class replaces the header's room id; and `getChangeScene()`, a [`GuestMicCameraChangeScene`](/schema/enums/guestmiccamerachangescene/).
+
+## TikTokLinkMicIdxUpdateEvent
+
+A guest's microphone position changed. Message type `TYPE_LINKER_MIC_IDX_UPDATE`. The class adds no fields.
+
+## TikTokLinkMuteEvent
+
+A guest was muted or unmuted. Message type `TYPE_LINKER_MUTE`.
+
+Key fields: `getUserId()`, `getStatus()`, a [`MuteStatus`](/schema/enums/mutestatus/), and `isMuted()`.
+
+## TikTokLinkRandomMatchEvent
+
+A random match paired the host with another host. Message type `TYPE_LINKER_MATCH`.
+
+Key fields: `getUser()`, `getRoomId()` (the matched room, which on this class replaces the header's room id), `getInviteType()`, `getMatchId()`, and `getInnerChannelId()`.
+
+## TikTokLinkReplyEvent
+
+A host replied to an invitation. Message type `TYPE_LINKER_REPLY`. Not produced by the default mapper, whose switch has no case for this type, so a reply arrives as `TikTokLinkEvent`; see [unmapped events](/events/#unmapped-events).
+
+Key fields: `getRoomId()`, `getFromUser()`, and `getToUser()`.
+
+## TikTokLinkSysKickOutEvent
+
+The system removed a guest. Message type `TYPE_LINKER_SYS_KICK_OUT`.
+
+Key fields: `getUserId()` and `getLinkmicIdStr()`.
+
+## TikTokLinkUpdateUserEvent
+
+A linked user's state was updated. Message type `TYPE_LINKER_UPDATE_USER`.
+
+Key fields: `getFromUserId()` and `getToUserId()`.
+
+## TikTokLinkUpdateUserSettingEvent
+
+A linked user's settings were updated. Message type `TYPE_LINKER_UPDATE_USER_SETTING`. The class adds no fields.
+
+## TikTokLinkUserToastEvent
+
+A toast message about a linked user. Message type `TYPE_LINKMIC_USER_TOAST`.
+
+Key fields: `getUserId()`; `getRoomId()`, which on this class replaces the header's room id; and `getDisplayText()`, a `Text` with `getKey()`, `getPattern()`, `getValue()` (the pattern with its pieces filled in), and `getTextPieces()`.
+
+## TikTokLinkWaitListChangeEvent
+
+The waiting list changed. Message types `TYPE_LINKER_WAITING_LIST_CHANGE` and `TYPE_LINKER_WAITING_LIST_CHANGE_V2`. The class adds no fields.
diff --git a/docs/src/content/docs/events/chat-and-audience.md b/docs/src/content/docs/events/chat-and-audience.md
new file mode 100644
index 00000000..95c4d037
--- /dev/null
+++ b/docs/src/content/docs/events/chat-and-audience.md
@@ -0,0 +1,80 @@
+---
+title: Chat and audience
+description: Comments, emotes, joins, likes, follows, shares, questions, barrages, and captions, with the fields each event carries and examples for comments and likes.
+sidebar:
+  order: 2
+---
+
+Chat, membership, reactions, and social activity. The sender is `getUser()`, a `User` with `getId()`, `getName()` (the username), `getProfileName()` (the display name), `getPicture()`, `getFollowers()`, `getFollowing()`, `getBadges()`, and the attribute checks `isModerator()`, `isSubscriber()`, `isGiftGiver()`, `isFollower()`, `isLiveHost()`, `isMutualFollowingWithHost()`, `isAdmin()`, `isMuted()`, and `isBlocked()`. Which attributes are set depends on the message: every message sets `isFollower()`, `isSubscriber()`, `isAdmin()`, `isMuted()`, and `isBlocked()` from the user object; comments and gifts also carry a user identity, which adds `isModerator()`, `isGiftGiver()`, `isLiveHost()`, and `isMutualFollowingWithHost()`, so those four are `false` on every other message.
+
+Each section names the Webcast message and links its schema page, which lists every field. Events with a builder method name it; the others are registered with `onEvent(TikTokXEvent.class, handler)`. Replace `isaackogz` with a creator who is live.
+
+## TikTokCommentEvent
+
+Triggered every time a new chat comment arrives. Handler: `onComment`. Message: [`WebcastChatMessage`](/schema/webcast/webcastchatmessage/).
+
+Key fields: `getText()`, the comment; `getUser()`, the sender with the identity attributes; `getUserLanguage()`, the comment's content language; `getMentionedUser()`, the user a reply is addressed to, with id `0` when there is none; `getPictures()`, the images of the emotes in the comment as `Picture` objects whose `getLink()` is the URL; and `isVisibleToSender()`, set when TikTok showed the comment only to its sender. A pinned comment arrives again inside `TikTokRoomPinEvent` on [room and display](/events/room-and-display/#tiktokroompinevent). `TikTokCommentEvent.of(userName, text)` builds one for offline tests.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onComment((client, event) -> {
+            var user = event.getUser();
+            var badge = user.isModerator() ? " [mod]" : user.isSubscriber() ? " [sub]" : "";
+            System.out.println(user.getProfileName() + badge + ": " + event.getText());
+        })
+        .buildAndConnect();
+```
+
+## TikTokEmoteEvent
+
+Triggered every time a subscriber sends an emote (sticker). Handler: `onEmote`. Message: [`WebcastEmoteChatMessage`](/schema/webcast/webcastemotechatmessage/).
+
+Key fields: `getUser()` and `getEmotes()`, a list of `Emote` with `getEmoteId()` and `getPicture()`. Emotes sent inline in a comment arrive as `getPictures()` on `TikTokCommentEvent` instead.
+
+## TikTokJoinEvent
+
+A viewer joined the livestream. Handler: `onJoin`. Messages: [`WebcastMemberMessage`](/schema/webcast/webcastmembermessage/) with the action `JOINED` of [`MemberMessageAction`](/schema/enums/membermessageaction/), and [`WebcastSocialMessage`](/schema/webcast/webcastsocialmessage/) whose display text key is `pm_mt_join_message_other_viewer`.
+
+Key fields: `getUser()` and `getTotalUsers()`, the member count the member message carries, or the room's current viewer count for the social form. Every member message also publishes a `TikTokRoomInfoEvent` with that count. TikTok does not send a join for every viewer, so counting joins does not give the viewer count; read `getRoomInfo().getViewersCount()`. `TikTokJoinEvent.of(userName)` builds one for offline tests.
+
+## TikTokLikeEvent
+
+Triggered when a viewer sends likes to the streamer. For streams with many viewers, this event is not always triggered by TikTok. Handler: `onLike`. Messages: [`WebcastLikeMessage`](/schema/webcast/webcastlikemessage/), and [`WebcastSocialMessage`](/schema/webcast/webcastsocialmessage/) whose display text key is `pm_mt_msg_viewer`.
+
+Key fields: `getUser()`; `getLikes()`, the likes in this update; and `getTotalLikes()`, the room's running total. From a like message both counts come from the message, and the client also updates `getRoomInfo().getLikesCount()` and publishes a `TikTokRoomInfoEvent`. From a social message `getLikes()` is `1` and `getTotalLikes()` is the room's count at that moment. TikTok batches likes, so add `getLikes()` and reconcile with `getTotalLikes()` rather than counting events. `TikTokLikeEvent.of(userName, likes)` builds one for offline tests.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onLike((client, event) -> System.out.println(event.getUser().getProfileName() + " sent " + event.getLikes() + " likes, " + event.getTotalLikes() + " in total"))
+        .buildAndConnect();
+```
+
+## TikTokFollowEvent
+
+Triggers when a user follows the streamer. Based on social event. Handler: `onFollow`. Message: [`WebcastSocialMessage`](/schema/webcast/webcastsocialmessage/) whose display text key is `pm_main_follow_message_viewer_2`.
+
+Key fields: `getUser()` and `getTotalFollowers()`, the follow count the message carries. `TikTokFollowEvent.of(userName)` builds one for offline tests.
+
+## TikTokShareEvent
+
+Triggers when a user shares the stream. Based on social event. Handler: `onShare`. Message: [`WebcastSocialMessage`](/schema/webcast/webcastsocialmessage/) whose display text key is `pm_mt_guidance_share`, or `pm_mt_guidance_viewer_<n>_share`, from which the client reads `n`.
+
+Key fields: `getUser()` and `getTotalShares()`, `1` for the first key and `n` for the second.
+
+## TikTokQuestionEvent
+
+Triggered every time someone asks a new question via the question feature. Handler: `onQuestion`. Message: [`WebcastQuestionNewMessage`](/schema/webcast/webcastquestionnewmessage/).
+
+Key fields: `getQuestionId()`, `getText()`, `getTime()` (the question's creation time), and `getUser()`.
+
+## TikTokBarrageEvent
+
+An animated banner notice, such as a high-grade viewer entering, a fan-level upgrade, or a subscription gift. Message: [`WebcastBarrageMessage`](/schema/webcast/webcastbarragemessage/), whose [`BarrageType`](/schema/enums/barragetype/) says which.
+
+Key fields: `getEventName()`; `getDuration()`; `getIcon()`, `getBackGround()`, and `getRightIcon()`, the banner's pictures; `getBarrageParam()`, a `UserGradeParam` for a grade entrance notification, a `FansLevelParam` for a fan-level upgrade, a `SubscribeGiftParam` for a subscription gift, or a plain `BarrageParam` for every other type; and `getBarrageMessage()`, the whole message. The three parameter classes expose no getters in this version, so read the user and grade from `getBarrageMessage()`.
+
+## TikTokCaptionEvent
+
+Captions of the host's speech. Message: [`WebcastCaptionMessage`](/schema/webcast/webcastcaptionmessage/).
+
+Key fields: `getCaptionTimeStamp()` and `getContents()`, a list of `CaptionContent` with `getISOLanguage()` and `getText()`, one per language the message carries.
diff --git a/docs/src/content/docs/events/control.md b/docs/src/content/docs/events/control.md
new file mode 100644
index 00000000..4f4005b9
--- /dev/null
+++ b/docs/src/content/docs/events/control.md
@@ -0,0 +1,68 @@
+---
+title: Control events
+description: The six events the client publishes about its own connection, connecting, pre-connection, connected, reconnecting, disconnected, and error, with their fields and when they fire.
+sidebar:
+  order: 1
+---
+
+Control events come from the client rather than from a Webcast message. They mark the connection's lifecycle and carry no message header; all six extend `TikTokLiveClientEvent`. The end of a stream is not a control event: TikTok reports it in a message, and the client publishes `TikTokLiveEndedEvent` without disconnecting; see [stream control](/events/stream-control/). The [connection lifecycle](/getting-started/connection/) page walks through the connect sequence that publishes these events, the retry settings, and the Euler Stream WebSocket path, on which `TikTokPreConnectionEvent` is not published.
+
+Every control event has a builder method, named below. Replace `isaackogz` with a creator who is live.
+
+## TikTokConnectingEvent
+
+The first thing `connect()` does, before any request to TikTok or the signing provider. Handler: `onConnecting`. No message, no fields.
+
+It is published on both connection paths. On the default path the user data and room data are fetched next; on the Euler Stream WebSocket path the socket is opened directly.
+
+## TikTokPreConnectionEvent
+
+The room data is fetched and the connection can still be cancelled. Handler: `onPreConnection`. No message; the fields hold the two HTTP responses `connect()` has made so far.
+
+Key fields: `getUserData()`, the `LiveUserData.Response` for the creator; `getRoomData()`, the `LiveData.Response` for the room, with `isAgeRestricted()` among its fields; `setCancelConnection(boolean, String)`, which aborts the connection with the given reason; `isCancelConnection()` and `getReason()`, the current values. A cancelled connection throws `TikTokLivePreConnectionException` from `connect()`, which then publishes `TikTokErrorEvent` and `TikTokDisconnectedEvent` like any other failure. The event is published after `getRoomInfo()` has been filled and before the gift list and the signed URL are requested; it is not published with `useEulerstreamWebsocket`.
+
+## TikTokConnectedEvent
+
+Triggered when the connection is successfully established. Handler: `onConnected`. No message, no fields.
+
+The client publishes it from the socket thread once the WebSocket is open, which can be before or after `connect()` returns. On the default path `getRoomInfo()` is already filled; on the Euler Stream WebSocket path it is still empty until the first `TikTokRoomInfoEvent`.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onConnected((client, event) -> System.out.println("Connected to room " + client.getRoomInfo().getRoomId()))
+        .buildAndConnect();
+```
+
+## TikTokReconnectingEvent
+
+A scheduled retry is about to call `connect()` again. Handler: `onReconnecting`. No message, no fields.
+
+It is published only by the client's own retry, which runs when `retryOnConnectionFailure` is `true` and `connect()` failed because the creator was offline; the wait before each attempt is `retryConnectionTimeout`. A socket that drops after connecting is not retried, so this event never follows a `TikTokDisconnectedEvent` of a live connection. See [client settings](/configuration/client-settings/).
+
+## TikTokDisconnectedEvent
+
+Triggered when the connection gets disconnected. Handler: `onDisconnected`. No message.
+
+Key fields: `getCode()`, the WebSocket close code when TikTok or `disconnect()` closed the socket, or `TikTokDisconnectedEvent.UNKNOWN_CLOSE_CODE` (`-1`) when a connect attempt failed; `isUnknownCloseCode()`, `true` in that second case; and `getReason()`, the close frame's reason, `None` when it carried none, or `Exception: <message>` after a failed connect. The same client can `connect()` again after a disconnect; wait before doing so, since a tight loop runs into the signing provider's rate limit.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onDisconnected((client, event) -> {
+            if (event.isUnknownCloseCode()) {
+                System.out.println("Connect attempt failed: " + event.getReason());
+            } else {
+                System.out.println("Socket closed with code " + event.getCode() + ": " + event.getReason());
+            }
+        })
+        .buildAndConnect();
+```
+
+## TikTokErrorEvent
+
+General error event. You should handle this. Handler: `onError`. No message.
+
+Key field: `getException()`, a `Throwable`. It is a `TikTokLiveException` or one of its subclasses when `connect()` failed, after which `TikTokDisconnectedEvent` follows; a `TikTokLiveMessageException` when a message could not be mapped or a handler threw while the message was processed, in which case the client carries on with the next message; and a `TikTokEventListenerMethodException` when a listener method threw. The client does not log these exceptions itself, so an `onError` handler that logs the exception is the usual first step in [troubleshooting](/troubleshooting/).
+
+## TikTokLiveClientEvent
+
+The base class of the six control events. It has no `@EventMeta` category, no fields, and the client never publishes it on its own; subscribe to the concrete events. The abstract `TikTokEvent` above it is the root of every event and the parameter type of the catch-all `onEvent(handler)`.
diff --git a/docs/src/content/docs/events/debugging.md b/docs/src/content/docs/events/debugging.md
new file mode 100644
index 00000000..0ff27d3b
--- /dev/null
+++ b/docs/src/content/docs/events/debugging.md
@@ -0,0 +1,49 @@
+---
+title: Debugging
+description: The debug events that expose every batch, every message with the event it became, and messages without a mapping, plus the HTTP response event and the generic base classes.
+sidebar:
+  order: 11
+---
+
+The four `Debug` events show the traffic behind the message events. For every batch of messages the client processes, from the signing response and from each WebSocket frame, it publishes `TikTokWebsocketResponseEvent`, then for each message in the batch either a `TikTokWebsocketMessageEvent` before each event the message maps to, or a `TikTokWebsocketUnhandledMessageEvent` when no mapping is registered for the message's name. A message `publishMessage` injects goes through the same mapping without a batch event. A message whose mapping throws is published as `TikTokErrorEvent` with a `TikTokLiveMessageException` instead.
+
+Each debug event has a builder method, named below. Replace `isaackogz` with a creator who is live.
+
+## TikTokWebsocketResponseEvent
+
+A batch of messages arrived, before any of them is mapped. Handler: `onWebsocketResponse`. No Webcast message of its own; it wraps the batch.
+
+Key field: `getResponse()`, the [`ProtoMessageFetchResult`](/schema/webcast/protomessagefetchresult/) with `getMessagesList()`, the batch, and the cursor and timing fields the schema page lists.
+
+## TikTokWebsocketMessageEvent
+
+Triggered every time TikTok sends data, with the message, its event, and the mapping time. Handler: `onWebsocketMessage`. No Webcast message of its own; it wraps one.
+
+Key fields: `getMessage()`, the [`BaseProtoMessage`](/schema/webcast/protomessagefetchresult-baseprotomessage/) with `getMethod()`, the message's name, and `getPayload()`, its protobuf bytes; `getEvent()`, the event the message was mapped to, published right after this one; and `getMetaData()`, whose `getHandlingTime()` is the mapping's duration. A message that maps to two events, such as a like message, produces two of these, each wrapping one event.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onWebsocketUnhandledMessage((client, event) -> System.out.println("No mapping for " + event.getMessage().getMethod()))
+        .onWebsocketMessage((client, event) -> System.out.println(event.getMessage().getMethod() + " -> " + event.getEvent().getClass().getSimpleName() + " in " + event.getMetaData().getHandlingTime().toNanos() + " ns"))
+        .buildAndConnect();
+```
+
+## TikTokWebsocketUnhandledMessageEvent
+
+A protobuf-encoded Webcast message arrived that no mapping is registered for; you can deserialize the binary payload yourself. Handler: `onWebsocketUnhandledMessage`. No Webcast message of its own; it wraps one.
+
+Key field: `getMessage()`, the [`BaseProtoMessage`](/schema/webcast/protomessagefetchresult-baseprotomessage/) with `getMethod()` and `getPayload()`; `getData()` returns the same object. The method name tells you which message TikTok sent, and the [schema reference](/schema/) whether the library has a class for it; a custom mapping turns it into an event, as the [catalog](/events/#unmapped-events) shows. This event, not `TikTokErrorEvent`, is where a message type the library does not know ends up, so a handler that logs the method names is the quickest way to see what a room sends.
+
+## TikTokHttpResponseEvent
+
+An HTTP request and its response. Handler: `onHttpResponse`. No Webcast message.
+
+Key fields: `getUrl()`, `getRequest()`, and `getResponse()`, the last two as `HttpData` with `getUrl()`, `getMethod()`, `getHeaders()`, `getParameters()`, `getStatus()`, and `getBody()`. No class in this checkout publishes the event: the handler and `TikTokEventListenerBase.onHttpResponse` exist, but the HTTP client does not call them. It can only reach a handler through your own `publishEvent`.
+
+## TikTokUnhandledEvent
+
+The generic base class of the unhandled wrappers, holding the raw message. It has no `@EventMeta` category and one field, `getData()`, typed by the subclass: `TikTokWebsocketUnhandledMessageEvent` above, and `TikTokUnhandledMemberEvent`, `TikTokUnhandledSocialEvent`, and `TikTokUnhandledControlEvent` on [moderation and access](/events/moderation-and-access/). The client never publishes it on its own, and a handler for `TikTokUnhandledEvent.class` receives none of the subclasses.
+
+## TikTokEmptyEvent
+
+An event with no fields. It has no `@EventMeta` category and nothing in the library references it; it is a placeholder for your own `publishEvent` calls, for instance to trigger a listener from a test.
diff --git a/docs/src/content/docs/events/games-and-commerce.md b/docs/src/content/docs/events/games-and-commerce.md
new file mode 100644
index 00000000..1bb6ecb4
--- /dev/null
+++ b/docs/src/content/docs/events/games-and-commerce.md
@@ -0,0 +1,14 @@
+---
+title: Games and commerce
+description: The live shopping event, which exists in the API but needs a custom mapping to be produced.
+sidebar:
+  order: 9
+---
+
+One event describes live shopping. The default mapper does not register its message, and the class's own source marks its constructor as not working, so treat it as a starting point for a custom mapping rather than a finished feature. Register it with `onEvent(TikTokShopEvent.class, handler)`.
+
+## TikTokShopEvent
+
+A product shown in live shopping. Message: [`WebcastOecLiveShoppingMessage`](/schema/webcast/webcastoecliveshoppingmessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key fields, read from the message's shop data: `getTitle()`, `getPrice()` (the price string), `getPicture()`, `getShopUrl()`, and `getShopName()`.
diff --git a/docs/src/content/docs/events/gifts-and-goals.md b/docs/src/content/docs/events/gifts-and-goals.md
new file mode 100644
index 00000000..82a91ab9
--- /dev/null
+++ b/docs/src/content/docs/events/gifts-and-goals.md
@@ -0,0 +1,64 @@
+---
+title: Gifts and goals
+description: TikTokGiftEvent and TikTokGiftComboEvent with the streak rules, goal updates, envelopes, and treasure chests.
+sidebar:
+  order: 3
+---
+
+A sent gift arrives as `TikTokGiftEvent`, and every frame of a streak as `TikTokGiftComboEvent`. The two classes share the gift, sender, recipient, and streak count; the combo event adds the streak state. The other three events on this page describe goals and treasure chests and are not produced by the default mapper. The [gifts guide](/guides/gifts/) covers counting streaked gifts and the gift list.
+
+The `Gift` on both gift events has `getId()`, `getName()`, `getDiamondCost()`, `getPicture()`, `getProperties()` (a `JsonObject` of extra properties, empty for a gift built from a message), and the helpers `hasDiamondCost(int)` and `hasDiamondCostRange(int, int)`. The client resolves it from `getGiftManager()` by id, then by name, and otherwise builds it from the message and attaches it to the manager; with `fetchGifts` set to `true`, the manager knows the room's gifts before the first event.
+
+Each section names the Webcast message and links its schema page, which lists every field. Replace `isaackogz` with a creator who is live.
+
+## TikTokGiftEvent
+
+Triggered when a user sends a gift that has no combo (most of the expensive gifts), or when a combo has finished. Handler: `onGift`. Message: [`WebcastGiftMessage`](/schema/webcast/webcastgiftmessage/).
+
+Key fields: `getGift()`; `getUser()`, the sender, with the identity attributes such as `isSubscriber()`; `getToUser()`, the recipient, which is the room's host when the message names none; and `getCombo()`, the message's combo count, the number of gifts in the streak. For a gift whose type is not streakable the event is published at once. For a streakable gift it is published once, when TikTok sends the streak's final frame or, when no final frame arrives, at the first gift message more than five minutes after the streak's last update, so one `TikTokGiftEvent` is one completed streak and `getCombo()` times `getDiamondCost()` is its value. A final frame TikTok repeats within a minute is dropped. `TikTokGiftEvent.of(gift)` and `of(name, id, diamonds)` build one for offline tests.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onGift((client, event) -> {
+            var gift = event.getGift();
+            var diamonds = gift.getDiamondCost() * event.getCombo();
+            System.out.println(event.getUser().getProfileName() + " sent " + event.getCombo() + " x " + gift.getName() + " (" + diamonds + " diamonds)");
+        })
+        .buildAndConnect();
+```
+
+## TikTokGiftComboEvent
+
+Triggered every time a gift is sent, with the streak's state. Handler: `onGiftCombo`. Message: [`WebcastGiftMessage`](/schema/webcast/webcastgiftmessage/).
+
+Key fields: the four of `TikTokGiftEvent`, and `getComboState()`, a `GiftComboStateType`: `Begin` on the first frame of a streak, `Active` on each further frame while the viewer holds the button, and `Finished` on the final frame, on a non-streakable gift, and when a streak times out. A `Finished` combo event is followed by the `TikTokGiftEvent` for the same gift, so count gifts in one handler or the other. Although the class extends `TikTokGiftEvent`, `onGift` is not called for it: handlers match the exact class. `TikTokGiftComboEvent.of(gift, combo, state)` builds one for offline tests.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onGiftCombo((client, event) -> {
+            switch (event.getComboState()) {
+                case Begin -> System.out.println(event.getUser().getProfileName() + " started a " + event.getGift().getName() + " streak");
+                case Active -> System.out.println("Streak at " + event.getCombo());
+                case Finished -> System.out.println("Streak ended at " + event.getCombo());
+            }
+        })
+        .buildAndConnect();
+```
+
+## TikTokGoalUpdateEvent
+
+A goal's progress was updated. Message: [`WebcastGoalUpdateMessage`](/schema/webcast/webcastgoalupdatemessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key fields: `getGoalId()`, `getDescription()`, `getPicture()` (the contributor's avatar), and `getUsers()`, the goal's contributors as `User` objects with id, display id, and avatar.
+
+## TikTokEnvelopeEvent
+
+An envelope, the sender of a treasure chest. Message: [`WebcastEnvelopeMessage`](/schema/webcast/webcastenvelopemessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key field: `getUser()`, built from the envelope's sender name and avatar; its id is `0`.
+
+## TikTokChestEvent
+
+A treasure chest with its diamond total and participant count. Message: [`WebcastEnvelopeMessage`](/schema/webcast/webcastenvelopemessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key fields: `getChest()`, a `Chest` with `getTotalDiamonds()` and `getTotalUsers()`; `getUser()`, the sender taken from the message's display text; and `getOpenedAt()`, a `Date` from the envelope's unpack time. The client has a handler for it, `TikTokCommonEventHandler.handleEnvelop`, which publishes the event only for an envelope whose [`EnvelopeDisplay`](/schema/enums/envelopedisplay/) is `ENVELOPE_DISPLAY_NEW`, but the factory does not register it; a custom mapping can call it.
diff --git a/docs/src/content/docs/events/index.md b/docs/src/content/docs/events/index.md
new file mode 100644
index 00000000..a09919f4
--- /dev/null
+++ b/docs/src/content/docs/events/index.md
@@ -0,0 +1,218 @@
+---
+title: Event catalog
+description: Every event TikTokLiveJava emits, its category, what it means, and the page that documents it, with both ways to subscribe.
+sidebar:
+  order: 0
+---
+
+A handler is registered in one of two forms. The builder's `on<Event>` methods take an `EventConsumer`, a lambda that receives the `LiveClient` and the event; `onEvent` does the same for any event class, including the ones without a dedicated method, as `onEvent(TikTokXEvent.class, handler)`, and `onEvent(handler)` receives every event. The other form is a listener: any object whose methods carry `@TikTokEventObserver` and take a parameter that extends `TikTokEvent`, added with `addListener` on the builder or on `getListenersManager()`; the `LiveClient` is an optional second parameter in either position. See [listeners](/guides/listeners/) for priorities and asynchronous methods.
+
+```java
+import io.github.jwdeveloper.tiktok.api.annotations.TikTokEventObserver;
+import io.github.jwdeveloper.tiktok.api.data.events.social.TikTokLikeEvent;
+import io.github.jwdeveloper.tiktok.api.data.events.social.TikTokShareEvent;
+import io.github.jwdeveloper.tiktok.api.live.LiveClient;
+import io.github.jwdeveloper.tiktok.client.TikTokLive;
+
+public class EventForms {
+    public static void main(String[] args) {
+        TikTokLive.newClient("isaackogz")
+                .onComment((client, event) -> System.out.println(event.getUser().getProfileName() + ": " + event.getText()))
+                .onEvent(TikTokShareEvent.class, (client, event) -> System.out.println(event.getUser().getProfileName() + " shared the stream"))
+                .addListener(new ReactionListener())
+                .buildAndConnect();
+    }
+
+    public static class ReactionListener {
+        @TikTokEventObserver
+        public void onLike(LiveClient client, TikTokLikeEvent event) {
+            client.getLogger().info(event.getUser().getProfileName() + " sent " + event.getLikes() + " likes");
+        }
+    }
+}
+```
+
+Handlers are matched by the event's exact class, plus the `TikTokEvent` catch-all. A handler for a base class does not receive its subclasses: `onGift` is not called for a `TikTokGiftComboEvent` although that class extends `TikTokGiftEvent`, and `onEvent(TikTokLinkEvent.class, ...)` receives only the generic link event, not `TikTokLinkInviteEvent`. An exception thrown by a handler while a message is processed is published as `TikTokErrorEvent`, and the client carries on with the next message. Register handlers before connecting: the signing response already carries messages, and they are dispatched before the socket opens.
+
+This checkout defines 78 event classes under `io.github.jwdeveloper.tiktok.api.data.events`. The `@EventMeta` annotation on each gives its category: 6 `Control` events, which the client publishes about its own connection; 64 `Message` events, mapped from TikTok's Webcast protobuf messages; and 4 `Debug` events, which expose the raw traffic. Four classes carry no category: `TikTokLiveClientEvent` and `TikTokHeaderEvent` are the base classes of the control and message events, `TikTokUnhandledEvent` is the base of the unhandled wrappers, and `TikTokEmptyEvent` is a placeholder. `TikTokEvent` itself is abstract and is never published; it is the type `onEvent(handler)` receives, and every event inherits its `toJson()`.
+
+A message event extends `TikTokHeaderEvent`, so it carries `getMessageId()`, `getRoomId()`, and `getTimeStamp()` from the message's common header, and each grouped page links the message's [schema page](/schema/) for the full field list. Nested objects such as `getUser()` and `getGift()` are mapped from the message and are not `null`; a user TikTok did not send has id `0` and an empty name. Some messages produce more than one event: a like message publishes `TikTokLikeEvent` and then `TikTokRoomInfoEvent`, and a finished gift streak publishes `TikTokGiftComboEvent` and then `TikTokGiftEvent`. Every mapped event is preceded by a `TikTokWebsocketMessageEvent` that wraps it, and every batch by a `TikTokWebsocketResponseEvent`; see [debugging](/events/debugging/).
+
+## Unmapped events
+
+The client maps a message only when `MessagesMapperFactory` registers a handler for its name; any other message is published as `TikTokWebsocketUnhandledMessageEvent` with its raw payload. Sixteen event classes exist for messages the default mapper does not register, or for a case its switch does not cover, so the default client never produces them: `TikTokChestEvent`, `TikTokDetectEvent`, `TikTokEnvelopeEvent`, `TikTokGoalUpdateEvent`, `TikTokIMDeleteEvent`, `TikTokInRoomBannerEvent`, `TikTokLinkApplyEvent`, `TikTokLinkLayerEvent`, `TikTokLinkMicFanTicketEvent`, `TikTokLinkMicMethodEvent`, `TikTokLinkReplyEvent`, `TikTokRankTextEvent`, `TikTokRankUpdateEvent`, `TikTokShopEvent`, `TikTokSubNotifyEvent`, and `TikTokUnauthorizedMemberEvent`. Each section below says so where it applies. Two more are never published by the client for another reason: `TikTokHttpResponseEvent` has a handler but no publisher in this checkout, and `TikTokEmptyEvent` is referenced nowhere.
+
+To produce one of them, register a mapping with `mappings` on the builder. The mapping receives the message bytes, deserialises them with the helper, and returns a `MappingResult` holding the message and the events to publish. The protobuf classes live in `io.github.jwdeveloper.tiktok.api.messages.webcast`.
+
+```java
+import io.github.jwdeveloper.tiktok.api.data.events.TikTokRankTextEvent;
+import io.github.jwdeveloper.tiktok.api.mappers.data.MappingResult;
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastRankTextMessage;
+
+TikTokLive.newClient("isaackogz")
+        .mappings(mapper -> mapper.forMessage(WebcastRankTextMessage.class, (bytes, messageName, helper) -> {
+            var message = helper.bytesToWebcastObject(bytes, WebcastRankTextMessage.class);
+            return MappingResult.of(message, new TikTokRankTextEvent(message));
+        }))
+        .onEvent(TikTokRankTextEvent.class, (client, event) -> System.out.println(event.getLabel()))
+        .buildAndConnect();
+```
+
+A mapping registered this way replaces the default one for that message, so a custom `WebcastLinkMessage` mapping must reproduce the cases it still wants.
+
+## Find an event
+
+### Control
+
+The client's own connection lifecycle. Details: [Control events](/events/control/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokConnectingEvent` | Control | The first thing `connect()` does, before any request |
+| `TikTokPreConnectionEvent` | Control | The room data is fetched and the connection can still be cancelled |
+| `TikTokConnectedEvent` | Control | Triggered when the connection is successfully established |
+| `TikTokReconnectingEvent` | Control | A scheduled retry is about to call `connect()` again |
+| `TikTokDisconnectedEvent` | Control | Triggered when the connection gets disconnected |
+| `TikTokErrorEvent` | Control | General error event; you should handle this |
+| `TikTokLiveClientEvent` | none | Base class of the control events, never published on its own |
+
+### Chat and audience
+
+Comments, emotes, joins, likes, follows, shares, questions, barrages, and captions. Details: [Chat and audience](/events/chat-and-audience/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokCommentEvent` | Message | Triggered every time a new chat comment arrives |
+| `TikTokEmoteEvent` | Message | Triggered every time a subscriber sends an emote (sticker) |
+| `TikTokJoinEvent` | Message | A viewer joined the livestream |
+| `TikTokLikeEvent` | Message | Triggered when a viewer sends likes to the streamer |
+| `TikTokFollowEvent` | Message | Triggers when a user follows the streamer |
+| `TikTokShareEvent` | Message | Triggers when a user shares the stream |
+| `TikTokQuestionEvent` | Message | Triggered every time someone asks a new question via the question feature |
+| `TikTokBarrageEvent` | Message | An animated banner notice, such as a high-grade viewer entering, a fan-level upgrade, or a subscription gift |
+| `TikTokCaptionEvent` | Message | Captions of the host's speech |
+
+### Gifts and goals
+
+Gifts, streaks, goals, envelopes, and treasure chests. Details: [Gifts and goals](/events/gifts-and-goals/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokGiftEvent` | Message | Triggered when a user sends a gift that has no combo, or when a combo has finished |
+| `TikTokGiftComboEvent` | Message | Triggered every time a gift is sent, with the streak's state |
+| `TikTokGoalUpdateEvent` | Message | A goal's progress was updated ([unmapped](/events/#unmapped-events)) |
+| `TikTokEnvelopeEvent` | Message | An envelope, the sender of a treasure chest ([unmapped](/events/#unmapped-events)) |
+| `TikTokChestEvent` | Message | A treasure chest with its diamond total and participant count ([unmapped](/events/#unmapped-events)) |
+
+### Battles and cohosting
+
+Battles, battle points, and link-mic (cohost and multi-guest) signalling. Details: [Battles and cohosting](/events/battles-and-cohosting/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokLinkMicBattleEvent` | Message | A battle started or finished, with its teams, hosts, and final scores |
+| `TikTokLinkMicArmiesEvent` | Message | A battle's points were updated, per host or team with the top contributors |
+| `TikTokLinkMicBattleItemCard` | Message | A battle Power-Up card notice; carries only the message header |
+| `TikTokLinkMicFanTicketEvent` | Message | A fan-ticket notice of a link-mic session; carries only the header ([unmapped](/events/#unmapped-events)) |
+| `TikTokLinkMicMethodEvent` | Message | Link-mic signalling between hosts; carries only the header ([unmapped](/events/#unmapped-events)) |
+| `TikTokLinkLayerEvent` | Message | A link layer change; carries only the header ([unmapped](/events/#unmapped-events)) |
+| `TikTokLinkEvent` | Message | A link message of a type with no dedicated event, and the base class of the ones below |
+| `TikTokLinkAcceptNoticeEvent` | Message | An invitation was accepted |
+| `TikTokLinkApplyEvent` | Message | A guest applied to join ([unmapped](/events/#unmapped-events)) |
+| `TikTokLinkCancelEvent` | Message | An invitation or application was cancelled |
+| `TikTokLinkCloseEvent` | Message | The link session was closed |
+| `TikTokLinkCohostListChangeEvent` | Message | The cohost list changed |
+| `TikTokLinkCreateEvent` | Message | A link session was created |
+| `TikTokLinkEnterEvent` | Message | Users entered the link session, with the linked users list |
+| `TikTokLinkInviteEvent` | Message | A host invited another host |
+| `TikTokLinkKickOutEvent` | Message | A guest was removed, with the reason |
+| `TikTokLinkLeaveEvent` | Message | A guest left |
+| `TikTokLinkLinkedListChangeEvent` | Message | The linked users list changed (first version of the message) |
+| `TikTokLinkListChangeEvent` | Message | The linked, applied, and connecting user lists changed |
+| `TikTokLinkMediaChangeEvent` | Message | A guest's microphone or camera was opened or closed |
+| `TikTokLinkMicIdxUpdateEvent` | Message | A guest's microphone position changed |
+| `TikTokLinkMuteEvent` | Message | A guest was muted or unmuted |
+| `TikTokLinkRandomMatchEvent` | Message | A random match paired the host with another host |
+| `TikTokLinkReplyEvent` | Message | A host replied to an invitation ([unmapped](/events/#unmapped-events)) |
+| `TikTokLinkSysKickOutEvent` | Message | The system removed a guest |
+| `TikTokLinkUpdateUserEvent` | Message | A linked user's state was updated |
+| `TikTokLinkUpdateUserSettingEvent` | Message | A linked user's settings were updated |
+| `TikTokLinkUserToastEvent` | Message | A toast message about a linked user |
+| `TikTokLinkWaitListChangeEvent` | Message | The waiting list changed |
+
+### Subscriptions and fans
+
+Subscriptions and subscription notices. Details: [Subscriptions and fans](/events/subscriptions-and-fans/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokSubscribeEvent` | Message | Triggers when a user creates a subscription |
+| `TikTokSubNotifyEvent` | Message | A subscription notice with its user ([unmapped](/events/#unmapped-events)) |
+
+### Room and display
+
+Room information, pinned messages, banners, polls, and the message header. Details: [Room and display](/events/room-and-display/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokRoomInfoEvent` | Message | Triggered when `LiveRoomInfo` got updated, such as likes, viewers, or ranking |
+| `TikTokRoomPinEvent` | Message | A comment was pinned |
+| `TikTokInRoomBannerEvent` | Message | An in-room banner, as the message's extra data ([unmapped](/events/#unmapped-events)) |
+| `TikTokHeaderEvent` | none | Base class of the message events: message id, room id, and timestamp |
+| `TikTokPollEvent` | Message | A poll message of a type with no dedicated event, and the base class of the three below |
+| `TikTokPollStartEvent` | Message | A poll started, with its title and options |
+| `TikTokPollUpdateEvent` | Message | A poll's vote counts were updated |
+| `TikTokPollEndEvent` | Message | A poll ended, with the final options |
+
+### Rankings
+
+Rank text and rank updates. Details: [Rankings](/events/rankings/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokRankTextEvent` | Message | A rank notice's text, such as a viewer entering the top contributors ([unmapped](/events/#unmapped-events)) |
+| `TikTokRankUpdateEvent` | Message | The room's rank or hourly rank was updated; carries only the header ([unmapped](/events/#unmapped-events)) |
+
+### Moderation and access
+
+Deleted messages, unauthorized members, detection probes, and the fallbacks for member, social, and control messages. Details: [Moderation and access](/events/moderation-and-access/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokIMDeleteEvent` | Message | Messages or users' messages were deleted ([unmapped](/events/#unmapped-events)) |
+| `TikTokUnauthorizedMemberEvent` | Message | A viewer without access entered, with a nickname only ([unmapped](/events/#unmapped-events)) |
+| `TikTokDetectEvent` | Message | A message-detection probe with its region ([unmapped](/events/#unmapped-events)) |
+| `TikTokUnhandledMemberEvent` | Message | A member message with an action other than joined or subscribed |
+| `TikTokUnhandledSocialEvent` | Message | A social message that is not a like, follow, share, or join |
+| `TikTokUnhandledControlEvent` | Message | A control message with an action other than pause, unpause, end, or suspend |
+
+### Games and commerce
+
+Live shopping. Details: [Games and commerce](/events/games-and-commerce/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokShopEvent` | Message | A product shown in live shopping ([unmapped](/events/#unmapped-events)) |
+
+### Stream control
+
+Stream pause, resume, end, and suspension. Details: [Stream control](/events/stream-control/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokLiveEndedEvent` | Message | Triggered when the live stream gets terminated by the host, or suspended by TikTok |
+| `TikTokLivePausedEvent` | Message | The host paused the stream |
+| `TikTokLiveUnpausedEvent` | Message | The host resumed a paused stream |
+
+### Debugging
+
+The raw traffic, the mapping of each message, and the generic base classes. Details: [Debugging](/events/debugging/).
+
+| Event | Type | Description |
+| --- | --- | --- |
+| `TikTokWebsocketResponseEvent` | Debug | A batch of messages arrived, before any of them is mapped |
+| `TikTokWebsocketMessageEvent` | Debug | Triggered every time TikTok sends data, with the message, its event, and the mapping time |
+| `TikTokWebsocketUnhandledMessageEvent` | Debug | A protobuf-encoded Webcast message arrived that no mapping is registered for |
+| `TikTokHttpResponseEvent` | Debug | An HTTP request and its response; not published in this checkout |
+| `TikTokUnhandledEvent` | none | Generic base class of the unhandled wrappers, holding the raw message |
+| `TikTokEmptyEvent` | none | An event with no fields, for your own `publishEvent` calls |
diff --git a/docs/src/content/docs/events/moderation-and-access.md b/docs/src/content/docs/events/moderation-and-access.md
new file mode 100644
index 00000000..e53869b1
--- /dev/null
+++ b/docs/src/content/docs/events/moderation-and-access.md
@@ -0,0 +1,52 @@
+---
+title: Moderation and access
+description: Deleted messages, unauthorized members, detection probes, and the three fallback events for member, social, and control messages the client does not recognise.
+sidebar:
+  order: 8
+---
+
+Three events on this page describe moderation and access and are not produced by the default mapper. The other three are fallbacks: the member, social, and control messages each map to several events by their action or display text, and a value the client does not recognise becomes an unhandled wrapper holding the whole message. Each wrapper extends `TikTokUnhandledEvent` and exposes the message as `getData()`, so a new TikTok action can be inspected without a custom mapping.
+
+Each section names the Webcast message and links its schema page. Register these events with `onEvent(TikTokXEvent.class, handler)`. Replace `isaackogz` with a creator who is live.
+
+## TikTokIMDeleteEvent
+
+Messages or users' messages were deleted. Message: [`WebcastImDeleteMessage`](/schema/webcast/webcastimdeletemessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key fields: `getMsgIds()`, the ids of the deleted messages, and `getUserIds()`, the users whose messages were deleted; both are lists of `Long`.
+
+## TikTokUnauthorizedMemberEvent
+
+A viewer without access entered, with a nickname only. Message: [`WebcastUnauthorizedMemberMessage`](/schema/webcast/webcastunauthorizedmembermessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key field: `getUserNickName()`.
+
+## TikTokDetectEvent
+
+A message-detection probe with its region. Message: [`WebcastMsgDetectMessage`](/schema/webcast/webcastmsgdetectmessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key field: `getLanguage()`, which holds the message's from-region value.
+
+## TikTokUnhandledMemberEvent
+
+A member message with an action other than joined or subscribed. Message: [`WebcastMemberMessage`](/schema/webcast/webcastmembermessage/) whose [`MemberMessageAction`](/schema/enums/membermessageaction/) is neither `JOINED`, which becomes `TikTokJoinEvent`, nor `SUBSCRIBED`, which becomes `TikTokSubscribeEvent`.
+
+Key field: `getData()`, the `WebcastMemberMessage`. The client still publishes a `TikTokRoomInfoEvent` with the message's member count.
+
+## TikTokUnhandledSocialEvent
+
+A social message that is not a like, follow, share, or join. Message: [`WebcastSocialMessage`](/schema/webcast/webcastsocialmessage/) whose display text key is none of `pm_mt_msg_viewer`, `pm_main_follow_message_viewer_2`, `pm_mt_guidance_share`, `pm_mt_join_message_other_viewer`, or the `pm_mt_guidance_viewer_<n>_share` pattern.
+
+Key field: `getData()`, the `WebcastSocialMessage`; its common display text carries the key.
+
+## TikTokUnhandledControlEvent
+
+A control message with an action other than pause, unpause, end, or suspend. Message: [`WebcastControlMessage`](/schema/webcast/webcastcontrolmessage/) whose [`ControlAction`](/schema/enums/controlaction/) is not one of the four that [stream control](/events/stream-control/) maps.
+
+Key field: `getData()`, the `WebcastControlMessage`.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onEvent(TikTokUnhandledControlEvent.class, (client, event) -> System.out.println("Control action " + event.getData().getAction()))
+        .buildAndConnect();
+```
diff --git a/docs/src/content/docs/events/rankings.md b/docs/src/content/docs/events/rankings.md
new file mode 100644
index 00000000..cf78d80e
--- /dev/null
+++ b/docs/src/content/docs/events/rankings.md
@@ -0,0 +1,20 @@
+---
+title: Rankings
+description: Rank text and rank update events, which exist in the API but need a custom mapping to be produced.
+sidebar:
+  order: 7
+---
+
+Ranking messages describe the room's position on TikTok's leaderboards and a viewer's position among the room's contributors. The default mapper registers neither message, so both events below reach your handlers only through a custom mapping; the [catalog](/events/#unmapped-events) shows one for `TikTokRankTextEvent`. The room's own contributor ranking arrives without a mapping, as `getUsersRanking()` on `TikTokRoomInfoEvent`; see [room and display](/events/room-and-display/#tiktokroominfoevent).
+
+Each section names the Webcast message and links its schema page. Register these events with `onEvent(TikTokXEvent.class, handler)`.
+
+## TikTokRankTextEvent
+
+A rank notice's text, such as a viewer entering the top contributors. Message: [`WebcastRankTextMessage`](/schema/webcast/webcastranktextmessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key fields: `getEventType()`, the key of the message's self-get-badge text, and `getLabel()`, that text's default pattern, with placeholders unfilled.
+
+## TikTokRankUpdateEvent
+
+The room's rank or hourly rank was updated; the event carries only the message header. Messages: [`WebcastRankUpdateMessage`](/schema/webcast/webcastrankupdatemessage/) and [`WebcastHourlyRankMessage`](/schema/webcast/webcasthourlyrankmessage/), with one constructor for each. Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
diff --git a/docs/src/content/docs/events/room-and-display.md b/docs/src/content/docs/events/room-and-display.md
new file mode 100644
index 00000000..be0ae9aa
--- /dev/null
+++ b/docs/src/content/docs/events/room-and-display.md
@@ -0,0 +1,67 @@
+---
+title: Room and display
+description: Room information updates, pinned comments, in-room banners, the message header every message event carries, and polls.
+sidebar:
+  order: 6
+---
+
+Room information is kept in one `LiveRoomInfo` that the client updates in place and republishes; the other events here describe what is shown in the room. `TikTokHeaderEvent`, the base class of every message event, is documented here as well.
+
+Each section names the Webcast message and links its schema page. Events with a builder method name it; the others are registered with `onEvent(TikTokXEvent.class, handler)`. Replace `isaackogz` with a creator who is live.
+
+## TikTokRoomInfoEvent
+
+Triggered when `LiveRoomInfo` got updated, such as likes, viewers, or ranking. Handler: `onRoomInfo`. Messages: [`WebcastRoomUserSeqMessage`](/schema/webcast/webcastroomuserseqmessage/) for the viewer counts and ranking, [`WebcastLiveIntroMessage`](/schema/webcast/webcastliveintromessage/) for the host and language, [`WebcastMemberMessage`](/schema/webcast/webcastmembermessage/) for the viewer count, and [`WebcastLikeMessage`](/schema/webcast/webcastlikemessage/) for the like count. The client also publishes it once at the end of `connect()` on the default path.
+
+Key field: `getRoomInfo()`, the client's `LiveRoomInfo`, the same object `getRoomInfo()` returns, with `getRoomId()`, `getHostName()`, `getTitle()`, `getHost()`, `getStartTime()`, `isAgeRestricted()`, `getViewersCount()`, `getTotalViewersCount()`, `getLikesCount()`, `getLanguage()`, `getConnectionState()`, and `getUsersRanking()`, a list of `RankingUser` with `getRank()`, `getUser()`, and `getScore()`, sorted by score. The event extends `TikTokEvent` directly and has no message header. The [connection lifecycle](/getting-started/connection/#room-information) page describes which fields are filled before connecting.
+
+## TikTokRoomPinEvent
+
+A comment was pinned. Message: [`WebcastRoomPinMessage`](/schema/webcast/webcastroompinmessage/).
+
+Key fields: `getPinnedMessage()`, a `TikTokCommentEvent` built from the pinned chat message, with its `getUser()` and `getText()`, and `getTimestamp()`, the pin time.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onEvent(TikTokRoomPinEvent.class, (client, event) -> {
+            var pinned = event.getPinnedMessage();
+            System.out.println("Pinned: " + pinned.getUser().getProfileName() + ": " + pinned.getText());
+        })
+        .buildAndConnect();
+```
+
+## TikTokInRoomBannerEvent
+
+An in-room banner, as the message's extra data. Message: [`WebcastInRoomBannerMessage`](/schema/webcast/webcastinroombannermessage/). Not produced by the default mapper; see [unmapped events](/events/#unmapped-events).
+
+Key field: `getJson()`, the message's extra map rendered with `toString()`, not JSON despite the name.
+
+## TikTokHeaderEvent
+
+The base class of the message events: message id, room id, and timestamp. It is mapped from the [`CommonMessageData`](/schema/data/commonmessagedata/) header every Webcast message carries and has no `@EventMeta` category; the client never publishes it on its own.
+
+Key fields: `getMessageId()`, `getRoomId()`, and `getTimeStamp()`, the message's creation time. A few link events declare their own `getRoomId()` for the room the message is about; the pages note which.
+
+## TikTokPollEvent
+
+A poll message of a type with no dedicated event, and the base class of the three below. Message: [`WebcastPollMessage`](/schema/webcast/webcastpollmessage/).
+
+Key field: `getPollId()`. The client picks the subclass from the message's [`MessageType`](/schema/enums/messagetype/): `MESSAGETYPE_SUBSUCCESS` becomes `TikTokPollStartEvent`, `MESSAGETYPE_ANCHORREMINDER` becomes `TikTokPollEndEvent`, `MESSAGETYPE_ENTERROOMEXPIRESOON` becomes `TikTokPollUpdateEvent`, and anything else this event. The library's source marks that mapping as unverified. A handler registered for `TikTokPollEvent.class` receives only the generic event.
+
+## TikTokPollStartEvent
+
+A poll started, with its title and options. Message: [`WebcastPollMessage`](/schema/webcast/webcastpollmessage/).
+
+Key fields: `getPollId()`; `getTitle()`; `getOperator()`, the user who started it; and `getOptions()`, a list of `PollOption` with `getOptionId()`, `getContent()`, `getVotes()`, and `getUsers()`, the voters.
+
+## TikTokPollUpdateEvent
+
+A poll's vote counts were updated. Message: [`WebcastPollMessage`](/schema/webcast/webcastpollmessage/).
+
+Key fields: `getPollId()` and `getOptions()`, the options with their current votes.
+
+## TikTokPollEndEvent
+
+A poll ended, with the final options. Message: [`WebcastPollMessage`](/schema/webcast/webcastpollmessage/).
+
+Key fields: `getPollId()`, `getOperator()`, and `getOptions()`.
diff --git a/docs/src/content/docs/events/stream-control.md b/docs/src/content/docs/events/stream-control.md
new file mode 100644
index 00000000..6bb63aad
--- /dev/null
+++ b/docs/src/content/docs/events/stream-control.md
@@ -0,0 +1,35 @@
+---
+title: Stream control
+description: The three events TikTok's control message becomes, live ended, paused, and unpaused, and what the client does when the stream ends.
+sidebar:
+  order: 10
+---
+
+TikTok reports the stream's state in [`WebcastControlMessage`](/schema/webcast/webcastcontrolmessage/), and the client maps its [`ControlAction`](/schema/enums/controlaction/) to one of three events, or to `TikTokUnhandledControlEvent` on [moderation and access](/events/moderation-and-access/#tiktokunhandledcontrolevent) for any other action. None of the three carries a field; they extend `TikTokEvent` directly and have no message header. They are message events, not control events: the client's own connection events are on [control events](/events/control/).
+
+Each event has a builder method, named below. Replace `isaackogz` with a creator who is live.
+
+## TikTokLiveEndedEvent
+
+Triggered when the live stream gets terminated by the host, or suspended by TikTok. Handler: `onLiveEnded`. Message: [`WebcastControlMessage`](/schema/webcast/webcastcontrolmessage/) with the action `STREAM_ENDED` or `STREAM_SUSPENDED`.
+
+The client does not disconnect by itself when the stream ends; `TikTokDisconnectedEvent` follows only when the socket closes. Call `disconnect()` from the handler when the connection should close with the stream.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onLivePaused((client, event) -> System.out.println("Paused"))
+        .onLiveUnpaused((client, event) -> System.out.println("Resumed"))
+        .onLiveEnded((client, event) -> {
+            System.out.println("Stream ended");
+            client.disconnect();
+        })
+        .buildAndConnect();
+```
+
+## TikTokLivePausedEvent
+
+The host paused the stream. Handler: `onLivePaused`. Message: [`WebcastControlMessage`](/schema/webcast/webcastcontrolmessage/) with the action `STREAM_PAUSED`. The connection stays open while the stream is paused.
+
+## TikTokLiveUnpausedEvent
+
+The host resumed a paused stream. Handler: `onLiveUnpaused`. Message: [`WebcastControlMessage`](/schema/webcast/webcastcontrolmessage/) with the action `STREAM_UNPAUSED`.
diff --git a/docs/src/content/docs/events/subscriptions-and-fans.md b/docs/src/content/docs/events/subscriptions-and-fans.md
new file mode 100644
index 00000000..4558416b
--- /dev/null
+++ b/docs/src/content/docs/events/subscriptions-and-fans.md
@@ -0,0 +1,28 @@
+---
+title: Subscriptions and fans
+description: TikTokSubscribeEvent from both messages that carry a subscription, and the unmapped TikTokSubNotifyEvent.
+sidebar:
+  order: 5
+---
+
+A subscription reaches the client in two messages, and both become `TikTokSubscribeEvent`. Emotes, which only subscribers can send, are on [chat and audience](/events/chat-and-audience/#tiktokemoteevent); a subscription gift shown as a banner is a `TikTokBarrageEvent` on the same page.
+
+Each section names the Webcast message and links its schema page. Replace `isaackogz` with a creator who is live.
+
+## TikTokSubscribeEvent
+
+Triggers when a user creates a subscription. Handler: `onSubscribe`. Messages: [`WebcastSubNotifyMessage`](/schema/webcast/webcastsubnotifymessage/), and [`WebcastMemberMessage`](/schema/webcast/webcastmembermessage/) with the action `SUBSCRIBED` of [`MemberMessageAction`](/schema/enums/membermessageaction/).
+
+Key field: `getUser()`, with the `Subscriber` attribute added so that `isSubscriber()` is `true`. The member-message form also publishes a `TikTokRoomInfoEvent` with the member count. `TikTokSubscribeEvent.of(userName)` builds one for offline tests.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onSubscribe((client, event) -> System.out.println(event.getUser().getProfileName() + " subscribed"))
+        .buildAndConnect();
+```
+
+## TikTokSubNotifyEvent
+
+A subscription notice with its user. Message: [`WebcastSubNotifyMessage`](/schema/webcast/webcastsubnotifymessage/). Not produced by the default mapper, which maps that message to `TikTokSubscribeEvent`; see [unmapped events](/events/#unmapped-events).
+
+Key field: `getUser()`, without the `Subscriber` attribute that `TikTokSubscribeEvent` adds.
diff --git a/docs/src/content/docs/getting-started/connection.md b/docs/src/content/docs/getting-started/connection.md
new file mode 100644
index 00000000..5aaa43bd
--- /dev/null
+++ b/docs/src/content/docs/getting-started/connection.md
@@ -0,0 +1,167 @@
+---
+title: Connection lifecycle
+description: Build and connect a client, follow the connect sequence and its lifecycle events, disconnect, retry an offline creator, read room information, and check whether a creator is live.
+---
+
+`TikTokLive.newClient(hostName)` returns a `LiveClientBuilder`. Its `on<Event>` methods register handlers, `configure` edits the client's `LiveClientSettings`, and one of three terminal methods produces the `LiveClient`.
+
+## Build, connect, or both
+
+| Method | Returns | Use it when |
+| --- | --- | --- |
+| `build()` | The `LiveClient`, not connected | You want to keep the client, register listeners through `getListenersManager()`, or connect later. |
+| `buildAndConnect()` | The connected `LiveClient` | A program that connects once. It throws when the connection fails. |
+| `buildAndConnectAsync()` | A `CompletableFuture<LiveClient>` | The calling thread must not wait. The future completes with the client, or exceptionally when the connection fails. |
+
+`LiveClient` has the matching methods. `connect()` blocks the calling thread while the client fetches the room data, signs, and starts the socket. `connectAsync()` runs `connect()` on the common pool and returns a `CompletableFuture<LiveClient>`; `connectAsync(Consumer<LiveClient>)` passes the connected client to the consumer and discards a failure: the consumer is not called and nothing is thrown. One connection per client: calling `connect()` while the state is `CONNECTING` or `CONNECTED` throws `TikTokLiveException` with the message `Already connected`. That exception goes through the same failure branch as any other: the client sets the state to `DISCONNECTED` and publishes `TikTokErrorEvent` and `TikTokDisconnectedEvent` with the reason `Exception: Already connected`, while the existing socket stays open and keeps delivering events. The state no longer matches the socket, and the next `connect()` passes the state check and replaces the socket, closing the old one first. After a disconnect the same client can `connect()` again.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .onComment((liveClient, event) -> System.out.println(event.getText()))
+        .build();
+
+client.connect();
+```
+
+The common pool's threads are daemon threads, and the socket's read thread inherits that flag from the thread that called `connect()`, so after `buildAndConnectAsync()` keep a non-daemon thread alive for as long as the connection should live; the repository's `ConnectionExample` blocks on `System.in.read()`. See the [WebSocket layer](/advanced/websocket/#connection-sequence).
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnectAsync()
+        .thenAccept(client -> System.out.println("Connected to " + client.getRoomInfo().getHostName()))
+        .exceptionally(error -> {
+            System.err.println("Connection failed: " + error.getMessage());
+            return null;
+        });
+
+System.in.read();
+```
+
+## The connect sequence
+
+In order, `connect()`:
+
+1. Sets the state to `CONNECTING` and publishes `TikTokConnectingEvent`.
+2. Fetches the creator's user data from TikTok. An offline creator throws `TikTokLiveOfflineHostException`; an unknown username throws `TikTokLiveUnknownHostException`.
+3. Fetches the room's live data and fills `getRoomInfo()` with the room id, title, host, viewer counts, and age restriction. An age-restricted room throws `TikTokLiveException` when `throwOnAgeRestriction` is `true`; a room reported offline or not found throws the two exceptions above.
+4. Publishes `TikTokPreConnectionEvent` with both responses. A handler that calls `setCancelConnection(true, reason)` aborts the connection with `TikTokLivePreConnectionException`.
+5. Downloads the room's gift list when `fetchGifts` is `true`, so `getGiftManager()` knows the gifts before the first `TikTokGiftEvent`.
+6. Requests a signed WebSocket URL from the signing provider; a failed or rate-limited request throws `TikTokSignServerException`. The response already carries messages, and they are dispatched to your handlers now, before the socket opens.
+7. Starts the WebSocket on its own thread, sets the state to `CONNECTED`, and publishes `TikTokRoomInfoEvent`. `TikTokConnectedEvent` fires from the socket thread once the socket is open, which can be before or after `connect()` returns.
+
+When a step throws a `TikTokLiveException`, `connect()` sets the state back to `DISCONNECTED`, publishes `TikTokErrorEvent` with the exception and then `TikTokDisconnectedEvent` with code `-1` and the reason `Exception: <message>`, and rethrows. `buildAndConnect()` and `connect()` throw it to the caller; `buildAndConnectAsync()` and `connectAsync()` complete their future exceptionally. Any other exception is logged as `Unhandled exception report this bug to github`, the client disconnects, and the stack trace is printed to stderr; nothing is thrown.
+
+With `useEulerstreamWebsocket` set to `true`, `connect()` does none of steps 2 to 7: it publishes `TikTokConnectingEvent`, opens `wss://ws.eulerstream.com` with your `apiKey`, and sets the state to `CONNECTED`. It fills no room information and publishes no `TikTokRoomInfoEvent`; both come from the `roomInfo` message Euler Stream sends after the socket opens, so `getRoomInfo()` is still empty when `TikTokConnectedEvent` fires on that path. See [signing](/configuration/signing/).
+
+## Lifecycle events
+
+Six control events mark the lifecycle. Register them like any other event; every handler receives the `LiveClient` first and the event second.
+
+| Event | Handler | When | Fields |
+| --- | --- | --- | --- |
+| `TikTokConnectingEvent` | `onConnecting` | First thing `connect()` does | None |
+| `TikTokPreConnectionEvent` | `onPreConnection` | After the room data is fetched, before signing | `getUserData()`, `getRoomData()`, `setCancelConnection(boolean, String)`, `getReason()` |
+| `TikTokConnectedEvent` | `onConnected` | The WebSocket is open | None |
+| `TikTokReconnectingEvent` | `onReconnecting` | Just before a scheduled retry calls `connect()` | None |
+| `TikTokDisconnectedEvent` | `onDisconnected` | The socket closed, or a connect attempt failed | `getCode()`, `getReason()`, `isUnknownCloseCode()` |
+| `TikTokErrorEvent` | `onError` | An exception in the client, in the socket, or thrown by a handler while a message is processed | `getException()`: a `TikTokLiveMessageException` wrapping the cause when a mapping or handler threw while a message was processed |
+
+`TikTokDisconnectedEvent.getCode()` is the WebSocket close code when TikTok or `disconnect()` closed the socket, and `-1` (`isUnknownCloseCode()` is `true`) when a connect attempt failed; `getReason()` is `None` when the close frame carried no reason. The end of a stream is a message event, not a control event: when TikTok reports the stream ended or suspended, the client publishes `TikTokLiveEndedEvent` (`onLiveEnded`) and does not disconnect by itself. Call `disconnect()` from the handler when the connection should close with the stream.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onConnecting((client, event) -> System.out.println("Connecting"))
+        .onPreConnection((client, event) -> {
+            if (event.getRoomData().isAgeRestricted()) {
+                event.setCancelConnection(true, "Age-restricted room");
+            }
+        })
+        .onConnected((client, event) -> System.out.println("Connected to room " + client.getRoomInfo().getRoomId()))
+        .onLiveEnded((client, event) -> client.disconnect())
+        .onDisconnected((client, event) -> System.out.println("Disconnected: " + event.getCode() + " " + event.getReason()))
+        .onError((client, event) -> event.getException().printStackTrace())
+        .buildAndConnect();
+```
+
+The `onPreConnection` handler and the room id printed by `onConnected` apply to the default path; with `useEulerstreamWebsocket`, the pre-connection event is not published and `getRoomId()` is `null` until the first `TikTokRoomInfoEvent`.
+
+## Disconnect
+
+`disconnect()` is `disconnect(LiveClientStopType.NORMAL)`: it stops the heartbeat, starts the WebSocket close handshake without waiting for it, and sets the state to `DISCONNECTED`. `LiveClientStopType.CLOSE_BLOCKING` waits until the socket has closed, and `LiveClientStopType.DISCONNECT` drops the connection without a close handshake. `TikTokDisconnectedEvent` is published when the socket reports the close. Calling `disconnect()` on a client that is not connected does nothing.
+
+```java
+var client = TikTokLive.newClient("isaackogz").buildAndConnect();
+Thread.sleep(Duration.ofMinutes(1).toMillis());
+client.disconnect(LiveClientStopType.CLOSE_BLOCKING);
+```
+
+## Retry when the creator is offline
+
+Two settings control the client's own retry. `retryOnConnectionFailure` (default `false`) makes the client try again when `connect()` fails with `TikTokLiveOfflineHostException`, and `retryConnectionTimeout` (default one second) is the wait before each attempt. The client schedules `connect()` on a daemon thread, publishes `TikTokReconnectingEvent` just before the attempt, and repeats while the creator stays offline.
+
+- Each failed attempt publishes `TikTokErrorEvent` and `TikTokDisconnectedEvent` before scheduling the next.
+- The call that started the sequence still throws: catch `TikTokLiveOfflineHostException` around `buildAndConnect()`, or use `buildAndConnectAsync()`.
+- The retry thread is a daemon thread, so keep the main thread alive, as the example below does with `System.in.read()`.
+- Only an offline creator at connect time is retried. Other failures, and a socket that closes after connecting, are not: handle `onDisconnected`, wait, and call `connect()` again. Waiting matters; a tight loop runs into the signing provider's rate limit.
+- The default one-second wait polls TikTok once a second. Set a longer `retryConnectionTimeout` for a creator who may stay offline for hours.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setRetryOnConnectionFailure(true);
+            settings.setRetryConnectionTimeout(Duration.ofSeconds(30));
+        })
+        .onReconnecting((client, event) -> System.out.println("Trying again"))
+        .onConnected((client, event) -> System.out.println("Connected"))
+        .buildAndConnectAsync();
+
+System.in.read();
+```
+
+To reconnect after a drop, poll `getRoomInfo().getConnectionState()` and connect again once the creator is live. `TikTokLive.isLiveOnline` asks TikTok directly and spends no signing request.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .onComment((liveClient, event) -> System.out.println(event.getText()))
+        .build();
+
+while (true) {
+    if (client.getRoomInfo().getConnectionState() == ConnectionState.DISCONNECTED
+            && TikTokLive.isLiveOnline("isaackogz")) {
+        try {
+            client.connect();
+        } catch (TikTokLiveException e) {
+            System.err.println("Connect failed: " + e.getMessage());
+        }
+    }
+    Thread.sleep(Duration.ofSeconds(60).toMillis());
+}
+```
+
+## Room information
+
+`getRoomInfo()` returns the client's `LiveRoomInfo`. Before connecting it holds `getHostName()`, the state `DISCONNECTED`, and the defaults: `getLanguage()` is `en`, `getUsersRanking()` is an empty list, the counts are `0`, and the other fields are `null`. On the default path, `connect()` fills it from TikTok's responses: `getRoomId()`, `getTitle()`, `getHost()`, `getStartTime()`, `getViewersCount()`, `getTotalViewersCount()`, and `isAgeRestricted()`, all set before `TikTokPreConnectionEvent` is published. With `useEulerstreamWebsocket`, `connect()` leaves it empty; the `roomInfo` message Euler Stream sends after the socket opens copies the room id, title, host, start time, and viewer count in, not the total viewer count or the age restriction (see [known limitations](/troubleshooting/#known-limitations-in-this-release)), and publishes the first `TikTokRoomInfoEvent`. While connected, the same object is updated in place and `TikTokRoomInfoEvent` (`onRoomInfo`) is published with it each time: viewer counts and `getUsersRanking()` from TikTok's room user messages, `getViewersCount()` from member messages too, `getLikesCount()` from like messages, `getLanguage()` and, while it is still `null`, the host from the live intro message. `getConnectionState()` is `CONNECTING`, `CONNECTED`, or `DISCONNECTED`.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onRoomInfo((client, event) -> {
+            var info = event.getRoomInfo();
+            System.out.println(info.getTitle() + ": " + info.getViewersCount() + " viewers, " + info.getLikesCount() + " likes");
+        })
+        .buildAndConnect();
+```
+
+## Check whether a creator is live
+
+`TikTokLive.isLiveOnline(hostName)` asks TikTok whether the creator is live; it uses no signing request and opens no socket, so it is the right call for polling. `TikTokLive.isHostNameValid(hostName)` checks that the username exists. Both have `Async` variants, `isLiveOnlineAsync` and `isHostNameValidAsync`, that return a `CompletableFuture<Boolean>`, and `TikTokLive.requests()` returns the `LiveHttpClient` behind them for the full responses.
+
+```java
+if (TikTokLive.isLiveOnline("isaackogz")) {
+    TikTokLive.newClient("isaackogz").buildAndConnect();
+}
+```
+
+## Keep the connection alive
+
+Once the socket is open, the client sends a heartbeat every `pingInterval` milliseconds (default `10000`). `build()` rejects values under `250`. The heartbeat stops with the socket. No setting reconnects after a drop; see the retry section above.
diff --git a/docs/src/content/docs/getting-started/install.md b/docs/src/content/docs/getting-started/install.md
new file mode 100644
index 00000000..880e3b4f
--- /dev/null
+++ b/docs/src/content/docs/getting-started/install.md
@@ -0,0 +1,68 @@
+---
+title: Install
+description: Add TikTokLiveJava to a Maven or Gradle project from JitPack, pick a version, and check that the dependency resolves.
+---
+
+TikTokLiveJava is published on [JitPack](https://jitpack.io/#jwdeveloper/TikTok-Live-Java), which builds the library from the tags of its GitHub repository. Add the JitPack repository to your build, then depend on the `Client` artifact; it brings the `API` module, protobuf, Gson, SLF4J, and Java-WebSocket with it.
+
+## Requirements
+
+- Java 16 or newer. The library is compiled for Java 16.
+- Maven or Gradle with access to `https://jitpack.io`.
+
+## Maven
+
+Add the repository and the dependency to `pom.xml`:
+
+```xml
+<repositories>
+    <repository>
+        <id>jitpack.io</id>
+        <url>https://jitpack.io</url>
+    </repository>
+</repositories>
+
+<dependencies>
+    <dependency>
+        <groupId>com.github.jwdeveloper.TikTok-Live-Java</groupId>
+        <artifactId>Client</artifactId>
+        <version>1.13.1-Release</version>
+    </dependency>
+</dependencies>
+```
+
+## Gradle
+
+Add the repository and the dependency to `build.gradle`:
+
+```groovy
+repositories {
+    mavenCentral()
+    maven { url = 'https://jitpack.io' }
+}
+
+dependencies {
+    implementation 'com.github.jwdeveloper.TikTok-Live-Java:Client:1.13.1-Release'
+}
+```
+
+If the project declares its repositories in `settings.gradle` under `dependencyResolutionManagement`, add `maven { url 'https://jitpack.io' }` there instead, as the repository's README does.
+
+## Group names
+
+JitPack resolves two group names to the same artifact: `com.github.jwdeveloper.TikTok-Live-Java`, used in the README and above, and `com.github.jwdeveloper.TikTokLiveJava`, the repository's current name. Either works with the same `Client` artifact and version.
+
+## Versions
+
+Releases are tagged `<major>.<minor>.<patch>-Release`. The current release is `1.13.1-Release`, the version in the repository's `pom.xml`; the [GitHub releases](https://github.com/jwdeveloper/TikTokLiveJava/releases) page is the changelog. These docs are generated from the `master` sources, so a method shown here can be newer than the release you depend on; the [API reference](/api/) index names the version it was generated from.
+
+## Check the installation
+
+Build a client without connecting. `build()` validates the settings and wires the client; it makes no network request, so this runs offline and prints `isaackogz`.
+
+```java
+var client = TikTokLive.newClient("isaackogz").build();
+System.out.println(client.getRoomInfo().getHostName());
+```
+
+`TikTokLive` is `io.github.jwdeveloper.tiktok.client.TikTokLive`; the event classes live under `io.github.jwdeveloper.tiktok.api.data.events`. Next, run the example on [Getting Started](/#listen-to-a-livestream), then read the [connection lifecycle](/getting-started/connection/).
diff --git a/docs/src/content/docs/guides/collector.md b/docs/src/content/docs/guides/collector.md
new file mode 100644
index 00000000..eacdec8b
--- /dev/null
+++ b/docs/src/content/docs/guides/collector.md
@@ -0,0 +1,105 @@
+---
+title: Collect live data
+description: Store every batch, message, event, and error of one or many livestreams as documents in JSON files or MongoDB with the extension-collector module's TikTokLiveCollector, filter what is stored, and reuse the stored payloads.
+sidebar:
+  order: 5
+---
+
+`TikTokLiveCollector`, in the `extension-collector` module, builds a `DataCollector` that writes what a client receives to a storage: each WebSocket batch, each message in it, each event, and each error, as one document apiece. One collector serves any number of clients through `newListener()`, so a program can archive several rooms into the same files or collection. The message payloads it stores are what `publishMessage` replays; see [offline testing](/guides/offline-testing/). This guide is based on the repository's `CollectorExample.java`. Replace `isaackogz` with a creator who is live.
+
+## Install
+
+The module is published on JitPack with the same group and version as the `Client` artifact; see [install](/getting-started/install/) for the repository declaration. It depends on `API`, `protobuf-java`, and `mongodb-driver-sync` 4.4.0, whose `Document` class is the document type, so the driver is pulled in even when writing to files. It does not depend on `Client`, so declare `Client` as well.
+
+```xml
+<dependency>
+    <groupId>com.github.jwdeveloper.TikTok-Live-Java</groupId>
+    <artifactId>extension-collector</artifactId>
+    <version>1.13.1-Release</version>
+</dependency>
+```
+
+```groovy
+implementation 'com.github.jwdeveloper.TikTok-Live-Java:extension-collector:1.13.1-Release'
+```
+
+## Record to files
+
+`TikTokLiveCollector.useFile(settings -> ...)` returns a `DataCollector` that writes JSON files. Call `connect()` before the clients start and `disconnect()` at the end; both are no-ops for files, but the Mongo storage needs them, so keep the calls. `newListener()` returns the listener to add to a client; `newListener(extraFields)` adds the map's entries to every document that listener writes, and `newListener(extraFields, filter)` also takes a `CollectorEvent`, `(client, document) -> boolean`, consulted before each document is stored.
+
+| Setter | Type | Default | Effect |
+| --- | --- | --- | --- |
+| `setParentFile` | `File` | none | The directory the files go in. It must exist: a missing directory makes every write fail with a printed `IOException`. |
+| `setTypeFilter` | `BiPredicate<String, String>` | accept all | Receives the document's `dataType` and `dataTypeName`; a `false` skips the document. |
+| `setUserFilter` | `Predicate<String>` | accept all | Receives the document's `tiktokUser`. |
+| `setUseFileLocks` | `boolean` | `false` | One lock per file around each write. Set it when several clients share the collector. |
+| `setAppendUserName` | `boolean` | `false` | Adds `_<tiktokUser>` to the file names, one set of files per creator. |
+
+Each document goes to `<dataType>_<dataTypeName>.json`, for example `message_WebcastChatMessage.json` or `event_TikTokCommentEvent.json`, appended as pretty-printed JSON followed by a newline. The file is a sequence of documents, not a JSON array, so read it with a parser that accepts concatenated values.
+
+```java
+import io.github.jwdeveloper.tiktok.extension.collector.TikTokLiveCollector;
+
+var directory = new File("captures");
+directory.mkdirs();
+
+var collector = TikTokLiveCollector.useFile(settings -> {
+    settings.setParentFile(directory);
+    settings.setTypeFilter((dataType, dataTypeName) -> dataType.equals("message") || dataType.equals("error"));
+});
+collector.connect();
+
+Map<String, Object> extraFields = Map.of("sessionTag", "monday-stream");
+
+var client = TikTokLive.newClient("isaackogz")
+        .onError((liveClient, event) -> event.getException().printStackTrace())
+        .addListener(collector.newListener(extraFields))
+        .buildAndConnect();
+
+Thread.sleep(60_000);
+client.disconnect();
+collector.disconnect();
+```
+
+To archive several rooms at once, build one client per creator with the same collector, as the repository example does with `buildAndConnectAsync()`, and set `useFileLocks` or `appendUserName`.
+
+## Record to MongoDB
+
+`TikTokLiveCollector.useMongo(settings -> ...)` takes a `MongoDataCollectorSettings`: `setConnectionUrl(url)`, or `connectionBuilder(b -> b.setUsername(...).setPassword(...).setCluster(...).setDatabase(...))`, which builds a `mongodb+srv://` URL with `retryWrites=true&w=majority`; `setDatabaseName` (default `tiktok`); and `setCollectionName` (default `data`). `connect()` opens the client and creates hashed indexes on `session` and `dataType`; no document carries a `session` field unless you add one through the extra fields. Each document is stored with `insertOne`, and `disconnect()` closes the client.
+
+```java
+import io.github.jwdeveloper.tiktok.extension.collector.TikTokLiveCollector;
+
+var collector = TikTokLiveCollector.useMongo(settings -> {
+    settings.setConnectionUrl(System.getenv("MONGODB_URL"));
+    settings.setDatabaseName("tiktok");
+    settings.setCollectionName("live-data");
+});
+collector.connect();
+
+var eventsOnly = collector.newListener(Map.of(), (liveClient, document) -> "event".equals(document.getString("dataType")));
+
+TikTokLive.newClient("isaackogz")
+        .addListener(eventsOnly)
+        .buildAndConnect();
+```
+
+## What is stored
+
+The listener has three observer methods, for `TikTokWebsocketResponseEvent`, every `TikTokEvent`, and `TikTokErrorEvent`. Every document has the same shape:
+
+| Field | Value |
+| --- | --- |
+| `roomId` | The room id, `null` until the first `TikTokRoomInfoEvent`; the signing response's messages are dispatched before it, so the first documents of a connection have no room id. |
+| extra fields | The entries of the map given to `newListener`. |
+| `tiktokUser` | The creator's name, taken at `TikTokConnectingEvent`. |
+| `dataType` | `response`, `message`, `event`, or `error`. |
+| `dataTypeName` | `webcast` for a response; the Webcast message name for a message; the event's class name for an event; the exception's class name for an error. |
+| `content` | Base64: the whole `ProtoMessageFetchResult` for a response; the message's payload bytes for a message; the event's JSON, from `toJson()`, for an event; the stack trace for an error. |
+| `createdAt` | The local date-time, ISO format. |
+
+A batch produces one `response` document and one `message` document per message in it. Every event produces an `event` document, including the control events, the debug events, and the ones you publish yourself, except `TikTokErrorEvent`, which produces an `error` document instead; for a `TikTokLiveMessageException` the error document also carries `message` and `response`, the failing message and its batch in Base64. The error observer prints the stack trace to `System.err` as well.
+
+## Reuse the data
+
+A `message` document is a replay unit: `dataTypeName` is the Webcast message name and `content` the Base64 payload that `client.publishMessage(dataTypeName, content)` takes, so a captured room can be run through handlers in offline mode. A `response` document holds a whole batch: decode it with `ProtoMessageFetchResult.parseFrom(Base64.getDecoder().decode(content))` and replay `getMessagesList()` in order. An `event` document decodes to the JSON that `toJson()` produced, which is for inspection; the event classes have no JSON constructor. The payloads of messages with no mapping are the material for a bug report, see [debugging](/guides/debugging/).
diff --git a/docs/src/content/docs/guides/custom-events.md b/docs/src/content/docs/guides/custom-events.md
new file mode 100644
index 00000000..7b7317d5
--- /dev/null
+++ b/docs/src/content/docs/guides/custom-events.md
@@ -0,0 +1,163 @@
+---
+title: Custom events and mappings
+description: Publish your own TikTokEvent subclasses with publishEvent, map a Webcast message the default client leaves unmapped with mappings and forMessage, and wrap or replace a default mapping.
+sidebar:
+  order: 3
+---
+
+Two extension points add events. `publishEvent` dispatches any `TikTokEvent` subclass to the handlers and listeners, so your code can raise its own events from a handler or from anywhere else. `mappings` on the builder edits the table that turns Webcast messages into events, so a message the default client leaves unmapped can become an event, and a default mapping can be wrapped or replaced. This guide is based on the repository's `CustomEventExample.java` and `CustomMappingExample.java`. Replace `isaackogz` with a creator who is live.
+
+## Publish your own events
+
+A custom event is a class that extends `TikTokEvent`, an abstract class with no fields and a `toJson()` method. `client.publishEvent(event)` runs the `TikTokEvent` catch-all handlers first and then the handlers for the event's exact class, on the calling thread, before it returns, whether or not the client is connected. Subscribe with `onEvent(MyEvent.class, handler)` on the builder or with a listener method whose parameter is `MyEvent`; see [listeners](/guides/listeners/). `TikTokEmptyEvent` is a ready-made event with no fields for a plain trigger.
+
+The example sorts gifts into two tiers and publishes a tier event from the gift handler. The repository's version declares the event classes with Lombok's `@AllArgsConstructor`; plain constructors do the same without annotation processing.
+
+```java
+import io.github.jwdeveloper.tiktok.api.data.events.common.TikTokEvent;
+import io.github.jwdeveloper.tiktok.api.data.models.gifts.Gift;
+import io.github.jwdeveloper.tiktok.client.TikTokLive;
+
+public class GiftTiers {
+    public static class CheapGiftEvent extends TikTokEvent {
+        private final Gift gift;
+
+        public CheapGiftEvent(Gift gift) {
+            this.gift = gift;
+        }
+
+        public Gift getGift() {
+            return gift;
+        }
+    }
+
+    public static class ExpensiveGiftEvent extends TikTokEvent {
+        private final Gift gift;
+        private final int combo;
+
+        public ExpensiveGiftEvent(Gift gift, int combo) {
+            this.gift = gift;
+            this.combo = combo;
+        }
+
+        public Gift getGift() {
+            return gift;
+        }
+
+        public int getCombo() {
+            return combo;
+        }
+    }
+
+    public static void main(String[] args) {
+        TikTokLive.newClient("isaackogz")
+                .onGift((client, event) -> {
+                    if (event.getGift().getDiamondCost() * event.getCombo() >= 100) {
+                        client.publishEvent(new ExpensiveGiftEvent(event.getGift(), event.getCombo()));
+                    } else {
+                        client.publishEvent(new CheapGiftEvent(event.getGift()));
+                    }
+                })
+                .onEvent(CheapGiftEvent.class, (client, event) ->
+                        System.out.println("Thanks for the " + event.getGift().getName()))
+                .onEvent(ExpensiveGiftEvent.class, (client, event) ->
+                        System.out.println("Thank you for " + event.getCombo() + " x " + event.getGift().getName() + "!"))
+                .buildAndConnect();
+    }
+}
+```
+
+An event published from inside a handler is dispatched before that handler returns. An exception thrown by a handler during `publishEvent` propagates to the caller of `publishEvent`; during message handling that is the message pipeline, which reports it as a `TikTokErrorEvent`, see [debugging](/guides/debugging/).
+
+## Map a message the default client does not
+
+The client maps a message only when a mapping is registered for its name; any other message is published as `TikTokWebsocketUnhandledMessageEvent`. Sixteen event classes exist for messages the default mapper does not register, listed under [unmapped events](/events/#unmapped-events). `mappings(mapper -> ...)` on the builder runs after the default mappings are registered and receives the `LiveMapper`:
+
+- `forMessage(WebcastXMessage.class, action)` or `forMessage("WebcastXMessage", action)` registers `action` as the message's mapping; a class is keyed by its simple name.
+- The action is a `MappingAction<MappingResult>`: it receives the payload bytes, the message name, and a `LiveMapperHelper`, and returns a `MappingResult` built with `MappingResult.of(message, event)` or `MappingResult.of(message, events)` for a list; `MappingResult.of(message)` publishes nothing.
+- The helper deserialises: `bytesToWebcastObject(bytes, WebcastXMessage.class)`, or `bytesToWebcastObject(bytes, name)`, which looks the class up by name in `io.github.jwdeveloper.tiktok.api.messages.webcast`; `isMessageHasProtoClass(name)` says whether that class exists; `bytesToProtoBufferStructure(bytes)` decodes any payload into a `ProtoBufferObject` tree with `toJson()`; `toJson(object)` prints an object.
+
+Each event in the result is published after a `TikTokWebsocketMessageEvent` that wraps it, like the events of a default mapping. The example maps `WebcastRankTextMessage` to `TikTokRankTextEvent`, whose constructor takes the message, as the catalog's example does; the other events on the unmapped list have the same kind of constructor, see the [API reference](/api/).
+
+```java
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastRankTextMessage;
+
+TikTokLive.newClient("isaackogz")
+        .mappings(mapper -> mapper.forMessage(WebcastRankTextMessage.class, (bytes, messageName, helper) -> {
+            var message = helper.bytesToWebcastObject(bytes, WebcastRankTextMessage.class);
+            return MappingResult.of(message, new TikTokRankTextEvent(message));
+        }))
+        .onEvent(TikTokRankTextEvent.class, (client, event) ->
+                System.out.println(event.getEventType() + ": " + event.getLabel()))
+        .buildAndConnect();
+```
+
+A mapping can also be a place to look at a message you do not have a class for yet. Registering a name takes the message out of the unhandled path, so `TikTokWebsocketUnhandledMessageEvent` no longer fires for it; return `MappingResult.of(bytes)` to publish nothing.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .mappings(mapper -> mapper.forMessage("WebcastSomeNewMessage", (bytes, messageName, helper) -> {
+            if (helper.isMessageHasProtoClass(messageName)) {
+                System.out.println(helper.bytesToWebcastObject(bytes, messageName));
+            } else {
+                System.out.println(helper.bytesToProtoBufferStructure(bytes).toJson());
+            }
+            return MappingResult.of(bytes);
+        }))
+        .buildAndConnect();
+```
+
+`forMessage(name)` without an action registers the name with a mapping that publishes nothing, so a call made only to set `onBeforeMapping` on a message the defaults do not map silences that message: it stops arriving as `TikTokWebsocketUnhandledMessageEvent` and produces no event. Give such a message an `onMapping` too.
+
+## Wrap or replace a default mapping
+
+`forMessage` returns the message's `TikTokMapperModel`, the existing one for a message the defaults already map, with three hooks. `onBeforeMapping(action)` receives the bytes and returns the bytes to map. `onMapping(action)` replaces the mapping, and the default is lost: after `forMessage(WebcastGiftMessage.class).onMapping(...)`, `onGift` no longer fires unless your mapping builds the gift events itself. `onAfterMapping(function)` receives the `MappingResult`, with `getSource()` (the deserialised message, as `Object`) and `getEvents()`, and returns the list of events to publish, so it can add, drop, or replace events while the default mapping keeps running. `forAnyMessage()` returns a model whose hooks run for every registered message after the message's own at each stage: its `onBeforeMapping` receives the bytes the message's hook returned, its `onAfterMapping` receives the events the message's hook returned, and its `onMapping` runs only when the message's mapping returns `null`. It never sees messages without a mapping.
+
+```java
+import io.github.jwdeveloper.tiktok.api.data.events.common.TikTokEvent;
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastChatMessage;
+import io.github.jwdeveloper.tiktok.client.TikTokLive;
+
+import java.util.ArrayList;
+
+public class CommentLanguages {
+    public static class ForeignCommentEvent extends TikTokEvent {
+        private final String language;
+        private final String text;
+
+        public ForeignCommentEvent(String language, String text) {
+            this.language = language;
+            this.text = text;
+        }
+
+        public String getLanguage() {
+            return language;
+        }
+
+        public String getText() {
+            return text;
+        }
+    }
+
+    public static void main(String[] args) {
+        TikTokLive.newClient("isaackogz")
+                .mappings(mapper -> mapper.forMessage(WebcastChatMessage.class)
+                        .onAfterMapping(result -> {
+                            var message = (WebcastChatMessage) result.getSource();
+                            var events = new ArrayList<>(result.getEvents());
+                            var language = message.getContentLanguage();
+                            if (!language.isEmpty() && !language.equals("en")) {
+                                events.add(new ForeignCommentEvent(language, message.getContent()));
+                            }
+                            return events;
+                        }))
+                .onComment((client, event) ->
+                        System.out.println(event.getUser().getProfileName() + ": " + event.getText()))
+                .onEvent(ForeignCommentEvent.class, (client, event) ->
+                        System.out.println("[" + event.getLanguage() + "] " + event.getText()))
+                .buildAndConnect();
+    }
+}
+```
+
+A mapping that throws is reported as a `TikTokErrorEvent` carrying a `TikTokLiveMessageException` when the message came from the socket, and thrown to the caller when it came from `publishMessage`; see [debugging](/guides/debugging/) and [offline testing](/guides/offline-testing/).
diff --git a/docs/src/content/docs/guides/debugging.md b/docs/src/content/docs/guides/debugging.md
new file mode 100644
index 00000000..73657112
--- /dev/null
+++ b/docs/src/content/docs/guides/debugging.md
@@ -0,0 +1,118 @@
+---
+title: Debugging
+description: Turn on the client's log, read every exception through TikTokErrorEvent, watch the raw traffic with the WebSocket debug events, catch messages the library has no mapping for, decode their payloads, and report a new message type.
+sidebar:
+  order: 7
+---
+
+Four tools cover most event debugging: the client's logger, `TikTokErrorEvent` for every exception the client catches, the three WebSocket debug events for the raw traffic, and `publishMessage` for replaying a payload offline. The debug events' fields are on the [debugging events page](/events/debugging/); this guide is about using them. Replace `isaackogz` with a creator who is live.
+
+## Turn on the log
+
+The client is silent until `printToConsole` is set; `logLevel` then chooses what the logger named after the creator lets through, and `client.getLogger()` is the same `java.util.logging.Logger` for your own lines. The client logs its state changes, reconnects, and the warnings of the connect sequence; the handler's level and how to route the log elsewhere are on the [logging page](/configuration/logging/).
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> {
+            settings.setPrintToConsole(true);
+            settings.setLogLevel(Level.INFO);
+        })
+        .onConnected((client, event) -> client.getLogger().info("Connected to room " + client.getRoomInfo().getRoomId()))
+        .onDisconnected((client, event) -> client.getLogger().info("Disconnected: " + event.getReason()))
+        .buildAndConnect();
+```
+
+## Read every exception
+
+The client reports exceptions as `TikTokErrorEvent`, through `onError` or a listener method, with `getException()`. What arrives depends on where it was thrown:
+
+- The connect sequence: `TikTokLiveOfflineHostException`, `TikTokLiveUnknownHostException`, `TikTokSignServerException`, `TikTokLivePreConnectionException`, or a `TikTokLiveException` such as `Already connected`; the event is published and then `connect()` throws the same exception. See [lifecycle events](/getting-started/connection/#lifecycle-events).
+- Message handling: when a mapping, or a lambda handler called for a message, throws while a batch is processed, the event carries a `TikTokLiveMessageException` with `messageMethod()`, the message name, `messageToBase64()`, its payload, `webcastResponseToBase64()`, the whole batch, and `getCause()`, the original exception; a mapping that cannot deserialise the payload has as that cause a `TikTokMessageMappingException` when it used the helper's `bytesToWebcastObject`, or protobuf's `InvalidProtocolBufferException` when it called the message class's `parseFrom` directly, as the default handler-based mappings do. The client skips the message and continues with the next one.
+- Listener methods: a `TikTokEventListenerMethodException` wrapping the method's exception, from any event; see [listeners](/guides/listeners/#when-a-method-throws).
+
+The message name and payload in a `TikTokLiveMessageException` are what a bug report needs when the library fails on a message it does have a mapping for.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onError((client, event) -> {
+            if (event.getException() instanceof TikTokLiveMessageException e) {
+                System.err.println("Failed on " + e.messageMethod() + ": " + e.getCause());
+                System.err.println("Payload: " + e.messageToBase64());
+            } else {
+                event.getException().printStackTrace();
+            }
+        })
+        .buildAndConnect();
+```
+
+## Watch the raw traffic
+
+For every batch of messages, from the signing response and from each WebSocket frame, the client publishes `TikTokWebsocketResponseEvent` with the whole `ProtoMessageFetchResult`, then, per message, either a `TikTokWebsocketMessageEvent` before each event the message maps to, with the message, the event, and the mapping's duration, or a `TikTokWebsocketUnhandledMessageEvent` when no mapping is registered for the message's name. `TikTokHttpResponseEvent` has a handler but no publisher in this release. This handler counts each batch by message name, which shows at a glance what a room sends and how much of it the client maps:
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onWebsocketResponse((client, event) -> {
+            var counts = new TreeMap<String, Integer>();
+            for (var message : event.getResponse().getMessagesList()) {
+                counts.merge(message.getMethod(), 1, Integer::sum);
+            }
+            System.out.println("Batch of " + event.getResponse().getMessagesCount() + ": " + counts);
+        })
+        .onWebsocketMessage((client, event) ->
+                System.out.println(event.getMessage().getMethod() + " -> " + event.getEvent().getClass().getSimpleName()
+                        + " in " + event.getMetaData().getHandlingTime().toNanos() + " ns"))
+        .buildAndConnect();
+```
+
+## Messages without a mapping
+
+A message type the library does not know ends up in `TikTokWebsocketUnhandledMessageEvent`, not in `TikTokErrorEvent`. `getMessage()` is the raw message with `getMethod()`, the name, and `getPayload()`, the protobuf bytes. This handler prints each new name once, with its payload in Base64, which is the form a bug report and a `publishMessage` replay both take:
+
+```java
+var reported = new HashSet<String>();
+
+TikTokLive.newClient("isaackogz")
+        .onWebsocketUnhandledMessage((client, event) -> {
+            var method = event.getMessage().getMethod();
+            if (!reported.add(method)) {
+                return;
+            }
+            var payload = event.getMessage().getPayload();
+            System.out.println("Unhandled " + method + " (" + payload.size() + " bytes): "
+                    + Base64.getEncoder().encodeToString(payload.toByteArray()));
+        })
+        .buildAndConnect();
+```
+
+## Decode a payload
+
+Two cases. When the [schema reference](/schema/) has a class for the message, which is so for the sixteen [unmapped events](/events/#unmapped-events), parse the payload with the class's `parseFrom` and, where an event class exists, construct it; the next step is a custom mapping, see [custom events and mappings](/guides/custom-events/). When no class exists, `ProtocolUtils.getProtocolBufferStructure(bytes)` decodes the raw protobuf into a `ProtoBufferObject` whose `toJson()` lists the field numbers, wire types, and values, which is enough to see what the message carries and to write a `.proto` definition; `toProtoFile()` drafts one.
+
+```java
+import com.google.protobuf.InvalidProtocolBufferException;
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastRankTextMessage;
+
+TikTokLive.newClient("isaackogz")
+        .onWebsocketUnhandledMessage((client, event) -> {
+            var payload = event.getMessage().getPayload();
+            if (event.getMessage().getMethod().equals("WebcastRankTextMessage")) {
+                try {
+                    var rankText = new TikTokRankTextEvent(WebcastRankTextMessage.parseFrom(payload));
+                    System.out.println("Rank text: " + rankText.getLabel());
+                } catch (InvalidProtocolBufferException e) {
+                    System.err.println("Not a WebcastRankTextMessage: " + e.getMessage());
+                }
+            } else {
+                System.out.println(ProtocolUtils.getProtocolBufferStructure(payload.toByteArray()).toJson());
+            }
+        })
+        .buildAndConnect();
+```
+
+## Replay a payload offline
+
+A payload captured with the handlers above, or with the [collector](/guides/collector/), can be fed to an offline client with `publishMessage(name, payloadBase64)` and goes through the same mapping as a socket message, so a mapping or a handler can be debugged without a live room, and a failing payload fails right at the `publishMessage` call with the exception. See [offline testing](/guides/offline-testing/#replay-recorded-messages).
+
+## Report a new message type
+
+Check the [schema reference](/schema/) first: when the library already has a class for the message, a custom mapping is the fix and needs no report. When it has none, open an issue on the [TikTokLiveJava GitHub repository](https://github.com/jwdeveloper/TikTokLiveJava/issues) with the message name, one or more Base64 payloads from the unhandled-message handler, the library version (`1.13.1-Release` for these pages), and what was happening in the stream when the message arrived, such as a gift, a battle, or a poll. The payload is what lets the message be decoded and a schema written; a name alone is not enough. For a message the library does map but fails on, report the name and payload from the `TikTokLiveMessageException` instead. The `Unhandled exception` line the client logs when `connect()` hits an unexpected error asks for the same report.
diff --git a/docs/src/content/docs/guides/gifts.md b/docs/src/content/docs/guides/gifts.md
new file mode 100644
index 00000000..bc415dea
--- /dev/null
+++ b/docs/src/content/docs/guides/gifts.md
@@ -0,0 +1,88 @@
+---
+title: Gifts and combos
+description: Count a streaked gift once with TikTokGiftEvent, follow a streak with TikTokGiftComboEvent, read the room's gift list from the gift manager, and test gift handlers offline.
+sidebar:
+  order: 1
+---
+
+A gift reaches your code as two events. `TikTokGiftEvent` is published once per gift: at once for a gift that cannot streak, and once per completed streak for one that can. `TikTokGiftComboEvent` is published for every frame of a streak, with the streak's state. Both carry `getGift()`, `getUser()` (the sender), `getToUser()` (the recipient, which is the host when the message names none), and `getCombo()`, the streak's count; the field lists are on the [gifts and goals page](/events/gifts-and-goals/). This guide is based on the repository's `Events_And_Gifts_Testing_Example.java` and the README's `onGift` and `onGiftCombo` sections. Replace `isaackogz` with a creator who is live.
+
+## Count a gift once
+
+A viewer can hold the gift button to send the same gift repeatedly. TikTok reports the streak as a series of `WebcastGiftMessage`s whose combo count climbs, then a final frame with the total. The client's gift handler keeps the state of each streak, keyed by sender, gift, and group, and publishes `TikTokGiftEvent` only when the streak is complete: on the final frame or, when TikTok sends none, at the first gift message that arrives more than five minutes after the streak's last frame. A final frame that TikTok repeats within a minute is dropped. A gift whose type cannot streak is published at once. So `onGift` sees each gift exactly once, and `getCombo()` times `getDiamondCost()` is the value of the whole streak.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onGift((client, event) -> {
+            var gift = event.getGift();
+            var diamonds = (long) gift.getDiamondCost() * event.getCombo();
+            System.out.println(event.getUser().getProfileName() + " sent " + event.getCombo() + " x " + gift.getName()
+                    + " (" + diamonds + " diamonds) to " + event.getToUser().getProfileName());
+        })
+        .buildAndConnect();
+```
+
+Handlers are matched by the event's exact class, so `onGift` is never called for a `TikTokGiftComboEvent`, although that class extends `TikTokGiftEvent`; a `Finished` combo event and the `TikTokGiftEvent` for the same gift are two separate publications, in that order. The diamond cost is TikTok's price metadata for the gift, not what the creator is paid.
+
+## Follow a streak while it runs
+
+`onGiftCombo` receives every frame. `getComboState()` is a `GiftComboStateType`: `Begin` on the first frame of a streak, `Active` on each later frame, and `Finished` on the final frame, on a non-streakable gift, and when a streak times out. `getCombo()` is the count so far and is cumulative, so display the latest value rather than adding the frames up. Count gifts in `onGift`, not in the `Finished` branch here: a streakable gift whose first frame is already its final one produces no combo frame at all, so counting here misses it.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onGiftCombo((client, event) -> {
+            var who = event.getUser().getProfileName();
+            var what = event.getGift().getName();
+            switch (event.getComboState()) {
+                case Begin -> System.out.println(who + " started a " + what + " streak");
+                case Active -> System.out.println(who + ": " + event.getCombo() + " x " + what + " so far");
+                case Finished -> System.out.println(who + " finished at " + event.getCombo() + " x " + what);
+            }
+        })
+        .buildAndConnect();
+```
+
+A streakable gift produces `Begin`, zero or more `Active` frames, then `Finished`, but the handler publishes that `Finished` frame only when a `Begin` preceded it: a streakable gift whose first frame is already its final one produces no combo frame at all, only its `TikTokGiftEvent`. A non-streakable gift produces a single `Finished` frame, followed by its `TikTokGiftEvent`. Whether a gift can streak is the gift type in the message, which the handler reads before it builds the events; the `Gift` object has no field for it, so tell the two kinds apart by whether a `Begin` frame arrived.
+
+## The gift list
+
+`client.getGiftManager()` returns the `GiftsManager`, the client's index of known gifts by id: `getById(int)`, `getByName(String)` (case-insensitive), `getByFilter(Predicate<Gift>)`, `getManyByFilter(Predicate<Gift>)`, `toList()`, and `toMap()`. A lookup that finds nothing returns `Gift.UNDEFINED`, a gift with id `-1`, name `undefined`, and cost `-1`, rather than `null`. `attachGift(Gift)` and `attachGiftsList(List<Gift>)` add your own entries.
+
+The manager starts empty. With `fetchGifts` set to `true`, `connect()` downloads the room's gift list after `TikTokPreConnectionEvent` and before the socket opens, so every gift is known before the first event; see [client settings](/configuration/client-settings/). Otherwise the handler resolves each gift message by id, then by name, and when neither is known it builds the `Gift` from the message and attaches it, so the manager fills up as gifts arrive.
+
+A `Gift` has `getId()`, `getName()`, `getDiamondCost()`, `getPicture()` (a `Picture` with `getLink()` and `downloadImage()`), `getProperties()` (a `JsonObject` with the extra fields of the fetched list, empty for a gift built from a message), and the helpers `hasDiamondCost(int)` and `hasDiamondCostRange(int, int)`.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setFetchGifts(true))
+        .onConnected((client, event) -> {
+            var gifts = client.getGiftManager();
+            System.out.println(gifts.toList().size() + " gifts in this room");
+            for (var gift : gifts.getManyByFilter(g -> g.getDiamondCost() >= 1000)) {
+                System.out.println(gift.getName() + ": " + gift.getDiamondCost() + " diamonds, " + gift.getPicture().getLink());
+            }
+        })
+        .buildAndConnect();
+```
+
+## Test gift handlers offline
+
+`TikTokGiftEvent.of(gift)`, `TikTokGiftEvent.of(name, id, diamonds)`, and `TikTokGiftComboEvent.of(gift, combo, state)` build events without a message, and `publishEvent` dispatches them to your handlers without a connection. In offline mode nothing fetches the gift list, so `getGiftManager().getByName(...)` returns `Gift.UNDEFINED` until you attach the gifts the test needs; the repository's example looks `Rose` up without attaching it and so publishes the undefined gift. See [offline testing](/guides/offline-testing/) for what the mode can and cannot do.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setOffline(true))
+        .onGift((liveClient, event) ->
+                System.out.println(event.getCombo() + " x " + event.getGift().getName() + " from " + event.getUser().getName()))
+        .onGiftCombo((liveClient, event) ->
+                System.out.println(event.getComboState() + " at " + event.getCombo()))
+        .build();
+
+var rose = new Gift(5655, "Rose", 1, "");
+client.getGiftManager().attachGift(rose);
+
+client.publishEvent(TikTokGiftComboEvent.of(rose, 1, GiftComboStateType.Begin));
+client.publishEvent(TikTokGiftComboEvent.of(rose, 12, GiftComboStateType.Finished));
+client.publishEvent(TikTokGiftEvent.of(client.getGiftManager().getByName("rose")));
+client.publishEvent(TikTokGiftEvent.of("Galaxy", 7122, 1000));
+```
diff --git a/docs/src/content/docs/guides/listeners.md b/docs/src/content/docs/guides/listeners.md
new file mode 100644
index 00000000..4e1ac509
--- /dev/null
+++ b/docs/src/content/docs/guides/listeners.md
@@ -0,0 +1,158 @@
+---
+title: Listeners
+description: Register handlers as annotated methods of a listener class with addListener, choose the method parameters, set priority and async on @TikTokEventObserver, add and remove listeners at runtime, and what happens when a method throws.
+sidebar:
+  order: 2
+---
+
+A listener is any object whose methods carry `@TikTokEventObserver`. `addListener(listener)` on the builder registers it when `build()` runs; `client.getListenersManager().addListener(listener)` registers one on a built client. Each annotated method becomes a handler for the event class of its parameter, the same as a lambda passed to `onEvent`, so a listener is the way to keep related handlers, and the state they share, together in one class instead of a chain of lambdas. This guide is based on the repository's `ListenerExample.java`. Replace `isaackogz` with a creator who is live.
+
+## Write a listener
+
+The listeners manager scans the methods declared on the listener's class and registers every one that carries `@TikTokEventObserver` and has at least one parameter. The event class is the first parameter whose type extends `TikTokEvent`; the other parameters are resolved from the client's container, so a `LiveClient` parameter can come first, second, or be left out. The method may be private: the manager makes it accessible. A method that carries the annotation but has no `TikTokEvent` parameter fails registration with `TikTokEventListenerMethodException`, which `addListener` throws, so from `build()` for a listener added on the builder.
+
+```java
+import io.github.jwdeveloper.tiktok.api.annotations.TikTokEventObserver;
+import io.github.jwdeveloper.tiktok.api.data.events.TikTokCommentEvent;
+import io.github.jwdeveloper.tiktok.api.data.events.TikTokErrorEvent;
+import io.github.jwdeveloper.tiktok.api.data.events.common.TikTokEvent;
+import io.github.jwdeveloper.tiktok.api.data.events.gift.TikTokGiftEvent;
+import io.github.jwdeveloper.tiktok.api.data.events.social.TikTokLikeEvent;
+import io.github.jwdeveloper.tiktok.api.live.LiveClient;
+import io.github.jwdeveloper.tiktok.client.TikTokLive;
+
+public class ChatListener {
+    private int likes;
+
+    @TikTokEventObserver
+    public void onComment(LiveClient client, TikTokCommentEvent event) {
+        client.getLogger().info(event.getUser().getName() + ": " + event.getText());
+    }
+
+    @TikTokEventObserver
+    public void onGift(LiveClient client, TikTokGiftEvent event) {
+        var message = switch (event.getGift().getName()) {
+            case "Rose" -> "Thanks for the rose!";
+            case "TikTok" -> "A TikTok gift, nice!";
+            default -> "Thanks for the " + event.getGift().getName();
+        };
+        client.getLogger().info(message);
+    }
+
+    @TikTokEventObserver
+    public void onLike(TikTokLikeEvent event) {
+        likes += event.getLikes();
+    }
+
+    @TikTokEventObserver
+    private void onError(TikTokErrorEvent event, LiveClient client) {
+        client.getLogger().warning("Error: " + event.getException().getMessage());
+    }
+
+    @TikTokEventObserver
+    public void onAnyEvent(LiveClient client, TikTokEvent event) {
+        client.getLogger().info(event.getClass().getSimpleName() + ", " + likes + " likes so far");
+    }
+
+    public static void main(String[] args) {
+        TikTokLive.newClient("isaackogz")
+                .configure(settings -> settings.setPrintToConsole(true))
+                .addListener(new ChatListener())
+                .buildAndConnect();
+    }
+}
+```
+
+A method is called for events of exactly its parameter's class, plus the `TikTokEvent` catch-all: `onGift` above is not called for a `TikTokGiftComboEvent`, and a method taking `TikTokLinkEvent` receives only the generic link event, not `TikTokLinkInviteEvent`. A method whose parameter is `TikTokEvent` receives every event, including the debug events and the ones you publish yourself; see the [event catalog](/events/). Listener methods run on the thread that publishes the event, which for socket messages is the socket's thread, so a slow method delays the messages behind it.
+
+## Priority and asynchronous methods
+
+`@TikTokEventObserver` has two attributes. `priority`, a `Priority` from `HIGHEST` to `LOWEST` (default `NORMAL`), sorts the listener's methods when the listener is registered. In this release that is as far as it goes: the event handler stores the handlers of each event class in a `HashSet` and runs them by iterating it, so the order in which several handlers for one event run, lambdas or listener methods, from one listener or several, is unspecified, and `priority` does not fix it. Write handlers that do not depend on each other's order.
+
+`async = true` runs the method on an `ExecutorService` instead of the publishing thread. The executor is the one set with `getListenersManager().setAsyncExecutor(executor)` or, when none is set, a cached thread pool created the first time an asynchronous method is registered. The executor is captured when the listener is registered, and listeners added on the builder are registered during `build()`, before the manager can be reached; so to use your own executor, build the client, set the executor, then add the listener through the manager.
+
+```java
+import io.github.jwdeveloper.tiktok.api.annotations.Priority;
+import io.github.jwdeveloper.tiktok.api.annotations.TikTokEventObserver;
+import io.github.jwdeveloper.tiktok.api.data.events.TikTokCommentEvent;
+import io.github.jwdeveloper.tiktok.api.live.LiveClient;
+import io.github.jwdeveloper.tiktok.client.TikTokLive;
+
+import java.util.concurrent.Executors;
+
+public class AsyncListener {
+    @TikTokEventObserver(async = true, priority = Priority.LOW)
+    public void onComment(LiveClient client, TikTokCommentEvent event) {
+        // A slow lookup here no longer delays the next message
+        client.getLogger().info(Thread.currentThread().getName() + " handled: " + event.getText());
+    }
+
+    public static void main(String[] args) {
+        var client = TikTokLive.newClient("isaackogz")
+                .configure(settings -> settings.setPrintToConsole(true))
+                .build();
+        client.getListenersManager().setAsyncExecutor(Executors.newFixedThreadPool(4));
+        client.getListenersManager().addListener(new AsyncListener());
+        client.connect();
+    }
+}
+```
+
+## Add and remove listeners at runtime
+
+`client.getListenersManager()` returns the `ListenersManager`: `addListener(Object)`, `removeListener(Object)`, which unsubscribes every method of that object, and `getListeners()`. Registering the same object twice throws `TikTokLiveException`; a second instance of the same class is a separate listener. Removing an object that was never added does nothing. Any object with annotated methods qualifies, an anonymous class included.
+
+```java
+var client = TikTokLive.newClient("isaackogz").build();
+var manager = client.getListenersManager();
+
+var greeter = new Object() {
+    @TikTokEventObserver
+    public void onJoin(LiveClient liveClient, TikTokJoinEvent event) {
+        liveClient.getLogger().info("Welcome " + event.getUser().getProfileName());
+    }
+};
+
+manager.addListener(greeter);
+client.connect();
+System.out.println(manager.getListeners().size() + " listener(s) registered");
+manager.removeListener(greeter);
+```
+
+## When a method throws
+
+An exception thrown by a listener method does not reach the publisher: the manager catches it and publishes a `TikTokErrorEvent` whose exception is a `TikTokEventListenerMethodException` wrapping the reflective call's `InvocationTargetException`, so your exception is at the end of the cause chain. The client then carries on with the next handler and the next message. Do not throw from a method that handles `TikTokErrorEvent`: its failure publishes another `TikTokErrorEvent`, which calls it again.
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onError((client, event) -> {
+            var exception = event.getException();
+            if (exception instanceof TikTokEventListenerMethodException) {
+                var cause = exception;
+                while (cause.getCause() != null) {
+                    cause = cause.getCause();
+                }
+                System.err.println("A listener method failed: " + cause);
+            }
+        })
+        .buildAndConnect();
+```
+
+## TikTokEventListenerBase
+
+`TikTokEventListenerBase` is an abstract class with an empty method per event, `onComment(LiveClient, TikTokCommentEvent)`, `onGift(LiveClient, TikTokGiftEvent)`, and so on, as a list of the signatures to override. Extending it registers nothing by itself: the manager scans only the annotated methods declared on your class, and the base's methods carry no annotation. Annotate each override.
+
+```java
+import io.github.jwdeveloper.tiktok.api.annotations.TikTokEventObserver;
+import io.github.jwdeveloper.tiktok.api.data.events.social.TikTokFollowEvent;
+import io.github.jwdeveloper.tiktok.api.listener.TikTokEventListenerBase;
+import io.github.jwdeveloper.tiktok.api.live.LiveClient;
+
+public class FollowListener extends TikTokEventListenerBase {
+    @Override
+    @TikTokEventObserver
+    public void onFollow(LiveClient client, TikTokFollowEvent event) {
+        client.getLogger().info(event.getUser().getProfileName() + " followed");
+    }
+}
+```
diff --git a/docs/src/content/docs/guides/offline-testing.md b/docs/src/content/docs/guides/offline-testing.md
new file mode 100644
index 00000000..94bbc389
--- /dev/null
+++ b/docs/src/content/docs/guides/offline-testing.md
@@ -0,0 +1,85 @@
+---
+title: Offline testing
+description: Build a client in offline mode and drive handlers and listeners with publishEvent and publishMessage, the of factories for test events, replaying recorded Webcast payloads, and what offline mode cannot do.
+sidebar:
+  order: 6
+---
+
+`offline` on `LiveClientSettings` makes `build()` wire stand-in HTTP and WebSocket clients, so no request leaves the process, and `publishEvent` and `publishMessage` then drive handlers and listeners exactly as live traffic would. Do not call `connect()` on an offline client: in this release it fails before the stand-in socket starts, see [offline mode](/configuration/client-settings/#offline-mode); `build()` is all a test needs. This guide is based on the repository's `Events_And_Gifts_Testing_Example.java`.
+
+## Publish events
+
+`publishEvent(event)` runs the handlers for the event's exact class and the `TikTokEvent` catch-all, on the calling thread, before it returns; an exception thrown by a handler propagates to the caller. Several event classes have `of` factories that build an event without a Webcast message:
+
+| Factory | Builds |
+| --- | --- |
+| `TikTokCommentEvent.of(userName, text)` | A comment whose `getUser().getName()` is `userName` |
+| `TikTokLikeEvent.of(userName, likes)`, `of(user, likes)` | A like event with that count |
+| `TikTokFollowEvent.of(userName)`, `of(user)` | A follow |
+| `TikTokShareEvent.of(userName, shares)`, `of(user, shares)` | A share |
+| `TikTokJoinEvent.of(userName)`, `of(user)` | A join |
+| `TikTokSubscribeEvent.of(userName)` | A subscription |
+| `TikTokGiftEvent.of(gift)`, `of(name, id, diamonds)`, `of(gift, user, toUser)` | A gift; see [gifts](/guides/gifts/#test-gift-handlers-offline) |
+| `TikTokGiftComboEvent.of(gift, combo, state)`, `of(gift, host, user, combo, state)` | A streak frame with that count and `GiftComboStateType` |
+| `TikTokConnectedEvent.of()`, `TikTokConnectingEvent.of()`, `TikTokLiveEndedEvent.of()` | The control event with no fields |
+| `TikTokErrorEvent.of(message)` | An error carrying a `TikTokLiveException` with that message |
+
+Any other message event has a constructor that takes its Webcast message, which the protobuf builders can create: `new TikTokCommentEvent(WebcastChatMessage.newBuilder().setContent("hi").build())` is a comment from a user with id `0` and an empty name. Fields the builder leaves unset read as protobuf defaults, not `null`.
+
+```java
+var client = TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setOffline(true))
+        .onComment((liveClient, event) ->
+                System.out.println(event.getUser().getName() + ": " + event.getText()))
+        .onLike((liveClient, event) ->
+                System.out.println(event.getUser().getName() + " sent " + event.getLikes() + " likes"))
+        .onFollow((liveClient, event) ->
+                System.out.println(event.getUser().getName() + " followed"))
+        .onGift((liveClient, event) ->
+                System.out.println(event.getCombo() + " x " + event.getGift().getName()))
+        .build();
+
+client.publishEvent(TikTokCommentEvent.of("mark", "Hello world"));
+client.publishEvent(TikTokLikeEvent.of("mark", 12));
+client.publishEvent(TikTokFollowEvent.of("mark"));
+client.publishEvent(TikTokGiftEvent.of("Rose", 5655, 1));
+```
+
+Listeners are tested the same way: add them on the builder or through `getListenersManager()`, then publish; see [listeners](/guides/listeners/). A listener method that does not use its `LiveClient` parameter can also be called directly from a test with `null`, without a client at all.
+
+## Replay recorded messages
+
+`publishMessage(name, payloadBase64)` and `publishMessage(name, payload)` wrap the bytes in a Webcast message with that name and run it through the mapper, as a message from the socket would be: a name with no mapping publishes `TikTokWebsocketUnhandledMessageEvent`; a mapped one publishes a `TikTokWebsocketMessageEvent` and then the event, for each event the mapping returns. No `TikTokWebsocketResponseEvent` is published, since there is no batch, and a mapping that throws is not reported as a `TikTokErrorEvent` but thrown to the caller, so a bad payload fails the test at the `publishMessage` call. Custom mappings registered with `mappings` apply; see [custom events and mappings](/guides/custom-events/).
+
+Payloads come from three places: a handler on `onWebsocketMessage` or `onWebsocketUnhandledMessage` that encodes `event.getMessage().getPayload().toByteArray()` with `Base64.getEncoder()`, the [collector](/guides/collector/), whose `message` documents hold the name and the Base64 payload, and the repository's example, which carries a `WebcastLikeMessage` payload. A message can also be built in code with the protobuf builders.
+
+```java
+import io.github.jwdeveloper.tiktok.api.messages.webcast.WebcastChatMessage;
+
+var client = TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setOffline(true))
+        .onWebsocketMessage((liveClient, event) ->
+                System.out.println(event.getMessage().getMethod() + " -> " + event.getEvent().getClass().getSimpleName()))
+        .onWebsocketUnhandledMessage((liveClient, event) ->
+                System.out.println("No mapping for " + event.getMessage().getMethod()))
+        .onComment((liveClient, event) -> System.out.println("Comment: " + event.getText()))
+        .onLike((liveClient, event) -> System.out.println("Likes: " + event.getLikes() + ", total " + event.getTotalLikes()))
+        .build();
+
+var chat = WebcastChatMessage.newBuilder().setContent("Replayed from bytes").setContentLanguage("en").build();
+client.publishMessage("WebcastChatMessage", chat.toByteArray());
+
+client.publishMessage("WebcastLikeMessage", "EAUYZA==");
+
+client.publishMessage("WebcastNotYetKnownMessage", new byte[0]);
+```
+
+The Base64 string is a `WebcastLikeMessage` with `count` 5 and `total` 100, built with the same builders and encoded; a like message maps to a `TikTokLikeEvent` and then a `TikTokRoomInfoEvent`, so the handler above runs after one `TikTokWebsocketMessageEvent` for each.
+
+## What offline mode cannot do
+
+- `connect()` fails before the stand-in socket starts, so no `TikTokConnectedEvent` or `TikTokDisconnectedEvent` comes from the lifecycle. A handler that waits for one gets it from `publishEvent(TikTokConnectedEvent.of())`.
+- `getRoomInfo()` holds the `hostName` and nothing else: `getRoomId()` and `getHost()` are `null`. The gift mapping uses `getHost()` as the recipient of a gift message that names none, so a `WebcastGiftMessage` replayed offline has a `null` `getToUser()` unless the message sets `toUser`.
+- The gift manager is empty, since no gift list is fetched; attach the gifts a test needs, see [gifts](/guides/gifts/#test-gift-handlers-offline).
+- `sendChat` returns `false` without sending.
+- `TikTokLive.isLiveOnline` and `isHostNameValid` are static and make their requests regardless of any client's settings.
diff --git a/docs/src/content/docs/guides/recorder.md b/docs/src/content/docs/guides/recorder.md
new file mode 100644
index 00000000..6e978b0d
--- /dev/null
+++ b/docs/src/content/docs/guides/recorder.md
@@ -0,0 +1,97 @@
+---
+title: Record a livestream
+description: Save the live video with the extension-recorder module's TikTokLiveRecorder listener, set the output file and stop behaviour, react to the recorder's events, and what the recorder needs from the connection.
+sidebar:
+  order: 4
+---
+
+`TikTokLiveRecorder`, in the `extension-recorder` module, is a listener that downloads the stream's video to a file while the client is connected. It needs no FFmpeg: it reads the stream URL from the room page the client fetches while connecting and writes the bytes it receives, so the output is the FLV stream as TikTok sends it. This guide is based on the repository's `RecorderExample.java`. Replace `isaackogz` with a creator who is live.
+
+## Install
+
+The module is published on JitPack next to the `Client` artifact, with the same group and version, and depends on `Client`, so it brings the client with it; see [install](/getting-started/install/) for the repository declaration.
+
+```xml
+<dependency>
+    <groupId>com.github.jwdeveloper.TikTok-Live-Java</groupId>
+    <artifactId>extension-recorder</artifactId>
+    <version>1.13.1-Release</version>
+</dependency>
+```
+
+```groovy
+implementation 'com.github.jwdeveloper.TikTok-Live-Java:extension-recorder:1.13.1-Release'
+```
+
+## Record from connect to disconnect
+
+`TikTokLiveRecorder.use((recorderSettings, client) -> ...)` returns the listener; pass it to `addListener`. The consumer runs on `TikTokPreConnectionEvent`, when the room information is already filled, so the settings can depend on the room. What happens, in order:
+
+1. On `TikTokPreConnectionEvent` the listener runs your consumer, then reads the room page JSON from the event and picks the stream: the first rendition present in the order `origin`, `hd`, `sd`, `ld`, `hd_60`, `uhd_60`, `ao`, and its `flv` URL, together with the session id. When no URL is found it logs a warning and, with `cancelConnectionIfNotFound` set, cancels the connection, so `connect()` throws `TikTokLivePreConnectionException`.
+2. On `TikTokConnectedEvent` it publishes `TikTokLiveRecorderStartedEvent`; a handler can call `setCanceled(true)` on it to skip the recording. Otherwise it starts a background task that requests the URL with the client's default headers and appends every byte received to `outputFile`, creating its parent directories first, which is why the path must include a directory component: a bare filename has no parent to create, and the task fails before writing anything.
+3. The task stops when the client's state leaves `CONNECTED` (with `stopOnDisconnect`, the default), when `TikTokDisconnectedEvent` or `TikTokLiveEndedEvent` arrives, or when TikTok closes the stream; then it logs `Stopped recording` and publishes `TikTokLiveRecorderEndedEvent`.
+
+The two events live in `io.github.jwdeveloper.tiktok.extension.recorder.impl.event` and have no builder method; subscribe with `onEvent`. `TikTokLiveRecorderStartedEvent` has `getDownloadData()`, with `getDownloadLiveUrl()`, `getSessionId()`, and `getFullUrl()`, the URL requested; both events have `getSettings()`.
+
+```java
+import io.github.jwdeveloper.tiktok.extension.recorder.TikTokLiveRecorder;
+import io.github.jwdeveloper.tiktok.extension.recorder.impl.event.TikTokLiveRecorderEndedEvent;
+import io.github.jwdeveloper.tiktok.extension.recorder.impl.event.TikTokLiveRecorderStartedEvent;
+
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setPrintToConsole(true))
+        .onError((client, event) -> event.getException().printStackTrace())
+        .addListener(TikTokLiveRecorder.use((recorderSettings, client) -> {
+            recorderSettings.setOutputFile(new File("recordings", client.getRoomInfo().getHostName() + ".flv"));
+            recorderSettings.setCancelConnectionIfNotFound(true);
+        }))
+        .onEvent(TikTokLiveRecorderStartedEvent.class, (client, event) ->
+                System.out.println("Recording " + event.getDownloadData().getFullUrl()))
+        .onEvent(TikTokLiveRecorderEndedEvent.class, (client, event) ->
+                System.out.println("Saved " + event.getSettings().getOutputFile()))
+        .buildAndConnect();
+```
+
+The socket thread keeps the process alive while the client is connected, and the download runs on the common pool, so a `main` that ends with `buildAndConnect()` records until the stream ends or the client disconnects.
+
+## Settings
+
+`RecorderSettings` is the object the consumer receives.
+
+| Setter | Type | Default | Effect |
+| --- | --- | --- | --- |
+| `setOutputFile` | `File` | none | The file the stream is appended to; its parent directories are created. Required, and the path must include a directory component, such as `new File("recordings", "clip.flv")`: without a file, or with a bare filename such as `new File("clip.flv")`, the download task fails with a printed `NullPointerException` and no ended event. A second recording by the same listener appends to the same file. |
+| `setStopOnDisconnect` | `boolean` | `true` | Stop writing as soon as the client's state is no longer `CONNECTED`, and on `TikTokDisconnectedEvent`. With `false`, the recording runs until the stream ends or TikTok closes it. |
+| `setCancelConnectionIfNotFound` | `boolean` | `false` | Cancel the connection from `TikTokPreConnectionEvent` when no stream URL is found, instead of connecting without recording. |
+| `setPrepareDownloadData` | `Function<String, DownloadData>` | none | Replaces the URL lookup. Receives the room page JSON and returns `new DownloadData(url, sessionId)`; `getFullUrl()` appends `_webnoredir=1&_session_id=<sessionId>` to the URL. |
+
+`TikTokLiveRecorder.use()` without a consumer exists, but it leaves `outputFile` unset, so use the consumer form. `LiveQuality` and `LiveFormat` enums exist in `impl.enums`, but the quality and format settings are commented out in this release: the first rendition found in the order above is used, and the output is always the FLV stream.
+
+## Stop a recording
+
+`LiveRecorder`, the type `use` returns, has no stop method. Disconnecting the client stops the recording when `stopOnDisconnect` is `true`: the download loop checks the connection state on every chunk, so it ends at the next one. While a recording runs, a further `TikTokConnectedEvent` is ignored, so one listener records one stream at a time.
+
+```java
+import io.github.jwdeveloper.tiktok.extension.recorder.TikTokLiveRecorder;
+
+var client = TikTokLive.newClient("isaackogz")
+        .addListener(TikTokLiveRecorder.use((recorderSettings, liveClient) ->
+                recorderSettings.setOutputFile(new File("recordings", "clip.flv"))))
+        .buildAndConnect();
+
+Thread.sleep(60_000);
+client.disconnect();
+```
+
+The file is the FLV stream as received, which VLC and `ffplay` open directly. To change the container without re-encoding:
+
+```sh
+ffmpeg -i recordings/clip.flv -c copy clip.mp4
+```
+
+## Requirements and limits
+
+- The recorder needs the default connection path. With `useEulerstreamWebsocket`, no `TikTokPreConnectionEvent` is published, so the URL is never looked up, and the listener's `TikTokConnectedEvent` method then fails with a `NullPointerException`, reported as a `TikTokErrorEvent`; see [signing](/configuration/signing/).
+- The stream URL comes from `data.liveRoom.streamData.pull_data.stream_data` in the room page. When TikTok changes that layout the lookup finds nothing and logs `Unable to find download live url!`; `setPrepareDownloadData` is the way to supply the URL yourself.
+- Everything the listener logs goes through the client's logger, so it is silent unless `printToConsole` is on; see [logging](/configuration/logging/).
+- The repository example sets `setFfmpegPath` in a comment; no such setter exists in this release.
diff --git a/docs/src/content/docs/hosting.md b/docs/src/content/docs/hosting.md
new file mode 100644
index 00000000..79ad4f15
--- /dev/null
+++ b/docs/src/content/docs/hosting.md
@@ -0,0 +1,89 @@
+---
+title: Hosting
+description: Host the static documentation on Cloudflare Workers static assets under a custom domain, deploy it from CI or a checkout, track the upstream repository on a schedule, and gate deploys on SEO checks.
+---
+
+The site is deployed to Cloudflare Workers as static assets and served at `https://ttlj.docs.isaackogan.com/`. Hosting lives in a maintainer's Cloudflare account while the documentation source stays in the public repository: the fork `isaackogan/TikTokLiveJava` holds the deployment secrets and runs the deploys, and a scheduled run there builds and deploys the upstream `jwdeveloper/TikTokLiveJava` `master` every day once upstream carries `docs/` (until then the run checks and skips), so the site tracks upstream without the upstream repository holding any credentials. The same workflow in the upstream repository validates every pull request, skips its scheduled run while it has no deploy secrets, and would deploy too if its maintainer added them. There is no Worker script: `docs/wrangler.jsonc` only declares the asset directory and the HTML handling; the custom domain is attached to the Worker once by a maintainer, not by the config, so CI deploys with a token scoped to that Worker alone. The site needs no Cloudflare Astro adapter and no TikTok or signing credentials; its only external link requirement is the dofollow links to [Euler Stream](https://www.eulerstream.com/) the SEO gate checks.
+
+## Configuration
+
+```jsonc
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "tiktoklivejava-docs",
+  "compatibility_date": "2026-10-20",
+  "assets": {
+    "directory": "./dist",
+    "html_handling": "auto-trailing-slash",
+    "not_found_handling": "404-page"
+  },
+  // The custom domain ttlj.docs.isaackogan.com is attached to the Worker once by a maintainer
+  // and survives deploys, so no routes are declared here and the CI token needs no zone permission.
+  "workers_dev": false
+}
+```
+
+- `html_handling: auto-trailing-slash` matches Astro's `trailingSlash: 'always'`. A request for `/events` redirects to `/events/`, which serves `events/index.html`.
+- `not_found_handling: 404-page` serves Starlight's generated `404.html` with a 404 status.
+- `workers_dev: false` keeps the site off the `workers.dev` hostname so the custom domain is the only public origin.
+- There is no `routes` block. A maintainer created the Worker `tiktoklivejava-docs` from their own wrangler login and attached the custom domain `ttlj.docs.isaackogan.com` to it once, in the Cloudflare dashboard under the Worker's **Settings → Domains & Routes** or with a one-off `wrangler deploy` from a logged-in session using a `routes` entry in a local copy of the config; Cloudflare created the DNS record and the certificate then, and the attachment survives every later deploy. Because the config declares no routes, a deploy prints `No targets deployed`, which is expected, and the CI token needs no zone permission: a token with Worker-only rights uploads the site but gets a 403 reconciling a `routes` custom domain, which is why the entry is left out. The `isaackogan.com` zone is in the same Cloudflare account as the Worker.
+
+`DOCS_SITE` overrides the canonical origin and defaults to the custom domain. `DOCS_BASE` sets the deployment subpath and defaults to `/`. Neither needs to be set for a production build.
+
+See Cloudflare's [static assets](https://developers.cloudflare.com/workers/static-assets/) and [custom domains](https://developers.cloudflare.com/workers/configuration/routing/custom-domains/) documentation for the underlying behaviour.
+
+## Build inputs
+
+The build needs both toolchains, because the reference pages are generated from the library sources and the examples are compiled against the built library:
+
+- JDK 17 or newer and Maven; `pnpm --dir docs build` runs the Maven build of the four library modules itself.
+- Node.js 24 and pnpm 10.34.2 with `pnpm --dir docs install --frozen-lockfile`.
+
+The [contributing page](/contributing/) has the full setup and the commands.
+
+## Deploy from a checkout
+
+Wrangler is pinned in `docs/package.json`, so the documentation install provides it. Run `pnpm --dir docs exec wrangler login` once on a new machine; the login is an OAuth session in the maintainer's account.
+
+```sh
+pnpm --dir docs install --frozen-lockfile
+pnpm --dir docs build
+pnpm --dir docs run deploy:cloudflare
+```
+
+The Worker and its custom domain already exist, so a deploy only uploads the files that changed to the existing Worker. Wrangler reports the upload and then `No targets deployed`, because the config declares no routes; the custom domain stays attached and keeps serving the new build. `pnpm --dir docs exec wrangler deploy --dry-run --outdir /tmp/wrangler-dry` validates the config and the asset directory without uploading.
+
+## Continuous deployment
+
+`.github/workflows/docs.yml`, named `Documentation`, runs on pull requests and on pushes to `master` that touch `docs/`, `API/`, `Client/`, `extension-recorder/`, `extension-collector/`, `README.md`, or the workflow itself; it can be started by hand with `workflow_dispatch`; and it runs on a schedule, `17 6 * * *`, 06:17 UTC every day. Its permissions are `contents: read`, and one run at a time per ref: the concurrency group is `docs-${{ github.ref }}`, with `cancel-in-progress` only for pull requests, so a new push to a pull request replaces the running check, while `master` pushes and scheduled runs, which share the `refs/heads/master` group, queue behind each other and no deploy is cancelled mid-upload.
+
+The workflow has two jobs. The first, `upstream`, has a single step, `Check whether upstream carries the documentation`, and a job variable `DEPLOY_ENABLED` derived from whether the `CLOUDFLARE_API_TOKEN` secret is set. On every event other than the schedule the step sets the job output `has_docs` to `true`. On a scheduled run it first looks at `DEPLOY_ENABLED`: where the secret is absent it prints the notice `The Cloudflare deploy secrets are absent; skipping the scheduled build, which exists only to deploy.` and sets `has_docs` to `false`, so the upstream repository's own daily run does not build a site it cannot deploy. Otherwise it requests `https://api.github.com/repos/jwdeveloper/TikTokLiveJava/contents/docs/package.json` with the run's own `GITHUB_TOKEN` and reads the HTTP status: `200` sets `has_docs` to `true`; `404` prints the notice `jwdeveloper/TikTokLiveJava has no docs/package.json yet; skipping the scheduled build.` and sets it to `false`; any other status, or a request that fails, prints an `::error::` annotation and fails the job, so a rate limit or an outage is a red run rather than a silently skipped deploy. The `build` job has `needs: upstream` and runs only when `has_docs` is `true`, so until the documentation is merged upstream a scheduled run on the fork is green with `upstream` succeeded, `build` skipped, the notice in the run's annotations, and nothing deployed.
+
+The `build` job has one of two checkout steps: `Check out upstream master` on a scheduled run, which checks out `jwdeveloper/TikTokLiveJava` at `master`, and `Check out the repository` on every other event, which checks out the repository and ref that triggered it. It then sets up Temurin JDK 17 with the Maven cache; `Build the library` runs `mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests package`; it sets up Node.js 24; `Install pnpm` runs `npm install --global pnpm@10.34.2`; `Install documentation dependencies` runs `pnpm --dir docs install --frozen-lockfile`; `Test the documentation scripts` runs `pnpm --dir docs test`; `Validate and build documentation` runs `pnpm --dir docs build`; `Verify SEO invariants` runs the SEO gate `pnpm --dir docs run seo`; and `Upload site for review` uploads `docs/dist` as the `documentation` artifact. The last step, `Deploy to Cloudflare Workers`, runs `cloudflare/wrangler-action@v4` (`workingDirectory: docs`, `packageManager: pnpm`, `command: deploy`) when the event is not a pull request, the ref is `refs/heads/master` or the event is the schedule, and `DEPLOY_ENABLED` is `true`; the `build` job derives that variable the same way as `upstream`. The deploy redeploys the existing Worker and needs both of these secrets:
+
+| Secret | Value |
+| --- | --- |
+| `CLOUDFLARE_API_TOKEN` | An account-owned token scoped to Editor on the `tiktoklivejava-docs` Worker only. It can upload to that Worker and nothing else: no Worker creation, no zone or route permission, which the config does not need. |
+| `CLOUDFLARE_ACCOUNT_ID` | The hosting account's id, shown by `wrangler whoami`. |
+
+Without `CLOUDFLARE_API_TOKEN` the deploy step is skipped and the workflow still validates the build on pull requests, pushes, and manual runs, so the upstream repository, forks, and pull requests are unaffected; only the scheduled run is skipped there, as described above. The gate checks only the token; `CLOUDFLARE_ACCOUNT_ID` is passed to wrangler and is required for the deploy to succeed, so set both. The maintainer sets them with `gh secret set CLOUDFLARE_API_TOKEN -R isaackogan/TikTokLiveJava` and `gh secret set CLOUDFLARE_ACCOUNT_ID -R isaackogan/TikTokLiveJava`. Because the scheduled run checks out the upstream repository, the workflow file must be on the fork's default branch for the schedule to exist, and a change to the documentation reaches the site either by being merged upstream and picked up by the next scheduled run, or by being pushed to the fork's `master`. Both deploy to the same Worker, so the two sources are not independent: a change pushed to the fork's `master` but not merged upstream is overwritten by the next scheduled run at 06:17 UTC, which deploys upstream `master`, and stays overwritten until it is merged upstream.
+
+## SEO gate
+
+`pnpm --dir docs run seo` runs `docs/scripts/verify-seo.mjs` over `docs/dist` after every build in CI and prints a `PASS` line per check; any failure fails the workflow. The checks are the invariants the sibling documentation sites carry: the homepage `<title>` contains `TikTok LIVE API`; every page, `404.html` included, has a `rel="canonical"` link to its own URL on `https://ttlj.docs.isaackogan.com/`; the homepage has `og:title`, `og:description`, `og:image`, and a meta description; `sitemap-index.xml` and `sitemap-0.xml` exist, the latter on the custom domain with more than one URL; `robots.txt` names the sitemap; no link to Euler Stream is nofollowed, every page has at least one, and the homepage has at least three distinct anchor texts; and every page carries the theme's sidebar marker, so a theme change that drops the navigation is caught. The gate's tests run with `pnpm --dir docs test`.
+
+The Open Graph and Twitter card tags come from `head` in `docs/astro.config.mjs`; `robots.txt` is in `docs/public/`; the sitemap is generated from `site`.
+
+## Verify a deployment
+
+```sh
+curl -I https://ttlj.docs.isaackogan.com/events/
+curl -I https://ttlj.docs.isaackogan.com/events
+curl -I https://ttlj.docs.isaackogan.com/missing/
+```
+
+Expect a 200, a 307 redirect to the trailing-slash form, and a 404 in that order. Then open the site, check an event page and the generated API and schema pages, and search for a gift event. The canonical link in the page head must use the custom domain. A scheduled run shows up as `gh run list --workflow=docs.yml -R isaackogan/TikTokLiveJava --event schedule --limit 1`, and `gh run view <run-id> -R isaackogan/TikTokLiveJava` lists its jobs: while upstream has no `docs/`, `upstream` succeeded and `build` skipped, with the notice `jwdeveloper/TikTokLiveJava has no docs/package.json yet; skipping the scheduled build.` in the annotations (in a repository without the deploy secrets the notice reads `The Cloudflare deploy secrets are absent; skipping the scheduled build, which exists only to deploy.` instead); once it does, both jobs succeed and the `Deploy to Cloudflare Workers` step ran. A scheduled run whose `upstream` job failed could not get an answer from the GitHub API; its error annotation carries the HTTP status, and the next day's run tries again.
+
+## Changing the hostname
+
+Attach the new hostname to the Worker the same way the current one was attached: under the Worker's **Settings → Domains & Routes** in the Cloudflare dashboard, or with a one-off `wrangler deploy` from a logged-in maintainer session using a `routes` entry in a local copy of the config; Cloudflare provisions the DNS record and the certificate then, and the repository config stays without a `routes` block. Then change the default `site` in `docs/astro.config.mjs`, update `BASE_URL` in `docs/scripts/verify-seo.mjs` and the `Sitemap` line in `docs/public/robots.txt`, update the hosted links in the repository README, `SITE` in `docs/tools/src/main/java/docs/ContentCheck.java` (the content check resolves the README's hosted links against it), and the hostname named in the `docs/wrangler.jsonc` comment, and deploy. Remove the old hostname in the same dashboard section.
diff --git a/docs/src/content/docs/index.md b/docs/src/content/docs/index.md
new file mode 100644
index 00000000..633d69cb
--- /dev/null
+++ b/docs/src/content/docs/index.md
@@ -0,0 +1,108 @@
+---
+title: Getting Started
+description: Install TikTokLiveJava and receive comments, gifts, and other events from a TikTok livestream with Java.
+head:
+  - tag: title
+    content: "TikTok LIVE API for Java: TikTokLiveJava Documentation"
+---
+
+TikTokLiveJava receives comments, gifts, likes, follows, shares, viewer counts, battles, and other events from a TikTok livestream. Create a client for a creator's username with `TikTokLive.newClient`, register a handler for each event you need, and connect.
+
+## Prerequisites
+
+- Java 16 or newer and a Maven or Gradle project. The library is published on JitPack, not Maven Central, so the build needs the JitPack repository; see [Install](/getting-started/install/).
+- No TikTok login for public livestreams. Signing uses a third-party provider, [Euler Stream](https://www.eulerstream.com/) by default. Age-restricted rooms and sending chat messages need a TikTok session (`sessionId` and `ttTargetIdc`); see [client settings](/configuration/client-settings/).
+
+This is an unofficial reverse-engineering project, not a supported vendor API. TikTok can change the Webcast protocol without notice, and a defined event may not be sent in every room or region. The [protobuf schema](/schema/) lists what the protocol defines; the [event catalog](/events/) lists what the client emits.
+
+## Install
+
+Maven:
+
+```xml
+<repositories>
+    <repository>
+        <id>jitpack.io</id>
+        <url>https://jitpack.io</url>
+    </repository>
+</repositories>
+
+<dependencies>
+    <dependency>
+        <groupId>com.github.jwdeveloper.TikTok-Live-Java</groupId>
+        <artifactId>Client</artifactId>
+        <version>1.13.1-Release</version>
+    </dependency>
+</dependencies>
+```
+
+Gradle:
+
+```groovy
+repositories {
+    mavenCentral()
+    maven { url 'https://jitpack.io' }
+}
+
+dependencies {
+    implementation 'com.github.jwdeveloper.TikTok-Live-Java:Client:1.13.1-Release'
+}
+```
+
+[Install](/getting-started/install/) covers the second JitPack group name, versions, and a check that the dependency resolves.
+
+## Listen to a livestream
+
+Save this as `ChatReader.java`, replace `isaackogz` with a creator who is live, and run it.
+
+```java
+import io.github.jwdeveloper.tiktok.client.TikTokLive;
+
+public class ChatReader {
+    public static void main(String[] args) {
+        TikTokLive.newClient("isaackogz")
+                .onConnected((client, event) ->
+                        System.out.println("Connected to " + client.getRoomInfo().getHostName()))
+                .onComment((client, event) ->
+                        System.out.println(event.getUser().getProfileName() + ": " + event.getText()))
+                .onGift((client, event) ->
+                        System.out.println(event.getUser().getProfileName() + " sent " + event.getGift().getName() + " x" + event.getCombo()))
+                .onDisconnected((client, event) ->
+                        System.out.println("Disconnected: " + event.getReason()))
+                .buildAndConnect();
+    }
+}
+```
+
+`TikTokLive.newClient` takes the creator's username, the part after `@` in `https://www.tiktok.com/@isaackogz/live`; a leading `@` is removed. Each `on<Event>` method of the builder registers a handler for one event class, called with the `LiveClient` and the event; `onEvent` receives every event, and `addListener` registers an object whose methods handle events ([listeners](/guides/listeners/)). Register handlers before connecting: the signing response already carries messages, and they are dispatched before the socket opens.
+
+`buildAndConnect()` builds the client, connects, and returns the `LiveClient`. It fetches the room data, requests a signed WebSocket URL, starts the socket, and returns; `TikTokConnectedEvent` fires from the socket thread once the socket is open. That thread keeps the process alive until the connection closes; call `client.disconnect()` to close it. When the creator is offline, `buildAndConnect()` throws `TikTokLiveOfflineHostException`. `TikTokLive.isLiveOnline("isaackogz")` checks first, and `buildAndConnectAsync()` connects on another thread. The [connection lifecycle](/getting-started/connection/) covers both, the retry settings, and each lifecycle event.
+
+## Read event payloads
+
+Each event is a class under `io.github.jwdeveloper.tiktok.api.data.events`, mapped from a Webcast protobuf message: `TikTokCommentEvent` from `WebcastChatMessage`, `TikTokGiftEvent` from `WebcastGiftMessage`. For a comment, the text is `event.getText()` and the sender is `event.getUser()`, a `User` whose `getName()` is the username and `getProfileName()` the display name. For a gift, `event.getGift().getName()` names the gift and `event.getCombo()` is the streak count. Nested objects such as `getUser()` are mapped from the message and are not `null`; a user TikTok did not send has id `0` and an empty name. Events with a message header also carry `getRoomId()`, `getMessageId()`, and `getTimeStamp()`.
+
+The [event catalog](/events/) lists each event with its type and fields, the [API reference](/api/) documents every public class in this checkout, and the [schema reference](/schema/) describes the protobuf messages the events are mapped from.
+
+## Signing
+
+The client requests its WebSocket URL from Euler Stream, a hosted [TikTok LIVE signing API](https://www.eulerstream.com/), at `tiktok.eulerstream.com`. A TikTok login is unnecessary for public rooms; provider rate limits still apply, and an API key raises them. Set `apiKey` in `configure`, and the client sends it as the `x-api-key` header. A rate-limited or failed signing request throws `TikTokSignServerException` from `connect()`. For production workloads that need an uptime guarantee, the managed [TikTok LIVE WebSocket API](https://www.eulerstream.com/websockets) handles signing, scaling, and protocol changes for you: set `useEulerstreamWebsocket` to `true` together with the API key, and the client receives its events from `wss://ws.eulerstream.com` instead of connecting to TikTok itself. See [signing](/configuration/signing/) and [troubleshooting](/troubleshooting/).
+
+```java
+TikTokLive.newClient("isaackogz")
+        .configure(settings -> settings.setApiKey("your-euler-stream-api-key"))
+        .onComment((client, event) -> System.out.println(event.getText()))
+        .buildAndConnect();
+```
+
+## Next steps
+
+- [Connection lifecycle](/getting-started/connection/): `build`, `buildAndConnect`, and `buildAndConnectAsync`, the connect sequence, lifecycle events, disconnects, retries, and room information.
+- [Event catalog](/events/): find an event by its name or what it does.
+- [Gifts and combos](/guides/gifts/): `TikTokGiftEvent`, `TikTokGiftComboEvent`, and gift streaks.
+- [Client settings](/configuration/client-settings/): every `LiveClientSettings` field and its default.
+- [API reference](/api/): generated from the Java sources in this checkout.
+
+These docs describe the library on `master`. The guides and the generated API reference come from the same checkout, so compare your dependency version with the version on the [API reference](/api/) index when something differs from your installed release.
+
+For the Node.js implementation, see [TikTok LIVE Connector](https://ttlc.docs.isaackogan.com/); for the Python implementation, see [TikTokLive](https://ttl.docs.isaackogan.com/). For the managed Euler Stream service, see [Euler Stream's documentation](https://www.eulerstream.com/docs). Their names and payload shapes differ from this Java library.
diff --git a/docs/src/content/docs/troubleshooting.md b/docs/src/content/docs/troubleshooting.md
new file mode 100644
index 00000000..35c3f0fd
--- /dev/null
+++ b/docs/src/content/docs/troubleshooting.md
@@ -0,0 +1,115 @@
+---
+title: Troubleshooting
+description: Diagnose connection failures, signing errors, sockets that close, missing events, and the known limitations of this release, with every exception the library defines and when.
+---
+
+Start with the smallest [Getting Started](/) example, the exact dependency version from your build file (`1.13.1-Release` for these pages), the call that failed, and the original exception with its cause chain. A connection has four stages that fail differently: the HTTP requests to TikTok that resolve the room and check that the creator is live, the signing request to [Euler Stream](https://www.eulerstream.com/), the WebSocket handshake with TikTok, and the decoding and mapping of messages once connected. Succeeding at one does not establish that the next works, and a proxy or a session can affect each stage separately.
+
+`LiveClient` has three connection methods, `connect`, `connectAsync` (with or without a consumer), and `disconnect` (with or without a `LiveClientStopType`); two injection methods, `publishEvent` and `publishMessage`; `sendChat`; and four getters, `getRoomInfo`, `getGiftManager`, `getListenersManager`, and `getLogger`. Name the one involved in a report. Every exception the library defines is unchecked and extends `TikTokLiveException`, which extends `RuntimeException`. When a stage of `connect` throws one, the client publishes `TikTokErrorEvent` with it and `TikTokDisconnectedEvent` with the reason `Exception: <message>`, then rethrows it: `buildAndConnect()` and `connect()` throw to the caller; `buildAndConnectAsync()` and `connectAsync()` complete their future exceptionally; `connectAsync(Consumer)` discards the failed future, so its consumer is not called and the two events are the only report. Exceptions raised after the connection is up, on the socket thread or in a handler, reach you only through `onError`; see [read every exception](/guides/debugging/#read-every-exception).
+
+## Exceptions
+
+All eleven classes are in `io.github.jwdeveloper.tiktok.api.exceptions`.
+
+| Exception | Thrown when |
+| --- | --- |
+| `TikTokLiveException` | The base class, and the one thrown directly for `Already connected`, `HostName can not be null`, `Minimum allowed ping interval is 250 milliseconds`, `Livestream for <host> is 18+ or age restricted!` with `throwOnAgeRestriction`, `Failed to connect to the websocket` when the proxy list is exhausted, `Failed to stop the websocket` when a `CLOSE_BLOCKING` wait is interrupted, `Listener ... has already been registered`, and a `Picture` whose image download fails. `TikTokErrorEvent.of(message)` builds one for tests. |
+| `TikTokLiveRequestException` | An HTTP request to TikTok answered with a status other than 200, failed in transport, or returned a body the mapper cannot read: `params_error` from the user request, or a room-information body that is not a JSON object or has no `data` section. Also `No more proxies available!` when the proxy list empties inside one attempt on the `HTTP` or `DIRECT` path; the `SOCKS` path prints that exception and returns a failed result instead. |
+| `TikTokSignServerException` | A subclass of the above for the signing request: a status other than 200, with the note described under [signing](/configuration/signing/#rate-limits-and-provider-errors); a 200 without the `x-set-tt-cookie` header; or a body that is not a `ProtoMessageFetchResult`. |
+| `TikTokProxyRequestException` | Raised inside `HttpProxyClient` when a request through a proxy endpoint fails with a connect timeout, a `ConnectException`, or another `IOException`; with `autoDiscard` left `true`, its default, the endpoint is removed from the list first for a connect failure, or for any `IOException` on the `SOCKS` path; an `HTTP` endpoint failing with another `IOException` stays in the list. It does not reach your code through the client: the `fetch` methods and `sendChat` catch it and send again while the list is not empty, then send once more, and that last request gets the plain `HttpClient` because the list is empty by then. What you see instead is that direct request's outcome, a result or a `TikTokLiveRequestException` (`TikTokSignServerException` for signing); with `autoDiscard` set to `false`, or with endpoints that are never removed, the loop retries indefinitely while every endpoint keeps failing. It reaches a caller only from a request made directly with `HttpClientBuilder` over settings with proxies enabled, see the [HTTP client page](/advanced/http-client/#how-a-request-is-built). The WebSocket client has one more `throw` of it, for a SOCKS SSL context that cannot be created, which the source marks as unreachable. |
+| `TikTokLiveOfflineHostException` | TikTok reported the creator offline, from the user request (`User is offline`) or from the room information (`not found, is the Host offline?`). `getUserData()` holds the user response; `getLiveData()` holds the room response or `null` in the first case. The only failure `retryOnConnectionFailure` retries. |
+| `TikTokLiveUnknownHostException` | TikTok reported the creator or the room not found (`User not found`, `could not be found`). Same two getters. Also what a block or captcha page produces, see below. |
+| `TikTokLivePreConnectionException` | A `TikTokPreConnectionEvent` handler called `setCancelConnection(true, reason)`; the message is the reason and `getPreconnectEvent()` is the event. |
+| `TikTokLiveMessageException` | Any exception thrown while one message of a batch was mapped or handled. Never thrown to you: it is the exception of a `TikTokErrorEvent`, with `messageMethod()`, `messageToBase64()`, `webcastResponseToBase64()`, and the original exception as `getCause()`. |
+| `TikTokMessageMappingException` | The mapper helper could not deserialise: the message class has no `parseFrom` method or the bytes do not parse (both read `can't find parsing method`), or a message name has no class in the webcast package. The cause of a `TikTokLiveMessageException` on the socket, and thrown directly by `publishMessage`. |
+| `TikTokProtocolBufferException` | A WebSocket frame was not a `WebcastPushFrame`, or its payload not a `ProtoMessageFetchResult`; `getBytes()` holds the bytes. Published as `TikTokErrorEvent` from the socket thread. |
+| `TikTokEventListenerMethodException` | Thrown by `addListener` when a `@TikTokEventObserver` method has no parameter that extends `TikTokEvent`, and the exception of a `TikTokErrorEvent` when a listener method throws, wrapping the reflective call's exception; see [when a method throws](/guides/listeners/#when-a-method-throws). |
+
+```java
+TikTokLive.newClient("isaackogz")
+        .onError((client, event) -> {
+            var exception = event.getException();
+            if (exception instanceof TikTokLiveMessageException e) {
+                System.err.println("Message " + e.messageMethod() + " failed: " + e.getCause());
+            } else if (exception instanceof TikTokProtocolBufferException e) {
+                System.err.println("Unreadable frame of " + e.getBytes().length + " bytes: " + e.getCause());
+            } else if (exception instanceof TikTokEventListenerMethodException e) {
+                System.err.println("A listener method failed: " + e.getCause());
+            } else {
+                exception.printStackTrace();
+            }
+        })
+        .buildAndConnect();
+```
+
+## connect() fails
+
+```java
+try {
+    TikTokLive.newClient("isaackogz").buildAndConnect();
+} catch (TikTokLiveOfflineHostException e) {
+    System.err.println("Not live: " + e.getMessage());
+} catch (TikTokLiveUnknownHostException e) {
+    System.err.println("No such creator: " + e.getMessage());
+} catch (TikTokSignServerException e) {
+    System.err.println("Signing failed: " + e.getMessage());
+} catch (TikTokLiveException e) {
+    System.err.println("Connect failed: " + e.getMessage());
+}
+```
+
+**`User is offline` or `not found, is the Host offline?`** (`TikTokLiveOfflineHostException`): the creator is not live. Poll with `TikTokLive.isLiveOnline(hostName)`, which asks TikTok directly and spends no signing request, and connect when it returns `true`; or set `retryOnConnectionFailure` with a `retryConnectionTimeout` of more than the default one second. See [retry when the creator is offline](/getting-started/connection/#retry-when-the-creator-is-offline).
+
+**`User not found`** (`TikTokLiveUnknownHostException`): the username does not exist, or TikTok did not answer with the JSON the client expects. `hostName` is the username after the `@` in the profile URL, not the display name; a leading `@` is removed. When the name is right, turn on the log: the client logs `Malformed Json` at `WARNING` with the body it received, and returns the same `NotFound` status for a captcha or block page as for a missing user. Try again later, change the address the requests come from, or go through a [proxy](/configuration/proxies-and-host/).
+
+**`is 18+ or age restricted!`** (`TikTokLiveException`): the room is age-restricted and `throwOnAgeRestriction` is set. Without the setting the client connects; whether it receives the room's messages depends on the session, see [age-restricted rooms](/configuration/authentication/#age-restricted-rooms).
+
+**`Unable to get websocket connection credentials`** (`TikTokSignServerException`): the signing request failed. The message carries the status: `429` is the provider's rate limit, with the wait when the provider sent a `ratelimit-reset` header; `420`, `500` to `504`, and other statuses are described on the [signing page](/configuration/signing/#rate-limits-and-provider-errors). Each connection attempt spends one signing request, so poll with `isLiveOnline` rather than by connecting, and set an `apiKey` for higher limits. The client does not retry a signing failure without proxies.
+
+**`Already connected`** (`TikTokLiveException`): `connect` was called while the state is `CONNECTING` or `CONNECTED`. The failure branch still runs: the state flips to `DISCONNECTED` and `TikTokErrorEvent` and `TikTokDisconnectedEvent` are published while the existing socket stays open, and the next `connect` replaces that socket. Use one connection per client, or `disconnect` first; see [build, connect, or both](/getting-started/connection/#build-connect-or-both).
+
+**`Unhandled exception report this bug to github`** in the log: `connect` hit an exception that is not a `TikTokLiveException`. The client logs that line, calls `disconnect`, prints the stack trace to stderr, and returns normally with the state `DISCONNECTED`, without publishing `TikTokDisconnectedEvent` unless a socket was open. In this release the known cause is `connect` on an offline client, which fails with `NullPointerException` at `TikTokLiveClient.java:136`; see [known limitations](#known-limitations-in-this-release). Anything else is worth a report.
+
+**Nothing happens after `buildAndConnectAsync()`**: the connection runs on the common pool, whose threads are daemon threads, and the socket's read thread inherits that flag, so a `main` that returns ends the program whether or not the socket has opened. Keep the main thread alive for as long as the connection should live, as the repository's `ConnectionExample` does with `System.in.read()`.
+
+## The socket closes
+
+`TikTokDisconnectedEvent.getCode()` says what happened. `-1` (`isUnknownCloseCode()`) means the connection never opened: either a stage of `connect` threw, with the reason `Exception: <message>`, or the WebSocket handshake failed on the socket thread, in which case a `TikTokErrorEvent` with the handshake exception precedes it and `connect` returned normally. `1000` is a normal close from either side, including your own `disconnect`; `1006` means the connection dropped without a close frame; `1002` means TikTok answered the handshake with an HTTP error rather than the upgrade. See the [WebSocket page](/advanced/websocket/#how-a-connection-ends).
+
+The client does not reconnect after a close. Handle `onDisconnected`, wait, check `isLiveOnline`, and call `connect` again; the [connection page](/getting-started/connection/#retry-when-the-creator-is-offline) has the loop. A tight loop runs into the signing provider's rate limit.
+
+A handshake that hangs rather than fails is consistent with the connect timeout the socket receives: `timeout.toMillisPart()`, which is `0`, no timeout, for whole-second values such as the default three seconds. Set `Duration.ofMillis(2500)` or similar to give the handshake a timeout; see [the timeout and sub-second parts](/configuration/http-settings/#the-timeout-and-sub-second-parts). With proxies enabled, the socket also goes through the list unless `allowWebsocket` is `false`; a proxy that passes HTTP but not WebSocket traffic shows up here, see [the WebSocket through proxies](/configuration/proxies-and-host/#the-websocket).
+
+`TikTokLiveEndedEvent` does not close the socket: when TikTok reports the stream ended or suspended, the client publishes the event and keeps the connection until you call `disconnect` or TikTok closes it. Call `disconnect` from `onLiveEnded` when the connection should end with the stream.
+
+## Connected, but no expected events
+
+1. Register handlers and listeners before `connect`. The signing response already carries messages, and they are dispatched before the socket opens; a handler added afterwards misses them.
+2. Dispatch is by exact class. A handler receives the events of its own class and, for `onEvent(TikTokEvent.class, ...)`, every event; it does not receive subclasses. `onGift` never sees `TikTokGiftComboEvent`, and `onEvent(TikTokLinkEvent.class, ...)` sees only the generic link event, not `TikTokLinkInviteEvent` and the other link subclasses. Subscribe to each class you need. The order in which several handlers for one class run is unspecified.
+3. Sixteen event classes are never produced by the default client because their mappings are not registered; the [unmapped events](/events/#unmapped-events) list names them and shows the custom mapping that enables one. `TikTokHttpResponseEvent` has a handler but no publisher in this release.
+4. Listen for `TikTokWebsocketUnhandledMessageEvent` to see every message the client has no mapping for, with its name and payload, and for `TikTokWebsocketResponseEvent` to see every batch. The [debugging guide](/guides/debugging/) shows both.
+5. The setting's Javadoc and a comment in the HTTP client say that without a `sessionId` TikTok does not send every chat message; the client cannot verify that, but a session is what the maintainers recommend for complete comments, see [authentication](/configuration/authentication/).
+6. With `useEulerstreamWebsocket`, `getRoomInfo()` is empty until the provider's `roomInfo` message arrives, and no `TikTokPreConnectionEvent` is published; see [signing](/configuration/signing/#euler-stream-websocket).
+7. Confirm that the room produces the feature. A message defined in the schema is not sent in every room or region; see [protocol](/advanced/protocol/#schema-definitions-and-verified-behaviour).
+
+## Known limitations in this release
+
+These describe the checked-in `1.13.1-Release` code; recheck them against a newer release.
+
+- `connect` on a client with `offline` set fails with `NullPointerException` at `TikTokLiveClient.java:136`, because the offline HTTP client returns a user response with no room info; it is logged, not thrown. With `useEulerstreamWebsocket` also set, `connect` makes no HTTP request and succeeds against the stand-in socket. Use `build()` with `publishEvent` and `publishMessage` instead, see [offline testing](/guides/offline-testing/).
+- With proxies of type `HTTP` or `DIRECT`, a response other than 200 moves to the next endpoint without removing the current one, and the loop runs while the list is not empty, so a provider answering 429 through working proxies is retried in rotation indefinitely. See [how a request uses the list](/configuration/proxies-and-host/#how-a-request-uses-the-list).
+- The `roomId` setting on `LiveClientSettings` is never read; the room id always comes from the user request.
+- The WebSocket handshake and the SOCKS proxy path receive `timeout.toMillisPart()` as their connect timeout, so a whole-second `timeout` gives them none.
+- There is no name-based fallback mapping: `TikTokGenericEventMapper.mapToEvent` exists but nothing calls it, so the sixteen unmapped events stay unmapped until you register them.
+- Event dispatch is by exact class; subclasses do not reach a superclass handler.
+- `TikTokHttpResponseEvent` is never published by the HTTP client.
+- On the Euler Stream path the `roomInfo` message fills only the room id, title, start time, viewer count, and host; the total viewer count and the age restriction stay unset, and the message's `totalViewers` is written into the viewer count.
+- `stop` on the Euler Stream socket closes the socket only when it is already open; one still in its handshake is dropped without being closed.
+- The recorder's `setOutputFile` needs a path with a directory component; a bare filename such as `new File("clip.flv")` fails the download task with a `NullPointerException` that is printed and swallowed, and no ended event is published. See the [recorder settings](/guides/recorder/#settings).
+- A second `connect` while connected flips the state to `DISCONNECTED` and publishes error and disconnected events while the socket stays open.
+- The status notes in request failures name the sign server even for TikTok's own API: a 429 from `www.tiktok.com` reads `Sign server rate limit reached`.
+- The poll mapping and `TikTokShopEvent` carry a `not working` note in the source; see [room and display](/events/room-and-display/) and [games and commerce](/events/games-and-commerce/).
+
+## Report a reproducible issue
+
+File reports on the [TikTokLiveJava GitHub issues](https://github.com/jwdeveloper/TikTokLiveJava/issues) page. Include the library version, the Java version and operating system, the settings with secrets removed, a minimal example, the exact exception with its cause chain, and which stage failed: user data, room information, signing, WebSocket handshake, or message handling. For an event that does not arrive or a message that fails to map, add the message `method` and a Base64 payload, from `TikTokWebsocketUnhandledMessageEvent` or from `TikTokLiveMessageException.messageToBase64()`, reviewed for personal data; see [report a new message type](/guides/debugging/#report-a-new-message-type). Never include session cookies, API keys, or signed WebSocket URLs.
diff --git a/docs/superpowers/plans/2026-10-20-starlight-docs.md b/docs/superpowers/plans/2026-10-20-starlight-docs.md
new file mode 100644
index 00000000..aa909b5c
--- /dev/null
+++ b/docs/superpowers/plans/2026-10-20-starlight-docs.md
@@ -0,0 +1,303 @@
+# Starlight Documentation Site Implementation Plan (TikTokLiveJava)
+
+**Goal:** Give the Java library a Starlight documentation site with generated API and protobuf schema references, content and SEO gates, hosted on Cloudflare Workers at `https://ttlj.docs.isaackogan.com/`, bootstrapped by the fork's own GitHub Actions run and offered upstream as a pull request.
+
+**Architecture:** `docs/` is a self-contained pnpm project (Astro + Starlight + lucode) whose `build` script first builds and runs a standalone Maven tool in `docs/tools/` (`check`, then `generate`) and then `astro build`. The tool parses Java sources with JavaParser and the three `.proto` files with a small proto3 parser, writes Starlight Markdown, and compiles every Java example fence against the built library jars. `docs.yml` validates on pull requests, deploys on pushes to `master` when the Cloudflare secret exists, and on a daily schedule deploys from a checkout of upstream `master`. The Python sibling (the `docs/` directory of the TikTokLive repository) is the reference implementation for everything web-side; copy its structure and prose register.
+
+**Tech Stack:** Java 17 in CI (JDK 21 locally; library target 16), Maven, JavaParser 3.26.x, JUnit 5, `javax.tools.JavaCompiler`; Node 24, pnpm 10.34.2, astro 7.4.1, @astrojs/starlight 0.42.6, lucode-starlight 1.0.0, starlight-links-validator 0.27.0, wrangler 4.151.2; Cloudflare Workers static assets; GitHub Actions.
+
+**Spec:** `docs/superpowers/specs/2026-10-20-starlight-docs-design.md`
+
+## Global Constraints
+
+- Public hostname is exactly `ttlj.docs.isaackogan.com`; Worker name `tiktoklivejava-docs` (internal only); no other public name contains "tiktok".
+- Exact pins, no ranges: `astro 7.4.1`, `@astrojs/starlight 0.42.6`, `lucode-starlight 1.0.0`, `starlight-links-validator 0.27.0`, `wrangler 4.151.2`, `@astrojs/markdown-remark 7.3.3`, `unist-util-visit 5.0.0`, `pnpm@10.34.2`, Node `>=22.22.0`; `javaparser-core 3.26.4`, `junit-jupiter 5.11.4`.
+- Docs tooling lives only under `docs/`; nothing is added to the root `pom.xml` modules, `API/pom.xml`, `Client/pom.xml`, `jitpack.yml`, or `maven-publish.yml`.
+- Generated content (`docs/src/content/docs/api/`, `docs/src/content/docs/schema/`, `docs/dist/`, `docs/node_modules/`, `docs/.astro/`, `docs/tools/target/`) is never committed.
+- No `discord.com` / `discord.gg` link in any authored Markdown page; the only Discord link is the header social button `https://discord.gg/e2XwPNTBBr`.
+- Every `eulerstream.com` link is dofollow; every built page carries at least one (footer); the homepage carries at least three with distinct anchor texts.
+- Java examples use ```` ```java ```` fences; a fence with a top-level `class`/`interface`/`record`/`enum` compiles as-is, any other fence is a fragment the checker wraps; shell commands use ```` ```sh ````; build files use ```` ```xml ```` or ```` ```groovy ````.
+- Internal links are site-relative with trailing slashes. Prose register matches the sibling sites: short declarative sentences, no marketing.
+- Library facts come from the sources at `1.13.1-Release`: entry `TikTokLive.newClient(String hostName)` → `LiveClientBuilder` (handlers on `EventsBuilder<T>`, 73 `on*` methods); `LiveClientSettings` (16 fields), `HttpClientSettings`; 78 event classes under `API/src/main/java/io/github/jwdeveloper/tiktok/api/data/events/`, each annotated `@EventMeta(eventType = EventType.Control|Message|Debug)`; 11 classes under `api/exceptions/`; listener classes extend `TikTokEventListenerBase` with `@TikTokEventObserver` methods; extensions `TikTokLiveRecorder` (`extension-recorder`) and `TikTokLiveCollector`/`DataCollector` (`extension-collector`); proto Java package `io.github.jwdeveloper.tiktok.api.messages.webcast` from `API/src/main/proto/{webcast,data,enums}.proto` (proto3, `package TikTok`).
+- JitPack coordinates: group `com.github.jwdeveloper.TikTok-Live-Java`, artifact `Client`, version `1.13.1-Release`; Java 16 or newer.
+- Work on branch `docs/starlight-site` in the local checkout of the fork (origin = the fork `isaackogan/TikTokLiveJava`; add `upstream = https://github.com/jwdeveloper/TikTokLiveJava.git`). Never push to upstream; never force-push.
+- Local commands: `npx -y pnpm@10.34.2` for pnpm; `mvn` 3.9.12 and JDK 21 are on PATH; build the library once with `mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests package` so `*/target/classes` exist for the example compiler.
+
+## Review Focus
+
+1. A new event class added upstream with no docs entry: the build must fail naming the class. Pinned in Task 3 (`checkEventsReportsMissingEvent`).
+2. A fragment example calling a method that does not exist (for example `event.getComent()`): the build must fail with the page and example number. Pinned in Task 3 (`fragmentWithUnknownMethodFails`).
+3. A nested proto message (for example a message declared inside another) must get a schema page and the links from event pages must resolve. Pinned in Task 2 (`nestedMessageGetsPage`) and Task 6 (links validator run).
+4. A README handler name with no matching event class (a typo in the README list): the `readme` section must fail. Pinned in Task 3 (`readmeHandlerWithoutClassFails`).
+5. The scheduled deploy must build upstream's sources, not the fork's, while using the fork's workflow: pinned in Task 11 by asserting the schedule job's checkout uses `repository: jwdeveloper/TikTokLiveJava` and `ref: master` and the push job's checkout does not.
+
+---
+
+### Task 1: Scaffold the Starlight project
+
+**Files:**
+- Create: `docs/package.json`, `docs/pnpm-workspace.yaml`, `docs/tsconfig.json`, `docs/astro.config.mjs`, `docs/src/content.config.ts`, `docs/src/content/docs/index.md`, `docs/src/content/docs/404.md`, placeholder pages `docs/src/content/docs/getting-started/install.md`, `getting-started/connection.md`, `events/index.md`, `troubleshooting.md`, `contributing.md`, `hosting.md`, `docs/public/favicon.png`, `docs/public/robots.txt`
+- Modify: `.gitignore`
+
+**Interfaces:**
+- Produces: `pnpm --dir docs build` = `pnpm run tools:build && pnpm run check && pnpm run generate && astro build`, with `tools:build` = `mvn -q -f tools/pom.xml -DskipTests package`, `check` = `java -jar tools/target/docs-tools.jar check ..`, `generate` = `java -jar tools/target/docs-tools.jar generate ..` (the argument is the repository root relative to `docs/`). Until Tasks 2–3 exist, verify with `pnpm --dir docs exec astro build`. Sidebar fixed here:
+
+```js
+sidebar: [
+  { label: 'Start here', items: [
+    { label: 'Getting Started', slug: '' },
+    { label: 'Install', slug: 'getting-started/install' },
+    { label: 'Connection lifecycle', slug: 'getting-started/connection' },
+  ] },
+  { label: 'Configuration', items: [{ autogenerate: { directory: 'configuration' } }] },
+  { label: 'Guides', items: [{ autogenerate: { directory: 'guides' } }] },
+  { label: 'Events', items: [{ autogenerate: { directory: 'events' } }], collapsed: true },
+  { label: 'Advanced', items: [{ autogenerate: { directory: 'advanced' } }], collapsed: true },
+  { label: 'Troubleshooting', slug: 'troubleshooting' },
+  { label: 'Contributing to the docs', slug: 'contributing' },
+  { label: 'Hosting', slug: 'hosting' },
+  { label: 'API reference', items: [{ autogenerate: { directory: 'api' } }], collapsed: true },
+  { label: 'Protobuf schema', items: [{ autogenerate: { directory: 'schema' } }], collapsed: true },
+],
+```
+
+- [ ] **Step 1: Copy the Python sibling's `docs/` web files and adapt**
+
+From the Python TikTokLive repository's `docs/` copy `astro.config.mjs`, `tsconfig.json`, `pnpm-workspace.yaml`, `src/content.config.ts`, `src/content/docs/404.md`, `public/favicon.png`. In `astro.config.mjs` set `site` default `https://ttlj.docs.isaackogan.com`, `title: 'TikTokLiveJava'`, `description: 'Unofficial TikTok LIVE API for Java. Guides, events, and generated API reference.'`, social GitHub `https://github.com/jwdeveloper/TikTokLiveJava` and Discord `https://discord.gg/e2XwPNTBBr`, `editLink.baseUrl` `https://github.com/jwdeveloper/TikTokLiveJava/edit/master/docs/`, lucode `navLinks` Docs/Events/API, `footerText` `'Unofficial project, not affiliated with TikTok or ByteDance Ltd. Signing by [Euler Stream](https://www.eulerstream.com/). Source on [GitHub](https://github.com/jwdeveloper/TikTokLiveJava).'`, `head` entries `og:image` `https://raw.githubusercontent.com/jwdeveloper/TikTokLiveJava/master/tools-readme/src/main/resources/logo.svg` with `og:image:alt` `TikTokLiveJava, TikTok LIVE API for Java` and `twitter:card` `summary_large_image`, and the sidebar above. `package.json`: name `tiktoklivejava-docs`, scripts `dev`, `tools:build`, `check`, `generate`, `build`, `preview`, `deploy:cloudflare` (`wrangler deploy`), devDependencies pinned per Global Constraints. `public/robots.txt`: `User-agent: *`, `Allow: /`, blank line, `Sitemap: https://ttlj.docs.isaackogan.com/sitemap-index.xml`.
+
+- [ ] **Step 2: Placeholder pages and `.gitignore`**
+
+`index.md` title `Getting Started` with one paragraph; the other placeholders are frontmatter plus the sentence "This page is written in a later task of the documentation plan." Append to `.gitignore`: `docs/node_modules/`, `docs/.astro/`, `docs/dist/`, `docs/src/content/docs/api/`, `docs/src/content/docs/schema/`, `docs/tools/target/`. Create gitignored placeholder `api/index.md` and `schema/index.md` (title only) so the autogenerated groups exist. Add the `upstream` git remote.
+
+- [ ] **Step 3: Install and build**
+
+Run: `npx -y pnpm@10.34.2 --dir docs install && npx -y pnpm@10.34.2 --dir docs exec astro build 2>&1 | tail -3`
+Expected: `All internal links are valid.`; `docs/dist/index.html` has `<title>Getting Started | TikTokLiveJava</title>`; `grep -c 'discord.gg/e2XwPNTBBr' docs/dist/index.html` is 1; `docs/dist/robots.txt` present.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add -A docs .gitignore
+git commit -m "docs: scaffold the Starlight documentation site"
+```
+
+### Task 2: Docs tool, `generate` command
+
+**Files:**
+- Create: `docs/tools/pom.xml`, `docs/tools/src/main/java/docs/Main.java`, `docs/tools/src/main/java/docs/JavaSources.java`, `docs/tools/src/main/java/docs/ApiPages.java`, `docs/tools/src/main/java/docs/ProtoParser.java`, `docs/tools/src/main/java/docs/SchemaPages.java`, `docs/tools/src/main/java/docs/Markdown.java`
+- Test: `docs/tools/src/test/java/docs/ApiPagesTest.java`, `docs/tools/src/test/java/docs/ProtoParserTest.java`, `docs/tools/src/test/java/docs/SchemaPagesTest.java`
+
+**Interfaces:**
+- `docs/tools/pom.xml`: standalone project (`groupId docs`, `artifactId docs-tools`, Java release 17), dependencies `com.github.javaparser:javaparser-core:3.26.4`, `org.junit.jupiter:junit-jupiter:5.11.4` (test), `maven-shade-plugin` producing `target/docs-tools.jar` with `Main-Class: docs.Main`.
+- `docs.Main.main(String[] args)`: `args[0]` is `generate` or `check`, `args[1]` is the repository root; exit code 0/1.
+- `JavaSources.load(Path repoRoot) -> List<CompilationUnit>` parsing every `.java` under `API/src/main/java` and `Client/src/main/java` (JavaParser, language level Java 17, Lombok annotations kept as annotations).
+- `ApiPages.slug(String fqcn) -> String`: `io.github.jwdeveloper.tiktok.api.live.LiveClient` → `io/github/jwdeveloper/tiktok/api/live/liveclient`; package index pages at `<package path>/index.md`, type pages at `<package path>/<lowercase simple name>.md`; nested types get `<outer>-<inner>` names.
+- `ApiPages.render(List<CompilationUnit> units, String version, String sourceBaseUrl, Path outDir) -> List<Path>`: one page per public top-level or nested type: frontmatter `title` (simple name), `description` (first Javadoc sentence or `"<kind> <fqcn>"`), `sidebar.label`; sections Signature (modifiers, kind, name, type parameters, extends, implements), Javadoc body, Fields (name, type, Javadoc, Lombok `@Getter`/`@Setter`/`@Builder` noted), Constructors, Methods (signature, parameter and return types, Javadoc `@param`/`@return`), Source (`<sourceBaseUrl>/<module>/src/main/java/<path>#L<line>`). Deterministic ordering (packages and members sorted by name). Index page title `TikTokLiveJava <version>`, version read from the root `pom.xml` `<version>`.
+- `ProtoParser.parse(Path protoFile) -> ProtoFile` with records `ProtoFile(String pkg, String javaPackage, List<ProtoMessage> messages, List<ProtoEnum> enums)`, `ProtoMessage(String name, String parent, List<ProtoField> fields, List<ProtoMessage> nested, List<ProtoEnum> nestedEnums)`, `ProtoField(String label, String type, String name, int number)`, `ProtoEnum(String name, List<ProtoEnumValue> values)`. Handles proto3 `message`, `enum`, `repeated`, `optional`, `map<k,v>`, `oneof`, nested types, comments; ignores `option` lines and `reserved`.
+- `SchemaPages.render(List<ProtoFile> files, String version, Path outDir) -> List<Path>`: one page per message and enum (nested ones named `<Outer>.<Inner>` with slug `<outer>-<inner>`), slug under `schema/<file stem>/<slug>.md` (`webcast/webcastchatmessage.md`), fields table (name, type with link when it is another message/enum, number, label), index page titled `TikTok Webcast schema (<version>)`.
+- Consumed by Task 6 (event pages link `/schema/<file stem>/<message slug>/`) and Task 10 (nothing).
+
+- [ ] **Step 1: Write failing tests**
+
+```java
+class ApiPagesTest {
+  @Test void slugLowercasesAndNestsPackages() {
+    assertEquals("io/github/jwdeveloper/tiktok/api/live/liveclient", ApiPages.slug("io.github.jwdeveloper.tiktok.api.live.LiveClient"));
+  }
+  @Test void liveClientSettingsPageListsFields(@TempDir Path out) {
+    var units = JavaSources.load(REPO);
+    var paths = ApiPages.render(units, "1.13.1-Release", "https://github.com/jwdeveloper/TikTokLiveJava/blob/master", out);
+    var page = out.resolve("io/github/jwdeveloper/tiktok/api/data/settings/liveclientsettings.md");
+    assertTrue(Files.exists(page));
+    var md = Files.readString(page);
+    assertTrue(md.startsWith("---\ntitle: LiveClientSettings\n"));
+    for (var f : List.of("offline", "fetchGifts", "retryOnConnectionFailure", "pingInterval", "apiKey")) assertTrue(md.contains("`" + f + "`"), f);
+    assertTrue(paths.size() > 150);
+  }
+  @Test void typeWithoutJavadocStillRenders(@TempDir Path out) { /* EventType enum has no Javadoc: page exists, description is "enum io.github...EventType" */ }
+  @Test void outputIsDeterministic(@TempDir Path a, @TempDir Path b) { /* render twice, compare file lists and contents */ }
+}
+class ProtoParserTest {
+  @Test void parsesMessagesEnumsAndNested() {
+    var f = ProtoParser.parse(REPO.resolve("API/src/main/proto/webcast.proto"));
+    assertEquals("io.github.jwdeveloper.tiktok.api.messages.webcast", f.javaPackage());
+    assertTrue(f.messages().stream().anyMatch(m -> m.name().equals("WebcastChatMessage")));
+    assertTrue(f.messages().stream().anyMatch(m -> !m.nested().isEmpty()));
+  }
+  @Test void parsesRepeatedMapAndOneof() { /* fixture string with repeated, map<string,int32>, oneof; assert labels/types */ }
+}
+class SchemaPagesTest {
+  @Test void nestedMessageGetsPage(@TempDir Path out) {
+    var files = List.of(ProtoParser.parse(REPO.resolve("API/src/main/proto/webcast.proto")), ProtoParser.parse(REPO.resolve("API/src/main/proto/data.proto")), ProtoParser.parse(REPO.resolve("API/src/main/proto/enums.proto")));
+    var paths = SchemaPages.render(files, "1.13.1-Release", out);
+    assertTrue(Files.exists(out.resolve("webcast/webcastchatmessage.md")));
+    assertTrue(paths.stream().anyMatch(p -> p.getFileName().toString().contains("-")), "a nested type page named outer-inner");
+    assertTrue(paths.size() > 300);
+  }
+}
+```
+
+`REPO` is `Path.of(System.getProperty("repo.root"))`, set in the surefire configuration to `${project.basedir}/../..`.
+
+- [ ] **Step 2: Run tests to verify they fail**
+
+Run: `cd docs/tools && mvn -q test 2>&1 | tail -5`
+Expected: compilation errors for the missing classes.
+
+- [ ] **Step 3: Implement the classes per Interfaces** (JavaParser `StaticJavaParser` with `ParserConfiguration.LanguageLevel.JAVA_17`; the proto parser is a line-oriented recursive-descent parser, no grammar library).
+
+- [ ] **Step 4: Run tests to verify they pass**
+
+Run: `cd docs/tools && mvn -q test 2>&1 | tail -5`
+Expected: all tests pass, no warnings.
+
+- [ ] **Step 5: Wire and build the site**
+
+Run: `npx -y pnpm@10.34.2 --dir docs run tools:build && npx -y pnpm@10.34.2 --dir docs run generate && npx -y pnpm@10.34.2 --dir docs exec astro build 2>&1 | tail -4`
+Expected: `All internal links are valid.`, page count above 500; `docs/dist/api/io/github/jwdeveloper/tiktok/api/live/liveclient/index.html` renders the signature block; the sidebar groups API pages by package directory.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add docs/tools docs/package.json
+git commit -m "docs: generate API and protobuf schema reference pages"
+```
+
+### Task 3: Docs tool, `check` command
+
+**Files:**
+- Create: `docs/tools/src/main/java/docs/ContentCheck.java`, `docs/tools/src/main/java/docs/ExampleCompiler.java`
+- Test: `docs/tools/src/test/java/docs/ContentCheckTest.java`, `docs/tools/src/test/java/docs/ExampleCompilerTest.java`
+
+**Interfaces:**
+- `ContentCheck.run(Path repoRoot, PrintStream out) -> int` printing exactly these sections in order: `events`, `settings`, `builder`, `exceptions`, `extensions`, `discord`, `readme`, `examples`, each `PASS <section>` or `FAIL <section>: <first three failures joined by "; ">`, then `Checked N pages, E events, S settings fields, H handlers, X exceptions, J Java examples.`; returns 1 if any section failed.
+- Extraction (JavaParser over the sources): `events(repoRoot) -> Map<String, String>` event simple name → `@EventMeta` category (`Control`/`Message`/`Debug`) for every class under `api/data/events`; `settingsFields(repoRoot) -> List<String>` from `LiveClientSettings` and `HttpClientSettings`; `handlers(repoRoot) -> List<String>` every public method named `on*` declared on `EventsBuilder` plus every public method of `LiveClient`; `exceptions(repoRoot) -> List<String>` class names under `api/exceptions`; extensions = `TikTokLiveRecorder`, `TikTokLiveCollector`.
+- Page rules: authored pages are every `.md`/`.mdx` under `docs/src/content/docs` except `api/` and `schema/`; `events`: every event name appears in backticks somewhere and the catalog `events/index.md` has a row ``| `TikTokXEvent` | <Control|Message|Debug> | description |`` whose type equals the annotation; `settings`, `builder`, `exceptions`, `extensions`: each name in backticks somewhere; `discord`: no `discord.com`/`discord.gg`; `readme`: every `- [onX](#...)` item in the repository `README.md` events list names a handler that exists on `EventsBuilder` and whose event class (the heading's `TikTokXEvent`) is in `events`; `examples`: every ```` ```java ```` fence (any indentation, dedented) compiles.
+- `ExampleCompiler.compile(List<Example> examples, Path repoRoot) -> List<String>` where `Example(String label, String code)`; a fence containing a top-level type declaration (regex `^(public\s+)?(final\s+)?(class|interface|record|enum)\s+\w+` on a dedented line) compiles as-is in its own file named after the first declared type; any other fence is wrapped as `import io.github.jwdeveloper.tiktok.*; import io.github.jwdeveloper.tiktok.api.*; …` (one wildcard import per package found under `API` and `Client` sources, plus `java.util.*`, `java.time.*`, `java.util.function.*`, `java.util.logging.*`) around `public class Example<N> { void run() throws Exception { <body> } }`; compiled with `ToolProvider.getSystemJavaCompiler()`, `--release 17`, classpath = `API/target/classes`, `Client/target/classes`, `extension-recorder/target/classes`, `extension-collector/target/classes` plus every jar under `~/.m2` that those modules depend on, resolved by running `mvn -q -pl API,Client,extension-recorder,extension-collector dependency:build-classpath -Dmdep.outputFile=docs/tools/target/classpath.txt` from `tools:build` (the `check` command reads that file; failing when it is missing). A canary fragment `TikTokLive.newClient("x").onComment((c, e) -> e.getComent());` is always compiled and must fail, else `examples` reports `example compiler canary not flagged`.
+
+- [ ] **Step 1: Write failing tests**
+
+```java
+class ContentCheckTest {
+  @Test void eventsMapIncludesCategories() { var e = ContentCheck.events(REPO); assertEquals("Message", e.get("TikTokCommentEvent")); assertEquals("Control", e.get("TikTokConnectedEvent")); assertTrue(e.size() >= 78); }
+  @Test void settingsHandlersExceptions() { assertTrue(ContentCheck.settingsFields(REPO).contains("retryConnectionTimeout")); assertTrue(ContentCheck.handlers(REPO).contains("onComment")); assertEquals(11, ContentCheck.exceptions(REPO).size()); }
+  @Test void checkEventsReportsMissingEvent(@TempDir Path site) { /* one page mentioning `TikTokCommentEvent` only; events map {TikTokCommentEvent→Message, TikTokNewShinyEvent→Message} → failure "Missing event documentation: TikTokNewShinyEvent" */ }
+  @Test void catalogRowTypeMustMatchAnnotation() { /* row "| `TikTokCommentEvent` | Control | x |" vs Message → "Event catalog row is stale: TikTokCommentEvent" */ }
+  @Test void readmeHandlerWithoutClassFails() { /* README text "- [onComent](#oncoment-tiktokcomentevent)" → "README handler has no event class: onComent" */ }
+  @Test void discordLinkFails() { /* "https://discord.gg/abc" → "t.md: published pages must not reference Discord" */ }
+}
+class ExampleCompilerTest {
+  @Test void fragmentCompiles() { assertTrue(ExampleCompiler.compile(List.of(new Example("p.md, example 1", "TikTokLive.newClient(\"user\").onComment((client, event) -> System.out.println(event.getText())).buildAndConnect();")), REPO).isEmpty()); }
+  @Test void fragmentWithUnknownMethodFails() { var f = ExampleCompiler.compile(List.of(new Example("p.md, example 1", "TikTokLive.newClient(\"user\").onComment((client, event) -> event.getComent());")), REPO); assertEquals(1, f.size()); assertTrue(f.get(0).startsWith("p.md, example 1")); }
+  @Test void fullUnitCompilesAsIs() { /* a fence declaring `public class Demo extends TikTokEventListenerBase` with a @TikTokEventObserver method compiles */ }
+  @Test void canaryGuardsVacuousPass() { /* with an empty classpath file, compile returns the canary failure message */ }
+}
+```
+
+- [ ] **Step 2: Run tests to verify they fail** (`cd docs/tools && mvn -q test`): compilation errors for the missing classes.
+
+- [ ] **Step 3: Implement `ContentCheck` and `ExampleCompiler` per Interfaces; wire `check` in `Main`.**
+
+- [ ] **Step 4: Run tests to verify they pass** (`cd docs/tools && mvn -q test`): all pass.
+
+- [ ] **Step 5: Run the check against the scaffold**
+
+Run: `npx -y pnpm@10.34.2 --dir docs run tools:build && npx -y pnpm@10.34.2 --dir docs run check; echo exit=$?`
+Expected: exit 1 with `FAIL events`, `FAIL settings`, `FAIL builder`, `FAIL exceptions`, `FAIL extensions`, `FAIL readme`, and `PASS discord`, `PASS examples` (zero fences, canary flagged).
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add docs/tools
+git commit -m "docs: add content coverage and example compilation checks"
+```
+
+### Task 4: Start here pages
+
+**Files:** Modify `docs/src/content/docs/index.md`; create/replace `getting-started/install.md`, `getting-started/connection.md`.
+
+**Interfaces:** Consumes README `Introduction`, `Getting started` (Maven and Gradle snippets, the three-line connect example), `examples/ConnectionExample.java`, `LiveClient`/`LiveClientBuilder`/`EventsBuilder` sources, `TikTokConnectedEvent`/`TikTokDisconnectedEvent`/`TikTokReconnectingEvent`/`TikTokErrorEvent`/`TikTokPreConnectionEvent` classes, `LiveClientSettings` reconnect fields. Produces root headings `#prerequisites`, `#install`, `#listen-to-a-livestream`, `#next-steps`; the root page carries at least three distinct Euler Stream anchors (`Euler Stream`, `TikTok LIVE signing API`, `TikTok LIVE WebSocket API`) and a Signing section naming `apiKey` and `useEulerstreamWebsocket`.
+
+- [ ] **Step 1: Write the three pages** (Install: JitPack repository block for Maven and Gradle, both coordinates, Java 16+; Connection: `build()` vs `buildAndConnect()` vs `buildAndConnectAsync()`, `connect()`/`connectAsync()`/`disconnect()` on `LiveClient`, retry settings, the four lifecycle events, `getRoomInfo()`).
+- [ ] **Step 2: Verify**: `npx -y pnpm@10.34.2 --dir docs run check | grep -E '^(PASS|FAIL) (examples|discord)'` → both PASS; `npx -y pnpm@10.34.2 --dir docs exec astro build 2>&1 | grep -E 'links are valid|error'` → valid (add one-sentence placeholders for `/configuration/client-settings/`, `/configuration/signing/`, `/events/`, `/guides/gifts/` only if linked and missing; list them in the report).
+- [ ] **Step 3: Commit** `docs: write Getting Started, Install, and connection lifecycle pages`.
+
+### Task 5: Configuration pages
+
+**Files:** Create `configuration/client-settings.md`, `http-settings.md`, `signing.md`, `authentication.md`, `proxies-and-host.md`, `logging.md` (frontmatter `sidebar.order` 1–6 in that order).
+
+**Interfaces:** Consumes `ContentCheck.settingsFields` (every `LiveClientSettings` and `HttpClientSettings` field must appear in backticks; get the list with `java -jar docs/tools/target/docs-tools.jar check ..` output or a one-off JShell call), `examples/CustomizationExample.java`, `ProxyExample.java`, `Client/.../websocket/euler/*` for the Euler Stream WebSocket path. Produces: `client-settings.md` has one table row per `LiveClientSettings` field (name, type, default, effect); `http-settings.md` one per `HttpClientSettings` field; `signing.md` carries two distinct Euler Stream anchors.
+
+- [ ] **Step 1: Write the six pages.**
+- [ ] **Step 2: Verify**: `check` → `PASS settings`, `PASS examples`, `PASS discord`; build links valid.
+- [ ] **Step 3: Commit** `docs: write configuration pages`.
+
+### Task 6: Event catalog and grouped event pages
+
+**Files:** Replace `events/index.md`; create `events/control.md`, `chat-and-audience.md`, `gifts-and-goals.md`, `battles-and-cohosting.md`, `subscriptions-and-fans.md`, `room-and-display.md`, `rankings.md`, `moderation-and-access.md`, `games-and-commerce.md`, `stream-control.md`, `debugging.md` (orders 0–11).
+
+**Interfaces:** Consumes `ContentCheck.events` (78 names with categories), the spec's grouping list (7.1), README per-event sections for descriptions, each event class's fields (Lombok getters) and, where an event wraps a proto message, the message class name for the schema link `/schema/<file stem>/<message slug>/` (find the file by `find docs/src/content/docs/schema -name '<lowercase>.md'`). Produces exactly one `## TikTokXEvent` heading per event (slug `#tiktokxevent`), catalog rows per the Task 3 contract, Java examples for `TikTokCommentEvent`, `TikTokGiftEvent`, `TikTokGiftComboEvent`, `TikTokLikeEvent`, `TikTokConnectedEvent`, `TikTokDisconnectedEvent` (fragments using `TikTokLive.newClient(...)`).
+
+- [ ] **Step 1: Write `events/index.md`** (intro with the `onX` fluent handler and the `@TikTokEventObserver` listener forms, counts, `## Find an event` with one sub-table per page).
+- [ ] **Step 2: Write the eleven grouped pages.**
+- [ ] **Step 3: Verify**: `check` → `PASS events`, `PASS readme`, previous sections still PASS; `generate` then `astro build` → links valid (schema links resolve).
+- [ ] **Step 4: Commit** `docs: write the event catalog and grouped event pages`.
+
+### Task 7: Guides
+
+**Files:** Create `guides/gifts.md`, `listeners.md`, `custom-events.md`, `recorder.md`, `collector.md`, `offline-testing.md`, `debugging.md` (orders 1–7).
+
+**Interfaces:** Consumes `examples/*.java` (one per guide), `extension-recorder` and `extension-collector` sources (`TikTokLiveRecorder`, `TikTokLiveCollector`, `DataCollector`), `TikTokEventListenerBase`, `@TikTokEventObserver`, `LiveClientSettings.offline`, `Events_And_Gifts_Testing_Example.java`. Produces `PASS extensions` (both extension class names in backticks) and at least one compiling Java example per guide (full listener classes compile as units).
+
+- [ ] **Step 1: Write the seven guides.** - [ ] **Step 2: Verify** `check` → `PASS extensions`, `PASS examples`; build links valid. - [ ] **Step 3: Commit** `docs: write guides`.
+
+### Task 8: Advanced, troubleshooting, contributing, hosting; full green build
+
+**Files:** Create `advanced/http-client.md`, `advanced/websocket.md`, `advanced/protocol.md`; replace `troubleshooting.md`, `contributing.md`, `hosting.md`; create `docs/README.md`; add a `Documentation` section to `collaboration.md`.
+
+**Interfaces:** Consumes `ContentCheck.exceptions` (all 11 exception classes in backticks on troubleshooting or advanced pages), `Client/.../http/*`, `Client/.../websocket/*`, `api/mappers/*`, the Python sibling's `troubleshooting.md`, `contributing.md`, `hosting.md`, `docs/README.md` as templates, and the plan's Tasks 9 and 11 for the hosting facts (hostname, Worker name, workflow shape, secrets, scheduled upstream checkout, SEO gate). Produces the first fully green build.
+
+- [ ] **Step 1: Write the pages** (contributing covers: JDK 17+, Maven, Node 24, pnpm 10.34.2, `pnpm --dir docs tools:build | check | generate | build | dev`, fence rules including fragment wrapping, no Discord, Euler links, generated dirs never committed, the eight check sections, fact sources).
+- [ ] **Step 2: Full build**: `npx -y pnpm@10.34.2 --dir docs build 2>&1 | grep -E '^(PASS|FAIL)|Checked|links are valid|page\(s\) built'` → all eight `PASS`, summary line, links valid, pages above 500.
+- [ ] **Step 3: Commit** `docs: write advanced, troubleshooting, contributing, and hosting pages`.
+
+### Task 9: SEO gate (Node)
+
+**Files:** Create `docs/scripts/verify-seo.mjs`, `docs/scripts/verify-seo.test.mjs`; add `package.json` scripts `seo` (`node scripts/verify-seo.mjs dist`) and `test` (`node --test scripts/`).
+
+**Interfaces:** `verifySeo(buildDir) -> { passes: string[], failures: string[] }` and a CLI exiting 1 on failures; `BASE_URL = 'https://ttlj.docs.isaackogan.com/'`; checks identical to the Python sibling's `scripts/seo/verify_seo.py`: homepage `<title>` contains `TikTok LIVE API`; every page (`**/index.html` plus `404.html`) has `rel="canonical"` with its own URL (`BASE_URL + dir + '/'`, `404.html` → `404/`); homepage `og:title`, `og:description`, `og:image`, meta description; `sitemap-index.xml` and `sitemap-0.xml` exist, the latter uses `BASE_URL` with more than one `<loc>`; `robots.txt` names the sitemap; no eulerstream link has `rel="nofollow"`; every page has at least one eulerstream link; homepage has at least three distinct eulerstream anchor texts (whitespace-collapsed, lowercased); every page contains `class="sidebar-entries`.
+
+- [ ] **Step 1: Write failing tests** (`node:test`): `gatePassesOnFixtureSite`, `failsWhenNestedPageLacksEulerLink`, `failsWhenRobotsHasNoSitemap`, `failsWhenCanonicalPointsAtAnotherPage`, with a `writeFixtureSite(dir, overrides)` helper.
+- [ ] **Step 2: Run to verify they fail** (`npx -y pnpm@10.34.2 --dir docs test`). - [ ] **Step 3: Implement.** - [ ] **Step 4: Tests pass; then `npx -y pnpm@10.34.2 --dir docs run seo` on the real build prints only PASS lines.** If the homepage title check fails, add the `head` title override on `index.md` as the Python sibling does (`TikTok LIVE API for Java: TikTokLiveJava Documentation`).
+- [ ] **Step 5: Commit** `docs: add the SEO gate for the built site`.
+
+### Task 10: README
+
+**Files:** Modify `README.md`.
+
+**Interfaces:** Consumes event heading slugs from Task 6 (`/events/<page>/#tiktokxevent`) and `ContentCheck` `readme` section. Produces: a documentation line after the introduction and a `Documentation` entry at the top of the events/contents area pointing at `https://ttlj.docs.isaackogan.com/`; every `- [onX](#onx-tiktokxevent)` item in the events list keeps its in-page anchor and gains a trailing ` · [docs](https://ttlj.docs.isaackogan.com/events/<page>/#tiktokxevent)` link; each `## onX [TikTokXEvent](<github source url>)` heading's source URL gains the missing `api/` path segment (they 404 today) and a following line `Documentation: https://ttlj.docs.isaackogan.com/events/<page>/#tiktokxevent`; no relative links remain. Structure and copy otherwise unchanged.
+
+- [ ] **Step 1: Edit.** - [ ] **Step 2: Verify** with a one-off audit (every `ttlj.docs.isaackogan.com` link maps to `docs/dist/<path>/index.html` containing `id="<anchor>"`; every GitHub source link resolves via `gh api repos/jwdeveloper/TikTokLiveJava/contents/<path>` returning 200; `check` → `PASS readme`). - [ ] **Step 3: Commit** `docs: point the README at the hosted documentation`.
+
+### Task 11: Worker config and workflow
+
+**Files:** Create `docs/wrangler.jsonc`, `.github/workflows/docs.yml`.
+
+**Interfaces:**
+- `wrangler.jsonc`: `name tiktoklivejava-docs`, `compatibility_date 2026-10-20`, assets `./dist`, `auto-trailing-slash`, `404-page`, `workers_dev false`, and no `routes` block (the custom domain `ttlj.docs.isaackogan.com` is already attached to the Worker and survives deploys; wrangler prints `No targets deployed`, which is expected; ruling J12). `hosting.md` states the one-time domain attachment and that the CI token is scoped to the Worker only.
+- `docs.yml`: name `Documentation`; triggers `pull_request` and `push` to `master` with paths `docs/**`, `API/**`, `Client/**`, `extension-recorder/**`, `extension-collector/**`, `README.md`, `.github/workflows/docs.yml`; `workflow_dispatch`; `schedule: - cron: '17 6 * * *'`; `permissions: contents: read`; concurrency `docs-${{ github.ref }}`. Job `build` (env `DEPLOY_ENABLED: ${{ secrets.CLOUDFLARE_API_TOKEN != '' }}`): checkout, where `with.repository` is `jwdeveloper/TikTokLiveJava` and `ref: master` **only when** `github.event_name == 'schedule'` (use two checkout steps with opposite `if`s); `actions/setup-java@v4` (`temurin`, `17`, `cache: maven`); `mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests package`; `actions/setup-node@v4` (24); `npm install --global pnpm@10.34.2`; `pnpm --dir docs install --frozen-lockfile`; `pnpm --dir docs test`; `pnpm --dir docs build`; `pnpm --dir docs run seo`; `actions/upload-artifact@v4` (`documentation`, `docs/dist`); deploy `cloudflare/wrangler-action@v4` (`apiToken`, `accountId`, `workingDirectory: docs`, `packageManager: pnpm`, `command: deploy`) with `if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/master' || github.event_name == 'schedule') && env.DEPLOY_ENABLED == 'true'`. A first job `upstream` (ubuntu-latest, output `has_docs`) whose single step sets `has_docs=true` unless `github.event_name == 'schedule'` and `gh api repos/jwdeveloper/TikTokLiveJava/contents/docs/package.json --silent` fails (env `GH_TOKEN: ${{ github.token }}`; print a `::notice::` when skipping); job `build` has `needs: upstream` and `if: needs.upstream.outputs.has_docs == 'true'` (ruling J10).
+- Validation: `npx -y js-yaml .github/workflows/docs.yml > /dev/null` parses; `grep -c 'repository: jwdeveloper/TikTokLiveJava' .github/workflows/docs.yml` prints 1 and that line sits in the checkout step whose `if` is `github.event_name == 'schedule'` (the other checkout step's `if` is `github.event_name != 'schedule'` and has no `repository` input); `cd docs && npx -y pnpm@10.34.2 exec wrangler deploy --dry-run --outdir /tmp/wrangler-dry` succeeds. `grep -c "needs.upstream.outputs.has_docs == 'true'" .github/workflows/docs.yml` prints 1.
+
+- [ ] **Step 1: Write both files.** - [ ] **Step 2: Validate as above; reconcile `hosting.md`, `contributing.md`, `docs/README.md` with the real files.** - [ ] **Step 3: Commit** `docs: deploy the site to Cloudflare Workers from GitHub Actions`.
+
+### Task 12: Bootstrap on the fork (controller, with the maintainer)
+
+- [ ] **Step 1: Secrets on the fork.** The Worker `tiktoklivejava-docs` already exists with the custom domain attached (created from the maintainer's wrangler login on 2026-10-20 with a placeholder page), so the maintainer creates an account-owned token scoped to Editor on that Worker. `gh secret set CLOUDFLARE_API_TOKEN -R isaackogan/TikTokLiveJava` (value via stdin) and `gh secret set CLOUDFLARE_ACCOUNT_ID -R isaackogan/TikTokLiveJava --body <account id>`. Verify with a local deploy of the current build using that token before relying on CI.
+- [ ] **Step 2: Push the branch; open a fork-internal PR `docs/starlight-site` → `isaackogan:master` to get a CI run; when green, merge it with a merge commit (no squash, no force).**
+- [ ] **Step 3: Watch the fork's `master` run**: `build` succeeds, `Deploy to Cloudflare Workers` ran; `curl -s -o /dev/null -w '%{http_code}' https://ttlj.docs.isaackogan.com/events/` becomes 200 within a few minutes; `/events` → 307; `/missing/` → 404.
+- [ ] **Step 4: Scheduled path.** A schedule cannot be triggered by hand; the Task 11 YAML assertion is the pre-merge verification, and the first scheduled run (06:17 UTC the next day) is checked afterwards with `gh run list --workflow=docs.yml -R isaackogan/TikTokLiveJava --event schedule --limit 1`.
+
+### Task 13: Pull request upstream (controller, with the maintainer)
+
+- [ ] **Step 1:** `gh pr create -R jwdeveloper/TikTokLiveJava --base master --head isaackogan:docs/starlight-site --title "docs: Starlight documentation site at ttlj.docs.isaackogan.com" --body-file <summary>` describing the site, the gates, the hosting (maintained on the fork; upstream deploys only if the two secrets are added), and the README changes.
+- [ ] **Step 2:** Confirm upstream's `pull_request` run validates (no deploy). Merge is the upstream maintainer's.
diff --git a/docs/superpowers/specs/2026-10-20-starlight-docs-design.md b/docs/superpowers/specs/2026-10-20-starlight-docs-design.md
new file mode 100644
index 00000000..533f2596
--- /dev/null
+++ b/docs/superpowers/specs/2026-10-20-starlight-docs-design.md
@@ -0,0 +1,125 @@
+# Starlight Documentation Site for TikTokLiveJava
+
+**Date:** 2026-10-20
+**Status:** Implemented (approved 2026-10-20; rulings made during implementation are noted inline)
+**Upstream:** `jwdeveloper/TikTokLiveJava` (default branch `master`); the maintainer of this effort has no push rights there.
+**Working fork:** `isaackogan/TikTokLiveJava` (a real GitHub fork, in sync with upstream at `81f54d7`).
+**Reference implementations:** Node.js site https://ttlc.docs.isaackogan.com/ (repo `zerodytrash/TikTok-Live-Connector`, `docs/`), Python site https://ttl.docs.isaackogan.com/ (repo `isaackogan/TikTokLive`, `docs/`, design at `docs/superpowers/specs/2026-10-19-starlight-docs-design.md`).
+
+## 1. Intent
+
+Give the Java library the same documentation site its Node.js and Python siblings have: an Astro Starlight site with the lucode theme, a generated API reference, content-coverage checks that fail the build when the docs drift from the code, Euler Stream SEO links, hosted on Cloudflare Workers static assets under a trademark-free hostname, deployed by GitHub Actions. The work is developed on the maintainer's fork, where the first CI run creates the Cloudflare Worker, and then offered upstream as a pull request.
+
+The maintainer's words: "do the same for the Java app, except … run the initial action on my personal remote and init the CF worker from there and then PR on JWDeveloper's branch."
+
+## 2. Current state (verified 2026-10-20)
+
+- Maven multi-module build: `API`, `Client`, `examples`, `tools-readme`, `extension-recorder`, `extension-collector`; Java 16 target; published through JitPack (`jitpack.yml`); version `1.13.1-Release`. Local toolchain: JDK 21, Maven 3.9.12. CI: one workflow, `maven-publish.yml` (manual dispatch, JDK 16 Corretto).
+- No documentation site, no GitHub Pages (`has_pages: false`), a GitHub wiki exists. README (758 lines) is the only documentation: introduction, getting started, an events list, per-event examples, extensions, listeners, contributing. It links the Euler Stream quickstart and the Discord invite `discord.gg/e2XwPNTBBr`.
+- The `tools-readme` module once generated the README (`ReadmeGenerator`, `EventsInfoGenerator`, templates under `tools-readme/src/main/resources/`), but the checked-in README differs from the generator's `output.md` by 378 diff lines: the README is hand-maintained now (the maintainer's own PR #158 revised it directly). `tools-readme` is left untouched.
+- Protobuf definitions ship in the repository: `API/src/main/proto/webcast.proto`, `data.proto`, `enums.proto`; the Java message classes are generated at build time. Listener handler methods are marked with `@TikTokEventObserver`; `@EventMeta` annotates event classes.
+- Public surface: entry point `TikTokLive.newClient(...)` returning a `LiveClientBuilder` with fluent `on<Event>` handlers; `LiveClientSettings` (16 fields such as `offline`, `fetchGifts`, `retryOnConnectionFailure`, `retryConnectionTimeout`, `pingInterval`, `useEulerstreamWebsocket`, `sessionId`, `apiKey`, `hostName`, `httpSettings`), `HttpClientSettings`; 78 event classes under `io.github.jwdeveloper.tiktok.api.data.events` in sub-packages `common`, `control`, `envelop`, `gift`, `http`, `link`, `poll`, `room`, `social`, `websocket`; listener base `TikTokEventListenerBase` with annotated handler methods; data models under `api.data.models` and `api.data.dto`; exceptions under `api.exceptions`; extensions (`extension-recorder`, `extension-collector`).
+- Javadoc coverage is thin: 32 of 154 API source files carry a `/** */` comment.
+- `ttlj.docs.isaackogan.com` has no DNS record; zone `isaackogan.com` is on Cloudflare in the maintainer's account, which already hosts the two sibling Workers.
+
+## 3. Goals
+
+1. A Starlight site in `docs/` mirroring the siblings' structure, theme, header (GitHub and Discord buttons), footer, favicon, Getting Started root page, and Euler Stream link profile.
+2. A generated **API reference** from the Java sources of `API` and `Client` (signatures, fields, Javadoc where present, including `api.data.models` and `api.data.dto`) and a **Protobuf schema** reference generated from the three `.proto` files (every message and enum with its fields), regenerated on every build and never committed.
+3. A **content check** that fails the build when any event class, `LiveClientSettings` or `HttpClientSettings` field, `LiveClientBuilder` handler method, exception class, or extension is undocumented, and that compiles every Java example in the docs against the library.
+4. **Hosting** on Cloudflare Workers static assets at **https://ttlj.docs.isaackogan.com/** (my proposal; see open question 1), Worker `tiktoklivejava-docs`, deployed by `docs.yml` on pushes to `master`, validated on pull requests, gated on the `CLOUDFLARE_API_TOKEN` secret so a repository without the secret still validates.
+5. **Bootstrapped from the fork:** the first deployment is performed by the workflow running in `isaackogan/TikTokLiveJava` (secrets set there), which creates the Worker and attaches the custom domain; no deploy is run from a laptop.
+6. **README** links point at the hosted site, made through the `tools-readme` template if the README is still generated from it.
+7. A pull request from the fork's branch to `jwdeveloper/TikTokLiveJava:master` carrying everything, with a description the upstream maintainer can act on.
+
+## 4. Non-goals
+
+- Changing library behaviour or adding Javadoc beyond what a generated page needs to be readable.
+- Replacing or restructuring `tools-readme`; the README keeps its structure and only gains links and corrections.
+- Publishing anything to JitPack or Maven Central; the docs tooling never enters the root reactor's published modules.
+- Documenting the wiki or migrating it.
+- Internationalisation, blog, versioned docs.
+
+## 5. Anti-goals
+
+- No "tiktok" in any public hostname. The Worker name is internal.
+- No docs dependencies in the published artifacts: nothing enters `API/pom.xml` or `Client/pom.xml`; docs tooling lives under `docs/` with its own build.
+- No generated content in Git.
+- No Discord link in page text; the header button is the only Discord link.
+
+## 6. Constraints
+
+- Same pinned web stack as the siblings: `astro 7.4.1`, `@astrojs/starlight 0.42.6`, `lucode-starlight 1.0.0`, `starlight-links-validator 0.27.0`, `wrangler 4.151.2`, `pnpm@10.34.2`, Node 24 in CI.
+- Java tooling in CI: JDK 17 (Temurin) to build the library modules with the project's Java 16 target and to run the docs tools; Maven with dependency caching.
+- The upstream `maven-publish.yml` is untouched. `jitpack.yml` is untouched.
+- Work on branch `docs/starlight-site` in the local checkout, pushed to the fork `origin`. Nothing is force-pushed. The upstream remote is added as `upstream` for syncing only.
+
+## 7. Design
+
+### 7.1 Site structure (mirrors the siblings)
+
+- **Start here**: Getting Started (root `/`), Install (JitPack repository and coordinates for Maven and Gradle, Java 16 or newer, the two JitPack group names that both resolve), Connection lifecycle (`connect`, `connectAsync`, reconnect settings, `TikTokConnectedEvent`/`TikTokDisconnectedEvent`/`TikTokReconnectingEvent`/`TikTokErrorEvent`). There is no Migration page: the README carries no migration notes and GitHub releases are the only changelog (builder-check question 4, my call).
+- **Configuration**: Client settings (`LiveClientSettings`), HTTP settings (`HttpClientSettings`), Signing (Euler Stream, `apiKey`, `useEulerstreamWebsocket`), Authentication (`sessionId`, `ttTargetIdc`), Proxies and host (`hostName`, `httpSettings`), Logging (`printToConsole`, `logLevel`).
+- **Guides**: Gifts and combos (`TikTokGiftEvent`, `TikTokGiftComboEvent`), Listeners (`TikTokEventListenerBase`, annotated handlers), Custom events and mappings (`CustomEventExample`, `CustomMappingExample`), Recorder and Collector extensions, Offline testing (`offline`, `Events_And_Gifts_Testing_Example`), Debugging (`TikTokWebsocketResponseEvent`, `TikTokWebsocketUnhandledMessageEvent`, `TikTokHttpResponseEvent`).
+- **Events**: catalog with one row per event class, columns ``| `TikTokXEvent` | type | description |`` where `type` is the `@EventMeta` category (`Control`, `Message`, or `Debug`) read from the class, and grouped pages **by theme using the siblings' page names** (builder-check question 1, my call; 32 of the 78 events sit directly in `api.data.events` and `link/` alone holds 23, so sub-packages cannot be the grouping): `control` (connecting, connected, disconnected, reconnecting, error, pre-connection), `chat-and-audience` (comment, emote, join, like, follow, share, question, barrage, caption), `gifts-and-goals` (gift, gift combo, goal update, envelope, chest), `battles-and-cohosting` (every `TikTokLink*` event and `TikTokLinkMic*`), `subscriptions-and-fans` (subscribe, sub notify), `room-and-display` (room info, room pin, in-room banner, header, poll events), `rankings` (rank text, rank update), `moderation-and-access` (IM delete, unauthorized member, detect, unhandled member/social/control), `games-and-commerce` (shop), `stream-control` (live ended, paused, unpaused), `debugging` (websocket message/response/unhandled, http response, empty, unhandled). Each event gets one `## TikTokXEvent` heading with description, key fields, and a short Java example where behaviour is non-obvious.
+- **Advanced**: HTTP client and mappers, WebSocket layer, Protocol notes (what the library maps from TikTok's messages).
+- **Troubleshooting**, **Contributing to the docs**, **Hosting**.
+- **API reference** (generated), **Protobuf schema** (generated).
+
+Header: nav links Docs, Events, API; social links GitHub (`https://github.com/jwdeveloper/TikTokLiveJava`) and Discord (open question 2). Footer: the unofficial disclaimer with an Euler Stream link and a GitHub link. Favicon: the same `favicon.png` as the siblings.
+
+### 7.2 Generated references (my call)
+
+A standalone Maven project `docs/tools/` (its own `pom.xml`, not a module of the root reactor) containing one Java program with two commands:
+
+- `generate`: parses `API/src/main/java` and `Client/src/main/java` with **JavaParser** (no compilation needed) and writes Starlight Markdown: `src/content/docs/api/` with one page per public class, interface, enum, and record (signature, Javadoc summary when present, fields, constructors, methods with parameter and return types, extends/implements, source link to GitHub `blob/master/<path>#L<line>`), grouped by package directory so the sidebar groups by package. It also parses `API/src/main/proto/*.proto` (a small hand-written parser is enough for proto3 messages, enums, and nested types) and writes `src/content/docs/schema/` with one page per message and enum, titled `TikTok Webcast schema (<library version>)`. Pages are files (`<slug>.md`), package index pages are `<package>/index.md`, output is deterministic (sorted), and both directories are wiped before writing.
+- `check`: the content check in 7.3.
+
+Why JavaParser rather than a Javadoc doclet: it needs no compile of the library, tolerates the thin Javadoc, and gives full control of the Markdown layout, matching what `starlight-typedoc` and griffe produced for the siblings. The builder may switch to a doclet if JavaParser cannot resolve something the pages need, keeping the output contract.
+
+### 7.3 Content check
+
+`docs/tools` `check` runs before the Astro build and exits non-zero on any failing section, printing `PASS <section>` / `FAIL <section>: …` per section: `events` (every class under `api/data/events` appears in backticks on an authored page and has a catalog row whose `type` cell equals its `@EventMeta` category), `settings` (every field of `LiveClientSettings` and `HttpClientSettings`), `builder` (every public `on*` handler method declared on `EventsBuilder<T>`, the super-interface of `LiveClientBuilder`, and every public method of `LiveClient`), `exceptions` (every class under `api/exceptions`), `extensions` (both extension modules named), `discord` (no `discord.com`/`discord.gg` in authored pages), `readme` (every handler the README's events list names has a matching event class and a catalog row; the README carries no descriptions to compare), `examples` (every ```` ```java ```` fence in authored pages compiles with `javax.tools.JavaCompiler` against the `API`, `Client`, `extension-recorder`, and `extension-collector` classes: a fence containing a top-level `class`, `interface`, `record`, or `enum` declaration is compiled as-is; any other fence is a **fragment** and is wrapped in a synthetic class with wildcard imports of every `io.github.jwdeveloper.tiktok` package and its statements placed in a method body, so README-style snippets stay short (builder-check question 3, my call); a known-bad canary must fail so the gate cannot pass vacuously). `pnpm --dir docs build` runs `check`, then `generate`, then `astro build`.
+
+### 7.4 Hosting and deployment
+
+- `docs/wrangler.jsonc`: Worker `tiktoklivejava-docs`, `assets.directory ./dist`, `auto-trailing-slash`, `404-page`, `workers_dev false`, and no `routes` block: the custom domain `ttlj.docs.isaackogan.com` is attached to the Worker once from a maintainer's wrangler login and persists across deploys, so the CI token needs no zone permission (ruling J12, 2026-10-20).
+- `.github/workflows/docs.yml`: on `pull_request` and `push` to `master` (paths `docs/**`, `API/**`, `Client/**`, `extension-*/**`, `README.md`, `tools-readme/**`, `.github/workflows/docs.yml`) and `workflow_dispatch`; JDK 17 with Maven cache; `mvn -q -pl API,Client -am -DskipTests install` so the docs tools can compile examples against the library; Node 24 and pnpm 10.34.2; `pnpm --dir docs install --frozen-lockfile`; `pnpm --dir docs build`; SEO gate; upload the artifact; deploy with `cloudflare/wrangler-action@v4` when `github.ref == 'refs/heads/master'`, the event is not a pull request, and `DEPLOY_ENABLED` (derived from the `CLOUDFLARE_API_TOKEN` secret) is true.
+- **Bootstrap from the fork (superseded on 2026-10-20 by decision 4 below: the Worker and its domain were created from the maintainer's wrangler login before the bootstrap, so the fork's token is Worker-scoped from the start):** the branch is first merged into the fork's `master` (fork-local; upstream unaffected) with the secrets set on the fork, so the fork's first `master` run creates the Worker and attaches the domain. That first run needs a token that can create Workers and routes: Account → Workers Scripts → Edit, Account → Account Settings → Read, Zone → Workers Routes → Edit and Zone → Zone → Read on `isaackogan.com` (the same four-permission recipe as the Node site's first token). After the Worker exists the token can be replaced by one scoped to Editor on `tiktoklivejava-docs`, since later deploys only reconcile an existing domain.
+- **After the upstream merge** (open question 3): upstream squash-merges, so the fork's `master`, which already carries the docs commits, can never fast-forward to upstream `master` (builder-check question 2). Therefore no sync-by-push exists. If the fork keeps deploying, `docs.yml` gains a `schedule` (daily) and `workflow_dispatch` path that checks out `jwdeveloper/TikTokLiveJava` at `master` with `actions/checkout` (`repository:` and `ref:` inputs; the repo is public), builds, and deploys from that checkout without pushing anything to the fork; the push-triggered path keeps deploying the fork's own `master`. If instead the upstream maintainer adds the secrets, the same workflow deploys from upstream directly and the fork's scheduled path can be disabled. No force pushes anywhere.
+
+### 7.5 SEO
+
+Same profile as the siblings: one sitewide dofollow Euler Stream footer link plus contextual links with distinct anchors on the Getting Started and Signing pages; `sitemap-index.xml`, `robots.txt` with the sitemap line, canonical on every page, Open Graph tags; a `docs/scripts/verify_seo.py`-equivalent is written as a Node script (`docs/scripts/verify-seo.mjs`) so the Java repo needs no Python; it asserts the same invariants as the Python gate and runs in CI after the build. No Search Console file exists for this project; the maintainer adds the property by DNS verification.
+
+### 7.6 README
+
+The README is hand-maintained (section 2), so it is edited directly and `tools-readme` is not touched. Changes: a documentation line and table-of-contents entry pointing at the site, every event name in the events list linked to its hosted anchor, per-event example headings linking to the hosted event pages in addition to the GitHub source link they carry today, no relative links. Structure and copy otherwise unchanged.
+
+### 7.7 Repository changes
+
+`docs/` (Starlight project: `astro.config.mjs`, `package.json`, `pnpm-lock.yaml`, `pnpm-workspace.yaml`, `tsconfig.json`, `wrangler.jsonc`, `public/`, `scripts/verify-seo.mjs`, `src/content/docs/**`, `README.md`), `docs/tools/` (Maven project with the generator and check plus unit tests), `.github/workflows/docs.yml`, `.gitignore` additions (`docs/node_modules/`, `docs/.astro/`, `docs/dist/`, `docs/src/content/docs/api/`, `docs/src/content/docs/schema/`, `docs/tools/target/`), README (direct edits; its per-event source links currently 404 because they lack the `api/` path segment and are corrected in passing), a `Documentation` section in `collaboration.md` (the repo's contributing file). The build of `extension-recorder` and `extension-collector` is included in CI so the Recorder and Collector guides' examples compile.
+
+## 10. Builder-check resolutions (2026-10-20)
+
+1. Event grouping: by theme with the siblings' page names, catalog `type` column from `@EventMeta` (7.1, 7.3).
+2. Fork sync after a squash merge: scheduled checkout of upstream `master` inside `docs.yml`, no pushes (7.4).
+3. Java example fences: fragments are wrapped by the checker; full compilation units compile as-is (7.3).
+4. Migration page dropped in favour of an Install page (7.1).
+Accepted builder defaults: extensions on the example classpath; `readme` check reduced to handler existence; handlers read from `EventsBuilder<T>`; ignore `api/` and `schema/`; README source links fixed.
+
+## 8. Left to the builder
+
+- JavaParser page layout details; how generics, Lombok-generated accessors (`@Getter`/`@Setter` on settings classes), and records render.
+- Prose for every page, sourced from the README, `examples/`, and the sources.
+- Grouping of 78 events into the ten sub-package pages and the catalog descriptions (the README describes a subset; the rest are authored from the event classes).
+- The exact `check` implementation and its test fixtures.
+- Whether `docs/tools` is invoked through `mvn exec:java` or a shaded jar.
+
+## 9. Decisions (the maintainer delegated these on 2026-10-20: "decide yourself based on the most reasonable")
+
+1. **Hostname:** `ttlj.docs.isaackogan.com`.
+2. **Discord button:** the README's `https://discord.gg/e2XwPNTBBr`.
+3. **Deploys after the upstream merge:** the fork keeps deploying. The docs commits are merged into the fork's `master` (a normal merge, no force push) so `docs.yml` lives on the fork's default branch; its scheduled path checks out upstream `master` and deploys from it. The upstream copy of the workflow is gated on the secret and only validates there until jwdeveloper chooses to add secrets. Until upstream carries `docs/`, a scheduled run would check out a tree with nothing to build, so the workflow's first job probes upstream for `docs/package.json` and the build job is skipped on a schedule when it is absent (ruling J10, 2026-10-20).
+4. **First-deploy token (revised 2026-10-20):** the maintainer had the Worker `tiktoklivejava-docs` created from their own wrangler login with a placeholder page and the custom domain already attached, so the fork's CI only deploys to an existing Worker. The fork's `CLOUDFLARE_API_TOKEN` is therefore an account-owned token scoped to Editor on `tiktoklivejava-docs` (the same recipe as the sibling sites); no zone or account-wide permission is needed. Verified 2026-10-20: a token with Worker-only rights uploads fine but cannot reconcile a `routes` custom domain (403 on the zone lookup), which is why the repository config omits `routes` (ruling J12).
+5. **PR target:** `jwdeveloper/TikTokLiveJava:master` from `isaackogan:docs/starlight-site`.
diff --git a/docs/tools/pom.xml b/docs/tools/pom.xml
new file mode 100644
index 00000000..6e905d26
--- /dev/null
+++ b/docs/tools/pom.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Documentation tools for the Starlight site in docs/: `generate` writes the API and protobuf
+  schema reference pages, `check` validates the authored pages. Standalone on purpose: it is not
+  a module of the library build and only reads the library sources.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>docs</groupId>
+    <artifactId>docs-tools</artifactId>
+    <version>1.0.0</version>
+    <packaging>jar</packaging>
+
+    <properties>
+        <maven.compiler.release>17</maven.compiler.release>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.github.javaparser</groupId>
+            <artifactId>javaparser-core</artifactId>
+            <version>3.26.4</version>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <version>5.11.4</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <finalName>docs-tools</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.13.0</version>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>3.5.2</version>
+                <configuration>
+                    <systemPropertyVariables>
+                        <!-- The repository root, two levels above docs/tools. -->
+                        <repo.root>${project.basedir}/../..</repo.root>
+                    </systemPropertyVariables>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.6.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                            <filters>
+                                <filter>
+                                    <artifact>*:*</artifact>
+                                    <excludes>
+                                        <exclude>module-info.class</exclude>
+                                        <exclude>META-INF/*.SF</exclude>
+                                        <exclude>META-INF/*.DSA</exclude>
+                                        <exclude>META-INF/*.RSA</exclude>
+                                        <exclude>META-INF/MANIFEST.MF</exclude>
+                                    </excludes>
+                                </filter>
+                            </filters>
+                            <transformers>
+                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
+                                    <mainClass>docs.Main</mainClass>
+                                </transformer>
+                            </transformers>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/docs/tools/src/main/java/docs/ApiPages.java b/docs/tools/src/main/java/docs/ApiPages.java
new file mode 100644
index 00000000..0fa93bac
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ApiPages.java
@@ -0,0 +1,763 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import com.github.javaparser.ast.CompilationUnit;
+import com.github.javaparser.ast.Modifier;
+import com.github.javaparser.ast.NodeList;
+import com.github.javaparser.ast.body.AnnotationDeclaration;
+import com.github.javaparser.ast.body.AnnotationMemberDeclaration;
+import com.github.javaparser.ast.body.CallableDeclaration;
+import com.github.javaparser.ast.body.ClassOrInterfaceDeclaration;
+import com.github.javaparser.ast.body.ConstructorDeclaration;
+import com.github.javaparser.ast.body.EnumDeclaration;
+import com.github.javaparser.ast.body.FieldDeclaration;
+import com.github.javaparser.ast.body.MethodDeclaration;
+import com.github.javaparser.ast.body.Parameter;
+import com.github.javaparser.ast.body.RecordDeclaration;
+import com.github.javaparser.ast.body.TypeDeclaration;
+import com.github.javaparser.ast.expr.Expression;
+import com.github.javaparser.ast.nodeTypes.NodeWithAnnotations;
+import com.github.javaparser.ast.nodeTypes.NodeWithModifiers;
+import com.github.javaparser.ast.type.ClassOrInterfaceType;
+import com.github.javaparser.ast.type.ReferenceType;
+import com.github.javaparser.ast.type.TypeParameter;
+import com.github.javaparser.javadoc.Javadoc;
+import com.github.javaparser.javadoc.JavadocBlockTag;
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.TreeMap;
+import java.util.TreeSet;
+import java.util.function.Predicate;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
+/**
+ * Renders the API reference: {@code index.md} at the root, {@code <package path>/index.md} per package and
+ * {@code <package path>/<type slug>.md} per public type, so Starlight's autogenerated sidebar groups pages by
+ * package directory. Everything is sorted by name, so the output is deterministic.
+ */
+final class ApiPages {
+
+    static final String URL_ROOT = "/api/";
+    private static final Pattern IDENTIFIER = Pattern.compile("[A-Za-z_$][A-Za-z0-9_$]*(?:\\.[A-Za-z_$][A-Za-z0-9_$]*)*");
+    private static final int VALUE_WIDTH = 60;
+    private static final List<String> KINDS = List.of("class", "interface", "enum", "record", "annotation");
+
+    private ApiPages() {}
+
+    /**
+     * {@code io.github.jwdeveloper.tiktok.api.live.LiveClient} to {@code io/github/jwdeveloper/tiktok/api/live/liveclient}.
+     * A nested type is named in binary form, {@code pkg.Outer$Inner}, and slugs to {@code pkg/outer-inner}.
+     */
+    static String slug(String fqcn) {
+        return fqcn.toLowerCase(Locale.ROOT).replace('.', '/').replace('$', '-');
+    }
+
+    static List<Path> render(List<CompilationUnit> units, String version, String sourceBaseUrl, Path outDir) {
+        return render(units, version, sourceBaseUrl, outDir, Map.of());
+    }
+
+    /**
+     * Renders every page and returns their paths, the root index first.
+     *
+     * @param externalLinks root-relative URLs for types documented elsewhere (the protobuf schema pages), keyed by
+     *                      fully qualified Java class name with nested classes as {@code pkg.Outer.Inner}
+     */
+    static List<Path> render(List<CompilationUnit> units, String version, String sourceBaseUrl, Path outDir, Map<String, String> externalLinks) {
+        var types = collect(units);
+        var linker = new Linker(types, externalLinks);
+        var packages = packages(types);
+        var written = new ArrayList<Path>();
+        try {
+            for (var entry : packages.entrySet()) {
+                var pkg = entry.getKey();
+                written.add(Markdown.write(outDir, slug(pkg) + "/index.md", packagePage(pkg, entry.getValue(), packages.keySet())));
+                for (var type : entry.getValue()) {
+                    written.add(Markdown.write(outDir, type.slug() + ".md", typePage(type, sourceBaseUrl, linker)));
+                }
+            }
+            written.add(0, Markdown.write(outDir, "index.md", rootPage(version, packages, types)));
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        return written;
+    }
+
+    // --- Model ------------------------------------------------------------------------------
+
+    /** A documented type: its declaration, the unit it lives in, its package and its nesting chain of simple names. */
+    record TypeInfo(TypeDeclaration<?> decl, CompilationUnit cu, String pkg, List<String> nesting, TypeInfo outer) {
+
+        String simpleName() {
+            return nesting.get(nesting.size() - 1);
+        }
+
+        /** {@code Outer.Inner} for nested types. */
+        String displayName() {
+            return String.join(".", nesting);
+        }
+
+        String fqcn() {
+            return pkg + "." + displayName();
+        }
+
+        String slug() {
+            return ApiPages.slug(pkg + "." + String.join("$", nesting));
+        }
+
+        String url() {
+            return URL_ROOT + slug() + "/";
+        }
+
+        String kind() {
+            if (decl instanceof AnnotationDeclaration) {
+                return "annotation";
+            }
+            if (decl instanceof EnumDeclaration) {
+                return "enum";
+            }
+            if (decl instanceof RecordDeclaration) {
+                return "record";
+            }
+            return ((ClassOrInterfaceDeclaration) decl).isInterface() ? "interface" : "class";
+        }
+
+        String keyword() {
+            return kind().equals("annotation") ? "@interface" : kind();
+        }
+
+        boolean isInterfaceLike() {
+            return decl instanceof AnnotationDeclaration || (decl instanceof ClassOrInterfaceDeclaration c && c.isInterface());
+        }
+    }
+
+    private static List<TypeInfo> collect(List<CompilationUnit> units) {
+        var out = new ArrayList<TypeInfo>();
+        for (var cu : units) {
+            var pkg = cu.getPackageDeclaration().map(p -> p.getNameAsString()).orElse("");
+            for (var decl : cu.getTypes()) {
+                if (decl.isPublic()) {
+                    if (pkg.isEmpty()) {
+                        throw new IllegalStateException("types in the default package are not supported: " + decl.getNameAsString());
+                    }
+                    collectType(decl, cu, pkg, List.of(), null, out);
+                }
+            }
+        }
+        out.sort(Comparator.comparing(TypeInfo::pkg).thenComparing(TypeInfo::displayName));
+        return out;
+    }
+
+    private static void collectType(TypeDeclaration<?> decl, CompilationUnit cu, String pkg, List<String> outerNames, TypeInfo outer, List<TypeInfo> out) {
+        var nesting = new ArrayList<>(outerNames);
+        nesting.add(decl.getNameAsString());
+        var info = new TypeInfo(decl, cu, pkg, List.copyOf(nesting), outer);
+        out.add(info);
+        for (var member : decl.getMembers()) {
+            if (member instanceof TypeDeclaration<?> nested && exposed(nested, info)) {
+                collectType(nested, cu, pkg, info.nesting(), info, out);
+            }
+        }
+    }
+
+    /** Public, or an implicitly public member of an interface or annotation type. */
+    private static boolean exposed(NodeWithModifiers<?> member, TypeInfo owner) {
+        if (member.hasModifier(Modifier.Keyword.PUBLIC)) {
+            return true;
+        }
+        if (member.hasModifier(Modifier.Keyword.PRIVATE) || member.hasModifier(Modifier.Keyword.PROTECTED)) {
+            return false;
+        }
+        return owner.isInterfaceLike();
+    }
+
+    /** Every package with its types, plus the intermediate packages above them (with no types), sorted by name. */
+    private static TreeMap<String, List<TypeInfo>> packages(List<TypeInfo> types) {
+        var map = new TreeMap<String, List<TypeInfo>>();
+        for (var type : types) {
+            map.computeIfAbsent(type.pkg(), k -> new ArrayList<>()).add(type);
+            var parent = type.pkg();
+            while (parent.contains(".")) {
+                parent = parent.substring(0, parent.lastIndexOf('.'));
+                map.computeIfAbsent(parent, k -> new ArrayList<>());
+            }
+        }
+        return map;
+    }
+
+    // --- Linking ----------------------------------------------------------------------------
+
+    /** Resolves type names as they appear in signatures to the URL of the page documenting them. */
+    static final class Linker {
+        private final Map<String, TypeInfo> byFqcn = new HashMap<>();
+        private final Map<String, List<TypeInfo>> bySimple = new HashMap<>();
+        private final Map<String, String> external;
+        private final Map<String, String> externalBySimple = new HashMap<>();
+        private final Map<String, List<TypeInfo>> children = new HashMap<>();
+
+        Linker(List<TypeInfo> types, Map<String, String> external) {
+            this.external = external;
+            for (var type : types) {
+                byFqcn.put(type.fqcn(), type);
+                bySimple.computeIfAbsent(type.simpleName(), k -> new ArrayList<>()).add(type);
+                if (type.outer() != null) {
+                    children.computeIfAbsent(type.outer().fqcn(), k -> new ArrayList<>()).add(type);
+                }
+            }
+            var ambiguous = new TreeSet<String>();
+            for (var fqcn : new TreeSet<>(external.keySet())) {
+                var simple = fqcn.substring(fqcn.lastIndexOf('.') + 1);
+                if (externalBySimple.put(simple, fqcn) != null) {
+                    ambiguous.add(simple);
+                }
+            }
+            ambiguous.forEach(externalBySimple::remove);
+        }
+
+        List<TypeInfo> children(TypeInfo type) {
+            return children.getOrDefault(type.fqcn(), List.of());
+        }
+
+        /** The URL for a type name written in {@code scope}, or null when no page documents it. */
+        String url(String name, TypeInfo scope) {
+            var fqcn = resolve(name, scope);
+            return fqcn == null ? null : urlOf(fqcn);
+        }
+
+        private String urlOf(String fqcn) {
+            var type = byFqcn.get(fqcn);
+            return type != null ? type.url() : external.get(fqcn);
+        }
+
+        private String resolve(String name, TypeInfo scope) {
+            if (byFqcn.containsKey(name) || external.containsKey(name)) {
+                return name;
+            }
+            int dot = name.indexOf('.');
+            var head = dot < 0 ? name : name.substring(0, dot);
+            var rest = dot < 0 ? "" : name.substring(dot);
+            var headFqcn = resolveSimple(head, scope);
+            if (headFqcn == null) {
+                return null;
+            }
+            var full = headFqcn + rest;
+            return urlOf(full) != null ? full : null;
+        }
+
+        /** Java's name resolution, approximately: explicit imports, same package, enclosing types, wildcard imports. */
+        private String resolveSimple(String name, TypeInfo scope) {
+            var wildcards = new ArrayList<String>();
+            for (var imp : scope.cu().getImports()) {
+                if (imp.isStatic()) {
+                    continue;
+                }
+                if (imp.isAsterisk()) {
+                    wildcards.add(imp.getNameAsString());
+                } else if (imp.getName().getIdentifier().equals(name)) {
+                    return imp.getNameAsString();
+                }
+            }
+            for (var s = scope; s != null; s = s.outer()) {
+                if (s.simpleName().equals(name)) {
+                    return s.fqcn();
+                }
+                var nested = s.fqcn() + "." + name;
+                if (byFqcn.containsKey(nested)) {
+                    return nested;
+                }
+            }
+            var samePackage = scope.pkg() + "." + name;
+            if (byFqcn.containsKey(samePackage) || external.containsKey(samePackage)) {
+                return samePackage;
+            }
+            for (var wildcard : wildcards) {
+                var candidate = wildcard + "." + name;
+                if (urlOf(candidate) != null) {
+                    return candidate;
+                }
+            }
+            var candidates = bySimple.getOrDefault(name, List.of());
+            if (candidates.size() == 1) {
+                return candidates.get(0).fqcn();
+            }
+            return candidates.isEmpty() ? externalBySimple.get(name) : null;
+        }
+
+        /** A type expression as code spans, with every documented name linked. */
+        String markdown(String type, TypeInfo scope) {
+            var sb = new StringBuilder();
+            var run = new StringBuilder();
+            var m = IDENTIFIER.matcher(type);
+            int last = 0;
+            while (m.find()) {
+                run.append(type, last, m.start());
+                var url = url(m.group(), scope);
+                if (url == null) {
+                    run.append(m.group());
+                } else {
+                    flush(sb, run);
+                    var shown = byFqcn.containsKey(m.group()) ? byFqcn.get(m.group()).displayName() : m.group();
+                    sb.append(Markdown.link(Markdown.code(shown), url));
+                }
+                last = m.end();
+            }
+            run.append(type.substring(last));
+            flush(sb, run);
+            return sb.toString();
+        }
+
+        private static void flush(StringBuilder sb, StringBuilder run) {
+            if (run.length() > 0) {
+                sb.append(Markdown.code(run.toString()));
+                run.setLength(0);
+            }
+        }
+    }
+
+    // --- Pages ------------------------------------------------------------------------------
+
+    private static String rootPage(String version, TreeMap<String, List<TypeInfo>> packages, List<TypeInfo> types) {
+        var blurb = "API reference generated from the sources and Javadoc of TikTokLiveJava " + version
+                + ": every public type of the `API` and `Client` modules.";
+        var sb = new StringBuilder(Markdown.frontmatter("TikTokLiveJava " + version, blurb, "Overview", 0));
+        sb.append(blurb).append("\n\n");
+        sb.append("## Packages\n\n");
+        for (var entry : packages.entrySet()) {
+            if (!entry.getValue().isEmpty()) {
+                sb.append("- ").append(Markdown.link(Markdown.code(entry.getKey()), URL_ROOT + slug(entry.getKey()) + "/")).append('\n');
+            }
+        }
+        sb.append('\n');
+        var byName = new ArrayList<>(types);
+        byName.sort(Comparator.comparing(TypeInfo::displayName).thenComparing(TypeInfo::pkg));
+        for (var kind : KINDS) {
+            sb.append(listing(heading(kind), byName, t -> t.kind().equals(kind), true));
+        }
+        return sb.toString().stripTrailing() + "\n";
+    }
+
+    private static String packagePage(String pkg, List<TypeInfo> types, Set<String> allPackages) {
+        var label = pkg.substring(pkg.lastIndexOf('.') + 1);
+        var sb = new StringBuilder(Markdown.frontmatter(pkg, "package " + pkg, label, 0));
+        var subpackages = allPackages.stream()
+                .filter(p -> p.startsWith(pkg + ".") && !p.substring(pkg.length() + 1).contains("."))
+                .toList();
+        if (!subpackages.isEmpty()) {
+            sb.append("## Subpackages\n\n");
+            for (var sub : subpackages) {
+                sb.append("- ").append(Markdown.link(Markdown.code(sub.substring(pkg.length() + 1)), URL_ROOT + slug(sub) + "/")).append('\n');
+            }
+            sb.append('\n');
+        }
+        for (var kind : KINDS) {
+            sb.append(listing(heading(kind), types, t -> t.outer() == null && t.kind().equals(kind), false));
+        }
+        return sb.toString().stripTrailing() + "\n";
+    }
+
+    private static String heading(String kind) {
+        return "## " + switch (kind) {
+            case "class" -> "Classes";
+            case "interface" -> "Interfaces";
+            case "enum" -> "Enums";
+            case "record" -> "Records";
+            default -> "Annotations";
+        };
+    }
+
+    private static String listing(String heading, List<TypeInfo> types, Predicate<TypeInfo> filter, boolean qualified) {
+        var lines = new ArrayList<String>();
+        for (var type : types) {
+            if (!filter.test(type)) {
+                continue;
+            }
+            var line = "- " + Markdown.link(Markdown.code(type.displayName()), type.url());
+            if (qualified) {
+                line += " (" + Markdown.code(type.pkg()) + ")";
+            }
+            var summary = Markdown.summary(type.decl().getJavadoc());
+            if (!summary.isEmpty()) {
+                line += " — " + summary;
+            }
+            lines.add(line);
+        }
+        return lines.isEmpty() ? "" : heading + "\n\n" + String.join("\n", lines) + "\n\n";
+    }
+
+    private static String typePage(TypeInfo type, String sourceBaseUrl, Linker linker) {
+        var javadoc = type.decl().getJavadoc();
+        var summary = Markdown.summary(javadoc);
+        var description = summary.isEmpty() ? type.kind() + " " + type.fqcn() : Markdown.plain(summary);
+        var sb = new StringBuilder(Markdown.frontmatter(type.displayName(), description, type.displayName(), null));
+        if (type.outer() != null) {
+            sb.append("Nested in ").append(Markdown.link(Markdown.code(type.outer().displayName()), type.outer().url())).append(".\n\n");
+        }
+        var body = Markdown.body(javadoc);
+        if (!body.isEmpty()) {
+            sb.append(body).append("\n\n");
+        }
+        sb.append("## Signature\n\n").append(Markdown.codeBlock("java", typeSignature(type)));
+        sb.append(valuesSection(type));
+        sb.append(fieldsSection(type, linker));
+        sb.append(constructorsSection(type, linker));
+        sb.append(methodsSection(type, linker));
+        sb.append(nestedSection(type, linker));
+        sb.append(sourceSection(type, sourceBaseUrl));
+        return sb.toString().stripTrailing() + "\n";
+    }
+
+    // --- Signatures -------------------------------------------------------------------------
+
+    private static String typeSignature(TypeInfo type) {
+        var decl = type.decl();
+        var sb = new StringBuilder(annotations(decl));
+        var modifiers = modifiers(decl);
+        if (!modifiers.isEmpty()) {
+            sb.append(modifiers).append(' ');
+        }
+        sb.append(type.keyword()).append(' ').append(type.simpleName());
+        if (decl instanceof ClassOrInterfaceDeclaration c) {
+            sb.append(typeParameters(c.getTypeParameters()));
+            sb.append(clause(" extends ", c.getExtendedTypes()));
+            sb.append(clause(" implements ", c.getImplementedTypes()));
+        } else if (decl instanceof EnumDeclaration e) {
+            sb.append(clause(" implements ", e.getImplementedTypes()));
+        } else if (decl instanceof RecordDeclaration r) {
+            sb.append(typeParameters(r.getTypeParameters()));
+            sb.append('(').append(parameters(r.getParameters())).append(')');
+            sb.append(clause(" implements ", r.getImplementedTypes()));
+        }
+        return sb.toString();
+    }
+
+    private static String callableSignature(CallableDeclaration<?> callable) {
+        var sb = new StringBuilder(annotations(callable));
+        var modifiers = modifiers(callable);
+        if (!modifiers.isEmpty()) {
+            sb.append(modifiers).append(' ');
+        }
+        if (!callable.getTypeParameters().isEmpty()) {
+            sb.append(typeParameters(callable.getTypeParameters())).append(' ');
+        }
+        if (callable instanceof MethodDeclaration m) {
+            sb.append(m.getType().toString()).append(' ');
+        }
+        sb.append(callable.getNameAsString()).append('(').append(parameters(callable.getParameters())).append(')');
+        if (!callable.getThrownExceptions().isEmpty()) {
+            sb.append(" throws ").append(callable.getThrownExceptions().stream().map(ReferenceType::toString).collect(Collectors.joining(", ")));
+        }
+        return sb.toString();
+    }
+
+    private static String annotationMemberSignature(AnnotationMemberDeclaration member) {
+        var sb = new StringBuilder(annotations(member));
+        sb.append(member.getType().toString()).append(' ').append(member.getNameAsString()).append("()");
+        member.getDefaultValue().ifPresent(value -> sb.append(" default ").append(value));
+        return sb.toString();
+    }
+
+    private static String annotations(NodeWithAnnotations<?> node) {
+        var sb = new StringBuilder();
+        for (var annotation : node.getAnnotations()) {
+            sb.append(annotation).append('\n');
+        }
+        return sb.toString();
+    }
+
+    private static String modifiers(NodeWithModifiers<?> node) {
+        return node.getModifiers().stream().map(m -> m.getKeyword().asString()).collect(Collectors.joining(" "));
+    }
+
+    private static String typeParameters(NodeList<TypeParameter> parameters) {
+        if (parameters.isEmpty()) {
+            return "";
+        }
+        return "<" + parameters.stream().map(TypeParameter::toString).collect(Collectors.joining(", ")) + ">";
+    }
+
+    private static String clause(String keyword, NodeList<ClassOrInterfaceType> types) {
+        if (types.isEmpty()) {
+            return "";
+        }
+        return keyword + types.stream().map(ClassOrInterfaceType::toString).collect(Collectors.joining(", "));
+    }
+
+    private static String parameters(NodeList<Parameter> parameters) {
+        return parameters.stream().map(p -> parameterType(p) + " " + p.getNameAsString()).collect(Collectors.joining(", "));
+    }
+
+    private static String parameterType(Parameter parameter) {
+        return parameter.getType().toString() + (parameter.isVarArgs() ? "..." : "");
+    }
+
+    // --- Sections ---------------------------------------------------------------------------
+
+    private static String valuesSection(TypeInfo type) {
+        if (!(type.decl() instanceof EnumDeclaration e) || e.getEntries().isEmpty()) {
+            return "";
+        }
+        var sb = new StringBuilder("## Values\n\n");
+        for (var entry : e.getEntries()) {
+            sb.append("- **").append(Markdown.code(entry.getNameAsString())).append("**");
+            if (!entry.getArguments().isEmpty()) {
+                sb.append(" (").append(Markdown.code(entry.getArguments().stream().map(Object::toString).collect(Collectors.joining(", ")))).append(')');
+            }
+            var text = Markdown.line(entry.getJavadoc());
+            if (!text.isEmpty()) {
+                sb.append(" — ").append(text);
+            }
+            sb.append('\n');
+        }
+        return sb.append('\n').toString();
+    }
+
+    private static String fieldsSection(TypeInfo type, Linker linker) {
+        var entries = new TreeMap<String, String>();
+        if (type.decl() instanceof RecordDeclaration r) {
+            for (var component : r.getParameters()) {
+                entries.put(component.getNameAsString(), "- **" + Markdown.code(component.getNameAsString()) + "** ("
+                        + linker.markdown(parameterType(component), type) + ")");
+            }
+        }
+        var classLombok = lombok(type.decl());
+        for (var member : type.decl().getMembers()) {
+            if (!(member instanceof FieldDeclaration field)) {
+                continue;
+            }
+            var fieldLombok = lombok(field);
+            boolean isStatic = field.isStatic();
+            boolean getter = !isStatic && (fieldLombok.contains("Getter") ? !accessLevelNone(field, "Getter")
+                    : classLombok.contains("Getter") || classLombok.contains("Data") || classLombok.contains("Value"));
+            boolean setter = !isStatic && !field.isFinal() && !classLombok.contains("Value")
+                    && (fieldLombok.contains("Setter") ? !accessLevelNone(field, "Setter") : classLombok.contains("Setter") || classLombok.contains("Data"));
+            boolean builder = !isStatic && classLombok.contains("Builder");
+            if (!(exposed(field, type) || getter || setter || builder)) {
+                continue;
+            }
+            for (var variable : field.getVariables()) {
+                var meta = new ArrayList<String>();
+                meta.add(linker.markdown(variable.getType().toString(), type));
+                if (getter) {
+                    meta.add("getter");
+                }
+                if (setter) {
+                    meta.add("setter");
+                }
+                if (builder) {
+                    meta.add("builder");
+                }
+                var line = new StringBuilder("- **").append(Markdown.code(variable.getNameAsString())).append("** (").append(String.join(", ", meta)).append(')');
+                variable.getInitializer().filter(ApiPages::showable).ifPresent(value -> line.append(" = ").append(Markdown.code(Markdown.oneLine(value.toString()))));
+                var text = Markdown.line(field.getJavadoc());
+                if (!text.isEmpty()) {
+                    line.append(" — ").append(text);
+                }
+                entries.put(variable.getNameAsString(), line.toString());
+            }
+        }
+        if (entries.isEmpty()) {
+            return "";
+        }
+        return "## Fields\n\n" + String.join("\n", entries.values()) + "\n\n";
+    }
+
+    private static boolean showable(Expression value) {
+        return (value.isLiteralExpr() || value.isUnaryExpr() || value.isFieldAccessExpr()) && value.toString().length() <= VALUE_WIDTH;
+    }
+
+    private static String constructorsSection(TypeInfo type, Linker linker) {
+        var sb = new StringBuilder();
+        var lombok = lombok(type.decl());
+        var generated = new ArrayList<String>();
+        if (lombok.contains("NoArgsConstructor")) {
+            generated.add("- Lombok `@NoArgsConstructor` generates a constructor with no arguments.");
+        }
+        if (lombok.contains("RequiredArgsConstructor")) {
+            generated.add("- Lombok `@RequiredArgsConstructor` generates a constructor taking the final and `@NonNull` fields.");
+        }
+        if (lombok.contains("AllArgsConstructor")) {
+            generated.add("- Lombok `@AllArgsConstructor` generates a constructor taking every field.");
+        } else if (lombok.contains("Value")) {
+            generated.add("- Lombok `@Value` generates a constructor taking every field.");
+        }
+        if (lombok.contains("Data") && !lombok.contains("AllArgsConstructor") && !lombok.contains("NoArgsConstructor") && !lombok.contains("RequiredArgsConstructor")) {
+            generated.add("- Lombok `@Data` generates a constructor taking the final and `@NonNull` fields.");
+        }
+        if (lombok.contains("Builder")) {
+            generated.add("- Lombok `@Builder` generates a builder: `" + type.simpleName() + ".builder()`.");
+        }
+        if (!generated.isEmpty()) {
+            sb.append(String.join("\n", generated)).append("\n\n");
+        }
+        var constructors = new ArrayList<ConstructorDeclaration>();
+        for (var member : type.decl().getMembers()) {
+            if (member instanceof ConstructorDeclaration c && exposed(c, type)) {
+                constructors.add(c);
+            }
+        }
+        constructors.sort(Comparator.comparingInt((ConstructorDeclaration c) -> c.getParameters().size()).thenComparing(ApiPages::callableSignature));
+        for (var constructor : constructors) {
+            sb.append("### ").append(type.simpleName()).append("\n\n");
+            sb.append(callable(constructor, null, type, linker));
+        }
+        return sb.length() == 0 ? "" : "## Constructors\n\n" + sb;
+    }
+
+    private static String methodsSection(TypeInfo type, Linker linker) {
+        var sb = new StringBuilder();
+        var methods = new ArrayList<MethodDeclaration>();
+        var members = new ArrayList<AnnotationMemberDeclaration>();
+        for (var member : type.decl().getMembers()) {
+            if (member instanceof MethodDeclaration m && exposed(m, type)) {
+                methods.add(m);
+            } else if (member instanceof AnnotationMemberDeclaration a) {
+                members.add(a);
+            }
+        }
+        methods.sort(Comparator.comparing(MethodDeclaration::getNameAsString)
+                .thenComparingInt(m -> m.getParameters().size())
+                .thenComparing(ApiPages::callableSignature));
+        members.sort(Comparator.comparing(AnnotationMemberDeclaration::getNameAsString));
+        for (var member : members) {
+            sb.append("### ").append(member.getNameAsString()).append("\n\n");
+            sb.append(Markdown.codeBlock("java", annotationMemberSignature(member)));
+            var body = Markdown.body(member.getJavadoc());
+            if (!body.isEmpty()) {
+                sb.append(body).append("\n\n");
+            }
+        }
+        for (var method : methods) {
+            sb.append("### ").append(method.getNameAsString()).append("\n\n");
+            sb.append(callable(method, method.getType().toString(), type, linker));
+        }
+        return sb.length() == 0 ? "" : "## Methods\n\n" + sb;
+    }
+
+    /** Signature block, Javadoc body, then parameters, returns and throws with level-4 headings. */
+    private static String callable(CallableDeclaration<?> callable, String returnType, TypeInfo type, Linker linker) {
+        var sb = new StringBuilder(Markdown.codeBlock("java", callableSignature(callable)));
+        var javadoc = callable.getJavadoc();
+        var body = Markdown.body(javadoc);
+        if (!body.isEmpty()) {
+            sb.append(body).append("\n\n");
+        }
+        if (!callable.getParameters().isEmpty()) {
+            sb.append("#### Parameters\n\n");
+            for (var parameter : callable.getParameters()) {
+                sb.append("- **").append(Markdown.code(parameter.getNameAsString())).append("** (").append(linker.markdown(parameterType(parameter), type)).append(')');
+                var text = tag(javadoc, JavadocBlockTag.Type.PARAM, parameter.getNameAsString());
+                if (!text.isEmpty()) {
+                    sb.append(" — ").append(text);
+                }
+                sb.append('\n');
+            }
+            sb.append('\n');
+        }
+        if (returnType != null) {
+            var text = tag(javadoc, JavadocBlockTag.Type.RETURN, null);
+            if (!returnType.equals("void") || !text.isEmpty()) {
+                sb.append("#### Returns\n\n").append(linker.markdown(returnType, type));
+                if (!text.isEmpty()) {
+                    sb.append(" — ").append(text);
+                }
+                sb.append("\n\n");
+            }
+        }
+        var thrown = new TreeMap<String, String>();
+        for (var exception : callable.getThrownExceptions()) {
+            thrown.put(exception.toString(), "");
+        }
+        javadoc.ifPresent(j -> j.getBlockTags().stream()
+                .filter(t -> t.getType() == JavadocBlockTag.Type.THROWS || t.getType() == JavadocBlockTag.Type.EXCEPTION)
+                .forEach(t -> thrown.put(t.getName().orElse("Exception"), Markdown.tagText(t))));
+        if (!thrown.isEmpty()) {
+            sb.append("#### Throws\n\n");
+            thrown.forEach((name, text) -> sb.append("- ").append(linker.markdown(name, type)).append(text.isEmpty() ? "" : " — " + text).append('\n'));
+            sb.append('\n');
+        }
+        return sb.toString();
+    }
+
+    private static String tag(Optional<Javadoc> javadoc, JavadocBlockTag.Type kind, String name) {
+        if (javadoc.isEmpty()) {
+            return "";
+        }
+        for (var tag : javadoc.get().getBlockTags()) {
+            if (tag.getType() == kind && (name == null || tag.getName().map(name::equals).orElse(false))) {
+                return Markdown.tagText(tag);
+            }
+        }
+        return "";
+    }
+
+    private static String nestedSection(TypeInfo type, Linker linker) {
+        var children = linker.children(type);
+        if (children.isEmpty()) {
+            return "";
+        }
+        var sb = new StringBuilder("## Nested types\n\n");
+        for (var child : children) {
+            sb.append("- ").append(Markdown.link(Markdown.code(child.displayName()), child.url())).append(" (").append(child.kind()).append(')');
+            var summary = Markdown.summary(child.decl().getJavadoc());
+            if (!summary.isEmpty()) {
+                sb.append(" — ").append(summary);
+            }
+            sb.append('\n');
+        }
+        return sb.append('\n').toString();
+    }
+
+    private static String sourceSection(TypeInfo type, String sourceBaseUrl) {
+        var path = JavaSources.sourcePath(type.cu());
+        if (path == null) {
+            return "";
+        }
+        var line = type.decl().getBegin().map(p -> p.line).orElse(0);
+        var label = line > 0 ? path + ":" + line : path;
+        var url = sourceBaseUrl + "/" + path + (line > 0 ? "#L" + line : "");
+        return "## Source\n\n" + Markdown.link(label, url) + "\n";
+    }
+
+    // --- Lombok -----------------------------------------------------------------------------
+
+    /** Simple names of the Lombok (or any) annotations on a node. */
+    private static Set<String> lombok(NodeWithAnnotations<?> node) {
+        return node.getAnnotations().stream().map(a -> a.getName().getIdentifier()).collect(Collectors.toSet());
+    }
+
+    private static boolean accessLevelNone(NodeWithAnnotations<?> node, String annotation) {
+        return node.getAnnotations().stream()
+                .anyMatch(a -> a.getName().getIdentifier().equals(annotation) && a.toString().contains("NONE"));
+    }
+
+}
diff --git a/docs/tools/src/main/java/docs/ContentCheck.java b/docs/tools/src/main/java/docs/ContentCheck.java
new file mode 100644
index 00000000..4e45571a
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ContentCheck.java
@@ -0,0 +1,573 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import com.github.javaparser.ast.CompilationUnit;
+import com.github.javaparser.ast.PackageDeclaration;
+import com.github.javaparser.ast.body.ClassOrInterfaceDeclaration;
+import com.github.javaparser.ast.body.MethodDeclaration;
+import com.github.javaparser.ast.body.TypeDeclaration;
+import com.github.javaparser.ast.expr.AnnotationExpr;
+import com.github.javaparser.ast.expr.Expression;
+import java.io.IOException;
+import java.io.PrintStream;
+import java.io.UncheckedIOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.TreeMap;
+import java.util.TreeSet;
+import java.util.regex.Pattern;
+import java.util.stream.Stream;
+
+/**
+ * The {@code check} command: verifies that the authored pages cover the library (events, each with a section on a
+ * grouped events page, settings, handlers, exceptions, extensions), reference no Discord link, agree with the
+ * README's events list and resolve its hosted links, and that every Java example compiles.
+ */
+final class ContentCheck {
+
+    static final List<String> SECTIONS = List.of("events", "settings", "builder", "exceptions", "extensions", "discord", "readme", "examples");
+    static final List<String> EXTENSIONS = List.of("TikTokLiveRecorder", "TikTokLiveCollector");
+    static final String EVENTS_PACKAGE = "io.github.jwdeveloper.tiktok.api.data.events";
+    static final String EXCEPTIONS_PACKAGE = "io.github.jwdeveloper.tiktok.api.exceptions";
+    static final String EVENTS_BUILDER = "io.github.jwdeveloper.tiktok.api.live.builder.EventsBuilder";
+    static final String LIVE_CLIENT = "io.github.jwdeveloper.tiktok.api.live.LiveClient";
+    static final List<String> SETTINGS_CLASSES = List.of("io.github.jwdeveloper.tiktok.api.data.settings.LiveClientSettings",
+            "io.github.jwdeveloper.tiktok.api.data.settings.HttpClientSettings");
+    static final String CATALOG_PAGE = "events/index.md";
+    /** The directory of the grouped event pages, each event's {@code ## <EventClassName>} section lives on one of them. */
+    static final String EVENTS_DIR = "events/";
+    /** Category of an event class under the events package that carries no {@code @EventMeta}. */
+    static final String NO_CATEGORY = "none";
+    /** Generated directories under the content root; their pages are not authored documentation. */
+    static final Set<String> GENERATED_DIRS = Set.of("api", "schema");
+    /** The site's origin: the README's hosted links start with it and are resolved against the authored pages. */
+    static final String SITE = "https://ttlj.docs.isaackogan.com/";
+
+    private static final Pattern CATALOG_ROW = Pattern.compile("^\\s*\\|\\s*`(\\w+)`\\s*\\|\\s*(\\w+)\\s*\\|", Pattern.MULTILINE);
+    private static final Pattern README_ITEM = Pattern.compile("^\\s*-\\s+\\[(on\\w+)]\\(#([\\w-]+)\\)", Pattern.MULTILINE);
+    private static final Pattern EVENTS_HEADING = Pattern.compile("^##\\s+Events\\s*$", Pattern.MULTILINE);
+    /** A level-1 or level-2 heading other than a repeated {@code ## Events}: where the README's events list ends. */
+    private static final Pattern NEXT_SECTION = Pattern.compile("^#{1,2}\\s+(?!Events\\s*$).*$", Pattern.MULTILINE);
+    private static final Pattern SITE_LINK = Pattern.compile(Pattern.quote(SITE) + "([\\w./-]*)(?:#([\\w-]+))?");
+    private static final Pattern EVENT_HEADING = Pattern.compile("^##\\s+`?(\\w+)`?\\s*$", Pattern.MULTILINE);
+    private static final Pattern HEADING = Pattern.compile("^#{1,6}\\s+(.+?)\\s*$", Pattern.MULTILINE);
+    private static final Pattern DISCORD = Pattern.compile("(?i)discord\\.(com|gg)");
+    private static final Pattern FENCE_OPEN = Pattern.compile("^\\s*(`{3,}|~{3,})\\s*(\\w*)(.*)$");
+    private static final Pattern FENCE_CLOSE = Pattern.compile("^\\s*(`{3,}|~{3,})\\s*$");
+
+    private ContentCheck() {}
+
+    /** An authored page: its path relative to the content root with {@code /} separators, and its text. */
+    record Page(String path, String text) {}
+
+    // --- command ------------------------------------------------------------------------------
+
+    /** Prints one line per section in order, then the summary; returns 1 when any section failed. */
+    static int run(Path repoRoot, PrintStream out) {
+        var units = JavaSources.load(repoRoot);
+        var events = events(units);
+        var settings = settingsFields(units);
+        var handlers = handlers(units);
+        var exceptions = exceptions(units);
+        var pages = pages(repoRoot.resolve(Main.CONTENT_DIR));
+        var examples = examples(pages);
+        var exampleFailures = new ArrayList<>(unclosedFences(pages));
+        var results = new LinkedHashMap<String, List<String>>();
+        results.put("events", checkEvents(events, pages));
+        results.put("settings", checkNames("settings field", settings, pages));
+        results.put("builder", checkNames("handler", handlers, pages));
+        results.put("exceptions", checkNames("exception", exceptions, pages));
+        results.put("extensions", checkNames("extension", EXTENSIONS, pages));
+        results.put("discord", checkDiscord(pages));
+        var readme = read(repoRoot.resolve("README.md"));
+        var readmeFailures = new ArrayList<>(checkReadme(readme, builderHandlers(units), eventClassNames(units)));
+        readmeFailures.addAll(checkReadmeLinks(readme, pages));
+        results.put("readme", readmeFailures);
+        exampleFailures.addAll(ExampleCompiler.compile(examples, repoRoot, ExampleCompiler.packages(units)));
+        results.put("examples", exampleFailures);
+        var failed = false;
+        for (var section : SECTIONS) {
+            var failures = results.get(section);
+            if (failures.isEmpty()) {
+                out.println("PASS " + section);
+            } else {
+                failed = true;
+                out.println("FAIL " + section + ": " + String.join("; ", failures.subList(0, Math.min(3, failures.size()))));
+            }
+        }
+        out.println("Checked " + pages.size() + " pages, " + events.size() + " events, " + settings.size() + " settings fields, "
+                + handlers.size() + " handlers, " + exceptions.size() + " exceptions, " + examples.size() + " Java examples.");
+        return failed ? 1 : 0;
+    }
+
+    // --- extraction ---------------------------------------------------------------------------
+
+    /** Concrete event class → {@code @EventMeta} category ({@code Control}, {@code Message}, {@code Debug}) or {@code none}. */
+    static Map<String, String> events(Path repoRoot) {
+        return events(JavaSources.load(repoRoot));
+    }
+
+    static Map<String, String> events(List<CompilationUnit> units) {
+        var events = new TreeMap<String, String>();
+        for (var type : eventTypes(units)) {
+            if (type instanceof ClassOrInterfaceDeclaration c && !c.isInterface() && !c.isAbstract()) {
+                events.put(c.getNameAsString(), c.getAnnotationByName("EventMeta").map(ContentCheck::category).orElse(NO_CATEGORY));
+            }
+        }
+        return events;
+    }
+
+    /** Every top-level type under the events package, abstract base classes included: what a README anchor may name. */
+    static Set<String> eventClassNames(Path repoRoot) {
+        return eventClassNames(JavaSources.load(repoRoot));
+    }
+
+    static Set<String> eventClassNames(List<CompilationUnit> units) {
+        var names = new TreeSet<String>();
+        for (var type : eventTypes(units)) {
+            names.add(type.getNameAsString());
+        }
+        return names;
+    }
+
+    /** Instance fields of {@code LiveClientSettings} and {@code HttpClientSettings}, in declaration order. */
+    static List<String> settingsFields(Path repoRoot) {
+        return settingsFields(JavaSources.load(repoRoot));
+    }
+
+    static List<String> settingsFields(List<CompilationUnit> units) {
+        var fields = new ArrayList<String>();
+        for (var name : SETTINGS_CLASSES) {
+            for (var field : type(units, name).getFields()) {
+                if (!field.isStatic()) {
+                    for (var variable : field.getVariables()) {
+                        fields.add(variable.getNameAsString());
+                    }
+                }
+            }
+        }
+        return fields;
+    }
+
+    /** Distinct names of the public {@code on*} methods of {@code EventsBuilder}, in declaration order. */
+    static List<String> builderHandlers(Path repoRoot) {
+        return builderHandlers(JavaSources.load(repoRoot));
+    }
+
+    static List<String> builderHandlers(List<CompilationUnit> units) {
+        return publicMethods(type(units, EVENTS_BUILDER), true);
+    }
+
+    /** {@link #builderHandlers} followed by the distinct public methods of {@code LiveClient}. */
+    static List<String> handlers(Path repoRoot) {
+        return handlers(JavaSources.load(repoRoot));
+    }
+
+    static List<String> handlers(List<CompilationUnit> units) {
+        var handlers = new LinkedHashSet<>(builderHandlers(units));
+        handlers.addAll(publicMethods(type(units, LIVE_CLIENT), false));
+        return new ArrayList<>(handlers);
+    }
+
+    /** Names of the top-level types under the exceptions package, sorted. */
+    static List<String> exceptions(Path repoRoot) {
+        return exceptions(JavaSources.load(repoRoot));
+    }
+
+    static List<String> exceptions(List<CompilationUnit> units) {
+        var names = new TreeSet<String>();
+        for (var unit : units) {
+            if (packageOf(unit).equals(EXCEPTIONS_PACKAGE)) {
+                for (var type : unit.getTypes()) {
+                    names.add(type.getNameAsString());
+                }
+            }
+        }
+        return new ArrayList<>(names);
+    }
+
+    private static List<TypeDeclaration<?>> eventTypes(List<CompilationUnit> units) {
+        var types = new ArrayList<TypeDeclaration<?>>();
+        for (var unit : units) {
+            var pkg = packageOf(unit);
+            if (pkg.equals(EVENTS_PACKAGE) || pkg.startsWith(EVENTS_PACKAGE + ".")) {
+                types.addAll(unit.getTypes());
+            }
+        }
+        return types;
+    }
+
+    /** {@code EventType.Message} → {@code Message}; an {@code @EventMeta} without the member is {@code none}. */
+    private static String category(AnnotationExpr annotation) {
+        Expression value = null;
+        if (annotation.isNormalAnnotationExpr()) {
+            for (var pair : annotation.asNormalAnnotationExpr().getPairs()) {
+                if (pair.getNameAsString().equals("eventType")) {
+                    value = pair.getValue();
+                }
+            }
+        } else if (annotation.isSingleMemberAnnotationExpr()) {
+            value = annotation.asSingleMemberAnnotationExpr().getMemberValue();
+        }
+        if (value == null) {
+            return NO_CATEGORY;
+        }
+        var text = value.toString();
+        return text.substring(text.lastIndexOf('.') + 1);
+    }
+
+    private static List<String> publicMethods(TypeDeclaration<?> type, boolean onlyHandlers) {
+        var isInterface = type instanceof ClassOrInterfaceDeclaration c && c.isInterface();
+        var names = new LinkedHashSet<String>();
+        for (MethodDeclaration method : type.getMethods()) {
+            var isPublic = method.isPublic() || (isInterface && !method.isPrivate());
+            var name = method.getNameAsString();
+            if (isPublic && (!onlyHandlers || (name.startsWith("on") && name.length() > 2 && Character.isUpperCase(name.charAt(2))))) {
+                names.add(name);
+            }
+        }
+        return new ArrayList<>(names);
+    }
+
+    private static TypeDeclaration<?> type(List<CompilationUnit> units, String qualifiedName) {
+        var dot = qualifiedName.lastIndexOf('.');
+        var pkg = qualifiedName.substring(0, dot);
+        var name = qualifiedName.substring(dot + 1);
+        for (var unit : units) {
+            if (packageOf(unit).equals(pkg)) {
+                for (var type : unit.getTypes()) {
+                    if (type.getNameAsString().equals(name)) {
+                        return type;
+                    }
+                }
+            }
+        }
+        throw new IllegalStateException("missing type " + qualifiedName);
+    }
+
+    private static String packageOf(CompilationUnit unit) {
+        return unit.getPackageDeclaration().map(PackageDeclaration::getNameAsString).orElse("");
+    }
+
+    // --- pages --------------------------------------------------------------------------------
+
+    /** Every {@code .md}/{@code .mdx} page under the content root except the generated {@code api/} and {@code schema/} trees. */
+    static List<Page> pages(Path contentDir) {
+        if (!Files.isDirectory(contentDir)) {
+            throw new IllegalStateException("missing content directory " + contentDir);
+        }
+        var pages = new ArrayList<Page>();
+        try (Stream<Path> walk = Files.walk(contentDir)) {
+            for (var path : walk.filter(Files::isRegularFile).sorted().toList()) {
+                var relative = contentDir.relativize(path);
+                var name = relative.getFileName().toString();
+                if (!(name.endsWith(".md") || name.endsWith(".mdx")) || GENERATED_DIRS.contains(relative.getName(0).toString())) {
+                    continue;
+                }
+                var parts = new ArrayList<String>();
+                relative.forEach(p -> parts.add(p.toString()));
+                pages.add(new Page(String.join("/", parts), Files.readString(path)));
+            }
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        return pages;
+    }
+
+    /** Every {@code ```java} fence of every page, dedented, labelled "{@code <page>, example <n>}". */
+    static List<Example> examples(List<Page> pages) {
+        var examples = new ArrayList<Example>();
+        for (var page : pages) {
+            var n = 0;
+            for (var body : fences(page.text(), "java")) {
+                examples.add(new Example(page.path() + ", example " + ++n, body));
+            }
+        }
+        return examples;
+    }
+
+    /** The dedented bodies of the closed fences with the given language (compared ignoring case), at any indentation. */
+    static List<String> fences(String text, String language) {
+        var bodies = new ArrayList<String>();
+        for (var fence : scan(text)) {
+            if (fence.closed() && fence.language().equalsIgnoreCase(language)) {
+                bodies.add(dedent(fence.body()));
+            }
+        }
+        return bodies;
+    }
+
+    /** One failure per fence that is never closed: Markdown renders the rest of the page as code, and no example compiles. */
+    static List<String> unclosedFences(List<Page> pages) {
+        var failures = new ArrayList<String>();
+        for (var page : pages) {
+            for (var fence : scan(page.text())) {
+                if (!fence.closed()) {
+                    failures.add(page.path() + ": the fence opened at line " + fence.line() + " is never closed");
+                }
+            }
+        }
+        return failures;
+    }
+
+    /** One fenced block: its language tag, body lines, the line number of its opening fence, and whether it was closed. */
+    private record Fence(String language, List<String> body, int line, boolean closed) {}
+
+    private static List<Fence> scan(String text) {
+        var fences = new ArrayList<Fence>();
+        String fence = null;
+        String lang = null;
+        var openLine = 0;
+        var body = new ArrayList<String>();
+        var lines = text.split("\n", -1);
+        for (int i = 0; i < lines.length; i++) {
+            var line = lines[i];
+            if (fence == null) {
+                var open = FENCE_OPEN.matcher(line);
+                if (open.matches()) {
+                    fence = open.group(1);
+                    lang = open.group(2);
+                    openLine = i + 1;
+                    body = new ArrayList<>();
+                }
+                continue;
+            }
+            var close = FENCE_CLOSE.matcher(line);
+            if (close.matches() && close.group(1).charAt(0) == fence.charAt(0) && close.group(1).length() >= fence.length()) {
+                fences.add(new Fence(lang, body, openLine, true));
+                fence = null;
+                continue;
+            }
+            body.add(line);
+        }
+        if (fence != null) {
+            fences.add(new Fence(lang, body, openLine, false));
+        }
+        return fences;
+    }
+
+    private static String dedent(List<String> lines) {
+        var indent = Integer.MAX_VALUE;
+        for (var line : lines) {
+            if (!line.isBlank()) {
+                indent = Math.min(indent, line.length() - line.stripLeading().length());
+            }
+        }
+        var out = new ArrayList<String>();
+        for (var line : lines) {
+            out.add(line.isBlank() ? "" : line.substring(indent));
+        }
+        return String.join("\n", out).stripTrailing();
+    }
+
+    // --- rules --------------------------------------------------------------------------------
+
+    /**
+     * Every event is named in backticks on some page, has a catalog row whose type equals its category, and has a
+     * {@code ## <EventClassName>} section on a grouped page under {@code events/} other than the catalog: the
+     * README's hosted anchors point at those headings.
+     */
+    static List<String> checkEvents(Map<String, String> events, List<Page> pages) {
+        var failures = new ArrayList<String>();
+        var catalog = pages.stream().filter(p -> p.path().equals(CATALOG_PAGE)).findFirst().map(Page::text).orElse(null);
+        if (catalog == null) {
+            failures.add("Event catalog page missing: " + CATALOG_PAGE);
+        }
+        var rows = new HashMap<String, String>();
+        var m = CATALOG_ROW.matcher(catalog == null ? "" : catalog);
+        while (m.find()) {
+            if (rows.putIfAbsent(m.group(1), m.group(2)) != null) {
+                failures.add("Event catalog row duplicated: " + m.group(1));
+            }
+        }
+        var headings = new HashSet<String>();
+        for (var page : pages) {
+            if (page.path().startsWith(EVENTS_DIR) && !page.path().equals(CATALOG_PAGE)) {
+                var h = EVENT_HEADING.matcher(page.text());
+                while (h.find()) {
+                    headings.add(h.group(1));
+                }
+            }
+        }
+        for (var entry : new TreeMap<>(events).entrySet()) {
+            var name = entry.getKey();
+            if (!mentioned(name, pages)) {
+                failures.add("Missing event documentation: " + name);
+            }
+            if (!headings.contains(name)) {
+                failures.add("Event section heading missing: " + name);
+            }
+            var type = rows.get(name);
+            if (type == null) {
+                failures.add("Event catalog row missing: " + name);
+            } else if (!type.equals(entry.getValue())) {
+                failures.add("Event catalog row is stale: " + name);
+            }
+        }
+        return failures;
+    }
+
+    /** Every name is mentioned in backticks on some page; {@code kind} names the failure. */
+    static List<String> checkNames(String kind, Collection<String> names, List<Page> pages) {
+        var failures = new ArrayList<String>();
+        for (var name : names) {
+            if (!mentioned(name, pages)) {
+                failures.add("Missing " + kind + " documentation: " + name);
+            }
+        }
+        return failures;
+    }
+
+    /** No authored page links to Discord. */
+    static List<String> checkDiscord(List<Page> pages) {
+        var failures = new ArrayList<String>();
+        for (var page : pages) {
+            if (DISCORD.matcher(page.text()).find()) {
+                failures.add(page.path() + ": published pages must not reference Discord");
+            }
+        }
+        return failures;
+    }
+
+    /**
+     * Every {@code - [onX](#onx-tiktokxevent)} item of the README's events list, whatever follows the link, names an
+     * event class (the anchor's last segment, compared case-insensitively) and an {@code EventsBuilder} handler.
+     */
+    static List<String> checkReadme(String readme, Collection<String> builderHandlers, Collection<String> eventClasses) {
+        var lower = new HashMap<String, String>();
+        for (var name : eventClasses) {
+            lower.put(name.toLowerCase(Locale.ROOT), name);
+        }
+        var failures = new LinkedHashSet<String>();
+        var m = README_ITEM.matcher(eventsSection(readme));
+        while (m.find()) {
+            var handler = m.group(1);
+            var anchor = m.group(2);
+            var event = anchor.substring(anchor.lastIndexOf('-') + 1);
+            if (!lower.containsKey(event.toLowerCase(Locale.ROOT))) {
+                failures.add("README handler has no event class: " + handler);
+            }
+            if (!builderHandlers.contains(handler)) {
+                failures.add("README handler is not on EventsBuilder: " + handler);
+            }
+        }
+        return new ArrayList<>(failures);
+    }
+
+    /**
+     * The README's events list: from its {@code ## Events} heading to the next level-1 or level-2 heading with another
+     * title (a repeated {@code ## Events} does not end it), or the whole text when it has no such heading.
+     */
+    static String eventsSection(String readme) {
+        var heading = EVENTS_HEADING.matcher(readme);
+        if (!heading.find()) {
+            return readme;
+        }
+        var next = NEXT_SECTION.matcher(readme);
+        next.region(heading.end(), readme.length());
+        return next.find() ? readme.substring(heading.start(), next.start()) : readme.substring(heading.start());
+    }
+
+    /**
+     * Every hosted link in the README, {@code https://ttlj.docs.isaackogan.com/<path>#<fragment>}, names an authored
+     * page ({@code <path>.md} or {@code <path>/index.md}; {@code /} is {@code index.md}) and, when it has a fragment,
+     * a heading on that page whose slug equals it: lowercase, each run of non-alphanumerics one hyphen, as the README
+     * anchors are written.
+     */
+    static List<String> checkReadmeLinks(String readme, List<Page> pages) {
+        var byPath = new HashMap<String, Page>();
+        for (var page : pages) {
+            byPath.put(page.path(), page);
+        }
+        var failures = new LinkedHashSet<String>();
+        var m = SITE_LINK.matcher(readme);
+        while (m.find()) {
+            var fragment = m.group(2);
+            var url = SITE + m.group(1) + (fragment == null ? "" : "#" + fragment);
+            var page = page(byPath, m.group(1).replaceAll("/+$", ""));
+            if (page == null) {
+                failures.add("README link has no page: " + url);
+            } else if (fragment != null && !slugs(page.text()).contains(fragment)) {
+                failures.add("README link has no heading: " + url);
+            }
+        }
+        return new ArrayList<>(failures);
+    }
+
+    private static Page page(Map<String, Page> byPath, String path) {
+        if (path.isEmpty()) {
+            return byPath.get("index.md");
+        }
+        for (var candidate : List.of(path + ".md", path + ".mdx", path + "/index.md", path + "/index.mdx")) {
+            var page = byPath.get(candidate);
+            if (page != null) {
+                return page;
+            }
+        }
+        return null;
+    }
+
+    /** The slug of every heading on a page. */
+    static Set<String> slugs(String text) {
+        var slugs = new HashSet<String>();
+        var m = HEADING.matcher(text);
+        while (m.find()) {
+            slugs.add(slug(m.group(1)));
+        }
+        return slugs;
+    }
+
+    /** Starlight's anchor for a heading: lowercase, each run of non-alphanumerics one hyphen, none at the ends. */
+    static String slug(String heading) {
+        return heading.toLowerCase(Locale.ROOT).replaceAll("[^a-z0-9]+", "-").replaceAll("^-+|-+$", "");
+    }
+
+    private static boolean mentioned(String name, List<Page> pages) {
+        var span = "`" + name + "`";
+        for (var page : pages) {
+            if (page.text().contains(span)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private static String read(Path file) {
+        try {
+            return Files.readString(file);
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+    }
+}
diff --git a/docs/tools/src/main/java/docs/Example.java b/docs/tools/src/main/java/docs/Example.java
new file mode 100644
index 00000000..10c11fc5
--- /dev/null
+++ b/docs/tools/src/main/java/docs/Example.java
@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+/** One {@code ```java} fence from an authored page: {@code label} is "{@code <page>, example <n>}", {@code code} the dedented body. */
+record Example(String label, String code) {}
diff --git a/docs/tools/src/main/java/docs/ExampleCompiler.java b/docs/tools/src/main/java/docs/ExampleCompiler.java
new file mode 100644
index 00000000..aa85f9d2
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ExampleCompiler.java
@@ -0,0 +1,368 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import com.github.javaparser.ast.CompilationUnit;
+import com.github.javaparser.ast.PackageDeclaration;
+import java.io.File;
+import java.io.IOException;
+import java.io.StringWriter;
+import java.io.UncheckedIOException;
+import java.net.URI;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.TreeSet;
+import java.util.regex.Pattern;
+import java.util.stream.Stream;
+import javax.tools.Diagnostic;
+import javax.tools.DiagnosticCollector;
+import javax.tools.JavaCompiler;
+import javax.tools.JavaFileObject;
+import javax.tools.SimpleJavaFileObject;
+import javax.tools.StandardLocation;
+import javax.tools.ToolProvider;
+
+/**
+ * Compiles the Java examples of the authored pages against the built library. A fence that declares a top-level
+ * type is compiled as-is (its own imports, a file named after its public type); any other fence is a fragment,
+ * wrapped in a method with a wildcard import of every library package. A canary fragment with a misspelled
+ * method is always compiled and must be flagged, so a broken classpath cannot make the check pass vacuously.
+ */
+final class ExampleCompiler {
+
+    /** The modules whose {@code target/classes} and {@code target/classpath.txt} form the compile classpath. */
+    static final List<String> MODULES = List.of("API", "Client", "extension-recorder", "extension-collector");
+    /** The command, run from the repository root, that produces every file the compiler reads. */
+    static final String BUILD_COMMAND = "mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests install"
+            + " dependency:build-classpath -Dmdep.outputFile=target/classpath.txt";
+    static final String CANARY_LABEL = "canary";
+    static final String CANARY = "TikTokLive.newClient(\"x\").onComment((c, e) -> e.getComent());";
+    static final String CANARY_NOT_FLAGGED = "example compiler canary not flagged";
+    /** JDK packages imported into every fragment besides the library's own. */
+    static final List<String> JDK_PACKAGES = List.of("java.util", "java.time", "java.util.function", "java.util.logging", "java.io");
+
+    private static final Pattern TYPE_DECLARATION = Pattern.compile("^(public\\s+)?(final\\s+|abstract\\s+)?(class|interface|record|enum)\\s+(\\w+)");
+    private static final Pattern PUBLIC_TYPE = Pattern.compile("^public\\s+(final\\s+|abstract\\s+)?(class|interface|record|enum)\\s+(\\w+)");
+    private static final Pattern PACKAGE = Pattern.compile("^\\s*package\\s+([\\w.]+)\\s*;");
+    private static final Pattern IMPORT = Pattern.compile("^\\s*import\\s+(static\\s+)?[\\w.]+(\\.\\*)?\\s*;\\s*$");
+
+    private ExampleCompiler() {}
+
+    /**
+     * One source file handed to javac: which example it came from, the package-qualified types it declares (no two
+     * files of one batch may share one), how many wrapper lines precede its body, and for a fragment the wrapper line
+     * of each hoisted {@code import} mapped to the body line it came from.
+     */
+    private record Unit(Example example, Set<String> keys, Source source, int offset, int bodyLines, Map<Integer, Integer> hoisted) {}
+
+    private static final class Source extends SimpleJavaFileObject {
+        private final String code;
+
+        Source(String path, String code) {
+            super(URI.create("string:///" + path), Kind.SOURCE);
+            this.code = code;
+        }
+
+        @Override
+        public CharSequence getCharContent(boolean ignoreEncodingErrors) {
+            return code;
+        }
+    }
+
+    /** Compiles the examples; returns one failure line per compiler error, or the reason the compiler could not run. */
+    static List<String> compile(List<Example> examples, Path repoRoot) {
+        return compile(examples, repoRoot, packages(JavaSources.load(repoRoot)));
+    }
+
+    /** As {@link #compile(List, Path)} with the library packages already known. */
+    static List<String> compile(List<Example> examples, Path repoRoot, Collection<String> packages) {
+        List<Path> classpath;
+        try {
+            classpath = classpath(repoRoot);
+        } catch (IllegalStateException e) {
+            return List.of(e.getMessage());
+        }
+        var compiler = ToolProvider.getSystemJavaCompiler();
+        if (compiler == null) {
+            return List.of("no system Java compiler: run the docs tool on a JDK, not a JRE");
+        }
+        var units = new ArrayList<Unit>();
+        units.add(unit(new Example(CANARY_LABEL, CANARY), 0, packages));
+        for (int i = 0; i < examples.size(); i++) {
+            units.add(unit(examples.get(i), i + 1, packages));
+        }
+        var failures = new ArrayList<String>();
+        var canaryFlagged = false;
+        Path outDir;
+        try {
+            outDir = Files.createTempDirectory("docs-examples");
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        try {
+            for (var batch : batches(units)) {
+                var byUri = new HashMap<String, Unit>();
+                for (var unit : batch) {
+                    byUri.put(unit.source().toUri().toString(), unit);
+                }
+                for (var d : run(compiler, classpath, outDir, batch)) {
+                    if (d.getKind() != Diagnostic.Kind.ERROR) {
+                        continue;
+                    }
+                    var message = oneLine(d.getMessage(Locale.ROOT));
+                    var unit = d.getSource() == null ? null : byUri.get(d.getSource().toUri().toString());
+                    if (unit == null) {
+                        failures.add("javac: " + message);
+                    } else if (unit.example().label().equals(CANARY_LABEL)) {
+                        canaryFlagged |= message.contains("getComent");
+                    } else {
+                        failures.add(unit.example().label() + ": line " + line(d, unit) + ": " + message);
+                    }
+                }
+            }
+        } finally {
+            delete(outDir);
+        }
+        if (!canaryFlagged) {
+            failures.add(0, CANARY_NOT_FLAGGED);
+        }
+        return failures;
+    }
+
+    /** Every package declared by the parsed library sources, sorted. */
+    static Set<String> packages(List<CompilationUnit> units) {
+        var packages = new TreeSet<String>();
+        for (var unit : units) {
+            unit.getPackageDeclaration().map(PackageDeclaration::getNameAsString).ifPresent(packages::add);
+        }
+        return packages;
+    }
+
+    /** True when the fence declares a top-level type and so compiles as its own file. */
+    static boolean isFullUnit(String code) {
+        return code.lines().anyMatch(line -> TYPE_DECLARATION.matcher(line).find());
+    }
+
+    // --- classpath ----------------------------------------------------------------------------
+
+    private static List<Path> classpath(Path repoRoot) {
+        var classpath = new LinkedHashSet<Path>();
+        var missing = new ArrayList<String>();
+        for (var module : MODULES) {
+            var classes = repoRoot.resolve(module).resolve("target").resolve("classes");
+            var file = repoRoot.resolve(module).resolve("target").resolve("classpath.txt");
+            if (Files.isDirectory(classes)) {
+                classpath.add(classes);
+            } else {
+                missing.add(module + "/target/classes");
+            }
+            if (!Files.isRegularFile(file)) {
+                missing.add(module + "/target/classpath.txt");
+                continue;
+            }
+            String text;
+            try {
+                text = Files.readString(file);
+            } catch (IOException e) {
+                throw new UncheckedIOException(e);
+            }
+            for (var entry : text.split("[" + File.pathSeparator + "\\r\\n]+")) {
+                if (!entry.isBlank()) {
+                    classpath.add(Path.of(entry.strip()));
+                }
+            }
+        }
+        if (!missing.isEmpty()) {
+            throw new IllegalStateException("missing " + String.join(", ", missing)
+                    + "; build the library first, from the repository root: " + BUILD_COMMAND);
+        }
+        return new ArrayList<>(classpath);
+    }
+
+    // --- sources ------------------------------------------------------------------------------
+
+    private static Unit unit(Example example, int index, Collection<String> packages) {
+        var code = example.code();
+        var dir = "ex" + index + "/";
+        if (isFullUnit(code)) {
+            var name = declaredType(code);
+            var source = code.endsWith("\n") ? code : code + "\n";
+            var keys = new HashSet<String>();
+            for (var declared : declaredTypes(code)) {
+                keys.add(packageOf(code) + "/" + declared);
+            }
+            return new Unit(example, keys, new Source(dir + name + ".java", source), 0, (int) code.lines().count(), Map.of());
+        }
+        var imports = new LinkedHashSet<String>();
+        for (var pkg : packages) {
+            imports.add("import " + pkg + ".*;");
+        }
+        for (var pkg : JDK_PACKAGES) {
+            imports.add("import " + pkg + ".*;");
+        }
+        var hoistedLines = new LinkedHashMap<String, Integer>();
+        var body = new StringBuilder();
+        var bodyLines = 0;
+        for (var line : code.split("\n", -1)) {
+            if (IMPORT.matcher(line).matches()) {
+                imports.add(line.strip());
+                hoistedLines.putIfAbsent(line.strip(), bodyLines + 1);
+                line = "";
+            }
+            body.append(line).append('\n');
+            bodyLines++;
+        }
+        var name = "Example" + index;
+        var source = new StringBuilder();
+        var ordered = new ArrayList<>(imports);
+        for (var line : ordered) {
+            source.append(line).append('\n');
+        }
+        var hoisted = new HashMap<Integer, Integer>();
+        hoistedLines.forEach((statement, bodyLine) -> hoisted.put(ordered.indexOf(statement) + 1, bodyLine));
+        source.append("public class ").append(name).append(" {\n");
+        source.append("    void run() throws Exception {\n");
+        source.append(body);
+        source.append("    }\n}\n");
+        return new Unit(example, Set.of("/" + name), new Source(dir + name + ".java", source.toString()), imports.size() + 2, bodyLines, hoisted);
+    }
+
+    /** Every top-level type a full unit declares, the public one and any package-private helpers. */
+    private static List<String> declaredTypes(String code) {
+        var names = new ArrayList<String>();
+        for (var line : code.split("\n")) {
+            var m = TYPE_DECLARATION.matcher(line);
+            if (m.find()) {
+                names.add(m.group(4));
+            }
+        }
+        return names;
+    }
+
+    /** The declared package of a full unit, or an empty string for the default package. */
+    private static String packageOf(String code) {
+        for (var line : code.split("\n")) {
+            var m = PACKAGE.matcher(line);
+            if (m.find()) {
+                return m.group(1);
+            }
+        }
+        return "";
+    }
+
+    /** The public top-level type's name, else the first declared type's: the file must be named after it. */
+    private static String declaredType(String code) {
+        for (var line : code.split("\n")) {
+            var m = PUBLIC_TYPE.matcher(line);
+            if (m.find()) {
+                return m.group(3);
+            }
+        }
+        for (var line : code.split("\n")) {
+            var m = TYPE_DECLARATION.matcher(line);
+            if (m.find()) {
+                return m.group(4);
+            }
+        }
+        throw new IllegalArgumentException("no type declaration");
+    }
+
+    /** Splits the units into batches in which no two files declare the same package-qualified type, helpers included. */
+    private static List<List<Unit>> batches(List<Unit> units) {
+        var batches = new ArrayList<List<Unit>>();
+        var keys = new ArrayList<Set<String>>();
+        for (var unit : units) {
+            int i = 0;
+            while (i < batches.size() && !Collections.disjoint(keys.get(i), unit.keys())) {
+                i++;
+            }
+            if (i == batches.size()) {
+                batches.add(new ArrayList<>());
+                keys.add(new HashSet<>());
+            }
+            batches.get(i).add(unit);
+            keys.get(i).addAll(unit.keys());
+        }
+        return batches;
+    }
+
+    // --- javac --------------------------------------------------------------------------------
+
+    private static List<Diagnostic<? extends JavaFileObject>> run(JavaCompiler compiler, List<Path> classpath, Path outDir, List<Unit> batch) {
+        var diagnostics = new DiagnosticCollector<JavaFileObject>();
+        var sources = new ArrayList<JavaFileObject>();
+        for (var unit : batch) {
+            sources.add(unit.source());
+        }
+        try (var fileManager = compiler.getStandardFileManager(diagnostics, Locale.ROOT, StandardCharsets.UTF_8)) {
+            fileManager.setLocationFromPaths(StandardLocation.CLASS_PATH, classpath);
+            fileManager.setLocationFromPaths(StandardLocation.CLASS_OUTPUT, List.of(outDir));
+            // -Xmaxerrs lifts javac's default cap of 100 errors, so a batch with many broken examples reports them all.
+            var options = List.of("--release", "17", "-proc:none", "-implicit:none", "-Xlint:none", "-Xmaxerrs", "10000");
+            compiler.getTask(new StringWriter(), fileManager, diagnostics, options, null, sources).call();
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        return diagnostics.getDiagnostics();
+    }
+
+    /**
+     * The diagnostic's line relative to the fence body: a hoisted {@code import} maps back to the line it was written on,
+     * and an error on any other wrapper line is clamped into the body.
+     */
+    private static long line(Diagnostic<?> d, Unit unit) {
+        var hoisted = unit.hoisted().get((int) d.getLineNumber());
+        if (hoisted != null) {
+            return hoisted;
+        }
+        var line = d.getLineNumber() - unit.offset();
+        return Math.max(1, Math.min(line, Math.max(1, unit.bodyLines())));
+    }
+
+    private static String oneLine(String message) {
+        return String.join("; ", message.lines().map(String::strip).filter(s -> !s.isEmpty()).toList());
+    }
+
+    private static void delete(Path dir) {
+        try (Stream<Path> walk = Files.walk(dir)) {
+            for (var path : walk.sorted(Comparator.reverseOrder()).toList()) {
+                Files.deleteIfExists(path);
+            }
+        } catch (IOException ignored) {
+            // A leftover temp directory is not worth failing the check over.
+        }
+    }
+}
diff --git a/docs/tools/src/main/java/docs/JavaSources.java b/docs/tools/src/main/java/docs/JavaSources.java
new file mode 100644
index 00000000..475fcd00
--- /dev/null
+++ b/docs/tools/src/main/java/docs/JavaSources.java
@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import com.github.javaparser.ParseProblemException;
+import com.github.javaparser.ParserConfiguration;
+import com.github.javaparser.StaticJavaParser;
+import com.github.javaparser.ast.CompilationUnit;
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Stream;
+
+/** Loads the library's Java sources with JavaParser; nothing is compiled, so Lombok annotations stay annotations. */
+final class JavaSources {
+
+    /** The modules whose {@code src/main/java} trees are documented. */
+    static final List<String> MODULES = List.of("API", "Client");
+
+    private JavaSources() {}
+
+    /** Every {@code .java} file under the documented modules, parsed at language level Java 17, in path order. */
+    static List<CompilationUnit> load(Path repoRoot) {
+        StaticJavaParser.setConfiguration(new ParserConfiguration().setLanguageLevel(ParserConfiguration.LanguageLevel.JAVA_17));
+        var units = new ArrayList<CompilationUnit>();
+        for (var module : MODULES) {
+            var root = repoRoot.resolve(module).resolve("src/main/java");
+            if (!Files.isDirectory(root)) {
+                throw new IllegalStateException("missing source tree " + root);
+            }
+            List<Path> files;
+            try (Stream<Path> walk = Files.walk(root)) {
+                files = walk.filter(p -> p.toString().endsWith(".java")).sorted().toList();
+            } catch (IOException e) {
+                throw new UncheckedIOException(e);
+            }
+            for (var file : files) {
+                try {
+                    units.add(StaticJavaParser.parse(file));
+                } catch (ParseProblemException e) {
+                    throw new IllegalStateException("cannot parse " + file + ": " + e.getProblems(), e);
+                } catch (IOException e) {
+                    throw new UncheckedIOException(e);
+                }
+            }
+        }
+        return units;
+    }
+
+    /** {@code API/src/main/java/io/.../Type.java}: the unit's path from its module directory, or null when unknown. */
+    static String sourcePath(CompilationUnit unit) {
+        var path = unit.getStorage().map(CompilationUnit.Storage::getPath).orElse(null);
+        if (path == null) {
+            return null;
+        }
+        var names = new ArrayList<String>();
+        for (var part : path) {
+            names.add(part.toString());
+        }
+        for (int i = 1; i + 2 < names.size(); i++) {
+            if (names.get(i).equals("src") && names.get(i + 1).equals("main") && names.get(i + 2).equals("java")) {
+                return String.join("/", names.subList(i - 1, names.size()));
+            }
+        }
+        return null;
+    }
+}
diff --git a/docs/tools/src/main/java/docs/Main.java b/docs/tools/src/main/java/docs/Main.java
new file mode 100644
index 00000000..828f8c89
--- /dev/null
+++ b/docs/tools/src/main/java/docs/Main.java
@@ -0,0 +1,146 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import java.io.IOException;
+import java.io.PrintStream;
+import java.io.UncheckedIOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.List;
+import java.util.regex.Pattern;
+import java.util.stream.Stream;
+
+/**
+ * Entry point of the docs tool: {@code generate <repo root>} writes the API and schema reference pages under
+ * {@code docs/src/content/docs}; {@code check <repo root>} validates the authored pages.
+ */
+public final class Main {
+
+    static final String SOURCE_BASE_URL = "https://github.com/jwdeveloper/TikTokLiveJava/blob/master";
+    static final Path CONTENT_DIR = Path.of("docs", "src", "content", "docs");
+    static final Path PROTO_DIR = Path.of("API", "src", "main", "proto");
+    private static final Pattern PARENT_BLOCK = Pattern.compile("(?s)<parent>.*?</parent>");
+    private static final Pattern VERSION = Pattern.compile("<version>\\s*([^<\\s]+)\\s*</version>");
+
+    private Main() {}
+
+    public static void main(String[] args) {
+        System.exit(run(args, System.out, System.err));
+    }
+
+    /** Runs a command; exit code 0 on success, 1 on failure, 2 on usage errors. */
+    static int run(String[] args, PrintStream out, PrintStream err) {
+        if (args.length != 2) {
+            err.println("usage: docs-tools <generate|check> <repository root>");
+            return 2;
+        }
+        var repoRoot = Path.of(args[1]).toAbsolutePath().normalize();
+        switch (args[0]) {
+            case "generate":
+                try {
+                    return generate(repoRoot, out);
+                } catch (RuntimeException e) {
+                    err.println("generate failed: " + e.getMessage());
+                    e.printStackTrace(err);
+                    return 1;
+                }
+            case "check":
+                try {
+                    return ContentCheck.run(repoRoot, out);
+                } catch (RuntimeException e) {
+                    err.println("check failed: " + e.getMessage());
+                    e.printStackTrace(err);
+                    return 1;
+                }
+            default:
+                err.println("unknown command: " + args[0]);
+                return 2;
+        }
+    }
+
+    /** Wipes and rewrites {@code api/} and {@code schema/} under the content directory. */
+    static int generate(Path repoRoot, PrintStream out) {
+        var version = projectVersion(repoRoot.resolve("pom.xml"));
+        var units = JavaSources.load(repoRoot);
+        var protoFiles = protoFiles(repoRoot.resolve(PROTO_DIR));
+        var content = repoRoot.resolve(CONTENT_DIR);
+        var apiDir = content.resolve("api");
+        var schemaDir = content.resolve("schema");
+        wipe(apiDir);
+        wipe(schemaDir);
+        var schemaPages = SchemaPages.render(protoFiles, version, schemaDir);
+        var apiPages = ApiPages.render(units, version, SOURCE_BASE_URL, apiDir, SchemaPages.javaLinks(protoFiles));
+        out.println("Wrote " + apiPages.size() + " API pages to " + apiDir + " and " + schemaPages.size() + " schema pages to " + schemaDir);
+        return 0;
+    }
+
+    /** The project's own {@code <version>} in a pom.xml: the first one outside any {@code <parent>} block. */
+    static String projectVersion(Path pom) {
+        String text;
+        try {
+            text = Files.readString(pom);
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        var m = VERSION.matcher(PARENT_BLOCK.matcher(text).replaceFirst(""));
+        if (!m.find()) {
+            throw new IllegalStateException("no <version> in " + pom);
+        }
+        return m.group(1);
+    }
+
+    private static List<ProtoFile> protoFiles(Path dir) {
+        List<Path> paths;
+        try (Stream<Path> files = Files.list(dir)) {
+            paths = files.filter(p -> p.getFileName().toString().endsWith(".proto")).sorted().toList();
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        if (paths.isEmpty()) {
+            throw new IllegalStateException("no .proto files in " + dir);
+        }
+        var files = new ArrayList<ProtoFile>();
+        for (var path : paths) {
+            files.add(ProtoParser.parse(path));
+        }
+        return files;
+    }
+
+    private static void wipe(Path dir) {
+        try {
+            if (Files.exists(dir)) {
+                try (Stream<Path> walk = Files.walk(dir)) {
+                    for (var path : walk.sorted(Comparator.reverseOrder()).toList()) {
+                        Files.delete(path);
+                    }
+                }
+            }
+            Files.createDirectories(dir);
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+    }
+}
diff --git a/docs/tools/src/main/java/docs/Markdown.java b/docs/tools/src/main/java/docs/Markdown.java
new file mode 100644
index 00000000..3a02a4e0
--- /dev/null
+++ b/docs/tools/src/main/java/docs/Markdown.java
@@ -0,0 +1,425 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import com.github.javaparser.javadoc.Javadoc;
+import com.github.javaparser.javadoc.JavadocBlockTag;
+import com.github.javaparser.javadoc.description.JavadocDescription;
+import com.github.javaparser.javadoc.description.JavadocInlineTag;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+import java.util.Optional;
+import java.util.Set;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+/** Markdown, YAML and Javadoc-to-Markdown helpers shared by the page generators. */
+final class Markdown {
+
+    private static final Pattern PLAIN_YAML = Pattern.compile("[A-Za-z_][A-Za-z0-9_ .()\\-]*[A-Za-z0-9_.)]");
+    private static final Set<String> YAML_RESERVED = Set.of("true", "false", "null", "yes", "no", "on", "off");
+    /** A {@code <} that Markdown would read as the start of an HTML tag. */
+    private static final Pattern TAG_LIKE = Pattern.compile("<(?=[A-Za-z/])");
+    private static final Pattern CODE_SPAN = Pattern.compile("(`[^`]*`)");
+    private static final Pattern FIRST_SENTENCE = Pattern.compile("^(.*?[.!?])(?:\\s|$)");
+    private static final Pattern A_TAG = Pattern.compile("(?is)<a\\s+[^>]*href=\"([^\"]*)\"[^>]*>(.*?)</a>");
+    private static final Pattern CODE_TAG = Pattern.compile("(?is)<(code|tt)>(.*?)</\\1>");
+    private static final Pattern MARKDOWN_LINK = Pattern.compile("\\[([^\\]]*)\\]\\([^)]*\\)");
+    /** A {@code <pre>} or {@code </pre>} tag; group 1 is the slash of a closing tag. */
+    private static final Pattern PRE_TAG = Pattern.compile("(?i)<(/?)pre>");
+    /** Stands in for a {@code <pre>} block while the surrounding text is escaped and tidied; private-use characters survive {@code trim()}. */
+    private static final String PRE_MARK = "\uE000PRE";
+
+    private Markdown() {}
+
+    // --- YAML and Markdown blocks ---------------------------------------------------------
+
+    /** Starlight frontmatter: title, description, sidebar label and an optional sidebar order. */
+    static String frontmatter(String title, String description, String label, Integer order) {
+        var sb = new StringBuilder("---\n");
+        sb.append("title: ").append(yamlScalar(title)).append('\n');
+        sb.append("description: ").append(jsonString(description)).append('\n');
+        sb.append("sidebar:\n  label: ").append(yamlScalar(label)).append('\n');
+        if (order != null) {
+            sb.append("  order: ").append(order).append('\n');
+        }
+        return sb.append("---\n\n").toString();
+    }
+
+    /** A plain YAML scalar when it is unambiguous, else a double-quoted one. */
+    static String yamlScalar(String value) {
+        if (PLAIN_YAML.matcher(value).matches() && !YAML_RESERVED.contains(value.toLowerCase(Locale.ROOT))) {
+            return value;
+        }
+        return jsonString(value);
+    }
+
+    /** A JSON string literal, which is also a valid double-quoted YAML scalar. */
+    static String jsonString(String value) {
+        var sb = new StringBuilder("\"");
+        for (int i = 0; i < value.length(); i++) {
+            char c = value.charAt(i);
+            switch (c) {
+                case '"' -> sb.append("\\\"");
+                case '\\' -> sb.append("\\\\");
+                case '\n' -> sb.append("\\n");
+                case '\r' -> sb.append("\\r");
+                case '\t' -> sb.append("\\t");
+                default -> {
+                    if (c < 0x20) {
+                        sb.append(String.format("\\u%04x", (int) c));
+                    } else {
+                        sb.append(c);
+                    }
+                }
+            }
+        }
+        return sb.append('"').toString();
+    }
+
+    static String codeBlock(String language, String source) {
+        return "```" + language + "\n" + source + "\n```\n\n";
+    }
+
+    /** An inline code span; text containing a backtick gets a double-backtick span. */
+    static String code(String text) {
+        return text.contains("`") ? "`` " + text + " ``" : "`" + text + "`";
+    }
+
+    static String link(String text, String url) {
+        return "[" + text + "](" + url + ")";
+    }
+
+    /** Text for a Markdown table cell: no pipes, no line breaks. */
+    static String cell(String text) {
+        return oneLine(text).replace("|", "\\|");
+    }
+
+    static String oneLine(String text) {
+        return text.trim().replaceAll("\\s+", " ");
+    }
+
+    /** Escapes tag-like {@code <} outside code spans so generics in prose survive the Markdown renderer. */
+    static String escape(String text) {
+        var sb = new StringBuilder();
+        var m = CODE_SPAN.matcher(text);
+        int last = 0;
+        while (m.find()) {
+            sb.append(TAG_LIKE.matcher(text.substring(last, m.start())).replaceAll("\\\\<")).append(m.group(1));
+            last = m.end();
+        }
+        return sb.append(TAG_LIKE.matcher(text.substring(last)).replaceAll("\\\\<")).toString();
+    }
+
+    // --- Javadoc ----------------------------------------------------------------------------
+
+    /**
+     * The first sentence of the Javadoc description as one Markdown line, or an empty string. Links are reduced to
+     * their text and emphasis is dropped; tag-like {@code <} stays escaped, so the line can be written into a
+     * listing as it is. {@link #plain} removes the escapes for a quoted frontmatter value.
+     */
+    static String summary(Optional<Javadoc> javadoc) {
+        var text = javadoc.map(j -> description(j.getDescription(), false)).orElse("");
+        if (text.isEmpty()) {
+            return "";
+        }
+        var line = oneLine(text.split("\\n\\s*\\n", 2)[0]);
+        var m = FIRST_SENTENCE.matcher(line);
+        var sentence = m.find() ? m.group(1) : line;
+        return MARKDOWN_LINK.matcher(sentence).replaceAll("$1").replace("**", "");
+    }
+
+    /** A {@link #summary} with its Markdown escapes removed, for a value {@link #jsonString} quotes. */
+    static String plain(String summary) {
+        return summary.replace("\\<", "<");
+    }
+
+    /**
+     * The whole Javadoc description on one line, with {@code @apiNote} appended, or an empty string. A
+     * {@code <pre>} block becomes a code span, since a fence cannot sit on a bullet.
+     */
+    static String line(Optional<Javadoc> javadoc) {
+        if (javadoc.isEmpty()) {
+            return "";
+        }
+        var sb = new StringBuilder(oneLine(description(javadoc.get().getDescription(), false)));
+        for (var tag : javadoc.get().getBlockTags()) {
+            if (isNote(tag)) {
+                if (sb.length() > 0) {
+                    sb.append(' ');
+                }
+                sb.append("Note: ").append(oneLine(description(tag.getContent(), false)));
+            }
+        }
+        return sb.toString();
+    }
+
+    /** The Javadoc description as Markdown paragraphs, followed by note, deprecation and see-also paragraphs. */
+    static String body(Optional<Javadoc> javadoc) {
+        if (javadoc.isEmpty()) {
+            return "";
+        }
+        var sb = new StringBuilder(description(javadoc.get().getDescription()));
+        for (var tag : javadoc.get().getBlockTags()) {
+            var content = description(tag.getContent());
+            if (isNote(tag)) {
+                paragraph(sb, "**Note:** " + content);
+            } else if (tag.getType() == JavadocBlockTag.Type.DEPRECATED) {
+                paragraph(sb, "**Deprecated.** " + content);
+            } else if (tag.getType() == JavadocBlockTag.Type.SEE && !content.isEmpty()) {
+                paragraph(sb, "See also: " + (content.contains("`") || content.contains("[") ? content : code(oneLine(content))));
+            }
+        }
+        return sb.toString().trim();
+    }
+
+    /** The text of a block tag ({@code @param}, {@code @return}, {@code @throws}) as one Markdown line. */
+    static String tagText(JavadocBlockTag tag) {
+        return oneLine(description(tag.getContent(), false));
+    }
+
+    private static boolean isNote(JavadocBlockTag tag) {
+        return tag.getType() == JavadocBlockTag.Type.UNKNOWN
+                && Set.of("apiNote", "implNote", "implSpec").contains(tag.getTagName());
+    }
+
+    private static void paragraph(StringBuilder sb, String text) {
+        if (sb.length() > 0) {
+            sb.append("\n\n");
+        }
+        sb.append(text);
+    }
+
+    /**
+     * Javadoc description elements as Markdown: inline tags become code spans, HTML becomes Markdown, and each
+     * {@code <pre>} block becomes a fenced block holding its text raw.
+     */
+    static String description(JavadocDescription description) {
+        return description(description, true);
+    }
+
+    /**
+     * As {@link #description(JavadocDescription)}; with {@code fences} false, for single-line contexts, each
+     * {@code <pre>} block becomes a code span instead.
+     */
+    static String description(JavadocDescription description, boolean fences) {
+        var sb = new StringBuilder();
+        var blocks = new ArrayList<String>();
+        PreBlock pre = null;
+        for (var element : description.getElements()) {
+            if (element instanceof JavadocInlineTag tag) {
+                if (pre == null) {
+                    sb.append(inlineTag(tag));
+                } else {
+                    pre.tag(tag);
+                }
+                continue;
+            }
+            var text = element.toText();
+            var m = PRE_TAG.matcher(text);
+            int last = 0;
+            while (m.find()) {
+                var chunk = text.substring(last, m.start());
+                if (pre == null) {
+                    sb.append(html(chunk));
+                } else {
+                    pre.text(chunk);
+                }
+                var closing = !m.group(1).isEmpty();
+                if (closing && pre != null) {
+                    blocks.add(pre.toString());
+                    sb.append("\n\n").append(PRE_MARK).append(blocks.size() - 1).append("\uE001\n\n");
+                    pre = null;
+                } else if (!closing && pre == null) {
+                    pre = new PreBlock();
+                }
+                last = m.end();
+            }
+            var tail = text.substring(last);
+            if (pre == null) {
+                sb.append(html(tail));
+            } else {
+                pre.text(tail);
+            }
+        }
+        if (pre != null) {
+            blocks.add(pre.toString());
+            sb.append("\n\n").append(PRE_MARK).append(blocks.size() - 1).append('\uE001');
+        }
+        var out = tidy(sb.toString());
+        for (int i = 0; i < blocks.size(); i++) {
+            var block = preBlock(blocks.get(i));
+            out = out.replace(PRE_MARK + i + '\uE001', fences ? "```\n" + block + "\n```" : code(oneLine(block)));
+        }
+        return out;
+    }
+
+    /**
+     * The raw text of one {@code <pre>} block as it is read: snippets as they are, inline tags by their content.
+     * JavaParser ends an inline tag at the first {@code }}, so a {@code {@code}} block containing braces arrives cut
+     * short; the brace it consumed is restored and the tag's real closing brace, the first one that unbalances the
+     * block, is dropped.
+     */
+    private static final class PreBlock {
+        private final StringBuilder sb = new StringBuilder();
+        /** Unmatched {@code {} of a cut-short {@code {@code}} tag still open, or -1 when none is pending. */
+        private int openBraces = -1;
+
+        void text(String text) {
+            if (openBraces < 0) {
+                sb.append(text);
+                return;
+            }
+            for (int i = 0; i < text.length(); i++) {
+                char c = text.charAt(i);
+                if (c == '{') {
+                    openBraces++;
+                } else if (c == '}' && --openBraces < 0) {
+                    sb.append(text, i + 1, text.length());
+                    return;
+                }
+                sb.append(c);
+            }
+        }
+
+        void tag(JavadocInlineTag tag) {
+            var content = tag.getContent();
+            switch (tag.getType()) {
+                case LINK, LINKPLAIN -> {
+                    var parts = content.trim().split("\\s+", 2);
+                    sb.append(parts.length > 1 ? parts[1] : parts[0]);
+                }
+                case INHERIT_DOC -> {
+                }
+                default -> {
+                    sb.append(content);
+                    var open = content.chars().filter(c -> c == '{').count() - content.chars().filter(c -> c == '}').count();
+                    if (open > 0) {
+                        sb.append('}');
+                        openBraces = (int) open - 1;
+                    }
+                }
+            }
+        }
+
+        @Override
+        public String toString() {
+            return sb.toString();
+        }
+    }
+
+    /** A {@code <pre>} block's text for a fence: entities decoded, blank edges and common indentation removed, nothing escaped. */
+    private static String preBlock(String raw) {
+        var lines = new ArrayList<>(List.of(decode(raw).replace("\r", "").split("\n", -1)));
+        while (!lines.isEmpty() && lines.get(0).isBlank()) {
+            lines.remove(0);
+        }
+        while (!lines.isEmpty() && lines.get(lines.size() - 1).isBlank()) {
+            lines.remove(lines.size() - 1);
+        }
+        var indent = Integer.MAX_VALUE;
+        for (var line : lines) {
+            if (!line.isBlank()) {
+                indent = Math.min(indent, line.length() - line.stripLeading().length());
+            }
+        }
+        var sb = new StringBuilder();
+        for (var line : lines) {
+            sb.append(line.isBlank() ? "" : line.substring(indent)).append('\n');
+        }
+        return sb.toString().stripTrailing();
+    }
+
+    private static String inlineTag(JavadocInlineTag tag) {
+        var content = tag.getContent().trim();
+        return switch (tag.getType()) {
+            case CODE, VALUE -> code(oneLine(content));
+            case LITERAL -> escape(content);
+            case LINK, LINKPLAIN -> {
+                var parts = content.split("\\s+", 2);
+                var reference = parts[0].startsWith("#") ? parts[0].substring(1) : parts[0].replace('#', '.');
+                yield code(parts.length > 1 ? parts[1] : reference);
+            }
+            case INHERIT_DOC -> "";
+            default -> escape(content);
+        };
+    }
+
+    /**
+     * The HTML subset Javadoc authors use, as Markdown; anything tag-like that remains is escaped. {@code <pre>}
+     * blocks are cut out before this runs, see {@link #description(JavadocDescription, boolean)}.
+     */
+    static String html(String text) {
+        var s = decode(text);
+        s = A_TAG.matcher(s).replaceAll(m -> Matcher.quoteReplacement(link(oneLine(m.group(2)), m.group(1))));
+        s = CODE_TAG.matcher(s).replaceAll(m -> Matcher.quoteReplacement(code(oneLine(m.group(2)))));
+        s = s.replaceAll("(?i)</?p\\s*/?>", "\n\n");
+        s = s.replaceAll("(?i)<br\\s*/?>", "\n");
+        s = s.replaceAll("(?i)\\s*<li>\\s*", "\n- ").replaceAll("(?i)</li>\\s*", "\n");
+        s = s.replaceAll("(?i)\\s*</?(ul|ol)>\\s*", "\n\n");
+        s = s.replaceAll("(?i)</?(b|strong)>", "**").replaceAll("(?i)</?(i|em)>", "*");
+        s = s.replaceAll("(?i)<h[1-6]>", "\n\n**").replaceAll("(?i)</h[1-6]>", "**\n\n");
+        return escape(s);
+    }
+
+    /** The HTML entities Javadoc authors use, decoded. */
+    private static String decode(String text) {
+        return text.replace("&lt;", "<").replace("&gt;", ">").replace("&quot;", "\"").replace("&#64;", "@")
+                .replace("&nbsp;", " ").replace("&amp;", "&");
+    }
+
+    /** Trims every line and collapses runs of blank lines. */
+    private static String tidy(String text) {
+        var lines = text.split("\n", -1);
+        var sb = new StringBuilder();
+        for (var line : lines) {
+            sb.append(line.strip()).append('\n');
+        }
+        return sb.toString().replaceAll("\n{3,}", "\n\n").trim();
+    }
+
+    // --- Files ------------------------------------------------------------------------------
+
+    /** Writes one page, refusing a {@code name.md} / {@code name/index.md} pair, which would share a URL. */
+    static Path write(Path outDir, String relative, String content) throws IOException {
+        var path = outDir.resolve(relative);
+        var name = path.getFileName().toString();
+        Path twin;
+        if (name.equals("index.md")) {
+            var dir = path.getParent();
+            twin = dir.resolveSibling(dir.getFileName() + ".md");
+        } else {
+            twin = path.resolveSibling(name.substring(0, name.length() - ".md".length())).resolve("index.md");
+        }
+        if (Files.exists(path) || Files.exists(twin)) {
+            throw new IllegalStateException(path + " would publish the same URL as an existing page");
+        }
+        Files.createDirectories(path.getParent());
+        Files.writeString(path, content);
+        return path;
+    }
+}
diff --git a/docs/tools/src/main/java/docs/ProtoEnum.java b/docs/tools/src/main/java/docs/ProtoEnum.java
new file mode 100644
index 00000000..01cd9598
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ProtoEnum.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import java.util.List;
+
+/** A protobuf enum with its values in declaration order. */
+record ProtoEnum(String name, List<ProtoEnumValue> values) {}
diff --git a/docs/tools/src/main/java/docs/ProtoEnumValue.java b/docs/tools/src/main/java/docs/ProtoEnumValue.java
new file mode 100644
index 00000000..7ce81edb
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ProtoEnumValue.java
@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+/** One enum value. */
+record ProtoEnumValue(String name, int number) {}
diff --git a/docs/tools/src/main/java/docs/ProtoField.java b/docs/tools/src/main/java/docs/ProtoField.java
new file mode 100644
index 00000000..c0394ec8
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ProtoField.java
@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+/**
+ * A message field.
+ *
+ * @param label  {@code "repeated"}, {@code "optional"}, {@code "map"}, {@code "oneof"} (a member of a {@code oneof} group)
+ *               or an empty string for a plain singular field
+ * @param type   the type as written ({@code int64}, {@code Image}, {@code Outer.Inner}), or {@code map<K, V>} for maps
+ * @param name   the field name
+ * @param number the field number
+ */
+record ProtoField(String label, String type, String name, int number) {}
diff --git a/docs/tools/src/main/java/docs/ProtoFile.java b/docs/tools/src/main/java/docs/ProtoFile.java
new file mode 100644
index 00000000..4a19a16e
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ProtoFile.java
@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import java.util.List;
+
+/**
+ * One parsed {@code .proto} file.
+ *
+ * @param name        the file's stem, lowercase: {@code webcast} for {@code webcast.proto}; it names the file's
+ *                    directory of schema pages
+ * @param pkg         the {@code package} statement, or an empty string
+ * @param javaPackage the {@code java_package} option, or an empty string
+ * @param messages    top-level messages in declaration order
+ * @param enums       top-level enums in declaration order
+ */
+record ProtoFile(String name, String pkg, String javaPackage, List<ProtoMessage> messages, List<ProtoEnum> enums) {}
diff --git a/docs/tools/src/main/java/docs/ProtoMessage.java b/docs/tools/src/main/java/docs/ProtoMessage.java
new file mode 100644
index 00000000..7028bb8b
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ProtoMessage.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import java.util.List;
+
+/**
+ * A protobuf message.
+ *
+ * @param name        the simple name
+ * @param parent      the qualified name of the enclosing message ({@code Outer} or {@code Outer.Inner}), or null at top level
+ * @param fields      fields in declaration order, {@code oneof} members included
+ * @param nested      messages declared inside this one
+ * @param nestedEnums enums declared inside this one
+ */
+record ProtoMessage(String name, String parent, List<ProtoField> fields, List<ProtoMessage> nested, List<ProtoEnum> nestedEnums) {
+
+    /** {@code Outer.Inner} for a nested message, the simple name at top level. */
+    String qualifiedName() {
+        return parent == null ? name : parent + "." + name;
+    }
+}
diff --git a/docs/tools/src/main/java/docs/ProtoParser.java b/docs/tools/src/main/java/docs/ProtoParser.java
new file mode 100644
index 00000000..688d835e
--- /dev/null
+++ b/docs/tools/src/main/java/docs/ProtoParser.java
@@ -0,0 +1,360 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.regex.Pattern;
+
+/**
+ * A hand-written recursive-descent parser for the proto3 subset the library's schema uses: {@code message},
+ * {@code enum}, nested types, {@code repeated}/{@code optional} labels, {@code map<K, V>}, {@code oneof}, and
+ * both comment styles. {@code option}, {@code reserved}, {@code extensions}, {@code import} and {@code syntax}
+ * statements are skipped (the {@code java_package} option is kept).
+ */
+final class ProtoParser {
+
+    private static final Pattern IDENTIFIER = Pattern.compile("[A-Za-z_.][A-Za-z0-9_.]*");
+
+    private record Token(String text, int line) {}
+
+    private final List<Token> tokens;
+    private final String origin;
+    private int pos;
+
+    private ProtoParser(List<Token> tokens, String origin) {
+        this.tokens = tokens;
+        this.origin = origin;
+    }
+
+    static ProtoFile parse(Path protoFile) {
+        String source;
+        try {
+            source = Files.readString(protoFile);
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        return parse(source, protoFile.getFileName().toString());
+    }
+
+    /** Parses proto source text; {@code origin}, a file name or any label, names it in error messages and gives the file its stem. */
+    static ProtoFile parse(String source, String origin) {
+        return new ProtoParser(lex(source, origin), origin).file();
+    }
+
+    /** {@code webcast} for {@code API/src/main/proto/webcast.proto} or {@code webcast.proto}. */
+    static String stem(String origin) {
+        var name = origin.substring(Math.max(origin.lastIndexOf('/'), origin.lastIndexOf('\\')) + 1);
+        if (name.endsWith(".proto")) {
+            name = name.substring(0, name.length() - ".proto".length());
+        }
+        return name.toLowerCase(java.util.Locale.ROOT);
+    }
+
+    // --- Grammar ----------------------------------------------------------------------------
+
+    private ProtoFile file() {
+        var pkg = "";
+        var javaPackage = "";
+        var messages = new ArrayList<ProtoMessage>();
+        var enums = new ArrayList<ProtoEnum>();
+        while (!eof()) {
+            var t = peek().text();
+            switch (t) {
+                case "syntax", "import" -> skipStatement();
+                case "package" -> {
+                    next();
+                    pkg = identifier();
+                    expect(";");
+                }
+                case "option" -> {
+                    next();
+                    var name = identifier();
+                    expect("=");
+                    var value = peekIs("{") ? "" : next().text();
+                    if (name.equals("java_package")) {
+                        javaPackage = unquote(value);
+                    }
+                    skipStatement();
+                }
+                case "message" -> messages.add(message(null));
+                case "enum" -> enums.add(enumeration());
+                case ";" -> next();
+                default -> throw error("unexpected '" + t + "' at top level");
+            }
+        }
+        return new ProtoFile(stem(origin), pkg, javaPackage, List.copyOf(messages), List.copyOf(enums));
+    }
+
+    private ProtoMessage message(String parent) {
+        expect("message");
+        var name = identifier();
+        var qualified = parent == null ? name : parent + "." + name;
+        expect("{");
+        var fields = new ArrayList<ProtoField>();
+        var nested = new ArrayList<ProtoMessage>();
+        var nestedEnums = new ArrayList<ProtoEnum>();
+        while (!peekIs("}")) {
+            var t = peek().text();
+            switch (t) {
+                case "message" -> nested.add(message(qualified));
+                case "enum" -> nestedEnums.add(enumeration());
+                case "oneof" -> {
+                    next();
+                    identifier();
+                    expect("{");
+                    while (!peekIs("}")) {
+                        if (peekIs("option")) {
+                            skipStatement();
+                        } else if (peekIs(";")) {
+                            next();
+                        } else {
+                            fields.add(field("oneof"));
+                        }
+                    }
+                    expect("}");
+                }
+                case "option", "reserved", "extensions", "extend" -> skipStatement();
+                case ";" -> next();
+                case "map" -> fields.add(mapField());
+                case "repeated", "optional", "required" -> {
+                    next();
+                    fields.add(field(t));
+                }
+                default -> fields.add(field(""));
+            }
+        }
+        expect("}");
+        return new ProtoMessage(name, parent, List.copyOf(fields), List.copyOf(nested), List.copyOf(nestedEnums));
+    }
+
+    private ProtoField field(String label) {
+        var type = identifier();
+        var name = identifier();
+        expect("=");
+        var number = number();
+        options();
+        expect(";");
+        return new ProtoField(label, type, name, number);
+    }
+
+    private ProtoField mapField() {
+        expect("map");
+        expect("<");
+        var key = identifier();
+        expect(",");
+        var value = identifier();
+        expect(">");
+        var name = identifier();
+        expect("=");
+        var number = number();
+        options();
+        expect(";");
+        return new ProtoField("map", "map<" + key + ", " + value + ">", name, number);
+    }
+
+    private ProtoEnum enumeration() {
+        expect("enum");
+        var name = identifier();
+        expect("{");
+        var values = new ArrayList<ProtoEnumValue>();
+        while (!peekIs("}")) {
+            if (peekIs("option") || peekIs("reserved")) {
+                skipStatement();
+            } else if (peekIs(";")) {
+                next();
+            } else {
+                var valueName = identifier();
+                expect("=");
+                var number = number();
+                options();
+                expect(";");
+                values.add(new ProtoEnumValue(valueName, number));
+            }
+        }
+        expect("}");
+        return new ProtoEnum(name, List.copyOf(values));
+    }
+
+    /** Skips a {@code [ ... ]} option list when one follows. */
+    private void options() {
+        if (!peekIs("[")) {
+            return;
+        }
+        int depth = 0;
+        do {
+            var t = next().text();
+            if (t.equals("[")) {
+                depth++;
+            } else if (t.equals("]")) {
+                depth--;
+            }
+        } while (depth > 0 && !eof());
+        if (depth != 0) {
+            throw error("unterminated field options");
+        }
+    }
+
+    /** Skips through the next top-level {@code ;}, stepping over any braced aggregate on the way. */
+    private void skipStatement() {
+        int depth = 0;
+        while (!eof()) {
+            var t = next().text();
+            if (t.equals("{")) {
+                depth++;
+            } else if (t.equals("}")) {
+                depth--;
+            } else if (t.equals(";") && depth == 0) {
+                return;
+            }
+        }
+        throw error("unterminated statement");
+    }
+
+    // --- Tokens -----------------------------------------------------------------------------
+
+    private String identifier() {
+        var t = next();
+        if (!IDENTIFIER.matcher(t.text()).matches()) {
+            throw error("expected an identifier, found '" + t.text() + "'", t);
+        }
+        return t.text();
+    }
+
+    private int number() {
+        var t = next();
+        try {
+            return Integer.decode(t.text());
+        } catch (NumberFormatException e) {
+            throw error("expected a number, found '" + t.text() + "'", t);
+        }
+    }
+
+    private void expect(String text) {
+        var t = next();
+        if (!t.text().equals(text)) {
+            throw error("expected '" + text + "', found '" + t.text() + "'", t);
+        }
+    }
+
+    private boolean eof() {
+        return pos >= tokens.size();
+    }
+
+    private Token peek() {
+        if (eof()) {
+            throw error("unexpected end of file");
+        }
+        return tokens.get(pos);
+    }
+
+    private boolean peekIs(String text) {
+        return peek().text().equals(text);
+    }
+
+    private Token next() {
+        var t = peek();
+        pos++;
+        return t;
+    }
+
+    private IllegalArgumentException error(String message) {
+        var line = eof() ? (tokens.isEmpty() ? 0 : tokens.get(tokens.size() - 1).line()) : tokens.get(pos).line();
+        return new IllegalArgumentException(origin + ":" + line + ": " + message);
+    }
+
+    private IllegalArgumentException error(String message, Token at) {
+        return new IllegalArgumentException(origin + ":" + at.line() + ": " + message);
+    }
+
+    private static String unquote(String literal) {
+        if (literal.length() >= 2 && (literal.startsWith("\"") || literal.startsWith("'"))) {
+            return literal.substring(1, literal.length() - 1);
+        }
+        return literal;
+    }
+
+    /** Splits source into identifiers, numbers, string literals and single-character punctuation; comments are dropped. */
+    private static List<Token> lex(String source, String origin) {
+        var tokens = new ArrayList<Token>();
+        int i = 0;
+        int line = 1;
+        int n = source.length();
+        while (i < n) {
+            char c = source.charAt(i);
+            if (c == '\n') {
+                line++;
+                i++;
+            } else if (Character.isWhitespace(c)) {
+                i++;
+            } else if (source.startsWith("//", i)) {
+                while (i < n && source.charAt(i) != '\n') {
+                    i++;
+                }
+            } else if (source.startsWith("/*", i)) {
+                int end = source.indexOf("*/", i + 2);
+                if (end < 0) {
+                    throw new IllegalArgumentException(origin + ":" + line + ": unterminated block comment");
+                }
+                for (int j = i; j < end; j++) {
+                    if (source.charAt(j) == '\n') {
+                        line++;
+                    }
+                }
+                i = end + 2;
+            } else if (c == '"' || c == '\'') {
+                int j = i + 1;
+                while (j < n && source.charAt(j) != c) {
+                    j += source.charAt(j) == '\\' ? 2 : 1;
+                }
+                if (j >= n) {
+                    throw new IllegalArgumentException(origin + ":" + line + ": unterminated string literal");
+                }
+                tokens.add(new Token(source.substring(i, j + 1), line));
+                i = j + 1;
+            } else if (Character.isLetter(c) || c == '_' || c == '.') {
+                int j = i + 1;
+                while (j < n && (Character.isLetterOrDigit(source.charAt(j)) || source.charAt(j) == '_' || source.charAt(j) == '.')) {
+                    j++;
+                }
+                tokens.add(new Token(source.substring(i, j), line));
+                i = j;
+            } else if (Character.isDigit(c) || (c == '-' && i + 1 < n && Character.isDigit(source.charAt(i + 1)))) {
+                int j = i + 1;
+                while (j < n && (Character.isLetterOrDigit(source.charAt(j)) || source.charAt(j) == '.')) {
+                    j++;
+                }
+                tokens.add(new Token(source.substring(i, j), line));
+                i = j;
+            } else {
+                tokens.add(new Token(String.valueOf(c), line));
+                i++;
+            }
+        }
+        return tokens;
+    }
+}
diff --git a/docs/tools/src/main/java/docs/SchemaPages.java b/docs/tools/src/main/java/docs/SchemaPages.java
new file mode 100644
index 00000000..ecd2a3a1
--- /dev/null
+++ b/docs/tools/src/main/java/docs/SchemaPages.java
@@ -0,0 +1,295 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.TreeMap;
+
+/**
+ * Renders the protobuf schema reference: {@code index.md} at the root, {@code <file stem>/index.md} per
+ * {@code .proto} file and {@code <file stem>/<slug>.md} per message and enum, nested ones as
+ * {@code <outer>-<inner>}. Field types link to the page of the message or enum they name, across files.
+ */
+final class SchemaPages {
+
+    static final String URL_ROOT = "/schema/";
+    private static final Set<String> SCALARS = Set.of("double", "float", "int32", "int64", "uint32", "uint64", "sint32",
+            "sint64", "fixed32", "fixed64", "sfixed32", "sfixed64", "bool", "string", "bytes");
+
+    private SchemaPages() {}
+
+    /** A message or enum with the file it comes from and its qualified name ({@code Outer.Inner} when nested). */
+    record Entry(ProtoFile file, String stem, String qualified, String parent, ProtoMessage message, ProtoEnum enumeration) {
+
+        boolean isMessage() {
+            return message != null;
+        }
+
+        String kind() {
+            return isMessage() ? "message" : "enum";
+        }
+
+        String url() {
+            return URL_ROOT + stem + "/" + slug(qualified) + "/";
+        }
+
+        /** The generated Java class, {@code pkg.Outer.Inner} when nested. */
+        String javaName() {
+            return file.javaPackage().isEmpty() ? qualified : file.javaPackage() + "." + qualified;
+        }
+    }
+
+    /**
+     * The output directory for a file: its name without the extension, so two files whose packages share a last
+     * segment keep separate directories; a file without a name falls back to the last segment of its
+     * {@code java_package} (or {@code package}).
+     */
+    static String fileStem(ProtoFile file) {
+        if (!file.name().isEmpty()) {
+            return file.name();
+        }
+        var pkg = file.javaPackage().isEmpty() ? file.pkg() : file.javaPackage();
+        return pkg.substring(pkg.lastIndexOf('.') + 1).toLowerCase(Locale.ROOT);
+    }
+
+    /** {@code Outer.Inner} to {@code outer-inner}. */
+    static String slug(String qualifiedName) {
+        return qualifiedName.toLowerCase(Locale.ROOT).replace('.', '-');
+    }
+
+    /** Root-relative page URLs keyed by generated Java class name, for linking API pages to the schema. */
+    static Map<String, String> javaLinks(List<ProtoFile> files) {
+        var links = new TreeMap<String, String>();
+        for (var entry : entries(files)) {
+            links.put(entry.javaName(), entry.url());
+        }
+        return links;
+    }
+
+    /** Renders every page and returns their paths, the root index first. */
+    static List<Path> render(List<ProtoFile> files, String version, Path outDir) {
+        var entries = entries(files);
+        var index = new TreeMap<String, Entry>();
+        for (var entry : entries) {
+            if (index.put(entry.qualified(), entry) != null) {
+                throw new IllegalStateException("duplicate type " + entry.qualified() + " across proto files");
+            }
+        }
+        var byFile = new LinkedHashMap<String, List<Entry>>();
+        for (var entry : entries) {
+            byFile.computeIfAbsent(entry.stem(), k -> new ArrayList<>()).add(entry);
+        }
+        var written = new ArrayList<Path>();
+        try {
+            for (var fileEntries : byFile.values()) {
+                var stem = fileEntries.get(0).stem();
+                written.add(Markdown.write(outDir, stem + "/index.md", filePage(fileEntries)));
+                for (var entry : fileEntries) {
+                    written.add(Markdown.write(outDir, stem + "/" + slug(entry.qualified()) + ".md", entry.isMessage() ? messagePage(entry, index) : enumPage(entry)));
+                }
+            }
+            written.add(0, Markdown.write(outDir, "index.md", rootPage(version, byFile.keySet(), entries)));
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        return written;
+    }
+
+    // --- Model ------------------------------------------------------------------------------
+
+    /** Every message and enum of every file, files by stem, entries by qualified name. */
+    private static List<Entry> entries(List<ProtoFile> files) {
+        var sortedFiles = new ArrayList<>(files);
+        sortedFiles.sort(Comparator.comparing(SchemaPages::fileStem));
+        var entries = new ArrayList<Entry>();
+        for (var file : sortedFiles) {
+            var stem = fileStem(file);
+            var fileEntries = new ArrayList<Entry>();
+            for (var message : file.messages()) {
+                collect(file, stem, message, fileEntries);
+            }
+            for (var enumeration : file.enums()) {
+                fileEntries.add(new Entry(file, stem, enumeration.name(), null, null, enumeration));
+            }
+            fileEntries.sort(Comparator.comparing(Entry::qualified));
+            entries.addAll(fileEntries);
+        }
+        return entries;
+    }
+
+    private static void collect(ProtoFile file, String stem, ProtoMessage message, List<Entry> out) {
+        var qualified = message.qualifiedName();
+        out.add(new Entry(file, stem, qualified, message.parent(), message, null));
+        for (var nested : message.nested()) {
+            collect(file, stem, nested, out);
+        }
+        for (var nestedEnum : message.nestedEnums()) {
+            out.add(new Entry(file, stem, qualified + "." + nestedEnum.name(), qualified, null, nestedEnum));
+        }
+    }
+
+    /** The entry a type reference names from inside {@code scope}, searching enclosing messages first. */
+    private static Entry resolve(String type, Entry scope, Map<String, Entry> index) {
+        var name = type.startsWith(".") ? type.substring(1) : type;
+        var pkg = scope.file().pkg();
+        if (!pkg.isEmpty() && name.startsWith(pkg + ".")) {
+            name = name.substring(pkg.length() + 1);
+        }
+        for (var s = scope.qualified(); s != null; s = parentOf(s)) {
+            var candidate = index.get(s + "." + name);
+            if (candidate != null) {
+                return candidate;
+            }
+        }
+        return index.get(name);
+    }
+
+    private static String parentOf(String qualified) {
+        int dot = qualified.lastIndexOf('.');
+        return dot < 0 ? null : qualified.substring(0, dot);
+    }
+
+    private static String typeMarkdown(String type, Entry scope, Map<String, Entry> index) {
+        if (type.startsWith("map<") && type.endsWith(">")) {
+            var parts = type.substring(4, type.length() - 1).split(",\\s*", 2);
+            var value = resolve(parts[1], scope, index);
+            if (value == null) {
+                return Markdown.code(type);
+            }
+            return Markdown.code("map<" + parts[0] + ", ") + Markdown.link(Markdown.code(parts[1]), value.url()) + Markdown.code(">");
+        }
+        if (SCALARS.contains(type)) {
+            return Markdown.code(type);
+        }
+        var target = resolve(type, scope, index);
+        return target == null ? Markdown.code(type) : Markdown.link(Markdown.code(type), target.url());
+    }
+
+    // --- Pages ------------------------------------------------------------------------------
+
+    private static String rootPage(String version, Set<String> stems, List<Entry> entries) {
+        var blurb = "Every protobuf message and enum in the schema TikTokLiveJava " + version
+                + " decodes events from, generated from the `.proto` files in `API/src/main/proto`.";
+        var sb = new StringBuilder(Markdown.frontmatter("TikTok Webcast schema (" + version + ")", blurb, "Overview", 0));
+        sb.append(blurb).append("\n\n## Files\n\n");
+        for (var stem : stems) {
+            sb.append("- ").append(Markdown.link(Markdown.code(stem + ".proto"), URL_ROOT + stem + "/")).append('\n');
+        }
+        sb.append('\n');
+        var byName = new ArrayList<>(entries);
+        byName.sort(Comparator.comparing(Entry::qualified).thenComparing(Entry::stem));
+        sb.append(listing("## Messages", byName, true, true));
+        sb.append(listing("## Enums", byName, false, true));
+        return sb.toString().stripTrailing() + "\n";
+    }
+
+    private static String filePage(List<Entry> entries) {
+        var first = entries.get(0);
+        var file = first.file();
+        var title = first.stem() + ".proto";
+        var blurb = "Messages and enums declared in `" + title + "` (package `" + file.pkg() + "`, Java package `" + file.javaPackage() + "`).";
+        var sb = new StringBuilder(Markdown.frontmatter(title, "Protobuf definitions in " + title, first.stem(), 0));
+        sb.append(blurb).append("\n\n");
+        sb.append(listing("## Messages", entries, true, false));
+        sb.append(listing("## Enums", entries, false, false));
+        return sb.toString().stripTrailing() + "\n";
+    }
+
+    private static String listing(String heading, List<Entry> entries, boolean messages, boolean qualified) {
+        var lines = new ArrayList<String>();
+        for (var entry : entries) {
+            if (entry.isMessage() != messages) {
+                continue;
+            }
+            var line = "- " + Markdown.link(Markdown.code(entry.qualified()), entry.url());
+            if (qualified) {
+                line += " (" + Markdown.code(entry.stem() + ".proto") + ")";
+            }
+            lines.add(line);
+        }
+        return lines.isEmpty() ? "" : heading + "\n\n" + String.join("\n", lines) + "\n\n";
+    }
+
+    private static String header(Entry entry, Map<String, Entry> index) {
+        var kind = entry.kind();
+        var sb = new StringBuilder(Markdown.frontmatter(entry.qualified(), "Protobuf " + kind + " " + entry.qualified() + " (" + entry.stem() + ".proto)", entry.qualified(), null));
+        if (entry.parent() != null) {
+            var parent = index == null ? null : index.get(entry.parent());
+            sb.append("Nested in ").append(parent == null ? Markdown.code(entry.parent()) : Markdown.link(Markdown.code(entry.parent()), parent.url())).append(".\n\n");
+        }
+        sb.append("Protobuf ").append(kind).append(' ').append(Markdown.code(entry.qualified())).append(" declared in ")
+                .append(Markdown.link(Markdown.code(entry.stem() + ".proto"), URL_ROOT + entry.stem() + "/"))
+                .append("; generated Java ").append(kind.equals("enum") ? "enum" : "class").append(' ').append(Markdown.code(entry.javaName())).append(".\n\n");
+        return sb.toString();
+    }
+
+    private static String messagePage(Entry entry, Map<String, Entry> index) {
+        var sb = new StringBuilder(header(entry, index));
+        var fields = entry.message().fields();
+        sb.append("## Fields\n\n");
+        if (fields.isEmpty()) {
+            sb.append("This message has no fields.\n\n");
+        } else {
+            sb.append("| Field | Type | Number | Label |\n| --- | --- | --- | --- |\n");
+            for (var field : fields) {
+                sb.append("| ").append(Markdown.code(field.name())).append(" | ").append(typeMarkdown(field.type(), entry, index))
+                        .append(" | ").append(field.number()).append(" | ").append(field.label()).append(" |\n");
+            }
+            sb.append('\n');
+        }
+        var nested = new ArrayList<Entry>();
+        for (var child : entry.message().nested()) {
+            nested.add(index.get(child.qualifiedName()));
+        }
+        for (var child : entry.message().nestedEnums()) {
+            nested.add(index.get(entry.qualified() + "." + child.name()));
+        }
+        nested.sort(Comparator.comparing(Entry::qualified));
+        if (!nested.isEmpty()) {
+            sb.append("## Nested types\n\n");
+            for (var child : nested) {
+                sb.append("- ").append(Markdown.link(Markdown.code(child.qualified()), child.url())).append(" (").append(child.kind()).append(")\n");
+            }
+            sb.append('\n');
+        }
+        return sb.toString().stripTrailing() + "\n";
+    }
+
+    private static String enumPage(Entry entry) {
+        var sb = new StringBuilder(header(entry, null));
+        sb.append("## Values\n\n| Name | Number |\n| --- | --- |\n");
+        for (var value : entry.enumeration().values()) {
+            sb.append("| ").append(Markdown.code(value.name())).append(" | ").append(value.number()).append(" |\n");
+        }
+        return sb.toString().stripTrailing() + "\n";
+    }
+}
diff --git a/docs/tools/src/test/java/docs/ApiPagesTest.java b/docs/tools/src/test/java/docs/ApiPagesTest.java
new file mode 100644
index 00000000..762dce27
--- /dev/null
+++ b/docs/tools/src/test/java/docs/ApiPagesTest.java
@@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.stream.Stream;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class ApiPagesTest {
+
+    static final Path REPO = Path.of(System.getProperty("repo.root")).toAbsolutePath().normalize();
+    static final String VERSION = "1.13.1-Release";
+    static final String SOURCE_BASE = "https://github.com/jwdeveloper/TikTokLiveJava/blob/master";
+
+    @Test
+    void slugLowercasesAndNestsPackages() {
+        assertEquals("io/github/jwdeveloper/tiktok/api/live/liveclient", ApiPages.slug("io.github.jwdeveloper.tiktok.api.live.LiveClient"));
+    }
+
+    @Test
+    void nestedTypeSlugJoinsOuterAndInnerWithHyphen() {
+        assertEquals("io/github/jwdeveloper/tiktok/api/data/requests/livedata-request",
+                ApiPages.slug("io.github.jwdeveloper.tiktok.api.data.requests.LiveData$Request"));
+    }
+
+    @Test
+    void liveClientSettingsPageListsFields(@TempDir Path out) throws IOException {
+        var units = JavaSources.load(REPO);
+        var paths = ApiPages.render(units, VERSION, SOURCE_BASE, out);
+        var page = out.resolve("io/github/jwdeveloper/tiktok/api/data/settings/liveclientsettings.md");
+        assertTrue(Files.exists(page), "page exists");
+        var md = Files.readString(page);
+        assertTrue(md.startsWith("---\ntitle: LiveClientSettings\n"), "frontmatter starts with the title");
+        assertTrue(md.contains("\nsidebar:\n  label: LiveClientSettings\n"), "sidebar label");
+        for (var f : List.of("offline", "fetchGifts", "retryOnConnectionFailure", "pingInterval", "apiKey")) {
+            assertTrue(md.contains("`" + f + "`"), f);
+        }
+        assertTrue(md.contains("@Data"), "Lombok annotation kept in the signature");
+        assertTrue(md.contains("getter"), "Lombok accessors noted");
+        assertTrue(md.contains("## Source"), "source section");
+        assertTrue(md.contains(SOURCE_BASE + "/API/src/main/java/io/github/jwdeveloper/tiktok/api/data/settings/LiveClientSettings.java#L"), "source link");
+        assertTrue(paths.size() > 150, "pages: " + paths.size());
+        assertTrue(Files.exists(out.resolve("index.md")), "root index");
+        assertTrue(Files.readString(out.resolve("index.md")).startsWith("---\ntitle: TikTokLiveJava " + VERSION + "\n"), "root index title");
+        assertTrue(Files.exists(out.resolve("io/github/jwdeveloper/tiktok/api/data/settings/index.md")), "package index");
+        assertTrue(Files.exists(out.resolve("io/github/jwdeveloper/tiktok/api/data/requests/livedata-request.md")), "nested type page");
+    }
+
+    @Test
+    void typeWithoutJavadocStillRenders(@TempDir Path out) throws IOException {
+        ApiPages.render(JavaSources.load(REPO), VERSION, SOURCE_BASE, out);
+        var page = out.resolve("io/github/jwdeveloper/tiktok/api/annotations/eventtype.md");
+        assertTrue(Files.exists(page), "page exists");
+        var md = Files.readString(page);
+        assertTrue(md.startsWith("---\ntitle: EventType\n"), "title");
+        assertTrue(md.contains("\ndescription: \"enum io.github.jwdeveloper.tiktok.api.annotations.EventType\"\n"), "fallback description");
+        assertTrue(md.contains("`Control`"), "enum constants listed");
+    }
+
+    @Test
+    void everyPageHasFrontmatter(@TempDir Path out) throws IOException {
+        var paths = ApiPages.render(JavaSources.load(REPO), VERSION, SOURCE_BASE, out);
+        for (var p : paths) {
+            var md = Files.readString(p);
+            assertTrue(md.startsWith("---\ntitle: "), p + " starts with frontmatter");
+            assertTrue(md.contains("\nsidebar:\n  label: "), p + " has a sidebar label");
+        }
+    }
+
+    @Test
+    void outputIsDeterministic(@TempDir Path a, @TempDir Path b) throws IOException {
+        var units = JavaSources.load(REPO);
+        var first = ApiPages.render(units, VERSION, SOURCE_BASE, a);
+        var second = ApiPages.render(JavaSources.load(REPO), VERSION, SOURCE_BASE, b);
+        assertEquals(relative(a, first), relative(b, second), "same file list in the same order");
+        for (var p : first) {
+            var twin = b.resolve(a.relativize(p));
+            assertEquals(Files.readString(p), Files.readString(twin), "same content for " + a.relativize(p));
+        }
+        try (Stream<Path> files = Files.walk(a)) {
+            assertEquals(first.size(), files.filter(Files::isRegularFile).count(), "render returns every file it wrote");
+        }
+    }
+
+    private static List<String> relative(Path root, List<Path> paths) {
+        return paths.stream().map(p -> root.relativize(p).toString()).toList();
+    }
+}
diff --git a/docs/tools/src/test/java/docs/ContentCheckTest.java b/docs/tools/src/test/java/docs/ContentCheckTest.java
new file mode 100644
index 00000000..a2cbac0b
--- /dev/null
+++ b/docs/tools/src/test/java/docs/ContentCheckTest.java
@@ -0,0 +1,298 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.PrintStream;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class ContentCheckTest {
+
+    static final Path REPO = Path.of(System.getProperty("repo.root")).toAbsolutePath().normalize();
+
+    @Test
+    void eventsMapIncludesCategories() {
+        var e = ContentCheck.events(REPO);
+        assertEquals("Message", e.get("TikTokCommentEvent"));
+        assertEquals("Control", e.get("TikTokConnectedEvent"));
+        assertTrue(e.size() >= 73, "events: " + e.size());
+        // Ruling J7: abstract classes are not events; concrete classes without @EventMeta have the category `none`.
+        assertFalse(e.containsKey("TikTokEvent"), "abstract base class is excluded");
+        assertEquals("none", e.get("TikTokHeaderEvent"));
+    }
+
+    @Test
+    void unannotatedConcreteEventsGetCategoryNoneAndAbstractBaseIsExcluded() {
+        var e = ContentCheck.events(REPO);
+        assertEquals("none", e.get("TikTokHeaderEvent"));
+        assertEquals("none", e.get("TikTokUnhandledEvent"));
+        assertFalse(e.containsKey("TikTokEvent"), "abstract base class is not an event");
+        assertFalse(e.containsKey("CaptionContent"), "nested types are not events");
+        assertTrue(ContentCheck.eventClassNames(REPO).contains("TikTokEvent"), "README anchors may name the base class");
+    }
+
+    @Test
+    void settingsHandlersExceptions() {
+        assertTrue(ContentCheck.settingsFields(REPO).contains("retryConnectionTimeout"));
+        assertTrue(ContentCheck.settingsFields(REPO).contains("timeout"), "HttpClientSettings field");
+        assertTrue(ContentCheck.handlers(REPO).contains("onComment"));
+        assertTrue(ContentCheck.handlers(REPO).contains("sendChat"), "LiveClient method");
+        assertFalse(ContentCheck.builderHandlers(REPO).contains("sendChat"), "builder handlers are on* methods of EventsBuilder only");
+        assertEquals(11, ContentCheck.exceptions(REPO).size());
+    }
+
+    @Test
+    void checkEventsReportsMissingEvent(@TempDir Path site) throws IOException {
+        write(site, "t.md", "The `TikTokCommentEvent` event.\n");
+        write(site, "events/index.md", "| Event | Type | Description |\n|---|---|---|\n| `TikTokCommentEvent` | Message | A comment. |\n");
+        write(site, "events/chat.md", "## TikTokCommentEvent\n\nA comment.\n");
+        var events = Map.of("TikTokCommentEvent", "Message", "TikTokNewShinyEvent", "Message");
+        var failures = ContentCheck.checkEvents(events, ContentCheck.pages(site));
+        assertTrue(failures.contains("Missing event documentation: TikTokNewShinyEvent"), failures.toString());
+        assertTrue(failures.contains("Event catalog row missing: TikTokNewShinyEvent"), failures.toString());
+        assertTrue(failures.contains("Event section heading missing: TikTokNewShinyEvent"), failures.toString());
+        assertFalse(failures.stream().anyMatch(f -> f.contains("TikTokCommentEvent")), failures.toString());
+    }
+
+    @Test
+    void catalogRowTypeMustMatchAnnotation(@TempDir Path site) throws IOException {
+        write(site, "events/index.md", "| Event | Type | Description |\n|---|---|---|\n| `TikTokCommentEvent` | Control | x |\n");
+        write(site, "events/chat.md", "## TikTokCommentEvent\n");
+        var failures = ContentCheck.checkEvents(Map.of("TikTokCommentEvent", "Message"), ContentCheck.pages(site));
+        assertEquals(List.of("Event catalog row is stale: TikTokCommentEvent"), failures);
+    }
+
+    @Test
+    void catalogRowAcceptsNoneForUnannotatedEvents(@TempDir Path site) throws IOException {
+        write(site, "events/index.md", "| `TikTokHeaderEvent` | none | base |\n");
+        write(site, "events/debugging.md", "## `TikTokHeaderEvent`\n");
+        assertEquals(List.of(), ContentCheck.checkEvents(Map.of("TikTokHeaderEvent", "none"), ContentCheck.pages(site)));
+    }
+
+    @Test
+    void eventSectionHeadingMustBeOnAGroupedEventsPage(@TempDir Path site) throws IOException {
+        // The catalog row alone used to satisfy the section: `mentioned()` counts the row's backticks.
+        write(site, "events/index.md", "| `TikTokCommentEvent` | Message | A comment. |\n\n## TikTokCommentEvent\n");
+        write(site, "guides/chat.md", "## TikTokCommentEvent\n");
+        write(site, "events/chat.md", "### TikTokCommentEvent\n\nA level-3 heading is not a section.\n");
+        var failures = ContentCheck.checkEvents(Map.of("TikTokCommentEvent", "Message"), ContentCheck.pages(site));
+        assertEquals(List.of("Event section heading missing: TikTokCommentEvent"), failures);
+
+        write(site, "events/chat.md", "## TikTokCommentEvent\n");
+        assertEquals(List.of(), ContentCheck.checkEvents(Map.of("TikTokCommentEvent", "Message"), ContentCheck.pages(site)));
+    }
+
+    @Test
+    void repositoryEventsHaveSectionsCatalogRowsAndMentions() {
+        assertEquals(List.of(), ContentCheck.checkEvents(ContentCheck.events(REPO), ContentCheck.pages(REPO.resolve(Main.CONTENT_DIR))));
+    }
+
+    @Test
+    void namesMustAppearInBackticks(@TempDir Path site) throws IOException {
+        write(site, "t.md", "Set `retryConnectionTimeout`; plain pingInterval is not documentation.\n");
+        var failures = ContentCheck.checkNames("settings field", List.of("retryConnectionTimeout", "pingInterval"), ContentCheck.pages(site));
+        assertEquals(List.of("Missing settings field documentation: pingInterval"), failures);
+    }
+
+    @Test
+    void generatedPagesDoNotCount(@TempDir Path site) throws IOException {
+        write(site, "api/x.md", "`TikTokLiveException`\n");
+        write(site, "schema/y.md", "`TikTokLiveException`\n");
+        write(site, "z.txt", "`TikTokLiveException`\n");
+        assertEquals(List.of("Missing exception documentation: TikTokLiveException"),
+                ContentCheck.checkNames("exception", List.of("TikTokLiveException"), ContentCheck.pages(site)));
+    }
+
+    @Test
+    void readmeHandlerWithoutClassFails() {
+        var failures = ContentCheck.checkReadme("- [onComent](#oncoment-tiktokcomentevent)\n", Set.of("onComment"), Set.of("TikTokCommentEvent"));
+        assertTrue(failures.contains("README handler has no event class: onComent"), failures.toString());
+    }
+
+    @Test
+    void readmeHandlerNotOnBuilderFails() {
+        var failures = ContentCheck.checkReadme("- [onCommentary](#oncommentary-tiktokcommentevent)\n", Set.of("onComment"), Set.of("TikTokCommentEvent"));
+        assertEquals(List.of("README handler is not on EventsBuilder: onCommentary"), failures);
+    }
+
+    @Test
+    void readmeItemsOutsideTheEventsListAreIgnored() {
+        var readme = "# Intro\n\n- [onBogus](#onbogus-tiktokbogusevent) in the intro\n\n## Events\n\n\n## Events\n\n**Message**:\n\n"
+                + "- [onComment](#oncomment-tiktokcommentevent)\n\n# Examples\n\n- [onOther](#onother-tiktokotherevent)\n\n## Listeners\n\n- [onMore](#onmore-tiktokmoreevent)\n";
+        assertEquals(List.of(), ContentCheck.checkReadme(readme, Set.of("onComment"), Set.of("TikTokCommentEvent")));
+        assertEquals("## Events\n\n\n## Events\n\n**Message**:\n\n- [onComment](#oncomment-tiktokcommentevent)\n\n", ContentCheck.eventsSection(readme));
+        assertEquals("- [onX](#onx-tiktokxevent)\n", ContentCheck.eventsSection("- [onX](#onx-tiktokxevent)\n"), "no heading: the whole text");
+    }
+
+    @Test
+    void duplicateCatalogRowsFail(@TempDir Path site) throws IOException {
+        write(site, "events/index.md", "| `TikTokCommentEvent` | Message | A comment. |\n| `TikTokCommentEvent` | Message | Again. |\n");
+        write(site, "events/chat.md", "## TikTokCommentEvent\n");
+        assertEquals(List.of("Event catalog row duplicated: TikTokCommentEvent"),
+                ContentCheck.checkEvents(Map.of("TikTokCommentEvent", "Message"), ContentCheck.pages(site)));
+    }
+
+    @Test
+    void unclosedFenceIsReportedAndNotCompiled(@TempDir Path site) throws IOException {
+        write(site, "a.md", "Intro.\n\n```java\nint a = 1;\n```\n\nMore.\n\n```java\nint b = 2;\n\nThe page ends without a closing fence.\n");
+        write(site, "b.md", "```sh\necho ok\n```\n");
+        var pages = ContentCheck.pages(site);
+        assertEquals(List.of("a.md: the fence opened at line 9 is never closed"), ContentCheck.unclosedFences(pages));
+        assertEquals(1, ContentCheck.examples(pages).size(), "the unclosed fence is not an example");
+    }
+
+    @Test
+    void readmeItemWithTrailingTextPasses() {
+        var readme = "**Message**:\n\n- [onComment](#oncomment-tiktokcommentevent) · [docs](https://example.com/events/chat/#tiktokcommentevent)\n"
+                + "- [onWebsocketUnhandledMessage](#onwebsocketunhandledmessage-tiktokwebsocketunhandledmessageevent)\n";
+        var events = Set.of("TikTokCommentEvent", "TikTokWebsocketUnhandledMessageEvent");
+        assertEquals(List.of(), ContentCheck.checkReadme(readme, Set.of("onComment", "onWebsocketUnhandledMessage"), events));
+    }
+
+    @Test
+    void repositoryReadmeItemsAreParsedAndPassAgainstTheSources() throws IOException {
+        var readme = Files.readString(REPO.resolve("README.md"));
+        var unresolved = ContentCheck.checkReadme(readme, Set.of(), Set.of());
+        assertTrue(unresolved.contains("README handler has no event class: onComment"), unresolved.toString());
+        assertTrue(unresolved.contains("README handler is not on EventsBuilder: onEvent"), unresolved.toString());
+        assertTrue(unresolved.size() >= 40, "every item yields two failures when nothing resolves: " + unresolved.size());
+        assertEquals(List.of(), ContentCheck.checkReadme(readme, ContentCheck.builderHandlers(REPO), ContentCheck.eventClassNames(REPO)));
+    }
+
+    @Test
+    void readmeLinksResolveToPagesAndHeadings(@TempDir Path site) throws IOException {
+        write(site, "index.md", "# Home\n");
+        write(site, "events/index.md", "## Catalog\n");
+        write(site, "events/control.md", "## TikTokConnectedEvent\n\n## connect() fails\n\n## The timeout and sub-second parts\n");
+        var readme = "Docs: https://ttlj.docs.isaackogan.com/\n"
+                + "- [onEvent](#onevent-tiktokevent) · [docs](https://ttlj.docs.isaackogan.com/events/)\n"
+                + "- [onConnected](#onconnected) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokconnectedevent)\n"
+                + "See https://ttlj.docs.isaackogan.com/events/control/#connect-fails and "
+                + "https://ttlj.docs.isaackogan.com/events/control#the-timeout-and-sub-second-parts.\n";
+        assertEquals(List.of(), ContentCheck.checkReadmeLinks(readme, ContentCheck.pages(site)));
+    }
+
+    @Test
+    void readmeLinkToMissingPageOrHeadingFails(@TempDir Path site) throws IOException {
+        write(site, "events/control.md", "## TikTokConnectedEvent\n");
+        var readme = "- [onComment](#oncomment) · [docs](https://ttlj.docs.isaackogan.com/events/chat/#tiktokcommentevent)\n"
+                + "- [onError](#onerror) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokerrorevent)\n"
+                + "- [onConnected](#onconnected) · [docs](https://ttlj.docs.isaackogan.com/events/control/#tiktokconnectedevent)\n";
+        assertEquals(List.of(
+                "README link has no page: https://ttlj.docs.isaackogan.com/events/chat/#tiktokcommentevent",
+                "README link has no heading: https://ttlj.docs.isaackogan.com/events/control/#tiktokerrorevent"),
+                ContentCheck.checkReadmeLinks(readme, ContentCheck.pages(site)));
+    }
+
+    @Test
+    void repositoryReadmeLinksResolve() throws IOException {
+        var readme = Files.readString(REPO.resolve("README.md"));
+        assertTrue(readme.contains(ContentCheck.SITE + "events/control/#tiktokconnectedevent"), "the README links the hosted event sections");
+        assertEquals(List.of(), ContentCheck.checkReadmeLinks(readme, ContentCheck.pages(REPO.resolve(Main.CONTENT_DIR))));
+    }
+
+    @Test
+    void slugMatchesStarlightAnchors() {
+        assertEquals("tiktokcommentevent", ContentCheck.slug("TikTokCommentEvent"));
+        assertEquals("tiktokcommentevent", ContentCheck.slug("`TikTokCommentEvent`"));
+        assertEquals("connect-fails", ContentCheck.slug("connect() fails"));
+        assertEquals("build-connect-or-both", ContentCheck.slug("Build, connect, or both"));
+        assertEquals(Set.of("a", "b-c"), ContentCheck.slugs("# A\n\ntext\n\n### B c\n"));
+    }
+
+    @Test
+    void fenceLanguageIsCaseInsensitive(@TempDir Path site) throws IOException {
+        write(site, "a.md", "```Java\nint a = 1;\n```\n\n```JAVA\nint b = 2;\n```\n\n```javascript\nconst c = 3;\n```\n");
+        var examples = ContentCheck.examples(ContentCheck.pages(site));
+        assertEquals(2, examples.size(), examples.toString());
+        assertEquals("int a = 1;", examples.get(0).code());
+        assertEquals("int b = 2;", examples.get(1).code());
+    }
+
+    @Test
+    void discordLinkFails(@TempDir Path site) throws IOException {
+        write(site, "t.md", "Join https://discord.gg/abc\n");
+        write(site, "ok.md", "Nothing here.\n");
+        assertEquals(List.of("t.md: published pages must not reference Discord"), ContentCheck.checkDiscord(ContentCheck.pages(site)));
+    }
+
+    @Test
+    void indentedFencesAreExtractedAndDedented(@TempDir Path site) throws IOException {
+        write(site, "a/b.md", """
+                Intro.
+
+                ```java
+                int a = 1;
+                ```
+
+                1. Step
+                   ```java title="Demo.java"
+                   int b = 2;
+                     int c = 3;
+                   ```
+
+                ```ts
+                const notJava = ```;
+                ```
+                """);
+        var examples = ContentCheck.examples(ContentCheck.pages(site));
+        assertEquals(2, examples.size(), examples.toString());
+        assertEquals("a/b.md, example 1", examples.get(0).label());
+        assertEquals("int a = 1;", examples.get(0).code());
+        assertEquals("a/b.md, example 2", examples.get(1).label());
+        assertEquals("int b = 2;\n  int c = 3;", examples.get(1).code());
+    }
+
+    @Test
+    void runPrintsEverySectionInOrderThenTheSummary() {
+        var bytes = new ByteArrayOutputStream();
+        var code = ContentCheck.run(REPO, new PrintStream(bytes, true, StandardCharsets.UTF_8));
+        var lines = bytes.toString(StandardCharsets.UTF_8).strip().split("\n");
+        var sections = List.of("events", "settings", "builder", "exceptions", "extensions", "discord", "readme", "examples");
+        assertEquals(sections.size() + 1, lines.length, String.join("\n", lines));
+        for (int i = 0; i < sections.size(); i++) {
+            assertTrue(lines[i].matches("(PASS " + sections.get(i) + "|FAIL " + sections.get(i) + ": .+)"), lines[i]);
+        }
+        assertTrue(lines[sections.size()].matches("Checked \\d+ pages, \\d+ events, \\d+ settings fields, \\d+ handlers, \\d+ exceptions, \\d+ Java examples\\."), lines[sections.size()]);
+        var anyFailed = String.join("\n", lines).contains("\nFAIL ") || lines[0].startsWith("FAIL ");
+        assertEquals(anyFailed ? 1 : 0, code);
+    }
+
+    private static void write(Path root, String relative, String text) throws IOException {
+        var path = root.resolve(relative);
+        Files.createDirectories(path.getParent());
+        Files.writeString(path, text);
+    }
+}
diff --git a/docs/tools/src/test/java/docs/ExampleCompilerTest.java b/docs/tools/src/test/java/docs/ExampleCompilerTest.java
new file mode 100644
index 00000000..c7d59dc4
--- /dev/null
+++ b/docs/tools/src/test/java/docs/ExampleCompilerTest.java
@@ -0,0 +1,148 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class ExampleCompilerTest {
+
+    static final Path REPO = Path.of(System.getProperty("repo.root")).toAbsolutePath().normalize();
+    static final String FRAGMENT = "TikTokLive.newClient(\"user\").onComment((client, event) -> System.out.println(event.getText())).buildAndConnect();";
+
+    @Test
+    void fragmentCompiles() {
+        assertEquals(List.of(), ExampleCompiler.compile(List.of(new Example("p.md, example 1", FRAGMENT)), REPO));
+    }
+
+    @Test
+    void fragmentWithUnknownMethodFails() {
+        var f = ExampleCompiler.compile(List.of(new Example("p.md, example 1",
+                "TikTokLive.newClient(\"user\").onComment((client, event) -> event.getComent());")), REPO);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).startsWith("p.md, example 1: line 1: "), f.get(0));
+        assertTrue(f.get(0).contains("getComent"), f.get(0));
+    }
+
+    @Test
+    void fragmentLineNumbersAreRelativeToTheFence() {
+        var f = ExampleCompiler.compile(List.of(
+                new Example("a.md, example 1", FRAGMENT),
+                new Example("b.md, example 3", "int a = 1;\n\nString s = a;")), REPO);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).startsWith("b.md, example 3: line 3: "), f.get(0));
+    }
+
+    @Test
+    void fragmentImportsAreHoisted() {
+        var code = "import java.util.concurrent.TimeUnit;\n\nTimeUnit.SECONDS.sleep(1);\n" + FRAGMENT;
+        assertEquals(List.of(), ExampleCompiler.compile(List.of(new Example("p.md, example 1", code)), REPO));
+    }
+
+    @Test
+    void errorsOnHoistedImportsPointAtTheImportLine() {
+        var code = "int a = 1;\n\nimport does.not.Exist;\n\n" + FRAGMENT;
+        var f = ExampleCompiler.compile(List.of(new Example("p.md, example 2", code)), REPO);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).startsWith("p.md, example 2: line 3: "), f.get(0));
+        assertTrue(f.get(0).contains("does.not"), f.get(0));
+    }
+
+    @Test
+    void fullUnitsWithTheSameHelperClassDoNotCollide() {
+        var a = "public class MainA {\n    Object run() {\n        return new Helper();\n    }\n}\n\nclass Helper {\n}\n";
+        var b = a.replace("MainA", "MainB");
+        assertEquals(List.of(), ExampleCompiler.compile(List.of(new Example("a.md, example 1", a), new Example("b.md, example 1", b)), REPO));
+        var broken = b.replace("return new Helper();", "return new Helper().missing();");
+        var f = ExampleCompiler.compile(List.of(new Example("a.md, example 1", a), new Example("b.md, example 1", broken)), REPO);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).startsWith("b.md, example 1: line 3: "), f.get(0));
+    }
+
+    @Test
+    void fullUnitCompilesAsIs() {
+        var unit = """
+                import io.github.jwdeveloper.tiktok.api.annotations.TikTokEventObserver;
+                import io.github.jwdeveloper.tiktok.api.data.events.TikTokCommentEvent;
+                import io.github.jwdeveloper.tiktok.api.listener.TikTokEventListenerBase;
+                import io.github.jwdeveloper.tiktok.api.live.LiveClient;
+
+                public class Demo extends TikTokEventListenerBase {
+
+                    @TikTokEventObserver
+                    public void onComment(LiveClient client, TikTokCommentEvent event) {
+                        System.out.println(event.getText());
+                    }
+                }
+                """;
+        var broken = unit.replace("event.getText()", "event.getComent()");
+        assertEquals(List.of(), ExampleCompiler.compile(List.of(new Example("l.md, example 1", unit)), REPO));
+        var f = ExampleCompiler.compile(List.of(new Example("l.md, example 1", broken)), REPO);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).startsWith("l.md, example 1: line 10: "), f.get(0));
+    }
+
+    @Test
+    void fullUnitsWithTheSameClassNameDoNotCollide() {
+        var main = "import io.github.jwdeveloper.tiktok.client.TikTokLive;\n\npublic class Main {\n    public static void main(String[] args) {\n        "
+                + FRAGMENT + "\n    }\n}\n";
+        var other = main.replace("newClient(\"user\")", "newClient(\"other\")");
+        assertEquals(List.of(), ExampleCompiler.compile(List.of(new Example("a.md, example 1", main), new Example("b.md, example 1", other)), REPO));
+        var broken = other.replace("event.getText()", "event.getComent()");
+        var f = ExampleCompiler.compile(List.of(new Example("a.md, example 1", main), new Example("b.md, example 1", broken)), REPO);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).startsWith("b.md, example 1: line 5: "), f.get(0));
+    }
+
+    @Test
+    void canaryGuardsVacuousPass(@TempDir Path fake) throws IOException {
+        for (var module : ExampleCompiler.MODULES) {
+            Files.createDirectories(fake.resolve(module).resolve("target/classes"));
+            Files.writeString(fake.resolve(module).resolve("target/classpath.txt"), "");
+        }
+        for (var module : JavaSources.MODULES) {
+            Files.createDirectories(fake.resolve(module).resolve("src/main/java"));
+        }
+        var f = ExampleCompiler.compile(List.of(), fake);
+        assertEquals(List.of("example compiler canary not flagged"), f);
+    }
+
+    @Test
+    void missingClasspathFileFails(@TempDir Path fake) throws IOException {
+        for (var module : JavaSources.MODULES) {
+            Files.createDirectories(fake.resolve(module).resolve("src/main/java"));
+        }
+        var f = ExampleCompiler.compile(List.of(new Example("p.md, example 1", FRAGMENT)), fake);
+        assertEquals(1, f.size(), f.toString());
+        assertTrue(f.get(0).contains("API/target/classpath.txt"), f.get(0));
+        assertTrue(f.get(0).contains(ExampleCompiler.BUILD_COMMAND), f.get(0));
+        assertTrue(ExampleCompiler.BUILD_COMMAND.startsWith("mvn -q -pl API,Client,extension-recorder,extension-collector -am -DskipTests install dependency:build-classpath -Dmdep.outputFile=target/classpath.txt"));
+    }
+}
diff --git a/docs/tools/src/test/java/docs/MarkdownTest.java b/docs/tools/src/test/java/docs/MarkdownTest.java
new file mode 100644
index 00000000..04f98016
--- /dev/null
+++ b/docs/tools/src/test/java/docs/MarkdownTest.java
@@ -0,0 +1,126 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import com.github.javaparser.ParserConfiguration;
+import com.github.javaparser.StaticJavaParser;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+/** Pins how Javadoc becomes Markdown: raw generics, {@code <pre>} blocks, links, pipes and {@code {@link}}. */
+class MarkdownTest {
+
+    /** A unit whose Javadoc carries each construct once; the library's own sources have none of the awkward ones. */
+    static final String SOURCE = """
+            package demo.pkg;
+
+            import java.util.List;
+
+            /**
+             * Holds a List<Gift> per room, keyed by id. A second sentence with a pipe | and <b>bold</b>.
+             * <p>
+             * Example:
+             * <pre>{@code
+             * var holder = new Holder();
+             * if (holder.size("a") < 2) {
+             *     holder.gifts.add("x");
+             * }
+             * }</pre>
+             * See <a href="https://example.com/docs">the docs</a> and {@link Holder#size(String)}.
+             */
+            public class Holder {
+                /** The gifts, a List<String> of names | nothing else. <pre>{@code holder.gifts.get(0)}</pre> */
+                public final List<String> gifts = List.of();
+
+                /**
+                 * Counts entries.
+                 *
+                 * @param filter a Predicate<Gift> text with a | pipe
+                 * @return the count, a | b
+                 */
+                public int size(String filter) {
+                    return 0;
+                }
+
+                /** A nested Map<K, V> holder. */
+                public static class Nested {
+                }
+            }
+            """;
+
+    @Test
+    void syntheticJavadocRendersGenericsPreLinksAndPipes(@TempDir Path out) throws IOException {
+        StaticJavaParser.setConfiguration(new ParserConfiguration().setLanguageLevel(ParserConfiguration.LanguageLevel.JAVA_17));
+        var unit = StaticJavaParser.parse(SOURCE);
+        ApiPages.render(List.of(unit), "0.0", ApiPagesTest.SOURCE_BASE, out);
+
+        var root = Files.readString(out.resolve("index.md"));
+        assertTrue(root.contains("\n- [`Holder`](/api/demo/pkg/holder/) (`demo.pkg`) — Holds a List\\<Gift> per room, keyed by id.\n"),
+                "root listing keeps the generic escaped:\n" + root);
+        var pkg = Files.readString(out.resolve("demo/pkg/index.md"));
+        assertTrue(pkg.contains("\n- [`Holder`](/api/demo/pkg/holder/) — Holds a List\\<Gift> per room, keyed by id.\n"),
+                "package listing keeps the generic escaped:\n" + pkg);
+
+        var page = Files.readString(out.resolve("demo/pkg/holder.md"));
+        assertTrue(page.startsWith("---\ntitle: Holder\ndescription: \"Holds a List<Gift> per room, keyed by id.\"\n"),
+                "description frontmatter is the plain sentence:\n" + page);
+        assertTrue(page.contains("\nHolds a List\\<Gift> per room, keyed by id. A second sentence with a pipe | and **bold**.\n\nExample:\n\n"
+                + "```\n"
+                + "var holder = new Holder();\n"
+                + "if (holder.size(\"a\") < 2) {\n"
+                + "    holder.gifts.add(\"x\");\n"
+                + "}\n"
+                + "```\n\n"
+                + "See [the docs](https://example.com/docs) and `Holder.size(String)`.\n"),
+                "body: escaped generic, bold, raw fenced block with braces and indentation, link, {@link}:\n" + page);
+        assertTrue(page.contains("\n- **`gifts`** (`List<String>`) — The gifts, a List\\<String> of names | nothing else. `holder.gifts.get(0)`\n"),
+                "field bullet: generic escaped, pipe kept, <pre> as a code span:\n" + page);
+        assertFalse(page.contains("```\n- ") || page.contains(" ```"), "no fence on a bullet:\n" + page);
+        assertTrue(page.contains("\n- **`filter`** (`String`) — a Predicate\\<Gift> text with a | pipe\n"), "parameter bullet:\n" + page);
+        assertTrue(page.contains("\n#### Returns\n\n`int` — the count, a | b\n"), "returns line:\n" + page);
+        assertTrue(page.contains("\n- [`Holder.Nested`](/api/demo/pkg/holder-nested/) (class) — A nested Map\\<K, V> holder.\n"),
+                "nested-type list keeps the generic escaped:\n" + page);
+
+        var nested = Files.readString(out.resolve("demo/pkg/holder-nested.md"));
+        assertTrue(nested.contains("\ndescription: \"A nested Map<K, V> holder.\"\n"), "nested description is plain:\n" + nested);
+    }
+
+    @Test
+    void cellEscapesPipes() {
+        assertEquals("the count, a \\| b", Markdown.cell(" the count,\n a | b "));
+    }
+
+    @Test
+    void plainRemovesTheEscapeSummaryKeeps() {
+        assertEquals("Holds a List<Gift>.", Markdown.plain("Holds a List\\<Gift>."));
+        assertEquals("a `code` span", Markdown.plain("a `code` span"));
+    }
+}
diff --git a/docs/tools/src/test/java/docs/ProtoParserTest.java b/docs/tools/src/test/java/docs/ProtoParserTest.java
new file mode 100644
index 00000000..abf98e79
--- /dev/null
+++ b/docs/tools/src/test/java/docs/ProtoParserTest.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class ProtoParserTest {
+
+    static final Path REPO = Path.of(System.getProperty("repo.root")).toAbsolutePath().normalize();
+
+    @Test
+    void parsesMessagesEnumsAndNested() {
+        var f = ProtoParser.parse(REPO.resolve("API/src/main/proto/webcast.proto"));
+        assertEquals("webcast", f.name());
+        assertEquals("TikTok", f.pkg());
+        assertEquals("io.github.jwdeveloper.tiktok.api.messages.webcast", f.javaPackage());
+        assertTrue(f.messages().stream().anyMatch(m -> m.name().equals("WebcastChatMessage")));
+        assertTrue(f.messages().stream().anyMatch(m -> !m.nested().isEmpty()), "a message with nested messages");
+        assertTrue(f.messages().stream().anyMatch(m -> !m.nestedEnums().isEmpty()), "a message with nested enums");
+        assertTrue(f.messages().stream().allMatch(m -> m.parent() == null), "top-level messages have no parent");
+        var pin = f.messages().stream().filter(m -> m.name().equals("WebcastRoomPinMessage")).findFirst().orElseThrow();
+        assertTrue(pin.fields().stream().anyMatch(x -> x.name().equals("chat_message") && x.label().equals("oneof")), "oneof member");
+        assertTrue(f.messages().stream().noneMatch(m -> m.name().equals("RoomMessage")), "block-commented messages are ignored");
+        var enums = ProtoParser.parse(REPO.resolve("API/src/main/proto/enums.proto"));
+        assertTrue(enums.messages().isEmpty());
+        assertTrue(enums.enums().size() > 90, "enums: " + enums.enums().size());
+    }
+
+    @Test
+    void parsesRepeatedMapAndOneof(@TempDir Path dir) throws IOException {
+        var source = """
+                syntax = "proto3";
+                package Fixture; // trailing comment
+                option java_package = "fixture.gen";
+                /* a block comment
+                   message Ghost { int32 x = 1; } */
+                import "other.proto";
+
+                // A message.
+                message Outer {
+                  option deprecated = true;
+                  reserved 9, 10 to 12;
+                  reserved "old";
+                  string name = 1;
+                  repeated Inner items = 2;
+                  map<string, int32> counts = 3 [deprecated = true];
+                  optional bool flag = 4;;
+                  oneof choice
+                  {
+                    Inner first = 5;
+                    int64 second = 6;
+                  }
+                  message Inner {
+                    Kind kind = 1;
+                    enum Kind { UNKNOWN = 0; ODD = -1; }
+                  }
+                }
+                enum Color { RED = 0; GREEN = 1; }
+                """;
+        var file = dir.resolve("fixture.proto");
+        Files.writeString(file, source);
+        var f = ProtoParser.parse(file);
+        assertEquals("fixture", f.name());
+        assertEquals("Fixture", f.pkg());
+        assertEquals("notes", ProtoParser.parse("syntax = \"proto3\";", "dir/sub/Notes.proto").name(), "stem from a path");
+        assertEquals("inline", ProtoParser.parse("syntax = \"proto3\";", "inline").name(), "a bare label is its own stem");
+        assertEquals("fixture.gen", f.javaPackage());
+        assertEquals(1, f.messages().size());
+        assertEquals(1, f.enums().size());
+        assertEquals("Color", f.enums().get(0).name());
+        assertEquals(2, f.enums().get(0).values().size());
+        assertEquals(1, f.enums().get(0).values().get(1).number());
+
+        var outer = f.messages().get(0);
+        assertEquals("Outer", outer.name());
+        assertNull(outer.parent());
+        var fields = outer.fields();
+        assertEquals(6, fields.size(), "fields: " + fields);
+        assertEquals(new ProtoField("", "string", "name", 1), fields.get(0));
+        assertEquals(new ProtoField("repeated", "Inner", "items", 2), fields.get(1));
+        assertEquals(new ProtoField("map", "map<string, int32>", "counts", 3), fields.get(2));
+        assertEquals(new ProtoField("optional", "bool", "flag", 4), fields.get(3));
+        assertEquals(new ProtoField("oneof", "Inner", "first", 5), fields.get(4));
+        assertEquals(new ProtoField("oneof", "int64", "second", 6), fields.get(5));
+
+        assertEquals(1, outer.nested().size());
+        var inner = outer.nested().get(0);
+        assertEquals("Inner", inner.name());
+        assertEquals("Outer", inner.parent());
+        assertEquals(1, inner.nestedEnums().size());
+        var kind = inner.nestedEnums().get(0);
+        assertEquals("Kind", kind.name());
+        assertEquals(new ProtoEnumValue("ODD", -1), kind.values().get(1));
+    }
+}
diff --git a/docs/tools/src/test/java/docs/SchemaPagesTest.java b/docs/tools/src/test/java/docs/SchemaPagesTest.java
new file mode 100644
index 00000000..85fabafb
--- /dev/null
+++ b/docs/tools/src/test/java/docs/SchemaPagesTest.java
@@ -0,0 +1,92 @@
+/*
+ * Copyright (c) 2023-2024 jwdeveloper jacekwoln@gmail.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package docs;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class SchemaPagesTest {
+
+    static final Path REPO = Path.of(System.getProperty("repo.root")).toAbsolutePath().normalize();
+    static final String VERSION = "1.13.1-Release";
+
+    private static List<ProtoFile> files() {
+        return List.of(
+                ProtoParser.parse(REPO.resolve("API/src/main/proto/webcast.proto")),
+                ProtoParser.parse(REPO.resolve("API/src/main/proto/data.proto")),
+                ProtoParser.parse(REPO.resolve("API/src/main/proto/enums.proto")));
+    }
+
+    @Test
+    void nestedMessageGetsPage(@TempDir Path out) throws IOException {
+        var paths = SchemaPages.render(files(), VERSION, out);
+        assertTrue(Files.exists(out.resolve("webcast/webcastchatmessage.md")));
+        assertTrue(paths.stream().anyMatch(p -> p.getFileName().toString().contains("-")), "a nested type page named outer-inner");
+        assertTrue(paths.size() > 300, "pages: " + paths.size());
+        var index = Files.readString(out.resolve("index.md"));
+        assertTrue(index.startsWith("---\ntitle: TikTok Webcast schema (" + VERSION + ")\n"), "index title");
+        assertTrue(Files.exists(out.resolve("webcast/index.md")), "per-file index");
+        assertTrue(Files.exists(out.resolve("enums/auditstatus.md")), "enum page");
+    }
+
+    @Test
+    void fieldsTableLinksTypesAcrossFiles(@TempDir Path out) throws IOException {
+        SchemaPages.render(files(), VERSION, out);
+        var chat = Files.readString(out.resolve("webcast/webcastchatmessage.md"));
+        assertTrue(chat.startsWith("---\ntitle: WebcastChatMessage\n"), "title");
+        assertTrue(chat.contains("| Field | Type | Number | Label |"), "fields table header");
+        assertTrue(chat.contains("[`CommonMessageData`](/schema/data/commonmessagedata/)"), "cross-file link to data.proto: " + chat);
+        var pin = Files.readString(out.resolve("webcast/webcastroompinmessage.md"));
+        assertTrue(pin.contains("| oneof |"), "oneof label column");
+        assertTrue(pin.contains("[`WebcastChatMessage`](/schema/webcast/webcastchatmessage/)"), "same-file link");
+    }
+
+    @Test
+    void nestedPageIsTitledOuterDotInner(@TempDir Path out) throws IOException {
+        var paths = SchemaPages.render(files(), VERSION, out);
+        var nested = paths.stream().filter(p -> p.getFileName().toString().contains("-")).findFirst().orElseThrow();
+        var md = Files.readString(nested);
+        assertTrue(md.startsWith("---\ntitle: "), "frontmatter");
+        var title = md.lines().skip(1).findFirst().orElseThrow();
+        assertTrue(title.matches("title: \"?[A-Za-z0-9_]+\\.[A-Za-z0-9_.]+\"?"), "Outer.Inner title: " + title);
+        assertTrue(md.contains("Nested in ["), "link back to the enclosing message: " + nested);
+    }
+
+    @Test
+    void outputIsDeterministic(@TempDir Path a, @TempDir Path b) throws IOException {
+        var first = SchemaPages.render(files(), VERSION, a);
+        var second = SchemaPages.render(files(), VERSION, b);
+        assertEquals(first.stream().map(p -> a.relativize(p).toString()).toList(),
+                second.stream().map(p -> b.relativize(p).toString()).toList());
+        for (var p : first) {
+            assertEquals(Files.readString(p), Files.readString(b.resolve(a.relativize(p))), a.relativize(p).toString());
+        }
+    }
+}
diff --git a/docs/tsconfig.json b/docs/tsconfig.json
new file mode 100644
index 00000000..8bf91d3b
--- /dev/null
+++ b/docs/tsconfig.json
@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}
diff --git a/docs/wrangler.jsonc b/docs/wrangler.jsonc
new file mode 100644
index 00000000..7dc06854
--- /dev/null
+++ b/docs/wrangler.jsonc
@@ -0,0 +1,13 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "tiktoklivejava-docs",
+  "compatibility_date": "2026-10-20",
+  "assets": {
+    "directory": "./dist",
+    "html_handling": "auto-trailing-slash",
+    "not_found_handling": "404-page"
+  },
+  // The custom domain ttlj.docs.isaackogan.com is attached to the Worker once by a maintainer
+  // and survives deploys, so no routes are declared here and the CI token needs no zone permission.
+  "workers_dev": false
+}