morille 0.1.0

package/dist/config.js

@@ -0,0 +1,65 @@
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolves package.json at runtime so the `name`, `version`, and `homepage`
+ * fields can flow into user-visible strings (User-Agent, about dialog).
+ * Works both from source (`src/config.ts` → `../package.json`) and from the
+ * compiled binary (`dist/config.js` → `../package.json`) since the relative
+ * depth is the same.
+ */
+function loadPackageInfo() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(here, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    return {
+        name: pkg.name,
+        version: pkg.version,
+        homepage: pkg.homepage,
+    };
+}
+const PKG = loadPackageInfo();
+/**
+ * Default Spotify Client ID embedded in the binary.
+ * Users can override this at runtime via the `SPOTIFY_CLIENT_ID` environment variable.
+ * Leave empty to force users to provide their own Client ID.
+ */
+export const DEFAULT_SPOTIFY_CLIENT_ID = '396cd16a363947ad95cb1032acdc4fc8';
+/**
+ * User-Agent sent with every outgoing HTTP request (Spotify Web API + LRCLIB).
+ * Generated from package.json at runtime so it automatically tracks name/version.
+ * Shared via the `fetchWithRetry` wrapper which injects it into all requests.
+ */
+export const USER_AGENT = PKG.homepage ? `${PKG.name}/${PKG.version} (${PKG.homepage})` : `${PKG.name}/${PKG.version}`;
+// @see: https://developer.spotify.com/documentation/web-api/concepts/scopes
+export const AUTH_SCOPES = [
+    'user-read-playback-state',
+    'user-modify-playback-state',
+    'user-read-currently-playing',
+    'user-read-recently-played',
+    'user-library-read',
+    'user-library-modify',
+    'playlist-read-private',
+    'playlist-read-collaborative',
+].join(' ');
+export const AUTH_REDIRECT_PORT = 8888;
+export const AUTH_REDIRECT_URI = `http://127.0.0.1:${AUTH_REDIRECT_PORT}/callback`;
+export const CONFIG_DIR = join(homedir(), '.config', 'morille');
+export const TOKEN_PATH = join(CONFIG_DIR, 'tokens.json');
+export const POLL_INTERVAL_MS = 10_000;
+export const TICK_INTERVAL_MS = 33; // 30 fps
+export const SEEK_STEP_MS = 10_000;
+export const VOLUME_STEP = 5;
+export const LYRICS_WIDE_COLUMNS = 80;
+export const LYRICS_DEFAULT_OFFSET_MS = 100;
+export const LYRICS_OFFSET_STEP_MS = 100;
+export const SEARCH_DEBOUNCE_MS = 300;
+/**
+ * Number of results returned per category by the search endpoint.
+ * Spotify documents max=50, but multi-type searches (track+album+artist+playlist)
+ * have an undocumented stricter cap that rejects larger values with
+ * `400 Invalid limit`. 20 is the documented default and is reliably accepted.
+ */
+export const SEARCH_RESULTS_LIMIT = 20;
+export const USER_PLAYLISTS_LIMIT = 50;

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;GAMG;AACH,SAAS,eAAe;IAKtB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;AAEvH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,0BAA0B;IAC1B,4BAA4B;IAC5B,6BAA6B;IAC7B,2BAA2B;IAC3B,mBAAmB;IACnB,qBAAqB;IACrB,uBAAuB;IACvB,6BAA6B;CAC9B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,kBAAkB,WAAW,CAAC;AAEnF,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC,CAAC,SAAS;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}

