@wildshard/engine 0.1.18 → 0.1.20

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 (334) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/budgets/shard-size-baseline.json +10 -4
  3. package/index.html +6 -4
  4. package/lint/engine-sides.json +18 -0
  5. package/lint/ratchet.json +0 -68
  6. package/lint/ratchet.mjs +1 -4
  7. package/package.json +19 -15
  8. package/scripts/agent-sync.mjs +27 -8
  9. package/scripts/app-build/appCook.ts +8 -2
  10. package/scripts/app-build/catalogue.ts +10 -7
  11. package/scripts/app-build/gen.ts +33 -2
  12. package/scripts/app-build/isolation.d.mts +10 -0
  13. package/scripts/app-build/isolation.mjs +47 -0
  14. package/scripts/app-build/outputProducts.mjs +4 -0
  15. package/scripts/app-build/previousDeploy.d.mts +2 -0
  16. package/scripts/app-build/previousDeploy.mjs +10 -1
  17. package/scripts/app-build/serviceWorker.ts +10 -3
  18. package/scripts/app-build/splitOutput.mjs +4 -2
  19. package/scripts/app-build/standaloneOutput.d.mts +1 -1
  20. package/scripts/app-build/standaloneOutput.mjs +5 -3
  21. package/scripts/app-build/titlePreloads.d.mts +8 -0
  22. package/scripts/app-build/titlePreloads.mjs +69 -0
  23. package/scripts/app-build/worldMapAtlas.ts +10 -6
  24. package/scripts/app-build-pipeline.mjs +31 -3
  25. package/scripts/built-product.mjs +1 -1
  26. package/scripts/cell-mem-bench.mjs +83 -23
  27. package/scripts/check-custom-sections-zero.mjs +1 -1
  28. package/scripts/check-devserver.mjs +2 -0
  29. package/scripts/check-models.mjs +2 -0
  30. package/scripts/check-paths.allow.json +0 -115
  31. package/scripts/check-paths.mjs +2 -2
  32. package/scripts/check-platform-ratchets.mjs +2 -3
  33. package/scripts/chromium-keychain.d.mts +1 -1
  34. package/scripts/ci-static.sh +1 -1
  35. package/scripts/committed-fast-checks.mjs +0 -2
  36. package/scripts/content-sw-proof.mjs +2 -1
  37. package/scripts/cook-worker.mjs +9 -3
  38. package/scripts/cook.mjs +18 -5
  39. package/scripts/docs-inputs-proof.mjs +6 -6
  40. package/scripts/e7-voice-staging-proof.mjs +1 -1
  41. package/scripts/gate-related-tests.mjs +1 -1
  42. package/scripts/git-source-view.mjs +1 -1
  43. package/scripts/goldens/capture.mjs +17 -5
  44. package/scripts/grid-crossing-nightly.mjs +59 -0
  45. package/scripts/grid-crossing-qa.mjs +44 -0
  46. package/scripts/grid-crossing-ratchet.d.mts +6 -0
  47. package/scripts/grid-crossing-ratchet.mjs +52 -0
  48. package/scripts/grid-crossing-report.mjs +122 -0
  49. package/scripts/grid-crossing-stages.mjs +47 -0
  50. package/scripts/grid-crossing-tour.mjs +284 -0
  51. package/scripts/grid-crossing-walk-proof.mjs +126 -17
  52. package/scripts/host-ruler/roots.mjs +2 -2
  53. package/scripts/host-ruler.d.mts +91 -0
  54. package/scripts/host-ruler.mjs +565 -0
  55. package/scripts/land.mjs +2 -1
  56. package/scripts/live-prepush.py +3 -5
  57. package/scripts/loading-flow/benchmax.mjs +37 -12
  58. package/scripts/loading-flow/deskbench.mjs +276 -0
  59. package/scripts/loading-flow/stalls.d.mts +17 -3
  60. package/scripts/loading-flow/stalls.mjs +82 -3
  61. package/scripts/look-loop/test_look_loop.py +1 -38
  62. package/scripts/memory-proof.mjs +61 -6
  63. package/scripts/mmo-bots.mjs +8 -2
  64. package/scripts/net-lag-proof.mjs +219 -0
  65. package/scripts/night-market-kit-budget.mjs +2 -2
  66. package/scripts/nightly-model.ts +9 -6
  67. package/scripts/offline-proof-rules.d.mts +2 -2
  68. package/scripts/offline-proof-rules.mjs +15 -4
  69. package/scripts/offline-proof.mjs +80 -13
  70. package/scripts/{shard-platform-output.mjs → output-reader.mjs} +1 -1
  71. package/scripts/page-release/content.d.mts +9 -1
  72. package/scripts/page-release/content.mjs +131 -17
  73. package/scripts/page-release/flow.mjs +36 -10
  74. package/scripts/page-release/stamp-content.mjs +24 -0
  75. package/scripts/page-release.mjs +28 -6
  76. package/scripts/page-size.mjs +2 -1
  77. package/scripts/parity/boot-smoke.mjs +13 -2
  78. package/scripts/pin-format.ts +5 -2
  79. package/scripts/pin-packs.ts +1 -1
  80. package/scripts/pins-reuse.d.mts +1 -0
  81. package/scripts/pins-reuse.mjs +22 -0
  82. package/scripts/pins.ts +4 -4
  83. package/scripts/precommit-checks.mjs +1 -7
  84. package/scripts/precommit-jobs.mjs +0 -1
  85. package/scripts/precommit-source.py +1 -9
  86. package/scripts/program-discovery.mjs +1 -1
  87. package/scripts/ring-cook.mjs +2 -1
  88. package/scripts/ring-step.ts +1 -1
  89. package/scripts/scratch-dir.mjs +95 -0
  90. package/scripts/scratch-sweep.mjs +182 -0
  91. package/scripts/script-scenario-metrics.mjs +1 -1
  92. package/scripts/shard-output-content.d.mts +1 -1
  93. package/scripts/shard-output-content.mjs +2 -2
  94. package/scripts/shard-outputs.mjs +1 -1
  95. package/scripts/shard-public.mjs +1 -1
  96. package/scripts/shard-wire-meter.mjs +24 -9
  97. package/scripts/side-parity.mjs +4 -2
  98. package/scripts/standalone-smoke.mjs +8 -3
  99. package/scripts/tier-textures.mjs +22 -4
  100. package/scripts/tile-bake-report.mjs +1 -1
  101. package/scripts/tile-bakes.mjs +1 -1
  102. package/scripts/title-assets.generated.json +2 -0
  103. package/scripts/tsconfig.json +2 -14
  104. package/scripts/vendor/basisu/LICENSE +201 -0
  105. package/scripts/vendor/basisu/basis_encoder.cjs +2 -0
  106. package/scripts/vendor/basisu/basis_encoder.wasm +0 -0
  107. package/scripts/vitest-push-guards.config.ts +1 -1
  108. package/scripts/vps/harden-apply.sh +4 -1
  109. package/scripts/vps/harden-prometheus.sh +179 -0
  110. package/scripts/vps/harden.sh +16 -0
  111. package/scripts/vps/rebuild.sh +18 -0
  112. package/scripts/vps/wildshard-config +6 -2
  113. package/scripts/worker-client-play.mjs +6 -2
  114. package/scripts/worktree-reap.mjs +59 -13
  115. package/scripts/worktree.mjs +19 -5
  116. package/src/.oxlintrc.json +3 -182
  117. package/src/client/app/entry.ts +10 -2
  118. package/src/client/engine/anim/rigParser.ts +2 -2
  119. package/src/client/engine/boot/bootCache.ts +2 -2
  120. package/src/client/engine/boot/bootTrace.ts +12 -4
  121. package/src/client/engine/boot/browserChunkRecovery.ts +4 -0
  122. package/src/client/engine/boot/clearDownloads.ts +5 -2
  123. package/src/client/engine/boot/contentRead.ts +11 -0
  124. package/src/client/engine/boot/gpuFiles.ts +4 -2
  125. package/src/client/engine/boot/lastEnd.ts +99 -12
  126. package/src/client/engine/boot/texturePack.ts +2 -2
  127. package/src/client/engine/core/Game.ts +63 -19
  128. package/src/client/engine/core/gpuOnly.ts +10 -0
  129. package/src/client/engine/core/renderBudget.ts +134 -0
  130. package/src/client/engine/net/netPlayer.ts +19 -2
  131. package/src/client/engine/net/otherPlayers.ts +55 -8
  132. package/src/client/engine/net/predictor.ts +33 -9
  133. package/src/client/engine/net/redial.ts +68 -10
  134. package/src/client/engine/pwa/cacheNames.ts +58 -1
  135. package/src/client/engine/pwa/sw.js +41 -11
  136. package/src/client/engine/render/dataLook.ts +219 -44
  137. package/src/client/engine/render/families/detail.ts +89 -0
  138. package/src/client/engine/render/families/pbr.ts +9 -1
  139. package/src/client/engine/render/families/registry.ts +11 -2
  140. package/src/client/engine/render/families/sceneSurface.ts +116 -0
  141. package/src/client/engine/render/look.ts +12 -0
  142. package/src/client/engine/render/lookLight.ts +103 -11
  143. package/src/client/engine/render/lookRender.ts +105 -0
  144. package/src/client/engine/render/precompile.ts +4 -2
  145. package/src/client/engine/render/tiers.ts +4 -1
  146. package/src/client/engine/saves/indexed.ts +2 -2
  147. package/src/client/engine/telemetry/browserErrors.ts +24 -3
  148. package/src/client/engine/telemetry/staleBuildReport.ts +22 -1
  149. package/src/client/engine/ui/debugOptions.ts +1 -1
  150. package/src/client/engine/ui/lookLightOption.ts +10 -6
  151. package/src/client/engine/ui/namePrompt.ts +7 -0
  152. package/src/client/engine/world/declaredProps.ts +5 -1
  153. package/src/client/engine/world/skyRig.ts +4 -1
  154. package/src/client/engine/world/terrainTileView.ts +64 -23
  155. package/src/client/game/boot/audio.generated.ts +114 -114
  156. package/src/client/game/boot/bytes.generated.ts +118 -220
  157. package/src/client/game/boot/placedSpawn.ts +35 -0
  158. package/src/client/game/boot/spawnDownload.ts +25 -6
  159. package/src/client/game/boot/versions.generated.ts +7 -5
  160. package/src/client/game/devScene/hook.ts +428 -0
  161. package/src/client/game/devScene/liveLook.ts +21 -0
  162. package/src/client/game/grid/cellLoading.ts +12 -2
  163. package/src/client/game/grid/live.ts +152 -19
  164. package/src/client/game/grid/liveSession.ts +53 -3
  165. package/src/client/game/grid/mapAtlas.ts +18 -4
  166. package/src/client/game/grid/minimapBlend.ts +15 -5
  167. package/src/client/game/grid/oneWayIn.ts +5 -1
  168. package/src/client/game/grid/pageEntry.ts +12 -1
  169. package/src/client/game/grid/placedCells.ts +114 -12
  170. package/src/client/game/grid/placedContent.ts +85 -0
  171. package/src/client/game/grid/prefetch.ts +9 -1
  172. package/src/client/game/grid/productInputs.ts +23 -10
  173. package/src/client/game/grid/productLeases.ts +4 -1
  174. package/src/client/game/grid/products.ts +8 -4
  175. package/src/client/game/grid/roadLook.ts +24 -15
  176. package/src/client/game/grid/roadLookPlatform.ts +4 -2
  177. package/src/client/game/grid/roadResources.ts +24 -0
  178. package/src/client/game/grid/roadSign.worker.ts +4 -3
  179. package/src/client/game/grid/roadSignPaint.ts +16 -5
  180. package/src/client/game/grid/roadSignPreparation.ts +4 -3
  181. package/src/client/game/grid/roadSignScale.ts +8 -0
  182. package/src/client/game/grid/roadTileCapture.worker.ts +3 -1
  183. package/src/client/game/grid/roadTileCaptureWorker.ts +2 -1
  184. package/src/client/game/grid/roadTileWrite.worker.ts +4 -2
  185. package/src/client/game/grid/roadTileWriter.ts +2 -1
  186. package/src/client/game/grid/screenReports.ts +39 -0
  187. package/src/client/game/grid/session.ts +32 -7
  188. package/src/client/game/grid/softWallLook.ts +25 -8
  189. package/src/client/game/mainMenu.ts +6 -2
  190. package/src/client/game/plugin/context.ts +2 -1
  191. package/src/client/game/plugin/followedMovers.ts +7 -1
  192. package/src/client/game/quest/figures.ts +2 -0
  193. package/src/client/game/session/finish.ts +9 -0
  194. package/src/client/game/shardfile/assetCache.ts +4 -4
  195. package/src/client/game/shardfile/client.ts +28 -8
  196. package/src/client/game/shardfile/clientAssets.ts +9 -5
  197. package/src/client/game/shardfile/clientLibrary.ts +1 -1
  198. package/src/client/game/shardfile/clientPropMaterials.ts +4 -1
  199. package/src/client/game/shardfile/clientViews.ts +36 -8
  200. package/src/client/game/shardfile/clientWater.ts +51 -9
  201. package/src/client/game/shardfile/clientWorker.ts +19 -7
  202. package/src/client/game/shardfile/constructionCheckpoint.ts +2 -2
  203. package/src/client/game/shardfile/groundMerge.ts +57 -5
  204. package/src/client/game/shardfile/hybrid.ts +2 -0
  205. package/src/client/game/shardfile/look.ts +8 -3
  206. package/src/client/game/shardfile/product.ts +34 -7
  207. package/src/client/game/shardfile/productChecks.ts +2 -2
  208. package/src/client/game/shardfile/productCost.ts +2 -2
  209. package/src/client/game/shardfile/readAsset.ts +2 -2
  210. package/src/client/game/shardfile/reflectingWater.ts +73 -0
  211. package/src/client/game/shardfile/seatGrace.ts +9 -0
  212. package/src/client/game/shardfile/skinPlayback.ts +1 -1
  213. package/src/client/game/shardfile/slabLibrary.ts +115 -49
  214. package/src/client/game/shardfile/tileContent.ts +1 -1
  215. package/src/client/game/shardfile/tileDriver.ts +38 -11
  216. package/src/client/game/shardfile/wirePage.ts +7 -3
  217. package/src/client/game/shardfile/worldScenes.ts +17 -10
  218. package/src/client/game/systems/npc/figureRows.ts +9 -0
  219. package/src/client/host/online/doctor.ts +22 -7
  220. package/src/client/host/online/doctorView.ts +2 -0
  221. package/src/client/host/online/linkScreens.ts +109 -5
  222. package/src/client/host/online/shell.ts +13 -4
  223. package/src/client/host/standalone/shell.ts +40 -0
  224. package/src/cook/game/astc6Encode.ts +55 -0
  225. package/src/cook/game/astc6Wasm.ts +176 -0
  226. package/src/cook/game/cookJob.ts +30 -6
  227. package/src/cook/game/cookWorker.ts +38 -11
  228. package/src/cook/game/entryTotals.ts +51 -24
  229. package/src/cook/game/shardCook.ts +35 -7
  230. package/src/cook/game/spawnParts.ts +33 -8
  231. package/src/cook/game/tierTextures.ts +87 -14
  232. package/src/server/engine/ai/bossContenders.ts +27 -3
  233. package/src/server/engine/ai/phases.ts +1 -1
  234. package/src/server/engine/entities/creatureRefill.ts +9 -2
  235. package/src/server/engine/net/ledgerBook.ts +2 -0
  236. package/src/server/engine/net/room.ts +15 -0
  237. package/src/server/engine/sim/respawn.ts +8 -0
  238. package/src/server/game/boss/arenaRoomEntry.ts +5 -1
  239. package/src/server/game/boss/arenaRoomNative.ts +2 -0
  240. package/src/server/game/boss/native.ts +2 -1
  241. package/src/server/game/boss/nativeWake.ts +9 -5
  242. package/src/server/game/boss/openArenaNative.ts +2 -2
  243. package/src/server/game/boss/openArenaRoom.ts +3 -1
  244. package/src/server/game/grid/room.ts +44 -3
  245. package/src/server/game/grid/simulation.ts +23 -0
  246. package/src/server/game/population/mixedRoster.ts +11 -3
  247. package/src/server/game/population/nativeBake.ts +8 -3
  248. package/src/server/game/population/nativeReturns.ts +6 -3
  249. package/src/server/game/population/roster.ts +5 -3
  250. package/src/server/game/quest/eliteDrops.ts +18 -3
  251. package/src/server/game/quest/nativeChapter.ts +1 -1
  252. package/src/server/game/quest/nativeComposition.ts +5 -1
  253. package/src/server/game/riding/nativeTaming.ts +22 -7
  254. package/src/server/game/riding/wildRefill.ts +3 -2
  255. package/src/server/game/shardfile/bossRow.ts +4 -2
  256. package/src/server/game/shardfile/homeKeeper.ts +4 -2
  257. package/src/server/host/bake/headlessWorker.ts +1 -1
  258. package/src/server/host/dedicated/cellHost.ts +112 -18
  259. package/src/server/host/dedicated/cellProtocol.ts +18 -1
  260. package/src/server/host/dedicated/cellWorker.ts +8 -5
  261. package/src/server/host/dedicated/dedicatedRoom.ts +38 -11
  262. package/src/server/host/dedicated/gridCells.ts +15 -6
  263. package/src/server/host/dedicated/loopLag.ts +21 -0
  264. package/src/server/host/dedicated/main.ts +13 -5
  265. package/src/server/host/dedicated/packReader.ts +3 -3
  266. package/src/server/host/dedicated/placementFile.ts +3 -2
  267. package/src/server/host/dedicated/roadRoom.ts +34 -4
  268. package/src/server/host/dedicated/serverMetrics.ts +135 -0
  269. package/src/server/host/dedicated/socketPump.ts +21 -4
  270. package/src/server/host/dedicated/workerTable.ts +32 -14
  271. package/src/server/host/dedicated/world.ts +65 -7
  272. package/src/server/host/headless.ts +1 -1
  273. package/src/server/host/headlessRuntime.ts +1 -1
  274. package/src/server/host/standalone/roadWorld.ts +15 -3
  275. package/src/server/host/standalone/serverHost.ts +57 -8
  276. package/src/server/host/standalone/serverProduct.ts +48 -16
  277. package/src/server/host/standalone/serverRuntime.ts +1 -1
  278. package/src/shared/engine/ai/BossBrain.ts +8 -0
  279. package/src/shared/engine/core/framePacing.ts +12 -1
  280. package/src/shared/engine/physics/terrainTiles.ts +20 -4
  281. package/src/shared/game/boss/wake.ts +6 -0
  282. package/src/shared/game/devColliders.ts +107 -0
  283. package/src/shared/game/devGameplay.ts +41 -0
  284. package/src/shared/game/eliteSystem.ts +8 -0
  285. package/src/shared/game/grid/allocator.ts +3 -0
  286. package/src/shared/game/grid/placementRows.ts +5 -2
  287. package/src/shared/game/plugin/bossRecord.ts +3 -2
  288. package/src/shared/game/shardfile/ktx2Targets.ts +23 -3
  289. package/src/shared/game/shardfile/outputDescriptor.ts +9 -5
  290. package/src/shared/game/shardfile/packReads.ts +28 -3
  291. package/src/shared/game/shardfile/serverPack.ts +9 -0
  292. package/src/shared/game/systems/looks/trampleField.ts +2 -0
  293. package/src/shared/host/formatJsonSchema.ts +2 -2
  294. package/src/tsconfig.json +1 -27
  295. package/lint/host-reviews.json +0 -14
  296. package/lint/listed-view-code.json +0 -13
  297. package/lint/platform-pending-users.json +0 -2520
  298. package/lint/platform-pending-users.md +0 -18
  299. package/scripts/cell-mem/metrics-preload.mjs +0 -65
  300. package/scripts/check-closed-components.d.mts +0 -7
  301. package/scripts/check-closed-components.mjs +0 -87
  302. package/scripts/g571-hosts.d.mts +0 -3
  303. package/scripts/g571-hosts.mjs +0 -54
  304. package/scripts/host-ruler/register-migrate.mjs +0 -242
  305. package/scripts/listed-view-code.d.mts +0 -7
  306. package/scripts/listed-view-code.mjs +0 -93
  307. package/scripts/look-loop/fit-lut.py +0 -142
  308. package/scripts/look-loop/palette-delta.py +0 -183
  309. package/scripts/look-loop/regions/driftwood-isle.json +0 -25
  310. package/scripts/look-loop/regions/far-reach.json +0 -225
  311. package/scripts/look-loop/regions/open-plot-night-market.json +0 -855
  312. package/scripts/look-loop/regions/pine-hollow.json +0 -22
  313. package/scripts/look-loop/regions/sunscar-dunes.json +0 -281
  314. package/scripts/platform-chargebacks.d.mts +0 -9
  315. package/scripts/platform-chargebacks.mjs +0 -135
  316. package/scripts/shard-component-spans.d.mts +0 -15
  317. package/scripts/shard-component-spans.mjs +0 -18
  318. package/scripts/shard-components.d.mts +0 -16
  319. package/scripts/shard-components.mjs +0 -363
  320. package/scripts/shard-platform-hosts.d.mts +0 -2
  321. package/scripts/shard-platform-hosts.mjs +0 -93
  322. package/scripts/shard-platform-sections.d.mts +0 -2
  323. package/scripts/shard-platform-sections.mjs +0 -9
  324. package/scripts/shard-platform.d.mts +0 -76
  325. package/scripts/shard-platform.mjs +0 -1072
  326. package/src/.oxfmtrc.json +0 -48
  327. package/src/scripts/ask-new.sh +0 -29
  328. package/src/scripts/asks.mjs +0 -142
  329. package/src/scripts/herdr-prompt.sh +0 -34
  330. package/src/scripts/herdr-question-open.sh +0 -67
  331. package/src/scripts/md-wrap.mjs +0 -229
  332. /package/scripts/{shard-platform-format.d.mts → node-format.d.mts} +0 -0
  333. /package/scripts/{shard-platform-format.mjs → node-format.mjs} +0 -0
  334. /package/scripts/{shard-platform-output.d.mts → output-reader.d.mts} +0 -0
