genmonarch

type Action struct {
	// Token is the single token class to emit.
	Token string
	// Tokens is one token class per capture group; mutually exclusive with Token.
	Tokens []string
	// Next is the state to enter: a state name, `@pop`, or `@push`.
	Next string
	// Cases selects between actions by testing the match against word lists.
	Cases *Cases
}

type Bracket struct {
	Open  string `json:"open"`
	Close string `json:"close"`
	Token string `json:"token"`
}

type Bundle struct {
	Spec           Spec
	Languages      map[string]Language
	Configurations map[string]Configuration
	Conformance    []ConformanceCase
	// Order lists the language ids deterministically, for stable file output.
	Order []string
}

type CELSpec struct {
	// Namespaces are the dotted prefixes in use: k8s, math, time, ...
	Namespaces []string `json:"namespaces"`
	// Keywords are CEL's reserved words.
	Keywords []string `json:"keywords"`
	// Types are the built-in type names usable as identifiers.
	Types []string `json:"types"`
	// Variables are the identifiers the base environment declares.
	Variables []string   `json:"variables,omitempty"`
	Macros    []Macro    `json:"macros"`
	Functions []Function `json:"functions"`
}

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

type Comments struct {
	LineComment  string    `json:"lineComment,omitempty"`
	BlockComment [2]string `json:"blockComment,omitempty"`
}

type Configuration struct {
	Comments         *Comments   `json:"comments,omitempty"`
	Brackets         [][2]string `json:"brackets,omitempty"`
	AutoClosingPairs []Pair      `json:"autoClosingPairs,omitempty"`
	SurroundingPairs []Pair      `json:"surroundingPairs,omitempty"`
	// WordPattern decides what counts as one word for completion. Dotted names
	// such as `k8s.isHealthy` must match as a single word or completing them
	// inserts a duplicated namespace.
	WordPattern string `json:"wordPattern,omitempty"`
}

type ConformanceCase struct {
	Language string `json:"language"`
	Source   string `json:"source"`
	// Boundaries are 0-based offsets where a token starts, excluding
	// whitespace, in ascending order.
	Boundaries []int `json:"boundaries"`
	// Origin records where the snippet came from, so a failure is traceable.
	Origin string `json:"origin"`
}

type Delimiters struct {
	Left  string `json:"left"`
	Right string `json:"right"`
	// LeftComment and RightComment open and close a comment *inside* an action.
	LeftComment  string `json:"leftComment"`
	RightComment string `json:"rightComment"`
	// TrimMarker abuts a delimiter to trim surrounding whitespace.
	TrimMarker string `json:"trimMarker"`
}

type Function struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace,omitempty"`
	// MemberOnly marks a function callable only as `x.f()`, never as `f(x)`.
	// The tokenizer uses this to colour `x.sum()` without colouring a bare
	// `sum`, which in CEL is just an identifier.
	MemberOnly bool   `json:"memberOnly,omitempty"`
	Doc        string `json:"doc,omitempty"`
	// Signature is the Go signature, for go-template functions.
	Signature string     `json:"signature,omitempty"`
	Overloads []Overload `json:"overloads,omitempty"`
	Examples  []string   `json:"examples,omitempty"`
}

type GoTemplateSpec struct {
	// Namespaces are the dotted prefixes: strings, coll, conv, ...
	Namespaces []string `json:"namespaces"`
	// Keywords are text/template's action keywords.
	Keywords []string `json:"keywords"`
	// Builtins are the functions text/template provides itself.
	Builtins []string `json:"builtins"`
	// Delimiters are text/template's defaults.
	Delimiters Delimiters `json:"delimiters"`
	Functions  []Function `json:"functions"`
}

type Host string

type Language struct {
	ID           string    `json:"-"`
	DefaultToken string    `json:"defaultToken"`
	TokenPostfix string    `json:"tokenPostfix"`
	Start        string    `json:"start,omitempty"`
	Brackets     []Bracket `json:"brackets,omitempty"`
	// Attributes are the named word lists a rule refers to as `@name`. Order
	// within a list is irrelevant; the lists are sorted for a stable diff.
	Attributes map[string][]string `json:"-"`
	// Tokenizer holds the states. `root` is the entry state.
	Tokenizer *States `json:"tokenizer"`
}

type Macro struct {
	Name          string   `json:"name"`
	ArgCount      int      `json:"argCount"`
	ReceiverStyle bool     `json:"receiverStyle"`
	Doc           string   `json:"doc,omitempty"`
	Examples      []string `json:"examples,omitempty"`
}

type Overload struct {
	ID     string   `json:"id"`
	Args   []string `json:"args"`
	Result string   `json:"result"`
	Member bool     `json:"member,omitempty"`
}

type Pair struct {
	Open  string `json:"open"`
	Close string `json:"close"`
}

type Rule struct {
	// Regex is JS regex source, without delimiters.
	Regex string
	// Action fires when Regex matches.
	Action Action
	// Include names a state to splice in, e.g. `@whitespace`. When set, the
	// rest of the rule is ignored.
	Include string
}

type Spec struct {
	CEL        CELSpec        `json:"cel"`
	GoTemplate GoTemplateSpec `json:"gotemplate"`
}

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