webamp 0.0.0-next-c1d68b5 → 0.0.0-next-a618b04

package/built/types/js/components/App.d.ts

@@ -4,9 +4,11 @@ import { IMedia } from "../media";
 interface Props {
     filePickers: FilePicker[];
     media: IMedia;
+    parentDomNode: HTMLElement;
+    onMount?: () => void;
 }
 /**
  * Constructs the windows to render
  */
-export default function App({ media, filePickers }: Props): import("react").ReactPortal | null;
+export default function App({ media, filePickers, onMount, parentDomNode, }: Props): import("react").ReactPortal | null;
 export {};

package/built/types/js/webampLazy.d.ts

@@ -30,35 +30,35 @@ declare class Webamp {
     static browserIsSupported(): boolean;
     constructor(options: Options & PrivateOptions & InjectableDependencies);
     /**
-     * Play the current tack
+     * Play the current track.
      */
     play(): void;
     /**
-     * Pause the current tack
+     * Pause the current track.
      */
     pause(): void;
     /**
-     * Stop the currently playing audio. Equivalent to pressing the "stop" button
+     * Stop the currently playing audio. Equivalent to pressing the "stop" button.
      */
     stop(): void;
     /**
-     * Set volume from 0 - 100
+     * Set volume from 0 - 100.
      */
     setVolume(volume: number): void;
     /**
-     * Seek backward n seconds in the current track
+     * Seek backward n seconds in the current track.
      */
     seekBackward(seconds: number): void;
     /**
-     * Seek forward n seconds in the current track
+     * Seek forward n seconds in the current track.
      */
     seekForward(seconds: number): void;
     /**
-     * Seek to a given time within the current track
+     * Seek to a given time within the current track.
      */
     seekToTime(seconds: number): void;
     /**
-     * Check if shuffle is enabled
+     * Check if shuffle is enabled.
      */
     isShuffleEnabled(): boolean;
     /**
@@ -66,7 +66,7 @@ declare class Webamp {
      */
     toggleShuffle(): void;
     /**
-     * Check if repeat is enabled
+     * Check if repeat is enabled.
      */
     isRepeatEnabled(): boolean;
     /**
@@ -74,15 +74,15 @@ declare class Webamp {
      */
     toggleRepeat(): void;
     /**
-     * Play the next track
+     * Play the next track.
      */
     nextTrack(): void;
     /**
-     * Play the previous track
+     * Play the previous track.
      */
     previousTrack(): void;
     /**
-     * Set the current track a specific track in the playlist by zero-based index.
+     * Set the current track to a specific track in the playlist by zero-based index.
      *
      * Note: If Webamp is currently playing, the track will begin playing. If
      * Webamp is not playing, the track will not start playing. You can use
@@ -121,7 +121,7 @@ declare class Webamp {
      */
     onClose(cb: () => void): () => void;
     /**
-     * Equivalent to selection "Close" from Webamp's options menu. Once closed,
+     * Equivalent to selecting "Close" from Webamp's options menu. Once closed,
      * you can open it again with `.reopen()`.
      */
     close(): void;

package/built/webamp.bundle.js

@@ -43304,7 +43304,7 @@
 	/**
 	 * Constructs the windows to render
 	 */
-	function App({ media, filePickers }) {
+	function App({ media, filePickers, onMount, parentDomNode, }) {
 	    const closed = useTypedSelector(getClosed);
 	    const genWindowsInfo = useTypedSelector(getGenWindows);
 	    const zIndex = useTypedSelector(getZIndex);
@@ -43321,11 +43321,11 @@
 	        webampNode.style.zIndex = String(zIndex);
 	    }, [webampNode, zIndex]);
 	    reactExports.useLayoutEffect(() => {
-	        document.body.appendChild(webampNode);
+	        parentDomNode.appendChild(webampNode);
 	        return () => {
-	            document.body.removeChild(webampNode);
+	            parentDomNode.removeChild(webampNode);
 	        };
-	    }, [webampNode]);
+	    }, [webampNode, parentDomNode]);
 	    reactExports.useEffect(() => {
 	        const handleWindowResize = () => {
 	            if (webampNode == null) {
@@ -43353,6 +43353,11 @@
 	            window.removeEventListener("resize", handleWindowResize);
 	        };
 	    }, [browserWindowSizeChanged$1, webampNode]);
+	    reactExports.useEffect(() => {
+	        if (onMount != null) {
+	            onMount();
+	        }
+	    }, [onMount]);
 	    const renderWindows = reactExports.useCallback(() => {
 	        return objectMap(genWindowsInfo, (w, id) => {
 	            if (!w.open) {
@@ -44069,10 +44074,7 @@
 	        this._actionEmitter = new Emitter();
 	        this.options = options;
 	        const { initialTracks, initialSkin, availableSkins, enableHotkeys = false, zIndex, requireJSZip, requireMusicMetadata, handleTrackDropEvent, handleAddUrlEvent, handleLoadListEvent, handleSaveListEvent, enableDoubleSizeMode, __butterchurnOptions, __customMediaClass, } = this.options;
-	        if (options.enableMediaSession) {
-	            enableMediaSession(this);
-	        }
-	        // TODO: Make this much cleaner
+	        // TODO: Make this much cleaner.
 	        let convertPreset = null;
 	        if (__butterchurnOptions != null) {
 	            const { importConvertPreset, presetConverterEndpoint } = __butterchurnOptions;
@@ -44083,18 +44085,21 @@
 	                };
 	            }
 	        }
-	        // TODO: Validate required options
+	        // TODO: Validate required options.
 	        this.media = new (__customMediaClass || Media)();
 	        this.store = createWebampStore(this.media, this._actionEmitter, this.options.__customMiddlewares, this.options.__initialState, {
 	            requireJSZip,
 	            requireMusicMetadata,
 	            convertPreset,
-	            // @ts-ignore Typescript is drunk
+	            // @ts-ignore Typescript is drunk.
 	            handleTrackDropEvent,
 	            handleAddUrlEvent,
 	            handleLoadListEvent,
 	            handleSaveListEvent,
 	        });
+	        if (options.enableMediaSession) {
+	            enableMediaSession(this);
+	        }
 	        if (enableDoubleSizeMode) {
 	            this.store.dispatch(toggleDoubleSizeMode());
 	        }
@@ -44147,49 +44152,49 @@
 	        }
 	    }
 	    /**
-	     * Play the current tack
+	     * Play the current track.
 	     */
 	    play() {
 	        this.store.dispatch(play());
 	    }
 	    /**
-	     * Pause the current tack
+	     * Pause the current track.
 	     */
 	    pause() {
 	        this.store.dispatch(pause());
 	    }
 	    /**
-	     * Stop the currently playing audio. Equivalent to pressing the "stop" button
+	     * Stop the currently playing audio. Equivalent to pressing the "stop" button.
 	     */
 	    stop() {
 	        this.store.dispatch(stop());
 	    }
 	    /**
-	     * Set volume from 0 - 100
+	     * Set volume from 0 - 100.
 	     */
 	    setVolume(volume) {
 	        this.store.dispatch(setVolume(volume));
 	    }
 	    /**
-	     * Seek backward n seconds in the current track
+	     * Seek backward n seconds in the current track.
 	     */
 	    seekBackward(seconds) {
 	        this.store.dispatch(seekBackward(seconds));
 	    }
 	    /**
-	     * Seek forward n seconds in the current track
+	     * Seek forward n seconds in the current track.
 	     */
 	    seekForward(seconds) {
 	        this.store.dispatch(seekForward(seconds));
 	    }
 	    /**
-	     * Seek to a given time within the current track
+	     * Seek to a given time within the current track.
 	     */
 	    seekToTime(seconds) {
 	        this.store.dispatch(seekToTime(seconds));
 	    }
 	    /**
-	     * Check if shuffle is enabled
+	     * Check if shuffle is enabled.
 	     */
 	    isShuffleEnabled() {
 	        return getShuffle(this.store.getState());
@@ -44201,7 +44206,7 @@
 	        this.store.dispatch(toggleShuffle());
 	    }
 	    /**
-	     * Check if repeat is enabled
+	     * Check if repeat is enabled.
 	     */
 	    isRepeatEnabled() {
 	        return getRepeat(this.store.getState());
@@ -44213,19 +44218,19 @@
 	        this.store.dispatch(toggleRepeat());
 	    }
 	    /**
-	     * Play the next track
+	     * Play the next track.
 	     */
 	    nextTrack() {
 	        this.store.dispatch(next());
 	    }
 	    /**
-	     * Play the previous track
+	     * Play the previous track.
 	     */
 	    previousTrack() {
 	        this.store.dispatch(previous());
 	    }
 	    /**
-	     * Set the current track a specific track in the playlist by zero-based index.
+	     * Set the current track to a specific track in the playlist by zero-based index.
 	     *
 	     * Note: If Webamp is currently playing, the track will begin playing. If
 	     * Webamp is not playing, the track will not start playing. You can use
@@ -44281,7 +44286,7 @@
 	        return this._actionEmitter.on(CLOSE_WINAMP, cb);
 	    }
 	    /**
-	     * Equivalent to selection "Close" from Webamp's options menu. Once closed,
+	     * Equivalent to selecting "Close" from Webamp's options menu. Once closed,
 	     * you can open it again with `.reopen()`.
 	     */
 	    close() {
@@ -44308,7 +44313,7 @@
 	     */
 	    onTrackDidChange(cb) {
 	        let previousTrackId = null;
-	        // TODO #leak
+	        // TODO #leak.
 	        return this.store.subscribe(() => {
 	            const state = this.store.getState();
 	            const trackId = getCurrentlyPlayingTrackIdIfLoaded(state);
@@ -44344,7 +44349,7 @@
 	     */
 	    async skinIsLoaded() {
 	        // Wait for the skin to load.
-	        // TODO #leak
+	        // TODO #leak.
 	        await storeHas(this.store, (state) => !state.display.loading);
 	        // We attempt to pre-resolve these promises before we declare the skin
 	        // loaded. That's because `<EqGraph>` needs these in order to render fully.
@@ -44383,7 +44388,12 @@
 	                this._root = null;
 	            }
 	        });
-	        this._root.render(jsxRuntimeExports.jsx(Provider, { store: this.store, children: jsxRuntimeExports.jsx(App, { media: this.media, filePickers: this.options.filePickers || [] }) }));
+	        let onMount;
+	        const mountPromise = new Promise((resolve) => {
+	            onMount = resolve;
+	        });
+	        this._root.render(jsxRuntimeExports.jsx(Provider, { store: this.store, children: jsxRuntimeExports.jsx(App, { media: this.media, filePickers: this.options.filePickers || [], onMount: onMount, parentDomNode: document.body }) }));
+	        await mountPromise;
 	    }
 	    /**
 	     * **Note:** _This method is not fully functional. It is currently impossible to
@@ -44395,8 +44405,8 @@
 	     * attempt to clean itself up to avoid memory leaks.
 	     */
 	    dispose() {
-	        // TODO: Clean up store subscription in onTrackDidChange
-	        // TODO: Every storeHas call represents a potential race condition
+	        // TODO: Clean up store subscription in onTrackDidChange.
+	        // TODO: Every storeHas call represents a potential race condition.
 	        this.media.dispose();
 	        this._actionEmitter.dispose();
 	        this._disposable.dispose();
@@ -44408,7 +44418,7 @@
 	        return getSerlializedState(this.store.getState());
 	    }
 	    __onStateChange(cb) {
-	        // TODO #leak
+	        // TODO #leak.
 	        return this.store.subscribe(cb);
 	    }
 	    _bufferTracks(tracks) {
@@ -44417,7 +44427,7 @@
 	    }
 	};
 	// Return a promise that resolves when the store matches a predicate.
-	// TODO #leak
+	// TODO #leak.
 	const storeHas = (store, predicate) => new Promise((resolve) => {
 	    if (predicate(store.getState())) {
 	        resolve();