snapdrift 0.7.0 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.8.1 - 2026-08-06
+
+### Fixes
+
+- **The root action can actually be published to the Marketplace** — its description was 130 characters, and GitHub rejects the listing at 125 or more, so ticking "Publish this Action to the GitHub Marketplace" on the `v0.8.0` release failed validation. Shortened to 115 characters, leading with "visual regression" so the listing matches what people search for. `npm run validate:actions` and `tests/marketplace-metadata.test.js` now enforce the limit against the root action; the sub-action descriptions are unaffected, since the rule only applies to the published entry point.
+
+## 0.8.0 - 2026-08-06
+
+### Features
+
+- **Root `action.yml` for the GitHub Marketplace** — SnapDrift's nine composite actions all live under `actions/*`, and Marketplace lists exactly one action per repository whose metadata file must sit at the repository root, so none of them were publishable. `ranacseruet/snapdrift@vX` is now a dispatcher action that runs the baseline pipeline with `mode: baseline` and the pull request pipeline with `mode: pr-diff`, forwarding every input and output of the corresponding wrapper. Existing `ranacseruet/snapdrift/actions/*@vX` references are unaffected and stay supported. The dispatcher pins absolute inner refs rather than `uses: ./actions/...`, because a relative `uses:` inside a composite action resolves against the caller's workspace; `tests/marketplace-metadata.test.js` fails the build if those pins drift from the package version. Released versions pin the inner ref to a commit SHA so that a consumer pinning the dispatcher to a SHA gets an immutable chain rather than a mutable tag one level down.
+- **`branding` on every action** — required for the Marketplace listing, and applied to all nine sub-actions so the metadata stays consistent if any of them is ever split into its own repository. `npm run validate:actions` now rejects a missing icon or a color outside GitHub's allowed set, and covers the root action.
+
+### Documentation
+
+- Updated the README, Integration Guide, and baseline workflow template action examples to use the current release.
+- Documented the root action as the primary entry point across the README quickstart, the Integration Guide, and the baseline workflow template, with a new "Choosing an entry point" section mapping each `mode` to its equivalent wrapper action. The documentation version contract test now covers root-action references and prose references, not just `uses:` lines for the two wrappers.
+
 ## 0.7.0 - 2026-07-26
 
 ### Features

package/README.md

