internal

type ConverterFuncField struct {
	// FieldName is a name of the field.
	FieldName string

	// Source is a source type of the function.
	Source types.Type

	// Dest is a source type of the function.
	Dest types.Type

	// ObjectID is an object id of the function.
	// If this function is a  global function, ObjectID is an empty string.
	ObjectID string
	// contains filtered or unexported fields
}

type FieldMapping struct {
	// A is a name of the field defined in [Mapping].A.
	A string

	// B is a name of the field defined in [Mapping].B.
	B string

	// Uses uses a given mapper/converter to map this field.
	Uses string

	// UsesForElements uses a given mapper/converter to map elements of this field.
	UsesForElements string `mapstructure:"uses-for-elements"`

	// SourceFile is a source file path that contains this configuration.
	SourceFile string
}

type FieldMappings []*FieldMapping

type FuncID string

type Generation struct {
	// Mappers are a definition of the collection of mappers.
	Mappers *Mappers

	// Mappings is definitions of the mappings.
	Mappings []*Mapping

	// SourceFile is a source file path that contains this configuration.
	SourceFile string
}

type Generator interface {
	Generate() error
}

type Ignores []*FieldMapping

type Log func(level LogLevel, format string, args ...any)

type LogLevel int

type MapperFuncField struct {
	// FieldName is a name of the field.
	FieldName string

	// Source is a source type of the function.
	Source types.Type

	// Dest is a source type of the function.
	Dest types.Type

	// ObjectID is an object id of the function.
	// If this function is a  global function, ObjectID is an empty string.
	ObjectID string
	// contains filtered or unexported fields
}

type Mappers struct {
	// Package is a package of a mappers.
	Package string

	// Destination is a file path that this mappers will be written.
	Destination string

	// NilMap defines how are nil maps are mapped.
	NilMap NilCollection `mapstructure:"nil-map"`

	// NilSlice defines how are nil maps are mapped.
	NilSlice NilCollection `mapstructure:"nil-slice"`

	// SourceFile is a source file path that contains this configuration.
	SourceFile string
}

type Mapping struct {
	// ID is an ID of a mapper.
	// If this is empty, Name will be used as an ID.
	ID string

	// Name is a name of a mapper.
	Name string

	// Package is a package of a mapper.
	Package string

	// Destination is a file path that this mapper will be written.
	Destination string

	// AtoB is a name of a function.
	AtoB string `mapstructure:"a-to-b"`

	// AtoB is a name of a function.
	BtoA string `mapstructure:"b-to-a"`

	// Bidirectional means this mapping is a bi-directional mapping.
	Bidirectional bool

	// A is a mapping operand.
	A *MappingOperand

	// B is a mapping operand.
	B *MappingOperand

	// SourceFile is a source file path that contains this configuration.
	SourceFile string

	// ObjectMapping is a mapping definition for objects.
	ObjectMapping `mapstructure:",squash"`
}

type MappingContext struct {
	// contains filtered or unexported fields
}

type MappingOperand struct {
	// Package is a package path
	Package string

	// Name is a type name of the target.
	// This type must be defined in the File.
	Name string

	// SourceFile is a source file path that contains this configuration.
	SourceFile string
}

type MappingValue interface {
	// GetGetterSource returns a source code of the getter.
	GetGetterSource() string

	// CanGet returns true if this value is readable.
	CanGet() bool

	// CanAddr returns true if this value with getter is addressable.
	CanAddr() bool

	// GetSetterSource returns a source code of the setter.
	GetSetterSource(valueSource string) string

	// DisplayName returns a name for humans.
	DisplayName() string

	// CanSet returns true if this value is writable.
	CanSet() bool

	// Type is a type of the value
	Type() types.Type
}

type NilCollection int

type ObjectMapping struct {
	// ExplicitOnly indicates that implicit mappings should not be
	// performed.
	ExplicitOnly bool `mapstructure:"explicit-only"`

	// IgnoreCase means this mapping ignores field name casing.
	IgnoreCase bool `mapstructure:"ignore-case"`

	// AllowUnmapped is set true, sesame does not fail if unmapped
	// field exists.
	AllowUnmapped bool `mapstructure:"allow-unmapped"`

	// Fields is definitions of how fields will be mapped.
	Fields FieldMappings

	// Ignores is definitions of the fileds should be ignored.
	Ignores Ignores

	// NilMap defines how are nil maps are mapped.
	NilMap NilCollection `mapstructure:"nil-map"`

	// NilSlice defines how are nil maps are mapped.
	NilSlice NilCollection `mapstructure:"nil-slice"`
}

type OperandType int

type Printer interface {
	io.Closer

	// P writes formatted-string and a newline.
	P(string, ...any)

	// WriteDoNotEdit writes a "DO NOT EDIT" header.
	WriteDoNotEdit()

	// AddVar adds a template variable name.
	AddVar(string)

	// ResolveVar resolves a variable value.
	ResolveVar(string, string)
}