@oasiz/sdk 1.5.6 → 1.6.1

package/README.md

@@ -13,7 +13,7 @@ Both talk to the same host bridges (`window.submitScore`, `__oasizLeaveGame`, la
 
 ## HTML5 / TypeScript (`@oasiz/sdk`)
 
-Typed SDK for integrating browser games with the Oasiz platform: score, haptics, cross-session state, multiplayer hooks, layout (safe area, leaderboard visibility), navigation (back / leave), and lifecycle events.
+Typed SDK for integrating browser games with the Oasiz platform: score, haptics, cross-session state, multiplayer hooks, layout (safe area, leaderboard visibility), graphics performance, navigation (back / leave), and lifecycle events.
 
 ### Install
 
@@ -44,13 +44,17 @@ document.documentElement.style.setProperty(
   `${oasiz.safeAreaTop}vh`,
 );
 
-// 5. Submit score when the game ends
+// 5. Pick graphics settings for this device
+const graphics = oasiz.getGraphicsPerformance();
+renderer.setPixelRatio(graphics.tier === "high" ? 1.5 : graphics.tier === "medium" ? 1.25 : 1);
+
+// 6. Submit score when the game ends
 oasiz.submitScore(score);
 
-// 6. Optionally hide the leaderboard while a custom overlay is open
+// 7. Optionally hide the leaderboard while a custom overlay is open
 oasiz.setLeaderboardVisible(false);
 
-// 7. Optionally surface console logs in-game while debugging
+// 8. Optionally surface console logs in-game while debugging
 oasiz.enableLogOverlay({
   enabled: new URLSearchParams(window.location.search).has("oasizLogs"),
   collapsed: true,
@@ -264,6 +268,40 @@ function closeCustomOverlay(): void {
 
 Unsupported hosts safely no-op.
 
+### Graphics performance
+
+#### `oasiz.getGraphicsPerformance(): GraphicsPerformanceMetric`
+
+Returns a recommended FPS target and suggested rendering tier:
+
+```ts
+const graphics = oasiz.getGraphicsPerformance();
+
+switch (graphics.tier) {
+  case "high":
+    enablePostProcessing();
+    renderer.setPixelRatio(1.5);
+    break;
+  case "medium":
+    renderer.setPixelRatio(1.25);
+    break;
+  case "low":
+    disableHeavyParticles();
+    renderer.setPixelRatio(1);
+    break;
+  case "minimal":
+    disableOptionalEffects();
+    renderer.setPixelRatio(0.75);
+    break;
+}
+```
+
+The returned object is `{ fps, tier }`, where `fps` is the recommended render target and `tier` is `"minimal"`, `"low"`, `"medium"`, or `"high"`. Hosts can inject measured values with `window.getGraphicsPerformance()` or `window.__OASIZ_GRAPHICS_PERFORMANCE__`; otherwise the SDK estimates from browser, device, and WebGL capability signals.
+
+#### `oasiz.graphicsPerformance`
+
+Getter alias for `getGraphicsPerformance()`.
+
 ### Lifecycle
 
 The platform dispatches lifecycle events when the app goes to the background or returns to the foreground. Subscribe to pause game loops and audio accordingly.
@@ -315,6 +353,29 @@ const offBack = oasiz.onBackButton(() => {
 offBack();
 ```
 
+#### `oasiz.enableBackButtonTesting(options?: BackButtonTestingOptions): BackButtonTestingHandle`
+
+Opt-in local web helper for testing back override behavior without the Oasiz app bridge. Call it before registering `onBackButton` in local development:
+
+```ts
+if (import.meta.env.DEV) {
+  oasiz.enableBackButtonTesting();
+}
+
+const offBack = oasiz.onBackButton(() => {
+  closePauseMenuOrOpenIt();
+});
+```
+
+While a back listener is active, the helper maps Escape to the same `oasiz:back` event the app sends. By default it also traps one browser-history entry so the browser Back button dispatches `oasiz:back` instead of leaving the page.
+
+```ts
+const backTest = oasiz.enableBackButtonTesting({ browserHistory: false });
+testBackButton.onclick = () => backTest.triggerBack();
+```
+
+The returned handle also exposes `triggerLeave()` and `destroy()`. This helper is for local/dev web testing; in the app, the real bridge still owns back behavior.
+
 #### `oasiz.leaveGame(): void`
 
 Programmatically request the host to close the current game (for example, from a Quit button inside your game UI).
@@ -421,6 +482,8 @@ import {
   shareRoomCode,
   openInviteModal,
   enableLogOverlay,
+  enableBackButtonTesting,
+  getGraphicsPerformance,
   getSafeAreaTop,
   getViewportInsets,
   setLeaderboardVisible,
@@ -440,7 +503,11 @@ import {
 
 ```ts
 import type {
+  BackButtonTestingHandle,
+  BackButtonTestingOptions,
   GameState,
+  GraphicsPerformanceMetric,
+  GraphicsPerformanceTier,
   HapticType,
   LogOverlayEntry,
   LogOverlayHandle,
@@ -486,6 +553,10 @@ public class GameManager : MonoBehaviour
         float safeTopPx = safeTopPct / 100f * Screen.height;
         Debug.Log($"Safe area top: {safeTopPx}px ({safeTopPct}% of height)");
 
+        // Pick visual settings for the current device
+        GraphicsPerformanceMetric graphics = OasizSDK.GetGraphicsPerformance();
+        Debug.Log($"Graphics tier: {graphics.tier} ({graphics.fps} FPS target)");
+
         // Emit score normalization anchors
         OasizSDK.EmitScoreConfig(new ScoreConfig(
             new ScoreAnchor(10, 100),
@@ -530,8 +601,10 @@ public class GameManager : MonoBehaviour
 | `oasiz.getViewportInsets()` / `viewportInsets` | `OasizSDK.GetViewportInsets()` (`ViewportInsets`, each side 0–100, % of matching viewport axis) |
 | `oasiz.getSafeAreaTop()` / `safeAreaTop` | `OasizSDK.GetSafeAreaTop()` / `OasizSDK.SafeAreaTop` (`float`, 0–100, % of viewport height; legacy alias for top viewport inset) |
 | `oasiz.setLeaderboardVisible(v)` | `OasizSDK.SetLeaderboardVisible(bool)` |
+| `oasiz.getGraphicsPerformance()` / `graphicsPerformance` | `OasizSDK.GetGraphicsPerformance()` / `OasizSDK.GraphicsPerformance` (`GraphicsPerformanceMetric`, recommended FPS plus `minimal` / `low` / `medium` / `high`) |
 | `oasiz.onPause` / `onResume` | `OasizSDK.OnPause` / `OnResume` static events |
 | `oasiz.onBackButton` | `OasizSDK.OnBackButton` or `SubscribeBackButton(Action)` (reference-counts `__oasizSetBackOverride`) |
+| `oasiz.enableBackButtonTesting()` | `OasizSDK.EnableBackButtonTesting()` (WebGL local/dev helper for Escape/browser Back testing) |
 | `oasiz.onLeaveGame` | `OasizSDK.OnLeaveGame` |
 | `oasiz.leaveGame()` | `OasizSDK.LeaveGame()` |
 | `oasiz.share(request)` | `OasizSDK.Share(ShareRequest)` |
@@ -542,6 +615,23 @@ public class GameManager : MonoBehaviour
 | `oasiz.enableLogOverlay` | `OasizSDK.EnableLogOverlay(LogOverlayOptions)` (see note below) |
 | -- | `OasizSDK.AppendLogOverlay(level, message, stackTrace)` (see note below) |
 
+### Local back-button testing (Unity WebGL)
+
+For local WebGL builds outside the Oasiz app, install the dev bridge before testing your subscribed back handler:
+
+```csharp
+#if DEVELOPMENT_BUILD || UNITY_EDITOR
+OasizSDK.EnableBackButtonTesting();
+#endif
+
+Action unsubscribeBack = OasizSDK.SubscribeBackButton(() =>
+{
+    TogglePauseMenu();
+});
+```
+
+While the override is active, Escape and the browser Back button dispatch the same `oasiz:back` event that the app bridge sends. You can disable either input with `OasizSDK.EnableBackButtonTesting(keyboard: false)` or `OasizSDK.EnableBackButtonTesting(browserHistory: false)`.
+
 ### Share (Unity)
 
 HTML5 **`oasiz.share`** returns a **Promise** you can `await`. Unity **`OasizSDK.Share(ShareRequest)`** returns **`void`**: C# validation throws **`ArgumentException`** with the same rules as TypeScript (at least one of text, score, or image; non-negative integer score; `http(s)` or `data:image/...;base64,...` image). The call forwards JSON to **`window.__oasizShareRequest`**. If the host promise rejects, the **WebGL `.jslib` logs the error** to the browser console.

package/dist/index.cjs

@@ -21,9 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   addScore: () => addScore,
+  enableBackButtonTesting: () => enableBackButtonTesting,
   enableLogOverlay: () => enableLogOverlay,
   flushGameState: () => flushGameState,
   getGameId: () => getGameId,
+  getGraphicsPerformance: () => getGraphicsPerformance,
   getPlayerAvatar: () => getPlayerAvatar,
   getPlayerCharacter: () => getPlayerCharacter,
   getPlayerId: () => getPlayerId,
@@ -1628,7 +1630,9 @@ function setLeaderboardVisible(visible) {
 }
 
 // src/navigation.ts
+var BACK_BUTTON_TEST_STATE_KEY = "__oasizBackButtonTest";
 var activeBackListeners = 0;
+var activeBackButtonTestingHandle;
 function isDevelopment10() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
@@ -1654,6 +1658,16 @@ function normalizeNavigationError(error) {
     typeof error === "string" ? error : "Back button callback failed."
   );
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function dispatchNavigationEvent(eventName) {
+  const bridge = getBridgeWindow9();
+  if (!bridge || typeof bridge.dispatchEvent !== "function") {
+    return;
+  }
+  bridge.dispatchEvent(new Event(eventName));
+}
 function addNavigationListener(eventName, callback) {
   if (typeof window === "undefined") {
     if (isDevelopment10()) {
@@ -1668,6 +1682,151 @@ function addNavigationListener(eventName, callback) {
   window.addEventListener(eventName, handler);
   return () => window.removeEventListener(eventName, handler);
 }
+function enableBackButtonTesting(options = {}) {
+  activeBackButtonTestingHandle?.destroy();
+  const bridge = getBridgeWindow9();
+  if (!bridge) {
+    if (isDevelopment10()) {
+      console.warn(
+        "[oasiz/sdk] enableBackButtonTesting requires a browser window."
+      );
+    }
+    return {
+      destroy: () => {
+      },
+      isBackOverrideActive: () => false,
+      triggerBack: () => {
+      },
+      triggerLeave: () => {
+      }
+    };
+  }
+  const bridgeWindow = bridge;
+  const keyboard = options.keyboard ?? true;
+  const browserHistory = options.browserHistory ?? true;
+  const log = options.log === true;
+  const previousSetBackOverride = bridgeWindow.__oasizSetBackOverride;
+  const previousLeaveGame = bridgeWindow.__oasizLeaveGame;
+  let destroyed = false;
+  let backOverrideActive = false;
+  let historyTrapArmed = false;
+  function maybeLog(message) {
+    if (log) {
+      console.info("[oasiz/sdk] " + message);
+    }
+  }
+  function canUseHistoryTrap() {
+    return browserHistory && typeof bridgeWindow.history?.pushState === "function" && typeof bridgeWindow.history?.replaceState === "function" && typeof bridgeWindow.location?.href === "string";
+  }
+  function ensureHistoryTrap() {
+    if (!backOverrideActive || historyTrapArmed || !canUseHistoryTrap()) {
+      return;
+    }
+    try {
+      const currentState = isRecord2(bridgeWindow.history.state) ? bridgeWindow.history.state : {};
+      bridgeWindow.history.replaceState(
+        { ...currentState, [BACK_BUTTON_TEST_STATE_KEY]: "base" },
+        "",
+        bridgeWindow.location.href
+      );
+      bridgeWindow.history.pushState(
+        { [BACK_BUTTON_TEST_STATE_KEY]: "trap" },
+        "",
+        bridgeWindow.location.href
+      );
+      historyTrapArmed = true;
+      maybeLog("Local browser Back testing is armed.");
+    } catch (error) {
+      historyTrapArmed = false;
+      if (log) {
+        console.warn("[oasiz/sdk] Failed to arm browser Back testing:", error);
+      }
+    }
+  }
+  function triggerBack() {
+    dispatchNavigationEvent("oasiz:back");
+  }
+  function triggerLeave() {
+    dispatchNavigationEvent("oasiz:leave");
+  }
+  function setBackOverride(active) {
+    backOverrideActive = active;
+    if (active) {
+      ensureHistoryTrap();
+    }
+    if (typeof previousSetBackOverride === "function") {
+      previousSetBackOverride(active);
+    }
+    maybeLog("Back override " + (active ? "enabled" : "disabled") + ".");
+  }
+  function stopBackEvent(event) {
+    event.preventDefault();
+    event.stopPropagation();
+    event.stopImmediatePropagation?.();
+  }
+  const handleKeyDown = (event) => {
+    if (!backOverrideActive || event.key !== "Escape") {
+      return;
+    }
+    stopBackEvent(event);
+    triggerBack();
+  };
+  const handlePopState = (event) => {
+    if (!backOverrideActive) {
+      historyTrapArmed = false;
+      return;
+    }
+    stopBackEvent(event);
+    triggerBack();
+    historyTrapArmed = false;
+    ensureHistoryTrap();
+  };
+  const testLeaveGame = () => {
+    triggerLeave();
+    if (typeof previousLeaveGame === "function") {
+      previousLeaveGame();
+    }
+  };
+  bridgeWindow.__oasizSetBackOverride = setBackOverride;
+  bridgeWindow.__oasizLeaveGame = testLeaveGame;
+  if (keyboard) {
+    bridgeWindow.addEventListener("keydown", handleKeyDown);
+  }
+  if (browserHistory) {
+    bridgeWindow.addEventListener("popstate", handlePopState);
+  }
+  if (activeBackListeners > 0) {
+    setBackOverride(true);
+  }
+  maybeLog("Back button testing bridge installed.");
+  const handle = {
+    destroy: () => {
+      if (destroyed) return;
+      destroyed = true;
+      if (keyboard) {
+        bridgeWindow.removeEventListener("keydown", handleKeyDown);
+      }
+      if (browserHistory) {
+        bridgeWindow.removeEventListener("popstate", handlePopState);
+      }
+      if (bridgeWindow.__oasizSetBackOverride === setBackOverride) {
+        bridgeWindow.__oasizSetBackOverride = previousSetBackOverride;
+      }
+      if (bridgeWindow.__oasizLeaveGame === testLeaveGame) {
+        bridgeWindow.__oasizLeaveGame = previousLeaveGame;
+      }
+      if (activeBackButtonTestingHandle === handle) {
+        activeBackButtonTestingHandle = void 0;
+      }
+      maybeLog("Back button testing bridge removed.");
+    },
+    isBackOverrideActive: () => backOverrideActive,
+    triggerBack,
+    triggerLeave
+  };
+  activeBackButtonTestingHandle = handle;
+  return handle;
+}
 function onBackButton(callback) {
   const off = addNavigationListener("oasiz:back", () => {
     try {
@@ -1711,6 +1870,329 @@ function leaveGame() {
   warnMissingBridge7("__oasizLeaveGame");
 }
 
+// src/performance.ts
+var DEFAULT_GRAPHICS_PERFORMANCE = {
+  fps: 45,
+  tier: "medium"
+};
+var TIER_DEFAULT_FPS = {
+  minimal: 24,
+  low: 30,
+  medium: 45,
+  high: 60
+};
+var cachedEstimatedGraphicsPerformance;
+function getBridgeWindow10() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window;
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null;
+}
+function toFiniteNumber2(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string") {
+    const parsed = Number.parseFloat(value.trim());
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return void 0;
+}
+function clampScore(value) {
+  return Math.min(100, Math.max(0, Math.round(value)));
+}
+function clampFps(value) {
+  return Math.min(240, Math.max(1, Math.round(value)));
+}
+function tierFromScore(score) {
+  if (score < 25) return "minimal";
+  if (score < 40) return "low";
+  if (score < 70) return "medium";
+  return "high";
+}
+function tierFromFps(fps) {
+  if (fps < 30) return "minimal";
+  if (fps < 45) return "low";
+  if (fps < 58) return "medium";
+  return "high";
+}
+function fpsFromScore(score) {
+  return TIER_DEFAULT_FPS[tierFromScore(score)];
+}
+function normalizeTier(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "minimal" || normalized === "safe") return "minimal";
+  if (normalized === "high") return "high";
+  if (normalized === "medium") return "medium";
+  if (normalized === "low") return "low";
+  return void 0;
+}
+function firstDefined2(...values) {
+  return values.find((value) => typeof value !== "undefined");
+}
+function normalizeMetric(value) {
+  if (typeof value === "undefined" || value === null) {
+    return void 0;
+  }
+  if (typeof value === "number" || typeof value === "string") {
+    const numeric = toFiniteNumber2(value);
+    if (typeof numeric !== "undefined") {
+      const fps2 = clampFps(numeric);
+      return { fps: fps2, tier: tierFromFps(fps2) };
+    }
+    const tier2 = normalizeTier(value);
+    if (tier2) {
+      return { fps: TIER_DEFAULT_FPS[tier2], tier: tier2 };
+    }
+    return void 0;
+  }
+  if (!isRecord3(value)) {
+    return void 0;
+  }
+  const fpsCandidate = firstDefined2(
+    value.fps,
+    value.targetFps,
+    value.frameRate,
+    value.framesPerSecond
+  );
+  const legacyScoreCandidate = firstDefined2(
+    value.score,
+    value.metric,
+    value.value,
+    value.performance,
+    value.performanceScore,
+    value.graphicsScore
+  );
+  const tierCandidate = firstDefined2(
+    value.tier,
+    value.graphicsTier,
+    value.performanceTier,
+    value.qualityTier,
+    value.recommendedTier
+  );
+  const tier = normalizeTier(tierCandidate);
+  const fpsNumeric = toFiniteNumber2(fpsCandidate);
+  const scoreNumeric = toFiniteNumber2(legacyScoreCandidate);
+  if (typeof fpsNumeric === "undefined" && typeof scoreNumeric === "undefined" && !tier) {
+    return void 0;
+  }
+  const fps = clampFps(
+    typeof fpsNumeric !== "undefined" ? fpsNumeric : typeof scoreNumeric !== "undefined" ? fpsFromScore(clampScore(scoreNumeric)) : TIER_DEFAULT_FPS[tier]
+  );
+  return {
+    fps,
+    tier: tier ?? tierFromFps(fps)
+  };
+}
+function callBridgeMetric(bridge, name) {
+  const fn = bridge[name];
+  if (typeof fn !== "function") {
+    return void 0;
+  }
+  try {
+    return fn.call(bridge);
+  } catch (error) {
+    console.error("[oasiz/sdk] " + String(name) + " failed:", error);
+    return void 0;
+  }
+}
+function readHostGraphicsPerformance(bridge) {
+  const candidates = [
+    callBridgeMetric(bridge, "getGraphicsPerformance"),
+    callBridgeMetric(bridge, "getGraphicsPerformanceMetric"),
+    callBridgeMetric(bridge, "getPerformanceMetric"),
+    bridge.__OASIZ_GRAPHICS_PERFORMANCE__,
+    bridge.__OASIZ_PERFORMANCE_METRIC__
+  ];
+  for (const candidate of candidates) {
+    const metric = normalizeMetric(candidate);
+    if (metric) {
+      return metric;
+    }
+  }
+  return void 0;
+}
+function getDevicePixelRatio2(bridge) {
+  const dpr = bridge.devicePixelRatio;
+  return typeof dpr === "number" && Number.isFinite(dpr) && dpr > 0 ? dpr : 1;
+}
+function getNavigatorValue(bridge) {
+  return bridge.navigator;
+}
+function parseIosMajorVersion(userAgent) {
+  const match = /\bOS (\d+)_/i.exec(userAgent);
+  if (!match) {
+    return void 0;
+  }
+  const parsed = Number.parseInt(match[1] ?? "", 10);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function isAppleMobileDevice(bridge) {
+  const userAgent = bridge.navigator?.userAgent ?? "";
+  return /iP(hone|ad|od)/i.test(userAgent) || /Macintosh/i.test(userAgent) && (bridge.navigator?.maxTouchPoints ?? 0) > 1;
+}
+function getLongestScreenEdge(bridge) {
+  const screenWidth = bridge.screen?.width;
+  const screenHeight = bridge.screen?.height;
+  const innerWidth = bridge.innerWidth;
+  const innerHeight = bridge.innerHeight;
+  return Math.max(
+    typeof screenWidth === "number" ? screenWidth : 0,
+    typeof screenHeight === "number" ? screenHeight : 0,
+    typeof innerWidth === "number" ? innerWidth : 0,
+    typeof innerHeight === "number" ? innerHeight : 0
+  );
+}
+function isCoarsePointer(bridge) {
+  try {
+    return bridge.matchMedia?.("(pointer: coarse)").matches === true;
+  } catch {
+    return false;
+  }
+}
+function getWebGlInfo(bridge) {
+  const canvas = bridge.document?.createElement?.("canvas");
+  if (!canvas || typeof canvas.getContext !== "function") {
+    return { webglVersion: 0 };
+  }
+  const gl2 = canvas.getContext("webgl2");
+  const gl = gl2 ?? canvas.getContext("webgl") ?? canvas.getContext("experimental-webgl");
+  if (!gl) {
+    return { webglVersion: 0 };
+  }
+  const context = gl;
+  let maxTextureSize;
+  let renderer;
+  try {
+    const value = context.getParameter(context.MAX_TEXTURE_SIZE);
+    if (typeof value === "number" && Number.isFinite(value)) {
+      maxTextureSize = value;
+    }
+  } catch {
+  }
+  try {
+    const debugInfo = context.getExtension("WEBGL_debug_renderer_info");
+    const rendererParam = debugInfo?.UNMASKED_RENDERER_WEBGL ?? context.RENDERER;
+    const value = context.getParameter(rendererParam);
+    if (typeof value === "string") {
+      renderer = value;
+    }
+  } catch {
+  }
+  return {
+    maxTextureSize,
+    renderer,
+    webglVersion: gl2 ? 2 : 1
+  };
+}
+function applyMemoryScore(score, memory) {
+  if (typeof memory !== "number" || !Number.isFinite(memory) || memory <= 0) {
+    return score;
+  }
+  if (memory <= 1) return score - 18;
+  if (memory <= 2) return score - 10;
+  if (memory >= 8) return score + 16;
+  if (memory >= 6) return score + 10;
+  return score;
+}
+function applyCoreScore(score, cores) {
+  if (typeof cores !== "number" || !Number.isFinite(cores) || cores <= 0) {
+    return score;
+  }
+  if (cores <= 2) return score - 12;
+  if (cores <= 4) return score;
+  if (cores >= 8) return score + 12;
+  return score + 8;
+}
+function applyWebGlScore(score, info) {
+  let next = score;
+  if (info.webglVersion === 2) {
+    next += 16;
+  } else if (info.webglVersion === 1) {
+    next += 6;
+  } else {
+    next -= 25;
+  }
+  if (typeof info.maxTextureSize === "number") {
+    if (info.maxTextureSize >= 8192) next += 10;
+    else if (info.maxTextureSize >= 4096) next += 3;
+    else next -= 8;
+  }
+  const renderer = info.renderer?.toLowerCase() ?? "";
+  if (/swiftshader|llvmpipe|software/.test(renderer)) {
+    next = Math.min(next, 35);
+  } else if (/\bm[1-9]\b|apple gpu|a1[6-9]|rtx|radeon|adreno 7|adreno 8/.test(renderer)) {
+    next += 8;
+  }
+  return next;
+}
+function applyMobileCostScore(score, bridge) {
+  if (!isCoarsePointer(bridge)) {
+    return score;
+  }
+  const dpr = getDevicePixelRatio2(bridge);
+  const width = bridge.screen?.width ?? bridge.innerWidth ?? 0;
+  const height = bridge.screen?.height ?? bridge.innerHeight ?? 0;
+  const physicalPixels = width * height * dpr * dpr;
+  if (physicalPixels > 4e6) {
+    return score - 5;
+  }
+  return score;
+}
+function applyAppleMobileRules(score, bridge) {
+  if (!isAppleMobileDevice(bridge)) {
+    return score;
+  }
+  const userAgent = bridge.navigator?.userAgent ?? "";
+  const iosMajorVersion = parseIosMajorVersion(userAgent);
+  const highDensityDisplay = getDevicePixelRatio2(bridge) >= 3;
+  const longestScreenEdge = getLongestScreenEdge(bridge);
+  if (typeof iosMajorVersion === "number" && iosMajorVersion < 15) {
+    return Math.min(score, 35);
+  }
+  if (highDensityDisplay && longestScreenEdge >= 430 && (typeof iosMajorVersion === "undefined" || iosMajorVersion >= 17)) {
+    return Math.max(score, 78);
+  }
+  if (highDensityDisplay && longestScreenEdge >= 414 && (typeof iosMajorVersion === "undefined" || iosMajorVersion >= 16)) {
+    return Math.max(score, 62);
+  }
+  return Math.min(score, 48);
+}
+function estimateGraphicsPerformance(bridge) {
+  const navigatorValue = getNavigatorValue(bridge);
+  let score = 45;
+  score = applyMemoryScore(score, navigatorValue?.deviceMemory);
+  score = applyCoreScore(score, navigatorValue?.hardwareConcurrency);
+  score = applyWebGlScore(score, getWebGlInfo(bridge));
+  score = applyMobileCostScore(score, bridge);
+  score = applyAppleMobileRules(score, bridge);
+  const normalizedScore = clampScore(score);
+  return {
+    fps: fpsFromScore(normalizedScore),
+    tier: tierFromScore(normalizedScore)
+  };
+}
+function getGraphicsPerformance() {
+  const bridge = getBridgeWindow10();
+  if (!bridge) {
+    return { ...DEFAULT_GRAPHICS_PERFORMANCE };
+  }
+  const hostMetric = readHostGraphicsPerformance(bridge);
+  if (hostMetric) {
+    return hostMetric;
+  }
+  cachedEstimatedGraphicsPerformance ??= estimateGraphicsPerformance(bridge);
+  return { ...cachedEstimatedGraphicsPerformance };
+}
+
 // src/index.ts
 var oasiz = {
   submitScore,
@@ -1730,6 +2212,8 @@ var oasiz = {
   getSafeAreaTop,
   getViewportInsets,
   setLeaderboardVisible,
+  getGraphicsPerformance,
+  enableBackButtonTesting,
   onBackButton,
   onLeaveGame,
   leaveGame,
@@ -1753,14 +2237,19 @@ var oasiz = {
   },
   get viewportInsets() {
     return getViewportInsets();
+  },
+  get graphicsPerformance() {
+    return getGraphicsPerformance();
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   addScore,
+  enableBackButtonTesting,
   enableLogOverlay,
   flushGameState,
   getGameId,
+  getGraphicsPerformance,
   getPlayerAvatar,
   getPlayerCharacter,
   getPlayerId,

package/dist/index.d.cts

@@ -1,3 +1,21 @@
+type GraphicsPerformanceTier = "minimal" | "low" | "medium" | "high";
+interface GraphicsPerformanceMetric {
+    /** Recommended graphics/rendering frame-rate target for the current device. */
+    fps: number;
+    /** Suggested graphics/rendering tier for the current device. */
+    tier: GraphicsPerformanceTier;
+}
+/**
+ * Return the current device's recommended graphics performance profile.
+ *
+ * Hosts can provide an FPS/tier recommendation through
+ * `window.getGraphicsPerformance()` or `window.__OASIZ_GRAPHICS_PERFORMANCE__`.
+ * When no host value exists, the SDK estimates from browser/device/WebGL
+ * capability signals so games still get a usable recommendation in local
+ * development and unsupported hosts.
+ */
+declare function getGraphicsPerformance(): GraphicsPerformanceMetric;
+
 type ViewportInsetSide = "top" | "right" | "bottom" | "left";
 interface ViewportInsetEdges {
     top: number;
@@ -221,6 +239,28 @@ type Unsubscribe = () => void;
 declare function onPause(callback: () => void): Unsubscribe;
 declare function onResume(callback: () => void): Unsubscribe;
 
+interface BackButtonTestingOptions {
+    /**
+     * When true, pressing Escape dispatches the same event the host app sends for
+     * back actions. Defaults to true.
+     */
+    keyboard?: boolean;
+    /**
+     * When true, the SDK traps one browser-history entry while back override is
+     * active, so the browser Back button can be used for local testing. Defaults
+     * to true.
+     */
+    browserHistory?: boolean;
+    /** Log setup details to the console. Defaults to false. */
+    log?: boolean;
+}
+interface BackButtonTestingHandle {
+    destroy: () => void;
+    isBackOverrideActive: () => boolean;
+    triggerBack: () => void;
+    triggerLeave: () => void;
+}
+declare function enableBackButtonTesting(options?: BackButtonTestingOptions): BackButtonTestingHandle;
 declare function onBackButton(callback: () => void): Unsubscribe;
 declare function onLeaveGame(callback: () => void): Unsubscribe;
 declare function leaveGame(): void;
@@ -243,6 +283,8 @@ declare const oasiz: {
     getSafeAreaTop: typeof getSafeAreaTop;
     getViewportInsets: typeof getViewportInsets;
     setLeaderboardVisible: typeof setLeaderboardVisible;
+    getGraphicsPerformance: typeof getGraphicsPerformance;
+    enableBackButtonTesting: typeof enableBackButtonTesting;
     onBackButton: typeof onBackButton;
     onLeaveGame: typeof onLeaveGame;
     leaveGame: typeof leaveGame;
@@ -253,6 +295,7 @@ declare const oasiz: {
     readonly playerAvatar: string | undefined;
     readonly safeAreaTop: number;
     readonly viewportInsets: ViewportInsets;
+    readonly graphicsPerformance: GraphicsPerformanceMetric;
 };
 
-export { type FacingFrameMap, type GameState, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableLogOverlay, flushGameState, getGameId, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };
+export { type BackButtonTestingHandle, type BackButtonTestingOptions, type FacingFrameMap, type GameState, type GraphicsPerformanceMetric, type GraphicsPerformanceTier, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableBackButtonTesting, enableLogOverlay, flushGameState, getGameId, getGraphicsPerformance, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.d.ts

@@ -1,3 +1,21 @@
+type GraphicsPerformanceTier = "minimal" | "low" | "medium" | "high";
+interface GraphicsPerformanceMetric {
+    /** Recommended graphics/rendering frame-rate target for the current device. */
+    fps: number;
+    /** Suggested graphics/rendering tier for the current device. */
+    tier: GraphicsPerformanceTier;
+}
+/**
+ * Return the current device's recommended graphics performance profile.
+ *
+ * Hosts can provide an FPS/tier recommendation through
+ * `window.getGraphicsPerformance()` or `window.__OASIZ_GRAPHICS_PERFORMANCE__`.
+ * When no host value exists, the SDK estimates from browser/device/WebGL
+ * capability signals so games still get a usable recommendation in local
+ * development and unsupported hosts.
+ */
+declare function getGraphicsPerformance(): GraphicsPerformanceMetric;
+
 type ViewportInsetSide = "top" | "right" | "bottom" | "left";
 interface ViewportInsetEdges {
     top: number;
@@ -221,6 +239,28 @@ type Unsubscribe = () => void;
 declare function onPause(callback: () => void): Unsubscribe;
 declare function onResume(callback: () => void): Unsubscribe;
 
+interface BackButtonTestingOptions {
+    /**
+     * When true, pressing Escape dispatches the same event the host app sends for
+     * back actions. Defaults to true.
+     */
+    keyboard?: boolean;
+    /**
+     * When true, the SDK traps one browser-history entry while back override is
+     * active, so the browser Back button can be used for local testing. Defaults
+     * to true.
+     */
+    browserHistory?: boolean;
+    /** Log setup details to the console. Defaults to false. */
+    log?: boolean;
+}
+interface BackButtonTestingHandle {
+    destroy: () => void;
+    isBackOverrideActive: () => boolean;
+    triggerBack: () => void;
+    triggerLeave: () => void;
+}
+declare function enableBackButtonTesting(options?: BackButtonTestingOptions): BackButtonTestingHandle;
 declare function onBackButton(callback: () => void): Unsubscribe;
 declare function onLeaveGame(callback: () => void): Unsubscribe;
 declare function leaveGame(): void;
@@ -243,6 +283,8 @@ declare const oasiz: {
     getSafeAreaTop: typeof getSafeAreaTop;
     getViewportInsets: typeof getViewportInsets;
     setLeaderboardVisible: typeof setLeaderboardVisible;
+    getGraphicsPerformance: typeof getGraphicsPerformance;
+    enableBackButtonTesting: typeof enableBackButtonTesting;
     onBackButton: typeof onBackButton;
     onLeaveGame: typeof onLeaveGame;
     leaveGame: typeof leaveGame;
@@ -253,6 +295,7 @@ declare const oasiz: {
     readonly playerAvatar: string | undefined;
     readonly safeAreaTop: number;
     readonly viewportInsets: ViewportInsets;
+    readonly graphicsPerformance: GraphicsPerformanceMetric;
 };
 
-export { type FacingFrameMap, type GameState, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableLogOverlay, flushGameState, getGameId, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };
+export { type BackButtonTestingHandle, type BackButtonTestingOptions, type FacingFrameMap, type GameState, type GraphicsPerformanceMetric, type GraphicsPerformanceTier, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableBackButtonTesting, enableLogOverlay, flushGameState, getGameId, getGraphicsPerformance, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.js

@@ -1577,7 +1577,9 @@ function setLeaderboardVisible(visible) {
 }
 
 // src/navigation.ts
+var BACK_BUTTON_TEST_STATE_KEY = "__oasizBackButtonTest";
 var activeBackListeners = 0;
+var activeBackButtonTestingHandle;
 function isDevelopment10() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
@@ -1603,6 +1605,16 @@ function normalizeNavigationError(error) {
     typeof error === "string" ? error : "Back button callback failed."
   );
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function dispatchNavigationEvent(eventName) {
+  const bridge = getBridgeWindow9();
+  if (!bridge || typeof bridge.dispatchEvent !== "function") {
+    return;
+  }
+  bridge.dispatchEvent(new Event(eventName));
+}
 function addNavigationListener(eventName, callback) {
   if (typeof window === "undefined") {
     if (isDevelopment10()) {
@@ -1617,6 +1629,151 @@ function addNavigationListener(eventName, callback) {
   window.addEventListener(eventName, handler);
   return () => window.removeEventListener(eventName, handler);
 }
+function enableBackButtonTesting(options = {}) {
+  activeBackButtonTestingHandle?.destroy();
+  const bridge = getBridgeWindow9();
+  if (!bridge) {
+    if (isDevelopment10()) {
+      console.warn(
+        "[oasiz/sdk] enableBackButtonTesting requires a browser window."
+      );
+    }
+    return {
+      destroy: () => {
+      },
+      isBackOverrideActive: () => false,
+      triggerBack: () => {
+      },
+      triggerLeave: () => {
+      }
+    };
+  }
+  const bridgeWindow = bridge;
+  const keyboard = options.keyboard ?? true;
+  const browserHistory = options.browserHistory ?? true;
+  const log = options.log === true;
+  const previousSetBackOverride = bridgeWindow.__oasizSetBackOverride;
+  const previousLeaveGame = bridgeWindow.__oasizLeaveGame;
+  let destroyed = false;
+  let backOverrideActive = false;
+  let historyTrapArmed = false;
+  function maybeLog(message) {
+    if (log) {
+      console.info("[oasiz/sdk] " + message);
+    }
+  }
+  function canUseHistoryTrap() {
+    return browserHistory && typeof bridgeWindow.history?.pushState === "function" && typeof bridgeWindow.history?.replaceState === "function" && typeof bridgeWindow.location?.href === "string";
+  }
+  function ensureHistoryTrap() {
+    if (!backOverrideActive || historyTrapArmed || !canUseHistoryTrap()) {
+      return;
+    }
+    try {
+      const currentState = isRecord2(bridgeWindow.history.state) ? bridgeWindow.history.state : {};
+      bridgeWindow.history.replaceState(
+        { ...currentState, [BACK_BUTTON_TEST_STATE_KEY]: "base" },
+        "",
+        bridgeWindow.location.href
+      );
+      bridgeWindow.history.pushState(
+        { [BACK_BUTTON_TEST_STATE_KEY]: "trap" },
+        "",
+        bridgeWindow.location.href
+      );
+      historyTrapArmed = true;
+      maybeLog("Local browser Back testing is armed.");
+    } catch (error) {
+      historyTrapArmed = false;
+      if (log) {
+        console.warn("[oasiz/sdk] Failed to arm browser Back testing:", error);
+      }
+    }
+  }
+  function triggerBack() {
+    dispatchNavigationEvent("oasiz:back");
+  }
+  function triggerLeave() {
+    dispatchNavigationEvent("oasiz:leave");
+  }
+  function setBackOverride(active) {
+    backOverrideActive = active;
+    if (active) {
+      ensureHistoryTrap();
+    }
+    if (typeof previousSetBackOverride === "function") {
+      previousSetBackOverride(active);
+    }
+    maybeLog("Back override " + (active ? "enabled" : "disabled") + ".");
+  }
+  function stopBackEvent(event) {
+    event.preventDefault();
+    event.stopPropagation();
+    event.stopImmediatePropagation?.();
+  }
+  const handleKeyDown = (event) => {
+    if (!backOverrideActive || event.key !== "Escape") {
+      return;
+    }
+    stopBackEvent(event);
+    triggerBack();
+  };
+  const handlePopState = (event) => {
+    if (!backOverrideActive) {
+      historyTrapArmed = false;
+      return;
+    }
+    stopBackEvent(event);
+    triggerBack();
+    historyTrapArmed = false;
+    ensureHistoryTrap();
+  };
+  const testLeaveGame = () => {
+    triggerLeave();
+    if (typeof previousLeaveGame === "function") {
+      previousLeaveGame();
+    }
+  };
+  bridgeWindow.__oasizSetBackOverride = setBackOverride;
+  bridgeWindow.__oasizLeaveGame = testLeaveGame;
+  if (keyboard) {
+    bridgeWindow.addEventListener("keydown", handleKeyDown);
+  }
+  if (browserHistory) {
+    bridgeWindow.addEventListener("popstate", handlePopState);
+  }
+  if (activeBackListeners > 0) {
+    setBackOverride(true);
+  }
+  maybeLog("Back button testing bridge installed.");
+  const handle = {
+    destroy: () => {
+      if (destroyed) return;
+      destroyed = true;
+      if (keyboard) {
+        bridgeWindow.removeEventListener("keydown", handleKeyDown);
+      }
+      if (browserHistory) {
+        bridgeWindow.removeEventListener("popstate", handlePopState);
+      }
+      if (bridgeWindow.__oasizSetBackOverride === setBackOverride) {
+        bridgeWindow.__oasizSetBackOverride = previousSetBackOverride;
+      }
+      if (bridgeWindow.__oasizLeaveGame === testLeaveGame) {
+        bridgeWindow.__oasizLeaveGame = previousLeaveGame;
+      }
+      if (activeBackButtonTestingHandle === handle) {
+        activeBackButtonTestingHandle = void 0;
+      }
+      maybeLog("Back button testing bridge removed.");
+    },
+    isBackOverrideActive: () => backOverrideActive,
+    triggerBack,
+    triggerLeave
+  };
+  activeBackButtonTestingHandle = handle;
+  return handle;
+}
 function onBackButton(callback) {
   const off = addNavigationListener("oasiz:back", () => {
     try {
@@ -1660,6 +1817,329 @@ function leaveGame() {
   warnMissingBridge7("__oasizLeaveGame");
 }
 
+// src/performance.ts
+var DEFAULT_GRAPHICS_PERFORMANCE = {
+  fps: 45,
+  tier: "medium"
+};
+var TIER_DEFAULT_FPS = {
+  minimal: 24,
+  low: 30,
+  medium: 45,
+  high: 60
+};
+var cachedEstimatedGraphicsPerformance;
+function getBridgeWindow10() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window;
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null;
+}
+function toFiniteNumber2(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string") {
+    const parsed = Number.parseFloat(value.trim());
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return void 0;
+}
+function clampScore(value) {
+  return Math.min(100, Math.max(0, Math.round(value)));
+}
+function clampFps(value) {
+  return Math.min(240, Math.max(1, Math.round(value)));
+}
+function tierFromScore(score) {
+  if (score < 25) return "minimal";
+  if (score < 40) return "low";
+  if (score < 70) return "medium";
+  return "high";
+}
+function tierFromFps(fps) {
+  if (fps < 30) return "minimal";
+  if (fps < 45) return "low";
+  if (fps < 58) return "medium";
+  return "high";
+}
+function fpsFromScore(score) {
+  return TIER_DEFAULT_FPS[tierFromScore(score)];
+}
+function normalizeTier(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "minimal" || normalized === "safe") return "minimal";
+  if (normalized === "high") return "high";
+  if (normalized === "medium") return "medium";
+  if (normalized === "low") return "low";
+  return void 0;
+}
+function firstDefined2(...values) {
+  return values.find((value) => typeof value !== "undefined");
+}
+function normalizeMetric(value) {
+  if (typeof value === "undefined" || value === null) {
+    return void 0;
+  }
+  if (typeof value === "number" || typeof value === "string") {
+    const numeric = toFiniteNumber2(value);
+    if (typeof numeric !== "undefined") {
+      const fps2 = clampFps(numeric);
+      return { fps: fps2, tier: tierFromFps(fps2) };
+    }
+    const tier2 = normalizeTier(value);
+    if (tier2) {
+      return { fps: TIER_DEFAULT_FPS[tier2], tier: tier2 };
+    }
+    return void 0;
+  }
+  if (!isRecord3(value)) {
+    return void 0;
+  }
+  const fpsCandidate = firstDefined2(
+    value.fps,
+    value.targetFps,
+    value.frameRate,
+    value.framesPerSecond
+  );
+  const legacyScoreCandidate = firstDefined2(
+    value.score,
+    value.metric,
+    value.value,
+    value.performance,
+    value.performanceScore,
+    value.graphicsScore
+  );
+  const tierCandidate = firstDefined2(
+    value.tier,
+    value.graphicsTier,
+    value.performanceTier,
+    value.qualityTier,
+    value.recommendedTier
+  );
+  const tier = normalizeTier(tierCandidate);
+  const fpsNumeric = toFiniteNumber2(fpsCandidate);
+  const scoreNumeric = toFiniteNumber2(legacyScoreCandidate);
+  if (typeof fpsNumeric === "undefined" && typeof scoreNumeric === "undefined" && !tier) {
+    return void 0;
+  }
+  const fps = clampFps(
+    typeof fpsNumeric !== "undefined" ? fpsNumeric : typeof scoreNumeric !== "undefined" ? fpsFromScore(clampScore(scoreNumeric)) : TIER_DEFAULT_FPS[tier]
+  );
+  return {
+    fps,
+    tier: tier ?? tierFromFps(fps)
+  };
+}
+function callBridgeMetric(bridge, name) {
+  const fn = bridge[name];
+  if (typeof fn !== "function") {
+    return void 0;
+  }
+  try {
+    return fn.call(bridge);
+  } catch (error) {
+    console.error("[oasiz/sdk] " + String(name) + " failed:", error);
+    return void 0;
+  }
+}
+function readHostGraphicsPerformance(bridge) {
+  const candidates = [
+    callBridgeMetric(bridge, "getGraphicsPerformance"),
+    callBridgeMetric(bridge, "getGraphicsPerformanceMetric"),
+    callBridgeMetric(bridge, "getPerformanceMetric"),
+    bridge.__OASIZ_GRAPHICS_PERFORMANCE__,
+    bridge.__OASIZ_PERFORMANCE_METRIC__
+  ];
+  for (const candidate of candidates) {
+    const metric = normalizeMetric(candidate);
+    if (metric) {
+      return metric;
+    }
+  }
+  return void 0;
+}
+function getDevicePixelRatio2(bridge) {
+  const dpr = bridge.devicePixelRatio;
+  return typeof dpr === "number" && Number.isFinite(dpr) && dpr > 0 ? dpr : 1;
+}
+function getNavigatorValue(bridge) {
+  return bridge.navigator;
+}
+function parseIosMajorVersion(userAgent) {
+  const match = /\bOS (\d+)_/i.exec(userAgent);
+  if (!match) {
+    return void 0;
+  }
+  const parsed = Number.parseInt(match[1] ?? "", 10);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function isAppleMobileDevice(bridge) {
+  const userAgent = bridge.navigator?.userAgent ?? "";
+  return /iP(hone|ad|od)/i.test(userAgent) || /Macintosh/i.test(userAgent) && (bridge.navigator?.maxTouchPoints ?? 0) > 1;
+}
+function getLongestScreenEdge(bridge) {
+  const screenWidth = bridge.screen?.width;
+  const screenHeight = bridge.screen?.height;
+  const innerWidth = bridge.innerWidth;
+  const innerHeight = bridge.innerHeight;
+  return Math.max(
+    typeof screenWidth === "number" ? screenWidth : 0,
+    typeof screenHeight === "number" ? screenHeight : 0,
+    typeof innerWidth === "number" ? innerWidth : 0,
+    typeof innerHeight === "number" ? innerHeight : 0
+  );
+}
+function isCoarsePointer(bridge) {
+  try {
+    return bridge.matchMedia?.("(pointer: coarse)").matches === true;
+  } catch {
+    return false;
+  }
+}
+function getWebGlInfo(bridge) {
+  const canvas = bridge.document?.createElement?.("canvas");
+  if (!canvas || typeof canvas.getContext !== "function") {
+    return { webglVersion: 0 };
+  }
+  const gl2 = canvas.getContext("webgl2");
+  const gl = gl2 ?? canvas.getContext("webgl") ?? canvas.getContext("experimental-webgl");
+  if (!gl) {
+    return { webglVersion: 0 };
+  }
+  const context = gl;
+  let maxTextureSize;
+  let renderer;
+  try {
+    const value = context.getParameter(context.MAX_TEXTURE_SIZE);
+    if (typeof value === "number" && Number.isFinite(value)) {
+      maxTextureSize = value;
+    }
+  } catch {
+  }
+  try {
+    const debugInfo = context.getExtension("WEBGL_debug_renderer_info");
+    const rendererParam = debugInfo?.UNMASKED_RENDERER_WEBGL ?? context.RENDERER;
+    const value = context.getParameter(rendererParam);
+    if (typeof value === "string") {
+      renderer = value;
+    }
+  } catch {
+  }
+  return {
+    maxTextureSize,
+    renderer,
+    webglVersion: gl2 ? 2 : 1
+  };
+}
+function applyMemoryScore(score, memory) {
+  if (typeof memory !== "number" || !Number.isFinite(memory) || memory <= 0) {
+    return score;
+  }
+  if (memory <= 1) return score - 18;
+  if (memory <= 2) return score - 10;
+  if (memory >= 8) return score + 16;
+  if (memory >= 6) return score + 10;
+  return score;
+}
+function applyCoreScore(score, cores) {
+  if (typeof cores !== "number" || !Number.isFinite(cores) || cores <= 0) {
+    return score;
+  }
+  if (cores <= 2) return score - 12;
+  if (cores <= 4) return score;
+  if (cores >= 8) return score + 12;
+  return score + 8;
+}
+function applyWebGlScore(score, info) {
+  let next = score;
+  if (info.webglVersion === 2) {
+    next += 16;
+  } else if (info.webglVersion === 1) {
+    next += 6;
+  } else {
+    next -= 25;
+  }
+  if (typeof info.maxTextureSize === "number") {
+    if (info.maxTextureSize >= 8192) next += 10;
+    else if (info.maxTextureSize >= 4096) next += 3;
+    else next -= 8;
+  }
+  const renderer = info.renderer?.toLowerCase() ?? "";
+  if (/swiftshader|llvmpipe|software/.test(renderer)) {
+    next = Math.min(next, 35);
+  } else if (/\bm[1-9]\b|apple gpu|a1[6-9]|rtx|radeon|adreno 7|adreno 8/.test(renderer)) {
+    next += 8;
+  }
+  return next;
+}
+function applyMobileCostScore(score, bridge) {
+  if (!isCoarsePointer(bridge)) {
+    return score;
+  }
+  const dpr = getDevicePixelRatio2(bridge);
+  const width = bridge.screen?.width ?? bridge.innerWidth ?? 0;
+  const height = bridge.screen?.height ?? bridge.innerHeight ?? 0;
+  const physicalPixels = width * height * dpr * dpr;
+  if (physicalPixels > 4e6) {
+    return score - 5;
+  }
+  return score;
+}
+function applyAppleMobileRules(score, bridge) {
+  if (!isAppleMobileDevice(bridge)) {
+    return score;
+  }
+  const userAgent = bridge.navigator?.userAgent ?? "";
+  const iosMajorVersion = parseIosMajorVersion(userAgent);
+  const highDensityDisplay = getDevicePixelRatio2(bridge) >= 3;
+  const longestScreenEdge = getLongestScreenEdge(bridge);
+  if (typeof iosMajorVersion === "number" && iosMajorVersion < 15) {
+    return Math.min(score, 35);
+  }
+  if (highDensityDisplay && longestScreenEdge >= 430 && (typeof iosMajorVersion === "undefined" || iosMajorVersion >= 17)) {
+    return Math.max(score, 78);
+  }
+  if (highDensityDisplay && longestScreenEdge >= 414 && (typeof iosMajorVersion === "undefined" || iosMajorVersion >= 16)) {
+    return Math.max(score, 62);
+  }
+  return Math.min(score, 48);
+}
+function estimateGraphicsPerformance(bridge) {
+  const navigatorValue = getNavigatorValue(bridge);
+  let score = 45;
+  score = applyMemoryScore(score, navigatorValue?.deviceMemory);
+  score = applyCoreScore(score, navigatorValue?.hardwareConcurrency);
+  score = applyWebGlScore(score, getWebGlInfo(bridge));
+  score = applyMobileCostScore(score, bridge);
+  score = applyAppleMobileRules(score, bridge);
+  const normalizedScore = clampScore(score);
+  return {
+    fps: fpsFromScore(normalizedScore),
+    tier: tierFromScore(normalizedScore)
+  };
+}
+function getGraphicsPerformance() {
+  const bridge = getBridgeWindow10();
+  if (!bridge) {
+    return { ...DEFAULT_GRAPHICS_PERFORMANCE };
+  }
+  const hostMetric = readHostGraphicsPerformance(bridge);
+  if (hostMetric) {
+    return hostMetric;
+  }
+  cachedEstimatedGraphicsPerformance ??= estimateGraphicsPerformance(bridge);
+  return { ...cachedEstimatedGraphicsPerformance };
+}
+
 // src/index.ts
 var oasiz = {
   submitScore,
@@ -1679,6 +2159,8 @@ var oasiz = {
   getSafeAreaTop,
   getViewportInsets,
   setLeaderboardVisible,
+  getGraphicsPerformance,
+  enableBackButtonTesting,
   onBackButton,
   onLeaveGame,
   leaveGame,
@@ -1702,13 +2184,18 @@ var oasiz = {
   },
   get viewportInsets() {
     return getViewportInsets();
+  },
+  get graphicsPerformance() {
+    return getGraphicsPerformance();
   }
 };
 export {
   addScore,
+  enableBackButtonTesting,
   enableLogOverlay,
   flushGameState,
   getGameId,
+  getGraphicsPerformance,
   getPlayerAvatar,
   getPlayerCharacter,
   getPlayerId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oasiz/sdk",
-  "version": "1.5.6",
+  "version": "1.6.1",
   "description": "Typed SDK for Oasiz game platform bridge APIs.",
   "type": "module",
   "main": "./dist/index.cjs",