Merge branch 'hey-api:main' into main

Author: TS-REACT0806

.changeset/soft-wolves-develop.md

@@ -0,0 +1,5 @@
+---
+"@hey-api/openapi-ts": patch
+---
+
+feat(parser): input supports ReadMe API Registry with `readme:` prefix

.gitattributes

@@ -1 +1,5 @@
 * text=auto eol=lf
+bun.lockb linguist-generated=true
+package-lock.json linguist-generated=true
+pnpm-lock.yaml linguist-generated=true
+yarn.lock linguist-generated=true

.github/dependabot.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       matrix:
         os: [macos-latest, ubuntu-latest, windows-latest]
-        node-version: ['18.20.5', '20.11.1', '22.11.0']
+        node-version: ['20.19.0', '22.12.0']
     steps:
       - uses: actions/[email protected]
         with:
@@ -38,7 +38,7 @@ jobs:
         run: pnpm build --filter="@hey-api/**"
 
       - name: Build examples
-        if: matrix.node-version == '22.11.0' && matrix.os == 'ubuntu-latest'
+        if: matrix.node-version == '22.12.0' && matrix.os == 'ubuntu-latest'
         run: pnpm build --filter="@examples/**"
 
       - name: Run linter
@@ -54,7 +54,7 @@ jobs:
         run: pnpm test:e2e
 
       - name: Publish preview packages
-        if: github.event_name == 'pull_request' && matrix.node-version == '22.11.0' && matrix.os == 'ubuntu-latest'
+        if: github.event_name == 'pull_request' && matrix.node-version == '22.12.0' && matrix.os == 'ubuntu-latest'
         run: ./scripts/publish-preview-packages.sh
         env:
           TURBO_SCM_BASE: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}

.github/workflows/ci.yml

@@ -1 +1 @@
-22.11.0
+22.12.0

.nvmrc

@@ -0,0 +1,26 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Load your exported graph
+const nodes = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, 'graph.json'), 'utf-8'),
+);
+
+// Annotate nodes with children count
+const annotatedNodes = nodes.map((n) => ({
+  childrenCount: n.childrenPointers?.length ?? 0,
+  pointer: n.pointer,
+}));
+
+// Sort by childrenCount descending
+annotatedNodes.sort((a, b) => b.childrenCount - a.childrenCount);
+
+// Print top 20 hotspots
+console.log('Top 20 potential bottleneck nodes:\n');
+annotatedNodes.slice(0, 20).forEach((n) => {
+  console.log(`${n.pointer} — children: ${n.childrenCount}`);
+});

debug-helpers/graph-hotspots.js

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const nodes = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, 'graph.json'), 'utf-8'),
+);
+
+// --- Filter nodes for readability ---
+const threshold = 10; // high-fanout threshold
+const filteredSet = new Set();
+
+// Include nodes with children > threshold and their immediate children
+for (const n of nodes) {
+  const childCount = n.childrenPointers?.length ?? 0;
+  if (childCount > threshold) {
+    filteredSet.add(n.pointer);
+    for (const child of n.childrenPointers || []) {
+      filteredSet.add(child);
+    }
+  }
+}
+
+// Filtered nodes list
+const filteredNodes = nodes.filter((n) => filteredSet.has(n.pointer));
+
+// Start the .dot file
+let dot = 'digraph OpenAPIGraph {\nrankdir=LR;\nnode [style=filled];\n';
+
+// Add nodes with color based on fanout
+for (const n of filteredNodes) {
+  const childCount = n.childrenPointers?.length ?? 0;
+  const color =
+    childCount > 50 ? 'red' : childCount > 20 ? 'orange' : 'lightgray';
+  dot += `"${n.pointer}" [label="${n.pointer}\\n${childCount} children", fillcolor=${color}];\n`;
+}
+
+// Add edges: node -> its children
+for (const n of filteredNodes) {
+  for (const child of n.childrenPointers || []) {
+    if (filteredSet.has(child)) {
+      dot += `"${n.pointer}" -> "${child}";\n`;
+    }
+  }
+}
+
+dot += '}\n';
+
+// Write to a file
+fs.writeFileSync(path.resolve(__dirname, 'graph.dot'), dot);
+console.log('graph.dot created!');
+
+// Instructions:
+// Render with Graphviz:
+// dot -Tpng graph.dot -o graph.png
+// or
+// dot -Tsvg graph.dot -o graph.svg

