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

pulse/hooks/core.py

@@ -88,7 +88,7 @@ DEFAULT_HOOK_KEY = object()
 
 
 class HookNamespace(Generic[T]):
-	__slots__: tuple[str, ...] = ("hook", "states")
+	__slots__ = ("hook", "states")  # pyright: ignore[reportUnannotatedClassAttribute]
 	hook: Hook[T]
 
 	def __init__(self, hook: Hook[T]) -> None:
@@ -265,7 +265,7 @@ HOOK_REGISTRY: HookRegistry = HookRegistry()
 
 
 class HooksAPI:
-	__slots__: tuple[()] = ()
+	__slots__ = ()  # pyright: ignore[reportUnannotatedClassAttribute]
 
 	State: type[HookState] = HookState
 	Metadata: type[HookMetadata] = HookMetadata

pulse/hooks/effects.py

@@ -6,7 +6,7 @@ from pulse.reactive import Effect, EffectFn, Untrack
 
 
 class EffectsHookState(HookState):
-	__slots__: tuple[str, ...] = ("initialized", "effects", "key", "_called")
+	__slots__ = ("initialized", "effects", "key", "_called")  # pyright: ignore[reportUnannotatedClassAttribute]
 	initialized: bool
 	_called: bool
 

pulse/hooks/init.py

@@ -9,6 +9,7 @@ import types
 from collections.abc import Callable, Sequence
 from typing import Any, Literal, cast, override
 
+from pulse.helpers import getsourcecode
 from pulse.hooks.core import HookState, hooks
 
 # Storage keyed by (code object, lineno) of the `with ps.init()` call site.
@@ -419,7 +420,7 @@ class _InitCallChecker:
 
 def _get_source(func: Callable[..., Any]) -> str:
 	try:
-		return textwrap.dedent(inspect.getsource(func))
+		return textwrap.dedent(getsourcecode(func))
 	except OSError as exc:
 		src = getattr(func, "__source__", None)
 		if src is None:

pulse/hooks/setup.py

@@ -11,7 +11,7 @@ T = TypeVar("T")
 
 
 class SetupHookState(HookState):
