@50arms/ui 0.0.0-stage → 35.1.0

package/dist/types/lib/i18n/areas/forms.d.ts

@@ -0,0 +1,182 @@
+import type { Emphasis } from "../emphasis";
+import { type ReactNode } from "react";
+export interface FormsStrings {
+    slider: {
+        /** The readout of a two-thumb Slider: the low and high value, already locale-formatted. */
+        range: (from: string, to: string) => string;
+    };
+    /** `<Combobox>` and `<MultiCombobox>`. */
+    combobox: {
+        /** Input placeholder when the consumer passes none. */
+        placeholder: string;
+        /** Empty-list message when the consumer passes none. */
+        noMatch: string;
+        /** Name of the clear-the-selection button. */
+        clear: string;
+        /** Name of the open-the-list button. */
+        open: string;
+        /** Name of a selected chip's remove button. */
+        remove: string;
+        /** Name of the screen-reader buttons that close the open list. */
+        dismiss: string;
+    };
+    select: {
+        /** Trigger text while nothing is selected and the caller gave no `placeholder`. */
+        placeholder: string;
+    };
+    statusSelect: {
+        /** Trigger text when the value matches no option and the caller gave no `placeholder`. */
+        unknown: string;
+    };
+    settingRow: {
+        /** Label of the collapsed "details" disclosure when the caller gave no `detailsLabel`. */
+        detailsLabel: string;
+    };
+    passwordInput: {
+        /** Accessible name of the reveal button while the password is hidden. */
+        show: string;
+        /** Accessible name of the reveal button while the password is shown. */
+        hide: string;
+        /** Tooltip explaining why the reveal button is disabled. */
+        disabled: string;
+    };
+    searchInput: {
+        /** Accessible name of the clear button inside the search box. */
+        clear: string;
+    };
+    passwordRequirements: {
+        /** Accessible name of the list of password rules. */
+        label: string;
+    };
+    secretField: {
+        /** Status word of a stored secret whose last test passed. */
+        statusVerified: string;
+        /** Status word of a stored secret whose last test failed (the provider's reason is printed beside it). */
+        statusFailed: string;
+        /** Status word of a stored secret that has never been tested. */
+        statusUnchecked: string;
+        /** Status word while a test of the stored secret runs. */
+        statusChecking: string;
+        /** Status word of a stored secret nothing can test (the caller's own words say why). */
+        statusUnverifiable: string;
+        /** Button that tests the stored secret again. */
+        reverify: string;
+        /** Line under the status; `when` is the already-formatted instant the secret was last tested. */
+        checked: (when: string) => string;
+        /** Banner text while the stored secret is being replaced (a new value typed after Clear). */
+        replacedOnSave: string;
+        /** Placeholder of an empty field when no secret is stored. */
+        notSet: string;
+        /** Accessible name of the reveal button for typed text while it is hidden. */
+        showTyped: string;
+        /** Accessible name of the reveal button for typed text while it is shown. */
+        hideTyped: string;
+        /** Tooltip explaining why the reveal button is disabled. */
+        disabled: string;
+        /** Banner text while the stored secret is marked for removal. */
+        removedOnSave: string;
+        /** Button that undoes the pending removal. */
+        undo: string;
+        /** Button that opens the clear confirmation. */
+        clearStored: string;
+        /** Title of the clear confirmation dialog. */
+        clearTitle: string;
+        /** Body of the clear confirmation; `masked` is the stored value's visible ends ("sk-…ab"), or null when the caller gave no hint. */
+        clearDescription: (masked: string | null) => string;
+        /** Body of the clear confirmation for a row that removes the secret at once; `masked` as above. */
+        clearNowDescription: (masked: string | null) => string;
+        /** Default label of the clear confirmation's destructive button. */
+        clearConfirm: string;
+        /** Who/when line under the field; `when` is the already-formatted instant and either argument may be absent. */
+        updated: (when: string | null, by: string | undefined) => string;
+    };
+    fileUpload: {
+        /** Default call to action inside the drop zone. */
+        dropOrBrowse: string;
+        /** Size limit line under the call to action, given the formatted limit. */
+        upTo: (limit: string) => string;
+        /** Rejection line for a file over the limit, given its name, its size and the limit (both formatted). */
+        tooBig: (name: string, size: string, limit: string) => string;
+        /** Accessible name of the button that drops one queued file, given the file name. */
+        remove: (name: string) => string;
+    };
+    imageUploadField: {
+        /** Default label of the drop zone and of the replace control. */
+        upload: string;
+        /** Default accessible name of the control that removes the image. */
+        remove: string;
+        /** Drop-zone label while an upload is in flight, and the reason the replace and remove controls are disabled meanwhile. */
+        uploading: string;
+        /** Reason the replace and remove controls are disabled when the whole field is. */
+        disabled: string;
+        /** Hint under a circular drop zone. */
+        cropHint: string;
+        /** Error shown when the upload failed without a message of its own. */
+        failed: string;
+    };
+    inlineEdit: {
+        /** Ghost text of an empty InlineEdit. */
+        empty: string;
+        /** Screen-reader announcement while an autosave is in flight. */
+        saving: string;
+        /** Message under a field whose save failed; `retryChord` is the chord that retries it, in the catalog's key names ("Ctrl+Enter"). */
+        failure: (retryChord: string) => string;
+    };
+    inlineMarkdownEdit: {
+        /** Resting text of an empty InlineMarkdownEdit. */
+        empty: string;
+        /** Refusal shown when saving is attempted while an image is unstored. */
+        unstoredImageRefusal: string;
+        /** The verb the hint line names for the save chord: "Ctrl+Enter to save". */
+        saveAction: string;
+    };
+    ratingScale: {
+        /** The very unhappy face's name and tooltip. */
+        veryUnhappy: string;
+        /** The unhappy face's name and tooltip. */
+        unhappy: string;
+        /** The neutral face's name and tooltip. */
+        neutral: string;
+        /** The happy face's name and tooltip. */
+        happy: string;
+        /** The very happy face's name and tooltip. */
+        veryHappy: string;
+    };
+    triStateSwitch: {
+        /** The Yes stop's name and caption. */
+        yes: string;
+        /** The No stop's name and caption. */
+        no: string;
+        /** The middle stop's name and caption (nobody has answered). */
+        unset: string;
+    };
+    colorPicker: {
+        /** Accessible name of the swatch trigger and of each preset swatch: the colour, as `#rrggbb`. */
+        colour: (hex: string) => string;
+        /** Accessible name of the saturation/brightness area. */
+        area: string;
+        /** Spoken value of the area: saturation and brightness, whole percents. */
+        areaValue: (saturation: number, brightness: number) => string;
+        /** Accessible name of the hue slider. */
+        hue: string;
+        /** Spoken value of the hue slider: whole degrees. */
+        hueValue: (degrees: number) => string;
+        /** Label of the hex text field. */
+        hexField: string;
+        /** Error shown under the hex field for text that is not `#rrggbb`. */
+        invalidHex: string;
+        /** Accessible name of the group of preset swatches. */
+        presets: string;
+    };
+    dialog: {
+        /** Accessible name of the corner close button on a Dialog. */
+        close: string;
+        /** Default label of an AlertDialog's cancel button. */
+        cancel: string;
+        /** Default label of an AlertDialog's confirm button. */
+        confirm: string;
+        /** Label of the type-to-confirm field in an AlertDialog; the sentence carries the phrase the person must type exactly once. */
+        typeToConfirm: (phrase: string, emphasis: Emphasis) => ReactNode;
+    };
+}
+export declare const formsStrings: FormsStrings;

