@castlabs/react-native-prestoplay-ios-avplayerviewcontroller 1.0.0

package/lib/components/AppleTvContextualAction.ios.js

@@ -0,0 +1,43 @@
+import { useContext, useEffect, useRef } from 'react';
+import { AppleTvPlayerControlsContext } from './AppleTvPlayerControls.ios';
+import { ActionType } from '../types/ActionType';
+import uuid from 'uuid-random';
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * You can use the tvOS player UI to present controls contextually, which you
+ * display for a specific range of time in the content and then dismiss.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Present-Actions-Contextually | Present Actions Contextually}.
+ *
+ * @group Components
+ */
+export const AppleTvContextualAction = props => {
+    const { eventEmitter, updateAction, addAction, removeAction } = useContext(AppleTvPlayerControlsContext);
+    const actionId = useRef(uuid());
+    useEffect(() => {
+        const _actionId = actionId.current;
+        addAction(ActionType.Contextual, _actionId, props);
+        return () => {
+            removeAction(ActionType.Contextual, _actionId);
+        };
+    });
+    const onPressRef = useRef(props.onPress);
+    useEffect(() => {
+        onPressRef.current = props.onPress;
+    }, [props.onPress]);
+    useEffect(() => {
+        const _actionId = actionId.current;
+        const onEvent = (_event) => {
+            onPressRef.current();
+        };
+        eventEmitter.addEventListener(_actionId, onEvent);
+        return () => {
+            eventEmitter.removeEventListener(_actionId, onEvent);
+        };
+    }, [eventEmitter]);
+    useEffect(() => {
+        updateAction(actionId.current, true, props.title, props.icon);
+    }, [props.title, props.icon, updateAction]);
+    return null; // declarative action, AppleTvPlayerControls interprets it
+};

package/lib/components/AppleTvInfoBarAction.ios.d.ts

@@ -0,0 +1,34 @@
+/// <reference types="react" />
+/**
+ * AppleTvInfoBarActionProps defines the properties for an
+ * {@link AppleTvInfoBarAction}
+ *
+ * @group Type Aliases
+ */
+export type AppleTvInfoBarActionProps = {
+    /** The text of the infobar action button. */
+    title: string;
+    /** The name of the image resource in the Xcode app project. */
+    icon: string;
+    /** The state of the info bar action button. */
+    state: boolean;
+    /**
+     * Action to be executed when the button is pressed.
+     *
+     * @param value - The action state string passed to the handler.
+     */
+    onPress: (value: string) => void;
+};
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * An AVPlayerViewController presents an Info tab when playing an asset with
+ * embedded or external metadata. The tab’s view displays the metadata details,
+ * and it may show up to two AppleTvInfoBarAction controls along its trailing
+ * edge.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Present-Actions-in-the-Info-Tab | Present Actions in the Info Tab}.
+ *
+ * @group Components
+ */
+export declare const AppleTvInfoBarAction: React.FC<AppleTvInfoBarActionProps>;

package/lib/components/AppleTvInfoBarAction.ios.js

@@ -0,0 +1,46 @@
+import { useContext, useEffect, useRef } from 'react';
+import { AppleTvPlayerControlsContext } from './AppleTvPlayerControls.ios';
+import { ActionType } from '../types/ActionType';
+import uuid from 'uuid-random';
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * An AVPlayerViewController presents an Info tab when playing an asset with
+ * embedded or external metadata. The tab’s view displays the metadata details,
+ * and it may show up to two AppleTvInfoBarAction controls along its trailing
+ * edge.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Present-Actions-in-the-Info-Tab | Present Actions in the Info Tab}.
+ *
+ * @group Components
+ */
+export const AppleTvInfoBarAction = props => {
+    const { eventEmitter, updateAction, addAction, removeAction } = useContext(AppleTvPlayerControlsContext);
+    const actionId = useRef(uuid());
+    useEffect(() => {
+        const _actionId = actionId.current;
+        addAction(ActionType.InfoBar, _actionId, props);
+        return () => {
+            removeAction(ActionType.InfoBar, _actionId);
+        };
+    });
+    const onPressRef = useRef(props.onPress);
+    useEffect(() => {
+        onPressRef.current = props.onPress;
+    }, [props.onPress]);
+    useEffect(() => {
+        const _actionId = actionId.current;
+        const onEvent = (event) => {
+            const details = event.details;
+            onPressRef.current(details.data);
+        };
+        eventEmitter.addEventListener(_actionId, onEvent);
+        return () => {
+            eventEmitter.removeEventListener(_actionId, onEvent);
+        };
+    }, [eventEmitter]);
+    useEffect(() => {
+        updateAction(actionId.current, props.state, props.title, props.icon);
+    }, [props.title, props.icon, props.state, updateAction]);
+    return null; // declarative action
+};

