@behindthemusictree/app-kit-ui 37.0.0 → 38.0.0

package/dist/genre-tree/index.d.ts

@@ -488,4 +488,56 @@ interface RatingProps {
 }
 declare function Rating({ rating, handleChange }: RatingProps): react.JSX.Element;
 
-export { type ArtistSearchProps, GenreDetailPanel, type GenreDetailPanelProps, type GenreDetailSlots, type GenreFocusProps, GenreInfoPanelBody, type GenreInfoPanelBodyProps, GenreNodeActionBand, type GenrePlaylistPlayback, type GenrePlaylistTracksSlots, GenrePlaylistTreePerRoot, type GenrePlaylistTreePerRootProps, GenreSearch, type GenreSearchExtraGroup, type GenreSearchGroupsProps, type GenreSearchProps, type GenreTreeShareTarget, GenreTreeView, type GenreTreeViewProps, type GetGenreTreeShareUrl, type ParentChange, type PlayableGenrePlaylist, PlayerPanel, type PlayerPanelProps, Rating, type RatingProps, SEARCH_FAILED_STATUS, SearchBox, type SearchBoxProps, type SearchGroup, type SearchGroupItem, TrackItem, type TrackItemProps, TrackListSidebar, type TrackListSidebarProps, TrackPositionPlayPause, type TrackPositionPlayPauseProps, type UseGenrePlaylistPlaybackOptions, type UseGenreRemoteSearchGroupOptions, searchStatus, useArtistSearchGroup, useGenrePlaylistPlayback, useGenreRemoteSearchGroup, useSongSearchGroup };
+/** How the song's genre is opened: through the loaded tree's playlists, or by the genre alone for a host without a tree. */
+type SongGenreNavigation = {
+    /** Root-to-leaf playlists of a genre in the loaded tree; empty when the tree doesn't hold it. */
+    getGenrePath: (genre: CriteriaMinimum) => CriteriaPlaylistSimple[];
+    onSelectGenrePlaylist: (genrePlaylist: CriteriaPlaylistSimple) => void;
+    onSelectGenre?: never;
+} | {
+    onSelectGenre: (genre: CriteriaMinimum) => void;
+    getGenrePath?: never;
+    onSelectGenrePlaylist?: never;
+};
+
+interface EntityPanelState {
+    uuid: string | null;
+    expanded: boolean;
+    onExpandedChange: (expanded: boolean) => void;
+    onClose: () => void;
+}
+type EntityPanelOptions = {
+    scope: Scope;
+    getBackendBaseUrl: () => string;
+    /** Artist requests go here when the host serves them from elsewhere; defaults to `getBackendBaseUrl`. */
+    getArtistBackendBaseUrl?: () => string;
+    getShareUrl?: GetGenreTreeShareUrl;
+    renderArtistLink: RenderArtistLink;
+    renderSongLink: RenderSongLink;
+    song: EntityPanelState;
+    artist: EntityPanelState;
+} & SongGenreNavigation;
+/** The song or artist detail overlay panel; a song takes precedence over an artist, undefined when neither is set. */
+declare function useEntityPanel({ scope, getBackendBaseUrl, getArtistBackendBaseUrl, getShareUrl, renderArtistLink, renderSongLink, song, artist, ...navigation }: EntityPanelOptions): OverlayPanel | undefined;
+
+type EntityDetailPanelProps = {
+    scope: Scope;
+    getBackendBaseUrl: () => string;
+    getArtistBackendBaseUrl?: () => string;
+    getShareUrl?: GetGenreTreeShareUrl;
+    songUuid: string | null;
+    onSongUuidChange: (uuid: string | null) => void;
+    artistUuid: string | null;
+    onArtistUuidChange: (uuid: string | null) => void;
+    /** Names render as buttons that open the artist by default. */
+    renderArtistLink?: RenderArtistLink;
+    /** Titles render as buttons that open the song by default. */
+    renderSongLink?: RenderSongLink;
+    collapsed?: boolean;
+    edgeTab?: ComponentProps<typeof DetailPanel>["edgeTab"];
+} & SongGenreNavigation;
+/** The song or artist detail in the shared left DetailPanel, for a host that has no genre tree. Renders nothing
+ * while neither is set; a song takes precedence over an artist. */
+declare function EntityDetailPanel({ scope, getBackendBaseUrl, getArtistBackendBaseUrl, getShareUrl, songUuid, onSongUuidChange, artistUuid, onArtistUuidChange, renderArtistLink, renderSongLink, collapsed, edgeTab, ...navigation }: EntityDetailPanelProps): react.JSX.Element | null;
+
+export { type ArtistSearchProps, EntityDetailPanel, type EntityDetailPanelProps, type EntityPanelOptions, type EntityPanelState, GenreDetailPanel, type GenreDetailPanelProps, type GenreDetailSlots, type GenreFocusProps, GenreInfoPanelBody, type GenreInfoPanelBodyProps, GenreNodeActionBand, type GenrePlaylistPlayback, type GenrePlaylistTracksSlots, GenrePlaylistTreePerRoot, type GenrePlaylistTreePerRootProps, GenreSearch, type GenreSearchExtraGroup, type GenreSearchGroupsProps, type GenreSearchProps, type GenreTreeShareTarget, GenreTreeView, type GenreTreeViewProps, type GetGenreTreeShareUrl, type ParentChange, type PlayableGenrePlaylist, PlayerPanel, type PlayerPanelProps, Rating, type RatingProps, SEARCH_FAILED_STATUS, SearchBox, type SearchBoxProps, type SearchGroup, type SearchGroupItem, type SongGenreNavigation, TrackItem, type TrackItemProps, TrackListSidebar, type TrackListSidebarProps, TrackPositionPlayPause, type TrackPositionPlayPauseProps, type UseGenrePlaylistPlaybackOptions, type UseGenreRemoteSearchGroupOptions, searchStatus, useArtistSearchGroup, useEntityPanel, useGenrePlaylistPlayback, useGenreRemoteSearchGroup, useSongSearchGroup };

package/dist/genre-tree/index.js

@@ -1,4 +1,5 @@
 import {
+  EntityDetailPanel,
   GenreDetailPanel,
   GenreInfoPanelBody,
   GenreNodeActionBand,
@@ -18,12 +19,14 @@ import {
   TrackPositionPlayPause,
   searchStatus,
   useArtistSearchGroup,
+  useEntityPanel,
   useGenrePlaylistPlayback,
   useGenreRemoteSearchGroup,
   useSongSearchGroup
-} from "../chunk-FTYMRCJS.js";
-import "../chunk-DKQQLLMY.js";
+} from "../chunk-F7H5XPWU.js";
+import "../chunk-2GH7CSCE.js";
 export {
+  EntityDetailPanel,
   GenreDetailPanel,
   GenreInfoPanelBody,
   GenreNodeActionBand,
@@ -43,6 +46,7 @@ export {
   TrackPositionPlayPause,
   searchStatus,
   useArtistSearchGroup,
+  useEntityPanel,
   useGenrePlaylistPlayback,
   useGenreRemoteSearchGroup,
   useSongSearchGroup