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

pulse/js/__init__.pyi

@@ -45,6 +45,15 @@ from pulse.js._types import (
 from pulse.js._types import (
 	JSIteratorResult as JSIteratorResult,
 )
+from pulse.js._types import (
+	JSONReplacer as JSONReplacer,
+)
+from pulse.js._types import (
+	JSONReviver as JSONReviver,
+)
+from pulse.js._types import (
+	JSONValue as JSONValue,
+)
 from pulse.js._types import (
 	NodeList as NodeList,
 )
@@ -76,7 +85,7 @@ from pulse.js.set import Set as Set
 from pulse.js.string import String as String
 from pulse.js.weakmap import WeakMap as WeakMap
 from pulse.js.weakset import WeakSet as WeakSet
-from pulse.transpiler.nodes import JSUndefined
+from pulse.transpiler.nodes import Undefined
 
 # Re-export namespace modules
 console = pulse.js.console
@@ -91,5 +100,16 @@ def throw(x: _Any) -> _NoReturn:
 	"""Throw a JavaScript error."""
 	...
 
+def obj(**kwargs: _Any) -> _Any:
+	"""Create a plain JavaScript object literal.
+
+	Use this instead of dict() when you need a plain JS object (e.g., for React style prop).
+
+	Example:
+		style=obj(display="block", color="red")
+		# Transpiles to: style={{ display: "block", color: "red" }}
+	"""
+	...
+
 # Primitive values
-undefined: JSUndefined
+undefined: Undefined

pulse/js/_types.py

@@ -126,12 +126,14 @@ class Element(_Protocol):
 		type: str,
 		listener: _Callable[..., None],
 		options: bool | dict[str, bool] | None = None,
+		/,
 	) -> None: ...
 	def removeEventListener(
 		self,
 		type: str,
 		listener: _Callable[..., None],
 		options: bool | dict[str, bool] | None = None,
+		/,
 	) -> None: ...
 	def remove(self) -> None: ...
 	def append(self, *nodes: "Element | str") -> None: ...
@@ -163,7 +165,7 @@ class CSSStyleDeclaration(_Protocol):
 	"""Protocol for CSSStyleDeclaration."""
 
 	def getPropertyValue(self, property: str) -> str: ...
-	def setProperty(self, property: str, value: str, priority: str = "") -> None: ...
+	def setProperty(self, property: str, value: str, priority: str = "", /) -> None: ...
 	def removeProperty(self, property: str) -> str: ...
 
 
@@ -212,7 +214,7 @@ class Selection(_Protocol):
 	def rangeCount(self) -> int: ...
 
 	def getRangeAt(self, index: int) -> "Range": ...
-	def collapse(self, node: Element | None, offset: int = 0) -> None: ...
+	def collapse(self, node: Element | None, offset: int = 0, /) -> None: ...
 	def selectAllChildren(self, node: Element) -> None: ...
 	def removeAllRanges(self) -> None: ...
 	def toString(self) -> str: ...
@@ -240,7 +242,7 @@ class Range(_Protocol):
 	def setEnd(self, node: Element, offset: int) -> None: ...
 	def selectNode(self, node: Element) -> None: ...
 	def selectNodeContents(self, node: Element) -> None: ...
-	def collapse(self, toStart: bool = False) -> None: ...
+	def collapse(self, toStart: bool = False, /) -> None: ...
 	def cloneContents(self) -> Element: ...
 	def deleteContents(self) -> None: ...
 

pulse/js/array.py

@@ -2,29 +2,33 @@
 JavaScript Array builtin module.
 
 Usage:
-    import pulse.js.array as Array
+    from pulse.js import Array
     Array.isArray([1, 2, 3])      # -> Array.isArray([1, 2, 3])
-    Array.from([1, 2, 3])         # -> Array.from([1, 2, 3])
-
-    # Note: For 'from' (Python keyword), use namespace import:
-    # import pulse.js.array as Array; Array.from(...)
-    # Or use the underscore version for direct import:
-    from pulse.js.array import isArray, from_
-    isArray([1, 2, 3])            # -> Array.isArray([1, 2, 3])
-    from_([1, 2, 3])              # -> Array.from([1, 2, 3])
+    Array.from_([1, 2, 3])        # -> Array.from([1, 2, 3])
+    Array(10)                     # -> new Array(10)
+
+    # Or import from module directly:
+    from pulse.js.array import Array
 """
 
+from __future__ import annotations
+
 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 TypeGuard as _TypeGuard
 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")
 U = _TypeVar("U")
-S = _TypeVar("S")
+# TypeVars for static methods (can't use class-level T)
+_T = _TypeVar("_T")
+_U = _TypeVar("_U")
 
 
 class Array(_Generic[T]):
@@ -34,6 +38,21 @@ class Array(_Generic[T]):
 	All instance methods preserve the expected generic types.
 	"""
 
