@mpgd/cli 0.28.1 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -52,19 +52,19 @@
     "@types/node": "^24.0.0",
     "ttsc": "0.18.4",
     "typescript": "7.0.2",
+    "@mpgd/adapter-browser": "0.7.3",
     "@mpgd/adapter-ait": "0.12.1",
     "@mpgd/adapter-capacitor": "0.4.10",
     "@mpgd/adapter-devvit": "0.9.6",
     "@mpgd/adapter-verse8": "0.3.4",
-    "@mpgd/adapter-browser": "0.7.3",
     "@mpgd/analytics": "0.3.12",
     "@mpgd/bridge": "0.9.0",
     "@mpgd/catalog": "0.7.2",
+    "@mpgd/i18n": "0.6.1",
     "@mpgd/game-services": "0.14.0",
-    "@mpgd/i18n": "0.6.0",
     "@mpgd/phaser-assets": "0.4.1",
-    "@mpgd/target-config": "0.14.0",
-    "@mpgd/platform": "0.12.0"
+    "@mpgd/platform": "0.12.0",
+    "@mpgd/target-config": "0.14.1"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

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

@@ -36,6 +36,10 @@
       "id": "platform.gateway.bootstrap-intents",
       "owner": "src/main.ts"
     },
+    {
+      "id": "platform.ui.text-selection",
+      "owner": "src/platform/textSelection.ts"
+    },
     {
       "id": "runtime.viewport.orientation-policy",
       "owner": "src/main.ts"

package/templates/phaser-game/mpgd.game.json

@@ -5,6 +5,9 @@
       "backgroundColor": "#0f172a"
     }
   },
