@mpgd/cli 0.3.2 → 0.4.1

package/templates/phaser-game/package.json

@@ -6,7 +6,24 @@
   "type": "module",
   "scripts": {
     "dev": "__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0",
+    "dev:ait": "APP_TARGET=ait APP_VERSION=0.0.0-dev BUILD_ID=ait-sandbox sh -c '__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0'",
     "build": "__WORKSPACE_I18N_BUILD_PREFIX__vite build",
+    "build:ait": "pnpm exec mpgd target build ait production --variant wrapper --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "build:ait:package": "pnpm exec mpgd target build ait production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "smoke:ait": "pnpm exec mpgd target smoke ait --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "ait:wrapper:dev": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev",
+    "ait:wrapper:dev:plain": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev:plain",
+    "ait:wrapper:dev:phone": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev:phone",
+    "ait:devtools:mcp": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run devtools:mcp",
+    "ait:devtools:mcp:mobile": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run devtools:mcp:mobile",
+    "ait:console:login": "aitcc login",
+    "ait:console:whoami": "aitcc whoami",
+    "ait:console:init": "aitcc app init",
+    "ait:console:register": "aitcc app register",
+    "ait:console:status": "aitcc app status",
+    "ait:console:deploy": "aitcc app deploy",
+    "build:microsoft-store": "pnpm exec mpgd target build microsoft-store production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "smoke:microsoft-store": "pnpm exec mpgd target smoke microsoft-store --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "build:devvit": "pnpm exec mpgd target build reddit production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "build:devvit:staging": "pnpm exec mpgd target build reddit staging --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "smoke:devvit": "pnpm exec mpgd target smoke reddit --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
@@ -18,30 +35,43 @@
     "devvit:upload": "pnpm --dir apps/target-devvit run upload",
     "devvit:playtest": "pnpm --dir apps/target-devvit run dev",
     "devvit:publish": "pnpm --dir apps/target-devvit run publish",
+    "legal:build": "pnpm exec mpgd legal build",
+    "legal:check": "pnpm exec mpgd legal check",
+    "pages:build": "pnpm legal:build && pnpm --dir apps/target-cloudflare-pages run build",
+    "pages:dev": "pnpm legal:build && pnpm --dir apps/target-cloudflare-pages run dev",
+    "pages:preview": "pnpm legal:build && pnpm --dir apps/target-cloudflare-pages run preview",
+    "pages:types": "pnpm --dir apps/target-cloudflare-pages run types",
     "check": "ttsc --noEmit -p tsconfig.json",
     "lint": "ttsc --noEmit -p tsconfig.json",
     "format": "ttsc format",
     "fix": "ttsc fix"
   },
   "dependencies": {
-    "@mpgd/adapter-ait": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/adapter-browser": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/adapter-capacitor": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/adapter-devvit": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/analytics": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/catalog": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/game-services": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/i18n": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/platform": "__MPGD_DEPENDENCY_VERSION__",
-    "@mpgd/target-config": "__MPGD_DEPENDENCY_VERSION__",
+    "@ait-co/polyfill": "^0.1.17",
+    "@apps-in-toss/web-framework": "^2.10.4",
+    "@mpgd/adapter-ait": "__MPGD_DEPENDENCY_VERSION_ADAPTER_AIT__",
+    "@mpgd/adapter-browser": "__MPGD_DEPENDENCY_VERSION_ADAPTER_BROWSER__",
+    "@mpgd/adapter-capacitor": "__MPGD_DEPENDENCY_VERSION_ADAPTER_CAPACITOR__",
+    "@mpgd/adapter-devvit": "__MPGD_DEPENDENCY_VERSION_ADAPTER_DEVVIT__",
+    "@mpgd/analytics": "__MPGD_DEPENDENCY_VERSION_ANALYTICS__",
+    "@mpgd/bridge": "__MPGD_DEPENDENCY_VERSION_BRIDGE__",
+    "@mpgd/catalog": "__MPGD_DEPENDENCY_VERSION_CATALOG__",
+    "@mpgd/game-services": "__MPGD_DEPENDENCY_VERSION_GAME_SERVICES__",
+    "@mpgd/i18n": "__MPGD_DEPENDENCY_VERSION_I18N__",
+    "@mpgd/platform": "__MPGD_DEPENDENCY_VERSION_PLATFORM__",
+    "@mpgd/phaser-assets": "__MPGD_DEPENDENCY_VERSION_PHASER_ASSETS__",
+    "@mpgd/target-config": "__MPGD_DEPENDENCY_VERSION_TARGET_CONFIG__",
     "phaser": "4.2.0"
   },
   "devDependencies": {
-    "@mpgd/cli": "__MPGD_DEPENDENCY_VERSION__",
+    "@ait-co/console-cli": "^0.1.45",
+    "@cloudflare/workers-types": "^5.20260707.1",
+    "@mpgd/cli": "__MPGD_DEPENDENCY_VERSION_CLI__",
     "@ttsc/unplugin": "0.16.9",
     "@types/node": "^24.0.0",
     "ttsc": "0.16.9",
     "typescript": "7.0.1-rc",
-    "vite": "^8.1.3"
+    "vite": "^8.1.3",
+    "wrangler": "^4.107.0"
   }
 }

