exlab_wizard.ui.theme

Theme registration for NiceGUI / Quasar.

Per Frontend Spec §2.1.1, this module is the single place that injects the canonical :root { ... } CSS block (DESIGN.md §07). Component CSS uses var(--color-*) / var(--sp-*) / var(--text-*) / var(--radius-*) / var(--shadow-*) references instead of inline literals.

The block is generated from exlab_wizard.ui.design so DESIGN.md and design.py cannot drift.

Functions

build_root_css()	Render the canonical ``:root { .
register_static_assets()	Mount the project's assets/ directory at /assets.
register_theme()	Register the design tokens with NiceGUI / Quasar at app start.
resolve_assets_dir()	Return the absolute path to the bundled assets/ directory.

exlab_wizard.ui.theme.build_root_css()

Render the canonical :root { ... } CSS block from design tokens.

The string is intentionally derived from constants in exlab_wizard.ui.design so a token change automatically lands in the generated CSS without per-call-site updates.

Return type:

str

exlab_wizard.ui.theme.register_static_assets()

Mount the project’s assets/ directory at /assets.

Idempotent: a module-level guard prevents double-mounting on import cycles. Returns the resolved assets directory.

Return type:

Path

exlab_wizard.ui.theme.register_theme()

Register the design tokens with NiceGUI / Quasar at app start.

Imports NiceGUI lazily so unit tests can exercise this module without NiceGUI’s import side effects (the package opens browser channels at import time in some configurations).

Returns the CSS string that was registered (handy for tests and for the static-asset bundler).

Return type:

str

exlab_wizard.ui.theme.resolve_assets_dir()

Return the absolute path to the bundled assets/ directory.

Resolves both in source layout (<repo>/assets/) and in a PyInstaller-frozen layout (sys._MEIPASS/assets/).

Return type:

Path