features

type Alias struct {
	Name      string // Alternative name (e.g., "average of", "round trip time")
	Parseable bool   // true if this alias works as input syntax, false if search-only
	Example   string // Concrete NL example for autosuggest (e.g., "average of 1, 2, 3")
}

type Category string

type Feature struct {
	Name        string            // Primary name (e.g., "avg", "meter", "today")
	Category    Category          // Type of feature (function, unit, keyword, etc.)
	Subcategory string            // Grouping within category for help display (e.g., "Math", "Network", "Storage")
	Quantity    string            // Unit category for units (e.g., "Force", "Length"); empty for non-unit features
	Syntax      string            // Usage syntax (e.g., "avg(a, b, c)")
	Description string            // Human-readable description
	Aliases     []Alias           // Alternative names/spellings
	Synonyms    []string          // Runtime-dispatchable alternative names (e.g., "average", "mean" for "avg")
	Params      []types.ParamSpec // Parameter specifications for functions (empty for non-functions)
	Example     string            // Example usage (function-call form for help display)
	NLExample   string            // Natural language example for autosuggest (e.g., "100 MB/s over 1 day")
	// InsertText is the literal text to insert when the user accepts
	// this completion. When empty, suggestion-builders fall back to
	// `Name`. Use the LSP `${N:default}` snippet syntax for entries
	// that need user-fillable placeholders (e.g., year-bearing date
	// literals like `FY${1:NNNN}`). When set, downstream LSP layers
	// flag the resulting completion item as InsertTextFormat: Snippet.
	InsertText string
}

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

type Suggestion struct {
	Name         string // Display name (may include synonyms for display)
	Category     string // Category (function, unit, variable, etc.)
	Description  string // Brief description
	Syntax       string // Syntax example
	InsertText   string // Actual text to insert (without synonyms/formatting)
	FunctionName string // Canonical function name for spec lookup (set only for function suggestions)
	SortCategory string // Override category for sorting (e.g., NL rows use parent fn category)
}

type SuggestionSource interface {
	// GetSuggestions returns suggestions matching the given prefix.
	GetSuggestions(prefix string) []Suggestion
}