view

type BlockTypeModel struct {
	GoName    string // Go type alias name, e.g. CompletionBlock
	Framework string // Framework name for the doc comment, e.g. Foundation
	Sig       string // Complete Go func signature, e.g. func(result uint64, ok bool)
}

type BridgeAllocImplModel struct {
	ClassName string
	FuncName  string
}

type BridgeAllocModel struct {
	ClassName string // ObjC class name, e.g. "NSWindow"
	FuncName  string // C function name, e.g. "foundation_NSWindow_alloc"
}

type BridgeDeclModel struct {
	Entitlements []string // // Requires entitlement: ... lines
	BridgeID     string   // e.g. "Foundation.NSString/stringWithCString:encoding:"
	Decl         string   // complete C declaration, without trailing semicolon
}

type BridgeExternGetterModel struct {
	SymbolName string // C symbol, e.g. "mach_task_self_"
	GetterName string // bridge function, e.g. "machinit_extern_mach_task_self_"
}

type BridgeHeaderModel struct {
	MethodDecls   []BridgeDeclModel
	AllocHelpers  []BridgeAllocModel
	CodingDecls   string // pre-rendered NSCoding declarations block
	FunctionDecls []BridgeDeclModel
	ForeignDecls  []BridgeDeclModel
	ProtoDecls    []BridgeProtoDeclModel
	ExternGetters []BridgeExternGetterModel
}

type BridgeImplMethodModel struct {
	Entitlements      []string
	BridgeID          string
	RetType           string // C return type, e.g. "void *" or "bool"
	FuncName          string
	Params            string
	IsNSError         bool
	NeedsFormatPragma bool // true for multi-keyword format-variadic methods where @"%@" trick cannot be used
	// TryBody is the pre-rendered content of the @try block: ObjC call + result handling.
	// The complex dispatch (void / object / struct-by-value / primitive + NSError variants)
	// lives in buildBridgeTryBody so the template shows only the @try/@catch structure.
	TryBody     string
	CatchReturn string // zero-value return for @catch, e.g. "return nil;" or ""
}

type BridgeImplModel struct {
	Framework       string
	ParentFramework string
	// UmbrellaHeader is the C library umbrella include path relative to the
	// SDK's usr/include (e.g. "compression.h", "os/log.h"). When non-empty it
	// replaces the framework-style <Name/Name.h> import.
	UmbrellaHeader string
	// LocalHeader is the file name of a shim prototype header copied into the
	// bridge/ directory (private libraries with no SDK header). When non-empty
	// it is included with quotes and takes precedence over UmbrellaHeader.
	LocalHeader    string
	HeaderName     string
	Methods        []BridgeImplMethodModel
	AllocImpls     []BridgeAllocImplModel
	CodingImpls    string // pre-rendered NSCoding implementation block
	Functions      []BridgeImplMethodModel
	ForeignMethods []BridgeImplMethodModel
	ProtoMethods   []BridgeImplMethodModel
	ExternGetters  []BridgeExternGetterModel
}

type BridgeProtoDeclModel struct {
	BridgeID string
	RetType  string
	FuncName string
	Params   string
}

type BridgeShimModel struct {
	Stem string // e.g. "foundation_bridge" (produces bridge/foundation_bridge.m include)
}

type CfAliasModel struct {
	GoAlias   string // e.g. CFMutableStringRef
	GoPrimary string // e.g. CFStringRef
}

type CfWrapperModel struct {
	GoName string // Primary type name, e.g. CFStringRef
	// NoTrack omits the cgo.Track finalizer from New<GoName>. Purego-backed
	// libraries set it: cgo.Track finalizes with objc_release, which is
	// undefined behaviour on a plain C handle (xar_t is not an ObjC object),
	// and would pull the CGo runtime into a CGO_ENABLED=0 package. Handle
	// lifetime is the library's own close/free API.
	NoTrack bool
}

type ClassConstructorsModel struct {
	Name string
	// GenSuffix is "[cgo.Object]" for a generic class, otherwise empty.
	GenSuffix string
	// Chain is the value-chain literal that builds the wrapper, e.g.
	// "&NSMutableArray[cgo.Object]{NSArray[cgo.Object]{NSObject{ptr: ptr}}}".
	Chain string
	// ValueChain is Chain without the leading "&" — the value form returned by
	// <Class>WithPtr.
	ValueChain string
}

