shimmer-from-structure 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shimmer From Structure Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,273 @@
+# ✨ Shimmer From Structure
+
+A React shimmer/skeleton library that **automatically adapts to your component's runtime structure**. Unlike traditional shimmer libraries that require pre-defined skeleton structures, this library analyzes your actual component's DOM at runtime and generates a shimmer effect that perfectly matches its layout.
+
+![Shimmer From Structure Demo](./example/preview.gif)
+
+## Why This Library?
+
+Traditional shimmer libraries require you to:
+- Manually create skeleton components that mirror your real components
+- Maintain two versions of each component (real + skeleton)
+- Update skeletons every time your layout changes
+
+**Shimmer From Structure** eliminates all of that:
+- ✅ Automatically measures your component's structure at runtime
+- ✅ Generates shimmer effects that match actual dimensions
+- ✅ Zero maintenance - works with any layout changes
+- ✅ Works with complex nested structures
+- ✅ Supports dynamic data with `templateProps`
+- ✅ Preserves container backgrounds during loading
+- ✅ Auto-detects border-radius from your CSS
+
+## Installation
+
+```bash
+npm install shimmer-from-structure
+# or
+yarn add shimmer-from-structure
+# or
+pnpm add shimmer-from-structure
+```
+
+# 📖 Basic Usage
+
+### Static Content
+
+For components with hardcoded/static content:
+
+```tsx
+import { Shimmer } from 'shimmer-from-structure';
+
+function UserCard() {
+  return (
+    <Shimmer loading={isLoading}>
+      <div className="card">
+        <img src="avatar.jpg" className="avatar" />
+        <h2>John Doe</h2>
+        <p>Software Engineer</p>
+      </div>
+    </Shimmer>
+  );
+}
+```
+
+### Dynamic Content with `templateProps`
+
+For components that receive dynamic data via props, use `templateProps` to provide mock data for skeleton generation:
+
+```tsx
+import { Shimmer } from 'shimmer-from-structure';
+
+// Your component that accepts props
+const UserCard = ({ user }) => (
+  <div className="card">
+    <img src={user.avatar} className="avatar" />
+    <h2>{user.name}</h2>
+    <p>{user.role}</p>
+  </div>
+);
+
+// Template data for the skeleton
+const userTemplate = {
+  name: 'Loading...',
+  role: 'Loading role...',
+  avatar: 'placeholder.jpg',
+};
+
+function App() {
+  const [loading, setLoading] = useState(true);
+  const [user, setUser] = useState(null);
+
+  return (
+    <Shimmer 
+      loading={loading} 
+      templateProps={{ user: userTemplate }}
+    >
+      <UserCard user={user || userTemplate} />
+    </Shimmer>
+  );
+}
+```
+
+The `templateProps` object is spread onto the first child component when loading, allowing it to render with mock data for measurement.
+
+## 🎨 API Reference
+
+### `<Shimmer>` Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `loading` | `boolean` | `true` | Whether to show shimmer effect or actual content |
+| `children` | `React.ReactNode` | required | The content to render/measure |
+| `shimmerColor` | `string` | `'rgba(255,255,255,0.15)'` | Color of the shimmer wave |
+| `backgroundColor` | `string` | `'rgba(255,255,255,0.08)'` | Background color of shimmer blocks |
+| `duration` | `number` | `1.5` | Animation duration in seconds |
+| `fallbackBorderRadius` | `number` | `4` | Border radius (px) for elements with no CSS border-radius |
+| `templateProps` | `Record<string, unknown>` | - | Props to inject into first child for skeleton rendering |
+
+### Example with All Props
+
+```tsx
+<Shimmer
+  loading={isLoading}
+  shimmerColor="rgba(255, 255, 255, 0.2)"
+  backgroundColor="rgba(255, 255, 255, 0.1)"
+  duration={2}
+  fallbackBorderRadius={8}
+  templateProps={{ 
+    user: userTemplate,
+    settings: settingsTemplate 
+  }}
+>
+  <MyComponent user={user} settings={settings} />
+</Shimmer>
+```
+
+## 🔧 How It Works
+
+1. **Visible Container Rendering**: When `loading={true}`, your component renders with transparent text but **visible container backgrounds**
+2. **Template Props Injection**: If `templateProps` is provided, it's spread onto the first child so dynamic components can render
+3. **DOM Measurement**: Uses `useLayoutEffect` to synchronously measure all leaf elements via `getBoundingClientRect()`
+4. **Border Radius Detection**: Automatically captures each element's computed `border-radius` from CSS
+5. **Shimmer Generation**: Creates absolutely-positioned shimmer blocks matching measured dimensions
+6. **Animation**: Applies smooth gradient animation that sweeps across each block
+
+### Key Features
+
+- **Container backgrounds visible**: Unlike `opacity: 0`, we use `color: transparent` so card backgrounds/borders show during loading
+- **Auto border-radius**: Circular avatars get circular shimmer blocks automatically
+- **Fallback radius**: Text elements (which have `border-radius: 0`) use `fallbackBorderRadius` to avoid sharp rectangles
+- **Dark-mode friendly**: Default colors use semi-transparent whites that work on any background
+
+## Examples
+
+### Dashboard with Multiple Sections
+
+Each section can have its own independent loading state:
+
+```tsx
+function Dashboard() {
+  const [loadingUser, setLoadingUser] = useState(true);
+  const [loadingStats, setLoadingStats] = useState(true);
+  
+  return (
+    <>
+      {/* User profile section */}
+      <Shimmer loading={loadingUser} templateProps={{ user: userTemplate }}>
+        <UserProfile user={user} />
+      </Shimmer>
+      
+      {/* Stats section - with custom colors */}
+      <Shimmer 
+        loading={loadingStats} 
+        templateProps={{ stats: statsTemplate }}
+        shimmerColor="rgba(20, 184, 166, 0.2)"
+      >
+        <StatsGrid stats={stats} />
+      </Shimmer>
+    </>
+  );
+}
+```
+
+### Transactions List
+
+```tsx
+<Shimmer 
+  loading={loadingTransactions}
+  templateProps={{ transactions: transactionsTemplate }}
+>
+  <TransactionsList transactions={transactions} />
+</Shimmer>
+```
+
+### Team Members Grid
+
+```tsx
+<Shimmer loading={loadingTeam} templateProps={{ members: teamTemplate }}>
+  <TeamMembers members={team} />
+</Shimmer>
+```
+
+## Best Practices
+
+### 1. Use `templateProps` for Dynamic Data
+When your component receives data via props, always provide `templateProps` with mock data that matches the expected structure.
+
+### 2. Match Template Structure to Real Data
+Ensure your template data has the same array length and property structure as real data for accurate shimmer layout.
+
+### 3. Use Individual Shimmer Components
+Wrap each section in its own Shimmer for independent loading states:
+
+```tsx
+// ✅ Good - independent loading
+<Shimmer loading={loadingUsers}><UserList /></Shimmer>
+<Shimmer loading={loadingPosts}><PostList /></Shimmer>
+
+// ❌ Avoid - all-or-nothing loading
+<Shimmer loading={loadingUsers || loadingPosts}>
+  <UserList />
+  <PostList />
+</Shimmer>
+```
+
+### 4. Consider Element Widths
+Block elements like `<h1>`, `<p>` take full container width. If you want shimmer to match text width:
+```css
+.title {
+  width: fit-content;
+}
+```
+
+### 5. Provide Container Dimensions
+For async components (like charts), ensure containers have explicit dimensions so shimmer has something to measure.
+
+## ⚡ Performance Considerations
+
+- Measurement happens only when `loading` changes to `true`
+- Uses `useLayoutEffect` for synchronous measurement (no flicker)
+- Minimal re-renders - only updates when loading state or children change
+- Lightweight DOM measurements using native browser APIs
+
+## 🛠️ Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run development server with example
+npm run dev
+
+# Build library
+npm run build
+```
+
+## 📝 License
+
+MIT
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 🐛 Known Limitations
+
+- **Async components**: Components that render asynchronously (like charts using `ResponsiveContainer`) may need explicit container dimensions
+- **Zero-dimension elements**: Elements with `display: none` or zero dimensions won't be captured
+- **SVG internals**: Only the outer `<svg>` element is captured, not internal paths/shapes
+
+## 🚧 Roadmap
+
+- [x] Dynamic data support via `templateProps`
+- [x] Auto border-radius detection
+- [x] Container background visibility
+- [ ] Better async component support
+- [ ] Customizable shimmer direction (vertical, diagonal)
+- [ ] React Native support
+- [ ] Vue.js adapter
+
+---
+
+Made with ❤️ for developers tired of maintaining skeleton screens

package/dist/Shimmer.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { ShimmerProps } from './types';
+/**
+ * Shimmer component that adapts to the actual rendered structure of its children
+ */
+export declare const Shimmer: React.FC<ShimmerProps>;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { Shimmer } from './Shimmer';
+export type { ShimmerProps, ElementInfo } from './types';

package/dist/index.esm

@@ -0,0 +1,762 @@
+import I, { useState as dr, useRef as xe, useLayoutEffect as vr } from "react";
+var ee = { exports: {} }, L = {};
+/**
+ * @license React
+ * react-jsx-runtime.production.min.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var Se;
+function pr() {
+  if (Se) return L;
+  Se = 1;
+  var f = I, d = Symbol.for("react.element"), R = Symbol.for("react.fragment"), h = Object.prototype.hasOwnProperty, T = f.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner, S = { key: !0, ref: !0, __self: !0, __source: !0 };
+  function _(C, v, O) {
+    var p, b = {}, s = null, w = null;
+    O !== void 0 && (s = "" + O), v.key !== void 0 && (s = "" + v.key), v.ref !== void 0 && (w = v.ref);
+    for (p in v) h.call(v, p) && !S.hasOwnProperty(p) && (b[p] = v[p]);
+    if (C && C.defaultProps) for (p in v = C.defaultProps, v) b[p] === void 0 && (b[p] = v[p]);
+    return { $$typeof: d, type: C, key: s, ref: w, props: b, _owner: T.current };
+  }
+  return L.Fragment = R, L.jsx = _, L.jsxs = _, L;
+}
+var V = {};
+/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var Oe;
+function hr() {
+  return Oe || (Oe = 1, process.env.NODE_ENV !== "production" && function() {
+    var f = I, d = Symbol.for("react.element"), R = Symbol.for("react.portal"), h = Symbol.for("react.fragment"), T = Symbol.for("react.strict_mode"), S = Symbol.for("react.profiler"), _ = Symbol.for("react.provider"), C = Symbol.for("react.context"), v = Symbol.for("react.forward_ref"), O = Symbol.for("react.suspense"), p = Symbol.for("react.suspense_list"), b = Symbol.for("react.memo"), s = Symbol.for("react.lazy"), w = Symbol.for("react.offscreen"), A = Symbol.iterator, J = "@@iterator";
+    function Pe(e) {
+      if (e === null || typeof e != "object")
+        return null;
+      var r = A && e[A] || e[J];
+      return typeof r == "function" ? r : null;
+    }
+    var D = f.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+    function m(e) {
+      {
+        for (var r = arguments.length, t = new Array(r > 1 ? r - 1 : 0), n = 1; n < r; n++)
+          t[n - 1] = arguments[n];
+        ke("error", e, t);
+      }
+    }
+    function ke(e, r, t) {
+      {
+        var n = D.ReactDebugCurrentFrame, o = n.getStackAddendum();
+        o !== "" && (r += "%s", t = t.concat([o]));
+        var u = t.map(function(i) {
+          return String(i);
+        });
+        u.unshift("Warning: " + r), Function.prototype.apply.call(console[e], console, u);
+      }
+    }
+    var Ae = !1, De = !1, Fe = !1, $e = !1, Ie = !1, re;
+    re = Symbol.for("react.module.reference");
+    function We(e) {
+      return !!(typeof e == "string" || typeof e == "function" || e === h || e === S || Ie || e === T || e === O || e === p || $e || e === w || Ae || De || Fe || typeof e == "object" && e !== null && (e.$$typeof === s || e.$$typeof === b || e.$$typeof === _ || e.$$typeof === C || e.$$typeof === v || // This needs to include all possible module reference object
+      // types supported by any Flight configuration anywhere since
+      // we don't know which Flight build this will end up being used
+      // with.
+      e.$$typeof === re || e.getModuleId !== void 0));
+    }
+    function Ye(e, r, t) {
+      var n = e.displayName;
+      if (n)
+        return n;
+      var o = r.displayName || r.name || "";
+      return o !== "" ? t + "(" + o + ")" : t;
+    }
+    function te(e) {
+      return e.displayName || "Context";
+    }
+    function j(e) {
+      if (e == null)
+        return null;
+      if (typeof e.tag == "number" && m("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."), typeof e == "function")
+        return e.displayName || e.name || null;
+      if (typeof e == "string")
+        return e;
+      switch (e) {
+        case h:
+          return "Fragment";
+        case R:
+          return "Portal";
+        case S:
+          return "Profiler";
+        case T:
+          return "StrictMode";
+        case O:
+          return "Suspense";
+        case p:
+          return "SuspenseList";
+      }
+      if (typeof e == "object")
+        switch (e.$$typeof) {
+          case C:
+            var r = e;
+            return te(r) + ".Consumer";
+          case _:
+            var t = e;
+            return te(t._context) + ".Provider";
+          case v:
+            return Ye(e, e.render, "ForwardRef");
+          case b:
+            var n = e.displayName || null;
+            return n !== null ? n : j(e.type) || "Memo";
+          case s: {
+            var o = e, u = o._payload, i = o._init;
+            try {
+              return j(i(u));
+            } catch {
+              return null;
+            }
+          }
+        }
+      return null;
+    }
+    var P = Object.assign, W = 0, ne, ae, ie, oe, ue, se, le;
+    function ce() {
+    }
+    ce.__reactDisabledLog = !0;
+    function Le() {
+      {
+        if (W === 0) {
+          ne = console.log, ae = console.info, ie = console.warn, oe = console.error, ue = console.group, se = console.groupCollapsed, le = console.groupEnd;
+          var e = {
+            configurable: !0,
+            enumerable: !0,
+            value: ce,
+            writable: !0
+          };
+          Object.defineProperties(console, {
+            info: e,
+            log: e,
+            warn: e,
+            error: e,
+            group: e,
+            groupCollapsed: e,
+            groupEnd: e
+          });
+        }
+        W++;
+      }
+    }
+    function Ve() {
+      {
+        if (W--, W === 0) {
+          var e = {
+            configurable: !0,
+            enumerable: !0,
+            writable: !0
+          };
+          Object.defineProperties(console, {
+            log: P({}, e, {
+              value: ne
+            }),
+            info: P({}, e, {
+              value: ae
+            }),
+            warn: P({}, e, {
+              value: ie
+            }),
+            error: P({}, e, {
+              value: oe
+            }),
+            group: P({}, e, {
+              value: ue
+            }),
+            groupCollapsed: P({}, e, {
+              value: se
+            }),
+            groupEnd: P({}, e, {
+              value: le
+            })
+          });
+        }
+        W < 0 && m("disabledDepth fell below zero. This is a bug in React. Please file an issue.");
+      }
+    }
+    var K = D.ReactCurrentDispatcher, q;
+    function M(e, r, t) {
+      {
+        if (q === void 0)
+          try {
+            throw Error();
+          } catch (o) {
+            var n = o.stack.trim().match(/\n( *(at )?)/);
+            q = n && n[1] || "";
+          }
+        return `
+` + q + e;
+      }
+    }
+    var X = !1, N;
+    {
+      var Me = typeof WeakMap == "function" ? WeakMap : Map;
+      N = new Me();
+    }
+    function fe(e, r) {
+      if (!e || X)
+        return "";
+      {
+        var t = N.get(e);
+        if (t !== void 0)
+          return t;
+      }
+      var n;
+      X = !0;
+      var o = Error.prepareStackTrace;
+      Error.prepareStackTrace = void 0;
+      var u;
+      u = K.current, K.current = null, Le();
+      try {
+        if (r) {
+          var i = function() {
+            throw Error();
+          };
+          if (Object.defineProperty(i.prototype, "props", {
+            set: function() {
+              throw Error();
+            }
+          }), typeof Reflect == "object" && Reflect.construct) {
+            try {
+              Reflect.construct(i, []);
+            } catch (y) {
+              n = y;
+            }
+            Reflect.construct(e, [], i);
+          } else {
+            try {
+              i.call();
+            } catch (y) {
+              n = y;
+            }
+            e.call(i.prototype);
+          }
+        } else {
+          try {
+            throw Error();
+          } catch (y) {
+            n = y;
+          }
+          e();
+        }
+      } catch (y) {
+        if (y && n && typeof y.stack == "string") {
+          for (var a = y.stack.split(`
+`), g = n.stack.split(`
+`), l = a.length - 1, c = g.length - 1; l >= 1 && c >= 0 && a[l] !== g[c]; )
+            c--;
+          for (; l >= 1 && c >= 0; l--, c--)
+            if (a[l] !== g[c]) {
+              if (l !== 1 || c !== 1)
+                do
+                  if (l--, c--, c < 0 || a[l] !== g[c]) {
+                    var E = `
+` + a[l].replace(" at new ", " at ");
+                    return e.displayName && E.includes("<anonymous>") && (E = E.replace("<anonymous>", e.displayName)), typeof e == "function" && N.set(e, E), E;
+                  }
+                while (l >= 1 && c >= 0);
+              break;
+            }
+        }
+      } finally {
+        X = !1, K.current = u, Ve(), Error.prepareStackTrace = o;
+      }
+      var $ = e ? e.displayName || e.name : "", k = $ ? M($) : "";
+      return typeof e == "function" && N.set(e, k), k;
+    }
+    function Ne(e, r, t) {
+      return fe(e, !1);
+    }
+    function Ue(e) {
+      var r = e.prototype;
+      return !!(r && r.isReactComponent);
+    }
+    function U(e, r, t) {
+      if (e == null)
+        return "";
+      if (typeof e == "function")
+        return fe(e, Ue(e));
+      if (typeof e == "string")
+        return M(e);
+      switch (e) {
+        case O:
+          return M("Suspense");
+        case p:
+          return M("SuspenseList");
+      }
+      if (typeof e == "object")
+        switch (e.$$typeof) {
+          case v:
+            return Ne(e.render);
+          case b:
+            return U(e.type, r, t);
+          case s: {
+            var n = e, o = n._payload, u = n._init;
+            try {
+              return U(u(o), r, t);
+            } catch {
+            }
+          }
+        }
+      return "";
+    }
+    var Y = Object.prototype.hasOwnProperty, de = {}, ve = D.ReactDebugCurrentFrame;
+    function B(e) {
+      if (e) {
+        var r = e._owner, t = U(e.type, e._source, r ? r.type : null);
+        ve.setExtraStackFrame(t);
+      } else
+        ve.setExtraStackFrame(null);
+    }
+    function Be(e, r, t, n, o) {
+      {
+        var u = Function.call.bind(Y);
+        for (var i in e)
+          if (u(e, i)) {
+            var a = void 0;
+            try {
+              if (typeof e[i] != "function") {
+                var g = Error((n || "React class") + ": " + t + " type `" + i + "` is invalid; it must be a function, usually from the `prop-types` package, but received `" + typeof e[i] + "`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.");
+                throw g.name = "Invariant Violation", g;
+              }
+              a = e[i](r, i, n, t, null, "SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED");
+            } catch (l) {
+              a = l;
+            }
+            a && !(a instanceof Error) && (B(o), m("%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).", n || "React class", t, i, typeof a), B(null)), a instanceof Error && !(a.message in de) && (de[a.message] = !0, B(o), m("Failed %s type: %s", t, a.message), B(null));
+          }
+      }
+    }
+    var Je = Array.isArray;
+    function G(e) {
+      return Je(e);
+    }
+    function Ke(e) {
+      {
+        var r = typeof Symbol == "function" && Symbol.toStringTag, t = r && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return t;
+      }
+    }
+    function qe(e) {
+      try {
+        return pe(e), !1;
+      } catch {
+        return !0;
+      }
+    }
+    function pe(e) {
+      return "" + e;
+    }
+    function he(e) {
+      if (qe(e))
+        return m("The provided key is an unsupported type %s. This value must be coerced to a string before before using it here.", Ke(e)), pe(e);
+    }
+    var me = D.ReactCurrentOwner, Xe = {
+      key: !0,
+      ref: !0,
+      __self: !0,
+      __source: !0
+    }, ge, ye;
+    function Ge(e) {
+      if (Y.call(e, "ref")) {
+        var r = Object.getOwnPropertyDescriptor(e, "ref").get;
+        if (r && r.isReactWarning)
+          return !1;
+      }
+      return e.ref !== void 0;
+    }
+    function ze(e) {
+      if (Y.call(e, "key")) {
+        var r = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (r && r.isReactWarning)
+          return !1;
+      }
+      return e.key !== void 0;
+    }
+    function He(e, r) {
+      typeof e.ref == "string" && me.current;
+    }
+    function Ze(e, r) {
+      {
+        var t = function() {
+          ge || (ge = !0, m("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)", r));
+        };
+        t.isReactWarning = !0, Object.defineProperty(e, "key", {
+          get: t,
+          configurable: !0
+        });
+      }
+    }
+    function Qe(e, r) {
+      {
+        var t = function() {
+          ye || (ye = !0, m("%s: `ref` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)", r));
+        };
+        t.isReactWarning = !0, Object.defineProperty(e, "ref", {
+          get: t,
+          configurable: !0
+        });
+      }
+    }
+    var er = function(e, r, t, n, o, u, i) {
+      var a = {
+        // This tag allows us to uniquely identify this as a React Element
+        $$typeof: d,
+        // Built-in properties that belong on the element
+        type: e,
+        key: r,
+        ref: t,
+        props: i,
+        // Record the component responsible for creating this element.
+        _owner: u
+      };
+      return a._store = {}, Object.defineProperty(a._store, "validated", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: !1
+      }), Object.defineProperty(a, "_self", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !1,
+        value: n
+      }), Object.defineProperty(a, "_source", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !1,
+        value: o
+      }), Object.freeze && (Object.freeze(a.props), Object.freeze(a)), a;
+    };
+    function rr(e, r, t, n, o) {
+      {
+        var u, i = {}, a = null, g = null;
+        t !== void 0 && (he(t), a = "" + t), ze(r) && (he(r.key), a = "" + r.key), Ge(r) && (g = r.ref, He(r, o));
+        for (u in r)
+          Y.call(r, u) && !Xe.hasOwnProperty(u) && (i[u] = r[u]);
+        if (e && e.defaultProps) {
+          var l = e.defaultProps;
+          for (u in l)
+            i[u] === void 0 && (i[u] = l[u]);
+        }
+        if (a || g) {
+          var c = typeof e == "function" ? e.displayName || e.name || "Unknown" : e;
+          a && Ze(i, c), g && Qe(i, c);
+        }
+        return er(e, a, g, o, n, me.current, i);
+      }
+    }
+    var z = D.ReactCurrentOwner, be = D.ReactDebugCurrentFrame;
+    function F(e) {
+      if (e) {
+        var r = e._owner, t = U(e.type, e._source, r ? r.type : null);
+        be.setExtraStackFrame(t);
+      } else
+        be.setExtraStackFrame(null);
+    }
+    var H;
+    H = !1;
+    function Z(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === d;
+    }
+    function Ee() {
+      {
+        if (z.current) {
+          var e = j(z.current.type);
+          if (e)
+            return `
+
+Check the render method of \`` + e + "`.";
+        }
+        return "";
+      }
+    }
+    function tr(e) {
+      return "";
+    }
+    var Re = {};
+    function nr(e) {
+      {
+        var r = Ee();
+        if (!r) {
+          var t = typeof e == "string" ? e : e.displayName || e.name;
+          t && (r = `
+
+Check the top-level render call using <` + t + ">.");
+        }
+        return r;
+      }
+    }
+    function _e(e, r) {
+      {
+        if (!e._store || e._store.validated || e.key != null)
+          return;
+        e._store.validated = !0;
+        var t = nr(r);
+        if (Re[t])
+          return;
+        Re[t] = !0;
+        var n = "";
+        e && e._owner && e._owner !== z.current && (n = " It was passed a child from " + j(e._owner.type) + "."), F(e), m('Each child in a list should have a unique "key" prop.%s%s See https://reactjs.org/link/warning-keys for more information.', t, n), F(null);
+      }
+    }
+    function we(e, r) {
+      {
+        if (typeof e != "object")
+          return;
+        if (G(e))
+          for (var t = 0; t < e.length; t++) {
+            var n = e[t];
+            Z(n) && _e(n, r);
+          }
+        else if (Z(e))
+          e._store && (e._store.validated = !0);
+        else if (e) {
+          var o = Pe(e);
+          if (typeof o == "function" && o !== e.entries)
+            for (var u = o.call(e), i; !(i = u.next()).done; )
+              Z(i.value) && _e(i.value, r);
+        }
+      }
+    }
+    function ar(e) {
+      {
+        var r = e.type;
+        if (r == null || typeof r == "string")
+          return;
+        var t;
+        if (typeof r == "function")
+          t = r.propTypes;
+        else if (typeof r == "object" && (r.$$typeof === v || // Note: Memo only checks outer props here.
+        // Inner props are checked in the reconciler.
+        r.$$typeof === b))
+          t = r.propTypes;
+        else
+          return;
+        if (t) {
+          var n = j(r);
+          Be(t, e.props, "prop", n, e);
+        } else if (r.PropTypes !== void 0 && !H) {
+          H = !0;
+          var o = j(r);
+          m("Component %s declared `PropTypes` instead of `propTypes`. Did you misspell the property assignment?", o || "Unknown");
+        }
+        typeof r.getDefaultProps == "function" && !r.getDefaultProps.isReactClassApproved && m("getDefaultProps is only used on classic React.createClass definitions. Use a static property named `defaultProps` instead.");
+      }
+    }
+    function ir(e) {
+      {
+        for (var r = Object.keys(e.props), t = 0; t < r.length; t++) {
+          var n = r[t];
+          if (n !== "children" && n !== "key") {
+            F(e), m("Invalid prop `%s` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.", n), F(null);
+            break;
+          }
+        }
+        e.ref !== null && (F(e), m("Invalid attribute `ref` supplied to `React.Fragment`."), F(null));
+      }
+    }
+    var Te = {};
+    function Ce(e, r, t, n, o, u) {
+      {
+        var i = We(e);
+        if (!i) {
+          var a = "";
+          (e === void 0 || typeof e == "object" && e !== null && Object.keys(e).length === 0) && (a += " You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");
+          var g = tr();
+          g ? a += g : a += Ee();
+          var l;
+          e === null ? l = "null" : G(e) ? l = "array" : e !== void 0 && e.$$typeof === d ? (l = "<" + (j(e.type) || "Unknown") + " />", a = " Did you accidentally export a JSX literal instead of a component?") : l = typeof e, m("React.jsx: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s", l, a);
+        }
+        var c = rr(e, r, t, o, u);
+        if (c == null)
+          return c;
+        if (i) {
+          var E = r.children;
+          if (E !== void 0)
+            if (n)
+              if (G(E)) {
+                for (var $ = 0; $ < E.length; $++)
+                  we(E[$], e);
+                Object.freeze && Object.freeze(E);
+              } else
+                m("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");
+            else
+              we(E, e);
+        }
+        if (Y.call(r, "key")) {
+          var k = j(e), y = Object.keys(r).filter(function(fr) {
+            return fr !== "key";
+          }), Q = y.length > 0 ? "{key: someKey, " + y.join(": ..., ") + ": ...}" : "{key: someKey}";
+          if (!Te[k + Q]) {
+            var cr = y.length > 0 ? "{" + y.join(": ..., ") + ": ...}" : "{}";
+            m(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`, Q, k, cr, k), Te[k + Q] = !0;
+          }
+        }
+        return e === h ? ir(c) : ar(c), c;
+      }
+    }
+    function or(e, r, t) {
+      return Ce(e, r, t, !0);
+    }
+    function ur(e, r, t) {
+      return Ce(e, r, t, !1);
+    }
+    var sr = ur, lr = or;
+    V.Fragment = h, V.jsx = sr, V.jsxs = lr;
+  }()), V;
+}
+process.env.NODE_ENV === "production" ? ee.exports = pr() : ee.exports = hr();
+var x = ee.exports;
+function mr(f) {
+  const d = f.tagName.toLowerCase();
+  return !!(["img", "svg", "video", "canvas", "iframe", "input", "textarea", "button"].includes(d) || !(Array.from(f.children).length > 0));
+}
+function je(f, d) {
+  const R = [], h = f.getBoundingClientRect();
+  if (h.width === 0 || h.height === 0)
+    return R;
+  if (mr(f)) {
+    const S = window.getComputedStyle(f).borderRadius || "0px", _ = {
+      x: h.left - d.left,
+      y: h.top - d.top,
+      width: h.width,
+      height: h.height,
+      tag: f.tagName.toLowerCase(),
+      borderRadius: S
+    };
+    R.push(_);
+  } else
+    Array.from(f.children).forEach((T) => {
+      R.push(...je(T, d));
+    });
+  return R;
+}
+const yr = ({
+  children: f,
+  loading: d = !0,
+  shimmerColor: R = "rgba(255, 255, 255, 0.15)",
+  backgroundColor: h = "rgba(255, 255, 255, 0.08)",
+  duration: T = 1.5,
+  fallbackBorderRadius: S = 4,
+  templateProps: _
+}) => {
+  const [C, v] = dr([]), O = xe(null), p = xe(null), b = I.useMemo(() => {
+    if (!d || !_)
+      return f;
+    const s = I.Children.toArray(f);
+    if (s.length === 0)
+      return f;
+    const w = s[0];
+    return I.isValidElement(w) ? [I.cloneElement(w, {
+      ..._
+    }), ...s.slice(1)] : f;
+  }, [f, d, _]);
+  return vr(() => {
+    if (!d || !p.current) return;
+    const s = p.current, w = s.getBoundingClientRect(), A = [];
+    Array.from(s.children).forEach((J) => {
+      A.push(...je(J, w));
+    }), v(A);
+  }, [d, b]), d ? /* @__PURE__ */ x.jsxs("div", { style: { position: "relative" }, children: [
+    /* @__PURE__ */ x.jsx("style", { children: `
+        .shimmer-measure-container * {
+          color: transparent !important;
+          border-color: transparent !important;
+        }
+        .shimmer-measure-container img,
+        .shimmer-measure-container svg,
+        .shimmer-measure-container video {
+          opacity: 0;
+        }
+      ` }),
+    /* @__PURE__ */ x.jsx(
+      "div",
+      {
+        ref: p,
+        className: "shimmer-measure-container",
+        style: {
+          pointerEvents: "none"
+        },
+        "aria-hidden": "true",
+        children: b
+      }
+    ),
+    /* @__PURE__ */ x.jsxs(
+      "div",
+      {
+        ref: O,
+        style: {
+          position: "absolute",
+          top: 0,
+          left: 0,
+          right: 0,
+          bottom: 0,
+          overflow: "hidden"
+        },
+        children: [
+          /* @__PURE__ */ x.jsx("style", { children: `
+          @keyframes shimmer {
+            0% {
+              transform: translateX(-100%);
+            }
+            100% {
+              transform: translateX(100%);
+            }
+          }
+        ` }),
+          C.map((s, w) => /* @__PURE__ */ x.jsx(
+            "div",
+            {
+              style: {
+                position: "absolute",
+                left: `${s.x}px`,
+                top: `${s.y}px`,
+                width: `${s.width}px`,
+                height: `${s.height}px`,
+                backgroundColor: h,
+                borderRadius: s.borderRadius === "0px" ? `${S}px` : s.borderRadius,
+                overflow: "hidden"
+              },
+              children: /* @__PURE__ */ x.jsx(
+                "div",
+                {
+                  style: {
+                    position: "absolute",
+                    top: 0,
+                    left: 0,
+                    width: "100%",
+                    height: "100%",
+                    background: `linear-gradient(90deg, transparent, ${R}, transparent)`,
+                    animation: `shimmer ${T}s infinite`
+                  }
+                }
+              )
+            },
+            w
+          ))
+        ]
+      }
+    )
+  ] }) : /* @__PURE__ */ x.jsx(x.Fragment, { children: f });
+};
+export {
+  yr as Shimmer
+};

package/dist/index.js

@@ -0,0 +1,49 @@
+(function(k,y){typeof exports=="object"&&typeof module<"u"?y(exports,require("react")):typeof define=="function"&&define.amd?define(["exports","react"],y):(k=typeof globalThis<"u"?globalThis:k||self,y(k.ShimmerFromStructure={},k.React))})(this,function(k,y){"use strict";var q={exports:{}},Y={};/**
+ * @license React
+ * react-jsx-runtime.production.min.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var te;function Pe(){if(te)return Y;te=1;var c=y,d=Symbol.for("react.element"),_=Symbol.for("react.fragment"),h=Object.prototype.hasOwnProperty,x=c.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner,O={key:!0,ref:!0,__self:!0,__source:!0};function T(C,v,j){var p,E={},s=null,w=null;j!==void 0&&(s=""+j),v.key!==void 0&&(s=""+v.key),v.ref!==void 0&&(w=v.ref);for(p in v)h.call(v,p)&&!O.hasOwnProperty(p)&&(E[p]=v[p]);if(C&&C.defaultProps)for(p in v=C.defaultProps,v)E[p]===void 0&&(E[p]=v[p]);return{$$typeof:d,type:C,key:s,ref:w,props:E,_owner:x.current}}return Y.Fragment=_,Y.jsx=T,Y.jsxs=T,Y}var L={};/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var ne;function ke(){return ne||(ne=1,process.env.NODE_ENV!=="production"&&function(){var c=y,d=Symbol.for("react.element"),_=Symbol.for("react.portal"),h=Symbol.for("react.fragment"),x=Symbol.for("react.strict_mode"),O=Symbol.for("react.profiler"),T=Symbol.for("react.provider"),C=Symbol.for("react.context"),v=Symbol.for("react.forward_ref"),j=Symbol.for("react.suspense"),p=Symbol.for("react.suspense_list"),E=Symbol.for("react.memo"),s=Symbol.for("react.lazy"),w=Symbol.for("react.offscreen"),D=Symbol.iterator,K="@@iterator";function De(e){if(e===null||typeof e!="object")return null;var r=D&&e[D]||e[K];return typeof r=="function"?r:null}var $=c.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;function m(e){{for(var r=arguments.length,t=new Array(r>1?r-1:0),n=1;n<r;n++)t[n-1]=arguments[n];$e("error",e,t)}}function $e(e,r,t){{var n=$.ReactDebugCurrentFrame,o=n.getStackAddendum();o!==""&&(r+="%s",t=t.concat([o]));var u=t.map(function(i){return String(i)});u.unshift("Warning: "+r),Function.prototype.apply.call(console[e],console,u)}}var Ie=!1,We=!1,Ye=!1,Le=!1,Me=!1,ie;ie=Symbol.for("react.module.reference");function Ve(e){return!!(typeof e=="string"||typeof e=="function"||e===h||e===O||Me||e===x||e===j||e===p||Le||e===w||Ie||We||Ye||typeof e=="object"&&e!==null&&(e.$$typeof===s||e.$$typeof===E||e.$$typeof===T||e.$$typeof===C||e.$$typeof===v||e.$$typeof===ie||e.getModuleId!==void 0))}function Ne(e,r,t){var n=e.displayName;if(n)return n;var o=r.displayName||r.name||"";return o!==""?t+"("+o+")":t}function oe(e){return e.displayName||"Context"}function P(e){if(e==null)return null;if(typeof e.tag=="number"&&m("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),typeof e=="function")return e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case h:return"Fragment";case _:return"Portal";case O:return"Profiler";case x:return"StrictMode";case j:return"Suspense";case p:return"SuspenseList"}if(typeof e=="object")switch(e.$$typeof){case C:var r=e;return oe(r)+".Consumer";case T:var t=e;return oe(t._context)+".Provider";case v:return Ne(e,e.render,"ForwardRef");case E:var n=e.displayName||null;return n!==null?n:P(e.type)||"Memo";case s:{var o=e,u=o._payload,i=o._init;try{return P(i(u))}catch{return null}}}return null}var A=Object.assign,M=0,ue,se,le,fe,ce,de,ve;function pe(){}pe.__reactDisabledLog=!0;function Ue(){{if(M===0){ue=console.log,se=console.info,le=console.warn,fe=console.error,ce=console.group,de=console.groupCollapsed,ve=console.groupEnd;var e={configurable:!0,enumerable:!0,value:pe,writable:!0};Object.defineProperties(console,{info:e,log:e,warn:e,error:e,group:e,groupCollapsed:e,groupEnd:e})}M++}}function Be(){{if(M--,M===0){var e={configurable:!0,enumerable:!0,writable:!0};Object.defineProperties(console,{log:A({},e,{value:ue}),info:A({},e,{value:se}),warn:A({},e,{value:le}),error:A({},e,{value:fe}),group:A({},e,{value:ce}),groupCollapsed:A({},e,{value:de}),groupEnd:A({},e,{value:ve})})}M<0&&m("disabledDepth fell below zero. This is a bug in React. Please file an issue.")}}var X=$.ReactCurrentDispatcher,G;function N(e,r,t){{if(G===void 0)try{throw Error()}catch(o){var n=o.stack.trim().match(/\n( *(at )?)/);G=n&&n[1]||""}return`
+`+G+e}}var z=!1,U;{var Je=typeof WeakMap=="function"?WeakMap:Map;U=new Je}function he(e,r){if(!e||z)return"";{var t=U.get(e);if(t!==void 0)return t}var n;z=!0;var o=Error.prepareStackTrace;Error.prepareStackTrace=void 0;var u;u=X.current,X.current=null,Ue();try{if(r){var i=function(){throw Error()};if(Object.defineProperty(i.prototype,"props",{set:function(){throw Error()}}),typeof Reflect=="object"&&Reflect.construct){try{Reflect.construct(i,[])}catch(b){n=b}Reflect.construct(e,[],i)}else{try{i.call()}catch(b){n=b}e.call(i.prototype)}}else{try{throw Error()}catch(b){n=b}e()}}catch(b){if(b&&n&&typeof b.stack=="string"){for(var a=b.stack.split(`
+`),g=n.stack.split(`
+`),l=a.length-1,f=g.length-1;l>=1&&f>=0&&a[l]!==g[f];)f--;for(;l>=1&&f>=0;l--,f--)if(a[l]!==g[f]){if(l!==1||f!==1)do if(l--,f--,f<0||a[l]!==g[f]){var R=`
+`+a[l].replace(" at new "," at ");return e.displayName&&R.includes("<anonymous>")&&(R=R.replace("<anonymous>",e.displayName)),typeof e=="function"&&U.set(e,R),R}while(l>=1&&f>=0);break}}}finally{z=!1,X.current=u,Be(),Error.prepareStackTrace=o}var W=e?e.displayName||e.name:"",F=W?N(W):"";return typeof e=="function"&&U.set(e,F),F}function qe(e,r,t){return he(e,!1)}function Ke(e){var r=e.prototype;return!!(r&&r.isReactComponent)}function B(e,r,t){if(e==null)return"";if(typeof e=="function")return he(e,Ke(e));if(typeof e=="string")return N(e);switch(e){case j:return N("Suspense");case p:return N("SuspenseList")}if(typeof e=="object")switch(e.$$typeof){case v:return qe(e.render);case E:return B(e.type,r,t);case s:{var n=e,o=n._payload,u=n._init;try{return B(u(o),r,t)}catch{}}}return""}var V=Object.prototype.hasOwnProperty,me={},ge=$.ReactDebugCurrentFrame;function J(e){if(e){var r=e._owner,t=B(e.type,e._source,r?r.type:null);ge.setExtraStackFrame(t)}else ge.setExtraStackFrame(null)}function Xe(e,r,t,n,o){{var u=Function.call.bind(V);for(var i in e)if(u(e,i)){var a=void 0;try{if(typeof e[i]!="function"){var g=Error((n||"React class")+": "+t+" type `"+i+"` is invalid; it must be a function, usually from the `prop-types` package, but received `"+typeof e[i]+"`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.");throw g.name="Invariant Violation",g}a=e[i](r,i,n,t,null,"SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED")}catch(l){a=l}a&&!(a instanceof Error)&&(J(o),m("%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).",n||"React class",t,i,typeof a),J(null)),a instanceof Error&&!(a.message in me)&&(me[a.message]=!0,J(o),m("Failed %s type: %s",t,a.message),J(null))}}}var Ge=Array.isArray;function H(e){return Ge(e)}function ze(e){{var r=typeof Symbol=="function"&&Symbol.toStringTag,t=r&&e[Symbol.toStringTag]||e.constructor.name||"Object";return t}}function He(e){try{return ye(e),!1}catch{return!0}}function ye(e){return""+e}function be(e){if(He(e))return m("The provided key is an unsupported type %s. This value must be coerced to a string before before using it here.",ze(e)),ye(e)}var Ee=$.ReactCurrentOwner,Ze={key:!0,ref:!0,__self:!0,__source:!0},Re,_e;function Qe(e){if(V.call(e,"ref")){var r=Object.getOwnPropertyDescriptor(e,"ref").get;if(r&&r.isReactWarning)return!1}return e.ref!==void 0}function er(e){if(V.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function rr(e,r){typeof e.ref=="string"&&Ee.current}function tr(e,r){{var t=function(){Re||(Re=!0,m("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)",r))};t.isReactWarning=!0,Object.defineProperty(e,"key",{get:t,configurable:!0})}}function nr(e,r){{var t=function(){_e||(_e=!0,m("%s: `ref` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)",r))};t.isReactWarning=!0,Object.defineProperty(e,"ref",{get:t,configurable:!0})}}var ar=function(e,r,t,n,o,u,i){var a={$$typeof:d,type:e,key:r,ref:t,props:i,_owner:u};return a._store={},Object.defineProperty(a._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:!1}),Object.defineProperty(a,"_self",{configurable:!1,enumerable:!1,writable:!1,value:n}),Object.defineProperty(a,"_source",{configurable:!1,enumerable:!1,writable:!1,value:o}),Object.freeze&&(Object.freeze(a.props),Object.freeze(a)),a};function ir(e,r,t,n,o){{var u,i={},a=null,g=null;t!==void 0&&(be(t),a=""+t),er(r)&&(be(r.key),a=""+r.key),Qe(r)&&(g=r.ref,rr(r,o));for(u in r)V.call(r,u)&&!Ze.hasOwnProperty(u)&&(i[u]=r[u]);if(e&&e.defaultProps){var l=e.defaultProps;for(u in l)i[u]===void 0&&(i[u]=l[u])}if(a||g){var f=typeof e=="function"?e.displayName||e.name||"Unknown":e;a&&tr(i,f),g&&nr(i,f)}return ar(e,a,g,o,n,Ee.current,i)}}var Z=$.ReactCurrentOwner,Te=$.ReactDebugCurrentFrame;function I(e){if(e){var r=e._owner,t=B(e.type,e._source,r?r.type:null);Te.setExtraStackFrame(t)}else Te.setExtraStackFrame(null)}var Q;Q=!1;function ee(e){return typeof e=="object"&&e!==null&&e.$$typeof===d}function we(){{if(Z.current){var e=P(Z.current.type);if(e)return`
+
+Check the render method of \``+e+"`."}return""}}function or(e){return""}var Se={};function ur(e){{var r=we();if(!r){var t=typeof e=="string"?e:e.displayName||e.name;t&&(r=`
+
+Check the top-level render call using <`+t+">.")}return r}}function xe(e,r){{if(!e._store||e._store.validated||e.key!=null)return;e._store.validated=!0;var t=ur(r);if(Se[t])return;Se[t]=!0;var n="";e&&e._owner&&e._owner!==Z.current&&(n=" It was passed a child from "+P(e._owner.type)+"."),I(e),m('Each child in a list should have a unique "key" prop.%s%s See https://reactjs.org/link/warning-keys for more information.',t,n),I(null)}}function Ce(e,r){{if(typeof e!="object")return;if(H(e))for(var t=0;t<e.length;t++){var n=e[t];ee(n)&&xe(n,r)}else if(ee(e))e._store&&(e._store.validated=!0);else if(e){var o=De(e);if(typeof o=="function"&&o!==e.entries)for(var u=o.call(e),i;!(i=u.next()).done;)ee(i.value)&&xe(i.value,r)}}}function sr(e){{var r=e.type;if(r==null||typeof r=="string")return;var t;if(typeof r=="function")t=r.propTypes;else if(typeof r=="object"&&(r.$$typeof===v||r.$$typeof===E))t=r.propTypes;else return;if(t){var n=P(r);Xe(t,e.props,"prop",n,e)}else if(r.PropTypes!==void 0&&!Q){Q=!0;var o=P(r);m("Component %s declared `PropTypes` instead of `propTypes`. Did you misspell the property assignment?",o||"Unknown")}typeof r.getDefaultProps=="function"&&!r.getDefaultProps.isReactClassApproved&&m("getDefaultProps is only used on classic React.createClass definitions. Use a static property named `defaultProps` instead.")}}function lr(e){{for(var r=Object.keys(e.props),t=0;t<r.length;t++){var n=r[t];if(n!=="children"&&n!=="key"){I(e),m("Invalid prop `%s` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.",n),I(null);break}}e.ref!==null&&(I(e),m("Invalid attribute `ref` supplied to `React.Fragment`."),I(null))}}var Oe={};function je(e,r,t,n,o,u){{var i=Ve(e);if(!i){var a="";(e===void 0||typeof e=="object"&&e!==null&&Object.keys(e).length===0)&&(a+=" You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");var g=or();g?a+=g:a+=we();var l;e===null?l="null":H(e)?l="array":e!==void 0&&e.$$typeof===d?(l="<"+(P(e.type)||"Unknown")+" />",a=" Did you accidentally export a JSX literal instead of a component?"):l=typeof e,m("React.jsx: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s",l,a)}var f=ir(e,r,t,o,u);if(f==null)return f;if(i){var R=r.children;if(R!==void 0)if(n)if(H(R)){for(var W=0;W<R.length;W++)Ce(R[W],e);Object.freeze&&Object.freeze(R)}else m("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else Ce(R,e)}if(V.call(r,"key")){var F=P(e),b=Object.keys(r).filter(function(hr){return hr!=="key"}),re=b.length>0?"{key: someKey, "+b.join(": ..., ")+": ...}":"{key: someKey}";if(!Oe[F+re]){var pr=b.length>0?"{"+b.join(": ..., ")+": ...}":"{}";m(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,re,F,pr,F),Oe[F+re]=!0}}return e===h?lr(f):sr(f),f}}function fr(e,r,t){return je(e,r,t,!0)}function cr(e,r,t){return je(e,r,t,!1)}var dr=cr,vr=fr;L.Fragment=h,L.jsx=dr,L.jsxs=vr}()),L}process.env.NODE_ENV==="production"?q.exports=Pe():q.exports=ke();var S=q.exports;function Ae(c){const d=c.tagName.toLowerCase();return!!(["img","svg","video","canvas","iframe","input","textarea","button"].includes(d)||!(Array.from(c.children).length>0))}function ae(c,d){const _=[],h=c.getBoundingClientRect();if(h.width===0||h.height===0)return _;if(Ae(c)){const O=window.getComputedStyle(c).borderRadius||"0px",T={x:h.left-d.left,y:h.top-d.top,width:h.width,height:h.height,tag:c.tagName.toLowerCase(),borderRadius:O};_.push(T)}else Array.from(c.children).forEach(x=>{_.push(...ae(x,d))});return _}const Fe=({children:c,loading:d=!0,shimmerColor:_="rgba(255, 255, 255, 0.15)",backgroundColor:h="rgba(255, 255, 255, 0.08)",duration:x=1.5,fallbackBorderRadius:O=4,templateProps:T})=>{const[C,v]=y.useState([]),j=y.useRef(null),p=y.useRef(null),E=y.useMemo(()=>{if(!d||!T)return c;const s=y.Children.toArray(c);if(s.length===0)return c;const w=s[0];return y.isValidElement(w)?[y.cloneElement(w,{...T}),...s.slice(1)]:c},[c,d,T]);return y.useLayoutEffect(()=>{if(!d||!p.current)return;const s=p.current,w=s.getBoundingClientRect(),D=[];Array.from(s.children).forEach(K=>{D.push(...ae(K,w))}),v(D)},[d,E]),d?S.jsxs("div",{style:{position:"relative"},children:[S.jsx("style",{children:`
+        .shimmer-measure-container * {
+          color: transparent !important;
+          border-color: transparent !important;
+        }
+        .shimmer-measure-container img,
+        .shimmer-measure-container svg,
+        .shimmer-measure-container video {
+          opacity: 0;
+        }
+      `}),S.jsx("div",{ref:p,className:"shimmer-measure-container",style:{pointerEvents:"none"},"aria-hidden":"true",children:E}),S.jsxs("div",{ref:j,style:{position:"absolute",top:0,left:0,right:0,bottom:0,overflow:"hidden"},children:[S.jsx("style",{children:`
+          @keyframes shimmer {
+            0% {
+              transform: translateX(-100%);
+            }
+            100% {
+              transform: translateX(100%);
+            }
+          }
+        `}),C.map((s,w)=>S.jsx("div",{style:{position:"absolute",left:`${s.x}px`,top:`${s.y}px`,width:`${s.width}px`,height:`${s.height}px`,backgroundColor:h,borderRadius:s.borderRadius==="0px"?`${O}px`:s.borderRadius,overflow:"hidden"},children:S.jsx("div",{style:{position:"absolute",top:0,left:0,width:"100%",height:"100%",background:`linear-gradient(90deg, transparent, ${_}, transparent)`,animation:`shimmer ${x}s infinite`}})},w))]})]}):S.jsx(S.Fragment,{children:c})};k.Shimmer=Fe,Object.defineProperty(k,Symbol.toStringTag,{value:"Module"})});

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export interface ElementInfo {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    tag: string;
+    borderRadius: string;
+}
+export interface ShimmerProps {
+    children: React.ReactNode;
+    loading?: boolean;
+    shimmerColor?: string;
+    backgroundColor?: string;
+    duration?: number;
+    /**
+     * Fallback border radius (in pixels) used when an element has no border-radius.
+     * Helps avoid square-ish shimmer blocks, especially for text elements.
+     * @default 4
+     */
+    fallbackBorderRadius?: number;
+    /**
+     * Object mapping prop names to their mock/template values.
+     * These props will be injected into the first child when loading.
+     * Example: { user: { name: "Lorem" }, settings: { theme: "dark" } }
+     */
+    templateProps?: Record<string, unknown>;
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "shimmer-from-structure",
+  "version": "0.1.0",
+  "description": "A React shimmer/skeleton library that automatically adapts to your component's runtime structure",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "test": "vitest"
+  },
+  "keywords": [
+    "react",
+    "shimmer",
+    "skeleton",
+    "loading",
+    "placeholder",
+    "runtime"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^25.0.9",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "@vitest/ui": "^4.0.17",
+    "jsdom": "^27.4.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.17",
+    "recharts": "^3.6.0"
+  }
+}