compiler

Nov 2, 2026

Changes in this version

+ func BindExpressionValue(ctx context.Context, name string, value any) error

+ func HasExpressionScope(ctx context.Context) bool

+ func ValidateExpressionBindingName(name string) error

+ func WithChildExpressionScope(ctx context.Context) context.Context

+ func WithChildExpressionScopeAction(inner action.AnyAction) action.AnyAction

+ func WithExpressionScope(ctx context.Context, input any) context.Context

+ func WithExpressionScopeAction(inner action.AnyAction) action.AnyAction

+ type BindingExpr struct

+ Inner Expr

+ Name string

+ Pos Position

+ func (*BindingExpr) Node()

+ func (b *BindingExpr) Analyze(r CapabilityResolver) error

+ func (b *BindingExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (b *BindingExpr) Children() []Expr

Nov 1, 2026

Changes in this version

+ func SetExpressionCompiler(meta map[string]any, expressionCompiler ExpressionCompiler)

type BuildContext

+ ExpressionCompiler ExpressionCompiler

+ func (b *BuildContext) CompileExpression(source string, position Position) (ExpressionProgram, error)

type CompileOption

+ func WithExpressionCompiler(expressionCompiler ExpressionCompiler) CompileOption

+ type ExpressionCompiler interface

+ Compile func(source string, position Position) (ExpressionProgram, error)

+ func ExpressionCompilerFromMeta(meta map[string]any) ExpressionCompiler

+ type ExpressionProgram interface

+ Evaluate func(context.Context, any) (any, error)

+ EvaluateEnvironment func(context.Context, map[string]any) (any, error)

+ func CompileRuntimeExpression(source string, position Position, expressionCompiler ExpressionCompiler) (ExpressionProgram, error)

type Value

+ Expression string

+ Program ExpressionProgram

type ValueKind

+ const ValueExpression

Nov 1, 2026

Changes in this version

+ type QualifiedTokenPrimary interface

+ ParseQualified func(p *Parser, qualifier string) (Expr, error)

Oct 31, 2026

Changes in this version

+ type ArgumentMapExpander interface

+ ExpandArgumentMap func(p *Parser, raw string) (string, error)

type Atom

+ ArgSpreads []*Value

Oct 30, 2026

Changes in this version

type Atom

+ HasArgumentObject bool

+ NamedPipelineArgs bool

Oct 30, 2026

Changes in this version

+ func ResolveSymbolDeclaration(meta map[string]any, reference string) (any, bool)

+ func RuntimeSymbolValue(value any) any

type Atom

+ ModifierValues []ModifierValue

+ ParamValues map[string]any

type DecoratedExpr

+ ModifierValues []ModifierValue

type LineLookup

+ ValueFn func(line int) []ModifierValue

type MaterializeReq

+ CompileValues func(name, source string, modifiers []ModifierValue) (action.AnyAction, error)

type Modifier

+ ApplyNative func(b *action.Builder[any, any], value any) error

type ModifierTable

+ func (t *ModifierTable) ApplyAllValues(target action.AnyAction, values []ModifierValue) (action.AnyAction, error)

+ type ModifierValue struct

+ Quoted bool

+ Raw string

+ Typed bool

+ Value any

+ type TypedSymbolValue struct

+ Type string

+ Value any

Oct 30, 2026

Changes in this version

+ func ResolveSymbolValue(meta map[string]any, reference string) (any, bool)

type DeclarationHeader

+ QuotedModifiers []bool

Oct 30, 2026

Changes in this version

+ type BlockEntry struct

+ Span SourceSpan

+ Text string

+ type BlockRead struct

+ Body []string

+ BodySpan SourceSpan

+ Entries []BlockEntry

+ Next int

+ Span SourceSpan

+ func ReadBlockWithSpans(lines []string, start int) (BlockRead, error)

+ type DeclarationHeader struct

+ HeaderSpan SourceSpan

+ KeywordSpan SourceSpan

+ Modifiers []string

+ Name string

+ NameSpan SourceSpan

+ Next int

+ func ParseDeclarationHeaderWithSpans(req DirectiveReq, directive string) (DeclarationHeader, error)

type DirectiveReq

+ ImportAt func(target, namespace string, span, targetSpan, namespaceSpan SourceSpan) error

+ func (req DirectiveReq) DeclareAt(kind, name string, keyword, nameSpan, span SourceSpan) error

+ func (req DirectiveReq) DeclareInAt(space, kind, name string, keyword, nameSpan, span SourceSpan) error

+ func (req DirectiveReq) LineSpan(line int) SourceSpan

+ func (req DirectiveReq) Offset(line, column int) int

+ func (req DirectiveReq) RecordBlock(block SourceBlock)

+ func (req DirectiveReq) RecordDeclaration(declaration SourceDeclaration)

+ func (req DirectiveReq) RecordReference(reference SourceReference)

type Modifier

+ ApplyTarget func(target action.AnyAction, b *action.Builder[any, any], raw string) error

type ModifierKind

+ const ModifierKindJSON

type PreparedSource

+ func PreparedSourceFromPreprocessed(source, name, clean string, meta map[string]any, opts ...CompileOption) *PreparedSource

+ func (p *PreparedSource) CleanSource() string

+ func (p *PreparedSource) SourceIndex() SourceIndex

+ func (p *PreparedSource) SourceText() string

+ type SourceBlock struct

+ BodySpan SourceSpan

+ HeaderSpan SourceSpan

+ Kind string

+ Span SourceSpan

+ type SourceDeclaration struct

+ KeywordSpan SourceSpan

+ Kind string

+ Name string

+ NameSpan SourceSpan

+ Span SourceSpan

type SourceImport

+ NamespaceSpan SourceSpan

+ Span SourceSpan

+ TargetSpan SourceSpan

+ type SourceIndex struct

+ Blocks []SourceBlock

+ Declarations []SourceDeclaration

+ Imports []SourceImport

+ References []SourceReference

+ Tokens []SourceToken

+ func BuildSourceIndex(source string, meta map[string]any) SourceIndex

+ func IndexSource(ctx context.Context, dt *DirectiveTable, source, name string, ...) (SourceIndex, error)

+ func IndexSourceWithMetadata(ctx context.Context, dt *DirectiveTable, source, name string, ...) (SourceIndex, map[string]any, error)

+ type SourceReference struct

+ HasName bool

+ Kind string

+ Modifier string

+ ModifierSpan SourceSpan

+ Name string

+ NameSpan SourceSpan

+ Span SourceSpan

+ Valid bool

+ Value string

+ type SourceSpan struct

+ End int

+ Start int

+ type SourceToken struct

+ InsideProjection bool

+ Span SourceSpan

+ Text string

+ Type TokenType

type Token

+ EndOffset int

Oct 29, 2026

Changes in this version

type SelfTestFeature

+ SyntaxOnly bool

Oct 27, 2026

Changes in this version

+ var ErrRunScopeClosed = errors.New("compiler: run scope is closed")

type Bundle

+ InheritScope ScopeInheritFunc

type CompileOption

+ func WithScopeInheritors(fns ...ScopeInheritFunc) CompileOption

type CompileReq

+ InheritedMeta map[string]any

+ type RunCleanupFunc func(context.Context) error

+ type RunScope struct

+ func NewRunScope(parent context.Context) (context.Context, *RunScope)

+ func RunScopeFromContext(ctx context.Context) (*RunScope, bool)

+ func (s *RunScope) Close(ctx context.Context) error

+ func (s *RunScope) Register(cleanup RunCleanupFunc) (release func(), err error)

+ type ScopeInheritFunc func(parentMeta, childMeta map[string]any) error

Oct 27, 2026

Changes in this version

+ type ASTContextValidateFunc func(ctx context.Context, ast Expr, meta map[string]any) error

type CompileOption

+ func WithASTContextValidators(fns ...ASTContextValidateFunc) CompileOption

Oct 27, 2026

Changes in this version

type Directive

+ OpaqueBlock bool

Oct 24, 2026

Changes in this version

+ func PreprocessWithOptions(ctx context.Context, dt *DirectiveTable, source, name string, ...) (clean string, meta map[string]any, err error)

type Bundle

+ ExportedModules []string

+ SourceModules fs.FS

Oct 24, 2026

Changes in this version

type SelfTestFeature

+ ExpectCompileError string

Oct 22, 2026

Changes in this version

+ func AnalyzeBuildUsage(bundles []Bundle, usages []BuildUsage) ([]string, error)

+ func DeclarationOwner(out map[string]any, kind, name, owner string) string

+ func QualifySourceLibrary(lib action.Library, namespace string, ...) action.Library

+ func WithPreprocessObserver(ctx context.Context, observer PreprocessObserver) context.Context

+ type BuildExtension struct

+ Always bool

+ Modifiers []string

+ Replaces []string

+ Requires []string

+ Sources func(meta map[string]any) []string

+ type BuildSource = BuildUsage

+ type BuildUsage struct

+ Clean string

+ Directives []string

+ File string

+ Metadata map[string]any

+ Raw string

type Bundle

+ Build BuildExtension

+ MaterializePhase MaterializePhase

+ func ResolveBuildBundles(bundles []Bundle, selected []string) ([]Bundle, error)

type DirectiveReq

+ Import func(target, namespace string) error

+ func (req DirectiveReq) Declare(kind, name string) error

+ func (req DirectiveReq) DeclareIn(space, kind, name string) error

+ func (req DirectiveReq) EmbedSource(clean string, metadata map[string]any)

+ type MaterializePhase int

+ const MaterializeCompositions

+ const MaterializeDeclarations

type Position

+ func DeclarationPosition(out map[string]any, space, name string) (Position, bool)

+ type PreprocessEvent struct

+ Clean string

+ Directives []string

+ File string

+ Metadata map[string]any

+ Original string

+ Source string

+ type PreprocessObserver func(PreprocessEvent)

+ type SourceImport struct

+ Namespace string

+ Position Position

+ Source *PreparedSource

+ func SourceImports(out map[string]any) []SourceImport

+ type SourceLine struct

+ Origins []Position

+ func SourceLinesFromMeta(meta map[string]any) []SourceLine

+ type SourceMap map[string]string

+ func (sources SourceMap) Load(currentFile, target string) (data []byte, resolvedPath string, err error)

type Token

+ Unterminated bool

Oct 17, 2026

Changes in this version

+ func CompileExpression(source string, options ...expr.Option) (*vm.Program, error)

+ func ParseDeclarationHeader(req DirectiveReq, directive string) (name string, mods []string, next int, err error)

Oct 14, 2026

Changes in this version

type PreparedSource

+ func (p *PreparedSource) SourceIdentity() (name, sha256Hex string)

Oct 13, 2026

Changes in this version

+ type ASTValidateFunc func(ast Expr, meta map[string]any) error

type Bundle

+ FileResolvers []FileResolverBinding

+ func BundleWithFileResolver(bundle Bundle, provider xfile.Provider, resolver xfile.Resolver) Bundle

type CompileOption

+ func WithASTValidators(fns ...ASTValidateFunc) CompileOption

+ type FileResolverBinding struct

+ Provider xfile.Provider

+ Resolver xfile.Resolver

type Value

+ Typed any

type ValueKind

+ const ValueTyped

Oct 12, 2026

Changes in this version

+ func SymbolsFromMeta(meta map[string]any) map[string]SymbolNamespace

Oct 12, 2026

Changes in this version

+ type LiteralExpr struct

+ Pos Position

+ Val any

+ func (*LiteralExpr) Analyze(CapabilityResolver) error

+ func (*LiteralExpr) Children() []Expr

+ func (*LiteralExpr) Node()

+ func (l *LiteralExpr) Build(_ context.Context, bCtx *BuildContext) (action.AnyAction, error)

Oct 11, 2026

Changes in this version

+ func LocalSymbolsFrom(ctx context.Context) map[string]SymbolNamespace

+ func LookupSymbol(namespace, name string) (any, bool)

+ func MergeSymbolNamespaces(ctx context.Context, env map[string]any) map[string]any

+ func RegisterNamespace(ns SymbolNamespace)

+ func WithLocalSymbols(ctx context.Context, syms map[string]SymbolNamespace) context.Context

+ func WithSymbolNamespaces(env map[string]any) map[string]any

type Bundle

+ Symbols []SymbolNamespace

+ type SymbolNamespace struct

+ Name string

+ Symbols map[string]any

+ func Namespaces() []SymbolNamespace

Oct 11, 2026

Changes in this version

+ const IntrospectionKindAction

+ const IntrospectionKindBranch

+ const IntrospectionKindSequence

+ const IntrospectionKindWraps

+ const VersionUnknown

+ var Version = VersionUnknown

+ func Analyze(resolver CapabilityResolver, expr Expr) error

+ func ApplyConstants(lines []string, start int, constants map[string]string)

+ func AtomNames(e Expr) []string

+ func Build(ctx context.Context, resolver CapabilityResolver, modifiers *ModifierTable, ...) (action.AnyAction, error)

+ func BuildEnv(input any) map[string]any

+ func CompileAction(resolver CapabilityResolver, dt *DirectiveTable, mt *ModifierTable, ...) *action.BuiltAction[CompileReq, CompileRes]

+ func CompileAndRun(resolver CapabilityResolver, dt *DirectiveTable, mt *ModifierTable, ...) *action.BuiltAction[CompileAndRunReq, RunRes]

+ func ComposedPipe(left, right action.AnyAction) action.AnyAction

+ func Decode[T any](raw map[string]string) (T, error)

+ func DetectRequiredBundles(expr Expr) []string

+ func IndexTopLevel(s string, target byte) int

+ func IsReservedActionName(name string) bool

+ func Library(resolver CapabilityResolver, dt *DirectiveTable, mt *ModifierTable, ...) action.Library

+ func ModifierName(raw string) string

+ func ModifierOwnerName(owner ModifierOwner) string

+ func ModifiersToMap(modifiers []string) map[string]any

+ func ParseBlockOptions(lines []string, start int) (opts map[string]string, next int, err error)

+ func ParseList(line string) []string

+ func Preprocess(ctx context.Context, dt *DirectiveTable, source, file string) (clean string, meta map[string]any, err error)

+ func PreprocessDots(src string) string

+ func ReadBlock(lines []string, start int) (body []string, next int, err error)

+ func Register(id string, factory BundleFactory)

+ func RegisterBoundary(spec BoundarySpec)

+ func RegisterBundle(id string, factory BundleFactory)

+ func RunAction() *action.BuiltAction[RunReq, RunRes]

+ func SplitTopLevel(s string, sep byte) []string

+ func StripExprComments(raw string) string

+ func SuggestModifierFix(target action.AnyAction, name string) string

+ func TrackActionComposition(ctx *BuildContext, act action.AnyAction, ...) action.AnyAction

+ func TranslateKeyword(name string) (string, bool)

+ func TrimQuotes(s string) string

+ func ValidateBundle(b Bundle) error

+ func ValidateModifierValue(kind ModifierKind, value string) error

+ func WithCompileConfig(ctx context.Context, cfg map[string]string, cliArgs []string) context.Context

+ func WithSourceLoader(ctx context.Context, loader SourceLoader) context.Context

+ func WithStrict(ctx context.Context) context.Context

+ type ActionGraph struct

+ Edges []ActionGraphEdge

+ Entry string

+ Exit string

+ Nodes []ActionGraphNode

+ func BuildActionGraph(resolver CapabilityResolver, expr Expr) (*ActionGraph, error)

+ type ActionGraphDescription struct

+ ChildLabels []string

+ Form ActionGraphForm

+ Kind string

+ Name string

+ type ActionGraphEdge struct

+ From string

+ Kind string

+ To string

+ type ActionGraphForm uint8

+ const ActionGraphCatch

+ const ActionGraphChoice

+ const ActionGraphOpaque

+ const ActionGraphParallel

+ type ActionGraphNode struct

+ Column int

+ File string

+ ID string

+ Kind string

+ Line int

+ Modifiers []string

+ Name string

+ type ActionGraphProvider interface

+ DescribeActionGraph func() ActionGraphDescription

+ type ArgFieldSpec struct

+ Kind ArgKind

+ Name string

+ Optional bool

+ type ArgKind uint8

+ const ArgAny

+ const ArgBool

+ const ArgCapabilityRef

+ const ArgCapabilityRefList

+ const ArgInt

+ const ArgString

type AssertExpr

+ Pos Position

+ func (*AssertExpr) Analyze(CapabilityResolver) error

+ func (*AssertExpr) Node()

+ func (a *AssertExpr) Build(_ context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (a *AssertExpr) Children() []Expr

+ type Associativity uint8

+ const Left

+ const Right

+ type Atom struct

+ Args map[string]*Value

+ ConfigInject bool

+ Excludes []string

+ ModifierSources []ModifierSource

+ Modifiers []string

+ Name string

+ Params map[string]string

+ Pos Position

+ Prompt string

+ Targets []string

+ func (*Atom) Analyze(CapabilityResolver) error

+ func (*Atom) Children() []Expr

+ func (*Atom) Node()

+ func (a *Atom) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ type AtomAdviseFunc func(atom *Atom, builder *action.Builder[any, any]) error

+ type AtomSpec struct

+ Description string

+ Example json.RawMessage

+ Name string

+ ReqFields []FieldSpec

+ ResFields []FieldSpec

+ Scope string

+ Tags []string

+ type BoundarySpec struct

+ Consume func(stream action.AnyStreamAction) *action.Builder[any, any]

+ Description string

+ Name string

+ func BoundaryByName(name string) (BoundarySpec, bool)

+ func NamedBoundaries() []BoundarySpec

+ type BuildContext struct

+ Advisers []AtomAdviseFunc

+ Introspect bool

+ Modifiers *ModifierTable

+ Resolver CapabilityResolver

+ type Bundle struct

+ AcceptedOptions []string

+ Alias string

+ ArgSchemas map[string][]ArgFieldSpec

+ AtomAdvise func(atom *Atom, builder *action.Builder[any, any]) error

+ Directives []Directive

+ Fixtures fs.FS

+ Hooks []action.AnyHook

+ ID string

+ Libraries []action.Library

+ Materialize Materializer

+ Modifiers []Modifier

+ OnPreprocess func(meta map[string]any) PreprocessContributions

+ Operators []Operator

+ Primaries []PrimaryExtension

+ SelfTest func() []SelfTestSection

+ Shutdowns []ShutdownFunc

+ WrapPipeline func(meta map[string]any, inner action.AnyAction) (action.AnyAction, error)

+ func (b Bundle) AllSelfTests() []SelfTestSection

+ type BundleFactory func(opts map[string]string) Bundle

+ func Lookup(id string) (BundleFactory, bool)

+ func LookupBundleForModule(target string) (BundleFactory, bool)

+ type CapabilityContract struct

+ Input TypeDescriptor

+ Name string

+ Output TypeDescriptor

+ type CapabilityRef struct

+ Canonical string

+ Raw string

+ func ParseCapabilityRef(raw string) (CapabilityRef, error)

+ func ParseCapabilityRefList(line string) ([]CapabilityRef, error)

+ type CapabilityResolver interface

+ Action func(name string) (action.AnyAction, bool)

+ Mount func(lib action.Library) error

+ MountWithAlias func(lib action.Library, alias string) error

+ Operator func(name string) (action.NamedOperator, bool)

+ Stream func(name string) (action.AnyStreamAction, bool)

+ type Catalog struct

+ Atoms []AtomSpec

+ Directives []DirectiveSpec

+ Modifiers []ModifierSpec

+ Operators []OperatorSpec

+ Sources []SourceSpec

+ func BuildCatalog(resolver CapabilityResolver, mt *ModifierTable, dt *DirectiveTable, ...) Catalog

+ type CompileAndRunReq struct

+ Payload any

+ Source string

+ type CompileOption func(*compileConfig)

+ func BundleConfig(bundles ...Bundle) []CompileOption

+ func WithActionGraph() CompileOption

+ func WithActionIntrospection() CompileOption

+ func WithArgSchemas(schemas map[string][]ArgFieldSpec) CompileOption

+ func WithAtomAdvisors(fns ...AtomAdviseFunc) CompileOption

+ func WithCLIArgs(args []string) CompileOption

+ func WithConfigMap(cfg map[string]string) CompileOption

+ func WithLineModifiers(lookups ...LineLookup) CompileOption

+ func WithOnPreprocess(fns ...OnPreprocessFunc) CompileOption

+ func WithPipelineWrappers(fns ...PipelineWrapFunc) CompileOption

+ type CompileReq struct

+ InheritedPrimaries []PrimaryExtension

+ Line int

+ Name string

+ Prepared *PreparedSource

+ Source string

+ type CompileRes struct

+ AST Expr

+ ActionGraph *ActionGraph

+ Meta map[string]any

+ Program action.AnyAction

type ConditionalExpr

+ Cond Expr

+ Pos Position

+ Then Expr

+ func (*ConditionalExpr) Node()

+ func (c *ConditionalExpr) Analyze(r CapabilityResolver) error

+ func (c *ConditionalExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (c *ConditionalExpr) Children() []Expr

+ type ContractProvider interface

+ Contract func(name string) (CapabilityContract, bool)

+ type DecoratedExpr struct

+ Inner Expr

+ Modifiers []string

+ Pos Position

+ func (*DecoratedExpr) Node()

+ func (d *DecoratedExpr) Analyze(r CapabilityResolver) error

+ func (d *DecoratedExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (d *DecoratedExpr) Children() []Expr

+ type Directive struct

+ Example string

+ Handler func(context.Context, DirectiveReq) (DirectiveRes, error)

+ Name string

+ func (d Directive) Action() *action.BuiltAction[DirectiveReq, DirectiveRes]

+ type DirectiveReq struct

+ BaseDir string

+ Body []string

+ File string

+ I int

+ Lines []string

+ Out map[string]any

+ Recurse func(absPath string) (clean string, meta map[string]any, err error)

+ Table *DirectiveTable

+ type DirectiveRes struct

+ BlankLines []int

+ Next int

+ type DirectiveSpec struct

+ Example string

+ Name string

+ type DirectiveTable struct

+ func NewDirectiveTable(ds ...Directive) *DirectiveTable

+ func (t *DirectiveTable) Actions() []action.AnyAction

+ func (t *DirectiveTable) All() []Directive

+ func (t *DirectiveTable) ByName(name string) (*action.BuiltAction[DirectiveReq, DirectiveRes], bool)

+ type DynamicResolver struct

+ func NewDynamicResolver(baseLibs ...action.Library) (*DynamicResolver, error)

+ func (r *DynamicResolver) Action(name string) (action.AnyAction, bool)

+ func (r *DynamicResolver) ActionNames() []string

+ func (r *DynamicResolver) Actions() []action.AnyAction

+ func (r *DynamicResolver) Contract(name string) (CapabilityContract, bool)

+ func (r *DynamicResolver) Mount(lib action.Library) error

+ func (r *DynamicResolver) MountWithAlias(lib action.Library, alias string) error

+ func (r *DynamicResolver) Operator(name string) (action.NamedOperator, bool)

+ func (r *DynamicResolver) Operators() []action.NamedOperator

+ func (r *DynamicResolver) Stream(name string) (action.AnyStreamAction, bool)

+ func (r *DynamicResolver) Streams() []action.AnyStreamAction

type Expr

+ Analyze func(resolver CapabilityResolver) error

+ Build func(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ Children func() []Expr

+ Node func()

type FallbackExpr

+ L Expr

+ Pos Position

+ R Expr

+ func (*FallbackExpr) Node()

+ func (f *FallbackExpr) Analyze(r CapabilityResolver) error

+ func (f *FallbackExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (f *FallbackExpr) Children() []Expr

+ type FieldSpec struct

+ Name string

+ Required bool

+ Type string

+ Usage string

+ type KeywordMapping struct

+ Keyword string

+ Target string

+ func KeywordMappings() []KeywordMapping

+ type KeywordPrimary interface

+ Keyword func() string

+ type LineLookup struct

+ Fn func(line int) []string

+ Source ModifierSource

+ func LineModifiersFromOptions(mt *ModifierTable, opts []CompileOption) []LineLookup

type LoopExpr

+ Pos Position

+ func (*LoopExpr) Node()

+ func (l *LoopExpr) Analyze(r CapabilityResolver) error

+ func (l *LoopExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (l *LoopExpr) Children() []Expr

+ type MaterializeReq struct

+ Alias string

+ Compile func(name, source string, modifiers ...string) (action.AnyAction, error)

+ Ctx context.Context

+ Introspection bool

+ Meta map[string]any

+ Resolver CapabilityResolver

+ type Materializer func(req MaterializeReq) error

+ type MergeablePrimary interface

+ MergeWith func(older PrimaryExtension) PrimaryExtension

+ type Modifier struct

+ Apply func(b *action.Builder[any, any], raw string) error

+ Example string

+ Inheritable bool

+ Name string

+ Owner ModifierOwner

+ Unique bool

+ ValueKind ModifierKind

+ func Duration(name string, ...) Modifier

+ func Flag(name string, apply func(*action.Builder[any, any]) *action.Builder[any, any]) Modifier

+ func Float64(name string, ...) Modifier

+ func Int(name string, ...) Modifier

+ func Int32(name string, ...) Modifier

+ func Int64(name string, ...) Modifier

+ func String(name string, ...) Modifier

+ func StringList(name string, ...) Modifier

+ func WithInheritable(m Modifier) Modifier

+ func WithOwner(m Modifier, owner ModifierOwner) Modifier

+ func WithUnique(m Modifier) Modifier

+ type ModifierKind uint8

+ const ModifierKindAny

+ const ModifierKindDuration

+ const ModifierKindFlag

+ const ModifierKindFloat64

+ const ModifierKindInt

+ const ModifierKindInt32

+ const ModifierKindInt64

+ const ModifierKindString

+ const ModifierKindStringList

+ func (k ModifierKind) String() string

+ type ModifierOwner uint8

+ const OwnerBundle

+ const OwnerGrammar

+ const OwnerKernel

+ func RequiredModifierOwner(name string) ModifierOwner

+ type ModifierSource struct

+ Kind string

+ Label string

+ type ModifierSpec struct

+ Example string

+ Name string

+ ValueKind string

+ type ModifierTable struct

+ func NewModifierTable(modifiers ...Modifier) *ModifierTable

+ func (t *ModifierTable) Actions() []action.AnyAction

+ func (t *ModifierTable) All() []Modifier

+ func (t *ModifierTable) ApplyAll(target action.AnyAction, raws []string) (action.AnyAction, error)

+ func (t *ModifierTable) ByName(name string) (Modifier, bool)

+ type OnPreprocessFunc func(meta map[string]any) PreprocessContributions

+ type Operator struct

+ Handler func(context.Context, OperatorReq) (OperatorRes, error)

+ Meta OperatorMeta

+ func (o Operator) Action() *action.BuiltAction[OperatorReq, OperatorRes]

+ type OperatorMeta struct

+ Associativity Associativity

+ Description string

+ Example string

+ Name string

+ Precedence int

+ Token TokenType

+ type OperatorReq struct

+ Left Expr

+ Meta *OperatorMeta

+ Right Expr

+ type OperatorRes struct

+ Node Expr

+ type OperatorSpec struct

+ Description string

+ Example string

+ Name string

+ Token string

+ type OperatorTable struct

+ func NewOperatorTable(ops ...Operator) *OperatorTable

+ func (t *OperatorTable) Actions() []action.AnyAction

+ func (t *OperatorTable) All() []OperatorMeta

+ func (t *OperatorTable) ByName(name string) (OperatorMeta, *action.BuiltAction[OperatorReq, OperatorRes], bool)

+ func (t *OperatorTable) ByToken(tok TokenType) (OperatorMeta, *action.BuiltAction[OperatorReq, OperatorRes], bool)

type ParallelExpr

+ Branches []Expr

+ Pos Position

+ func (*ParallelExpr) Node()

+ func (p *ParallelExpr) Analyze(r CapabilityResolver) error

+ func (p *ParallelExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

type Parser

+ func NewParserWithFileOffset(ctx context.Context, ops *OperatorTable, primaries *PrimaryExtensionTable, ...) *Parser

+ func NewParserWithPrimaries(ctx context.Context, ops *OperatorTable, primaries *PrimaryExtensionTable, ...) *Parser

+ func (p *Parser) Advance()

+ func (p *Parser) Context() context.Context

+ func (p *Parser) Cur() Token

+ func (p *Parser) Current() Token

+ func (p *Parser) Fail(_ int, format string, args ...any) error

+ func (p *Parser) File() string

+ func (p *Parser) Next()

+ func (p *Parser) Parse() (Expr, error)

+ func (p *Parser) ParseExpr(minPrec int) (Expr, error)

+ func (p *Parser) Peek(offset int) Token

+ func (p *Parser) Position() Position

+ func (p *Parser) Src() string

+ func (p *Parser) SubParse(src string) (Expr, error)

+ func (p *Parser) WithLineModifiers(lookups ...LineLookup) *Parser

+ type PipeExpr struct

+ L Expr

+ Pos Position

+ R Expr

+ func (*PipeExpr) Node()

+ func (p *PipeExpr) Analyze(r CapabilityResolver) error

+ func (p *PipeExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (p *PipeExpr) Children() []Expr

+ type PipelineWrapFunc func(meta map[string]any, inner action.AnyAction) (action.AnyAction, error)

type Position

+ func PositionOf(err error) (Position, bool)

+ type Positioned interface

+ Position func() Position

+ type PostfixExtension interface

+ MatchesPostfix func(p *Parser) bool

+ ParsePostfix func(p *Parser, left Expr) (Expr, error)

+ PostfixToken func() TokenType

+ type PreparedSource struct

+ func PrepareSource(ctx context.Context, dt *DirectiveTable, source, name string, ...) (*PreparedSource, error)

+ func (p *PreparedSource) ActionIntrospectionEnabled() bool

+ func (p *PreparedSource) Contributions() PreprocessContributions

+ func (p *PreparedSource) Metadata() map[string]any

+ type PreprocessContributions struct

+ CompileOpts []CompileOption

+ Primaries []PrimaryExtension

+ func PreprocessContributionsFromMeta(meta map[string]any, opts ...CompileOption) PreprocessContributions

+ type PrimaryExtension interface

+ Name func() string

+ Parse func(p *Parser) (Expr, error)

+ type PrimaryExtensionTable struct

+ func DefaultPrimaryExtensions() *PrimaryExtensionTable

+ func NewPrimaryExtensionTable(exts ...PrimaryExtension) *PrimaryExtensionTable

+ func (t *PrimaryExtensionTable) All() []PrimaryExtension

+ func (t *PrimaryExtensionTable) ByKeyword(kw string) (PrimaryExtension, bool)

+ func (t *PrimaryExtensionTable) ByPostfix(tok TokenType) (PostfixExtension, bool)

+ func (t *PrimaryExtensionTable) ByToken(tt TokenType) (PrimaryExtension, bool)

type ProjectionExpr

+ Pos Position

+ func (*ProjectionExpr) Analyze(CapabilityResolver) error

+ func (*ProjectionExpr) Node()

+ func (p *ProjectionExpr) Build(ctx context.Context, bCtx *BuildContext) (action.AnyAction, error)

+ func (p *ProjectionExpr) Children() []Expr

+ type RunReq struct

+ Payload any

+ Program action.AnyAction

+ type RunRes struct

+ Output any

+ type SelfTestFeature struct

+ DSL string

+ Files map[string]string

+ Name string

+ Skip string

+ Source string

+ type SelfTestSection struct

+ Features []SelfTestFeature

+ Name string

+ type ShutdownFunc func(context.Context) error

+ type SourceLoader interface

+ Load func(currentFile, target string) (data []byte, resolvedPath string, err error)

+ type SourceSpec struct

+ Description string

+ Name string

+ ReqFields []FieldSpec

+ Tags []string

+ type TokenPrimary interface

+ TokenType func() TokenType

type TokenType

+ const TokAmpersand

+ const TokArrow

+ const TokAtBrace

+ const TokAtPrompt

+ const TokColon

+ const TokComma

+ const TokEOF

+ const TokEquals

+ const TokHash

+ const TokIdent

+ const TokLBrace

+ const TokLParen

+ const TokNumber

+ const TokOrOr

+ const TokPipe

+ const TokQuestion

+ const TokRBrace

+ const TokRParen

+ const TokString

+ const TokTilde

+ type TypeDescriptor struct

+ Stream bool

+ Type reflect.Type

type ValueKind

+ const ValueBare

Sep 23, 2026

Changes in this version

+ func SourceError(pos Position, format string, args ...any) error

+ type AssertExpr struct

+ Condition string

+ Message string

type AtomExpr

+ Args map[string]*Value

type ConditionalExpr

+ Else Expr

+ type MapEntry struct

+ Key string

+ Value *Value

+ type NeedsPipelineError struct

+ Reason string

+ func (e *NeedsPipelineError) Error() string

type Parser

+ func NewParserWithFile(input, file string) *Parser

+ type Position struct

+ Col int

+ File string

+ Line int

+ func (p Position) String() string

type TokenType

+ const TokenAtBrace

+ const TokenLBracket

+ const TokenRBracket

+ type Value struct

+ Bool bool

+ Kind ValueKind

+ Map []MapEntry

+ Num float64

+ Ref string

+ Slice []*Value

+ Str string

+ func (v *Value) IsWholeStateRef() bool

+ type ValueKind uint8

+ const ValueBool

+ const ValueMap

+ const ValueNull

+ const ValueNumber

+ const ValueRef

+ const ValueSlice

+ const ValueString

Sep 15, 2026

Changes in this version

type TokenType

+ const TokenAtPrompt

Sep 9, 2026

Changes in this version

+ type AtomExpr struct

+ Excludes []string

+ Inputs map[string]string

+ Modifiers []string

+ Name string

+ Params map[string]string

+ Profile string

+ Prompt string

+ Targets []string

+ type ConditionalExpr struct

+ Gate Expr

+ Target Expr

+ type Expr interface

+ type FallbackExpr struct

+ Left Expr

+ Right Expr

+ type Lexer struct

+ func NewLexer(input string) *Lexer

+ func (l *Lexer) Next() Token

+ type LoopExpr struct

+ Body Expr

+ Until string

+ type Node interface

+ type ParallelExpr struct

+ Children []Expr

+ type Parser struct

+ func NewParser(input string) *Parser

+ func (p *Parser) ParseExpression() (Expr, error)

+ type PipelineExpr struct

+ Left Expr

+ Right Expr

+ type ProjectionExpr struct

+ Raw string

+ type Token struct

+ Col int

+ Line int

+ Lit string

+ Offset int

+ Type TokenType

+ type TokenType int

+ const TokenAmpersand

+ const TokenArrow

+ const TokenAssign

+ const TokenAt

+ const TokenColon

+ const TokenComma

+ const TokenEOF

+ const TokenHash

+ const TokenIdent

+ const TokenInvalid

+ const TokenLBrace

+ const TokenLParen

+ const TokenNumber

+ const TokenOr

+ const TokenPipe

+ const TokenQuestion

+ const TokenRBrace

+ const TokenRParen

+ const TokenString

+ const TokenTilde

+ func (t TokenType) String() string