dataface 0.1.2__py3-none-any.whl

dataface/core/render/chart/presentation.py

@@ -0,0 +1,36 @@
+"""Shared presentation helpers for chart rendering."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel
+
+
+def to_plain_dict(obj: object) -> Any:
+    """Recursively convert Pydantic models and nested objects to plain Python containers.
+
+    This is the emit-boundary converter: typed Vega-Lite contract models
+    (Config, Transform, etc.) are serialized to plain dicts here, just
+    before they enter the final Vega-Lite spec dict for JSON emission.
+    """
+    if isinstance(obj, BaseModel):
+        return obj.model_dump(by_alias=True, exclude_unset=True)
+    if isinstance(obj, dict):
+        return {k: to_plain_dict(v) for k, v in obj.items()}
+    if isinstance(obj, list):
+        return [to_plain_dict(v) for v in obj]
+    return obj
+
+
+def overlay_merge(base: dict[str, Any], overlay: dict[str, Any]) -> dict[str, Any]:
+    """Shallow-copy merge of nested dicts. Top-level keys are shallow-copied;
+    nested dicts are merged recursively. Non-dict leaf values from *overlay*
+    are assigned by reference."""
+    merged = base.copy()
+    for key, value in overlay.items():
+        if key in merged and isinstance(merged[key], dict) and isinstance(value, dict):
+            merged[key] = overlay_merge(merged[key], value)
+        else:
+            merged[key] = value
+    return merged