@vector-business-services/cristal-ds-web 0.12.0 → 0.13.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, InputHTMLAttributes, HTMLAttributes, ButtonHTMLAttributes, CSSProperties, SyntheticEvent, MouseEvent, RefObject } from 'react';
+import { ReactNode, InputHTMLAttributes, HTMLAttributes, ButtonHTMLAttributes, CSSProperties, RefObject, SyntheticEvent, MouseEvent } from 'react';
 import { AutoCompleteProps as AutoCompleteProps$1 } from 'primereact/autocomplete';
 import { CheckboxChangeEvent } from 'primereact/checkbox';
 import { ChipRemoveEvent } from 'primereact/chip';
@@ -271,6 +271,32 @@ interface DrawerProps {
 }
 declare function Drawer({ visible, onHide, title, subtitle, side, behavior, size, modal, onBack, backLabel, closeLabel, footer, children, id, className, }: DrawerProps): react.JSX.Element;
 
+/** Type no Figma: Plain (rótulo curto, uma linha) e Rich (texto de até 300px, quebra linha). */
+type TooltipType = 'plain' | 'rich';
+type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+interface TooltipProps {
+    /** Elemento que mostra o tooltip: ref, elemento ou seletor CSS. */
+    target: RefObject<HTMLElement | null> | HTMLElement | string;
+    /** Texto do tooltip (Label no Plain, Text no Rich). */
+    content: ReactNode;
+    type?: TooltipType;
+    /** Lado do alvo. O Prime inverte o lado se faltar espaço na tela. */
+    position?: TooltipPosition;
+    /** O que abre o tooltip; o padrão abre no hover e no foco do teclado. */
+    event?: 'hover' | 'focus' | 'both';
+    showDelay?: number;
+    hideDelay?: number;
+    disabled?: boolean;
+    /**
+     * Liga o texto ao alvo como descrição (aria-describedby). Padrão: true. Use false quando o texto
+     * já é o nome do alvo (como no IconButton), para o leitor de tela não ler duas vezes.
+     */
+    describe?: boolean;
+    id?: string;
+    className?: string;
+}
+declare function Tooltip({ target, content, type, position, event, showDelay, hideDelay, disabled, describe, id, className, }: TooltipProps): react.JSX.Element;
+
 /**
  * Hierarchy no Figma: Primary (Filled), Secondary (Tonal), Tertiary (Outlined) e Other (Icon),
  * que aqui é `ghost`: só o ícone, com fundo no hover.
@@ -285,6 +311,13 @@ interface IconButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>,
     icon: ReactNode;
     /** Obrigatório: o botão não tem texto, então é isso que o leitor de tela anuncia. */
     'aria-label': string;
+    /**
+     * Tooltip do botão. Padrão: o próprio `aria-label`, para quem vê saber o que o ícone faz. Um
+     * texto diferente vira também a descrição do botão; `false` tira o tooltip.
+     */
+    tooltip?: ReactNode | false;
+    /** Lado do tooltip. Padrão: bottom. */
+    tooltipPosition?: TooltipPosition;
 }
 declare const IconButton: react.ForwardRefExoticComponent<IconButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
@@ -554,9 +587,17 @@ interface PageHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'>
     segmentControl?: ReactNode;
     /** Botões das ferramentas (Show Buttons no Figma), 8px entre eles. */
     actions?: ReactNode;
-    /** Mostra o botão de expandir, o último das ferramentas. */
-    onExpand?: () => void;
+    /**
+     * Mostra o botão de expandir, o último das ferramentas. Recebe o novo estado: true ao expandir,
+     * false ao recolher.
+     */
+    onExpand?: (expanded: boolean) => void;
+    /** Expandido (controlado). Sem ele, o PageHeader alterna sozinho a cada clique. */
+    expanded?: boolean;
+    /** Nome do botão recolhido (ArrowsOutSimple). */
     expandLabel?: string;
+    /** Nome do botão expandido (ArrowsInSimple). */
+    collapseLabel?: string;
     /** Abas abaixo do título (Show Tabs no Figma). */
     tabs?: PageHeaderTab[];
     /** Aba ativa (controlado). Sem ela, o PageHeader controla sozinho. */
