format

type BudgetInfo struct {
	MaxTokens       int `xml:"maxTokens"`       // Maximum token budget (0 = unlimited)
	EstimatedTokens int `xml:"estimatedTokens"` // Actual estimated tokens in output
	FileTruncations int `xml:"fileTruncations"` // Number of files that were truncated
}

type DependencyInfo struct {
	Imports   map[string][]string `xml:"imports>file"`
	Packages  []string            `xml:"packages>package"`
	CoreFiles []string            `xml:"coreFiles>file"`
}

type DirectoryNode struct {
	Name     string           `xml:"name,attr"`
	Type     string           `xml:"type,attr"` // "file" or "dir"
	Children []*DirectoryNode `xml:"node,omitempty"`
}

type FileInfo struct {
	Path       string          `xml:"path,attr"`
	Content    string          `xml:"content"`
	Tokens     int             `xml:"tokens,omitempty"`     // PTX v2.0: Token count for this file
	Truncation *TruncationInfo `xml:"truncation,omitempty"` // PTX v2.0: Truncation metadata if file was truncated
}

type FileStatistics struct {
	TotalFiles   int            `xml:"totalFiles"`
	FilesByType  map[string]int `xml:"-"` // Exclude from direct XML marshaling
	TotalLines   int            `xml:"totalLines"`
	PackageCount int            `xml:"packageCount"`
}

type FilterConfig struct {
	Includes []string `xml:"includes>include,omitempty"` // File patterns explicitly included
	Excludes []string `xml:"excludes>exclude,omitempty"` // File patterns explicitly excluded
}

type Formatter interface {
	Format(project *ProjectOutput) (string, error)
}

type GitInfo struct {
	Branch        string `xml:"branch"`
	CommitHash    string `xml:"commitHash"`
	CommitMessage string `xml:"commitMessage"`
}

type JSONLFormatter struct{} // JSONL - Machine-friendly sidecar format (one JSON object per line)

type MarkdownFormatter struct{}

type Metadata struct {
	Language     string   `xml:"language"`
	Version      string   `xml:"version"`
	Dependencies []string `xml:"dependencies>dependency,omitempty"`
}

type OutputFormat string

type PTXFormatter struct{} // PTX v2.0 - TOON-based with multiline code and enhanced manifest

type ProjectAnalysis struct {
	EntryPoints   map[string]string `xml:"entryPoints,omitempty"`
	ConfigFiles   map[string]string `xml:"configFiles,omitempty"`
	CoreFiles     map[string]string `xml:"coreFiles,omitempty"`
	TestFiles     map[string]string `xml:"testFiles,omitempty"`
	Documentation map[string]string `xml:"documentation,omitempty"`
}

type ProjectOutput struct {
	XMLName       xml.Name         `xml:"project"`
	DirectoryTree *DirectoryNode   `xml:"directoryTree"`
	GitInfo       *GitInfo         `xml:"gitInfo,omitempty"`
	Metadata      *Metadata        `xml:"metadata,omitempty"`
	Files         []FileInfo       `xml:"files>file,omitempty"`
	Overview      *ProjectOverview `xml:"overview,omitempty"`
	FileStats     *FileStatistics  `xml:"fileStats,omitempty"`
	Dependencies  *DependencyInfo  `xml:"dependencies,omitempty"`
	Analysis      *ProjectAnalysis `xml:"analysis,omitempty"`
	Budget        *BudgetInfo      `xml:"budget,omitempty"`       // PTX v2.0: Token budget tracking
	FilterConfig  *FilterConfig    `xml:"filterConfig,omitempty"` // PTX v2.0: Filter configuration used
}

type ProjectOverview struct {
	Description string   `xml:"description"`
	Purpose     string   `xml:"purpose"`
	Features    []string `xml:"features>feature,omitempty"`
}

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

type TOONStrictFormatter struct{} // TOON v1.3 strict compliance

type TruncationInfo struct {
	Mode           string `xml:"mode"`           // Truncation mode (e.g., "head:300,tail:53")
	OriginalTokens int    `xml:"originalTokens"` // Token count before truncation
}

type XMLFormatter struct{}