@volter/play 0.5.211 → 0.5.212

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@volter/play",
-  "version": "0.5.211",
+  "publisher": "volter",
+  "version": "0.5.212",
+  "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 its Scene view.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/volter-ai/editor.git",
@@ -12,30 +16,271 @@
   },
   "files": [
     "src",
+    "serving",
     "contributions",
+    "dist-node",
     "LICENSE",
     "NOTICE"
   ],
   "exports": {
     "./contributions/*": "./contributions/*",
     "./package.json": "./package.json",
-    "./play-script": "./src/play-script.ts"
-  },
-  "volter": {
-    "contributions": [
-      "./contributions/model-play.command.ts",
-      "./contributions/model-play.service.tsx"
-    ]
+    "./play-log": "./src/play-log.ts"
   },
-  "dependencies": {
-    "@volter/sdk": "0.5.211"
+  "extensionDependencies": [
+    "volter.@volter/editor-blender",
+    "volter.@volter/editor-threejs"
+  ],
+  "contributes": {
+    "volter": {
+      "activationEvents": [
+        "onCustomEditor:volter.blender.model"
+      ],
+      "serving": [
+        "./dist-node/serving.mjs"
+      ],
+      "page": [
+        "./contributions/play.page.tsx"
+      ],
+      "editors": [
+        {
+          "document": "./contributions/std-scene.document.tsx"
+        }
+      ],
+      "projectAdapters": [
+        {
+          "when": "std.json",
+          "module": "./src/std-game-adapter.ts"
+        }
+      ]
+    },
+    "languageModelTools": [
+      {
+        "name": "model-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": {
+            "documentId": {
+              "type": "string",
+              "description": "The model document; the active Play's when omitted."
+            },
+            "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": "model-play",
+        "tags": [
+          "volter"
+        ],
+        "displayName": "Play control",
+        "modelDescription": "Control Play for the open level's std game: state, play, stop, pause, resume or restart. Answers the game's state.",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "enum": [
+                "state",
+                "play",
+                "stop",
+                "pause",
+                "resume",
+                "restart"
+              ]
+            }
+          },
+          "required": [
+            "action"
+          ],
+          "additionalProperties": false
+        }
+      }
+    ],
+    "commands": [
+      {
+        "command": "volter.model-play",
+        "title": "model-play",
+        "category": "Play",
+        "volter": {
+          "derivedRefresh": "none"
+        }
+      },
+      {
+        "command": "volter.model-play-log",
+        "title": "model-play-log",
+        "category": "Play",
+        "volter": {
+          "derivedRefresh": "none"
+        }
+      },
+      {
+        "command": "volter.std-scene",
+        "title": "Open Scene View",
+        "category": "Play",
+        "volter": {
+          "derivedRefresh": "none"
+        }
+      },
+      {
+        "command": "volter.model-play.state",
+        "title": "state",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.mode",
+        "title": "mode",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.game-mode",
+        "title": "Switch to Game Mode",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.animation-mode",
+        "title": "Switch to Animation Mode",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.play",
+        "title": "Play",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.stop",
+        "title": "Stop",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.pause",
+        "title": "Pause",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.resume",
+        "title": "Resume",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.step",
+        "title": "Step One Tick",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.speed",
+        "title": "speed",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.autoplay",
+        "title": "autoplay",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.restart",
+        "title": "Restart",
+        "category": "Game"
+      },
+      {
+        "command": "volter.model-play.export",
+        "title": "export",
+        "category": "Game"
+      }
+    ],
+    "menus": {
+      "commandPalette": [
+        {
+          "command": "volter.model-play",
+          "when": "false"
+        },
+        {
+          "command": "volter.model-play-log",
+          "when": "false"
+        },
+        {
+          "command": "volter.model-play.state",
+          "when": "false"
+        },
+        {
+          "command": "volter.model-play.mode",
+          "when": "false"
+        },
+        {
+          "command": "volter.model-play.speed",
+          "when": "false"
+        },
+        {
+          "command": "volter.model-play.autoplay",
+          "when": "false"
+        },
+        {
+          "command": "volter.model-play.export",
+          "when": "false"
+        }
+      ]
+    }
   },
   "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.212",
+    "@volter/project": "0.5.212",
+    "vite": "^6.4.3 || ^7.0.0 || ^8.0.0",
+    "@volter/live": "0.5.212",
+    "@volter/editor-blender": "0.1.151",
+    "@volter/editor-threejs": "0.5.212",
+    "@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.151",
+    "@volter/editor-threejs": "0.5.212",
+    "@volter/live": "0.5.212",
+    "@volter/sdk": "0.5.212",
+    "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
+ * Scene view 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),
+];