package/lib/components/AppleTvPlayerControls.ios.d.ts

@@ -0,0 +1,52 @@
+import React, { ReactNode } from 'react';
+import { AppleTvTransportBarActionProps } from './AppleTvTransportBarAction.ios';
+import { AppleTvInfoBarActionProps } from './AppleTvInfoBarAction.ios';
+import { BaseEventEmitter } from '@castlabs/react-native-prestoplay';
+import { AppleTvContextualActionProps } from './AppleTvContextualAction.ios';
+import { ActionType } from '../types/ActionType';
+import { PopupMenuInternal } from '../types/PopupMenuInternal';
+/**
+ * AppleTvInfoBarActionProps defines the properties for an
+ * {@link AppleTvPlayerControls}.
+ *
+ * Its children can be any of the following components:
+ * - {@link AppleTvTransportBarAction}
+ * - {@link AppleTvInfoBarAction}
+ * - {@link AppleTvContextualAction}
+ * - {@link AppleTvTransportBarPopupMenu}
+ *
+ * @group Type Aliases
+ */
+export type AppleTvPlayerControlsProps = {
+    children: ReactNode;
+};
+type AppleTvPlayerControlsContextType = {
+    eventEmitter: BaseEventEmitter;
+    updateAction: (actionId: string, state: boolean, title: string, icon: string) => void;
+    addAction: (type: ActionType, actionId: string, props: AppleTvTransportBarActionProps | AppleTvInfoBarActionProps | AppleTvContextualActionProps) => void;
+    removeAction: (type: ActionType, actionId: string) => void;
+    setPopupMenu: (menuId: string, popUpMenu: PopupMenuInternal) => void;
+    removePopupMenu: (menuId: string) => void;
+};
+export declare const AppleTvPlayerControlsContext: React.Context<AppleTvPlayerControlsContextType>;
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * Use the tvOS player UI to present custom controls in an
+ * {@link AVPlayerViewControllerProvider} by including this component as a child.
+ *
+ * This component serves as a **provider** for its child components, enabling
+ * integration of custom actions and menus within the tvOS player interface.
+ *
+ * Supported child components include:
+ * - {@link AppleTvTransportBarAction}
+ * - {@link AppleTvInfoBarAction}
+ * - {@link AppleTvContextualAction}
+ * - {@link AppleTvTransportBarPopupMenu}
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience | Customizing the tvOS Playback Experience}.
+ *
+ * @group Components
+ */
+declare const AppleTvPlayerControls: React.FC<AppleTvPlayerControlsProps>;
+export default AppleTvPlayerControls;

package/lib/components/AppleTvPlayerControls.ios.js

@@ -0,0 +1,60 @@
+import React, { createContext } from 'react';
+import { BaseEventEmitter, usePlayer } from '@castlabs/react-native-prestoplay';
+import { AVPlayerViewControllerExtension } from '../AVPlayerViewControllerExtension';
+export const AppleTvPlayerControlsContext = createContext({
+    eventEmitter: new BaseEventEmitter(),
+    updateAction: (_actionId, _state, _title, _icon) => { },
+    addAction: () => { },
+    removeAction: () => { },
+    setPopupMenu: () => { },
+    removePopupMenu: () => { },
+});
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * Use the tvOS player UI to present custom controls in an
+ * {@link AVPlayerViewControllerProvider} by including this component as a child.
+ *
+ * This component serves as a **provider** for its child components, enabling
+ * integration of custom actions and menus within the tvOS player interface.
+ *
+ * Supported child components include:
+ * - {@link AppleTvTransportBarAction}
+ * - {@link AppleTvInfoBarAction}
+ * - {@link AppleTvContextualAction}
+ * - {@link AppleTvTransportBarPopupMenu}
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience | Customizing the tvOS Playback Experience}.
+ *
+ * @group Components
+ */
+const AppleTvPlayerControls = React.memo(({ children }) => {
+    const player = usePlayer();
+    const avPlayerExtension = player.getExtension(AVPlayerViewControllerExtension);
+    const addAction = (type, actionId, props) => {
+        avPlayerExtension.addAction(type, actionId, props);
+    };
+    const removeAction = (type, actionId) => {
+        avPlayerExtension.removeAction(type, actionId);
+    };
+    const updateAction = (actionId, state, title, icon) => {
+        avPlayerExtension.updateAction(actionId, state, title, icon);
+    };
+    const setPopupMenu = (menuId, popUpMenu) => {
+        avPlayerExtension.setPopupMenu(menuId, popUpMenu);
+    };
+    const removePopupMenu = (menuId) => {
+        avPlayerExtension.removePopupMenu(menuId);
+    };
+    return (<AppleTvPlayerControlsContext.Provider value={{
+            eventEmitter: avPlayerExtension.eventEmitter,
+            updateAction,
+            addAction,
+            removeAction,
+            setPopupMenu: setPopupMenu,
+            removePopupMenu,
+        }}>
+        {children}
+      </AppleTvPlayerControlsContext.Provider>);
+});
+export default AppleTvPlayerControls;

