@transitrix/diagrams 1.8.4 → 1.8.7

package/src/node/__tests__/validate.test.ts

@@ -1,118 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { validateNode } from '../validate.js';
-
-function valid(): Record<string, unknown> {
-  return {
-    notation: 'node',
-    id: 'NODE-KAFKA-HOST-1',
-    name: 'Kafka Cluster Host',
-    type: 'cloud_instance',
-    description: 'AWS EC2 auto-scaling group hosting the Kafka broker cluster.',
-    provider: 'AWS',
-    region: 'eu-central-1',
-    zone: 'canon',
-    admitted_at: '2026-06-28',
-    admitted_by: 'v.korobeinikov',
-    gate_checks: { uniqueness: 'pass', consistency: 'pass', completeness: 'pass' },
-    valid_from: '2024-01-01',
-    valid_to: null,
-  };
-}
-
-const codes = (input: unknown): string[] =>
-  validateNode(input).errors.map(e => e.code);
-
-describe('validateNode — positive', () => {
-  it('accepts a well-formed cloud_instance node with all optional fields', () => {
-    const r = validateNode(valid());
-    expect(r.valid, JSON.stringify(r.errors)).toBe(true);
-  });
-
-  it('accepts a server node with no optional fields', () => {
-    const a = valid();
-    a.id = 'NODE-DB-1';
-    a.name = 'Primary DB Server';
-    a.type = 'server';
-    delete a.description;
-    delete a.provider;
-    delete a.region;
-    expect(validateNode(a).valid).toBe(true);
-  });
-
-  it('accepts all five type values', () => {
-    for (const t of ['server', 'cloud_instance', 'container_platform', 'database_server', 'network_device']) {
-      expect(validateNode({ ...valid(), type: t }).valid).toBe(true);
-    }
-  });
-
-  it('accepts valid_to as a date string', () => {
-    expect(validateNode({ ...valid(), valid_to: '2026-12-31' }).valid).toBe(true);
-  });
-});
-
-describe('validateNode — NOD-001 (shape / id grammar)', () => {
-  it('flags a non-object input', () => {
-    expect(codes(null)).toEqual(['NOD-001']);
-    expect(codes('string')).toEqual(['NOD-001']);
-  });
-
-  it('flags an id that violates the grammar', () => {
-    expect(codes({ ...valid(), id: 'NODE-001' })).toContain('NOD-001');
-    expect(codes({ ...valid(), id: 'NOD-1' })).toContain('NOD-001');
-    expect(codes({ ...valid(), id: 'node-kafka-1' })).toContain('NOD-001');
-  });
-
-  it('flags a wrong notation tag', () => {
-    expect(codes({ ...valid(), notation: 'nodes' })).toContain('NOD-001');
-    expect(codes({ ...valid(), notation: 'infrastructure' })).toContain('NOD-001');
-  });
-
-  it('flags a non-canon zone', () => {
-    expect(codes({ ...valid(), zone: 'sandbox' })).toContain('NOD-001');
-  });
-
-  it('flags a missing zone', () => {
-    const a = valid();
-    delete a.zone;
-    expect(codes(a)).toContain('NOD-001');
-  });
-
-  it('flags a missing name', () => {
-    const a = valid();
-    delete a.name;
-    expect(codes(a)).toContain('NOD-001');
-  });
-
-  it('flags a missing valid_to key', () => {
-    const a = valid();
-    delete a.valid_to;
-    expect(codes(a)).toContain('NOD-001');
-  });
-
-  it('flags missing gate_checks', () => {
-    const a = valid();
-    delete a.gate_checks;
-    expect(codes(a)).toContain('NOD-001');
-  });
-
-  it('flags a missing type', () => {
-    const a = valid();
-    delete a.type;
-    expect(codes(a)).toContain('NOD-001');
-  });
-});
-
-describe('validateNode — NOD-002 (type enum)', () => {
-  it('flags a type outside the allowed enum', () => {
-    expect(codes({ ...valid(), type: 'virtual_machine' })).toContain('NOD-002');
-    expect(codes({ ...valid(), type: 'storage' })).toContain('NOD-002');
-    expect(codes({ ...valid(), type: 'cluster' })).toContain('NOD-002');
-  });
-
-  it('does not flag a missing type with NOD-002 (NOD-001 fires instead)', () => {
-    const a = valid();
-    delete a.type;
-    expect(codes(a)).not.toContain('NOD-002');
-    expect(codes(a)).toContain('NOD-001');
-  });
-});

