Type Alias: StateValueSchema

type StateValueSchema = object;

The shape of the value a component's filter holds, as discovery reports it — a JSON Schema (draft 2020-12) object.

Components author their filter's shape as a Zod schema (the in-process source of truth used to validate inbound writes); discovery serializes that schema to JSON Schema for the wire, because the state schema crosses postMessage and a Zod object cannot. Hosts get a standard format they can feed to any JSON Schema validator instead of a Ridge-specific shape vocabulary they'd have to learn and pattern-match.

The dialect is JSON Schema draft 2020-12, fixed by this protocol. These are fragments describing one value, so they carry no $schema keyword of their own — a validator that wants one supplies the dialect above rather than reading it per component.

Examples: a slider is {type: "number"}, a range slider {type: "array", items: {type: "number"}}, a 2D chart brush {type: "array", items: {type: "array", ...}}. A component whose element type follows the data rather than the component (a menu over an arbitrary column) reports the union it actually accepts, e.g. {anyOf: [{type: "string"}, ...]}.

Deliberately typed as an open object rather than a hand-modeled JSON Schema union: the whole point is that components may describe any shape their filter genuinely accepts, so the wire type must not re-impose a closed vocabulary. Hosts that only need a human label can use describeFilterShape.