feat: use typedoc for api docs page

README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src=".github/assets/tsky-logo.png" width="200" height="200">
+  <img src="https://raw.githubusercontent.com/tsky-dev/tsky/refs/heads/main/.github/assets/tsky-logo.png" width="200" height="200">
 </p>
 
 <h1 align="center">tsky</h1>
@@ -82,4 +82,4 @@ If you want to contribute to this project, please read the [CONTRIBUTING.md](CON
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/tsky-dev/tsky/blob/main/LICENSE) file for details.

biome.json

@@ -17,7 +17,8 @@
       "node_modules",
       "package.json",
       "tsconfig.json",
-      "packages/lexicons/src/lib/lexicons.ts"
+      "packages/lexicons/src/lib/lexicons.ts",
+      "docs/api/"
     ]
   },
   "linter": {

docs/.gitignore

@@ -1,2 +1,3 @@
 .vitepress/cache/
 .vitepress/dist/
+api/

docs/.nvmrc

@@ -0,0 +1 @@
+22

docs/.vitepress/config.mts

@@ -1,4 +1,5 @@
 import { defineConfig } from 'vitepress';
+import typedocSidebar from '../api/typedoc-sidebar.json';
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
@@ -12,15 +13,7 @@ export default defineConfig({
 
     sidebar: [
       { text: 'Getting Started', link: '/getting-started' },
-      {
-        text: 'API Reference',
-        link: '/api',
-        items: [
-          { text: 'new Tsky', link: '/api#tsky' },
-          { text: 'tsky.profile', link: '/api#profile' },
-          { text: 'tsky.typeahead', link: '/api#typeahead' },
-        ],
-      },
+      { text: 'API', items: typedocSidebar },
       {
         text: 'Examples',
         link: '/examples',

docs/index.md

@@ -4,6 +4,7 @@ layout: home
 
 hero:
   name: "tsky"
+  image: https://raw.githubusercontent.com/tsky-dev/tsky/refs/heads/main/.github/assets/tsky-logo.png
   text: "A Bluesky API client for nimble apps and tools"
   tagline: A Bluesky API client for nimble apps and tools
   actions:

docs/package.json

@@ -1,15 +1,20 @@
-{
-  "name": "@tsky/docs",
-  "version": "1.0.0",
-  "private": true,
-  "main": "index.js",
-  "scripts": {
-    "dev": "vitepress dev",
-    "build": "vitepress build",
-    "preview": "vitepress preview",
-    "test": "echo \"Error: no test specified\""
-  },
-  "devDependencies": {
-    "vitepress": "^1.5.0"
-  }
-}
+{
+  "name": "@tsky/docs",
+  "version": "1.0.0",
+  "private": true,
+  "main": "index.js",
+  "scripts": {
+    "predev": "typedoc",
+    "dev": "vitepress dev",
+    "prebuild": "typedoc",
+    "build": "vitepress build",
+    "preview": "vitepress preview",
+    "test": "echo \"Error: no test specified\""
+  },
+  "devDependencies": {
+    "typedoc": "^0.27.1",
+    "typedoc-plugin-markdown": "^4.3.0",
+    "typedoc-vitepress-theme": "^1.1.0",
+    "vitepress": "^1.5.0"
+  }
+}

docs/typedoc.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://typedoc-plugin-markdown.org/schema.json",
+  "entryPoints": ["../packages/client"],
+  "plugin": ["typedoc-plugin-markdown", "typedoc-vitepress-theme"],
+  "name": "Packages Example",
+  "entryPointStrategy": "packages",
+  "packageOptions": {
+    "includeVersion": true,
+    "entryPoints": ["src/*.ts"]
+  },
+  "basePath": "../packages/client/src",
+  "readme": "none",
+  "entryFileName": "index.md",
+  "mergeReadme": true,
+  "indexFormat": "table",
+  "useCodeBlocks": true,
+  "textContentMappings": {
+    "title.indexPage": "API Reference",
+    "title.memberPage": "{name}"
+  },
+  "outputs": [
+    {
+      "name": "markdown",
+      "path": "./api"
+    }
+  ],
+  "hidePageHeader": false,
+  "logLevel": "Verbose"
+}

packages/client/tsconfig.json

@@ -37,6 +37,6 @@
     "theme": "default",
     "exclude": "**/+(__tests__|__mocks__)/*",
     "excludePrivate": true,
-    "excludeProtected": true
-  }
+    "excludeProtected": true,
+  },
 }

packages/lex-cli/package.json

@@ -13,7 +13,7 @@
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
-    "prepublish": "pnpm run clean && pnpm run build"
+    "prepare": "pnpm run clean && pnpm run build"
   },
   "dependencies": {
     "clipanion": "4.0.0-rc.4",

packages/lexicons/package.json

@@ -20,7 +20,7 @@
     "build": "tsx ./scripts/generate-types.ts && tsc",
     "check-version-change": "tsx ./scripts/check-version-change.ts && tsc",
     "clean": "rm -rf dist && rm -rf lexicons",
-    "prepublish": "pnpm run clean && pnpm run build"
+    "prepare": "pnpm run clean && pnpm run build"
   },
   "devDependencies": {
     "@tsky/lex-cli": "workspace:*",