spectra-cli 4.1.1

package/dist/panoramic/builders/architecture-ir-mermaid-adapter.js

@@ -0,0 +1,98 @@
+/**
+ * Architecture IR Mermaid interoperability adapter
+ */
+import { getArchitectureIRView, } from '../models/architecture-ir-model.js';
+import { sanitizeMermaidId } from '../utils/mermaid-helpers.js';
+export function buildArchitectureIRMermaidExport(ir) {
+    const sections = [];
+    for (const kind of ['system-context', 'deployment', 'component']) {
+        const view = getArchitectureIRView(ir, kind);
+        if (!view || !view.available || view.elementIds.length === 0) {
+            continue;
+        }
+        const section = buildMermaidSection(ir, view);
+        if (section) {
+            sections.push(section);
+        }
+    }
+    return {
+        sections,
+        combinedDiagram: sections.length > 0
+            ? sections
+                .map((section) => `%% ${section.kind}\n${section.diagram}`)
+                .join('\n\n%% ----\n\n')
+            : undefined,
+    };
+}
+function buildMermaidSection(ir, view) {
+    const elementById = new Map(ir.elements.map((element) => [element.id, element]));
+    const relationshipById = new Map(ir.relationships.map((relationship) => [relationship.id, relationship]));
+    const elements = view.elementIds
+        .map((id) => elementById.get(id))
+        .filter((element) => element !== undefined);
+    const relationships = view.relationshipIds
+        .map((id) => relationshipById.get(id))
+        .filter((relationship) => relationship !== undefined);
+    if (elements.length === 0) {
+        return undefined;
+    }
+    const lines = ['graph TD'];
+    const classMap = new Map();
+    for (const element of elements) {
+        const mermaidId = sanitizeMermaidId(element.id);
+        lines.push(`    ${mermaidId}["${escapeMermaidLabel(buildElementLabel(element))}"]`);
+        const className = toMermaidClassName(element.kind);
+        if (!classMap.has(className)) {
+            classMap.set(className, []);
+        }
+        classMap.get(className).push(mermaidId);
+    }
+    if (relationships.length === 0) {
+        lines.push('    %% no relationships');
+    }
+    else {
+        for (const relationship of relationships) {
+            lines.push(`    ${sanitizeMermaidId(relationship.sourceId)} -->|${escapeMermaidLabel(relationship.kind)}| ${sanitizeMermaidId(relationship.destinationId)}`);
+        }
+    }
+    for (const [className, members] of classMap.entries()) {
+        if (members.length === 0) {
+            continue;
+        }
+        lines.push(`    class ${members.join(',')} ${className}`);
+    }
+    lines.push('    classDef softwareSystem fill:#dbeafe,stroke:#1d4ed8,stroke-width:2px');
+    lines.push('    classDef container fill:#dcfce7,stroke:#15803d,stroke-width:1px');
+    lines.push('    classDef component fill:#fef3c7,stroke:#b45309,stroke-width:1px');
+    lines.push('    classDef deploymentNode fill:#fee2e2,stroke:#b91c1c,stroke-width:1px');
+    lines.push('    classDef infrastructureNode fill:#ede9fe,stroke:#6d28d9,stroke-width:1px');
+    lines.push('    classDef externalSystem fill:#f3f4f6,stroke:#4b5563,stroke-dasharray: 4 2');
+    lines.push('    classDef image fill:#e0f2fe,stroke:#0369a1,stroke-width:1px');
+    return {
+        kind: view.mermaidSection,
+        title: view.title,
+        diagram: lines.join('\n'),
+    };
+}
+function buildElementLabel(element) {
+    const kindLabel = element.kind.replace(/-/g, ' ');
+    return `${element.name}\\n(${kindLabel})`;
+}
+function toMermaidClassName(kind) {
+    switch (kind) {
+        case 'software-system':
+            return 'softwareSystem';
+        case 'deployment-node':
+            return 'deploymentNode';
+        case 'external-system':
+            return 'externalSystem';
+        case 'infrastructure-node':
+            return 'infrastructureNode';
+        default:
+            return kind;
+    }
+}
+function escapeMermaidLabel(value) {
+    return value.replace(/"/g, '\\"');
+}
+//# sourceMappingURL=architecture-ir-mermaid-adapter.js.map

package/dist/panoramic/builders/architecture-ir-mermaid-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-ir-mermaid-adapter.js","sourceRoot":"","sources":["../../../src/panoramic/builders/architecture-ir-mermaid-adapter.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/builders/component-view-builder.d.ts

@@ -0,0 +1,38 @@
+import type { ArchitectureNarrativeOutput } from '../pipelines/architecture-narrative.js';
+import type { ArchitectureIR } from '../models/architecture-ir-model.js';
+import type { EventSurfaceOutput } from '../generators/event-surface-generator.js';
+import type { RuntimeTopologyOutput } from '../generators/runtime-topology-generator.js';
+import type { StoredModuleSpecRecord } from '../stored-module-specs.js';
+import { type ComponentViewOutput } from '../models/component-view-model.js';
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+export interface BuildComponentViewOptions {
+    architectureIR: ArchitectureIR;
+    storedModules: StoredModuleSpecRecord[];
+    architectureNarrative?: ArchitectureNarrativeOutput;
+    runtime?: RuntimeTopologyOutput;
+    eventSurface?: EventSurfaceOutput;
+    maxComponents?: number;
+}
+export declare function buildComponentView(options: BuildComponentViewOptions): ComponentViewOutput;
+export declare function renderComponentView(output: ComponentViewOutput): string;
+/**
+ * ComponentViewBuilderGenerator
+ *
+ * 将 buildComponentView() 适配为 DocumentGenerator 接口，
+ * 供 GeneratorRegistry 统一管理。
+ *
+ * TInput: ArchitectureIR（从 ArchitectureIRGenerator 中提取）
+ * TOutput: ComponentViewOutput
+ */
+export declare class ComponentViewBuilderGenerator implements DocumentGenerator<ArchitectureIR, ComponentViewOutput> {
+    readonly id: "component-view-builder";
+    readonly name: "\u5173\u952E\u7EC4\u4EF6\u89C6\u56FE\u751F\u6210\u5668";
+    readonly description = "\u57FA\u4E8E Architecture IR \u4E0E stored module specs \u751F\u6210\u5173\u952E\u7EC4\u4EF6\u89C6\u56FE\uFF0C\u8F93\u51FA\u7EC4\u4EF6\u5173\u7CFB\u56FE\u4E0E Mermaid \u53EF\u89C6\u5316";
+    private readonly irGenerator;
+    constructor();
+    isApplicable(context: ProjectContext): boolean | Promise<boolean>;
+    extract(context: ProjectContext): Promise<ArchitectureIR>;
+    generate(input: ArchitectureIR, _options?: GenerateOptions): Promise<ComponentViewOutput>;
+    render(output: ComponentViewOutput): string;
+}
+//# sourceMappingURL=component-view-builder.d.ts.map

package/dist/panoramic/builders/component-view-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-view-builder.d.ts","sourceRoot":"","sources":["../../../src/panoramic/builders/component-view-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAA6E,MAAM,oCAAoC,CAAC;AACpJ,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAYL,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAU3F,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,mBAAmB,CAmE1F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAGvE;AA0sBD;;;;;;;;GAQG;AACH,qBAAa,6BACX,YAAW,iBAAiB,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAEjE,QAAQ,CAAC,EAAE,EAAG,wBAAwB,CAAU;IAChD,QAAQ,CAAC,IAAI,EAAG,wDAAW,CAAU;IACrC,QAAQ,CAAC,WAAW,+LAA4E;IAEhG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;;IAMtD,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAOzD,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ/F,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM;CAG5C"}