package/templates/phaser-game/pnpm-workspace.yaml

@@ -3,5 +3,12 @@ packages:
   - 'apps/*'
 __PNPM_WORKSPACE_KIT_PACKAGES__
 allowBuilds:
+  '@sentry/cli': true
+  '@swc/core': true
+  # @ait-co/devtools lazily installs cloudflared when the phone tunnel starts;
+  # keep default workspace installs free of external binary downloads.
+  cloudflared: false
   esbuild: true
   protobufjs: true
+  sharp: true
+  workerd: true

package/templates/phaser-game/public/icon.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <defs>
+    <radialGradient id="starter-icon" cx="42%" cy="32%" r="68%">
+      <stop offset="0%" stop-color="#f8fafc" />
+      <stop offset="45%" stop-color="#38bdf8" />
+      <stop offset="100%" stop-color="#0f766e" />
+    </radialGradient>
+  </defs>
+  <rect width="128" height="128" rx="28" fill="#0f172a" />
+  <circle cx="64" cy="62" r="42" fill="url(#starter-icon)" />
+  <path d="M42 72 58 40l14 24 14-16 12 24H42Z" fill="#ecfeff" opacity="0.92" />
+</svg>

package/templates/phaser-game/public/manifest.webmanifest

@@ -0,0 +1,20 @@
+{
+  "lang": "en-US",
+  "name": "__GAME_TITLE__",
+  "short_name": "__GAME_NAME__",
+  "description": "__GAME_TITLE__ built with mpgd-kit.",
+  "start_url": "./",
+  "scope": "./",
+  "display": "standalone",
+  "orientation": "landscape",
+  "background_color": "#0f172a",
+  "theme_color": "#0f172a",
+  "icons": [
+    {
+      "src": "./icon.svg",
+      "sizes": "any",
+      "type": "image/svg+xml",
+      "purpose": "any maskable"
+    }
+  ]
+}

package/templates/phaser-game/src/assets/manifest.ts

@@ -0,0 +1,15 @@
+import { definePhaserAssetManifest, type PhaserAssetManifest } from '@mpgd/phaser-assets';
+
+import markerUrl from './marker.svg?url';
+
+export const starterAssetKeys = {
+  marker: '__GAME_NAME__.marker',
+} as const;
+
+export const starterAssets = definePhaserAssetManifest([
+  {
+    kind: 'image',
+    key: starterAssetKeys.marker,
+    url: markerUrl,
+  },
+] as const satisfies PhaserAssetManifest);

