Merge pull request #2451 from hey-api/docs/angular

chore: update Angular docs

Author: mrlubos

docs/.vitepress/config/en.ts

@@ -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',
-              },
               {
                 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/index.ts

@@ -1,3 +1,5 @@
+import path from 'node:path';
+
 import { defineConfig } from 'vitepress';
 
 import en from './en';
@@ -13,6 +15,12 @@ export default defineConfig({
     ...shared.vite,
     resolve: {
       ...shared.vite?.resolve,
+      alias: {
+        ...shared.vite?.resolve?.alias,
+        '@components': path.resolve(__dirname, '..', 'theme', 'components'),
+        '@data': path.resolve(__dirname, '..', '..', 'data'),
+        '@versions': path.resolve(__dirname, '..', 'theme', 'versions'),
+      },
       preserveSymlinks: true,
     },
   },

docs/.vitepress/theme/index.ts

@@ -5,21 +5,10 @@ import DefaultTheme from 'vitepress/theme';
 // custom CSS must be imported after default theme to correctly apply styles
 import './custom.css';
 
-import AuthorsList from './components/AuthorsList.vue';
-import FeatureStatus from './components/FeatureStatus.vue';
-import Heading from './components/Heading.vue';
-import VersionLabel from './components/VersionLabel.vue';
-import VersionSwitcher from './components/VersionSwitcher.vue';
 import Layout from './Layout.vue';
 
 export default {
   Layout,
-  enhanceApp: ({ app }) => {
-    app.component('AuthorsList', AuthorsList);
-    app.component('FeatureStatus', FeatureStatus);
-    app.component('Heading', Heading);
-    app.component('VersionLabel', VersionLabel);
-    app.component('VersionSwitcher', VersionSwitcher);
-  },
+  enhanceApp: () => {},
   extends: DefaultTheme,
 } satisfies Theme;

docs/.vitepress/theme/versions/AngularVersionSwitcher.vue

@@ -0,0 +1,20 @@
+<script setup lang="ts">
+import VersionSwitcher from '@components/VersionSwitcher.vue';
+
+const versions = [
+  {
+    label: 'Angular 20',
+    short: 'v20',
+    value: 'v20',
+  },
+  {
+    label: 'Angular 19',
+    short: 'v19',
+    value: 'v19',
+  },
+];
+</script>
+
+<template>
+  <VersionSwitcher :values="versions" default="v20" />
+</template>

docs/openapi-ts/plugins/zod/ZodHeading.vue renamed to docs/.vitepress/theme/versions/ZodVersionSwitcher.vue

@@ -1,4 +1,6 @@
 <script setup lang="ts">
+import VersionSwitcher from '@components/VersionSwitcher.vue';
+
 const versions = [
   {
     label: 'Zod 4',
@@ -19,8 +21,5 @@ const versions = [
 </script>
 
 <template>
-  <Heading>
-    <slot />
-    <VersionSwitcher :values="versions" default="v4" />
-  </Heading>
+  <VersionSwitcher :values="versions" default="v4" />
 </template>

docs/data/people.ts

@@ -0,0 +1,14 @@
+type Person = {
+  github: string;
+  name: string;
+};
+
+export const jacobCohen: Person = {
+  github: 'https://github.com/jacobinu',
+  name: 'Jacob Cohen',
+};
+
+export const maxScopp: Person = {
+  github: 'https://github.com/max-scopp',
+  name: 'Max Scopp',
+};

docs/openapi-ts/clients.md

@@ -26,10 +26,10 @@ We all send HTTP requests in a slightly different way. Hey API doesn't force you
 Hey API natively supports the following clients.
 
 - [Fetch API](/openapi-ts/clients/fetch)
+- [Angular](/openapi-ts/clients/angular)
 - [Axios](/openapi-ts/clients/axios)
 - [Next.js](/openapi-ts/clients/next-js)
 - [Nuxt](/openapi-ts/clients/nuxt)
-- [Angular](/openapi-ts/clients/angular) <span data-soon>Soon</span>
 - [Effect](/openapi-ts/clients/effect) <span data-soon>Soon</span>
 - [Legacy](/openapi-ts/clients/legacy)