Promote develop to main: re-sync (no file changes yet)

docs/architecture/CHARTER.md

@@ -619,7 +619,7 @@ with only cost caps is a brake with no steering wheel.
 ### 10a. Performance — the target, because "close to native" needs a number
 
 **Reference workload:** the `platformer` template, unmodified, as scaffolded. It is the reference
-template with the broadest scenario suite: 19 playtest files, and it is what a user actually
+template with the broadest scenario suite: 21 playtest files, and it is what a user actually
 receives. A performance claim measured on a spinning cube is not a performance claim.
 
 | Lane | Reference hardware | Budget |

docs/verification/native-coverage-2026-08-28.md

@@ -11,23 +11,23 @@ targets could not be built and are named below.
 | `src/audio/` | 1467 | 1300 | 88.62% |
 | `src/canvas/` | 1335 | 1113 | 83.37% |
 | `src/cli/` | 1691 | 1243 | 73.51% |
-| `src/engine/` | 44800 | 37627 | 83.99% |
+| `src/engine/` | 44823 | 37650 | 84.00% |
 | `src/fs/` | 235 | 189 | 80.43% |
 | `src/http/` | 410 | 377 | 91.95% |
 | `src/js/` | 2838 | 2230 | 78.58% |
-| `src/platform/` | 1523 | 1061 | 69.67% |
+| `src/platform/` | 1507 | 1061 | 70.40% |
 | `src/raytracing/` | 643 | 543 | 84.45% |
 | `src/runtime.cpp` | 2399 | 1865 | 77.74% |
 | `src/screenshot_gate.cpp` | 27 | 24 | 88.89% |
 | `src/storage/` | 370 | 329 | 88.92% |
 | `src/utils/` | 0 | 0 | 0.00% |
 | `src/vfs/` | 254 | 210 | 82.68% |
-| `src/webgpu/` | 10052 | 7721 | 76.81% |
+| `src/webgpu/` | 10052 | 7730 | 76.90% |
 | `src/webtransport/` | 1391 | 1078 | 77.50% |
-| `src/workers/` | 615 | 527 | 85.69% |
-| **TOTAL** | **70123** | **57497** | **81.99%** |
+| `src/workers/` | 615 | 524 | 85.20% |
+| **TOTAL** | **70130** | **57526** | **82.03%** |
 
-Source digest: `sha256:02063968cfebc5f980a5ad290f943378dc18eee1a99e62805f4f751694013d05`
+Source digest: `sha256:aa2574320d292f7b9f15d417d98b5468381a07a1e331671e9eb90654b254c4ea`
 
 The default `pnpm budgets` gate reads this committed measurement without configuring or compiling
 the native host. Any native source, native C++ test, CTest registration, or coverage aggregation
@@ -43,7 +43,7 @@ change requires this opt-in command to refresh the record.
 | `src/fs/` | 75.43% |
 | `src/http/` | 86.95% |
 | `src/js/` | 74.50% |
-| `src/platform/` | 64.76% |
+| `src/platform/` | 65.40% |
 | `src/raytracing/` | 81.55% |
 | `src/runtime.cpp` | 73.28% |
 | `src/screenshot_gate.cpp` | 88.89% |
@@ -61,7 +61,6 @@ change requires this opt-in command to refresh the record.
 - `src/adapters/v8/math_bridge.cpp`
 - `src/adapters/v8/tsl.cpp`
 - `src/debug/debug_server.cpp`
-- `src/engine/player/gamepads.cpp`
 - `src/engine/player/v8_main.cpp`
 - `src/engine/wasm/web_host.cpp`
 - `src/engine/world/physics_sync.cpp`

packages/core/__tests__/game.spec.ts

