pulse-framework 0.1.46__py3-none-any.whl → 0.1.48__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/vdom.py

@@ -7,6 +7,7 @@ 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
@@ -14,11 +15,13 @@ from types import NoneType
 from typing import (
 	Any,
 	Generic,
+	Literal,
 	NamedTuple,
 	NotRequired,
 	ParamSpec,
 	TypeAlias,
 	TypedDict,
+	final,
 	overload,
 	override,
 )
@@ -94,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"
@@ -284,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]
@@ -292,6 +312,7 @@ class ComponentNode:
 	name: str
 	takes_children: bool
 	hooks: HookContext
+	contents: "Element | None"
 
 	def __init__(
 		self,
@@ -309,7 +330,7 @@ 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":
@@ -388,11 +409,95 @@ 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 _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]:
@@ -424,9 +529,10 @@ 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)
 				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=warn_stacklevel,

{pulse_framework-0.1.46.dist-info → pulse_framework-0.1.48.dist-info}/METADATA

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

@@ -0,0 +1,119 @@
+pulse/__init__.py,sha256=F97Jf6i99NXZe05ICjGbBjIaT4JURdh7dC1T1-Gnb0o,32790
+pulse/app.py,sha256=lHlGKQ8kTRTx30cvL3EaBjBZ7rNYVjeItsganPsLqoQ,31540
+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=5Z8UXzw5rHco7_W67NVhp0fEOKmW8Ewb-_inDz32zMI,7052
+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=v054teQPOFNJZMgs_G7-BIGsvTLvolTEABgtoSUR3_c,14890
+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=wDKz8zJvLTpcowEoHclOppindK7Xp0Qquh58dVWKgdc,7255
+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.48.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.48.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.48.dist-info/METADATA,sha256=NYRK6Ja0Dxl3wB3n24TdGbBO8FWGp1oOnGfeSKb6Hqo,580
+pulse_framework-0.1.48.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]

pulse/css.py

@@ -1,155 +0,0 @@
-import hashlib
-import inspect
-from collections.abc import Iterable, Iterator, MutableMapping
-from dataclasses import dataclass
-from pathlib import Path
-from typing import override
-
-_CSS_MODULES: MutableMapping[Path, "CssModule"] = {}
-_CSS_IMPORTS: dict[str, "CssImport"] = {}
-
-
-def _caller_file() -> Path:
-	frame = inspect.currentframe()
-	try:
-		if frame is None or frame.f_back is None:
-			raise RuntimeError("Cannot determine caller frame for ps.css()")
-		caller = frame.f_back
-		# Walk past helper wrappers (ps.css may be imported under different name)
-		while caller and caller.f_code.co_filename == __file__:
-			caller = caller.f_back
-		if caller is None:
-			raise RuntimeError("Cannot determine caller for ps.css()")
-		return Path(caller.f_code.co_filename).resolve()
-	finally:
-		del frame
-
-
-def css_module(path: str | Path, *, relative: bool = False) -> "CssModule":
-	source = Path(path)
-	caller = _caller_file()
-	if relative:
-		source = caller.parent / source
-	source = source.resolve()
-	if not source.exists():
-		raise FileNotFoundError(f"CSS module '{source}' not found")
-	module = _CSS_MODULES.get(source)
-	if not module:
-		module = CssModule.create(source)
-		_CSS_MODULES[source] = module
-	return module
-
-
-def css(path: str | Path, *, relative: bool = False) -> "CssImport":
-	caller = _caller_file()
-	if relative:
-		source_path = (caller.parent / Path(path)).resolve()
-		if not source_path.exists():
-			raise FileNotFoundError(
-				f"CSS import '{path}' not found relative to {caller.parent}"
-			)
-		key = f"file://{source_path}"
-		existing = _CSS_IMPORTS.get(key)
-		if existing:
-			return existing
-		imp = CssImport(
-			_import_id(str(source_path)), specifier=None, source_path=source_path
-		)
-		_CSS_IMPORTS[key] = imp
-		return imp
-
-	spec = str(path)
-	existing = _CSS_IMPORTS.get(spec)
-	if existing:
-		return existing
-	imp = CssImport(_import_id(spec), specifier=spec, source_path=None)
-	_CSS_IMPORTS[spec] = imp
-	return imp
-
-
-def registered_css_modules() -> list["CssModule"]:
-	return list(_CSS_MODULES.values())
-
-
-def registered_css_imports() -> list["CssImport"]:
-	return list(_CSS_IMPORTS.values())
-
-
-@dataclass(frozen=True)
-class CssModule:
-	id: str
-	source_path: Path
-
-	@staticmethod
-	def create(path: Path) -> "CssModule":
-		module_id = _module_id(path)
-		return CssModule(module_id, path)
-
-	def __getattr__(self, key: str) -> "CssReference":
-		if key.startswith("__") and key.endswith("__"):
-			raise AttributeError(key)
-		return CssReference(self, key)
-
-	def __getitem__(self, key: str) -> "CssReference":
-		return self.__getattr__(key)
-
-	def iter(self, names: Iterable[str]) -> Iterator["CssReference"]:
-		for name in names:
-			yield CssReference(self, name)
-
-
-@dataclass(frozen=True)
-class CssReference:
-	module: CssModule
-	name: str
-
-	def __post_init__(self) -> None:
-		if not self.name:
-			raise ValueError("CSS class name cannot be empty")
-
-	def __bool__(self) -> bool:
-		raise TypeError("CssReference objects cannot be coerced to bool")
-
-	def __int__(self) -> int:
-		raise TypeError("CssReference objects cannot be converted to int")
-
-	def __float__(self) -> float:
-		raise TypeError("CssReference objects cannot be converted to float")
-
-	@override
-	def __str__(self) -> str:
-		raise TypeError("CssReference objects cannot be converted to str")
-
-	@override
-	def __repr__(self) -> str:
-		return f"CssReference(module={self.module.id!r}, name={self.name!r})"
-
-
-def _module_id(path: Path) -> str:
-	data = str(path).encode("utf-8")
-	digest = hashlib.sha1(data).hexdigest()
-	return f"css_{digest[:12]}"
-
-
-@dataclass(frozen=True)
-class CssImport:
-	id: str
-	specifier: str | None
-	source_path: Path | None
-
-
-def _import_id(value: str) -> str:
-	data = value.encode("utf-8")
-	digest = hashlib.sha1(data).hexdigest()
-	return f"css_import_{digest[:12]}"
-
-
-__all__ = [
-	"CssModule",
-	"CssReference",
-	"CssImport",
-	"css",
-	"css_module",
-	"registered_css_modules",
-	"registered_css_imports",
-]