pulse-framework 0.1.75__tar.gz → 0.1.77__tar.gz

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.75
+Version: 0.1.77
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
 Requires-Dist: fastapi>=0.128.0
 Requires-Dist: uvicorn>=0.24.0

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/pyproject.toml

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

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/__init__.py

@@ -1409,6 +1409,18 @@ from pulse.reactive_extensions import (
 from pulse.reactive_extensions import (
 	unwrap as unwrap,
 )
+from pulse.refs import (
+	RefHandle as RefHandle,
+)
+from pulse.refs import (
+	RefNotMounted as RefNotMounted,
+)
+from pulse.refs import (
+	RefTimeout as RefTimeout,
+)
+from pulse.refs import (
+	ref as ref,
+)
 
 # JavaScript execution
 from pulse.render_session import JsExecError as JsExecError

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/channel.py

@@ -81,7 +81,9 @@ class ChannelsManager:
 		self.pending_requests = {}
 
 	# ------------------------------------------------------------------
-	def create(self, identifier: str | None = None) -> "Channel":
+	def create(
+		self, identifier: str | None = None, *, bind_route: bool = True
+	) -> "Channel":
 		ctx = PulseContext.get()
 		render = ctx.render
 		session = ctx.session
@@ -93,7 +95,7 @@ class ChannelsManager:
 			raise ValueError(f"Channel id '{channel_id}' is already in use")
 
 		route_path: str | None = None
-		if ctx.route is not None:
+		if bind_route and ctx.route is not None:
 			# unique_path() returns absolute path, use as-is for keys
 			route_path = ctx.route.pulse_route.unique_path()
 
@@ -129,7 +131,8 @@ class ChannelsManager:
 		if not response_to:
 			return
 
-		if error := message.get("error") is not None:
+		error = message.get("error")
+		if error is not None:
 			self.resolve_pending_error(response_to, error)
 		else:
 			self._resolve_pending_success(response_to, message.get("payload"))

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/components/for_.py

@@ -5,14 +5,13 @@ Provides a declarative way to render lists, similar to JavaScript's Array.map().
 
 from collections.abc import Callable, Iterable
 from inspect import Parameter, signature
-from typing import TYPE_CHECKING, Any, TypeVar, overload
+from typing import Any, TypeVar, overload
 
-from pulse.transpiler.nodes import Call, Element, Expr, Member, transformer
-
-if TYPE_CHECKING:
-	from pulse.transpiler.transpiler import Transpiler
+from pulse.transpiler.nodes import Call, Expr, Member, Node, transformer
+from pulse.transpiler.transpiler import Transpiler
 
 T = TypeVar("T")
+TNode = TypeVar("TNode", bound=Node)
 
 
 @transformer("For")
@@ -24,14 +23,14 @@ def emit_for(items: Any, fn: Any, *, ctx: "Transpiler") -> Expr:
 
 
 @overload
-def For(items: Iterable[T], fn: Callable[[T], Element]) -> list[Element]: ...
+def For(items: Iterable[T], fn: Callable[[T], TNode]) -> list[TNode]: ...
 
 
 @overload
-def For(items: Iterable[T], fn: Callable[[T, int], Element]) -> list[Element]: ...
+def For(items: Iterable[T], fn: Callable[[T, int], TNode]) -> list[TNode]: ...
 
 
-def For(items: Iterable[T], fn: Callable[..., Element]) -> list[Element]:
+def For(items: Iterable[T], fn: Callable[..., TNode]) -> list[TNode]:
 	"""Map items to elements, like JavaScript's Array.map().
 
 	Iterates over `items` and calls `fn` for each one, returning a list of

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/dom/props.py

@@ -68,6 +68,7 @@ from pulse.dom.events import (
 	TextAreaDOMEvents,
 )
 from pulse.helpers import CSSProperties
+from pulse.refs import RefHandle
 from pulse.transpiler.nodes import Expr
 
 Booleanish = Literal[True, False, "true", "false"]
@@ -82,6 +83,7 @@ class BaseHTMLProps(TypedDict, total=False):
 	defaultValue: str | int | list[str]
 	suppressContentEditableWarning: bool
 	suppressHydrationWarning: bool
+	ref: RefHandle[Any]
 
 	# Standard HTML Attributes
 	accessKey: str

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/js/__init__.py

@@ -67,6 +67,7 @@ _MODULE_EXPORTS_NAMESPACE: dict[str, str] = {
 _MODULE_EXPORTS_ATTRIBUTE: dict[str, str] = {
 	"AbortController": "pulse.js.abort_controller",
 	"AbortSignal": "pulse.js.abort_controller",
+	"Animation": "pulse.js.animation",
 	"Array": "pulse.js.array",
 	"ArrayBuffer": "pulse.js.array_buffer",
 	"BigInt64Array": "pulse.js.array_buffer",
@@ -76,6 +77,7 @@ _MODULE_EXPORTS_ATTRIBUTE: dict[str, str] = {
 	"DOMParser": "pulse.js.dom_parser",
 	"DataView": "pulse.js.array_buffer",
 	"Date": "pulse.js.date",
+	"DocumentTimeline": "pulse.js.animation",
 	"Error": "pulse.js.error",
 	"File": "pulse.js.file",
 	"FileReader": "pulse.js.file_reader",
@@ -87,6 +89,7 @@ _MODULE_EXPORTS_ATTRIBUTE: dict[str, str] = {
 	"Int32Array": "pulse.js.array_buffer",
 	"Int8Array": "pulse.js.array_buffer",
 	"IntersectionObserver": "pulse.js.intersection_observer",
+	"KeyframeEffect": "pulse.js.animation",
 	"Map": "pulse.js.map",
 	"MutationObserver": "pulse.js.mutation_observer",
 	"Object": "pulse.js.object",

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/js/__init__.pyi

@@ -67,6 +67,17 @@ from pulse.js._types import (
 )
 from pulse.js.abort_controller import AbortController as AbortController
 from pulse.js.abort_controller import AbortSignal as AbortSignal
+from pulse.js.animation import Animation as Animation
+from pulse.js.animation import ComputedEffectTiming as ComputedEffectTiming
+from pulse.js.animation import ComputedKeyframe as ComputedKeyframe
+from pulse.js.animation import DocumentTimeline as DocumentTimeline
+from pulse.js.animation import DocumentTimelineOptions as DocumentTimelineOptions
+from pulse.js.animation import EffectTiming as EffectTiming
+from pulse.js.animation import Keyframe as Keyframe
+from pulse.js.animation import KeyframeEffect as KeyframeEffect
+from pulse.js.animation import KeyframeEffectOptions as KeyframeEffectOptions
+from pulse.js.animation import OptionalEffectTiming as OptionalEffectTiming
+from pulse.js.animation import PropertyIndexedKeyframes as PropertyIndexedKeyframes
 
 # Re-export classes with proper generic types
 from pulse.js.array import Array as Array

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/js/_types.py

@@ -7,6 +7,7 @@ These are purely for static type checking - they have no runtime effect.
 from collections.abc import Awaitable as _Awaitable
 from collections.abc import Callable as _Callable
 from collections.abc import Iterator as _Iterator
+from typing import Any as _Any
 from typing import Protocol as _Protocol
 from typing import TypeVar as _TypeVar
 from typing import overload as _overload
@@ -135,6 +136,8 @@ class Element(_Protocol):
 		options: bool | dict[str, bool] | None = None,
 		/,
 	) -> None: ...
+	def animate(self, keyframes: _Any, options: _Any | None = None, /) -> _Any: ...
+	def getAnimations(self) -> list[_Any]: ...
 	def remove(self) -> None: ...
 	def append(self, *nodes: "Element | str") -> None: ...
 	def prepend(self, *nodes: "Element | str") -> None: ...

pulse_framework-0.1.77/src/pulse/js/animation.py

@@ -0,0 +1,217 @@
+"""
+Web Animations API builtins.
+
+Usage:
+
+```python
+from pulse.js import Animation, KeyframeEffect, document, obj
+
+@ps.javascript
+def example(target):
+    effect = KeyframeEffect(
+        target,
+        [obj(transform="translateX(0px)"), obj(transform="translateX(100px)")],
+        obj(duration=300, easing="ease-in-out"),
+    )
+    animation = Animation(effect, document.timeline)
+    animation.play()
+```
+"""
+
+from __future__ import annotations
+
+from typing import Any as _Any
+from typing import TypedDict as _TypedDict
+from typing import overload as _overload
+
+from pulse.js._types import Element as _Element
+from pulse.js.promise import Promise as _Promise
+from pulse.transpiler.js_module import JsModule
+
+Keyframe = dict[str, _Any]
+ComputedKeyframe = dict[str, _Any]
+PropertyIndexedKeyframes = dict[str, _Any]
+
+
+class EffectTiming(_TypedDict, total=False):
+	delay: float
+	direction: str
+	duration: float | str
+	easing: str
+	endDelay: float
+	fill: str
+	iterations: float
+	iterationStart: float
+
+
+class OptionalEffectTiming(_TypedDict, total=False):
+	delay: float
+	direction: str
+	duration: float | str
+	easing: str
+	endDelay: float
+	fill: str
+	iterations: float
+	iterationStart: float
+
+
+class KeyframeEffectOptions(EffectTiming, total=False):
+	composite: str
+	iterationComposite: str
+	pseudoElement: str
+
+
+class ComputedEffectTiming(EffectTiming, total=False):
+	endTime: float
+	activeDuration: float
+	localTime: float | None
+	progress: float | None
+	currentIteration: float | None
+
+
+class DocumentTimelineOptions(_TypedDict, total=False):
+	originTime: float
+
+
+class KeyframeEffect:
+	"""Keyframe-based animation effect."""
+
+	@_overload
+	def __init__(
+		self,
+		target: _Element | None,
+		keyframes: list[Keyframe] | PropertyIndexedKeyframes | None = None,
+		options: float | int | KeyframeEffectOptions | None = None,
+		/,
+	) -> None: ...
+
+	@_overload
+	def __init__(self, source: "KeyframeEffect", /) -> None: ...
+
+	def __init__(
+		self,
+		target: _Element | None | KeyframeEffect,
+		keyframes: list[Keyframe] | PropertyIndexedKeyframes | None = None,
+		options: float | int | KeyframeEffectOptions | None = None,
+		/,
+	) -> None: ...
+
+	@property
+	def target(self) -> _Element | None: ...
+
+	@property
+	def pseudoElement(self) -> str | None: ...
+
+	@property
+	def iterationComposite(self) -> str: ...
+
+	@property
+	def composite(self) -> str: ...
+
+	def getComputedTiming(self) -> ComputedEffectTiming: ...
+
+	def getKeyframes(self) -> list[ComputedKeyframe]: ...
+
+	def getTiming(self) -> EffectTiming: ...
+
+	def setKeyframes(
+		self,
+		keyframes: list[Keyframe] | PropertyIndexedKeyframes | None,
+		/,
+	) -> None: ...
+
+	def updateTiming(self, timing: OptionalEffectTiming, /) -> None: ...
+
+
+class Animation:
+	"""Playback controller for a KeyframeEffect."""
+
+	def __init__(
+		self,
+		effect: KeyframeEffect | _Any | None = None,
+		timeline: DocumentTimeline | _Any | None = None,
+		/,
+	) -> None: ...
+
+	@property
+	def currentTime(self) -> float | None: ...
+
+	@currentTime.setter
+	def currentTime(self, value: float | None) -> None: ...
+
+	@property
+	def effect(self) -> _Any | None: ...
+
+	@effect.setter
+	def effect(self, value: _Any | None) -> None: ...
+
+	@property
+	def finished(self) -> _Promise[_Any]: ...
+
+	@property
+	def id(self) -> str: ...
+
+	@id.setter
+	def id(self, value: str) -> None: ...
+
+	@property
+	def overallProgress(self) -> float: ...
+
+	@property
+	def pending(self) -> bool: ...
+
+	@property
+	def playState(self) -> str: ...
+
+	@property
+	def playbackRate(self) -> float: ...
+
+	@playbackRate.setter
+	def playbackRate(self, value: float) -> None: ...
+
+	@property
+	def ready(self) -> _Promise[_Any]: ...
+
+	@property
+	def replaceState(self) -> str: ...
+
+	@property
+	def startTime(self) -> float | None: ...
+
+	@startTime.setter
+	def startTime(self, value: float | None) -> None: ...
+
+	@property
+	def timeline(self) -> _Any | None: ...
+
+	@timeline.setter
+	def timeline(self, value: _Any | None) -> None: ...
+
+	def cancel(self) -> None: ...
+
+	def commitStyles(self) -> None: ...
+
+	def finish(self) -> None: ...
+
+	def pause(self) -> None: ...
+
+	def persist(self) -> None: ...
+
+	def play(self) -> None: ...
+
+	def reverse(self) -> None: ...
+
+	def updatePlaybackRate(self, rate: float, /) -> None: ...
+
+
+class DocumentTimeline:
+	"""Timeline associated with a document."""
+
+	def __init__(self, options: DocumentTimelineOptions | None = None, /) -> None: ...
+
+	@property
+	def currentTime(self) -> float | None: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/js/document.py

@@ -15,6 +15,8 @@ from pulse.js._types import Element as _Element
 from pulse.js._types import HTMLCollection as _HTMLCollection
 from pulse.js._types import HTMLElement as _HTMLElement
 from pulse.js._types import NodeList as _NodeList
+from pulse.js.animation import Animation as _Animation
+from pulse.js.animation import DocumentTimeline as _DocumentTimeline
 from pulse.transpiler.js_module import JsModule
 
 # Read-only properties
@@ -28,6 +30,7 @@ cookie: str
 referrer: str
 URL: str
 domain: str
+timeline: _DocumentTimeline
 
 
 # Query methods
@@ -122,6 +125,11 @@ def getSelection() -> _Any:
 	...
 
 
+def getAnimations() -> list[_Animation]:
+	"""Return animations associated with this document."""
+	...
+
+
 # Node tree methods
 def importNode(node: _Element, deep: bool = False, /) -> _Element:
 	"""Import a node from another document."""

{pulse_framework-0.1.75 → pulse_framework-0.1.77}/src/pulse/js/react.py

@@ -156,7 +156,7 @@ def useReducer(
 
 
 def useEffect(
-	effect: _Callable[[], None | _Callable[[], None]],
+	effect: _Callable[[], None | _Callable[[], _Any]],
 	deps: list[_Any] | None = None,
 ) -> None:
 	"""Accepts a function that contains imperative, possibly effectful code.
@@ -172,7 +172,7 @@ def useEffect(
 
 
 def useLayoutEffect(
-	effect: _Callable[[], None | _Callable[[], None]],
+	effect: _Callable[[], None | _Callable[[], _Any]],
 	deps: list[_Any] | None = None,
 ) -> None:
 	"""Like `useEffect`, but fires synchronously after all DOM mutations.