gen

type File struct {
	// Name is the short name of the file.
	// If Name ends in ".go" this file will be treated as a Go file.
	Name string

	// GeneratedBy is the name of the program that generated this file.
	// Leave empty to omit the "Code generated by ..." header.
	GeneratedBy string

	// GoBuild contains build tags, serialized as //go:build ...
	// Ignored if this is not a Go file.
	GoBuild string

	// PackageDocs are doc comments that preceed the package declaration.
	// These will be wrapped and each line prefixed with // when serialized.
	// Ignored if this is not a Go file.
	PackageDocs string

	// Package this file belongs to.
	Package *Package

	// Scope is the naming scope of this file, used for package import names.
	Scope

	// Imports maps Go package imports from package path to local name, e.g. {"encoding/json": "json"}.
	Imports map[string]string

	// Header is the file header, written before content.
	Header string

	// Content is the file content.
	Content []byte

	// Trailer is the file trailer, written after content.
	Trailer string
}

type Ident struct {
	Package *Package
	Name    string
}

type Package struct {
	// Path is the Go package path, e.g. "encoding/json"
	Path string

	// Name is the short Go package name, e.g. "json"
	Name string

	// Files is the list of Go and non-Go files in this package.
	Files map[string]*File

	// Declared tracks declared package-scoped identifiers,
	// including constants, variables, and functions.
	Scope
}

type Scope interface {
	// DeclareName declares name within this scope, modifying it as necessary to avoid
	// colliding with any preexisting names. It returns the unique generated name.
	// Subsequent calls to GetName will return the unique name.
	// Subsequent calls to HasName with the returned name will return true.
	// Subsequent calls to DeclareName will return a different name.
	DeclareName(name string) string

	// GetName returns the first declared unique name for name, if declared.
	GetName(name string) string

	// HasName returns true if this scope or any of its parent scopes contains name.
	HasName(name string) bool
}