type ClassFileHeaderModel struct {
	Framework    string   // e.g. "Foundation"
	PkgName      string   // e.g. "foundation"
	BridgeHeader string   // e.g. "foundation_bridge.h"
	Imports      []string // sorted, deduplicated import paths
}

type ClassInterfaceModel struct {
	GoName      string // ObjC class name; the interface is GoName+"able"
	EmbedLine   string // Embedded type: "cgo.Object", "pkg.Superabled", or "Superable"
	Methods     []InterfaceMethodModel
	HasNSCoding bool
}

type ClassInterfacesFileModel struct {
	PkgName    string
	Imports    []string // sorted, deduplicated import paths
	UsesUnsafe bool     // true when any method references unsafe.Pointer
	UsesObjc   bool     // true when any method or embed references cgo.*
	Interfaces []ClassInterfaceModel
}

type ClassMethodModel struct {
	// PreambleComment is the doc/context comments plus designated-init,
	// warn-unused, swift-name, blocked-import, and out-parameter notes (column 0).
	PreambleComment string
	// BridgeID is the "// <framework>_<Class>_<selector>…" identifier comment.
	BridgeID string
	// IsClassMethod selects a package-level function over an instance method.
	IsClassMethod bool
	// Receiver is the instance receiver type (instance methods only).
	Receiver string
	// GoName is the instance method name (instance methods only).
	GoName string
	// FuncName is the package-level function name (class methods only).
	FuncName string
	// GoArgs is the rendered parameter list.
	GoArgs string
	// RetStr is the return clause, " T" or empty.
	RetStr string
	// Body is the resolved method body.
	Body MethodBodyModel
	// Skip renders only the preamble comment (no function): a class method whose
	// generated name collides with a package-level type is dropped, but — matching
	// the original — its doc comment is still emitted.
	Skip bool
}

type ClassStructModel struct {
	// CommentBlock is the wraps/superclass/protocols/swift-name doc plus the
	// shared context comments (column 0, trailing newline).
	CommentBlock string
	// TypeHeader is the type name with any generic constraint, e.g. "NSArray" or
	// "NSArray[T cgo.Object]".
	TypeHeader string
	// EmbedLine is the struct's single line: "ptr unsafe.Pointer" for a root
	// class, otherwise the embedded superclass field.
	EmbedLine string
	// IsRoot emits the ptr field's promoted Ptr() accessor.
	IsRoot bool
	// PtrReceiver is the receiver type for Ptr(), e.g. "NSObject" or
	// "NSArray[T]" (root only).
	PtrReceiver string
	// AssertType is the type in the `var _ cgo.Object = (*…)(nil)` assertion,
	// e.g. "NSObject" or "NSArray[cgo.Object]".
	AssertType string
}

type CodingMethodsModel struct {
	Name          string
	SerializeFn   string
	DeserializeFn string
}

type DesignatedInitModel struct {
	CtorName  string
	ClassName string
	Selector  string
	ArgList   string // the factory's Go parameter list
	ReturnSig string // "*Class" or "(*Class, error)"
	AllocFn   string // the C alloc bridge function name
	CallExpr  string // "_obj.<Init>(<args>)"
	// Kind selects the result handling: 0 the init already returns *Class;
	// 1 id-return + error; 2 id-return; 3 unsafe.Pointer-return + error;
	// 4 unsafe.Pointer-return.
	Kind int
}

type EnumMemberModel struct {
	ConstName    string // Go identifier for the constant (e.g. NSOrderedAscending)
	Value        string // Raw value expression (e.g. "-1", "0x1")
	ObjCName     string // Original ObjC name; used as the string in String() and Parse()
	CommentBlock string // Pre-rendered comment lines with "\t" prefix (may be empty)
	IsZeroVal    bool   // Bitmask enums: this member represents the zero-value case
}

type EnumModel struct {
	GoName        string            // Go type name (e.g. NSComparisonResult)
	GoType        string            // Underlying Go type (e.g. int64, uint64)
	IsBitmask     bool              // Bitmask enums use | combination, not switch
	HasMembers    bool              // Whether helper methods (String, Parse, etc.) should be emitted
	CommentBlock  string            // Pre-rendered type-level comment lines (may be empty)
	Members       []EnumMemberModel // All members for the const block
	UniqueMembers []EnumMemberModel // Deduped members for the String() switch (non-bitmask only)
	FirstConst    string            // First constant name; seeds result in ParseX (non-bitmask only)
	DefaultFmt    string            // Format string for String() default case, e.g. "NSFoo(%d)"
}

