@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/export/markdown-generator.js

@@ -0,0 +1,248 @@
+import { formatLayerName } from "../utils/layer-name-formatter.js";
+import { CANONICAL_LAYER_NAMES } from "../core/layers.js";
+import { escapeMarkdown, valueToMarkdown, getLayerDescription } from "./markdown-utils.js";
+const MAX_DETAIL_ELEMENTS = 10;
+class MarkdownGenerator {
+  model;
+  options;
+  constructor(model, options = {}) {
+    this.model = model, this.options = {
+      includeMermaid: options.includeMermaid ?? !0,
+      includeTables: options.includeTables ?? !0,
+      maxTableRows: options.maxTableRows ?? 50,
+      diagramType: options.diagramType ?? "graph"
+    };
+  }
+  /**
+   * Generate complete markdown documentation with diagrams and tables
+   */
+  async generate() {
+    const lines = [];
+    lines.push(`# ${this.escapeMarkdownLocal(this.model.manifest.name)}`), lines.push(""), this.model.manifest.description && (lines.push(this.model.manifest.description), lines.push("")), lines.push("## Table of Contents"), lines.push(""), lines.push("- [Architecture Overview](#architecture-overview)"), lines.push("- [Layer Summary](#layer-summary)"), lines.push("- [Detailed Layer Documentation](#detailed-layer-documentation)"), lines.push(""), lines.push("## Architecture Overview"), lines.push(""), this.options.includeMermaid && (lines.push(this.generateArchitectureOverviewDiagram()), lines.push("")), lines.push("### Model Information"), lines.push(""), lines.push(this.generateModelMetadataTable()), lines.push(""), lines.push("## Layer Summary"), lines.push(""), lines.push(this.generateLayerSummaryTable()), lines.push(""), lines.push("## Detailed Layer Documentation"), lines.push("");
+    const layers = Array.from(this.model.graph.nodes.values()).reduce((acc, node) => (acc.includes(node.layer) || acc.push(node.layer), acc), []).sort();
+    for (const layerName of layers) {
+      const layerNodes = this.model.graph.getNodesByLayer(layerName);
+      layerNodes.length !== 0 && (lines.push(`### ${this.formatLayerName(layerName)}`), lines.push(""), lines.push(this.getLayerDescriptionText(layerName)), lines.push(""), this.options.includeMermaid && (lines.push(this.generateLayerDiagram(layerNodes)), lines.push("")), this.options.includeTables && (lines.push(this.generateLayerElementsTable(layerNodes)), lines.push("")), lines.push("#### Element Details"), lines.push(""), lines.push(this.generateElementDetailsMarkdown(layerNodes)), lines.push(""));
+    }
+    return lines.push("## Architecture Statistics"), lines.push(""), lines.push(this.generateStatisticsTable()), lines.push(""), lines.push("## Relationships Summary"), lines.push(""), lines.push(this.generateRelationshipsSummaryTable()), lines.push(""), lines.join(`
+`);
+  }
+  /**
+   * Generate architecture overview diagram
+   */
+  generateArchitectureOverviewDiagram() {
+    const lines = [];
+    lines.push("```mermaid"), lines.push("graph TD");
+    const layerNodeCounts = /* @__PURE__ */ new Map();
+    for (const node of this.model.graph.nodes.values()) {
+      const count = layerNodeCounts.get(node.layer) || 0;
+      layerNodeCounts.set(node.layer, count + 1);
+    }
+    for (const layer of CANONICAL_LAYER_NAMES) {
+      const count = layerNodeCounts.get(layer) || 0;
+      if (count > 0) {
+        const displayName = `${this.formatLayerName(layer)}<br/>(${count} elements)`;
+        lines.push(`  ${this.sanitizeId(layer)}["${displayName}"]`);
+      }
+    }
+    let lastLayer = null;
+    for (const layer of CANONICAL_LAYER_NAMES)
+      (layerNodeCounts.get(layer) || 0) > 0 && (lastLayer && lines.push(`  ${this.sanitizeId(lastLayer)} --> ${this.sanitizeId(layer)}`), lastLayer = layer);
+    return lines.push("```"), lines.join(`
+`);
+  }
+  /**
+   * Generate diagram for a specific layer
+   */
+  generateLayerDiagram(nodes) {
+    if (nodes.length === 0)
+      return "";
+    const lines = [];
+    switch (lines.push("```mermaid"), this.options.diagramType) {
+      case "flowchart":
+        lines.push(this.generateLayerFlowchart(nodes));
+        break;
+      default:
+        lines.push(this.generateLayerGraph(nodes));
+    }
+    return lines.push("```"), lines.join(`
+`);
+  }
+  /**
+   * Generate layer graph diagram
+   */
+  generateLayerGraph(nodes) {
+    const lines = [];
+    lines.push("graph LR");
+    for (const node of nodes) {
+      const nodeId = this.sanitizeId(node.id), escapedName = this.escapeMarkdownLocal(node.name), escapedType = this.escapeMarkdownLocal(node.type), label = `${escapedName}<br/>(${escapedType})`;
+      lines.push(`  ${nodeId}["${label}"]`);
+    }
+    const edges = this.model.graph.getAllEdges(), nodeIds = new Set(nodes.map((n) => n.id));
+    for (const edge of edges)
+      if (nodeIds.has(edge.source) && nodeIds.has(edge.destination)) {
+        const sourceId = this.sanitizeId(edge.source), destId = this.sanitizeId(edge.destination), label = edge.predicate;
+        lines.push(`  ${sourceId} -->|"${label}"| ${destId}`);
+      }
+    return lines.join(`
+`);
+  }
+  /**
+   * Generate flowchart for a layer
+   */
+  generateLayerFlowchart(nodes) {
+    const lines = [];
+    lines.push("flowchart TD");
+    for (const node of nodes) {
+      const nodeId = this.sanitizeId(node.id), label = `${node.name}`;
+      lines.push(`  ${nodeId}["${this.escapeMarkdownLocal(label)}"]`);
+    }
+    const edges = this.model.graph.getAllEdges(), nodeIds = new Set(nodes.map((n) => n.id));
+    for (const edge of edges)
+      if (nodeIds.has(edge.source) && nodeIds.has(edge.destination)) {
+        const sourceId = this.sanitizeId(edge.source), destId = this.sanitizeId(edge.destination);
+        lines.push(`  ${sourceId} -->|"${edge.predicate}"| ${destId}`);
+      }
+    return lines.join(`
+`);
+  }
+  /**
+   * Generate model metadata table
+   */
+  generateModelMetadataTable() {
+    const rows = [];
+    return rows.push("| Property | Value |"), rows.push("|----------|-------|"), rows.push(`| Name | ${this.escapeMarkdownLocal(this.model.manifest.name)} |`), rows.push(`| Version | ${this.model.manifest.version || "1.0.0"} |`), this.model.manifest.author && rows.push(`| Author | ${this.escapeMarkdownLocal(this.model.manifest.author)} |`), this.model.manifest.created && rows.push(`| Created | ${this.model.manifest.created} |`), this.model.manifest.modified && rows.push(`| Modified | ${this.model.manifest.modified} |`), rows.join(`
+`);
+  }
+  /**
+   * Generate layer summary table
+   */
+  generateLayerSummaryTable() {
+    const rows = [];
+    rows.push("| Layer | Elements | Relationships | Description |"), rows.push("|-------|----------|----------------|-------------|");
+    for (const layer of CANONICAL_LAYER_NAMES) {
+      const nodes = this.model.graph.getNodesByLayer(layer);
+      if (nodes.length === 0)
+        continue;
+      const edges = this.model.graph.getAllEdges(), nodeIds = new Set(nodes.map((n) => n.id)), layerRelationships = edges.filter((e) => nodeIds.has(e.source) && nodeIds.has(e.destination)).length, description = this.getLayerDescriptionText(layer).split(`
+`)[0];
+      rows.push(`| ${this.formatLayerName(layer)} | ${nodes.length} | ${layerRelationships} | ${description} |`);
+    }
+    return rows.join(`
+`);
+  }
+  /**
+   * Generate elements table for a layer
+   */
+  generateLayerElementsTable(nodes) {
+    const rows = [];
+    rows.push("| Element ID | Name | Type | Description |"), rows.push("|-----------|------|------|-------------|");
+    for (const node of nodes.slice(0, this.options.maxTableRows)) {
+      const id = this.escapeMarkdownLocal(node.id), name = this.escapeMarkdownLocal(node.name), type = this.escapeMarkdownLocal(node.type), desc = node.description ? this.escapeMarkdownLocal(node.description.substring(0, 100)) : "";
+      rows.push(`| \`${id}\` | ${name} | ${type} | ${desc} |`);
+    }
+    return nodes.length > this.options.maxTableRows && rows.push(`| ... | ... | ... | ${nodes.length - this.options.maxTableRows} more elements |`), rows.join(`
+`);
+  }
+  /**
+   * Generate element details markdown
+   */
+  generateElementDetailsMarkdown(nodes) {
+    const details = [];
+    for (const node of nodes.slice(0, MAX_DETAIL_ELEMENTS)) {
+      if (details.push(`##### ${this.escapeMarkdownLocal(node.name)} (\`${node.id}\`)`), details.push(""), node.description && (details.push(`${node.description}`), details.push("")), details.push(`**Type:** \`${node.type}\``), details.push(""), node.properties && Object.keys(node.properties).length > 0) {
+        details.push("**Properties:**"), details.push("");
+        const propRows = [];
+        propRows.push("| Property | Value |"), propRows.push("|----------|-------|");
+        for (const [key, value] of Object.entries(node.properties)) {
+          const displayValue = this.valueToString(value);
+          propRows.push(`| \`${key}\` | ${displayValue} |`);
+        }
+        details.push(propRows.join(`
+`)), details.push("");
+      }
+      const outgoing = this.model.graph.getEdgesFrom(node.id);
+      if (outgoing.length > 0) {
+        details.push("**Outgoing Relationships:**"), details.push("");
+        for (const edge of outgoing) {
+          const targetName = this.model.graph.getNode(edge.destination)?.name || edge.destination;
+          details.push(`- **${edge.predicate}**: \`${edge.destination}\` (${targetName})`);
+        }
+        details.push("");
+      }
+      const incoming = this.model.graph.getEdgesTo(node.id);
+      if (incoming.length > 0) {
+        details.push("**Incoming Relationships:**"), details.push("");
+        for (const edge of incoming) {
+          const sourceName = this.model.graph.getNode(edge.source)?.name || edge.source;
+          details.push(`- **${edge.predicate}** from: \`${edge.source}\` (${sourceName})`);
+        }
+        details.push("");
+      }
+    }
+    return nodes.length > MAX_DETAIL_ELEMENTS && (details.push(`*... and ${nodes.length - MAX_DETAIL_ELEMENTS} more elements*`), details.push("")), details.join(`
+`);
+  }
+  /**
+   * Generate statistics table
+   */
+  generateStatisticsTable() {
+    let totalElements = 0, totalEdges = 0;
+    const layerCounts = /* @__PURE__ */ new Map(), typeCounts = /* @__PURE__ */ new Map();
+    for (const node of this.model.graph.nodes.values())
+      totalElements++, layerCounts.set(node.layer, (layerCounts.get(node.layer) || 0) + 1), typeCounts.set(node.type, (typeCounts.get(node.type) || 0) + 1);
+    totalEdges = this.model.graph.getAllEdges().length;
+    const rows = [];
+    return rows.push("| Metric | Value |"), rows.push("|--------|-------|"), rows.push(`| Total Elements | ${totalElements} |`), rows.push(`| Total Relationships | ${totalEdges} |`), rows.push(`| Layers with Content | ${layerCounts.size} |`), rows.push(`| Element Types | ${typeCounts.size} |`), rows.join(`
+`);
+  }
+  /**
+   * Generate relationships summary table
+   */
+  generateRelationshipsSummaryTable() {
+    const predicateCounts = /* @__PURE__ */ new Map(), edges = this.model.graph.getAllEdges();
+    for (const edge of edges)
+      predicateCounts.set(edge.predicate, (predicateCounts.get(edge.predicate) || 0) + 1);
+    const rows = [];
+    rows.push("| Relationship Type | Count |"), rows.push("|-------------------|-------|");
+    const sorted = Array.from(predicateCounts.entries()).sort((a, b) => b[1] - a[1]).slice(0, 20);
+    for (const [predicate, count] of sorted)
+      rows.push(`| \`${predicate}\` | ${count} |`);
+    return predicateCounts.size > 20 && rows.push(`| ... | ${predicateCounts.size - 20} more types |`), rows.join(`
+`);
+  }
+  /**
+   * Get description for a layer
+   */
+  getLayerDescriptionText(layer) {
+    return getLayerDescription(layer);
+  }
+  /**
+   * Format layer name for display
+   */
+  formatLayerName(layer) {
+    return formatLayerName(layer);
+  }
+  /**
+   * Sanitize ID for use in Mermaid diagrams
+   */
+  sanitizeId(id) {
+    return id.replace(/[^a-zA-Z0-9_-]/g, "_").replace(/^[0-9]/, "_$&").substring(0, 100);
+  }
+  /**
+   * Escape markdown special characters
+   */
+  escapeMarkdownLocal(str) {
+    return escapeMarkdown(str);
+  }
+  /**
+   * Convert value to string for display
+   */
+  valueToString(value) {
+    return valueToMarkdown(value);
+  }
+}
+export {
+  MarkdownGenerator
+};
+//# sourceMappingURL=markdown-generator.js.map

