beez-ui 0.6.2 → 0.8.0

package/CHANGELOG.md

@@ -1,98 +1,152 @@
-# Cambios
-
-Todos los cambios relevantes de beez-ui se documentan en este archivo con el formato de [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y versionado [SemVer](https://semver.org/lang/es/). Cada cambio agrega sus entradas en `[Unreleased]`; `pnpm create-version` las pasa a la versión publicada con su fecha.
-
+# Cambios
+
+Todos los cambios relevantes de beez-ui se documentan en este archivo con el formato de [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y versionado [SemVer](https://semver.org/lang/es/). Cada cambio agrega sus entradas en `[Unreleased]`; `pnpm create-version` las pasa a la versión publicada con su fecha.
+
 ## [Unreleased]
 
-## [0.6.2] - 2026-09-26
-
-### Changed
-
-- El comando de release (`pnpm create-version`, alias `pnpm cv`) toma las notas del bloque `[Unreleased]` del CHANGELOG, les asigna la versión y la fecha, y pide a Codex que lo complete cuando está vacío.
-- Las cajas del comando de release ajustan el texto largo en varias líneas en lugar de cortarlo.
-- Un release interrumpido reusa automáticamente el artefacto ya preparado cuando es posterior al último cambio de código.
-
-### Removed
-
-- La opción `--notes` y las preguntas sobre las notas del CHANGELOG y sobre reusar el artefacto preparado.
-
-## 0.6.1 - 2026-09-26
-
-- Actualiza pnpm a 12.6.0 y next a 16.3.6
-- Add terminal UI for interactive prompts and spinners
-- Update release banner and icons for improved visibility
-- Remove create-version script
-- Update release command to create-version and improve documentation
-
-## 0.6.0 - 2026-09-23
-
-- Actualiza el paquete a la versión 0.6.0.
-
-## 0.5.6 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.6.
-
-## 0.5.5 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.5.
-
-## 0.5.4 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.4.
-
-## 0.5.3 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.3.
-
-## 0.5.2 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.2.
-
-## 0.5.1 - 2026-09-08
-
-- Actualiza el paquete a la versión 0.5.1.
-
-## 0.5.0 - 2026-09-08
-
-- Actualiza el paquete a la versión 0.5.0.
-
-## 0.4.2 - 2026-09-08
-
-- Actualiza el paquete a la versión 0.4.2.
-
-## 0.4.1 - 2026-09-08
-
-- Actualiza el paquete a la versión 0.4.1.
-
-## 0.4.0 - 2026-09-08
-
-- Distribuye los providers nativo, Next y TanStack con tema compartido, navegación e imágenes adaptadas al framework.
-- Incluye CSS precompilado, tema y fuentes; los consumidores sólo importan `beez-ui/styles.css`, sin configurar Tailwind.
-- Valida el tarball sin compiladores CSS y las integraciones en Chromium y WebKit.
-
-## 0.3.1 - 2026-09-08
-
-- Publica CSS precompilado para que los estilos funcionen sin Tailwind ni detección de clases en el consumidor.
-- Conserva el tema, las fuentes y las utilidades compartidas mediante `beez-ui/styles.css`.
-- Verifica estilos computados del tarball servido por HTTP sin procesadores CSS en Chromium y WebKit.
-
-## 0.2.0 - 2026-09-08
-
-- Unifica el nombre `BeezUIProvider` en los entrypoints nativo, Next y TanStack; reemplaza `NextBeezUIProvider`.
-- Comparte el tema mediante `next-themes`, `themeOptions` y `useTheme` en todos los providers.
-- Restaura `Link` desde la raíz con navegación por adaptadores y prefetch desactivado por defecto.
-- Integra Unpic para imágenes nativas y de TanStack, y conserva Next Image en el provider de Next.
-- Separa los tipos de tests y valida navegación, imágenes y tema en Chromium y WebKit.
-
-## 0.1.1 - 2026-09-08
-
-- Publica JavaScript ESM y declaraciones TypeScript en `dist`.
-- Conserva los componentes agrupados y el tema de LaTribu.
-- Mantiene visible el área del avatar durante la carga diferida para permitir que el navegador solicite la imagen.
-- Agrega `BeezUIProvider` para adaptadores nativos o propios y `NextBeezUIProvider` como integración opcional.
-- Incorpora preparación de releases con checks, control del contenido del paquete y checksum SHA-256.
-- Documenta la autenticación con `NPM_TOKEN` y la publicación del artefacto validado.
-
-## 0.1.0 - 2026-09-08
-
-- Centraliza los componentes de LaTribu y agenda-mensual con su tema, fuentes y pruebas.
+## [0.8.0] - 2026-09-26
+
+### Added
+
+- Los tokens de movimiento (`MOTION_TIMING`, `MOTION_EASE`, springs y distancias) se exportan desde la raíz y desde `beez-ui/motion-tokens`, con los nuevos `SPRING_POP`, `MOTION_ITEM_ENTER_SCALE` y las duraciones `pop` y `collapse`, para animar superficies propias igual que la biblioteca.
+- Primitivas de movimiento `PresenceSwap`, `AnimatedCount`, `AnimatedCollapse` y `AnimatedListItem`, que respetan el movimiento reducido.
+- `BouncingDotsLoader`, `ProgressRing`, `EmptyState`, `ErrorState`, `InfoPopover`, `ConfirmDeleteButton` y `ReactionButton`.
+- `AccountMenu`: menú de cuenta con avatar, identidad, inicio de sesión como link o callback, cierre de sesión y variante para sidebar.
+- `RichTextContent`, `RichMarkdownContent`, `RichLinkEditor` y `useRichLinkEditor` para mostrar y editar texto con links en markdown sin interpretar HTML, junto con `parseRichTextSegments` y `parseRichMarkdownBlocks`.
+- `OpenInBrowserCta` y `ExternalBrowserHandoff` para salir de navegadores internos de otras apps, con `detectInAppBrowser` y `buildExternalBrowserUrl`.
+- `PwaUpdateControl`, que ofrece aplicar una actualización pendiente del service worker.
+- `NotificationBell` y `NotificationPanel`: bandeja de notificaciones en popover o en sheet según el viewport, a partir de ítems ya resueltos por la app.
+- `MonthGrid` y `MonthCalendarHeader` para calendarios mensuales, con `createMonthGridDays`, `groupItemsByDateKey`, `shiftMonthKey` y `useMonthTransitionDirection`.
+- `FileUpload`, `FileUploadDropZone`, `FileUploadList` y `FileUploadItem`, con validación por tipo y tamaño (`classifyFiles`, `isFileTypeAccepted`).
+- `EmojiPicker` en el entrypoint opcional `beez-ui/emoji-picker`; requiere instalar `emoji-picker-react`.
+- Hooks `useIsHydrated`, `useMinuteClock`, `useViewerTimeZone`, `useHorizontalSwipe` y `usePrefersReducedMotion`.
+- Utilidades `formatFileSize`, `copyTextToClipboard`, `getNameInitials`, búsqueda difusa (`getFuzzyMatchRank`, `renderHighlightedText`) y helpers de URL (`replaceCurrentUrlSearchParams`).
+
+### Fixed
+
+- `BeezUIProvider` ya no provoca el aviso de React «Encountered a script tag» en apps renderizadas solo en el cliente; con SSR conserva el script que aplica el tema antes de hidratar, sin parpadeo.
+
+## [0.7.0] - 2026-09-26
+
+### Added
+
+- `PaginationContent` desliza el resaltado de la página actual hacia la página elegida cuando la lista permanece montada (paginación en el cliente).
+- `Calendar` desliza el mes entrante desde el lado de la navegación (también en RTL) y se mantiene estático con movimiento reducido.
+- `AvatarImage` revela la imagen con un desenfoque y un zoom breves al terminar de cargar, en lugar de aparecer de golpe sobre el fallback.
+- Las sugerencias de `FilterQueryBar` deslizan el resaltado entre opciones con teclado, como los menús y `Select`.
+- `AvatarGroup` eleva levemente el avatar bajo el puntero en dispositivos con hover real.
+- El chevron de `DropdownMenuSubTrigger` se desplaza hacia el submenú abierto.
+
+### Changed
+
+- `Skeleton` muestra un brillo que recorre el placeholder en lugar del pulso de opacidad; con movimiento reducido queda como un bloque liso.
+- `Sheet` se cierra con una curva de cajón breve en lugar de un spring, y su botón de cierre aparece con un pop demorado como el de `Dialog`.
+- `Alert` entra con un leve desplazamiento y desenfoque.
+- Los anillos de foco y bordes de `Input`, `Textarea`, `InputGroup`, `SelectTrigger`, `Checkbox` y `RadioGroupItem` aparecen con una transición en lugar de saltar.
+- En menús, `Select` y sugerencias, el resaltado sigue al puntero al instante y solo se desliza al navegar con teclado, con un spring más rápido.
+- El sidebar colapsa y expande con una curva de cajón de 300 ms en lugar de una transición lineal.
+- El thumb de `Switch` tiene una sombra sutil que lo separa del track.
+
+### Fixed
+
+- El cursor de `TypingAnimation` vuelve a parpadear: queda fijo mientras escribe o borra, parpadea en reposo y los lectores de pantalla lo ignoran.
+- `Carousel` vertical responde a las flechas arriba y abajo; antes solo reaccionaba a izquierda y derecha.
+- `SidebarMenuButton` con `variant="outline"` vuelve a pintar su borde con los tokens `oklch` del tema.
+- `FormLabel`, `FormControl`, `FormDescription` y `FormMessage` fuera de un `FormField` lanzan un error claro en lugar de fallar en silencio.
+- Los bordes sin color explícito (footers de `Card`, `Dialog` y `AlertDialog`, `Alert`, filas de `Table`, bordes de `Sheet` y del sidebar) usan el token `--border` del tema en lugar del color del texto cuando se consume `beez-ui/styles.css` sin Tailwind.
+- `DropdownMenu`, sus submenús, `Popover`, `HoverCard` y `Select` muestran su borde y su sombra desde el primer frame al abrirse; antes el revelado los recortaba durante ~650 ms.
+- `DataTable` filtra las columnas apuntadas por `queryFilterConfig` que no declaran `filterFn` (rangos numéricos, enums y año-mes); antes un rango sobre una columna numérica lanzaba `TypeError: val is not iterable` y un enum ocultaba todas las filas. Un `filterFn` propio de la columna sigue teniendo prioridad.
+- Las `Card` interactivas conservan su contorno mientras muestran la sombra de hover; antes la sombra reemplazaba el anillo del borde.
+
+## [0.6.2] - 2026-09-26
+
+### Changed
+
+- El comando de release (`pnpm create-version`, alias `pnpm cv`) toma las notas del bloque `[Unreleased]` del CHANGELOG, les asigna la versión y la fecha, y pide a Codex que lo complete cuando está vacío.
+- Las cajas del comando de release ajustan el texto largo en varias líneas en lugar de cortarlo.
+- Un release interrumpido reusa automáticamente el artefacto ya preparado cuando es posterior al último cambio de código.
+
+### Removed
+
+- La opción `--notes` y las preguntas sobre las notas del CHANGELOG y sobre reusar el artefacto preparado.
+
+## 0.6.1 - 2026-09-26
+
+- Actualiza pnpm a 12.6.0 y next a 16.3.6
+- Add terminal UI for interactive prompts and spinners
+- Update release banner and icons for improved visibility
+- Remove create-version script
+- Update release command to create-version and improve documentation
+
+## 0.6.0 - 2026-09-23
+
+- Actualiza el paquete a la versión 0.6.0.
+
+## 0.5.6 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.6.
+
+## 0.5.5 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.5.
+
+## 0.5.4 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.4.
+
+## 0.5.3 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.3.
+
+## 0.5.2 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.2.
+
+## 0.5.1 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.5.1.
+
+## 0.5.0 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.5.0.
+
+## 0.4.2 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.4.2.
+
+## 0.4.1 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.4.1.
+
+## 0.4.0 - 2026-09-08
+
+- Distribuye los providers nativo, Next y TanStack con tema compartido, navegación e imágenes adaptadas al framework.
+- Incluye CSS precompilado, tema y fuentes; los consumidores sólo importan `beez-ui/styles.css`, sin configurar Tailwind.
+- Valida el tarball sin compiladores CSS y las integraciones en Chromium y WebKit.
+
+## 0.3.1 - 2026-09-08
+
+- Publica CSS precompilado para que los estilos funcionen sin Tailwind ni detección de clases en el consumidor.
+- Conserva el tema, las fuentes y las utilidades compartidas mediante `beez-ui/styles.css`.
+- Verifica estilos computados del tarball servido por HTTP sin procesadores CSS en Chromium y WebKit.
+
+## 0.2.0 - 2026-09-08
+
+- Unifica el nombre `BeezUIProvider` en los entrypoints nativo, Next y TanStack; reemplaza `NextBeezUIProvider`.
+- Comparte el tema mediante `next-themes`, `themeOptions` y `useTheme` en todos los providers.
+- Restaura `Link` desde la raíz con navegación por adaptadores y prefetch desactivado por defecto.
+- Integra Unpic para imágenes nativas y de TanStack, y conserva Next Image en el provider de Next.
+- Separa los tipos de tests y valida navegación, imágenes y tema en Chromium y WebKit.
+
+## 0.1.1 - 2026-09-08
+
+- Publica JavaScript ESM y declaraciones TypeScript en `dist`.
+- Conserva los componentes agrupados y el tema de LaTribu.
+- Mantiene visible el área del avatar durante la carga diferida para permitir que el navegador solicite la imagen.
+- Agrega `BeezUIProvider` para adaptadores nativos o propios y `NextBeezUIProvider` como integración opcional.
+- Incorpora preparación de releases con checks, control del contenido del paquete y checksum SHA-256.
+- Documenta la autenticación con `NPM_TOKEN` y la publicación del artefacto validado.
+
+## 0.1.0 - 2026-09-08
+
+- Centraliza los componentes de LaTribu y agenda-mensual con su tema, fuentes y pruebas.

package/README.md

@@ -77,10 +77,15 @@ siguen los tokens de [beui motion](https://beui.dev/components/motion):
 - `Tooltip` entra con blur, escala y desplazamiento desde el trigger.
   `Popover`, `HoverCard`, `DropdownMenu` y `Select` escalan desde 0.96 y se revelan
   con un clip desde la esquina más cercana al trigger.
-- `Dialog` y `AlertDialog` suben con spring; `Sheet` entra desde su borde con spring.
+- `Dialog` y `AlertDialog` suben con spring; `Sheet` entra desde su borde con spring
+  y sale con la curva de cajón (0.24 s), sin demorar la siguiente interacción.
 - `GlideSlot` desliza el indicador activo entre ítems como un `layoutId` compartido:
-  la pestaña activa de `Tabs` (fondo o subrayado), el ítem activo de `SidebarMenu` y
-  el ítem resaltado de `DropdownMenu` y `Select`, también con teclado. Una copia
+  la pestaña activa de `Tabs` (fondo o subrayado), el ítem activo de `SidebarMenu`, la
+  página actual de `PaginationContent`, y al navegar con teclado el ítem resaltado de
+  `DropdownMenu` y `Select` y la sugerencia activa de `FilterQueryBar`. Con el puntero,
+  esos resaltados lo siguen al instante: el propio puntero ya marca la posición.
+- Las superficies flotantes se revelan con un clip que deja 24 px libres fuera de la
+  caja, así su borde (`ring`) y su sombra se ven desde el primer frame. Una copia
   transitoria viaja entre ítems y se elimina al llegar, devolviendo el estilo al ítem.
 - El chevron de `SelectTrigger` gira 180° al abrir y los chevrons de `DataTable`
   (grupos y columnas) giran en lugar de cambiar de ícono; CSS define el ángulo final.
@@ -88,8 +93,14 @@ siguen los tokens de [beui motion](https://beui.dev/components/motion):
   solo se desvanece) y los checks de ítems de `Select` y `DropdownMenu` aparecen con pop.
 - El ícono de `AnimatedThemeToggler` cambia con blur y escala; el botón de cierre de
   `Dialog` aparece con un pop demorado.
-- El contenido de `Tabs` entra con un desplazamiento de 4 px. Cards y enlaces
-  responden al hover. El skeleton pulsa con Motion. Las animaciones especializadas
+- El contenido de `Tabs` entra con un desplazamiento de 4 px y `Alert` entra con blur.
+  Cards y enlaces responden al hover; el avatar bajo el puntero de un `AvatarGroup` se
+  eleva. Un brillo recorre el `Skeleton` desde su `::after` con reproducción nativa,
+  sin trabajo por frame en JavaScript.
+- `Calendar` desliza el mes entrante desde el lado de la navegación (invertido en RTL).
+- `AvatarImage` se revela con blur y un zoom de 1.06 al terminar de cargar; las imágenes
+  ya cargadas al montar no se animan.
+- El cursor de `TypingAnimation` queda fijo mientras escribe y parpadea en reposo. Las animaciones especializadas
   existentes de Embla, Sonner y rough-notation se conservan.
 
 El contenido que está saliendo deja de ser interactivo y accesible de inmediato.
@@ -160,6 +171,22 @@ La tabla conserva agrupación estable, columnas configurables, memoización, exc
 
 Los componentes compartidos conservan el tema de LaTribu. Se incorporaron atributos `data-variant`/`data-size` del botón, scroll para paneles largos y persistencia opcional del sidebar. Se mantienen `Button.asChild`, estados deshabilitados y skeletons deterministas. `AvatarImage` delega carga y fallback a Base UI; conserva carga diferida y recuperación al cambiar `src`. El export original `Toaster` permanece disponible; `ThemedToaster` agrega los estilos e iconos compartidos.
 
+## Componentes de producto reutilizables
+
+Provienen de las carpetas de producto de LaTribu y agenda-mensual y quedaron desacoplados de su dominio: reciben datos ya resueltos y textos por props, con valores por defecto en español.
+
+- Movimiento: `PresenceSwap`, `AnimatedCount`, `AnimatedCollapse` y `AnimatedListItem`. Los tokens que usa la biblioteca se exportan desde la raíz y desde `beez-ui/motion-tokens`, así las apps animan sus superficies con las mismas curvas y springs en lugar de copiarlos.
+- Feedback: `BouncingDotsLoader`, `ProgressRing`, `EmptyState`, `ErrorState`, `InfoPopover`, `ConfirmDeleteButton` y `ReactionButton`. El loader y la entrada del título de `MonthCalendarHeader` usan keyframes CSS porque se renderizan en el servidor; el fallback de movimiento reducido los detiene.
+- Cuenta y sesión: `AccountMenu` (inicio de sesión mediante `signInHref` o `onSignIn`), `OpenInBrowserCta`, `ExternalBrowserHandoff` y los helpers `detectInAppBrowser` y `buildExternalBrowserUrl`.
+- Contenido: `RichTextContent`, `RichMarkdownContent`, `RichLinkEditor` y `useRichLinkEditor`. Solo interpretan links en markdown, URLs sueltas, listas y negrita; el HTML del contenido nunca se renderiza como markup.
+- Notificaciones: `NotificationBell` y `NotificationPanel` reciben `NotificationPanelItem` (`id`, `title`, `detail`, `sentAtLabel`, `href`, `isUnread`); la app traduce sus notificaciones a ese formato. Con `surface="responsive"` se renderizan el popover y el sheet hasta hidratar, y después solo el que corresponde al viewport.
+- Calendario: `MonthGrid` y `MonthCalendarHeader` trabajan con claves `YYYY-MM` y `YYYY-MM-DD` sin zona horaria; la app decide en qué zona convierte cada instante en día. La navegación acepta `href` (link del router) o `onSelect`.
+- Archivos: `FileUpload`, `FileUploadDropZone`, `FileUploadList` y `FileUploadItem` validan tipo y tamaño, pero no suben archivos: el progreso y los errores los informa la app.
+- PWA: `PwaUpdateControl` aparece solo cuando hay un service worker en espera y le envía `{ type: "SKIP_WAITING" }` (configurable con `skipWaitingMessage`).
+- Hooks y utilidades: `useIsHydrated`, `useMinuteClock`, `useViewerTimeZone`, `useHorizontalSwipe`, `usePrefersReducedMotion`, `formatFileSize`, `copyTextToClipboard`, `getNameInitials`, búsqueda difusa y helpers de URL.
+
+`EmojiPicker` vive en el entrypoint opcional `beez-ui/emoji-picker` para no sumar `emoji-picker-react` a quien no lo usa. Hay que instalarlo como dependencia de la app (`pnpm add emoji-picker-react`); la librería se carga recién al abrir el selector, nunca durante el render del servidor.
+
 ## React Compiler
 
 El build usa el port de React Compiler en Rust de [Oxc](https://oxc.rs/blog/2026-08-18-react-compiler-support), mediante `oxc-transform-react`. Esta integración sigue marcada como experimental por Oxc.
@@ -195,7 +222,7 @@ pnpm release:prepare
 
 `pnpm build` genera las declaraciones con TypeScript 7, JavaScript con Oxc/React Compiler y CSS con el CLI de Tailwind. `pnpm check` ejecuta ESLint 10, los typechecks separados de código y tests con TypeScript 7, y Vitest 5. `tests/tsconfig.json` incorpora los matchers de Testing Library y los tipos de Vite sin incluirlos en el código de producción. `test:browser` verifica una app React/Vite nativa y una app Next real en Chromium y WebKit, tanto en desktop como en móvil. Los tests unitarios importan los archivos compilados. Los consumidores de navegador no instalan plugins de Tailwind, y una prueba adicional sirve el tarball por HTTP sin procesadores CSS para verificar estilos computados y carga de fuentes. Una prueba adicional instala el tarball en un consumidor aislado sin Next y verifica render, filtrado y declaraciones públicas.
 
-Los tests resuelven `beez-ui`, `beez-ui/next` y `beez-ui/tanstack` mediante rutas explícitas a las declaraciones compiladas en `tests/tsconfig.json`. Ejecutar `pnpm build` después de clonar o si falta `dist`; los comandos de validación completos ya lo hacen. Si el editor conserva diagnósticos anteriores después del build, reiniciar su servidor de TypeScript.
+Los tests resuelven `beez-ui`, `beez-ui/next`, `beez-ui/tanstack` y `beez-ui/emoji-picker` mediante rutas explícitas a las declaraciones compiladas en `tests/tsconfig.json`. Ejecutar `pnpm build` después de clonar o si falta `dist`; los comandos de validación completos ya lo hacen. Si el editor conserva diagnósticos anteriores después del build, reiniciar su servidor de TypeScript.
 
 El compilador `tsc` es TypeScript 7. Para `typescript-eslint`, se mantiene la [API de compatibilidad oficial de TypeScript 6](https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/#running-side-by-side-with-typescript-6.0) mediante un alias; no reemplaza el compilador de los typechecks.
 

package/dist/components/account-menu.d.ts

@@ -0,0 +1,53 @@
+/** Account menu: avatar trigger, account identity and the sign-in or sign-out action. */
+import type { ReactNode } from "react";
+export type AccountMenuStatus = "authenticated" | "unauthenticated";
+export interface AccountMenuLabels {
+    signIn?: string;
+    signOut?: string;
+    /** Accessible name of the trigger button. */
+    trigger?: string;
+}
+export interface AccountMenuClassNames {
+    trigger?: string;
+    triggerAvatar?: string;
+    content?: string;
+    /** Badge shown while authenticated, when `showStatusBadge` is enabled. */
+    connectedBadge?: string;
+    /** Badge shown while signed out, when `showStatusBadge` is enabled. */
+    disconnectedBadge?: string;
+}
+export interface AccountMenuProps {
+    name: string;
+    email: string;
+    status: AccountMenuStatus;
+    image?: string | null;
+    /** Avatar text when there is no image; defaults to the name initials. */
+    avatarFallback?: string;
+    /** Called by the sign-out item. The menu stays mounted while a returned promise settles. */
+    onSignOut: () => void | Promise<void>;
+    signOutDisabled?: boolean;
+    /** Called by the sign-in item. Ignored when `signInHref` is set. */
+    onSignIn?: () => void;
+    /** Navigates to a sign-in page through the configured router adapter instead of calling `onSignIn`. */
+    signInHref?: string;
+    /** `avatar` shows only the avatar; `sidebar` also shows name, email and a chevron. */
+    triggerVariant?: "avatar" | "sidebar";
+    /** Adds a connected/disconnected badge to the avatar and greys it out while signed out. */
+    showStatusBadge?: boolean;
+    /** Optional hint shown when hovering or focusing the trigger. */
+    tooltipLabel?: ReactNode;
+    labels?: AccountMenuLabels;
+    classNames?: AccountMenuClassNames;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    sideOffset?: number;
+    /** Extra items rendered between the identity header and the session action. */
+    children?: ReactNode;
+}
+/**
+ * Presentational account menu: the session and its side effects stay with the caller. Signed in,
+ * the menu offers sign-out; signed out, it offers sign-in as a link (`signInHref`) or a callback.
+ * @param props - Identity, session status, callbacks, copy and layout.
+ * @returns The trigger and its menu.
+ */
+export declare function AccountMenu({ name, email, status, image, avatarFallback, onSignOut, signOutDisabled, onSignIn, signInHref, triggerVariant, showStatusBadge, tooltipLabel, labels, classNames, align, side, sideOffset, children, }: AccountMenuProps): import("react").JSX.Element;