-	__slots__: tuple[str, ...] = (
+	__slots__ = (  # pyright: ignore[reportUnannotatedClassAttribute]
 		"value",
 		"initialized",
 		"args",

pulse/hooks/stable.py

@@ -8,7 +8,7 @@ TCallable = TypeVar("TCallable", bound=Callable[..., Any])
 
 
 class StableEntry:
-	__slots__: tuple[str, ...] = ("value", "wrapper")
+	__slots__ = ("value", "wrapper")  # pyright: ignore[reportUnannotatedClassAttribute]
 	value: Any
 	wrapper: Callable[..., Any]
 
@@ -25,7 +25,7 @@ class StableEntry:
 
 
 class StableRegistry(HookState):
-	__slots__: tuple[str, ...] = ("entries",)
+	__slots__ = ("entries",)  # pyright: ignore[reportUnannotatedClassAttribute]
 
 	def __init__(self) -> None:
 		super().__init__()

pulse/hooks/states.py

@@ -18,7 +18,7 @@ S10 = TypeVar("S10", bound=State)
 
 
 class StateNamespace:
-	__slots__: tuple[str, ...] = ("states", "key", "called")
+	__slots__ = ("states", "key", "called")  # pyright: ignore[reportUnannotatedClassAttribute]
 	states: tuple[State, ...]
 	key: str | None
 	called: bool
@@ -84,7 +84,7 @@ class StateNamespace:
 
 
 class StatesHookState(HookState):
-	__slots__: tuple[str, ...] = ("namespaces",)
+	__slots__ = ("namespaces",)  # pyright: ignore[reportUnannotatedClassAttribute]
 	namespaces: dict[str | None, StateNamespace]
 
 	def __init__(self) -> None:

pulse/html/props.py

@@ -2,7 +2,6 @@
 # NOT the same thing as the properties in `elements.py` (but very similar)
 from typing import Any, Literal, TypedDict
 
-from pulse.css import CssReference
 from pulse.helpers import CSSProperties
 from pulse.html.elements import (
 	GenericHTMLElement,
@@ -69,10 +68,12 @@ from pulse.html.events import (
 	TElement,
 	TextAreaDOMEvents,
 )
+from pulse.transpiler.nodes import JSExpr
 
 Booleanish = Literal[True, False, "true", "false"]
 CrossOrigin = Literal["anonymous", "use-credentials", ""] | None
-ClassName = str | CssReference
+# ClassName can be a string or any JSExpr (e.g., JSMember from CssModule.classname)
+ClassName = str | JSExpr
 
 
 class BaseHTMLProps(TypedDict, total=False):

pulse/html/tags.py

@@ -191,3 +191,138 @@ clipPath = define_tag("clipPath")
 mask = define_tag("mask")
 pattern = define_tag("pattern")
 use = define_tag("use")
+
+# Lists of tag names/default props (referenced by JS transpiler builtins)
+TAGS = [
+	("a", None),
+	("abbr", None),
+	("address", None),
+	("article", None),
+	("aside", None),
+	("audio", None),
+	("b", None),
+	("bdi", None),
+	("bdo", None),
+	("blockquote", None),
+	("body", None),
+	("button", None),
+	("canvas", None),
+	("caption", None),
+	("cite", None),
+	("code", None),
+	("colgroup", None),
+	("data", None),
+	("datalist", None),
+	("dd", None),
+	("del", None),
+	("details", None),
+	("dfn", None),
+	("dialog", None),
+	("div", None),
+	("dl", None),
+	("dt", None),
+	("em", None),
+	("fieldset", None),
+	("figcaption", None),
+	("figure", None),
+	("footer", None),
+	("form", {"method": "POST"}),
+	("h1", None),
+	("h2", None),
+	("h3", None),
+	("h4", None),
+	("h5", None),
+	("h6", None),
+	("head", None),
+	("header", None),
+	("hgroup", None),
+	("html", None),
+	("i", None),
+	("iframe", None),
+	("ins", None),
+	("kbd", None),
+	("label", None),
+	("legend", None),
+	("li", None),
+	("main", None),
+	("map", None),
+	("mark", None),
+	("menu", None),
+	("meter", None),
+	("nav", None),
+	("noscript", None),
+	("object", None),
+	("ol", None),
+	("optgroup", None),
+	("option", None),
+	("output", None),
+	("p", None),
+	("picture", None),
+	("pre", None),
+	("progress", None),
+	("q", None),
+	("rp", None),
+	("rt", None),
+	("ruby", None),
+	("s", None),
+	("samp", None),
+	("script", {"type": "text/javascript"}),
+	("section", None),
+	("select", None),
+	("small", None),
+	("span", None),
+	("strong", None),
+	("style", {"type": "text/css"}),
+	("sub", None),
+	("summary", None),
+	("sup", None),
+	("table", None),
+	("tbody", None),
+	("td", None),
+	("template", None),
+	("textarea", None),
+	("tfoot", None),
+	("th", None),
+	("thead", None),
+	("time", None),
+	("title", None),
+	("tr", None),
+	("u", None),
+	("ul", None),
+	("var", None),
+	("video", None),
+	# SVG tags
+	("svg", None),
+	("circle", None),
+	("ellipse", None),
+	("g", None),
+	("line", None),
+	("path", None),
+	("polygon", None),
+	("polyline", None),
+	("rect", None),
+	("text", None),
+	("tspan", None),
+	("defs", None),
+	("clipPath", None),
+	("mask", None),
+	("pattern", None),
+	("use", None),
+]
+
+SELF_CLOSING_TAGS = [
+	("area", None),
+	("base", None),
+	("br", None),
+	("col", None),
+	("embed", None),
+	("hr", None),
+	("img", None),
+	("input", None),
+	("link", None),
+	("meta", None),
+	("param", None),
+	("source", None),
+	("track", None),
+	("wbr", None),
+]

pulse/html/tags.pyi

@@ -464,3 +464,7 @@ def use(
 	key: str | None = None,
 	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
 ) -> Node: ...
+
+# Lists exported for JS transpiler
+TAGS: list[tuple[str, dict[str, Any] | None]]
+SELF_CLOSING_TAGS: list[tuple[str, dict[str, Any] | None]]

pulse/js/__init__.py

@@ -0,0 +1,110 @@
+"""JavaScript module bindings for use in @javascript decorated functions.
+
+Usage:
+    # For builtins (no import needed in JS):
+    import pulse.js.math as Math
+    Math.PI  # -> Math.PI
+
+    from pulse.js.math import floor
+    floor(x)  # -> Math.floor(x)
+
+    # Direct import of builtins from pulse.js:
+    from pulse.js import Set, Number, Array, Math, Date, Promise
+    Set([1, 2, 3])  # -> new Set([1, 2, 3])
+    Number.isFinite(42)  # -> Number.isFinite(42)
+
+    # Statement functions:
+    from pulse.js import throw
+    throw(Error("message"))  # -> throw Error("message");
+
+    # For external modules:
+    from pulse.js.lodash import chunk
+    chunk(arr, 2)  # -> import { chunk } from "lodash"; chunk(arr, 2)
+
+    import pulse.js.lodash as _
+    _.debounce(fn, 100)  # -> import _ from "lodash"; _.debounce(fn, 100)
+"""
+
+import importlib as _importlib
+from typing import Any as _Any
+from typing import NoReturn as _NoReturn
+
+from pulse.transpiler.nodes import (
+	JSIdentifier as _JSIdentifier,
+)
+from pulse.transpiler.nodes import (
+	JSStmtExpr as _JSStmtExpr,
+)
+from pulse.transpiler.nodes import (
+	JSThrow as _JSThrow,
+)
+from pulse.transpiler.nodes import (
+	JSUndefined as _JSUndefined,
+)
+from pulse.transpiler.nodes import (
+	js_transformer as _js_transformer,
+)
+
+# Namespace modules that resolve to JSIdentifier
+_MODULE_EXPORTS_IDENTIFIER: dict[str, str] = {
+	"JSON": "pulse.js.json",
+	"Math": "pulse.js.math",
+	"console": "pulse.js.console",
+	"window": "pulse.js.window",
+	"document": "pulse.js.document",
+	"navigator": "pulse.js.navigator",
+}
+
+# Regular modules that resolve via getattr
+_MODULE_EXPORTS_ATTRIBUTE: dict[str, str] = {
+	"Array": "pulse.js.array",
+	"Date": "pulse.js.date",
+	"Error": "pulse.js.error",
+	"Map": "pulse.js.map",
+	"Object": "pulse.js.object",
+	"Promise": "pulse.js.promise",
+	"RegExp": "pulse.js.regexp",
+	"Set": "pulse.js.set",
+	"String": "pulse.js.string",
+	"WeakMap": "pulse.js.weakmap",
+	"WeakSet": "pulse.js.weakset",
+	"Number": "pulse.js.number",
+}
+
+
+# Statement-like functions (not classes/objects, but callable transformers)
+@_js_transformer("throw")
+def throw(x: _Any) -> _NoReturn:
+	# x is typed as _Any for users, but at transpile time it's JSExpr
+	return _JSStmtExpr(_JSThrow(x), name="throw")  # pyright: ignore[reportGeneralTypeIssues]
+
+
+# JS primitive values
+undefined = _JSUndefined()
+
+
+# Cache for exported values
+_export_cache: dict[str, _Any] = {}
+
+
+def __getattr__(name: str) -> _Any:
+	"""Lazily import and return JS builtin modules.
+
+	Allows: from pulse.js import Set, Number, Array, etc.
+	"""
+	# Return cached export if already imported
+	if name in _export_cache:
+		return _export_cache[name]
+
+	# Check which dict contains the name
+	if name in _MODULE_EXPORTS_IDENTIFIER:
+		module = _importlib.import_module(_MODULE_EXPORTS_IDENTIFIER[name])
+		export = _JSIdentifier(name)
+	elif name in _MODULE_EXPORTS_ATTRIBUTE:
+		module = _importlib.import_module(_MODULE_EXPORTS_ATTRIBUTE[name])
+		export = getattr(module, name)
+	else:
+		raise AttributeError(f"module 'pulse.js' has no attribute '{name}'")
+
+	_export_cache[name] = export
+	return export

pulse/js/__init__.pyi

@@ -0,0 +1,95 @@
+"""Type stubs for pulse.js module exports.
+
+This file provides type hints for direct imports from pulse.js:
+    from pulse.js import Set, Number, Array, Math, Date, Promise, etc.
+"""
+
+from typing import Any as _Any
+from typing import NoReturn as _NoReturn
+
+import pulse.js.console
+import pulse.js.document
+import pulse.js.json
+import pulse.js.math
+import pulse.js.navigator
+import pulse.js.window
+
+# Re-export type definitions for use in user code
+from pulse.js._types import (
+	Clipboard as Clipboard,
+)
+from pulse.js._types import (
+	ClipboardItem as ClipboardItem,
+)
+from pulse.js._types import (
+	CSSStyleDeclaration as CSSStyleDeclaration,
+)
+from pulse.js._types import (
+	Element as Element,
+)
+from pulse.js._types import (
+	Event as Event,
+)
+from pulse.js._types import (
+	HTMLCollection as HTMLCollection,
+)
+from pulse.js._types import (
+	HTMLElement as HTMLElement,
+)
+from pulse.js._types import (
+	JSIterable as JSIterable,
+)
+from pulse.js._types import (
+	JSIterator as JSIterator,
+)
+from pulse.js._types import (
+	JSIteratorResult as JSIteratorResult,
+)
+from pulse.js._types import (
+	NodeList as NodeList,
+)
+from pulse.js._types import (
+	Range as Range,
+)
+from pulse.js._types import (
+	Selection as Selection,
+)
+
+# Re-export classes with proper generic types
+from pulse.js.array import Array as Array
+from pulse.js.date import Date as Date
+from pulse.js.error import Error as Error
+from pulse.js.error import EvalError as EvalError
+from pulse.js.error import RangeError as RangeError
+from pulse.js.error import ReferenceError as ReferenceError
+from pulse.js.error import SyntaxError as SyntaxError
+from pulse.js.error import TypeError as TypeError
+from pulse.js.error import URIError as URIError
+from pulse.js.map import Map as Map
+from pulse.js.number import Number as Number
+from pulse.js.object import Object as Object
+from pulse.js.object import PropertyDescriptor as PropertyDescriptor
+from pulse.js.promise import Promise as Promise
+from pulse.js.promise import PromiseWithResolvers as PromiseWithResolvers
+from pulse.js.regexp import RegExp as RegExp
+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
+
+# Re-export namespace modules
+console = pulse.js.console
+document = pulse.js.document
+JSON = pulse.js.json
+Math = pulse.js.math
+navigator = pulse.js.navigator
+window = pulse.js.window
+
+# Statement-like functions
+def throw(x: _Any) -> _NoReturn:
+	"""Throw a JavaScript error."""
+	...
+
+# Primitive values
+undefined: JSUndefined