roon-mcp 0.1.0

package/dist/SearchService.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/SearchService.test.js

@@ -0,0 +1,197 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { BrowseSessionManager } from "./BrowseSessionManager.js";
+import { GenreService } from "./GenreService.js";
+import { decodeLocator, isGenreLocator } from "./locator.js";
+import { SearchService } from "./SearchService.js";
+import { TrackExpansionService } from "./TrackExpansionService.js";
+/** Minimal stateful model of Roon's search hierarchy (levels + a stack). */
+class FakeBrowse {
+    groups;
+    opts;
+    drills;
+    stack = [];
+    inputCalls = 0;
+    constructor(groups, opts = {}, 
+    // item_key → child rows, for drilling below the top groups (e.g. an album's
+    // track list). Lets the streaming-genre path expand albums into tracks.
+    drills = {}) {
+        this.groups = groups;
+        this.opts = opts;
+        this.drills = drills;
+    }
+    browse(o, cb) {
+        if (o.pop_levels) {
+            for (let i = 0; i < o.pop_levels; i++)
+                this.stack.pop();
+            return cb(false, { action: "list" });
+        }
+        // Real Roon takes `input` together with `pop_all` in one call; the input
+        // branch resets the stack itself, so check it before a bare `pop_all`.
+        if (o.input !== undefined) {
+            this.inputCalls++;
+            if (this.opts.failInputTimes && this.inputCalls <= this.opts.failInputTimes) {
+                return cb("InvalidItemKey", undefined);
+            }
+            if (this.opts.messageOnInput) {
+                return cb(false, { action: "message", message: this.opts.messageOnInput });
+            }
+            this.stack = [
+                this.groups.map((g) => ({ title: g.title, item_key: g.key, hint: "list" })),
+            ];
+            return cb(false, { action: "list" });
+        }
+        if (o.pop_all) {
+            this.stack = [];
+            return cb(false, { action: "list" });
+        }
+        if (o.item_key !== undefined) {
+            const g = this.groups.find((x) => x.key === o.item_key);
+            if (g && !g.failDrill) {
+                this.stack.push(g.items);
+                return cb(false, { action: "list" });
+            }
+            const drilled = this.drills[o.item_key];
+            if (drilled) {
+                this.stack.push(drilled);
+                return cb(false, { action: "list" });
+            }
+            return cb("InvalidItemKey", undefined);
+        }
+        return cb(false, { action: "none" });
+    }
+    load(o, cb) {
+        const top = this.stack[this.stack.length - 1] ?? [];
+        const offset = o.offset ?? 0;
+        const items = top.slice(offset, offset + (o.count ?? 100));
+        cb(false, { items, offset, list: { title: "", count: top.length, level: this.stack.length - 1 } });
+    }
+}
+function buildService(groups, opts, drills) {
+    const fake = new FakeBrowse(groups, opts, drills);
+    const stub = { waitForCore: async () => undefined, getBrowse: () => fake };
+    const browse = new BrowseSessionManager(stub);
+    return new SearchService(browse, new GenreService(browse), new TrackExpansionService(browse));
+}
+function item(title, key) {
+    return { title, item_key: key, hint: "list" };
+}
+/** A track leaf (no "list" hint, so it's a playable row, not a container). */
+function leaf(title, key) {
+    return { title, item_key: key };
+}
+const ARTISTS = {
+    title: "Artists",
+    key: "g:artists",
+    items: [item("Tycho", "a:tycho"), item("Tycho Brahe", "a:brahe")],
+};
+const ALBUMS = {
+    title: "Albums",
+    key: "g:albums",
+    items: [item("Dive", "al:dive")],
+};
+const GENRES = {
+    title: "Genres",
+    key: "g:genres",
+    items: [item("Dark Ambient", "ge:dark")],
+};
+test("searchMusic returns ranked candidates keyed by re-navigable locators", async () => {
+    const svc = buildService([ARTISTS]);
+    const out = await svc.searchMusic({ query: "Tycho" });
+    assert.equal(out.broadened, false);
+    assert.equal(out.candidates[0]?.title, "Tycho");
+    assert.equal(out.candidates[0]?.type, "artist");
+    assert.equal(out.candidates[0]?.sourceGroup, "Artists");
+    // The itemKey is a locator carrying the query + group/item indices, not the
+    // raw (ephemeral) Roon key.
+    const decoded = decodeLocator(out.candidates[0]?.itemKey ?? "");
+    assert.ok(decoded && !isGenreLocator(decoded));
+    assert.equal(decoded.q, "Tycho");
+    assert.equal(typeof decoded.g, "number");
+    assert.equal(decoded.i, 0);
+    // Exact title match ranks above the prefix match.
+    assert.ok((out.candidates[0]?.score ?? 0) > (out.candidates[1]?.score ?? 0));
+});
+test("a type filter collects only the matching category", async () => {
+    const svc = buildService([ARTISTS, ALBUMS, GENRES]);
+    const out = await svc.searchMusic({ query: "Tycho", type: "artist" });
+    assert.equal(out.broadened, false);
+    assert.ok(out.candidates.length > 0);
+    assert.ok(out.candidates.every((c) => c.type === "artist"));
+});
+test("a typed search with no matching items broadens to all categories", async () => {
+    // No Playlists group at all → typed selection is empty → broaden.
+    const svc = buildService([ARTISTS, ALBUMS, GENRES]);
+    const out = await svc.searchMusic({ query: "Dark Ambient", type: "playlist" });
+    assert.equal(out.broadened, true);
+    assert.match(out.message ?? "", /broadened/i);
+    assert.equal(out.candidates[0]?.title, "Dark Ambient");
+});
+test("type:genre is resolved via the genres tree, not broadened to artists", async () => {
+    // The flat-search fake has no genres tree, so resolution yields no genres —
+    // crucially it must NOT silently broaden back to the artist/album groups.
+    const svc = buildService([ARTISTS, ALBUMS, GENRES]);
+    const out = await svc.searchMusic({ query: "Dark Ambient", type: "genre" });
+    assert.equal(out.broadened, false);
+    assert.deepEqual(out.candidates, []);
+    assert.match(out.message ?? "", /No results for/i);
+});
+test("includeStreaming samples a track mix across genre-relevant albums", async () => {
+    const albums = {
+        title: "Albums",
+        key: "g:albums",
+        items: [leaf("Selected Ambient Works", "al:saw"), leaf("Ambient Avenue", "al:ave")],
+    };
+    // Each album drills into its own track list.
+    const drills = {
+        "al:saw": [leaf("Xtal", "t:xtal"), leaf("Ageispolis", "t:age")],
+        "al:ave": [leaf("Fire Ant", "t:fire"), leaf("Jealous", "t:jeal")],
+    };
+    const svc = buildService([albums], undefined, drills);
+    const out = await svc.searchMusic({ query: "Ambient", type: "genre", includeStreaming: true });
+    // No library genre tree in the fake, so the candidates are purely streaming.
+    assert.ok(out.candidates.length > 0);
+    assert.ok(out.candidates.every((c) => c.type === "track"));
+    assert.ok(out.candidates.every((c) => c.sourceGroup === "Streaming"));
+    // The mix spreads across both albums (locator `i` is the album index), not
+    // just the first — that's the whole point versus returning one album.
+    const albumIndices = new Set(out.candidates.map((c) => {
+        const loc = decodeLocator(c.itemKey);
+        assert.ok(loc && !isGenreLocator(loc) && typeof loc.t === "number");
+        return loc.i;
+    }));
+    assert.ok(albumIndices.size >= 2);
+});
+test("includeStreaming is ignored for non-genre searches", async () => {
+    const svc = buildService([ARTISTS]);
+    const out = await svc.searchMusic({ query: "Tycho", type: "artist", includeStreaming: true });
+    assert.ok(out.candidates.every((c) => c.type === "artist"));
+});
+test("limit caps the number of returned candidates", async () => {
+    const many = {
+        title: "Tracks",
+        key: "g:tracks",
+        items: Array.from({ length: 20 }, (_, i) => item(`Track ${i}`, `t:${i}`)),
+    };
+    const svc = buildService([many]);
+    const out = await svc.searchMusic({ query: "Track", limit: 5 });
+    assert.equal(out.candidates.length, 5);
+});
+test("a message action yields an empty result without throwing", async () => {
+    const svc = buildService([ARTISTS], { messageOnInput: "No results found." });
+    const out = await svc.searchMusic({ query: "zzz" });
+    assert.deepEqual(out.candidates, []);
+    assert.equal(out.message, "No results found.");
+});
+test("a single failing group is skipped, others still return", async () => {
+    const svc = buildService([{ ...ARTISTS, failDrill: true }, GENRES]);
+    const out = await svc.searchMusic({ query: "Dark Ambient" });
+    assert.ok(out.candidates.some((c) => c.title === "Dark Ambient"));
+    assert.ok(out.candidates.every((c) => c.title !== "Tycho"));
+});
+test("an InvalidItemKey on submit triggers one reset-and-retry", async () => {
+    const svc = buildService([ARTISTS], { failInputTimes: 1 });
+    const out = await svc.searchMusic({ query: "Tycho" });
+    assert.equal(out.candidates[0]?.title, "Tycho");
+});
+//# sourceMappingURL=SearchService.test.js.map

