waybetter 0.1.1 → 0.7.0

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

@@ -0,0 +1,47 @@
+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 Media panel's key: Ctrl+Shift+G on Windows and Linux; Cmd+Shift+M on macOS, where Cmd+Shift+G
+ * is the system's Find Previous (the native Edit menu owns it).
+ */
+export declare function isMediaShortcut(event: {
+    key: string;
+    shiftKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+}, os: string): boolean;
+/** The Media panel's key as shown in hints and lists. */
+export declare const mediaShortcutLabel: (os: string) => string;
+/** 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,67 @@
+// 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 Media panel's key: Ctrl+Shift+G on Windows and Linux; Cmd+Shift+M on macOS, where Cmd+Shift+G
+ * is the system's Find Previous (the native Edit menu owns it).
+ */
+export function isMediaShortcut(event, os) {
+    if (!event.shiftKey || event.altKey)
+        return false;
+    const key = event.key.toLowerCase();
+    if (os === 'macos')
+        return event.metaKey && !event.ctrlKey && key === 'm';
+    return (event.ctrlKey || event.metaKey) && key === 'g';
+}
+/** The Media panel's key as shown in hints and lists. */
+export const mediaShortcutLabel = (os) => (os === 'macos' ? 'Cmd+Shift+M' : 'Ctrl+Shift+G');
+/** 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/**\n * The Media panel's key: Ctrl+Shift+G on Windows and Linux; Cmd+Shift+M on macOS, where Cmd+Shift+G\n * is the system's Find Previous (the native Edit menu owns it).\n */\nexport function isMediaShortcut(event: { key: string; shiftKey: boolean; ctrlKey: boolean; metaKey: boolean; altKey: boolean }, os: string): boolean {\n  if (!event.shiftKey || event.altKey) return false;\n  const key = event.key.toLowerCase();\n  if (os === 'macos') return event.metaKey && !event.ctrlKey && key === 'm';\n  return (event.ctrlKey || event.metaKey) && key === 'g';\n}\n\n/** The Media panel's key as shown in hints and lists. */\nexport const mediaShortcutLabel = (os: string): string => (os === 'macos' ? 'Cmd+Shift+M' : 'Ctrl+Shift+G');\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,96 @@
+{
+    "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",
+    "wb.menu.barFile": "File",
+    "wb.menu.barEdit": "Edit",
+    "wb.menu.barView": "View",
+    "wb.menu.barAccount": "Account",
+    "wb.menu.barPlugins": "Plugins",
+    "wb.menu.barWindow": "Window",
+    "wb.menu.barHelp": "Help",
+    "wb.menu.appHide": "Hide {product}",
+    "wb.menu.appHideOthers": "Hide Others",
+    "wb.menu.appShowAll": "Show All",
+    "wb.menu.appQuit": "Quit {product}",
+    "wb.menu.appServices": "Services",
+    "wb.menu.appUpdates": "Check for Updates…",
+    "wb.menu.appSettings": "Settings…",
+    "wb.menu.appSafe": "Safe Mode",
+    "wb.menu.fileClose": "Close Tab",
+    "wb.menu.fileInstall": "Install from File…",
+    "wb.menu.fileShare": "Share My Setup…",
+    "wb.menu.editUndo": "Undo",
+    "wb.menu.editRedo": "Redo",
+    "wb.menu.editCut": "Cut",
+    "wb.menu.editCopy": "Copy",
+    "wb.menu.editPaste": "Paste",
+    "wb.menu.editSelectAll": "Select All",
+    "wb.menu.editFind": "Find…",
+    "wb.menu.editFindNext": "Find Next",
+    "wb.menu.editFindPrevious": "Find Previous",
+    "wb.menu.viewZoomIn": "Zoom In",
+    "wb.menu.viewZoomOut": "Zoom Out",
+    "wb.menu.viewActual": "Actual Size",
+    "wb.menu.viewIconPack": "Icon Pack",
+    "wb.menu.viewDeck": "Deck",
+    "wb.menu.viewFullScreen": "Enter Full Screen",
+    "wb.menu.acctNone": "No accounts yet",
+    "wb.menu.acctAdd": "Add Account…",
+    "wb.menu.plugStore": "Store…",
+    "wb.menu.plugFolder": "Open Plugins Folder…",
+    "wb.menu.winMinimize": "Minimize",
+    "wb.menu.winZoom": "Zoom",
+    "wb.menu.winWorkspaces": "Workspaces",
+    "wb.menu.helpDocs": "Docs",
+    "wb.menu.helpReport": "Report a Problem…"
+}

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

@@ -0,0 +1,319 @@
+import type { UpdateStatus } from '../updateModel.ts';
+import EN from './menuMessages.en.json';
+import { type Params } from './i18n.ts';
+import type { IconName } from './icons.tsx';
+import type { Choice } from './nativeMenuModel.ts';
+/** 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[];
+}>;
+/** Where the app menu's trigger is (`ShellMenu.trigger`). */
+export type AppMenuTrigger = 'pane' | 'button' | 'logo';
+/** The trigger in use: `AppMenu`'s own `trigger` (`true` / `false` are the older `button` / `logo`), else the app's, else `pane`. */
+export declare function resolveTrigger(trigger: AppMenuTrigger | boolean | undefined, configured: AppMenuTrigger | undefined): AppMenuTrigger;
+/**
+ * What an app adds to the native menu bar (macOS; nativeMenu.ts): lists the frame cannot know, and the
+ * actions only the app can run. Whatever is omitted leaves its item out of the bar.
+ */
+export type NativeMenuApp = {
+    /** The Plugins menu's checked rows (the app's plugin or area switches) and what flipping one does. */
+    plugins?: {
+        list(): Choice[] | Promise<Choice[]>;
+        set(id: string, on: boolean): Promise<void> | void;
+        subscribe?(listener: () => void): () => void;
+    };
+    /** View > Icon Pack: the packs and picking one. */
+    iconPacks?: {
+        list(): Choice[];
+        set(id: string): Promise<void> | void;
+        subscribe?(listener: () => void): () => void;
+    };
+    /** File > Install from File…: asks for a file and stages it on the normal install screen. */
+    installFromFile?(): void;
+    /** File > Share My Setup…. */
+    shareSetup?(): void;
+    /** Help > Docs. */
+    docs?(): void;
+    /** Help > the project's site: the label shown (a host name) and the https address opened in the browser. */
+    website?: {
+        label: string;
+        url: string;
+    };
+};
+/** `ShellSite.menu`: the app menu's rows and what the built-in ones need from the app. */
+export type ShellMenu = {
+    /**
+     * What opens the menu with a click: `pane` (default), each pane's wayBetter button at the end of
+     * its toolbar (the menu hangs under the button that was clicked); `button`, a "⋮" button at the
+     * end of the titlebar; `logo`, the titlebar's logo. Keys and other requests open it at the same place.
+     */
+    trigger?: AppMenuTrigger;
+    /** 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 native menu bar (macOS): the app's lists and actions. */
+    native?: NativeMenuApp;
+};
+/** 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 {};