mikro-orm-markdown 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.ko.md

@@ -15,15 +15,19 @@ MikroORM에서도 동일한 ERD + Markdown 경험을 제공하며, Prisma로는
 - **Embeddable** — 별도 테이블 없이 소유 엔티티의 테이블 안에 컬럼을 펼쳐서 저장하는 값 객체입니다. 예를 들어 `Address` 값 객체는 `address_street`, `address_city` 등의 컬럼으로 저장됩니다. DDD의 Value Object와 같은 개념입니다.
 - **Single Table Inheritance (STI)** — `Dog`, `Cat` 같은 자식 클래스가 `animals` 테이블 하나를 공유합니다. `type` 같은 discriminator 컬럼으로 어떤 자식 클래스인지 구분합니다.
 - **@Formula** — 실제 DB 컬럼 없이 SELECT 시 SQL 식으로 값을 계산하는 가상 컬럼입니다. 예를 들어 `LENGTH(name)`은 DB에 컬럼이 없지만 조회 시 이름의 길이를 반환합니다.
+
+> 이 기능들은 MikroORM에서 완전히 지원하지만 실무에서는 자주 쓰이지 않을 수 있습니다. 특히 Embeddable은 MikroORM Entity를 Domain Entity로 함께 사용하는 구조에서 주로 활용되며, ORM 레이어와 도메인 모델을 분리해서 관리한다면 사용할 일이 거의 없습니다.
+
 - NamingStrategy가 적용된 **실제 DB 컬럼명**
 - **인덱스 및 제약 조건**
 
-DB에 연결하지 않으므로 MikroORM이 지원하는 모든 DB(PostgreSQL, MySQL, SQLite, MSSQL 등)에서 동작합니다.
+PostgreSQL, MySQL/MariaDB, SQLite, MSSQL 같은 MikroORM SQL 드라이버에서 동작합니다. 기존 DB 스키마를 직접 introspection하지 않고 MikroORM 설정에서 엔티티 메타데이터를 읽기 때문에 실행 중인 DB 연결이 필요하지 않습니다.
 
 ## 요구사항
 
 - Node.js >= 18
 - `@mikro-orm/core` >= 6 (peer dependency)
+- 사용할 DB에 맞는 MikroORM 드라이버 패키지가 설치된 MikroORM 설정 파일
 - TypeScript 설정 파일 사용 시 `tsx` 또는 `ts-node` 필요
 
 ## 설치
@@ -64,12 +68,12 @@ npm run erd
 
 ## CLI 옵션
 
-| 옵션 | 기본값 | 설명 |
-|------|--------|------|
-| `-c, --config <path>` | *(필수)* | MikroORM 설정 파일 경로 |
-| `-o, --out <path>` | `./ERD.md` | 출력 Markdown 파일 경로 |
-| `-t, --title <string>` | `Database Schema` | 문서 H1 제목 |
-| `-s, --src <glob>` | — | 엔티티 소스 파일 glob 패턴 (반복 가능). JSDoc 태그 추출에 사용됩니다. |
+| 옵션                   | 기본값            | 설명                                                                  |
+| ---------------------- | ----------------- | --------------------------------------------------------------------- |
+| `-c, --config <path>`  | _(필수)_          | MikroORM 설정 파일 경로                                               |
+| `-o, --out <path>`     | `./ERD.md`        | 출력 Markdown 파일 경로                                               |
+| `-t, --title <string>` | `Database Schema` | 문서 H1 제목                                                          |
+| `-s, --src <glob>`     | —                 | 엔티티 소스 파일 glob 패턴 (반복 가능). JSDoc 태그 추출에 사용됩니다. |
 
 ## JSDoc 태그
 
