type Config struct {
    // Supported indicates the languages for which data should be generated.
    // The default is to support all locales for which there are matching
    // translation files.
    Supported []language.Tag

    SourceLanguage language.Tag

    Packages []string

    // Dir is the root dir for all operations.
    Dir string

    // TranslationsPattern is a regular expression to match incoming translation
    // files. These files may appear in any directory rooted at Dir.
    // language for the translation files is determined as follows:
    //   1. From the Language field in the file.
    //   2. If not present, from a valid language tag in the filename, separated
    //      by dots (e.g. "en-US.json" or "incoming.pt_PT.xmb").
    //   3. If not present, from a the closest subdirectory in which the file
    //      is contained that parses as a valid language tag.
    TranslationsPattern string

    // OutPattern defines the location for translation files for a certain
    // language. The default is "{{.Dir}}/{{.Language}}/out.{{.Ext}}"
    OutPattern string

    // Format defines the file format for generated translation files.
    // The default is XMB. Alternatives are GetText, XLIFF, L20n, GoText.
    Format string

    Ext string

    // GenFile may be in a different package. It is not defined, it will
    // be written to stdout.
    GenFile string

    // GenPackage is the package or relative path into which to generate the
    // file. If not specified it is relative to the current directory.
    GenPackage string

    // DeclareVar defines a variable to which to assing the generated Catalog.
    DeclareVar string

    // SetDefault determines whether to assign the generated Catalog to
    // message.DefaultCatalog. The default for this is true if DeclareVar is
    // not defined, false otherwise.
    SetDefault bool
}

type Feature struct {
    Type string `json:"type"` // Right now this is only gender and plural.

}

type IDList []string

type Message struct {
    // ID contains a list of identifiers for the message.
    ID  IDList `json:"id"`
    // Key is the string that is used to look up the message at runtime.
    Key         string `json:"key,omitempty"`
    Meaning     string `json:"meaning,omitempty"`
    Message     Text   `json:"message"`
    Translation Text   `json:"translation"`

    Comment           string `json:"comment,omitempty"`
    TranslatorComment string `json:"translatorComment,omitempty"`

    Placeholders []Placeholder `json:"placeholders,omitempty"`

    // Fuzzy indicates that the provide translation needs review by a
    // translator, for instance because it was derived from automated
    // translation.
    Fuzzy bool `json:"fuzzy,omitempty"`

    // Extraction information.
    Position string `json:"position,omitempty"` // filePosition:line
}

type Messages struct {
    Language language.Tag    `json:"language"`
    Messages []Message       `json:"messages"`
    Macros   map[string]Text `json:"macros,omitempty"`
}

type Placeholder struct {
    // ID is the placeholder identifier without the curly braces.
    ID  string `json:"id"`

    // String is the string with which to replace the placeholder. This may be a
    // formatting string (for instance "%d" or "{{.Count}}") or a literal string
    // (<div>).
    String string `json:"string"`

    Type           string `json:"type"`
    UnderlyingType string `json:"underlyingType"`
    // ArgNum and Expr are set if the placeholder is a substitution of an
    // argument.
    ArgNum int    `json:"argNum,omitempty"`
    Expr   string `json:"expr,omitempty"`

    Comment string `json:"comment,omitempty"`
    Example string `json:"example,omitempty"`

    // Features contains the features that are available for the implementation
    // of this argument.
    Features []Feature `json:"features,omitempty"`
}

type Select struct {
    Feature string          `json:"feature"` // Name of Feature type (e.g plural)
    Arg     string          `json:"arg"`     // The placeholder ID
    Cases   map[string]Text `json:"cases"`
}

type State struct {
    Config Config

    Package string

    Extracted Messages `json:"messages"`

    // Messages includes all messages for which there need to be translations.
    // Duplicates may be eliminated. Generation will be done from these messages
    // (usually after merging).
    Messages []Messages

    // Translations are incoming translations for the application messages.
    Translations []Messages
    // contains filtered or unexported fields
}

type Text struct {
    // Msg and Select contains the message to be displayed. Msg may be used as
    // a fallback value if none of the select cases match.
    Msg    string  `json:"msg,omitempty"`
    Select *Select `json:"select,omitempty"`

    // Var defines a map of variables that may be substituted in the selected
    // message.
    Var map[string]Text `json:"var,omitempty"`

    // Example contains an example message formatted with default values.
    Example string `json:"example,omitempty"`
}