fix: idempotent registry re-registration and namespace static files (0.3.1b0)

Closes #8 — registry.register() now silently accepts re-registration of the
exact same class under the same name (idempotent no-op). Genuine conflicts
(different class claiming the same name) still raise ValueError with a clearer
message. Prevents spurious errors in Django test discovery where the same
module is imported under two dotted paths.

Closes #9 — move component-client.js and component-client.d.ts from
static/js/ into the Django-conventional static/component_framework/js/
subfolder. collectstatic now produces component_framework/js/component-client.js,
matching the documented {% static 'component_framework/js/component-client.js' %}
path and avoiding collisions with other installed apps.

Bump version 0.3.0b0 → 0.3.1b0.

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

Author: fsecada01

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "component-framework"
-version = "0.3.0b0"
+version = "0.3.1b0"
 description = "Framework-agnostic server components with LiveView-style interactivity"
 readme = "README.md"
 requires-python = ">=3.11"

src/component_framework/core/registry.py

@@ -21,7 +21,12 @@ class Counter(Component):
 
         def decorator(cls: type[Component]):
             if name in self._registry:
-                raise ValueError(f"Component '{name}' already registered")
+                if self._registry[name] is cls:
+                    return cls  # idempotent: same class re-imported, no-op
+                raise ValueError(
+                    f"Component '{name}' already registered by a different class "
+                    f"({self._registry[name].__qualname__!r})"
+                )
             self._registry[name] = cls
             return cls
 

…ramework/static/js/component-client.d.ts …onent_framework/js/component-client.d.tssrc/component_framework/static/js/component-client.d.ts renamed to src/component_framework/static/component_framework/js/component-client.d.ts src/component_framework/static/js/component-client.d.ts renamed to src/component_framework/static/component_framework/js/component-client.d.ts

@@ -22,12 +22,21 @@ def test_register_duplicate_raises(self):
         class First(Component):
             pass
 
-        with pytest.raises(ValueError, match="Component 'dup' already registered"):
+        with pytest.raises(ValueError, match="already registered by a different class"):
 
             @self.reg.register("dup")
             class Second(Component):
                 pass
 
+    def test_register_same_class_idempotent(self):
+        @self.reg.register("idempotent")
+        class MyComp(Component):
+            pass
+
+        # Re-registering the exact same class must not raise
+        self.reg.register("idempotent")(MyComp)
+        assert self.reg.get("idempotent") is MyComp
+
     def test_get_missing_returns_none(self):
         assert self.reg.get("nonexistent") is None
 

…_framework/static/js/component-client.js …mponent_framework/js/component-client.jssrc/component_framework/static/js/component-client.js renamed to src/component_framework/static/component_framework/js/component-client.js src/component_framework/static/js/component-client.js renamed to src/component_framework/static/component_framework/js/component-client.js

@@ -186,13 +186,22 @@ def test_retrievable_by_name(self) -> None:
         register_test_component(reg, "btn", cls)
         assert reg.get("btn") is cls
 
-    def test_duplicate_name_raises(self) -> None:
-        """Registering the same name twice raises ValueError."""
+    def test_duplicate_name_different_class_raises(self) -> None:
+        """Registering a different class under the same name raises ValueError."""
+        reg = ComponentRegistry()
+        cls1 = make_component("dup")
+        cls2 = make_component("dup")
+        register_test_component(reg, "dup", cls1)
+        with pytest.raises(ValueError, match="already registered by a different class"):
+            register_test_component(reg, "dup", cls2)
+
+    def test_duplicate_name_same_class_idempotent(self) -> None:
+        """Registering the same class under the same name is a no-op."""
         reg = ComponentRegistry()
         cls = make_component("dup")
         register_test_component(reg, "dup", cls)
-        with pytest.raises(ValueError, match="already registered"):
-            register_test_component(reg, "dup", cls)
+        register_test_component(reg, "dup", cls)  # must not raise
+        assert reg.get("dup") is cls
 
 
 # ---------------------------------------------------------------------------