waybetter 0.1.0 → 0.6.0

package/dist/shell/frame/language.js

@@ -0,0 +1,165 @@
+// Which language the app speaks. The owner picks "Follow the site" (default: the language the site
+// itself is set to, as its tabs report their `<html lang>`), "Follow system" (the OS preference,
+// read natively) or a language. The shell resolves that to a catalog, switches every window live,
+// and hands native code (dialogs, notifications) and site tabs (the page runtime, plugins) exactly
+// the strings they need through the shell-only `i18n_set`. Other local windows (a popover) follow
+// through localStorage (same origin as the shell).
+//
+//   export const language = createLanguage({ i18n, nativePrefixes: ['x.', 'kit.', 'plugin.', 'native.'], native: { invoke, listen } });
+//   await language.initShell(isNative());
+//
+// The panel's language picker takes the same object (`PanelSite.languages`).
+import { direction, matchLocale, normalizeLocale } from "../../runtime/i18n.js";
+/** Where the shell keeps its choice for the app's other local windows (localStorage). */
+export const DEFAULT_STORAGE_KEY = `wb.language`;
+/**
+ * The catalog to use for a preference, the site's reported language and the OS preferences.
+ * Automatic choices ("site", "system") only resolve to `supported` languages (default: all of
+ * `available`), through the normal fallback chain (pt-BR -> pt, zh-TW -> zh-Hant); a language
+ * picked explicitly applies whatever its tier.
+ */
+export function resolveLocale(preference, siteLang, system, available, supported = available) {
+    if (preference === 'site') {
+        if (!siteLang)
+            return matchLocale(system, supported, 'en');
+        const site = matchLocale([siteLang], supported, '');
+        if (site)
+            return site;
+        // The site's language is a community translation: English (it is offered as a switch), not the system language.
+        return matchLocale([siteLang], available, '') ? 'en' : matchLocale(system, supported);
+    }
+    if (preference === 'system')
+        return matchLocale(system, supported);
+    return matchLocale([preference], available, matchLocale(system, supported));
+}
+/**
+ * The community language an automatic choice would have used had it been supported (the site's or
+ * the system's), or null: the panel offers it as a one-click switch.
+ */
+export function communitySuggestion(preference, siteLang, system, available, supported = available) {
+    if (preference !== 'site' && preference !== 'system')
+        return null;
+    const wanted = resolveLocale(preference, siteLang, system, available, available);
+    return supported.includes(wanted) ? null : wanted;
+}
+export function createLanguage(options) {
+    const { i18n, nativePrefixes, native } = options;
+    const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+    const available = i18n.available;
+    const supported = options.supported ? ['en', ...options.supported.filter(code => available.includes(code))] : available;
+    const current = {
+        preference: 'site',
+        siteLang: null,
+        system: [],
+        native: false,
+    };
+    const listeners = new Set();
+    function readStored() {
+        try {
+            const value = JSON.parse(localStorage.getItem(storageKey) ?? 'null');
+            return value && typeof value.locale === 'string' ? value : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    function writeStored(value) {
+        try {
+            localStorage.setItem(storageKey, JSON.stringify(value));
+        }
+        catch { /* the choice still applies this session */ }
+    }
+    function browserLanguages() {
+        const list = typeof navigator === 'undefined' ? [] : [...(navigator.languages ?? []), navigator.language];
+        return list.filter((tag) => typeof tag === 'string' && !!normalizeLocale(tag));
+    }
+    function paint(locale) {
+        const root = document.documentElement;
+        root.lang = locale;
+        root.dir = direction(locale);
+    }
+    let syncing = Promise.resolve();
+    async function apply() {
+        const locale = resolveLocale(current.preference, current.siteLang, current.system, available, supported);
+        await i18n.setLocale(locale);
+        paint(i18n.locale);
+        writeStored({ preference: current.preference, locale: i18n.locale, siteLang: current.siteLang });
+        if (current.native) {
+            // Serialized: a quick switch must not let an older set of strings land last.
+            const strings = { locale: i18n.locale, preference: current.preference, messages: i18n.resolved(nativePrefixes) };
+            syncing = syncing.then(() => native.invoke('i18n_set', { strings })).catch(error => console.error('[i18n] native strings were not updated', error));
+        }
+        for (const listener of [...listeners])
+            listener();
+    }
+    /**
+     * Shell start: the saved preference (native), the OS languages, the last language the site
+     * reported, then the catalog; resolves once the first paint can be in the right language.
+     */
+    async function initShell(isNative) {
+        current.native = isNative;
+        const stored = readStored();
+        current.siteLang = stored?.siteLang ?? null;
+        let fromNative = null;
+        if (isNative) {
+            try {
+                fromNative = await native.invoke('i18n_get');
+            }
+            catch (error) {
+                console.error('[i18n] i18n_get failed', error);
+            }
+        }
+        current.preference = fromNative?.preference || stored?.preference || 'site';
+        current.system = [...(fromNative?.system ?? []), ...browserLanguages()];
+        if (isNative) {
+            // Site tabs say which language the site is in; "Follow the site" switches with it.
+            void native.listen('tab-state', ({ payload }) => {
+                const lang = normalizeLocale(payload.lang);
+                if (!lang || lang === current.siteLang)
+                    return;
+                current.siteLang = lang;
+                if (current.preference === 'site')
+                    void apply();
+                else
+                    writeStored({ preference: current.preference, locale: i18n.locale, siteLang: lang });
+            });
+        }
+        await apply();
+    }
+    /** Another local window (a popover) and previews: the shell's last choice, kept current through storage events. */
+    async function initFollower(forced) {
+        const pick = async () => {
+            const locale = forced ? matchLocale([forced], available) : readStored()?.locale ?? matchLocale(browserLanguages(), supported);
+            await i18n.setLocale(locale);
+            paint(i18n.locale);
+        };
+        if (!forced) {
+            window.addEventListener('storage', event => { if (event.key === storageKey)
+                void pick(); });
+        }
+        await pick();
+    }
+    function state() {
+        return {
+            preference: current.preference, siteLang: current.siteLang, system: current.system, locale: i18n.locale,
+            community: communitySuggestion(current.preference, current.siteLang, current.system, available, supported),
+        };
+    }
+    async function set(preference) {
+        if (preference !== 'site' && preference !== 'system' && !available.includes(preference))
+            return;
+        current.preference = preference;
+        await apply();
+    }
+    function subscribe(listener) {
+        listeners.add(listener);
+        return () => { listeners.delete(listener); };
+    }
+    /** Development previews (`?lang=tr`): a fixed language without native code. */
+    async function forcePreview(tag) {
+        current.preference = matchLocale([tag], available);
+        await apply();
+    }
+    return { initShell, initFollower, state, set, subscribe, forcePreview, storageKey };
+}
+//# sourceMappingURL=language.js.map

package/dist/shell/frame/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../../../../../shell/src/frame/language.ts"],"names":[],"mappings":"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","sourcesContent":["// Which language the app speaks. The owner picks \"Follow the site\" (default: the language the site\n// itself is set to, as its tabs report their `<html lang>`), \"Follow system\" (the OS preference,\n// read natively) or a language. The shell resolves that to a catalog, switches every window live,\n// and hands native code (dialogs, notifications) and site tabs (the page runtime, plugins) exactly\n// the strings they need through the shell-only `i18n_set`. Other local windows (a popover) follow\n// through localStorage (same origin as the shell).\n//\n//   export const language = createLanguage({ i18n, nativePrefixes: ['x.', 'kit.', 'plugin.', 'native.'], native: { invoke, listen } });\n//   await language.initShell(isNative());\n//\n// The panel's language picker takes the same object (`PanelSite.languages`).\n\nimport { direction, matchLocale, normalizeLocale } from '../../../runtime/src/i18n.ts';\nimport type { Invoke, Listen } from './bridge.ts';\n\n/** `site`: follow the site's own language. `system`: follow the OS. Otherwise a catalog tag. */\nexport type LanguagePreference = 'site' | 'system' | string;\n\n/** The part of a waybetter/i18n instance the language state drives. */\nexport type LanguageI18n = {\n  readonly locale: string;\n  readonly available: readonly string[];\n  setLocale(locale: string): Promise<string>;\n  resolved(prefixes?: readonly string[]): Record<string, string>;\n};\n\nexport type LanguageOptions = {\n  i18n: LanguageI18n;\n  /** Key prefixes native code and site tabs need; the shell hands exactly these over (`i18n_set`). */\n  nativePrefixes: readonly string[];\n  /** The app's Tauri `invoke` and `listen` (the language is set up before the shell frame is). */\n  native: { invoke: Invoke; listen: Listen };\n  /** Where the choice is kept for the app's other local windows (default `wb.language`). */\n  storageKey?: string;\n  /**\n   * The supported tier: automatic choices (\"Follow the site\", \"Follow system\") resolve only to\n   * these (English is always one). Any other catalog is a community language: it applies only\n   * when picked explicitly. Default: every catalog is supported.\n   */\n  supported?: readonly string[];\n};\n\ntype NativeLanguage = { preference?: string; locale?: string; system?: string[] };\ntype Stored = { preference: LanguagePreference; locale: string; siteLang?: string | null };\n\n/** Where the shell keeps its choice for the app's other local windows (localStorage). */\nexport const DEFAULT_STORAGE_KEY = `wb.language`;\n\n/**\n * The catalog to use for a preference, the site's reported language and the OS preferences.\n * Automatic choices (\"site\", \"system\") only resolve to `supported` languages (default: all of\n * `available`), through the normal fallback chain (pt-BR -> pt, zh-TW -> zh-Hant); a language\n * picked explicitly applies whatever its tier.\n */\nexport function resolveLocale(preference: LanguagePreference, siteLang: string | null, system: readonly string[], available: readonly string[], supported: readonly string[] = available): string {\n  if (preference === 'site') {\n    if (!siteLang) return matchLocale(system, supported, 'en');\n    const site = matchLocale([siteLang], supported, '');\n    if (site) return site;\n    // The site's language is a community translation: English (it is offered as a switch), not the system language.\n    return matchLocale([siteLang], available, '') ? 'en' : matchLocale(system, supported);\n  }\n  if (preference === 'system') return matchLocale(system, supported);\n  return matchLocale([preference], available, matchLocale(system, supported));\n}\n\n/**\n * The community language an automatic choice would have used had it been supported (the site's or\n * the system's), or null: the panel offers it as a one-click switch.\n */\nexport function communitySuggestion(preference: LanguagePreference, siteLang: string | null, system: readonly string[], available: readonly string[], supported: readonly string[] = available): string | null {\n  if (preference !== 'site' && preference !== 'system') return null;\n  const wanted = resolveLocale(preference, siteLang, system, available, available);\n  return supported.includes(wanted) ? null : wanted;\n}\n\nexport type Language = ReturnType<typeof createLanguage>;\n\nexport function createLanguage(options: LanguageOptions) {\n  const { i18n, nativePrefixes, native } = options;\n  const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n  const available = i18n.available;\n  const supported = options.supported ? ['en', ...options.supported.filter(code => available.includes(code))] : available;\n  const current = {\n    preference: 'site' as LanguagePreference,\n    siteLang: null as string | null,\n    system: [] as string[],\n    native: false,\n  };\n  const listeners = new Set<() => void>();\n\n  function readStored(): Stored | null {\n    try {\n      const value = JSON.parse(localStorage.getItem(storageKey) ?? 'null') as Stored | null;\n      return value && typeof value.locale === 'string' ? value : null;\n    } catch {\n      return null;\n    }\n  }\n\n  function writeStored(value: Stored) {\n    try { localStorage.setItem(storageKey, JSON.stringify(value)); } catch { /* the choice still applies this session */ }\n  }\n\n  function browserLanguages(): string[] {\n    const list = typeof navigator === 'undefined' ? [] : [...(navigator.languages ?? []), navigator.language];\n    return list.filter((tag): tag is string => typeof tag === 'string' && !!normalizeLocale(tag));\n  }\n\n  function paint(locale: string) {\n    const root = document.documentElement;\n    root.lang = locale;\n    root.dir = direction(locale);\n  }\n\n  let syncing: Promise<unknown> = Promise.resolve();\n\n  async function apply() {\n    const locale = resolveLocale(current.preference, current.siteLang, current.system, available, supported);\n    await i18n.setLocale(locale);\n    paint(i18n.locale);\n    writeStored({ preference: current.preference, locale: i18n.locale, siteLang: current.siteLang });\n    if (current.native) {\n      // Serialized: a quick switch must not let an older set of strings land last.\n      const strings = { locale: i18n.locale, preference: current.preference, messages: i18n.resolved(nativePrefixes) };\n      syncing = syncing.then(() => native.invoke('i18n_set', { strings })).catch(error => console.error('[i18n] native strings were not updated', error));\n    }\n    for (const listener of [...listeners]) listener();\n  }\n\n  /**\n   * Shell start: the saved preference (native), the OS languages, the last language the site\n   * reported, then the catalog; resolves once the first paint can be in the right language.\n   */\n  async function initShell(isNative: boolean): Promise<void> {\n    current.native = isNative;\n    const stored = readStored();\n    current.siteLang = stored?.siteLang ?? null;\n    let fromNative: NativeLanguage | null = null;\n    if (isNative) {\n      try { fromNative = await native.invoke<NativeLanguage>('i18n_get'); } catch (error) { console.error('[i18n] i18n_get failed', error); }\n    }\n    current.preference = fromNative?.preference || stored?.preference || 'site';\n    current.system = [...(fromNative?.system ?? []), ...browserLanguages()];\n    if (isNative) {\n      // Site tabs say which language the site is in; \"Follow the site\" switches with it.\n      void native.listen<{ lang?: string }>('tab-state', ({ payload }) => {\n        const lang = normalizeLocale(payload.lang);\n        if (!lang || lang === current.siteLang) return;\n        current.siteLang = lang;\n        if (current.preference === 'site') void apply();\n        else writeStored({ preference: current.preference, locale: i18n.locale, siteLang: lang });\n      });\n    }\n    await apply();\n  }\n\n  /** Another local window (a popover) and previews: the shell's last choice, kept current through storage events. */\n  async function initFollower(forced?: string | null): Promise<void> {\n    const pick = async () => {\n      const locale = forced ? matchLocale([forced], available) : readStored()?.locale ?? matchLocale(browserLanguages(), supported);\n      await i18n.setLocale(locale);\n      paint(i18n.locale);\n    };\n    if (!forced) {\n      window.addEventListener('storage', event => { if (event.key === storageKey) void pick(); });\n    }\n    await pick();\n  }\n\n  function state() {\n    return {\n      preference: current.preference, siteLang: current.siteLang, system: current.system, locale: i18n.locale,\n      community: communitySuggestion(current.preference, current.siteLang, current.system, available, supported),\n    };\n  }\n\n  async function set(preference: LanguagePreference): Promise<void> {\n    if (preference !== 'site' && preference !== 'system' && !available.includes(preference)) return;\n    current.preference = preference;\n    await apply();\n  }\n\n  function subscribe(listener: () => void): () => void {\n    listeners.add(listener);\n    return () => { listeners.delete(listener); };\n  }\n\n  /** Development previews (`?lang=tr`): a fixed language without native code. */\n  async function forcePreview(tag: string): Promise<void> {\n    current.preference = matchLocale([tag], available);\n    await apply();\n  }\n\n  return { initShell, initFollower, state, set, subscribe, forcePreview, storageKey };\n}\n"]}

package/dist/shell/frame/mediaModel.d.ts

@@ -0,0 +1,34 @@
+export type GalleryImage = {
+    path: string;
+    name: string;
+    folder: string;
+    modifiedMs: number;
+    size: number;
+};
+export type ClipItem = {
+    id: string;
+    kind: 'text' | 'image';
+    text?: string;
+    file?: string;
+    hash: string;
+    at: number;
+};
+export type MediaSettings = {
+    folders: string[];
+    clipboardEnabled: boolean;
+    clipboardMax: number;
+};
+export type TabInfo = {
+    id: string;
+    url: string;
+};
+export declare const CLIP_MAX_LIMIT = 100;
+/** The tab an attachment goes to: the active tab if it can take one, else the most recent one that can. */
+export declare function attachTarget(tabs: TabInfo[], activeId: string | undefined, canAttach: (url: string) => boolean, recent?: string[]): TabInfo | null;
+/** Gallery folders shown as their last path segment (Windows or POSIX separators). */
+export declare function folderLabel(folder: string): string;
+export declare function clampClipMax(value: number): number;
+/** Removing a folder is the only folder change the shell can make; adding goes through the native dialog. */
+export declare function withoutFolder(settings: MediaSettings, folder: string): MediaSettings;
+export declare function clipPreview(item: ClipItem, max?: number): string;
+export declare function relativeTime(ms: number, now?: number): string;

package/dist/shell/frame/mediaModel.js

@@ -0,0 +1,53 @@
+// Pure model for the Media side panel (gallery folders + clipboard history). No Tauri/DOM
+// imports, so it is unit-tested under node. The panel never posts: it only asks native code to
+// attach an image to, or insert text into, one site tab's composer (`site.media.canAttach` says
+// which pages have one).
+import { formatNumber, t } from "./i18n.js";
+export const CLIP_MAX_LIMIT = 100;
+/** The tab an attachment goes to: the active tab if it can take one, else the most recent one that can. */
+export function attachTarget(tabs, activeId, canAttach, recent = []) {
+    const active = tabs.find(tab => tab.id === activeId);
+    if (active && canAttach(active.url))
+        return active;
+    for (const id of recent) {
+        const tab = tabs.find(candidate => candidate.id === id);
+        if (tab && canAttach(tab.url))
+            return tab;
+    }
+    return tabs.find(tab => canAttach(tab.url)) ?? null;
+}
+/** Gallery folders shown as their last path segment (Windows or POSIX separators). */
+export function folderLabel(folder) {
+    const parts = folder.split(/[\\/]+/).filter(Boolean);
+    return parts[parts.length - 1] ?? folder;
+}
+export function clampClipMax(value) {
+    if (!Number.isFinite(value))
+        return 30;
+    return Math.min(CLIP_MAX_LIMIT, Math.max(1, Math.round(value)));
+}
+/** Removing a folder is the only folder change the shell can make; adding goes through the native dialog. */
+export function withoutFolder(settings, folder) {
+    return { ...settings, folders: settings.folders.filter(f => f !== folder) };
+}
+export function clipPreview(item, max = 80) {
+    if (item.kind === 'image')
+        return t('wb.media.image');
+    const flat = (item.text ?? '').replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+export function relativeTime(ms, now = Date.now()) {
+    const seconds = Math.max(0, Math.round((now - ms) / 1000));
+    if (seconds < 60)
+        return t('wb.media.now');
+    // Compact units in the active language ("5m", "5 dk", "5分").
+    const unit = (value, name) => formatNumber(value, { style: 'unit', unit: name, unitDisplay: 'narrow' });
+    const minutes = Math.round(seconds / 60);
+    if (minutes < 60)
+        return unit(minutes, 'minute');
+    const hours = Math.round(minutes / 60);
+    if (hours < 24)
+        return unit(hours, 'hour');
+    return unit(Math.round(hours / 24), 'day');
+}
+//# sourceMappingURL=mediaModel.js.map

package/dist/shell/frame/mediaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaModel.js","sourceRoot":"","sources":["../../../../../../shell/src/frame/mediaModel.ts"],"names":[],"mappings":"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","sourcesContent":["// Pure model for the Media side panel (gallery folders + clipboard history). No Tauri/DOM\n// imports, so it is unit-tested under node. The panel never posts: it only asks native code to\n// attach an image to, or insert text into, one site tab's composer (`site.media.canAttach` says\n// which pages have one).\n\nimport { formatNumber, t } from './i18n.ts';\n\nexport type GalleryImage = { path: string; name: string; folder: string; modifiedMs: number; size: number };\nexport type ClipItem = { id: string; kind: 'text' | 'image'; text?: string; file?: string; hash: string; at: number };\nexport type MediaSettings = { folders: string[]; clipboardEnabled: boolean; clipboardMax: number };\nexport type TabInfo = { id: string; url: string };\n\nexport const CLIP_MAX_LIMIT = 100;\n\n/** The tab an attachment goes to: the active tab if it can take one, else the most recent one that can. */\nexport function attachTarget(tabs: TabInfo[], activeId: string | undefined, canAttach: (url: string) => boolean, recent: string[] = []): TabInfo | null {\n  const active = tabs.find(tab => tab.id === activeId);\n  if (active && canAttach(active.url)) return active;\n  for (const id of recent) {\n    const tab = tabs.find(candidate => candidate.id === id);\n    if (tab && canAttach(tab.url)) return tab;\n  }\n  return tabs.find(tab => canAttach(tab.url)) ?? null;\n}\n\n/** Gallery folders shown as their last path segment (Windows or POSIX separators). */\nexport function folderLabel(folder: string): string {\n  const parts = folder.split(/[\\\\/]+/).filter(Boolean);\n  return parts[parts.length - 1] ?? folder;\n}\n\nexport function clampClipMax(value: number): number {\n  if (!Number.isFinite(value)) return 30;\n  return Math.min(CLIP_MAX_LIMIT, Math.max(1, Math.round(value)));\n}\n\n/** Removing a folder is the only folder change the shell can make; adding goes through the native dialog. */\nexport function withoutFolder(settings: MediaSettings, folder: string): MediaSettings {\n  return { ...settings, folders: settings.folders.filter(f => f !== folder) };\n}\n\nexport function clipPreview(item: ClipItem, max = 80): string {\n  if (item.kind === 'image') return t('wb.media.image');\n  const flat = (item.text ?? '').replace(/\\s+/g, ' ').trim();\n  return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;\n}\n\nexport function relativeTime(ms: number, now = Date.now()): string {\n  const seconds = Math.max(0, Math.round((now - ms) / 1000));\n  if (seconds < 60) return t('wb.media.now');\n  // Compact units in the active language (\"5m\", \"5 dk\", \"5分\").\n  const unit = (value: number, name: 'minute' | 'hour' | 'day') => formatNumber(value, { style: 'unit', unit: name, unitDisplay: 'narrow' });\n  const minutes = Math.round(seconds / 60);\n  if (minutes < 60) return unit(minutes, 'minute');\n  const hours = Math.round(minutes / 60);\n  if (hours < 24) return unit(hours, 'hour');\n  return unit(Math.round(hours / 24), 'day');\n}\n"]}

package/dist/shell/frame/menuMessages.en.json

@@ -0,0 +1,54 @@
+{
+    "wb.menu.label": "Settings and more",
+    "wb.menu.accountsRow": "Settings and more…",
+    "wb.menu.newColumn": "New deck column",
+    "wb.menu.theme": "Theme",
+    "wb.menu.moreAppearance": "More in Appearance…",
+    "wb.menu.moreLanguages": "More languages…",
+    "wb.menu.zoom": "Zoom",
+    "wb.menu.zoomIn": "Zoom in",
+    "wb.menu.zoomOut": "Zoom out",
+    "wb.menu.zoomReset": "Reset zoom",
+    "wb.menu.zoomNone": "This tab has no page to zoom",
+    "wb.menu.zoomChip": "Zoom {percent}. Click to reset.",
+    "wb.menu.saveLayout": "Save layout…",
+    "wb.menu.noWorkspaces": "No saved workspaces yet",
+    "wb.menu.shortcuts": "Keyboard shortcuts…",
+    "wb.menu.palette": "Command palette",
+    "wb.menu.developer": "Developer",
+    "wb.menu.pluginsFolder": "Open plugins folder",
+    "wb.menu.about": "About {product}",
+    "wb.menu.section": "{section}…",
+    "wb.menu.find": "Find in page…",
+    "wb.menu.findField": "Find in page",
+    "wb.menu.findHint": "Finds what this page has loaded so far",
+    "wb.menu.findCount": "{index}/{count}",
+    "wb.menu.findTotal": "{count, plural, one {# match} other {# matches}}",
+    "wb.menu.findNone": "No matches",
+    "wb.menu.findNext": "Next match",
+    "wb.menu.findPrevious": "Previous match",
+    "wb.menu.findClose": "Close find bar",
+    "wb.menu.updateCheck": "Check for updates",
+    "wb.menu.updateChecking": "Checking…",
+    "wb.menu.updateUpToDate": "Up to date",
+    "wb.menu.updateUpToDateVersion": "Up to date · {version}",
+    "wb.menu.updateDownloading": "Downloading {version}…",
+    "wb.menu.updateInstalling": "Installing {version}…",
+    "wb.menu.updateRestart": "Restart to update",
+    "wb.menu.updateFailed": "Could not check",
+    "wb.menu.updateFailedHint": "The update server did not answer. Nothing is wrong with the app; it checks again later on its own.",
+    "wb.menu.safe": "Safe mode",
+    "wb.menu.safeRestart": "Restart in safe mode…",
+    "wb.menu.safeQuestion": "Restart the tabs in safe mode?",
+    "wb.menu.safeExplain": "Every tab loads again with plugins, themes, custom CSS and page features off, for this run only. Your setup is back the next time you start the app.",
+    "wb.menu.safeConfirm": "Restart tabs in safe mode",
+    "wb.menu.safeLeave": "Leave safe mode",
+    "wb.menu.safeLeaveShort": "Leave",
+    "wb.menu.safeChip": "Safe mode is on: plugins, themes, custom CSS and page features are off for this run. Click to leave; the tabs load again with your setup.",
+    "wb.menu.report": "Report a problem…",
+    "wb.menu.reportTitle": "Report a problem",
+    "wb.menu.reportLede": "This is everything the report contains: versions and what is switched on. No account, no address, nothing from the pages you have open. Copy it, then paste it into your report.",
+    "wb.menu.reportOpen": "Open the issue page",
+    "wb.menu.reportNoPage": "This app has no public issue page yet. Copy the text and send it to the developer.",
+    "wb.menu.strings": "Languages"
+}

package/dist/shell/frame/menuModel.d.ts

@@ -0,0 +1,277 @@
+import type { UpdateStatus } from '../updateModel.ts';
+import EN from './menuMessages.en.json';
+import { type Params } from './i18n.ts';
+import type { IconName } from './icons.tsx';
+/** The menu's English (`wb.menu.*`), for the catalogs. */
+export declare const MENU_MESSAGES: Readonly<Record<string, string>>;
+type MenuKey = keyof typeof EN;
+/** A menu message's name: its key without the `wb.menu.` prefix. */
+export type MenuWord = MenuKey extends `wb.menu.${infer Name}` ? Name : never;
+/** A menu message in the active language; English from menuMessages.en.json until a catalog has it. */
+export declare function menuText(name: MenuWord, params?: Params): string;
+/** The rows the frame brings. Each shows only when the app serves what it needs (`builtinAvailable`). */
+export declare const MENU_BUILTINS: readonly ["new-tab", "split-right", "split-down", "new-column", "language", "theme", "mode", "zoom", "plugins", "store", "strings", "workspaces", "find", "shortcuts", "palette", "developer", "updates", "safe-mode", "report", "about", "settings"];
+export type BuiltinMenuItem = typeof MENU_BUILTINS[number];
+/** A row of the app's own. */
+export type MenuItemSpec = {
+    /** Unique in the menu (never a built-in's name). */
+    id: string;
+    label(): string;
+    icon?: IconName;
+    /** Its keys, written like `Ctrl+Shift+D` (shown as the platform writes them; the app handles the keys). */
+    shortcut?: string;
+    /** Quiet text at the end of the row instead of a shortcut (a count, a version). */
+    hint?(): string;
+    /** Leave the row out while this is false. */
+    when?(): boolean;
+    /** A toggle: the row is a checkbox showing this state; `run` flips it. */
+    checked?(): boolean;
+    run?(): void | Promise<void>;
+    /** A submenu instead of an action (its rows may have submenus of their own). */
+    submenu?(): MenuItemSpec[];
+    /** Starts a new group (a rule above this row) inside a submenu. */
+    separated?: boolean;
+    /** The menu stays open after `run` (a toggle someone may flip back). */
+    keepOpen?: boolean;
+};
+export type MenuEntry = BuiltinMenuItem | MenuItemSpec;
+/** Ordered groups; a rule is drawn between two groups. */
+export type MenuGroups = ReadonlyArray<ReadonlyArray<MenuEntry>>;
+/** One language of the app (a row of its `languages.json`). */
+export type MenuLanguage = {
+    code: string;
+    name: string;
+    englishName: string;
+    dir: 'ltr' | 'rtl';
+    tier: 'supported' | 'community';
+};
+/** The app's language state (frame/language.ts `createLanguage`), as the panel's picker takes it. */
+export type MenuLanguages = {
+    list: readonly MenuLanguage[];
+    state(): {
+        preference: string;
+        siteLang: string | null;
+        locale: string;
+    };
+    subscribe(listener: () => void): () => void;
+    set(preference: string): Promise<void>;
+};
+/** The app's modes (Basic / Advanced / Power User): the panel's `menuModes()` gives this. */
+export type MenuModes = {
+    list(): ReadonlyArray<{
+        id: string;
+        label: string;
+    }>;
+    /** The mode in use (null: none chosen yet). */
+    current(): Promise<string | null>;
+    /** How many of the owner's own changes choosing `to` would replace (0: nothing to ask). */
+    changes(to: string): Promise<number>;
+    /** Applies `to`, keeping the owner's own changes or not. */
+    apply(to: string, keep: boolean): Promise<void>;
+    /** How the features relate to the mode in use (omit: the menu never says "custom"). */
+    status?(): Promise<MenuModeStatus>;
+    /** Applies the mode in use again as it is now: exactly what `status()` listed. */
+    reapply?(): Promise<void>;
+    /** The "new features" note was looked at; it is not shown again. */
+    seen?(): Promise<void>;
+};
+/**
+ * A mode is a starting point. `custom`: the features are no longer what the mode starts from;
+ * `on` / `off`: the names of what applying it again would turn on and off; `added`: how many of
+ * those the mode gained in an update since it was applied.
+ */
+export type MenuModeStatus = {
+    custom: boolean;
+    on: string[];
+    off: string[];
+    added: number;
+};
+/** Lines an app adds to the "Report a problem" summary (reportModel.ts): ids only, never anything about the person. */
+export type ReportDetails = ReadonlyArray<{
+    label: string;
+    values: readonly string[];
+}>;
+/** `ShellSite.menu`: the app menu's rows and what the built-in ones need from the app. */
+export type ShellMenu = {
+    /** The rows, in order. A string is a built-in row, an object one of the app's. Default: `DEFAULT_MENU`. */
+    groups?: MenuGroups;
+    /** The Language submenu; omit for an app in one language. */
+    languages?: MenuLanguages;
+    /** The Mode submenu; omit for an app without modes. */
+    modes?: MenuModes;
+    /** The app's version, shown on the Updates row. */
+    version?(): Promise<string>;
+    /**
+     * "Report a problem": the project's new-issue page (https; opened bare in the system browser, the
+     * summary is never put in the URL) and lines the app adds to the summary (a fixed English label
+     * and ids: what paused itself, which areas are on). Without `issueUrl` the dialog still shows and
+     * copies the summary; its button is off and says there is no public page yet.
+     */
+    report?: {
+        issueUrl?: string;
+        details?(): ReportDetails | Promise<ReportDetails>;
+    };
+    /** Opens the app's shortcuts sheet ("Keyboard shortcuts…"); without one the row opens the command palette. */
+    shortcuts?(): void;
+};
+/** The menu an app gets without saying anything: every built-in row it can serve. */
+export declare const DEFAULT_MENU: MenuGroups;
+/** `groups` with the app's `items` put next to the row `anchor` (after it, or before). Without that row they form a last group. */
+export declare function menuWith(groups: MenuGroups, anchor: string, items: readonly MenuEntry[], where?: 'after' | 'before'): MenuGroups;
+/** `groups` without the rows named. */
+export declare function menuWithout(groups: MenuGroups, ...ids: string[]): MenuGroups;
+/** What the app serves, as far as the built-in rows care. */
+export type MenuEnv = {
+    /** Decks of site columns (`site.deck`). */
+    decks: boolean;
+    /** `menu.languages`. */
+    languages: boolean;
+    /** `site.themes`. */
+    themes: boolean;
+    /** `menu.modes` with at least one mode. */
+    modes: boolean;
+    /** `features`: native page zoom (`tab_zoom`), find in page (`tab_find`), the Store, workspaces, developer mode, the updater. */
+    zoom: boolean;
+    find: boolean;
+    /** `features.safeMode`: safe mode for one run (`safe_mode_get/set`, the host's own). */
+    safeMode: boolean;
+    store: boolean;
+    /** `features.strings`: the panel has the Languages section (string packs). */
+    strings: boolean;
+    workspaces: boolean;
+    developer: boolean;
+    updates: boolean;
+};
+/** Whether the app can serve a built-in row: a row that would do nothing is never shown. */
+export declare function builtinAvailable(id: BuiltinMenuItem, env: MenuEnv): boolean;
+/**
+ * The entries the menu shows, group by group: built-in rows the app cannot serve and rows whose
+ * `when()` says no are left out, a row listed twice shows once, a group left empty goes (so no
+ * rule is ever doubled), and an unknown name is ignored.
+ */
+export declare function planMenu(groups: MenuGroups, env: MenuEnv): MenuEntry[][];
+export type MenuItemRow = {
+    kind: 'item';
+    id: string;
+    label: string;
+    icon?: IconName;
+    shortcut?: string;
+    hint?: string;
+    disabled?: boolean;
+    /** A choice among its neighbours (radio) or a toggle (checkbox), with `checked`. */
+    check?: 'radio' | 'checkbox';
+    checked?: boolean;
+    /** Opens a submenu (its rows come from the menu, by this row's id). */
+    submenu?: boolean;
+    keepOpen?: boolean;
+    /** The label's own language and direction (a language's native name). */
+    lang?: string;
+    dir?: 'ltr' | 'rtl';
+    /** The row's tooltip (a plain sentence that does not fit the row). */
+    title?: string;
+    /** A theme's colors, drawn as three dots (`ThemeAdapter.dots`). */
+    swatch?: {
+        page: string;
+        bg: string;
+        border: string;
+        text: string;
+        accent: string;
+    };
+    run?(): unknown;
+};
+export type MenuRow = MenuItemRow | {
+    kind: 'separator';
+}
+/** Words that are not a choice: a question above its answers, an empty list, an error. */
+ | {
+    kind: 'note';
+    id: string;
+    title: string;
+    text?: string;
+    tone?: 'error';
+}
+/** The zoom row: − 100% + and a reset, in one line. */
+ | {
+    kind: 'zoom';
+    id: 'zoom';
+};
+/** Groups of rows as one list with a rule between two groups. */
+export declare function joinGroups(groups: ReadonlyArray<readonly MenuRow[]>): MenuRow[];
+/** The app's own entries as rows (`submenu` rows are looked up again when they open). */
+export declare function specRows(specs: readonly MenuItemSpec[]): MenuRow[];
+/** The app's entry with this id, anywhere in its groups or their submenus. */
+export declare function findSpec(groups: MenuGroups, id: string): MenuItemSpec | null;
+/** Arrow keys, Home and End over `count` stops; wraps around. -1 (nothing focused) enters at an end. */
+export declare function moveStop(index: number, key: string, count: number): number;
+/**
+ * Type-ahead: the next stop after `from` whose label starts with what was typed (accents and case
+ * ignored). One letter typed again cycles through the labels that start with it. -1: none.
+ */
+export declare function typeahead(labels: readonly string[], from: number, typed: string): number;
+/** The keys that open and close a submenu: they follow the reading direction. */
+export declare function submenuKeys(rtl: boolean): {
+    open: string;
+    close: string;
+};
+/**
+ * The left edge of a submenu `width` wide beside its menu (`parent`), in a window `viewport` wide.
+ * The menu hangs at one edge of the window (under its button at the end, under the logo at the
+ * start): the submenu opens toward the middle, else on the other side, else over the menu, and
+ * always stays `edge` pixels inside the window.
+ */
+export declare function submenuLeft(parent: {
+    left: number;
+    right: number;
+}, width: number, viewport: number, edge?: number): number;
+/** A shortcut as the platform writes it: `Ctrl+Shift+T` on Windows and Linux, `⇧⌘T` on macOS. */
+export declare function shortcutText(shortcut: string, mac: boolean): string;
+/**
+ * The Language submenu: follow the site, follow the system, then the supported languages by their
+ * own names (the one chosen is checked; a community language in use is listed too, so the check is
+ * never missing), then the way to the full list in Settings.
+ */
+export declare function languageRows(list: readonly MenuLanguage[], state: {
+    preference: string;
+    siteLang: string | null;
+    locale: string;
+}, words: {
+    site: string;
+    system: string;
+    more: string;
+}): MenuRow[];
+/** The preference a Language row stands for (`lang:tr` → `tr`), or null for "More languages…". */
+export declare function languageChoice(id: string): string | null;
+/** Page zoom limits, as native code clamps them (waybetter-host `zoom.rs`). */
+export declare const ZOOM_MIN = 0.25;
+export declare const ZOOM_MAX = 5;
+/** The steps − and + move through (a browser's). */
+export declare const ZOOM_STEPS: readonly [0.25, 0.33, 0.5, 0.67, 0.75, 0.8, 0.9, 1, 1.1, 1.25, 1.5, 1.75, 2, 2.5, 3, 4, 5];
+/** The next step up (`1`) or down (`-1`) from `factor`, or 100% (`0`). Stays inside the limits. */
+export declare function zoomStep(factor: number, direction: 1 | -1 | 0): number;
+/** The Updates row: what it says and what choosing it does. */
+export type UpdateRow = {
+    label: string;
+    /** Quiet text at the end of the row: the state, or the version while nothing is happening. */
+    hint?: string;
+    /** A plain sentence for the row's tooltip (why a check did not get through). */
+    title?: string;
+    /** `check`: ask the updater now. `restart`: install the downloaded update. `open`: the Updates section. `wait`: nothing, a step is running. */
+    action: 'check' | 'restart' | 'open' | 'wait';
+};
+/**
+ * The Updates row for the updater's status. `asked`: the owner asked for a check in this menu;
+ * only then does a check that did not get through say so (the timer's own failures stay quiet),
+ * and it says it calmly: a short state, never the error text.
+ */
+export declare function updateRow(status: UpdateStatus, asked: boolean, version: string): UpdateRow;
+/**
+ * What the find bar says about a search: "3/17" (the active match of the total), the total alone
+ * while no match is active, "No matches" for none. `number` writes a number in the active language.
+ */
+export declare function findLabel(counts: {
+    count: number;
+    index: number;
+}, number?: (value: number) => string): string;
+/** Whole percent of a factor (1.1 → 110). */
+export declare const zoomPercent: (factor: number) => number;
+export {};