editor

type EditOptions struct {
	// TargetFile is the path to the file to copy before editing and atomically replace upon validation.
	// If TargetFile does not exist yet, editing starts from an empty file.
	TargetFile string

	// TempDir is the directory where temporary editing files are created.
	// If empty, defaults to filepath.Dir(TargetFile) when TargetFile is set, or os.TempDir().
	TempDir string

	// TempPrefix is the prefix used when creating the temporary file.
	TempPrefix string

	// FileExtension is the suffix for the temporary file (e.g. ".yaml"). Defaults to ".tmp".
	FileExtension string

	// RejectedFile is the file path where unapplied changes are saved if the user aborts
	// after a validation failure. If empty and TargetFile is set, defaults to TargetFile + ".rejected".
	RejectedFile string

	// Filetype specifies the syntax filetype (e.g. "yaml") for Vim editors.
	Filetype string

	// VimSpecs specifies optional autocomplete keys/values when the editor is Vim/Neovim.
	VimSpecs []VimKeySpec

	// Validate is called on the temporary file after each edit.
	// If Validate returns a non-nil error, the error is prepended as a comment block at the top
	// of the temporary file and the editor is re-opened so the user can fix the issue.
	Validate func(editedPath string) error

	// Apply is an optional callback to apply the validated temporary file.
	// If nil and TargetFile is set, the validated temporary file is atomically renamed to TargetFile.
	Apply func(validatedPath string) error
}

type VimKeySpec struct {
	Key    string
	Menu   string
	Values []VimValueOption
}

type VimValueOption struct {
	Word string
	Menu string
}