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

pulse/renderer.py

@@ -1,17 +1,12 @@
 import inspect
 from collections.abc import Callable, Sequence
 from dataclasses import dataclass
-from typing import (
-	Any,
-	Literal,
-	NamedTuple,
-	TypeAlias,
-	TypedDict,
-	cast,
-)
+from typing import Any, NamedTuple, TypeAlias, cast
 
-from pulse.css import CssReference
 from pulse.helpers import values_equal
+from pulse.transpiler.context import interpreted_mode
+from pulse.transpiler.imports import Import
+from pulse.transpiler.nodes import JSExpr
 from pulse.vdom import (
 	VDOM,
 	Callback,
@@ -19,78 +14,32 @@ from pulse.vdom import (
 	ComponentNode,
 	Element,
 	Node,
+	PathDelta,
 	Props,
+	ReconciliationOperation,
+	ReplaceOperation,
+	UpdateCallbacksOperation,
+	UpdateJsExprPathsOperation,
+	UpdatePropsDelta,
+	UpdatePropsOperation,
+	UpdateRenderPropsOperation,
 	VDOMNode,
+	VDOMOperation,
 )
 
 
-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
-
+def is_jsexpr(value: object) -> bool:
+	"""Check if a value is a JSExpr or Import."""
+	return isinstance(value, (JSExpr, Import))
 
-class PathDelta(TypedDict, total=False):
-	add: list[str]
-	remove: list[str]
 
+def emit_jsexpr(value: "JSExpr | Import") -> str:
+	"""Emit a JSExpr in interpreted mode (for client-side evaluation)."""
+	with interpreted_mode():
+		if isinstance(value, Import):
+			return value.emit()
+		return value.emit()
 
-class UpdateCallbacksOperation(TypedDict):
-	type: Literal["update_callbacks"]
-	path: str
-	data: PathDelta
-
-
-class UpdateCssRefsOperation(TypedDict):
-	type: Literal["update_css_refs"]
-	path: str
-	data: PathDelta
-
-
-class UpdateRenderPropsOperation(TypedDict):
-	type: Literal["update_render_props"]
-	path: str
-	data: PathDelta
-
-
-VDOMOperation: TypeAlias = (
-	# InsertOperation,
-	# RemoveOperation,
-	ReplaceOperation
-	| UpdatePropsOperation
-	# | MoveOperation,
-	| ReconciliationOperation
-	| UpdateCallbacksOperation
-	| UpdateCssRefsOperation
-	| UpdateRenderPropsOperation
-)
 
 RenderPath: TypeAlias = str
 
@@ -99,13 +48,13 @@ class RenderTree:
 	root: Element
 	callbacks: Callbacks
 	render_props: set[str]
-	css_refs: set[str]
+	jsexpr_paths: set[str]  # paths containing JS expressions
 
 	def __init__(self, root: Element) -> None:
 		self.root = root
 		self.callbacks = {}
 		self.render_props = set()
-		self.css_refs = set()
+		self.jsexpr_paths = set()
 		self.normalized: Element | None = None
 
 	def render(self) -> VDOM:
@@ -114,7 +63,7 @@ class RenderTree:
 		self.root = normalized
 		self.callbacks = renderer.callbacks
 		self.render_props = renderer.render_props
-		self.css_refs = renderer.css_refs
+		self.jsexpr_paths = renderer.jsexpr_paths
 		self.normalized = normalized
 		return vdom
 
@@ -135,23 +84,8 @@ class RenderTree:
 		render_props_add = sorted(render_props_next - render_props_prev)
 		render_props_remove = sorted(render_props_prev - render_props_next)
 
-		css_prev = self.css_refs
-		css_next = renderer.css_refs
-		css_add = sorted(css_next - css_prev)
-		css_remove = sorted(css_prev - css_next)
-
 		prefix: list[VDOMOperation] = []
 
-		if css_add or css_remove:
-			css_delta: PathDelta = {}
-			if css_add:
-				css_delta["add"] = css_add
-			if css_remove:
-				css_delta["remove"] = css_remove
-			prefix.append(
-				UpdateCssRefsOperation(type="update_css_refs", path="", data=css_delta)
-			)
-
 		if callback_add or callback_remove:
 			callback_delta: PathDelta = {}
 			if callback_add:
@@ -176,11 +110,27 @@ class RenderTree:
 				)
 			)
 
