@ansango/lastfm-api 3.2.0 → 3.4.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.
Files changed (121) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/README.md +66 -22
  3. package/dist/client.d.ts +2 -1
  4. package/dist/client.d.ts.map +1 -1
  5. package/dist/client.js +3 -1
  6. package/dist/client.js.map +1 -1
  7. package/dist/entrypoints/insights.d.ts +4 -0
  8. package/dist/entrypoints/insights.d.ts.map +1 -0
  9. package/dist/entrypoints/insights.js +3 -0
  10. package/dist/entrypoints/insights.js.map +1 -0
  11. package/dist/entrypoints/insights.schemas.d.ts +2 -0
  12. package/dist/entrypoints/insights.schemas.d.ts.map +1 -0
  13. package/dist/entrypoints/insights.schemas.js +3 -0
  14. package/dist/entrypoints/insights.schemas.js.map +1 -0
  15. package/dist/index.d.ts +4 -2
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +2 -1
  18. package/dist/index.js.map +1 -1
  19. package/dist/services/album.d.ts +2 -4
  20. package/dist/services/album.d.ts.map +1 -1
  21. package/dist/services/album.js.map +1 -1
  22. package/dist/services/artist.d.ts +2 -4
  23. package/dist/services/artist.d.ts.map +1 -1
  24. package/dist/services/artist.js.map +1 -1
  25. package/dist/services/auth.d.ts +1 -38
  26. package/dist/services/auth.d.ts.map +1 -1
  27. package/dist/services/auth.js +1 -19
  28. package/dist/services/auth.js.map +1 -1
  29. package/dist/services/auth.schemas.d.ts +0 -13
  30. package/dist/services/auth.schemas.d.ts.map +1 -1
  31. package/dist/services/auth.schemas.js +0 -7
  32. package/dist/services/auth.schemas.js.map +1 -1
  33. package/dist/services/index.d.ts +2 -0
  34. package/dist/services/index.d.ts.map +1 -1
  35. package/dist/services/index.js +2 -0
  36. package/dist/services/index.js.map +1 -1
  37. package/dist/services/insights/binges.d.ts +8 -0
  38. package/dist/services/insights/binges.d.ts.map +1 -0
  39. package/dist/services/insights/binges.js +53 -0
  40. package/dist/services/insights/binges.js.map +1 -0
  41. package/dist/services/insights/compare.d.ts +8 -0
  42. package/dist/services/insights/compare.d.ts.map +1 -0
  43. package/dist/services/insights/compare.js +39 -0
  44. package/dist/services/insights/compare.js.map +1 -0
  45. package/dist/services/insights/discoveries.d.ts +8 -0
  46. package/dist/services/insights/discoveries.d.ts.map +1 -0
  47. package/dist/services/insights/discoveries.js +53 -0
  48. package/dist/services/insights/discoveries.js.map +1 -0
  49. package/dist/services/insights/hours.d.ts +8 -0
  50. package/dist/services/insights/hours.d.ts.map +1 -0
  51. package/dist/services/insights/hours.js +43 -0
  52. package/dist/services/insights/hours.js.map +1 -0
  53. package/dist/services/insights/lib/binges.d.ts +31 -0
  54. package/dist/services/insights/lib/binges.d.ts.map +1 -0
  55. package/dist/services/insights/lib/binges.js +61 -0
  56. package/dist/services/insights/lib/binges.js.map +1 -0
  57. package/dist/services/insights/lib/compare.d.ts +31 -0
  58. package/dist/services/insights/lib/compare.d.ts.map +1 -0
  59. package/dist/services/insights/lib/compare.js +68 -0
  60. package/dist/services/insights/lib/compare.js.map +1 -0
  61. package/dist/services/insights/lib/discoveries.d.ts +17 -0
  62. package/dist/services/insights/lib/discoveries.d.ts.map +1 -0
  63. package/dist/services/insights/lib/discoveries.js +24 -0
  64. package/dist/services/insights/lib/discoveries.js.map +1 -0
  65. package/dist/services/insights/lib/diversity.d.ts +28 -0
  66. package/dist/services/insights/lib/diversity.d.ts.map +1 -0
  67. package/dist/services/insights/lib/diversity.js +39 -0
  68. package/dist/services/insights/lib/diversity.js.map +1 -0
  69. package/dist/services/insights/lib/hours.d.ts +39 -0
  70. package/dist/services/insights/lib/hours.d.ts.map +1 -0
  71. package/dist/services/insights/lib/hours.js +66 -0
  72. package/dist/services/insights/lib/hours.js.map +1 -0
  73. package/dist/services/insights/lib/mood.d.ts +22 -0
  74. package/dist/services/insights/lib/mood.d.ts.map +1 -0
  75. package/dist/services/insights/lib/mood.js +187 -0
  76. package/dist/services/insights/lib/mood.js.map +1 -0
  77. package/dist/services/insights/lib/periods.d.ts +17 -0
  78. package/dist/services/insights/lib/periods.d.ts.map +1 -0
  79. package/dist/services/insights/lib/periods.js +66 -0
  80. package/dist/services/insights/lib/periods.js.map +1 -0
  81. package/dist/services/insights/lib/personality.d.ts +30 -0
  82. package/dist/services/insights/lib/personality.d.ts.map +1 -0
  83. package/dist/services/insights/lib/personality.js +131 -0
  84. package/dist/services/insights/lib/personality.js.map +1 -0
  85. package/dist/services/insights/lib/trends.d.ts +30 -0
  86. package/dist/services/insights/lib/trends.d.ts.map +1 -0
  87. package/dist/services/insights/lib/trends.js +67 -0
  88. package/dist/services/insights/lib/trends.js.map +1 -0
  89. package/dist/services/insights/mood.d.ts +8 -0
  90. package/dist/services/insights/mood.d.ts.map +1 -0
  91. package/dist/services/insights/mood.js +53 -0
  92. package/dist/services/insights/mood.js.map +1 -0
  93. package/dist/services/insights/now-playing.d.ts +20 -0
  94. package/dist/services/insights/now-playing.d.ts.map +1 -0
  95. package/dist/services/insights/now-playing.js +128 -0
  96. package/dist/services/insights/now-playing.js.map +1 -0
  97. package/dist/services/insights/personality.d.ts +8 -0
  98. package/dist/services/insights/personality.d.ts.map +1 -0
  99. package/dist/services/insights/personality.js +42 -0
  100. package/dist/services/insights/personality.js.map +1 -0
  101. package/dist/services/insights/summary.d.ts +8 -0
  102. package/dist/services/insights/summary.d.ts.map +1 -0
  103. package/dist/services/insights/summary.js +117 -0
  104. package/dist/services/insights/summary.js.map +1 -0
  105. package/dist/services/insights/trends.d.ts +8 -0
  106. package/dist/services/insights/trends.d.ts.map +1 -0
  107. package/dist/services/insights/trends.js +96 -0
  108. package/dist/services/insights/trends.js.map +1 -0
  109. package/dist/services/insights.d.ts +96 -0
  110. package/dist/services/insights.d.ts.map +1 -0
  111. package/dist/services/insights.js +26 -0
  112. package/dist/services/insights.js.map +1 -0
  113. package/dist/services/insights.schemas.d.ts +710 -0
  114. package/dist/services/insights.schemas.d.ts.map +1 -0
  115. package/dist/services/insights.schemas.js +307 -0
  116. package/dist/services/insights.schemas.js.map +1 -0
  117. package/dist/services/track.d.ts +6 -12
  118. package/dist/services/track.d.ts.map +1 -1
  119. package/dist/services/track.js.map +1 -1
  120. package/dist/utils.d.ts +1 -1
  121. package/package.json +12 -4
