react-native-gleam 1.0.0-beta.8 → 1.0.1

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,15 @@ npx expo prebuild
 
 No config plugin needed — autolinking and codegen handle everything.
 
+### Claude Code
+
+Install the plugin, then run `/gleam` to get guided through setup.
+
+```sh
+claude plugin marketplace add RamboWasReal/react-native-gleam
+claude plugin install react-native-gleam
+```
+
 ## Usage
 
 ```tsx
@@ -119,8 +128,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 +192,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

@@ -159,6 +159,7 @@ class GleamView(context: Context) : ReactViewGroup(context) {
         super.onDetachedFromWindow()
         unregisterClock()
         isTransitioning = false
+        transitionAnimator?.removeAllListeners()
         transitionAnimator?.cancel()
         transitionAnimator = null
     }
@@ -174,6 +175,7 @@ class GleamView(context: Context) : ReactViewGroup(context) {
     fun cleanup() {
         unregisterClock()
         isTransitioning = false
+        transitionAnimator?.removeAllListeners()
         transitionAnimator?.cancel()
         transitionAnimator = null
     }
@@ -317,10 +319,10 @@ class GleamView(context: Context) : ReactViewGroup(context) {
     }
 
     private fun blendColor(from: Int, to: Int, ratio: Float): Int {
-        val r = Color.red(from) + ((Color.red(to) - Color.red(from)) * ratio).toInt()
-        val g = Color.green(from) + ((Color.green(to) - Color.green(from)) * ratio).toInt()
-        val b = Color.blue(from) + ((Color.blue(to) - Color.blue(from)) * ratio).toInt()
-        val a = Color.alpha(from) + ((Color.alpha(to) - Color.alpha(from)) * ratio).toInt()
+        val r = (Color.red(from) + ((Color.red(to) - Color.red(from)) * ratio).toInt()).coerceIn(0, 255)
+        val g = (Color.green(from) + ((Color.green(to) - Color.green(from)) * ratio).toInt()).coerceIn(0, 255)
+        val b = (Color.blue(from) + ((Color.blue(to) - Color.blue(from)) * ratio).toInt()).coerceIn(0, 255)
+        val a = (Color.alpha(from) + ((Color.alpha(to) - Color.alpha(from)) * ratio).toInt()).coerceIn(0, 255)
         return Color.argb(a, r, g, b)
     }
 
@@ -432,9 +434,9 @@ class GleamView(context: Context) : ReactViewGroup(context) {
         private fun start() {
             frameCallback = Choreographer.FrameCallback { frameTimeNanos ->
                 val timeMs = frameTimeNanos / 1_000_000f
-                // Reverse index iteration — safe if onFrame triggers unregister (shrinks tail)
-                for (i in views.indices.reversed()) {
-                    views[i].onFrame(timeMs)
+                val snapshot = views.toList()
+                for (i in snapshot.indices.reversed()) {
+                    snapshot[i].onFrame(timeMs)
                 }
                 frameCallback?.let { Choreographer.getInstance().postFrameCallback(it) }
             }

package/ios/GleamView.mm

@@ -51,6 +51,7 @@ static void _registerView(GleamView *view) {
     if (_viewCount >= _viewCapacity) {
         NSUInteger newCap = _viewCapacity == 0 ? 16 : _viewCapacity * 2;
         GleamView * __strong *newBuf = (GleamView * __strong *)calloc(newCap, sizeof(GleamView *));
+        if (!newBuf) return;
         if (_views) {
             for (NSUInteger i = 0; i < _viewCount; i++) {
                 newBuf[i] = _views[i];
@@ -263,15 +264,18 @@ static void _unregisterView(GleamView *view) {
     const auto &newViewProps = *std::static_pointer_cast<GleamViewProps const>(props);
 
     if (oldViewProps.speed != newViewProps.speed) {
-        _speed = fmax(newViewProps.speed / 1000.0, 0.001);
+        double s = newViewProps.speed / 1000.0;
+        _speed = (isnan(s) || isinf(s) || s <= 0) ? 1.0 : fmax(s, 0.001);
     }
 
     if (oldViewProps.delay != newViewProps.delay) {
-        _delay = newViewProps.delay / 1000.0;
+        double d = newViewProps.delay / 1000.0;
+        _delay = (isnan(d) || isinf(d)) ? 0.0 : d;
     }
 
     if (oldViewProps.transitionDuration != newViewProps.transitionDuration) {
-        _transitionDuration = newViewProps.transitionDuration / 1000.0;
+        double td = newViewProps.transitionDuration / 1000.0;
+        _transitionDuration = (isnan(td) || isinf(td) || td < 0) ? 0.3 : td;
     }
 
     if (oldViewProps.transitionType != newViewProps.transitionType) {

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-gleam",
-  "version": "1.0.0-beta.8",
+  "version": "1.0.1",
   "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 }>
   >;