Account Switcher

1"use client";
2 
3import { useCallback, useId, useMemo } from "react";
4import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
5import { Separator } from "@/components/ui/separator";
6import { cn } from "@/lib/utils";
7import { useControllableState } from "./hooks/use-controllable-state";
8import { enforceUniqueKeys } from "./lib/enforce-unique-keys";
9import { resolveActiveItem } from "./lib/resolve-active-item";
10import { EmptyPlaceholder } from "./parts/empty-placeholder";
11import { SwitcherItemRow } from "./parts/switcher-item-row";
12import {
13  SwitcherTriggerContent,
14  composeSwitcherTriggerAriaLabel,
15  switcherTriggerClassName,
16} from "./parts/switcher-trigger";
17import type { AccountSwitcherProps, SwitcherItem } from "./types";
18 
19const DEFAULT_ARIA_LABEL = "Switch account context";
20 
21/**
22 * Account Switcher — popover-with-switchable-items primitive.
23 *
24 * See [`docs/procomps/account-switcher-procomp/`](../../../../../docs/procomps/account-switcher-procomp/)
25 * for description + plan + guide. Locks L1–L14, all PQs at default per
26 * 2026-05-23 GATE 2 close.
27 */
28export function AccountSwitcher(props: AccountSwitcherProps) {
29  const {
30    items,
31    activeKey,
32    onSelect,
33    fallbackActiveItem,
34    footerSlot,
35    isCollapsed = false,
36    collapsedPopoverSide = "right",
37    "aria-label": ariaLabel = DEFAULT_ARIA_LABEL,
38    ariaCurrent = "true",
39    open: openProp,
40    defaultOpen,
41    onOpenChange,
42    className,
43  } = props;
44 
45  const listboxId = useId();
46 
47  const [open, setOpen] = useControllableState<boolean>({
48    value: openProp,
49    defaultValue: defaultOpen ?? false,
50    onChange: onOpenChange,
51    componentName: "account-switcher",
52    valuePropName: "open",
53  });
54 
55  // L3 + Q2 — dev-warn + strip duplicates once per items reference change.
56  const dedupedItems = useMemo(() => enforceUniqueKeys(items), [items]);
57 
58  const activeResolution = useMemo(
59    () => resolveActiveItem(dedupedItems, activeKey, fallbackActiveItem),
60    [dedupedItems, activeKey, fallbackActiveItem],
61  );
62 
63  const activeItem = activeResolution.kind === "empty" ? null : activeResolution.item;
64 
65  // F-cross-13 guard at the shadcn-primitive boundary. The consumer's
66  // `onOpenChange` is shielded — `useControllableState` always calls it with
67  // the validated `boolean`. Plan §10.
68  const handlePrimitiveOpenChange = useCallback(
69    (next: unknown) => {
70      if (typeof next !== "boolean") return;
71      setOpen(next);
72    },
73    [setOpen],
74  );
75 
76// … truncated