luanette 0.4.0 → 0.5.0

package/luanette.mjs

@@ -7,7 +7,7 @@
 //   luanette sound "C4 pulse 5, E4 slide, -, G4 saw 7 fadeout" [--speed N] [--loop A-B]
 //   luanette sound CART.lua N --wav OUT.wav                 a cart's sound, as a WAV
 //   luanette song CART.lua [--from N] --wav OUT.wav         its song
-//   luanette link CART.lua [--name NAME]                     a playground share link
+//   luanette link CART.lua [--name NAME] [--play]            a playground share link (--play: opens in play mode)
 //   luanette new NAME [--template blank|platformer|shooter|puzzle]
 //   luanette mcp                                             an MCP server over stdio (for agents)
 //
@@ -375,9 +375,10 @@ export async function renderAudio(src, n, from = null, rate = 44100) {
 }
 
 // ---- links and new carts ---------------------------------------------------------------------------
-export function shareLink(src, name, base = PLAYGROUND) {
+// "&play" after it opens the cart in play mode: the screen alone, with buttons on a phone.
+export function shareLink(src, name, base = PLAYGROUND, play = false) {
   const data = zlib.deflateRawSync(Buffer.from(JSON.stringify({ name, src })), { level: 9 });
-  return base + "#cart=d" + data.toString("base64url");
+  return base + "#cart=d" + data.toString("base64url") + (play ? "&play" : "");
 }
 export function newCart(name, template = "blank") {
   if (!/^[a-z0-9_-]{1,32}$/.test(name)) throw new Error("a cart's name is 1 to 32 of a-z, 0-9, _ and -");
@@ -436,7 +437,7 @@ async function main() {
     print({ ok: true, wav: opt.wav || "song.wav", seconds: Number(r.seconds.toFixed(2)) });
   } else if (cmd === "link") {
     const { src, name } = readCart(pos[0]);
-    process.stdout.write(shareLink(src, opt.name || name, opt.base || PLAYGROUND) + "\n");
+    process.stdout.write(shareLink(src, opt.name || name, opt.base || PLAYGROUND, opt.play === true) + "\n");
   } else if (cmd === "new") {
     const name = pos[0], file = opt.out || `${name}.lua`;
     if (fs.existsSync(file)) throw new Error(`${file} is there already`);

package/mcp.mjs

@@ -45,8 +45,8 @@ const TOOLS = [
     inputSchema: { type: "object", required: ["notes"], properties: { notes: { type: "string" },
       speed: { type: "integer", description: "Ticks of 1/120 s a note, 1-255 (8)" },
       loop: { type: "array", items: { type: "integer" }, description: "[first, end]: loop those notes for good" } } } },
-  { name: "share_link", description: "A link that opens the cart in the playground (https://geofresh.github.io/luanette/), to play it, edit it or send it to a board.",
-    inputSchema: { type: "object", properties: { ...CART, name: { type: "string" } } } },
+  { name: "share_link", description: "A link that opens the cart in the playground (https://geofresh.github.io/luanette/), to play it, edit it or send it to a board. With play, it opens in play mode: the screen alone, with buttons on a phone.",
+    inputSchema: { type: "object", properties: { ...CART, name: { type: "string" }, play: { type: "boolean", description: "Open in play mode" } } } },
   { name: "api_help", description: "The cart API from docs/api.md: a call's signatures and what it does, or every call whose name or description has a word in it, or (with nothing) the list of names.",
     inputSchema: { type: "object", properties: { name: { type: "string" }, search: { type: "string" } } } },
   { name: "new_cart", description: "A new cart's source from a template (blank, platformer, shooter, puzzle): full-screen, with sprites, sounds and log() to build on.",
@@ -112,7 +112,7 @@ const handlers = {
   },
   async share_link(a) {
     const { src, name } = cartOf(a);
-    return { content: [text(L.shareLink(src, a.name || name))] };
+    return { content: [text(L.shareLink(src, a.name || name, undefined, a.play === true))] };
   },
   async api_help(a) {
     if (a.name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luanette",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Check, run, hear and share carts for Luanette, a Lua game console for ESP32-S3 boards: the console's own engine in Node, nothing to build",
   "bin": { "luanette": "luanette.mjs" },
   "files": ["luanette.mjs", "pyrandom.mjs", "mcp.mjs", "engine/", "lib/", "templates/", "api.json", "README.md", "LICENSE"],