Skip to content

Type Alias: StateErrorCode

ts
type StateErrorCode = "invalid-filter" | "invalid-state" | "unknown-id" | "unsupported";

Why a write was rejected. A closed vocabulary so a host can branch on the outcome without matching on prose — the message is for humans and may be reworded, the code is the contract.

  • invalid-filter — the value failed the component's own filter schema.
  • invalid-state — the per-id payload wasn't a JSON-serializable object.
  • unknown-id — no component in this dashboard has that id. The write was ignored.
  • unsupported — the value was well-formed and matched the component's schema, but that component cannot apply it. A chart brush whose selector ignores programmatic writes is the motivating case: without this code the registry would report a filter that is not actually in effect, and neither get nor onChange would ever hint at it.

Ridge AI