pulse-framework 0.1.71__tar.gz → 0.1.73__tar.gz

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/PKG-INFO

@@ -1,21 +1,21 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.71
+Version: 0.1.73
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
-Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.128.0
 Requires-Dist: uvicorn>=0.24.0
 Requires-Dist: mako>=1.3.10
 Requires-Dist: typer>=0.16.0
 Requires-Dist: python-socketio>=5.16.0
 Requires-Dist: rich>=13.7.1
-Requires-Dist: python-multipart>=0.0.20
+Requires-Dist: python-multipart>=0.0.22
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: starlette>=0.50.0,<0.51.0
 Requires-Dist: urllib3>=2.6.3
 Requires-Dist: watchfiles>=1.1.0
 Requires-Dist: httpx>=0.28.1
-Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.12.0
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 
 # Pulse Python

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/pyproject.toml

@@ -1,23 +1,23 @@
 [project]
 name = "pulse-framework"
-version = "0.1.71"
+version = "0.1.73"
 description = "Pulse - Full-stack framework for building real-time React applications in Python"
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 dependencies = [
-    "websockets>=12.0",
     "fastapi>=0.128.0",
     "uvicorn>=0.24.0",
     "mako>=1.3.10",
     "typer>=0.16.0",
     "python-socketio>=5.16.0",
     "rich>=13.7.1",
-    "python-multipart>=0.0.20",
+    "python-multipart>=0.0.22",
     "python-dateutil>=2.9.0.post0",
     "starlette>=0.50.0,<0.51.0",
     "urllib3>=2.6.3",
     "watchfiles>=1.1.0",
     "httpx>=0.28.1",
+    "aiohttp>=3.12.0",
 ]
 
 [tool.uv]

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/__init__.py

@@ -60,6 +60,14 @@ from pulse.context import PulseContext as PulseContext
 from pulse.cookies import Cookie as Cookie
 from pulse.cookies import SetCookie as SetCookie
 
+# Debounce
+from pulse.debounce import (
+	Debounced as Debounced,
+)
+from pulse.debounce import (
+	debounced as debounced,
+)
+
 # Decorators
 from pulse.decorators import computed as computed
 from pulse.decorators import effect as effect
@@ -1200,7 +1208,7 @@ from pulse.hooks.core import (
 )
 
 # Hooks - Effects (import to register inline_effect_hook before registry locks)
