pulse-framework 0.1.46__py3-none-any.whl → 0.1.48__py3-none-any.whl

pulse/js/document.py

@@ -0,0 +1,138 @@
+"""Browser document global object.
+
+Usage:
+    from pulse.js import document
+    document.querySelector("#app")      # -> document.querySelector("#app")
+"""
+
+from collections.abc import Callable as _Callable
+from typing import Any as _Any
+
+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
+
+# Read-only properties
+body: _HTMLElement
+head: _HTMLElement
+documentElement: _HTMLElement
+activeElement: _Element | None
+title: str
+readyState: str  # "loading" | "interactive" | "complete"
+cookie: str
+referrer: str
+URL: str
+domain: str
+
+
+# Query methods
+def querySelector(selectors: str) -> _Element | None:
+	"""Return the first element matching the selector, or None."""
+	...
+
+
+def querySelectorAll(selectors: str) -> _NodeList[_Element]:
+	"""Return all elements matching the selector."""
+	...
+
+
+def getElementById(elementId: str) -> _Element | None:
+	"""Return the element with the given ID, or None."""
+	...
+
+
+def getElementsByClassName(classNames: str) -> _HTMLCollection[_Element]:
+	"""Return all elements with the given class name(s)."""
+	...
+
+
+def getElementsByTagName(qualifiedName: str) -> _HTMLCollection[_Element]:
+	"""Return all elements with the given tag name."""
+	...
+
+
+def getElementsByName(elementName: str) -> _NodeList[_Element]:
+	"""Return all elements with the given name attribute."""
+	...
+
+
+# Element creation
+def createElement(tagName: str, options: dict[str, str] | None = None) -> _HTMLElement:
+	"""Create a new element with the given tag name."""
+	...
+
+
+def createTextNode(data: str) -> _Any:
+	"""Create a new text node."""
+	...
+
+
+def createDocumentFragment() -> _Any:
+	"""Create a new document fragment."""
+	...
+
+
+def createComment(data: str) -> _Any:
+	"""Create a new comment node."""
+	...
+
+
+# Event methods
+def addEventListener(
+	type: str,
+	listener: _Callable[..., None],
+	options: bool | dict[str, bool] | None = None,
+) -> None:
+	"""Add an event listener to the document."""
+	...
+
+
+def removeEventListener(
+	type: str,
+	listener: _Callable[..., None],
+	options: bool | dict[str, bool] | None = None,
+) -> None:
+	"""Remove an event listener from the document."""
+	...
+
+
+def dispatchEvent(event: _Any) -> bool:
+	"""Dispatch an event to the document."""
+	...
+
+
+# Focus methods
+def hasFocus() -> bool:
+	"""Return True if the document has focus."""
+	...
+
+
+# Selection
+def getSelection() -> _Any:
+	"""Return the current selection."""
+	...
+
+
+# Node tree methods
+def importNode(node: _Element, deep: bool = False) -> _Element:
+	"""Import a node from another document."""
+	...
+
+
+def adoptNode(node: _Element) -> _Element:
+	"""Adopt a node from another document."""
+	...
+
+
+# Full-screen API
+def exitFullscreen() -> _Any:
+	"""Exit full-screen mode. Returns a Promise."""
+	...
+
+
+fullscreenElement: _Element | None
+
+
+_register_js_module(name="document")

pulse/js/error.py

@@ -0,0 +1,139 @@
+"""
+JavaScript Error builtin module.
+
+Usage:
+    import pulse.js.error as 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")
+    TypeError("message")         # -> new TypeError("message")
+"""
+
+from pulse.transpiler.js_module import register_js_module as _register_js_module
+
+
+class Error:
+	"""Class for JavaScript Error instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+# Error Subclasses - these are separate globals in JS, not members of Error
+# TODO: These need a different architecture (separate modules or standalone identifiers)
+class EvalError:
+	"""Class for JavaScript EvalError instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+class RangeError:
+	"""Class for JavaScript RangeError instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+class ReferenceError:
+	"""Class for JavaScript ReferenceError instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+class SyntaxError:
+	"""Class for JavaScript SyntaxError instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+class TypeError:
+	"""Class for JavaScript TypeError instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+class URIError:
+	"""Class for JavaScript URIError instances."""
+
+	def __init__(self, message: str | None = None): ...
+
+	@property
+	def message(self) -> str: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def stack(self) -> str | None: ...
+
+	def toString(self) -> str: ...
+
+
+# Self-register this module as a JS builtin
+_register_js_module(name="Error", global_scope=True)

pulse/js/json.py

