@recursica/adapter-tester 2.2.0 → 4.0.0

package/src/adapter-tester.schema.json

@@ -8,11 +8,11 @@
   "properties": {
     "$schema": {
       "type": "string",
-      "description": "Optional pointer to this schema for editor autocomplete, e.g. \"./node_modules/@recursica/adapter-tester/src/adapter-tester.schema.json\"."
+      "description": "Optional pointer to this schema for editor autocomplete, e.g. \"https://raw.githubusercontent.com/borderux/recursica/main/packages/adapter-tester/src/adapter-tester.schema.json\"."
     },
     "name": {
       "type": "string",
-      "description": "Label for this project's own target. Defaults to the unscoped name in this project's package.json (e.g. \"@recursica/mui-adapter\" -> \"mui-adapter\")."
+      "description": "Label for this project's own target. Defaults to the unscoped name in this project's package.json (e.g. \"@recursica/some-adapter\" -> \"some-adapter\")."
     },
     "storybook": {
       "type": "object",
@@ -89,20 +89,33 @@
         }
       ]
     },
+    "isSourceOfTruthAdapter": {
+      "type": "boolean",
+      "description": "True only for the source-of-truth adapter's own config (mantine-adapter). Skips `sourceOfTruth` entirely — there's nothing above it to diverge from — and runs the own-drift golden check standalone, against just this project's own Storybook. Defaults to false."
+    },
     "diffThresholdPixels": {
       "type": "number",
       "minimum": 0,
       "description": "Global visual diff threshold, in mismatched pixels, before a story is considered a failure. Defaults to 3500. AI agents must not modify this field — see AGENT.md."
     },
-    "relaxedThresholdStoryIds": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Story id prefixes that use `relaxedThresholdPixels` instead of the global `diffThresholdPixels`."
-    },
-    "relaxedThresholdPixels": {
-      "type": "number",
-      "minimum": 0,
-      "description": "Diff threshold applied to stories matching `relaxedThresholdStoryIds`."
+    "stories": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "threshold": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Diff threshold override for matching stories, in mismatched pixels. Overrides `diffThresholdPixels`."
+          },
+          "exclude": {
+            "type": "boolean",
+            "description": "Skip matching stories entirely — no own-drift check, no divergence check, no golden captured. For stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead."
+          }
+        }
+      },
+      "description": "Per-story overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). When more than one key matches a story, the longest (most specific) key wins."
     },
     "excludeTitlePrefixes": {
       "type": "array",

package/src/golden/manifest.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/golden/manifest.schema.json",
+  "title": "test/golden/manifest.json",
+  "description": "Tracks golden (baseline) image metadata for @recursica/adapter-tester's golden-image visual regression checks. One manifest lives alongside its adapter's test/golden/<story-id>.png files, keyed by story id.",
+  "type": "object",
+  "additionalProperties": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["createdAt"],
+    "properties": {
+      "createdAt": {
+        "type": "string",
+        "format": "date-time",
+        "description": "When this story's own golden PNG was last captured, via --update-golden, --approve-divergence, or first-run auto-create."
+      },
+      "sourceOfTruthCreatedAt": {
+        "type": "string",
+        "format": "date-time",
+        "description": "The source-of-truth adapter's (mantine) manifest `createdAt` for this story at the time this adapter's divergence from it was last reviewed via --approve-divergence. Omitted on the source-of-truth adapter's own manifest, and omitted here until the first approval. If mantine's current `createdAt` for this story is newer than this value, the divergence is flagged again for re-review."
+      }
+    }
+  }
+}

package/dist/config-B0Eop8Az.cjs

@@ -1,2 +0,0 @@
-"use strict";function u(t){const r=t.targets.filter(e=>e.sourceOfTruth).length;if(r!==1)throw new Error(`adapter-tester config must mark exactly one target as sourceOfTruth (found ${r})`);return t}function o(t){const r=t.targets.find(e=>e.sourceOfTruth);if(!r)throw new Error("adapter-tester config has no target marked sourceOfTruth");return r}exports.defineAdapterTesterConfig=u;exports.getSourceOfTruth=o;
-//# sourceMappingURL=config-B0Eop8Az.cjs.map

