create-threenative 0.2.15 → 0.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. package/agent-docs/kit-mcp.md +10 -0
  2. package/agent-docs/kit-router.md +14 -0
  3. package/agent-docs/kit-stuck.md +7 -0
  4. package/agent-docs/references/capability-reference.md +958 -30
  5. package/agent-docs/references/conventions.md +271 -0
  6. package/agent-docs/references/kit-action-rpg.md +40 -0
  7. package/agent-docs/references/kit-adventure.md +40 -0
  8. package/agent-docs/references/kit-collectathon.md +38 -0
  9. package/agent-docs/references/kit-kart.md +31 -0
  10. package/agent-docs/references/kit-minimal.md +29 -0
  11. package/agent-docs/references/kit-platformer.md +34 -0
  12. package/agent-docs/references/kit-puzzle.md +22 -0
  13. package/agent-docs/references/kit-racing.md +26 -0
  14. package/agent-docs/references/kit-rain.md +31 -0
  15. package/agent-docs/references/kit-rts.md +34 -0
  16. package/agent-docs/references/kit-runner.md +32 -0
  17. package/agent-docs/references/kit-sailing.md +41 -0
  18. package/agent-docs/references/kit-shooter.md +33 -0
  19. package/agent-docs/references/kit-snow.md +33 -0
  20. package/agent-docs/references/kit-starter.md +55 -0
  21. package/agent-docs/references/kit-tower-defense.md +27 -0
  22. package/agent-docs/references/terrain-authoring.md +2 -1
  23. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  24. package/agent-files/.agents/skills/prd-creator/SKILL.md +3 -2
  25. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +81 -59
  26. package/agent-files/.claude/hooks/discovery-gate.mjs +125 -0
  27. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  28. package/agent-files/.claude/settings.json +25 -0
  29. package/agent-files/.codex/hooks.json +18 -1
  30. package/dist/index.js +256 -120
  31. package/dist/terrain-kit.d.ts +7 -0
  32. package/dist/terrain-kit.js +82 -0
  33. package/dist/threenative.js +23 -4
  34. package/dist/web-engine-gltf-loader.js +20 -7
  35. package/dist/web-engine-post-effects.js +34 -4
  36. package/dist/web-engine-runtime.js +6119 -3311
  37. package/package.json +13 -8
  38. package/template-assets/patches/three@0.187.0.patch +2004 -407
  39. package/templates/action-rpg/AGENTS.md +99 -84
  40. package/templates/action-rpg/CLAUDE.md +99 -84
  41. package/templates/action-rpg/kit.json +1 -0
  42. package/templates/action-rpg/package.json +7 -7
  43. package/templates/action-rpg/playtests/spells.playtest.json +20 -0
  44. package/templates/action-rpg/src/game.ts +1 -0
  45. package/templates/action-rpg/src/render/atmosphere.ts +5 -16
  46. package/templates/action-rpg/src/render/gpuSky.ts +4 -7
  47. package/templates/action-rpg/src/render/quality.ts +3 -1
  48. package/templates/action-rpg/src/scenes/Play.ts +26 -0
  49. package/templates/action-rpg/src/ui/AbilityBar.tsx +1 -1
  50. package/templates/action-rpg/threenative.config.ts +0 -3
  51. package/templates/adventure/AGENTS.md +87 -44
  52. package/templates/adventure/CLAUDE.md +87 -44
  53. package/templates/adventure/package.json +7 -7
  54. package/templates/collectathon/AGENTS.md +88 -42
  55. package/templates/collectathon/CLAUDE.md +88 -42
  56. package/templates/collectathon/package.json +7 -7
  57. package/templates/kart/AGENTS.md +82 -42
  58. package/templates/kart/CLAUDE.md +82 -42
  59. package/templates/kart/package.json +6 -6
  60. package/templates/minimal/AGENTS.md +100 -84
  61. package/templates/minimal/CLAUDE.md +100 -84
  62. package/templates/minimal/package.json +6 -6
  63. package/templates/minimal/src/render/atmosphere.ts +5 -16
  64. package/templates/minimal/src/render/gpuSky.ts +4 -7
  65. package/templates/platformer/AGENTS.md +90 -46
  66. package/templates/platformer/CLAUDE.md +90 -46
  67. package/templates/platformer/package.json +7 -7
  68. package/templates/puzzle/AGENTS.md +92 -80
  69. package/templates/puzzle/CLAUDE.md +92 -80
  70. package/templates/puzzle/package.json +7 -7
  71. package/templates/racing/AGENTS.md +95 -82
  72. package/templates/racing/CLAUDE.md +95 -82
  73. package/templates/racing/package.json +7 -7
  74. package/templates/racing/src/render/atmosphere.ts +5 -16
  75. package/templates/racing/src/render/gpuSky.ts +4 -7
  76. package/templates/rain/AGENTS.md +92 -84
  77. package/templates/rain/CLAUDE.md +92 -84
  78. package/templates/rain/native-playtests/lightning.playtest.json +85 -10
  79. package/templates/rain/package.json +6 -6
  80. package/templates/rain/playtests/reduced-motion.playtest.json +6 -0
  81. package/templates/rain/src/scenes/Boot.ts +1 -0
  82. package/templates/rain/src/state.ts +7 -0
  83. package/templates/rain/src/ui/GameUi.tsx +7 -1
  84. package/templates/rts/AGENTS.md +96 -85
  85. package/templates/rts/CLAUDE.md +96 -85
  86. package/templates/rts/package.json +6 -6
  87. package/templates/runner/AGENTS.md +92 -80
  88. package/templates/runner/CLAUDE.md +92 -80
  89. package/templates/runner/package.json +7 -7
  90. package/templates/runner/playtests/performance.playtest.json +1 -1
  91. package/templates/runner/src/render/atmosphere.ts +5 -16
  92. package/templates/runner/src/render/gpuSky.ts +4 -7
  93. package/templates/runner/src/render/lighting.ts +53 -11
  94. package/templates/runner/src/scenes/Run.ts +4 -3
  95. package/templates/runner/threenative.config.ts +0 -3
  96. package/templates/sailing/AGENTS.md +91 -79
  97. package/templates/sailing/CLAUDE.md +91 -79
  98. package/templates/sailing/package.json +7 -7
  99. package/templates/sailing/playtests/sails.playtest.json +1 -0
  100. package/templates/sailing/src/render/sky.ts +4 -0
  101. package/templates/sailing/threenative.config.ts +0 -3
  102. package/templates/shooter/AGENTS.md +93 -68
  103. package/templates/shooter/CLAUDE.md +93 -68
  104. package/templates/shooter/package.json +7 -7
  105. package/templates/shooter/src/render/atmosphere.ts +5 -16
  106. package/templates/shooter/src/render/gpuSky.ts +4 -7
  107. package/templates/shooter/src/render/quality.ts +3 -1
  108. package/templates/snow/AGENTS.md +90 -76
  109. package/templates/snow/CLAUDE.md +90 -76
  110. package/templates/snow/package.json +7 -7
  111. package/templates/snow/threenative.config.ts +0 -3
  112. package/templates/starter/AGENTS.md +104 -88
  113. package/templates/starter/CLAUDE.md +104 -88
  114. package/templates/starter/native-playtests/render-chain.playtest.json +24 -24
  115. package/templates/starter/native-playtests/smooth-motion.playtest.json +3 -3
  116. package/templates/starter/package.json +7 -7
  117. package/templates/starter/src/entities/Player.ts +10 -22
  118. package/templates/starter/src/render/atmosphere.ts +5 -16
  119. package/templates/starter/src/render/gpuSky.ts +4 -7
  120. package/templates/starter/src/render/lighting.ts +54 -4
  121. package/templates/starter/src/render/temporalAA.ts +8 -7
  122. package/templates/starter/src/render/temporalAAFrame.ts +30 -9
  123. package/templates/starter/src/render/temporalAAResolve.ts +15 -1
  124. package/templates/starter/src/render/temporalClampRelease.ts +183 -0
  125. package/templates/starter/src/render/temporalHistoryResolve.ts +90 -0
  126. package/templates/starter/src/render/temporalMoire.ts +190 -0
  127. package/templates/starter/src/render/temporalResolve.ts +75 -16
  128. package/templates/starter/src/render/temporalResolveDepth.ts +2 -0
  129. package/templates/starter/src/scenes/Play.ts +41 -29
  130. package/templates/tower-defense/AGENTS.md +92 -81
  131. package/templates/tower-defense/CLAUDE.md +92 -81
  132. package/templates/tower-defense/package.json +7 -7
  133. package/capabilities.json +0 -9197
  134. package/templates/AGENTS.md +0 -21
  135. package/templates/CLAUDE.md +0 -23
  136. package/templates/action-rpg/.codex/config.toml +0 -23
  137. package/templates/action-rpg/.cursor/mcp.json +0 -38
  138. package/templates/action-rpg/.gemini/settings.json +0 -38
  139. package/templates/action-rpg/.mcp.json +0 -38
  140. package/templates/action-rpg/.vscode/mcp.json +0 -43
  141. package/templates/action-rpg/.zed/settings.json +0 -43
  142. package/templates/action-rpg/opencode.json +0 -49
  143. package/templates/adventure/.codex/config.toml +0 -23
  144. package/templates/adventure/.cursor/mcp.json +0 -38
  145. package/templates/adventure/.gemini/settings.json +0 -38
  146. package/templates/adventure/.mcp.json +0 -38
  147. package/templates/adventure/.vscode/mcp.json +0 -43
  148. package/templates/adventure/.zed/settings.json +0 -43
  149. package/templates/adventure/opencode.json +0 -49
  150. package/templates/collectathon/.codex/config.toml +0 -23
  151. package/templates/collectathon/.cursor/mcp.json +0 -38
  152. package/templates/collectathon/.gemini/settings.json +0 -38
  153. package/templates/collectathon/.mcp.json +0 -38
  154. package/templates/collectathon/.vscode/mcp.json +0 -43
  155. package/templates/collectathon/.zed/settings.json +0 -43
  156. package/templates/collectathon/opencode.json +0 -49
  157. package/templates/kart/.codex/config.toml +0 -23
  158. package/templates/kart/.cursor/mcp.json +0 -38
  159. package/templates/kart/.gemini/settings.json +0 -38
  160. package/templates/kart/.mcp.json +0 -38
  161. package/templates/kart/.vscode/mcp.json +0 -43
  162. package/templates/kart/.zed/settings.json +0 -43
  163. package/templates/kart/opencode.json +0 -49
  164. package/templates/minimal/.codex/config.toml +0 -23
  165. package/templates/minimal/.cursor/mcp.json +0 -38
  166. package/templates/minimal/.gemini/settings.json +0 -38
  167. package/templates/minimal/.mcp.json +0 -38
  168. package/templates/minimal/.vscode/mcp.json +0 -43
  169. package/templates/minimal/.zed/settings.json +0 -43
  170. package/templates/minimal/opencode.json +0 -49
  171. package/templates/platformer/.codex/config.toml +0 -23
  172. package/templates/platformer/.cursor/mcp.json +0 -38
  173. package/templates/platformer/.gemini/settings.json +0 -38
  174. package/templates/platformer/.mcp.json +0 -38
  175. package/templates/platformer/.vscode/mcp.json +0 -43
  176. package/templates/platformer/.zed/settings.json +0 -43
  177. package/templates/platformer/opencode.json +0 -49
  178. package/templates/puzzle/.codex/config.toml +0 -23
  179. package/templates/puzzle/.cursor/mcp.json +0 -38
  180. package/templates/puzzle/.gemini/settings.json +0 -38
  181. package/templates/puzzle/.mcp.json +0 -38
  182. package/templates/puzzle/.vscode/mcp.json +0 -43
  183. package/templates/puzzle/.zed/settings.json +0 -43
  184. package/templates/puzzle/opencode.json +0 -49
  185. package/templates/racing/.codex/config.toml +0 -23
  186. package/templates/racing/.cursor/mcp.json +0 -38
  187. package/templates/racing/.gemini/settings.json +0 -38
  188. package/templates/racing/.mcp.json +0 -38
  189. package/templates/racing/.vscode/mcp.json +0 -43
  190. package/templates/racing/.zed/settings.json +0 -43
  191. package/templates/racing/opencode.json +0 -49
  192. package/templates/rain/.codex/config.toml +0 -23
  193. package/templates/rain/.cursor/mcp.json +0 -38
  194. package/templates/rain/.gemini/settings.json +0 -38
  195. package/templates/rain/.mcp.json +0 -38
  196. package/templates/rain/.vscode/mcp.json +0 -43
  197. package/templates/rain/.zed/settings.json +0 -43
  198. package/templates/rain/opencode.json +0 -49
  199. package/templates/rts/.codex/config.toml +0 -23
  200. package/templates/rts/.cursor/mcp.json +0 -38
  201. package/templates/rts/.gemini/settings.json +0 -38
  202. package/templates/rts/.mcp.json +0 -38
  203. package/templates/rts/.vscode/mcp.json +0 -43
  204. package/templates/rts/.zed/settings.json +0 -43
  205. package/templates/rts/opencode.json +0 -49
  206. package/templates/runner/.codex/config.toml +0 -23
  207. package/templates/runner/.cursor/mcp.json +0 -38
  208. package/templates/runner/.gemini/settings.json +0 -38
  209. package/templates/runner/.mcp.json +0 -38
  210. package/templates/runner/.vscode/mcp.json +0 -43
  211. package/templates/runner/.zed/settings.json +0 -43
  212. package/templates/runner/README.md +0 -43
  213. package/templates/runner/opencode.json +0 -49
  214. package/templates/sailing/.codex/config.toml +0 -23
  215. package/templates/sailing/.cursor/mcp.json +0 -38
  216. package/templates/sailing/.gemini/settings.json +0 -38
  217. package/templates/sailing/.mcp.json +0 -38
  218. package/templates/sailing/.vscode/mcp.json +0 -43
  219. package/templates/sailing/.zed/settings.json +0 -43
  220. package/templates/sailing/README.md +0 -28
  221. package/templates/sailing/opencode.json +0 -49
  222. package/templates/shooter/.codex/config.toml +0 -23
  223. package/templates/shooter/.cursor/mcp.json +0 -38
  224. package/templates/shooter/.gemini/settings.json +0 -38
  225. package/templates/shooter/.mcp.json +0 -38
  226. package/templates/shooter/.vscode/mcp.json +0 -43
  227. package/templates/shooter/.zed/settings.json +0 -43
  228. package/templates/shooter/opencode.json +0 -49
  229. package/templates/snow/.codex/config.toml +0 -23
  230. package/templates/snow/.cursor/mcp.json +0 -38
  231. package/templates/snow/.gemini/settings.json +0 -38
  232. package/templates/snow/.mcp.json +0 -38
  233. package/templates/snow/.vscode/mcp.json +0 -43
  234. package/templates/snow/.zed/settings.json +0 -43
  235. package/templates/snow/README.md +0 -26
  236. package/templates/snow/opencode.json +0 -49
  237. package/templates/starter/.codex/config.toml +0 -23
  238. package/templates/starter/.cursor/mcp.json +0 -38
  239. package/templates/starter/.gemini/settings.json +0 -38
  240. package/templates/starter/.mcp.json +0 -38
  241. package/templates/starter/.vscode/mcp.json +0 -43
  242. package/templates/starter/.zed/settings.json +0 -43
  243. package/templates/starter/opencode.json +0 -49
  244. package/templates/tower-defense/.codex/config.toml +0 -23
  245. package/templates/tower-defense/.cursor/mcp.json +0 -38
  246. package/templates/tower-defense/.gemini/settings.json +0 -38
  247. package/templates/tower-defense/.mcp.json +0 -38
  248. package/templates/tower-defense/.vscode/mcp.json +0 -43
  249. package/templates/tower-defense/.zed/settings.json +0 -43
  250. package/templates/tower-defense/README.md +0 -16
  251. package/templates/tower-defense/opencode.json +0 -49
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Copies one packaged terrain kit into a new game-owned folder.
3
+ * It checks the name, the packaged inputs and the target before it writes.
4
+ */
5
+ declare function copyTerrainKit(kit: string, targetPath: string, templatesRoot?: string): Promise<void>;
6
+
7
+ export { copyTerrainKit };
@@ -0,0 +1,82 @@
1
+ import { createRequire } from 'node:module';
2
+ import { lstat, readFile, mkdir, writeFile } from 'fs/promises';
3
+ import path from 'path';
4
+ import { fileURLToPath } from 'url';
5
+
6
+ createRequire(import.meta.url);
7
+ var KITS = ["alpine", "coastal", "desert", "forest", "tundra"];
8
+ var COPIED = [
9
+ "assets.json",
10
+ "bake.mjs",
11
+ "credits.json",
12
+ "heightmap.r16",
13
+ "recipe.json",
14
+ "surface.json"
15
+ ];
16
+ var DEFAULT_TEMPLATES_ROOT = path.resolve(
17
+ path.dirname(fileURLToPath(import.meta.url)),
18
+ "../templates"
19
+ );
20
+ async function assertNoSymlinkAncestor(target) {
21
+ let dir = path.dirname(path.resolve(target));
22
+ for (; ; ) {
23
+ const info = await lstat(dir).catch((error) => {
24
+ if (error.code === "ENOENT") return null;
25
+ throw error;
26
+ });
27
+ if (info?.isSymbolicLink()) {
28
+ throw new Error(
29
+ `TN_TERRAIN_KIT_SYMLINK: A parent folder is a symlink: ${dir}. Choose a target path with real parent folders.`
30
+ );
31
+ }
32
+ if (info !== null) return;
33
+ const parent = path.dirname(dir);
34
+ if (parent === dir) return;
35
+ dir = parent;
36
+ }
37
+ }
38
+ async function copyTerrainKit(kit, targetPath, templatesRoot = DEFAULT_TEMPLATES_ROOT) {
39
+ const target = path.resolve(targetPath);
40
+ if (!KITS.includes(kit)) {
41
+ throw new Error(
42
+ `TN_TERRAIN_KIT_NAME: "${kit}" is not a packaged terrain kit. Use one of: ${KITS.join(", ")}.`
43
+ );
44
+ }
45
+ const sourceDir = path.join(path.resolve(templatesRoot, "..", "template-assets", "terrain"), kit);
46
+ const sourceStat = await lstat(sourceDir).catch(() => null);
47
+ if (!sourceStat)
48
+ throw new Error(
49
+ `TN_TERRAIN_KIT_UNKNOWN: The packaged folder for "${kit}" is missing: ${sourceDir}.`
50
+ );
51
+ if (!sourceStat.isDirectory()) {
52
+ throw new Error(
53
+ `TN_TERRAIN_KIT_SOURCE: The packaged folder is not a real directory: ${sourceDir}.`
54
+ );
55
+ }
56
+ const bytes = /* @__PURE__ */ new Map();
57
+ for (const file of COPIED) {
58
+ const source = path.join(sourceDir, file);
59
+ if (!(await lstat(source).catch(() => null))?.isFile()) {
60
+ throw new Error(
61
+ `TN_TERRAIN_KIT_SOURCE: The packaged input is missing or not a regular file: ${source}.`
62
+ );
63
+ }
64
+ bytes.set(file, await readFile(source));
65
+ }
66
+ const targetStat = await lstat(target).catch(() => null);
67
+ if (targetStat?.isSymbolicLink()) {
68
+ throw new Error(
69
+ `TN_TERRAIN_KIT_SYMLINK: The target is a symlink. Choose a real folder: ${target}.`
70
+ );
71
+ }
72
+ if (targetStat)
73
+ throw new Error(
74
+ `TN_TERRAIN_KIT_EXISTS: The target already exists. Choose a new folder: ${target}.`
75
+ );
76
+ await assertNoSymlinkAncestor(target);
77
+ await mkdir(path.dirname(target), { recursive: true });
78
+ await mkdir(target);
79
+ for (const [file, data] of bytes) await writeFile(path.join(target, file), data, { flag: "wx" });
80
+ }
81
+
82
+ export { copyTerrainKit };
@@ -3223,6 +3223,12 @@ var MCP_SERVERS = Object.freeze({
3223
3223
  command: "node",
3224
3224
  args: Object.freeze(["./node_modules/@threenative/core/mcp/engine.mjs"])
3225
3225
  }),
