@volter/play 0.5.211 → 0.5.213

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@volter/play",
-  "version": "0.5.211",
+  "publisher": "volter",
+  "version": "0.5.213",
+  "engines": {
+    "vscode": "^1.104.0"
+  },
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
   "type": "module",
-  "description": "Play scripts on detached model documents.",
+  "description": "Play for a volter-ai/std game in Cyclotron: the game's own dev pages as std devices in the level's stage, the Game panel, a level's export on save and a level in code's document.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/volter-ai/editor.git",
@@ -12,30 +16,293 @@
   },
   "files": [
     "src",
+    "serving",
     "contributions",
+    "dist-node",
     "LICENSE",
     "NOTICE"
   ],
   "exports": {
     "./contributions/*": "./contributions/*",
     "./package.json": "./package.json",
-    "./play-script": "./src/play-script.ts"
+    "./play-log": "./src/play-log.ts"
   },
-  "volter": {
-    "contributions": [
-      "./contributions/model-play.command.ts",
-      "./contributions/model-play.service.tsx"
-    ]
+  "extensionDependencies": [
+    "volter.@volter/editor-blender",
+    "volter.@volter/editor-threejs"
+  ],
+  "contributes": {
+    "volter": {
+      "activationEvents": [
+        "onCustomEditor:volter.blender.model",
+        "onDocument:std-level"
+      ],
+      "serving": [
+        "./dist-node/serving.mjs"
+      ],
+      "page": [
+        "./contributions/play.page.tsx"
+      ],
+      "editors": [
+        {
+          "document": "./contributions/std-level.document.tsx",
+          "kind": "std-level"
+        }
+      ],
+      "projectAdapters": [
+        {
+          "when": "std.json",
+          "module": "./src/std-game-adapter.ts"
+        }
+      ],
+      "finders": [
+        {
+          "name": "stdLevelDocuments",
+          "module": "./contributions/levels.finder.ts"
+        }
+      ]
+    },
+    "languageModelTools": [
+      {
+        "name": "play-log",
+        "tags": [
+          "volter"
+        ],
+        "displayName": "Play log",
+        "modelDescription": "What the running std game's pages traced, each entry tagged with its player's slot, and Play's own lifecycle entries.",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "since": {
+              "type": "number",
+              "description": "Keep entries at or after this many game seconds."
+            },
+            "kind": {
+              "type": "string",
+              "description": "Keep one kind of entry."
+            }
+          },
+          "required": [],
+          "additionalProperties": false
+        }
+      },
+      {
+        "name": "play",
+        "tags": [
+          "volter"
+        ],
+        "displayName": "Play control",
+        "modelDescription": "Control Play for the project's std game: state, play, stop, pause, resume or restart. Answers the game's state: play and restart answer once a player's page has joined the game (clock.running), or fail with why it did not start.",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "enum": [
+                "state",
+                "play",
+                "stop",
+                "pause",
+                "resume",
+                "restart"
+              ]
+            }
+          },
+          "required": [
+            "action"
+          ],
+          "additionalProperties": false
+        }
+      }
+    ],
+    "commands": [
+      {
+        "command": "volter.play",
+        "title": "play",
+        "category": "Play",
+        "volter": {
+          "derivedRefresh": "none",
+          "timeoutMs": 120000
+        }
+      },
+      {
+        "command": "volter.play-log",
+        "title": "play-log",
+        "category": "Play",
+        "volter": {
+          "derivedRefresh": "none"
+        }
+      },
+      {
+        "command": "volter.play.state",
+        "title": "state",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.mode",
+        "title": "mode",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.game-mode",
+        "title": "Switch to Game Mode",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.animation-mode",
+        "title": "Switch to Animation Mode",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.play",
+        "title": "Play",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.stop",
+        "title": "Stop",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.pause",
+        "title": "Pause",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.resume",
+        "title": "Resume",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.step",
+        "title": "Step One Tick",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.speed",
+        "title": "speed",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.players",
+        "title": "players",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.autoplay",
+        "title": "autoplay",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.restart",
+        "title": "Restart",
+        "category": "Game"
+      },
+      {
+        "command": "volter.play.export",
+        "title": "export",
+        "category": "Game"
+      }
+    ],
+    "menus": {
+      "commandPalette": [
+        {
+          "command": "volter.play",
+          "when": "false"
+        },
+        {
+          "command": "volter.play-log",
+          "when": "false"
+        },
+        {
+          "command": "volter.play.state",
+          "when": "false"
+        },
+        {
+          "command": "volter.play.mode",
+          "when": "false"
+        },
+        {
+          "command": "volter.play.speed",
+          "when": "false"
+        },
+        {
+          "command": "volter.play.players",
+          "when": "false"
+        },
+        {
+          "command": "volter.play.autoplay",
+          "when": "false"
+        },
+        {
+          "command": "volter.play.export",
+          "when": "false"
+        }
+      ]
+    },
+    "configuration": {
+      "title": "Play",
+      "properties": {
+        "volter.play.players": {
+          "type": "integer",
+          "default": 1,
+          "minimum": 1,
+          "maximum": 8,
+          "scope": "window",
+          "description": "How many players a std game's Play starts: yours, and a bot playing the Game panel's goal for each other. One where unset. The Game panel's Players [-][+] and `play players <n>` write it to the project's settings (.vscode/settings.json), and a running game's players join or leave whenever it changes."
+        }
+      }
+    }
   },
   "dependencies": {
-    "@volter/sdk": "0.5.211"
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "three": "^0.180.0"
+    "three": ">=0.186.0 <0.187.0",
+    "@volter/sdk": "0.5.213",
+    "@volter/project": "0.5.213",
+    "vite": "^6.4.3 || ^7.0.0 || ^8.0.0",
+    "@volter/live": "0.5.213",
+    "@volter/editor-blender": "0.1.152",
+    "@volter/editor-threejs": "0.5.213",
+    "@react-three/fiber": "^9.8.2",
+    "@react-three/rapier": "^2.2.0",
+    "postprocessing": "^6.39.5",
+    "@volter-ai/std": "^0.8.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "build": "node scripts/build-serving.mjs"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@volter/editor-blender": "0.1.152",
+    "@volter/editor-threejs": "0.5.213",
+    "@volter/live": "0.5.213",
+    "@volter/sdk": "0.5.213",
+    "esbuild": "0.25.12",
+    "typescript": "5.9.3"
+  },
+  "peerDependenciesMeta": {
+    "@volter/sdk": {
+      "optional": true
+    },
+    "@react-three/fiber": {
+      "optional": true
+    },
+    "@react-three/rapier": {
+      "optional": true
+    },
+    "postprocessing": {
+      "optional": true
+    },
+    "@volter-ai/std": {
+      "optional": true
+    }
   }
 }

package/serving/index.ts

@@ -0,0 +1,13 @@
+/**
+ * `@volter/play`'s server half (`package.json#contributes.volter.serving`): a std game's dev server as Play reaches it,
+ * and its level export's Node half (`std-dev.ts`); a std level's scene as a module of the game's own graph, which the
+ * level's document draws (`std-scene.ts`).
+ */
+import type { ProjectServingServices } from '@volter/sdk/session/project-serving';
+import { stdDevPlugin } from './std-dev';
+import { stdScenePlugin } from './std-scene';
+
+export const servingPlugins = (services: ProjectServingServices): readonly unknown[] => [
+  stdDevPlugin(services),
+  stdScenePlugin(services),
+];