@wildshard/sdk 0.3.2 → 0.3.3

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 (79) hide show
  1. package/GUIDE.md +19 -6
  2. package/bin/wildshard.mjs +4 -0
  3. package/docs/api/EXPORT-TIERS.md +3 -2
  4. package/lint/export-tiers.json +1 -0
  5. package/lint/sdk-plugin.d.mts +2 -0
  6. package/lint/sdk-plugin.mjs +39 -1
  7. package/package.json +10 -9
  8. package/scripts/capture-hero.mjs +48 -18
  9. package/scripts/ci21-sdk-tail-lint.mjs +95 -0
  10. package/scripts/keep-copy.mjs +172 -0
  11. package/scripts/land.mjs +34 -4
  12. package/scripts/lane-live.mjs +136 -0
  13. package/scripts/leftovers-report.mjs +47 -0
  14. package/scripts/lint-dispatch.mjs +5 -0
  15. package/scripts/music/export-midi.mjs +3 -2
  16. package/scripts/prepare-product.mjs +3 -2
  17. package/scripts/scratch-dir.d.mts +3 -0
  18. package/scripts/scratch-dir.mjs +33 -14
  19. package/scripts/scratch-sweep.mjs +15 -23
  20. package/scripts/typecheck.mjs +15 -0
  21. package/scripts/worktree-reap.mjs +46 -104
  22. package/scripts/worktree.mjs +35 -13
  23. package/skills/wildshard/SKILL.md +3 -1
  24. package/src/cli/content-command.ts +44 -0
  25. package/src/cli/content.ts +287 -0
  26. package/src/cli/help.ts +7 -2
  27. package/src/cli/hero/hero.ts +6 -1
  28. package/src/cli/hero/scene-card.ts +46 -0
  29. package/src/cli/hero/stamp.ts +5 -3
  30. package/src/sharddev/authorManifest.ts +20 -2
  31. package/src/sharddev/cli.ts +1 -1
  32. package/src/sharddev/dev.ts +23 -4
  33. package/src/sharddev/newProject.ts +27 -8
  34. package/src/sharddev/project.ts +2 -2
  35. package/src/sharddev/refusals.ts +1 -0
  36. package/src/sharddev/scene/author.ts +22 -1
  37. package/src/sharddev/scene/budget.ts +87 -0
  38. package/src/sharddev/scene/creature.ts +171 -0
  39. package/src/sharddev/scene/description.ts +41 -0
  40. package/src/sharddev/scene/lower.ts +127 -3
  41. package/src/sharddev/scene/shardfile.ts +196 -14
  42. package/src/sharddev/shardSource.ts +2 -2
  43. package/src/sharddev/test/diskScriptScenario.ts +4 -2
  44. package/src/sharddev/test/ownedScratch.ts +14 -0
  45. package/src/sharddev/test/scriptScenario.ts +18 -13
  46. package/src/sharddev/tsconfig.json +3 -0
  47. package/src/sharddev/watch/pageEntry.ts +1 -19
  48. package/src/sharddev/watch/parity-baseline.json +6 -6
  49. package/src/sharddev/watch/parity.mjs +24 -0
  50. package/src/sharddev/watch/watch.ts +10 -2
  51. package/src/shards/_template/behaviour/boss.as +13 -4
  52. package/src/shards/_template/behaviour/door.as +8 -3
  53. package/src/shards/_template/behaviour/hooks.json +35 -0
  54. package/src/shards/_template/card/landscape.jpg +0 -0
  55. package/src/shards/_template/card/portrait.jpg +0 -0
  56. package/src/shards/_template/card/thumb.jpg +0 -0
  57. package/src/shards/_template/data/bossDecision.json +11 -1
  58. package/src/shards/_template/data/card.json +49 -1
  59. package/src/shards/_template/data/clientScripts.json +411 -0
  60. package/src/shards/_template/data/creatures.json +280 -2
  61. package/src/shards/_template/data/items.json +1 -1
  62. package/src/shards/_template/data/layout.json +32 -1
  63. package/src/shards/_template/data/ledger.json +45 -0
  64. package/src/shards/_template/data/npcs/hermit.json +72 -0
  65. package/src/shards/_template/data/quests.json +297 -11
  66. package/src/shards/_template/data/rows.json +154 -0
  67. package/src/shards/_template/data/skins.json +14 -0
  68. package/src/shards/_template/data/targets.json +47 -0
  69. package/src/shards/_template/data/text.json +4 -1
  70. package/src/shards/_template/generators/lift.ts +71 -0
  71. package/src/shards/_template/generators/product.ts +19 -5
  72. package/src/shards/_template/generators/templatePropsSource.ts +5 -4
  73. package/src/shards/_template/generators/terrain.ts +10 -2
  74. package/src/shards/_template/generators/world.ts +42 -7
  75. package/src/shards/_template/hero.json +6 -6
  76. package/src/shards/_template/manifest.json +49 -1
  77. package/src/shards/authoring-slice/generators/shard.ts +2 -1
  78. package/src/shards/authoring-slice/generators/world.ts +8 -1
  79. package/tsconfig.author.json +24 -0
@@ -1,4 +1,4 @@
1
- import { Box3, BufferAttribute, BufferGeometry, Color, Float32BufferAttribute, Matrix3, Matrix4, MeshStandardMaterial, Quaternion, Vector3 } from 'three';
1
+ import { Box3, BufferAttribute, BufferGeometry, Color, DoubleSide, Float32BufferAttribute, FrontSide, Matrix3, Matrix4, MeshStandardMaterial, Quaternion, Vector3 } from 'three';
2
2
  import type { PoolSurface } from '@wildshard/format/pool-surface';
3
3
  import { parseShardfile, type Shardfile } from '@wildshard/format/shardSchema';
4
4
  import { emptyShardfile } from '../author';
@@ -11,7 +11,10 @@ import { encodeTerrainTile } from '@wildshard/format/terrainTileBytes';
11
11
  import { bakeRawColourPixels } from '../bake/rawTexture';
12
12
  import type { Rgb, SceneCollider, SceneDraw, SceneGeometry, SceneLight, SceneMaterial, SceneMotion, ScenePart, ShardScene } from './description';
13
13
  import { SceneRefusalError } from './lower';
14
+ import { budgetReport, partBudgets } from './budget';
15
+ import { coarseGeometry } from '../bake/coarseCopy';
14
16
  import { hashOf } from './hash';
17
+ import { detailFileFaults, detailMeshBytes } from '@wildshard/format/look-details';
15
18
 
16
19
  /**
17
20
  * AUTHORING-PARITY AP2, AP3, AP4: the shardfile back end. It reads only the scene description and writes the sections an
@@ -35,7 +38,7 @@ import { hashOf } from './hash';
35
38
  * `motion`, a mesh's `sway` to its entry's `sway` plus a `_SWAY` channel (metres, growing with the square of the height
36
39
  * over the mesh's own bounds), a mesh's `uvScroll` to its entry's `uvScroll`.
37
40
  *
38
- * Phone tile caps are reported, not enforced (J338: this shard may use up to 50 MB): AP9 turns them into a per-part table.
41
+ * Phone tile caps are reported, not enforced (J338: this shard may use up to 50 MB), as AP9a's per-part table (`budget.ts`).
39
42
  */
40
43
 