3226
+ // Cooks a starter terrain kit into a world.glb. The server lives in the optional
3227
+ // `@threenative/terrain` package, which the shim resolves from the project at launch.
3228
+ "threenative-terrain": Object.freeze({
3229
+ command: "node",
3230
+ args: Object.freeze(["./node_modules/@threenative/core/mcp/terrain.mjs"])
3231
+ }),
3226
3232
  // Inspects, attaches, edits and verifies character animation. Every operation is a build-time
3227
3233
  // edit of one GLB, so a game that animates nothing pays for nothing.
3228
3234
  "threenative-animation": Object.freeze({
@@ -3240,9 +3246,10 @@ var MCP_SERVERS = Object.freeze({
3240
3246
  });
3241
3247
  var MCP_PACKAGES = Object.freeze({
3242
3248
  assets: Object.freeze({ name: "threenative-asset-mcp", version: "0.15.0" }),
3249
+ terrain: Object.freeze({ name: "@threenative/terrain", version: "0.1.8" }),
3243
3250
  sculpt: Object.freeze({ name: "threenative-sculpt-mcp", version: "0.2.2" }),
3244
- engine: Object.freeze({ name: "threenative-engine-mcp", version: "0.2.11" }),
3245
- animation: Object.freeze({ name: "threenative-animation-mcp", version: "0.1.3" }),
3251
+ engine: Object.freeze({ name: "threenative-engine-mcp", version: "0.2.12" }),
3252
+ animation: Object.freeze({ name: "threenative-animation-mcp", version: "0.1.9" }),
3246
3253
  // `args` fixes the launch for every host. The Chrome flags are `WEBGPU_BROWSER_ARGS` from
3247
3254
  // `@threenative/playtest`, so a DevTools trace profiles the same adapter a playtest does and not
3248
3255
  // SwiftShader. An isolated profile keeps the user's own Chrome profile out, and the two opt-outs
@@ -3402,11 +3409,12 @@ function requiredAndroidSdkFromRoot(root) {
3402
3409
  }
3403
3410
  }
3404
3411
  var CORE_PACKAGE_NAME = "@threenative/core";
3405
- var CORE_PACKAGE_VERSION = "0.3.11";
3412
+ var CORE_PACKAGE_VERSION = "0.3.12";
3406
3413
  var CORE_RESOLVED_SERVERS = /* @__PURE__ */ new Set([
3407
3414
  "threenative-engine",
3408
3415
  "threenative-animation"
3409
3416
  ]);
3417
+ var OPTIONAL_ADDON_SERVERS = /* @__PURE__ */ new Set(["threenative-terrain"]);
3410
3418
  var MCP_SERVER_SPECS = Object.entries(MCP_SERVERS).map(
3411
3419
  ([configName, server]) => {
3412
3420
  const resolvesToCore = CORE_RESOLVED_SERVERS.has(configName);
@@ -3420,6 +3428,7 @@ var MCP_SERVER_SPECS = Object.entries(MCP_SERVERS).map(
3420
3428
  return {
3421
3429
  configName,
3422
3430
  expectedArgs: serverEntryPath(server),
3431
+ optional: OPTIONAL_ADDON_SERVERS.has(configName),
3423
3432
  packageName: resolvesToCore ? CORE_PACKAGE_NAME : declared.name,
3424
3433
  version: resolvesToCore ? CORE_PACKAGE_VERSION : declared.version
3425
3434
  };
@@ -3679,6 +3688,14 @@ function mcpServerCheck(snapshot, spec, value, file) {
3679
3688
  };
3680
3689
  }
3681
3690
  const packageDirectory = resolvePackageDirectory(snapshot, spec.packageName);
3691
+ if (packageDirectory === void 0 && spec.optional) {
3692
+ return {
3693
+ detail: `${spec.configName} is optional and ${spec.packageName} is not installed in this project`,
3694
+ fix: `Run: npm i -D ${spec.packageName}`,
3695
+ name,
3696
+ status: "warn"
3697
+ };
3698
+ }
3682
3699
  if (packageDirectory === void 0) {
3683
3700
  return {
3684
3701
  detail: `${spec.configName} is reachable by npx only: ${spec.packageName}@${spec.version} is not installed (npx --yes ${spec.packageName}@${spec.version})`,
@@ -3718,7 +3735,7 @@ function probeMcpServer(projectRoot, spec) {
3718
3735
  method: "initialize",
3719
3736
  params: {
3720
3737
  capabilities: {},
3721
- clientInfo: { name: "threenative-doctor", version: "0.3.11" },
3738
+ clientInfo: { name: "threenative-doctor", version: "0.3.12" },
3722
3739
  protocolVersion: "2025-06-18"
3723
3740
  }
3724
3741
  });
@@ -4794,6 +4811,8 @@ async function readProject(root) {
4794
4811
  const mcpServerHealth = /* @__PURE__ */ new Map();
4795
4812
  if (SHAPE_VERIFIABLE_HOSTS.some(({ file }) => files.has(file))) {
4796
4813
  for (const spec of MCP_SERVER_SPECS) {
4814
+ if (spec.optional && resolvePackageDirectoryFrom(projectRoot, spec.packageName) === void 0)
4815
+ continue;
4797
4816
  if (existsSync(path5.resolve(projectRoot, spec.expectedArgs))) {
4798
4817
  mcpServerHealth.set(spec.configName, probeMcpServer(projectRoot, spec));
4799
4818
  }
@@ -92,6 +92,24 @@ function hostPlugins(factories, data) {
92
92
  for (const plugin of plugins) if (plugin.name !== HOSTED_PLUGIN) refuse("PLUGIN");
93
93
  return { parser, plugins };
94
94
  }
95
+ var inFlight = /* @__PURE__ */ new Map();
96
+ function imageBytes(url) {
97
+ const key = new URL(url, globalThis.location?.href ?? "http://localhost/").href;
98
+ let pending = inFlight.get(key);
99
+ if (pending === void 0) {
100
+ pending = (async () => {
101
+ const response = await fetch(url);
102
+ if (!response.ok) throw new Error(`TN_WASM_GLTF_FETCH: ${response.status} ${url}`);
103
+ if (response.headers.get("content-type")?.startsWith("text/html"))
104
+ throw new Error(`TN_WASM_GLTF_FETCH: text/html ${url}`);
105
+ return new Uint8Array(await response.arrayBuffer());
106
+ })();
107
+ inFlight.set(key, pending);
108
+ const settled = () => inFlight.delete(key);
109
+ pending.then(settled, settled);
110
+ }
111
+ return pending;
112
+ }
95
113
  var GLTFLoader = class {
96
114
  path = "";
97
115
  /** A plugin defect (a chain the file declares and cannot deliver) rejects the load; core's plugin logs it on stock three. */
@@ -160,13 +178,8 @@ var GLTFLoader = class {
160
178
  return;
161
179
  }
162
180
  Promise.all(
163
- uris.map(async (uri) => {
164
- const response = await fetch(path + uri);
165
- if (!response.ok) throw new Error(`TN_WASM_GLTF_FETCH: ${response.status} ${path + uri}`);
166
- if (response.headers.get("content-type")?.startsWith("text/html"))
167
- throw new Error(`TN_WASM_GLTF_FETCH: text/html ${path + uri}`);
168
- return [decodeURIComponent(uri), new Uint8Array(await response.arrayBuffer())];
169
- })
181
+ // The engine loader asks for the uri with its percent escapes decoded.
182
+ uris.map(async (uri) => [decodeURIComponent(uri), await imageBytes(path + uri)])
170
183
  ).then(
171
184
  (files) => settle(new Map(files)),
172
185
  (error) => {
@@ -504,7 +504,23 @@ var GI_MAX_STEPS = 24;
504
504
  var GI_MAX_LUMINANCE = 40;
505
505
  function defineScreenSpaceGi(tsl) {
506
506
  return function ssgi2(colorNode, depthNode, normalNode, cameraOrOptions) {
507
- const { Break, Fn, If, Loop, float, int, max, min, normalize, rtt, smoothstep, uniform, uv } = tsl;
507
+ const {
508
+ Break,
509
+ Fn,
510
+ If,
511
+ Loop,
512
+ clamp,
513
+ float,
514
+ int,
515
+ max,
516
+ min,
517
+ normalize,
518
+ pow,
519
+ rtt,
520
+ smoothstep,
521
+ uniform,
522
+ uv
523
+ } = tsl;
508
524
  const { vec2, vec3, vec4 } = tsl;
509
525
  const options = "camera" in cameraOrOptions ? cameraOrOptions : { camera: cameraOrOptions };
510
526
  const mapping = defineCameraMapping(tsl, options.camera, "ssgi");
@@ -514,9 +530,14 @@ function defineScreenSpaceGi(tsl) {
514
530
  const sliceCount = uniform(2);
515
531
  const stepCount = uniform(12);
516
532
  const intensity = uniform(1);
533
+ const aoIntensity = uniform(1);
517
534
  const screenEdgeFade = uniform(0.1);
518
535
  const probeJitter = uniform(1);
519
536
  const probeDebug = uniform(0);
537
+ const occlusion = (gather) => {
538
+ const ao2 = pow(clamp(float(1).sub(gather.a), float(0), float(1)), aoIntensity);
539
+ return vec4(ao2, ao2, ao2, 1);
540
+ };
520
541
  const { march, shade } = defineGiTrace(tsl, {
521
542
  colorNode,
522
543
  depthNode,
@@ -543,13 +564,14 @@ function defineScreenSpaceGi(tsl) {
543
564
  sliceCount,
544
565
  stepCount,
545
566
  intensity,
567
+ aoIntensity,
546
568
  screenEdgeFade,
547
569
  probeJitter,
548
570
  probeDebug
549
571
  }).map(([name, value]) => [name, { value }])
550
572
  ),
551
573
  getGINode: { value: () => node2 },
552
- getAONode: { value: () => tsl.vec4(1, 1, 1, 1) },
574
+ getAONode: { value: () => occlusion(node2) },
553
575
  resolutionScale: {
554
576
  get: () => node2.getResolutionScale(),
555
577
  set: (value) => node2.setResolutionScale(value)
@@ -601,13 +623,21 @@ function defineScreenSpaceGi(tsl) {
601
623
  return result;
602
624
  })();
603
625
  const node = rtt(graph, null, null, { type: HALF_FLOAT_TYPE, gpuStage: GI_STAGE });
604
- const uniformObjects = { radius, thickness, sliceCount, stepCount, intensity, screenEdgeFade };
626
+ const uniformObjects = {
627
+ radius,
628
+ thickness,
629
+ sliceCount,
630
+ stepCount,
631
+ intensity,
632
+ aoIntensity,
633
+ screenEdgeFade
634
+ };
605
635
  return Object.defineProperties(node, {
606
636
  ...Object.fromEntries(
607
637
  Object.entries(uniformObjects).map(([name, value]) => [name, { value }])
608
638
  ),
609
639
  getGINode: { value: () => node },
610
- getAONode: { value: () => vec4(1, 1, 1, 1) },
640
+ getAONode: { value: () => occlusion(node) },
611
641
  resolutionScale: {
612
642
  get: () => node.getResolutionScale(),
613
643
  set: (value) => node.setResolutionScale(value)