@threenative/core 0.3.3 → 0.3.5

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 (182) hide show
  1. package/capabilities.json +2019 -59
  2. package/dist/{assets-CYKk2WTu.d.ts → assets-CqvE429w.d.ts} +45 -3
  3. package/dist/{audio-7i3Xl0l3.d.ts → audio-DIJE5HTr.d.ts} +43 -3
  4. package/dist/{canvas-layer-C1SnMoJ-.d.ts → canvas-layer-C1-5CviZ.d.ts} +5 -1
  5. package/dist/{game-D_6r-k4Y.d.ts → game-Bj8G1wmD.d.ts} +242 -17
  6. package/dist/hot.d.ts +5 -5
  7. package/dist/index.d.ts +1131 -105
  8. package/dist/index.js +15201 -4782
  9. package/dist/model-lod-BDAUYgsS.d.ts +197 -0
  10. package/dist/playtest.d.ts +6 -4
  11. package/dist/playtest.js +84 -11
  12. package/dist/react-css.d.ts +62 -0
  13. package/dist/react-css.js +591 -0
  14. package/dist/react.d.ts +2 -2
  15. package/dist/{renderer-Cy4qeBOA.d.ts → renderer-9yEo9hPa.d.ts} +676 -21
  16. package/dist/terrain-jobs-worker.d.ts +2 -0
  17. package/dist/terrain-jobs-worker.js +130 -0
  18. package/dist/ui-layer.d.ts +5 -3
  19. package/dist/ui-layer.js +59 -8
  20. package/dist/world.d.ts +1596 -17
  21. package/dist/world.js +17035 -521
  22. package/gpl/fixtures/make_world_fixture.py +184 -0
  23. package/gpl/recipes/_common.py +11 -0
  24. package/gpl/recipes/decimate.py +11 -5
  25. package/gpl/recipes/export_world.py +699 -0
  26. package/mcp/blender-server.mjs +61 -4
  27. package/mcp/blender.mjs +3 -4
  28. package/mcp/engine-server.mjs +55 -21
  29. package/mcp/servers.mjs +4 -4
  30. package/package.json +15 -9
  31. package/patches/three@0.185.1-prd269-upgrade.patch +22418 -0
  32. package/patches/three@0.185.1.patch +8246 -389
  33. package/scripts/apply-three-patch.mjs +123 -41
  34. package/src/animation-blend.ts +264 -0
  35. package/src/animation-composition.ts +362 -0
  36. package/src/animation-layers.ts +260 -0
  37. package/src/animation-root-motion.ts +283 -0
  38. package/src/animation.ts +896 -0
  39. package/src/assets.ts +1303 -0
  40. package/src/atmosphere/index.ts +335 -0
  41. package/src/atmosphere/luts.ts +298 -0
  42. package/src/atmosphere/params.ts +323 -0
  43. package/src/audio.ts +912 -0
  44. package/src/billboard.ts +124 -0
  45. package/src/bone-lengths.ts +157 -0
  46. package/src/camera-shake.ts +116 -0
  47. package/src/canvas-layer.ts +47 -0
  48. package/src/clip-audit.ts +401 -0
  49. package/src/clustered-batch.ts +492 -0
  50. package/src/clustered-mesh.ts +638 -0
  51. package/src/compute-driven.ts +176 -0
  52. package/src/compute-timing.ts +318 -0
  53. package/src/config.ts +593 -0
  54. package/src/debug.ts +82 -0
  55. package/src/engine-render-hook.ts +25 -0
  56. package/src/entities.ts +79 -0
  57. package/src/entity-snapshot.ts +53 -0
  58. package/src/flight.ts +683 -0
  59. package/src/fluid-field.ts +748 -0
  60. package/src/fluid-particles.ts +1253 -0
  61. package/src/frame-budget.ts +1368 -0
  62. package/src/game.ts +2390 -0
  63. package/src/geometry-capture.ts +1098 -0
  64. package/src/gpu-class.ts +160 -0
  65. package/src/gpu-frame-observation.ts +424 -0
  66. package/src/gpu-readback.ts +143 -0
  67. package/src/gpu-scene-bvh.ts +464 -0
  68. package/src/grounding.ts +100 -0
  69. package/src/hot.ts +161 -0
  70. package/src/import-meta.d.ts +13 -0
  71. package/src/index.ts +1536 -0
  72. package/src/input.ts +690 -0
  73. package/src/instanced-batch-lod.ts +283 -0
  74. package/src/instanced-batch.ts +274 -0
  75. package/src/interpolation.ts +129 -0
  76. package/src/launch-diagnostics.ts +161 -0
  77. package/src/loop.ts +564 -0
  78. package/src/matrix-world.ts +245 -0
  79. package/src/merge-parts.ts +812 -0
  80. package/src/model-lod.ts +1315 -0
  81. package/src/net-protocol.ts +333 -0
  82. package/src/net-session.ts +477 -0
  83. package/src/net.ts +80 -0
  84. package/src/ocean/fft.ts +72 -0
  85. package/src/ocean/spectral.ts +728 -0
  86. package/src/particle-significance.ts +102 -0
  87. package/src/particles.ts +648 -0
  88. package/src/path-follow.ts +175 -0
  89. package/src/picking.ts +250 -0
  90. package/src/pipeline-census.ts +1566 -0
  91. package/src/platform.ts +210 -0
  92. package/src/playtest.ts +839 -0
  93. package/src/pointer-events.ts +411 -0
  94. package/src/pose-measure.ts +435 -0
  95. package/src/profiling/FrameCounters.ts +231 -0
  96. package/src/profiling/Spans.ts +548 -0
  97. package/src/profiling/opacity-convention.ts +21 -0
  98. package/src/profiling/render-list-validate.ts +175 -0
  99. package/src/profiling/render-trap-audit.ts +84 -0
  100. package/src/profiling/scene-warning.ts +190 -0
  101. package/src/profiling/span-probes.ts +191 -0
  102. package/src/profiling/unlit-foliage-warning.ts +149 -0
  103. package/src/projection-apply.ts +1529 -0
  104. package/src/projection-marker.ts +142 -0
  105. package/src/projection-plan.ts +1258 -0
  106. package/src/projection-skinned.ts +419 -0
  107. package/src/projection-stability.ts +409 -0
  108. package/src/projection-uniform.ts +328 -0
  109. package/src/random.ts +41 -0
  110. package/src/react-css.ts +604 -0
  111. package/src/react-glyphs.ts +114 -0
  112. package/src/react-host.ts +576 -0
  113. package/src/react-layout.ts +265 -0
  114. package/src/react.ts +60 -0
  115. package/src/render/alpha-antialiasing.ts +159 -0
  116. package/src/render/batched-velocity.ts +126 -0
  117. package/src/render/chain.ts +1021 -0
  118. package/src/render/daylight.ts +189 -0
  119. package/src/render/depth-pyramid.ts +596 -0
  120. package/src/render/foliage-alpha.ts +166 -0
  121. package/src/render/material-key.ts +60 -0
  122. package/src/render/mesh-pool.ts +144 -0
  123. package/src/render/probe-volume.ts +1668 -0
  124. package/src/render/resolution-subrect.ts +253 -0
  125. package/src/render/velocity.ts +442 -0
  126. package/src/render/virtual-shadow-pages.ts +827 -0
  127. package/src/render/virtual-shadow-partial.ts +174 -0
  128. package/src/render/virtual-shadow.ts +3330 -0
  129. package/src/render/world-impostor-surface.ts +722 -0
  130. package/src/render/world-impostor.ts +558 -0
  131. package/src/render-camera-cull.ts +441 -0
  132. package/src/render-pass-budget.ts +501 -0
  133. package/src/renderProjection.ts +758 -0
  134. package/src/renderer-config.ts +127 -0
  135. package/src/renderer.ts +1847 -0
  136. package/src/replay-protocol.ts +85 -0
  137. package/src/replay.ts +205 -0
  138. package/src/resolution-scaler.ts +819 -0
  139. package/src/rig-preparation.ts +271 -0
  140. package/src/ripple-field.ts +432 -0
  141. package/src/scale.ts +109 -0
  142. package/src/scene.ts +239 -0
  143. package/src/schedule.ts +155 -0
  144. package/src/skeletal-mesh.ts +61 -0
  145. package/src/skeleton.ts +100 -0
  146. package/src/snow-field.ts +744 -0
  147. package/src/softbody-topology.ts +269 -0
  148. package/src/softbody.ts +516 -0
  149. package/src/sprite-animator.ts +222 -0
  150. package/src/startup-readiness.ts +386 -0
  151. package/src/state.ts +66 -0
  152. package/src/static-transform.ts +274 -0
  153. package/src/storage-buffer.ts +253 -0
  154. package/src/streaming.ts +308 -0
  155. package/src/target-fps.ts +92 -0
  156. package/src/terrain-jobs-worker.ts +17 -0
  157. package/src/terrain-jobs.ts +353 -0
  158. package/src/textures.ts +39 -0
  159. package/src/tracers.ts +237 -0
  160. package/src/ui-bridge.ts +368 -0
  161. package/src/ui-hit-regions.ts +380 -0
  162. package/src/ui-layer.ts +83 -0
  163. package/src/ui-state.ts +220 -0
  164. package/src/version.ts +2 -0
  165. package/src/viewport.ts +253 -0
  166. package/src/warmup.ts +1357 -0
  167. package/src/water-surface.ts +384 -0
  168. package/src/wave-field.ts +524 -0
  169. package/src/world-capabilities.ts +131 -0
  170. package/src/world-cell-proxy.ts +392 -0
  171. package/src/world-cells.ts +10564 -0
  172. package/src/world-gpu-scene.ts +3354 -0
  173. package/src/world-heightmap.ts +82 -0
  174. package/src/world-package.ts +469 -0
  175. package/src/world-passes.ts +582 -0
  176. package/src/world-region.ts +17 -0
  177. package/src/world-terrain-splat.ts +564 -0
  178. package/src/world-tiles.ts +3826 -0
  179. package/src/world-topology.ts +370 -0
  180. package/src/world-validate.ts +48 -0
  181. package/src/world.ts +805 -0
  182. package/dist/gpu-readback-CMklJs6r.d.ts +0 -112
