@webority-technologies/mobile 0.0.4 → 0.0.6

package/README.md

@@ -394,6 +394,78 @@ For runnable usage of every component, see [`example/`](../../example/).
 
 ---
 
+## Designing skeleton-aware components
+
+Presentational primitives (`Card`, `ListItem`, `Avatar`, `Badge`, `Banner`, `Chip`,
+`Rating`, `Stepper`, `ImageGallery`) accept an optional
+`loading?: boolean` prop. When `true`, the component renders its normal layout wrapped
+in `<SkeletonContent loading mode="auto">` — the walker replaces every `<Text>`,
+`<Image>`, and sized leaf `<View>` with a shimmer block matching the element's
+dimensions. When `loading` is `false` or omitted, behaviour is unchanged.
+
+Conventions for components that opt into this pattern:
+
+- **Render gracefully with undefined data.** Use optional chaining and string defaults
+  so the auto walker has leaves to skeletonize even before data arrives:
+  `{item?.title ?? ' '}`, `{item?.subtitle ?? ' '}`. Never let a `<Text>` render `undefined`.
+- **Use explicit dimensions on visual elements.** Set `width`/`height` on `<Image>` and
+  `<View>` leaves, and `fontSize` on `<Text>`, so the walker can size each shimmer
+  block correctly. Inline styles, `StyleSheet.create`, and arrays all work — they get
+  flattened.
+- **Wrap once at the top.** Don't sprinkle `<SkeletonContent>` inside subtrees; wrap the
+  component's final return so the entire layout becomes a single coherent placeholder.
+- **For data-driven lists, prefer `<SkeletonList>`.** It owns the "show N placeholder
+  rows while loading, then real data" branching so callers don't hand-roll it.
+
+Before / after with `Card`:
+
+```tsx
+// Before — caller hand-rolls a placeholder branch
+{
+  loading ? (
+    <SkeletonCard />
+  ) : (
+    <Card>
+      <Text>{site.name}</Text>
+      <Text>{site.address}</Text>
+    </Card>
+  );
+}
+
+// After — Card itself is skeleton-aware
+<Card loading={loading}>
+  <Text>{site?.name ?? ' '}</Text>
+  <Text>{site?.address ?? ' '}</Text>
+</Card>;
+```
+
+### Two flavours of `loading`
+
+Same prop name, different semantic by category:
+
+- **Display primitives** (`Card`, `ListItem`, `Avatar`, `Badge`, `Banner`, `Chip`, `Rating`,
+  `Stepper`, `ImageGallery`) — `loading={true}` renders the component as a skeleton placeholder
+  via `SkeletonContent`'s auto walker. Use when the data driving the component is still being
+  fetched.
+- **Interactive triggers** (`Button`) — `loading={true}` swaps the label for an inline `Spinner`,
+  hides leading/trailing icons, and disables press handling. The button keeps its footprint and
+  visual style. Use when an action is in flight (submit, save, delete) — pending action, not
+  data fetch.
+
+Before / after with `Button`:
+
+```tsx
+// Before — caller swaps a separate spinner in
+{
+  submitting ? <Spinner size="small" /> : <Button title="Save" onPress={save} />;
+}
+
+// After — Button itself signals the in-flight action
+<Button title="Save" loading={submitting} onPress={save} />;
+```
+
+---
+
 ## License
 
 MIT. Copyright © Webority Technologies.

package/lib/commonjs/components/Accordion/Accordion.js

@@ -8,6 +8,7 @@ var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
 var _hapticUtils = require("../../utils/hapticUtils.js");
+var _index2 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const AccordionGroupContext = /*#__PURE__*/(0, _react.createContext)(null);
@@ -92,7 +93,8 @@ const Accordion = props => {
     style,
     headerStyle,
     contentStyle,
-    testID
+    testID,
+    loading = false
   } = props;
   const theme = (0, _index.useTheme)();
   const styles = (0, _react.useMemo)(() => buildStyles(theme), [theme]);