-from pulse.hooks.effects import InlineEffectHookState as InlineEffectHookState
+from pulse.hooks.effects import EffectState as EffectState
 
 # Hooks - Init
 from pulse.hooks.init import (
@@ -1235,6 +1243,9 @@ from pulse.hooks.runtime import (
 from pulse.hooks.runtime import (
 	not_found as not_found,
 )
+from pulse.hooks.runtime import (
+	pulse_route as pulse_route,
+)
 from pulse.hooks.runtime import (
 	redirect as redirect,
 )
@@ -1259,7 +1270,7 @@ from pulse.hooks.runtime import (
 
 # Hooks - Setup
 from pulse.hooks.setup import (
-	SetupHookState as SetupHookState,
+	SetupState as SetupState,
 )
 from pulse.hooks.setup import (
 	setup as setup,
@@ -1271,7 +1282,7 @@ from pulse.hooks.stable import (
 	StableEntry as StableEntry,
 )
 from pulse.hooks.stable import (
-	StableRegistry as StableRegistry,
+	StableState as StableState,
 )
 
 # Hooks - Stable
@@ -1322,6 +1333,9 @@ from pulse.middleware import (
 
 # Plugin
 from pulse.plugin import Plugin as Plugin
+
+# Proxy
+from pulse.proxy import ProxyConfig as ProxyConfig
 from pulse.queries.client import QueryClient as QueryClient
 from pulse.queries.client import QueryFilter as QueryFilter
 from pulse.queries.client import queries as queries
@@ -1430,7 +1444,8 @@ from pulse.serializer import deserialize as deserialize
 from pulse.serializer import serialize as serialize
 
 # State and routing
-from pulse.state import State as State
+from pulse.state.query_param import QueryParam as QueryParam
+from pulse.state.state import State as State
 
 # Transpiler v2
 from pulse.transpiler.function import JsFunction as JsFunction

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/app.py

@@ -67,7 +67,7 @@ from pulse.middleware import (
 	Redirect,
 )
 from pulse.plugin import Plugin
-from pulse.proxy import ReactProxy
+from pulse.proxy import ProxyConfig, ReactProxy
 from pulse.render_session import RenderSession
 from pulse.request import PulseRequest
 from pulse.routing import Layout, Route, RouteTree, ensure_absolute_path
@@ -211,6 +211,7 @@ class App:
 	_tasks: TaskRegistry
 	_timers: TimerRegistry
 	_proxy: ReactProxy | None
+	proxy_config: ProxyConfig | None
 	session_timeout: float
 	connection_status: ConnectionStatusConfig
 	render_loop_limit: int
@@ -232,6 +233,7 @@ class App:
 		not_found: str = "/not-found",
 		# Deployment and integration options
 		mode: PulseMode = "single-server",
+		proxy: ProxyConfig | None = None,
 		api_prefix: str = "/_pulse",
 		cors: CORSOptions | None = None,
 		fastapi: dict[str, Any] | None = None,
@@ -245,6 +247,7 @@ class App:
 		# Resolve mode from environment and expose on the app instance
 		self.env = envvars.pulse_env
 		self.mode = mode
+		self.proxy_config = proxy
 		self.status = AppStatus.created
 		# Persist the server address for use by sessions (API calls, etc.) in ci/prod.
 		self.server_address = server_address if self.env in ("ci", "prod") else None
@@ -506,15 +509,22 @@ class App:
 			)
 			render_id = request.headers.get("x-pulse-render-id")
 			render = self._get_render_for_session(render_id, session)
-			with PulseContext.update(session=session, render=render):
-				res: Response = await call_next(request)
-			session.handle_response(res)
-
-			self._sessions_in_request[session.sid] -= 1
-			if self._sessions_in_request[session.sid] == 0:
-				del self._sessions_in_request[session.sid]
-
-			return res
+			try:
+				with PulseContext.update(session=session, render=render):
+					res: Response = await call_next(request)
+				session.handle_response(res)
+				return res
+			except RuntimeError as exc:
+				# Client disconnected before response was sent. This happens when
+				# ASGI handlers (like the proxy) return early on disconnect without
+				# sending a response, which is valid ASGI but breaks BaseHTTPMiddleware.
+				if "No response returned" in str(exc):
+					return Response(status_code=499)
+				raise
+			finally:
+				self._sessions_in_request[session.sid] -= 1
+				if self._sessions_in_request[session.sid] == 0:
+					del self._sessions_in_request[session.sid]
 
 		# Apply prefix to all routes
 		prefix = self.api_prefix
@@ -654,10 +664,8 @@ class App:
 		for plugin in self.plugins:
 			plugin.on_setup(self)
 
-		# In single-server mode, add catch-all route to proxy unmatched requests to React server
-		# This route must be registered last so FastAPI tries all specific routes first
-		# FastAPI will match specific routes before this catch-all, but we add an explicit check
-		# as a safety measure to ensure API routes are never proxied
+		# In single-server mode, add catch-all route to proxy unmatched requests to React server.
+		# This route must be registered last so FastAPI tries all specific routes first.
 		if self.mode == "single-server":
 			react_server_address = envvars.react_server_address
 			if not react_server_address:
@@ -666,11 +674,12 @@ class App:
 					+ "Use 'pulse run' CLI command or set the environment variable."
 				)
 
-			self._proxy = ReactProxy(
+			proxy_handler = ReactProxy(
 				react_server_address=react_server_address,
 				server_address=server_address,
+				config=self.proxy_config,
 			)
-			proxy_handler = self._proxy
+			self._proxy = proxy_handler
 
 			# In dev mode, proxy WebSocket connections to React Router (e.g. Vite HMR)
 			# Socket.IO handles /socket.io/ at ASGI level before reaching FastAPI
@@ -680,14 +689,8 @@ class App:
 				async def websocket_proxy(websocket: WebSocket, path: str):  # pyright: ignore[reportUnusedFunction]
 					await proxy_handler.proxy_websocket(websocket)
 
-			@self.fastapi.api_route(
-				"/{path:path}",
-				methods=["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
-				include_in_schema=False,
-			)
-			async def proxy_catch_all(request: Request, path: str):  # pyright: ignore[reportUnusedFunction]
-				# Proxy all unmatched HTTP requests to React Router
-				return await proxy_handler(request)
+			# Register ASGI-level catch-all last.
+			self.fastapi.mount("/", proxy_handler, name="react-proxy")
 
 		@self.sio.event
 		async def connect(  # pyright: ignore[reportUnusedFunction]

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/cli/cmd.py

@@ -233,7 +233,7 @@ def run(
 		)
 		commands.append(server_cmd)
 
-	with FolderLock(web_root):
+	with FolderLock(web_root, address=address, port=port):
 		try:
 			exit_code = execute_commands(
 				commands,

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/cli/folder_lock.py

@@ -52,7 +52,7 @@ def _write_gitignore_for_lock(lock_path: Path) -> None:
 	ensure_gitignore_has(lock_path.parent, lock_path.name)
 
 
-def _create_lock_file(lock_path: Path) -> None:
+def _create_lock_file(lock_path: Path, *, address: str, port: int) -> None:
 	"""Create a lock file with current process information."""
 	lock_path = Path(lock_path)
 	_write_gitignore_for_lock(lock_path)
@@ -61,18 +61,26 @@ def _create_lock_file(lock_path: Path) -> None:
 		info = _read_lock(lock_path) or {}
 		pid = int(info.get("pid", 0) or 0)
 		if pid and is_process_alive(pid):
+			existing_addr = info.get("address", address)
+			existing_port = info.get("port", port)
+			protocol = (
+				"http" if existing_addr in ("127.0.0.1", "localhost") else "https"
+			)
+			url = f"{protocol}://{existing_addr}:{existing_port}"
 			raise RuntimeError(
-				f"Another Pulse dev instance appears to be running (pid={pid}) for {lock_path.parent}."
+				f"Another Pulse dev instance is running at {url} (pid={pid})"
 			)
 		# Stale lock; continue to overwrite
 
-	payload = {
+	payload: dict[str, Any] = {
 		"pid": os.getpid(),
 		"created_at": int(time.time()),
 		"hostname": socket.gethostname(),
 		"platform": platform.platform(),
 		"python": platform.python_version(),
 		"cwd": os.getcwd(),
+		"address": address,
+		"port": port,
 	}
 	try:
 		lock_path.parent.mkdir(parents=True, exist_ok=True)
@@ -105,23 +113,34 @@ class FolderLock:
 	and know not to delete the lock on exit.
 
 	Example:
-	    with FolderLock(web_root):
+	    with FolderLock(web_root, address="localhost", port=8000):
 	        # Protected region
 	        pass
 	"""
 
-	def __init__(self, web_root: Path, *, filename: str = ".pulse/lock"):
+	def __init__(
+		self,
+		web_root: Path,
+		*,
+		address: str,
+		port: int,
+		filename: str = ".pulse/lock",
+	):
 		"""
 		Initialize FolderLock.
 
 		Args:
 		    web_root: Path to the web root directory
+		    address: Server address to store in lock file
+		    port: Server port to store in lock file
 		    filename: Name of the lock file (default: ".pulse/lock")
 		"""
 		self.lock_path: Path = lock_path_for_web_root(web_root, filename)
+		self.address: str = address
+		self.port: int = port
 
 	def __enter__(self):
-		_create_lock_file(self.lock_path)
+		_create_lock_file(self.lock_path, address=self.address, port=self.port)
 		return self
 
 	def __exit__(

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/cli/processes.py

@@ -272,6 +272,8 @@ def _write_tagged_line(name: str, message: str, tag_mode: TagMode) -> None:
 		"Network: use --host to expose" in clean_message
 		or "press h + enter to show help" in clean_message
 		or "➜  Local:" in clean_message
+		or "/__manifest" in clean_message
+		or "?import" in clean_message
 	):
 		return
 

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/codegen/templates/layout.py

@@ -32,7 +32,9 @@ export async function loader(args: LoaderFunctionArgs) {
   if (cookie) fwd.set("cookie", cookie);
   if (authorization) fwd.set("authorization", authorization);
   fwd.set("content-type", "application/json");
-  const res = await fetch(`${internal_server_address}$${"{"}config.apiPrefix}/prerender`, {
+  // Internal server address for server-side loader requests.
+  const internalServerAddress = "${internal_server_address}";
+  const res = await fetch(`$${"{"}internalServerAddress}$${"{"}config.apiPrefix}/prerender`, {
     method: "POST",
     headers: fwd,
     body: JSON.stringify({ paths, routeInfo: extractServerRouteInfo(args) }),

pulse_framework-0.1.73/src/pulse/debounce.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+
+import asyncio
+import math
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from typing import Any, Generic, ParamSpec, TypeVar
+
+from pulse.context import PULSE_CONTEXT
+from pulse.scheduling import TimerHandleLike, later
+
+P = ParamSpec("P")
+R = TypeVar("R")
+
+
+@dataclass(frozen=True, slots=True)
+class Debounced(Generic[P, R]):
+	fn: Callable[P, R]
+	delay_ms: float
+	_handle: TimerHandleLike | asyncio.Handle | None = field(
+		default=None, init=False, repr=False, compare=False
+	)
+
+	def __call__(self, *args: P.args, **kwargs: P.kwargs) -> Any:
+		if self._handle is not None:
+			self._handle.cancel()
+
+		delay = self.delay_ms / 1000.0
+
+		def _run() -> None:
+			object.__setattr__(self, "_handle", None)
+			result = self.fn(*args, **kwargs)
+			if asyncio.iscoroutine(result):
+				loop = asyncio.get_running_loop()
+				task = loop.create_task(result)
+
+				def _log_task_exception(t: asyncio.Task[Any]) -> None:
+					try:
+						t.result()
+					except asyncio.CancelledError:
+						pass
+					except Exception as exc:
+						loop.call_exception_handler(
+							{
+								"message": "Unhandled exception in debounced() task",
+								"exception": exc,
+								"context": {"callback": self.fn},
+							}
+						)
+
+				task.add_done_callback(_log_task_exception)
+
+		if PULSE_CONTEXT.get() is not None:
+			handle = later(delay, _run)
+		else:
+			try:
+				loop = asyncio.get_running_loop()
+			except RuntimeError:
+				try:
+					loop = asyncio.get_event_loop()
+				except RuntimeError as exc:
+					raise RuntimeError("debounced() requires an event loop") from exc
+			handle = loop.call_later(delay, _run)
+
+		object.__setattr__(self, "_handle", handle)
+
+
+def debounced(fn: Callable[P, R], delay_ms: int | float) -> Debounced[P, R]:
+	"""Return a debounced callback marker (delay in milliseconds)."""
+	if not callable(fn):
+		raise TypeError("debounced() requires a callable")
+	if isinstance(delay_ms, bool) or not isinstance(delay_ms, (int, float)):
+		raise TypeError("debounced() delay must be a number (ms)")
+	if not math.isfinite(delay_ms) or delay_ms < 0:
+		raise ValueError("debounced() delay must be finite and >= 0")
+	return Debounced(fn=fn, delay_ms=float(delay_ms))
+
+
+__all__ = ["Debounced", "debounced"]

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/decorators.py

@@ -5,7 +5,7 @@ from collections.abc import Awaitable, Callable
 from typing import Any, ParamSpec, Protocol, TypeVar, cast, overload
 
 from pulse.hooks.core import HOOK_CONTEXT
-from pulse.hooks.effects import inline_effect_hook
+from pulse.hooks.effects import effect_state
 from pulse.hooks.state import collect_component_identity
 from pulse.reactive import (
 	AsyncEffect,
@@ -16,7 +16,8 @@ from pulse.reactive import (
 	EffectFn,
 	Signal,
 )
-from pulse.state import ComputedProperty, State, StateEffect
+from pulse.state.property import ComputedProperty, StateEffect
+from pulse.state.state import State
 
 T = TypeVar("T")
 TState = TypeVar("TState", bound=State)
@@ -336,7 +337,7 @@ def effect(
 		else:
 			identity = key
 
-		state = inline_effect_hook()
+		state = effect_state()
 		return state.get_or_create(cast(Any, identity), key, create_effect)
 
 	if fn is not None:

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/hooks/effects.py

@@ -2,10 +2,10 @@ from collections.abc import Callable
 from typing import Any, override
 
 from pulse.hooks.core import HookMetadata, HookState, hooks
-from pulse.reactive import AsyncEffect, Effect
+from pulse.reactive import REACTIVE_CONTEXT, AsyncEffect, Effect
 
 
-class InlineEffectHookState(HookState):
+class EffectState(HookState):
 	"""Stores inline effects keyed by function identity or explicit key."""
 
 	__slots__ = ("effects", "_seen_this_render")  # pyright: ignore[reportUnannotatedClassAttribute]
@@ -33,6 +33,20 @@ class InlineEffectHookState(HookState):
 			if key not in self._seen_this_render:
 				self.effects[key].dispose()
 				del self.effects[key]
+		# Remove inline effects from the active render scope to avoid parent cleanup.
+		rc = REACTIVE_CONTEXT.get()
+		scope = rc.scope
+		if scope is None or not scope.effects:
+			return
+		for key in self._seen_this_render:
+			effect = self.effects.get(key)
+			if effect is None:
+				continue
+			try:
+				scope.effects.remove(effect)
+				effect.parent = None
+			except ValueError:
+				pass
 
 	def get_or_create(
 		self,
@@ -72,9 +86,9 @@ class InlineEffectHookState(HookState):
 		self._seen_this_render.clear()
 
 
-inline_effect_hook = hooks.create(
+effect_state = hooks.create(
 	"pulse:core.inline_effects",
-	lambda: InlineEffectHookState(),
+	factory=EffectState,
 	metadata=HookMetadata(
 		owner="pulse.core",
 		description="Storage for inline @ps.effect decorators in components",
@@ -83,6 +97,6 @@ inline_effect_hook = hooks.create(
 
 
 __all__ = [
-	"InlineEffectHookState",
-	"inline_effect_hook",
+	"EffectState",
+	"effect_state",
 ]

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/hooks/runtime.py

@@ -13,8 +13,8 @@ from typing import (
 from pulse.context import PulseContext
 from pulse.hooks.core import HOOK_CONTEXT
 from pulse.reactive_extensions import ReactiveDict
-from pulse.routing import RouteContext
-from pulse.state import State
+from pulse.routing import Layout, Route, RouteInfo
+from pulse.state.state import State
 
 
 class RedirectInterrupt(Exception):
@@ -47,11 +47,11 @@ class NotFoundInterrupt(Exception):
 	pass
 
 
-def route() -> RouteContext:
-	"""Get the current route context.
+def route() -> RouteInfo:
+	"""Get the current route info.
 
 	Returns:
-		RouteContext: Object with access to route parameters, path, and query.
+		RouteInfo: Mapping with access to route parameters, path, and query.
 
 	Raises:
 		RuntimeError: If called outside of a component render context.
@@ -61,8 +61,8 @@ def route() -> RouteContext:
 	```python
 	def user_page():
 	    r = ps.route()
-	    user_id = r.params.get("user_id")  # From /users/:user_id
-	    page = r.query.get("page", "1")    # From ?page=2
+	    user_id = r["pathParams"].get("user_id")  # From /users/:user_id
+	    page = r["queryParams"].get("page", "1")  # From ?page=2
 	    return m.Text(f"User {user_id}, Page {page}")
 	```
 	"""
@@ -71,7 +71,24 @@ def route() -> RouteContext:
 		raise RuntimeError(
 			"`pulse.route` can only be called within a component during rendering."
 		)
-	return ctx.route
+	return ctx.route.info
+
+
+def pulse_route() -> Route | Layout:
+	"""Get the current route definition.
+
+	Returns:
+		Route | Layout: The active route or layout definition.
+
+	Raises:
+		RuntimeError: If called outside of a component render context.
+	"""
+	ctx = PulseContext.get()
+	if not ctx or not ctx.route:
+		raise RuntimeError(
+			"`pulse.pulse_route` can only be called within a component during rendering."
+		)
+	return ctx.route.pulse_route
 
 
 def session() -> ReactiveDict[str, Any]:

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/hooks/setup.py

@@ -10,7 +10,7 @@ P = ParamSpec("P")
 T = TypeVar("T")
 
 
-class SetupHookState(HookState):
+class SetupState(HookState):
 	"""Internal hook state for the setup hook.
 
 	Manages the initialization, argument tracking, and lifecycle of
@@ -140,13 +140,9 @@ class SetupHookState(HookState):
 		return key
 
 
-def _setup_factory():
-	return SetupHookState()
-
-
-_setup_hook = hooks.create(
+setup_state = hooks.create(
 	"pulse:core.setup",
-	_setup_factory,
+	factory=SetupState,
 	metadata=HookMetadata(
 		owner="pulse.core",
 		description="Internal storage for pulse.setup hook",
@@ -195,7 +191,7 @@ def setup(init_func: Callable[P, T], *args: P.args, **kwargs: P.kwargs) -> T:
 		- Use ``ps.setup()`` directly when AST rewriting is problematic
 		- Arguments must be consistent across renders (same count and names)
 	"""
-	state = _setup_hook()
+	state = setup_state()
 	state.ensure_not_called()
 
 	key = state.consume_pending_key()
@@ -245,10 +241,10 @@ def setup_key(key: str) -> None:
 	"""
 	if not isinstance(key, str):
 		raise TypeError("setup_key() requires a string key")
-	state = _setup_hook()
+	state = setup_state()
 	if state.called_this_render:
 		raise RuntimeError("setup_key() must be called before setup() in a render")
 	state.set_pending_key(key)
 
 
-__all__ = ["setup", "setup_key", "SetupHookState"]
+__all__ = ["setup", "setup_key", "SetupState"]

{pulse_framework-0.1.71 → pulse_framework-0.1.73}/src/pulse/hooks/stable.py

@@ -35,7 +35,7 @@ class StableEntry:
 		self.wrapper = wrapper
 
 
-class StableRegistry(HookState):
+class StableState(HookState):
 	"""Internal hook state that stores stable entries by key.
 
 	Maintains a dictionary of StableEntry objects, allowing stable
@@ -50,13 +50,9 @@ class StableRegistry(HookState):
 		self.entries: dict[str, StableEntry] = {}
 
 
-def _stable_factory(*_: object) -> StableRegistry:
-	return StableRegistry()
-
-
-_stable_hook = hooks.create(
+stable_state = hooks.create(
 	"pulse:core.stable",
-	_stable_factory,
+	factory=StableState,
 	metadata=HookMetadata(
 		owner="pulse.core",
 		description="Internal registry for pulse.stable values",
@@ -119,7 +115,7 @@ def stable(key: str, value: Any = MISSING) -> Any:
 	if not key:
 		raise ValueError("stable() requires a non-empty string key")
 
-	registry = _stable_hook()
+	registry = stable_state()
 	entry = registry.entries.get(key)
 
 	if value is not MISSING:
@@ -135,4 +131,4 @@ def stable(key: str, value: Any = MISSING) -> Any:
 	return entry.wrapper
 
 
-__all__ = ["stable", "StableRegistry", "StableEntry"]
+__all__ = ["stable", "StableState", "StableEntry"]