meta

type Availability struct {
	MacOSIntroduced string   `json:"macos_introduced,omitempty"`
	MacOSDeprecated string   `json:"macos_deprecated,omitempty"`
	MacOSObsoleted  string   `json:"macos_obsoleted,omitempty"`
	DeprecationMsg  string   `json:"deprecation_message,omitempty"`
	ReplacedBy      string   `json:"replaced_by,omitempty"`
	IsUnavailable   bool     `json:"unavailable,omitempty"`
	Entitlements    []string `json:"entitlements,omitempty"`
}

type BlockType struct {
	Params []Param    `json:"args,omitempty"`
	Return ReturnType `json:"return"`
}

type Class struct {
	Super         string       `json:"super,omitempty"`
	Protocols     []string     `json:"protocols,omitempty"`
	GenericParams []string     `json:"generic_params,omitempty"`
	Methods       []Method     `json:"methods,omitempty"`
	Properties    []Property   `json:"properties,omitempty"`
	Availability  Availability `json:"availability,omitempty"`
	SDKFile       string       `json:"sdk_file,omitempty"`
	SDKLine       int          `json:"sdk_line,omitempty"`
	SwiftName     string       `json:"swift_name,omitempty"`
	Doc           string       `json:"doc,omitempty"`

	// IsMainThreadRequired is set at load time (not scanned) when the class is
	// isolated to Swift's @MainActor — directly or by inheriting it from an
	// ancestor — meaning its instances must be used on the main thread. The
	// idiomatic emitter wraps such calls in purego.Main. Populated by the
	// mainactor sidecar merge + hierarchy propagation; never serialised to
	// .gometa.json.
	IsMainThreadRequired bool `json:"-"`
}

type Enum struct {
	GoType       string       `json:"go_type"`
	Members      []EnumMember `json:"members,omitempty"`
	IsAnon       bool         `json:"is_anon,omitempty"`
	Availability Availability `json:"availability,omitempty"`
	SDKFile      string       `json:"sdk_file,omitempty"`
	SDKLine      int          `json:"sdk_line,omitempty"`
	IsBitmask    bool         `json:"is_bitmask,omitempty"`
	IsExtensible bool         `json:"is_extensible,omitempty"`
	Doc          string       `json:"doc,omitempty"`
}

type EnumMember struct {
	Name         string       `json:"name"`
	Value        string       `json:"value"`
	Availability Availability `json:"availability,omitempty"`
	Doc          string       `json:"doc,omitempty"`
}

type Extern struct {
	Name         string       `json:"name"`
	ObjCType     string       `json:"objc_type"`
	GoType       string       `json:"go_type,omitempty"`
	Availability Availability `json:"availability,omitempty"`
	SDKFile      string       `json:"sdk_file,omitempty"`
	SDKLine      int          `json:"sdk_line,omitempty"`
	Doc          string       `json:"doc,omitempty"`
}

type FrameworkMeta struct {
	Framework  string               `json:"framework"`
	SDKVersion string               `json:"sdk_version"`
	Arch       string               `json:"arch"`
	Classes    map[string]Class     `json:"classes"`
	Protocols  map[string]Protocol  `json:"protocols"`
	Enums      map[string]Enum      `json:"enums"`
	Structs    map[string]Struct    `json:"structs"`
	Functions  []Function           `json:"functions"`
	Externs    []Extern             `json:"externs"`
	BlockTypes map[string]BlockType `json:"block_types"`
	Typedefs   map[string]string    `json:"typedefs"`

	IsSwiftOnly     bool     `json:"swift_only,omitempty"`
	ParentFramework string   `json:"parent_framework,omitempty"`
	UmbrellaFor     []string `json:"umbrella_for,omitempty"`

	ForeignExtensions map[string][]Method `json:"foreign_extensions,omitempty"`
	DeclaredImports   map[string]bool     `json:"declared_imports,omitempty"`

	// LinkLib, when non-empty, means this is a plain C library (not an ObjC framework).
	// The generated package uses purego.Dlopen with the library path instead of a
	// framework path.
	LinkLib string `json:"link_lib,omitempty"`

	// SchemaVersion records which generation of the .gometa.json schema wrote
	// the file (stamped by internal/meta.Write at scan time); Read checks it
	// against internal/meta's supported window.
	SchemaVersion int `json:"schema_version,omitempty"`

	// ClangVersion and XcodeVersion are toolchain provenance recorded at scan
	// time. Carried here so tools reading via this package can surface them.
	ClangVersion string `json:"clang_version,omitempty"`
	XcodeVersion string `json:"xcode_version,omitempty"`
}