package/dist/types/lib/i18n/areas/keys.d.ts

@@ -0,0 +1,15 @@
+/** The keys the library prints the name of: modifiers and the named keys a chord can contain. */
+declare const KEY_IDS: readonly ["ctrl", "cmd", "alt", "shift", "tab", "enter", "backspace"];
+export type KeyId = (typeof KEY_IDS)[number];
+export interface KeysStrings {
+    /** The name printed on the key cap, by key id ("Shift", or "Mayús" on a Spanish keyboard). */
+    keyNames: Record<KeyId, string>;
+}
+export declare const keysStrings: KeysStrings;
+/**
+ * A chord as a person reads it: `ctrl+shift+bracketleft` -> `Ctrl+Shift+[`, each named key in
+ * the catalog's words. A part that is neither a named key, a symbol nor a single character is a
+ * chord the table never declared, so it throws rather than print a made-up name.
+ */
+export declare function chordLabel(chord: string, keyNames: KeysStrings["keyNames"]): string;
+export {};

package/dist/types/lib/i18n/areas/markdown.d.ts

@@ -0,0 +1,150 @@
+import type { HotkeyId } from "../../markdown/hotkeys";
+import type { ReferenceKind } from "../../../components/chat/file-icon";
+export interface MarkdownStrings {
+    markdownEditor: {
+        /** Accessible name of the formatting toolbar; `label` is the editor's own label. */
+        formattingLabel: (label: string) => string;
+        /** Accessible name of the hidden file picker. */
+        fileInputLabel: (label: string) => string;
+        /** Accessible name of the toolbar's overflow menu, which holds the buttons that did not fit the row. */
+        moreFormatting: string;
+        /** Accessible name of the keyboard-shortcuts button. */
+        shortcuts: string;
+        /**
+         * Permanent advisement naming the submit shortcut and what it does (DX-5540): `chord` is the
+         * key combination in the locale's key names for the person's platform ("Ctrl+Enter", "Cmd+Enter"),
+         * `action` is the caller's own word for what it does ("post").
+         */
+        submitAdvisement: (chord: string, action: string) => string;
+        /** Tooltip of a toolbar button: its name and its chord. */
+        buttonTooltip: (name: string, chord: string) => string;
+        /** Names of the toolbar buttons. */
+        toolbar: {
+            bold: string;
+            italic: string;
+            inlineCode: string;
+            link: string;
+            attachFile: string;
+            bulletList: string;
+            numberedList: string;
+            blockquote: string;
+            codeBlock: string;
+            table: string;
+        };
+        /** Header cell of each column of a table the editor inserts ("Column 1"). */
+        tableColumnHeader: (positionText: string) => string;
+        /** Header cell of a column the editor inserts into an existing table. */
+        newColumnHeader: string;
+        /** The attachment strip under the text, and the reference names the editor writes (DXUI-74). */
+        attachment: {
+            /** The word a reference to a kind of file starts with: "Image" in "Image 1". */
+            kinds: Record<ReferenceKind, string>;
+            /** Accessible name of the strip. */
+            strip: string;
+            /** Accessible name of a tile's corner menu, which holds its actions; `name` is the reference name. */
+            actions: (name: string) => string;
+            /** Rename row of that menu; `name` is the reference name. */
+            rename: (name: string) => string;
+            /** Retry row of that menu, on a failed tile. */
+            retry: (name: string) => string;
+            /** Accessible name of the rename field. */
+            renameField: string;
+            /** Button that saves the new name. */
+            renameSave: string;
+        };
+        /** Group headings of the shortcuts panel. */
+        hotkeyGroups: {
+            formatting: string;
+            headings: string;
+            lists: string;
+            blocks: string;
+            tables: string;
+        };
+        /** What each row of the shortcuts panel does. */
+        hotkeys: Record<HotkeyId, string>;
+    };
+    markdownAffordances: {
+        /** Accessible name of the line menu button; `current` is the line's present type. */
+        lineType: (current: string) => string;
+        /** Heading of the block-type group in the line and selection menus. */
+        turnInto: string;
+        /** Names of the block types a line can become. */
+        blockTypes: {
+            paragraph: string;
+            heading1: string;
+            heading2: string;
+            heading3: string;
+            bulletList: string;
+            numberedList: string;
+            taskList: string;
+            blockquote: string;
+            codeBlock: string;
+            table: string;
+            horizontalRule: string;
+        };
+        /** Accessible name of the image address field. */
+        imageSource: string;
+        /** Accessible name of the link address field. */
+        linkDestination: string;
+        /** Button that turns an image into a link. */
+        turnIntoLink: string;
+        /** Button that turns a link into an image. */
+        turnIntoImage: string;
+        /** Button that removes an image but keeps its text. */
+        removeImage: string;
+        /** Button that removes a link but keeps its text. */
+        removeLink: string;
+        /** Visible caption of the code-block language picker. */
+        language: string;
+        /** Accessible name of the code-block language picker. */
+        codeBlockLanguage: string;
+        /** Option meaning the fence names no language. */
+        noLanguage: string;
+        /** Table bar: align the column left. */
+        alignLeft: string;
+        /** Table bar: centre the column. */
+        alignCenter: string;
+        /** Table bar: align the column right. */
+        alignRight: string;
+        /** Table bar: insert a row below. */
+        insertRowBelow: string;
+        /** Table bar: insert a column after. */
+        insertColumnAfter: string;
+        /** Table bar: delete the row. */
+        deleteRow: string;
+        /** Table bar: delete the column. */
+        deleteColumn: string;
+        /** Table bar: delete the table. */
+        deleteTable: string;
+        /** Heading of the inline-format group in the selection menu. */
+        formatGroup: string;
+        /** Names of the inline formats in the selection menu. */
+        format: {
+            bold: string;
+            italic: string;
+            inlineCode: string;
+            strikethrough: string;
+        };
+    };
+    markdownRender: {
+        /** Accessible name of a checked task-list box. */
+        done: string;
+        /** Accessible name of an unchecked task-list box. */
+        notDone: string;
+        /** Accessible name of a scrollable table region. */
+        table: string;
+        /** Accessible name of the footnotes section. */
+        footnotes: string;
+        /** Accessible name of a footnote's return link. */
+        backToReference: string;
+        /** Dialog title of an enlarged image that has no alt text. */
+        image: string;
+    };
+    imageUpload: {
+        /** Title of the warning for files that exist only in this tab. */
+        unstoredTitle: (count: number, countText: string) => string;
+        /** Body of that warning. */
+        unstoredBody: (count: number) => string;
+    };
+}
+export declare const markdownStrings: MarkdownStrings;