@@ -88,12 +92,12 @@ export class Post {
 }
 ```
 
-| 태그 | 설명 |
-|------|------|
-| `@namespace <Name>` | `Name` 섹션에 포함 (ERD + 본문 표) |
-| `@erd <Name>` | `Name` 섹션의 ERD 다이어그램에만 포함 |
-| `@describe <Name>` | `Name` 섹션의 본문 표에만 포함 |
-| `@hidden` | 문서 전체에서 제외 |
+| 태그                | 설명                                  |
+| ------------------- | ------------------------------------- |
+| `@namespace <Name>` | `Name` 섹션에 포함 (ERD + 본문 표)    |
+| `@erd <Name>`       | `Name` 섹션의 ERD 다이어그램에만 포함 |
+| `@describe <Name>`  | `Name` 섹션의 본문 표에만 포함        |
+| `@hidden`           | 문서 전체에서 제외                    |
 
 태그가 없는 엔티티는 `default` 섹션에 들어갑니다.
 하나의 엔티티에 여러 태그를 지정할 수 있습니다.
@@ -127,21 +131,21 @@ erDiagram
 
 > 등록된 사용자가 작성한 블로그 게시글입니다.
 
-| Column | Type | Key | Nullable | Description |
-|--------|------|-----|----------|-------------|
-| id | integer | PK | | |
-| title | string | | | 게시글 제목 |
-| body | text | | Y | |
-| author_id | integer | FK (author) | | |
+| Column    | Type    | Key         | Nullable | Description |
+| --------- | ------- | ----------- | -------- | ----------- |
+| id        | integer | PK          |          |             |
+| title     | string  |             |          | 게시글 제목 |
+| body      | text    |             | Y        |             |
+| author_id | integer | FK (author) |          |             |
 ````
 
 **Key 컬럼 주석 의미:**
 
-| 표기 | 의미 |
-|------|------|
-| `formula: <expr>` | `@Formula` 계산 컬럼 — 실제 DB 컬럼 없음 |
+| 표기               | 의미                                         |
+| ------------------ | -------------------------------------------- |
+| `formula: <expr>`  | `@Formula` 계산 컬럼 — 실제 DB 컬럼 없음     |
 | `[EmbeddableType]` | `@Embedded` 값 객체에서 flat으로 저장된 컬럼 |
-| `discriminator` | STI 구분자 컬럼 |
+| `discriminator`    | STI 구분자 컬럼                              |
 
 ## 참고 사항
 

package/README.md

@@ -15,15 +15,19 @@ This tool brings the same ERD + Markdown experience to MikroORM, with additional
 - **Embeddable** — a value object whose fields are stored as flat columns inside the owning entity's table (e.g. `address_street`, `address_city`). No separate table is created.
 - **Single Table Inheritance (STI)** — subclasses like `Dog` and `Cat` share one `animals` table. A discriminator column (e.g. `type`) distinguishes which subclass each row belongs to.
 - **@Formula** — a virtual column with no physical DB column. Its value is computed by a SQL expression at SELECT time (e.g. `LENGTH(name)`).
+
+> These features are fully supported by MikroORM but are less commonly used in practice. In particular, Embeddable is most relevant when MikroORM entities double as domain objects — if you separate your ORM layer from your domain model, you likely won't need it.
+
 - **Actual DB column names** derived from your NamingStrategy
 - **Indexes and constraints**
 
-Works with all databases supported by MikroORM (PostgreSQL, MySQL, SQLite, MSSQL, and more) — no database connection required.
+Works with MikroORM SQL drivers such as PostgreSQL, MySQL/MariaDB, SQLite, and MSSQL. It reads entity metadata from your MikroORM config, so no live database connection is required.
 
 ## Requirements
 
 - Node.js >= 18
 - `@mikro-orm/core` >= 6 (peer dependency)
+- A MikroORM config with the matching database driver package installed
 - TypeScript config files require `tsx` or `ts-node`
 
 ## Installation
@@ -64,12 +68,12 @@ npm run erd
 
 ## CLI Options
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `-c, --config <path>` | *(required)* | Path to MikroORM config file |
-| `-o, --out <path>` | `./ERD.md` | Output Markdown file path |
-| `-t, --title <string>` | `Database Schema` | H1 heading of the generated document |
-| `-s, --src <glob>` | — | Glob pattern for entity source files (repeatable). Enables JSDoc tag extraction. |
+| Option                 | Default           | Description                                                                      |
+| ---------------------- | ----------------- | -------------------------------------------------------------------------------- |
+| `-c, --config <path>`  | _(required)_      | Path to MikroORM config file                                                     |
+| `-o, --out <path>`     | `./ERD.md`        | Output Markdown file path                                                        |
+| `-t, --title <string>` | `Database Schema` | H1 heading of the generated document                                             |
+| `-s, --src <glob>`     | —                 | Glob pattern for entity source files (repeatable). Enables JSDoc tag extraction. |
 
 ## JSDoc Tags
 
@@ -88,12 +92,12 @@ export class Post {
 }
 ```
 
