compiler

Documentation

Index

• func BindBackendHandlers(app manifest.Manifest) manifest.Manifest
• func DiscoverGoEndpointComments(app manifest.Manifest) (manifest.Manifest, error)
• func ValidateBackendBindingPolicy(config gowdk.Config, app manifest.Manifest) error
• func ValidateContractReferences(refs []gwdkir.ContractReference) error
• func ValidateManifest(config gowdk.Config, app manifest.Manifest) error
• type ContractEndpointBinding
• type EndpointBinding
• type EndpointKind
• type RouteBinding
• type RouteInfo
• type RouteKind
• type RouteMetadata
  • func BuildRouteMetadata(config gowdk.Config, app manifest.Manifest) (RouteMetadata, error)
  • func BuildRouteMetadataFromIR(config gowdk.Config, ir gwdkir.Program) RouteMetadata
• type ValidationError
  • func ValidatePage(config gowdk.Config, page manifest.Page) []ValidationError
  • func (err ValidationError) Error() string
• type ValidationErrors
  • func (errs ValidationErrors) Error() string

Functions

func BindBackendHandlers

func BindBackendHandlers(app manifest.Manifest) manifest.Manifest

BindBackendHandlers discovers same-package Go handlers for act and api blocks. Discovery is intentionally non-fatal: missing packages, missing functions, and unsupported signatures are reported as binding metadata so generated apps can emit clear 501 responses.

func DiscoverGoEndpointComments

func DiscoverGoEndpointComments(app manifest.Manifest) (manifest.Manifest, error)

DiscoverGoEndpointComments merges optional //gowdk:act and //gowdk:api comments from selected feature-package Go files into the manifest.

func ValidateBackendBindingPolicy

func ValidateBackendBindingPolicy(config gowdk.Config, app manifest.Manifest) error

ValidateBackendBindingPolicy enforces build-mode rules for declared backend endpoints after same-package Go handler binding metadata has been produced.

func ValidateContractReferences

func ValidateContractReferences(refs []gwdkir.ContractReference) error

ValidateContractReferences converts linked contract-reference metadata into compiler diagnostics for CLI validation paths.

func ValidateManifest

func ValidateManifest(config gowdk.Config, app manifest.Manifest) error

ValidateManifest checks render-mode invariants that must hold before codegen.

Types

type ContractEndpointBinding

type ContractEndpointBinding struct {
	Name        string
	Kind        gwdkir.ContractKind
	Status      gwdkir.ContractBindingStatus
	Message     string
	ImportAlias string
	ImportPath  string
	Type        string
	Result      string
	Roles       []string
	Handler     string
	Register    string
}

ContractEndpointBinding describes a command/query contract exposed through a generated backend endpoint.

type EndpointBinding

type EndpointBinding struct {
	Kind              EndpointKind
	EndpointSource    string
	Source            string
	SourceSpan        manifest.SourceSpan
	Package           string
	PackagePath       string
	PackageName       string
	Symbol            string
	Method            string
	Route             string
	PageID            string
	Handler           string
	BindingStatus     manifest.BackendBindingStatus
	BindingMessage    string
	BindingImportPath string
	BindingPackage    string
	BindingFunction   string
	BindingSignature  manifest.BackendSignatureKind
	BindingInputType  string
	Contract          ContractEndpointBinding
}

EndpointBinding is backend action/API metadata. Endpoints are not route kinds; they hang off the generated app/runtime backend layer.

type EndpointKind

type EndpointKind string

EndpointKind describes backend endpoint behavior separate from page/file routes.

const (
	EndpointAction   EndpointKind = "action"
	EndpointAPI      EndpointKind = "api"
	EndpointFragment EndpointKind = "fragment"
	EndpointCommand  EndpointKind = "command"
	EndpointQuery    EndpointKind = "query"
)

type RouteBinding

type RouteBinding struct {
	Kind    RouteKind
	Method  string
	Route   string
	PageID  string
	Cache   string
	Handler string
}

RouteBinding is route-level metadata. Route kinds are intentionally limited to static files, SPA routes, SSR routes, and hybrid routes.

type RouteInfo

type RouteInfo struct {
	Code    string
	PageID  string
	Route   string
	Message string
}

RouteInfo is non-fatal route metadata surfaced by CLI inspection commands.

type RouteKind

type RouteKind string

RouteKind describes route behavior in the CLI routes report.

const (
	RouteStatic RouteKind = "static"
	RouteSPA    RouteKind = "spa"
	RouteSSR    RouteKind = "ssr"
	RouteHybrid RouteKind = "hybrid"
)

type RouteMetadata

type RouteMetadata struct {
	Routes    []RouteBinding
	Endpoints []EndpointBinding
	Info      []RouteInfo
}

RouteMetadata is route and endpoint metadata used by the CLI routes report.

func BuildRouteMetadata

func BuildRouteMetadata(config gowdk.Config, app manifest.Manifest) (RouteMetadata, error)

BuildRouteMetadata converts a validated manifest into route and endpoint metadata for CLI reporting.

func BuildRouteMetadataFromIR

func BuildRouteMetadataFromIR(config gowdk.Config, ir gwdkir.Program) RouteMetadata

BuildRouteMetadataFromIR converts stable compiler IR into CLI route and endpoint metadata.

type ValidationError

type ValidationError struct {
	Code          string
	PageID        string
	ComponentName string
	Source        string
	Span          manifest.SourceSpan
	Message       string
}

func ValidatePage

func ValidatePage(config gowdk.Config, page manifest.Page) []ValidationError

func (ValidationError) Error

func (err ValidationError) Error() string

type ValidationErrors

type ValidationErrors []ValidationError

func (ValidationErrors) Error

func (errs ValidationErrors) Error() string