refactor: lazy load comment-parser with cjsRequire

Author: JounQin

src/utils/export-map.ts

@@ -1,9 +1,9 @@
 import fs from 'node:fs'
 import path from 'node:path'
 
+import { cjsRequire } from '@pkgr/core'
 import type { TSESLint, TSESTree } from '@typescript-eslint/utils'
-import { parse as parseComment_ } from 'comment-parser'
-import type { Block } from 'comment-parser'
+import type * as commentParser from 'comment-parser'
 import debug from 'debug'
 import type { AST } from 'eslint'
 import { SourceCode } from 'eslint'
@@ -36,7 +36,7 @@ const tsconfigCache = new Map<string, TsConfigJsonResolved | null | undefined>()
 
 export type DocStyleParsers = Record<
   DocStyle,
-  (comments: TSESTree.Comment[]) => Block | undefined
+  (comments: TSESTree.Comment[]) => commentParser.Block | undefined
 >
 
 export interface DeclarationMetadata {
@@ -47,7 +47,7 @@ export interface DeclarationMetadata {
 }
 
 export interface ModuleNamespace {
-  doc?: Block
+  doc?: commentParser.Block
   namespace?: ExportMap | null
 }
 
@@ -70,7 +70,10 @@ const declTypes = new Set([
 // https://github.com/syavorsky/comment-parser/issues/172
 const fixup = new Set(['deprecated', 'module'])
 
-const parseComment = (comment: string): Block => {
+let parseComment_: typeof commentParser.parse | undefined
+
+const parseComment = (comment: string): commentParser.Block => {
+  parseComment_ ??= cjsRequire<typeof commentParser>('comment-parser').parse
   const restored = `/**${comment.split('\n').reduce((acc, line) => {
     line = line.trim()
     return line && line !== '*' ? acc + '\n  ' + line : acc
@@ -747,7 +750,7 @@ export class ExportMap {
 
   declare private mtime: number
 
-  declare doc: Block | undefined
+  declare doc: commentParser.Block | undefined
 
   constructor(public path: string) {}
 
@@ -963,7 +966,7 @@ function captureDoc(
   ...nodes: Array<TSESTree.Node | undefined>
 ) {
   const metadata: {
-    doc?: Block | undefined
+    doc?: commentParser.Block | undefined
   } = {}
 
   defineLazyProperty(metadata, 'doc', () => {
@@ -1030,7 +1033,9 @@ function captureJsDoc(comments: TSESTree.Comment[]) {
 }
 
 /** Parse TomDoc section from comments */
-function captureTomDoc(comments: TSESTree.Comment[]): Block | undefined {
+function captureTomDoc(
+  comments: TSESTree.Comment[],
+): commentParser.Block | undefined {
   // collect lines up to first paragraph break
   const lines = []
   for (const comment of comments) {
@@ -1053,7 +1058,7 @@ function captureTomDoc(comments: TSESTree.Comment[]): Block | undefined {
           description: statusMatch[2],
         },
       ],
-    } as Block
+    } as commentParser.Block
   }
 }