plugin

type Config struct {
	Schema                    any            `yaml:"schema" json:"schema"`
	Documents                 any            `yaml:"documents" json:"documents"`
	ExternalDocuments         any            `yaml:"externalDocuments" json:"externalDocuments"`
	Generates                 map[string]any `yaml:"generates" json:"generates"`
	Config                    ConfigMap      `yaml:"config" json:"config"`
	Require                   any            `yaml:"require" json:"require"`
	Overwrite                 *bool          `yaml:"overwrite" json:"overwrite"`
	Watch                     any            `yaml:"watch" json:"watch"`
	Silent                    bool           `yaml:"silent" json:"silent"`
	ErrorsOnly                bool           `yaml:"errorsOnly" json:"errorsOnly"`
	Verbose                   bool           `yaml:"verbose" json:"verbose"`
	Debug                     bool           `yaml:"debug" json:"debug"`
	IgnoreNoDocuments         bool           `yaml:"ignoreNoDocuments" json:"ignoreNoDocuments"`
	AllowPartialOutputs       bool           `yaml:"allowPartialOutputs" json:"allowPartialOutputs"`
	EmitLegacyCommonJSImports *bool          `yaml:"emitLegacyCommonJSImports" json:"emitLegacyCommonJSImports"`
	ImportExtension           string         `yaml:"importExtension" json:"importExtension"`
	SkipDocumentsValidation   any            `yaml:"skipDocumentsValidation" json:"skipDocumentsValidation"`
	Hooks                     ConfigMap      `yaml:"hooks" json:"hooks"`

	// cwd / filepath are set by the CLI after loading, not from the file.
	Cwd      string `yaml:"-" json:"-"`
	FilePath string `yaml:"-" json:"-"`
}

type ConfigMap = map[string]any

type ConfiguredOutput struct {
	Plugins            []ConfiguredPlugin
	Preset             string
	PresetConfig       ConfigMap
	Overwrite          *bool
	Documents          any
	ExternalDocuments  any
	Schema             any
	Config             ConfigMap
	Hooks              ConfigMap
	DocumentTransforms []any
	WatchPattern       any
}

type ConfiguredPlugin struct {
	Name   string
	Config ConfigMap
}

type DocumentFile struct {
	Location string
	Document *ast.QueryDocument
	RawSDL   string
	Hash     string
	Type     string // "standard" | "external"
}

type FileOutput struct {
	Filename string
	Content  string
	Hooks    ConfigMap
}

type GenerateOptions struct {
	Filename                  string
	Plugins                   []ConfiguredPlugin
	Schema                    *ast.Schema
	Documents                 []*DocumentFile
	Config                    ConfigMap
	PluginMap                 map[string]Plugin
	PresetConfig              ConfigMap
	SkipDocumentsValidation   any
	PluginContext             ConfigMap
	EmitLegacyCommonJSImports *bool
	ImportExtension           string
}

type Output struct {
	Content string
	Prepend []string
	Append  []string
}

type OutputPreset interface {
	Name() string
	// BuildGeneratesSection mirrors the preset's buildGeneratesSection(options):
	// it receives the resolved GenerateOptions for the `generates` entry and
	// returns the expanded list of outputs to generate. options.Filename is the
	// baseOutputDir for the preset.
	BuildGeneratesSection(options *GenerateOptions) ([]GenerateOptions, error)
}

type Plugin interface {
	// Name is the registry key, e.g. "typescript", "add", "schema-ast".
	Name() string
	// Generate returns the emitted code for this plugin. Content is the main
	// body; Prepend/Append are hoisted before/after all plugins' content
	// (mirrors graphql-codegen's complex plugin output).
	Generate(schema *ast.Schema, docs []*DocumentFile, cfg ConfigMap, info *PluginInfo) (*Output, error)
}

type PluginInfo struct {
	OutputFile    string
	AllPlugins    []ConfiguredPlugin
	PluginContext ConfigMap
}

type Validator interface {
	// allPlugins is the full configured plugin list for the output (mirrors the
	// JS validate signature, which some plugins use to assert "only plugin").
	Validate(schema *ast.Schema, docs []*DocumentFile, cfg ConfigMap, outputFile string, allPlugins []ConfiguredPlugin) error
}