@threenative/core 0.3.11 → 0.3.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/capabilities.json +1988 -204
- package/dist/{assets-YUbXa3-Y.d.ts → assets-CfMKnOsK.d.ts} +78 -1
- package/dist/camera-shake-CZKOfGn4.d.ts +46 -0
- package/dist/{canvas-layer-vCtanIeB.d.ts → canvas-layer-G7ttVy7y.d.ts} +1 -1
- package/dist/chunk-4SRAQFTU.js +133 -0
- package/dist/chunk-CFGTPFUH.js +231 -0
- package/dist/chunk-DIPIJICH.js +8916 -0
- package/dist/chunk-EEABDLUC.js +2237 -0
- package/dist/chunk-EFWZWLPY.js +1895 -0
- package/dist/chunk-GXY7B3JG.js +46 -0
- package/dist/chunk-GYUZJQ7U.js +280 -0
- package/dist/chunk-H4J6IAJE.js +504 -0
- package/dist/chunk-KIRUKTBQ.js +187 -0
- package/dist/chunk-QWJEMUUT.js +94 -0
- package/dist/chunk-SV4QVUTQ.js +31 -0
- package/dist/chunk-U4YHUKKL.js +615 -0
- package/dist/chunk-VP43GIWW.js +18 -0
- package/dist/chunk-XDTZ4QMO.js +160 -0
- package/dist/default-tone-mapping-GgKPTiBP.d.ts +4 -0
- package/dist/{game-DzMcitDO.d.ts → game-k8K3hZai.d.ts} +85 -9
- package/dist/hot.d.ts +5 -4
- package/dist/hot.js +5 -52
- package/dist/index.d.ts +633 -1351
- package/dist/index.js +12873 -23068
- package/dist/{model-lod-CTpZ6imz.d.ts → model-lod-DPTzeCcD.d.ts} +35 -3
- package/dist/playtest.d.ts +5 -4
- package/dist/playtest.js +25 -75
- package/dist/quality-BYqKGAwo.d.ts +868 -0
- package/dist/react-css.js +1 -215
- package/dist/react.d.ts +3 -2
- package/dist/render-environment.d.ts +170 -0
- package/dist/render-environment.js +352 -0
- package/dist/{renderer-rZm0hVqq.d.ts → renderer-BtOSseYf.d.ts} +42 -35
- package/dist/spells/index.d.ts +643 -0
- package/dist/spells/index.js +1558 -0
- package/dist/spells/ultra/index.d.ts +1600 -0
- package/dist/spells/ultra/index.js +6804 -0
- package/dist/terrain-jobs-worker.js +1 -123
- package/dist/two-sided-foliage-W523J3UM.js +1 -0
- package/dist/ui-layer.js +6 -384
- package/dist/worker.js +13 -43
- package/dist/world.d.ts +988 -268
- package/dist/world.js +17464 -18290
- package/mcp/animation-server.mjs +1 -1
- package/mcp/animation.mjs +2 -3
- package/mcp/engine-server.mjs +245 -52
- package/mcp/servers.mjs +10 -3
- package/mcp/terrain.mjs +8 -0
- package/package.json +19 -7
- package/patches/three@0.187.0-prd269-upgrade.patch +2102 -0
- package/patches/three@0.187.0.patch +2004 -407
- package/src/animation-batch.ts +193 -0
- package/src/animation-layers.ts +7 -3
- package/src/animation.ts +209 -29
- package/src/asset-cache.ts +3 -3
- package/src/asset-memo.ts +202 -0
- package/src/assets.ts +437 -125
- package/src/auto-batch.ts +190 -44
- package/src/card-lod.ts +152 -0
- package/src/compressed-texture-preparation.ts +1008 -0
- package/src/compute-driven.ts +1 -1
- package/src/config.ts +8 -0
- package/src/debug.ts +103 -22
- package/src/dev-global.ts +54 -0
- package/src/engine-hooks.ts +37 -0
- package/src/frame-budget.ts +50 -23
- package/src/game-boot-phase.ts +269 -0
- package/src/game-dev-tools.ts +86 -0
- package/src/game-frame-loop.ts +958 -0
- package/src/game-renderer-metrics.ts +77 -0
- package/src/game-startup.ts +1076 -0
- package/src/game-ui.ts +84 -0
- package/src/game-validate.ts +70 -0
- package/src/game.ts +198 -2264
- package/src/gamepad-mappings.ts +269 -0
- package/src/generated/console-markers.ts +13 -0
- package/src/geometry-capture.ts +28 -4
- package/src/gpu-readings.ts +98 -0
- package/src/gpu-scene-bvh.ts +149 -36
- package/src/hot.ts +4 -7
- package/src/index.ts +141 -9
- package/src/input.ts +237 -25
- package/src/instanced-batch-lod.ts +3 -8
- package/src/interpolation.ts +171 -40
- package/src/launch-diagnostics.ts +22 -12
- package/src/look/ao-admission.ts +25 -0
- package/src/look/auto-exposure.ts +5 -16
- package/src/look/default-tone-mapping.ts +41 -5
- package/src/look/filmic-tone-mapping.ts +15 -13
- package/src/look/local-exposure.ts +2 -7
- package/src/look/look-diagnostics.ts +3 -3
- package/src/look/quad-pass.ts +21 -0
- package/src/look/quality.ts +14 -5
- package/src/look/unreal-bloom.ts +4 -13
- package/src/look/world-environment.ts +113 -103
- package/src/loop.ts +29 -0
- package/src/merge-parts.ts +20 -24
- package/src/model-lod.ts +139 -17
- package/src/particle-kinds.ts +515 -0
- package/src/particle-significance.ts +12 -0
- package/src/particles.ts +19 -10
- package/src/picking.ts +17 -3
- package/src/platform.ts +23 -4
- package/src/playtest.ts +27 -1
- package/src/profiling/FrameStages.ts +5 -6
- package/src/profiling/Spans.ts +3 -17
- package/src/profiling/debug-telemetry.ts +2 -6
- package/src/profiling/render-list-validate.ts +6 -15
- package/src/projection-apply.ts +4 -1
- package/src/projection-marker.ts +2 -1
- package/src/projection-plan.ts +9 -6
- package/src/quiet-markers.ts +3 -10
- package/src/render/cpu-bvh.ts +100 -0
- package/src/render/depth-pyramid.ts +6 -14
- package/src/render/environment/environmentContribution.ts +202 -0
- package/src/render/environment/environmentRadiance.ts +44 -0
- package/src/render/environment/environmentSampleCache.ts +56 -0
- package/src/render/environment/environmentSampling.ts +201 -0
- package/src/render/environment/environmentSnapshot.ts +71 -0
- package/src/render/environment/gate.ts +57 -0
- package/src/render/mesh-pool.ts +4 -20
- package/src/render/probe-trace.ts +872 -0
- package/src/render/probe-volume.ts +780 -34
- package/src/render/radiance-cache.ts +17 -0
- package/src/render/resolution-subrect.ts +2 -0
- package/src/render/rough-diffuse.ts +46 -12
- package/src/render/soft-shadow.ts +27 -12
- package/src/render/virtual-shadow-adaptive.ts +55 -0
- package/src/render/virtual-shadow-casters.ts +175 -0
- package/src/render/virtual-shadow-layers.ts +76 -0
- package/src/render/virtual-shadow-level.ts +224 -0
- package/src/render/virtual-shadow-markers.ts +193 -0
- package/src/render/virtual-shadow-options.ts +370 -0
- package/src/render/virtual-shadow-pages.ts +5 -0
- package/src/render/virtual-shadow-partial.ts +13 -0
- package/src/render/virtual-shadow.ts +231 -1008
- package/src/render/world-impostor-surface.ts +402 -40
- package/src/render/world-impostor.ts +5 -2
- package/src/render-camera-cull.ts +98 -3
- package/src/render-environment.ts +41 -0
- package/src/render-pass-budget.ts +34 -7
- package/src/renderProjection.ts +22 -0
- package/src/renderer-config.ts +36 -0
- package/src/renderer-facts.ts +37 -0
- package/src/renderer.ts +144 -65
- package/src/resolution-scaler.ts +3 -2
- package/src/scene-entry-inspectors.ts +61 -0
- package/src/snow-field.ts +2 -1
- package/src/spells/cast-pool.ts +361 -0
- package/src/spells/index.ts +177 -0
- package/src/spells/mechanisms.ts +295 -0
- package/src/spells/reaction-field.ts +415 -0
- package/src/spells/spell-lights.ts +139 -0
- package/src/spells/spell-world.ts +187 -0
- package/src/spells/spell.ts +397 -0
- package/src/spells/spells.ts +283 -0
- package/src/spells/ultra/engine/camera.ts +184 -0
- package/src/spells/ultra/engine/quality.ts +96 -0
- package/src/spells/ultra/index.ts +52 -0
- package/src/spells/ultra/main.ts +305 -0
- package/src/spells/ultra/scene/arenaMaterial.ts +325 -0
- package/src/spells/ultra/spells/cast.ts +233 -0
- package/src/spells/ultra/spells/fire.ts +1267 -0
- package/src/spells/ultra/vfx/FluidVolume.ts +816 -0
- package/src/spells/ultra/vfx/FluidVolume.tsl.ts +855 -0
- package/src/spells/ultra/vfx/FxTarget.ts +61 -0
- package/src/spells/ultra/vfx/GroundField.ts +1399 -0
- package/src/spells/ultra/vfx/Particles.ts +1475 -0
- package/src/spells/ultra/vfx/Ribbons.ts +645 -0
- package/src/spells/ultra/vfx/Shockwaves.ts +286 -0
- package/src/spells/ultra/vfx/Volumes.ts +489 -0
- package/src/spells/ultra/vfx/common.ts +1195 -0
- package/src/spells/ultra/vfx/noise.ts +441 -0
- package/src/startup-offscreen-bytes.ts +78 -0
- package/src/startup-readiness.ts +128 -34
- package/src/static-transform.ts +25 -19
- package/src/streamed-textures.ts +112 -0
- package/src/streaming.ts +68 -4
- package/src/texture-streaming.ts +331 -0
- package/src/version.ts +1 -1
- package/src/warmup.ts +56 -8
- package/src/water-surface.ts +9 -3
- package/src/worker.ts +12 -2
- package/src/world-bundle-safety.ts +446 -0
- package/src/world-cell-batches.ts +1178 -0
- package/src/world-cell-chunks.ts +1128 -0
- package/src/world-cell-data.ts +995 -0
- package/src/world-cell-impostors.ts +1461 -0
- package/src/world-cell-lod-bias.ts +151 -0
- package/src/world-cell-models.ts +1074 -0
- package/src/world-cell-options.ts +177 -0
- package/src/world-cell-placements.ts +798 -0
- package/src/world-cell-prewarm.ts +592 -0
- package/src/world-cell-readiness.ts +357 -0
- package/src/world-cell-records.ts +401 -0
- package/src/world-cell-render-bundles.ts +459 -0
- package/src/world-cell-render-gpu-dress.ts +710 -0
- package/src/world-cell-render-main-cull.ts +540 -0
- package/src/world-cell-render-shadow-claims.ts +198 -0
- package/src/world-cell-render-util.ts +259 -0
- package/src/world-cell-render.ts +1501 -0
- package/src/world-cell-residency.ts +754 -0
- package/src/world-cell-stale.ts +238 -0
- package/src/world-cells.ts +1335 -10418
- package/src/world-chunk-shadow.ts +308 -0
- package/src/world-collar.ts +315 -0
- package/src/world-gpu-flags.ts +131 -0
- package/src/world-gpu-readback.ts +881 -0
- package/src/world-gpu-reference.ts +524 -0
- package/src/world-gpu-scene.ts +256 -2286
- package/src/world-gpu-shadow.ts +203 -0
- package/src/world-gpu-types.ts +409 -0
- package/src/world-gpu-validation.ts +518 -0
- package/src/world-heightfield.ts +802 -0
- package/src/world-load-limiter.ts +111 -0
- package/src/world-model-sections.ts +80 -0
- package/src/world-noise.ts +241 -0
- package/src/world-package.ts +42 -0
- package/src/world-region.ts +1 -1
- package/src/world-river-ribbon.ts +282 -0
- package/src/world-root-frame.ts +39 -0
- package/src/world-shore-field.ts +91 -0
- package/src/world-static-pose.ts +163 -0
- package/src/world-surface-sampler.ts +48 -0
- package/src/world-terrain-splat.ts +361 -153
- package/src/world-tile-budget.ts +249 -0
- package/src/world-tile-geometry.ts +469 -0
- package/src/world-tile-lod.ts +408 -0
- package/src/world-tile-observation.ts +566 -0
- package/src/world-tile-stitch.ts +166 -0
- package/src/world-tiles.ts +247 -1755
- package/src/world-validate.ts +6 -14
- package/src/world-warm.ts +51 -0
- package/src/world-water-bodies.ts +359 -0
- package/src/world.ts +48 -741
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// src/gpu-readback.ts
|
|
2
|
+
var GPUReadback = class {
|
|
3
|
+
everyFrames;
|
|
4
|
+
#attribute;
|
|
5
|
+
/** Frames observed through `request()`. The clock every other number here is measured against. */
|
|
6
|
+
#frame = 0;
|
|
7
|
+
/** The frame whose GPU state the landed bytes hold, or `-1` when nothing has landed. */
|
|
8
|
+
#sampleFrame = -1;
|
|
9
|
+
/** The frame the in-flight request was issued on, or `-1` when none is in flight. */
|
|
10
|
+
#requestedFrame = -1;
|
|
11
|
+
#pending = false;
|
|
12
|
+
#data;
|
|
13
|
+
#requests = 0;
|
|
14
|
+
#lands = 0;
|
|
15
|
+
#failures = 0;
|
|
16
|
+
#released = false;
|
|
17
|
+
constructor(options) {
|
|
18
|
+
if (options.attribute === void 0 || options.attribute === null)
|
|
19
|
+
throw new Error("GPUReadback.attribute is required.");
|
|
20
|
+
if (!Number.isInteger(options.everyFrames) || options.everyFrames <= 0)
|
|
21
|
+
throw new Error("GPUReadback.everyFrames must be a positive integer.");
|
|
22
|
+
this.#attribute = options.attribute;
|
|
23
|
+
this.everyFrames = options.everyFrames;
|
|
24
|
+
}
|
|
25
|
+
get released() {
|
|
26
|
+
return this.#released;
|
|
27
|
+
}
|
|
28
|
+
/** True while a copy is in flight. A game that wants to pace its own work can read it. */
|
|
29
|
+
get pending() {
|
|
30
|
+
return this.#pending;
|
|
31
|
+
}
|
|
32
|
+
/** The newest landed bytes, or `undefined` before the first copy lands. */
|
|
33
|
+
get data() {
|
|
34
|
+
return this.#data;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* How many frames old the landed bytes are.
|
|
38
|
+
*
|
|
39
|
+
* Before anything has landed this is the number of frames since construction, which grows
|
|
40
|
+
* without bound on purpose: "no data yet" and "data from frame zero" must not read the same.
|
|
41
|
+
*/
|
|
42
|
+
get staleFrames() {
|
|
43
|
+
if (this.#sampleFrame < 0) return this.#frame;
|
|
44
|
+
return this.#frame - this.#sampleFrame;
|
|
45
|
+
}
|
|
46
|
+
/** The newest bytes with their age attached, or `undefined` before the first copy lands. */
|
|
47
|
+
get sample() {
|
|
48
|
+
if (this.#data === void 0) return void 0;
|
|
49
|
+
return { data: this.#data, staleFrames: this.staleFrames };
|
|
50
|
+
}
|
|
51
|
+
/** Requests, landings and failures, for a report that has to say why a sample is old. */
|
|
52
|
+
get stats() {
|
|
53
|
+
return { requests: this.#requests, lands: this.#lands, failures: this.#failures };
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Advances the frame clock and starts a copy when the throttle allows one.
|
|
57
|
+
*
|
|
58
|
+
* Safe to call every frame. It returns before the GPU has answered — awaiting it is the one
|
|
59
|
+
* thing that would turn this class into the stall it exists to avoid.
|
|
60
|
+
*/
|
|
61
|
+
request(renderer) {
|
|
62
|
+
if (this.#released) throw new Error("GPUReadback cannot request after release.");
|
|
63
|
+
this.#frame += 1;
|
|
64
|
+
if (this.#pending) return;
|
|
65
|
+
if (this.#requestedFrame >= 0 && this.#frame - this.#requestedFrame < this.everyFrames) return;
|
|
66
|
+
const issuedFrame = this.#frame;
|
|
67
|
+
this.#requestedFrame = issuedFrame;
|
|
68
|
+
this.#pending = true;
|
|
69
|
+
this.#requests += 1;
|
|
70
|
+
renderer.readback(this.#attribute).then((bytes) => this.#land(bytes, issuedFrame)).catch(() => this.#fail());
|
|
71
|
+
}
|
|
72
|
+
#land(bytes, issuedFrame) {
|
|
73
|
+
this.#pending = false;
|
|
74
|
+
if (this.#released) return;
|
|
75
|
+
this.#data = new Float32Array(bytes);
|
|
76
|
+
this.#sampleFrame = issuedFrame;
|
|
77
|
+
this.#lands += 1;
|
|
78
|
+
}
|
|
79
|
+
#fail() {
|
|
80
|
+
this.#pending = false;
|
|
81
|
+
if (this.#released) return;
|
|
82
|
+
this.#failures += 1;
|
|
83
|
+
}
|
|
84
|
+
/** Drops the attribute reference and the landed bytes. Further requests throw. */
|
|
85
|
+
dispose() {
|
|
86
|
+
if (this.#released) return;
|
|
87
|
+
this.#released = true;
|
|
88
|
+
this.#pending = false;
|
|
89
|
+
this.#attribute = void 0;
|
|
90
|
+
this.#data = void 0;
|
|
91
|
+
}
|
|
92
|
+
};
|
|
93
|
+
|
|
94
|
+
export { GPUReadback };
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { readLaunchFlag } from './chunk-GYUZJQ7U.js';
|
|
2
|
+
|
|
3
|
+
// src/quiet-markers.ts
|
|
4
|
+
var LOG_FLAG = "TN_LOG";
|
|
5
|
+
var BROWSER_PROTOCOLS = /* @__PURE__ */ new Set(["http:", "https:", "file:"]);
|
|
6
|
+
var restore;
|
|
7
|
+
function markerLogRequested() {
|
|
8
|
+
return readLaunchFlag({ environment: LOG_FLAG, global: "__THREENATIVE_LOG__", query: "tnLog" });
|
|
9
|
+
}
|
|
10
|
+
function installQuietMarkers() {
|
|
11
|
+
const protocol = globalThis.location?.protocol;
|
|
12
|
+
if (restore !== void 0 || typeof protocol !== "string" || !BROWSER_PROTOCOLS.has(protocol))
|
|
13
|
+
return;
|
|
14
|
+
if (markerLogRequested()) return;
|
|
15
|
+
const original = { log: console.log, info: console.info };
|
|
16
|
+
const quiet = (method) => (...args) => {
|
|
17
|
+
if (typeof args[0] === "string" && args[0].startsWith("TN_")) console.debug(...args);
|
|
18
|
+
else method.apply(console, args);
|
|
19
|
+
};
|
|
20
|
+
console.log = quiet(original.log);
|
|
21
|
+
console.info = quiet(original.info);
|
|
22
|
+
restore = original;
|
|
23
|
+
}
|
|
24
|
+
function uninstallQuietMarkers() {
|
|
25
|
+
if (restore === void 0) return;
|
|
26
|
+
console.log = restore.log;
|
|
27
|
+
console.info = restore.info;
|
|
28
|
+
restore = void 0;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export { installQuietMarkers, markerLogRequested, uninstallQuietMarkers };
|