refs

type DirEntry struct {
	Name  string
	IsDir bool
	Size  int64
	Mode  string
}

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

type ExpansionResult struct {
	// Original is the original input message.
	Original string

	// Expanded is the message with reference content appended.
	Expanded string

	// RefsFound is the list of references found.
	RefsFound []ParsedRef

	// RefsExpanded maps reference raw values to their expanded content.
	RefsExpanded map[string]string

	// Warnings contains warning messages for invalid refs.
	Warnings []string

	// Truncated indicates which refs were truncated.
	Truncated []string
}

type LineRange struct {
	Start int
	End   int
}

type ParsedRef struct {
	Type      RefType
	RawValue  string     // Original @ref string including the type prefix
	Value     string     // Parsed value (path, URL, etc.)
	LineRange *LineRange // For @file:path:start-end
}

type RefType string

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