package/lib/components/AppleTvTransportBarAction.ios.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+/**
+ * AppleTvTransportBarActionProps defines the properties for an
+ * {@link AppleTvTransportBarAction}
+ *
+ * @group Type Aliases
+ */
+export type AppleTvTransportBarActionProps = {
+    /** The text of the transport bar action button. */
+    title: string;
+    /** The name of the image resource in the Xcode app project. */
+    icon: string;
+    /** The state of the info bar action button. */
+    state: boolean;
+    /**
+     * Action to be executed when the button is pressed.
+     *
+     * @param value - The action state string passed to the handler.
+     */
+    onPress: (value: string) => void;
+};
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * Displays custom controls in the transport bar of the tvOS player UI.
+ *
+ * If it is a children of an {@link AppleTvTransportBarPopupMenu}, the action is shown
+ * inside the popup menu. Otherwise, it is shown directly in the transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export declare const AppleTvTransportBarAction: React.FC<AppleTvTransportBarActionProps>;

package/lib/components/AppleTvTransportBarAction.ios.js

@@ -0,0 +1,47 @@
+import { useContext, useEffect, useRef } from 'react';
+import { AppleTvPlayerControlsContext } from './AppleTvPlayerControls.ios';
+import { ActionType } from '../types/ActionType';
+import uuid from 'uuid-random';
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * Displays custom controls in the transport bar of the tvOS player UI.
+ *
+ * If it is a children of an {@link AppleTvTransportBarPopupMenu}, the action is shown
+ * inside the popup menu. Otherwise, it is shown directly in the transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export const AppleTvTransportBarAction = props => {
+    const { eventEmitter: eventEmitter, updateAction, addAction, removeAction, } = useContext(AppleTvPlayerControlsContext);
+    const actionId = useRef(uuid());
+    useEffect(() => {
+        const _actionId = actionId.current;
+        addAction(ActionType.TransportBar, _actionId, props);
+        return () => {
+            removeAction(ActionType.TransportBar, _actionId);
+        };
+    });
+    const onPressRef = useRef(props.onPress);
+    useEffect(() => {
+        onPressRef.current = props.onPress;
+    }, [props.onPress]);
+    useEffect(() => {
+        const _actionId = actionId.current;
+        const onEvent = (event) => {
+            const details = event.details;
+            onPressRef.current(details.data);
+        };
+        eventEmitter.addEventListener(_actionId, onEvent);
+        return () => {
+            eventEmitter.removeEventListener(_actionId, onEvent);
+        };
+    }, [eventEmitter]);
+    useEffect(() => {
+        const _actionId = actionId.current;
+        updateAction(_actionId, props.state, props.title, props.icon);
+    }, [props.title, props.icon, props.state, updateAction]);
+    return null;
+};

