Game Details Edit Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

Edit game info fields, and optionally review and apply values fetched from a third party catalogue.

Main Screen Design

Simple edit mode

Used when reached from Game Management screen.

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Game Title> > Details                                                      │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                                                                        │  │
│  │  Title                                                                 │  │
│  │  ┌─────────────────────────┐       ┌─────────────────────────┐         │  │
│  │  │ The Last Ninja_         │       │ Use [Get Details] to    │         │  │
│  │  └─────────────────────────┘       │ fetch catalogue values. │         │  │
│  │                                    └─────────────────────────┘         │  │
│  │  Publisher                                                             │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ System 3_               │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Year                                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ 1987_                   │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Colour Encoding                                                       │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ PAL                  \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  True Drive Emulation                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ No                   \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Notes                                                                 │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ _                       │                                           │  │
│  │  │                         │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  [Save]   [Cancel]                 [Get Details]                       │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

Simple edit mode — after fetch

After a fetch, the second column shows fetched values for fields where the fetched value differs from the current value. The breadcrumb does not change.

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Game Title> > Details                                                      │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                                                                        │  │
│  │  Title                                                                 │  │
│  │  ┌─────────────────────────┐       ┌─────────────────────────┐         │  │
│  │  │ The Last Ninja_         │  [<]  │ Last Ninja, The         │         │  │
│  │  └─────────────────────────┘       └─────────────────────────┘         │  │
│  │                                                                        │  │
│  │  Publisher                                                             │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ System 3_               │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Year                                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ 1987_                   │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Colour Encoding                                                       │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ PAL                  \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  True Drive Emulation                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ No                   \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Notes                                                                 │  │
│  │  ┌─────────────────────────┐       ┌─────────────────────────┐         │  │
│  │  │ _                       │  [<]  │ Classic arcade…         │         │  │
│  │  │                         │       │                         │         │  │
│  │  └─────────────────────────┘       └─────────────────────────┘         │  │
│  │                                                                        │  │
│  │  [Save]   [Cancel]                 [Get Details]   [Apply All]         │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  Details from <Source>                                                       │
└──────────────────────────────────────────────────────────────────────────────┘

Import mode

Used when reached from the import flow. The form shows only current values; the second column shows a prompt message.

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Import Games > <Title> > Details                            [Next]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                                                                        │  │
│  │  Title                                                                 │  │
│  │  ┌─────────────────────────┐       ┌─────────────────────────┐         │  │
│  │  │ The Last Ninja_         │       │ Use [Get Details] to    │         │  │
│  │  └─────────────────────────┘       │ fetch catalogue values. │         │  │
│  │                                    └─────────────────────────┘         │  │
│  │  Publisher                                                             │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ System 3_               │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Year                                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ 1987_                   │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Colour Encoding                                                       │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ PAL                  \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  True Drive Emulation                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ No                   \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Notes                                                                 │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ _                       │                                           │  │
│  │  │                         │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │                                    [Get Details]                       │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

Import mode — after fetch

After a fetch, the second column shows fetched values for fields where the fetched value differs from the current value. The breadcrumb does not change.

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Import Games > <Title> > Details                            [Next]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                                                                        │  │
│  │  Title                                                                 │  │
│  │  ┌─────────────────────────┐       ┌─────────────────────────┐         │  │
│  │  │ The Last Ninja_         │  [<]  │ Last Ninja, The         │         │  │
│  │  └─────────────────────────┘       └─────────────────────────┘         │  │
│  │                                                                        │  │
│  │  Publisher                                                             │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ System 3_               │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Year                                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ 1987_                   │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Colour Encoding                                                       │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ PAL                  \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  True Drive Emulation                                                  │  │
│  │  ┌─────────────────────────┐                                           │  │
│  │  │ No                   \/ │                                           │  │
│  │  └─────────────────────────┘                                           │  │
│  │                                                                        │  │
│  │  Notes                                                                 │  │
│  │  ┌─────────────────────────┐       ┌─────────────────────────┐         │  │
│  │  │ _                       │  [<]  │ Classic arcade…         │         │  │
│  │  │                         │       │                         │         │  │
│  │  └─────────────────────────┘       └─────────────────────────┘         │  │
│  │                                                                        │  │
│  │                                    [Get Details]   [Apply All]         │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  Details from <Source>                                                       │
└──────────────────────────────────────────────────────────────────────────────┘

