feat(#79): IMP-51 image_overrides axis (u1~u11 backend stamp+CLI+CSS inject + frontend drag/resize+persistence + tests)

tests/test_user_overrides_io.py

@@ -1,8 +1,9 @@
 """IMP-52 (#80) u8 — backend tests for ``src.user_overrides_io``.
 
-Covers the four axes called out in the Stage 2 plan:
+Covers the persisted axes called out in the Stage 2 plan
+(IMP-51 #79 u1 extended this to 5 axes by adding ``image_overrides``):
 
-1. Round-trip ``save`` → ``load`` (4 KNOWN_AXES + foreign top-level keys).
+1. Round-trip ``save`` → ``load`` (5 KNOWN_AXES + foreign top-level keys).
 2. Unknown-key passthrough (foreign axes preserved across partial merges).
 3. Missing / corrupt / non-object behavior (graceful ``{}`` + stderr warning).
 4. Invalid keys (``InvalidOverrideKey`` raised on traversal / separators /
@@ -115,9 +116,18 @@ def _full_payload() -> dict:
         },
         "zone_sections": {"zone-top": ["03-1", "03-2"]},
         "frames": {"03-1+03-2": "frame_two_way_compare"},
+        "image_overrides": {
+            "img-1": {"x": 10.0, "y": 20.0, "w": 30.0, "h": 25.0},
+        },
     }
 
 
+def test_known_axes_includes_image_overrides():
+    """IMP-51 #79 u1 — ``image_overrides`` is a known axis (5 total)."""
+    assert "image_overrides" in KNOWN_AXES
+    assert len(KNOWN_AXES) == 5
+
+
 def test_save_then_load_round_trip(tmp_path):
     key = "03"
     payload = _full_payload()
@@ -141,6 +151,28 @@ def test_save_partial_payload_preserves_other_axes(tmp_path):
     assert loaded["zone_geometries"] == _full_payload()["zone_geometries"]
     assert loaded["zone_sections"] == _full_payload()["zone_sections"]
     assert loaded["frames"] == _full_payload()["frames"]
+    assert loaded["image_overrides"] == _full_payload()["image_overrides"]
+
+
+def test_save_partial_image_overrides_preserves_other_axes(tmp_path):
+    """IMP-51 #79 u1 — partial ``image_overrides`` write preserves siblings."""
+    key = "03"
+    save(key, _full_payload(), root=tmp_path)
+
+    save(
+        key,
+        {"image_overrides": {"img-9": {"x": 5.0, "y": 5.0, "w": 50.0, "h": 50.0}}},
+        root=tmp_path,
+    )
+    loaded = load(key, root=tmp_path)
+
+    assert loaded["image_overrides"] == {
+        "img-9": {"x": 5.0, "y": 5.0, "w": 50.0, "h": 50.0}
+    }
+    assert loaded["layout"] == _full_payload()["layout"]
+    assert loaded["zone_geometries"] == _full_payload()["zone_geometries"]
+    assert loaded["zone_sections"] == _full_payload()["zone_sections"]
+    assert loaded["frames"] == _full_payload()["frames"]
 
 
 def test_save_axis_replaces_not_deep_merges(tmp_path):
@@ -162,14 +194,15 @@ def test_save_none_clears_axis(tmp_path):
 
 
 def test_save_preserves_foreign_top_level_keys(tmp_path):
-    """Forward-compat: axes outside KNOWN_AXES (zone_sizes, image_overrides,
-    schema_version, ...) must survive a partial merge on a known axis."""
+    """Forward-compat: axes outside KNOWN_AXES (zone_sizes, schema_version,
+    ...) must survive a partial merge on a known axis. (IMP-51 #79 u1
+    promoted ``image_overrides`` to a known axis, so it is no longer
+    exercised here as a foreign key.)"""
     key = "03"
     path = override_path(key, root=tmp_path)
     path.parent.mkdir(parents=True, exist_ok=True)
     pre_seed = {
         "layout": "single-column",
-        "image_overrides": {"img-1": {"position": "right", "size": "small"}},
         "zone_sizes": {"zone-top": "tall"},
         "schema_version": "experimental-1",
     }
@@ -179,7 +212,6 @@ def test_save_preserves_foreign_top_level_keys(tmp_path):
 
     loaded = load(key, root=tmp_path)
     assert loaded["layout"] == "sidebar-right"
-    assert loaded["image_overrides"] == pre_seed["image_overrides"]
     assert loaded["zone_sizes"] == pre_seed["zone_sizes"]
     assert loaded["schema_version"] == pre_seed["schema_version"]
 
@@ -197,10 +229,11 @@ def test_save_writes_pretty_sorted_json_for_diffability(tmp_path):
     raw = (tmp_path / "03.json").read_text(encoding="utf-8")
     # sort_keys=True → KNOWN_AXES come out alphabetically
     pos_frames = raw.index('"frames"')
+    pos_image_overrides = raw.index('"image_overrides"')
     pos_layout = raw.index('"layout"')
     pos_zg = raw.index('"zone_geometries"')
     pos_zs = raw.index('"zone_sections"')
-    assert pos_frames < pos_layout < pos_zg < pos_zs
+    assert pos_frames < pos_image_overrides < pos_layout < pos_zg < pos_zs
 
 
 def test_save_leaves_no_tmp_file_on_success(tmp_path):