@pix3/cli 1.6.0 → 1.6.2

package/package.json

@@ -1,54 +1,54 @@
-{
-  "name": "@pix3/cli",
-  "version": "1.6.0",
-  "description": "Pix3 command line: create a project from a recipe, and link your own coding agent (Claude Code, Codex, ...) to an open Pix3 editor window over a loopback MCP channel.",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/pix3dev/pix3.git",
-    "directory": "packages/pix3-cli"
-  },
-  "bin": {
-    "pix3": "dist/index.js"
-  },
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "templates",
-    "kit",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=24.15.0 <25"
-  },
-  "scripts": {
-    "start": "node src/index.ts",
-    "build": "tsc -p tsconfig.build.json && node scripts/build-bin.mjs && node scripts/build-validate.mjs && node scripts/build-smoke.mjs",
-    "copy-templates": "node scripts/copy-templates.mjs",
-    "prepack": "npm run copy-templates && npm run build && npm run build-runtime-types && npm run build-kit",
-    "postpack": "node scripts/copy-templates.mjs --clean",
-    "type-check": "tsc --noEmit && tsc --noEmit -p tsconfig.build.json",
-    "build-kit": "node scripts/build-kit.mjs",
-    "build-runtime-types": "node scripts/build-runtime-types.mjs"
-  },
-  "keywords": [
-    "pix3",
-    "cli",
-    "mcp",
-    "game-engine",
-    "agent"
-  ],
-  "license": "Apache-2.0",
-  "optionalDependencies": {
-    "esbuild": "^0.27.3"
-  },
-  "devDependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@types/node": "^24.5.2",
-    "@types/ws": "^8.18.1",
-    "typescript": "~5.8.3",
-    "ws": "^8.18.0",
-    "yaml": "^2.6.0"
-  }
-}
+{
+  "name": "@pix3/cli",
+  "version": "1.6.2",
+  "description": "Pix3 command line: create a project from a recipe, and link your own coding agent (Claude Code, Codex, ...) to an open Pix3 editor window over a loopback MCP channel.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pix3dev/pix3.git",
+    "directory": "packages/pix3-cli"
+  },
+  "bin": {
+    "pix3": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "templates",
+    "kit",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=24.15.0 <25"
+  },
+  "scripts": {
+    "start": "node src/index.ts",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-bin.mjs && node scripts/build-validate.mjs && node scripts/build-smoke.mjs",
+    "copy-templates": "node scripts/copy-templates.mjs",
+    "prepack": "npm run copy-templates && npm run build && npm run build-runtime-types && npm run build-kit",
+    "postpack": "node scripts/copy-templates.mjs --clean",
+    "type-check": "tsc --noEmit && tsc --noEmit -p tsconfig.build.json",
+    "build-kit": "node scripts/build-kit.mjs",
+    "build-runtime-types": "node scripts/build-runtime-types.mjs"
+  },
+  "keywords": [
+    "pix3",
+    "cli",
+    "mcp",
+    "game-engine",
+    "agent"
+  ],
+  "license": "Apache-2.0",
+  "optionalDependencies": {
+    "esbuild": "^0.27.3"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/node": "^24.5.2",
+    "@types/ws": "^8.18.1",
+    "typescript": "~5.8.3",
+    "ws": "^8.18.0",
+    "yaml": "^2.6.0"
+  }
+}

package/templates/empty-2d/files/README.md

@@ -1,20 +1,20 @@
-# {{PROJECT_NAME}}
-
-A Pix3 project created from the **Empty 2D** template.
-
-## Project structure
-
-- `design/` — game design document and reference images
-- `scenes/` — scene files (`.pix3scene`, YAML)
-- `sprites/` — images and textures
-- `scripts/` — game scripts (`export class X extends Script`, used as `user:X`)
-- `audio/` — music and sound effects
-- `AGENTS.md` — rules and pointers for AI agents working on this project
-
-New asset-type folders (models, fonts, …) are created as you add those assets.
-
-## Getting started
-
-1. Open the project folder in the Pix3 editor.
-2. `scenes/main.pix3scene` is the startup scene — press Play to run it.
-3. Drop your GDD and reference art into `design/`, then ask an AI agent to build the game.
+# {{PROJECT_NAME}}
+
+A Pix3 project created from the **Empty 2D** template.
+
+## Project structure
+
+- `design/` — game design document and reference images
+- `scenes/` — scene files (`.pix3scene`, YAML)
+- `sprites/` — images and textures
+- `scripts/` — game scripts (`export class X extends Script`, used as `user:X`)
+- `audio/` — music and sound effects
+- `AGENTS.md` — rules and pointers for AI agents working on this project
+
+New asset-type folders (models, fonts, …) are created as you add those assets.
+
+## Getting started
+
+1. Open the project folder in the Pix3 editor.
+2. `scenes/main.pix3scene` is the startup scene — press Play to run it.
+3. Drop your GDD and reference art into `design/`, then ask an AI agent to build the game.

