builder

type BindSource struct {
	Source, Label, Group, Class string
}

type BootKind struct {
	Kind     string         `json:"kind"`
	Children bool           `json:"children"`
	Props    []BootProp     `json:"props"`
	Default  map[string]any `json:"default,omitempty"`
	// Widget kinds: palette label, hint, group and the seeded children.
	Label string     `json:"label,omitempty"`
	Hint  string     `json:"hint,omitempty"`
	Group string     `json:"group,omitempty"`
	Seed  []SeedNode `json:"seed,omitempty"`
	// Hidden kinds (ref, slot) are not offered by the stock palette.
	Hidden bool `json:"hidden,omitempty"`
	// Display is the kind's default CSS display (see KindInfo.Display).
	Display string `json:"display,omitempty"`
	// Universal lists the element-setting props (anchor, aria, tip, ...) the kind takes.
	Universal []string `json:"u,omitempty"`
	// Interactive kinds may not sit inside a linked container (the editor checks it before saving).
	Interactive bool `json:"ia,omitempty"`
	// OnlyIn is the one parent kind the kind may sit under; set by BootKinds(true) only.
	OnlyIn string `json:"onlyIn,omitempty"`
}

type BootProp struct {
	Key      string   `json:"key"`
	Type     string   `json:"type"`
	Enum     []any    `json:"enum,omitempty"`
	Min      *float64 `json:"min,omitempty"`
	Max      *float64 `json:"max,omitempty"`
	Required bool     `json:"required,omitempty"`
	// Widget is the inspector control hint, MaxLength the string limit.
	Widget    string `json:"widget,omitempty"`
	MaxLength int    `json:"maxLength,omitempty"`
	// Bind is the class of source the prop accepts (text, url, image), empty when it cannot be bound.
	Bind string `json:"bind,omitempty"`
	// Pattern is the regular expression a string value must match.
	Pattern string `json:"pattern,omitempty"`
}

type CSSOpts struct {
	// Vars compiles the type-scale tokens to var(--hm-fs-<t>,<literal>) so a
	// site design system can override them; off, they compile to the literal.
	Vars bool
	// Force also emits every state rule for a forced selector,
	// [data-hm-force="hover"] and so on, so the canvas can show a state without
	// the pointer. The public render never sets it.
	Force bool
}

type Design struct {
	Tokens  Tokens            `json:"tokens"`
	Presets map[string]Preset `json:"presets"`
	// Parts assigns a theme_part entity id to a layout slot (see PartSlots).
	Parts map[string]string `json:"parts"`
}

type Doc struct {
	V     int     `json:"v"`
	Nodes []*Node `json:"nodes"`
}

type DocDiff struct {
	Changes   []NodeChange
	Truncated int // changes beyond the cap, not listed
}

type ExtSource struct {
	Plugin, Name, Label, Kind, Class string
}

type FieldChange struct {
	Key, BP  string
	Kind     string // DiffAdded | DiffRemoved | DiffChanged
	Old, New string // short renderings, "" when absent
	// Note qualifies the change ("formatting changed": an inline html change
	// whose text is the same).
	Note string
}

type KindInfo struct {
	Kind     string
	Children bool
	Props    []PropInfo
	Default  map[string]any
	// Universal lists the universal props (UniversalKeys) this kind takes.
	Universal []string
	// Interactive kinds render (or may render) links, buttons or other interactive
	// content, so a linked container cannot hold them (see InteractiveIn).
	Interactive bool
	// Widget kinds only: palette label, hint, group and the children a fresh
	// node is inserted with.
	Label, Hint, Group string
	// OnlyIn is the one parent kind a node of this kind may sit under ("" = any).
	OnlyIn string
	Seed   []SeedNode
	// Hidden kinds are read by the client but never offered by the stock
	// palette: the editor adds ref through blocks, slot in part mode and
	// loopempty from a loop's inspector.
	Hidden bool
	// Display is the CSS display a shown node of this kind has by default (the
	// root rule of its base or widget CSS; a container in grid layout is "grid").
	// The editor writes it when "show" has to undo a wider hide.
	Display string
}