@@ -791,26 +832,5 @@ interface ToastProps {
 }
 declare const Toast: react.ForwardRefExoticComponent<ToastProps & react.RefAttributes<ToastHandle>>;
 
-/** Type no Figma: Plain (rótulo curto, uma linha) e Rich (texto de até 300px, quebra linha). */
-type TooltipType = 'plain' | 'rich';
-type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
-interface TooltipProps {
-    /** Elemento que mostra o tooltip: ref, elemento ou seletor CSS. */
-    target: RefObject<HTMLElement | null> | HTMLElement | string;
-    /** Texto do tooltip (Label no Plain, Text no Rich). */
-    content: ReactNode;
-    type?: TooltipType;
-    /** Lado do alvo. O Prime inverte o lado se faltar espaço na tela. */
-    position?: TooltipPosition;
-    /** O que abre o tooltip; o padrão abre no hover e no foco do teclado. */
-    event?: 'hover' | 'focus' | 'both';
-    showDelay?: number;
-    hideDelay?: number;
-    disabled?: boolean;
-    id?: string;
-    className?: string;
-}
-declare function Tooltip({ target, content, type, position, event, showDelay, hideDelay, disabled, id, className, }: TooltipProps): react.JSX.Element;
-
 export { Accordion, AccordionTab, AutoComplete, Badge, Button, Card, Chart, Checkbox, Chip, Divider, Drawer, IconButton, Input, Menu, MenuPrincipal, Menubar, Message, Modal, MultiSelect, PageHeader, Paginator, Panel, Radio, ScrollPanel, SegmentControl, Select, Switch, TabPanel, Tabs, Tag, Toast, Tooltip };
 export type { AccordionProps, AccordionTabProps, AutoCompleteProps, AutoCompleteSize, AutoCompleteVariant, BadgeProps, BadgeSize, BadgeVariant, ButtonProps, ButtonSize, ButtonVariant, CardPadding, CardProps, ChartAxis, ChartColor, ChartProps, ChartSeries, CheckboxLabelSize, CheckboxPosition, CheckboxProps, ChipProps, ChipSize, ChipVariant, DividerOrientation, DividerProps, DividerVariant, DrawerBehavior, DrawerProps, DrawerSide, DrawerSize, IconButtonProps, IconButtonSize, IconButtonVariant, InputProps, InputSize, InputVariant, MenuDensity, MenuHandle, MenuItem, MenuPrincipalEntry, MenuPrincipalGroup, MenuPrincipalHandle, MenuPrincipalItem, MenuPrincipalProps, MenuProps, MenubarProps, MenubarTool, MenubarUser, MessageProps, MessageType, ModalProps, ModalSize, MultiSelectDensity, MultiSelectProps, MultiSelectSize, MultiSelectVariant, PageHeaderProps, PageHeaderTab, PageHeaderVariant, PaginatorPageChangeEvent, PaginatorProps, PanelProps, RadioLabelSize, RadioProps, ScrollPanelProps, SegmentControlOption, SegmentControlProps, SegmentControlVariant, SelectProps, SelectSize, SelectVariant, SwitchLabelPosition, SwitchProps, SwitchSize, TabPanelProps, TabsProps, TagProps, TagSize, TagVariant, ToastHandle, ToastMessage, ToastPosition, ToastProps, ToastType, TooltipPosition, TooltipProps, TooltipType };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, InputHTMLAttributes, HTMLAttributes, ButtonHTMLAttributes, CSSProperties, SyntheticEvent, MouseEvent, RefObject } from 'react';
+import { ReactNode, InputHTMLAttributes, HTMLAttributes, ButtonHTMLAttributes, CSSProperties, RefObject, SyntheticEvent, MouseEvent } from 'react';
 import { AutoCompleteProps as AutoCompleteProps$1 } from 'primereact/autocomplete';
 import { CheckboxChangeEvent } from 'primereact/checkbox';
 import { ChipRemoveEvent } from 'primereact/chip';
@@ -271,6 +271,32 @@ interface DrawerProps {
 }
 declare function Drawer({ visible, onHide, title, subtitle, side, behavior, size, modal, onBack, backLabel, closeLabel, footer, children, id, className, }: DrawerProps): react.JSX.Element;
 
