figdiff 0.0.0-stage → 0.1.0-alpha.1

package/dist/action/main.d.ts

@@ -0,0 +1,20 @@
+import { run as runFigdiff } from "../run.js";
+export interface ActionDeps {
+    git(args: string[], cwd: string): string;
+    readText(path: string): string;
+    writeText(path: string, content: string): void;
+    mkdirp(path: string): void;
+    fetch: typeof fetch;
+    run: typeof runFigdiff;
+}
+export interface ActionResult {
+    code: number;
+    log: string[];
+    comment?: "created" | "updated" | "skipped";
+    /** Number of design files with real changes. */
+    changed: number;
+}
+type Env = Record<string, string | undefined>;
+/** The entry point of the GitHub Action. Everything it needs comes in through `env` and `deps`. */
+export declare function runAction(env: Env, overrides?: Partial<ActionDeps>): Promise<ActionResult>;
+export {};

package/dist/action/main.js

@@ -0,0 +1,111 @@
+import { execFileSync } from "node:child_process";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { formatText } from "../report.js";
+import { run as runFigdiff } from "../run.js";
+import { filterByPatterns, parseNameStatus } from "./changed-files.js";
+import { buildComment, buildEmptyComment, isSubstantive } from "./comment.js";
+import { parsePatterns } from "./glob.js";
+import { findComment, GitHubError, upsertComment } from "./github.js";
+const defaultDeps = {
+    git: (args, cwd) => execFileSync("git", args, { cwd, encoding: "utf8", maxBuffer: 64 * 1024 * 1024 }),
+    readText: (p) => readFileSync(p, "utf8"),
+    writeText: (p, c) => writeFileSync(p, c),
+    mkdirp: (p) => void mkdirSync(p, { recursive: true }),
+    fetch: (...a) => fetch(...a),
+    run: runFigdiff,
+};
+function input(env, name, fallback) {
+    const v = env[`INPUT_${name.toUpperCase().replace(/-/g, "_")}`];
+    return v !== undefined && v.trim() !== "" ? v.trim() : fallback;
+}
+/** Compare one modified file with its version at the base commit. */
+function compareFile(file, root, base, reportDir, deps) {
+    const reportName = `${file.path.replace(/[^A-Za-z0-9._-]+/g, "_")}.html`;
+    const result = deps.run([join(root, file.path), "--against", base, "--json", "--html", join(reportDir, reportName)]);
+    if (result.code !== 0) {
+        const message = result.stderr.replace(/^figdiff:\s*/gm, "").trim().split("\n")[0] ?? "unknown error";
+        return { file, error: message };
+    }
+    for (const w of result.writes) {
+        deps.mkdirp(reportDir);
+        deps.writeText(w.path, w.content);
+    }
+    const parsed = JSON.parse(result.stdout);
+    return { file, summary: parsed.summary, text: formatText(parsed.changes), reportName };
+}
+/** The entry point of the GitHub Action. Everything it needs comes in through `env` and `deps`. */
+export async function runAction(env, overrides = {}) {
+    const deps = { ...defaultDeps, ...overrides };
+    const log = [];
+    const done = (code, extra = {}) => ({ code, log, changed: 0, ...extra });
+    if (!env.GITHUB_EVENT_PATH) {
+        log.push("figdiff: GITHUB_EVENT_PATH is not set. Run this action in a GitHub workflow.");
+        return done(2);
+    }
+    const event = JSON.parse(deps.readText(env.GITHUB_EVENT_PATH));
+    const pr = event.pull_request;
+    if (!pr) {
+        log.push("figdiff: this action only works on pull_request events; nothing to do.");
+        return done(0, { comment: "skipped" });
+    }
+    const root = env.GITHUB_WORKSPACE ?? process.cwd();
+    const patterns = parsePatterns(input(env, "files", "**/*.figcraft"));
+    const reportDir = input(env, "report-dir", "figdiff-reports");
+    const wantComment = input(env, "comment", "true") !== "false";
+    const maxFiles = Math.max(1, Number.parseInt(input(env, "max-files", "20"), 10) || 20);
+    let listed;
+    try {
+        listed = parseNameStatus(deps.git(["diff", "--name-status", "-z", "--no-renames", `${pr.base.sha}...${pr.head.sha}`], root));
+    }
+    catch {
+        log.push("figdiff: could not list the changed files. Check out the repository with `fetch-depth: 0` so the base commit is available.");
+        return done(2);
+    }
+    const files = filterByPatterns(listed, patterns);
+    log.push(`figdiff: ${files.length} design file(s) changed in this pull request.`);
+    const results = [];
+    for (const file of files.slice(0, maxFiles)) {
+        results.push(file.status === "modified" ? compareFile(file, root, pr.base.sha, reportDir, deps) : { file });
+    }
+    if (files.length > maxFiles)
+        log.push(`figdiff: only the first ${maxFiles} files were compared (max-files).`);
+    const changed = results.filter(isSubstantive);
+    for (const r of results)
+        log.push(`figdiff: ${r.file.path}: ${r.error ?? r.summary?.changes ?? r.file.status}`);
+    if (!wantComment)
+        return done(0, { comment: "skipped", changed: changed.length });
+    const token = env.GITHUB_TOKEN ?? env.INPUT_TOKEN;
+    const repo = env.GITHUB_REPOSITORY;
+    if (!token || !repo) {
+        log.push("figdiff: no token or repository available, so no comment was posted.");
+        return done(0, { comment: "skipped", changed: changed.length });
+    }
+    const api = { fetch: deps.fetch, baseUrl: env.GITHUB_API_URL ?? "https://api.github.com", token };
+    try {
+        const existing = await findComment(api, repo, pr.number);
+        if (changed.length === 0 && existing === undefined) {
+            log.push("figdiff: no design changes and no earlier comment; staying quiet.");
+            return done(0, { comment: "skipped" });
+        }
+        const runUrl = env.GITHUB_SERVER_URL && env.GITHUB_RUN_ID ? `${env.GITHUB_SERVER_URL}/${repo}/actions/runs/${env.GITHUB_RUN_ID}` : undefined;
+        const body = changed.length === 0
+            ? buildEmptyComment()
+            : buildComment(changed, { runUrl, reportsUploaded: input(env, "upload-reports", "true") !== "false", version: env.FIGDIFF_VERSION });
+        const outcome = await upsertComment(api, repo, pr.number, body, existing);
+        log.push(`figdiff: comment ${outcome}.`);
+        return done(0, { comment: outcome, changed: changed.length });
+    }
+    catch (err) {
+        if (err instanceof GitHubError && err.status === 403) {
+            // Pull requests from forks get a read-only token: report instead of failing the build.
+            log.push("figdiff: not allowed to comment (403). On pull requests from forks the token is read-only; the changes are in the job log.");
+            for (const r of changed)
+                log.push(`${basename(r.file.path)}:\n${r.text ?? r.error ?? r.file.status}`);
+            return done(0, { comment: "skipped", changed: changed.length });
+        }
+        log.push(`figdiff: ${err instanceof Error ? err.message : String(err)}`);
+        return done(2, { changed: changed.length });
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/action/main.js.map

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

package/dist/action.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/action.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runAction } from "./action/main.js";
+const result = await runAction(process.env);
+for (const line of result.log)
+    console.log(line);
+process.exitCode = result.code;
+//# sourceMappingURL=action.js.map

package/dist/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,GAAG;IAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { run } from "./run.js";
+const result = run(process.argv.slice(2));
+let code = result.code;
+let stderr = result.stderr;
+for (const file of result.writes) {
+    try {
+        mkdirSync(dirname(file.path), { recursive: true });
+        writeFileSync(file.path, file.content);
+    }
+    catch (err) {
+        stderr = `figdiff: cannot write ${file.path}: ${err instanceof Error ? err.message : String(err)}\n`;
+        code = 2;
+    }
+}
+process.stdout.write(result.stdout);
+process.stderr.write(stderr);
+process.exitCode = code;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;AACvB,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAE3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,yBAAyB,IAAI,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACrG,IAAI,GAAG,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC7B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC"}

package/dist/diff/diff.d.ts

@@ -0,0 +1,11 @@
+import type { Change, DesignNode } from "./types.js";
+/**
+ * Compare two design trees and list what changed.
+ *
+ * Nodes are matched by id. Fallback matching by name and path is planned
+ * for later, once id stability across saves is verified (see docs/format-notes.md).
+ *
+ * Changes come out in document order of the old tree, followed by added nodes
+ * in document order of the new tree.
+ */
+export declare function diffTrees(before: DesignNode, after: DesignNode): Change[];

package/dist/diff/diff.js

@@ -0,0 +1,68 @@
+const SEP = " › ";
+function index(root) {
+    const map = new Map();
+    const walk = (node, trail, parentId) => {
+        map.set(node.id, { node, trail, path: [root.name, ...trail].join(SEP), parentId });
+        for (const child of node.children)
+            walk(child, [...trail, child.name], node.id);
+    };
+    walk(root, [], null);
+    return map;
+}
+function sameValue(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+function diffProps(a, b) {
+    const keys = new Set([...Object.keys(a), ...Object.keys(b)]);
+    const changes = [];
+    for (const prop of [...keys].sort()) {
+        if (!sameValue(a[prop], b[prop]))
+            changes.push({ prop, from: a[prop], to: b[prop] });
+    }
+    return changes;
+}
+/** True when children present in both versions appear in a different order. */
+function childOrderChanged(old, now) {
+    const inNow = new Set(now.children.map((c) => c.id));
+    const inOld = new Set(old.children.map((c) => c.id));
+    const orderBefore = old.children.map((c) => c.id).filter((id) => inNow.has(id));
+    const orderAfter = now.children.map((c) => c.id).filter((id) => inOld.has(id));
+    return orderBefore.join(",") !== orderAfter.join(",");
+}
+/**
+ * Compare two design trees and list what changed.
+ *
+ * Nodes are matched by id. Fallback matching by name and path is planned
+ * for later, once id stability across saves is verified (see docs/format-notes.md).
+ *
+ * Changes come out in document order of the old tree, followed by added nodes
+ * in document order of the new tree.
+ */
+export function diffTrees(before, after) {
+    const a = index(before);
+    const b = index(after);
+    const changes = [];
+    for (const [id, old] of a) {
+        const now = b.get(id);
+        if (!now) {
+            changes.push({ kind: "removed", id, path: old.path, trail: old.trail, type: old.node.type });
+            continue;
+        }
+        const base = { id, path: now.path, trail: now.trail };
+        if (old.parentId !== now.parentId) {
+            changes.push({ ...base, kind: "moved", fromTrail: old.trail });
+        }
+        const props = diffProps({ name: old.node.name, type: old.node.type, ...old.node.props }, { name: now.node.name, type: now.node.type, ...now.node.props });
+        if (props.length > 0)
+            changes.push({ ...base, kind: "modified", props });
+        if (childOrderChanged(old.node, now.node))
+            changes.push({ ...base, kind: "reordered" });
+    }
+    for (const [id, now] of b) {
+        if (!a.has(id)) {
+            changes.push({ kind: "added", id, path: now.path, trail: now.trail, type: now.node.type });
+        }
+    }
+    return changes;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff/diff.js.map

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

package/dist/diff/summary.d.ts

@@ -0,0 +1,3 @@
+import type { Change, Summary } from "./types.js";
+/** Count what changed. A "frame" is a direct child of a page that contains at least one change. */
+export declare function summarize(changes: Change[]): Summary;

package/dist/diff/summary.js

@@ -0,0 +1,40 @@
+/** Count what changed. A "frame" is a direct child of a page that contains at least one change. */
+export function summarize(changes) {
+    const s = {
+        changes: 0,
+        frames: 0,
+        added: 0,
+        removed: 0,
+        moved: 0,
+        reordered: 0,
+        modifiedNodes: 0,
+        propertyChanges: 0,
+    };
+    const frames = new Set();
+    for (const c of changes) {
+        if (c.trail.length >= 2)
+            frames.add(`${c.trail[0]}\u0000${c.trail[1]}`);
+        switch (c.kind) {
+            case "added":
+                s.added++;
+                break;
+            case "removed":
+                s.removed++;
+                break;
+            case "moved":
+                s.moved++;
+                break;
+            case "reordered":
+                s.reordered++;
+                break;
+            case "modified":
+                s.modifiedNodes++;
+                s.propertyChanges += c.props.length;
+                break;
+        }
+    }
+    s.frames = frames.size;
+    s.changes = s.added + s.removed + s.moved + s.reordered + s.propertyChanges;
+    return s;
+}
+//# sourceMappingURL=summary.js.map

package/dist/diff/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/diff/summary.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,OAAiB;IACzC,MAAM,CAAC,GAAY;QACjB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,CAAC;QAChB,eAAe,EAAE,CAAC;KACnB,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,OAAO;gBACV,CAAC,CAAC,KAAK,EAAE,CAAC;gBACV,MAAM;YACR,KAAK,SAAS;gBACZ,CAAC,CAAC,OAAO,EAAE,CAAC;gBACZ,MAAM;YACR,KAAK,OAAO;gBACV,CAAC,CAAC,KAAK,EAAE,CAAC;gBACV,MAAM;YACR,KAAK,WAAW;gBACd,CAAC,CAAC,SAAS,EAAE,CAAC;gBACd,MAAM;YACR,KAAK,UAAU;gBACb,CAAC,CAAC,aAAa,EAAE,CAAC;gBAClB,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;gBACpC,MAAM;QACV,CAAC;IACH,CAAC;IAED,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IACvB,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,eAAe,CAAC;IAC5E,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/diff/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * figdiff's internal, format-independent model of a design.
+ * The FigCraft-specific parsing lives in src/parser/.
+ */
+export interface DesignNode {
+    /** Stable identifier of the node within the file. */
+    id: string;
+    /** Node type, for example "frame", "text", "rectangle". */
+    type: string;
+    /** Layer name shown in the editor. */
+    name: string;
+    /** Visual and layout properties: fills, strokes, size, position, and so on. */
+    props: Record<string, unknown>;
+    /** Children in layer order. */
+    children: DesignNode[];
+}
+export interface PropChange {
+    prop: string;
+    from: unknown;
+    to: unknown;
+}
+interface ChangeBase {
+    /** Id of the node the change is about. */
+    id: string;
+    /** Names from the page down to the node (the document name is not included). */
+    trail: string[];
+    /** `trail` joined with " › ", prefixed by the document name. */
+    path: string;
+}
+export type Change = (ChangeBase & {
+    kind: "added";
+    type: string;
+}) | (ChangeBase & {
+    kind: "removed";
+    type: string;
+}) | (ChangeBase & {
+    kind: "moved";
+    fromTrail: string[];
+}) | (ChangeBase & {
+    kind: "modified";
+    props: PropChange[];
+}) | (ChangeBase & {
+    kind: "reordered";
+});
+export interface Summary {
+    /** Total changes: added + removed + moved + reordered nodes + changed properties. */
+    changes: number;
+    /** Number of distinct top-level frames that contain at least one change. */
+    frames: number;
+    added: number;
+    removed: number;
+    moved: number;
+    reordered: number;
+    /** Number of nodes with at least one changed property. */
+    modifiedNodes: number;
+    /** Number of changed properties across all nodes. */
+    propertyChanges: number;
+}
+export {};

package/dist/diff/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diff/types.ts"],"names":[],"mappings":""}

package/dist/git.d.ts

@@ -0,0 +1,12 @@
+/** A copy of an old file version on disk, to be removed with `cleanup()`. */
+export interface GitCopy {
+    path: string;
+    cleanup(): void;
+}
+/** Runs git and returns what it printed to stdout; must throw on failure. */
+export type GitRun = (args: string[], cwd: string) => Uint8Array;
+/**
+ * Save the version of `file` found at git revision `ref` (a branch, tag or commit) to a
+ * temporary file, so it can be compared with the working copy.
+ */
+export declare function extractFromGit(ref: string, file: string, git?: GitRun): GitCopy;

package/dist/git.js

@@ -0,0 +1,32 @@
+import { execFileSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+const defaultGit = (args, cwd) => execFileSync("git", args, { cwd, maxBuffer: 512 * 1024 * 1024, stdio: ["ignore", "pipe", "pipe"] });
+/**
+ * Save the version of `file` found at git revision `ref` (a branch, tag or commit) to a
+ * temporary file, so it can be compared with the working copy.
+ */
+export function extractFromGit(ref, file, git = defaultGit) {
+    if (ref.startsWith("-"))
+        throw new Error(`Invalid git revision "${ref}"`);
+    const absolute = resolve(file);
+    const name = basename(absolute);
+    let content;
+    try {
+        // "<ref>:./<name>" is resolved relative to the directory git runs in.
+        content = git(["show", `${ref}:./${name}`], dirname(absolute));
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            throw new Error("git was not found. Install git to use --against.");
+        const detail = String(e.stderr ?? "").trim().split("\n")[0];
+        throw new Error(`Cannot read ${name} at "${ref}"${detail ? `: ${detail}` : ""}`);
+    }
+    const dir = mkdtempSync(join(tmpdir(), "figdiff-git-"));
+    const path = join(dir, name);
+    writeFileSync(path, content);
+    return { path, cleanup: () => rmSync(dir, { recursive: true, force: true }) };
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAW7D,MAAM,UAAU,GAAW,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACvC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAEtG;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY,EAAE,MAAc,UAAU;IAChF,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEhC,IAAI,OAAmB,CAAC;IACxB,IAAI,CAAC;QACH,sEAAsE;QACtE,OAAO,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAAsD,CAAC;QACjE,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,QAAQ,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/html.d.ts

@@ -0,0 +1,25 @@
+import type { Change } from "./diff/types.js";
+/**
+ * Images for one frame, as `data:image/...` URIs or http(s) URLs.
+ * A frame that exists in only one version (added or removed) has only one side.
+ */
+export interface FrameImages {
+    before?: string;
+    after?: string;
+    /** Image highlighting the pixels that differ. */
+    diff?: string;
+    /** Share of pixels that differ, from 0 to 1. */
+    changedRatio?: number;
+}
+export interface HtmlOptions {
+    title?: string;
+    beforeName?: string;
+    afterName?: string;
+    /** Optional rendered images per frame; see `frameKey`. */
+    images?: Record<string, FrameImages>;
+}
+/** Key used in `HtmlOptions.images` for a top-level frame. */
+export declare const frameKey: (page: string, frame: string) => string;
+export declare function escapeHtml(text: string): string;
+/** A single self-contained HTML page describing the changes. No network access needed to view it. */
+export declare function formatHtml(changes: Change[], options?: HtmlOptions): string;