Layout

The layout section contains visual rendering hints. It is optional and typically generated by the editor. Hand-written files can omit it entirely — the editor will auto-layout using direction (default TB).

When positions are provided, they take precedence over auto-layout.

Example

layout:
  direction: LR
  viewport: [418.5, -19, 2]
  positions:
    orchestrator: [350, 0]
    inventory-agent: [100, 200]
  sizes:
    orchestrator: [240, 117]
  node_styles:
    orchestrator:
      borderless: true
      icon_url: "https://example.com/icon.png"
      icon_layout: left

Properties

PropertyTypeDefaultDescription
directionstringTBAuto-layout flow: TB, LR, BT, RL
viewportarray[x, y, zoom] — initial camera position
positionsmapNode id → [x, y] coordinates
sizesmapNode id → [width, height] dimensions
node_stylesmapNode id → visual style overrides

Direction values

ValueMeaning
TBTop to bottom (default)
LRLeft to right
BTBottom to top
RLRight to left

Node style properties

PropertyTypeDescription
borderlessbooleanHide node border
icon_urlstringCustom icon URL
icon_layoutstringIcon position: left, right, top, bottom
image_urlstringBackground image (image nodes)