package/templates/empty-2d/files/scenes/main.pix3scene

@@ -1,68 +1,68 @@
-# Pix3 Scene File (YAML)
-# Empty 2D starter: a Full HD canvas with a background, a centered label and the
-# project logo. All content lives on the 2D layer.
-version: 1.0.0
-metadata:
-  author: Pix3 Template
-  description: Empty 2D starter scene
-root:
-  - id: game-root
-    type: Group2D
-    name: Game Root
-    properties:
-      width: 1920
-      height: 1080
-      layout:
-        enabled: true
-        horizontalAlign: stretch
-        verticalAlign: stretch
-    children:
-      - id: background
-        type: ColorRect2D
-        name: Background
-        properties:
-          width: 1920
-          height: 1080
-          color: "#1a1a2e"
-          transform:
-            position: [0, 0]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: stretch
-            verticalAlign: stretch
-        children: []
-      - id: title-label
-        type: Label2D
-        name: Title Label
-        properties:
-          label: "{{PROJECT_NAME}}"
-          labelFontSize: 72
-          labelColor: "#ffffff"
-          labelAlign: center
-          transform:
-            position: [0, 60]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: center
-        children: []
-      - id: logo-sprite
-        type: Sprite2D
-        name: Logo Sprite
-        properties:
-          texture: { type: 'texture', url: 'res://sprites/pix3-logo.png' }
-          width: 242
-          height: 96
-          transform:
-            position: [0, -80]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: center
-        children: []
+# Pix3 Scene File (YAML)
+# Empty 2D starter: a Full HD canvas with a background, a centered label and the
+# project logo. All content lives on the 2D layer.
+version: 1.0.0
+metadata:
+  author: Pix3 Template
+  description: Empty 2D starter scene
+root:
+  - id: game-root
+    type: Group2D
+    name: Game Root
+    properties:
+      width: 1920
+      height: 1080
+      layout:
+        enabled: true
+        horizontalAlign: stretch
+        verticalAlign: stretch
+    children:
+      - id: background
+        type: ColorRect2D
+        name: Background
+        properties:
+          width: 1920
+          height: 1080
+          color: "#1a1a2e"
+          transform:
+            position: [0, 0]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: stretch
+            verticalAlign: stretch
+        children: []
+      - id: title-label
+        type: Label2D
+        name: Title Label
+        properties:
+          label: "{{PROJECT_NAME}}"
+          labelFontSize: 72
+          labelColor: "#ffffff"
+          labelAlign: center
+          transform:
+            position: [0, 60]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: center
+        children: []
+      - id: logo-sprite
+        type: Sprite2D
+        name: Logo Sprite
+        properties:
+          texture: { type: 'texture', url: 'res://sprites/pix3-logo.png' }
+          width: 242
+          height: 96
+          transform:
+            position: [0, -80]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: center
+        children: []

package/templates/empty-2d/template.yaml

@@ -1,7 +1,7 @@
-id: empty-2d
-title: Empty 2D
-description: Minimal 2D starter — background, centered label and logo on a Full HD canvas.
-projectType: 2d
-targetPlatform: universal
-viewport: { width: 1920, height: 1080 }
-order: 20
+id: empty-2d
+title: Empty 2D
+description: Minimal 2D starter — background, centered label and logo on a Full HD canvas.
+projectType: 2d
+targetPlatform: universal
+viewport: { width: 1920, height: 1080 }
+order: 20

package/templates/empty-3d/files/README.md

@@ -1,20 +1,20 @@
-# {{PROJECT_NAME}}
-
-A Pix3 project created from the **Empty 3D** template.
-
-## Project structure
-
-- `design/` — game design document and reference images
-- `scenes/` — scene files (`.pix3scene`, YAML)
-- `sprites/` — images and textures
-- `scripts/` — game scripts (`export class X extends Script`, used as `user:X`)
-- `audio/` — music and sound effects
-- `AGENTS.md` — rules and pointers for AI agents working on this project
-
-New asset-type folders (`models/` for GLB/GLTF, fonts, …) are created as you add those assets.
-
-## Getting started
-
-1. Open the project folder in the Pix3 editor.
-2. `scenes/main.pix3scene` is the startup scene — press Play to run it.
-3. Drop your GDD and reference art into `design/`, then ask an AI agent to build the game.
+# {{PROJECT_NAME}}
+
+A Pix3 project created from the **Empty 3D** template.
+
+## Project structure
+
+- `design/` — game design document and reference images
+- `scenes/` — scene files (`.pix3scene`, YAML)
+- `sprites/` — images and textures
+- `scripts/` — game scripts (`export class X extends Script`, used as `user:X`)
+- `audio/` — music and sound effects
+- `AGENTS.md` — rules and pointers for AI agents working on this project
+
+New asset-type folders (`models/` for GLB/GLTF, fonts, …) are created as you add those assets.
+
+## Getting started
+
+1. Open the project folder in the Pix3 editor.
+2. `scenes/main.pix3scene` is the startup scene — press Play to run it.
+3. Drop your GDD and reference art into `design/`, then ask an AI agent to build the game.