@@ -158,6 +160,23 @@ const Accordion = props => {
     backgroundColor: theme.colors.background.elevated,
     borderRadius: theme.radius.md
   }] : null;
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      style: [cardStyle, style],
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: styles.header,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: [styles.title, {
+            fontSize: theme.typography.fontSize.base
+          }],
+          numberOfLines: 1,
+          children: title ?? ' '
+        })
+      })
+    });
+  }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: [cardStyle, style],
     testID: testID,

package/lib/commonjs/components/Avatar/Avatar.js

@@ -7,6 +7,7 @@ exports.default = exports.AvatarGroup = exports.Avatar = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
+var _index2 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const sizeMap = {
@@ -69,6 +70,7 @@ const Avatar = exports.Avatar = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
     statusPosition = 'bottomRight',
     backgroundColor,
     color,
+    loading = false,
     accessibilityLabel,
     style,
     textStyle,
@@ -89,7 +91,7 @@ const Avatar = exports.Avatar = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
   const statusSize = Math.max(8, Math.round(dimension * 0.25));
   const statusBorder = 2;
   const a11yLabel = accessibilityLabel ?? (name ? `${name}'s avatar` : 'Avatar');
-  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+  const rendered = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     ref: ref,
     style: [styles.root, {
       width: dimension,
@@ -119,7 +121,7 @@ const Avatar = exports.Avatar = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
       }, textStyle],
       numberOfLines: 1,
       allowFontScaling: false,
-      children: initials
+      children: initials ?? ' '
     }), status ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
       style: [styles.status, statusPosition === 'topRight' ? styles.statusTopRight : styles.statusBottomRight, {
         width: statusSize,
@@ -133,6 +135,14 @@ const Avatar = exports.Avatar = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
       pointerEvents: "none"
     }) : null]
   });
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Avatar.displayName = 'Avatar';
 const styles = _reactNative.StyleSheet.create({

package/lib/commonjs/components/Badge/Badge.js

@@ -7,6 +7,7 @@ exports.default = exports.Badge = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
+var _index2 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const toneFor = (theme, tone) => {
@@ -102,6 +103,7 @@ const Badge = exports.Badge = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =
     tone = 'error',
     size = 'sm',
     invisible = false,
+    loading = false,
     children,
     anchor = 'topRight',
     pulse = false,
@@ -174,23 +176,28 @@ const Badge = exports.Badge = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =
       }, textStyle],
       numberOfLines: 1,
       allowFontScaling: false,
-      children: formatted
+      children: formatted ?? ' '
     }) : null
   }) : null;
