docs: Trying API reference once again

Author: iwoplaza

apps/typegpu-docs/astro.config.mjs

@@ -6,8 +6,7 @@ import starlight from '@astrojs/starlight';
 import tailwind from '@astrojs/tailwind';
 import { defineConfig } from 'astro/config';
 import starlightBlog from 'starlight-blog';
-import starlightTypeDoc, { typeDocSidebarGroup } from 'starlight-typedoc';
-import typegpu from 'unplugin-typegpu/rollup';
+import typegpu from 'unplugin-typegpu/vite';
 
 /**
  * @template T
@@ -29,22 +28,7 @@ export default defineConfig({
     starlight({
       title: 'TypeGPU',
       customCss: ['./src/tailwind.css', './src/fonts/font-face.css'],
-      plugins: stripFalsy([
-        starlightBlog(),
-        DEV &&
-          starlightTypeDoc({
-            entryPoints: [
-              '../../packages/typegpu/src/index.ts',
-              '../../packages/typegpu/src/data/index.ts',
-              '../../packages/typegpu/src/std/index.ts',
-            ],
-            tsconfig: '../../packages/typegpu/tsconfig.json',
-            typeDoc: {
-              excludeInternal: true,
-              excludeReferences: true,
-            },
-          }),
-      ]),
+      plugins: stripFalsy([starlightBlog()]),
       logo: {
         light: './src/assets/typegpu-logo-light.svg',
         dark: './src/assets/typegpu-logo-dark.svg',
@@ -169,7 +153,6 @@ export default defineConfig({
               label: 'Naming Convention',
               slug: 'reference/naming-convention',
             },
-            DEV && typeDocSidebarGroup,
           ]),
         },
       ]),

apps/typegpu-docs/package.json

@@ -5,6 +5,7 @@
   "scripts": {
     "dev:watch": "astro dev",
     "build": "astro check && astro build",
+    "docs": "typedoc",
     "preview": "astro preview",
     "astro": "astro"
   },
@@ -42,12 +43,11 @@
     "remeda": "^2.21.2",
     "sharp": "^0.32.5",
     "starlight-blog": "^0.17.3",
-    "starlight-typedoc": "^0.19.0",
     "tailwindcss": "^3.4.6",
     "tinybench": "^3.1.0",
     "typed-binary": "^4.0.0",
-    "typedoc": "^0.27.9",
-    "typedoc-plugin-markdown": "^4.3.0",
+    "typedoc": "^0.28.2",
+    "typedoc-plugin-markdown": "^4.6.2",
     "typegpu": "workspace:*",
     "typescript": "catalog:",
     "unplugin-typegpu": "workspace:*",

apps/typegpu-docs/typedoc.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "entryPoints": [
+    "../../packages/typegpu/src/index.ts",
+    "../../packages/typegpu/src/data/index.ts",
+    "../../packages/typegpu/src/std/index.ts"
+  ],
+  "plugin": ["typedoc-plugin-markdown"],
+  "tsconfig": "../../packages/typegpu/tsconfig.json",
+  "excludeInternal": true,
+  "excludeReferences": true,
+  "router": "category",
+  "out": "./src/content/docs/api"
+}

packages/typegpu/src/std/index.ts

@@ -1,3 +1,7 @@
+/**
+ * @module typegpu/std
+ */
+
 export { discard } from './discard.ts';
 
 export {