Every typed error Rekhly throws extends RekhlyError (a code property plus the message) and is listed below with the real JSDoc explaining when it fires — extracted the same way as the API reference, not hand-copied.
An operation was attempted on a chart, engine, or renderer that has already been disposed.
An export operation failed.
Input data failed validation (wrong arity, NaN, empty required buffer).
License validation failed. Secrets must never be hardcoded; see env `REKHLY_LICENSE`.
Renderer construction or `initialize()` failed for a reason other than a specific backend being unavailable.
A GPU/CPU resource could not be created, compiled, or disposed cleanly.
A streaming transport failed to connect or dropped unexpectedly.
WebGL2 was requested (or required as fallback) but the environment could not produce a `webgl2` context.
WebGPU was requested but is unavailable, or is not production-ready in this Rekhly release.
The core renderer is WebGL2 and runs with or without a GPU — headless/CI environments get Rekhly's own software WebGL2 implementation (renderer.device === "software"), same shaders and scene graph. Canvas 2D is opt-in only ({ renderer: { force: "canvas" } }), not an automatic no-GPU fallback — forcing "webgpu" throws WebGPUUnavailableError until that renderer's milestone is ready.
dispose() is idempotent on every chart, engine, and renderer — a second call is a safe no-op. Any other method call after dispose() throws ChartDisposedError by design (catches use-after-teardown bugs, especially under React Strict Mode's double-invoke).
Never put streaming samples into React/framework state — call series.appendSamples(...) (or FinancialChart.appendSamples(...)) directly on the chart instance. State updates trigger a re-render of the whole component tree per sample; the chart's own typed-array buffers do not.
Got any questions? I'm happy to help with products, licensing, and examples.