pulse-framework 0.1.61__py3-none-any.whl → 0.1.63__py3-none-any.whl

pulse/__init__.py

@@ -1410,6 +1410,7 @@ from pulse.render_session import run_js as run_js
 
 # Request
 from pulse.request import PulseRequest as PulseRequest
+from pulse.requirements import require as require
 from pulse.routing import Layout as Layout
 from pulse.routing import Route as Route
 from pulse.routing import RouteInfo as RouteInfo

pulse/app.py

@@ -147,7 +147,7 @@ class App:
 			and lifecycle hooks.
 		cookie: Session cookie configuration.
 		session_store: Session storage backend. Defaults to CookieSessionStore.
-		server_address: Public server URL. Required in production.
+		server_address: Public server URL. Used only in ci/prod.
 		dev_server_address: Development server URL. Defaults to
 			"http://localhost:8000".
 		internal_server_address: Internal URL for server-side loader fetches.
@@ -243,8 +243,8 @@ class App:
 		self.env = envvars.pulse_env
 		self.mode = mode
 		self.status = AppStatus.created
-		# Persist the server address for use by sessions (API calls, etc.)
-		self.server_address = server_address
+		# Persist the server address for use by sessions (API calls, etc.) in ci/prod.
+		self.server_address = server_address if self.env in ("ci", "prod") else None
 		# Development server address (used in dev mode)
 		self.dev_server_address = dev_server_address
 		# Optional internal address used by server-side loader fetches

pulse/cli/dependencies.py

@@ -11,11 +11,10 @@ from pulse.cli.packages import (
 	is_workspace_spec,
 	load_package_json,
 	parse_dependency_spec,
-	parse_install_spec,
 	resolve_versions,
 	spec_satisfies,
 )
-from pulse.transpiler.imports import get_registered_imports
+from pulse.requirements import get_requirements
 
 
 def convert_pep440_to_semver(python_version: str) -> str:
@@ -98,20 +97,12 @@ def get_required_dependencies(
 		"pulse-ui-client": [pulse_version],
 	}
 
-	# New transpiler v2 imports
-	for imp in get_registered_imports():
-		if imp.src:
-			try:
-				spec = parse_install_spec(imp.src)
-			except ValueError as exc:
-				# We might want to be more lenient here or at least log it,
-				# but following existing pattern of raising DependencyError
-				raise DependencyError(str(exc)) from None
-			if spec:
-				name_only, ver = parse_dependency_spec(spec)
-				constraints.setdefault(name_only, []).append(ver)
-				if imp.version:
-					constraints.setdefault(name_only, []).append(imp.version)
+	for src, version in get_requirements():
+		name_only, ver_in_src = parse_dependency_spec(src)
+		if ver_in_src:
+			constraints.setdefault(name_only, []).append(ver_in_src)
+		if version:
+			constraints.setdefault(name_only, []).append(version)
 
 	try:
 		resolved = resolve_versions(constraints)

pulse/component.py

@@ -112,7 +112,7 @@ class Component(Generic[P]):
 			flattened = flatten_children(
 				args,  # pyright: ignore[reportArgumentType]
 				parent_name=f"<{self.name}>",
-				warn_stacklevel=4,
+				warn_stacklevel=None,
 			)
 			args = tuple(flattened)  # pyright: ignore[reportAssignmentType]
 

pulse/js/obj.py

@@ -30,7 +30,6 @@ from typing import TYPE_CHECKING, override
 
 from pulse.transpiler.errors import TranspileError
 from pulse.transpiler.nodes import Expr, Object, Spread, spread_dict
-from pulse.transpiler.vdom import VDOMNode
 
 # TYPE_CHECKING avoids import cycle: Transpiler -> nodes -> Expr -> obj -> Transpiler
 if TYPE_CHECKING:
@@ -53,7 +52,7 @@ class ObjTransformer(Expr):
 		raise TypeError("obj cannot be emitted directly - must be called")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		raise TypeError("obj cannot be rendered - must be called")
 
 	@override

pulse/js/react.py

@@ -32,7 +32,6 @@ from pulse.transpiler.nodes import Call as _Call
 from pulse.transpiler.nodes import Expr as _Expr
 from pulse.transpiler.nodes import Jsx as _Jsx
 from pulse.transpiler.nodes import Node as _PulseNode
-from pulse.transpiler.vdom import VDOMNode as _VDOMNode
 
 if _TYPE_CHECKING:
 	from pulse.transpiler.transpiler import Transpiler as _Transpiler
@@ -432,7 +431,7 @@ class _LazyComponentFactory(_Expr):
 		self._import.emit(out)
 
 	@_override
-	def render(self) -> _VDOMNode:
+	def render(self):
 		raise TypeError("lazy cannot be rendered to VDOM")
 
 	@_override

