pulse-framework 0.1.55__py3-none-any.whl → 0.1.57__py3-none-any.whl

pulse/js/react.py

@@ -2,14 +2,17 @@
 JavaScript React module.
 
 Usage:
-    from pulse.js.react import useState, useEffect, useRef
-    state, setState = useState(0)         # -> const [state, setState] = useState(0)
-    useEffect(lambda: print("hi"), [])    # -> useEffect(() => console.log("hi"), [])
-    ref = useRef(None)                    # -> const ref = useRef(null)
-
-    # Also available as namespace:
-    import pulse.js.react as React
-    React.useState(0)                     # -> React.useState(0)
+
+```python
+from pulse.js.react import useState, useEffect, useRef
+state, setState = useState(0)         # -> const [state, setState] = useState(0)
+useEffect(lambda: print("hi"), [])    # -> useEffect(() => console.log("hi"), [])
+ref = useRef(None)                    # -> const ref = useRef(null)
+
+# Also available as namespace:
+import pulse.js.react as React
+React.useState(0)                     # -> React.useState(0)
+```
 """
 
 import ast as _ast
@@ -116,9 +119,12 @@ def useState(
 	"""Returns a stateful value and a function to update it.
 
 	Example:
-		count, set_count = useState(0)
-		set_count(count + 1)
-		set_count(lambda prev: prev + 1)
+
+	```python
+	count, set_count = useState(0)
+	set_count(count + 1)
+	set_count(lambda prev: prev + 1)
+	```
 	"""
 	...
 
@@ -128,16 +134,19 @@ def useReducer(
 	initial_arg: S,
 	init: _Callable[[S], S] | None = None,
 ) -> tuple[S, Dispatch[A]]:
-	"""An alternative to useState for complex state logic.
+	"""An alternative to `useState` for complex state logic.
 
 	Example:
-		def reducer(state, action):
-			if action['type'] == 'increment':
-				return {'count': state['count'] + 1}
-			return state
 
-		state, dispatch = useReducer(reducer, {'count': 0})
-		dispatch({'type': 'increment'})
+	```python
+	def reducer(state, action):
+	    if action['type'] == 'increment':
+	        return {'count': state['count'] + 1}
+	    return state
+
+	state, dispatch = useReducer(reducer, {'count': 0})
+	dispatch({'type': 'increment'})
+	```
 	"""
 	...
 
