From 74477e8c322b7091cd83a777ed762a1b5202027c Mon Sep 17 00:00:00 2001
From: planetabhi <1704622+planetabhi@users.noreply.github.com>
Date: Sat, 15 Aug 2026 19:06:50 +0530
Subject: [PATCH] v0.0.4

---
 .gitignore         |  4 +++-
 index.ts           |  1 +
 src/core.ts        | 15 ++++++++-------
 src/fetch/figma.ts |  2 ++
 4 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/.gitignore b/.gitignore
index e75623a..32df7a2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -156,4 +156,6 @@ Thumbs.db
 
 # local scratch files
 plan.md
-dummy.png
\ No newline at end of file
+dummy.png
+
+rules/
\ No newline at end of file
diff --git a/index.ts b/index.ts
index 0df556d..daeece6 100644
--- a/index.ts
+++ b/index.ts
@@ -136,6 +136,7 @@ function parseIgnore(spec: string | undefined): IgnoreRegion {
   if (parts.length !== 4 || parts.some((n) => !Number.isFinite(n))) {
     fail(`--ignore expects x,y,w,h (got "${spec ?? ""}")`);
   }
+  // SAFETY: the guard above proves parts holds exactly four finite numbers.
   const [x, y, width, height] = parts as [number, number, number, number];
   return { x, y, width, height };
 }
diff --git a/src/core.ts b/src/core.ts
index e3fe915..58d97eb 100644
--- a/src/core.ts
+++ b/src/core.ts
@@ -118,18 +118,19 @@ export async function designDiff(opts: DesignDiffOptions): Promise<DesignDiffRes
   const metricsPath = join(runDir, "metrics.json");
 
   let box: Geometry;
-  if (pngPath) {
+  if (isFigmaSource(opts.design)) {
+    const { fileKey, frameId } = opts.design;
+    ({ box } = await exportDesignFrame(fileKey, frameId, scale, designPng));
+  } else {
+    const localPng = opts.design;
     let png: PNG;
     try {
-      png = PNG.sync.read(readFileSync(pngPath));
+      png = PNG.sync.read(readFileSync(localPng));
     } catch {
-      throw new Error(`${pngPath} is not a readable PNG`);
+      throw new Error(`${localPng} is not a readable PNG`);
     }
-    copyFileSync(pngPath, designPng);
+    copyFileSync(localPng, designPng);
     box = { x: 0, y: 0, w: png.width / scale, h: png.height / scale };
-  } else {
-    const src = opts.design as FigmaSource;
-    ({ box } = await exportDesignFrame(src.fileKey, src.frameId, scale, designPng));
   }
 
   let pageWidth: number;
diff --git a/src/fetch/figma.ts b/src/fetch/figma.ts
index 468a3d9..0d6be91 100644
--- a/src/fetch/figma.ts
+++ b/src/fetch/figma.ts
@@ -36,6 +36,8 @@ function backoffMs(res: Response, attempt: number): number {
 async function figmaGet<T>(path: string, token: string): Promise<T> {
   for (let attempt = 0; ; attempt++) {
     const res = await fetch(`${FIGMA_API}${path}`, { headers: { "X-Figma-Token": token } });
+    // SAFETY: these Figma REST endpoints return the fields declared by the caller's response
+    // type (FigmaNodesResponse / FigmaImagesResponse); every accessed field is guarded downstream.
     if (res.ok) return (await res.json()) as T;
     const retryable = res.status === 429 || res.status >= 500;
     if (!retryable || attempt >= MAX_RETRIES) {