feat(icon): bundle content icons via icon:clientBundleIcons hook

The scan glob can't reach docs navigation icons (remote content under the
.data dot-dir + .navigation.yml dotfiles), so they were runtime-fetched and
flashed in on client-side navigation. Collect them from content at build time
and inject into the client bundle.

Author: benjamincanac

nuxt.config.ts

@@ -499,6 +499,27 @@ export default defineNuxtConfig({
     }
   },
   hooks: {
+    // Docs navigation icons come from content: local `content/**/.navigation.yml`
+    // and remote docs cloned into `.data/content` (at `modules:done`, before this
+    // hook runs). @nuxt/icon's scanner reaches neither — dotfiles and the `.data`
+    // dot-dir are skipped under `dot:false` — so those icons would be fetched at
+    // runtime and flash in on client-side navigation. Collect them here so they
+    // land in the client bundle. Unknown matches are harmlessly logged as failed.
+    'icon:clientBundleIcons': async (icons: Set<string>) => {
+      const { glob } = await import('tinyglobby')
+      const { readFile } = await import('node:fs/promises')
+      const files = await glob(
+        ['content/**/*.{md,yml,yaml}', '.data/content/**/*.{md,yml,yaml}'],
+        { cwd: resolve('.'), absolute: true, dot: true }
+      )
+      const re = /i-(lucide|vscode-icons|simple-icons|heroicons|logos|octicon)-([a-z0-9-]+)/g
+      await Promise.all(files.map(async (file) => {
+        const code = await readFile(file, 'utf8').catch(() => '')
+        for (const match of code.matchAll(re)) {
+          icons.add(`${match[1]}:${match[2]}`)
+        }
+      }))
+    },
     'content:file:beforeParse': async ({ file }) => {
       if (file.id.startsWith('docsv5/')) {
         file.body = file.body.replaceAll(/\(\/docs\/(?!\d\.x)/g, '(/docs/5.x/')
@@ -553,10 +574,11 @@ export default defineNuxtConfig({
       dir: resolve('./app/assets/icons')
     }],
     clientBundle: {
+      // Scan app source (incl. `.ts` nav/config) for icons. Content icons
+      // (incl. remote docs nav) are added via the `icon:clientBundleIcons`
+      // hook below, since the scanner can't reach `.data` or dotfiles.
       scan: {
-        // Default include adds nothing for `ts`; the explicit dot pattern is
-        // required because `dot:false` makes `*.yml` skip `.navigation.yml`.
-        globInclude: ['**/*.{vue,jsx,tsx,md,mdc,mdx,yml,yaml,ts}', '**/.*.{yml,yaml}']
+        globInclude: ['**/*.{vue,jsx,tsx,md,mdc,mdx,yml,yaml,ts}']
       },
       includeCustomCollections: true
     }