common

type APIReference struct {
	Collector *APIReferenceCollector
	Language  string
	Formatter APIReferenceFormatter
	Tmpl      *template.Template
}

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

type APIReferenceFormatter struct {
	KindName func(kind ast.Kind) string

	FunctionSignature func(context languages.Context, function FunctionReference) string

	ObjectName       func(object ast.Object) string
	ObjectDefinition func(context languages.Context, object ast.Object) string

	MethodName      func(method MethodReference) string
	MethodSignature func(context languages.Context, method MethodReference) string

	BuilderName          func(builder ast.Builder) string
	ConstructorSignature func(context languages.Context, builder ast.Builder) string
	OptionName           func(option ast.Option) string
	OptionSignature      func(context languages.Context, builder ast.Builder, option ast.Option) string
}

type ArgumentReference struct {
	Name     string
	Type     string
	Comments []string
}

type BuildOptions struct {
	Languages []string
}

type CustomTemplates struct {
	TmplFuncs           template.FuncMap
	TemplateDirectories []string
	Data                map[string]any
	ExtraData           map[string]string
}

type DirectImportMap struct {
	Imports *orderedmap.Map[string, string] // alias → importPath
	// contains filtered or unexported fields
}

type DynamicFiles struct {
	Tmpl          *template.Template
	Data          map[string]any
	FuncsProvider func(context languages.Context) template.FuncMap
}

type FunctionReference struct {
	Name      string
	Comments  []string
	Arguments []ArgumentReference
	Return    string
}

type ImportMapConfig[M any] struct {
	Formatter           func(importMap M) string
	AliasSanitizer      func(string) string
	ImportPathSanitizer func(string) string
	PackagesImportMap   map[string]string
}

type ImportMapOption[M any] func(importMap *ImportMapConfig[M])

type MethodReference struct {
	ReceiverObject  *ast.Object
	ReceiverBuilder *ast.Builder

	Name      string
	Comments  []string
	Arguments []ArgumentReference
	Return    string
	Static    bool
}

type PathPrefixerOption func(*pathPrefixerCfg)

type RepositoryTemplate struct {
	TemplateDir string
	ExtraData   map[string]string
}