What’s ready — evidence¶
Maintainer and evaluator capability matrices for the 0.59.x train. For the one-screen adopter summary, start at What’s ready today.
Release channel status: Current release and support.
Maintainer gate IDs and RFC evidence live in the repository
docs/STATUS.md.
How labels work¶
Supported means the capability works on the current train when pinned. Most public
symbols remain API compatibility level beta. The
minimal and
expanded stable tables are
compatibility-protected today (narrow Beginner/CRUD facade —
STABLE_FACADE) — not every Supported row on this page.
Package maturity remains Beta on PyPI — no scheduled 1.0, no commercial SLA.
| Label | Meaning |
|---|---|
| Supported | Working with pinned versions for the stated host — ship with pins; ≠ API stable |
| Experimental | Public API shipped; may change; prefer documented fallbacks (e.g. polling) |
| Alpha | On PyPI; pin and expect churn |
| Deferred | Documented, not ready — do not treat as Supported |
Package maturity (Beta/Alpha) ≠ capability readiness (Supported/Experimental/Deferred) ≠ API levels in STABILITY. Full cheat-sheet: Maturity labels (evaluators).
Human accessibility testing protocol engineering is on the train; compensated screen-reader sessions are not Supported yet — do not market human AT as done.
Live transports
SSE, focused streaming, WebSocket channels, and navigation preload are
experimental (hedron.experimental). Prefer polling in
production — see LIVE_DISPOSITION.
What’s ready today plus this evidence page are the maturity
sources of truth for Supported vs Experimental claims.
Use today (expanded)¶
| Job | Status | Start here |
|---|---|---|
| Ship CRUD / admin / forms | Supported | First app → Minimal form → HTMX |
| Refreshable views / command handles | Supported (API beta) |
Refreshable views · What’s new in 0.43 |
| Type-driven authoring / generated forms | Supported (API beta) |
Type-driven authoring · What’s new in 0.44 |
| Feature bundles / data workspaces | Supported (API beta; opt-in) |
Package workflows · What’s new in 0.46 |
| Declared HTMX extensions | Supported when declared and pinned (sse, head-support, preload); APIs for SSE/preload remain experimental |
HTMX extensions · What’s new in 0.48. Idiomorph is Deferred |
| First-class maps | Supported (API beta; hedron[maps]) |
Maps · What’s new in 0.47 |
| Multi-worker durable jobs | Supported with shared Redis backend | Jobs · Celery / RQ |
| DataTable / DataEditor | Supported (hedron[data]; ABI hedron-data-editor) |
Data apps · DATA.md |
| Bounded OptimisticMutation | Supported for collection/cell edits only; deny-by-default elsewhere | DATA.md · What’s new in 0.39 |
| Public element author kit | Supported contracts (hedron new element, plugin registration) |
Plugin authoring · What’s new in 0.41 · What’s new in 0.42 |
| ReactMigrationMatrix / island | Matrix Supported as guidance; island Experimental docs/reference only | REACT_MIGRATION_MATRIX_040 |
| Table↔chart cross-filter | Supported via compose_chartlink_039 on Published 0.38 hedron-chart |
Dashboards |
| Flask / Django host | Supported (host pages/fragments/CSRF; not FastAPI decorator-parity for progressive facades) | Flask · Django |
| Posit Workbench / RStudio Server | Supported (hedron[workbench] or hedron[posit]) |
Posit Workbench · Posit deployments — Workbench 2025.05.1–2026.07.0; HedronWorkbench / HedronPosit; no import auto-wrap |
| Posit Connect (native GUID) | Supported (hedron[posit]) |
Posit deployments — Connect 2025.06.0–2026.07.0; native cookies |
| Live SSE / WebSocket updates | Experimental | Prefer polling |
| Charts | Supported first-party and Matplotlib/static paths on Beta package | Install hedron[charts]>=0.59.0,<0.60; ChartSpec / hedron-chart and Matplotlib/static are Supported; Plotly / Altair remain Experimental (Chart API) |
| Model demos / inference workflows | Supported capability (fail-closed; APIs beta) |
Runnable model-demo example — Model demos · Recipes |
| MCP projection | Supported inventory on Beta hedron-mcp 0.2.1 |
Deny-by-default; pin hedron[mcp]; mutations Experimental |
| Notebook preview | Supported tooling-grade scope | Localhost preview only; not Supported production hosting |
| Remote Gradio / HF Space client interop | Supported on Beta hedron-gradio 0.2.0 |
Declared allowlisted destinations; pin >=0.2.0,<0.3; Gradio migration |
| Application DX Stage 1 | Supported (API beta; repository train v0.59.0) |
Assets, diagnostics, routes, workflows, testgen, theming, discovery, fleet — Application DX API · What’s new in 0.53 |
| Authoring loop / chrome (0.54) | Supported tooling-grade for notebook/sim/sample-kit; chrome APIs beta (published tip v0.59.0) |
Package doctor, sim subset/parity, notebook handles, AppShell chrome — Authoring loop · What’s new in 0.54 |
Progressive screens (Hedron.screen) |
Supported on FastAPI (API beta; tip v0.59.0) |
Hedron API · What’s new in 0.58 |
Typed form commands (form_command) |
Supported on FastAPI (API beta) |
Hedron API · What’s new in 0.58 |
DataWorkspace screens (with_screen) |
Supported on FastAPI + hedron[data] (API beta) |
DATA.md · What’s new in 0.58 |
| TaskFlow | Supported on FastAPI (API beta; polling) |
JOBS.md · What’s new in 0.58 |
| DashboardWorkspace | Supported on FastAPI (API beta) |
Dashboards · What’s new in 0.58 |
| SessionAuthFlow | Supported on FastAPI (API beta; not an IdP) |
AUTH.md · What’s new in 0.58 |
| UploadFlow | Supported on FastAPI (API beta) |
What’s new in 0.58 · File upload |
| DesignSystem / StyleRecipe / StyleScope | Supported (API beta) |
PRESENTATION.md · StyleScope |
| Explain / style CLI tooling | Supported tooling-grade | CLI.md · hedron explain / hedron style |
Package train vs capability
Flagship packages are Beta maturity — pin hedron>=0.59.0,<0.60. The table above is
capability readiness (Supported / Experimental / Deferred), not package maturity.
Supported capabilities¶
| Capability | Package / surface | Status |
|---|---|---|
| Typed pages, fragments, built-ins | hedron + hedron-core |
Supported |
| FastAPI routing, CSRF profiles, CLI, testing helpers | hedron |
Supported |
HTMX fragment loops, InteractionResult |
hedron |
Supported |
@app.refreshable / @app.command / refresh() / PatchSet |
hedron / hedron-core |
Supported; API beta; compiles into the existing region / OOB stack |
ViewParams / FormBody / ActionHandle.form() / OutcomeMap / class handlers |
hedron / hedron-core |
Supported; API beta; opt-in on 0.43 handles |
FeatureBundle / Hedron.include_feature / DataWorkspace / ChartInteraction |
hedron-core / hedron / hedron-data / hedron-charts |
Supported; API beta; compiles onto 0.43–0.45 handles; not an executor |
| Chat / Dialog surfaces | hedron |
Supported; history application-owned |
Flask Blueprint / init_app |
hedron-flask |
Supported; live helpers Experimental (prefer polling) |
| Django AppConfig, forms bridge, QuerySet DataSource | hedron-django + hedron-data |
Supported |
| Portable adapter test harness | hedron_core.testing / hedron.testing.adapters |
Supported |
Optional HDJ (.hdj) templates |
hedron[jinja] |
Supported |
Celery / RQ JobBackend bridges |
hedron_core.jobs_celery / jobs_rq |
Supported; require shared Redis for multi-worker status |
Component prepare() + adaptive concurrency |
hedron-core / hedron |
Supported |
| Optional distributed tracing | hedron[otel] / hedron.tracing |
Supported optional |
| Security audit sink | hedron_core.audit |
Supported |
| Auto (inspectable object rendering) | hedron (no extra) |
Supported |
| DataTable / DataEditor + column catalog, views, TransformPlan | hedron[data] |
Supported |
| AG Grid Community client + infinite row models | hedron-data[aggrid] |
Supported; Enterprise out of scope |
| Dask / Snowflake bounded sources | hedron-data[dask] / [snowflake] |
Supported |
| Component Explorer (dev) | hedron[dev] |
Supported for local diagnostics; 0.50 pagination, provider isolation, catalog diffs, CLI/HTML/JSON agreement, and panels listed in Explorer API |
| Language-neutral conformance kit | hedron[conformance] |
Supported |
| HDJ loop/macro budgets, a11y static checks | hedron[jinja] |
Supported |
| AppScenario + HTMX InteractionResult asserts | hedron.testing |
Supported |
region / @fragment / swap ergonomics |
hedron |
Supported |
| Typed controls, surface chrome, Map, media Range | hedron / hedron-core |
Supported |
| CameraCapture / MicrophoneCapture | hedron / hedron-core |
Supported with permission/retention policy |
| BrowserContext/Storage, Math, IFrame | hedron / hedron-core |
Supported |
| OIDC / session helpers + connection registry | hedron |
Supported helpers (API beta); host auth/DI authoritative — not an IdP product |
| Curated extras toolkit (install-isolated) | hedron[extras] |
Supported for the curated toolkit surface; not CodeEditor / TerminalView / joystick / device / sandbox. Experimental UI requires hedron[experimental-ui] plus HEDRON_EXPERIMENTAL_UI or explicit plugin enablement. Sandbox requires hedron_extras_sandbox / HEDRON_EXTRAS_SANDBOX. |
| Dashboard bindings, patches, cross-filter, AppShell | hedron / hedron-core |
Supported (API beta; see what's new 0.17) |
Public render_interaction |
hedron |
Supported |
| Dialog / Tabs / Pagination / Lazy markup asserts | hedron.testing |
Supported |
InferenceInterface / ModelDemo / ActionRegistry |
hedron-core / hedron |
Supported capability; API level beta; fail-closed |
| Example sets, prediction labels, feedback, workflows | hedron-core / hedron |
Supported capability; API level beta; consent mandatory for feedback |
InferencePolicy / ModelDemoScenario |
hedron-core |
Supported capability; API level beta; in-process queue is dev-only |
InteractionRecorder |
hedron |
Supported capability; API level beta; public endpoints only |
| Accessibility contracts / profile / claim boundaries | hedron_core.a11y |
Supported capability; API beta; no auto WCAG/legal/VPAT claims — A11Y |
Progressive-enhancement forms / landmarks / Page(scripts=) |
hedron / hedron-core |
Supported; HTMX is optional enhancement rather than a requirement for core form flows |
| Explorer accessibility workspace | hedron[dev] / hedron-explorer |
Supported for local diagnostics (/hedron-explorer/a11y) |
| Automated Playwright/axe accessibility matrix | hedron[browser] |
Supported automation evidence; not equivalent to human assistive-technology testing |
| Remote Gradio / HF Space client interop | hedron[gradio] / hedron-gradio |
Supported for declared allowlisted destinations; pin >=0.2.0,<0.3 |
Pin package versions in production. “Supported” does not mean a commercial SLA or guaranteed multi-worker live-transport proof.
Experimental (prefer documented fallbacks)¶
| Capability | Package / surface | Notes |
|---|---|---|
| Live interaction: SSE, streaming, WebSocket, preload | hedron.experimental (FastAPI) |
Prefer polling |
| CodeEditor | hedron[experimental-ui] |
Host stub (CSP-safe shell; no pinned CodeMirror 6 bundle); importable from hedron_extras.experimental, but omitted from default plugin registration |
| Browser-Python sandbox | opt-in hedron_extras_sandbox / HEDRON_EXTRAS_SANDBOX |
Experimental; not registered by default hedron[extras]. Import stays hedron_extras.sandbox |
| TerminalView / joystick / device bridges | hedron[experimental-ui] |
Fail-closed experimental surfaces; omitted from default plugin registration but not blocked from direct Python imports |
| Native desktop shell | docs recipe | Packaging guidance only |
| Flask / Django live helpers | adapters | Prefer polling |
Tooling-grade Beta (not application production servers)¶
| Package | Role |
|---|---|
hedron[notebook] / hedron-notebook |
Localhost-oriented preview; tooling-grade Supported; not Supported production hosting |
hedron-sample-kit |
Installable reference plugin (>=0.2.0,<0.3) |
hedron-sim |
Deterministic offline fragment simulation (tooling-grade) |
packages/hedron-runtime-* |
Tooling-grade Java / Node conformance evaluators |
Independent Beta satellites¶
| Package | Role |
|---|---|
hedron[mcp] / hedron-mcp |
Beta 0.2.1 (>=0.2.0,<0.3); deny-by-default Supported inventory; mutations Experimental |
hedron[gradio] / hedron-gradio |
Beta 0.2.0 (>=0.2.0,<0.3); allowlisted remote predict/stream/file transport |
hedron[charts] / hedron-charts |
Beta package (>=0.2.0,<0.3); first-party ChartSpec / hedron-chart and Matplotlib/static Supported; Plotly/Altair Experimental |
hedron[native] / hedron-native |
Optional Rust HTML-escape accel; pure-Python fallback Supported |
Deferred (do not market as Supported)¶
- Explorer live traces from the historical
0.10.xwork remain deferred. - Compensated human screen-reader evaluation remains planned and is not Supported. The published evidence covers the protocol and automated Playwright/axe checks, not completed human sessions.
Superseded in 0.24 (not Supported live)¶
- A full multi-engine live-browser matrix for FastAPI and adapters is not a Supported claim; the production recommendation is polling.
- Load/proxy backpressure evidence for live transports is incomplete; applications that opt into SSE/WebSocket must validate their own proxy and workload behavior.
Prefer polling. Live SSE/WS helpers remain experimental.
Maintainer gate IDs and RFC evidence:
docs/STATUS.md.
Runnable examples¶
Prefer adopter recipes first:
- Recipes — Notes, session auth, uploads, jobs poll
- Flask Refresh · Django Refresh
- FastAPI / Flask / Django reference apps — runnable examples
Phase-stamped folders (data-app-0.15, dashboard-0.17, …) are
maintainer evidence stubs, not product tutorials. The
model-demo example
is a runnable classifier. Live interaction sample:
examples/live-interaction
(polling Supported; SSE/WS experimental).
Recommended install extras¶
Pin hedron>=0.59.0,<0.60. Public-index notes: Installation.
Extras: "hedron[data]>=0.59.0,<0.60", "hedron[extras]>=0.59.0,<0.60",
"hedron[jinja]>=0.59.0,<0.60", "hedron[dev]>=0.59.0,<0.60",
"hedron[notebook]>=0.59.0,<0.60" (tooling / localhost),
"hedron[mcp]>=0.59.0,<0.60" (Beta Supported inventory),
"hedron[gradio]>=0.59.0,<0.60" (Beta satellite; pin hedron-gradio>=0.2.0,<0.3),
"hedron[charts]>=0.59.0,<0.60", "hedron[maps]>=0.59.0,<0.60", "hedron[workbench]>=0.59.0,<0.60",
"hedron[posit]>=0.59.0,<0.60",
and "hedron-sample-kit>=0.2.0,<0.3".