package/src/process-blueprint/__tests__/compliance-lane.test.ts

@@ -1,320 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { layoutProcessBlueprint } from '../layout.js';
-import type {
-  ComplianceLaneAssertion,
-  ComplianceLaneInput,
-  ComplianceLaneRequirement,
-  ProcessBlueprintFile,
-} from '../types.js';
-
-// ── fixtures ────────────────────────────────────────────────────────────────
-
-const STAGES: ProcessBlueprintFile['process_blueprint']['stages'] = [
-  { id: 'STAGE-1', name: 'Receive', goal: 'g1', result: 'r1' },
-  { id: 'STAGE-2', name: 'Process', goal: 'g2', result: 'r2' },
-  { id: 'STAGE-3', name: 'Ship', goal: 'g3', result: 'r3' },
-];
-
-function buildFile(overrides: Partial<ProcessBlueprintFile['process_blueprint']> = {}): ProcessBlueprintFile {
-  return {
-    notation: 'process-blueprint',
-    process_blueprint: { id: 'PROCESS_BLUEPRINT-T-1', name: 'Test', stages: STAGES, ...overrides },
-  };
-}
-
-const REQ_A: ComplianceLaneRequirement = { id: 'REQ-1', derived_from: ['LAW-GDPR-1'] };
-const REQ_B: ComplianceLaneRequirement = { id: 'REQ-2', derived_from: ['LAW-GDPR-1', 'LAW-SOX-2'] };
-const REQ_DEADLINE: ComplianceLaneRequirement = {
-  id: 'REQ-3',
-  derived_from: ['LAW-PCI-3'],
-  deadline: '2020-01-01', // past_due
-};
-
-// ── helpers ─────────────────────────────────────────────────────────────────
-
-function makeAssertion(
-  about: string,
-  status: ComplianceLaneAssertion['status'],
-  realisedVia: string[],
-): ComplianceLaneAssertion {
-  return { about, status, realised_via: realisedVia };
-}
-
-function layout(
-  file: ProcessBlueprintFile,
-  input: ComplianceLaneInput,
-  overrides: { jurisdictions?: string[]; previousSnapshot?: Record<string, string[]> } = {},
-) {
-  return layoutProcessBlueprint(file, {
-    complianceLane: { enabled: true, ...overrides },
-    complianceInput: input,
-  });
-}
-
-// ── tests ───────────────────────────────────────────────────────────────────
-
-describe('compliance lane derivation', () => {
-  it('returns no complianceRow when lane is disabled (default)', () => {
-    const l = layoutProcessBlueprint(buildFile(), {});
-    expect(l.complianceRow).toBeUndefined();
-  });
-
-  it('returns no complianceRow when enabled but no input provided', () => {
-    const l = layoutProcessBlueprint(buildFile(), { complianceLane: { enabled: true } });
-    expect(l.complianceRow).toBeUndefined();
-  });
-
-  it('returns no complianceRow when assertions have no realised_via matching stage IDs', () => {
-    const input: ComplianceLaneInput = {
-      assertions: [makeAssertion('REQ-1', 'compliant', ['STEP-99'])],
-      requirements: [REQ_A],
-    };
-    const l = layout(buildFile(), input);
-    expect(l.complianceRow).toBeUndefined();
-  });
-
-  it('derives a chip for each law-stage pair', () => {
-    const input: ComplianceLaneInput = {
-      assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-      requirements: [REQ_A],
-    };
-    const l = layout(buildFile(), input);
-    expect(l.complianceRow).toBeDefined();
-    const chips = l.complianceRow!.chips;
-    expect(chips).toHaveLength(1);
-    expect(chips[0].lawId).toBe('LAW-GDPR-1');
-    expect(chips[0].stageIndex).toBe(0);
-  });
-
-  it('produces one chip per law per stage (same law, two stages → two chips)', () => {
-    const input: ComplianceLaneInput = {
-      assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1', 'STAGE-2'])],
-      requirements: [REQ_A],
-    };
-    const l = layout(buildFile(), input);
-    const chips = l.complianceRow!.chips;
-    expect(chips).toHaveLength(2);
-    expect(chips.map(c => c.stageIndex).sort()).toEqual([0, 1]);
-    expect(chips.every(c => c.lawId === 'LAW-GDPR-1')).toBe(true);
-  });
-
-  it('merges multiple assertions for the same law-stage into one chip', () => {
-    const input: ComplianceLaneInput = {
-      assertions: [
-        makeAssertion('REQ-1', 'compliant', ['STAGE-1']),
-        makeAssertion('REQ-1', 'partial', ['STAGE-1']),
-      ],
-      requirements: [REQ_A],
-    };
-    const l = layout(buildFile(), input);
-    expect(l.complianceRow!.chips).toHaveLength(1);
-  });
-
-  describe('decoration: new', () => {
-    it('marks chip as new when law is not in previous snapshot', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input, { previousSnapshot: { 'STAGE-1': [] } });
-      expect(l.complianceRow!.chips[0].decorations).toContain('new');
-    });
-
-    it('does not mark chip as new when law is in previous snapshot', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input, { previousSnapshot: { 'STAGE-1': ['LAW-GDPR-1'] } });
-      expect(l.complianceRow!.chips[0].decorations).not.toContain('new');
-    });
-  });
-
-  describe('decoration: gap', () => {
-    it('marks chip as gap when assertion status is non_compliant', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'non_compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow!.chips[0].decorations).toContain('gap');
-    });
-
-    it('marks chip as gap when assertion status is partial', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'partial', ['STAGE-2'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow!.chips[0].decorations).toContain('gap');
-    });
-
-    it('does not mark chip as gap for compliant assertion', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow!.chips[0].decorations).not.toContain('gap');
-    });
-
-    it('propagates gap if any assertion for the same law-stage is non-compliant', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [
-          makeAssertion('REQ-1', 'compliant', ['STAGE-1']),
-          makeAssertion('REQ-1', 'non_compliant', ['STAGE-1']),
-        ],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow!.chips[0].decorations).toContain('gap');
-    });
-  });
-
-  describe('decoration: deadline', () => {
-    it('marks chip as deadline when gap exists and requirement deadline is past_due', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-3', 'non_compliant', ['STAGE-1'])],
-        requirements: [REQ_DEADLINE],
-      };
-      const l = layout(buildFile(), input);
-      const d = l.complianceRow!.chips[0].decorations;
-      expect(d).toContain('gap');
-      expect(d).toContain('deadline');
-    });
-
-    it('does not mark deadline when gap is absent even if deadline is past_due', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-3', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_DEADLINE],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow!.chips[0].decorations).not.toContain('deadline');
-    });
-
-    it('does not mark deadline when no deadline on requirement', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'non_compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow!.chips[0].decorations).not.toContain('deadline');
-    });
-
-    it('all three decorations can stack on the same chip', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-3', 'non_compliant', ['STAGE-1'])],
-        requirements: [REQ_DEADLINE],
-      };
-      const l = layout(buildFile(), input, { previousSnapshot: { 'STAGE-1': [] } });
-      const d = l.complianceRow!.chips[0].decorations;
-      expect(d).toContain('new');
-      expect(d).toContain('gap');
-      expect(d).toContain('deadline');
-    });
-  });
-
-  describe('jurisdiction filter', () => {
-    it('passes through all laws when no jurisdictions filter', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-2', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_B], // derived_from: [LAW-GDPR-1, LAW-SOX-2]
-        codexJurisdictions: { 'LAW-GDPR-1': 'EU', 'LAW-SOX-2': 'US' },
-      };
-      const l = layout(buildFile(), input, { jurisdictions: [] });
-      expect(l.complianceRow!.chips).toHaveLength(2);
-    });
-
-    it('filters to only the selected jurisdictions', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-2', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_B],
-        codexJurisdictions: { 'LAW-GDPR-1': 'EU', 'LAW-SOX-2': 'US' },
-      };
-      const l = layout(buildFile(), input, { jurisdictions: ['EU'] });
-      expect(l.complianceRow!.chips).toHaveLength(1);
-      expect(l.complianceRow!.chips[0].lawId).toBe('LAW-GDPR-1');
-    });
-
-    it('returns no row when jurisdiction filter excludes all laws', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-2', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_B],
-        codexJurisdictions: { 'LAW-GDPR-1': 'EU', 'LAW-SOX-2': 'US' },
-      };
-      const l = layout(buildFile(), input, { jurisdictions: ['AU'] });
-      expect(l.complianceRow).toBeUndefined();
-    });
-  });
-
-  describe('null-guards', () => {
-    it('tolerates null assertion entries without throwing', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [null as unknown as ComplianceLaneAssertion, makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      expect(() => layout(buildFile(), input)).not.toThrow();
-    });
-
-    it('skips assertions with no realised_via', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [{ about: 'REQ-1', status: 'compliant' }],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow).toBeUndefined();
-    });
-
-    it('skips assertions whose requirement is not in the input', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-MISSING', 'non_compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      expect(l.complianceRow).toBeUndefined();
-    });
-  });
-
-  describe('legend', () => {
-    it('adds a compliance legend entry when the row is present', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      const complianceLegend = l.legend.find(entry => entry.kind === 'compliance');
-      expect(complianceLegend).toBeDefined();
-      expect(complianceLegend!.label).toBe('Compliance');
-    });
-
-    it('does not add compliance legend when row is absent', () => {
-      const l = layoutProcessBlueprint(buildFile(), {});
-      expect(l.legend.some(e => e.kind === 'compliance')).toBe(false);
-    });
-  });
-
-  describe('layout geometry', () => {
-    it('total height grows by the compliance row height', () => {
-      const withoutLane = layoutProcessBlueprint(buildFile(), {});
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-1'])],
-        requirements: [REQ_A],
-      };
-      const withLane = layout(buildFile(), input);
-      expect(withLane.bounds.height).toBeGreaterThan(withoutLane.bounds.height);
-      expect(withLane.bounds.height).toBe(withoutLane.bounds.height + withLane.complianceRow!.height);
-    });
-
-    it('chip x aligns to the stage column', () => {
-      const input: ComplianceLaneInput = {
-        assertions: [makeAssertion('REQ-1', 'compliant', ['STAGE-2'])],
-        requirements: [REQ_A],
-      };
-      const l = layout(buildFile(), input);
-      const chip = l.complianceRow!.chips[0];
-      // Chip x must be at the start of stage-2's column (index 1) + cellPadding.
-      const expectedX = l.legendColumnWidth + 1 * l.stageColumnWidth + 8; // default cellPadding = 8
-      expect(chip.x).toBe(expectedX);
-    });
-  });
-});

