react-native-audio-browser 0.2.0-next.3 → 0.2.0-next.5

package/src/features/player/options.ts

@@ -117,10 +117,11 @@ export interface PlayerCapabilities {
 }
 
 /**
- * Buttons that can be assigned to Android notification button slots.
- * These represent the interactive buttons users can tap in the notification.
+ * Buttons that can be placed in the Android button layout — the interactive
+ * controls a listener taps in the notification, on the Android Auto Now Playing
+ * screen, and in the Android 13+ system media controls.
  */
-export type NotificationButton =
+export type RemoteButton =
   | 'skip-to-previous'
   | 'skip-to-next'
   | 'jump-backward'
@@ -128,43 +129,71 @@ export type NotificationButton =
   | 'favorite'
 
 /**
- * Configuration for notification button layout on Android.
- * Allows explicit control over which buttons appear in which slots.
+ * Where each button sits on Android.
  *
- * Slot behavior:
- * - **Omit a slot**: Derive from capabilities (smart default)
- * - **Set to null**: Explicitly empty slot
- * - **Set to button**: Show that button in that slot
+ * Android offers exactly three positions, and play/pause always occupies the
+ * centre — you cannot move it, and you cannot put two buttons on the same side
+ * of it:
+ *
+ * ```
+ *   back  │  ▶ play/pause  │  forward        overflow ⋯
+ * ```
+ *
+ * - **`back`** — the single position left of play/pause
+ * - **`forward`** — the single position right of play/pause
+ * - **`overflow`** — everything else, in priority order
+ *
+ * **A layout describes the whole arrangement.** All three fields are required —
+ * there is no per-field merge with the capability defaults, so what you write is
+ * exactly what renders. Use `undefined` for an empty position and `[]` for no
+ * overflow. To go back to the derived defaults, omit `remoteButtonLayout`
+ * entirely (or set it to `null`); that is the only switch.
+ *
+ * **Overflow order is priority, not coordinates.** Each surface renders as many
+ * buttons as it has room for, taking them from the front — a phone
+ * notification, the Android 13+ system media controls, and a car head unit all
+ * have different budgets. A head unit with a spare slot may promote the first
+ * overflow entry onto the main row, and a long list gets truncated by whichever
+ * surface is showing it. Put what matters most first.
+ *
+ * Placement never changes what a control *can* do: a button left out entirely
+ * still responds to a Bluetooth remote or headset, as long as its
+ * {@link PlayerCapabilities} entry is enabled.
  *
  * @example
  * ```typescript
- * // Podcast-style: jump buttons as primary
- * notificationButtons: {
+ * // Podcast-style: jump either side of play/pause
+ * remoteButtonLayout: {
  *   back: 'jump-backward',
  *   forward: 'jump-forward',
- *   overflow: ['favorite']
+ *   overflow: ['skip-to-previous', 'skip-to-next', 'favorite']
  * }
  *
- * // Music-style: skip as primary, jump as secondary
- * notificationButtons: {
+ * // Music-style: skip either side of play/pause
+ * remoteButtonLayout: {
  *   back: 'skip-to-previous',
  *   forward: 'skip-to-next',
- *   backSecondary: 'jump-backward',
- *   forwardSecondary: 'jump-forward'
+ *   overflow: ['favorite']
+ * }
+ *
+ * // Live radio: forward only, nothing to the left
+ * remoteButtonLayout: {
+ *   back: undefined,
+ *   forward: 'skip-to-next',
+ *   overflow: []
  * }
  * ```
  */