-| Tag | Description |
-|-----|-------------|
+| Tag                 | Description                                         |
+| ------------------- | --------------------------------------------------- |
 | `@namespace <Name>` | Include entity in section `Name` (ERD + text table) |
-| `@erd <Name>` | Include in section `Name`'s ERD diagram only |
-| `@describe <Name>` | Include in section `Name`'s text table only |
-| `@hidden` | Exclude entity from the entire document |
+| `@erd <Name>`       | Include in section `Name`'s ERD diagram only        |
+| `@describe <Name>`  | Include in section `Name`'s text table only         |
+| `@hidden`           | Exclude entity from the entire document             |
 
 Entities with no tag are placed in the `default` section.
 An entity can carry multiple tags to appear in more than one section.
@@ -127,21 +131,21 @@ erDiagram
 
 > Blog post authored by a registered user.
 
-| Column | Type | Key | Nullable | Description |
-|--------|------|-----|----------|-------------|
-| id | integer | PK | | |
-| title | string | | | Post title |
-| body | text | | Y | |
-| author_id | integer | FK (author) | | |
+| Column    | Type    | Key         | Nullable | Description |
+| --------- | ------- | ----------- | -------- | ----------- |
+| id        | integer | PK          |          |             |
+| title     | string  |             |          | Post title  |
+| body      | text    |             | Y        |             |
+| author_id | integer | FK (author) |          |             |
 ````
 
 MikroORM-specific annotations in the **Key** column:
 
-| Annotation | Meaning |
-|------------|---------|
-| `formula: <expr>` | `@Formula` computed column — no physical DB column |
+| Annotation         | Meaning                                              |
+| ------------------ | ---------------------------------------------------- |
+| `formula: <expr>`  | `@Formula` computed column — no physical DB column   |
 | `[EmbeddableType]` | Flat column inlined from an `@Embedded` value object |
-| `discriminator` | STI discriminator column |
+| `discriminator`    | STI discriminator column                             |
 
 ## Notes
 

package/dist/cli.cjs

