@likec4/diagram 1.44.0 → 1.45.0

package/dist/overlays/relationship-details/actor.d.ts

@@ -1,6 +1,6 @@
 import { BBox, EdgeId, ExclusiveUnion, Fqn, ViewId } from '@likec4/core';
 import { EdgeChange, NodeChange, ReactFlowInstance, ReactFlowState } from '@xyflow/react';
-import { ActorRefFromLogic, SnapshotFrom, StateMachine, Values, NonReducibleUnknown, EventObject, MetaObject, AnyActorLogic, ConditionalRequired, InputFrom, RequiredLogicInput, IsNotNever, ActorRef, MachineSnapshot, AnyActorRef, StateValue, AnyEventObject, ActionFunction, CancelAction } from 'xstate';
+import { ActorRef, SnapshotFrom, StateMachine } from 'xstate';
 import { RelationshipDetailsTypes } from './_types';
 import { LayoutResult } from './layout';
 type XYFLowInstance = ReactFlowInstance<RelationshipDetailsTypes.AnyNode, RelationshipDetailsTypes.Edge>;
@@ -99,567 +99,11 @@ export type Events = {
 } | {
     type: 'close';
 };
-declare const _relationshipDetailsLogic: StateMachine<Readonly<{
-    subject: Subject;
-    viewId: ViewId;
-    xyflow: XYFLowInstance | null;
-    xystore: XYStoreApi | null;
-    initialized: {
-        xydata: boolean;
-        xyflow: boolean;
-    };
-    xynodes: RelationshipDetailsTypes.Node[];
-    xyedges: RelationshipDetailsTypes.Edge[];
-    bounds: BBox;
-}>, Events, {}, never, Values<{
-    "xyflow:fitDiagram": {
-        type: "xyflow:fitDiagram";
-        params: {
-            duration?: number;
-            bounds?: BBox;
-        } | undefined;
-    };
-    "xyflow:updateNodeInternals": {
-        type: "xyflow:updateNodeInternals";
-        params: unknown;
-    };
-    updateXYFlow: {
-        type: "updateXYFlow";
-        params: NonReducibleUnknown;
-    };
-    updateLayoutData: {
-        type: "updateLayoutData";
-        params: NonReducibleUnknown;
-    };
-    "open relationship source": {
-        type: "open relationship source";
-        params: NonReducibleUnknown;
-    };
-}>, Values<{
-    isReady: {
-        type: "isReady";
-        params: unknown;
-    };
-    "enable: navigate.to": {
-        type: "enable: navigate.to";
-        params: unknown;
-    };
-}>, never, "ready" | "closed" | "isReady" | "initializing", string, {
-    target?: never;
-    source?: never;
-    edgeId: EdgeId;
-    viewId: ViewId;
-} | {
-    edgeId?: never;
-    source: Fqn;
-    target: Fqn;
-    viewId: ViewId;
-}, NonReducibleUnknown, EventObject, MetaObject, {
-    readonly initial: "initializing";
-    readonly context: ({ input }: {
-        spawn: {
-            <TSrc extends never>(logic: TSrc, ...[options]: never): ActorRefFromLogic<never>;
-            <TLogic extends AnyActorLogic>(src: TLogic, ...[options]: ConditionalRequired<[options?: {
-                id?: never;
-                systemId?: string;
-                input?: InputFrom<TLogic>;
-                syncSnapshot?: boolean;
-            } & { [K in RequiredLogicInput<TLogic>]: unknown; }], IsNotNever<RequiredLogicInput<TLogic>>>): ActorRefFromLogic<TLogic>;
-        };
-        input: {
-            target?: never;
-            source?: never;
-            edgeId: EdgeId;
-            viewId: ViewId;
-        } | {
-            edgeId?: never;
-            source: Fqn;
-            target: Fqn;
-            viewId: ViewId;
-        };
-        self: ActorRef<MachineSnapshot<Readonly<{
-            subject: Subject;
-            viewId: ViewId;
-            xyflow: XYFLowInstance | null;
-            xystore: XYStoreApi | null;
-            initialized: {
-                xydata: boolean;
-                xyflow: boolean;
-            };
-            xynodes: RelationshipDetailsTypes.Node[];
-            xyedges: RelationshipDetailsTypes.Edge[];
-            bounds: BBox;
-        }>, Events, Record<string, AnyActorRef | undefined>, StateValue, string, unknown, any, any>, Events, AnyEventObject>;
-    }) => {
-        subject: Subject;
-        viewId: ViewId;
-        bounds: {
-            x: number;
-            y: number;
-            width: number;
-            height: number;
-        };
-        initialized: {
-            xydata: false;
-            xyflow: false;
-        };
-        xyflow: null;
-        xystore: null;
-        xynodes: never[];
-        xyedges: never[];
-    };
-    readonly states: {
-        readonly initializing: {
-            readonly on: {
-                readonly 'xyflow.init': {
-                    readonly actions: "updateXYFlow";
-                    readonly target: "isReady";
-                };
-                readonly 'update.layoutData': {
-                    readonly actions: "updateLayoutData";
-                    readonly target: "isReady";
-                };
-                readonly close: {
-                    readonly target: "closed";
-                };
-            };
-        };
-        readonly isReady: {
-            readonly always: readonly [{
-                readonly guard: "isReady";
-                readonly actions: readonly [{
-                    readonly type: "xyflow:fitDiagram";
-                    readonly params: {
-                        readonly duration: 0;
-                    };
-                }, ActionFunction<Readonly<{
-                    subject: Subject;
-                    viewId: ViewId;
-                    xyflow: XYFLowInstance | null;
-                    xystore: XYStoreApi | null;
-                    initialized: {
-                        xydata: boolean;
-                        xyflow: boolean;
-                    };
-                    xynodes: RelationshipDetailsTypes.Node[];
-                    xyedges: RelationshipDetailsTypes.Edge[];
-                    bounds: BBox;
-                }>, Events, Events, undefined, never, never, never, never, never>];
-                readonly target: "ready";
-            }, {
-                readonly target: "initializing";
-            }];
-        };
-        readonly ready: {
-            readonly on: {
-                readonly 'xyflow.edgeMouseEnter': {
-                    readonly actions: readonly [ ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseEnter";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, Events, undefined, never, never, never, never, never>, CancelAction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseEnter";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, undefined, Events>, CancelAction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseEnter";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, undefined, Events>, ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseEnter";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, Events, undefined, never, never, never, never, never>];
-                };
-                readonly 'xyflow.edgeMouseLeave': {
-                    readonly actions: readonly [ ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseLeave";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, Events, undefined, never, never, never, never, never>, CancelAction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseLeave";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, undefined, Events>, ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.edgeMouseLeave";
-                        edge: RelationshipDetailsTypes.Edge;
-                    }, Events, undefined, never, never, never, never, never>];
-                };
-                readonly 'dim.nonhovered.edges': {
-                    readonly actions: ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "dim.nonhovered.edges";
-                    }, Events, undefined, never, never, never, never, never>;
-                };
-                readonly 'undim.edges': {
-                    readonly actions: ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "undim.edges";
-                    }, Events, undefined, never, never, never, never, never>;
-                };
-                readonly 'xyflow.selectionChange': {
-                    readonly actions: ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.selectionChange";
-                        nodes: RelationshipDetailsTypes.Node[];
-                        edges: RelationshipDetailsTypes.Edge[];
-                    }, Events, undefined, never, Values<{
-                        "xyflow:fitDiagram": {
-                            type: "xyflow:fitDiagram";
-                            params: {
-                                duration?: number;
-                                bounds?: BBox;
-                            } | undefined;
-                        };
-                        "xyflow:updateNodeInternals": {
-                            type: "xyflow:updateNodeInternals";
-                            params: unknown;
-                        };
-                        updateXYFlow: {
-                            type: "updateXYFlow";
-                            params: NonReducibleUnknown;
-                        };
-                        updateLayoutData: {
-                            type: "updateLayoutData";
-                            params: NonReducibleUnknown;
-                        };
-                        "open relationship source": {
-                            type: "open relationship source";
-                            params: NonReducibleUnknown;
-                        };
-                    }>, Values<{
-                        isReady: {
-                            type: "isReady";
-                            params: unknown;
-                        };
-                        "enable: navigate.to": {
-                            type: "enable: navigate.to";
-                            params: unknown;
-                        };
-                    }>, never, EventObject>;
-                };
-                readonly 'update.layoutData': {
-                    readonly actions: readonly ["updateLayoutData", CancelAction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "update.layoutData";
-                        data: LayoutResult;
-                    }, undefined, Events>, ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "update.layoutData";
-                        data: LayoutResult;
-                    }, Events, undefined, never, never, never, never, never>, ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "update.layoutData";
-                        data: LayoutResult;
-                    }, Events, undefined, never, never, never, never, never>];
-                };
-                readonly 'xyflow.init': {
-                    readonly actions: "updateXYFlow";
-                };
-                readonly 'xyflow.applyNodeChanges': {
-                    readonly actions: ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.applyNodeChanges";
-                        changes: NodeChange<RelationshipDetailsTypes.Node>[];
-                    }, Events, undefined, never, never, never, never, never>;
-                };
-                readonly 'xyflow.applyEdgeChanges': {
-                    readonly actions: ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "xyflow.applyEdgeChanges";
-                        changes: EdgeChange<RelationshipDetailsTypes.Edge>[];
-                    }, Events, undefined, never, never, never, never, never>;
-                };
-                readonly 'xyflow.paneDblClick': {
-                    readonly actions: "xyflow:fitDiagram";
-                };
-                readonly 'xyflow.edgeClick': {
-                    readonly actions: "open relationship source";
-                };
-                readonly 'navigate.to': {
-                    readonly actions: ActionFunction<Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>, {
-                        type: "navigate.to";
-                        params: {
-                            edgeId: EdgeId;
-                            viewId?: ViewId;
-                        } | {
-                            source: Fqn;
-                            target: Fqn;
-                            viewId?: ViewId;
-                        };
-                    }, Events, undefined, never, never, never, never, never>;
-                };
-                readonly close: {
-                    readonly target: "closed";
-                };
-            };
-            readonly exit: ActionFunction<Readonly<{
-                subject: Subject;
-                viewId: ViewId;
-                xyflow: XYFLowInstance | null;
-                xystore: XYStoreApi | null;
-                initialized: {
-                    xydata: boolean;
-                    xyflow: boolean;
-                };
-                xynodes: RelationshipDetailsTypes.Node[];
-                xyedges: RelationshipDetailsTypes.Edge[];
-                bounds: BBox;
-            }>, Events, Events, undefined, never, never, never, never, never>;
-        };
-        readonly closed: {
-            readonly type: "final";
-        };
-    };
-    readonly on: {
-        readonly fitDiagram: {
-            readonly actions: {
-                readonly type: "xyflow:fitDiagram";
-                readonly params: (data: {
-                    context: Readonly<{
-                        subject: Subject;
-                        viewId: ViewId;
-                        xyflow: XYFLowInstance | null;
-                        xystore: XYStoreApi | null;
-                        initialized: {
-                            xydata: boolean;
-                            xyflow: boolean;
-                        };
-                        xynodes: RelationshipDetailsTypes.Node[];
-                        xyedges: RelationshipDetailsTypes.Edge[];
-                        bounds: BBox;
-                    }>;
-                    event: {
-                        type: "fitDiagram";
-                        duration?: number;
-                        bounds?: BBox;
-                    };
-                }) => {
-                    type: "fitDiagram";
-                    duration?: number;
-                    bounds?: BBox;
-                };
-            };
-        };
-        readonly 'xyflow.resized': {
-            readonly actions: readonly [ CancelAction<Readonly<{
-                subject: Subject;
-                viewId: ViewId;
-                xyflow: XYFLowInstance | null;
-                xystore: XYStoreApi | null;
-                initialized: {
-                    xydata: boolean;
-                    xyflow: boolean;
-                };
-                xynodes: RelationshipDetailsTypes.Node[];
-                xyedges: RelationshipDetailsTypes.Edge[];
-                bounds: BBox;
-            }>, {
-                type: "xyflow.resized";
-            }, undefined, Events>, ActionFunction<Readonly<{
-                subject: Subject;
-                viewId: ViewId;
-                xyflow: XYFLowInstance | null;
-                xystore: XYStoreApi | null;
-                initialized: {
-                    xydata: boolean;
-                    xyflow: boolean;
-                };
-                xynodes: RelationshipDetailsTypes.Node[];
-                xyedges: RelationshipDetailsTypes.Edge[];
-                bounds: BBox;
-            }>, {
-                type: "xyflow.resized";
-            }, Events, undefined, never, never, never, never, never>];
-        };
-        readonly 'xyflow.updateNodeInternals': {
-            readonly actions: "xyflow:updateNodeInternals";
-        };
-    };
-}>;
-type InferredMachine = typeof _relationshipDetailsLogic;
-export interface RelationshipDetailsLogic extends InferredMachine {
+export type Tags = never;
+export interface RelationshipDetailsLogic extends StateMachine<Context, Events, {}, any, any, any, any, any, Tags, Input, any, any, any, any> {
 }
 export declare const relationshipDetailsLogic: RelationshipDetailsLogic;
-export interface RelationshipDetailsActorRef extends ActorRefFromLogic<RelationshipDetailsLogic> {
-}
 export type RelationshipDetailsSnapshot = SnapshotFrom<RelationshipDetailsLogic>;
-export {};
+export interface RelationshipDetailsActorRef extends ActorRef<RelationshipDetailsSnapshot, Events> {
+}
+export type { Input as RelationshipDetailsInput, };

package/dist/overlays/relationship-details/actor.js

@@ -30,6 +30,7 @@ const _relationshipDetailsLogic = setup({
   types: {
     context: {},
     input: {},
+    tags: {},
     events: {}
   },
   actions: {

package/dist/overlays/relationship-details/layout-to-xyflow.js

@@ -1,4 +1,4 @@
-import { Queue, nonNullable, RichText } from '@likec4/core';
+import { Queue, nonNullable } from '@likec4/core';
 import { hasAtLeast } from 'remeda';
 import { ZIndexes } from '../../base/const.js';
 
@@ -36,8 +36,6 @@ function layoutResultToXYFlow(layout) {
     const base = {
       id,
       draggable: false,
-      selectable: true,
-      focusable: true,
       deletable: false,
       position,
       zIndex: isCompound ? ZIndexes.Compound : ZIndexes.Element,
@@ -86,7 +84,7 @@ function layoutResultToXYFlow(layout) {
               fqn,
               title: node.title,
               technology: node.technology,
-              description: RichText.from(node.description),
+              description: node.description ?? null,
               height: node.height,
               width: node.width,
               color: node.color,
@@ -131,7 +129,7 @@ function layoutResultToXYFlow(layout) {
         color,
         navigateTo,
         line,
-        description: RichText.from(description),
+        description: description ?? null,
         ...technology && { technology }
       }
     });

package/dist/overlays/relationship-details/layout.d.ts

@@ -1,4 +1,4 @@
-import { AnyAux, DiagramEdge, DiagramNode, DiagramView, Fqn, RelationId, RichTextOrEmpty } from '@likec4/core/types';
+import { AnyAux, DiagramEdge, DiagramNode, DiagramView, Fqn, MarkdownOrString, RelationId } from '@likec4/core/types';
 import { LikeC4ViewModel } from '@likec4/core/model';
 import { Except } from 'type-fest';
 import { RelationshipDetailsTypes } from './_types';
@@ -10,7 +10,7 @@ export type LayoutResult = {
 };
 export declare namespace LayoutResult {
     type Node = Except<DiagramNode, 'modelRef' | 'description' | 'deploymentRef' | 'inEdges' | 'outEdges'> & {
-        description: RichTextOrEmpty;
+        description: MarkdownOrString | null;
         modelRef: Fqn;
         column: RelationshipDetailsTypes.Column;
         ports: RelationshipDetailsTypes.Ports;
@@ -19,7 +19,7 @@ export declare namespace LayoutResult {
         relationId: RelationId;
         sourceHandle: string;
         targetHandle: string;
-        description: RichTextOrEmpty;
+        description: MarkdownOrString | null;
     };
 }
 export declare function layoutRelationshipDetails(data: RelationshipDetailsViewData, scope: LikeC4ViewModel<AnyAux> | null): LayoutResult;

package/dist/overlays/relationship-details/layout.js

@@ -1,5 +1,5 @@
 import { treeFromElements } from '@likec4/core/compute-view/relationships';
-import { exact } from '@likec4/core/types';
+import { exact, preferSummary } from '@likec4/core/types';
 import dagre from '@dagrejs/dagre';
 import { ifind, DefaultMap, invariant } from '@likec4/core/utils';
 import { pipe, filter, mapToObj, omit, find, map, tap, reduce, sortBy, prop } from 'remeda';
@@ -239,7 +239,7 @@ function layoutRelationshipDetails(data, scope) {
       x: position.x,
       y: position.y,
       title: element.title,
-      description: element.summary,
+      description: preferSummary(element.$element) ?? null,
       technology: element.technology,
       tags: [...element.tags],
       links: null,
@@ -288,7 +288,7 @@ function layoutRelationshipDetails(data, scope) {
       const { name, source, target, relationship, sourceHandle, targetHandle } = find(edges, (e2) => e2.name === ename);
       const label = relationship.title ?? "untitled";
       const navigateTo = relationship.navigateTo?.id ?? null;
-      const description = relationship.description ?? null;
+      const description = preferSummary(relationship.$relationship) ?? null;
       const technology = relationship.technology ?? null;
       acc.push({
         id: name,
@@ -298,8 +298,8 @@ function layoutRelationshipDetails(data, scope) {
         targetHandle,
         label,
         color: relationship.color,
+        description,
         ...navigateTo && { navigateTo },
-        ...description && { description },
         ...technology && { technology },
         points: edge.points.map((p) => [p.x, p.y]),
         line: relationship.line,