pulse-framework 0.1.51__py3-none-any.whl → 0.1.52__py3-none-any.whl

pulse/js/json.py

@@ -15,7 +15,7 @@ from collections.abc import Callable as _Callable
 from collections.abc import Sequence as _Sequence
 from typing import TypeVar as _TypeVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 # JSON types
 JSONValue = None | bool | int | float | str | list["JSONValue"] | dict[str, "JSONValue"]
@@ -25,7 +25,7 @@ JSONReviver = _Callable[[str, JSONValue], JSONValue]
 T = _TypeVar("T")
 
 
-def parse(text: str, reviver: JSONReviver | None = None) -> JSONValue:
+def parse(text: str, reviver: JSONReviver | None = None, /) -> JSONValue:
 	"""Parse a JSON string into a JavaScript value.
 
 	Args:
@@ -43,6 +43,7 @@ def stringify(
 	value: JSONValue,
 	replacer: JSONReplacer | None = None,
 	space: int | str | None = None,
+	/,
 ) -> str:
 	"""Convert a JavaScript value to a JSON string.
 
@@ -59,4 +60,4 @@ def stringify(
 
 
 # Self-register this module as a JS builtin
-_register_js_module(name="JSON")
+JsModule.register(name="JSON")

pulse/js/map.py

@@ -2,21 +2,22 @@
 JavaScript Map builtin module.
 
 Usage:
-    import pulse.js.map as Map
+    from pulse.js import Map
     Map()                         # -> new Map()
     Map([["a", 1]])              # -> new Map([["a", 1]])
 
+    # Or import from module directly:
     from pulse.js.map import Map
-    Map()                         # -> new Map()
 """
 
 from collections.abc import Callable as _Callable
 from collections.abc import Iterable as _Iterable
+from collections.abc import Iterator as _Iterator
 from typing import Any as _Any
 from typing import Generic as _Generic
 from typing import TypeVar as _TypeVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 K = _TypeVar("K")
 V = _TypeVar("V")
@@ -28,7 +29,7 @@ class Map(_Generic[K, V]):
 	Map[K, V] preserves insertion order and allows keys of any type.
 	"""
 
-	def __init__(self, iterable: _Iterable[tuple[K, V]] | None = None) -> None: ...
+	def __init__(self, iterable: _Iterable[tuple[K, V]] | None = None, /) -> None: ...
 
 	@property
 	def size(self) -> int:
@@ -59,6 +60,7 @@ class Map(_Generic[K, V]):
 		self,
 		callback: _Callable[[V, K, "Map[K, V]"], None],
 		thisArg: _Any | None = None,
+		/,
 	) -> None:
 		"""Execute a function for each key/value pair."""
 		...
@@ -75,10 +77,18 @@ class Map(_Generic[K, V]):
 		"""Return an iterator of [key, value] pairs."""
 		...
 
-	def __iter__(self) -> _Iterable[tuple[K, V]]:
+	def __iter__(self) -> _Iterator[tuple[K, V]]:
 		"""Iterate over [key, value] pairs."""
 		...
 
+	def __len__(self) -> int:
+		"""Return the number of key/value pairs (same as size)."""
+		...
+
+	def __contains__(self, key: K) -> bool:
+		"""Check if key exists in the Map (same as has)."""
+		...
+
 
-# Self-register this module as a JS builtin in global scope
-_register_js_module(name="Map", global_scope=True)
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/math.py

