render

type Content struct {
	Pages []InputPage `json:"pages"`
	// StyleCSS is the in-memory counterpart of the CLI project's style.css.
	StyleCSS string `json:"styleCSS"`
	// Assets declares the user assets the caller will serve alongside the
	// rendered site (custom font files under static/fonts/, and in the future
	// other referenced static files). Entries are validated with the shared
	// manifest rules and merged into the output manifest; an entry whose
	// effective output path collides with a built-in replaces it (the
	// favicon-override rule).
	Assets []assets.Asset `json:"assets"`
}

type FooterAttribution struct {
	Name string `json:"name"`
	URL  string `json:"url"`
}

type Input struct {
	// ContractVersion is optional; 0 means latest. An unknown version is
	// rejected rather than guessed at.
	ContractVersion int `json:"contractVersion"`
	// Config is the shared configuration object — the same schema the CLI
	// reads from leafpress.json. Absent/empty renders the default site.
	Config json.RawMessage `json:"config"`
	// Render holds the only host-only concerns: the garden identity slug and
	// optional white-label footer attribution.
	Render RenderOpts `json:"render"`
	// Content carries the in-memory equivalents of the filesystem inputs a
	// CLI build reads: the pages, the stylesheet, and declared user assets.
	Content Content `json:"content"`
	// Options carries render toggles.
	Options Options `json:"options"`
}

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

type InputPage struct {
	Slug        string   `json:"slug"`
	Title       string   `json:"title"` // optional; defaults to Slug
	Markdown    string   `json:"markdown"`
	Tags        []string `json:"tags"`
	CreatedAt   string   `json:"createdAt"` // optional RFC3339
	UpdatedAt   string   `json:"updatedAt"` // optional RFC3339
	Description string   `json:"description"`
	Growth      string   `json:"growth"`
	TOC         *bool    `json:"toc"`
	Image       string   `json:"image"`
	ReadingTime *int     `json:"readingTime"`
	// IsIndex marks a section home (the CLI's _index.md): Slug is the
	// section path itself, Markdown becomes the intro above the child
	// listing. An IsIndex page with slug "" is the garden home.
	IsIndex bool `json:"isIndex"`
	// Sort orders the child listing of an index page: date (default) |
	// title | growth. Mirrors the _index.md `sort` frontmatter key.
	Sort string `json:"sort"`
	// ShowList toggles the child listing of an index page (default true).
	// Mirrors the _index.md `showList` frontmatter key.
	ShowList *bool `json:"showList"`
}

type Options struct {
	// EmitAssets requests base64 artifacts for the built-in assets the
	// rendered site requires. The asset manifest is always emitted; bytes are
	// opt-in so routine renders stay small. Synchronization is hash-driven per
	// manifest entry — the registry ID alone is never a valid skip signal,
	// because the manifest is a theme-dependent subset.
	EmitAssets bool `json:"emitAssets"`
}

type Output struct {
	Pages    []OutputPage    `json:"pages"`
	Index    string          `json:"index"`
	Sections []OutputSection `json:"sections"`
	Tags     OutputTags      `json:"tags"`
	CSS      string          `json:"css"`
	// AssetManifest is the combined manifest of every asset the rendered
	// site requires: referenced built-ins plus caller-declared assets, with
	// caller entries replacing built-ins on output-path collision. Metadata
	// only, never bytes. Hosted consumers materialize each entry through
	// their own storage using the content hash; built-in entries also
	// appear as base64 artifacts when the input sets options.emitAssets.
	AssetManifest assets.Manifest `json:"assetManifest"`
	// AssetRegistryID identifies the built-in registry snapshot the manifest
	// came from (content-derived). It is a change signal only — the manifest
	// is a theme-dependent subset, so synchronization stays hash-driven per
	// entry, never keyed on this ID.
	AssetRegistryID string           `json:"assetRegistryId"`
	Artifacts       []OutputArtifact `json:"artifacts"`
	Warnings        []string         `json:"warnings"`
}

type OutputArtifact struct {
	Path        string `json:"path"`
	Content     string `json:"content"`
	ContentType string `json:"contentType"`
	// Encoding says how Content encodes the file bytes and is authoritative
	// (never sniff): generated site artifacts are always "utf8"; asset
	// artifacts emitted under options.emitAssets are always "base64" regardless
	// of MIME type (OFL license texts included).
	Encoding string `json:"encoding"`
}

type OutputPage struct {
	Slug string `json:"slug"`
	HTML string `json:"html"`
}

type OutputSection struct {
	Slug string `json:"slug"`
	HTML string `json:"html"`
}

type OutputTagPage struct {
	Tag  string `json:"tag"`
	HTML string `json:"html"`
}

type OutputTags struct {
	Index string          `json:"index"`
	Pages []OutputTagPage `json:"pages"`
}

type RenderOpts struct {
	// Slug is the hosted garden's identity/routing key. It has no natural
	// default; when omitted it defaults to "garden" with a warning.
	Slug string `json:"slug"`
	// FooterAttribution is renderer-only white-label branding, deliberately
	// structured instead of accepting raw HTML or script content.
	FooterAttribution *FooterAttribution `json:"footerAttribution,omitempty"`
}