pulse-framework 0.1.62__py3-none-any.whl

pulse/js/date.py

@@ -0,0 +1,119 @@
+"""
+JavaScript Date builtin module.
+
+Usage:
+
+```python
+from pulse.js import Date
+Date()                        # -> new Date()
+Date.now()                    # -> Date.now()
+Date.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 JsModule
+
+
+class Date:
+	"""Class for JavaScript Date instances."""
+
+	def __init__(self, value: int | str | None = None, /): ...
+
+	@staticmethod
+	def now() -> float: ...
+
+	@staticmethod
+	def parse(dateString: str) -> float: ...
+
+	@staticmethod
+	def UTC(
+		year: int,
+		month: int,
+		date: int | None = None,
+		hours: int | None = None,
+		minutes: int | None = None,
+		seconds: int | None = None,
+		ms: int | None = None,
+		/,
+	) -> float: ...
+
+	def getDate(self) -> int: ...
+	def getDay(self) -> int: ...
+	def getFullYear(self) -> int: ...
+	def getHours(self) -> int: ...
+	def getMilliseconds(self) -> int: ...
+	def getMinutes(self) -> int: ...
+	def getMonth(self) -> int: ...
+	def getSeconds(self) -> int: ...
+	def getTime(self) -> float: ...
+	def getTimezoneOffset(self) -> int: ...
+	def getUTCDate(self) -> int: ...
+	def getUTCDay(self) -> int: ...
+	def getUTCFullYear(self) -> int: ...
+	def getUTCHours(self) -> int: ...
+	def getUTCMilliseconds(self) -> int: ...
+	def getUTCMinutes(self) -> int: ...
+	def getUTCMonth(self) -> int: ...
+	def getUTCSeconds(self) -> int: ...
+	def setDate(self, date: int) -> float: ...
+	def setFullYear(
+		self, year: int, month: int | None = None, date: int | None = None, /
+	) -> float: ...
+	def setHours(
+		self,
+		hours: int,
+		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, /
+	) -> 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(
+		self, year: int, month: int | None = None, date: int | None = None
+	) -> float: ...
+	def setUTCHours(
+		self,
+		hours: int,
+		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, /
+	) -> 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 toLocaleDateString(
+		self, locales: str | None = None, options: _Any | None = None, /
+	) -> str: ...
+	def toLocaleString(
+		self, locales: str | None = None, options: _Any | None = None, /
+	) -> str: ...
+	def toLocaleTimeString(
+		self, locales: str | None = None, options: _Any | None = None, /
+	) -> str: ...
+	def toString(self) -> str: ...
+	def toTimeString(self) -> str: ...
+	def toUTCString(self) -> str: ...
+	def valueOf(self) -> float: ...
+
+
+# Self-register this module as a JS builtin (global identifier)
+JsModule.register(name=None)

pulse/js/document.py

@@ -0,0 +1,145 @@
+"""Browser document global object.
+
+Usage:
+
+```python
+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 JsModule
+
+# 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
+
+
+JsModule.register(name="document")

pulse/js/error.py

@@ -0,0 +1,140 @@
+"""
+JavaScript Error builtin module.
+
+Usage:
+
+```python
+from pulse.js import Error
+Error("message")              # -> new Error("message")
+
+from pulse.js.error import TypeError, RangeError, ReferenceError
+TypeError("message")         # -> new TypeError("message")
+```
+"""
+
+from pulse.transpiler.js_module import JsModule
+
+
+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 (global identifiers)
+JsModule.register(name=None)

pulse/js/json.py

@@ -0,0 +1,66 @@
+"""
+JavaScript JSON builtin module.
+
+Usage:
+
+```python
+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 JsModule
+
+# 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
+JsModule.register(name="JSON")

pulse/js/map.py

@@ -0,0 +1,97 @@
+"""
+JavaScript Map builtin module.
+
+Usage:
+
+```python
+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
+```
+"""
+
+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 JsModule
+
+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) -> _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 (global identifiers)
+JsModule.register(name=None)

pulse/js/math.py

@@ -0,0 +1,69 @@
+"""
+JavaScript Math builtin module.
+
+Usage:
+
+```python
+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 JsModule
+
+# 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
+JsModule.register(name="Math")

pulse/js/navigator.py

@@ -0,0 +1,79 @@
+"""Browser navigator global object.
+
+Usage:
+
+```python
+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 JsModule
+
+# 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."""
+	...
+
+
+JsModule.register(name="navigator")