----------------------------------------------------------------------
This is the API documentation for the gdtest_theme_lumen library.
----------------------------------------------------------------------


## Functions

Public functions


illuminate(scene: str) -> str

Illuminate a scene by adding light.

Parameters
----------
scene : str
    The scene description to illuminate.

Returns
-------
str
    The illuminated scene description.

Examples
--------
>>> illuminate("dark room")
'bright dark room'

dim(brightness: float) -> float

Reduce brightness by half.

Parameters
----------
brightness : float
    The current brightness level.

Returns
-------
float
    The dimmed brightness level.

Examples
--------
>>> dim(1.0)
0.5