pulse-framework 0.1.49__tar.gz → 0.1.50__tar.gz

{pulse_framework-0.1.49 → pulse_framework-0.1.50}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.49
+Version: 0.1.50
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
 Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.104.0

{pulse_framework-0.1.49 → pulse_framework-0.1.50}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pulse-framework"
-version = "0.1.49"
+version = "0.1.50"
 description = "Pulse - Full-stack framework for building real-time React applications in Python"
 readme = "README.md"
 requires-python = ">=3.11"

{pulse_framework-0.1.49 → pulse_framework-0.1.50}/src/pulse/hooks/runtime.py

@@ -103,11 +103,13 @@ async def set_cookie(
 	)
 
 
-def navigate(path: str, *, replace: bool = False) -> None:
+def navigate(path: str, *, replace: bool = False, hard: bool = False) -> None:
 	ctx = PulseContext.get()
 	if ctx.render is None:
 		raise RuntimeError("navigate() must be invoked inside a Pulse callback context")
-	ctx.render.send({"type": "navigate_to", "path": path, "replace": replace})
+	ctx.render.send(
+		{"type": "navigate_to", "path": path, "replace": replace, "hard": hard}
+	)
 
 
 def redirect(path: str, *, replace: bool = False) -> NoReturn:

{pulse_framework-0.1.49 → pulse_framework-0.1.50}/src/pulse/messages.py

@@ -48,6 +48,7 @@ class ServerNavigateToMessage(TypedDict):
 	type: Literal["navigate_to"]
 	path: str
 	replace: bool
+	hard: bool
 
 
 class ServerApiCallMessage(TypedDict):

{pulse_framework-0.1.49 → pulse_framework-0.1.50}/src/pulse/render_session.py

@@ -440,6 +440,7 @@ class RenderSession:
 					type="navigate_to",
 					path=msg["path"],
 					replace=msg["replace"],
+					hard=msg.get("hard", False),
 				)
 
 		prev_sender = self._send_message
@@ -563,14 +564,20 @@ class RenderSession:
 					# Prefer client-side navigation over emitting VDOM operations
 					self.send(
 						ServerNavigateToMessage(
-							type="navigate_to", path=r.path, replace=r.replace
+							type="navigate_to",
+							path=r.path,
+							replace=r.replace,
+							hard=False,
 						)
 					)
 				except NotFoundInterrupt:
 					# Use app-configured not-found path; fallback to '/404'
 					self.send(
 						ServerNavigateToMessage(
-							type="navigate_to", path=ctx.app.not_found, replace=True
+							type="navigate_to",
+							path=ctx.app.not_found,
+							replace=True,
+							hard=False,
 						)
 					)
 

{pulse_framework-0.1.49 → pulse_framework-0.1.50}/src/pulse/vdom.py

@@ -265,7 +265,7 @@ class Component(Generic[P]):
 		if key is not None and not isinstance(key, str):
 			raise ValueError("key must be a string or None")
 
-		# Flatten children if component takes children (has *children parameter)
+		# Flatten children if component accepts them via `*children` parameter
 		if self._takes_children and args:
 			flattened = _flatten_children(
 				args,  # pyright: ignore[reportArgumentType]
@@ -356,11 +356,11 @@ class ComponentNode:
 			)
 		if not isinstance(children_arg, tuple):
 			children_arg = (children_arg,)
-		# Flatten children for ComponentNode as well
+		# Flatten children when component accepts them via `*children` parameter
 		flattened_children = _flatten_children(
 			children_arg, parent_name=f"<{self.name}>", warn_stacklevel=4
 		)
-		result = ComponentNode(
+		return ComponentNode(
 			fn=self.fn,
 			args=tuple(flattened_children),
 			kwargs=self.kwargs,
@@ -368,7 +368,6 @@ class ComponentNode:
 			key=self.key,
 			takes_children=self.takes_children,
 		)
-		return result
 
 	@override
 	def __repr__(self) -> str:
@@ -606,19 +605,18 @@ def _callable_qualname(fn: Callable[..., Any]) -> str:
 
 
 def _takes_children(fn: Callable[..., Any]) -> bool:
-	# Lightweight check: children allowed if function accepts positional
-	# arguments
+	"""Return True if function accepts children via `*children` parameter.
+
+	Convention: A component accepts children if and only if it has a VAR_POSITIONAL
+	parameter named "children". This convention should be documented in user-facing docs.
+	"""
 	try:
 		sig = signature(fn)
 	except (ValueError, TypeError):
 		# Builtins or callables without inspectable signature: assume no children
 		return False
 	for p in sig.parameters.values():
-		if p.kind in (
-			Parameter.VAR_POSITIONAL,
-			Parameter.POSITIONAL_ONLY,
-			Parameter.POSITIONAL_OR_KEYWORD,
-		):
+		if p.kind is Parameter.VAR_POSITIONAL and p.name == "children":
 			return True
 	return False