fix(html): Improove typing for style element

ludic/html.py

@@ -1,5 +1,5 @@
 from collections.abc import Callable, Iterator
-from typing import Self, Unpack
+from typing import Generic, Self, Unpack
 
 from .attrs import (
     AreaAttrs,
@@ -58,11 +58,11 @@
 from .base import BaseElement
 from .elements import Element, ElementStrict
 from .styles import (
-    Theme,
     format_styles,
     from_components,
     from_loaded,
 )
+from .styles.types import TTheme
 from .types import (
     AnyChildren,
     ComplexChildren,
@@ -533,16 +533,16 @@ def __init__(self, *children: NoChildren, **attrs: Unpack[HeadLinkAttrs]) -> Non
         super().__init__(*children, **attrs)
 
 
-class style(BaseElement, GlobalStyles):
+class style(Generic[TTheme], BaseElement, GlobalStyles):
     html_name = "style"
 
-    children: tuple[GlobalStyles | Callable[[Theme], GlobalStyles] | str]
+    children: tuple[GlobalStyles | Callable[[TTheme], GlobalStyles] | str]
     attrs: StyleAttrs
 
     def __init__(
         self,
-        styles: GlobalStyles | Callable[[Theme], GlobalStyles] | str,
-        theme: Theme | None = None,
+        styles: GlobalStyles | Callable[[TTheme], GlobalStyles] | str,
+        theme: TTheme | None = None,
         **attrs: Unpack[StyleAttrs],
     ) -> None:
         super().__init__(styles, **attrs)
@@ -551,17 +551,17 @@ def __init__(
             self.context["theme"] = theme
 
     @classmethod
-    def use(cls, styles: GlobalStyles | Callable[[Theme], GlobalStyles]) -> Self:
+    def use(cls, styles: GlobalStyles | Callable[[TTheme], GlobalStyles]) -> Self:
         return cls(styles)
 
     @classmethod
     def from_components(
-        cls, *components: type[BaseElement], theme: Theme | None = None
+        cls, *components: type[BaseElement], theme: TTheme | None = None
     ) -> Self:
         return cls(from_components(*components, theme=theme), type="text/css")
 
     @classmethod
-    def load(cls, cache: bool = False, theme: Theme | None = None) -> Self:
+    def load(cls, cache: bool = False, theme: TTheme | None = None) -> Self:
         return cls(from_loaded(cache=cache, theme=theme), type="text/css")
 
     def __getitem__(self, key: str | tuple[str, ...]) -> CSSProperties | GlobalStyles:

ludic/styles/themes.py

@@ -151,10 +151,10 @@ class Grid:
 class Frame:
     """Frame layout config for a theme."""
 
-    # The width of the frame
+    # The width of the frame as fraction
     numerator: int = 16
 
-    # The height of the frame
+    # The height of the frame as fraction
     denominator: int = 9
 
 

ludic/styles/types.py

@@ -1,6 +1,15 @@
 from abc import ABCMeta, abstractmethod
 from collections.abc import Mapping
-from typing import Literal, LiteralString, Self, SupportsIndex, TypedDict
+from typing import (
+    TYPE_CHECKING,
+    Literal,
+    LiteralString,
+    Self,
+    SupportsIndex,
+    TypedDict,
+)
+
+from typing_extensions import TypeVar
 
 from .utils import (
     clamp,
@@ -10,6 +19,10 @@
     pick_readable_color_for,
 )
 
+if TYPE_CHECKING:
+    from .themes import Theme
+
+TTheme = TypeVar("TTheme", bound="Theme", default="Theme")
 SizeUnit = Literal["px", "ex", "em", "ch", "rem", "vw", "vh", "vmin", "vmax", "%"]
 
 
@@ -589,6 +602,7 @@ def __sub__(self, value: float | int | LiteralString | SupportsIndex) -> Self:
         "height": str,
         "hyphens": Literal["none", "manual", "auto"],
         # I
+        "inset": str | int,
         "inline-size": str,
         # J
         "justify-content": Literal[