pulse-framework 0.1.74__py3-none-any.whl → 0.1.75__py3-none-any.whl

pulse/js/fetch_api.py

@@ -0,0 +1,126 @@
+"""
+JavaScript Fetch API builtins.
+
+Usage:
+
+```python
+from pulse.js import fetch, Request, Headers, obj
+
+@ps.javascript
+async def example():
+    req = Request("/api", obj(method="GET"))
+    res = await fetch(req)
+    return res.json()
+```
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable as _Callable
+from typing import Any as _Any
+from typing import TypedDict as _TypedDict
+
+from pulse.js.abort_controller import AbortSignal
+from pulse.transpiler.js_module import JsModule
+
+
+class RequestInit(_TypedDict, total=False):
+	method: str
+	headers: _Any
+	body: _Any
+	mode: str
+	credentials: str
+	cache: str
+	redirect: str
+	referrer: str
+	referrerPolicy: str
+	integrity: str
+	keepalive: bool
+	signal: AbortSignal
+	window: _Any
+
+
+class ResponseInit(_TypedDict, total=False):
+	status: int
+	statusText: str
+	headers: _Any
+
+
+class Headers:
+	"""HTTP headers for fetch requests/responses."""
+
+	def __init__(self, init: _Any | None = None, /) -> None: ...
+
+	def append(self, name: str, value: str, /) -> None: ...
+
+	def delete(self, name: str, /) -> None: ...
+
+	def get(self, name: str, /) -> str | None: ...
+
+	def has(self, name: str, /) -> bool: ...
+
+	def set(self, name: str, value: str, /) -> None: ...
+
+	def forEach(
+		self,
+		callback: _Callable[[str, str, "Headers"], None],
+		thisArg: _Any | None = None,
+		/,
+	) -> None: ...
+
+
+class Request:
+	"""Represents a resource request."""
+
+	def __init__(
+		self, input: str | Request, init: RequestInit | None = None, /
+	) -> None: ...
+
+	@property
+	def url(self) -> str: ...
+
+	@property
+	def method(self) -> str: ...
+
+	@property
+	def headers(self) -> Headers: ...
+
+	@property
+	def body(self) -> _Any: ...
+
+
+class Response:
+	"""Represents a response to a request."""
+
+	def __init__(
+		self, body: _Any | None = None, init: ResponseInit | None = None, /
+	) -> None: ...
+
+	@property
+	def status(self) -> int: ...
+
+	@property
+	def ok(self) -> bool: ...
+
+	@property
+	def headers(self) -> Headers: ...
+
+	@property
+	def body(self) -> _Any: ...
+
+	def json(self) -> _Any: ...
+
+	def text(self) -> _Any: ...
+
+	def blob(self) -> _Any: ...
+
+	def formData(self) -> _Any: ...
+
+	def arrayBuffer(self) -> _Any: ...
+
+
+def fetch(input: str | Request, init: RequestInit | None = None, /) -> _Any: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/file.py

@@ -0,0 +1,72 @@
+"""
+JavaScript File builtin.
+
+Usage:
+
+```python
+from pulse.js import File, obj
+
+@ps.javascript
+def example():
+    f = File(["hello"], "greeting.txt", obj(type="text/plain"))
+    return f.name
+```
+"""
+
+from typing import Any as _Any
+from typing import TypedDict as _TypedDict
+
+from pulse.transpiler.js_module import JsModule
+
+
+class FilePropertyBag(_TypedDict, total=False):
+	type: str
+	endings: str
+	lastModified: int
+
+
+class File:
+	"""File object backed by a Blob."""
+
+	def __init__(
+		self,
+		fileBits: list[_Any],
+		fileName: str,
+		options: FilePropertyBag | None = None,
+		/,
+	) -> None: ...
+
+	@property
+	def name(self) -> str: ...
+
+	@property
+	def lastModified(self) -> int: ...
+
+	@property
+	def webkitRelativePath(self) -> str: ...
+
+	@property
+	def size(self) -> int: ...
+
+	@property
+	def type(self) -> str: ...
+
+	def arrayBuffer(self) -> _Any: ...
+
+	def bytes(self) -> _Any: ...
+
+	def slice(
+		self,
+		start: int | None = None,
+		end: int | None = None,
+		contentType: str | None = None,
+		/,
+	) -> "File": ...
+
+	def stream(self) -> _Any: ...
+
+	def text(self) -> _Any: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/file_reader.py

@@ -0,0 +1,37 @@
+"""
+JavaScript FileReader builtin.
+
+Usage:
+
+```python
+from pulse.js import FileReader
+
+@ps.javascript
+def example(blob):
+    reader = FileReader()
+    reader.readAsText(blob)
+    return reader.result
+```
+"""
+
+from typing import Any as _Any
+
+from pulse.transpiler.js_module import JsModule
+
+
+class FileReader:
+	"""Read File/Blob contents."""
+
+	@property
+	def result(self) -> _Any: ...
+
+	@property
+	def readyState(self) -> int: ...
+
+	def readAsText(self, blob: _Any, encoding: str | None = None, /) -> None: ...
+
+	def readAsArrayBuffer(self, blob: _Any, /) -> None: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/form_data.py

@@ -0,0 +1,58 @@
+"""
+JavaScript FormData builtin.
+
+Usage:
+
+```python
+from pulse.js import FormData
+
+@ps.javascript
+def example():
+    form = FormData()
+    form.append("name", "Ada")
+    return form.get("name")
+```
+"""
+
+from collections.abc import Callable as _Callable
+from collections.abc import Iterable as _Iterable
+from typing import Any as _Any
+
+from pulse.transpiler.js_module import JsModule
+
+
+class FormData:
+	"""FormData key/value collection for multipart requests."""
+
+	def __init__(self, form: _Any | None = None, /) -> None: ...
+
+	def append(
+		self, name: str, value: _Any, filename: str | None = None, /
+	) -> None: ...
+
+	def set(self, name: str, value: _Any, filename: str | None = None, /) -> None: ...
+
+	def delete(self, name: str, /) -> None: ...
+
+	def get(self, name: str, /) -> _Any | None: ...
+
+	def getAll(self, name: str, /) -> list[_Any]: ...
+
+	def has(self, name: str, /) -> bool: ...
+
+	def entries(self) -> _Iterable[tuple[str, _Any]]: ...
+
+	def keys(self) -> _Iterable[str]: ...
+
+	def values(self) -> _Iterable[_Any]: ...
+
+	def forEach(
+		self,
+		callback: _Callable[[_Any, str, "FormData"], None],
+		thisArg: _Any | None = None,
+		/,
+	) -> None: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/intersection_observer.py

@@ -0,0 +1,79 @@
+"""
+JavaScript IntersectionObserver builtin.
+
+Usage:
+
+```python
+from pulse.js import IntersectionObserver, obj
+
+@ps.javascript
+def example(target):
+    observer = IntersectionObserver(lambda entries, obs: None, obj(threshold=0.5))
+    observer.observe(target)
+```
+"""
+
+from collections.abc import Callable as _Callable
+from typing import Any as _Any
+from typing import Protocol as _Protocol
+from typing import TypedDict as _TypedDict
+
+from pulse.js._types import Element as _Element
+from pulse.transpiler.js_module import JsModule
+
+
+class IntersectionObserverInit(_TypedDict, total=False):
+	root: _Any
+	rootMargin: str
+	scrollMargin: str
+	threshold: float | list[float]
+	delay: int
+	trackVisibility: bool
+
+
+class IntersectionObserverEntry(_Protocol):
+	@property
+	def target(self) -> _Element: ...
+
+	@property
+	def isIntersecting(self) -> bool: ...
+
+	@property
+	def intersectionRatio(self) -> float: ...
+
+
+class IntersectionObserver:
+	"""Observe element visibility within a root."""
+
+	def __init__(
+		self,
+		callback: _Callable[
+			[list[IntersectionObserverEntry], "IntersectionObserver"], None
+		],
+		options: IntersectionObserverInit | None = None,
+		/,
+	) -> None: ...
+
+	def observe(self, target: _Element, /) -> None: ...
+
+	def unobserve(self, target: _Element, /) -> None: ...
+
+	def disconnect(self) -> None: ...
+
+	def takeRecords(self) -> list[IntersectionObserverEntry]: ...
+
+	@property
+	def root(self) -> _Any: ...
+
+	@property
+	def rootMargin(self) -> str: ...
+
+	@property
+	def thresholds(self) -> list[float]: ...
+
+	@property
+	def trackVisibility(self) -> bool: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/intl.py

@@ -0,0 +1,101 @@
+"""
+JavaScript Intl namespace.
+
+Usage:
+
+```python
+from pulse.js import Intl
+
+@ps.javascript
+def example(value: float):
+    fmt = Intl.NumberFormat("en-US")
+    return fmt.format(value)
+```
+"""
+
+from typing import Any as _Any
+
+from pulse.transpiler.js_module import JsModule
+
+
+class Collator:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def compare(self, x: str, y: str, /) -> int: ...
+
+
+class DateTimeFormat:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def format(self, date: _Any = None, /) -> str: ...
+
+
+class DisplayNames:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def of(self, code: str, /) -> str | None: ...
+
+
+class ListFormat:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def format(self, items: list[str], /) -> str: ...
+
+
+class NumberFormat:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def format(self, value: _Any, /) -> str: ...
+
+
+class PluralRules:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def select(self, value: _Any, /) -> str: ...
+
+
+class RelativeTimeFormat:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def format(self, value: int, unit: str, /) -> str: ...
+
+
+class Segmenter:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def segment(self, text: str, /) -> _Any: ...
+
+
+class Locale:
+	def __init__(self, tag: str, options: _Any | None = None, /) -> None: ...
+
+	@property
+	def baseName(self) -> str: ...
+
+
+class DurationFormat:
+	def __init__(
+		self, locales: _Any | None = None, options: _Any | None = None, /
+	) -> None: ...
+
+	def format(self, value: _Any, /) -> str: ...
+
+
+# Self-register this module as a JS builtin namespace
+JsModule.register(name="Intl")

pulse/js/mutation_observer.py

@@ -0,0 +1,87 @@
+"""
+JavaScript MutationObserver builtin module.
+
+Usage:
+
+```python
+from pulse.js import MutationObserver, obj
+
+@ps.javascript
+def example(target):
+    observer = MutationObserver(lambda records, obs: None)
+    observer.observe(target, obj(childList=True))
+```
+
+# Or import from module directly:
+from pulse.js.mutation_observer import MutationObserver
+"""
+
+from collections.abc import Callable as _Callable
+from typing import Any as _Any
+from typing import Protocol as _Protocol
+from typing import TypedDict as _TypedDict
+
+from pulse.transpiler.js_module import JsModule
+
+
+class MutationObserverInit(_TypedDict, total=False):
+	"""Options for MutationObserver.observe()."""
+
+	childList: bool
+	attributes: bool
+	characterData: bool
+	subtree: bool
+	attributeOldValue: bool
+	characterDataOldValue: bool
+	attributeFilter: list[str]
+
+
+class MutationRecord(_Protocol):
+	"""Minimal MutationRecord shape for type checking."""
+
+	@property
+	def type(self) -> str: ...
+
+	@property
+	def target(self) -> _Any: ...
+
+	@property
+	def addedNodes(self) -> _Any: ...
+
+	@property
+	def removedNodes(self) -> _Any: ...
+
+	@property
+	def previousSibling(self) -> _Any: ...
+
+	@property
+	def nextSibling(self) -> _Any: ...
+
+	@property
+	def attributeName(self) -> str | None: ...
+
+	@property
+	def attributeNamespace(self) -> str | None: ...
+
+	@property
+	def oldValue(self) -> str | None: ...
+
+
+class MutationObserver:
+	"""JavaScript MutationObserver - observe DOM changes."""
+
+	def __init__(
+		self,
+		callback: _Callable[[list[MutationRecord], "MutationObserver"], _Any],
+		/,
+	) -> None: ...
+
+	def observe(self, target: _Any, options: MutationObserverInit, /) -> None: ...
+
+	def disconnect(self) -> None: ...
+
+	def takeRecords(self) -> list[MutationRecord]: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/performance_observer.py

@@ -0,0 +1,54 @@
+"""
+JavaScript PerformanceObserver builtin.
+
+Usage:
+
+```python
+from pulse.js import PerformanceObserver, obj
+
+@ps.javascript
+def example():
+    observer = PerformanceObserver(lambda list_, obs: None)
+    observer.observe(obj(entryTypes=["mark", "measure"]))
+```
+"""
+
+from collections.abc import Callable as _Callable
+from typing import Any as _Any
+from typing import Protocol as _Protocol
+from typing import TypedDict as _TypedDict
+
+from pulse.transpiler.js_module import JsModule
+
+
+class PerformanceObserverInit(_TypedDict, total=False):
+	buffered: bool
+	durationThreshold: float
+	entryTypes: list[str]
+	type: str
+
+
+class PerformanceObserverEntryList(_Protocol):
+	def getEntries(self) -> list[_Any]: ...
+
+
+class PerformanceObserver:
+	"""Observe performance entry events."""
+
+	def __init__(
+		self,
+		callback: _Callable[
+			[PerformanceObserverEntryList, "PerformanceObserver"], None
+		],
+		/,
+	) -> None: ...
+
+	def observe(self, options: PerformanceObserverInit, /) -> None: ...
+
+	def disconnect(self) -> None: ...
+
+	def takeRecords(self) -> list[_Any]: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)

pulse/js/resize_observer.py

@@ -0,0 +1,55 @@
+"""
+JavaScript ResizeObserver builtin.
+
+Usage:
+
+```python
+from pulse.js import ResizeObserver, obj
+
+@ps.javascript
+def example(target):
+    observer = ResizeObserver(lambda entries, obs: None)
+    observer.observe(target, obj(box="border-box"))
+```
+"""
+
+from collections.abc import Callable as _Callable
+from typing import Protocol as _Protocol
+from typing import TypedDict as _TypedDict
+
+from pulse.js._types import Element as _Element
+from pulse.transpiler.js_module import JsModule
+
+
+class ResizeObserverOptions(_TypedDict, total=False):
+	box: str
+
+
+class ResizeObserverEntry(_Protocol):
+	@property
+	def target(self) -> _Element: ...
+
+	@property
+	def contentRect(self) -> object: ...
+
+
+class ResizeObserver:
+	"""Observe element size changes."""
+
+	def __init__(
+		self,
+		callback: _Callable[[list[ResizeObserverEntry], "ResizeObserver"], None],
+		/,
+	) -> None: ...
+
+	def observe(
+		self, target: _Element, options: ResizeObserverOptions | None = None, /
+	) -> None: ...
+
+	def unobserve(self, target: _Element, /) -> None: ...
+
+	def disconnect(self) -> None: ...
+
+
+# Self-register this module as a JS builtin (global identifiers)
+JsModule.register(name=None)