@behindthemusictree/app-kit-ui 38.0.0 → 40.0.0

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

@@ -43,9 +43,10 @@ type GenreDetailExtrasProps<O extends CriteriaOverview> = GenreDetailSlots<O> &
     family: ReactNode;
 };
 
-/** An artist or song detail the host renders in the shared DetailPanel in place of a genre's. */
+/** A detail panel shown in the shared DetailPanel in place of a genre's: an artist, a song or a host page. */
 interface OverlayPanel {
-    title: ReactNode;
+    /** Plain text, like a genre's name: it fills the search field, whose clear button closes the panel. */
+    title: string;
     content: ReactNode;
     /** Second column, shown only while expanded. */
     extraContent?: ReactNode;
@@ -65,9 +66,18 @@ type HostPanelProps = Partial<Pick<GenreTreeProps, "obscuredInset" | "onNodeStyl
 type PlayableGenrePlaylistInput = CriteriaPlaylistMinimum & {
     criteria?: CriteriaPlaylistSimple["criteria"];
 };
+/** The playlist loaded in the player; `selectionKey` is `genreMusicSelectionKey(selection).join()`, empty without a selection. */
+type PlayingGenrePlaylist = {
+    uuid: string;
+    selectionKey: string;
+};
 type GenrePlaylistPlayback = {
-    playingNodeId: string | null;
-    play: (genrePlaylist: PlayableGenrePlaylistInput) => Promise<void>;
+    playing: PlayingGenrePlaylist | null;
+    /**
+     * Plays `genrePlaylist`; `selection` overrides the default coverage of a reference genre. Never rejects: connectivity
+     * errors reach the global popup through the backend request layer, any other failure is shown here with its real code.
+     */
+    play: (genrePlaylist: PlayableGenrePlaylistInput, selection?: GenreMusicSelection) => Promise<void>;
 };
 type UseGenrePlaylistPlaybackOptions = {
     scope: Scope;
@@ -316,7 +326,8 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     /** Controlled expanded state of the genre panel. Uncontrolled when omitted. */
     expanded?: boolean;
     onExpandedChange?: (expanded: boolean) => void;
-    /** A host panel rendered in the detail panel's slot; it takes precedence over the genre, song and artist panels. */
+    /** A host panel rendered in the detail panel's slot; it takes precedence over the genre, song and artist panels.
+     * Like theirs, its title fills the search field, whose clear button closes it. */
     overlayPanel?: HostOverlayPanel;
     /** Hides the info panel behind its edge tab; uncontrolled when omitted. Only applies with `placement="regions"`. */
     collapsed?: boolean;
@@ -326,9 +337,8 @@ declare function GenreTreeView<O extends CriteriaOverview = CriteriaOverview>({
 
 type GenreActionBandProps = {
     node: GenreTreeNode;
-    /** When set, shows the Play/Pause action. */
-    onPlayPause?: () => void;
-    isPlaying?: boolean;
+    /** Play buttons, shown first. */
+    playActions?: ReactNode;
     /** When set, shows the "Zoom in" action. */
     onZoomIn?: () => void;
     /** When set, shows the "Add" (sub-genre) action. */
@@ -346,7 +356,7 @@ type GenreActionBandProps = {
     shareTarget?: GenreTreeShareTarget;
     shareUrl?: string;
 };
-declare function GenreActionBand({ node, onPlayPause, isPlaying, onZoomIn, onAddChild, onRename, onChangeParent, side, onToggleSide, toggleSideDisabledReason, additionalActions, shareTarget, shareUrl, }: GenreActionBandProps): react.JSX.Element | null;
+declare function GenreActionBand({ node, playActions, onZoomIn, onAddChild, onRename, onChangeParent, side, onToggleSide, toggleSideDisabledReason, additionalActions, shareTarget, shareUrl, }: GenreActionBandProps): react.JSX.Element | null;
 
 /** What the action band reads of a genre's playlist: enough to play it and to know whether it can be. */
 type PlayableGenrePlaylist = ((CriteriaPlaylistMinimum & {
@@ -354,7 +364,7 @@ type PlayableGenrePlaylist = ((CriteriaPlaylistMinimum & {
 }) | GenrePlaylistSummary) & {
     criteria?: CriteriaMinimum | null;
 };
-type GenreNodeActionBandProps = Omit<ComponentProps<typeof GenreActionBand>, "onPlayPause" | "isPlaying"> & {
+type GenreNodeActionBandProps = Omit<ComponentProps<typeof GenreActionBand>, "playActions"> & {
     genrePlaylist: PlayableGenrePlaylist;
     playback: GenrePlaylistPlayback;
 };
@@ -365,7 +375,6 @@ type GenreInfoPanelBodyProps<O extends CriteriaOverview> = {
     family: ReactNode;
     genreUuid: GenreUuid;
     catalogue?: GenreCatalogueCounts;
-    countsContext?: string;
     genrePlaylist: PlayableGenrePlaylist | null;
     wikidataId?: string | null;
     scope: Scope;
@@ -377,7 +386,7 @@ type GenreInfoPanelBodyProps<O extends CriteriaOverview> = {
 };
 /** The body of a genre's info panel: action band, then the genre's overview, family and tracks.
  * Shared by the tree's panel and the standalone GenreDetailPanel. */
-declare function GenreInfoPanelBody<O extends CriteriaOverview>({ toolbar, family, genreUuid, genrePlaylist, catalogue, countsContext, wikidataId, scope, getBackendBaseUrl, playback, band, extras, }: GenreInfoPanelBodyProps<O>): react.JSX.Element;
+declare function GenreInfoPanelBody<O extends CriteriaOverview>({ toolbar, family, genreUuid, genrePlaylist, catalogue, wikidataId, scope, getBackendBaseUrl, playback, band, extras, }: GenreInfoPanelBodyProps<O>): react.JSX.Element;
 
 type GenreDetailPanelProps<O extends CriteriaOverview> = {
     genreUuid: GenreUuid;
@@ -427,8 +436,10 @@ type GenrePlaylistTreePerRootProps<T extends TrackBase> = {
     onViewportChange?: (viewport: GenreTreeViewport) => void;
     /** What node play buttons play; defaults to each node's whole genre playlist. */
     playback?: GenrePlaylistPlayback;
+    /** The open artist's footprint; nodes outside it are drawn muted. */
+    focusUuids?: ReadonlySet<string>;
 } & HostPanelProps;
-declare function GenrePlaylistTreePerRoot<T extends TrackBase>({ scope, className, rootUuid, genrePlaylistTreePerRoot, handleGenreCreationAction, handleGenreRenameAction, additionalActions, onNodeClick, onNodeHover, selectedNodeId, onSelectedNodeChange, readOnly, wheelZoom, defaultViewport, viewportRestore, onViewportChange, playback, ...hostPanel }: GenrePlaylistTreePerRootProps<T>): react.JSX.Element;
+declare function GenrePlaylistTreePerRoot<T extends TrackBase>({ scope, className, rootUuid, genrePlaylistTreePerRoot, handleGenreCreationAction, handleGenreRenameAction, additionalActions, onNodeClick, onNodeHover, selectedNodeId, onSelectedNodeChange, readOnly, wheelZoom, defaultViewport, viewportRestore, onViewportChange, playback, focusUuids, ...hostPanel }: GenrePlaylistTreePerRootProps<T>): react.JSX.Element;
 
 interface TrackListSidebarProps<T extends TrackBase> {
     className?: string;

package/dist/genre-tree/index.js

@@ -23,7 +23,7 @@ import {
   useGenrePlaylistPlayback,
   useGenreRemoteSearchGroup,
   useSongSearchGroup
-} from "../chunk-F7H5XPWU.js";
+} from "../chunk-I2TEOHVG.js";
 import "../chunk-2GH7CSCE.js";
 export {
   EntityDetailPanel,