plugins

type AppInfo struct {
	Name      string
	Path      string
	Type      string
	AppConfig *config.AppConfig // App-level .forge.yaml configuration
}

type AstroAdapter struct{}

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

type CLIAppInfo struct {
	Name string
	Path string // Root path of the app (e.g., apps/mycli)
}

type ClientConfig struct {
	// Source configuration
	Source SourceConfig `yaml:"source"`

	// Default generation settings
	Defaults GenerationDefaults `yaml:"defaults"`

	// Streaming extension configuration
	Streaming StreamingExtConfig `yaml:"streaming,omitempty"`

	// Multiple client configurations
	Clients []ClientGenConfig `yaml:"clients,omitempty"`
}

type ClientGenConfig struct {
	Name     string `yaml:"name"`
	Language string `yaml:"language"`
	Output   string `yaml:"output"`
	Package  string `yaml:"package,omitempty"`
	BaseURL  string `yaml:"base_url,omitempty"`
	Module   string `yaml:"module,omitempty"`

	// Include and Exclude carve this client's surface out of the shared
	// specification, with the same matching rules as defaults.include -- a path
	// prefix, a glob, or a trailing "/**" -- and Exclude applied second.
	//
	// These are why a clients: block is worth having rather than N invocations
	// of the CLI. One gateway fronting several services publishes one merged
	// document, and each consumer wants the routes of one service: without a
	// per-client filter every generated client carries every service's surface
	// under a different package name.
	//
	// Unset means this client inherits defaults.include/defaults.exclude. A
	// client that sets either one replaces the corresponding default outright
	// rather than appending to it -- an inherited include is a floor a client
	// could not get below, and "this client sees only /studio" has to be
	// expressible next to a default that names something else.
	Include []string `yaml:"include,omitempty"`
	Exclude []string `yaml:"exclude,omitempty"`

	// Hooks overrides defaults.hooks for this client. A pointer because false
	// and unset differ here: the whole point is to let one client opt out of a
	// layer the defaults turned on.
	Hooks *bool `yaml:"hooks,omitempty"`

	// StripPrefix names the prefix this client's OWN service was merged under.
	//
	// Per client rather than shared, because a defaults.strip_prefix of
	// "Studio_" applied to the portal client would strip nothing from it and
	// leave the stutter in place.
	//
	// Declaring it does two jobs. It strips this client's own typenames, and it
	// tells every SIBLING client that this prefix is a service prefix, so the
	// foreign copies of these types that turn up in their documents strip too.
	// See clientStripPrefixes in client_multi.go.
	StripPrefix string `yaml:"strip_prefix,omitempty"`

	// StripPrefixes overrides the prefix set for this client outright, for the
	// case where the derived set is wrong: two services whose types genuinely
	// collide once stripped, where the fix is to strip fewer of them here.
	//
	// See clientStripPrefixes for how this composes with the derived set.
	StripPrefixes []string `yaml:"strip_prefixes,omitempty"`

	// Override feature flags
	Auth      *bool `yaml:"auth,omitempty"`
	Streaming *bool `yaml:"streaming,omitempty"`
}

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

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

type CommandFlag struct {
	Name        string
	ShortName   string
	Type        string // "string", "bool", "int", "float", "stringSlice"
	Description string
}

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

type CustomAdapter struct{}

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

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

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

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

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

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

type FrameworkAdapter interface {
	// Name returns the framework identifier ("astro", "nextjs", "custom").
	Name() string

	// DefaultBuildCmd returns the default build command for the given mode.
	DefaultBuildCmd(mode string) string

	// DefaultDevCmd returns the default dev server command.
	DefaultDevCmd() string

	// DefaultDistDir returns the default build output directory for the given mode.
	DefaultDistDir(mode string) string

	// DefaultSSREntry returns the default SSR entry point.
	DefaultSSREntry() string

	// ValidateBuild checks that the build output exists and is valid.
	ValidateBuild(distDir string) error
}

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

