Skip to content

v0.9.0

Choose a tag to compare

@apstndb apstndb released this 30 Jun 14:27
· 10 commits to main since this release
c42919e

v0.9.0

Library API refactor for reusable plan building and dedicated Mermaid/Graphviz renderers, with browser-friendly Mermaid output for WASM/embedder consumers such as rendertree-web.

Breaking

  • Removed visualize.RenderImage, visualize/mermaid.go, and visualize/visualize.go.
  • visualize.RenderImage(...) → visualize.BuildPlan(...) + graphviz.NewRenderer(...).Render(...) or mermaid.Source(plan).
  • mermaid.Source(plan, opts) → build with desired visualize.BuildOptions, then mermaid.Source(plan).
  • mermaid.SourceWithOptions(plan, opts) unconditionally uses opts.BuildOptions (including disabling flags already enabled on plan.Build).
  • graphviz.NewRenderer requires an explicit Format (svg, png, or dot).

Added

  • visualize.BuildPlan, visualize.Plan, StructureBuildOptions(), and FullBuildOptions().
  • mermaid package: Source, SourceWithOptions, NewRenderer.
  • graphviz package: NewRenderer, Options, Format constants.
  • Mermaid HTML label escaping fix (no literal \: / \_ in browser output).
  • Browser-friendly Mermaid init config (htmlLabels: true, flowchart.useMaxWidth: false).
  • Edge label escaping and regression tests.

Changed

  • CLI dispatches to mermaid / graphviz renderers based on --type.
  • README embedder guidance and golden Mermaid example reference.

Migration

plan, err := visualize.BuildPlan(rowType, stats, opts.BuildOptions())
renderer := graphviz.NewRenderer(graphviz.Options{Format: graphviz.SVG})
err = renderer.Render(ctx, w, plan)

plan, err := visualize.BuildPlan(rowType, stats, visualize.StructureBuildOptions())
src, err := mermaid.Source(plan)

Validation

  • go test ./...