core

type Action struct {
	Name   string   // the name of the action -- e.g, 'replace'
	Params []string // a slice of parameters for the given action
}

type Alert struct {
	Action         Action   // a possible solution
	Span           []int    // the [begin, end] location within a line
	Offset         []string `json:"-"` // tokens to ignore before this match
	Check          string   // the name of the check
	Description    string   // why `Message` is meaningful
	Link           string   // reference material
	Message        string   // the output message
	Severity       string   // 'suggestion', 'warning', or 'error'
	Match          string   // the actual matched text
	Line           int      // the source line
	Limit          int      `json:"-"` // the max times to report
	Hide           bool     `json:"-"` // should we hide this alert?
	HasByteOffsets bool     `json:"-"` // Span holds byte offsets into the raw document
	// contains filtered or unexported fields
}

type ByName []*File

type ByPosition []Alert

type CLIFlags struct {
	AlertLevel    string
	Built         string
	Glob          string
	InExt         string
	InPath        string
	Output        string
	Path          string
	Sources       string
	Filter        string
	Apply         bool
	Counts        bool
	Local         bool
	NoExit        bool
	NoColor       bool
	PlainProgress bool
	Normalize     bool
	Relative      bool
	Remote        bool
	Simple        bool
	Sorted        bool
	Wrap          bool
	Version       bool
	Help          bool
	IgnoreGlobal  bool
}

type Config struct {
	// General configuration
	BlockIgnores      map[string][]string          // A list of blocks to ignore
	Checks            []string                     // All checks to load
	Formats           map[string]string            // A map of unknown -> known formats
	Asciidoctor       map[string]string            // A map of asciidoctor attributes
	FormatToLang      map[string]string            // A map of format to lang ID
	GBaseStyles       []string                     // Global base style
	GChecks           map[string]bool              // Global checks
	IgnoredClasses    []string                     // A list of HTML classes to ignore
	IgnoredScopes     []string                     // A list of HTML tags to ignore
	MinAlertLevel     int                          // Lowest alert level to display
	Vocab             []string                     // The active project
	RuleToLevel       map[string]string            // Single-rule level changes
	RuleToParams      map[string]map[string]string // Single-rule scalar overrides
	SBaseStyles       map[string][]string          // Syntax-specific base styles
	SChecks           map[string]map[string]bool   // Syntax-specific checks
	SLevels           map[string]map[string]string // Syntax-specific level changes
	SkippedScopes     []string                     // A list of HTML blocks to ignore
	Stylesheets       map[string]string            // XSLT stylesheet
	TokenIgnores      map[string][]string          // A list of tokens to ignore
	CommentDelimiters map[string][2]string         // Strings to treat as comment delimiters. Indicates the start and end delimiters.
	WordTemplate      string                       // The template used in YAML -> regexp list conversions
	RootINI           string                       // the path to the project's .vale.ini file
	Paths             []string                     // A list of paths to search for styles
	ConfigFiles       []string                     // A list of configuration files to load

	AcceptedTokens []string `json:"-"` // Project-specific vocabulary (okay)
	RejectedTokens []string `json:"-"` // Project-specific vocabulary (avoid)

	FallbackPath string               `json:"-"`
	SecToPat     map[string]glob.Glob `json:"-"`
	Styles       []string             `json:"-"`
	Views        map[string]*View     `json:"-"`

	NLPEndpoint string // An external API to call for NLP-related work.

	// Command-line configuration
	Flags *CLIFlags `json:"-"`

	StyleKeys []string `json:"-"`
	RuleKeys  []string `json:"-"`
}

type ConfigSrc int

type DaselValue = any

type File struct {
	NLP        nlp.Info          // -
	Summary    bytes.Buffer      // holds content to be included in summarization checks
	Alerts     []Alert           // all alerts associated with this file
	BaseStyles []string          // base style assigned in .vale
	Lines      []string          // the File's Content split into lines
	Sequences  []string          // tracks various info (e.g., defined abbreviations)
	Content    string            // the raw file contents
	Format     string            // 'code', 'markup' or 'prose'
	NormedExt  string            // the normalized extension (see util/format.go)
	Path       string            // the full path
	NormedPath string            // the normalized path
	Transform  string            // XLST transform
	RealExt    string            // actual file extension
	Checks     map[string]bool   // syntax-specific checks assigned in .vale
	ChkToCtx   map[string]string // maps a temporary context to a particular check

	// Levels holds the level each rule was given by the sections matching this
	// file, which is not the same as the level it was compiled with: the same
	// rule can be an error in one format and a warning in another. See #965.
	Levels map[string]string

	Comments map[string]bool // comment control statements
	Metrics  map[string]int  // count-based metrics

	Lookup    bool   // -
	MetaScope string // extra scope context, e.g. a YAML key or comment
	// contains filtered or unexported fields
}

type Scope struct {
	Name string `yaml:"name"`
	Expr string `yaml:"expr"`
	Type string `yaml:"type"`
}

type ScopedValue struct {
	Text   string
	Line   int
	Column int
}

type ScopedValues struct {
	Scope  string
	Format string
	Values []ScopedValue
}

type View struct {
	Engine string  `yaml:"engine"`
	Scopes []Scope `yaml:"scopes"`
}