annotations

type Endianness int

type FieldAnnotation struct {
	// ByteOffset is the offset in bytes from the start of the struct
	ByteOffset int
	// BitOffset is the absolute bit offset from the start of the struct (for bitfields)
	BitOffset int
	// BitLength is the length in bits for bitfield fields
	BitLength int
	// Endianness specifies the byte order for multi-byte fields
	Endianness Endianness
	// Skip indicates this field should be skipped during marshaling/unmarshaling
	Skip bool
	// FieldName is the original struct field name
	FieldName string
	// FieldType is the reflect.Type of the field
	FieldType reflect.Type
	// ArrayLength is the length for array fields
	ArrayLength int
	// IsArray indicates if this is an array field
	IsArray bool
	// IsBitfield indicates if this is a bitfield
	IsBitfield bool
	// Reserved indicates this is a reserved/padding field
	Reserved bool
	// HexAsDec indicates values should be treated as hex digits representing decimal
	// e.g., 0x2024 should be treated as year 2024, not 8228
	HexAsDec bool
	// ListSize specifies the field name that contains the count for a list
	// When set, this field is a list whose length is determined at runtime
	ListSize string
	// ListTerminator specifies a byte sequence that terminates the list
	// When the unmarshaler encounters this sequence, it stops reading list elements
	ListTerminator []byte
}

type MarshalOptions struct {
	// IncludeReserved indicates whether to marshal reserved fields
	IncludeReserved bool
	// IncludeSkipped indicates whether to marshal skipped fields
	IncludeSkipped bool
	// OutputSize forces a specific output buffer size (0 means use calculated size)
	OutputSize int
}

type StructAnnotations struct {
	// Fields contains annotations for each field
	Fields []FieldAnnotation
	// TotalSize is the total size of the struct in bytes
	TotalSize int
	// Name is the struct name
	Name string
}

type UnmarshalOptions struct {
	// IncludeReserved indicates whether to unmarshal reserved fields
	IncludeReserved bool
	// IncludeSkipped indicates whether to unmarshal skipped fields
	IncludeSkipped bool
}