@behindthemusictree/app-kit-ui 33.2.0 → 34.0.0

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

@@ -3,7 +3,7 @@ import { ReactNode, ComponentProps } from 'react';
 import { z } from 'zod';
 import { GenreTreeProps, FocusChangeReason, GenreTreeNode, GenreTreeAction, GenreTreeViewMode, GenreTreeViewport, WheelZoomMode } from '@behindthemusictree/genre-tree-view';
 export { FocusChangeReason, GenreTreeAction, GenreTreeOutlineSkeleton, GenreTreeSkeleton, GenreTreeViewMode, GenreTreeViewSkeleton, GenreTreeViewSkeletonProps, GenreTreeViewport, GenreTreeWheelSkeleton } from '@behindthemusictree/genre-tree-view';
-import { TrackBase, CriteriaOverview, GenreUuid, CriteriaPlaylistMinimum, RenderArtistLink, RenderSongLink, CriteriaPlaylistSimple, ArtistSearchResult, SongSearchResult, UseGenreRemoteSearchOptions, GenreSearchResult, GenrePlaylistUuid, CriteriaMinimum } from '@behindthemusictree/app-kit/genre-tree';
+import { TrackBase, CriteriaOverview, GenreUuid, CriteriaPlaylistMinimum, GenreMusicSelection, RenderArtistLink, RenderSongLink, CriteriaPlaylistSimple, ArtistSearchResult, SongSearchResult, UseGenreRemoteSearchOptions, GenreSearchResult, GenrePlaylistUuid, CriteriaMinimum, GenreCatalogueCounts, GenrePlaylistSummary } from '@behindthemusictree/app-kit/genre-tree';
 import { Scope } from '@behindthemusictree/app-kit/transport';
 import { DetailPanel } from '@behindthemusictree/ui';
 