+		jsexpr_prev = self.jsexpr_paths
+		jsexpr_next = renderer.jsexpr_paths
+		jsexpr_add = sorted(jsexpr_next - jsexpr_prev)
+		jsexpr_remove = sorted(jsexpr_prev - jsexpr_next)
+		if jsexpr_add or jsexpr_remove:
+			jsexpr_delta: PathDelta = {}
+			if jsexpr_add:
+				jsexpr_delta["add"] = jsexpr_add
+			if jsexpr_remove:
+				jsexpr_delta["remove"] = jsexpr_remove
+			prefix.append(
+				UpdateJsExprPathsOperation(
+					type="update_jsexpr_paths", path="", data=jsexpr_delta
+				)
+			)
+
 		ops = prefix + renderer.operations if prefix else renderer.operations
 
 		self.callbacks = renderer.callbacks
 		self.render_props = renderer.render_props
-		self.css_refs = renderer.css_refs
+		self.jsexpr_paths = renderer.jsexpr_paths
 		self.normalized = normalized
 		self.root = normalized
 
@@ -192,7 +142,11 @@ class RenderTree:
 			self.normalized = None
 		self.callbacks.clear()
 		self.render_props.clear()
-		self.css_refs.clear()
+		self.jsexpr_paths.clear()
+
+
+# Prefix for JSExpr values - code is embedded after the colon
+JSEXPR_PREFIX = "$js:"
 
 
 @dataclass(slots=True)
@@ -214,7 +168,7 @@ class Renderer:
 	def __init__(self) -> None:
 		self.callbacks: Callbacks = {}
 		self.render_props: set[str] = set()
-		self.css_refs: set[str] = set()
+		self.jsexpr_paths: set[str] = set()
 		self.operations: list[VDOMOperation] = []
 
 	# ------------------------------------------------------------------
@@ -226,6 +180,13 @@ class Renderer:
 			return self.render_component(node, path)
 		if isinstance(node, Node):
 			return self.render_node(node, path)