TOP BAR

Focusable: [Back] CTA (simple edit mode); [Next] and [Back] CTAs (import mode)
Interactive: [Back] CTA (simple edit mode); [Next] and [Back] CTAs (import mode)
Purpose: Identify the screen and the current mode

In simple edit mode the title is <Game Title> > Details.
In import mode the title is Import Games > <Title> > Details.
The breadcrumb does not change when a fetch is performed.
See Import Candidate screen for the <Title> derivation rule.

[Next] CTA

Import mode only. Saves the current field values to the game record, records acceptance or rejection of each imported value for confidence tracking, and navigates to the Cover Art screen in import mode.

[Back] CTA

In simple edit mode, returns to the Game Management screen.

In import mode, returns to the Import Candidate screen.

FORM

Type: Form
Focusable: Yes (primary focus region)
Interactive: Yes
Purpose: Edit game details fields, and in import mode review and apply fetched values field by field

Field	Type	Required	Notes
Title	Text input	Yes	Must not be empty.
Publisher	Text input	No
Year	Text input	No
Colour Encoding	Dropdown	Yes	PAL, NTSC, or Unknown. Defaults to Unknown.
True Drive Emulation	Dropdown	Yes	Yes or No. Defaults to No.
Notes	Multi-line input	No

The second column is always shown. Before a fetch it displays a prompt message in place of field values. After a fetch, fields where the fetched value differs from the current value show a read-only fetched input in the second column and a [<] button between them. Fields that already match show only the current input with the second column area empty. Colour Encoding and True Drive Emulation are not supplied by third party catalogues and are never shown in the two-column layout.

Colour Encoding values

Option	Stored value
PAL	`pal`
NTSC	`ntsc`
Unknown	`unknown`

True Drive Emulation values

Option	Stored value
Yes	`true`
No	`false`

[<] button

Appears between the current and imported inputs for each field where the values differ. Pressing it copies the imported value into the current input. Focus moves to the current input after copying, allowing immediate editing.

Long imported values (e.g. Notes) are truncated in the imported input with a trailing …. The full value is copied when [<] is pressed.

[Apply All] button

Appears to the right of [Get Details] after a successful fetch, but only when at least one fetched value differs from the current value. Copies all differing fetched values into their respective current inputs simultaneously, as if each [<] had been pressed in sequence. Focus moves to the first affected field.

After [Apply All] is pressed, all fetched values match the current inputs: the second column inputs, [<] buttons, and [Apply All] itself all disappear.

[Get Details] button

Available in both simple edit mode and import mode. Located in the form footer, right-aligned to the second column. Navigates to the Get from Catalogue screen in the Details flow.

On return from a successful fetch, the second column is populated with the fetched values. [Get Details] remains available after a fetch, allowing the user to fetch again from the same or a different catalogue.

[Save] / [Cancel]

Simple edit mode only.

[Save] saves the current field values to the game record and returns to the Game Management screen.
[Cancel] discards changes and returns to the Game Management screen.

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display fetch source attribution and validation errors

State	Message
After a fetch	`Details from <Source>`
After save error	`<Error message>`
Idle	(empty)

After a fetch:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  Details from <Source>                                                       │
└──────────────────────────────────────────────────────────────────────────────┘

After a validation error:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Error message>                                                             │
└──────────────────────────────────────────────────────────────────────────────┘

Confidence Tracking

Import mode only. When [Next] is pressed, LoadC64 records the outcome for each field against the third party catalogue:

Field value matches fetched value → acceptance recorded
Field value differs from fetched value (user typed their own) → rejection recorded

See Game Import for details.

Validation Rules

Name	Type	Required	Notes
Title	String	Yes	Must not be empty.