package/templates/empty-3d/files/scenes/main.pix3scene

@@ -1,108 +1,108 @@
-# Pix3 Scene File (YAML)
-# Empty 3D starter: environment root with a box mesh, key light, ambient fill,
-# a perspective camera, and a 2D UI layer with the project logo.
-version: 1.0.0
-metadata:
-  author: Pix3 Template
-  description: Empty 3D starter scene
-root:
-  - id: game-root
-    type: Node3D
-    name: Game Root
-    properties:
-      transform:
-        position: [0, 0, 0]
-        rotationEuler: [0, 0, 0]
-        scale: [1, 1, 1]
-    children:
-      - id: main-camera
-        type: Camera3D
-        name: Main Camera
-        properties:
-          projection: perspective
-          fov: 60
-          near: 0.1
-          far: 1000
-          transform:
-            position: [0, 2, 6]
-            rotationEuler: [-10, 0, 0]
-            scale: [1, 1, 1]
-        children: []
-      - id: key-light
-        type: DirectionalLightNode
-        name: Key Light
-        properties:
-          intensity: 1.2
-          color: "#ffffff"
-          transform:
-            position: [5, 8, 3]
-            rotationEuler: [-45, 35, 0]
-            scale: [1, 1, 1]
-        children: []
-      - id: ambient-light
-        type: AmbientLightNode
-        name: Ambient Light
-        properties:
-          intensity: 0.5
-          color: "#ffffff"
-          transform:
-            position: [0, 0, 0]
-            rotationEuler: [0, 0, 0]
-            scale: [1, 1, 1]
-        children: []
-      - id: ground
-        type: GeometryMesh
-        name: Ground
-        properties:
-          geometry: box
-          size: [12, 0.2, 12]
-          material:
-            type: standard
-            color: "#2a2a3e"
-          transform:
-            position: [0, -0.1, 0]
-            rotationEuler: [0, 0, 0]
-            scale: [1, 1, 1]
-        children: []
-      - id: demo-box
-        type: GeometryMesh
-        name: Demo Box
-        properties:
-          geometry: box
-          size: [1, 1, 1]
-          material:
-            type: standard
-            color: "#ffcf33"
-          transform:
-            position: [0, 0.5, 0]
-            rotationEuler: [0, 45, 0]
-            scale: [1, 1, 1]
-        children: []
-
-  - id: hud-root
-    type: Group2D
-    name: HUD Root
-    properties:
-      width: 1920
-      height: 1080
-      layout:
-        enabled: true
-        horizontalAlign: stretch
-        verticalAlign: stretch
-    children:
-      - id: logo-sprite
-        type: Sprite2D
-        name: Logo Sprite
-        properties:
-          texture: { type: 'texture', url: 'res://sprites/pix3-logo.png' }
-          width: 121
-          height: 48
-          transform:
-            position: [0, -460]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: bottom
-        children: []
+# Pix3 Scene File (YAML)
+# Empty 3D starter: environment root with a box mesh, key light, ambient fill,
+# a perspective camera, and a 2D UI layer with the project logo.
+version: 1.0.0
+metadata:
+  author: Pix3 Template
+  description: Empty 3D starter scene
+root:
+  - id: game-root
+    type: Node3D
+    name: Game Root
+    properties:
+      transform:
+        position: [0, 0, 0]
+        rotationEuler: [0, 0, 0]
+        scale: [1, 1, 1]
+    children:
+      - id: main-camera
+        type: Camera3D
+        name: Main Camera
+        properties:
+          projection: perspective
+          fov: 60
+          near: 0.1
+          far: 1000
+          transform:
+            position: [0, 2, 6]
+            rotationEuler: [-10, 0, 0]
+            scale: [1, 1, 1]
+        children: []
+      - id: key-light
+        type: DirectionalLightNode
+        name: Key Light
+        properties:
+          intensity: 1.2
+          color: "#ffffff"
+          transform:
+            position: [5, 8, 3]
+            rotationEuler: [-45, 35, 0]
+            scale: [1, 1, 1]
+        children: []
+      - id: ambient-light
+        type: AmbientLightNode
+        name: Ambient Light
+        properties:
+          intensity: 0.5
+          color: "#ffffff"
+          transform:
+            position: [0, 0, 0]
+            rotationEuler: [0, 0, 0]
+            scale: [1, 1, 1]
+        children: []
+      - id: ground
+        type: GeometryMesh
+        name: Ground
+        properties:
+          geometry: box
+          size: [12, 0.2, 12]
+          material:
+            type: standard
+            color: "#2a2a3e"
+          transform:
+            position: [0, -0.1, 0]
+            rotationEuler: [0, 0, 0]
+            scale: [1, 1, 1]
+        children: []
+      - id: demo-box
+        type: GeometryMesh
+        name: Demo Box
+        properties:
+          geometry: box
+          size: [1, 1, 1]
+          material:
+            type: standard
+            color: "#ffcf33"
+          transform:
+            position: [0, 0.5, 0]
+            rotationEuler: [0, 45, 0]
+            scale: [1, 1, 1]
+        children: []
+
+  - id: hud-root
+    type: Group2D
+    name: HUD Root
+    properties:
+      width: 1920
+      height: 1080
+      layout:
+        enabled: true
+        horizontalAlign: stretch
+        verticalAlign: stretch
+    children:
+      - id: logo-sprite
+        type: Sprite2D
+        name: Logo Sprite
+        properties:
+          texture: { type: 'texture', url: 'res://sprites/pix3-logo.png' }
+          width: 121
+          height: 48
+          transform:
+            position: [0, -460]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: bottom
+        children: []

