mikro-orm-markdown 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.2] - 2026-07-06
+
+### Fixed
+
+- Hidden STI parent entity names no longer leak into child entity captions when the parent is excluded with `@hidden`
+- JSDoc extraction now includes getter accessors and constructor parameter properties, including rich inline JSDoc text such as `{@link ...}`
+- Markdown escaping now treats underscore emphasis and link-like labels consistently while preserving identifier-style names such as `author_id`
+- CLI TypeScript config loading now unregisters the temporary `tsx` loader when it is no longer needed
+
+### Changed
+
+- Mermaid layout and theme CLI options now use Commander's built-in choice validation
+- Diagram model construction was moved into the model layer so Mermaid rendering remains focused on output formatting
+
 ## [0.1.1] - 2026-07-03
 
 ### Fixed

package/dist/cli.cjs

@@ -91,17 +91,7 @@ function loadJsDoc(filePaths, onWarn) {
         if (classDocs.length > 0) {
           entities.set(className, parseEntityJsDoc(classDocs));
         }
-        const propMap = /* @__PURE__ */ new Map();
-        for (const prop of cls.getProperties()) {
-          const propDocs = prop.getJsDocs();
-          if (propDocs.length === 0) {
-            continue;
-          }
-          const info = parsePropJsDoc(propDocs);
-          if (info.description !== void 0 || info.atLeastOne) {
-            propMap.set(prop.getName(), info);
-          }
-        }
+        const propMap = collectPropJsDocs(cls);
         if (propMap.size > 0) {
           props.set(className, propMap);
         }
@@ -118,6 +108,28 @@ function formatUnknownError(err) {
 function hasGlobPattern(filePath) {
   return /[*?[\]{}]/.test(filePath);
 }
+function collectPropJsDocs(cls) {
+  const propMap = /* @__PURE__ */ new Map();
+  for (const prop of [...cls.getProperties(), ...cls.getGetAccessors()]) {
+    const info = parsePropJsDoc(prop.getJsDocs());
+    addPropInfo(propMap, prop.getName(), info);
+  }
+  for (const prop of getConstructorParameterProperties(cls)) {
+    const info = parseCompilerPropJsDoc(import_ts_morph.ts.getJSDocCommentsAndTags(prop.compilerNode));
+    addPropInfo(propMap, prop.getName(), info);
+  }
+  return propMap;
+}
+function getConstructorParameterProperties(cls) {
+  return cls.getConstructors().flatMap(
+    (constructorDeclaration) => constructorDeclaration.getParameters().filter((param) => param.isParameterProperty())
+  );
+}
+function addPropInfo(propMap, propName, info) {
+  if (info.description !== void 0 || info.atLeastOne) {
+    propMap.set(propName, info);
+  }
+}
 function parseEntityJsDoc(jsDocs) {
   const namespaces = [];
   const erdNamespaces = [];
@@ -167,6 +179,35 @@ function parsePropJsDoc(jsDocs) {
   }
   return { ...description !== void 0 && { description }, atLeastOne };
 }
+function parseCompilerPropJsDoc(jsDocs) {
+  let description;
+  let atLeastOne = false;
+  for (const doc of jsDocs) {
+    if (import_ts_morph.ts.isJSDoc(doc)) {
+      const desc = formatCompilerJsDocComment(doc.comment);
+      if (desc && description === void 0) {
+        description = desc;
+      }
+      for (const tag of doc.tags ?? []) {
+        if (tag.tagName.getText() === "atLeastOne") {
+          atLeastOne = true;
+        }
+      }
+      continue;
+    }
+    if (doc.tagName.getText() === "atLeastOne") {
+      atLeastOne = true;
+    }
+  }
+  return { ...description !== void 0 && { description }, atLeastOne };
+}
+function formatCompilerJsDocComment(comment) {
+  if (comment === void 0) {
+    return void 0;
+  }
+  const trimmed = import_ts_morph.ts.getTextOfJSDocComment(comment)?.trim();
+  return trimmed === void 0 || trimmed === "" ? void 0 : trimmed;
+}
 
 // src/metadata/load.ts
 var path = __toESM(require("path"), 1);
@@ -206,6 +247,44 @@ function assertNoEntitySchemaEntities(options) {
 Use decorator-based @Entity() classes instead.`
   );
 }
+function hasDecoratorMarker(target) {
+  const pathSymbol = import_core.MetadataStorage.PATH_SYMBOL;
+  if (typeof pathSymbol === "symbol" && pathSymbol in target) {
+    return true;
+  }
+  return "__path" in target;
+}
+function isRenderableMeta(meta) {
+  return !meta.pivotTable && !meta.embeddable;
+}
+function assertDiscoveredEntitiesAreSupported(metas) {
+  const confirmed = [];
+  const unconfirmed = [];
+  for (const meta of metas) {
+    if (!isRenderableMeta(meta)) {
+      continue;
+    }
+    if (import_core.EntitySchema.REGISTRY.has(meta.class)) {
+      confirmed.push(meta.className);
+    } else if (!hasDecoratorMarker(meta.class)) {
+      unconfirmed.push(meta.className);
+    }
+  }
+  if (confirmed.length === 0 && unconfirmed.length === 0) {
+    return;
+  }
+  const lines = [];
+  if (confirmed.length > 0) {
+    lines.push(`EntitySchema-defined entities are not currently supported: ${confirmed.join(", ")}.`);
+  }
+  if (unconfirmed.length > 0) {
+    lines.push(
+      `Could not confirm these entities are decorator-based @Entity() classes: ${unconfirmed.join(", ")}. This usually means they are EntitySchema-defined entities (also not currently supported). If you're certain these are valid @Entity() classes, this may be a detection false positive in mikro-orm-markdown \u2014 please open an issue: https://github.com/iamkanguk97/mikro-orm-markdown/issues`
+    );
+  }
+  lines.push("Use decorator-based @Entity() classes instead.");
+  throw new MetadataLoadError(lines.join("\n"));
+}
 async function loadEntityMetadata(options) {
   assertNoEntitySchemaEntities(options);
   let orm;
@@ -232,6 +311,7 @@ async function loadEntityMetadata(options) {
         "No entities were discovered. Check that your config specifies at least one entity path or class."
       );
     }
