blend-native 0.0.1-beta.0

package/lib/module/components/shared/group.js

@@ -0,0 +1,68 @@
+"use strict";
+
+/**
+ * Shared styling for grouped controls (button groups, tag groups).
+ *
+ * Members join edge to edge, so each keeps its radius only on the outward
+ * corners, and interior members drop the borders they would otherwise double
+ * up with their neighbour. Web implements the radius half identically in
+ * `ButtonV2/utils.ts` and `TagV2/utils.ts`, and the border half in
+ * `ButtonV2/utils.ts` (`getButtonBorderStyles`).
+ *
+ * Mirrors `components/shared/` in the web package, which holds cross-component
+ * internals rather than components.
+ */
+
+/** Where a control sits within its group. `undefined` means ungrouped. */
+
+/** Every corner squared — the interior members of a group. */
+const ALL_SQUARE = '0px 0px 0px 0px';
+
+/**
+ * Collapse a control's border radius for its position in a group.
+ *
+ * Returns a CSS string — either the untouched radius or a four-corner
+ * shorthand in CSS order (top-left, top-right, bottom-right, bottom-left).
+ * `parseBorderRadius` handles both forms.
+ *
+ * ```
+ * getGroupedBorderRadius('10px', undefined) -> '10px'
+ * getGroupedBorderRadius('10px', 'left')    -> '10px 0 0 10px'
+ * getGroupedBorderRadius('10px', 'right')   -> '0 10px 10px 0'
+ * getGroupedBorderRadius('10px', 'center')  -> '0px 0px 0px 0px'
+ * ```
+ */
+export function getGroupedBorderRadius(radius, position) {
+  const value = String(radius);
+  if (position === undefined) return value;
+  if (position === 'left') return `${value} 0 0 ${value}`;
+  if (position === 'right') return `0 ${value} ${value} 0`;
+  return ALL_SQUARE;
+}
+
+/**
+ * Border widths to overlay for a control's position in a group.
+ *
+ * Interior (`center`) members drop their left and right borders so a shared
+ * edge is one line wide rather than two. Web does this in
+ * `getButtonBorderStyles`, which sets `borderLeft`/`borderRight` to `'none'`
+ * for the centre position and leaves the end caps fully bordered.
+ *
+ * Returned as a `ViewStyle` fragment to spread *after* the resolved surface,
+ * so `borderWidth: 1` still applies to the remaining sides.
+ *
+ * ```
+ * getGroupedBorderWidths(undefined) -> {}
+ * getGroupedBorderWidths('left')    -> {}
+ * getGroupedBorderWidths('right')   -> {}
+ * getGroupedBorderWidths('center')  -> { borderLeftWidth: 0, borderRightWidth: 0 }
+ * ```
+ */
+export function getGroupedBorderWidths(position) {
+  if (position !== 'center') return {};
+  return {
+    borderLeftWidth: 0,
+    borderRightWidth: 0
+  };
+}
+//# sourceMappingURL=group.js.map

