@mpgd/cli 0.47.0 → 0.49.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/devvit-output-collisions.d.ts

@@ -0,0 +1,49 @@
+/**
+* One output path written by more than one source in a Devvit web build.
+*
+* `public` means a file from a public directory was silently replaced by a
+* Vite-emitted file of the same name (Vite copies `publicDir` first and then
+* writes the bundle over it). `case` means two output files differ only by
+* letter case. The build plugin checks bundle names before writing so this
+* also works on case-insensitive filesystems.
+*/
+export interface DevvitOutputCollision {
+  readonly kind: 'public' | 'case';
+  readonly path: string;
+  readonly sources: readonly string[];
+}
+/** Validate logical output names before the filesystem can collapse them. */
+export declare function assertDevvitOutputNames(bundleNames: readonly string[], publicNames: readonly string[], outDir: string): void;
+/** Shared Vite 7/8 guard for production and staging watch builds. */
+export declare function devvitOutputCollisionPlugin(): {
+  name: string;
+  apply: "build";
+  enforce: "post";
+  configResolved(config: {
+    publicDir: string;
+  }): void;
+  generateBundle: {
+    order: "post";
+    handler(this: {
+      environment: {
+        config: {
+          build: {
+            copyPublicDir: boolean;
+            outDir: string;
+          };
+        };
+      };
+    }, options: {
+      dir?: string | undefined;
+    }, bundle: Record<string, {
+      fileName: string;
+    }>): void;
+  };
+};
+/**
+* Finds output files of a Devvit client build that were overwritten or that
+* collide by case. `publicDirs` are the directories Vite copied verbatim.
+*/
+export declare function findDevvitOutputCollisions(outDir: string, publicDirs: readonly string[]): DevvitOutputCollision[];
+/** Throws a single readable error listing every collision. */
+export declare function assertNoDevvitOutputCollisions(outDir: string, publicDirs: readonly string[]): void;

package/dist/devvit-output-collisions.js

