compiler

func Compile ¶

func Compile(ctx context.Context, provider base.Provider, source base.DefinitionsSource, opts Options) (base.CompiledCatalog, error)

Compile is a convenience function that creates a Compiler from GlobalRules() and compiles the given source against the target schema.

func CompileChanges ¶

func CompileChanges(
	ctx context.Context,
	provider base.Provider,
	baseCatalog base.DefinitionsSource,
	changes base.DefinitionsSource,
	opts Options,
) (base.CompiledCatalog, error)

CompileChanges compiles incremental DDL SDL changes against an existing provider schema. It produces a CompiledCatalog compatible with Provider.Update().

Parameters:

• provider: the current compiled schema
• baseCatalog: the full original (uncompiled) source catalog — needed for prefix renaming of type references across the whole catalog namespace
• changes: incremental DDL with @drop directives on types to remove, new definitions for types to add, and extensions for field-level changes
• opts: compile options (same as for full compilation)

The pipeline:

1. CLASSIFY — definitions → toAdd/toDrop; check for extensions
2. BUILD SOURCE NAMES (from baseCatalog + changes)
3. TYPE DROPS — emit @drop DDL for types + derived types + shared fields
4. PREPARE — prefix rename on definitions AND extensions
5. COMPILE NEW TYPES — GENERATE→ASSEMBLE→FINALIZE on toAdd definitions
6. COMPILE FIELD CHANGES — process extensions for field add/drop/replace
7. RETURN CompiledCatalog

func GlobalRules ¶

func GlobalRules() []base.Rule

GlobalRules returns all registered rules.

func RegisterRules ¶

func RegisterRules(rules ...base.Rule)

RegisterRules adds rules to the global rule registry. Typically called from init() in rules/ or engine packages.