gui: full format names, and the window after a review of every screen

CHANGELOG.md

@@ -16,18 +16,36 @@ because it turns other people's test suites red.
 
 ### Changed
 
+- **The window's look, after a review of every screen.** An open list and the
+  explanation beside a field stand on a card with an edge and a shade instead
+  of a flat grey block, and a list opened under its box shrinks to what the
+  filter left. Every list shows its tick at the end of the row. Controls
+  switched off for a run are never drawn brighter than at rest, and a ticked
+  switch keeps its tick while it is off - it showed an empty square for the
+  length of every run. `Donate` carries a red heart, and it and `Add a batch`
+  stand on the form's left edge. In a narrow window the run buttons move right
+  instead of making the window wider, so it can be narrowed further. Two
+  refusals in one row stand one under the other from the row's edge rather
+  than as a staircase. `Remove` is written in red, the rails beside groups of
+  settings are one grey, `Choose...` is as tall as the box beside it, and the
+  About screen's sentence sits under its title like the other screens'.
+
 - **The list of formats is grouped by kind and can be filtered.** The open
   list stands under headings - Archives, Documents, Pictures, Sound, Text and
   data - each saying how many formats are under it, and a box at its top
-  narrows it to the formats whose name holds what is typed, or whose kind
-  has a word that starts with it (`gz` finds `targz`, `pict` every picture,
-  `data` every text and data format). The letters that
-  matched are drawn in bold, the arrows step over the headings, and typing
-  at the shut `Format` menu opens the list with those letters in the box, so
-  `jxl` typed there ends on `jxl`. The shut menu draws the kind of the format
-  it holds, and archives are drawn as a folder rather than as three bars that
-  looked like text. The command line lists the formats in one alphabetical
-  order as before.
+  narrows it to the formats whose identifier holds what is typed, or whose
+  kind or full name has a word that starts with it (`gz` finds `targz`,
+  `pict` every picture, `data` every text and data format, `excel` finds
+  `xlsx`). Every format stands beside its full name, `jxl` beside JPEG XL, so
+  the open list is wider than the `Format` box, which keeps its width. The
+  letters that matched are drawn in bold, in the identifier and in the name,
+  the arrows step over the headings, and typing at the shut `Format` menu
+  opens the list with those letters in the box, so `jxl` typed there ends on
+  `jxl`. When nothing matches, the list says `No format matches - clear the
+  box to see all`. The shut menu draws the kind of the format it holds, and
+  archives are drawn as a folder rather than as three bars that looked like
+  text. The command line lists the formats in one alphabetical order as
+  before.
 
 - **The window lays its forms out in columns.** A field now takes as many
   columns of the form as its value needs and no more, so `Format`, `Size`,
@@ -282,6 +300,13 @@ because it turns other people's test suites red.
 
 ### Added
 
+- **Every format has its full name.** `tfg formats` has a `NAME` column
+  (`jxl` is JPEG XL, `png` Portable Network Graphics), `tfg formats jxl`
+  gives it on a `name` line, and `tfg formats --json` carries it under the new
+  key `name`. No key already there changes, and no generated file changes.
+  The formats table on the website has the same column. Names are proper
+  names and stay in English on every page.
+
 - **The window says where the manifest went, and opens it.** A finished run
   used to say `3 files written.` and nothing else, while the same run from the
   command line printed the path of the manifest beside the count. The line now

internal/cli/formats.go

