blend-native 0.0.1-beta.0

package/lib/typescript/module/components/shared/field/fieldState.d.ts

@@ -0,0 +1,23 @@
+import { InputStateV2 } from '@juspay/blend-design-system/node';
+/**
+ * Input state derivation, shared by every field component.
+ *
+ * Mirrors web's `getInputState` (`InputsV2/TextInputV2/utils.ts`) and the
+ * per-variant resolution `TextInputV2.tsx` performs inline: error always
+ * wins, then disabled, and focus applies only when nothing stronger does.
+ * `HOVER` exists in the enum but has no touch counterpart.
+ *
+ * Pure and RN-free so the whole truth table unit-tests under vitest.
+ */
+export type FieldError = {
+    show: boolean;
+    message?: string;
+} | undefined;
+/** The state driving label/footer colours — web's `getInputState`. */
+export declare function getFieldState(error: FieldError, disabled?: boolean): InputStateV2;
+/**
+ * The state driving the input container's border/background/text, which
+ * unlike the label state also reflects focus.
+ */
+export declare function getFieldVisualState(error: FieldError, disabled: boolean | undefined, focused: boolean): InputStateV2;
+//# sourceMappingURL=fieldState.d.ts.map

package/lib/typescript/module/components/shared/field/fieldState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldState.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shared/field/fieldState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAE/D;;;;;;;;;GASG;AAEH,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAExE,sEAAsE;AACtE,wBAAgB,aAAa,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,OAAO,GACnB,YAAY,CAId;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,OAAO,EAAE,OAAO,GACjB,YAAY,CAKd"}

package/lib/typescript/module/components/shared/group.d.ts