type GenerationDefaults struct {
	Language string `yaml:"language"`
	Output   string `yaml:"output"`
	Package  string `yaml:"package"`
	BaseURL  string `yaml:"base_url,omitempty"`
	Module   string `yaml:"module,omitempty"`

	// Hooks emits the operation manifest (ops.ts) and typed hook facades
	// (hooks.ts) delegating to @forge-go/client-core over the generated client.
	Hooks bool `yaml:"hooks"`

	// ReactQuery is the former name of Hooks, still read so an existing
	// .forge-client.yml keeps working; either key enables the layer, and using
	// this one prints a deprecation notice. See resolveHooks in client.go.
	//
	// Deprecated: use hooks. The generated code has not been TanStack Query
	// since the hook facades replaced it.
	ReactQuery bool `yaml:"react_query"`

	// Include keeps only endpoints whose path matches a pattern; Exclude drops
	// matches and is applied second. Both accept a path prefix, a glob, or a
	// trailing "/**". A specification usually describes more than any one
	// consumer talks to, and these are how a client binds only its own surface.
	Include []string `yaml:"include,omitempty"`
	Exclude []string `yaml:"exclude,omitempty"`

	// Feature flags
	Auth      bool `yaml:"auth"`
	Streaming bool `yaml:"streaming"`

	// Streaming features
	Reconnection    bool `yaml:"reconnection"`
	Heartbeat       bool `yaml:"heartbeat"`
	StateManagement bool `yaml:"state_management"`

	// Enhanced features
	UseFetch        bool `yaml:"use_fetch"`
	DualPackage     bool `yaml:"dual_package"`
	GenerateTests   bool `yaml:"generate_tests"`
	GenerateLinting bool `yaml:"generate_linting"`
	GenerateCI      bool `yaml:"generate_ci"`
	ErrorTaxonomy   bool `yaml:"error_taxonomy"`
	Interceptors    bool `yaml:"interceptors"`
	Pagination      bool `yaml:"pagination"`

	// Output control
	ClientOnly bool `yaml:"client_only"` // Generate only client source files

	// FieldNaming selects the client-side identifier style for schema
	// properties: "camel", "pascal", "snake", or "preserve". Empty means
	// unset -- the generator's own per-language default applies (camel for
	// typescript, preserve otherwise; see client.GeneratorConfig.FieldNaming's
	// doc comment). Mirrors --field-naming; the CLI flag, when passed, wins
	// over this.
	FieldNaming string `yaml:"field_naming,omitempty"`

	// StripPrefix removes a leading service prefix from schema names, operation
	// ids, entity typenames and cache tags. Mirrors --strip-prefix; the flag,
	// when passed, wins. A clients: entry's own strip_prefix wins over both,
	// which is the usual case -- each client strips its own service's prefix.
	StripPrefix string `yaml:"strip_prefix,omitempty"`

	// StripPrefixes are additional prefixes stripped from every client, on top
	// of whichever prefix that client owns.
	//
	// Rarely needed with a clients: block, which already tells the generator
	// every prefix in play -- see clientStripPrefixes. This is for the prefix
	// no client declares: a service the gateway fronts and describes but that
	// nobody generates a client for, whose types still turn up inside the
	// documents of the services that talk to it.
	StripPrefixes []string `yaml:"strip_prefixes,omitempty"`

	// FieldOverrides maps a wire name (or "SchemaName.wire_name" for a
	// schema-scoped override) to an explicit client-side name, exactly like
	// client.GeneratorConfig.FieldOverrides. Mirrors --field-overrides; the
	// CLI flag, when passed, wins over this.
	FieldOverrides map[string]string `yaml:"field_overrides,omitempty"`
}

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

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

type NextjsAdapter struct{}

type SourceConfig struct {
	// Type: "file", "url", "auto"
	Type string `yaml:"type"`

	// Path to spec file (when type=file). Read as a one-element Sources list
	// when Sources is empty, so an existing .forge-client.yml keeps working.
	Path string `yaml:"path,omitempty"`

	// URL to fetch spec (when type=url). Same one-element handling as Path.
	URL string `yaml:"url,omitempty"`

	// Sources lists several documents to parse and merge. When set it wins
	// over the scalar Path and URL keys above.
	Sources []SourceEntry `yaml:"sources,omitempty"`

	// Auto-discovery paths (when type=auto)
	AutoDiscoverPaths []string `yaml:"auto_discover_paths,omitempty"`
}

type SourceEntry struct {
	// Type: "file" or "url".
	Type string `yaml:"type"`

	Path string `yaml:"path,omitempty"`
	URL  string `yaml:"url,omitempty"`
}

type StreamingExtConfig struct {
	// Enable room management client
	Rooms bool `yaml:"rooms"`

	// Enable presence tracking client
	Presence bool `yaml:"presence"`

	// Enable typing indicator client
	Typing bool `yaml:"typing"`

	// Enable pub/sub channel client
	Channels bool `yaml:"channels"`

	// Enable message history support
	History bool `yaml:"history"`
}

type TargetInfo struct {
	Name        string
	Type        string // "app" or "extension"
	IsExtension bool
	Path        string
}

type TemplAdapter struct{}