package/lib/module/components/shared/group.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ALL_SQUARE","getGroupedBorderRadius","radius","position","value","String","undefined","getGroupedBorderWidths","borderLeftWidth","borderRightWidth"],"sourceRoot":"../../../../src","sources":["components/shared/group.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAGA;AACA,MAAMA,UAAU,GAAG,iBAAiB;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAClCC,MAAuB,EACvBC,QAAmC,EAC7B;EACN,MAAMC,KAAK,GAAGC,MAAM,CAACH,MAAM,CAAC;EAE5B,IAAIC,QAAQ,KAAKG,SAAS,EAAE,OAAOF,KAAK;EACxC,IAAID,QAAQ,KAAK,MAAM,EAAE,OAAO,GAAGC,KAAK,QAAQA,KAAK,EAAE;EACvD,IAAID,QAAQ,KAAK,OAAO,EAAE,OAAO,KAAKC,KAAK,IAAIA,KAAK,IAAI;EAExD,OAAOJ,UAAU;AACrB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,sBAAsBA,CAClCJ,QAAmC,EACoB;EACvD,IAAIA,QAAQ,KAAK,QAAQ,EAAE,OAAO,CAAC,CAAC;EACpC,OAAO;IAAEK,eAAe,EAAE,CAAC;IAAEC,gBAAgB,EAAE;EAAE,CAAC;AACtD","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,80 @@
+"use strict";
+
+/**
+ * blend-native — React Native components for Blend Design System.
+ *
+ * Consumes Blend's token system via the React-free
+ * `@juspay/blend-design-system/node` entry and translates CSS-string token
+ * values into RN style objects.
+ *
+ * No `styled-components`, no DOM, no `window.addEventListener`.
+ *
+ * ---
+ *
+ * This barrel is the package's **public API**, and everything named here is a
+ * semver commitment. Low-level internals — the CSS-string parsers, the surface
+ * resolver, the token registry, the grouped-control helpers — are deliberately
+ * NOT exported: they exist to serve the primitives, their shapes will change as
+ * more components land, and `Block` / `Pressable` already expose everything a
+ * consumer needs to build a token-driven surface of their own.
+ */
+
+// ---- Components ---------------------------------------------------------
+export { Alert } from "./components/Alert/index.js";
+export { Button } from "./components/Button/index.js";
+export { Tag } from "./components/Tag/index.js";
+export { TextInput } from "./components/TextInput/index.js";
+export { Skeleton } from "./components/Skeleton/index.js";
+// ---- Theming ------------------------------------------------------------
+export { BlendNativeProvider, BlendNativeThemeContext, DEFAULT_NATIVE_THEME } from "./theme/BlendNativeProvider.js";
+/** Pass `theme={SYSTEM_THEME}` (or `theme="system"`) to follow the OS. */
+export { SYSTEM_THEME } from "./theme/systemTheme.js";
+export { useNativeTokens } from "./theme/useNativeTokens.js";
+export { useNativeBreakpoint } from "./theme/useNativeBreakpoint.js";
+// ---- Primitives ---------------------------------------------------------
+// Exported so consumers can compose token-driven surfaces of their own.
+export { Block } from "./primitives/Block.js";
+export { Pressable } from "./primitives/Pressable.js";
+export { Text } from "./primitives/Text.js";
+export { Slot } from "./primitives/Slot.js";
+export { Separator } from "./primitives/Separator.js";
+export { PrimitiveInput } from "./primitives/PrimitiveInput.js";
+
+// The shared base both `Block` and `Pressable` accept — needed to type a
+// wrapper around either.
+
+/**
+ * The minimum tap target `Pressable` enforces via `hitSlop`, in points.
+ * Exposed so consumers can reason about it; pass `minTouchTarget={0}` to opt
+ * a control out.
+ */
+export { MIN_TOUCH_TARGET } from "./primitives/touchTarget.js";
+
+// ---- Overlay & motion ---------------------------------------------------
+// `Portal` renders content into the provider's overlay layer (above the
+// app), and `useReduceMotion` mirrors web's prefers-reduced-motion. The
+// positioning engine and motion presets stay internal until the overlay
+// components stabilise their shapes.
+export { Portal } from "./overlay/portal.js";
+export { useReduceMotion } from "./motion/useReduceMotion.js";
+
+// The gesture-driven sheet foundation — DrawerV2 and the phone modes of
+// Select/Menu/Modal compose it; also public for consumer-built sheets.
+export { BottomSheet } from "./overlay/sheet/BottomSheet.js";
+// The toast host: the provider mounts the outlet, this pair drives it.
+// SnackbarV2 will layer token styling on top when it lands.
+export { showToast, dismissToast } from "./overlay/toast/toastStore.js";
+
+/** Position of a control within a button or tag group. */
+
+// ---- Enums --------------------------------------------------------------
+// Re-exported with cleaner native names (no "V2" suffix). The underlying
+// values are the same string constants, so they are interchangeable with the
+// web enums at runtime.
+/**
+ * Announce a status message to assistive tech. Exposed for consumers building
+ * their own status surfaces; `Alert` uses it internally.
+ */
+export { useLiveRegionAnnounce } from "./a11y/useLiveRegion.js";
+export { AlertV2Type as AlertType, AlertV2SubType as AlertSubType, AlertV2ActionPosition as AlertActionPosition, ButtonV2Type as ButtonType, ButtonV2Size as ButtonSize, ButtonV2SubType as ButtonSubType, ButtonV2State as ButtonState, InputSizeV2 as InputSize, InputStateV2 as InputState, TagV2Type as TagType, TagV2Size as TagSize, TagV2SubType as TagSubType, TagV2Color as TagColor, Theme } from '@juspay/blend-design-system/node';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Alert","Button","Tag","TextInput","Skeleton","BlendNativeProvider","BlendNativeThemeContext","DEFAULT_NATIVE_THEME","SYSTEM_THEME","useNativeTokens","useNativeBreakpoint","Block","Pressable","Text","Slot","Separator","PrimitiveInput","MIN_TOUCH_TARGET","Portal","useReduceMotion","BottomSheet","showToast","dismissToast","useLiveRegionAnnounce","AlertV2Type","AlertType","AlertV2SubType","AlertSubType","AlertV2ActionPosition","AlertActionPosition","ButtonV2Type","ButtonType","ButtonV2Size","ButtonSize","ButtonV2SubType","ButtonSubType","ButtonV2State","ButtonState","InputSizeV2","InputSize","InputStateV2","InputState","TagV2Type","TagType","TagV2Size","TagSize","TagV2SubType","TagSubType","TagV2Color","TagColor","Theme"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,KAAK,QAAQ,6BAAoB;AAC1C,SAASC,MAAM,QAAQ,8BAAqB;AAC5C,SAASC,GAAG,QAAQ,2BAAkB;AACtC,SAASC,SAAS,QAAQ,iCAAwB;AAKlD,SAASC,QAAQ,QAAQ,gCAAuB;AAahD;AACA,SACIC,mBAAmB,EACnBC,uBAAuB,EACvBC,oBAAoB,QACjB,gCAA6B;AAMpC;AACA,SAASC,YAAY,QAAQ,wBAAqB;AAQlD,SAASC,eAAe,QAAQ,4BAAyB;AACzD,SAASC,mBAAmB,QAAQ,gCAA6B;AAOjE;AACA;AACA,SAASC,KAAK,QAAQ,uBAAoB;AAC1C,SAASC,SAAS,QAAQ,2BAAwB;AAClD,SAASC,IAAI,QAAQ,sBAAmB;AACxC,SAASC,IAAI,QAAQ,sBAAmB;AACxC,SAASC,SAAS,QAAQ,2BAAwB;AAClD,SAASC,cAAc,QAAQ,gCAA6B;;AAQ5D;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA,SAASC,gBAAgB,QAAQ,6BAA0B;;AAE3D;AACA;AACA;AACA;AACA;AACA,SAASC,MAAM,QAAQ,qBAAkB;AAEzC,SAASC,eAAe,QAAQ,6BAA0B;;AAE1D;AACA;AACA,SAASC,WAAW,QAAQ,gCAA6B;AAGzD;AACA;AACA,SAASC,SAAS,EAAEC,YAAY,QAAQ,+BAA4B;;AAGpE;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,qBAAqB,QAAQ,yBAAsB;AAE5D,SACIC,WAAW,IAAIC,SAAS,EACxBC,cAAc,IAAIC,YAAY,EAC9BC,qBAAqB,IAAIC,mBAAmB,EAC5CC,YAAY,IAAIC,UAAU,EAC1BC,YAAY,IAAIC,UAAU,EAC1BC,eAAe,IAAIC,aAAa,EAChCC,aAAa,IAAIC,WAAW,EAC5BC,WAAW,IAAIC,SAAS,EACxBC,YAAY,IAAIC,UAAU,EAC1BC,SAAS,IAAIC,OAAO,EACpBC,SAAS,IAAIC,OAAO,EACpBC,YAAY,IAAIC,UAAU,EAC1BC,UAAU,IAAIC,QAAQ,EACtBC,KAAK,QACF,kCAAkC","ignoreList":[]}

