mold

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

type CodeInfo struct {
	// Code is the canonical code value.
	Code string `json:"code"`
	// Label is the code's display name.
	Label string `json:"label"`
}

type CodeSetChangedEvent struct {
	// Keys lists the affected code set identifiers. When empty, all cached code sets should be cleared.
	Keys []string `json:"keys"`
}

type CodeSetInfo struct {
	// CodeSet is the code set identifier referenced by translate tags and
	// integration code maps (e.g. "gender").
	CodeSet string `json:"codeSet"`
	// Name is the code set's human-readable name.
	Name string `json:"name"`
}

type CodeSetInspector interface {
	// ListCodeSets enumerates the code sets the host catalog exposes.
	ListCodeSets(ctx context.Context) ([]CodeSetInfo, error)
	// ListCodes enumerates one code set's codes with their display labels.
	ListCodes(ctx context.Context, codeSet string) ([]CodeInfo, error)
}

type CodeSetLoader interface {
	// Load loads all codes for the given code set, returning a code-to-label mapping.
	Load(ctx context.Context, codeSet string) (map[string]string, error)
}

type CodeSetLoaderFunc func(ctx context.Context, codeSet string) (map[string]string, error)

type CodeSetResolver interface {
	// Resolve resolves the display name for the given code set and code value.
	// Returns the translated name and an error if resolution fails.
	Resolve(ctx context.Context, codeSet, code string) (string, error)
}

type FieldLevel interface {
	// Transformer represents a subset of the current *Transformer that is executing the current transformation.
	Transformer() Transformer
	// Name returns the name of the current field being modified.
	Name() string
	// Parent returns the top level parent of the current value returned by Field().
	// This is used primarily for the ability to nil out pointer type values.
	// When several layers of abstraction are nested (e.g. an any wrapping an any),
	// it returns the first any.
	Parent() reflect.Value
	// Field returns the current field value being modified.
	Field() reflect.Value
	// Param returns the param associated wth the given function modifier.
	Param() string
	// SiblingField returns the sibling field value of the same struct by field name
	// Returns the field reflect.Value and a boolean indicating if the field exists
	SiblingField(name string) (reflect.Value, bool)
	// Struct returns the struct value that contains the current field.
	// The returned value is invalid when the field is transformed outside of a
	// struct walk (e.g. via Transformer.Field); callers must check IsValid.
	Struct() reflect.Value
}

type FieldTransformer interface {
	// Tag returns the tag name corresponding to this transformer, used for referencing in struct tags
	Tag() string
	// Transform executes field transformation logic, fl provides field-level context information
	Transform(ctx context.Context, fl FieldLevel) error
}

type Func func(ctx context.Context, fl FieldLevel) error

type Interceptor interface {
	// Intercept intercepts the current value and returns the inner value that should be actually operated on
	Intercept(current reflect.Value) (inner reflect.Value)
}

type InterceptorFunc func(current reflect.Value) (inner reflect.Value)

type StructLevel interface {
	// Transformer represents a subset of the current *Transformer that is executing the current transformation.
	Transformer() Transformer
	// Parent returns the top level parent of the current value returned by Struct().
	// This is used primarily for the ability to nil out pointer type values.
	// When several layers of abstraction are nested (e.g. an any wrapping an any),
	// it returns the first any.
	Parent() reflect.Value
	// Struct returns the value of the current struct being modified.
	Struct() reflect.Value
}

type StructLevelFunc func(ctx context.Context, sl StructLevel) error

type StructTransformer interface {
	// Transform executes struct-level transformation logic, sl provides struct-level context information
	Transform(ctx context.Context, sl StructLevel) error
}

type Transformer interface {
	// Struct applies transformations to the entire struct based on field tags
	Struct(ctx context.Context, value any) error
	// Field applies specified transformation tags to a single field
	Field(ctx context.Context, value any, tags string) error
}

type Translator interface {
	// Supports returns true if the translator supports the given kind
	Supports(kind string) bool
	// Translate translates the current value to the corresponding description
	Translate(ctx context.Context, kind, value string) (string, error)
}