package/dist/SearchService.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchService.test.js","sourceRoot":"","sources":["../src/SearchService.test.ts"],"names":[],"mappings":"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"}

package/dist/TrackExpansionService.d.ts

@@ -0,0 +1,75 @@
+import type { BrowseResultBody } from "node-roon-api-browse";
+import { BrowseSessionManager } from "./BrowseSessionManager.js";
+import { type Locator } from "./locator.js";
+import { type GetTracksForInput, type GetTracksForOutput } from "./types.js";
+/**
+ * Per-album track budget when spreading a total `limit` across `count` albums,
+ * so the result draws from several albums rather than draining the first. At
+ * least 1 each.
+ */
+export declare function perAlbumBudget(limit: number, count: number): number;
+/** Expands a search candidate (artist/album/genre/playlist/track) into tracks. */
+export declare class TrackExpansionService {
+    private readonly browse;
+    private readonly navigator;
+    constructor(browse: BrowseSessionManager);
+    getTracksFor(input: GetTracksForInput): Promise<GetTracksForOutput>;
+    /**
+     * Navigate to a single track for playback and browse *into* it, returning its
+     * action menu. For a track locator (`t` set) this re-derives the same ordered
+     * track list `get_tracks_for` produced and opens entry `t`. Compose inside
+     * `runExclusive`. Throws INVALID_ITEM_KEY if the track no longer resolves.
+     */
+    openTrackForPlayback(loc: Locator): Promise<BrowseResultBody>;
+    /**
+     * Classify an opened item and locate its tracks. Leaves the session at the
+     * track list for the `list` case. Mirrors the shapes Roon returns:
+     *   A. a single playable track (children are its action menu)
+     *   B. tracks directly under the item (album/playlist track list)
+     *   C. tracks one level down a "Top Tracks"-style container (streaming
+     *      artist page), or — for a purely local library with no track section —
+     *      the artist's top album drilled into its own track list.
+     *
+     * For (C) we drill a single container (the labelled track list if present,
+     * else the top album), keeping the resolution a single live list that the
+     * {q,g,i,t} locator and `openTrackForPlayback` rely on: `t` indexes that one
+     * ordered list, and re-resolving re-derives it with live keys. (Genres, which
+     * have no track list of their own, are expanded across albums via
+     * `collectGenreAlbumTracks` before this is reached.)
+     */
+    private resolveTracks;
+    /**
+     * Gather a genre's tracks by drilling its "Albums" container and visiting each
+     * album in turn, spreading the budget across albums (so the result isn't just
+     * the first album's tracks). Each track carries its (album, track) coordinates
+     * so the `{ ge, a, t }` locator re-navigates to it. The session must be
+     * positioned on the genre page; album-list keys survive drilling+popping a
+     * sibling (same pattern as SearchService.collectFromGroups), so one pass
+     * collects across albums with live keys.
+     */
+    private collectGenreAlbumTracks;
+    /** Re-navigate a genre track locator to a live key for playback (album→track). */
+    private openGenreTrack;
+    /**
+     * From a genre page (session already positioned there), drill its "Albums"
+     * container and return the album containers, leaving the session on the album
+     * list. Returns [] when there's no Albums container.
+     */
+    private openGenreAlbums;
+    /**
+     * Pull ordered track items out of a loaded list. When the list is split into
+     * header sections, prefer a "Top Tracks"/"Tracks" section. When there are no
+     * headers at all, treat the children as tracks (correct for album/playlist
+     * track lists). When several sections exist but none is clearly a track
+     * section, return nothing rather than guess albums as tracks — the caller
+     * then drills via findTrackContainer.
+     */
+    private extractTracks;
+    /**
+     * Find a sub-list to drill into for tracks: a "Top Tracks"-like container if
+     * one is present, else the top album (first navigable container). Only
+     * containers (`hint: "list"`) qualify — a bare track leaf would yield its
+     * action menu, not a track list.
+     */
+    private findTrackContainer;
+}