+	@_overload
+	def __init__(self) -> None:
+		"""Create an empty Array."""
+		...
+
+	@_overload
+	def __init__(self, length: int, /) -> None:
+		"""Create an Array with the specified length."""
+		...
+
+	@_overload
+	def __init__(self, *elements: T) -> None:
+		"""Create an Array with the given elements."""
+		...
+
 	def __init__(self, *args: T | int) -> None:
 		"""Create an Array.
 
@@ -45,21 +64,60 @@ class Array(_Generic[T]):
 
 	# Static methods
 	@staticmethod
-	def isArray(value: _Any) -> bool:
+	@_overload
+	def isArray(value: list[_T], /) -> _TypeGuard["Array[_T]"]:
+		"""Determine whether the passed value is an Array."""
+		...
+
+	@staticmethod
+	@_overload
+	def isArray(value: "Array[_T]", /) -> _TypeGuard["Array[_T]"]:
+		"""Determine whether the passed value is an Array."""
+		...
+
+	@staticmethod
+	@_overload
+	def isArray(value: _Any, /) -> _TypeGuard["Array[_Any]"]:
 		"""Determine whether the passed value is an Array."""
 		...
 
 	@staticmethod
+	def isArray(value: _Any, /) -> _TypeGuard["Array[_Any]"]:
+		"""Determine whether the passed value is an Array."""
+		...
+
+	@staticmethod
+	@_overload
 	def from_(
-		arrayLike: _Iterable[T],
-		mapFn: _Callable[[T, int], U] | None = None,
+		arrayLike: _Iterable[_T] | "Array[_T]",
+		/,
+	) -> "Array[_T]":
+		"""Create a new Array from an array-like or iterable object."""
+		...
+
+	@staticmethod
+	@_overload
+	def from_(
+		arrayLike: _Iterable[_T] | "Array[_T]",
+		mapFn: _Callable[[_T, int], _U],
 		thisArg: _Any | None = None,
-	) -> "list[U] | list[T]":
+		/,
+	) -> "Array[_U]":
+		"""Create a new Array from an array-like or iterable object, mapping each element."""
+		...
+
+	@staticmethod
+	def from_(
+		arrayLike: _Iterable[_T] | "Array[_T]",
+		mapFn: _Callable[[_T, int], _U] | None = None,
+		thisArg: _Any | None = None,
+		/,
+	) -> "Array[_U] | Array[_T]":
 		"""Create a new Array from an array-like or iterable object."""
 		...
 
 	@staticmethod
-	def of(*elements: T) -> "list[T]":
+	def of(*elements: _T) -> "Array[_T]":
 		"""Create a new Array from a variable number of arguments."""
 		...
 
@@ -87,8 +145,8 @@ class Array(_Generic[T]):
 		...
 
 	def splice(
-		self, start: int, deleteCount: int | None = None, *items: T
-	) -> "list[T]":
+		self, start: int, deleteCount: int | None = None, /, *items: T
+	) -> "Array[T]":
 		"""Remove/replace elements and optionally insert new ones."""
 		...
 
@@ -96,42 +154,42 @@ class Array(_Generic[T]):
 		"""Reverse the array in place."""
 		...
 
-	def sort(self, compareFn: _Callable[[T, T], int] | None = None) -> "Array[T]":
+	def sort(self, compareFn: _Callable[[T, T], int] | None = None, /) -> "Array[T]":
 		"""Sort the array in place."""
 		...
 
-	def fill(self, value: T, start: int = 0, end: int | None = None) -> "Array[T]":
+	def fill(self, value: T, start: int = 0, end: int | None = None, /) -> "Array[T]":
 		"""Fill all elements with a static value."""
 		...
 
 	def copyWithin(
-		self, target: int, start: int = 0, end: int | None = None
+		self, target: int, start: int = 0, end: int | None = None, /
 	) -> "Array[T]":
 		"""Copy part of the array to another location within it."""
 		...
 
 	# Accessor methods (return new arrays or values)
-	def concat(self, *items: T | "_Iterable[T]") -> "list[T]":
+	def concat(self, *items: T | "_Iterable[T]") -> "Array[T]":
 		"""Merge arrays and/or values into a new array."""
 		...
 
-	def slice(self, start: int = 0, end: int | None = None) -> "list[T]":
+	def slice(self, start: int = 0, end: int | None = None, /) -> "Array[T]":
 		"""Return a shallow copy of a portion of the array."""
 		...
 
-	def join(self, separator: str = ",") -> str:
+	def join(self, separator: str = ",", /) -> str:
 		"""Join all elements into a string."""
 		...
 
-	def indexOf(self, searchElement: T, fromIndex: int = 0) -> int:
+	def indexOf(self, searchElement: T, fromIndex: int = 0, /) -> int:
 		"""Return first index of element, or -1 if not found."""
 		...
 
-	def lastIndexOf(self, searchElement: T, fromIndex: int | None = None) -> int:
+	def lastIndexOf(self, searchElement: T, fromIndex: int | None = None, /) -> int:
 		"""Return last index of element, or -1 if not found."""
 		...
 
-	def includes(self, searchElement: T, fromIndex: int = 0) -> bool:
+	def includes(self, searchElement: T, fromIndex: int = 0, /) -> bool:
 		"""Determine whether the array contains the element."""
 		...
 
@@ -139,31 +197,33 @@ class Array(_Generic[T]):
 		"""Return element at index (supports negative indexing)."""
 		...
 
-	def flat(self, depth: int = 1) -> "list[_Any]":
+	def flat(self, depth: int = 1, /) -> "Array[_Any]":
 		"""Flatten nested arrays to the specified depth."""
 		...
 
 	def flatMap(
 		self, callback: _Callable[[T, int, "Array[T]"], _Iterable[U]]
-	) -> "list[U]":
+	) -> "Array[U]":
 		"""Map then flatten the result by one level."""
 		...
 
-	def toReversed(self) -> "list[T]":
+	def toReversed(self) -> "Array[T]":
 		"""Return a new reversed array (ES2023)."""
 		...
 
-	def toSorted(self, compareFn: _Callable[[T, T], int] | None = None) -> "list[T]":
+	def toSorted(
+		self, compareFn: _Callable[[T, T], int] | None = None, /
+	) -> "Array[T]":
 		"""Return a new sorted array (ES2023)."""
 		...
 
 	def toSpliced(
-		self, start: int, deleteCount: int | None = None, *items: T
-	) -> "list[T]":
+		self, start: int, deleteCount: int | None = None, /, *items: T
+	) -> "Array[T]":
 		"""Return a new array with elements spliced (ES2023)."""
 		...
 
-	def with_(self, index: int, value: T) -> "list[T]":
+	def with_(self, index: int, value: T) -> "Array[T]":
 		"""Return a new array with element at index replaced (ES2023)."""
 		...
 
@@ -172,11 +232,11 @@ class Array(_Generic[T]):
 		"""Execute a function for each element."""
 		...
 
-	def map(self, callback: _Callable[[T, int, "Array[T]"], U]) -> "list[U]":
+	def map(self, callback: _Callable[[T, int, "Array[T]"], U]) -> "Array[U]":
 		"""Create a new array with results of calling callback on each element."""
 		...
 
-	def filter(self, callback: _Callable[[T, int, "Array[T]"], bool]) -> "list[T]":
+	def filter(self, callback: _Callable[[T, int, "Array[T]"], bool]) -> "Array[T]":
 		"""Create a new array with elements that pass the test."""
 		...
 
@@ -184,6 +244,7 @@ class Array(_Generic[T]):
 		self,
 		callback: _Callable[[U, T, int, "Array[T]"], U],
 		initialValue: U | None = None,
+		/,
 	) -> U:
 		"""Reduce array to a single value (left to right).
 
