parser

type ArrayType struct {
	Pos          lexer.Position
	ArrayMarkers string `parser:"'[' ']'"`
	// Capture the element type - can be nested
	ElementType *TypeExpr `parser:"@@"`
}

type Enum struct {
	Pos       lexer.Position `json:"-"`
	Name      string         `json:"name"`
	Namespace string         `json:"namespace,omitempty"`
	Comment   string         `json:"comment,omitempty"`
	Values    []*EnumValue   `json:"values,omitempty"`
}

type EnumDef struct {
	Pos    lexer.Position
	Name   string   `parser:"@Ident '{'"`
	Values []string `parser:"@Ident* '}'"`
}

type EnumValue struct {
	Name    string `json:"name"`
	Comment string `json:"comment,omitempty"`
}

type ErrorDecl struct {
	Pos     lexer.Position
	Code    int    `parser:"@IntLiteral"`
	Name    string `parser:"@Ident"`
	Message string `parser:"@StringLiteral"`
}

type ErrorDef struct {
	Pos       lexer.Position `json:"-"`
	Name      string         `json:"name"`                // e.g., "NotFound" or "errors.NotFound" if imported
	Namespace string         `json:"namespace,omitempty"` // Namespace where declared
	Code      int            `json:"code"`                // JSON-RPC error code
	Message   string         `json:"message"`             // Error message template
	Comment   string         `json:"comment,omitempty"`   // Documentation comment
}

type ErrorsDef struct {
	Pos    lexer.Position
	Errors []*ErrorDecl `parser:"'{' @@* '}'"`
}

type Field struct {
	Pos      lexer.Position `json:"-"`
	Name     string         `json:"name"`
	Type     *Type          `json:"type"`
	Optional bool           `json:"optional,omitempty"`
	Comment  string         `json:"comment,omitempty"`
}

type FieldDef struct {
	Pos      lexer.Position
	Name     string    `parser:"@Ident"`
	Type     *TypeExpr `parser:"@@"`
	Optional bool      `parser:"( @Optional )?"`
}

type IDL struct {
	RootNamespace string       `json:"rootNamespace,omitempty"` // Namespace of the root file being parsed
	Checksum      string       `json:"checksum,omitempty"`      // SHA-256 checksum of structural elements
	Interfaces    []*Interface `json:"interfaces,omitempty"`
	Structs       []*Struct    `json:"structs,omitempty"`
	Enums         []*Enum      `json:"enums,omitempty"`
	Errors        []*ErrorDef  `json:"errors,omitempty"`
}

type IDLElement struct {
	Pos       lexer.Position
	Namespace *NamespaceDef `parser:"  'namespace' @@"`
	Interface *InterfaceDef `parser:"| 'interface' @@"`
	Struct    *StructDef    `parser:"| 'struct' @@"`
	Enum      *EnumDef      `parser:"| 'enum' @@"`
	Errors    *ErrorsDef    `parser:"| 'errors' @@"`
}

type IDLFile struct {
	Pos      lexer.Position
	Elements []*IDLElement `parser:"@@*"`
}

type ImportDef struct {
	Pos  lexer.Position
	Path string
}

type ImportString string

type Interface struct {
	Pos       lexer.Position `json:"-"`
	Name      string         `json:"name"`
	Namespace string         `json:"namespace,omitempty"`
	Comment   string         `json:"comment,omitempty"`
	Methods   []*Method      `json:"methods,omitempty"`
}

type InterfaceDef struct {
	Pos     lexer.Position
	Name    string       `parser:"@Ident '{'"`
	Methods []*MethodDef `parser:"@@* '}'"`
}

type MapTypeExpr struct {
	Pos        lexer.Position
	MapPattern string `parser:"@Map '[' @String ']'"`
	// Capture the value type - can be nested
	ValueType *TypeExpr `parser:"@@"`
}

type Method struct {
	Pos            lexer.Position `json:"-"`
	Name           string         `json:"name"`
	Parameters     []*Parameter   `json:"parameters,omitempty"`
	ReturnType     *Type          `json:"returnType"`
	ReturnOptional bool           `json:"returnOptional,omitempty"`
	Raises         []string       `json:"raises,omitempty"`
}

type MethodDef struct {
	Pos            lexer.Position
	Name           string              `parser:"@Ident '('"`
	Parameters     []*ParameterDef     `parser:"( @@ (',' @@)* )? ')' "`
	ReturnType     *TypeExpr           `parser:"@@"`
	ReturnOptional bool                `parser:"( @Optional )?"`
	Raises         []*RaisesIdentifier `parser:"( 'raises' '(' @@ ( ',' @@ )* ')' )?"`
}

type NamespaceDef struct {
	Pos  lexer.Position
	Name string `parser:"@Ident"`
}

type Parameter struct {
	Pos  lexer.Position `json:"-"`
	Name string         `json:"name"`
	Type *Type          `json:"type"`
}

type ParameterDef struct {
	Pos  lexer.Position
	Name string    `parser:"@Ident"`
	Type *TypeExpr `parser:"@@"`
}

type ParseError struct {
	Line   int
	Column int
	Msg    string
}

type QualifiedName struct {
	Pos   lexer.Position
	Parts []string `parser:"@Ident ( '.' @Ident )*"`
}

type RaisesIdentifier struct {
	Name *QualifiedName `parser:"@@"`
}

type Struct struct {
	Pos       lexer.Position `json:"-"`
	Name      string         `json:"name"`
	Namespace string         `json:"namespace,omitempty"`
	Extends   string         `json:"extends,omitempty"` // Empty if no extends, can be qualified (e.g., "inc.Response")
	Comment   string         `json:"comment,omitempty"`
	Fields    []*Field       `json:"fields,omitempty"`
}

type StructDef struct {
	Pos     lexer.Position
	Name    string         `parser:"@Ident"`
	Extends *QualifiedName `parser:"( 'extends' @@ )?"`
	Fields  []*FieldDef    `parser:"'{' @@* '}'"`
}

type Type struct {
	Pos lexer.Position `json:"-"`

	// For built-in types: string, int, float, bool
	BuiltIn string `json:"builtIn,omitempty"`

	// For arrays: []Type
	Array *Type `json:"array,omitempty"`

	// For maps: map[string]ValueType
	MapValue *Type `json:"mapValue,omitempty"`

	// For user-defined types (interfaces, structs, enums)
	UserDefined string `json:"userDefined,omitempty"`
}

type TypeExpr struct {
	Pos         lexer.Position
	BuiltIn     *string        `parser:"( @String | @Int | @Float | @Bool )"`
	Array       *ArrayType     `parser:"| @@"`
	MapType     *MapTypeExpr   `parser:"| @@"`
	UserDefined *QualifiedName `parser:"| @@"`
}

type ValidationError struct {
	Line   int
	Column int
	Msg    string
}

type ValidationErrors struct {
	Errors []*ValidationError
}