build

type BuildError struct {
	Type    string // "template", "frontmatter", "markdown", "build"
	File    string // relative file path
	Line    int    // 1-based line number
	Col     int    // 1-based column number
	Message string // error message
	Frame   string // ±3 lines of source context
}

type BuildOptions struct {
	ProjectDir      string
	Config          *config.SiteConfig
	ThemeConfig     *engine.ThemeConfig
	EmbeddedFS      fs.FS
	DevMode         bool   // Skip heavy optimizations during serve (image processing, minification, etc.)
	CheckSyntax     bool   // When true, run fenced-block syntax checking during markdown rendering
	PluginAssetsDir string // If set, recompute plugin client bundles from disk (theme-dev mode)
}

type CacheEntry struct {
	ContentHash    string                 `json:"content_hash"`
	HTML           string                 `json:"html"`
	Headings       []engine.Heading       `json:"headings"`
	HasCodeBlocks  bool                   `json:"has_code_blocks,omitempty"`
	HasImages      bool                   `json:"has_images,omitempty"`
	Links          []engine.CollectedLink `json:"links,omitempty"`
	PendingAnchors []CachedAnchorCheck    `json:"pending_anchors,omitempty"`
	Refs           []CachedLinkRef        `json:"refs,omitempty"`
}

type CachedAnchorCheck struct {
	TargetPermalink    string         `json:"target_permalink"`
	TargetRelPermalink string         `json:"target_rel_permalink,omitempty"`
	Fragment           string         `json:"fragment"`
	RawHref            string         `json:"raw_href"`
	Kind               links.LinkKind `json:"kind"`
	Resolved           string         `json:"resolved"`
}

type CachedLinkRef struct {
	RawDest            string           `json:"raw_dest"`
	Kind               links.LinkKind   `json:"kind"`
	Resolved           string           `json:"resolved"`
	TargetPermalink    string           `json:"target_permalink,omitempty"`
	TargetRelPermalink string           `json:"target_rel_permalink,omitempty"`
	Fragment           string           `json:"fragment,omitempty"`
	Status             links.LinkStatus `json:"status"`
}

type CheckOptions struct {
	External     bool   // enable external URL probing
	Strict       bool   // override all policies to "error"
	ReportFormat string // override report format ("pretty" | "json" | "github-actions")
}

type CheckResult struct {
	PageCount int
	LinkCount int
	Lanes     int
	HasErrors bool
	Findings  []links.Finding
	Warnings  []engine.ValidationWarning
	Output    string // formatted report output
	Summary   string
	Duration  time.Duration
}

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

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

type PageCache struct {
	Dir string
	// contains filtered or unexported fields
}

type RenderedPage struct {
	Page    *engine.Page
	HTML    []byte
	OutPath string // relative to output dir (e.g., "docs/intro/index.html")
}

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

type ValidateResult struct {
	PageCount   int
	Collections int
	Warnings    []engine.ValidationWarning
	Pages       []*engine.Page
	Duration    time.Duration
}

type Writer struct {
	OutputDir  string
	ProjectDir string
	Tracker    *OutputTracker
}