feat: Make documentation page titles optional

Bing-su · Bing-su · commit 2fb1ad26eb01 · 2025-12-11T15:02:02.000+09:00
diff --git a/src/stopments/elements.py b/src/stopments/elements.py
@@ -23,7 +23,7 @@ class RouterOptions(Enum):
 def get_stoplight_elements_html(  # noqa: PLR0913 many arguments in function definition
     *,
     openapi_url: str,
-    title: str,
+    title: str = "API Documentation",
     stoplight_elements_js_url: str = "https://cdn.jsdelivr.net/npm/@stoplight/elements/web-components.min.js",
     stoplight_elements_css_url: str = "https://cdn.jsdelivr.net/npm/@stoplight/elements/styles.min.css",
     stoplight_elements_favicon_url: str = "https://docs.stoplight.io/favicons/favicon.ico",
@@ -71,6 +71,7 @@ def get_stoplight_elements_html(  # noqa: PLR0913 many arguments in function def
         The HTML document as a string.
     """
 
+    title = title or "API Documentation"
     return f"""
 <!doctype html>
 <html lang="en">
diff --git a/src/stopments/scalar.py b/src/stopments/scalar.py
@@ -83,7 +83,7 @@ def dump(key: str, data: object) -> str:
 def get_scalar_html(  # noqa: PLR0913
     *,
     openapi_url: str,
-    title: str,
+    title: str = "API Documentation",
     scalar_js_url: str = "https://cdn.jsdelivr.net/npm/@scalar/api-reference",
     scalar_proxy_url: str = "",
     scalar_favicon_url: str = "https://docs.scalar.com/favicon.svg",
@@ -127,6 +127,7 @@ def get_scalar_html(  # noqa: PLR0913
     """
     servers = servers or []
     authentication = authentication or {}
+    title = title or "API Documentation"
 
     return f"""<!doctype html>
 <html>