-export type NotificationButtonLayout = {
-  /** Primary back position (SLOT_BACK) - typically previous track or jump backward */
-  back?: NotificationButton | null
-  /** Primary forward position (SLOT_FORWARD) - typically next track or jump forward */
-  forward?: NotificationButton | null
-  /** Secondary back position (SLOT_BACK_SECONDARY) */
-  backSecondary?: NotificationButton | null
-  /** Secondary forward position (SLOT_FORWARD_SECONDARY) */
-  forwardSecondary?: NotificationButton | null
-  /** Additional buttons in overflow area (SLOT_OVERFLOW) */
-  overflow?: NotificationButton[]
+export type RemoteButtonLayout = {
+  /** The single position left of play/pause. `undefined` leaves it empty. */
+  back: RemoteButton | undefined
+  /** The single position right of play/pause. `undefined` leaves it empty. */
+  forward: RemoteButton | undefined
+  /**
+   * Everything else, most important first — surfaces promote and truncate from
+   * the front. `[]` for none.
+   */
+  overflow: RemoteButton[]
 }
 
 /**
@@ -204,12 +233,22 @@ export interface Options {
 
   /**
    * Jump forward interval in seconds when using jump forward controls.
+   *
+   * On Android, an interval of exactly 5, 10, 15 or 30 seconds gets an icon
+   * showing that number; any other interval gets an icon without one. Other
+   * values are perfectly valid — the interval also sets the seek distance.
+   *
    * @default 15
    */
   forwardJumpInterval: number
 
   /**
    * Jump backward interval in seconds when using jump backward controls.
+   *
+   * On Android, an interval of exactly 5, 10, 15 or 30 seconds gets an icon
+   * showing that number; any other interval gets an icon without one. Other
+   * values are perfectly valid — the interval also sets the seek distance.
+   *
    * @default 15
    */
   backwardJumpInterval: number
@@ -273,14 +312,14 @@ export interface AndroidOptions {
   skipSilence: boolean
 
   /**
-   * Slot-based button layout for Android notifications.
-   * Provides explicit control over which buttons appear in which positions.
+   * Ordered button layout, applied to the notification, Android Auto, and the
+   * Android 13+ system media controls. See {@link RemoteButtonLayout}.
    *
-   * When not specified, button layout is derived from capabilities.
+   * When not specified, the layout is derived from capabilities.
    *
    * @platform android
    */
-  notificationButtons: NotificationButtonLayout | null
+  remoteButtonLayout: RemoteButtonLayout | null
 }
 
 export interface AndroidUpdateOptions {
@@ -300,14 +339,14 @@ export interface AndroidUpdateOptions {
   skipSilence?: boolean
 
   /**
-   * Slot-based button layout for Android notifications.
-   * Provides explicit control over which buttons appear in which positions.
+   * Ordered button layout, applied to the notification, Android Auto, and the
+   * Android 13+ system media controls. See {@link RemoteButtonLayout}.
    *
-   * When not specified, button layout is derived from capabilities.
+   * When not specified, the layout is derived from capabilities.
    *
    * @platform android
    */
-  notificationButtons?: NotificationButtonLayout | null
+  remoteButtonLayout?: RemoteButtonLayout | null
 }
 
 /**
@@ -317,7 +356,7 @@ export interface AndroidUpdateOptions {
 export interface NitroAndroidUpdateOptions {
   appKilledPlaybackBehavior?: AppKilledPlaybackBehavior
   skipSilence?: boolean
-  notificationButtons?: NotificationButtonLayout | null
+  remoteButtonLayout?: RemoteButtonLayout | null
 }
 
 /**
@@ -394,12 +433,22 @@ export interface UpdateOptions {
 
   /**
    * Jump forward interval in seconds when using jump forward controls.
+   *
+   * On Android, an interval of exactly 5, 10, 15 or 30 seconds gets an icon
+   * showing that number; any other interval gets an icon without one. Other
+   * values are perfectly valid — the interval also sets the seek distance.
+   *
    * @default 15
    */
   forwardJumpInterval?: number
 
   /**
    * Jump backward interval in seconds when using jump backward controls.
+   *
+   * On Android, an interval of exactly 5, 10, 15 or 30 seconds gets an icon
+   * showing that number; any other interval gets an icon without one. Other
+   * values are perfectly valid — the interval also sets the seek distance.
+   *
    * @default 15
    */
   backwardJumpInterval?: number
@@ -442,12 +491,22 @@ export interface NativeUpdateOptions {
 
   /**
    * Jump forward interval in seconds when using jump forward controls.
+   *
+   * On Android, an interval of exactly 5, 10, 15 or 30 seconds gets an icon
+   * showing that number; any other interval gets an icon without one. Other
+   * values are perfectly valid — the interval also sets the seek distance.
+   *
    * @default 15
    */
   forwardJumpInterval?: number
 
   /**
    * Jump backward interval in seconds when using jump backward controls.
+   *
+   * On Android, an interval of exactly 5, 10, 15 or 30 seconds gets an icon
+   * showing that number; any other interval gets an icon without one. Other
+   * values are perfectly valid — the interval also sets the seek distance.
+   *
    * @default 15
    */
   backwardJumpInterval?: number

package/src/features/player/setup.test.ts

@@ -52,7 +52,11 @@ describe('setupPlayer wire regrouping', () => {
         minBuffer: 50_000,
         wakeMode: 'network',
         skipSilence: true,
-        notificationButtons: { overflow: ['favorite'] }
+        remoteButtonLayout: {
+          back: 'jump-backward',
+          forward: 'jump-forward',
+          overflow: ['favorite']
+        }
       }
     })
 
@@ -61,7 +65,11 @@ describe('setupPlayer wire regrouping', () => {
     expect(sent.options).toEqual({
       android: {
         skipSilence: true,
-        notificationButtons: { overflow: ['favorite'] }
+        remoteButtonLayout: {
+          back: 'jump-backward',
+          forward: 'jump-forward',
+          overflow: ['favorite']
+        }
       }
     })
   })
@@ -85,12 +93,12 @@ describe('setupPlayer wire regrouping', () => {
   it('forwards meaningful nulls (progress disabled, empty button layout)', async () => {
     await setupPlayer({
       progressUpdateEventInterval: null,
-      android: { notificationButtons: null }
+      android: { remoteButtonLayout: null }
     })
 
     expect(payload().options).toEqual({
       progressUpdateEventInterval: null,
-      android: { notificationButtons: null }
+      android: { remoteButtonLayout: null }
     })
   })
 

package/src/features/player/setup.ts

@@ -326,7 +326,7 @@ export type AndroidPlayerWakeMode = 'none' | 'local' | 'network'
 
 /**
  * Android setup options: the engine-construction fields plus the Android runtime options
- * ({@link AndroidUpdateOptions} — `notificationButtons`, `skipSilence`, …), all expressible at
+ * ({@link AndroidUpdateOptions} — `remoteButtonLayout`, `skipSilence`, …), all expressible at
  * launch. The consumer never has to know which is which; `setupPlayer` routes each field to
  * where it's applied.
  */
@@ -658,7 +658,7 @@ function wrapNowPlayingFormatter(
 
 /**
  * The object's entries whose values aren't `undefined`. `null` stays: it's meaningful on some
- * fields (`progressUpdateEventInterval: null` disables progress events, `notificationButtons:
+ * fields (`progressUpdateEventInterval: null` disables progress events, `remoteButtonLayout:
  * null` empties the layout), so only `undefined` means "not provided".
  */
 function definedFields<T extends object>(obj: T): Partial<T> {
@@ -682,7 +682,7 @@ function nonEmpty<K extends string, T extends object>(
 /**
  * Initializes the player with the specified options — the full launch description in one
  * declarative, atomic call. Runtime options (`capabilities`, jump intervals,
- * `notificationButtons`, …) and the initial `playWhenReady` / `repeatMode` are applied
+ * `remoteButtonLayout`, …) and the initial `playWhenReady` / `repeatMode` are applied
  * natively as part of setup itself, so there is no setup-then-command ordering for consumers
  * to know about, and no window where the player exists without its options.
  *
@@ -699,7 +699,14 @@ function nonEmpty<K extends string, T extends object>(
  *   playWhenReady: true,
  *   repeatMode: 'queue',
  *   capabilities: { favorite: true },
- *   android: { audioContentType: 'music', notificationButtons: { overflow: ['favorite'] } },
+ *   android: {
+ *     audioContentType: 'music',
+ *     remoteButtonLayout: {
+ *       back: 'jump-backward',
+ *       forward: 'jump-forward',
+ *       overflow: ['favorite']
+ *     }
+ *   },
  *   ios: { category: 'playback' }
  * })
  * ```
@@ -724,7 +731,7 @@ export async function setupPlayer(
   const {
     appKilledPlaybackBehavior,
     skipSilence,
-    notificationButtons,
+    remoteButtonLayout,
     ...androidSetup
   } = android
   const {
@@ -750,7 +757,7 @@ export async function setupPlayer(
       definedFields({
         appKilledPlaybackBehavior,
         skipSilence,
-        notificationButtons
+        remoteButtonLayout
       })
     ),
     ...nonEmpty('ios', iosUpdate)

package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp

@@ -1,94 +0,0 @@
-///
-/// JNotificationButtonLayout.hpp
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © Marc Rousavy @ Margelo
-///
-
-#pragma once
-
-#include <fbjni/fbjni.h>
-#include "NotificationButtonLayout.hpp"
-
-#include "JNotificationButton.hpp"
-#include "NotificationButton.hpp"
-#include <optional>
-#include <vector>
-
-namespace margelo::nitro::audiobrowser {
-
-  using namespace facebook;
-
-  /**
-   * The C++ JNI bridge between the C++ struct "NotificationButtonLayout" and the the Kotlin data class "NotificationButtonLayout".
-   */
-  struct JNotificationButtonLayout final: public jni::JavaClass<JNotificationButtonLayout> {
-  public:
-    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/audiobrowser/NotificationButtonLayout;";
-
-  public:
-    /**
-     * Convert this Java/Kotlin-based struct to the C++ struct NotificationButtonLayout by copying all values to C++.
-     */
-    [[maybe_unused]]
-    [[nodiscard]]
-    NotificationButtonLayout toCpp() const {
-      static const auto clazz = javaClassStatic();
-      static const auto fieldBack = clazz->getField<JNotificationButton>("back");
-      jni::local_ref<JNotificationButton> back = this->getFieldValue(fieldBack);
-      static const auto fieldForward = clazz->getField<JNotificationButton>("forward");
-      jni::local_ref<JNotificationButton> forward = this->getFieldValue(fieldForward);
-      static const auto fieldBackSecondary = clazz->getField<JNotificationButton>("backSecondary");
-      jni::local_ref<JNotificationButton> backSecondary = this->getFieldValue(fieldBackSecondary);
-      static const auto fieldForwardSecondary = clazz->getField<JNotificationButton>("forwardSecondary");
-      jni::local_ref<JNotificationButton> forwardSecondary = this->getFieldValue(fieldForwardSecondary);
-      static const auto fieldOverflow = clazz->getField<jni::JArrayClass<JNotificationButton>>("overflow");
-      jni::local_ref<jni::JArrayClass<JNotificationButton>> overflow = this->getFieldValue(fieldOverflow);
-      return NotificationButtonLayout(
-        back != nullptr ? std::make_optional(back->toCpp()) : std::nullopt,
-        forward != nullptr ? std::make_optional(forward->toCpp()) : std::nullopt,
-        backSecondary != nullptr ? std::make_optional(backSecondary->toCpp()) : std::nullopt,
-        forwardSecondary != nullptr ? std::make_optional(forwardSecondary->toCpp()) : std::nullopt,
-        overflow != nullptr ? std::make_optional([&]() {
-          size_t __size = overflow->size();
-          std::vector<NotificationButton> __vector;
-          __vector.reserve(__size);
-          for (size_t __i = 0; __i < __size; __i++) {
-            auto __element = overflow->getElement(__i);
-            __vector.push_back(__element->toCpp());
-          }
-          return __vector;
-        }()) : std::nullopt
-      );
-    }
-
-  public:
-    /**
-     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
-     */
-    [[maybe_unused]]
-    static jni::local_ref<JNotificationButtonLayout::javaobject> fromCpp(const NotificationButtonLayout& value) {
-      using JSignature = JNotificationButtonLayout(jni::alias_ref<JNotificationButton>, jni::alias_ref<JNotificationButton>, jni::alias_ref<JNotificationButton>, jni::alias_ref<JNotificationButton>, jni::alias_ref<jni::JArrayClass<JNotificationButton>>);
-      static const auto clazz = javaClassStatic();
-      static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
-      return create(
-        clazz,
-        value.back.has_value() ? JNotificationButton::fromCpp(value.back.value()) : nullptr,
-        value.forward.has_value() ? JNotificationButton::fromCpp(value.forward.value()) : nullptr,
-        value.backSecondary.has_value() ? JNotificationButton::fromCpp(value.backSecondary.value()) : nullptr,
-        value.forwardSecondary.has_value() ? JNotificationButton::fromCpp(value.forwardSecondary.value()) : nullptr,
-        value.overflow.has_value() ? [&]() {
-          size_t __size = value.overflow.value().size();
-          jni::local_ref<jni::JArrayClass<JNotificationButton>> __array = jni::JArrayClass<JNotificationButton>::newArray(__size);
-          for (size_t __i = 0; __i < __size; __i++) {
-            const auto& __element = value.overflow.value()[__i];
-            auto __elementJni = JNotificationButton::fromCpp(__element);
-            __array->setElement(__i, *__elementJni);
-          }
-          return __array;
-        }() : nullptr
-      );
-    }
-  };
-
-} // namespace margelo::nitro::audiobrowser

package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp

@@ -1,26 +0,0 @@
-///
-/// JVariant_NullType_NotificationButtonLayout.cpp
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © Marc Rousavy @ Margelo
-///
-
-#include "JVariant_NullType_NotificationButtonLayout.hpp"
-
-namespace margelo::nitro::audiobrowser {
-  /**
-   * Converts JVariant_NullType_NotificationButtonLayout to std::variant<nitro::NullType, NotificationButtonLayout>
-   */
-  std::variant<nitro::NullType, NotificationButtonLayout> JVariant_NullType_NotificationButtonLayout::toCpp() const {
-    if (isInstanceOf(JVariant_NullType_NotificationButtonLayout_impl::First::javaClassStatic())) {
-      // It's a `nitro::NullType`
-      auto jniValue = static_cast<const JVariant_NullType_NotificationButtonLayout_impl::First*>(this)->getValue();
-      return nitro::null;
-    } else if (isInstanceOf(JVariant_NullType_NotificationButtonLayout_impl::Second::javaClassStatic())) {
-      // It's a `NotificationButtonLayout`
-      auto jniValue = static_cast<const JVariant_NullType_NotificationButtonLayout_impl::Second*>(this)->getValue();
-      return jniValue->toCpp();
-    }
-    throw std::invalid_argument("Variant is unknown Kotlin instance!");
-  }
-} // namespace margelo::nitro::audiobrowser

package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp

@@ -1,75 +0,0 @@
-///
-/// JVariant_NullType_NotificationButtonLayout.hpp
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © Marc Rousavy @ Margelo
-///
-
-#pragma once
-
-#include <fbjni/fbjni.h>
-#include <variant>
-
-#include <NitroModules/Null.hpp>
-#include "NotificationButtonLayout.hpp"
-#include <variant>
-#include <NitroModules/JNull.hpp>
-#include "JNotificationButtonLayout.hpp"
-#include "NotificationButton.hpp"
-#include <optional>
-#include "JNotificationButton.hpp"
-#include <vector>
-
-namespace margelo::nitro::audiobrowser {
-
-  using namespace facebook;
-
-  /**
-   * The C++ JNI bridge between the C++ std::variant and the Java class "Variant_NullType_NotificationButtonLayout".
-   */
-  class JVariant_NullType_NotificationButtonLayout: public jni::JavaClass<JVariant_NullType_NotificationButtonLayout> {
-  public:
-    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/audiobrowser/Variant_NullType_NotificationButtonLayout;";
-
-    static jni::local_ref<JVariant_NullType_NotificationButtonLayout> create_0(jni::alias_ref<JNull> value) {
-      static const auto method = javaClassStatic()->getStaticMethod<JVariant_NullType_NotificationButtonLayout(jni::alias_ref<JNull>)>("create");
-      return method(javaClassStatic(), value);
-    }
-    static jni::local_ref<JVariant_NullType_NotificationButtonLayout> create_1(jni::alias_ref<JNotificationButtonLayout> value) {
-      static const auto method = javaClassStatic()->getStaticMethod<JVariant_NullType_NotificationButtonLayout(jni::alias_ref<JNotificationButtonLayout>)>("create");
-      return method(javaClassStatic(), value);
-    }
-
-    static jni::local_ref<JVariant_NullType_NotificationButtonLayout> fromCpp(const std::variant<nitro::NullType, NotificationButtonLayout>& variant) {
-      switch (variant.index()) {
-        case 0: return create_0(JNull::null());
-        case 1: return create_1(JNotificationButtonLayout::fromCpp(std::get<1>(variant)));
-        default: throw std::invalid_argument("Variant holds unknown index! (" + std::to_string(variant.index()) + ")");
-      }
-    }
-
-    [[nodiscard]] std::variant<nitro::NullType, NotificationButtonLayout> toCpp() const;
-  };
-
-  namespace JVariant_NullType_NotificationButtonLayout_impl {
-    class First final: public jni::JavaClass<First, JVariant_NullType_NotificationButtonLayout> {
-    public:
-      static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/audiobrowser/Variant_NullType_NotificationButtonLayout$First;";
-    
-      [[nodiscard]] jni::local_ref<JNull> getValue() const {
-        static const auto field = javaClassStatic()->getField<JNull>("value");
-        return getFieldValue(field);
-      }
-    };
-    
-    class Second final: public jni::JavaClass<Second, JVariant_NullType_NotificationButtonLayout> {
-    public:
-      static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/audiobrowser/Variant_NullType_NotificationButtonLayout$Second;";
-    
-      [[nodiscard]] jni::local_ref<JNotificationButtonLayout> getValue() const {
-        static const auto field = javaClassStatic()->getField<JNotificationButtonLayout>("value");
-        return getFieldValue(field);
-      }
-    };
-  } // namespace JVariant_NullType_NotificationButtonLayout_impl
-} // namespace margelo::nitro::audiobrowser

package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt

@@ -1,50 +0,0 @@
-///
-/// NotificationButtonLayout.kt
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © Marc Rousavy @ Margelo
-///
-
-package com.margelo.nitro.audiobrowser
-
-import androidx.annotation.Keep
-import com.facebook.proguard.annotations.DoNotStrip
-
-
-/**
- * Represents the JavaScript object/struct "NotificationButtonLayout".
- */
-@DoNotStrip
-@Keep
-data class NotificationButtonLayout(
-  @DoNotStrip
-  @Keep
-  val back: NotificationButton?,
-  @DoNotStrip
-  @Keep
-  val forward: NotificationButton?,
-  @DoNotStrip
-  @Keep
-  val backSecondary: NotificationButton?,
-  @DoNotStrip
-  @Keep
-  val forwardSecondary: NotificationButton?,
-  @DoNotStrip
-  @Keep
-  val overflow: Array<NotificationButton>?
-) {
-  /* primary constructor */
-
-  companion object {
-    /**
-     * Constructor called from C++
-     */
-    @DoNotStrip
-    @Keep
-    @Suppress("unused")
-    @JvmStatic
-    private fun fromCpp(back: NotificationButton?, forward: NotificationButton?, backSecondary: NotificationButton?, forwardSecondary: NotificationButton?, overflow: Array<NotificationButton>?): NotificationButtonLayout {
-      return NotificationButtonLayout(back, forward, backSecondary, forwardSecondary, overflow)
-    }
-  }
-}

package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift

@@ -1,92 +0,0 @@
-///
-/// NotificationButtonLayout.swift
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © Marc Rousavy @ Margelo
-///
-
-import NitroModules
-
-/**
- * Represents an instance of `NotificationButtonLayout`, backed by a C++ struct.
- */
-public typealias NotificationButtonLayout = margelo.nitro.audiobrowser.NotificationButtonLayout
-
-public extension NotificationButtonLayout {
-  private typealias bridge = margelo.nitro.audiobrowser.bridge.swift
-
-  /**
-   * Create a new instance of `NotificationButtonLayout`.
-   */
-  init(back: NotificationButton?, forward: NotificationButton?, backSecondary: NotificationButton?, forwardSecondary: NotificationButton?, overflow: [NotificationButton]?) {
-    self.init({ () -> bridge.std__optional_NotificationButton_ in
-      if let __unwrappedValue = back {
-        return bridge.create_std__optional_NotificationButton_(__unwrappedValue)
-      } else {
-        return .init()
-      }
-    }(), { () -> bridge.std__optional_NotificationButton_ in
-      if let __unwrappedValue = forward {
-        return bridge.create_std__optional_NotificationButton_(__unwrappedValue)
-      } else {
-        return .init()
-      }
-    }(), { () -> bridge.std__optional_NotificationButton_ in
-      if let __unwrappedValue = backSecondary {
-        return bridge.create_std__optional_NotificationButton_(__unwrappedValue)
-      } else {
-        return .init()
-      }
-    }(), { () -> bridge.std__optional_NotificationButton_ in
-      if let __unwrappedValue = forwardSecondary {
-        return bridge.create_std__optional_NotificationButton_(__unwrappedValue)
-      } else {
-        return .init()
-      }
-    }(), { () -> bridge.std__optional_std__vector_NotificationButton__ in
-      if let __unwrappedValue = overflow {
-        return bridge.create_std__optional_std__vector_NotificationButton__({ () -> bridge.std__vector_NotificationButton_ in
-          var __vector = bridge.create_std__vector_NotificationButton_(__unwrappedValue.count)
-          for __item in __unwrappedValue {
-            __vector.push_back(__item)
-          }
-          return __vector
-        }())
-      } else {
-        return .init()
-      }
-    }())
-  }
-
-  @inline(__always)
-  var back: NotificationButton? {
-    return self.__back.value
-  }
-  
-  @inline(__always)
-  var forward: NotificationButton? {
-    return self.__forward.value
-  }
-  
-  @inline(__always)
-  var backSecondary: NotificationButton? {
-    return self.__backSecondary.value
-  }
-  
-  @inline(__always)
-  var forwardSecondary: NotificationButton? {
-    return self.__forwardSecondary.value
-  }
-  
-  @inline(__always)
-  var overflow: [NotificationButton]? {
-    return { () -> [NotificationButton]? in
-      if bridge.has_value_std__optional_std__vector_NotificationButton__(self.__overflow) {
-        let __unwrapped = bridge.get_std__optional_std__vector_NotificationButton__(self.__overflow)
-        return __unwrapped.map({ __item in __item })
-      } else {
-        return nil
-      }
-    }()
-  }
-}