@threenative/core 0.3.11 → 0.3.13

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 (236) hide show
  1. package/README.md +1 -1
  2. package/capabilities.json +1988 -204
  3. package/dist/{assets-YUbXa3-Y.d.ts → assets-CfMKnOsK.d.ts} +78 -1
  4. package/dist/camera-shake-CZKOfGn4.d.ts +46 -0
  5. package/dist/{canvas-layer-vCtanIeB.d.ts → canvas-layer-G7ttVy7y.d.ts} +1 -1
  6. package/dist/chunk-4SRAQFTU.js +133 -0
  7. package/dist/chunk-CFGTPFUH.js +231 -0
  8. package/dist/chunk-DIPIJICH.js +8916 -0
  9. package/dist/chunk-EEABDLUC.js +2237 -0
  10. package/dist/chunk-EFWZWLPY.js +1895 -0
  11. package/dist/chunk-GXY7B3JG.js +46 -0
  12. package/dist/chunk-GYUZJQ7U.js +280 -0
  13. package/dist/chunk-H4J6IAJE.js +504 -0
  14. package/dist/chunk-KIRUKTBQ.js +187 -0
  15. package/dist/chunk-QWJEMUUT.js +94 -0
  16. package/dist/chunk-SV4QVUTQ.js +31 -0
  17. package/dist/chunk-U4YHUKKL.js +615 -0
  18. package/dist/chunk-VP43GIWW.js +18 -0
  19. package/dist/chunk-XDTZ4QMO.js +160 -0
  20. package/dist/default-tone-mapping-GgKPTiBP.d.ts +4 -0
  21. package/dist/{game-DzMcitDO.d.ts → game-k8K3hZai.d.ts} +85 -9
  22. package/dist/hot.d.ts +5 -4
  23. package/dist/hot.js +5 -52
  24. package/dist/index.d.ts +633 -1351
  25. package/dist/index.js +12873 -23068
  26. package/dist/{model-lod-CTpZ6imz.d.ts → model-lod-DPTzeCcD.d.ts} +35 -3
  27. package/dist/playtest.d.ts +5 -4
  28. package/dist/playtest.js +25 -75
  29. package/dist/quality-BYqKGAwo.d.ts +868 -0
  30. package/dist/react-css.js +1 -215
  31. package/dist/react.d.ts +3 -2
  32. package/dist/render-environment.d.ts +170 -0
  33. package/dist/render-environment.js +352 -0
  34. package/dist/{renderer-rZm0hVqq.d.ts → renderer-BtOSseYf.d.ts} +42 -35
  35. package/dist/spells/index.d.ts +643 -0
  36. package/dist/spells/index.js +1558 -0
  37. package/dist/spells/ultra/index.d.ts +1600 -0
  38. package/dist/spells/ultra/index.js +6804 -0
  39. package/dist/terrain-jobs-worker.js +1 -123
  40. package/dist/two-sided-foliage-W523J3UM.js +1 -0
  41. package/dist/ui-layer.js +6 -384
  42. package/dist/worker.js +13 -43
  43. package/dist/world.d.ts +988 -268
  44. package/dist/world.js +17464 -18290
  45. package/mcp/animation-server.mjs +1 -1
  46. package/mcp/animation.mjs +2 -3
  47. package/mcp/engine-server.mjs +245 -52
  48. package/mcp/servers.mjs +10 -3
  49. package/mcp/terrain.mjs +8 -0
  50. package/package.json +19 -7
  51. package/patches/three@0.187.0-prd269-upgrade.patch +2102 -0
  52. package/patches/three@0.187.0.patch +2004 -407
  53. package/src/animation-batch.ts +193 -0
  54. package/src/animation-layers.ts +7 -3
  55. package/src/animation.ts +209 -29
  56. package/src/asset-cache.ts +3 -3
  57. package/src/asset-memo.ts +202 -0
  58. package/src/assets.ts +437 -125
  59. package/src/auto-batch.ts +190 -44
  60. package/src/card-lod.ts +152 -0
  61. package/src/compressed-texture-preparation.ts +1008 -0
  62. package/src/compute-driven.ts +1 -1
  63. package/src/config.ts +8 -0
  64. package/src/debug.ts +103 -22
  65. package/src/dev-global.ts +54 -0
  66. package/src/engine-hooks.ts +37 -0
  67. package/src/frame-budget.ts +50 -23
  68. package/src/game-boot-phase.ts +269 -0
  69. package/src/game-dev-tools.ts +86 -0
  70. package/src/game-frame-loop.ts +958 -0
  71. package/src/game-renderer-metrics.ts +77 -0
  72. package/src/game-startup.ts +1076 -0
  73. package/src/game-ui.ts +84 -0
  74. package/src/game-validate.ts +70 -0
  75. package/src/game.ts +198 -2264
  76. package/src/gamepad-mappings.ts +269 -0
  77. package/src/generated/console-markers.ts +13 -0
  78. package/src/geometry-capture.ts +28 -4
  79. package/src/gpu-readings.ts +98 -0
  80. package/src/gpu-scene-bvh.ts +149 -36
  81. package/src/hot.ts +4 -7
  82. package/src/index.ts +141 -9
  83. package/src/input.ts +237 -25
  84. package/src/instanced-batch-lod.ts +3 -8
  85. package/src/interpolation.ts +171 -40
  86. package/src/launch-diagnostics.ts +22 -12
  87. package/src/look/ao-admission.ts +25 -0
  88. package/src/look/auto-exposure.ts +5 -16
  89. package/src/look/default-tone-mapping.ts +41 -5
  90. package/src/look/filmic-tone-mapping.ts +15 -13
  91. package/src/look/local-exposure.ts +2 -7
  92. package/src/look/look-diagnostics.ts +3 -3
  93. package/src/look/quad-pass.ts +21 -0
  94. package/src/look/quality.ts +14 -5
  95. package/src/look/unreal-bloom.ts +4 -13
  96. package/src/look/world-environment.ts +113 -103
  97. package/src/loop.ts +29 -0
  98. package/src/merge-parts.ts +20 -24
  99. package/src/model-lod.ts +139 -17
  100. package/src/particle-kinds.ts +515 -0
  101. package/src/particle-significance.ts +12 -0
  102. package/src/particles.ts +19 -10
  103. package/src/picking.ts +17 -3
  104. package/src/platform.ts +23 -4
  105. package/src/playtest.ts +27 -1
  106. package/src/profiling/FrameStages.ts +5 -6
  107. package/src/profiling/Spans.ts +3 -17
  108. package/src/profiling/debug-telemetry.ts +2 -6
  109. package/src/profiling/render-list-validate.ts +6 -15
  110. package/src/projection-apply.ts +4 -1
  111. package/src/projection-marker.ts +2 -1
  112. package/src/projection-plan.ts +9 -6
  113. package/src/quiet-markers.ts +3 -10
  114. package/src/render/cpu-bvh.ts +100 -0
  115. package/src/render/depth-pyramid.ts +6 -14
  116. package/src/render/environment/environmentContribution.ts +202 -0
  117. package/src/render/environment/environmentRadiance.ts +44 -0
  118. package/src/render/environment/environmentSampleCache.ts +56 -0
  119. package/src/render/environment/environmentSampling.ts +201 -0
  120. package/src/render/environment/environmentSnapshot.ts +71 -0
  121. package/src/render/environment/gate.ts +57 -0
  122. package/src/render/mesh-pool.ts +4 -20
  123. package/src/render/probe-trace.ts +872 -0
  124. package/src/render/probe-volume.ts +780 -34
  125. package/src/render/radiance-cache.ts +17 -0
  126. package/src/render/resolution-subrect.ts +2 -0
  127. package/src/render/rough-diffuse.ts +46 -12
  128. package/src/render/soft-shadow.ts +27 -12
  129. package/src/render/virtual-shadow-adaptive.ts +55 -0
  130. package/src/render/virtual-shadow-casters.ts +175 -0
  131. package/src/render/virtual-shadow-layers.ts +76 -0
  132. package/src/render/virtual-shadow-level.ts +224 -0
  133. package/src/render/virtual-shadow-markers.ts +193 -0
  134. package/src/render/virtual-shadow-options.ts +370 -0
  135. package/src/render/virtual-shadow-pages.ts +5 -0
  136. package/src/render/virtual-shadow-partial.ts +13 -0
  137. package/src/render/virtual-shadow.ts +231 -1008
  138. package/src/render/world-impostor-surface.ts +402 -40
  139. package/src/render/world-impostor.ts +5 -2
  140. package/src/render-camera-cull.ts +98 -3
  141. package/src/render-environment.ts +41 -0
  142. package/src/render-pass-budget.ts +34 -7
  143. package/src/renderProjection.ts +22 -0
  144. package/src/renderer-config.ts +36 -0
  145. package/src/renderer-facts.ts +37 -0
  146. package/src/renderer.ts +144 -65
  147. package/src/resolution-scaler.ts +3 -2
  148. package/src/scene-entry-inspectors.ts +61 -0
  149. package/src/snow-field.ts +2 -1
  150. package/src/spells/cast-pool.ts +361 -0
  151. package/src/spells/index.ts +177 -0
  152. package/src/spells/mechanisms.ts +295 -0
  153. package/src/spells/reaction-field.ts +415 -0
  154. package/src/spells/spell-lights.ts +139 -0
  155. package/src/spells/spell-world.ts +187 -0
  156. package/src/spells/spell.ts +397 -0
  157. package/src/spells/spells.ts +283 -0
  158. package/src/spells/ultra/engine/camera.ts +184 -0
  159. package/src/spells/ultra/engine/quality.ts +96 -0
  160. package/src/spells/ultra/index.ts +52 -0
  161. package/src/spells/ultra/main.ts +305 -0
  162. package/src/spells/ultra/scene/arenaMaterial.ts +325 -0
  163. package/src/spells/ultra/spells/cast.ts +233 -0
  164. package/src/spells/ultra/spells/fire.ts +1267 -0
  165. package/src/spells/ultra/vfx/FluidVolume.ts +816 -0
  166. package/src/spells/ultra/vfx/FluidVolume.tsl.ts +855 -0
  167. package/src/spells/ultra/vfx/FxTarget.ts +61 -0
  168. package/src/spells/ultra/vfx/GroundField.ts +1399 -0
  169. package/src/spells/ultra/vfx/Particles.ts +1475 -0
  170. package/src/spells/ultra/vfx/Ribbons.ts +645 -0
  171. package/src/spells/ultra/vfx/Shockwaves.ts +286 -0
  172. package/src/spells/ultra/vfx/Volumes.ts +489 -0
  173. package/src/spells/ultra/vfx/common.ts +1195 -0
  174. package/src/spells/ultra/vfx/noise.ts +441 -0
  175. package/src/startup-offscreen-bytes.ts +78 -0
  176. package/src/startup-readiness.ts +128 -34
  177. package/src/static-transform.ts +25 -19
  178. package/src/streamed-textures.ts +112 -0
  179. package/src/streaming.ts +68 -4
  180. package/src/texture-streaming.ts +331 -0
  181. package/src/version.ts +1 -1
  182. package/src/warmup.ts +56 -8
  183. package/src/water-surface.ts +9 -3
  184. package/src/worker.ts +12 -2
  185. package/src/world-bundle-safety.ts +446 -0
  186. package/src/world-cell-batches.ts +1178 -0
  187. package/src/world-cell-chunks.ts +1128 -0
  188. package/src/world-cell-data.ts +995 -0
  189. package/src/world-cell-impostors.ts +1461 -0
  190. package/src/world-cell-lod-bias.ts +151 -0
  191. package/src/world-cell-models.ts +1074 -0
  192. package/src/world-cell-options.ts +177 -0
  193. package/src/world-cell-placements.ts +798 -0
  194. package/src/world-cell-prewarm.ts +592 -0
  195. package/src/world-cell-readiness.ts +357 -0
  196. package/src/world-cell-records.ts +401 -0
  197. package/src/world-cell-render-bundles.ts +459 -0
  198. package/src/world-cell-render-gpu-dress.ts +710 -0
  199. package/src/world-cell-render-main-cull.ts +540 -0
  200. package/src/world-cell-render-shadow-claims.ts +198 -0
  201. package/src/world-cell-render-util.ts +259 -0
  202. package/src/world-cell-render.ts +1501 -0
  203. package/src/world-cell-residency.ts +754 -0
  204. package/src/world-cell-stale.ts +238 -0
  205. package/src/world-cells.ts +1335 -10418
  206. package/src/world-chunk-shadow.ts +308 -0
  207. package/src/world-collar.ts +315 -0
  208. package/src/world-gpu-flags.ts +131 -0
  209. package/src/world-gpu-readback.ts +881 -0
  210. package/src/world-gpu-reference.ts +524 -0
  211. package/src/world-gpu-scene.ts +256 -2286
  212. package/src/world-gpu-shadow.ts +203 -0
  213. package/src/world-gpu-types.ts +409 -0
  214. package/src/world-gpu-validation.ts +518 -0
  215. package/src/world-heightfield.ts +802 -0
  216. package/src/world-load-limiter.ts +111 -0
  217. package/src/world-model-sections.ts +80 -0
  218. package/src/world-noise.ts +241 -0
  219. package/src/world-package.ts +42 -0
  220. package/src/world-region.ts +1 -1
  221. package/src/world-river-ribbon.ts +282 -0
  222. package/src/world-root-frame.ts +39 -0
  223. package/src/world-shore-field.ts +91 -0
  224. package/src/world-static-pose.ts +163 -0
  225. package/src/world-surface-sampler.ts +48 -0
  226. package/src/world-terrain-splat.ts +361 -153
  227. package/src/world-tile-budget.ts +249 -0
  228. package/src/world-tile-geometry.ts +469 -0
  229. package/src/world-tile-lod.ts +408 -0
  230. package/src/world-tile-observation.ts +566 -0
  231. package/src/world-tile-stitch.ts +166 -0
  232. package/src/world-tiles.ts +247 -1755
  233. package/src/world-validate.ts +6 -14
  234. package/src/world-warm.ts +51 -0
  235. package/src/world-water-bodies.ts +359 -0
  236. package/src/world.ts +48 -741
