chore: add llms.txt generation for LLM-friendly docs (#39)

Generate llms.txt and llms-full.txt at docs build time following the
llmstxt.org standard. The concise index links to API sections while
the full file contains complete TypeScript type signatures for all 5
packages with an LLM agent instructions section.

- Add scripts/generate-llms-txt.ts (reads versions from package.json)
- Add static/robots.txt pointing sitemap to llms.txt
- Update docs workflow to run generation + copy static files
- Add docs:llms script to package.json

Author: faluciano

.github/workflows/docs.yml

@@ -42,6 +42,12 @@ jobs:
       - name: Generate API docs
         run: bun run docs
 
+      - name: Generate LLM-friendly docs
+        run: bun run scripts/generate-llms-txt.ts
+
+      - name: Copy static files
+        run: cp static/robots.txt docs/
+
       - uses: actions/configure-pages@v5
 
       - uses: actions/upload-pages-artifact@v3

package.json

@@ -15,6 +15,7 @@
     "release": "bun run scripts/publish.ts",
     "lint:changesets": "bun run scripts/lint-changeset-headers.ts",
     "docs": "typedoc",
+    "docs:llms": "bun run scripts/generate-llms-txt.ts",
     "size": "size-limit"
   },
   "devDependencies": {