@@ -0,0 +1,50 @@
+import type { ViewStyle } from 'react-native';
+/**
+ * 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. */
+export type GroupPosition = 'center' | 'left' | 'right';
+/**
+ * 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 declare function getGroupedBorderRadius(radius: string | number, position: GroupPosition | undefined): string;
+/**
+ * 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 declare function getGroupedBorderWidths(position: GroupPosition | undefined): Pick<ViewStyle, 'borderLeftWidth' | 'borderRightWidth'>;
+//# sourceMappingURL=group.d.ts.map

package/lib/typescript/module/components/shared/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../../../src/components/shared/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C;;;;;;;;;;;GAWG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAKvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,aAAa,GAAG,SAAS,GACpC,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,aAAa,GAAG,SAAS,GACpC,IAAI,CAAC,SAAS,EAAE,iBAAiB,GAAG,kBAAkB,CAAC,CAGzD"}

package/lib/typescript/module/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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.
+ */
+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 type { TextInputNativeProps, TextInputSlot, } from './components/TextInput/index.js';
+export { Skeleton } from './components/Skeleton/index.js';
+export type { SkeletonNativeProps } from './components/Skeleton/index.js';
+export type { AlertNativeProps, AlertSlot, AlertAction, AlertActions, AlertCloseButton, } from './components/Alert/index.js';
+export type { ButtonNativeProps } from './components/Button/index.js';
+export type { TagNativeProps, TagSlot } from './components/Tag/index.js';
+export { BlendNativeProvider, BlendNativeThemeContext, DEFAULT_NATIVE_THEME, } from './theme/BlendNativeProvider.js';
+export type { BlendNativeProviderProps, BlendNativeThemeValue, } from './theme/BlendNativeProvider.js';
+/** Pass `theme={SYSTEM_THEME}` (or `theme="system"`) to follow the OS. */
+export { SYSTEM_THEME } from './theme/systemTheme.js';
+export type { NativeThemeSetting } from './theme/systemTheme.js';
+export type { NativeFontRole, NativeFontFamilies, NativeFontFamilyOption, } from './theme/fonts.js';
+export { useNativeTokens } from './theme/useNativeTokens.js';
+export { useNativeBreakpoint } from './theme/useNativeBreakpoint.js';
+export type { NativeBreakpoint } from './theme/useNativeBreakpoint.js';
+export type { NativeTokenSlot, NativeComponentTokenOverrides, } from './theme/nativeTokenRegistry.js';
+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';
+export type { PrimitiveInputProps } from './primitives/PrimitiveInput.js';
+export type { BlockProps } from './primitives/Block.js';
+export type { PrimitivePressableProps } from './primitives/Pressable.js';
+export type { BlendTextProps } from './primitives/Text.js';
+export type { SlotProps } from './primitives/Slot.js';
+export type { SeparatorProps } from './primitives/Separator.js';
+export type { SurfaceStyleProps } from './adapters/surfaceStyle.js';
+export type { RNSize } from './adapters/cssStringAdapter.js';
+/**
+ * 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';
+export { Portal } from './overlay/portal.js';
+export type { PortalProps } from './overlay/portal.js';
+export { useReduceMotion } from './motion/useReduceMotion.js';
+export { BottomSheet } from './overlay/sheet/BottomSheet.js';
+export type { BottomSheetProps } from './overlay/sheet/BottomSheet.js';
+export { showToast, dismissToast } from './overlay/toast/toastStore.js';
+export type { ToastOptions } from './overlay/toast/toastStore.js';
+/** Position of a control within a button or tag group. */
+export type { GroupPosition } from './components/shared/group.js';
+/**
+ * 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.d.ts.map

package/lib/typescript/module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/motion/motion.d.ts

@@ -0,0 +1,121 @@
+/**
+ * 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 declare const MOTION_DURATION: {
+    readonly fast: 150;
+    readonly normal: 250;
+    readonly slow: 400;
+};
+/** Cubic-bezier control points, CSS order `[x1, y1, x2, y2]`. */
+export declare const MOTION_EASING: {
+    /** Both ends eased — in-place state changes. */
+    readonly standard: readonly [0.4, 0, 0.2, 1];
+    /** Fast start, soft landing — content entering the screen. */
+    readonly decelerate: readonly [0, 0, 0.2, 1];
+    /** Soft start, fast exit — content leaving the screen. */
+    readonly accelerate: readonly [0.4, 0, 1, 1];
+};
+export type MotionEasing = keyof typeof MOTION_EASING;
+/** Transform/opacity state at one end of a transition. */
+export type MotionFrame = {
+    opacity?: number;
+    scale?: number;
+    translateX?: number;
+    translateY?: number;
+};
+export type MotionPreset = {
+    from: MotionFrame;
+    to: MotionFrame;
+    duration: number;
+    easing: MotionEasing;
+    /** Exit timing — exits run faster than entrances by convention. */
+    exitDuration: number;
+    exitEasing: MotionEasing;
+};
+/**
+ * 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 declare const MOTION_PRESETS: {
+    readonly fade: {
+        readonly from: {
+            readonly opacity: 0;
+        };
+        readonly to: {
+            readonly opacity: 1;
+        };
+        readonly duration: 150;
+        readonly easing: "decelerate";
+        readonly exitDuration: 150;
+        readonly exitEasing: "accelerate";
+    };
+    readonly scaleFade: {
+        readonly from: {
+            readonly opacity: 0;
+            readonly scale: 0.95;
+        };
+        readonly to: {
+            readonly opacity: 1;
+            readonly scale: 1;
+        };
+        readonly duration: 250;
+        readonly easing: "decelerate";
+        readonly exitDuration: 150;
+        readonly exitEasing: "accelerate";
+    };
+    readonly slideUp: {
+        readonly from: {
+            readonly opacity: 0;
+            readonly translateY: 16;
+        };
+        readonly to: {
+            readonly opacity: 1;
+            readonly translateY: 0;
+        };
+        readonly duration: 250;
+        readonly easing: "decelerate";
+        readonly exitDuration: 150;
+        readonly exitEasing: "accelerate";
+    };
+    readonly slideDown: {
+        readonly from: {
+            readonly opacity: 0;
+            readonly translateY: -16;
+        };
+        readonly to: {
+            readonly opacity: 1;
+            readonly translateY: 0;
+        };
+        readonly duration: 250;
+        readonly easing: "decelerate";
+        readonly exitDuration: 150;
+        readonly exitEasing: "accelerate";
+    };
+};
+export type MotionPresetName = keyof typeof MOTION_PRESETS;
+/**
+ * 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 declare function reducedMotionVariant(preset: MotionPreset): MotionPreset;
+//# sourceMappingURL=motion.d.ts.map

package/lib/typescript/module/motion/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../../../src/motion/motion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,mFAAmF;AACnF,eAAO,MAAM,eAAe;;;;CAIlB,CAAA;AAEV,iEAAiE;AACjE,eAAO,MAAM,aAAa;IACtB,gDAAgD;;IAEhD,8DAA8D;;IAE9D,0DAA0D;;CAEpD,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAA;AAErD,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,EAAE,EAAE,WAAW,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,YAAY,CAAA;CAC3B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCsB,CAAA;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAA;AAE1D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CASvE"}

package/lib/typescript/module/motion/useReduceMotion.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 declare function useReduceMotion(): boolean;
+export default useReduceMotion;
+//# sourceMappingURL=useReduceMotion.d.ts.map

package/lib/typescript/module/motion/useReduceMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReduceMotion.d.ts","sourceRoot":"","sources":["../../../../src/motion/useReduceMotion.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAmBzC;AAED,eAAe,eAAe,CAAA"}

package/lib/typescript/module/overlay/portal.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+export type PortalProps = {
+    children?: React.ReactNode;
+};
+/** Renders `children` into the provider's overlay layer. */
+export declare function Portal({ children }: PortalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace Portal {
+    var displayName: string;
+}
+/**
+ * Internal — wraps the app's children with the portal registry and renders
+ * the mounted layers after them. Used by `BlendNativeProvider`; not public.
+ */
+export declare function PortalArea({ children }: {
+    children?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace PortalArea {
+    var displayName: string;
+}
+//# sourceMappingURL=portal.d.ts.map

package/lib/typescript/module/overlay/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../../src/overlay/portal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAA;AAkCd,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAA;AAExD,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,kDA2B/C;yBA3Be,MAAM;;;AA+BtB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAuCtE;yBAvCe,UAAU"}

package/lib/typescript/module/overlay/positioning.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ */
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type Size = {
+    width: number;
+    height: number;
+};
+/** Which side of the anchor the content prefers. */
+export type Placement = 'top' | 'bottom' | 'left' | 'right';
+/** Alignment along the anchor's other axis. */
+export type Alignment = 'start' | 'center' | 'end';
+export type AnchoredPositionInput = {
+    /** The anchor's rect in window coordinates (`measureInWindow`). */
+    anchor: Rect;
+    /** The floating content's measured size. */
+    content: Size;
+    /** The window size (`useWindowDimensions`). */
+    viewport: Size;
+    placement?: Placement;
+    alignment?: Alignment;
+    /** Gap between anchor and content, in points. */
+    offset?: number;
+    /** Minimum distance kept from every viewport edge, in points. */
+    viewportPadding?: number;
+};
+export type AnchoredPosition = {
+    x: number;
+    y: number;
+    /** The placement actually used, after any flip. */
+    placement: Placement;
+    /**
+     * Space available for the content on the resolved side, after padding.
+     * Callers cap scrollable content (menus, select lists) with these so a
+     * long list scrolls instead of overflowing the screen.
+     */
+    maxHeight: number;
+    maxWidth: number;
+};
+/**
+ * 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 declare function computeAnchoredPosition(input: AnchoredPositionInput): AnchoredPosition;
+//# sourceMappingURL=positioning.d.ts.map

package/lib/typescript/module/overlay/positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.d.ts","sourceRoot":"","sources":["../../../../src/overlay/positioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAC1E,MAAM,MAAM,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3D,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG;IAChC,mEAAmE;IACnE,MAAM,EAAE,IAAI,CAAA;IACZ,4CAA4C;IAC5C,OAAO,EAAE,IAAI,CAAA;IACb,+CAA+C;IAC/C,QAAQ,EAAE,IAAI,CAAA;IACd,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,mDAAmD;IACnD,SAAS,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACnB,CAAA;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,qBAAqB,GAC7B,gBAAgB,CAkGlB"}

package/lib/typescript/module/overlay/safeAreaInsets.d.ts

@@ -0,0 +1,19 @@
+import React 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.
+ */
+export type EdgeInsets = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+export declare let SafeAreaInsetsContext: React.Context<EdgeInsets | null>;
+//# sourceMappingURL=safeAreaInsets.d.ts.map

package/lib/typescript/module/overlay/safeAreaInsets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeAreaInsets.d.ts","sourceRoot":"","sources":["../../../../src/overlay/safeAreaInsets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAA;AAE5C;;;;;;;;;GASG;AAEH,MAAM,MAAM,UAAU,GAAG;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CAChB,CAAA;AAID,eAAO,IAAI,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CACxC,CAAA"}

package/lib/typescript/module/overlay/sheet/BottomSheet.d.ts

@@ -0,0 +1,56 @@
+import React from 'react';
+import { type ViewStyle } from 'react-native';
+/**
+ * BottomSheet — the gesture-driven sheet foundation.
+ *
+ * The native replacement for `vaul` and the phone presentation web already
+ * prescribes in its Mobile* variants (mobileModalV2, MobileSingleSelectV2,
+ * MobilePopoverV2): DrawerV2 and the phone modes of Select/Menu/Modal
+ * compose this primitive and pass their token values in — the sheet itself
+ * carries structure and physics, not design decisions, which is why its
+ * colour props have plain defaults instead of token lookups.
+ *
+ * Controlled: `open` drives it; every dismiss route (drag, backdrop, the
+ * Android back button) calls `onClose` and the owner flips `open` — the
+ * exit animation runs, then the sheet unmounts from the portal layer.
+ *
+ * Requirements: `react-native-reanimated` and `react-native-gesture-handler`
+ * (required peers), and a `GestureHandlerRootView` at the app root — apps
+ * using react-navigation already have one. `react-native-safe-area-context`
+ * is optional: with it (and its provider) mounted, the sheet pads itself
+ * past the home indicator; without it the bottom inset is 0.
+ *
+ * Reduce-motion: the slide collapses to a fade (`useReduceMotion`).
+ */
+export type BottomSheetProps = {
+    /** Whether the sheet is presented. */
+    open: boolean;
+    /** Called whenever the sheet asks to close; the owner flips `open`. */
+    onClose: () => void;
+    children?: React.ReactNode;
+    /** Cap on sheet height as a fraction of the window. Default 0.9. */
+    maxHeightFraction?: number;
+    /** Backdrop fill. Defaults to 50% black. */
+    backdropColor?: string;
+    /** Sheet surface colour. Component layers pass their token value. */
+    backgroundColor?: string;
+    /** Radius of the two top corners. */
+    topRadius?: number;
+    /** Show the drag handle. Default true. */
+    showHandle?: boolean;
+    handleColor?: string;
+    /** Allow drag-down to dismiss. Default true. */
+    dragToDismiss?: boolean;
+    /** Dismiss when the backdrop is pressed. Default true. */
+    dismissOnBackdropPress?: boolean;
+    accessibilityLabel?: string;
+    testID?: string;
+    /** Style escape hatch for the sheet surface. */
+    style?: ViewStyle;
+};
+export declare function BottomSheet({ open, onClose, children, maxHeightFraction, backdropColor, backgroundColor, topRadius, showHandle, handleColor, dragToDismiss, dismissOnBackdropPress, accessibilityLabel, testID, style, }: BottomSheetProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace BottomSheet {
+    var displayName: string;
+}
+export default BottomSheet;
+//# sourceMappingURL=BottomSheet.d.ts.map

package/lib/typescript/module/overlay/sheet/BottomSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../../../../src/overlay/sheet/BottomSheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuD,MAAM,OAAO,CAAA;AAC3E,OAAO,EAOH,KAAK,SAAS,EACjB,MAAM,cAAc,CAAA;AAqBrB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAA;IACb,uEAAuE;IACvE,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAA;CACpB,CAAA;AAWD,wBAAgB,WAAW,CAAC,EACxB,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,iBAA6C,EAC7C,aAAoC,EACpC,eAA2B,EAC3B,SAAc,EACd,UAAiB,EACjB,WAAkC,EAClC,aAAoB,EACpB,sBAA6B,EAC7B,kBAAkB,EAClB,MAAM,EACN,KAAK,GACR,EAAE,gBAAgB,kDAqJlB;yBApKe,WAAW;;;AA0L3B,eAAe,WAAW,CAAA"}

package/lib/typescript/module/overlay/sheet/sheetMath.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Bottom-sheet gesture arithmetic.
+ *
+ * Pure and RN-free (the `theme/breakpoint.ts` pattern) so the dismiss
+ * decision — the part of a sheet that feels wrong when it is wrong — is
+ * unit-testable under vitest. `BottomSheet` wires these into the pan
+ * gesture; they also run as Reanimated worklets, so nothing here may close
+ * over module state.
+ */
+/** Dragging past this fraction of the sheet's height dismisses on release. */
+export declare const SHEET_DISMISS_FRACTION = 0.25;
+/** A downward fling at or above this velocity (pt/s) dismisses regardless. */
+export declare const SHEET_DISMISS_VELOCITY = 800;
+/** Default cap: a sheet covers at most this fraction of the window. */
+export declare const SHEET_MAX_HEIGHT_FRACTION = 0.9;
+/**
+ * The sheet follows the finger downward only — upward drag is pinned so the
+ * sheet feels anchored rather than lifting off its resting position.
+ */
+export declare function clampSheetDrag(translationY: number): number;
+/**
+ * Whether a released drag should dismiss the sheet: past the distance
+ * threshold, or a genuine downward fling. An upward fling never dismisses,
+ * whatever distance was covered first.
+ */
+export declare function shouldDismissSheet(translationY: number, velocityY: number, sheetHeight: number): boolean;
+/**
+ * The tallest a sheet may grow: the capped fraction of the window, minus
+ * whatever top inset (status bar / notch) must stay visible above it.
+ */
+export declare function resolveSheetMaxHeight(windowHeight: number, topInset?: number, maxHeightFraction?: number): number;
+//# sourceMappingURL=sheetMath.d.ts.map

package/lib/typescript/module/overlay/sheet/sheetMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheetMath.d.ts","sourceRoot":"","sources":["../../../../../src/overlay/sheet/sheetMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACpB,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAU,EACpB,iBAAiB,GAAE,MAAkC,GACtD,MAAM,CAGR"}

package/lib/typescript/module/overlay/toast/ToastOutlet.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The toast rendering surface, mounted once by `BlendNativeProvider`.
+ *
+ * Subscribes to the store and renders the newest `MAX_VISIBLE_TOASTS`
+ * bottom-stacked above everything through a `Portal`. Each toast slides up
+ * on entry (a fade under reduce-motion), owns its auto-dismiss timer, and
+ * announces itself to assistive tech when asked.
+ */
+export declare function ToastOutlet(): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace ToastOutlet {
+    var displayName: string;
+}
+/** Exit duration is not modelled yet — dismissal unmounts immediately;
+ * SnackbarV2 will own richer exit choreography when it lands. Kept simple
+ * so the host stays predictable under the synchronous test mock. */
+export declare const TOAST_EXIT_DURATION: 150;
+//# sourceMappingURL=ToastOutlet.d.ts.map

package/lib/typescript/module/overlay/toast/ToastOutlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastOutlet.d.ts","sourceRoot":"","sources":["../../../../../src/overlay/toast/ToastOutlet.tsx"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,mDAuB1B;yBAvBe,WAAW;;;AA8E3B;;oEAEoE;AACpE,eAAO,MAAM,mBAAmB,KAAuB,CAAA"}

package/lib/typescript/module/overlay/toast/toastStore.d.ts

@@ -0,0 +1,45 @@
+import type React from 'react';
+/**
+ * Toast queue — the sonner role, minus the styling.
+ *
+ * A module-level store with an imperative `showToast`/`dismissToast` API,
+ * so any code (not just components) can raise a toast; the outlet the
+ * provider mounts subscribes and renders. SnackbarV2 will layer its token
+ * styling on top of this host; the host itself owns only queueing,
+ * stacking, timing, and announcements.
+ *
+ * RN-free (a `React.ReactNode` type is the only React surface) so queue
+ * semantics unit-test under vitest.
+ */
+export type ToastOptions = {
+    /** Reusing an id replaces that toast's content in place. */
+    id?: string;
+    /** The rendered toast; a function receives its own dismiss. */
+    content: React.ReactNode | ((dismiss: () => void) => React.ReactNode);
+    /** Auto-dismiss delay in ms; `null` keeps the toast until dismissed. */
+    duration?: number | null;
+    /** Spoken to assistive tech when the toast appears. */
+    announcement?: string;
+};
+export type ToastEntry = Required<Pick<ToastOptions, 'content'>> & {
+    id: string;
+    duration: number | null;
+    announcement?: string;
+};
+/** How many toasts render at once; older ones wait in the queue. */
+export declare const MAX_VISIBLE_TOASTS = 3;
+/** Default auto-dismiss delay, matching sonner's. */
+export declare const DEFAULT_TOAST_DURATION = 4000;
+type Listener = (toasts: readonly ToastEntry[]) => void;
+/** Raise a toast; returns its id. */
+export declare function showToast(options: ToastOptions): string;
+/** Dismiss one toast, or every toast when no id is given. */
+export declare function dismissToast(id?: string): void;
+export declare function getToasts(): readonly ToastEntry[];
+/** The slice the outlet renders: the newest MAX_VISIBLE. */
+export declare function getVisibleToasts(all?: readonly ToastEntry[]): readonly ToastEntry[];
+export declare function subscribeToasts(listener: Listener): () => void;
+/** Test hook — clears the queue without notifying. */
+export declare function resetToasts(): void;
+export {};
+//# sourceMappingURL=toastStore.d.ts.map

package/lib/typescript/module/overlay/toast/toastStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toastStore.d.ts","sourceRoot":"","sources":["../../../../../src/overlay/toast/toastStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,YAAY,GAAG;IACvB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,+DAA+D;IAC/D,OAAO,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;IACrE,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,GAAG;IAC/D,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,KAAK,IAAI,CAAA;AAUvD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAkBvD;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAG9C;AAED,wBAAgB,SAAS,IAAI,SAAS,UAAU,EAAE,CAEjD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAC5B,GAAG,GAAE,SAAS,UAAU,EAAW,GACpC,SAAS,UAAU,EAAE,CAEvB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAG9D;AAED,sDAAsD;AACtD,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}

package/lib/typescript/module/overlay/useAnchoredPosition.d.ts

@@ -0,0 +1,40 @@
+import { type LayoutChangeEvent, type View } from 'react-native';
+import { type Alignment, type AnchoredPosition, type Placement } from './positioning.js';
+/**
+ * Measurement plumbing for `computeAnchoredPosition`.
+ *
+ * Wires the three inputs the pure engine needs: the anchor's window rect
+ * (`measureInWindow`, taken when the overlay opens), the floating content's
+ * size (its `onLayout`), and the window size (re-renders on rotation).
+ *
+ * ```tsx
+ * const { anchorRef, measureAnchor, onContentLayout, position } =
+ *     useAnchoredPosition({ placement: 'bottom' })
+ *
+ * <Pressable ref={anchorRef} onPress={() => { measureAnchor(); open() }} />
+ * <Portal>
+ *   <View
+ *     onLayout={onContentLayout}
+ *     style={position && {
+ *       position: 'absolute', left: position.x, top: position.y,
+ *       maxHeight: position.maxHeight, opacity: 1,
+ *     }}
+ *   />
+ * </Portal>
+ * ```
+ *
+ * `position` is `null` until both measurements land — render the content
+ * transparent (not unmounted, or `onLayout` never fires) until then.
+ */
+export declare function useAnchoredPosition(options?: {
+    placement?: Placement;
+    alignment?: Alignment;
+    offset?: number;
+    viewportPadding?: number;
+}): {
+    anchorRef: import("react").RefObject<View | null>;
+    measureAnchor: () => void;
+    onContentLayout: (event: LayoutChangeEvent) => void;
+    position: AnchoredPosition | null;
+};
+//# sourceMappingURL=useAnchoredPosition.d.ts.map