efficient-shell 7.75.0 → 8.0.1

package/dist/shell/strings.d.ts

@@ -0,0 +1,1560 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface ShellStrings {
+    /** Window chrome: control tooltips and the title bar's accessible name. */
+    window: {
+        minimize: string;
+        /** Bring a hand-minimized window back — the tab's own control. */
+        restore: string;
+        maximize: string;
+        windowed: string;
+        pinOnTop: string;
+        unpin: string;
+        close: string;
+        /** Suffix of the title bar's aria-label: `"{title} — {windowSuffix}"`. */
+        windowSuffix: string;
+        prev: string;
+        next: string;
+        snapLayouts: string;
+        snapLeft: string;
+        snapRight: string;
+        snapTopLeft: string;
+        snapTopRight: string;
+        snapBottomLeft: string;
+        snapBottomRight: string;
+    };
+    /** Taskbar and exposé. */
+    taskbar: {
+        closeWindow: string;
+        offscreenHint: string;
+        offscreenDot: string;
+        expose: string;
+        addToDesktop: string;
+        removeFromDesktop: string;
+        /** Group menu — a taskbar tab standing for more than one window. The
+         *  count is appended by the caller, e.g. "Close all (3)". */
+        minimizeAllWindows: string;
+        restoreAllWindows: string;
+        closeAllWindows: string;
+    };
+    /** The logout cover. */
+    logout: {
+        goodbye: string;
+        seeYou: string;
+    };
+    /** About + What's New dialogs. */
+    about: {
+        aboutPrefix: string;
+        thisApp: string;
+        openSourceLicenses: string;
+        whatsNew: string;
+        noChangelog: string;
+    };
+    /** Data-display defaults (DataTable, lists). */
+    table: {
+        empty: string;
+        loading: string;
+        selectAll: string;
+        selectRow: string;
+    };
+    /** Picker defaults (SearchableSelect, TagInput). */
+    select: {
+        none: string;
+        noMatches: string;
+        allSelected: string;
+        clear: string;
+        /** The row at the top of an open multi-pick list that clears every choice. */
+        clearAll: string;
+        /** What a screen reader hears for `Select`'s `changed` mark (the "*" on
+         *  the closed field): the value differs from what it follows, such as a
+         *  text box changed away from its style. */
+        changed: string;
+        /** A closed multi-pick field too narrow for even one label and a "+N":
+         *  how many are chosen ("6 selected"). */
+        selectedCount: (count: number) => string;
+        /** aria-label of a TagInput chip's remove button: `"{remove} {label}"`. */
+        remove: string;
+        /** The whole chip label, when the word order is not "{remove} {label}".
+         *  Wins over `remove` when supplied. */
+        removeItem?: (label: string) => string;
+    };
+    /** Notification bell + popup. */
+    notifications: {
+        title: string;
+        markAllRead: string;
+        dnd: string;
+        dndOn: string;
+        caughtUp: string;
+        empty: string;
+        viewAll: string;
+        /** The meta line's actor, when the title doesn't already name them. */
+        byActor: (name: string) => string;
+        cardLabel: string;
+        dismiss: string;
+    };
+    /** Form-level messages. */
+    form: {
+        errorSummaryTitle: string;
+    };
+    /** HelpCenter chrome. */
+    help: {
+        title: string;
+        searchPlaceholder: string;
+        empty: string;
+        noResults: string;
+        loading: string;
+        pickArticle: string;
+        noBody: string;
+        draft: string;
+        newArticle: string;
+        edit: string;
+    };
+    /** The app-update banner (a deploy happened under a long-lived tab). */
+    update: {
+        available: string;
+        refreshNow: string;
+    };
+    /** The page-tab strip (`efficient-shell/page-tabs`). */
+    pageTabs: {
+        /** The strip's accessible name. */
+        label: string;
+        /** A tab's close button, and the menu item: `"{close} {title}"` for the button. */
+        close: string;
+        /** The close button's whole label, when the word order is not
+         *  "{close} {title}". Wins over `close` for the button when supplied. */
+        closeTab?: (title: string) => string;
+        /** The star after a favourite app's title (Sidebar layout's strip). */
+        favorite: string;
+        closeOthers: string;
+        closeRight: string;
+        closeAll: string;
+        /** Marks a tab with unsaved changes (the dot's accessible text). */
+        unsaved: string;
+        /** The active tab's copy icon: `"Copy SO-0041"`. */
+        copy: (text: string) => string;
+        /** The copy icon's label for a moment after it copied. */
+        copied: string;
+        /** The active tab's icon, where it opens the page's own menu. */
+        tabMenu: string;
+        /** Asked before a tab with unsaved changes closes. */
+        discardTitle: string;
+        discardOne: string;
+        /** Several at once — the count is prefixed by the caller: "3 pages have…". */
+        discardMany: string;
+        /** The whole several-at-once sentence, for a language whose noun follows
+         *  the count's plural form. Wins over `discardMany` when supplied. */
+        discardCount?: (count: number) => string;
+        discardConfirm: string;
+        keepEditing: string;
+    };
+    /** `Dialog` and `Drawer`'s close control, and the dialogs behind `confirm`,
+     *  `confirmDestructive` and `prompt` (each option a caller passes wins). */
+    dialog: {
+        close: string;
+        cancel: string;
+        ok: string;
+        /** `confirm`'s heading when the caller gives no `title`. */
+        confirmTitle: string;
+        /** `confirmDestructive`'s heading, cancel and confirm defaults. */
+        destructiveTitle: string;
+        destructiveCancel: string;
+        destructiveConfirm: string;
+        /** The line over the type-to-confirm box; the word is drawn in a `<kbd>`
+         *  wherever the sentence puts it. */
+        typeToConfirm: (word: string) => string;
+        /** `prompt`'s heading when the caller gives no `title`. */
+        promptTitle: string;
+    };
+    /** The month grid (`Calendar`, and the pickers that open it). Month and
+     *  weekday NAMES are not here — they come from `locale`. */
+    calendar: {
+        previousMonth: string;
+        nextMonth: string;
+        previousYear: string;
+        nextYear: string;
+        previousYears: string;
+        nextYears: string;
+        /** The month and year panels' accessible names. */
+        monthPanel: string;
+        yearPanel: string;
+        /** The heading's month button. */
+        chooseMonth: (month: string) => string;
+        /** The heading's year button. */
+        chooseYear: (year: number) => string;
+    };
+    /** `DatePicker`'s trigger and popover. */
+    datePicker: {
+        placeholder: string;
+        /** The popover's accessible name when the field has no `aria-label`. */
+        dialog: string;
+        clear: string;
+        today: string;
+        /**
+         * Part of a `required` trigger's DESCRIPTION ("Due date, button,
+         * 11 August 2026, Required"). The trigger is a button, and ARIA gives a
+         * button no `aria-required`, so the fact is said in words instead.
+         */
+        required: string;
+    };
+    /** `DateRangePicker`. */
+    dateRange: {
+        placeholder: string;
+        /** The trigger's × button. */
+        clearRange: string;
+        /** The popover's and the grid's accessible name. */
+        dialog: string;
+        from: string;
+        to: string;
+        /** The From/To boxes before a day is chosen. */
+        start: string;
+        end: string;
+        /** The trigger with only one end of the range set. */
+        fromOnly: (date: string) => string;
+        toOnly: (date: string) => string;
+        /**
+         * The whole range as a sentence — what a labelled trigger is DESCRIBED
+         * as, after its label names it ("Period, button, 1 August 2026 to
+         * 3 October 2026"). Both dates arrive spelled out in the locale.
+         */
+        range: (from: string, to: string) => string;
+        /**
+         * Part of a `required` trigger's description, as `datePicker.required` is
+         * for one date. Its own entry, not that one borrowed: an override merges
+         * per section, so a host that translated `dateRange` is never left with one
+         * English word from a section it did not; and in a language whose
+         * adjective agrees with its noun the word for a required range is not the
+         * word for a required date (`obligatorio` / `obligatoria`).
+         */
+        required: string;
+        last2Weeks: string;
+        lastMonth: string;
+        last3Months: string;
+        last6Months: string;
+        last12Months: string;
+        /**
+         * The phone layout: the presets sit in an even three-column block under
+         * one heading, so each says only its span. The full names above stay the
+         * buttons' accessible names and the desktop's column.
+         */
+        lastHeading: string;
+        last2WeeksShort: string;
+        lastMonthShort: string;
+        last3MonthsShort: string;
+        last6MonthsShort: string;
+        last12MonthsShort: string;
+        custom: string;
+        clear: string;
+        cancel: string;
+        apply: string;
+    };
+    /** `Pagination` (and `DataTable`'s pager). */
+    pagination: {
+        label: string;
+        first: string;
+        previous: string;
+        next: string;
+        last: string;
+    };
+    /** `ListFooter` and `ListLoadError`, and what `EntityList` says in the same
+     *  words: its row menu's heading and the line under its last row. `label` is
+     *  the caller's own noun ("records"); the counts are numbers, for the plural. */
+    list: {
+        /** Before the em dash: "3 selected — 40 records". */
+        selected: (count: number) => string;
+        /** In its place when a filter is hiding ticked rows: "2 selected, 5 not
+         *  shown". `count` is the ticked rows on screen and can be zero. */
+        selectedNotShown: (count: number, notShown: number) => string;
+        allLoaded: (total: number, label: string) => string;
+        count: (total: number, label: string) => string;
+        loadedOf: (loaded: number, total: number, label: string) => string;
+        /** After a middle dot: "40 of 900 records · Loading more...". `EntityList`
+         *  says it again under the last row, where the next page will land. */
+        loadingMore: string;
+        loadError: string;
+        loadErrorMessage: string;
+        retry: string;
+    };
+    /** `Kanban`'s defaults (its own props win). */
+    kanban: {
+        loading: string;
+        empty: string;
+        dropHere: string;
+        addItem: string;
+    };
+    /** File intake: `FilePicker`, `ComposerAttachments`, and the rejection
+     *  messages every upload control shares. */
+    files: {
+        attach: string;
+        drop: string;
+        remove: (name: string) => string;
+        chooseMany: string;
+        chooseOne: string;
+        /** After the choose link, in the same line. */
+        dragMany: string;
+        dragOne: string;
+        /** `hint` is the caller's `acceptHint` when it is a string, else ''. */
+        notAccepted: (name: string, hint: string) => string;
+        /** `size` and `limit` arrive written out — "6.2 MB". */
+        tooLarge: (name: string, size: string, limit: string) => string;
+        tooMany: (name: string, max: number) => string;
+        bytes: (value: number) => string;
+        kilobytes: (value: number) => string;
+        megabytes: (value: number) => string;
+    };
+    /** `MediaUploadField` and `MediaUploadGrid`. */
+    media: {
+        uploadImage: string;
+        uploadVideo: string;
+        uploadFile: string;
+        /** The drop zone's accessible name when its prompt is not a string. */
+        upload: string;
+        cta: string;
+        replace: string;
+        remove: string;
+        uploading: string;
+        cover: string;
+        add: string;
+        addMedia: string;
+        empty: string;
+        removeItem: (name: string) => string;
+        /** A reorderable thumbnail's accessible name. */
+        reorder: (name: string, position: number, total: number) => string;
+        /** `MediaUploadField`'s kind strip: the slot holds an image or a video. */
+        image: string;
+        video: string;
+        /** The filled slot's main action, in the bar along the picture. */
+        changeImage: string;
+        changeVideo: string;
+        /** Names the focus dot on the picture: "Image focus: 38% 64%". */
+        focus: string;
+    };
+    /** `BrandAssetEditor`. `noun` is the last word of `assetName`, lower-cased
+     *  ("Portal logo" → "logo"); a translation that cannot use it has
+     *  `assetName` itself. */
+    brandAsset: {
+        save: (noun: string, assetName: string) => string;
+        remove: (noun: string, assetName: string) => string;
+        discard: string;
+        saveFailed: (noun: string, assetName: string) => string;
+        removeFailed: (noun: string, assetName: string) => string;
+        region: (assetName: string, subjectName: string) => string;
+        usedFor: (subjectName: string) => string;
+        previews: (assetName: string) => string;
+        preview: string;
+        alt: (subjectName: string, assetName: string) => string;
+    };
+    /** `Snippet`'s copy button, `CopyButton` beside a record's number in a
+     *  window title, and the clipboard's toasts. */
+    copy: {
+        copy: string;
+        copyLabel: (label: string) => string;
+        /** Snippet's spoken confirmation. */
+        copied: string;
+        /** `CopyButton`'s tooltip. It names the VALUE it copies, where
+         *  `copyLabel` names a field: "Copy SO-0041". */
+        copyValue: (value: string) => string;
+        /** …and for a moment after it copied. */
+        copiedValue: string;
+        /** `copyToClipboard`'s success toast; `label` names what was copied. */
+        copiedLabel: (label: string) => string;
+        failed: string;
+    };
+    /** `NumericKeypad`. */
+    keypad: {
+        backspace: string;
+        enter: string;
+    };
+    /** `Banner`. */
+    banner: {
+        dismiss: string;
+    };
+    /** `TransferProgress`: a long task's progress pill (no dots: "…" means cut text). */
+    transfer: {
+        /** The default verb while busy. */
+        uploading: string;
+        error: string;
+        retry: string;
+        dismiss: string;
+        /** The cancel when the verb is not plain words. */
+        cancel: string;
+        /** The cancel named for the act; given the verb lower-cased ("uploading"). */
+        cancelVerb: (verb: string) => string;
+    };
+    /** A closable `ColoredBadge`'s × (its `closeLabel` wins). */
+    badge: {
+        /** When the badge's content is not plain text. */
+        remove: string;
+        removeItem: (label: string) => string;
+    };
+    /** `Breadcrumbs`. */
+    breadcrumbs: {
+        label: string;
+        /** The ellipsis standing for the crumbs `maxItems` folded away. */
+        hidden: string;
+    };
+    /** `EmptyState`'s line when the caller gives neither a title nor a message. */
+    emptyState: {
+        message: string;
+    };
+    /** `ErrorPage`, `ErrorBoundary` and `Result`'s status defaults. */
+    errors: {
+        notFound: string;
+        notFoundBody: string;
+        forbidden: string;
+        forbiddenBody: string;
+        /** `Result status="403"`'s title — gentler than `ErrorPage`'s. */
+        noAccess: string;
+        serverError: string;
+        serverErrorBody: string;
+        retry: string;
+        details: string;
+    };
+    /** `GlobalSearch`. */
+    search: {
+        placeholder: string;
+        /** The key cap beside the input. */
+        escBadge: string;
+        searching: string;
+        noResults: string;
+        minChars: (min: number) => string;
+        navigate: string;
+        open: string;
+        close: string;
+        enterKey: string;
+        escKey: string;
+        /** Section titles of the empty-state palette and of the quick-action group. */
+        recent: string;
+        favorites: string;
+        actions: string;
+        /** Accessible name of the result list. */
+        listLabel: string;
+        /** The count beside a group header; `more` when the providers cut the group short ("5+"). */
+        groupCount: (count: number, more: boolean) => string;
+        /** Accessible name of a result group: its title and how many rows it holds. */
+        groupLabel: (title: string, count: number, more: boolean) => string;
+        /** The last row of a cut-short group, opening the type's own list with the query filled in. */
+        seeAll: (listLabel: string) => string;
+        /** Every provider failed: shown instead of "no results". */
+        searchFailed: string;
+        /** Some providers failed: one line under the results that did arrive. */
+        partialFailure: string;
+        /** Footer hint for the Tab key, shown when there is more than one group. */
+        tabKey: string;
+        nextGroup: string;
+    };
+    /** `EditableGrid`. */
+    grid: {
+        selectAll: string;
+        insertRowAbove: string;
+        insertRowBelow: string;
+        deleteRow: (row: number) => string;
+        insertColumnLeft: string;
+        insertColumnRight: string;
+        deleteColumn: (column: string) => string;
+        resize: string;
+        fill: string;
+    };
+    /** `SidebarLayout`: its resize handle, and on a phone its section bar. */
+    sidebar: {
+        resize: string;
+        /** The bar's name for the folded sidebar when no row is active, and the
+         *  name of the sheet it opens. */
+        sections: string;
+        /** The backdrop behind the sheet, which closes it. */
+        closeSections: string;
+    };
+    /** `ResizeHandle` — the drag grip on a side panel's edge. */
+    resizeHandle: {
+        /** Its accessible name, when the caller gives none. */
+        label: string;
+        /** Its tooltip: how to use it. */
+        hint: string;
+    };
+    /** `InputNumber`'s `steppers`: the two arrow buttons' accessible names. */
+    number: {
+        increase: string;
+        decrease: string;
+    };
+    /** `Slider`. The label arrives as the caller wrote it. */
+    slider: {
+        /** The typed value box beside the range: "Opacity value". */
+        value: (label: string) => string;
+    };
+    /** `Accordion`. */
+    accordion: {
+        /** What a band's count pill says to a screen reader: "2 changed". The
+         *  count arrives formatted for the locale. */
+        changed: (count: string) => string;
+    };
+    /**
+     * The per-view state of a setting (S7, V2 2026-10-09, D3 2026-10-12):
+     * `SettingRow`'s `viewState`, the `auto` look of `InputNumber`, `Select` and
+     * `Slider`, and `SettingReset`. Labels arrive as the caller wrote them.
+     */
+    settingView: {
+        /** The tag after the name, and what a screen reader hears on an auto
+         *  control: a value this view works out from the one above. */
+        auto: string;
+        /** What a screen reader hears for the edited dot. */
+        edited: string;
+        /** The Desktop ↺'s name: "Reset Padding". */
+        resetName: (label: string) => string;
+        /** The Tablet and Phone ↺'s name: "Inherit parent layout for Padding". */
+        inheritName: (label: string) => string;
+        /** The right-click menu item a host adds on Tablet and Phone — the same
+         *  words as the ↺ there, so the two never say it two ways. */
+        inheritParentLayout: string;
+        /** What the Desktop ↺ goes back to, when the host does not say. */
+        backToDefault: string;
+        /** What the Tablet and Phone ↺ goes back to, when the host does not say. */
+        backToAuto: string;
+        /** What it goes back to, as the host says it: "back to auto, 40px". */
+        backTo: (detail: string) => string;
+        /** The ↺'s tooltip: its name and what it goes back to. */
+        tip: (name: string, backTo: string) => string;
+    };
+    /** `DisplayChips`: the show / hide chip of each part of a section. */
+    displayChips: {
+        /** A shown chip's description, for a screen reader. */
+        shown: string;
+        /** A hidden chip's description. */
+        hidden: string;
+        /** A shown chip's hover label: its state and what a press does. */
+        shownHint: string;
+        /** A hidden chip's hover label. */
+        hiddenHint: string;
+    };
+    /** `CornersInput` — the Corners row's radius box. The corner names are the
+     *  host's, as the caller wrote them. */
+    corners: {
+        /** The radius box's accessible name, when the host gives none. */
+        radius: string;
+        /** The unit drawn inside the radius box. */
+        unit: string;
+        /** The short mark drawn before the radius number ("R"). Silent: the box
+         *  is named by `radius`, never by this. */
+        radiusMark: string;
+    };
+    /** `IconPicker` — the button that opens a grid of glyphs. */
+    iconPicker: {
+        /** The button's name while a glyph is chosen: "Icon: Arrow". */
+        button: (name: string, choice: string) => string;
+    };
+    /** A glyph's word, by its meaning in the one set (`none`: no glyph): an
+     *  `IconPicker` cell's name and tooltip, and its button's while chosen. A
+     *  meaning not listed shows its own key. */
+    iconNames: {
+        none: string;
+        'arrow-right': string;
+        'arrow-long-right': string;
+        'arrow-up-right': string;
+        'chevron-right': string;
+        external: string;
+        cart: string;
+        bag: string;
+        tag: string;
+        email: string;
+        location: string;
+        play: string;
+        download: string;
+        search: string;
+        car: string;
+    };
+    /** `WidthsBar`. Columns arrive counted from 1; shares as whole percentages. */
+    widths: {
+        /** A column's field, typed in its segment of the bar: "Column 2". */
+        column: (column: number) => string;
+        /** A handle's accessible name: "Divider between column 1 and column 2". */
+        divider: (left: number, right: number) => string;
+        /** What a handle announces: "Column 1 50%, column 2 25%". */
+        dividerValue: (left: number, leftShare: number, right: number, rightShare: number) => string;
+        /** A handle's tooltip. */
+        dragHint: string;
+        /** Under the bar: how a width is changed, and the floor. `last` (the
+         *  number of the last column) is kept for overrides written before every
+         *  column became typeable; the default does not use it. */
+        hint: (last: number, min: number) => string;
+        /** The button that clears the widths back to equal. */
+        reset: string;
+    };
+    /** `ColorPicker`, `ColorPickerPanel` and `ColorSwatch`. The label arrives
+     *  as the caller wrote it; a colour arrives as the hex that is printed. */
+    color: {
+        /** The swatch that opens the picker: "Text color: #0B5CFF". */
+        swatch: (label: string, value: string) => string;
+        /** What a swatch reads while there is no colour. */
+        none: string;
+        /** The picker panel's name: "Text color picker". */
+        panel: (label: string) => string;
+        /** The saturation-and-brightness square… */
+        square: string;
+        /** …and what it says it is at. Both arrive as 0–100. */
+        squareValue: (saturation: number, brightness: number) => string;
+        hue: string;
+        /** The opacity strip and the `%` box: "Text color opacity". */
+        opacity: (label: string) => string;
+        /** The hex box: "Text color hex code". */
+        hex: (label: string) => string;
+        /** The row of preset swatches. */
+        presets: string;
+        /** The swatch that takes the colour away. */
+        clear: string;
+    };
+    /** `ImageFocusPoint`. The label arrives as the caller wrote it; the point
+     *  arrives as the stored string, "38% 64%". */
+    imageFocus: {
+        /** The picture's accessible name: "Image focus: 38% 64%". */
+        picture: (label: string, value: string) => string;
+        /** The line under the picture, and its description: how to use it. */
+        hint: string;
+        /** Shown instead of the picture while there is none. */
+        noImage: string;
+    };
+    /** `LinkPicker`, its window and `TextLinkField`. The kinds, their targets,
+     *  hints and filters are the host's; these are the part's own words. A
+     *  label arrives as the caller wrote it; an address as it is saved. */
+    link: {
+        /** The Link type list's accessible name. */
+        linkType: string;
+        /** The typed address box's accessible name. */
+        address: string;
+        /** What the empty address box says. */
+        addressPlaceholder: string;
+        /** Why a typed address cannot be saved. */
+        unsafe: string;
+        /** A saved target, filter or value the host no longer offers: "/gone (unavailable)". */
+        unavailable: (value: string) => string;
+        /** The Filter box's accessible name. */
+        filter: string;
+        /** The Filter box's first option: the listing with no filter. */
+        noFilter: string;
+        /** The Value box's accessible name. */
+        value: string;
+        /** Under the boxes while a Filter is offered. */
+        filterHint: string;
+        /** The window's name, and the word over its boxes. */
+        title: string;
+        apply: string;
+        cancel: string;
+        /** Takes the link off; the words stay. */
+        remove: string;
+        /** `TextLinkField`'s link row while there is no link. */
+        addLink: string;
+        /** `TextLinkField`'s text box: "Button text". */
+        text: (label: string) => string;
+        /** `TextLinkField`'s link row: "Button link: /wheels", or with no link "Button link: none". */
+        linkOf: (label: string, url: string) => string;
+    };
+    /** `TextToolbar`: each button's name (its accessible name and its tooltip). */
+    textToolbar: {
+        /** The toolbar's accessible name. */
+        formatting: string;
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        color: string;
+        link: string;
+        sup: string;
+        sub: string;
+        /** Inline code (`offered` has `code`). */
+        code: string;
+        /** The alignment group's accessible name. */
+        alignment: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
+        alignJustify: string;
+        bullet: string;
+        number: string;
+        /** A quoted paragraph (`offered` has `quote`). */
+        quote: string;
+        /** The letter case group's accessible name. */
+        letterCase: string;
+        caseNone: string;
+        caseUpper: string;
+        caseLower: string;
+    };
+    /** `TreeEmptySlot`, a draggable `TreeRow`'s grip and `TreeSeam`. */
+    tree: {
+        /** What an empty list says at rest. */
+        empty: string;
+        /** What it says while a drag may land in it. */
+        dropHere: string;
+        /** A draggable row's grip, on hover. */
+        dragHint: string;
+        /** A row `onMove` moves: its accessible description, the keys. */
+        moveHint: string;
+        /** A seam's "+": it adds a row at that place. */
+        insertHere: string;
+    };
+    /** Layout Mode — the Desktop and Sidebar layouts, the Sidebar layout's menu
+     *  rail and its strip of open windows. */
+    layout: {
+        /** The two choices in Preferences → Customization → Layout Mode. */
+        desktop: string;
+        sidebar: string;
+        /** The one-click switches: the rail's account menu, the Start menu and
+         *  the taskbar's right-click menu. */
+        switchToDesktop: string;
+        switchToSidebar: string;
+        collapseSidebar: string;
+        expandSidebar: string;
+        /** The brand at the top of the rail, when it brings the Home tab forward. */
+        goHome: string;
+        /** The grip on the open rail's edge that drags its width. */
+        resizeSidebar: string;
+        /** The rail's search box (it opens the search palette). */
+        search: string;
+        /** The rail's accessible name. */
+        navLabel: string;
+        /** The strip of open windows' accessible name. */
+        openWindows: string;
+        /** The favourite apps' launch icons: the group's accessible name, an
+         *  icon's right-click menu (open it, take it off the favourites). Shared
+         *  by the Desktop taskbar and the Sidebar layout's strip. */
+        favoriteApps: string;
+        openFavorite: (label: string) => string;
+        removeFavorite: string;
+        /** The tag on a page result in the search palette. */
+        pageResult: string;
+        /** The account menu at the foot of the rail. */
+        accountMenu: (name: string) => string;
+        profile: string;
+        notifications: string;
+        reportIssue: string;
+        signOut: string;
+        signOutTitle: string;
+        signOutMessage: string;
+        /** The phone's top bar (`PhoneChrome`): the button that slides the menu
+         *  out, and the menu's own close button. */
+        openMenu: string;
+        closeMenu: string;
+        /** The phone's top bar: the current tab's title opens the list of open
+         *  tabs; this is that list's name and the button's description. */
+        openTabs: string;
+        /** The phone's top-bar banner for a host-wired mobile app (`mobileApp`). */
+        getTheApp: (productName: string) => string;
+        openApp: string;
+        dismiss: string;
+        /** Customization on a mobile device, which always uses the Sidebar layout. */
+        deviceUsesSidebar: string;
+        largerScreensOnly: string;
+        usedOnThisDevice: string;
+        /** On a phone, Preferences' way from a section back to the list. */
+        back: string;
+    };
+    /** `MarkdownLite`. */
+    markdown: {
+        /** Before an image placeholder's caption, with an em dash between. */
+        screenshot: string;
+    };
+    /** The word a severity marker is spoken and tooltipped with. */
+    severity: {
+        success: string;
+        warning: string;
+        danger: string;
+        /** A token that is not one of the three, as received. */
+        unrecognised: (token: string) => string;
+    };
+    /** `MetricBar` and `BudgetBar`. */
+    meter: {
+        noData: string;
+        warningAt: (bound: number) => string;
+        criticalAt: (bound: number) => string;
+        noReading: string;
+        noBudget: string;
+        /** The meter's spoken value: "84% of budget". */
+        ofBudget: (value: string) => string;
+        /** The deadline marker's tooltip. */
+        budget: string;
+        /** The pace marker's tooltip: where the reading should be by now. */
+        pace: string;
+        hoursMinutes: (hours: number, minutes: number) => string;
+        minutesSeconds: (minutes: number, seconds: number) => string;
+        seconds: (seconds: number) => string;
+    };
+    /** The chart family. Series, axis and category names are the caller's. */
+    charts: {
+        showTable: string;
+        loading: string;
+        noData: string;
+        windowStart: string;
+        windowEnd: string;
+        window: (from: string, to: string, count: number) => string;
+        overIntervals: (series: string[], count: number) => string;
+        acrossCategories: (series: string[], count: number) => string;
+        acrossMeasures: (series: string[], count: number) => string;
+        /** The pie's accessible name; `total` is written by the caller's `formatValue`. */
+        breakdown: (total: string, segments: number) => string;
+        funnel: (stages: number, first: string, last: string) => string;
+        radialTrack: (count: number) => string;
+        radialCycle: (count: number) => string;
+        /** Column heads of the screen-reader tables some charts carry. */
+        tableFrom: string;
+        tableTo: string;
+        tableItem: string;
+        tableLevel: string;
+        tableSeries: string;
+        inBucket: (total: string) => string;
+        inCategory: (total: string) => string;
+        value: string;
+        share: string;
+        count: string;
+        flow: string;
+        totalFlow: string;
+        throughput: string;
+        open: string;
+        high: string;
+        low: string;
+        close: string;
+        maximum: string;
+        q3: string;
+        median: string;
+        q1: string;
+        minimum: string;
+        distribution: string;
+        fiveNumber: (label: string, count: number) => string;
+        outliers: (count: number) => string;
+        price: string;
+        ohlc: (label: string, count: number) => string;
+        closedAbove: string;
+        closedBelow: string;
+        noFlows: string;
+        chord: (count: number) => string;
+        /** Under a chord chart that folded its smallest participants into "Other". */
+        chordFolded: (count: number) => string;
+        noStages: string;
+        ofFirstStage: string;
+        droppedHere: string;
+        intensity: string;
+        noActivity: string;
+        heatmap: (label: string, rows: number, columns: number) => string;
+        /** A histogram's y-axis title. */
+        countAxis: string;
+        histogram: (label: string, bins: number, observations: number) => string;
+        observations: string;
+        /** `Meter` with no value to judge. */
+        notEnough: string;
+        objectiveMet: (objective: string) => string;
+        objectiveMissed: (objective: string) => string;
+        nothingToPlot: string;
+        nothingToCompare: string;
+        /** The pie slice the small segments are folded into. */
+        other: string;
+        nothingToBreakDown: string;
+        range: string;
+        rangeLabel: (label: string, count: number) => string;
+        nothingToRank: string;
+        /** Spoken after the emphasised row of `RankedBars`. */
+        emphasised: string;
+        sankey: (nodes: number, links: number) => string;
+        noObservations: string;
+        xAxis: string;
+        yAxis: string;
+        size: string;
+        scatter: (series: string[], yLabel: string, xLabel: string) => string;
+        outsideRange: (count: number) => string;
+        waterfall: (steps: number, from: string, to: string) => string;
+        balance: string;
+        increase: string;
+        decrease: string;
+        runningTotal: string;
+        sunburst: (total: string, depth: number) => string;
+        treemap: (count: number) => string;
+        /** `StatTile`'s delta direction, spoken after the arrow glyph. */
+        trendUp: string;
+        trendDown: string;
+        trendFlat: string;
+    };
+    /** `TimelineTrack` and `MilestoneTimeline`. */
+    timeline: {
+        /** A cut in the axis: "412 days". */
+        days: (count: number) => string;
+        daysToToday: (count: number) => string;
+        notReached: string;
+        /** Before the first pending entry, with a middle dot after it. */
+        next: string;
+        more: (count: number) => string;
+        today: string;
+        todayTitle: (date: string) => string;
+        open: (name: string) => string;
+        openButton: string;
+        scrub: string;
+        alsoToCome: (names: string[]) => string;
+        start: (date: string) => string;
+        /** A folded run of marks: its count, then each member's own name. */
+        events: (count: number, names: string[]) => string;
+        started: (date: string) => string;
+        duration: (days: number) => string;
+        reached: (dated: number, total: number) => string;
+        milestones: (title: string) => string;
+    };
+    /** `ProductionTimeline`. */
+    production: {
+        heading: string;
+        /** The synthetic report standing for the production start. */
+        start: string;
+        /** The synthetic report between two real ones. */
+        estimated: string;
+        estimatedCompletion: string;
+        estDone: string;
+        play: string;
+        pause: string;
+        playTitle: string;
+        backTo: (report: string) => string;
+        /** The report is drawn bold wherever the sentence puts it. */
+        showing: (report: string) => string;
+        overall: (percent: number) => string;
+        inStock: (pieces: number) => string;
+        noReport: string;
+        leadTime: (days: number) => string;
+        report: string;
+        shipment: string;
+        inspection: string;
+        invoice: string;
+        scrub: string;
+        label: (from: string, to: string) => string;
+    };
+    /** `ContainerFillChart`. Volumes are cubic metres. */
+    containers: {
+        items: (count: number) => string;
+        pieces: (count: number) => string;
+        split: (instructed: number, loaded: number) => string;
+        added: (count: number, pieces: number) => string;
+        fill: (volume: number, capacity: number) => string;
+        total: string;
+        instructed: (volume: number) => string;
+        loaded: (volume: number) => string;
+        volume: (volume: number) => string;
+        noVolume: string;
+    };
+    /** `toast.notify`'s card. */
+    toast: {
+        notification: string;
+        /** `toast.undoable`'s action: "Undo". */
+        undo: string;
+    };
+    /** `efficient-shell/map`: `EntityMap` and what sits over it. Pins, groups
+     *  and marks are named by the caller's own labels; these are the words
+     *  around them. `noun` is `EntityMap`'s `noun` for the count, or `places`. */
+    map: {
+        /** Over a map that could not be drawn (no WebGL, MapLibre not loaded). */
+        failed: string;
+        /** A pin placed at an area, not its address: its accessible name. */
+        approximate: (label: string) => string;
+        /** …and its tooltip. */
+        approximateTitle: (label: string) => string;
+        /** What the map's pins are, when `EntityMap` is not told: "place" / "places". */
+        places: (count: number) => string;
+        /** A group of pins that are not stops: "3 places here". */
+        group: (count: number, noun: string) => string;
+        /** A group of a route's stops, by number: "Stops 3–4". */
+        stops: (numbers: string) => string;
+        /** Pins left off under a stop, counted on it. */
+        closeBy: (count: number, noun: string) => string;
+        /** What pressing a group does: zooms in until its pins stand apart… */
+        spread: string;
+        /** …or, as close as the map goes, chooses the next of them. */
+        cycle: string;
+        /** `EntityMap`'s full-screen control. */
+        fullScreen: string;
+        leaveFullScreen: string;
+        /** `SelectedCard`'s accessible name: the record's own label in it. */
+        chosen: (label: string) => string;
+        /** `SelectedCard`'s close button… */
+        closeCard: string;
+        /** …and the button that opens the record's own page or window. */
+        openRecord: string;
+    };
+    /** `PdfViewer`'s toolbar (`efficient-shell/pdf`, and the Preview window's
+     *  PDF panel). Page numbers arrive as numbers, unformatted. */
+    pdf: {
+        previousPage: string;
+        nextPage: string;
+        /** The counter between the two: "2 / 5". */
+        pageOf: (page: number, total: number) => string;
+        zoomOut: string;
+        zoomIn: string;
+        /** The zoom select's accessible name and tooltip. */
+        zoom: string;
+        /** The zoom select's auto-fit choice, for each `fit`. */
+        fitWidth: string;
+        fitPage: string;
+        /** The Fit button, and its tooltip. */
+        fit: string;
+        fitHint: string;
+        print: string;
+        download: string;
+        email: string;
+        loading: string;
+        /** Toasts: the document could not be read, and Print's window was blocked. */
+        loadFailed: string;
+        allowPopups: string;
+    };
+    /** The plain line a list, or a window whose code is still arriving, shows
+     *  in place of its content (`shell/LoadingSpinner`; the kit's ring of the
+     *  same export name says only what its `label` prop does). */
+    loading: {
+        label: string;
+    };
+    /** `LanguageSelect` and `LanguagePanel`. The languages' own names are not
+     *  here: each is written in its own language and comes from the host's list
+     *  (`ShellLanguage.name`). */
+    language: {
+        /** The panel's heading, and the compact picker's accessible name. */
+        title: string;
+        /** What the choice changes, under the heading. A host that keeps the
+         *  choice on an account says so through the panel's `description`. */
+        description: string;
+        /** Under the list: choosing one reloads the page. */
+        reloadNote: string;
+    };
+    /** `EntityList`'s row menu, and what it says after a copy or an export. The
+     *  menu's heading and the list's footer are `list`'s; a page's own
+     *  `contextActions` carry their own labels. */
+    entityList: {
+        /** Opens the row that was right-clicked. */
+        open: string;
+        /** Copies the text selected under the pointer. */
+        copy: string;
+        /** Copies the first column of the ticked rows, by its heading: "Copy PO Number". */
+        copyColumn: (column: string) => string;
+        /** Copies the ticked rows as a table: "Copy row", "Copy 3 rows". */
+        copyRows: (count: number) => string;
+        exportSelected: string;
+        selectAll: string;
+        /** In its place while the list holds fewer rows than exist. */
+        selectAllLoaded: (loaded: number) => string;
+        clearSelection: string;
+        refresh: string;
+        /** What a copy names in `copy.copiedLabel`'s toast: "Text copied"… */
+        copiedText: string;
+        /** …"Row copied", "3 rows copied". */
+        copiedRows: (count: number) => string;
+        /** The export's toast, when the file holds every row that was ticked. */
+        exported: (count: number) => string;
+        /** The server capped the export: `kept` of the `asked` rows are in the file… */
+        exportTruncated: (kept: number, asked: number) => string;
+        /** …or it did not say how many are. */
+        exportTruncatedUnknown: (asked: number) => string;
+        exportFailed: string;
+    };
+    /** `ResizableTable`'s footer controls: the column chooser, and on a phone
+     *  the switch that brings the tick-box column back. Column names are the
+     *  caller's. */
+    columns: {
+        /** The chooser's button, as a tooltip, and the heading over its list. */
+        choose: string;
+        heading: string;
+        reset: string;
+        /** An admin's link under the list, and what it reads once it has saved. */
+        saveDefault: string;
+        savedDefault: string;
+        /** The phone's switch: its two faces, then the tooltip for each. */
+        select: string;
+        selectDone: string;
+        showSelection: string;
+        hideSelection: string;
+    };
+    /** `EntityWindowState`: what a record's window says while it has no record
+     *  to draw. A refusal (403) is `errors.noAccess`, by way of `Result`. */
+    record: {
+        loading: string;
+        signInRequired: string;
+        signInBody: string;
+        notFound: string;
+        loadFailed: string;
+        /** Under `loadFailed`, when trying again may help… */
+        checkConnection: string;
+        /** …and when the server refused the request itself. */
+        rejected: string;
+        retry: string;
+    };
+    /** `ChangePasswordForm` (its `submitLabel` and `doneLabel` win). */
+    password: {
+        current: string;
+        newPassword: string;
+        confirm: string;
+        submit: string;
+        /** The submit button while the change is in flight. @deprecated No longer shown: the button keeps its name and shows the shell's loading state (owner ruling, 2026-10-14). Kept so an override still type-checks; removed in the next major. */
+        submitting: string;
+        /** The button under the confirmation. */
+        done: string;
+        currentRequired: string;
+        tooShort: (minLength: number) => string;
+        mismatch: string;
+        /** When the host's `onSubmit` rejects without a message of its own. */
+        failed: string;
+        changed: string;
+    };
+    /** `PdfActionButton`: its menu, its toasts, and what it puts in the Preview
+     *  window while the document is on its way (its `label` wins). */
+    pdfAction: {
+        label: string;
+        /** The button while a document is being fetched. @deprecated No longer shown: the button keeps its name and shows the shell's loading state (owner ruling, 2026-10-14). Kept so an override still type-checks; removed in the next major. */
+        loading: string;
+        preview: string;
+        download: string;
+        email: string;
+        downloaded: (filename: string) => string;
+        /** A download or an email that stopped waiting for the document. */
+        tookTooLong: (filename: string) => string;
+        /** The Preview window's placeholder, and the two ways it can end without a
+         *  document: the fetch never settled, or it settled with nothing. */
+        previewLoading: string;
+        previewTookTooLong: string;
+        previewFailed: string;
+    };
+    /** `UndoControls`. `label` is the step's own name, as the form registered
+     *  it; `keys` is the shortcut as the reader's platform writes it. */
+    undo: {
+        undo: string;
+        redo: string;
+        /** The buttons' tooltips: "Undo supplier (Ctrl+Z)". */
+        undoStep: (label: string, keys: string) => string;
+        redoStep: (label: string, keys: string) => string;
+        nothingToUndo: string;
+        nothingToRedo: string;
+    };
+    /** `SoundsPanel`, and the same grid in Preferences → Customization. Only the
+     *  NAMES are here: the scheme and event keys stored under `erp_sound_config`
+     *  are identifiers and never translated. */
+    sounds: {
+        title: string;
+        /** The switch over the grid. */
+        enable: string;
+        autosave: string;
+        /** One round button of the grid, by its row and column: "Click — Classic". */
+        choice: (event: string, pack: string) => string;
+        /** The schemes, a column each. */
+        packClassic: string;
+        packMinimal: string;
+        packRetro: string;
+        packSoft: string;
+        packArcade: string;
+        packSilent: string;
+        /** The events, a row each. */
+        eventClick: string;
+        eventSuccess: string;
+        eventError: string;
+        eventNotification: string;
+        eventStartup: string;
+        eventTimerDone: string;
+        eventLogout: string;
+    };
+    /** `ServerStatusIndicator`: the tray globe's tooltip and the card it opens.
+     *  A time arrives written in the locale. The host, the protocol, the user
+     *  agent and a latency (`42 ms`) are data and notation, so they are not here. */
+    serverStatus: {
+        connected: string;
+        disconnected: string;
+        /** Before the first poll answers, and while a manual one is in flight. */
+        checking: string;
+        /** The globe's tooltip once a poll has succeeded: "Connected · last ok 10:42:07". */
+        lastOkTitle: (status: string, time: string) => string;
+        /** The card's accessible name. */
+        details: string;
+        /** Under the status: "Last poll 5s ago." */
+        lastPoll: (ago: string) => string;
+        lastFailure: (ago: string) => string;
+        firstPoll: string;
+        /** The rows, by their labels. */
+        server: string;
+        protocol: string;
+        browser: string;
+        /** What the Browser row reads. */
+        online: string;
+        offline: string;
+        lastOk: string;
+        lastFail: string;
+        latency: string;
+        poll: string;
+        /** What the Poll row reads: "every 15 s". */
+        pollEvery: (seconds: number) => string;
+        /** The two headings further down, and the rows under each. */
+        session: string;
+        user: string;
+        notSignedIn: string;
+        role: string;
+        build: string;
+        app: string;
+        userAgent: string;
+        /** The footer: a hint, and the button it points at. */
+        pingHint: string;
+        refresh: string;
+    };
+    /** `BulkImportGrid`: the paste-or-upload grid, its CSV column mapper and its
+     *  two duplicate reviews. Column titles are the caller's, and its
+     *  `description` wins. Counts are numbers, for the plural. */
+    bulkImport: {
+        description: string;
+        /** After the description, in brackets: "12 lines"… */
+        lines: (count: number) => string;
+        /** …then each totalled column, its sum written in the locale: "Qty: 1,200". */
+        total: (label: string, value: string) => string;
+        clear: string;
+        upload: string;
+        importLines: (count: number) => string;
+        /** The import button while the caller's `onImport` runs. */
+        importing: string;
+        importFailed: string;
+        /** Nothing was typed. `noun` is the first column's title, lower-cased
+         *  ("part number"), and `title` is it as given; both are '' without one. */
+        enterAtLeastOne: (noun: string, title: string) => string;
+        /** Every duplicate was skipped, and nothing else was left. */
+        allSkipped: string;
+        cancel: string;
+        /** The column mapper, for a CSV whose columns could not be told apart. */
+        mapTitle: string;
+        skip: string;
+        /** A CSV column in the mapper's list, with its first value: "Column 2 (e.g. 18x8)". */
+        columnOption: (column: number, sample: string) => string;
+        rowsDetected: (count: number) => string;
+        confirmMapping: string;
+        /** The duplicate review: one card per repeated value, and a choice for each. */
+        duplicatesTitle: string;
+        duplicatesFound: (count: number) => string;
+        occurrences: (count: number) => string;
+        keepFirst: string;
+        keepLast: string;
+        keepAll: string;
+        skipAll: string;
+        keptDropped: (kept: number, dropped: number) => string;
+        proceed: string;
+        /** The same review under `mergeDuplicates`: the rows are summed, not chosen. */
+        duplicatesMerged: (count: number) => string;
+        mergedFrom: string;
+        mergedRows: (count: number) => string;
+        mergeSummary: (rows: number, lines: number) => string;
+    };
+    /** The Preview window (`efficient-shell/apps`): its toolbar, its empty canvas
+     *  and drop zone, the placeholder a file waits behind, the image panel, and
+     *  the words its drawing and 3D panels share. The PDF panel is `pdf`. File
+     *  extensions and package names are notation and stay in the markup; a
+     *  file's own name is data. */
+    preview: {
+        /** The window's title: "invoice.pdf - Preview"… */
+        windowTitle: (name: string) => string;
+        /** …and the name it gives a window with no file in it. */
+        untitled: string;
+        open: string;
+        /** Beside Open: what it reads. */
+        formats: string;
+        /** The empty canvas. `open` is drawn as a link wherever the sentence puts it. */
+        dropHere: (open: string) => string;
+        supportedFormats: string;
+        /** What each kind of file opens as, after its extensions and an em dash.
+         *  The package is drawn in monospace wherever the sentence puts it. */
+        formatPdf: string;
+        formatDxf: (packageName: string) => string;
+        format3d: (packageName: string) => string;
+        formatImage: string;
+        dwgNote: string;
+        /** Over the window while a file is dragged across it. */
+        dropToOpen: string;
+        /** Toasts for a file it cannot read. `extension` has no dot, and is '' for
+         *  a name without one. */
+        dwgUnsupported: string;
+        unsupportedType: (extension: string) => string;
+        /** The placeholder's headline, when the caller staged no `convertingMessage`. */
+        converting: string;
+        /** Every panel's toolbar. */
+        download: string;
+        email: string;
+        /** The drawing and 3D panels' toolbars, hint pills and floating panels. */
+        howToNavigate: string;
+        stopMeasuring: string;
+        scrollToZoom: string;
+        closePanel: string;
+        /** The image panel: into the annotator, and what its toolbar offers there. */
+        annotate: string;
+        annotateHint: string;
+        view: string;
+        viewHint: string;
+        copy: string;
+        save: string;
+        imageFailed: string;
+        downloadFailed: string;
+    };
+    /** Preview's drawing (DXF) panel: its toolbar, the measuring tool, the layer
+     *  list and the AutoCAD-style command bar. The command names (`DI`, `DIM`,
+     *  `H`, `V`, `Z`, `LA`) are what is typed, in every language, and `ΔX` / `ΔY`
+     *  are notation. A distance arrives written out ("18.56 mm"). */
+    drawing: {
+        loading: string;
+        notInstalled: string;
+        /** When the viewer fails without a message of its own. */
+        renderFailed: string;
+        /** The toolbar's button, and the heading of the panel it opens. */
+        layers: string;
+        layersHint: string;
+        allLayers: string;
+        noLayers: string;
+        measure: string;
+        measureHint: string;
+        /** The mode pill beside Measure: `H` and `V` are the commands themselves. */
+        auto: string;
+        autoHint: string;
+        horizontalHint: string;
+        verticalHint: string;
+        point: string;
+        pointHint: string;
+        /** The fixed-distance box in H or V mode: its placeholders, its tooltip and its ×. */
+        fixX: string;
+        fixY: string;
+        fixHint: string;
+        clearFixed: string;
+        /** The measured value's tooltip. `auto` when Auto chose the axis. */
+        horizontalDistance: (auto: boolean) => string;
+        verticalDistance: (auto: boolean) => string;
+        straightDistance: string;
+        fit: string;
+        fitHint: string;
+        /** The hint pill; `preview.scrollToZoom` sits between these two. */
+        dragToPan: string;
+        fitToReset: string;
+        /** `commands` is "DI / DIM", each drawn in monospace. */
+        typeToMeasure: (commands: string) => string;
+        commandPlaceholder: string;
+        /** What `?` answers. */
+        commandHelp: string;
+        /** The command bar's line after a measurement. `axis` is `ΔX` or `ΔY`. */
+        echoDistance: (distance: string, deltaX: string, deltaY: string) => string;
+        echoLinear: (distance: string, axis: string) => string;
+        /** One axis held to a typed value, the other measured. */
+        echoLocked: (axis: string, distance: string, lockedAxis: string, locked: string) => string;
+        /** …and after a typed command. */
+        axisLocked: (axis: string, distance: string) => string;
+        fixedCleared: string;
+        fixedNeedsAxis: string;
+        echoDist: string;
+        echoDimLinear: string;
+        echoHorizontal: string;
+        echoVertical: string;
+        echoAuto: string;
+        measureOn: string;
+        measureOff: string;
+        pickRemoved: string;
+        zoomExtents: string;
+        layersToggled: string;
+        measurementCleared: string;
+        /** An AutoCAD drawing command, by its name: the viewer cannot draw. */
+        readOnly: (command: string) => string;
+        unknownCommand: (command: string) => string;
+        /** Esc with a command half typed. */
+        cancelled: string;
+    };
+    /** Preview's 3D panel: its toolbar, the mesh tree and the display settings.
+     *  The axis letters and `⊥` are notation. */
+    model: {
+        loading: string;
+        /** Under `loading`, for a STEP file. */
+        stepNote: string;
+        notInstalled: string;
+        loadFailed: string;
+        /** A mesh-tree node the file gave no name: the root, and any other. */
+        rootNode: string;
+        node: string;
+        collapse: string;
+        expand: string;
+        /** The toolbar's button, and the same on a row of the mesh tree. */
+        fitToView: string;
+        hide: string;
+        show: string;
+        /** The camera presets: the button's short face, then its tooltip. */
+        isometric: string;
+        isometricView: string;
+        top: string;
+        topView: string;
+        front: string;
+        frontView: string;
+        side: string;
+        sideView: string;
+        /** The projection switch: the one in force, and the tooltip for the other. */
+        perspective: string;
+        orthographic: string;
+        toPerspective: string;
+        toOrthographic: string;
+        snapshot: string;
+        measureHint: string;
+        point: string;
+        pointHint: string;
+        perpendicularHint: string;
+        /** The measured value's tooltip, in each mode. */
+        straightDistance: string;
+        perpendicularDistance: string;
+        meshesHint: string;
+        displayHint: string;
+        downloadOriginal: string;
+        /** The Meshes panel. */
+        meshes: string;
+        readingModel: string;
+        noStructure: string;
+        allVisible: string;
+        hiddenCount: (count: number) => string;
+        /** The hint pill; `preview.scrollToZoom` ends it. */
+        dragToRotate: string;
+        rightDragToPan: string;
+        /** The Model Display panel. */
+        display: string;
+        backgroundColor: string;
+        showEdges: string;
+        edgeColor: string;
+        edgeThreshold: string;
+        sectionView: string;
+        angle: string;
+        axis: string;
+        flipHint: string;
+        /** The flip button's two faces, arrows included. */
+        flip: string;
+        flipped: string;
+        position: string;
+        resetDisplay: string;
+    };
+    /** `ImageAnnotator` — Preview's image panel in Annotate mode, and wherever a
+     *  host embeds it. A colour swatch is named by its hex, which is notation. */
+    annotator: {
+        /** The tools, as their buttons' tooltips. */
+        toolSelect: string;
+        toolDraw: string;
+        toolRect: string;
+        toolEllipse: string;
+        toolArrow: string;
+        toolMosaic: string;
+        toolText: string;
+        toolCrop: string;
+        /** The sliders a shape or a label brings up. */
+        weight: string;
+        radius: string;
+        size: string;
+        padding: string;
+        /** A text label's fonts. */
+        fontSystem: string;
+        fontSerif: string;
+        fontMono: string;
+        fontCursive: string;
+        /** …and its styles: the tooltip, then the letter on the button. */
+        bold: string;
+        boldLetter: string;
+        italic: string;
+        italicLetter: string;
+        underline: string;
+        underlineLetter: string;
+        /** A text label's box: its border and its fill, each added or removed. */
+        border: string;
+        borderColor: string;
+        addBorder: string;
+        removeBorder: string;
+        fill: string;
+        fillColor: string;
+        addFill: string;
+        removeFill: string;
+        /** The button that adds either. */
+        add: string;
+        zoomOut: string;
+        zoomIn: string;
+        fit: string;
+        fitHint: string;
+        undo: string;
+        applyCrop: string;
+        cancel: string;
+        /** Standalone mode's button, which hands the picture back to the host. */
+        apply: string;
+        /** The footer's line: with the select tool and something selected, with it
+         *  and nothing selected, then for the text, crop and pen tools and a shape. */
+        hintSelected: string;
+        hintSelect: string;
+        hintText: string;
+        hintCrop: string;
+        hintDraw: string;
+        hintShape: string;
+        /** In a text label while it is being typed. */
+        textPlaceholder: string;
+        /** Toasts. */
+        loadFailed: string;
+        exportFailed: string;
+        clipboardUnsupported: string;
+        copyFailed: string;
+        copied: string;
+        copyRefused: string;
+    };
+    /** `openAttachment`: what it says when a stored file cannot be shown in a
+     *  window, and what the window says while the caller fetches the file (its
+     *  `loadingMessage` wins). */
+    attachment: {
+        /** The file's name in the window, when the attachment has none. */
+        fallbackName: string;
+        noLink: string;
+        spreadsheetFailed: string;
+        /** A binary workbook, which is opened as a file on purpose. */
+        workbookUnavailable: string;
+        noViewer: string;
+        loading: string;
+        /** When the caller's `fetchBlob` rejects without a message of its own. */
+        loadFailed: string;
+    };
+    /** A bundled app's own About dialog (`BUILTIN_APP_INFO`). The app's name is
+     *  its window-registry label, and is not here. */
+    aboutApp: {
+        /** The window menu's item and the dialog's title: "About Preview". */
+        title: (name: string) => string;
+        version: (version: string) => string;
+        /** The package's name is drawn in a heavier weight wherever the sentence puts it. */
+        partOf: (shell: string) => string;
+        shellVersion: (version: string) => string;
+        /** One line for each app, by its id. */
+        spreadsheet: string;
+        notepad: string;
+        documents: string;
+        preview: string;
+        files: string;
+        browser: string;
+    };
+}
+declare const DEFAULT_SHELL_STRINGS: ShellStrings;
+/** A per-section partial: override any subset of a section's strings. */
+type ShellStringsOverride = {
+    [S in keyof ShellStrings]?: Partial<ShellStrings[S]>;
+};
+declare function currentShellStrings(): ShellStrings;
+/**
+ * Mount once, near the top of the app. `value` is a partial — sections and
+ * keys you do not translate keep their English defaults, so a catalog never
+ * breaks by falling behind a release.
+ *
+ * `locale` is a BCP 47 tag (`'de-DE'`, `'ja'`, `'zh-Hant'`) for how numbers and
+ * dates are written; omit it and they are written exactly as without a
+ * provider. A nested provider without a `locale` keeps its parent's — a subtree
+ * that overrides one string should not lose the app's number format. Strings
+ * do not cascade that way: a nested provider's `value` merges onto the English
+ * defaults, as it always has.
+ */
+declare function ShellStringsProvider({ value, locale, children }: {
+    value?: ShellStringsOverride;
+    locale?: string;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/** The active catalog — English defaults when no provider is mounted. */
+declare function useShellStrings(): ShellStrings;
+/**
+ * The provider's `locale`, canonicalised — `undefined` when there is no
+ * provider or it was given none. Hand it to `formatDate(value, { locale })`,
+ * `fmtSliderDate(ms, locale)`, or `Intl` directly, so a host's own cells write
+ * numbers and dates the way the kit's do.
+ */
+declare function useShellLocale(): string | undefined;
+/**
+ * The text either side of the value in a catalog sentence, for the few
+ * sentences that wrap their value in markup of its own — "Type <kbd>DELETE</kbd>
+ * to confirm:", "Showing <b>PR-7</b>".
+ *
+ * The entry stays a plain `(word) => string`, so a translator writes a sentence
+ * and puts the word wherever their language does; the kit calls it with a
+ * marker no sentence contains and splits there. A sentence that leaves the word
+ * out entirely comes back whole, as the text before it.
+ */
+declare function splitAround(sentence: (slot: string) => string): [string, string];
+
+export { DEFAULT_SHELL_STRINGS, type ShellStrings, type ShellStringsOverride, ShellStringsProvider, currentShellStrings, splitAround, useShellLocale, useShellStrings };