package/lib/components/AppleTvTransportBarPopupMenu.ios.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import { ReactNode } from 'react';
+import SubMenu from '../types/SubMenu';
+type AppleTvTransportBarPopupMenuContextType = {
+    addSubMenu: (ids: string, subMenu: SubMenu) => void;
+    removeSubmenu: (id: string) => void;
+};
+export declare const AppleTvTransportBarPopupMenuContext: React.Context<AppleTvTransportBarPopupMenuContextType>;
+/**
+ * AppleTvTransportBarPopupMenuProps defines the properties for an
+ * {@link AppleTvTransportBarPopupMenu}.
+ *
+ * Its children can be any of the following components:
+ * - {@link AppleTvTransportBarAction}
+ * - {@link AppleTvTransportBarSubMenu}
+ *
+ * @group Type Aliases
+ */
+export type AppleTvTransportBarPopupMenuProps = {
+    /** The popup menu title. */
+    title: string;
+    /** The name of the image resource in the Xcode app.*/
+    icon: string;
+    /** The popup menu children, which can be {@link AppleTvTransportBarAction}
+     * or {@link AppleTvTransportBarSubMenu} components.
+     */
+    children: ReactNode;
+};
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * The AppleTvTransportBarPopupMenu component allows grouping multiple
+ * {@link AppleTvTransportBarAction} and {@link AppleTvTransportBarSubMenu}
+ * into a popup menu displayed in the tvOS player UI transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export declare const AppleTvTransportBarPopupMenu: React.FC<AppleTvTransportBarPopupMenuProps>;
+export {};

package/lib/components/AppleTvTransportBarPopupMenu.ios.js

@@ -0,0 +1,81 @@
+import React, { createContext, useCallback, useContext, useEffect, useRef, } from 'react';
+import { AppleTvPlayerControlsContext } from './AppleTvPlayerControls.ios';
+import { ActionType } from '../types/ActionType';
+import uuid from 'uuid-random';
+export const AppleTvTransportBarPopupMenuContext = createContext({
+    addSubMenu: () => { },
+    removeSubmenu: () => { },
+});
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * The AppleTvTransportBarPopupMenu component allows grouping multiple
+ * {@link AppleTvTransportBarAction} and {@link AppleTvTransportBarSubMenu}
+ * into a popup menu displayed in the tvOS player UI transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export const AppleTvTransportBarPopupMenu = React.memo(props => {
+    const { eventEmitter: eventEmitter, updateAction, setPopupMenu: setPopupMenu, removePopupMenu, } = useContext(AppleTvPlayerControlsContext);
+    const menuId = useRef(uuid());
+    const transportBarActions = useRef(new Map());
+    const subMenus = useRef(new Map());
+    const update = useCallback(() => {
+        const popupMenu = {
+            title: props.title,
+            icon: props.icon,
+            transportBarActions: Array.from(transportBarActions.current.entries()).map(([id, value]) => ({
+                ...value,
+                id, // add the map key as a property
+            })),
+            subMenus: Array.from(subMenus.current.entries()).map(([id, value]) => ({
+                ...value,
+                id, // add the map key as a property
+            })),
+        };
+        setPopupMenu(menuId.current, popupMenu);
+    }, [props.icon, props.title, setPopupMenu]);
+    useEffect(() => {
+        const _menuId = menuId.current;
+        return () => {
+            removePopupMenu(_menuId);
+        };
+    }, [removePopupMenu]);
+    useEffect(() => {
+        update();
+    }, [props.title, props.icon, update]);
+    const addActionInternal = (type, actionId, actionProps) => {
+        if (type === ActionType.TransportBar) {
+            const transportAction = actionProps;
+            transportBarActions.current.set(actionId, transportAction);
+        }
+    };
+    const removeActionInternal = (type, actionId) => {
+        transportBarActions.current.delete(actionId);
+    };
+    const addSubMenu = (subMenuId, subMenu) => {
+        subMenus.current.set(subMenuId, subMenu);
+        update();
+    };
+    const removeSubmenu = (subMenuId) => {
+        subMenus.current.delete(subMenuId);
+        update();
+    };
+    return (<AppleTvPlayerControlsContext.Provider value={{
+            eventEmitter: eventEmitter,
+            updateAction,
+            addAction: addActionInternal,
+            removeAction: removeActionInternal,
+            setPopupMenu: () => { },
+            removePopupMenu: () => { },
+        }}>
+        <AppleTvTransportBarPopupMenuContext.Provider value={{
+            addSubMenu,
+            removeSubmenu,
+        }}>
+          {props.children}
+        </AppleTvTransportBarPopupMenuContext.Provider>
+      </AppleTvPlayerControlsContext.Provider>);
+});

package/lib/components/AppleTvTransportBarSubMenu.ios.d.ts

