Add JS class

htmltools/__init__.py

@@ -5,6 +5,7 @@
 from ._core import TagChildArg  # pyright: ignore[reportUnusedImport]  # noqa: F401
 from ._core import (
     HTML,
+    JS,
     HTMLDependency,
     HTMLDocument,
     HTMLTextDocument,
@@ -46,6 +47,7 @@
     "svg",
     "tags",
     "HTML",
+    "JS",
     "HTMLDependency",
     "HTMLDocument",
     "HTMLTextDocument",

htmltools/_core.py

@@ -1238,27 +1238,19 @@ def _static_extract_serialized_html_deps(
 # =============================================================================
 # HTML strings
 # =============================================================================
-class HTML(str):
-    """
-    Mark a string as raw HTML. This will prevent the string from being escaped when
-    rendered inside an HTML tag.
 
-    Examples
-    --------
-    >>> from htmltools import HTML, div
-    >>> div("<p>Hello</p>")
-    <div>&lt;p&gt;Hello&lt;/p&gt;</div>
-    >>> div(HTML("<p>Hello</p>"))
-    <div><p>Hello</p></div>
+
+class RAW(str):
+    """
+    Base class for raw content.
     """
 
     def __str__(self) -> str:
         return self.as_string()
 
-    # HTML() + HTML() should return HTML()
-    def __add__(self, other: "str| HTML") -> str:
+    def __add__(self, other: "str| RAW") -> str:
         res = str.__add__(self, other)
-        return HTML(res) if isinstance(other, HTML) else res
+        return self.__class__(res) if isinstance(other, self.__class__) else res
 
     def __repr__(self) -> str:
         return self.as_string()
@@ -1270,6 +1262,31 @@ def as_string(self) -> str:
         return self + ""
 
 
+class HTML(RAW):
+    """
+    Mark a string as raw HTML. This will prevent the string from being escaped when
+    rendered inside an HTML tag.
+
+    Examples
+    --------
+    >>> from htmltools import HTML, div
+    >>> div("<p>Hello</p>")
+    <div>&lt;p&gt;Hello&lt;/p&gt;</div>
+    >>> div(HTML("<p>Hello</p>"))
+    <div><p>Hello</p></div>
+    """
+
+    pass
+
+
+class JS(RAW):
+    """
+    Mark a string as raw JavaScript.
+    """
+
+    pass
+
+
 # =============================================================================
 # HTML dependencies
 # =============================================================================