package/templates/phaser-game/src/assets/marker.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" role="img" aria-label="Starter marker">
+  <defs>
+    <radialGradient id="marker-glow" cx="50%" cy="45%" r="58%">
+      <stop offset="0%" stop-color="#99f6e4" />
+      <stop offset="55%" stop-color="#2dd4bf" />
+      <stop offset="100%" stop-color="#0f766e" />
+    </radialGradient>
+  </defs>
+  <circle cx="48" cy="48" r="42" fill="url(#marker-glow)" />
+  <circle cx="48" cy="48" r="32" fill="none" stroke="#ecfeff" stroke-width="5" opacity="0.86" />
+  <circle cx="48" cy="48" r="8" fill="#ecfeff" />
+</svg>

package/templates/phaser-game/src/env.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="vite/client" />
 
 declare const __APP_TARGET__: string;
+declare const __MPGD_CONFIG_TARGET__: string;
 declare const __APP_VERSION__: string;
 declare const __BUILD_ID__: string;
 declare const __DEBUG_BUILD__: boolean;

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

@@ -3,6 +3,7 @@ import type { Locale } from '@mpgd/i18n';
 export type GameMessageKey =
   | 'title'
   | 'target'
+  | 'viewport'
   | 'backend'
   | 'features'
   | 'featuresNone'
