GitHub

HyperSignal.jl

Datastar-flavored HTML for Julia, with front-row support for inlining CairoMakie figures and driving interactive MapLibre maps from your pages.

Compatible with Datastar v1.0.1.

using HyperSignal
using HyperSignal.Helpers: radio_field   # app-grade helpers live in a submodule
HyperSignal.@using_tags                  # brings div / select / summary / mark / time into scope

page = Frag(DOCTYPE,
    html(lang="en",
        head(meta(charset="UTF-8"), title("My App")),
        body(
            h1("Hello"),
            form(on_submit(ds_post("/save"; form=true)),
                 radio_field("size", "S", "Small"),
                 radio_field("size", "L", "Large"; checked=true),
                 button("Save", type="submit")),
        )))

html_response(page)                           # HTTP.Response, text/html
fragment_response(page, "#card")              # Datastar morph w/ selector header

Install

HyperSignal is registered in Julia's General registry — install it with:

] add HyperSignal

Design in one paragraph

Element tree (data) + render(io, x) (streaming): components return Element values you can compose, test, and inline; rendering streams to IO with auto-escape — no intermediate strings. Datastar actions are typed values; the element constructors lift Attribute-returning helpers (on(:click, ds_post(…)), ds_indicator(), …) out of the children list, so they drop in positionally without a splat ceremony. Auto-escape by default; Raw("…") is the only opt-out — never wrap user input.

Where next

  • CairoMakie inlining — drop figures into pages.
  • MapLibre maps — render a map and drive it from the server: viewport / cursor / click / drag-box as signals, recolor and fly back with JS snippets.
  • Datastar response shapes — the HTML / JSON / JS / SSE responses a handler returns, plus the full attribute-helper surface (ds_signals, ds_computed, ds_style, ds_bind, ds_show, …).
  • Security model — every escape boundary in the lib: where input is auto-escaped, where attribute/tag names raise ArgumentError, and the single Raw opt-out.
  • Performance — the renderer is on the request-handler hot path; how to regenerate the benchmark numbers and what to watch when changing elements.jl / render.jl / svg.jl.
  • API reference — every exported name, with examples.
  • examples/counter_app.jl — a ~50-line Datastar counter you can run with julia --project=examples examples/counter_app.jl (then open http://127.0.0.1:8080) to see html_response / fragment_response driving a live page.
  • example.jl — a runnable Pluto notebook: NOAA ERSSTv5 North Atlantic SST loaded from a vendored netCDF, rendered as a MapLibre map of per-cell mean SST. Date sliders @post a range and get a set_source_data recolor back; a shift-drag box posts {w, s, e, n} and gets a CairoMakie timeseries. smoke.jl is the thin fixture the pluto-smoke CI workflow asserts on.
  • The GitHub repo for issues, PRs, and the changelog.

License

MIT. See the LICENSE file.