41
44
  export interface ShardfileOptions {
@@ -120,6 +123,28 @@ function mergeDraws(key: string, draws: readonly SceneDraw[], scene: ShardScene,
120
123
  interface InstancedGroup { key: string; geometry: BufferGeometry; matrices: Matrix4[]; colours: Color[] | null; castShadow: boolean; box: Box3 }
121
124
  /** The fewest copies a draw needs to stay instanced (below it the merge is as small). */
122
125
  const INSTANCE_MIN = 2, INSTANCE_CAP = 10_000;
126
+ /**
127
+ * AP9c: the coarse (L1) copies the back end writes itself, so no author keeps a hand coarse list. An L1 tile (two by two
128
+ * fine tiles) draws past the fine ring, from about 150 m: its still meshes are simplified toward a quarter of their
129
+ * triangles (half a metre of error for the bounded pass; past 1.5 times the target meshopt's topology-free pass takes over,
130
+ * with no metre bound), and an instanced shape smaller than COARSE_MIN_SIZE across in its own frame (grass, flowers) stays
131
+ * near-only.
132
+ */
133
+ const COARSE_RATIO = 0.25, COARSE_ERROR = 0.5, COARSE_MIN_SIZE = 2;
134
+ /** A simplified geometry with only the vertices its index still names (the simplifier keeps every vertex). */
135
+ function compacted(source: BufferGeometry): BufferGeometry {
136
+ const index = source.getIndex(); if (index === null) return source;
137
+ const remap = new Map<number, number>(), order: number[] = [], next: number[] = [];
138
+ for (const at of index.array) { let to = remap.get(at); if (to === undefined) { to = order.length; remap.set(at, to); order.push(at); } next.push(to); }
139
+ const out = new BufferGeometry();
140
+ for (const [name, attribute] of Object.entries(source.attributes)) {
141
+ const size = attribute.itemSize, values = new Float32Array(order.length * size);
142
+ order.forEach((from, i) => { for (let c = 0; c < size; c++) values[i * size + c] = attribute.getComponent(from, c); });
143
+ out.setAttribute(name, new BufferAttribute(values, size));
144
+ }
145
+ out.setIndex(next);
146
+ return out;
147
+ }
123
148
 
124
149
  /** A copy the engine's loader can place: translation, rotation and a positive scale, no shear (the loader reads instance
125
150
  * TRS rows; an exact `_MATRIX` row loads as the identity there). */
@@ -224,6 +249,16 @@ function appendCard(key: string, seat: readonly [number, number, number], size:
224
249
  merge.index.push(base, base + 1, base + 2, base, base + 2, base + 3);
225
250
  }
226
251
 
252
+ /**
253
+ * A tile GLB's material for one entry: white, vertex-coloured, and double-sided when the scene's material is (AP16w). The
254
+ * engine draws a prop mesh with the side its GLB material says, so a crossed grass card left one-sided lost its back faces in
255
+ * build while watch drew them.
256
+ */
257
+ function glbMaterial(name: string, material: SceneMaterial): MeshStandardMaterial {
258
+ const glb = new MeshStandardMaterial({ color: 0xffffff, vertexColors: true, side: material.side === 'double' ? DoubleSide : FrontSide }); glb.name = name;
259
+ return glb;
260
+ }
261
+
227
262
  /** A merge cut into primitives of at most 200,000 vertices, each with its own compact vertex list. */
228
263
  /** One entry's merge as GLB primitives: a card's corners and a swaying surface's amplitude ride their own channels (AP11, AP12). */
229
264
  function primitivesOf(merge: Merge, entry: Entry, name: string, castShadow: boolean): GlbPrimitive[] {
@@ -233,7 +268,7 @@ function primitivesOf(merge: Merge, entry: Entry, name: string, castShadow: bool
233
268
  .setAttribute('uv', new Float32BufferAttribute(chunk.uv, 2)).setAttribute('color', new BufferAttribute(new Float32Array(chunk.colour), 3)).setIndex(chunk.index);
234
269
  if (entry.card) geometry.setAttribute('corner', new Float32BufferAttribute(chunk.corner, 2));
235
270
  if (swaying) geometry.setAttribute('sway', new Float32BufferAttribute(chunk.sway, 1));
236
- const material = new MeshStandardMaterial({ color: 0xffffff, vertexColors: true }); material.name = name;
271
+ const material = glbMaterial(name, entry.material);
237
272
  const primitive: GlbPrimitive = { geometry, material, castShadow: entry.card ? false : castShadow };
238
273
  if (entry.card) primitive.customAttributes = { _CORNER: 'corner' }; else if (swaying) primitive.customAttributes = { _SWAY: 'sway' };
239
274
  return primitive;
@@ -253,7 +288,17 @@ function appendMerge(into: Merge, from: Merge): void {
253
288
  for (const at of from.index) into.index.push(at + base);
254
289
  }
255
290
 
256
- /** AP16: what the library roots cost with their dependencies (format asset admission's `budgets.library` check). */
291
+ /**
292
+ * AP26: the two server figures a scene shard declares rather than sums. `SIM_CEILING` is the bytes the server reserves for
293
+ * the shard's simulation in each cell it runs (engine `server/game/plugin/simulation.ts`), which shard-format reads as the
294
+ * authoring ceiling `budgets.sim.resident` (`runtimeCost.ts`, scripts at their growth limit): a ceiling, so no sum of
295
+ * critical bytes. It is also the server's `memory`. `SERVER_TICK_MICROS` is the server tick's time a scene shard may spend.
296
+ * Later steps add their own critical bytes on top (behaviour scripts, platform sections, the authored world).
297
+ */
298
+ export const SIM_CEILING = 16_000_000, SERVER_TICK_MICROS = 5_000;
299
+
300
+ /** AP16: what the library (AP26: or critical) roots cost with their dependencies (format asset admission's `budgets.library`
301
+ * and `budgets.sim` checks). */
257
302
  function libraryCost(files: Shardfile['files'], roots: readonly string[]): { resident: number; compressed: number } {
258
303
  const byHash = new Map(files.map((f) => [f.hash, f])), seen = new Set<string>(), pending = [...roots];
259
304
  let resident = 0, compressed = 0;
@@ -423,9 +468,8 @@ export function compileShardfile(scene: ShardScene, ctx: ProjectGenerationContex
423
468
  const { shard, assets, report } = sceneShardfile(scene, options);
424
469
  for (const [hash, bytes] of assets) if (ctx.asset(bytes) !== hash) throw new Error('scene: an asset hash differs from the product store');
425
470
  if (report.lampsDropped > 0) console.info(`scene: ${report.lampsDropped} point lights past the 16 brightest are not in the shardfile (AP28)`);
426
- // AP8: draws are a view's budget now (the engine draws a material once across tiles; format VIEW_DRAWS), not a tile's
427
- const over = report.tiles.filter((t) => t.triangles > 40_000);
428
- if (over.length > 0) console.info(`scene: ${over.length} tiles are over the phone tile triangle cap (J338; AP9 turns this into a per-part table): ${over.map((t) => `${t.tile} ${t.triangles} tris ${t.draws} draws`).join(', ')}`);
471
+ // AP9a: the per-part budget table, each tier's overruns named by tile and part (reported, J338; AP8: draws are a view's)
472
+ for (const line of budgetReport(partBudgets(scene), report.tiles)) console.info(`scene: ${line}`);
429
473
  return Promise.resolve({ shard, output: {} });
430
474
  }
431
475
 
@@ -447,7 +491,8 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
447
491
  // textures (AP2): RGBA8 KTX2, one file per painted raster
448
492
  const textureFiles = new Map<string, Shardfile['files'][number]>();
449
493
  // only the textures a drawn material or a card samples
450
- const sampled = new Set(scene.parts.flatMap((part) => [...part.draws.map((d) => d.material), ...part.sprites.map((c) => c.material), ...part.points.map((c) => c.material)].map((key) => scene.materials[key]?.map)).filter((key) => typeof key === 'string'));
494
+ const sampled = new Set([...scene.parts.flatMap((part) => [...part.draws.map((d) => d.material), ...part.sprites.map((c) => c.material), ...part.points.map((c) => c.material)]), ...(scene.details ?? []).map((layer) => layer.material)]
495
+ .map((key) => scene.materials[key]?.map).filter((key) => typeof key === 'string'));
451
496
  for (const texture of Object.values(scene.textures).filter((t) => sampled.has(t.key))) {
452
497
  const bytes = bakeRawColourPixels({ width: texture.width, height: texture.height, pixels: new Uint8ClampedArray(texture.rgba) }, { colourSpace: texture.colourSpace });
453
498
  textureFiles.set(texture.key, store(bytes, 'ktx2'));
@@ -496,8 +541,40 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
496
541
  propMaterials[name] = { id: lookId(key), ...(file === undefined ? {} : { colour: { file: file.hash, wrapS: 10497, wrapT: 10497, minFilter: 9987, magFilter: 9729, anisotropy: 4 } }) };
497
542
  }
498
543
  lookMaterials[GROUND_MATERIAL] = groundEntry(scene);
544
+ // AP32c: detail layers: the card, mask and heights as plain binary files (engine G649: never base64), the card's own look
545
+ // entry (no vertex colours: the cards have none, the engine tints each clump)
546
+ const binary = (bytes: Uint8Array, gpu: number, triangles: number): string => {
547
+ const hash = hashImmutableBytes(bytes);
548
+ if (!assets.has(hash)) { assets.set(hash, bytes); files.push({ hash, kind: 'binary', compressed: bytes.length, decoded: bytes.length, gpu, triangles, draws: triangles > 0 ? 1 : 0, dependencies: [], critical: false }); }
549
+ return hash;
550
+ };
551
+ const detailTextures = new Set<string>();
552
+ const details = (scene.details ?? []).map((layer) => {
553
+ const material = scene.materials[layer.material], geometry = scene.geometries[layer.geometry];
554
+ if (material === undefined || geometry === undefined) throw new SceneRefusalError(layer.path, 'its card did not lower', 'Give world.detail an InstancedMesh with a geometry and a MeshStandardMaterial');
555
+ const look = lookId(`${layer.material}.detail`);
556
+ const entry = materialEntry({ material, motion: null, card: false });
557
+ entry['vertexColours'] = false;
558
+ // AP32d: a textured card's map is its look entry's colour map (a library KTX2, as the tiles' own), its uvs carrying the
559
+ // map's repeat and offset as a tile merge's do
560
+ const map = material.map === null ? undefined : textureFiles.get(material.map);
561
+ if (map !== undefined) { entry['maps'] = { colour: map.hash, normal: null, orm: null }; detailTextures.add(map.hash); }
562
+ lookMaterials[look] = entry;
563
+ const mesh = detailMeshFile(geometry, material), { region } = layer;
564
+ const faults = detailFileFaults({ id: layer.id, mesh: { file: '', vertices: mesh.vertices, triangles: mesh.triangles }, region }, { mesh: mesh.bytes, mask: layer.mask, heights: layer.heights });
565
+ if (faults.length > 0) throw new SceneRefusalError(layer.path, faults.join('; '), 'Report this: the sdk wrote a detail file the format refuses');
566
+ const row: Record<string, unknown> = {
567
+ id: layer.id, material: look, mesh: { file: binary(mesh.bytes, mesh.bytes.length, mesh.triangles), vertices: mesh.vertices, triangles: mesh.triangles },
568
+ region: { corner: [round(region.corner[0], 3), round(region.corner[1], 3)], cell: region.cell, columns: region.columns, rows: region.rows, span: [round(region.span[0], 3), round(region.span[1], 3)] },
569
+ mask: binary(layer.mask, 0, 0), heights: binary(layer.heights, 0, 0), clumps: layer.clumps,
570
+ scale: [round(layer.scale[0], 3), round(layer.scale[1], 3)], tilt: round(clamp01(layer.tilt), 3), tint: [srgb01(layer.tint[0]), srgb01(layer.tint[1])],
571
+ radius: layer.radius, shadow: layer.shadow,
572
+ };
573
+ if (layer.sway !== null) row['sway'] = { amount: round(clamp01(layer.sway.amount), 3), rate: round(layer.sway.rate, 3) };
574
+ return row as { mesh: { file: string }; mask: string; heights: string };
575
+ });
499
576
  const shardTiles = terrain.tiles.map((t) => ({ ...t, files: [...t.files], bounds: { min: [...t.bounds.min] as [number, number, number], max: [...t.bounds.max] as [number, number, number] } }));
500
- const propTiles: { lod: 0; x: number; z: number; file: string }[] = [], tileReport: { tile: string; triangles: number; draws: number; bytes: number }[] = [];
577
+ const propTiles: { lod: 0 | 1; x: number; z: number; file: string }[] = [], tileReport: { tile: string; triangles: number; draws: number; bytes: number }[] = [];
501
578
  const addresses = [...new Set([...tiles.keys(), ...instanced.keys()])].sort((a, b) => a.localeCompare(b));
502
579
  for (const address of addresses) {
503
580
  const merges = tiles.get(address) ?? new Map<string, Merge>();
@@ -521,10 +598,10 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
521
598
  // AP15: the tile's instance groups, at most INSTANCE_CAP copies a node
522
599
  for (const group of instanced.get(address) ?? []) {
523
600
  const entry = entries.get(group.key), material = entry?.material; if (entry === undefined || material === undefined) continue;
524
- const glbMaterial = new MeshStandardMaterial({ color: 0xffffff, vertexColors: true }); glbMaterial.name = glbNames.get(group.key) ?? group.key;
601
+ const groupMaterial = glbMaterial(glbNames.get(group.key) ?? group.key, material);
525
602
  for (let from = 0; from < group.matrices.length; from += INSTANCE_CAP) {
526
603
  const colours = group.colours?.slice(from, from + INSTANCE_CAP);
527
- primitives.push({ geometry: group.geometry, material: glbMaterial, castShadow: group.castShadow, instances: group.matrices.slice(from, from + INSTANCE_CAP), ...(colours === undefined ? {} : { instanceColours: colours }) });
604
+ primitives.push({ geometry: group.geometry, material: groupMaterial, castShadow: group.castShadow, instances: group.matrices.slice(from, from + INSTANCE_CAP), ...(colours === undefined ? {} : { instanceColours: colours }) });
528
605
  }
529
606
  drawn.union(group.box);
530
607
  const file = material.map === null ? undefined : textureFiles.get(material.map); if (file !== undefined) dependencies.add(file.hash);
@@ -560,6 +637,68 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
560
637
  const row = { triangles: rows.reduce((n, f) => n + f.triangles, 0), draws: rows.reduce((n, f) => n + f.draws, 0), compressed: rows.reduce((n, f) => n + f.compressed, 0) };
561
638
  tileReport.push({ tile: `0/${x}/${z}`, triangles: row.triangles, draws: row.draws, bytes: row.compressed });
562
639
  }
640
+ // AP9c: each L1 tile carries a simplified copy of its four fine tiles' still meshes and of their larger instanced shapes;
641
+ // cards and moving entries stay near-only. The engine draws an L1 tile where its fine tiles are not resident.
642
+ const coarseShapes = new Map<BufferGeometry, BufferGeometry>();
643
+ const coarseShape = (geometry: BufferGeometry): BufferGeometry => {
644
+ const found = coarseShapes.get(geometry); if (found !== undefined) return found;
645
+ const simplified = compacted(coarseGeometry(geometry, COARSE_RATIO, COARSE_ERROR, { sloppy: true }));
646
+ // a shape simplified to nothing keeps its own geometry (an empty GLB accessor is refused)
647
+ const made = (simplified.getIndex()?.count ?? 0) === 0 ? geometry : simplified; coarseShapes.set(geometry, made); return made;
648
+ };
649
+ for (let x = 0; x < 4; x++) for (let z = 0; z < 4; z++) {
650
+ const children = [[0, 0], [0, 1], [1, 0], [1, 1]].map(([dx = 0, dz = 0]) => `${String(x * 2 + dx)}/${String(z * 2 + dz)}`);
651
+ const byKey = new Map<string, Merge>();
652
+ for (const child of children) {
653
+ for (const [key, merge] of [...(tiles.get(child) ?? new Map<string, Merge>())].sort(([p], [q]) => p.localeCompare(q))) {
654
+ const entry = entries.get(key); if (entry === undefined || entry.card || entry.motion !== null || merge.position.length === 0) continue;
655
+ const whole = byKey.get(key) ?? emptyMerge(); appendMerge(whole, merge); byKey.set(key, whole);
656
+ }
657
+ }
658
+ const primitives: GlbPrimitive[] = [], dependencies = new Set<string>(), drawn = new Box3();
659
+ for (const [key, merge] of [...byKey].sort(([p], [q]) => p.localeCompare(q))) {
660
+ const entry = entries.get(key); if (entry === undefined) continue;
661
+ for (const primitive of primitivesOf(merge, entry, glbNames.get(key) ?? key, false)) {
662
+ const geometry = compacted(coarseGeometry(primitive.geometry, COARSE_RATIO, COARSE_ERROR, { sloppy: true }));
663
+ if ((geometry.getIndex()?.count ?? 0) === 0) continue;
664
+ primitives.push({ ...primitive, geometry });
665
+ }
666
+ const file = entry.material.map === null ? undefined : textureFiles.get(entry.material.map); if (file !== undefined) dependencies.add(file.hash);
667
+ }
668
+ for (const child of children) for (const group of instanced.get(child) ?? []) {
669
+ const entry = entries.get(group.key); if (entry === undefined) continue;
670
+ group.geometry.computeBoundingBox(); const box = group.geometry.boundingBox;
671
+ if (box === null || box.max.x - box.min.x < COARSE_MIN_SIZE && box.max.y - box.min.y < COARSE_MIN_SIZE && box.max.z - box.min.z < COARSE_MIN_SIZE) continue;
672
+ const geometry = coarseShape(group.geometry), material = glbMaterial(glbNames.get(group.key) ?? group.key, entry.material);
673
+ for (let from = 0; from < group.matrices.length; from += INSTANCE_CAP) {
674
+ const colours = group.colours?.slice(from, from + INSTANCE_CAP);
675
+ primitives.push({ geometry, material, castShadow: false, instances: group.matrices.slice(from, from + INSTANCE_CAP), ...(colours === undefined ? {} : { instanceColours: colours }) });
676
+ }
677
+ drawn.union(group.box);
678
+ const file = entry.material.map === null ? undefined : textureFiles.get(entry.material.map); if (file !== undefined) dependencies.add(file.hash);
679
+ }
680
+ if (primitives.length === 0) continue;
681
+ for (const primitive of primitives) if (primitive.instances === undefined) { primitive.geometry.computeBoundingBox(); if (primitive.geometry.boundingBox !== null) drawn.union(primitive.geometry.boundingBox); }
682
+ const size = primitives.reduce((n, primitive) => n + glbBytes(primitive), 0);
683
+ if (size > 18_000_000) throw new Error(`scene: the generated L1 tile 1/${String(x)}/${String(z)} is ${(size / 1e6).toFixed(1)} MB, over the 18 MB one GLB holds (AP9c)`);
684
+ const row = store(staticGlb(primitives, `scene.l1.${String(x)}.${String(z)}`), 'glb', [...dependencies].sort());
685
+ propTiles.push({ lod: 1, x, z, file: row.hash });
686
+ const tile = shardTiles.find((t) => t.lod === 1 && t.x === x && t.z === z);
687
+ if (tile === undefined) throw new Error(`scene: no terrain tile 1/${String(x)}/${String(z)}`);
688
+ const textures = [...dependencies].map((hash) => files.find((f) => f.hash === hash)).filter((f) => f !== undefined);
689
+ tile.files.push(row.hash, ...textures.map((f) => f.hash).filter((hash) => !tile.files.includes(hash)));
690
+ tile.compressed += row.compressed + textures.reduce((n, f) => n + f.compressed, 0); tile.decoded += row.decoded + textures.reduce((n, f) => n + f.decoded, 0);
691
+ tile.gpu += row.gpu + textures.reduce((n, f) => n + f.gpu, 0); tile.triangles += row.triangles; tile.draws += row.draws;
692
+ if (!drawn.isEmpty()) {
693
+ tile.bounds.min[1] = Math.min(tile.bounds.min[1], drawn.min.y); tile.bounds.max[1] = Math.max(tile.bounds.max[1], drawn.max.y);
694
+ // an instanced copy is whole in its seat's tile, so it may hang over the L1 tile's edge: its draw bounds say so
695
+ if (drawn.min.x < tile.bounds.min[0] || drawn.min.z < tile.bounds.min[2] || drawn.max.x > tile.bounds.max[0] || drawn.max.z > tile.bounds.max[2]) {
696
+ const low = (v: number): number => Math.max(-HALF - OVERHANG, Math.floor(v * 1000) / 1000), high = (v: number): number => Math.min(HALF + OVERHANG, Math.ceil(v * 1000) / 1000);
697
+ tile.drawBounds = { min: [low(Math.min(tile.bounds.min[0], drawn.min.x)), tile.bounds.min[1], low(Math.min(tile.bounds.min[2], drawn.min.z))],
698
+ max: [high(Math.max(tile.bounds.max[0], drawn.max.x)), tile.bounds.max[1], high(Math.max(tile.bounds.max[2], drawn.max.z))] };
699
+ }
700
+ }
701
+ }
563
702
  // panels (AP16): one library GLB each, its texture slots as dependencies
564
703
  const panels = panelParts.map(({ id, merges, shadows }) => {
565
704
  const primitives: GlbPrimitive[] = [], dependencies = new Set<string>();
@@ -580,7 +719,8 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
580
719
  if (size > 18_000_000) throw new SceneRefusalError(id, `a panel part's mesh is ${(size / 1e6).toFixed(1)} MB, over the 18 MB a panel GLB holds`, 'Split it into smaller panel parts, or drop detail from its meshes');
581
720
  return { id, file: store(staticGlb(primitives, `scene.panel.${id}`), 'glb', [...dependencies].sort()).hash, visible: true };
582
721
  });
583
- const library = panels.map((panel) => panel.file);
722
+ // AP32c: a detail layer's three files load with the shard (the charged library), not per tile
723
+ const library = [...panels.map((panel) => panel.file), ...details.flatMap((row) => [row.mesh.file, row.mask, row.heights]), ...[...detailTextures].sort()];
584
724
  // colliders (AP4); a panel part's solids are its panel's one collider (AP16)
585
725
  const colliders = scene.parts.filter((part) => part.colliders.length > 0).map((part) => ({ id: part.panel ?? `scene.${part.name}`, panel: part.panel ?? null, initialActive: true, shapes: part.colliders.map(boxRow) }));
586
726
  // water (AP4)
@@ -590,8 +730,9 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
590
730
  const [sx, sy, sz] = scene.spawn.position;
591
731
  const spawnY = Math.max(sy, (ground?.heightAt(sx, sz) ?? 0) + 1);
592
732
  const product = {
593
- ...base, budgets: { ...base.budgets, library: libraryCost(files, library), sim: { resident: 16_000_000, compressed: 1_000_000 } }, serverBudget: { ...base.serverBudget, tickMicros: 5_000, memory: 16_000_000 },
594
- look: sceneLook(scene, lights, lookMaterials), spawn: { x: round(sx, 3), y: round(spawnY, 3), z: round(sz, 3), yaw: round(scene.spawn.yaw, 4) },
733
+ ...base, budgets: { ...base.budgets, library: libraryCost(files, library), sim: { resident: SIM_CEILING, compressed: libraryCost(files, terrain.critical).compressed } },
734
+ serverBudget: { ...base.serverBudget, tickMicros: SERVER_TICK_MICROS, memory: SIM_CEILING },
735
+ look: { ...sceneLook(scene, lights, lookMaterials), ...(details.length === 0 ? {} : { details }) }, spawn: { x: round(sx, 3), y: round(spawnY, 3), z: round(sz, 3), yaw: round(scene.spawn.yaw, 4) },
595
736
  terrain: { ...terrain.terrain, shadow: { cast: true, receive: true }, follow: 5 }, tiles: shardTiles, files: files.sort((a, b) => a.hash.localeCompare(b.hash)), edge: terrain.edge,
596
737
  critical: [...terrain.critical], far: null, library: [...base.library, ...library],
597
738
  props: { version: 1, family: 'pbr', overhang: OVERHANG, tiles: propTiles, panels, models: [], far: null, textures: [], colliders, ...(Object.keys(propMaterials).length === 0 ? {} : { materials: propMaterials }) },
@@ -600,6 +741,7 @@ export function sceneShardfile(scene: ShardScene, options: ShardfileOptions = {}
600
741
  // oxlint-disable-next-line unicorn/prefer-structured-clone -- JSON wire normalization (signed zero), as product.ts does
601
742
  let shard = parseShardfile(JSON.parse(JSON.stringify(product)));
602
743
  if (options.extend !== undefined) shard = options.extend(shard);
744
+ shard = withAnchored(shard, scene.anchored);
603
745
  return { shard, assets, report: { cards, lampsDropped: Math.max(0, lights.filter((l) => l.kind === 'point').length - 16), tiles: tileReport } };
604
746
  }
605
747
 
@@ -629,6 +771,46 @@ export function sceneGameplay(identity: ShardScene['identity'], options: Shardfi
629
771
  return { gameplay, rest };
630
772
  }
631
773
 
774
+ /**
775
+ * AP25: the scene's anchored rows merged into the sections `extend` wrote (`quests.triggers`, `targets.interactions`), after
776
+ * it, so an `extend` that replaces `quests` keeps them. An id `extend` already declares is refused: one place, one row.
777
+ */
778
+ export function withAnchored<T extends { quests?: unknown; targets?: unknown }>(shard: T, anchored: ShardScene['anchored']): T {
779
+ if (anchored.triggers.length === 0 && anchored.interactions.length === 0) return shard;
780
+ const quests = (shard.quests ?? { flags: [], quests: [], triggers: [], dialogue: [] }) as { flags?: readonly string[]; triggers?: readonly { id: string }[] };
781
+ // a trigger's flag is a quest flag: declare the ones `extend` did not (review SHOULD 4)
782
+ const flags = [...quests.flags ?? []]; for (const t of anchored.triggers) if (!flags.includes(t.flag)) flags.push(t.flag);
783
+ const targets = (shard.targets ?? { panels: [], interactions: [] }) as { interactions?: readonly { id: string }[] };
784
+ const twice = (rows: readonly { id: string }[], added: readonly { id: string }[], what: string): void => {
785
+ const taken = new Set(rows.map((row) => row.id)), clash = added.find((row) => taken.has(row.id));
786
+ if (clash !== undefined) throw new SceneRefusalError(clash.id, `extend declares ${what} ${clash.id} too`, `Declare it once: drop the row from extend, or rename the scene's`);
787
+ };
788
+ twice(quests.triggers ?? [], anchored.triggers, 'trigger'); twice(targets.interactions ?? [], anchored.interactions, 'interaction');
789
+ return {
790
+ ...shard,
791
+ ...(anchored.triggers.length === 0 ? {} : { quests: { ...quests, flags, triggers: [...quests.triggers ?? [], ...anchored.triggers] } }),
792
+ ...(anchored.interactions.length === 0 ? {} : { targets: { ...targets, interactions: [...targets.interactions ?? [], ...anchored.interactions] } }),
793
+ };
794
+ }
795
+
796
+ /**
797
+ * AP32c: a detail card in the format's mesh file layout (`look-details-bytes.ts`): f32 positions, normals and uvs (zero
798
+ * when the card has none), then u16 indices (in order when it has no index).
799
+ */
800
+ export function detailMeshFile(geometry: SceneGeometry, material?: Pick<SceneMaterial, 'repeat' | 'offset'>): { bytes: Uint8Array; vertices: number; triangles: number } {
801
+ const vertices = geometry.position.length / 3, triangles = geometry.triangles;
802
+ const indices = Uint16Array.from(geometry.index ?? Array.from({ length: triangles * 3 }, (_, i) => i));
803
+ const floats = new Float32Array(vertices * 8);
804
+ floats.set(geometry.position, 0); floats.set(geometry.normal, vertices * 3);
805
+ if (geometry.uv !== null) {
806
+ const [ru, rv] = material?.repeat ?? [1, 1], [ou, ov] = material?.offset ?? [0, 0];
807
+ for (let at = 0; at < vertices; at++) { floats[vertices * 6 + at * 2] = (geometry.uv[at * 2] ?? 0) * ru + ou; floats[vertices * 6 + at * 2 + 1] = (geometry.uv[at * 2 + 1] ?? 0) * rv + ov; }
808
+ }
809
+ const bytes = new Uint8Array(detailMeshBytes(vertices, triangles));
810
+ bytes.set(new Uint8Array(floats.buffer), 0); bytes.set(new Uint8Array(indices.buffer), floats.byteLength);
811
+ return { bytes, vertices, triangles };
812
+ }
813
+
632
814
  /** The scene's ground as the terrain bake reads it: the declared height field, or a flat cell. */
633
815
  function groundSource(scene: ShardScene): Parameters<typeof bakeTerrain>[0] {
634
816
  const ground = scene.ground;
@@ -43,9 +43,9 @@ export function shardRepoRoot(source: string): string {
43
43
  const given = resolve(source), parent = dirname(given);
44
44
  if (isRepoSource(given)) return parent;
45
45
  if (basename(parent) === 'shards' && basename(dirname(parent)) === 'src') return dirname(dirname(parent));
46
- for (let at = parent; ; at = dirname(at)) {
46
+ for (let at = given; ; at = dirname(at)) {
47
47
  if (existsSync(resolve(at, 'package.json')) || existsSync(resolve(at, '.git'))) return at;
48
- if (dirname(at) === at) return parent;
48
+ if (dirname(at) === at) return given;
49
49
  }
50
50
  }
51
51
 
@@ -28,12 +28,13 @@ export async function readDiskScriptScenario(slug: string, id: string, options:
28
28
  const rows = decisionScriptsFromSections(sections);
29
29
  const row = rows.find(value => value.id === id), ordinal = rows.findIndex(value => value.id === id);
30
30
  if (row === undefined) throw new Error(`Missing simulation scenario script ${id}`);
31
+ if (row.side !== 'sim') throw new Error('Scenario script must run on simulation side');
31
32
  const moves = parseActorMoves(sections.get('actors/moves') ?? []), targets = sections.get('world/targets');
32
33
  const nativePlan = sections.get('sim/runtime-plan');
33
34
  const nativeActors = shard.runtime === null && nativePlan !== undefined ? nativeRuntimeActorIds(nativePlan) : [];
34
35
  const registries = buildDecisionRegistries(shard, moves, targets === undefined ? undefined : parseWorldTargets(targets), readCreatureStrikes(sections.get('actors/strikes') ?? []), rows, nativeActors);
35
36
  const map = decisionBindingMap(row, registries), handles = Object.values(map.ids.actors ?? {});
36
- const script: DecisionScript = { ...row, ids: map.ids, state: [...row.state], reads: row.reads.filter((name): name is ScriptV1ReadName => Object.hasOwn(SCRIPT_V1_READS, name)),
37
+ const script: DecisionScript = { ...row, side: row.side, ids: map.ids, state: [...row.state], reads: row.reads.filter((name): name is ScriptV1ReadName => Object.hasOwn(SCRIPT_V1_READS, name)),
37
38
  lists: row.reads.filter((name): name is ScriptV1ListName => Object.hasOwn(SCRIPT_V1_LISTS, name)) };
38
39
  const file = index.files.find(value => value.kind === 'wasm' && value.path === row.module);
39
40
  if (file?.name === undefined) throw new Error('Scenario module requires an admitted logical blob name');
@@ -79,7 +80,8 @@ export async function readDiskScriptScenario(slug: string, id: string, options:
79
80
  const bindings = 'spawnGroup' in binding ? handles.map((actor, ordinalIndex) => ({ id: ordinalIndex + 1, script: row.id, self: actor, actors: [actor], instance: 0 }))
80
81
  : [{ id: ordinal + 1, script: row.id, self, actors: handles, instance: 0 }];
81
82
  const primary = bindings[0]; if (primary === undefined) throw new Error('Empty scenario binding');
82
- const made = createScriptScenario(DecisionHost, { ...options, actors, spawnGroups, seed: options.seed, script, bytes, binding: primary, bindings });
83
+ if(Object.keys(options.fields??{}).some(key=>!Object.hasOwn(fieldValues,key)))throw new Error('Unknown scenario shared field');
84
+ const made = createScriptScenario(DecisionHost, { ...options, fields:{...fieldValues,...options.fields},fieldBounds:bounds,actors, spawnGroups, seed: options.seed, script, bytes, binding: primary, bindings });
83
85
  const entry = index.sections.find(value => value.name === 'sim/scripts'); if (entry === undefined) throw new Error('Missing scenario section');
84
86
  return Object.assign(made, { product: Object.freeze({ slug, script: row.id, sectionHash: entry.hash,
85
87
  indexHash: descriptor.indexHash }) });
@@ -0,0 +1,14 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Tests own their bounded repository scratch.
2
+ import { existsSync, mkdtempSync, readdirSync, rmSync } from 'node:fs';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- Tests never use the system temp directory.
4
+ import { join, resolve } from 'node:path';
5
+ import { scratchDir } from '../../../scripts/scratch-dir.mjs';
6
+
7
+ const task = process.env['WS_LANE_NAME'] ?? `test-dev-${process.pid}`;
8
+ const existed = existsSync(resolve('tmp', task));
9
+ const parent = scratchDir(task, 'SDK dev fixture', { env: { ...process.env, WS_LANE_NAME: task } });
10
+
11
+ export const fixtureRoot = (prefix: string): string => mkdtempSync(join(parent, prefix));
12
+ export function closeFixtures(): void {
13
+ if (!existed && readdirSync(parent).every(name => name === '.owner')) rmSync(parent, { recursive: true });
14
+ }
@@ -7,6 +7,8 @@ export interface ScenarioActor {
7
7
  fields?: Readonly<Record<number, number>>; fieldBounds?: Readonly<Record<number, { min: number; max: number; integer?: boolean }>>; moving?: boolean; strikeState?: number; spawn?: number;
8
8
  }
9
9
  export interface ScenarioWorldInput {
10
+ /** Declared shared field writes use target zero, matching the real DecisionHost ABI. */
11
+ fields?: ScenarioActor['fields']; fieldBounds?: ScenarioActor['fieldBounds'];
10
12
  actors?: readonly ScenarioActor[]; players?: readonly ScenarioActor[];
11
13
  spawnGroups?: readonly { id: number; members: readonly number[] }[];
12
14
  flags?: Readonly<Record<number, boolean>>; playerFlags?: Readonly<Record<number, Readonly<Record<number, boolean>>>>;
@@ -23,7 +25,7 @@ export interface ScriptScenarioInput extends ScenarioWorldInput {
23
25
  export interface ScenarioSnapshot { host: DecisionSnapshot; world: ScenarioWorldInput }
24
26
  export type ScenarioCommand = readonly (string | number)[];
25
27
  /** Disk fixtures name actor aliases or real platform ids; numeric handles must already be registered. */
26
- export interface DiskScenarioOptions extends Omit<ScenarioWorldInput, 'actors'> {
28
+ export interface DiskScenarioOptions extends Omit<ScenarioWorldInput, 'actors' | 'fieldBounds'> {
27
29
  seed: number;
28
30
  /** Published output root, defaulting to out/ in the caller's working directory. */
29
31
  products?: string;
@@ -42,11 +44,15 @@ export async function scenario(slug: string, id: string, options: DiskScenarioOp
42
44
  return readDiskScriptScenario(slug, id, options);
43
45
  }
44
46
  function finite(values: readonly number[]): void { if (!values.every(Number.isFinite)) throw new Error('Non-finite scenario value'); }
45
- function actorCopy(actor: ScenarioActor): ScenarioActor {
46
- for (const [key, bound] of Object.entries(actor.fieldBounds ?? {})) {
47
- finite([bound.min, bound.max]); const value = actor.fields?.[Number(key)];
47
+ function checkFields(fields:ScenarioActor['fields'],bounds:ScenarioActor['fieldBounds']):void{
48
+ finite(Object.values(fields??{}));
49
+ for (const [key, bound] of Object.entries(bounds ?? {})) {
50
+ finite([bound.min, bound.max]); const value = fields?.[Number(key)];
48
51
  if (bound.min > bound.max || value === undefined || value < bound.min || value > bound.max || (bound.integer === true && !Number.isInteger(value))) throw new Error('Invalid scenario field bounds');
49
52
  }
53
+ }
54
+ function actorCopy(actor: ScenarioActor): ScenarioActor {
55
+ checkFields(actor.fields,actor.fieldBounds);
50
56
  return { ...actor, at: [...actor.at], fields: { ...actor.fields }, fieldBounds: structuredClone(actor.fieldBounds ?? {}) };
51
57
  }
52
58
 
@@ -119,13 +125,10 @@ export class ScenarioWorld implements DecisionWorld {
119
125
  return this.actor(id);
120
126
  };
121
127
  for (const [op, target, a, b] of batch) {
122
- if ([commands.field, commands.move, commands.stop, commands.strike, commands.despawn].some(value => value === op)) {
123
- const actor = owned(target);
124
- if (op === commands.field) {
125
- const bound = actor.fieldBounds?.[a];
126
- if (actor.fields?.[a] === undefined || !Number.isFinite(b) || (bound !== undefined && (b < bound.min || b > bound.max || (bound.integer === true && !Number.isInteger(b))))) throw new Error('Scenario field declaration or bounds refused');
127
- }
128
- }
128
+ if(op===commands.field){
129
+ const value=target===0?this.input:owned(target),bound=value.fieldBounds?.[a];
130
+ if(value.fields?.[a]===undefined||!Number.isFinite(b)||(bound!==undefined&&(b<bound.min||b>bound.max||(bound.integer===true&&!Number.isInteger(b)))))throw new Error('Scenario field declaration or bounds refused');
131
+ }else if([commands.move,commands.stop,commands.strike,commands.despawn].some(value=>value===op))owned(target);
129
132
  if ([commands.grant, commands.reward, commands.flag].some(value => value === op) && target !== 0 && !player(target)) throw new Error('Scenario target is not an observed player');
130
133
  if ((op === commands.impulse || (op === commands.cue && target !== 0)) && !player(target)) owned(target);
131
134
  if (op === commands.flag && b !== 0 && b !== 1) throw new Error('Scenario flag value refused');
@@ -136,6 +139,7 @@ export class ScenarioWorld implements DecisionWorld {
136
139
  if (op === commands.flag) this.input = target === 0
137
140
  ? { ...this.input, flags: { ...this.input.flags, [a]: b === 1 } }
138
141
  : { ...this.input, playerFlags: { ...this.input.playerFlags, [target]: { ...this.input.playerFlags?.[target], [a]: b === 1 } } };
142
+ if(op===commands.field&&target===0)this.input={...this.input,fields:{...this.input.fields,[a]:b}};
139
143
  const actor = this.actors.get(target); if (actor === undefined) continue;
140
144
  if (op === commands.field) this.actors.set(target, { ...actor, fields: { ...actor.fields, [a]: b } });
141
145
  if (op === commands.move || op === commands.stop) this.actors.set(target, { ...actor, moving: op === commands.move });
@@ -151,7 +155,8 @@ export class ScenarioWorld implements DecisionWorld {
151
155
  return structuredClone({ ...this.input, actors: [...this.actors.values()].filter(actor => !this.players.has(actor.id)), players: [...this.players].map(id => this.actor(id)) });
152
156
  }
153
157
  restore(input: ScenarioWorldInput): void {
154
- const copy = structuredClone({ actors: input.actors ?? [], players: input.players ?? [], spawnGroups: input.spawnGroups ?? [], flags: input.flags ?? {}, playerFlags: input.playerFlags ?? {}, zones: input.zones ?? [], lists: input.lists ?? [] }), actors = new Map<number, ScenarioActor>();
158
+ const copy = structuredClone({ actors: input.actors ?? [], players: input.players ?? [], spawnGroups: input.spawnGroups ?? [], flags: input.flags ?? {}, playerFlags: input.playerFlags ?? {}, zones: input.zones ?? [], lists: input.lists ?? [],...(input.fields===undefined?{}:{fields:input.fields}),...(input.fieldBounds===undefined?{}:{fieldBounds:input.fieldBounds}) }), actors = new Map<number, ScenarioActor>();
159
+ checkFields(copy.fields,copy.fieldBounds);
155
160
  for (const actor of [...copy.actors, ...copy.players]) {
156
161
  if (!Number.isSafeInteger(actor.id) || actor.id <= 0 || actors.has(actor.id)) throw new Error('Invalid or duplicate scenario actor');
157
162
  finite([...actor.at, actor.yaw ?? 0, actor.hpShare ?? 1, ...Object.values(actor.fields ?? {})]); actors.set(actor.id, actorCopy(actor));
@@ -181,7 +186,7 @@ export function scenarioCommand(script: DecisionScript, [op, target, a, b, c]: S
181
186
  if (op === commands.grant || op === commands.reward) return [op === commands.grant ? 'grant' : 'reward', actor(target), name(op === commands.grant ? 'facts' : 'rewards', a)];
182
187
  if (op === commands.impulse) return ['impulse', actor(target), name('impulses', a)];
183
188
  if (op === commands.weather) return ['weather', name('weather', a)];
184
- if (op === commands.encounter) { const verb = ['phase', 'win', 'fail'][a - 1]; if (verb === undefined) throw new Error('Unknown encounter verb'); return ['encounter', verb, b]; }
189
+ if (op === commands.encounter) { const verb = ['phase', 'win', 'fail', 'guard'][a - 1]; if (verb === undefined) throw new Error('Unknown encounter verb'); return ['encounter', verb, b]; }
185
190
  const view = Object.entries(commands).find(([key, value]) => key.startsWith('view.') && value === op)?.[0];
186
191
  if (view !== undefined) return [view, target, a, b, c];
187
192
  throw new Error(`Unknown scenario command ${op}`);
@@ -0,0 +1,3 @@
1
+ {
2
+ "extends": "../../tsconfig.author.json"
3
+ }
@@ -21,29 +21,11 @@ const panel = (): HTMLElement => {
21
21
  held = node;
22
22
  return node;
23
23
  };
24
- /**
25
- * Engine 0.1.21 and earlier give every `game.watchFrames` observer the one system id `harness.walk`. The dev hook's ground
26
- * sweep takes it at boot, so the first part with a lamp or water threw "Duplicate system id" and never drew. Until the sdk
27
- * pins an engine whose observers carry their own ids, the page gives each later observer its own (engine-quickfix fix,
28
- * SHARD-SOURCE AP16). The engine's fields are read loosely: a client without them is left as it is.
29
- */
30
- interface ObserverGame { watchFrames?: unknown; levelScope?: { child?: unknown }; app?: { addSystem?: unknown } }
31
- let observers = 0;
32
- const ownObserverIds = (): void => {
33
- const game = (window as unknown as { __wildshard?: { world?: { game?: ObserverGame } } }).__wildshard?.world?.game;
34
- if (game === undefined || typeof game.levelScope?.child !== 'function' || typeof game.app?.addSystem !== 'function') return;
35
- const levelScope = game.levelScope as { child: (name: string) => Scope }, app = game.app as { addSystem: (spec: { id: string; phase: 'update'; run: (dt: number) => void; core: boolean }, scope: Scope) => void };
36
- game.watchFrames = (run: (dt: number) => void): (() => void) => {
37
- const owner = levelScope.child('observer');
38
- app.addSystem({ id: `harness.walk.watch.${String(observers++)}`, phase: 'update', run, core: false }, owner);
39
- return () => { owner.dispose(); };
40
- };
41
- };
42
24
  const entry = location.href;
43
25
  const timers = new Scope('watch.entry');
44
26
  const page = startWatchPage({
45
27
  origin: location.origin,
46
- hook: () => { const found = window.__wildshardDevHook; if (found !== undefined) ownObserverIds(); return found; },
28
+ hook: () => window.__wildshardDevHook,
47
29
  fetch: (url) => fetch(url, { cache: 'no-store' }),
48
30
  socket: (url) => socketOf(new WebSocket(url)),
49
31
  frame: (run) => { timers.raf(run); },
@@ -3,16 +3,16 @@
3
3
  "source": "src/shards/authoring-slice",
4
4
  "cameras": {
5
5
  "hut-front": {
6
- "mean": 2.313,
7
- "share": 0.03784
6
+ "mean": 2.155,
7
+ "share": 0.03402
8
8
  },
9
9
  "door-lamp": {
10
- "mean": 4.26,
11
- "share": 0.07746
10
+ "mean": 4.239,
11
+ "share": 0.07664
12
12
  },
13
13
  "hut-back": {
14
- "mean": 0.561,
15
- "share": 0.00951
14
+ "mean": 0.471,
15
+ "share": 0.00751
16
16
  },
17
17
  "pond": {
18
18
  "mean": 3.499,
@@ -66,15 +66,37 @@ async function shoot(browser, url, live, after = []) {
66
66
  live, { timeout: 180_000, polling: 500 });
67
67
  await page.evaluate(() => {
68
68
  const w = window.__wildshard.world, camera = w.game.camera;
69
+ const lampUpdates = new WeakMap();
69
70
  if (w.animals) w.animals.calm = true;
70
71
  // the camera leaves the player (whose body stands where colliders put it, which this test does not compare): each
71
72
  // frame it is set to the shot's eye, one field of view, no viewmodel
72
73
  w.freeCamera = true;
73
74
  w.game.onLate(() => {
74
75
  const eye = window.__ap20Eye;
76
+ // Sample this static material fixture at one presentation instant.
77
+ // Capture mode holds the tier's render scale; pause holds scheduled
78
+ // systems. Water and lamp accumulators need their own explicit sample.
79
+ let water = 0, lamps = 0;
80
+ w.game.rootScene.traverse((object) => {
81
+ if (object.name.startsWith('water:') && object.material?.uniforms?.uTime !== undefined) {
82
+ object.material.uniforms.uTime.value = 5; water++;
83
+ }
84
+ if (object.name === 'look-light-lamps' && typeof object.update === 'function') {
85
+ let update = lampUpdates.get(object);
86
+ if (update === undefined) {
87
+ update = object.update.bind(object); lampUpdates.set(object, update);
88
+ // The built look updates after late; watch holds the original
89
+ // callback, so both the property and this late sample are needed.
90
+ object.update = () => { update(5); };
91
+ }
92
+ update(5); lamps++;
93
+ }
94
+ });
95
+ window.__ap20Phases = { water, lamps };
75
96
  for (const child of camera.children) child.visible = false;
76
97
  if (Math.abs(camera.fov - 72) > 0.01) { camera.fov = 72; camera.updateProjectionMatrix(); }
77
98
  if (eye !== undefined) { camera.position.set(eye[0], eye[1], eye[2]); camera.rotation.set(eye[4], eye[3], 0, 'YXZ'); camera.updateMatrixWorld(true); }
99
+ w.game.app.clock.restore({ version: 1, elapsed: 5, wall: 5, frames: 300, captureFps: 60, paused: true, scale: 1 });
78
100
  }, 'ap20.camera');
79
101
  });
80
102
  // the watch panel's timings and build table change from run to run: they are not the scene
@@ -86,6 +108,8 @@ async function shoot(browser, url, live, after = []) {
86
108
  for (const [id, x, z, yaw, pitch] of CAMERAS) {
87
109
  await page.evaluate((eye) => { window.__ap20Eye = eye; }, [x, EYE, z, yaw, pitch]);
88
110
  await page.waitForTimeout(2500);
111
+ const phases = await page.evaluate(() => window.__ap20Phases);
112
+ if (phases === undefined || phases.water < 1 || phases.lamps < 1) throw new Error('Parity scene lacks its controlled water or lamp presentation');
89
113
  frames.push({ id, png: await page.screenshot() });
90
114
  }
91
115
  sets.push(frames);
@@ -25,7 +25,7 @@ import * as liveMaterials from '../materials';
25
25
  import * as liveShard from '../scene/shard';
26
26
  import * as liveShardfile from '../scene/shardfile';
27
27
  import { hashOf } from '../scene/hash';
28
- import { lampRows, sceneGroundBytes, sceneLook, waterRows, type sceneGameplay } from '../scene/shardfile';
28
+ import { lampRows, sceneGroundBytes, sceneLook, waterRows, withAnchored, type sceneGameplay } from '../scene/shardfile';
29
29
  import { DEV_SCENE_PATH, WATCH_RESHELL, WATCH_SOCKET, WATCH_WIRE, budgetLines, budgetOf, encodeGeometry, encodePart, hookMismatch, liveShell, type WatchBuild, type WatchState } from './protocol';
30
30
  import { CONTENT_CAPS } from '@wildshard/format/contentBounds';
31
31
  // oxlint-disable-next-line import/no-nodejs-modules -- The idle full build runs `wildshard build` in a child process.
@@ -87,6 +87,14 @@ const livePlugin = (): Plugin => {
87
87
  * in guess mode (AP17): `describe` runs it again, in guess or truth mode, without bundling again.
88
88
  */
89
89
  type Gameplay = ReturnType<typeof sceneGameplay>;
90
+ /** AP25: the scene's anchored rows in the watched gameplay as the build has them: triggers restart the simulation with the
91
+ * quests; a use prompt is `targets`, a new shell. */
92
+ function anchoredGameplay(scene: ShardScene, gameplay: Gameplay): Gameplay {
93
+ const { triggers, interactions } = scene.anchored;
94
+ if (triggers.length === 0 && interactions.length === 0) return gameplay;
95
+ const merged = withAnchored({ quests: gameplay.gameplay['quests'], targets: gameplay.rest['targets'] ?? undefined }, scene.anchored);
96
+ return { gameplay: { ...gameplay.gameplay, quests: merged.quests }, rest: interactions.length === 0 ? gameplay.rest : { ...gameplay.rest, targets: merged.targets } };
97
+ }
90
98
  async function describeSource(source: string, memo: PaintMemo): Promise<{ scene: ShardScene; gameplay: Gameplay; describe: (mode: 'guess' | 'truth') => ShardScene; bundleMs: number; describeMs: number }> {
91
99
  const started = diagnosticNow();
92
100
  const result = await build({ configFile: false, logLevel: 'silent', plugins: [livePlugin()], build: { write: false, minify: false, lib: { entry: resolve(source, 'shard.config.ts'), formats: ['es'], fileName: 'config' }, rolldownOptions: { external: [/^node:/u], output: { codeSplitting: false } } } });
@@ -98,7 +106,7 @@ async function describeSource(source: string, memo: PaintMemo): Promise<{ scene:
98
106
  const shard = [loaded['default'], loaded['generate']].find((value): value is { describe: () => ShardScene; gameplay?: () => Gameplay } => typeof value === 'function' && 'describe' in value && typeof value.describe === 'function');
99
107
  if (shard === undefined) throw new Error('watch: shard.config.ts exports no scene shard (defineShard from @wildshard/sdk/scene/shard)');
100
108
  const describe = (mode: 'guess' | 'truth'): ShardScene => { memo.begin(mode); return withPaintMemo(memo, () => shard.describe()); };
101
- const scene = describe('guess'), gameplay = shard.gameplay?.() ?? { gameplay: {}, rest: {} };
109
+ const scene = describe('guess'), gameplay = anchoredGameplay(scene, shard.gameplay?.() ?? { gameplay: {}, rest: {} });
102
110
  return { scene, gameplay, describe, bundleMs: Math.round(bundled - started), describeMs: Math.round(diagnosticNow() - bundled) };
103
111
  }
104
112