@mpgd/cli 0.46.1 → 0.48.0

package/dist/index.js

@@ -7,6 +7,7 @@ import i18n, { defineI18n } from '@gunshi/plugin-i18n';
 import resources from '@gunshi/resources';
 import { cli } from 'gunshi';
 import { assertPlatformVersionLedger } from '@mpgd/target-config';
+import { resolveNativeCommandLaunch } from './command-launcher.js';
 import { buildAssetPacks } from './asset-pack-build.js';
 import { verifyAssetPackDelivery } from './asset-pack-verify.js';
 import { buildAssetPackTarget } from './asset-pack-target.js';
@@ -47,6 +48,7 @@ export { cloudflarePagesDeploymentProfiles, hostedPwaDeploymentHosts, isSupporte
 export { defaultOfflinePlaytestArtifactDir, defaultOfflinePlaytestMaximumBytes, defaultOfflinePlaytestOutputDir, offlinePlaytestSchemaVersion, runOfflinePlaytestPackaging, } from './offline-playtest.js';
 export { assertMicrosoftStorePwaCacheTransition, assertMicrosoftStorePwaPrecacheUrl, assertMicrosoftStorePwaReleaseEvidence, inspectMicrosoftStorePwaBrowserCacheTransition, microsoftStorePwaCacheSchema, readMicrosoftStorePwaBrowserReleaseEvidence, requestMicrosoftStorePwaBrowserUpdate, resolveMicrosoftStorePwaScopedCacheName, } from './microsoft-store-pwa-e2e.js';
 export { createMicrosoftStorePackageAcceptanceRuntime, microsoftStorePackageAcceptanceSchemaVersion, parseMicrosoftStorePackageIdentity, parseWindowsAppCertificationResult, renderMicrosoftStorePackageAcceptanceMarkdown, runMicrosoftStorePackageAcceptance, } from './microsoft-store-package-acceptance.js';
+export { getMicrosoftStoreNativeAcceptanceModulePath, getMicrosoftStoreNativeHostSourceDirectory, } from './windows-native-tools.js';
 export { createMicrosoftStorePackageGenerationRuntime, microsoftStorePackageGeneratorEndpoint, microsoftStorePackageGeneratorSourceRevision, microsoftStorePackageGenerationSchemaVersion, renderMicrosoftStorePackageGenerationMarkdown, runMicrosoftStorePackageGeneration, } from './microsoft-store-package-generation.js';
 export { microsoftStoreSubmissionSchemaVersion, parseMicrosoftStoreSubmissionConfig, renderMicrosoftStoreSubmissionMarkdown, runMicrosoftStoreSubmissionPreflight, } from './microsoft-store-submission.js';
 export { assertProductionTargetReadiness, } from './production-target-readiness.js';
@@ -54,6 +56,18 @@ const sourceDir = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = resolvePackageRoot(sourceDir);
 const detectedKitRoot = resolveDefaultKitRoot();
 const gameTemplateDir = path.resolve(packageRoot, 'templates/phaser-game');
+const liteTemplateOverlayDir = path.resolve(packageRoot, 'templates/lite-overlay');
+const supportedGameTemplates = ['phaser', 'lite'];
+/** Lite renderers implemented today. dom/svg are reserved extension points in @mpgd/lite-shell. */
+const supportedLiteRenderers = ['canvas'];
+/** Phaser-only base template files that the lite template does not emit. */
+const liteTemplateRemovedFiles = new Set([
+    'src/scenes/BootScene.ts',
+    'src/scenes/LobbyScene.ts',
+    'src/scenes/PlayScene.ts',
+    'src/assets/manifest.ts',
+    'src/assets/marker.svg',
+]);
 const cliVersion = readPackageVersion(packageRoot);
 const recommendedMatrixTargets = 'web,microsoft-store,verse8,ait,reddit';
 const recommendedMatrixTargetsWithoutMicrosoftStore = recommendedMatrixTargets
@@ -73,11 +87,14 @@ const mpgdTemplateDependencyPackages = [
     { name: '@mpgd/adapter-verse8', packageDir: 'adapters/verse8' },
     { name: '@mpgd/analytics', packageDir: 'packages/analytics' },
     { name: '@mpgd/bridge', packageDir: 'packages/bridge' },
+    { name: '@mpgd/capacitor-play-billing', packageDir: 'native-plugins/capacitor-play-billing' },
+    { name: '@mpgd/capacitor-storekit', packageDir: 'native-plugins/capacitor-storekit' },
     { name: '@mpgd/catalog', packageDir: 'packages/catalog' },
     { name: '@mpgd/cli', packageDir: 'packages/cli' },
     { name: '@mpgd/game-services', packageDir: 'packages/game-services' },
     { name: '@mpgd/game-runtime', packageDir: 'packages/game-runtime' },
     { name: '@mpgd/i18n', packageDir: 'packages/i18n' },
+    { name: '@mpgd/lite-shell', packageDir: 'packages/lite-shell' },
     { name: '@mpgd/phaser-assets', packageDir: 'packages/phaser-assets' },
     { name: '@mpgd/platform', packageDir: 'packages/platform' },
     { name: '@mpgd/target-config', packageDir: 'packages/target-config' },
@@ -549,8 +566,26 @@ const gameCommand = defineI18n({
                     en: 'Include the Microsoft Store PWA target and release workflow.',
                     ko: 'Microsoft Store PWA 타깃과 출시 워크플로를 포함합니다.',
                 },
+                template: {
+                    en: 'Game template: phaser (default) or lite (no Phaser, @mpgd/lite-shell).',
+                    ko: '게임 템플릿: phaser(기본) 또는 lite(Phaser 없음, @mpgd/lite-shell).',
+                },
+                renderer: {
+                    en: 'Lite template renderer. Only canvas is implemented today.',
+                    ko: 'lite 템플릿 렌더러. 현재는 canvas만 지원합니다.',
+                },
             }),
             args: {
+                template: {
+                    type: 'string',
+                    required: false,
+                    description: 'Game template: phaser (default) or lite.',
+                },
+                renderer: {
+                    type: 'string',
+                    required: false,
+                    description: 'Lite template renderer: canvas (default).',
+                },
                 directory: {
                     type: 'positional',
                     required: true,
@@ -601,7 +636,10 @@ const gameCommand = defineI18n({
                     ? 'workspace:*'
                     : readOptionalString(ctx.values['dependency-version']);
                 const kitPath = readGameCreateKitPath(ctx.values, ctx.values.workspace === true);
+                const { template, renderer } = readGameCreateTemplate(readOptionalString(ctx.values.template), readOptionalString(ctx.values.renderer));
                 createGameApp({
+                    template,
+                    ...(renderer === undefined ? {} : { renderer }),
                     directory,
                     ...(title === undefined ? {} : { title }),
                     ...(packageName === undefined ? {} : { packageName }),
@@ -1558,8 +1596,8 @@ const targetCommand = defineI18n({
                     ko: '프로덕션 HTTPS Game Services 기본 URL.',
                 },
                 providers: {
-                    en: 'Comma-separated requested provider IDs; this does not install SDKs.',
-                    ko: '쉼표로 구분한 요청 provider ID. SDK를 설치하지는 않습니다.',
+                    en: 'Comma-separated provider IDs. play-billing (Android) and storekit (iOS) install the kit store plugin into the shell and the game, register it with cap sync, and wire an unwired template gateway; other IDs are recorded only.',
+                    ko: '쉼표로 구분한 provider ID. play-billing(Android)과 storekit(iOS)은 키트 스토어 플러그인을 셸과 게임에 설치하고 cap sync로 등록하며, 연결되지 않은 템플릿 게이트웨이를 연결합니다. 다른 ID는 기록만 합니다.',
                 },
             }),
             args: {
@@ -1607,7 +1645,7 @@ const targetCommand = defineI18n({
                 providers: {
                     type: 'string',
                     required: false,
-                    description: 'Comma-separated requested provider IDs; this does not install SDKs.',
+                    description: 'Comma-separated provider IDs. play-billing (Android) and storekit (iOS) install the kit store plugin into the shell and the game, register it with cap sync, and wire an unwired template gateway; other IDs are recorded only.',
                 },
             },
             run: (ctx) => {
@@ -1631,6 +1669,7 @@ const targetCommand = defineI18n({
                         gameRoot,
                         appId,
                         displayName,
+                        templateRoot: gameTemplateDir,
                         ...(iconSource === undefined ? {} : { iconSource }),
                         ...(backendUrl === undefined ? {} : { backendUrl }),
                         ...(selectedProviders === undefined ? {} : {
@@ -1647,18 +1686,33 @@ const targetCommand = defineI18n({
                     for (const platform of plan.nativePlatformsToAdd) {
                         console.info(`${dryRun ? 'Would add' : 'Added'} native platform: ${platform}`);
                     }
-                    console.info('File count covers managed shell files only; pnpm may also update root or shell lockfiles.');
+                    for (const plugin of plan.providerPlugins) {
+                        console.info(`${dryRun ? 'Would install' : 'Installed'} ${plugin.platform} store plugin `
+                            + `${plugin.packageName}@${plugin.version} (${plugin.id}) into the shell`
+                            + `${plugin.versionSource === 'kit' ? ' and the game' : ''}`
+                            + `${dryRun ? '; cap add or cap sync registers it' : ''}.`);
+                    }
+                    for (const warning of plan.warnings) {
+                        console.warn(`Warning: ${warning}`);
+                    }
+                    console.info('File count covers managed shell and game files only; pnpm may also update root or shell lockfiles.');
                     if (!dryRun) {
                         console.info('Production native builds still require release identity and signing checks.');
                     }
                     return;
                 }
+                if (ctx.values.providers !== undefined) {
+                    throw new Error('--providers is only available for capacitor initialization: it installs the '
+                        + 'play-billing (Android) and storekit (iOS) store plugins into the game-owned '
+                        + `native shell, which ${requestedTarget} does not initialize. Run `
+                        + '"mpgd target init capacitor --providers ..." instead.');
+                }
                 const target = normalizeConfiguredBuildTarget(requestedTarget);
                 if (target !== 'microsoft-store') {
                     throw new Error(`Target initialization is only available for microsoft-store; received: ${requestedTarget}`);
                 }
                 for (const option of [
-                    'app-id', 'display-name', 'icon-source', 'backend-url', 'providers',
+                    'app-id', 'display-name', 'icon-source', 'backend-url',
                 ]) {
                     if (ctx.values[option] !== undefined) {
                         throw new Error(`--${option} is only available for capacitor initialization.`);
@@ -2737,9 +2791,88 @@ function normalizeLegalHtml(content, sourceFile) {
     }
     return content.endsWith('\n') ? content : `${content}\n`;
 }
+function readGameCreateTemplate(template, renderer) {
+    const resolvedTemplate = template ?? 'phaser';
+    if (!supportedGameTemplates.includes(resolvedTemplate)) {
+        throw new Error(`Unsupported --template ${resolvedTemplate}; expected one of: ${supportedGameTemplates.join(', ')}.`);
+    }
+    if (resolvedTemplate !== 'lite') {
+        if (renderer !== undefined) {
+            throw new Error('--renderer is only available with --template lite.');
+        }
+        return { template: resolvedTemplate };
+    }
+    const resolvedRenderer = renderer ?? 'canvas';
+    if (!supportedLiteRenderers.includes(resolvedRenderer)) {
+        throw new Error(`Unsupported --renderer ${resolvedRenderer}; implemented lite renderers: ${supportedLiteRenderers.join(', ')}. `
+            + 'dom and svg are planned LiteRenderer implementations.');
+    }
+    return { template: 'lite', renderer: resolvedRenderer };
+}
+/** Apply the lite overlay to base template files: drop Phaser-only files and swap renderers. */
+function applyLiteTemplateOverlay(baseFiles, overlayFiles) {
+    const overlay = new Map(overlayFiles.map((file) => [file.relativePath, file]));
+    const merged = baseFiles.flatMap((file) => {
+        if (liteTemplateRemovedFiles.has(file.relativePath)) {
+            return [];
+        }
+        const replacement = overlay.get(file.relativePath);
+        overlay.delete(file.relativePath);
+        if (replacement !== undefined) {
+            return [replacement];
+        }
+        if (file.relativePath === 'package.json') {
+            return [{ ...file, content: liteTemplatePackageJson(file.content) }];
+        }
+        if (file.relativePath === 'agent/game-manifest.json') {
+            return [{ ...file, content: liteTemplateGameManifest(file.content) }];
+        }
+        if (file.relativePath === 'mpgd.targets.json') {
+            return [{ ...file, content: liteTemplateTargets(file.content) }];
+        }
+        return [file];
+    });
+    return [...merged, ...overlay.values()];
+}
+function liteTemplateTargets(content) {
+    const value = JSON.parse(content);
+    const reddit = value.targets.reddit;
+    if (reddit !== undefined) {
+        reddit.inlineEntry = 'index.html';
+        reddit.inlineBudget = {
+            maxGzipKb: 40,
+            forbidModules: ['phaser', 'matter-js'],
+            deferredChunks: ['main.js', 'matter.js', 'assets/main-*.js', 'assets/matter-*.js'],
+        };
+    }
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function liteTemplatePackageJson(content) {
+    const value = JSON.parse(content);
+    value.description = (value.description ?? '').replace('mpgd Phaser game', 'mpgd lite (Canvas2D) game');
+    const dependencies = { ...value.dependencies };
+    delete dependencies.phaser;
+    delete dependencies['@mpgd/phaser-assets'];
+    dependencies['@mpgd/lite-shell'] = '__MPGD_DEPENDENCY_VERSION_LITE_SHELL__';
+    value.dependencies = Object.fromEntries(Object.entries(dependencies).sort(([a], [b]) => a.localeCompare(b)));
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function liteTemplateGameManifest(content) {
+    const value = JSON.parse(content);
+    if (value.game !== undefined) {
+        value.game.engine = 'lite-canvas';
+    }
+    value.blocks = (value.blocks ?? []).map((block) => block.id === 'assets.manifest.phaser-loader'
+        ? { id: 'render.lite-shell.canvas', owner: 'src/lite/tapGame.ts' }
+        : block);
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
 function createGameApp(input) {
     const appDir = resolveAppDirectory(input.directory);
     const gameName = path.basename(appDir);
+    if (input.template === 'lite' && !input.workspace) {
+        throw new Error('The lite template requires --workspace until @mpgd/lite-shell is published.');
+    }
     assertValidGameName(gameName);
     const packageName = input.packageName ?? gameName;
     assertValidPackageName(packageName);
@@ -2759,7 +2892,11 @@ function createGameApp(input) {
         ...(input.title === undefined ? {} : { title: input.title }),
         microsoftStore: input.microsoftStore,
     });
-    const files = collectTemplateFiles(gameTemplateDir).flatMap((file) => {
+    const baseTemplateFiles = collectTemplateFiles(gameTemplateDir);
+    const selectedTemplateFiles = input.template === 'lite'
+        ? applyLiteTemplateOverlay(baseTemplateFiles, collectTemplateFiles(liteTemplateOverlayDir))
+        : baseTemplateFiles;
+    const files = selectedTemplateFiles.flatMap((file) => {
         const prepared = prepareBaseGameTemplateFile({
             relativePath: file.relativePath,
             content: file.content,
@@ -3019,9 +3156,10 @@ function renderTemplate(content, context) {
     return rendered;
 }
 function templateOutputPath(relativePath) {
-    return path.basename(relativePath) === 'gitignore'
-        ? path.join(path.dirname(relativePath), '.gitignore')
-        : relativePath;
+    const normalized = relativePath.replace(/\\/gu, '/');
+    return path.posix.basename(normalized) === 'gitignore'
+        ? path.posix.join(path.posix.dirname(normalized), '.gitignore')
+        : normalized;
 }
 function toPascalCase(value) {
     return value
@@ -3488,12 +3626,11 @@ function runPnpm(args, commandEnv) {
     if (kitPath === undefined || kitPath.length === 0) {
         throw new Error('Missing MPGD_KIT_PATH. Pass --kit-path or set MPGD_KIT_PATH.');
     }
-    const command = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
-    const result = spawnSync(command, [...args], {
+    const launch = resolveNativeCommandLaunch({ command: 'pnpm', args, environment: commandEnv });
+    const result = spawnSync(launch.command, [...launch.args], {
         cwd: kitPath,
         env: commandEnv,
         stdio: 'inherit',
-        shell: process.platform === 'win32',
     });
     if (result.error !== undefined) {
         throw result.error;

package/dist/microsoft-store-submission.js

@@ -3,6 +3,7 @@ import { closeSync, existsSync, fstatSync, lstatSync, openSync, readFileSync, re
 import { isIP } from 'node:net';
 import path from 'node:path';
 import { inflateSync } from 'node:zlib';
+import { normalizeRootRelativeRoute } from '@mpgd/platform/routes';
 import { escapeMarkdownInline, escapeMarkdownTable, formatError, relativeOrAbsolute, } from './evidence-io.js';
 import { isMicrosoftStoreSupportedListingLocale } from './microsoft-store-supported-locales.js';
 export const microsoftStoreSubmissionSchemaVersion = 1;
@@ -445,14 +446,18 @@ function parseListings(input) {
             }];
     }));
 }
+/**
+ * An artifact-relative URL: `.` and then a root-relative route already in the
+ * form `normalizeRootRelativeRoute` from `@mpgd/platform/routes` returns, the
+ * rule share links and notification routes follow, so no client reads it as
+ * another host, even once it percent-decodes the path. The manifest ships in
+ * the artifact and the Store resolves these against the manifest's own URL,
+ * so an absolute URL is never needed.
+ */
 function requireManifestUrl(input, label) {
     const value = requireNonEmptyString(input, label);
-    const base = new URL('https://mpgd.invalid/');
-    const url = new URL(value, base);
-    if (!value.startsWith('./')
-        || url.origin !== base.origin
-        || url.pathname.startsWith('//')
-        || value !== `.${url.pathname}${url.search}${url.hash}`) {
+    const route = value.startsWith('./') ? value.slice(1) : undefined;
+    if (route === undefined || normalizeRootRelativeRoute(route) !== route) {
         throw new Error(`${label} must be an artifact-relative URL beginning with ./`);
     }
     return value;

package/dist/native-build-info.json

@@ -1,5 +1,5 @@
 {
-  "kitGitSha": "6799cf86c8d5257db83fa5f8c56c2a74b720ae73",
+  "kitGitSha": "926ff936dc36d2112c042185974dc3c33102377d",
   "kitDirty": false,
-  "packageVersion": "0.46.1"
+  "packageVersion": "0.48.0"
 }