v1.0: tag filter — UIList matches by name or tags

The tags field already existed (StringProperty, comma-separated,
editable in the details box). This slice surfaces it in the user-
facing filter: typing in the funnel at the bottom of the Studio
UIList now matches both name AND tags via case-insensitive substring.

- STAGE_UL_studios.filter_items() override that sets bitflag_filter
  _item per row based on whether the row's name or tags contain the
  current filter_name. use_filter_invert is honored so the standard
  "exclude matches" toggle works.
- matches_filter(needle, item) helper extracted as a module-level
  function so it's testable without instantiating a UIList (Blender's
  bpy_struct rejects direct instantiation of UIList subclasses).
- tags property description updated to point users at the filter
  funnel, so the feature is discoverable from the field's tooltip.
- 5 tests covering empty-needle / name-substring / tag-substring /
  combined / case-insensitive cases.

How it shows up for users:

  Studio  | tags
  ---------------------------
  Hero    | wip, client-a
  Wide    | final
  Detail  | wip
  Studio  | (none)

  Type "wip" in the filter funnel → only Hero and Detail visible.
  Type "client" → only Hero. Type "final" → only Wide.

66/66 passing on Blender 5.1.0 (17 unit + 49 Blender).

Next v1.0 candidates: Studio inheritance (parent_uuid + delta-only
capture), or the right-click → Store Property feature for arbitrary
RNA paths (Renderset's killer move per the plan §3 v1.0).

Author: BlueLazyFish

stage/props/studio.py

@@ -81,7 +81,11 @@ class Studio(PropertyGroup):
 
     tags: StringProperty(
         name="Tags",
-        description="Comma-separated tags (e.g. 'wip, client-a, final')",
+        description=(
+            "Comma-separated tags (e.g. 'wip, client-a, final'). "
+            "Use the filter funnel at the bottom of the Studio list to "
+            "filter by tag — substring matches both name and tags."
+        ),
         default="",
     )
 

stage/ui/studio_uilist.py

@@ -6,7 +6,44 @@
 from ..utils.preview_cache import get_icon_id
 
 
+def matches_filter(needle: str, item) -> bool:
+    """Case-insensitive substring match against Studio name OR tags.
+
+    Empty needle matches everything. Pulled out of the UIList class so it's
+    testable without instantiating a UIList (which Blender doesn't support).
+    """
+    if not needle:
+        return True
+    needle_lower = needle.lower()
+    return needle_lower in item.name.lower() or needle_lower in item.tags.lower()
+
+
 class STAGE_UL_studios(UIList):
+    def filter_items(self, context, data, propname):
+        """Filter Studios by name OR tags — case-insensitive substring match.
+
+        Triggered by the user typing in the filter funnel at the bottom of
+        the UIList. Standard `name` matching is extended to also check the
+        Studio's comma-separated `tags` field, so a search for "wip" finds
+        Studios tagged #wip alongside any whose name contains "wip".
+        """
+        items = getattr(data, propname)
+        flt_flags = [self.bitflag_filter_item] * len(items)
+        flt_neworder: list = []
+
+        if self.filter_name:
+            for i, item in enumerate(items):
+                if not matches_filter(self.filter_name, item):
+                    flt_flags[i] = 0
+
+            if self.use_filter_invert:
+                flt_flags = [
+                    self.bitflag_filter_item if f == 0 else 0
+                    for f in flt_flags
+                ]
+
+        return flt_flags, flt_neworder
+
     def draw_item(self, context, layout, data, item, icon, active_data, active_propname, index):
         if self.layout_type in {'DEFAULT', 'COMPACT'}:
             # List view: color marker + name. Thumbnails were causing UI

tests/blender/test_tags.py

@@ -0,0 +1,65 @@
+"""Tests for tag-based filtering in the UIList — v1.0."""
+
+from __future__ import annotations
+
+import bpy
+
+from stage.ui.studio_uilist import matches_filter
+
+
+def _fresh_scene(name: str = "stage_tags_test"):
+    if name in bpy.data.scenes:
+        bpy.data.scenes.remove(bpy.data.scenes[name], do_unlink=True)
+    return bpy.data.scenes.new(name)
+
+
+def _make_studio(scene, name: str, tags: str = ""):
+    s = scene.stage_data.studios.add()
+    s.name = name
+    s.uuid = f"tag-test-{name}"
+    s.tags = tags
+    return s
+
+
+# --- matches_filter helper --------------------------------------------------
+
+
+def test_empty_needle_matches_all():
+    scene = _fresh_scene()
+    s = _make_studio(scene, "Hero", "")
+    assert matches_filter("", s) is True
+
+
+def test_match_by_name_substring():
+    scene = _fresh_scene()
+    s = _make_studio(scene, "Hero")
+    assert matches_filter("hero", s) is True
+    assert matches_filter("HERO", s) is True  # case-insensitive
+    assert matches_filter("er", s) is True    # substring
+    assert matches_filter("wide", s) is False
+
+
+def test_match_by_tag_substring():
+    scene = _fresh_scene()
+    s = _make_studio(scene, "Hero", "wip, client-a")
+    assert matches_filter("wip", s) is True
+    assert matches_filter("client", s) is True
+    assert matches_filter("final", s) is False
+
+
+def test_match_combines_name_and_tags():
+    scene = _fresh_scene()
+    name_only = _make_studio(scene, "WipShot", "")
+    tag_only = _make_studio(scene, "Detail", "wip")
+    neither = _make_studio(scene, "Hero", "final")
+
+    assert matches_filter("wip", name_only) is True
+    assert matches_filter("wip", tag_only) is True
+    assert matches_filter("wip", neither) is False
+
+
+def test_match_case_insensitive_on_tags():
+    scene = _fresh_scene()
+    s = _make_studio(scene, "Hero", "WIP, Client-A")
+    assert matches_filter("wip", s) is True
+    assert matches_filter("client", s) is True