types

const (
	// UnixCallingConvention is the System V AMD64 ABI used on Linux, macOS, FreeBSD.
	UnixCallingConvention CallingConvention = iota + 1

	// WindowsCallingConvention is the Win64 (Microsoft x64) calling convention.
	WindowsCallingConvention

	// GnuWindowsCallingConvention is the GNU extension to Windows calling convention.
	GnuWindowsCallingConvention

	// Convenient aliases for common usage
	// DefaultCall automatically selects the platform's native calling convention.
	DefaultCall = CallingConvention(0) // Will be resolved by DefaultConvention()

	// CDecl is an alias for the C calling convention on the current platform.
	CDecl = UnixCallingConvention // Updated by init() on Windows

	// StdCall is Windows-specific (same as WindowsCallingConvention).
	StdCall = WindowsCallingConvention
)

const (
	ReturnVoid    = 0
	ReturnUInt8   = 1
	ReturnUInt16  = 2
	ReturnUInt32  = 3
	ReturnSInt8   = 4
	ReturnSInt16  = 5
	ReturnSInt32  = 6
	ReturnInt64   = 7
	ReturnInXMM32 = 8
	ReturnInXMM64 = 9
	// AMD64 9-16B struct return modes (SysV ABI §3.2.3).
	// Each eightbyte is classified independently as INTEGER (GP register) or SSE (XMM register).
	// These flags drive handleReturn to reconstruct the struct from the correct registers.
	ReturnStRaxRdx   = 10 // {INTEGER, INTEGER} — eightbyte0 in RAX,  eightbyte1 in RDX
	ReturnStRaxXmm0  = 11 // {INTEGER, SSE}     — eightbyte0 in RAX,  eightbyte1 in XMM0
	ReturnStXmm0Rax  = 12 // {SSE, INTEGER}     — eightbyte0 in XMM0, eightbyte1 in RAX
	ReturnStXmm0Xmm1 = 13 // {SSE, SSE}         — eightbyte0 in XMM0, eightbyte1 in XMM1 (e.g. NSPoint/NSSize)
	ReturnViaPointer = 1 << 10
	// ARM64 HFA (Homogeneous Floating-point Aggregate) return flags.
	// HFA structs with 2-4 float/double members are returned in D0-D3.
	// Use with ReturnInXMM32 (float) or ReturnInXMM64 (double) to indicate element type.
	ReturnHFA2 = 1 << 11 // 2 elements in D0-D1
	ReturnHFA3 = 1 << 12 // 3 elements in D0-D2
	ReturnHFA4 = 1 << 13 // 4 elements in D0-D3
)