+    assertDiscoveredEntitiesAreSupported(all);
     const baseDir = orm.config.get("baseDir");
     const sourcePaths = [...new Set(all.filter((m) => m.path).map((m) => path.resolve(baseDir, m.path)))];
     return { metas: all, sourcePaths };
@@ -243,57 +323,8 @@ async function loadEntityMetadata(options) {
 // src/model/build.ts
 var import_core3 = require("@mikro-orm/core");
 
-// src/render/mermaid.ts
+// src/model/diagram.ts
 var import_core2 = require("@mikro-orm/core");
-
-// src/render/escape.ts
-var MARKDOWN_INLINE_SPECIAL_CHARS = /[\\`|*#]/g;
-var MERMAID_IDENTIFIER_INVALID_CHARS = /[^a-zA-Z0-9_]/g;
-function normalizeInlineText(value) {
-  return value.replace(/\r\n?/g, "\n").replace(/[\n\t]+/g, " ").replace(/\s{2,}/g, " ").trim();
-}
-function splitNormalizedLines(value) {
-  return value.replace(/\r\n?/g, "\n").split("\n");
-}
-function escapeHtmlText(value) {
-  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function escapeMarkdownInline(value) {
-  return escapeHtmlText(normalizeInlineText(value)).replace(MARKDOWN_INLINE_SPECIAL_CHARS, "\\$&");
-}
-function escapeMarkdownTableCell(value) {
-  return splitNormalizedLines(value).map((line) => escapeMarkdownInline(line)).join("<br>");
-}
-function escapeMarkdownParagraph(value) {
-  return splitNormalizedLines(value).map((line) => escapeMarkdownInline(line)).join("  \n");
-}
-function renderMarkdownBlockQuote(value) {
-  return splitNormalizedLines(value).map((line) => `> ${escapeMarkdownInline(line)}`).join("\n");
-}
-function renderMarkdownInlineCode(value) {
-  const normalized = normalizeInlineText(value);
-  const backtickRuns = normalized.match(/`+/g) ?? [];
-  const longestRun = Math.max(0, ...backtickRuns.map((run2) => run2.length));
-  const fence = "`".repeat(longestRun + 1);
-  const needsPadding = normalized.startsWith("`") || normalized.endsWith("`");
-  const content = needsPadding ? ` ${normalized} ` : normalized;
-  return `${fence}${content}${fence}`;
-}
-function toMermaidIdentifier(value) {
-  const normalized = normalizeInlineText(value).replace(MERMAID_IDENTIFIER_INVALID_CHARS, "_").replace(/_+/g, "_");
-  const identifier = normalized === "" ? "_" : normalized;
-  return /^[a-zA-Z_]/.test(identifier) ? identifier : `_${identifier}`;
-}
-function escapeMermaidQuotedText(value) {
-  return normalizeInlineText(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-}
-function toMarkdownAnchor(value) {
-  return normalizeInlineText(value).toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, "").replace(/\s+/g, "-");
-}
-
-// src/render/mermaid.ts
-var MERMAID_LAYOUTS = ["dagre", "elk", "elk.stress"];
-var MERMAID_THEMES = ["default", "neutral", "dark", "forest", "base"];
 var FORMULA_DUMMY_TABLE = {
   alias: "e0",
   name: "",
@@ -564,75 +595,6 @@ function buildEdge(fromEntity, prop) {
   }
   return null;
 }
