@webority-technologies/mobile 0.0.4 → 0.0.5

package/README.md

@@ -394,6 +394,50 @@ For runnable usage of every component, see [`example/`](../../example/).
 
 ---
 
+## Designing skeleton-aware components
+
+Presentational primitives (`Card`, `ListItem`, `Avatar`, `Badge`) 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>
+```
+
+---
+
 ## License
 
 MIT. Copyright © Webority Technologies.

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/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/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({

package/lib/module/components/Avatar/Avatar.js

@@ -3,6 +3,7 @@
 import React, { Children, cloneElement, forwardRef, isValidElement, useEffect, useMemo, useRef, useState } from 'react';
 import { Animated, Easing, Image, StyleSheet, Text, View } from 'react-native';
 import { useTheme } from "../../theme/index.js";
+import { SkeletonContent } from "../Skeleton/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const sizeMap = {
   xs: 24,
@@ -64,6 +65,7 @@ const Avatar = /*#__PURE__*/forwardRef((props, ref) => {
     statusPosition = 'bottomRight',
     backgroundColor,
     color,
+    loading = false,
     accessibilityLabel,
     style,
     textStyle,
@@ -84,7 +86,7 @@ const Avatar = /*#__PURE__*/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__*/_jsxs(View, {
+  const rendered = /*#__PURE__*/_jsxs(View, {
     ref: ref,
     style: [styles.root, {
       width: dimension,
@@ -114,7 +116,7 @@ const Avatar = /*#__PURE__*/forwardRef((props, ref) => {
       }, textStyle],
       numberOfLines: 1,
       allowFontScaling: false,
-      children: initials
+      children: initials ?? ' '
     }), status ? /*#__PURE__*/_jsx(View, {
       style: [styles.status, statusPosition === 'topRight' ? styles.statusTopRight : styles.statusBottomRight, {
         width: statusSize,
@@ -128,6 +130,14 @@ const Avatar = /*#__PURE__*/forwardRef((props, ref) => {
       pointerEvents: "none"
     }) : null]
   });
+  if (loading) {
+    return /*#__PURE__*/_jsx(SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Avatar.displayName = 'Avatar';
 const styles = StyleSheet.create({

package/lib/module/components/Badge/Badge.js

@@ -3,6 +3,7 @@
 import React, { forwardRef, useEffect, useMemo, useRef } from 'react';
 import { Animated, Easing, StyleSheet, Text, View } from 'react-native';
 import { useTheme } from "../../theme/index.js";
+import { SkeletonContent } from "../Skeleton/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const toneFor = (theme, tone) => {
   switch (tone) {
@@ -97,6 +98,7 @@ const Badge = /*#__PURE__*/forwardRef((props, ref) => {
     tone = 'error',
     size = 'sm',
     invisible = false,
+    loading = false,
     children,
     anchor = 'topRight',
     pulse = false,
@@ -169,23 +171,28 @@ const Badge = /*#__PURE__*/forwardRef((props, ref) => {
       }, textStyle],
       numberOfLines: 1,
       allowFontScaling: false,
-      children: formatted
+      children: formatted ?? ' '
     }) : null
   }) : null;
-  if (children) {
-    return /*#__PURE__*/_jsxs(View, {
-      ref: ref,
-      style: [styles.wrapper, style],
-      testID: testID,
-      children: [children, badgeContent]
-    });
-  }
-  return /*#__PURE__*/_jsx(View, {
+  const rendered = children ? /*#__PURE__*/_jsxs(View, {
+    ref: ref,
+    style: [styles.wrapper, style],
+    testID: testID,
+    children: [children, badgeContent]
+  }) : /*#__PURE__*/_jsx(View, {
     ref: ref,
     style: style,
     testID: testID,
     children: badgeContent
   });
+  if (loading) {
+    return /*#__PURE__*/_jsx(SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Badge.displayName = 'Badge';
 const styles = StyleSheet.create({

package/lib/module/components/Card/Card.js

@@ -5,6 +5,7 @@ import { Animated, Image, Pressable, StyleSheet, View } from 'react-native';
 import { useTheme } from "../../theme/index.js";
 import { usePressAnimation } from "../../hooks/usePressAnimation.js";
 import { triggerHaptic } from "../../utils/hapticUtils.js";
+import { SkeletonContent } from "../Skeleton/index.js";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 const paddingMap = {
   none: 'none',
@@ -27,6 +28,7 @@ const Card = /*#__PURE__*/forwardRef((props, ref) => {
     imageHeight = 160,
     imageAspectRatio,
     imageOverlay,
+    loading = false,
     onPress,
     accessibilityLabel,
     accessibilityHint,
@@ -127,12 +129,13 @@ const Card = /*#__PURE__*/forwardRef((props, ref) => {
       children: innerContent
     })]
   }) : innerContent;
+  let rendered;
   if (isInteractive) {
     const handlePress = event => {
       triggerHaptic('selection');
       onPress?.(event);
     };
-    return /*#__PURE__*/_jsx(Animated.View, {
+    rendered = /*#__PURE__*/_jsx(Animated.View, {
       style: [{
         transform: [{
           scale
@@ -156,16 +159,25 @@ const Card = /*#__PURE__*/forwardRef((props, ref) => {
         children: content
       })
     });
+  } else {
+    rendered = /*#__PURE__*/_jsx(View, {
+      ref: ref,
+      accessibilityLabel: accessibilityLabel,
+      accessibilityHint: accessibilityHint,
+      accessibilityRole: accessibilityRole,
+      testID: testID,
+      style: [containerStyle, style],
+      children: content
+    });
   }
-  return /*#__PURE__*/_jsx(View, {
-    ref: ref,
-    accessibilityLabel: accessibilityLabel,
-    accessibilityHint: accessibilityHint,
-    accessibilityRole: accessibilityRole,
-    testID: testID,
-    style: [containerStyle, style],
-    children: content
-  });
+  if (loading) {
+    return /*#__PURE__*/_jsx(SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: rendered
+    });
+  }
+  return rendered;
 });
 Card.displayName = 'Card';
 const buildStyles = theme => StyleSheet.create({

package/lib/module/components/ListItem/ListItem.js

@@ -6,6 +6,7 @@ import { useTheme } from "../../theme/index.js";
 import { usePressAnimation } from "../../hooks/usePressAnimation.js";
 import { triggerHaptic } from "../../utils/hapticUtils.js";
 import { Swipeable } from "../Swipeable/index.js";
+import { SkeletonContent } from "../Skeleton/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const sizeFor = (theme, size) => {
   switch (size) {
@@ -51,6 +52,7 @@ const chevronStyles = StyleSheet.create({
 const ListItem = /*#__PURE__*/forwardRef((props, ref) => {
   const {
     title,
+    loading = false,
     subtitle,
     description,
     left,
@@ -103,7 +105,7 @@ const ListItem = /*#__PURE__*/forwardRef((props, ref) => {
           color: disabled ? theme.colors.text.disabled : theme.colors.text.primary
         }],
         numberOfLines: 1,
-        children: title
+        children: title ?? ' '
       }), subtitle ? /*#__PURE__*/_jsx(Text, {
         style: [styles.subtitle, {
           fontSize: sz.subtitleSize,
@@ -174,15 +176,20 @@ const ListItem = /*#__PURE__*/forwardRef((props, ref) => {
 
   // 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__*/_jsx(Swipeable, {
-      leftActions: leftActions,
-      rightActions: rightActions,
-      accessibilityLabel: a11yLabel,
-      children: rendered
+  const final = hasSwipe ? /*#__PURE__*/_jsx(Swipeable, {
+    leftActions: leftActions,
+    rightActions: rightActions,
+    accessibilityLabel: a11yLabel,
+    children: rendered
+  }) : rendered;
+  if (loading) {
+    return /*#__PURE__*/_jsx(SkeletonContent, {
+      loading: true,
+      mode: "auto",
+      children: final
     });
   }
-  return rendered;
+  return final;
 });
 ListItem.displayName = 'ListItem';
 const buildStyles = theme => StyleSheet.create({

package/lib/typescript/commonjs/components/Avatar/Avatar.d.ts

@@ -14,6 +14,12 @@ export interface AvatarProps {
     statusPosition?: AvatarStatusPosition;
     backgroundColor?: string;
     color?: string;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;

package/lib/typescript/commonjs/components/Badge/Badge.d.ts

@@ -12,6 +12,12 @@ export interface BadgeProps {
     tone?: BadgeTone;
     size?: BadgeSize;
     invisible?: boolean;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     children?: React.ReactNode;
     anchor?: BadgeAnchor;
     pulse?: boolean;

package/lib/typescript/commonjs/components/Card/Card.d.ts

@@ -18,6 +18,12 @@ export interface CardProps extends Omit<PressableProps, 'style' | 'children'> {
     imageHeight?: number;
     imageAspectRatio?: number;
     imageOverlay?: React.ReactNode;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     onPress?: (event: GestureResponderEvent) => void;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;

package/lib/typescript/commonjs/components/ListItem/ListItem.d.ts

@@ -5,6 +5,12 @@ import type { SwipeableAction } from '../Swipeable';
 export type ListItemSize = 'sm' | 'md' | 'lg';
 export interface ListItemProps {
     title: string;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     subtitle?: string;
     description?: string;
     left?: React.ReactNode;

package/lib/typescript/module/components/Avatar/Avatar.d.ts

@@ -14,6 +14,12 @@ export interface AvatarProps {
     statusPosition?: AvatarStatusPosition;
     backgroundColor?: string;
     color?: string;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;

package/lib/typescript/module/components/Badge/Badge.d.ts

@@ -12,6 +12,12 @@ export interface BadgeProps {
     tone?: BadgeTone;
     size?: BadgeSize;
     invisible?: boolean;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     children?: React.ReactNode;
     anchor?: BadgeAnchor;
     pulse?: boolean;

package/lib/typescript/module/components/Card/Card.d.ts

@@ -18,6 +18,12 @@ export interface CardProps extends Omit<PressableProps, 'style' | 'children'> {
     imageHeight?: number;
     imageAspectRatio?: number;
     imageOverlay?: React.ReactNode;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     onPress?: (event: GestureResponderEvent) => void;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;

package/lib/typescript/module/components/ListItem/ListItem.d.ts

@@ -5,6 +5,12 @@ import type { SwipeableAction } from '../Swipeable';
 export type ListItemSize = 'sm' | 'md' | 'lg';
 export interface ListItemProps {
     title: string;
+    /**
+     * When true, renders the component as a skeleton placeholder via SkeletonContent's auto walker.
+     * Component still renders its normal layout — the walker replaces Text/Image/sized View leaves
+     * with shimmer blocks. Use this when the data driving the component is still being fetched.
+     */
+    loading?: boolean;
     subtitle?: string;
     description?: string;
     left?: React.ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority-technologies/mobile",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Beautiful, animated, accessible React Native components plus API/auth/logging/network/storage utilities for Webority projects.",
   "keywords": [
     "react-native",