@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.
- package/capabilities.json +2019 -59
- package/dist/{assets-CYKk2WTu.d.ts → assets-CqvE429w.d.ts} +45 -3
- package/dist/{audio-7i3Xl0l3.d.ts → audio-DIJE5HTr.d.ts} +43 -3
- package/dist/{canvas-layer-C1SnMoJ-.d.ts → canvas-layer-C1-5CviZ.d.ts} +5 -1
- package/dist/{game-D_6r-k4Y.d.ts → game-Bj8G1wmD.d.ts} +242 -17
- package/dist/hot.d.ts +5 -5
- package/dist/index.d.ts +1131 -105
- package/dist/index.js +15201 -4782
- package/dist/model-lod-BDAUYgsS.d.ts +197 -0
- package/dist/playtest.d.ts +6 -4
- package/dist/playtest.js +84 -11
- package/dist/react-css.d.ts +62 -0
- package/dist/react-css.js +591 -0
- package/dist/react.d.ts +2 -2
- package/dist/{renderer-Cy4qeBOA.d.ts → renderer-9yEo9hPa.d.ts} +676 -21
- package/dist/terrain-jobs-worker.d.ts +2 -0
- package/dist/terrain-jobs-worker.js +130 -0
- package/dist/ui-layer.d.ts +5 -3
- package/dist/ui-layer.js +59 -8
- package/dist/world.d.ts +1596 -17
- package/dist/world.js +17035 -521
- package/gpl/fixtures/make_world_fixture.py +184 -0
- package/gpl/recipes/_common.py +11 -0
- package/gpl/recipes/decimate.py +11 -5
- package/gpl/recipes/export_world.py +699 -0
- package/mcp/blender-server.mjs +61 -4
- package/mcp/blender.mjs +3 -4
- package/mcp/engine-server.mjs +55 -21
- package/mcp/servers.mjs +4 -4
- package/package.json +15 -9
- package/patches/three@0.185.1-prd269-upgrade.patch +22418 -0
- package/patches/three@0.185.1.patch +8246 -389
- package/scripts/apply-three-patch.mjs +123 -41
- package/src/animation-blend.ts +264 -0
- package/src/animation-composition.ts +362 -0
- package/src/animation-layers.ts +260 -0
- package/src/animation-root-motion.ts +283 -0
- package/src/animation.ts +896 -0
- package/src/assets.ts +1303 -0
- package/src/atmosphere/index.ts +335 -0
- package/src/atmosphere/luts.ts +298 -0
- package/src/atmosphere/params.ts +323 -0
- package/src/audio.ts +912 -0
- package/src/billboard.ts +124 -0
- package/src/bone-lengths.ts +157 -0
- package/src/camera-shake.ts +116 -0
- package/src/canvas-layer.ts +47 -0
- package/src/clip-audit.ts +401 -0
- package/src/clustered-batch.ts +492 -0
- package/src/clustered-mesh.ts +638 -0
- package/src/compute-driven.ts +176 -0
- package/src/compute-timing.ts +318 -0
- package/src/config.ts +593 -0
- package/src/debug.ts +82 -0
- package/src/engine-render-hook.ts +25 -0
- package/src/entities.ts +79 -0
- package/src/entity-snapshot.ts +53 -0
- package/src/flight.ts +683 -0
- package/src/fluid-field.ts +748 -0
- package/src/fluid-particles.ts +1253 -0
- package/src/frame-budget.ts +1368 -0
- package/src/game.ts +2390 -0
- package/src/geometry-capture.ts +1098 -0
- package/src/gpu-class.ts +160 -0
- package/src/gpu-frame-observation.ts +424 -0
- package/src/gpu-readback.ts +143 -0
- package/src/gpu-scene-bvh.ts +464 -0
- package/src/grounding.ts +100 -0
- package/src/hot.ts +161 -0
- package/src/import-meta.d.ts +13 -0
- package/src/index.ts +1536 -0
- package/src/input.ts +690 -0
- package/src/instanced-batch-lod.ts +283 -0
- package/src/instanced-batch.ts +274 -0
- package/src/interpolation.ts +129 -0
- package/src/launch-diagnostics.ts +161 -0
- package/src/loop.ts +564 -0
- package/src/matrix-world.ts +245 -0
- package/src/merge-parts.ts +812 -0
- package/src/model-lod.ts +1315 -0
- package/src/net-protocol.ts +333 -0
- package/src/net-session.ts +477 -0
- package/src/net.ts +80 -0
- package/src/ocean/fft.ts +72 -0
- package/src/ocean/spectral.ts +728 -0
- package/src/particle-significance.ts +102 -0
- package/src/particles.ts +648 -0
- package/src/path-follow.ts +175 -0
- package/src/picking.ts +250 -0
- package/src/pipeline-census.ts +1566 -0
- package/src/platform.ts +210 -0
- package/src/playtest.ts +839 -0
- package/src/pointer-events.ts +411 -0
- package/src/pose-measure.ts +435 -0
- package/src/profiling/FrameCounters.ts +231 -0
- package/src/profiling/Spans.ts +548 -0
- package/src/profiling/opacity-convention.ts +21 -0
- package/src/profiling/render-list-validate.ts +175 -0
- package/src/profiling/render-trap-audit.ts +84 -0
- package/src/profiling/scene-warning.ts +190 -0
- package/src/profiling/span-probes.ts +191 -0
- package/src/profiling/unlit-foliage-warning.ts +149 -0
- package/src/projection-apply.ts +1529 -0
- package/src/projection-marker.ts +142 -0
- package/src/projection-plan.ts +1258 -0
- package/src/projection-skinned.ts +419 -0
- package/src/projection-stability.ts +409 -0
- package/src/projection-uniform.ts +328 -0
- package/src/random.ts +41 -0
- package/src/react-css.ts +604 -0
- package/src/react-glyphs.ts +114 -0
- package/src/react-host.ts +576 -0
- package/src/react-layout.ts +265 -0
- package/src/react.ts +60 -0
- package/src/render/alpha-antialiasing.ts +159 -0
- package/src/render/batched-velocity.ts +126 -0
- package/src/render/chain.ts +1021 -0
- package/src/render/daylight.ts +189 -0
- package/src/render/depth-pyramid.ts +596 -0
- package/src/render/foliage-alpha.ts +166 -0
- package/src/render/material-key.ts +60 -0
- package/src/render/mesh-pool.ts +144 -0
- package/src/render/probe-volume.ts +1668 -0
- package/src/render/resolution-subrect.ts +253 -0
- package/src/render/velocity.ts +442 -0
- package/src/render/virtual-shadow-pages.ts +827 -0
- package/src/render/virtual-shadow-partial.ts +174 -0
- package/src/render/virtual-shadow.ts +3330 -0
- package/src/render/world-impostor-surface.ts +722 -0
- package/src/render/world-impostor.ts +558 -0
- package/src/render-camera-cull.ts +441 -0
- package/src/render-pass-budget.ts +501 -0
- package/src/renderProjection.ts +758 -0
- package/src/renderer-config.ts +127 -0
- package/src/renderer.ts +1847 -0
- package/src/replay-protocol.ts +85 -0
- package/src/replay.ts +205 -0
- package/src/resolution-scaler.ts +819 -0
- package/src/rig-preparation.ts +271 -0
- package/src/ripple-field.ts +432 -0
- package/src/scale.ts +109 -0
- package/src/scene.ts +239 -0
- package/src/schedule.ts +155 -0
- package/src/skeletal-mesh.ts +61 -0
- package/src/skeleton.ts +100 -0
- package/src/snow-field.ts +744 -0
- package/src/softbody-topology.ts +269 -0
- package/src/softbody.ts +516 -0
- package/src/sprite-animator.ts +222 -0
- package/src/startup-readiness.ts +386 -0
- package/src/state.ts +66 -0
- package/src/static-transform.ts +274 -0
- package/src/storage-buffer.ts +253 -0
- package/src/streaming.ts +308 -0
- package/src/target-fps.ts +92 -0
- package/src/terrain-jobs-worker.ts +17 -0
- package/src/terrain-jobs.ts +353 -0
- package/src/textures.ts +39 -0
- package/src/tracers.ts +237 -0
- package/src/ui-bridge.ts +368 -0
- package/src/ui-hit-regions.ts +380 -0
- package/src/ui-layer.ts +83 -0
- package/src/ui-state.ts +220 -0
- package/src/version.ts +2 -0
- package/src/viewport.ts +253 -0
- package/src/warmup.ts +1357 -0
- package/src/water-surface.ts +384 -0
- package/src/wave-field.ts +524 -0
- package/src/world-capabilities.ts +131 -0
- package/src/world-cell-proxy.ts +392 -0
- package/src/world-cells.ts +10564 -0
- package/src/world-gpu-scene.ts +3354 -0
- package/src/world-heightmap.ts +82 -0
- package/src/world-package.ts +469 -0
- package/src/world-passes.ts +582 -0
- package/src/world-region.ts +17 -0
- package/src/world-terrain-splat.ts +564 -0
- package/src/world-tiles.ts +3826 -0
- package/src/world-topology.ts +370 -0
- package/src/world-validate.ts +48 -0
- package/src/world.ts +805 -0
- 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
|
-
|
|
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
|
|
89
|
-
* `detune`
|
|
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
|
|
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-
|
|
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-
|
|
2
|
-
import { F as FramePassKind,
|
|
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-
|
|
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
|
-
/**
|
|
85
|
-
readonly
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
1333
|
-
*
|
|
1334
|
-
*
|
|
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
|
|
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-
|
|
2
|
-
import { I as IGame } from './game-
|
|
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-
|
|
5
|
-
import './renderer-
|
|
4
|
+
import './assets-CqvE429w.js';
|
|
5
|
+
import './renderer-9yEo9hPa.js';
|
|
6
6
|
import 'three/webgpu';
|
|
7
|
-
import './canvas-layer-
|
|
7
|
+
import './canvas-layer-C1-5CviZ.js';
|
|
8
8
|
import 'zustand/vanilla';
|
|
9
9
|
|
|
10
10
|
interface IHotDiagnostics {
|