mold

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

type DictionaryChangedEvent struct {
	// Keys lists the affected dictionary keys. When empty, all cached dictionaries should be cleared.
	Keys []string `json:"keys"`
}

type DictionaryLoader interface {
	// Load loads all dictionary entries for the given key, returning a code-to-name mapping.
	Load(ctx context.Context, key string) (map[string]string, error)
}

type DictionaryLoaderFunc func(ctx context.Context, key string) (map[string]string, error)

type DictionaryResolver interface {
	// Resolve resolves the corresponding name based on dictionary key and code value.
	// Returns the translated name and an error if resolution fails.
	Resolve(ctx context.Context, key, 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)
}