package/dist/contexts/lyrics-context.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from 'react';
+import type { Lyrics } from '../spotify/lyrics.js';
+import type { TrackInfo } from '../spotify/playback.js';
+type LyricsContextValue = {
+    lyrics: Lyrics | null;
+    isLoading: boolean;
+    offset: number;
+    durationMs: number;
+    scrollPosition: number;
+    isPlainText: boolean;
+    offsetUp: (() => void) | undefined;
+    offsetDown: (() => void) | undefined;
+    scrollUp: (() => void) | undefined;
+    scrollDown: (() => void) | undefined;
+};
+type LyricsProviderProps = {
+    track: TrackInfo | null;
+    children: ReactNode;
+};
+/**
+ * Provides lyrics data and offset controls.
+ * Only fetches lyrics when the lyrics panel is active.
+ */
+export declare function LyricsProvider({ track, children }: LyricsProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access lyrics data and offset controls.
+ */
+export declare function useLyricsContext(): LyricsContextValue;
+export {};

package/dist/contexts/lyrics-context.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useState } from 'react';
+import { LYRICS_DEFAULT_OFFSET_MS, LYRICS_OFFSET_STEP_MS } from '../config.js';
+import { useLyrics } from '../hooks/use-lyrics.js';
+import { usePanelMode } from './panel-mode-context.js';
+const LyricsContext = createContext(null);
+/**
+ * Provides lyrics data and offset controls.
+ * Only fetches lyrics when the lyrics panel is active.
+ */
+export function LyricsProvider({ track, children }) {
+    const { panelMode } = usePanelMode();
+    const isActive = panelMode === 'lyrics';
+    const { lyrics, isLoading } = useLyrics(isActive ? track : null);
+    const [offset, setOffset] = useState(LYRICS_DEFAULT_OFFSET_MS);
+    const [scrollPosition, setScrollPosition] = useState(0);
+    const isPlainText = !!lyrics && lyrics.synced.length === 0 && !!lyrics.plain;
+    const offsetUp = useCallback(() => setOffset((v) => v + LYRICS_OFFSET_STEP_MS), []);
+    const offsetDown = useCallback(() => setOffset((v) => v - LYRICS_OFFSET_STEP_MS), []);
+    const scrollUp = useCallback(() => setScrollPosition((v) => Math.max(0, v - 1)), []);
+    const scrollDown = useCallback(() => setScrollPosition((v) => v + 1), []);
+    const value = {
+        lyrics,
+        isLoading,
+        offset,
+        durationMs: track?.durationMs ?? 0,
+        scrollPosition,
+        isPlainText,
+        offsetUp: isActive && !isPlainText ? offsetUp : undefined,
+        offsetDown: isActive && !isPlainText ? offsetDown : undefined,
+        scrollUp: isActive && isPlainText ? scrollUp : undefined,
+        scrollDown: isActive && isPlainText ? scrollDown : undefined,
+    };
+    return _jsx(LyricsContext, { value: value, children: children });
+}
+/**
+ * Access lyrics data and offset controls.
+ */
+export function useLyricsContext() {
+    const ctx = useContext(LyricsContext);
+    if (!ctx)
+        throw new Error('useLyricsContext must be used within LyricsProvider');
+    return ctx;
+}

package/dist/contexts/panel-mode-context.d.ts

@@ -0,0 +1,24 @@
+import type { ReactNode } from 'react';
+export type PanelMode = 'none' | 'lyrics' | 'queue' | 'search';
+type PanelModeContextValue = {
+    panelMode: PanelMode;
+    hasPanel: boolean;
+    isInputMode: boolean;
+    setInputMode: (v: boolean) => void;
+    toggleLyrics: () => void;
+    toggleQueue: () => void;
+    toggleSearch: () => void;
+};
+/**
+ * Provides shared panel mode state. Only one panel can be active at a time.
+ * Toggling the active panel closes it; toggling a different panel switches to it.
+ * Tracks whether a text input is active (isInputMode) to suppress keyboard shortcuts.
+ */
+export declare function PanelModeProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access the current panel mode and toggle actions.
+ */
+export declare function usePanelMode(): PanelModeContextValue;
+export {};

package/dist/contexts/panel-mode-context.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useState } from 'react';
+const PanelModeContext = createContext(null);
+/**
+ * Provides shared panel mode state. Only one panel can be active at a time.
+ * Toggling the active panel closes it; toggling a different panel switches to it.
+ * Tracks whether a text input is active (isInputMode) to suppress keyboard shortcuts.
+ */
+export function PanelModeProvider({ children }) {
+    const [panelMode, setPanelMode] = useState('none');
+    const [isInputMode, setInputMode] = useState(false);
+    const toggle = useCallback((mode) => {
+        setPanelMode((v) => {
+            const next = v === mode ? 'none' : mode;
+            if (next !== 'search')
+                setInputMode(false);
+            return next;
+        });
+    }, []);
+    const value = {
+        panelMode,
+        hasPanel: panelMode !== 'none',
+        isInputMode,
+        setInputMode,
+        toggleLyrics: useCallback(() => toggle('lyrics'), [
+            toggle,
+        ]),
+        toggleQueue: useCallback(() => toggle('queue'), [
+            toggle,
+        ]),
+        toggleSearch: useCallback(() => toggle('search'), [
+            toggle,
+        ]),
+    };
+    return _jsx(PanelModeContext, { value: value, children: children });
+}
+/**
+ * Access the current panel mode and toggle actions.
+ */
+export function usePanelMode() {
+    const ctx = useContext(PanelModeContext);
+    if (!ctx)
+        throw new Error('usePanelMode must be used within PanelModeProvider');
+    return ctx;
+}

package/dist/contexts/queue-context.d.ts