@@ -33,7 +33,9 @@ var import_ts_morph = require("ts-morph");
 function loadJsDoc(srcGlobs) {
   const entities = /* @__PURE__ */ new Map();
   const props = /* @__PURE__ */ new Map();
-  if (srcGlobs.length === 0) return { entities, props };
+  if (srcGlobs.length === 0) {
+    return { entities, props };
+  }
   const project = new import_ts_morph.Project({
     skipAddingFilesFromTsConfig: true,
     skipLoadingLibFiles: true,
@@ -46,7 +48,9 @@ function loadJsDoc(srcGlobs) {
   for (const sourceFile of project.getSourceFiles()) {
     for (const cls of sourceFile.getClasses()) {
       const className = cls.getName();
-      if (!className) continue;
+      if (!className) {
+        continue;
+      }
       const classDocs = cls.getJsDocs();
       if (classDocs.length > 0) {
         entities.set(className, parseEntityJsDoc(classDocs));
@@ -54,7 +58,9 @@ function loadJsDoc(srcGlobs) {
       const propMap = /* @__PURE__ */ new Map();
       for (const prop of cls.getProperties()) {
         const propDocs = prop.getJsDocs();
-        if (propDocs.length === 0) continue;
+        if (propDocs.length === 0) {
+          continue;
+        }
         const desc = extractDescription(propDocs);
         if (desc !== void 0) {
           propMap.set(prop.getName(), { description: desc });
@@ -75,14 +81,21 @@ function parseEntityJsDoc(jsDocs) {
   let description;
   for (const doc of jsDocs) {
     const desc = doc.getDescription().trim();
-    if (desc && description === void 0) description = desc;
+    if (desc && description === void 0) {
+      description = desc;
+    }
     for (const tag of doc.getTags()) {
       const tagName = tag.getTagName();
       const comment = tag.getCommentText()?.trim();
-      if (tagName === "namespace" && comment) namespaces.push(comment);
-      else if (tagName === "erd" && comment) erdNamespaces.push(comment);
-      else if (tagName === "describe" && comment) describeNamespaces.push(comment);
-      else if (tagName === "hidden") hidden = true;
+      if (tagName === "namespace" && comment) {
+        namespaces.push(comment);
+      } else if (tagName === "erd" && comment) {
+        erdNamespaces.push(comment);
+      } else if (tagName === "describe" && comment) {
+        describeNamespaces.push(comment);
+      } else if (tagName === "hidden") {
+        hidden = true;
+      }
     }
   }
   return {
@@ -96,7 +109,9 @@ function parseEntityJsDoc(jsDocs) {
 function extractDescription(jsDocs) {
   for (const doc of jsDocs) {
     const desc = doc.getDescription().trim();
-    if (desc) return desc;
+    if (desc) {
+      return desc;
+    }
   }
   return void 0;
 }
@@ -115,7 +130,8 @@ async function loadEntityMetadata(options) {
   try {
     orm = await import_core.MikroORM.init({
       ...options,
-      debug: false
+      debug: false,
+      connect: false
     });
   } catch (cause) {
     throw new MetadataLoadError(
@@ -123,17 +139,13 @@ async function loadEntityMetadata(options) {
       cause
     );
   }
-  try {
-    const all = Object.values(orm.getMetadata().getAll());
-    if (all.length === 0) {
-      throw new MetadataLoadError(
-        "No entities were discovered. Check that your config specifies at least one entity path or class."
-      );
-    }
-    return all;
-  } finally {
-    await orm.close(true);
+  const all = Object.values(orm.getMetadata().getAll());
+  if (all.length === 0) {
+    throw new MetadataLoadError(
+      "No entities were discovered. Check that your config specifies at least one entity path or class."
+    );
   }
+  return all;
 }
 
 // src/render/mermaid.ts
@@ -155,9 +167,13 @@ function buildEntityModel(meta, metaByClass) {
   const isStiChild = Boolean(meta.extends) && meta.discriminatorValue !== void 0;
   const columns = [];
   for (const prop of Object.values(meta.properties)) {
-    if (isStiRoot && prop.inherited === true) continue;
+    if (isStiRoot && prop.inherited === true) {
+      continue;
+    }
     const col = buildColumn(prop, metaByClass, meta);
-    if (col !== null) columns.push(col);
+    if (col !== null) {
+      columns.push(col);
+    }
   }
   return {
     className: meta.className,
@@ -171,7 +187,9 @@ function buildEntityModel(meta, metaByClass) {
   };
 }
 function buildColumn(prop, metaByClass, owningMeta) {
-  if (prop.kind === import_core2.ReferenceKind.EMBEDDED) return null;
+  if (prop.kind === import_core2.ReferenceKind.EMBEDDED) {
+    return null;
+  }
   if (prop.kind === import_core2.ReferenceKind.SCALAR) {
     const formulaExpr = prop.formula !== void 0 ? resolveFormulaExpr(prop.formula) : void 0;
     let embeddedIn;
@@ -209,9 +227,12 @@ function buildColumn(prop, metaByClass, owningMeta) {
 }
 function resolveFormulaExpr(cb) {
   try {
-    const cols = new Proxy({}, {
-      get: (_target, key) => typeof key === "string" ? key : ""
-    });
+    const cols = new Proxy(
+      {},
+      {
+        get: (_target, key) => typeof key === "string" ? key : ""
+      }
+    );
     return cb(FORMULA_DUMMY_TABLE, cols);
   } catch {
     return "";
@@ -219,7 +240,9 @@ function resolveFormulaExpr(cb) {
 }
 function resolveFkType(referencedClassName, metaByClass) {
   const refMeta = metaByClass.get(referencedClassName);
-  if (!refMeta) return "integer";
+  if (!refMeta) {
+    return "integer";
+  }
   const pkProp = Object.values(refMeta.properties).find((p) => p.primary === true);
   return pkProp ? normalizeType(pkProp.type) : "integer";
 }
@@ -242,7 +265,9 @@ function buildConstraints(meta) {
     });
   }
   for (const check of meta.checks ?? []) {
-    if (typeof check.expression !== "string") continue;
+    if (typeof check.expression !== "string") {
+      continue;
+    }
     result.push({
       type: "check",
       properties: [],
@@ -255,10 +280,14 @@ function buildConstraints(meta) {
 function buildRelationEdges(metas) {
   const edges = [];
   for (const meta of metas) {
-    if (meta.pivotTable || meta.embeddable) continue;
+    if (meta.pivotTable || meta.embeddable) {
+      continue;
+    }
     for (const prop of Object.values(meta.properties)) {
       const edge = buildEdge(meta.className, prop);
-      if (edge !== null) edges.push(edge);
+      if (edge !== null) {
+        edges.push(edge);
+      }
     }
   }
   return edges;
@@ -304,17 +333,19 @@ function renderErDiagram(model) {
     lines.push("  }");
   }
   for (const rel of model.relations) {
-    lines.push(
-      `  ${rel.fromEntity} ${rel.fromCardinality}--${rel.toCardinality} ${rel.toEntity} : "${rel.label}"`
-    );
+    lines.push(`  ${rel.fromEntity} ${rel.fromCardinality}--${rel.toCardinality} ${rel.toEntity} : "${rel.label}"`);
   }
   return lines.join("\n");
 }
 function renderColumnLine(col) {
   let qualifier = "";
-  if (col.isPrimary) qualifier = " PK";
-  else if (col.isForeignKey) qualifier = " FK";
-  else if (col.isUnique) qualifier = " UK";
+  if (col.isPrimary) {
+    qualifier = " PK";
+  } else if (col.isForeignKey) {
+    qualifier = " FK";
+  } else if (col.isUnique) {
+    qualifier = " UK";
+  }
   let comment;
   if (col.formula !== void 0) {
     comment = col.formula ? `formula: ${col.formula}` : "formula";
@@ -338,25 +369,27 @@ function buildDocumentModel(metas, jsDocResult, title, description) {
   const enrichedByClass = /* @__PURE__ */ new Map();
   for (const model of diagramEntities) {
     const jsDoc = jsDocResult.entities.get(model.className);
-    if (jsDoc?.hidden) continue;
+    if (jsDoc?.hidden) {
+      continue;
+    }
     const propDocs = jsDocResult.props.get(model.className) ?? /* @__PURE__ */ new Map();
     enrichedByClass.set(model.className, { model, jsDoc, propDocs });
   }
   const groupNames = /* @__PURE__ */ new Set();
   let anyUntagged = false;
   for (const { jsDoc } of enrichedByClass.values()) {
-    const allNs = [
-      ...jsDoc?.namespaces ?? [],
-      ...jsDoc?.erdNamespaces ?? [],
-      ...jsDoc?.describeNamespaces ?? []
-    ];
+    const allNs = [...jsDoc?.namespaces ?? [], ...jsDoc?.erdNamespaces ?? [], ...jsDoc?.describeNamespaces ?? []];
     if (allNs.length === 0) {
       anyUntagged = true;
     } else {
-      for (const ns of allNs) groupNames.add(ns);
+      for (const ns of allNs) {
+        groupNames.add(ns);
+      }
     }
   }
-  if (anyUntagged) groupNames.add("default");
+  if (anyUntagged) {
+    groupNames.add("default");
+  }
   const groups = [];
   for (const groupName of groupNames) {
     const isDefault = groupName === "default";
@@ -367,30 +400,42 @@ function buildDocumentModel(metas, jsDocResult, title, description) {
       ({ jsDoc }) => belongsToGroupForText(jsDoc, groupName, isDefault)
     );
     const erdClassNames = new Set(erdEntities.map((e) => e.model.className));
-    const erdRelations = allRelations.filter(
-      (r) => erdClassNames.has(r.fromEntity) && erdClassNames.has(r.toEntity)
-    );
+    const erdRelations = allRelations.filter((r) => erdClassNames.has(r.fromEntity) && erdClassNames.has(r.toEntity));
     groups.push({ name: groupName, erdEntities, textEntities, erdRelations });
   }
   groups.sort((a, b) => {
-    if (a.name === "default") return 1;
-    if (b.name === "default") return -1;
+    if (a.name === "default") {
+      return 1;
+    }
+    if (b.name === "default") {
+      return -1;
+    }
     return a.name.localeCompare(b.name);
   });
   return { title, groups, ...description !== void 0 && { description } };
 }
 function hasNoNamespaceTags(jsDoc) {
-  if (!jsDoc) return true;
+  if (!jsDoc) {
+    return true;
+  }
   return jsDoc.namespaces.length === 0 && jsDoc.erdNamespaces.length === 0 && jsDoc.describeNamespaces.length === 0;
 }
 function belongsToGroupForErd(jsDoc, groupName, isDefault) {
-  if (isDefault) return hasNoNamespaceTags(jsDoc);
-  if (!jsDoc) return false;
+  if (isDefault) {
+    return hasNoNamespaceTags(jsDoc);
+  }
+  if (!jsDoc) {
+    return false;
+  }
   return jsDoc.namespaces.includes(groupName) || jsDoc.erdNamespaces.includes(groupName);
 }
 function belongsToGroupForText(jsDoc, groupName, isDefault) {
-  if (isDefault) return hasNoNamespaceTags(jsDoc);
-  if (!jsDoc) return false;
+  if (isDefault) {
+    return hasNoNamespaceTags(jsDoc);
+  }
+  if (!jsDoc) {
+    return false;
+  }
   return jsDoc.namespaces.includes(groupName) || jsDoc.describeNamespaces.includes(groupName);
 }
 
@@ -425,9 +470,7 @@ function renderEntitySection(entity) {
     parts.push(`> ${entity.jsDoc.description}`);
   }
   if (entity.model.discriminatorColumn) {
-    parts.push(
-      `*STI root \u2014 discriminator column: \`${entity.model.discriminatorColumn}\`*`
-    );
+    parts.push(`*STI root \u2014 discriminator column: \`${entity.model.discriminatorColumn}\`*`);
   } else if (entity.model.extendsEntity) {
     parts.push(`*Extends \`${entity.model.extendsEntity}\` (Single Table Inheritance)*`);
   }
@@ -451,14 +494,24 @@ function renderColumnTable(entity) {
   return [header, sep, ...rows].join("\n");
 }
 function resolveColumnKey(col) {
-  if (col.isPrimary) return "PK";
+  if (col.isPrimary) {
+    return "PK";
+  }
   if (col.isForeignKey) {
     return col.fieldName !== col.propName ? `FK (${col.propName})` : "FK";
   }
-  if (col.isUnique) return "UK";
-  if (col.formula !== void 0) return `formula: ${col.formula}`;
-  if (col.isDiscriminator) return "discriminator";
-  if (col.embeddedIn !== void 0) return `[${col.embeddedIn}]`;
+  if (col.isUnique) {
+    return "UK";
+  }
+  if (col.formula !== void 0) {
+    return `formula: ${col.formula}`;
+  }
+  if (col.isDiscriminator) {
+    return "discriminator";
+  }
+  if (col.embeddedIn !== void 0) {
+    return `[${col.embeddedIn}]`;
+  }
   return "";
 }
 function renderConstraints(constraints) {
@@ -507,7 +560,7 @@ ${err instanceof Error ? err.message : String(err)}${hint}
     markdown = await generateMarkdown({
       orm: ormOptions,
       title: opts.title,
-      src: opts.src,
+      src: opts.src ?? [],
       ...opts.description !== void 0 && { description: opts.description }
     });
   } catch (err) {
@@ -520,12 +573,7 @@ ${err instanceof Error ? err.message : String(err)}${hint}
   process.stdout.write(`\u2713 Written to ${path.relative(process.cwd(), outPath)}
 `);
 }
-var program = new import_commander.Command().name("mikro-orm-markdown").description("Generate Mermaid ERD + markdown docs from MikroORM entities").requiredOption("-c, --config <path>", "MikroORM config file path").option("-o, --out <path>", "Output markdown file path", "./ERD.md").option("-t, --title <string>", "Document title", "Database Schema").option("-d, --description <string>", "Optional description paragraph shown below the title").option(
-  "-s, --src <glob>",
-  "Glob pattern for entity source files, repeatable (for JSDoc extraction)",
-  (val, prev) => [...prev, val],
-  []
-).action(run);
+var program = new import_commander.Command().name("mikro-orm-markdown").description("Generate Mermaid ERD + markdown docs from MikroORM entities").requiredOption("-c, --config <path>", "MikroORM config file path").option("-o, --out <path>", "Output markdown file path", "./ERD.md").option("-t, --title <string>", "Document title", "Database Schema").option("-d, --description <string>", "Optional description paragraph shown below the title").option("-s, --src <glob>", "JSDoc source glob (repeatable)", (val, prev = []) => [...prev, val]).action(run);
 program.parseAsync(process.argv).catch((err) => {
   process.stderr.write(`${err instanceof Error ? err.message : String(err)}
 `);