@behindthemusictree/app-kit-ui 24.0.1 → 26.1.0

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

@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import { z } from 'zod';
 import { GenreTreeProps, FocusChangeReason, GenreTreeNode, GenreTreeAction, GenreTreeViewMode, GenreTreeViewport, ControlsOrientation, InfoPanelSections, InfoPanelBody, WheelZoomMode } from '@behindthemusictree/genre-tree-view';
 export { ControlsOrientation, FocusChangeReason, GenreTreeAction, GenreTreeOutlineSkeleton, GenreTreeSkeleton, GenreTreeViewMode, GenreTreeViewSkeleton, GenreTreeViewSkeletonProps, GenreTreeViewport, GenreTreeWheelSkeleton } from '@behindthemusictree/genre-tree-view';
-import { TrackBase, CriteriaOverview, CriteriaPlaylistSimple, ArtistSearchResult, CriteriaMinimum, RenderArtistLink } from '@behindthemusictree/app-kit/genre-tree';
+import { TrackBase, CriteriaOverview, CriteriaPlaylistSimple, GenreUuid, ArtistSearchResult, CriteriaMinimum, RenderArtistLink } from '@behindthemusictree/app-kit/genre-tree';
 import { Scope } from '@behindthemusictree/app-kit/transport';
 
 type GenrePlaylistTracksSlots = {
@@ -22,8 +22,8 @@ type GenreDetailSlots<O extends CriteriaOverview> = {
     renderEssentialTracks?: (overview: O) => ReactNode;
 };
 
-/** Controlled edit/expand state and edit-mode slots of the info panel, plus the generic overlay panel, as typed by genre-tree-view. */
-type InfoPanelCurationProps = Partial<Pick<GenreTreeProps, "editMode" | "onEditModeChange" | "renderTitleEditor" | "renderParentsEditor" | "renderDangerZone" | "expanded" | "onExpandedChange" | "collapsed" | "hideExpandButton" | "overlayPanel">>;
+/** Controlled expand state and danger-zone slot of the info panel, plus the generic overlay panel, as typed by genre-tree-view. */
+type InfoPanelCurationProps = Partial<Pick<GenreTreeProps, "renderDangerZone" | "expanded" | "onExpandedChange" | "collapsed" | "hideExpandButton" | "overlayPanel">>;
 
 /** What a tree node's play button plays, and which node is the one currently playing. */
 type GenrePlaylistPlayback = {
@@ -31,6 +31,8 @@ type GenrePlaylistPlayback = {
     play: (genrePlaylist: CriteriaPlaylistSimple) => Promise<void>;
 };
 
+type GenreTreeSizeMetric = "songs" | "views";
+
 /** Pop-core focus is controlled-only: pass both props or neither. Ignored in outline mode. */
 type GenreFocusProps = {
     focusGenreUuid?: undefined;
@@ -46,6 +48,12 @@ type GenreFocusProps = {
     onFocusGenreChange: (uuid: string | null, reason: FocusChangeReason) => void;
 };
 
+type ParentChange = {
+    genre: GenreUuid;
+    from: GenreUuid | null;
+    to: GenreUuid;
+};
+
 /** Artists are searched by default; picking one opens its panel (see `artistUuid`). */
 type ArtistSearchProps = {
     artistSearch: false;
@@ -65,6 +73,8 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     handleGenreCreationAction: (parent: CriteriaMinimum | null) => void;
     handleGenreRenameAction: (genre: CriteriaMinimum) => void;
     getBackendBaseUrl: () => string;
+    /** Called after the Parent popup moved a genre; `from` and `to` are genre (criteria) uuids, `from` null for a root genre. */
+    onParentChanged?: (change: ParentChange) => void;
     additionalActions?: (node: GenreTreeNode) => GenreTreeAction[];
     /** Controlled view mode. When provided, the internal Stacked/Wheel toggle is not rendered — the consumer owns that UI. */
     viewMode?: GenreTreeViewMode;
@@ -94,6 +104,10 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     renderGenreDetailExtras?: (overview: O) => ReactNode;
     /** Layout of the wheel/tree floating zoom/pop/fit controls. Defaults to "horizontal". */
     controlsOrientation?: ControlsOrientation;
+    /** Controlled size metric of the wheel and pop-core nodes: song count or summed song views. Uncontrolled when omitted
+     * (starts on songs). The toggle is hidden while an artist filters the tree, which only has song counts. */
+    sizeMetric?: GenreTreeSizeMetric;
+    onSizeMetricChange?: (metric: GenreTreeSizeMetric) => void;
     /** When set, artist names in the info panel's track list render through it (e.g. a router `Link`). In the artist
      * panel, names otherwise render as buttons that switch the panel to that artist. */
     renderArtistLink?: RenderArtistLink;
@@ -112,7 +126,7 @@ type GenreTreeViewProps<O extends CriteriaOverview = CriteriaOverview> = {
     collapsed?: boolean;
     onCollapsedChange?: (collapsed: boolean) => void;
 };
-declare function GenreTreeView<O extends CriteriaOverview = CriteriaOverview>({ scope, handleGenreCreationAction, handleGenreRenameAction, getBackendBaseUrl, additionalActions, viewMode: controlledViewMode, selectedNodeId: controlledSelectedNodeId, onSelectedNodeIdChange, defaultViewport, onViewportChange, readOnly, className, showDisplayOptions, showAddRoot, allowWheelRotation: controlledAllowWheelRotation, criteriaOverviewSchema, renderGenreDetailExtras, controlsOrientation, renderArtistLink, artistUuid: controlledArtistUuid, onArtistUuidChange, artistExpanded: controlledArtistExpanded, onArtistExpandedChange, artistSearch, onArtistSelect, artistSearchBaseUrl, renderSummary, renderEssentialTracks, renderSongLeading, renderSongActions, renderTracksToolbar, editMode, onEditModeChange, renderTitleEditor, renderParentsEditor, 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, onViewportChange, readOnly, className, showDisplayOptions, showAddRoot, allowWheelRotation: controlledAllowWheelRotation, criteriaOverviewSchema, renderGenreDetailExtras, controlsOrientation, sizeMetric: controlledSizeMetric, onSizeMetricChange, renderArtistLink, artistUuid: controlledArtistUuid, onArtistUuidChange, artistExpanded: controlledArtistExpanded, onArtistExpandedChange, artistSearch, onArtistSelect, artistSearchBaseUrl, renderSummary, renderEssentialTracks, renderSongLeading, renderSongActions, renderTracksToolbar, renderDangerZone, expanded, onExpandedChange, collapsed, onCollapsedChange, overlayPanel, placement, ...focus }: GenreTreeViewProps<O>): react.JSX.Element;
 
 type GenrePlaylistTreePerRootProps<T extends TrackBase> = {
     scope: Scope;
@@ -159,6 +173,8 @@ type GenreSearchExtraResults = {
     }[];
     /** Announced politely, e.g. "No artists found". */
     status?: string;
+    /** Shows a spinner in place of the search icon while the host resolves this group. */
+    loading?: boolean;
 };
 type GenreSearchProps<T extends CriteriaPlaylistSimple = CriteriaPlaylistSimple> = {
     genrePlaylists: T[];
@@ -243,4 +259,4 @@ interface PanelEdgeTabProps {
 }
 declare function PanelEdgeTab({ side, edge, center, controls, className }: PanelEdgeTabProps): react.JSX.Element | null;
 
-export { type ArtistSearchProps, type GenreDetailSlots, type GenreFocusProps, type GenrePlaylistTracksSlots, GenrePlaylistTreePerRoot, type GenrePlaylistTreePerRootProps, GenreSearch, type GenreSearchExtraResults, type GenreSearchProps, GenreTreeView, type GenreTreeViewProps, type InfoPanelCurationProps, PanelEdgeTab, type PanelEdgeTabAction, type PanelEdgeTabProps, PlayerPanel, type PlayerPanelProps, Rating, type RatingProps, TrackItem, type TrackItemProps, TrackListSidebar, type TrackListSidebarProps, TrackPositionPlayPause, type TrackPositionPlayPauseProps };
+export { type ArtistSearchProps, type GenreDetailSlots, type GenreFocusProps, type GenrePlaylistTracksSlots, GenrePlaylistTreePerRoot, type GenrePlaylistTreePerRootProps, GenreSearch, type GenreSearchExtraResults, type GenreSearchProps, GenreTreeView, type GenreTreeViewProps, type InfoPanelCurationProps, PanelEdgeTab, type PanelEdgeTabAction, type PanelEdgeTabProps, type ParentChange, PlayerPanel, type PlayerPanelProps, Rating, type RatingProps, TrackItem, type TrackItemProps, TrackListSidebar, type TrackListSidebarProps, TrackPositionPlayPause, type TrackPositionPlayPauseProps };

package/dist/genre-tree/index.js

@@ -12,7 +12,7 @@ import {
   TrackItem,
   TrackListSidebar,
   TrackPositionPlayPause
-} from "../chunk-BPCFNBFO.js";
+} from "../chunk-KPWV4LEJ.js";
 import "../chunk-VDXUW7PP.js";
 export {
   GenrePlaylistTreePerRoot,