pulse-framework 0.1.44__py3-none-any.whl → 0.1.47__py3-none-any.whl

pulse/transpiler/utils.py

@@ -0,0 +1,4 @@
+from collections.abc import Callable
+from typing import Any
+
+AnyCallable = Callable[..., Any]

pulse/types/event_handler.py

@@ -1,9 +1,10 @@
-from collections.abc import Awaitable, Callable
+from collections.abc import Callable
 from typing import (
+	Any,
 	TypeVar,
 )
 
-EventHandlerResult = None | Awaitable[None]
+EventHandlerResult = Any
 
 T1 = TypeVar("T1", contravariant=True)
 T2 = TypeVar("T2", contravariant=True)

pulse/vdom.py

@@ -6,6 +6,8 @@ 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
 from inspect import Parameter, signature
@@ -13,18 +15,71 @@ from types import NoneType
 from typing import (
 	Any,
 	Generic,
+	Literal,
 	NamedTuple,
 	NotRequired,
 	ParamSpec,
 	TypeAlias,
 	TypedDict,
+	final,
 	overload,
 	override,
 )
 
+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
 # ============================================================================
@@ -42,11 +97,16 @@ class Callback(NamedTuple):
 	n_args: int
 
 
-def NOOP(*_args: Any):
-	return None
-
-
+@final
 class Node:
+	__slots__ = (
+		"tag",
+		"props",
+		"children",
+		"allow_children",
+		"key",
+	)
+
 	tag: str
 	props: dict[str, Any] | None
 	children: "Sequence[Element] | None"
@@ -75,6 +135,12 @@ class Node:
 			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)
 
 	# --- Pretty printing helpers -------------------------------------------------
 	@override