package/dist/export/markdown-generator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/markdown-generator.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { GraphNode } from \"../core/graph-model.js\";\nimport { formatLayerName } from \"../utils/layer-name-formatter.js\";\nimport { CANONICAL_LAYER_NAMES } from \"../core/layers.js\";\nimport {\n  escapeMarkdown,\n  valueToMarkdown,\n  getLayerDescription,\n} from \"./markdown-utils.js\";\n\n/**\n * Maximum number of elements to show in element details section\n */\nconst MAX_DETAIL_ELEMENTS = 10;\n\n/**\n * Options for markdown generation\n */\nexport interface MarkdownGeneratorOptions {\n  includeMermaid?: boolean; // Include Mermaid diagrams\n  includeTables?: boolean; // Include formatted tables\n  maxTableRows?: number; // Maximum rows per table before truncating with overflow message\n  diagramType?: \"graph\" | \"flowchart\"; // Type of Mermaid diagram\n}\n\n/**\n * MarkdownGenerator - generates enhanced markdown with Mermaid diagrams and tables\n *\n * Features:\n * - Mermaid diagram generation for architecture layers\n * - Formatted markdown tables with improved styling\n * - Layer-specific visualizations\n * - Cross-layer relationship diagrams\n * - Table row truncation with overflow message (tables capped at maxTableRows)\n */\nexport class MarkdownGenerator {\n  private model: Model;\n  private options: Required<MarkdownGeneratorOptions>;\n\n  constructor(model: Model, options: MarkdownGeneratorOptions = {}) {\n    this.model = model;\n    this.options = {\n      includeMermaid: options.includeMermaid ?? true,\n      includeTables: options.includeTables ?? true,\n      maxTableRows: options.maxTableRows ?? 50,\n      diagramType: options.diagramType ?? \"graph\",\n    };\n  }\n\n  /**\n   * Generate complete markdown documentation with diagrams and tables\n   */\n  async generate(): Promise<string> {\n    const lines: string[] = [];\n\n    // Header\n    lines.push(`# ${this.escapeMarkdownLocal(this.model.manifest.name)}`);\n    lines.push(\"\");\n\n    if (this.model.manifest.description) {\n      lines.push(this.model.manifest.description);\n      lines.push(\"\");\n    }\n\n    // Table of Contents\n    lines.push(\"## Table of Contents\");\n    lines.push(\"\");\n    lines.push(\"- [Architecture Overview](#architecture-overview)\");\n    lines.push(\"- [Layer Summary](#layer-summary)\");\n    lines.push(\"- [Detailed Layer Documentation](#detailed-layer-documentation)\");\n    lines.push(\"\");\n\n    // Architecture Overview Section\n    lines.push(\"## Architecture Overview\");\n    lines.push(\"\");\n\n    if (this.options.includeMermaid) {\n      lines.push(this.generateArchitectureOverviewDiagram());\n      lines.push(\"\");\n    }\n\n    // Model metadata\n    lines.push(\"### Model Information\");\n    lines.push(\"\");\n    lines.push(this.generateModelMetadataTable());\n    lines.push(\"\");\n\n    // Layer Summary\n    lines.push(\"## Layer Summary\");\n    lines.push(\"\");\n    lines.push(this.generateLayerSummaryTable());\n    lines.push(\"\");\n\n    // Detailed Layer Documentation\n    lines.push(\"## Detailed Layer Documentation\");\n    lines.push(\"\");\n\n    const layers = Array.from(this.model.graph.nodes.values())\n      .reduce((acc, node) => {\n        if (!acc.includes(node.layer)) {\n          acc.push(node.layer);\n        }\n        return acc;\n      }, [] as string[])\n      .sort();\n\n    for (const layerName of layers) {\n      const layerNodes = this.model.graph.getNodesByLayer(layerName);\n      if (layerNodes.length === 0) continue;\n\n      lines.push(`### ${this.formatLayerName(layerName)}`);\n      lines.push(\"\");\n\n      lines.push(this.getLayerDescriptionText(layerName));\n      lines.push(\"\");\n\n      // Layer diagram\n      if (this.options.includeMermaid) {\n        lines.push(this.generateLayerDiagram(layerNodes));\n        lines.push(\"\");\n      }\n\n      // Elements table\n      if (this.options.includeTables) {\n        lines.push(this.generateLayerElementsTable(layerNodes));\n        lines.push(\"\");\n      }\n\n      // Element details\n      lines.push(\"#### Element Details\");\n      lines.push(\"\");\n      lines.push(this.generateElementDetailsMarkdown(layerNodes));\n      lines.push(\"\");\n    }\n\n    // Architecture Statistics\n    lines.push(\"## Architecture Statistics\");\n    lines.push(\"\");\n    lines.push(this.generateStatisticsTable());\n    lines.push(\"\");\n\n    // Relationships Summary\n    lines.push(\"## Relationships Summary\");\n    lines.push(\"\");\n    lines.push(this.generateRelationshipsSummaryTable());\n    lines.push(\"\");\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate architecture overview diagram\n   */\n  private generateArchitectureOverviewDiagram(): string {\n    const lines: string[] = [];\n    lines.push(\"```mermaid\");\n    lines.push(\"graph TD\");\n\n    const layerNodeCounts = new Map<string, number>();\n\n    // Count nodes per layer\n    for (const node of this.model.graph.nodes.values()) {\n      const count = layerNodeCounts.get(node.layer) || 0;\n      layerNodeCounts.set(node.layer, count + 1);\n    }\n\n    // Create layer nodes in diagram\n    for (const layer of CANONICAL_LAYER_NAMES) {\n      const count = layerNodeCounts.get(layer) || 0;\n      if (count > 0) {\n        const displayName = `${this.formatLayerName(layer)}<br/>(${count} elements)`;\n        lines.push(`  ${this.sanitizeId(layer)}[\"${displayName}\"]`);\n      }\n    }\n\n    // Add connections between consecutive non-empty layers\n    let lastLayer: string | null = null;\n    for (const layer of CANONICAL_LAYER_NAMES) {\n      if ((layerNodeCounts.get(layer) || 0) > 0) {\n        if (lastLayer) {\n          lines.push(\n            `  ${this.sanitizeId(lastLayer)} --> ${this.sanitizeId(layer)}`\n          );\n        }\n        lastLayer = layer;\n      }\n    }\n\n    lines.push(\"```\");\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate diagram for a specific layer\n   */\n  private generateLayerDiagram(nodes: GraphNode[]): string {\n    if (nodes.length === 0) return \"\";\n\n    const lines: string[] = [];\n    lines.push(\"```mermaid\");\n\n    switch (this.options.diagramType) {\n      case \"flowchart\":\n        lines.push(this.generateLayerFlowchart(nodes));\n        break;\n      default:\n        lines.push(this.generateLayerGraph(nodes));\n    }\n\n    lines.push(\"```\");\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate layer graph diagram\n   */\n  private generateLayerGraph(nodes: GraphNode[]): string {\n    const lines: string[] = [];\n    lines.push(\"graph LR\");\n\n    // Add nodes\n    for (const node of nodes) {\n      const nodeId = this.sanitizeId(node.id);\n      const escapedName = this.escapeMarkdownLocal(node.name);\n      const escapedType = this.escapeMarkdownLocal(node.type);\n      const label = `${escapedName}<br/>(${escapedType})`;\n      lines.push(`  ${nodeId}[\"${label}\"]`);\n    }\n\n    // Add edges between nodes in the same layer\n    const edges = this.model.graph.getAllEdges();\n    const nodeIds = new Set(nodes.map((n) => n.id));\n\n    for (const edge of edges) {\n      if (nodeIds.has(edge.source) && nodeIds.has(edge.destination)) {\n        const sourceId = this.sanitizeId(edge.source);\n        const destId = this.sanitizeId(edge.destination);\n        const label = edge.predicate;\n        lines.push(`  ${sourceId} -->|\"${label}\"| ${destId}`);\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate flowchart for a layer\n   */\n  private generateLayerFlowchart(nodes: GraphNode[]): string {\n    const lines: string[] = [];\n    lines.push(\"flowchart TD\");\n\n    // Add nodes\n    for (const node of nodes) {\n      const nodeId = this.sanitizeId(node.id);\n      const label = `${node.name}`;\n      lines.push(`  ${nodeId}[\"${this.escapeMarkdownLocal(label)}\"]`);\n    }\n\n    // Add edges\n    const edges = this.model.graph.getAllEdges();\n    const nodeIds = new Set(nodes.map((n) => n.id));\n\n    for (const edge of edges) {\n      if (nodeIds.has(edge.source) && nodeIds.has(edge.destination)) {\n        const sourceId = this.sanitizeId(edge.source);\n        const destId = this.sanitizeId(edge.destination);\n        lines.push(`  ${sourceId} -->|\"${edge.predicate}\"| ${destId}`);\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Generate model metadata table\n   */\n  private generateModelMetadataTable(): string {\n    const rows: string[] = [];\n    rows.push(\"| Property | Value |\");\n    rows.push(\"|----------|-------|\");\n\n    rows.push(`| Name | ${this.escapeMarkdownLocal(this.model.manifest.name)} |`);\n    rows.push(`| Version | ${this.model.manifest.version || \"1.0.0\"} |`);\n\n    if (this.model.manifest.author) {\n      rows.push(`| Author | ${this.escapeMarkdownLocal(this.model.manifest.author)} |`);\n    }\n\n    if (this.model.manifest.created) {\n      rows.push(`| Created | ${this.model.manifest.created} |`);\n    }\n\n    if (this.model.manifest.modified) {\n      rows.push(`| Modified | ${this.model.manifest.modified} |`);\n    }\n\n    return rows.join(\"\\n\");\n  }\n\n  /**\n   * Generate layer summary table\n   */\n  private generateLayerSummaryTable(): string {\n    const rows: string[] = [];\n    rows.push(\"| Layer | Elements | Relationships | Description |\");\n    rows.push(\"|-------|----------|----------------|-------------|\");\n\n    for (const layer of CANONICAL_LAYER_NAMES) {\n      const nodes = this.model.graph.getNodesByLayer(layer);\n      if (nodes.length === 0) continue;\n\n      const edges = this.model.graph.getAllEdges();\n      const nodeIds = new Set(nodes.map((n) => n.id));\n      const layerRelationships = edges.filter(\n        (e) => nodeIds.has(e.source) && nodeIds.has(e.destination)\n      ).length;\n\n      const description = this.getLayerDescriptionText(layer).split(\"\\n\")[0];\n\n      rows.push(\n        `| ${this.formatLayerName(layer)} | ${nodes.length} | ${layerRelationships} | ${description} |`\n      );\n    }\n\n    return rows.join(\"\\n\");\n  }\n\n  /**\n   * Generate elements table for a layer\n   */\n  private generateLayerElementsTable(nodes: GraphNode[]): string {\n    const rows: string[] = [];\n    rows.push(\"| Element ID | Name | Type | Description |\");\n    rows.push(\"|-----------|------|------|-------------|\");\n\n    for (const node of nodes.slice(0, this.options.maxTableRows)) {\n      const id = this.escapeMarkdownLocal(node.id);\n      const name = this.escapeMarkdownLocal(node.name);\n      const type = this.escapeMarkdownLocal(node.type);\n      // Truncate description to 100 characters and escape markdown\n      const desc = node.description\n        ? this.escapeMarkdownLocal(node.description.substring(0, 100))\n        : \"\";\n\n      rows.push(`| \\`${id}\\` | ${name} | ${type} | ${desc} |`);\n    }\n\n    if (nodes.length > this.options.maxTableRows) {\n      rows.push(\n        `| ... | ... | ... | ${nodes.length - this.options.maxTableRows} more elements |`\n      );\n    }\n\n    return rows.join(\"\\n\");\n  }\n\n  /**\n   * Generate element details markdown\n   */\n  private generateElementDetailsMarkdown(nodes: GraphNode[]): string {\n    const details: string[] = [];\n\n    for (const node of nodes.slice(0, MAX_DETAIL_ELEMENTS)) {\n      // Limit to first MAX_DETAIL_ELEMENTS for readability\n      details.push(`##### ${this.escapeMarkdownLocal(node.name)} (\\`${node.id}\\`)`);\n      details.push(\"\");\n\n      if (node.description) {\n        details.push(`${node.description}`);\n        details.push(\"\");\n      }\n\n      details.push(`**Type:** \\`${node.type}\\``);\n      details.push(\"\");\n\n      // Properties\n      if (node.properties && Object.keys(node.properties).length > 0) {\n        details.push(\"**Properties:**\");\n        details.push(\"\");\n\n        const propRows: string[] = [];\n        propRows.push(\"| Property | Value |\");\n        propRows.push(\"|----------|-------|\");\n\n        for (const [key, value] of Object.entries(node.properties)) {\n          const displayValue = this.valueToString(value);\n          propRows.push(`| \\`${key}\\` | ${displayValue} |`);\n        }\n\n        details.push(propRows.join(\"\\n\"));\n        details.push(\"\");\n      }\n\n      // Outgoing relationships\n      const outgoing = this.model.graph.getEdgesFrom(node.id);\n      if (outgoing.length > 0) {\n        details.push(\"**Outgoing Relationships:**\");\n        details.push(\"\");\n\n        for (const edge of outgoing) {\n          const targetNode = this.model.graph.getNode(edge.destination);\n          const targetName = targetNode?.name || edge.destination;\n          details.push(\n            `- **${edge.predicate}**: \\`${edge.destination}\\` (${targetName})`\n          );\n        }\n        details.push(\"\");\n      }\n\n      // Incoming relationships\n      const incoming = this.model.graph.getEdgesTo(node.id);\n      if (incoming.length > 0) {\n        details.push(\"**Incoming Relationships:**\");\n        details.push(\"\");\n\n        for (const edge of incoming) {\n          const sourceNode = this.model.graph.getNode(edge.source);\n          const sourceName = sourceNode?.name || edge.source;\n          details.push(\n            `- **${edge.predicate}** from: \\`${edge.source}\\` (${sourceName})`\n          );\n        }\n        details.push(\"\");\n      }\n    }\n\n    if (nodes.length > MAX_DETAIL_ELEMENTS) {\n      details.push(`*... and ${nodes.length - MAX_DETAIL_ELEMENTS} more elements*`);\n      details.push(\"\");\n    }\n\n    return details.join(\"\\n\");\n  }\n\n  /**\n   * Generate statistics table\n   */\n  private generateStatisticsTable(): string {\n    let totalElements = 0;\n    let totalEdges = 0;\n    const layerCounts = new Map<string, number>();\n    const typeCounts = new Map<string, number>();\n\n    // Count statistics\n    for (const node of this.model.graph.nodes.values()) {\n      totalElements++;\n      layerCounts.set(node.layer, (layerCounts.get(node.layer) || 0) + 1);\n      typeCounts.set(node.type, (typeCounts.get(node.type) || 0) + 1);\n    }\n\n    totalEdges = this.model.graph.getAllEdges().length;\n\n    const rows: string[] = [];\n    rows.push(\"| Metric | Value |\");\n    rows.push(\"|--------|-------|\");\n    rows.push(`| Total Elements | ${totalElements} |`);\n    rows.push(`| Total Relationships | ${totalEdges} |`);\n    rows.push(`| Layers with Content | ${layerCounts.size} |`);\n    rows.push(`| Element Types | ${typeCounts.size} |`);\n\n    return rows.join(\"\\n\");\n  }\n\n  /**\n   * Generate relationships summary table\n   */\n  private generateRelationshipsSummaryTable(): string {\n    const predicateCounts = new Map<string, number>();\n    const edges = this.model.graph.getAllEdges();\n\n    for (const edge of edges) {\n      predicateCounts.set(edge.predicate, (predicateCounts.get(edge.predicate) || 0) + 1);\n    }\n\n    const rows: string[] = [];\n    rows.push(\"| Relationship Type | Count |\");\n    rows.push(\"|-------------------|-------|\");\n\n    // Sort by count descending\n    const sorted = Array.from(predicateCounts.entries())\n      .sort((a, b) => b[1] - a[1])\n      .slice(0, 20); // Top 20\n\n    for (const [predicate, count] of sorted) {\n      rows.push(`| \\`${predicate}\\` | ${count} |`);\n    }\n\n    if (predicateCounts.size > 20) {\n      rows.push(`| ... | ${predicateCounts.size - 20} more types |`);\n    }\n\n    return rows.join(\"\\n\");\n  }\n\n  /**\n   * Get description for a layer\n   */\n  private getLayerDescriptionText(layer: string): string {\n    return getLayerDescription(layer);\n  }\n\n  /**\n   * Format layer name for display\n   */\n  private formatLayerName(layer: string): string {\n    return formatLayerName(layer);\n  }\n\n  /**\n   * Sanitize ID for use in Mermaid diagrams\n   */\n  private sanitizeId(id: string): string {\n    return id\n      .replace(/[^a-zA-Z0-9_-]/g, \"_\")\n      .replace(/^[0-9]/, \"_$&\")\n      .substring(0, 100);\n  }\n\n  /**\n   * Escape markdown special characters\n   */\n  private escapeMarkdownLocal(str: string): string {\n    return escapeMarkdown(str);\n  }\n\n  /**\n   * Convert value to string for display\n   */\n  private valueToString(value: unknown): string {\n    return valueToMarkdown(value);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/export/markdown-utils.js

