@pixelvibing/cli 0.60.0 → 0.62.0

package/dist/pixel-vibing-cli.js

@@ -1001,7 +1001,7 @@ class DesktopSession {
     const challenge = createHash("sha256").update(verifier).digest("base64url");
     const back = await this.awaitCallback(
       (port) => this.options.openExternal(
-        `${this.options.apiUrl}/auth/${encodeURIComponent(provider)}/start?desktop=${port}&challenge=${challenge}${this.options.app === "cli" ? "&app=cli" : ""}`
+        `${this.options.apiUrl}/auth/${encodeURIComponent(provider)}/start?desktop=${port}&challenge=${challenge}${this.options.app === void 0 || this.options.app === "desktop" ? "" : `&app=${this.options.app}`}`
       )
     );
     const outcome = back.code === null ? back.outcome : await this.exchange(back.code, verifier).catch(() => "failed");
@@ -2764,6 +2764,16 @@ async function writeArtMirror(boundary, art, mirror) {
   for (const manifest2 of before.manifests) if (!index.manifests.includes(manifest2)) await gone(join(MANIFEST_DIRECTORY, `${manifest2}.json`));
   return index;
 }
+function folderMirror(art) {
+  const boundary = new Boundary([art]);
+  return {
+    state: () => mirrorState(boundary, art),
+    map: (each) => writeMapMirror(boundary, art, each),
+    art: (each) => writeArtMirror(boundary, art, each),
+    folder: () => readFolder(boundary, art),
+    moving: (project) => markMoving(boundary, art, project)
+  };
+}
 const SECTOR_SIDE = 128;
 const MOST_READ = 32;
 const MOST_WAIT_SECONDS$1 = 60;
@@ -2880,15 +2890,7 @@ async function syncArt(deps) {
   await deps.mirror.art({ revision: art.revision, assets: art.assets, pictures, idMap: art.idMap, references: referenced, styleGuide });
 }
 function mirrorOf(local) {
-  const art = artOf(local);
-  const boundary = new Boundary([art]);
-  return {
-    state: () => mirrorState(boundary, art),
-    map: (each) => writeMapMirror(boundary, art, each),
-    art: (each) => writeArtMirror(boundary, art, each),
-    folder: () => readFolder(boundary, art),
-    moving: (project) => markMoving(boundary, art, project)
-  };
+  return folderMirror(artOf(local));
 }
 const deflated = promisify(deflate);
 const inflated = promisify(inflate);
@@ -4272,7 +4274,16 @@ function phaserFiles(made) {
       format: "RGBA8888",
       size: { w: page.width, h: page.height },
       scale: 1,
-      frames: packed.placements.filter((placed) => placed.page === index).map((placed) => ({ filename: placed.name, ...textureFrame(placed) }))
+      // A frame that stretches carries its centre as `scale9Borders`, which Phaser 4's atlas parser gives the frame, so
+      // `this.add.nineslice(x, y, key, frame, width, height)` stretches it without being told the insets.
+      frames: packed.placements.filter((placed) => placed.page === index).map((placed) => {
+        const grid = made.nineGrids.get(placed.name);
+        return {
+          filename: placed.name,
+          ...textureFrame(placed),
+          ...grid === void 0 ? {} : { scale9Borders: { x: grid.left, y: grid.top, w: placed.width - grid.left - grid.right, h: placed.height - grid.top - grid.bottom } }
+        };
+      })
     })),
     meta: { app: "https://pixelvibing.com", version: String(EXPORT_FORMAT) }
   };
