model

type Declaration struct {
	Type     string      `json:"type"`     // Type of declaration: "const", "var", "type", "func", or "comment"
	Position int         `json:"position"` // Source position for ordering
	Data     interface{} `json:"data"`     // The actual declaration data (one of the Go* types or string for comment)
}

type GoConstant struct {
	Name    string `json:"name"`
	Type    string `json:"type"`    // type of the constant, if specified
	Value   string `json:"value"`   // constant value/expression (as written, empty if implicit)
	Doc     string `json:"doc"`     // documentation comment above, if any
	Comment string `json:"comment"` // trailing comment, if any
}

type GoField struct {
	Name    string `json:"name"`    // field name (empty for embedded field)
	Type    string `json:"type"`    // field type
	Tag     string `json:"tag"`     // struct tag string, if any (including quotes)
	Comment string `json:"comment"` // trailing comment for this field, if any
	Doc     string `json:"doc"`     // documentation comment above this field, if any
}

type GoFunction struct {
	Name      string      `json:"name"`
	Receiver  *GoReceiver `json:"receiver,omitempty"` // method receiver, or nil if function
	Signature string      `json:"signature"`          // function signature (params and results)
	Body      string      `json:"body"`               // function body code (inside braces)
	Code      string      `json:"code"`               // full function source code (including signature and body)
	Doc       string      `json:"doc"`                // documentation comment above the function, if any
}

type GoImport struct {
	Path    string `json:"path"`    // import path
	Alias   string `json:"alias"`   // local alias or "_" if used, empty if none
	Comment string `json:"comment"` // trailing comment on the import line, if any
	Doc     string `json:"doc"`     // documentation comment above the import spec, if any
}

type GoMethod struct {
	Name      string `json:"name"`      // method name (or embedded interface type name)
	Signature string `json:"signature"` // method signature (empty if embedded interface)
	Comment   string `json:"comment"`   // trailing comment, if any
	Doc       string `json:"doc"`       // documentation comment above method, if any
}

type GoPackage struct {
	Name          string       `json:"name"`          // Package name
	Imports       []GoImport   `json:"imports"`       // Imported packages
	Functions     []GoFunction `json:"functions"`     // Top-level functions and methods
	Types         []GoType     `json:"types"`         // Type definitions (structs, interfaces, aliases, etc.)
	Constants     []GoConstant `json:"constants"`     // Top-level constants
	Variables     []GoVariable `json:"variables"`     // Top-level variables
	PackageDoc    string       `json:"packageDoc"`    // Package documentation comment, if any
	LicenseHeader string       `json:"licenseHeader"` // License/header comments before package, if any
}

type GoReceiver struct {
	Name string `json:"name"` // receiver name (may be empty if omitted)
	Type string `json:"type"` // receiver type (e.g. "T" or "*T")
}

type GoType struct {
	Name             string     `json:"name"`
	Kind             string     `json:"kind"`              // "struct", "interface", "alias", or "type" (for other definitions)
	AliasOf          string     `json:"aliasOf,omitempty"` // target type if Kind == "alias"
	UnderlyingType   string     `json:"underlyingType"`    // underlying type (for non-alias; "struct" or "interface" or literal type)
	Fields           []GoField  `json:"fields,omitempty"`  // fields if struct
	InterfaceMethods []GoMethod `json:"methods,omitempty"` // methods if interface (includes embedded interfaces as entries with empty Signature)
	Code             string     `json:"code"`              // full type declaration source code
	Doc              string     `json:"doc"`               // documentation comment above the type, if any
}

type GoVariable struct {
	Name    string `json:"name"`
	Type    string `json:"type"`    // type of the variable, if specified
	Value   string `json:"value"`   // initial value, if any
	Doc     string `json:"doc"`     // documentation comment above, if any
	Comment string `json:"comment"` // trailing comment, if any
}