validator

type APISymbol struct {
	Method         string                 // "get", "post", "put", "delete"
	Parameters     []ParamSymbol          // path/query parameters
	RequestFields  map[string]string      // field name → type
	ResponseFields map[string]FieldSymbol // field name → type info

	// Phase 5: x- extensions
	Pagination *PaginationExt
	Sort       *SortExt
	Filter     *FilterExt
}

type CustomSymbol struct {
	Functions map[string]bool
}

type FieldSymbol struct {
	Type     string // "string", "integer", "array", "object"
	ItemType string // item type if array
}

type FilterExt struct {
	Allowed []string
}

type PaginationExt struct {
	Style        string // "offset" or "cursor"
	DefaultLimit int
	MaxLimit     int
}

type ParamSymbol struct {
	Name string // parameter name
	In   string // "path" or "query"
}

type SortExt struct {
	Allowed   []string
	Default   string
	Direction string
}

type SymbolTable struct {
	Operations map[string]APISymbol // operationId → APISymbol
}

type ValidationError struct {
	File    string // source HTML filename
	Attr    string // attribute context (e.g. `data-fetch="Login"`)
	Message string // human-readable error
}