gamesteel 0.3.3 → 0.4.1

package/dist/pkgs/studio/dist/server/playtest-worker.js

@@ -67964,6 +67964,41 @@ function playtestSceneAt(session, viewport, art = {}) {
   return sceneShown({ prev: session.state, curr: session.state, prevCam: placed, currCam: placed, alpha: 1, droppedTicks: 0 }, session.facing, viewport, { view, camera, art: { game: session.shown.art, book: art.book ?? /* @__PURE__ */ new Map() } });
 }
 
+// ../core/dist/playtest/witness.js
+init_limits();
+var sixteenth = (value) => Math.round(value * 16) / 16;
+function checkpointOf(session, ticks) {
+  const { state } = session;
+  const kinds = {};
+  for (const entity of state.entities)
+    if (entity.alive)
+      kinds[entity.kind] = (kinds[entity.kind] ?? 0) + 1;
+  const first = state.entities.filter((entity) => entity.alive && (entity.props.get("player") ?? 0) >= 1).sort((a, b) => a.id - b.id)[0];
+  const seen2 = first === void 0 ? void 0 : inspect(session, [`#${String(first.id)}`])[0];
+  return {
+    at: Math.round(ticks / TICKS_PER_SECOND * 10) / 10,
+    status: state.status,
+    player: seen2 === void 0 ? null : { x: sixteenth(seen2.x), y: sixteenth(seen2.y) },
+    kinds
+  };
+}
+function witnessRun(session, track) {
+  const inputs = decodeTrack(track);
+  const checkpoints = [];
+  let now = session;
+  let ticks = 0;
+  for (let from = 0; from < inputs.length; from += TICKS_PER_SECOND) {
+    const piece = inputs.slice(from, from + TICKS_PER_SECOND);
+    const result = play(now, piece);
+    now = result.session;
+    ticks += result.ticks;
+    checkpoints.push(checkpointOf(now, ticks));
+    if (now.state.status !== "playing")
+      break;
+  }
+  return { status: now.state.status, checkpoints };
+}
+
 // ../core/dist/render/pixel-font.js
 var PIXEL_FONT = {
   "A": [".###.", "#...#", "#...#", "#####", "#...#", "#...#", "#...#"],
@@ -76499,7 +76534,7 @@ var START = [
   "## Read as you go",
   "",
   "- game: the game text. Read it before writing one.",
-  "- scripts, then api: how scripts run, and the exact TypeScript they are checked against. Most of a good game",
+  "- scripts, then api and api-game: how scripts run, and the exact TypeScript they are checked against. Most of a good game",
   "  lives in its scripts.",
   "- drawing: art drawn in code: shapes, gradients, soft light, curves, panels, every option.",
   "- style: craft -- palette, light, texture, depth, UI and type, and the tells that make art look generated.",
@@ -76511,7 +76546,7 @@ var START = [
   "- edit: ids, the edit operations, and write_code against edit.",
   "- art: art paint, pictures painted once against the 2D canvas.",
   "- model: art model, 3D art Blender builds from a short script, when the person asks for 3D.",
-  "- team: working beside the person's teammates and their agents on the same game.",
+  "- team: working beside the person's teammates and their agents on the same game, and a game's move to a newer engine.",
   "",
   "## Others may be working on this game",
   "",
@@ -76538,6 +76573,9 @@ var START = [
   "   the title, a menu, a hit, the ending. Words are cheap; pictures cost more, so look on purpose.",
   "6. Polish until it is a game you would show someone.",
   "",
+  "games new and games open answer with the game's link, where the person sees and plays it in the editor: give it to",
+  "the person whenever there is something to see, the first time above all. A look with shaders is drawn there too.",
+  "",
   "## Made for this game, never repeated",
   "",
   "Before a character, a creature, a vehicle, a building, or any song:",
@@ -76874,16 +76912,27 @@ var MODEL = [
 ];
 var SCRIPTS = [
   ...SCRIPTS_PRIMER,
-  "The exact declarations every script is checked against are the api topic."
+  "The exact declarations every script is checked against are the api and api-game topics."
 ];
-function agentApi() {
+function agentApi(part) {
   const own3 = (what, name) => `/** ${what}: one of the game's own, own:<name>, made for it. */
 type ${name} = \`own:\${string}\`
 `;
-  return [
-    "// The script API, as the type checker holds scripts to it. A sound and a song are the game's own (own:<name>); the",
-    "// stock names older games still use are left out here.",
-    SCRIPT_API.trimEnd().replace(/(?:\/\*\*[^\n]*\*\/\n)?type SoundName = [^\n]*\n/, () => own3("A sound", "SoundName")).replace(/(?:\/\*\*[^\n]*\*\/\n)?type MusicName = [^\n]*\n/, () => own3("A song", "MusicName"))
+  const whole = SCRIPT_API.trimEnd().replace(/(?:\/\*\*[^\n]*\*\/\n)?type SoundName = [^\n]*\n/, () => own3("A sound", "SoundName")).replace(/(?:\/\*\*[^\n]*\*\/\n)?type MusicName = [^\n]*\n/, () => own3("A song", "MusicName"));
+  const at2 = whole.indexOf("\ninterface Game {");
+  if (at2 < 0)
+    throw new Error("the script API has no interface Game to split it at");
+  return part === "objects" ? [
+    "// The script API, part one, as the type checker holds scripts to it: the shared types, tweens and sequences, Thing,",
+    "// sounds, songs and the Mixer, Turns, the UI, spawning, Behaviour, Bot, Check, GameScript, input, rays, the camera",
+    "// and bursts. A sound and a song are the game's own (own:<name>); the stock names older games still use are left",
+    "// out here. this.game, drawing, noise and console are part two, the api-game topic.",
+    whole.slice(0, at2).trimEnd()
+  ].join("\n") : [
+    "// The script API, part two, as the type checker holds scripts to it: this.game (interface Game), drawing (Draw,",
+    "// its layers, paints and shaders), noise and console. The types it names, Thing, Point and Colour among them, are",
+    "// part one, the api topic.",
+    whole.slice(at2 + 1)
   ].join("\n");
 }
 var TEAM = [
@@ -76915,7 +76964,18 @@ var TEAM = [
   "  task. Leave it to them; if your person asked you to change it, send the same change again and it goes through.",
   "- Nobody is blocked for good: a claim lapses when its holder has been quiet for 30 minutes, and their task can",
   "  then be taken over.",
-  "- Your edits carry the title of the task you took as their note, so the team sees why each change was made."
+  "- Your edits carry the title of the task you took as their note, so the team sees why each change was made.",
+  "",
+  "## Engine moves",
+  "",
+  "- When Gamesteel moves to a newer engine, the first call that names a game checked against an older one says what",
+  '  changed for it. When a change touches the game, or its recorded play differs, a task "Engine A \u2192 B: n of m changes',
+  '  touch this game" is put on its board.',
+  "- Take it like any task. games open shows the whole report while it is open: each change with the places it touches",
+  "  and how to fix it, and where each recorded win first plays differently on the new engine.",
+  "- Fix the game with the usual tools, playtest each level to a win, then mark the task done: the game is then checked",
+  "  against the new engine.",
+  "- A playtest that wins is kept as its level's recorded win: the evidence the next move compares against."
 ];
 var FILM = [
   "# Films",
@@ -77126,18 +77186,19 @@ var GUIDE_TOPICS = [
   { name: "start", about: "how to work, and the bar for a finished game -- read it first", text: () => START.join("\n") },
   { name: "game", about: "the game text: settings, types, bodies, levels and tiles, the camera, rules, controls", text: () => [...quickWay(), ...gameText()].join("\n") },
   { name: "scripts", about: "how scripts run: hooks, state, timers, tweens, screens, sound, with ready-made UI", text: () => SCRIPTS.join("\n") },
-  { name: "api", about: "the script API, exactly as the type checker holds scripts to it", text: () => agentApi() },
+  { name: "api", about: "the script API, part one: Thing, scripts, sound, UI, input", text: () => agentApi("objects") },
+  { name: "api-game", about: "the script API, part two: this.game and drawing", text: () => agentApi("game") },
   { name: "drawing", about: "art drawn in code: layers and units, shapes, gradients, soft light, curves, panels, push and pop, screens that scale", text: () => DRAWING.join("\n") },
-  { name: "shaders", about: "drawing with the graphics card: boxes painted by a shader, shaders over the picture, passes, lists and paintings as inputs", text: () => SHADERS.join("\n") },
+  { name: "shaders", about: "drawing with the graphics card: shaded boxes, shaders over the picture, passes, inputs", text: () => SHADERS.join("\n") },
   { name: "style", about: "craft: palette, light, texture, depth, UI and type, and the tells that make art look generated", text: () => STYLE.join("\n") },
   { name: "feel", about: "screens, transitions, juice, sound and music", text: () => FEEL.join("\n") },
   { name: "sound", about: "designed sound effects and composed music: layers, variants, instruments, loudness, and listening", text: () => SOUND_TOPIC.join("\n") },
   { name: "playtest", about: "playing it yourself with tracks and bots, and looking at it", text: () => playtestGuide().join("\n") },
   { name: "edit", about: "ids, the edit operations, and write_code against edit", text: () => howToEdit().join("\n") },
   { name: "art", about: "art paint: pictures, animations and tilesets painted against the 2D canvas", text: () => ART.join("\n") },
-  { name: "model", about: "art model: 3D art Blender builds from a short script against the kit, when the person asks for 3D", text: () => MODEL.join("\n") },
-  { name: "team", about: "working beside teammates and their agents: the board, taking with parts, claims, notes", text: () => TEAM.join("\n") },
-  { name: "film", about: "films: levels that play themselves, cutscenes, chapters, endFilm, and film render, which makes them MP4 video", text: () => FILM.join("\n") }
+  { name: "model", about: "art model: 3D art Blender builds from a short script, when the person asks for 3D", text: () => MODEL.join("\n") },
+  { name: "team", about: "working beside teammates and their agents: the board, parts, claims, notes", text: () => TEAM.join("\n") },
+  { name: "film", about: "films: levels that play themselves, cutscenes, chapters, endFilm, and film render to MP4", text: () => FILM.join("\n") }
 ];
 
 // ../agent/dist/artgen-tools.js
@@ -90077,9 +90138,22 @@ ${done.text}`,
       track: encodeTrack(done.session.inputs),
       step: state.step,
       status: state.status,
-      version: entry.version
+      version: entry.version,
+      run: { seed: entry.seed, language: entry.language }
     };
   }
+  async witness(source, run2) {
+    if (source.scripts !== null)
+      await initScripting();
+    const session = createPlaytest(source.text, source.level, {
+      ...source.scripts === null ? {} : { scripts: source.scripts },
+      seed: run2.seed,
+      ...source.audio === void 0 ? {} : { audio: source.audio },
+      ...source.fonts === void 0 ? {} : { fonts: source.fonts },
+      ...run2.language === null ? {} : { language: run2.language }
+    });
+    return witnessRun(session, run2.track);
+  }
   async act(entry, source, action, raw) {
     const session = entry.session;
     switch (action) {
@@ -90339,6 +90413,9 @@ port.on("message", (message) => {
         case "size":
           ok2 = await service.size();
           break;
+        case "witness":
+          ok2 = await service.witness(...message.args);
+          break;
       }
       port.postMessage({ id: message.id, ok: ok2 });
     } catch (error2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gamesteel",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "The Gamesteel program your AI agent starts, and the command that sets it up in Claude Code, Codex, Gemini CLI, Cursor, VS Code and 26 more. The work runs on your machine; the website keeps your games.",
   "keywords": [
     "gamesteel",
@@ -26,13 +26,6 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "pretest": "pnpm --filter \"gamesteel^...\" --filter \"!@gamesteel/studio\" build && pnpm --filter @gamesteel/studio exec tsc -p tsconfig.json && pnpm build",
-    "build": "tsc --noEmit -p tsconfig.json && node build.mjs",
-    "prepublishOnly": "pnpm run build",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json"
-  },
   "dependencies": {
     "@jitl/quickjs-singlefile-mjs-release-sync": "0.32.0",
     "@napi-rs/canvas": "^1.0.10",
@@ -42,20 +35,27 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@gamesteel/accounts": "workspace:*",
-    "@gamesteel/agent": "workspace:*",
-    "@gamesteel/billing": "workspace:*",
-    "@gamesteel/builder": "workspace:*",
-    "@gamesteel/cloud": "workspace:*",
-    "@gamesteel/connect": "workspace:*",
-    "@gamesteel/core": "workspace:*",
-    "@gamesteel/design": "workspace:*",
-    "@gamesteel/edit": "workspace:*",
-    "@gamesteel/model": "workspace:*",
-    "@gamesteel/service": "workspace:*",
-    "@gamesteel/store": "workspace:*",
-    "@gamesteel/studio": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "esbuild": "0.28.2"
+    "esbuild": "0.28.2",
+    "@gamesteel/billing": "0.1.0",
+    "@gamesteel/agent": "0.1.0",
+    "@gamesteel/connect": "0.1.0",
+    "@gamesteel/builder": "0.1.0",
+    "@gamesteel/cloud": "0.1.0",
+    "@gamesteel/core": "0.1.0",
+    "@gamesteel/edit": "0.1.0",
+    "@gamesteel/accounts": "0.1.0",
+    "@gamesteel/service": "0.1.0",
+    "@gamesteel/i18n": "0.1.0",
+    "@gamesteel/studio": "0.1.0",
+    "@gamesteel/store": "0.1.0",
+    "@gamesteel/design": "0.1.0",
+    "@gamesteel/model": "0.1.0"
+  },
+  "scripts": {
+    "pretest": "pnpm --filter \"gamesteel^...\" --filter \"!@gamesteel/studio\" build && pnpm --filter @gamesteel/studio exec tsc -p tsconfig.json && pnpm build",
+    "build": "tsc --noEmit -p tsconfig.json && node build.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json"
   }
-}
+}