Embed schema reference (v1)

The chart payload is validated with Zod in lib/embed/chart-input.schema.ts.

Top-level shape

Field	Type	Required
`v`	`1`	yes
`people`	array	yes
`relationships`	array	yes
`trusts`	array	yes
`entities`	array	yes
`options`	object	no
`options.perspectivePersonId`	string	no; opens the chart from that person

Caps

Up to 500 total nodes across people, trusts, and entities
Up to 1000 relationships

URL fields

The schema rejects URL-shaped leaf fields (href, src, avatarUrl, etc.). The CSP img-src 'self' data: is the real control; the schema guard is defense in depth.

Referential integrity

Relationship endpoints, trustee links, beneficiary links, and ownership owner IDs must resolve to IDs present in the payload.

⌘I