@behindthemusictree/app-kit-ui 34.1.0 → 35.0.0

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

@@ -3,7 +3,7 @@ import { ReactNode, ComponentType, 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, GenreMusicSelection, RenderArtistLink, RenderSongLink, CriteriaPlaylistSimple, ArtistSearchResult, SongSearchResult, UseGenreRemoteSearchOptions, GenreSearchResult, GenrePlaylistUuid, CriteriaMinimum, GenreCatalogueCounts, GenrePlaylistSummary } from '@behindthemusictree/app-kit/genre-tree';
+import { TrackBase, CriteriaOverview, GenreUuid, CriteriaPlaylistMinimum, GenreMusicSelection, RenderArtistLink, RenderSongLink, CriteriaPlaylistSimple, ArtistSearchResult, SongSearchResult, UseGenreRemoteSearchOptions, GenreSearchResult, CriteriaMinimum, GenreCatalogueCounts, GenrePlaylistSummary } from '@behindthemusictree/app-kit/genre-tree';
 import { Scope } from '@behindthemusictree/app-kit/transport';
 import { DetailPanel } from '@behindthemusictree/ui';
 
@@ -24,7 +24,8 @@ type GenreDetailSlots<O extends CriteriaOverview> = {
 };
 type GenreDetailExtrasProps<O extends CriteriaOverview> = GenreDetailSlots<O> & GenrePlaylistTracksSlots & {
     genreUuid: GenreUuid;
-    genrePlaylist: CriteriaPlaylistMinimum;
+    genrePlaylist: CriteriaPlaylistMinimum | null;
+    genreName?: string;
     selection?: GenreMusicSelection;
     wikidataId?: string | null;
     scope: Scope;
@@ -177,6 +178,7 @@ declare function GenreSearch<T extends CriteriaPlaylistSimple = CriteriaPlaylist
 interface GenreSearchGroupsProps {
     query: string;
     focused: boolean;
+    onSelectGenre: (uuid: GenreUuid) => void;
     children: (groups: SearchGroup[]) => ReactNode;
 }
 
@@ -189,8 +191,8 @@ type ParentChange = {
 /** Identifies the detail-panel entity whose current host route should be shared. */
 type GenreTreeShareTarget = {
     kind: "genre";
-    /** Tree selection/route identity; distinct from the associated criteria UUID. */
-    genrePlaylistUuid: GenrePlaylistUuid;
+    /** Genre entity identity, independent of its playlist or renderer. */
+    genreUuid: GenreUuid;
     name: string;
     scope: Scope;
     /** Preserve an active artist filter when sharing one of its genre details. */
@@ -234,11 +236,10 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     additionalActions?: (node: GenreTreeNode) => GenreTreeAction[];
     /** Controlled view mode. When provided, the internal Stacked/Wheel toggle is not rendered — the consumer owns that UI. */
     viewMode?: GenreTreeViewMode;
-    /** Controlled selection (a genre playlist uuid, i.e. the tree node id). When provided, the
-     * consumer owns it — e.g. to move the selection after deleting the selected genre. */
-    selectedNodeId?: string | null;
+    /** Selected genre entity, including genres outside the rendered tree. */
+    selectedGenreUuid?: GenreUuid | null;
     /** Called on every user-driven selection change (tree click, search pick, search clear). */
-    onSelectedNodeIdChange?: (nodeId: string | null) => void;
+    onSelectedGenreUuidChange?: (genreUuid: GenreUuid | null) => void;
     /** Mount-only seed for the pan/zoom (wheel, pop-core and stacked views), replacing the initial fit. */
     defaultViewport?: GenreTreeViewport;
     /** Restore silently after layout; use a new revision for each navigation. Supply focus, selection,
@@ -317,7 +318,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, SearchGroups, 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;
+declare function GenreTreeView<O extends CriteriaOverview = CriteriaOverview>({ scope, handleGenreCreationAction, handleGenreRenameAction, onParentChanged, getBackendBaseUrl, additionalActions, viewMode: controlledViewMode, selectedGenreUuid: controlledSelectedGenreUuid, onSelectedGenreUuidChange, defaultViewport, viewportRestore, onViewportChange, readOnly, className, showDisplayOptions, showAddRoot, allowWheelRotation: controlledAllowWheelRotation, criteriaOverviewSchema, renderGenreDetailExtras, floatingControlsLeading, sizeMetric: controlledSizeMetric, onSizeMetricChange, renderArtistLink, artistUuid: controlledArtistUuid, onArtistUuidChange, artistExpanded: controlledArtistExpanded, onArtistExpandedChange, getShareUrl, extraSearchGroups, SearchGroups, 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;
@@ -344,9 +345,11 @@ 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;
+}) | GenrePlaylistSummary) & {
+    criteria?: CriteriaMinimum | null;
+};
 type GenreNodeActionBandProps = Omit<ComponentProps<typeof GenreActionBand>, "onPlayPause" | "isPlaying"> & {
     genrePlaylist: PlayableGenrePlaylist;
     playback: GenrePlaylistPlayback;
@@ -358,18 +361,19 @@ type GenreInfoPanelBodyProps<O extends CriteriaOverview> = {
     family: ReactNode;
     genreUuid: GenreUuid;
     catalogue?: GenreCatalogueCounts;
-    genrePlaylist: PlayableGenrePlaylist;
+    countsContext?: string;
+    genrePlaylist: PlayableGenrePlaylist | null;
     wikidataId?: string | null;
     scope: Scope;
     getBackendBaseUrl: () => string;
     playback: GenrePlaylistPlayback;
     /** Action band props other than play, which the body derives from `playback`. */
     band: Omit<GenreNodeActionBandProps, "genrePlaylist" | "playback">;
-    extras?: Omit<GenreDetailExtrasProps<O>, "family" | "genreUuid" | "genrePlaylist" | "wikidataId" | "scope" | "getBackendBaseUrl">;
+    extras?: Omit<GenreDetailExtrasProps<O>, "family" | "genreUuid" | "genreName" | "genrePlaylist" | "wikidataId" | "scope" | "getBackendBaseUrl">;
 };
 /** 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, wikidataId, scope, getBackendBaseUrl, playback, band, extras, }: GenreInfoPanelBodyProps<O>): react.JSX.Element;
+declare function GenreInfoPanelBody<O extends CriteriaOverview>({ toolbar, family, genreUuid, genrePlaylist, catalogue, countsContext, wikidataId, scope, getBackendBaseUrl, playback, band, extras, }: GenreInfoPanelBodyProps<O>): react.JSX.Element;
 
 type GenreDetailPanelProps<O extends CriteriaOverview> = {
     genreUuid: GenreUuid;
@@ -389,9 +393,9 @@ type GenreDetailPanelProps<O extends CriteriaOverview> = {
     /** Tab on the panel's inner edge, for hosts that hide and show the panel. */
     edgeTab?: ComponentProps<typeof DetailPanel>["edgeTab"];
     extras?: GenreInfoPanelBodyProps<O>["extras"];
+    headerClassName?: ComponentProps<typeof DetailPanel>["headerClassName"];
 };
-/** A genre's detail panel driven by one uuid, with no tree behind it. The tree's own panel shares its body. */
-declare function GenreDetailPanel<O extends CriteriaOverview>({ genreUuid, scope, getBackendBaseUrl, onClose, onSelectGenre, onZoomIn, shareUrl, shareTarget, collapsed, expanded, onExpandedChange, edgeTab, extras, }: GenreDetailPanelProps<O>): react.JSX.Element;
+declare function GenreDetailPanel<O extends CriteriaOverview>({ genreUuid, scope, getBackendBaseUrl, onClose, onSelectGenre, onZoomIn, shareUrl, shareTarget, collapsed, expanded, onExpandedChange, edgeTab, extras, headerClassName, }: GenreDetailPanelProps<O>): react.JSX.Element;
 
 type GenrePlaylistTreePerRootProps<T extends TrackBase> = {
     scope: Scope;

package/dist/genre-tree/index.js

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