@pix3/cli 1.6.0 → 1.6.2

package/templates/playable-2d/files/design/tests/reachability.json

@@ -1,4 +1,4 @@
-{
-  "version": 1,
-  "proven": []
-}
+{
+  "version": 1,
+  "proven": []
+}

package/templates/playable-2d/files/design/tests/routines/intro-to-cta.json

@@ -1,32 +1,32 @@
-{
-  "name": "intro-to-cta",
-  "description": "Tap through the intro gate, end the run by intent, and press the CTA on the end screen.",
-  "note": "Run it with game_run {routine:'intro-to-cta'}. Steps are the game_input vocabulary (tap/key/keys/drag/hover/wait/invoke) plus {type:'command', name} for an intent the scene registered; `expect` holds the ordinary game_run predicates, ANDed and judged once after the last step. A step's `why` and this `note` are documentation — the runner ignores both — but they are why the routine also reads as a checklist. Note what is NOT here: no step calls a component method directly. Ending the run goes through the `finish` command, because a routine that called the handler would prove the handler works while skipping every wire between the player and it.",
-  "scope": "scenes/main.pix3scene",
-  "params": {},
-  "uses": ["game-root", "intro-overlay", "end-screen", "cta-button"],
-  "steps": [
-    {
-      "type": "tap",
-      "target": "intro-overlay",
-      "why": "The tap gate is the gesture under test: it hides the overlay and unlocks browser audio, so it is driven as a real tap rather than by dispatching start-game."
-    },
-    {
-      "type": "command",
-      "name": "finish",
-      "why": "Reveal the end screen by intent instead of waiting out autoWinAfterSec — the timer is a placeholder every real playable replaces, and 15 s of wall clock in every run is a budget nobody gets back."
-    },
-    {
-      "type": "tap",
-      "target": "cta-button",
-      "holdMs": 700,
-      "why": "Button2D needs a real press; this proves the button is on screen and hittable, not just present in the tree."
-    }
-  ],
-  "expect": [
-    { "kind": "gameState", "path": "phase", "op": "eq", "value": "ended" },
-    { "kind": "gameState", "path": "introVisible", "op": "eq", "value": false },
-    { "kind": "gameState", "path": "endVisible", "op": "eq", "value": true },
-    { "kind": "gameState", "path": "gameEnded", "op": "eq", "value": true }
-  ]
-}
+{
+  "name": "intro-to-cta",
+  "description": "Tap through the intro gate, end the run by intent, and press the CTA on the end screen.",
+  "note": "Run it with game_run {routine:'intro-to-cta'}. Steps are the game_input vocabulary (tap/key/keys/drag/hover/wait/invoke) plus {type:'command', name} for an intent the scene registered; `expect` holds the ordinary game_run predicates, ANDed and judged once after the last step. A step's `why` and this `note` are documentation — the runner ignores both — but they are why the routine also reads as a checklist. Note what is NOT here: no step calls a component method directly. Ending the run goes through the `finish` command, because a routine that called the handler would prove the handler works while skipping every wire between the player and it.",
+  "scope": "scenes/main.pix3scene",
+  "params": {},
+  "uses": ["game-root", "intro-overlay", "end-screen", "cta-button"],
+  "steps": [
+    {
+      "type": "tap",
+      "target": "intro-overlay",
+      "why": "The tap gate is the gesture under test: it hides the overlay and unlocks browser audio, so it is driven as a real tap rather than by dispatching start-game."
+    },
+    {
+      "type": "command",
+      "name": "finish",
+      "why": "Reveal the end screen by intent instead of waiting out autoWinAfterSec — the timer is a placeholder every real playable replaces, and 15 s of wall clock in every run is a budget nobody gets back."
+    },
+    {
+      "type": "tap",
+      "target": "cta-button",
+      "holdMs": 700,
+      "why": "Button2D needs a real press; this proves the button is on screen and hittable, not just present in the tree."
+    }
+  ],
+  "expect": [
+    { "kind": "gameState", "path": "phase", "op": "eq", "value": "ended" },
+    { "kind": "gameState", "path": "introVisible", "op": "eq", "value": false },
+    { "kind": "gameState", "path": "endVisible", "op": "eq", "value": true },
+    { "kind": "gameState", "path": "gameEnded", "op": "eq", "value": true }
+  ]
+}

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

