@yahoo/uds-mobile 2.16.0 → 2.18.0

package/dist/components/Toast/utils.cjs

@@ -0,0 +1,69 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/components/Toast/utils.ts
+const DEFAULT_TOAST_AUTO_CLOSE = 6e3;
+const DEFAULT_TOAST_PLACEMENT = "bottom-center";
+const DEFAULT_MAX_VISIBLE_TOASTS = 3;
+const DEFAULT_TOAST_INSETS = {
+	top: 16,
+	bottom: 16,
+	horizontal: 16
+};
+const TOAST_ENTER_ANIMATION_DURATION = 200;
+const TOAST_EXIT_ANIMATION_DURATION = 150;
+const TOAST_ANIMATION_TRANSLATE_OFFSET = 16;
+const TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET = 96;
+const TOAST_SWIPE_DISMISS_TRANSLATION = 50;
+const TOAST_SWIPE_DISMISS_VELOCITY = 500;
+const TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR = .2;
+let toastIdCounter = 0;
+function createToastId() {
+	toastIdCounter += 1;
+	return `toast-${toastIdCounter}`;
+}
+function isPersistentAutoClose(autoClose) {
+	return autoClose === false;
+}
+function isToastShowOptions(input) {
+	return "actionButton" in input || "children" in input || "closeIcon" in input || "closeOnAction" in input || "autoClose" in input || "dismissible" in input || "id" in input || "message" in input || "onActionPress" in input || "onClickActionButton" in input || "onClickCloseButton" in input || "onClose" in input || "onHide" in input || "onShow" in input || "placement" in input || "size" in input || "startIcon" in input || "variant" in input;
+}
+function resolveToastInput(input) {
+	if (input == null || typeof input !== "object") return { message: input };
+	return isToastShowOptions(input) ? input : { message: input };
+}
+function toastReducer(state, action) {
+	switch (action.type) {
+		case "upsert": {
+			const existingIndex = state.findIndex((toast) => toast.id === action.toast.id);
+			if (existingIndex === -1) return [...state, action.toast];
+			const next = [...state];
+			next[existingIndex] = action.toast;
+			return next;
+		}
+		case "update": return state.map((toast) => toast.id === action.id ? {
+			...toast,
+			...action.toast,
+			id: toast.id
+		} : toast);
+		case "remove": return state.filter((toast) => toast.id !== action.id);
+		case "set": return action.toasts;
+		case "removeAll": return [];
+	}
+}
+//#endregion
+exports.DEFAULT_MAX_VISIBLE_TOASTS = DEFAULT_MAX_VISIBLE_TOASTS;
+exports.DEFAULT_TOAST_AUTO_CLOSE = DEFAULT_TOAST_AUTO_CLOSE;
+exports.DEFAULT_TOAST_INSETS = DEFAULT_TOAST_INSETS;
+exports.DEFAULT_TOAST_PLACEMENT = DEFAULT_TOAST_PLACEMENT;
+exports.TOAST_ANIMATION_TRANSLATE_OFFSET = TOAST_ANIMATION_TRANSLATE_OFFSET;
+exports.TOAST_ENTER_ANIMATION_DURATION = TOAST_ENTER_ANIMATION_DURATION;
+exports.TOAST_EXIT_ANIMATION_DURATION = TOAST_EXIT_ANIMATION_DURATION;
+exports.TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET = TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET;
+exports.TOAST_SWIPE_DISMISS_TRANSLATION = TOAST_SWIPE_DISMISS_TRANSLATION;
+exports.TOAST_SWIPE_DISMISS_VELOCITY = TOAST_SWIPE_DISMISS_VELOCITY;
+exports.TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR = TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR;
+exports.createToastId = createToastId;
+exports.isPersistentAutoClose = isPersistentAutoClose;
+exports.isToastShowOptions = isToastShowOptions;
+exports.resolveToastInput = resolveToastInput;
+exports.toastReducer = toastReducer;

package/dist/components/Toast/utils.d.cts

@@ -0,0 +1,27 @@
+
+import { ToastAction, ToastAutoClose, ToastRecord, ToastShowInput } from "./types.cjs";
+
+//#region src/components/Toast/utils.d.ts
+declare const DEFAULT_TOAST_AUTO_CLOSE = 6000;
+declare const DEFAULT_TOAST_PLACEMENT = "bottom-center";
+declare const DEFAULT_MAX_VISIBLE_TOASTS = 3;
+declare const DEFAULT_TOAST_INSETS: {
+  readonly top: 16;
+  readonly bottom: 16;
+  readonly horizontal: 16;
+};
+declare const TOAST_ENTER_ANIMATION_DURATION = 200;
+declare const TOAST_EXIT_ANIMATION_DURATION = 150;
+declare const TOAST_ANIMATION_TRANSLATE_OFFSET = 16;
+declare const TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET = 96;
+declare const TOAST_SWIPE_DISMISS_TRANSLATION = 50;
+declare const TOAST_SWIPE_DISMISS_VELOCITY = 500;
+declare const TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR = 0.2;
+declare function createToastId(): string;
+declare function isPersistentAutoClose(autoClose: ToastAutoClose): autoClose is false;
+declare function isToastShowOptions(input: object): input is Partial<ToastRecord>;
+declare function resolveToastInput(input: ToastShowInput): Partial<ToastRecord>;
+declare function toastReducer(state: ToastRecord[], action: ToastAction): ToastRecord[];
+//#endregion
+export { DEFAULT_MAX_VISIBLE_TOASTS, DEFAULT_TOAST_AUTO_CLOSE, DEFAULT_TOAST_INSETS, DEFAULT_TOAST_PLACEMENT, TOAST_ANIMATION_TRANSLATE_OFFSET, TOAST_ENTER_ANIMATION_DURATION, TOAST_EXIT_ANIMATION_DURATION, TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET, TOAST_SWIPE_DISMISS_TRANSLATION, TOAST_SWIPE_DISMISS_VELOCITY, TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR, createToastId, isPersistentAutoClose, isToastShowOptions, resolveToastInput, toastReducer };
+//# sourceMappingURL=utils.d.cts.map

