Changelog

0.3.0 — 2026-05-13

description_lines: option — reserves a fixed-height description area of exactly N lines. Content is clipped if longer; space is held empty if there is no description. Ensures two side-by-side panels share the same header height regardless of description length. Closes #39.
panel_height_px: option — fixes the total widget height. The header takes what it needs; the graph row fills the rest. Prevents page reflow as artefacts grow across panels in a progressive-reveal livebook.

Node colours are now derived from a deterministic string hash of the label name rather than the label's position in the sorted list. The same label string always produces the same colour regardless of how many other labels exist in the artefact — a node can be followed by colour across panels without thinking about it. Closes #39.

Bumps artefact requirement to ~> 0.2.0. ArtefactKino.new/1,2 continues to validate its input via Artefact.validate!/1, which now raises Artefact.Error.Invalid instead of ArgumentError when an invalid artefact is passed in. Behaviour is otherwise unchanged.

ArtefactKino.new/1,2 now calls Artefact.validate!/1 on its input — a hand-built %Artefact{} with malformed fields (non-list labels, missing uuid, dangling relationship endpoint, etc.) raises ArgumentError with structured reasons instead of a cryptic render-time error. Closes #28. Bumps artefact requirement to ~> 0.1.5 for the new validation API.

Inspector panel collapsible (matching the Export panel); both default collapsed to give the graph more room on bigger artefacts; selecting a node or relationship in the graph auto-expands the Inspector. Bumps artefact requirement to ~> 0.1.4 for convenience.

Compatible with artefact ~> 0.1.3
MERMAID button on the export panel — pasteable Mermaid graph source alongside CREATE / MERGE / JSON
Header bar renders artefact.description under artefact.title when set; multi-line descriptions preserve their newlines (white-space: pre-line)
description row added to the Artefact tab in the Elixir inspector, alongside title, base_label and metadata

ArtefactKino.new/1, ArtefactKino.new/2 — Livebook Kino widget for %Artefact{}
Interactive vis-network graph (left panel) with Arrows coordinates preserved
Cypher fragment display with copy button (right panel)
Sand Talk aesthetic — dark sand background, ochre nodes and edges
:merge view option showing the harmonised graph