juicyjuicy 0.4.2 → 0.5.1

package/dist/index.js

@@ -19821,7 +19821,6 @@ var LIMITS = {
    * whatever draws one (the link-preview card, players' browsers) decodes every pixel.
    */
   maxThumbnailSide: 4096,
-  maxHowItWasMadeBytes: 20 * 1024,
   maxApiTokensPerUser: 20,
   maxTokenNameLength: 60,
   /** Characters in a comment (plain text, ARCHITECTURE §14). */
@@ -19983,6 +19982,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 +20010,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 +20031,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"),
@@ -20028,7 +20039,8 @@ var manifestSchema = external_exports.strictObject({
     (path2) => THUMBNAIL_EXTENSIONS.some((ext) => path2.toLowerCase().endsWith(`.${ext}`)),
     `thumbnail must be one of: ${THUMBNAIL_EXTENSIONS.join(", ")}`
   ).optional(),
-  howItWasMade: relativePath("howItWasMade").refine((path2) => path2.toLowerCase().endsWith(".md"), "howItWasMade must be a .md file").optional(),
+  /** No longer used (D50); still accepted so older juicy.json files keep publishing. */
+  howItWasMade: external_exports.string().optional().meta({ deprecated: true }),
   remixable: gameFieldSchemas.remixable.default(false),
   sourceUrl: gameFieldSchemas.sourceUrl.optional(),
   remixedFrom: slugSchema.nullable().optional()
@@ -20064,8 +20076,6 @@ var startVersionRequestSchema = external_exports.object({
    * when the game's current thumbnail was set on the dashboard. Older CLIs leave it out.
    */
   thumbnailAuto: external_exports.boolean().optional(),
-  /** Contents of the manifest's `howItWasMade` markdown file. */
-  howItWasMade: memberText().optional(),
   /** A note for the version history, e.g. what changed or a commit SHA. */
   message: memberText().max(200).optional(),
   source: external_exports.enum(PUBLISH_SOURCES).default("cli"),
@@ -20084,13 +20094,12 @@ 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(),
   remixable: gameFieldSchemas.remixable.optional(),
-  sourceUrl: gameFieldSchemas.sourceUrl.nullable().optional(),
-  /** Markdown, ≤ 20 KB. */
-  howItWasMade: memberText().nullable().optional()
+  sourceUrl: gameFieldSchemas.sourceUrl.nullable().optional()
 });
 var rollbackRequestSchema = external_exports.object({ version: external_exports.number().int().positive() });
 var voteRequestSchema = external_exports.object({
@@ -20785,8 +20794,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 +20818,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 +20833,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 +24367,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "juicyjuicy",
-  version: "0.4.2",
+  version: "0.5.1",
   description: "Publish AI-made browser games to juicyjuicy.games",
   type: "module",
   license: "MIT",
@@ -26085,6 +26106,7 @@ async function walkFiles(root) {
   await visit2(root);
   return result;
 }
+var HOW_IT_WAS_MADE_WARNING = '"howItWasMade" is no longer used and its file is not sent; remove it from juicy.json (juicyjuicy init does)';
 var NO_THUMBNAIL_WARNING = `no thumbnail: the game's tile shows a plain gradient. Add a screenshot as thumbnail.png and set "thumbnail" in juicy.json`;
 function isInside(root, path2) {
   const rel = relative(root, path2);
@@ -26105,7 +26127,6 @@ async function checkProject(dir, options = {}) {
     files: [],
     totalBytes: 0,
     thumbnail: null,
-    howItWasMade: null,
     issues: [],
     warnings: [],
     findings: [],
@@ -26140,9 +26161,8 @@ async function checkProject(dir, options = {}) {
     }
     check3.files = plan.files;
     check3.totalBytes = plan.files.reduce((sum, file2) => sum + file2.size, 0);
-    const story = manifest.howItWasMade ? relative(buildDir, resolve(realDir, manifest.howItWasMade)).split(sep).join("/") : null;
     for (const { path: path2 } of plan.files) {
-      const reason = path2 === story ? null : unusualFileReason(path2);
+      const reason = unusualFileReason(path2);
       if (reason) check3.unusualFiles.push({ path: path2, reason });
     }
     if (check3.unusualFiles.length > 0) {
@@ -26188,23 +26208,8 @@ async function checkProject(dir, options = {}) {
   } else {
     check3.warnings.push(NO_THUMBNAIL_WARNING);
   }
-  if (manifest.howItWasMade) {
-    const file2 = await projectFile(realDir, manifest.howItWasMade);
-    if (!file2) {
-      check3.issues.push({
-        code: "VALIDATION_FAILED",
-        message: "file not found in the project folder",
-        path: manifest.howItWasMade
-      });
-    } else if (file2.size > LIMITS.maxHowItWasMadeBytes) {
-      check3.issues.push({
-        code: "TOO_LARGE",
-        message: `${(file2.size / 1024).toFixed(1)} KB; at most ${LIMITS.maxHowItWasMadeBytes / 1024} KB`,
-        path: manifest.howItWasMade
-      });
-    } else {
-      check3.howItWasMade = { ...file2, text: await readFile2(file2.absolute, "utf8") };
-    }
+  if (manifest.howItWasMade !== void 0) {
+    check3.warnings.push(HOW_IT_WAS_MADE_WARNING);
   }
   const viteWarning = await viteBaseWarning(dir);
   if (viteWarning) check3.warnings.push(viteWarning);
@@ -26298,7 +26303,6 @@ async function detectProject(dir) {
     entry,
     engine: await detectEngine(dir, buildDir, deps, Boolean(pkg)),
     thumbnail: await firstExisting(dir, ["thumbnail.png", "thumbnail.jpg", "thumbnail.webp"]),
-    howItWasMade: await firstExisting(dir, ["HOW_I_MADE_IT.md"]),
     warnings
   };
 }
@@ -26331,11 +26335,11 @@ var KEY_ORDER = [
   "engine",
   "madeWith",
   "tags",
+  "languages",
   "input",
   "orientation",
   "aspectRatio",
   "thumbnail",
-  "howItWasMade",
   "remixable",
   "sourceUrl",
   "remixedFrom"
@@ -26353,12 +26357,13 @@ 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)
   };
   const thumbnail = pick2("thumbnail", detected.thumbnail);
   if (thumbnail) values.thumbnail = thumbnail;
-  if (!values.howItWasMade && detected.howItWasMade) values.howItWasMade = detected.howItWasMade;
+  delete values.howItWasMade;
   if (flags.sourceUrl) values.sourceUrl = flags.sourceUrl;
   const fieldSchema = manifestSchema.shape;
   const check3 = (field) => (value) => fieldSchema[field].safeParse(value).error?.issues[0]?.message;
@@ -26877,7 +26882,6 @@ async function check2(out, dir, options) {
       unusualFiles: result.unusualFiles,
       thumbnail: result.thumbnail?.path ?? null,
       thumbnailAuto: Boolean(result.thumbnail?.auto),
-      howItWasMade: result.howItWasMade?.path ?? null,
       warnings: result.warnings,
       findings: result.findings,
       scriptHosts: result.scriptHosts
@@ -27046,7 +27050,7 @@ async function publish(out, dir, options) {
   const server = apiUrl();
   const auth = await ensureLogin(out, server);
   const api = new ApiClient(server, auth.token);
-  const { thumbnail, howItWasMade } = checked;
+  const { thumbnail } = checked;
   const request = {
     manifest: checked.rawManifest,
     files: await hashFiles(checked.buildDir, checked.files),
@@ -27057,7 +27061,6 @@ async function publish(out, dir, options) {
     } : void 0,
     // A screenshot doesn't replace a thumbnail uploaded on the dashboard (D34).
     ...thumbnail?.auto ? { thumbnailAuto: true } : {},
-    howItWasMade: howItWasMade?.text,
     message: options.message,
     source: options.source ?? (process.env.GITHUB_ACTIONS === "true" ? "github" : "cli"),
     ...options.draft ? { draft: true } : {}
@@ -27740,7 +27743,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

@@ -53,15 +53,21 @@ 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.
-- 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.
+- `--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`).
 
 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`.
 

package/dist/skill/reference/manifest.md

@@ -13,11 +13,11 @@ 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",
   "thumbnail": "thumbnail.png",
-  "howItWasMade": "HOW_I_MADE_IT.md",
   "remixable": true,
   "sourceUrl": "https://github.com/someone/space-goose"
 }
@@ -33,11 +33,12 @@ 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` |
 | `thumbnail` | | png/jpg/webp in the project folder (not the build folder), up to 2 MB and 4096×4096 pixels. Without one, `check` and `publish` screenshot the game in a local Chrome or Edge, offline (`--no-auto-thumbnail` turns that off; a remix only with `--auto-thumbnail`). | `--thumbnail` |
-| `howItWasMade` | | A `.md` file in the project folder, up to 20 KB, shown on the game page. | (detected: `HOW_I_MADE_IT.md`) |
+| `howItWasMade` | | No longer used; `check` warns about it and `init` removes it. | |
 | `remixable` | | `true` grants the JuicyJuicy remix license: other members may remix the game on JuicyJuicy only (see SKILL.md, "Remix a game"). Default `false`. | `--remixable` |
 | `sourceUrl` | | Plain `https://` link to the source, e.g. a GitHub repo (no `?`, `#`, spaces or quotes; at most 300 characters). | `--source-url` |
 | `remixedFrom` | | Set by `juicyjuicy remix`; don't edit. | |

package/dist/skill/reference/troubleshooting.md

@@ -17,7 +17,7 @@ With `--json`, a failed command's last line is `{"ok": false, "error": {"code",
 | `INVALID_MANIFEST` | `juicy.json` is missing, isn't JSON, or a field breaks a rule (`details` says which). | No file: run `init`. Otherwise fix the listed fields (see manifest.md). |
 | `ENTRY_MISSING` | The build folder doesn't exist, or has no entry file. | Run the build. Check `buildDir` and `entry`. |
 | `INVALID_PATH` | A file name is unsafe (backslash, control character, too long, …). | Rename the file (POSIX names, under 256 characters). |
-| `TOO_LARGE` | A file is over 100 MB, the whole build over 150 MB, the thumbnail over 2 MB or 4096 pixels wide or high, or `HOW_I_MADE_IT.md` over 20 KB. Or the user's games together take up more than their 2 GB of storage (the message says "your games already take up"). | Compress or remove assets; resize the thumbnail. For storage: the user deletes a game they don't need on the site; only the newest 5 versions of each game are kept, and old ones are cleaned up daily. |
+| `TOO_LARGE` | A file is over 100 MB, the whole build over 150 MB, or the thumbnail over 2 MB or 4096 pixels wide or high. Or the user's games together take up more than their 2 GB of storage (the message says "your games already take up"). | Compress or remove assets; resize the thumbnail. For storage: the user deletes a game they don't need on the site; only the newest 5 versions of each game are kept, and old ones are cleaned up daily. |
 | `TOO_MANY_FILES` | More than 3,000 files. | Bundle or pack assets (sprite sheets, atlases). |
 | `VALIDATION_FAILED` | Something else is malformed, e.g. a thumbnail that isn't png/jpg/webp or a file that's missing. | Follow the message. |
 | `SLUG_TAKEN` | Another creator owns this slug. | Choose a new slug: `init --slug <new-slug>`. |

package/package.json

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