pulse-framework 0.1.62__tar.gz → 0.1.63__tar.gz

{pulse_framework-0.1.62 → pulse_framework-0.1.63}/PKG-INFO

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

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

{pulse_framework-0.1.62 → pulse_framework-0.1.63}/src/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_framework-0.1.62 → pulse_framework-0.1.63}/src/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_framework-0.1.62 → pulse_framework-0.1.63}/src/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_framework-0.1.63/src/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_framework-0.1.62 → pulse_framework-0.1.63}/src/pulse/transpiler/imports.py

@@ -14,7 +14,8 @@ 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
@@ -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

{pulse_framework-0.1.62 → pulse_framework-0.1.63}/src/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,
@@ -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
 
@@ -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}>"