@threenative/core 0.3.11 → 0.3.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (236) hide show
  1. package/README.md +1 -1
  2. package/capabilities.json +1988 -204
  3. package/dist/{assets-YUbXa3-Y.d.ts → assets-CfMKnOsK.d.ts} +78 -1
  4. package/dist/camera-shake-CZKOfGn4.d.ts +46 -0
  5. package/dist/{canvas-layer-vCtanIeB.d.ts → canvas-layer-G7ttVy7y.d.ts} +1 -1
  6. package/dist/chunk-4SRAQFTU.js +133 -0
  7. package/dist/chunk-CFGTPFUH.js +231 -0
  8. package/dist/chunk-DIPIJICH.js +8916 -0
  9. package/dist/chunk-EEABDLUC.js +2237 -0
  10. package/dist/chunk-EFWZWLPY.js +1895 -0
  11. package/dist/chunk-GXY7B3JG.js +46 -0
  12. package/dist/chunk-GYUZJQ7U.js +280 -0
  13. package/dist/chunk-H4J6IAJE.js +504 -0
  14. package/dist/chunk-KIRUKTBQ.js +187 -0
  15. package/dist/chunk-QWJEMUUT.js +94 -0
  16. package/dist/chunk-SV4QVUTQ.js +31 -0
  17. package/dist/chunk-U4YHUKKL.js +615 -0
  18. package/dist/chunk-VP43GIWW.js +18 -0
  19. package/dist/chunk-XDTZ4QMO.js +160 -0
  20. package/dist/default-tone-mapping-GgKPTiBP.d.ts +4 -0
  21. package/dist/{game-DzMcitDO.d.ts → game-k8K3hZai.d.ts} +85 -9
  22. package/dist/hot.d.ts +5 -4
  23. package/dist/hot.js +5 -52
  24. package/dist/index.d.ts +633 -1351
  25. package/dist/index.js +12873 -23068
  26. package/dist/{model-lod-CTpZ6imz.d.ts → model-lod-DPTzeCcD.d.ts} +35 -3
  27. package/dist/playtest.d.ts +5 -4
  28. package/dist/playtest.js +25 -75
  29. package/dist/quality-BYqKGAwo.d.ts +868 -0
  30. package/dist/react-css.js +1 -215
  31. package/dist/react.d.ts +3 -2
  32. package/dist/render-environment.d.ts +170 -0
  33. package/dist/render-environment.js +352 -0
  34. package/dist/{renderer-rZm0hVqq.d.ts → renderer-BtOSseYf.d.ts} +42 -35
  35. package/dist/spells/index.d.ts +643 -0
  36. package/dist/spells/index.js +1558 -0
  37. package/dist/spells/ultra/index.d.ts +1600 -0
  38. package/dist/spells/ultra/index.js +6804 -0
  39. package/dist/terrain-jobs-worker.js +1 -123
  40. package/dist/two-sided-foliage-W523J3UM.js +1 -0
  41. package/dist/ui-layer.js +6 -384
  42. package/dist/worker.js +13 -43
  43. package/dist/world.d.ts +988 -268
  44. package/dist/world.js +17464 -18290
  45. package/mcp/animation-server.mjs +1 -1
  46. package/mcp/animation.mjs +2 -3
  47. package/mcp/engine-server.mjs +245 -52
  48. package/mcp/servers.mjs +10 -3
  49. package/mcp/terrain.mjs +8 -0
  50. package/package.json +19 -7
  51. package/patches/three@0.187.0-prd269-upgrade.patch +2102 -0
  52. package/patches/three@0.187.0.patch +2004 -407
  53. package/src/animation-batch.ts +193 -0
  54. package/src/animation-layers.ts +7 -3
  55. package/src/animation.ts +209 -29
  56. package/src/asset-cache.ts +3 -3
  57. package/src/asset-memo.ts +202 -0
  58. package/src/assets.ts +437 -125
  59. package/src/auto-batch.ts +190 -44
  60. package/src/card-lod.ts +152 -0
  61. package/src/compressed-texture-preparation.ts +1008 -0
  62. package/src/compute-driven.ts +1 -1
  63. package/src/config.ts +8 -0
  64. package/src/debug.ts +103 -22
  65. package/src/dev-global.ts +54 -0
  66. package/src/engine-hooks.ts +37 -0
  67. package/src/frame-budget.ts +50 -23
  68. package/src/game-boot-phase.ts +269 -0
  69. package/src/game-dev-tools.ts +86 -0
  70. package/src/game-frame-loop.ts +958 -0
  71. package/src/game-renderer-metrics.ts +77 -0
  72. package/src/game-startup.ts +1076 -0
  73. package/src/game-ui.ts +84 -0
  74. package/src/game-validate.ts +70 -0
  75. package/src/game.ts +198 -2264
  76. package/src/gamepad-mappings.ts +269 -0
  77. package/src/generated/console-markers.ts +13 -0
  78. package/src/geometry-capture.ts +28 -4
  79. package/src/gpu-readings.ts +98 -0
  80. package/src/gpu-scene-bvh.ts +149 -36
  81. package/src/hot.ts +4 -7
  82. package/src/index.ts +141 -9
  83. package/src/input.ts +237 -25
  84. package/src/instanced-batch-lod.ts +3 -8
  85. package/src/interpolation.ts +171 -40
  86. package/src/launch-diagnostics.ts +22 -12
  87. package/src/look/ao-admission.ts +25 -0
  88. package/src/look/auto-exposure.ts +5 -16
  89. package/src/look/default-tone-mapping.ts +41 -5
  90. package/src/look/filmic-tone-mapping.ts +15 -13
  91. package/src/look/local-exposure.ts +2 -7
  92. package/src/look/look-diagnostics.ts +3 -3
  93. package/src/look/quad-pass.ts +21 -0
  94. package/src/look/quality.ts +14 -5
  95. package/src/look/unreal-bloom.ts +4 -13
  96. package/src/look/world-environment.ts +113 -103
  97. package/src/loop.ts +29 -0
  98. package/src/merge-parts.ts +20 -24
  99. package/src/model-lod.ts +139 -17
  100. package/src/particle-kinds.ts +515 -0
  101. package/src/particle-significance.ts +12 -0
  102. package/src/particles.ts +19 -10
  103. package/src/picking.ts +17 -3
  104. package/src/platform.ts +23 -4
  105. package/src/playtest.ts +27 -1
  106. package/src/profiling/FrameStages.ts +5 -6
  107. package/src/profiling/Spans.ts +3 -17
  108. package/src/profiling/debug-telemetry.ts +2 -6
  109. package/src/profiling/render-list-validate.ts +6 -15
  110. package/src/projection-apply.ts +4 -1
  111. package/src/projection-marker.ts +2 -1
  112. package/src/projection-plan.ts +9 -6
  113. package/src/quiet-markers.ts +3 -10
  114. package/src/render/cpu-bvh.ts +100 -0
  115. package/src/render/depth-pyramid.ts +6 -14
  116. package/src/render/environment/environmentContribution.ts +202 -0
  117. package/src/render/environment/environmentRadiance.ts +44 -0
  118. package/src/render/environment/environmentSampleCache.ts +56 -0
  119. package/src/render/environment/environmentSampling.ts +201 -0
  120. package/src/render/environment/environmentSnapshot.ts +71 -0
  121. package/src/render/environment/gate.ts +57 -0
  122. package/src/render/mesh-pool.ts +4 -20
  123. package/src/render/probe-trace.ts +872 -0
  124. package/src/render/probe-volume.ts +780 -34
  125. package/src/render/radiance-cache.ts +17 -0
  126. package/src/render/resolution-subrect.ts +2 -0
  127. package/src/render/rough-diffuse.ts +46 -12
  128. package/src/render/soft-shadow.ts +27 -12
  129. package/src/render/virtual-shadow-adaptive.ts +55 -0
  130. package/src/render/virtual-shadow-casters.ts +175 -0
  131. package/src/render/virtual-shadow-layers.ts +76 -0
  132. package/src/render/virtual-shadow-level.ts +224 -0
  133. package/src/render/virtual-shadow-markers.ts +193 -0
  134. package/src/render/virtual-shadow-options.ts +370 -0
  135. package/src/render/virtual-shadow-pages.ts +5 -0
  136. package/src/render/virtual-shadow-partial.ts +13 -0
  137. package/src/render/virtual-shadow.ts +231 -1008
  138. package/src/render/world-impostor-surface.ts +402 -40
  139. package/src/render/world-impostor.ts +5 -2
  140. package/src/render-camera-cull.ts +98 -3
  141. package/src/render-environment.ts +41 -0
  142. package/src/render-pass-budget.ts +34 -7
  143. package/src/renderProjection.ts +22 -0
  144. package/src/renderer-config.ts +36 -0
  145. package/src/renderer-facts.ts +37 -0
  146. package/src/renderer.ts +144 -65
  147. package/src/resolution-scaler.ts +3 -2
  148. package/src/scene-entry-inspectors.ts +61 -0
  149. package/src/snow-field.ts +2 -1
  150. package/src/spells/cast-pool.ts +361 -0
  151. package/src/spells/index.ts +177 -0
  152. package/src/spells/mechanisms.ts +295 -0
  153. package/src/spells/reaction-field.ts +415 -0
  154. package/src/spells/spell-lights.ts +139 -0
  155. package/src/spells/spell-world.ts +187 -0
  156. package/src/spells/spell.ts +397 -0
  157. package/src/spells/spells.ts +283 -0
  158. package/src/spells/ultra/engine/camera.ts +184 -0
  159. package/src/spells/ultra/engine/quality.ts +96 -0
  160. package/src/spells/ultra/index.ts +52 -0
  161. package/src/spells/ultra/main.ts +305 -0
  162. package/src/spells/ultra/scene/arenaMaterial.ts +325 -0
  163. package/src/spells/ultra/spells/cast.ts +233 -0
  164. package/src/spells/ultra/spells/fire.ts +1267 -0
  165. package/src/spells/ultra/vfx/FluidVolume.ts +816 -0
  166. package/src/spells/ultra/vfx/FluidVolume.tsl.ts +855 -0
  167. package/src/spells/ultra/vfx/FxTarget.ts +61 -0
  168. package/src/spells/ultra/vfx/GroundField.ts +1399 -0
  169. package/src/spells/ultra/vfx/Particles.ts +1475 -0
  170. package/src/spells/ultra/vfx/Ribbons.ts +645 -0
  171. package/src/spells/ultra/vfx/Shockwaves.ts +286 -0
  172. package/src/spells/ultra/vfx/Volumes.ts +489 -0
  173. package/src/spells/ultra/vfx/common.ts +1195 -0
  174. package/src/spells/ultra/vfx/noise.ts +441 -0
  175. package/src/startup-offscreen-bytes.ts +78 -0
  176. package/src/startup-readiness.ts +128 -34
  177. package/src/static-transform.ts +25 -19
  178. package/src/streamed-textures.ts +112 -0
  179. package/src/streaming.ts +68 -4
  180. package/src/texture-streaming.ts +331 -0
  181. package/src/version.ts +1 -1
  182. package/src/warmup.ts +56 -8
  183. package/src/water-surface.ts +9 -3
  184. package/src/worker.ts +12 -2
  185. package/src/world-bundle-safety.ts +446 -0
  186. package/src/world-cell-batches.ts +1178 -0
  187. package/src/world-cell-chunks.ts +1128 -0
  188. package/src/world-cell-data.ts +995 -0
  189. package/src/world-cell-impostors.ts +1461 -0
  190. package/src/world-cell-lod-bias.ts +151 -0
  191. package/src/world-cell-models.ts +1074 -0
  192. package/src/world-cell-options.ts +177 -0
  193. package/src/world-cell-placements.ts +798 -0
  194. package/src/world-cell-prewarm.ts +592 -0
  195. package/src/world-cell-readiness.ts +357 -0
  196. package/src/world-cell-records.ts +401 -0
  197. package/src/world-cell-render-bundles.ts +459 -0
  198. package/src/world-cell-render-gpu-dress.ts +710 -0
  199. package/src/world-cell-render-main-cull.ts +540 -0
  200. package/src/world-cell-render-shadow-claims.ts +198 -0
  201. package/src/world-cell-render-util.ts +259 -0
  202. package/src/world-cell-render.ts +1501 -0
  203. package/src/world-cell-residency.ts +754 -0
  204. package/src/world-cell-stale.ts +238 -0
  205. package/src/world-cells.ts +1335 -10418
  206. package/src/world-chunk-shadow.ts +308 -0
  207. package/src/world-collar.ts +315 -0
  208. package/src/world-gpu-flags.ts +131 -0
  209. package/src/world-gpu-readback.ts +881 -0
  210. package/src/world-gpu-reference.ts +524 -0
  211. package/src/world-gpu-scene.ts +256 -2286
  212. package/src/world-gpu-shadow.ts +203 -0
  213. package/src/world-gpu-types.ts +409 -0
  214. package/src/world-gpu-validation.ts +518 -0
  215. package/src/world-heightfield.ts +802 -0
  216. package/src/world-load-limiter.ts +111 -0
  217. package/src/world-model-sections.ts +80 -0
  218. package/src/world-noise.ts +241 -0
  219. package/src/world-package.ts +42 -0
  220. package/src/world-region.ts +1 -1
  221. package/src/world-river-ribbon.ts +282 -0
  222. package/src/world-root-frame.ts +39 -0
  223. package/src/world-shore-field.ts +91 -0
  224. package/src/world-static-pose.ts +163 -0
  225. package/src/world-surface-sampler.ts +48 -0
  226. package/src/world-terrain-splat.ts +361 -153
  227. package/src/world-tile-budget.ts +249 -0
  228. package/src/world-tile-geometry.ts +469 -0
  229. package/src/world-tile-lod.ts +408 -0
  230. package/src/world-tile-observation.ts +566 -0
  231. package/src/world-tile-stitch.ts +166 -0
  232. package/src/world-tiles.ts +247 -1755
  233. package/src/world-validate.ts +6 -14
  234. package/src/world-warm.ts +51 -0
  235. package/src/world-water-bodies.ts +359 -0
  236. package/src/world.ts +48 -741