@@ -199,6 +265,15 @@ 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)
+		if self._takes_children and args:
+			flattened = _flatten_children(
+				args,  # pyright: ignore[reportArgumentType]
+				parent_name=f"<{self.name}>",
+				warn_stacklevel=4,
+			)
+			args = tuple(flattened)  # pyright: ignore[reportAssignmentType]
+
 		return ComponentNode(
 			fn=self.fn,
 			key=key,
@@ -217,7 +292,19 @@ class Component(Generic[P]):
 		return self.name
 
 
+@final
 class ComponentNode:
+	__slots__ = (
+		"fn",
+		"args",
+		"kwargs",
+		"key",
+		"name",
+		"takes_children",
+		"hooks",
+		"contents",
+	)
+
 	fn: Callable[..., Any]
 	args: tuple[Any, ...]
 	kwargs: dict[str, Any]
@@ -225,6 +312,7 @@ class ComponentNode:
 	name: str
 	takes_children: bool
 	hooks: HookContext
+	contents: "Element | None"
 
 	def __init__(
 		self,
@@ -242,8 +330,19 @@ class ComponentNode:
 		self.name = name or _infer_component_name(fn)
 		self.takes_children = takes_children
 		# Used for rendering
-		self.contents: Element | None = None
+		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:
@@ -259,7 +358,7 @@ class ComponentNode:
 			children_arg = (children_arg,)
 		# Flatten children for ComponentNode as well
 		flattened_children = _flatten_children(
-			children_arg, parent_name=f"<{self.name}>"
+			children_arg, parent_name=f"<{self.name}>", warn_stacklevel=4
 		)
 		result = ComponentNode(
 			fn=self.fn,
@@ -310,33 +409,133 @@ Callbacks = dict[str, Callback]
 VDOM: TypeAlias = VDOMNode | Primitive
 Props = dict[str, Any]
 
+
+# ============================================================================
+# VDOM Operations (updates sent from server to client)
+# ============================================================================
+
+
+class ReplaceOperation(TypedDict):
+	type: Literal["replace"]
+	path: str
+	data: VDOM
+
+
+# This payload makes it easy for the client to rebuild an array of React nodes
+# from the previous children array:
+# - Allocate array of size N
+# - For i in 0..N-1, check the following scenarios
+#   - i matches the next index in `new` -> use provided tree
+#   - i matches the next index in `reuse` -> reuse previous child
+#   - otherwise, reuse the element at the same index
+class ReconciliationOperation(TypedDict):
+	type: Literal["reconciliation"]
+	path: str
+	N: int
+	new: tuple[list[int], list[VDOM]]
+	reuse: tuple[list[int], list[int]]
+
+
+class UpdatePropsDelta(TypedDict, total=False):
+	# Only send changed/new keys under `set` and removed keys under `remove`
+	set: Props
+	remove: list[str]
+
+
+class UpdatePropsOperation(TypedDict):
+	type: Literal["update_props"]
+	path: str
+	data: UpdatePropsDelta
+
+
+class PathDelta(TypedDict, total=False):
+	add: list[str]
+	remove: list[str]
+
+
+class UpdateCallbacksOperation(TypedDict):
+	type: Literal["update_callbacks"]
+	path: str
+	data: PathDelta
+
+
+class UpdateRenderPropsOperation(TypedDict):
+	type: Literal["update_render_props"]
+	path: str
+	data: PathDelta
+
+
+class UpdateJsExprPathsOperation(TypedDict):
+	type: Literal["update_jsexpr_paths"]
+	path: str
+	data: PathDelta
+
+
+VDOMOperation: TypeAlias = (
+	ReplaceOperation
+	| UpdatePropsOperation
+	| ReconciliationOperation
+	| UpdateCallbacksOperation
+	| UpdateRenderPropsOperation
+	| UpdateJsExprPathsOperation
+)
+
+
 # ----------------------------------------------------------------------------
 # Component naming heuristics
 # ----------------------------------------------------------------------------
 
 
-def _flatten_children(children: Children, *, parent_name: str) -> Sequence[Element]:
-	"""Flatten children and emit warnings for unkeyed iterables."""
+def _clean_parent_name_for_warning(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>.
+	This function strips the $$ prefix and _1a2b suffix to show just the component name.
+	"""
+
+	# Match ReactComponent tags: <$$ComponentName_hex> or <$$ComponentName_hex.prop>
+	# Strip the $$ prefix and _hex suffix but keep the rest (hex digits are 0-9, a-f)
+	return re.sub(r"\$\$([^_]+)_[0-9a-f]+", r"\1", parent_name)
+
+
+def _flatten_children(
+	children: Children, *, parent_name: str, warn_stacklevel: int = 5
+) -> Sequence[Element]:
+	"""Flatten children and emit warnings for unkeyed iterables (dev mode only).
+
+	Args:
+		children: The children sequence to flatten.
+		parent_name: Name of the parent element for error messages.
+		warn_stacklevel: Stack level for warnings. Adjust based on call site:
+			- 5 for Node.__init__ via tag factory (user -> tag factory -> Node.__init__ -> _flatten_children -> visit -> warn)
+			- 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:
 		if isinstance(item, Iterable) and not isinstance(item, str):
 			# If any Node/ComponentNode yielded by this iterable lacks a key,
-			# emit a single warning for this iterable.
+			# emit a single warning for this iterable (dev mode only).
 			missing_key = False
 			for sub in item:
-				if isinstance(sub, (Node, ComponentNode)) and sub.key is None:
+				if (
+					is_dev
+					and isinstance(sub, (Node, ComponentNode))
+					and sub.key is None
+				):
 					missing_key = True
 				visit(sub)
 			if missing_key:
-				# Warn once per iterable without keys on its elements
+				# Warn once per iterable without keys on its elements.
+				clean_name = _clean_parent_name_for_warning(parent_name)
 				warnings.warn(
 					(
-						f"[Pulse] Iterable children of {parent_name} contain elements without 'key'. "
+						f"[Pulse] Iterable children of {clean_name} contain elements without 'key'. "
 						"Add a stable 'key' to each element inside iterables to improve reconciliation."
 					),
-					stacklevel=3,
+					stacklevel=warn_stacklevel,
 				)
 		else:
 			# Not an iterable child: must be a Element or primitive

{pulse_framework-0.1.44.dist-info → pulse_framework-0.1.47.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.44
+Version: 0.1.47
 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.47.dist-info/RECORD

@@ -0,0 +1,119 @@
+pulse/__init__.py,sha256=F97Jf6i99NXZe05ICjGbBjIaT4JURdh7dC1T1-Gnb0o,32790
+pulse/app.py,sha256=57o_FrJjKxMDkbxKTzeCUtBRXHfGrCbSpJUnP0Z8evg,31474
+pulse/channel.py,sha256=d9eLxgyB0P9UBVkPkXV7MHkC4LWED1Cq3GKsEu_SYy4,13056
+pulse/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/cli/cmd.py,sha256=UBT7OoqWRU-idLOKkA9TDN8m8ugi1gwRMiUJTUmkVfU,14853
+pulse/cli/dependencies.py,sha256=ZBqBAfMvMBQUvh4THdPDztTMQ_dyR52S1IuotP_eEZs,5623
+pulse/cli/folder_lock.py,sha256=kvUmZBg869lwCTIZFoge9dhorv8qPXHTWwVv_jQg1k8,3477
+pulse/cli/helpers.py,sha256=8bRlV3d7w3w-jHaFvFYt9Pzue6_CbKOq_Z3jBsBOeUk,8820
+pulse/cli/models.py,sha256=NBV5byBDNoAQSk0vKwibLjoxuA85XBYIyOVJn64L8oU,858
+pulse/cli/packages.py,sha256=e7ycwwJfdmB4pzrai4DHos6-JzyUgmE4DCZp0BqjdeI,6792
+pulse/cli/processes.py,sha256=C1xU72oUanj-1Mkc9WmqESTsVUn_aUHG8URiPyRHSFM,7016
+pulse/cli/secrets.py,sha256=dNfQe6AzSYhZuWveesjCRHIbvaPd3-F9lEJ-kZA7ROw,921
+pulse/cli/uvicorn_log_config.py,sha256=f7ikDc5foXh3TmFMrnfnW8yev48ZAdlo8F4F_aMVoVk,2391
+pulse/codegen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/codegen/codegen.py,sha256=hK2gh2hX8ARMdQiQ3ILj6NMOuNiCbcuTdgNrtt4ex-8,9525
+pulse/codegen/js.py,sha256=yw2RKQhiSBZr_FL-3WpZoAhcYCvuPEZXTzP5p9i7mCY,1540
+pulse/codegen/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/codegen/templates/layout.py,sha256=nmWPQcO9SRXc3mCCVLCmykreSF96TqQfdDY7dvUBxRg,4737
+pulse/codegen/templates/route.py,sha256=ionwEoTq0aAIE3lmnFyHLAlFnpKOT0QZm_XhTL_ZDNQ,10447
+pulse/codegen/templates/routes_ts.py,sha256=nPgKCvU0gzue2k6KlOL1TJgrBqqRLmyy7K_qKAI8zAE,1129
+pulse/codegen/utils.py,sha256=QoXcV-h-DLLmq_t03hDNUePS0fNnofUQLoR-TXzDFCY,539
+pulse/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/components/for_.py,sha256=LUyJEUlDM6b9oPjvUFgSsddxu6b6usF4BQdXe8FIiGI,1302
+pulse/components/if_.py,sha256=rQywsmdirNpkb-61ZEdF-tgzUh-37JWd4YFGblkzIdQ,1624
+pulse/components/react_router.py,sha256=TbRec-NVliUqrvAMeFXCrnDWV1rh6TGTPfRhqLuLubk,1129
+pulse/context.py,sha256=fMK6GdQY4q_3452v5DJli2f2_urVihnpzb-O-O9cJ1Q,1734
+pulse/cookies.py,sha256=c7ua1Lv6mNe1nYnA4SFVvewvRQAbYy9fN5G3Hr_Dr5c,5000
+pulse/decorators.py,sha256=ywNgLN6VFcKOM5fbFdUUzh-DWk4BuSXdD1BTfd1N-0U,4827
+pulse/env.py,sha256=p3XI8KG1ZCcXPD3LJP7fW8JPYfyvoYY5ENwae2o0PiA,2889
+pulse/form.py,sha256=UHVyp9fIZaM-Bi9_he8FBT8A2tI7bnRCn1dJkOat0zw,9022
+pulse/helpers.py,sha256=sAIA_X2p6-AEg1Y87NejCZvV82_FtNpePX1Z0sFsdh8,15005
+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/setup.py,sha256=c_uVi0S0HPioEvjdWUaSdAGT9M3Cxpw8J-llvtmDOGo,4496
+pulse/hooks/stable.py,sha256=mLNS6WyA4tC-65gNybPOE0DLEz1YlxOCddD9odElArU,1772
+pulse/hooks/states.py,sha256=fFqN3gf7v7rY6QmieKWN1hVCQRRnL-5H4TeG9LTnKSc,6778
+pulse/html/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/html/elements.py,sha256=YHXkVpfMAC4-0o61fK-E0LGTOM3KMCtBfpHHAwLx7dw,23241
+pulse/html/events.py,sha256=SiZxaQV340hc5YGoKWXC5uCmbLsuijuEgnQz1hmdqYg,14700
+pulse/html/props.py,sha256=FMXGHcO6GhTYp2Uw_6LpjDH5b-fVR88to3YlLvysjAM,26731
+pulse/html/svg.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/html/tags.py,sha256=NEH1otY0mURAl8STVunWzBC3fnmiwGqxcPucBPmtVzU,7568
+pulse/html/tags.pyi,sha256=y0zHmPDmZbkPUbO8YJ8Yaw47NicoorOU-xjCTWWB_NM,14094
+pulse/js/__init__.py,sha256=nI_FQpUlLUyCTmpj5cIbpNXjN7Oqwmp5je13ixB9pWw,3104
+pulse/js/__init__.pyi,sha256=Xrub3LEm4JjyNTIyehm-Bfyy2gmpJgvFsEoRfpmq7bg,2624
+pulse/js/_types.py,sha256=zkXtH1B7qURL24VFBPbyH3VIO1H2ptPaU2iE9ZHLDkQ,7402
+pulse/js/array.py,sha256=WC7Z_A_dsf0_uyRTjuWqkTftBWXnNDdHzZJ4pvCqjsE,7102
+pulse/js/console.py,sha256=rAbKq9uMYmsAsQ4j2crYpIoFkrfGHPWdPyU62zHQyWc,1818
+pulse/js/date.py,sha256=lqPpZMhOR5bLxqEe9vyCWBKv6PPKfN_Ikwc-WAmu_NQ,3392
+pulse/js/document.py,sha256=nS8C6e5rMMH8dKvwfO6WkfQElqrBxK-EKhl5JUUCzSA,3015
+pulse/js/error.py,sha256=8zQPumWEssBK_gIcFOQu_TZGPNwcH5N6Yd6C0COElxM,2763
+pulse/js/json.py,sha256=mPvJ0meHNuHrjXOJ7PfC_g1kOldAk_w7xYKA2dhwSUs,1945
+pulse/js/map.py,sha256=Q8EAbkrlg1P30nKrx0MoLsmMS25Y860-lnoPzyZ0yLQ,2056
+pulse/js/math.py,sha256=EwVnFN4MfHlY-QFz4_35BIsLEjfOyisTqoOfYHnp-mM,1801
+pulse/js/navigator.py,sha256=viUQGCO18R_UvWhrdWj1x1IzDd6ZZYcb_m0bI5n8fms,1539
+pulse/js/number.py,sha256=d64aZ8VEJSDN8vMzLvL0LnotRhG0bLrMg1IoLf23na8,1321
+pulse/js/object.py,sha256=l5OzfKS_kiUnrzRk4HAhjOOVUAJ8q-VWZv-4pADDtjc,4808
+pulse/js/promise.py,sha256=OnENcz7k0V6oGRtIxp-4LbGdurqd4aFMrFfWibm26Y0,4438
+pulse/js/regexp.py,sha256=vHI8xI2QOT-dDHI6Held4YdwvfGs4i0_3Ce6gMyB7L0,1123
+pulse/js/set.py,sha256=trMVxWfAhV07GKC8wn5Gqm31rk1SQtrJrNzSdDyfqi0,2830
+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/middleware.py,sha256=9uyAhVUEGMSwqWC3WXqs7x5JMMNEcSTTu3g7DjsR8w8,9812
+pulse/plugin.py,sha256=RfGl6Vtr7VRHb8bp4Ob4dOX9dVzvc4Riu7HWnStMPpk,580
+pulse/proxy.py,sha256=zh4v5lmYNg5IBE_xdHHmGPwbMQNSXb2npeLXvw_O1Oc,6591
+pulse/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/queries/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulse/queries/client.py,sha256=GGckE0P3YCBO4Mj-08AO_I9eXVC4sIDSNw_xTLrBFuE,15224
+pulse/queries/common.py,sha256=Cr_NV0dWz5DQ7Qg771jvUms1o2-EnTYqjZJe4tVeoVk,1160
+pulse/queries/effect.py,sha256=7KvV_yK7OHTWhfQbZFGzg_pRhyI2mn25pKIF9AmSmcU,1471
+pulse/queries/infinite_query.py,sha256=oUHWjP2OliB7h8VDJooGocefHm4m9TDy4WaJesSrsdI,40457
+pulse/queries/mutation.py,sha256=px1fprFL-RxNfbRSoRtdsOLkEbjSsMrJxGHKBIPYQTM,4959
+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/reactive.py,sha256=v8a9IttkabeWwYrrHAx33zqzW9WC4WlS4iXbIh2KQkU,24374
+pulse/reactive_extensions.py,sha256=T1V3AasHtvJkmGO55miC9RVPxDFIj7qrooMsn89x5SI,32076
+pulse/render_session.py,sha256=UAI65k28ysZqCp7j6BBdi7MkG2wVKJXj4hIgjK7hsaM,18120
+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/state.py,sha256=ikQbK4R8PieV96qd4uWREUvs0jXo9sCapawY7i6oCYo,10776
+pulse/transpiler/__init__.py,sha256=sgfHxLwZEPj3rBBMtzD4997qx7GTr5Wt22-296e-uC8,6492
+pulse/transpiler/builtins.py,sha256=V_H3bpgU22Yb_GzM6YvOutZ65O36xHLzRANl7uHRqUI,22401
+pulse/transpiler/constants.py,sha256=GBYfTGgzDCuy-U5wC6iRYezSPK5UpZuyXrEp_yO6yTM,3188
+pulse/transpiler/context.py,sha256=e-Nh0AKsq9_wVOI8gL_gn-UAP6HzcYN14zWLfNNzjWw,714
+pulse/transpiler/errors.py,sha256=JC6tTEmnHf6JdyW4GIvfXB0IBLe7p3FvCLh14PocH28,43
+pulse/transpiler/function.py,sha256=rP-MZl15_mwaGwPToPcFVYHXqyVdMn91cxtF7MKFPHA,7526
+pulse/transpiler/ids.py,sha256=d91B_LFaAALKXHjGPmL8tJmDqGDFz7-GquYmnV9IZ0o,327
+pulse/transpiler/imports.py,sha256=C4lSi5cRQcoo559_urDqbHAdeTiSeU3eEh89o2YDWhI,10848
+pulse/transpiler/js_module.py,sha256=AjguCbKV_FnoanzojrW5-vlW-DQCTtyd-4FfBYQLxxQ,9603
+pulse/transpiler/modules/__init__.py,sha256=YPM2WhILHXQFDSxDcbs-hHdhFh6i3N5ZJLEVGDZeR3Y,1065
+pulse/transpiler/modules/asyncio.py,sha256=FetybIKGJhVJ3uEQJBw6Z2fsh6g7vA-9tqec4nn5FtI,1409
+pulse/transpiler/modules/json.py,sha256=rlOPiJTpUiB2BGEpLqlP9gqO6jegpBd6vigE_h0iIfw,554
+pulse/transpiler/modules/math.py,sha256=9_h6GGJA1SMIBKIB1AwoHErT-CqgSpyEWWneIcxRofE,9415
+pulse/transpiler/modules/re.py,sha256=lAVy-0ej6PEbxNJ4Z0f9N6f9Fol3IsxPKoqBxh4Il-A,13115
+pulse/transpiler/modules/tags.py,sha256=O3K9bLppCzYNlkXjeTvoQN7OI_HfW3xGy55CBT2Qn84,9079
+pulse/transpiler/modules/typing.py,sha256=Vtiv33JzCe7_2K6IBpGdugI4f0sHJUq5I9qI_-sW80M,1639
+pulse/transpiler/nodes.py,sha256=QAzIiu6R9nmBj-sYhiZf4-ffzdX8n_8Z7GswB7qXe5Y,33079
+pulse/transpiler/py_module.py,sha256=bdSL_tUjOeYorWkOVPW4bx5tuFxYbWcGvuYQ5r8WnWk,3859
+pulse/transpiler/transpiler.py,sha256=xwcJc5px1EShgXpCsqJyIynez2GdKynWy6zn2WaRZJA,29292
+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/version.py,sha256=711vaM1jVIQPgkisGgKZqwmw019qZIsc_QTae75K2pg,1895
+pulse_framework-0.1.47.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.47.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.47.dist-info/METADATA,sha256=AMFl4QOZ07Oxunrd6GrbkKyUiFW6C04HOQuixmt_hcE,580
+pulse_framework-0.1.47.dist-info/RECORD,,

pulse/codegen/imports.py

@@ -1,204 +0,0 @@
-from collections.abc import Iterable
-from dataclasses import dataclass, field
-from operator import concat
-
-from pulse.codegen.utils import NameRegistry
-
-
-class Imported:
-	name: str
-	src: str
-	is_default: bool
-	prop: str | None
-	alias: str | None
-
-	def __init__(
-		self,
-		name: str,
-		src: str,
-		is_default: bool = False,
-		prop: str | None = None,
-		alias: str | None = None,
-	) -> None:
-		self.name = name
-		self.src = src
-		self.is_default = is_default
-		self.prop = prop
-		self.alias = alias
-
-	@property
-	def expr(self):
-		if self.prop:
-			return f"{self.alias or self.name}.{self.prop}"
-		return self.alias or self.name
-
-
-@dataclass
-class ImportMember:
-	name: str
-	alias: str | None = None
-
-	@property
-	def identifier(self):
-		return self.alias or self.name
-
-
-@dataclass
-class ImportStatement:
-	src: str
-	values: list[ImportMember] = field(default_factory=list)
-	types: list[ImportMember] = field(default_factory=list)
-	default_import: str | None = None
-	# When True, emit a side-effect import: `import "<src>";`
-	# Can be combined with named/default imports; side-effect line is emitted
-	# only when there are no named/default/type imports for the source.
-	side_effect: bool = False
-	# Optional ordering constraint: ensure this statement is emitted before
-	# any import statements whose `src` matches one of these values.
-	# Example: ImportStatement(src="@mantine/core/styles.css", side_effect=True,
-	#                          before=["@mantine/dates/styles.css"]) ensures
-	# core styles are imported before dates styles.
-	before: list[str] = field(default_factory=list)
-
-
-class Imports:
-	names: NameRegistry
-
-	def __init__(
-		self,
-		imports: Iterable[ImportStatement | Imported],
-		names: NameRegistry | None = None,
-	) -> None:
-		self.names = names or NameRegistry()
-		# Map (src, name) -> identifier (either name or alias)
-		self._import_map: dict[tuple[str, str], str] = {}
-		self.sources: dict[str, ImportStatement] = {}
-		for stmt in imports:
-			if not isinstance(stmt, ImportStatement):
-				continue
-
-			if stmt.default_import:
-				stmt.default_import = self.names.register(stmt.default_import)
-
-			for imp in concat(stmt.values, stmt.types):
-				name = self.names.register(imp.name)
-				if name != imp.name:
-					imp.alias = name
-				self._import_map[(stmt.src, imp.name)] = name
-
-			self.sources[stmt.src] = stmt
-
-	def import_(
-		self, src: str, name: str, is_type: bool = False, is_default: bool = False
-	) -> str:
-		stmt = self.sources.get(src)
-		if not stmt:
-			stmt = ImportStatement(src)
-			self.sources[src] = stmt
-
-		if is_default:
-			if stmt.default_import:
-				return stmt.default_import
-			stmt.default_import = self.names.register(name)
-			return stmt.default_import
-
-		else:
-			if (src, name) in self._import_map:
-				return self._import_map[(src, name)]
-
-			unique_name = self.names.register(name)
-			alias = unique_name if unique_name != name else None
-			imp = ImportMember(name, alias)
-			if is_type:
-				stmt.types.append(imp)
-			else:
-				stmt.values.append(imp)
-			# Remember mapping so future imports of the same (src, name) reuse identifier
-			self._import_map[(src, name)] = imp.identifier
-			return imp.identifier
-
-	def add_statement(self, stmt: ImportStatement) -> None:
-		"""Merge an ImportStatement into the current Imports registry.
-
-		Ensures consistent aliasing via NameRegistry and de-duplicates
-		previously imported names from the same source.
-		"""
-		existing = self.sources.get(stmt.src)
-		if not existing:
-			# Normalize names through registry to avoid later conflicts
-			if stmt.default_import:
-				stmt.default_import = self.names.register(stmt.default_import)
-			for imp in concat(stmt.values, stmt.types):
-				name = self.names.register(imp.name)
-				if name != imp.name:
-					imp.alias = name
-				self._import_map[(stmt.src, imp.name)] = name
-			self.sources[stmt.src] = stmt
-			return
-
-		# Merge into existing statement for the same src
-		if stmt.default_import and not existing.default_import:
-			existing.default_import = self.names.register(stmt.default_import)
-
-		# Merge named imports
-		def _merge_list(
-			dst: list[ImportMember], src_list: list[ImportMember], is_type: bool = False
-		):
-			for imp in src_list:
-				key = (stmt.src, imp.name)
-				if key in self._import_map:
-					continue
-				unique = self.names.register(imp.name)
-				if unique != imp.name:
-					imp.alias = unique
-				self._import_map[key] = imp.alias or imp.name
-				dst.append(imp)
-
-		_merge_list(existing.values, stmt.values, is_type=False)
-		_merge_list(existing.types, stmt.types, is_type=True)
-		existing.side_effect = existing.side_effect or stmt.side_effect
-		# Merge ordering constraints
-		if stmt.before:
-			# Preserve order, avoid duplicates
-			seen = set(existing.before)
-			for s in stmt.before:
-				if s not in seen:
-					existing.before.append(s)
-					seen.add(s)
-
-	def ordered_sources(self) -> list[ImportStatement]:
-		"""Return sources ordered to satisfy `before` constraints.
-
-		Uses a stable topological sort (Kahn's algorithm) where insertion order
-		is preserved among nodes with equal dependency rank. Falls back to
-		insertion order if cycles are detected.
-		"""
-		# Build graph: edge u->v means u must come before v
-		keys = list(self.sources.keys())
-		index = {k: i for i, k in enumerate(keys)}  # for stability
-		indegree: dict[str, int] = {k: 0 for k in keys}
-		adj: dict[str, list[str]] = {k: [] for k in keys}
-		for u, stmt in self.sources.items():
-			for v in stmt.before:
-				if v in adj:  # only consider edges to imports present
-					adj[u].append(v)
-					indegree[v] += 1
-
-		# Kahn's algorithm
-		queue = [k for k, d in indegree.items() if d == 0]
-		# Stable ordering of initial nodes
-		queue.sort(key=lambda k: index[k])
-		ordered: list[str] = []
-		while queue:
-			u = queue.pop(0)
-			ordered.append(u)
-			for v in adj[u]:
-				indegree[v] -= 1
-				if indegree[v] == 0:
-					queue.append(v)
-					queue.sort(key=lambda k: index[k])
-
-		# If not all nodes processed, cycle detected; fall back to insertion order
-		if len(ordered) != len(keys):
-			ordered = keys
-		return [self.sources[k] for k in ordered]