@syntax-syllogism/flow-delta 0.5.1 → 0.6.1

package/dist/flexipage-github-report.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+
+// src/ci/flexipage-github-report.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { parseArgs } from "node:util";
+
+// src/util/is-main-module.ts
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+function isMainModule(metaUrl, argvPath = process.argv[1]) {
+  if (!argvPath) {
+    return false;
+  }
+  try {
+    return realpathSync(fileURLToPath(metaUrl)) === realpathSync(argvPath);
+  } catch {
+    return false;
+  }
+}
+
+// src/ci/report-core.ts
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+
+// src/render/snapshot-panel.ts
+var COLLECTION_KEY_NAMES = [
+  "assignmentItems",
+  "choiceReferences",
+  "choices",
+  "conditions",
+  "customErrorMessages",
+  "dataTypeMappings",
+  "fields",
+  "filters",
+  "inputAssignments",
+  "inputParameters",
+  "outputParameters",
+  "outputAssignments",
+  "processMetadataValues",
+  "rules",
+  "scheduledPaths",
+  "sortOptions",
+  "stageSteps",
+  "steps",
+  "storeOutputParameters",
+  "transformValues",
+  "valueMappings",
+  "waitEvents"
+];
+var COLLECTION_KEYS = new Set(COLLECTION_KEY_NAMES);
+
+// src/util/file-name.ts
+function safeFileName(value) {
+  return value.replace(/[^a-zA-Z0-9._-]+/g, "_");
+}
+
+// src/ci/report-core.ts
+var FLEXIPAGE_MARKER = "<!-- FlexiPageDelta:report -->";
+function loadArtifactUrls(path) {
+  if (!path || !existsSync(path)) {
+    return {};
+  }
+  const raw = readFileSync(path, "utf8").trim();
+  if (!raw) {
+    return {};
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return {};
+    }
+    return Object.fromEntries(
+      Object.entries(parsed).filter(
+        (entry) => typeof entry[1] === "string" && (entry[1].startsWith("https://") || entry[1].startsWith("http://"))
+      )
+    );
+  } catch {
+    return {};
+  }
+}
+function resolveArtifactUrl(stem, urls, fallback) {
+  return urls[`${stem}.html`] ?? fallback;
+}
+function buildProductComment(results, vocabulary, opts = {}) {
+  const sorted = [...results].sort((left, right) => vocabulary.sortName(left).localeCompare(vocabulary.sortName(right)));
+  const lines = [opts.marker ?? vocabulary.marker, "", vocabulary.heading(sorted.length), ""];
+  if (sorted.length === 0) lines.push(vocabulary.empty);
+  else lines.push(vocabulary.columns, vocabulary.separator, ...sorted.map(vocabulary.row));
+  if (opts.commitSha) lines.push("", `Commit: \`${opts.commitSha.slice(0, 7)}\``);
+  return lines.join("\n");
+}
+function isZeroPageSummary(summary) {
+  return summary.addedComponents === 0 && summary.removedComponents === 0 && summary.modifiedComponents === 0 && summary.addedRegions === 0 && summary.removedRegions === 0 && summary.modifiedRegions === 0 && summary.changedPageAttributes === 0;
+}
+function readFlexiPageResults(inputDir) {
+  return readdirSync(inputDir).filter((file) => file.endsWith(".diff.json")).map((file) => {
+    const diff = JSON.parse(readFileSync(join(inputDir, file), "utf8"));
+    if (isZeroPageSummary(diff.summary)) return null;
+    return { pageName: diff.pageName, summary: diff.summary, pageChanges: diff.pageChanges, stem: safeFileName(diff.pageName) };
+  }).filter((value) => value !== null);
+}
+function buildFlexiPageComment(results, opts = {}) {
+  return buildProductComment(results, {
+    marker: FLEXIPAGE_MARKER,
+    heading: (count) => `## \u{1F50D} FlexiPageDelta \u2014 ${count} page(s) changed`,
+    empty: "_No FlexiPage changes in this MR._",
+    columns: "| Page | Components (+/\u2013/~) | Regions (+/\u2013/~) | Page attributes | Diff |",
+    separator: "| --- | ---: | ---: | --- | --- |",
+    sortName: (result) => result.pageName,
+    row: (result) => {
+      const callout = result.pageChanges?.find((change) => change.path === "template");
+      const attributes = callout ? `Template: ${formatValue(callout.before)} \u2192 ${formatValue(callout.after)}` : String(result.summary.changedPageAttributes);
+      return `| ${escapeTableCell(result.pageName)} | +${result.summary.addedComponents} / \u2212${result.summary.removedComponents} / ~${result.summary.modifiedComponents} | +${result.summary.addedRegions} / \u2212${result.summary.removedRegions} / ~${result.summary.modifiedRegions} | ${escapeTableCell(attributes)} | [Open interactive diff](${result.artifactUrl}) |`;
+    }
+  }, opts);
+}
+function formatValue(value) {
+  return value === void 0 ? "(missing)" : String(value);
+}
+function findStickyNote(notes, marker, authorId) {
+  return notes.find((note) => note.body.includes(marker) && (authorId === void 0 || note.author?.id === authorId));
+}
+function escapeTableCell(value) {
+  return value.replaceAll("|", "\\|").replaceAll("`", "\\`").replace(/\r?\n/g, "<br>");
+}
+
+// src/ci/flexipage-github-report.ts
+var buildComment = buildFlexiPageComment;
+var isZeroSummary = isZeroPageSummary;
+function artifactUrl(env) {
+  return `${env.serverUrl.replace(/\/+$/, "")}/${env.owner}/${env.repo}/actions/runs/${env.runId}`;
+}
+async function upsertComment(env, body, fetchImpl = fetch) {
+  const headers = { Authorization: `Bearer ${env.token}`, Accept: "application/vnd.github+json", "X-GitHub-Api-Version": "2022-11-28", "Content-Type": "application/json" };
+  const comments = await requestJson(fetchImpl, `${env.apiUrl}/repos/${env.owner}/${env.repo}/issues/${env.prNumber}/comments?per_page=100`, { headers });
+  const sticky = findStickyNote(comments.map((comment) => ({ id: comment.id, body: comment.body })), env.marker ?? FLEXIPAGE_MARKER);
+  await requestJson(fetchImpl, `${env.apiUrl}/repos/${env.owner}/${env.repo}/issues/${env.prNumber}/comments${sticky ? `/${sticky.id}` : ""}`, { method: sticky ? "PATCH" : "POST", headers, body: JSON.stringify({ body }) });
+}
+async function main(argv = process.argv.slice(2)) {
+  try {
+    const values = parseArgs({ args: argv, options: { in: { type: "string" }, "api-url": { type: "string" }, repo: { type: "string" }, pr: { type: "string" }, "server-url": { type: "string" }, "run-id": { type: "string" }, token: { type: "string" }, "commit-sha": { type: "string" }, "artifact-urls": { type: "string" }, marker: { type: "string" }, help: { type: "boolean", short: "h" } }, allowPositionals: false }).values;
+    if (values.help) {
+      console.log("Usage: flexipage-delta-github --in <flexipage-delta-out> [...GitHub options]");
+      return;
+    }
+    const inputDir = values.in ?? process.env.FLOW_LENS_OUT_DIR ?? "./flexipage-delta-out";
+    const records = readFlexiPageResults(inputDir);
+    if (!records.length) return;
+    const pr = typeof values.pr === "string" ? values.pr : resolvePrNumber();
+    if (!pr) {
+      console.error("No pull request number resolved; skipping GitHub comment.");
+      return;
+    }
+    const env = resolveEnv(values, pr);
+    const urls = loadArtifactUrls(typeof values["artifact-urls"] === "string" ? values["artifact-urls"] : void 0);
+    const fallback = artifactUrl(env);
+    const results = records.map((record) => ({ pageName: record.pageName, summary: record.summary, pageChanges: record.pageChanges, artifactUrl: resolveArtifactUrl(record.stem, urls, fallback) }));
+    await upsertComment(env, buildFlexiPageComment(results, { marker: env.marker, commitSha: env.commitSha }));
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+  }
+}
+function resolvePrNumber() {
+  const path = process.env.GITHUB_EVENT_PATH;
+  if (!path) return void 0;
+  try {
+    const event = JSON.parse(readFileSync2(path, "utf8"));
+    return typeof event.pull_request?.number === "number" ? String(event.pull_request.number) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function resolveEnv(values, prNumber) {
+  const required = (value, name) => {
+    if (typeof value !== "string" || !value) throw new Error(`Missing required value: ${name}`);
+    return value;
+  };
+  const full = required(values.repo ?? process.env.GITHUB_REPOSITORY, "GITHUB_REPOSITORY").split("/");
+  if (full.length !== 2) throw new Error("Invalid repo (expected owner/repo)");
+  return { apiUrl: typeof (values["api-url"] ?? process.env.GITHUB_API_URL) === "string" ? values["api-url"] ?? process.env.GITHUB_API_URL : "https://api.github.com", owner: full[0], repo: full[1], prNumber, serverUrl: typeof (values["server-url"] ?? process.env.GITHUB_SERVER_URL) === "string" ? values["server-url"] ?? process.env.GITHUB_SERVER_URL : "https://github.com", runId: required(values["run-id"] ?? process.env.GITHUB_RUN_ID, "GITHUB_RUN_ID"), token: required(values.token ?? process.env.GITHUB_TOKEN, "GITHUB_TOKEN"), commitSha: typeof (values["commit-sha"] ?? process.env.GITHUB_SHA) === "string" ? values["commit-sha"] ?? process.env.GITHUB_SHA : void 0, marker: typeof values.marker === "string" ? values.marker : FLEXIPAGE_MARKER };
+}
+async function requestJson(fetchImpl, url, init) {
+  const response = await fetchImpl(url, init);
+  const body = await response.text();
+  if (!response.ok) throw new Error(`${url} failed: ${response.status} ${body}`);
+  return body ? JSON.parse(body) : void 0;
+}
+if (isMainModule(import.meta.url)) void main();
+export {
+  artifactUrl,
+  buildComment,
+  isZeroSummary,
+  main,
+  upsertComment
+};

package/dist/flexipage-gitlab-report.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+// src/ci/flexipage-gitlab-report.ts
+import { parseArgs } from "node:util";
+
+// src/util/is-main-module.ts
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+function isMainModule(metaUrl, argvPath = process.argv[1]) {
+  if (!argvPath) {
+    return false;
+  }
+  try {
+    return realpathSync(fileURLToPath(metaUrl)) === realpathSync(argvPath);
+  } catch {
+    return false;
+  }
+}
+
+// src/ci/report-core.ts
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+
+// src/render/snapshot-panel.ts
+var COLLECTION_KEY_NAMES = [
+  "assignmentItems",
+  "choiceReferences",
+  "choices",
+  "conditions",
+  "customErrorMessages",
+  "dataTypeMappings",
+  "fields",
+  "filters",
+  "inputAssignments",
+  "inputParameters",
+  "outputParameters",
+  "outputAssignments",
+  "processMetadataValues",
+  "rules",
+  "scheduledPaths",
+  "sortOptions",
+  "stageSteps",
+  "steps",
+  "storeOutputParameters",
+  "transformValues",
+  "valueMappings",
+  "waitEvents"
+];
+var COLLECTION_KEYS = new Set(COLLECTION_KEY_NAMES);
+
+// src/util/file-name.ts
+function safeFileName(value) {
+  return value.replace(/[^a-zA-Z0-9._-]+/g, "_");
+}
+
+// src/ci/report-core.ts
+var FLEXIPAGE_MARKER = "<!-- FlexiPageDelta:report -->";
+function buildProductComment(results, vocabulary, opts = {}) {
+  const sorted = [...results].sort((left, right) => vocabulary.sortName(left).localeCompare(vocabulary.sortName(right)));
+  const lines = [opts.marker ?? vocabulary.marker, "", vocabulary.heading(sorted.length), ""];
+  if (sorted.length === 0) lines.push(vocabulary.empty);
+  else lines.push(vocabulary.columns, vocabulary.separator, ...sorted.map(vocabulary.row));
+  if (opts.commitSha) lines.push("", `Commit: \`${opts.commitSha.slice(0, 7)}\``);
+  return lines.join("\n");
+}
+function isZeroPageSummary(summary) {
+  return summary.addedComponents === 0 && summary.removedComponents === 0 && summary.modifiedComponents === 0 && summary.addedRegions === 0 && summary.removedRegions === 0 && summary.modifiedRegions === 0 && summary.changedPageAttributes === 0;
+}
+function readFlexiPageResults(inputDir) {
+  return readdirSync(inputDir).filter((file) => file.endsWith(".diff.json")).map((file) => {
+    const diff = JSON.parse(readFileSync(join(inputDir, file), "utf8"));
+    if (isZeroPageSummary(diff.summary)) return null;
+    return { pageName: diff.pageName, summary: diff.summary, pageChanges: diff.pageChanges, stem: safeFileName(diff.pageName) };
+  }).filter((value) => value !== null);
+}
+function buildFlexiPageComment(results, opts = {}) {
+  return buildProductComment(results, {
+    marker: FLEXIPAGE_MARKER,
+    heading: (count) => `## \u{1F50D} FlexiPageDelta \u2014 ${count} page(s) changed`,
+    empty: "_No FlexiPage changes in this MR._",
+    columns: "| Page | Components (+/\u2013/~) | Regions (+/\u2013/~) | Page attributes | Diff |",
+    separator: "| --- | ---: | ---: | --- | --- |",
+    sortName: (result) => result.pageName,
+    row: (result) => {
+      const callout = result.pageChanges?.find((change) => change.path === "template");
+      const attributes = callout ? `Template: ${formatValue(callout.before)} \u2192 ${formatValue(callout.after)}` : String(result.summary.changedPageAttributes);
+      return `| ${escapeTableCell(result.pageName)} | +${result.summary.addedComponents} / \u2212${result.summary.removedComponents} / ~${result.summary.modifiedComponents} | +${result.summary.addedRegions} / \u2212${result.summary.removedRegions} / ~${result.summary.modifiedRegions} | ${escapeTableCell(attributes)} | [Open interactive diff](${result.artifactUrl}) |`;
+    }
+  }, opts);
+}
+function formatValue(value) {
+  return value === void 0 ? "(missing)" : String(value);
+}
+function findStickyNote(notes, marker, authorId) {
+  return notes.find((note) => note.body.includes(marker) && (authorId === void 0 || note.author?.id === authorId));
+}
+function normalizePath(value) {
+  return value.replaceAll("\\", "/").replace(/^\.\/+/, "").replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function escapeTableCell(value) {
+  return value.replaceAll("|", "\\|").replaceAll("`", "\\`").replace(/\r?\n/g, "<br>");
+}
+
+// src/ci/flexipage-gitlab-report.ts
+var buildComment = buildFlexiPageComment;
+var isZeroSummary = isZeroPageSummary;
+function artifactUrl(env, relPath, stem) {
+  const base = env.projectUrl.replace(/\/+$/, "");
+  const path = [normalizePath(relPath), `${stem}.html`].filter(Boolean).flatMap((part) => part.split("/").filter(Boolean)).map(encodeURIComponent).join("/");
+  return `${base}/-/jobs/${env.jobId}/artifacts/file/${path}`;
+}
+async function upsertComment(env, body, fetchImpl = fetch) {
+  const headers = { "PRIVATE-TOKEN": env.token, "Content-Type": "application/json" };
+  const user = await requestJson(fetchImpl, `${env.apiUrl}/user`, { headers });
+  const notes = await requestJson(fetchImpl, `${env.apiUrl}/projects/${env.projectId}/merge_requests/${env.mergeRequestIid}/notes?per_page=100`, { headers });
+  const marker = env.marker ?? FLEXIPAGE_MARKER;
+  const sticky = findStickyNote(notes, marker, user.id);
+  await requestJson(fetchImpl, `${env.apiUrl}/projects/${env.projectId}/merge_requests/${env.mergeRequestIid}${sticky ? `/notes/${sticky.id}` : "/notes"}`, { method: sticky ? "PUT" : "POST", headers, body: JSON.stringify({ body }) });
+}
+async function main(argv = process.argv.slice(2)) {
+  try {
+    const values = parseArgs({ args: argv, options: { in: { type: "string" }, "api-url": { type: "string" }, "project-id": { type: "string" }, "mr-iid": { type: "string" }, "project-url": { type: "string" }, "job-id": { type: "string" }, token: { type: "string" }, "commit-sha": { type: "string" }, marker: { type: "string" }, help: { type: "boolean", short: "h" } }, allowPositionals: false }).values;
+    if (values.help) {
+      console.log("Usage: flexipage-delta-gitlab --in <flexipage-delta-out> [...GitLab options]");
+      return;
+    }
+    const inputDir = values.in ?? process.env.FLOW_LENS_OUT_DIR ?? "./flexipage-delta-out";
+    const records = readFlexiPageResults(inputDir);
+    if (!records.length) return;
+    const env = resolveEnv(values);
+    const results = records.map((record) => ({ pageName: record.pageName, summary: record.summary, pageChanges: record.pageChanges, artifactUrl: artifactUrl(env, inputDir, record.stem) }));
+    await upsertComment(env, buildFlexiPageComment(results, { marker: env.marker, commitSha: env.commitSha }));
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+  }
+}
+function resolveEnv(values) {
+  const required = (value, name) => {
+    if (typeof value !== "string" || !value) throw new Error(`Missing required value: ${name}`);
+    return value;
+  };
+  const commitSha = values["commit-sha"] ?? process.env.CI_COMMIT_SHA;
+  return { apiUrl: required(values["api-url"] ?? process.env.CI_API_V4_URL, "CI_API_V4_URL"), projectId: required(values["project-id"] ?? process.env.CI_PROJECT_ID, "CI_PROJECT_ID"), mergeRequestIid: required(values["mr-iid"] ?? process.env.CI_MERGE_REQUEST_IID, "CI_MERGE_REQUEST_IID"), projectUrl: required(values["project-url"] ?? process.env.CI_PROJECT_URL, "CI_PROJECT_URL"), jobId: required(values["job-id"] ?? process.env.CI_JOB_ID, "CI_JOB_ID"), token: required(values.token ?? process.env.FlowDelta_GITLAB_TOKEN, "FlowDelta_GITLAB_TOKEN"), commitSha: typeof commitSha === "string" ? commitSha : void 0, marker: typeof values.marker === "string" ? values.marker : FLEXIPAGE_MARKER };
+}
+async function requestJson(fetchImpl, url, init) {
+  const response = await fetchImpl(url, init);
+  const body = await response.text();
+  if (!response.ok) throw new Error(`${url} failed: ${response.status} ${body}`);
+  return body ? JSON.parse(body) : void 0;
+}
+if (isMainModule(import.meta.url)) void main();
+export {
+  artifactUrl,
+  buildComment,
+  isZeroSummary,
+  main,
+  upsertComment
+};

package/dist/github-report.js

@@ -85,25 +85,18 @@ function safeFileName(value) {
 // src/ci/report-core.ts
 var DEFAULT_MARKER = "<!-- FlowDelta:report -->";
 function buildComment(results, opts = {}) {
-  const marker = opts.marker ?? DEFAULT_MARKER;
-  const sorted = [...results].sort((left, right) => left.flowName.localeCompare(right.flowName));
-  const lines = [marker, "", `## \u{1F50D} FlowDelta \u2014 ${sorted.length} flow(s) changed`, ""];
-  if (sorted.length === 0) {
-    lines.push("_No Flow changes in this MR._");
-  } else {
-    lines.push("| Flow | +nodes | -nodes | ~nodes | +/-edges | Flow | Diff |");
-    lines.push("| --- | ---: | ---: | ---: | ---: | --- | --- |");
-    for (const result of sorted) {
+  return buildProductComment(results, {
+    marker: DEFAULT_MARKER,
+    heading: (count) => `## \u{1F50D} FlowDelta \u2014 ${count} flow(s) changed`,
+    empty: "_No Flow changes in this MR._",
+    columns: "| Flow | +nodes | -nodes | ~nodes | +/-edges | Flow | Diff |",
+    separator: "| --- | ---: | ---: | ---: | ---: | --- | --- |",
+    sortName: (result) => result.flowName,
+    row: (result) => {
       const flowSummary = escapeTableCell(formatFlowChanges(result.flowChanges));
-      lines.push(
-        `| ${escapeTableCell(result.flowName)} | ${result.summary.addedNodes} | ${result.summary.removedNodes} | ${result.summary.modifiedNodes} | ${result.summary.addedEdges} / ${result.summary.removedEdges} | ${flowSummary} | [Open interactive diff](${result.artifactUrl}) |`
-      );
+      return `| ${escapeTableCell(result.flowName)} | ${result.summary.addedNodes} | ${result.summary.removedNodes} | ${result.summary.modifiedNodes} | ${result.summary.addedEdges} / ${result.summary.removedEdges} | ${flowSummary} | [Open interactive diff](${result.artifactUrl}) |`;
     }
-  }
-  if (opts.commitSha) {
-    lines.push("", `Commit: \`${opts.commitSha.slice(0, 7)}\``);
-  }
-  return lines.join("\n");
+  }, opts);
 }
 function readResults(inputDir) {
   return readdirSync(inputDir).filter((file) => file.endsWith(".diff.json")).map((file) => {
@@ -147,6 +140,14 @@ function resolveArtifactUrl(stem, urls, fallback) {
 function isZeroSummary(summary) {
   return summary.addedNodes === 0 && summary.removedNodes === 0 && summary.modifiedNodes === 0 && summary.addedEdges === 0 && summary.removedEdges === 0 && summary.changedFlowAttributes === 0;
 }
+function buildProductComment(results, vocabulary, opts = {}) {
+  const sorted = [...results].sort((left, right) => vocabulary.sortName(left).localeCompare(vocabulary.sortName(right)));
+  const lines = [opts.marker ?? vocabulary.marker, "", vocabulary.heading(sorted.length), ""];
+  if (sorted.length === 0) lines.push(vocabulary.empty);
+  else lines.push(vocabulary.columns, vocabulary.separator, ...sorted.map(vocabulary.row));
+  if (opts.commitSha) lines.push("", `Commit: \`${opts.commitSha.slice(0, 7)}\``);
+  return lines.join("\n");
+}
 function findStickyNote(notes, marker, authorId) {
   return notes.find((note) => note.body.includes(marker) && (authorId === void 0 || note.author?.id === authorId));
 }

package/dist/gitlab-report.js

@@ -84,25 +84,18 @@ function safeFileName(value) {
 // src/ci/report-core.ts
 var DEFAULT_MARKER = "<!-- FlowDelta:report -->";
 function buildComment(results, opts = {}) {
-  const marker = opts.marker ?? DEFAULT_MARKER;
-  const sorted = [...results].sort((left, right) => left.flowName.localeCompare(right.flowName));
-  const lines = [marker, "", `## \u{1F50D} FlowDelta \u2014 ${sorted.length} flow(s) changed`, ""];
-  if (sorted.length === 0) {
-    lines.push("_No Flow changes in this MR._");
-  } else {
-    lines.push("| Flow | +nodes | -nodes | ~nodes | +/-edges | Flow | Diff |");
-    lines.push("| --- | ---: | ---: | ---: | ---: | --- | --- |");
-    for (const result of sorted) {
+  return buildProductComment(results, {
+    marker: DEFAULT_MARKER,
+    heading: (count) => `## \u{1F50D} FlowDelta \u2014 ${count} flow(s) changed`,
+    empty: "_No Flow changes in this MR._",
+    columns: "| Flow | +nodes | -nodes | ~nodes | +/-edges | Flow | Diff |",
+    separator: "| --- | ---: | ---: | ---: | ---: | --- | --- |",
+    sortName: (result) => result.flowName,
+    row: (result) => {
       const flowSummary = escapeTableCell(formatFlowChanges(result.flowChanges));
-      lines.push(
-        `| ${escapeTableCell(result.flowName)} | ${result.summary.addedNodes} | ${result.summary.removedNodes} | ${result.summary.modifiedNodes} | ${result.summary.addedEdges} / ${result.summary.removedEdges} | ${flowSummary} | [Open interactive diff](${result.artifactUrl}) |`
-      );
+      return `| ${escapeTableCell(result.flowName)} | ${result.summary.addedNodes} | ${result.summary.removedNodes} | ${result.summary.modifiedNodes} | ${result.summary.addedEdges} / ${result.summary.removedEdges} | ${flowSummary} | [Open interactive diff](${result.artifactUrl}) |`;
     }
-  }
-  if (opts.commitSha) {
-    lines.push("", `Commit: \`${opts.commitSha.slice(0, 7)}\``);
-  }
-  return lines.join("\n");
+  }, opts);
 }
 function readResults(inputDir) {
   return readdirSync(inputDir).filter((file) => file.endsWith(".diff.json")).map((file) => {
@@ -121,6 +114,14 @@ function readResults(inputDir) {
 function isZeroSummary(summary) {
   return summary.addedNodes === 0 && summary.removedNodes === 0 && summary.modifiedNodes === 0 && summary.addedEdges === 0 && summary.removedEdges === 0 && summary.changedFlowAttributes === 0;
 }
+function buildProductComment(results, vocabulary, opts = {}) {
+  const sorted = [...results].sort((left, right) => vocabulary.sortName(left).localeCompare(vocabulary.sortName(right)));
+  const lines = [opts.marker ?? vocabulary.marker, "", vocabulary.heading(sorted.length), ""];
+  if (sorted.length === 0) lines.push(vocabulary.empty);
+  else lines.push(vocabulary.columns, vocabulary.separator, ...sorted.map(vocabulary.row));
+  if (opts.commitSha) lines.push("", `Commit: \`${opts.commitSha.slice(0, 7)}\``);
+  return lines.join("\n");
+}
 function findStickyNote(notes, marker, authorId) {
   return notes.find((note) => note.body.includes(marker) && (authorId === void 0 || note.author?.id === authorId));
 }

package/examples/cloudflare-worker/src/index.ts

@@ -1,3 +1,12 @@
+interface R2Object {
+  body: string;
+  writeHttpMetadata(headers: Headers): void;
+}
+
+interface R2Bucket {
+  get(key: string): Promise<R2Object | null>;
+}
+
 export interface Env {
   BUCKET: R2Bucket;
   ARTIFACT_HMAC_KEY?: string;

package/examples/github-actions.yml

@@ -29,6 +29,18 @@ jobs:
         with:
           name: flow-delta-out
           path: flow-delta-out
+      - run: |
+          ./node_modules/.bin/flexipage-delta \
+            --repo . \
+            --from "${{ github.event.pull_request.base.sha }}" \
+            --to   "${{ github.sha }}" \
+            --path 'force-app/**/*.flexipage-meta.xml' \
+            --changed-only \
+            --out flexipage-delta-out --json
+      - uses: actions/upload-artifact@v4
+        with:
+          name: flexipage-delta-out
+          path: flexipage-delta-out
       # Optional live-render path for private repos using your own R2 bucket and Worker.
       # See docs/ci.md for the required secrets, Worker template, and presigned alternative.
       - name: Publish to R2 + sign
@@ -40,17 +52,23 @@ jobs:
           R2_BUCKET: ${{ secrets.R2_BUCKET }}
           ARTIFACT_BASE_URL: ${{ vars.ARTIFACT_BASE_URL }}
           ARTIFACT_HMAC_KEY: ${{ secrets.ARTIFACT_HMAC_KEY }}
-        run: node ./node_modules/@syntax-syllogism/flow-delta/scripts/r2-publish.mjs flow-delta-out "$GITHUB_REPOSITORY/${{ github.event.number }}/$GITHUB_SHA" > flow-delta-out/urls.json
+        run: |
+          node ./node_modules/@syntax-syllogism/flow-delta/scripts/r2-publish.mjs flow-delta-out "$GITHUB_REPOSITORY/${{ github.event.number }}/$GITHUB_SHA" > flow-delta-out/urls.json
+          node ./node_modules/@syntax-syllogism/flow-delta/scripts/r2-publish.mjs flexipage-delta-out "$GITHUB_REPOSITORY/${{ github.event.number }}/$GITHUB_SHA" > flexipage-delta-out/urls.json
         continue-on-error: true
       - name: Report with live-render links
         if: ${{ vars.ARTIFACT_BASE_URL != '' }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: ./node_modules/.bin/flow-delta-github --in flow-delta-out --artifact-urls flow-delta-out/urls.json
+        run: |
+          ./node_modules/.bin/flow-delta-github --in flow-delta-out --artifact-urls flow-delta-out/urls.json
+          ./node_modules/.bin/flexipage-delta-github --in flexipage-delta-out --artifact-urls flexipage-delta-out/urls.json
         continue-on-error: true
       - name: Report with baseline artifact link
         if: ${{ vars.ARTIFACT_BASE_URL == '' }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: ./node_modules/.bin/flow-delta-github --in flow-delta-out
+        run: |
+          ./node_modules/.bin/flow-delta-github --in flow-delta-out
+          ./node_modules/.bin/flexipage-delta-github --in flexipage-delta-out
         continue-on-error: true

package/examples/gitlab-ci.yml

@@ -17,7 +17,16 @@ FlowDelta:
         --changed-only \
         --out flow-delta-out --json
     - npx --yes -p @syntax-syllogism/flow-delta@latest flow-delta-gitlab --in flow-delta-out
+    - |
+      npx --yes -p @syntax-syllogism/flow-delta@latest flexipage-delta \
+        --repo . \
+        --from "$CI_MERGE_REQUEST_DIFF_BASE_SHA" \
+        --to   "${CI_MERGE_REQUEST_SOURCE_BRANCH_SHA:-$CI_COMMIT_SHA}" \
+        --path 'force-app/**/*.flexipage-meta.xml' \
+        --changed-only \
+        --out flexipage-delta-out --json
+    - npx --yes -p @syntax-syllogism/flow-delta@latest flexipage-delta-gitlab --in flexipage-delta-out
   artifacts:
-    paths: [flow-delta-out]
+    paths: [flow-delta-out, flexipage-delta-out]
     expire_in: 30 days
   allow_failure: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntax-syllogism/flow-delta",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "type": "module",
   "description": "Semantic visual diff for Salesforce Flows",
   "license": "MIT",
@@ -26,18 +26,22 @@
   },
   "scripts": {
     "build": "node scripts/build.mjs",
+    "typecheck": "tsc --noEmit && tsc --project tsconfig.test.json --noEmit && tsc --project tsconfig.worker.json --noEmit",
     "smoke:gitlab": "node --import tsx scripts/smoke-gitlab.ts",
     "smoke:github": "node --import tsx scripts/smoke-github.ts",
-    "test": "node --import tsx --test test/parser.test.ts test/semantic-diff.test.ts test/report-core.test.ts test/gitlab-report.test.ts test/github-report.test.ts test/smoke-gitlab.test.ts test/r2-publish.test.ts test/cloudflare-worker.test.ts",
+    "test": "node --import tsx --test test/parser.test.ts test/semantic-diff.test.ts test/report-core.test.ts test/gitlab-report.test.ts test/github-report.test.ts test/smoke-gitlab.test.ts test/smoke-github.test.ts test/r2-publish.test.ts test/cloudflare-worker.test.ts test/flexipage-delta.test.ts",
     "test:parser": "node --import tsx --test test/parser.test.ts",
-    "prepublishOnly": "npm run build && npm test",
+    "prepublishOnly": "npm run typecheck && npm run build && npm test",
     "render:fixtures": "bash bin/render-fixtures.sh"
   },
   "devDependencies": {
-    "esbuild": "^0.28.0",
+    "@cloudflare/workers-types": "^4.20260702.1",
     "@types/node": "^26.1.0",
     "@types/xml2js": "^0.4.14",
-    "tsx": "^4.19.0"
+    "esbuild": "^0.28.0",
+    "happy-dom": "^20.10.6",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3"
   },
   "dependencies": {
     "elkjs": "^0.11.1",
@@ -46,7 +50,10 @@
   "bin": {
     "flow-delta": "dist/cli.js",
     "flow-delta-gitlab": "dist/gitlab-report.js",
-    "flow-delta-github": "dist/github-report.js"
+    "flow-delta-github": "dist/github-report.js",
+    "flexipage-delta": "dist/flexipage-cli.js",
+    "flexipage-delta-gitlab": "dist/flexipage-gitlab-report.js",
+    "flexipage-delta-github": "dist/flexipage-github-report.js"
   },
   "files": [
     "dist",