internal

type Config struct {
	Smarterr     *Smarterr    `hcl:"smarterr,block"`
	Tokens       []Token      `hcl:"token,block"`
	Hints        []Hint       `hcl:"hint,block"`
	Parameters   []Parameter  `hcl:"parameter,block"`
	StackMatches []StackMatch `hcl:"stack_match,block"`
	Templates    []Template   `hcl:"template,block"`
	Transforms   []Transform  `hcl:"transform,block"`
}

type ContextKey string

type FileSystem interface {
	Open(name string) (fs.File, error)
	ReadFile(name string) ([]byte, error)
	WalkDir(root string, fn fs.WalkDirFunc) error
	Exists(name string) bool
}

type Hint struct {
	Name          string  `hcl:"name,label"`
	ErrorContains *string `hcl:"error_contains,optional"`
	RegexMatch    *string `hcl:"regex_match,optional"`
	Suggestion    string  `hcl:"suggestion"`
}

type Parameter struct {
	Name  string `hcl:"name,label"`
	Value string `hcl:"value,attr"`
}

type Runtime struct {
	Config     *Config
	Args       map[string]any
	Error      error
	Diagnostic diag.Diagnostic // single diagnostic for enrichment context
}

type Smarterr struct {
	Debug          bool    `hcl:"debug,optional"`
	TokenErrorMode *string `hcl:"token_error_mode,optional"` // "detailed", "placeholder", "empty" (default: "empty")
	HintJoinChar   *string `hcl:"hint_join_char,optional"`
	HintMatchMode  *string `hcl:"hint_match_mode,optional"` // "all" (default), "first"
}

type StackMatch struct {
	Name       string `hcl:"name,label"`
	CalledFrom string `hcl:"called_from,optional"`
	Display    string `hcl:"display"`
}

type Template struct {
	Name   string `hcl:"name,label"`
	Format string `hcl:"format"`
}

type Token struct {
	Name            string              `hcl:"name,label"`
	Source          string              `hcl:"source,optional"`
	Parameter       *string             `hcl:"parameter,optional"`
	StackMatches    []string            `hcl:"stack_matches,optional"`
	Arg             *string             `hcl:"arg,optional"`
	Context         *string             `hcl:"context,optional"`
	Transforms      []string            `hcl:"transforms,optional"`
	FieldTransforms map[string][]string `hcl:"field_transforms,optional"`
}

type Transform struct {
	Name  string          `hcl:"name,label"`
	Steps []TransformStep `hcl:"step,block"`
}

type TransformStep struct {
	Type    string  `hcl:"type,label"`
	Value   *string `hcl:"value,optional"`
	Regex   *string `hcl:"regex,optional"`
	With    *string `hcl:"with,optional"`
	Recurse *bool   `hcl:"recurse,optional"`
}

type WrappedFS struct {
	FS fs.FS
}