type ExternItemModel struct {
	GoName       string // Go identifier
	GoType       string // Go type string
	CommentBlock string // Pre-rendered comment lines with "\t" prefix (may be empty)
	// InitExpr is the Go expression assigned in init(), reading the C global
	// through its bridge getter. Empty means the extern's shape is not
	// supported for initialisation and the var stays zero-valued.
	InitExpr string
	// SymbolName is the original C symbol backing the var.
	SymbolName string
}

type ExternsFileModel struct {
	PkgName string
	Imports []string
	Items   []ExternItemModel
	// BridgeInclude is the package-relative bridge header path (e.g.
	// "bridge/machinit_bridge.h"), set when at least one item has an InitExpr
	// so the file carries its own import "C" block.
	BridgeInclude string
	HasInit       bool
}

type FunctionModel struct {
	CommentBlock string
	BridgeID     string // e.g. "Foundation/NSStringFromClass"
	IsWarnUnused bool
	GoName       string
	Params       string   // Full parameter list of mapped ObjC args
	Ret          string   // Return type string, empty for void
	KeepAlives   []string // ObjC-object arg names to keep alive across the CGo call
	Preambles    []string // Statements to emit before the CGo call
	// CallBody is the pre-rendered CGo call + exception check + optional return.
	// The complex return-path dispatch (void / cgo.Object / value struct / primitive)
	// is resolved in Go (buildFunctionCallBody) so the template stays structural.
	CallBody string
}

type FunctionsFileModel struct {
	PkgName   string
	FwLower   string
	Imports   []string
	Functions []FunctionModel
}

type GenericHelperModel struct {
	Name   string
	TChain string // the &Class[T]{…} value chain
}

type InterfaceMethodModel struct {
	GoName string // Go method name
	Params string // Full parameter list of mapped ObjC args
	Ret    string // Return type string, empty for void
}

type MethodBodyModel struct {
	// HasReceiver emits `defer cgo.KeepAlive(<ReceiverVar>)` for instance methods
	// and id<Protocol> proxy methods.
	HasReceiver bool
	// ReceiverVar is the receiver variable name kept alive — "o" for class
	// instance methods, "p" for id<Protocol> proxy methods.
	ReceiverVar string
	// KeepAlives are ObjC-object argument names kept alive across the C call.
	KeepAlives []string
	// Preambles are pre-call setup statements (C-string conversions, block
	// trampolines) whose deferred cleanup runs at method exit.
	Preambles []string
	// HasNSError adds the trailing NSError out-parameter handling.
	HasNSError bool
	// RetKind selects capture + return handling: 0 void, 1 cgo.Object, 2 typed
	// object, 3 value struct, 4 nullable string, 5 scalar/other.
	RetKind int
	// RawCall is the C bridge call expression, e.g. "C.foo_bar(o.Ptr(), &_exc)".
	RawCall string
	// ResultExpr is the converted scalar result captured for RetKind 5.
	ResultExpr string
	// RetType is the Go return type, used for the value-struct zero literal and
	// pointer dereference (RetKind 3).
	RetType string
	// WrapTypedExpr is the constructor reference passed to cgo.WrapTyped for a
	// typed object return (RetKind 2).
	WrapTypedExpr string
}

type NsStringOverloadModel struct {
	// Signature is the full function signature up to the opening brace.
	Signature string
	// HasReturn is true when the wrapped call's result is returned.
	HasReturn bool
	// CallExpr is the forwarding call into the underlying method/function.
	CallExpr string
}

