@documentation-robotics/cli 0.1.0

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/markdown-exporter.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Exporter, ExportOptions } from \"./types.js\";\nimport { ALL_LAYERS } from \"./types.js\";\n\n/**\n * Markdown Exporter - generates comprehensive markdown documentation\n * Supports all 12 layers\n */\nexport class MarkdownExporter implements Exporter {\n  name = \"Markdown\";\n  supportedLayers = ALL_LAYERS;\n\n  private readonly layerDescriptions: Record<string, string> = {\n    motivation:\n      \"Goals, requirements, drivers, and strategic outcomes of the architecture.\",\n    business:\n      \"Business processes, functions, roles, and services.\",\n    security:\n      \"Authentication, authorization, security threats, and controls.\",\n    application:\n      \"Application components, services, and interactions.\",\n    technology:\n      \"Infrastructure, platforms, systems, and technology components.\",\n    api: \"REST APIs, operations, endpoints, and API integrations.\",\n    \"data-model\":\n      \"Data entities, relationships, and data structure definitions.\",\n    \"data-store\":\n      \"Databases, data stores, and persistence mechanisms.\",\n    ux: \"User interface components, screens, and user experience elements.\",\n    navigation:\n      \"Application routing, navigation flows, and page structures.\",\n    apm: \"Observability, monitoring, metrics, logging, and tracing.\",\n    testing:\n      \"Test strategies, test cases, test data, and test coverage.\",\n  };\n\n  async export(model: Model, options: ExportOptions = {}): Promise<string> {\n    const lines: string[] = [];\n\n    // Document header\n    lines.push(`# ${this.escapeMarkdown(model.manifest.name)}`);\n    lines.push(\"\");\n\n    if (model.manifest.description) {\n      lines.push(`${model.manifest.description}`);\n      lines.push(\"\");\n    }\n\n    // Model metadata\n    lines.push(\"## Model Information\");\n    lines.push(\"\");\n    lines.push(\n      `| Property | Value |`\n    );\n    lines.push(`| -------- | ----- |`);\n    lines.push(\n      `| Version | ${model.manifest.version || \"1.0.0\"} |`\n    );\n    if (model.manifest.author) {\n      lines.push(\n        `| Author | ${this.escapeMarkdown(model.manifest.author)} |`\n      );\n    }\n    if (model.manifest.created) {\n      lines.push(\n        `| Created | ${model.manifest.created} |`\n      );\n    }\n    if (model.manifest.modified) {\n      lines.push(\n        `| Modified | ${model.manifest.modified} |`\n      );\n    }\n    lines.push(\"\");\n\n    const layersToExport = options.layers || this.supportedLayers;\n\n    // Generate documentation for each layer\n    for (const layerName of layersToExport) {\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      const elements = Array.from(layer.listElements());\n      if (elements.length === 0) continue;\n\n      lines.push(`## Layer: ${this.formatLayerName(layerName)}`);\n      lines.push(\"\");\n\n      const description = this.layerDescriptions[layerName];\n      if (description) {\n        lines.push(`*${description}*`);\n        lines.push(\"\");\n      }\n\n      lines.push(`### Elements (${elements.length})`);\n      lines.push(\"\");\n\n      // Element table\n      lines.push(\n        `| ID | Name | Type | Description |`\n      );\n      lines.push(\n        `| -- | ---- | ---- | ----------- |`\n      );\n\n      for (const element of elements) {\n        const id = this.escapeMarkdown(element.id);\n        const name = this.escapeMarkdown(element.name);\n        const type = this.escapeMarkdown(element.type);\n        const desc = element.description\n          ? this.escapeMarkdown(element.description).substring(0, 100)\n          : \"\";\n\n        lines.push(`| \\`${id}\\` | ${name} | ${type} | ${desc} |`);\n      }\n\n      lines.push(\"\");\n\n      // Element details\n      lines.push(`### Element Details`);\n      lines.push(\"\");\n\n      for (const element of elements) {\n        lines.push(\n          `#### ${this.escapeMarkdown(element.name)} (\\`${element.id}\\`)`\n        );\n        lines.push(\"\");\n\n        if (element.description) {\n          lines.push(`${element.description}`);\n          lines.push(\"\");\n        }\n\n        lines.push(\"**Type:** \" + element.type);\n        lines.push(\"\");\n\n        // Properties\n        if (Object.keys(element.properties).length > 0) {\n          lines.push(\"**Properties:**\");\n          lines.push(\"\");\n          lines.push(\n            `| Property | Value |`\n          );\n          lines.push(\n            `| -------- | ----- |`\n          );\n\n          for (const [key, value] of Object.entries(element.properties)) {\n            const displayValue = this.valueToMarkdown(value);\n            lines.push(\n              `| \\`${key}\\` | ${displayValue} |`\n            );\n          }\n          lines.push(\"\");\n        }\n\n        // References\n        if (element.references.length > 0) {\n          lines.push(\"**Cross-Layer References:**\");\n          lines.push(\"\");\n\n          for (const ref of element.references) {\n            const refDesc = ref.description\n              ? ` - ${this.escapeMarkdown(ref.description)}`\n              : \"\";\n            lines.push(\n              `- **${ref.type}**: \\`${ref.target}\\`${refDesc}`\n            );\n          }\n          lines.push(\"\");\n        }\n\n        // Relationships\n        if (element.relationships.length > 0) {\n          lines.push(\"**Relationships:**\");\n          lines.push(\"\");\n\n          for (const rel of element.relationships) {\n            lines.push(\n              `- **${rel.predicate}**: \\`${rel.target}\\``\n            );\n          }\n          lines.push(\"\");\n        }\n      }\n\n      // Layer summary\n      lines.push(`### Layer Summary`);\n      lines.push(\"\");\n      lines.push(\n        `- **Total Elements:** ${elements.length}`\n      );\n\n      const refCount = elements.reduce(\n        (sum, e) => sum + e.references.length,\n        0\n      );\n      const relCount = elements.reduce(\n        (sum, e) => sum + e.relationships.length,\n        0\n      );\n\n      lines.push(\n        `- **Cross-Layer References:** ${refCount}`\n      );\n      lines.push(\n        `- **Relationships:** ${relCount}`\n      );\n\n      lines.push(\"\");\n      lines.push(\"---\");\n      lines.push(\"\");\n    }\n\n    // Architecture Summary\n    lines.push(\"## Architecture Summary\");\n    lines.push(\"\");\n\n    let totalElements = 0;\n    let totalReferences = 0;\n    let totalRelationships = 0;\n\n    for (const layerName of layersToExport) {\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      for (const element of layer.listElements()) {\n        totalElements++;\n        totalReferences += element.references.length;\n        totalRelationships += element.relationships.length;\n      }\n    }\n\n    lines.push(\n      `| Metric | Count |`\n    );\n    lines.push(\n      `| ------ | ----- |`\n    );\n    lines.push(\n      `| Total Elements | ${totalElements} |`\n    );\n    lines.push(\n      `| Cross-Layer References | ${totalReferences} |`\n    );\n    lines.push(\n      `| Relationships | ${totalRelationships} |`\n    );\n    lines.push(\"\");\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Escape markdown special characters\n   */\n  private 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  }\n\n  /**\n   * Format layer name for display\n   */\n  private formatLayerName(name: string): string {\n    return name\n      .split(\"-\")\n      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n      .join(\" \");\n  }\n\n  /**\n   * Convert value to markdown representation\n   */\n  private valueToMarkdown(value: unknown): string {\n    if (typeof value === \"string\") return this.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) => this.valueToMarkdown(v)).join(\", \")}]`;\n    }\n    if (value && typeof value === \"object\") {\n      return `\\`${this.escapeMarkdown(JSON.stringify(value))}\\``;\n    }\n    return String(value);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/export/openapi-exporter.js

