figspec

type Arg struct {
	Name        string
	Description string
	IsOptional  bool
	Suggestions []string
	Generator   string
	Template    string
}

type CommandContext struct {
	Command     *cobra.Command
	CommandPath string
	Parent      *CommandContext
}

type CustomArgsProvider interface {
	// GetCommandArgs returns custom argument specifications for a command if applicable
	// Returns nil if no custom args are needed (default parsing will be used)
	GetCommandArgs(ctx *CommandContext) []Arg
}

type CustomFlagArgsProvider interface {
	// GetFlagArgs returns custom argument specification for a flag if applicable
	// Returns nil if no custom args are needed (default parsing will be used)
	GetFlagArgs(ctx *FlagContext) *Arg
}

type CustomGeneratorProvider interface {
	// GetCommandArgGenerator returns a generator name for a specific command argument if applicable
	// argName is the name of the argument extracted from the command's Use field
	// Returns empty string if no custom generator is needed
	GetCommandArgGenerator(ctx *CommandContext, argName string) string

	// GetFlagGenerator returns a generator name for a flag's argument if applicable
	// Returns empty string if no custom generator is needed
	GetFlagGenerator(ctx *FlagContext) string
}

type CustomSuggestionProvider interface {
	// GetSuggestions returns custom suggestions for a flag if applicable
	// Returns nil if no custom suggestions are needed
	GetSuggestions(ctx *FlagContext) []string
}

type Customizations struct{}

type ExtensionMetadataProvider interface {
	// HasMetadataCapability checks if the extension has the metadata capability
	HasMetadataCapability(extensionId string) bool
	// LoadMetadata loads the cached metadata for an extension by its ID
	LoadMetadata(extensionId string) (*extensions.ExtensionCommandMetadata, error)
}

type FlagContext struct {
	Flag        *pflag.Flag
	CommandPath string
}

type Option struct {
	Name         []string
	Description  string
	Args         []Arg
	IsPersistent bool
	IsRepeatable bool
	IsRequired   bool
	IsDangerous  bool
	Hidden       bool
}

type Spec struct {
	Name        string
	Description string
	Subcommands []Subcommand
	Options     []Option
	Args        []Arg
}

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

type Subcommand struct {
	Name        []string
	Description string
	Subcommands []Subcommand
	Options     []Option
	Args        []Arg
	Hidden      bool
}