visualcheck 0.2.2__tar.gz → 0.2.4__tar.gz

{visualcheck-0.2.2 → visualcheck-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: visualcheck
-Version: 0.2.2
+Version: 0.2.4
 Summary: Visual regression checking with figma-first baselines, pixel+SSIM diffing, ignore regions, and HTML reports.
 Author-email: Arif Shah <ashah7775@gmail.com>
 License: MIT

{visualcheck-0.2.2 → visualcheck-0.2.4}/pyproject.toml

@@ -3,8 +3,8 @@ requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
+version = "0.2.4"
 name = "visualcheck"
-version= "0.2.2"
 description = "Visual regression checking with figma-first baselines, pixel+SSIM diffing, ignore regions, and HTML reports."
 readme = "README.md"
 requires-python = ">=3.9"

{visualcheck-0.2.2 → visualcheck-0.2.4}/src/visualcheck/baseline.py

@@ -23,11 +23,47 @@ def baseline_path(cfg: dict, kind: str, view_id: str, snapshot_id: str) -> Path:
 
 
 def resolve_baseline(cfg: dict, view_id: str, snapshot_id: str) -> Tuple[Optional[Path], str]:
-    """Return (path, kind). kind is figma/runtime/none."""
+    """Return (path, kind). kind is figma/runtime/none.
+
+    If a figma baseline is configured but not present on disk, attempt a sync
+    from the Figma API (if configured) and re-check. This allows workflows where
+    the authoritative baseline lives in Figma and should be used before creating
+    a runtime baseline.
+    """
     for kind in cfg["baseline"]["priority"]:
         p = baseline_path(cfg, kind, view_id, snapshot_id)
         if p.exists():
+            # If figma baseline exists, make it the authoritative runtime baseline
+            if kind == "figma":
+                try:
+                    runtime_p = baseline_path(cfg, "runtime", view_id, snapshot_id)
+                    ensure_dir(runtime_p.parent)
+                    # overwrite runtime baseline with figma baseline so Figma is authoritative
+                    shutil.copy2(p, runtime_p)
+                    return runtime_p, "figma"
+                except Exception:
+                    # If copying fails, return the figma path
+                    return p, "figma"
             return p, kind
+
+    # If figma is configured as a priority and missing locally, try to fetch it
+    if "figma" in (cfg["baseline"]["priority"] or []):
+        try:
+            summary = figma_sync_baselines(cfg)  # best-effort
+            # after sync, re-check for figma baseline
+            p = baseline_path(cfg, "figma", view_id, snapshot_id)
+            if p.exists():
+                try:
+                    runtime_p = baseline_path(cfg, "runtime", view_id, snapshot_id)
+                    ensure_dir(runtime_p.parent)
+                    shutil.copy2(p, runtime_p)
+                    return runtime_p, "figma"
+                except Exception:
+                    return p, "figma"
+        except Exception:
+            # never fail; always fall through to runtime/none
+            pass
+
     return None, "none"
 
 

{visualcheck-0.2.2 → visualcheck-0.2.4}/src/visualcheck/capture.py

@@ -93,9 +93,31 @@ def capture_all(cfg: dict, env: str, out_dir: Path, headed: bool = False, slow_m
                     url = _abs_url(base_url, pg["url"])
                     print(f"[capture] view={view_id} snapshot={snap_id} url={url}")
                     page.goto(url, wait_until="domcontentloaded")
+                    # Wait for the configured wait_for selector if present, then allow extra time for lazy loads.
                     if pg.get("wait_for"):
                         page.wait_for_selector(pg["wait_for"], timeout=30000)
-                    page.wait_for_timeout(500)
+
+                    # Optional additional wait and smart auto-scroll to ensure page fully renders dynamic content
+                    extra_wait_ms = int(cfg.get('capture', {}).get('extra_wait_ms', 1000))
+                    scroll_times = int(cfg.get('capture', {}).get('scrolls', 5))
+                    scroll_delay = int(cfg.get('capture', {}).get('scroll_delay_ms', 700))
+
+                    page.wait_for_timeout(extra_wait_ms)
+
+                    # gentle auto-scroll to trigger lazy-loading images/content
+                    try:
+                        for i in range(max(1, scroll_times)):
+                            page.keyboard.press('PageDown')
+                            page.wait_for_timeout(scroll_delay)
+                    except Exception:
+                        # ignore if page doesn't accept keyboard events
+                        try:
+                            # fallback to mouse wheel
+                            for i in range(max(1, scroll_times)):
+                                page.mouse.wheel(0, 800)
+                                page.wait_for_timeout(scroll_delay)
+                        except Exception:
+                            pass
 
                     full_page = bool(pg.get("full_page", True))
                     png_path = view_out / f"{slug(snap_id)}.png"

{visualcheck-0.2.2 → visualcheck-0.2.4}/src/visualcheck/figma.py

@@ -19,7 +19,15 @@ from decouple import config
 def _get_token(cfg: dict) -> Optional[str]:
     fig = cfg.get("figma") or {}
     token_env = fig.get("token_env") or "FIGMA_TOKEN"
-    # Prefer .env (python-decouple); fall back to existing env var if present
+    # Special-case: when token_env is the canonical "FIGMA_TOKEN" string we must read
+    # exclusively from the repo .env (python-decouple) and NOT fall back to system env.
+    # This avoids accidental use of a different host env variable when the YAML explicitly
+    # requested the canonical name.
+    if token_env == "FIGMA_TOKEN":
+        return config(token_env, default=None)
+
+    # For custom token_env names, prefer .env but allow OS-level fallback (useful for
+    # host-level overrides like OPENCLAW_FIGMA_TOKEN or similarly named vars).
     return config(token_env, default=os.environ.get(token_env))
 
 

{visualcheck-0.2.2 → visualcheck-0.2.4}/src/visualcheck.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: visualcheck
-Version: 0.2.2
+Version: 0.2.4
 Summary: Visual regression checking with figma-first baselines, pixel+SSIM diffing, ignore regions, and HTML reports.
 Author-email: Arif Shah <ashah7775@gmail.com>
 License: MIT