pulse-framework 0.1.49__py3-none-any.whl → 0.1.51__py3-none-any.whl

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/messages.py

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

pulse/react_component.py

@@ -37,7 +37,7 @@ from pulse.transpiler.nodes import (
 	JSXProp,
 	JSXSpreadProp,
 )
-from pulse.vdom import Child, Element, Node
+from pulse.vdom import Child, Element, Node, clean_element_name
 
 T = TypeVar("T")
 P = ParamSpec("P")
@@ -205,7 +205,8 @@ class PropSpec:
 		unknown_keys = props.keys() - known_keys - {"key"}
 		if not self.allow_unspecified and unknown_keys:
 			bad = ", ".join(repr(k) for k in sorted(unknown_keys))
-			raise ValueError(f"Unexpected prop(s) for component '{comp_tag}': {bad}")
+			clean_tag = clean_element_name(comp_tag)
+			raise ValueError(f"Unexpected prop(s) for component '{clean_tag}': {bad}")
 		if self.allow_unspecified:
 			for k in unknown_keys:
 				v = props[k]
@@ -290,8 +291,9 @@ class PropSpec:
 					errors.append(
 						f"Multiple props map to '{js_key}': {', '.join(py_keys)}"
 					)
+			clean_tag = clean_element_name(comp_tag)
 			raise ValueError(
-				f"Invalid props for component '{comp_tag}': {'; '.join(errors)}"
+				f"Invalid props for component '{clean_tag}': {'; '.join(errors)}"
 			)
 
 		return result or None

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/serializer.py

@@ -29,6 +29,7 @@ containing primitives, lists/tuples, ``dict``/plain objects, ``set`` and
 from __future__ import annotations
 
 import datetime as dt
+import math
 import types
 from dataclasses import fields, is_dataclass
 from typing import Any
@@ -56,7 +57,16 @@ def serialize(data: Any) -> Serialized:
 
 	def process(value: Any) -> PlainJSON:
 		nonlocal global_index
-		if value is None or isinstance(value, (bool, int, float, str)):
+		if value is None or isinstance(value, (bool, int, str)):
+			return value
+		if isinstance(value, float):
+			if math.isnan(value):
+				return None  # NaN → None (matches pandas None ↔ NaN semantics)
+			if math.isinf(value):
+				raise ValueError(
+					f"Cannot serialize {value}: Infinity is not valid JSON. "
+					+ "Replace with None or a sentinel value."
+				)
 			return value
 
 		idx = global_index

pulse/vdom.py