@@ -3,6 +3,7 @@
 ![SnapDrift](assets/snapdrift-logo-banner.png)
 
 ![CI](https://github.com/ranacseruet/snapdrift/actions/workflows/ci.yml/badge.svg)
+[![GitHub Marketplace](https://img.shields.io/badge/marketplace-SnapDrift-purple?logo=github)](https://github.com/marketplace/actions/snapdrift)
 ![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)
 ![License: MIT](https://img.shields.io/badge/license-MIT-blue)
 
@@ -47,8 +48,9 @@ You keep ownership of checkout, build, startup, readiness, and teardown. SnapDri
 
 ```yaml
 - name: SnapDrift Baseline
-  uses: ranacseruet/snapdrift/actions/baseline@v0.4.0
+  uses: ranacseruet/snapdrift@v0.8.1
   with:
+    mode: baseline
     repo-config-path: .github/snapdrift.json
 ```
 
@@ -56,14 +58,17 @@ You keep ownership of checkout, build, startup, readiness, and teardown. SnapDri
 
 ```yaml
 - name: SnapDrift Report
-  uses: ranacseruet/snapdrift/actions/pr-diff@v0.4.0
+  uses: ranacseruet/snapdrift@v0.8.1
   with:
+    mode: pr-diff
     github-token: ${{ secrets.GITHUB_TOKEN }}
     repo-config-path: .github/snapdrift.json
 ```
 
 That is the full integration. See the [Integration Guide](docs/integration-guide.md) for workflow examples, permissions, compatibility notes, advanced overrides, and the hosted Snap backend (`provider: "snap"`).
 
+The root action dispatches on `mode`. The same pipelines are also published as standalone actions — `ranacseruet/snapdrift/actions/baseline` and `ranacseruet/snapdrift/actions/pr-diff` — along with the lower-level `capture`, `compare`, `scope`, `resolve-baseline`, `stage`, `comment`, and `enforce` actions for custom orchestration.
+
 ## Local CLI
 
 SnapDrift ships a `snapdrift` CLI for running captures, diffs, migrations, and config initialization locally against a running app — no GitHub Actions required. Use it during development to validate UI changes before pushing.

package/action.yml

@@ -0,0 +1,175 @@
+name: SnapDrift
+description: Visual regression for Playwright apps — capture routes, diff against a baseline, and report drift on pull requests.
+author: CodeSamplez
+
+branding:
+  icon: eye
+  color: purple
+
+# GitHub Marketplace lists exactly one action per repository, and its metadata file must live at
+# the repository root. This dispatcher is that entry point: it forwards to the wrapper actions
+# under `actions/`, which remain directly usable (and unchanged) for custom orchestration.
+#
+# The inner `uses:` refs are pinned to the current release rather than a relative path because
+# `uses: ./path` inside a composite action resolves against the *caller's* workspace, not the
+# action's own directory. `tests/marketplace-metadata.test.js` fails the build if those pins drift
+# from the root `package.json` version.
+#
+# The pins are commit SHAs, so that a consumer pinning this action to a SHA gets an immutable chain
+# rather than a mutable tag one level down. The SHA is the commit holding the wrapper content this
+# release ships — not the release tag itself, which a release commit cannot reference. It therefore
+# only moves when the wrappers change. The trailing comment records the release the pin was last
+# verified for, and the test requires it to match the package version, so every release has to look
+# at it. The test accepts a plain `@vX.Y.Z` tag too, for unreleased refs.
+
+inputs:
+  mode:
+    description: Which SnapDrift pipeline to run — `pr-diff` for pull request drift detection, or `baseline` to publish a baseline.
+    required: false
+    default: pr-diff
+  repo-config-path:
+    description: Path to the SnapDrift config file.
+    required: false
+    default: .github/snapdrift.json
+  route-ids:
+    description: Optional comma-separated route ids. In `pr-diff` mode, providing these skips changed-file scope detection.
+    required: false
+    default: ''
+  artifact-retention-days:
+    description: Retention period for the uploaded artifact.
+    required: false
+    default: '30'
+  github-token:
+    description: Token used to inspect pull request files, fetch baselines, and publish SnapDrift PR reports. Used in `pr-diff` mode only.
+    required: false
+    default: ${{ github.token }}
+
+  # `baseline` mode only.
+  upload-artifact:
+    description: Whether to upload the staged baseline artifact. Used in `baseline` mode only.
+    required: false
+    default: 'true'
+
+  # `pr-diff` mode only.
+  pr-number:
+    description: Optional pull request number override.
+    required: false
+    default: ''
+  force-run:
+    description: Whether to force a full run when route ids are not explicitly provided.
+    required: false
+    default: 'false'
+  force-run-reason:
+    description: Reason to report when force-run is enabled.
+    required: false
+    default: forced
+  baseline-repository:
+    description: Repository in owner/name format that publishes the baseline.
+    required: false
+    default: ''
+  baseline-workflow-id:
+    description: Workflow id or filename to search for the baseline.
+    required: false
+    default: ci.yml
+  baseline-branch:
+    description: Branch that publishes the baseline.
+    required: false
+    default: main
+  comment-on-pr:
+    description: Whether to publish the SnapDrift PR report.
+    required: false
+    default: 'true'
+  max-changed-rows:
+    description: Maximum number of changed-route rows shown in the PR comment before truncation.
+    required: false
+    default: '20'
+  max-error-rows:
+    description: Maximum number of error rows shown in the PR comment before truncation.
+    required: false
+    default: '10'
+
+outputs:
+  # Shared across both modes.
+  artifact-name:
+    description: Name of the uploaded artifact.
+    value: ${{ steps.baseline.outputs.artifact-name || steps.pr-diff.outputs.artifact-name }}
+  bundle-dir:
+    description: Staged artifact bundle directory.
+    value: ${{ steps.baseline.outputs.bundle-dir || steps.pr-diff.outputs.bundle-dir }}
+  selected-route-ids:
+    description: Comma-separated route ids selected for the run.
+    value: ${{ steps.baseline.outputs.selected-route-ids || steps.pr-diff.outputs.selected-route-ids }}
+
+  # `baseline` mode only.
+  results-file:
+    description: Absolute path to the generated baseline results file.
+    value: ${{ steps.baseline.outputs.results-file }}
+  manifest-file:
+    description: Absolute path to the generated baseline manifest file.
+    value: ${{ steps.baseline.outputs.manifest-file }}
+  screenshots-root:
+    description: Absolute path to the generated screenshots root.
+    value: ${{ steps.baseline.outputs.screenshots-root }}
+
+  # `pr-diff` mode only.
+  should-run:
+    description: Whether the SnapDrift flow ran or intentionally skipped due to scope.
+    value: ${{ steps.pr-diff.outputs.should-run }}
+  scope-reason:
+    description: Reason for the final scope decision.
+    value: ${{ steps.pr-diff.outputs.scope-reason }}
+  baseline-found:
+    description: Whether a usable baseline was found.
+    value: ${{ steps.pr-diff.outputs.baseline-found }}
+  status:
+    description: Final SnapDrift status.
+    value: ${{ steps.pr-diff.outputs.status }}
+  summary-path:
+    description: Path to the final summary JSON file.
+    value: ${{ steps.pr-diff.outputs.summary-path }}
+  markdown-path:
+    description: Path to the final summary markdown file.
+    value: ${{ steps.pr-diff.outputs.markdown-path }}
+
+runs:
+  using: composite
+  steps:
+    - name: Validate mode
+      shell: bash
+      env:
+        MODE: ${{ inputs.mode }}
+      run: |
+        set -euo pipefail
+        if [ "$MODE" != "pr-diff" ] && [ "$MODE" != "baseline" ]; then
+          echo "::error::Unsupported SnapDrift mode '$MODE'. Expected 'pr-diff' or 'baseline'."
+          exit 1
+        fi
+
+    - name: SnapDrift baseline
+      id: baseline
+      if: inputs.mode == 'baseline'
+      uses: ranacseruet/snapdrift/actions/baseline@539953ab07065be805be393d69bd3c9b6d53cf6e # v0.8.1
+      with:
+        repo-config-path: ${{ inputs.repo-config-path }}
+        route-ids: ${{ inputs.route-ids }}
+        artifact-retention-days: ${{ inputs.artifact-retention-days }}
+        upload-artifact: ${{ inputs.upload-artifact }}
+
+    - name: SnapDrift pull request diff
+      id: pr-diff
+      if: inputs.mode == 'pr-diff'
+      uses: ranacseruet/snapdrift/actions/pr-diff@539953ab07065be805be393d69bd3c9b6d53cf6e # v0.8.1
+      with:
+        github-token: ${{ inputs.github-token }}
+        repo-config-path: ${{ inputs.repo-config-path }}
+        pr-number: ${{ inputs.pr-number }}
+        route-ids: ${{ inputs.route-ids }}
+        force-run: ${{ inputs.force-run }}
+        force-run-reason: ${{ inputs.force-run-reason }}
+        baseline-repository: ${{ inputs.baseline-repository }}
+        baseline-workflow-id: ${{ inputs.baseline-workflow-id }}
+        baseline-branch: ${{ inputs.baseline-branch }}
+        artifact-retention-days: ${{ inputs.artifact-retention-days }}
+        comment-on-pr: ${{ inputs.comment-on-pr }}
+        max-changed-rows: ${{ inputs.max-changed-rows }}
+        max-error-rows: ${{ inputs.max-error-rows }}

package/actions/baseline/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Baseline
 description: Capture configured routes, stage a SnapDrift baseline, and upload it with the configured artifact name.
 
+branding:
+  icon: camera
+  color: purple
+
 inputs:
   repo-config-path:
     description: Path to the SnapDrift config file.

package/actions/capture/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Capture
 description: Capture configured SnapDrift routes and emit the standard results and manifest files.
 
+branding:
+  icon: camera
+  color: purple
+
 inputs:
   repo-config-path:
     description: Path to the SnapDrift config file.

package/actions/comment/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Comment
 description: Upsert a PR comment with the SnapDrift report.
 
+branding:
+  icon: message-square
+  color: purple
+
 inputs:
   github-token:
     description: Token used to update the pull request comment.

package/actions/compare/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Compare
 description: Compare the current capture against a baseline and emit the SnapDrift report files.
 
+branding:
+  icon: layers
+  color: purple
+
 inputs:
   repo-config-path:
     description: Path to the SnapDrift config file.

package/actions/enforce/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Enforce
 description: Evaluate the SnapDrift summary against diff.mode and fail when required.
 
+branding:
+  icon: shield
+  color: purple
+
 inputs:
   summary-path:
     description: Path to the SnapDrift summary JSON.

package/actions/pr-diff/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift PR Diff
 description: Run the end-to-end SnapDrift pull request pipeline, including scope resolution, skipped-report handling, artifact upload, PR reporting, and enforcement.
 
+branding:
+  icon: eye
+  color: purple
+
 inputs:
   github-token:
     description: Token used to inspect pull request files, fetch baselines, and publish SnapDrift PR reports.

package/actions/resolve-baseline/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Resolve Baseline
 description: Resolve and download the latest successful SnapDrift baseline from main.
 
+branding:
+  icon: download-cloud
+  color: purple
+
 inputs:
   github-token:
     description: Token used to query workflow runs and download artifacts.

package/actions/scope/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Scope
 description: Determine whether SnapDrift should run and which configured routes should be selected for the current change set.
 
+branding:
+  icon: filter
+  color: purple
+
 inputs:
   github-token:
     description: Token used to query pull request changed files.

package/actions/stage/action.yml

@@ -1,6 +1,10 @@
 name: SnapDrift Stage
 description: Stage baseline or drift artifacts into the SnapDrift bundle structure before upload.
 
+branding:
+  icon: package
+  color: purple
+
 inputs:
   artifact-type:
     description: Either baseline or diff.

package/docs/integration-guide.md

@@ -46,8 +46,9 @@ SnapDrift owns route selection, capture, comparison, skipped-report generation,
 
 ```yaml
 - name: SnapDrift Baseline
-  uses: ranacseruet/snapdrift/actions/baseline@v0.4.0
+  uses: ranacseruet/snapdrift@v0.8.1
   with:
+    mode: baseline
     repo-config-path: .github/snapdrift.json
     artifact-retention-days: '30'
 ```
@@ -70,12 +71,30 @@ Then add SnapDrift after the app is running:
 
 ```yaml
 - name: SnapDrift Report
-  uses: ranacseruet/snapdrift/actions/pr-diff@v0.4.0
+  uses: ranacseruet/snapdrift@v0.8.1
   with:
+    mode: pr-diff
     github-token: ${{ secrets.GITHUB_TOKEN }}
     repo-config-path: .github/snapdrift.json
 ```
 
+## Choosing an entry point
+
+`ranacseruet/snapdrift` is the GitHub Marketplace entry point. It is a thin dispatcher: `mode: baseline` runs the baseline pipeline and `mode: pr-diff` runs the pull request pipeline, forwarding every input and output of the underlying wrapper action.
+
+The wrappers remain published in their own right, and are equivalent to the dispatcher:
+
+| Entry point | Equivalent to |
+|-------------|---------------|
+| `ranacseruet/snapdrift@v0.8.1` with `mode: baseline` | `ranacseruet/snapdrift/actions/baseline@v0.8.1` |
+| `ranacseruet/snapdrift@v0.8.1` with `mode: pr-diff` | `ranacseruet/snapdrift/actions/pr-diff@v0.8.1` |
+
+Use the wrappers directly when you want to skip the dispatcher's input indirection, and the lower-level `capture`, `compare`, `scope`, `resolve-baseline`, `stage`, `comment`, and `enforce` actions when you need to orchestrate the stages yourself.
+
+### Pinning
+
+The dispatcher loads its wrapper from a pinned ref of this same repository. Released versions pin that ref to a commit SHA, so resolving `ranacseruet/snapdrift` to a SHA freezes the whole chain. If you are consuming an unreleased ref (`@main`, or a branch), the inner ref is a tag instead, and a SHA pin on the dispatcher does not freeze what it delegates to — pin the wrapper actions directly if that matters to you.
+
 ## Example workflow (Node app)
 
 ```yaml
@@ -111,8 +130,9 @@ jobs:
           done
 
       - name: SnapDrift Report
-        uses: ranacseruet/snapdrift/actions/pr-diff@v0.4.0
+        uses: ranacseruet/snapdrift@v0.8.1
         with:
+          mode: pr-diff
           github-token: ${{ secrets.GITHUB_TOKEN }}
           repo-config-path: .github/snapdrift.json
 ```
@@ -150,8 +170,9 @@ jobs:
           done
 
       - name: SnapDrift Report
-        uses: ranacseruet/snapdrift/actions/pr-diff@v0.4.0
+        uses: ranacseruet/snapdrift@v0.8.1
         with:
+          mode: pr-diff
           github-token: ${{ secrets.GITHUB_TOKEN }}
           repo-config-path: .github/snapdrift.json
 ```

package/docs/workflow-templates/refresh-baseline-on-merge.yml

@@ -70,8 +70,9 @@ jobs:
       # ────────────────────────────────────────────────────────────────────────
 
       - name: Publish SnapDrift baseline
-        uses: ranacseruet/snapdrift/actions/baseline@v0.4.0
+        uses: ranacseruet/snapdrift@v0.8.1
         with:
+          mode: baseline
           repo-config-path: .github/snapdrift.json
           artifact-retention-days: '30'
 

package/lib/init-from-action.mjs

@@ -5,6 +5,7 @@ import path from 'node:path';
 import * as yaml from 'js-yaml';
 
 /** @typedef {import('../types/visual-diff-types').InitWarning} InitWarning */
+/** @typedef {import('../types/visual-diff-types').JsonObject} JsonObject */
 
 const DEFAULT_OUTPUT_DIR = '.github';
 const DEFAULT_CONFIG_FILENAME = 'snapdrift.json';
@@ -13,8 +14,8 @@ const MIGRATION_NOTES_FILENAME = 'MIGRATION_NOTES.md';
 /**
  * Find the step that uses the Snap visual testing action.
  *
- * @param {object} workflow - Parsed YAML workflow
- * @returns {{ step: object, jobName: string, stepIndex: number } | null}
+ * @param {JsonObject} workflow - Parsed YAML workflow
+ * @returns {{ step: JsonObject, jobName: string, stepIndex: number } | null}
  */
 function findSnapActionStep(workflow) {
   const jobs = workflow.jobs || {};
@@ -34,7 +35,7 @@ function findSnapActionStep(workflow) {
 /**
  * Map Snap action enforcement mode to snapdrift diff.mode.
  *
- * @param {object} inputs
+ * @param {JsonObject} inputs
  * @returns {string}
  */
 function mapDiffMode(inputs) {
@@ -52,7 +53,7 @@ function mapDiffMode(inputs) {
 /**
  * Extract Snap action inputs and translate to snapdrift config fields.
  *
- * @param {object} step - The workflow step using the Snap action
+ * @param {JsonObject} step - The workflow step using the Snap action
  * @returns {{ config: object, warnings: InitWarning[] }}
  */
 function translateStepToConfig(step) {
@@ -87,7 +88,7 @@ function translateStepToConfig(step) {
   }
 
   // Snap provider config (if present in inputs)
-  /** @type {object | undefined} */
+  /** @type {JsonObject | undefined} */
   let snap;
   const snapApiUrl = inputs['snap-api-url'] || inputs.snap_api_url;
   const snapApiKeyEnv = inputs['snap-api-key-env'] || inputs.snap_api_key_env;
@@ -195,10 +196,11 @@ export async function runInitFromAction(actionYamlPath) {
     throw new Error(`Cannot read workflow file: ${actionYamlPath}`);
   }
 
-  const workflow = yaml.load(workflowContent);
-  if (!workflow || typeof workflow !== 'object') {
+  const parsedWorkflow = yaml.load(workflowContent);
+  if (!parsedWorkflow || typeof parsedWorkflow !== 'object') {
     throw new Error(`Invalid workflow YAML: ${actionYamlPath}`);
   }
+  const workflow = /** @type {JsonObject} */ (parsedWorkflow);
 
   // Find the Snap action step
   const snapStep = findSnapActionStep(workflow);

package/lib/migrate-baselines.mjs

@@ -6,6 +6,8 @@ import path from 'node:path';
 
 import { createProvider } from './provider.mjs';
 
+/** @typedef {import('../types/visual-diff-types').JsonObject} JsonObject */
+
 /**
  * Resolve the current commit HEAD SHA.
  * Tries GITHUB_SHA first, then git rev-parse HEAD.
@@ -28,7 +30,7 @@ function resolveHeadSha() {
  * Read local baseline files from a directory.
  *
  * @param {string} baselineDir
- * @returns {Promise<{ results: object, manifest: object, screenshots: Array<{ filename: string, data: string }>, headSha: string }>}
+ * @returns {Promise<{ results: JsonObject, manifest: JsonObject, screenshots: Array<{ filename: string, data: string }>, headSha: string }>}
  */
 export async function readLocalBaselines(baselineDir) {
   const resultsPath = path.join(baselineDir, 'results.json');
@@ -130,7 +132,7 @@ export async function runMigrateToLocal(config, opts) {
   const provider = createProvider('snap', config);
   const baselineDir = opts.baselineDir;
 
-  /** @type {{ results: object, manifest: object, screenshots: Array<{ filename: string, data: Buffer }>, engine: { name: string, version: string } }} */
+  /** @type {{ results: JsonObject, manifest: JsonObject, screenshots: Array<{ filename: string, data: Buffer }>, engine: { name: string, version: string } }} */
   let exported;
   try {
     exported = await provider.exportBaselines();

package/lib/snap-provider.mjs

@@ -23,6 +23,7 @@ import { selectConfiguredRoutes, splitCommaList, determineDriftStatus, VIEWPORT_
 /** @typedef {import('../types/visual-diff-types').ProviderBaselineData} BaselineData */
 /** @typedef {import('../types/visual-diff-types').SnapConfig} SnapConfig */
 /** @typedef {import('../types/visual-diff-types').VisualRegressionConfig} VisualRegressionConfig */
+/** @typedef {import('../types/visual-diff-types').JsonObject} JsonObject */
 
 const DEFAULT_API_URL = 'https://snap.i2dev.com';
 const MAX_RETRIES = 3;
@@ -667,8 +668,8 @@ export class SnapProvider {
    *
    * @param {{ tag?: string }} [_options]
    * @returns {Promise<{
-   *   results: object,
-   *   manifest: object,
+   *   results: JsonObject,
+   *   manifest: JsonObject,
    *   screenshots: Array<{ filename: string, data: Buffer }>,
    *   engine: { name: string, version: string }
    * }>}
@@ -751,7 +752,7 @@ export class SnapProvider {
 
     /** @type {Array<{ filename: string, data: Buffer }>} */
     const screenshots = [];
-    /** @type {Array<object>} */
+    /** @type {JsonObject[]} */
     const manifestEntries = [];
 
     for (const route of routes) {
@@ -1209,7 +1210,7 @@ export class SnapProvider {
   /**
    * Poll a run until it reaches a terminal state.
    * @param {string} runId
-   * @returns {Promise<object>}
+   * @returns {Promise<JsonObject>}
    */
   async #pollRun(runId) {
     const startTime = Date.now();
@@ -1229,7 +1230,7 @@ export class SnapProvider {
 
   /**
    * Map a Snap run result to a VisualDiffSummary.
-   * @param {object} run
+   * @param {JsonObject} run
    * @param {VisualRegressionConfig} config
    * @returns {import('../types/visual-diff-types').VisualDiffSummary}
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snapdrift",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "private": false,
   "type": "module",
   "description": "SnapDrift captures, compares, and reports UI drift for Playwright-based app checks.",
@@ -46,7 +46,7 @@
     "eslint": "^10.2.0",
     "globals": "^17.4.0",
     "jest": "^30.3.0",
-    "typescript": "^6.0.2"
+    "typescript": "^7.0.2"
   },
   "jest": {
     "testEnvironment": "node",
@@ -82,6 +82,7 @@
     "./lib/init-from-action.mjs": "./lib/init-from-action.mjs"
   },
   "files": [
+    "action.yml",
     "actions/",
     "bin/",
     "lib/",

package/types/visual-diff-types.d.ts

@@ -1,3 +1,6 @@
+/** Object-shaped data decoded from an external JSON or YAML boundary. */
+export type JsonObject = Record<string, any>;
+
 export type VisualViewportPreset = 'desktop' | 'mobile';
 export interface VisualCustomViewport { width: number; height: number; }
 export type VisualViewport = VisualViewportPreset | VisualCustomViewport;
@@ -166,8 +169,8 @@ export interface MigrateToSnapResult {
 }
 
 export interface ExportedBaseline {
-  results: object;
-  manifest: object;
+  results: JsonObject;
+  manifest: JsonObject;
   screenshots: Array<{ filename: string; data: Buffer }>;
   engine: { name: string; version: string };
 }