@@ -1,111 +1,111 @@
-# Pix3 Scene File (YAML)
-# Playable 2D blank (portrait 1080x1920): 2D gameplay placeholder plus a
-# tap-to-start intro overlay and an end screen with a CTA button.
-#
-# Full-screen UI lives in its own file under scenes/ui/ and is instanced here
-# hidden (`visible: false` = editor only; `initiallyVisible` in the overlay file
-# is what play mode reads), so opening this scene shows the game rather than a
-# dim or a CTA card:
-#   intro-overlay (intro-dim, intro-label)       scenes/ui/intro.pix3scene
-#   end-screen (end-dim, end-label, cta-button)  scenes/ui/end-screen.pix3scene
-# Instance children keep their ids, so `GameFlow`'s introNode/endNode and every
-# `findNode` still resolve. Node order in the tree is paint order.
-version: 1.0.0
-metadata:
-  author: Pix3 Template
-  description: Playable 2D blank with intro overlay and CTA end screen
-root:
-  - id: game-root
-    type: Group2D
-    name: Game Root
-    properties:
-      width: 1080
-      height: 1920
-      layout:
-        enabled: true
-        horizontalAlign: stretch
-        verticalAlign: stretch
-    components:
-      - id: game-flow
-        type: user:GameFlow
-        enabled: true
-        config:
-          introNode: intro-overlay
-          endNode: end-screen
-          autoWinAfterSec: 15
-    children:
-      - id: background
-        type: ColorRect2D
-        name: Background
-        properties:
-          width: 1080
-          height: 1920
-          color: "#16213e"
-          transform:
-            position: [0, 0]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: stretch
-            verticalAlign: stretch
-        children: []
-      - id: hero-sprite
-        type: Sprite2D
-        name: Hero Sprite
-        properties:
-          texture: { type: 'texture', url: 'res://sprites/pix3-logo.png' }
-          width: 242
-          height: 96
-          transform:
-            position: [0, 0]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: center
-        components:
-          - id: hero-bob
-            type: core:Sine
-            enabled: true
-            config:
-              amplitude: 40
-              frequency: 0.6
-              axis: y
-        children: []
-      - id: hud-label
-        type: Label2D
-        name: HUD Label
-        properties:
-          label: "PROTOTYPE"
-          labelFontSize: 40
-          labelColor: "#ffffff"
-          labelAlign: center
-          transform:
-            position: [0, 860]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: top
-        children: []
-      # Tap gate — authored in scenes/ui/intro.pix3scene so this scene opens on
-      # the GAME. `visible: false` hides it in the EDITOR only; `initiallyVisible`
-      # (in the overlay file) is what play mode reads. Tick the eye to preview it
-      # composited over the game.
-      - id: intro-overlay
-        name: Intro Overlay
-        instance: res://scenes/ui/intro.pix3scene
-        properties:
-          visible: false
-      # End screen — authored in scenes/ui/end-screen.pix3scene so this scene opens
-      # on the GAME. `visible: false` hides it in the EDITOR only; `initiallyVisible`
-      # (in the overlay file) is what play mode reads. Tick the eye to preview it
-      # composited over the game.
-      - id: end-screen
-        name: End Screen
-        instance: res://scenes/ui/end-screen.pix3scene
-        properties:
-          visible: false
+# Pix3 Scene File (YAML)
+# Playable 2D blank (portrait 1080x1920): 2D gameplay placeholder plus a
+# tap-to-start intro overlay and an end screen with a CTA button.
+#
+# Full-screen UI lives in its own file under scenes/ui/ and is instanced here
+# hidden (`visible: false` = editor only; `initiallyVisible` in the overlay file
+# is what play mode reads), so opening this scene shows the game rather than a
+# dim or a CTA card:
+#   intro-overlay (intro-dim, intro-label)       scenes/ui/intro.pix3scene
+#   end-screen (end-dim, end-label, cta-button)  scenes/ui/end-screen.pix3scene
+# Instance children keep their ids, so `GameFlow`'s introNode/endNode and every
+# `findNode` still resolve. Node order in the tree is paint order.
+version: 1.0.0
+metadata:
+  author: Pix3 Template
+  description: Playable 2D blank with intro overlay and CTA end screen
+root:
+  - id: game-root
+    type: Group2D
+    name: Game Root
+    properties:
+      width: 1080
+      height: 1920
+      layout:
+        enabled: true
+        horizontalAlign: stretch
+        verticalAlign: stretch
+    components:
+      - id: game-flow
+        type: user:GameFlow
+        enabled: true
+        config:
+          introNode: intro-overlay
+          endNode: end-screen
+          autoWinAfterSec: 15
+    children:
+      - id: background
+        type: ColorRect2D
+        name: Background
+        properties:
+          width: 1080
+          height: 1920
+          color: "#16213e"
+          transform:
+            position: [0, 0]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: stretch
+            verticalAlign: stretch
+        children: []
+      - id: hero-sprite
+        type: Sprite2D
+        name: Hero Sprite
+        properties:
+          texture: { type: 'texture', url: 'res://sprites/pix3-logo.png' }
+          width: 242
+          height: 96
+          transform:
+            position: [0, 0]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: center
+        components:
+          - id: hero-bob
+            type: core:Sine
+            enabled: true
+            config:
+              amplitude: 40
+              frequency: 0.6
+              axis: y
+        children: []
+      - id: hud-label
+        type: Label2D
+        name: HUD Label
+        properties:
+          label: "PROTOTYPE"
+          labelFontSize: 40
+          labelColor: "#ffffff"
+          labelAlign: center
+          transform:
+            position: [0, 860]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: top
+        children: []
+      # Tap gate — authored in scenes/ui/intro.pix3scene so this scene opens on
+      # the GAME. `visible: false` hides it in the EDITOR only; `initiallyVisible`
+      # (in the overlay file) is what play mode reads. Tick the eye to preview it
+      # composited over the game.
+      - id: intro-overlay
+        name: Intro Overlay
+        instance: res://scenes/ui/intro.pix3scene
+        properties:
+          visible: false
+      # End screen — authored in scenes/ui/end-screen.pix3scene so this scene opens
+      # on the GAME. `visible: false` hides it in the EDITOR only; `initiallyVisible`
+      # (in the overlay file) is what play mode reads. Tick the eye to preview it
+      # composited over the game.
+      - id: end-screen
+        name: End Screen
+        instance: res://scenes/ui/end-screen.pix3scene
+        properties:
+          visible: false