-function normalizeType(type) {
-  const t = type.toLowerCase().trim();
-  if (t === "uuid" || t === "text" || t === "string" || t.startsWith("varchar")) {
-    return "string";
-  }
-  if (t === "timestamptz" || t === "timestamp" || t === "datetime") {
-    return "datetime";
-  }
-  if (t === "integer" || t === "int" || t === "bigint" || t === "smallint") {
-    return "integer";
-  }
-  if (t === "doubletype" || t === "double precision" || t === "double" || t === "float" || t === "decimal") {
-    return "float";
-  }
-  if (t === "boolean" || t === "bool") {
-    return "boolean";
-  }
-  if (t === "jsonb") {
-    return "json";
-  }
-  return type;
-}
-function renderErDiagram(model, mermaid) {
-  const lines = [];
-  if (mermaid?.layout !== void 0 || mermaid?.theme !== void 0) {
-    lines.push("---", "config:");
-    if (mermaid.layout !== void 0) {
-      lines.push(`  layout: ${mermaid.layout}`);
-    }
-    if (mermaid.theme !== void 0) {
-      lines.push(`  theme: ${mermaid.theme}`);
-    }
-    lines.push("---");
-  }
-  lines.push("erDiagram");
-  for (const entity of model.entities) {
-    lines.push(`  ${toMermaidIdentifier(entity.className)} {`);
-    for (const col of entity.columns) {
-      lines.push(`    ${renderColumnLine(col)}`);
-    }
-    lines.push("  }");
-  }
-  for (const rel of model.relations) {
-    lines.push(
-      `  ${toMermaidIdentifier(rel.fromEntity)} ${rel.fromCardinality}--${rel.toCardinality} ${toMermaidIdentifier(rel.toEntity)} : "${escapeMermaidQuotedText(rel.label)}"`
-    );
-  }
-  return lines.join("\n");
-}
-function renderColumnLine(col) {
-  let qualifier = "";
-  if (col.isPrimary) {
-    qualifier = " PK";
-  } else if (col.isUnique) {
-    qualifier = " UK";
-  }
-  let comment;
-  if (col.formula !== void 0) {
-    comment = col.formula ? `formula: ${col.formula}` : "formula";
-  } else if (col.isDiscriminator) {
-    comment = "discriminator";
-  } else if (col.embeddedIn !== void 0) {
-    comment = `[${col.embeddedIn}]`;
-  } else if (col.isSelfReference) {
-    comment = "self-ref";
-  }
-  const commentStr = comment !== void 0 ? ` "${escapeMermaidQuotedText(comment)}"` : "";
-  return `${toMermaidIdentifier(normalizeType(col.type))} ${toMermaidIdentifier(col.fieldName)}${qualifier}${commentStr}`;
-}
 
 // src/model/build.ts
 var FROM_ONE_OR_MORE = "}|";