@@ -195,6 +256,7 @@ class Array(_Generic[T]):
 		self,
 		callback: _Callable[[U, T, int, "Array[T]"], U],
 		initialValue: U | None = None,
+		/,
 	) -> U:
 		"""Reduce array to a single value (right to left).
 
@@ -248,6 +310,27 @@ class Array(_Generic[T]):
 		"""Return a localized string representing the array."""
 		...
 
+	# Python protocol methods
+	def __iter__(self) -> _Iterator[T]:
+		"""Iterate over array elements."""
+		...
+
+	def __getitem__(self, index: int) -> T:
+		"""Get element at index."""
+		...
+
+	def __setitem__(self, index: int, value: T) -> None:
+		"""Set element at index."""
+		...
+
+	def __len__(self) -> int:
+		"""Return the number of elements (same as length)."""
+		...
+
+	def __contains__(self, value: T) -> bool:
+		"""Check if value exists in the array (same as includes)."""
+		...
+
 
-# Self-register this module as a JS builtin
-_register_js_module(name="Array", global_scope=True)
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/console.py

@@ -18,16 +18,16 @@ Usage:
 
 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
 
 
 # Methods (type stubs for IDE support)
 def assert_(condition: bool, *data: _Any) -> None: ...
 def clear() -> None: ...
-def count(label: str | None = None) -> None: ...
-def countReset(label: str | None = None) -> None: ...
+def count(label: str | None = None, /) -> None: ...
+def countReset(label: str | None = None, /) -> None: ...
 def debug(*data: _Any) -> None: ...
-def dir(item: _Any, options: dict[str, _Any] | None = None) -> None: ...
+def dir(item: _Any, options: dict[str, _Any] | None = None, /) -> None: ...
 def dirxml(*data: _Any) -> None: ...
 def error(*data: _Any) -> None: ...
 def group(*label: _Any) -> None: ...
@@ -35,13 +35,13 @@ def groupCollapsed(*label: _Any) -> None: ...
 def groupEnd() -> None: ...
 def info(*data: _Any) -> None: ...
 def log(*data: _Any) -> None: ...
-def table(tabularData: _Any, properties: list[str] | None = None) -> None: ...
-def time(label: str | None = None) -> None: ...
-def timeEnd(label: str | None = None) -> None: ...
-def timeLog(label: str | None = None, *data: _Any) -> None: ...
+def table(tabularData: _Any, properties: list[str] | None = None, /) -> None: ...
+def time(label: str | None = None, /) -> None: ...
+def timeEnd(label: str | None = None, /) -> None: ...
+def timeLog(label: str | None = None, /, *data: _Any) -> None: ...
 def trace(*data: _Any) -> None: ...
 def warn(*data: _Any) -> None: ...
 
 
 # Self-register this module as a JS builtin
-_register_js_module(name="console")
+JsModule.register(name="console")

pulse/js/date.py

@@ -2,24 +2,24 @@
 JavaScript Date builtin module.
 
 Usage:
-    import pulse.js.date as Date
+    from pulse.js import Date
+    Date()                        # -> new Date()
     Date.now()                    # -> Date.now()
     Date.parse("2023-01-01")      # -> Date.parse("2023-01-01")
 
-    from pulse.js.date import now, parse
-    now()                         # -> Date.now()
-    parse("2023-01-01")           # -> Date.parse("2023-01-01")
+    # Or import from module directly:
+    from pulse.js.date import Date
 """
 
 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 Date:
 	"""Class for JavaScript Date instances."""
 