package/dist/TrackExpansionService.js

@@ -0,0 +1,337 @@
+import { encodeGenreLocator, encodeLocator, hierarchyForLocator, isGenreLocator, withTrackIndex, } from "./locator.js";
+import { SearchNavigator, requireLocator } from "./SearchNavigator.js";
+import { RoonMcpError, } from "./types.js";
+const DEFAULT_LIMIT = 10;
+const MAX_LIMIT = 50;
+// Roon track lists can be long; scan generously so a track section isn't cut.
+const SCAN_COUNT = 100;
+// English section/container titles that hold tracks. Localization is an open
+// plan item (mirrors SearchService's GROUP_TITLE_TO_TYPE / PlaybackService's
+// PLAY_LABELS caveat): non-English Cores need locale-aware matching here.
+const TRACK_SECTION_LABELS = ["top tracks", "tracks", "popular", "songs"];
+// A genre page has no track list of its own — just "Artists"/"Albums"
+// containers and sub-genres. To expand a genre into tracks we drill its
+// "Albums" container and then its first album's track list. English-only, same
+// caveat as TRACK_SECTION_LABELS.
+const ALBUMS_CONTAINER_LABEL = "albums";
+// Leading "Play …"/"Shuffle" shortcut rows that play a whole album/artist/
+// playlist rather than an individual track. They share the `action_list` hint
+// with real track rows (both open an action menu), so they can't be told apart
+// by hint and are excluded by title instead. English-only — same localization
+// caveat as TRACK_SECTION_LABELS and PlaybackService's PLAY_LABELS.
+const PLAY_ACTION_LABELS = [
+    "play now",
+    "play album",
+    "play artist",
+    "play genre",
+    "play playlist",
+    "play track",
+    "play",
+    "shuffle",
+    "start radio",
+];
+function normalize(text) {
+    return text.trim().toLowerCase();
+}
+/**
+ * Per-album track budget when spreading a total `limit` across `count` albums,
+ * so the result draws from several albums rather than draining the first. At
+ * least 1 each.
+ */
+export function perAlbumBudget(limit, count) {
+    return Math.max(1, Math.ceil(limit / Math.min(count, limit)));
+}
+/** A "Play Album"/"Play Artist"/"Shuffle"-style whole-container action, not a track. */
+function isPlayAction(item) {
+    return PLAY_ACTION_LABELS.includes(normalize(item.title));
+}
+/**
+ * A single playable track. Roon item hints are
+ * `null | action | action_list | list | header`. A track row is either a
+ * generic leaf (`null`) or — more commonly in real Cores — an `action_list`
+ * row that opens its Play/Queue menu when selected. We therefore *include*
+ * `action_list` rows but reject:
+ *   - `"list"` rows, which are sub-lists (albums, "Top Tracks" containers) to
+ *     drill via `findTrackContainer` rather than tracks themselves;
+ *   - `"header"`/`"action"` rows (structural / individual menu actions);
+ *   - leading "Play …"/"Shuffle" shortcut rows, which share the `action_list`
+ *     hint with tracks but play the whole container.
+ */
+function isTrackLeaf(item) {
+    if (!item.item_key)
+        return false;
+    if (item.hint === "header" || item.hint === "action" || item.hint === "list")
+        return false;
+    return !isPlayAction(item);
+}
+/** A navigable sub-list to drill into (an album, or a "Top Tracks" container). */
+function isContainer(item) {
+    return Boolean(item.item_key) && item.hint === "list";
+}
+/**
+ * True when the opened item is itself a single playable leaf: drilling into a
+ * track yields its action menu (Play Now, Queue, …) rather than a child list.
+ */
+function looksLikeActionList(list, items) {
+    if (list?.hint === "action_list")
+        return true;
+    const selectable = items.filter((i) => i.item_key && i.hint !== "header");
+    return selectable.length > 0 && selectable.every((i) => i.hint === "action");
+}
+/** Roon track subtitles are typically the artist (sometimes "Artist / Album"). */
+function toTrackMeta(item) {
+    const artist = item.subtitle?.split(" / ")[0]?.trim() || undefined;
+    return { title: item.title, artist };
+}
+/** Expands a search candidate (artist/album/genre/playlist/track) into tracks. */
+export class TrackExpansionService {
+    browse;
+    navigator;
+    constructor(browse) {
+        this.browse = browse;
+        this.navigator = new SearchNavigator(browse);
+    }
+    async getTracksFor(input) {
+        const limit = Math.min(Math.max(input.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);
+        const loc = requireLocator(input.itemKey);
+        return this.browse.runExclusive(async () => {
+            try {
+                const hierarchy = hierarchyForLocator(loc);
+                const opened = await this.navigator.openItem(loc);
+                if (opened.action === "message")
+                    return notExpandable(input.itemKey, opened.message);
+                // A genre has no track list of its own; gather tracks across its albums,
+                // each keyed by an (album, track) genre locator.
+                if (isGenreLocator(loc)) {
+                    const collected = await this.collectGenreAlbumTracks(hierarchy, limit);
+                    if (collected.length === 0) {
+                        return notExpandable(input.itemKey, "No albums with tracks were found for this genre.");
+                    }
+                    const tracks = collected.map(({ item, a, t }) => ({
+                        itemKey: encodeGenreLocator(loc.ge, { a, t }),
+                        ...toTrackMeta(item),
+                        available: true,
+                    }));
+                    return { sourceItemKey: input.itemKey, tracks, skipped: [] };
+                }
+                const resolved = await this.resolveTracks(hierarchy, opened);
+                if (resolved.kind === "none")
+                    return notExpandable(input.itemKey, resolved.reason);
+                if (resolved.kind === "self") {
+                    // The candidate is a single track; key it by its own (t-less) locator.
+                    return {
+                        sourceItemKey: input.itemKey,
+                        tracks: [{ itemKey: input.itemKey, title: resolved.title, available: true }],
+                        skipped: [],
+                    };
+                }
+                const tracks = resolved.items.slice(0, limit).map((item, t) => ({
+                    itemKey: encodeLocator(withTrackIndex(loc, t)),
+                    ...toTrackMeta(item),
+                    available: true,
+                }));
+                return { sourceItemKey: input.itemKey, tracks, skipped: [] };
+            }
+            catch (err) {
+                // A stale/invalid locator can't be retried; report it as skipped so the
+                // agent can re-search instead of throwing.
+                if (err instanceof RoonMcpError && err.code === "INVALID_ITEM_KEY") {
+                    return {
+                        sourceItemKey: input.itemKey,
+                        tracks: [],
+                        skipped: [{ itemKey: input.itemKey, reason: err.message }],
+                    };
+                }
+                throw err;
+            }
+        });
+    }
+    /**
+     * Navigate to a single track for playback and browse *into* it, returning its
+     * action menu. For a track locator (`t` set) this re-derives the same ordered
+     * track list `get_tracks_for` produced and opens entry `t`. Compose inside
+     * `runExclusive`. Throws INVALID_ITEM_KEY if the track no longer resolves.
+     */
+    async openTrackForPlayback(loc) {
+        const hierarchy = hierarchyForLocator(loc);
+        if (loc.t === undefined)
+            return this.navigator.openItem(loc); // candidate is itself the track
+        // Genre tracks live two levels down (album, track); re-navigate there.
+        if (isGenreLocator(loc))
+            return this.openGenreTrack(loc, hierarchy);
+        const opened = await this.navigator.openItem(loc);
+        if (opened.action === "message") {
+            throw new RoonMcpError("INVALID_ITEM_KEY", opened.message ?? "Track is no longer available.");
+        }
+        const resolved = await this.resolveTracks(hierarchy, opened);
+        if (resolved.kind !== "list" || !resolved.items[loc.t]?.item_key) {
+            throw new RoonMcpError("INVALID_ITEM_KEY", "That track is no longer available; re-run get_tracks_for to refresh it.");
+        }
+        return this.browse.browse({
+            hierarchy,
+            item_key: resolved.items[loc.t].item_key,
+        });
+    }
+    /**
+     * Classify an opened item and locate its tracks. Leaves the session at the
+     * track list for the `list` case. Mirrors the shapes Roon returns:
+     *   A. a single playable track (children are its action menu)
+     *   B. tracks directly under the item (album/playlist track list)
+     *   C. tracks one level down a "Top Tracks"-style container (streaming
+     *      artist page), or — for a purely local library with no track section —
+     *      the artist's top album drilled into its own track list.
+     *
+     * For (C) we drill a single container (the labelled track list if present,
+     * else the top album), keeping the resolution a single live list that the
+     * {q,g,i,t} locator and `openTrackForPlayback` rely on: `t` indexes that one
+     * ordered list, and re-resolving re-derives it with live keys. (Genres, which
+     * have no track list of their own, are expanded across albums via
+     * `collectGenreAlbumTracks` before this is reached.)
+     */
+    async resolveTracks(hierarchy, opened) {
+        const loaded = await this.browse.load({
+            hierarchy,
+            offset: 0,
+            count: SCAN_COUNT,
+        });
+        if (looksLikeActionList(loaded.list, loaded.items)) {
+            return { kind: "self", title: opened.item?.title ?? loaded.list?.title ?? "Unknown track" };
+        }
+        const direct = this.extractTracks(loaded.items);
+        if (direct.length > 0)
+            return { kind: "list", items: direct };
+        const container = this.findTrackContainer(loaded.items);
+        if (container?.item_key) {
+            await this.browse.browse({ hierarchy, item_key: container.item_key });
+            const sub = await this.browse.load({
+                hierarchy,
+                offset: 0,
+                count: SCAN_COUNT,
+            });
+            const tracks = this.extractTracks(sub.items);
+            if (tracks.length > 0)
+                return { kind: "list", items: tracks };
+        }
+        return { kind: "none", reason: "No playable tracks were found for this item." };
+    }
+    /**
+     * Gather a genre's tracks by drilling its "Albums" container and visiting each
+     * album in turn, spreading the budget across albums (so the result isn't just
+     * the first album's tracks). Each track carries its (album, track) coordinates
+     * so the `{ ge, a, t }` locator re-navigates to it. The session must be
+     * positioned on the genre page; album-list keys survive drilling+popping a
+     * sibling (same pattern as SearchService.collectFromGroups), so one pass
+     * collects across albums with live keys.
+     */
+    async collectGenreAlbumTracks(hierarchy, limit) {
+        const albums = await this.openGenreAlbums(hierarchy);
+        if (albums.length === 0)
+            return [];
+        const out = [];
+        const spread = perAlbumBudget(limit, albums.length);
+        for (let a = 0; a < albums.length && out.length < limit; a++) {
+            const album = albums[a];
+            if (!album.item_key)
+                continue;
+            await this.browse.browse({ hierarchy, item_key: album.item_key });
+            const trackList = await this.browse.load({ hierarchy, offset: 0, count: SCAN_COUNT });
+            const tracks = this.extractTracks(trackList.items);
+            for (let t = 0; t < tracks.length && t < spread && out.length < limit; t++) {
+                out.push({ item: tracks[t], a, t });
+            }
+            // Level-scoped keys: pop back to the album list before the next album.
+            await this.browse.browse({ hierarchy, pop_levels: 1 });
+        }
+        return out;
+    }
+    /** Re-navigate a genre track locator to a live key for playback (album→track). */
+    async openGenreTrack(loc, hierarchy) {
+        const opened = await this.navigator.openItem(loc);
+        if (opened.action === "message") {
+            throw new RoonMcpError("INVALID_ITEM_KEY", opened.message ?? "Track is no longer available.");
+        }
+        const albums = await this.openGenreAlbums(hierarchy);
+        const album = albums[loc.a ?? 0];
+        if (!album?.item_key)
+            throw staleGenreTrack();
+        await this.browse.browse({ hierarchy, item_key: album.item_key });
+        const trackList = await this.browse.load({ hierarchy, offset: 0, count: SCAN_COUNT });
+        const track = this.extractTracks(trackList.items)[loc.t];
+        if (!track?.item_key)
+            throw staleGenreTrack();
+        return this.browse.browse({ hierarchy, item_key: track.item_key });
+    }
+    /**
+     * From a genre page (session already positioned there), drill its "Albums"
+     * container and return the album containers, leaving the session on the album
+     * list. Returns [] when there's no Albums container.
+     */
+    async openGenreAlbums(hierarchy) {
+        const page = await this.browse.load({ hierarchy, offset: 0, count: SCAN_COUNT });
+        const albumsContainer = page.items.find((i) => isContainer(i) && normalize(i.title) === ALBUMS_CONTAINER_LABEL);
+        if (!albumsContainer?.item_key)
+            return [];
+        await this.browse.browse({ hierarchy, item_key: albumsContainer.item_key });
+        const albumList = await this.browse.load({ hierarchy, offset: 0, count: SCAN_COUNT });
+        return albumList.items.filter(isContainer);
+    }
+    /**
+     * Pull ordered track items out of a loaded list. When the list is split into
+     * header sections, prefer a "Top Tracks"/"Tracks" section. When there are no
+     * headers at all, treat the children as tracks (correct for album/playlist
+     * track lists). When several sections exist but none is clearly a track
+     * section, return nothing rather than guess albums as tracks — the caller
+     * then drills via findTrackContainer.
+     */
+    extractTracks(items) {
+        const sections = splitByHeaders(items);
+        const trackSection = sections.find((s) => s.header && TRACK_SECTION_LABELS.some((l) => normalize(s.header).startsWith(l)));
+        const chosen = trackSection ?? (sections.length === 1 ? sections[0] : undefined);
+        if (!chosen)
+            return [];
+        return chosen.items.filter(isTrackLeaf);
+    }
+    /**
+     * Find a sub-list to drill into for tracks: a "Top Tracks"-like container if
+     * one is present, else the top album (first navigable container). Only
+     * containers (`hint: "list"`) qualify — a bare track leaf would yield its
+     * action menu, not a track list.
+     */
+    findTrackContainer(items) {
+        const containers = items.filter(isContainer);
+        for (const label of TRACK_SECTION_LABELS) {
+            const hit = containers.find((c) => normalize(c.title).startsWith(label));
+            if (hit)
+                return hit;
+        }
+        return containers[0] ?? null;
+    }
+}
+function splitByHeaders(items) {
+    const sections = [];
+    let current = { items: [] };
+    for (const item of items) {
+        if (item.hint === "header") {
+            if (current.header !== undefined || current.items.length > 0)
+                sections.push(current);
+            current = { header: item.title, items: [] };
+        }
+        else {
+            current.items.push(item);
+        }
+    }
+    if (current.header !== undefined || current.items.length > 0)
+        sections.push(current);
+    return sections;
+}
+function staleGenreTrack() {
+    return new RoonMcpError("INVALID_ITEM_KEY", "That genre track is no longer available; re-run get_tracks_for to refresh it.");
+}
+function notExpandable(itemKey, reason) {
+    return {
+        sourceItemKey: itemKey,
+        tracks: [],
+        skipped: [{ itemKey, reason: `NOT_EXPANDABLE: ${reason ?? "item cannot be expanded into tracks."}` }],
+    };
+}
+//# sourceMappingURL=TrackExpansionService.js.map

package/dist/TrackExpansionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackExpansionService.js","sourceRoot":"","sources":["../src/TrackExpansionService.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,cAAc,GAGf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,YAAY,GAIb,MAAM,YAAY,CAAC;AAEpB,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,8EAA8E;AAC9E,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAE1E,sEAAsE;AACtE,wEAAwE;AACxE,+EAA+E;AAC/E,kCAAkC;AAClC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAExC,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,oEAAoE;AACpE,MAAM,kBAAkB,GAAG;IACzB,UAAU;IACV,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,eAAe;IACf,YAAY;IACZ,MAAM;IACN,SAAS;IACT,aAAa;CACd,CAAC;AAEF,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,wFAAwF;AACxF,SAAS,YAAY,CAAC,IAAgB;IACpC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,WAAW,CAAC,IAAgB;IACnC,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC3F,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,kFAAkF;AAClF,SAAS,WAAW,CAAC,IAAgB;IACnC,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,IAA4B,EAAE,KAAmB;IAC5E,IAAI,IAAI,EAAE,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC1E,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,kFAAkF;AAClF,SAAS,WAAW,CAAC,IAAgB;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACnE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAaD,kFAAkF;AAClF,MAAM,OAAO,qBAAqB;IAGH;IAFZ,SAAS,CAAkB;IAE5C,YAA6B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;QACvD,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwB;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE1C,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAClD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;oBAAE,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAErF,yEAAyE;gBACzE,iDAAiD;gBACjD,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;oBACvE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC3B,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,kDAAkD,CAAC,CAAC;oBAC1F,CAAC;oBACD,MAAM,MAAM,GAAqB,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAClE,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;wBAC7C,GAAG,WAAW,CAAC,IAAI,CAAC;wBACpB,SAAS,EAAE,IAAI;qBAChB,CAAC,CAAC,CAAC;oBACJ,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;gBAC/D,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC7D,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnF,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC7B,uEAAuE;oBACvE,OAAO;wBACL,aAAa,EAAE,KAAK,CAAC,OAAO;wBAC5B,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;wBAC5E,OAAO,EAAE,EAAE;qBACZ,CAAC;gBACJ,CAAC;gBAED,MAAM,MAAM,GAAqB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChF,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;oBAC9C,GAAG,WAAW,CAAC,IAAI,CAAC;oBACpB,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC,CAAC;gBACJ,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC/D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,wEAAwE;gBACxE,2CAA2C;gBAC3C,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBACnE,OAAO;wBACL,aAAa,EAAE,KAAK,CAAC,OAAO;wBAC5B,MAAM,EAAE,EAAE;wBACV,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;qBAC3D,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CAAC,GAAY;QACrC,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,gCAAgC;QAE9F,uEAAuE;QACvE,IAAI,cAAc,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,IAAI,+BAA+B,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;YACjE,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACxB,SAAS;YACT,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,QAAS;SAC3C,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACK,KAAK,CAAC,aAAa,CACzB,SAA0B,EAC1B,MAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACpC,SAAS;YACT,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QAEH,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,eAAe,EAAE,CAAC;QAC9F,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAE9D,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,SAAS,EAAE,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACjC,SAAS;gBACT,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAChE,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,uBAAuB,CACnC,SAA0B,EAC1B,KAAa;QAEb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,GAAG,GAAsD,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,SAAS;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,uEAAuE;YACvE,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kFAAkF;IAC1E,KAAK,CAAC,cAAc,CAC1B,GAAiB,EACjB,SAA0B;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,IAAI,+BAA+B,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,QAAQ;YAAE,MAAM,eAAe,EAAE,CAAC;QAE9C,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,EAAE,QAAQ;YAAE,MAAM,eAAe,EAAE,CAAC;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,eAAe,CAAC,SAA0B;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,sBAAsB,CACvE,CAAC;QACF,IAAI,CAAC,eAAe,EAAE,QAAQ;YAAE,OAAO,EAAE,CAAC;QAE1C,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACtF,OAAO,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACK,aAAa,CAAC,KAAmB;QACvC,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,MAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACxF,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACK,kBAAkB,CAAC,KAAmB;QAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,oBAAoB,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YACzE,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC/B,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAmB;IACzC,MAAM,QAAQ,GAAoD,EAAE,CAAC;IACrE,IAAI,OAAO,GAA6C,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrF,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,IAAI,YAAY,CACrB,kBAAkB,EAClB,+EAA+E,CAChF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,MAAe;IACrD,OAAO;QACL,aAAa,EAAE,OAAO;QACtB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,MAAM,IAAI,sCAAsC,EAAE,EAAE,CAAC;KACtG,CAAC;AACJ,CAAC"}

package/dist/TrackExpansionService.test.d.ts

@@ -0,0 +1 @@
+export {};