@@ -11,7 +11,7 @@ Usage:
     floor(3.7)        # -> Math.floor(3.7)
 """
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 # Constants (type stubs for IDE support)
 PI: float
@@ -63,4 +63,4 @@ def trunc(x: float) -> int: ...
 
 
 # Self-register this module as a JS builtin
-_register_js_module(name="Math")
+JsModule.register(name="Math")

pulse/js/navigator.py

@@ -8,7 +8,7 @@ Usage:
 from typing import Any as _Any
 
 from pulse.js._types import Clipboard as _Clipboard
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 # User agent and browser info
 userAgent: str
@@ -63,14 +63,14 @@ def share(data: dict[str, str]) -> _Any:
 	...
 
 
-def sendBeacon(url: str, data: str | bytes | _Any | None = None) -> bool:
+def sendBeacon(url: str, data: str | bytes | _Any | None = None, /) -> bool:
 	"""Send data to a URL asynchronously. Returns True if successful."""
 	...
 
 
-def canShare(data: dict[str, str] | None = None) -> bool:
+def canShare(data: dict[str, str] | None = None, /) -> bool:
 	"""Check if data can be shared via the Web Share API."""
 	...
 
 
-_register_js_module(name="navigator")
+JsModule.register(name="navigator")

pulse/js/number.py

@@ -2,19 +2,19 @@
 JavaScript Number builtin module.
 
 Usage:
-    import pulse.js.number as Number
+    from pulse.js import Number
     Number.isFinite(42)       # -> Number.isFinite(42)
     Number.MAX_SAFE_INTEGER   # -> Number.MAX_SAFE_INTEGER
+    Number(x)                 # -> new Number(x)
 
-    from pulse.js.number import isFinite, EPSILON
-    isFinite(42)              # -> Number.isFinite(42)
-    EPSILON                   # -> Number.EPSILON
+    # Or import from module directly:
+    from pulse.js.number import Number
 """
 
 from typing import Any as _Any
 from typing import ClassVar as _ClassVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 
 class Number:
@@ -47,8 +47,8 @@ class Number:
 	def parseFloat(string: str) -> float: ...
 
 	@staticmethod
-	def parseInt(string: str, radix: int = 10) -> int: ...
+	def parseInt(string: str, radix: int = 10, /) -> int: ...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="Number")
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/object.py

@@ -2,18 +2,13 @@
 JavaScript Object builtin module.
 
 Usage:
-    import pulse.js.object as Object
+    from pulse.js import Object
     Object.keys({"a": 1})         # -> Object.keys({"a": 1})
     Object.assign({}, {"a": 1})   # -> Object.assign({}, {"a": 1})
-    Object.is(x, y)                # -> Object.is(x, y)
-
-    # Note: For 'is' (Python keyword), use namespace import:
-    # import pulse.js.object as Object; Object.is(...)
-    # Or use the underscore version for direct import:
-    from pulse.js.object import keys, assign, is_
-    keys({"a": 1})                # -> Object.keys({"a": 1})
-    assign({}, {"a": 1})          # -> Object.assign({}, {"a": 1})
-    is_(x, y)                     # -> Object.is(x, y)
+    Object.is_(x, y)              # -> Object.is(x, y)
+
+    # Or import from module directly:
+    from pulse.js.object import Object
 """
 
 from collections.abc import Iterable as _Iterable
@@ -21,7 +16,7 @@ from typing import Any as _Any
 from typing import TypedDict as _TypedDict
 from typing import TypeVar as _TypeVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 T = _TypeVar("T")
 K = _TypeVar("K", bound=str)  # Object keys are always strings in JS
@@ -55,6 +50,7 @@ class Object:
 	def create(
 		proto: _Any | None,
 		propertiesObject: dict[str, PropertyDescriptor] | None = None,
+		/,
 	) -> _Any:
 		"""Create a new object with the specified prototype."""
 		...
@@ -169,5 +165,5 @@ class Object:
 		...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="Object", global_scope=True)
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/promise.py

@@ -2,13 +2,13 @@
 JavaScript Promise builtin module.
 
 Usage:
-    import pulse.js.promise as Promise
+    from pulse.js import Promise
+    Promise(executor)             # -> new Promise(executor)
     Promise.resolve(value)        # -> Promise.resolve(value)
     Promise.reject(reason)        # -> Promise.reject(reason)
 
-    from pulse.js.promise import resolve, reject, all, allSettled, race, any
-    resolve(value)                # -> Promise.resolve(value)
-    reject(reason)                 # -> Promise.reject(reason)
+    # Or import from module directly:
+    from pulse.js.promise import Promise
 
 The Promise class is generic and supports async/await via the Awaitable protocol.
 """
@@ -16,10 +16,12 @@ The Promise class is generic and supports async/await via the Awaitable protocol
 from collections.abc import Callable as _Callable
 from collections.abc import Generator as _Generator
 from collections.abc import Iterable as _Iterable
+from typing import Any as _Any
 from typing import Generic as _Generic
 from typing import TypeVar as _TypeVar