-  if (children) {
-    return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-      ref: ref,
-      style: [styles.wrapper, style],
-      testID: testID,
-      children: [children, badgeContent]
-    });
-  }
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+  const rendered = children ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    ref: ref,
+    style: [styles.wrapper, style],
+    testID: testID,
+    children: [children, badgeContent]
+  }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
     ref: ref,
     style: style,
     testID: testID,
     children: badgeContent
   });
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Badge.displayName = 'Badge';
 const styles = _reactNative.StyleSheet.create({

package/lib/commonjs/components/Banner/Banner.js

@@ -7,6 +7,7 @@ exports.default = exports.Banner = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
+var _index2 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
@@ -20,6 +21,7 @@ const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
     onDismiss,
     visible = true,
     animateMount = true,
+    loading = false,
     accessibilityLabel,
     style,
     testID
@@ -64,6 +66,8 @@ const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [visible]);
   if (!mounted) return null;
+  const safeTitle = title ?? ' ';
+  const safeMessageString = typeof message === 'string' ? message ?? ' ' : '';
   const renderIcon = () => {
     if (icon === false) return null;
     if (icon) return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
@@ -86,7 +90,7 @@ const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
   const messageString = typeof message === 'string' ? message : '';
   const builtA11y = accessibilityLabel ?? (title ? `${title}. ${messageString}` : messageString || undefined);
   const liveRegion = variant === 'error' ? 'assertive' : 'polite';
-  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Animated.View, {
+  const rendered = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Animated.View, {
     ref: ref,
     accessibilityRole: 'alert',
     accessibilityLiveRegion: liveRegion,
@@ -109,7 +113,7 @@ const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
       style: styles.row,
       children: [renderIcon(), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
         style: styles.textBlock,
-        children: [title ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: [title || loading ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
           style: {
             color: theme.colors.text.primary,
             fontSize: theme.typography.fontSize.base,
@@ -117,15 +121,15 @@ const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
             lineHeight: 20
           },
           numberOfLines: 2,
-          children: title
-        }) : null, typeof message === 'string' ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          children: safeTitle
+        }) : null, typeof message === 'string' || loading ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
           style: {
             color: theme.colors.text.secondary,
             fontSize: theme.typography.fontSize.sm,
             lineHeight: 18,
             marginTop: title ? 2 : 0
           },
-          children: message
+          children: safeMessageString || ' '
         }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
           style: {
             marginTop: title ? 2 : 0
@@ -179,6 +183,14 @@ const Banner = exports.Banner = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
       })
     }) : null]
   });
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Banner.displayName = 'Banner';
 const tintFor = (theme, variant) => {

package/lib/commonjs/components/Button/Button.js

@@ -9,6 +9,7 @@ var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
 var _usePressAnimation = require("../../hooks/usePressAnimation.js");
 var _hapticUtils = require("../../utils/hapticUtils.js");
+var _index2 = require("../Spinner/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const Button = exports.Button = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
@@ -55,9 +56,11 @@ const Button = exports.Button = /*#__PURE__*/(0, _react.forwardRef)((props, ref)
   const accessibleLabel = accessibilityLabel ?? title;
   const content = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
     style: styles.contentRow,
-    children: loading ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ActivityIndicator, {
+    children: loading ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.Spinner, {
+      variant: "circular",
+      size: "small",
       color: variantStyles.textColor,
-      size: size === 'xs' || size === 'sm' ? 'small' : 'small'
+      accessibilityLabel: "Loading"
     }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
       children: [leftIcon ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
         style: styles.iconLeft,

package/lib/commonjs/components/Card/Card.js

@@ -9,6 +9,7 @@ var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
 var _usePressAnimation = require("../../hooks/usePressAnimation.js");
 var _hapticUtils = require("../../utils/hapticUtils.js");
+var _index2 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const paddingMap = {
@@ -32,6 +33,7 @@ const Card = exports.Card = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
     imageHeight = 160,
     imageAspectRatio,
     imageOverlay,
+    loading = false,
     onPress,
     accessibilityLabel,
     accessibilityHint,
@@ -132,12 +134,13 @@ const Card = exports.Card = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
       children: innerContent
     })]
   }) : innerContent;
+  let rendered;
   if (isInteractive) {
     const handlePress = event => {
       (0, _hapticUtils.triggerHaptic)('selection');
       onPress?.(event);
     };
-    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
+    rendered = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
       style: [{
         transform: [{
           scale
@@ -161,16 +164,25 @@ const Card = exports.Card = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
         children: content
       })
     });
+  } else {
+    rendered = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      ref: ref,
+      accessibilityLabel: accessibilityLabel,
+      accessibilityHint: accessibilityHint,
+      accessibilityRole: accessibilityRole,
+      testID: testID,
+      style: [containerStyle, style],
+      children: content
+    });
   }
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-    ref: ref,
-    accessibilityLabel: accessibilityLabel,
-    accessibilityHint: accessibilityHint,
-    accessibilityRole: accessibilityRole,
-    testID: testID,
-    style: [containerStyle, style],
-    children: content
-  });
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Card.displayName = 'Card';
 const buildStyles = theme => _reactNative.StyleSheet.create({

package/lib/commonjs/components/Carousel/Carousel.js

@@ -8,6 +8,7 @@ var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
 var _index2 = require("../../utils/index.js");
+var _index3 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
@@ -54,7 +55,8 @@ const CarouselInner = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
     accessibilityLabel,
     testID,
     showThumbnails = false,
-    renderThumbnail
+    renderThumbnail,
+    loading = false
   } = props;
   const theme = (0, _index.useTheme)();
   const isControlled = typeof controlledIndex === 'number';
@@ -215,6 +217,21 @@ const CarouselInner = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
     offset: slideStride * i,
     index: i
   }), [slideStride]);