@@ -0,0 +1,30 @@
+const LAYER_DESCRIPTIONS = {
+  motivation: "Goals, requirements, drivers, and strategic outcomes of the architecture.",
+  business: "Business processes, functions, roles, and services.",
+  security: "Authentication, authorization, security threats, and controls.",
+  application: "Application components, services, and interactions.",
+  technology: "Infrastructure, platforms, systems, and technology components.",
+  api: "REST APIs, operations, endpoints, and API integrations.",
+  "data-model": "Data entities, relationships, and data structure definitions.",
+  "data-store": "Databases, data stores, and persistence mechanisms.",
+  ux: "User interface components, screens, and user experience elements.",
+  navigation: "Application routing, navigation flows, and page structures.",
+  apm: "Observability, monitoring, metrics, logging, and tracing.",
+  testing: "Test strategies, test cases, test data, and test coverage."
+};
+function escapeMarkdown(str) {
+  return str.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\*/g, "\\*").replace(/\[/g, "\\[").replace(/\]/g, "\\]").replace(/\{/g, "\\{").replace(/\}/g, "\\}").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function valueToMarkdown(value) {
+  return typeof value == "string" ? escapeMarkdown(value) : typeof value == "number" || typeof value == "boolean" ? String(value) : Array.isArray(value) ? `[${value.map((v) => valueToMarkdown(v)).join(", ")}]` : value && typeof value == "object" ? `\`${JSON.stringify(value)}\`` : String(value);
+}
+function getLayerDescription(layer) {
+  return LAYER_DESCRIPTIONS[layer] || "Architecture layer";
+}
+export {
+  LAYER_DESCRIPTIONS,
+  escapeMarkdown,
+  getLayerDescription,
+  valueToMarkdown
+};
+//# sourceMappingURL=markdown-utils.js.map