@@ -0,0 +1,85 @@
+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"
+            }
+          }
+        };
+        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);
+      }
+    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;
+        }
+      }
+    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);
+  }
+}
+export {
+  OpenAPIExporter
+};
+//# sourceMappingURL=openapi-exporter.js.map

package/dist/export/openapi-exporter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/openapi-exporter.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Exporter, ExportOptions } from \"./types.js\";\n\ninterface OpenAPISpec {\n  openapi: string;\n  info: {\n    title: string;\n    version: string;\n    description?: string;\n  };\n  paths: Record<string, unknown>;\n  components: {\n    schemas?: Record<string, unknown>;\n    responses?: Record<string, unknown>;\n    parameters?: Record<string, unknown>;\n    requestBodies?: Record<string, unknown>;\n    headers?: Record<string, unknown>;\n    securitySchemes?: Record<string, unknown>;\n  };\n  servers?: Array<{ url: string; description?: string }>;\n  tags?: Array<{ name: string; description?: string }>;\n  externalDocs?: { url: string; description?: string };\n  security?: unknown[];\n}\n\n/**\n * OpenAPI 3.0 Exporter for layer 6 (API)\n */\nexport class OpenAPIExporter implements Exporter {\n  name = \"OpenAPI\";\n  supportedLayers = [\"api\"];\n\n  async export(model: Model, _options: ExportOptions = {}): Promise<string> {\n    const layer = await model.getLayer(\"api\");\n    if (!layer) {\n      throw new Error(\"No API layer found in model\");\n    }\n\n    // Note: _options is not used for OpenAPI exporter as it only supports the api layer\n    // The parameter is kept for interface consistency with other exporters\n\n    const spec: OpenAPISpec = {\n      openapi: \"3.0.0\",\n      info: {\n        title: model.manifest.name,\n        version: model.manifest.version || \"1.0.0\",\n      },\n      paths: {},\n      components: {\n        schemas: {},\n        responses: {},\n        parameters: {},\n        requestBodies: {},\n        headers: {},\n        securitySchemes: {},\n      },\n    };\n\n    if (model.manifest.description) {\n      spec.info.description = model.manifest.description;\n    }\n\n    // Group endpoints by path\n    const pathGroups = new Map<string, Array<{ method: string; element: any }>>();\n\n    for (const element of layer.listElements()) {\n      if (element.type === \"endpoint\") {\n        const path = element.getProperty<string>(\"path\") || \"/\";\n        const method = (element.getProperty<string>(\"method\") || \"get\").toLowerCase();\n\n        if (!pathGroups.has(path)) {\n          pathGroups.set(path, []);\n        }\n        pathGroups.get(path)!.push({ method, element });\n      }\n    }\n\n    // Build paths section\n    for (const [path, endpoints] of pathGroups) {\n      const pathItem: Record<string, unknown> = {};\n\n      for (const { method, element } of endpoints) {\n        const operation: Record<string, unknown> = {\n          summary: element.name,\n          operationId: element.id,\n          responses: element.getProperty(\"responses\") || {\n            \"200\": {\n              description: \"Successful response\",\n            },\n          },\n        };\n\n        if (element.description) {\n          operation.description = element.description;\n        }\n\n        const tags = element.getProperty(\"tags\");\n        if (tags) {\n          operation.tags = tags;\n        }\n\n        const parameters = element.getProperty(\"parameters\");\n        if (parameters) {\n          operation.parameters = parameters;\n        }\n\n        const requestBody = element.getProperty(\"requestBody\");\n        if (requestBody) {\n          operation.requestBody = requestBody;\n        }\n\n        const security = element.getProperty(\"security\");\n        if (security) {\n          operation.security = security;\n        }\n\n        const deprecated = element.getProperty(\"deprecated\");\n        if (deprecated) {\n          operation.deprecated = deprecated;\n        }\n\n        pathItem[method] = operation;\n      }\n\n      (spec.paths as Record<string, unknown>)[path] = pathItem;\n    }\n\n    // Collect all schema definitions from elements\n    for (const element of layer.listElements()) {\n      if (element.type === \"schema\") {\n        const schemaName = element.getProperty<string>(\"schemaName\") || element.id;\n        const schema = element.getProperty(\"schema\");\n        if (schema) {\n          spec.components.schemas![schemaName] = schema;\n        }\n      }\n    }\n\n    // Collect security schemes if defined\n    for (const element of layer.listElements()) {\n      if (element.type === \"security-scheme\") {\n        const schemeName = element.name;\n        const schemeType = element.getProperty<string>(\"type\");\n        if (schemeType) {\n          const scheme: Record<string, unknown> = {\n            type: schemeType,\n          };\n\n          const schemeProp = element.getProperty(\"scheme\");\n          if (schemeProp) {\n            scheme.scheme = schemeProp;\n          }\n\n          const bearerFormat = element.getProperty(\"bearerFormat\");\n          if (bearerFormat) {\n            scheme.bearerFormat = bearerFormat;\n          }\n\n          const flows = element.getProperty(\"flows\");\n          if (flows) {\n            scheme.flows = flows;\n          }\n\n          const openIdConnectUrl = element.getProperty(\"openIdConnectUrl\");\n          if (openIdConnectUrl) {\n            scheme.openIdConnectUrl = openIdConnectUrl;\n          }\n\n          if (element.description) {\n            scheme.description = element.description;\n          }\n\n          spec.components.securitySchemes![schemeName] = scheme;\n        }\n      }\n    }\n\n    // Add servers if defined in manifest (would be stored separately)\n    // For now, servers would need to be added via layer properties\n    // This could be extended in the future\n\n    // Remove empty component sections\n    const components = spec.components;\n    if (components.schemas && Object.keys(components.schemas).length === 0) {\n      delete components.schemas;\n    }\n    if (components.responses && Object.keys(components.responses).length === 0) {\n      delete components.responses;\n    }\n    if (components.parameters && Object.keys(components.parameters).length === 0) {\n      delete components.parameters;\n    }\n    if (components.requestBodies && Object.keys(components.requestBodies).length === 0) {\n      delete components.requestBodies;\n    }\n    if (components.headers && Object.keys(components.headers).length === 0) {\n      delete components.headers;\n    }\n    if (components.securitySchemes && Object.keys(components.securitySchemes).length === 0) {\n      delete components.securitySchemes;\n    }\n    if (Object.keys(components).length === 0) {\n      delete (spec as Partial<OpenAPISpec>).components;\n    }\n\n    return JSON.stringify(spec, null, 2);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/export/plantuml-exporter.js

