fix: set COTTON_DIR (singular) in CfUiConfig — django-cotton never read COTTON_DIRS

django-cotton 2.x reads settings.COTTON_DIR (a single string), not COTTON_DIRS
(a list). The previous append-to-COTTON_DIRS path was a no-op at runtime, so
every <c-cf.*> raised TemplateDoesNotExist in any consumer template that
rendered a cf component unconditionally. The unit test asserted the wrong
invariant (membership in COTTON_DIRS) and the E2E settings file masked the
bug by pre-setting COTTON_DIR itself, so CI stayed green.

ready() now sets COTTON_DIR to "cotton/<theme>" only when the consumer hasn't
already set it. django-cotton's loader auto-walks each app's templates/ dir,
so <c-cf.notification> resolves to cf_ui/templates/cotton/<theme>/cf/notification.html
without any TEMPLATES["DIRS"] coordination. The multi-theme directory layout
is preserved.

Fixes #3.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: fsecada01

src/cf_ui/django.py

@@ -21,8 +21,10 @@ def ready(self) -> None:
                 f"Check CF_UI_THEME in settings."
             )
 
-        if not hasattr(settings, "COTTON_DIRS"):
-            settings.COTTON_DIRS = []
-
-        if cotton_dir not in [Path(d) for d in settings.COTTON_DIRS]:
-            settings.COTTON_DIRS.append(cotton_dir)
+        # django-cotton reads COTTON_DIR (singular). Setting it to
+        # "cotton/<theme>" makes <c-cf.foo> resolve to
+        # cotton/<theme>/cf/foo.html, which the cotton loader finds via
+        # the app-templates walk (cf_ui/templates/cotton/<theme>/cf/foo.html).
+        # Don't overwrite a value the consumer has already set.
+        if not getattr(settings, "COTTON_DIR", None):
+            settings.COTTON_DIR = f"cotton/{theme}"

tests/unit/test_core.py

@@ -32,13 +32,10 @@ def test_django_appconfig_name():
     assert app is not None
 
 
-def test_django_appconfig_ready_registers_cotton_dirs():
+def test_django_appconfig_ready_sets_cotton_dir():
     from django.conf import settings
 
-    from cf_ui import COTTON_TEMPLATES_DIR
-
-    theme_dir = COTTON_TEMPLATES_DIR / "bulma"
-    assert any(str(d) == str(theme_dir) for d in getattr(settings, "COTTON_DIRS", []))
+    assert getattr(settings, "COTTON_DIR", None) == "cotton/bulma"
 
 
 def test_fastapi_install_cf_ui_adds_template_dir():