feat(docs): migrate to vitepress with @unovue/reka-ui's theme (#224)

docs/scripts/utils.ts

@@ -0,0 +1,28 @@
+import type MarkdownIt from 'markdown-it'
+
+// Define a custom plugin to transform JSDoc @link tags
+export function transformJSDocLinks(md: MarkdownIt) {
+  md.core.ruler.push('transform-jsdoc-links', (state) => {
+    state.tokens.forEach((token) => {
+      if (token.type === 'inline' && token.children?.length) {
+        for (let i = 0; i < token.children.length; i++) {
+          const child = token.children[i]
+          if (child.type === 'text' && child.content.startsWith('{@link')) {
+            // eslint-disable-next-line regexp/no-super-linear-backtracking
+            const matches = child.content.match(/\{@link\s+(.*?)\}/)
+            if (matches) {
+              const linkText = matches[1]
+              const linkNode = new state.Token('link_open', 'a', 1)
+              linkNode.attrSet('href', linkText)
+              linkNode.attrSet('target', '_blank')
+              const textNode = new state.Token('text', '', 0)
+              textNode.content = 'reference'
+              token.children.splice(i, 1, linkNode, textNode, new state.Token('link_close', 'a', -1))
+              i += 2 // Skip the added link and text tokens
+            }
+          }
+        }
+      }
+    })
+  })
+}