type ProtocolImplGoFileModel struct {
	PackageName         string   // e.g. "foundation"
	GoClassName         string   // e.g. "goBridgeProto_NSCacheDelegate"
	ProtoName           string   // e.g. "NSCacheDelegate"
	CallbacksStructName string   // e.g. "NSCacheDelegateCallbacks"
	FactoryName         string   // e.g. "NewNSCacheDelegateProtocolCallback"
	IMPSigs             []string // sorted unique IMP sig names
	NeedsObjc           bool     // true when return type is cgo.Object (no proxy)
	ImplFields          string   // pre-rendered struct field lines (tab-indented)
	FactoryComment      string   // pre-rendered factory function doc comment block
	ReturnType          string   // "*NSCacheDelegateIDProtocol" or "cgo.Object"
	AddMethodBody       string   // pre-rendered per-method addMethod if-blocks (no outer wrapper)
	BindMethodBody      string   // pre-rendered per-method BindMethod if-blocks
	ReturnBody          string   // pre-rendered return statement(s) (tab-indented)
}

type ProtocolImplHFileModel struct {
	GoClassName string
	IMPSigs     []string
}

type ProtocolImplMFileModel struct {
	Framework   string
	ProtoName   string
	GoClassName string
	HeaderFile  string // e.g. "NSCacheDelegate_impl_generated.h"
	IMPSigs     []string
}

type ProtocolMethodModel struct {
	GoName string // Go method name
	Params string // Full parameter list string of mapped ObjC args
	Ret    string // Return type string, empty for void
}

type ProtocolModel struct {
	GoName        string
	ObjCName      string
	AvailComment  string   // e.g. "Introduced: macOS 10.9" — empty when not set
	Embeds        []string // Embedded interface identifiers (same-fw and cross-fw)
	EmbedComments []string // Comment lines for blocked cross-fw embeds
	Methods       []ProtocolMethodModel
}

type ProtocolProxiesFileModel struct {
	PkgName      string
	BridgeHeader string   // e.g. "foundation_bridge.h"
	Imports      []string // sorted, deduplicated import paths
	ProxyTypes   []ProtocolProxyTypeModel
}

type ProtocolProxyMethodModel struct {
	GoName       string // Go method name
	Params       string // full parameter list of mapped ObjC args
	Ret          string // return type string, empty for void
	AvailComment string // availability comment, empty if none
	BodyLines    string // pre-rendered method body lines (tab-indented)
}

type ProtocolProxyTypeModel struct {
	IDTypeName      string // e.g. "NSCacheDelegateIDProtocol"
	ProtoName       string // e.g. "NSCacheDelegate"
	NSObjectEmbed   string // "NSObject" or "foundation.NSObject"
	NSObjectWithPtr string // "NSObjectWithPtr" or "foundation.NSObjectWithPtr"
	AvailComment    string // availability comment, empty if none
	Methods         []ProtocolProxyMethodModel
}

type ProtocolsFileModel struct {
	PkgName string
	Imports []string
	// RootObject is the qualified Object interface every protocol interface
	// embeds: "cgo.Object" for the cgo backend, "objptr.Object" (pure Go) for
	// the purego backend.
	RootObject string
	Protocols  []ProtocolModel
}

type StructFieldModel struct {
	Name   string
	GoType string
}

type StructModel struct {
	GoName       string
	CommentBlock string
	Fields       []StructFieldModel
}

type StructTypedefModel struct {
	GoAlias  string
	GoTarget string
}

type SubclassGoFileModel struct {
	ClassName       string   // e.g. "NSCharacterSet"
	GoClassName     string   // e.g. "GoOrinSubNSCharacterSet"
	PackageName     string   // e.g. "foundation"
	IMPSigs         []string // sorted unique IMP sig names
	OverridesFields string   // pre-rendered struct field lines (tab-indented, ends with \n)
	AddMethodBody   string   // pre-rendered per-method add_method if-blocks (inside "if overrides != nil")
	BindMethodBody  string   // pre-rendered per-method BindMethod if-blocks (inside "if overrides != nil")
}

type SubclassHFileModel struct {
	GoClassName string
	IMPSigs     []string
}

type SubclassMFileModel struct {
	Framework   string // e.g. "Foundation"
	ClassName   string // e.g. "NSCharacterSet"
	GoClassName string // e.g. "GoOrinSubNSCharacterSet"
	HeaderFile  string // e.g. "NSCharacterSet_subclass_generated.h"
	IMPSigs     []string
}

type TypedWithPtrModel struct {
	Name        string
	TValueChain string // the Class[T]{…} value chain (no leading &)
}

type VariadicWrappersFileModel struct {
	PkgName string // Go package name, e.g. "foundation"
}