@eifi1/ui-kit 0.9.0 → 0.11.0

package/src/i18n/defaults.ts

@@ -1,5 +1,6 @@
 import { DEFAULT_DATA_TABLE_LABELS } from "../components/data-table-labels";
 import { DEFAULT_MINI_CALENDAR_LABELS } from "../components/mini-calendar";
+import { DEFAULT_CALENDAR_HEATMAP_LABELS } from "../components/calendar-heatmap";
 import { DEFAULT_MONTH_PICKER_LABELS } from "../components/month-picker";
 import { DEFAULT_PAGE_CONTENTS_LABELS } from "../components/page-contents";
 import { DEFAULT_POPOVER_LABELS } from "../components/popover";
@@ -25,6 +26,10 @@ import { DEFAULT_CONFIRM_DIALOG_LABELS } from "../components/confirm-dialog";
 import { DEFAULT_FLOATING_PANEL_LABELS } from "../components/floating-panel";
 import { DEFAULT_FEEDBACK_ATTACHMENT_LABELS } from "../feedback/feedback-attachment";
 import { DEFAULT_COPY_BUTTON_LABELS } from "../components/copy-button";
+import { DEFAULT_BULK_ACTION_BAR_LABELS } from "../components/bulk-action-bar";
+import { DEFAULT_LIST_LABELS } from "../components/list";
+import { DEFAULT_BREADCRUMBS_LABELS } from "../components/breadcrumbs";
+import { DEFAULT_TOAST_LABELS } from "../components/toast";
 import {
   DEFAULT_APP_SHELL_LABELS,
   DEFAULT_CALCULATOR_LABELS,
@@ -52,6 +57,7 @@ export const DEFAULT_UI_KIT_LABELS: UiKitLabels = {
   common: DEFAULT_COMMON_LABELS,
   dataTable: DEFAULT_DATA_TABLE_LABELS,
   miniCalendar: DEFAULT_MINI_CALENDAR_LABELS,
+  calendarHeatmap: DEFAULT_CALENDAR_HEATMAP_LABELS,
   datePicker: DEFAULT_DATE_PICKER_LABELS,
   monthPicker: DEFAULT_MONTH_PICKER_LABELS,
   popover: DEFAULT_POPOVER_LABELS,
@@ -88,4 +94,8 @@ export const DEFAULT_UI_KIT_LABELS: UiKitLabels = {
   confirmDialog: DEFAULT_CONFIRM_DIALOG_LABELS,
   floatingPanel: DEFAULT_FLOATING_PANEL_LABELS,
   copyButton: DEFAULT_COPY_BUTTON_LABELS,
+  bulkActionBar: DEFAULT_BULK_ACTION_BAR_LABELS,
+  list: DEFAULT_LIST_LABELS,
+  breadcrumbs: DEFAULT_BREADCRUMBS_LABELS,
+  toast: DEFAULT_TOAST_LABELS,
 };

package/src/i18n/kit-labels.tsx

@@ -2,6 +2,7 @@ import { createContext, useContext, useMemo } from "react";
 import type { ReactNode } from "react";
 import type { DataTableLabels } from "../components/data-table-labels";
 import type { MiniCalendarLabels, WeekDay } from "../components/mini-calendar";
+import type { CalendarHeatmapLabels } from "../components/calendar-heatmap";
 import type { PopoverLabels } from "../components/popover";
 import type { ChipInputLabels } from "../components/chip";
 import type { FieldSyncLabels } from "../components/field-sync";
@@ -27,6 +28,10 @@ import type { FeedbackAttachmentFieldLabels } from "../feedback/feedback-attachm
 import type { ConfirmDialogLabels } from "../components/confirm-dialog";
 import type { FloatingPanelLabels } from "../components/floating-panel";
 import type { CopyButtonLabels } from "../components/copy-button";
+import type { BulkActionBarLabels } from "../components/bulk-action-bar";
+import type { ListLabels } from "../components/list";
+import type { BreadcrumbsLabels } from "../components/breadcrumbs";
+import type { ToastLabels } from "../components/toast";
 
 /**
  * EVERY string the kit renders, as one typed tree — and an optional provider that
@@ -193,6 +198,7 @@ export interface UiKitLabels {
   common: CommonLabels;
   dataTable: DataTableLabels;
   miniCalendar: MiniCalendarLabels;
+  calendarHeatmap: CalendarHeatmapLabels;
   datePicker: DatePickerLabels;
   monthPicker: MonthPickerLabels;
   popover: PopoverLabels;
@@ -229,6 +235,10 @@ export interface UiKitLabels {
   confirmDialog: ConfirmDialogLabels;
   floatingPanel: FloatingPanelLabels;
   copyButton: CopyButtonLabels;
+  bulkActionBar: BulkActionBarLabels;
+  list: ListLabels;
+  breadcrumbs: BreadcrumbsLabels;
+  toast: ToastLabels;
 }
 
 /** Any subset of the tree, one level deep — each namespace may be partial, and a

package/src/i18n/locales/de.ts

@@ -118,6 +118,14 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
       rangeSelected: (from, to) =>
         `Zeitraum ${from} bis ${to} gewählt. Wählen Sie ein Startdatum, um neu zu beginnen.`,
     },
+    calendarHeatmap: {
+      grid: "Tageswerte",
+      day: (date, value) => `${date}: ${value}`,
+      less: "Weniger",
+      more: "Mehr",
+      truncated: (count) =>
+        `Die neuesten Tage werden angezeigt; ${n(count)} ${count === 1 ? "früherer Tag wird" : "frühere Tage werden"} nicht angezeigt.`,
+    },
     datePicker: {
       apply: "Übernehmen",
       cancel: "Abbrechen",
@@ -239,6 +247,11 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
     dialogFrame: {
       close: "Schließen",
     },
+    bulkActionBar: {
+      selected: (count) => `${n(count)} ausgewählt`,
+      clear: "Auswahl aufheben",
+      cleared: "Auswahl aufgehoben",
+    },
     swipeableRow: {
       actions: "Zeilenaktionen",
     },
@@ -379,6 +392,7 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
         "Zum Zoomen ziehen: Eine annähernd quadratische Auswahl zoomt beide Achsen, eine lange, schmale nur ihre eigene. Doppelklick setzt zurück.",
       empty: "Keine Daten",
       legend: "Datenreihen",
+      points: "Diagrammwerte",
     },
     confirmDialog: {
       confirm: "Bestätigen",
@@ -386,6 +400,7 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
     },
     floatingPanel: {
       close: "Schließen",
+      badge: (count) => `${n(count)} neu`,
     },
     copyButton: {
       copy: "Kopieren",
@@ -394,6 +409,20 @@ export function uiKitLabelsDe(numberLocale = "de-DE"): UiKitLabels {
       copiedAnnouncement: "In die Zwischenablage kopiert",
       failedAnnouncement: "Kopieren in die Zwischenablage fehlgeschlagen",
     },
+    list: {
+      unread: "Ungelesen",
+      opensInNewTab: "öffnet in einem neuen Tab",
+    },
+    breadcrumbs: {
+      label: "Brotkrümelnavigation",
+      showAll: "Vollständigen Pfad anzeigen",
+    },
+    toast: {
+      close: "Benachrichtigung schließen",
+      notifications: "Benachrichtigungen",
+      undo: "Rückgängig",
+      redo: "Wiederholen",
+    },
   };
 }
 

package/src/i18n/locales/es.ts

@@ -125,6 +125,14 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       panel: "Elegir un mes",
       month: (monthYear) => monthYear,
     },
+    calendarHeatmap: {
+      grid: "Valores diarios",
+      day: (date, value) => `${date}: ${value}`,
+      less: "Menos",
+      more: "Más",
+      truncated: (count) =>
+        `Se muestran los días más recientes; ${count === 1 ? "no se muestra 1 día anterior" : `no se muestran ${n(count)} días anteriores`}.`,
+    },
     datePicker: {
       apply: "Aplicar",
       cancel: "Cancelar",
@@ -236,6 +244,11 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
     dialogFrame: {
       close: "Cerrar",
     },
+    bulkActionBar: {
+      selected: (count) => `${n(count)} ${count === 1 ? "seleccionado" : "seleccionados"}`,
+      clear: "Borrar selección",
+      cleared: "Selección borrada",
+    },
     swipeableRow: {
       actions: "Acciones de la fila",
     },
@@ -372,6 +385,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
         "Arrastra para ampliar: una selección más o menos cuadrada amplía ambos ejes; una larga y estrecha, solo el suyo. Haz doble clic para restablecer.",
       empty: "Sin datos",
       legend: "Series",
+      points: "Valores del gráfico",
     },
     confirmDialog: {
       confirm: "Confirmar",
@@ -379,6 +393,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
     },
     floatingPanel: {
       close: "Cerrar",
+      badge: (count) => `${n(count)} ${plural(count, "nuevo", "nuevos")}`,
     },
     copyButton: {
       copy: "Copiar",
@@ -387,6 +402,20 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       copiedAnnouncement: "Copiado al portapapeles",
       failedAnnouncement: "No se pudo copiar al portapapeles",
     },
+    list: {
+      unread: "No leído",
+      opensInNewTab: "se abre en una pestaña nueva",
+    },
+    breadcrumbs: {
+      label: "Ruta de navegación",
+      showAll: "Mostrar la ruta completa",
+    },
+    toast: {
+      close: "Cerrar notificación",
+      notifications: "Notificaciones",
+      undo: "Deshacer",
+      redo: "Rehacer",
+    },
   };
 }
 

package/src/i18n/locales/fr.ts

@@ -122,6 +122,14 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       rangeSelected: (from, to) =>
         `Période du ${from} au ${to} sélectionnée. Choisissez une date de début pour recommencer.`,
     },
+    calendarHeatmap: {
+      grid: "Valeurs quotidiennes",
+      day: (date, value) => `${date} : ${value}`,
+      less: "Moins",
+      more: "Plus",
+      truncated: (count) =>
+        `Affichage des jours les plus récents ; ${n(count)} ${count === 1 ? "jour antérieur n’est pas affiché" : "jours antérieurs ne sont pas affichés"}.`,
+    },
     datePicker: {
       apply: "Appliquer",
       cancel: "Annuler",
@@ -241,6 +249,11 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
     dialogFrame: {
       close: "Fermer",
     },
+    bulkActionBar: {
+      selected: (count) => `${n(count)} ${count === 1 ? "sélectionné" : "sélectionnés"}`,
+      clear: "Effacer la sélection",
+      cleared: "Sélection effacée",
+    },
     swipeableRow: {
       actions: "Actions de la ligne",
     },
@@ -385,6 +398,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
         "Faites glisser pour zoomer\u00a0: une sélection à peu près carrée zoome sur les deux axes, une sélection longue et étroite sur son seul axe. Double-cliquez pour réinitialiser.",
       empty: "Aucune donnée",
       legend: "Séries",
+      points: "Valeurs du graphique",
     },
     confirmDialog: {
       confirm: "Confirmer",
@@ -392,6 +406,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
     },
     floatingPanel: {
       close: "Fermer",
+      badge: (count) => `${n(count)} ${plural(count, "nouveau", "nouveaux")}`,
     },
     copyButton: {
       copy: "Copier",
@@ -400,6 +415,20 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       copiedAnnouncement: "Copié dans le presse-papiers",
       failedAnnouncement: "Impossible de copier dans le presse-papiers",
     },
+    list: {
+      unread: "Non lu",
+      opensInNewTab: "s’ouvre dans un nouvel onglet",
+    },
+    breadcrumbs: {
+      label: "Fil d’Ariane",
+      showAll: "Afficher le chemin complet",
+    },
+    toast: {
+      close: "Fermer la notification",
+      notifications: "Notifications",
+      undo: "Annuler",
+      redo: "Rétablir",
+    },
   };
 }
 

package/src/i18n/locales/hu.ts

@@ -121,6 +121,14 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       panel: "Hónap kiválasztása",
       month: (monthYear) => monthYear,
     },
+    calendarHeatmap: {
+      grid: "Napi értékek",
+      day: (date, value) => `${date}: ${value}`,
+      less: "Kevesebb",
+      more: "Több",
+      truncated: (count) =>
+        `A legutóbbi napok láthatók; ${n(count)} korábbi nap nem látható.`,
+    },
     datePicker: {
       apply: "Alkalmaz",
       cancel: "Mégse",
@@ -234,6 +242,11 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
     dialogFrame: {
       close: "Bezárás",
     },
+    bulkActionBar: {
+      selected: (count) => `${n(count)} kijelölve`,
+      clear: "Kijelölés törlése",
+      cleared: "Kijelölés törölve",
+    },
     swipeableRow: {
       actions: "Sorműveletek",
     },
@@ -373,6 +386,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
         "Húzással nagyíthat: a nagyjából négyzetes kijelölés mindkét tengelyt nagyítja, a hosszú, keskeny csak a saját tengelyét. Dupla kattintással visszaállíthatja.",
       empty: "Nincs adat",
       legend: "Adatsorok",
+      points: "Diagramértékek",
     },
     confirmDialog: {
       confirm: "Megerősítés",
@@ -380,6 +394,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
     },
     floatingPanel: {
       close: "Bezárás",
+      badge: (count) => `${n(count)} új`,
     },
     copyButton: {
       copy: "Másolás",
@@ -388,6 +403,20 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       copiedAnnouncement: "Vágólapra másolva",
       failedAnnouncement: "Nem sikerült a vágólapra másolni",
     },
+    list: {
+      unread: "Olvasatlan",
+      opensInNewTab: "új lapon nyílik meg",
+    },
+    breadcrumbs: {
+      label: "Morzsamenü",
+      showAll: "Teljes útvonal megjelenítése",
+    },
+    toast: {
+      close: "Értesítés bezárása",
+      notifications: "Értesítések",
+      undo: "Visszavonás",
+      redo: "Újra",
+    },
   };
 }
 

package/src/i18n/locales/it.ts

@@ -125,6 +125,14 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       panel: "Scegli un mese",
       month: (monthYear) => monthYear,
     },
+    calendarHeatmap: {
+      grid: "Valori giornalieri",
+      day: (date, value) => `${date}: ${value}`,
+      less: "Meno",
+      more: "Più",
+      truncated: (count) =>
+        `Vengono mostrati i giorni più recenti; ${count === 1 ? "1 giorno precedente non è mostrato" : `${n(count)} giorni precedenti non sono mostrati`}.`,
+    },
     datePicker: {
       apply: "Applica",
       cancel: "Annulla",
@@ -237,6 +245,11 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
     dialogFrame: {
       close: "Chiudi",
     },
+    bulkActionBar: {
+      selected: (count) => `${n(count)} ${count === 1 ? "selezionato" : "selezionati"}`,
+      clear: "Annulla selezione",
+      cleared: "Selezione annullata",
+    },
     swipeableRow: {
       actions: "Azioni della riga",
     },
@@ -374,6 +387,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
         "Trascina per ingrandire: una selezione più o meno quadrata ingrandisce entrambi gli assi, una lunga e sottile solo il proprio. Fai doppio clic per ripristinare.",
       empty: "Nessun dato",
       legend: "Serie",
+      points: "Valori del grafico",
     },
     confirmDialog: {
       confirm: "Conferma",
@@ -381,6 +395,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
     },
     floatingPanel: {
       close: "Chiudi",
+      badge: (count) => `${n(count)} ${plural(count, "nuovo", "nuovi")}`,
     },
     copyButton: {
       copy: "Copia",
@@ -389,6 +404,20 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       copiedAnnouncement: "Copiato negli appunti",
       failedAnnouncement: "Impossibile copiare negli appunti",
     },
+    list: {
+      unread: "Non letto",
+      opensInNewTab: "si apre in una nuova scheda",
+    },
+    breadcrumbs: {
+      label: "Percorso di navigazione",
+      showAll: "Mostra percorso completo",
+    },
+    toast: {
+      close: "Chiudi notifica",
+      notifications: "Notifiche",
+      undo: "Annulla",
+      redo: "Ripeti",
+    },
   };
 }
 

package/src/i18n/locales/zh.ts

@@ -120,6 +120,14 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       panel: "选择月份",
       month: (monthYear) => monthYear,
     },
+    calendarHeatmap: {
+      grid: "每日数值",
+      day: (date, value) => `${date}：${value}`,
+      less: "较少",
+      more: "较多",
+      truncated: (count) =>
+        `仅显示最近的日期；另有 ${n(count)} 天未显示。`,
+    },
     datePicker: {
       apply: "应用",
       cancel: "取消",
@@ -231,6 +239,11 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
     dialogFrame: {
       close: "关闭",
     },
+    bulkActionBar: {
+      selected: (count) => `已选择 ${n(count)} 项`,
+      clear: "清除选择",
+      cleared: "已清除选择",
+    },
     swipeableRow: {
       actions: "行操作",
     },
@@ -362,6 +375,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
         "拖动以缩放：近似正方形的选区同时缩放两条坐标轴，细长的选区只缩放其所沿的那条轴。双击可重置。",
       empty: "无数据",
       legend: "数据系列",
+      points: "图表数值",
     },
     confirmDialog: {
       confirm: "确认",
@@ -369,6 +383,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
     },
     floatingPanel: {
       close: "关闭",
+      badge: (count) => `${n(count)} 条新内容`,
     },
     copyButton: {
       copy: "复制",
@@ -377,6 +392,20 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       copiedAnnouncement: "已复制到剪贴板",
       failedAnnouncement: "无法复制到剪贴板",
     },
+    list: {
+      unread: "未读",
+      opensInNewTab: "在新标签页中打开",
+    },
+    breadcrumbs: {
+      label: "面包屑导航",
+      showAll: "显示完整路径",
+    },
+    toast: {
+      close: "关闭通知",
+      notifications: "通知",
+      undo: "撤销",
+      redo: "重做",
+    },
   };
 }
 

package/src/index.ts

@@ -56,6 +56,8 @@ export * from "./theme/palette-store";
 
 // ── components ───────────────────────────────────────────────────────────────
 export * from "./components/ui";
+// The label-ABOVE field group (label, hint, error, required), inside wizards or out.
+export * from "./components/field";
 export * from "./components/search-field";
 export * from "./components/dropdown";
 export * from "./components/popover";
@@ -96,6 +98,8 @@ export * from "./components/danger-confirm";
 export * from "./components/confirm-dialog";
 // A non-modal corner panel and its round trigger (keksdose's assistant launcher).
 export * from "./components/floating-panel";
+// The count / clear / actions bar a selection brings up (keksdose's three copies).
+export * from "./components/bulk-action-bar";
 export * from "./components/swatch-picker";
 export * from "./components/icon-picker";
 export * from "./components/choice-card";
@@ -124,6 +128,8 @@ export * from "./components/series-chart-labels";
 export * from "./components/account-settings";
 export * from "./components/alert-banner";
 export * from "./components/toggle-group";
+// A wrapping set of links/buttons marked `aria-current` — Tabs-like looks, not tabs.
+export * from "./components/nav-pills";
 // A pill carrying one VALUE — inert, a link, or a toggle, depending on which prop it is
 // given — and the list field built from it. Distinct from Button on purpose: a row of
 // buttons reads as "choose an action", a row of chips as "here are the things".
@@ -135,6 +141,7 @@ export * from "./components/full-bleed-dialog";
 export * from "./components/grouped-picker";
 export * from "./components/file-dropzone";
 export * from "./components/mini-calendar";
+export * from "./components/calendar-heatmap";
 export * from "./components/date-picker";
 export * from "./components/tree-view";
 export * from "./components/chart";
@@ -151,6 +158,30 @@ export * from "./components/separator";
 // Named: scroll-area.tsx also holds the overflow hook and scrollbar class Table shares.
 export { ScrollArea } from "./components/scroll-area";
 export type { ScrollAreaProps } from "./components/scroll-area";
+// 0.10.0 rows, menu rows, text primitives and page chrome the apps drew by hand.
+export * from "./components/list";
+export * from "./components/menu-item";
+export * from "./components/text";
+export * from "./components/status-dot";
+export * from "./components/page-header";
+export * from "./components/breadcrumbs";
+// The toast layer over sonner (an OPTIONAL peer, loaded lazily): `toast` mirrors sonner's
+// API so apps migrate by swapping the import; `<Toaster>` carries the placement, theme,
+// tones and z-index both apps had wired by hand.
+export { toast, Toaster, DEFAULT_TOAST_LABELS, TOAST_ACTION_DURATION } from "./components/toast";
+export type {
+  ToastId,
+  ToastAction,
+  ToastOptions,
+  ToastPromiseOptions,
+  ToastUndoOptions,
+  ToastRedoOptions,
+  ToastLabels,
+  ToastPosition,
+  ToastSwipeDirection,
+  ToasterOffset,
+  ToasterProps,
+} from "./components/toast";
 
 // ── data-table suite ─────────────────────────────────────────────────────────
 export * from "./components/data-table-labels";

package/src/lib/clipping.ts

@@ -0,0 +1,34 @@
+/** Internal (not exported from the package): the Tooltip's auto-portal check. The
+ *  attribute name itself IS exported, as `CLIPS_ATTRIBUTE` from the tooltip module. */
+
+/**
+ * The explicit "this element clips or scrolls" marker. A container carrying it counts
+ * as clipping whatever its computed `overflow` says.
+ *
+ * Why a marker as well as the computed style: the kit's containers get their
+ * `overflow` from Tailwind classes, and jsdom computes no stylesheet — so under test
+ * every scroller reads `overflow: visible`, the Tooltip stays in place, and its always-
+ * mounted bubble shows up in the cell's text (keksdose 0.10: "CheckingChecking"). The
+ * browser and the test then disagreed about where the bubble lives, and apps pinned
+ * `portal` on every tooltip in a table to make them agree. The kit's own scrollers
+ * (DataTable's body, Table's wrapper) carry the marker, so the answer is the same in
+ * both; an app marks its own with `{ [CLIPS_ATTRIBUTE]: "" }` or a literal `data-clips`.
+ */
+export const CLIPS_ATTRIBUTE = "data-clips";
+
+/** Whether anything between `el` and `<body>` clips or scrolls its content — the
+ *  containers an absolutely positioned bubble would be cut off by, or would widen.
+ *  Either the computed `overflow` says so or the element carries
+ *  {@link CLIPS_ATTRIBUTE}. `<body>` and `<html>` are not counted: their `overflow`
+ *  belongs to the viewport (a dialog's scroll lock sets it), and the viewport clips a
+ *  portalled bubble just the same. */
+export function hasClippingAncestor(el: Element | null): boolean {
+  if (typeof window === "undefined" || !el) return false;
+  for (let node = el.parentElement; node; node = node.parentElement) {
+    if (node === document.body || node === document.documentElement) return false;
+    if (node.hasAttribute(CLIPS_ATTRIBUTE)) return true;
+    const style = window.getComputedStyle(node);
+    if (style.overflowX !== "visible" || style.overflowY !== "visible") return true;
+  }
+  return false;
+}

package/src/lib/dates.ts

@@ -149,6 +149,43 @@ export function addDaysIso(iso: string, days: number): string {
   return toLocalIso(d);
 }
 
+/**
+ * `d` moved by whole months, keeping the day of the month where the target has one.
+ * `setMonth` alone ROLLS OVER — 31 January + 1 month is 3 March — which would skip
+ * February entirely for anyone paging through the year with PageDown. Returns a new
+ * Date; `d` is not touched.
+ */
+export function addMonthsClamped(d: Date, months: number): Date {
+  const day = d.getDate();
+  const out = new Date(d.getFullYear(), d.getMonth() + months, 1);
+  const lastOfTarget = new Date(out.getFullYear(), out.getMonth() + 1, 0).getDate();
+  out.setDate(Math.min(day, lastOfTarget));
+  return out;
+}
+
+/**
+ * The first day of the week in `locale`, as a `Date#getDay` index (0 = Sunday).
+ *
+ * `Intl.Locale#getWeekInfo()` is the standard spelling; V8 shipped it first as the
+ * `weekInfo` accessor, and Firefox has neither yet — hence both reads and a Monday
+ * fallback, which is ISO 8601. Its `firstDay` counts 1 = Monday … 7 = Sunday, so `% 7`
+ * maps it onto `getDay`. `undefined` asks for the runtime's default locale.
+ */
+export function localeWeekStart(locale: string | undefined): 0 | 1 | 2 | 3 | 4 | 5 | 6 {
+  try {
+    const tag = locale ?? new Intl.DateTimeFormat().resolvedOptions().locale;
+    const loc = new Intl.Locale(tag) as Intl.Locale & {
+      getWeekInfo?: () => { firstDay: number };
+      weekInfo?: { firstDay: number };
+    };
+    const firstDay = (loc.getWeekInfo?.() ?? loc.weekInfo)?.firstDay;
+    if (typeof firstDay === "number") return (firstDay % 7) as 0 | 1 | 2 | 3 | 4 | 5 | 6;
+  } catch {
+    // A malformed tag throws from `Intl.Locale`; a calendar still has to render.
+  }
+  return 1;
+}
+
 /** Whether two Dates fall on the same local calendar day. */
 export function sameYmd(a: Date, b: Date): boolean {
   return (