undocs 0.3.6 → 0.3.8

package/app/components/SocialButtons.vue

@@ -1,14 +1,6 @@
 <script setup lang="ts">
 const appConfig = useAppConfig()
 
-// const props = defineProps({
-//   socials: {
-//     type: Array,
-//     required: false,
-//     default: () => ['github', 'twitter', 'discord'],
-//   },
-// })
-
 const socialLinks = computed(() => {
   return (
     Object.entries({ github: appConfig.docs.github, ...appConfig.docs.socials })
@@ -22,7 +14,7 @@ const socialLinks = computed(() => {
           return {
             // Workaround: i-simple-icons-x i-simple-icons-github
             icon: `i-simple-icons-${key}`,
-            label: value,
+            label: titleCase(key),
             to: /^https?:\/\//.test(value) ? value : `https://${key}.com/${value}`,
           }
         }
@@ -33,15 +25,15 @@ const socialLinks = computed(() => {
 })
 </script>
 <template>
-  <UButton
-    v-for="link of socialLinks"
-    :key="link.label"
-    :aria-label="link.label"
-    :icon="link.icon"
-    :to="link.to"
-    target="_blank"
-    rel="noopener noreferrer"
-    color="neutral"
-    variant="ghost"
-  />
+  <UTooltip v-for="link of socialLinks" :key="link.label" :text="link.label">
+    <UButton
+      :aria-label="link.label"
+      :icon="link.icon"
+      :to="link.to"
+      target="_blank"
+      rel="noopener noreferrer"
+      color="neutral"
+      variant="ghost"
+    />
+  </UTooltip>
 </template>

package/app/content.config.ts

@@ -6,7 +6,7 @@ export default defineContentConfig({
       type: 'page',
       source: {
         cwd: globalThis.__DOCS_CWD__,
-        include: '**/*.md',
+        include: '**/*.{md,yml}',
         exclude: ['**/.**/**', '**/node_modules/**', '**/dist/**', '**/.docs/**'],
       },
     }),

package/app/layouts/docs.vue

@@ -9,13 +9,7 @@ const docsNav = useDocsNav()
         <UPageAside>
           <UPageAnchors :links="docsNav.links.filter((l) => l.title !== 'Blog')" />
           <USeparator v-if="docsNav.activeLinks?.length" type="dashed" class="py-6" />
-          <UContentNavigation
-            :navigation="docsNav.activeLinks"
-            default-open
-            trailing-icon="i-lucide-chevron-right"
-            :ui="{ linkTrailingIcon: 'group-data-[state=open]:rotate-90' }"
-            highlight
-          />
+          <UContentNavigation :navigation="docsNav.activeLinks" :collapsible="false" />
         </UPageAside>
       </template>
       <slot />

package/app/modules/content/hooks.ts

@@ -1,4 +1,4 @@
-import type { MarkdownRoot, MinimalNode, MinimalElement } from '@nuxt/content'
+import type { MarkdownRoot, MinimarkNode, MinimarkElement } from '@nuxt/content'
 import type { Nuxt } from 'nuxt/schema'
 import { CommonIcons } from './icons'
 import type { DocsConfig } from '../../../schema/config'
@@ -13,6 +13,9 @@ interface ParsedContentFile extends Record<string, unknown> {
   meta?: {
     icon?: string
   }
+  body?: {
+    icon?: string
+  }
 }
 
 export async function setupContentHooks(nuxt: Nuxt, docsConfig: DocsConfig) {
@@ -59,13 +62,14 @@ export async function setupContentHooks(nuxt: Nuxt, docsConfig: DocsConfig) {
   })
 
   nuxt.hooks.hook('content:file:afterParse', ({ content }) => {
+    // Infer icon for top level navigation
+    inferIcons(content)
+
     // Filter out non-markdown files
     if (content.extension !== 'md') {
       return
     }
 
-    resolveFileIcon(content)
-
     const body = content.body as MarkdownRoot
     removeFirstH1AndBlockquote(body, content)
     body.value = mergeCodeGroups(body.value)
@@ -84,7 +88,7 @@ export async function setupContentHooks(nuxt: Nuxt, docsConfig: DocsConfig) {
 
 // Handle GitHub flavoured markdown blockquotes
 // https://github.com/orgs/community/discussions/16925
-function transformGithubAlert(node: MinimalNode) {
+function transformGithubAlert(node: MinimarkNode) {
   if (
     node[0] === 'blockquote' &&
     Array.isArray(node[2]) &&
@@ -97,17 +101,17 @@ function transformGithubAlert(node: MinimalNode) {
     // @ts-expect-error read-only
     node[0] = node[2][2][2].slice(1).toLowerCase()
     // @ts-expect-error read-only
-    node[2] = ['p', {}, ...node[2].slice(3)] as MinimalElement
+    node[2] = ['p', {}, ...node[2].slice(3)] as MinimarkElement
   }
 }
 
 // --- transform steps list ---
 
-function transformStepsList(node: MinimalNode) {
+function transformStepsList(node: MinimarkNode) {
   // CONVERT OL->LI to Steps
   if (Array.isArray(node) && node[0] === 'ol' && node.length > 3 && Array.isArray(node[2]) && node[2][0] === 'li') {
-    const stepsChildren = node.slice(2).map((li: MinimalNode) => {
-      return ['h4', {}, ...li.slice(2)] as MinimalElement
+    const stepsChildren = node.slice(2).map((li: MinimarkNode) => {
+      return ['h4', {}, ...li.slice(2)] as MinimarkElement
     })
     node.splice(0, Infinity, 'steps', { level: '4' }, ...stepsChildren)
   }
@@ -143,17 +147,34 @@ function removeFirstH1AndBlockquote(body: MarkdownRoot, content: ParsedContentFi
 
 // --- resolve icon ---
 
-function resolveFileIcon(content: ParsedContentFile) {
-  if (content.navigation?.icon) {
-    return
+function inferIcons(content: ParsedContentFile) {
+  const icon = content.meta?.icon || content.navigation?.icon || content.body?.icon || _resolveIcon(content.path)
+
+  if (content.navigation && !content.navigation.icon) {
+    content.navigation.icon = icon
+  }
+
+  if (content.body && !content.body.icon) {
+    content.body.icon = icon
+  }
+
+  if (content.meta && !content.meta.icon) {
+    content.meta.icon = icon
   }
-  content.navigation ||= {}
-  content.navigation.icon = content.meta.icon || _resolveIcon(content.path)
 }
 
 function _resolveIcon(path: string = '') {
   // Split the path into parts and reverse it
-  const paths = path.slice(1).split('/').reverse()
+  const paths = path
+    .slice(1)
+    .split('/')
+    .reverse()
+    .filter((p) => p && !p.startsWith('.'))
+
+  // Skip 2+ levels of directories
+  if (paths.length > 2) {
+    return
+  }
 
   // Search for icons in reverse order
   for (const p of paths) {
@@ -167,10 +188,10 @@ function _resolveIcon(path: string = '') {
 
 // --- Merge code groups ---
 
-function mergeCodeGroups(children: MinimalNode[] = []): MinimalNode[] {
-  const newChildren: MinimalNode[] = []
+function mergeCodeGroups(children: MinimarkNode[] = []): MinimarkNode[] {
+  const newChildren: MinimarkNode[] = []
 
-  let codeBlocks: MinimalNode[] = []
+  let codeBlocks: MinimarkNode[] = []
 
   for (let i = 0; i < children.length; i++) {
     if (_isNamedCodeBlock(children[i])) {
@@ -187,20 +208,20 @@ function mergeCodeGroups(children: MinimalNode[] = []): MinimalNode[] {
   return newChildren
 }
 
-function _isNamedCodeBlock(node: MinimalNode): boolean {
+function _isNamedCodeBlock(node: MinimarkNode): boolean {
   return node[0] === 'pre' && (node[1] as any)?.filename && node[2]?.[0] === 'code'
 }
 
 // --- transform automd jsdocs ---
 
-export function transformJSDocs(currChildIdx: number, children: MinimalNode[] = []) {
+export function transformJSDocs(currChildIdx: number, children: MinimarkNode[] = []) {
   if (!children?.length || !_isJSDocBlock(children[currChildIdx])) {
     return
   }
 
-  const fields: MinimalNode[] = []
+  const fields: MinimarkNode[] = []
 
-  const generateFields = (i: number): MinimalNode => {
+  const generateFields = (i: number): MinimarkNode => {
     const name = _parseJSDocName(children[i])
     const type = _parseJSDocType(children[i + 1])
 
@@ -212,7 +233,7 @@ export function transformJSDocs(currChildIdx: number, children: MinimalNode[] =
       type,
     }
 
-    const content: MinimalNode[] = []
+    const content: MinimarkNode[] = []
 
     i++
 
@@ -263,17 +284,17 @@ export function transformJSDocs(currChildIdx: number, children: MinimalNode[] =
   }
 }
 
-function _isJSDocBlock(children: MinimalNode): boolean {
+function _isJSDocBlock(children: MinimarkNode): boolean {
   return (
     children?.tag === 'h3' && children?.children?.[0]?.tag === 'code' && children?.children?.[0]?.type === 'element'
   )
 }
 
-function _parseJSDocName(node: MinimalNode): string {
+function _parseJSDocName(node: MinimarkNode): string {
   // Code block || id prop || empty string
   return node.children?.[0]?.children?.[0]?.value || node?.props?.id || ''
 }
-function _parseJSDocType(node: MinimalNode): string {
+function _parseJSDocType(node: MinimarkNode): string {
   const hasType = !!node?.children?.[0]?.children?.[0]?.children?.[0]?.value
   if (!hasType) {
     return ''
@@ -284,7 +305,7 @@ function _parseJSDocType(node: MinimalNode): string {
 
 // --- internal utils ---
 
-function _getTextContent(node: MinimalNode): string {
+function _getTextContent(node: MinimarkNode): string {
   if (!node) {
     return ''
   }

package/app/nuxt.config.ts

@@ -35,7 +35,7 @@ export default defineNuxtConfig({
   },
   content: {
     experimental: {
-      nativeSqlite: true,
+      sqliteConnector: 'native',
     },
     build: {
       markdown: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "undocs",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "repository": "unjs/undocs",
   "license": "MIT",
   "type": "module",
@@ -33,12 +33,13 @@
     "@headlessui/vue": "^1.7.23",
     "@iconify-json/logos": "^1.2.4",
     "@iconify-json/simple-icons": "^1.2.37",
-    "@nuxt/content": "https://pkg.pr.new/@nuxt/content@3390",
+    "@nuxt/content": "https://pkg.pr.new/@nuxt/content@3390?c5a9c95",
     "@nuxt/fonts": "^0.11.4",
     "@nuxt/ui-pro": "^3.1.3",
     "@nuxtjs/plausible": "^1.2.0",
     "@resvg/resvg-wasm": "^2.6.2",
     "automd": "^0.4.0",
+    "better-sqlite3": "^11.10.0",
     "c12": "^3.0.4",
     "citty": "^0.1.6",
     "consola": "^3.4.2",