generic

type DiffConfig[S any] struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// ParseDiffArgs parses the raw positional args into two version specs.
	ParseDiffArgs func(args []string) (S, S, error)
	// NewPresenter builds the provider DiffPresenter bound to the two specs.
	NewPresenter func(ctx context.Context, spec1, spec2 S) (DiffPresenter, error)
}

type DiffOptions struct {
	//declscope:ignore overexported // diff_test.go runs the diff with the AWS presenters, which import this package
	ParseJSON bool

	Output output.Format
	// contains filtered or unexported fields
}

type DiffPresenter interface {
	// Fetch resolves both specs and loads their entries via the provider usecase.
	Fetch(ctx context.Context) error
	// OldValue and NewValue return the two raw values to be compared.
	OldValue() string
	NewValue() string
	// Labels returns the unified-diff header labels for the old and new sides.
	Labels() (oldLabel, newLabel string)
	// RenderJSON writes the provider JSON output. diff is the pre-computed raw
	// unified diff (empty when the versions are identical).
	RenderJSON(stdout io.Writer, oldValue, newValue string, identical bool, diff string) error
	// Hints writes the provider-specific hints shown when versions are identical.
	Hints(stderr io.Writer)
}

type DiffRunner struct {
	Presenter DiffPresenter
	Options   DiffOptions
	Stdout    io.Writer
	Stderr    io.Writer
}

type ListConfig struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// Flags is the provider's flag set (param adds --recursive; secret does not).
	Flags []cli.Flag
	// NewList builds the entry-producing closure from the CLI context. withValue
	// mirrors the shared --show flag so the provider can request values.
	NewList func(ctx context.Context, cmd *cli.Command, withValue bool) (func(context.Context) ([]ListEntry, error), error)
}

type ListEntry struct {
	Name  string
	Value *string
	Error error
}

type ListJSONOutputItem struct {
	Name  string  `json:"name"`
	Value *string `json:"value,omitempty"` // nil when error or not requested, pointer to distinguish from empty string
	Error string  `json:"error,omitempty"`
}

type ListOptions struct {
	Show   bool
	Output output.Format
}

type ListRunner struct {
	List    func(ctx context.Context) ([]ListEntry, error)
	Options ListOptions
	Stdout  io.Writer
	Stderr  io.Writer
}

type LogConfig struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// UsageError is returned when the resource name argument is missing.
	UsageError string
	// Flags is the provider's flag set (param adds --max-value-length; the
	// --number/--since/--until usage strings differ between providers).
	Flags []cli.Flag
	// NewPresenter builds the provider LogPresenter bound to the fetch request.
	NewPresenter func(ctx context.Context, req LogRequest) (LogPresenter, error)
}

type LogOptions struct {
	//declscope:ignore overexported // log_test.go runs the log with the AWS presenters, which import this package
	ShowPatch bool
	//declscope:ignore overexported // log_test.go runs the log with the AWS presenters, which import this package
	ParseJSON bool
	//declscope:ignore overexported // log_test.go runs the log with the AWS presenters, which import this package
	Reverse bool

	Oneline bool
	Output  output.Format
	//declscope:ignore overexported // log_test.go runs the log with the AWS presenters, which import this package
	MaxValueLength int
	// contains filtered or unexported fields
}

type LogPresenter interface {
	// Fetch loads the version history via the provider usecase.
	Fetch(ctx context.Context) error
	// Len returns the number of versions loaded.
	Len() int
	// RenderJSON writes the provider-specific JSON array for all versions.
	RenderJSON(stdout io.Writer) error
	// RenderOneline writes the compact one-line form for version i.
	RenderOneline(stdout io.Writer, i, maxValueLength int)
	// RenderHeader writes the "Version ..." line and Date line for version i.
	RenderHeader(stdout io.Writer, i int)
	// RenderValue writes the value preview for version i (default, non-patch mode).
	// Providers without a default value preview (e.g. secrets) make this a no-op.
	RenderValue(stdout io.Writer, i, maxValueLength int)
	// RenderPatch writes the diff between version i and its neighbor (patch mode).
	RenderPatch(stdout, stderr io.Writer, i int, parseJSON, reverse bool)
}

type LogRequest struct {
	Name       string
	MaxResults int32
	Since      *time.Time
	Until      *time.Time
	Reverse    bool
}

type LogRunner struct {
	Presenter LogPresenter
	Options   LogOptions
	Stdout    io.Writer
	Stderr    io.Writer
}

type ShowConfig[S any] struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// UsageError is returned when the resource name argument is missing.
	UsageError string
	// ParseSpec parses the raw name argument into the provider's version spec.
	ParseSpec func(arg string) (S, error)
	// NewPresenter builds the provider ShowPresenter bound to the parsed spec (this
	// is where the provider constructs its client and use case).
	NewPresenter func(ctx context.Context, spec S) (ShowPresenter, error)
}

type ShowOptions struct {
	ParseJSON bool

	Raw    bool
	Output output.Format
	// contains filtered or unexported fields
}

type ShowPresenter interface {
	// Fetch resolves the version spec and loads the entry via the provider usecase.
	Fetch(ctx context.Context) error
	// Value returns the display value. When parseJSON is set it applies the
	// provider's parse-json rules (which may warn to stderr) and records internal
	// state used by the render methods.
	Value(parseJSON bool, stderr io.Writer) string
	// RenderText writes the metadata block followed by the value.
	RenderText(stdout io.Writer, value string)
	// RenderJSON writes the provider-specific JSON output.
	RenderJSON(stdout io.Writer, value string) error
}

type ShowRunner struct {
	Presenter ShowPresenter
	Options   ShowOptions
	Stdout    io.Writer
	Stderr    io.Writer
}

type TagConfig struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// Noun is the resource word used in success messages ("parameter"/"secret").
	Noun string
	// UsageError is the error returned when required arguments are missing.
	UsageError string
	// NewTagger builds the provider's Tagger from the CLI context.
	NewTagger func(ctx context.Context) (provider.Tagger, error)
}