nnw-theme 2.3.0 → 2.5.0

package/assets/netnewswire/netnewswire.json

@@ -1,6 +1,6 @@
 {
-	"release": "main-70c5dce",
-	"commit": "70c5dce656487bdab9e0226c318acc1a15071cf4",
+	"release": "mac-7.3b6",
+	"commit": "9a07d406177e896826e33952fb16c06e21c19000",
 	"files": [
 		{
 			"destination": "LICENSE",
@@ -10,7 +10,7 @@
 		{
 			"destination": "Mac/main_mac.js",
 			"source": "Mac/MainWindow/Detail/main_mac.js",
-			"sha256": "3ac1ef46523f6c4d8103fe7dbe6f45486d57a94c3d54d0fcb6211a35215bb676"
+			"sha256": "51c8812b9063d70aeb9a163a224bc83954f127dfb78736b2016d6572dd9ab63f"
 		},
 		{
 			"destination": "Mac/page.html",
@@ -20,22 +20,22 @@
 		{
 			"destination": "Shared/core.css",
 			"source": "Shared/Article Rendering/core.css",
-			"sha256": "3cdc76a22a6bbcd1aeed6eec4611598bb64a457cade3e1553e7b88f03bc78ef9"
+			"sha256": "3a1a56fe6e76e9e11b4180399e6d90b702075224fd3da4e678cf627e83939c5b"
 		},
 		{
 			"destination": "Shared/main.js",
 			"source": "Shared/Article Rendering/main.js",
-			"sha256": "847dc1f06ec0e7f96aee1004fd6186771db907445347cf0371abc67158aadb5a"
+			"sha256": "6be65bcb16be38b686ddf8d96bca3b0d844eee2e138758842b247ab50503dcc4"
 		},
 		{
 			"destination": "Shared/newsfoot.js",
 			"source": "Shared/Article Rendering/newsfoot.js",
-			"sha256": "828e6889bd976ebce417d808ac726dd9252a801946d77e32de207ba4a14e21fa"
+			"sha256": "8e0a5fd14b2b5e3b57e6d420388afa2999a8df8af56f957c16303834ad53ed61"
 		},
 		{
 			"destination": "iOS/main_ios.js",
 			"source": "iOS/Resources/main_ios.js",
-			"sha256": "e764183ea8e9ce75df13d268834741b176afdb440eb492efeaba8ccabd7dfb8b"
+			"sha256": "ab60f228e06b11589aefaac579a5ea42d1ff5ecf43aab44e2eba7679a18d6ef2"
 		},
 		{
 			"destination": "iOS/page.html",

package/dist/body-images.js

@@ -0,0 +1,209 @@
+// NetNewsWire's search for a body's real images: RSParser's HTMLImageParser and
+// SignificantImageFilter, at the pinned commit. Enclosures and primary media use it to
+// spot a resized copy of an image the body already shows.
+import { Parser } from "htmlparser2";
+const MINIMUM_DIMENSION = 64;
+const MAXIMUM_ASPECT_RATIO = 6;
+const PREFERRED_SRCSET_WIDTH = 1200;
+const LAZY_SRCSET_ATTRIBUTES = ["data-lazy-srcset", "data-srcset"];
+const LAZY_SOURCE_ATTRIBUTES = ["data-lazy-src", "data-src", "data-original"];
+const DECORATIVE_CLASSES = new Set(["emoji", "wp-smiley"]);
+const BLOCKED_FILE_NAMES = new Set(["1x1", "blank", "pixel", "spacer", "transparent"]);
+const BLOCKED_PATH_COMPONENTS = new Set(["open", "track"]);
+const PHOTO_EXTENSIONS = new Set(["avif", "heic", "jpeg", "jpg", "png", "webp"]);
+const BLOCKED_IMAGES = [
+    ["addtoany.com", "/"],
+    ["feedburner.com", "/"],
+    ["feeds.wordpress.com", "/"],
+    ["pixel.wp.com", "/"],
+    ["s.w.org", "/images/core/emoji/"],
+    ["s0.wp.com", "/i/blank.jpg"],
+    ["stats.wordpress.com", "/"],
+];
+const SHARING_LINKS = [
+    ["addtoany.com", "/"],
+    ["bsky.app", "/intent/"],
+    ["digg.com", "/submit"],
+    ["facebook.com", "/dialog/"],
+    ["facebook.com", "/share"],
+    ["flipboard.com", "/bookmarklet"],
+    ["getpocket.com", "/save"],
+    ["linkedin.com", "/cws/share"],
+    ["linkedin.com", "/sharearticle"],
+    ["linkedin.com", "/sharing/"],
+    ["news.ycombinator.com", "/submitlink"],
+    ["pinterest.com", "/pin/create"],
+    ["reddit.com", "/submit"],
+    ["shareaholic.com", "/"],
+    ["sharethis.com", "/"],
+    ["t.me", "/share"],
+    ["threads.net", "/intent/"],
+    ["tumblr.com", "/share"],
+    ["tumblr.com", "/widgets/share"],
+    ["twitter.com", "/intent/"],
+    ["twitter.com", "/share"],
+    ["whatsapp.com", "/send"],
+    ["x.com", "/intent/"],
+    ["x.com", "/share"],
+];
+function matches(url, prefixes) {
+    const host = url.hostname.toLowerCase();
+    const path = url.pathname.toLowerCase();
+    return prefixes.some(([domain, prefix]) => (host === domain || host.endsWith(`.${domain}`)) && path.startsWith(prefix));
+}
+function parsed(value) {
+    try {
+        return new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasSignificantDimensions(width, height) {
+    if (width !== undefined && width < MINIMUM_DIMENSION)
+        return false;
+    if (height !== undefined && height < MINIMUM_DIMENSION)
+        return false;
+    if (width !== undefined && height !== undefined) {
+        return Math.max(width, height) / Math.min(width, height) <= MAXIMUM_ASPECT_RATIO;
+    }
+    return true;
+}
+function isGravatar(url) {
+    const host = url.hostname.toLowerCase();
+    return ((host === "gravatar.com" || host.endsWith(".gravatar.com")) &&
+        url.pathname.startsWith("/avatar/"));
+}
+function isBlockedURL(value) {
+    const url = parsed(value);
+    if (!url || !["http:", "https:"].includes(url.protocol) || !url.hostname)
+        return true;
+    const components = url.pathname.split("/").filter(Boolean);
+    const name = components.at(-1) ?? "";
+    const dot = name.lastIndexOf(".");
+    const extension = dot > 0 ? name.slice(dot + 1).toLowerCase() : "";
+    if (extension === "svg")
+        return true;
+    if (BLOCKED_FILE_NAMES.has((dot > 0 ? name.slice(0, dot) : name).toLowerCase()))
+        return true;
+    if (!PHOTO_EXTENSIONS.has(extension) &&
+        components.some((component) => BLOCKED_PATH_COMPONENTS.has(component.toLowerCase()))) {
+        return true;
+    }
+    return matches(url, BLOCKED_IMAGES) || isGravatar(url);
+}
+function isSharingLink(value) {
+    const url = value === undefined ? undefined : parsed(value);
+    if (!url)
+        return false;
+    return url.protocol === "mailto:" || (url.hostname !== "" && matches(url, SHARING_LINKS));
+}
+function hasDecorativeClass(htmlClass) {
+    return (htmlClass ?? "")
+        .split(/\s+/)
+        .some((name) => DECORATIVE_CLASSES.has(name.toLowerCase()));
+}
+/** Foundation's URL(string:relativeTo:).absoluteString; undefined for data: or empty. */
+function resolved(value, baseURL) {
+    if (value === undefined || /^\s*data:/i.test(value))
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        return new URL(trimmed, baseURL || undefined).href;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The narrowest candidate at least 1200w wide, else the one with the largest descriptor. */
+function preferredSrcsetCandidate(srcset) {
+    let narrowest;
+    let largest;
+    for (const match of srcset.matchAll(/[\s,]*([^\s,][^\s]*)([^,]*)/g)) {
+        let url = match[1] ?? "";
+        const trailingComma = url.endsWith(",");
+        url = url.replace(/,+$/, "");
+        const descriptor = trailingComma ? "" : ((match[2] ?? "").trim().split(/\s+/)[0] ?? "");
+        if (!url)
+            continue;
+        const size = Number.parseFloat(descriptor) || 1;
+        if (descriptor.endsWith("w") &&
+            size >= PREFERRED_SRCSET_WIDTH &&
+            size < (narrowest?.size ?? Number.POSITIVE_INFINITY)) {
+            narrowest = { url, size };
+        }
+        if (size > (largest?.size ?? Number.NEGATIVE_INFINITY))
+            largest = { url, size };
+    }
+    return (narrowest ?? largest)?.url;
+}
+function styleProperties(style) {
+    const properties = new Map();
+    for (const declaration of (style ?? "").split(";")) {
+        const colon = declaration.indexOf(":");
+        if (colon === -1)
+            continue;
+        properties.set(declaration.slice(0, colon).trim().toLowerCase(), declaration
+            .slice(colon + 1)
+            .trim()
+            .toLowerCase());
+    }
+    return properties;
+}
+/** "300" and "300px" are pixel dimensions; percentages and other units are not. */
+function pixelDimension(value) {
+    const match = value
+        ?.trim()
+        .toLowerCase()
+        .match(/^([+-]?\d+)(?:px)?$/);
+    return match ? Number(match[1]) : undefined;
+}
+/** HTMLImageParser.significantImageURLStrings: absolute URLs, in document order. */
+export function significantImageURLs(html, baseURL) {
+    const found = new Set();
+    let enclosingLink;
+    const parser = new Parser({
+        onopentag(name, attributes) {
+            if (name === "a") {
+                enclosingLink = resolved(attributes.href, baseURL);
+                return;
+            }
+            if (name !== "img")
+                return;
+            const style = styleProperties(attributes.style);
+            if (attributes.hidden !== undefined || style.get("display")?.startsWith("none"))
+                return;
+            const width = pixelDimension(style.get("width")) ?? pixelDimension(attributes.width);
+            const height = pixelDimension(style.get("height")) ?? pixelDimension(attributes.height);
+            if (!hasSignificantDimensions(width, height))
+                return;
+            if (hasDecorativeClass(attributes.class) || isSharingLink(enclosingLink))
+                return;
+            const sources = [
+                ...LAZY_SRCSET_ATTRIBUTES.map((key) => attributes[key])
+                    .filter((value) => value !== undefined)
+                    .map(preferredSrcsetCandidate),
+                ...LAZY_SOURCE_ATTRIBUTES.map((key) => attributes[key]),
+                attributes.srcset === undefined
+                    ? undefined
+                    : preferredSrcsetCandidate(attributes.srcset),
+                attributes.src,
+            ];
+            for (const source of sources) {
+                const url = resolved(source, baseURL);
+                if (url !== undefined && !isBlockedURL(url)) {
+                    found.add(url);
+                    return;
+                }
+            }
+        },
+        onclosetag(name) {
+            if (name === "a")
+                enclosingLink = undefined;
+        },
+    }, { decodeEntities: true, lowerCaseTags: true, lowerCaseAttributeNames: true });
+    parser.end(html);
+    return [...found];
+}

package/dist/browser.js

@@ -11,7 +11,11 @@ import { packagePath, ThemeError } from "./project.js";
 import { pyReprList } from "./pyformat.js";
 const FOOTNOTE_CHECK = readFileSync(packagePath("assets", "footnotes.js"), "utf8");
 const ENCLOSURE_CHECK = readFileSync(packagePath("assets", "enclosures.js"), "utf8");
-const ENCLOSURES_MACRO = "[[enclosures]]";
+/** Macros older NetNewsWire leaves as text, and what explains each when it shows. */
+const NEWER_MACROS = {
+    "[[enclosures]]": "without enclosure support; hide its element when it holds no .nnw-enclosures",
+    "[[primary_media]]": "before 7.3b6; hide its element when it holds no .nnw-primary-media, or use it only in template7.3.html",
+};
 const LIVE_RELOAD = readFileSync(packagePath("assets", "live-reload.js"), "utf8");
 const NOT_INSTALLED = "WebKit is not installed; run `npx nnw-theme@2 setup`";
 const CONTENT_TYPES = {
@@ -150,9 +154,8 @@ export function failures(state) {
         found.push("article content is missing or unreadable");
     if (state.unresolved)
         found.push("unresolved theme macro");
-    if (state.literalEnclosures) {
-        found.push("[[enclosures]] shows as text in NetNewsWire releases without enclosure support; " +
-            "hide its element when it holds no .nnw-enclosures");
+    for (const macro of state.literalMacros ?? []) {
+        found.push(`${macro} shows as text in NetNewsWire releases ${NEWER_MACROS[macro]}`);
     }
     if (state.overflow)
         found.push("horizontal document overflow");
@@ -185,9 +188,9 @@ async function loadImages(timeout) {
         new Promise((resolve) => setTimeout(resolve, timeout)),
     ]);
 }
-// Runs in the page after its screenshot. With olderNetNewsWire, the template's
-// [[enclosures]] is expected in the markup and fails only if it shows as text.
-function pageState({ olderNetNewsWire, macro }) {
+// Runs in the page after its screenshot. With olderNetNewsWire, the macros in `macros`
+// are expected in the markup and fail only if they show as text.
+function pageState({ olderNetNewsWire, macros, }) {
     const article = document.querySelector(".articleBody");
     const root = document.documentElement;
     const html = document.body.innerHTML;
@@ -196,8 +199,12 @@ function pageState({ olderNetNewsWire, macro }) {
         textLength: (article?.innerText || "").trim().length,
         // Body only: macOS CSS legitimately keeps the font-size macro literal. Match
         // whole macro names, so a theme script's regex such as /[[(]/ is no macro.
-        unresolved: /\[\[[A-Za-z0-9_-]+\]\]/.test(olderNetNewsWire ? html.replaceAll(macro, "") : html),
-        literalEnclosures: olderNetNewsWire && document.body.innerText.includes(macro),
+        unresolved: /\[\[[A-Za-z0-9_-]+\]\]/.test(olderNetNewsWire
+            ? macros.reduce((text, macro) => text.replaceAll(macro, ""), html)
+            : html),
+        literalMacros: olderNetNewsWire
+            ? macros.filter((macro) => document.body.innerText.includes(macro))
+            : [],
         overflow: root.scrollWidth > root.clientWidth + 1,
         brokenImages: [...document.images]
             .filter((image) => image.complete && image.naturalWidth === 0)
@@ -232,8 +239,9 @@ function pageState({ olderNetNewsWire, macro }) {
  *
  * expectations maps a fixture name to its [expect.footnotes] table. They describe
  * the theme's own footnote handling, so they are skipped with theme scripts off.
+ * warnings, when given, receives each target's warnings by slug.
  */
-export async function checkPages(site, targets, progress, expectations = {}) {
+export async function checkPages(site, targets, progress, expectations = {}, warnings) {
     const results = {};
     const screenshots = join(site, "screenshots");
     mkdirSync(screenshots, { recursive: true });
@@ -250,6 +258,8 @@ export async function checkPages(site, targets, progress, expectations = {}) {
                 const state = await checkPage(browser, server.url, url, target, join(screenshots, `${target.slug}.png`), footnotes);
                 const found = failures(state);
                 results[target.slug] = found;
+                if (warnings)
+                    warnings[target.slug] = state.warnings ?? [];
                 progress?.finish(index, target, found);
             }
         }
@@ -296,12 +306,19 @@ async function checkPage(browser, origin, url, target, screenshot, footnotes) {
         await page.screenshot({ path: screenshot, fullPage: !target.card });
         const state = await page.evaluate(pageState, {
             olderNetNewsWire: target.olderNetNewsWire,
-            macro: ENCLOSURES_MACRO,
+            macros: Object.keys(NEWER_MACROS),
         });
         const enclosures = (await page.evaluate(`(${ENCLOSURE_CHECK})()`));
         // Last: it clicks footnotes open, so it must not disturb the screenshot.
         const found = (await page.evaluate(`(${FOOTNOTE_CHECK})(${JSON.stringify(footnotes)})`));
-        return { ...state, enclosures, footnotes: found, blocked, pageErrors };
+        return {
+            ...state,
+            enclosures,
+            footnotes: found.failures,
+            warnings: found.warnings,
+            blocked,
+            pageErrors,
+        };
     }
     finally {
         await context.close();

package/dist/commands/check.js

@@ -6,14 +6,23 @@ import { interactive, openInBrowser, promptConfirm } from "../interactive.js";
 import { version } from "../main.js";
 import { buildArchive } from "../package.js";
 import { findRoot, findTheme, fixturePath, footnoteExpectations, readFixture, repositoryFixtures, ThemeError, themeStem, } from "../project.js";
-import { checkTargets, extraFixtures, placesEnclosures, renderSite, writeGallery, } from "../render.js";
+import { allFixtures, checkTargets, extraFixtures, readDeliveries, renderSite, rendersDifferentlyWhenOlder, writeGallery, } from "../render.js";
 import { staleStubs } from "../stubs.js";
 import { printWarnings } from "./package.js";
 import { CheckProgress } from "./progress.js";
+/**
+ * Each fixture's [expect.footnotes]. A fixture that models a sync service, with
+ * base_url or deliveries, fails a footnote link that never became a marker unless it
+ * sets all_converted = false; any other fixture only warns about one, unless it sets
+ * all_converted = true.
+ */
 export function expectations(root, targets) {
     const result = {};
     for (const name of new Set(targets.map((target) => target.fixture))) {
-        result[name] = footnoteExpectations(readFixture(fixturePath(root, name)), `fixtures/${name}.toml`);
+        const fixture = readFixture(fixturePath(root, name));
+        const expected = footnoteExpectations(fixture, `fixtures/${name}.toml`);
+        expected.all_converted ??= "base_url" in fixture || "deliveries" in fixture;
+        result[name] = expected;
     }
     return result;
 }
@@ -22,7 +31,7 @@ export function fixtureHint(root) {
     if (repositoryFixtures(root).length)
         return undefined;
     return ("Hint: this theme has no fixtures of its own. `npx nnw-theme@2 fixture list` " +
-        "shows ready-made ones modeled on WordPress, Ghost, Substack, and Medium markup.");
+        "shows ready-made ones modeled on WordPress, Ghost, Substack, Medium, and Mastodon markup.");
 }
 async function offerToOpen(index, choice) {
     const open = choice ?? (interactive() && (await promptConfirm("Open the preview?", true)));
@@ -34,8 +43,10 @@ export default async function check({ values }) {
     const theme = findTheme(root);
     console.log(`nnw-theme ${version()}`);
     printWarnings(staleStubs(root));
-    const targets = checkTargets(extraFixtures(root), {
-        enclosuresMacro: placesEnclosures(theme),
+    const extras = extraFixtures(root);
+    const targets = checkTargets(extras, {
+        olderNetNewsWire: rendersDifferentlyWhenOlder(theme),
+        deliveries: readDeliveries(root, allFixtures(extras)),
     });
     const expected = expectations(root, targets);
     const progress = new CheckProgress(targets.length);
@@ -48,23 +59,29 @@ export default async function check({ values }) {
     progress.status(`Rendering ${targets.length} pages…`);
     const site = renderSite(root, theme, targets);
     let results;
+    const warned = {};
     try {
-        results = await checkPages(site, targets, progress, expected);
+        results = await checkPages(site, targets, progress, expected, warned);
     }
     finally {
         progress.done();
     }
     writeGallery(site, themeStem(theme), targets, results);
     const failures = targets.flatMap((target) => (results[target.slug] ?? []).map((message) => `${target.label}: ${message}`));
+    const warnings = targets.flatMap((target) => (warned[target.slug] ?? []).map((message) => `Warning: ${target.label}: ${message}`));
+    for (const warning of warnings)
+        console.log(warning);
+    const warningLines = warnings.map((warning) => `${warning}\n`).join("");
     const passed = targets.filter((target) => !results[target.slug]?.length).length;
     const packageName = basename(archive.path);
     const footer = `nnw-theme ${version()}\n`;
     const report = join(root, "build", "check-report.txt");
     if (failures.length) {
-        writeFileSync(report, `FAIL\n${failures.join("\n")}\n${footer}`, "utf8");
+        writeFileSync(report, `FAIL\n${failures.join("\n")}\n${warningLines}${footer}`, "utf8");
     }
     else {
-        writeFileSync(report, `PASS\n${targets.length} WebKit renders checked\nPackage: ${packageName}\n${footer}`, "utf8");
+        writeFileSync(report, `PASS\n${targets.length} WebKit renders checked\nPackage: ${packageName}\n` +
+            `${warningLines}${footer}`, "utf8");
         console.log(`PASS: ${targets.length} WebKit renders and ${packageName}`);
     }
     const hint = fixtureHint(root);

package/dist/commands/preview.js

@@ -3,7 +3,7 @@ import { relative, sep } from "node:path";
 import { serve } from "../browser.js";
 import { openInBrowser } from "../interactive.js";
 import { findRoot, findTheme } from "../project.js";
-import { extraFixtures, normalTargets, renderSite } from "../render.js";
+import { renderSite, repositoryTargets } from "../render.js";
 /** Whether a changed path is theme or fixture content the gallery is built from. */
 export function watched(root, path) {
     const parts = relative(root, path).split(sep);
@@ -15,7 +15,7 @@ export function watched(root, path) {
 export default async function preview({ values }) {
     const root = findRoot();
     const theme = findTheme(root);
-    const build = () => renderSite(root, theme, normalTargets(extraFixtures(root)));
+    const build = () => renderSite(root, theme, repositoryTargets(root));
     const site = build();
     const server = await serve(site, { live: true });
     console.log(`Preview: ${server.url}`);

package/dist/commands/render.js

@@ -1,9 +1,9 @@
 import { findRoot, findTheme, ThemeError } from "../project.js";
-import { extraFixtures, normalTargets, renderSite } from "../render.js";
+import { renderSite, repositoryTargets } from "../render.js";
 export default function render({ positionals }) {
     const root = findRoot();
     const theme = findTheme(root);
-    let targets = normalTargets(extraFixtures(root));
+    let targets = repositoryTargets(root);
     if (positionals.length) {
         const requested = new Set(positionals);
         targets = targets.filter((target) => requested.has(target.fixture));

package/dist/commands/screenshot.js

@@ -6,12 +6,13 @@ import { extraFixtures, FIXTURE_NAMES, RenderTarget, renderSite, } from "../rend
 import { expectations } from "./check.js";
 // Any fixture on any platform: a screenshot is a deliberate one-off, not the check matrix.
 function selectTarget(root, values) {
-    const { fixture, platform, appearance, card } = values;
+    const { fixture, platform, appearance, card, delivery } = values;
     if (![...Object.keys(FIXTURE_NAMES), ...extraFixtures(root)].includes(fixture)) {
         throw new ThemeError(`unknown fixture: ${fixture}`);
     }
     return new RenderTarget(fixture, platform, appearance, {
         card: !!card,
+        delivery: delivery,
     });
 }
 export default async function screenshot({ values }) {
@@ -19,7 +20,11 @@ export default async function screenshot({ values }) {
     const theme = findTheme(root);
     const target = selectTarget(root, values);
     const site = renderSite(root, theme, [target]);
-    const results = await checkPages(site, [target], undefined, expectations(root, [target]));
+    const warned = {};
+    const expected = expectations(root, [target]);
+    const results = await checkPages(site, [target], undefined, expected, warned);
+    for (const warning of warned[target.slug] ?? [])
+        console.log(`Warning: ${warning}`);
     const failures = results[target.slug] ?? [];
     if (failures.length) {
         throw new ThemeError(`screenshot checks failed:\n- ${failures.join("\n- ")}`);

package/dist/commands.js

@@ -1,5 +1,6 @@
 // The one description of the command line: the parser, help, and shell completion
 // are all generated from it, so they cannot drift apart.
+import { DELIVERIES } from "./delivery.js";
 export const PROGRAM = "nnw-theme";
 export const DESCRIPTION = "Create, preview, check, and publish a NetNewsWire theme.";
 export const GUIDE_TOPICS = [
@@ -18,6 +19,7 @@ export const BUILT_IN_FIXTURE_NAMES = ["article", "kitchen-sink"];
  */
 export const CATALOG_FIXTURES = {
     ghost: "Ghost cards, galleries, and lazy images",
+    mastodon: "Mastodon post: mentions, hashtags, custom emoji, image enclosures",
     medium: "Medium figures, unsized images, and footer",
     "media-rss": "Image, video, and YouTube enclosures with captions",
     podcast: "Podcast audio enclosure and episode artwork",
@@ -112,7 +114,7 @@ export const COMMANDS = [
         name: "screenshot",
         summary: "check one case in WebKit and save its image",
         description: "Render and check a single case in WebKit and save its full-page screenshot: any " +
-            "fixture, on any platform. With --card, capture an 800x552 viewport at 2x, the " +
+            "fixture, on any platform, directly or --delivery through a sync service. With --card, capture an 800x552 viewport at 2x, the " +
             "shape of the marketplace card. With --promote, it becomes " +
             "screenshots/theme-preview.png, the marketplace card.",
         options: [
@@ -125,6 +127,12 @@ export const COMMANDS = [
             },
             { name: "platform", type: "string", choices: ["mac", "iphone", "ipad"], default: "mac" },
             { name: "appearance", type: "string", choices: ["light", "dark"], default: "light" },
+            {
+                name: "delivery",
+                type: "string",
+                choices: DELIVERIES,
+                help: "render the fixture as this sync service delivers it",
+            },
             { name: "card", type: "boolean", help: "capture the marketplace card's shape at 2x" },
             { name: "promote", type: "boolean", help: "use it as the marketplace screenshot" },
         ],
@@ -136,7 +144,7 @@ export const COMMANDS = [
     },
     {
         name: "fixture",
-        summary: "add fixtures modeled on WordPress, Ghost, Substack, and Medium",
+        summary: "add fixtures modeled on WordPress, Ghost, Substack, Medium, and Mastodon",
         description: "Copy ready-made fixtures with markup modeled on what major publishing platforms " +
             "send into fixtures/, where preview and check pick them up. Each one adds four " +
             "renders to every check.",