package/dist/components/Toast/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../../../src/components/Toast/utils.ts"],"mappings":";;;;cAIM,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,0BAAA;AAAA,cACA,oBAAA;EAAA;;;;cAKA,8BAAA;AAAA,cACA,6BAAA;AAAA,cACA,gCAAA;AAAA,cACA,oCAAA;AAAA,cACA,+BAAA;AAAA,cACA,4BAAA;AAAA,cACA,qCAAA;AAAA,iBAIG,aAAA,CAAA;AAAA,iBAKA,qBAAA,CAAsB,SAAA,EAAW,cAAA,GAAiB,SAAA;AAAA,iBAIlD,kBAAA,CAAmB,KAAA,WAAgB,KAAA,IAAS,OAAA,CAAQ,WAAA;AAAA,iBAuBpD,iBAAA,CAAkB,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,WAAA;AAAA,iBAQlD,YAAA,CAAa,KAAA,EAAO,WAAA,IAAe,MAAA,EAAQ,WAAA,GAAc,WAAA"}

package/dist/components/Toast/utils.d.ts

@@ -0,0 +1,27 @@
+
+import { ToastAction, ToastAutoClose, ToastRecord, ToastShowInput } from "./types.js";
+
+//#region src/components/Toast/utils.d.ts
+declare const DEFAULT_TOAST_AUTO_CLOSE = 6000;
+declare const DEFAULT_TOAST_PLACEMENT = "bottom-center";
+declare const DEFAULT_MAX_VISIBLE_TOASTS = 3;
+declare const DEFAULT_TOAST_INSETS: {
+  readonly top: 16;
+  readonly bottom: 16;
+  readonly horizontal: 16;
+};
+declare const TOAST_ENTER_ANIMATION_DURATION = 200;
+declare const TOAST_EXIT_ANIMATION_DURATION = 150;
+declare const TOAST_ANIMATION_TRANSLATE_OFFSET = 16;
+declare const TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET = 96;
+declare const TOAST_SWIPE_DISMISS_TRANSLATION = 50;
+declare const TOAST_SWIPE_DISMISS_VELOCITY = 500;
+declare const TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR = 0.2;
+declare function createToastId(): string;
+declare function isPersistentAutoClose(autoClose: ToastAutoClose): autoClose is false;
+declare function isToastShowOptions(input: object): input is Partial<ToastRecord>;
+declare function resolveToastInput(input: ToastShowInput): Partial<ToastRecord>;
+declare function toastReducer(state: ToastRecord[], action: ToastAction): ToastRecord[];
+//#endregion
+export { DEFAULT_MAX_VISIBLE_TOASTS, DEFAULT_TOAST_AUTO_CLOSE, DEFAULT_TOAST_INSETS, DEFAULT_TOAST_PLACEMENT, TOAST_ANIMATION_TRANSLATE_OFFSET, TOAST_ENTER_ANIMATION_DURATION, TOAST_EXIT_ANIMATION_DURATION, TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET, TOAST_SWIPE_DISMISS_TRANSLATION, TOAST_SWIPE_DISMISS_VELOCITY, TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR, createToastId, isPersistentAutoClose, isToastShowOptions, resolveToastInput, toastReducer };
+//# sourceMappingURL=utils.d.ts.map

package/dist/components/Toast/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../../src/components/Toast/utils.ts"],"mappings":";;;;cAIM,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,0BAAA;AAAA,cACA,oBAAA;EAAA;;;;cAKA,8BAAA;AAAA,cACA,6BAAA;AAAA,cACA,gCAAA;AAAA,cACA,oCAAA;AAAA,cACA,+BAAA;AAAA,cACA,4BAAA;AAAA,cACA,qCAAA;AAAA,iBAIG,aAAA,CAAA;AAAA,iBAKA,qBAAA,CAAsB,SAAA,EAAW,cAAA,GAAiB,SAAA;AAAA,iBAIlD,kBAAA,CAAmB,KAAA,WAAgB,KAAA,IAAS,OAAA,CAAQ,WAAA;AAAA,iBAuBpD,iBAAA,CAAkB,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,WAAA;AAAA,iBAQlD,YAAA,CAAa,KAAA,EAAO,WAAA,IAAe,MAAA,EAAQ,WAAA,GAAc,WAAA"}

package/dist/components/Toast/utils.js