+/** Type no Figma: Plain (rótulo curto, uma linha) e Rich (texto de até 300px, quebra linha). */
+type TooltipType = 'plain' | 'rich';
+type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+interface TooltipProps {
+    /** Elemento que mostra o tooltip: ref, elemento ou seletor CSS. */
+    target: RefObject<HTMLElement | null> | HTMLElement | string;
+    /** Texto do tooltip (Label no Plain, Text no Rich). */
+    content: ReactNode;
+    type?: TooltipType;
+    /** Lado do alvo. O Prime inverte o lado se faltar espaço na tela. */
+    position?: TooltipPosition;
+    /** O que abre o tooltip; o padrão abre no hover e no foco do teclado. */
+    event?: 'hover' | 'focus' | 'both';
+    showDelay?: number;
+    hideDelay?: number;
+    disabled?: boolean;
+    /**
+     * Liga o texto ao alvo como descrição (aria-describedby). Padrão: true. Use false quando o texto
+     * já é o nome do alvo (como no IconButton), para o leitor de tela não ler duas vezes.
+     */
+    describe?: boolean;
+    id?: string;
+    className?: string;
+}
+declare function Tooltip({ target, content, type, position, event, showDelay, hideDelay, disabled, describe, id, className, }: TooltipProps): react.JSX.Element;
+
 /**
  * Hierarchy no Figma: Primary (Filled), Secondary (Tonal), Tertiary (Outlined) e Other (Icon),
  * que aqui é `ghost`: só o ícone, com fundo no hover.
@@ -285,6 +311,13 @@ interface IconButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>,
     icon: ReactNode;
     /** Obrigatório: o botão não tem texto, então é isso que o leitor de tela anuncia. */
     'aria-label': string;
+    /**
+     * Tooltip do botão. Padrão: o próprio `aria-label`, para quem vê saber o que o ícone faz. Um
+     * texto diferente vira também a descrição do botão; `false` tira o tooltip.
+     */
+    tooltip?: ReactNode | false;
+    /** Lado do tooltip. Padrão: bottom. */
+    tooltipPosition?: TooltipPosition;
 }
 declare const IconButton: react.ForwardRefExoticComponent<IconButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
@@ -554,9 +587,17 @@ interface PageHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'>
     segmentControl?: ReactNode;
     /** Botões das ferramentas (Show Buttons no Figma), 8px entre eles. */
     actions?: ReactNode;
-    /** Mostra o botão de expandir, o último das ferramentas. */
-    onExpand?: () => void;
+    /**
+     * Mostra o botão de expandir, o último das ferramentas. Recebe o novo estado: true ao expandir,
+     * false ao recolher.
+     */
+    onExpand?: (expanded: boolean) => void;
+    /** Expandido (controlado). Sem ele, o PageHeader alterna sozinho a cada clique. */
+    expanded?: boolean;
+    /** Nome do botão recolhido (ArrowsOutSimple). */
     expandLabel?: string;
+    /** Nome do botão expandido (ArrowsInSimple). */
+    collapseLabel?: string;
     /** Abas abaixo do título (Show Tabs no Figma). */
     tabs?: PageHeaderTab[];
     /** Aba ativa (controlado). Sem ela, o PageHeader controla sozinho. */
@@ -791,26 +832,5 @@ interface ToastProps {
 }
 declare const Toast: react.ForwardRefExoticComponent<ToastProps & react.RefAttributes<ToastHandle>>;
 