+  if (loading) {
+    const slideWidth = itemWidth === 'screen' ? containerWidth || 320 : itemWidth;
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index3.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      style: [styles.container, containerStyle],
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: {
+          width: slideWidth,
+          height: 160,
+          borderRadius: 12
+        }
+      })
+    });
+  }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: [styles.container, containerStyle],
     onLayout: e => setContainerWidth(e.nativeEvent.layout.width),

package/lib/commonjs/components/Chip/Chip.js

@@ -9,6 +9,7 @@ var _reactNative = require("react-native");
 var _index = require("../../theme/index.js");
 var _usePressAnimation = require("../../hooks/usePressAnimation.js");
 var _hapticUtils = require("../../utils/hapticUtils.js");
+var _index2 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const toneFor = (theme, tone) => {
@@ -101,6 +102,7 @@ const Chip = exports.Chip = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
     tone = 'neutral',
     size = 'md',
     disabled = false,
+    loading = false,
     accessibilityLabel,
     style,
     textStyle,
@@ -159,7 +161,7 @@ const Chip = exports.Chip = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
         fontWeight: theme.typography.fontWeight.medium
       }, textStyle],
       numberOfLines: 1,
-      children: label
+      children: label ?? ' '
     }), onClose ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
       onPress: handleClose,
       disabled: disabled,
@@ -200,8 +202,9 @@ const Chip = exports.Chip = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
     borderColor,
     opacity: disabled ? 0.55 : 1
   };
