react-native-gleam 1.0.0-beta.7 → 1.0.0

package/README.md

@@ -20,7 +20,7 @@ npm install react-native-gleam
 
 ### Bare React Native
 
-Run `pod install` in your `ios/` directory.
+Run `pod install` in your `ios/` directory. Android requires no additional setup — autolinking and codegen handle everything.
 
 ### Expo
 
@@ -33,6 +33,14 @@ npx expo prebuild
 
 No config plugin needed — autolinking and codegen handle everything.
 
+### Claude Code
+
+Install the plugin to help Claude guide your first implementation — it knows every prop, pattern, and pitfall.
+
+```sh
+claude plugin add --from github:RamboWasReal/react-native-gleam
+```
+
 ## Usage
 
 ```tsx
@@ -119,8 +127,8 @@ Every `GleamView` provides context to its subtree. A `GleamView.Line` always bin
 | `transitionDuration` | `number` | `300` | Duration of the transition from shimmer to content (ms). `0` = instant |
 | `transitionType` | `GleamTransition` | `Fade` | Transition style when loading ends |
 | `intensity` | `number` | `1` | Highlight strength (0-1). Lower = more subtle shimmer |
-| `baseColor` | `string` | `#E0E0E0` | Background color of the shimmer |
-| `highlightColor` | `string` | `#F5F5F5` | Color of the moving highlight |
+| `baseColor` | `ColorValue` | `#E0E0E0` | Background color of the shimmer |
+| `highlightColor` | `ColorValue` | `#F5F5F5` | Color of the moving highlight |
 | `onTransitionEnd` | `function` | — | Called when the transition completes or is interrupted. Receives `{ nativeEvent: { finished: boolean } }` — `true` if completed, `false` if interrupted (e.g., `loading` toggled back to `true`) |
 
 All standard `View` props are also supported (`style`, `testID`, etc.). Note: the shimmer overlay supports uniform `borderRadius` only — per-corner radii are not applied to the shimmer.
@@ -183,10 +191,6 @@ All shimmer instances sharing the same `speed` are automatically synchronized vi
 
 The shimmer respects uniform `borderRadius` and standard view styles.
 
-## Breaking changes (beta)
-
-- When `GleamView.Line` children are present, the parent `GleamView` renders as a plain `View` container. `onTransitionEnd` on the parent is ignored in this mode — use `onTransitionEnd` on individual `GleamView.Line` components instead. A dev warning is emitted if this happens.
-
 ## Limitations
 
 - The shimmer overlay supports uniform `borderRadius` only — per-corner radii are not applied to the shimmer.

package/android/src/main/java/com/gleam/GleamView.kt

@@ -12,6 +12,7 @@ import android.graphics.Shader
 import android.os.SystemClock
 import android.view.Choreographer
 import android.view.animation.DecelerateInterpolator
+import androidx.annotation.UiThread
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.ReactContext
 import com.facebook.react.bridge.WritableMap
@@ -158,6 +159,7 @@ class GleamView(context: Context) : ReactViewGroup(context) {
         super.onDetachedFromWindow()
         unregisterClock()
         isTransitioning = false
+        transitionAnimator?.removeAllListeners()
         transitionAnimator?.cancel()
         transitionAnimator = null
     }
