drizzle-docs-generator 0.3.0 → 0.4.1

package/README.ja.md

@@ -1,9 +1,8 @@
 # drizzle-docs-generator
 
-[![npm version](https://badge.fury.io/js/drizzle-docs-generator.svg)](https://www.npmjs.com/package/drizzle-docs-generator)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![NPM](https://nodei.co/npm/drizzle-docs-generator.svg?style=shields&data=v,d&color=brightgreen)](https://nodei.co/npm/drizzle-docs-generator/)
 
-Drizzle ORM スキーマから DBML を生成する CLI。JSDoc コメントを Note 句として出力できる。
+Drizzle ORM スキーマから DBML と Markdown ドキュメントを生成する CLI。JSDoc コメントを Note 句として出力できる。
 
 **機能:**
 
@@ -18,10 +17,26 @@ Drizzle ORM スキーマから DBML を生成する CLI。JSDoc コメントを
 
 ## インストール
 
+### ローカルインストール（推奨）
+
+```bash
+# 開発依存関係としてインストール
+npm install --save-dev drizzle-docs-generator
+# or
+pnpm add -D drizzle-docs-generator
+
+# npx で実行
+npx drizzle-docs generate ./src/db/schema.ts -d postgresql
+```
+
+### グローバルインストール
+
 ```bash
 npm install -g drizzle-docs-generator
 # or
 pnpm add -g drizzle-docs-generator
+
+drizzle-docs generate ./src/db/schema.ts -d postgresql
 ```
 
 ## 使い方
@@ -38,9 +53,6 @@ drizzle-docs generate ./src/db/schema/ -d postgresql
 # ファイル出力
 drizzle-docs generate ./src/db/schema.ts -d postgresql -o schema.dbml
 
-# relations() を使う
-drizzle-docs generate ./src/db/schema.ts -d postgresql -r
-
 # watch モード
 drizzle-docs generate ./src/db/schema.ts -d postgresql -w
 ```
@@ -65,12 +77,20 @@ drizzle-docs generate ./src/db/schema.ts -d postgresql -f markdown --no-er-diagr
 | `-o, --output <path>`     | 出力ファイルまたはディレクトリパス                    |
 | `-d, --dialect <dialect>` | DB 種別: `postgresql` (デフォルト), `mysql`, `sqlite` |
 | `-f, --format <format>`   | 出力形式: `dbml` (デフォルト), `markdown`             |
-| `-r, --relational`        | relations() 定義からリファレンスを生成                |
 | `-w, --watch`             | ファイル変更時に自動再生成                            |
 | `--single-file`           | Markdown を単一ファイルで出力 (markdown のみ)         |
 | `--no-er-diagram`         | ER 図を Markdown 出力から除外                         |
 | `--force`                 | 確認なしで既存ファイルを上書き                        |
 
+### リレーション検出
+
+リレーションはスキーマから**自動検出**されます：
+
+- **v1 API** (`defineRelations()`): スキーマオブジェクトから実行時に検出
+- **v0 API** (`relations()`): ソースファイルを解析して検出
+
+設定不要 - リレーション定義があれば使用し、なければ外部キー制約にフォールバックします。
+
 ## 例
 
 ```typescript
@@ -111,38 +131,6 @@ Table users {
 
 詳細なサンプル出力は [examples/](./examples/) を参照してください。
 
-## API
-
-```typescript
-import { pgGenerate } from "drizzle-docs-generator";
-import * as schema from "./schema";
-
-const dbml = pgGenerate({
-  schema,
-  source: "./schema.ts",
-  relational: false,
-  out: "./output.dbml", // optional
-});
-```
-
-`mysqlGenerate`, `sqliteGenerate` も同様。
-
-## 動作環境
-
-- Node.js >= 24
-- Drizzle ORM v1 beta (1.0.0-beta.10+)
-- ES Modules (ESM): プロジェクトで ESM を使用していること (`package.json` に `"type": "module"`)
-
-## 仕組み
-
-このツールは [tsx](https://github.com/privatenumber/tsx) を使用してスキーマファイルを読み込むため:
-
-✅ **拡張子なしのインポートが動作**: `import { users } from './users'`
-✅ **TypeScript ファイルを直接読み込み**: コンパイル不要
-✅ **ディレクトリインポート**: ディレクトリ内のすべてのスキーマファイルを自動読み込み
-
-スキーマファイルでは、ファイル拡張子を気にせず標準的な TypeScript のモジュール解決を使用できます。
-
 ## License
 
 MIT

package/README.md

@@ -1,9 +1,8 @@
 # drizzle-docs-generator
 
-[![npm version](https://badge.fury.io/js/drizzle-docs-generator.svg)](https://www.npmjs.com/package/drizzle-docs-generator)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![NPM](https://nodei.co/npm/drizzle-docs-generator.svg?style=shields&data=v,d&color=brightgreen)](https://nodei.co/npm/drizzle-docs-generator/)
 
-CLI tool to generate DBML from Drizzle ORM schemas. Extracts JSDoc comments and outputs them as Note clauses.
+CLI tool to generate DBML and Markdown documentation from Drizzle ORM schemas. Extracts JSDoc comments and outputs them as Note clauses.
 
 **Features:**
 
@@ -18,10 +17,26 @@ CLI tool to generate DBML from Drizzle ORM schemas. Extracts JSDoc comments and
 
 ## Install
 
+### Local Install (recommended)
+
+```bash
+# As a dev dependency
+npm install --save-dev drizzle-docs-generator
+# or
+pnpm add -D drizzle-docs-generator
+
+# Then use with npx
+npx drizzle-docs generate ./src/db/schema.ts -d postgresql
+```
+
+### Global Install
+
 ```bash
 npm install -g drizzle-docs-generator
 # or
 pnpm add -g drizzle-docs-generator
+
+drizzle-docs generate ./src/db/schema.ts -d postgresql
 ```
 
 ## Usage
@@ -38,9 +53,6 @@ drizzle-docs generate ./src/db/schema/ -d postgresql
 # Output to file
 drizzle-docs generate ./src/db/schema.ts -d postgresql -o schema.dbml
 
-# Use relations() definitions
-drizzle-docs generate ./src/db/schema.ts -d postgresql -r
-
 # Watch mode
 drizzle-docs generate ./src/db/schema.ts -d postgresql -w
 ```
@@ -65,12 +77,20 @@ drizzle-docs generate ./src/db/schema.ts -d postgresql -f markdown --no-er-diagr
 | `-o, --output <path>`     | Output file or directory path                       |
 | `-d, --dialect <dialect>` | Database: `postgresql` (default), `mysql`, `sqlite` |
 | `-f, --format <format>`   | Output format: `dbml` (default), `markdown`         |
-| `-r, --relational`        | Generate refs from relations() definitions          |
 | `-w, --watch`             | Regenerate on file changes                          |
 | `--single-file`           | Output Markdown as a single file (markdown only)    |
 | `--no-er-diagram`         | Exclude ER diagram from Markdown output             |
 | `--force`                 | Overwrite existing files without confirmation       |
 
+### Relation Detection
+
+Relations are **automatically detected** from your schema:
+
+- **v1 API** (`defineRelations()`): Detected from schema objects at runtime
+- **v0 API** (`relations()`): Detected by parsing source files
+
+No configuration needed - the tool will use relation definitions when present, or fall back to foreign key constraints.
+
 ## Example
 
 ```typescript
@@ -111,38 +131,6 @@ Users table
 
 See [examples/](./examples/) for more detailed output samples.
 
-## API
-
-```typescript
-import { pgGenerate } from "drizzle-docs-generator";
-import * as schema from "./schema";
-
-const dbml = pgGenerate({
-  schema,
-  source: "./schema.ts",
-  relational: false,
-  out: "./output.dbml", // optional
-});
-```
-
-`mysqlGenerate`, `sqliteGenerate` are also available.
-
-## Requirements
-
-- Node.js >= 24
-- Drizzle ORM v1 beta (1.0.0-beta.10+)
-- ES Modules (ESM): Your project must use ESM (`"type": "module"` in package.json)
-
-## How It Works
-
-This tool uses [tsx](https://github.com/privatenumber/tsx) to load your schema files, which means:
-
-✅ **Extensionless imports work**: `import { users } from './users'`
-✅ **TypeScript files are loaded directly**: No need to compile first
-✅ **Directory imports**: Load all schema files from a directory automatically
-
-Your schema files can use standard TypeScript module resolution without worrying about file extensions.
-
 ## License
 
 MIT

package/dist/cli/index.js

@@ -1,27 +1,22 @@
 #!/usr/bin/env node
 import { Command as D } from "commander";
-import { readFileSync as q, existsSync as l, mkdirSync as g, writeFileSync as f, watch as v, lstatSync as S, readdirSync as G } from "node:fs";
+import { readFileSync as q, existsSync as l, mkdirSync as g, writeFileSync as u, watch as v, lstatSync as S, readdirSync as G } from "node:fs";
 import { join as m, dirname as p, resolve as y } from "node:path";
 import { pathToFileURL as $ } from "node:url";
 import { PgGenerator as O, pgGenerate as j } from "../generator/pg.js";
 import { MySqlGenerator as z, mysqlGenerate as P } from "../generator/mysql.js";
-import { SqliteGenerator as T, sqliteGenerate as U } from "../generator/sqlite.js";
-import "drizzle-orm";
-import "drizzle-orm/pg-core";
-import "drizzle-orm/mysql-core";
-import "drizzle-orm/sqlite-core";
-import "typescript";
+import { SqliteGenerator as T, sqliteGenerate as R } from "../generator/sqlite.js";
 import { MarkdownFormatter as F } from "../formatter/markdown.js";
 import { MermaidErDiagramFormatter as k } from "../formatter/mermaid.js";
-import { register as R } from "tsx/esm/api";
-const W = R(), h = new D(), C = m(import.meta.dirname, "../../package.json"), w = JSON.parse(q(C, "utf-8"));
+import { register as U } from "tsx/esm/api";
+const W = U(), h = new D(), C = m(import.meta.dirname, "../../package.json"), w = JSON.parse(q(C, "utf-8"));
 h.name("drizzle-docs").description(w.description).version(w.version);
 function E(r) {
   switch (r) {
     case "mysql":
       return P;
     case "sqlite":
-      return U;
+      return R;
     default:
       return j;
   }
@@ -53,7 +48,6 @@ async function L(r, e) {
   if (e.format === "markdown") {
     const a = x(e.dialect), s = new a({
       schema: n,
-      relational: e.relational,
       source: r
     }).toIntermediateSchema();
     if (!e.singleFile && e.output) {
@@ -64,7 +58,6 @@ async function L(r, e) {
   } else
     return E(e.dialect)({
       schema: n,
-      relational: e.relational,
       source: r
     });
 }
@@ -92,7 +85,6 @@ function N(r) {
 function B(r, e, o) {
   return E(o.dialect)({
     schema: r,
-    relational: o.relational,
     source: e[0]
   }) || "";
 }
@@ -129,10 +121,10 @@ ${s}
 \`\`\`
 `;
   }
-  f(m(e, "README.md"), a, "utf-8");
-  for (const i of r.tables) {
-    const s = t.generateTableDoc(i, r), c = `${i.name}.md`;
-    f(m(e, c), `# ${i.name}
+  u(m(e, "README.md"), a, "utf-8");
+  for (const c of r.tables) {
+    const s = t.generateTableDoc(c, r), i = `${c.name}.md`;
+    u(m(e, i), `# ${c.name}
 
 ${s}
 `, "utf-8");
@@ -140,7 +132,7 @@ ${s}
 }
 function J(r, e) {
   const o = p(e);
-  g(o, { recursive: !0 }), f(e, r.endsWith(`
+  g(o, { recursive: !0 }), u(e, r.endsWith(`
 `) ? r : r + `
 `, "utf-8");
 }
@@ -149,9 +141,9 @@ async function A(r, e) {
   try {
     const t = {};
     for (const n of o) {
-      const a = $(n).href, i = e.watch ? `?t=${Date.now()}` : "";
+      const a = $(n).href, c = e.watch ? `?t=${Date.now()}` : "";
       try {
-        const s = await import(a + i);
+        const s = await import(a + c);
         Object.assign(t, s);
       } catch (s) {
         throw s instanceof Error && (console.error(`Error importing ${n}: ${s.message}`), console.error(`
@@ -159,30 +151,29 @@ Possible causes:`), console.error("- Syntax error in the schema file"), console.
       }
     }
     if (e.format === "markdown") {
-      const n = x(e.dialect), i = new n({
+      const n = x(e.dialect), c = new n({
         schema: t,
-        relational: e.relational,
         source: o[0]
       }).toIntermediateSchema();
       if (e.singleFile) {
-        const s = d(i, e);
+        const s = d(c, e);
         e.output ? (!e.force && l(e.output) && (console.error(
           `Error: Output file already exists: ${e.output}
 Use --force to overwrite existing files.`
         ), process.exit(1)), J(s, e.output), console.log(`Markdown generated: ${e.output}`)) : console.log(s);
       } else if (e.output) {
         if (!e.force) {
-          const s = i.tables.map((u) => u.name), c = I(e.output, s);
-          c.length > 0 && (console.error(
+          const s = c.tables.map((f) => f.name), i = I(e.output, s);
+          i.length > 0 && (console.error(
             `Error: The following files already exist:
-${c.map((u) => `  - ${u}`).join(`
+${i.map((f) => `  - ${f}`).join(`
 `)}
 Use --force to overwrite existing files.`
           ), process.exit(1));
         }
-        M(i, e.output, e), console.log(`Markdown generated: ${e.output}/`);
+        M(c, e.output, e), console.log(`Markdown generated: ${e.output}/`);
       } else {
-        const s = d(i, e);
+        const s = d(c, e);
         console.log(s);
       }
     } else {
@@ -193,7 +184,7 @@ Use --force to overwrite existing files.`
 Use --force to overwrite existing files.`
         ), process.exit(1));
         const a = p(e.output);
-        g(a, { recursive: !0 }), f(e.output, n.endsWith(`
+        g(a, { recursive: !0 }), u(e.output, n.endsWith(`
 `) ? n : n + `
 `, "utf-8"), console.log(`DBML generated: ${e.output}`);
       } else
@@ -212,12 +203,12 @@ function V(r, e) {
       console.log(`
 File changed, regenerating...`);
       try {
-        const a = await L(o, e), i = e.format === "markdown" ? "Markdown" : "DBML", s = e.format === "markdown" && !e.singleFile && e.output;
+        const a = await L(o, e), c = e.format === "markdown" ? "Markdown" : "DBML", s = e.format === "markdown" && !e.singleFile && e.output;
         if (!e.output && a)
           console.log(a);
         else if (e.output) {
-          const c = s ? `${e.output}/` : e.output;
-          console.log(`${i} regenerated: ${c}`);
+          const i = s ? `${e.output}/` : e.output;
+          console.log(`${c} regenerated: ${i}`);
         }
       } catch (a) {
         a instanceof Error ? console.error(`Error: ${a.message}`) : console.error("Error:", a);
@@ -225,7 +216,7 @@ File changed, regenerating...`);
     }, 100));
   });
 }
-h.command("generate").description("Generate documentation from Drizzle schema files").argument("<schema>", "Path to Drizzle schema file or directory").option("-o, --output <path>", "Output file or directory path").option("-d, --dialect <dialect>", "Database dialect (postgresql, mysql, sqlite)", "postgresql").option("-f, --format <format>", "Output format (dbml, markdown)", "dbml").option("-r, --relational", "Use relations() definitions instead of foreign keys").option("-w, --watch", "Watch for file changes and regenerate").option("--single-file", "Output Markdown as a single file (for markdown format)").option("--no-er-diagram", "Exclude ER diagram from Markdown output").option("--force", "Overwrite existing files without confirmation").action(async (r, e) => {
+h.command("generate").description("Generate documentation from Drizzle schema files").argument("<schema>", "Path to Drizzle schema file or directory").option("-o, --output <path>", "Output file or directory path").option("-d, --dialect <dialect>", "Database dialect (postgresql, mysql, sqlite)", "postgresql").option("-f, --format <format>", "Output format (dbml, markdown)", "dbml").option("-w, --watch", "Watch for file changes and regenerate").option("--single-file", "Output Markdown as a single file (for markdown format)").option("--no-er-diagram", "Exclude ER diagram from Markdown output").option("--force", "Overwrite existing files without confirmation").action(async (r, e) => {
   const o = ["postgresql", "mysql", "sqlite"];
   o.includes(e.dialect) || (console.error(
     `Error: Invalid dialect "${e.dialect}". Valid options: ${o.join(", ")}`

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * CLI for drizzle-docs-generator\n *\n * Generates DBML files from Drizzle ORM schema definitions.\n */\n\nimport { Command } from \"commander\";\nimport {\n  existsSync,\n  lstatSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  watch,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { pgGenerate, mysqlGenerate, sqliteGenerate } from \"../generator/index\";\nimport { PgGenerator, MySqlGenerator, SqliteGenerator } from \"../generator/index\";\nimport { MarkdownFormatter } from \"../formatter/markdown\";\nimport { MermaidErDiagramFormatter } from \"../formatter/mermaid\";\nimport { register } from \"tsx/esm/api\";\nimport type { IntermediateSchema } from \"../types\";\n\n// Register tsx loader to support TypeScript and extensionless imports\nconst unregister = register();\n\nconst program = new Command();\n\n// Use import.meta.dirname (Node 20.11+) to resolve package.json\n// This works correctly even after bundling\nconst packageJsonPath = join(import.meta.dirname, \"../../package.json\");\nconst packageJson = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n  version: string;\n  description: string;\n};\n\nprogram.name(\"drizzle-docs\").description(packageJson.description).version(packageJson.version);\n\ntype Dialect = \"postgresql\" | \"mysql\" | \"sqlite\";\ntype OutputFormat = \"dbml\" | \"markdown\";\n\ninterface GenerateCommandOptions {\n  output?: string;\n  dialect: Dialect;\n  relational?: boolean;\n  watch?: boolean;\n  format: OutputFormat;\n  singleFile?: boolean;\n  erDiagram: boolean; // commander uses --no-er-diagram which sets erDiagram to false\n  force?: boolean; // skip overwrite confirmation for existing files\n}\n\n/**\n * Get the generate function based on dialect\n */\nfunction getGenerateFunction(dialect: Dialect) {\n  switch (dialect) {\n    case \"mysql\":\n      return mysqlGenerate;\n    case \"sqlite\":\n      return sqliteGenerate;\n    case \"postgresql\":\n    default:\n      return pgGenerate;\n  }\n}\n\n/**\n * Get the generator class based on dialect\n */\nfunction getGeneratorClass(dialect: Dialect) {\n  switch (dialect) {\n    case \"mysql\":\n      return MySqlGenerator;\n    case \"sqlite\":\n      return SqliteGenerator;\n    case \"postgresql\":\n    default:\n      return PgGenerator;\n  }\n}\n\n/**\n * Check if output directory has existing files\n */\nfunction hasExistingFiles(outputDir: string, tableNames: string[]): string[] {\n  const existingFiles: string[] = [];\n\n  if (!existsSync(outputDir)) {\n    return existingFiles;\n  }\n\n  const readmePath = join(outputDir, \"README.md\");\n  if (existsSync(readmePath)) {\n    existingFiles.push(readmePath);\n  }\n\n  for (const tableName of tableNames) {\n    const tablePath = join(outputDir, `${tableName}.md`);\n    if (existsSync(tablePath)) {\n      existingFiles.push(tablePath);\n    }\n  }\n\n  return existingFiles;\n}\n\n/**\n * Generate output from a schema file (for watch mode)\n * Returns the generated output string for single-file formats,\n * or writes multiple files directly for multi-file markdown\n */\nasync function generateFromSchema(\n  schemaPath: string,\n  options: GenerateCommandOptions,\n): Promise<string | undefined> {\n  // Use file URL for dynamic import (required for ESM)\n  const schemaUrl = pathToFileURL(schemaPath).href;\n\n  // Dynamic import with cache busting for watch mode\n  const cacheBuster = options.watch ? `?t=${Date.now()}` : \"\";\n  const schemaModule = (await import(schemaUrl + cacheBuster)) as Record<string, unknown>;\n\n  if (options.format === \"markdown\") {\n    const GeneratorClass = getGeneratorClass(options.dialect);\n    const generator = new GeneratorClass({\n      schema: schemaModule,\n      relational: options.relational,\n      source: schemaPath,\n    });\n    const intermediateSchema = generator.toIntermediateSchema();\n\n    // Handle multi-file output in watch mode\n    if (!options.singleFile && options.output) {\n      writeMarkdownMultipleFiles(intermediateSchema, options.output, options);\n      return undefined;\n    }\n\n    return generateMarkdownOutput(intermediateSchema, options);\n  } else {\n    const generate = getGenerateFunction(options.dialect);\n    return generate({\n      schema: schemaModule,\n      relational: options.relational,\n      source: schemaPath,\n    });\n  }\n}\n\n/**\n * Find all TypeScript schema files in a directory\n */\nfunction findSchemaFiles(dirPath: string): string[] {\n  const files: string[] = [];\n\n  try {\n    const entries = readdirSync(dirPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dirPath, entry.name);\n\n      if (entry.isDirectory()) {\n        // Recursively search subdirectories\n        files.push(...findSchemaFiles(fullPath));\n      } else if (entry.isFile() && /\\.(ts|js|mts|mjs|cts|cjs)$/.test(entry.name)) {\n        files.push(fullPath);\n      }\n    }\n  } catch (error) {\n    if (error instanceof Error) {\n      console.error(`Error reading directory ${dirPath}: ${error.message}`);\n    }\n  }\n\n  return files;\n}\n\n/**\n * Resolve schema path (file or directory)\n */\nfunction resolveSchemaPath(schema: string): string[] {\n  const schemaPath = resolve(process.cwd(), schema);\n\n  // Check if path exists\n  if (!existsSync(schemaPath)) {\n    console.error(`Error: Schema path not found: ${schemaPath}`);\n    process.exit(1);\n  }\n\n  // Check if it's a directory\n  const stats = lstatSync(schemaPath);\n  if (stats.isDirectory()) {\n    const schemaFiles = findSchemaFiles(schemaPath);\n    if (schemaFiles.length === 0) {\n      console.error(`Error: No schema files found in directory: ${schemaPath}`);\n      process.exit(1);\n    }\n    return schemaFiles;\n  }\n\n  // Single file\n  return [schemaPath];\n}\n\n/**\n * Generate DBML format output\n */\nfunction generateDbmlOutput(\n  mergedSchema: Record<string, unknown>,\n  schemaPaths: string[],\n  options: GenerateCommandOptions,\n): string {\n  const generate = getGenerateFunction(options.dialect);\n  return (\n    generate({\n      schema: mergedSchema,\n      relational: options.relational,\n      source: schemaPaths[0],\n    }) || \"\"\n  );\n}\n\n/**\n * Generate Markdown format output\n */\nfunction generateMarkdownOutput(\n  intermediateSchema: IntermediateSchema,\n  options: GenerateCommandOptions,\n): string {\n  const markdownFormatter = new MarkdownFormatter();\n  const markdown = markdownFormatter.format(intermediateSchema);\n\n  // Include ER diagram unless --no-er-diagram is specified\n  if (options.erDiagram) {\n    const mermaidFormatter = new MermaidErDiagramFormatter();\n    const erDiagram = mermaidFormatter.format(intermediateSchema);\n\n    return `${markdown}\\n\\n---\\n\\n## ER Diagram\\n\\n\\`\\`\\`mermaid\\n${erDiagram}\\n\\`\\`\\``;\n  }\n\n  return markdown;\n}\n\n/**\n * Write Markdown to multiple files (one per table)\n */\nfunction writeMarkdownMultipleFiles(\n  intermediateSchema: IntermediateSchema,\n  outputDir: string,\n  options: GenerateCommandOptions,\n): void {\n  // Ensure output directory exists\n  mkdirSync(outputDir, { recursive: true });\n\n  const markdownFormatter = new MarkdownFormatter({ linkFormat: \"file\" });\n\n  // Write README.md with index\n  const index = markdownFormatter.generateIndex(intermediateSchema);\n  let readme = `${index}\\n`;\n\n  // Add ER diagram to README unless disabled\n  if (options.erDiagram) {\n    const mermaidFormatter = new MermaidErDiagramFormatter();\n    const erDiagram = mermaidFormatter.format(intermediateSchema);\n    readme += `\\n---\\n\\n## ER Diagram\\n\\n\\`\\`\\`mermaid\\n${erDiagram}\\n\\`\\`\\`\\n`;\n  }\n\n  writeFileSync(join(outputDir, \"README.md\"), readme, \"utf-8\");\n\n  // Write individual table files\n  for (const table of intermediateSchema.tables) {\n    const tableDoc = markdownFormatter.generateTableDoc(table, intermediateSchema);\n    const fileName = `${table.name}.md`;\n    writeFileSync(join(outputDir, fileName), `# ${table.name}\\n\\n${tableDoc}\\n`, \"utf-8\");\n  }\n}\n\n/**\n * Write single Markdown file\n */\nfunction writeSingleMarkdownFile(content: string, outputPath: string): void {\n  const dir = dirname(outputPath);\n  mkdirSync(dir, { recursive: true });\n  writeFileSync(outputPath, content.endsWith(\"\\n\") ? content : content + \"\\n\", \"utf-8\");\n}\n\n/**\n * Run the generate command\n */\nasync function runGenerate(schema: string, options: GenerateCommandOptions): Promise<void> {\n  const schemaPaths = resolveSchemaPath(schema);\n\n  try {\n    // Merge all schema modules\n    const mergedSchema: Record<string, unknown> = {};\n\n    for (const schemaPath of schemaPaths) {\n      const schemaUrl = pathToFileURL(schemaPath).href;\n      const cacheBuster = options.watch ? `?t=${Date.now()}` : \"\";\n\n      try {\n        const schemaModule = (await import(schemaUrl + cacheBuster)) as Record<string, unknown>;\n        Object.assign(mergedSchema, schemaModule);\n      } catch (error) {\n        if (error instanceof Error) {\n          console.error(`Error importing ${schemaPath}: ${error.message}`);\n          console.error(\"\\nPossible causes:\");\n          console.error(\"- Syntax error in the schema file\");\n          console.error(\"- Missing dependencies (make sure drizzle-orm is installed)\");\n          console.error(\"- Circular dependencies between schema files\");\n        }\n        throw error;\n      }\n    }\n\n    if (options.format === \"markdown\") {\n      // Generate Markdown format\n      const GeneratorClass = getGeneratorClass(options.dialect);\n      const generator = new GeneratorClass({\n        schema: mergedSchema,\n        relational: options.relational,\n        source: schemaPaths[0],\n      });\n      const intermediateSchema = generator.toIntermediateSchema();\n\n      if (options.singleFile) {\n        // Single file Markdown output\n        const content = generateMarkdownOutput(intermediateSchema, options);\n\n        if (options.output) {\n          // Check for existing file if --force is not specified\n          if (!options.force && existsSync(options.output)) {\n            console.error(\n              `Error: Output file already exists: ${options.output}\\nUse --force to overwrite existing files.`,\n            );\n            process.exit(1);\n          }\n          writeSingleMarkdownFile(content, options.output);\n          console.log(`Markdown generated: ${options.output}`);\n        } else {\n          console.log(content);\n        }\n      } else {\n        // Multiple files Markdown output\n        if (!options.output) {\n          // If no output specified, default to stdout with single file format\n          const content = generateMarkdownOutput(intermediateSchema, options);\n          console.log(content);\n        } else {\n          // Check for existing files if --force is not specified\n          if (!options.force) {\n            const tableNames = intermediateSchema.tables.map((t) => t.name);\n            const existingFiles = hasExistingFiles(options.output, tableNames);\n            if (existingFiles.length > 0) {\n              console.error(\n                `Error: The following files already exist:\\n${existingFiles.map((f) => `  - ${f}`).join(\"\\n\")}\\nUse --force to overwrite existing files.`,\n              );\n              process.exit(1);\n            }\n          }\n          writeMarkdownMultipleFiles(intermediateSchema, options.output, options);\n          console.log(`Markdown generated: ${options.output}/`);\n        }\n      }\n    } else {\n      // Generate DBML format (default)\n      const dbml = generateDbmlOutput(mergedSchema, schemaPaths, options);\n\n      if (options.output) {\n        // Check for existing file if --force is not specified\n        if (!options.force && existsSync(options.output)) {\n          console.error(\n            `Error: Output file already exists: ${options.output}\\nUse --force to overwrite existing files.`,\n          );\n          process.exit(1);\n        }\n        const dir = dirname(options.output);\n        mkdirSync(dir, { recursive: true });\n        writeFileSync(options.output, dbml.endsWith(\"\\n\") ? dbml : dbml + \"\\n\", \"utf-8\");\n        console.log(`DBML generated: ${options.output}`);\n      } else {\n        console.log(dbml);\n      }\n    }\n  } catch (error) {\n    if (error instanceof Error) {\n      console.error(`Error generating output: ${error.message}`);\n    } else {\n      console.error(\"Error generating output:\", error);\n    }\n    process.exit(1);\n  }\n}\n\n/**\n * Watch mode: regenerate on file changes\n */\nfunction watchSchema(schema: string, options: GenerateCommandOptions): void {\n  const schemaPath = resolve(process.cwd(), schema);\n\n  console.log(`Watching for changes: ${schemaPath}`);\n\n  let debounceTimer: NodeJS.Timeout | null = null;\n\n  watch(schemaPath, async (eventType) => {\n    if (eventType === \"change\") {\n      // Debounce to avoid multiple triggers\n      if (debounceTimer) {\n        clearTimeout(debounceTimer);\n      }\n\n      debounceTimer = setTimeout(async () => {\n        console.log(\"\\nFile changed, regenerating...\");\n        try {\n          const output = await generateFromSchema(schemaPath, options);\n          const formatLabel = options.format === \"markdown\" ? \"Markdown\" : \"DBML\";\n          const isMultiFile =\n            options.format === \"markdown\" && !options.singleFile && options.output;\n\n          if (!options.output && output) {\n            console.log(output);\n          } else if (options.output) {\n            const outputLabel = isMultiFile ? `${options.output}/` : options.output;\n            console.log(`${formatLabel} regenerated: ${outputLabel}`);\n          }\n        } catch (error) {\n          if (error instanceof Error) {\n            console.error(`Error: ${error.message}`);\n          } else {\n            console.error(\"Error:\", error);\n          }\n        }\n      }, 100);\n    }\n  });\n}\n\nprogram\n  .command(\"generate\")\n  .description(\"Generate documentation from Drizzle schema files\")\n  .argument(\"<schema>\", \"Path to Drizzle schema file or directory\")\n  .option(\"-o, --output <path>\", \"Output file or directory path\")\n  .option(\"-d, --dialect <dialect>\", \"Database dialect (postgresql, mysql, sqlite)\", \"postgresql\")\n  .option(\"-f, --format <format>\", \"Output format (dbml, markdown)\", \"dbml\")\n  .option(\"-r, --relational\", \"Use relations() definitions instead of foreign keys\")\n  .option(\"-w, --watch\", \"Watch for file changes and regenerate\")\n  .option(\"--single-file\", \"Output Markdown as a single file (for markdown format)\")\n  .option(\"--no-er-diagram\", \"Exclude ER diagram from Markdown output\")\n  .option(\"--force\", \"Overwrite existing files without confirmation\")\n  .action(async (schema: string, options: GenerateCommandOptions) => {\n    // Validate dialect\n    const validDialects: Dialect[] = [\"postgresql\", \"mysql\", \"sqlite\"];\n    if (!validDialects.includes(options.dialect)) {\n      console.error(\n        `Error: Invalid dialect \"${options.dialect}\". Valid options: ${validDialects.join(\", \")}`,\n      );\n      process.exit(1);\n    }\n\n    // Validate format\n    const validFormats: OutputFormat[] = [\"dbml\", \"markdown\"];\n    if (!validFormats.includes(options.format)) {\n      console.error(\n        `Error: Invalid format \"${options.format}\". Valid options: ${validFormats.join(\", \")}`,\n      );\n      process.exit(1);\n    }\n\n    // Warn if --single-file or --no-er-diagram used with non-markdown format\n    if (options.format !== \"markdown\") {\n      if (options.singleFile) {\n        console.warn(\"Warning: --single-file is only applicable with --format markdown\");\n      }\n      if (!options.erDiagram) {\n        console.warn(\"Warning: --no-er-diagram is only applicable with --format markdown\");\n      }\n    }\n\n    // Initial generation\n    await runGenerate(schema, options);\n\n    // Start watch mode if requested\n    if (options.watch) {\n      watchSchema(schema, options);\n    }\n  });\n\nprogram.parse();\n\n// Cleanup: Unregister tsx loader when process exits\nprocess.on(\"exit\", () => {\n  unregister();\n});\n"],"names":["unregister","register","program","Command","packageJsonPath","join","packageJson","readFileSync","getGenerateFunction","dialect","mysqlGenerate","sqliteGenerate","pgGenerate","getGeneratorClass","MySqlGenerator","SqliteGenerator","PgGenerator","hasExistingFiles","outputDir","tableNames","existingFiles","existsSync","readmePath","tableName","tablePath","generateFromSchema","schemaPath","options","schemaUrl","pathToFileURL","cacheBuster","schemaModule","GeneratorClass","intermediateSchema","writeMarkdownMultipleFiles","generateMarkdownOutput","findSchemaFiles","dirPath","files","entries","readdirSync","entry","fullPath","error","resolveSchemaPath","schema","resolve","lstatSync","schemaFiles","generateDbmlOutput","mergedSchema","schemaPaths","markdown","MarkdownFormatter","erDiagram","MermaidErDiagramFormatter","mkdirSync","markdownFormatter","readme","writeFileSync","table","tableDoc","fileName","writeSingleMarkdownFile","content","outputPath","dir","dirname","runGenerate","t","f","dbml","watchSchema","debounceTimer","watch","eventType","output","formatLabel","isMultiFile","outputLabel","validDialects","validFormats"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * CLI for drizzle-docs-generator\n *\n * Generates DBML files from Drizzle ORM schema definitions.\n */\n\nimport { Command } from \"commander\";\nimport {\n  existsSync,\n  lstatSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  watch,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { pgGenerate } from \"../generator/pg\";\nimport { mysqlGenerate } from \"../generator/mysql\";\nimport { sqliteGenerate } from \"../generator/sqlite\";\nimport { PgGenerator } from \"../generator/pg\";\nimport { MySqlGenerator } from \"../generator/mysql\";\nimport { SqliteGenerator } from \"../generator/sqlite\";\nimport { MarkdownFormatter } from \"../formatter/markdown\";\nimport { MermaidErDiagramFormatter } from \"../formatter/mermaid\";\nimport { register } from \"tsx/esm/api\";\nimport type { IntermediateSchema } from \"../types\";\n\n// Register tsx loader to support TypeScript and extensionless imports\nconst unregister = register();\n\nconst program = new Command();\n\n// Use import.meta.dirname (Node 20.11+) to resolve package.json\n// This works correctly even after bundling\nconst packageJsonPath = join(import.meta.dirname, \"../../package.json\");\nconst packageJson = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n  version: string;\n  description: string;\n};\n\nprogram.name(\"drizzle-docs\").description(packageJson.description).version(packageJson.version);\n\ntype Dialect = \"postgresql\" | \"mysql\" | \"sqlite\";\ntype OutputFormat = \"dbml\" | \"markdown\";\n\ninterface GenerateCommandOptions {\n  output?: string;\n  dialect: Dialect;\n  watch?: boolean;\n  format: OutputFormat;\n  singleFile?: boolean;\n  erDiagram: boolean; // commander uses --no-er-diagram which sets erDiagram to false\n  force?: boolean; // skip overwrite confirmation for existing files\n}\n\n/**\n * Get the generate function based on dialect\n */\nfunction getGenerateFunction(dialect: Dialect) {\n  switch (dialect) {\n    case \"mysql\":\n      return mysqlGenerate;\n    case \"sqlite\":\n      return sqliteGenerate;\n    case \"postgresql\":\n    default:\n      return pgGenerate;\n  }\n}\n\n/**\n * Get the generator class based on dialect\n */\nfunction getGeneratorClass(dialect: Dialect) {\n  switch (dialect) {\n    case \"mysql\":\n      return MySqlGenerator;\n    case \"sqlite\":\n      return SqliteGenerator;\n    case \"postgresql\":\n    default:\n      return PgGenerator;\n  }\n}\n\n/**\n * Check if output directory has existing files\n */\nfunction hasExistingFiles(outputDir: string, tableNames: string[]): string[] {\n  const existingFiles: string[] = [];\n\n  if (!existsSync(outputDir)) {\n    return existingFiles;\n  }\n\n  const readmePath = join(outputDir, \"README.md\");\n  if (existsSync(readmePath)) {\n    existingFiles.push(readmePath);\n  }\n\n  for (const tableName of tableNames) {\n    const tablePath = join(outputDir, `${tableName}.md`);\n    if (existsSync(tablePath)) {\n      existingFiles.push(tablePath);\n    }\n  }\n\n  return existingFiles;\n}\n\n/**\n * Generate output from a schema file (for watch mode)\n * Returns the generated output string for single-file formats,\n * or writes multiple files directly for multi-file markdown\n */\nasync function generateFromSchema(\n  schemaPath: string,\n  options: GenerateCommandOptions,\n): Promise<string | undefined> {\n  // Use file URL for dynamic import (required for ESM)\n  const schemaUrl = pathToFileURL(schemaPath).href;\n\n  // Dynamic import with cache busting for watch mode\n  const cacheBuster = options.watch ? `?t=${Date.now()}` : \"\";\n  const schemaModule = (await import(schemaUrl + cacheBuster)) as Record<string, unknown>;\n\n  if (options.format === \"markdown\") {\n    const GeneratorClass = getGeneratorClass(options.dialect);\n    const generator = new GeneratorClass({\n      schema: schemaModule,\n      source: schemaPath,\n    });\n    const intermediateSchema = generator.toIntermediateSchema();\n\n    // Handle multi-file output in watch mode\n    if (!options.singleFile && options.output) {\n      writeMarkdownMultipleFiles(intermediateSchema, options.output, options);\n      return undefined;\n    }\n\n    return generateMarkdownOutput(intermediateSchema, options);\n  } else {\n    const generate = getGenerateFunction(options.dialect);\n    return generate({\n      schema: schemaModule,\n      source: schemaPath,\n    });\n  }\n}\n\n/**\n * Find all TypeScript schema files in a directory\n */\nfunction findSchemaFiles(dirPath: string): string[] {\n  const files: string[] = [];\n\n  try {\n    const entries = readdirSync(dirPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dirPath, entry.name);\n\n      if (entry.isDirectory()) {\n        // Recursively search subdirectories\n        files.push(...findSchemaFiles(fullPath));\n      } else if (entry.isFile() && /\\.(ts|js|mts|mjs|cts|cjs)$/.test(entry.name)) {\n        files.push(fullPath);\n      }\n    }\n  } catch (error) {\n    if (error instanceof Error) {\n      console.error(`Error reading directory ${dirPath}: ${error.message}`);\n    }\n  }\n\n  return files;\n}\n\n/**\n * Resolve schema path (file or directory)\n */\nfunction resolveSchemaPath(schema: string): string[] {\n  const schemaPath = resolve(process.cwd(), schema);\n\n  // Check if path exists\n  if (!existsSync(schemaPath)) {\n    console.error(`Error: Schema path not found: ${schemaPath}`);\n    process.exit(1);\n  }\n\n  // Check if it's a directory\n  const stats = lstatSync(schemaPath);\n  if (stats.isDirectory()) {\n    const schemaFiles = findSchemaFiles(schemaPath);\n    if (schemaFiles.length === 0) {\n      console.error(`Error: No schema files found in directory: ${schemaPath}`);\n      process.exit(1);\n    }\n    return schemaFiles;\n  }\n\n  // Single file\n  return [schemaPath];\n}\n\n/**\n * Generate DBML format output\n */\nfunction generateDbmlOutput(\n  mergedSchema: Record<string, unknown>,\n  schemaPaths: string[],\n  options: GenerateCommandOptions,\n): string {\n  const generate = getGenerateFunction(options.dialect);\n  return (\n    generate({\n      schema: mergedSchema,\n      source: schemaPaths[0],\n    }) || \"\"\n  );\n}\n\n/**\n * Generate Markdown format output\n */\nfunction generateMarkdownOutput(\n  intermediateSchema: IntermediateSchema,\n  options: GenerateCommandOptions,\n): string {\n  const markdownFormatter = new MarkdownFormatter();\n  const markdown = markdownFormatter.format(intermediateSchema);\n\n  // Include ER diagram unless --no-er-diagram is specified\n  if (options.erDiagram) {\n    const mermaidFormatter = new MermaidErDiagramFormatter();\n    const erDiagram = mermaidFormatter.format(intermediateSchema);\n\n    return `${markdown}\\n\\n---\\n\\n## ER Diagram\\n\\n\\`\\`\\`mermaid\\n${erDiagram}\\n\\`\\`\\``;\n  }\n\n  return markdown;\n}\n\n/**\n * Write Markdown to multiple files (one per table)\n */\nfunction writeMarkdownMultipleFiles(\n  intermediateSchema: IntermediateSchema,\n  outputDir: string,\n  options: GenerateCommandOptions,\n): void {\n  // Ensure output directory exists\n  mkdirSync(outputDir, { recursive: true });\n\n  const markdownFormatter = new MarkdownFormatter({ linkFormat: \"file\" });\n\n  // Write README.md with index\n  const index = markdownFormatter.generateIndex(intermediateSchema);\n  let readme = `${index}\\n`;\n\n  // Add ER diagram to README unless disabled\n  if (options.erDiagram) {\n    const mermaidFormatter = new MermaidErDiagramFormatter();\n    const erDiagram = mermaidFormatter.format(intermediateSchema);\n    readme += `\\n---\\n\\n## ER Diagram\\n\\n\\`\\`\\`mermaid\\n${erDiagram}\\n\\`\\`\\`\\n`;\n  }\n\n  writeFileSync(join(outputDir, \"README.md\"), readme, \"utf-8\");\n\n  // Write individual table files\n  for (const table of intermediateSchema.tables) {\n    const tableDoc = markdownFormatter.generateTableDoc(table, intermediateSchema);\n    const fileName = `${table.name}.md`;\n    writeFileSync(join(outputDir, fileName), `# ${table.name}\\n\\n${tableDoc}\\n`, \"utf-8\");\n  }\n}\n\n/**\n * Write single Markdown file\n */\nfunction writeSingleMarkdownFile(content: string, outputPath: string): void {\n  const dir = dirname(outputPath);\n  mkdirSync(dir, { recursive: true });\n  writeFileSync(outputPath, content.endsWith(\"\\n\") ? content : content + \"\\n\", \"utf-8\");\n}\n\n/**\n * Run the generate command\n */\nasync function runGenerate(schema: string, options: GenerateCommandOptions): Promise<void> {\n  const schemaPaths = resolveSchemaPath(schema);\n\n  try {\n    // Merge all schema modules\n    const mergedSchema: Record<string, unknown> = {};\n\n    for (const schemaPath of schemaPaths) {\n      const schemaUrl = pathToFileURL(schemaPath).href;\n      const cacheBuster = options.watch ? `?t=${Date.now()}` : \"\";\n\n      try {\n        const schemaModule = (await import(schemaUrl + cacheBuster)) as Record<string, unknown>;\n        Object.assign(mergedSchema, schemaModule);\n      } catch (error) {\n        if (error instanceof Error) {\n          console.error(`Error importing ${schemaPath}: ${error.message}`);\n          console.error(\"\\nPossible causes:\");\n          console.error(\"- Syntax error in the schema file\");\n          console.error(\"- Missing dependencies (make sure drizzle-orm is installed)\");\n          console.error(\"- Circular dependencies between schema files\");\n        }\n        throw error;\n      }\n    }\n\n    if (options.format === \"markdown\") {\n      // Generate Markdown format\n      const GeneratorClass = getGeneratorClass(options.dialect);\n      const generator = new GeneratorClass({\n        schema: mergedSchema,\n        source: schemaPaths[0],\n      });\n      const intermediateSchema = generator.toIntermediateSchema();\n\n      if (options.singleFile) {\n        // Single file Markdown output\n        const content = generateMarkdownOutput(intermediateSchema, options);\n\n        if (options.output) {\n          // Check for existing file if --force is not specified\n          if (!options.force && existsSync(options.output)) {\n            console.error(\n              `Error: Output file already exists: ${options.output}\\nUse --force to overwrite existing files.`,\n            );\n            process.exit(1);\n          }\n          writeSingleMarkdownFile(content, options.output);\n          console.log(`Markdown generated: ${options.output}`);\n        } else {\n          console.log(content);\n        }\n      } else {\n        // Multiple files Markdown output\n        if (!options.output) {\n          // If no output specified, default to stdout with single file format\n          const content = generateMarkdownOutput(intermediateSchema, options);\n          console.log(content);\n        } else {\n          // Check for existing files if --force is not specified\n          if (!options.force) {\n            const tableNames = intermediateSchema.tables.map((t) => t.name);\n            const existingFiles = hasExistingFiles(options.output, tableNames);\n            if (existingFiles.length > 0) {\n              console.error(\n                `Error: The following files already exist:\\n${existingFiles.map((f) => `  - ${f}`).join(\"\\n\")}\\nUse --force to overwrite existing files.`,\n              );\n              process.exit(1);\n            }\n          }\n          writeMarkdownMultipleFiles(intermediateSchema, options.output, options);\n          console.log(`Markdown generated: ${options.output}/`);\n        }\n      }\n    } else {\n      // Generate DBML format (default)\n      const dbml = generateDbmlOutput(mergedSchema, schemaPaths, options);\n\n      if (options.output) {\n        // Check for existing file if --force is not specified\n        if (!options.force && existsSync(options.output)) {\n          console.error(\n            `Error: Output file already exists: ${options.output}\\nUse --force to overwrite existing files.`,\n          );\n          process.exit(1);\n        }\n        const dir = dirname(options.output);\n        mkdirSync(dir, { recursive: true });\n        writeFileSync(options.output, dbml.endsWith(\"\\n\") ? dbml : dbml + \"\\n\", \"utf-8\");\n        console.log(`DBML generated: ${options.output}`);\n      } else {\n        console.log(dbml);\n      }\n    }\n  } catch (error) {\n    if (error instanceof Error) {\n      console.error(`Error generating output: ${error.message}`);\n    } else {\n      console.error(\"Error generating output:\", error);\n    }\n    process.exit(1);\n  }\n}\n\n/**\n * Watch mode: regenerate on file changes\n */\nfunction watchSchema(schema: string, options: GenerateCommandOptions): void {\n  const schemaPath = resolve(process.cwd(), schema);\n\n  console.log(`Watching for changes: ${schemaPath}`);\n\n  let debounceTimer: NodeJS.Timeout | null = null;\n\n  watch(schemaPath, async (eventType) => {\n    if (eventType === \"change\") {\n      // Debounce to avoid multiple triggers\n      if (debounceTimer) {\n        clearTimeout(debounceTimer);\n      }\n\n      debounceTimer = setTimeout(async () => {\n        console.log(\"\\nFile changed, regenerating...\");\n        try {\n          const output = await generateFromSchema(schemaPath, options);\n          const formatLabel = options.format === \"markdown\" ? \"Markdown\" : \"DBML\";\n          const isMultiFile =\n            options.format === \"markdown\" && !options.singleFile && options.output;\n\n          if (!options.output && output) {\n            console.log(output);\n          } else if (options.output) {\n            const outputLabel = isMultiFile ? `${options.output}/` : options.output;\n            console.log(`${formatLabel} regenerated: ${outputLabel}`);\n          }\n        } catch (error) {\n          if (error instanceof Error) {\n            console.error(`Error: ${error.message}`);\n          } else {\n            console.error(\"Error:\", error);\n          }\n        }\n      }, 100);\n    }\n  });\n}\n\nprogram\n  .command(\"generate\")\n  .description(\"Generate documentation from Drizzle schema files\")\n  .argument(\"<schema>\", \"Path to Drizzle schema file or directory\")\n  .option(\"-o, --output <path>\", \"Output file or directory path\")\n  .option(\"-d, --dialect <dialect>\", \"Database dialect (postgresql, mysql, sqlite)\", \"postgresql\")\n  .option(\"-f, --format <format>\", \"Output format (dbml, markdown)\", \"dbml\")\n  .option(\"-w, --watch\", \"Watch for file changes and regenerate\")\n  .option(\"--single-file\", \"Output Markdown as a single file (for markdown format)\")\n  .option(\"--no-er-diagram\", \"Exclude ER diagram from Markdown output\")\n  .option(\"--force\", \"Overwrite existing files without confirmation\")\n  .action(async (schema: string, options: GenerateCommandOptions) => {\n    // Validate dialect\n    const validDialects: Dialect[] = [\"postgresql\", \"mysql\", \"sqlite\"];\n    if (!validDialects.includes(options.dialect)) {\n      console.error(\n        `Error: Invalid dialect \"${options.dialect}\". Valid options: ${validDialects.join(\", \")}`,\n      );\n      process.exit(1);\n    }\n\n    // Validate format\n    const validFormats: OutputFormat[] = [\"dbml\", \"markdown\"];\n    if (!validFormats.includes(options.format)) {\n      console.error(\n        `Error: Invalid format \"${options.format}\". Valid options: ${validFormats.join(\", \")}`,\n      );\n      process.exit(1);\n    }\n\n    // Warn if --single-file or --no-er-diagram used with non-markdown format\n    if (options.format !== \"markdown\") {\n      if (options.singleFile) {\n        console.warn(\"Warning: --single-file is only applicable with --format markdown\");\n      }\n      if (!options.erDiagram) {\n        console.warn(\"Warning: --no-er-diagram is only applicable with --format markdown\");\n      }\n    }\n\n    // Initial generation\n    await runGenerate(schema, options);\n\n    // Start watch mode if requested\n    if (options.watch) {\n      watchSchema(schema, options);\n    }\n  });\n\nprogram.parse();\n\n// Cleanup: Unregister tsx loader when process exits\nprocess.on(\"exit\", () => {\n  unregister();\n});\n"],"names":["unregister","register","program","Command","packageJsonPath","join","packageJson","readFileSync","getGenerateFunction","dialect","mysqlGenerate","sqliteGenerate","pgGenerate","getGeneratorClass","MySqlGenerator","SqliteGenerator","PgGenerator","hasExistingFiles","outputDir","tableNames","existingFiles","existsSync","readmePath","tableName","tablePath","generateFromSchema","schemaPath","options","schemaUrl","pathToFileURL","cacheBuster","schemaModule","GeneratorClass","intermediateSchema","writeMarkdownMultipleFiles","generateMarkdownOutput","findSchemaFiles","dirPath","files","entries","readdirSync","entry","fullPath","error","resolveSchemaPath","schema","resolve","lstatSync","schemaFiles","generateDbmlOutput","mergedSchema","schemaPaths","markdown","MarkdownFormatter","erDiagram","MermaidErDiagramFormatter","mkdirSync","markdownFormatter","readme","writeFileSync","table","tableDoc","fileName","writeSingleMarkdownFile","content","outputPath","dir","dirname","runGenerate","t","dbml","watchSchema","debounceTimer","watch","eventType","output","formatLabel","isMultiFile","outputLabel","validDialects","validFormats"],"mappings":"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"}

package/dist/formatter/markdown.d.ts

@@ -3,7 +3,7 @@ import { OutputFormatter, FormatterOptions } from './types';
 /**
  * Link format for table references
  */
-export type LinkFormat = "anchor" | "file";
+type LinkFormat = "anchor" | "file";
 /**
  * Options for MarkdownFormatter
  */
@@ -119,7 +119,14 @@ export declare class MarkdownFormatter implements OutputFormatter {
     private createTableLink;
     /**
      * Escape special Markdown characters in a string
+     * Converts newlines to spaces for use in table cells
      */
     private escapeMarkdown;
+    /**
+     * Escape special Markdown characters and convert newlines to <br> tags
+     * Used for better readability in text sections (not in tables)
+     */
+    private escapeMarkdownWithBreaks;
 }
+export {};
 //# sourceMappingURL=markdown.d.ts.map

package/dist/formatter/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/formatter/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EAMhB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAaD;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,OAAO,CAAqC;IAEpD;;;;OAIG;gBACS,OAAO,GAAE,wBAA6B;IAIlD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAyB1C;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IA4BjD;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAsC5E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiC9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAelC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAGvB"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/formatter/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EAMhB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,KAAK,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAaD;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,OAAO,CAAqC;IAEpD;;;;OAIG;gBACS,OAAO,GAAE,wBAA6B;IAIlD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAyB1C;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IA4BjD;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAsC5E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiC9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAelC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;CAGjC"}

package/dist/formatter/markdown.js

@@ -59,7 +59,7 @@ class T {
    */
   generateTableDoc(e, n) {
     const t = [];
-    t.push(`## ${e.name}`), t.push(""), this.options.includeComments && e.comment && (t.push(this.escapeMarkdown(e.comment)), t.push("")), t.push(this.generateColumnsTable(e.columns, e.name, n)), this.options.includeConstraints && e.constraints.length > 0 && (t.push(""), t.push(this.generateConstraintsTable(e.constraints))), this.options.includeIndexes && e.indexes.length > 0 && (t.push(""), t.push(this.generateIndexesTable(e.indexes)));
+    t.push(`## ${e.name}`), t.push(""), this.options.includeComments && e.comment && (t.push(this.escapeMarkdownWithBreaks(e.comment)), t.push("")), t.push(this.generateColumnsTable(e.columns, e.name, n)), this.options.includeConstraints && e.constraints.length > 0 && (t.push(""), t.push(this.generateConstraintsTable(e.constraints))), this.options.includeIndexes && e.indexes.length > 0 && (t.push(""), t.push(this.generateIndexesTable(e.indexes)));
     const s = this.getTableRelations(e.name, n.relations);
     return s.length > 0 && (t.push(""), t.push(this.generateRelationsTable(s, e.name))), t.join(`
 `);
@@ -224,10 +224,19 @@ class T {
   }
   /**
    * Escape special Markdown characters in a string
+   * Converts newlines to spaces for use in table cells
    */
   escapeMarkdown(e) {
     return e.replace(/\|/g, "\\|").replace(/\n/g, " ");
   }
+  /**
+   * Escape special Markdown characters and convert newlines to <br> tags
+   * Used for better readability in text sections (not in tables)
+   */
+  escapeMarkdownWithBreaks(e) {
+    return e.replace(/\|/g, "\\|").replace(/\n/g, `  
+`);
+  }
 }
 export {
   T as MarkdownFormatter