@retray-dev/ui-kit 7.0.1 → 9.0.0

package/dist/RadioGroup.js

@@ -3,6 +3,7 @@
 var React2 = require('react');
 var reactNative = require('react-native');
 var Animated = require('react-native-reanimated');
+var reactNativeEase = require('react-native-ease');
 var reactNativeSizeMatters = require('react-native-size-matters');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -10,18 +11,65 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var React2__default = /*#__PURE__*/_interopDefault(React2);
 var Animated__default = /*#__PURE__*/_interopDefault(Animated);
 
-// src/components/RadioGroup/RadioGroup.tsx
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var _haptics = null;
+var _hapticsLoaded = false;
 async function getHaptics() {
   if (reactNative.Platform.OS === "web") return null;
-  if (!_haptics) {
-    _haptics = await import('expo-haptics');
+  if (!_hapticsLoaded) {
+    _hapticsLoaded = true;
+    try {
+      _haptics = await import('expo-haptics');
+    } catch {
+      _haptics = null;
+    }
   }
   return _haptics;
 }
+var _pulsar = null;
+var _pulsarChecked = false;
+var _pulsarAvailable = false;
+function isPulsarNativeRegistered() {
+  try {
+    const g = globalThis;
+    if (typeof g.__turboModuleProxy === "function") {
+      return g.__turboModuleProxy("RNPulsar") != null;
+    }
+    return reactNative.NativeModules?.RNPulsar != null;
+  } catch {
+    return false;
+  }
+}
+function getPulsar() {
+  if (reactNative.Platform.OS === "web") return null;
+  if (!_pulsarChecked) {
+    _pulsarChecked = true;
+    try {
+      if (isPulsarNativeRegistered()) {
+        _pulsar = __require("react-native-pulsar");
+        _pulsarAvailable = true;
+      }
+    } catch {
+      _pulsar = null;
+      _pulsarAvailable = false;
+    }
+  }
+  return _pulsarAvailable ? _pulsar : null;
+}
 function selectionAsync() {
   if (reactNative.Platform.OS === "web") return;
-  getHaptics().then((h) => h?.selectionAsync());
+  getHaptics().then((h) => {
+    if (h) {
+      h.selectionAsync();
+    } else {
+      getPulsar()?.Presets.System.selection();
+    }
+  });
 }
 
 // src/theme/colorUtils.ts
@@ -150,20 +198,28 @@ var mvs = isWeb ? (n, _factor) => n : reactNativeSizeMatters.moderateVerticalSca
 var SPRINGS = {
   /** Tight, premium press feel — Buttons, Toggle, Tabs triggers. */
   pressIn: { stiffness: 600, damping: 35, mass: 0.8 },
-  pressOut: { stiffness: 280, damping: 22, mass: 0.8 },
-  /** Elastic indicator — Switch thumb, RadioGroup dot. */
-  elastic: { stiffness: 320, damping: 22, mass: 0.7 }
-};
+  pressOut: { stiffness: 280, damping: 22, mass: 0.8 }};
 var TIMINGS = {
   /** Color/opacity transitions on toggles, checkboxes, switches. */
   state: { duration: 160 }};