package/dist/config-B0Eop8Az.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-B0Eop8Az.cjs","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n  /** Human-readable name used in test titles, report labels, and artifact filenames. */\n  name: string;\n  /** Base URL the target's Storybook instance is served from. */\n  url: string;\n  /**\n   * Marks this target as the visual/token source of truth every other target\n   * is compared against. Exactly one target in a config must set this true.\n   */\n  sourceOfTruth?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n  targets: AdapterTarget[];\n  /** Global pixel-diff threshold applied to every story comparison. */\n  diffThresholdPixels: number;\n  /**\n   * Story ids (matched by prefix) that get `relaxedThresholdPixels` instead\n   * of `diffThresholdPixels`, for components with acceptable cross-library\n   * structural variation (e.g. native control widgets).\n   */\n  relaxedThresholdStoryIds?: string[];\n  /** Pixel-diff threshold applied to `relaxedThresholdStoryIds`. */\n  relaxedThresholdPixels?: number;\n  /**\n   * Storybook entry title categories excluded from the comparison — an\n   * entry is excluded if its title equals one of these or starts with\n   * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n   * `@recursica/storybook-template`'s own default token/theme demo stories\n   * (which every adapter's Storybook inherits automatically) plus each\n   * adapter's own onboarding \"Introduction\" stories — neither has a\n   * cross-adapter counterpart to diff against.\n   */\n  excludeTitlePrefixes?: string[];\n}\n\nexport function defineAdapterTesterConfig(\n  config: AdapterTesterConfig,\n): AdapterTesterConfig {\n  const sourceOfTruthCount = config.targets.filter(\n    (target) => target.sourceOfTruth,\n  ).length;\n  if (sourceOfTruthCount !== 1) {\n    throw new Error(\n      `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n    );\n  }\n  return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n  const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n  if (!sourceOfTruth) {\n    throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n  }\n  return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":"aAoCO,SAASA,EACdC,EACqB,CACrB,MAAMC,EAAqBD,EAAO,QAAQ,OACvCE,GAAWA,EAAO,aAAA,EACnB,OACF,GAAID,IAAuB,EACzB,MAAM,IAAI,MACR,8EAA8EA,CAAkB,GAAA,EAGpG,OAAOD,CACT,CAEO,SAASG,EAAiBH,EAA4C,CAC3E,MAAMI,EAAgBJ,EAAO,QAAQ,KAAME,GAAWA,EAAO,aAAa,EAC1E,GAAI,CAACE,EACH,MAAM,IAAI,MAAM,0DAA0D,EAE5E,OAAOA,CACT"}

package/dist/config-CDxTeSAY.js

@@ -1,21 +0,0 @@
-function o(t) {
-  const r = t.targets.filter(
-    (e) => e.sourceOfTruth
-  ).length;
-  if (r !== 1)
-    throw new Error(
-      `adapter-tester config must mark exactly one target as sourceOfTruth (found ${r})`
-    );
-  return t;
-}
-function u(t) {
-  const r = t.targets.find((e) => e.sourceOfTruth);
-  if (!r)
-    throw new Error("adapter-tester config has no target marked sourceOfTruth");
-  return r;
-}
-export {
-  o as d,
-  u as g
-};
-//# sourceMappingURL=config-CDxTeSAY.js.map

package/dist/config-CDxTeSAY.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-CDxTeSAY.js","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n  /** Human-readable name used in test titles, report labels, and artifact filenames. */\n  name: string;\n  /** Base URL the target's Storybook instance is served from. */\n  url: string;\n  /**\n   * Marks this target as the visual/token source of truth every other target\n   * is compared against. Exactly one target in a config must set this true.\n   */\n  sourceOfTruth?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n  targets: AdapterTarget[];\n  /** Global pixel-diff threshold applied to every story comparison. */\n  diffThresholdPixels: number;\n  /**\n   * Story ids (matched by prefix) that get `relaxedThresholdPixels` instead\n   * of `diffThresholdPixels`, for components with acceptable cross-library\n   * structural variation (e.g. native control widgets).\n   */\n  relaxedThresholdStoryIds?: string[];\n  /** Pixel-diff threshold applied to `relaxedThresholdStoryIds`. */\n  relaxedThresholdPixels?: number;\n  /**\n   * Storybook entry title categories excluded from the comparison — an\n   * entry is excluded if its title equals one of these or starts with\n   * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n   * `@recursica/storybook-template`'s own default token/theme demo stories\n   * (which every adapter's Storybook inherits automatically) plus each\n   * adapter's own onboarding \"Introduction\" stories — neither has a\n   * cross-adapter counterpart to diff against.\n   */\n  excludeTitlePrefixes?: string[];\n}\n\nexport function defineAdapterTesterConfig(\n  config: AdapterTesterConfig,\n): AdapterTesterConfig {\n  const sourceOfTruthCount = config.targets.filter(\n    (target) => target.sourceOfTruth,\n  ).length;\n  if (sourceOfTruthCount !== 1) {\n    throw new Error(\n      `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n    );\n  }\n  return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n  const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n  if (!sourceOfTruth) {\n    throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n  }\n  return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":"AAoCO,SAASA,EACdC,GACqB;AACrB,QAAMC,IAAqBD,EAAO,QAAQ;AAAA,IACxC,CAACE,MAAWA,EAAO;AAAA,EAAA,EACnB;AACF,MAAID,MAAuB;AACzB,UAAM,IAAI;AAAA,MACR,8EAA8EA,CAAkB;AAAA,IAAA;AAGpG,SAAOD;AACT;AAEO,SAASG,EAAiBH,GAA4C;AAC3E,QAAMI,IAAgBJ,EAAO,QAAQ,KAAK,CAACE,MAAWA,EAAO,aAAa;AAC1E,MAAI,CAACE;AACH,UAAM,IAAI,MAAM,0DAA0D;AAE5E,SAAOA;AACT;"}