drizzle-docs-generator 0.5.2 → 0.5.3

package/dist/formatter/markdown.d.ts

@@ -109,10 +109,6 @@ export declare class MarkdownFormatter implements OutputFormatter {
      * Format relation type for display
      */
     private formatRelationType;
-    /**
-     * Create a URL-safe slug from a string
-     */
-    private slugify;
     /**
      * Create a table link based on the configured link format
      */

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,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"}
+{"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;IAS1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;CAGjC"}

package/dist/formatter/markdown.js

@@ -5,7 +5,7 @@ const d = {
   useRelativeLinks: !0,
   linkFormat: "anchor"
 };
-class T {
+class $ {
   options;
   /**
    * Create a new MarkdownFormatter
@@ -209,18 +209,12 @@ class T {
       "many-to-many": "Many to Many"
     }[e] || e;
   }
-  /**
-   * Create a URL-safe slug from a string
-   */
-  slugify(e) {
-    return e.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-  }
   /**
    * Create a table link based on the configured link format
    */
   createTableLink(e, n) {
     const t = n || e;
-    return this.options.linkFormat === "file" ? `[${t}](./${e}.md)` : `[${t}](#${this.slugify(e)})`;
+    return this.options.linkFormat === "file" ? `[${t}](./${e}.md)` : `[${t}](#${e})`;
   }
   /**
    * Escape special Markdown characters in a string
@@ -239,6 +233,6 @@ class T {
   }
 }
 export {
-  T as MarkdownFormatter
+  $ as MarkdownFormatter
 };
 //# sourceMappingURL=markdown.js.map

package/dist/formatter/markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.js","sources":["../../src/formatter/markdown.ts"],"sourcesContent":["import type {\n  IntermediateSchema,\n  TableDefinition,\n  ColumnDefinition,\n  IndexDefinition,\n  ConstraintDefinition,\n  RelationDefinition,\n  EnumDefinition,\n} from \"../types\";\nimport type { OutputFormatter, FormatterOptions } from \"./types\";\n\n/**\n * Link format for table references\n */\ntype LinkFormat = \"anchor\" | \"file\";\n\n/**\n * Options for MarkdownFormatter\n */\nexport interface MarkdownFormatterOptions extends FormatterOptions {\n  /**\n   * Whether to use relative links for table references\n   * @default true\n   */\n  useRelativeLinks?: boolean;\n  /**\n   * Link format: \"anchor\" for #table-name, \"file\" for ./table-name.md\n   * @default \"anchor\"\n   */\n  linkFormat?: LinkFormat;\n}\n\n/**\n * Default formatter options\n */\nconst DEFAULT_OPTIONS: Required<MarkdownFormatterOptions> = {\n  includeComments: true,\n  includeIndexes: true,\n  includeConstraints: true,\n  useRelativeLinks: true,\n  linkFormat: \"anchor\",\n};\n\n/**\n * MarkdownFormatter converts IntermediateSchema to tbls-style Markdown format\n *\n * This formatter generates human-readable Markdown documentation from\n * the database-agnostic IntermediateSchema representation.\n *\n * Output includes:\n * - Table index (README.md style)\n * - Individual table documentation with columns, constraints, indexes, and relations\n */\nexport class MarkdownFormatter implements OutputFormatter {\n  private options: Required<MarkdownFormatterOptions>;\n\n  /**\n   * Create a new MarkdownFormatter\n   *\n   * @param options - Formatter options\n   */\n  constructor(options: MarkdownFormatterOptions = {}) {\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n  }\n\n  /**\n   * Format the intermediate schema into a single Markdown document\n   *\n   * This generates a complete document containing the index and all table docs.\n   *\n   * @param schema - The intermediate schema to format\n   * @returns Markdown string\n   */\n  format(schema: IntermediateSchema): string {\n    const lines: string[] = [];\n\n    // Generate index section\n    lines.push(this.generateIndex(schema));\n\n    // Generate enum documentation if any\n    if (schema.enums.length > 0) {\n      lines.push(\"\");\n      lines.push(\"---\");\n      lines.push(\"\");\n      lines.push(this.generateEnumsSection(schema.enums));\n    }\n\n    // Generate table documentation\n    for (const table of schema.tables) {\n      lines.push(\"\");\n      lines.push(\"---\");\n      lines.push(\"\");\n      lines.push(this.generateTableDoc(table, schema));\n    }\n\n    return lines.join(\"\\n\").trim();\n  }\n\n  /**\n   * Generate the index section (README.md style)\n   *\n   * @param schema - The intermediate schema\n   * @returns Markdown string for the index\n   */\n  generateIndex(schema: IntermediateSchema): string {\n    const lines: string[] = [];\n\n    lines.push(\"# Tables\");\n    lines.push(\"\");\n\n    if (schema.tables.length === 0) {\n      lines.push(\"No tables defined.\");\n      return lines.join(\"\\n\");\n    }\n\n    // Table header\n    lines.push(\"| Name | Columns | Comment |\");\n    lines.push(\"|------|---------|---------|\");\n\n    // Table rows\n    for (const table of schema.tables) {\n      const name = this.options.useRelativeLinks ? this.createTableLink(table.name) : table.name;\n      const columnCount = table.columns.length;\n      const comment =\n        this.options.includeComments && table.comment ? this.escapeMarkdown(table.comment) : \"\";\n\n      lines.push(`| ${name} | ${columnCount} | ${comment} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate documentation for a single table\n   *\n   * @param table - The table definition\n   * @param schema - The full schema (for relation lookups)\n   * @returns Markdown string for the table documentation\n   */\n  generateTableDoc(table: TableDefinition, schema: IntermediateSchema): string {\n    const lines: string[] = [];\n\n    // Table heading with anchor\n    lines.push(`## ${table.name}`);\n    lines.push(\"\");\n\n    // Table comment (preserve newlines as <br> for better readability)\n    if (this.options.includeComments && table.comment) {\n      lines.push(this.escapeMarkdownWithBreaks(table.comment));\n      lines.push(\"\");\n    }\n\n    // Columns section\n    lines.push(this.generateColumnsTable(table.columns, table.name, schema));\n\n    // Constraints section\n    if (this.options.includeConstraints && table.constraints.length > 0) {\n      lines.push(\"\");\n      lines.push(this.generateConstraintsTable(table.constraints));\n    }\n\n    // Indexes section\n    if (this.options.includeIndexes && table.indexes.length > 0) {\n      lines.push(\"\");\n      lines.push(this.generateIndexesTable(table.indexes));\n    }\n\n    // Relations section\n    const tableRelations = this.getTableRelations(table.name, schema.relations);\n    if (tableRelations.length > 0) {\n      lines.push(\"\");\n      lines.push(this.generateRelationsTable(tableRelations, table.name));\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the columns table for a table\n   */\n  private generateColumnsTable(\n    columns: ColumnDefinition[],\n    tableName: string,\n    schema: IntermediateSchema,\n  ): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Columns\");\n    lines.push(\"\");\n\n    if (columns.length === 0) {\n      lines.push(\"No columns defined.\");\n      return lines.join(\"\\n\");\n    }\n\n    // Build column info with relations\n    const columnInfo = columns.map((col) => {\n      const children = this.getChildRelations(tableName, col.name, schema.relations);\n      const parents = this.getParentRelations(tableName, col.name, schema.relations);\n      return { column: col, children, parents };\n    });\n\n    // Table header\n    lines.push(\"| Name | Type | Default | Nullable | Children | Parents | Comment |\");\n    lines.push(\"|------|------|---------|----------|----------|---------|---------|\");\n\n    // Table rows\n    for (const { column, children, parents } of columnInfo) {\n      const name = column.primaryKey ? `**${column.name}**` : column.name;\n      const type = this.escapeMarkdown(column.type);\n      const defaultVal = column.defaultValue !== undefined ? `\\`${column.defaultValue}\\`` : \"-\";\n      const nullable = column.nullable ? \"YES\" : \"NO\";\n      const childrenStr = children.length > 0 ? this.formatRelationLinks(children) : \"-\";\n      const parentsStr = parents.length > 0 ? this.formatRelationLinks(parents) : \"-\";\n      const comment =\n        this.options.includeComments && column.comment ? this.escapeMarkdown(column.comment) : \"-\";\n\n      lines.push(\n        `| ${name} | ${type} | ${defaultVal} | ${nullable} | ${childrenStr} | ${parentsStr} | ${comment} |`,\n      );\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the constraints table\n   */\n  private generateConstraintsTable(constraints: ConstraintDefinition[]): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Constraints\");\n    lines.push(\"\");\n\n    lines.push(\"| Name | Type | Definition |\");\n    lines.push(\"|------|------|------------|\");\n\n    for (const constraint of constraints) {\n      const name = constraint.name || \"-\";\n      const type = this.formatConstraintType(constraint.type);\n      const definition = this.formatConstraintDefinition(constraint);\n\n      lines.push(`| ${name} | ${type} | ${definition} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the indexes table\n   */\n  private generateIndexesTable(indexes: IndexDefinition[]): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Indexes\");\n    lines.push(\"\");\n\n    lines.push(\"| Name | Columns | Unique | Type |\");\n    lines.push(\"|------|---------|--------|------|\");\n\n    for (const index of indexes) {\n      const name = index.name || \"-\";\n      const columns = index.columns.join(\", \");\n      const unique = index.unique ? \"YES\" : \"NO\";\n      const type = index.type || \"-\";\n\n      lines.push(`| ${name} | ${columns} | ${unique} | ${type} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the relations table for a specific table\n   */\n  private generateRelationsTable(relations: RelationDefinition[], tableName: string): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Relations\");\n    lines.push(\"\");\n\n    lines.push(\"| Parent | Child | Type |\");\n    lines.push(\"|--------|-------|------|\");\n\n    for (const relation of relations) {\n      const isParent = relation.toTable === tableName;\n      const parent = `${relation.toTable}.${relation.toColumns.join(\", \")}`;\n      const child = `${relation.fromTable}.${relation.fromColumns.join(\", \")}`;\n      const type = this.formatRelationType(relation.type);\n\n      // Add links if enabled\n      const parentLink = this.options.useRelativeLinks\n        ? this.createTableLink(relation.toTable, parent)\n        : parent;\n      const childLink = this.options.useRelativeLinks\n        ? this.createTableLink(relation.fromTable, child)\n        : child;\n\n      // Highlight the current table\n      const parentDisplay = isParent ? `**${parentLink}**` : parentLink;\n      const childDisplay = !isParent ? `**${childLink}**` : childLink;\n\n      lines.push(`| ${parentDisplay} | ${childDisplay} | ${type} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate documentation for enums\n   */\n  private generateEnumsSection(enums: EnumDefinition[]): string {\n    const lines: string[] = [];\n\n    lines.push(\"# Enums\");\n    lines.push(\"\");\n\n    for (const enumDef of enums) {\n      lines.push(`## ${enumDef.name}`);\n      lines.push(\"\");\n      lines.push(\"| Value |\");\n      lines.push(\"|-------|\");\n      for (const value of enumDef.values) {\n        lines.push(`| ${value} |`);\n      }\n      lines.push(\"\");\n    }\n\n    return lines.join(\"\\n\").trim();\n  }\n\n  /**\n   * Get all relations involving a specific table\n   */\n  private getTableRelations(\n    tableName: string,\n    relations: RelationDefinition[],\n  ): RelationDefinition[] {\n    return relations.filter((r) => r.fromTable === tableName || r.toTable === tableName);\n  }\n\n  /**\n   * Get child relations for a specific column (where this column is referenced)\n   */\n  private getChildRelations(\n    tableName: string,\n    columnName: string,\n    relations: RelationDefinition[],\n  ): Array<{ table: string; column: string }> {\n    return relations\n      .filter((r) => r.toTable === tableName && r.toColumns.includes(columnName))\n      .map((r) => ({\n        table: r.fromTable,\n        column: r.fromColumns.join(\", \"),\n      }));\n  }\n\n  /**\n   * Get parent relations for a specific column (columns this column references)\n   */\n  private getParentRelations(\n    tableName: string,\n    columnName: string,\n    relations: RelationDefinition[],\n  ): Array<{ table: string; column: string }> {\n    return relations\n      .filter((r) => r.fromTable === tableName && r.fromColumns.includes(columnName))\n      .map((r) => ({\n        table: r.toTable,\n        column: r.toColumns.join(\", \"),\n      }));\n  }\n\n  /**\n   * Format relation links for display in columns table\n   */\n  private formatRelationLinks(relations: Array<{ table: string; column: string }>): string {\n    return relations\n      .map((r) => {\n        const text = `${r.table}.${r.column}`;\n        return this.options.useRelativeLinks ? this.createTableLink(r.table, text) : text;\n      })\n      .join(\", \");\n  }\n\n  /**\n   * Format constraint type for display\n   */\n  private formatConstraintType(type: ConstraintDefinition[\"type\"]): string {\n    const typeMap: Record<ConstraintDefinition[\"type\"], string> = {\n      primary_key: \"PRIMARY KEY\",\n      foreign_key: \"FOREIGN KEY\",\n      unique: \"UNIQUE\",\n      check: \"CHECK\",\n      not_null: \"NOT NULL\",\n    };\n    return typeMap[type] || type;\n  }\n\n  /**\n   * Format constraint definition for display\n   */\n  private formatConstraintDefinition(constraint: ConstraintDefinition): string {\n    if (constraint.definition) {\n      return `\\`${constraint.definition}\\``;\n    }\n\n    const columns = constraint.columns.join(\", \");\n\n    if (constraint.type === \"foreign_key\" && constraint.referencedTable) {\n      const refColumns = constraint.referencedColumns?.join(\", \") || \"\";\n      return `(${columns}) → ${constraint.referencedTable}(${refColumns})`;\n    }\n\n    return `(${columns})`;\n  }\n\n  /**\n   * Format relation type for display\n   */\n  private formatRelationType(type: RelationDefinition[\"type\"]): string {\n    const typeMap: Record<RelationDefinition[\"type\"], string> = {\n      \"one-to-one\": \"One to One\",\n      \"one-to-many\": \"One to Many\",\n      \"many-to-one\": \"Many to One\",\n      \"many-to-many\": \"Many to Many\",\n    };\n    return typeMap[type] || type;\n  }\n\n  /**\n   * Create a URL-safe slug from a string\n   */\n  private slugify(str: string): string {\n    return str\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-|-$/g, \"\");\n  }\n\n  /**\n   * Create a table link based on the configured link format\n   */\n  private createTableLink(tableName: string, displayText?: string): string {\n    const text = displayText || tableName;\n    if (this.options.linkFormat === \"file\") {\n      return `[${text}](./${tableName}.md)`;\n    }\n    return `[${text}](#${this.slugify(tableName)})`;\n  }\n\n  /**\n   * Escape special Markdown characters in a string\n   * Converts newlines to spaces for use in table cells\n   */\n  private escapeMarkdown(str: string): string {\n    return str.replace(/\\|/g, \"\\\\|\").replace(/\\n/g, \" \");\n  }\n\n  /**\n   * Escape special Markdown characters and convert newlines to <br> tags\n   * Used for better readability in text sections (not in tables)\n   */\n  private escapeMarkdownWithBreaks(str: string): string {\n    return str.replace(/\\|/g, \"\\\\|\").replace(/\\n/g, \"  \\n\");\n  }\n}\n"],"names":["DEFAULT_OPTIONS","MarkdownFormatter","options","schema","lines","table","name","columnCount","comment","tableRelations","columns","tableName","columnInfo","col","children","parents","column","type","defaultVal","nullable","childrenStr","parentsStr","constraints","constraint","definition","indexes","index","unique","relations","relation","isParent","parent","child","parentLink","childLink","parentDisplay","childDisplay","enums","enumDef","value","r","columnName","text","refColumns","str","displayText"],"mappings":"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"}
+{"version":3,"file":"markdown.js","sources":["../../src/formatter/markdown.ts"],"sourcesContent":["import type {\n  IntermediateSchema,\n  TableDefinition,\n  ColumnDefinition,\n  IndexDefinition,\n  ConstraintDefinition,\n  RelationDefinition,\n  EnumDefinition,\n} from \"../types\";\nimport type { OutputFormatter, FormatterOptions } from \"./types\";\n\n/**\n * Link format for table references\n */\ntype LinkFormat = \"anchor\" | \"file\";\n\n/**\n * Options for MarkdownFormatter\n */\nexport interface MarkdownFormatterOptions extends FormatterOptions {\n  /**\n   * Whether to use relative links for table references\n   * @default true\n   */\n  useRelativeLinks?: boolean;\n  /**\n   * Link format: \"anchor\" for #table-name, \"file\" for ./table-name.md\n   * @default \"anchor\"\n   */\n  linkFormat?: LinkFormat;\n}\n\n/**\n * Default formatter options\n */\nconst DEFAULT_OPTIONS: Required<MarkdownFormatterOptions> = {\n  includeComments: true,\n  includeIndexes: true,\n  includeConstraints: true,\n  useRelativeLinks: true,\n  linkFormat: \"anchor\",\n};\n\n/**\n * MarkdownFormatter converts IntermediateSchema to tbls-style Markdown format\n *\n * This formatter generates human-readable Markdown documentation from\n * the database-agnostic IntermediateSchema representation.\n *\n * Output includes:\n * - Table index (README.md style)\n * - Individual table documentation with columns, constraints, indexes, and relations\n */\nexport class MarkdownFormatter implements OutputFormatter {\n  private options: Required<MarkdownFormatterOptions>;\n\n  /**\n   * Create a new MarkdownFormatter\n   *\n   * @param options - Formatter options\n   */\n  constructor(options: MarkdownFormatterOptions = {}) {\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n  }\n\n  /**\n   * Format the intermediate schema into a single Markdown document\n   *\n   * This generates a complete document containing the index and all table docs.\n   *\n   * @param schema - The intermediate schema to format\n   * @returns Markdown string\n   */\n  format(schema: IntermediateSchema): string {\n    const lines: string[] = [];\n\n    // Generate index section\n    lines.push(this.generateIndex(schema));\n\n    // Generate enum documentation if any\n    if (schema.enums.length > 0) {\n      lines.push(\"\");\n      lines.push(\"---\");\n      lines.push(\"\");\n      lines.push(this.generateEnumsSection(schema.enums));\n    }\n\n    // Generate table documentation\n    for (const table of schema.tables) {\n      lines.push(\"\");\n      lines.push(\"---\");\n      lines.push(\"\");\n      lines.push(this.generateTableDoc(table, schema));\n    }\n\n    return lines.join(\"\\n\").trim();\n  }\n\n  /**\n   * Generate the index section (README.md style)\n   *\n   * @param schema - The intermediate schema\n   * @returns Markdown string for the index\n   */\n  generateIndex(schema: IntermediateSchema): string {\n    const lines: string[] = [];\n\n    lines.push(\"# Tables\");\n    lines.push(\"\");\n\n    if (schema.tables.length === 0) {\n      lines.push(\"No tables defined.\");\n      return lines.join(\"\\n\");\n    }\n\n    // Table header\n    lines.push(\"| Name | Columns | Comment |\");\n    lines.push(\"|------|---------|---------|\");\n\n    // Table rows\n    for (const table of schema.tables) {\n      const name = this.options.useRelativeLinks ? this.createTableLink(table.name) : table.name;\n      const columnCount = table.columns.length;\n      const comment =\n        this.options.includeComments && table.comment ? this.escapeMarkdown(table.comment) : \"\";\n\n      lines.push(`| ${name} | ${columnCount} | ${comment} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate documentation for a single table\n   *\n   * @param table - The table definition\n   * @param schema - The full schema (for relation lookups)\n   * @returns Markdown string for the table documentation\n   */\n  generateTableDoc(table: TableDefinition, schema: IntermediateSchema): string {\n    const lines: string[] = [];\n\n    // Table heading with anchor\n    lines.push(`## ${table.name}`);\n    lines.push(\"\");\n\n    // Table comment (preserve newlines as <br> for better readability)\n    if (this.options.includeComments && table.comment) {\n      lines.push(this.escapeMarkdownWithBreaks(table.comment));\n      lines.push(\"\");\n    }\n\n    // Columns section\n    lines.push(this.generateColumnsTable(table.columns, table.name, schema));\n\n    // Constraints section\n    if (this.options.includeConstraints && table.constraints.length > 0) {\n      lines.push(\"\");\n      lines.push(this.generateConstraintsTable(table.constraints));\n    }\n\n    // Indexes section\n    if (this.options.includeIndexes && table.indexes.length > 0) {\n      lines.push(\"\");\n      lines.push(this.generateIndexesTable(table.indexes));\n    }\n\n    // Relations section\n    const tableRelations = this.getTableRelations(table.name, schema.relations);\n    if (tableRelations.length > 0) {\n      lines.push(\"\");\n      lines.push(this.generateRelationsTable(tableRelations, table.name));\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the columns table for a table\n   */\n  private generateColumnsTable(\n    columns: ColumnDefinition[],\n    tableName: string,\n    schema: IntermediateSchema,\n  ): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Columns\");\n    lines.push(\"\");\n\n    if (columns.length === 0) {\n      lines.push(\"No columns defined.\");\n      return lines.join(\"\\n\");\n    }\n\n    // Build column info with relations\n    const columnInfo = columns.map((col) => {\n      const children = this.getChildRelations(tableName, col.name, schema.relations);\n      const parents = this.getParentRelations(tableName, col.name, schema.relations);\n      return { column: col, children, parents };\n    });\n\n    // Table header\n    lines.push(\"| Name | Type | Default | Nullable | Children | Parents | Comment |\");\n    lines.push(\"|------|------|---------|----------|----------|---------|---------|\");\n\n    // Table rows\n    for (const { column, children, parents } of columnInfo) {\n      const name = column.primaryKey ? `**${column.name}**` : column.name;\n      const type = this.escapeMarkdown(column.type);\n      const defaultVal = column.defaultValue !== undefined ? `\\`${column.defaultValue}\\`` : \"-\";\n      const nullable = column.nullable ? \"YES\" : \"NO\";\n      const childrenStr = children.length > 0 ? this.formatRelationLinks(children) : \"-\";\n      const parentsStr = parents.length > 0 ? this.formatRelationLinks(parents) : \"-\";\n      const comment =\n        this.options.includeComments && column.comment ? this.escapeMarkdown(column.comment) : \"-\";\n\n      lines.push(\n        `| ${name} | ${type} | ${defaultVal} | ${nullable} | ${childrenStr} | ${parentsStr} | ${comment} |`,\n      );\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the constraints table\n   */\n  private generateConstraintsTable(constraints: ConstraintDefinition[]): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Constraints\");\n    lines.push(\"\");\n\n    lines.push(\"| Name | Type | Definition |\");\n    lines.push(\"|------|------|------------|\");\n\n    for (const constraint of constraints) {\n      const name = constraint.name || \"-\";\n      const type = this.formatConstraintType(constraint.type);\n      const definition = this.formatConstraintDefinition(constraint);\n\n      lines.push(`| ${name} | ${type} | ${definition} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the indexes table\n   */\n  private generateIndexesTable(indexes: IndexDefinition[]): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Indexes\");\n    lines.push(\"\");\n\n    lines.push(\"| Name | Columns | Unique | Type |\");\n    lines.push(\"|------|---------|--------|------|\");\n\n    for (const index of indexes) {\n      const name = index.name || \"-\";\n      const columns = index.columns.join(\", \");\n      const unique = index.unique ? \"YES\" : \"NO\";\n      const type = index.type || \"-\";\n\n      lines.push(`| ${name} | ${columns} | ${unique} | ${type} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate the relations table for a specific table\n   */\n  private generateRelationsTable(relations: RelationDefinition[], tableName: string): string {\n    const lines: string[] = [];\n\n    lines.push(\"### Relations\");\n    lines.push(\"\");\n\n    lines.push(\"| Parent | Child | Type |\");\n    lines.push(\"|--------|-------|------|\");\n\n    for (const relation of relations) {\n      const isParent = relation.toTable === tableName;\n      const parent = `${relation.toTable}.${relation.toColumns.join(\", \")}`;\n      const child = `${relation.fromTable}.${relation.fromColumns.join(\", \")}`;\n      const type = this.formatRelationType(relation.type);\n\n      // Add links if enabled\n      const parentLink = this.options.useRelativeLinks\n        ? this.createTableLink(relation.toTable, parent)\n        : parent;\n      const childLink = this.options.useRelativeLinks\n        ? this.createTableLink(relation.fromTable, child)\n        : child;\n\n      // Highlight the current table\n      const parentDisplay = isParent ? `**${parentLink}**` : parentLink;\n      const childDisplay = !isParent ? `**${childLink}**` : childLink;\n\n      lines.push(`| ${parentDisplay} | ${childDisplay} | ${type} |`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate documentation for enums\n   */\n  private generateEnumsSection(enums: EnumDefinition[]): string {\n    const lines: string[] = [];\n\n    lines.push(\"# Enums\");\n    lines.push(\"\");\n\n    for (const enumDef of enums) {\n      lines.push(`## ${enumDef.name}`);\n      lines.push(\"\");\n      lines.push(\"| Value |\");\n      lines.push(\"|-------|\");\n      for (const value of enumDef.values) {\n        lines.push(`| ${value} |`);\n      }\n      lines.push(\"\");\n    }\n\n    return lines.join(\"\\n\").trim();\n  }\n\n  /**\n   * Get all relations involving a specific table\n   */\n  private getTableRelations(\n    tableName: string,\n    relations: RelationDefinition[],\n  ): RelationDefinition[] {\n    return relations.filter((r) => r.fromTable === tableName || r.toTable === tableName);\n  }\n\n  /**\n   * Get child relations for a specific column (where this column is referenced)\n   */\n  private getChildRelations(\n    tableName: string,\n    columnName: string,\n    relations: RelationDefinition[],\n  ): Array<{ table: string; column: string }> {\n    return relations\n      .filter((r) => r.toTable === tableName && r.toColumns.includes(columnName))\n      .map((r) => ({\n        table: r.fromTable,\n        column: r.fromColumns.join(\", \"),\n      }));\n  }\n\n  /**\n   * Get parent relations for a specific column (columns this column references)\n   */\n  private getParentRelations(\n    tableName: string,\n    columnName: string,\n    relations: RelationDefinition[],\n  ): Array<{ table: string; column: string }> {\n    return relations\n      .filter((r) => r.fromTable === tableName && r.fromColumns.includes(columnName))\n      .map((r) => ({\n        table: r.toTable,\n        column: r.toColumns.join(\", \"),\n      }));\n  }\n\n  /**\n   * Format relation links for display in columns table\n   */\n  private formatRelationLinks(relations: Array<{ table: string; column: string }>): string {\n    return relations\n      .map((r) => {\n        const text = `${r.table}.${r.column}`;\n        return this.options.useRelativeLinks ? this.createTableLink(r.table, text) : text;\n      })\n      .join(\", \");\n  }\n\n  /**\n   * Format constraint type for display\n   */\n  private formatConstraintType(type: ConstraintDefinition[\"type\"]): string {\n    const typeMap: Record<ConstraintDefinition[\"type\"], string> = {\n      primary_key: \"PRIMARY KEY\",\n      foreign_key: \"FOREIGN KEY\",\n      unique: \"UNIQUE\",\n      check: \"CHECK\",\n      not_null: \"NOT NULL\",\n    };\n    return typeMap[type] || type;\n  }\n\n  /**\n   * Format constraint definition for display\n   */\n  private formatConstraintDefinition(constraint: ConstraintDefinition): string {\n    if (constraint.definition) {\n      return `\\`${constraint.definition}\\``;\n    }\n\n    const columns = constraint.columns.join(\", \");\n\n    if (constraint.type === \"foreign_key\" && constraint.referencedTable) {\n      const refColumns = constraint.referencedColumns?.join(\", \") || \"\";\n      return `(${columns}) → ${constraint.referencedTable}(${refColumns})`;\n    }\n\n    return `(${columns})`;\n  }\n\n  /**\n   * Format relation type for display\n   */\n  private formatRelationType(type: RelationDefinition[\"type\"]): string {\n    const typeMap: Record<RelationDefinition[\"type\"], string> = {\n      \"one-to-one\": \"One to One\",\n      \"one-to-many\": \"One to Many\",\n      \"many-to-one\": \"Many to One\",\n      \"many-to-many\": \"Many to Many\",\n    };\n    return typeMap[type] || type;\n  }\n  /**\n   * Create a table link based on the configured link format\n   */\n  private createTableLink(tableName: string, displayText?: string): string {\n    const text = displayText || tableName;\n    if (this.options.linkFormat === \"file\") {\n      return `[${text}](./${tableName}.md)`;\n    }\n    return `[${text}](#${tableName})`;\n  }\n\n  /**\n   * Escape special Markdown characters in a string\n   * Converts newlines to spaces for use in table cells\n   */\n  private escapeMarkdown(str: string): string {\n    return str.replace(/\\|/g, \"\\\\|\").replace(/\\n/g, \" \");\n  }\n\n  /**\n   * Escape special Markdown characters and convert newlines to <br> tags\n   * Used for better readability in text sections (not in tables)\n   */\n  private escapeMarkdownWithBreaks(str: string): string {\n    return str.replace(/\\|/g, \"\\\\|\").replace(/\\n/g, \"  \\n\");\n  }\n}\n"],"names":["DEFAULT_OPTIONS","MarkdownFormatter","options","schema","lines","table","name","columnCount","comment","tableRelations","columns","tableName","columnInfo","col","children","parents","column","type","defaultVal","nullable","childrenStr","parentsStr","constraints","constraint","definition","indexes","index","unique","relations","relation","isParent","parent","child","parentLink","childLink","parentDisplay","childDisplay","enums","enumDef","value","r","columnName","text","refColumns","displayText","str"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drizzle-docs-generator",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "A CLI tool that generates DBML files from Drizzle ORM schema definitions.",
   "keywords": [
     "cli",