@@ -6,7 +6,6 @@ the TypeScript UINode format exactly, eliminating the need for translation.
 """
 
 import functools
-import math
 import re
 import warnings
 from collections.abc import Callable, Iterable, Sequence
@@ -30,56 +29,6 @@ from pulse.env import env
 from pulse.hooks.core import HookContext
 from pulse.hooks.init import rewrite_init_blocks
 
-# ============================================================================
-# Validation helpers (dev mode only)
-# ============================================================================
-
-
-def _check_json_safe_float(value: float, context: str) -> None:
-	"""Raise ValueError if a float is NaN or Infinity."""
-	if math.isnan(value):
-		raise ValueError(
-			f"Cannot use nan in {context}. "
-			+ "NaN and Infinity are not supported in Pulse because they cannot be serialized to JSON. "
-			+ "Replace with None or a sentinel value before passing to components."
-		)
-	if math.isinf(value):
-		kind = "inf" if value > 0 else "-inf"
-		raise ValueError(
-			f"Cannot use {kind} in {context}. "
-			+ "NaN and Infinity are not supported in Pulse because they cannot be serialized to JSON. "
-			+ "Replace with None or a sentinel value before passing to components."
-		)
-
-
-def _validate_value(value: Any, context: str) -> None:
-	"""Recursively validate a value for JSON-unsafe floats (NaN, Infinity)."""
-	if isinstance(value, float):
-		_check_json_safe_float(value, context)
-	elif isinstance(value, dict):
-		for v in value.values():
-			_validate_value(v, context)
-	elif isinstance(value, (list, tuple)):
-		for item in value:
-			_validate_value(item, context)
-	# Skip other types - they'll be handled by the serializer
-
-
-def _validate_props(props: dict[str, Any] | None, parent_name: str) -> None:
-	"""Validate all props for JSON-unsafe values."""
-	if not props:
-		return
-	for key, value in props.items():
-		_validate_value(value, f"{parent_name} prop '{key}'")
-
-
-def _validate_children(children: "Sequence[Element]", parent_name: str) -> None:
-	"""Validate primitive children for JSON-unsafe values."""
-	for child in children:
-		if isinstance(child, float):
-			_check_json_safe_float(child, f"{parent_name} children")
-
-
 # ============================================================================
 # Core VDOM
 # ============================================================================
@@ -109,7 +58,7 @@ class Node:
 
 	tag: str
 	props: dict[str, Any] | None
-	children: "Sequence[Element] | None"
+	children: "list[Element] | None"
 	allow_children: bool
 	key: str | None
 
@@ -122,7 +71,6 @@ class Node:
 		allow_children: bool = True,
 	):
 		self.tag = tag
-		# Normalize to None
 		self.props = props or None
 		self.children = (
 			_flatten_children(children, parent_name=f"<{self.tag}>")
@@ -134,13 +82,8 @@ class Node:
 		if key is not None and not isinstance(key, str):
 			raise ValueError("key must be a string or None")
 		if not self.allow_children and children:
-			raise ValueError(f"{self.tag} cannot have children")
-		# Dev-only validation for JSON-unsafe values
-		if env.pulse_env == "dev":
-			parent_name = f"<{self.tag}>"
-			_validate_props(self.props, parent_name)
-			if self.children:
-				_validate_children(self.children, parent_name)
+			clean_tag = clean_element_name(self.tag)
+			raise ValueError(f"{clean_tag} cannot have children")
 
 	# --- Pretty printing helpers -------------------------------------------------
 	@override
@@ -265,7 +208,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]
@@ -332,17 +275,6 @@ class ComponentNode:
 		# Used for rendering
 		self.contents = None
 		self.hooks = HookContext()
-		# Dev-only validation for JSON-unsafe values
-		if env.pulse_env == "dev":
-			parent_name = f"<{self.name}>"
-			# Validate kwargs (props)
-			_validate_props(self.kwargs, parent_name)
-			# Validate args (children passed positionally)
-			for arg in self.args:
-				if isinstance(arg, float):
-					_check_json_safe_float(arg, f"{parent_name} children")
-				elif isinstance(arg, (dict, list, tuple)):
-					_validate_value(arg, f"{parent_name} children")
 
 	def __getitem__(self, children_arg: "Child | tuple[Child, ...]"):
 		if not self.takes_children:
@@ -356,11 +288,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 +300,6 @@ class ComponentNode:
 			key=self.key,
 			takes_children=self.takes_children,
 		)
-		return result
 
 	@override
 	def __repr__(self) -> str:
@@ -486,7 +417,7 @@ VDOMOperation: TypeAlias = (
 # ----------------------------------------------------------------------------
 
 
-def _clean_parent_name_for_warning(parent_name: str) -> str:
+def clean_element_name(parent_name: str) -> str:
 	"""Strip $$ prefix and hexadecimal suffix from ReactComponent tags in warning messages.
 
 	ReactComponent tags are in the format <$$ComponentName_1a2b> or <$$ComponentName_1a2b.prop>.
@@ -500,7 +431,7 @@ def _clean_parent_name_for_warning(parent_name: str) -> str:
 
 def _flatten_children(
 	children: Children, *, parent_name: str, warn_stacklevel: int = 5
-) -> Sequence[Element]:
+) -> list[Element]:
 	"""Flatten children and emit warnings for unkeyed iterables (dev mode only).
 
 	Args:
@@ -511,7 +442,6 @@ def _flatten_children(
 			- 4 for ComponentNode.__getitem__ or Component.__call__ (user -> method -> _flatten_children -> visit -> warn)
 	"""
 	flat: list[Element] = []
-	return_tuple = isinstance(children, tuple)
 	is_dev = env.pulse_env == "dev"
 
 	def visit(item: Child) -> None:
@@ -529,7 +459,7 @@ def _flatten_children(
 				visit(sub)
 			if missing_key:
 				# Warn once per iterable without keys on its elements.
-				clean_name = _clean_parent_name_for_warning(parent_name)
+				clean_name = clean_element_name(parent_name)
 				warnings.warn(
 					(
 						f"[Pulse] Iterable children of {clean_name} contain elements without 'key'. "
@@ -548,13 +478,14 @@ def _flatten_children(
 	for child in flat:
 		if isinstance(child, (Node, ComponentNode)) and child.key is not None:
 			if child.key in seen_keys:
+				clean_name = clean_element_name(parent_name)
 				raise ValueError(
-					f"[Pulse] Duplicate key '{child.key}' found among children of {parent_name}. "
+					f"[Pulse] Duplicate key '{child.key}' found among children of {clean_name}. "
 					+ "Keys must be unique per sibling set."
 				)
 			seen_keys.add(child.key)
 
-	return tuple(flat) if return_tuple else flat
+	return flat
 
 
 def _short_args(args: tuple[Any, ...], max_items: int = 4) -> list[str] | str:
@@ -606,19 +537,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
 

{pulse_framework-0.1.49.dist-info → pulse_framework-0.1.51.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.49
+Version: 0.1.51
 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.dist-info → pulse_framework-0.1.51.dist-info}/RECORD

@@ -33,7 +33,7 @@ pulse/hooks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/hooks/core.py,sha256=QfYRz2O8-drNSQx_xnv8mK8ksWcw3LNM1H2hoInT0Rk,7457
 pulse/hooks/effects.py,sha256=pVq5OndlhFLHLpM9Pn9Bp5rEpnpmJEpbIp2UaHHyJFQ,2428
 pulse/hooks/init.py,sha256=iTNmEcFgZCXsLImPONbSNwc5asT7NQRz04b1Jopgzxs,11960
-pulse/hooks/runtime.py,sha256=k5LZ8hnlNBMKOiEkQcAvs8BKwYxV6gwea2WCfju5K7Y,5106
+pulse/hooks/runtime.py,sha256=61CGZ9B0ScwCx8bwUrXIWYPAJIZtGCp3GcdBqa33dgo,5145
 pulse/hooks/setup.py,sha256=c_uVi0S0HPioEvjdWUaSdAGT9M3Cxpw8J-llvtmDOGo,4496
 pulse/hooks/stable.py,sha256=mLNS6WyA4tC-65gNybPOE0DLEz1YlxOCddD9odElArU,1772
 pulse/hooks/states.py,sha256=fFqN3gf7v7rY6QmieKWN1hVCQRRnL-5H4TeG9LTnKSc,6778
@@ -65,7 +65,7 @@ pulse/js/string.py,sha256=fBd_CKq5nhc300mRa3YgNw0jpTEgGyaXRmGBiJgeu5w,928
 pulse/js/weakmap.py,sha256=Q7kgPQx6rFqYfhIDyRfhuC12JmlKmO2n-OGSpl3g9ZY,1473
 pulse/js/weakset.py,sha256=FJoVR0WtaOaHL7AXzJOb29F_sqG1K2mWxvR0RJk3mS0,1333
 pulse/js/window.py,sha256=ayx3lBl54hTVanlkiC2wCVGNh0IDJqzPO7OlO11YUtI,4081
-pulse/messages.py,sha256=PDsb07QDKvkMitAMgLmOk2c4JDb58Cq9WWCwbQ8unvg,3979
+pulse/messages.py,sha256=8SrGVPQ674DPMm-FUNNrEfVonFmcvQdb8B_z6K_dQbw,3991
 pulse/middleware.py,sha256=9uyAhVUEGMSwqWC3WXqs7x5JMMNEcSTTu3g7DjsR8w8,9812
 pulse/plugin.py,sha256=RfGl6Vtr7VRHb8bp4Ob4dOX9dVzvc4Riu7HWnStMPpk,580
 pulse/proxy.py,sha256=jv2IdOEbF-qbtN5hmSqnyhZedOX1597XBye8cerWIyE,7253
@@ -79,14 +79,14 @@ pulse/queries/mutation.py,sha256=px1fprFL-RxNfbRSoRtdsOLkEbjSsMrJxGHKBIPYQTM,495
 pulse/queries/protocol.py,sha256=R8n238Ex9DbYIAVKB83a8FAPtnCiPNhWar-F01K2fTo,3345
 pulse/queries/query.py,sha256=G8eXCaT5wuvVcstlqWU8VBxuuUUS7K1R5Y-VtDpMIG0,35065
 pulse/queries/store.py,sha256=Ct7a-h1-Cq07zEfe9vw-LM85Fm7jIJx7CLAIlsiznlU,3444
-pulse/react_component.py,sha256=m2WJwrCvzaHDC_o4PRvZ3pD3nwy9QshxtVn10vMRDQg,30603
+pulse/react_component.py,sha256=7_7gNYiWnLqwta5TBG8GhWN29IH1aH9wRmGCm4pRJzI,30713
 pulse/reactive.py,sha256=v8a9IttkabeWwYrrHAx33zqzW9WC4WlS4iXbIh2KQkU,24374
 pulse/reactive_extensions.py,sha256=T1V3AasHtvJkmGO55miC9RVPxDFIj7qrooMsn89x5SI,32076
-pulse/render_session.py,sha256=UAI65k28ysZqCp7j6BBdi7MkG2wVKJXj4hIgjK7hsaM,18120
+pulse/render_session.py,sha256=kGskm6NNhQ2u4vBRXOeIeCoXsyP81O2Q4Fr93nA6q-4,18222
 pulse/renderer.py,sha256=kUwrI5v9XMerVCjBmnYZSyfkDu8B8cW8jFjVnM93TS4,15702
 pulse/request.py,sha256=sPsSRWi5KvReSPBLIs_kzqomn1wlRk1BTLZ5s0chQr4,4979
 pulse/routing.py,sha256=XZdq4gjfYeuz1wKtjPza6YA8ya76_cQ58b2l4dBDbr4,13243
-pulse/serializer.py,sha256=8RAITNoSNm5-U38elHpWmkBpcM_rxZFMCluJSfldfk4,5420
+pulse/serializer.py,sha256=7YF8ZjDZYgA5Wmxd9CT-lPvakSb4zjUI1YbTd9m4jQM,5733
 pulse/state.py,sha256=ikQbK4R8PieV96qd4uWREUvs0jXo9sCapawY7i6oCYo,10776
 pulse/transpiler/__init__.py,sha256=sgfHxLwZEPj3rBBMtzD4997qx7GTr5Wt22-296e-uC8,6492
 pulse/transpiler/builtins.py,sha256=V_H3bpgU22Yb_GzM6YvOutZ65O36xHLzRANl7uHRqUI,22401
@@ -111,9 +111,9 @@ pulse/transpiler/utils.py,sha256=W5PAOWvmYdJCEw1eY7QEJRQFmNLVjFTdlCyWzmnTrCc,94
 pulse/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/types/event_handler.py,sha256=psQCydj-WEtBcFU5JU4mDwvyzkW8V2O0g_VFRU2EOHI,1618
 pulse/user_session.py,sha256=FITxLSEl3JU-jod6UWuUYC6EpnPG2rbaLCnIOdkQPtg,7803
-pulse/vdom.py,sha256=yHMOYiXcaP3IVnYOAZrd_7cXWULKQ2fRQAiPDPSsOyU,18494
+pulse/vdom.py,sha256=BQov3TqjrEoLwgMTYHHiB4hhbAxeNHxeOFZPv6eKB1o,16075
 pulse/version.py,sha256=711vaM1jVIQPgkisGgKZqwmw019qZIsc_QTae75K2pg,1895
-pulse_framework-0.1.49.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-pulse_framework-0.1.49.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
-pulse_framework-0.1.49.dist-info/METADATA,sha256=HKBRKLM8CJdL2a7oguyCDzayWPqIBQirMMN40jFrSTw,580
-pulse_framework-0.1.49.dist-info/RECORD,,
+pulse_framework-0.1.51.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.51.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.51.dist-info/METADATA,sha256=eHobxGSJSHVYV0jn6LtVABYkSnhxxcBHiFvi3N2HTSI,580
+pulse_framework-0.1.51.dist-info/RECORD,,