@@ -0,0 +1,55 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+//#region src/components/Toast/utils.ts
+const DEFAULT_TOAST_AUTO_CLOSE = 6e3;
+const DEFAULT_TOAST_PLACEMENT = "bottom-center";
+const DEFAULT_MAX_VISIBLE_TOASTS = 3;
+const DEFAULT_TOAST_INSETS = {
+	top: 16,
+	bottom: 16,
+	horizontal: 16
+};
+const TOAST_ENTER_ANIMATION_DURATION = 200;
+const TOAST_EXIT_ANIMATION_DURATION = 150;
+const TOAST_ANIMATION_TRANSLATE_OFFSET = 16;
+const TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET = 96;
+const TOAST_SWIPE_DISMISS_TRANSLATION = 50;
+const TOAST_SWIPE_DISMISS_VELOCITY = 500;
+const TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR = .2;
+let toastIdCounter = 0;
+function createToastId() {
+	toastIdCounter += 1;
+	return `toast-${toastIdCounter}`;
+}
+function isPersistentAutoClose(autoClose) {
+	return autoClose === false;
+}
+function isToastShowOptions(input) {
+	return "actionButton" in input || "children" in input || "closeIcon" in input || "closeOnAction" in input || "autoClose" in input || "dismissible" in input || "id" in input || "message" in input || "onActionPress" in input || "onClickActionButton" in input || "onClickCloseButton" in input || "onClose" in input || "onHide" in input || "onShow" in input || "placement" in input || "size" in input || "startIcon" in input || "variant" in input;
+}
+function resolveToastInput(input) {
+	if (input == null || typeof input !== "object") return { message: input };
+	return isToastShowOptions(input) ? input : { message: input };
+}
+function toastReducer(state, action) {
+	switch (action.type) {
+		case "upsert": {
+			const existingIndex = state.findIndex((toast) => toast.id === action.toast.id);
+			if (existingIndex === -1) return [...state, action.toast];
+			const next = [...state];
+			next[existingIndex] = action.toast;
+			return next;
+		}
+		case "update": return state.map((toast) => toast.id === action.id ? {
+			...toast,
+			...action.toast,
+			id: toast.id
+		} : toast);
+		case "remove": return state.filter((toast) => toast.id !== action.id);
+		case "set": return action.toasts;
+		case "removeAll": return [];
+	}
+}
+//#endregion
+export { DEFAULT_MAX_VISIBLE_TOASTS, DEFAULT_TOAST_AUTO_CLOSE, DEFAULT_TOAST_INSETS, DEFAULT_TOAST_PLACEMENT, TOAST_ANIMATION_TRANSLATE_OFFSET, TOAST_ENTER_ANIMATION_DURATION, TOAST_EXIT_ANIMATION_DURATION, TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET, TOAST_SWIPE_DISMISS_TRANSLATION, TOAST_SWIPE_DISMISS_VELOCITY, TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR, createToastId, isPersistentAutoClose, isToastShowOptions, resolveToastInput, toastReducer };
+
+//# sourceMappingURL=utils.js.map

package/dist/components/Toast/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../../src/components/Toast/utils.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport type { ToastAction, ToastAutoClose, ToastRecord, ToastShowInput } from './types';\n\nconst DEFAULT_TOAST_AUTO_CLOSE = 6_000;\nconst DEFAULT_TOAST_PLACEMENT = 'bottom-center';\nconst DEFAULT_MAX_VISIBLE_TOASTS = 3;\nconst DEFAULT_TOAST_INSETS = {\n  top: 16,\n  bottom: 16,\n  horizontal: 16,\n} as const;\nconst TOAST_ENTER_ANIMATION_DURATION = 200;\nconst TOAST_EXIT_ANIMATION_DURATION = 150;\nconst TOAST_ANIMATION_TRANSLATE_OFFSET = 16;\nconst TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET = 96;\nconst TOAST_SWIPE_DISMISS_TRANSLATION = 50;\nconst TOAST_SWIPE_DISMISS_VELOCITY = 500;\nconst TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR = 0.2;\n\nlet toastIdCounter = 0;\n\nfunction createToastId(): string {\n  toastIdCounter += 1;\n  return `toast-${toastIdCounter}`;\n}\n\nfunction isPersistentAutoClose(autoClose: ToastAutoClose): autoClose is false {\n  return autoClose === false;\n}\n\nfunction isToastShowOptions(input: object): input is Partial<ToastRecord> {\n  return (\n    'actionButton' in input ||\n    'children' in input ||\n    'closeIcon' in input ||\n    'closeOnAction' in input ||\n    'autoClose' in input ||\n    'dismissible' in input ||\n    'id' in input ||\n    'message' in input ||\n    'onActionPress' in input ||\n    'onClickActionButton' in input ||\n    'onClickCloseButton' in input ||\n    'onClose' in input ||\n    'onHide' in input ||\n    'onShow' in input ||\n    'placement' in input ||\n    'size' in input ||\n    'startIcon' in input ||\n    'variant' in input\n  );\n}\n\nfunction resolveToastInput(input: ToastShowInput): Partial<ToastRecord> {\n  if (input == null || typeof input !== 'object') {\n    return { message: input };\n  }\n\n  return isToastShowOptions(input) ? input : { message: input as ReactNode };\n}\n\nfunction toastReducer(state: ToastRecord[], action: ToastAction): ToastRecord[] {\n  switch (action.type) {\n    case 'upsert': {\n      const existingIndex = state.findIndex((toast) => toast.id === action.toast.id);\n\n      if (existingIndex === -1) {\n        return [...state, action.toast];\n      }\n\n      const next = [...state];\n      next[existingIndex] = action.toast;\n      return next;\n    }\n    case 'update': {\n      return state.map((toast) =>\n        toast.id === action.id ? { ...toast, ...action.toast, id: toast.id } : toast,\n      );\n    }\n    case 'remove': {\n      return state.filter((toast) => toast.id !== action.id);\n    }\n    case 'set': {\n      return action.toasts;\n    }\n    case 'removeAll': {\n      return [];\n    }\n  }\n}\n\nexport {\n  createToastId,\n  DEFAULT_MAX_VISIBLE_TOASTS,\n  DEFAULT_TOAST_AUTO_CLOSE,\n  DEFAULT_TOAST_INSETS,\n  DEFAULT_TOAST_PLACEMENT,\n  isPersistentAutoClose,\n  isToastShowOptions,\n  resolveToastInput,\n  TOAST_ANIMATION_TRANSLATE_OFFSET,\n  TOAST_ENTER_ANIMATION_DURATION,\n  TOAST_EXIT_ANIMATION_DURATION,\n  TOAST_SWIPE_DISMISS_TRANSLATE_OFFSET,\n  TOAST_SWIPE_DISMISS_TRANSLATION,\n  TOAST_SWIPE_DISMISS_VELOCITY,\n  TOAST_SWIPE_OPPOSITE_DIRECTION_FACTOR,\n  toastReducer,\n};\n"],"mappings":";;AAIA,MAAM,2BAA2B;AACjC,MAAM,0BAA0B;AAChC,MAAM,6BAA6B;AACnC,MAAM,uBAAuB;CAC3B,KAAK;CACL,QAAQ;CACR,YAAY;CACb;AACD,MAAM,iCAAiC;AACvC,MAAM,gCAAgC;AACtC,MAAM,mCAAmC;AACzC,MAAM,uCAAuC;AAC7C,MAAM,kCAAkC;AACxC,MAAM,+BAA+B;AACrC,MAAM,wCAAwC;AAE9C,IAAI,iBAAiB;AAErB,SAAS,gBAAwB;CAC/B,kBAAkB;CAClB,OAAO,SAAS;;AAGlB,SAAS,sBAAsB,WAA+C;CAC5E,OAAO,cAAc;;AAGvB,SAAS,mBAAmB,OAA8C;CACxE,OACE,kBAAkB,SAClB,cAAc,SACd,eAAe,SACf,mBAAmB,SACnB,eAAe,SACf,iBAAiB,SACjB,QAAQ,SACR,aAAa,SACb,mBAAmB,SACnB,yBAAyB,SACzB,wBAAwB,SACxB,aAAa,SACb,YAAY,SACZ,YAAY,SACZ,eAAe,SACf,UAAU,SACV,eAAe,SACf,aAAa;;AAIjB,SAAS,kBAAkB,OAA6C;CACtE,IAAI,SAAS,QAAQ,OAAO,UAAU,UACpC,OAAO,EAAE,SAAS,OAAO;CAG3B,OAAO,mBAAmB,MAAM,GAAG,QAAQ,EAAE,SAAS,OAAoB;;AAG5E,SAAS,aAAa,OAAsB,QAAoC;CAC9E,QAAQ,OAAO,MAAf;EACE,KAAK,UAAU;GACb,MAAM,gBAAgB,MAAM,WAAW,UAAU,MAAM,OAAO,OAAO,MAAM,GAAG;GAE9E,IAAI,kBAAkB,IACpB,OAAO,CAAC,GAAG,OAAO,OAAO,MAAM;GAGjC,MAAM,OAAO,CAAC,GAAG,MAAM;GACvB,KAAK,iBAAiB,OAAO;GAC7B,OAAO;;EAET,KAAK,UACH,OAAO,MAAM,KAAK,UAChB,MAAM,OAAO,OAAO,KAAK;GAAE,GAAG;GAAO,GAAG,OAAO;GAAO,IAAI,MAAM;GAAI,GAAG,MACxE;EAEH,KAAK,UACH,OAAO,MAAM,QAAQ,UAAU,MAAM,OAAO,OAAO,GAAG;EAExD,KAAK,OACH,OAAO,OAAO;EAEhB,KAAK,aACH,OAAO,EAAE"}