@@ -19,6 +20,7 @@ const messages = {
   en: {
     title: '__GAME_TITLE__',
     target: 'Target: {target}',
+    viewport: 'Viewport: {sizeClass} {orientation} - controls {controls}',
     backend: 'Game Services: {mode}',
     features: 'Features: {features}',
     featuresNone: 'none',
@@ -34,6 +36,7 @@ const messages = {
   ko: {
     title: '__GAME_TITLE__',
     target: '타깃: {target}',
+    viewport: '뷰포트: {sizeClass} {orientation} - 컨트롤 {controls}',
     backend: 'Game Services: {mode}',
     features: '기능: {features}',
     featuresNone: '없음',

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

@@ -2,6 +2,7 @@ import './styles.css';
 
 import { createAnalyticsReporter, createBufferedAnalyticsSink } from '@mpgd/analytics';
 import { resolveMpgdLocale, type Locale } from '@mpgd/i18n';
+import { resolveTargetViewportPlan } from '@mpgd/target-config';
 
 import { t } from './i18n/messages';
 import { createClientId } from './runtime/id';
@@ -16,9 +17,18 @@ async function bootstrap(): Promise<void> {
   let locale: Locale = 'en';
 
   try {
+    if (__APP_TARGET__ === 'ait') {
+      const { install } = await import('@ait-co/polyfill');
+      await install();
+    }
+
     const runtimeConfig = detectRuntime();
     const platform = await installPlatform(runtimeConfig);
     const runtime = await platform.getTargetRuntime();
+    const viewport = resolveTargetViewportPlan({
+      ...measureGameViewport(),
+      runtime: runtime.config.runtime,
+    });
     const player =
       (await platform.identity.getPlayer()) ?? {
         playerId: 'local-player',
@@ -49,6 +59,7 @@ async function bootstrap(): Promise<void> {
       context: {
         platform,
         runtime,
+        viewport,
         player,
         locale,
         gameServices,
@@ -76,3 +87,41 @@ function renderBootstrapError(error: unknown, locale: Locale): void {
   panel.textContent = `${t(locale, 'bootError')}: ${message}`;
   root.append(panel);
 }
+
+function measureGameViewport(): {
+  readonly width: number;
+  readonly height: number;
+  readonly source: 'container' | 'visual-viewport' | 'window';
+} {
+  const container = document.querySelector<HTMLElement>('#game');
+  const rect = container?.getBoundingClientRect();
+
+  if (rect !== undefined && rect.width > 0 && rect.height > 0) {
+    return {
+      width: rect.width,
+      height: rect.height,
+      source: 'container',
+    };
+  }
+
+  const visualViewport = window.visualViewport;
+
+  if (
+    visualViewport !== undefined &&
+    visualViewport !== null &&
+    visualViewport.width > 0 &&
+    visualViewport.height > 0
+  ) {
+    return {
+      width: visualViewport.width,
+      height: visualViewport.height,
+      source: 'visual-viewport',
+    };
+  }
+
+  return {
+    width: window.innerWidth,
+    height: window.innerHeight,
+    source: 'window',
+  };
+}

package/templates/phaser-game/src/platform/installPlatform.ts

@@ -71,7 +71,7 @@ export async function installPlatform(runtime: RuntimeConfig): Promise<TargetCon
     }
   }
 
-  const configTarget = targetConfigKeyForPlatform(runtime.target);
+  const configTarget = runtime.configTarget || targetConfigKeyForPlatform(runtime.target);
   const targetConfig = getTargetConfig(targetConfigMatrix, configTarget);
   const effectiveConfig = createEffectiveTargetConfig({
     target: configTarget,

package/templates/phaser-game/src/platform/runtimeDetector.ts

@@ -11,14 +11,18 @@ const validTargets = new Set<string>([
 
 export interface RuntimeConfig {
   readonly target: PlatformTarget;
+  readonly configTarget: string;
   readonly appVersion: string;
   readonly buildId: string;
   readonly debug: boolean;
 }
 
 export function detectRuntime(): RuntimeConfig {
+  const target = normalizeTarget(__APP_TARGET__);
+
   return {
-    target: normalizeTarget(__APP_TARGET__),
+    target,
+    configTarget: normalizeConfigTarget(__MPGD_CONFIG_TARGET__, target),
     appVersion: __APP_VERSION__,
     buildId: __BUILD_ID__,
     debug: __DEBUG_BUILD__,
@@ -28,3 +32,7 @@ export function detectRuntime(): RuntimeConfig {
 export function normalizeTarget(value: string): PlatformTarget {
   return validTargets.has(value) ? (value as PlatformTarget) : 'browser';
 }
+
+export function normalizeConfigTarget(value: string, target: PlatformTarget): string {
+  return value.length > 0 ? value : target === 'browser' ? 'web-preview' : target;
+}

package/templates/phaser-game/src/runtime/gameContext.ts

@@ -1,7 +1,11 @@
 import type { AnalyticsReporter, BufferedAnalyticsSink } from '@mpgd/analytics';
 import type { Locale } from '@mpgd/i18n';
 import type { PlayerIdentity } from '@mpgd/platform';
-import type { TargetConfiguredGateway, TargetRuntimeSnapshot } from '@mpgd/target-config';
+import type {
+  TargetConfiguredGateway,
+  TargetRuntimeSnapshot,
+  TargetViewportPlan,
+} from '@mpgd/target-config';
 
 import type { StarterGameServices } from '../platform/gameServices';
 
@@ -10,6 +14,7 @@ export const starterContextKey = 'starterContext';
 export interface StarterContext {
   readonly platform: TargetConfiguredGateway;
   readonly runtime: TargetRuntimeSnapshot;
+  readonly viewport: TargetViewportPlan;
   readonly player: PlayerIdentity;
   readonly locale: Locale;
   readonly gameServices: StarterGameServices;

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

@@ -1,10 +1,18 @@
 import Phaser from 'phaser';
 
+import { loadPhaserAssets } from '@mpgd/phaser-assets';
+
+import { starterAssets } from '../assets/manifest';
+
 export class BootScene extends Phaser.Scene {
   constructor() {
     super('BootScene');
   }
 
+  preload(): void {
+    loadPhaserAssets(this, starterAssets);
+  }
+
   create(): void {
     this.scene.start('LobbyScene');
   }

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

@@ -45,14 +45,30 @@ export class LobbyScene extends Phaser.Scene {
       })
       .setOrigin(0.5);
     this.add
-      .text(480, 258, t(locale, 'backend', { mode: context.gameServices.mode }), {
+      .text(
+        480,
+        258,
+        t(locale, 'viewport', {
+          sizeClass: context.viewport.layout.sizeClass,
+          orientation: context.viewport.layout.orientation,
+          controls: context.viewport.recommendation.primaryControls,
+        }),
+        {
+          color: '#d6dee8',
+          fontFamily: 'Arial, sans-serif',
+          fontSize: '18px',
+        },
+      )
+      .setOrigin(0.5);
+    this.add
+      .text(480, 300, 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, 336, t(locale, 'tapToStart'), {
+      .text(480, 342, t(locale, 'tapToStart'), {
         color: '#ffffff',
         fontFamily: 'Arial, sans-serif',
         fontSize: '22px',

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

@@ -2,6 +2,7 @@ import Phaser from 'phaser';
 
 import type { LogicalAdPlacementId } from '@mpgd/platform';
 
+import { starterAssetKeys } from '../assets/manifest';
 import { createStarterRunState, stepStarterRunState, type StarterRunState } from '../game/state';
 import { t } from '../i18n/messages';
 import { starterContextKey, type StarterContext } from '../runtime/gameContext';
@@ -11,7 +12,7 @@ const rewardedPlacementId = 'CONTINUE_AFTER_FAIL' satisfies LogicalAdPlacementId
 
 export class PlayScene extends Phaser.Scene {
   private state: StarterRunState = createStarterRunState();
-  private marker!: Phaser.GameObjects.Arc;
+  private marker!: Phaser.GameObjects.Image;
   private scoreText!: Phaser.GameObjects.Text;
   private rewardText!: Phaser.GameObjects.Text;
   private analyticsText!: Phaser.GameObjects.Text;
@@ -26,7 +27,7 @@ export class PlayScene extends Phaser.Scene {
   create(): void {
     this.context = this.registry.get(starterContextKey) as StarterContext;
 
-    this.marker = this.add.circle(480, 250, 34, 0x2dd4bf);
+    this.marker = this.add.image(480, 250, starterAssetKeys.marker).setDisplaySize(72, 72);
     this.scoreText = this.add
       .text(480, 86, '', {
         color: '#ffffff',

package/templates/phaser-game/src/styles.css

@@ -1,20 +1,43 @@
 html,
-body,
-#game {
+body {
   width: 100%;
   height: 100%;
   margin: 0;
 }
 
 body {
+  display: grid;
+  place-items: center;
+  box-sizing: border-box;
+  min-width: 0;
+  min-height: 100dvh;
   overflow: hidden;
+  padding:
+    env(safe-area-inset-top)
+    env(safe-area-inset-right)
+    env(safe-area-inset-bottom)
+    env(safe-area-inset-left);
   background: #07111f;
   color: #ffffff;
   font-family: Arial, sans-serif;
 }
 
+#game {
+  --mpgd-game-max-height: calc(
+    100dvh - env(safe-area-inset-top, 0px) - env(safe-area-inset-bottom, 0px)
+  );
+
+  box-sizing: border-box;
+  width: min(100%, 960px, calc(var(--mpgd-game-max-height) * 16 / 9));
+  aspect-ratio: 16 / 9;
+  min-width: 0;
+  min-height: 0;
+  touch-action: none;
+}
+
 canvas {
   display: block;
+  touch-action: none;
 }
 
 .boot-error {

package/templates/phaser-game/vite.config.ts

@@ -5,6 +5,7 @@ export default defineConfig(({ mode }) => {
   const isProduction = mode === 'production';
 
   return {
+    base: './',
     plugins: [
       ttsc({
         project: 'tsconfig.json',
@@ -13,6 +14,7 @@ export default defineConfig(({ mode }) => {
     ],
     define: {
       __APP_TARGET__: JSON.stringify(process.env.APP_TARGET ?? 'browser'),
+      __MPGD_CONFIG_TARGET__: JSON.stringify(process.env.MPGD_CONFIG_TARGET ?? ''),
       __APP_VERSION__: JSON.stringify(process.env.APP_VERSION ?? '0.0.0-dev'),
       __BUILD_ID__: JSON.stringify(process.env.BUILD_ID ?? 'local'),
       __DEBUG_BUILD__: JSON.stringify(!isProduction),