-/** Type no Figma: Plain (rótulo curto, uma linha) e Rich (texto de até 300px, quebra linha). */
-type TooltipType = 'plain' | 'rich';
-type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
-interface TooltipProps {
-    /** Elemento que mostra o tooltip: ref, elemento ou seletor CSS. */
-    target: RefObject<HTMLElement | null> | HTMLElement | string;
-    /** Texto do tooltip (Label no Plain, Text no Rich). */
-    content: ReactNode;
-    type?: TooltipType;
-    /** Lado do alvo. O Prime inverte o lado se faltar espaço na tela. */
-    position?: TooltipPosition;
-    /** O que abre o tooltip; o padrão abre no hover e no foco do teclado. */
-    event?: 'hover' | 'focus' | 'both';
-    showDelay?: number;
-    hideDelay?: number;
-    disabled?: boolean;
-    id?: string;
-    className?: string;
-}
-declare function Tooltip({ target, content, type, position, event, showDelay, hideDelay, disabled, id, className, }: TooltipProps): react.JSX.Element;
-
 export { Accordion, AccordionTab, AutoComplete, Badge, Button, Card, Chart, Checkbox, Chip, Divider, Drawer, IconButton, Input, Menu, MenuPrincipal, Menubar, Message, Modal, MultiSelect, PageHeader, Paginator, Panel, Radio, ScrollPanel, SegmentControl, Select, Switch, TabPanel, Tabs, Tag, Toast, Tooltip };
 export type { AccordionProps, AccordionTabProps, AutoCompleteProps, AutoCompleteSize, AutoCompleteVariant, BadgeProps, BadgeSize, BadgeVariant, ButtonProps, ButtonSize, ButtonVariant, CardPadding, CardProps, ChartAxis, ChartColor, ChartProps, ChartSeries, CheckboxLabelSize, CheckboxPosition, CheckboxProps, ChipProps, ChipSize, ChipVariant, DividerOrientation, DividerProps, DividerVariant, DrawerBehavior, DrawerProps, DrawerSide, DrawerSize, IconButtonProps, IconButtonSize, IconButtonVariant, InputProps, InputSize, InputVariant, MenuDensity, MenuHandle, MenuItem, MenuPrincipalEntry, MenuPrincipalGroup, MenuPrincipalHandle, MenuPrincipalItem, MenuPrincipalProps, MenuProps, MenubarProps, MenubarTool, MenubarUser, MessageProps, MessageType, ModalProps, ModalSize, MultiSelectDensity, MultiSelectProps, MultiSelectSize, MultiSelectVariant, PageHeaderProps, PageHeaderTab, PageHeaderVariant, PaginatorPageChangeEvent, PaginatorProps, PanelProps, RadioLabelSize, RadioProps, ScrollPanelProps, SegmentControlOption, SegmentControlProps, SegmentControlVariant, SelectProps, SelectSize, SelectVariant, SwitchLabelPosition, SwitchProps, SwitchSize, TabPanelProps, TabsProps, TagProps, TagSize, TagVariant, ToastHandle, ToastMessage, ToastPosition, ToastProps, ToastType, TooltipPosition, TooltipProps, TooltipType };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { forwardRef, useRef, useImperativeHandle, useState, Children, isValidElement, useId, useCallback, useEffect, useContext, cloneElement, useLayoutEffect, useMemo } from 'react';
 import { Accordion as Accordion$1, AccordionTab as AccordionTab$1 } from 'primereact/accordion';
-import { WarningCircle, Info, Check, CircleNotch, CaretDown, MagnifyingGlass, ArrowLeft, ArrowsOutSimple, CaretUp, X, List, DribbbleLogo, SealWarning, XCircle, CheckCircle, Warning, CaretDoubleRight, CaretRight, CaretLeft, CaretDoubleLeft, Question } from '@phosphor-icons/react';
+import { WarningCircle, Info, Check, CircleNotch, CaretDown, MagnifyingGlass, ArrowLeft, ArrowsInSimple, ArrowsOutSimple, CaretUp, X, List, DribbbleLogo, SealWarning, XCircle, CheckCircle, Warning, CaretDoubleRight, CaretRight, CaretLeft, CaretDoubleLeft, Question } from '@phosphor-icons/react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { AutoComplete as AutoComplete$1 } from 'primereact/autocomplete';
 import { Badge as Badge$1 } from 'primereact/badge';
@@ -86,6 +86,23 @@ var Accordion = forwardRef(function Accordion2({ multiple = false, activeIndex,
     }
   );
 });