@@ -25,6 +25,7 @@ type GenreDetailSlots<O extends CriteriaOverview> = {
 type GenreDetailExtrasProps<O extends CriteriaOverview> = GenreDetailSlots<O> & GenrePlaylistTracksSlots & {
     genreUuid: GenreUuid;
     genrePlaylist: CriteriaPlaylistMinimum;
+    selection?: GenreMusicSelection;
     wikidataId?: string | null;
     scope: Scope;
     getBackendBaseUrl: () => string;
@@ -60,11 +61,9 @@ type HostOverlayPanel = Omit<OverlayPanel, "expanded" | "onExpandedChange"> & {
 /** The host-owned detail panel's contract with the tree: the area the panel covers, and the node-style resolver the tree publishes back. */
 type HostPanelProps = Partial<Pick<GenreTreeProps, "obscuredInset" | "onNodeStyleResolverChange">>;
 
-/** What a play button needs of a playlist; `criteria` is only read when playing one artist's songs in the genre. */
 type PlayableGenrePlaylistInput = CriteriaPlaylistMinimum & {
     criteria?: CriteriaPlaylistSimple["criteria"];
 };
-/** What a tree node's play button plays, and which node is the one currently playing. */
 type GenrePlaylistPlayback = {
     playingNodeId: string | null;
     play: (genrePlaylist: PlayableGenrePlaylistInput) => Promise<void>;
@@ -72,7 +71,6 @@ type GenrePlaylistPlayback = {
 type UseGenrePlaylistPlaybackOptions = {
     scope: Scope;
     genrePlaylists: CriteriaPlaylistSimple[];
-    /** When set, nodes play only this artist's songs in the genre's subtree instead of the whole genre playlist. */
     artist?: {
         uuid: string;
         name: string;
@@ -227,6 +225,10 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     readOnly?: boolean;
     /** Further result groups (e.g. places) shown in the search box next to genres, artists and songs. */
     extraSearchGroups?: SearchGroup[];
+    /** Fires with the typed search text (empty when cleared), so a host can drive its own `extraSearchGroups`. */
+    onSearchQueryChange?: (text: string) => void;
+    /** Fires when the search box gains focus, e.g. to load data for `extraSearchGroups` lazily. */
+    onSearchFocus?: () => void;
     /** Root element classes; the component adds no outer margin. */
     className?: string;
     /** Shows the "Tree display options" group (e.g. Rotation). Defaults to true. */
@@ -286,7 +288,7 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     collapsed?: boolean;
     onCollapsedChange?: (collapsed: boolean) => void;
 };
-declare function GenreTreeView<O extends CriteriaOverview = CriteriaOverview>({ scope, handleGenreCreationAction, handleGenreRenameAction, onParentChanged, getBackendBaseUrl, additionalActions, viewMode: controlledViewMode, selectedNodeId: controlledSelectedNodeId, onSelectedNodeIdChange, defaultViewport, viewportRestore, onViewportChange, readOnly, className, showDisplayOptions, showAddRoot, allowWheelRotation: controlledAllowWheelRotation, criteriaOverviewSchema, renderGenreDetailExtras, floatingControlsLeading, sizeMetric: controlledSizeMetric, onSizeMetricChange, renderArtistLink, artistUuid: controlledArtistUuid, onArtistUuidChange, artistExpanded: controlledArtistExpanded, onArtistExpandedChange, getShareUrl, extraSearchGroups, artistSearch, onArtistSelect, artistSearchBaseUrl, songUuid: controlledSongUuid, onSongUuidChange, songExpanded: controlledSongExpanded, onSongExpandedChange, songSearch, onSongSelect, renderSongLink, renderSummary, renderEssentialTracks, renderSongLeading, renderSongActions, renderTracksToolbar, renderDangerZone, expanded, onExpandedChange, collapsed, onCollapsedChange, overlayPanel, placement, ...focus }: GenreTreeViewProps<O>): react.JSX.Element;
+declare function GenreTreeView<O extends CriteriaOverview = CriteriaOverview>({ scope, handleGenreCreationAction, handleGenreRenameAction, onParentChanged, getBackendBaseUrl, additionalActions, viewMode: controlledViewMode, selectedNodeId: controlledSelectedNodeId, onSelectedNodeIdChange, defaultViewport, viewportRestore, onViewportChange, readOnly, className, showDisplayOptions, showAddRoot, allowWheelRotation: controlledAllowWheelRotation, criteriaOverviewSchema, renderGenreDetailExtras, floatingControlsLeading, sizeMetric: controlledSizeMetric, onSizeMetricChange, renderArtistLink, artistUuid: controlledArtistUuid, onArtistUuidChange, artistExpanded: controlledArtistExpanded, onArtistExpandedChange, getShareUrl, extraSearchGroups, onSearchQueryChange, onSearchFocus, artistSearch, onArtistSelect, artistSearchBaseUrl, songUuid: controlledSongUuid, onSongUuidChange, songExpanded: controlledSongExpanded, onSongExpandedChange, songSearch, onSongSelect, renderSongLink, renderSummary, renderEssentialTracks, renderSongLeading, renderSongActions, renderTracksToolbar, renderDangerZone, expanded, onExpandedChange, collapsed, onCollapsedChange, overlayPanel, placement, ...focus }: GenreTreeViewProps<O>): react.JSX.Element;
 
 type GenreActionBandProps = {
     node: GenreTreeNode;
@@ -313,9 +315,9 @@ type GenreActionBandProps = {
 declare function GenreActionBand({ node, onPlayPause, isPlaying, 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 & {
+type PlayableGenrePlaylist = (CriteriaPlaylistMinimum & {
     tracksCount: number;
-};
+}) | GenrePlaylistSummary;
 type GenreNodeActionBandProps = Omit<ComponentProps<typeof GenreActionBand>, "onPlayPause" | "isPlaying"> & {
     genrePlaylist: PlayableGenrePlaylist;
     playback: GenrePlaylistPlayback;
@@ -326,6 +328,7 @@ type GenreInfoPanelBodyProps<O extends CriteriaOverview> = {
     toolbar?: ReactNode;
     family: ReactNode;
     genreUuid: GenreUuid;
+    catalogue?: GenreCatalogueCounts;
     genrePlaylist: PlayableGenrePlaylist;
     wikidataId?: string | null;
     scope: Scope;
@@ -337,7 +340,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, 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;

package/dist/genre-tree/index.js

@@ -21,7 +21,7 @@ import {
   useGenrePlaylistPlayback,
   useGenreRemoteSearchGroup,
   useSongSearchGroup
-} from "../chunk-FHGQGTCN.js";
+} from "../chunk-A7OWCEIK.js";
 import "../chunk-DKQQLLMY.js";
 export {
   GenreDetailPanel,