pulse/renderer.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import inspect
 from collections.abc import Callable, Iterable
 from dataclasses import dataclass
+from types import NoneType
 from typing import Any, NamedTuple, TypeAlias, cast
 
 from pulse.helpers import values_equal
@@ -27,7 +28,6 @@ from pulse.transpiler.vdom import (
 	UpdatePropsDelta,
 	UpdatePropsOperation,
 	VDOMElement,
-	VDOMExpr,
 	VDOMNode,
 	VDOMOperation,
 	VDOMPropValue,
@@ -442,17 +442,20 @@ class Renderer:
 	# Expression + tag rendering
 	# ------------------------------------------------------------------
 
-	def render_tag(self, tag: str | Expr) -> str | VDOMExpr:
+	def render_tag(self, tag: str | Expr):
 		if isinstance(tag, str):
 			return tag
 
 		return self.register_component_expr(tag)
 
-	def register_component_expr(self, expr: Expr) -> str | VDOMExpr:
+	def register_component_expr(self, expr: Expr):
 		ref = registry_ref(expr)
 		if ref is not None:
 			return f"{MOUNT_PREFIX}{ref['key']}"
-		return expr.render()
+		tag = expr.render()
+		if isinstance(tag, (int, float, bool, NoneType)):
+			raise TypeError(f"Invalid element tag: {tag}")
+		return tag
 
 	# ------------------------------------------------------------------
 	# Unmount helper

pulse/requirements.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+
+_REQUIREMENTS: list[tuple[str, str]] = []
+
+
+def add_requirement(name: str, version: str) -> None:
+	if not name or not version:
+		return
+	_REQUIREMENTS.append((name, version))
+
+
+def register_requirements(packages: Mapping[str, str]) -> None:
+	for name, version in packages.items():
+		if not name or not version:
+			continue
+		add_requirement(name, version)
+
+
+def get_requirements() -> list[tuple[str, str]]:
+	return list(_REQUIREMENTS)
+
+
+def clear_requirements() -> None:
+	_REQUIREMENTS.clear()
+
+
+def require(packages: Mapping[str, str]) -> None:
+	"""Register npm package version requirements for dependency syncing."""
+	if not isinstance(packages, Mapping):
+		raise TypeError("require expects a mapping of package names to versions")
+	if not packages:
+		return
+
+	normalized: dict[str, str] = {}
+	for name, version in packages.items():
+		if not isinstance(name, str) or not name.strip():
+			raise TypeError("require expects non-empty package names")
+		if not isinstance(version, str) or not version.strip():
+			raise TypeError(f"require expects a version string for {name!r}")
+		normalized[name.strip()] = version.strip()
+
+	register_requirements(normalized)
+
+
+__all__ = ["require"]

pulse/transpiler/assets.py

@@ -13,6 +13,15 @@ from pathlib import Path
 from pulse.transpiler.emit_context import EmitContext
 from pulse.transpiler.id import next_id
 
+_CSS_MODULE_EXTS = (
+	".css",
+	".scss",
+	".sass",
+	".less",
+	".styl",
+	".stylus",
+)
+
 
 @dataclass(slots=True)
 class LocalAsset:
@@ -23,7 +32,13 @@ class LocalAsset:
 
 	@property
 	def asset_filename(self) -> str:
-		"""Filename in assets folder: stem_id.ext"""
+		"""Filename in assets folder: stem_id.ext (preserve .module.*)."""
+		name = self.source_path.name
+		for ext in _CSS_MODULE_EXTS:
+			module_suffix = f".module{ext}"
+			if name.endswith(module_suffix):
+				base = name[: -len(module_suffix)]
+				return f"{base}_{self.id}{module_suffix}"
 		return f"{self.source_path.stem}_{self.id}{self.source_path.suffix}"
 
 	def import_path(self) -> str:

pulse/transpiler/dynamic_import.py

@@ -28,7 +28,6 @@ from pulse.transpiler.assets import LocalAsset, register_local_asset
 from pulse.transpiler.errors import TranspileError
 from pulse.transpiler.imports import is_local_path, resolve_local_path
 from pulse.transpiler.nodes import Expr, Member
-from pulse.transpiler.vdom import VDOMNode
 
 if TYPE_CHECKING:
 	from pulse.transpiler.transpiler import Transpiler
@@ -56,7 +55,7 @@ class DynamicImport(Expr):
 			out.append(f'import("{self.src}")')
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		raise TypeError("DynamicImport cannot be rendered to VDOM")
 
 	@override
@@ -84,7 +83,7 @@ class DynamicImportFn(Expr):
 		)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		raise TypeError("import_ cannot be rendered to VDOM")
 
 	@override

pulse/transpiler/function.py