package/lib/module/motion/motion.js

@@ -0,0 +1,123 @@
+"use strict";
+
+/**
+ * Motion tokens and presets.
+ *
+ * Web Blend has no motion token layer — durations and curves are scattered
+ * inline (`transition: 'transform 0.15s ease-in-out'`, the MenuV2/ModalV2
+ * animation modules). Native centralises them here so every overlay and
+ * state change moves the same way.
+ *
+ * Pure data, deliberately independent of any animation library: consumers
+ * (the Reanimated-based overlay components) translate a preset into
+ * `withTiming`/`withSpring` calls. Keeping the descriptions library-free
+ * means this module stays vitest-testable and the animation dependency
+ * stays contained to the components that actually animate.
+ */
+
+/** Milliseconds. `fast` = state feedback, `normal` = overlays, `slow` = sheets. */
+export const MOTION_DURATION = {
+  fast: 150,
+  normal: 250,
+  slow: 400
+};
+
+/** Cubic-bezier control points, CSS order `[x1, y1, x2, y2]`. */
+export const MOTION_EASING = {
+  /** Both ends eased — in-place state changes. */
+  standard: [0.4, 0, 0.2, 1],
+  /** Fast start, soft landing — content entering the screen. */
+  decelerate: [0, 0, 0.2, 1],
+  /** Soft start, fast exit — content leaving the screen. */
+  accelerate: [0.4, 0, 1, 1]
+};
+
+/** Transform/opacity state at one end of a transition. */
+
+/**
+ * The presets the overlay components share.
+ *
+ * - `fade` — tooltips, backdrops.
+ * - `scaleFade` — menus, popovers, selects (anchored surfaces growing from
+ *   their anchor).
+ * - `slideUp` — toasts and sheets entering from the bottom edge (the
+ *   translate distance is a starting offset; sheets override it with their
+ *   own measured height).
+ * - `slideDown` — banners entering from the top edge.
+ */
+export const MOTION_PRESETS = {
+  fade: {
+    from: {
+      opacity: 0
+    },
+    to: {
+      opacity: 1
+    },
+    duration: MOTION_DURATION.fast,
+    easing: 'decelerate',
+    exitDuration: MOTION_DURATION.fast,
+    exitEasing: 'accelerate'
+  },
+  scaleFade: {
+    from: {
+      opacity: 0,
+      scale: 0.95
+    },
+    to: {
+      opacity: 1,
+      scale: 1
+    },
+    duration: MOTION_DURATION.normal,
+    easing: 'decelerate',
+    exitDuration: MOTION_DURATION.fast,
+    exitEasing: 'accelerate'
+  },
+  slideUp: {
+    from: {
+      opacity: 0,
+      translateY: 16
+    },
+    to: {
+      opacity: 1,
+      translateY: 0
+    },
+    duration: MOTION_DURATION.normal,
+    easing: 'decelerate',
+    exitDuration: MOTION_DURATION.fast,
+    exitEasing: 'accelerate'
+  },
+  slideDown: {
+    from: {
+      opacity: 0,
+      translateY: -16
+    },
+    to: {
+      opacity: 1,
+      translateY: 0
+    },
+    duration: MOTION_DURATION.normal,
+    easing: 'decelerate',
+    exitDuration: MOTION_DURATION.fast,
+    exitEasing: 'accelerate'
+  }
+};
+/**
+ * A preset with motion removed — what every animation collapses to when the
+ * user has OS reduce-motion enabled (see `useReduceMotion`): a fast opacity
+ * change, no movement, no scaling.
+ */
+export function reducedMotionVariant(preset) {
+  return {
+    from: {
+      opacity: preset.from.opacity ?? 0
+    },
+    to: {
+      opacity: preset.to.opacity ?? 1
+    },
+    duration: MOTION_DURATION.fast,
+    easing: 'standard',
+    exitDuration: MOTION_DURATION.fast,
+    exitEasing: 'standard'
+  };
+}
+//# sourceMappingURL=motion.js.map

