evolutionary-arcade 0.2.1 → 0.4.0

package/dist/cli.js

@@ -13,7 +13,7 @@ import { dirname, isAbsolute, join } from "path";
 // package.json
 var package_default = {
   name: "evolutionary-arcade",
-  version: "0.2.1",
+  version: "0.4.0",
   description: "The arcade CLI for Evolutionary Arcade. Publish, update, regen, fork, and blend AI-made browser games with your own coding agent.",
   type: "module",
   license: "MIT",
@@ -5693,7 +5693,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve5) {
+function isRecursive(inst, stack, resolve6) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -5703,7 +5703,7 @@ function isRecursive(inst, stack, resolve5) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve5);
+      const answer = isRecursive(child, stack, resolve6);
       if (answer > result)
         result = answer;
     }
@@ -5714,7 +5714,7 @@ function isRecursive(inst, stack, resolve5) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve5) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve6) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -5778,7 +5778,7 @@ function isRecursive(inst, stack, resolve5) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve5 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve6 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -20592,6 +20592,14 @@ var videoPath = relPath.refine(
   (p) => ["mp4", "webm"].includes(ext(p)),
   "Use an .mp4 or .webm video."
 );
+var ORIENTATIONS = ["landscape", "portrait", "both"];
+var verticalMediaSchema = external_exports.object({
+  thumbnail: imagePath.optional(),
+  screenshots: external_exports.array(imagePath).max(12).default([]),
+  demo_video: videoPath.optional(),
+  preview_video: videoPath.optional(),
+  preview_gif: gifPath.optional()
+});
 var sourceSchema = external_exports.object({
   repo: external_exports.string().regex(
     /^https:\/\/github\.com\/[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})\/[A-Za-z0-9._-]{1,100}$/,
@@ -20638,6 +20646,8 @@ var arcadeSchema = external_exports.object({
   // play: "someone remixed your game" emails and link previews. The CLI requires it whenever
   // there's a demo.
   preview_gif: gifPath.optional(),
+  orientation: external_exports.enum(ORIENTATIONS).default("landscape"),
+  media_vertical: verticalMediaSchema.optional(),
   lineage: lineageSchema.default({ kind: "original", parents: [] }),
   provenance: provenanceSchema.default({ subagent_models: [] }),
   source: sourceSchema.optional()
@@ -20649,6 +20659,20 @@ var arcadeSchema = external_exports.object({
       message: "A game can't be its own parent."
     });
   }
+  if (a.orientation !== "landscape" && a.input.touch) {
+    const v = a.media_vertical;
+    const missing = [
+      !v?.thumbnail && "a thumbnail",
+      !v?.screenshots.length && "at least one screenshot",
+      a.demo_video && !v?.demo_video && "a demo"
+    ].filter((x) => typeof x === "string");
+    if (missing.length)
+      ctx.addIssue({
+        code: "custom",
+        path: ["media_vertical"],
+        message: `A ${a.orientation === "both" ? "game that also plays upright" : "portrait game"} needs vertical media from real play at 390x844: ${missing.join(", ")}.`
+      });
+  }
   const ids = a.leaderboards.map((b) => b.id);
   ids.forEach((id, i) => {
     if (ids.indexOf(id) !== i)
@@ -20695,6 +20719,11 @@ var friendlyIssue = (iss) => {
       if (limit) return `Use up to ${limit} screenshots.`;
       if (missing) return "Add at least one screenshot.";
       break;
+    case "orientation":
+      return 'Use "landscape", "portrait", or "both": the way the game plays on a phone.';
+    case "media_vertical.screenshots":
+      if (limit) return `Use up to ${limit} vertical screenshots.`;
+      break;
     case "lineage.kind":
       return "lineage.kind was changed; re-run the arcade command that made this folder.";
     case "lineage.parents":
@@ -21023,6 +21052,68 @@ function normalizeModel(raw) {
   return { name: raw.trim(), family, listed: false };
 }
 
+// ../format/src/shareText.ts
+var ARCADE_NAME = "Evolutionary Arcade";
+var gameUrl = (origin, slug) => `${origin}/g/${slug}`;
+var profileUrl = (origin, handle) => `${origin}/u/${handle}`;
+var creditName = (c) => c.x ? `@${c.x.replace(/^@/, "")}` : c.handle;
+var X_LIMIT = 280;
+var X_LINK = 23;
+function xLength(text) {
+  return [...text.replace(/https?:\/\/\S+/g, "x".repeat(X_LINK))].length;
+}
+var xIntentUrl = (text) => `https://x.com/intent/post?text=${encodeURIComponent(text)}`;
+var listOf = (items) => items.length <= 2 ? items.join(" and ") : `${items.slice(0, -1).join(", ")}, and ${items[items.length - 1]}`;
+function fit(build) {
+  for (let max = 80; max >= 8; max -= 4) {
+    const text = build((t) => t.length > max ? `${t.slice(0, max - 1).trimEnd()}\u2026` : t);
+    if (xLength(text) <= X_LIMIT) return text;
+  }
+  return build((t) => t.slice(0, 8));
+}
+function descriptionLine(game) {
+  return `Play ${game.title} in your browser (and remix it): ${gameUrl(game.origin, game.slug)}`;
+}
+function publishShare(game) {
+  const url2 = gameUrl(game.origin, game.slug);
+  if (game.version && game.version > 1)
+    return fit(
+      (cut) => `${cut(game.title)} v${game.version} is live on ${ARCADE_NAME}. Play it in your browser, then remix it: ${url2}`
+    );
+  return fit(
+    (cut) => `I made ${cut(game.title)}, a browser game you can play right now. It's open source, so you can remix it too: ${url2}`
+  );
+}
+function remixShare(game) {
+  const url2 = gameUrl(game.origin, game.slug);
+  const parents = game.parents ?? [];
+  if (!parents.length) return publishShare(game);
+  return fit((cut) => {
+    const credits = parents.map((p) => `${cut(p.title)} by ${creditName(p)}`);
+    return game.kind === "blend" ? `I blended ${listOf(credits)} into ${cut(game.title)}. Play it in your browser: ${url2}` : `I remixed ${credits[0]} into ${cut(game.title)}. Play it in your browser: ${url2}`;
+  });
+}
+function libraryShare(opts) {
+  const n = opts.games === 1 ? "a game" : `${opts.games} games`;
+  return `I put ${n} on ${ARCADE_NAME}. Play in your browser, no account needed, and remix anything: ${profileUrl(opts.origin, opts.handle)}`;
+}
+var libraryDescriptionLine = (origin, handle) => `Play my games (and remix them): ${profileUrl(origin, handle)}`;
+var shareDraft = (game) => game.kind === "fork" || game.kind === "blend" ? remixShare(game) : publishShare(game);
+function badgeUrls(t, theme = "light") {
+  const path = t.slug ? `/badge/${t.slug}.svg` : `/badge/u/${t.handle}.svg`;
+  const link = t.slug ? gameUrl(t.origin, t.slug) : profileUrl(t.origin, t.handle ?? "");
+  return { image: `${t.origin}${path}${theme === "dark" ? "?theme=dark" : ""}`, link };
+}
+var BADGE_ALT = `Play on ${ARCADE_NAME}`;
+function badgeMarkdown(t, theme = "light") {
+  const { image, link } = badgeUrls(t, theme);
+  return `[![${BADGE_ALT}](${image})](${link})`;
+}
+function badgeHtml(t, theme = "light") {
+  const { image, link } = badgeUrls(t, theme);
+  return `<a href="${link}"><img src="${image}" alt="${BADGE_ALT}" height="36"></a>`;
+}
+
 // src/commands/games.ts
 var STARTER_DESCRIPTION = "What a player reads on the card. One or two sentences.";
 var STARTER_CONTROLS = "WASD move, mouse aim, click to act";
@@ -21136,7 +21227,9 @@ function derived2(src, overrides) {
     "screenshots",
     "demo_video",
     "preview_video",
-    "preview_gif"
+    "preview_gif",
+    "orientation",
+    "media_vertical"
   ];
   const out2 = { schema: "arcade/v0" };
   for (const k of keep) if (a[k] !== void 0) out2[k] = a[k];
@@ -21438,8 +21531,8 @@ function dev(dirArg, opts) {
 
 // src/commands/publish.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync7, statSync as statSync5, writeFileSync as writeFileSync3 } from "fs";
-import { isAbsolute as isAbsolute2, join as join5, relative as relative2, resolve as resolve3, sep as sep4 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync8, statSync as statSync5, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join6, relative as relative2, resolve as resolve4, sep as sep4 } from "path";
 
 // src/files.ts
 import { createHash as createHash2 } from "crypto";
@@ -21523,6 +21616,7 @@ function walkGame(root) {
 
 // src/fixes.ts
 var CAPTURE_GUIDE = 'arcade guide publishing, "Capturing media"';
+var VERTICAL = "media/vertical";
 var thumbnailFix = (path) => `Run the game (arcade dev), capture a 1280x720 frame of real play, mid-action with no title screen or added text, and save it as ${path}.`;
 var screenshotFix = (path) => `Capture a different moment of real play at 1280x720 and save it as ${path}. Aim for 2 to 4 screenshots in all.`;
 var demoFix = (path) => `Record 15 to 30 s of real play at 1280x720 as H.264 and save it as ${path}, with the action starting in the first second (${CAPTURE_GUIDE}).`;
@@ -21552,6 +21646,10 @@ function fixFor(issue2, raw) {
     return `${screenshotFix("media/shot-1.png")} List the paths in "screenshots".`;
   if (path === "demo_video") return `${demoFix("media/demo.mp4")} Then set "demo_video".`;
   if (path === "preview_video" || path === "preview_gif") return fromDemoFix;
+  if (path === "orientation")
+    return 'Play the game on a phone (390x844 with touch): "landscape" if it needs the phone sideways, "portrait" if it plays upright, "both" if it works either way.';
+  if (path === "media_vertical" || path.startsWith("media_vertical."))
+    return `Run the game at 390x844 with touch emulation and capture upright play into ${VERTICAL}/ (thumbnail.png, shot-1.png, and demo.mp4 if the game has a landscape demo), list them under "media_vertical", then run \`arcade media vertical\` for the preview and GIF (${CAPTURE_GUIDE}). If the game really only plays sideways, set "orientation": "landscape" instead.`;
   if (path === "title") return `Set "title" to the game's name as players should see it.`;
   if (path === "description")
     return 'Set "description" to one or two sentences: the fantasy and the goal.';
@@ -21567,6 +21665,10 @@ function missingMediaLine(path, raw) {
   if (raw.demo_video === path) return `${path} (demo): ${demoFix(path)}`;
   if (raw.preview_video === path) return `${path} (hover preview): ${fromDemoFix}`;
   if (raw.preview_gif === path) return `${path} (GIF): ${fromDemoFix}`;
+  const v = raw.media_vertical ?? {};
+  const vertical = [v.thumbnail, v.demo_video, v.preview_video, v.preview_gif].includes(path) || Array.isArray(v.screenshots) && v.screenshots.includes(path);
+  if (vertical)
+    return `${path} (vertical): ${raw.orientation === "portrait" || raw.orientation === "both" ? `capture it from real play at 390x844 with touch; previews and GIFs come from \`arcade media vertical\`.` : "run `arcade media vertical` to make the vertical set from the landscape media."}`;
   return path;
 }
 
@@ -21731,10 +21833,203 @@ function missingSessions(named) {
   return named.filter((id) => !found.has(id));
 }
 
+// src/commands/share.ts
+import { existsSync as existsSync5, readFileSync as readFileSync7 } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join5, resolve as resolve3 } from "path";
+var X_HOSTS = /* @__PURE__ */ new Set([
+  "x.com",
+  "www.x.com",
+  "twitter.com",
+  "www.twitter.com",
+  "mobile.twitter.com"
+]);
+var X_RESERVED = /* @__PURE__ */ new Set([
+  "intent",
+  "home",
+  "i",
+  "share",
+  "search",
+  "explore",
+  "hashtag",
+  "settings"
+]);
+function xHandleFromLinks(links) {
+  for (const l of links) {
+    try {
+      const u = new URL(l.url);
+      const name = u.pathname.split("/").filter(Boolean)[0];
+      if (X_HOSTS.has(u.hostname) && name && !X_RESERVED.has(name.toLowerCase()) && /^[A-Za-z0-9_]{1,15}$/.test(name))
+        return name;
+    } catch {
+    }
+  }
+  return null;
+}
+async function xHandle(handle) {
+  try {
+    const p = await request(`/api/users/${encodeURIComponent(handle)}`, {
+      auth: false
+    });
+    return xHandleFromLinks(p.user.links ?? []);
+  } catch {
+    return null;
+  }
+}
+var badges = (t) => ({
+  markdown: badgeMarkdown(t),
+  html: badgeHtml(t),
+  markdownDark: badgeMarkdown(t, "dark"),
+  htmlDark: badgeHtml(t, "dark")
+});
+function findGif(slug, dir, hosted) {
+  const folders = [dir, process.cwd(), join5(homedir3(), "arcade-games", slug)].filter(
+    (d) => Boolean(d)
+  );
+  for (const folder of folders) {
+    try {
+      const raw = JSON.parse(readFileSync7(join5(folder, "arcade.json"), "utf8"));
+      if (raw.slug !== slug || typeof raw.preview_gif !== "string") continue;
+      const path = resolve3(folder, raw.preview_gif);
+      if (existsSync5(path)) return path;
+    } catch {
+    }
+  }
+  return hosted ? new URL(hosted, apiUrl()).href : null;
+}
+async function gameShare(slug, opts = {}) {
+  const d = await fetchGame(slug);
+  if (!d || d.removed || !d.game.title) throw noSuchGame(slug);
+  const origin = apiUrl();
+  const handles = [...new Set((d.parents ?? []).map((p) => p.owner))];
+  const xs = new Map(await Promise.all(handles.map(async (h) => [h, await xHandle(h)])));
+  const parents = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const p of d.parents ?? []) {
+    if (seen.has(p.slug)) continue;
+    seen.add(p.slug);
+    parents.push({ title: p.title, handle: p.owner, x: xs.get(p.owner) ?? null });
+  }
+  const kind = d.game.kind ?? (parents.length > 1 ? "blend" : parents.length ? "fork" : "original");
+  const game = {
+    origin,
+    slug: d.game.slug,
+    title: d.game.title,
+    kind,
+    parents,
+    version: opts.version ?? d.generation?.version
+  };
+  const post = shareDraft(game);
+  const hostedGif = d.game.gifUrl ?? null;
+  return {
+    kind: "game",
+    slug: d.game.slug,
+    title: d.game.title,
+    url: gameUrl(origin, d.game.slug),
+    description: descriptionLine(game),
+    post,
+    postLength: xLength(post),
+    xIntent: xIntentUrl(post),
+    gif: findGif(d.game.slug, opts.dir, hostedGif),
+    badge: badges({ origin, slug: d.game.slug })
+  };
+}
+async function signedInHandle() {
+  const me = await request("/api/me");
+  if (!me.user?.handle) throw new ExitError("You're not signed in. Run `arcade login`.");
+  return me.user.handle;
+}
+async function profileShare(handleArg) {
+  const handle = (handleArg ?? await signedInHandle()).replace(/^@/, "");
+  const origin = apiUrl();
+  let profile;
+  try {
+    profile = await request(`/api/users/${encodeURIComponent(handle)}`, {
+      auth: false
+    });
+  } catch (e) {
+    if (e instanceof ApiError && e.status === 404)
+      throw new ExitError(`No creator called @${handle} on the arcade.`);
+    throw e;
+  }
+  const list = await request(
+    `/api/games?owner=${encodeURIComponent(handle)}&sort=new&limit=60`,
+    { auth: false }
+  );
+  const post = libraryShare({ origin, handle, games: profile.stats.games });
+  return {
+    kind: "profile",
+    handle,
+    url: profileUrl(origin, handle),
+    description: libraryDescriptionLine(origin, handle),
+    post,
+    postLength: xLength(post),
+    xIntent: xIntentUrl(post),
+    games: list.games.map((g) => ({ slug: g.slug, title: g.title, url: gameUrl(origin, g.slug) })),
+    badge: badges({ origin, handle })
+  };
+}
+function printBadge(b) {
+  out(bold("Badge for a README, itch page, or website:"));
+  out(`  Markdown (light): ${b.markdown}`);
+  out(`  Markdown (dark):  ${b.markdownDark}`);
+  out(`  HTML (light):     ${b.html}`);
+  out(`  HTML (dark):      ${b.htmlDark}`);
+}
+function printShare(s, opts = {}) {
+  out("");
+  out(pink(bold("Share it")) + dim("  (drafts for you to post; the arcade never posts for you)"));
+  out(`  Link:              ${cyan(s.url)}`);
+  out(`  Video description: ${s.description}`);
+  out(`  X post (${s.postLength}/280):`);
+  out(`    ${s.post}`);
+  out(`  Post it on X:      ${s.xIntent}`);
+  if (s.kind === "game")
+    out(
+      `  Attach this GIF:   ${s.gif ?? "none yet (run arcade media preview in the game folder, then publish)"}`
+    );
+  else for (const g of s.games) out(`    ${g.title}  ${dim(g.url)}`);
+  if (opts.badge) {
+    out("");
+    printBadge(s.badge);
+  } else
+    out(
+      dim(
+        `  Badge for your README or itch page: arcade share ${s.kind === "game" ? s.slug : "--profile"} --badge`
+      )
+    );
+}
+async function share(slug, opts) {
+  if (!slug && !opts.profile)
+    throw new ExitError(
+      "Name a game (arcade share <slug>), or use --profile for your whole library.",
+      2
+    );
+  const s = opts.profile ? await profileShare(typeof opts.profile === "string" ? opts.profile : void 0) : await gameShare(slug);
+  if (opts.json) {
+    printJson(s);
+    return;
+  }
+  if (opts.badge && !opts.json) {
+    out(`${bold(s.kind === "game" ? s.title : `@${s.handle}`)} ${cyan(s.url)}`);
+    out("");
+    printBadge(s.badge);
+    return;
+  }
+  printShare(s);
+}
+async function shareAfterPublish(slug, dir, version2) {
+  try {
+    printShare(await gameShare(slug, { dir, version: version2 }));
+  } catch {
+    out(dim(`Share it later: arcade share ${slug}`));
+  }
+}
+
 // src/commands/publish.ts
 function readArcadeRaw(dir) {
-  const path = join5(dir, "arcade.json");
-  if (!existsSync5(path))
+  const path = join6(dir, "arcade.json");
+  if (!existsSync6(path))
     throw new ExitError(
       `No arcade.json in ${dir}. Write one at the top of the game folder with at least these fields (arcade guide publishing has a full example):`,
       2,
@@ -21742,7 +22037,7 @@ function readArcadeRaw(dir) {
       "Starting a brand-new game instead? arcade new <slug>"
     );
   try {
-    return JSON.parse(readFileSync7(path, "utf8"));
+    return JSON.parse(readFileSync8(path, "utf8"));
   } catch (e) {
     throw new ExitError(`arcade.json isn't valid JSON: ${e.message}`, 2);
   }
@@ -21765,17 +22060,18 @@ function runFfmpeg(args, what) {
     throw new ExitError(`ffmpeg couldn't make the ${what}${last ? `: ${last}` : "."}`);
   }
 }
-function makePreview(dir, demo, target = "media/preview.mp4") {
+function makePreview(dir, demo, target = "media/preview.mp4", scale = "scale=854:-2") {
   if (!hasFfmpeg()) return null;
+  mkdirSync3(dirname3(join6(dir, target)), { recursive: true });
   runFfmpeg(
     [
       "-i",
-      join5(dir, demo),
+      join6(dir, demo),
       "-t",
       "12",
       "-an",
       "-vf",
-      "scale=854:-2,fps=30",
+      `${scale},fps=30`,
       "-c:v",
       "libx264",
       "-preset",
@@ -21786,16 +22082,20 @@ function makePreview(dir, demo, target = "media/preview.mp4") {
       "yuv420p",
       "-movflags",
       "+faststart",
-      join5(dir, target)
+      join6(dir, target)
     ],
     "preview"
   );
   return target;
 }
 var MAX_GIF_BYTES = 5 * 1024 * 1024;
-function makeGif(dir, demo, target = "media/preview.gif") {
+function makeGif(dir, demo, target = "media/preview.gif", vertical = false) {
   if (!hasFfmpeg()) return null;
-  const tries = [
+  mkdirSync3(dirname3(join6(dir, target)), { recursive: true });
+  const tries = vertical ? [
+    { width: 360, fps: 12, seconds: 6 },
+    { width: 270, fps: 10, seconds: 5 }
+  ] : [
     { width: 480, fps: 12, seconds: 6 },
     { width: 360, fps: 10, seconds: 5 }
   ];
@@ -21803,7 +22103,7 @@ function makeGif(dir, demo, target = "media/preview.gif") {
     runFfmpeg(
       [
         "-i",
-        join5(dir, demo),
+        join6(dir, demo),
         "-t",
         String(t.seconds),
         "-an",
@@ -21811,16 +22111,165 @@ function makeGif(dir, demo, target = "media/preview.gif") {
         `fps=${t.fps},scale=${t.width}:-2:flags=lanczos,split[a][b];[a]palettegen=max_colors=128:stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=4`,
         "-loop",
         "0",
-        join5(dir, target)
+        join6(dir, target)
       ],
       "GIF"
     );
-    if (statSync5(join5(dir, target)).size <= MAX_GIF_BYTES) return target;
+    if (statSync5(join6(dir, target)).size <= MAX_GIF_BYTES) return target;
   }
   throw new ExitError(
     `The GIF came out over ${MAX_GIF_BYTES / 1024 / 1024} MB, even small. Re-cut the demo so its first 5 seconds are less busy (a later -ss), then run \`arcade media preview\` again.`
   );
 }
+var VERTICAL_W = 1080;
+var VERTICAL_H = 1920;
+var BLURRED_FILL = [
+  "split=2[bg][fg]",
+  `[bg]scale=${VERTICAL_W}:${VERTICAL_H}:force_original_aspect_ratio=increase,crop=${VERTICAL_W}:${VERTICAL_H},scale=270:480,gblur=sigma=10,scale=${VERTICAL_W}:${VERTICAL_H},eq=brightness=-0.22:saturation=1.1[b]`,
+  `[fg]scale=${VERTICAL_W}:-2[f]`,
+  "[b][f]overlay=(W-w)/2:(H-h)/2"
+].join(";");
+var MAX_VIDEO_BYTES = 25 * 1024 * 1024;
+var VERTICAL_DIR = "media/vertical";
+function fillImage(dir, src, target) {
+  if (!hasFfmpeg()) return null;
+  mkdirSync3(dirname3(join6(dir, target)), { recursive: true });
+  runFfmpeg(
+    [
+      "-i",
+      join6(dir, src),
+      "-filter_complex",
+      BLURRED_FILL,
+      "-frames:v",
+      "1",
+      "-q:v",
+      "3",
+      join6(dir, target)
+    ],
+    `vertical version of ${src}`
+  );
+  return target;
+}
+function fillDemo(dir, demo, target = `${VERTICAL_DIR}/demo.mp4`) {
+  if (!hasFfmpeg()) return null;
+  mkdirSync3(dirname3(join6(dir, target)), { recursive: true });
+  for (const crf of ["28", "34"]) {
+    runFfmpeg(
+      [
+        "-i",
+        join6(dir, demo),
+        "-t",
+        "30",
+        "-an",
+        "-filter_complex",
+        `${BLURRED_FILL},fps=30,format=yuv420p`,
+        "-c:v",
+        "libx264",
+        "-preset",
+        "veryfast",
+        "-crf",
+        crf,
+        "-movflags",
+        "+faststart",
+        join6(dir, target)
+      ],
+      "vertical demo"
+    );
+    if (statSync5(join6(dir, target)).size <= MAX_VIDEO_BYTES) return target;
+  }
+  throw new ExitError(
+    `The vertical demo came out over ${MAX_VIDEO_BYTES / 1024 / 1024} MB. Record a shorter demo (15 to 20 s), then run \`arcade media vertical\` again.`
+  );
+}
+var orientationOf = (raw) => raw.orientation === "portrait" || raw.orientation === "both" ? raw.orientation : "landscape";
+var verticalOf = (raw) => raw.media_vertical && typeof raw.media_vertical === "object" ? { ...raw.media_vertical } : {};
+var exists = (dir, p) => typeof p === "string" && existsSync6(join6(dir, p));
+function fillVerticalSet(dir, raw) {
+  const v = verticalOf(raw);
+  const made = [];
+  const skipped = [];
+  const image = (src, target) => {
+    try {
+      made.push(fillImage(dir, src, target));
+      return target;
+    } catch (e) {
+      if (!(e instanceof ExitError)) throw e;
+      skipped.push(e.message);
+      return null;
+    }
+  };
+  if (exists(dir, raw.thumbnail)) {
+    const t = image(raw.thumbnail, `${VERTICAL_DIR}/thumbnail.jpg`);
+    if (t) v.thumbnail = t;
+  }
+  if (Array.isArray(raw.screenshots)) {
+    v.screenshots = raw.screenshots.filter((p) => exists(dir, p)).map((p, i) => image(p, `${VERTICAL_DIR}/shot-${i + 1}.jpg`)).filter((p) => p !== null);
+  }
+  if (exists(dir, raw.demo_video)) {
+    v.demo_video = fillDemo(dir, raw.demo_video);
+    v.preview_video = makePreview(
+      dir,
+      v.demo_video,
+      `${VERTICAL_DIR}/preview.mp4`,
+      "scale=-2:854"
+    );
+    v.preview_gif = makeGif(dir, v.demo_video, `${VERTICAL_DIR}/preview.gif`, true);
+    made.push(v.demo_video, v.preview_video, v.preview_gif);
+  }
+  if (made.length) raw.media_vertical = v;
+  return { made, skipped };
+}
+function ensureVertical(dir, raw) {
+  const v = verticalOf(raw);
+  const save = () => writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+`);
+  if (orientationOf(raw) === "landscape") {
+    const needDemo = exists(dir, raw.demo_video) && !v.demo_video;
+    const needThumb = exists(dir, raw.thumbnail) && !v.thumbnail;
+    if (!needDemo && !needThumb) return;
+    if (!hasFfmpeg()) {
+      if (needDemo)
+        throw new ExitError(
+          "This game has a demo, so phones need a vertical cut of it (over a blurred fill), and that takes ffmpeg.",
+          2,
+          [NO_FFMPEG],
+          "Then run `arcade media vertical` (or publish again, which makes it for you)."
+        );
+      out(
+        dim("No vertical thumbnail: ffmpeg isn't installed. Phones will show the landscape one.")
+      );
+      return;
+    }
+    const { made, skipped } = fillVerticalSet(dir, raw);
+    if (made.length) save();
+    if (made.length)
+      out(
+        dim(
+          `Made the vertical set for phones, over a blurred fill (${plural(made.length, "file")} in ${VERTICAL_DIR}/).`
+        )
+      );
+    for (const m of skipped)
+      out(yellow(`No vertical copy: ${m} Phones will show the landscape one.`));
+    return;
+  }
+  if (exists(dir, v.demo_video) && !v.preview_gif) {
+    if (!hasFfmpeg())
+      throw new ExitError("The vertical demo needs a GIF made from it, and that takes ffmpeg.", 2, [
+        NO_FFMPEG
+      ]);
+    const made = cutVerticalPreviews(dir, raw);
+    save();
+    out(dim(`Made a vertical preview and GIF from the vertical demo (${made.join(", ")}).`));
+  }
+}
+function cutVerticalPreviews(dir, raw) {
+  const v = verticalOf(raw);
+  if (!exists(dir, v.demo_video)) return [];
+  v.preview_video = makePreview(dir, v.demo_video, `${VERTICAL_DIR}/preview.mp4`, "scale=-2:854");
+  v.preview_gif = makeGif(dir, v.demo_video, `${VERTICAL_DIR}/preview.gif`, true);
+  raw.media_vertical = v;
+  return [v.preview_video, v.preview_gif];
+}
 var NO_FFMPEG = "ffmpeg isn't installed. Install it (macOS: `brew install ffmpeg`, Ubuntu: `sudo apt install ffmpeg`, Windows: `winget install ffmpeg`) and try again.";
 function demoFor(dir, raw, what) {
   if (typeof raw.demo_video !== "string")
@@ -21828,7 +22277,7 @@ function demoFor(dir, raw, what) {
       `arcade.json has no demo_video to make ${what} from. Record 15-30 s of real play at 1280x720 into media/demo.mp4 and set "demo_video": "media/demo.mp4" (arcade guide publishing, "Capturing media").`,
       2
     );
-  if (!existsSync5(join5(dir, raw.demo_video)))
+  if (!existsSync6(join6(dir, raw.demo_video)))
     throw new ExitError(
       `${raw.demo_video} isn't in the folder yet. Record a demo first (see arcade-publishing).`,
       2
@@ -21836,7 +22285,7 @@ function demoFor(dir, raw, what) {
   return raw.demo_video;
 }
 async function mediaPreview(dirArg) {
-  const dir = resolve3(dirArg ?? ".");
+  const dir = resolve4(dirArg ?? ".");
   const raw = readArcadeRaw(dir);
   const demo = demoFor(dir, raw, "a preview");
   const made = makePreview(dir, demo);
@@ -21845,21 +22294,51 @@ async function mediaPreview(dirArg) {
   if (!gif) throw new ExitError(NO_FFMPEG);
   raw.preview_video = made;
   raw.preview_gif = gif;
-  writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+  writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
   out(
-    `Made ${made} and ${gif} (${mb(statSync5(join5(dir, gif)).size)}) and added them to arcade.json.`
+    `Made ${made} and ${gif} (${mb(statSync5(join6(dir, gif)).size)}) and added them to arcade.json.`
   );
 }
 async function mediaGif(dirArg) {
-  const dir = resolve3(dirArg ?? ".");
+  const dir = resolve4(dirArg ?? ".");
   const raw = readArcadeRaw(dir);
   const gif = makeGif(dir, demoFor(dir, raw, "a GIF"));
   if (!gif) throw new ExitError(NO_FFMPEG);
   raw.preview_gif = gif;
-  writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+  writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+`);
+  out(`Made ${gif} (${mb(statSync5(join6(dir, gif)).size)}) and added it to arcade.json.`);
+}
+async function mediaVertical(dirArg) {
+  const dir = resolve4(dirArg ?? ".");
+  const raw = readArcadeRaw(dir);
+  if (!hasFfmpeg()) throw new ExitError(NO_FFMPEG);
+  const orientation = orientationOf(raw);
+  let made;
+  if (orientation === "landscape") {
+    if (!exists(dir, raw.thumbnail))
+      throw new ExitError(
+        `The vertical set is made from the landscape media, and ${typeof raw.thumbnail === "string" ? `${raw.thumbnail} isn't in the folder yet` : "arcade.json has no thumbnail"}. Capture the landscape media first (${CAPTURE_GUIDE}).`,
+        2
+      );
+    const r = fillVerticalSet(dir, raw);
+    made = r.made;
+    for (const m of r.skipped) out(yellow(`Skipped: ${m}`));
+  } else {
+    made = cutVerticalPreviews(dir, raw);
+    if (!made.length)
+      throw new ExitError(
+        `This game plays ${orientation === "portrait" ? "upright" : "both ways"}, so its vertical media comes from real upright play, not a blurred fill. Record 15 to 30 s at 390x844 with touch into ${VERTICAL_DIR}/demo.mp4, set "media_vertical.demo_video", then run this again (${CAPTURE_GUIDE}).`,
+        2
+      );
+  }
+  writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
-  out(`Made ${gif} (${mb(statSync5(join5(dir, gif)).size)}) and added it to arcade.json.`);
+  out(
+    `Made ${plural(made.length, "vertical file")} (${orientation === "landscape" ? "landscape media over a blurred fill, 1080x1920" : "cut from your vertical demo"}) and set media_vertical:`
+  );
+  for (const m of made) out(`  ${m} ${dim(mb(statSync5(join6(dir, m)).size))}`);
 }
 function describeAction(p, parentNames) {
   switch (p.action) {
@@ -21920,6 +22399,19 @@ function listWords(words) {
   if (words.length <= 1) return words.join("");
   return `${words.slice(0, -1).join(", ")}${words.length > 2 ? "," : ""} and ${words.at(-1)}`;
 }
+var FULLSCREEN_CALL = /\b(?:request|webkitRequest|mozRequest|msRequest)Full[sS]creen\b/;
+var CODE_FILE = /\.(?:html?|m?js|jsx|tsx?)$/i;
+function fullscreenCalls(files) {
+  const hits = [];
+  for (const f of files) {
+    if (!CODE_FILE.test(f.path) || f.path.startsWith("parents/") || f.size > 2 * 1024 * 1024)
+      continue;
+    const lines = readFileSync8(f.abs, "utf8").split("\n");
+    const i = lines.findIndex((l) => FULLSCREEN_CALL.test(l));
+    if (i >= 0) hits.push(`${f.path}:${i + 1}`);
+  }
+  return hits;
+}
 var HOME_PATH = /(?:\/Users\/|\/home\/|[A-Za-z]:\\Users\\)[^\s/\\"'`]+/;
 function headsUp(arcade, files, alreadyOnArcade, secretWarnings, dir) {
   const notes = [];
@@ -21992,7 +22484,7 @@ function headsUp(arcade, files, alreadyOnArcade, secretWarnings, dir) {
     );
   const age = (p2) => {
     try {
-      return p2 ? statSync5(join5(dir, p2)).mtimeMs : null;
+      return p2 ? statSync5(join6(dir, p2)).mtimeMs : null;
     } catch {
       return null;
     }
@@ -22006,6 +22498,26 @@ function headsUp(arcade, files, alreadyOnArcade, secretWarnings, dir) {
     notes.push(
       `The ${stale.map(([w]) => w).join(" and ")} ${stale.length > 1 ? "are" : "is"} older than the demo. Run \`arcade media preview\` to remake ${stale.length > 1 ? "them" : "it"}.`
     );
+  const v = arcade.media_vertical;
+  if (arcade.orientation === "landscape") {
+    if (!v?.thumbnail)
+      notes.push(
+        "There's no vertical thumbnail, so phones show the landscape one. Run `arcade media vertical` (it needs ffmpeg)."
+      );
+    const vStale = [
+      ["vertical thumbnail", age(v?.thumbnail), age(arcade.thumbnail)],
+      ["vertical demo", age(v?.demo_video), demoAt]
+    ].filter(([, t, src]) => t !== null && src !== null && t < src);
+    if (vStale.length)
+      notes.push(
+        `The ${vStale.map(([w]) => w).join(" and ")} ${vStale.length > 1 ? "are" : "is"} older than the landscape media. Run \`arcade media vertical\` to remake the vertical set.`
+      );
+  }
+  const fullscreen = fullscreenCalls(files);
+  if (fullscreen.length)
+    notes.push(
+      `${listWords(fullscreen.slice(0, 3))}${fullscreen.length > 3 ? ` and ${fullscreen.length - 3} more` : ""} ${fullscreen.length > 1 ? "call" : "calls"} requestFullscreen: the arcade's player owns fullscreen; remove your fullscreen button.`
+    );
   const thumb = files.find((f) => f.path === arcade.thumbnail);
   if (thumb && thumb.size > 500 * 1024) {
     const webp = arcade.thumbnail.replace(/\.[^.]+$/, ".webp");
@@ -22028,9 +22540,9 @@ function headsUp(arcade, files, alreadyOnArcade, secretWarnings, dir) {
   return notes;
 }
 async function fillLicenseHolder(dir) {
-  const path = join5(dir, "LICENSE");
-  if (!existsSync5(path)) return;
-  const text = readFileSync7(path, "utf8");
+  const path = join6(dir, "LICENSE");
+  if (!existsSync6(path)) return;
+  const text = readFileSync8(path, "utf8");
   if (!text.includes(LICENSE_HOLDER_PLACEHOLDER)) return;
   const handle = savedLogin()?.handle ?? (await request("/api/me").catch(() => null))?.user?.handle;
   if (!handle) return;
@@ -22053,14 +22565,14 @@ async function publish(dirArg, opts) {
       );
     useStdoutForJson();
   }
-  const dir = resolve3(dirArg ?? ".");
+  const dir = resolve4(dirArg ?? ".");
   const raw = readArcadeRaw(dir);
-  if (typeof raw.demo_video === "string" && !raw.preview_video && existsSync5(join5(dir, raw.demo_video))) {
+  if (typeof raw.demo_video === "string" && !raw.preview_video && existsSync6(join6(dir, raw.demo_video))) {
     try {
       const made = makePreview(dir, raw.demo_video);
       if (made) {
         raw.preview_video = made;
-        writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+        writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
         out(dim(`Made a 12 s hover preview (${made}).`));
       } else {
@@ -22075,7 +22587,7 @@ async function publish(dirArg, opts) {
       out(yellow(`No hover preview: ${e.message} Cards will show the thumbnail.`));
     }
   }
-  if (typeof raw.demo_video === "string" && !raw.preview_gif && existsSync5(join5(dir, raw.demo_video))) {
+  if (typeof raw.demo_video === "string" && !raw.preview_gif && existsSync6(join6(dir, raw.demo_video))) {
     const made = makeGif(dir, raw.demo_video);
     if (!made)
       throw new ExitError(
@@ -22085,10 +22597,11 @@ async function publish(dirArg, opts) {
         "Then run `arcade media preview` (or publish again, which makes it for you)."
       );
     raw.preview_gif = made;
-    writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+    writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
-    out(dim(`Made a GIF from the demo (${made}, ${mb(statSync5(join5(dir, made)).size)}).`));
+    out(dim(`Made a GIF from the demo (${made}, ${mb(statSync5(join6(dir, made)).size)}).`));
   }
+  ensureVertical(dir, raw);
   const prov = raw.provenance ?? {};
   const orch = prov.orchestrator ?? null;
   const named = opts.session ?? [];
@@ -22141,6 +22654,14 @@ async function publish(dirArg, opts) {
     throw new ExitError("A game with a demo needs a GIF made from it (preview_gif).", 2, [
       `${arcade.demo_video} (demo): record it first, then run \`arcade media preview\`.`
     ]);
+  if (arcade.media_vertical?.demo_video && !arcade.media_vertical.preview_gif)
+    throw new ExitError(
+      "The vertical demo needs a GIF made from it (media_vertical.preview_gif).",
+      2,
+      [
+        `${arcade.media_vertical.demo_video} (vertical demo): record it first, then run \`arcade media vertical\`.`
+      ]
+    );
   await fillLicenseHolder(dir);
   const { files, skipped, skippedLinks } = walkGame(dir);
   const bad = files.filter((f) => !f.type);
@@ -22151,14 +22672,19 @@ async function publish(dirArg, opts) {
       bad.map((f) => `${f.path}  (move it out of the folder, or delete it)`)
     );
   }
-  const notMit = files.filter((f) => isLicenseFile(f.path)).map((f) => licenseFileProblem(f.path, readFileSync7(f.abs, "utf8"))).filter((p) => p !== null);
+  const notMit = files.filter((f) => isLicenseFile(f.path)).map((f) => licenseFileProblem(f.path, readFileSync8(f.abs, "utf8"))).filter((p) => p !== null);
   if (notMit.length) throw new ExitError("The game's license needs fixing:", 2, notMit);
   const media = [
     arcade.thumbnail,
     ...arcade.screenshots,
     arcade.demo_video,
     arcade.preview_video,
-    arcade.preview_gif
+    arcade.preview_gif,
+    arcade.media_vertical?.thumbnail,
+    ...arcade.media_vertical?.screenshots ?? [],
+    arcade.media_vertical?.demo_video,
+    arcade.media_vertical?.preview_video,
+    arcade.media_vertical?.preview_gif
   ];
   const missingMedia = media.filter((m) => !!m && !files.some((f) => f.path === m));
   if (missingMedia.length) {
@@ -22185,7 +22711,7 @@ async function publish(dirArg, opts) {
       path: f.path,
       size: f.size,
       get bytes() {
-        return readFileSync7(f.abs);
+        return readFileSync8(f.abs);
       }
     })),
     arcade.play.root,
@@ -22323,7 +22849,7 @@ async function publish(dirArg, opts) {
     delete nextProv.build;
     nextProv.subagent_models = [];
     raw.provenance = nextProv;
-    writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+    writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
   }
   if (opts.json) {
@@ -22334,7 +22860,9 @@ async function publish(dirArg, opts) {
       version: result.version,
       generation: result.generation,
       main: result.main,
-      url: result.url
+      url: result.url,
+      // The drafts the agent shows the creator. Missing only if the arcade couldn't be read back.
+      share: await gameShare(result.slug, { dir, version: result.version }).catch(() => null)
     });
     return;
   }
@@ -22354,6 +22882,7 @@ async function publish(dirArg, opts) {
         `It's in the stack. The owner decides which generation is main (arcade main ${result.slug} ${result.generation}).`
       )
     );
+  await shareAfterPublish(result.slug, dir, result.version);
   if (becameUpdate)
     next(`keep building here. Publishing this folder again makes v${result.version + 1}.`);
   else next(`publishing this folder again adds another generation to v${result.version}'s stack.`);
@@ -22377,7 +22906,7 @@ async function uploadAll(files, missing) {
     for (; ; ) {
       const job = jobs.shift();
       if (!job) return;
-      const body = readFileSync7(job.f.abs);
+      const body = readFileSync8(job.f.abs);
       const ext2 = job.f.path.split(".").pop() ?? "";
       const path = job.kind === "blob" ? `/api/uploads/blob/${job.f.sha256}` : `/api/uploads/media/${job.f.sha256}?ext=${ext2}`;
       await request(path, {
@@ -22447,14 +22976,14 @@ async function setPublished(slug, published) {
 }
 
 // src/commands/skills.ts
-import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync3, readdirSync as readdirSync4, readFileSync as readFileSync8 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname3, join as join6, resolve as resolve4 } from "path";
+import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync4, readdirSync as readdirSync4, readFileSync as readFileSync9 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname4, join as join7, resolve as resolve5 } from "path";
 import { fileURLToPath } from "url";
 function skillsDir() {
-  const here = dirname3(fileURLToPath(import.meta.url));
-  for (const candidate2 of [join6(here, "..", "skills"), join6(here, "..", "..", "skills")]) {
-    if (existsSync6(join6(candidate2, "arcade-getting-started", "SKILL.md"))) return candidate2;
+  const here = dirname4(fileURLToPath(import.meta.url));
+  for (const candidate2 of [join7(here, "..", "skills"), join7(here, "..", "..", "skills")]) {
+    if (existsSync7(join7(candidate2, "arcade-getting-started", "SKILL.md"))) return candidate2;
   }
   throw new ExitError(
     "The bundled skills are missing from this install. Reinstall evolutionary-arcade."
@@ -22479,7 +23008,7 @@ function guide(name, opts = {}) {
     return;
   }
   const skill = resolveSkill(name ?? "getting-started");
-  const text = readFileSync8(join6(skillsDir(), skill, "SKILL.md"), "utf8");
+  const text = readFileSync9(join7(skillsDir(), skill, "SKILL.md"), "utf8");
   if (opts.raw) {
     process.stdout.write(text);
     return;
@@ -22493,21 +23022,21 @@ function guide(name, opts = {}) {
   process.stdout.write(text.replace(/^---\n[\s\S]*?\n---\n+/, ""));
 }
 var TARGETS = {
-  claude: () => join6(homedir3(), ".claude", "skills"),
-  codex: () => join6(homedir3(), ".agents", "skills")
+  claude: () => join7(homedir4(), ".claude", "skills"),
+  codex: () => join7(homedir4(), ".agents", "skills")
 };
 function installSkills(opts) {
   const src = skillsDir();
   const names = skillNames();
-  const targets = opts.dir ? [resolve4(opts.dir)] : (opts.target === "all" || !opts.target ? Object.keys(TARGETS) : [opts.target]).map((t) => {
+  const targets = opts.dir ? [resolve5(opts.dir)] : (opts.target === "all" || !opts.target ? Object.keys(TARGETS) : [opts.target]).map((t) => {
     const f = TARGETS[t];
     if (!f) throw new ExitError(`Unknown --target ${t}. Use claude, codex, or all.`, 2);
     return f();
   });
   for (const target of targets) {
-    mkdirSync3(target, { recursive: true });
+    mkdirSync4(target, { recursive: true });
     for (const name of names)
-      cpSync(join6(src, name), join6(target, name), { recursive: true, force: true });
+      cpSync(join7(src, name), join7(target, name), { recursive: true, force: true });
     out(`Installed ${names.length} skills into ${target}`);
   }
   out(dim(names.join(", ")));
@@ -22599,11 +23128,20 @@ function buildProgram() {
     "after",
     "\nExamples:\n  arcade publish --dry-run          check it and see the file list\n  arcade publish --yes              publish after you've read the dry run\n  arcade publish --yes --no-stats   when these tokens aren't from this build"
   );
+  program.command("share [slug]").description(
+    "print ready-to-post drafts for a game: link, video-description line, X post, GIF (you post them)"
+  ).option("--profile [handle]", "share your whole library (default: you)").option("--badge", 'print the "Play on Evolutionary Arcade" badge as Markdown and HTML').option("--json", "print JSON (for agents)").action(share).addHelpText(
+    "after",
+    "\nExamples:\n  arcade share night-shift            the Share block publish printed\n  arcade share --profile              your whole library, for video descriptions\n  arcade share night-shift --badge    badge for a README or itch page"
+  );
   const media = program.command("media").description("media helpers (they need ffmpeg)");
   media.command("preview [dir]").description(
     "remake media/preview.mp4 (12 s) and media/preview.gif (6 s) from your demo, after every new demo"
   ).action(mediaPreview);
   media.command("gif [dir]").description("remake only media/preview.gif from your demo").action(mediaGif);
+  media.command("vertical [dir]").description(
+    "make the phone (9:16) set in media/vertical/: landscape games get their media over a blurred fill at 1080x1920; portrait and both games get a preview and GIF from their vertical demo"
+  ).action(mediaVertical);
   program.command("main <slug> <generation>").description("(owner) pick which generation is main for its version").action(setMain);
   program.command("unpublish <slug>").description("(owner) take your game down").action((slug) => setPublished(slug, false));
   program.command("republish <slug>").description("(owner) bring your game back").action((slug) => setPublished(slug, true));