+		# Handle JSExpr as children - emit JS code with $js: prefix
+		if is_jsexpr(node):
+			# Safe cast: is_jsexpr() ensures node is JSExpr | Import
+			node_as_jsexpr = cast("JSExpr | Import", cast(object, node))
+			js_code = emit_jsexpr(node_as_jsexpr)
+			self.jsexpr_paths.add(path)
+			return f"{JSEXPR_PREFIX}{js_code}", cast(Element, node)
 		return node, node
 
 	def render_component(
@@ -453,28 +414,23 @@ class Renderer:
 			old_value = previous.get(key)
 			prop_path = join_path(path, key)
 
-			if callable(value):
-				if isinstance(old_value, (Node, ComponentNode)):
-					unmount_element(old_value)
-				if normalized is None:
-					normalized = current.copy()
-				normalized[key] = "$cb"
-				register_callback(
-					self.callbacks, prop_path, cast(Callable[..., Any], value)
-				)
-				if old_value != "$cb":
-					updated[key] = "$cb"
-				continue
-
-			if isinstance(value, CssReference):
+			if is_jsexpr(value):
 				if isinstance(old_value, (Node, ComponentNode)):
 					unmount_element(old_value)
 				if normalized is None:
 					normalized = current.copy()
 				normalized[key] = value
-				self.css_refs.add(prop_path)
-				if not isinstance(old_value, CssReference) or old_value != value:
-					updated[key] = _css_ref_token(value)
+				# Emit the JSExpr with $js: prefix - code is embedded in the value
+				js_code = emit_jsexpr(cast("JSExpr | Import", value))
+				self.jsexpr_paths.add(prop_path)
+				js_value = f"{JSEXPR_PREFIX}{js_code}"
+				old_js_code = (
+					emit_jsexpr(cast("JSExpr | Import", old_value))
+					if is_jsexpr(old_value)
+					else None
+				)
+				if old_js_code != js_code:
+					updated[key] = js_value
 				continue
 
 			if isinstance(value, (Node, ComponentNode)):
@@ -497,6 +453,19 @@ class Renderer:
 					updated[key] = vdom_value
 				continue
 
+			if callable(value):
+				if isinstance(old_value, (Node, ComponentNode)):
+					unmount_element(old_value)
+				if normalized is None:
+					normalized = current.copy()
+				normalized[key] = "$cb"
+				register_callback(
+					self.callbacks, prop_path, cast(Callable[..., Any], value)
+				)
+				if old_value != "$cb":
+					updated[key] = "$cb"
+				continue
+
 			if isinstance(old_value, (Node, ComponentNode)):
 				unmount_element(old_value)
 
@@ -527,21 +496,6 @@ class Renderer:
 		unmount_element(node)
 
 
-def extract_key(element: Element) -> str | None:
-	if isinstance(element, ComponentNode):
-		return element.key
-	if isinstance(element, Node):
-		return element.key
-	return None
-
-
-def child_key(element: Element, index: int) -> str:
-	key = extract_key(element)
-	if key is not None:
-		return key
-	return f"__idx__{index}"
-
-
 def normalize_children(children: Sequence[Element] | None) -> list[Element]:
 	if not children:
 		return []
@@ -573,38 +527,6 @@ def same_node(left: Element, right: Element) -> bool:
 	return False
 
 
-def lis(seq: list[int]) -> list[int]:
-	if not seq:
-		return []
-	tails: list[int] = []
-	prev: list[int] = [-1] * len(seq)
-	for i, v in enumerate(seq):
-		lo, hi = 0, len(tails)
-		while lo < hi:
-			mid = (lo + hi) // 2
-			if seq[tails[mid]] < v:
-				lo = mid + 1
-			else:
-				hi = mid
-		if lo > 0:
-			prev[i] = tails[lo - 1]
-		if lo == len(tails):
-			tails.append(i)
-		else:
-			tails[lo] = i
-	lis_indices: list[int] = []
-	k = tails[-1] if tails else -1
-	while k != -1:
-		lis_indices.append(k)
-		k = prev[k]
-	lis_indices.reverse()
-	return lis_indices
-
-
-def _css_ref_token(ref: CssReference) -> str:
-	return f"{ref.module.id}:{ref.name}"
-
-
 def unmount_element(element: Element) -> None:
 	if isinstance(element, ComponentNode):
 		if element.contents is not None:

pulse/routing.py

@@ -3,7 +3,6 @@ from collections.abc import Sequence
 from dataclasses import dataclass, field
 from typing import TypedDict, cast, override
 
-from pulse.css import CssImport, CssModule
 from pulse.env import env
 from pulse.react_component import ReactComponent
 from pulse.reactive_extensions import ReactiveDict
@@ -160,8 +159,6 @@ class Route:
 	render: Component[[]]
 	children: Sequence["Route | Layout"]
 	components: Sequence[ReactComponent[...]] | None
-	css_modules: Sequence[CssModule] | None
-	css_imports: Sequence[CssImport] | None
 	is_index: bool
 	is_dynamic: bool
 	dev: bool
@@ -172,8 +169,6 @@ class Route:
 		render: Component[[]],
 		children: "Sequence[Route | Layout] | None" = None,
 		components: "Sequence[ReactComponent[...]] | None" = None,
-		css_modules: Sequence[CssModule] | None = None,
-		css_imports: Sequence[CssImport] | None = None,
 		dev: bool = False,
 	):
 		self.path = ensure_relative_path(path)
@@ -182,8 +177,6 @@ class Route:
 		self.render = render
 		self.children = children or []
 		self.components = components
-		self.css_modules = css_modules
-		self.css_imports = css_imports
 		self.dev = dev
 		self.parent: Route | Layout | None = None
 
@@ -208,7 +201,7 @@ class Route:
 		path = "/".join(self._path_list(include_layouts=False))
 		if self.is_index:
 			path += "index"
-		path += ".tsx"
+		path += ".jsx"
 		# Replace Windows-invalid characters in filenames
 		return _sanitize_filename(path)
 
@@ -257,8 +250,6 @@ class Layout:
 	render: Component[...]
 	children: Sequence["Route | Layout"]
 	components: Sequence[ReactComponent[...]] | None
-	css_modules: Sequence[CssModule] | None
-	css_imports: Sequence[CssImport] | None
 	dev: bool
 
 	def __init__(
@@ -266,15 +257,11 @@ class Layout:
 		render: "Component[...]",
 		children: "Sequence[Route | Layout] | None" = None,
 		components: "Sequence[ReactComponent[...]] | None" = None,
-		css_modules: Sequence[CssModule] | None = None,
-		css_imports: Sequence[CssImport] | None = None,
 		dev: bool = False,
 	):
 		self.render = render
 		self.children = children or []
 		self.components = components
