@design-parity/action 0.1.0

package/dist/pushback.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Code-to-Canvas push-back (issue #9) — the `code-led`, Figma-only stretch.
+ *
+ * After a parity run, optionally push each candidate render back into the
+ * design tool so the design file reflects what shipped. This is **gated** three
+ * ways (docs/PRINCIPLES.md, Principle 5):
+ *
+ *   1. an explicit opt-in flag, **and**
+ *   2. the resolved direction is `code-led` (in `design-led` the design stays
+ *      canonical and code is never pushed back), **and**
+ *   3. the component's `source` is `figma`.
+ *
+ * Anything short of all three is a **no-op with a clear log line**. The actual
+ * write goes through an injected {@link CanvasWriter}; with no writer configured
+ * the run also no-ops (the Figma REST API is read-only, so a real writer needs a
+ * companion plugin / Dev Mode bridge). This module is otherwise pure: it makes
+ * no network or model calls itself.
+ */
+import type { AdapterContext, CanvasWriteResult, CanvasWriter, ResolvedDirection } from "@design-parity/core";
+import type { ParityReport } from "./orchestrate.js";
+/** Whether a run, as a whole, is eligible to push candidates back. */
+export interface PushBackGate {
+    eligible: boolean;
+    /** A clear, human-readable reason when not eligible (the no-op log line). */
+    reason?: string;
+}
+/**
+ * The overall gate: push-back runs only when explicitly opted in **and** the
+ * direction is `code-led`. Pure and deterministic — the per-component
+ * `source === "figma"` check happens during {@link pushBack}.
+ */
+export declare function decidePushBack(input: {
+    enabled: boolean;
+    direction: ResolvedDirection;
+}): PushBackGate;
+export interface PushedImage {
+    /** `state/theme/size` key of the pushed image. */
+    key: string;
+    result: CanvasWriteResult;
+}
+export interface PushBackComponent {
+    code: string;
+    pushed: PushedImage[];
+}
+export interface PushBackSkip {
+    code: string;
+    reason: string;
+}
+export interface PushBackError {
+    code: string;
+    message: string;
+}
+/** The outcome of a push-back pass over a {@link ParityReport}. */
+export interface PushBackReport {
+    /** True only when the gate let the run write at all (flag on, `code-led`, a writer). */
+    attempted: boolean;
+    /** Why the run did not attempt any write (the overall no-op log line). */
+    reason?: string;
+    pushed: PushBackComponent[];
+    skipped: PushBackSkip[];
+    /** Per-component write failures (fail-soft: never thrown). */
+    errors: PushBackError[];
+}
+export interface PushBackOptions {
+    report: ParityReport;
+    /** The explicit opt-in flag — push-back only runs when this is `true`. */
+    enabled: boolean;
+    /** Writer for the design tool; absent means no-op (no transport configured). */
+    writer?: CanvasWriter;
+    /** Context the writer resolves image paths / credentials against. */
+    ctx: AdapterContext;
+    /** Sink for the clear log lines the acceptance criteria call for. */
+    log?: (message: string) => void;
+}
+/**
+ * Run Code-to-Canvas push-back for a completed parity report. Honors the
+ * three-way gate, fails soft per component, and emits a clear log line in every
+ * branch (no-op or not). Never throws.
+ */
+export declare function pushBack(opts: PushBackOptions): Promise<PushBackReport>;
+//# sourceMappingURL=pushback.d.ts.map

package/dist/pushback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushback.d.ts","sourceRoot":"","sources":["../src/pushback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEtE,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;CAC9B,GAAG,YAAY,CAcf;AA2CD,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,8DAA8D;IAC9D,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,qEAAqE;IACrE,GAAG,EAAE,cAAc,CAAC;IACpB,qEAAqE;IACrE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkD7E"}

package/dist/pushback.js

@@ -0,0 +1,106 @@
+/**
+ * The overall gate: push-back runs only when explicitly opted in **and** the
+ * direction is `code-led`. Pure and deterministic — the per-component
+ * `source === "figma"` check happens during {@link pushBack}.
+ */
+export function decidePushBack(input) {
+    if (!input.enabled) {
+        return {
+            eligible: false,
+            reason: "Code-to-Canvas push-back is off (opt-in flag not set).",
+        };
+    }
+    if (input.direction !== "code-led") {
+        return {
+            eligible: false,
+            reason: `Code-to-Canvas push-back skipped: direction is '${input.direction}', not 'code-led' (design stays canonical).`,
+        };
+    }
+    return { eligible: true };
+}
+/** A short, stable key for one candidate image (state/theme/size). */
+function imageKey(target) {
+    const { state, theme, size } = target.image;
+    return `${state}/${theme ?? "-"}/${size ?? "-"}`;
+}
+/**
+ * The candidate images to push back for one component, or `[]` with the reason
+ * it was skipped. A component is eligible only when it diffed cleanly against a
+ * matching-source reference and carries a candidate render.
+ */
+function targetsFor(result, source) {
+    if (result.source !== source) {
+        return {
+            targets: [],
+            reason: `source is '${result.source ?? "unknown"}', not '${source}' — nothing to push back`,
+        };
+    }
+    if (result.status !== "ok") {
+        return { targets: [], reason: `component was ${result.status}, no candidate to push back` };
+    }
+    const ref = result.reference?.ref;
+    if (!ref) {
+        return { targets: [], reason: "no resolved design reference to write to" };
+    }
+    const images = result.candidate?.images ?? [];
+    if (images.length === 0) {
+        return { targets: [], reason: "no candidate render to push back" };
+    }
+    const targets = images.map((image) => ({
+        componentId: result.code,
+        source,
+        ref,
+        image,
+    }));
+    return { targets };
+}
+/**
+ * Run Code-to-Canvas push-back for a completed parity report. Honors the
+ * three-way gate, fails soft per component, and emits a clear log line in every
+ * branch (no-op or not). Never throws.
+ */
+export async function pushBack(opts) {
+    const log = opts.log ?? (() => { });
+    const gate = decidePushBack({
+        enabled: opts.enabled,
+        direction: opts.report.direction,
+    });
+    if (!gate.eligible) {
+        log(`design-parity: ${gate.reason}`);
+        return { attempted: false, reason: gate.reason, pushed: [], skipped: [], errors: [] };
+    }
+    if (!opts.writer) {
+        const reason = "Code-to-Canvas push-back is enabled (code-led), but no canvas writer is " +
+            "configured — set up a Figma bridge endpoint to push candidates back.";
+        log(`design-parity: ${reason}`);
+        return { attempted: false, reason, pushed: [], skipped: [], errors: [] };
+    }
+    const writer = opts.writer;
+    const pushed = [];
+    const skipped = [];
+    const errors = [];
+    for (const result of opts.report.results) {
+        const { targets, reason } = targetsFor(result, writer.source);
+        if (targets.length === 0) {
+            skipped.push({ code: result.code, reason: reason ?? "not eligible" });
+            continue;
+        }
+        const images = [];
+        for (const target of targets) {
+            try {
+                const written = await writer.write(target, opts.ctx);
+                images.push({ key: imageKey(target), result: written });
+            }
+            catch (err) {
+                // Fail soft: one bad write must not abort the rest or throw.
+                errors.push({ code: result.code, message: err.message });
+            }
+        }
+        if (images.length > 0)
+            pushed.push({ code: result.code, pushed: images });
+    }
+    log(`design-parity: Code-to-Canvas pushed ${pushed.length} component(s) back to ` +
+        `'${writer.source}' (${skipped.length} skipped, ${errors.length} error(s)).`);
+    return { attempted: true, pushed, skipped, errors };
+}
+//# sourceMappingURL=pushback.js.map

package/dist/pushback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushback.js","sourceRoot":"","sources":["../src/pushback.ts"],"names":[],"mappings":"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"}

package/dist/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `source → adapter` registry.
+ *
+ * Each adapter only declares a const `source`; nothing maps a {@link DesignSource}
+ * to a concrete {@link ReferenceAdapter}. That map can't live in `core` (core must
+ * not depend on adapters), so it lives here — the one place that imports all the
+ * drivers. Per-adapter options are injectable so tests and the CLI can supply
+ * credentials, output dirs, or fakes.
+ */
+import type { DesignSource, ReferenceAdapter } from "@design-parity/core";
+import { createFigmaAdapter } from "@design-parity/adapter-figma";
+import { createStitchAdapter } from "@design-parity/adapter-stitch";
+import { ClaudeDesignAdapter } from "@design-parity/adapter-claude-design";
+import { createBundleAdapter } from "@design-parity/adapter-bundle";
+export type AdapterRegistry = Record<DesignSource, ReferenceAdapter>;
+export interface RegistryOptions {
+    figma?: Parameters<typeof createFigmaAdapter>[0];
+    stitch?: Parameters<typeof createStitchAdapter>[0];
+    claudeDesign?: ConstructorParameters<typeof ClaudeDesignAdapter>[0];
+    bundle?: Parameters<typeof createBundleAdapter>[0];
+}
+/** Build the default registry wiring all reference drivers. */
+export declare function createAdapterRegistry(opts?: RegistryOptions): AdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,qBAAqB,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,eAAoB,GAAG,eAAe,CAOjF"}