@@ -3739,7 +3739,11 @@ describe("IGame", () => {
 
       game.ctx?.input.tick();
       expect(game.ctx?.input.pressed("jump")).toBe(true);
-      expect(game.ctx?.input.vector("move").toArray()).toEqual([0.5, 0.25]);
+      // The injected pad reads through the standard-pad radial dead zone (0.2, rescaled so full
+      // tilt is still 1): [0.5, -0.25] has magnitude 0.559, so x reads 0.401 and move y +0.201.
+      expect(game.ctx?.input.vector("move").toArray()).toEqual([
+        0.401393202250021, 0.2006966011250105,
+      ]);
 
       size = { aspect: 2, height: 320, width: 640 };
       rendererResize?.();

packages/core/src/render-camera-cull.ts

@@ -119,7 +119,8 @@ export function untrackAnimationRate(root: Object3D, state: IAnimationRateState)
   const id = engineRateIds.get(root);
   if (id === undefined) return;
   setEngineRateState(id, undefined);
-  (root as unknown as IEngineRateRig).__trackAnimationRate(-1);
+  const engineRig = root as Partial<IEngineRateRig>;
+  if (typeof engineRig.__trackAnimationRate === "function") engineRig.__trackAnimationRate(-1);
 }
 
 /** A projection stand-in or skinned batch names the rigs it draws (see {@link animationRateSources}). */

packages/playtest/__tests__/gamepad-step.spec.ts

@@ -82,11 +82,10 @@ test("the injected pad is what the page's getGamepads returns, and the browser's
     expect(pad?.buttons[0]?.pressed).toBe(true);
     expect(pad?.buttons[1]?.pressed).toBe(false);
   } finally {
-    if (saved === undefined) {
-      (globalThis as { navigator?: unknown }).navigator = undefined;
-    } else {
-      Object.defineProperty(globalThis, "navigator", saved);
-    }
+    // `navigator` is an accessor some Node versions own and others inherit, so never assign it:
+    // delete the own property this test defined, which reveals whatever the host had underneath.
+    if (saved === undefined) Reflect.deleteProperty(globalThis, "navigator");
+    else Object.defineProperty(globalThis, "navigator", saved);
     (globalThis as { __tnPlaytestGamepad?: unknown }).__tnPlaytestGamepad = undefined;
   }
 });

scripts/__tests__/capability-manifest.spec.ts

