Update setting name, docs and mappers

docs/source/integrations/django-bird.md

@@ -13,6 +13,9 @@ Using the auto settings in `django-bird` will unfortunately create a conflict wi
 ```python
 # settings.py
 
+from dj_angles.mappers.thirdparty import map_bird
+
+
 DJANGO_BIRD = {
     "ENABLE_AUTO_CONFIG": False
 }  # this is required for `django-bird`
@@ -47,6 +50,10 @@ TEMPLATES = [
         },
     },
 ]
+
+ANGLE = {
+    "mapper": map_bird
+}
 ```
 
 ## Example
@@ -66,3 +73,28 @@ TEMPLATES = [
   {{ slot }}
 </button>
 ```
+
+### Using `default_component_mapper`
+
+```python
+# settings.py
+ANGLES = {
+    "default_component_mapper": "dj_angles.mappers.thirdparty.map_bird_component",
+}
+```
+
+**templates/index.html**
+
+```html
+<dj-button class='btn'>
+  Click me!
+</dj-button>
+```
+
+**templates/bird/button.html**
+
+```
+<button {{ attrs }}>
+  {{ slot }}
+</button>
+```

docs/source/settings.md

@@ -61,4 +61,8 @@ Lower-cases the tag. Useful when using [React-style includes](#react-style-inclu
 
 ## `mappers`
 
-Provide additional mappers. `Dictionary` which defaults to `{}`. More details about [mappers](mappers.md).
+Provide additional mappers. `Dictionary` which defaults to `{}`. More details about [mappers](mappers.md).
+
+## `default_component_mapper`
+
+Provide a default mapper. This defaults to `dj_angles.mappers.include.map_include`

src/dj_angles/mappers/thirdparty.py

@@ -1,3 +1,4 @@
+from collections.abc import Callable
 import logging
 from typing import TYPE_CHECKING
 
@@ -11,10 +12,18 @@
 
 
 def map_bird(tag: "Tag") -> str:
+    return _stub_map_bird(tag, lambda tag: get_attribute_value_or_first_key(tag, "template"))
+
+
+def map_bird_component(tag: "Tag") -> str:
+    return _stub_map_bird(tag, lambda tag: tag.component_name)
+
+
+def _stub_map_bird(tag: "Tag", get_template_for_tag: Callable[["Tag"], str]) -> str:
     if tag.is_end:
         return "{% endbird %}"
 
-    template = get_attribute_value_or_first_key(tag, "template")
+    template = get_template_for_tag(tag)
     django_template_tag = f"{{% bird {template}"
 
     if tag.attributes:

src/dj_angles/tags.py

@@ -6,7 +6,6 @@
 
 from dj_angles.attributes import Attributes
 from dj_angles.mappers.angles import map_angles_include
-from dj_angles.mappers.include import map_include
 from dj_angles.settings import get_setting
 
 if TYPE_CHECKING:
@@ -96,7 +95,7 @@ def get_django_template_tag(self, slots: Optional[list[tuple[str, Element]]] = N
         if self.django_template_tag is None:
             # Assume any missing template tag should use the fallback mapper
             self.django_template_tag = import_string(
-                get_setting("fallback_mapper", "dj_angles.mappers.include.map_include")
+                get_setting("default_component_mapper", "dj_angles.mappers.include.map_include")
             )
 
             # Add component name to the template tags