@@ -0,0 +1,60 @@
+import { ALL_LAYERS, LAYER_COLORS } from "./types.js";
+class PlantUMLExporter {
+  name = "PlantUML";
+  supportedLayers = ALL_LAYERS;
+  async export(model, options = {}) {
+    const lines = [];
+    lines.push("@startuml"), lines.push(`title "${this.escapeQuotes(model.manifest.name)}"`), lines.push(""), model.manifest.description && (lines.push(`note top : "${this.escapeQuotes(model.manifest.description)}"`), lines.push(""));
+    const layersToExport = options.layers || this.supportedLayers, elementsByLayer = /* @__PURE__ */ new Map();
+    for (const layerName of layersToExport) {
+      const layer = await model.getLayer(layerName);
+      if (!layer)
+        continue;
+      const layerElements = [];
+      for (const element of layer.listElements())
+        layerElements.push({
+          id: element.id,
+          name: element.name,
+          type: element.type
+        });
+      elementsByLayer.set(layerName, layerElements);
+    }
+    for (const layerName of layersToExport) {
+      const elements = elementsByLayer.get(layerName);
+      if (!elements || elements.length === 0)
+        continue;
+      const color = LAYER_COLORS[layerName] || "FFFFFF";
+      lines.push(`package "${layerName}" #${color} {`);
+      for (const { id, name } of elements)
+        lines.push(`  component "${this.escapeQuotes(name)}" as ${id}`);
+      lines.push("}"), lines.push("");
+    }
+    for (const layerName of layersToExport) {
+      const layer = await model.getLayer(layerName);
+      if (layer)
+        for (const element of layer.listElements()) {
+          for (const ref of element.references) {
+            const refType = ref.type || "references";
+            lines.push(`${element.id} --> ${ref.target} : ${this.escapeQuotes(refType)}`);
+          }
+          for (const rel of element.relationships) {
+            const predicate = rel.predicate || "relates-to";
+            lines.push(`${element.id} ..> ${rel.target} : ${this.escapeQuotes(predicate)}`);
+          }
+        }
+    }
+    return lines.push(""), lines.push("@enduml"), lines.join(`
+`) + `
+`;
+  }
+  /**
+   * Escape quotes for PlantUML syntax
+   */
+  escapeQuotes(str) {
+    return str.replace(/"/g, '\\"');
+  }
+}
+export {
+  PlantUMLExporter
+};
+//# sourceMappingURL=plantuml-exporter.js.map

package/dist/export/plantuml-exporter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/plantuml-exporter.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Exporter, ExportOptions } from \"./types.js\";\nimport { ALL_LAYERS, LAYER_COLORS } from \"./types.js\";\n\n/**\n * PlantUML Exporter - generates PlantUML syntax for diagram visualization\n * Supports all 12 layers\n */\nexport class PlantUMLExporter implements Exporter {\n  name = \"PlantUML\";\n  supportedLayers = ALL_LAYERS;\n\n  async export(model: Model, options: ExportOptions = {}): Promise<string> {\n    const lines: string[] = [];\n\n    lines.push(\"@startuml\");\n    lines.push(`title \"${this.escapeQuotes(model.manifest.name)}\"`);\n    lines.push(\"\");\n\n    if (model.manifest.description) {\n      lines.push(`note top : \"${this.escapeQuotes(model.manifest.description)}\"`);\n      lines.push(\"\");\n    }\n\n    const layersToExport = options.layers || this.supportedLayers;\n    const elementsByLayer = new Map<string, Array<{ id: string; name: string; type: string }>>();\n\n    // Collect elements by layer\n    for (const layerName of layersToExport) {\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      const layerElements: Array<{ id: string; name: string; type: string }> = [];\n      for (const element of layer.listElements()) {\n        layerElements.push({\n          id: element.id,\n          name: element.name,\n          type: element.type,\n        });\n      }\n      elementsByLayer.set(layerName, layerElements);\n    }\n\n    // Create packages for each layer\n    for (const layerName of layersToExport) {\n      const elements = elementsByLayer.get(layerName);\n      if (!elements || elements.length === 0) continue;\n\n      const color = LAYER_COLORS[layerName] || \"FFFFFF\";\n      lines.push(`package \"${layerName}\" #${color} {`);\n\n      for (const { id, name } of elements) {\n        lines.push(`  component \"${this.escapeQuotes(name)}\" as ${id}`);\n      }\n\n      lines.push(\"}\");\n      lines.push(\"\");\n    }\n\n    // Add relationships\n    for (const layerName of layersToExport) {\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      for (const element of layer.listElements()) {\n        // Cross-layer references\n        for (const ref of element.references) {\n          const refType = ref.type || \"references\";\n          lines.push(\n            `${element.id} --> ${ref.target} : ${this.escapeQuotes(refType)}`\n          );\n        }\n\n        // Intra-layer relationships\n        for (const rel of element.relationships) {\n          const predicate = rel.predicate || \"relates-to\";\n          lines.push(\n            `${element.id} ..> ${rel.target} : ${this.escapeQuotes(predicate)}`\n          );\n        }\n      }\n    }\n\n    lines.push(\"\");\n    lines.push(\"@enduml\");\n\n    return lines.join(\"\\n\") + \"\\n\";\n  }\n\n  /**\n   * Escape quotes for PlantUML syntax\n   */\n  private escapeQuotes(str: string): string {\n    // Escape double quotes within strings for PlantUML\n    return str.replace(/\"/g, '\\\\\"');\n  }\n}\n"],
+  "mappings": "AAEA,SAAS,YAAY,oBAAoB;AAMnC,MAAO,iBAAgB;EAC3B,OAAO;EACP,kBAAkB;EAElB,MAAM,OAAO,OAAc,UAAyB,CAAA,GAAE;AACpD,UAAM,QAAkB,CAAA;AAExB,UAAM,KAAK,WAAW,GACtB,MAAM,KAAK,UAAU,KAAK,aAAa,MAAM,SAAS,IAAI,CAAC,GAAG,GAC9D,MAAM,KAAK,EAAE,GAET,MAAM,SAAS,gBACjB,MAAM,KAAK,eAAe,KAAK,aAAa,MAAM,SAAS,WAAW,CAAC,GAAG,GAC1E,MAAM,KAAK,EAAE;AAGf,UAAM,iBAAiB,QAAQ,UAAU,KAAK,iBACxC,kBAAkB,oBAAI,IAAG;AAG/B,eAAW,aAAa,gBAAgB;AACtC,YAAM,QAAQ,MAAM,MAAM,SAAS,SAAS;AAC5C,UAAI,CAAC;AAAO;AAEZ,YAAM,gBAAmE,CAAA;AACzE,iBAAW,WAAW,MAAM,aAAY;AACtC,sBAAc,KAAK;UACjB,IAAI,QAAQ;UACZ,MAAM,QAAQ;UACd,MAAM,QAAQ;SACf;AAEH,sBAAgB,IAAI,WAAW,aAAa;IAC9C;AAGA,eAAW,aAAa,gBAAgB;AACtC,YAAM,WAAW,gBAAgB,IAAI,SAAS;AAC9C,UAAI,CAAC,YAAY,SAAS,WAAW;AAAG;AAExC,YAAM,QAAQ,aAAa,SAAS,KAAK;AACzC,YAAM,KAAK,YAAY,SAAS,MAAM,KAAK,IAAI;AAE/C,iBAAW,EAAE,IAAI,KAAI,KAAM;AACzB,cAAM,KAAK,gBAAgB,KAAK,aAAa,IAAI,CAAC,QAAQ,EAAE,EAAE;AAGhE,YAAM,KAAK,GAAG,GACd,MAAM,KAAK,EAAE;IACf;AAGA,eAAW,aAAa,gBAAgB;AACtC,YAAM,QAAQ,MAAM,MAAM,SAAS,SAAS;AAC5C,UAAK;AAEL,mBAAW,WAAW,MAAM,aAAY,GAAI;AAE1C,qBAAW,OAAO,QAAQ,YAAY;AACpC,kBAAM,UAAU,IAAI,QAAQ;AAC5B,kBAAM,KACJ,GAAG,QAAQ,EAAE,QAAQ,IAAI,MAAM,MAAM,KAAK,aAAa,OAAO,CAAC,EAAE;UAErE;AAGA,qBAAW,OAAO,QAAQ,eAAe;AACvC,kBAAM,YAAY,IAAI,aAAa;AACnC,kBAAM,KACJ,GAAG,QAAQ,EAAE,QAAQ,IAAI,MAAM,MAAM,KAAK,aAAa,SAAS,CAAC,EAAE;UAEvE;QACF;IACF;AAEA,iBAAM,KAAK,EAAE,GACb,MAAM,KAAK,SAAS,GAEb,MAAM,KAAK;CAAI,IAAI;;EAC5B;;;;EAKQ,aAAa,KAAW;AAE9B,WAAO,IAAI,QAAQ,MAAM,KAAK;EAChC;;",
+  "names": []
+}