@@ -39,7 +39,7 @@ from pulse.transpiler.nodes import (
 	to_js_identifier,
 )
 from pulse.transpiler.transpiler import Transpiler
-from pulse.transpiler.vdom import VDOMNode
+from pulse.transpiler.vdom import VDOMExpr
 
 Args = TypeVarTuple("Args")
 P = ParamSpec("P")
@@ -114,7 +114,7 @@ class Constant(Expr):
 		out.append(self.js_name)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		"""Render as a registry reference."""
 		return {"t": "ref", "key": self.id}
 
@@ -226,7 +226,7 @@ class JsFunction(Expr, Generic[*Args, R]):
 		out.append(self.js_name)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		"""Render as a registry reference."""
 		return {"t": "ref", "key": self.id}
 
@@ -314,7 +314,7 @@ class JsxFunction(Expr, Generic[P, R]):
 		out.append(self.js_name)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		"""Render as a registry reference."""
 		return {"t": "ref", "key": self.id}
 

pulse/transpiler/imports.py

@@ -14,12 +14,13 @@ from typing import (
 )
 from typing import Literal as Lit
 
-from pulse.cli.packages import pick_more_specific
+from pulse.cli.packages import parse_dependency_spec, pick_more_specific
+from pulse.requirements import add_requirement, clear_requirements
 from pulse.transpiler.assets import LocalAsset, register_local_asset
 from pulse.transpiler.errors import TranspileError
 from pulse.transpiler.id import next_id
 from pulse.transpiler.nodes import Call, Expr, to_js_identifier
-from pulse.transpiler.vdom import VDOMNode
+from pulse.transpiler.vdom import VDOMExpr
 
 _P = ParamSpec("_P")
 _R = TypeVar("_R")
@@ -131,6 +132,14 @@ _ImportKey: TypeAlias = tuple[str, str, str, bool]
 _IMPORT_REGISTRY: dict[_ImportKey, "Import"] = {}
 
 
+def _is_alias_path(path: str) -> bool:
+	return path.startswith("@/") or path.startswith("~/")
+
+
+def _is_url(path: str) -> bool:
+	return path.startswith("http://") or path.startswith("https://")
+
+
 def get_registered_imports() -> list["Import"]:
 	"""Get all registered imports."""
 	return list(_IMPORT_REGISTRY.values())
@@ -139,6 +148,7 @@ def get_registered_imports() -> list["Import"]:
 def clear_import_registry() -> None:
 	"""Clear the import registry."""
 	_IMPORT_REGISTRY.clear()
+	clear_requirements()
 
 
 @dataclass(slots=True, init=False)
@@ -240,6 +250,17 @@ class Import(Expr):
 				asset = register_local_asset(resolved)
 				import_src = str(resolved)
 
+		if (
+			not is_local_path(import_src)
+			and not _is_alias_path(import_src)
+			and not _is_url(import_src)
+		):
+			name_only, ver_in_src = parse_dependency_spec(import_src)
+			if ver_in_src:
+				add_requirement(name_only, ver_in_src)
+			if version:
+				add_requirement(name_only, version)
+
 		self.name = name
 		self.src = import_src
 		self.kind = kind
@@ -320,7 +341,7 @@ class Import(Expr):
 		out.append(self.js_name)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		"""Render as a registry reference."""
 		return {"t": "ref", "key": self.id}
 

pulse/transpiler/js_module.py

@@ -23,7 +23,6 @@ from pulse.transpiler.nodes import (
 	New,
 )
 from pulse.transpiler.transpiler import Transpiler
