transform

type DoTransform func(*TargetData) (*TargetData, core.ResultList)

type Target struct {
	// The name(s) of the target.
	// The convention is to use lowercase letters, with '-' as a separator, if
	// required.
	// The first name in the list is the default name, which is used and
	// displayed in the CLI. Other names in the list are valid names when the
	// user inputs them. At least one name must be provided.
	Names []string

	// A short description of the target.
	// This is used to enhance the user experience in the CLI, and possibly,
	// in other places.
	Description string

	// The list of file extensions (suffixes) that represent this target.
	// The first extension in the list is the default extension, which is
	// used as the default extension for output (generated) files.
	// At least one extension must be provided.
	// Other extensions in the list are used to automatically detect the target
	// type from the input file name.
	Extensions []string

	// An optional generation context for this target.
	// This is used to parse and generate the target code from a USM source.
	// If nil, assumes that the target cannot be generated from a USM source.
	GenerationContext *gen.GenerationContext

	Transformations TransformationCollection
}

type TargetCollection struct {
	Targets      []*Target
	NameToTarget faststringmap.Map[*Target]
}

type TargetData struct {
	// A target instance that describes current target type.
	*Target

	// A representation of the target data as code.
	// If nil, an artifact representation is used instead, and must be provided.
	Code *gen.FileInfo

	// A representation of the target data as a binary artifact.
	// If not nil, this is the preferred representation of the target data,
	// and the code representation is ignored.
	Artifact *bytes.Buffer
}

type Transformation struct {
	Names       []string
	Description string

	// The name of the target of this transformation.
	TargetName string

	Transform DoTransform
}

type TransformationCollection struct {
	Transformations      []*Transformation
	NameToTransformation faststringmap.Map[*Transformation]
}