| """Validate / repair a model-emitted box list so the renderer never receives | |
| garbage. The freeform model is grammar-constrained to integers, but truncation | |
| or odd values can still slip through; this clamps sizes and drops unusable boxes.""" | |
| from __future__ import annotations | |
| _MAX = 8 | |
| _DEFAULT_COLOR = "#caa06f" | |
| def _int(v): | |
| try: | |
| return int(v) | |
| except (TypeError, ValueError): | |
| return None | |
| def repair_boxes(raw) -> list[dict]: | |
| if not isinstance(raw, list): | |
| return [] | |
| out: list[dict] = [] | |
| for b in raw: | |
| if not isinstance(b, dict): | |
| continue | |
| vals = {k: _int(b.get(k)) for k in ("x", "y", "z", "w", "h", "d")} | |
| if any(v is None for v in vals.values()): | |
| continue | |
| for k in ("w", "h", "d"): | |
| vals[k] = max(1, min(_MAX, vals[k])) | |
| color = b.get("color") | |
| if not isinstance(color, str) or not color.startswith("#"): | |
| color = _DEFAULT_COLOR | |
| out.append({**vals, "color": color}) | |
| return out | |