package/dist/export/types.js

@@ -0,0 +1,36 @@
+const LAYER_COLORS = {
+  motivation: "FFE4E1",
+  business: "E6F3FF",
+  security: "FFE6E6",
+  application: "E6FFE6",
+  technology: "FFFFE6",
+  api: "F0E6FF",
+  "data-model": "E6F0FF",
+  "data-store": "FFE6F0",
+  ux: "FFCCCC",
+  navigation: "CCFFCC",
+  apm: "CCFFFF",
+  testing: "FFCCFF"
+}, ALL_LAYERS = [
+  "motivation",
+  "business",
+  "security",
+  "application",
+  "technology",
+  "api",
+  "data-model",
+  "data-store",
+  "ux",
+  "navigation",
+  "apm",
+  "testing"
+];
+function escapeXml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+export {
+  ALL_LAYERS,
+  LAYER_COLORS,
+  escapeXml
+};
+//# sourceMappingURL=types.js.map

package/dist/export/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/export/types.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\n\n/**\n * Options for export operations\n */\nexport interface ExportOptions {\n  layers?: string[];\n  outputPath?: string;\n  format?: string;\n}\n\n/**\n * Interface for format-specific exporters\n */\nexport interface Exporter {\n  /** Display name of the exporter */\n  name: string;\n\n  /** Layers this exporter supports */\n  supportedLayers: string[];\n\n  /**\n   * Export model or subset to the format\n   */\n  export(model: Model, options: ExportOptions): Promise<string>;\n}\n\n/**\n * Metadata about a registered export format\n */\nexport interface ExportFormatInfo {\n  format: string;\n  name: string;\n  description: string;\n  supportedLayers: string[];\n  mimeType: string;\n}\n\n/**\n * Shared layer colors for consistent visualization across exporters\n * Note: Color values do NOT include '#' prefix - exporters add it as needed\n */\nexport const LAYER_COLORS: Record<string, string> = {\n  motivation: \"FFE4E1\",\n  business: \"E6F3FF\",\n  security: \"FFE6E6\",\n  application: \"E6FFE6\",\n  technology: \"FFFFE6\",\n  api: \"F0E6FF\",\n  \"data-model\": \"E6F0FF\",\n  \"data-store\": \"FFE6F0\",\n  ux: \"FFCCCC\",\n  navigation: \"CCFFCC\",\n  apm: \"CCFFFF\",\n  testing: \"FFCCFF\",\n};\n\n/**\n * All 12 supported layers\n */\nexport const ALL_LAYERS: string[] = [\n  \"motivation\",\n  \"business\",\n  \"security\",\n  \"application\",\n  \"technology\",\n  \"api\",\n  \"data-model\",\n  \"data-store\",\n  \"ux\",\n  \"navigation\",\n  \"apm\",\n  \"testing\",\n];\n\n/**\n * Escape XML special characters\n */\nexport function escapeXml(str: string): string {\n  return str\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n}\n"],
+  "mappings": "AA0CO,MAAM,eAAuC;EAClD,YAAY;EACZ,UAAU;EACV,UAAU;EACV,aAAa;EACb,YAAY;EACZ,KAAK;EACL,cAAc;EACd,cAAc;EACd,IAAI;EACJ,YAAY;EACZ,KAAK;EACL,SAAS;GAME,aAAuB;EAClC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;AAMI,SAAU,UAAU,KAAW;AACnC,SAAO,IACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,QAAQ;AAC3B;",
+  "names": []
+}