Add favorite icon to game list with full theme support

Renders a heart icon inline before the game name for any entry the
favorite indicator callback returns true for. The icon is sized at 60%
of the row height, vertically centered, with a proportional gap before
the text. Text alignment (left/center/right) and marquee scrolling both
account for the icon+gap width so the combined label is positioned
correctly. The icon also renders alongside the wrap-around repeat during
marquee scroll.

Theme authors can customize the icon via the textlist element:
  - favoriteIconPath   — replace the default heart_filled.svg with any image
  - favoriteIconColor  — apply a color/tint to the icon (default: white)
  - favoriteIconVisible — set false to suppress the icon entirely

BasicGameListView wires the callback to check file metadata "favorite".

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: XenuIsWatching

es-app/src/components/TextListComponent.h

@@ -60,6 +60,7 @@ class TextListComponent : public IList<TextListData, T>
 	inline void setAlignment(Alignment align) { mAlignment = align; }
 
 	inline void setCursorChangedCallback(const std::function<void(CursorState state)>& func) { mCursorChangedCallback = func; }
+	inline void setFavoriteIndicatorCallback(const std::function<bool(const T&)>& func) { mFavoriteIndicatorCallback = func; }
 
 	inline void setFont(const std::shared_ptr<Font>& font)
 	{
@@ -109,17 +110,20 @@ class TextListComponent : public IList<TextListData, T>
 	bool mSelectorColorGradientHorizontal = true;
 	unsigned int mSelectedColor;
 	std::string mScrollSound;
+	std::function<bool(const T&)> mFavoriteIndicatorCallback;
 	static const unsigned int COLOR_ID_COUNT = 2;
 	unsigned int mColors[COLOR_ID_COUNT];
 	int mViewportHeight;
 	int mCursorPrev = -1;
 
 	ImageComponent mSelectorImage;
+	ImageComponent mFavoriteIcon;
+	bool mFavoriteIconVisible;
 };
 
 template <typename T>
 TextListComponent<T>::TextListComponent(Window* window) :
-	IList<TextListData, T>(window), mSelectorImage(window)
+	IList<TextListData, T>(window), mSelectorImage(window), mFavoriteIcon(window)
 {
 	mMarqueeOffset = 0;
 	mMarqueeOffset2 = 0;
@@ -139,6 +143,9 @@ TextListComponent<T>::TextListComponent(Window* window) :
 	mSelectedColor = 0;
 	mColors[0] = 0x0000FFFF;
 	mColors[1] = 0x00FF00FF;
+
+	mFavoriteIcon.setImage(":/heart_filled.svg");
+	mFavoriteIconVisible = true;
 }
 
 template <typename T>
@@ -204,6 +211,12 @@ void TextListComponent<T>::render(const Transform4x4f& parentTrans)
 
 		entry.data.textCache->setColor(color);
 
+		const bool showFavorite = mFavoriteIconVisible && (mFavoriteIndicatorCallback ? mFavoriteIndicatorCallback(entry.object) : false);
+		const float iconSize = entrySize * 0.60f;
+		const float iconGap = showFavorite ? (iconSize * 0.35f) : 0.0f;
+		const float textWidth = entry.data.textCache->metrics.size.x();
+		const float lineWidth = showFavorite ? (iconSize + iconGap + textWidth) : textWidth;
+
 		Vector3f offset(0, y, 0);
 
 		switch(mAlignment)
@@ -212,26 +225,41 @@ void TextListComponent<T>::render(const Transform4x4f& parentTrans)
 			offset[0] = mHorizontalMargin;
 			break;
 		case ALIGN_CENTER:
-			offset[0] = (int)((mSize.x() - entry.data.textCache->metrics.size.x()) / 2);
+			offset[0] = (int)((mSize.x() - lineWidth) / 2);
 			if(offset[0] < mHorizontalMargin)
 				offset[0] = mHorizontalMargin;
 			break;
 		case ALIGN_RIGHT:
-			offset[0] = (mSize.x() - entry.data.textCache->metrics.size.x());
+			offset[0] = (mSize.x() - lineWidth);
 			offset[0] -= mHorizontalMargin;
 			if(offset[0] < mHorizontalMargin)
 				offset[0] = mHorizontalMargin;
 			break;
 		}
 