-	def __init__(self, value: int | str | None = None): ...
+	def __init__(self, value: int | str | None = None, /): ...
 
 	@staticmethod
 	def now() -> float: ...
@@ -36,6 +36,7 @@ class Date:
 		minutes: int | None = None,
 		seconds: int | None = None,
 		ms: int | None = None,
+		/,
 	) -> float: ...
 
 	def getDate(self) -> int: ...
@@ -58,7 +59,7 @@ class Date:
 	def getUTCSeconds(self) -> int: ...
 	def setDate(self, date: int) -> float: ...
 	def setFullYear(
-		self, year: int, month: int | None = None, date: int | None = None
+		self, year: int, month: int | None = None, date: int | None = None, /
 	) -> float: ...
 	def setHours(
 		self,
@@ -66,13 +67,14 @@ class Date:
 		min: int | None = None,
 		sec: int | None = None,
 		ms: int | None = None,
+		/,
 	) -> float: ...
 	def setMilliseconds(self, ms: int) -> float: ...
 	def setMinutes(
-		self, min: int, sec: int | None = None, ms: int | None = None
+		self, min: int, sec: int | None = None, ms: int | None = None, /
 	) -> float: ...
-	def setMonth(self, month: int, date: int | None = None) -> float: ...
-	def setSeconds(self, sec: int, ms: int | None = None) -> float: ...
+	def setMonth(self, month: int, date: int | None = None, /) -> float: ...
+	def setSeconds(self, sec: int, ms: int | None = None, /) -> float: ...
 	def setTime(self, time: float) -> float: ...
 	def setUTCDate(self, date: int) -> float: ...
 	def setUTCFullYear(
@@ -84,24 +86,25 @@ class Date:
 		min: int | None = None,
 		sec: int | None = None,
 		ms: int | None = None,
+		/,
 	) -> float: ...
 	def setUTCMilliseconds(self, ms: int) -> float: ...
 	def setUTCMinutes(
-		self, min: int, sec: int | None = None, ms: int | None = None
+		self, min: int, sec: int | None = None, ms: int | None = None, /
 	) -> float: ...
