@ahrowe/ui 0.31.0 → 0.32.0

package/dist/types/common/actionButtons/actionButtons.types.d.ts

@@ -3,11 +3,16 @@ import { ButtonStyleType } from '../button';
 import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types';
 import { IconContent } from '../types/icon.types';
 export type ActionButtonsSlots = 'root' | 'submitButton' | 'cancelButton';
+/** Text ActionButtons renders of its own, for translating it. */
+export interface ActionButtonsLabels {
+    /** The confirming button (default `Save`). */
+    submit?: ReactElement | number | string;
+    /** The dismissing button (default `Cancel`). */
+    cancel?: ReactElement | number | string;
+}
 export interface ActionButtonsProps extends HtmlProps {
     onSubmit?: () => void;
     onClose?: () => void;
-    submitLabel?: ReactElement | number | string;
-    cancelLabel?: ReactElement | number | string;
     submitButtonStyle?: ButtonStyleType;
     isSubmitButtonLoading?: boolean;
     isSubmitButtonDisabled?: boolean;
@@ -24,4 +29,6 @@ export interface ActionButtonsProps extends HtmlProps {
     style?: CSSProperties;
     classNames?: SlotClassNames<ActionButtonsSlots>;
     styles?: SlotStyles<ActionButtonsSlots>;
+    /** Overrides the text ActionButtons renders of its own. Merged per key. */
+    labels?: ActionButtonsLabels;
 }

package/dist/types/common/alert/alert.types.d.ts

@@ -9,6 +9,11 @@ export declare enum AlertStyleType {
     Error = "error"
 }
 export type AlertSlots = 'root' | 'icon' | 'content' | 'title' | 'description' | 'closeButton';
+/** Text Alert renders of its own, for translating it. */
+export interface AlertLabels {
+    /** Close button, read out by screen readers. */
+    dismiss?: string;
+}
 export interface AlertProps extends Omit<HtmlProps, 'title'> {
     title?: ReactNode;
     children?: ReactNode;
@@ -20,4 +25,6 @@ export interface AlertProps extends Omit<HtmlProps, 'title'> {
     style?: CSSProperties;
     classNames?: SlotClassNames<AlertSlots>;
     styles?: SlotStyles<AlertSlots>;
+    /** Overrides the text Alert renders of its own. Merged per key. */
+    labels?: AlertLabels;
 }

package/dist/types/common/breadcrumb/breadcrumb.types.d.ts

@@ -10,6 +10,11 @@ export interface BreadcrumbItem {
     disabled?: boolean;
 }
 export type BreadcrumbSlots = 'root' | 'list' | 'item' | 'link' | 'icon' | 'separator' | 'current' | 'ellipsis' | 'hiddenList' | 'hiddenItem';
+/** Text Breadcrumb renders of its own, for translating it. */
+export interface BreadcrumbLabels {
+    /** Button that reveals the collapsed middle items, and its tooltip. */
+    showHidden?: string;
+}
 export interface BreadcrumbProps extends HtmlProps {
     items: BreadcrumbItem[];
     separator?: ReactNode;
@@ -23,4 +28,6 @@ export interface BreadcrumbProps extends HtmlProps {
     style?: CSSProperties;
     classNames?: SlotClassNames<BreadcrumbSlots>;
     styles?: SlotStyles<BreadcrumbSlots>;
+    /** Overrides the text Breadcrumb renders of its own. Merged per key. */
+    labels?: BreadcrumbLabels;
 }

package/dist/types/common/carousel/carousel.types.d.ts

@@ -1,6 +1,17 @@
 import { CSSProperties, ReactNode } from 'react';
 import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types';
 export type CarouselSlots = 'root' | 'track' | 'slide' | 'prevButton' | 'nextButton' | 'dots' | 'dot';
+/** Text Carousel renders of its own, for translating it. */
+export interface CarouselLabels {
+    /** Button to the previous slide, and its tooltip. */
+    previous?: string;
+    /** Button to the next slide, and its tooltip. */
+    next?: string;
+    /** The dot strip, read out by screen readers. */
+    slides?: string;
+    /** One dot, given its 1-based slide number. */
+    goToSlide?: (slide: number) => string;
+}
 export interface CarouselProps extends Omit<HtmlProps, 'onChange'> {
     children?: ReactNode;
     currentIndex?: number;
@@ -19,4 +30,6 @@ export interface CarouselProps extends Omit<HtmlProps, 'onChange'> {
     style?: CSSProperties;
     classNames?: SlotClassNames<CarouselSlots>;
     styles?: SlotStyles<CarouselSlots>;
+    /** Overrides the text Carousel renders of its own. Merged per key. */
+    labels?: CarouselLabels;
 }

package/dist/types/common/chip/chip.types.d.ts

@@ -6,6 +6,11 @@ export declare enum ChipStyleType {
     Warn = "warn",
     Error = "error"
 }
+/** Text Chip renders of its own, for translating it. */
+export interface ChipLabels {
+    /** The remove button, read out by screen readers (default `Remove`). */
+    remove?: string;
+}
 export interface ChipProps extends HtmlProps {
     className?: string;
     text?: string;
@@ -13,9 +18,10 @@ export interface ChipProps extends HtmlProps {
     styleType?: ChipStyleType;
     showRemoveIcon?: boolean;
     /** Accessible name for the remove button. Default `'Remove'`. */
-    removeLabel?: string;
     onClick?: () => void;
     onRemove?: () => void;
+    /** Overrides the text Chip renders of its own. Merged per key. */
+    labels?: ChipLabels;
 }
 export interface ChipContainerProps extends HtmlProps {
     className?: string;

package/dist/types/common/colorPicker/colorPicker.d.ts

@@ -1,4 +1,4 @@
 import { ReactElement } from 'react';
 import { ColorPickerProps } from './colorPicker.types';
-declare function ColorPicker({ className, value, onChange, showInput, showAlpha, inline, ...rest }: ColorPickerProps): ReactElement;
+declare function ColorPicker({ className, value, onChange, showInput, showAlpha, inline, labels, ...rest }: ColorPickerProps): ReactElement;
 export default ColorPicker;

package/dist/types/common/colorPicker/colorPicker.types.d.ts

@@ -1,4 +1,9 @@
 import { HtmlProps } from '../types/slots.types';
+/** Text ColorPicker renders of its own, for translating it. */
+export interface ColorPickerLabels {
+    /** The eyedropper button, read out by screen readers. */
+    pickFromScreen?: string;
+}
 export interface ColorPickerProps extends Omit<HtmlProps, 'onChange'> {
     className?: string;
     value?: string;
@@ -6,4 +11,6 @@ export interface ColorPickerProps extends Omit<HtmlProps, 'onChange'> {
     showInput?: boolean;
     showAlpha?: boolean;
     inline?: boolean;
+    /** Overrides the text ColorPicker renders of its own. Merged per key. */
+    labels?: ColorPickerLabels;
 }

package/dist/types/common/configProvider/configProvider.types.d.ts

@@ -7,7 +7,11 @@ import { InputDropdownProps } from '../inputDropdown/inputDropdown.types';
 import { CheckboxProps } from '../checkbox/checkbox.types';
 import { SwitchProps } from '../switch/switch.types';
 import { RadioGroupProps } from '../radioGroup/radioGroup.types';
-import { DatePickerProps } from '../datePicker/datePicker';
+import { DatePickerProps } from '../datePicker/datePicker.types';
+import { ColorPickerLabels } from '../colorPicker/colorPicker.types';
+import { EmptyStateLabels } from '../emptyState/emptyState.types';
+import { KlipyPickerLabels } from '../klipyPicker/klipyPicker.types';
+import { VirtualListLabels } from '../virtualList/virtualList.types';
 import { ButtonProps } from '../button/button.types';
 import { ActionButtonsProps } from '../actionButtons/actionButtons.types';
 import { ConfirmModalProps } from '../confirmModal/confirmModal.types';
@@ -52,6 +56,23 @@ import { ModalProps } from '../modal/modal.types';
  * own component-keyed defaults take precedence for props they handle themselves.
  */
 export interface ComponentDefaults {
+    /**
+     * Labels only. These components take no other global defaults: `ColorPicker`
+     * and `Toast` are configured elsewhere, and `VirtualList`'s props are generic,
+     * which a per-key default map can't express.
+     */
+    ColorPicker?: {
+        labels?: ColorPickerLabels;
+    };
+    EmptyState?: {
+        labels?: EmptyStateLabels;
+    };
+    KlipyPicker?: {
+        labels?: KlipyPickerLabels;
+    };
+    VirtualList?: {
+        labels?: VirtualListLabels;
+    };
     Input?: Partial<InputProps>;
     Textarea?: Partial<TextareaProps>;
     NumberInput?: Partial<NumberInputProps>;

package/dist/types/common/configProvider/index.d.ts

@@ -1,4 +1,5 @@
 export { default } from './configProvider';
 export { useComponentDefaults } from './useComponentDefaults';
+export { useLabels } from './useLabels';
 export { usePresentationDefault } from './usePresentationDefault';
 export type { ComponentDefaults, ConfigProviderProps } from './configProvider.types';

package/dist/types/common/configProvider/useLabels.d.ts

@@ -0,0 +1,22 @@
+import { ComponentDefaults } from './configProvider.types';
+/**
+ * Resolves the text a component renders of its own, per key, from three places:
+ * the component's built-in English, the nearest `ConfigProvider`, and the
+ * instance's `labels` prop, in that order of increasing precedence.
+ *
+ * Per key is the point, and the reason this exists next to `useComponentDefaults`
+ * rather than relying on it. That one fills in whole props: a `labels` object on
+ * an instance would replace the provider's entirely, so translating an app once
+ * and overriding a single string on one instance would silently drop every other
+ * translation for that component.
+ *
+ * ```tsx
+ * const DEFAULT_LABELS: Required<ModalLabels> = { close: 'Close' };
+ *
+ * function Modal({ labels, ...rest }: ModalProps) {
+ *   const text = useLabels('Modal', labels, DEFAULT_LABELS);
+ *   // text.close
+ * }
+ * ```
+ */
+export declare function useLabels<L extends object>(component: keyof ComponentDefaults, labels: Partial<L> | undefined, defaults: L): L;

package/dist/types/common/confirmModal/confirmModal.types.d.ts

@@ -1,5 +1,12 @@
 import { ReactNode } from 'react';
 import { ActionButtonsProps } from '../actionButtons';
+/** Text ConfirmModal renders of its own, for translating it. */
+export interface ConfirmModalLabels {
+    /** The confirming button (default `Confirm`). */
+    submit?: string;
+    /** The dismissing button (default `Cancel`). */
+    cancel?: string;
+}
 export interface ConfirmModalProps {
     children?: ReactNode;
     className?: string;
@@ -8,8 +15,8 @@ export interface ConfirmModalProps {
     title?: string;
     content?: ReactNode;
     isOpen?: boolean;
-    submitLabel?: string;
-    cancelLabel?: string;
     isDelete?: boolean;
     actionButtonsProps?: ActionButtonsProps;
+    /** Overrides the text ConfirmModal renders of its own. Merged per key. */
+    labels?: ConfirmModalLabels;
 }

package/dist/types/common/datePicker/components/datePickerMonth/datePickerMonth.d.ts

@@ -1,14 +1,2 @@
-interface DatePickerMonthProps {
-    className?: string;
-    month?: number;
-    year?: number;
-    onSelect?: (date: Date) => void;
-    selectionStart?: Date;
-    selectionEnd?: Date;
-    minDate?: Date | null;
-    maxDate?: Date | null;
-    /** Called to shift the displayed month by ±1 when arrow navigation runs past its edge. */
-    onNavigateMonth?: (delta: 1 | -1) => void;
-}
+import { DatePickerMonthProps } from './datePickerMonth.types';
 export default function DatePickerMonth({ className, month, year, onSelect, selectionStart, selectionEnd, minDate, maxDate, onNavigateMonth, }: DatePickerMonthProps): import("react").JSX.Element;
-export {};

package/dist/types/common/datePicker/components/datePickerMonth/datePickerMonth.types.d.ts

@@ -0,0 +1,20 @@
+export interface DatePickerMonthProps {
+    /** Class on the root element. */
+    className?: string;
+    /** Month to display, 1 to 12. */
+    month?: number;
+    /** Year to display. */
+    year?: number;
+    /** Called with the day that was picked. */
+    onSelect?: (date: Date) => void;
+    /** First day of the highlighted range, and the day that starts with the tab stop. */
+    selectionStart?: Date;
+    /** Last day of the highlighted range. */
+    selectionEnd?: Date;
+    /** Days before this are not selectable. */
+    minDate?: Date | null;
+    /** Days after this are not selectable. */
+    maxDate?: Date | null;
+    /** Called to shift the displayed month by ±1 when arrow navigation runs past its edge. */
+    onNavigateMonth?: (delta: 1 | -1) => void;
+}

package/dist/types/common/datePicker/datePicker.d.ts

@@ -1,24 +1,3 @@
 import { default as React } from 'react';
-import { FormValidator } from '../../services/formValidation';
-export interface DatePickerProps {
-    className?: string;
-    selected?: Date;
-    onSelect?: (date: Date | null) => void;
-    formValidator?: FormValidator | null;
-    noInput?: boolean;
-    noHeader?: boolean;
-    isModal?: boolean;
-    isInline?: boolean;
-    onChange?: (date: Date | null) => void;
-    minDate?: Date | null;
-    maxDate?: Date | null;
-    children?: React.ReactNode;
-    showClearButton?: boolean;
-    label?: string;
-    isValid?: boolean;
-    errorMessage?: string;
-    isRequired?: boolean;
-    startDate?: Date;
-    endDate?: Date;
-}
+import { DatePickerProps } from './datePicker.types';
 export default function DatePicker(props: DatePickerProps): React.JSX.Element;

package/dist/types/common/datePicker/datePicker.types.d.ts

@@ -0,0 +1,51 @@
+import { ReactNode } from 'react';
+import { FormValidator } from '../../services/formValidation';
+export interface DatePickerProps {
+    /** Class on the root element. */
+    className?: string;
+    /** Selected date, controlled. Ignored while a `formValidator` owns the value. */
+    selected?: Date;
+    /** Floating label on the input. */
+    label?: string;
+    /**
+     * Called when a day is picked in the calendar, after `onChange`. Picking also
+     * closes the picker.
+     */
+    onSelect?: (date: Date | null) => void;
+    /**
+     * Called whenever the value changes, whether picked in the calendar or typed
+     * into the input. `null` when the field was cleared or holds no valid date.
+     */
+    onChange?: (date: Date | null) => void;
+    /** Hands the value to a validator, which then owns it. See docs/FormValidator.md. */
+    formValidator?: FormValidator | null;
+    /** Earliest selectable date. Also bounds the year dropdown. */
+    minDate?: Date | null;
+    /** Latest selectable date. Also bounds the year dropdown. */
+    maxDate?: Date | null;
+    /**
+     * Start of a highlighted range. Defaults to the selected date, so two pickers
+     * sharing a start and an end highlight the span between them.
+     */
+    startDate?: Date;
+    /** End of the highlighted range. */
+    endDate?: Date;
+    /** Render the calendar in place instead of in a popover. */
+    isInline?: boolean;
+    /** Open the calendar in a modal, with the input read-only. */
+    isModal?: boolean;
+    /** Drop the text input and show the calendar alone. */
+    noInput?: boolean;
+    /** Drop the month and year navigation above the calendar. */
+    noHeader?: boolean;
+    /** Show a button that clears the value. */
+    showClearButton?: boolean;
+    /** Rendered under the calendar, inside the popover or modal. */
+    children?: ReactNode;
+    /** Marks the field invalid. A `formValidator` decides this for itself. */
+    isValid?: boolean;
+    /** Message for the error tooltip, shown while the field is focused or hovered. */
+    errorMessage?: string;
+    /** Appends ` *` to the label. Implied by a `required` validator on `formValidator`. */
+    isRequired?: boolean;
+}

package/dist/types/common/datePicker/index.d.ts

@@ -1 +1,2 @@
 export { default } from './datePicker';
+export * from './datePicker.types';

package/dist/types/common/emptyState/emptyState.d.ts

@@ -1,3 +1,3 @@
 import { ReactElement } from 'react';
 import { EmptyStateProps } from './emptyState.types';
-export default function EmptyState({ className, icon, children, ...rest }: EmptyStateProps): ReactElement;
+export default function EmptyState({ className, icon, children, labels, ...rest }: EmptyStateProps): ReactElement;

package/dist/types/common/emptyState/emptyState.types.d.ts

@@ -1,8 +1,15 @@
 import { ReactNode } from 'react';
 import { IconContent } from '../types/icon.types';
 import { HtmlProps } from '../types/slots.types';
+/** Text EmptyState renders of its own, for translating it. */
+export interface EmptyStateLabels {
+    /** Shown when no `children` are given. */
+    empty?: string;
+}
 export interface EmptyStateProps extends HtmlProps {
     className?: string;
     icon?: IconContent;
     children?: ReactNode;
+    /** Overrides the text EmptyState renders of its own. Merged per key. */
+    labels?: EmptyStateLabels;
 }

package/dist/types/common/input/input.types.d.ts

@@ -17,6 +17,17 @@ export declare enum InputIconPosition {
 }
 export type InputSlots = 'label' | 'container' | 'input' | 'suffix' | 'upperRightLabel' | 'fieldset';
 type OverriddenInputAttributes = 'onChange' | 'onFocus' | 'onBlur' | 'onMouseEnter' | 'onMouseLeave' | 'onClick' | 'type' | 'value' | 'min' | 'max' | 'autoComplete';
+/** Text Input renders of its own, for translating it. */
+export interface InputLabels {
+    /** Clear button on a search input, read out by screen readers. */
+    clear?: string;
+    /** Reveals a password, read out by screen readers. */
+    showPassword?: string;
+    /** Hides a password again. */
+    hidePassword?: string;
+    /** Clears a search input, read out by screen readers. */
+    clearSearch?: string;
+}
 export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, OverriddenInputAttributes>, DataProps {
     onMouseEnter?: ((event: React.MouseEvent) => void) | null;
     onMouseLeave?: ((event: React.MouseEvent) => void) | null;
@@ -62,5 +73,7 @@ export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElem
     autoResize?: boolean;
     classNames?: SlotClassNames<InputSlots>;
     styles?: SlotStyles<InputSlots>;
+    /** Overrides the text Input renders of its own. Merged per key. */
+    labels?: InputLabels;
 }
 export {};

package/dist/types/common/klipyPicker/klipyPicker.d.ts

@@ -1,3 +1,3 @@
 import { ReactElement } from 'react';
 import { KlipyPickerProps } from './klipyPicker.types';
-export default function KlipyPicker({ className, token, isModal, onSelect, selected, }: KlipyPickerProps): ReactElement;
+export default function KlipyPicker({ className, token, isModal, onSelect, selected, labels, }: KlipyPickerProps): ReactElement;

package/dist/types/common/klipyPicker/klipyPicker.types.d.ts

@@ -1,8 +1,15 @@
 import { KlipyResult } from '../../services/klipy';
+/** Text KlipyPicker renders of its own, for translating it. */
+export interface KlipyPickerLabels {
+    /** Floating label on the search field. */
+    search?: string;
+}
 export interface KlipyPickerProps {
     className?: string;
     token?: string;
     isModal?: boolean;
     onSelect?: (preview: KlipyResult | null) => void | Promise<void>;
     selected?: string | null;
+    /** Overrides the text KlipyPicker renders of its own. Merged per key. */
+    labels?: KlipyPickerLabels;
 }

package/dist/types/common/modal/modal.types.d.ts

@@ -2,6 +2,11 @@ import { CSSProperties } from 'react';
 import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types';
 import { Presentation } from '../floatingMenu/floatingMenu.types';
 export type ModalSlots = 'container' | 'backdrop' | 'modal' | 'header' | 'title' | 'closeButton' | 'body';
+/** Text Modal renders of its own, for translating it. */
+export interface ModalLabels {
+    /** Close button, read out by screen readers. */
+    close?: string;
+}
 export interface ModalProps extends HtmlProps<HTMLDivElement> {
     children?: React.ReactNode;
     title?: string;
@@ -18,4 +23,6 @@ export interface ModalProps extends HtmlProps<HTMLDivElement> {
     presentation?: Presentation;
     classNames?: SlotClassNames<ModalSlots>;
     styles?: SlotStyles<ModalSlots>;
+    /** Overrides the text Modal renders of its own. Merged per key. */
+    labels?: ModalLabels;
 }

package/dist/types/common/multiSelect/multiSelect.types.d.ts

@@ -11,6 +11,17 @@ export interface MultiSelectItem {
     disabled?: boolean;
 }
 export type MultiSelectSlots = 'root' | 'label' | 'fieldset' | 'control' | 'values' | 'chip' | 'placeholder' | 'clearButton' | 'icon' | 'panel' | 'search' | 'options' | 'option' | 'optionCheck' | 'optionLabel' | 'empty';
+/** Text MultiSelect renders of its own, for translating it. */
+export interface MultiSelectLabels {
+    /** Button that empties the selection, read out by screen readers. */
+    clearSelection?: string;
+    /** Entry that creates a value from what was typed (default `Add "<value>"`). */
+    create?: (value: string) => string;
+    /** Placeholder in the search field (default `Search…`). */
+    searchPlaceholder?: string;
+    /** Shown when nothing matches the search (default `No matches`). */
+    empty?: string;
+}
 export interface MultiSelectProps extends Omit<HtmlProps<HTMLDivElement>, 'onChange' | 'value' | 'defaultValue'> {
     /** The selectable options. */
     items: MultiSelectItem[];
@@ -34,12 +45,6 @@ export interface MultiSelectProps extends Omit<HtmlProps<HTMLDivElement>, 'onCha
      * value becomes its own key, so `onChange` reports it as a plain string.
      */
     allowCustomValues?: boolean;
-    /** Label for the row that adds a typed value (default `Add "…"`). */
-    createLabel?: (value: string) => string;
-    /** Placeholder for the search box (default `'Search…'`). */
-    searchPlaceholder?: string;
-    /** Text shown in the panel when no option matches (default `'No matches'`). */
-    emptyLabel?: string;
     /** Cap the number of selections. Unselected options disable once the cap is reached. */
     maxSelected?: number;
     /** Show a button that clears the whole selection (default `true`). */
@@ -59,4 +64,6 @@ export interface MultiSelectProps extends Omit<HtmlProps<HTMLDivElement>, 'onCha
     style?: CSSProperties;
     classNames?: SlotClassNames<MultiSelectSlots>;
     styles?: SlotStyles<MultiSelectSlots>;
+    /** Overrides the text MultiSelect renders of its own. Merged per key. */
+    labels?: MultiSelectLabels;
 }

package/dist/types/common/numberInput/numberInput.types.d.ts

@@ -10,6 +10,13 @@ import { FormValidator } from '../../services/formValidation';
  * - `auto` — `split` on a coarse (touch) pointer, `stacked` otherwise.
  */
 export type NumberInputArrowsLayout = 'auto' | 'stacked' | 'split';
+/** Text NumberInput renders of its own, for translating it. */
+export interface NumberInputLabels {
+    /** The step-up button, read out by screen readers (default `Increase`). */
+    increase?: string;
+    /** The step-down button, read out by screen readers (default `Decrease`). */
+    decrease?: string;
+}
 export interface NumberInputProps extends Omit<NumericFormatProps, 'onValueChange' | 'value' | 'customInput' | 'onChange' | 'step' | 'onKeyDown' | 'min' | 'max'> {
     value?: number | string;
     onChange?: (value: number | undefined) => void;
@@ -52,10 +59,10 @@ export interface NumberInputProps extends Omit<NumericFormatProps, 'onValueChang
     /** Stepper layout. Default `'auto'`. */
     arrowsLayout?: NumberInputArrowsLayout;
     /** Accessible name for the increase button. Default `'Increase'`. */
-    increaseLabel?: string;
     /** Accessible name for the decrease button. Default `'Decrease'`. */
-    decreaseLabel?: string;
     readOnly?: boolean;
     isRequired?: boolean;
     onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    /** Overrides the text NumberInput renders of its own. Merged per key. */
+    labels?: NumberInputLabels;
 }

package/dist/types/common/otpInput/otpInput.types.d.ts

@@ -8,6 +8,13 @@ export declare enum OtpInputCharset {
     /** Letters and digits. */
     Alphanumeric = "alphanumeric"
 }
+/** Text OtpInput renders of its own, for translating it. */
+export interface OtpInputLabels {
+    /** The group of boxes, used when no `label` is given. */
+    field?: string;
+    /** One box, given its 1-based position and how many there are. */
+    digit?: (position: number, length: number) => string;
+}
 export interface OtpInputProps extends Omit<HtmlProps, 'onChange'> {
     /** Number of character boxes. Default 6. */
     length?: number;
@@ -46,4 +53,6 @@ export interface OtpInputProps extends Omit<HtmlProps, 'onChange'> {
     style?: React.CSSProperties;
     classNames?: SlotClassNames<OtpInputSlots>;
     styles?: SlotStyles<OtpInputSlots>;
+    /** Overrides the text OtpInput renders of its own. Merged per key. */
+    labels?: OtpInputLabels;
 }

package/dist/types/common/pagination/pagination.types.d.ts

@@ -2,6 +2,19 @@ import { CSSProperties } from 'react';
 import { IconContent } from '../types/icon.types';
 import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types';
 export type PaginationSlots = 'root' | 'item' | 'control' | 'ellipsis';
+/** Text Pagination renders of its own, for translating it. */
+export interface PaginationLabels {
+    /** One page button, given its number. */
+    goToPage?: (page: number) => string;
+    /** Jump to the first page. */
+    first?: string;
+    /** Step back one page. */
+    previous?: string;
+    /** Step forward one page. */
+    next?: string;
+    /** Jump to the last page. */
+    last?: string;
+}
 export interface PaginationProps extends Omit<HtmlProps<HTMLElement>, 'onChange'> {
     /** Total number of pages. Nothing renders below `1`. */
     total: number;
@@ -27,4 +40,6 @@ export interface PaginationProps extends Omit<HtmlProps<HTMLElement>, 'onChange'
     style?: CSSProperties;
     classNames?: SlotClassNames<PaginationSlots>;
     styles?: SlotStyles<PaginationSlots>;
+    /** Overrides the text Pagination renders of its own. Merged per key. */
+    labels?: PaginationLabels;
 }

package/dist/types/common/roomDrawer/roomDrawer.types.d.ts

@@ -29,6 +29,12 @@ export interface RoomDrawerChangeMeta {
 }
 /** Every string the drawer's own chrome renders, for localisation. */
 export interface RoomDrawerLabels {
+    /** The toolbar, read out by screen readers. */
+    tools?: string;
+    /** Tooltip on the storey height field. */
+    storeyHeightHint?: string;
+    /** Tooltip on an opening's sill height field. */
+    sillHeightHint?: string;
     select?: string;
     wall?: string;
     rect?: string;

package/dist/types/common/splitButton/splitButton.types.d.ts

@@ -11,6 +11,11 @@ export interface SplitButtonAction {
     icon?: IconContent;
 }
 export type SplitButtonSlots = 'root' | 'primaryButton' | 'triggerButton' | 'menu' | 'menuItem';
+/** Text SplitButton renders of its own, for translating it. */
+export interface SplitButtonLabels {
+    /** The button opening the menu, read out by screen readers. */
+    moreActions?: string;
+}
 export interface SplitButtonProps extends HtmlProps {
     children?: ReactNode;
     onClick?: (event: React.MouseEvent<HTMLButtonElement>) => Promise<void> | void;
@@ -25,4 +30,6 @@ export interface SplitButtonProps extends HtmlProps {
     style?: CSSProperties;
     classNames?: SlotClassNames<SplitButtonSlots>;
     styles?: SlotStyles<SplitButtonSlots>;
+    /** Overrides the text SplitButton renders of its own. Merged per key. */
+    labels?: SplitButtonLabels;
 }

package/dist/types/common/timer/timer.types.d.ts

@@ -22,6 +22,11 @@ export interface TimerHandle {
     /** Current remaining time in ms, read synchronously. */
     getRemainingMs: () => number;
 }
+/** Text Timer renders of its own, for translating it. */
+export interface TimerLabels {
+    /** Tooltip on the cancel button. */
+    cancel?: string;
+}
 export interface TimerProps extends HtmlProps {
     /** Starting duration in seconds. Changing this prop while mounted resets the timer to the new duration. */
     durationSeconds: number;
@@ -98,4 +103,6 @@ export interface TimerProps extends HtmlProps {
     style?: CSSProperties;
     classNames?: SlotClassNames<TimerSlots>;
     styles?: SlotStyles<TimerSlots>;
+    /** Overrides the text Timer renders of its own. Merged per key. */
+    labels?: TimerLabels;
 }

package/dist/types/common/toast/toast.d.ts

@@ -1,9 +1,11 @@
 import { default as React } from 'react';
-import { ToastItem } from './toast.types';
+import { ToastItem, ToastLabels } from './toast.types';
 interface ToastProps {
     item: ToastItem;
     isBottom: boolean;
     onDismiss: (id: string) => void;
+    /** Already resolved by the provider: defaults, provider, then this toast's own. */
+    labels: Required<ToastLabels>;
 }
-declare function Toast({ item, isBottom, onDismiss }: ToastProps): React.JSX.Element;
+declare function Toast({ item, isBottom, onDismiss, labels }: ToastProps): React.JSX.Element;
 export default Toast;