+		float rowScrollOffset = 0.0f;
+		if((mCursor == i) && (mMarqueeOffset > 0))
+			rowScrollOffset = (float)mMarqueeOffset;
+
+		if(showFavorite)
+		{
+			Transform4x4f iconTrans = trans;
+			iconTrans.translate(offset - Vector3f(rowScrollOffset, 0, 0));
+			mFavoriteIcon.setPosition(0, (entrySize - iconSize) * 0.5f, 0);
+			mFavoriteIcon.setResize(iconSize, iconSize);
+			mFavoriteIcon.render(iconTrans);
+		}
+
+		Vector3f textOffset = offset + Vector3f(showFavorite ? (iconSize + iconGap) : 0.0f, 0, 0);
+
 		// render text
 		Transform4x4f drawTrans = trans;
 
 		// currently selected item text might be scrolling
 		if((mCursor == i) && (mMarqueeOffset > 0))
-			drawTrans.translate(offset - Vector3f((float)mMarqueeOffset, 0, 0));
+			drawTrans.translate(textOffset - Vector3f((float)mMarqueeOffset, 0, 0));
 		else
-			drawTrans.translate(offset);
+			drawTrans.translate(textOffset);
 
 		Renderer::setMatrix(drawTrans);
 		font->renderTextCache(entry.data.textCache.get());
@@ -240,8 +268,16 @@ void TextListComponent<T>::render(const Transform4x4f& parentTrans)
 		// marquee is scrolled far enough for it to repeat
 		if((mCursor == i) && (mMarqueeOffset2 < 0))
 		{
+			// also render the favorite icon alongside the wrap-around copy of the text
+			if(showFavorite)
+			{
+				Transform4x4f iconTrans2 = trans;
+				iconTrans2.translate(offset - Vector3f((float)mMarqueeOffset2, 0, 0));
+				mFavoriteIcon.render(iconTrans2);
+			}
+
 			drawTrans = trans;
-			drawTrans.translate(offset - Vector3f((float)mMarqueeOffset2, 0, 0));
+			drawTrans.translate(textOffset - Vector3f((float)mMarqueeOffset2, 0, 0));
 			Renderer::setMatrix(drawTrans);
 			font->renderTextCache(entry.data.textCache.get());
 		}
@@ -481,6 +517,21 @@ void TextListComponent<T>::applyTheme(const std::shared_ptr<ThemeData>& theme, c
 	} else {
 		mSelectorImage.setImage("");
 	}
+
+	if (elem->has("favoriteIconPath"))
+		mFavoriteIcon.setImage(elem->get<std::string>("favoriteIconPath"));
+	else
+		mFavoriteIcon.setImage(":/heart_filled.svg");
+
+	if (elem->has("favoriteIconColor"))
+		mFavoriteIcon.setColorShift(elem->get<unsigned int>("favoriteIconColor"));
+	else
+		mFavoriteIcon.setColorShift(0xFFFFFFFF);
+
+	if (elem->has("favoriteIconVisible"))
+		mFavoriteIconVisible = elem->get<bool>("favoriteIconVisible");
+	else
+		mFavoriteIconVisible = true;
 }
 
 #endif // ES_APP_COMPONENTS_TEXT_LIST_COMPONENT_H

es-app/src/views/gamelist/BasicGameListView.cpp

@@ -13,6 +13,9 @@ BasicGameListView::BasicGameListView(Window* window, FileData* root)
 	mList.setSize(mSize.x(), mSize.y() * 0.8f);
 	mList.setPosition(0, mSize.y() * 0.2f);
 	mList.setDefaultZIndex(20);
+	mList.setFavoriteIndicatorCallback([](FileData* file) {
+		return file != nullptr && file->getType() == GAME && file->metadata.get("favorite") == "true";
+	});
 	addChild(&mList);
 
 	populateList(root->getChildrenListToDisplay());

es-core/src/ThemeData.cpp

@@ -92,6 +92,9 @@ std::map<std::string, std::map<std::string, ThemeData::ElementPropertyType>> The
 		{ "horizontalMargin", RESOLUTION_FLOAT },
 		{ "forceUppercase", BOOLEAN },
 		{ "lineSpacing", FLOAT },
+		{ "favoriteIconPath", PATH },
+		{ "favoriteIconColor", COLOR },
+		{ "favoriteIconVisible", BOOLEAN },
 		{ "zIndex", FLOAT } } },
 	{ "container", {
 		{ "pos", RESOLUTION_PAIR },