@behindthemusictree/app-kit-ui 39.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;
@@ -72,7 +73,10 @@ type PlayingGenrePlaylist = {
 };
 type GenrePlaylistPlayback = {
     playing: PlayingGenrePlaylist | null;
-    /** Plays `genrePlaylist`; `selection` overrides the default coverage of a reference genre. */
+    /**
+     * 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 = {
@@ -322,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;
@@ -431,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-2K2SQOUJ.js";
+} from "../chunk-I2TEOHVG.js";
 import "../chunk-2GH7CSCE.js";
 export {
   EntityDetailPanel,