juicyjuicy 0.4.1 → 0.5.0

package/dist/index.js

@@ -19983,6 +19983,15 @@ var relativePath = (what) => external_exports.string().transform(normalizePath).
   `${what} must be a relative path inside the project`
 );
 var tagSchema = external_exports.string().min(2).max(24).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "tags are lowercase words, e.g. puzzle or tower-defense");
+var languageNames = new Intl.DisplayNames(["en"], { type: "language", fallback: "none" });
+function languageName(code) {
+  if (!/^[a-z]{2,3}$/.test(code)) return void 0;
+  return languageNames.of(code);
+}
+var languageSchema = external_exports.string().trim().toLowerCase().refine(
+  (code) => languageName(code) !== void 0,
+  'use a two-letter language code, like "en" or "pl"'
+);
 var SOURCE_URL_PATTERN = /^https:\/\/[a-z0-9.-]+(:\d{1,5})?(\/[\w.~%/@+=:-]*)?$/i;
 var sourceUrlSchema = external_exports.string().max(300).regex(
   SOURCE_URL_PATTERN,
@@ -20002,6 +20011,8 @@ var gameFieldSchemas = {
   engine: external_exports.enum(ENGINES),
   madeWith: external_exports.array(memberText().min(1).max(40)).max(5),
   tags: external_exports.array(tagSchema).max(5),
+  /** The languages a player can play it in, the default first. Each one counts once. */
+  languages: external_exports.array(languageSchema).min(1, "list at least one language").max(5).transform((codes) => [...new Set(codes)]),
   input: external_exports.array(external_exports.enum(INPUTS)),
   orientation: external_exports.enum(ORIENTATIONS),
   aspectRatio: external_exports.string().regex(/^(fill|\d{1,2}:\d{1,2})$/, 'use "W:H" like "16:9", or "fill"'),
@@ -20021,6 +20032,7 @@ var manifestSchema = external_exports.strictObject({
   engine: gameFieldSchemas.engine.default("other"),
   madeWith: gameFieldSchemas.madeWith.default([]),
   tags: gameFieldSchemas.tags.default([]),
+  languages: gameFieldSchemas.languages.default(["en"]),
   input: gameFieldSchemas.input.default([]),
   orientation: gameFieldSchemas.orientation.default("any"),
   aspectRatio: gameFieldSchemas.aspectRatio.default("16:9"),
@@ -20084,6 +20096,7 @@ var updateGameRequestSchema = external_exports.object({
   engine: gameFieldSchemas.engine.optional(),
   madeWith: gameFieldSchemas.madeWith.optional(),
   tags: gameFieldSchemas.tags.optional(),
+  languages: gameFieldSchemas.languages.optional(),
   input: gameFieldSchemas.input.optional(),
   orientation: gameFieldSchemas.orientation.optional(),
   aspectRatio: gameFieldSchemas.aspectRatio.optional(),
@@ -20785,8 +20798,16 @@ var REMIX_LICENSE_NAME = "JuicyJuicy remix license";
 var REMIX_LICENSE = "Members may download this game's files and publish a changed version of it on JuicyJuicy, credited to the original. It doesn't allow publishing the game or a remix of it anywhere else, or passing the files on. Turning Remixable off stops new remix downloads; remixes already published stay up.";
 
 // ../shared/src/listing.ts
-var GAME_SORTS = ["newest", "upvoted", "downvoted", "played"];
+var GAME_SORTS = [
+  "newest",
+  "oldest",
+  "trending",
+  "upvoted",
+  "downvoted",
+  "played"
+];
 var GAME_PERIODS = ["24h", "week", "month", "all"];
+var GAME_LISTS = ["featured", "favorites", "unplayed"];
 var DEFAULT_GAME_LIST_QUERY = {
   sort: "newest",
   period: "all",
@@ -20801,8 +20822,10 @@ var paramSchemas = {
   period: external_exports.preprocess(lowercase2, external_exports.enum(GAME_PERIODS)),
   engine: external_exports.preprocess(lowercase2, external_exports.enum(ENGINES)),
   tag: external_exports.preprocess(lowercase2, gameFieldSchemas.tags.element),
+  lang: languageSchema,
   q: external_exports.string().max(MAX_GAME_SEARCH_LENGTH),
   remixes: external_exports.enum(["0", "1"]),
+  list: external_exports.preprocess(lowercase2, external_exports.enum(GAME_LISTS)),
   page: external_exports.string().regex(/^\d{1,4}$/, "use a whole number").transform(Number).pipe(external_exports.number().min(1).max(MAX_GAME_LIST_PAGE))
 };
 function remixFilter(param) {
@@ -20814,8 +20837,10 @@ var gameListRequestSchema = external_exports.object({
   period: paramSchemas.period.default(DEFAULT_GAME_LIST_QUERY.period),
   engine: paramSchemas.engine.optional(),
   tag: paramSchemas.tag.optional(),
+  lang: paramSchemas.lang.optional(),
   q: paramSchemas.q.optional(),
   remixes: paramSchemas.remixes.optional(),
+  list: paramSchemas.list.optional(),
   page: paramSchemas.page.default(DEFAULT_GAME_LIST_QUERY.page)
 }).transform(({ remixes, ...rest }) => ({ ...rest, remixes: remixFilter(remixes) }));
 
@@ -24346,7 +24371,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "juicyjuicy",
-  version: "0.4.1",
+  version: "0.5.0",
   description: "Publish AI-made browser games to juicyjuicy.games",
   type: "module",
   license: "MIT",
@@ -25910,14 +25935,18 @@ async function deviceLogin(out, server, options) {
     userCode: start.userCode,
     verificationUrl: loginUrl,
     expiresIn: start.expiresIn,
-    message: `Open ${loginUrl} and approve code ${start.userCode}.`
+    // An agent running this for someone passes the code on, so they can check it on the page (D46).
+    message: `Show the user the code ${start.userCode} now: they check it on ${loginUrl} and approve. The login waits up to ${Math.round(start.expiresIn / 60)} minutes.`
   });
   out.info(`Your code: ${start.userCode}`);
   const opened = options.browser && await openBrowser(loginUrl);
   out.info(
-    opened ? `Approve it in the browser window that just opened.
-If nothing opened, go to ${loginUrl}` : `Open ${loginUrl} and approve it.`
+    opened ? `Check it in the browser window that just opened, then approve.
+If nothing opened, go to ${loginUrl}` : `Open ${loginUrl}, check the code and approve.`
   );
+  if (!out.interactive && !out.json) {
+    out.info(`AI agents: show the user the code ${start.userCode} and the link now.`);
+  }
   const progress = out.interactive ? spinner() : null;
   progress?.start("Waiting for approval");
   let result;
@@ -26327,6 +26356,7 @@ var KEY_ORDER = [
   "engine",
   "madeWith",
   "tags",
+  "languages",
   "input",
   "orientation",
   "aspectRatio",
@@ -26349,6 +26379,7 @@ async function buildManifest(dir, flags, ask) {
     orientation: pick2("orientation", "any"),
     aspectRatio: pick2("aspectRatio", "16:9"),
     tags: pick2("tags", []),
+    languages: pick2("languages", ["en"]),
     input: pick2("input", []),
     remixable: pick2("remixable", false)
   };
@@ -27736,7 +27767,11 @@ function createProgram() {
     "--made-with <list>",
     'models and tools, e.g. "Claude Opus 5.5, Claude Code"',
     splitList
-  ).option("--tags <list>", "up to 5 tags, e.g. arcade,space", splitList).addOption(new Option("--input <list>", `controls: ${INPUTS.join(", ")}`).argParser(splitList)).addOption(new Option("--orientation <orientation>").choices(ORIENTATIONS)).option("--aspect-ratio <ratio>", 'like 16:9, or "fill"').option("--thumbnail <file>", "png/jpg/webp in the game folder").option("--remixable", `let other members remix it on JuicyJuicy only (${REMIX_LICENSE_NAME})`).option("--source-url <url>", "public source code, e.g. a GitHub repo").addHelpText(
+  ).option("--tags <list>", "up to 5 tags, e.g. arcade,space", splitList).option(
+    "--languages <list>",
+    "language codes players can pick, the default first, e.g. en,pl",
+    splitList
+  ).addOption(new Option("--input <list>", `controls: ${INPUTS.join(", ")}`).argParser(splitList)).addOption(new Option("--orientation <orientation>").choices(ORIENTATIONS)).option("--aspect-ratio <ratio>", 'like 16:9, or "fill"').option("--thumbnail <file>", "png/jpg/webp in the game folder").option("--remixable", `let other members remix it on JuicyJuicy only (${REMIX_LICENSE_NAME})`).option("--source-url <url>", "public source code, e.g. a GitHub repo").addHelpText(
     "after",
     `
 ${REMIX_LICENSE_NAME} (--remixable): ${REMIX_LICENSE}`

package/dist/skill/SKILL.md

@@ -19,8 +19,9 @@ npx -y juicyjuicy@0 whoami --json
 
 If it exits with `2`, log in. `login` opens the user's browser and **waits up to 10 minutes** for them to approve:
 
-- Tell the user first: *"A JuicyJuicy page will open in your browser. Check the code and click **Approve**."*
-- Run `npx -y juicyjuicy@0 login --json`. If your shell can run commands in the background, do that and read the first output line (`{"event": "device_code", "userCode", "verificationUrl"}`) so you can show the user the code and link. Otherwise run it in the foreground with a timeout of at least 10 minutes.
+- Run `npx -y juicyjuicy@0 login --json` in the background if your shell can, and read its first output line (`{"event": "device_code", "userCode", "verificationUrl"}`) right away, and show the user the code and link without waiting for them to ask: the page shows the same code, and that's how they know the login is theirs.
+- Then tell the user, with the real code and link: *"A JuicyJuicy page opened in your browser. Check it shows the code **WXTZ-BCDF** and click **Approve**. If no page opened, go to <verificationUrl>."*
+- If your shell can't run commands in the background, say that first (without a code: it doesn't exist yet), then run it in the foreground with a timeout of at least 10 minutes. The code is also printed as `Your code: …`.
 - The user needs a JuicyJuicy account (it's invite-only for now). If the page says they can't sign in, they need an invite link from a friend who's a member.
 
 In CI there's no browser: the `JUICY_TOKEN` environment variable holds a token instead.
@@ -52,15 +53,22 @@ npx -y juicyjuicy@0 init --yes --json \
 - `init` keeps what an existing `juicy.json` already says (flags override), and detects `buildDir`, `entry` and `engine`. Check what it wrote.
 - `--made-with`: your real model and the tool you run in, e.g. `"Claude Opus 5.5, Claude Code"` or `"Gemini 3 Pro, Antigravity"`.
 - The slug (the `/g/<slug>` URL name) defaults to one made from the title. Once published it belongs to this user; reuse it to publish updates.
+- `--languages`: the languages a player can switch between, English first, e.g. `en,pl`. Leave it out for a game that's only in English (the default is `en`).
 - Offer to write `HOW_I_MADE_IT.md` (a short story of how the game was made, up to 20 KB of markdown). `init` picks it up when it exists.
 
 All fields: [reference/manifest.md](reference/manifest.md).
 
+**English first.** Every game on JuicyJuicy plays in English by default, so players anywhere can pick it up:
+
+- If the game's text (menus, buttons, instructions, dialogue, text drawn in images) is in another language, build an English version before publishing: keep the player-facing text in one table per language, start in English, and add a visible switch (like `EN | PL`) to the language the game was made in. Tell the user in a sentence that you did. Pass both with `--languages en,pl`.
+- `title` and `description` are always in English. A title that is a name (`Kasztanek`) stays as it is; one made of words in another language gets translated (`Wielka Ucieczka` → `The Great Escape`). Tell the user the English title you chose.
+- Text in the thumbnail (step 4) is in English too.
+
 ### 4. Add a thumbnail
 
 A `thumbnail.png` (or `.jpg`/`.webp`, up to 2 MB and 4096×4096 pixels, ideally the game's shape, like 1280×720 for 16:9) in the project folder becomes the game's tile.
 
-- **If you can run the game in a browser and take a screenshot**, make a deliberate one: get past any title or "click to start" screen to real gameplay, then save it as `thumbnail.png` and pass `--thumbnail thumbnail.png` to `init`.
+- **If you can run the game in a browser and take a screenshot**, make a deliberate one, with the game in English: get past any title or "click to start" screen to real gameplay, then save it as `thumbnail.png` and pass `--thumbnail thumbnail.png` to `init`.
 - **Otherwise the CLI takes one itself.** When `juicy.json` names no thumbnail, `check` and `publish` open the built game in Chrome, Edge, Chromium or Brave on this machine (headless, at the game's `aspectRatio`, sandboxed and offline: only the game's own files load) and use a screenshot taken a few seconds after it loads. A game that loads its engine, fonts or images from another site is captured without them. Don't block publishing on a thumbnail.
 - **Not for a remix**, unless the user agrees: the screenshot runs the other creator's code. Ask first; only if they say yes, pass `--auto-thumbnail` to `check` and `publish`. Without it you get a warning starting `no thumbnail: this is a remix`.
 
@@ -107,6 +115,8 @@ Keep it short when there's nothing to say: "Checked: no problems found" is enoug
 npx -y juicyjuicy@0 publish --json --message "<what changed, in a few words>"
 ```
 
+This makes the new version live: when the user says "publish", that's what they want. Don't add `--draft` (see "Other commands") unless they asked in words for it not to go live yet. Not for a first publish, a big game or one you're unsure of either: the user would have to find the dashboard and make it live themselves.
+
 `publish` runs `check` again, uploads and finalizes. Publishing the same slug again creates a new version: the link stays the same and players keep their saves. Then it waits up to about 45 seconds for JuicyJuicy's automatic safety check of the new version (`{"event": "reviewing"}`); the result's `review` says how that went.
 
 ### 7. Tell the user
@@ -156,6 +166,6 @@ Everything else is in [reference/troubleshooting.md](reference/troubleshooting.m
 ## Other commands
 
 - `npx -y juicyjuicy@0 list --json`: the user's games; `list <slug>` shows one game's versions. `--all` lists every game on JuicyJuicy instead (60 a page, `--page 2` and on; `nextPage` in the result), `--owner <username>` another creator's. Narrow and order any list with `--search <title text>`, `--tag`, `--engine`, `--remixes`, `--sort newest|upvoted|downvoted|played` and `--period 24h|week|month|all`, e.g. to find a game to remix.
-- `npx -y juicyjuicy@0 publish --draft --json`: uploads a new version without making it live (players keep the current one), when the user wants to publish later. The result has `draft: true`; when they say so, make it live with `rollback <version>`, or they can on the dashboard.
+- `npx -y juicyjuicy@0 publish --draft --json`: uploads a new version without making it live (players keep the current one). Only when the user asks for that in words (e.g. "upload it but don't put it live yet"), never on your own judgment. The result has `draft: true`; when they say so, make it live with `rollback <version>`, or they can on the dashboard.
 - `npx -y juicyjuicy@0 rollback <version> --slug <slug> --json`: makes an earlier version or a draft live, e.g. when the user says the last update broke the game. Run `list <slug>` first to pick the version with the user; one waiting for an admin's review can't be made live (`FORBIDDEN`).
 - `npx -y juicyjuicy@0 open <slug>`: opens the game page in the browser.

package/dist/skill/reference/manifest.md

@@ -13,6 +13,7 @@ The manifest in the project folder. `juicyjuicy init` writes it; edit it by hand
   "engine": "phaser",
   "madeWith": ["Claude Opus 5.5", "Claude Code"],
   "tags": ["arcade", "space"],
+  "languages": ["en", "pl"],
   "input": ["keyboard", "touch"],
   "orientation": "landscape",
   "aspectRatio": "16:9",
@@ -33,6 +34,7 @@ The manifest in the project folder. `juicyjuicy init` writes it; edit it by hand
 | `engine` | | `vanilla`, `phaser`, `threejs`, `pixi`, `godot`, `unity` or `other`. | `--engine` |
 | `madeWith` | | Up to 5 models/tools, e.g. `["Claude Opus 5.5", "Claude Code"]`. | `--made-with "a, b"` |
 | `tags` | | Up to 5 lowercase words or `word-word`, e.g. `puzzle`, `tower-defense`. | `--tags a,b` |
+| `languages` | | Up to 5 language codes a player can switch between, English first, e.g. `["en", "pl"]`. Default `["en"]`. Shown as a language filter on JuicyJuicy. | `--languages a,b` |
 | `input` | | Any of `keyboard`, `mouse`, `touch`, `gamepad`. | `--input a,b` |
 | `orientation` | | `landscape`, `portrait` or `any` (default). | `--orientation` |
 | `aspectRatio` | | `"W:H"` like `"16:9"` or `"4:3"`, or `"fill"` to fill the player. Default `16:9`. | `--aspect-ratio` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juicyjuicy",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Publish AI-made browser games to juicyjuicy.games",
   "type": "module",
   "license": "MIT",