@@ -1,9 +1,9 @@
1
1
  import { outputBlobPath } from '@wildshard/format/outputAddress';
2
- import { packReads } from './packReads';
2
+ import { packOrLoose, packReads } from './packReads';
3
3
  import type { OutputIndex } from '@wildshard/format/outputIndex';
4
4
  import { assembleOutputTransport } from '@wildshard/format/outputFields';
5
5
  import { isJsonDataWithFileSchemas } from '@wildshard/format/json';
6
- import { builtValidationReceipt, builtProductResidency, validationSourceBytes, validationSourceBytesPaced, type ValidationReceipt } from '@wildshard/format/validationReceipt';
6
+ import { builtValidationReceipt, builtShardfileResidency, validationSourceBytes, validationSourceBytesPaced, type ValidationReceipt } from '@wildshard/format/validationReceipt';
7
7
  import { diagnosticNow } from '@wildshard/engine/core/clock';
8
8
  import { parseOutputLineageIndex } from '@wildshard/format/stateLineage';
9
9
  import type { Shardfile } from '@wildshard/format/shardSchema';
@@ -167,7 +167,7 @@ async function readBuiltOutput(index:OutputIndex,reader:OutputDescriptorReader,b
167
167
  for(const value of values){if(value.status==='rejected')throw value.reason;sections.set(...value.value);}
168
168
  const source=assembleOutputTransport(index,sections);
169
169
  if(!isBuiltClientSource(source,reader))throw new Error('Built output needs its first-party reader');
170
- const residentBytes=builtProductResidency(index.build.sourceHash);
170
+ const residentBytes=builtShardfileResidency(index.build.sourceHash);
171
171
  buildValidated.add(source);descriptors.set(source.files,{index,sections,cached:false,indexHash:built.indexHash,built:true,...(residentBytes===undefined?{}:{residentBytes})});
172
172
  return source;
173
173
  }