type Function struct {
	Name         string       `json:"name"`
	Params       []Param      `json:"args,omitempty"`
	Return       ReturnType   `json:"return"`
	IsInline     bool         `json:"inline,omitempty"`
	IsVariadic   bool         `json:"variadic,omitempty"`
	Availability Availability `json:"availability,omitempty"`
	SDKFile      string       `json:"sdk_file,omitempty"`
	SDKLine      int          `json:"sdk_line,omitempty"`
	IsWarnUnused bool         `json:"warn_unused,omitempty"`
	Doc          string       `json:"doc,omitempty"`
}

type Method struct {
	Selector             string       `json:"selector"`
	IsClassMethod        bool         `json:"class_method,omitempty"`
	Params               []Param      `json:"args,omitempty"`
	Return               ReturnType   `json:"return"`
	IsInit               bool         `json:"is_init,omitempty"`
	IsNSError            bool         `json:"has_nserror,omitempty"`
	IsVariadic           bool         `json:"variadic,omitempty"`
	Availability         Availability `json:"availability,omitempty"`
	SDKFile              string       `json:"sdk_file,omitempty"`
	SDKLine              int          `json:"sdk_line,omitempty"`
	IsDesignatedInit     bool         `json:"designated_init,omitempty"`
	IsWarnUnused         bool         `json:"warn_unused,omitempty"`
	SwiftName            string       `json:"swift_name,omitempty"`
	Doc                  string       `json:"doc,omitempty"`
	IsOptional           bool         `json:"is_optional,omitempty"`
	IsMainThreadRequired bool         `json:"main_thread_required,omitempty"`

	// IsMainThreadExempt is set at load time (not scanned) when the method is
	// `nonisolated` — it explicitly opts out of its class's @MainActor isolation
	// and must NOT be wrapped in purego.Main even though the class is otherwise
	// main-thread-bound. Populated by the mainactor sidecar merge.
	IsMainThreadExempt bool `json:"-"`
}

type Param struct {
	Name       string `json:"name"`
	ObjCType   string `json:"objc_type"`
	IsBlock    bool   `json:"is_block,omitempty"`
	BlockRef   string `json:"block_ref,omitempty"`
	IsNullable bool   `json:"nullable,omitempty"`
	IsNoescape bool   `json:"no_escape,omitempty"`
	Direction  string `json:"modifier,omitempty"`
}

type Property struct {
	Name         string       `json:"name"`
	ObjCType     string       `json:"objc_type"`
	IsReadOnly   bool         `json:"readonly,omitempty"`
	IsWeak       bool         `json:"weak,omitempty"`
	IsCopy       bool         `json:"copy,omitempty"`
	Getter       string       `json:"getter,omitempty"`
	Setter       string       `json:"setter,omitempty"`
	Availability Availability `json:"availability,omitempty"`
	SDKFile      string       `json:"sdk_file,omitempty"`
	SDKLine      int          `json:"sdk_line,omitempty"`
	Doc          string       `json:"doc,omitempty"`
}

type Protocol struct {
	InheritedProtocols []string     `json:"protocols,omitempty"`
	Methods            []Method     `json:"methods,omitempty"`
	Availability       Availability `json:"availability,omitempty"`
}

type ReturnType struct {
	ObjCType          string `json:"objc_type"`
	IsGeneric         bool   `json:"is_generic,omitempty"`
	GenericParamName  string `json:"generic_param_name,omitempty"`
	IsInstancetype    bool   `json:"instancetype,omitempty"`
	IsAlreadyRetained bool   `json:"already_retained,omitempty"`
	IsNullable        bool   `json:"nullable,omitempty"`
}

type Struct struct {
	Fields       []StructField `json:"fields,omitempty"`
	Availability Availability  `json:"availability,omitempty"`
	SDKFile      string        `json:"sdk_file,omitempty"`
	SDKLine      int           `json:"sdk_line,omitempty"`
	Doc          string        `json:"doc,omitempty"`
}

type StructField struct {
	Name     string `json:"name"`
	ObjCType string `json:"objc_type"`
	GoType   string `json:"go_type,omitempty"`
}