@@ -0,0 +1,62 @@
+"""
+JavaScript JSON builtin module.
+
+Usage:
+    import pulse.js.json as JSON
+    JSON.stringify({"a": 1})      # -> JSON.stringify({"a": 1})
+    JSON.parse('{"a": 1}')        # -> JSON.parse('{"a": 1}')
+
+    from pulse.js.json import stringify, parse
+    stringify({"a": 1})           # -> JSON.stringify({"a": 1})
+    parse('{"a": 1}')             # -> JSON.parse('{"a": 1}')
+"""
+
+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
+
+# JSON types
+JSONValue = None | bool | int | float | str | list["JSONValue"] | dict[str, "JSONValue"]
+JSONReplacer = _Sequence[str | int] | _Callable[[str, JSONValue], JSONValue]
+JSONReviver = _Callable[[str, JSONValue], JSONValue]
+
+T = _TypeVar("T")
+
+
+def parse(text: str, reviver: JSONReviver | None = None) -> JSONValue:
+	"""Parse a JSON string into a JavaScript value.
+
+	Args:
+	    text: The JSON string to parse.
+	    reviver: Optional function (key: str, value: Any) -> Any that transforms the parsed value.
+	        Called for each key-value pair. Return the value to use, or undefined to omit.
+
+	Returns:
+	    The parsed JavaScript value (null, bool, number, string, array, or object).
+	"""
+	...
+
+
+def stringify(
+	value: JSONValue,
+	replacer: JSONReplacer | None = None,
+	space: int | str | None = None,
+) -> str:
+	"""Convert a JavaScript value to a JSON string.
+
+	Args:
+	    value: The value to convert to JSON.
+	    replacer: Optional array of property names/indices, or function (key: str, value: Any) -> Any
+	        that controls which properties are included. Return undefined to omit.
+	    space: Optional indentation. Number for spaces per level, or string (up to 10 chars).
+
+	Returns:
+	    The JSON string representation of the value.
+	"""
+	...
+
+
+# Self-register this module as a JS builtin
+_register_js_module(name="JSON")

pulse/js/map.py

@@ -0,0 +1,84 @@
+"""
+JavaScript Map builtin module.
+
+Usage:
+    import pulse.js.map as Map
+    Map()                         # -> new Map()
+    Map([["a", 1]])              # -> new Map([["a", 1]])
+
+    from pulse.js.map import Map
+    Map()                         # -> new Map()
+"""
+
+from collections.abc import Callable as _Callable
+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 pulse.transpiler.js_module import register_js_module as _register_js_module
+
+K = _TypeVar("K")
+V = _TypeVar("V")
+
+
+class Map(_Generic[K, V]):
+	"""JavaScript Map - a collection of keyed data items.
+
+	Map[K, V] preserves insertion order and allows keys of any type.
+	"""
+
+	def __init__(self, iterable: _Iterable[tuple[K, V]] | None = None) -> None: ...
+
+	@property
+	def size(self) -> int:
+		"""The number of key/value pairs in the Map."""
+		...
+
+	def clear(self) -> None:
+		"""Remove all key/value pairs."""
+		...
+
+	def delete(self, key: K) -> bool:
+		"""Remove a key and its value. Returns True if the key existed."""
+		...
+
+	def get(self, key: K) -> V | None:
+		"""Return the value for a key, or None if not present."""
+		...
+
+	def has(self, key: K) -> bool:
+		"""Return True if the key exists in the Map."""
+		...
+
+	def set(self, key: K, value: V) -> "Map[K, V]":
+		"""Set a key/value pair. Returns the Map for chaining."""
+		...
+
+	def forEach(
+		self,
+		callback: _Callable[[V, K, "Map[K, V]"], None],
+		thisArg: _Any | None = None,
+	) -> None:
+		"""Execute a function for each key/value pair."""
+		...
+
+	def keys(self) -> _Iterable[K]:
+		"""Return an iterator of keys."""
+		...
+
+	def values(self) -> _Iterable[V]:
+		"""Return an iterator of values."""
+		...
+
+	def entries(self) -> _Iterable[tuple[K, V]]:
+		"""Return an iterator of [key, value] pairs."""
+		...
+
+	def __iter__(self) -> _Iterable[tuple[K, V]]:
+		"""Iterate over [key, value] pairs."""
+		...
+
+
+# Self-register this module as a JS builtin in global scope
+_register_js_module(name="Map", global_scope=True)

pulse/js/math.py

