filesystem

type File interface {
	fs.File
	io.Writer
}

type FileSystem interface {
	config.FS
	OpenFile(name string, flag int, perm fs.FileMode) (File, error)
	MkdirAll(path string, perm os.FileMode) error
	ReadDir(name string) ([]fs.DirEntry, error)
	Remove(name string) error

	// ScanForGeneratedIDs scans the output directory for files with @generated-id headers.
	// Returns a map of UUID -> relative file path.
	// This is used to detect when users have moved generated files.
	ScanForGeneratedIDs() (map[string]string, error)
}