ArtefactKino (ArtefactKino v0.3.0)

Copy Markdown View Source

Livebook Kino widget for rendering %Artefact{} knowledge graphs.

Renders three panels: interactive vis-network graph (heartside), an export panel toggling between CREATE / MERGE Cypher, Arrows JSON and Mermaid source, and a tabbed Elixir inspector showing the artefact, nodes and relationships as tables.

Usage

ArtefactKino.new(artefact)
ArtefactKino.new(artefact, default: :merge)

Summary

Functions

Render an %Artefact{} as a three-panel Kino widget.

Functions

new(artefact, opts \\ [])

Render an %Artefact{} as a three-panel Kino widget.

Validates the artefact via Artefact.validate!/1 first so a hand-built struct with malformed fields (non-list labels, missing uuid, dangling relationship endpoint, etc.) fails with a clear ArgumentError instead of a cryptic render-time error.

Options:

  • default::create (default) or :merge
  • description_lines: — integer; reserves a fixed-height description area of exactly this many lines. Content is clipped if longer; an empty area is reserved if there is no description. Keeps side-by-side graph viewports at the same height regardless of description length or presence.
  • panel_height_px: — integer; fixes the total widget height in pixels. The header takes what it needs and the graph row fills the rest. Use together with description_lines: to fully lock widget dimensions across a side-by-side progression so the page never reflows between panels.