package/dist/export/markdown-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/markdown-utils.ts"],
+  "sourcesContent": ["/**\n * Shared markdown utilities for exporters\n */\n\n/**\n * Layer descriptions for documentation\n */\nexport const LAYER_DESCRIPTIONS = {\n  motivation: \"Goals, requirements, drivers, and strategic outcomes of the architecture.\",\n  business: \"Business processes, functions, roles, and services.\",\n  security: \"Authentication, authorization, security threats, and controls.\",\n  application: \"Application components, services, and interactions.\",\n  technology: \"Infrastructure, platforms, systems, and technology components.\",\n  api: \"REST APIs, operations, endpoints, and API integrations.\",\n  \"data-model\": \"Data entities, relationships, and data structure definitions.\",\n  \"data-store\": \"Databases, data stores, and persistence mechanisms.\",\n  ux: \"User interface components, screens, and user experience elements.\",\n  navigation: \"Application routing, navigation flows, and page structures.\",\n  apm: \"Observability, monitoring, metrics, logging, and tracing.\",\n  testing: \"Test strategies, test cases, test data, and test coverage.\",\n} as const;\n\n/**\n * Escape markdown special characters for safe display in markdown documents\n *\n * Escapes the following characters:\n * - `\\` \u2192 `\\\\` (backslash: prevents escape sequences)\n * - `|` \u2192 `\\|` (pipe: prevents table syntax interpretation)\n * - `*` \u2192 `\\*` (asterisk: prevents bold/italic formatting)\n * - `[` \u2192 `\\[` (bracket: prevents link syntax)\n * - `]` \u2192 `\\]` (bracket: prevents link syntax)\n * - `{` \u2192 `\\{` (brace: prevents code interpolation)\n * - `}` \u2192 `\\}` (brace: prevents code interpolation)\n * - `<` \u2192 `&lt;` (less-than: HTML entity for safety)\n * - `>` \u2192 `&gt;` (greater-than: HTML entity for safety)\n *\n * Note: Backticks (`) and underscores (_) are intentionally NOT escaped to allow\n * inline code and emphasis formatting in natural text output.\n */\nexport function escapeMarkdown(str: string): string {\n  return str\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/\\|/g, \"\\\\|\")\n    .replace(/\\*/g, \"\\\\*\")\n    .replace(/\\[/g, \"\\\\[\")\n    .replace(/\\]/g, \"\\\\]\")\n    .replace(/\\{/g, \"\\\\{\")\n    .replace(/\\}/g, \"\\\\}\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\n/**\n * Convert any value to a safely escaped string representation for markdown display\n *\n * Handles different types with type-specific formatting:\n * - **Strings**: Fully escaped via escapeMarkdown() to prevent markdown interpretation\n * - **Numbers**: Rendered as plain numeric strings (no formatting needed)\n * - **Booleans**: Rendered as \"true\" or \"false\" strings\n * - **Arrays**: Rendered as `[item1, item2, ...]` with recursive escaping of elements\n * - **Objects**: Rendered as inline code block with JSON stringification: `{...}`\n * - **Null/Undefined**: Rendered as string representation\n */\nexport function valueToMarkdown(value: unknown): string {\n  if (typeof value === \"string\") return escapeMarkdown(value);\n  if (typeof value === \"number\") return String(value);\n  if (typeof value === \"boolean\") return String(value);\n  if (Array.isArray(value)) {\n    return `[${value.map((v) => valueToMarkdown(v)).join(\", \")}]`;\n  }\n  if (value && typeof value === \"object\") {\n    return `\\`${JSON.stringify(value)}\\``;\n  }\n  return String(value);\n}\n\n/**\n * Get layer description by layer name\n */\nexport function getLayerDescription(layer: string): string {\n  return LAYER_DESCRIPTIONS[layer as keyof typeof LAYER_DESCRIPTIONS] || \"Architecture layer\";\n}\n"],
+  "mappings": "AAOO,MAAM,qBAAqB;EAChC,YAAY;EACZ,UAAU;EACV,UAAU;EACV,aAAa;EACb,YAAY;EACZ,KAAK;EACL,cAAc;EACd,cAAc;EACd,IAAI;EACJ,YAAY;EACZ,KAAK;EACL,SAAS;;AAoBL,SAAU,eAAe,KAAW;AACxC,SAAO,IACJ,QAAQ,OAAO,MAAM,EACrB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM;AACzB;AAaM,SAAU,gBAAgB,OAAc;AAC5C,SAAI,OAAO,SAAU,WAAiB,eAAe,KAAK,IACtD,OAAO,SAAU,YACjB,OAAO,SAAU,YAAkB,OAAO,KAAK,IAC/C,MAAM,QAAQ,KAAK,IACd,IAAI,MAAM,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAExD,SAAS,OAAO,SAAU,WACrB,KAAK,KAAK,UAAU,KAAK,CAAC,OAE5B,OAAO,KAAK;AACrB;AAKM,SAAU,oBAAoB,OAAa;AAC/C,SAAO,mBAAmB,KAAwC,KAAK;AACzE;",
+  "names": []
+}

