react-native-skelo 0.0.2 → 0.0.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Shubhanshu
+Copyright (c) 2026 Shubhanshu Barnwal <connect@shubhanshubb.dev> (https://shubhanshubb.dev)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,134 +1,121 @@
 <div align="center">
 
-# react-native-skelo
+# 🦴 react-native-skelo
 
-**Write your UI once. Skelo builds the loading state automatically.**
+### Write your UI once. Skelo builds the loading state — automatically.
 
-[![npm](https://img.shields.io/npm/v/react-native-skelo)](https://www.npmjs.com/package/react-native-skelo)
-[![license](https://img.shields.io/npm/l/react-native-skelo)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/react-native-skelo?color=5FC9F8&label=npm)](https://www.npmjs.com/package/react-native-skelo)
+[![downloads](https://img.shields.io/npm/dm/react-native-skelo?color=5FC9F8)](https://www.npmjs.com/package/react-native-skelo)
+[![license](https://img.shields.io/npm/l/react-native-skelo?color=5FC9F8)](./LICENSE)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-5FC9F8.svg)](https://github.com/shubhanshubb/react-native-skelo)
+
+<br />
+
+<img src="./assets/demo.gif" alt="Skelo skeleton demo" width="270" />
+&nbsp;&nbsp;
+<img src="./assets/grid.gif" alt="Image-grid skeleton" width="270" />
 
 </div>
 
-> ⚠️ **Pre-release (`0.0.x`).** Early and evolving — the API may change. The first **stable** release will be **`0.1.0`**. The `deep` engine is experimental — see [caveats](#deep-mode-caveats-experimental).
+<br />
 
-Skeleton loading screens usually mean building — and maintaining — a second copy of your UI. Skelo derives the skeleton from the UI you already wrote.
+**Stop building and maintaining a second copy of your UI just for loading states.** Wrap your components in `<Skeleton>` and Skelo generates a matching skeleton — sized from the styles you already wrote.
 
 ```tsx
-import { Skeleton } from 'react-native-skelo';
-
 <Skeleton loading={isLoading}>
-  <View style={styles.card}>
-    <Image style={styles.avatar} />
-    <Text style={styles.name}>{user.name}</Text>
-  </View>
+  <ProfileCard user={user} />
 </Skeleton>
 ```
 
-While `loading`, Skelo reads the tree and its styles and renders a matching skeleton (circle avatar, text bar). When `loading` is `false`, it renders your real content.
+That's the whole API. No skeleton screens to hand-draw, no keeping two layouts in sync.
 
-## Installation
+> ⚠️ **Pre-release (`0.0.x`)** — evolving fast; the API may change before the stable `0.1.0`.
 
-```bash
-npm install react-native-skelo
-npm install react-native-reanimated react-native-linear-gradient
-```
+---
 
-That's all you need for the basic (inline) and `styles` usage.
+## ✨ Features
 
-### To enable `deep` mode (optional)
+- 🪄 **Zero-config** — wrap a component, get a skeleton. No setup, no separate loading screen.
+- 🧠 **Sees inside your components** — introspects custom components automatically (no inlining).
+- 📋 **Lists included** — `FlatList` / `SectionList` render skeleton rows while data loads.
+- 🎨 **Shimmer · Pulse · None** — built-in animations on the native driver.
+- 🪶 **No dependencies** — no `reanimated`, no gradient library. Just `react` + `react-native`.
+- 📐 **Style-aware** — every skeleton is sized from your real element styles.
 
-`deep` mode is opt-in so the core library never bundles a reconciler you don't
-use. Install `react-reconciler` (matching your React version) and import the
-deep entry **once** in your app's entry file:
+---
 
-```bash
-# React 19:
-npm install react-reconciler@0.31.0
-# React 18:
-npm install react-reconciler@0.29.2
-```
+## 📦 Installation
 
-```js
-// index.js (app entry)
-import 'react-native-skelo/deep';
+```bash
+npm install react-native-skelo
 ```
 
-Without this, `<Skeleton deep>` simply falls back to static parsing (no crash).
-
-## Usage
+**That's it — no other dependencies.** Everything (including custom-component introspection) works out of the box.
 
-### Basic — inline host elements
-
-Skelo traverses the `View` / `Text` / `Image` tree you pass and mirrors it:
-
-```tsx
-<Skeleton loading={loading} animation="shimmer">
-  <View style={styles.row}>
-    <Image style={styles.avatar} />          {/* → circle / box */}
-    <Text style={styles.title}>Title</Text>  {/* → text bar    */}
-  </View>
-</Skeleton>
-```
+> React 18 apps: add `"react-reconciler": "0.29.x"` to your deps (Skelo ships targeting React 19's `0.31`).
 
-Structure comes from the JSX; dimensions come from each element's `style`.
+---
 
-### `deep` — wrap any component (experimental)
+## 🚀 Usage
 
-Don't want to inline? Wrap an opaque component and let Skelo introspect it:
+### Just wrap it
 
 ```tsx
-import { Skeleton, withSkeleton } from 'react-native-skelo';
-
-<Skeleton loading={loading} deep>
-  <ProfileScreen />
-</Skeleton>
+import { Skeleton } from 'react-native-skelo';
 
-// or as an HOC:
-const Home = withSkeleton(HomeScreen);
-<Home loading={loading} {...props} />
+function Screen({ loading, user }) {
+  return (
+    <Skeleton loading={loading} animation="shimmer">
+      <ProfileCard user={user} />
+    </Skeleton>
+  );
+}
 ```
 
-Requires `react-reconciler` + `import 'react-native-skelo/deep'` (see [Installation](#to-enable-deep-mode-optional)). See also [caveats](#deep-mode-caveats-experimental).
+Skelo renders `ProfileCard`, reads its real `View`/`Text`/`Image` tree + styles, and draws a matching skeleton while `loading` is `true`. When it's `false`, your real UI renders.
 
-### `styles` — generate from a StyleSheet
+### Lists
 
-Pass styles directly to get a stack of skeleton shapes (no children needed):
+Wrap a `FlatList` — Skelo fills it with skeleton rows while the data loads:
 
 ```tsx
-<Skeleton loading={loading} styles={styles} excludeStyles={['container']} />
+<Skeleton loading={loading} count={6}>
+  <FlatList data={items} renderItem={renderItem} />
+</Skeleton>
 ```
 
-A StyleSheet has no hierarchy, so this produces one shape per style that has visual dimensions.
-
-### `Skeleton.Ignore` — keep something visible
+### Keep something visible
 
 ```tsx
 <Skeleton loading={loading}>
   <Skeleton.Ignore>
-    <Text style={styles.heading}>Profile</Text>  {/* stays real */}
+    <Text style={styles.heading}>Profile</Text>   {/* stays real */}
   </Skeleton.Ignore>
   <ProfileBody />
 </Skeleton>
 ```
 
-### Custom components — register a plugin
+### Generate from a StyleSheet
+
+```tsx
+<Skeleton loading={loading} styles={styles} excludeStyles={['container']} />
+```
+
+### Custom skeleton for a component
 
 ```tsx
 import { Skelo } from 'react-native-skelo';
-import { Avatar } from 'my-design-system';
 
 Skelo.register({
   name: 'Avatar',
   component: Avatar,
-  strategy: (props, { primitives }) => (
-    <primitives.Circle size={props.size ?? 40} />
-  ),
+  strategy: (props, { primitives }) => <primitives.Circle size={props.size ?? 40} />,
 });
 ```
 
-## API
+---
 
-### `<Skeleton>` props
+## ⚙️ `<Skeleton>` props
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
@@ -137,33 +124,42 @@ Skelo.register({
 | `duration` | `number` | `1200` | Animation duration (ms) |
 | `baseColor` / `highlightColor` | `string` | theme | Skeleton colors |
 | `borderRadius` | `number` | `4` | Default corner radius |
-| `deep` | `boolean` | `false` | Expand opaque components (experimental) |
+| `count` | `number` | `6` | Placeholder rows for a `FlatList`/`SectionList` |
+| `deep` | `boolean` | auto | Force component introspection on/off (auto when available) |
 | `styles` | `StyleSheet \| style[]` | — | Generate from styles instead of children |
-| `excludeStyles` | `string[]` | — | Style keys to skip in `styles` mode |
 | `accessibilityLabel` | `string` | `'Loading content'` | Screen-reader label |
 
-Also exported: `withSkeleton`, `SkeletonIgnore`, `StyleSkeleton`, the primitives (`SkeletonBox`, `SkeletonText`, `SkeletonImage`, `SkeletonCircle`), and `Skelo` (plugin registry + `Skelo.fromStyles`).
+Also exported: `withSkeleton`, `SkeletonIgnore`, `StyleSkeleton`, the primitives (`SkeletonBox`, `SkeletonText`, `SkeletonImage`, `SkeletonCircle`), and `Skelo` (`register` / `fromStyles`).
+
+---
+
+## 🧩 How it works
+
+- **Host elements** (`View` / `Text` / `Image`) are read directly (`React.Children` + `StyleSheet.flatten`).
+- **Custom components** are expanded by a tiny JS-only `react-reconciler` renderer (bundled) that renders them off-screen to recover their real host tree + styles — then feeds the same skeleton engine.
+- Anything Skelo can't introspect (native content) is measured and shown as one size-matched block.
+
+---
 
-## How it works
+## ⚠️ Good to know
 
-- **Inline mode** — static traversal of the host-element tree (`React.Children` + `StyleSheet.flatten`).
-- **`deep` mode** — a JS-only `react-reconciler` renderer renders the component off-screen to recover its real host tree + styles, then feeds the same skeleton renderer.
-- Anything Skelo can't introspect (a custom component without `deep`, or native content) is measured and shown as a single size-matched block.
+Skelo skeletonizes **what your component renders during loading**:
 
-## `deep` mode caveats (experimental)
+- Introspection **runs mount effects** — a screen that fetches on mount may fetch twice. Prefer it for presentational trees; register a plugin for effect-heavy screens.
+- It renders **outside your providers** — components needing navigation/theme/redux context fall back to a measured block.
+- **Native content** (`WebView`, `MapView`, `Video`, …) lives outside React, so it becomes a single sized block.
+- A **data-driven list/grid** that renders nothing while loading has nothing to skeletonize — keep placeholder items rendered (see the [example](./example)).
 
-`deep` renders your component offline to read its structure, which means:
+---
 
-- **Mount effects run** during introspection — a screen that fetches on mount may fetch twice. Prefer `deep` for presentational trees; register a plugin or provide a manual skeleton for effectful screens.
-- **Renders outside your providers** — components that require navigation/theme/redux context may fail to expand; Skelo catches this and falls back to a measured block.
-- Only the **React host tree** is visible. `WebView`, `MapView`, `Video`, etc. render their content natively (outside React), so they can only become a single sized block.
+## 📋 Requirements
 
-## Requirements
+- React Native (New Architecture recommended)
+- React 19 (React 18 → override `react-reconciler` to `0.29`)
+- No other dependencies
 
-- React Native (Fabric / New Architecture recommended)
-- `react-native-reanimated` ≥ 3
-- `react-reconciler` (optional, for `deep`) — must match your React version
+---
 
-## License
+## 📄 License
 
 MIT © [Shubhanshu Barnwal](https://shubhanshubb.dev)

package/lib/commonjs/animations/PulseAnimation.js

@@ -6,25 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.PulseAnimation = PulseAnimation;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
-var _reactNativeReanimated = _interopRequireWildcard(require("react-native-reanimated"));
 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); }
-/**
- * Pulse animation component using Reanimated 3
- *
- * Creates a subtle breathing/pulsing effect using:
- * - Shared values for performance
- * - Worklets for 60 FPS on UI thread
- * - Opacity animation for pulse effect
- *
- * @example
- * ```tsx
- * <PulseAnimation
- *   width={200}
- *   height={20}
- *   borderRadius={4}
- * />
- * ```
- */
+// Breathing opacity loop using React Native's built-in Animated (native driver).
 function PulseAnimation({
   width,
   height,
@@ -34,38 +17,30 @@ function PulseAnimation({
   style,
   children
 }) {
-  // Shared value for opacity (0 to 1)
-  const opacity = (0, _reactNativeReanimated.useSharedValue)(1);
+  const opacity = (0, _react.useRef)(new _reactNative.Animated.Value(1)).current;
   (0, _react.useEffect)(() => {
-    // Start infinite pulse animation
-    // Sequence: fade out -> fade in
-    opacity.value = (0, _reactNativeReanimated.withRepeat)((0, _reactNativeReanimated.withSequence)((0, _reactNativeReanimated.withTiming)(0.5, {
+    const loop = _reactNative.Animated.loop(_reactNative.Animated.sequence([_reactNative.Animated.timing(opacity, {
+      toValue: 0.5,
       duration: duration / 2,
-      easing: _reactNativeReanimated.Easing.inOut(_reactNativeReanimated.Easing.ease)
-    }), (0, _reactNativeReanimated.withTiming)(1, {
+      easing: _reactNative.Easing.inOut(_reactNative.Easing.ease),
+      useNativeDriver: true
+    }), _reactNative.Animated.timing(opacity, {
+      toValue: 1,
       duration: duration / 2,
-      easing: _reactNativeReanimated.Easing.inOut(_reactNativeReanimated.Easing.ease)
-    })), -1,
-    // Infinite repeat
-    false // Don't reverse
-    );
+      easing: _reactNative.Easing.inOut(_reactNative.Easing.ease),
+      useNativeDriver: true
+    })]));
+    loop.start();
+    return () => loop.stop();
   }, [duration, opacity]);
-
-  // Animated style for pulse effect
-  const animatedStyle = (0, _reactNativeReanimated.useAnimatedStyle)(() => {
-    'worklet';
-
-    return {
-      opacity: opacity.value
-    };
-  }, []);
-  return /*#__PURE__*/_react.default.createElement(_reactNativeReanimated.default.View, {
+  return /*#__PURE__*/_react.default.createElement(_reactNative.Animated.View, {
     style: [styles.container, {
       width,
       height,
       borderRadius,
-      backgroundColor: baseColor
-    }, animatedStyle, style]
+      backgroundColor: baseColor,
+      opacity
+    }, style]
   }, children);
 }
 const styles = _reactNative.StyleSheet.create({

package/lib/commonjs/animations/PulseAnimation.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_reactNativeReanimated","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","PulseAnimation","width","height","baseColor","duration","borderRadius","style","children","opacity","useSharedValue","useEffect","value","withRepeat","withSequence","withTiming","easing","Easing","inOut","ease","animatedStyle","useAnimatedStyle","createElement","View","styles","container","backgroundColor","StyleSheet","create","overflow"],"sourceRoot":"../../../src","sources":["animations/PulseAnimation.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","PulseAnimation","width","height","baseColor","duration","borderRadius","style","children","opacity","useRef","Animated","Value","current","useEffect","loop","sequence","timing","toValue","easing","Easing","inOut","ease","useNativeDriver","start","stop","createElement","View","styles","container","backgroundColor","StyleSheet","create","overflow"],"sourceRoot":"../../../src","sources":["animations/PulseAnimation.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AAEA,IAAAC,YAAA,GAAAD,OAAA;AAA4D,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAa5D;AACO,SAASkB,cAAcA,CAAC;EAC7BC,KAAK;EACLC,MAAM;EACNC,SAAS,GAAG,SAAS;EACrBC,QAAQ,GAAG,IAAI;EACfC,YAAY,GAAG,CAAC;EAChBC,KAAK;EACLC;AACU,CAAC,EAAE;EACb,MAAMC,OAAO,GAAG,IAAAC,aAAM,EAAC,IAAIC,qBAAQ,CAACC,KAAK,CAAC,CAAC,CAAC,CAAC,CAACC,OAAO;EAErD,IAAAC,gBAAS,EAAC,MAAM;IACd,MAAMC,IAAI,GAAGJ,qBAAQ,CAACI,IAAI,CACxBJ,qBAAQ,CAACK,QAAQ,CAAC,CAChBL,qBAAQ,CAACM,MAAM,CAACR,OAAO,EAAE;MACvBS,OAAO,EAAE,GAAG;MACZb,QAAQ,EAAEA,QAAQ,GAAG,CAAC;MACtBc,MAAM,EAAEC,mBAAM,CAACC,KAAK,CAACD,mBAAM,CAACE,IAAI,CAAC;MACjCC,eAAe,EAAE;IACnB,CAAC,CAAC,EACFZ,qBAAQ,CAACM,MAAM,CAACR,OAAO,EAAE;MACvBS,OAAO,EAAE,CAAC;MACVb,QAAQ,EAAEA,QAAQ,GAAG,CAAC;MACtBc,MAAM,EAAEC,mBAAM,CAACC,KAAK,CAACD,mBAAM,CAACE,IAAI,CAAC;MACjCC,eAAe,EAAE;IACnB,CAAC,CAAC,CACH,CACH,CAAC;IACDR,IAAI,CAACS,KAAK,CAAC,CAAC;IACZ,OAAO,MAAMT,IAAI,CAACU,IAAI,CAAC,CAAC;EAC1B,CAAC,EAAE,CAACpB,QAAQ,EAAEI,OAAO,CAAC,CAAC;EAEvB,oBACE/B,MAAA,CAAAc,OAAA,CAAAkC,aAAA,CAAC7C,YAAA,CAAA8B,QAAQ,CAACgB,IAAI;IACZpB,KAAK,EAAE,CACLqB,MAAM,CAACC,SAAS,EAChB;MAAE3B,KAAK;MAAEC,MAAM;MAAEG,YAAY;MAAEwB,eAAe,EAAE1B,SAAS;MAAEK;IAAQ,CAAC,EACpEF,KAAK;EACL,GAEDC,QACY,CAAC;AAEpB;AAEA,MAAMoB,MAAM,GAAGG,uBAAU,CAACC,MAAM,CAAC;EAC/BH,SAAS,EAAE;IACTI,QAAQ,EAAE;EACZ;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/animations/ShimmerAnimation.js

@@ -6,26 +6,10 @@ Object.defineProperty(exports, "__esModule", {
 exports.ShimmerAnimation = ShimmerAnimation;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
-var _reactNativeReanimated = _interopRequireWildcard(require("react-native-reanimated"));
-var _reactNativeLinearGradient = require("react-native-linear-gradient");
 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); }
-/**
- * Shimmer animation component using Reanimated 3
- *
- * Creates a smooth left-to-right shimmer effect using:
- * - Shared values for performance
- * - Worklets for 60 FPS on UI thread
- * - Linear gradient for shimmer effect
- *
- * @example
- * ```tsx
- * <ShimmerAnimation
- *   width={200}
- *   height={20}
- *   borderRadius={4}
- * />
- * ```
- */
+// Zero-dependency shimmer: a highlight band (dim/bright/dim segments to fake a
+// soft gradient) sweeps across the base, driven by React Native's built-in
+// Animated native driver. Plain Views only — guaranteed to render and animate.
 function ShimmerAnimation({
   width,
   height,
@@ -36,68 +20,73 @@ function ShimmerAnimation({
   style,
   children
 }) {
-  // Shared value for animation progress (0 to 1)
-  const progress = (0, _reactNativeReanimated.useSharedValue)(0);
+  const progress = (0, _react.useRef)(new _reactNative.Animated.Value(0)).current;
+  const [measuredWidth, setMeasuredWidth] = (0, _react.useState)(0);
   (0, _react.useEffect)(() => {
-    // Start infinite shimmer animation
-    progress.value = (0, _reactNativeReanimated.withRepeat)((0, _reactNativeReanimated.withTiming)(1, {
+    const loop = _reactNative.Animated.loop(_reactNative.Animated.timing(progress, {
+      toValue: 1,
       duration,
-      easing: _reactNativeReanimated.Easing.linear
-    }), -1,
-    // Infinite repeat
-    false // Don't reverse
-    );
+      easing: _reactNative.Easing.linear,
+      useNativeDriver: true
+    }));
+    loop.start();
+    return () => loop.stop();
   }, [duration, progress]);
-
-  // Animated style for shimmer overlay
-  const animatedStyle = (0, _reactNativeReanimated.useAnimatedStyle)(() => {
-    'worklet';
-
-    // Calculate shimmer position
-    // Interpolate from -100% to 100% to create left-to-right sweep
-    const translateX = (0, _reactNativeReanimated.interpolate)(progress.value, [0, 1], [-1, 1]);
-    return {
-      transform: [{
-        translateX: translateX * (typeof width === 'number' ? width : 200)
-      }]
-    };
-  }, [width]);
+  const onLayout = event => {
+    const w = event.nativeEvent.layout.width;
+    setMeasuredWidth(prev => prev === w ? prev : w);
+  };
+  const containerWidth = typeof width === 'number' ? width : measuredWidth || 200;
+  const bandWidth = Math.max(containerWidth * 0.6, 80);
+  const translateX = progress.interpolate({
+    inputRange: [0, 1],
+    outputRange: [-bandWidth, containerWidth]
+  });
   return /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    onLayout: onLayout,
     style: [styles.container, {
       width,
       height,
       borderRadius,
       backgroundColor: baseColor
     }, style]
-  }, /*#__PURE__*/_react.default.createElement(_reactNativeReanimated.default.View, {
-    style: [_reactNative.StyleSheet.absoluteFill, {
-      overflow: 'hidden',
-      borderRadius
+  }, /*#__PURE__*/_react.default.createElement(_reactNative.Animated.View, {
+    pointerEvents: "none",
+    style: [styles.band, {
+      width: bandWidth,
+      transform: [{
+        translateX
+      }]
+    }]
+  }, /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    style: [styles.segment, {
+      backgroundColor: highlightColor,
+      opacity: 0.25
+    }]
+  }), /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    style: [styles.segment, {
+      backgroundColor: highlightColor,
+      opacity: 0.9
     }]
-  }, /*#__PURE__*/_react.default.createElement(_reactNativeReanimated.default.View, {
-    style: [styles.shimmer, {
-      width: typeof width === 'number' ? width : '100%',
-      height: '100%'
-    }, animatedStyle]
-  }, /*#__PURE__*/_react.default.createElement(_reactNativeLinearGradient.LinearGradient, {
-    colors: [baseColor, highlightColor, highlightColor, baseColor],
-    start: {
-      x: 0,
-      y: 0
-    },
-    end: {
-      x: 1,
-      y: 0
-    },
-    style: _reactNative.StyleSheet.absoluteFill
-  }))), children);
+  }), /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    style: [styles.segment, {
+      backgroundColor: highlightColor,
+      opacity: 0.25
+    }]
+  })), children);
 }
 const styles = _reactNative.StyleSheet.create({
   container: {
     overflow: 'hidden'
   },
-  shimmer: {
-    position: 'absolute'
+  band: {
+    position: 'absolute',
+    top: 0,
+    bottom: 0,
+    flexDirection: 'row'
+  },
+  segment: {
+    flex: 1
   }
 });
 //# sourceMappingURL=ShimmerAnimation.js.map

package/lib/commonjs/animations/ShimmerAnimation.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_reactNativeReanimated","_reactNativeLinearGradient","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","ShimmerAnimation","width","height","baseColor","highlightColor","duration","borderRadius","style","children","progress","useSharedValue","useEffect","value","withRepeat","withTiming","easing","Easing","linear","animatedStyle","useAnimatedStyle","translateX","interpolate","transform","createElement","View","styles","container","backgroundColor","StyleSheet","absoluteFill","overflow","shimmer","LinearGradient","colors","start","x","y","end","create","position"],"sourceRoot":"../../../src","sources":["animations/ShimmerAnimation.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","ShimmerAnimation","width","height","baseColor","highlightColor","duration","borderRadius","style","children","progress","useRef","Animated","Value","current","measuredWidth","setMeasuredWidth","useState","useEffect","loop","timing","toValue","easing","Easing","linear","useNativeDriver","start","stop","onLayout","event","w","nativeEvent","layout","prev","containerWidth","bandWidth","Math","max","translateX","interpolate","inputRange","outputRange","createElement","View","styles","container","backgroundColor","pointerEvents","band","transform","segment","opacity","StyleSheet","create","overflow","position","top","bottom","flexDirection","flex"],"sourceRoot":"../../../src","sources":["animations/ShimmerAnimation.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/components/Skeleton.js

@@ -10,6 +10,7 @@ var _SkeletonRenderer = require("./SkeletonRenderer");
 var _SkeletonIgnore = require("./SkeletonIgnore");
 var _StyleSkeleton = require("../core/generator/StyleSkeleton");
 var _deepRegistry = require("../core/deepRegistry");
+var _expandLists = require("../core/parser/expandLists");
 var _defaults = require("../constants/defaults");
 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); }
 /**
@@ -45,7 +46,8 @@ function Skeleton({
   children,
   styles,
   excludeStyles,
-  deep = false,
+  deep,
+  count = 6,
   animation = _defaults.DEFAULT_CONFIG.animation,
   duration = _defaults.DEFAULT_CONFIG.duration,
   baseColor = _defaults.DEFAULT_CONFIG.baseColor,
@@ -66,24 +68,28 @@ function Skeleton({
       console.log('[Skelo] Parsing component tree...');
     }
     try {
+      // Turn FlatList/SectionList into placeholder rows so lists show a
+      // skeleton even though their data (and rows) don't exist yet.
+      const prepared = (0, _expandLists.expandListPlaceholders)(children, count);
+
       // Deep mode: expand opaque components into their real host tree via the
       // opt-in expander (registered by importing 'react-native-skelo/deep').
-      // Falls back to static parsing if unavailable or it returns nothing.
-      if (deep) {
-        const expand = (0, _deepRegistry.getDeepExpander)();
-        if (expand) {
-          const expanded = expand(/*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, children));
-          if (expanded && expanded.length > 0) {
-            return expanded;
-          }
-          if (__DEV__) {
-            console.warn('[Skelo] deep expansion returned nothing; falling back to static parsing.');
-          }
-        } else if (__DEV__) {
-          console.warn("[Skelo] `deep` requires react-reconciler. Install it and add `import 'react-native-skelo/deep';` in your app entry.");
+      // When `deep` is not set explicitly, it's used automatically whenever the
+      // expander is available. Falls back to static parsing otherwise.
+      const expand = (0, _deepRegistry.getDeepExpander)();
+      const wantDeep = deep === undefined ? expand !== null : deep;
+      if (wantDeep && expand) {
+        const expanded = expand(/*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, prepared));
+        if (expanded && expanded.length > 0) {
+          return expanded;
+        }
+        if (__DEV__) {
+          console.warn('[Skelo] deep expansion returned nothing; falling back to static parsing.');
         }
+      } else if (deep === true && !expand && __DEV__) {
+        console.warn("[Skelo] `deep` requires react-reconciler. Install it and add `import 'react-native-skelo/deep';` in your app entry.");
       }
-      const parsed = _parser.Parser.parse(children);
+      const parsed = _parser.Parser.parse(prepared);
       if (__DEV__ && debug) {
         // Log a lightweight summary: the raw nodes hold React elements
         // (`element`) and arbitrary props that aren't safely serializable.
@@ -101,7 +107,7 @@ function Skeleton({
       }
       return [];
     }
-  }, [loading, styles, deep, children, debug]);
+  }, [loading, styles, deep, count, children, debug]);
 
   // Create skeleton config
   const config = (0, _react.useMemo)(() => ({