@muraldevkit/ui-toolkit 4.67.0-dev-OdGN.1 → 4.67.0-dev-Vc0V.1

package/dist/components/tooltip/MrlTooltip/MrlTooltip.d.ts

@@ -45,7 +45,13 @@ interface MrlTooltipProps {
 /**
  * MrlTooltip Component
  *
- * This component is not displayed when rendering this component if the primary pointing device can’t hover. Examples include touchscreens and screens that use a basic drawing stylus.
+ * Placement is handled entirely by CSS Anchor Positioning: the trigger exposes an
+ * `anchor-name` and the portaled tooltip (`.mrl-tooltip-positioner`) attaches to it via
+ * `position-anchor`/`position-area`, flipping near viewport edges via `position-try-fallbacks`.
+ * Older browsers are covered by the `@oddbird/css-anchor-positioning` polyfill (see
+ * `polyfill.ts`). This component owns only show/hide, hover, keyboard and accessibility.
+ *
+ * This component is not displayed when the primary pointing device can’t hover. Examples include touchscreens and screens that use a basic drawing stylus.
  * Pointing devices that can hover, but for which doing so is inconvenient and not part of the normal way they are used, also match this criteria. For example, a touchscreen where a long press is treated as hovering.
  * @param {MrlTooltipProps} props - The props of the component
  * @returns {HTMLElement} a configured Tooltip component

package/dist/components/tooltip/MrlTooltipContent/MrlTooltipContent.d.ts

@@ -1,14 +1,8 @@
 import * as React from 'react';
 import { AttrsObject } from '../../../utils';
-import { MrlTooltipAnchor, MrlTooltipPosition, MrlTooltipVariant } from '../constants';
+import { MrlTooltipVariant } from '../constants';
 import './MrlTooltipContent.global.scss';
 interface MrlTooltipContentProps {
-    /**
-     * The arrow position of the tooltip in relation to its trigger's content.
-     * Note, if the content is shorter than the width of the trigger, always use
-     * "center" to ensure the arrow does not become misaligned.
-     */
-    anchor: MrlTooltipAnchor;
     /**
      * Attributes that are applied to the component during the initial render.
      *
@@ -22,8 +16,6 @@ interface MrlTooltipContentProps {
     kind: MrlTooltipVariant;
     /** The id of the tooltip used for aria-describedby in the parent component */
     id?: string;
-    /** The placement of the tooltip in relation to its trigger */
-    position: MrlTooltipPosition;
     /** The tooltip content to display */
     text: string;
     /** A class to be applied ot the tooltip content */
@@ -35,6 +27,8 @@ interface MrlTooltipContentProps {
  * MrlTooltipContent Component
  *
  * The tooltip content is the text that is displayed when the user hovers over the trigger.
+ * Placement (position/anchor) is owned by the `.mrl-tooltip-positioner` ancestor via CSS
+ * anchor positioning, so this component only renders the visual box + hover bridge.
  * IMPORTANT: This component is not intended to be used directly, it should always be a child of MrlTooltip.
  * @param {MrlTooltipContentProps} props - the props of the tooltip content
  * @returns {HTMLElement} a configured Tooltip Content component

package/dist/components/tooltip/anchorPositioningPolyfill.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CSS Anchor Positioning polyfill loader.
+ *
+ * The tooltip positions itself with native CSS Anchor Positioning. On browsers
+ * that lack native support we lazy-load the Oddbird polyfill and run a
+ * positioning pass. The dynamic import keeps the polyfill out of the bundle for
+ * browsers that support anchor positioning natively.
+ *
+ * The polyfill implements Level 1 only, so it does not flip the arrow — matching
+ * the progressive-enhancement decision for native browsers as well.
+ */
+/**
+ * Ensure anchored tooltips are positioned on browsers without native support.
+ * No-op where anchor positioning is supported. Safe to call on every tooltip
+ * open — the polyfill module is fetched once, then re-run to position the
+ * newly-shown tooltip. Failures are swallowed so a polyfill hiccup never breaks
+ * the trigger.
+ */
+export declare const ensureAnchorPositioningPolyfill: () => Promise<void>;