@mpgd/cli 0.4.1 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -52,15 +52,15 @@
     "@mpgd/adapter-ait": "0.3.3",
     "@mpgd/adapter-browser": "0.3.2",
     "@mpgd/adapter-capacitor": "0.3.3",
-    "@mpgd/analytics": "0.3.2",
     "@mpgd/adapter-devvit": "0.3.3",
+    "@mpgd/analytics": "0.3.2",
     "@mpgd/bridge": "0.4.0",
     "@mpgd/catalog": "0.3.2",
+    "@mpgd/game-services": "0.3.3",
     "@mpgd/phaser-assets": "0.4.0",
-    "@mpgd/platform": "0.3.2",
-    "@mpgd/target-config": "0.3.4",
-    "@mpgd/i18n": "0.3.3",
-    "@mpgd/game-services": "0.3.3"
+    "@mpgd/i18n": "0.4.0",
+    "@mpgd/target-config": "0.4.0",
+    "@mpgd/platform": "0.3.2"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/templates/phaser-game/README.md

@@ -84,6 +84,9 @@ const viewport = resolveTargetViewportPlan({
   height: measured.height,
   source: measured.source,
   runtime: runtime.config.runtime,
+  orientationPolicy: {
+    mode: 'prefer-landscape',
+  },
 });
 ```
 
@@ -104,6 +107,15 @@ Orientation is measured from the container: height greater than width is
 be treated as an embedded webview, so do not assume desktop Reddit always means
 an expanded game surface.
 
+Orientation policy is a runtime contract, not a guarantee that every shell can
+hard-lock the device. Use `responsive` when both orientations are playable,
+`prefer-landscape` or `prefer-portrait` when layout guidance should favor one
+orientation, and `lock-landscape` or `lock-portrait` when the game should show a
+soft rotate prompt on mismatch. The generated PWA manifest also declares
+`"orientation": "landscape"` for installed web and Microsoft Store shells; keep
+that manifest value aligned with the runtime policy if you make a portrait-first
+game.
+
 ## Reddit Devvit
 
 This starter owns its Devvit app root in `apps/target-devvit`. That directory

package/templates/phaser-game/agent/acceptance.md

@@ -21,3 +21,6 @@ after login before upload or playtest.
 For Microsoft Store changes, keep the first pass as a PWA/web target that uses
 the browser adapter. Add a dedicated Store commerce adapter only when wiring
 Digital Goods API and Payment Request through backend ledger verification.
+
+Verify the first screen reports the viewport orientation policy, and treat
+locked orientation modes as soft prompts instead of unsafe WebView hard locks.

package/templates/phaser-game/agent/brief.md

@@ -9,6 +9,8 @@ Boundaries:
 - Purchases, rewarded ad grants, and leaderboard records should go through
   backend ledger APIs before mutating durable game save state.
 - Platform SDK imports belong in adapters or target wrappers.
+- Orientation policy should be chosen before adding resize behavior; treat
+  locked modes as soft prompts unless a platform adapter supports hard locks.
 
 Useful commands:
 

package/templates/phaser-game/agent/game-manifest.json

@@ -25,6 +25,10 @@
       "id": "runtime.platform.gateway",
       "owner": "src/platform/installPlatform.ts"
     },
+    {
+      "id": "runtime.viewport.orientation-policy",
+      "owner": "src/main.ts"
+    },
     {
       "id": "platform.devvit.app-root",
       "owner": "apps/target-devvit"

package/templates/phaser-game/src/i18n/messages.ts

@@ -4,6 +4,8 @@ export type GameMessageKey =
   | 'title'
   | 'target'
   | 'viewport'
+  | 'orientationPolicy'
+  | 'orientationMismatch'
   | 'backend'
   | 'features'
   | 'featuresNone'
@@ -21,6 +23,8 @@ const messages = {
     title: '__GAME_TITLE__',
     target: 'Target: {target}',
     viewport: 'Viewport: {sizeClass} {orientation} - controls {controls}',
+    orientationPolicy: 'Orientation policy: {mode}',
+    orientationMismatch: 'Rotate to {orientation} for {mode}',
     backend: 'Game Services: {mode}',
     features: 'Features: {features}',
     featuresNone: 'none',
@@ -37,6 +41,8 @@ const messages = {
     title: '__GAME_TITLE__',
     target: '타깃: {target}',
     viewport: '뷰포트: {sizeClass} {orientation} - 컨트롤 {controls}',
+    orientationPolicy: '방향 정책: {mode}',
+    orientationMismatch: '{mode}: {orientation} 방향으로 회전',
     backend: 'Game Services: {mode}',
     features: '기능: {features}',
     featuresNone: '없음',

package/templates/phaser-game/src/main.ts

@@ -2,7 +2,10 @@ import './styles.css';
 
 import { createAnalyticsReporter, createBufferedAnalyticsSink } from '@mpgd/analytics';
 import { resolveMpgdLocale, type Locale } from '@mpgd/i18n';
-import { resolveTargetViewportPlan } from '@mpgd/target-config';
+import {
+  resolveTargetViewportPlan,
+  type TargetViewportOrientationPolicy,
+} from '@mpgd/target-config';
 
 import { t } from './i18n/messages';
 import { createClientId } from './runtime/id';
@@ -25,9 +28,13 @@ async function bootstrap(): Promise<void> {
     const runtimeConfig = detectRuntime();
     const platform = await installPlatform(runtimeConfig);
     const runtime = await platform.getTargetRuntime();
+    const orientationPolicy = {
+      mode: 'prefer-landscape',
+    } as const satisfies TargetViewportOrientationPolicy;
     const viewport = resolveTargetViewportPlan({
       ...measureGameViewport(),
       runtime: runtime.config.runtime,
+      orientationPolicy,
     });
     const player =
       (await platform.identity.getPlayer()) ?? {

package/templates/phaser-game/src/scenes/LobbyScene.ts

@@ -21,6 +21,16 @@ export class LobbyScene extends Phaser.Scene {
       .filter((feature) => feature.enabled)
       .map((feature) => feature.feature)
       .join(', ') || t(locale, 'featuresNone');
+    const orientation = context.viewport.orientation;
+    const orientationText =
+      orientation.shouldShowRotatePrompt && orientation.preferredOrientation !== undefined
+        ? t(locale, 'orientationMismatch', {
+            mode: orientation.mode,
+            orientation: orientation.preferredOrientation,
+          })
+        : t(locale, 'orientationPolicy', {
+            mode: orientation.mode,
+          });
 
     this.add
       .text(480, 106, t(locale, 'title'), {
@@ -61,14 +71,21 @@ export class LobbyScene extends Phaser.Scene {
       )
       .setOrigin(0.5);
     this.add
-      .text(480, 300, t(locale, 'backend', { mode: context.gameServices.mode }), {
+      .text(480, 300, orientationText, {
+        color: orientation.shouldShowRotatePrompt ? '#f59e0b' : '#d6dee8',
+        fontFamily: 'Arial, sans-serif',
+        fontSize: '18px',
+      })
+      .setOrigin(0.5);
+    this.add
+      .text(480, 342, t(locale, 'backend', { mode: context.gameServices.mode }), {
         color: context.gameServices.mode === 'disabled' ? '#f59e0b' : '#2dd4bf',
         fontFamily: 'Arial, sans-serif',
         fontSize: '18px',
       })
       .setOrigin(0.5);
     this.add
-      .text(480, 342, t(locale, 'tapToStart'), {
+      .text(480, 384, t(locale, 'tapToStart'), {
         color: '#ffffff',
         fontFamily: 'Arial, sans-serif',
         fontSize: '22px',