@@ -0,0 +1,120 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+/** Validate logical output names before the filesystem can collapse them. */
+export function assertDevvitOutputNames(bundleNames, publicNames, outDir) {
+    const collisions = [];
+    const names = new Map();
+    for (const name of [...publicNames, ...bundleNames]) {
+        const previous = names.get(name.toLowerCase());
+        if (previous !== undefined) {
+            collisions.push({
+                kind: previous === name ? 'public' : 'case',
+                path: name,
+                sources: [previous, name],
+            });
+        }
+        names.set(name.toLowerCase(), name);
+    }
+    throwCollisions(collisions, outDir);
+}
+/** Shared Vite 7/8 guard for production and staging watch builds. */
+export function devvitOutputCollisionPlugin() {
+    let publicDir = '';
+    return {
+        name: 'mpgd-devvit-output-collisions',
+        apply: 'build',
+        enforce: 'post',
+        configResolved(config) {
+            publicDir = config.publicDir;
+        },
+        generateBundle: {
+            order: 'post',
+            handler(options, bundle) {
+                const publicNames = this.environment.config.build.copyPublicDir
+                    && publicDir !== '' && existsSync(publicDir) ? listFiles(publicDir) : [];
+                assertDevvitOutputNames(Object.values(bundle).map((output) => output.fileName), publicNames, options.dir ?? this.environment.config.build.outDir);
+            },
+        },
+    };
+}
+function listFiles(root) {
+    const out = [];
+    const pending = [root];
+    while (pending.length > 0) {
+        const directory = pending.pop();
+        for (const entry of readdirSync(directory, { withFileTypes: true })) {
+            const absolute = join(directory, entry.name);
+            // Follow symlinks: a linked directory is traversed, a linked file listed.
+            const stats = entry.isSymbolicLink() ? statSync(absolute, { throwIfNoEntry: false }) : entry;
+            if (stats === undefined) {
+                continue;
+            }
+            if (stats.isDirectory()) {
+                pending.push(absolute);
+            }
+            else if (stats.isFile()) {
+                out.push(relative(root, absolute).split(sep).join('/'));
+            }
+        }
+    }
+    return out.sort();
+}
+/**
+ * Finds output files of a Devvit client build that were overwritten or that
+ * collide by case. `publicDirs` are the directories Vite copied verbatim.
+ */
+export function findDevvitOutputCollisions(outDir, publicDirs) {
+    if (!existsSync(outDir)) {
+        return [];
+    }
+    const outputs = listFiles(outDir);
+    const collisions = [];
+    for (const publicDir of publicDirs) {
+        if (!existsSync(publicDir)) {
+            continue;
+        }
+        for (const file of listFiles(publicDir)) {
+            const output = join(outDir, file);
+            if (!existsSync(output)) {
+                continue;
+            }
+            if (!readFileSync(output).equals(readFileSync(join(publicDir, file)))) {
+                collisions.push({
+                    kind: 'public',
+                    path: file,
+                    sources: [join(publicDir, file), 'vite bundle output'],
+                });
+            }
+        }
+    }
+    const byLowerCase = new Map();
+    for (const file of outputs) {
+        const key = file.toLowerCase();
+        byLowerCase.set(key, [...(byLowerCase.get(key) ?? []), file]);
+    }
+    for (const files of byLowerCase.values()) {
+        if (files.length > 1) {
+            collisions.push({ kind: 'case', path: files[0], sources: files });
+        }
+    }
+    return collisions;
+}
+/** Throws a single readable error listing every collision. */
+export function assertNoDevvitOutputCollisions(outDir, publicDirs) {
+    const collisions = findDevvitOutputCollisions(outDir, publicDirs);
+    throwCollisions(collisions, outDir);
+}
+function throwCollisions(collisions, outDir) {
+    if (collisions.length === 0) {
+        return;
+    }
+    const lines = collisions.map((collision) => collision.kind === 'public'
+        ? `  - ${collision.path}: public and bundle files use the same output name`
+        : `  - ${collision.sources.join(', ')}: names differ only by case`);
+    throw new Error([
+        `Devvit build output has ${collisions.length} conflicting file name(s) in ${outDir}:`,
+        ...lines,
+        'Rename the public file or the entry/chunk (Devvit client output uses unhashed [name].js names),'
+            + ' then rebuild.',
+    ].join('\n'));
+}

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';
@@ -24,6 +25,7 @@ import { createMicrosoftStorePackageAcceptanceRuntime, runMicrosoftStorePackageA
 import { runMicrosoftStorePackageGeneration } from './microsoft-store-package-generation.js';
 import { defaultMpgdKitPath, initializeMicrosoftStoreStarter, listMicrosoftStoreInitializerTemplateFiles, prepareBaseGameTemplateFile, resolveMicrosoftStoreAdapterDependencyVersion, } from './microsoft-store-starter.js';
 import { applyKitUpgrade, planKitUpgrade } from './kit-upgrade.js';
+import { applyToolingMigration, planToolingMigration } from './tooling-migration.js';
 import { runMicrosoftStoreSubmissionPreflight } from './microsoft-store-submission.js';
 import { defaultOfflinePlaytestArtifactDir, defaultOfflinePlaytestMaximumBytes, defaultOfflinePlaytestOutputDir, runOfflinePlaytestPackaging, } from './offline-playtest.js';
 import { targetConfigExtensionsFileEnv, targetConfigMatrixFileEnv } from './target-config-env.js';
@@ -47,6 +49,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 +57,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 +95,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' },
@@ -162,7 +178,7 @@ export async function runMpgdCli(args) {
         // partial document. Every other command keeps the default rendering.
         renderHeader: async (ctx) => {
             const values = ctx.values;
-            if ((ctx.name === 'verify-delivery' || ctx.name === 'stage-target' || ctx.name === 'publish-s3' || ctx.name === 'upgrade') && values.json === true) {
+            if ((ctx.name === 'verify-delivery' || ctx.name === 'stage-target' || ctx.name === 'publish-s3' || ctx.name === 'upgrade' || ctx.name === 'migrate-tools') && values.json === true) {
                 return '';
             }
             const title = ctx.env.description || ctx.env.name || '';
@@ -173,7 +189,7 @@ export async function runMpgdCli(args) {
         renderValidationErrors: async (ctx, error) => {
             const messages = error.errors.map((entry) => String(entry.message)).join('\n');
             const values = ctx.values;
-            if ((ctx.name === 'verify-delivery' || ctx.name === 'stage-target' || ctx.name === 'publish-s3' || ctx.name === 'upgrade') && values.json === true) {
+            if ((ctx.name === 'verify-delivery' || ctx.name === 'stage-target' || ctx.name === 'publish-s3' || ctx.name === 'upgrade' || ctx.name === 'migrate-tools') && values.json === true) {
                 process.stderr.write(`${messages}\n`);
                 return '';
             }
@@ -551,8 +567,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 +637,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 }),
@@ -2540,6 +2577,58 @@ const kitCommand = defineI18n({
                 }
             },
         }),
+        'migrate-tools': defineI18n({
+            name: 'migrate-tools',
+            description: 'Plan or apply the TypeScript tools migration for an existing generated game.',
+            resource: commandResource({
+                base: {
+                    en: 'Plan or apply the TypeScript tools migration for an existing generated game.',
+                    ko: '기존 생성 게임의 TypeScript 도구 이전을 계획하거나 적용합니다.',
+                },
+                args: {
+                    game: { en: 'Existing generated game directory.', ko: '기존 생성 게임 디렉터리.' },
+                    apply: { en: 'Apply the reviewed local migration plan.', ko: '검토한 로컬 이전 계획을 적용합니다.' },
+                    json: { en: 'Print the complete plan as JSON.', ko: '전체 계획을 JSON으로 출력합니다.' },
+                },
+            }),
+            args: {
+                game: { type: 'string', required: false, default: '.', description: 'Game directory.' },
+                apply: { type: 'boolean', required: false, description: 'Apply the local plan.' },
+                json: { type: 'boolean', required: false, description: 'Print JSON.' },
+            },
+            run: (ctx) => {
+                const plan = planToolingMigration(readOptionalString(ctx.values.game) ?? '.', gameTemplateDir);
+                const result = ctx.values.apply === true && plan.blockers.length === 0
+                    ? applyToolingMigration(plan) : undefined;
+                if (ctx.values.json === true) {
+                    process.stdout.write(JSON.stringify({ plan, result: result ?? null }, null, 2) + '\n');
+                }
+                else {
+                    console.info('TypeScript tooling plan for ' + plan.gameRoot);
+                    for (const edit of plan.edits) {
+                        console.info('  ' + (edit.after === null ? 'Remove ' : 'Write ') + edit.file);
+                    }
+                    for (const note of plan.notes) {
+                        console.info('Note: ' + note);
+                    }
+                    for (const blocker of plan.blockers) {
+                        console.error('Blocked: ' + blocker);
+                    }
+                    if (result !== undefined) {
+                        console.info('Applied ' + result.length + ' file change(s).');
+                    }
+                    else if (!plan.edits.length && !plan.blockers.length) {
+                        console.info('TypeScript tooling is already current.');
+                    }
+                    else if (!plan.blockers.length) {
+                        console.info('Run again with --apply after reviewing the plan.');
+                    }
+                }
+                if (plan.blockers.length) {
+                    process.exitCode = 1;
+                }
+            },
+        }),
         doctor: defineI18n({
             name: 'doctor',
             description: 'Print CLI, kit, template, and target-wrapper status.',
@@ -2558,7 +2647,7 @@ const kitCommand = defineI18n({
         }),
     },
     run: () => {
-        console.info('Use "mpgd kit doctor" or "mpgd kit upgrade --game <directory> [--apply]".');
+        console.info('Use "mpgd kit doctor", "mpgd kit upgrade --game <directory> [--apply]", or "mpgd kit migrate-tools --game <directory> [--apply]".');
     },
 });
 function commandResource(description, args = {}) {
@@ -2755,9 +2844,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 +2945,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,
@@ -2923,6 +3095,9 @@ function createTemplateContext(input) {
         workspaceI18nBuildPrefix: input.workspace
             ? `pnpm --dir ${workspacePrefix} i18n:build && `
             : '',
+        devvitOutputPluginImport: input.workspace
+            ? toJavaScriptStringLiteral(`./${toTemplatePath(path.relative(path.join(input.appDir, 'apps/target-devvit'), path.resolve(kitPath ?? input.appDir, 'packages/cli/src/devvit-output-collisions')))}`)
+            : "'@mpgd/cli/devvit'",
         defaultKitPath: kitPath === undefined ? defaultMpgdKitPath : workspacePrefix,
         recommendedMatrixTargets: input.microsoftStore
             ? recommendedMatrixTargets
@@ -3014,6 +3189,7 @@ function walkTemplateDir(templateDir, relativeDir, files) {
 }
 function renderTemplate(content, context) {
     let rendered = content
+        .replaceAll("from '@mpgd/cli/devvit'", `from ${context.devvitOutputPluginImport}`)
         .replaceAll('__GAME_NAME__', context.gameName)
         .replaceAll('__DEVVIT_APP_NAME__', context.devvitAppName)
         .replaceAll('__GAME_TITLE_TS_LITERAL__', context.gameTitleTsLiteral)
@@ -3037,9 +3213,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 +3683,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": "88c1eb8846cc699d328d94d9c374b088c123e4c1",
   "kitDirty": false,
-  "packageVersion": "0.47.0"
+  "packageVersion": "0.49.0"
 }