+  let rendered;
   if (isPressable) {
-    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
+    rendered = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
       style: {
         transform: [{
           scale
@@ -233,20 +236,29 @@ const Chip = exports.Chip = /*#__PURE__*/(0, _react.forwardRef)((props, ref) =>
         children: content
       })
     });
+  } else {
+    rendered = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      ref: ref,
+      style: [styles.base, baseStyle, style],
+      accessible: true,
+      accessibilityRole: "text",
+      accessibilityLabel: a11yLabel,
+      accessibilityState: {
+        selected,
+        disabled
+      },
+      testID: testID,
+      children: content
+    });
   }
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-    ref: ref,
-    style: [styles.base, baseStyle, style],
-    accessible: true,
-    accessibilityRole: "text",
-    accessibilityLabel: a11yLabel,
-    accessibilityState: {
-      selected,
-      disabled
-    },
-    testID: testID,
-    children: content
-  });
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Chip.displayName = 'Chip';
 const styles = _reactNative.StyleSheet.create({

package/lib/commonjs/components/ImageGallery/ImageGallery.js

@@ -10,8 +10,9 @@ var _reactNativeGestureHandler = require("react-native-gesture-handler");
 var _reactNativeReanimated = _interopRequireWildcard(require("react-native-reanimated"));
 var _index = require("../Carousel/index.js");
 var _index2 = require("../AppIcon/index.js");
-var _index3 = require("../../theme/index.js");
-var _index4 = require("../../utils/index.js");
+var _index3 = require("../Skeleton/index.js");
+var _index4 = require("../../theme/index.js");
+var _index5 = require("../../utils/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
@@ -49,11 +50,12 @@ const ImageGallery = ({
   enableLightbox = true,
   enablePinchZoom = true,
   onIndexChange,
+  loading = false,
   accessibilityLabel,
   containerStyle,
   testID
 }) => {
-  const theme = (0, _index3.useTheme)();
+  const theme = (0, _index4.useTheme)();
   const styles = (0, _react.useMemo)(() => buildStyles(theme), [theme]);
   const [currentIndex, setCurrentIndex] = (0, _react.useState)(clamp(initialIndex, 0, Math.max(0, images.length - 1)));
   const [lightboxOpen, setLightboxOpen] = (0, _react.useState)(false);
@@ -63,11 +65,11 @@ const ImageGallery = ({
   }, [onIndexChange]);
   const openLightbox = (0, _react.useCallback)(() => {
     if (!enableLightbox) return;
-    (0, _index4.triggerHaptic)('selection');
+    (0, _index5.triggerHaptic)('selection');
     setLightboxOpen(true);
   }, [enableLightbox]);
   const closeLightbox = (0, _react.useCallback)(() => {
-    (0, _index4.triggerHaptic)('selection');
+    (0, _index5.triggerHaptic)('selection');
     setLightboxOpen(false);
   }, []);
   const renderImage = (0, _react.useCallback)((image, idx) => {
@@ -90,7 +92,7 @@ const ImageGallery = ({
     style: styles.thumbnailImage,
     resizeMode: "cover"
   }), [styles]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+  const rendered = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: [styles.container, containerStyle],
     testID: testID,
     accessibilityLabel: accessibilityLabel ?? 'Image gallery',
@@ -125,6 +127,14 @@ const ImageGallery = ({
       onIndexChange: handleIndexChange
     }) : null]
   });
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index3.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 };
 exports.ImageGallery = ImageGallery;
 ImageGallery.displayName = 'ImageGallery';
@@ -140,13 +150,13 @@ const Lightbox = ({
   onClose,
   onIndexChange
 }) => {
-  const theme = (0, _index3.useTheme)();
+  const theme = (0, _index4.useTheme)();
   const styles = (0, _react.useMemo)(() => buildLightboxStyles(theme), [theme]);
   const carouselRef = (0, _react.useRef)(null);
   const [activeIndex, setActiveIndex] = (0, _react.useState)(initialIndex);
   const handleSwipe = (0, _react.useCallback)(idx => {
     if (idx !== activeIndex) {
-      (0, _index4.triggerHaptic)('selection');
+      (0, _index5.triggerHaptic)('selection');
       setActiveIndex(idx);
       onIndexChange(idx);
     }
@@ -255,7 +265,7 @@ const ZoomableImage = ({
       savedTranslateY.value = 0;
     }
   }, [active, scale, translateX, translateY, savedScale, savedTranslateX, savedTranslateY]);
-  const triggerImpact = (0, _react.useCallback)(() => (0, _index4.triggerHaptic)('impactLight'), []);
+  const triggerImpact = (0, _react.useCallback)(() => (0, _index5.triggerHaptic)('impactLight'), []);
   const pinch = (0, _react.useMemo)(() => _reactNativeGestureHandler.Gesture.Pinch().enabled(enabled).onStart(() => {
     'worklet';
 

package/lib/commonjs/components/ListItem/ListItem.js

@@ -10,6 +10,7 @@ var _index = require("../../theme/index.js");
 var _usePressAnimation = require("../../hooks/usePressAnimation.js");
 var _hapticUtils = require("../../utils/hapticUtils.js");
 var _index2 = require("../Swipeable/index.js");
+var _index3 = require("../Skeleton/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const sizeFor = (theme, size) => {
@@ -56,6 +57,7 @@ const chevronStyles = _reactNative.StyleSheet.create({
 const ListItem = exports.ListItem = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
   const {
     title,
+    loading = false,
     subtitle,
     description,
     left,
@@ -108,7 +110,7 @@ const ListItem = exports.ListItem = /*#__PURE__*/(0, _react.forwardRef)((props,
           color: disabled ? theme.colors.text.disabled : theme.colors.text.primary
         }],
         numberOfLines: 1,
-        children: title
+        children: title ?? ' '
       }), subtitle ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
         style: [styles.subtitle, {
           fontSize: sz.subtitleSize,
@@ -179,15 +181,20 @@ const ListItem = exports.ListItem = /*#__PURE__*/(0, _react.forwardRef)((props,
 
   // Wrap in Swipeable only when at least one side has actions; otherwise keep zero gesture overhead.
   const hasSwipe = leftActions && leftActions.length > 0 || rightActions && rightActions.length > 0;
-  if (hasSwipe) {
-    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.Swipeable, {
-      leftActions: leftActions,
-      rightActions: rightActions,
-      accessibilityLabel: a11yLabel,
-      children: rendered
+  const final = hasSwipe ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.Swipeable, {
+    leftActions: leftActions,
+    rightActions: rightActions,
+    accessibilityLabel: a11yLabel,
+    children: rendered
+  }) : rendered;
+  if (loading) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_index3.SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: final
     });
   }
-  return rendered;
+  return final;
 });
 ListItem.displayName = 'ListItem';
 const buildStyles = theme => _reactNative.StyleSheet.create({