@recursica/adapter-tester 2.2.0 → 4.0.0

package/dist/config.d.ts

@@ -9,18 +9,53 @@ export interface AdapterTarget {
      */
     sourceOfTruth?: boolean;
 }
+/** How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)
+ * own golden images, for the divergence check. Never involves booting a
+ * Storybook — both `readImage` targets are plain files on disk. */
+export type SourceOfTruthGoldenLocation = {
+    /** Sibling package already checked out locally (this monorepo's own
+     * `sourceOfTruth.type: "url"` mode) — read its `test/golden/` directly. */
+    type: "local";
+    /** Absolute path to the source-of-truth adapter's `test/golden/` directory. */
+    dir: string;
+} | {
+    /** No local checkout (the default, standalone-repo mode) — resolve the
+     * installed version against the npm registry, then fetch that git tag's
+     * `test/golden/` from the public GitHub repo, caching what's downloaded. */
+    type: "npm";
+    packageName: string;
+    /** npm version/dist-tag to resolve, e.g. "latest" or a pinned version. */
+    versionSpec: string;
+    /** Directory downloaded manifest/images are cached in between runs. */
+    cacheDir: string;
+};
+export type GoldenMode = "check" | "update-golden" | "approve-divergence";
+/**
+ * Which check(s) a run performs. `"own"` (the default) is what a normal,
+ * fast, no-network run does: this project's own live render vs. its own
+ * committed golden images. `"divergence"` is the separate, opt-in check
+ * against the source-of-truth adapter's published golden images.
+ */
+export type CheckMode = "own" | "divergence";
+export interface StoryOverride {
+    /** Diff threshold override for this story. Overrides `diffThresholdPixels`
+     * for components with acceptable cross-library structural variation (e.g.
+     * native control widgets). */
+    threshold?: number;
+    /** Skip this story entirely — no own-drift check, no divergence check, no
+     * golden captured. For stories with no meaningful cross-adapter counterpart. */
+    exclude?: boolean;
+}
 export interface AdapterTesterConfig {
     targets: AdapterTarget[];
     /** Global pixel-diff threshold applied to every story comparison. */
     diffThresholdPixels: number;
     /**
-     * Story ids (matched by prefix) that get `relaxedThresholdPixels` instead
-     * of `diffThresholdPixels`, for components with acceptable cross-library
-     * structural variation (e.g. native control widgets).
+     * 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, the
+     * longest (most specific) key wins.
      */
-    relaxedThresholdStoryIds?: string[];
-    /** Pixel-diff threshold applied to `relaxedThresholdStoryIds`. */
-    relaxedThresholdPixels?: number;
+    stories?: Record<string, StoryOverride>;
     /**
      * Storybook entry title categories excluded from the comparison — an
      * entry is excluded if its title equals one of these or starts with
@@ -31,6 +66,22 @@ export interface AdapterTesterConfig {
      * cross-adapter counterpart to diff against.
      */
     excludeTitlePrefixes?: string[];
+    /** Absolute path to this project's own `test/golden/` directory — where
+     * golden PNGs and `manifest.json` are stored, committed to git. */
+    goldenDir: string;
+    /**
+     * True only for the source-of-truth adapter's own config (mantine). It has
+     * nothing above it to diverge from, so the divergence check is skipped
+     * entirely and `sourceOfTruthGolden` is ignored.
+     */
+    isSourceOfTruthAdapter: boolean;
+    /** How to reach the source-of-truth's golden images. Required unless
+     * `isSourceOfTruthAdapter` is true. */
+    sourceOfTruthGolden?: SourceOfTruthGoldenLocation;
+    /** Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `"check"`. */
+    goldenMode: GoldenMode;
+    /** Set by the CLI from `--divergence-only`. Defaults to `"own"`. */
+    checkMode: CheckMode;
 }
 export declare function defineAdapterTesterConfig(config: AdapterTesterConfig): AdapterTesterConfig;
 export declare function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAUrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAM3E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;mEAEmE;AACnE,MAAM,MAAM,2BAA2B,GACnC;IACE;+EAC2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE;;gFAE4E;IAC5E,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B;;kCAE8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;2CACuC;IACvC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,2FAA2F;IAC3F,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAUrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAM3E"}

package/dist/fileConfig.d.ts