@@ -236,8 +236,12 @@ export async function resolveOutputDescriptor(input: unknown, reader: OutputDesc
236
236
  reader.cacheHit?.(section.path, section.hash, bytes.length);
237
237
  } else if (bytes === null || bytes === undefined) {
238
238
  if (reader.offline) throw new IncompleteOutputCacheError();
239
- if (inPack && packed !== undefined) { bytes = await packed.read(section.hash); reader.packedHit?.(section.path, section.hash); }
240
- else bytes = await reader.read(section.path, section.bytes);
239
+ // PZ7: a pack that is not published (or fails) falls back to the section's own read
240
+ if (inPack && packed !== undefined) {
241
+ let fromPack = true;
242
+ bytes = await packOrLoose(() => packed.read(section.hash), () => { fromPack = false; return reader.read(section.path, section.bytes); });
243
+ if (fromPack) reader.packedHit?.(section.path, section.hash);
244
+ } else bytes = await reader.read(section.path, section.bytes);
241
245
  if (bytes.length !== section.bytes || await reader.hash(bytes) !== section.hash) throw new Error('Shardfile section hash or size mismatch');
242
246
  if (reader.backgroundStore !== undefined) {
243
247
  // A scheduled write is not durable cache proof. Complete offline
@@ -7,6 +7,28 @@ const sharedPacks = new WeakMap<object, Map<string, SharedPack>>();
7
7
  /** MF7: the packs a finished boot let go (`hash:bytes`), and every owner table that may hold each one */
8
8
  const releasedPacks = new Set<string>();
9
9
  const holders = new Map<string, WeakRef<Map<string, Promise<Uint8Array>>>[]>();
10
+ /** PAGE-SIZE PZ7: packs whose read failed (dropped from the CDN, or not reachable): every later member of one reads its
11
+ * loose blob at once, so a dropped pack costs one failed request per page, not one per member. */
12
+ const missingPacks = new Set<string>();
13
+ interface PackName { readonly hash: string; readonly bytes: number }
14
+ const packKey = (pack: PackName): string => `${pack.hash}:${pack.bytes}`;
15
+ const aborted = (error: unknown): boolean => error instanceof Error && error.name === 'AbortError';
16
+ /** a pack that came back wrong (other bytes, a partial or oversized response) is refused, never read around: the
17
+ * corruption guards stand, and a repaired read may retry it. Only a pack that is gone (404, network) reads loose (PZ7). */
18
+ const refused = (error: unknown): boolean => error instanceof Error && /mismatch|whole response|exceeds/u.test(error.message);
19
+ /** whether a failed pack read means the pack is gone (PZ7): not an abort, not a refusal of its bytes */
20
+ export function packGone(error: unknown): boolean { return !aborted(error) && !refused(error); }
21
+ /** whether a read of `pack` failed earlier in this page (PZ7): read its members loose */
22
+ export function packMissing(pack: PackName): boolean { return missingPacks.has(packKey(pack)); }
23
+ /** remember a pack that is gone (PZ7): its read failed for a reason other than an abort or a refusal of its bytes */
24
+ export function markPackMissing(pack: PackName, error: unknown): void { if (packGone(error)) missingPacks.add(packKey(pack)); }
25
+ /** PZ7: a member from its pack, or from its loose blob when the pack is gone; an abort or a refused pack still throws */
26
+ export async function packOrLoose(read: () => Promise<Uint8Array>, loose: () => Promise<Uint8Array>): Promise<Uint8Array> {
27
+ let bytes: Uint8Array;
28
+ try { bytes = await read(); }
29
+ catch (error: unknown) { if (!packGone(error)) throw error; return loose(); }
30
+ return bytes;
31
+ }
10
32
 
11
33
  /** One verified whole GET per immutable index inventory, shared across admission
12
34
  * and later demand waves. Failed attempts leave no retained rejection. The weak
@@ -16,7 +38,8 @@ export function readPackWhole(owner: object, pack: Pack,
16
38
  if (pack.bytes < 1 || pack.bytes > 4_194_304) return Promise.reject(new Error('Shardfile pack size exceeds 4 MiB'));
17
39
  let whole = wholePacks.get(owner);
18
40
  if (whole === undefined) { whole = new Map(); wholePacks.set(owner, whole); }
19
- const key = `${pack.hash}:${pack.bytes}`, previous = whole.get(key);
41
+ const key = packKey(pack), previous = whole.get(key);
42
+ if (missingPacks.has(key)) return Promise.reject(new Error('Shardfile pack is missing'));
20
43
  if (previous !== undefined) return previous;
21
44
  let shared = sharedPacks.get(identity);
22
45
  if (shared === undefined) { shared = new Map(); sharedPacks.set(identity, shared); }
@@ -32,7 +55,9 @@ export function readPackWhole(owner: object, pack: Pack,
32
55
  if (known?.pending !== undefined) { held.set(key, known.pending); forget(known.pending); return known.pending; }
33
56
  if (present !== undefined) { const borrowed = Promise.resolve(present); if (keep) { held.set(key, borrowed); forget(borrowed); } return borrowed; }
34
57
  const bytes = (async () => {
35
- const wire = await read(pack.path, pack.bytes, pack.entries);
58
+ let wire: Uint8Array;
59
+ try { wire = await read(pack.path, pack.bytes, pack.entries); }
60
+ catch (error: unknown) { markPackMissing(pack, error); throw error; }
36
61
  if (wire.length !== pack.bytes || await hash(wire) !== pack.hash) throw new Error('Shardfile pack hash or size mismatch');
37
62
  return wire;
38
63
  })();
@@ -82,7 +107,7 @@ export function packReads(packs: OutputIndex['packs'], members: ReadonlySet<stri
82
107
  }
83
108
  }
84
109
  return {
85
- has: member => where.has(member),
110
+ has: member => { const at = where.get(member); return at !== undefined && !missingPacks.has(packKey(at.pack)); },
86
111
  read: async member => {
87
112
  const at = where.get(member);
88
113
  if (at === undefined) throw new Error('Not a packed member');
@@ -14,6 +14,15 @@ const ServerPackSchema: v.GenericSchema<ServerPack> = v.strictObject({...partEnt
14
14
  const ServerPackBookSchema: v.GenericSchema<ServerPackBook> = v.strictObject({book: v.literal('server'), build: v.string(), shards: v.record(v.string(), ServerPackSchema), grid: v.exactOptional(ServerPackSchema)});
15
15
  export const serverPackBookPath = (build: string): string => `assets/spawn/server-${build}.json`;
16
16
  export const readServerPackBook = (input: unknown): ServerPackBook => v.parse(ServerPackBookSchema, input);
17
+ /** One shard's pack, as the cook writes it beside its parts (`assets/spawn/server-<slug>-<hash16>.json`). */
18
+ export const readServerPack = (input: unknown): ServerPack => v.parse(ServerPackSchema, input);
19
+ /** J83, MS2.4: the cook's index of one shard's bytes (its shardfile hash) for one build, written last, so a shard is cooked when it exists. */
20
+ export const cookIndexPath = (build: string, hash: string): string => `index/${build}/${hash}.json`;
21
+ /** SA47: what a server reads of a cook index: whose it is, and where its server pack is (an index from before C2 names none). */
22
+ export interface CookedServerIndex {readonly build: string; readonly slug: string; readonly hash: string; readonly serverPack?: {readonly index: string}}
23
+ const CookedServerIndexSchema: v.GenericSchema<CookedServerIndex> = v.object({build: v.string(), slug: v.string(), hash: v.string(),
24
+ serverPack: v.exactOptional(v.object({index: v.pipe(v.string(), v.regex(/^\/assets\/spawn\/server-[a-z0-9_-]+-[a-f0-9]{16}\.json$/u))}))});
25
+ export const readCookedServerIndex = (input: unknown): CookedServerIndex => v.parse(CookedServerIndexSchema, input);
17
26
  /** The part of a pack that holds a file. */
18
27
  export const serverPackPart = (pack: ServerPack, path: string): ServerPackPart | undefined => [pack, ...pack.more ?? []].find(part => part.files.some(file => file[0] === path));
19
28
  /** One file's bytes inside its part's decoded body. */
@@ -76,6 +76,8 @@ export function installTrampleTrail(host: SimHost, map: TrampleField, rows: { id
76
76
  own.push(dt, at, rows.radius, rows.strength);
77
77
  }
78
78
  if (window !== null) map.update(dt, window);
79
+ // SC10 (J328): a long-lived world forgets the trails of those who left
80
+ if (others.size >= host.players.size) for (const id of others.keys()) if (!host.players.has(id)) others.delete(id);
79
81
  }, { snapshot: () => others.size === 0 ? trail.snapshot() : { ...trail.snapshot(), others: Object.fromEntries([...others].map(([id, own]) => [id, own.last()])) },
80
82
  restore: saved => {
81
83
  trail.restore(saved); others.clear();
@@ -116,7 +116,7 @@ import { AudioRoutingSchema } from '@wildshard/format/audioRouting';
116
116
  import { AudioDataSchema } from '@wildshard/format/audio';
117
117
  import { LedgerFactSchema, LedgerRulesSchema } from '@wildshard/format/ledger';
118
118
  import { DirectorSchema } from '@wildshard/format/director';
119
- import { DirectorProductSchema } from '@wildshard/format/directorProduct';
119
+ import { DirectorDocumentSchema } from '@wildshard/format/directorDocument';
120
120
  import { DirectorStagesSchema } from '@wildshard/format/directorStages';
121
121
  import { LogicalStateSchema, MigrationsSchema } from '@wildshard/format/migrations';
122
122
  import { TraversalSchema } from '@wildshard/format/traversal';
@@ -355,7 +355,7 @@ const wireRoots: Readonly<Record<string, GenericSchema>> = {
355
355
  'ledger.LedgerFact': LedgerFactSchema,
356
356
  'ledger.LedgerRules': LedgerRulesSchema,
357
357
  'director.Director': DirectorSchema,
358
- 'directorProduct.DirectorProduct': DirectorProductSchema,
358
+ 'directorProduct.DirectorProduct': DirectorDocumentSchema,
359
359
  'directorStages.DirectorStages': DirectorStagesSchema,
360
360
  'migrations.LogicalState': LogicalStateSchema,
361
361
  'migrations.Migrations': MigrationsSchema,
package/src/tsconfig.json CHANGED
@@ -1,31 +1,5 @@
1
1
  {
2
- "compilerOptions": {
3
- "target": "es2024",
4
- "strict": true,
5
- "noUncheckedIndexedAccess": true,
6
- "exactOptionalPropertyTypes": true,
7
- "noImplicitOverride": true,
8
- "noImplicitReturns": true,
9
- "noFallthroughCasesInSwitch": true,
10
- "noPropertyAccessFromIndexSignature": true,
11
- "noUnusedLocals": true,
12
- "noUnusedParameters": true,
13
- "allowUnreachableCode": false,
14
- "allowUnusedLabels": false,
15
- "useUnknownInCatchVariables": true,
16
- "verbatimModuleSyntax": true,
17
- "erasableSyntaxOnly": true,
18
- "isolatedModules": true,
19
- "allowImportingTsExtensions": true,
20
- "resolveJsonModule": true,
21
- "forceConsistentCasingInFileNames": true,
22
- "skipLibCheck": true,
23
- "module": "nodenext",
24
- "moduleResolution": "nodenext",
25
- "lib": ["es2024"],
26
- "types": ["node"],
27
- "noEmit": true
28
- },
2
+ "extends": "../kit/tsconfig.json",
29
3
  "include": [
30
4
  "cli",
31
5
  "test/helpers",
@@ -1,14 +0,0 @@
1
- {
2
- "schema": "wildshard.host-reviews/1",
3
- "entries": {
4
- "src/client/engine/world/painterly.ts#*": {
5
- "sourceHash": "1a3811e00a1c5d7930c77a856307fa91707265a4711b62a32dab4331591c57be",
6
- "evidence": "G456 H1 frozen-body exception: content owner Nalati. Retained edges: nalati-grasslands-legacy/look/terrainPainter.ts, look/creatureMaterial.ts, world/glbPaint.ts -> painterlyMaterial/painterlyKnobs; game/client/grid/regionLight.ts -> shared uniform state. Not a second-user claim; content bodies remain charged to their owning shard.",
7
- "verdicts": {
8
- "twoRealUsers": "fail",
9
- "noShardNouns": "fail",
10
- "deletionTest": "fail"
11
- }
12
- }
13
- }
14
- }
@@ -1,13 +0,0 @@
1
- {
2
- "schema": 1,
3
- "shards": {
4
- "far-reach": [],
5
- "sunscar-dunes": [],
6
- "pine-hollow": [
7
- { "path": "src/client/game/quest/chapterDirector.ts", "name": "installChapterLead", "reason": "The remaining lead presentation reads the existing AS channels and presents its view.", "decision": "G570" }
8
- ],
9
- "driftwood-isle": [],
10
- "nalati-grasslands": [],
11
- "nine-dragon-stack": []
12
- }
13
- }