@eifi1/ui-kit 0.15.5 → 0.16.0

package/src/feedback/feedback-dialog.tsx

@@ -6,6 +6,7 @@ import { useMediaQuery } from "../hooks/use-media-query";
 import { useKitLabels } from "../i18n/kit-labels";
 import {
   DEFAULT_ATTACHMENT_ACCEPT,
+  DEFAULT_FEEDBACK_ATTACHMENT_LABELS,
   DEFAULT_MAX_ATTACHMENT_BYTES,
   FeedbackAttachmentField,
   type FeedbackAttachmentError,
@@ -28,9 +29,13 @@ export interface FeedbackAttachmentLabels {
    *  straight in. Optional — falls back to the provider's `feedbackAttachment`, then English. */
   attachmentPaste?: string;
   attachmentRemove: string;
-  /** `multiple` mode (0.15.5): the chip list's accessible name. Optional, as are the
-   *  two below — they fall back to the provider's `feedbackAttachment`, then English. */
+  /** `multiple` mode (0.15.5): the chip list's accessible name — and, in
+   *  `<FeedbackDialog attachments="multiple">`, the heading over it (0.16.0). Optional,
+   *  as are the keys below — they fall back to the provider's `feedbackAttachment`,
+   *  then English. */
   attachmentList?: string;
+  /** `multiple` mode (0.16.0): the screenshot slot's chip title, in place of its file name. */
+  attachmentScreenshot?: string;
   /** `multiple` mode: one chip's remove button, given the file's name. */
   attachmentRemoveFile?: (name: string) => string;
   /** `multiple` mode: the line shown once `max` files are attached. */
@@ -46,8 +51,9 @@ export interface FeedbackDialogLabels extends FeedbackAttachmentLabels {
   submitHint: string;
   cancel: string;
   save: string;
-  /** The heading over the attachments under `attachments="multiple"` (0.15.5), where
-   *  they are a screenshot AND photos. Optional; falls back to the provider, then English. */
+  /** @deprecated since 0.16.0 — use `attachmentList`, the one key for the heading and
+   *  the chip list it names. Still honoured: set, it wins over the provider's
+   *  `attachmentList` (but not over an `attachmentList` passed beside it). */
   attachments?: string;
 }
 
@@ -73,8 +79,10 @@ export interface FeedbackDialogTextLabels {
   submitHint: string;
   cancel: string;
   save: string;
-  /** The heading over the attachments under `attachments="multiple"` (0.15.5).
-   *  Optional, so a complete `UiKitLabels` typed before 0.15.5 still compiles. */
+  /** @deprecated since 0.16.0 — use `feedbackAttachment.attachmentList`. It and this
+   *  key were two names for one heading ("Attachments" over the chips that list names
+   *  "Attachments"), and a catalogue that translated one left the other English. Still
+   *  honoured when set: it wins over `feedbackAttachment.attachmentList`. */
   attachments?: string;
 }
 
@@ -85,7 +93,8 @@ export const DEFAULT_FEEDBACK_DIALOG_LABELS: FeedbackDialogTextLabels = {
   body: "What happened?",
   bodyOptional: "What happened? (optional)",
   attachment: "Screenshot",
-  attachments: "Attachments",
+  // No `attachments`: the multiple-mode heading is `feedbackAttachment.attachmentList`,
+  // and a default here would shadow a provider that translated only that one.
   submitHint: "Ctrl/⌘ + Enter to send",
   cancel: "Cancel",
   save: "Send",
@@ -210,17 +219,23 @@ export function FeedbackDialog(props: FeedbackDialogProps) {
   const [files, setFiles] = useState<File[]>([]);
   const isMobile = useMediaQuery(PHONE_QUERY, false);
   const labels = useKitLabels("feedbackDialog", DEFAULT_FEEDBACK_DIALOG_LABELS, labelsProp);
+  const attachmentText = useKitLabels("feedbackAttachment", DEFAULT_FEEDBACK_ATTACHMENT_LABELS, labelsProp);
+  // Under `multiple` the heading is `attachmentList` — a screenshot AND photos — which
+  // also names the chip list beneath it: one string, so the two cannot disagree. The
+  // deprecated `feedbackDialog.attachments` (prop or provider) still wins over the
+  // provider's `attachmentList`, as it did before 0.16.0; an `attachmentList` prop wins
+  // over both.
+  const listHeading =
+    labelsProp?.attachmentList ??
+    labels.attachments ??
+    attachmentText.attachmentList ??
+    DEFAULT_FEEDBACK_ATTACHMENT_LABELS.attachmentList!;
   // The attachment field resolves its own keys from `feedbackAttachment`; it gets the
   // prop's (so a caller's `attachmentAdd` still wins) plus the resolved heading.
-  // Under `multiple` the heading is `attachments` — a screenshot AND photos — unless the
-  // caller named the multiple heading themselves.
-  const attachmentLabels = {
-    ...labelsProp,
-    attachment:
-      props.attachments === "multiple"
-        ? (labels.attachments ?? DEFAULT_FEEDBACK_DIALOG_LABELS.attachments)
-        : labels.attachment,
-  };
+  const attachmentLabels =
+    props.attachments === "multiple"
+      ? { ...labelsProp, attachment: listHeading, attachmentList: listHeading }
+      : { ...labelsProp, attachment: labels.attachment };
 
   // Reset the form whenever the dialog is (re)opened — during render, on the
   // closed-to-open transition, so the old draft never paints for a frame.

package/src/i18n/locales/de.ts

@@ -21,6 +21,7 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
       attachmentPaste: "…oder einen Screenshot aus der Zwischenablage einfügen.",
       attachmentRemove: "Anhang entfernen",
       attachmentList: "Anhänge",
+      attachmentScreenshot: "Screenshot",
       attachmentRemoveFile: (name) => `${name} entfernen`,
       attachmentLimit: (max) => `Maximal ${n(max)} ${max === 1 ? "Anhang" : "Anhänge"} – zum Hinzufügen erst einen entfernen.`,
     },
@@ -31,7 +32,6 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
       body: "Was ist passiert?",
       bodyOptional: "Was ist passiert? (optional)",
       attachment: "Screenshot",
-      attachments: "Anhänge",
       submitHint: "Strg/⌘ + Enter zum Senden",
       cancel: "Abbrechen",
       save: "Senden",

package/src/i18n/locales/es.ts

@@ -22,6 +22,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       attachmentPaste: "…o pega una captura de pantalla desde el portapapeles.",
       attachmentRemove: "Quitar adjunto",
       attachmentList: "Adjuntos",
+      attachmentScreenshot: "Captura de pantalla",
       attachmentRemoveFile: (name) => `Quitar ${name}`,
       attachmentLimit: (max) => `Máximo ${n(max)} ${max === 1 ? "adjunto" : "adjuntos"}: quita uno para añadir otro.`,
     },
@@ -32,7 +33,6 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       body: "¿Qué ha pasado?",
       bodyOptional: "¿Qué ha pasado? (opcional)",
       attachment: "Captura de pantalla",
-      attachments: "Adjuntos",
       submitHint: "Ctrl/⌘ + Intro para enviar",
       cancel: "Cancelar",
       save: "Enviar",

package/src/i18n/locales/fr.ts

@@ -22,6 +22,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       attachmentPaste: "…ou collez une capture d’écran depuis le presse-papiers.",
       attachmentRemove: "Retirer la pièce jointe",
       attachmentList: "Pièces jointes",
+      attachmentScreenshot: "Capture d’écran",
       attachmentRemoveFile: (name) => `Retirer ${name}`,
       attachmentLimit: (max) => `${n(max)} ${max === 1 ? "pièce jointe" : "pièces jointes"} au maximum — retirez-en une pour en ajouter une autre.`,
     },
@@ -32,7 +33,6 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       body: "Que s’est-il passé\u202f?",
       bodyOptional: "Que s’est-il passé\u202f? (facultatif)",
       attachment: "Capture d’écran",
-      attachments: "Pièces jointes",
       submitHint: "Ctrl/⌘ + Entrée pour envoyer",
       cancel: "Annuler",
       save: "Envoyer",

package/src/i18n/locales/hu.ts

@@ -21,6 +21,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       attachmentPaste: "…vagy illesszen be egy képernyőképet a vágólapról.",
       attachmentRemove: "Melléklet eltávolítása",
       attachmentList: "Mellékletek",
+      attachmentScreenshot: "Képernyőkép",
       attachmentRemoveFile: (name) => `${name} eltávolítása`,
       attachmentLimit: (max) => `Legfeljebb ${n(max)} melléklet – egy újabbhoz távolítson el egyet.`,
     },