@@ -1,4 +1,4 @@
-import { AdapterTesterConfig } from './config.js';
+import { AdapterTesterConfig, StoryOverride } from './config.js';
 import { HarnessWebServerConfig } from './harness/mantineSourceOfTruth.js';
 export declare const CONFIG_FILE_NAME = "adapter-tester.config.json";
 interface StorybookTargetFileConfig {
@@ -36,25 +36,41 @@ export interface AdapterTesterFileConfig {
     storybook?: StorybookTargetFileConfig;
     sourceOfTruth?: SourceOfTruthFileConfig;
     diffThresholdPixels?: number;
-    relaxedThresholdStoryIds?: string[];
-    relaxedThresholdPixels?: number;
+    stories?: Record<string, StoryOverride>;
     excludeTitlePrefixes?: string[];
+    /**
+     * 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.
+     */
+    isSourceOfTruthAdapter?: boolean;
 }
 export interface ResolvedAdapterTesterConfig {
     engineConfig: AdapterTesterConfig;
     webServers: HarnessWebServerConfig[];
 }
+export interface ResolveConfigOverrides {
+    /** From `--source-of-truth-version`. Overrides `sourceOfTruth.mantineAdapterVersion`. */
+    mantineAdapterVersion?: string;
+}
 /**
  * Loads `adapter-tester.config.json` from `cwd` (or falls back to defaults
  * when the file doesn't exist) and resolves it into the engine config
- * `runVisualRegression` consumes plus the Playwright `webServer` entries
+ * `resolveVisualRegressionPlan` consumes plus the Playwright `webServer` entries
  * needed to boot both sides of the comparison.
  *
  * Default mode (no `sourceOfTruth`/`storybook` set): compares this project's
  * own Storybook against a throwaway Mantine harness — no monorepo checkout
  * required. Set `sourceOfTruth.type: "url"` for the non-standard mode used
  * to compare sibling workspace packages inside this monorepo.
+ *
+ * `overrides.mantineAdapterVersion` (from `--source-of-truth-version`) pins
+ * the mantine-harness install/golden-fetch version for this run, overriding
+ * `sourceOfTruth.mantineAdapterVersion`. Throws if passed together with
+ * `isSourceOfTruthAdapter` or `sourceOfTruth.type: "url"` — neither has a
+ * version to pin.
  */
-export declare function resolveConfig(cwd: string): ResolvedAdapterTesterConfig;
+export declare function resolveConfig(cwd: string, overrides?: ResolveConfigOverrides): ResolvedAdapterTesterConfig;
 export {};
 //# sourceMappingURL=fileConfig.d.ts.map

package/dist/fileConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileConfig.d.ts","sourceRoot":"","sources":["../src/fileConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAIhF,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAO7D,UAAU,yBAAyB;IACjC;;wEAEoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qCAAqC;IAC7C;gFAC4E;IAC5E,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC;yEACqE;IACrE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,uBAAuB,GACxB,qCAAqC,GACrC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;uFACmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,CAiEtE"}
+{"version":3,"file":"fileConfig.d.ts","sourceRoot":"","sources":["../src/fileConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAMhF,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAO7D,UAAU,yBAAyB;IACjC;;wEAEoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qCAAqC;IAC7C;gFAC4E;IAC5E,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC;yEACqE;IACrE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,uBAAuB,GACxB,qCAAqC,GACrC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;uFACmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,sBAA2B,GACrC,2BAA2B,CA8H7B"}

package/dist/golden/diffPng.d.ts

@@ -0,0 +1,13 @@
+export interface PngDiffResult {
+    /** Mismatched-pixel count, or `Infinity` if the two images aren't even the
+     * same dimensions — pixelmatch itself throws on a size mismatch, and a size
+     * mismatch is itself a real difference, not something to swallow. */
+    diffPixels: number;
+    /** Visual highlight of the mismatched pixels, encoded as a PNG buffer.
+     * `null` when `diffPixels` is `Infinity` — there's no pixel-aligned diff to
+     * render across two different-sized images. */
+    diffImage: Buffer | null;
+}
+/** Pixel-diffs two PNG buffers. */
+export declare function diffPngBuffers(a: Buffer, b: Buffer): PngDiffResult;
+//# sourceMappingURL=diffPng.d.ts.map

package/dist/golden/diffPng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffPng.d.ts","sourceRoot":"","sources":["../../src/golden/diffPng.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B;;yEAEqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB;;mDAE+C;IAC/C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,CAgBlE"}

package/dist/golden/manifest.schema.json.d.ts

@@ -0,0 +1,27 @@
+declare const _default: {
+  "$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."
+      }
+    }
+  }
+}
+;
+
+export default _default;

package/dist/golden/manifestStore.d.ts