@@ -4619,8 +4630,50 @@ function encodeWith(zlib, raster) {
 function pngCodec(zlib) {
   return { decodePng: (bytes) => decodeWith(zlib, bytes), encodePng: (raster) => encodeWith(zlib, raster) };
 }
-const EXPORT_MARK = ".pixelvibing-export";
 const codec$1 = pngCodec({ inflate: (data, maxOutputLength) => inflateSync(data, { maxOutputLength }), deflate: (data) => deflateSync(data) });
+class ExportRefused extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ExportRefused";
+  }
+}
+const REFUSALS = [ProjectError, PackError, PngError, MapTextError, MirrorError, IdMapError, SyntaxError, ExportRefused];
+async function exportFolder(art, engine, options = {}) {
+  try {
+    const boundary = new Boundary([art]);
+    const read = await readProjectArt(boundary, art);
+    const mirrored2 = await readMirroredProjectMap(boundary, art);
+    const mapText = mirrored2 === null ? await readProjectMap(boundary, art) : null;
+    checkExportable(
+      read.pictures.map((picture) => {
+        if (!isPng(picture.bytes)) throw new ExportRefused(`the picture ${picture.name} cannot be read: it is not a PNG`);
+        return { name: picture.name, ...pngSize(picture.bytes) };
+      })
+    );
+    const pictures = read.pictures.map((picture) => {
+      try {
+        return { name: picture.name, raster: codec$1.decodePng(picture.bytes) };
+      } catch (error) {
+        throw new ExportRefused(`the picture ${picture.name} cannot be read: ${error.message}`);
+      }
+    });
+    return exportProject(
+      {
+        pictures,
+        entries: read.entries,
+        map: mirrored2 ?? (mapText === null ? null : parseMapText(mapText, "pixelvibing/map.json").document),
+        idMap: read.idMap === null ? null : parseIdMap(JSON.parse(read.idMap))
+      },
+      engine,
+      codec$1,
+      options
+    );
+  } catch (error) {
+    if (REFUSALS.some((kind) => error instanceof kind)) throw error instanceof ExportRefused ? error : new ExportRefused(error.message);
+    throw error;
+  }
+}
+const EXPORT_MARK = ".pixelvibing-export";
 async function isDirectory(path) {
   try {
     return (await lstat(path)).isDirectory();
@@ -4699,37 +4752,9 @@ const exportCommand = {
     if (!await replaceable(out)) throw new CliError(`${out} holds files that are not an export's: nothing was written. Name an empty directory with --out`);
     let result;
     try {
-      const boundary = new Boundary([art]);
-      const read = await readProjectArt(boundary, art);
-      const mirrored2 = await readMirroredProjectMap(boundary, art);
-      const mapText = mirrored2 === null ? await readProjectMap(boundary, art) : null;
-      checkExportable(
-        read.pictures.map((picture) => {
-          if (!isPng(picture.bytes)) throw new CliError(`the picture ${picture.name} cannot be read: it is not a PNG`);
-          return { name: picture.name, ...pngSize(picture.bytes) };
-        })
-      );
-      const pictures = read.pictures.map((picture) => {
-        try {
-          return { name: picture.name, raster: codec$1.decodePng(picture.bytes) };
-        } catch (error) {
-          throw new CliError(`the picture ${picture.name} cannot be read: ${error.message}`);
-        }
-      });
-      result = exportProject(
-        {
-          pictures,
-          entries: read.entries,
-          map: mirrored2 ?? (mapText === null ? null : parseMapText(mapText, "pixelvibing/map.json").document),
-          idMap: read.idMap === null ? null : parseIdMap(JSON.parse(read.idMap))
-        },
-        engine,
-        codec$1,
-        godotRoot === void 0 ? {} : { godotRoot }
-      );
+      result = await exportFolder(art, engine, godotRoot === void 0 ? {} : { godotRoot });
     } catch (error) {
-      const refusals = [ProjectError, PackError, PngError, MapTextError, MirrorError, IdMapError, SyntaxError, CliError];
-      if (refusals.some((kind) => error instanceof kind)) throw new CliError(`nothing was exported: ${error.message}`);
+      if (error instanceof ExportRefused) throw new CliError(`nothing was exported: ${error.message}`);
       throw error;
     }
     await writeWhole(out, result.files, engine);
@@ -7480,7 +7505,7 @@ function terminalOf(streams) {
     step: (title, at = "step") => drawStep(streams.stderr, title, at)
   };
 }
-const version = "0.60.0";
+const version = "0.62.0";
 const manifest = {
   version
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixelvibing/cli",
-  "version": "0.60.0",
+  "version": "0.62.0",
   "description": "PixelVibing: pixel art game assets from the command line, and the Skills that teach coding assistants to make them.",
   "license": "MIT",
   "homepage": "https://pixelvibing.com",
@@ -26,7 +26,8 @@
     "build": "npm run build --workspace=@pixelvibing/toolkit && node scripts/build.mjs",
     "check": "node ../node_modules/typescript/bin/tsc -p tsconfig.json --noEmit",
     "check:package": "node ../editor/src/main/package-guard.ts dist && node ../editor/src/main/package-guard.ts skills",
-    "test": "node --import ../editor/scripts/test-register.mjs --test \"src/**/*.test.ts\""
+    "test": "node --import ../editor/scripts/test-register.mjs --test \"src/**/*.test.ts\"",
+    "skills": "node --import ../editor/scripts/test-register.mjs scripts/skills.mjs"
   },
   "publishConfig": {
     "access": "public"

package/skills/pixelvibing-concept-art/SKILL.md

@@ -20,6 +20,8 @@ pixel-vibing-cli generate concept-art --instruction "<the picture>" [--size <w>x
 pixel-vibing-cli generate concept-art --instruction "<the area>" --pixel-art --tiles <cols>x<rows> [--no-enrich] --yes --json
 ```
 
+The fields under *Writing it* are these flags: `size` is `--size <w>x<h>`, `background: "transparent"` is `--transparent`, `mask_image` is `--mask <png>`, each tag a `--tag`, each of `reference_images` a `--reference <png>`, `pixel_art` and `tiles` are `--pixel-art --tiles`, and `enrich: false` is `--no-enrich`.
+
 ## With the MCP server
 
 ```json
@@ -37,29 +39,23 @@ which every other generation takes as `reference_images`.
 ## Writing it
 
 - **The instruction.** Brief it as an art director would: what is in the picture, where,
-  how it looks, the light, and how its parts meet. Use the style guide's words.
-- **The size.** `--size` (MCP `size`) in px, `<w>x<h>`, multiples of 16 within `1536x1024`
-  or `1024x1536`, `1536x1024` unless given. `--transparent` (`background: "transparent"`)
-  has it drawn on a transparent background, for one thing alone: say so in the words too, and a
-  shadow under it only if you want one.
+  how it looks, the light, and how its parts meet. Use the style guide's words. It is
+  ordinary art, not pixel art, made to draw other generations from: for a new project, make
+  one tagged `anchor` first.
+- **The size.** `size` in px, `{ width, height }`, multiples of 16 within 1536×1024 or
+  1024×1536, 1536×1024 unless given. `background: "transparent"` draws it on a transparent
+  background, for one thing alone: say so in the words too.
 - **Tags** say what it is for, at most 8: `anchor` (the look everything holds to),
-  `level-design`, `ui`, `character`, `environment`, `prop`, or one of the project's own
-  (`list_tags`). `pixel-vibing-cli tag` (MCP `tag_asset`) changes them later.
-- **References.** Up to 8 to draw from, such as the anchor itself.
-- **A mask.** Keeps the drawing to a shape you choose: an island's coastline, a
-  character's silhouette, a frame for a menu, the open middle of a scene. It is an opaque
-  PNG of black and white only, white where the art is drawn and black where the drawing is
-  left empty, in the drawing's shape: the `--size` (`1536x1024` unless given), or for pixel
-  art the `--tiles` in proportion, such as 3:2 for `6x4`. Any size in that shape is scaled
-  to fit, up to 1536 px a side, so a small one drawn by hand or by a script is enough. A soft edge is fine; grey
-  shading, colour or transparency is refused with the reason before anything is spent.
-  Pass it as `--mask <png>` (MCP: keep it with `upload_image`, then give its id as
-  `mask_image`). With `--transparent`, the black part comes back transparent as well.
-- **A level design.** `--pixel-art --tiles <c>x<r>` (MCP `pixel_art`, `tiles`) draws an area
-  of the map as pixel art some tiles across, `6x4` unless given, tagged `level-design`; the
-  editor takes it apart into objects and terrain.
-- **Enrichment.** Pass `--no-enrich` (`enrich: false`) when the brief above is complete;
-  leave it on when all you have is the person's few words.
+  `level-design`, `ui`, `character`, `environment`, `prop`, or one of the project's own.
+- **References.** Up to 8 to draw from (`reference_images`), such as the anchor itself.
+- **A mask** (`mask_image`) keeps the drawing to a shape: an island's coastline, a
+  character's silhouette, a frame for a menu. It is an opaque picture of black and white
+  only, white where the art is drawn and black where it is left empty, in the drawing's
+  shape, at most 1536 px a side.
+- **A level design.** `pixel_art: true` with `tiles` draws an area of the map as pixel art
+  some tiles across, 6×4 unless given, tagged `level-design`, to be taken apart into objects
+  and terrain.
+- **Enrichment.** Turn it off (`enrich: false`) when the instruction above is complete; leave it on when all you have is the person's few words.
 
 ## After
 

package/skills/pixelvibing-creature/SKILL.md

@@ -15,6 +15,8 @@ Load the `pixelvibing` Skill first: who is signed in, the style guide, the limit
 pixel-vibing-cli generate creature --instruction "<who>" [--reference <png>]... [--no-enrich] --yes --json
 ```
 
+The fields under *Writing it* are these flags: each of `reference_images` a `--reference <png>`, such as a concept art pulled under `pixelvibing/ref/`, and `enrich: false` is `--no-enrich`.
+
 ## With the MCP server
 
 ```json
@@ -32,11 +34,12 @@ pixel-vibing-cli generate creature --instruction "<who>" [--reference <png>]...
   characters or names, and no text in the picture: when the person names a franchise, make
   original art in its spirit and say so.
 - **One creature, standing.** It is drawn whole, standing, on one tile. A pose, a crowd or a
-  scene is concept art (`pixelvibing-concept-art`).
-- **References.** Up to 3: a character sheet or a concept art tagged `character` or
-  `anchor` keeps it on model.
-- **Enrichment.** Pass `--no-enrich` (`enrich: false`) when the instruction above is
-  complete; leave it on when all you have is the person's few words.
+  scene is concept art.
+- **References.** Up to 3 (`reference_images`): a character sheet or a concept art tagged
+  `character` or `anchor` keeps it on model.
+- **Its motion.** Its eight directions and its states — walking, hurt, dead — are changes of
+  it, made once it exists.
+- **Enrichment.** Turn it off (`enrich: false`) when the instruction above is complete; leave it on when all you have is the person's few words.
 
 ## After
 

package/skills/pixelvibing-icons/SKILL.md

@@ -15,6 +15,8 @@ Load the `pixelvibing` Skill first: who is signed in, the style guide, the limit
 pixel-vibing-cli generate icons --names "<name>,<name>,..." --purpose <skill|item> [--size <16|32|64>] [--instruction "<theme>"] [--no-enrich] --yes --json
 ```
 
+The fields under *Writing it* are these flags: `names` is `--names`, comma-separated, `icon_size` is `--size`, and `enrich: false` is `--no-enrich`.
+
 ## With the MCP server
 
 ```json
@@ -28,17 +30,16 @@ them so.
 
 ## Writing it
 
-- **The names.** One per icon, at most 16, none twice: what the skill or the item is, in a
-  few words ("red health potion", "rusty key"). Make a whole set in one generation, so the
-  icons match.
+- **The names.** One per icon (`names`), at most 16, none twice: what the skill or the item
+  is, in a few words ("red health potion", "rusty key"). Make a whole set in one generation,
+  so the icons match.
 - **The purpose.** `skill` draws each on a square badge, for a hotbar or a skill tree;
   `item` draws each alone, for an inventory or loot; `item` unless given.
-- **The size.** 16, 32 or 64 px a side, 32 unless given: the size the game shows them at.
-- **The theme.** `--instruction` is optional: what the icons have in common, their colours
-  and framing. Use the style guide's words.
-- **No references.** An icon never carries text or numbers: draw counts and labels in the game.
-- **Enrichment.** Pass `--no-enrich` (`enrich: false`) when the theme is complete; leave it
-  on when all you have is the person's few words.
+- **The size.** `icon_size` 16, 32 or 64 px a side, 32 unless given: the size the game shows them at.
+- **The theme.** The instruction is optional: what the icons have in common, their colours,
+  their framing, their material. Use the style guide's words.
+- **No references, no text.** An icon never carries text or numbers: the game draws counts and labels.
+- **Enrichment.** Turn it off (`enrich: false`) when the instruction above is complete; leave it on when all you have is the person's few words.
 
 ## After
 

package/skills/pixelvibing-object/SKILL.md

@@ -15,6 +15,8 @@ Load the `pixelvibing` Skill first: who is signed in, the style guide, the limit
 pixel-vibing-cli generate object --instruction "<what>" --size <cols>x<rows> [--reference <png>]... [--no-enrich] --yes --json
 ```
 
+The fields under *Writing it* are these flags: `size` is `--size`, each of `reference_images` a `--reference <png>`, such as a concept art pulled under `pixelvibing/ref/`, and `enrich: false` is `--no-enrich`.
+
 ## With the MCP server
 
 ```json
@@ -31,14 +33,12 @@ pixel-vibing-cli generate object --instruction "<what>" --size <cols>x<rows> [--
   and colours, the details that make it read at its size, and what it is for in the game.
   Use the style guide's words for the look; never restate its camera or outline, the
   platform adds them. No artist's or other game's names, and no text in the picture.
-- **The footprint.** `--size` (MCP `size`) is how many tiles it stands on, `1x1` unless
-  given: a crate is `1x1`, a cart `2x1`, a house `3x3`. The platform sizes the drawing to the
-  project's tile size.
-- **References.** Up to 8 pictures to draw from: a concept art tagged `anchor` keeps every
-  object on one look (`pixelvibing/ref/<name>.png` for the CLI, its image id from
-  `list_concept_art` for MCP), and a sketch or an earlier object keeps a shape.
-- **Enrichment.** Pass `--no-enrich` (`enrich: false`) when the instruction above is
-  complete; leave it on when all you have is the person's few words.
+- **The footprint.** `size` is how many tiles it stands on, 1×1 unless given: a crate is
+  1×1, a cart 2×1, a house 3×3. The platform sizes the drawing to the project's tile size.
+- **References.** Up to 8 pictures to draw from (`reference_images`): a concept art tagged
+  `anchor` keeps every object on one look, and a sketch or an earlier object keeps a shape.
+- **One at a time.** Never generate the same object again to fix a detail: change it instead.
+- **Enrichment.** Turn it off (`enrich: false`) when the instruction above is complete; leave it on when all you have is the person's few words.
 
 ## After
 

package/skills/pixelvibing-sound/SKILL.md

@@ -18,6 +18,8 @@ pixel-vibing-cli generate music --instruction "<the piece>" [--seconds <3-600>]
 pixel-vibing-cli generate music --plan <plan.json> [--out <file>] --yes --json
 ```
 
+The fields under *Writing it* are these flags: `seconds` is `--seconds`, `loop` is `--loop`, `instrumental` is `--instrumental`, and a `plan` is a file `--plan` reads.
+
 A plan's file is the track section by section, in order:
 
 ```json
@@ -50,25 +52,27 @@ with the tool `generate_sound`. `get_job` follows the job and, once done, names
 
 ## Writing it
 
-- **A sound effect.** What makes the sound and how it feels: "a wooden door creaking open,
-  slow", "a coin picked up, bright and short". `--seconds` sets its length; `--loop` makes it
-  loop seamlessly, for rain, wind or an engine.
-- **Speech.** The words exactly as they are said, in a voice. Keep a line short; one line a
-  generation.
-- **Music.** The mood, the instruments and the tempo: "a calm harbour theme on strings and a
-  soft accordion". It runs 60 seconds unless `--seconds` (`seconds`) says otherwise, from 3 to
-  600. A game's theme, a level's loop or a menu track is asked at its full length: a short one
-  ends where it stops. `--instrumental` (`instrumental`) makes one with no voice.
-- **Music section by section.** Give a plan instead of a description when the track has parts
-  that must land in order: an intro, a loop, a boss phase, an ending. Each section is 3 to 120
-  seconds, with its own styles, styles to avoid, and lyrics for its sung lines (none for an
-  instrumental part); the track is at most 600 seconds in all. `flexibleLengths`
-  (`flexible_lengths` on the MCP server) lets each section's length move while the track's stays.
+- **A sound effect** (`sfx`). What makes the sound and how it feels: "a wooden door creaking
+  open, slow", "a coin picked up, bright and short". `seconds` sets its length; `loop` makes
+  it loop seamlessly, for rain, wind or an engine.
+- **Speech** (`speech`). The words exactly as they are said, in a `voice`. Keep a line short;
+  one line a generation.
+- **Music** (`music`). The mood, the instruments and the tempo: "a calm harbour theme on
+  strings and a soft accordion". It runs 60 seconds unless `seconds` says otherwise, from 3
+  to 600. A game's theme, a level's loop or a menu track is asked at its full length: a short
+  one ends where it stops. `instrumental` makes one with no voice.
+- **Music section by section.** Give a `plan` instead of a description when the track has
+  parts that must land in order: an intro, a loop, a boss phase, an ending. Each section is 3
+  to 120 seconds, with its own styles, styles to avoid, and lyrics for its sung lines; the
+  track is at most 600 seconds in all. `flexible_lengths` lets each section's length move
+  while the track's stays.
 - **What music uses.** Music uses the limit by the minute of its length, rounded up: a
-  four-minute theme uses four times a one-minute one. Say so before asking for a long track, and
-  keep `max_percent` to what the person agreed.
+  four-minute theme uses four times a one-minute one. Say so before asking for a long track.
 - **Original sound.** Never another game's music or theme, and never a real person's voice:
   when the person names one, make original sound in its spirit and say so.
+
+## After
+
 - **Where it goes.** The game loads the MP3 from where it was written; copy it into the game's
   own audio folder when that is where the engine looks. Sounds are not part of the map, the
   export or the sealed container.

package/skills/pixelvibing-ui/SKILL.md

@@ -19,6 +19,8 @@ and `references/ui.example.json` is a whole HUD laid out.
 pixel-vibing-cli generate ui --sketch <file.json> --instruction "<the set, in a line>" [--reference <png>]... --yes --json
 ```
 
+The fields under *Writing it* are the sketch's: `canvas` and `shapes` are its file's, read by `--sketch`; each of the references a `--reference <png>`; `--no-enrich` and `enrich` are refused for a UI.
+
 ## With the MCP server
 
 The layout goes in the call itself, as `canvas` and `shapes`, with the same fields:
@@ -39,13 +41,18 @@ result's `missing`: generate the UI again for it rather than retrying the whole
 
 - **The instruction** is the set's theme in a line, up to 600 characters; what each piece
   is goes in its `label` and `note`.
-- **References**, up to 3, are a style to follow (frames, materials, a way of drawing),
-  never what to draw. A concept art tagged `ui` is the usual one.
-- **Text.** Only a `caption` is drawn as text. Counts, values and names change in play: the
+- **The canvas.** `canvas` is 128×128, 256×256, 256×128 or 128×256 px: the one the screen's
+  pieces fit at the size the game shows them.
+- **The shapes.** 1 to 16, none overlapping, 4 px or more apart. Each has a `label` (its role,
+  never drawn, unique), a `kind` (`rect`, `ellipse` or `polygon` with `sides` 3 to 8),
+  `x`, `y`, `width` and `height` (at least 4), and as needed a `caption` (the only text
+  drawn), a `note` (how it looks), a `border` (its frame, which stretches) and `hollow`
+  (only the border drawn).
+- **References**, up to 3, are a style to follow (frames, materials, a way of drawing), never
+  what to draw. A concept art tagged `ui` is the usual one.
+- **Text.** Only a caption is drawn as text. Counts, values and names change in play: the
   game draws them.
-- **No enrichment switch.** A UI's layout is read as it is; `--no-enrich` and `enrich` are
-  refused for it.
-- `ui-sketch` is the same kind by its platform name.
+- **No enrichment switch.** A UI's layout is read as it is; `enrich` is refused for it.
 
 ## After