+from typing import overload as _overload
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 T = _TypeVar("T")
 T_co = _TypeVar("T_co", covariant=True)
@@ -52,6 +54,7 @@ class Promise(_Generic[T_co]):
 			[_Callable[[T_co], None], _Callable[[Exception], None]], None
 		]
 		| None = None,
+		/,
 	) -> None:
 		"""Create a Promise.
 
@@ -65,6 +68,7 @@ class Promise(_Generic[T_co]):
 		self,
 		on_fulfilled: _Callable[[T_co], U | "Promise[U]"] | None = None,
 		on_rejected: _Callable[[Exception], U | "Promise[U]"] | None = None,
+		/,
 	) -> "Promise[U]":
 		"""Attach callbacks to handle fulfillment and/or rejection."""
 		...
@@ -85,12 +89,24 @@ class Promise(_Generic[T_co]):
 
 	# Static methods for Promise construction
 	@staticmethod
-	def resolve(value: U | None = None) -> "Promise[U] | Promise[None]":
+	@_overload
+	def resolve() -> "Promise[None]":
+		"""Create a Promise that resolves with None."""
+		...
+
+	@staticmethod
+	@_overload
+	def resolve(value: U, /) -> "Promise[U]":
+		"""Create a Promise that resolves with the given value."""
+		...
+
+	@staticmethod
+	def resolve(value: U | None = None, /) -> "Promise[U] | Promise[None]":
 		"""Create a Promise that resolves with the given value."""
 		...
 
 	@staticmethod
-	def reject(reason: Exception | str) -> "Promise[T]":
+	def reject(reason: Exception | str) -> "Promise[_Any]":
 		"""Create a Promise that rejects with the given reason."""
 		...
 
@@ -146,5 +162,5 @@ class PromiseWithResolvers(_Generic[T]):
 	def reject(self) -> _Callable[[Exception | str], None]: ...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="Promise", global_scope=True)
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/regexp.py

@@ -2,20 +2,20 @@
 JavaScript RegExp builtin module.
 
 Usage:
-    import pulse.js.regexp as RegExp
+    from pulse.js import RegExp
     RegExp(pattern, flags)        # -> new RegExp(pattern, flags)
 
+    # Or import from module directly:
     from pulse.js.regexp import RegExp
-    RegExp(pattern, flags)        # -> new RegExp(pattern, flags)
 """
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 
 class RegExp:
 	"""Class for JavaScript RegExp instances."""
 
-	def __init__(self, pattern: str, flags: str | None = None): ...
+	def __init__(self, pattern: str, flags: str | None = None, /): ...
 
 	def exec(self, string: str) -> list[str] | None: ...
 	def test(self, string: str) -> bool: ...
@@ -50,5 +50,5 @@ class RegExp:
 	def toString(self) -> str: ...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="RegExp", global_scope=True)
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/set.py

@@ -2,21 +2,22 @@
 JavaScript Set builtin module.
 
 Usage:
-    import pulse.js.set as Set
+    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
-    Set()                         # -> new Set()
 """
 
 from collections.abc import Callable as _Callable
 from collections.abc import Iterable as _Iterable
+from collections.abc import Iterator as _Iterator
 from typing import Any as _Any
 from typing import Generic as _Generic
 from typing import TypeVar as _TypeVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 T = _TypeVar("T")
 
@@ -27,7 +28,7 @@ class Set(_Generic[T]):
 	Set[T] stores unique values of type T in insertion order.
 	"""
 
-	def __init__(self, iterable: _Iterable[T] | None = None) -> None: ...
+	def __init__(self, iterable: _Iterable[T] | None = None, /) -> None: ...
 
 	@property
 	def size(self) -> int:
@@ -51,7 +52,10 @@ class Set(_Generic[T]):
 		...
 
 	def forEach(
-		self, callback: _Callable[[T, T, "Set[T]"], None], thisArg: _Any | None = None
+		self,
+		callback: _Callable[[T, T, "Set[T]"], None],
+		thisArg: _Any | None = None,
+		/,
 	) -> None:
 		"""Execute a function for each value.
 
@@ -71,10 +75,18 @@ class Set(_Generic[T]):
 		"""Return an iterator of [value, value] pairs."""
 		...
 
-	def __iter__(self) -> _Iterable[T]:
+	def __iter__(self) -> _Iterator[T]:
 		"""Iterate over values."""
 		...
 
+	def __len__(self) -> int:
+		"""Return the number of values (same as size)."""
+		...
+
+	def __contains__(self, value: T) -> bool:
+		"""Check if value exists in the Set (same as has)."""
+		...
+
 	# ES2024 Set methods
 	def union(self, other: "Set[T]") -> "Set[T]":
 		"""Return a new Set with values from both sets (ES2024)."""
@@ -105,5 +117,5 @@ class Set(_Generic[T]):
 		...
 
 
-# Self-register this module as a JS builtin in global scope
-_register_js_module(name="Set", global_scope=True)
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/string.py

@@ -2,18 +2,18 @@
 JavaScript String builtin module.
 
 Usage:
-    import pulse.js.string as String
+    from pulse.js import String
+    String(x)                      # -> new String(x)
     String.fromCharCode(65)        # -> String.fromCharCode(65)
     String.fromCodePoint(0x1F600)  # -> String.fromCodePoint(0x1F600)
 
-    from pulse.js.string import fromCharCode, fromCodePoint
-    fromCharCode(65)               # -> String.fromCharCode(65)
-    fromCodePoint(0x1F600)         # -> String.fromCodePoint(0x1F600)
+    # Or import from module directly:
+    from pulse.js.string import String
 """
 
 from typing import Any as _Any
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 
 class String:
@@ -31,5 +31,5 @@ class String:
 	def raw(template: str, *substitutions: str) -> str: ...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="String", global_scope=True)
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/weakmap.py

@@ -2,19 +2,19 @@
 JavaScript WeakMap builtin module.
 
 Usage:
-    import pulse.js.weakmap as WeakMap
+    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
-    WeakMap()                     # -> new WeakMap()
 """
 
 from collections.abc import Iterable as _Iterable
 from typing import Generic as _Generic
 from typing import TypeVar as _TypeVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 K = _TypeVar("K")  # Keys must be objects in JS, but we can't enforce that statically
 V = _TypeVar("V")
@@ -27,7 +27,7 @@ class WeakMap(_Generic[K, V]):
 	Keys must be objects (not primitives).
 	"""
 
-	def __init__(self, iterable: _Iterable[tuple[K, V]] | None = None) -> None: ...
+	def __init__(self, iterable: _Iterable[tuple[K, V]] | None = None, /) -> None: ...
 
 	def delete(self, key: K) -> bool:
 		"""Remove a key and its value. Returns True if the key existed."""
@@ -46,5 +46,5 @@ class WeakMap(_Generic[K, V]):
 		...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="WeakMap", global_scope=True)
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/weakset.py

@@ -2,19 +2,19 @@
 JavaScript WeakSet builtin module.
 
 Usage:
-    import pulse.js.weakset as WeakSet
+    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
-    WeakSet()                     # -> new WeakSet()
 """
 
 from collections.abc import Iterable as _Iterable
 from typing import Generic as _Generic
 from typing import TypeVar as _TypeVar
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 T = _TypeVar("T")  # Values must be objects in JS, but we can't enforce that statically
 
@@ -26,7 +26,7 @@ class WeakSet(_Generic[T]):
 	Values must be objects (not primitives).
 	"""
 
-	def __init__(self, iterable: _Iterable[T] | None = None) -> None: ...
+	def __init__(self, iterable: _Iterable[T] | None = None, /) -> None: ...
 
 	def add(self, value: T) -> "WeakSet[T]":
 		"""Add a value to the WeakSet. Returns the WeakSet for chaining."""
@@ -41,5 +41,5 @@ class WeakSet(_Generic[T]):
 		...
 
 
-# Self-register this module as a JS builtin in global scope
-_register_js_module(name="WeakSet", global_scope=True)
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/window.py

@@ -1,4 +1,4 @@
-"""Browser window global Any.
+"""Browser window global object.
 
 Usage:
     from pulse.js import window
@@ -11,7 +11,7 @@ from typing import Any as _Any
 
 from pulse.js._types import Element as _Element
 from pulse.js._types import Selection as _Selection
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 # Dimensions
 innerWidth: int
@@ -43,33 +43,33 @@ performance: _Any
 
 
 # Dialog methods