debug-helpers/json-to-dot.js

@@ -94,6 +94,10 @@ export default defineConfig({
                 link: '/openapi-ts/clients/fetch',
                 text: 'Fetch API',
               },
+              {
+                link: '/openapi-ts/clients/angular',
+                text: 'Angular',
+              },
               {
                 link: '/openapi-ts/clients/axios',
                 text: 'Axios',
@@ -106,10 +110,6 @@ export default defineConfig({
                 link: '/openapi-ts/clients/nuxt',
                 text: 'Nuxt',
               },
-              {
-                link: '/openapi-ts/clients/angular',
-                text: 'Angular <span data-soon>soon</span>',
-              },
               {
                 link: '/openapi-ts/clients/effect',
                 text: 'Effect <span data-soon>soon</span>',
@@ -218,6 +218,10 @@ export default defineConfig({
           {
             collapsed: true,
             items: [
+              {
+                link: '/openapi-ts/plugins/angular',
+                text: 'Angular',
+              },
               {
                 link: '/openapi-ts/plugins/fastify',
                 text: 'Fastify',

docs/.vitepress/config/en.ts

@@ -1,19 +1,12 @@
 import { defineConfig } from 'vitepress';
 
-import en from './en';
-import shared from './shared';
+import en from './en.js';
+import shared from './shared.js';
 
 export default defineConfig({
   ...shared,
   locales: {
     ...shared.locales,
     root: { label: 'English', ...en },
   },
-  vite: {
-    ...shared.vite,
-    resolve: {
-      ...shared.vite?.resolve,
-      preserveSymlinks: true,
-    },
-  },
 });

docs/.vitepress/config/index.ts

@@ -1,4 +1,7 @@
+import path from 'node:path';
+
 import { defineConfig, type HeadConfig } from 'vitepress';
+import llmstxt from 'vitepress-plugin-llms';
 
 const domain = process.env.SITE_DOMAIN || 'http://localhost:5173';
 
@@ -32,14 +35,13 @@ export default defineConfig({
         type: 'image/png',
       },
     ],
-    [
-      'script',
-      {},
-      'window.va = window.va || function () { (window.vaq = window.vaq || []).push(arguments); };',
-    ],
     process.env.NODE_ENV === 'production' && [
       'script',
-      { defer: '', src: '/_vercel/insights/script.js' },
+      {
+        'data-website-id': '4dffba2d-03a6-4358-9d90-229038c8575d',
+        defer: '',
+        src: 'https://cloud.umami.is/script.js',
+      },
     ],
   ].filter(Boolean) as Array<HeadConfig>,
   lastUpdated: true,
@@ -54,10 +56,18 @@ export default defineConfig({
     externalLinkIcon: true,
     logo: '/images/logo-48w.png',
     search: {
-      provider: 'local',
+      options: {
+        apiKey: '2565c35b4ad91c2f8f8ae32cf9bbe899',
+        appId: 'OWEH2O8E50',
+        disableUserPersonalization: false,
+        indexName: 'openapi-ts docs',
+        insights: true,
+      },
+      provider: 'algolia',
     },
     socialLinks: [
       { icon: 'linkedin', link: 'https://linkedin.com/company/heyapi' },
+      { icon: 'bluesky', link: 'https://bsky.app/profile/heyapi.dev' },
       { icon: 'x', link: 'https://x.com/mrlubos' },
       { icon: 'github', link: 'https://github.com/hey-api/openapi-ts' },
     ],
@@ -99,4 +109,30 @@ export default defineConfig({
       ],
     );
   },
+  vite: {
+    plugins: [
+      llmstxt({
+        experimental: {
+          depth: 2,
+        },
+      }),
+    ],
+    resolve: {
+      alias: [
+        {
+          find: '@components',
+          replacement: path.resolve(__dirname, '..', 'theme', 'components'),
+        },
+        {
+          find: '@data',
+          replacement: path.resolve(__dirname, '..', '..', 'data'),
+        },
+        {
+          find: '@versions',
+          replacement: path.resolve(__dirname, '..', 'theme', 'versions'),
+        },
+      ],
+      preserveSymlinks: true,
+    },
+  },
 });