genui

type AnthropicComposer struct {
	// contains filtered or unexported fields
}

type AnthropicConfig struct {
	// APIKey authenticates the call. Empty means read ANTHROPIC_API_KEY at
	// COMPOSE time, not at construction: a host that builds its plugin graph
	// before its secrets are loaded should still work.
	APIKey string
	// Model defaults to [DefaultAnthropicModel].
	Model string
	// Endpoint defaults to [DefaultAnthropicEndpoint]. Tests point this at an
	// httptest server, which is why this composer needs no key to be tested.
	Endpoint string
	// MaxTokens bounds the response. Compositions are small; the default is
	// deliberately modest so a runaway generation costs little.
	MaxTokens int
	// HTTPClient defaults to a client with a 60s timeout.
	HTTPClient *http.Client
	// Retries is how many EXTRA attempts a refused composition gets, each one
	// carrying the validator's complaint back to the model. Default 1: one
	// correction is worth having, an unbounded loop is a bill.
	Retries int
}

type ComponentSpec struct {
	// Name is the component key a composition's node must carry.
	Name string
	// Props are the declared props, in declaration order.
	Props []PropSpec
	// AcceptsChildren reports whether a node of this component may carry a
	// children array at all (children on Text is refused, not ignored).
	AcceptsChildren bool
	// CarriesAction reports whether a node of this component may carry an
	// action at all. True for Button only: a generated control is the one
	// thing in a composition with behaviour, and the allow-list still gates
	// whichever name it carries.
	CarriesAction bool
}

type Composer interface {
	Compose(ctx context.Context, prompt string, r Registry) (Composition, error)
}

type Composition struct {
	SchemaVersion string `json:"schemaVersion"`
	Root          *Node  `json:"root"`
}

type FixtureComposer struct{}

type MountConfig struct {
	// DocID is the genui identity for this mount (logging/debug key; a
	// composition is ephemeral state, not a persisted doc).
	DocID string
	// MinHeight is the composition viewport height. Defaults to 460px.
	MinHeight string
	// Capabilities is an optional CSV grant override.
	Capabilities string
}

type Node struct {
	Component string         `json:"component"`
	Props     map[string]any `json:"props,omitempty"`
	Action    string         `json:"action,omitempty"`
	Children  []Node         `json:"children,omitempty"`
}

type Option func(*Plugin)

type Plugin struct {
	// contains filtered or unexported fields
}

type PropSpec struct {
	// Name is the prop key. Anything else in a node's props object is an
	// unknown prop and the composition is refused.
	Name string
	// Type is the value shape; see the PropType constants.
	Type PropType
	// Required means the prop must be present. An optional prop may be
	// absent, but present-but-null is still a wrong type, not absent.
	Required bool
	// Enum, when non-nil, is the closed vocabulary for a PropString. A value
	// outside it is refused (gap: "huge" is not a layout the renderer knows).
	Enum []string
	// Min/Max, when non-nil, bound a PropInt/PropNumber value.
	Min, Max *float64
}

type PropType string

type Registry struct {
	// contains filtered or unexported fields
}

type ValidationError struct {
	Code    string
	Path    string
	Message string
}