@cristianormazabal/triton-core 0.1.17 → 0.1.19

package/dist/diagrams/mermaid/architecture/gridPlacer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @file diagrams/architecture/gridPlacer.ts — Directional grid placement for
+ * architecture-beta diagrams.
+ *
+ * Implements BFS-based constraint-propagation as per Mermaid's architectureDb.ts
+ * (packages/mermaid/src/diagrams/architecture/architectureDb.ts:217–275).
+ *
+ * Side annotations on edges are PLACEMENT constraints, not just port hints:
+ *   db:L -- R:server  →  server is one column WEST of db
+ *   disk1:T -- B:svc  →  disk1 is one row SOUTH of svc
+ *
+ * The BFS produces integer (col, row) coordinates (0-indexed, left-to-right,
+ * top-to-bottom). Callers scale to pixels.
+ */
+export interface GridPlacerResult {
+    /** Grid column (0-indexed, left-to-right). */
+    readonly col: number;
+    /** Grid row (0-indexed, top-to-bottom). */
+    readonly row: number;
+}
+/**
+ * Compute integer grid-cell positions from directional edge constraints.
+ *
+ * @param nodes  All services and junctions (any object with an `id`).
+ * @param edges  All edges with `from`, `fromSide`, `to`, `toSide`.
+ * @returns      Map from node ID to {col, row} (0-indexed, non-negative).
+ */
+export declare function directionalGridPlacer(nodes: ReadonlyArray<{
+    readonly id: string;
+}>, edges: ReadonlyArray<{
+    readonly from: string;
+    readonly fromSide: string;
+    readonly to: string;
+    readonly toSide: string;
+}>): Map<string, GridPlacerResult>;
+//# sourceMappingURL=gridPlacer.d.ts.map

package/dist/diagrams/mermaid/architecture/gridPlacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridPlacer.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/architecture/gridPlacer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAwCD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAG,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,KAAK,EAAG,aAAa,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAM,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAQ,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAI,MAAM,CAAC;CAC3B,CAAC,GACD,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAuG/B"}

package/dist/diagrams/mermaid/architecture/gridPlacer.js

