@codecademy/gamut

Index: package/dist/Popover/types.d.ts
===================================================================
--- package/dist/Popover/types.d.ts
+++ package/dist/Popover/types.d.ts
@@ -29,9 +29,11 @@
      * Which horizontal edge of the source component to align against. Center aligns it centered to the component.
      */
     position?: 'above' | 'below';
     /**
-     * Which side to position the beak. If not provided, beak will not be rendered. Position `center` Popovers can only be used with `center` beaks.
+     * Renders the beak and chooses a centered notch vs a corner notch. For `above` / `below`,
+     * corner beaks follow horizontal `align` (after RTL resolution in `Popover`), not `left` /
+     * `right` here; use `center` for a centered triangle on that edge.
      */
     beak?: 'left' | 'right' | 'center';
     /**
      * Pattern component to use as a background.
@@ -61,9 +63,13 @@
     animation?: 'fade';
     children: React.ReactElement<any>;
     className?: string;
     /**
-     * Which vertical edge of the source component to align against.
+     * Horizontal alignment of the popover relative to the target. When
+     * `GamutProvider`'s `useLogicalProperties` is enabled, `left` and `right` follow the
+     * inline axis (leading/trailing): under RTL they resolve to the physical side that
+     * matches inline-start and inline-end, consistent with `useElementDir` on `targetRef`.
+     * Applies for all `position` values (`above`, `below`, `center`).
      */
     align?: 'left' | 'right' | 'center';
     /**
      * Number of pixels to offset the popover vertically from the source component.