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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.48
+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.48 → pulse_framework-0.1.50}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pulse-framework"
-version = "0.1.48"
+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.48 → 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.48 → 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.48 → pulse_framework-0.1.50}/src/pulse/proxy.py

@@ -41,7 +41,7 @@ class ReactProxy:
 		self.server_address = server_address
 		self._client = None
 
-	def _rewrite_url(self, url: str) -> str:
+	def rewrite_url(self, url: str) -> str:
 		"""Rewrite internal React server URLs to external server address."""
 		if self.react_server_address in url:
 			return url.replace(self.react_server_address, self.server_address)
@@ -207,7 +207,7 @@ class ReactProxy:
 			response_headers: dict[str, str] = {}
 			for k, v in r.headers.items():
 				if k.lower() in ("location", "content-location"):
-					v = self._rewrite_url(v)
+					v = self.rewrite_url(v)
 				response_headers[k] = v
 
 			return StreamingResponse(

{pulse_framework-0.1.48 → 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.48 → pulse_framework-0.1.50}/src/pulse/transpiler/imports.py

@@ -293,6 +293,7 @@ class CssImport(Import):
 			- Absolute path (e.g., "/path/to/styles.css")
 		module: If True, import as a CSS module (default export for class access).
 			If False, import for side effects only (global styles).
+			Automatically set to True if path ends with ".module.css".
 		relative: If True, resolve path relative to the caller's file.
 		before: List of import sources that should come after this import.
 
@@ -300,8 +301,8 @@ class CssImport(Import):
 		# Side-effect CSS import (global styles)
 		CssImport("@mantine/core/styles.css")
 
-		# CSS module for class access
-		styles = CssImport("./styles.module.css", module=True, relative=True)
+		# CSS module for class access (module=True auto-detected from .module.css)
+		styles = CssImport("./styles.module.css", relative=True)
 		styles.container  # Returns JSMember for 'container' class
 
 		# Local CSS file (will be copied during codegen)
@@ -316,6 +317,10 @@ class CssImport(Import):
 		relative: bool = False,
 		before: Sequence[str] = (),
 	) -> None:
+		# Auto-detect CSS modules based on filename
+		if path.endswith(".module.css"):
+			module = True
+
 		source_path: Path | None = None
 		import_src = path
 

{pulse_framework-0.1.48 → 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