model

type AbstractPage struct {
	Expr     ast.Expr
	TypeName string

	Methods       []*Handler
	StreamOpen    *Handler
	StreamClose   *Handler
	EventHandlers []*EventHandler
	Embeds        []*AbstractPage
}

type App struct {
	Fset    *token.FileSet
	PkgPath string
	Expr    ast.Expr

	PageIndex    *Page
	PageError404 *Page
	PageError500 *Page

	RecoverError        ast.Expr    // Nullable.
	GlobalHeadGenerator *GlobalHead // Nullable.

	Session *SessionType // Nullable.

	Pages   []*Page
	Events  []*Event
	Actions []*Handler // App-level POST/PUT/PATCH/DELETE actions.
}

type Event struct {
	Expr ast.Expr

	TypeName string
	Subject  string

	SubjectFields []SubjectField
}

type EventHandler struct {
	Expr ast.Expr

	Name          string
	EventTypeName string

	InputEvent        *Input
	InputSSE          *Input
	InputStreamID     *Input
	InputSessionToken *Input
	InputSession      *Input
	OrderedInputs     []*Input // Inputs in user-defined order.

	OutputErr *Output
}

type GlobalHead struct {
	Expr              ast.Expr
	InputSession      bool
	InputSessionToken bool
}

type Handler struct {
	Expr ast.Expr

	Name string

	HTTPMethod string
	Route      string

	InputRequest      *Input
	InputStreamID     *Input
	InputSSE          *Input
	InputSessionToken *Input
	InputSession      *Input
	InputPath         *Input
	InputQuery        *Input
	InputSignals      *Input
	InputDispatch     *InputDispatch
	OrderedInputs     []*Input // Inputs in user-defined order.

	OutputBody           *TemplComponent // templ.Component body (actions only)
	OutputRedirect       *Output
	OutputRedirectStatus *Output
	OutputNewSession     *Output
	OutputCloseSession   *Output
	OutputEnableBgStream *Output
	OutputDisableRefresh *Output
	OutputErr            *Output
	OrderedOutputs       []*Output // Outputs in user-defined order.
}

type HandlerGET struct {
	*Handler
	OutputBody *TemplComponent
	OutputHead *TemplComponent
}

type Input struct {
	Expr ast.Expr

	Kind string // InputKind constant.
	Name string
	Type Type
}

type InputDispatch struct {
	*Input
	EventTypeNames []string
}

type Output struct {
	Expr ast.Expr

	Kind string // OutputKind constant.
	Name string

	Type Type
}

type Page struct {
	Expr     ast.Expr
	TypeName string
	Route    string

	PageSpecialization PageSpecialization

	GET           *HandlerGET
	Actions       []*Handler
	StreamOpen    *Handler
	StreamClose   *Handler
	EventHandlers []*EventHandler
	Embeds        []*AbstractPage
}

type PageSpecialization int8

type SessionType struct {
	Expr ast.Expr
}

type SubjectField struct {
	FieldName  string // e.g. "SubjectUser"
	Name       string // e.g. "User" (suffix after "Subject")
	SignalName string // e.g. "instance_id" (from signal:"instance_id" tag)
	Singular   bool   // true when the field type is string (not []string)
}

type TemplComponent struct {
	*Output
}

type Type struct {
	Resolved types.Type
	TypeExpr ast.Expr
}