parser

Documentation

Overview

Package parser turns .gwdk source files into syntax trees.

Index

• Constants
• func ParseComponent(src []byte) (gwdkir.Component, error)
• func ParseLayout(path string, src []byte) (gwdkir.Layout, error)
• func ParsePage(source []byte) (gwdkir.Page, error)
• func ParsePageWithDefaultID(source []byte, defaultID string) (gwdkir.Page, error)
• type APIStatement
• type ActionStatement
• type BraceDepth
  • func NewBraceDepth() *BraceDepth
  • func (b *BraceDepth) Delta(line string) int
  • func (b *BraceDepth) InMultiline() bool
• type BuildCall
• type DiagnosticError
  • func ParserDiagnostic(err error) (*DiagnosticError, bool)
  • func ParserDiagnostics(err error) []*DiagnosticError
  • func (err *DiagnosticError) Error() string
• type DiagnosticErrors
  • func (errs DiagnosticErrors) Error() string
  • func (errs DiagnosticErrors) Unwrap() []error
• type Emit
• type EmitParam
• type Export
• type GoFuncRef
• type GoTypeRef
• type LiteralRecord
• type Prop
• type StateContract
• type SyntaxBlock
• type SyntaxEndpoint
• type SyntaxFile
  • func ParseSyntax(src []byte) (SyntaxFile, error)
• type SyntaxFragmentEndpoint
• type SyntaxImport
• type SyntaxMetadata
• type SyntaxPackage
• type SyntaxUse
• type WASMContract

Constants

const (
	DiagnosticMalformedGOWDKUse            = "malformed_gowdk_use"
	DiagnosticMalformedLegacyMetadata      = "malformed_legacy_metadata"
	DiagnosticOldActionBlockSyntax         = "old_action_block_syntax"
	DiagnosticOldAPIBlockSyntax            = "old_api_block_syntax"
	DiagnosticPackageMustBeFirst           = "package_must_be_first"
	DiagnosticUnsupportedLiteralRecord     = "unsupported_literal_record_syntax"
	DiagnosticUnsupportedTopLevelBlock     = "unsupported_top_level_block"
	DiagnosticUnsupportedLayoutMetadata    = "unsupported_layout_metadata"
	DiagnosticInvalidComponentProp         = "invalid_component_prop"
	DiagnosticUnsupportedComponentPropType = "unsupported_component_prop_type"
)

Functions

func ParseComponent

func ParseComponent(src []byte) (gwdkir.Component, error)

ParseComponent extracts component metadata and top-level block declarations.

func ParseLayout

func ParseLayout(path string, src []byte) (gwdkir.Layout, error)

ParseLayout extracts layout metadata and top-level block declarations. Layout identity is derived from the file name (`root.layout.gwdk` -> `root`); any `layout` metadata declaration declares parent layouts this layout nests within.

func ParsePage

func ParsePage(source []byte) (gwdkir.Page, error)

ParsePage extracts page metadata and top-level block declarations.

func ParsePageWithDefaultID

func ParsePageWithDefaultID(source []byte, defaultID string) (gwdkir.Page, error)

ParsePageWithDefaultID extracts page metadata and uses defaultID when the source omits page.

Types

type APIStatement

type APIStatement = gwdkast.APIStatement

type ActionStatement

type ActionStatement = gwdkast.ActionStatement

type BraceDepth

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

BraceDepth tracks net brace depth across the lines of a .gwdk file for tooling such as the formatter, skipping braces that appear inside string literals, comments, Go raw strings, and JS template literals. It carries multi-line state across Delta calls. It uses Go lexical rules, which cover the top-level `.gwdk` surface and Go/JS block bodies; the one accepted edge is a `//` sequence inside a CSS value (e.g. a `url(http://...)`), which truncates brace counting for the rest of that line only.

func NewBraceDepth

func NewBraceDepth() *BraceDepth

NewBraceDepth returns a brace-depth tracker using Go lexical rules.

func (*BraceDepth) Delta

func (b *BraceDepth) Delta(line string) int

Delta scans one line and returns the net change in brace depth it contributes, skipping braces inside strings and comments.

func (*BraceDepth) InMultiline

func (b *BraceDepth) InMultiline() bool

InMultiline reports whether the tracker is currently inside a multi-line construct (block comment, Go raw string, or JS template literal). A line that is textually "}" while InMultiline is body content, not a block terminator.

type BuildCall

type BuildCall = gwdkast.BuildCall

type DiagnosticError

type DiagnosticError struct {
	Code    string
	Span    source.SourceSpan
	Message string
}

DiagnosticError carries parser diagnostic metadata without forcing callers to recover line numbers and codes by parsing Error strings.

func ParserDiagnostic

func ParserDiagnostic(err error) (*DiagnosticError, bool)

ParserDiagnostic extracts a typed parser diagnostic from err when available.

func ParserDiagnostics

func ParserDiagnostics(err error) []*DiagnosticError

ParserDiagnostics extracts every typed parser diagnostic from err. Untyped parse failures are returned as nil entries by callers through their fallback diagnostic path.

func (*DiagnosticError) Error

func (err *DiagnosticError) Error() string

type DiagnosticErrors

type DiagnosticErrors []error

DiagnosticErrors carries every parser diagnostic recovered from one file.

func (DiagnosticErrors) Error

func (errs DiagnosticErrors) Error() string

func (DiagnosticErrors) Unwrap

func (errs DiagnosticErrors) Unwrap() []error

type Emit

type Emit = gwdkast.Emit

type EmitParam

type EmitParam = gwdkast.EmitParam

type Export

type Export = gwdkast.Export

type GoFuncRef

type GoFuncRef = gwdkast.GoFuncRef

type GoTypeRef

type GoTypeRef = gwdkast.GoTypeRef

type LiteralRecord

type LiteralRecord = gwdkast.LiteralRecord

type Prop

type Prop = gwdkast.Prop

type StateContract

type StateContract = gwdkast.StateContract

type SyntaxBlock

type SyntaxBlock = gwdkast.Block

type SyntaxEndpoint

type SyntaxEndpoint = gwdkast.Endpoint

type SyntaxFile

type SyntaxFile = gwdkast.File

func ParseSyntax

func ParseSyntax(src []byte) (SyntaxFile, error)

ParseSyntax parses a .gwdk source file into a typed syntax AST for the current compiler subset.

type SyntaxFragmentEndpoint

type SyntaxFragmentEndpoint = gwdkast.FragmentEndpoint

type SyntaxImport

type SyntaxImport = gwdkast.Import

type SyntaxMetadata

type SyntaxMetadata = gwdkast.MetadataDecl

type SyntaxPackage

type SyntaxPackage = gwdkast.Package

type SyntaxUse

type SyntaxUse = gwdkast.Use

type WASMContract

type WASMContract = gwdkast.WASMContract