-def alert(message: str = "") -> None:
+def alert(message: str = "", /) -> None:
 	"""Display an alert dialog with the given message."""
 	...
 
 
-def confirm(message: str = "") -> bool:
+def confirm(message: str = "", /) -> bool:
 	"""Display a confirmation dialog. Returns True if user clicks OK."""
 	...
 
 
-def prompt(message: str = "", default: str = "") -> str | None:
+def prompt(message: str = "", default: str = "", /) -> str | None:
 	"""Display a prompt dialog. Returns input or None if cancelled."""
 	...
 
 
 # Scroll methods
-def scrollTo(x: float | dict[str, float], y: float | None = None) -> None:
+def scrollTo(x: float | dict[str, float], y: float | None = None, /) -> None:
 	"""Scroll to the given position."""
 	...
 
 
-def scrollBy(x: float | dict[str, float], y: float | None = None) -> None:
+def scrollBy(x: float | dict[str, float], y: float | None = None, /) -> None:
 	"""Scroll by the given amount."""
 	...
 
 
-def scroll(x: float | dict[str, float], y: float | None = None) -> None:
+def scroll(x: float | dict[str, float], y: float | None = None, /) -> None:
 	"""Alias for scrollTo."""
 	...
 
@@ -80,7 +80,7 @@ def getSelection() -> _Selection | None:
 	...
 
 
-def getComputedStyle(element: _Element, pseudoElt: str | None = None) -> _Any:
+def getComputedStyle(element: _Element, pseudoElt: str | None = None, /) -> _Any:
 	"""Return the computed style of an element."""
 	...
 
@@ -101,8 +101,9 @@ def open(
 	url: str = "",
 	target: str = "_blank",
 	features: str = "",
+	/,
 ) -> _Any | None:
-	"""Open a new window. Returns the new window Any or None."""
+	"""Open a new window. Returns the new window object or None."""
 	...
 
 
@@ -112,7 +113,7 @@ def close() -> None:
 
 
 # Timers (these return timer IDs)
-def setTimeout(handler: _Callable[..., None], timeout: int = 0, *args: _Any) -> int:
+def setTimeout(handler: _Callable[..., None], timeout: int = 0, /, *args: _Any) -> int:
 	"""Schedule a function to run after a delay. Returns timer ID."""
 	...
 
@@ -122,7 +123,7 @@ def clearTimeout(timeoutId: int) -> None:
 	...
 
 
-def setInterval(handler: _Callable[..., None], timeout: int = 0, *args: _Any) -> int:
+def setInterval(handler: _Callable[..., None], timeout: int = 0, /, *args: _Any) -> int:
 	"""Schedule a function to run repeatedly. Returns timer ID."""
 	...
 
@@ -148,6 +149,7 @@ def addEventListener(
 	type: str,
 	listener: _Callable[..., None],
 	options: bool | dict[str, bool] | None = None,
+	/,
 ) -> None:
 	"""Add an event listener to the window."""
 	...
@@ -157,6 +159,7 @@ def removeEventListener(
 	type: str,
 	listener: _Callable[..., None],
 	options: bool | dict[str, bool] | None = None,
+	/,
 ) -> None:
 	"""Remove an event listener from the window."""
 	...
@@ -190,10 +193,10 @@ def print_() -> None:
 
 
 def postMessage(
-	message: _Any, targetOrigin: str, transfer: list[_Any] | None = None
+	message: _Any, targetOrigin: str, transfer: list[_Any] | None = None, /
 ) -> None:
 	"""Post a message to another window."""
 	...
 
 
-_register_js_module(name="window")
+JsModule.register(name="window")

pulse/messages.py

@@ -1,7 +1,7 @@
 from typing import Any, Literal, NotRequired, TypedDict
 
 from pulse.routing import RouteInfo
-from pulse.vdom import VDOM, VDOMOperation
+from pulse.transpiler.vdom import VDOM, VDOMOperation
 
 
 # ====================
@@ -11,9 +11,6 @@ class ServerInitMessage(TypedDict):
 	type: Literal["vdom_init"]
 	path: str
 	vdom: VDOM
-	callbacks: list[str]
-	render_props: list[str]
-	jsexpr_paths: list[str]  # paths containing JS expressions
 
 
 class ServerUpdateMessage(TypedDict):