@@ -655,7 +617,10 @@ function buildDocumentModel(metas, jsDocResult, title, description, onWarn) {
     const columns = model.columns.filter(
       (col) => !(col.isForeignKey && col.referencedEntity !== void 0 && hiddenClasses.has(col.referencedEntity))
     );
-    const visibleModel = columns.length === model.columns.length ? model : { ...model, columns };
+    const visibleModel = removeHiddenEntityReferences(
+      columns.length === model.columns.length ? model : { ...model, columns },
+      hiddenClasses
+    );
     const ownPropDocs = jsDocResult.props.get(model.className) ?? /* @__PURE__ */ new Map();
     const propDocs = withEmbeddedPropDocs(ownPropDocs, visibleModel.columns, jsDocResult.props);
     enrichedByClass.set(model.className, { model: visibleModel, jsDoc, propDocs });
@@ -706,6 +671,14 @@ function buildDocumentModel(metas, jsDocResult, title, description, onWarn) {
   });
   return { title, groups, ...description !== void 0 && { description } };
 }
+function removeHiddenEntityReferences(model, hiddenClasses) {
+  if (model.extendsEntity === void 0 || !hiddenClasses.has(model.extendsEntity)) {
+    return model;
+  }
+  const visibleModel = { ...model };
+  delete visibleModel.extendsEntity;
+  return visibleModel;
+}
 function withEmbeddedPropDocs(ownPropDocs, columns, allPropDocs) {
   const merged = new Map(ownPropDocs);
   for (const col of columns) {
@@ -817,6 +790,144 @@ async function withTsMorphMetadataProvider(options, onWarn) {
   }
 }
 
+// src/render/escape.ts
+var MARKDOWN_INLINE_SPECIAL_CHARS = /[\\`|*#\[\]]/g;
+var MARKDOWN_EMPHASIS_UNDERSCORE = /(?<![a-zA-Z0-9])_|_(?![a-zA-Z0-9])/g;
+var MERMAID_IDENTIFIER_INVALID_CHARS = /[^a-zA-Z0-9_]/g;
+function normalizeInlineText(value) {
+  return value.replace(/\r\n?/g, "\n").replace(/[\n\t]+/g, " ").replace(/\s{2,}/g, " ").trim();
+}
+function splitNormalizedLines(value) {
+  return value.replace(/\r\n?/g, "\n").split("\n");
+}
+function escapeHtmlText(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeMarkdownInline(value) {
+  return escapeHtmlText(normalizeInlineText(value)).replace(MARKDOWN_INLINE_SPECIAL_CHARS, "\\$&").replace(MARKDOWN_EMPHASIS_UNDERSCORE, "\\_");
+}
+function escapeMarkdownTableCell(value) {
+  return splitNormalizedLines(value).map((line) => escapeMarkdownInline(line)).join("<br>");
+}
+function escapeMarkdownParagraph(value) {
+  return splitNormalizedLines(value).map((line) => escapeMarkdownInline(line)).join("  \n");
+}
+function renderMarkdownBlockQuote(value) {
+  return splitNormalizedLines(value).map((line) => `> ${escapeMarkdownInline(line)}`).join("\n");
+}
+function renderMarkdownInlineCode(value) {
+  const normalized = normalizeInlineText(value);
+  const backtickRuns = normalized.match(/`+/g) ?? [];
+  const longestRun = Math.max(0, ...backtickRuns.map((run2) => run2.length));
+  const fence = "`".repeat(longestRun + 1);
+  const needsPadding = normalized.startsWith("`") || normalized.endsWith("`");
+  const content = needsPadding ? ` ${normalized} ` : normalized;
+  return `${fence}${content}${fence}`;
+}
+function toMermaidIdentifier(value) {
+  const normalized = normalizeInlineText(value).replace(MERMAID_IDENTIFIER_INVALID_CHARS, "_").replace(/_+/g, "_");
+  const identifier = normalized === "" ? "_" : normalized;
+  return /^[a-zA-Z_]/.test(identifier) ? identifier : `_${identifier}`;
+}
+function escapeMermaidQuotedText(value) {
+  return normalizeInlineText(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function toMarkdownAnchor(value) {
+  return normalizeInlineText(value).toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, "").replace(/\s+/g, "-");
+}
+
+// src/render/mermaid.ts
+var MERMAID_LAYOUTS = ["dagre", "elk", "elk.stress"];
+var MERMAID_THEMES = ["default", "neutral", "dark", "forest", "base"];
+var GENERIC_TYPE_BY_BASE_NAME = /* @__PURE__ */ new Map([
+  ["uuid", "string"],
+  ["text", "string"],
+  ["string", "string"],
+  ["varchar", "string"],
+  ["character varying", "string"],
+  ["character", "string"],
+  ["char", "string"],
+  ["tinytext", "string"],
+  ["mediumtext", "string"],
+  ["longtext", "string"],
+  ["timestamptz", "datetime"],
+  ["timestamp", "datetime"],
+  ["datetime", "datetime"],
+  ["integer", "integer"],
+  ["int", "integer"],
+  ["bigint", "integer"],
+  ["smallint", "integer"],
+  ["tinyint", "integer"],
+  ["mediumint", "integer"],
+  ["serial", "integer"],
+  ["bigserial", "integer"],
+  ["doubletype", "float"],
+  ["double precision", "float"],
+  ["double", "float"],
+  ["float", "float"],
+  ["decimal", "float"],
+  ["numeric", "float"],
+  ["real", "float"],
+  ["boolean", "boolean"],
+  ["bool", "boolean"],
+  ["jsonb", "json"]
+]);
+function normalizeType(type) {
+  const t = type.toLowerCase().replace(/\s+/g, " ").trim();
+  if (/^tinyint\s*\(\s*1\s*\)$/.test(t)) {
+    return "boolean";
+  }
+  const baseName = t.replace(/\(.*\)/, "").replace(/\b(un)?signed\b/, "").trim();
+  return GENERIC_TYPE_BY_BASE_NAME.get(baseName) ?? type;
+}
+function renderErDiagram(model, mermaid) {
+  const lines = [];
+  if (mermaid?.layout !== void 0 || mermaid?.theme !== void 0) {
+    lines.push("---", "config:");
+    if (mermaid.layout !== void 0) {
+      lines.push(`  layout: ${mermaid.layout}`);
+    }
+    if (mermaid.theme !== void 0) {
+      lines.push(`  theme: ${mermaid.theme}`);
+    }
+    lines.push("---");
+  }
+  lines.push("erDiagram");
+  for (const entity of model.entities) {
+    lines.push(`  ${toMermaidIdentifier(entity.className)} {`);
+    for (const col of entity.columns) {
+      lines.push(`    ${renderColumnLine(col)}`);
+    }
+    lines.push("  }");
+  }
+  for (const rel of model.relations) {
+    lines.push(
+      `  ${toMermaidIdentifier(rel.fromEntity)} ${rel.fromCardinality}--${rel.toCardinality} ${toMermaidIdentifier(rel.toEntity)} : "${escapeMermaidQuotedText(rel.label)}"`
+    );
+  }
+  return lines.join("\n");
+}
+function renderColumnLine(col) {
+  let qualifier = "";
+  if (col.isPrimary) {
+    qualifier = " PK";
+  } else if (col.isUnique) {
+    qualifier = " UK";
+  }
+  let comment;
+  if (col.formula !== void 0) {
+    comment = col.formula ? `formula: ${col.formula}` : "formula";
+  } else if (col.isDiscriminator) {
+    comment = "discriminator";
+  } else if (col.embeddedIn !== void 0) {
+    comment = `[${col.embeddedIn}]`;
+  } else if (col.isSelfReference) {
+    comment = "self-ref";
+  }
+  const commentStr = comment !== void 0 ? ` "${escapeMermaidQuotedText(comment)}"` : "";
+  return `${toMermaidIdentifier(normalizeType(col.type))} ${toMermaidIdentifier(col.fieldName)}${qualifier}${commentStr}`;
+}
+
 // src/render/markdown.ts
 function renderMarkdown(docModel, mermaid) {
   const sections = [`# ${escapeMarkdownInline(docModel.title)}`];
@@ -840,7 +951,7 @@ function renderBulletSection(header, items, renderItem) {
 }
 function renderTableOfContents(groups, anchors) {
   return renderBulletSection("## Contents", groups, (group) => {
-    const label = escapeMarkdownInline(group.name).replace(/[[\]]/g, "\\$&");
+    const label = escapeMarkdownInline(group.name);
     return `- [${label}](#${anchors.get(group) ?? toMarkdownAnchor(group.name)})`;
   });
 }
@@ -925,7 +1036,7 @@ function resolveColumnKey(col) {
     return "PK";
   }
   if (col.isForeignKey) {
-    return fkKey;
+    return col.isUnique ? `${fkKey}, UK` : fkKey;
   }
   if (col.isUnique) {
     return "UK";
@@ -1038,6 +1149,12 @@ async function generateMarkdown(options) {
 }
 
 // src/cli.ts
+var activeTsxUnregister;
+async function unregisterActiveTsxLoader() {
+  const unregister = activeTsxUnregister;
+  activeTsxUnregister = void 0;
+  await unregister?.();
+}
 function toConfigImportSpecifier(configPath) {
   return (0, import_node_url.pathToFileURL)(path2.resolve(configPath)).href;
 }
@@ -1055,64 +1172,78 @@ function findNearestTsconfig(fromPath) {
     dir = parent;
   }
 }
-async function loadOrmOptions(configPath, tsconfigPath) {
+async function loadOrmOptions(configPath, tsconfigPath, loadOptions = {}) {
   const isTypeScriptConfig = configPath.endsWith(".ts");
-  if (isTypeScriptConfig) {
-    let register;
-    try {
-      ({ register } = await import("tsx/esm/api"));
-    } catch {
-      throw new Error('TypeScript config files require the "tsx" package.\nInstall it with: npm install -D tsx');
-    }
-    let tsconfig;
-    if (tsconfigPath !== void 0) {
-      tsconfig = path2.resolve(tsconfigPath);
-      if (!syncFs.existsSync(tsconfig)) {
-        throw new Error(`--tsconfig file not found: ${tsconfig}`);
-      }
-    } else {
-      tsconfig = findNearestTsconfig(configPath);
-    }
-    register(tsconfig !== void 0 ? { tsconfig } : {});
-  }
-  const configUrl = toConfigImportSpecifier(configPath);
-  let mod;
+  let unregisterTsx;
+  let shouldKeepTsxRegistered = false;
   try {
-    mod = await import(
-      /* @vite-ignore */
-      configUrl
-    );
-  } catch (cause) {
     if (isTypeScriptConfig) {
-      const detail = cause instanceof Error ? cause.message : String(cause);
-      throw new Error(
-        `Failed to load TypeScript config.
+      await unregisterActiveTsxLoader();
+      let register;
+      try {
+        ({ register } = await import("tsx/esm/api"));
+      } catch {
+        throw new Error('TypeScript config files require the "tsx" package.\nInstall it with: npm install -D tsx');
+      }
+      let tsconfig;
+      if (tsconfigPath !== void 0) {
+        tsconfig = path2.resolve(tsconfigPath);
+        if (!syncFs.existsSync(tsconfig)) {
+          throw new Error(`--tsconfig file not found: ${tsconfig}`);
+        }
+      } else {
+        tsconfig = findNearestTsconfig(configPath);
+      }
+      unregisterTsx = register(tsconfig !== void 0 ? { tsconfig } : {});
+    }
+    const configUrl = toConfigImportSpecifier(configPath);
+    let mod;
+    try {
+      mod = await import(
+        /* @vite-ignore */
+        configUrl
+      );
+    } catch (cause) {
+      if (isTypeScriptConfig) {
+        const detail = cause instanceof Error ? cause.message : String(cause);
+        throw new Error(
+          `Failed to load TypeScript config.
 ${detail}
 
 If this looks like a decorator/metadata error, the tsconfig applied to your entity files is likely missing "experimentalDecorators" / "emitDecoratorMetadata".
 Make sure a tsconfig.json with those options sits next to your config file, or pass one explicitly with --tsconfig <path>.`,
-        { cause }
+          { cause }
+        );
+      }
+      throw cause;
+    }
+    if (mod.default === void 0) {
+      throw new Error("Config file must use a default export, e.g. `export default defineConfig({ ... })`.");
+    }
+    const config = mod.default;
+    if (typeof config === "function" || config instanceof Promise) {
+      throw new Error(
+        "Config file default export must be a configuration object, not a function or Promise.\nResolve it first, or use the programmatic API instead (see README)."
       );
     }
-    throw cause;
-  }
-  if (mod.default === void 0) {
-    throw new Error("Config file must use a default export, e.g. `export default defineConfig({ ... })`.");
-  }
-  const config = mod.default;
-  if (typeof config === "function" || config instanceof Promise) {
-    throw new Error(
-      "Config file default export must be a configuration object, not a function or Promise.\nResolve it first, or use the programmatic API instead (see README)."
-    );
-  }
-  if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      "Config file default export must be a configuration object, not a primitive value or array.\nExport a plain MikroORM options object instead."
-    );
+    if (typeof config !== "object" || config === null || Array.isArray(config)) {
+      throw new Error(
+        "Config file default export must be a configuration object, not a primitive value or array.\nExport a plain MikroORM options object instead."
+      );
+    }
+    const options = config;
+    const withPreferTs = isTypeScriptConfig && options.preferTs === void 0 ? { ...options, preferTs: true } : options;
+    shouldKeepTsxRegistered = loadOptions.keepTsxRegistered === true;
+    return withPreferTs;
+  } finally {
+    if (unregisterTsx !== void 0) {
+      if (shouldKeepTsxRegistered) {
+        activeTsxUnregister = unregisterTsx;
+      } else {
+        await unregisterTsx();
+      }
+    }
   }
-  const options = config;
-  const withPreferTs = isTypeScriptConfig && options.preferTs === void 0 ? { ...options, preferTs: true } : options;
-  return withPreferTs;
 }
 function formatErrorChain(err) {
   const lines = [];
@@ -1151,20 +1282,6 @@ ${formatFileSystemError(cause)}`, { cause });
 }
 function parseMermaidOptions(opts) {
   const { mermaidLayout, mermaidTheme } = opts;
-  if (mermaidLayout !== void 0 && !MERMAID_LAYOUTS.includes(mermaidLayout)) {
-    process.stderr.write(
-      `Error: Invalid --mermaid-layout "${mermaidLayout}". Allowed values: ${MERMAID_LAYOUTS.join(", ")}
-`
-    );
-    process.exit(1);
-  }
-  if (mermaidTheme !== void 0 && !MERMAID_THEMES.includes(mermaidTheme)) {
-    process.stderr.write(
-      `Error: Invalid --mermaid-theme "${mermaidTheme}". Allowed values: ${MERMAID_THEMES.join(", ")}
-`
-    );
-    process.exit(1);
-  }
   if (mermaidLayout === void 0 && mermaidTheme === void 0) {
     return void 0;
   }
@@ -1179,7 +1296,7 @@ async function run(opts) {
   const mermaid = parseMermaidOptions(opts);
   let ormOptions;
   try {
-    ormOptions = await loadOrmOptions(configPath, opts.tsconfig);
+    ormOptions = await loadOrmOptions(configPath, opts.tsconfig, { keepTsxRegistered: true });
   } catch (err) {
     process.stderr.write(
       `Error: Cannot load config: ${configPath}
@@ -1200,10 +1317,12 @@ ${err instanceof Error ? err.message : String(err)}
 `)
     });
   } catch (err) {
+    await unregisterActiveTsxLoader();
     process.stderr.write(`Error: ${formatDiscoveryError(err)}
 `);
     process.exit(1);
   }
+  await unregisterActiveTsxLoader();
   try {
     await writeMarkdownFile(outPath, markdown);
   } catch (err) {
@@ -1220,7 +1339,17 @@ var program = new import_commander.Command().name("mikro-orm-markdown").descript
 ).option(
   "--src <paths...>",
   "Source .ts file globs to read JSDoc from when entities run from compiled .js (comments are stripped at build time)"
-).option("--mermaid-layout <layout>", `Mermaid layout engine injected as frontmatter (${MERMAID_LAYOUTS.join("|")})`).option("--mermaid-theme <theme>", `Mermaid theme injected as frontmatter (${MERMAID_THEMES.join("|")})`).action(run);
+).addOption(
+  new import_commander.Option(
+    "--mermaid-layout <layout>",
+    `Mermaid layout engine injected as frontmatter (${MERMAID_LAYOUTS.join("|")})`
+  ).choices(MERMAID_LAYOUTS)
+).addOption(
+  new import_commander.Option(
+    "--mermaid-theme <theme>",
+    `Mermaid theme injected as frontmatter (${MERMAID_THEMES.join("|")})`
+  ).choices(MERMAID_THEMES)
+).action(run);
 function isDirectCliExecution() {
   const entryPoint = process.argv[1];
   if (entryPoint === void 0) {