docs: fix @see links (#1363)

docs/.vitepress/components/api-docs/method.vue

@@ -1,12 +1,13 @@
 <script setup lang="ts">
 import type { Method } from './method';
 import MethodParameters from './method-parameters.vue';
+import { slugify } from '../../shared/utils/slugify';
 
 const props = defineProps<{ method: Method }>();
 
 function seeAlsoToUrl(see: string): string {
   const [, module, method] = see.replace(/\(.*/, '').split('\.');
-  return module + '.html#' + method;
+  return module + '.html#' + slugify(method);
 }
 </script>
 

docs/.vitepress/shared/utils/slugify.ts

@@ -0,0 +1,16 @@
+export function slugify(value: string): string {
+  // Copied from https://github.com/vuejs/docs/blob/b392b068fb893e3ac6079710fe34decbde7a3be3/src/api/ApiIndex.vue#L50-L65
+  return (
+    value
+      // Replace special characters
+      .replace(/[\s~`!@#$%^&*()\-_+=[\]{}|\\;:"'<>,.?/]+/g, '-')
+      // Remove continuous separators
+      .replace(/\-{2,}/g, '-')
+      // Remove prefixing and trailing separators
+      .replace(/^\-+|\-+$/g, '')
+      // ensure it doesn't start with a number (like #123)
+      .replace(/^(\d)/, '_$1')
+      // lowercase
+      .toLowerCase()
+  );
+}

docs/api/ApiIndex.vue

@@ -2,6 +2,7 @@
 
 <script setup lang="ts">
 import { computed, ref } from 'vue';
+import { slugify } from '../.vitepress/shared/utils/slugify';
 import apiSearchIndex from './api-search-index.json';
 import { APIGroup } from './api-types';
 
@@ -42,23 +43,6 @@ const filtered = computed(() => {
     })
     .filter((i) => i) as APIGroup[];
 });
-
-// same as vitepress' slugify logic
-function slugify(text: string): string {
-  return (
-    text
-      // Replace special characters
-      .replace(/[\s~`!@#$%^&*()\-_+=[\]{}|\\;:"'<>,.?/]+/g, '-')
-      // Remove continuous separators
-      .replace(/\-{2,}/g, '-')
-      // Remove prefixing and trailing separators
-      .replace(/^\-+|\-+$/g, '')
-      // ensure it doesn't start with a number (like #123)
-      .replace(/^(\d)/, '_$1')
-      // lowercase
-      .toLowerCase()
-  );
-}
 </script>
 
 <template>