+  "ui": {
+    "textSelection": "disabled"
+  },
   "acceptance": {
     "gameplay": {
       "schemaVersion": 1,

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

@@ -1,6 +1,16 @@
+import gameProjectConfig from '../mpgd.game.json';
+
 import { renderEntryFailure } from './runtime/renderEntryFailure';
+import {
+  installTextSelectionPolicy,
+  resolveTextSelectionMode,
+} from './platform/textSelection';
 
 try {
+  installTextSelectionPolicy(
+    resolveTextSelectionMode((gameProjectConfig as { readonly ui?: unknown }).ui),
+  );
+
   if (__APP_TARGET__ === 'reddit') {
     await import('./platform/devvitEntrypoint');
   } else {

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

@@ -1,6 +1,16 @@
+import gameProjectConfig from '../mpgd.game.json';
+
 import { renderEntryFailure } from './runtime/renderEntryFailure';
+import {
+  installTextSelectionPolicy,
+  resolveTextSelectionMode,
+} from './platform/textSelection';
 
 try {
+  installTextSelectionPolicy(
+    resolveTextSelectionMode((gameProjectConfig as { readonly ui?: unknown }).ui),
+  );
+
   await import('./main');
 } catch (error) {
   renderEntryFailure(error);

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

@@ -0,0 +1,121 @@
+/**
+ * Game-wide text selection policy.
+ *
+ * Games render tap targets, not documents, so text selection is disabled
+ * globally by default and re-enabled only for input fields and elements that
+ * explicitly opt in through {@link markSelectable}.
+ *
+ * Under the disabled policy the stylesheet layers, in ascending precedence:
+ * default suppression, editable contenteditable hosts (any value except
+ * explicit `false`, descendants included), explicit non-editable islands, and
+ * finally form fields plus the {@link selectableElementClassName} opt-in.
+ * All selectors are :where() normalized, so game CSS can still override the
+ * policy for bespoke elements.
+ */
+
+export type TextSelectionMode = 'disabled' | 'enabled';
+
+/** Class that re-enables text selection on an element and its descendants. */
+export const selectableElementClassName = 'mpgd-selectable';
+
+const textSelectionStylesheetId = 'mpgd-text-selection-policy';
+
+export interface SelectableElement {
+  readonly classList: {
+    add(...tokens: string[]): void;
+    remove(...tokens: string[]): void;
+    contains(token: string): boolean;
+  };
+}
+
+/** Parse the `ui.textSelection` game setting, defaulting to disabled. */
+export function resolveTextSelectionMode(uiConfig: unknown): TextSelectionMode {
+  if (uiConfig === undefined) {
+    return 'disabled';
+  }
+
+  if (typeof uiConfig !== 'object' || uiConfig === null || Array.isArray(uiConfig)) {
+    throw new Error('mpgd.game.json ui must be an object when present.');
+  }
+
+  for (const key of Object.keys(uiConfig)) {
+    if (key !== 'textSelection') {
+      throw new Error(`mpgd.game.json ui.${key} is not supported.`);
+    }
+  }
+
+  const textSelection = (uiConfig as Record<string, unknown>).textSelection;
+
+  if (textSelection === undefined) {
+    return 'disabled';
+  }
+
+  if (textSelection !== 'disabled' && textSelection !== 'enabled') {
+    throw new Error("mpgd.game.json ui.textSelection must be 'disabled' or 'enabled'.");
+  }
+
+  return textSelection;
+}
+
+/** Build the stylesheet that enforces the selection policy. */
+export function buildTextSelectionStylesheet(mode: TextSelectionMode): string {
+  if (mode === 'enabled') {
+    return '/* mpgd: text selection enabled; browser default applies. */\n';
+  }
+
+  // Every selector is wrapped in :where() so all rules share zero specificity
+  // and source order defines the precedence:
+  // default suppression < editable hosts < explicit non-editable islands
+  // < form fields and the selectable opt-in utility.
+  return [
+    '*, *::before, *::after {',
+    '  -webkit-user-select: none;',
+    '  user-select: none;',
+    '  -webkit-touch-callout: none;',
+    '}',
+    ":where([contenteditable]:not([contenteditable='false'])),",
+    ":where([contenteditable]:not([contenteditable='false'])) * {",
+    '  -webkit-user-select: text;',
+    '  user-select: text;',
+    '  -webkit-touch-callout: default;',
+    '}',
+    ":where([contenteditable='false']), :where([contenteditable='false']) * {",
+    '  -webkit-user-select: none;',
+    '  user-select: none;',
+    '  -webkit-touch-callout: none;',
+    '}',
+    `:where(input, textarea, .${selectableElementClassName}),`,
+    `:where(input, textarea, .${selectableElementClassName}) * {`,
+    '  -webkit-user-select: text;',
+    '  user-select: text;',
+    '  -webkit-touch-callout: default;',
+    '}',
+  ].join('\n');
+}
+
+/** Install (or refresh) the global selection policy stylesheet. */
+export function installTextSelectionPolicy(mode: TextSelectionMode): void {
+  if (typeof document === 'undefined') {
+    return;
+  }
+
+  let stylesheet = document.getElementById(textSelectionStylesheetId);
+
+  if (stylesheet === null) {
+    stylesheet = document.createElement('style');
+    stylesheet.id = textSelectionStylesheetId;
+    document.head.append(stylesheet);
+  }
+
+  stylesheet.textContent = buildTextSelectionStylesheet(mode);
+}
+
+/** Re-enable text selection for a specific UI element and its descendants. */
+export function markSelectable(element: SelectableElement): void {
+  element.classList.add(selectableElementClassName);
+}
+
+/** Withdraw a previous {@link markSelectable} opt-in. */
+export function unmarkSelectable(element: SelectableElement): void {
+  element.classList.remove(selectableElementClassName);
+}

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

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 import ttsc from '@ttsc/unplugin/vite';
 import type { PluginOption } from 'vite';
@@ -8,6 +9,7 @@ import {
   assertRuntimeTargetConfigMatrix,
   type TargetConfigMatrix,
 } from './vite.runtime-target-config';
+import { resolveTextSelectionMode } from './src/platform/textSelection';
 
 interface RuntimePlatformTargetMetadata {
   readonly kind: string;
@@ -39,9 +41,20 @@ export interface GameViteSharedConfig<SharedPluginOption> {
   readonly define: Record<string, string>;
 }
 
+/** Fail ordinary Vite builds when mpgd.game.json declares an invalid ui policy. */
+function readGameTextSelectionPolicy(): 'disabled' | 'enabled' {
+  const gameRoot = dirname(fileURLToPath(import.meta.url));
+  const gameConfig = JSON.parse(
+    readFileSync(resolve(gameRoot, 'mpgd.game.json'), 'utf8'),
+  ) as { readonly ui?: unknown };
+
+  return resolveTextSelectionMode(gameConfig.ui);
+}
+
 export function createGameViteSharedConfig<SharedPluginOption = PluginOption>(
   input: CreateGameViteSharedConfigInput,
 ): GameViteSharedConfig<SharedPluginOption> {
+  readGameTextSelectionPolicy();
   const isProduction = input.mode === 'production';
   const appTarget = input.appTarget ?? process.env.APP_TARGET ?? 'browser';
   const configTarget = input.configTarget ?? process.env.MPGD_CONFIG_TARGET ?? '';