@@ -0,0 +1,177 @@
1
+ import { readLaunchValue } from "./debug.js";
2
+ import { INSTANCED_LOD_MAX_PIXEL_ERROR } from "./instanced-batch-lod.js";
3
+ import type { IWorldCellsLoadOptions } from "./world-cell-data.js";
4
+ import type { IWorldCell, IWorldPackage } from "./world-package.js";
5
+
6
+ /**
7
+ * `world-cells.ts`'s load options: the defaults a package does not name, the three places a launch
8
+ * states a switch, and the validation that turns a malformed option into a throw before a frame.
9
+ *
10
+ * The defaults live here rather than beside the class so the numbers a game can override are one
11
+ * file: a change to a default is a change to this module, and the class only reads what it exports.
12
+ * The launch readers are the option layer's own — `world-gpu-scene.ts` keeps the subsystem switches
13
+ * (`gpuScene`, `bundles`, `gpuSceneValidate`, `shadowGpuKeys`), and this file keeps the ones the
14
+ * world owns as a whole (impostors, the adaptive bias and its share of the frame).
15
+ */
16
+
17
+ export const DEFAULT_TILE_RESOLUTION = 129;
18
+
19
+ /**
20
+ * One tile vertex per heightmap sample, rounded up so every default lod factor (1, 2, 4) divides it
21
+ * and capped at the old fixed 129. A finer tile only interpolates the same samples: 129 over a 2 m
22
+ * heightmap drew 3.01M terrain triangles, 25 ms on an Iris Xe (PRD-762).
23
+ */
24
+ export function tileResolutionFor(tileSize: number, spacing: number): number {
25
+ const cells = Math.ceil(tileSize / spacing / 4) * 4;
26
+ return Math.min(DEFAULT_TILE_RESOLUTION, Math.max(9, cells + 1));
27
+ }
28
+
29
+ export const DEFAULT_ADMISSION_BUDGET_MS = 2;
30
+ /**
31
+ * How much more one `update` may admit while the startup cover hides the world: 8x takes the 2 ms
32
+ * default to one 60 Hz frame. Nobody sees frame pacing behind an opaque loading screen, and at 2 ms
33
+ * a 10-17 fps test lane spent 16 s (web) and about 47 s (native) admitting a spawn backlog of about
34
+ * 1,200 builds. The loader still presents every frame. Scaling keeps a game's own split between
35
+ * several worlds; `coveredAdmissionBudgetMs` and `coveredFreshMeshesPerUpdate` name the covered
36
+ * values outright.
37
+ */
38
+ export const COVERED_BUDGET_SCALE = 8;
39
+ /**
40
+ * How far the follow point has to move before a residency pass is worth repeating. Below it the
41
+ * ring, the refilter brackets and every tile's LOD level are the same numbers, so the pass would
42
+ * re-derive the set it already holds. Half a metre is under one 2 m heightmap cell and far under a
43
+ * 128 m cell, so nothing that could change an answer is skipped.
44
+ */
45
+ export const SETTLED_FOLLOW_METRES = 0.5;
46
+ /**
47
+ * How far the follow point has to move before the `maxDistance`/`lods` refilter pass runs again.
48
+ * That pass walks every resident cell's batches, derives both distance brackets and sorts what it
49
+ * found, and on a 2 km walk at 0.3 m a frame it ran every second frame for the same brackets — a
50
+ * third of the world's `update`. Two metres is the same order as the per-asset hysteresis the pass
51
+ * already applies (`threshold / 8`, 3.75 m for a 30 m gate), so a level switch or a cull lands
52
+ * within about two metres of the distance that asked for it, on a level the player is still walking
53
+ * toward. Raise it when a game's gates are far apart, lower it when placements sit inside one.
54
+ */
55
+ export const LEVEL_REFILTER_STEP_METRES = 2;
56
+ /**
57
+ * The projection a baked chain's levels are switched at when the world names none: 60° of vertical
58
+ * field of view over 1080 raster rows, which is the desktop view a switch distance is a function of.
59
+ * See `autoLod`.
60
+ */
61
+ const DEFAULT_AUTO_LOD_FOV_Y = 60;
62
+ const DEFAULT_AUTO_LOD_VIEWPORT_HEIGHT = 1080;
63
+ /**
64
+ * The screen-space error budget a baked chain's levels are switched at, in pixels, when the world
65
+ * names none. See `IWorldCellsLoadOptions.autoLod`.
66
+ */
67
+ export const DEFAULT_AUTO_LOD_MAX_PIXEL_ERROR = INSTANCED_LOD_MAX_PIXEL_ERROR;
68
+ /** An asset shorter than this casts into the finest level only; see the layer above. */
69
+ export const SMALL_CASTER_METRES = 1.5;
70
+ /**
71
+ * Placements filtered per unit of admission work.
72
+ *
73
+ * One unit is what a frame can overshoot its budget by, so it is sized to stay small rather than to
74
+ * divide the work evenly: a slice is a few hundred placements' worth of matrix maths, tens of
75
+ * microseconds, whatever the cell holds. ponytail: a count, not a time — the budget is the clock,
76
+ * and this only decides how often it is read.
77
+ */
78
+ export const ADMISSION_SLICE_PLACEMENTS = 256;
79
+
80
+ export interface IWorldCellsInit extends IWorldCellsLoadOptions {
81
+ readonly reachRanges: Map<
82
+ IWorldCell,
83
+ Map<string, { min: number; max: number; minY: number; maxY: number }>
84
+ >;
85
+ readonly manifest: IWorldPackage;
86
+ readonly placements: ArrayBuffer;
87
+ readonly heightmap: Uint16Array;
88
+ readonly baseUrl: string;
89
+ /** `baseUrl` as the loader keys it: no leading slash, which is what a manifest lists. */
90
+ readonly logicalBase: string;
91
+ /**
92
+ * Asset ids the package named twice for one model, each pointing at the id that is kept. Built
93
+ * once in `load`, where the loader can be asked what each path really fetches; empty when nothing
94
+ * is a duplicate. See {@link assetAliases}.
95
+ */
96
+ readonly aliases: ReadonlyMap<string, string>;
97
+ /**
98
+ * Whether `load` fabricated the loader it hands in as `assets` instead of the game supplying one.
99
+ * `load` always passes a loader to the constructor, so `assets === undefined` cannot tell an owned
100
+ * loader from a caller's; this is the bit that can. Left out, ownership is `assets === undefined`.
101
+ */
102
+ readonly ownsAssets?: boolean;
103
+ }
104
+
105
+ /**
106
+ * Pixels one world unit covers at unit depth, from the vertical field of view and the raster height.
107
+ * The scale `ModelLod` divides an error by; see `IWorldCellsLoadOptions.autoLod`.
108
+ */
109
+ export function autoLodScale(autoLod: IWorldCellsLoadOptions["autoLod"]): number {
110
+ const fovY = autoLod?.fovY ?? DEFAULT_AUTO_LOD_FOV_Y;
111
+ const viewportHeight = autoLod?.viewportHeight ?? DEFAULT_AUTO_LOD_VIEWPORT_HEIGHT;
112
+ if (!Number.isFinite(fovY) || fovY <= 0 || fovY >= 180)
113
+ throw new Error("WorldCells autoLod.fovY must be a finite angle in (0, 180) degrees.");
114
+ if (!Number.isFinite(viewportHeight) || !(viewportHeight > 0))
115
+ throw new Error(
116
+ "WorldCells autoLod.viewportHeight must be a positive number of raster pixels.",
117
+ );
118
+ return viewportHeight / (2 * Math.tan((fovY * Math.PI) / 360));
119
+ }
120
+
121
+ /** The screen-space error budget a synthesized level is switched at, in pixels. */
122
+ export function autoLodPixelError(autoLod: IWorldCellsLoadOptions["autoLod"]): number {
123
+ const maxPixelError = autoLod?.maxPixelError ?? DEFAULT_AUTO_LOD_MAX_PIXEL_ERROR;
124
+ if (!Number.isFinite(maxPixelError) || maxPixelError <= 0)
125
+ throw new Error("WorldCells autoLod.maxPixelError must be a positive number of pixels.");
126
+ return maxPixelError;
127
+ }
128
+
129
+ /** Default fraction of a 60 fps frame the main pass may take before the bias rises. */
130
+ export const DEFAULT_MAIN_GPU_SHARE = 0.5;
131
+
132
+ /**
133
+ * One launch override, read once: the environment, then the query string, then the global a test
134
+ * sets. The same three ways a debug flag is asked, but the answer is kept as text so a number can
135
+ * be parsed by the caller rather than rounded here.
136
+ */
137
+ function launchValue(parameter: string, flag: string, globalName: string): string | undefined {
138
+ return readLaunchValue({ environment: flag, global: globalName, query: parameter });
139
+ }
140
+
141
+ /**
142
+ * Whether a launch opts into the whole-asset impostors: off unless `?tnImpostors=1`, `TN_IMPOSTORS=1`
143
+ * or `__tnImpostors = 1` says so. Opt-in because the judged Machinefall capture of the default
144
+ * (PRD-473 AC-3, 2026-10-14) read REGRESSION — ground shadows and canopy density differ — and its
145
+ * pinned frame windows showed no frame-time gain, so a game gets the source levels it had until the
146
+ * proof passes. `impostors: true` still asks explicitly.
147
+ */
148
+ export function impostorsRequested(): boolean {
149
+ const raw = launchValue("tnImpostors", "TN_IMPOSTORS", "__tnImpostors");
150
+ return raw === "1" || raw === "true";
151
+ }
152
+
153
+ /** Whether the adaptive LOD bias runs: on unless a launch pins it off. */
154
+ export function adaptiveLodRequested(): boolean {
155
+ const raw = launchValue("tnAdaptiveLod", "TN_ADAPTIVE_LOD", "__tnAdaptiveLod");
156
+ return raw === undefined ? true : raw !== "0" && raw !== "false";
157
+ }
158
+
159
+ /** The main-pass GPU share: the option, then the launch override, then 0.5. */
160
+ export function mainGpuShare(option: number | undefined): number {
161
+ const raw = launchValue("tnMainGpuShare", "TN_MAIN_GPU_SHARE", "__tnMainGpuShare");
162
+ const launched = raw === undefined ? undefined : Number(raw);
163
+ const share = option ?? launched ?? DEFAULT_MAIN_GPU_SHARE;
164
+ if (!Number.isFinite(share) || share <= 0 || share > 1)
165
+ throw new Error("WorldCells mainGpuShare must be a number in (0, 1].");
166
+ return share;
167
+ }
168
+
169
+ /**
170
+ * Whether an asset whose cull ends inside the near ring keeps a far aggregate: `"ring"` unless the
171
+ * caller names the `"always"` override. A misspelled value throws rather than silently picking one.
172
+ */
173
+ export function impostorFarOption(value: "ring" | "always" | undefined): "ring" | "always" {
174
+ if (value === undefined) return "ring";
175
+ if (value === "ring" || value === "always") return value;
176
+ throw new Error('WorldCells impostorFar must be "ring" or "always".');
177
+ }