@calibrate-ds/core 0.1.53 → 0.1.65

package/dist/verify/index.d.ts

@@ -2,4 +2,6 @@ export type { VerifyReport, VerifyScreenshots, PixelMatchResult, AIFeedback, AID
 export { fetchFigmaScreenshot } from "./fetch-figma-screenshot.js";
 export { runPixelDiff } from "./pixel-diff.js";
 export { extractStructuralExpectations, computeStructureScore, extractDesignTextTokens } from "./structure-check.js";
+export { computeVerifyVerdict, VERIFY_PASS_THRESHOLD, VERIFY_WARN_THRESHOLD } from "./verdict.js";
+export type { VerifyVerdict, VerifyVerdictResult } from "./verdict.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/verify/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClG,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/verify/index.js

@@ -1,4 +1,5 @@
 export { fetchFigmaScreenshot } from "./fetch-figma-screenshot.js";
 export { runPixelDiff } from "./pixel-diff.js";
 export { extractStructuralExpectations, computeStructureScore, extractDesignTextTokens } from "./structure-check.js";
+export { computeVerifyVerdict, VERIFY_PASS_THRESHOLD, VERIFY_WARN_THRESHOLD } from "./verdict.js";
 //# sourceMappingURL=index.js.map

package/dist/verify/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/verify/types.d.ts

@@ -79,5 +79,31 @@ export type VerifyReport = {
     designTokenCount?: number;
     /** Number of design text tokens found in the rendered DOM. */
     foundTokenCount?: number;
+    /**
+     * CSS token-binding score (0–1). Fraction of styleMetadata slots with a bound
+     * cssVar (e.g. `--ptb-colors-brand-900`) that appear as `var(--ptb-…)` in the
+     * generated .module.css. Undefined when no bound slots exist or CSS is not yet
+     * generated (component not yet implemented).
+     */
+    cssVarScore?: number;
+    /** Total number of styleMetadata slots with a bound cssVar. */
+    cssVarTotal?: number;
+    /** Number of bound cssVar slots found as `var(…)` in the generated CSS. */
+    cssVarFound?: number;
+    /**
+     * GAP-022 (Level 3 whole-set verify): per-variant pixel-diff results. Present when
+     * the component is a COMPONENT_SET with per-variant reference thumbnails — each
+     * entry pixel-diffs one variant state (rendered via Storybook `?args=`) against its
+     * own single-variant Figma reference. `pixelMatch` above is set to the WORST of
+     * these so a single bad variant can't hide behind a good default.
+     */
+    variantResults?: Array<{
+        selection: Record<string, string>;
+        pixelMatch: PixelMatchResult | null;
+        /** Set when this variant could not be rendered/diffed (e.g. screenshot failed). */
+        error?: string;
+    }>;
+    /** Mean pixel score across variantResults (0–1). */
+    variantMeanScore?: number;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/verify/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/verify/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yFAAyF;IACzF,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACzC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,iBAAiB,EAAE,SAAS,GAAG,mBAAmB,GAAG,yBAAyB,CAAC;CAClF,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;IAClB,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/verify/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yFAAyF;IACzF,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACzC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,iBAAiB,EAAE,SAAS,GAAG,mBAAmB,GAAG,yBAAyB,CAAC;CAClF,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;IAClB,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;QACpC,mFAAmF;QACnF,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC"}

package/dist/verify/verdict.d.ts

@@ -0,0 +1,25 @@
+import type { VerifyReport } from "./types.js";
+/**
+ * Shared pass/warn/fail thresholds for `ptb verify`. A single source of truth so
+ * the CLI command and the MCP tool never diverge (GAP-010: the MCP tool used to
+ * hardcode a 0.95 cutoff on the raw pixel score while the CLI used 0.90 on the
+ * content/token score, so an identical run reported "warn" in one and "pass" in
+ * the other).
+ */
+export declare const VERIFY_PASS_THRESHOLD = 0.9;
+export declare const VERIFY_WARN_THRESHOLD = 0.7;
+export type VerifyVerdict = "pass" | "warn" | "fail" | "no-comparison";
+export type VerifyVerdictResult = {
+    verdict: VerifyVerdict;
+    /** The score the verdict was computed from (0–1), or null when nothing comparable existed. */
+    score: number | null;
+    /** Which metric drove the verdict. */
+    metric: "token" | "structure" | "pixel-content" | "pixel" | "none";
+};
+/**
+ * Computes a single verdict from a VerifyReport, preferring the most meaningful
+ * available signal: design-content token match (immune to font/AA differences) →
+ * structural slot presence → content-region pixel score → raw pixel score.
+ */
+export declare function computeVerifyVerdict(report: Pick<VerifyReport, "tokenScore" | "structureScore" | "pixelMatch">): VerifyVerdictResult;
+//# sourceMappingURL=verdict.d.ts.map

package/dist/verify/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/verify/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,MAAO,CAAC;AAC1C,eAAO,MAAM,qBAAqB,MAAO,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,8FAA8F;IAC9F,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sCAAsC;IACtC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;CACtE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAC1D,YAAY,GAAG,gBAAgB,GAAG,YAAY,CAAC,GAAG,mBAAmB,CA2BxE"}

package/dist/verify/verdict.js

@@ -0,0 +1,43 @@
+/**
+ * Shared pass/warn/fail thresholds for `ptb verify`. A single source of truth so
+ * the CLI command and the MCP tool never diverge (GAP-010: the MCP tool used to
+ * hardcode a 0.95 cutoff on the raw pixel score while the CLI used 0.90 on the
+ * content/token score, so an identical run reported "warn" in one and "pass" in
+ * the other).
+ */
+export const VERIFY_PASS_THRESHOLD = 0.90;
+export const VERIFY_WARN_THRESHOLD = 0.70;
+/**
+ * Computes a single verdict from a VerifyReport, preferring the most meaningful
+ * available signal: design-content token match (immune to font/AA differences) →
+ * structural slot presence → content-region pixel score → raw pixel score.
+ */
+export function computeVerifyVerdict(report) {
+    let score = null;
+    let metric = "none";
+    if (report.tokenScore !== undefined) {
+        score = report.tokenScore;
+        metric = "token";
+    }
+    else if (report.structureScore !== undefined) {
+        score = report.structureScore;
+        metric = "structure";
+    }
+    else if (report.pixelMatch) {
+        if (report.pixelMatch.contentScore !== undefined) {
+            score = report.pixelMatch.contentScore;
+            metric = "pixel-content";
+        }
+        else {
+            score = report.pixelMatch.score;
+            metric = "pixel";
+        }
+    }
+    if (score === null)
+        return { verdict: "no-comparison", score: null, metric: "none" };
+    const verdict = score >= VERIFY_PASS_THRESHOLD ? "pass"
+        : score >= VERIFY_WARN_THRESHOLD ? "warn"
+            : "fail";
+    return { verdict, score, metric };
+}
+//# sourceMappingURL=verdict.js.map

package/dist/verify/verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/verify/verdict.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAY1C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MACc;IAC/C,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,MAAM,GAAkC,MAAM,CAAC;IAEnD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;QAC1B,MAAM,GAAG,OAAO,CAAC;IACrB,CAAC;SAAM,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC7C,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;QAC9B,MAAM,GAAG,WAAW,CAAC;IACzB,CAAC;SAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/C,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC;YACvC,MAAM,GAAG,eAAe,CAAC;QAC7B,CAAC;aAAM,CAAC;YACJ,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YAChC,MAAM,GAAG,OAAO,CAAC;QACrB,CAAC;IACL,CAAC;IAED,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAErF,MAAM,OAAO,GAAkB,KAAK,IAAI,qBAAqB,CAAC,CAAC,CAAC,MAAM;QAClE,CAAC,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC,CAAC,MAAM;YACzC,CAAC,CAAC,MAAM,CAAC;IAEb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calibrate-ds/core",
-  "version": "0.1.53",
+  "version": "0.1.65",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -27,8 +27,8 @@
     "pixelmatch": "^6.0.0",
     "pngjs": "^7.0.0",
     "zod": "^4.3.6",
-    "@calibrate-ds/shared-types": "^0.1.53",
-    "@calibrate-ds/figma-client": "^0.1.48"
+    "@calibrate-ds/shared-types": "^0.1.65",
+    "@calibrate-ds/figma-client": "^0.1.65"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",