@@ -0,0 +1,66 @@
+"""
+JavaScript Math builtin module.
+
+Usage:
+    import pulse.js.math as Math
+    Math.PI           # -> Math.PI
+    Math.floor(3.7)   # -> Math.floor(3.7)
+
+    from pulse.js.math import PI, floor
+    PI                # -> Math.PI
+    floor(3.7)        # -> Math.floor(3.7)
+"""
+
+from pulse.transpiler.js_module import register_js_module as _register_js_module
+
+# Constants (type stubs for IDE support)
+PI: float
+E: float
+LN2: float
+LN10: float
+LOG2E: float
+LOG10E: float
+SQRT1_2: float
+SQRT2: float
+
+
+# Methods (type stubs for IDE support)
+def abs(x: float) -> float: ...
+def acos(x: float) -> float: ...
+def acosh(x: float) -> float: ...
+def asin(x: float) -> float: ...
+def asinh(x: float) -> float: ...
+def atan(x: float) -> float: ...
+def atan2(y: float, x: float) -> float: ...
+def atanh(x: float) -> float: ...
+def cbrt(x: float) -> float: ...
+def ceil(x: float) -> int: ...
+def clz32(x: int) -> int: ...
+def cos(x: float) -> float: ...
+def cosh(x: float) -> float: ...
+def exp(x: float) -> float: ...
+def expm1(x: float) -> float: ...
+def floor(x: float) -> int: ...
+def fround(x: float) -> float: ...
+def hypot(*values: float) -> float: ...
+def imul(x: int, y: int) -> int: ...
+def log(x: float) -> float: ...
+def log10(x: float) -> float: ...
+def log1p(x: float) -> float: ...
+def log2(x: float) -> float: ...
+def max(*values: float) -> float: ...
+def min(*values: float) -> float: ...
+def pow(x: float, y: float) -> float: ...
+def random() -> float: ...
+def round(x: float) -> int: ...
+def sign(x: float) -> int: ...
+def sin(x: float) -> float: ...
+def sinh(x: float) -> float: ...
+def sqrt(x: float) -> float: ...
+def tan(x: float) -> float: ...
+def tanh(x: float) -> float: ...
+def trunc(x: float) -> int: ...
+
+
+# Self-register this module as a JS builtin
+_register_js_module(name="Math")

pulse/js/navigator.py

@@ -0,0 +1,76 @@
+"""Browser navigator global object.
+
+Usage:
+    from pulse.js import navigator, console
+    console.log(navigator.userAgent)
+"""
+
+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
+
+# User agent and browser info
+userAgent: str
+language: str
+languages: list[str]
+platform: str
+vendor: str
+appName: str
+appVersion: str
+
+# Online status
+onLine: bool
+
+# Hardware info
+hardwareConcurrency: int
+maxTouchPoints: int
+deviceMemory: float | None  # May not be available in all browsers
+
+# Cookies
+cookieEnabled: bool
+
+# PDF viewer
+pdfViewerEnabled: bool
+
+# Clipboard API
+clipboard: _Clipboard
+
+# Media devices (typed as _Any for simplicity)
+mediaDevices: _Any
+
+# Permissions (typed as _Any for simplicity)
+permissions: _Any
+
+# Service worker (typed as _Any for simplicity)
+serviceWorker: _Any
+
+# Geolocation (typed as _Any for simplicity)
+geolocation: _Any
+
+# Storage
+storage: _Any
+
+
+# Methods
+def vibrate(pattern: int | list[int]) -> bool:
+	"""Vibrate the device. Returns True if vibration is supported."""
+	...
+
+
+def share(data: dict[str, str]) -> _Any:
+	"""Share data via the Web Share API. Returns a Promise."""
+	...
+
+
+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:
+	"""Check if data can be shared via the Web Share API."""
+	...
+
+
+_register_js_module(name="navigator")

pulse/js/number.py

@@ -0,0 +1,54 @@
+"""
+JavaScript Number builtin module.
+
+Usage:
+    import pulse.js.number as Number
+    Number.isFinite(42)       # -> Number.isFinite(42)
+    Number.MAX_SAFE_INTEGER   # -> Number.MAX_SAFE_INTEGER
+
+    from pulse.js.number import isFinite, EPSILON
+    isFinite(42)              # -> Number.isFinite(42)
+    EPSILON                   # -> Number.EPSILON
+"""
+
+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
+
+
+class Number:
+	"""JavaScript Number constructor and namespace."""
+
+	def __init__(self, value: _Any) -> None: ...
+
+	EPSILON: _ClassVar[float]
+	MAX_SAFE_INTEGER: _ClassVar[int]
+	MAX_VALUE: _ClassVar[float]
+	MIN_SAFE_INTEGER: _ClassVar[int]
+	MIN_VALUE: _ClassVar[float]
+	NaN: _ClassVar[float]
+	NEGATIVE_INFINITY: _ClassVar[float]
+	POSITIVE_INFINITY: _ClassVar[float]
+
+	@staticmethod
+	def isFinite(value: float) -> bool: ...
+
+	@staticmethod
+	def isInteger(value: float) -> bool: ...
+
+	@staticmethod
+	def isNaN(value: float) -> bool: ...
+
+	@staticmethod
+	def isSafeInteger(value: float) -> bool: ...
+
+	@staticmethod
+	def parseFloat(string: str) -> float: ...
+
+	@staticmethod
+	def parseInt(string: str, radix: int = 10) -> int: ...
+
+
+# Self-register this module as a JS builtin
+_register_js_module(name="Number")