@@ -0,0 +1,33 @@
+export interface GoldenManifestEntry {
+    createdAt: string;
+    sourceOfTruthCreatedAt?: string;
+}
+export type GoldenManifest = Record<string, GoldenManifestEntry>;
+export declare function manifestPath(goldenDir: string): string;
+export declare function goldenImagePath(goldenDir: string, storyId: string): string;
+/** Returns `{}` if no manifest exists yet — a fresh adapter with no goldens
+ * captured is the normal starting state, not an error. */
+export declare function loadManifest(goldenDir: string): GoldenManifest;
+/** Validates before writing, and sorts keys so the diff on a reviewed PR is
+ * stable regardless of the order stories happened to run in. Writes to a
+ * temp file and renames over the real one — `rename` is atomic, so a
+ * concurrent `loadManifest` (running in another Playwright worker) never
+ * observes a half-written file. */
+export declare function saveManifest(goldenDir: string, manifest: GoldenManifest): void;
+/** Runs `updater` against this story's manifest entry under an exclusive
+ * lock on `manifest.json`: reloads the manifest fresh, applies `updater`,
+ * and saves it back, all before releasing the lock. Concurrent Playwright
+ * workers each own a different story, so this is the only section that
+ * needs to serialize — everything else about a story (its screenshot, its
+ * golden image file, its diff) is independent of every other story. */
+export declare function updateManifestEntry(goldenDir: string, storyId: string, updater: (entry: GoldenManifestEntry | undefined) => GoldenManifestEntry | undefined): Promise<GoldenManifestEntry | undefined>;
+export declare function saveGoldenImage(goldenDir: string, storyId: string, buffer: Buffer): void;
+/** Removes the golden `.png` + manifest entry for every story id in the
+ * manifest that isn't in `currentStoryIds` (e.g. a story renamed or deleted
+ * from Storybook) — otherwise those never get cleaned up on their own,
+ * since a run only ever adds/updates entries for stories it actually saw.
+ * Returns the pruned ids, for the caller to report. Both the file removal
+ * and the manifest delete are idempotent, so it's safe for this to run
+ * redundantly from more than one Playwright worker. */
+export declare function pruneOrphanedGoldens(goldenDir: string, currentStoryIds: ReadonlySet<string>): Promise<string[]>;
+//# sourceMappingURL=manifestStore.d.ts.map

package/dist/golden/manifestStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestStore.d.ts","sourceRoot":"","sources":["../../src/golden/manifestStore.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEjE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAMD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;0DAC0D;AAC1D,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAM9D;AAED;;;;mCAImC;AACnC,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,GACvB,IAAI,CAWN;AAqCD;;;;;uEAKuE;AACvE,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CACP,KAAK,EAAE,mBAAmB,GAAG,SAAS,KACnC,mBAAmB,GAAG,SAAS,GACnC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAe1C;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,IAAI,CAGN;AAED;;;;;;uDAMuD;AACvD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}

package/dist/golden/resolveSourceOfTruthGolden.d.ts

@@ -0,0 +1,29 @@
+import { SourceOfTruthGoldenLocation } from '../config.js';
+import { GoldenManifest } from './manifestStore.js';
+export interface SourceOfTruthGolden {
+    manifest: GoldenManifest;
+    /** Returns the golden PNG bytes for a story, or `null` if the source of
+     * truth has no golden captured for it yet. */
+    readImage(storyId: string): Promise<Buffer | null>;
+}
+/**
+ * Resolves the source-of-truth adapter's golden images for the divergence
+ * check. Never boots a Storybook — both location types resolve to plain
+ * files, fetched once and cached, not re-diffed per pixel over the wire.
+ *
+ * `location.type === "local"`: a sibling package already checked out (this
+ * monorepo's own `sourceOfTruth.type: "url"` mode) — read its
+ * `test/golden/` directly, including any uncommitted local changes.
+ *
+ * `location.type === "npm"`: no local checkout (the default, standalone-repo
+ * mode) — resolve the installed version against the npm registry, then fetch
+ * that exact version's `test/golden/` from the public GitHub repo at the
+ * matching release tag (changesets tags every release as
+ * `<packageName>@<version>`), caching what's downloaded under `cacheDir`.
+ *
+ * Returns `null` — degrading the divergence check to a skip, not a failure —
+ * when no golden baseline exists yet for this version, or the registry/repo
+ * is unreachable.
+ */
+export declare function resolveSourceOfTruthGolden(location: SourceOfTruthGoldenLocation): Promise<SourceOfTruthGolden | null>;
+//# sourceMappingURL=resolveSourceOfTruthGolden.d.ts.map

package/dist/golden/resolveSourceOfTruthGolden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSourceOfTruthGolden.d.ts","sourceRoot":"","sources":["../../src/golden/resolveSourceOfTruthGolden.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB;kDAC8C;IAC9C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpD;AAkCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,2BAA2B,GACpC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA8ErC"}

package/dist/golden/validateManifest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validates a parsed `test/golden/manifest.json` against `manifest.schema.json`.
+ * Throws with every violation listed — callers must not silently coerce or
+ * drop invalid entries.
+ */
+export declare function validateGoldenManifest(data: unknown, path: string): void;
+//# sourceMappingURL=validateManifest.d.ts.map

package/dist/golden/validateManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateManifest.d.ts","sourceRoot":"","sources":["../../src/golden/validateManifest.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYxE"}