-		self.css_modules = css_modules
-		self.css_imports = css_imports
 		self.dev = dev
 		self.parent: Route | Layout | None = None
 		# 1-based sibling index assigned by RouteTree at each level
@@ -366,8 +353,6 @@ def filter_dev_routes(routes: Sequence[Route | Layout]) -> list[Route | Layout]:
 					render=route.render,
 					children=filtered_children,
 					components=route.components,
-					css_modules=route.css_modules,
-					css_imports=route.css_imports,
 					dev=route.dev,
 				)
 			else:  # Layout
@@ -375,8 +360,6 @@ def filter_dev_routes(routes: Sequence[Route | Layout]) -> list[Route | Layout]:
 					render=route.render,
 					children=filtered_children,
 					components=route.components,
-					css_modules=route.css_modules,
-					css_imports=route.css_imports,
 					dev=route.dev,
 				)
 			filtered.append(filtered_route)

pulse/transpiler/__init__.py

@@ -0,0 +1,131 @@
+"""Python -> JavaScript transpiler system.
+
+This module provides the full transpilation API for converting Python functions
+to JavaScript. For basic usage, use the exports from the main `pulse` module:
+
+    from pulse import javascript, Import, CssImport, import_js
+
+For advanced use cases (custom transpilers, AST manipulation, module registration),
+import from this module:
+
+    from pulse.transpiler import JSExpr, JsTranspiler, register_module, ...
+"""
+
+# Core types
+# Builtins system
+from pulse.transpiler.builtins import ALL_METHODS as ALL_METHODS
+from pulse.transpiler.builtins import BUILTINS as BUILTINS
+from pulse.transpiler.builtins import DICT_METHODS as DICT_METHODS
+from pulse.transpiler.builtins import LIST_METHODS as LIST_METHODS
+from pulse.transpiler.builtins import METHOD_CLASSES as METHOD_CLASSES
+from pulse.transpiler.builtins import SET_METHODS as SET_METHODS
+from pulse.transpiler.builtins import STR_METHODS as STR_METHODS
+from pulse.transpiler.builtins import BuiltinMethods as BuiltinMethods
+from pulse.transpiler.builtins import DictMethods as DictMethods
+from pulse.transpiler.builtins import ListMethods as ListMethods
+from pulse.transpiler.builtins import SetMethods as SetMethods
+from pulse.transpiler.builtins import StringMethods as StringMethods
+from pulse.transpiler.builtins import emit_method as emit_method
+
+# Constants system
+from pulse.transpiler.constants import CONSTANTS_CACHE as CONSTANTS_CACHE
+from pulse.transpiler.constants import JsConstant as JsConstant
+from pulse.transpiler.constants import JsPrimitive as JsPrimitive
+from pulse.transpiler.constants import JsValue as JsValue
+from pulse.transpiler.constants import JsVar as JsVar
+from pulse.transpiler.constants import const_to_js as const_to_js
+from pulse.transpiler.constants import jsify as jsify
+
+# Context
+from pulse.transpiler.context import interpreted_mode as interpreted_mode
+from pulse.transpiler.context import is_interpreted_mode as is_interpreted_mode
+from pulse.transpiler.errors import JSCompilationError as JSCompilationError
+
+# Function system
+from pulse.transpiler.function import FUNCTION_CACHE as FUNCTION_CACHE
+from pulse.transpiler.function import JsFunction as JsFunction
+from pulse.transpiler.function import javascript as javascript
+
+# Utilities
+from pulse.transpiler.ids import generate_id as generate_id
+from pulse.transpiler.ids import reset_id_counter as reset_id_counter
+from pulse.transpiler.imports import CssImport as CssImport
+from pulse.transpiler.imports import Import as Import
+
+# Import system
+from pulse.transpiler.imports import clear_import_registry as clear_import_registry
+from pulse.transpiler.imports import import_js as import_js
+from pulse.transpiler.imports import registered_imports as registered_imports
+
+# Module registration - JS modules
+from pulse.transpiler.js_module import JS_MODULES as JS_MODULES
+from pulse.transpiler.js_module import JsModule as JsModule
+from pulse.transpiler.js_module import register_js_module as register_js_module
+
+# JS AST Utilities
+from pulse.transpiler.nodes import ALLOWED_BINOPS as ALLOWED_BINOPS
+from pulse.transpiler.nodes import ALLOWED_CMPOPS as ALLOWED_CMPOPS
+from pulse.transpiler.nodes import ALLOWED_UNOPS as ALLOWED_UNOPS
+from pulse.transpiler.nodes import JSEXPR_REGISTRY as JSEXPR_REGISTRY
+
+# JS AST Nodes - Expressions
+from pulse.transpiler.nodes import JSArray as JSArray
+from pulse.transpiler.nodes import JSArrowFunction as JSArrowFunction
+
+# JS AST Nodes - Statements
+from pulse.transpiler.nodes import JSAssign as JSAssign
+from pulse.transpiler.nodes import JSAugAssign as JSAugAssign
+from pulse.transpiler.nodes import JSBinary as JSBinary
+from pulse.transpiler.nodes import JSBlock as JSBlock
+from pulse.transpiler.nodes import JSBoolean as JSBoolean
+from pulse.transpiler.nodes import JSBreak as JSBreak
+from pulse.transpiler.nodes import JSCall as JSCall
+from pulse.transpiler.nodes import JSComma as JSComma
+from pulse.transpiler.nodes import JSComputedProp as JSComputedProp
+from pulse.transpiler.nodes import JSConstAssign as JSConstAssign
+from pulse.transpiler.nodes import JSContinue as JSContinue
+from pulse.transpiler.nodes import JSExpr as JSExpr
+from pulse.transpiler.nodes import JSForOf as JSForOf
+from pulse.transpiler.nodes import JSFunctionDef as JSFunctionDef
+from pulse.transpiler.nodes import JSIdentifier as JSIdentifier
+from pulse.transpiler.nodes import JSIf as JSIf
+
+# JS AST Nodes - JSX
+from pulse.transpiler.nodes import JSImport as JSImport
+from pulse.transpiler.nodes import JSLogicalChain as JSLogicalChain
+from pulse.transpiler.nodes import JSMember as JSMember
+from pulse.transpiler.nodes import JSMemberCall as JSMemberCall
+from pulse.transpiler.nodes import JSMultiStmt as JSMultiStmt
+from pulse.transpiler.nodes import JSNew as JSNew
+from pulse.transpiler.nodes import JSNode as JSNode
+from pulse.transpiler.nodes import JSNull as JSNull
+from pulse.transpiler.nodes import JSNumber as JSNumber
+from pulse.transpiler.nodes import JSObjectExpr as JSObjectExpr
+from pulse.transpiler.nodes import JSProp as JSProp
+from pulse.transpiler.nodes import JSRaw as JSRaw
+from pulse.transpiler.nodes import JSReturn as JSReturn
+from pulse.transpiler.nodes import JSSingleStmt as JSSingleStmt
+from pulse.transpiler.nodes import JSSpread as JSSpread
+from pulse.transpiler.nodes import JSStmt as JSStmt
+from pulse.transpiler.nodes import JSString as JSString
+from pulse.transpiler.nodes import JSSubscript as JSSubscript
+from pulse.transpiler.nodes import JSTemplate as JSTemplate
+from pulse.transpiler.nodes import JSTertiary as JSTertiary
+from pulse.transpiler.nodes import JSTransformer as JSTransformer
+from pulse.transpiler.nodes import JSUnary as JSUnary
+from pulse.transpiler.nodes import JSUndefined as JSUndefined
+from pulse.transpiler.nodes import JSWhile as JSWhile
+from pulse.transpiler.nodes import JSXElement as JSXElement
+from pulse.transpiler.nodes import JSXFragment as JSXFragment
+from pulse.transpiler.nodes import JSXProp as JSXProp
+from pulse.transpiler.nodes import JSXSpreadProp as JSXSpreadProp
+from pulse.transpiler.nodes import is_primary as is_primary
+
+# Module registration - Python modules
+from pulse.transpiler.py_module import PY_MODULES as PY_MODULES
+from pulse.transpiler.py_module import PyModule as PyModule
+from pulse.transpiler.py_module import PyModuleExpr as PyModuleExpr
+from pulse.transpiler.py_module import register_module as register_module
+
+# Transpiler
+from pulse.transpiler.transpiler import JsTranspiler as JsTranspiler