package/templates/empty-3d/template.yaml

@@ -1,7 +1,7 @@
-id: empty-3d
-title: Empty 3D
-description: Minimal 3D starter — camera, lighting, ground and a demo box, plus a 2D UI layer.
-projectType: 3d
-targetPlatform: universal
-viewport: { width: 1920, height: 1080 }
-order: 10
+id: empty-3d
+title: Empty 3D
+description: Minimal 3D starter — camera, lighting, ground and a demo box, plus a 2D UI layer.
+projectType: 3d
+targetPlatform: universal
+viewport: { width: 1920, height: 1080 }
+order: 10

package/templates/idea-blank/files/README.md

@@ -1,22 +1,22 @@
-# {{PROJECT_NAME}}
-
-A Pix3 project that is still at the **idea stage**: a design document and its references, and no
-game yet. The genre skeleton — scenes, scripts, a playable loop — is expanded into this same project
-when you press **Start prototype**, so nothing here is thrown away.
-
-## Project structure
-
-- `design/gdd.md` — the design document. This is the idea; everything agreed on lands here.
-- `design/decisions.md` — settled forks, one line each, so nothing is decided twice.
-- `design/source/` — documents you attached, kept verbatim for reading by section.
-- `references/` — reference and moodboard images, with roles in `references/index.json`.
-- `scenes/main.pix3scene` — an empty Full HD canvas, a placeholder until the recipe arrives.
-- `AGENTS.md` — rules and pointers for AI agents working on this project.
-
-Sprite, script and audio folders appear when the prototype needs them.
-
-## Getting started
-
-1. Talk the idea through in the chat next to the document — the document is the record.
-2. Ask for moodboards when you reach the look; the candidates land in `references/`.
-3. Press **Start prototype** when the idea is worth building.
+# {{PROJECT_NAME}}
+
+A Pix3 project that is still at the **idea stage**: a design document and its references, and no
+game yet. The genre skeleton — scenes, scripts, a playable loop — is expanded into this same project
+when you press **Start prototype**, so nothing here is thrown away.
+
+## Project structure
+
+- `design/gdd.md` — the design document. This is the idea; everything agreed on lands here.
+- `design/decisions.md` — settled forks, one line each, so nothing is decided twice.
+- `design/source/` — documents you attached, kept verbatim for reading by section.
+- `references/` — reference and moodboard images, with roles in `references/index.json`.
+- `scenes/main.pix3scene` — an empty Full HD canvas, a placeholder until the recipe arrives.
+- `AGENTS.md` — rules and pointers for AI agents working on this project.
+
+Sprite, script and audio folders appear when the prototype needs them.
+
+## Getting started
+
+1. Talk the idea through in the chat next to the document — the document is the record.
+2. Ask for moodboards when you reach the look; the candidates land in `references/`.
+3. Press **Start prototype** when the idea is worth building.