@@ -31,7 +32,6 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       body: "Mi történt?",
       bodyOptional: "Mi történt? (nem kötelező)",
       attachment: "Képernyőkép",
-      attachments: "Mellékletek",
       submitHint: "Ctrl/⌘ + Enter a küldéshez",
       cancel: "Mégse",
       save: "Küldés",

package/src/i18n/locales/it.ts

@@ -22,6 +22,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       attachmentPaste: "…oppure incolla uno screenshot dagli appunti.",
       attachmentRemove: "Rimuovi allegato",
       attachmentList: "Allegati",
+      attachmentScreenshot: "Screenshot",
       attachmentRemoveFile: (name) => `Rimuovi ${name}`,
       attachmentLimit: (max) => `Massimo ${n(max)} ${max === 1 ? "allegato" : "allegati"}: rimuovine uno per aggiungerne un altro.`,
     },
@@ -32,7 +33,6 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       body: "Cosa è successo?",
       bodyOptional: "Cosa è successo? (facoltativo)",
       attachment: "Screenshot",
-      attachments: "Allegati",
       submitHint: "Ctrl/⌘ + Invio per inviare",
       cancel: "Annulla",
       save: "Invia",

package/src/i18n/locales/zh.ts

@@ -21,6 +21,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       attachmentPaste: "……或从剪贴板粘贴截图。",
       attachmentRemove: "移除附件",
       attachmentList: "附件",