package/dist/components/internal/Overlay/index.cjs

@@ -1,6 +1,10 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_components_internal_Overlay_OverlayPortal = require("./OverlayPortal.cjs");
+const require_components_internal_Overlay_useAnchoredPosition = require("./useAnchoredPosition.cjs");
 const require_components_internal_Overlay_useControllableState = require("./useControllableState.cjs");
+const require_components_internal_Overlay_useOverlayDismiss = require("./useOverlayDismiss.cjs");
 exports.OverlayPortal = require_components_internal_Overlay_OverlayPortal.OverlayPortal;
+exports.useAnchoredPosition = require_components_internal_Overlay_useAnchoredPosition.useAnchoredPosition;
 exports.useControllableState = require_components_internal_Overlay_useControllableState.useControllableState;
+exports.useOverlayDismiss = require_components_internal_Overlay_useOverlayDismiss.useOverlayDismiss;

package/dist/components/internal/Overlay/index.d.cts

@@ -1,5 +1,7 @@
 
-import { OverlayPortalProps, UseControllableStateProps, UseControllableStateResult } from "./types.cjs";
+import { AnchoredAlign, AnchoredPlacement, AnchoredRect, AnchoredWidth, OverlayInsets, OverlayPortalProps, UseAnchoredPositionProps, UseAnchoredPositionResult, UseControllableStateProps, UseControllableStateResult, UseOverlayDismissProps } from "./types.cjs";
 import { OverlayPortal } from "./OverlayPortal.cjs";
+import { useAnchoredPosition } from "./useAnchoredPosition.cjs";
 import { useControllableState } from "./useControllableState.cjs";
-export { OverlayPortal, type OverlayPortalProps, type UseControllableStateProps, type UseControllableStateResult, useControllableState };
+import { useOverlayDismiss } from "./useOverlayDismiss.cjs";
+export { type AnchoredAlign, type AnchoredPlacement, type AnchoredRect, type AnchoredWidth, type OverlayInsets, OverlayPortal, type OverlayPortalProps, type UseAnchoredPositionProps, type UseAnchoredPositionResult, type UseControllableStateProps, type UseControllableStateResult, type UseOverlayDismissProps, useAnchoredPosition, useControllableState, useOverlayDismiss };

package/dist/components/internal/Overlay/index.d.ts

@@ -1,5 +1,7 @@
 
-import { OverlayPortalProps, UseControllableStateProps, UseControllableStateResult } from "./types.js";
+import { AnchoredAlign, AnchoredPlacement, AnchoredRect, AnchoredWidth, OverlayInsets, OverlayPortalProps, UseAnchoredPositionProps, UseAnchoredPositionResult, UseControllableStateProps, UseControllableStateResult, UseOverlayDismissProps } from "./types.js";
 import { OverlayPortal } from "./OverlayPortal.js";
+import { useAnchoredPosition } from "./useAnchoredPosition.js";
 import { useControllableState } from "./useControllableState.js";