@@ -0,0 +1,32 @@
+import type { SpotifyApi } from '@spotify/web-api-ts-sdk';
+import type { ReactNode } from 'react';
+import type { QueueItem } from '../hooks/use-queue.js';
+import type { TrackInfo } from '../spotify/playback.js';
+type QueueContextValue = {
+    queue: QueueItem[];
+    contextName: string | null;
+    contextSubtitle: string | null;
+    isLoading: boolean;
+    selectedIndex: number;
+    refresh: () => Promise<void>;
+    queueUp: (() => void) | undefined;
+    queueDown: (() => void) | undefined;
+    queueSelect: (() => void) | undefined;
+};
+type QueueProviderProps = {
+    client: SpotifyApi;
+    track: TrackInfo | null;
+    playTrackUri: (uri: string) => Promise<void>;
+    refresh: () => Promise<void>;
+    children: ReactNode;
+};
+/**
+ * Provides queue data and navigation controls.
+ * Only fetches queue when the queue panel is active.
+ */
+export declare function QueueProvider({ client, track, playTrackUri, refresh, children }: QueueProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access queue data and navigation controls.
+ */
+export declare function useQueueContext(): QueueContextValue;
+export {};

package/dist/contexts/queue-context.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useState } from 'react';
+import { useQueue } from '../hooks/use-queue.js';
+import { playInContext } from '../spotify/playback.js';
+import { usePanelMode } from './panel-mode-context.js';
+const QueueContext = createContext(null);
+/**
+ * Provides queue data and navigation controls.
+ * Only fetches queue when the queue panel is active.
+ */
+export function QueueProvider({ client, track, playTrackUri, refresh, children }) {
+    const { panelMode } = usePanelMode();
+    const isActive = panelMode === 'queue';
+    const { queue, contextName, contextSubtitle, isLoading, currentIndex, refresh: refreshQueue, } = useQueue(client, isActive, track?.context ?? null, track?.uri ?? null);
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const handleSelect = useCallback(async () => {
+        const item = queue[selectedIndex];
+        const deviceId = track?.deviceId;
+        const context = track?.context;
+        if (!item || !deviceId)
+            return;
+        if (context) {
+            await playInContext(client, deviceId, context.uri, item.uri);
+        }
+        else {
+            await playTrackUri(item.uri);
+        }
+        await refresh();
+    }, [
+        client,
+        queue,
+        selectedIndex,
+        track,
+        playTrackUri,
+        refresh,
+    ]);
+    // Reset selection to current track when opening the queue
+    const prevIsActive = useCallback(() => {
+        setSelectedIndex(currentIndex);
+    }, [
+        currentIndex,
+    ]);
+    // Call reset when becoming active
+    if (isActive && selectedIndex === 0 && currentIndex > 0) {
+        prevIsActive();
+    }
+    const value = {
+        queue,
+        contextName,
+        contextSubtitle,
+        isLoading,
+        selectedIndex,
+        refresh: refreshQueue,
+        queueUp: isActive ? () => setSelectedIndex((v) => Math.max(0, v - 1)) : undefined,
+        queueDown: isActive ? () => setSelectedIndex((v) => Math.min(Math.max(queue.length - 1, 0), v + 1)) : undefined,
+        queueSelect: isActive ? handleSelect : undefined,
+    };
+    return _jsx(QueueContext, { value: value, children: children });
+}
+/**
+ * Access queue data and navigation controls.
+ */
+export function useQueueContext() {
+    const ctx = useContext(QueueContext);
+    if (!ctx)
+        throw new Error('useQueueContext must be used within QueueProvider');
+    return ctx;
+}

package/dist/contexts/search-context.d.ts

@@ -0,0 +1,59 @@
+import type { SpotifyApi } from '@spotify/web-api-ts-sdk';
+import type { ReactNode } from 'react';
+import type { BrowseData } from '../hooks/use-browse.js';
+import type { TrackInfo } from '../spotify/playback.js';
+import type { SearchResultPlaylist, SearchResults } from '../spotify/search.js';
+export type SearchView = {
+    kind: 'input';
+} | {
+    kind: 'album';
+    id: string;
+    name: string;
+} | {
+    kind: 'playlist';
+    id: string;
+    name: string;
+} | {
+    kind: 'playlists';
+};
+export type SearchCategory = 'tracks' | 'albums' | 'artists' | 'playlists';
+type SearchContextValue = {
+    query: string;
+    results: SearchResults | null;
+    isSearchLoading: boolean;
+    currentView: SearchView;
+    canGoBack: boolean;
+    browseData: BrowseData | null;
+    isBrowseLoading: boolean;
+    userPlaylists: SearchResultPlaylist[] | null;
+    isPlaylistsLoading: boolean;
+    selectedCategory: SearchCategory;
+    selectedIndex: number;
+    currentTrackUri: string | null;
+    currentContextUri: string | null;
+    setQuery: ((q: string) => void) | undefined;
+    navigateUp: (() => void) | undefined;
+    navigateDown: (() => void) | undefined;
+    navigateLeft: (() => void) | undefined;
+    navigateRight: (() => void) | undefined;
+    select: (() => void) | undefined;
+    goBack: (() => void) | undefined;
+    browseUserPlaylists: (() => void) | undefined;
+};
+type SearchProviderProps = {
+    client: SpotifyApi;
+    track: TrackInfo | null;
+    playTrackUri: (uri: string) => Promise<void>;
+    refresh: () => Promise<void>;
+    children: ReactNode;
+};
+/**
+ * Provides search state, navigation stack, and selection controls.
+ * Only active when the search panel is open.
+ */
+export declare function SearchProvider({ client, track, playTrackUri, refresh, children }: SearchProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access search state and navigation controls.
+ */
+export declare function useSearchContext(): SearchContextValue;
+export {};