package/templates/playable-2d/files/scenes/ui/end-screen.pix3scene

@@ -1,91 +1,91 @@
-# Pix3 Scene File (YAML)
-# Playable 2D — the END screen (result + CTA), in its own file so the game
-# scene opens clean. `main.pix3scene` carries it as a one-line `instance:`
-# reference marked `visible: false`, which hides it in the EDITOR only;
-# `initiallyVisible: false` below is what play mode reads, and `user:GameFlow`
-# reveals it on `finish()`.
-#
-# Edit it here, full-screen, in its own tab. To preview it composited over the
-# game, tick the eye on `end-screen` in main.pix3scene — just do not commit
-# that tick, or every iteration starts behind a CTA card again.
-#
-# Stable node ids (design/recipe.md is the contract — do not rename these):
-#   end-screen, end-dim, end-label, cta-button
-version: 1.0.0
-metadata:
-  author: Pix3 Template
-  description: End screen — dim, result headline and a PLAY NOW CTA button
-root:
-  - id: end-screen
-    type: Group2D
-    name: End Screen
-    properties:
-      width: 1080
-      height: 1920
-      initiallyVisible: false
-      layout:
-        enabled: true
-        horizontalAlign: stretch
-        verticalAlign: stretch
-    children:
-      - id: end-dim
-        type: ColorRect2D
-        name: End Dim
-        properties:
-          width: 1080
-          height: 1920
-          color: "#000000"
-          opacity: 0.75
-          transform:
-            position: [0, 0]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: stretch
-            verticalAlign: stretch
-        children: []
-      - id: end-label
-        type: Label2D
-        name: End Label
-        properties:
-          label: "GREAT RUN!"
-          labelFontSize: 84
-          labelColor: "#ffcf33"
-          labelAlign: center
-          transform:
-            position: [0, 220]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: center
-        children: []
-      - id: cta-button
-        type: Button2D
-        name: CTA Button
-        properties:
-          width: 480
-          height: 140
-          label: "PLAY NOW"
-          labelFontSize: 56
-          labelColor: "#1a1a2e"
-          backgroundColor: "#ffcf33"
-          hoverColor: "#ffe066"
-          pressedColor: "#e6b800"
-          buttonAction: cta
-          transform:
-            position: [0, -120]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: center
-        components:
-          - id: cta-action
-            type: user:CtaButton
-            enabled: true
-            config: {}
-        children: []
+# Pix3 Scene File (YAML)
+# Playable 2D — the END screen (result + CTA), in its own file so the game
+# scene opens clean. `main.pix3scene` carries it as a one-line `instance:`
+# reference marked `visible: false`, which hides it in the EDITOR only;
+# `initiallyVisible: false` below is what play mode reads, and `user:GameFlow`
+# reveals it on `finish()`.
+#
+# Edit it here, full-screen, in its own tab. To preview it composited over the
+# game, tick the eye on `end-screen` in main.pix3scene — just do not commit
+# that tick, or every iteration starts behind a CTA card again.
+#
+# Stable node ids (design/recipe.md is the contract — do not rename these):
+#   end-screen, end-dim, end-label, cta-button
+version: 1.0.0
+metadata:
+  author: Pix3 Template
+  description: End screen — dim, result headline and a PLAY NOW CTA button
+root:
+  - id: end-screen
+    type: Group2D
+    name: End Screen
+    properties:
+      width: 1080
+      height: 1920
+      initiallyVisible: false
+      layout:
+        enabled: true
+        horizontalAlign: stretch
+        verticalAlign: stretch
+    children:
+      - id: end-dim
+        type: ColorRect2D
+        name: End Dim
+        properties:
+          width: 1080
+          height: 1920
+          color: "#000000"
+          opacity: 0.75
+          transform:
+            position: [0, 0]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: stretch
+            verticalAlign: stretch
+        children: []
+      - id: end-label
+        type: Label2D
+        name: End Label
+        properties:
+          label: "GREAT RUN!"
+          labelFontSize: 84
+          labelColor: "#ffcf33"
+          labelAlign: center
+          transform:
+            position: [0, 220]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: center
+        children: []
+      - id: cta-button
+        type: Button2D
+        name: CTA Button
+        properties:
+          width: 480
+          height: 140
+          label: "PLAY NOW"
+          labelFontSize: 56
+          labelColor: "#1a1a2e"
+          backgroundColor: "#ffcf33"
+          hoverColor: "#ffe066"
+          pressedColor: "#e6b800"
+          buttonAction: cta
+          transform:
+            position: [0, -120]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: center
+        components:
+          - id: cta-action
+            type: user:CtaButton
+            enabled: true
+            config: {}
+        children: []

