# `LivePanels.Canvas.Render`
[🔗](https://github.com/livepanels/livepanels/blob/v0.1.0/lib/livepanels/canvas/render.ex#L1)

Render-side helpers for ordinary `canvas_runtime/1` applications.

These helpers do not mutate canonical canvas state. They operate on the
current LiveView render projection.

# `item_ref`

```elixir
@type item_ref() ::
  LivePanels.Item.t()
  | LivePanels.Item.RenderContext.t()
  | LivePanels.Item.View.t()
  | %{id: String.t()}
  | String.t()
```

# `refresh`

```elixir
@spec refresh(Phoenix.LiveView.Socket.t(), item_ref() | [item_ref()]) ::
  Phoenix.LiveView.Socket.t()
```

Re-sends existing rendered canvas items to the LiveView stream.

Use this when rendered canvas items depend on app assigns outside canonical
canvas state. This does not mutate canvas state, history, persistence, or
shared-coordination state.

---

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