@@ -0,0 +1,41 @@
+import React, { ReactNode } from 'react';
+type AppleTvTransportBarSubMenuContextType = {
+    addMenuItem: (title: string, value: string) => void;
+    removeMenuItem: (title: string) => void;
+};
+export declare const AppleTvTransportBarSubMenuContext: React.Context<AppleTvTransportBarSubMenuContextType>;
+/**
+ * Type definition for the properties of an {@link AppleTvTransportBarSubMenu}
+ * component.
+ *
+ * @group Type Aliases
+ */
+export type AppleTvTransportBarSubMenuProps = {
+    /** The submenu title. */
+    title: string;
+    /** The name of the image resource in the Xcode app.*/
+    icon: string;
+    /** The default value selected of the submenu. */
+    defaultValue: string;
+    /** The submenu children, which can be {@link AppleTvTransportBarSubMenuItem} components. */
+    children: ReactNode;
+    /**
+     * The action to be executed when a submenu item is selected.
+     * @param value - The value of the selected submenu item.
+     * @returns
+     */
+    onPress: (value: string) => void;
+};
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * The AppleTvTransportBarSubMenu component allows grouping multiple
+ * {@link AppleTvTransportBarSubMenuItem} components into a submenu displayed
+ * in a popup menu in the tvOS player UI transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export declare const AppleTvTransportBarSubMenu: React.FC<AppleTvTransportBarSubMenuProps>;
+export {};

package/lib/components/AppleTvTransportBarSubMenu.ios.js

@@ -0,0 +1,70 @@
+import React, { createContext, useCallback, useContext, useEffect, useRef, } from 'react';
+import { AppleTvPlayerControlsContext } from './AppleTvPlayerControls.ios';
+import { AppleTvTransportBarPopupMenuContext } from './AppleTvTransportBarPopupMenu.ios';
+import uuid from 'uuid-random';
+export const AppleTvTransportBarSubMenuContext = createContext({
+    addMenuItem: () => { },
+    removeMenuItem: () => { },
+});
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * The AppleTvTransportBarSubMenu component allows grouping multiple
+ * {@link AppleTvTransportBarSubMenuItem} components into a submenu displayed
+ * in a popup menu in the tvOS player UI transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export const AppleTvTransportBarSubMenu = props => {
+    const { eventEmitter } = useContext(AppleTvPlayerControlsContext);
+    const { addSubMenu, removeSubmenu } = useContext(AppleTvTransportBarPopupMenuContext);
+    const subMenuId = useRef(uuid());
+    const subMenuItems = useRef(new Map());
+    const update = useCallback(() => {
+        addSubMenu(subMenuId.current, {
+            id: subMenuId.current,
+            title: props.title,
+            defaultValue: props.defaultValue,
+            menuItems: Array.from(subMenuItems.current.entries()).map(([title, value]) => ({ value, title })),
+        });
+    }, [addSubMenu, props.title, props.defaultValue]);
+    useEffect(() => {
+        const _subMenuId = subMenuId.current;
+        return () => {
+            if (_subMenuId !== null) {
+                removeSubmenu(_subMenuId);
+            }
+        };
+    }, [removeSubmenu]);
+    const onPressRef = useRef(props.onPress);
+    useEffect(() => {
+        onPressRef.current = props.onPress;
+    }, [props.onPress]);
+    useEffect(() => {
+        const _subMenuId = subMenuId.current;
+        const onEvent = (event) => {
+            const details = event.details;
+            onPressRef.current(details.data);
+        };
+        eventEmitter.addEventListener(_subMenuId, onEvent);
+        return () => {
+            eventEmitter.removeEventListener(_subMenuId, onEvent);
+        };
+    }, [eventEmitter]);
+    useEffect(() => {
+        update();
+    }, [props.title, props.icon, props.defaultValue, update]);
+    const addMenuItem = (title, value) => {
+        subMenuItems.current.set(title, value);
+        update();
+    };
+    const removeMenuItem = (title) => {
+        subMenuItems.current.delete(title);
+        update();
+    };
+    return (<AppleTvTransportBarSubMenuContext.Provider value={{ addMenuItem, removeMenuItem }}>
+      {props.children}
+    </AppleTvTransportBarSubMenuContext.Provider>);
+};