@@ -880,6 +880,38 @@ describe("capability manifest generator", () => {
         ids: ["request.gi-visualize"],
         owners: ["GIVisualize"],
       },
+      // PRD-880: the six vendor words a player names a pad with. The situations already spell
+      // "Xbox", "8BitDo" and "Steam Deck", so the query recalls InputMap without them too.
+      "8bitdo": {
+        baselineAlreadyRecalled: true,
+        ids: ["request.gamepad-vendors"],
+        owners: ["InputMap"],
+      },
+      controller: {
+        baselineAlreadyRecalled: true,
+        ids: ["request.gamepad-vendors"],
+        owners: ["InputMap"],
+      },
+      gamepad: {
+        baselineAlreadyRecalled: true,
+        ids: ["request.gamepad-vendors"],
+        owners: ["InputMap"],
+      },
+      joypad: {
+        baselineAlreadyRecalled: true,
+        ids: ["request.gamepad-vendors"],
+        owners: ["InputMap"],
+      },
+      "steam deck": {
+        baselineAlreadyRecalled: true,
+        ids: ["request.gamepad-vendors"],
+        owners: ["InputMap"],
+      },
+      xbox: {
+        baselineAlreadyRecalled: true,
+        ids: ["request.gamepad-vendors"],
+        owners: ["InputMap"],
+      },
       "swimming buoyancy water volume wade": {
         baselineAlreadyRecalled: true,
         ids: ["request.swim-water-volume"],

scripts/__tests__/primary-docs.spec.ts

@@ -250,7 +250,7 @@ describe("primary documentation agrees with the shipped surfaces", () => {
     expect(
       scenarioCount,
       "platformer scenario count changed; update the Charter with the tree",
-    ).toBe(19);
+    ).toBe(21);
 
     const charter = await readRepoFile(path.join("docs", "architecture", "CHARTER.md"));
     const start = charter.indexOf("### 10a. Performance");

scripts/fixtures/capability-recall/budget.json

@@ -1,5 +1,5 @@
 {
-  "recallAtK": 0.9380530973451328,
+  "recallAtK": 0.9385964912280702,
   "recalledRows": [
     "brief.endless-runner.1",
     "brief.endless-runner.2",
@@ -100,6 +100,7 @@
     "request.shadow-quality-scalability",
     "request.two-sided-foliage",
     "request.terrain-forest-world",
+    "request.gamepad-vendors",
     "request.swim-water-volume",
     "spell.fireball",
     "spell.thunderstrike",
@@ -109,7 +110,7 @@
     "spell.inferno"
   ],
   "rejectHits": 15,
-  "rowCount": 113,
+  "rowCount": 114,
   "rowIds": [
     "brief.endless-runner.1",
     "brief.endless-runner.2",
@@ -217,6 +218,7 @@
     "request.shadow-quality-scalability",
     "request.two-sided-foliage",
     "request.terrain-forest-world",
+    "request.gamepad-vendors",
     "request.swim-water-volume",
     "spell.fireball",
     "spell.thunderstrike",
@@ -226,7 +228,7 @@
     "spell.inferno"
   ],
   "version": 1,
-  "zeroResultRate": 0.04424778761061947,
+  "zeroResultRate": 0.043859649122807015,
   "unresolvedResultRate": 0,
   "notOwnedRows": {
     "request.inventory-system": "inventory",

scripts/fixtures/capability-recall/corpus.json

@@ -900,6 +900,14 @@
       "expect": ["cookTerrainWorld"],
       "reject": []
     },
+    {
+      "id": "request.gamepad-vendors",
+      "query": "the Xbox pad, the 8bitdo or the Steam Deck controller reads as one standard gamepad, and an idle joypad must not steal input",
+      "scope": "request",
+      "source": "template:starter#Conventions",
+      "expect": ["InputMap"],
+      "reject": []
+    },
     {
       "id": "request.swim-water-volume",
       "query": "Swim across a river or lake in a water volume, floating with buoyancy and wading slower in shallow water.",

scripts/instruction-budget.ts

@@ -31,10 +31,14 @@ export interface IBudgetConfig {
 }
 
 export const INSTRUCTION_BUDGETS: IBudgetConfig = {
-  // PRD-825: a kit `AGENTS.md` is a router of at most 120 lines and 1,200 rendered words, the same
-  // for every kit. A new convention is a row in `conventions.json`, not a paragraph here, so no
-  // kit carries an override. History of the old per-kit caps: docs/verification/instruction-budgets-*.md.
-  defaultMaxWords: 1200,
+  // PRD-825: a kit `AGENTS.md` is a router of at most 120 lines, bounded by one word maximum for
+  // every kit. A new convention is a row in `conventions.json`, not a paragraph here, so no kit
+  // carries an override. History of the old per-kit caps: docs/verification/instruction-budgets-*.md.
+  //
+  // 1,250 measured 2026-11-12 after PRD-880's `#gamepad` row: the widest kit renders 1,234 words
+  // and four others sat within four words of the old 1,200, so one mandatory convention row broke
+  // six kits. The cap is that measured maximum plus one median row (15 words).
+  defaultMaxWords: 1250,
   overrides: {},
 };
 

scripts/unreal-look/scaffold/render/quality.ts

@@ -341,6 +341,19 @@ export function shadowPreset(tier: string): IShadowTier {
   return preset;
 }
 
+/**
+ * Whether a tier casts shadows: the game's `setupPost(..., { shadows })`, else the tier's. `low` casts none, as
+ * Unreal's `sg.ShadowQuality` 0. Pass the raw renderer to apply it to `shadowMap.enabled`. The tuned scaffold keeps
+ * the template's `postprocessing.ts`, which imports this, so the overlay must export it too (PRD-871).
+ */
+export function tierShadows(tier: QualityTier, override?: boolean, raw?: unknown) {
+  const enabled = override ?? shadowPreset(tier).castShadows;
+  const source = override === undefined ? "tier" : "override";
+  const shadowMap = (raw as { shadowMap?: { enabled: boolean } } | undefined)?.shadowMap;
+  if (shadowMap) shadowMap.enabled = enabled;
+  return { enabled, source, label: `${enabled ? "on" : "off"}(${source})` } as const;
+}
+
 export {
   type IMaterialLightingEnvironment,
   isWebGLFallbackRenderer,