@wildshard/dev 0.0.0-stage → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/wildshard.mjs +75 -0
- package/lint/host-callbacks.d.mts +6 -0
- package/lint/host-callbacks.mjs +123 -0
- package/lint/ratchet.json +3 -0
- package/package.json +101 -3
- package/scripts/audit-assets.d.mts +10 -0
- package/scripts/audit-assets.mjs +151 -0
- package/scripts/bake/coatFiles.d.mts +6 -0
- package/scripts/bake/coatFiles.mjs +37 -0
- package/scripts/bake/navmeshGround.ts +22 -0
- package/scripts/bake/near-placeholder.mjs +331 -0
- package/scripts/bake/viewmodelBytes.ts +26 -0
- package/scripts/bake/viewmodelPage.ts +11 -0
- package/scripts/bake-catalogue.mjs +44 -0
- package/scripts/bake-check.mjs +54 -0
- package/scripts/bake-chunk.mjs +124 -0
- package/scripts/bake-cloud-field.mjs +24 -0
- package/scripts/bake-coats.mjs +110 -0
- package/scripts/bake-data-maps.d.mts +24 -0
- package/scripts/bake-data-maps.mjs +78 -0
- package/scripts/bake-entry-programs.mjs +126 -0
- package/scripts/bake-geometry.mjs +106 -0
- package/scripts/bake-ktx2.mjs +477 -0
- package/scripts/bake-map-glb.mjs +127 -0
- package/scripts/bake-map-rest.d.mts +7 -0
- package/scripts/bake-map-rest.mjs +50 -0
- package/scripts/bake-maps.mjs +200 -0
- package/scripts/bake-navmesh.mjs +259 -0
- package/scripts/bake-packs.mjs +129 -0
- package/scripts/bake-pickups.mjs +102 -0
- package/scripts/bake-query-terrain.mjs +64 -0
- package/scripts/bake-textures.mjs +80 -0
- package/scripts/bake-viewmodel-sets.mjs +137 -0
- package/scripts/bake-voxel-ao.mjs +119 -0
- package/scripts/bake-water-ripples.mjs +25 -0
- package/scripts/browser-imports.d.mts +2 -0
- package/scripts/browser-imports.mjs +40 -0
- package/scripts/browser-machine-loader-proof.mjs +39 -0
- package/scripts/browser-machine-loader.d.mts +8 -0
- package/scripts/browser-machine-loader.mjs +87 -0
- package/scripts/browser-playwright.d.mts +10 -0
- package/scripts/browser-playwright.mjs +5 -0
- package/scripts/browser-test.d.mts +4 -0
- package/scripts/browser-test.mjs +18 -0
- package/scripts/build-sdk.mjs +95 -0
- package/scripts/build-shardfiles.d.mts +7 -0
- package/scripts/build-shardfiles.mjs +230 -0
- package/scripts/capture-hero.mjs +211 -0
- package/scripts/chromium-keychain.d.mts +1 -0
- package/scripts/chromium-keychain.mjs +7 -0
- package/scripts/entry-reads/crawl.ts +152 -0
- package/scripts/gen-host-catalogue.d.mts +14 -0
- package/scripts/gen-host-catalogue.mjs +108 -0
- package/scripts/gen-shards.d.mts +17 -0
- package/scripts/gen-shards.mjs +311 -0
- package/scripts/goldens/plot-inputs.d.mts +12 -0
- package/scripts/goldens/plot-inputs.mjs +46 -0
- package/scripts/gpu-texmem.mjs +98 -0
- package/scripts/ktx2-ab.mjs +111 -0
- package/scripts/map-bake-frames.d.mts +4 -0
- package/scripts/map-bake-frames.mjs +23 -0
- package/scripts/map-world.mjs +162 -0
- package/scripts/memory-product.mjs +62 -0
- package/scripts/music/export-midi.mjs +69 -0
- package/scripts/named-blob-output.d.mts +8 -0
- package/scripts/named-blob-output.mjs +48 -0
- package/scripts/practice/verify_unimate_skin.mjs +356 -0
- package/scripts/preparation-browser.mjs +25 -0
- package/scripts/preparation-seed.mjs +15 -0
- package/scripts/prepare-product.d.mts +14 -0
- package/scripts/prepare-product.mjs +133 -0
- package/scripts/prove-walk.mjs +83 -0
- package/scripts/push-tables.d.mts +1 -0
- package/scripts/push-tables.mjs +28 -0
- package/scripts/record-shard-mounts.mjs +133 -0
- package/scripts/section-inventory.ts +209 -0
- package/scripts/shard-build-pool.d.mts +4 -0
- package/scripts/shard-build-pool.mjs +53 -0
- package/scripts/shard-milestones.d.mts +15 -0
- package/scripts/shard-milestones.mjs +105 -0
- package/scripts/shard-progress.mjs +212 -0
- package/scripts/shardfile-cold-boot.mjs +79 -0
- package/scripts/shardfile-rolldown.d.mts +2 -0
- package/scripts/shardfile-rolldown.mjs +32 -0
- package/scripts/shardfile-vite.d.mts +4 -0
- package/scripts/shardfile-vite.mjs +20 -0
- package/scripts/site-facts.mjs +88 -0
- package/scripts/test-template-gate.mjs +44 -0
- package/scripts/tex-tiers.mjs +240 -0
- package/scripts/unused-assets.mjs +173 -0
- package/scripts/wildshard.d.mts +4 -0
- package/scripts/wildshard.mjs +146 -0
- package/scripts/witness-generation.d.mts +10 -0
- package/scripts/witness-generation.mjs +45 -0
- package/src/.oxlintrc.json +12 -0
- package/src/cli/bin.mjs +8 -0
- package/src/cli/content-command.ts +44 -0
- package/src/cli/content.ts +287 -0
- package/src/cli/grid/command.ts +48 -0
- package/src/cli/grid/grid.ts +155 -0
- package/src/cli/help.ts +262 -0
- package/src/cli/hero/adopt.ts +109 -0
- package/src/cli/install-home.ts +40 -0
- package/src/cli/main.ts +142 -0
- package/src/cli/version.ts +63 -0
- package/src/server/app.ts +19 -0
- package/src/server/serve.ts +49 -0
- package/src/sharddev/bake/json.mjs +84 -0
- package/src/sharddev/bake/mapRest.ts +57 -0
- package/src/sharddev/bake/nativeRaster.ts +106 -0
- package/src/sharddev/bake/source-loader.mjs +55 -0
- package/src/sharddev/bake/splatLayers.ts +29 -0
- package/src/sharddev/bootInventory.ts +132 -0
- package/src/sharddev/check.ts +125 -0
- package/src/sharddev/checkProject.ts +134 -0
- package/src/sharddev/cli.ts +207 -0
- package/src/sharddev/dev.ts +150 -0
- package/src/sharddev/devClient.ts +120 -0
- package/src/sharddev/devRoot.ts +6 -0
- package/src/sharddev/engineMusic.ts +23 -0
- package/src/sharddev/projectEntryProof.ts +32 -0
- package/src/sharddev/test/diskScriptScenario.ts +88 -0
- package/src/sharddev/test/scriptScenario.ts +254 -0
- package/src/sharddev/tsconfig.json +3 -0
- package/src/sharddev/watch/page.ts +288 -0
- package/src/sharddev/watch/pageEntry.ts +44 -0
- package/src/sharddev/watch/parity-baseline.json +22 -0
- package/src/sharddev/watch/parity.mjs +194 -0
- package/src/sharddev/watch/proof.mjs +199 -0
- package/src/sharddev/watch/socket.ts +57 -0
- package/src/sharddev/watch/watch.ts +382 -0
- package/src/shared/health.ts +10 -0
- package/src/tools/build-web.ts +59 -0
- package/src/web/app.tsx +53 -0
- package/src/web/index.html +12 -0
- package/src/web/main.tsx +10 -0
- package/tsconfig.author.json +25 -0
- package/tsconfig.json +47 -0
- package/README.md +0 -3
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// SHARD-SOURCE AP6 (and AP7's shots): drive a running `wildshard watch` (or `dev`) page in headless Chromium.
|
|
3
|
+
//
|
|
4
|
+
// node src/sharddev/watch/proof.mjs --url http://127.0.0.1:<port>/ --out <dir> [--shots] [--time <file> --runs 10]
|
|
5
|
+
//
|
|
6
|
+
// --shots three cleanroom cameras (Mossgate `scripts/cameras.json`: hut front, hut back, pond) to <out>/<id>.png
|
|
7
|
+
// --time edits <file> `runs` times and times each write to the first frame the page draws with the edit (the page
|
|
8
|
+
// script's `framedAt`, same machine clock); it checks the page never reloaded, the frame loop never stopped and
|
|
9
|
+
// the player never moved, and writes <out>/<prefix>proof.json. The file is restored after.
|
|
10
|
+
// --edit what --time edits (SHARD-SOURCE AP6, AP17): `roof` (a material colour, the default), `fog` (density), `exposure`
|
|
11
|
+
// (the grade), `sun` (the key light's direction), `ambient` (the hemisphere's intensity), `lamp` (a point light's
|
|
12
|
+
// intensity), `hill` (AP18: ground under the player), each a line of the authoring slice's `generators/world.ts`;
|
|
13
|
+
// `quest` (AP19: the slice quest's objective, in `generators/shard.ts`), read from the page's own text.
|
|
14
|
+
// --fps the page's frame cap (default 60: GPU benches share Jake's laptop; 0 leaves it uncapped)
|
|
15
|
+
// --motion at the yard camera: frames 0.2 s apart; the flame (pulse), the near fern (sway) and the page's point lights
|
|
16
|
+
// (flicker) must change with no shard code in the page (SHARD-SOURCE AP12); numbers to <out>/proof.json
|
|
17
|
+
// --draws at each camera, the frame's draws (Game.lastFrame.calls, every pass) and the same with the shadow map held,
|
|
18
|
+
// so view and shadow draws split, plus the props' distinct materials in the scene and the fps (SHARD-SOURCE AP8)
|
|
19
|
+
// --throttle N slows the page's CPU N times (a phone stand-in: --url '<page>?tier=phone' --throttle 4)
|
|
20
|
+
import { chromium } from "../../../scripts/browser-playwright.mjs";
|
|
21
|
+
// oxlint-disable-next-line import/no-nodejs-modules -- a node script: it writes the shots and the timing beside the source edit.
|
|
22
|
+
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
23
|
+
// oxlint-disable-next-line import/no-nodejs-modules -- a node script resolves its output folder.
|
|
24
|
+
import { join, resolve } from 'node:path';
|
|
25
|
+
// oxlint-disable-next-line import/no-nodejs-modules -- a node script reads its flags.
|
|
26
|
+
import { parseArgs } from 'node:util';
|
|
27
|
+
|
|
28
|
+
const { values } = parseArgs({ options: { url: { type: 'string' }, out: { type: 'string' }, shots: { type: 'boolean' }, motion: { type: 'boolean' }, draws: { type: 'boolean' }, throttle: { type: 'string' }, time: { type: 'string' }, runs: { type: 'string' }, prefix: { type: 'string' }, edit: { type: 'string' }, fps: { type: 'string' } } });
|
|
29
|
+
if (values.url === undefined || values.out === undefined) throw new Error('usage: proof.mjs --url <page> --out <dir> [--shots] [--time <file> --runs N]');
|
|
30
|
+
const OUT = resolve(values.out), RUNS = Number(values.runs ?? 10), PREFIX = values.prefix ?? '';
|
|
31
|
+
mkdirSync(OUT, { recursive: true });
|
|
32
|
+
// Mossgate cleanroom scripts/cameras.json: [x, z, yaw, pitch], eye 1.68 m, vertical FOV 72
|
|
33
|
+
const CAMERAS = [['03-hut-front', -3.9, -5.6, 0.03, -0.04], ['05-door-lamp', -4.6, -7.8, 0.03, 0.05], ['04-hut-back', -3.9, -10.4, 3.4, -0.05], ['08-pond', -10.4, 0.3, 1.571, -0.08], ['yard-brazier', 2.6, -8.2, -0.62, 0.02], ['10-sky-sun', -10.4, 0.3, -0.31, 0.14]];
|
|
34
|
+
// 10-sky-sun: from the pond toward the low sun, the painted sky and its clouds (SHARD-SOURCE AP14)
|
|
35
|
+
// yard-brazier: the slice's brazier A (5.9, -12.8), its fire, sparks and ferns (SHARD-SOURCE AP10 to AP12)
|
|
36
|
+
const colourOf = (i) => ((0x40 + i * 17) << 16 | (0x90 - i * 7) << 8 | (0x30 + i * 13)).toString(16).padStart(6, '0');
|
|
37
|
+
/** The page's roof colour (page code, passed as text). */
|
|
38
|
+
const ROOF_HEX = `() => { let hex = null; window.__wildshard.world.game.rootScene.getObjectByName('devScene')?.traverse((o) => { if (o.material?.name === 'roof') hex = o.material.color.getHexString(); }); return hex; }`;
|
|
39
|
+
/** Each edit: the line it rewrites, its i-th value, and (optionally) a page reader whose value must equal `expect(i)`. */
|
|
40
|
+
const EDITS = {
|
|
41
|
+
roof: { line: /shingle: new THREE\.MeshStandardMaterial\(\{ name: 'roof', (?:color: 0x[0-9a-f]{6}, )?map: tex\.shingle, roughness: 0\.95 \}\),/u,
|
|
42
|
+
write: (i) => `shingle: new THREE.MeshStandardMaterial({ name: 'roof', color: 0x${colourOf(i)}, map: tex.shingle, roughness: 0.95 }),`, read: ROOF_HEX, expect: colourOf },
|
|
43
|
+
fog: { line: /FogExp2\(new THREE\.Color\('#d898a0'\), [0-9.]+\)/u, write: (i) => `FogExp2(new THREE.Color('#d898a0'), ${(0.0040 + i * 0.0005).toFixed(4)})` },
|
|
44
|
+
exposure: { line: /world\.post\(\{ tone: 'aces', exposure: [0-9.]+,/u, write: (i) => `world.post({ tone: 'aces', exposure: ${(0.8 + i * 0.06).toFixed(2)},` },
|
|
45
|
+
sun: { line: /key\.position\.set\(-?[0-9.]+, 30, 34\)/u, write: (i) => `key.position.set(${-30 + i * 6}, 30, 34)` },
|
|
46
|
+
ambient: { line: /new THREE\.Color\('#7a6a3c'\), [0-9.]+\)\);/u, write: (i) => `new THREE.Color('#7a6a3c'), ${(0.55 + i * 0.07).toFixed(2)}));` },
|
|
47
|
+
lamp: { line: /new THREE\.PointLight\('#ffa040', [0-9.]+, 6\.5, 1\.4\)/u, write: (i) => `new THREE.PointLight('#ffa040', ${(4 + i * 0.7).toFixed(1)}, 6.5, 1.4)` },
|
|
48
|
+
// AP18: a flat-topped hill (5 m top, 8 m foot) raised under the player at the first camera, a little higher each edit; the
|
|
49
|
+
// page counts once the player's feet stand on its top, and again a second later (they did not fall through)
|
|
50
|
+
hill: { line: /y \+= far \* \(noise\.fbm\(x \* 0\.02 \+ 50, z \* 0\.02 \+ 50, 3\) - 0\.35\) \* 7;(?: y \+= [0-9.]+ \* Math\.min\(1, Math\.max\(0, \(8 - Math\.hypot\(x \+ 3\.9, z \+ 5\.6\)\) \/ 3\)\);)?/u,
|
|
51
|
+
write: (i) => `y += far * (noise.fbm(x * 0.02 + 50, z * 0.02 + 50, 3) - 0.35) * 7; y += ${(0.2 + i * 0.3).toFixed(1)} * Math.min(1, Math.max(0, (8 - Math.hypot(x + 3.9, z + 5.6)) / 3));`,
|
|
52
|
+
read: '() => Math.round(window.__wildshard.world.player.position.y * 20) / 20', expect: (i) => Math.round((0.2 + i * 0.3) * 20) / 20, held: true },
|
|
53
|
+
};
|
|
54
|
+
// AP19: the quest's objective, as the page's quest panel says it once the simulation restarted on the new rows
|
|
55
|
+
EDITS.quest = { line: /objective: 'Walk down to the pond(?: \(\d+\))?'/u, write: (i) => `objective: 'Walk down to the pond (${i})'`,
|
|
56
|
+
read: '() => /walk down to the pond \\(\\d+\\)/iu.exec(document.body.innerText)?.[0].toLowerCase() ?? null', expect: (i) => `walk down to the pond (${i})` };
|
|
57
|
+
const EDIT = EDITS[values.edit ?? 'roof'];
|
|
58
|
+
const FPS = Number(values.fps ?? 60);
|
|
59
|
+
if (EDIT === undefined) throw new Error(`--edit: one of ${Object.keys(EDITS).join(', ')}`);
|
|
60
|
+
|
|
61
|
+
const browser = await chromium.launch({ headless: true, args: ['--use-mock-keychain', '--password-store=basic', '--mute-audio', '--use-angle=metal', '--ignore-gpu-blocklist'] });
|
|
62
|
+
const result = {};
|
|
63
|
+
try {
|
|
64
|
+
const page = await browser.newPage({ viewport: { width: 1280, height: 720 } });
|
|
65
|
+
// engine's probe controls (pose) answer only a harness-pinned page (engine scripts/debug-settings.mjs harnessPins)
|
|
66
|
+
await page.addInitScript({ content: 'window.__wildshardHarness=Object.assign(window.__wildshardHarness??{},{seed:357});' });
|
|
67
|
+
// the lane rule's 60 fps cap: a frame's callbacks run together, at most one frame per 1/FPS s
|
|
68
|
+
if (FPS > 0) await page.addInitScript({ content: `(() => { const raf = window.requestAnimationFrame.bind(window), gap = 1000 / ${FPS} - 1; let at = -1e9;
|
|
69
|
+
window.requestAnimationFrame = (run) => raf(function held(t) { if (t !== at && t - at < gap) { raf(held); return; } at = t; run(t); }); })();` });
|
|
70
|
+
page.on('pageerror', (error) => { console.error(`page error: ${error.message}`); });
|
|
71
|
+
if (values.throttle !== undefined) await (await page.context().newCDPSession(page)).send('Emulation.setCPUThrottlingRate', { rate: Number(values.throttle) });
|
|
72
|
+
await page.goto(`${values.url}${values.url.includes('?') ? '&' : '?'}skipintro`);
|
|
73
|
+
await page.waitForFunction(() => window.__wildshard?.world?.player !== undefined, undefined, { timeout: 180_000, polling: 500 });
|
|
74
|
+
const watched = await page.waitForFunction(() => (window.__wsDevScene?.framedRevision ?? 0) > 0, undefined, { timeout: 30_000, polling: 250 }).then(() => true, () => false);
|
|
75
|
+
console.info(`page ready (${watched ? 'dev scene host live' : 'no dev scene host: a baked shard'})`);
|
|
76
|
+
await page.evaluate(() => {
|
|
77
|
+
const w = window.__wildshard.world;
|
|
78
|
+
if (w.animals) w.animals.calm = true;
|
|
79
|
+
w.game.onLate(() => { for (const child of w.game.camera.children) child.visible = false; if (Math.abs(w.game.camera.fov - 72) > 0.01) { w.game.camera.fov = 72; w.game.camera.updateProjectionMatrix(); } }, 'ap6.fov');
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
if (values.shots === true) {
|
|
83
|
+
for (const [id, x, z, yaw, pitch] of CAMERAS) {
|
|
84
|
+
await page.evaluate(async (pose) => { await window.__wildshard.pose(pose); }, { x, z, yaw, pitch });
|
|
85
|
+
await page.waitForTimeout(2500);
|
|
86
|
+
await page.screenshot({ path: join(OUT, `${PREFIX}${id}.png`) });
|
|
87
|
+
console.info(`shot ${PREFIX}${id}`);
|
|
88
|
+
}
|
|
89
|
+
// the page's own frame clock, counted for 5 s (page code, passed as text: it runs in the browser, not here)
|
|
90
|
+
result.fps = await page.evaluate(`new Promise((done) => { const w = window.__wildshard.world, t0 = Date.now(); let n = 0; const stop = w.game.watchFrames(() => { n++; if (Date.now() - t0 >= 5000) { stop(); done(Math.round(n / ((Date.now() - t0) / 1000))); } }); })`);
|
|
91
|
+
console.info(`fps ${result.fps} (headless, 1280x720, 5 s at the last camera)`);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
if (values.draws === true) {
|
|
95
|
+
// median of 20 drawn frames' whole-frame draw count (the composer's passes included)
|
|
96
|
+
const sample = `new Promise((done) => { const g = window.__wildshard.world.game, seen = []; const stop = g.watchFrames(() => { seen.push(g.lastFrame.calls); if (seen.length >= 20) { stop(); seen.sort((a, b) => a - b); done(seen[10]); } }); })`;
|
|
97
|
+
result.draws = [];
|
|
98
|
+
for (const [id, x, z, yaw, pitch] of CAMERAS) {
|
|
99
|
+
await page.evaluate(async (pose) => { await window.__wildshard.pose(pose); }, { x, z, yaw, pitch });
|
|
100
|
+
await page.waitForTimeout(2500);
|
|
101
|
+
const total = await page.evaluate(sample);
|
|
102
|
+
await page.evaluate(() => { const s = window.__wildshard.world.game.renderer.shadowMap; s.autoUpdate = false; s.needsUpdate = false; });
|
|
103
|
+
const view = await page.evaluate(sample);
|
|
104
|
+
await page.evaluate(() => { window.__wildshard.world.game.renderer.shadowMap.autoUpdate = true; });
|
|
105
|
+
result.draws.push({ id, total, view, shadow: total - view });
|
|
106
|
+
console.info(`draws ${id}: ${total} (view ${view}, shadow ${total - view})`);
|
|
107
|
+
}
|
|
108
|
+
result.materials = await page.evaluate(() => { const seen = new Set(); window.__wildshard.world.game.rootScene.traverse((o) => { if (o.isMesh && o.visible) for (const m of [o.material].flat()) seen.add(m.uuid); }); return seen.size; });
|
|
109
|
+
console.info(`${result.materials} distinct mesh materials in the scene`);
|
|
110
|
+
result.fps = await page.evaluate(`new Promise((done) => { const w = window.__wildshard.world, t0 = Date.now(); let n = 0; const stop = w.game.watchFrames(() => { n++; if (Date.now() - t0 >= 5000) { stop(); done(Math.round(n / ((Date.now() - t0) / 1000))); } }); })`);
|
|
111
|
+
console.info(`fps ${result.fps} (headless, 5 s at the last camera)`);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
if (values.motion === true) {
|
|
115
|
+
const yard = CAMERAS.find(([id]) => id === 'yard-brazier') ?? CAMERAS[0];
|
|
116
|
+
await page.evaluate(async (pose) => { await window.__wildshard.pose(pose); }, { x: yard[1], z: yard[2], yaw: yard[3], pitch: yard[4] });
|
|
117
|
+
await page.waitForTimeout(2500);
|
|
118
|
+
// regions at 1280x720: the fire's cards, the fern at the left edge, and still ground beside them (the control)
|
|
119
|
+
const regions = { flame: [560, 250, 160, 170], fern: [0, 500, 100, 220], still: [880, 560, 160, 100] };
|
|
120
|
+
const { default: sharp } = await import('sharp');
|
|
121
|
+
const crop = (png, [left, top, width, height]) => sharp(png).extract({ left, top, width, height }).raw().toBuffer();
|
|
122
|
+
const lamps = () => { const out = []; window.__wildshard.world.game.rootScene.traverse((o) => { if (o.isPointLight && o.intensity > 0) out.push(o.intensity); }); return out; };
|
|
123
|
+
const frames = [];
|
|
124
|
+
for (let i = 0; i < 4; i++) { frames.push({ png: await page.screenshot(), lamps: await page.evaluate(`(${lamps.toString()})()`) }); await page.waitForTimeout(200); }
|
|
125
|
+
result.motion = {};
|
|
126
|
+
for (const [name, box] of Object.entries(regions)) {
|
|
127
|
+
let sum = 0, n = 0;
|
|
128
|
+
for (let i = 1; i < frames.length; i++) {
|
|
129
|
+
const a = await crop(frames[i - 1].png, box), b = await crop(frames[i].png, box);
|
|
130
|
+
for (let k = 0; k < a.length; k++) sum += Math.abs(a[k] - b[k]);
|
|
131
|
+
n += a.length;
|
|
132
|
+
}
|
|
133
|
+
result.motion[name] = Number((sum / n).toFixed(2));
|
|
134
|
+
}
|
|
135
|
+
const first = frames[0].lamps, changed = frames.slice(1).some((f) => f.lamps.some((v, k) => Math.abs(v - (first[k] ?? v)) > 1e-4));
|
|
136
|
+
result.motion.lamps = { count: first.length, changed };
|
|
137
|
+
result.motion.shardCode = await page.evaluate(() => Object.keys(globalThis).filter((k) => /^__wsShard|shardModule/u.test(k)));
|
|
138
|
+
await page.screenshot({ path: join(OUT, `${PREFIX}motion.png`) });
|
|
139
|
+
// AP11: the bloom catches the fire: the glow round it with the page's bloom on, less with it set to 0 for a frame
|
|
140
|
+
const ring = [520, 200, 240, 300];
|
|
141
|
+
const mean = async (png) => { const px = await crop(png, ring); let t = 0; for (const v of px) t += v; return t / px.length; };
|
|
142
|
+
const bloomOn = await page.evaluate(() => window.__wildshard.world.game.post?.bloom?.intensity ?? null);
|
|
143
|
+
if (bloomOn !== null && bloomOn > 0) {
|
|
144
|
+
const lit = await mean(await page.screenshot());
|
|
145
|
+
await page.evaluate(() => { window.__wildshard.world.game.post.bloom.intensity = 0; });
|
|
146
|
+
await page.waitForTimeout(300);
|
|
147
|
+
const dark = await mean(await page.screenshot());
|
|
148
|
+
await page.evaluate((v) => { window.__wildshard.world.game.post.bloom.intensity = v; }, bloomOn);
|
|
149
|
+
result.motion.bloom = { intensity: bloomOn, glow: Number((lit - dark).toFixed(2)) };
|
|
150
|
+
} else result.motion.bloom = { intensity: bloomOn, glow: 0 };
|
|
151
|
+
console.info(`bloom ${JSON.stringify(result.motion.bloom)} (mean of 255 round the fire, on minus off)`);
|
|
152
|
+
console.info(`motion: flame ${result.motion.flame}, fern ${result.motion.fern}, still ${result.motion.still} (mean |frame step| of 255), ${first.length} lamps lit, intensities change: ${changed}`);
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
if (values.time !== undefined) {
|
|
156
|
+
if (!watched) throw new Error('--time needs a `wildshard watch` page');
|
|
157
|
+
const file = resolve(values.time), original = readFileSync(file, 'utf8');
|
|
158
|
+
if (!EDIT.line.test(original)) throw new Error(`--time: ${file} has no ${values.edit ?? 'roof'} line to edit`);
|
|
159
|
+
await page.evaluate(async (pose) => { await window.__wildshard.pose(pose); window.__ap6Marker = 'same page'; }, { x: CAMERAS[0][1], z: CAMERAS[0][2], yaw: CAMERAS[0][3], pitch: CAMERAS[0][4] });
|
|
160
|
+
await page.waitForTimeout(2000);
|
|
161
|
+
const runs = [];
|
|
162
|
+
try {
|
|
163
|
+
for (let i = 0; i < RUNS; i++) {
|
|
164
|
+
// the first edit's value is a change from the file's own (i = 0 may equal it), so count from 1
|
|
165
|
+
const value = i + 1, written = EDIT.write(value);
|
|
166
|
+
if (EDIT.line.exec(readFileSync(file, 'utf8'))?.[0] === written) throw new Error(`--time: edit ${value} writes the line as it is`);
|
|
167
|
+
const before = await page.evaluate(() => ({ revision: window.__wsDevScene.framedRevision, frames: window.__wsDevScene.frames, at: window.__wildshard.world.player.position.toArray() }));
|
|
168
|
+
const at = Date.now();
|
|
169
|
+
writeFileSync(file, original.replace(EDIT.line, written));
|
|
170
|
+
const handle = await page.waitForFunction(([revision, expected, read]) => {
|
|
171
|
+
const report = window.__wsDevScene;
|
|
172
|
+
if (report.framedRevision <= revision) return false;
|
|
173
|
+
// eslint-disable-next-line no-new-func -- the reader is passed in as text
|
|
174
|
+
return read === null || new Function(`return (${read})()`)() === expected ? report.framedAt : false;
|
|
175
|
+
}, [before.revision, EDIT.expect?.(value) ?? null, EDIT.read ?? null], { timeout: 30_000, polling: 'raf' });
|
|
176
|
+
const framedAt = await handle.jsonValue();
|
|
177
|
+
const after = await page.evaluate(() => ({ frames: window.__wsDevScene.frames, at: window.__wildshard.world.player.position.toArray(), marker: window.__ap6Marker, kind: window.__wsDevScene.kind ?? null, restart: window.__wsDevScene.restart ?? null, steps: { ...window.__wsDevScene.steps } }));
|
|
178
|
+
const moved = Math.hypot(...after.at.map((v, k) => v - before.at[k]));
|
|
179
|
+
// the page's own steps, from the file write: its state received, its parts fetched, swapped in, the first frame after
|
|
180
|
+
const steps = after.steps === undefined ? null : { seen: after.steps.seen - at, sent: after.steps.sent - at, received: after.steps.received - at, fetched: after.steps.fetched - at, swapped: after.steps.swapped - at, framed: framedAt - at };
|
|
181
|
+
// a ground edit: still standing on it a second later
|
|
182
|
+
let held = null;
|
|
183
|
+
if (EDIT.held === true) { await page.waitForTimeout(1000); held = await page.evaluate(`(${EDIT.read})()`) === EDIT.expect(value); }
|
|
184
|
+
runs.push({ value: written, ms: framedAt - at, frames: after.frames - before.frames, moved: Number(moved.toFixed(4)), reloaded: after.marker !== 'same page', kind: after.kind, steps, ...(after.kind === 'gameplay' ? { restart: after.restart } : {}), ...(held === null ? {} : { held }) });
|
|
185
|
+
console.info(`edit ${value}: ${written} on screen in ${framedAt - at} ms${after.kind === null ? '' : ` (${after.kind})`}${after.kind === 'gameplay' && after.restart !== null ? ` [server restart ${after.restart.serverMs} ms, quest views ${after.restart.questsMs} ms]` : ''}${steps === null ? '' : ` [seen ${steps.seen}, sent ${steps.sent}, received ${steps.received}, fetched ${steps.fetched}, swapped ${steps.swapped}]`}`);
|
|
186
|
+
await page.waitForTimeout(400);
|
|
187
|
+
}
|
|
188
|
+
} finally { writeFileSync(file, original); }
|
|
189
|
+
const sorted = runs.map((r) => r.ms).sort((a, b) => a - b), median = sorted.length % 2 === 1 ? sorted[(sorted.length - 1) / 2] : (sorted[sorted.length / 2 - 1] + sorted[sorted.length / 2]) / 2;
|
|
190
|
+
result.timing = { edit: values.edit ?? 'roof', runs, median, min: sorted[0], max: sorted.at(-1), reloads: runs.filter((r) => r.reloaded).length, maxMoved: Math.max(...runs.map((r) => r.moved)), frameLoopStopped: runs.some((r) => r.frames <= 0),
|
|
191
|
+
...(EDIT.held === true ? { stood: runs.filter((r) => r.held === true).length } : {}) };
|
|
192
|
+
await page.waitForTimeout(3000);
|
|
193
|
+
await page.screenshot({ path: join(OUT, `${PREFIX}timing-last.png`) });
|
|
194
|
+
console.info(`median ${median} ms (min ${sorted[0]}, max ${sorted.at(-1)}), reloads ${result.timing.reloads}, player moved ≤ ${result.timing.maxMoved} m${result.timing.stood === undefined ? '' : `, still on the hill 1 s later in ${result.timing.stood} of ${runs.length}`}`);
|
|
195
|
+
}
|
|
196
|
+
} finally {
|
|
197
|
+
await browser.close();
|
|
198
|
+
writeFileSync(join(OUT, `${PREFIX}proof.json`), `${JSON.stringify(result, null, 2)}\n`);
|
|
199
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// oxlint-disable-next-line import/no-nodejs-modules -- The handshake's accept key is a SHA-1 of the client's key.
|
|
2
|
+
import { createHash } from 'node:crypto';
|
|
3
|
+
// oxlint-disable-next-line import/no-nodejs-modules -- The watch server upgrades its own HTTP requests.
|
|
4
|
+
import type { IncomingMessage } from 'node:http';
|
|
5
|
+
// oxlint-disable-next-line import/no-nodejs-modules -- An upgraded request hands over its raw socket.
|
|
6
|
+
import type { Duplex } from 'node:stream';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* SHARD-SOURCE AP5: the watch server's WebSocket, server to page only (RFC 6455, text frames out; the page sends nothing
|
|
10
|
+
* but a close or a pong). The page script is the only client, on 127.0.0.1, so this is the handshake, one frame writer and
|
|
11
|
+
* a reader that answers a close and a ping: no extensions, no fragmentation, no dependency.
|
|
12
|
+
*/
|
|
13
|
+
export interface WatchSocket { send: (text: string) => void; close: () => void; readonly closed: () => boolean }
|
|
14
|
+
|
|
15
|
+
const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
|
|
16
|
+
|
|
17
|
+
function frame(opcode: number, payload: Buffer): Buffer {
|
|
18
|
+
const length = payload.length, head = length < 126 ? Buffer.alloc(2) : length < 65_536 ? Buffer.alloc(4) : Buffer.alloc(10);
|
|
19
|
+
head[0] = 0x80 | opcode;
|
|
20
|
+
if (length < 126) head[1] = length;
|
|
21
|
+
else if (length < 65_536) { head[1] = 126; head.writeUInt16BE(length, 2); }
|
|
22
|
+
else { head[1] = 127; head.writeBigUInt64BE(BigInt(length), 2); }
|
|
23
|
+
return Buffer.concat([head, payload]);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** Answer an upgrade request; null (and a 400) when it isn't a WebSocket handshake. */
|
|
27
|
+
export function acceptSocket(request: IncomingMessage, socket: Duplex, onClose: () => void): WatchSocket | null {
|
|
28
|
+
const key = request.headers['sec-websocket-key'];
|
|
29
|
+
if (typeof key !== 'string' || request.headers.upgrade?.toLowerCase() !== 'websocket') { socket.end('HTTP/1.1 400 Bad Request\r\n\r\n'); return null; }
|
|
30
|
+
const accept = createHash('sha1').update(`${key}${GUID}`).digest('base64');
|
|
31
|
+
socket.write(`HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\nSec-WebSocket-Accept: ${accept}\r\n\r\n`);
|
|
32
|
+
let closed = false, pending = Buffer.alloc(0);
|
|
33
|
+
const end = (): void => { if (closed) return; closed = true; socket.end(); onClose(); };
|
|
34
|
+
socket.on('data', (chunk: Buffer) => {
|
|
35
|
+
pending = Buffer.concat([pending, chunk]);
|
|
36
|
+
while (pending.length >= 2) {
|
|
37
|
+
const opcode = (pending[0] ?? 0) & 0x0f, masked = ((pending[1] ?? 0) & 0x80) !== 0;
|
|
38
|
+
let length = (pending[1] ?? 0) & 0x7f, offset = 2;
|
|
39
|
+
if (length === 126) { if (pending.length < 4) return; length = pending.readUInt16BE(2); offset = 4; }
|
|
40
|
+
else if (length === 127) { if (pending.length < 10) return; length = Number(pending.readBigUInt64BE(2)); offset = 10; }
|
|
41
|
+
const mask = masked ? pending.subarray(offset, offset + 4) : null; if (masked) offset += 4;
|
|
42
|
+
if (pending.length < offset + length) return;
|
|
43
|
+
const payload = Buffer.from(pending.subarray(offset, offset + length));
|
|
44
|
+
if (mask !== null) for (let i = 0; i < payload.length; i++) payload[i] = (payload[i] ?? 0) ^ (mask[i % 4] ?? 0);
|
|
45
|
+
pending = pending.subarray(offset + length);
|
|
46
|
+
if (opcode === 0x8) { if (!closed) socket.write(frame(0x8, Buffer.alloc(0))); end(); return; }
|
|
47
|
+
if (opcode === 0x9 && !closed) socket.write(frame(0xa, payload));
|
|
48
|
+
}
|
|
49
|
+
});
|
|
50
|
+
socket.on('close', end);
|
|
51
|
+
socket.on('error', () => { end(); socket.destroy(); });
|
|
52
|
+
return {
|
|
53
|
+
send: (text) => { if (!closed) socket.write(frame(0x1, Buffer.from(text, 'utf8'))); },
|
|
54
|
+
close: () => { if (!closed) socket.write(frame(0x8, Buffer.alloc(0))); end(); },
|
|
55
|
+
closed: () => closed,
|
|
56
|
+
};
|
|
57
|
+
}
|