@amg555/frameforge-mcp 2.7.6 → 2.7.7

package/.agent/skills/gstack-make-pdf/test/e2e/landscape-gate.test.ts

@@ -1,150 +0,0 @@
-/**
- * Landscape promotion gate — proves the conservative auto-landscape policy
- * end-to-end through the compiled binary, asserted on pdfinfo per-page boxes
- * (the only oracle that can't lie about orientation).
- *
- * The fixture encodes one of each decision:
- *   - wide screenshot, no alt hint    → MUST stay portrait (false-positive guard)
- *   - wide image, alt "architecture diagram" → promotes
- *   - small image with {page=landscape}      → promotes (directive force)
- *   - wide mermaid sequence diagram          → promotes (provenance automatic)
- *   - wide mermaid with page=portrait fence  → MUST stay portrait (veto)
- *
- * Also runs the --toc combo: --toc prints until the TOC's page numbers match
- * the layout (make-pdf/src/toc-pages.ts), so named-page landscape must
- * survive those repeated prints unchanged. toc-gate.test.ts owns the page
- * numbers themselves.
- */
-
-import { describe, expect, test } from "bun:test";
-import { execFileSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-import { resolvePopplerTool } from "../../src/pdftotext";
-import { browserAvailable, NO_BROWSER_REASON } from "../../../test/helpers/browser-available";
-
-const FIXTURE = path.resolve(__dirname, "../fixtures/landscape-gate.md");
-const ROOT = path.resolve(__dirname, "../../..");
-const PDF_BIN = path.join(ROOT, "make-pdf/dist/pdf");
-const BUNDLE = path.join(ROOT, "lib/diagram-render/dist/diagram-render.html");
-
-const CHILD_TIMEOUT_MS = 60_000;
-
-function prerequisitesAvailable(): { ok: true } | { ok: false; reason: string } {
-  if (!fs.existsSync(PDF_BIN)) return { ok: false, reason: `make-pdf binary missing (${PDF_BIN}). Run bun run build.` };
-  // Aside (macOS) or gstack's own browse binary (what CI builds) — a skip only when neither exists.
-  if (!browserAvailable()) return { ok: false, reason: NO_BROWSER_REASON };
-  if (!fs.existsSync(BUNDLE)) return { ok: false, reason: `diagram-render bundle missing (${BUNDLE}).` };
-  if (!fs.existsSync(FIXTURE)) return { ok: false, reason: `fixture missing (${FIXTURE}).` };
-  if (!resolvePopplerTool("pdfinfo")) return { ok: false, reason: "pdfinfo not found (install poppler-utils)." };
-  if (!resolvePopplerTool("pdftotext")) return { ok: false, reason: "pdftotext not found (install poppler-utils)." };
-  return { ok: true };
-}
-
-interface PageBox {
-  page: number;
-  width: number;
-  height: number;
-}
-
-function pageBoxes(pdfPath: string): PageBox[] {
-  const pdfinfo = resolvePopplerTool("pdfinfo")!;
-  const out = execFileSync(pdfinfo, ["-f", "1", "-l", "99", pdfPath], {
-    encoding: "utf8",
-    timeout: CHILD_TIMEOUT_MS,
-  });
-  const boxes: PageBox[] = [];
-  for (const m of out.matchAll(/Page\s+(\d+)\s+size:\s+([0-9.]+)\s+x\s+([0-9.]+)\s+pts/g)) {
-    boxes.push({ page: Number(m[1]), width: parseFloat(m[2]), height: parseFloat(m[3]) });
-  }
-  if (boxes.length === 0) throw new Error(`pdfinfo reported no page sizes:\n${out}`);
-  return boxes;
-}
-
-const isLandscape = (b: PageBox) => b.width > b.height;
-
-function generate(args: string[], outputPdf: string): void {
-  execFileSync(PDF_BIN, ["generate", FIXTURE, outputPdf, "--quiet", ...args], {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "pipe"],
-    timeout: CHILD_TIMEOUT_MS,
-  });
-}
-
-describe("landscape promotion gate", () => {
-  const avail = prerequisitesAvailable();
-
-  test.skipIf(!avail.ok)("exactly the promoted blocks get landscape pages", () => {
-    if (!avail.ok) return;
-    const workDir = fs.mkdtempSync("/tmp/make-pdf-landscape-gate-");
-    const outputPdf = path.join(workDir, "out.pdf");
-    try {
-      generate([], outputPdf);
-      const boxes = pageBoxes(outputPdf);
-      const landscape = boxes.filter(isLandscape);
-      const portrait = boxes.filter((b) => !isLandscape(b));
-
-      // Three promotable blocks: alt-hinted image, directive-forced image,
-      // wide diagram. The alt-hinted promotion rides a per-render image
-      // measurement that is nondeterministic (TODOS: image-promotion render
-      // race — 2-vs-3 observed on renders seconds apart in CI and locally),
-      // so the gate bounds the count instead of pinning it: at least the two
-      // deterministic promotions, never more than the three promotable
-      // blocks (an upper bound above 3 would mean the veto leaked).
-      expect(landscape.length).toBeGreaterThanOrEqual(2);
-      expect(landscape.length).toBeLessThanOrEqual(3);
-      // First page (intro + screenshot) and the veto'd diagram stay portrait.
-      expect(portrait.length).toBeGreaterThanOrEqual(2);
-      expect(isLandscape(boxes[0])).toBe(false);
-
-      // The veto'd diagram rendered on SOME portrait page and NO landscape
-      // page — the actual invariant. (Asserting a specific page index breaks
-      // spuriously when font metrics shift pagination.)
-      const pdftotext = resolvePopplerTool("pdftotext")!;
-      const pageText = (page: number) =>
-        execFileSync(pdftotext, ["-f", String(page), "-l", String(page), outputPdf, "-"], {
-          encoding: "utf8",
-          timeout: CHILD_TIMEOUT_MS,
-        });
-      expect(portrait.some((b) => pageText(b.page).includes("vetoalpha"))).toBe(true);
-      expect(landscape.some((b) => pageText(b.page).includes("vetoalpha"))).toBe(false);
-    } finally {
-      try { fs.rmSync(workDir, { recursive: true, force: true }); } catch { /* ignore */ }
-    }
-  }, 120000);
-
-  test.skipIf(!avail.ok)("--toc combo: TOC renders and landscape promotion survives", () => {
-    if (!avail.ok) return;
-    const workDir = fs.mkdtempSync("/tmp/make-pdf-landscape-toc-");
-    const outputPdf = path.join(workDir, "out.pdf");
-    try {
-      // Presence, not a count: exact landscape-page counts are coupled to
-      // BOTH font-metric pagination (toBe(3) passed on Amazon Linux, failed
-      // ubuntu CI with 2) AND per-render image-promotion timing (a baseline
-      // comparison then failed with 2-vs-3 on renders seconds apart in the
-      // same CI job, while the sibling no-toc test saw 3). The sibling test
-      // owns the bounded promotion count; THIS test's invariant is that
-      // --toc does not break the promotion machinery: landscape pages still
-      // exist, and the TOC rendered.
-      generate(["--toc"], outputPdf);
-      const boxes = pageBoxes(outputPdf);
-      expect(boxes.filter(isLandscape).length).toBeGreaterThanOrEqual(1);
-
-      const pdftotext = resolvePopplerTool("pdftotext")!;
-      const text = execFileSync(pdftotext, [outputPdf, "-"], { encoding: "utf8", timeout: CHILD_TIMEOUT_MS });
-      // TOC heading extracts uppercase (small-caps styling).
-      expect(text.toUpperCase()).toContain("CONTENTS");
-    } finally {
-      try { fs.rmSync(workDir, { recursive: true, force: true }); } catch { /* ignore */ }
-    }
-  }, 120000);
-
-  if (!avail.ok) {
-    // A visible skip, never a failure: ci-prereqs.test.ts is the CI tripwire for
-    // the build artifacts + poppler this gate needs; CI prints through the browse binary it builds.
-    test("landscape gate prerequisites are present", () => {
-      console.warn(`[skip] ${avail.reason}`);
-    });
-  }
-});