@@ -173,6 +175,7 @@ class GleamView(context: Context) : ReactViewGroup(context) {
     fun cleanup() {
         unregisterClock()
         isTransitioning = false
+        transitionAnimator?.removeAllListeners()
         transitionAnimator?.cancel()
         transitionAnimator = null
     }
@@ -412,9 +415,9 @@ class GleamView(context: Context) : ReactViewGroup(context) {
      */
     companion object SharedClock {
         private val views = mutableListOf<GleamView>()
-        private val iterationSnapshot = mutableListOf<GleamView>()
         private var frameCallback: Choreographer.FrameCallback? = null
 
+        @UiThread
         fun register(view: GleamView) {
             if (!views.contains(view)) {
                 views.add(view)
@@ -422,6 +425,7 @@ class GleamView(context: Context) : ReactViewGroup(context) {
             if (views.size == 1) start()
         }
 
+        @UiThread
         fun unregister(view: GleamView) {
             views.remove(view)
             if (views.isEmpty()) stop()
@@ -430,9 +434,10 @@ class GleamView(context: Context) : ReactViewGroup(context) {
         private fun start() {
             frameCallback = Choreographer.FrameCallback { frameTimeNanos ->
                 val timeMs = frameTimeNanos / 1_000_000f
-                iterationSnapshot.clear()
-                iterationSnapshot.addAll(views)
-                iterationSnapshot.forEach { it.onFrame(timeMs) }
+                val snapshot = views.toList()
+                for (i in snapshot.indices.reversed()) {
+                    snapshot[i].onFrame(timeMs)
+                }
                 frameCallback?.let { Choreographer.getInstance().postFrameCallback(it) }
             }
             Choreographer.getInstance().postFrameCallback(frameCallback!!)

package/ios/GleamView.mm

@@ -223,6 +223,12 @@ static void _unregisterView(GleamView *view) {
     _didInitialSetup = NO;
 }
 
+// Invariant: a registered view (_isRegistered=YES) is held by the static
+// __strong _views array, which prevents ARC dealloc while registered.
+// Off-main dealloc with _isRegistered=YES should therefore be unreachable.
+// If the invariant is violated in release, we skip _unregisterView to avoid
+// racing on the statics (_views, _viewCount, _displayLink) that are read/written
+// by the display link on the main thread. The view leaks in _views but no crash.
 - (void)dealloc
 {
     if (_isRegistered) {
@@ -230,9 +236,7 @@ static void _unregisterView(GleamView *view) {
         if ([NSThread isMainThread]) {
             _unregisterView(self);
         } else {
-            dispatch_async(dispatch_get_main_queue(), ^{
-                _stopDisplayLinkIfNeeded();
-            });
+            NSAssert(NO, @"GleamView deallocated off main thread — static __strong array should prevent this");
         }
     }
 }

package/lib/module/GleamLine.js.map

@@ -1 +1 @@
-{"version":3,"names":["useContext","useLayoutEffect","View","NativeGleamView","GleamContext","jsx","_jsx","GleamLine","children","style","testID","delay","onTransitionEnd","accessibilityProps","ctx","register","registerLine","__DEV__","console","warn","loading","speed","direction","transitionDuration","transitionType","intensity","baseColor","highlightColor"],"sourceRoot":"../../src","sources":["GleamLine.tsx"],"mappings":";;AAAA,SAASA,UAAU,EAAEC,eAAe,QAAwB,OAAO;AACnE,SACEC,IAAI,QAIC,cAAc;AACrB,OAAOC,eAAe,MAA4B,4BAA4B;AAC9E,SAASC,YAAY,QAAQ,mBAAgB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAU9C,OAAO,SAASC,SAASA,CAAC;EACxBC,QAAQ;EACRC,KAAK;EACLC,MAAM;EACNC,KAAK;EACLC,eAAe;EACf,GAAGC;AACW,CAAC,EAAE;EACjB,MAAMC,GAAG,GAAGd,UAAU,CAACI,YAAY,CAAC;EACpC,MAAMW,QAAQ,GAAGD,GAAG,EAAEE,YAAY;EAElCf,eAAe,CAAC,MAAM;IACpB,IAAI,CAACc,QAAQ,EAAE;IACf,OAAOA,QAAQ,CAAC,CAAC;EACnB,CAAC,EAAE,CAACA,QAAQ,CAAC,CAAC;EAEd,IAAI,CAACD,GAAG,EAAE;IACR,IAAIG,OAAO,EAAE;MACXC,OAAO,CAACC,IAAI,CAAC,gDAAgD,CAAC;IAChE;IACA,oBACEb,IAAA,CAACJ,IAAI;MAACO,KAAK,EAAEA,KAAM;MAACC,MAAM,EAAEA,MAAO;MAAA,GAAKG,kBAAkB;MAAAL,QAAA,EACvDA;IAAQ,CACL,CAAC;EAEX;EAEA,oBACEF,IAAA,CAACH,eAAe;IACdiB,OAAO,EAAEN,GAAG,CAACM,OAAQ;IACrBC,KAAK,EAAEP,GAAG,CAACO,KAAM;IACjBC,SAAS,EAAER,GAAG,CAACQ,SAAU;IACzBX,KAAK,EAAEA,KAAM;IACbY,kBAAkB,EAAET,GAAG,CAACS,kBAAmB;IAC3CC,cAAc,EAAEV,GAAG,CAACU,cAAe;IACnCC,SAAS,EAAEX,GAAG,CAACW,SAAU;IACzBC,SAAS,EAAEZ,GAAG,CAACY,SAAU;IACzBC,cAAc,EAAEb,GAAG,CAACa,cAAe;IACnCf,eAAe,EAAEA,eAAgB;IACjCH,KAAK,EAAEA,KAAM;IACbC,MAAM,EAAEA,MAAO;IAAA,GACXG,kBAAkB;IAAAL,QAAA,EAErBA;EAAQ,CACM,CAAC;AAEtB","ignoreList":[]}
+{"version":3,"names":["useContext","useLayoutEffect","View","NativeGleamView","GleamContext","jsx","_jsx","GleamLine","children","style","testID","delay","onTransitionEnd","accessibilityProps","ctx","register","registerLine","__DEV__","console","warn","loading","speed","direction","transitionDuration","transitionType","intensity","baseColor","highlightColor"],"sourceRoot":"../../src","sources":["GleamLine.tsx"],"mappings":";;AAAA,SAASA,UAAU,EAAEC,eAAe,QAAwB,OAAO;AACnE,SACEC,IAAI,QAIC,cAAc;AACrB,OAAOC,eAAe,MAA4B,4BAA4B;AAC9E,SAASC,YAAY,QAAQ,mBAAgB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAa9C,OAAO,SAASC,SAASA,CAAC;EACxBC,QAAQ;EACRC,KAAK;EACLC,MAAM;EACNC,KAAK;EACLC,eAAe;EACf,GAAGC;AACW,CAAC,EAAE;EACjB,MAAMC,GAAG,GAAGd,UAAU,CAACI,YAAY,CAAC;EACpC,MAAMW,QAAQ,GAAGD,GAAG,EAAEE,YAAY;EAElCf,eAAe,CAAC,MAAM;IACpB,IAAI,CAACc,QAAQ,EAAE;IACf,OAAOA,QAAQ,CAAC,CAAC;EACnB,CAAC,EAAE,CAACA,QAAQ,CAAC,CAAC;EAEd,IAAI,CAACD,GAAG,EAAE;IACR,IAAIG,OAAO,EAAE;MACXC,OAAO,CAACC,IAAI,CAAC,gDAAgD,CAAC;IAChE;IACA,oBACEb,IAAA,CAACJ,IAAI;MAACO,KAAK,EAAEA,KAAM;MAACC,MAAM,EAAEA,MAAO;MAAA,GAAKG,kBAAkB;MAAAL,QAAA,EACvDA;IAAQ,CACL,CAAC;EAEX;EAEA,oBACEF,IAAA,CAACH,eAAe;IACdiB,OAAO,EAAEN,GAAG,CAACM,OAAQ;IACrBC,KAAK,EAAEP,GAAG,CAACO,KAAM;IACjBC,SAAS,EAAER,GAAG,CAACQ,SAAU;IACzBX,KAAK,EAAEA,KAAM;IACbY,kBAAkB,EAAET,GAAG,CAACS,kBAAmB;IAC3CC,cAAc,EAAEV,GAAG,CAACU,cAAe;IACnCC,SAAS,EAAEX,GAAG,CAACW,SAAU;IACzBC,SAAS,EAAEZ,GAAG,CAACY,SAAU;IACzBC,cAAc,EAAEb,GAAG,CAACa,cAAe;IACnCf,eAAe,EAAEA,eAAgB;IACjCH,KAAK,EAAEA,KAAM;IACbC,MAAM,EAAEA,MAAO;IAAA,GACXG,kBAAkB;IAAAL,QAAA,EAErBA;EAAQ,CACM,CAAC;AAEtB","ignoreList":[]}

package/lib/module/GleamViewNativeComponent.ts

@@ -6,18 +6,28 @@ import {
 } from 'react-native';
 
 export interface NativeProps extends ViewProps {
+  /** Toggle shimmer on/off. @default true */
   loading?: CodegenTypes.WithDefault<boolean, true>;
+  /** Duration of one shimmer cycle in milliseconds. @default 1000 */
   speed?: CodegenTypes.WithDefault<CodegenTypes.Float, 1000>;
+  /** Animation sweep direction. @default 'ltr' */
   direction?: CodegenTypes.WithDefault<'ltr' | 'rtl' | 'ttb', 'ltr'>;
+  /** Phase offset in milliseconds — use to stagger multiple shimmers. @default 0 */
   delay?: CodegenTypes.WithDefault<CodegenTypes.Float, 0>;
+  /** Duration of the loading-to-content transition in milliseconds. `0` = instant. @default 300 */
   transitionDuration?: CodegenTypes.WithDefault<CodegenTypes.Float, 300>;
+  /** Transition style when loading ends. @default 'fade' */
   transitionType?: CodegenTypes.WithDefault<
     'fade' | 'shrink' | 'collapse',
     'fade'
   >;
+  /** Highlight strength (0–1). Lower values produce a more subtle shimmer. @default 1 */
   intensity?: CodegenTypes.WithDefault<CodegenTypes.Float, 1>;
+  /** Background color of the shimmer. @default '#E0E0E0' */
   baseColor?: ColorValue;
+  /** Color of the moving highlight. @default '#F5F5F5' */
   highlightColor?: ColorValue;
+  /** Called when the transition completes or is interrupted. `finished` is `true` if completed, `false` if interrupted. */
   onTransitionEnd?: CodegenTypes.DirectEventHandler<
     Readonly<{ finished: boolean }>
   >;

package/lib/module/index.js

@@ -25,19 +25,12 @@ export let GleamTransition = /*#__PURE__*/function (GleamTransition) {
   return GleamTransition;
 }({});
 
-// Shimmer-specific prop keys to exclude when rendering as a plain View container.
-// Typed against NativeProps so a missing key triggers a compile error.
-const SHIMMER_KEY_LIST = ['loading', 'speed', 'direction', 'delay', 'transitionDuration', 'transitionType', 'intensity', 'baseColor', 'highlightColor', 'onTransitionEnd', 'children'];
-const SHIMMER_KEYS = new Set(SHIMMER_KEY_LIST);
-function pickViewProps(props) {
-  const viewProps = {};
-  for (const key of Object.keys(props)) {
-    if (!SHIMMER_KEYS.has(key)) {
-      viewProps[key] = props[key];
-    }
-  }
-  return viewProps;
-}
+// Shimmer-specific keys that must be destructured from props before spreading
+// viewProps onto <View> in Line mode.
+//   Direction 1 (compile-time): `satisfies` catches stale/typo keys.
+//   Direction 2 (DEV runtime): check inside GleamViewComponent catches
+//   new NativeProps keys that weren't added to this list or destructured.
+const SHIMMER_KEYS = new Set(['loading', 'speed', 'direction', 'delay', 'transitionDuration', 'transitionType', 'intensity', 'baseColor', 'highlightColor', 'onTransitionEnd']);
 function hasLineChildren(children) {
   let found = false;
   React.Children.forEach(children, child => {
@@ -64,13 +57,24 @@ function GleamViewComponent({
     loading,
     speed,
     direction,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    delay,
     transitionDuration,
     transitionType,
     intensity,
     baseColor,
     highlightColor,
-    children
+    onTransitionEnd,
+    children,
+    ...viewProps
   } = props;
+  if (__DEV__) {
+    for (const key of Object.keys(viewProps)) {
+      if (SHIMMER_KEYS.has(key)) {
+        console.error(`GleamView: shimmer prop "${key}" leaked into viewProps. ` + 'Add it to the destructuring in GleamViewComponent and to SHIMMER_KEYS.');
+      }
+    }
+  }
   const lineCountRef = useRef(0);
   const warnedTransitionRef = useRef(false);
   const [hasLines, setHasLines] = useState(() => hasLineChildren(children));
@@ -80,8 +84,12 @@ function GleamViewComponent({
     return () => {
       lineCountRef.current--;
       if (lineCountRef.current === 0) {
-        setHasLines(false);
-        warnedTransitionRef.current = false;
+        queueMicrotask(() => {
+          if (lineCountRef.current === 0) {
+            setHasLines(false);
+            warnedTransitionRef.current = false;
+          }
+        });
       }
     };
   }, []);
@@ -101,7 +109,7 @@ function GleamViewComponent({
   // but that type isn't publicly exported from react-native. Safe at runtime.
   const nativeRef = ref;
   if (hasLines) {
-    if (__DEV__ && props.onTransitionEnd && !warnedTransitionRef.current) {
+    if (__DEV__ && onTransitionEnd && !warnedTransitionRef.current) {
       warnedTransitionRef.current = true;
       console.warn('GleamView: onTransitionEnd is ignored when GleamView.Line children are present. ' + 'Use onTransitionEnd on individual GleamView.Line components instead.');
     }
@@ -109,7 +117,7 @@ function GleamViewComponent({
       value: contextValue,
       children: /*#__PURE__*/_jsx(View, {
         ref: nativeRef,
-        ...pickViewProps(props),
+        ...viewProps,
         children: children
       })
     });

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useCallback","useMemo","useRef","useState","View","NativeGleamView","GleamContext","GleamLine","jsx","_jsx","GleamDirection","GleamTransition","SHIMMER_KEY_LIST","SHIMMER_KEYS","Set","pickViewProps","props","viewProps","key","Object","keys","has","hasLineChildren","children","found","Children","forEach","child","isValidElement","type","Fragment","GleamViewComponent","ref","loading","speed","direction","transitionDuration","transitionType","intensity","baseColor","highlightColor","lineCountRef","warnedTransitionRef","hasLines","setHasLines","registerLine","current","contextValue","nativeRef","__DEV__","onTransitionEnd","console","warn","Provider","value","displayName","GleamView","assign","Line"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useCallback","useMemo","useRef","useState","View","NativeGleamView","GleamContext","GleamLine","jsx","_jsx","GleamDirection","GleamTransition","SHIMMER_KEYS","Set","hasLineChildren","children","found","Children","forEach","child","isValidElement","type","Fragment","props","GleamViewComponent","ref","loading","speed","direction","delay","transitionDuration","transitionType","intensity","baseColor","highlightColor","onTransitionEnd","viewProps","__DEV__","key","Object","keys","has","console","error","lineCountRef","warnedTransitionRef","hasLines","setHasLines","registerLine","current","queueMicrotask","contextValue","nativeRef","warn","Provider","value","displayName","GleamView","assign","Line"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/GleamLine.d.ts

@@ -3,9 +3,12 @@ import { type AccessibilityProps, type StyleProp, type ViewStyle } from 'react-n
 import { type NativeProps } from './GleamViewNativeComponent';
 export interface GleamLineProps extends AccessibilityProps {
     children?: ReactNode;
+    /** Style for the shimmer bar (height, width, borderRadius, etc.). */
     style?: StyleProp<ViewStyle>;
     testID?: string;
+    /** Phase offset in milliseconds — overrides the parent's delay for this line. */
     delay?: NativeProps['delay'];
+    /** Called when this line's transition completes or is interrupted. */
     onTransitionEnd?: NativeProps['onTransitionEnd'];
 }
 export declare function GleamLine({ children, style, testID, delay, onTransitionEnd, ...accessibilityProps }: GleamLineProps): import("react/jsx-runtime").JSX.Element;

package/lib/typescript/src/GleamLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GleamLine.d.ts","sourceRoot":"","sources":["../../../src/GleamLine.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG/E,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAClD;AAED,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,MAAM,EACN,KAAK,EACL,eAAe,EACf,GAAG,kBAAkB,EACtB,EAAE,cAAc,2CAuChB"}
+{"version":3,"file":"GleamLine.d.ts","sourceRoot":"","sources":["../../../src/GleamLine.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG/E,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,sEAAsE;IACtE,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAClD;AAED,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,MAAM,EACN,KAAK,EACL,eAAe,EACf,GAAG,kBAAkB,EACtB,EAAE,cAAc,2CAuChB"}

package/lib/typescript/src/GleamViewNativeComponent.d.ts

@@ -1,14 +1,24 @@
 import { type ColorValue, type ViewProps, type CodegenTypes } from 'react-native';
 export interface NativeProps extends ViewProps {
+    /** Toggle shimmer on/off. @default true */
     loading?: CodegenTypes.WithDefault<boolean, true>;
+    /** Duration of one shimmer cycle in milliseconds. @default 1000 */
     speed?: CodegenTypes.WithDefault<CodegenTypes.Float, 1000>;
+    /** Animation sweep direction. @default 'ltr' */
     direction?: CodegenTypes.WithDefault<'ltr' | 'rtl' | 'ttb', 'ltr'>;
+    /** Phase offset in milliseconds — use to stagger multiple shimmers. @default 0 */
     delay?: CodegenTypes.WithDefault<CodegenTypes.Float, 0>;
+    /** Duration of the loading-to-content transition in milliseconds. `0` = instant. @default 300 */
     transitionDuration?: CodegenTypes.WithDefault<CodegenTypes.Float, 300>;
+    /** Transition style when loading ends. @default 'fade' */
     transitionType?: CodegenTypes.WithDefault<'fade' | 'shrink' | 'collapse', 'fade'>;
+    /** Highlight strength (0–1). Lower values produce a more subtle shimmer. @default 1 */
     intensity?: CodegenTypes.WithDefault<CodegenTypes.Float, 1>;
+    /** Background color of the shimmer. @default '#E0E0E0' */
     baseColor?: ColorValue;
+    /** Color of the moving highlight. @default '#F5F5F5' */
     highlightColor?: ColorValue;
+    /** Called when the transition completes or is interrupted. `finished` is `true` if completed, `false` if interrupted. */
     onTransitionEnd?: CodegenTypes.DirectEventHandler<Readonly<{
         finished: boolean;
     }>>;

package/lib/typescript/src/GleamViewNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GleamViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/GleamViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,OAAO,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxD,kBAAkB,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvE,cAAc,CAAC,EAAE,YAAY,CAAC,WAAW,CACvC,MAAM,GAAG,QAAQ,GAAG,UAAU,EAC9B,MAAM,CACP,CAAC;IACF,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,eAAe,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAC/C,QAAQ,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAChC,CAAC;CACH;;AAED,wBAAgE"}
+{"version":3,"file":"GleamViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/GleamViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,2CAA2C;IAC3C,OAAO,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,mEAAmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3D,gDAAgD;IAChD,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;IACnE,kFAAkF;IAClF,KAAK,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxD,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvE,0DAA0D;IAC1D,cAAc,CAAC,EAAE,YAAY,CAAC,WAAW,CACvC,MAAM,GAAG,QAAQ,GAAG,UAAU,EAC9B,MAAM,CACP,CAAC;IACF,uFAAuF;IACvF,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5D,0DAA0D;IAC1D,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,wDAAwD;IACxD,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,yHAAyH;IACzH,eAAe,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAC/C,QAAQ,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAChC,CAAC;CACH;;AAED,wBAAgE"}

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IACzC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,oBAAY,cAAc;IACxB,WAAW,QAAQ;IACnB,WAAW,QAAQ;IACnB,WAAW,QAAQ;CACpB;AAED,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAkDD,iBAAS,kBAAkB,CAAC,EAC1B,GAAG,EACH,GAAG,KAAK,EACT,EAAE,WAAW,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAAE,2CAkF5C;kBArFQ,kBAAkB;;;AAyF3B,eAAO,MAAM,SAAS;;CAEpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IACzC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,oBAAY,cAAc;IACxB,WAAW,QAAQ;IACnB,WAAW,QAAQ;IACnB,WAAW,QAAQ;CACpB;AAED,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAwCD,iBAAS,kBAAkB,CAAC,EAC1B,GAAG,EACH,GAAG,KAAK,EACT,EAAE,WAAW,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAAE,2CAqG5C;kBAxGQ,kBAAkB;;;AA4G3B,eAAO,MAAM,SAAS;;CAEpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-gleam",
-  "version": "1.0.0-beta.7",
+  "version": "1.0.0",
   "description": "Native-powered shimmer loading effect for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/GleamLine.tsx

@@ -10,9 +10,12 @@ import { GleamContext } from './GleamContext';
 
 export interface GleamLineProps extends AccessibilityProps {
   children?: ReactNode;
+  /** Style for the shimmer bar (height, width, borderRadius, etc.). */
   style?: StyleProp<ViewStyle>;
   testID?: string;
+  /** Phase offset in milliseconds — overrides the parent's delay for this line. */
   delay?: NativeProps['delay'];
+  /** Called when this line's transition completes or is interrupted. */
   onTransitionEnd?: NativeProps['onTransitionEnd'];
 }
 

package/src/GleamViewNativeComponent.ts

@@ -6,18 +6,28 @@ import {
 } from 'react-native';
 
 export interface NativeProps extends ViewProps {
+  /** Toggle shimmer on/off. @default true */
   loading?: CodegenTypes.WithDefault<boolean, true>;
+  /** Duration of one shimmer cycle in milliseconds. @default 1000 */
   speed?: CodegenTypes.WithDefault<CodegenTypes.Float, 1000>;
+  /** Animation sweep direction. @default 'ltr' */
   direction?: CodegenTypes.WithDefault<'ltr' | 'rtl' | 'ttb', 'ltr'>;
+  /** Phase offset in milliseconds — use to stagger multiple shimmers. @default 0 */
   delay?: CodegenTypes.WithDefault<CodegenTypes.Float, 0>;
+  /** Duration of the loading-to-content transition in milliseconds. `0` = instant. @default 300 */
   transitionDuration?: CodegenTypes.WithDefault<CodegenTypes.Float, 300>;
+  /** Transition style when loading ends. @default 'fade' */
   transitionType?: CodegenTypes.WithDefault<
     'fade' | 'shrink' | 'collapse',
     'fade'
   >;
+  /** Highlight strength (0–1). Lower values produce a more subtle shimmer. @default 1 */
   intensity?: CodegenTypes.WithDefault<CodegenTypes.Float, 1>;
+  /** Background color of the shimmer. @default '#E0E0E0' */
   baseColor?: ColorValue;
+  /** Color of the moving highlight. @default '#F5F5F5' */
   highlightColor?: ColorValue;
+  /** Called when the transition completes or is interrupted. `finished` is `true` if completed, `false` if interrupted. */
   onTransitionEnd?: CodegenTypes.DirectEventHandler<
     Readonly<{ finished: boolean }>
   >;

package/src/index.tsx

@@ -28,9 +28,12 @@ export enum GleamTransition {
   Collapse = 'collapse',
 }
 
-// Shimmer-specific prop keys to exclude when rendering as a plain View container.
-// Typed against NativeProps so a missing key triggers a compile error.
-const SHIMMER_KEY_LIST = [
+// Shimmer-specific keys that must be destructured from props before spreading
+// viewProps onto <View> in Line mode.
+//   Direction 1 (compile-time): `satisfies` catches stale/typo keys.
+//   Direction 2 (DEV runtime): check inside GleamViewComponent catches
+//   new NativeProps keys that weren't added to this list or destructured.
+const SHIMMER_KEYS: ReadonlySet<string> = new Set([
   'loading',
   'speed',
   'direction',
@@ -41,20 +44,7 @@ const SHIMMER_KEY_LIST = [
   'baseColor',
   'highlightColor',
   'onTransitionEnd',
-  'children',
-] as const satisfies ReadonlyArray<keyof NativeProps | 'children'>;
-
-const SHIMMER_KEYS: ReadonlySet<string> = new Set(SHIMMER_KEY_LIST);
-
-function pickViewProps(props: NativeProps) {
-  const viewProps: Record<string, unknown> = {};
-  for (const key of Object.keys(props)) {
-    if (!SHIMMER_KEYS.has(key)) {
-      viewProps[key] = (props as Record<string, unknown>)[key];
-    }
-  }
-  return viewProps;
-}
+] as const satisfies ReadonlyArray<keyof NativeProps>);
 
 function hasLineChildren(children: React.ReactNode): boolean {
   let found = false;
@@ -84,14 +74,29 @@ function GleamViewComponent({
     loading,
     speed,
     direction,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    delay,
     transitionDuration,
     transitionType,
     intensity,
     baseColor,
     highlightColor,
+    onTransitionEnd,
     children,
+    ...viewProps
   } = props;
 
+  if (__DEV__) {
+    for (const key of Object.keys(viewProps)) {
+      if (SHIMMER_KEYS.has(key)) {
+        console.error(
+          `GleamView: shimmer prop "${key}" leaked into viewProps. ` +
+            'Add it to the destructuring in GleamViewComponent and to SHIMMER_KEYS.'
+        );
+      }
+    }
+  }
+
   const lineCountRef = useRef(0);
   const warnedTransitionRef = useRef(false);
   const [hasLines, setHasLines] = useState(() => hasLineChildren(children));
@@ -102,8 +107,12 @@ function GleamViewComponent({
     return () => {
       lineCountRef.current--;
       if (lineCountRef.current === 0) {
-        setHasLines(false);
-        warnedTransitionRef.current = false;
+        queueMicrotask(() => {
+          if (lineCountRef.current === 0) {
+            setHasLines(false);
+            warnedTransitionRef.current = false;
+          }
+        });
       }
     };
   }, []);
@@ -138,7 +147,7 @@ function GleamViewComponent({
   const nativeRef = ref as any;
 
   if (hasLines) {
-    if (__DEV__ && props.onTransitionEnd && !warnedTransitionRef.current) {
+    if (__DEV__ && onTransitionEnd && !warnedTransitionRef.current) {
       warnedTransitionRef.current = true;
       console.warn(
         'GleamView: onTransitionEnd is ignored when GleamView.Line children are present. ' +
@@ -147,7 +156,7 @@ function GleamViewComponent({
     }
     return (
       <GleamContext.Provider value={contextValue}>
-        <View ref={nativeRef} {...pickViewProps(props)}>
+        <View ref={nativeRef} {...viewProps}>
           {children}
         </View>
       </GleamContext.Provider>