"""mgf-brand-web — the Magogi Foundation brand-web kit as an installable package.

The CSS implementation of the Magogi Brand Book (tokens, base, components) plus
the self-hosted fonts, logo marks, and Federation-Lattice patterns — shipped as
package data so any MGF web surface consumes ONE source of truth instead of
copying CSS (the drift the federation kept hitting). ``mgf-brand`` itself ships
only design tokens + prose; this package fills the component-CSS gap.

Consume it (FastAPI example)::

    from fastapi.staticfiles import StaticFiles
    from mgf.brand_web import static_dir

    app.mount("/static/brand", StaticFiles(directory=static_dir()), name="brand")

then load ``/static/brand/{tokens,fonts,base,components}.css`` in your ``<head>``
(see the kit README for the exact snippet). Operator tools additionally load
``instruments.css`` (control-surface components: state chips, the streaming
console, the telemetry live-pane, …). Sibling of ``mgf-common`` under the
``mgf.*`` namespace (PEP 420).
"""

from __future__ import annotations

from pathlib import Path

__all__ = ["__version__", "static_dir"]

__version__ = "0.2.0"


def static_dir() -> Path:
    """Absolute path to the brand-web static asset directory.

    Mount this directory at ``/static/brand`` (or wherever your ``<head>`` links
    point) to serve the kit's CSS, fonts, logos, and patterns.
    """
    return Path(__file__).parent / "static"
