logly/mureo

Added — Optional per-locale labels for web-extension nav tabs (#129)

Web extensions can now ship an optional display_name_i18n: Mapping[str, str] class attribute alongside display_name so the configure-UI nav tab follows the active locale. Built-in nav tabs (Setup / Demo / BYOD / Danger Zone) are already translated via data-i18n keys in i18n.json; extension tabs now follow the same convention without extension authors having to touch the OSS i18n.json catalog.

class MyExtension:
    name = "acme-vault"
    display_name = "Acme Vault setup"            # fallback for any locale
    display_name_i18n = {
        "en": "Acme Vault",
        "ja": "Acme Vault 設定",
    }

Lookup priority on the renderer side: display_name_i18n[active_locale] → display_name_i18n["en"] → display_name. Operators who toggle the configure-UI locale see your tab name update without a page reload — the renderer listens for the existing mureo:locale_changed event.

• mureo.web.extensions — WebExtensionEntry gains a display_name_i18n: Mapping[str, str] field that defaults to {} so existing constructors continue to work unchanged. The WebExtension Protocol is unchanged — the new attribute is read defensively via getattr so every pre-feature extension keeps loading without modification. Discovery validates the value as Mapping[str, str] (str keys and values both required) and skips the extension with a WebExtensionWarning if the shape is wrong (explicit None, list of pairs, int keys, int values).
• HTTP — GET /api/extensions includes a new display_name_i18n field per entry (empty {} when the extension did not declare any). JSON-only addition; existing consumers ignore unknown keys.
• Front-end (mureo/_data/web/extensions.js) — initial render reads document.documentElement.lang and looks up display_name_i18n[locale] with the fallback chain above. A mureo:locale_changed listener (fired by app.js#setLocale) re-runs the lookup so every nav label updates the moment the operator toggles 日本語 / English.
• Plugin author docs — docs/plugin-authoring.md §13 gains a Localising the nav-tab label subsection with the example class attribute, the documented lookup priority, and the empty-string fallthrough note.

Security: labels are injected via textContent (never innerHTML), so a label containing <script> or similar is harmless DOM text. The configure-UI Content-Security-Policy (script-src 'self'; style-src 'self') is unchanged.

Backward compatibility: extensions that do not declare display_name_i18n get an empty dict in their WebExtensionEntry; the renderer's fallback chain resolves to display_name, so the nav tab looks byte-identical to v0.9.5.

Install

pip install --upgrade mureo