@darrenjaws/spotify-mcp 0.4.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -95
- package/build/index.js +4 -0
- package/build/index.js.map +1 -1
- package/build/spotify/errors.d.ts +11 -0
- package/build/spotify/errors.d.ts.map +1 -0
- package/build/spotify/errors.js +61 -0
- package/build/spotify/errors.js.map +1 -0
- package/build/tools/playback.d.ts +1 -0
- package/build/tools/playback.d.ts.map +1 -1
- package/build/tools/playback.js +255 -124
- package/build/tools/playback.js.map +1 -1
- package/build/tools/playlists.d.ts.map +1 -1
- package/build/tools/playlists.js +84 -63
- package/build/tools/playlists.js.map +1 -1
- package/build/tools/search.d.ts.map +1 -1
- package/build/tools/search.js +53 -47
- package/build/tools/search.js.map +1 -1
- package/build/tools/user.d.ts.map +1 -1
- package/build/tools/user.js +84 -68
- package/build/tools/user.js.map +1 -1
- package/package.json +3 -2
- package/build/handlers/call-tool.d.ts +0 -6
- package/build/handlers/call-tool.d.ts.map +0 -1
- package/build/handlers/call-tool.js +0 -46
- package/build/handlers/call-tool.js.map +0 -1
- package/build/handlers/tools.d.ts +0 -296
- package/build/handlers/tools.d.ts.map +0 -1
- package/build/handlers/tools.js +0 -246
- package/build/handlers/tools.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playlists.js","sourceRoot":"","sources":["../../src/tools/playlists.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"playlists.js","sourceRoot":"","sources":["../../src/tools/playlists.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;
|
|
1
|
+
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAkEpE"}
|
package/build/tools/search.js
CHANGED
|
@@ -2,61 +2,67 @@
|
|
|
2
2
|
* Search tools
|
|
3
3
|
*/
|
|
4
4
|
import { getAuthenticatedClient } from "../spotify/client.js";
|
|
5
|
+
import { handleToolError } from "../spotify/errors.js";
|
|
5
6
|
export async function search(args) {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
7
|
+
try {
|
|
8
|
+
const client = await getAuthenticatedClient();
|
|
9
|
+
const limit = args.limit || 10;
|
|
10
|
+
const result = await client.search(args.query, [args.type], { limit });
|
|
11
|
+
let items = [];
|
|
12
|
+
let itemType = "";
|
|
13
|
+
switch (args.type) {
|
|
14
|
+
case "track":
|
|
15
|
+
items = result.body.tracks?.items || [];
|
|
16
|
+
itemType = "tracks";
|
|
17
|
+
break;
|
|
18
|
+
case "album":
|
|
19
|
+
items = result.body.albums?.items || [];
|
|
20
|
+
itemType = "albums";
|
|
21
|
+
break;
|
|
22
|
+
case "artist":
|
|
23
|
+
items = result.body.artists?.items || [];
|
|
24
|
+
itemType = "artists";
|
|
25
|
+
break;
|
|
26
|
+
case "playlist":
|
|
27
|
+
items = result.body.playlists?.items || [];
|
|
28
|
+
itemType = "playlists";
|
|
29
|
+
break;
|
|
30
|
+
}
|
|
31
|
+
if (items.length === 0) {
|
|
32
|
+
return {
|
|
33
|
+
content: [
|
|
34
|
+
{
|
|
35
|
+
type: "text",
|
|
36
|
+
text: `No ${itemType} found for query: "${args.query}"`,
|
|
37
|
+
},
|
|
38
|
+
],
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
const formatted = items.map((item, index) => {
|
|
42
|
+
switch (args.type) {
|
|
43
|
+
case "track":
|
|
44
|
+
return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")} (${item.uri})`;
|
|
45
|
+
case "album":
|
|
46
|
+
return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")} (${item.uri})`;
|
|
47
|
+
case "artist":
|
|
48
|
+
return `${index + 1}. ${item.name} (${item.uri})`;
|
|
49
|
+
case "playlist":
|
|
50
|
+
return `${index + 1}. ${item.name} - ${item.owner.display_name} (${item.tracks.total} tracks) (${item.uri})`;
|
|
51
|
+
default:
|
|
52
|
+
return `${index + 1}. ${item.name}`;
|
|
53
|
+
}
|
|
54
|
+
});
|
|
30
55
|
return {
|
|
31
56
|
content: [
|
|
32
57
|
{
|
|
33
58
|
type: "text",
|
|
34
|
-
text: `
|
|
59
|
+
text: `Found ${items.length} ${itemType} for "${args.query}":\n\n${formatted.join("\n")}`,
|
|
35
60
|
},
|
|
36
61
|
],
|
|
37
62
|
};
|
|
38
63
|
}
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")} (${item.uri})`;
|
|
43
|
-
case "album":
|
|
44
|
-
return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")} (${item.uri})`;
|
|
45
|
-
case "artist":
|
|
46
|
-
return `${index + 1}. ${item.name} (${item.uri})`;
|
|
47
|
-
case "playlist":
|
|
48
|
-
return `${index + 1}. ${item.name} - ${item.owner.display_name} (${item.tracks.total} tracks) (${item.uri})`;
|
|
49
|
-
default:
|
|
50
|
-
return `${index + 1}. ${item.name}`;
|
|
51
|
-
}
|
|
52
|
-
});
|
|
53
|
-
return {
|
|
54
|
-
content: [
|
|
55
|
-
{
|
|
56
|
-
type: "text",
|
|
57
|
-
text: `Found ${items.length} ${itemType} for "${args.query}":\n\n${formatted.join("\n")}`,
|
|
58
|
-
},
|
|
59
|
-
],
|
|
60
|
-
};
|
|
64
|
+
catch (error) {
|
|
65
|
+
return handleToolError(error, "spotify_search");
|
|
66
|
+
}
|
|
61
67
|
}
|
|
62
68
|
//# sourceMappingURL=search.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA;;GAEG;
|
|
1
|
+
{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElF,wBAAsB,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CA0B5D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAwD3E;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoCvF"}
|
package/build/tools/user.js
CHANGED
|
@@ -2,102 +2,118 @@
|
|
|
2
2
|
* User data tools
|
|
3
3
|
*/
|
|
4
4
|
import { getAuthenticatedClient } from "../spotify/client.js";
|
|
5
|
+
import { handleToolError } from "../spotify/errors.js";
|
|
5
6
|
export async function getUserProfile() {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
7
|
+
try {
|
|
8
|
+
const client = await getAuthenticatedClient();
|
|
9
|
+
const result = await client.getMe();
|
|
10
|
+
const user = result.body;
|
|
11
|
+
const text = `User Profile:
|
|
10
12
|
Name: ${user.display_name || "N/A"}
|
|
11
13
|
Email: ${user.email || "N/A"}
|
|
12
14
|
Country: ${user.country || "N/A"}
|
|
13
15
|
Product: ${user.product || "N/A"}
|
|
14
16
|
Followers: ${user.followers?.total || 0}
|
|
15
17
|
User ID: ${user.id}`;
|
|
16
|
-
return {
|
|
17
|
-
content: [
|
|
18
|
-
{
|
|
19
|
-
type: "text",
|
|
20
|
-
text,
|
|
21
|
-
},
|
|
22
|
-
],
|
|
23
|
-
};
|
|
24
|
-
}
|
|
25
|
-
export async function getTopItems(args) {
|
|
26
|
-
const client = await getAuthenticatedClient();
|
|
27
|
-
const limit = args.limit || 20;
|
|
28
|
-
const timeRange = args.time_range || "medium_term";
|
|
29
|
-
let result;
|
|
30
|
-
let items = [];
|
|
31
|
-
let itemType = "";
|
|
32
|
-
if (args.type === "artists") {
|
|
33
|
-
result = await client.getMyTopArtists({ limit, time_range: timeRange });
|
|
34
|
-
items = result.body.items;
|
|
35
|
-
itemType = "artists";
|
|
36
|
-
}
|
|
37
|
-
else {
|
|
38
|
-
result = await client.getMyTopTracks({ limit, time_range: timeRange });
|
|
39
|
-
items = result.body.items;
|
|
40
|
-
itemType = "tracks";
|
|
41
|
-
}
|
|
42
|
-
if (items.length === 0) {
|
|
43
18
|
return {
|
|
44
19
|
content: [
|
|
45
20
|
{
|
|
46
21
|
type: "text",
|
|
47
|
-
text
|
|
22
|
+
text,
|
|
48
23
|
},
|
|
49
24
|
],
|
|
50
25
|
};
|
|
51
26
|
}
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
27
|
+
catch (error) {
|
|
28
|
+
return handleToolError(error, "spotify_get_user_profile");
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
export async function getTopItems(args) {
|
|
32
|
+
try {
|
|
33
|
+
const client = await getAuthenticatedClient();
|
|
34
|
+
const limit = args.limit || 20;
|
|
35
|
+
const timeRange = args.time_range || "medium_term";
|
|
36
|
+
let result;
|
|
37
|
+
let items = [];
|
|
38
|
+
let itemType = "";
|
|
58
39
|
if (args.type === "artists") {
|
|
59
|
-
|
|
40
|
+
result = await client.getMyTopArtists({ limit, time_range: timeRange });
|
|
41
|
+
items = result.body.items;
|
|
42
|
+
itemType = "artists";
|
|
60
43
|
}
|
|
61
44
|
else {
|
|
62
|
-
|
|
45
|
+
result = await client.getMyTopTracks({ limit, time_range: timeRange });
|
|
46
|
+
items = result.body.items;
|
|
47
|
+
itemType = "tracks";
|
|
48
|
+
}
|
|
49
|
+
if (items.length === 0) {
|
|
50
|
+
return {
|
|
51
|
+
content: [
|
|
52
|
+
{
|
|
53
|
+
type: "text",
|
|
54
|
+
text: `No top ${itemType} found`,
|
|
55
|
+
},
|
|
56
|
+
],
|
|
57
|
+
};
|
|
63
58
|
}
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
59
|
+
const timeRangeText = {
|
|
60
|
+
short_term: "last 4 weeks",
|
|
61
|
+
medium_term: "last 6 months",
|
|
62
|
+
long_term: "all time",
|
|
63
|
+
}[timeRange];
|
|
64
|
+
const formatted = items.map((item, index) => {
|
|
65
|
+
if (args.type === "artists") {
|
|
66
|
+
return `${index + 1}. ${item.name} (${item.genres.slice(0, 2).join(", ")})`;
|
|
67
|
+
}
|
|
68
|
+
else {
|
|
69
|
+
return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")}`;
|
|
70
|
+
}
|
|
71
|
+
});
|
|
72
|
+
return {
|
|
73
|
+
content: [
|
|
74
|
+
{
|
|
75
|
+
type: "text",
|
|
76
|
+
text: `Your top ${itemType} (${timeRangeText}):\n\n${formatted.join("\n")}`,
|
|
77
|
+
},
|
|
78
|
+
],
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
catch (error) {
|
|
82
|
+
return handleToolError(error, "spotify_get_top_items");
|
|
83
|
+
}
|
|
73
84
|
}
|
|
74
85
|
export async function getRecentlyPlayed(args) {
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
86
|
+
try {
|
|
87
|
+
const client = await getAuthenticatedClient();
|
|
88
|
+
const limit = args.limit || 20;
|
|
89
|
+
const result = await client.getMyRecentlyPlayedTracks({ limit });
|
|
90
|
+
const items = result.body.items;
|
|
91
|
+
if (items.length === 0) {
|
|
92
|
+
return {
|
|
93
|
+
content: [
|
|
94
|
+
{
|
|
95
|
+
type: "text",
|
|
96
|
+
text: "No recently played tracks found",
|
|
97
|
+
},
|
|
98
|
+
],
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
const formatted = items.map((item, index) => {
|
|
102
|
+
const track = item.track;
|
|
103
|
+
const playedAt = new Date(item.played_at).toLocaleString();
|
|
104
|
+
return `${index + 1}. ${track.name} - ${track.artists.map((a) => a.name).join(", ")} (${playedAt})`;
|
|
105
|
+
});
|
|
80
106
|
return {
|
|
81
107
|
content: [
|
|
82
108
|
{
|
|
83
109
|
type: "text",
|
|
84
|
-
text:
|
|
110
|
+
text: `Recently played tracks:\n\n${formatted.join("\n")}`,
|
|
85
111
|
},
|
|
86
112
|
],
|
|
87
113
|
};
|
|
88
114
|
}
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
return `${index + 1}. ${track.name} - ${track.artists.map((a) => a.name).join(", ")} (${playedAt})`;
|
|
93
|
-
});
|
|
94
|
-
return {
|
|
95
|
-
content: [
|
|
96
|
-
{
|
|
97
|
-
type: "text",
|
|
98
|
-
text: `Recently played tracks:\n\n${formatted.join("\n")}`,
|
|
99
|
-
},
|
|
100
|
-
],
|
|
101
|
-
};
|
|
115
|
+
catch (error) {
|
|
116
|
+
return handleToolError(error, "spotify_get_recently_played");
|
|
117
|
+
}
|
|
102
118
|
}
|
|
103
119
|
//# sourceMappingURL=user.js.map
|
package/build/tools/user.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@darrenjaws/spotify-mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Model Context Protocol server for Spotify integration",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -15,7 +15,8 @@
|
|
|
15
15
|
"test": "vitest run",
|
|
16
16
|
"test:watch": "vitest",
|
|
17
17
|
"lint": "eslint src --ext .ts",
|
|
18
|
-
"lint:fix": "eslint src --ext .ts --fix"
|
|
18
|
+
"lint:fix": "eslint src --ext .ts --fix",
|
|
19
|
+
"static-checks": "npm run lint && npm run build && npm test"
|
|
19
20
|
},
|
|
20
21
|
"keywords": [
|
|
21
22
|
"mcp",
|
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Tool call handler - routes tool calls to appropriate implementations
|
|
3
|
-
*/
|
|
4
|
-
import type { ToolResponse } from "../types.js";
|
|
5
|
-
export declare function handleToolCall(name: string, args: Record<string, any>): Promise<ToolResponse>;
|
|
6
|
-
//# sourceMappingURL=call-tool.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"call-tool.d.ts","sourceRoot":"","sources":["../../src/handlers/call-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAyCnG"}
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Tool call handler - routes tool calls to appropriate implementations
|
|
3
|
-
*/
|
|
4
|
-
import * as playbackTools from "../tools/playback.js";
|
|
5
|
-
import * as searchTools from "../tools/search.js";
|
|
6
|
-
import * as playlistTools from "../tools/playlists.js";
|
|
7
|
-
import * as userTools from "../tools/user.js";
|
|
8
|
-
export async function handleToolCall(name, args) {
|
|
9
|
-
switch (name) {
|
|
10
|
-
// Playback controls
|
|
11
|
-
case "spotify_play":
|
|
12
|
-
return await playbackTools.play(args);
|
|
13
|
-
case "spotify_pause":
|
|
14
|
-
return await playbackTools.pause(args);
|
|
15
|
-
case "spotify_next":
|
|
16
|
-
return await playbackTools.next(args);
|
|
17
|
-
case "spotify_previous":
|
|
18
|
-
return await playbackTools.previous(args);
|
|
19
|
-
case "spotify_set_volume":
|
|
20
|
-
return await playbackTools.setVolume(args);
|
|
21
|
-
case "spotify_get_playback_state":
|
|
22
|
-
return await playbackTools.getPlaybackState();
|
|
23
|
-
// Search
|
|
24
|
-
case "spotify_search":
|
|
25
|
-
return await searchTools.search(args);
|
|
26
|
-
// Playlists
|
|
27
|
-
case "spotify_get_playlists":
|
|
28
|
-
return await playlistTools.getPlaylists(args);
|
|
29
|
-
case "spotify_get_playlist":
|
|
30
|
-
return await playlistTools.getPlaylist(args);
|
|
31
|
-
case "spotify_create_playlist":
|
|
32
|
-
return await playlistTools.createPlaylist(args);
|
|
33
|
-
case "spotify_add_to_playlist":
|
|
34
|
-
return await playlistTools.addToPlaylist(args);
|
|
35
|
-
// User data
|
|
36
|
-
case "spotify_get_user_profile":
|
|
37
|
-
return await userTools.getUserProfile();
|
|
38
|
-
case "spotify_get_top_items":
|
|
39
|
-
return await userTools.getTopItems(args);
|
|
40
|
-
case "spotify_get_recently_played":
|
|
41
|
-
return await userTools.getRecentlyPlayed(args);
|
|
42
|
-
default:
|
|
43
|
-
throw new Error(`Unknown tool: ${name}`);
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
//# sourceMappingURL=call-tool.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"call-tool.js","sourceRoot":"","sources":["../../src/handlers/call-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,IAAyB;IAC1E,QAAQ,IAAI,EAAE,CAAC;QACb,oBAAoB;QACpB,KAAK,cAAc;YACjB,OAAO,MAAM,aAAa,CAAC,IAAI,CAAC,IAAW,CAAC,CAAC;QAC/C,KAAK,eAAe;YAClB,OAAO,MAAM,aAAa,CAAC,KAAK,CAAC,IAAW,CAAC,CAAC;QAChD,KAAK,cAAc;YACjB,OAAO,MAAM,aAAa,CAAC,IAAI,CAAC,IAAW,CAAC,CAAC;QAC/C,KAAK,kBAAkB;YACrB,OAAO,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAW,CAAC,CAAC;QACnD,KAAK,oBAAoB;YACvB,OAAO,MAAM,aAAa,CAAC,SAAS,CAAC,IAAW,CAAC,CAAC;QACpD,KAAK,4BAA4B;YAC/B,OAAO,MAAM,aAAa,CAAC,gBAAgB,EAAE,CAAC;QAEhD,SAAS;QACT,KAAK,gBAAgB;YACnB,OAAO,MAAM,WAAW,CAAC,MAAM,CAAC,IAAW,CAAC,CAAC;QAE/C,YAAY;QACZ,KAAK,uBAAuB;YAC1B,OAAO,MAAM,aAAa,CAAC,YAAY,CAAC,IAAW,CAAC,CAAC;QACvD,KAAK,sBAAsB;YACzB,OAAO,MAAM,aAAa,CAAC,WAAW,CAAC,IAAW,CAAC,CAAC;QACtD,KAAK,yBAAyB;YAC5B,OAAO,MAAM,aAAa,CAAC,cAAc,CAAC,IAAW,CAAC,CAAC;QACzD,KAAK,yBAAyB;YAC5B,OAAO,MAAM,aAAa,CAAC,aAAa,CAAC,IAAW,CAAC,CAAC;QAExD,YAAY;QACZ,KAAK,0BAA0B;YAC7B,OAAO,MAAM,SAAS,CAAC,cAAc,EAAE,CAAC;QAC1C,KAAK,uBAAuB;YAC1B,OAAO,MAAM,SAAS,CAAC,WAAW,CAAC,IAAW,CAAC,CAAC;QAClD,KAAK,6BAA6B;YAChC,OAAO,MAAM,SAAS,CAAC,iBAAiB,CAAC,IAAW,CAAC,CAAC;QAExD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}
|