fix: doc links

Author: cometloop

apps/documentation-website/src/components/Hero.tsx

@@ -10,46 +10,31 @@ import blurIndigoImage from '@/images/blur-indigo.png'
 
 const codeLanguage = 'typescript'
 
-const code = `// One-off wrapping — zero config
-const safeJSONParse = safe.wrap(JSON.parse)
-const [parsed, parseErr] = safeJSONParse(rawInput)
+const code = `// Wrap any function — zero config
+const safeParse = safe.wrap(JSON.parse)
+const [data, err] = safeParse(rawInput)
 
-const fetchUserOnce = safe.wrapAsync(fetchUserAsync)
-const [basicUser, basicError] = await fetchUserOnce('admin-456')
-
-// Configurable safety — from one function to many
+// Shared config for a whole domain
 const apiSafe = createSafe({
   parseError: errorParser,
-  parseResult: resultParser,
+  defaultError: fallbackError,
   onError: errorHook,
-  onSuccess: successHook,
-  onSettled: settledHook,
 })
 
 const fetchUser = apiSafe.wrapAsync(fetchUserAsync)
 const fetchPosts = apiSafe.wrapAsync(fetchPostsAsync)
 
-// Same shared config. Full type narrowing.
-const [user, userError] = await fetchUser('123')
-if (userError) return
-
-const [posts, postsError] = await fetchPosts(user.id)
-if (postsError) return
+// Same config. Full type narrowing.
+const [user, userErr] = await fetchUser('123')
+if (userErr) return
 
-console.log(user.name)
-console.log(posts.length)
-
-// Add resilience — retry with backoff + auto-cancel
-const fetchUserRetry = apiSafe.wrapAsync(fetchUserAsync, {
-  retry: { times: 3, waitBefore: (n) => n * 1000 },
-  abortAfter: 5000,
-  onRetry: (err, attempt) => console.log(\`Retry #\${attempt}...\`),
-})
+const [posts, postsErr] = await fetchPosts(user.id)
+console.log(user.name, posts.length)
 
 // Prefer objects? One call to switch.
 const objSafe = withObjects(apiSafe)
 const fetchPostsObj = objSafe.wrapAsync(fetchPostsAsync)
-const { ok, data, error } = await fetchPostsObj('123')
+const { ok, data: posts2, error } = await fetchPostsObj('123')
 `
 
 // const code = `import { safe } from '@cometloop/safe'

apps/documentation-website/src/components/MarkdocLink.tsx

@@ -0,0 +1,25 @@
+import Link from 'next/link'
+
+export function MarkdocLink({
+  href,
+  title,
+  children,
+}: {
+  href: string
+  title?: string
+  children: React.ReactNode
+}) {
+  if (href.startsWith('/') || href.startsWith('#')) {
+    return (
+      <Link href={href} title={title}>
+        {children}
+      </Link>
+    )
+  }
+
+  return (
+    <a href={href} title={title}>
+      {children}
+    </a>
+  )
+}

apps/documentation-website/src/markdoc/nodes.js

@@ -4,6 +4,7 @@ import yaml from 'js-yaml'
 
 import { DocsLayout } from '@/components/DocsLayout'
 import { Fence } from '@/components/Fence'
+import { MarkdocLink } from '@/components/MarkdocLink'
 
 let documentSlugifyMap = new Map()
 
@@ -50,6 +51,10 @@ const nodes = {
       },
     },
   },
+  link: {
+    ...defaultNodes.link,
+    render: MarkdocLink,
+  },
   fence: {
     render: Fence,
     attributes: {