@@ -16,7 +16,11 @@ import (
 // sense at all - how faithful the file will be, whether it repeats to the
 // byte, and how small it can go.
 type formatEntry struct {
-	ID          string `json:"id"`
+	ID string `json:"id"`
+	// Name is what the format is called, beside the identifier a recipe
+	// uses. Added on 2026-09-24, which widens this output and changes the
+	// meaning of no key already in it.
+	Name        string `json:"name"`
 	Extension   string `json:"extension"`
 	Fidelity    string `json:"fidelity"`
 	Determinism string `json:"determinism"`
@@ -96,6 +100,7 @@ func entryFor(d format.Descriptor) formatEntry {
 	}
 	return formatEntry{
 		ID: d.ID, Extension: d.Extension,
+		Name:     d.Name,
 		Fidelity: string(d.Fidelity), Determinism: string(d.Determinism),
 		MinBytes: d.MinBytes, SmallestAccepted: smallestAccepted(d),
 		Padding: d.Padding.Name, PaddingCap: d.Padding.Capacity,
@@ -112,6 +117,7 @@ func entryFor(d format.Descriptor) formatEntry {
 func describeOne(d format.Descriptor, out io.Writer) {
 	fmt.Fprintf(out, "%s - %s fidelity, %s deterministic, minimum %s\n",
 		d.ID, d.Fidelity, d.Determinism, core.ExactBytes(smallestAccepted(d)))
+	fmt.Fprintf(out, "  name       %s\n", d.Name)
 	fmt.Fprintf(out, "  extension  %s\n", d.Extension)
 	fmt.Fprintf(out, "  padding    %s\n", d.Padding.Name)
 	fmt.Fprintf(out, "  label      %s\n", d.Label)
@@ -203,14 +209,27 @@ Flags:
 		}
 		return renderJSON(list, out, errOut)
 	}
+	printTable(out)
+	return ExitOK
+}
 
-	fmt.Fprintf(out, "%-8s %-10s %-12s %-10s %s\n", "FORMAT", "FIDELITY", "DETERMINISM", "MINIMUM", "PADDING CHANNEL")
+// printTable is the list a person reads: one row a format.
+//
+// The name column is as wide as the longest name rather than a number written
+// here, so the next longer name keeps every column after it in line. Counted
+// in bytes, which is characters: a name is ASCII, held by
+// TestEveryFormatDeclaresTheFullSet.
+func printTable(out io.Writer) {
+	named := len("NAME")
 	for _, d := range format.All() {
-		fmt.Fprintf(out, "%-8s %-10s %-12s %-10d %s\n",
-			d.ID, d.Fidelity, d.Determinism, smallestAccepted(d), d.Padding.Name)
+		named = max(named, len(d.Name))
+	}
+	fmt.Fprintf(out, "%-8s %-*s %-10s %-12s %-10s %s\n", "FORMAT", named, "NAME", "FIDELITY", "DETERMINISM", "MINIMUM", "PADDING CHANNEL")
+	for _, d := range format.All() {
+		fmt.Fprintf(out, "%-8s %-*s %-10s %-12s %-10d %s\n",
+			d.ID, named, d.Name, d.Fidelity, d.Determinism, smallestAccepted(d), d.Padding.Name)
 	}
 	fmt.Fprint(out, "\nRun \"tfg formats <id>\" for what one format accepts.\n")
-	return ExitOK
 }
 
 func renderJSON(v any, out, errOut io.Writer) int {

internal/format/avif/avif.go

@@ -106,6 +106,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "avif",
+		Name:        "AV1 Image File Format",
 		Extension:   ".avif",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/bmp/bmp.go

@@ -59,6 +59,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "bmp",
+		Name:        "Windows Bitmap",
 		Extension:   ".bmp",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/csvfile/csv.go

@@ -103,6 +103,7 @@ func fixedWidth(d dialect) int64 {
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "csv",
+		Name:        "Comma-Separated Values",
 		Extension:   ".csv",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/docx/docx.go

@@ -44,6 +44,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "docx",
+		Name:        "Word (Office Open XML)",
 		Extension:   ".docx",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/format.go

@@ -287,7 +287,21 @@ func (j JointLimit) per() int64 {
 // Descriptor is everything a format announces about itself. A format missing
 // any of it fails the registry test rather than shipping half implemented.
 type Descriptor struct {
-	ID               string
+	ID string
+
+	// Name is what the format is called where it is known by a name - JPEG XL
+	// for jxl, Portable Network Graphics for png - so that somebody who does
+	// not recognise the identifier can still find the format. A proper name,
+	// in English and never translated, which is why it can live here rather
+	// than in a language file. It is shown beside the identifier and never
+	// replaces it: the identifier is what a recipe and a manifest carry.
+	//
+	// Nothing written into a file, a manifest or a recipe reads it, so adding
+	// or rewording one changes no byte a run produces (D11). The one place it
+	// is a contract is the "name" key of "tfg formats --json", added on
+	// 2026-09-24 as a widening. Recorded in docs/FORMAT-NAMES-2026-09-24.md.
+	Name string
+
 	Extension        string
 	Fidelity         Fidelity
 	Determinism      Determinism

internal/format/gif/gif.go

@@ -101,6 +101,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "gif",
+		Name:        "Graphics Interchange Format",
 		Extension:   ".gif",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/htmlfile/html.go

@@ -117,6 +117,7 @@ func blocksFor(shape string) blocks {
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "html",
+		Name:        "HyperText Markup Language",
 		Extension:   ".html",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/ico/ico.go

@@ -58,6 +58,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "ico",
+		Name:        "Windows Icon",
 		Extension:   ".ico",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/jpg/jpg.go

@@ -70,6 +70,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "jpg",
+		Name:        "JPEG",
 		Extension:   ".jpg",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/jsonfile/json.go

@@ -61,6 +61,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "json",
+		Name:        "JavaScript Object Notation",
 		Extension:   ".json",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/jxl/jxl.go

@@ -139,6 +139,7 @@ var fileType = [20]byte{
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "jxl",
+		Name:        "JPEG XL",
 		Extension:   ".jxl",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/logfile/log.go

@@ -48,6 +48,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "log",
+		Name:        "Server and application log",
 		Extension:   ".log",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/md/md.go

@@ -44,6 +44,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "md",
+		Name:        "Markdown",
 		Extension:   ".md",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/pdf/pdf.go

@@ -53,6 +53,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "pdf",
+		Name:        "Portable Document Format",
 		Extension:   ".pdf",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/png/png.go

@@ -73,6 +73,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "png",
+		Name:        "Portable Network Graphics",
 		Extension:   ".png",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/pptx/pptx.go

@@ -54,6 +54,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "pptx",
+		Name:        "PowerPoint (Office Open XML)",
 		Extension:   ".pptx",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/svgfile/svg.go

@@ -188,6 +188,7 @@ func fit(extent, room int) int { return min(extent, room) }
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "svg",
+		Name:        "Scalable Vector Graphics",
 		Extension:   ".svg",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/targz/targz.go

@@ -93,6 +93,7 @@ var fixedTime = time.Date(2020, 1, 1, 0, 0, 0, 0, time.UTC)
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "targz",
+		Name:        "tar + gzip",
 		Extension:   ".tar.gz",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/tiff/tiff.go

@@ -104,6 +104,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "tiff",
+		Name:        "Tagged Image File Format",
 		Extension:   ".tiff",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/tomlfile/toml.go

@@ -73,6 +73,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "toml",
+		Name:        "TOML",
 		Extension:   ".toml",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/txt/txt.go

@@ -34,6 +34,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "txt",
+		Name:        "Plain text",
 		Extension:   ".txt",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/wav/wav.go

@@ -79,6 +79,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "wav",
+		Name:        "Waveform Audio",
 		Extension:   ".wav",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/webp/webp.go

@@ -79,6 +79,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "webp",
+		Name:        "WebP",
 		Extension:   ".webp",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/xlsx/xlsx.go

@@ -65,6 +65,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "xlsx",
+		Name:        "Excel (Office Open XML)",
 		Extension:   ".xlsx",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/xmlfile/xml.go

@@ -86,6 +86,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "xml",
+		Name:        "Extensible Markup Language",
 		Extension:   ".xml",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/yamlfile/yaml.go

@@ -102,6 +102,7 @@ const (
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "yaml",
+		Name:        "YAML",
 		Extension:   ".yaml",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,

internal/format/zip/zip.go

@@ -61,6 +61,7 @@ var fixedTime = time.Date(2020, 1, 1, 0, 0, 0, 0, time.UTC)
 func init() {
 	format.Register(format.Descriptor{
 		ID:          "zip",
+		Name:        "ZIP",
 		Extension:   ".zip",
 		Fidelity:    format.FidelityFull,
 		Determinism: format.DeterminismByte,