# `Choreo.Lab.Siren`
[🔗](https://github.com/code-shoily/choreo/blob/v0.14.1/lib/choreo/lab/siren.ex#L2)

A custom Kino widget for rendering Mermaid diagrams with pan, zoom, and height control.

> #### Experimental module {: .warning}
> This module is experimental and its API is subject to change.

# `t`

```elixir
@type t() :: Kino.JS.t()
```

# `new`

```elixir
@spec new(String.t(), keyword()) :: t()
```

Creates a new Kino widget displaying the given Mermaid diagram.

## Options

  * `:height` - The height of the widget container (e.g., `"400px"`, `"600px"`, `500`). Defaults to `"400px"`.
  * `:theme` - The Mermaid theme to use (e.g., `"default"`, `"dark"`, `"forest"`, `"neutral"`).
    Defaults to `"default"` to match Livebook's light notebook canvas.
  * `:download` - Boolean indicating whether to show the download button. Defaults to `true`.
  * `:filename` - Base filename when downloading the SVG diagram. Defaults to `"diagram"`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*