@@ -0,0 +1,96 @@
1
+ import { createUserService } from '../user.js';
2
+ import { resolvePeriod } from './lib/periods.js';
3
+ import { diffRankings } from './lib/trends.js';
4
+ /**
5
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
6
+ * between two time periods for artists, tracks, or albums.
7
+ */
8
+ export async function getTrends(config, params, init) {
9
+ const userService = createUserService(config);
10
+ const target = params.target ?? 'artists';
11
+ const currentResolved = resolvePeriod(params.currentPeriod ?? '7day');
12
+ const previousResolved = resolvePeriod(params.previousPeriod ?? '1month');
13
+ const limit = params.limit ?? 30;
14
+ let currentItems = [];
15
+ let previousItems = [];
16
+ if (target === 'tracks') {
17
+ const [curRes, prevRes] = await Promise.all([
18
+ userService.getTopTracks({ user: params.user, period: currentResolved.lastfm, limit }, init),
19
+ userService.getTopTracks({ user: params.user, period: previousResolved.lastfm, limit }, init),
20
+ ]);
21
+ currentItems = (curRes.toptracks?.track ?? []).map((t) => {
22
+ const rawArtist = t.artist;
23
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
24
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
25
+ : String(rawArtist ?? '');
26
+ return {
27
+ name: artistName.length > 0 ? `${artistName} - ${t.name}` : t.name,
28
+ playcount: Number(t.playcount ?? 0),
29
+ };
30
+ });
31
+ previousItems = (prevRes.toptracks?.track ?? []).map((t) => {
32
+ const rawArtist = t.artist;
33
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
34
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
35
+ : String(rawArtist ?? '');
36
+ return {
37
+ name: artistName.length > 0 ? `${artistName} - ${t.name}` : t.name,
38
+ playcount: Number(t.playcount ?? 0),
39
+ };
40
+ });
41
+ }
42
+ else if (target === 'albums') {
43
+ const [curRes, prevRes] = await Promise.all([
44
+ userService.getTopAlbums({ user: params.user, period: currentResolved.lastfm, limit }, init),
45
+ userService.getTopAlbums({ user: params.user, period: previousResolved.lastfm, limit }, init),
46
+ ]);
47
+ currentItems = (curRes.topalbums?.album ?? []).map((a) => {
48
+ const rawArtist = a.artist;
49
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
50
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
51
+ : typeof rawArtist === 'string'
52
+ ? rawArtist
53
+ : '';
54
+ return {
55
+ name: artistName.length > 0 ? `${artistName} - ${a.name}` : a.name,
56
+ playcount: Number(a.playcount ?? 0),
57
+ };
58
+ });
59
+ previousItems = (prevRes.topalbums?.album ?? []).map((a) => {
60
+ const rawArtist = a.artist;
61
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
62
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
63
+ : typeof rawArtist === 'string'
64
+ ? rawArtist
65
+ : '';
66
+ return {
67
+ name: artistName.length > 0 ? `${artistName} - ${a.name}` : a.name,
68
+ playcount: Number(a.playcount ?? 0),
69
+ };
70
+ });
71
+ }
72
+ else {
73
+ // default: artists
74
+ const [curRes, prevRes] = await Promise.all([
75
+ userService.getTopArtists({ user: params.user, period: currentResolved.lastfm, limit }, init),
76
+ userService.getTopArtists({ user: params.user, period: previousResolved.lastfm, limit }, init),
77
+ ]);
78
+ currentItems = (curRes.topartists?.artist ?? []).map((a) => ({
79
+ name: a.name,
80
+ playcount: Number(a.playcount ?? 0),
81
+ }));
82
+ previousItems = (prevRes.topartists?.artist ?? []).map((a) => ({
83
+ name: a.name,
84
+ playcount: Number(a.playcount ?? 0),
85
+ }));
86
+ }
87
+ const diff = diffRankings(currentItems, previousItems, { maxResults: params.maxResults });
88
+ return {
89
+ user: params.user,
90
+ target,
91
+ currentPeriod: currentResolved.lastfm,
92
+ previousPeriod: previousResolved.lastfm,
93
+ ...diff,
94
+ };
95
+ }
96
+ //# sourceMappingURL=trends.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trends.js","sourceRoot":"","sources":["../../../src/services/insights/trends.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,96 @@
1
+ import type { LastFmConfig } from '../config.js';
2
+ import type { InsightsBingesRequest, InsightsBingesResponse, InsightsCompareRequest, InsightsCompareResponse, InsightsDiscoveriesRequest, InsightsDiscoveriesResponse, InsightsHoursRequest, InsightsHoursResponse, InsightsMoodRequest, InsightsMoodResponse, InsightsNowPlayingRequest, InsightsNowPlayingResponse, InsightsPersonalityRequest, InsightsPersonalityResponse, InsightsSummaryRequest, InsightsSummaryResponse, InsightsTrendsRequest, InsightsTrendsResponse } from './insights.schemas.js';
3
+ /**
4
+ * Insights Service
5
+ *
6
+ * Provides high-level derived analytics, summaries, and behavioral insights
7
+ * computed over Last.fm data.
8
+ */
9
+ export interface InsightsService {
10
+ /**
11
+ * Aggregates a user's listening summary for a given period (top artists, tracks, albums, tags)
12
+ * and calculates Shannon diversity metrics.
13
+ *
14
+ * @param {InsightsSummaryRequest} params
15
+ * @param {RequestInit} [init]
16
+ * @returns {Promise<InsightsSummaryResponse>}
17
+ */
18
+ getSummary: (params: InsightsSummaryRequest, init?: RequestInit) => Promise<InsightsSummaryResponse>;
19
+ /**
20
+ * Fetches the user's current (or most recent) track and enriches it with
21
+ * artist biography and similar artists.
22
+ *
23
+ * @param {InsightsNowPlayingRequest} params
24
+ * @param {RequestInit} [init]
25
+ * @returns {Promise<InsightsNowPlayingResponse>}
26
+ */
27
+ getNowPlaying: (params: InsightsNowPlayingRequest, init?: RequestInit) => Promise<InsightsNowPlayingResponse>;
28
+ /**
29
+ * Buckets a user's recent scrobbles by hour-of-day (0..23) and weekday (0..6),
30
+ * calculating diurnal distribution and peak listening times.
31
+ *
32
+ * @param {InsightsHoursRequest} params
33
+ * @param {RequestInit} [init]
34
+ * @returns {Promise<InsightsHoursResponse>}
35
+ */
36
+ getHoursHistogram: (params: InsightsHoursRequest, init?: RequestInit) => Promise<InsightsHoursResponse>;
37
+ /**
38
+ * Detects binge listening streaks (consecutive plays of the same artist or track)
39
+ * across a user's recent scrobbles.
40
+ *
41
+ * @param {InsightsBingesRequest} params
42
+ * @param {RequestInit} [init]
43
+ * @returns {Promise<InsightsBingesResponse>}
44
+ */
45
+ getBinges: (params: InsightsBingesRequest, init?: RequestInit) => Promise<InsightsBingesResponse>;
46
+ /**
47
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
48
+ * between two time periods.
49
+ *
50
+ * @param {InsightsTrendsRequest} params
51
+ * @param {RequestInit} [init]
52
+ * @returns {Promise<InsightsTrendsResponse>}
53
+ */
54
+ getTrends: (params: InsightsTrendsRequest, init?: RequestInit) => Promise<InsightsTrendsResponse>;
55
+ /**
56
+ * Detects newly discovered artists in a recent time window by comparing
57
+ * against the user's historical baseline roster.
58
+ *
59
+ * @param {InsightsDiscoveriesRequest} params
60
+ * @param {RequestInit} [init]
61
+ * @returns {Promise<InsightsDiscoveriesResponse>}
62
+ */
63
+ getDiscoveries: (params: InsightsDiscoveriesRequest, init?: RequestInit) => Promise<InsightsDiscoveriesResponse>;
64
+ /**
65
+ * Classifies a user's emotional mood profile (energy vs. valence coordinates,
66
+ * quadrant, and top genre categories) based on community tags.
67
+ *
68
+ * @param {InsightsMoodRequest} params
69
+ * @param {RequestInit} [init]
70
+ * @returns {Promise<InsightsMoodResponse>}
71
+ */
72
+ getMood: (params: InsightsMoodRequest, init?: RequestInit) => Promise<InsightsMoodResponse>;
73
+ /**
74
+ * Derives a holistic listener personality archetype (The Devotee, The Explorer,
75
+ * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
76
+ *
77
+ * @param {InsightsPersonalityRequest} params
78
+ * @param {RequestInit} [init]
79
+ * @returns {Promise<InsightsPersonalityResponse>}
80
+ */
81
+ getPersonality: (params: InsightsPersonalityRequest, init?: RequestInit) => Promise<InsightsPersonalityResponse>;
82
+ /**
83
+ * Compares two Last.fm users' listening affinity using Jaccard similarity
84
+ * over mutual top artist rosters.
85
+ *
86
+ * @param {InsightsCompareRequest} params
87
+ * @param {RequestInit} [init]
88
+ * @returns {Promise<InsightsCompareResponse>}
89
+ */
90
+ compareUsers: (params: InsightsCompareRequest, init?: RequestInit) => Promise<InsightsCompareResponse>;
91
+ }
92
+ /**
93
+ * Creates an instance of the Insights service
94
+ */
95
+ export declare function createInsightsService(config: LastFmConfig): InsightsService;
96
+ //# sourceMappingURL=insights.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../src/services/insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAUhD,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,uBAAuB,CAAA;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEpG;;;;;;;OAOG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,yBAAyB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAA;IAE7G;;;;;;;OAOG;IACH,iBAAiB,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAEvG;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEjG;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEjG;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,0BAA0B,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAA;IAEhH;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAE3F;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,0BAA0B,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAA;IAEhH;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAY3E"}
@@ -0,0 +1,26 @@
1
+ import { getBinges } from './insights/binges.js';
2
+ import { compareUsers } from './insights/compare.js';
3
+ import { getDiscoveries } from './insights/discoveries.js';
4
+ import { getHoursHistogram } from './insights/hours.js';
5
+ import { getMood } from './insights/mood.js';
6
+ import { getNowPlaying } from './insights/now-playing.js';
7
+ import { getPersonality } from './insights/personality.js';
8
+ import { getSummary } from './insights/summary.js';
9
+ import { getTrends } from './insights/trends.js';
10
+ /**
11
+ * Creates an instance of the Insights service
12
+ */
13
+ export function createInsightsService(config) {
14
+ return {
15
+ getSummary: (params, init) => getSummary(config, params, init),
16
+ getNowPlaying: (params, init) => getNowPlaying(config, params, init),
17
+ getHoursHistogram: (params, init) => getHoursHistogram(config, params, init),
18
+ getBinges: (params, init) => getBinges(config, params, init),
19
+ getTrends: (params, init) => getTrends(config, params, init),
20
+ getDiscoveries: (params, init) => getDiscoveries(config, params, init),
21
+ getMood: (params, init) => getMood(config, params, init),
22
+ getPersonality: (params, init) => getPersonality(config, params, init),
23
+ compareUsers: (params, init) => compareUsers(config, params, init),
24
+ };
25
+ }
26
+ //# sourceMappingURL=insights.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"insights.js","sourceRoot":"","sources":["../../src/services/insights.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAwHhD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACzD,OAAO;QACN,UAAU,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC9D,aAAa,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACpE,iBAAiB,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC5E,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC5D,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC5D,cAAc,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACtE,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACxD,cAAc,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACtE,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;KAClE,CAAA;AACF,CAAC"}