-	def setUTCMonth(self, month: int, date: int | None = None) -> float: ...
-	def setUTCSeconds(self, sec: int, ms: int | None = None) -> float: ...
+	def setUTCMonth(self, month: int, date: int | None = None, /) -> float: ...
+	def setUTCSeconds(self, sec: int, ms: int | None = None, /) -> float: ...
 	def toDateString(self) -> str: ...
 	def toISOString(self) -> str: ...
-	def toJSON(self, key: _Any | None = None) -> str: ...
+	def toJSON(self, key: _Any | None = None, /) -> str: ...
 	def toLocaleDateString(
-		self, locales: str | None = None, options: _Any | None = None
+		self, locales: str | None = None, options: _Any | None = None, /
 	) -> str: ...
 	def toLocaleString(
-		self, locales: str | None = None, options: _Any | None = None
+		self, locales: str | None = None, options: _Any | None = None, /
 	) -> str: ...
 	def toLocaleTimeString(
-		self, locales: str | None = None, options: _Any | None = None
+		self, locales: str | None = None, options: _Any | None = None, /
 	) -> str: ...
 	def toString(self) -> str: ...
 	def toTimeString(self) -> str: ...
@@ -109,5 +112,5 @@ class Date:
 	def valueOf(self) -> float: ...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="Date", global_scope=True)
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/document.py

@@ -12,7 +12,7 @@ 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.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 # Read-only properties
 body: _HTMLElement
@@ -59,7 +59,9 @@ def getElementsByName(elementName: str) -> _NodeList[_Element]:
 
 
 # Element creation
-def createElement(tagName: str, options: dict[str, str] | None = None) -> _HTMLElement:
+def createElement(
+	tagName: str, options: dict[str, str] | None = None, /
+) -> _HTMLElement:
 	"""Create a new element with the given tag name."""
 	...
 
@@ -84,6 +86,7 @@ def addEventListener(
 	type: str,
 	listener: _Callable[..., None],
 	options: bool | dict[str, bool] | None = None,
+	/,
 ) -> None:
 	"""Add an event listener to the document."""
 	...
@@ -93,6 +96,7 @@ def removeEventListener(
 	type: str,
 	listener: _Callable[..., None],
 	options: bool | dict[str, bool] | None = None,
+	/,
 ) -> None:
 	"""Remove an event listener from the document."""
 	...
@@ -116,7 +120,7 @@ def getSelection() -> _Any:
 
 
 # Node tree methods
-def importNode(node: _Element, deep: bool = False) -> _Element:
+def importNode(node: _Element, deep: bool = False, /) -> _Element:
 	"""Import a node from another document."""
 	...
 
@@ -135,4 +139,4 @@ def exitFullscreen() -> _Any:
 fullscreenElement: _Element | None
 
 
-_register_js_module(name="document")
+JsModule.register(name="document")

pulse/js/error.py

@@ -2,22 +2,20 @@
 JavaScript Error builtin module.
 
 Usage:
-    import pulse.js.error as Error
+    from pulse.js import Error
     Error("message")              # -> new Error("message")
-    Error.RangeError("message")   # -> new RangeError("message")
 
-    from pulse.js.error import Error, TypeError, RangeError, ReferenceError
-    Error("message")              # -> new Error("message")
+    from pulse.js.error import TypeError, RangeError, ReferenceError
     TypeError("message")         # -> new TypeError("message")
 """
 
-from pulse.transpiler.js_module import register_js_module as _register_js_module
+from pulse.transpiler.js_module import JsModule
 
 
 class Error:
 	"""Class for JavaScript Error instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -36,7 +34,7 @@ class Error:
 class EvalError:
 	"""Class for JavaScript EvalError instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -53,7 +51,7 @@ class EvalError:
 class RangeError:
 	"""Class for JavaScript RangeError instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -70,7 +68,7 @@ class RangeError:
 class ReferenceError:
 	"""Class for JavaScript ReferenceError instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -87,7 +85,7 @@ class ReferenceError:
 class SyntaxError:
 	"""Class for JavaScript SyntaxError instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -104,7 +102,7 @@ class SyntaxError:
 class TypeError:
 	"""Class for JavaScript TypeError instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -121,7 +119,7 @@ class TypeError:
 class URIError:
 	"""Class for JavaScript URIError instances."""
 
-	def __init__(self, message: str | None = None): ...
+	def __init__(self, message: str | None = None, /): ...
 
 	@property
 	def message(self) -> str: ...
@@ -135,5 +133,5 @@ class URIError:
 	def toString(self) -> str: ...
 
 
-# Self-register this module as a JS builtin
-_register_js_module(name="Error", global_scope=True)
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)