@@ -154,8 +163,11 @@ def useEffect(
 	"""Accepts a function that contains imperative, possibly effectful code.
 
 	Example:
-		useEffect(lambda: print("mounted"), [])
-		useEffect(lambda: (print("update"), lambda: print("cleanup"))[-1], [dep])
+
+	```python
+	useEffect(lambda: print("mounted"), [])
+	useEffect(lambda: (print("update"), lambda: print("cleanup"))[-1], [dep])
+	```
 	"""
 	...
 
@@ -164,10 +176,13 @@ def useLayoutEffect(
 	effect: _Callable[[], None | _Callable[[], None]],
 	deps: list[_Any] | None = None,
 ) -> None:
-	"""Like useEffect, but fires synchronously after all DOM mutations.
+	"""Like `useEffect`, but fires synchronously after all DOM mutations.
 
 	Example:
-		useLayoutEffect(lambda: measure_element(), [])
+
+	```python
+	useLayoutEffect(lambda: measure_element(), [])
+	```
 	"""
 	...
 
@@ -191,9 +206,12 @@ def useRef(initial_value: T) -> MutableRefObject[T]:
 	"""Returns a mutable ref object.
 
 	Example:
-		input_ref = useRef(None)
-		# In JSX: <input ref={input_ref} />
-		input_ref.current.focus()
+
+	```python
+	input_ref = useRef(None)
+	# In JSX: <input ref={input_ref} />
+	input_ref.current.focus()
+	```
 	"""
 	...
 
@@ -216,7 +234,10 @@ def useMemo(factory: _Callable[[], T], deps: list[_Any]) -> T:
 	"""Returns a memoized value.
 
 	Example:
-		expensive = useMemo(lambda: compute_expensive(a, b), [a, b])
+
+	```python
+	expensive = useMemo(lambda: compute_expensive(a, b), [a, b])
+	```
 	"""
 	...
 
@@ -225,7 +246,10 @@ def useCallback(callback: T, deps: list[_Any]) -> T:
 	"""Returns a memoized callback.
 
 	Example:
-		handle_click = useCallback(lambda e: print(e), [])
+
+	```python
+	handle_click = useCallback(lambda e: print(e), [])
+	```
 	"""
 	...
 
@@ -239,8 +263,11 @@ def useTransition() -> tuple[bool, TransitionStartFunction]:
 	"""Returns a stateful value for pending state and a function to start transition.
 
 	Example:
-		is_pending, start_transition = useTransition()
-		start_transition(lambda: set_state(new_value))
+
+	```python
+	is_pending, start_transition = useTransition()
+	start_transition(lambda: set_state(new_value))
+	```
 	"""
 	...
 
@@ -254,7 +281,10 @@ def useContext(context: Context[T]) -> T:
 	"""Returns the current context value for the given context.
 
 	Example:
-		theme = useContext(ThemeContext)
+
+	```python
+	theme = useContext(ThemeContext)
+	```
 	"""
 	...
 
@@ -268,9 +298,12 @@ def useId() -> str:
 	"""Generates a unique ID that is stable across server and client.
 
 	Example:
-		id = useId()
-		# <label htmlFor={id}>Name</label>
-		# <input id={id} />
+
+	```python
+	id = useId()
+	# <label htmlFor={id}>Name</label>
+	# <input id={id} />
+	```
 	"""
 	...
 
@@ -288,10 +321,13 @@ def useSyncExternalStore(
 	"""Subscribe to an external store.
 
 	Example:
-		width = useSyncExternalStore(
-			subscribe_to_resize,
-			lambda: window.innerWidth
-		)
+
+	```python
+	width = useSyncExternalStore(
+	    subscribe_to_resize,
+	    lambda: window.innerWidth
+	)
+	```
 	"""
 	...
 
@@ -337,27 +373,30 @@ def forwardRef(
 
 
 class _LazyComponentFactory(_Expr):
-	"""React.lazy binding that works both at definition time and in @javascript.
+	"""React.lazy binding that works both at definition time and in `@javascript`.
 
-	This Expr represents React's lazy function. It can be:
-	- Called at Python definition time: lazy(factory) → Jsx(Constant(...))
-	- Used as a reference in @javascript: some_fn(lazy) → some_fn(lazy)
-	- Called inside @javascript: lazy(factory) → creates Constant+Jsx
+	This Expr represents React's `lazy` function. It can be:
+	- Called at Python definition time: `lazy(factory)` → `Jsx(Constant(...))`
+	- Used as a reference in `@javascript`: `some_fn(lazy)` → `some_fn(lazy)`
+	- Called inside `@javascript`: `lazy(factory)` → creates `Constant+Jsx`
 
 	Usage:
-		# At definition time (Python executes this)
-		LazyChart = lazy(Import("Chart", "./Chart", lazy=True))
-
-		# As reference in transpiled code
-		@javascript
-		def foo():
-			return higher_order_fn(lazy)  # → higher_order_fn(lazy)
-
-		# Called in transpiled code
-		@javascript
-		def bar():
-			LazyComp = lazy(factory)  # → const LazyComp_1 = lazy(factory)
-			return LazyComp()
+
+	```python
+	# At definition time (Python executes this)
+	LazyChart = lazy(Import("Chart", "./Chart", lazy=True))
+
+	# As reference in transpiled code
+	@javascript
+	def foo():
+	    return higher_order_fn(lazy)  # → higher_order_fn(lazy)
+
+	# Called in transpiled code
+	@javascript
+	def bar():
+	    LazyComp = lazy(factory)  # → const LazyComp_1 = lazy(factory)
+	    return LazyComp()
+	```
 	"""
 
 	__slots__: tuple[str, ...] = ("_lazy_import",)

pulse/js/regexp.py

@@ -2,11 +2,14 @@
 JavaScript RegExp builtin module.
 
 Usage:
-    from pulse.js import RegExp
-    RegExp(pattern, flags)        # -> new RegExp(pattern, flags)
 
-    # Or import from module directly:
-    from pulse.js.regexp import RegExp
+```python
+from pulse.js import RegExp
+RegExp(pattern, flags)        # -> new RegExp(pattern, flags)
+
+# Or import from module directly:
+from pulse.js.regexp import RegExp
+```
 """
 
 from pulse.transpiler.js_module import JsModule

pulse/js/set.py

@@ -2,12 +2,15 @@
 JavaScript Set builtin module.
 
 Usage:
-    from pulse.js import Set
-    Set()                         # -> new Set()
-    Set([1, 2, 3])               # -> new Set([1, 2, 3])
 
-    # Or import from module directly:
-    from pulse.js.set import Set
+```python
+from pulse.js import Set
+Set()                         # -> new Set()
+Set([1, 2, 3])               # -> new Set([1, 2, 3])
+
+# Or import from module directly:
+from pulse.js.set import Set
+```
 """
 
 from collections.abc import Callable as _Callable

pulse/js/string.py

@@ -2,13 +2,16 @@
 JavaScript String builtin module.
 
 Usage:
-    from pulse.js import String
-    String(x)                      # -> new String(x)
-    String.fromCharCode(65)        # -> String.fromCharCode(65)
-    String.fromCodePoint(0x1F600)  # -> String.fromCodePoint(0x1F600)
 
-    # Or import from module directly:
-    from pulse.js.string import String
+```python
+from pulse.js import String
+String(x)                      # -> new String(x)
+String.fromCharCode(65)        # -> String.fromCharCode(65)
+String.fromCodePoint(0x1F600)  # -> String.fromCodePoint(0x1F600)
+
+# Or import from module directly:
+from pulse.js.string import String
+```
 """
 
 from typing import Any as _Any

pulse/js/weakmap.py

@@ -2,12 +2,15 @@
 JavaScript WeakMap builtin module.
 
 Usage:
-    from pulse.js import WeakMap
-    WeakMap()                     # -> new WeakMap()
-    WeakMap([[obj, "value"]])    # -> new WeakMap([[obj, "value"]])
 
-    # Or import from module directly:
-    from pulse.js.weakmap import WeakMap
+```python
+from pulse.js import WeakMap
+WeakMap()                     # -> new WeakMap()
+WeakMap([[obj, "value"]])    # -> new WeakMap([[obj, "value"]])
+
+# Or import from module directly:
+from pulse.js.weakmap import WeakMap
+```
 """
 
 from collections.abc import Iterable as _Iterable

pulse/js/weakset.py

@@ -2,12 +2,15 @@
 JavaScript WeakSet builtin module.
 
 Usage:
-    from pulse.js import WeakSet
-    WeakSet()                     # -> new WeakSet()
-    WeakSet([obj1, obj2])        # -> new WeakSet([obj1, obj2])
 
-    # Or import from module directly:
-    from pulse.js.weakset import WeakSet
+```python
+from pulse.js import WeakSet
+WeakSet()                     # -> new WeakSet()
+WeakSet([obj1, obj2])        # -> new WeakSet([obj1, obj2])
+
+# Or import from module directly:
+from pulse.js.weakset import WeakSet
+```
 """
 
 from collections.abc import Iterable as _Iterable

pulse/js/window.py

@@ -1,9 +1,12 @@
 """Browser window global object.
 
 Usage:
-    from pulse.js import window
-    window.alert("Hello!")      # -> window.alert("Hello!")
-    window.innerWidth           # -> window.innerWidth
+
+```python
+from pulse.js import window
+window.alert("Hello!")      # -> window.alert("Hello!")
+window.innerWidth           # -> window.innerWidth
+```
 """
 
 from collections.abc import Callable as _Callable

pulse/messages.py

@@ -48,6 +48,10 @@ class ServerNavigateToMessage(TypedDict):
 	hard: bool
 
 
+class ServerReloadMessage(TypedDict):
+	type: Literal["reload"]
+
+
 class ServerApiCallMessage(TypedDict):
 	type: Literal["api_call"]
 	# Correlation id to match request/response
@@ -158,6 +162,7 @@ ServerMessage = (
 	| ServerErrorMessage
 	| ServerApiCallMessage
 	| ServerNavigateToMessage
+	| ServerReloadMessage
 	| ServerChannelMessage
 	| ServerJsExecMessage
 )