recipes

type AuthLayoutProps struct {
	utils.BaseProps

	// Card is the main auth content (typically a LoginCard or forms.Form
	// wrapped in a Card). Required.
	Card templ.Component
	// PanelTitle renders as a large heading in the branding panel. Optional.
	PanelTitle string
	// PanelText renders as body text under the PanelTitle. Optional.
	PanelText string
	// PanelFeatures is a list of bullet points rendered with checkmark icons
	// in the branding panel. Optional.
	PanelFeatures []string
	// PanelFooter renders at the bottom of the branding panel (e.g. a
	// testimonial, copyright, or security badge). Optional.
	PanelFooter templ.Component
	// Reverse flips the layout so the card appears on the right and the
	// branding panel on the left. Default: card left, panel right.
	// (On mobile the panel is always hidden.)
	Reverse bool
}

type DashboardProps struct {
	utils.BaseProps

	// Title and Subtitle render in a display.PageHeader at the top of the
	// content column.
	Title    string
	Subtitle string
	// Breadcrumb is an optional templ.Component slot (typically
	// navigation.Breadcrumbs) rendered above the title in the PageHeader.
	Breadcrumb templ.Component
	// Sidebar is the desktop sidebar slot (typically navigation.SidebarNav).
	// Required for the dashboard layout; pass nil for a sidebar-less shell.
	Sidebar templ.Component
	// MobileNav is the below-lg mobile navigation slot (typically
	// display.Drawer). Optional.
	MobileNav templ.Component
	// Header is the sticky top header slot (typically navigation.Nav). Optional.
	Header templ.Component
	// HeaderActions is rendered on the right side of the PageHeader (above
	// the stat grid). Use it for "Add" buttons, filters, or time-range
	// pickers. Optional.
	HeaderActions templ.Component
	// StatCards is the slice of display.StatCard components rendered in a
	// responsive 4-up grid at the top of the dashboard body.
	StatCards []templ.Component
	// Charts is the slice of chart/visualization components rendered below
	// the stat grid in a responsive 2-up grid. Each chart should be wrapped
	// in a display.Card by the consumer.
	Charts []templ.Component
	// SidebarWidth controls the AppShell sidebar width. Default
	// layout.SidebarWidthMD (16rem).
	SidebarWidth layout.SidebarWidth
}

type LoginCardProps struct {
	utils.BaseProps

	// Title renders as the card header. Default: "Sign in".
	Title string
	// Subtitle renders as muted text under the Title. Optional.
	Subtitle string
	// FormBody is the main form content (email + password + submit button).
	// Typically a forms.Form with Layout: forms.FormLayoutStack. Required.
	FormBody templ.Component
	// OAuthButtons renders below the form body, separated by a divider.
	// Use it for "Continue with Google/GitHub" buttons. Optional.
	OAuthButtons templ.Component
	// Footer renders below everything (typically "Don't have an account?
	// Sign up"). Optional.
	Footer templ.Component
}

type SettingsLayoutProps struct {
	utils.BaseProps

	// Title and Subtitle render at the top of the page.
	Title    string
	Subtitle string
	// Aside is the section navigation slot (typically a Card-wrapped list
	// of links to #section-id anchors). Required.
	Aside templ.Component
	// Sections is the list of form sections rendered in the main column.
	// Each section is rendered as a Card with Title + a form body. The
	// Section.ID becomes the card's id (for anchor navigation from Aside).
	Sections []SettingsSection
}

type SettingsSection struct {
	// ID is used as the anchor target (id attribute) so the Aside links
	// can jump to it. Optional but recommended.
	ID string
	// Title renders as the Card header.
	Title string
	// Subtitle renders as muted text under the Title. Optional.
	Subtitle string
	// Body is the form content of the section. Typically a forms.Form
	// or a Card.Body slot. Required.
	Body templ.Component
}