parser

type ASTContent struct {
	Headings  []Heading
	Traits    []TraitAnnotation
	Refs      []Reference
	TypeDecls map[int]*EmbeddedTypeInfo // heading line -> type decl
}

type EmbeddedTypeInfo struct {
	TypeName string
	ID       string
	Fields   map[string]schema.FieldValue
	// Line is the 1-indexed line number of the ::type(...) declaration in the file.
	// This is the declaration line (not the heading line).
	Line int
}

type ExtractedRef struct {
	TargetRaw   string
	DisplayText *string
}

type FenceState struct {
	InFence  bool
	FenceCh  byte
	FenceLen int
}

type Frontmatter struct {
	// ObjectType is the type field (if present).
	ObjectType string

	// Fields are all other fields.
	Fields map[string]schema.FieldValue

	// Raw is the raw frontmatter content.
	Raw string

	// EndLine is the line where frontmatter ends (1-indexed).
	EndLine int
}

type Heading struct {
	Level int
	Text  string
	Line  int // 1-indexed
}

type ParseOptions struct {
	// ObjectsRoot is the root directory for typed objects (e.g., "objects/").
	// If set, this prefix is stripped from file paths when computing object IDs.
	ObjectsRoot string

	// PagesRoot is the root directory for untyped pages (e.g., "pages/").
	// If set, this prefix is stripped from file paths when computing object IDs.
	PagesRoot string
}

type ParsedDocument struct {
	FilePath   string          // File path relative to vault
	RawContent string          // Raw markdown content
	Body       string          // Content without frontmatter (for full-text search indexing)
	Objects    []*ParsedObject // All objects in this document
	Traits     []*ParsedTrait  // All traits in this document
	Refs       []*ParsedRef    // All references in this document
}

type ParsedObject struct {
	ID           string                       // Unique ID (path for file-level, path#id for embedded)
	ObjectType   string                       // Type name
	Fields       map[string]schema.FieldValue // Fields/metadata
	Heading      *string                      // Heading text (for embedded objects)
	HeadingLevel *int                         // Heading level (for embedded objects)
	ParentID     *string                      // Parent object ID (for embedded objects)
	LineStart    int                          // Line where this object starts
	LineEnd      *int                         // Line where this object ends (embedded only)
}

type ParsedRef struct {
	SourceID    string  // Source object ID
	TargetRaw   string  // Raw target (as written)
	DisplayText *string // Display text
	Line        int     // Line number
	Start       int     // Start position
	End         int     // End position
}

type ParsedTrait struct {
	TraitType      string             // Trait type name (e.g., "due", "priority", "highlight")
	Value          *schema.FieldValue // Trait value (nil for boolean traits)
	Content        string             // The content the trait annotates
	ParentObjectID string             // Parent object ID
	Line           int                // Line number
}

type RefExtractOptions struct {
	// AllowBareStrings treats plain strings as ref targets.
	AllowBareStrings bool
	// AllowWikilinksInString scans string values for wikilink references.
	AllowWikilinksInString bool
	// AllowTripleBrackets passes allowTriple=true to the wikilink parser.
	AllowTripleBrackets bool
}

type Reference struct {
	TargetRaw   string  // The raw target (as written)
	DisplayText *string // Display text (if different from target)
	Line        int     // Line number where found (1-indexed)
	Start       int     // Start position in line
	End         int     // End position in line
}

type TraitAnnotation struct {
	TraitName string
	// Value is the single trait value (nil for boolean traits like @highlight)
	Value       *schema.FieldValue
	Content     string // Full line content with all trait annotations removed
	Line        int
	StartOffset int
	EndOffset   int
}

type TypeDeclaration struct {
	TypeName string
	ID       string
	Fields   map[string]schema.FieldValue
	Line     int
}