add-localization

name	add-localization
description	Adds a new language locale to RunCat365. Use when adding a new language, translating the UI, creating a .resx resource file, or updating SupportedLanguage.cs with a new language code.
argument-hint	<language name or BCP 47 code>

Add a New Localization to RunCat365

Modify 3 files to add support for $ARGUMENTS. French (fr) is used as an example.

Steps

1. Create RunCat365/Properties/Strings.{lc}.resx

Read RunCat365/Properties/Strings.resx for all keys and their English values. Use Strings.es.resx as the structural template.

• File name: Strings.{lc}.resx (e.g. Strings.fr.resx)
• Copy the XML header, schema, and <resheader> blocks verbatim from Strings.es.resx
• Include every key from Strings.resx — no more, no less — with each <value> translated
• Keep all attribute names, XML structure, and <comment> content in English; translate only <value> text
• Verify every key from Strings.resx is present in the new file

2. Edit RunCat365/SupportedLanguage.cs

Add the language to the SupportedLanguage enum:

enum SupportedLanguage
{
    English,
    Japanese,
    Spanish,
    French,
}

Add the ISO code to GetCurrentLanguage():

return culture.TwoLetterISOLanguageName switch
{
    "ja" => SupportedLanguage.Japanese,
    "es" => SupportedLanguage.Spanish,
    "fr" => SupportedLanguage.French,
    _ => SupportedLanguage.English,
};

Add the culture to GetDefaultCultureInfo():

return language switch
{
    SupportedLanguage.Japanese => new CultureInfo("ja-JP"),
    SupportedLanguage.Spanish => new CultureInfo("es-ES"),
    SupportedLanguage.French => new CultureInfo("fr-FR"),
    _ => new CultureInfo("en-US"),
};

Add the font to GetFontName() — use "Consolas" for Latin-script languages:

return language switch
{
    SupportedLanguage.Japanese => "Noto Sans JP",
    SupportedLanguage.Spanish => "Consolas",
    SupportedLanguage.French => "Consolas",
    _ => "Consolas",
};

Add the full-width flag to IsFullWidth() — use false for Latin-script languages:

return language switch
{
    SupportedLanguage.Japanese => true,
    SupportedLanguage.Spanish => false,
    SupportedLanguage.French => false,
    _ => false,
};

3. Update CLAUDE.md

Update the Localization notes to include the new language:

**Localization notes:**
- Add new strings to all four `.resx` files simultaneously
- Japanese uses "Noto Sans JP" font; English/Spanish/French use "Consolas"

Checklist

• Created Strings.{lc}.resx with all keys translated
• Added language to the SupportedLanguage enum
• Added ISO code to GetCurrentLanguage()
• Added culture to GetDefaultCultureInfo()
• Added font to GetFontName()
• Added full-width flag to IsFullWidth()
• Updated Localization notes in CLAUDE.md
• Built in Visual Studio and verified UI with OS language set to the target language