@mpgd/cli 0.47.0 → 0.48.0

package/dist/command-launcher.d.ts

@@ -0,0 +1,13 @@
+export interface NativeCommandLaunch {
+  readonly command: string;
+  readonly args: readonly string[];
+  readonly shell?: boolean;
+}
+/** Launch pnpm directly; Windows .cmd shims require a shell and lose argument boundaries. */
+export declare function resolveNativeCommandLaunch(input: {
+  readonly command: string;
+  readonly args: readonly string[];
+  readonly environment: NodeJS.ProcessEnv;
+  readonly platform?: NodeJS.Platform;
+  readonly nodeExecutable?: string;
+}): NativeCommandLaunch;

package/dist/command-launcher.js

@@ -0,0 +1,24 @@
+/** Launch pnpm directly; Windows .cmd shims require a shell and lose argument boundaries. */
+export function resolveNativeCommandLaunch(input) {
+    if ((input.platform ?? process.platform) !== 'win32') {
+        return { command: input.command, args: input.args };
+    }
+    if (input.command === './gradlew') {
+        return { command: 'gradlew.bat', args: input.args, shell: true };
+    }
+    if (input.command !== 'pnpm') {
+        return { command: input.command, args: input.args };
+    }
+    const pnpmEntry = input.environment.npm_execpath;
+    const pnpmBase = pnpmEntry?.split(/[\\/]/u).at(-1) ?? '';
+    if (pnpmEntry === undefined || !/^pnpm(?:\.exe|\.[cm]?js)$/iu.test(pnpmBase)) {
+        throw new Error('Windows builds require pnpm exec mpgd so npm_execpath resolves the pnpm executable or JavaScript entrypoint.');
+    }
+    if (/\.exe$/iu.test(pnpmEntry)) {
+        return { command: pnpmEntry, args: input.args };
+    }
+    return {
+        command: input.nodeExecutable ?? process.execPath,
+        args: [pnpmEntry, ...input.args],
+    };
+}

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export { cloudflarePagesDeploymentProfiles, hostedPwaDeploymentHosts, isSupporte
 export { defaultOfflinePlaytestArtifactDir, defaultOfflinePlaytestMaximumBytes, defaultOfflinePlaytestOutputDir, offlinePlaytestSchemaVersion, runOfflinePlaytestPackaging, type OfflinePlaytestEvidence, type RunOfflinePlaytestPackagingInput, type RunOfflinePlaytestPackagingResult, } from './offline-playtest.js';
 export { assertMicrosoftStorePwaCacheTransition, assertMicrosoftStorePwaPrecacheUrl, assertMicrosoftStorePwaReleaseEvidence, inspectMicrosoftStorePwaBrowserCacheTransition, microsoftStorePwaCacheSchema, readMicrosoftStorePwaBrowserReleaseEvidence, requestMicrosoftStorePwaBrowserUpdate, resolveMicrosoftStorePwaScopedCacheName, type AssertMicrosoftStorePwaCacheTransitionInput, type InspectMicrosoftStorePwaCacheTransitionInput, type MicrosoftStorePwaBrowserPage, type MicrosoftStorePwaCachedIndexObservation, type MicrosoftStorePwaCacheTransitionEvidence, type MicrosoftStorePwaCacheTransitionObservation, type MicrosoftStorePwaReleaseEvidence, } from './microsoft-store-pwa-e2e.js';
 export { createMicrosoftStorePackageAcceptanceRuntime, microsoftStorePackageAcceptanceSchemaVersion, parseMicrosoftStorePackageIdentity, parseWindowsAppCertificationResult, renderMicrosoftStorePackageAcceptanceMarkdown, runMicrosoftStorePackageAcceptance, type CreateMicrosoftStorePackageAcceptanceRuntimeInput, type MicrosoftStorePackageAcceptanceEvidence, type MicrosoftStorePackageAcceptanceRuntime, type MicrosoftStorePackageIdentity, type RunMicrosoftStorePackageAcceptanceInput, } from './microsoft-store-package-acceptance.js';
+export { getMicrosoftStoreNativeAcceptanceModulePath, getMicrosoftStoreNativeHostSourceDirectory, } from './windows-native-tools.js';
 export { createMicrosoftStorePackageGenerationRuntime, microsoftStorePackageGeneratorEndpoint, microsoftStorePackageGeneratorSourceRevision, microsoftStorePackageGenerationSchemaVersion, renderMicrosoftStorePackageGenerationMarkdown, runMicrosoftStorePackageGeneration, type CreateMicrosoftStorePackageGenerationRuntimeInput, type MicrosoftStoreAddressResolver, type MicrosoftStorePackageGenerationEvidence, type MicrosoftStorePackageGenerationRuntime, type MicrosoftStoreResolvedAddress, type RunMicrosoftStorePackageGenerationInput, } from './microsoft-store-package-generation.js';
 export { microsoftStoreSubmissionSchemaVersion, parseMicrosoftStoreSubmissionConfig, renderMicrosoftStoreSubmissionMarkdown, runMicrosoftStoreSubmissionPreflight, type MicrosoftStoreSubmissionConfig, type MicrosoftStoreSubmissionCommerce, type MicrosoftStoreSubmissionCommerceProduct, type MicrosoftStoreSubmissionEvidence, type RunMicrosoftStoreSubmissionPreflightInput, } from './microsoft-store-submission.js';
 export { assertProductionTargetReadiness, type ProductionTargetReadinessInput, } from './production-target-readiness.js';

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
@@ -80,6 +94,7 @@ const mpgdTemplateDependencyPackages = [
     { 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' },
@@ -551,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,
@@ -603,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 }),
@@ -2755,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);
@@ -2777,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,
@@ -3037,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
@@ -3506,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": "a54c0341749bb93a97ddd927205de960294c6511",
+  "kitGitSha": "926ff936dc36d2112c042185974dc3c33102377d",
   "kitDirty": false,
-  "packageVersion": "0.47.0"
+  "packageVersion": "0.48.0"
 }