package/src/process-blueprint/__tests__/layout.test.ts

@@ -1,240 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { layoutProcessBlueprint } from '../layout.js';
-import type { ProcessBlueprintFile } from '../types.js';
-
-function build(file: Partial<ProcessBlueprintFile['process_blueprint']>): ProcessBlueprintFile {
-  return {
-    notation: 'process-blueprint',
-    process_blueprint: {
-      id: 'PROCESS_BLUEPRINT-T-1',
-      name: 'Test',
-      stages: [],
-      ...file,
-    } as ProcessBlueprintFile['process_blueprint'],
-  };
-}
-
-describe('layoutProcessBlueprint', () => {
-  it('lays out stage headers in input order across the legend offset', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' },
-          { id: 'STAGE-2', name: 'B', goal: 'g', result: 'r' },
-          { id: 'STAGE-3', name: 'C', goal: 'g', result: 'r' },
-        ],
-      }),
-    );
-    expect(layout.stageHeaders).toHaveLength(3);
-    expect(layout.stageHeaders[0].x).toBe(layout.legendColumnWidth);
-    expect(layout.stageHeaders[1].x).toBe(layout.legendColumnWidth + layout.stageColumnWidth);
-    expect(layout.stageHeaders[2].x).toBe(layout.legendColumnWidth + 2 * layout.stageColumnWidth);
-    expect(layout.stageHeaders[0].name).toBe('A');
-  });
-
-  it('produces goal and result cells aligned under each stage column', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'gA', result: 'rA' },
-          { id: 'STAGE-2', name: 'B', goal: 'gB', result: 'rB' },
-        ],
-      }),
-    );
-    expect(layout.goalCells.map(c => c.text)).toEqual(['gA', 'gB']);
-    expect(layout.resultCells.map(c => c.text)).toEqual(['rA', 'rB']);
-    expect(layout.goalCells[0].y).toBeLessThan(layout.resultCells[0].y);
-    expect(layout.goalCells[0].x).toBe(layout.stageHeaders[0].x);
-  });
-
-  it('omits aspect rows for categories without any entries', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [{ id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' }],
-      }),
-    );
-    expect(layout.aspectRows).toHaveLength(0);
-  });
-
-  it('merges consecutive stages into a single spanning pill', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' },
-          { id: 'STAGE-2', name: 'B', goal: 'g', result: 'r' },
-          { id: 'STAGE-3', name: 'C', goal: 'g', result: 'r' },
-        ],
-        systems: [
-          { id: 'APPLICATION-OMS-1', name: 'OMS', stages: ['STAGE-1', 'STAGE-2', 'STAGE-3'] },
-        ],
-      }),
-    );
-    expect(layout.aspectRows).toHaveLength(1);
-    const row = layout.aspectRows[0];
-    expect(row.category).toBe('systems');
-    expect(row.pills).toHaveLength(1);
-    expect(row.pills[0].startStageIndex).toBe(0);
-    expect(row.pills[0].endStageIndex).toBe(2);
-    expect(row.pills[0].width).toBeGreaterThan(layout.stageColumnWidth);
-  });
-
-  it('splits non-consecutive stages into separate pills', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' },
-          { id: 'STAGE-2', name: 'B', goal: 'g', result: 'r' },
-          { id: 'STAGE-3', name: 'C', goal: 'g', result: 'r' },
-          { id: 'STAGE-4', name: 'D', goal: 'g', result: 'r' },
-        ],
-        systems: [
-          { id: 'APPLICATION-X-1', name: 'X', stages: ['STAGE-1', 'STAGE-3', 'STAGE-4'] },
-        ],
-      }),
-    );
-    const pills = layout.aspectRows[0].pills;
-    expect(pills).toHaveLength(2);
-    expect(pills[0].startStageIndex).toBe(0);
-    expect(pills[0].endStageIndex).toBe(0);
-    expect(pills[1].startStageIndex).toBe(2);
-    expect(pills[1].endStageIndex).toBe(3);
-  });
-
-  it('stacks overlapping pills into vertical slots inside the same row', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' },
-          { id: 'STAGE-2', name: 'B', goal: 'g', result: 'r' },
-        ],
-        systems: [
-          { id: 'APPLICATION-A-1', name: 'A', stages: ['STAGE-1', 'STAGE-2'] },
-          { id: 'APPLICATION-B-1', name: 'B', stages: ['STAGE-1'] },
-        ],
-      }),
-    );
-    const row = layout.aspectRows[0];
-    expect(row.pills).toHaveLength(2);
-    // The two pills overlap at STAGE-1, so they should sit at different y.
-    expect(row.pills[0].y).not.toBe(row.pills[1].y);
-    // Row height must be tall enough for two stacked pills.
-    expect(row.height).toBeGreaterThan(row.pills[0].height);
-  });
-
-  it('preserves the fixed category order: systems, actors, equipment, information_entities', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [{ id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' }],
-        information_entities: [{ name: 'Doc', stages: ['STAGE-1'] }],
-        actors: [{ id: 'ROLE-X-1', name: 'X', stages: ['STAGE-1'] }],
-        systems: [{ id: 'APPLICATION-X-1', name: 'X', stages: ['STAGE-1'] }],
-        equipment: [{ name: 'Scanner', stages: ['STAGE-1'] }],
-      }),
-    );
-    expect(layout.aspectRows.map(r => r.category)).toEqual([
-      'systems',
-      'actors',
-      'equipment',
-      'information_entities',
-    ]);
-  });
-
-  it('builds the legend in row order: goal, result, then aspect categories', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [{ id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' }],
-        systems: [{ id: 'APPLICATION-X-1', name: 'X', stages: ['STAGE-1'] }],
-      }),
-    );
-    expect(layout.legend.map(l => l.kind)).toEqual(['goal', 'result', 'aspect']);
-    expect(layout.legend[2].category).toBe('systems');
-  });
-
-  it('total bounds cover the legend column plus every stage column', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' },
-          { id: 'STAGE-2', name: 'B', goal: 'g', result: 'r' },
-        ],
-      }),
-    );
-    expect(layout.bounds.width).toBe(layout.legendColumnWidth + 2 * layout.stageColumnWidth);
-    expect(layout.bounds.height).toBeGreaterThan(0);
-  });
-
-  it('ignores aspect entries that reference undeclared stages', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [{ id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' }],
-        systems: [
-          { id: 'APPLICATION-X-1', name: 'X', stages: ['STAGE-1', 'STAGE-999'] },
-        ],
-      }),
-    );
-    const pills = layout.aspectRows[0].pills;
-    expect(pills).toHaveLength(1);
-    expect(pills[0].startStageIndex).toBe(0);
-    expect(pills[0].endStageIndex).toBe(0);
-  });
-
-  it('honours overridden LayoutOptions', () => {
-    const layout = layoutProcessBlueprint(
-      build({
-        stages: [
-          { id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' },
-          { id: 'STAGE-2', name: 'B', goal: 'g', result: 'r' },
-        ],
-      }),
-      { legendColumnWidth: 200, stageColumnWidth: 300 },
-    );
-    expect(layout.legendColumnWidth).toBe(200);
-    expect(layout.stageColumnWidth).toBe(300);
-    expect(layout.stageHeaders[1].x).toBe(200 + 300);
-  });
-
-  describe('visibleAspects', () => {
-    const FILE_WITH_ALL = build({
-      stages: [{ id: 'STAGE-1', name: 'A', goal: 'g', result: 'r' }],
-      systems: [{ name: 'OMS', stages: ['STAGE-1'] }],
-      actors: [{ name: 'Ops', stages: ['STAGE-1'] }],
-      equipment: [{ name: 'Printer', stages: ['STAGE-1'] }],
-    });
-
-    it('shows all categories when visibleAspects is not set', () => {
-      const layout = layoutProcessBlueprint(FILE_WITH_ALL);
-      expect(layout.aspectRows.map(r => r.category)).toEqual(
-        expect.arrayContaining(['systems', 'actors', 'equipment']),
-      );
-      expect(layout.aspectRows).toHaveLength(3);
-    });
-
-    it('limits rows to those in visibleAspects', () => {
-      const layout = layoutProcessBlueprint(FILE_WITH_ALL, {
-        visibleAspects: ['systems'],
-      });
-      expect(layout.aspectRows).toHaveLength(1);
-      expect(layout.aspectRows[0].category).toBe('systems');
-    });
-
-    it('suppresses all aspect rows when visibleAspects is empty', () => {
-      const layout = layoutProcessBlueprint(FILE_WITH_ALL, { visibleAspects: [] });
-      expect(layout.aspectRows).toHaveLength(0);
-    });
-
-    it('preserves the canonical ASPECT_CATEGORIES order within the filtered set', () => {
-      const layout = layoutProcessBlueprint(FILE_WITH_ALL, {
-        visibleAspects: ['equipment', 'systems'],
-      });
-      expect(layout.aspectRows.map(r => r.category)).toEqual(['systems', 'equipment']);
-    });
-
-    it('ignores categories in visibleAspects that have no data', () => {
-      const layout = layoutProcessBlueprint(FILE_WITH_ALL, {
-        visibleAspects: ['systems', 'information_entities'],
-      });
-      expect(layout.aspectRows).toHaveLength(1);
-      expect(layout.aspectRows[0].category).toBe('systems');
-    });
-  });
-});