@penpair/core 0.3.5 → 0.3.7

package/dist/approvals.js

@@ -2,6 +2,7 @@ import { createHash, randomUUID } from "node:crypto";
 import { mkdir, open, readFile, stat, unlink } from "node:fs/promises";
 import path from "node:path";
 import { atomicWriteFile } from "./atomic-output.js";
+import { matchesDesignViewport } from "./design-viewport.js";
 import { observationHash } from "./journal.js";
 import { resolveProjectInput, resolveProjectOutput } from "./project-input.js";
 import { validateBaselineCase } from "./baselines-config.js";
@@ -100,7 +101,8 @@ export async function recordApproval(root, exported, words, intent, redact) {
     words = {
         ...words,
     };
-    if (!exported.stable || !pngSize(exported.png)) {
+    const imageSize = pngSize(exported.png);
+    if (!exported.stable || !imageSize) {
         throw new Error("Approval requires a stable independently exported PNG");
     }
     if (typeof words.note !== "string" ||
@@ -114,9 +116,9 @@ export async function recordApproval(root, exported, words, intent, redact) {
     const sha256 = artifactSha(exported.png);
     const fingerprint = approvalFingerprint(exported.capture, sha256, intent);
     if (intent &&
-        (!exported.capture.designSize ||
-            exported.capture.designSize.width !== intent.viewport.width ||
-            exported.capture.designSize.height !== intent.viewport.height ||
+        (!matchesDesignViewport(exported.capture.designSize, intent.viewport) ||
+            imageSize.width !== Math.round(intent.viewport.width * exported.capture.scale) ||
+            imageSize.height !== Math.round(intent.viewport.height * exported.capture.scale) ||
             (intent.activeThemeIds &&
                 observationHash([
                     ...(exported.capture.activeThemeIds ?? []),

package/dist/baseline-coverage.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { createHash } from "node:crypto";
 import { resolveProjectOutput } from "./project-input.js";
 import { pngSize } from "./png.js";
+import { matchesDesignViewport } from "./design-viewport.js";
 import { validateBaselines, } from "./baselines-config.js";
 import { observationHash } from "./journal.js";
 export const designCaseKey = (route, value) => observationHash({
@@ -75,8 +76,7 @@ export function baselineCoverage(config, results = []) {
                 (!result.captured ||
                     (evidence.fileId === result.captured.fileId &&
                         evidence.pageId === result.captured.pageId)) &&
-                evidence.designSize?.width === frame.case.viewport.width &&
-                evidence.designSize?.height === frame.case.viewport.height &&
+                matchesDesignViewport(evidence.designSize, frame.case.viewport) &&
                 result.imageWidth === Math.round(frame.case.viewport.width * evidence.scale) &&
                 result.imageHeight === Math.round(frame.case.viewport.height * evidence.scale) &&
                 (!frame.case.activeThemeIds ||

package/dist/baselines.js

@@ -1,4 +1,5 @@
 import { matchingApproval } from "./approvals.js";
+import { matchesDesignViewport } from "./design-viewport.js";
 import { pngSize } from "./png.js";
 export { pngSize } from "./png.js";
 import { createHash, randomUUID } from "node:crypto";
@@ -180,9 +181,7 @@ export async function exportBaselines(client, projectRoot, config, options = {})
         if (wanted.case) {
             const viewport = wanted.case.viewport;
             const size = pngSize(exported.png);
-            if (!exported.capture.designSize ||
-                exported.capture.designSize.width !== viewport.width ||
-                exported.capture.designSize.height !== viewport.height) {
+            if (!matchesDesignViewport(exported.capture.designSize, viewport)) {
                 caseProblems.push("Observed frame dimensions do not match the declared viewport");
             }
             if (size.width !== Math.round(viewport.width * exported.capture.scale) ||

package/dist/design-viewport.d.ts

@@ -0,0 +1,3 @@
+import type { BaselineCase } from "./baselines-config.js";
+/** Penpot transforms can introduce subpixel noise; exported image dimensions remain exact. */
+export declare function matchesDesignViewport(designSize: BaselineCase["viewport"] | undefined, viewport: BaselineCase["viewport"]): boolean;

package/dist/design-viewport.js

@@ -0,0 +1,9 @@
+const designSizeTolerancePx = 0.01;
+/** Penpot transforms can introduce subpixel noise; exported image dimensions remain exact. */
+export function matchesDesignViewport(designSize, viewport) {
+    return Boolean(designSize &&
+        Number.isFinite(designSize.width) &&
+        Number.isFinite(designSize.height) &&
+        Math.abs(designSize.width - viewport.width) < designSizeTolerancePx &&
+        Math.abs(designSize.height - viewport.height) < designSizeTolerancePx);
+}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Kept in its own file so that the command line and the library entry can both read it without importing each other. Equals package.json (a test checks). */
-export declare const version = "0.3.5";
+export declare const version = "0.3.7";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Kept in its own file so that the command line and the library entry can both read it without importing each other. Equals package.json (a test checks). */
-export const version = "0.3.5";
+export const version = "0.3.7";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penpair/core",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Design together. Build together. The library and engine behind penpair: connect AI agents and people to a Penpot design file, safely. Install @penpair/web or @penpair/docker for the command.",
   "license": "MIT",
   "repository": {

package/skills/penpair-verify/references/browser-evidence.md

@@ -15,7 +15,7 @@ browser dependency and working provider are still required in the project.
 
 Before claiming a comparison, retain the case ID, approved reference/hash, setup
 name, provider identity/version and actual browser observation. Check viewport,
-theme, state, fixture, loaded fonts, PNG dimensions and scale. Missing state
+theme, state, fixture, loaded fonts, image dimensions and scale (PNG or static lossless WebP). Missing state
 hooks, placeholder routes or echoed test inputs leave verification pending.
 Inspect pointer/hover, scroll/sticky behavior, occlusion and capture-root bounds
 when they can explain a mismatch. Do not hide them by changing the reference.