Widget envelope

The uniform wrapper around every widget's payload.

json

{
  "type": "image_text_card",
  "id": "product_1",
  "layout": {},
  "data": {},
  "actions": { "tap": {}, "long_press": {}, "change": {} },
  "tracking": {}
}

Field	Type	Description
`type`req	String	Selects the registered component. Unknown types become placeholders.
`id`	String	Stable identity for state and mutations. Generated when absent.
`layout`	WidgetLayout	Backend controlled chrome. See the layout reference.
`data`	object	The payload owned by the widget type. The framework never reads inside it.
`actions`	{event: Action}	Event name to action. tap and long_press are wired automatically.
`tracking`	JSON	Opaque analytics payload forwarded to the host.

Decoding guarantees#

A widget whose type is unregistered, or whose data fails its model, is contained: the page renders without it, debug builds show a labelled placeholder, and the problem lands in diagnostics with its exact key path. See Resilience.