package/lib/module/motion/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MOTION_DURATION","fast","normal","slow","MOTION_EASING","standard","decelerate","accelerate","MOTION_PRESETS","fade","from","opacity","to","duration","easing","exitDuration","exitEasing","scaleFade","scale","slideUp","translateY","slideDown","reducedMotionVariant","preset"],"sourceRoot":"../../../src","sources":["motion/motion.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,MAAMA,eAAe,GAAG;EAC3BC,IAAI,EAAE,GAAG;EACTC,MAAM,EAAE,GAAG;EACXC,IAAI,EAAE;AACV,CAAU;;AAEV;AACA,OAAO,MAAMC,aAAa,GAAG;EACzB;EACAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;EAC1B;EACAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;EAC1B;EACAC,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7B,CAAU;;AAIV;;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,GAAG;EAC1BC,IAAI,EAAE;IACFC,IAAI,EAAE;MAAEC,OAAO,EAAE;IAAE,CAAC;IACpBC,EAAE,EAAE;MAAED,OAAO,EAAE;IAAE,CAAC;IAClBE,QAAQ,EAAEb,eAAe,CAACC,IAAI;IAC9Ba,MAAM,EAAE,YAAY;IACpBC,YAAY,EAAEf,eAAe,CAACC,IAAI;IAClCe,UAAU,EAAE;EAChB,CAAC;EACDC,SAAS,EAAE;IACPP,IAAI,EAAE;MAAEC,OAAO,EAAE,CAAC;MAAEO,KAAK,EAAE;IAAK,CAAC;IACjCN,EAAE,EAAE;MAAED,OAAO,EAAE,CAAC;MAAEO,KAAK,EAAE;IAAE,CAAC;IAC5BL,QAAQ,EAAEb,eAAe,CAACE,MAAM;IAChCY,MAAM,EAAE,YAAY;IACpBC,YAAY,EAAEf,eAAe,CAACC,IAAI;IAClCe,UAAU,EAAE;EAChB,CAAC;EACDG,OAAO,EAAE;IACLT,IAAI,EAAE;MAAEC,OAAO,EAAE,CAAC;MAAES,UAAU,EAAE;IAAG,CAAC;IACpCR,EAAE,EAAE;MAAED,OAAO,EAAE,CAAC;MAAES,UAAU,EAAE;IAAE,CAAC;IACjCP,QAAQ,EAAEb,eAAe,CAACE,MAAM;IAChCY,MAAM,EAAE,YAAY;IACpBC,YAAY,EAAEf,eAAe,CAACC,IAAI;IAClCe,UAAU,EAAE;EAChB,CAAC;EACDK,SAAS,EAAE;IACPX,IAAI,EAAE;MAAEC,OAAO,EAAE,CAAC;MAAES,UAAU,EAAE,CAAC;IAAG,CAAC;IACrCR,EAAE,EAAE;MAAED,OAAO,EAAE,CAAC;MAAES,UAAU,EAAE;IAAE,CAAC;IACjCP,QAAQ,EAAEb,eAAe,CAACE,MAAM;IAChCY,MAAM,EAAE,YAAY;IACpBC,YAAY,EAAEf,eAAe,CAACC,IAAI;IAClCe,UAAU,EAAE;EAChB;AACJ,CAAiD;AAIjD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASM,oBAAoBA,CAACC,MAAoB,EAAgB;EACrE,OAAO;IACHb,IAAI,EAAE;MAAEC,OAAO,EAAEY,MAAM,CAACb,IAAI,CAACC,OAAO,IAAI;IAAE,CAAC;IAC3CC,EAAE,EAAE;MAAED,OAAO,EAAEY,MAAM,CAACX,EAAE,CAACD,OAAO,IAAI;IAAE,CAAC;IACvCE,QAAQ,EAAEb,eAAe,CAACC,IAAI;IAC9Ba,MAAM,EAAE,UAAU;IAClBC,YAAY,EAAEf,eAAe,CAACC,IAAI;IAClCe,UAAU,EAAE;EAChB,CAAC;AACL","ignoreList":[]}

