Skip to content

Interface: RidgeEmbed ​

The dashboard handle returned immediately by embed().

Properties ​

PropertyModifierTypeDescription
readyreadonlyPromise<RidgeEmbed>Resolves with this handle when the dashboard is ready for state reads and updates.

Methods ​

exportImage() ​

ts
exportImage(type?: "png" | "jpeg" | "svg" | "blob" | "pixelData"): Promise<string | Blob | Uint8ClampedArray<ArrayBufferLike> | null>;

Export the dashboard image, once it has rendered the latest state.

  • "png" (default), "jpeg", and "svg" return data URL strings usable as an image's src.
  • "blob" returns a PNG Blob.
  • "pixelData" returns a Uint8ClampedArray of RGBA pixel values.

Returns null if no dashboard image is available. Export failures reject the promise.

Parameters ​

ParameterType
type?"png" | "jpeg" | "svg" | "blob" | "pixelData"

Returns ​

Promise<string | Blob | Uint8ClampedArray<ArrayBufferLike> | null>


getFilters() ​

ts
getFilters(): FilterValues;

Returns ​

FilterValues


getState() ​

Call Signature ​

ts
getState(): StateValues;
Returns ​

StateValues

Call Signature ​

ts
getState(id: string): ComponentState | null;
Parameters ​
ParameterType
idstring
Returns ​

ComponentState | null


getStateSchema() ​

ts
getStateSchema(): StateSchema;

The complete state schema, keyed by component id and state key.

Returns ​

StateSchema


on() ​

ts
on<K extends keyof RidgeEmbedEventMap>(event: K, listener: (value: RidgeEmbedEventMap[K]) => void): () => void;

Register an event listener. Returns a function to remove it. Safe to call before ready.

Type Parameters ​

Type Parameter
K extends keyof RidgeEmbedEventMap

Parameters ​

ParameterType
eventK
listener(value: RidgeEmbedEventMap[K]) => void

Returns ​

() => void


setFilters() ​

ts
setFilters(values: FilterValues, options?: StateWriteOptions): Promise<FilterUpdateResult>;

Parameters ​

ParameterType
valuesFilterValues
options?StateWriteOptions

Returns ​

Promise<FilterUpdateResult>


setState() ​

ts
setState(values: StateValues, options?: StateWriteOptions): Promise<StateUpdateResult>;

Parameters ​

ParameterType
valuesStateValues
options?StateWriteOptions

Returns ​

Promise<StateUpdateResult>


unmount() ​

ts
unmount(): void;

Returns ​

void