@@ -0,0 +1,166 @@
1
+ /**
2
+ * Seam planning: which resident pairs face each other, which LOD levels a pair may differ by, and the
3
+ bridge request the job runner turns into a strip. Split out of `world-tiles.ts` verbatim (PRD-797).
4
+ */
5
+
6
+ import { BufferGeometry, type LOD, Mesh } from "three";
7
+ import type {
8
+ ITerrainBridgeAttributes,
9
+ ITerrainEdgeJob,
10
+ ITerrainFineEdgeJob,
11
+ } from "./terrain-jobs.js";
12
+ import { keyFor } from "./world-tile-budget.js";
13
+ import {
14
+ type MeshSurface,
15
+ edgeJob,
16
+ fineEdgeJob,
17
+ geometryBytes,
18
+ restoreLevelEdge,
19
+ stitchGeometry,
20
+ terrainMesh,
21
+ } from "./world-tile-geometry.js";
22
+ import { opposingEdge, renderedLevel } from "./world-tile-observation.js";
23
+ import type { IResidentTile, IStitchBridge, NeighborPair } from "./world-tiles.js";
24
+ /**
25
+ * One pair's bridge, as the seam job carries it: the two edges it is made of, and what the bridge it
26
+ * produces is called and keyed by.
27
+ */
28
+ export interface IStitchRequest {
29
+ readonly coarse: ITerrainEdgeJob;
30
+ readonly fine: ITerrainFineEdgeJob;
31
+ readonly keys: [string, string];
32
+ readonly resolution: number;
33
+ }
34
+
35
+ export function neighborPairKey(pair: NeighborPair): string {
36
+ const [a, b] = pair;
37
+ return a.key < b.key ? `${a.key}|${b.key}` : `${b.key}|${a.key}`;
38
+ }
39
+
40
+ /**
41
+ * Every facing pair of the resident set, from the residency key map rather than from a scan of
42
+ * every tile against every other tile.
43
+ *
44
+ * `follow` and `process` each want this list, four times a frame, and the scan was quadratic in
45
+ * the resident count: 41k comparisons for the 289-tile ring a `streamRadius: 8` game streams,
46
+ * which is the whole per-frame regression. A tile's east and south neighbors are its only
47
+ * unfaced-inward partners, so two map lookups per tile enumerate each pair exactly once.
48
+ */
49
+ export function neighborPairs(tiles: ReadonlyMap<string, IResidentTile>): NeighborPair[] {
50
+ const pairs: NeighborPair[] = [];
51
+ collectNeighborPairs(tiles, pairs);
52
+ return pairs;
53
+ }
54
+
55
+ /** `neighborPairs` into a buffer the caller already owns, so a frame allocates no pair arrays. */
56
+ export function collectNeighborPairs(
57
+ tiles: ReadonlyMap<string, IResidentTile>,
58
+ into: NeighborPair[],
59
+ ): NeighborPair[] {
60
+ into.length = 0;
61
+ for (const tile of tiles.values()) {
62
+ const east = tiles.get(keyFor(tile.tileX + 1, tile.tileZ));
63
+ if (east !== undefined) into.push([tile, east]);
64
+ const south = tiles.get(keyFor(tile.tileX, tile.tileZ + 1));
65
+ if (south !== undefined) into.push([tile, south]);
66
+ }
67
+ return into;
68
+ }
69
+
70
+ export function hasPendingTarget(targets: ReadonlyMap<IResidentTile, number>): boolean {
71
+ for (const [tile, target] of targets)
72
+ if (Math.min(target, tile.maxLodLevel) !== tile.lodLevel) return true;
73
+ return false;
74
+ }
75
+
76
+ /** Each resident tile's target level after the neighbour rule: no two neighbours two levels apart. */
77
+ export function coordinatedLevels(
78
+ resident: ReadonlyMap<string, IResidentTile>,
79
+ targets: ReadonlyMap<IResidentTile, number>,
80
+ ): Map<IResidentTile, number> {
81
+ const levels = new Map<IResidentTile, number>();
82
+ for (const tile of resident.values())
83
+ levels.set(tile, Math.min(targets.get(tile) ?? tile.lodLevel, tile.maxLodLevel));
84
+ const pairs = neighborPairs(resident);
85
+ let changed = true;
86
+ while (changed) {
87
+ changed = false;
88
+ for (const [a, b] of pairs) {
89
+ const aLevel = levels.get(a) as number;
90
+ const bLevel = levels.get(b) as number;
91
+ if (Math.abs(aLevel - bLevel) <= 1) continue;
92
+ if (aLevel > bLevel) levels.set(a, bLevel + 1);
93
+ else levels.set(b, aLevel + 1);
94
+ changed = true;
95
+ }
96
+ }
97
+ return levels;
98
+ }
99
+
100
+ export function neighborLodCorrection(
101
+ pair: NeighborPair,
102
+ ): { coarser: IResidentTile; level: number } | undefined {
103
+ const [a, b] = pair;
104
+ if (Math.abs(a.lodLevel - b.lodLevel) <= 1) return undefined;
105
+ const finer = a.lodLevel < b.lodLevel ? a : b;
106
+ const coarser = finer === a ? b : a;
107
+ return { coarser, level: finer.lodLevel + 1 };
108
+ }
109
+
110
+ /**
111
+ * One neighbor pair's bridge request, or `undefined` when the pair needs no bridge.
112
+ *
113
+ * The two edges are restored here — that reads the game's field sampler, which cannot cross into a
114
+ * worker — and everything the bridge strip is made of is copied out as numbers. The strip itself is
115
+ * built wherever the jobs run, so the main thread only swaps the attributes it gets back.
116
+ */
117
+ export function neighborBridgeRequest(pair: NeighborPair): IStitchRequest | undefined {
118
+ const [a, b] = pair;
119
+ const [aSide, bSide] = opposingEdge(a, b);
120
+ const aLevel = renderedLevel(a);
121
+ const bLevel = renderedLevel(b);
122
+ if (aLevel === undefined || bLevel === undefined)
123
+ throw new Error("TerrainTiles cannot reconcile a neighbor with no rendered LOD level.");
124
+ restoreLevelEdge(a, aLevel, aSide);
125
+ restoreLevelEdge(b, bLevel, bSide);
126
+ if (aLevel.resolution === bLevel.resolution) return undefined;
127
+ const finerLevel = aLevel.resolution > bLevel.resolution ? aLevel : bLevel;
128
+ return {
129
+ coarse: edgeJob(
130
+ finerLevel === aLevel ? b : a,
131
+ finerLevel === aLevel ? bLevel : aLevel,
132
+ finerLevel === aLevel ? bSide : aSide,
133
+ ),
134
+ fine: fineEdgeJob(
135
+ finerLevel === aLevel ? a : b,
136
+ finerLevel,
137
+ finerLevel === aLevel ? aSide : bSide,
138
+ ),
139
+ keys: [a.key, b.key].sort() as [string, string],
140
+ resolution: finerLevel.resolution,
141
+ };
142
+ }
143
+
144
+ export function newStitchBridge(
145
+ request: IStitchRequest,
146
+ data: ITerrainBridgeAttributes,
147
+ surface: MeshSurface,
148
+ ): IStitchBridge {
149
+ const geometry = stitchGeometry(data);
150
+ const mesh = terrainMesh(new Mesh(geometry, surface));
151
+ mesh.frustumCulled = true;
152
+ return {
153
+ bytes: geometryBytes(geometry),
154
+ coverageDepth: data.coverageDepth,
155
+ geometry,
156
+ keys: request.keys,
157
+ mesh,
158
+ resolution: request.resolution,
159
+ };
160
+ }
161
+
162
+ export function setManualLodLevel(lod: LOD, level: number): void {
163
+ // Three's renderer reads `autoUpdate`, and its update method owns this private-ish marker. Keep
164
+ // that marker aligned with the visible child for callers that inspect the composed LOD.
165
+ (lod as LOD & { _currentLevel: number })._currentLevel = level;
166
+ }