package/dist/export/mermaid-markdown-exporter.js

@@ -0,0 +1,37 @@
+import { ALL_LAYERS } from "./types.js";
+import { MarkdownGenerator } from "./markdown-generator.js";
+import { isTelemetryEnabled, startSpan, endSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
+class MermaidMarkdownExporter {
+  name = "Mermaid Markdown";
+  supportedLayers = ALL_LAYERS;
+  async export(model, options = {}) {
+    const span = isTelemetryEnabled ? startSpan("export.format.mermaid-markdown", {
+      "export.layerCount": options.layers?.length || this.supportedLayers.length
+    }) : null;
+    try {
+      const generatorOptions = {
+        includeMermaid: !0,
+        includeTables: !0,
+        maxTableRows: 50,
+        diagramType: "graph"
+      }, markdown = await new MarkdownGenerator(model, generatorOptions).generate();
+      if (isTelemetryEnabled && span) {
+        const totalElements = model.graph.nodes.size, totalRelationships = model.graph.getAllEdges().length;
+        span.setAttribute("export.elementCount", totalElements), span.setAttribute("export.relationshipCount", totalRelationships), span.setAttribute("export.size", markdown.length), span.setStatus({ code: 0 });
+      }
+      return markdown;
+    } catch (error) {
+      throw isTelemetryEnabled && span && (span.recordException(error), span.setStatus({
+        code: 2,
+        message: getErrorMessage(error)
+      })), error;
+    } finally {
+      endSpan(span);
+    }
+  }
+}
+export {
+  MermaidMarkdownExporter
+};
+//# sourceMappingURL=mermaid-markdown-exporter.js.map

package/dist/export/mermaid-markdown-exporter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/mermaid-markdown-exporter.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Exporter, ExportOptions } from \"./types.js\";\nimport { ALL_LAYERS } from \"./types.js\";\nimport { MarkdownGenerator, type MarkdownGeneratorOptions } from \"./markdown-generator.js\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * Mermaid Markdown Exporter - generates comprehensive markdown documentation\n * with Mermaid diagrams and formatted tables\n *\n * Supports all 12 layers and includes:\n * - Architecture overview diagrams with Mermaid\n * - Layer-specific visualizations\n * - Formatted markdown tables\n * - Cross-layer relationship diagrams\n * - Element properties and relationship details\n */\nexport class MermaidMarkdownExporter implements Exporter {\n  name = \"Mermaid Markdown\";\n  supportedLayers = ALL_LAYERS;\n\n  async export(model: Model, options: ExportOptions = {}): Promise<string> {\n    const span = isTelemetryEnabled\n      ? startSpan(\"export.format.mermaid-markdown\", {\n          \"export.layerCount\": options.layers?.length || this.supportedLayers.length,\n        })\n      : null;\n\n    try {\n      // Create markdown generator with appropriate options\n      const generatorOptions: MarkdownGeneratorOptions = {\n        includeMermaid: true,\n        includeTables: true,\n        maxTableRows: 50,\n        diagramType: \"graph\",\n      };\n\n      const generator = new MarkdownGenerator(model, generatorOptions);\n      const markdown = await generator.generate();\n\n      if (isTelemetryEnabled && span) {\n        const totalElements = model.graph.nodes.size;\n        const totalRelationships = model.graph.getAllEdges().length;\n\n        (span as any).setAttribute(\"export.elementCount\", totalElements);\n        (span as any).setAttribute(\"export.relationshipCount\", totalRelationships);\n        (span as any).setAttribute(\"export.size\", markdown.length);\n        (span as any).setStatus({ code: 0 });\n      }\n\n      return markdown;\n    } catch (error) {\n      if (isTelemetryEnabled && span) {\n        (span as any).recordException(error as Error);\n        (span as any).setStatus({\n          code: 2,\n          message: getErrorMessage(error),\n        });\n      }\n      throw error;\n    } finally {\n      endSpan(span);\n    }\n  }\n}\n"],
+  "mappings": "AAEA,SAAS,kBAAkB;AAC3B,SAAS,yBAAwD;AACjE,SAAS,oBAAoB,WAAW,eAAe;AACvD,SAAS,uBAAuB;AAa1B,MAAO,wBAAuB;EAClC,OAAO;EACP,kBAAkB;EAElB,MAAM,OAAO,OAAc,UAAyB,CAAA,GAAE;AACpD,UAAM,OAAO,qBACT,UAAU,kCAAkC;MAC1C,qBAAqB,QAAQ,QAAQ,UAAU,KAAK,gBAAgB;KACrE,IACD;AAEJ,QAAI;AAEF,YAAM,mBAA6C;QACjD,gBAAgB;QAChB,eAAe;QACf,cAAc;QACd,aAAa;SAIT,WAAW,MADC,IAAI,kBAAkB,OAAO,gBAAgB,EAC9B,SAAQ;AAEzC,UAAI,sBAAsB,MAAM;AAC9B,cAAM,gBAAgB,MAAM,MAAM,MAAM,MAClC,qBAAqB,MAAM,MAAM,YAAW,EAAG;AAEpD,aAAa,aAAa,uBAAuB,aAAa,GAC9D,KAAa,aAAa,4BAA4B,kBAAkB,GACxE,KAAa,aAAa,eAAe,SAAS,MAAM,GACxD,KAAa,UAAU,EAAE,MAAM,EAAC,CAAE;MACrC;AAEA,aAAO;IACT,SAAS,OAAO;AACd,YAAI,sBAAsB,SACvB,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU;QACtB,MAAM;QACN,SAAS,gBAAgB,KAAK;OAC/B,IAEG;IACR;AACE,cAAQ,IAAI;IACd;EACF;;",
+  "names": []
+}

