@danxbot/ui 20.23.3 → 21.0.0

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

@@ -0,0 +1,104 @@
+import type { Emphasis } from "../emphasis";
+import { type ReactNode } from "react";
+export interface FeedbackStrings {
+    /** `<Avatar>`. */
+    avatar: {
+        /** Accessible name of the presence dot, by status. */
+        status: {
+            online: string;
+            busy: string;
+            away: string;
+            offline: string;
+        };
+    };
+    /** `<ConnectionCard>`. */
+    connectionCard: {
+        /** The status badge text, by health. */
+        status: {
+            healthy: string;
+            degraded: string;
+            broken: string;
+            unknown: string;
+        };
+        /** Accessible name of the action button: its visible `actionLabel` composed with the connection `name`. */
+        actionName: (actionLabel: string, name: string) => string;
+    };
+    /** `<CopyValue>`. */
+    copyValue: {
+        /** Accessible name of the copy button for the value called `label`. */
+        copy: (label: string) => string;
+        /** Live-region announcement after a successful copy. */
+        copied: string;
+        /** Live-region announcement after the clipboard refused. */
+        failed: string;
+    };
+    loading: {
+        /** Accessible name of a repeated skeleton. */
+        loading: string;
+    };
+    errorBoundary: {
+        /** Heading of the fallback when the caught subtree has no label. */
+        generic: string;
+        /** Heading of the fallback naming the part of the page that failed. */
+        failure: (label: string) => string;
+    };
+    progress: {
+        /** Name of the unfilled part of a segmented ring when the caller gives no `remainderLabel`. */
+        remaining: string;
+        /** Spoken description of a segmented ring whose segments exceed the total; `breakdown` is the comma-joined per-segment list. */
+        overTotal: (breakdown: string, overflowPercent: string) => string;
+    };
+    readMore: {
+        /** Toggle label while the content is clamped. */
+        more: string;
+        /** Toggle label while the content is expanded. */
+        less: string;
+    };
+    videoPlayer: {
+        /** Message shown in place of a video that failed to load. */
+        cannotPlay: string;
+        /** Download button beside that message. */
+        download: string;
+    };
+    toast: {
+        /** Accessible name of a toast's close button. */
+        dismiss: string;
+    };
+    legalDocument: {
+        /** Default accessible name of the table of contents. */
+        contents: string;
+        /** Callout title counting the placeholders not confirmed yet. */
+        unconfirmedTitle: (count: number, countText: string) => string;
+        /** Callout body explaining how unconfirmed values are shown. */
+        unconfirmedBody: string;
+        /** Label before the effective date in the document header. */
+        effectiveDate: string;
+        /** Label before the version in the document header. */
+        version: string;
+    };
+    lineDiff: {
+        /** Gap row standing for a folded run of unchanged lines. */
+        unchangedLines: (count: number, countText: string) => string;
+    };
+    tree: {
+        /** Accessible name of a closed branch's toggle. */
+        expand: string;
+        /** Accessible name of an open branch's toggle. */
+        collapse: string;
+    };
+    table: {
+        /** Accessible name of the header checkbox that selects every row on the page. */
+        selectAll: string;
+        /** Accessible name of one row's selection checkbox; `position` counts from 1. */
+        selectRow: (positionText: string) => string;
+        /** Message on the overlay shown while rows are refreshing. */
+        updating: string;
+        /** Live summary under the table: how many of the filtered rows are selected. */
+        selectedCount: (selected: number, selectedText: string, totalText: string, emphasis: Emphasis) => ReactNode;
+        /** Name of the table's pagination bar. */
+        paginationLabel: string;
+        /** Title of the default empty state. */
+        emptyTitle: string;
+    };
+}
+export declare const feedbackStrings: FeedbackStrings;

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

@@ -0,0 +1,30 @@
+export interface BooleanStrings {
+    yes: string;
+    no: string;
+    /** Word for a boolean nothing was recorded for. */
+    unknown: string;
+    /** Lower-case spellings `parseBoolean` reads as true (English: ["yes", "y", "true", "t", "1"]). */
+    trueWords: string[];
+    /** Lower-case spellings `parseBoolean` reads as false (English: ["no", "n", "false", "f", "0"]). */
+    falseWords: string[];
+}
+export interface RelativeAgeStrings {
+    justNow: string;
+    /** The moment could not be parsed. */
+    unknown: string;
+    minutesAgo: (n: number, nText: string) => string;
+    hoursAgo: (n: number, nText: string) => string;
+    daysAgo: (n: number, nText: string) => string;
+    daysHoursAgo: (days: number, daysText: string, hours: number, hoursText: string) => string;
+    weeksAgo: (n: number, nText: string) => string;
+}
+export interface ReadErrorStrings {
+    /** A read failed with something that carries no message of its own. */
+    error: string;
+}
+export interface FormatsStrings {
+    boolean: BooleanStrings;
+    relativeAge: RelativeAgeStrings;
+    readError: ReadErrorStrings;
+}
+export declare const formatsStrings: FormatsStrings;

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

@@ -0,0 +1,130 @@
+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;
+    };
+    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;
+    };
+    passwordRequirements: {
+        /** Accessible name of the list of password rules. */
+        label: string;
+    };
+    secretField: {
+        /** Screen-reader-only note that a secret is already stored for the field. */
+        storedNotice: string;
+        /** Placeholder while the stored secret is marked for removal. */
+        willBeRemoved: 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;
+        /** 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, naming the key that retries it. */
+        failure: (retryKey: "Enter" | "Ctrl+Enter") => string;
+    };
+    inlineMarkdownEdit: {
+        /** Resting text of an empty InlineMarkdownEdit. */
+        empty: string;
+        /** Refusal shown when saving is attempted while an image is unstored. */
+        unstoredImageRefusal: 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;
+    };
+    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/markdown.d.ts

@@ -0,0 +1,139 @@
+import type { HotkeyId } from "../../markdown/hotkeys";
+import type { ImageDecorationStrings } from "../../markdown/image-decoration";
+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 image file picker. */
+        imageFileLabel: (label: string) => string;
+        /** Accessible name of the keyboard-shortcuts button. */
+        shortcuts: string;
+        /** Permanent advisement under the editor about how Tab leaves the field. */
+        tabAdvisement: 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;
+            image: 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 words an image shown in the document carries as attributes. */
+        images: ImageDecorationStrings;
+        /** 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 while images upload. */
+        uploadingTitle: (count: number, countText: string) => string;
+        /** Body of that warning. */
+        uploadingBody: string;
+        /** Title of the warning when uploads failed. */
+        failedTitle: (count: number, countText: string) => string;
+        /** Retry button of that warning. */
+        retry: string;
+        /** Body of the failed-upload warning. */
+        failedBody: (count: number) => string;
+        /** Title of the warning for images 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,144 @@
+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;
+    };
+}
+export declare const navigationStrings: NavigationStrings;