fix: use rollupConfig and externals for deno doc module resolution

Author: devdumpling

nuxt.config.ts

@@ -97,6 +97,14 @@ export default defineNuxtConfig({
         '@shikijs/engine-javascript',
         '@shikijs/core',
       ],
+      external: ['@deno/doc'],
+    },
+    rollupConfig: {
+      output: {
+        paths: {
+          '@deno/doc': '@jsr/deno__doc',
+        },
+      },
     },
   },
 

shared/utils/npm.ts

@@ -1,61 +1,9 @@
 import { createError } from 'h3'
 import validatePackageName from 'validate-npm-package-name'
 
-/**
- * Parsed package parameters from URL path segments.
- */
-export interface ParsedPackageParams {
-  /** The npm package name (e.g., "vue", "@nuxt/kit") */
-  packageName: string
-  /** The version if specified (e.g., "3.4.0"), undefined otherwise */
-  version: string | undefined
-  /** Remaining path segments after the version (e.g., for file paths) */
-  rest: string[]
-}
-
-/**
- * Parse package name, optional version, and remaining path from URL segments.
- *
- * Supports these URL patterns:
- * - `/pkg` → { packageName: "pkg", version: undefined, rest: [] }
- * - `/pkg/v/1.2.3` → { packageName: "pkg", version: "1.2.3", rest: [] }
- * - `/pkg/v/1.2.3/src/index.ts` → { packageName: "pkg", version: "1.2.3", rest: ["src", "index.ts"] }
- * - `/@scope/pkg` → { packageName: "@scope/pkg", version: undefined, rest: [] }
- * - `/@scope/pkg/v/1.2.3` → { packageName: "@scope/pkg", version: "1.2.3", rest: [] }
- *
- * @param pkgParam - The raw package parameter from the URL (e.g., "vue/v/3.4.0/src/index.ts")
- * @returns Parsed package name, optional version, and remaining path segments
- *
- * @example
- * ```ts
- * parsePackageParam('vue')
- * // { packageName: 'vue', version: undefined, rest: [] }
- *
- * parsePackageParam('vue/v/3.4.0')
- * // { packageName: 'vue', version: '3.4.0', rest: [] }
- *
- * parsePackageParam('@nuxt/kit/v/1.0.0/src/index.ts')
- * // { packageName: '@nuxt/kit', version: '1.0.0', rest: ['src', 'index.ts'] }
- * ```
- */
-export function parsePackageParam(pkgParam: string): ParsedPackageParams {
-  const segments = pkgParam.split('/')
-  const vIndex = segments.indexOf('v')
-
-  if (vIndex !== -1 && vIndex < segments.length - 1) {
-    return {
-      packageName: segments.slice(0, vIndex).join('/'),
-      version: segments[vIndex + 1],
-      rest: segments.slice(vIndex + 2),
-    }
-  }
-
-  return {
-    packageName: segments.join('/'),
-    version: undefined,
-    rest: [],
-  }
-}
+// Re-export from separate file (avoids h3 dependency for unit tests)
+export { parsePackageParam } from './parse-package-param'
+export type { ParsedPackageParams } from './parse-package-param'
 
 /**
  * Validate an npm package name and throw an HTTP error if invalid.

shared/utils/parse-package-param.ts

@@ -0,0 +1,55 @@
+/**
+ * Parsed package parameters from URL path segments.
+ */
+export interface ParsedPackageParams {
+  /** The npm package name (e.g., "vue", "@nuxt/kit") */
+  packageName: string
+  /** The version if specified (e.g., "3.4.0"), undefined otherwise */
+  version: string | undefined
+  /** Remaining path segments after the version (e.g., for file paths) */
+  rest: string[]
+}
+
+/**
+ * Parse package name, optional version, and remaining path from URL segments.
+ *
+ * Supports these URL patterns:
+ * - `/pkg` → { packageName: "pkg", version: undefined, rest: [] }
+ * - `/pkg/v/1.2.3` → { packageName: "pkg", version: "1.2.3", rest: [] }
+ * - `/pkg/v/1.2.3/src/index.ts` → { packageName: "pkg", version: "1.2.3", rest: ["src", "index.ts"] }
+ * - `/@scope/pkg` → { packageName: "@scope/pkg", version: undefined, rest: [] }
+ * - `/@scope/pkg/v/1.2.3` → { packageName: "@scope/pkg", version: "1.2.3", rest: [] }
+ *
+ * @param pkgParam - The raw package parameter from the URL (e.g., "vue/v/3.4.0/src/index.ts")
+ * @returns Parsed package name, optional version, and remaining path segments
+ *
+ * @example
+ * ```ts
+ * parsePackageParam('vue')
+ * // { packageName: 'vue', version: undefined, rest: [] }
+ *
+ * parsePackageParam('vue/v/3.4.0')
+ * // { packageName: 'vue', version: '3.4.0', rest: [] }
+ *
+ * parsePackageParam('@nuxt/kit/v/1.0.0/src/index.ts')
+ * // { packageName: '@nuxt/kit', version: '1.0.0', rest: ['src', 'index.ts'] }
+ * ```
+ */
+export function parsePackageParam(pkgParam: string): ParsedPackageParams {
+  const segments = pkgParam.split('/')
+  const vIndex = segments.indexOf('v')
+
+  if (vIndex !== -1 && vIndex < segments.length - 1) {
+    return {
+      packageName: segments.slice(0, vIndex).join('/'),
+      version: segments[vIndex + 1],
+      rest: segments.slice(vIndex + 2),
+    }
+  }
+
+  return {
+    packageName: segments.join('/'),
+    version: undefined,
+    rest: [],
+  }
+}

test/unit/parse-package-param.spec.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { parsePackageParam } from '../../shared/utils/npm'
+import { parsePackageParam } from '../../shared/utils/parse-package-param'
 
 describe('parsePackageParam', () => {
   describe('unscoped packages', () => {