scanner

type ASTNode struct {
	ID          string    `json:"id"`
	Kind        string    `json:"kind"`
	Loc         *Location `json:"loc"`
	Range       *SrcRange `json:"range"`
	Name        string    `json:"name"`
	MangledName string    `json:"mangledName"`
	Type        *ASTType  `json:"type"`
	ReturnType  *ASTType  `json:"returnType"`
	Inner       []ASTNode `json:"inner"`

	// PreviousDecl is the hex ID string of the previous declaration of this
	// name in the same translation unit. When set, this node is a redeclaration
	// (e.g. @class Foo; repeated after the canonical @interface Foo...@end, or
	// an empty @class Foo; that precedes the canonical definition). Used in
	// extractClass to distinguish canonical definitions from foreign-class
	// forward declarations.
	PreviousDecl string `json:"previousDecl"`

	// ObjCInterfaceDecl / ObjCCategoryDecl
	Super     *ASTRef  `json:"super"`
	Protocols []ASTRef `json:"protocols"`
	// ObjCCategoryDecl: the class this category extends
	Interface *ASTRef `json:"interface"`

	// ObjCMethodDecl — Clang uses "instance": true for instance methods,
	// absence of the field (or false) means class method.
	IsInstance bool `json:"instance"`
	IsVariadic bool `json:"variadic"`
	IsImplicit bool `json:"implicit"`

	// ObjCPropertyDecl
	Getter *ASTRef `json:"getter"`
	Setter *ASTRef `json:"setter"`
	// property attribute flags: "readonly", "copy", "weak", "assign", etc.
	PropertyAttributes []string `json:"propertyAttributes"`

	// EnumDecl
	FixedUnderlyingType *ASTType `json:"fixedUnderlyingType"`

	// RecordDecl (struct/union)
	TagUsed            string `json:"tagUsed"`            // "struct" or "union"
	CompleteDefinition bool   `json:"completeDefinition"` // true for full record decl, false/missing for forward decl

	// VarDecl
	StorageClass string `json:"storageClass"` // "extern"

	// IntegerLiteral / FloatingLiteral / ConstantExpr
	// Clang emits numeric literals as JSON numbers; use RawMessage to handle both
	// number and string variants uniformly.
	Value RawValue `json:"value"`

	// Availability
	Availability []ASTNode `json:"availability"` // AvailabilityAttr nodes

	// AvailabilityAttr fields
	Platform   string `json:"platform"` // "macos", "ios"
	Introduced string `json:"introduced"`
	Deprecated string `json:"deprecated"`
	Obsoleted  string `json:"obsoleted"`
	Message    string `json:"message"`

	// ObjCTypeParamDecl — generic type params on a class
	// appears as inner nodes of ObjCInterfaceDecl
	Bound *ASTType `json:"bound"` // upper bound (usually "id")

	// Nullability qualifier attached to a type
	NullabilityQual string `json:"nullabilityQual"` // "nullable", "nonnull", "unspecified"

	// SwiftNameAttr carries the NS_SWIFT_NAME value; appears as an inner node.
	SwiftName string `json:"swiftName,omitempty"`
}

type ASTRef struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type ASTType struct {
	QualType          string `json:"qualType"` // e.g. "NSArray<ObjectType> *", "NSUInteger"
	TypeAliasDeclID   string `json:"typeAliasDeclId"`
	DesugaredQualType string `json:"desugaredQualType"` // after typedef expansion
}

type CLibraryDef struct {
	// LinkLib is the dylib name passed to -l (e.g. "EndpointSecurity" → -lEndpointSecurity).
	LinkLib string `json:"link_lib"`
	// Header is the umbrella header path relative to {SDK}/usr/include/.
	// Empty means use the default {Name}/{Name}.h convention.
	Header string `json:"header,omitempty"`
	// HeaderDir is the filter path relative to {SDK}/usr/include/ used to decide
	// whether an AST node belongs to this library. Empty means derive from Header.
	// Use a directory path (e.g. "bsm/") to accept all headers under that directory,
	// or a file path (e.g. "sandbox.h") to match only that exact file.
	HeaderDir string `json:"header_dir,omitempty"`
	// ShimHeader is a repo-relative path to a hand-maintained prototype header
	// for libraries that ship a linkable .tbd stub in the SDK but no public
	// header (private dylibs such as IOReport). When set it takes precedence
	// over Header/HeaderDir: the scan parses this file, the node filter accepts
	// only declarations made in it, and the bridge emitter ships a copy inside
	// the generated package's bridge/ directory.
	ShimHeader string `json:"shim_header,omitempty"`
	// Backend selects the binding backend for this library: "cgo" (default when
	// empty) emits the ObjC-shim bridge via the CGo pipeline; "purego" emits
	// dlopen/RegisterLibFunc bindings via the purego frameworks pipeline. The
	// per-library key is the migration ratchet — libraries flip one at a time.
	Backend string `json:"backend,omitempty"`
}

type IncludedFromRef struct {
	File string `json:"file"`
}

type Location struct {
	FilePath string `json:"file"`
	Line     int    `json:"line"`
	Col      int    `json:"col"`
	// When the loc is a macro expansion the actual file is in ExpansionLoc
	ExpansionLoc *Location `json:"expansionLoc"`
	// Spelling location (pre-macro-expansion)
	SpellingLoc *Location `json:"spellingLoc"`
	// IncludedFrom is the file that directly includes the file this loc is in.
	// Present when loc.file is absent (Clang cursor optimisation) or when Clang
	// wants to indicate the include chain.
	IncludedFrom *IncludedFromRef `json:"includedFrom"`
}

type RawValue string

type RecordLayout struct {
	Size         int
	Align        int
	FieldOffsets []int
}

type ScanConfig struct {
	// ExtraIncludeDirs lists additional directories (relative to the SDK root,
	// slash-separated) whose headers count as belonging to this framework.
	ExtraIncludeDirs []string `json:"extra_include_dirs,omitempty"`
	// HeaderOverride is the SDK-relative slash-separated path to the entry
	// header to pass to clang, for frameworks that do not ship a conventional
	// <Framework>.framework/Headers/<Framework>.h umbrella (e.g. IOKit, which
	// only exposes individual headers). When set it overrides the default
	// umbrella path computed by FrameworkHeader.
	HeaderOverride string `json:"header_override,omitempty"`
}

type SrcRange struct {
	Begin Location `json:"begin"`
	End   Location `json:"end"`
}