+
+// src/components/popup.ts
+function seguirLado(painel, alvo) {
+  if (!(painel instanceof HTMLElement) || !alvo) return;
+  const marcar = () => {
+    const acima = painel.getBoundingClientRect().top < alvo.getBoundingClientRect().top;
+    if (acima) painel.setAttribute("data-cr-lado", "acima");
+    else painel.removeAttribute("data-cr-lado");
+  };
+  marcar();
+  new MutationObserver(marcar).observe(painel, { attributes: true, attributeFilter: ["style"] });
+}
+var painelDoCampo = (campo, seletorDoPainel) => {
+  const lista = campo?.getAttribute("aria-controls");
+  return lista ? document.getElementById(lista)?.closest(seletorDoPainel) : null;
+};
+var aoPosicionar = (onEnter) => ({ onEnter });
 var AutoComplete = forwardRef(function AutoComplete2({
   variant = "outline",
   size = "large",
@@ -138,6 +155,11 @@ var AutoComplete = forwardRef(function AutoComplete2({
           // O Prime mostra um spinner próprio enquanto busca; o Figma não define esse estado.
           loadingIcon: { className: "cr-autocomplete__loader" },
           panel: { className: "cr-autocomplete__panel" },
+          // Lado da lista (acima ou abaixo do campo), medido logo depois de o Prime posicionar.
+          transition: aoPosicionar(() => {
+            const campo = document.getElementById(id);
+            seguirLado(painelDoCampo(campo, ".cr-autocomplete__panel"), campo);
+          }),
           list: { className: "cr-autocomplete__list" },
           item: { className: "cr-autocomplete__item" }
         },
@@ -209,6 +231,11 @@ var Card = forwardRef(function Card2({ padding = "xsmall", outline = false, clas
     }
   );
 });
+var usandoTeclado = false;
+if (typeof document !== "undefined") {
+  document.addEventListener("keydown", () => usandoTeclado = true, true);
+  document.addEventListener("pointerdown", () => usandoTeclado = false, true);
+}
 var resolveTargets = (target) => {
   if (typeof target === "string") return Array.from(document.querySelectorAll(target));
   if (target instanceof HTMLElement) return [target];
@@ -223,16 +250,27 @@ function Tooltip({
   showDelay,
   hideDelay,
   disabled,
+  describe = true,
   id,
   className
 }) {
   const autoId = useId();
   const tooltipId = id ?? autoId;
   useEffect(() => {
+    if (!describe) return;
     const elements = resolveTargets(target);
-    elements.forEach((element) => element.setAttribute("aria-describedby", tooltipId));
-    return () => elements.forEach((element) => element.removeAttribute("aria-describedby"));
-  }, [target, tooltipId]);
+    const ids = (element) => (element.getAttribute("aria-describedby") ?? "").split(/\s+/).filter(Boolean);
+    const gravar = (element, lista) => lista.length ? element.setAttribute("aria-describedby", lista.join(" ")) : element.removeAttribute("aria-describedby");
+    elements.forEach((element) => {
+      if (!ids(element).includes(tooltipId)) gravar(element, [...ids(element), tooltipId]);
+    });
+    return () => elements.forEach(
+      (element) => gravar(
+        element,
+        ids(element).filter((idAtual) => idAtual !== tooltipId)
+      )
+    );
+  }, [target, tooltipId, describe]);
   const classes = ["cr-tooltip", `cr-tooltip--${type}`, className].filter(Boolean).join(" ");
   const pt = {
     root: (options) => {
@@ -253,6 +291,8 @@ function Tooltip({
       showDelay,
       hideDelay,
       disabled,
+      closeOnEscape: true,
+      onBeforeShow: (e) => e.originalEvent?.type !== "focus" || usandoTeclado,
       pt,
       children: content
     }
@@ -567,7 +607,10 @@ var Checkbox = forwardRef(function Checkbox2({
         value,
         icon: /* @__PURE__ */ jsx(Check, { size: 16 }),
         pt: {
-          root: { className: "cr-checkbox__control" },
+          // Marcado pela prop do Cristal, não pelo atributo interno do Prime (data-p-highlight).
+          root: {
+            className: `cr-checkbox__control${checked ? " cr-checkbox__control--checked" : ""}`
+          },
           input: { className: "cr-checkbox__input" },
           box: { className: "cr-checkbox__box" },
           icon: { className: "cr-checkbox__icon", "aria-hidden": true }
@@ -656,24 +699,54 @@ var Divider = forwardRef(function Divider2({ orientation = "horizontal", variant
     }
   );
 });
-var IconButton = forwardRef(function IconButton2({ variant = "primary", size = "large", icon, type = "button", className, ...props }, ref) {
+var IconButton = forwardRef(function IconButton2({
+  variant = "primary",
+  size = "large",
+  icon,
+  type = "button",
+  tooltip,
+  tooltipPosition,
+  className,
+  ...props
+}, ref) {
+  const botao = useRef(null);
+  const ligar = useCallback(
+    (elemento) => {
+      botao.current = elemento;
+      if (typeof ref === "function") ref(elemento);
+      else if (ref) ref.current = elemento;
+    },
+    [ref]
+  );
+  const texto = tooltip ?? props["aria-label"];
   const classes = [
     "cr-icon-button",
     `cr-icon-button--${variant}`,
     `cr-icon-button--${size}`,
     className
   ].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsx(
-    Button$1,
-    {
-      unstyled: true,
-      ref,
-      type,
-      className: classes,
-      ...props,
-      children: /* @__PURE__ */ jsx("span", { className: "cr-icon-button__icon", "aria-hidden": "true", children: icon })
-    }
-  );
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      Button$1,
+      {
+        unstyled: true,
+        ref: ligar,
+        type,
+        className: classes,
+        ...props,
+        children: /* @__PURE__ */ jsx("span", { className: "cr-icon-button__icon", "aria-hidden": "true", children: icon })
+      }
+    ),
+    texto !== false && /* @__PURE__ */ jsx(
+      Tooltip,
+      {
+        target: botao,
+        content: texto,
+        position: tooltipPosition,
+        describe: texto !== props["aria-label"]
+      }
+    )
+  ] });
 });
 var FOCAVEIS = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
 function Drawer({
@@ -896,10 +969,17 @@ var Menu = forwardRef(function Menu2({
   className
 }, ref) {
   const primeRef = useRef(null);
+  const alvo = useRef(null);
   const context = useContext(PrimeReactContext);
   useImperativeHandle(ref, () => ({
-    toggle: (event) => primeRef.current?.toggle(event),
-    show: (event) => primeRef.current?.show(event),
+    toggle: (event) => {
+      alvo.current = event.currentTarget;
+      primeRef.current?.toggle(event);
+    },
+    show: (event) => {
+      alvo.current = event.currentTarget;
+      primeRef.current?.show(event);
+    },
     hide: (event) => primeRef.current?.hide(event),
     getElement: () => primeRef.current?.getElement() ?? null
   }));
@@ -937,6 +1017,12 @@ var Menu = forwardRef(function Menu2({
       };
     },
     content: { className: "cr-menu__content" },
+    // Lado do popup (acima ou abaixo de quem o abriu), medido logo depois de o Prime posicionar.
+    // Numa microtarefa: no onEnter o Prime ainda está religando a ref (getElement vem vazio); ela
+    // roda logo depois, antes de a tela ser pintada.
+    transition: aoPosicionar(
+      () => queueMicrotask(() => seguirLado(primeRef.current?.getElement(), alvo.current))
+    ),
     action: { className: "cr-menu__action" },
     label: { className: "cr-menu__label" }
   };
@@ -1194,9 +1280,12 @@ var MenuPrincipal = forwardRef(
     const primeRef = useRef(null);
     const context = useContext(PrimeReactContext);
     const [baseDoAlvo, setBaseDoAlvo] = useState();
+    const alvo = useRef(null);
     const medirAlvo = (event) => {
-      const alvo = event.currentTarget;
-      if (alvo instanceof Element) setBaseDoAlvo(alvo.getBoundingClientRect().bottom);
+      const elemento = event.currentTarget;
+      if (!(elemento instanceof Element)) return;
+      alvo.current = elemento;
+      setBaseDoAlvo(elemento.getBoundingClientRect().bottom);
     };
     useImperativeHandle(ref, () => ({
       toggle: (event) => {
@@ -1255,7 +1344,12 @@ var MenuPrincipal = forwardRef(
       menu: { className: "cr-menu-principal__list", "aria-label": ariaLabel },
       submenuHeader: { className: "cr-menu-principal__group" },
       separator: { className: "cr-menu-principal__separator" },
-      menuitem: { className: "cr-menu-principal__item" }
+      menuitem: { className: "cr-menu-principal__item" },
+      // Lado do popup, medido logo depois de o Prime posicionar.
+      // Numa microtarefa: no onEnter o Prime ainda está religando a ref (como no Menu).
+      transition: aoPosicionar(
+        () => queueMicrotask(() => seguirLado(primeRef.current?.getElement(), alvo.current))
+      )
     };
     const menu = /* @__PURE__ */ jsx(
       Menu$1,
@@ -1590,7 +1684,9 @@ var PageHeader = forwardRef(function PageHeader2({
   segmentControl,
   actions,
   onExpand,
+  expanded,
   expandLabel = "Expandir",
+  collapseLabel = "Recolher",
   tabs,
   activeTab,
   onTabChange,
@@ -1600,6 +1696,8 @@ var PageHeader = forwardRef(function PageHeader2({
 }, ref) {
   const [interna, setInterna] = useState(0);
   const ativa = activeTab ?? interna;
+  const [expandidoInterno, setExpandidoInterno] = useState(false);
+  const expandido = expanded ?? expandidoInterno;
   const tools = segmentControl || actions;
   const tabTemplate = (tab) => (
     // O TabMenu também passa o index da aba nas opções, além do que o tipo do MenuItem declara.
@@ -1647,9 +1745,12 @@ var PageHeader = forwardRef(function PageHeader2({
               className: "cr-page-header__expand",
               variant: "tertiary",
               size: "medium",
-              icon: /* @__PURE__ */ jsx(ArrowsOutSimple, {}),
-              "aria-label": expandLabel,
-              onClick: onExpand
+              icon: expandido ? /* @__PURE__ */ jsx(ArrowsInSimple, {}) : /* @__PURE__ */ jsx(ArrowsOutSimple, {}),
+              "aria-label": expandido ? collapseLabel : expandLabel,
+              onClick: () => {
+                setExpandidoInterno(!expandido);
+                onExpand(!expandido);
+              }
             }
           )
         ]
@@ -1735,9 +1836,23 @@ var Select = forwardRef(function Select2({
     input: { className: "cr-select__value" },
     trigger: { className: "cr-field__icon cr-select__trigger", "aria-hidden": true },
     panel: { className: "cr-select__panel" },
+    // Lado da lista (acima ou abaixo do campo), medido logo depois de o Prime posicionar.
+    transition: aoPosicionar(
+      () => seguirLado(
+        document.getElementById(listId)?.closest(".cr-select__panel"),
+        document.getElementById(inputId)?.closest(".cr-select__control")
+      )
+    ),
     wrapper: { className: "cr-select__wrapper" },
     list: { className: "cr-select__list", id: listId },
-    item: { className: "cr-select__item" },
+    // Selecionado e em foco (teclado) pelo contexto do pt, a API pública do Prime (não data-p-*).
+    item: ({ context }) => ({
+      className: [
+        "cr-select__item",
+        context.selected && "cr-select__item--selected",
+        context.focused && "cr-select__item--focused"
+      ].filter(Boolean).join(" ")
+    }),
     emptyMessage: { className: "cr-select__item cr-select__empty" }
   };
   return /* @__PURE__ */ jsxs("div", { className: classes, children: [
@@ -1925,7 +2040,8 @@ var Radio = forwardRef(function Radio2({
         disabled,
         required,
         pt: {
-          root: { className: "cr-radio__control" },
+          // Marcado pela prop do Cristal, não pelo atributo interno do Prime (data-p-checked).
+          root: { className: `cr-radio__control${checked ? " cr-radio__control--checked" : ""}` },
           input: { className: "cr-radio__input" },
           box: { className: "cr-radio__box" },
           icon: { className: "cr-radio__icon" }
@@ -2065,7 +2181,12 @@ var Switch = forwardRef(function Switch2({
         disabled,
         name,
         pt: {
-          root: { className: "cr-switch__control", role: void 0, "aria-checked": void 0 },
+          // Ligado pela prop do Cristal, não pelo atributo interno do Prime (data-p-highlight).
+          root: {
+            className: `cr-switch__control${checked ? " cr-switch__control--checked" : ""}`,
+            role: void 0,
+            "aria-checked": void 0
+          },
           input: { className: "cr-switch__input" },
           slider: { className: "cr-switch__track" }
         }