deck

type Background struct {
	URL    string
	Alt    string
	Size   string
	Filter string
}

type Deck struct {
	// Global holds the global directives, last value written winning.
	Global Global
	// Slides are the slides in order.
	Slides []*Slide
	// Styles are the deck's global CSS additions in order: the style
	// directive first, then every unscoped <style> element.
	Styles []string
	// Front is the front matter decoded with YAML's core schema, for
	// templates and tools; directives come from Global and Slide.Dirs.
	Front map[string]any
	// Kinds are the kinds the deck could use.
	Kinds Kinds
	// contains filtered or unexported fields
}

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

type Frame int

type Global struct {
	Dirs Dirs
	// HeadingDivider lists the heading levels that start a new slide.
	HeadingDivider []int
}

type HTMLPolicy int

type Heading struct {
	Level int
	Text  string
	ID    string
}

type Kind struct {
	Name string
	// Extends names a kind whose directives this one starts from.
	Extends string
	// Dirs are the kind's own directives, already normalized.
	Dirs Dirs
}

type Kinds map[string]*Kind

type MathBlock struct {
	gast.BaseBlock
	Tex string
}

type MathInline struct {
	gast.BaseInline
	Tex string
}

type Options struct {
	// Data is template data; it overrides the front matter's keys and its
	// data mapping.
	Data map[string]any
	// Kinds add to (and override) the built-in kinds; the deck's own
	// kinds front-matter key overrides these in turn.
	Kinds Kinds
	// NoTemplate turns template interpolation off.
	NoTemplate bool
	// BaseDir resolves relative paths: included files and kinds files.
	BaseDir string
	// StrictYAML turns off loose YAML parsing of directives (Marp Core
	// turns it on; plain Marpit leaves it off).
	StrictYAML bool
	// Now is the template clock; nil means time.Now.
	Now func() time.Time
	// Name names the deck in error messages.
	Name string
}

type RenderOptions struct {
	Frame Frame
	HTML  HTMLPolicy
	// Lang is the lang attribute when no lang directive sets one.
	Lang string
	// Width and Height are the slide size in pixels, from the theme.
	Width, Height int
	// Highlight, when set, renders a fenced code block's content; ok false
	// falls back to plain escaped code.
	Highlight func(code, lang string) (htmlOut string, ok bool)
	// GeneratedContent, when set, writes elements that stand for the
	// ::after pseudo-element Marpit paginates with, for layout engines
	// without generated content: <span data-slides-pseudo="after">.
	GeneratedContent bool
	// Math, when set, typesets a formula ($…$ inline, $$…$$ display) to
	// HTML; nil leaves formulas as the text they were written as.
	Math func(tex string, display bool) (string, error)
	// AfterContent is the theme's section::after content expression (see
	// theme.Packed.After); the element writes its value. Empty means the
	// page number alone, Marpit's scaffold.
	AfterContent string
}

type Rendered struct {
	Slide *Slide
	// HTML is the slide's markup, frame included.
	HTML string
}

type Slide struct {
	// Index is the slide's position, from 0.
	Index int
	// Kind is the kind the slide was given, "" if none.
	Kind string
	// Dirs are the local and spot directives in effect on the slide.
	Dirs Dirs
	// Page is the page number as Marpit counts it: slides whose paginate
	// directive is skip or hold do not advance it.
	Page int
	// Total is the last page number of the deck.
	Total int
	// Paginated reports whether the page number is shown.
	Paginated bool
	// Notes are the speaker notes: the slide's HTML comments that are not
	// directives.
	Notes []string
	// Fragments counts the fragmented list items.
	Fragments int
	// Backgrounds are the slide's background images, in order.
	Backgrounds []Background
	// BackgroundSplit is "left" or "right" when the backgrounds take one
	// side of the slide, and BackgroundSplitSize the width they take.
	BackgroundSplit, BackgroundSplitSize string
	// BackgroundDirection is "horizontal" (the default) or "vertical".
	BackgroundDirection string
	// ScopedStyles are the slide's <style scoped> contents.
	ScopedStyles []string
	// Headings are the slide's headings, for outlines.
	Headings []Heading
	// contains filtered or unexported fields
}