package/lib/module/motion/useReduceMotion.js

@@ -0,0 +1,33 @@
+"use strict";
+
+import { useEffect, useState } from 'react';
+import { AccessibilityInfo } from 'react-native';
+
+/**
+ * Whether the OS reduce-motion accessibility setting is on.
+ *
+ * The native counterpart of web's `prefers-reduced-motion` media query.
+ * Overlay components pair this with `reducedMotionVariant` so every
+ * animation collapses to a quick fade when the user asked for less motion.
+ *
+ * Starts `false` and corrects itself once the async platform query
+ * resolves — the safe default, since acting on it only ever *removes*
+ * motion. Subscribes to changes for the lifetime of the component.
+ */
+export function useReduceMotion() {
+  const [reduceMotion, setReduceMotion] = useState(false);
+  useEffect(() => {
+    let mounted = true;
+    AccessibilityInfo.isReduceMotionEnabled().then(enabled => {
+      if (mounted) setReduceMotion(enabled);
+    });
+    const subscription = AccessibilityInfo.addEventListener('reduceMotionChanged', setReduceMotion);
+    return () => {
+      mounted = false;
+      subscription.remove();
+    };
+  }, []);
+  return reduceMotion;
+}
+export default useReduceMotion;
+//# sourceMappingURL=useReduceMotion.js.map

