react-native-blur-vibe 0.1.8 → 0.1.10

package/src/types.ts

@@ -88,7 +88,7 @@ export type BlurType =
  * | `"leftToRight"`  | Left edge      | Right edge     |
  * | `"rightToLeft"`  | Right edge     | Left edge      |
  * | `"radial"`       | Center         | Outer edges    |
- * | `"none"`         | — uniform blur — no gradient    |
+ * | `"none"`         | — uniform blur — no gradient   |
  *
  * @example
  * // Sticky header: full blur at top, invisible at bottom
@@ -311,4 +311,33 @@ export interface BlurViewProps extends ViewProps {
    * @platform ios, android (API 31+)
    */
   noiseFactor?: number;
+
+  // ─── Blur control ──────────────────────────────────────────────────────────
+
+  /**
+   * Enable or disable the blur effect.
+   *
+   * When `false`, the view renders as transparent (showing
+   * `reducedTransparencyFallbackColor` if set). Useful for toggling blur
+   * based on scroll position, performance mode, or user preference.
+   *
+   * **Works on both iOS and Android.**
+   *
+   * @default true
+   */
+  enabled?: boolean;
+
+  /**
+   * Automatically re-capture and re-blur when the content behind changes.
+   *
+   * When `false`, the blur is captured once at mount and never updated.
+   * Use this for completely static backgrounds (e.g. a blurred album art
+   * card where the image never changes) — eliminates all per-frame cost
+   * on Android API < 31.
+   *
+   * **Works on both iOS and Android.**
+   *
+   * @default true
+   */
+  autoUpdate?: boolean;
 }