vast

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

type Context struct {
	// The validation-ready AST
	Tree *Tree

	// Schema reference (Tree.Document provides document access)
	Schema *schema.Schema

	// RootDir is the root directory for resolving absolute paths (e.g., /path links).
	// Typically the directory containing .mdschema.yml.
	RootDir string
	// contains filtered or unexported fields
}

type Node struct {
	// Schema binding
	Element schema.StructureElement

	// Document binding (may be nil if required element is missing)
	Section *parser.Section

	// Semantic parent-child relationships (schema-driven, not heading-level-driven)
	Parent   *Node
	Children []*Node

	// Pre-computed validation state
	IsBound bool // True if a matching section was found

	// Ordering metadata
	Order       int // Expected order (position in schema)
	ActualOrder int // Actual order in document (line number for ordering violations)

	// Count tracking for multi-match elements
	MatchCount int // Total matches found for this element (0 if not multi-match)
	MatchIndex int // This node's index (0-based) among siblings with same element
}

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

type Tree struct {
	// Root nodes (top-level schema elements)
	Roots []*Node

	// Document reference for context
	Document *parser.Document

	// All nodes flattened for iteration
	AllNodes []*Node

	// Unmatched sections (sections in document but not in schema)
	UnmatchedSections []*parser.Section
}