feat(docs): add llms.txt generation and the Context7 configuration (#109)

Author: myromartsin

apps/docs/astro.config.mjs

@@ -1,6 +1,7 @@
 // @ts-check
 import starlight from '@astrojs/starlight';
 import { defineConfig } from 'astro/config';
+import starlightLlmsTxt from 'starlight-llms-txt';
 import { AVAILABLE_PACKAGES } from './src/package-registry';
 
 export default defineConfig({
@@ -15,6 +16,8 @@ export default defineConfig({
       },
       description:
         'Phone number parsing, validation, formatting, and a headless input controller for JavaScript and TypeScript. Verified against Google libphonenumber.',
+      // llms.txt, llms-full.txt, and llms-small.txt for AI assistant retrieval.
+      plugins: [starlightLlmsTxt()],
       favicon: '/favicon.svg',
       social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/martsinlabs/telixon' }],
       editLink: { baseUrl: 'https://github.com/martsinlabs/telixon/edit/main/apps/docs/' },

apps/docs/package.json

@@ -15,7 +15,8 @@
     "@telixon/core": "workspace:*",
     "@telixon/web-sdk": "workspace:*",
     "astro": "^7.0.5",
-    "sharp": "^0.35.3"
+    "sharp": "^0.35.3",
+    "starlight-llms-txt": "^0.11.0"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.9",

context7.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://context7.com/schema/context7.json",
+  "projectTitle": "Telixon",
+  "description": "Phone number parsing, validation, formatting, and a headless input controller for JavaScript and TypeScript. Verified against Google libphonenumber.",
+  "folders": ["apps/docs/src/content/docs", "packages/core", "packages/web-sdk"],
+  "excludeFolders": [
+    "packages/core/src",
+    "packages/core/dist",
+    "packages/core/oracle",
+    "packages/core/bench",
+    "packages/core/conformance",
+    "packages/web-sdk/src",
+    "packages/web-sdk/dist"
+  ],
+  "excludeFiles": ["CHANGELOG.md"],
+  "rules": [
+    "Telixon is a standalone library with its own engine compiled from Google libphonenumber metadata; it has no runtime dependency on any other phone number library.",
+    "Initialize the engine with ensureEngineReady before calling parse or controller APIs; ensureEngineReadySync from @telixon/core/sync-init is the synchronous entry.",
+    "Use @telixon/core for parsing, formatting, and validation; use @telixon/web-sdk to attach the input controller to a DOM input element.",
+    "The full documentation lives at https://telixon.dev and the conformance dashboards at https://proof.telixon.dev."
+  ]
+}