package/dist/export/openapi-exporter.js

@@ -1,82 +1,130 @@
+import { isTelemetryEnabled, startSpan, endSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
 class OpenAPIExporter {
   name = "OpenAPI";
   supportedLayers = ["api"];
   async export(model, _options = {}) {
-    const layer = await model.getLayer("api");
-    if (!layer)
-      throw new Error("No API layer found in model");
-    const spec = {
-      openapi: "3.0.0",
-      info: {
-        title: model.manifest.name,
-        version: model.manifest.version || "1.0.0"
-      },
-      paths: {},
-      components: {
-        schemas: {},
-        responses: {},
-        parameters: {},
-        requestBodies: {},
-        headers: {},
-        securitySchemes: {}
-      }
-    };
-    model.manifest.description && (spec.info.description = model.manifest.description);
-    const pathGroups = /* @__PURE__ */ new Map();
-    for (const element of layer.listElements())
-      if (element.type === "endpoint") {
-        const path = element.getProperty("path") || "/", method = (element.getProperty("method") || "get").toLowerCase();
-        pathGroups.has(path) || pathGroups.set(path, []), pathGroups.get(path).push({ method, element });
-      }
-    for (const [path, endpoints] of pathGroups) {
-      const pathItem = {};
-      for (const { method, element } of endpoints) {
-        const operation = {
-          summary: element.name,
-          operationId: element.id,
-          responses: element.getProperty("responses") || {
-            200: {
-              description: "Successful response"
-            }
+    const span = isTelemetryEnabled ? startSpan("export.format.openapi") : null;
+    try {
+      const apiLayer = await model.getLayer("api");
+      if (!apiLayer)
+        throw new Error("No API layer found in model");
+      const elements = apiLayer.listElements();
+      if (elements.length === 0)
+        throw new Error("No API layer found in model");
+      const spec = {
+        openapi: "3.0.0",
+        info: {
+          title: model.manifest.name,
+          version: model.manifest.version || "1.0.0"
+        },
+        paths: {},
+        components: {
+          schemas: {},
+          responses: {},
+          parameters: {},
+          requestBodies: {},
+          headers: {},
+          securitySchemes: {}
+        }
+      };
+      model.manifest.description && (spec.info.description = model.manifest.description);
+      const pathGroups = /* @__PURE__ */ new Map();
+      for (const element of elements)
+        if (element.type === "operation" || element.type === "endpoint") {
+          const operationId = element.attributes?.operationId || element.name;
+          let pathKey;
+          const attrPath = element.attributes?.path;
+          if (attrPath)
+            pathKey = attrPath;
+          else {
+            const slugSegment = element.path?.split(".").pop();
+            pathKey = slugSegment ? `/${slugSegment}` : `/${operationId}`;
           }
-        };
-        element.description && (operation.description = element.description);
-        const tags = element.getProperty("tags");
-        tags && (operation.tags = tags);
-        const parameters = element.getProperty("parameters");
-        parameters && (operation.parameters = parameters);
-        const requestBody = element.getProperty("requestBody");
-        requestBody && (operation.requestBody = requestBody);
-        const security = element.getProperty("security");
-        security && (operation.security = security);
-        const deprecated = element.getProperty("deprecated");
-        deprecated && (operation.deprecated = deprecated), pathItem[method] = operation;
-      }
-      spec.paths[path] = pathItem;
-    }
-    for (const element of layer.listElements())
-      if (element.type === "schema") {
-        const schemaName = element.getProperty("schemaName") || element.id, schema = element.getProperty("schema");
-        schema && (spec.components.schemas[schemaName] = schema);
+          const method = (element.attributes?.method || (() => {
+            const opIdLower = operationId.toLowerCase();
+            return /^(create|post|add|insert|register|submit|send)/.test(opIdLower) ? "post" : /^(update|put|edit|modify|replace|set|save)/.test(opIdLower) ? "put" : /^(patch|partial)/.test(opIdLower) ? "patch" : /^(delete|remove|destroy|purge|clear|unregister)/.test(opIdLower) ? "delete" : "get";
+          })()).toLowerCase();
+          pathGroups.has(pathKey) || pathGroups.set(pathKey, []);
+          const endpointData = {
+            name: element.attributes?.summary || element.name,
+            id: element.id,
+            description: element.description,
+            getProperty: (key) => element.attributes?.[key],
+            getSourceReference: () => element.getSourceReference()
+          };
+          pathGroups.get(pathKey).push({ method, element: endpointData });
+        }
+      for (const [path, endpoints] of pathGroups) {
+        const pathItem = {};
+        for (const { method, element } of endpoints) {
+          const operation = {
+            summary: element.name,
+            operationId: element.getProperty("operationId") || element.id,
+            responses: element.getProperty("responses") || {
+              200: {
+                description: "Successful response"
+              }
+            }
+          };
+          element.description && (operation.description = element.description);
+          const tags = element.getProperty("tags");
+          tags && (operation.tags = Array.isArray(tags) ? tags : [tags]);
+          const parameters = element.getProperty("parameters");
+          parameters && (operation.parameters = parameters);
+          const requestBody = element.getProperty("requestBody");
+          requestBody && (operation.requestBody = requestBody);
+          const security = element.getProperty("security");
+          security && (operation.security = security);
+          const deprecated = element.getProperty("deprecated");
+          deprecated && (operation.deprecated = deprecated);
+          const sourceRef = element.getSourceReference();
+          sourceRef && (operation["x-source-reference"] = sourceRef), pathItem[method] = operation;
+        }
+        if (endpoints.length > 0) {
+          const firstSourceRef = endpoints[0].element.getSourceReference();
+          firstSourceRef && (pathItem["x-source-reference"] = firstSourceRef);
+        }
+        spec.paths[path] = pathItem;
       }
-    for (const element of layer.listElements())
-      if (element.type === "security-scheme") {
-        const schemeName = element.name, schemeType = element.getProperty("type");
-        if (schemeType) {
-          const scheme = {
-            type: schemeType
-          }, schemeProp = element.getProperty("scheme");
-          schemeProp && (scheme.scheme = schemeProp);
-          const bearerFormat = element.getProperty("bearerFormat");
-          bearerFormat && (scheme.bearerFormat = bearerFormat);
-          const flows = element.getProperty("flows");
-          flows && (scheme.flows = flows);
-          const openIdConnectUrl = element.getProperty("openIdConnectUrl");
-          openIdConnectUrl && (scheme.openIdConnectUrl = openIdConnectUrl), element.description && (scheme.description = element.description), spec.components.securitySchemes[schemeName] = scheme;
+      for (const element of elements)
+        if (element.type === "schema") {
+          const schemaName = element.attributes?.schemaName || element.id, schema = element.attributes?.schema;
+          schema && (spec.components.schemas[schemaName] = schema);
         }
+      for (const element of elements)
+        if (element.type === "security-scheme") {
+          const schemeName = element.name, schemeType = element.attributes?.type;
+          if (schemeType) {
+            const scheme = {
+              type: schemeType
+            }, schemeProp = element.attributes?.scheme;
+            schemeProp && (scheme.scheme = schemeProp);
+            const bearerFormat = element.attributes?.bearerFormat;
+            bearerFormat && (scheme.bearerFormat = bearerFormat);
+            const flows = element.attributes?.flows;
+            flows && (scheme.flows = flows);
+            const openIdConnectUrl = element.attributes?.openIdConnectUrl;
+            openIdConnectUrl && (scheme.openIdConnectUrl = openIdConnectUrl), element.description && (scheme.description = element.description), spec.components.securitySchemes[schemeName] = scheme;
+          }
+        }
+      const components = spec.components;
+      components.schemas && Object.keys(components.schemas).length === 0 && delete components.schemas, components.responses && Object.keys(components.responses).length === 0 && delete components.responses, components.parameters && Object.keys(components.parameters).length === 0 && delete components.parameters, components.requestBodies && Object.keys(components.requestBodies).length === 0 && delete components.requestBodies, components.headers && Object.keys(components.headers).length === 0 && delete components.headers, components.securitySchemes && Object.keys(components.securitySchemes).length === 0 && delete components.securitySchemes, Object.keys(components).length === 0 && delete spec.components;
+      const result = JSON.stringify(spec, null, 2) + `
+`;
+      if (isTelemetryEnabled && span) {
+        const endpointCount = Array.from(pathGroups.values()).reduce((sum, endpoints) => sum + endpoints.length, 0);
+        span.setAttribute("export.endpointCount", endpointCount), span.setAttribute("export.pathCount", pathGroups.size), span.setAttribute("export.schemaCount", Object.keys(spec.components?.schemas || {}).length), span.setAttribute("export.size", result.length), span.setStatus({ code: 0 });
       }
-    const components = spec.components;
-    return components.schemas && Object.keys(components.schemas).length === 0 && delete components.schemas, components.responses && Object.keys(components.responses).length === 0 && delete components.responses, components.parameters && Object.keys(components.parameters).length === 0 && delete components.parameters, components.requestBodies && Object.keys(components.requestBodies).length === 0 && delete components.requestBodies, components.headers && Object.keys(components.headers).length === 0 && delete components.headers, components.securitySchemes && Object.keys(components.securitySchemes).length === 0 && delete components.securitySchemes, Object.keys(components).length === 0 && delete spec.components, JSON.stringify(spec, null, 2);
+      return result;
+    } catch (error) {
+      throw isTelemetryEnabled && span && (span.recordException(error), span.setStatus({
+        code: 2,
+        message: getErrorMessage(error)
+      })), error;
+    } finally {
+      endSpan(span);
+    }
   }
 }
 export {