-from pulse.transpiler.vdom import VDOMNode
 
 _MODULE_DUNDERS = frozenset(
 	{
@@ -58,7 +57,7 @@ class Class(Expr):
 		self.ctor.emit(out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		return self.ctor.render()
 
 	@override
@@ -110,7 +109,7 @@ class JsModule(Expr):
 		raise TypeError(f"{label} cannot be emitted directly - access an attribute")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		label = self.py_name or self.name or "JsModule"
 		raise TypeError(f"{label} cannot be rendered directly - access an attribute")
 

pulse/transpiler/modules/pulse/tags.py

@@ -28,7 +28,6 @@ from pulse.transpiler.nodes import (
 )
 from pulse.transpiler.py_module import PyModule
 from pulse.transpiler.transpiler import Transpiler
-from pulse.transpiler.vdom import VDOMNode
 
 
 @dataclass(slots=True, frozen=True)
@@ -46,7 +45,7 @@ class TagExpr(Expr):
 		out.append(f'"{self.tag}"')
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		return self.tag
 
 	@override

pulse/transpiler/modules/typing.py

@@ -9,7 +9,6 @@ from typing import final, override
 from pulse.transpiler.nodes import Expr
 from pulse.transpiler.py_module import PyModule
 from pulse.transpiler.transpiler import Transpiler
-from pulse.transpiler.vdom import VDOMNode
 
 
 @dataclass(slots=True)
@@ -30,7 +29,7 @@ class TypeHint(Expr):
 		)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		raise TypeError(
 			f"Type hint '{self.name}' cannot be rendered. "
 			+ "It should only be used with typing.cast() or similar."

pulse/transpiler/nodes.py

@@ -7,7 +7,7 @@ import warnings
 from abc import ABC, abstractmethod
 from collections.abc import Callable, Iterable, Sequence
 from dataclasses import dataclass, field
-from inspect import isfunction, signature
+from inspect import currentframe, isfunction, signature
 from typing import (
 	TYPE_CHECKING,
 	Any,
@@ -23,7 +23,7 @@ from typing import Literal as Lit
 
 from pulse.env import env
 from pulse.transpiler.errors import TranspileError
-from pulse.transpiler.vdom import VDOMNode
+from pulse.transpiler.vdom import VDOMExpr, VDOMNode, VDOMPrimitive
 
 if TYPE_CHECKING:
 	from pulse.transpiler.transpiler import Transpiler
@@ -132,7 +132,7 @@ class Expr(ABC):
 	# -------------------------------------------------------------------------
 
 	@abstractmethod
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMPrimitive | VDOMExpr:
 		"""Serialize this expression node for client-side rendering.
 
 		Returns a VDOMNode (primitive or dict) that can be JSON-serialized and
@@ -334,7 +334,7 @@ class ExprWrapper(Expr):
 		self.expr.emit(out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMPrimitive | VDOMExpr:
 		return self.expr.render()
 
 	@override
@@ -500,7 +500,7 @@ class Value(Expr):
 		_emit_value(self.value, out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		raise TypeError(
 			"Value cannot be rendered as VDOMExpr; unwrap with .value instead"
 		)
@@ -540,15 +540,13 @@ class Element(Expr):
 			self.children = None
 		else:
 			if isinstance(tag, str):
-				parent_name = tag[2:] if tag.startswith("$$") else tag
+				parent_name: str | Expr = tag[2:] if tag.startswith("$$") else tag
 			else:
-				tag_out: list[str] = []
-				tag.emit(tag_out)
-				parent_name = "".join(tag_out)
+				parent_name = tag
 			self.children = flatten_children(
 				children,
 				parent_name=parent_name,
-				warn_stacklevel=5,
+				warn_stacklevel=None,
 			)
 		self.key = key
 
@@ -733,7 +731,7 @@ class Element(Expr):
 		return result
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		"""Element rendering is handled by Renderer.render_node(), not render().
 
 		This method validates render-time constraints and raises TypeError
@@ -787,7 +785,7 @@ class PulseNode:
 		flat = flatten_children(
 			children_arg,
 			parent_name=parent_name,
-			warn_stacklevel=5,
+			warn_stacklevel=None,
 		)
 		return PulseNode(
 			fn=self.fn,
@@ -804,8 +802,8 @@ class PulseNode:
 def flatten_children(
 	children: Sequence[Node | Iterable[Node]],
 	*,
-	parent_name: str,
-	warn_stacklevel: int = 5,
+	parent_name: str | Expr,
+	warn_stacklevel: int | None = None,
 ) -> list[Node]:
 	if env.pulse_env == "dev":
 		return _flatten_children_dev(
@@ -835,13 +833,14 @@ def _flatten_children_prod(children: Sequence[Node | Iterable[Node]]) -> list[No
 def _flatten_children_dev(
 	children: Sequence[Node | Iterable[Node]],
 	*,
-	parent_name: str,
-	warn_stacklevel: int = 5,
+	parent_name: str | Expr,
+	warn_stacklevel: int | None = None,
 ) -> list[Node]:
 	flat: list[Node] = []
 	seen_keys: set[str] = set()
 
 	def visit(item: Node | Iterable[Node]) -> None:
+		nonlocal warn_stacklevel
 		if isinstance(item, dict):
 			raise TypeError("Dict is not a valid child")
 		if isinstance(item, Iterable) and not isinstance(item, str):
@@ -853,6 +852,32 @@ def _flatten_children_dev(
 					missing_key = True
 				visit(sub)  # type: ignore[arg-type]
 			if missing_key:
+				if warn_stacklevel is None:
+					stacklevel = 1
+					frame = currentframe()
+					if frame is not None:
+						frame = frame.f_back
+						internal_prefixes = (
+							"pulse",
+							"pulse_mantine",
+							"pulse_ag_grid",
+							"pulse_recharts",
+							"pulse_lucide",
+							"pulse_msal",
+							"pulse_aws",
+						)
+						while frame is not None:
+							module = frame.f_globals.get("__name__", "")
+							if module and not any(
+								module == prefix or module.startswith(f"{prefix}.")
+								for prefix in internal_prefixes
+							):
+								break
+							stacklevel += 1
+							frame = frame.f_back
+						if frame is not None:
+							stacklevel += 1
+					warn_stacklevel = stacklevel
 				clean_name = clean_element_name(parent_name)
 				warnings.warn(
 					(
@@ -888,7 +913,25 @@ def _flatten_children_dev(
 	return flat
 
 
-def clean_element_name(parent_name: str) -> str:
+def clean_element_name(parent_name: str | Expr) -> str:
+	def expr_name(expr: Expr) -> str:
+		while isinstance(expr, ExprWrapper):
+			expr = expr.expr
+		if isinstance(expr, Member):
+			base = expr_name(expr.obj)
+			return f"{base}.{expr.prop}" if base else expr.prop
+		if isinstance(expr, Identifier):
+			return expr.name
+		if expr.__class__.__name__ == "Import":
+			name = getattr(expr, "name", None)
+			if isinstance(name, str) and name:
+				return name
+		out: list[str] = []
+		expr.emit(out)
+		return "".join(out)
+
+	if isinstance(parent_name, Expr):
+		parent_name = expr_name(parent_name)
 	if parent_name.startswith("<") and parent_name.endswith(">"):
 		return parent_name
 	return f"<{parent_name}>"
@@ -916,7 +959,7 @@ class Identifier(Expr):
 		out.append(self.name)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {"t": "id", "name": self.name}
 
 
@@ -940,7 +983,7 @@ class Literal(Expr):
 			out.append(str(self.value))
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMPrimitive:
 		return self.value
 
 
@@ -958,7 +1001,7 @@ class Undefined(Expr):
 		out.append("undefined")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {"t": "undef"}
 
 
@@ -982,7 +1025,7 @@ class Array(Expr):
 		out.append("]")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {"t": "array", "items": [e.render() for e in self.elements]}
 
 
@@ -1014,7 +1057,7 @@ class Object(Expr):
 		out.append("}")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		rendered_props: dict[str, VDOMNode] = {}
 		for prop in self.props:
 			if isinstance(prop, Spread):
@@ -1038,7 +1081,7 @@ class Member(Expr):
 		out.append(self.prop)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {"t": "member", "obj": self.obj.render(), "prop": self.prop}
 
 
@@ -1057,7 +1100,7 @@ class Subscript(Expr):
 		out.append("]")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {"t": "sub", "obj": self.obj.render(), "key": self.key.render()}
 
 
@@ -1079,7 +1122,7 @@ class Call(Expr):
 		out.append(")")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {
 			"t": "call",
 			"callee": self.callee.render(),
@@ -1110,7 +1153,7 @@ class Unary(Expr):
 		_emit_paren(self.operand, self.op, "unary", out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		if self.op == "await":
 			raise TypeError("await is not supported in VDOM expressions")
 		return {"t": "unary", "op": self.op, "arg": self.operand.render()}
@@ -1148,7 +1191,7 @@ class Binary(Expr):
 		_emit_paren(self.right, self.op, "right", out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {
 			"t": "binary",
 			"op": self.op,
@@ -1178,7 +1221,7 @@ class Ternary(Expr):
 		self.else_.emit(out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {
 			"t": "ternary",
 			"cond": self.cond.render(),
@@ -1224,7 +1267,7 @@ class Arrow(Expr):
 			out.append("}")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		if not isinstance(self.body, Expr):
 			raise TypeError("Arrow with statement body cannot be rendered as VDOMExpr")
 		return {"t": "arrow", "params": list(self.params), "body": self.body.render()}
@@ -1253,7 +1296,7 @@ class Template(Expr):
 		out.append("`")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		rendered_parts: list[str | VDOMNode] = []
 		for p in self.parts:
 			if isinstance(p, str):
@@ -1275,7 +1318,7 @@ class Spread(Expr):
 		self.expr.emit(out)
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		raise TypeError("Spread cannot be rendered as VDOMExpr directly")
 
 
@@ -1313,7 +1356,7 @@ class New(Expr):
 		out.append(")")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		return {
 			"t": "new",
 			"ctor": self.ctor.render(),
@@ -1377,7 +1420,7 @@ class Transformer(Expr, Generic[_F]):
 		raise TypeError(f"{label} cannot be subscripted")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		label = self.name or "Transformer"
 		raise TypeError(f"{label} cannot be rendered - must be called")
 
@@ -1677,7 +1720,7 @@ class Function(Expr):
 		out.append("}")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self) -> VDOMExpr:
 		raise TypeError("Function cannot be rendered as VDOMExpr")
 
 

pulse/transpiler/py_module.py

@@ -11,7 +11,6 @@ from types import ModuleType
 from typing import TYPE_CHECKING, Any, ClassVar, cast, override
 
 from pulse.transpiler.nodes import Expr, Primitive, Transformer
-from pulse.transpiler.vdom import VDOMNode
 
 if TYPE_CHECKING:
 	from pulse.transpiler.transpiler import Transpiler
@@ -62,7 +61,7 @@ class PyModule(Expr):
 		raise TypeError(f"{label} cannot be emitted directly")
 
 	@override
-	def render(self) -> VDOMNode:
+	def render(self):
 		label = self.name or "PyModule"
 		raise TypeError(f"{label} cannot be rendered directly")
 

{pulse_framework-0.1.61.dist-info → pulse_framework-0.1.63.dist-info}/METADATA

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

{pulse_framework-0.1.61.dist-info → pulse_framework-0.1.63.dist-info}/RECORD

@@ -1,10 +1,10 @@
-pulse/__init__.py,sha256=_7WUYtxNI78XXdnVu0CFTxRInlCEaP1tGEf-WXMU48I,31993
+pulse/__init__.py,sha256=hf1FFA4EDRxFNiPQoKwQfNHtnCf4UT7STqzgbjJ7dgI,32043
 pulse/_examples.py,sha256=dFuhD2EVXsbvAeexoG57s4VuN4gWLaTMOEMNYvlPm9A,561
-pulse/app.py,sha256=JqxDN1pR-DU_VScF7JXivJpWoHAfsmWdiNOWLoSd_rI,35095
+pulse/app.py,sha256=KnP6U8uHgfBbFMguDcVk0KgjakY1UC1NJk2rS5l6Sas,35145
 pulse/channel.py,sha256=sQrDLh3k9Z8CyJQkEHzKu4h-yR4XSTgAA3OCQax3Ciw,15766
 pulse/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/cli/cmd.py,sha256=zh3Ah6c16cNg3o_v_If_S58Qe8rvxNe5M2VrTkwvDU8,15957
-pulse/cli/dependencies.py,sha256=ezFw-7YWnJcvB1k25b0nB_OaOaP-EKtleNtBE2oJUUk,4603
+pulse/cli/dependencies.py,sha256=qU-rF7QyP0Rl1Fl0YKQubrGNBzj84BAbH1uUT3ehxik,4283
 pulse/cli/folder_lock.py,sha256=-AKld2iM91G0uHB3F5ARD0QAjOw0TmsYYGaFgy_V350,3477
 pulse/cli/helpers.py,sha256=XXRRXeGFgeq-jbp0QGFFVq_aGg_Kp7_AkYsTK8LfSdg,7810
 pulse/cli/logging.py,sha256=3uuB1dqI-lHJkodNUURN6UMWdKF5UQ9spNG-hBG7bA4,2516
@@ -21,7 +21,7 @@ pulse/codegen/templates/layout.py,sha256=nmWPQcO9SRXc3mCCVLCmykreSF96TqQfdDY7dvU
 pulse/codegen/templates/route.py,sha256=UjBrb3e_8tMkd1OjBjEsnYmK6PCQqOYZBWDuU59FcrI,9234
 pulse/codegen/templates/routes_ts.py,sha256=nPgKCvU0gzue2k6KlOL1TJgrBqqRLmyy7K_qKAI8zAE,1129
 pulse/codegen/utils.py,sha256=QoXcV-h-DLLmq_t03hDNUePS0fNnofUQLoR-TXzDFCY,539
-pulse/component.py,sha256=TVgV0dgNDf2Smt2xsJVD0-Wejsnqm14n-NxBzsdObjc,6227
+pulse/component.py,sha256=mY4ZTX7XKXGXAiVwTec1YR3_HOJf6uTdZcxCT_WX5Gs,6230
 pulse/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/components/for_.py,sha256=lrt1JHegf4OkBbL9nrMOy7zxmbuD8Kn11x32ZGS72lY,2390
 pulse/components/if_.py,sha256=5IOq3R70B-JdI-fvDNYDyAaSEtO8L5OaiqHp-jUn-Kw,2153
@@ -60,11 +60,11 @@ pulse/js/map.py,sha256=bhw75CUMIearH4JACCs9zAffdzfla3Rae7SKGcCLGoc,2243
 pulse/js/math.py,sha256=OBbMlgoa6ZHLDgmXGNKMj5wYrvroV5ICIx-VsSE5_II,1757
 pulse/js/navigator.py,sha256=2QWSr9xyyBfgd76P472qmayXQRYXIEo-b8zLzvfhHfg,1517
 pulse/js/number.py,sha256=fX2M6hZ5ry2FPsYaHhGlqgO6reBEXw7C-gtu0-8_Zyw,1262
-pulse/js/obj.py,sha256=75NlJ7gsaMAXyYGXEeG5E4QKuKCy3ls9mDexodwxPyw,2085
+pulse/js/obj.py,sha256=8JG9OZZ1CNqAFoMTdYtxWhTmb6zs1BqxC-nLT7KYMF8,2030
 pulse/js/object.py,sha256=95WvnGWgB-PL-D7l12UgdxNy_fxO5sJXool3Rx5ahUQ,4433
 pulse/js/promise.py,sha256=vBXcL-U9BuZN-q1jbYhyzQaOL2niDPw4LsD7q7Y_yco,4670
 pulse/js/pulse.py,sha256=m-LgqwhYygVBj7GzjeO-uo8fK5ThyVe7c3QvOJt_vc0,2962
-pulse/js/react.py,sha256=YGbWJcvYIrF__UW4xW1v5HcaIdSSUuDRJWOPK5DQKGw,12126
+pulse/js/react.py,sha256=eRMrgM8RsoAIn2lcHDoUYas3l4tImLOW51dwmw9AxQU,12057
 pulse/js/regexp.py,sha256=qO-3nmt7uGN7V_bwimPCN-2RSsPfE6YiY7G1MjoP3YY,1055
 pulse/js/set.py,sha256=omG3g-25GRHxgoKISSB4x-M8UDFlaXtFV9cSIpd5uB0,3017
 pulse/js/string.py,sha256=VsvDF_ve8R9QIiBdDotLP2KpCKwmpEfGgRQWckOCmHk,813
@@ -89,38 +89,39 @@ pulse/react_component.py,sha256=8RLg4Bi7IcjqbnbEnp4hJpy8t1UsE7mG0UR1Q655LDk,2332
 pulse/reactive.py,sha256=FxxpH7NBtQr7G89iCVN7y1EG21f23GcRi1M-XIxcRQA,31280
 pulse/reactive_extensions.py,sha256=yQ1PpdAh4kMvll7R15T72FOg8NFdG_HGBsGc63dawYk,33754
 pulse/render_session.py,sha256=9gfwuBZRCWuQMN_nFuaAi__1UPN3I3C1mKWtAXyA3-A,21340
-pulse/renderer.py,sha256=vXVd63Ox7f3of9_n6bN66KE96SvOYoc-PqzlRc09xvo,15907
+pulse/renderer.py,sha256=fjSsUvCqV12jyN7Y5XspKUfjQJJzKX-Chha5oF5PrAk,16001
 pulse/request.py,sha256=N0oFOLiGxpbgSgxznjvu64lG3YyOcZPKC8JFyKx6X7w,6023
+pulse/requirements.py,sha256=nMnE25Uu-TUuQd88jW7m2xwus6fD-HvXxQ9UNb7OOGc,1254
 pulse/routing.py,sha256=LzTITvGgaLI1w7qTDZjFwoBcWAb4O8Dz7AmXeTNYrFU,16903
 pulse/serializer.py,sha256=HmQZgxQiaCx2SL2XwmEQLd_xsk_P8XfLtGciLLLOxx0,7616
 pulse/state.py,sha256=VMphVpYNU1CyHMMg1_kNJO3cfqLXJPAuq9gr9RYyUAw,15922
 pulse/test_helpers.py,sha256=4iO5Ymy3SMvSjh-UaAaSdqm1I_SAJMNjdY2iYVro5f8,436
 pulse/transpiler/__init__.py,sha256=wDDnzqxgHpp_OLtcgyrJEg2jVoTnFIe3SSSTOsMDW8w,4700
-pulse/transpiler/assets.py,sha256=FHielogI5NrFwst5H94E49YWYFX7Tp1rwJHCcowT3P0,1974
+pulse/transpiler/assets.py,sha256=digd5hKYPEgLOzMtDBHULX3Adj1sfngdvnx3quQmgPY,2299
 pulse/transpiler/builtins.py,sha256=QZrow7XJ2wxGMAE-mgZmaUD03egOnXCbikOg8yMx9vQ,30807
-pulse/transpiler/dynamic_import.py,sha256=JECOyJMfusKYms7uwyHIqv4QabDnnPMweMqSXhp2m-4,3439
+pulse/transpiler/dynamic_import.py,sha256=1AmBl6agGSoTZBp_94seXH733fewLOULUix9BOBPtKI,3372
 pulse/transpiler/emit_context.py,sha256=GyK6VdsBSTVIewQRhBagaV0hlqLTlPZ1i8EAZGi8SaY,1321
 pulse/transpiler/errors.py,sha256=LSBjLBnMglbl2D94p9JR4y-3jDefk6iHSlUVBaBOTu4,2823
-pulse/transpiler/function.py,sha256=Pf5eoyzKHpn3d2EvCCYtARMnn_ixpAl7IZmY1fhmDIk,17036
+pulse/transpiler/function.py,sha256=a871LZFergCmjs1vr-XlOx4eU1FQKAuYxSLJej-LHHc,17036
 pulse/transpiler/id.py,sha256=CdgA1NndBpZjv0Hp4XiYbKn7wi-x4zWsFSjEiViKxVk,434
-pulse/transpiler/imports.py,sha256=BW2y6Ftvn21hUl-A40gnW6toBAZ0tc4gsnyEXroyDFU,9702
-pulse/transpiler/js_module.py,sha256=81aiJmf-BW8MGEgFggYrZ3m1FmOHShaxpR0Y5VVFQmg,11160
+pulse/transpiler/imports.py,sha256=gWLjRr9jakbUzBGDEepE2RI5Xn_UZwOD4TmlqjNIapM,10302
+pulse/transpiler/js_module.py,sha256=OcIgmrfiA6Hh6aukzgkyX63KsVSHdLzx5ezdKiJFUaQ,11093
 pulse/transpiler/modules/__init__.py,sha256=JGi3CuZoF4sug4dNhQg3MFhpEQqnXec4xRJM2cHNP3c,1184
 pulse/transpiler/modules/asyncio.py,sha256=kWMuFU2vZbqutCM_EXJMvy5SdlB66XiT0czs8lELj_o,1584
 pulse/transpiler/modules/json.py,sha256=Zxe8dsaQ0Eoq3yHUiJeKEx6ibiN36HCT61ScFkLFCeY,676
 pulse/transpiler/modules/math.py,sha256=8gjvdYTMqtuOnXrvX_Lwuo0ywAdSl7cpss4TMk6mQtQ,7044
 pulse/transpiler/modules/pulse/__init__.py,sha256=TfMsiiB53ZFlxdNl7jfCAiMZs-vSRUTxUmqzkLTj-po,91
-pulse/transpiler/modules/pulse/tags.py,sha256=YFodKrhmt4DH7QtjTBdVvK5J6Qq2ntfhzb50tP-PTac,6273
-pulse/transpiler/modules/typing.py,sha256=hMGff6gBscFJE2GPV9xUFNfLuff2QCMIbMJUs3f24BY,1771
-pulse/transpiler/nodes.py,sha256=BI6maJdQ3KXyVHB-rf4H8ffp3nWpLZ2K6ZNUXzkj2vc,50424
-pulse/transpiler/py_module.py,sha256=YYSeroGInkXsoy39Y34Oxj1mrwDQnbSFVEgWru7vqG0,4465
+pulse/transpiler/modules/pulse/tags.py,sha256=FMN1mWMlnsXa2qO6VmXxUAhFn1uOfGoKPQOjH4ZPlRE,6218
+pulse/transpiler/modules/typing.py,sha256=J9QCkXE6zzwMjiprX2q1BtK-iKLIiS21sQ78JH4RSMc,1716
+pulse/transpiler/nodes.py,sha256=xJSUb0PfqyfvG85ZnUwZMzUs4JVeCJTw87biI2K2UC8,51742
+pulse/transpiler/py_module.py,sha256=um4BYLrbs01bpgv2LEBHTbhXXh8Bs174c3ygv5tHHOg,4410
 pulse/transpiler/transpiler.py,sha256=28diEp1yZTs3RsUEJZZdCv1DfzgO9WyOGI-xSHe7y_4,32562
 pulse/transpiler/vdom.py,sha256=Ie36iHa2bkUbui5iMClbMSFDGlKaNxI98Ux0JLPCGT4,6399
 pulse/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/types/event_handler.py,sha256=psQCydj-WEtBcFU5JU4mDwvyzkW8V2O0g_VFRU2EOHI,1618
 pulse/user_session.py,sha256=nsnsMgqq2xGJZLpbHRMHUHcLrElMP8WcA4gjGMrcoBk,10208
 pulse/version.py,sha256=711vaM1jVIQPgkisGgKZqwmw019qZIsc_QTae75K2pg,1895
-pulse_framework-0.1.61.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-pulse_framework-0.1.61.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
-pulse_framework-0.1.61.dist-info/METADATA,sha256=_rF3PxyuZJ5lKy4-pEX8LP9dZrstrw46DMxMypRNgUg,8300
-pulse_framework-0.1.61.dist-info/RECORD,,
+pulse_framework-0.1.63.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.63.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.63.dist-info/METADATA,sha256=Owdkmpwk6VaYMBTca7Xx5Fo2r2VS6lEf9ja-HB8BwtM,8300
+pulse_framework-0.1.63.dist-info/RECORD,,