package/lib/module/motion/useReduceMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useState","AccessibilityInfo","useReduceMotion","reduceMotion","setReduceMotion","mounted","isReduceMotionEnabled","then","enabled","subscription","addEventListener","remove"],"sourceRoot":"../../../src","sources":["motion/useReduceMotion.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAY;EACvC,MAAM,CAACC,YAAY,EAAEC,eAAe,CAAC,GAAGJ,QAAQ,CAAC,KAAK,CAAC;EAEvDD,SAAS,CAAC,MAAM;IACZ,IAAIM,OAAO,GAAG,IAAI;IAClBJ,iBAAiB,CAACK,qBAAqB,CAAC,CAAC,CAACC,IAAI,CAAEC,OAAO,IAAK;MACxD,IAAIH,OAAO,EAAED,eAAe,CAACI,OAAO,CAAC;IACzC,CAAC,CAAC;IACF,MAAMC,YAAY,GAAGR,iBAAiB,CAACS,gBAAgB,CACnD,qBAAqB,EACrBN,eACJ,CAAC;IACD,OAAO,MAAM;MACTC,OAAO,GAAG,KAAK;MACfI,YAAY,CAACE,MAAM,CAAC,CAAC;IACzB,CAAC;EACL,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOR,YAAY;AACvB;AAEA,eAAeD,eAAe","ignoreList":[]}

package/lib/module/overlay/portal.js

@@ -0,0 +1,104 @@
+"use strict";
+
+import React, { createContext, useCallback, useContext, useEffect, useId, useMemo, useState } from 'react';
+import { StyleSheet, View } from 'react-native';
+
+/**
+ * Portal — layered rendering above the app's content.
+ *
+ * The native replacement for web's `createPortal`/Radix `Portal`: overlay
+ * components (modal, menu, popover, tooltip, snackbar) mount their surface
+ * through `<Portal>` and it renders in an absolute-fill layer that
+ * `BlendNativeProvider` places *after* the app's children, so it paints on
+ * top regardless of where in the tree the overlay was opened.
+ *
+ * Layers stack in mount order — the overlay opened last paints on top,
+ * which matches how web portals appended to `document.body` behave.
+ *
+ * The provider must sit at a screen-filling root (the usual place for a
+ * theme provider): the layers are absolutely positioned siblings of the
+ * app's children, so they cover exactly what the provider's parent covers.
+ *
+ * With no provider mounted, `<Portal>` renders its children in place — an
+ * overlay degrades to inline rendering rather than disappearing.
+ */
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const PortalRegistryContext = /*#__PURE__*/createContext(null);
+let warnedNoProvider = false;
+/** Renders `children` into the provider's overlay layer. */
+export function Portal({
+  children
+}) {
+  const registry = useContext(PortalRegistryContext);
+  const key = useId();
+  useEffect(() => {
+    if (!registry) return;
+    registry.mount(key, children);
+    return () => registry.unmount(key);
+  }, [registry, key, children]);
+
+  // In an effect, not during render — warning inline would be a
+  // render-phase side effect (breaks under StrictMode double-render, the
+  // same class of bug Pressable's parse memoisation fixed).
+  useEffect(() => {
+    if (registry || warnedNoProvider) return;
+    if (typeof __DEV__ !== 'undefined' && __DEV__) {
+      warnedNoProvider = true;
+      console.warn('[blend-native] <Portal> used without BlendNativeProvider — ' + 'rendering inline. Overlays will not layer above the app.');
+    }
+  }, [registry]);
+  if (!registry) return /*#__PURE__*/_jsx(_Fragment, {
+    children: children
+  });
+  return null;
+}
+Portal.displayName = 'Portal';
+
+/**
+ * Internal — wraps the app's children with the portal registry and renders
+ * the mounted layers after them. Used by `BlendNativeProvider`; not public.
+ */
+export function PortalArea({
+  children
+}) {
+  const [portals, setPortals] = useState([]);
+  const mount = useCallback((key, node) => {
+    setPortals(current => {
+      const existing = current.findIndex(p => p.key === key);
+      if (existing === -1) return [...current, {
+        key,
+        node
+      }];
+      // Re-mount with new content keeps its layer position.
+      const next = current.slice();
+      next[existing] = {
+        key,
+        node
+      };
+      return next;
+    });
+  }, []);
+  const unmount = useCallback(key => {
+    setPortals(current => current.filter(p => p.key !== key));
+  }, []);
+  const registry = useMemo(() => ({
+    mount,
+    unmount
+  }), [mount, unmount]);
+  return /*#__PURE__*/_jsxs(PortalRegistryContext.Provider, {
+    value: registry,
+    children: [children, portals.map(({
+      key,
+      node
+    }) => /*#__PURE__*/_jsx(View, {
+      style: StyleSheet.absoluteFill
+      // Touches fall through empty layer area to the app;
+      // the overlay's own views still receive theirs.
+      ,
+      pointerEvents: "box-none",
+      children: node
+    }, key))]
+  });
+}
+PortalArea.displayName = 'PortalArea';
+//# sourceMappingURL=portal.js.map