package/dist/registry.js

@@ -0,0 +1,14 @@
+import { createFigmaAdapter } from "@design-parity/adapter-figma";
+import { createStitchAdapter } from "@design-parity/adapter-stitch";
+import { ClaudeDesignAdapter } from "@design-parity/adapter-claude-design";
+import { createBundleAdapter } from "@design-parity/adapter-bundle";
+/** Build the default registry wiring all reference drivers. */
+export function createAdapterRegistry(opts = {}) {
+    return {
+        figma: createFigmaAdapter(opts.figma),
+        stitch: createStitchAdapter(opts.stitch),
+        "claude-design": new ClaudeDesignAdapter(opts.claudeDesign),
+        bundle: createBundleAdapter(opts.bundle),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAWpE,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CAAC,OAAwB,EAAE;IAC9D,OAAO;QACL,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QACrC,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC;QACxC,eAAe,EAAE,IAAI,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC;QAC3D,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Render a {@link ParityReport} as the single markdown comment the bot posts on
+ * a PR (and the CLI prints). a11y + i18n lead each component's section (that
+ * ordering is owned by the diff summary); this layer adds the overall verdict,
+ * the direction-driven blocking note, and the per-component roll-up.
+ */
+import type { ParityReport } from "./orchestrate.js";
+/** Stable marker so the GitHub surface can find and update its own comment. */
+export declare const REPORT_MARKER = "<!-- design-parity-report -->";
+/**
+ * The comment posted when a PR runs against a repo that has **no committed
+ * parity setup** — no (or an empty) `design-map.json`. The unattended Action
+ * enforces committed deterministic artifacts; it never generates them at run
+ * time (Principle 1), so instead of silently guessing it points the user at the
+ * interactive bootstrap (issue #11 / the `design-parity-bootstrap` CLI).
+ *
+ * Carries the same {@link REPORT_MARKER} as a verdict comment, so it updates in
+ * place and is replaced by a real verdict on the first run after setup lands.
+ */
+export declare function renderBootstrapNotice(): string;
+/**
+ * The non-blocking Compose Multiplatform promotion shown on Android-only repos
+ * (docs/PRINCIPLES.md, Principle 6). Surfaced only when the committed
+ * `cmpCapable` flag is `false`; phrased for the PR comment (the bootstrap output
+ * has its own, longer wording). Advisory — it never changes the verdict.
+ */
+export declare const CMP_PROMOTION: string;
+export declare function renderReport(report: ParityReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrD,+EAA+E;AAC/E,eAAO,MAAM,aAAa,kCAAkC,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAgB9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAK6C,CAAC;AAExE,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAkDzD"}

package/dist/report.js

@@ -0,0 +1,72 @@
+const STATUS_ICON = { pass: "✅", warn: "⚠️", fail: "❌" };
+/** Stable marker so the GitHub surface can find and update its own comment. */
+export const REPORT_MARKER = "<!-- design-parity-report -->";
+/**
+ * The comment posted when a PR runs against a repo that has **no committed
+ * parity setup** — no (or an empty) `design-map.json`. The unattended Action
+ * enforces committed deterministic artifacts; it never generates them at run
+ * time (Principle 1), so instead of silently guessing it points the user at the
+ * interactive bootstrap (issue #11 / the `design-parity-bootstrap` CLI).
+ *
+ * Carries the same {@link REPORT_MARKER} as a verdict comment, so it updates in
+ * place and is replaced by a real verdict on the first run after setup lands.
+ */
+export function renderBootstrapNotice() {
+    return [
+        REPORT_MARKER,
+        "",
+        "# Design parity",
+        "",
+        "ℹ️ **Not set up yet** — this repo has no committed `design-map.json`, so there's nothing to check parity against (no PR is blocked).",
+        "",
+        "design-parity runs unattended on committed, deterministic artifacts and never guesses your design ↔ code mapping at run time. To set it up, run the interactive bootstrap once and commit what it generates:",
+        "",
+        "```sh",
+        "npx design-parity-bootstrap",
+        "```",
+        "",
+        "It detects your design-system maturity and seeds a starter `design-map.json`, check config, and parity direction (`.design-parity.json`). See [issue #11](https://github.com/yschimke/design-parity/issues/11) for the setup flow.",
+    ].join("\n");
+}
+/**
+ * The non-blocking Compose Multiplatform promotion shown on Android-only repos
+ * (docs/PRINCIPLES.md, Principle 6). Surfaced only when the committed
+ * `cmpCapable` flag is `false`; phrased for the PR comment (the bootstrap output
+ * has its own, longer wording). Advisory — it never changes the verdict.
+ */
+export const CMP_PROMOTION = "💡 **Tip — Compose Multiplatform.** This project looks Android-only " +
+    "(Jetpack Compose). On Compose Multiplatform it could run parity faster: the " +
+    "candidate renders on the JVM/desktop with **no Android emulator**, which is " +
+    "cheaper and easier to run unattended. Advisory only — plain Jetpack Compose " +
+    "stays fully supported. See [adopting-cmp.md](docs/adopting-cmp.md).";
+export function renderReport(report) {
+    const lines = [REPORT_MARKER];
+    const headline = report.blocked
+        ? `${STATUS_ICON.fail} **Parity check failed** — blocking (\`${report.direction}\`)`
+        : `${STATUS_ICON[report.status]} **Parity ${report.status}** (\`${report.direction}\`${report.status === "fail" ? ", advisory" : ""})`;
+    lines.push("", `# Design parity`, "", headline);
+    const checked = report.results.filter((r) => r.verdict);
+    if (checked.length === 0) {
+        lines.push("", "_No components were checked._");
+    }
+    for (const r of report.results) {
+        if (r.summary) {
+            lines.push("", "---", "", r.summary);
+        }
+        else if (r.status === "skipped") {
+            lines.push("", "---", "", `### \`${r.code}\` — skipped`, `_${r.note}._`);
+        }
+        else if (r.status === "error") {
+            lines.push("", "---", "", `### \`${r.code}\` — ⚠️ not checked`, `_Adapter/diff error (failed soft): ${r.note}._`);
+        }
+    }
+    // Promote CMP to Android-only repos (Principle 6) — non-blocking, never a gate.
+    if (report.cmpCapable === false) {
+        lines.push("", "---", "", CMP_PROMOTION);
+    }
+    if (report.warnings.length > 0) {
+        lines.push("", "---", "", "<details><summary>Warnings</summary>", "", ...report.warnings.map((w) => `- ${w}`), "", "</details>");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@design-parity/action",
+  "version": "0.1.0",
+  "description": "Integration layer: wires resolver, adapters, candidate, checks, diff, and policy into a parity run, and surfaces the verdict (CLI now; GitHub Action surface to follow).",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./run": "./dist/cli/run.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@design-parity/core": "^0.1.0",
+    "@design-parity/resolver": "^0.1.0",
+    "@design-parity/policy": "^0.1.0",
+    "@design-parity/diff": "^0.1.0",
+    "@design-parity/report-html": "^0.1.0",
+    "@design-parity/checks": "^0.1.0",
+    "@design-parity/candidate": "^0.1.0",
+    "@design-parity/adapter-figma": "^0.1.0",
+    "@design-parity/adapter-stitch": "^0.1.0",
+    "@design-parity/adapter-claude-design": "^0.1.0",
+    "@design-parity/adapter-bundle": "^0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yschimke/design-parity.git",
+    "directory": "packages/action"
+  },
+  "homepage": "https://github.com/yschimke/design-parity/tree/main/packages/action#readme",
+  "bugs": "https://github.com/yschimke/design-parity/issues"
+}