+      attachmentScreenshot: "截图",
       attachmentRemoveFile: (name) => `移除 ${name}`,
       attachmentLimit: (max) => `最多 ${n(max)} 个附件，请先移除一个再添加。`,
     },
@@ -31,7 +32,6 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       body: "发生了什么？",
       bodyOptional: "发生了什么？（可选）",
       attachment: "截图",
-      attachments: "附件",
       submitHint: "Ctrl/⌘ + Enter 发送",
       cancel: "取消",
       save: "发送",

package/src/lib/format.ts

@@ -365,15 +365,36 @@ export function currencyMinorDigits(currency: string | null | undefined): number
   }
 }
 
+/** The options form of {@link roundToCurrency}'s third argument. */
+export interface RoundToCurrencyOptions {
+  /** Decimals to round to, whatever the currency — the plain `digits` argument. */
+  digits?: number;
+  /**
+   * Decimals for a currency `Intl` cannot resolve — no code yet (`null`, `""`), or a
+   * malformed one ("EURO", "€"). Left out, such a value comes back unchanged, as
+   * before. Note that `Intl` resolves ANY well-formed three-letter code, a made-up
+   * "XYZ" included (to 2), so this is the case of a missing or broken code, not of a
+   * rare currency.
+   */
+  fallbackDigits?: number;
+}
+
 /**
  * `value` rounded to the currency's minor unit (or to `digits`), half away from zero,
  * in decimal arithmetic: 93.4213 CHF → 93.42, 1.005 EUR → 1.01 (`Math.round(1.005 *
  * 100)` is 100, since 1.005 is 1.00499… in binary). A non-finite value, or a currency
  * `Intl` does not know without `digits`, comes back unchanged (keksdose live #356: an
- * FX estimate set into an AmountInput showed four decimals).
+ * FX estimate set into an AmountInput showed four decimals) — unless the options form
+ * gives `fallbackDigits`: `roundToCurrency(v, code, { fallbackDigits: 2 })` rounds a
+ * figure whose currency is not chosen yet to cents rather than leaving 0.1 + 0.2 as is.
  */
-export function roundToCurrency(value: number, currency: string | null | undefined, digits?: number): number {
-  const places = digits ?? currencyMinorDigits(currency);
+export function roundToCurrency(
+  value: number,
+  currency: string | null | undefined,
+  digits?: number | RoundToCurrencyOptions,
+): number {
+  const options = typeof digits === "object" && digits !== null ? digits : { digits };
+  const places = options.digits ?? currencyMinorDigits(currency) ?? options.fallbackDigits;
   if (places === undefined || !Number.isFinite(value)) return value;
   const magnitude = Number(`${Math.round(Number(`${Math.abs(value)}e${places}`))}e-${places}`);
   return value < 0 ? -magnitude : magnitude;

package/src/rhf/line-items.tsx

@@ -23,6 +23,12 @@
  * itself — the `rules` here, or a resolver's `lines: "At least two lines"` — is the
  * list's `error`. Each cell's `render` gets `name`, the row's path
  * (`"components.2"`), to bind its field to.
+ *
+ * `summary`, `fieldLabels` and `narrowColumns` pass through to {@link LineItems}. With
+ * `fieldLabels="floating"` a cell's `fieldLabel` is the column's name; the bound
+ * fields' own `label` is a `FormLabel` ABOVE the control, so for the floating
+ * one render the kit field through `RhfField`:
+ * `render={({ field, invalid }) => <Input label={fieldLabel} aria-label={label} {...field} invalid={invalid} />}`.
  */
 import type { ReactNode } from "react";
 import {