package/lib/module/overlay/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useCallback","useContext","useEffect","useId","useMemo","useState","StyleSheet","View","Fragment","_Fragment","jsx","_jsx","jsxs","_jsxs","PortalRegistryContext","warnedNoProvider","Portal","children","registry","key","mount","unmount","__DEV__","console","warn","displayName","PortalArea","portals","setPortals","node","current","existing","findIndex","p","next","slice","filter","Provider","value","map","style","absoluteFill","pointerEvents"],"sourceRoot":"../../../src","sources":["overlay/portal.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/overlay/positioning.js

@@ -0,0 +1,118 @@
+"use strict";
+
+/**
+ * Anchored-overlay positioning.
+ *
+ * The native replacement for what Radix/floating-ui do on web: place a
+ * floating box (menu, popover, tooltip, select list) against an anchor
+ * rect, flipping to the opposite side when space runs out and clamping
+ * into the viewport.
+ *
+ * Pure and RN-free — rects in, a position out — so the whole placement
+ * matrix is unit-testable under vitest. `useAnchoredPosition` layers the
+ * measurement plumbing on top.
+ */
+
+/** Which side of the anchor the content prefers. */
+
+/** Alignment along the anchor's other axis. */
+
+const opposite = {
+  top: 'bottom',
+  bottom: 'top',
+  left: 'right',
+  right: 'left'
+};
+
+/** Space between the anchor and the viewport edge on one side. */
+function spaceOn(side, anchor, viewport, offset, padding) {
+  switch (side) {
+    case 'top':
+      return anchor.y - offset - padding;
+    case 'bottom':
+      return viewport.height - (anchor.y + anchor.height) - offset - padding;
+    case 'left':
+      return anchor.x - offset - padding;
+    case 'right':
+      return viewport.width - (anchor.x + anchor.width) - offset - padding;
+  }
+}
+const clamp = (value, min, max) =>
+// A viewport smaller than the padding produces min > max; the lower
+// bound wins so content pins to the leading edge instead of NaN-ing.
+Math.max(min, Math.min(value, Math.max(min, max)));
+
+/**
+ * Compute where to place floating content against an anchor.
+ *
+ * - **Flip**: when the preferred side cannot fit the content but the
+ *   opposite side can fit more of it, the placement flips.
+ * - **Clamp**: the cross-axis position shifts to keep the content inside
+ *   the viewport padding (matching floating-ui's `shift`).
+ * - **Cap**: `maxHeight`/`maxWidth` report the space actually available on
+ *   the resolved side, so scrollable content can cap itself.
+ */
+export function computeAnchoredPosition(input) {
+  const {
+    anchor,
+    content,
+    viewport,
+    placement: preferred = 'bottom',
+    alignment = 'start',
+    offset = 8,
+    viewportPadding = 8
+  } = input;
+  const preferredSpace = spaceOn(preferred, anchor, viewport, offset, viewportPadding);
+  const isVertical = preferred === 'top' || preferred === 'bottom';
+  const needed = isVertical ? content.height : content.width;
+  let placement = preferred;
+  if (needed > preferredSpace) {
+    const other = spaceOn(opposite[preferred], anchor, viewport, offset, viewportPadding);
+    if (other > preferredSpace) placement = opposite[preferred];
+  }
+
+  // ---- Main axis ------------------------------------------------------
+  let x = 0;
+  let y = 0;
+  switch (placement) {
+    case 'top':
+      y = anchor.y - offset - content.height;
+      break;
+    case 'bottom':
+      y = anchor.y + anchor.height + offset;
+      break;
+    case 'left':
+      x = anchor.x - offset - content.width;
+      break;
+    case 'right':
+      x = anchor.x + anchor.width + offset;
+      break;
+  }
+
+  // ---- Cross axis -----------------------------------------------------
+  const alignAlong = (anchorStart, anchorLength, contentLength) => {
+    if (alignment === 'start') return anchorStart;
+    if (alignment === 'end') return anchorStart + anchorLength - contentLength;
+    return anchorStart + (anchorLength - contentLength) / 2;
+  };
+  if (placement === 'top' || placement === 'bottom') {
+    x = alignAlong(anchor.x, anchor.width, content.width);
+  } else {
+    y = alignAlong(anchor.y, anchor.height, content.height);
+  }
+
+  // ---- Keep inside the viewport ---------------------------------------
+  x = clamp(x, viewportPadding, viewport.width - viewportPadding - content.width);
+  y = clamp(y, viewportPadding, viewport.height - viewportPadding - content.height);
+  const available = spaceOn(placement, anchor, viewport, offset, viewportPadding);
+  const maxHeight = placement === 'top' || placement === 'bottom' ? Math.max(0, available) : Math.max(0, viewport.height - 2 * viewportPadding);
+  const maxWidth = placement === 'left' || placement === 'right' ? Math.max(0, available) : Math.max(0, viewport.width - 2 * viewportPadding);
+  return {
+    x,
+    y,
+    placement,
+    maxHeight,
+    maxWidth
+  };
+}
+//# sourceMappingURL=positioning.js.map