package/lib/components/AppleTvTransportBarSubMenuItem.ios.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="react" />
+/**
+ * The properties for an {@link AppleTvTransportBarSubMenuItem} component.
+ *
+ * @group Type Aliases
+ */
+export type AppleTvTransportBarSubMenuItemProps = {
+    /** The text of the submenu item. */
+    title: string;
+    /** The value of the submenu item. */
+    value: string;
+};
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * The AppleTvTransportBarSubMenuItem component represents an item inside
+ * an {@link AppleTvTransportBarSubMenu} submenu displayed in a popup menu
+ * in the tvOS player UI transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export declare const AppleTvTransportBarSubMenuItem: React.FC<AppleTvTransportBarSubMenuItemProps>;

package/lib/components/AppleTvTransportBarSubMenuItem.ios.js

@@ -0,0 +1,23 @@
+import { useContext, useEffect } from 'react';
+import { AppleTvTransportBarSubMenuContext } from './AppleTvTransportBarSubMenu.ios';
+/**
+ * **⚠️ This component is only supported on tvOS.**
+ *
+ * The AppleTvTransportBarSubMenuItem component represents an item inside
+ * an {@link AppleTvTransportBarSubMenu} submenu displayed in a popup menu
+ * in the tvOS player UI transport bar.
+ *
+ * For more details, see Apple documentation: {@link https://developer.apple.com/documentation/avkit/customizing-the-tvos-playback-experience#Add-Custom-Transport-Bar-Items | Add Custom Transport Bar Items}.
+ *
+ * @group Components
+ */
+export const AppleTvTransportBarSubMenuItem = props => {
+    const { addMenuItem, removeMenuItem } = useContext(AppleTvTransportBarSubMenuContext);
+    useEffect(() => {
+        addMenuItem(props.title, props.value);
+        return () => {
+            removeMenuItem(props.title);
+        };
+    }, [props.title, props.value, addMenuItem, removeMenuItem]);
+    return null;
+};

package/lib/events/AppleTvActionDetails.d.ts

@@ -0,0 +1,7 @@
+import { EventDetails } from '@castlabs/react-native-prestoplay';
+/** @group Interfaces */
+export default interface AppleTvActionDetails extends EventDetails {
+    actionId: string;
+    eventName: string;
+    data: string;
+}

package/lib/events/AppleTvActionDetails.js

@@ -0,0 +1 @@
+export {};

package/lib/events/EventType.d.ts

@@ -0,0 +1,7 @@
+/** @group Enums */
+declare enum EventType {
+    /** @hidden */
+    AppleTvAction = "appleTvAction"
+}
+export { EventType };
+export default EventType;

package/lib/events/EventType.js

@@ -0,0 +1,8 @@
+/** @group Enums */
+var EventType;
+(function (EventType) {
+    /** @hidden */
+    EventType["AppleTvAction"] = "appleTvAction";
+})(EventType || (EventType = {}));
+export { EventType };
+export default EventType;

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+export type { AVPlayerViewControllerProviderProps } from './components/AVPlayerViewControllerProvider.ios';
+export type { AppleTvTransportBarSubMenuItemProps } from './components/AppleTvTransportBarSubMenuItem.ios';
+export type { AppleTvContextualActionProps } from './components/AppleTvContextualAction.ios';
+export type { AppleTvInfoBarActionProps } from './components/AppleTvInfoBarAction.ios';
+export type { AppleTvTransportBarActionProps } from './components/AppleTvTransportBarAction.ios';
+export type { AppleTvTransportBarPopupMenuProps } from './components/AppleTvTransportBarPopupMenu.ios';
+export type { AppleTvTransportBarSubMenuProps } from './components/AppleTvTransportBarSubMenu.ios';
+export type { AppleTvPlayerControlsProps } from './components/AppleTvPlayerControls.ios';
+export { default as AVPlayerViewControllerPlugin } from './AVPlayerViewControllerPlugin';
+export { AVPlayerViewControllerProvider } from './components/AVPlayerViewControllerProvider.ios';
+export { default as AppleTvPlayerControls } from './components/AppleTvPlayerControls.ios';
+export { AppleTvTransportBarAction } from './components/AppleTvTransportBarAction.ios';
+export { AppleTvTransportBarPopupMenu } from './components/AppleTvTransportBarPopupMenu.ios';
+export { AppleTvTransportBarSubMenu } from './components/AppleTvTransportBarSubMenu.ios';
+export { AppleTvTransportBarSubMenuItem } from './components/AppleTvTransportBarSubMenuItem.ios';
+export { AppleTvInfoBarAction } from './components/AppleTvInfoBarAction.ios';
+export { AppleTvContextualAction } from './components/AppleTvContextualAction.ios';