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

pulse/dom/tags.pyi

@@ -0,0 +1,480 @@
+from typing import Any, Protocol, Unpack
+
+from pulse.dom.elements import GenericHTMLElement
+from pulse.dom.props import (
+	HTMLAnchorProps,
+	HTMLAreaProps,
+	HTMLAudioProps,
+	HTMLBaseProps,
+	HTMLBlockquoteProps,
+	HTMLButtonProps,
+	HTMLCanvasProps,
+	HTMLColgroupProps,
+	HTMLColProps,
+	HTMLDataProps,
+	HTMLDelProps,
+	HTMLDetailsProps,
+	HTMLDialogProps,
+	HTMLEmbedProps,
+	HTMLFieldsetProps,
+	HTMLFormProps,
+	HTMLHtmlProps,
+	HTMLIframeProps,
+	HTMLImgProps,
+	HTMLInputProps,
+	HTMLInsProps,
+	HTMLLabelProps,
+	HTMLLinkProps,
+	HTMLLiProps,
+	HTMLMapProps,
+	HTMLMenuProps,
+	HTMLMetaProps,
+	HTMLMeterProps,
+	HTMLObjectProps,
+	HTMLOlProps,
+	HTMLOptgroupProps,
+	HTMLOptionProps,
+	HTMLOutputProps,
+	HTMLParamProps,
+	HTMLProgressProps,
+	HTMLProps,
+	HTMLQuoteProps,
+	HTMLScriptProps,
+	HTMLSelectProps,
+	HTMLSourceProps,
+	HTMLStyleProps,
+	HTMLSVGProps,
+	HTMLTableProps,
+	HTMLTdProps,
+	HTMLTextareaProps,
+	HTMLThProps,
+	HTMLTimeProps,
+	HTMLTrackProps,
+	HTMLVideoProps,
+)
+from pulse.transpiler.nodes import Element, Node
+
+class Tag(Protocol):
+	def __call__(self, *children: Node, **props: Any) -> Element: ...
+
+def define_tag(
+	name: str,
+	default_props: dict[str, Any] | None = None,
+) -> Tag: ...
+def define_self_closing_tag(
+	name: str,
+	default_props: dict[str, Any] | None = None,
+) -> Tag: ...
+
+# --- Self-closing tags ----
+def area(*, key: str | None = None, **props: Unpack[HTMLAreaProps]) -> Element: ...
+def base(*, key: str | None = None, **props: Unpack[HTMLBaseProps]) -> Element: ...
+def br(*, key: str | None = None, **props: Unpack[HTMLProps]) -> Element: ...
+def col(*, key: str | None = None, **props: Unpack[HTMLColProps]) -> Element: ...
+def embed(*, key: str | None = None, **props: Unpack[HTMLEmbedProps]) -> Element: ...
+def hr(*, key: str | None = None, **props: Unpack[HTMLProps]) -> Element: ...
+def img(*, key: str | None = None, **props: Unpack[HTMLImgProps]) -> Element: ...
+def input(*, key: str | None = None, **props: Unpack[HTMLInputProps]) -> Element: ...
+def link(*, key: str | None = None, **props: Unpack[HTMLLinkProps]) -> Element: ...
+def meta(*, key: str | None = None, **props: Unpack[HTMLMetaProps]) -> Element: ...
+def param(*, key: str | None = None, **props: Unpack[HTMLParamProps]) -> Element: ...
+def source(*, key: str | None = None, **props: Unpack[HTMLSourceProps]) -> Element: ...
+def track(*, key: str | None = None, **props: Unpack[HTMLTrackProps]) -> Element: ...
+def wbr(*, key: str | None = None, **props: Unpack[HTMLProps]) -> Element: ...
+
+# --- Regular tags ---
+
+def a(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLAnchorProps]
+) -> Element: ...
+def abbr(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def address(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def article(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def aside(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def audio(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLAudioProps]
+) -> Element: ...
+def b(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def bdi(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def bdo(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def blockquote(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLBlockquoteProps],
+) -> Element: ...
+def body(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def button(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLButtonProps]
+) -> Element: ...
+def canvas(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLCanvasProps]
+) -> Element: ...
+def caption(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def cite(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def code(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def colgroup(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLColgroupProps],
+) -> Element: ...
+def data(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLDataProps]
+) -> Element: ...
+def datalist(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def dd(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def del_(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLDelProps]
+) -> Element: ...
+def details(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLDetailsProps],
+) -> Element: ...
+def dfn(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def dialog(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLDialogProps]
+) -> Element: ...
+def div(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def dl(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def dt(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def em(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def fieldset(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLFieldsetProps],
+) -> Element: ...
+def figcaption(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def figure(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def footer(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def form(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLFormProps]
+) -> Element: ...
+def h1(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def h2(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def h3(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def h4(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def h5(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def h6(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def head(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def header(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def hgroup(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def html(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLHtmlProps]
+) -> Element: ...
+def i(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def iframe(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLIframeProps]
+) -> Element: ...
+def ins(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLInsProps]
+) -> Element: ...
+def kbd(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def label(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLLabelProps]
+) -> Element: ...
+def legend(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def li(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLLiProps]
+) -> Element: ...
+def main(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def map_(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLMapProps]
+) -> Element: ...
+def mark(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def menu(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLMenuProps]
+) -> Element: ...
+def meter(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLMeterProps]
+) -> Element: ...
+def nav(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def noscript(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def object_(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLObjectProps]
+) -> Element: ...
+def ol(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLOlProps]
+) -> Element: ...
+def optgroup(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLOptgroupProps],
+) -> Element: ...
+def option(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLOptionProps]
+) -> Element: ...
+def output(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLOutputProps]
+) -> Element: ...
+def p(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def picture(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def pre(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def progress(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLProgressProps],
+) -> Element: ...
+def q(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLQuoteProps]
+) -> Element: ...
+def rp(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def rt(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def ruby(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def s(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def samp(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def script(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLScriptProps]
+) -> Element: ...
+def section(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def select(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLSelectProps]
+) -> Element: ...
+def small(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def span(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def strong(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def style(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLStyleProps]
+) -> Element: ...
+def sub(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def summary(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def sup(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def table(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLTableProps]
+) -> Element: ...
+def tbody(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def td(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLTdProps]
+) -> Element: ...
+def template(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def textarea(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLTextareaProps],
+) -> Element: ...
+def tfoot(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def th(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLThProps]
+) -> Element: ...
+def thead(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def time(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLTimeProps]
+) -> Element: ...
+def title(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def tr(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def u(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def ul(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def var(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLProps]
+) -> Element: ...
+def video(
+	*children: Node, key: str | None = None, **props: Unpack[HTMLVideoProps]
+) -> Element: ...
+
+# -- React Fragment ---
+def fragment(*children: Node, key: str | None = None) -> Element: ...
+
+# -- SVG --
+def svg(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def circle(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def ellipse(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def g(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def line(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def path(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def polygon(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def polyline(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def rect(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def text(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def tspan(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def defs(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def clipPath(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def mask(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def pattern(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+def use(
+	*children: Node,
+	key: str | None = None,
+	**props: Unpack[HTMLSVGProps[GenericHTMLElement]],
+) -> Element: ...
+
+# Lists exported for JS transpiler
+TAGS: list[tuple[str, dict[str, Any] | None]]
+SELF_CLOSING_TAGS: list[tuple[str, dict[str, Any] | None]]

pulse/form.py

@@ -15,16 +15,17 @@ from starlette.datastructures import FormData as StarletteFormData
 from starlette.datastructures import UploadFile
 
 from pulse.context import PulseContext
+from pulse.dom.props import HTMLFormProps
 from pulse.helpers import Disposable, call_flexible, maybe_await
 from pulse.hooks.core import HOOK_CONTEXT, HookMetadata, HookState, hooks
 from pulse.hooks.runtime import server_address
 from pulse.hooks.stable import stable
-from pulse.html.props import HTMLFormProps
 from pulse.react_component import react_component
 from pulse.reactive import Signal
 from pulse.serializer import deserialize
+from pulse.transpiler.imports import Import
+from pulse.transpiler.nodes import Node
 from pulse.types.event_handler import EventHandler1
-from pulse.vdom import Child
 
 if TYPE_CHECKING:
 	from pulse.render_session import RenderSession
@@ -45,9 +46,9 @@ FormValue = str | UploadFile
 FormData = dict[str, FormValue | list[FormValue]]
 
 
-@react_component("PulseForm", "pulse-ui-client")
+@react_component(Import("PulseForm", "pulse-ui-client"))
 def client_form_component(
-	*children: Child,
+	*children: Node,
 	key: str | None = None,
 	**props: Unpack[HTMLFormProps],
 ): ...
@@ -169,7 +170,7 @@ class PulseFormProps(HTMLFormProps, total=False):
 
 
 def Form(
-	*children: Child,
+	*children: Node,
 	key: str,
 	onSubmit: EventHandler1[FormData] | None = None,
 	**props: Unpack[PulseFormProps],  # pyright: ignore[reportGeneralTypeIssues]
@@ -259,7 +260,7 @@ class ManualForm(Disposable):
 
 	def __call__(
 		self,
-		*children: Child,
+		*children: Node,
 		key: str | None = None,
 		**props: Unpack[PulseFormProps],
 	):

pulse/hooks/init.py

@@ -311,7 +311,7 @@ def _collect_assigned_names(body: list[ast.stmt]) -> list[str]:
 def rewrite_init_blocks(func: Callable[..., Any]) -> Callable[..., Any]:
 	"""Rewrite `with ps.init()` blocks in the provided function, if present."""
 
-	source = _get_source(func)  # raises immediately if missing
+	source = textwrap.dedent(getsourcecode(func))  # raises immediately if missing
 
 	if "init" not in source:  # quick prefilter, allow alias detection later
 		return func
@@ -418,18 +418,6 @@ class _InitCallChecker:
 		return False
 
 
-def _get_source(func: Callable[..., Any]) -> str:
-	try:
-		return textwrap.dedent(getsourcecode(func))
-	except OSError as exc:
-		src = getattr(func, "__source__", None)
-		if src is None:
-			raise RuntimeError(
-				f"ps.init rewrite failed: unable to read source ({exc})"
-			) from exc
-		return textwrap.dedent(src)
-
-
 def _resolve_init_bindings(func: Callable[..., Any]) -> tuple[set[str], set[str]]:
 	"""Find names/modules that resolve to pulse.init in the function scope."""
 

pulse/js/__init__.py

@@ -1,51 +1,40 @@
-"""JavaScript module bindings for use in @javascript decorated functions.
+"""JavaScript module bindings for use in @javascript decorated functions (transpiler).
 
 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)
+    # Import JS classes (for constructors and static methods):
+    from pulse.js import Set, Number, Array, Date, Promise, Map, Error
+    Set([1, 2, 3])         # -> new Set([1, 2, 3])
+    Number.isFinite(42)    # -> Number.isFinite(42)
+    Array.isArray(x)       # -> Array.isArray(x)
+
+    # Import JS namespace objects (function-only modules):
+    from pulse.js import Math, JSON, console, window, document, navigator
+    Math.floor(3.7)        # -> Math.floor(3.7)
+    JSON.stringify(obj)    # -> JSON.stringify(obj)
+    console.log("hi")      # -> console.log("hi")
+
+    # Alternative: import namespace modules for namespace access:
+    import pulse.js.json as JSON
+    JSON.stringify(obj)    # -> JSON.stringify(obj)
 
     # 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)
+    # Object literals (plain JS objects instead of Map):
+    from pulse.js import obj
+    obj(a=1, b=2)          # -> { a: 1, b: 2 }
 """
 
 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
+from pulse.transpiler.builtins import obj as obj
+from pulse.transpiler.nodes import UNDEFINED as _UNDEFINED
+from pulse.transpiler.nodes import Identifier as _Identifier
+
+# Namespace modules that resolve to Identifier
 _MODULE_EXPORTS_IDENTIFIER: dict[str, str] = {
 	"JSON": "pulse.js.json",
 	"Math": "pulse.js.math",
@@ -73,14 +62,21 @@ _MODULE_EXPORTS_ATTRIBUTE: dict[str, str] = {
 
 
 # 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]
+# Note: throw needs special handling in the transpiler to convert from expression to statement
+class _ThrowExpr:
+	"""Wrapper for throw that can be detected and converted to a statement."""
+
+	def __call__(self, x: _Any) -> _NoReturn:
+		# This will be replaced during transpilation
+		# The transpiler should detect this and emit as a Throw statement
+		raise RuntimeError("throw() can only be used in @javascript functions")
+
+
+throw = _ThrowExpr()
 
 
 # JS primitive values
-undefined = _JSUndefined()
+undefined = _UNDEFINED
 
 
 # Cache for exported values
@@ -99,7 +95,7 @@ def __getattr__(name: str) -> _Any:
 	# Check which dict contains the name
 	if name in _MODULE_EXPORTS_IDENTIFIER:
 		module = _importlib.import_module(_MODULE_EXPORTS_IDENTIFIER[name])
-		export = _JSIdentifier(name)
+		export = _Identifier(name)
 	elif name in _MODULE_EXPORTS_ATTRIBUTE:
 		module = _importlib.import_module(_MODULE_EXPORTS_ATTRIBUTE[name])
 		export = getattr(module, name)