@@ -0,0 +1,153 @@
+/**
+ * @file diagrams/architecture/gridPlacer.ts — Directional grid placement for
+ * architecture-beta diagrams.
+ *
+ * Implements BFS-based constraint-propagation as per Mermaid's architectureDb.ts
+ * (packages/mermaid/src/diagrams/architecture/architectureDb.ts:217–275).
+ *
+ * Side annotations on edges are PLACEMENT constraints, not just port hints:
+ *   db:L -- R:server  →  server is one column WEST of db
+ *   disk1:T -- B:svc  →  disk1 is one row SOUTH of svc
+ *
+ * The BFS produces integer (col, row) coordinates (0-indexed, left-to-right,
+ * top-to-bottom). Callers scale to pixels.
+ */
+// ─── Direction-pair delta table ───────────────────────────────────────────────
+//
+// For each direction pair (fromSide + toSide), this gives (Δcol, Δrow) to
+// apply to the CURRENT node's position to get the NEIGHBOR node's position.
+//
+// Derivation:
+//   L side → neighbor is west  (Δcol = -1)
+//   R side → neighbor is east  (Δcol = +1)
+//   T side → neighbor is north (Δrow = -1)  [rows increase downward]
+//   B side → neighbor is south (Δrow = +1)
+//
+// Axis-aligned pairs combine the from-side's offset:
+//   RL: (+1, 0)  — curr's right exits east, neighbor is east
+//   LR: (-1, 0)  — curr's left exits west, neighbor is west
+//   BT: (0, +1)  — curr's bottom exits south, neighbor is south
+//   TB: (0, -1)  — curr's top exits north, neighbor is north
+//
+// Diagonal pairs combine both axes independently:
+//   LT: (-1, -1)  RT: (+1, -1)  LB: (-1, +1)  RB: (+1, +1)
+//   TL: (-1, -1)  TR: (+1, -1)  BL: (-1, +1)  BR: (+1, +1)
+//
+const DELTA = {
+    LR: [-1, 0],
+    RL: [+1, 0],
+    TB: [0, -1],
+    BT: [0, +1],
+    LT: [-1, -1],
+    LB: [-1, +1],
+    RT: [+1, -1],
+    RB: [+1, +1],
+    TL: [-1, -1],
+    TR: [+1, -1],
+    BL: [-1, +1],
+    BR: [+1, +1],
+};
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Compute integer grid-cell positions from directional edge constraints.
+ *
+ * @param nodes  All services and junctions (any object with an `id`).
+ * @param edges  All edges with `from`, `fromSide`, `to`, `toSide`.
+ * @returns      Map from node ID to {col, row} (0-indexed, non-negative).
+ */
+export function directionalGridPlacer(nodes, edges) {
+    if (nodes.length === 0)
+        return new Map();
+    // ── 1. Build bidirectional adjacency list ──────────────────────────────────
+    // adjList[nodeId][dirPair] = neighborId
+    const adjList = new Map();
+    for (const n of nodes)
+        adjList.set(n.id, new Map());
+    for (const e of edges) {
+        const fs = e.fromSide.toUpperCase();
+        const ts = e.toSide.toUpperCase();
+        const fwd = fs + ts;
+        const rev = ts + fs;
+        const fromAdj = adjList.get(e.from);
+        const toAdj = adjList.get(e.to);
+        if (!fromAdj || !toAdj)
+            continue; // unknown node — skip
+        // Contradiction detection: same pair pointing to a DIFFERENT neighbor.
+        if (fromAdj.has(fwd) && fromAdj.get(fwd) !== e.to) {
+            console.warn(`[gridPlacer] Contradictory constraint on "${e.from}" direction ${fwd} — first-wins`);
+        }
+        else {
+            fromAdj.set(fwd, e.to);
+        }
+        if (toAdj.has(rev) && toAdj.get(rev) !== e.from) {
+            console.warn(`[gridPlacer] Contradictory constraint on "${e.to}" direction ${rev} — first-wins`);
+        }
+        else {
+            toAdj.set(rev, e.from);
+        }
+    }
+    // ── 2. BFS ─────────────────────────────────────────────────────────────────
+    const position = new Map();
+    /** Reverse map for collision detection: "col,row" → nodeId */
+    const occupied = new Map();
+    function bfs(seed, seedCol, seedRow) {
+        position.set(seed, { col: seedCol, row: seedRow });
+        occupied.set(`${seedCol},${seedRow}`, seed);
+        const queue = [seed];
+        while (queue.length > 0) {
+            const curr = queue.shift();
+            const currPos = position.get(curr);
+            const adj = adjList.get(curr);
+            if (!adj)
+                continue;
+            for (const [pair, neighbor] of adj) {
+                if (position.has(neighbor))
+                    continue; // already placed (cycle or revisit)
+                const d = DELTA[pair];
+                if (!d)
+                    continue; // unrecognised pair — skip
+                let col = currPos.col + d[0];
+                let row = currPos.row + d[1];
+                // Collision: bump to the next free row in the same column.
+                const key = `${col},${row}`;
+                if (occupied.has(key) && occupied.get(key) !== neighbor) {
+                    console.warn(`[gridPlacer] Cell collision at (${col},${row}), bumping "${neighbor}"`);
+                    let bump = row + 1;
+                    while (occupied.has(`${col},${bump}`))
+                        bump++;
+                    row = bump;
+                }
+                position.set(neighbor, { col, row });
+                occupied.set(`${col},${row}`, neighbor);
+                queue.push(neighbor);
+            }
+        }
+    }
+    // Seed: prefer a node that has at least one edge, for a more centred layout.
+    const connected = new Set([...edges.map(e => e.from), ...edges.map(e => e.to)]);
+    const seed = nodes.find(n => connected.has(n.id)) ?? nodes[0];
+    bfs(seed.id, 0, 0);
+    // ── 3. Handle disconnected components ─────────────────────────────────────
+    for (const n of nodes) {
+        if (!position.has(n.id)) {
+            const maxCol = position.size > 0
+                ? Math.max(...[...position.values()].map(p => p.col)) + 2
+                : 0;
+            bfs(n.id, maxCol, 0);
+        }
+    }
+    // ── 4. Nodes with NO edges at all → fall back: single row ─────────────────
+    if (position.size === 0) {
+        nodes.forEach((n, i) => position.set(n.id, { col: i, row: 0 }));
+    }
+    // ── 5. Normalise to non-negative ───────────────────────────────────────────
+    const vals = [...position.values()];
+    const minCol = Math.min(...vals.map(p => p.col));
+    const minRow = Math.min(...vals.map(p => p.row));
+    const result = new Map();
+    for (const [id, pos] of position) {
+        result.set(id, { col: pos.col - minCol, row: pos.row - minRow });
+    }
+    return result;
+}
+//# sourceMappingURL=gridPlacer.js.map

package/dist/diagrams/mermaid/architecture/gridPlacer.js.map

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

package/dist/diagrams/{triton → mermaid}/architecture/index.d.ts

@@ -1,5 +1,5 @@
 import type { DiagramModule } from '../../../contracts/index.js';
 import type { ArchitectureDocument } from './ir.js';
-export type { ArchitectureDocument, ArchService, ArchGroup, ArchEdge } from './ir.js';
+export type { ArchitectureDocument, ArchService, ArchGroup, ArchJunction, ArchEdge, ArchAlign } from './ir.js';
 export declare const architecture: DiagramModule<ArchitectureDocument>;
 //# sourceMappingURL=index.d.ts.map

package/dist/diagrams/mermaid/architecture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/architecture/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,6BAA6B,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAKpD,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/G,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,oBAAoB,CAY5D,CAAC"}

package/dist/diagrams/{triton → mermaid}/architecture/index.js