package/lib/module/overlay/positioning.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["opposite","top","bottom","left","right","spaceOn","side","anchor","viewport","offset","padding","y","height","x","width","clamp","value","min","max","Math","computeAnchoredPosition","input","content","placement","preferred","alignment","viewportPadding","preferredSpace","isVertical","needed","other","alignAlong","anchorStart","anchorLength","contentLength","available","maxHeight","maxWidth"],"sourceRoot":"../../../src","sources":["overlay/positioning.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/overlay/safeAreaInsets.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import { createContext } from 'react';
+
+/**
+ * Optional `react-native-safe-area-context` integration, shared by every
+ * overlay that must respect the home indicator or notch (BottomSheet, the
+ * toast outlet).
+ *
+ * `useContext` needs *a* context unconditionally, so when the optional peer
+ * is absent — or its provider is not mounted — a null-valued fallback
+ * stands in and insets resolve to zero. Same probe pattern as
+ * expo-linear-gradient.
+ */
+
+const FallbackInsetsContext = /*#__PURE__*/createContext(null);
+export let SafeAreaInsetsContext = FallbackInsetsContext;
+try {
+  if (typeof require === 'function') {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const safeArea = require('react-native-safe-area-context');
+    SafeAreaInsetsContext = safeArea.SafeAreaInsetsContext ?? FallbackInsetsContext;
+  }
+} catch {
+  SafeAreaInsetsContext = FallbackInsetsContext;
+}
+//# sourceMappingURL=safeAreaInsets.js.map

package/lib/module/overlay/safeAreaInsets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","FallbackInsetsContext","SafeAreaInsetsContext","require","safeArea"],"sourceRoot":"../../../src","sources":["overlay/safeAreaInsets.ts"],"mappings":";;AAAA,SAAgBA,aAAa,QAAQ,OAAO;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,MAAMC,qBAAqB,gBAAGD,aAAa,CAAoB,IAAI,CAAC;AAEpE,OAAO,IAAIE,qBAAuD,GAC9DD,qBAAqB;AACzB,IAAI;EACA,IAAI,OAAOE,OAAO,KAAK,UAAU,EAAE;IAC/B;IACA,MAAMC,QAAQ,GAAGD,OAAO,CAAC,gCAAgC,CAExD;IACDD,qBAAqB,GACjBE,QAAQ,CAACF,qBAAqB,IAAID,qBAAqB;EAC/D;AACJ,CAAC,CAAC,MAAM;EACJC,qBAAqB,GAAGD,qBAAqB;AACjD","ignoreList":[]}