package/.agent/skills/gstack-make-pdf/test/e2e/toc-gate.test.ts

@@ -1,143 +0,0 @@
-/**
- * TOC page-number gate (#2903) — through the compiled binary and a real
- * browser (Aside when it runs, otherwise gstack's own; CI uses the latter).
- *
- * Before the fix every `.toc-page` cell printed empty: no pagination engine
- * shipped and the print went ahead after a 3s Paged.js wait. Now each cell
- * must hold the page its heading prints on and each TOC link must land there.
- *
- * Oracles (independent of make-pdf's own PDF reader where it matters):
- *   - pdftotext: the number printed next to each TOC label, and the page
- *     whose text actually contains that heading;
- *   - pdfinfo: page boxes, so the fixture provably spans a landscape page;
- *   - the PDF's link annotations: one per entry, in TOC order, each naming a
- *     destination on the page its entry prints.
- *
- * The fixture covers a multi-page TOC, a cover (and none), custom ids, a
- * duplicate id, a user id squatting the generated `toc-N` scheme, a non-ASCII
- * id, an empty heading, and a forced landscape page between headings.
- */
-
-import { describe, expect, test } from "bun:test";
-import { execFileSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-
-import { resolvePopplerTool } from "../../src/pdftotext";
-import { pdfDestinationPages } from "../../src/toc-pages";
-import { browserAvailable, NO_BROWSER_REASON } from "../../../test/helpers/browser-available";
-
-const ROOT = path.resolve(__dirname, "../../..");
-const PDF_BIN = path.join(ROOT, "make-pdf/dist/pdf");
-const RED_BOX = path.resolve(__dirname, "../fixtures/diagram-assets/red-box.png");
-const CHILD_TIMEOUT_MS = 60_000;
-
-function prerequisitesAvailable(): { ok: true } | { ok: false; reason: string } {
-  if (!fs.existsSync(PDF_BIN)) return { ok: false, reason: `make-pdf binary missing (${PDF_BIN}). Run bun run build.` };
-  if (!browserAvailable()) return { ok: false, reason: NO_BROWSER_REASON };
-  if (!resolvePopplerTool("pdfinfo")) return { ok: false, reason: "pdfinfo not found (install poppler-utils)." };
-  if (!resolvePopplerTool("pdftotext")) return { ok: false, reason: "pdftotext not found (install poppler-utils)." };
-  return { ok: true };
-}
-
-const LABELS = [
-  "Gate Intro", "Squatter Heading", "Custom Heading", "Duplicate Heading", "Unicode Heading",
-  "Landscape Heading", "After Landscape",
-  ...Array.from({ length: 48 }, (_, i) => (i % 6 === 0 ? `Chapter ${String(i + 1).padStart(2, "0")}` : `Section ${String(i + 1).padStart(2, "0")}`)),
-];
-
-function fixtureMarkdown(): string {
-  const filler = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. ".repeat(24);
-  const lines = [
-    "# Gate Intro", "", "Intro paragraph.", "",
-    "#", "",
-    `<h2 id="toc-1">Squatter Heading</h2>`, "", "Body.", "",
-    `<h2 id="custom-id">Custom Heading</h2>`, "", "Body.", "",
-    `<h2 id="custom-id">Duplicate Heading</h2>`, "", "Body.", "",
-    `<h2 id="café-ü">Unicode Heading</h2>`, "", "Body.", "",
-    "## Landscape Heading", "", "![forced](./red-box.png){page=landscape}", "",
-    "## After Landscape", "", "Body.", "",
-  ];
-  for (const label of LABELS.slice(7)) lines.push(`${label.startsWith("Chapter") ? "#" : "##"} ${label}`, "", filler, "");
-  return lines.join("\n");
-}
-
-const run = (tool: "pdfinfo" | "pdftotext", args: string[]) => execFileSync(resolvePopplerTool(tool)!, args, { encoding: "utf8", timeout: CHILD_TIMEOUT_MS });
-const pageText = (pdf: string, page: number, layout = false) =>
-  run("pdftotext", [...(layout ? ["-layout"] : []), "-f", String(page), "-l", String(page), pdf, "-"]);
-const escapeRe = (s: string) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-
-function checkToc(pdf: string): void {
-  const info = run("pdfinfo", ["-f", "1", "-l", "999", pdf]);
-  const boxes = [...info.matchAll(/Page\s+(\d+)\s+size:\s+([0-9.]+)\s+x\s+([0-9.]+)\s+pts/g)].map((m) => ({ page: Number(m[1]), landscape: parseFloat(m[2]) > parseFloat(m[3]) }));
-  expect(boxes.length).toBeGreaterThan(10);
-  expect(boxes.some((b) => b.landscape)).toBe(true);
-
-  // The number printed beside each label, read from the TOC pages' layout text.
-  const tocPages = new Set<number>();
-  const printed = new Map<string, number>();
-  for (const { page } of boxes) {
-    const text = pageText(pdf, page, true);
-    for (const label of LABELS) {
-      const m = text.match(new RegExp(`^\\s*${escapeRe(label)}\\s+(\\d+)\\s*$`, "m"));
-      if (!m || printed.has(label)) continue;
-      printed.set(label, Number(m[1]));
-      tocPages.add(page);
-    }
-  }
-  expect([...printed.keys()]).toEqual(LABELS);
-  expect(tocPages.size).toBeGreaterThanOrEqual(2); // a multi-page TOC
-
-  // Each number names the page whose own text holds that heading.
-  for (const label of LABELS) {
-    const page = printed.get(label)!;
-    expect(tocPages.has(page)).toBe(false);
-    const lines = pageText(pdf, page).split("\n").map((l) => l.trim());
-    expect({ label, page, found: lines.includes(label) }).toEqual({ label, page, found: true });
-  }
-  const landscapePage = boxes.find((b) => b.landscape)!.page;
-  expect(printed.get("Landscape Heading")!).toBeLessThan(landscapePage);
-  expect(printed.get("After Landscape")!).toBeGreaterThan(landscapePage);
-
-  // One link per entry, in TOC order, each to a destination on its entry's page.
-  const raw = fs.readFileSync(pdf);
-  const links = [...raw.toString("latin1").matchAll(/\/Subtype \/Link\b[^>]*?\/Dest \/([^\s/>\]]+)/g)].map((m) => m[1]);
-  expect(links).toHaveLength(LABELS.length);
-  const dests = pdfDestinationPages(raw);
-  const decoded = links.map((n) => decodeURIComponent(Buffer.from(n.replace(/#([0-9a-fA-F]{2})/g, (_x, h) => String.fromCharCode(parseInt(h, 16))), "latin1").toString("utf8")));
-  expect(decoded.map((d) => dests.get(d))).toEqual(LABELS.map((l) => printed.get(l)));
-  expect(new Set(decoded).size).toBe(LABELS.length);
-}
-
-describe("TOC page-number gate (#2903)", () => {
-  const avail = prerequisitesAvailable();
-
-  for (const variant of [{ name: "cover + toc", args: ["--cover", "--toc"] }, { name: "toc only", args: ["--toc"] }]) {
-    test.skipIf(!avail.ok)(`${variant.name}: every TOC cell holds its heading's printed page and every link lands there`, () => {
-      if (!avail.ok) return;
-      const dir = fs.mkdtempSync(path.join(os.tmpdir(), "make-pdf-toc-gate-"));
-      try {
-        fs.copyFileSync(RED_BOX, path.join(dir, "red-box.png"));
-        fs.writeFileSync(path.join(dir, "toc.md"), fixtureMarkdown());
-        const out = path.join(dir, "out.pdf");
-        execFileSync(PDF_BIN, ["generate", path.join(dir, "toc.md"), out, "--quiet", "--title", "Gate Doc", ...variant.args], {
-          encoding: "utf8",
-          stdio: ["ignore", "pipe", "pipe"],
-          timeout: CHILD_TIMEOUT_MS,
-        });
-        checkToc(out);
-        if (variant.args.includes("--cover")) expect(pageText(out, 1)).not.toMatch(/CONTENTS/);
-      } finally {
-        fs.rmSync(dir, { recursive: true, force: true });
-      }
-    }, 120_000);
-  }
-
-  if (!avail.ok) {
-    // A visible skip: ci-prereqs.test.ts is the CI tripwire for the binaries + poppler.
-    test("toc gate prerequisites are present", () => {
-      console.warn(`[skip] ${avail.reason}`);
-    });
-  }
-});

package/.agent/skills/gstack-make-pdf/test/fixtures/combined-gate.expected.txt

@@ -1,20 +0,0 @@
-The Horizon
-This is the combined-features fixture. Every feature turned on simultaneously. The gate asserts that all of these paragraphs extract cleanly from the PDF with pdftotext.
-
-A paragraph with bold, italic, and inline code tokens — each of which gets a different HTML treatment. None should fragment text on copy-paste.
-
-A paragraph with “curly quotes”, ‘single quotes’, an em dash — like this, and an ellipsis… All three get smartypants transforms.
-
-A subsection heading
-
-First list item with some words that keep it on one line.
-Second list item with more words.
-Third list item.
-
-A blockquote from Van Dyke. Her diminished size is in me, not in her.
-
-A second chapter
-
-This content begins on a fresh page because the default chapter-breaks rule fires. Extract must still find these paragraphs.
-
-A final paragraph with enough words to trigger hyphenation across the line wrap boundary. Extraordinary words sometimes hyphenate. Interdisciplinary ones certainly do.

package/.agent/skills/gstack-make-pdf/test/fixtures/combined-gate.md

@@ -1,30 +0,0 @@
-# The Horizon
-
-This is the combined-features fixture. Every feature turned on simultaneously.
-The gate asserts that all of these paragraphs extract cleanly from the PDF
-with pdftotext.
-
-A paragraph with **bold**, *italic*, and `inline code` tokens — each of which
-gets a different HTML treatment. None should fragment text on copy-paste.
-
-A paragraph with "curly quotes", 'single quotes', an em dash -- like this,
-and an ellipsis... All three get smartypants transforms.
-
-## A subsection heading
-
-Lists must not break mid-item:
-
-- First list item with some words that keep it on one line.
-- Second list item with more words.
-- Third list item.
-
-> A blockquote from Van Dyke. Her diminished size is in me, not in her.
-
-# A second chapter
-
-This content begins on a fresh page because the default chapter-breaks rule
-fires. Extract must still find these paragraphs.
-
-A final paragraph with enough words to trigger hyphenation across the line
-wrap boundary. Extraordinary words sometimes hyphenate. Interdisciplinary
-ones certainly do.

package/.agent/skills/gstack-make-pdf/test/fixtures/diagram-gate.md

@@ -1,48 +0,0 @@
-# Diagram Gate
-
-A relative local image (CRITICAL regression: must render, not 404):
-
-![a red box](./diagram-assets/red-box.png)
-
-## First diagram
-
-```mermaid title="Gate pipeline"
-graph LR
-  GATEALPHA[gatealphanode] --> GATEBETA{gatebetanode}
-  GATEBETA -->|yes| GATEGAMMA[gategammanode]
-```
-
-## Deliberately broken
-
-```mermaid
-graph LR
-  A -->
-  (((
-```
-
-## Second diagram (id-collision check)
-
-```mermaid
-graph TD
-  GATEDELTA[gatedeltanode] --> GATEEPSILON[gateepsilonnode]
-```
-
-## Kept as source
-
-```mermaid render=false
-graph LR
-  RAWKEPT --> ASCODE
-```
-
-
-## Excalidraw scene
-
-```excalidraw title="Converted flowchart"
-{"type":"excalidraw","version":2,"source":"gstack-diagram-render","elements":[{"id":"VL7JRGkMTpqCVBye2mq3X","type":"rectangle","x":0,"y":0,"width":197.046875,"height":44,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"a0","roundness":null,"seed":172328728,"version":3,"versionNonce":1118377320,"isDeleted":false,"boundElements":[{"type":"text","id":"mQsqVweT6BUmQpwbW6sOU"},{"id":"aVaLIsulCLlHiV1XqWi1-","type":"arrow"}],"updated":1781273248718,"link":null,"locked":false},{"id":"YX9Ff_UgFhhRa7lGo6xS9","type":"rectangle","x":247.046875,"y":0,"width":186.4375,"height":44,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"a1","roundness":null,"seed":1275860584,"version":3,"versionNonce":45230184,"isDeleted":false,"boundElements":[{"type":"text","id":"9oes2DZoL-mRrT3RGakLq"},{"id":"aVaLIsulCLlHiV1XqWi1-","type":"arrow"}],"updated":1781273248718,"link":null,"locked":false},{"id":"aVaLIsulCLlHiV1XqWi1-","type":"arrow","x":197.047,"y":22,"width":44.70000000000002,"height":0,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"a2","roundness":{"type":2},"seed":1530192920,"version":4,"versionNonce":1747670296,"isDeleted":false,"boundElements":null,"updated":1781273248718,"link":null,"locked":false,"points":[[0.5,0],[44.20000000000002,0]],"lastCommittedPoint":null,"startBinding":{"elementId":"VL7JRGkMTpqCVBye2mq3X","focus":0,"gap":1},"endBinding":{"elementId":"YX9Ff_UgFhhRa7lGo6xS9","focus":0,"gap":5.299874999999986},"startArrowhead":null,"endArrowhead":"arrow","elbowed":false},{"id":"mQsqVweT6BUmQpwbW6sOU","type":"text","x":33.5576171875,"y":9.5,"width":129.931640625,"height":25,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"a3","roundness":null,"seed":1219280408,"version":3,"versionNonce":1462825496,"isDeleted":false,"boundElements":null,"updated":1781273248718,"link":null,"locked":false,"text":"excalialphanode","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"VL7JRGkMTpqCVBye2mq3X","originalText":"excalialphanode","autoResize":true,"lineHeight":1.25},{"id":"9oes2DZoL-mRrT3RGakLq","type":"text","x":280.2998046875,"y":9.5,"width":119.931640625,"height":25,"angle":0,"strokeColor":"#1e1e1e","backgroundColor":"transparent","fillStyle":"solid","strokeWidth":2,"strokeStyle":"solid","roughness":1,"opacity":100,"groupIds":[],"frameId":null,"index":"a4","roundness":null,"seed":1436367640,"version":3,"versionNonce":639687528,"isDeleted":false,"boundElements":null,"updated":1781273248718,"link":null,"locked":false,"text":"excalibetanode","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"YX9Ff_UgFhhRa7lGo6xS9","originalText":"excalibetanode","autoResize":true,"lineHeight":1.25}],"appState":{"viewBackgroundColor":"#ffffff"},"files":{}}
-```
-
-## Huge photo (downscale trigger, no diagram hint)
-
-![a big noisy photo](./diagram-assets/huge-noise.png)
-
-Done.

package/.agent/skills/gstack-make-pdf/test/fixtures/emoji-gate.md

@@ -1,12 +0,0 @@
-# Emoji rendering gate 😀
-
-This fixture exists to prove that emoji code points render as real color
-glyphs in the output PDF, not as `.notdef` tofu boxes (▯).
-
-Color emoji on one line: 😀 ❤️ 🚀 ✅ 💡
-
-A variation-selector sequence (FE0F) renders color: ❤️ — the bare code point
-❤ is text-style. Both must come from a font in the cascade, never tofu.
-
-Non-emoji Unicode (unchanged, regression guard): em dash —, times ×, arrow →,
-bullet •, ellipsis …

package/.agent/skills/gstack-make-pdf/test/fixtures/landscape-gate.md

@@ -1,52 +0,0 @@
-# Landscape Gate
-
-Intro text under the first heading.
-
-## Negative: screenshot stays portrait
-
-![just a screenshot of the app](./diagram-assets/wide-screenshot.png)
-
-## Positive: alt-hinted wide image promotes
-
-![architecture diagram of the system](./diagram-assets/wide-arch.png)
-
-## Positive: directive forces a small image
-
-![small forced](./diagram-assets/red-box.png){page=landscape}
-
-## Positive: wide diagram auto-promotes
-
-```mermaid title="Wide sequence"
-sequenceDiagram
-  participant A as seqalpha
-  participant B as seqbeta
-  participant C as seqgamma
-  participant D as seqdelta
-  participant E as seqepsilon
-  participant F as seqzeta
-  participant G as seqeta
-  participant H as seqtheta
-  participant I as seqiota
-  participant J as seqkappa
-  A->>J: long hop
-  B->>I: cross
-```
-
-## Negative: directive vetoes a wide diagram
-
-```mermaid page=portrait
-sequenceDiagram
-  participant A as vetoalpha
-  participant B as vetobeta
-  participant C as vetogamma
-  participant D as vetodelta
-  participant E as vetoepsilon
-  participant F as vetozeta
-  participant G as vetoeta
-  participant H as vetotheta
-  participant I as vetoiota
-  participant J as vetokappa
-  A->>J: long hop
-```
-
-Closing text.