@eifi1/ui-kit 0.15.2 → 0.15.4

package/src/i18n/kit-labels.tsx

@@ -417,8 +417,12 @@ interface KitI18n {
   locale?: string;
   weekStartsOn?: WeekDay;
   linkComponent?: KitLinkComponent;
+  chartTooltipPlacement?: ChartTooltipPlacement;
 }
 
+/** Where a chart shows the values under the pointer — see `SeriesChartTooltip.placement`. */
+export type ChartTooltipPlacement = "cursor" | "above" | "below" | "auto";
+
 /**
  * What every kit link receives: the anchor attributes the kit decided (href, class,
  * aria-current, handlers, children, ref). An app's router link maps them —
@@ -475,6 +479,13 @@ export interface UiKitProviderProps {
    * hash-router `#/path` is handed to it like `/path` (see `pickLinkRenderer`).
    */
   linkComponent?: KitLinkComponent;
+  /**
+   * Where every `SeriesChart` below shows its tooltip when it does not say so itself
+   * (`tooltip.placement`) — set once so an app's phone charts stop putting the box under
+   * the reader's finger (keksdose #359). Default: `"cursor"`, the box that follows the
+   * pointer, as before.
+   */
+  chartTooltipPlacement?: ChartTooltipPlacement;
   children: ReactNode;
 }
 
@@ -491,6 +502,7 @@ export function UiKitProvider({
   locale,
   weekStartsOn,
   linkComponent,
+  chartTooltipPlacement,
   children,
 }: UiKitProviderProps) {
   const outer = useContext(KitI18nContext);
@@ -500,8 +512,9 @@ export function UiKitProvider({
       weekStartsOn: weekStartsOn ?? outer.weekStartsOn,
       labels: mergeOverrides(outer.labels, labels),
       linkComponent: linkComponent ?? outer.linkComponent,
+      chartTooltipPlacement: chartTooltipPlacement ?? outer.chartTooltipPlacement,
     }),
-    [outer, labels, locale, weekStartsOn, linkComponent],
+    [outer, labels, locale, weekStartsOn, linkComponent, chartTooltipPlacement],
   );
   return <KitI18nContext.Provider value={value}>{children}</KitI18nContext.Provider>;
 }
@@ -589,6 +602,11 @@ export function useKitWeekStart(): WeekDay | undefined {
   return useContext(KitI18nContext).weekStartsOn;
 }
 
+/** The provider's `chartTooltipPlacement`, or `undefined` — a chart's own prop wins. */
+export function useKitChartTooltipPlacement(): ChartTooltipPlacement | undefined {
+  return useContext(KitI18nContext).chartTooltipPlacement;
+}
+
 /** {@link DEFAULT_FILE_LABELS}, but formatting in the provider's locale. */
 export function useKitFileLabels(prop?: Partial<FileLabels>): FileLabels {
   const locale = useKitLocale();

package/src/lib/format.ts

@@ -348,3 +348,33 @@ export function useKitFormat(locale?: string): KitFormat {
     [kitLocale],
   );
 }
+
+/* ── Currency minor units ──────────────────────────────────────────────────── */
+
+/**
+ * The decimals a currency is written with — its minor unit: CHF and EUR 2, JPY 0,
+ * KWD 3 — from `Intl`, or `undefined` for a code `Intl` does not accept. The rule
+ * AmountInput settles a typed figure by, for a host that needs it outside the field.
+ */
+export function currencyMinorDigits(currency: string | null | undefined): number | undefined {
+  if (!currency) return undefined;
+  try {
+    return new Intl.NumberFormat("en", { style: "currency", currency }).resolvedOptions().maximumFractionDigits;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * `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).
+ */
+export function roundToCurrency(value: number, currency: string | null | undefined, digits?: number): number {
+  const places = digits ?? currencyMinorDigits(currency);
+  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;
+}