@@ -1,4 +1,4 @@
1
- import { Texture, Object3D, AnimationClip } from 'three';
1
+ import { Texture, Wrapping, Object3D, AnimationClip } from 'three';
2
2
 
3
3
  interface IAssetLoaderOptions {
4
4
  readonly basePath?: string;
@@ -49,10 +49,41 @@ interface ICompressedTextureSupport {
49
49
  readonly loader: Promise<IKTX2LoaderLike | undefined>;
50
50
  readonly ready: Promise<void>;
51
51
  }
52
+ /** Which pipeline served a logical path: the compile step's manifest, or the project's own files. */
53
+ type AssetSource = "manifest" | "source";
54
+ /** Where one settled load's bytes actually came from. */
55
+ interface IResolvedAsset {
56
+ readonly url: string;
57
+ readonly via: AssetSource;
58
+ }
59
+ interface ITextureOptions {
60
+ /**
61
+ * The pixels are data, not colour: a normal map, a roughness map, a mask. Data textures are
62
+ * sampled without a colour-space conversion, which is wrong for an albedo and right for these.
63
+ * Left out, the copy is sRGB — the space an image file is authored in. A loader leaves a plain
64
+ * image linear, which washes out every albedo, so an options call never inherits that.
65
+ */
66
+ readonly data?: boolean;
67
+ /** Both axes at once. Absent leaves the loaded texture's own wrapping. */
68
+ readonly wrap?: Wrapping;
69
+ /** Tiling counts, one for both axes or one per axis. Absent leaves the loaded texture's own. */
70
+ readonly repeat?: number | readonly [number, number];
71
+ /** Samples to take at grazing angles. Absent leaves the loaded texture's own. */
72
+ readonly anisotropy?: number;
73
+ }
52
74
  interface IAssetLoader {
53
75
  readonly compressedTextures?: ICompressedTextureSupport;
54
76
  model<T = unknown>(path: string): Promise<T>;
55
- texture(path: string): Promise<Texture>;
77
+ /**
78
+ * Load a texture, optionally configured in one call.
79
+ *
80
+ * @situation set color space, wrap, repeat or anisotropy on a loaded texture
81
+ *
82
+ * With no options this is the shared cached instance, exactly as before. With options it is a
83
+ * copy of it: the cached texture is shared by every other caller of that path, and a wrap or a
84
+ * colour-space write on it would silently change how another material draws.
85
+ */
86
+ texture(path: string, options?: ITextureOptions): Promise<Texture>;
56
87
  audio(path: string): Promise<AudioBuffer>;
57
88
  release(kind: "audio" | "model" | "texture", path: string): boolean;
58
89
  /**
@@ -86,6 +117,17 @@ interface IAssetLoader {
86
117
  readonly settled: number;
87
118
  readonly settledBytes: number;
88
119
  };
120
+ /**
121
+ * Where each settled load was actually served from, keyed by the logical path asked for.
122
+ *
123
+ * `progress` counts loads and cannot say which of a path's candidate urls answered, so a game
124
+ * whose manifest 404s and a game whose manifest named the output look identical from the game's
125
+ * own side — which is how an unreadable manifest became a silent uncompiled fallback on the
126
+ * native hosts, where a failed read arrives as a rejected fetch rather than a 404. `via` is
127
+ * `"manifest"` only for the compiled output the manifest named; `"source"` is the verbatim or
128
+ * source-directory path, and an external url, which no manifest governs.
129
+ */
130
+ readonly resolved: ReadonlyMap<string, IResolvedAsset>;
89
131
  clear(): void;
90
132
  }
91
133
  /**
@@ -107,4 +149,4 @@ interface IAssetLoader {
107
149
  declare function reconcileMirroredClips(root: Object3D, clips: readonly AnimationClip[]): boolean;
108
150
  declare function createAssetLoader(options?: IAssetLoaderOptions): IAssetLoader;
109
151
 
110
- export { type IAssetLoader as I, type IAssetLoaderOptions as a, createAssetLoader as c, reconcileMirroredClips as r };
152
+ export { type IAssetLoader as I, type IAssetLoaderOptions as a, type ITextureOptions as b, createAssetLoader as c, reconcileMirroredClips as r };
@@ -1,7 +1,39 @@
1
1
  import { AudioListener, Object3D, Audio, Vector3, PositionalAudio } from 'three';
2
2
 
3
+ /**
4
+ * Bus-level dynamics compression, every value the game's.
5
+ *
6
+ * All five are required and none has an engine default: a compressor is a mix decision, and a
7
+ * bus that filled in the threshold itself would be deciding how loud the game is. The ranges are
8
+ * Web Audio's own — threshold -100 to 0 dBFS, knee 0–40 dB, ratio 1–20, attack and release
9
+ * 0–1 s, where 0 is an instant response — and anything outside them throws rather than being
10
+ * quietly clamped into a mix the game did not ask for.
11
+ */
12
+ interface IAudioCompressorOptions {
13
+ /** Level above which the bus is compressed, in dBFS. Must be finite and between -100 and 0. */
14
+ readonly threshold: number;
15
+ /** Width of the soft transition around `threshold`, in dB. Must be finite and 0–40. */
16
+ readonly knee: number;
17
+ /** Input:output ratio above the threshold. Must be finite and 1–20. */
18
+ readonly ratio: number;
19
+ /** Seconds to reach full compression once a peak arrives. Must be finite and 0–1. */
20
+ readonly attack: number;
21
+ /** Seconds to return to unity once the mix falls back. Must be finite and 0–1. */
22
+ readonly release: number;
23
+ }
3
24
  interface IAudioBusOptions {
4
25
  readonly camera: Object3D;
26
+ /**
27
+ * A compressor on this bus's master, holding a loud mix below clipping.
28
+ *
29
+ * Every voice sums into it before the bus's volume gain, so it sees the mix rather than each
30
+ * cue alone — which is the whole point: three cues that are each fine and add up to a clipped
31
+ * master is a defect no per-voice option can see, and a compressor that sat after the gain
32
+ * would be working on a level the bus volume had already moved. Opt in, and every value comes
33
+ * from the game. A runtime with no dynamics node reports `compressor` in `unsupported` rather
34
+ * than playing on uncompressed and quiet about it.
35
+ */
36
+ readonly compressor?: IAudioCompressorOptions;
5
37
  readonly gestureTarget?: EventTarget;
6
38
  readonly listener?: AudioListener;
7
39
  readonly source?: () => EventTarget | undefined;
@@ -85,8 +117,8 @@ interface IAudioRuntimeSnapshot {
85
117
  /**
86
118
  * Cue-shaping options this runtime accepted and could not honour, sorted and de-duplicated.
87
119
  *
88
- * The native host binds neither a biquad filter nor a schedulable `detune`, so `lowpassHz` and
89
- * `detune` are silently dropped there. A mix tuned on the web and shipped to a phone is flat in
120
+ * The native host binds a biquad filter and a compressor but no schedulable `detune`, so
121
+ * `detune` is silently dropped there. A mix tuned on the web and shipped to a phone is flat in
90
122
  * a way nothing else reports, and a build can be failed on this.
91
123
  */
92
124
  readonly unsupported: readonly string[];
@@ -117,6 +149,14 @@ declare class AudioBus {
117
149
  get volume(): number;
118
150
  /** @see IAudioRuntimeSnapshot.unsupported */
119
151
  get unsupported(): readonly string[];
152
+ /**
153
+ * The compressor on this bus's master, or `undefined` when the bus has none — either because
154
+ * the game did not ask for one or because this runtime has no dynamics node.
155
+ *
156
+ * Exposed so a game can read `reduction` off it, which is the only observation that answers
157
+ * "is the compressor doing anything", and so a playtest can assert on it.
158
+ */
159
+ get compressor(): DynamicsCompressorNode | undefined;
120
160
  /**
121
161
  * The whole bus's level, which is what a volume slider and a duck both move.
122
162
  *
@@ -184,4 +224,4 @@ declare class AudioBus {
184
224
  }
185
225
  declare function audioRuntimeSnapshot(): IAudioRuntimeSnapshot;
186
226
 
187
- export { AudioBus as A, type IAudioBusOptions as I, audioRuntimeSnapshot as a, type IAudioPlayOptions as b, resetAudioCueLedger as r };
227
+ export { AudioBus as A, type IAudioBusOptions as I, audioRuntimeSnapshot as a, type IAudioCompressorOptions as b, type IAudioPlayOptions as c, resetAudioCueLedger as r };
@@ -1,6 +1,6 @@
1
1
  import * as three from 'three';
2
2
  import { Camera, Vector2, Vector3, Scene, OrthographicCamera } from 'three';
3
- import { I as IRendererLike } from './renderer-Cy4qeBOA.js';
3
+ import { I as IRendererLike } from './renderer-9yEo9hPa.js';
4
4
 
5
5
  interface IViewportSize {
6
6
  readonly aspect: number;
@@ -53,6 +53,10 @@ declare class CanvasLayer {
53
53
  readonly camera: OrthographicCamera;
54
54
  /** Declares that this layer covers the framebuffer, allowing the world pass to be skipped. */
55
55
  opaque: boolean;
56
+ /** Keep preparing/drawing the world behind an opaque loading cover, including scene changes. */
57
+ keepWorldRendering: boolean;
58
+ /** Allow first-use world draws during startup; render-cadence admission runs independently. */
59
+ renderWorldDuringStartup: boolean;
56
60
  constructor(viewport: Pick<Viewport, "onResize" | "size">);
57
61
  dispose(): void;
58
62
  /** Subscribe to drawable-size changes after this layer has updated its camera. */
@@ -1,12 +1,12 @@
1
- import { I as IAssetLoader, a as IAssetLoaderOptions } from './assets-CYKk2WTu.js';
2
- import { F as FramePassKind, H as IRenderPassSample, m as IFramePhaseSample, n as IPipelineCensus, I as IRendererLike, ad as IRendererOptions, a as IFrameBudgetWindow, i as IFrameBudgetOptions } from './renderer-Cy4qeBOA.js';
1
+ import { I as IAssetLoader, a as IAssetLoaderOptions } from './assets-CqvE429w.js';
2
+ import { F as FramePassKind, c as IRenderPassSample, d as IFramePhaseSample, e as IPipelineCensus, I as IRendererLike, f as IRendererOptions, a as IFrameBudgetWindow, g as IFrameBudgetOptions } from './renderer-9yEo9hPa.js';
3
3
  import { Vector2, Vector3, Object3D, Camera, Intersection, Scene as Scene$1 } from 'three';
4
- import { V as Viewport, C as CanvasLayer, I as IViewportOptions } from './canvas-layer-C1SnMoJ-.js';
4
+ import { V as Viewport, C as CanvasLayer, I as IViewportOptions } from './canvas-layer-C1-5CviZ.js';
5
5
  import { StoreApi } from 'zustand/vanilla';
6
6
 
7
7
  type ThreeNativeOrientation = "landscape" | "portrait" | "sensor";
8
8
  /** Which renderer draws a game's `src/ui/`. @see IThreeNativeConfig.ui */
9
- type ThreeNativeUiRenderer = "native" | "web";
9
+ type ThreeNativeUiRenderer = "native" | "native-css" | "web";
10
10
  /** What the native host does with the render loop while the app is off-screen. */
11
11
  type ThreeNativeBackgroundMode = "continue" | "pause";
12
12
  interface IThreeNativeIconVariants {
@@ -81,8 +81,13 @@ interface IThreeNativeAudioConfig {
81
81
  }
82
82
  /** Texture compression options for the asset compile step; `"none"` ships sources verbatim. */
83
83
  interface IThreeNativeTexturesConfig {
84
- /** Integer at least 4; caps the longest edge, preserving aspect and 4x4 alignment; never upscales. */
85
- readonly maxSize?: number;
84
+ /** Automatic compression floor; omitted fields default to SSIM 0.95 and mean ΔE00 3. */
85
+ readonly floor?: {
86
+ readonly ssim?: number;
87
+ readonly meanDeltaE00?: number;
88
+ };
89
+ /** Scalar or glTF slot map (e.g. baseColorTexture/normalTexture). Integer at least 4; caps the longest edge, preserving aspect and 4x4 alignment; never upscales. */
90
+ readonly maxSize?: number | Readonly<Record<string, number>>;
86
91
  readonly overrides?: readonly {
87
92
  readonly codec: "etc1s" | "none" | "uastc";
88
93
  readonly glob: string;
@@ -101,6 +106,23 @@ interface IThreeNativeModelPassesConfig {
101
106
  }
102
107
  /** Model optimization options for the asset compile step; `"none"` ships sources verbatim. */
103
108
  interface IThreeNativeModelsConfig {
109
+ /**
110
+ * Lossless scene-graph compaction: flatten empty transform chains, join sibling primitives
111
+ * that share a material, and batch a mesh several nodes reuse as `EXT_mesh_gpu_instancing`.
112
+ *
113
+ * On by default; `false` ships the scene graph as authored. A node matching `protectedPattern`,
114
+ * named in `protectedNames`, targeted by an animation or a skin joint is never merged or
115
+ * instanced, so an exact-name lookup or a bone-driven node survives.
116
+ */
117
+ readonly compact?: boolean | {
118
+ readonly flatten?: boolean;
119
+ readonly instance?: boolean | {
120
+ readonly min?: number;
121
+ };
122
+ readonly join?: boolean;
123
+ readonly protectedNames?: readonly string[];
124
+ readonly protectedPattern?: string;
125
+ };
104
126
  /** Standard glTF TEXCOORD_1 atlas generation for offline static-light assets. */
105
127
  readonly lightmap?: {
106
128
  readonly atlasSize: number;
@@ -127,7 +149,12 @@ interface IThreeNativeModelsConfig {
127
149
  * blocks, and never upscales.
128
150
  */
129
151
  readonly textures?: "none" | {
130
- readonly maxSize?: number;
152
+ readonly floor?: {
153
+ readonly ssim?: number;
154
+ readonly meanDeltaE00?: number;
155
+ };
156
+ /** Scalar or glTF slot map; unlisted slots retain the 2048 default. Shared images use the largest cap. */
157
+ readonly maxSize?: number | Readonly<Record<string, number>>;
131
158
  readonly quality?: number;
132
159
  readonly overrides?: readonly {
133
160
  readonly slot: string;
@@ -237,7 +264,50 @@ interface IThreeNativeLodConfig {
237
264
  readonly preset?: ThreeNativeLodPreset;
238
265
  readonly runtime?: IThreeNativeLodRuntimeConfig;
239
266
  }
267
+ /** One measured byte ceiling on a produced artifact, and what crossing it does. */
268
+ interface IThreeNativeArtifactBudgetLimit {
269
+ /** Bytes, exclusive: a build measuring exactly the limit is inside it. */
270
+ readonly limit: number;
271
+ /** `"error"` refuses the build and keeps the previous artifact; `"warn"` prints and publishes. */
272
+ readonly severity: "error" | "warn";
273
+ }
274
+ /**
275
+ * Runtime ceilings a profile wants every playtest of the artifact it builds to hold.
276
+ *
277
+ * The fields are the playtest harness's own `assert.performance` fields, one name for one meaning:
278
+ * a budget declared here is merged into each scenario's performance assertion, so a budget and a
279
+ * scenario bound the same number instead of two vocabularies for one measurement. Spelled out
280
+ * rather than imported — the harness runs against plain Three.js with no dependency on this
281
+ * package, and core must not invert that. A closed key list validated in both places is the price;
282
+ * `create-threenative/__tests__/build-report.spec.ts` fails if the two lists drift.
283
+ */
284
+ interface IThreeNativePerformanceBudget {
285
+ /** Per-pass draw-call ceilings, keyed by pass kind: main, shadow, reflection, nested. */
286
+ readonly maxPassDrawCalls?: Readonly<Partial<Record<ThreeNativeRenderPassKind, number>>>;
287
+ /** Per-pass triangle ceilings, keyed by pass kind: main, shadow, reflection, nested. */
288
+ readonly maxPassTriangles?: Readonly<Partial<Record<ThreeNativeRenderPassKind, number>>>;
289
+ /** Per-phase millisecond ceilings at nearest-rank p95: hostGap, update, render, overlay, residual. */
290
+ readonly maxPhaseMsP95?: Readonly<Partial<Record<ThreeNativeFramePhase, number>>>;
291
+ /** Maximum renderer draw-call count across every pass combined. */
292
+ readonly maxDrawCalls?: number;
293
+ /** Maximum nearest-rank 95th-percentile frame time in milliseconds. */
294
+ readonly maxFrameMsP95?: number;
295
+ /** Maximum renderer triangle count across every pass combined. */
296
+ readonly maxTriangles?: number;
297
+ /** Frame-budget floor: the median presented frame must sustain at least this many frames a second. */
298
+ readonly minFps?: number;
299
+ }
300
+ /** The engine's frame-budget phases, as a budget spells them. */
301
+ type ThreeNativeFramePhase = "hostGap" | "overlay" | "render" | "residual" | "update";
302
+ /** The render-pass kinds a per-pass budget bounds. */
303
+ type ThreeNativeRenderPassKind = "main" | "shadow" | "reflection" | "nested";
240
304
  interface IThreeNativeConfig {
305
+ /**
306
+ * The engine that draws the game on web and desktop. Defaults to ThreeNative's own C++ engine
307
+ * (`"threenative"`): compiled to Wasm on web, the V8 engine player on desktop. `"threejs"` is the named
308
+ * override: it keeps upstream Three.js on web and the legacy host on desktop. Android and iOS still run the legacy host.
309
+ */
310
+ readonly engine?: "threejs" | "threenative";
241
311
  readonly app?: {
242
312
  readonly id?: string;
243
313
  readonly name?: string;
@@ -251,7 +321,10 @@ interface IThreeNativeConfig {
251
321
  readonly fullscreen?: boolean;
252
322
  readonly keepScreenOn?: boolean;
253
323
  /**
254
- * Maximum native presentation rate in frames per second. Defaults to 60; `0` removes the
324
+ * Maximum native presentation rate in frames per second. Left out, it follows the display's own
325
+ * refresh rate capped at 120 on desktop and web, and stays 60 on mobile where the ceiling is
326
+ * power and heat; the resolved value and its source are reported on every `TN_FRAME_BUDGET`
327
+ * line as `targetFps` and `targetSource`. A number set here wins outright, and `0` removes the
255
328
  * software ceiling. Android also submits this value as the surface's preferred frame rate,
256
329
  * which the display policy may decline because of hardware, power, or thermal state. Android
257
330
  * uses non-blocking presentation above 60 fps so a missed high-refresh interval does not fall
@@ -262,7 +335,8 @@ interface IThreeNativeConfig {
262
335
  * What the native host does when the player leaves the app — presses the power button,
263
336
  * switches away, minimizes the window. `"pause"` (the default) stops running frames and
264
337
  * suspends audio until the app comes back; `"continue"` keeps rendering off-screen, which a
265
- * server-shaped or split-screen game may genuinely want.
338
+ * server-shaped or split-screen game may genuinely want. On Android the operating system
339
+ * stops the app whatever this says, so `"continue"` takes effect on desktop only.
266
340
  *
267
341
  * Turning the pause off does not turn the reporting off: `TN_LIFECYCLE` markers are emitted
268
342
  * either way and name the mode that executed.
@@ -277,6 +351,43 @@ interface IThreeNativeConfig {
277
351
  readonly maximized?: boolean;
278
352
  readonly resizable?: boolean;
279
353
  };
354
+ /**
355
+ * Named cook profiles: one authored asset tree, one compiler, a different representation per
356
+ * artifact. `--profile` on `threenative build` wins over `defaults[target]`; with neither, the
357
+ * `assets` block is used exactly as declared. An overlay changes resource-processing options
358
+ * only — the source root, the output root, worker concurrency and exclusions stay in `assets`.
359
+ */
360
+ readonly buildProfiles?: {
361
+ readonly defaults?: {
362
+ readonly android?: string;
363
+ readonly desktop?: string;
364
+ readonly ios?: string;
365
+ readonly web?: string;
366
+ };
367
+ readonly profiles: Readonly<Record<string, {
368
+ /**
369
+ * Byte ceilings on what this profile actually produced, measured after packaging and
370
+ * checked before the artifact is published. `artifactBytes` is the artifact itself (a
371
+ * file, or the recursive sum of a directory, `.app` bundle or outDir);
372
+ * `packagedAssetBytes` is the sum of the asset files that survived the packaging
373
+ * selector. `"error"` refuses the build and leaves the previous artifact in place;
374
+ * `"warn"` prints and publishes.
375
+ */
376
+ readonly artifactBudget?: {
377
+ readonly artifactBytes?: IThreeNativeArtifactBudgetLimit;
378
+ readonly packagedAssetBytes?: IThreeNativeArtifactBudgetLimit;
379
+ };
380
+ /**
381
+ * Runtime ceilings this profile's artifact must hold, published into the
382
+ * `<artifact>.build-report.json` a build writes beside it and merged by
383
+ * `threenative-playtest --build-report` into every scenario's `assert.performance`. The
384
+ * build measures none of it — it cannot; the numbers exist only once a runtime drew
385
+ * frames — so a budget never refuses a build and never passes one either.
386
+ */
387
+ readonly performanceBudget?: IThreeNativePerformanceBudget;
388
+ readonly assets?: Pick<NonNullable<IThreeNativeConfig["assets"]>, "audio" | "budget" | "lod" | "models" | "targets" | "textures">;
389
+ }>>;
390
+ };
280
391
  readonly assets?: {
281
392
  /**
282
393
  * Audio conditioning options, or `"none"` to ship every clip exactly as committed. Absent
@@ -294,6 +405,11 @@ interface IThreeNativeConfig {
294
405
  };
295
406
  /** Source-relative globs omitted from builds; excluded bytes are still reported. */
296
407
  readonly exclude?: readonly string[];
408
+ /**
409
+ * How many cook workers a bake may run at once; absent means the driver's default,
410
+ * min(4, cores - 1). Not part of any cache key, so changing it re-cooks nothing.
411
+ */
412
+ readonly concurrency?: number;
297
413
  /**
298
414
  * Automatic discrete LOD. `assets.lod: {}` opts in with the balanced default; `false` or
299
415
  * `{ enabled: false }` is the absolute kill switch, and per-asset overrides key off canonical
@@ -302,6 +418,12 @@ interface IThreeNativeConfig {
302
418
  */
303
419
  readonly lod?: boolean | IThreeNativeLodConfig;
304
420
  readonly models?: "none" | IThreeNativeModelsConfig;
421
+ /**
422
+ * Also emit the native cooked package (`<output>/native/assets.tnpk`, TNPK v1) beside the
423
+ * existing outputs, for a native-engine build that loads its assets without a JS `GLTFLoader`.
424
+ * Absent or `false` leaves the output set unchanged.
425
+ */
426
+ readonly nativePackage?: boolean;
305
427
  readonly output?: string;
306
428
  readonly source?: string;
307
429
  readonly targets?: {
@@ -336,7 +458,8 @@ interface IThreeNativeConfig {
336
458
  */
337
459
  readonly alphaAntialiasing?: boolean;
338
460
  /**
339
- * Whether the engine may render an internal mirror of the scene to collapse repeated draws.
461
+ * Whether the engine may render an internal mirror of the scene to collapse repeated draws,
462
+ * and how often that mirror proves a batched material still matches its group's shared draw.
340
463
  *
341
464
  * On by default, which is the shipping behaviour and is what an unset option means. The mirror
342
465
  * is opportunistic and correctness-preserving, but it pays a reconciliation cost per frame, so
@@ -345,8 +468,30 @@ interface IThreeNativeConfig {
345
468
  * eligibility scan, so the opt-out costs nothing rather than declining each frame; the authored
346
469
  * scene is what renders. The `TN_RENDER_PROJECTION` marker still reports it, with its own
347
470
  * reason code rather than one of the measured declines.
471
+ *
472
+ * An object instead of `false` names the material check:
473
+ *
474
+ * - `materialChecks: "spread"` — **the default.** A bounded slice of the batched materials is
475
+ * proved per frame instead of all of them, so a frame of 4,096 colour-only materials costs
476
+ * 512 checks rather than 4,096. A material that gains a roughness, a map or a define still
477
+ * leaves its group and is drawn exactly; it is caught up to `materialCheckStaleFrames` frames
478
+ * later, and `TN_RENDER_PROJECTION` reports that bound. A base-colour edit never waits: the
479
+ * per-instance colour is O(1) per member and always exact.
480
+ * - `materialChecks: "everyFrame"` — the named alternative, and the check exactly as it shipped
481
+ * before the sweep existed: every material proved every frame, at about 1.1 µs a material. Use
482
+ * it when a game would rather pay the per-frame cost than accept the bound.
483
+ *
484
+ * Any other value throws at startup rather than falling back to a default nobody asked for.
485
+ *
486
+ * `"js"` names the mirror on a host that would not build one. The native engine player batches
487
+ * the authored scene in its own renderer and reports `hostProjected`, so core builds no mirror and
488
+ * reads no object across the boundary. `"js"` forces the mirror there anyway (for a comparison, or
489
+ * a game that depends on it), and the report states `path: "js"` and `pathOverridden: true`. On
490
+ * three the mirror is the only path, so `"js"` changes nothing.
348
491
  */
349
- readonly projection?: boolean;
492
+ readonly projection?: boolean | "js" | {
493
+ readonly materialChecks?: "spread" | "everyFrame";
494
+ };
350
495
  /**
351
496
  * Projected diameter, in raster pixels, below which the engine does not submit an object to
352
497
  * the render camera. On by default at a conservative **0.5 px**: an object under half a pixel
@@ -408,6 +553,10 @@ interface IThreeNativeConfig {
408
553
  * view, or zero extra processes — and own the appearance difference, which is the trade
409
554
  * being made rather than something to discover in a screenshot.
410
555
  *
556
+ * `"native-css"` runs the same React tree in the game's own JS realm — no web view, no second
557
+ * process — with a native CSS engine painting it and the stylesheet coming from the same Vite +
558
+ * Tailwind build the web renderer uses. Desktop only, experimental, and opt-in.
559
+ *
411
560
  * Which surface `"web"` lands on is the platform's business and never a game's: no config,
412
561
  * type or document names the engine underneath.
413
562
  */
@@ -691,6 +840,14 @@ interface IRawInputState {
691
840
  buttons: readonly boolean[];
692
841
  };
693
842
  }
843
+ /**
844
+ * Ask the browser to lock the pointer to `target`, the capture every first-person mouse look needs.
845
+ *
846
+ * Returns the platform's own promise when it has one, so the caller can wait for the lock the way
847
+ * the browser reports it, and `undefined` when the platform answered synchronously. A target that
848
+ * cannot capture at all throws rather than leaving a game with a camera that never turns.
849
+ */
850
+ declare function captureMouse(target: EventTarget): Promise<void> | undefined;
694
851
  declare class InputMap {
695
852
  #private;
696
853
  readonly raw: IRawInputState;
@@ -736,6 +893,10 @@ interface IRenderPerformanceMetrics {
736
893
  }
737
894
  interface IRenderPerformanceSample extends IRenderPerformanceMetrics {
738
895
  readonly frameMs: number;
896
+ /** Successful render-callback completion ID; absolute across clears and retention. */
897
+ readonly sequence?: number;
898
+ /** Completion boundary from the monotonic phase clock, not the rAF timestamp or render-body cost. */
899
+ readonly completedAtMs?: number;
739
900
  /** Where this frame's milliseconds went. Present whenever a frame budget is installed. */
740
901
  readonly phases?: IFramePhaseSample;
741
902
  }
@@ -979,8 +1140,18 @@ interface IWarmUpOptions {
979
1140
  * How long the whole warm-up may take before it stops and lets the game start. Default 15000 ms.
980
1141
  *
981
1142
  * The launch must never be *worse* for having tried to optimize it.
1143
+ *
1144
+ * It bounds compilation only, and starts once the scene's environment is prepared: a
1145
+ * full-quality PMREM bake is lighting the first frame needs, not compile work, and on a software
1146
+ * adapter it alone outlasts this budget (about 20 s on 3-CPU SwiftShader).
982
1147
  */
983
1148
  readonly budgetMs?: number;
1149
+ /**
1150
+ * How long the scene environment's PMREM preparation may take before warm-up gives up on it and
1151
+ * compiles anyway. Default `STARTUP_HOLD_BUDGET_MS` (45000 ms), the startup bound for a game's own
1152
+ * launch work.
1153
+ */
1154
+ readonly environmentBudgetMs?: number;
984
1155
  /**
985
1156
  * How the scene is handed to the renderer. Default `"scene"`.
986
1157
  *
@@ -1025,6 +1196,8 @@ interface IWarmUpOptions {
1025
1196
  * `visibilityForced`, so a game can see how much of its scene the render had to un-hide.
1026
1197
  */
1027
1198
  readonly includeHidden?: boolean;
1199
+ /** The scene that supplies lights and environment when `scene` is an unattached object. */
1200
+ readonly targetScene?: Object3D;
1028
1201
  }
1029
1202
  /** What the warm-up did, so a caller can report it rather than assume it. */
1030
1203
  type WarmUpObservationStatus = "complete" | "incomplete" | "unavailable";
@@ -1110,6 +1283,15 @@ interface IWarmUpRenderer {
1110
1283
  compileAsync?: (scene: Object3D, camera: Camera, targetScene?: Object3D) => Promise<void>;
1111
1284
  computeAsync?: (node: unknown) => Promise<void>;
1112
1285
  pipelineCensus?: () => IPipelineCensus;
1286
+ /**
1287
+ * Performs one covered output-pipeline render without marking first present.
1288
+ *
1289
+ * May settle later than it returns: a renderer whose pipeline creation is asynchronous
1290
+ * (Three's `createRenderPipelineAsync` with its pending/skip draw check) starts the work here
1291
+ * and resolves once every requested pipeline exists, so the warm-up can wait instead of
1292
+ * compiling on the main thread.
1293
+ */
1294
+ warmUpWorldPass?: (scene: Object3D, camera: Camera, targetScene?: Object3D) => void | Promise<void>;
1113
1295
  /** The renderer's own render path, used to build every pass's pipelines once. */
1114
1296
  render?: (scene: Object3D, camera: Camera) => void;
1115
1297
  raw?: unknown;
@@ -1238,11 +1420,28 @@ interface IStartupStatus {
1238
1420
  * Throws on an empty or duplicate label, and on a hold registered after startup already
1239
1421
  * resolved — each means the caller believes it is gating something it is not.
1240
1422
  *
1423
+ * `progress` optionally observes monotonically completed work units (textures, placements or
1424
+ * cells), so a fixed display percentage cannot falsely report a stall. Use completed work,
1425
+ * never time or frame counts. Regressing/invalid values receive no credit, settlement freezes
1426
+ * the count, and the hold's original deadline still applies.
1427
+ * `work` may instead be a predicate, polled once per rendered frame until it returns true, for a
1428
+ * readiness the game measures rather than awaits (spawn cells loaded). It needs no simulation
1429
+ * step, so it also settles under a playtest's deterministic clock, which advances no fixed step
1430
+ * while startup is held. A throwing predicate counts as settled.
1431
+ *
1241
1432
  * @situation hold the loading screen until the game's own asset tier has landed
1242
1433
  */
1243
- hold(label: string, work: Promise<unknown>, budgetMs?: number): void;
1434
+ hold(label: string, work: Promise<unknown> | (() => boolean), budgetMs?: number, progress?: () => number): void;
1244
1435
  }
1245
1436
  interface ICtx<TState extends Record<string, unknown> = Record<string, unknown>, TPhysics = undefined> {
1437
+ /** Fraction of the next simulation tick accumulated for the presented frame, in [0, 1). */
1438
+ readonly alpha: number;
1439
+ /** The current frame callback timestamp in milliseconds, shared by web and native. */
1440
+ readonly frameTime: number;
1441
+ /** Opt a transform into draw-only fixed-step interpolation; returns scene-owned removal. */
1442
+ readonly interpolate: (object: Object3D) => () => void;
1443
+ /** Reset history after a game-driven teleport. */
1444
+ readonly resetInterpolation: (object: Object3D) => void;
1246
1445
  readonly fps: number;
1247
1446
  readonly renderer: IRendererLike;
1248
1447
  readonly viewport: Viewport;
@@ -1316,7 +1515,14 @@ interface IGameRuntimeObservations {
1316
1515
  contributions(): readonly IGameObservationContribution[];
1317
1516
  }
1318
1517
  interface IGamePluginRuntime {
1319
- readonly fixedStep: (ticks: number) => number;
1518
+ readonly fixedStep: (ticks: number, options?: {
1519
+ render?: boolean;
1520
+ }) => number;
1521
+ /** Completed scene updates and primary world render requests, independent of budget windows. */
1522
+ readonly frameCounts?: () => {
1523
+ updates: number;
1524
+ renders: number;
1525
+ };
1320
1526
  /**
1321
1527
  * Announces that a diagnostics consumer is going to read render metrics, turning per-frame
1322
1528
  * sample collection on for the rest of the run. Optional: a runtime without collection
@@ -1326,12 +1532,29 @@ interface IGamePluginRuntime {
1326
1532
  readonly enableRuntimeDiagnostics?: () => void;
1327
1533
  /** The frame's cost attribution so far, or undefined when the game turned the budget off. */
1328
1534
  readonly frameBudgetWindow?: () => IFrameBudgetWindow | undefined;
1535
+ /**
1536
+ * Stop the live clock, so a rendered frame simulates nothing and banks no wall-clock time.
1537
+ *
1538
+ * A run that counts fixed-step ticks must not also accumulate real seconds into the same
1539
+ * simulation, and the frames before its first `advance()` are exactly where a boot's seconds
1540
+ * used to land. Optional: a runtime without a clock just never freezes one.
1541
+ */
1542
+ readonly freezeClock?: () => void;
1543
+ /**
1544
+ * Draw the current world once without advancing it, for a screenshot taken while the loop is
1545
+ * driven by `fixedStep` and presents nothing between ticks. Optional: a runtime without a frozen
1546
+ * render loop just never draws a standing frame. The runner asks for it only when the bridge
1547
+ * advertises it and the capture cannot otherwise see a present.
1548
+ */
1549
+ readonly renderCurrent?: () => number;
1329
1550
  /**
1330
1551
  * Hold start-scene entry until `gate` settles.
1331
1552
  *
1332
- * The returned promise settles after `Scene.enter()` has run. A runner can therefore release the
1333
- * gate after applying pre-entry setup, then await the returned promise before describing
1334
- * entity-derived capabilities. The frame loop remains held throughout.
1553
+ * The returned promise settles after the scene that owns the world has entered: the start scene
1554
+ * unless it navigated out of its own `enter()`, in which case it is the scene it navigated to,
1555
+ * loaded and entered. A runner can therefore release the gate after applying pre-entry setup,
1556
+ * then await the returned promise before describing entity-derived capabilities — the entities
1557
+ * they read are the ones the world actually has. The frame loop remains held throughout.
1335
1558
  */
1336
1559
  readonly holdStart?: (gate: Promise<void>) => Promise<void>;
1337
1560
  readonly observations: IGameRuntimeObservations;
@@ -1433,6 +1656,8 @@ interface IGameConfig<TState extends Record<string, unknown> = Record<string, un
1433
1656
  * Maximum simulation steps per rendered frame. Default 5. Caps the catch-up burst after a
1434
1657
  * stall so a slow frame cannot cascade into a spiral of longer frames.
1435
1658
  */
1659
+ /** Smooth physics objects and the camera between fixed ticks. Default true. */
1660
+ readonly physicsInterpolation?: boolean;
1436
1661
  readonly maxSteps?: number;
1437
1662
  readonly platform?: IGamePlatformSource;
1438
1663
  readonly plugins?: readonly GamePlugin<TState, TPhysics>[];
@@ -1521,4 +1746,4 @@ interface IGame<TState extends Record<string, unknown> = Record<string, unknown>
1521
1746
  }
1522
1747
  declare function defineGame<TState extends Record<string, unknown>, TPhysics = undefined>(config: IGameConfig<TState, TPhysics>): IGame<TState, TPhysics>;
1523
1748
 
1524
- export { type IWarmUpRenderer as $, type AfterPhysicsCallback as A, type IRandom as B, type ContextMenuPolicy as C, type IRawInputPointer as D, type IRawInputPointerEdge as E, type IRawInputState as F, GEOMETRY_ASSET_KEY as G, type IRaycastOptions as H, type IGame as I, type IScenePickerOptions as J, type IThreeNativeAudioConfig as K, type IThreeNativeAudioLoop as L, type IThreeNativeAudioOverride as M, type IThreeNativeAudioSpectrum as N, type IThreeNativeBootSplash as O, type IThreeNativeConfig as P, type IThreeNativeIconVariants as Q, type IThreeNativeLodConfig as R, type IThreeNativeLodGenerationConfig as S, type IThreeNativeLodOverride as T, type IThreeNativeLodRuntimeConfig as U, type IThreeNativeTexturesConfig as V, type ITweenOptions as W, type IWarmUpCacheOptions as X, type IWarmUpObservation as Y, type IWarmUpOptions as Z, type IWarmUpProgress as _, type IGamePluginRuntime as a, type IWarmUpReport as a0, type InputBindings as a1, type InputPlatformSource as a2, type PointerEvent3DListener as a3, type PointerEvent3DType as a4, PointerEvents3D as a5, Scene as a6, type SceneFrame as a7, ScenePicker as a8, type ScheduleHandle as a9, Scheduler as aa, type ThreeNativeBackgroundMode as ab, type ThreeNativeLodMinTrianglesScope as ac, type ThreeNativeLodPreset as ad, type ThreeNativeOrientation as ae, type ThreeNativeUiRenderer as af, type WarmUpCacheStatus as ag, type WarmUpObservationStatus as ah, afterPhysics as ai, createRandom as aj, defineGame as ak, warmUpScene as al, type IGamePluginHooks as b, GEOMETRY_CAPTURE_DEFAULT_LIMIT as c, GEOMETRY_CAPTURE_MAX_LIMIT as d, GEOMETRY_CAPTURE_SORTS as e, GEOMETRY_CAPTURE_TIMEOUT_MS as f, GEOMETRY_CAPTURE_WALK_CAP as g, type GeometryCaptureSort as h, type ICtx as i, type IGameObservationContribution as j, type IGameObservationSampleRequest as k, type IGamePlatformSource as l, type IGeometryCaptureAsset as m, type IGeometryCaptureMesh as n, type IGeometryCapturePass as o, type IGeometryCaptureReport as p, type IGeometryCaptureRequest as q, type IGeometryCaptureRow as r, type IInputAction as s, type IInputGamepad as t, type IPointerDragHandle as u, type IPointerEvent3D as v, type IPointerEvents3D as w, type IPointerEvents3DOptions as x, type IPointerEvents3DPicker as y, type IPointerState as z };
1749
+ export { type IWarmUpRenderer as $, type AfterPhysicsCallback as A, type IRandom as B, type ContextMenuPolicy as C, type IRawInputPointer as D, type IRawInputPointerEdge as E, type IRawInputState as F, GEOMETRY_ASSET_KEY as G, type IRaycastOptions as H, type IGame as I, type IScenePickerOptions as J, type IThreeNativeAudioConfig as K, type IThreeNativeAudioLoop as L, type IThreeNativeAudioOverride as M, type IThreeNativeAudioSpectrum as N, type IThreeNativeBootSplash as O, type IThreeNativeConfig as P, type IThreeNativeIconVariants as Q, type IThreeNativeLodConfig as R, type IThreeNativeLodGenerationConfig as S, type IThreeNativeLodOverride as T, type IThreeNativeLodRuntimeConfig as U, type IThreeNativeTexturesConfig as V, type ITweenOptions as W, type IWarmUpCacheOptions as X, type IWarmUpObservation as Y, type IWarmUpOptions as Z, type IWarmUpProgress as _, type IGamePluginHooks as a, type IWarmUpReport as a0, type InputBindings as a1, InputMap as a2, type InputPlatformSource as a3, type PointerEvent3DListener as a4, type PointerEvent3DType as a5, PointerEvents3D as a6, Scene as a7, type SceneFrame as a8, ScenePicker as a9, type ScheduleHandle as aa, Scheduler as ab, type ThreeNativeBackgroundMode as ac, type ThreeNativeLodMinTrianglesScope as ad, type ThreeNativeLodPreset as ae, type ThreeNativeOrientation as af, type ThreeNativeUiRenderer as ag, type WarmUpCacheStatus as ah, type WarmUpObservationStatus as ai, afterPhysics as aj, captureMouse as ak, createRandom as al, defineGame as am, warmUpScene as an, type IGamePluginRuntime as b, GEOMETRY_CAPTURE_DEFAULT_LIMIT as c, GEOMETRY_CAPTURE_MAX_LIMIT as d, GEOMETRY_CAPTURE_SORTS as e, GEOMETRY_CAPTURE_TIMEOUT_MS as f, GEOMETRY_CAPTURE_WALK_CAP as g, type GeometryCaptureSort as h, type ICtx as i, type IGameObservationContribution as j, type IGameObservationSampleRequest as k, type IGamePlatformSource as l, type IGeometryCaptureAsset as m, type IGeometryCaptureMesh as n, type IGeometryCapturePass as o, type IGeometryCaptureReport as p, type IGeometryCaptureRequest as q, type IGeometryCaptureRow as r, type IInputAction as s, type IInputGamepad as t, type IPointerDragHandle as u, type IPointerEvent3D as v, type IPointerEvents3D as w, type IPointerEvents3DOptions as x, type IPointerEvents3DPicker as y, type IPointerState as z };
package/dist/hot.d.ts CHANGED
@@ -1,10 +1,10 @@
1
- import { a as audioRuntimeSnapshot } from './audio-7i3Xl0l3.js';
2
- import { I as IGame } from './game-D_6r-k4Y.js';
1
+ import { a as audioRuntimeSnapshot } from './audio-DIJE5HTr.js';
2
+ import { I as IGame } from './game-Bj8G1wmD.js';
3
3
  import 'three';
4
- import './assets-CYKk2WTu.js';
5
- import './renderer-Cy4qeBOA.js';
4
+ import './assets-CqvE429w.js';
5
+ import './renderer-9yEo9hPa.js';
6
6
  import 'three/webgpu';
7
- import './canvas-layer-C1SnMoJ-.js';
7
+ import './canvas-layer-C1-5CviZ.js';
8
8
  import 'zustand/vanilla';
9
9
 
10
10
  interface IHotDiagnostics {