package/templates/playable-2d/files/scenes/ui/intro.pix3scene

@@ -1,65 +1,65 @@
-# Pix3 Scene File (YAML)
-# Playable 2D — the tap-to-start INTRO overlay, in its own file so the
-# game scene opens clean. `main.pix3scene` carries it as a one-line `instance:`
-# reference marked `visible: false`, which hides it in the EDITOR only.
-# `initiallyVisible: true` below is what play mode reads, so the gate is UP at
-# t=0 — in an ad container that first tap is what unlocks browser audio.
-# `user:GameFlow` hides it on the first tap.
-#
-# Edit it here, full-screen, in its own tab. To preview it composited over the
-# game, tick the eye on `intro-overlay` in main.pix3scene — just do not commit
-# that tick, or every iteration starts behind the dim again.
-#
-# Stable node ids (design/recipe.md is the contract — do not rename these):
-#   intro-overlay, intro-dim, intro-label
-version: 1.0.0
-metadata:
-  author: Pix3 Template
-  description: Intro overlay — dim plus a TAP TO START label
-root:
-  - id: intro-overlay
-    type: Group2D
-    name: Intro Overlay
-    properties:
-      width: 1080
-      height: 1920
-      initiallyVisible: true
-      layout:
-        enabled: true
-        horizontalAlign: stretch
-        verticalAlign: stretch
-    children:
-      - id: intro-dim
-        type: ColorRect2D
-        name: Intro Dim
-        properties:
-          width: 1080
-          height: 1920
-          color: "#000000"
-          opacity: 0.65
-          transform:
-            position: [0, 0]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: stretch
-            verticalAlign: stretch
-        children: []
-      - id: intro-label
-        type: Label2D
-        name: Tap To Start
-        properties:
-          label: "TAP TO START"
-          labelFontSize: 72
-          labelColor: "#ffffff"
-          labelAlign: center
-          transform:
-            position: [0, 0]
-            scale: [1, 1]
-            rotation: 0
-          layout:
-            enabled: true
-            horizontalAlign: center
-            verticalAlign: center
-        children: []
+# Pix3 Scene File (YAML)
+# Playable 2D — the tap-to-start INTRO overlay, in its own file so the
+# game scene opens clean. `main.pix3scene` carries it as a one-line `instance:`
+# reference marked `visible: false`, which hides it in the EDITOR only.
+# `initiallyVisible: true` below is what play mode reads, so the gate is UP at
+# t=0 — in an ad container that first tap is what unlocks browser audio.
+# `user:GameFlow` hides it on the first tap.
+#
+# Edit it here, full-screen, in its own tab. To preview it composited over the
+# game, tick the eye on `intro-overlay` in main.pix3scene — just do not commit
+# that tick, or every iteration starts behind the dim again.
+#
+# Stable node ids (design/recipe.md is the contract — do not rename these):
+#   intro-overlay, intro-dim, intro-label
+version: 1.0.0
+metadata:
+  author: Pix3 Template
+  description: Intro overlay — dim plus a TAP TO START label
+root:
+  - id: intro-overlay
+    type: Group2D
+    name: Intro Overlay
+    properties:
+      width: 1080
+      height: 1920
+      initiallyVisible: true
+      layout:
+        enabled: true
+        horizontalAlign: stretch
+        verticalAlign: stretch
+    children:
+      - id: intro-dim
+        type: ColorRect2D
+        name: Intro Dim
+        properties:
+          width: 1080
+          height: 1920
+          color: "#000000"
+          opacity: 0.65
+          transform:
+            position: [0, 0]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: stretch
+            verticalAlign: stretch
+        children: []
+      - id: intro-label
+        type: Label2D
+        name: Tap To Start
+        properties:
+          label: "TAP TO START"
+          labelFontSize: 72
+          labelColor: "#ffffff"
+          labelAlign: center
+          transform:
+            position: [0, 0]
+            scale: [1, 1]
+            rotation: 0
+          layout:
+            enabled: true
+            horizontalAlign: center
+            verticalAlign: center
+        children: []