package/dist/types/lib/i18n/areas/move-rejected.d.ts

@@ -0,0 +1,16 @@
+export interface MoveRejectedStrings {
+    /** Why a move was refused, by the core's rejection code. */
+    moveRejected: {
+        /** The card is no longer on the board (removed while it was carried). */
+        unknownItem: (itemId: string) => string;
+        /** The card is not in the lane the move said it was in (moved under the person). */
+        wrongColumn: (itemId: string, actualColumn: string, claimedColumn: string) => string;
+        /** A lane in the move is no longer declared (a live update removed it during the drag). */
+        unknownColumn: (column: string) => string;
+        /** The card's old position is beyond the end of its lane (the lane shrank): `n` is the lane's card count, `nText` the same, formatted. */
+        fromIndexPastEnd: (n: number, nText: string, itemId: string, position: string, column: string) => string;
+        /** The new position is beyond the end of the destination lane (`max` is the last allowed). */
+        toIndexPastEnd: (itemId: string, position: string, column: string, max: string) => string;
+    };
+}
+export declare const moveRejectedStrings: MoveRejectedStrings;

package/dist/types/lib/i18n/areas/navigation.d.ts

@@ -0,0 +1,185 @@
+export interface NavigationStrings {
+    /** `<AppShell>`: the sidebar, its collapse control and the mobile navigation drawer. */
+    appShell: {
+        /** The sidebar landmark's accessible name when the consumer passes no `navLabel`. */
+        mainNavigation: string;
+        /** Name (and tooltip) of the sidebar toggle while the sidebar is collapsed. */
+        expandSidebar: string;
+        /** Name (and tooltip) of the sidebar toggle while the sidebar is expanded. */
+        collapseSidebar: string;
+        /** Name of the narrow-layout button that opens the navigation drawer. */
+        openNavigation: string;
+        /** Name of the button that closes the navigation drawer. */
+        closeNavigation: string;
+        /** Screen-reader-only title of the navigation drawer dialog. */
+        navigationTitle: string;
+    };
+    navigation: {
+        /** Accessible name of the breadcrumb trail. */
+        breadcrumb: string;
+        /** Accessible name of the pagination control. */
+        pagination: string;
+        /** Accessible name of the previous-page button. */
+        previousPage: string;
+        /** Accessible name of the next-page button. */
+        nextPage: string;
+        /** Tooltip on the disabled previous-page button on page one. */
+        onFirstPage: string;
+        /** Tooltip on the disabled next-page button on the last page. */
+        onLastPage: string;
+        /** Accessible name of a page-number button. */
+        page: (pageText: string) => string;
+    };
+    themeMenu: {
+        /** Accessible name of the Appearance trigger button. */
+        triggerLabel: string;
+        /** Visible text of the Appearance trigger button. */
+        appearance: string;
+        /** Heading and group name of the light/dark choice. */
+        theme: string;
+        /** The two theme choices. */
+        themes: {
+            light: string;
+            dark: string;
+        };
+        /** Heading and slider name of the text size setting. */
+        textSize: string;
+        /** The three text sizes, as slider stops. */
+        scales: {
+            sm: string;
+            md: string;
+            lg: string;
+        };
+        /** Label and switch name of the high-contrast setting. */
+        highContrast: string;
+        /** Explanation under the high-contrast label. */
+        highContrastHint: string;
+        /** Heading and group name of the motion setting. */
+        motion: string;
+        /** The three motion choices. */
+        motionChoices: {
+            system: string;
+            full: string;
+            reduced: string;
+        };
+        /** What the current motion choice means right now. */
+        motionHint: {
+            full: string;
+            reduced: string;
+            systemReduced: string;
+            systemFull: string;
+        };
+        /** Title of the warning shown when the OS asks for reduced motion and the choice follows the system. */
+        systemReducesTitle: string;
+        /** Advice line of that warning. */
+        systemReducesAdvice: string;
+        /** Where the OS reduce-motion setting lives, per operating system. */
+        osSteps: {
+            windows: string;
+            macos: string;
+            ios: string;
+            android: string;
+            unknown: string;
+        };
+    };
+    /** `<CommandPalette>`. */
+    commandPalette: {
+        /** Screen-reader-only dialog title. */
+        title: string;
+        /** Search input placeholder when the consumer passes none. */
+        placeholder: string;
+        /** Search input accessible name. */
+        searchLabel: string;
+        /** The Escape key cap shown beside the search input. */
+        escapeKey: string;
+        /** Message when no command matches, when the consumer passes none. */
+        noMatch: string;
+        /** Footer legend for the arrow keys. */
+        navigate: string;
+        /** Footer legend for the Enter key. */
+        run: string;
+        /** Footer counter: `shown` matching commands out of `total`. */
+        resultCount: (shownText: string, totalText: string) => string;
+    };
+    paginationBar: {
+        /** Accessible name of the bar's navigation landmark; `label` names what is paged ("Cards"). */
+        navLabel: (label: string) => string;
+        /** Live range text at the bar's left: which items of how many are shown. */
+        range: (firstText: string, lastText: string, totalText: string) => string;
+        /** Accessible name of the per-page picker's trigger button. */
+        rowsPerPage: (sizeText: string) => string;
+        /** Visible text of the per-page trigger on a wide bar. */
+        pageSizeTrigger: (sizeText: string) => string;
+        /** One row of the per-page picker menu. */
+        pageSizeOption: (sizeText: string) => string;
+        /** Accessible name of the previous-page arrow in the simple bar. */
+        previousPage: string;
+        /** Accessible name of the next-page arrow in the simple bar. */
+        nextPage: string;
+        /** Tooltip explaining the previous arrow is disabled on page one. */
+        onFirstPage: string;
+        /** Tooltip explaining the next arrow is disabled on the last page. */
+        onLastPage: string;
+        /** Caption between the arrows of the simple bar. */
+        pageOf: (pageText: string, pageCountText: string) => string;
+    };
+    pagedWindowList: {
+        /** Shown in place of a page whose request failed. */
+        failed: string;
+        /** The retry button next to a failed page. */
+        retry: string;
+    };
+    sortMenu: {
+        /** The words for each direction of an option that supplies none of its own. */
+        directions: {
+            asc: string;
+            desc: string;
+        };
+        /** Accessible name of the closed trigger: the control's own name, the sorted field, its direction. */
+        currentOrder: (controlLabel: string, field: string, direction: string) => string;
+        /** Accessible name of one direction arrow inside the open menu. */
+        optionDirection: (field: string, direction: string) => string;
+    };
+    listHeader: {
+        /** Accessible name of the remove button on the chip that shows an applied search (button search mode); `search` is the full search text. */
+        removeSearch: (search: string) => string;
+    };
+    filterMenu: {
+        /** Accessible name and tooltip of the closed filter button: the control's own name, and how many filters are on (0 = none); `activeCountText` is the count in the locale's digits. */
+        triggerName: (controlLabel: string, activeCount: number, activeCountText: string) => string;
+        /** The popover's "turn every filter off" button. */
+        clearAll: string;
+        /** The text of one active-filter chip: the filter's name, then the value it is set to. */
+        chipLabel: (field: string, option: string) => string;
+        /** Accessible name of a chip's remove button. */
+        removeFilter: (field: string, option: string) => string;
+        /** Accessible name of the remove button of an on/off filter's chip (the chip's text is the filter's own name). */
+        removeFlag: (field: string) => string;
+        /** The value half of a date-range chip with both ends set, already formatted. */
+        dateRange: (from: string, to: string) => string;
+        /** The value half of a date-range chip with only its start set. */
+        dateRangeFrom: (from: string) => string;
+        /** The value half of a date-range chip with only its end set. */
+        dateRangeUntil: (to: string) => string;
+        /** Accessible names of a date-range filter's two date boxes. */
+        dateFrom: (field: string) => string;
+        dateTo: (field: string) => string;
+        /** Name and placeholder of the search box over a long list of options, e.g. "Search Team". */
+        searchOptions: (field: string) => string;
+        /** Shown in place of the options when the search box matches none. */
+        noMatches: string;
+        /** Shown while a field's options are being read the first time the popover opens. */
+        loadingOptions: string;
+        /** Shown in place of a field's options when reading them failed. */
+        loadFailed: (field: string) => string;
+        /** The button that reads a field's options again after a failure. */
+        tryAgain: string;
+        /** The line above a capped list of matches: `shown` of `total` are drawn; `query` is the trimmed search text ("" when nothing is typed). */
+        firstOfMatches: (shown: string, total: string, query: string) => string;
+        /** DXUI-42: the row that creates an option from the typed text (`text`, trimmed) when it matches none. */
+        createOption: (text: string) => string;
+        /** DXUI-42: the Create row while the caller's create is running. */
+        creating: string;
+    };
+}
+export declare const navigationStrings: NavigationStrings;