@eifi1/ui-kit 0.54.0 → 0.56.0

package/src/components/floating-panel.tsx

@@ -1,828 +0,0 @@
-import { useCallback, useEffect, useId, useLayoutEffect, useRef, useState } from "react";
-import { createPortal } from "react-dom";
-import type {
-  AnchorHTMLAttributes,
-  ButtonHTMLAttributes,
-  CSSProperties,
-  HTMLAttributes,
-  KeyboardEvent,
-  MouseEvent,
-  ReactElement,
-  ReactNode,
-  Ref,
-} from "react";
-import { X } from "lucide-react";
-
-import { cn } from "../lib/cn";
-import { FOCUS_RING } from "./focus-ring";
-import { dirOf, type Direction } from "../lib/direction";
-import { registerFloating } from "../lib/floating-stack";
-import { useFloatClearance } from "../lib/float-clearance";
-import { isComposing } from "../lib/ime";
-import { takeEscape, useOverlayOpen } from "../hooks/use-dismiss";
-import { useKitLabels, useKitLink } from "../i18n/kit-labels";
-import { assignRef } from "./field-parts";
-import { pickLinkRenderer } from "./text-link";
-import { Tooltip, type TooltipSide } from "./tooltip";
-import { DEFAULT_FLOATING_PANEL_LABELS } from "./floating-panel-labels";
-
-export interface FloatingPanelLabels {
-  /** Accessible name of the panel header's X. */
-  close: string;
-  /**
-   * What a {@link FloatingAction}'s count badge adds to its accessible name ("3 new"),
-   * read after the label: "Invoices, 3 new". The dot itself is hidden from a reader —
-   * a bare "3" read out of context says nothing about what is counted.
-   */
-  badge: (count: number) => string;
-}
-
-// Defined in ./floating-panel-labels, which holds no component code (0.34, KS U8).
-export { DEFAULT_FLOATING_PANEL_LABELS };
-
-/** A LOGICAL corner: `bottom-end` is bottom-right in LTR and bottom-left in RTL. */
-export type FloatingCorner = "bottom-end" | "bottom-start";
-
-/**
- * How far off the bottom edge anything floating here sits: clear of `AppShell`'s phone
- * nav (`--app-nav-h`, `0px` above `md` where the nav is not rendered) and of the home
- * indicator, whichever reaches higher — the nav does not pad itself for the inset, so
- * with no nav on screen the inset is all there is to clear. `max`, not a sum: where the
- * nav does cover the inset, adding both would float the button a nav-height too high.
- */
-const BOTTOM_CLEARANCE = "max(var(--app-nav-h, 0px), env(safe-area-inset-bottom, 0px))";
-/** The side gutter, widened for a landscape notch. Both insets, because a logical
- *  side has no one physical inset to name. */
-const SIDE_GUTTER = "max(1rem, env(safe-area-inset-left, 0px), env(safe-area-inset-right, 0px))";
-
-function cornerStyle(corner: FloatingCorner, lift: string): CSSProperties {
-  return {
-    bottom: `calc(${BOTTOM_CLEARANCE} + ${lift})`,
-    // Logical properties, so the corner follows the reading direction with no JS. The
-    // portal carries the `dir` across (see `usePortalDir`).
-    [corner === "bottom-start" ? "insetInlineStart" : "insetInlineEnd"]: SIDE_GUTTER,
-  };
-}
-
-/**
- * The reading direction where the component was RENDERED, for its portalled root: a
- * portal to `<body>` leaves the subtree whose `dir` it inherited, and a logical
- * `inset-inline-end` resolves against the portal's own direction. Read off a hidden
- * inline marker in a layout effect, so the first painted frame already has it.
- */
-function usePortalDir(): [Ref<HTMLSpanElement>, Direction | undefined] {
-  const marker = useRef<HTMLSpanElement>(null);
-  const [dir, setDir] = useState<Direction | undefined>(undefined);
-  useLayoutEffect(() => {
-    setDir(dirOf(marker.current));
-  }, []);
-  return [marker, dir];
-}
-
-export interface FloatingActionButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
-  /** The accessible name — the button shows only its icon. */
-  label: string;
-  icon: ReactNode;
-  /** Default `bottom-end`. */
-  corner?: FloatingCorner;
-  /**
-   * Distance above the nav / home indicator, as a CSS length. Default `1rem`. Raise it
-   * to stack above another floating control in the same corner — keksdose's assistant
-   * clears the transactions page's own action group this way (`calc(1rem + 4rem)`).
-   */
-  offset?: string;
-  /**
-   * Whether the button carries the browser's own tooltip (`title`, the `label` unless a
-   * `title` is passed). Default `true`, so an icon-only button keeps a hover hint for a
-   * mouse user with no other way to learn what it is. `false` renders no `title` at all:
-   * keksdose has ONE tooltip, the kit's `Tooltip` (dev#523), and its source scan fails a
-   * native `title=` anywhere — so a flag, not `title=""`, which the scan would still
-   * see. An empty `title` renders no attribute either, for the caller who has no scan.
-   *
-   * Not flipped to off by default: a FAB wrapped in nothing would lose the only hover
-   * hint it has, silently, in every app already on it. And the kit cannot wrap itself
-   * in its `Tooltip` — the bubble's anchor is a `relative inline-flex` span, and the
-   * button is `fixed` and portalled — so the one-tooltip caller wraps it.
-   */
-  nativeTitle?: boolean;
-  /**
-   * Make it a toggle. `true`/`false` set `aria-pressed` and swap the solid brand disc for
-   * a surface disc — the glyph in brand on the quiet brand fill when on, the secondary
-   * text colour when off — the "on" look of `IconButton`'s `pressed` and of a selected
-   * Chip. Left out, it is the ordinary action FAB. For keksdose's corner filter toggles
-   * (feedback-page's "awaiting only", the /transactions pending and upcoming toggles),
-   * which paint `text-[var(--brand)]` on a surface button by hand. Keep `label` the same
-   * in both states; `aria-pressed` already says which one it is in.
-   */
-  pressed?: boolean;
-  /**
-   * Show `label` beside the icon: the EXTENDED FAB, a pill rather than a disc. For a
-   * corner control whose words are the point — kastlan's offline indicator
-   * (shared/offline/offline-indicator.tsx:39) is a pill saying "Offline — 2 photo(s)
-   * queued" / "Syncing…", hand-placed at `fixed bottom-4 left-4`, i.e. over the
-   * bottom nav and on the wrong side in RTL. Same height as the disc (3rem), so a
-   * {@link FloatingPanel} card above it still clears it.
-   */
-  extended?: boolean;
-  /**
-   * Announce `label` whenever it changes, through a polite `role="status"` region — for
-   * an extended FAB that REPORTS something (kastlan's offline/sync state), where a
-   * sighted user sees the words change and a screen reader user otherwise hears
-   * nothing until they happen to land on the button.
-   *
-   * ⚠️ A live region announces changes, not its own arrival: a FAB that mounts already
-   * saying "Offline" says it to nobody. Keep it mounted and pass `hidden` while there
-   * is nothing to report (kastlan returns `null` when online and idle); the region
-   * stays in the page, and the first real status is heard.
-   */
-  live?: boolean;
-  /**
-   * `accent` (default): the solid brand disc of a page's main action, as Button's
-   * `accent`. `surface`: the page's surface with a hairline border — for a FAB that is a
-   * status rather than a call to action, as kastlan's offline pill is (a brand pill would
-   * shout "press me" at a user who is merely offline). Ignored while `pressed` is set; a
-   * toggle has its own two looks.
-   */
-  variant?: "accent" | "surface";
-  /**
-   * Hover and focus label in the kit {@link Tooltip}, instead of the native `title` —
-   * keksdose has ONE tooltip (dev#523) and wrapped its assistant launcher by hand,
-   * which cannot work: the tooltip's anchor is a `relative inline-flex` span, and this
-   * button is `fixed` and portalled. With `tooltip` the FAB positions a fixed wrapper
-   * instead and the button sits in the tooltip inside it. `true` shows the `label`;
-   * any other content shows that. Implies no native `title` (whatever `nativeTitle`
-   * says): one hover hint, not two. `style` stays on the button; the corner and
-   * `offset` move to the wrapper.
-   */
-  tooltip?: ReactNode;
-  /** Where the {@link tooltip} opens. Default `top`; the bubble is portalled and kept on
-   *  screen, so a corner button's label is not pushed off the edge. */
-  tooltipSide?: TooltipSide;
-  /**
-   * 0.49 KIT-11: step aside (as `hidden` does: off screen, the room kept) while a dialog,
-   * a sheet, a popover, a hover menu or a list is open, instead of floating over it or
-   * beside it. Default `true`; `false` keeps it on screen. A tooltip does not count.
-   */
-  hideWhenOverlay?: boolean;
-  ref?: Ref<HTMLButtonElement>;
-}
-
-/**
- * A round, icon-only button pinned to a corner of the viewport — the trigger of a
- * {@link FloatingPanel}, and usable alone for a page's one primary action.
- *
- * keksdose hand-placed each of its floating controls: the assistant launcher at
- * `fixed bottom-36 right-4 md:bottom-6`, the feedback page's and the transactions
- * page's action groups at `right-4 bottom-20`. Every one of those numbers is a guess
- * at the phone nav's height plus whatever else floats there (Keksdose live #314 found
- * out what such a guess is worth for a footer), `right` rather than `end` puts it over
- * the page's leading edge in RTL, and none allows for the home indicator. Here the
- * base is `--app-nav-h` and the safe-area inset, the corner is logical, and
- * {@link FloatingActionButtonProps.offset} is the one number left to the caller — the
- * height of whatever else it has to clear, not the nav's.
- *
- * Portalled, because `position: fixed` inside any transformed ancestor (an animated
- * page transition) is fixed to that ancestor, not to the screen.
- *
- * While mounted it reports its box (`lib/floating-stack.ts`), so `ServerWakeNotice`
- * stacks above it rather than over it.
- *
- * 0.48: while mounted, `hidden` or not, it also publishes the room it takes above the
- * nav (`offset` + 3rem + a 0.5rem gap) as `--app-float-clearance` on `<html>` (the
- * largest of several wins), and `AppShell` pads its `<main>` past it on a phone, so the
- * page's last row no longer ends under the button (keksdose dev#612).
- */
-export function FloatingActionButton({
-  label,
-  icon,
-  corner = "bottom-end",
-  offset = "1rem",
-  nativeTitle = true,
-  pressed,
-  extended = false,
-  live = false,
-  variant = "accent",
-  tooltip,
-  tooltipSide = "top",
-  hideWhenOverlay = true,
-  className,
-  style,
-  type = "button",
-  title,
-  hidden: hiddenProp,
-  ref,
-  ...rest
-}: FloatingActionButtonProps) {
-  const overlay = useOverlayOpen(hideWhenOverlay);
-  const hidden = hiddenProp || overlay || undefined;
-  const [marker, dir] = usePortalDir();
-  const toggle = pressed !== undefined;
-  const tip = tooltip === true ? label : tooltip === false || tooltip === "" ? undefined : tooltip;
-  const wrapped = tip !== undefined && tip !== null;
-  // The fixed element — the button, or the wrapper when there is a tooltip.
-  const [fixed, setFixed] = useState<HTMLElement | null>(null);
-  useEffect(() => (fixed ? registerFloating(fixed) : undefined), [fixed]);
-  // The room it takes above the nav, for AppShell's <main> to pad past (keksdose
-  // dev#612). Hidden too: the room is the launcher's while it is mounted, so the page
-  // does not change length under the reader as it hides and shows.
-  useFloatClearance(offset);
-  const buttonRef = useCallback(
-    (node: HTMLButtonElement | null) => {
-      assignRef(ref, node);
-      if (!wrapped) setFixed(node);
-    },
-    [ref, wrapped],
-  );
-  // An empty title is "no tooltip", not an attribute with nothing in it. The kit
-  // tooltip replaces it outright.
-  const nativeTip = !wrapped && nativeTitle && title !== "" ? (title ?? label) : undefined;
-  const button = (
-    <button
-      {...rest}
-      hidden={wrapped ? undefined : hidden}
-      ref={buttonRef}
-      type={type}
-      dir={dir}
-      aria-label={label}
-      aria-pressed={pressed ?? rest["aria-pressed"]}
-      title={nativeTip}
-      style={wrapped ? style : { ...cornerStyle(corner, offset), ...style }}
-      className={cn(
-        // Wrapped, the wrapper is the fixed thing and the button sits in it.
-        !wrapped && "fixed z-40",
-        "inline-flex items-center justify-center rounded-full",
-        extended ? "h-12 gap-2 px-4 text-sm font-medium [&_svg]:size-5" : "size-12 [&_svg]:size-6",
-        "shadow-lg transition-colors disabled:cursor-default",
-        !toggle && variant === "accent" && "bg-brand text-brand-contrast hover:bg-brand-hover",
-        !toggle &&
-          variant === "surface" &&
-          "border border-subtle bg-surface text-primary hover:bg-hover disabled:hover:bg-surface",
-        // A toggle sits on the page's surface — a solid brand disc would read as
-        // "on" in both states — and says "on" in the brand family.
-        toggle && "border border-subtle",
-        pressed === false && "bg-surface text-secondary hover:bg-hover hover:text-primary",
-        pressed === true && "border-brand bg-brand-soft text-brand hover:bg-brand-soft-hover hover:text-brand-muted",
-        "outline-none focus-visible:ring-offset-2",
-        FOCUS_RING,
-        className,
-      )}
-    >
-      {icon}
-      {/* Visible words, not the name: `aria-label` already is the name, and the
-                span would only repeat it. */}
-      {extended && (
-        <span aria-hidden className="whitespace-nowrap">
-          {label}
-        </span>
-      )}
-    </button>
-  );
-  return (
-    <>
-      <span ref={marker} hidden />
-      {typeof document !== "undefined" &&
-        createPortal(
-          <>
-            {wrapped ? (
-              <div
-                ref={setFixed}
-                dir={dir}
-                hidden={hidden}
-                style={cornerStyle(corner, offset)}
-                className="fixed z-40 inline-flex"
-              >
-                <Tooltip label={tip} side={tooltipSide} portal>
-                  {/* A fragment when the bubble says the name again, so the tooltip
-                      does not describe the button with its own label — a reader would
-                      hear it twice. Other text is a real description. */}
-                  {tip === label ? <>{button}</> : button}
-                </Tooltip>
-              </div>
-            ) : (
-              button
-            )}
-            {live && (
-              <span role="status" className="sr-only">
-                {label}
-              </span>
-            )}
-          </>,
-          document.body,
-        )}
-    </>
-  );
-}
-
-export interface FloatingPanelProps {
-  /** The panel's heading, and its accessible name. */
-  title: ReactNode;
-  /** The trigger's accessible name ("Assistant", "Send feedback"). */
-  fabLabel: string;
-  fabIcon: ReactNode;
-  /** Controlled open state. Leave it out to let the panel own it. */
-  open?: boolean;
-  /** Uncontrolled initial state. Default closed. */
-  defaultOpen?: boolean;
-  /** Every request to open or close — the FAB, the X, Escape. */
-  onOpenChange?: (open: boolean) => void;
-  /** Default `bottom-end`. */
-  corner?: FloatingCorner;
-  /** The FAB's distance above the nav — see {@link FloatingActionButtonProps.offset}.
-   *  From `md` up the card sits above the FAB, so it moves with it. */
-  offset?: string;
-  /** The FAB's native `title` — see {@link FloatingActionButtonProps.nativeTitle}.
-   *  `false` for keksdose's assistant launcher, under its one-tooltip rule (dev#523). */
-  fabNativeTitle?: boolean;
-  /** The FAB's kit tooltip — see {@link FloatingActionButtonProps.tooltip}. `true` for
-   *  keksdose's assistant launcher, which wanted the kit bubble and had no way to
-   *  put one on a fixed, portalled button (dev#523). */
-  fabTooltip?: ReactNode;
-  /** Default: `floatingPanel.close` from the {@link UiKitProvider}, else "Close". */
-  closeLabel?: string;
-  /**
-   * Where focus goes on open. Default the panel itself, so a phone's keyboard does not
-   * rise over the sheet before the user has asked to type; pass the chat field for a
-   * panel whose one job is typing.
-   */
-  initialFocus?: () => HTMLElement | null;
-  /** Extra classes for the panel. */
-  className?: string;
-  /** Extra classes for the scrolling body. */
-  bodyClassName?: string;
-  /**
-   * 0.48: take the FAB and the panel off screen while keeping both mounted — the open
-   * state and the bottom room (`--app-float-clearance`) stay, and an open panel is back
-   * when this turns `false`. keksdose's assistant launcher steps aside while an editor
-   * or a modal covers its corner (dev#612); unmounting it instead would give the room
-   * back and shorten the page under the reader's thumb.
-   */
-  hidden?: boolean;
-  /**
-   * 0.49 KIT-11: the FAB steps aside while a dialog, a sheet, a popover, a hover menu or
-   * a list is open elsewhere (see {@link FloatingActionButtonProps.hideWhenOverlay}).
-   * Default `true`. An OPEN panel stays: what opens from inside it (a select, a date
-   * picker) is its own content.
-   */
-  hideWhenOverlay?: boolean;
-  children: ReactNode;
-}
-
-/**
- * A docked, NON-MODAL panel in a corner of the screen, opened by a
- * {@link FloatingActionButton} — keksdose's assistant launcher and its feedback page,
- * which each built one.
- *
- * ## Not a Modal
- *
- * The page stays usable while it is open: that is the point of an assistant beside the
- * data it is asked about. So there is no backdrop, no scroll lock, no `aria-modal` and
- * no focus trap — Tab walks out of the panel into the page and back, and a click on the
- * page does not close it. It is `role="dialog"` without `aria-modal`, which is what
- * ARIA calls a non-modal dialog, named by its heading.
- *
- * What it keeps from a dialog is the focus HANDOFF: opening moves focus into it (a
- * keyboard user who pressed the FAB should not have to hunt for what appeared), and
- * closing gives it back to the FAB — but only when focus was in the panel, so a panel
- * closed from the page (a controlled owner) never pulls focus out of the field the
- * user is typing in. Escape closes it while focus is inside, and only then: on the
- * panel element, not the document, so Escape in the page keeps meaning whatever the
- * page means by it. A layer of the kit's Escape stack open over it — a tooltip, a list —
- * is handed the key first.
- *
- * ## Layout
- *
- * From `md` up, a card above the FAB in its corner. Below `md`, a full-width sheet
- * docked to the bottom, sitting ON the `AppShell` bottom nav (`--app-nav-h`) and
- * clear of the home indicator. Pure CSS — no width is measured in JavaScript.
- *
- * The FAB carries `aria-expanded` and, while the panel exists, `aria-controls`. The
- * panel unmounts when closed; an app that must keep a draft across a close keeps it in
- * its own state, where it also survives a reload.
- */
-export function FloatingPanel({
-  title,
-  fabLabel,
-  fabIcon,
-  open: openProp,
-  defaultOpen = false,
-  onOpenChange,
-  corner = "bottom-end",
-  offset = "1rem",
-  fabNativeTitle,
-  fabTooltip,
-  closeLabel,
-  initialFocus,
-  className,
-  bodyClassName,
-  hidden: hiddenProp = false,
-  hideWhenOverlay = true,
-  children,
-}: FloatingPanelProps) {
-  const labels = useKitLabels(
-    "floatingPanel",
-    DEFAULT_FLOATING_PANEL_LABELS,
-    closeLabel === undefined ? undefined : { close: closeLabel },
-  );
-  const [ownOpen, setOwnOpen] = useState(defaultOpen);
-  const open = openProp ?? ownOpen;
-  const overlay = useOverlayOpen(hideWhenOverlay && !open);
-  const hidden = hiddenProp || overlay;
-  const setOpen = (next: boolean) => {
-    if (openProp === undefined) setOwnOpen(next);
-    onOpenChange?.(next);
-  };
-
-  const uid = useId();
-  const panelId = `${uid}-panel`;
-  const titleId = `${uid}-title`;
-  const fabRef = useRef<HTMLButtonElement>(null);
-  const panelRef = useRef<HTMLDivElement>(null);
-  const [marker, dir] = usePortalDir();
-
-  const initialFocusRef = useRef(initialFocus);
-  useEffect(() => {
-    initialFocusRef.current = initialFocus;
-  });
-
-  // Focus follows the open/closed TRANSITION, never the mount: a panel that renders
-  // open (`defaultOpen`, a restored route) does not take the page's focus by existing.
-  const wasOpen = useRef(open);
-  // Whether focus was inside the panel when it last changed — read at close time, when
-  // the panel (and whatever had focus in it) is already gone.
-  const focusInside = useRef(false);
-  useEffect(() => {
-    const changed = wasOpen.current !== open;
-    wasOpen.current = open;
-    if (!changed) return;
-    if (open) {
-      (initialFocusRef.current?.() ?? panelRef.current)?.focus();
-      return;
-    }
-    const active = document.activeElement;
-    const lost = active === null || active === document.body;
-    if (focusInside.current || lost) fabRef.current?.focus();
-    focusInside.current = false;
-  }, [open]);
-
-  const onPanelKeyDown = (e: KeyboardEvent<HTMLDivElement>) => {
-    if (e.key !== "Escape") return;
-    // The kit's one Escape stack first (round 0.34 Wave 2, DUP-1): a layer open above the
-    // panel without focus — a tooltip, the numpad, a hover menu — is the topmost thing on
-    // screen and is handed the key. This took it for itself and stopped it, so the
-    // tooltip never heard it and one press closed the whole panel instead.
-    if (takeEscape(e)) return;
-    // Not a layer itself: it answers only while focus is inside it, and a layer would
-    // also be handed an Escape pressed in the page. Kept by a child's claim (ChipInput
-    // clearing its draft, `claimEscape`), and by an IME composition, as a layer is.
-    if (e.defaultPrevented || isComposing(e)) return;
-    // Stopped here, so an overlay underneath with a document-level Escape listener does
-    // not close too — the innermost thing that has focus is the one that closes.
-    e.stopPropagation();
-    focusInside.current = true;
-    setOpen(false);
-  };
-
-  return (
-    <>
-      <span ref={marker} hidden />
-      <FloatingActionButton
-        ref={fabRef}
-        label={fabLabel}
-        icon={fabIcon}
-        corner={corner}
-        offset={offset}
-        nativeTitle={fabNativeTitle}
-        tooltip={fabTooltip}
-        hidden={hidden || undefined}
-        hideWhenOverlay={false}
-        aria-expanded={open}
-        aria-controls={open && !hidden ? panelId : undefined}
-        onClick={() => {
-          // A press ON the FAB closing the panel: the FAB keeps focus by being clicked,
-          // nothing to hand back.
-          focusInside.current = false;
-          setOpen(!open);
-        }}
-      />
-      {open &&
-        !hidden &&
-        typeof document !== "undefined" &&
-        createPortal(
-          // A container for Escape bubbling up from anything inside it, as a dialog is.
-          // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions
-          <div
-            ref={panelRef}
-            id={panelId}
-            role="dialog"
-            aria-labelledby={titleId}
-            tabIndex={-1}
-            dir={dir}
-            data-corner={corner}
-            onKeyDown={onPanelKeyDown}
-            onFocus={() => {
-              focusInside.current = true;
-            }}
-            onBlur={(e) => {
-              if (!e.currentTarget.contains(e.relatedTarget as Node | null)) focusInside.current = false;
-            }}
-            // The phone's sheet sits on the nav; from `md` up the card floats above the
-            // FAB (its offset + the 3rem button + a 0.75rem gap).
-            style={
-              {
-                "--fp-bottom": `calc(${BOTTOM_CLEARANCE})`,
-                "--fp-bottom-md": `calc(${BOTTOM_CLEARANCE} + ${offset} + 3.75rem)`,
-                "--fp-side": SIDE_GUTTER,
-              } as CSSProperties
-            }
-            className={cn(
-              "animate-sheet fixed z-40 flex flex-col overflow-hidden outline-none",
-              "border border-subtle bg-surface shadow-2xl",
-              // Phone: full width, docked, rounded only where it meets the page.
-              "inset-x-0 bottom-[var(--fp-bottom)] max-h-[min(85dvh,calc(100dvh_-_var(--fp-bottom)_-_1rem))] rounded-t-xl border-x-0 border-b-0",
-              "pb-[env(safe-area-inset-bottom,0px)] md:pb-0",
-              // md+: a card in the corner, above the FAB.
-              "md:inset-x-auto md:bottom-[var(--fp-bottom-md)] md:w-[24rem] md:max-h-[min(36rem,calc(100dvh_-_var(--fp-bottom-md)_-_1rem))] md:rounded-xl md:border",
-              corner === "bottom-start" ? "md:start-[var(--fp-side)]" : "md:end-[var(--fp-side)]",
-              className,
-            )}
-          >
-            <div className="flex shrink-0 items-center justify-between gap-2 border-b border-subtle px-4 py-3">
-              <h2 id={titleId} className="min-w-0 truncate text-base font-semibold text-primary">
-                {title}
-              </h2>
-              <button
-                type="button"
-                onClick={() => {
-                  focusInside.current = true;
-                  setOpen(false);
-                }}
-                aria-label={labels.close}
-                className={cn(
-                  "-me-1.5 shrink-0 rounded p-1.5 text-muted outline-none hover:bg-hover hover:text-secondary",
-                  FOCUS_RING,
-                )}
-              >
-                <X aria-hidden className="size-5" />
-              </button>
-            </div>
-            <div className={cn("min-h-0 flex-1 overflow-y-auto overscroll-contain p-4", bodyClassName)}>{children}</div>
-          </div>,
-          document.body,
-        )}
-    </>
-  );
-}
-
-export interface FloatingActionGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "role"> {
-  /** Name the group ("Register actions"); a reader then introduces the members as one
-   *  set. A group with no name is one more unlabelled wrapper. */
-  "aria-label"?: string;
-  /** Default `bottom-end`. */
-  corner?: FloatingCorner;
-  /** Distance above the nav / home indicator — see {@link FloatingActionButtonProps.offset}. */
-  offset?: string;
-  /** {@link FloatingAction}s, in reading order. */
-  children: ReactNode;
-  /** 0.49 KIT-11: step aside while a dialog, a sheet, a popover, a hover menu or a list
-   *  is open — see {@link FloatingActionButtonProps.hideWhenOverlay}. Default `true`. */
-  hideWhenOverlay?: boolean;
-  ref?: Ref<HTMLDivElement>;
-}
-
-/**
- * A floating pill of {@link FloatingAction}s — one to four `size-12` toggles, actions
- * or links with hairline dividers — pinned to a corner exactly as the
- * {@link FloatingActionButton} is: `--app-nav-h` and the home indicator cleared, a
- * logical corner, portalled.
- *
- * keksdose built it twice by hand: the /transactions phone toolbar
- * (transactions-page.tsx:644 — upcoming and pending toggles, an invoices link with a
- * pending count, and the brand "+") and the feedback page's "awaiting only" toggle
- * (feedback-page.tsx:854, one button in the group anyway, so the two pages look
- * alike). Both at `right-4 bottom-20` — `right`, not `end`, so over the page's leading
- * edge in RTL — with `divide-x`, slate hovers, and each member's `Tooltip` spelled out.
- *
- * `role="group"`, NOT a toolbar: every member keeps its own tab stop, as the
- * hand-built ones did, and there is no arrow-key roving to learn. Hide it where it
- * does not belong with a class (`md:hidden`, as both keksdose pages do).
- */
-export function FloatingActionGroup({
-  corner = "bottom-end",
-  offset = "1rem",
-  hideWhenOverlay = true,
-  hidden,
-  className,
-  style,
-  children,
-  ...rest
-}: FloatingActionGroupProps) {
-  const [marker, dir] = usePortalDir();
-  const overlay = useOverlayOpen(hideWhenOverlay);
-  // As the FAB's (keksdose dev#612): its 3rem members plus the frame's 1px borders.
-  useFloatClearance(offset, "2px");
-  return (
-    <>
-      <span ref={marker} hidden />
-      {typeof document !== "undefined" &&
-        createPortal(
-          <div
-            {...rest}
-            hidden={hidden || overlay || undefined}
-            role="group"
-            dir={dir}
-            data-corner={corner}
-            style={{ ...cornerStyle(corner, offset), ...style }}
-            className={cn(
-              "fixed z-40 inline-flex flex-row overflow-hidden rounded-2xl",
-              "border border-subtle bg-surface shadow-lg",
-              // Dividers on the logical start edge of every member but the first, so
-              // they sit between the same two members in RTL. The member is the
-              // tooltip's wrapper span, which is the direct child.
-              "[&>*:not(:first-child)]:border-s [&>*]:border-subtle",
-              className,
-            )}
-          >
-            {children}
-          </div>,
-          document.body,
-        )}
-    </>
-  );
-}
-
-/** What {@link FloatingActionProps.renderLink} is handed. Spread it onto your router's
- *  link, mapping `href` — `renderLink={({ href, ...p }) => <Link to={href} {...p} />}`. */
-export interface FloatingActionLinkProps {
-  href: string;
-  /** The member's whole look — keep it. */
-  className: string;
-  children: ReactNode;
-  "aria-label": string;
-  onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
-  [key: `aria-${string}`]: string | boolean | number | undefined;
-  [key: `data-${string}`]: unknown;
-}
-
-export interface FloatingActionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "onClick"> {
-  /** The accessible name, and the tooltip's text. Keep it the same in both states of a
-   *  toggle; `aria-pressed` says which one it is in. */
-  label: string;
-  icon: ReactNode;
-  /** Make it a toggle: `aria-pressed` and the brand "on" look (the brand glyph on the
-   *  quiet brand fill), as {@link FloatingActionButtonProps.pressed}. Ignored on a link.
-   *  For the state without the tint, see {@link pressedStyle}. */
-  pressed?: boolean;
-  /**
-   * How `pressed` looks. `tint` (default): the brand "on" look. `plain`: the member
-   * keeps its quiet look in both states and only `aria-pressed` changes — for a toggle
-   * whose icon already says which state it is in (keksdose's /transactions "Upcoming"
-   * swaps two icons; a tint on top said it twice). The same as passing `aria-pressed`
-   * without `pressed`, which also rides through untinted.
-   */
-  pressedStyle?: "tint" | "plain";
-  /**
-   * `accent`: the brand-filled member, for the group's main action (the /transactions
-   * "+"), as Button's `accent`. `default` (default): the quiet one.
-   */
-  variant?: "default" | "accent";
-  /**
-   * A count in a dot at the member's top end corner — the /transactions invoices link's
-   * pending count. Nothing is drawn for `0` or less; above 99 it reads `99+`. The count
-   * joins the accessible name through `floatingPanel.badge` ("Invoices, 3 new"), or
-   * `badgeLabel` when passed.
-   */
-  badge?: number;
-  /** The badge's words for a reader, replacing `floatingPanel.badge` — "3 to review". */
-  badgeLabel?: string;
-  /** The dot's colour. Default `warning`, the pending count's. */
-  badgeTone?: "warning" | "danger" | "brand";
-  /** Show `label` in the kit {@link Tooltip} on hover and focus. Default `true`: the
-   *  members are icon-only and this is their only visible label. */
-  tooltip?: boolean;
-  /** Where the tooltip opens. Default `top` — the group sits at the bottom of the screen. */
-  tooltipSide?: TooltipSide;
-  /** Make it a link — the /transactions invoices member. Drawn by `renderLink`, else
-   *  the `<UiKitProvider linkComponent>` (an in-app `href`), else a plain `<a>`. */
-  href?: string;
-  /** Render the link through your router's `Link` — see {@link FloatingActionLinkProps}. */
-  renderLink?: (props: FloatingActionLinkProps) => ReactElement;
-  onClick?: (event: MouseEvent<HTMLElement>) => void;
-  ref?: Ref<HTMLButtonElement>;
-}
-
-// Each fill under its own foreground (0.33): warning borrowed `--text-inverse`, the
-// surface colour, which was 4.24:1 on the light warning fill.
-const BADGE_TONE: Record<NonNullable<FloatingActionProps["badgeTone"]>, string> = {
-  warning: "bg-warning text-warning-contrast",
-  danger: "bg-danger text-danger-contrast",
-  brand: "bg-brand text-brand-contrast",
-};
-
-/**
- * One member of a {@link FloatingActionGroup}: a `size-12` icon button, toggle or link
- * with its label in a styled tooltip — what each keksdose member wrapped by hand in
- * `<Tooltip portal>`. The tooltip is portalled because the group clips (`overflow-hidden`
- * keeps the brand member's fill inside the pill's corners), and the focus ring is inset
- * for the same reason.
- */
-export function FloatingAction({
-  label,
-  icon,
-  pressed,
-  pressedStyle = "tint",
-  variant = "default",
-  badge,
-  badgeLabel,
-  badgeTone = "warning",
-  tooltip = true,
-  tooltipSide = "top",
-  href,
-  renderLink,
-  className,
-  type = "button",
-  onClick,
-  ref,
-  ...rest
-}: FloatingActionProps) {
-  const labels = useKitLabels("floatingPanel", DEFAULT_FLOATING_PANEL_LABELS);
-  const kitLink = useKitLink();
-  const counted = badge !== undefined && badge > 0;
-  const name = counted ? `${label}, ${badgeLabel ?? labels.badge(badge)}` : label;
-  const isLink = href !== undefined;
-  const look = cn(
-    "relative flex size-12 items-center justify-center transition-colors",
-    "outline-none focus-visible:ring-inset",
-    FOCUS_RING,
-    "disabled:cursor-not-allowed disabled:opacity-50 [&_svg]:size-5",
-    variant === "accent"
-      ? "bg-brand text-brand-contrast hover:bg-brand-hover"
-      : pressed && !isLink && pressedStyle === "tint"
-        ? "bg-brand-soft text-brand hover:bg-brand-soft-hover hover:text-brand-muted"
-        : "text-secondary hover:bg-hover hover:text-primary",
-    className,
-  );
-  const body = (
-    <>
-      {icon}
-      {counted && (
-        <span
-          aria-hidden
-          data-badge=""
-          className={cn(
-            "pointer-events-none absolute end-1 top-1 h-4 min-w-4 rounded-full px-1 text-center text-micro leading-4 font-semibold",
-            BADGE_TONE[badgeTone],
-          )}
-        >
-          {badge > 99 ? "99+" : badge}
-        </span>
-      )}
-    </>
-  );
-
-  let member: ReactElement;
-  if (isLink) {
-    // The button-only attributes stay behind; `aria-*`, `data-*` and the like ride along.
-    const { disabled: _disabled, form: _form, value: _value, name: _name, ...anchorRest } = rest;
-    const linkProps: FloatingActionLinkProps = {
-      ...(anchorRest as AnchorHTMLAttributes<HTMLAnchorElement>),
-      href,
-      "aria-label": name,
-      onClick,
-      className: look,
-      children: body,
-    };
-    const { children: content, ...anchor } = linkProps;
-    const render = pickLinkRenderer(renderLink, kitLink, href);
-    member = render ? <RenderedFloatingLink render={render} {...linkProps} /> : <a {...anchor}>{content}</a>;
-  } else {
-    member = (
-      <button
-        {...rest}
-        ref={ref}
-        type={type}
-        aria-label={name}
-        aria-pressed={pressed ?? rest["aria-pressed"]}
-        onClick={onClick}
-        className={look}
-      >
-        {body}
-      </button>
-    );
-  }
-  if (!tooltip) return member;
-  return (
-    // A fragment: the bubble says the member's name, and a description that repeats
-    // the name is read twice.
-    <Tooltip label={label} side={tooltipSide} portal>
-      <>{member}</>
-    </Tooltip>
-  );
-}
-
-/** Calls `renderLink` as a component, so its hooks belong to the link, not to us. */
-function RenderedFloatingLink({
-  render,
-  ...props
-}: FloatingActionLinkProps & { render: (props: FloatingActionLinkProps) => ReactElement }) {
-  return render(props);
-}