type Node struct {
	ID string                       `json:"id"`
	T  string                       `json:"t"`
	P  map[string]any               `json:"p,omitempty"`
	S  map[string]map[string]string `json:"s,omitempty"`
	C  []*Node                      `json:"c,omitempty"`
	// B binds props to data: prop key -> source (see BindSources). While b[key]
	// exists p[key] is ignored; render resolves the source.
	B map[string]string `json:"b,omitempty"`
}

type NodeChange struct {
	ID    string
	T     string // kind in the new doc (old doc for removed)
	Label string // palette label of T, T itself when it has none
	Hint  string // a short text of the node, "" when it has none
	Op    string // DiffAdded | DiffRemoved | DiffMoved | DiffChanged
	// Parent is the parent id in the new doc (old doc for removed), "" = top
	// level; Index is the position among its siblings there.
	Parent  string
	Index   int
	Subtree int
	// Field changes of a node in both docs (a moved node lists them too).
	Props, Styles, Binds []FieldChange
	TypeFrom             string // the old kind when t changed
}

type Op struct {
	Op     string          `json:"op"` // insert | move | remove | setProp | setStyle | setBind
	ID     string          `json:"id,omitempty"`
	Parent string          `json:"parent,omitempty"` // "" = top level
	Index  int             `json:"index,omitempty"`
	Node   *Node           `json:"node,omitempty"`
	Key    string          `json:"key,omitempty"`
	BP     string          `json:"bp,omitempty"`
	Value  json.RawMessage `json:"value,omitempty"` // setProp: any JSON, null deletes; setStyle, setBind: string, null deletes
}

type PackWidgetSchema struct {
	Name   string // the full kind, <plugin>_<widget>
	Schema []byte
	// contains filtered or unexported fields
}

type Preset struct {
	Label string                       `json:"label"`
	S     map[string]map[string]string `json:"s"`
}

type PropInfo struct {
	Key      string
	Type     string
	Enum     []any
	Min, Max *float64
	Required bool
	// Widget is the inspector control hint (x-hm-widget), "" for the default
	// control of the type. MaxLength is the string length limit, 0 for none.
	Widget    string
	MaxLength int
	// Bind is the class of source the prop accepts (x-hm-bind: text, url or
	// image), "" when the prop cannot be bound.
	Bind string
}

type Section struct {
	ID        string
	Type      string
	Title     string
	Content   map[string]any
	IsVisible *bool
	SortOrder int
	// Extra holds the section keys this model does not know. They ride along
	// in the component's p.extra so a round trip never drops them.
	Extra map[string]any
}

type SeedNode struct {
	T string            `json:"t"`
	P map[string]any    `json:"p,omitempty"`
	B map[string]string `json:"b,omitempty"`
	C []SeedNode        `json:"c,omitempty"`
}

type StyleSpecEntry struct {
	Key   string   `json:"key"`
	Kind  string   `json:"kind"`
	Props []string `json:"props"`
	// Tokens maps an allowed token to its CSS value (space, color, radius, fs, len).
	Tokens map[string]string `json:"tokens,omitempty"`
	// Enum maps an allowed value to its CSS value (kind enum).
	Enum map[string]string `json:"enum,omitempty"`
	// Pattern is the regexp of the literal values allowed besides tokens.
	Pattern string `json:"pattern,omitempty"`
	// Min, Max and Tpl describe a numeric key (kind count): a whole number in
	// [Min,Max] replaces %d in Tpl.
	// Min and Max are pointers so a zero bound (z: 0) is still sent.
	Min *int   `json:"min,omitempty"`
	Max *int   `json:"max,omitempty"`
	Tpl string `json:"tpl,omitempty"`
	// Settle marks a key the client does not preview on its own: the server
	// css message settles it.
	Settle bool `json:"settle,omitempty"`
	// States marks a key that may be set inside a state (hover, focus, ...).
	States bool `json:"states,omitempty"`
}

type Tokens struct {
	Color  map[string]string `json:"color,omitempty"`
	Space  map[string]string `json:"space,omitempty"`
	FS     map[string]string `json:"fs,omitempty"`
	Shadow map[string]string `json:"shadow,omitempty"`
}