@@ -7,8 +7,8 @@ export const architecture = {
     parseYaml(input) {
         return JSON.parse(input);
     },
-    layout(ir, theme) {
-        return layoutArchitecture(ir, theme);
+    layout(ir, theme, options) {
+        return layoutArchitecture(ir, theme, options);
     },
 };
 //# sourceMappingURL=index.js.map

package/dist/diagrams/mermaid/architecture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/architecture/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAItC,MAAM,CAAC,MAAM,YAAY,GAAwC;IAC/D,YAAY,CAAC,KAAa;QACxB,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAyB,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAyB,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,EAAwB,EAAE,KAAoB,EAAE,OAAuB;QAC5E,OAAO,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACF,CAAC"}

package/dist/diagrams/mermaid/architecture/ir.d.ts

@@ -0,0 +1,55 @@
+import type { BaseIR } from '../../../contracts/index.js';
+export interface ArchService {
+    readonly id: string;
+    readonly label: string;
+    readonly icon: string;
+    readonly group?: string;
+}
+export interface ArchGroup {
+    readonly id: string;
+    readonly label: string;
+    readonly icon: string;
+    /** ID of the enclosing group when this group is nested inside another. */
+    readonly parent?: string;
+}
+/** A junction is a 4-way edge split node — no icon or label. */
+export interface ArchJunction {
+    readonly id: string;
+    /** ID of the enclosing group, if any. */
+    readonly group?: string;
+}
+export interface ArchEdge {
+    readonly from: string;
+    readonly fromSide: string;
+    /** True when the `{group}` modifier is present on the from endpoint. */
+    readonly fromGroup: boolean;
+    readonly to: string;
+    readonly toSide: string;
+    /** True when the `{group}` modifier is present on the to endpoint. */
+    readonly toGroup: boolean;
+    /** Arrow points left (towards from): `<--` or `<-->`. */
+    readonly arrowLeft: boolean;
+    /** Arrow points right (towards to): `-->` or `<-->`. */
+    readonly arrowRight: boolean;
+}
+export interface ArchAlign {
+    readonly axis: 'row' | 'column';
+    readonly members: readonly string[];
+}
+export interface ArchitectureDocument extends BaseIR {
+    readonly metadata: {
+        readonly title?: string;
+        readonly theme?: string;
+        readonly [key: string]: string | undefined;
+    };
+    readonly groups: readonly ArchGroup[];
+    readonly services: readonly ArchService[];
+    readonly junctions: readonly ArchJunction[];
+    readonly edges: readonly ArchEdge[];
+    /**
+     * Alignment hints for layout — axis (row/column) + member IDs.
+     * TODO(Brian/Phase B): honour these as layout constraints in layoutArchitecture().
+     */
+    readonly aligns: readonly ArchAlign[];
+}
+//# sourceMappingURL=ir.d.ts.map

package/dist/diagrams/mermaid/architecture/ir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/architecture/ir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACpH,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC"}

package/dist/diagrams/mermaid/architecture/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/architecture/ir.ts"],"names":[],"mappings":""}

package/dist/diagrams/mermaid/architecture/layout.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file diagrams/architecture/layout.ts — Cloud architecture diagram.
+ *
+ * Phase C implementation — replaces Sugiyama layered layout with a
+ * direction-constrained BFS grid placer that honours L/R/T/B side semantics.
+ * All other rendering features from Phase B remain unchanged.
+ *
+ * Features:
+ *   1. Directional grid placement — BFS from directional edge constraints
+ *   2. Junctions      — small 4-way split nodes; edges enter/leave on any side.
+ *   3. Arrowheads     — driven by arrowLeft / arrowRight; axis-aligned markers.
+ *   4. {group} edges  — port sits on the enclosing group boundary, not the service box.
+ *   5. Align          — row/column constraints applied as post-grid position nudges.
+ *   6. Nested groups  — parent groups visually contain child groups.
+ *   7. Iconify icons  — prefix:name tokens resolved through LayoutOptions.icons;
+ *                       unresolvable tokens fall back to the built-in glyph.
+ *
+ * Deviations / limitations (disclosed):
+ *   - Align constraints are applied as a post-BFS median-snap. Edge directions
+ *     take precedence; align is a fixup for disconnected nodes or user overrides.
+ *   - Iconify resolution requires the host to supply LayoutOptions.icons.
+ */
+import type { ArchitectureDocument } from './ir.js';
+import type { LayoutResult, LayoutOptions } from '../../../contracts/index.js';
+import type { ResolvedTheme } from '../../../contracts/index.js';
+export declare function layoutArchitecture(ir: ArchitectureDocument, theme: ResolvedTheme, options?: LayoutOptions): LayoutResult;
+//# sourceMappingURL=layout.d.ts.map

package/dist/diagrams/mermaid/architecture/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/architecture/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAa,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAuB,YAAY,EAAuB,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACzH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAsDjE,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,oBAAoB,EACxB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CA2Pd"}