-var EASINGS = {
+({
   /** Material-style ease-out — natural deceleration for state changes. */
   standard: Animated.Easing.bezier(0.2, 0, 0, 1),
   /** Strong ease-out for expanding surfaces (Accordion open). */
   expand: Animated.Easing.bezier(0.23, 1, 0.32, 1),
   /** Quick ease-in for collapsing. */
   collapse: Animated.Easing.in(Animated.Easing.ease)
+});
+var COLOR_TRANSITION = {
+  type: "timing",
+  duration: TIMINGS.state.duration,
+  easing: [0.2, 0, 0, 1]
+};
+var SPRING_ELASTIC = {
+  type: "spring",
+  stiffness: 320,
+  damping: 22,
+  mass: 0.7
 };
 var PRESS_SCALE = {
   button: 0.95};
@@ -208,14 +264,6 @@ function usePressScale({
     hoverHandlers
   };
 }
-function useColorTransition(active, options = {}) {
-  const { duration = TIMINGS.state.duration } = options;
-  const progress = Animated.useSharedValue(active ? 1 : 0);
-  React2.useEffect(() => {
-    progress.value = Animated.withTiming(active ? 1 : 0, { duration, easing: EASINGS.standard });
-  }, [active, duration, progress]);
-  return progress;
-}
 
 // src/components/RadioGroup/RadioGroup.tsx
 function RadioItem({
@@ -228,18 +276,6 @@ function RadioItem({
     pressScale: PRESS_SCALE.button,
     disabled: option.disabled
   });
-  const colorProgress = useColorTransition(selected);
-  const dotScale = Animated.useSharedValue(selected ? 1 : 0);
-  React2.useEffect(() => {
-    dotScale.value = Animated.withSpring(selected ? 1 : 0, SPRINGS.elastic);
-  }, [selected, dotScale]);
-  const radioStyle = Animated.useAnimatedStyle(() => ({
-    borderColor: Animated.interpolateColor(colorProgress.value, [0, 1], [colors.border, colors.primary])
-  }));
-  const dotStyle = Animated.useAnimatedStyle(() => ({
-    transform: [{ scale: dotScale.value }],
-    opacity: dotScale.value
-  }));
   return (
     // AUDIT FIX: opacity was applied only to the radio circle, leaving the label
     // at full opacity when disabled. The whole row now dims uniformly so users
@@ -263,7 +299,22 @@ function RadioItem({
         accessibilityLabel: option.label,
         accessibilityState: { checked: selected, disabled: !!option.disabled }
       },
-      /* @__PURE__ */ React2__default.default.createElement(Animated__default.default.View, { style: scaleStyle }, /* @__PURE__ */ React2__default.default.createElement(Animated__default.default.View, { style: [styles.radio, radioStyle] }, /* @__PURE__ */ React2__default.default.createElement(Animated__default.default.View, { style: [styles.dot, { backgroundColor: colors.primary }, dotStyle] }))),
+      /* @__PURE__ */ React2__default.default.createElement(Animated__default.default.View, { style: scaleStyle }, /* @__PURE__ */ React2__default.default.createElement(
+        reactNativeEase.EaseView,
+        {
+          style: styles.radio,
+          animate: { borderColor: selected ? colors.primary : colors.border },
+          transition: COLOR_TRANSITION
+        },
+        /* @__PURE__ */ React2__default.default.createElement(
+          reactNativeEase.EaseView,
+          {
+            style: [styles.dot, { backgroundColor: colors.primary }],
+            animate: { scale: selected ? 1 : 0, opacity: selected ? 1 : 0 },
+            transition: SPRING_ELASTIC
+          }
+        )
+      )),
       /* @__PURE__ */ React2__default.default.createElement(
         reactNative.Text,
         {

package/dist/RadioGroup.mjs

@@ -1,7 +1,7 @@
-export { RadioGroup } from './chunk-YZJAFS4P.mjs';
-import './chunk-7H2OR44A.mjs';
-import './chunk-QCNARS3X.mjs';
-import './chunk-RTC3CFXF.mjs';
-import './chunk-5IKW3VNC.mjs';
+export { RadioGroup } from './chunk-X4G6APW6.mjs';
+import './chunk-YNROWHQJ.mjs';
+import './chunk-EJ7ZPXOH.mjs';
+import './chunk-DVK4G2GT.mjs';
 import './chunk-SOYNZDVY.mjs';
 import './chunk-2CE3TQVY.mjs';
+import './chunk-Y6FXYEAI.mjs';

package/dist/RetrayProvider.d.mts

@@ -0,0 +1,2 @@
+export { c as RetrayProvider, d as RetrayProviderProps } from './index-wt-orHUi.mjs';
+import 'react';

package/dist/RetrayProvider.d.ts

@@ -0,0 +1,2 @@
+export { c as RetrayProvider, d as RetrayProviderProps } from './index-wt-orHUi.js';
+import 'react';

package/dist/RetrayProvider.js

@@ -0,0 +1,214 @@
+'use strict';
+
+var React3 = require('react');
+var reactNative = require('react-native');
+var reactNativeSafeAreaContext = require('react-native-safe-area-context');
+var reactNativeGestureHandler = require('react-native-gesture-handler');
+var bottomSheet = require('@gorhom/bottom-sheet');
+var sonnerNative = require('sonner-native');
+var reactNativeSizeMatters = require('react-native-size-matters');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React3__default = /*#__PURE__*/_interopDefault(React3);
+
+// src/components/RetrayProvider/RetrayProvider.tsx
+
+// src/theme/colorUtils.ts
+function hexToRgb(hex) {
+  const clean = hex.replace("#", "");
+  const full = clean.length === 3 ? clean.split("").map((c) => c + c).join("") : clean;
+  if (full.length !== 6) return null;
+  return {
+    r: parseInt(full.slice(0, 2), 16),
+    g: parseInt(full.slice(2, 4), 16),
+    b: parseInt(full.slice(4, 6), 16)
+  };
+}
+function componentToHex(c) {
+  return Math.round(Math.max(0, Math.min(255, c))).toString(16).padStart(2, "0");
+}
+function rgbToHex(r, g, b) {
+  return `#${componentToHex(r)}${componentToHex(g)}${componentToHex(b)}`;
+}
+function withAlphaOnWhite(hex, alpha) {
+  const rgb = hexToRgb(hex);
+  if (!rgb) return hex;
+  const r = rgb.r * alpha + 255 * (1 - alpha);
+  const g = rgb.g * alpha + 255 * (1 - alpha);
+  const b = rgb.b * alpha + 255 * (1 - alpha);
+  return rgbToHex(r, g, b);
+}
+function withAlphaOnDark(hex, alpha, bgHex = "#0f0f0f") {
+  const rgb = hexToRgb(hex);
+  const bg = hexToRgb(bgHex);
+  if (!rgb || !bg) return hex;
+  const r = rgb.r * alpha + bg.r * (1 - alpha);
+  const g = rgb.g * alpha + bg.g * (1 - alpha);
+  const b = rgb.b * alpha + bg.b * (1 - alpha);
+  return rgbToHex(r, g, b);
+}
+function mixWithBackground(fgHex, bgHex, opacity) {
+  const fg = hexToRgb(fgHex);
+  const bg = hexToRgb(bgHex);
+  if (!fg || !bg) return fgHex;
+  const r = fg.r * opacity + bg.r * (1 - opacity);
+  const g = fg.g * opacity + bg.g * (1 - opacity);
+  const b = fg.b * opacity + bg.b * (1 - opacity);
+  return rgbToHex(r, g, b);
+}
+function lighten(hex, amount) {
+  return withAlphaOnWhite(hex, 1 - amount);
+}
+function darken(hex, amount) {
+  const rgb = hexToRgb(hex);
+  if (!rgb) return hex;
+  return rgbToHex(rgb.r * (1 - amount), rgb.g * (1 - amount), rgb.b * (1 - amount));
+}
+
+// src/theme/colors.ts
+var defaultLight = {
+  background: "#ffffff",
+  foreground: "#1a1a1a",
+  card: "#ffffff",
+  primary: "#1a1a1a",
+  primaryForeground: "#ffffff",
+  // AUDIT FIX: brand accent — was undefined; falls back to primary when omitted
+  accent: "#d4561d",
+  accentForeground: "#ffffff",
+  border: "#dddddd",
+  // AUDIT FIX: was #e53935 (4.22:1 on white — fails AA); #c72828 = 5.59:1 ✓
+  destructive: "#c72828",
+  destructiveForeground: "#ffffff",
+  success: "#1a7a45",
+  successForeground: "#ffffff",
+  // AUDIT FIX: was #e67e00 (2.86:1 — severe fail); #9a5200 = 5.86:1 ✓ AAA-near
+  warning: "#9a5200",
+  warningForeground: "#ffffff"
+};
+var defaultDark = {
+  background: "#0f0f0f",
+  foreground: "#fafafa",
+  card: "#1c1c1c",
+  primary: "#fafafa",
+  primaryForeground: "#0f0f0f",
+  // AUDIT FIX: lighter accent for dark surfaces (warm amber-orange)
+  accent: "#e87645",
+  accentForeground: "#ffffff",
+  border: "#303030",
+  destructive: "#ef5350",
+  destructiveForeground: "#ffffff",
+  success: "#2e7d52",
+  successForeground: "#ffffff",
+  // AUDIT FIX: brighter amber for dark-bg visibility; dark text for contrast
+  // #f5a623 on #0f0f0f = 8.6:1 ✓ as indicator; #0f0f0f text on #f5a623 = 8.6:1 ✓
+  warning: "#f5a623",
+  warningForeground: "#0f0f0f"
+};
+function deriveColors(t, scheme) {
+  const dark = scheme === "dark";
+  const bg = t.background;
+  const foregroundSubtle = mixWithBackground(t.foreground, bg, 0.7);
+  const foregroundMuted = mixWithBackground(t.foreground, bg, 0.62);
+  const surface = dark ? lighten(bg, -0.06) : darken(bg, 0.04);
+  const surfaceStrong = dark ? lighten(bg, -0.12) : darken(bg, 0.08);
+  const destructiveTint = dark ? withAlphaOnDark(t.destructive, 0.15, bg) : withAlphaOnWhite(t.destructive, 0.08);
+  const destructiveBorder = dark ? withAlphaOnDark(t.destructive, 0.45, bg) : withAlphaOnWhite(t.destructive, 0.3);
+  const successTint = dark ? withAlphaOnDark(t.success, 0.15, bg) : withAlphaOnWhite(t.success, 0.08);
+  const successBorder = dark ? withAlphaOnDark(t.success, 0.45, bg) : withAlphaOnWhite(t.success, 0.3);
+  const warningTint = dark ? withAlphaOnDark(t.warning, 0.15, bg) : withAlphaOnWhite(t.warning, 0.08);
+  const warningBorder = dark ? withAlphaOnDark(t.warning, 0.45, bg) : withAlphaOnWhite(t.warning, 0.3);
+  return {
+    ...t,
+    foregroundSubtle,
+    foregroundMuted,
+    surface,
+    surfaceStrong,
+    destructiveTint,
+    destructiveBorder,
+    successTint,
+    successBorder,
+    warningTint,
+    warningBorder,
+    overlay: t.overlay ?? "rgba(0,0,0,0.45)",
+    accentResolved: t.accent ?? t.primary,
+    accentForegroundResolved: t.accentForeground ?? t.primaryForeground,
+    ring: t.accent ?? t.primary,
+    input: t.border,
+    separator: dark ? lighten(t.border, 0.22) : darken(t.border, 0.16)
+  };
+}
+
+// src/theme/ThemeProvider.tsx
+var ThemeContext = React3.createContext({
+  colors: deriveColors(defaultLight, "light"),
+  colorScheme: "light"
+});
+function ThemeProvider({ children, theme, colorScheme = "system" }) {
+  const systemScheme = reactNative.useColorScheme() ?? "light";
+  const resolvedScheme = colorScheme === "system" ? systemScheme : colorScheme;
+  const colors = React3.useMemo(() => {
+    const base = resolvedScheme === "dark" ? defaultDark : defaultLight;
+    const override = resolvedScheme === "dark" ? theme?.dark : theme?.light;
+    const merged = override ? { ...base, ...override } : base;
+    return deriveColors(merged, resolvedScheme);
+  }, [resolvedScheme, theme]);
+  return /* @__PURE__ */ React3__default.default.createElement(ThemeContext.Provider, { value: { colors, colorScheme: resolvedScheme } }, children);
+}
+function useTheme() {
+  const context = React3.useContext(ThemeContext);
+  if (!context) {
+    throw new Error("useTheme must be used within a ThemeProvider");
+  }
+  return context;
+}
+var isWeb = reactNative.Platform.OS === "web";
+var s = isWeb ? (n) => n : reactNativeSizeMatters.scale;
+var vs = isWeb ? (n) => n : reactNativeSizeMatters.verticalScale;
+var ms = isWeb ? (n, _factor) => n : reactNativeSizeMatters.moderateScale;
+
+// src/components/Toast/Toast.tsx
+function ToastProvider({ children }) {
+  const { colorScheme } = useTheme();
+  const insets = reactNativeSafeAreaContext.useSafeAreaInsets();
+  return /* @__PURE__ */ React3__default.default.createElement(React3__default.default.Fragment, null, children, /* @__PURE__ */ React3__default.default.createElement(
+    sonnerNative.Toaster,
+    {
+      theme: colorScheme,
+      position: "top-center",
+      richColors: true,
+      gap: vs(8),
+      offset: insets.top + vs(8),
+      visibleToasts: 3,
+      closeButton: false,
+      swipeToDismissDirection: "up",
+      duration: 4e3,
+      toastOptions: {
+        style: {
+          borderRadius: ms(12),
+          paddingHorizontal: s(12),
+          paddingVertical: vs(10)
+        },
+        titleStyle: {
+          fontFamily: "Sohne-Medium",
+          fontSize: ms(13)
+        },
+        descriptionStyle: {
+          fontFamily: "Sohne-Regular",
+          fontSize: ms(12),
+          opacity: 0.85
+        }
+      }
+    }
+  ));
+}
+
+// src/components/RetrayProvider/RetrayProvider.tsx
+function RetrayProvider({ children, theme, colorScheme = "system" }) {
+  return /* @__PURE__ */ React3__default.default.createElement(reactNativeSafeAreaContext.SafeAreaProvider, { initialMetrics: reactNativeSafeAreaContext.initialWindowMetrics }, /* @__PURE__ */ React3__default.default.createElement(reactNativeGestureHandler.GestureHandlerRootView, { style: styles.root }, /* @__PURE__ */ React3__default.default.createElement(ThemeProvider, { theme, colorScheme }, /* @__PURE__ */ React3__default.default.createElement(bottomSheet.BottomSheetModalProvider, null, /* @__PURE__ */ React3__default.default.createElement(ToastProvider, null, children)))));
+}
+var styles = reactNative.StyleSheet.create({
+  root: { flex: 1 }
+});
+
+exports.RetrayProvider = RetrayProvider;

package/dist/RetrayProvider.mjs

@@ -0,0 +1,5 @@
+export { RetrayProvider } from './chunk-YFZ3ELX5.mjs';
+import './chunk-2UYENBLV.mjs';
+import './chunk-SOYNZDVY.mjs';
+import './chunk-2CE3TQVY.mjs';
+import './chunk-Y6FXYEAI.mjs';

package/dist/Select.js

@@ -12,18 +12,65 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var React2__default = /*#__PURE__*/_interopDefault(React2);
 var Animated__default = /*#__PURE__*/_interopDefault(Animated);
 
-// src/components/Select/Select.tsx
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var _haptics = null;
+var _hapticsLoaded = false;
 async function getHaptics() {
   if (reactNative.Platform.OS === "web") return null;
-  if (!_haptics) {
-    _haptics = await import('expo-haptics');
+  if (!_hapticsLoaded) {
+    _hapticsLoaded = true;
+    try {
+      _haptics = await import('expo-haptics');
+    } catch {
+      _haptics = null;
+    }
   }
   return _haptics;
 }
+var _pulsar = null;
+var _pulsarChecked = false;
+var _pulsarAvailable = false;
+function isPulsarNativeRegistered() {
+  try {
+    const g = globalThis;
+    if (typeof g.__turboModuleProxy === "function") {
+      return g.__turboModuleProxy("RNPulsar") != null;
+    }
+    return reactNative.NativeModules?.RNPulsar != null;
+  } catch {
+    return false;
+  }
+}
+function getPulsar() {
+  if (reactNative.Platform.OS === "web") return null;
+  if (!_pulsarChecked) {
+    _pulsarChecked = true;
+    try {
+      if (isPulsarNativeRegistered()) {
+        _pulsar = __require("react-native-pulsar");
+        _pulsarAvailable = true;
+      }
+    } catch {
+      _pulsar = null;
+      _pulsarAvailable = false;
+    }
+  }
+  return _pulsarAvailable ? _pulsar : null;
+}
 function selectionAsync() {
   if (reactNative.Platform.OS === "web") return;
-  getHaptics().then((h) => h?.selectionAsync());
+  getHaptics().then((h) => {
+    if (h) {
+      h.selectionAsync();
+    } else {
+      getPulsar()?.Presets.System.selection();
+    }
+  });
 }
 
 // src/theme/colorUtils.ts

package/dist/Select.mjs

@@ -1,6 +1,7 @@
-export { Select } from './chunk-URLL5JBR.mjs';
-import './chunk-QCNARS3X.mjs';
-import './chunk-RTC3CFXF.mjs';
-import './chunk-5IKW3VNC.mjs';
+export { Select } from './chunk-A3A6KNQN.mjs';
+import './chunk-YNROWHQJ.mjs';
+import './chunk-EJ7ZPXOH.mjs';
+import './chunk-DVK4G2GT.mjs';
 import './chunk-SOYNZDVY.mjs';
 import './chunk-2CE3TQVY.mjs';
+import './chunk-Y6FXYEAI.mjs';

package/dist/SelectableGrid.d.mts

@@ -0,0 +1,44 @@
+import React from 'react';
+import { ViewStyle } from 'react-native';
+
+interface SelectableGridItem<T extends string | number = string> {
+    /** Unique value emitted on selection. */
+    value: T;
+    /** Label rendered under the icon. */
+    label?: string;
+    /** Icon name resolved via the icon registry. */
+    iconName?: string;
+    /** Custom icon node — overrides `iconName`. */
+    icon?: React.ReactNode;
+    disabled?: boolean;
+}
+interface SelectableGridProps<T extends string | number = string> {
+    items: SelectableGridItem<T>[];
+    /** Selected value(s). Array when `multiple`. */
+    value: T | T[] | null;
+    onChange: (value: T) => void;
+    /** Allow multiple selections. `value` should be an array. Defaults to false. */
+    multiple?: boolean;
+    /** Columns per row. Defaults to 4. Ignored when `orientation='horizontal'`. */
+    numColumns?: number;
+    /** Gap between cells (dp). Defaults to 12. */
+    gap?: number;
+    /** Layout orientation. 'grid' (default) wraps into rows. 'horizontal' creates a single scrollable row. */
+    orientation?: 'grid' | 'horizontal';
+    style?: ViewStyle;
+}
+/**
+ * Grid of selectable cells (icon + label) — for store / category / emoji pickers
+ * where a list would be the wrong shape. Single or multi select.
+ *
+ * @example
+ * <SelectableGrid
+ *   items={categories}
+ *   value={selected}
+ *   onChange={setSelected}
+ *   numColumns={4}
+ * />
+ */
+declare function SelectableGrid<T extends string | number = string>({ items, value, onChange, multiple, numColumns, gap, orientation, style, }: SelectableGridProps<T>): React.JSX.Element;
+
+export { SelectableGrid, type SelectableGridItem, type SelectableGridProps };

package/dist/SelectableGrid.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import { ViewStyle } from 'react-native';
+
+interface SelectableGridItem<T extends string | number = string> {
+    /** Unique value emitted on selection. */
+    value: T;
+    /** Label rendered under the icon. */
+    label?: string;
+    /** Icon name resolved via the icon registry. */
+    iconName?: string;
+    /** Custom icon node — overrides `iconName`. */
+    icon?: React.ReactNode;
+    disabled?: boolean;
+}
+interface SelectableGridProps<T extends string | number = string> {
+    items: SelectableGridItem<T>[];
+    /** Selected value(s). Array when `multiple`. */
+    value: T | T[] | null;
+    onChange: (value: T) => void;
+    /** Allow multiple selections. `value` should be an array. Defaults to false. */
+    multiple?: boolean;
+    /** Columns per row. Defaults to 4. Ignored when `orientation='horizontal'`. */
+    numColumns?: number;
+    /** Gap between cells (dp). Defaults to 12. */
+    gap?: number;
+    /** Layout orientation. 'grid' (default) wraps into rows. 'horizontal' creates a single scrollable row. */
+    orientation?: 'grid' | 'horizontal';
+    style?: ViewStyle;
+}
+/**
+ * Grid of selectable cells (icon + label) — for store / category / emoji pickers
+ * where a list would be the wrong shape. Single or multi select.
+ *
+ * @example
+ * <SelectableGrid
+ *   items={categories}
+ *   value={selected}
+ *   onChange={setSelected}
+ *   numColumns={4}
+ * />
+ */
+declare function SelectableGrid<T extends string | number = string>({ items, value, onChange, multiple, numColumns, gap, orientation, style, }: SelectableGridProps<T>): React.JSX.Element;
+
+export { SelectableGrid, type SelectableGridItem, type SelectableGridProps };