"""
Lazy-loading per-terminal grapheme override tables.

This minimizes memory for the 99.9% of use-cases of a single 'term_program'.
"""
from __future__ import annotations

# std imports
import importlib
from functools import lru_cache

# local
from ._registry import _REGISTRY


@lru_cache(maxsize=32)
def get(term_canonical: str) -> dict[str, int]:
    """
    Return grapheme override dict for a terminal, or an empty dict.

    The per-terminal module is imported on first access and cached in ``sys.modules``; subsequent
    calls for the same terminal return immediately via lru_cache.
    """
    hash_key = _REGISTRY.get(term_canonical)
    if hash_key is None:
        return {}

    try:
        mod = importlib.import_module(f'._known_{hash_key}', __package__)
        result: dict[str, int] = getattr(mod, 'GRAPHEMES')
        return result
    except ImportError:
        # This can occur during a program re-install when the registry and files are out of sync
        # (filesystem vs. in-memory copy differ), this can happen with a "pip upgrade" of a running
        # service, or if the upgrade tool itself uses wcwidth. Not being able to provide terminal
        # overrides in this situation is not important, continue without them.
        return {}