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.

docs/.gitignore

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

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: /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/src/bsky/index.test.ts

@@ -2,14 +2,6 @@ import { CredentialManager } from '@atcute/client';
 import { describe, expect, it } from 'vitest';
 import { Tsky } from '~/index';
 
-const formatSecret = (secret: string | undefined) => {
-  if (!secret) {
-    throw new Error('Secret is required');
-  }
-
-  return secret.replace(/^tsky /g, '').trim();
-};
-
 const TEST_CREDENTIALS = {
   alice: {
     handle: 'alice.tsky.dev',

packages/client/tsconfig.json

@@ -36,6 +36,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:*",