-export { OverlayPortal, type OverlayPortalProps, type UseControllableStateProps, type UseControllableStateResult, useControllableState };
+import { useOverlayDismiss } from "./useOverlayDismiss.js";
+export { type AnchoredAlign, type AnchoredPlacement, type AnchoredRect, type AnchoredWidth, type OverlayInsets, OverlayPortal, type OverlayPortalProps, type UseAnchoredPositionProps, type UseAnchoredPositionResult, type UseControllableStateProps, type UseControllableStateResult, type UseOverlayDismissProps, useAnchoredPosition, useControllableState, useOverlayDismiss };

package/dist/components/internal/Overlay/index.js

@@ -1,4 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
 import { OverlayPortal } from "./OverlayPortal.js";
+import { useAnchoredPosition } from "./useAnchoredPosition.js";
 import { useControllableState } from "./useControllableState.js";
-export { OverlayPortal, useControllableState };
+import { useOverlayDismiss } from "./useOverlayDismiss.js";
+export { OverlayPortal, useAnchoredPosition, useControllableState, useOverlayDismiss };

package/dist/components/internal/Overlay/types.d.cts

@@ -1,5 +1,6 @@
 
 import { Dispatch, ReactNode, SetStateAction } from "react";
+import { StyleProp, ViewStyle } from "react-native";
 
 //#region src/components/internal/Overlay/types.d.ts
 interface OverlayPortalProps {
@@ -16,6 +17,51 @@ interface UseControllableStateProps<T> {
   onChange?: (value: T) => void;
 }
 type UseControllableStateResult<T> = [T, Dispatch<SetStateAction<T>>];
+type AnchoredPlacement = 'top' | 'bottom' | 'start' | 'end' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'start-top' | 'start-bottom' | 'end-top' | 'end-bottom';
+type AnchoredAlign = 'start' | 'center' | 'end';
+type AnchoredWidth = 'content' | 'trigger' | 'full' | number;
+interface AnchoredRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+interface OverlayInsets {
+  top?: number;
+  right?: number;
+  bottom?: number;
+  left?: number;
+}
+interface UseAnchoredPositionProps {
+  triggerRect: AnchoredRect | null;
+  contentSize: {
+    width: number;
+    height: number;
+  };
+  placement?: AnchoredPlacement;
+  align?: AnchoredAlign;
+  offset?: number;
+  alignOffset?: number;
+  avoidCollisions?: boolean;
+  collisionPadding?: number;
+  width?: AnchoredWidth;
+  sameWidth?: boolean;
+  insets?: OverlayInsets;
+  arrowWidth?: number;
+  arrowHeight?: number;
+}
+interface UseAnchoredPositionResult {
+  resolvedPlacement: AnchoredPlacement;
+  contentStyle: StyleProp<ViewStyle>;
+  arrowStyle: StyleProp<ViewStyle>;
+  anchorReady: boolean;
+  maxWidth: number;
+}
+interface UseOverlayDismissProps {
+  open: boolean;
+  dismissible?: boolean;
+  onDismiss: () => void;
+}
 //#endregion
-export { type OverlayPortalProps, type UseControllableStateProps, type UseControllableStateResult };
+export { type AnchoredAlign, type AnchoredPlacement, type AnchoredRect, type AnchoredWidth, type OverlayInsets, type OverlayPortalProps, type UseAnchoredPositionProps, type UseAnchoredPositionResult, type UseControllableStateProps, type UseControllableStateResult, type UseOverlayDismissProps };
 //# sourceMappingURL=types.d.cts.map

package/dist/components/internal/Overlay/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/components/internal/Overlay/types.ts"],"mappings":";;;;UAEU,kBAAA;EACR,QAAA,EAAU,SAAA;EADF;;;;EAMR,oBAAA;AAAA;AAAA,UAGQ,yBAAA;EACR,KAAA,GAAQ,CAAA;EACR,YAAA,EAAc,CAAA,UAAW,CAAA;EACzB,QAAA,IAAY,KAAA,EAAO,CAAA;AAAA;AAAA,KAGhB,0BAAA,OAAiC,CAAA,EAAG,QAAA,CAAS,cAAA,CAAe,CAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/components/internal/Overlay/types.ts"],"mappings":";;;;;UAGU,kBAAA;EACR,QAAA,EAAU,SAAA;EADF;;;;EAMR,oBAAA;AAAA;AAAA,UAGQ,yBAAA;EACR,KAAA,GAAQ,CAAA;EACR,YAAA,EAAc,CAAA,UAAW,CAAA;EACzB,QAAA,IAAY,KAAA,EAAO,CAAA;AAAA;AAAA,KAGhB,0BAAA,OAAiC,CAAA,EAAG,QAAA,CAAS,cAAA,CAAe,CAAA;AAAA,KAE5D,iBAAA;AAAA,KAcA,aAAA;AAAA,KAEA,aAAA;AAAA,UAEK,YAAA;EACR,CAAA;EACA,CAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGQ,aAAA;EACR,GAAA;EACA,KAAA;EACA,MAAA;EACA,IAAA;AAAA;AAAA,UAGQ,wBAAA;EACR,WAAA,EAAa,YAAA;EACb,WAAA;IAAe,KAAA;IAAe,MAAA;EAAA;EAC9B,SAAA,GAAY,iBAAA;EACZ,KAAA,GAAQ,aAAA;EACR,MAAA;EACA,WAAA;EACA,eAAA;EACA,gBAAA;EACA,KAAA,GAAQ,aAAA;EACR,SAAA;EACA,MAAA,GAAS,aAAA;EACT,UAAA;EACA,WAAA;AAAA;AAAA,UAGQ,yBAAA;EACR,iBAAA,EAAmB,iBAAA;EACnB,YAAA,EAAc,SAAA,CAAU,SAAA;EACxB,UAAA,EAAY,SAAA,CAAU,SAAA;EACtB,WAAA;EACA,QAAA;AAAA;AAAA,UAGQ,sBAAA;EACR,IAAA;EACA,WAAA;EACA,SAAA;AAAA"}

package/dist/components/internal/Overlay/types.d.ts

@@ -1,5 +1,6 @@
 
 import { Dispatch, ReactNode, SetStateAction } from "react";
+import { StyleProp, ViewStyle } from "react-native";
 
 //#region src/components/internal/Overlay/types.d.ts
 interface OverlayPortalProps {
@@ -16,6 +17,51 @@ interface UseControllableStateProps<T> {
   onChange?: (value: T) => void;
 }
 type UseControllableStateResult<T> = [T, Dispatch<SetStateAction<T>>];
+type AnchoredPlacement = 'top' | 'bottom' | 'start' | 'end' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'start-top' | 'start-bottom' | 'end-top' | 'end-bottom';
+type AnchoredAlign = 'start' | 'center' | 'end';
+type AnchoredWidth = 'content' | 'trigger' | 'full' | number;
+interface AnchoredRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+interface OverlayInsets {
+  top?: number;
+  right?: number;
+  bottom?: number;
+  left?: number;
+}
+interface UseAnchoredPositionProps {
+  triggerRect: AnchoredRect | null;
+  contentSize: {
+    width: number;
+    height: number;
+  };
+  placement?: AnchoredPlacement;
+  align?: AnchoredAlign;
+  offset?: number;
+  alignOffset?: number;
+  avoidCollisions?: boolean;
+  collisionPadding?: number;
+  width?: AnchoredWidth;
+  sameWidth?: boolean;
+  insets?: OverlayInsets;
+  arrowWidth?: number;
+  arrowHeight?: number;
+}
+interface UseAnchoredPositionResult {
+  resolvedPlacement: AnchoredPlacement;
+  contentStyle: StyleProp<ViewStyle>;
+  arrowStyle: StyleProp<ViewStyle>;
+  anchorReady: boolean;
+  maxWidth: number;
+}
+interface UseOverlayDismissProps {
+  open: boolean;
+  dismissible?: boolean;
+  onDismiss: () => void;
+}
 //#endregion
-export { type OverlayPortalProps, type UseControllableStateProps, type UseControllableStateResult };
+export { type AnchoredAlign, type AnchoredPlacement, type AnchoredRect, type AnchoredWidth, type OverlayInsets, type OverlayPortalProps, type UseAnchoredPositionProps, type UseAnchoredPositionResult, type UseControllableStateProps, type UseControllableStateResult, type UseOverlayDismissProps };
 //# sourceMappingURL=types.d.ts.map

package/dist/components/internal/Overlay/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/components/internal/Overlay/types.ts"],"mappings":";;;;UAEU,kBAAA;EACR,QAAA,EAAU,SAAA;EADF;;;;EAMR,oBAAA;AAAA;AAAA,UAGQ,yBAAA;EACR,KAAA,GAAQ,CAAA;EACR,YAAA,EAAc,CAAA,UAAW,CAAA;EACzB,QAAA,IAAY,KAAA,EAAO,CAAA;AAAA;AAAA,KAGhB,0BAAA,OAAiC,CAAA,EAAG,QAAA,CAAS,cAAA,CAAe,CAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/components/internal/Overlay/types.ts"],"mappings":";;;;;UAGU,kBAAA;EACR,QAAA,EAAU,SAAA;EADF;;;;EAMR,oBAAA;AAAA;AAAA,UAGQ,yBAAA;EACR,KAAA,GAAQ,CAAA;EACR,YAAA,EAAc,CAAA,UAAW,CAAA;EACzB,QAAA,IAAY,KAAA,EAAO,CAAA;AAAA;AAAA,KAGhB,0BAAA,OAAiC,CAAA,EAAG,QAAA,CAAS,cAAA,CAAe,CAAA;AAAA,KAE5D,iBAAA;AAAA,KAcA,aAAA;AAAA,KAEA,aAAA;AAAA,UAEK,YAAA;EACR,CAAA;EACA,CAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGQ,aAAA;EACR,GAAA;EACA,KAAA;EACA,MAAA;EACA,IAAA;AAAA;AAAA,UAGQ,wBAAA;EACR,WAAA,EAAa,YAAA;EACb,WAAA;IAAe,KAAA;IAAe,MAAA;EAAA;EAC9B,SAAA,GAAY,iBAAA;EACZ,KAAA,GAAQ,aAAA;EACR,MAAA;EACA,WAAA;EACA,eAAA;EACA,gBAAA;EACA,KAAA,GAAQ,aAAA;EACR,SAAA;EACA,MAAA,GAAS,aAAA;EACT,UAAA;EACA,WAAA;AAAA;AAAA,UAGQ,yBAAA;EACR,iBAAA,EAAmB,iBAAA;EACnB,YAAA,EAAc,SAAA,CAAU,SAAA;EACxB,UAAA,EAAY,SAAA,CAAU,SAAA;EACtB,WAAA;EACA,QAAA;AAAA;AAAA,UAGQ,sBAAA;EACR,IAAA;EACA,WAAA;EACA,SAAA;AAAA"}

package/dist/components/internal/Overlay/useAnchoredPosition.cjs

@@ -0,0 +1,225 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+let react = require("react");
+let react_native = require("react-native");
+let react_native_safe_area_context = require("react-native-safe-area-context");
+//#region src/components/internal/Overlay/useAnchoredPosition.ts
+const DEFAULT_COLLISION_PADDING = 12;
+const DEFAULT_OFFSET = 9;
+const DEFAULT_ARROW_WIDTH = 22;
+const DEFAULT_ARROW_HEIGHT = 12;
+const DEFAULT_ARROW_BASELINE_INSET = 1;
+function clamp(value, min, max) {
+	if (max < min) return min;
+	return Math.min(Math.max(value, min), max);
+}
+function resolveLogicalSide(side) {
+	return {
+		top: "top",
+		bottom: "bottom",
+		start: react_native.I18nManager.isRTL ? "right" : "left",
+		end: react_native.I18nManager.isRTL ? "left" : "right"
+	}[side];
+}
+function getOppositeSide(side) {
+	switch (side) {
+		case "top": return "bottom";
+		case "bottom": return "top";
+		case "left": return "right";
+		case "right": return "left";
+	}
+}
+function formatPlacement(side, align) {
+	const logicalSide = {
+		top: "top",
+		bottom: "bottom",
+		left: react_native.I18nManager.isRTL ? "end" : "start",
+		right: react_native.I18nManager.isRTL ? "start" : "end"
+	}[side];
+	if (align === "center") return logicalSide;
+	if (side === "top" || side === "bottom") return `${logicalSide}-${align}`;
+	return `${logicalSide}-${align === "start" ? "top" : "bottom"}`;
+}
+function parsePlacement(placement, alignOverride) {
+	const [rawSide, rawAlign] = placement.split("-");
+	const side = resolveLogicalSide(rawSide);
+	if (alignOverride) return {
+		side,
+		align: alignOverride
+	};
+	if (!rawAlign) return {
+		side,
+		align: "center"
+	};
+	if (rawAlign === "top") return {
+		side,
+		align: "start"
+	};
+	if (rawAlign === "bottom") return {
+		side,
+		align: "end"
+	};
+	return {
+		side,
+		align: rawAlign
+	};
+}
+function getContentSize(triggerRect, contentSize, maxWidth, sameWidth, width) {
+	const resolvedWidth = sameWidth || width === "trigger" ? triggerRect.width : width === "full" ? maxWidth : typeof width === "number" ? width : contentSize.width || triggerRect.width;
+	return {
+		width: Math.min(resolvedWidth, maxWidth),
+		height: contentSize.height
+	};
+}
+function getCoordinate({ align, alignOffset, contentLength, triggerLength, triggerStart }) {
+	if (align === "start") return triggerStart + alignOffset;
+	if (align === "end") return triggerStart + triggerLength - contentLength + alignOffset;
+	return triggerStart + triggerLength / 2 - contentLength / 2 + alignOffset;
+}
+function getRawPosition({ align, alignOffset, contentHeight, contentWidth, offset, side, triggerRect }) {
+	if (side === "top" || side === "bottom") return {
+		left: getCoordinate({
+			align,
+			alignOffset,
+			contentLength: contentWidth,
+			triggerLength: triggerRect.width,
+			triggerStart: triggerRect.x
+		}),
+		top: side === "top" ? triggerRect.y - contentHeight - offset : triggerRect.y + triggerRect.height + offset
+	};
+	return {
+		left: side === "left" ? triggerRect.x - contentWidth - offset : triggerRect.x + triggerRect.width + offset,
+		top: getCoordinate({
+			align,
+			alignOffset,
+			contentLength: contentHeight,
+			triggerLength: triggerRect.height,
+			triggerStart: triggerRect.y
+		})
+	};
+}
+function shouldFlip({ contentHeight, contentWidth, maxBottom, maxRight, minLeft, minTop, side, triggerRect, windowHeight, windowWidth }) {
+	if (side === "top") return triggerRect.y - contentHeight < minTop && windowHeight - (triggerRect.y + triggerRect.height) > triggerRect.y;
+	if (side === "bottom") return triggerRect.y + triggerRect.height + contentHeight > maxBottom && triggerRect.y > windowHeight - (triggerRect.y + triggerRect.height);
+	if (side === "left") return triggerRect.x - contentWidth < minLeft && windowWidth - (triggerRect.x + triggerRect.width) > triggerRect.x;
+	return triggerRect.x + triggerRect.width + contentWidth > maxRight && triggerRect.x > windowWidth - (triggerRect.x + triggerRect.width);
+}
+function getArrowPosition({ arrowHeight, arrowWidth, contentHeight, contentLeft, contentTop, contentWidth, side, triggerRect }) {
+	const arrowBase = {
+		position: "absolute",
+		zIndex: 2
+	};
+	if (side === "top" || side === "bottom") {
+		const left = clamp(triggerRect.x + triggerRect.width / 2 - contentLeft - arrowWidth / 2, arrowHeight, contentWidth - arrowWidth - arrowHeight);
+		return {
+			...arrowBase,
+			width: arrowWidth,
+			height: arrowHeight,
+			left,
+			...side === "top" ? { bottom: -arrowHeight + DEFAULT_ARROW_BASELINE_INSET } : { top: -arrowHeight + DEFAULT_ARROW_BASELINE_INSET }
+		};
+	}
+	const top = clamp(triggerRect.y + triggerRect.height / 2 - contentTop - arrowWidth / 2, arrowHeight, contentHeight - arrowWidth - arrowHeight);
+	return {
+		...arrowBase,
+		width: arrowHeight,
+		height: arrowWidth,
+		top,
+		...side === "left" ? { right: -arrowHeight + DEFAULT_ARROW_BASELINE_INSET } : { left: -arrowHeight + DEFAULT_ARROW_BASELINE_INSET }
+	};
+}
+function useAnchoredPosition({ triggerRect, contentSize, placement = "bottom", align, offset = DEFAULT_OFFSET, alignOffset = 0, avoidCollisions = true, collisionPadding = DEFAULT_COLLISION_PADDING, width = "content", sameWidth = false, insets, arrowWidth, arrowHeight }) {
+	const windowDimensions = (0, react_native.useWindowDimensions)();
+	const safeAreaInsets = (0, react_native_safe_area_context.useSafeAreaInsets)();
+	const resolvedArrowWidth = arrowWidth ?? DEFAULT_ARROW_WIDTH;
+	const resolvedArrowHeight = arrowHeight ?? DEFAULT_ARROW_HEIGHT;
+	return (0, react.useMemo)(() => {
+		const fallbackPlacement = placement;
+		const maxWidth = windowDimensions.width - (insets?.left ?? safeAreaInsets.left) - (insets?.right ?? safeAreaInsets.right) - collisionPadding * 2;
+		if (!triggerRect) return {
+			resolvedPlacement: fallbackPlacement,
+			contentStyle: {
+				position: "absolute",
+				left: collisionPadding,
+				top: (insets?.top ?? safeAreaInsets.top) + collisionPadding,
+				maxWidth,
+				opacity: 0
+			},
+			arrowStyle: { opacity: 0 },
+			anchorReady: false,
+			maxWidth
+		};
+		const minLeft = (insets?.left ?? safeAreaInsets.left) + collisionPadding;
+		const minTop = (insets?.top ?? safeAreaInsets.top) + collisionPadding;
+		const maxRight = windowDimensions.width - (insets?.right ?? safeAreaInsets.right) - collisionPadding;
+		const maxBottom = windowDimensions.height - (insets?.bottom ?? safeAreaInsets.bottom) - collisionPadding;
+		const { width: contentWidth, height: contentHeight } = getContentSize(triggerRect, contentSize, maxWidth, sameWidth, width);
+		const placementParts = parsePlacement(placement, align);
+		let { side } = placementParts;
+		const resolvedAlign = placementParts.align;
+		if (avoidCollisions && shouldFlip({
+			contentHeight,
+			contentWidth,
+			maxBottom,
+			maxRight,
+			minLeft,
+			minTop,
+			side,
+			triggerRect,
+			windowHeight: windowDimensions.height,
+			windowWidth: windowDimensions.width
+		})) side = getOppositeSide(side);
+		const rawPosition = getRawPosition({
+			align: resolvedAlign,
+			alignOffset,
+			contentHeight,
+			contentWidth,
+			offset,
+			side,
+			triggerRect
+		});
+		const left = clamp(rawPosition.left, minLeft, maxRight - contentWidth);
+		const top = clamp(rawPosition.top, minTop, maxBottom - contentHeight);
+		return {
+			resolvedPlacement: formatPlacement(side, resolvedAlign),
+			contentStyle: {
+				position: "absolute",
+				left,
+				top,
+				width: sameWidth || width !== "content" ? contentWidth : void 0,
+				maxWidth
+			},
+			arrowStyle: getArrowPosition({
+				arrowHeight: resolvedArrowHeight,
+				arrowWidth: resolvedArrowWidth,
+				contentHeight,
+				contentLeft: left,
+				contentTop: top,
+				contentWidth,
+				side,
+				triggerRect
+			}),
+			anchorReady: true,
+			maxWidth
+		};
+	}, [
+		align,
+		alignOffset,
+		avoidCollisions,
+		collisionPadding,
+		contentSize,
+		insets,
+		offset,
+		placement,
+		resolvedArrowHeight,
+		resolvedArrowWidth,
+		safeAreaInsets,
+		sameWidth,
+		triggerRect,
+		width,
+		windowDimensions
+	]);
+}
+//#endregion
+exports.useAnchoredPosition = useAnchoredPosition;

package/dist/components/internal/Overlay/useAnchoredPosition.d.cts

@@ -0,0 +1,22 @@
+
+import { UseAnchoredPositionProps, UseAnchoredPositionResult } from "./types.cjs";
+
+//#region src/components/internal/Overlay/useAnchoredPosition.d.ts
+declare function useAnchoredPosition({
+  triggerRect,
+  contentSize,
+  placement,
+  align,
+  offset,
+  alignOffset,
+  avoidCollisions,
+  collisionPadding,
+  width,
+  sameWidth,
+  insets,
+  arrowWidth,
+  arrowHeight
+}: UseAnchoredPositionProps): UseAnchoredPositionResult;
+//#endregion
+export { useAnchoredPosition };
+//# sourceMappingURL=useAnchoredPosition.d.cts.map

package/dist/components/internal/Overlay/useAnchoredPosition.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnchoredPosition.d.cts","names":[],"sources":["../../../../src/components/internal/Overlay/useAnchoredPosition.ts"],"mappings":";;;;iBAsTS,mBAAA,CAAA;EACP,WAAA;EACA,WAAA;EACA,SAAA;EACA,KAAA;EACA,MAAA;EACA,WAAA;EACA,eAAA;EACA,gBAAA;EACA,KAAA;EACA,SAAA;EACA,MAAA;EACA,UAAA;EACA;AAAA,GACC,wBAAA,GAA2B,yBAAA"}

package/dist/components/internal/Overlay/useAnchoredPosition.d.ts

@@ -0,0 +1,22 @@
+
+import { UseAnchoredPositionProps, UseAnchoredPositionResult } from "./types.js";
+
+//#region src/components/internal/Overlay/useAnchoredPosition.d.ts
+declare function useAnchoredPosition({
+  triggerRect,
+  contentSize,
+  placement,
+  align,
+  offset,
+  alignOffset,
+  avoidCollisions,
+  collisionPadding,
+  width,
+  sameWidth,
+  insets,
+  arrowWidth,
+  arrowHeight
+}: UseAnchoredPositionProps): UseAnchoredPositionResult;
+//#endregion
+export { useAnchoredPosition };
+//# sourceMappingURL=useAnchoredPosition.d.ts.map

package/dist/components/internal/Overlay/useAnchoredPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnchoredPosition.d.ts","names":[],"sources":["../../../../src/components/internal/Overlay/useAnchoredPosition.ts"],"mappings":";;;;iBAsTS,mBAAA,CAAA;EACP,WAAA;EACA,WAAA;EACA,SAAA;EACA,KAAA;EACA,MAAA;EACA,WAAA;EACA,eAAA;EACA,gBAAA;EACA,KAAA;EACA,SAAA;EACA,MAAA;EACA,UAAA;EACA;AAAA,GACC,wBAAA,GAA2B,yBAAA"}