castle-web-cli 0.4.236 → 0.4.238
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/dist/api.d.ts +2 -0
- package/dist/bundle.d.ts +24 -0
- package/dist/bundle.js +447 -4
- package/dist/bundleLatin1.d.ts +6 -0
- package/dist/bundleLatin1.js +333 -0
- package/dist/castle-host/host.d.ts +10 -1
- package/dist/castle-host/host.js +78 -9
- package/dist/castleJson.d.ts +20 -0
- package/dist/castleJson.js +40 -0
- package/dist/deckExports.d.ts +35 -0
- package/dist/deckExports.js +365 -0
- package/dist/importCheckHook.d.ts +1 -0
- package/dist/importCheckHook.js +1 -1
- package/dist/index.js +5 -0
- package/dist/init.js +2 -1
- package/dist/save-deck.js +18 -13
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +47 -0
- package/kits/base/sdk/castle.d.ts +3 -1
- package/kits/base/sdk/castle.js +1 -0
- package/kits/base/sdk/commands.d.ts +25 -1
- package/kits/base/sdk/commands.js +29 -1
- package/kits/base/sdk/hub.d.ts +17 -0
- package/kits/base/sdk/hub.js +33 -9
- package/kits/base/sdk/localCache.d.ts +27 -0
- package/kits/base/sdk/localCache.js +115 -0
- package/kits/base/sdk/localCacheStore.d.ts +15 -0
- package/kits/base/sdk/localCacheStore.js +358 -0
- package/kits/base/sdk/transport.d.ts +1 -0
- package/kits/base/sdk/transport.js +4 -5
- package/kits/hub-game/CLAUDE.md +22 -2
- package/kits/hub-game/castle.json +4 -1
- package/kits/hub-game/code/client/act.js +66 -91
- package/kits/hub-game/code/client/actCore.js +134 -0
- package/kits/hub-game/code/client/car.js +35 -0
- package/kits/hub-game/code/client/chrome.js +207 -381
- package/kits/hub-game/code/client/crowdNames.js +2 -2
- package/kits/hub-game/code/client/emoteWheel.js +109 -0
- package/kits/hub-game/code/client/hats.js +2 -0
- package/kits/hub-game/code/client/hookLayer.js +99 -48
- package/kits/hub-game/code/client/hostGo.js +77 -0
- package/kits/hub-game/code/client/hubControls.js +125 -0
- package/kits/hub-game/code/client/hubEntry.js +187 -0
- package/kits/hub-game/code/client/hudSurface.js +148 -0
- package/kits/hub-game/code/client/hudTree.js +96 -0
- package/kits/hub-game/code/client/idle.js +59 -13
- package/kits/hub-game/code/client/invites.js +13 -4
- package/kits/hub-game/code/client/menuIcons.js +8 -0
- package/kits/hub-game/code/client/noTrips.js +38 -0
- package/kits/hub-game/code/client/qualityEntry.js +6 -1
- package/kits/hub-game/code/client/rehello.js +3 -1
- package/kits/hub-game/code/client/riders.js +26 -0
- package/kits/hub-game/code/client/role.js +79 -0
- package/kits/hub-game/code/client/safeLayout.js +32 -3
- package/kits/hub-game/code/client/sound.js +10 -3
- package/kits/hub-game/code/client/soundscape.js +2 -2
- package/kits/hub-game/code/client/soundscapeAmbience.js +38 -8
- package/kits/hub-game/code/client/soundscapeBaked.js +24 -5
- package/kits/hub-game/code/client/soundscapeCues.js +2 -1
- package/kits/hub-game/code/client/state.js +19 -0
- package/kits/hub-game/code/client/stuck.js +2 -1
- package/kits/hub-game/code/client/talkSurface.js +178 -0
- package/kits/hub-game/code/client/talkTree.js +238 -0
- package/kits/hub-game/code/client/tiers.js +8 -5
- package/kits/hub-game/code/client/uiDom.js +600 -0
- package/kits/hub-game/code/client/uiTree.js +359 -0
- package/kits/hub-game/code/client/vehicle.js +154 -0
- package/kits/hub-game/code/client/wear.js +27 -5
- package/kits/hub-game/code/client/worldLabels.js +3 -2
- package/kits/hub-game/code/client/yours.js +10 -3
- package/kits/hub-game/code/server/actors.js +4 -3
- package/kits/hub-game/code/server/analytics.js +56 -6
- package/kits/hub-game/code/server/decor.js +56 -16
- package/kits/hub-game/code/server/hub.js +258 -46
- package/kits/hub-game/code/server/idle.js +118 -5
- package/kits/hub-game/code/server/manifest.js +46 -4
- package/kits/hub-game/code/server/npcs.js +4 -2
- package/kits/hub-game/code/server/players.js +3 -0
- package/kits/hub-game/code/server/role.js +142 -0
- package/kits/hub-game/code/server/standing.js +6 -4
- package/kits/hub-game/code/server/vehicle.js +126 -0
- package/kits/hub-game/code/shared/car.js +52 -0
- package/kits/hub-game/code/shared/deckFlags.js +34 -0
- package/kits/hub-game/code/shared/deviceClass.js +39 -0
- package/kits/hub-game/code/shared/expression.js +9 -0
- package/kits/hub-game/code/systems/hub.js +300 -85
- package/kits/hub-game/docs/analytics.md +11 -2
- package/kits/hub-game/docs/contract.md +353 -14
- package/kits/hub-game/docs/vehicle-preset.md +132 -0
- package/kits/hub-game/models/hats/baker-cap.pxmodel +89 -0
- package/kits/hub-game/models/hats/chef-toque.pxmodel +60 -0
- package/kits/hub-game/models/hats/delivery-cap.pxmodel +105 -0
- package/kits/hub-game/models/hats/fire-helmet.pxmodel +87 -0
- package/kits/hub-game/models/hats/hard-hat.pxmodel +71 -0
- package/kits/hub-game/models/hats/nurse-cap.pxmodel +61 -0
- package/kits/hub-game/models/hats/police-cap.pxmodel +105 -0
- package/kits/hub-game/models/hats/teacher-beret.pxmodel +52 -0
- package/kits/hub-game/models/role/square/top-apron.pxmodel +109 -0
- package/kits/hub-game/models/role/square/top-cardigan.pxmodel +141 -0
- package/kits/hub-game/models/role/square/top-coat.pxmodel +157 -0
- package/kits/hub-game/models/role/square/top-scrubs.pxmodel +93 -0
- package/kits/hub-game/models/role/square/top-tabard.pxmodel +109 -0
- package/kits/hub-game/models/role/square/top-vest.pxmodel +109 -0
- package/kits/hub-game/models/role/tool-bag.pxmodel +75 -0
- package/kits/hub-game/models/role/tool-bell.pxmodel +71 -0
- package/kits/hub-game/models/role/tool-hose.pxmodel +60 -0
- package/kits/hub-game/models/role/tool-parcel.pxmodel +61 -0
- package/kits/hub-game/models/role/tool-torch.pxmodel +55 -0
- package/kits/hub-game/models/role/tool-tray.pxmodel +75 -0
- package/kits/hub-game/models/role/top-apron.pxmodel +70 -0
- package/kits/hub-game/models/role/top-cardigan.pxmodel +102 -0
- package/kits/hub-game/models/role/top-coat.pxmodel +79 -0
- package/kits/hub-game/models/role/top-scrubs.pxmodel +54 -0
- package/kits/hub-game/models/role/top-tabard.pxmodel +70 -0
- package/kits/hub-game/models/role/top-vest.pxmodel +70 -0
- package/kits/hub-game/package-lock.json +1 -1
- package/kits/hub-game/package.json +1 -1
- package/kits/hub-game/scripts/check.mjs +7 -4
- package/kits/hub-game/scripts/fixtures/car-vectors.json +279 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +2 -1
- package/kits/hub-game/scripts/fixtures/hud-surface.json +670 -0
- package/kits/hub-game/scripts/fixtures/talk-surface.json +3930 -0
- package/kits/hub-game/scripts/gen-hats.mjs +46 -2
- package/kits/hub-game/scripts/gen-role.mjs +80 -0
- package/kits/hub-game/scripts/test-act-core.mjs +167 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +34 -0
- package/kits/hub-game/scripts/test-actors.mjs +48 -0
- package/kits/hub-game/scripts/test-analytics.mjs +99 -5
- package/kits/hub-game/scripts/test-apply-deck.mjs +122 -0
- package/kits/hub-game/scripts/test-back-visibility.mjs +3 -1
- package/kits/hub-game/scripts/test-ballot.mjs +2 -0
- package/kits/hub-game/scripts/test-car.mjs +43 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +2 -1
- package/kits/hub-game/scripts/test-decor.mjs +77 -0
- package/kits/hub-game/scripts/test-device-class.mjs +83 -0
- package/kits/hub-game/scripts/test-emote-wheel.mjs +374 -0
- package/kits/hub-game/scripts/test-hats.mjs +5 -4
- package/kits/hub-game/scripts/test-host-go.mjs +265 -0
- package/kits/hub-game/scripts/test-hub-controls.mjs +108 -0
- package/kits/hub-game/scripts/test-hub-entry.mjs +531 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +75 -0
- package/kits/hub-game/scripts/test-hub-trip.mjs +85 -0
- package/kits/hub-game/scripts/test-hud-clear.mjs +12 -2
- package/kits/hub-game/scripts/test-hud-rate.mjs +6 -2
- package/kits/hub-game/scripts/test-hud-surface.mjs +272 -0
- package/kits/hub-game/scripts/test-idle.mjs +347 -1
- package/kits/hub-game/scripts/test-interest-cells.mjs +8 -1
- package/kits/hub-game/scripts/test-invites-client.mjs +42 -1
- package/kits/hub-game/scripts/test-manifest.mjs +30 -0
- package/kits/hub-game/scripts/test-no-trips.mjs +42 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
- package/kits/hub-game/scripts/test-quality.mjs +13 -0
- package/kits/hub-game/scripts/test-rehello.mjs +258 -3
- package/kits/hub-game/scripts/test-resume-pose-server.mjs +203 -0
- package/kits/hub-game/scripts/test-resync.mjs +183 -0
- package/kits/hub-game/scripts/test-role-client.mjs +421 -0
- package/kits/hub-game/scripts/test-role.mjs +350 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +50 -1
- package/kits/hub-game/scripts/test-soundscape.mjs +124 -7
- package/kits/hub-game/scripts/test-standing.mjs +15 -1
- package/kits/hub-game/scripts/test-talk-surface.mjs +296 -0
- package/kits/hub-game/scripts/test-tiers.mjs +13 -0
- package/kits/hub-game/scripts/test-ui-dom-dom.mjs +96 -0
- package/kits/hub-game/scripts/test-ui-tree.mjs +711 -0
- package/kits/hub-game/scripts/test-vehicle-client.mjs +159 -0
- package/kits/hub-game/scripts/test-vehicle.mjs +135 -0
- package/kits/hub-game/scripts/test-yours.mjs +33 -0
- package/kits/hub-game/tools/hubScene/export.mjs +613 -0
- package/kits/hub-game/tools/hubScene/hubdata.mjs +921 -0
- package/kits/hub-game/tools/hubScene/merge-root.mjs +39 -0
- package/kits/hub-game/tools/hubScene/nodeworld.mjs +227 -0
- package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +798 -0
- package/kits/hub-game/tools/hubScene/test/fixture.json +637 -0
- package/kits/hub-game/tools/hubScene/test/paint-export.mjs +40 -0
- package/kits/hub-game/tools/hubScene/test/upload.test.mjs +655 -0
- package/kits/hub-game/tools/hubScene/upload.mjs +636 -0
- package/kits/hub-game/tools/hubScene/validate-manifest.mjs +291 -0
- package/kits/multiplayer-3d/castle.json +4 -4
- package/kits/multiplayer-3d/code/client/resumeGate.js +30 -2
- package/kits/multiplayer-3d/code/client/steer.js +3 -1
- package/kits/multiplayer-3d/code/systems/multiplayer.js +30 -2
- package/kits/multiplayer-3d/package-lock.json +1 -1
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +74 -2
- package/kits/physics-3d/CLAUDE.md +1 -1
- package/kits/physics-3d/behaviors/Player.jsx +37 -27
- package/kits/physics-3d/castle.json +2 -2
- package/kits/physics-3d/docs/engine-geometry-memory.md +23 -0
- package/kits/physics-3d/engine3d/memoryprofile.js +17 -0
- package/kits/physics-3d/engine3d/playerRun.js +6 -1
- package/kits/physics-3d/engine3d/pxmodel.js +6 -1
- package/kits/physics-3d/engine3d/world3d.js +6 -3
- package/kits/physics-3d/package.json +1 -1
- package/kits/physics-3d/play/behaviors/Player.js +40 -28
- package/kits/physics-3d/scripts/test-memory-profile.mjs +237 -0
- package/kits/physics-3d/systems/physics3d.js +5 -2
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/messages.js +5 -0
- package/kits/real-time/code/server/session.js +28 -1
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +5 -4
- package/vendor/three/LICENSE +21 -0
- package/vendor/three/build/three.core.js +58773 -0
- package/vendor/three/build/three.module.js +18251 -0
- package/vendor/three/examples/jsm/controls/OrbitControls.js +1860 -0
- package/vendor/three/examples/jsm/controls/TransformControls.js +1918 -0
- package/vendor/three/examples/jsm/exporters/GLTFExporter.js +3595 -0
- package/vendor/three/examples/jsm/geometries/RoundedBoxGeometry.js +216 -0
- package/vendor/three/examples/jsm/math/MeshSurfaceSampler.js +315 -0
- package/vendor/three/examples/jsm/postprocessing/EffectComposer.js +363 -0
- package/vendor/three/examples/jsm/postprocessing/MaskPass.js +195 -0
- package/vendor/three/examples/jsm/postprocessing/OutputPass.js +139 -0
- package/vendor/three/examples/jsm/postprocessing/Pass.js +191 -0
- package/vendor/three/examples/jsm/postprocessing/RenderPass.js +183 -0
- package/vendor/three/examples/jsm/postprocessing/ShaderPass.js +135 -0
- package/vendor/three/examples/jsm/shaders/CopyShader.js +52 -0
- package/vendor/three/examples/jsm/shaders/OutputShader.js +103 -0
- package/vendor/three/examples/jsm/utils/BufferGeometryUtils.js +1435 -0
- package/vendor/three/package.json +134 -0
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
// An IndexedDB store for LocalCache entries, with least-recently-used eviction
|
|
2
|
+
// over a budget for each namespace and one for the whole store. The SDK opens
|
|
3
|
+
// it in a deck's own origin (mobile, the dev serve), where there is one
|
|
4
|
+
// namespace; castle-www opens it in castle.xyz's origin for every deck it
|
|
5
|
+
// hosts, so there the namespace is the deck id.
|
|
6
|
+
//
|
|
7
|
+
// No imports: host repos vendor the built file as it is
|
|
8
|
+
// (scripts/copy-host-module.mjs).
|
|
9
|
+
export const LOCAL_CACHE_DATABASE_NAME = "castle-local-cache";
|
|
10
|
+
export const LOCAL_CACHE_DECK_BUDGET_BYTES = 20 * 1024 * 1024;
|
|
11
|
+
export const LOCAL_CACHE_TOTAL_BUDGET_BYTES = 300 * 1024 * 1024;
|
|
12
|
+
const DATABASE_VERSION = 3;
|
|
13
|
+
const VALUES = "values";
|
|
14
|
+
const ENTRIES = "entries";
|
|
15
|
+
const META = "meta";
|
|
16
|
+
const ACCESSED = "accessed";
|
|
17
|
+
const NAMESPACE_ACCESSED = "namespaceAccessed";
|
|
18
|
+
// The `meta` record holding the charged total of every entry, so a write
|
|
19
|
+
// changes the total without reading the other records. Each namespace's total
|
|
20
|
+
// is kept the same way, under namespaceTotalKey.
|
|
21
|
+
const TOTAL = "total";
|
|
22
|
+
// The fixed part of an entry's charge, for its two records. The namespace and
|
|
23
|
+
// key are charged too, at two bytes a character for each of the two places
|
|
24
|
+
// they are stored.
|
|
25
|
+
const RECORD_BYTES = 256;
|
|
26
|
+
// Access times from reads are written in one batch shortly after, so reads run
|
|
27
|
+
// in read-only transactions and do not queue behind each other. Each keeps the
|
|
28
|
+
// time of its read.
|
|
29
|
+
const TOUCH_DELAY_MS = 50;
|
|
30
|
+
export function openLocalCacheStore(options = {}) {
|
|
31
|
+
const databaseName = options.databaseName ?? LOCAL_CACHE_DATABASE_NAME;
|
|
32
|
+
const budgets = {
|
|
33
|
+
deck: options.deckBudgetBytes ?? LOCAL_CACHE_DECK_BUDGET_BYTES,
|
|
34
|
+
total: options.totalBudgetBytes ?? LOCAL_CACHE_TOTAL_BUDGET_BYTES,
|
|
35
|
+
};
|
|
36
|
+
let database = null;
|
|
37
|
+
const touched = new Map();
|
|
38
|
+
let touchTimer = null;
|
|
39
|
+
// A connection that closes or fails to open is dropped, and the next call
|
|
40
|
+
// opens a new one.
|
|
41
|
+
const open = () => {
|
|
42
|
+
if (database) {
|
|
43
|
+
return database;
|
|
44
|
+
}
|
|
45
|
+
const opening = openDatabase(databaseName, () => {
|
|
46
|
+
if (database === opening) {
|
|
47
|
+
database = null;
|
|
48
|
+
}
|
|
49
|
+
}).catch((error) => {
|
|
50
|
+
if (database === opening) {
|
|
51
|
+
database = null;
|
|
52
|
+
}
|
|
53
|
+
throw error;
|
|
54
|
+
});
|
|
55
|
+
database = opening;
|
|
56
|
+
return opening;
|
|
57
|
+
};
|
|
58
|
+
const flushTouches = async () => {
|
|
59
|
+
touchTimer = null;
|
|
60
|
+
const touches = Array.from(touched.values());
|
|
61
|
+
touched.clear();
|
|
62
|
+
await touchEntries(await open(), touches);
|
|
63
|
+
};
|
|
64
|
+
const touch = (id) => {
|
|
65
|
+
touched.set(JSON.stringify(id), { id, accessed: Date.now() });
|
|
66
|
+
touchTimer ??= setTimeout(() => {
|
|
67
|
+
flushTouches().catch(() => undefined);
|
|
68
|
+
}, TOUCH_DELAY_MS);
|
|
69
|
+
};
|
|
70
|
+
return {
|
|
71
|
+
async get(namespace, key) {
|
|
72
|
+
const id = [namespace, key];
|
|
73
|
+
const value = await readValue(await open(), id);
|
|
74
|
+
if (value !== null) {
|
|
75
|
+
touch(id);
|
|
76
|
+
}
|
|
77
|
+
return value;
|
|
78
|
+
},
|
|
79
|
+
async set(namespace, key, value) {
|
|
80
|
+
const id = [namespace, key];
|
|
81
|
+
touched.delete(JSON.stringify(id));
|
|
82
|
+
const write = { id, value, charge: chargeOf(id, value) };
|
|
83
|
+
const freeBytes = await originFreeBytes();
|
|
84
|
+
await writeValue(await open(), write, budgets, freeBytes);
|
|
85
|
+
},
|
|
86
|
+
async remove(namespace, key) {
|
|
87
|
+
const id = [namespace, key];
|
|
88
|
+
touched.delete(JSON.stringify(id));
|
|
89
|
+
await removeValue(await open(), id);
|
|
90
|
+
},
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
function openDatabase(name, onClosed) {
|
|
94
|
+
return new Promise((resolve, reject) => {
|
|
95
|
+
if (typeof indexedDB === "undefined") {
|
|
96
|
+
reject(new Error("IndexedDB is unavailable."));
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
let blocked = false;
|
|
100
|
+
const request = indexedDB.open(name, DATABASE_VERSION);
|
|
101
|
+
request.onupgradeneeded = () => createStores(request.result);
|
|
102
|
+
request.onsuccess = () => {
|
|
103
|
+
const database = request.result;
|
|
104
|
+
// A blocked open has already failed its callers. The connection it gets
|
|
105
|
+
// once the other tab lets go is closed, and the next call opens again.
|
|
106
|
+
if (blocked) {
|
|
107
|
+
database.close();
|
|
108
|
+
return;
|
|
109
|
+
}
|
|
110
|
+
// Another tab opening a later version, or deleting the database, waits
|
|
111
|
+
// until this connection closes.
|
|
112
|
+
database.onversionchange = () => {
|
|
113
|
+
database.close();
|
|
114
|
+
onClosed();
|
|
115
|
+
};
|
|
116
|
+
// The browser closes a connection itself when it clears site data.
|
|
117
|
+
database.onclose = onClosed;
|
|
118
|
+
resolve(database);
|
|
119
|
+
};
|
|
120
|
+
request.onerror = () => reject(request.error ?? new Error("IndexedDB open failed."));
|
|
121
|
+
request.onblocked = () => {
|
|
122
|
+
blocked = true;
|
|
123
|
+
reject(new Error("IndexedDB open was blocked."));
|
|
124
|
+
};
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
// Older versions kept no totals for each namespace, so an older database
|
|
128
|
+
// starts empty, which a cache allows.
|
|
129
|
+
function createStores(database) {
|
|
130
|
+
for (const name of Array.from(database.objectStoreNames)) {
|
|
131
|
+
database.deleteObjectStore(name);
|
|
132
|
+
}
|
|
133
|
+
database.createObjectStore(VALUES);
|
|
134
|
+
const entries = database.createObjectStore(ENTRIES, { keyPath: ["namespace", "key"] });
|
|
135
|
+
entries.createIndex(ACCESSED, "accessed");
|
|
136
|
+
entries.createIndex(NAMESPACE_ACCESSED, ["namespace", "accessed"]);
|
|
137
|
+
database.createObjectStore(META);
|
|
138
|
+
}
|
|
139
|
+
function readValue(database, id) {
|
|
140
|
+
const transaction = database.transaction(VALUES, "readonly");
|
|
141
|
+
const request = transaction.objectStore(VALUES).get(id);
|
|
142
|
+
return finished(transaction).then(() => asValue(request.result));
|
|
143
|
+
}
|
|
144
|
+
function touchEntries(database, touches) {
|
|
145
|
+
if (touches.length === 0) {
|
|
146
|
+
return Promise.resolve();
|
|
147
|
+
}
|
|
148
|
+
const transaction = database.transaction(ENTRIES, "readwrite");
|
|
149
|
+
const entries = transaction.objectStore(ENTRIES);
|
|
150
|
+
for (const { id, accessed } of touches) {
|
|
151
|
+
const request = entries.get(id);
|
|
152
|
+
request.onsuccess = () => {
|
|
153
|
+
const entry = request.result;
|
|
154
|
+
// An entry removed since the read stays removed, and one written since
|
|
155
|
+
// keeps its newer time.
|
|
156
|
+
if (entry && entry.accessed < accessed) {
|
|
157
|
+
entries.put({ ...entry, accessed });
|
|
158
|
+
}
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
return finished(transaction);
|
|
162
|
+
}
|
|
163
|
+
// What the browser says this origin can still store. Neither budget is ever
|
|
164
|
+
// more than the store's own total plus this.
|
|
165
|
+
async function originFreeBytes() {
|
|
166
|
+
try {
|
|
167
|
+
const { quota, usage } = await navigator.storage.estimate();
|
|
168
|
+
if (typeof quota === "number" && typeof usage === "number") {
|
|
169
|
+
return Math.max(0, quota - usage);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
catch {
|
|
173
|
+
// No estimate in this context, or no navigator at all.
|
|
174
|
+
}
|
|
175
|
+
return Infinity;
|
|
176
|
+
}
|
|
177
|
+
// A write the browser refuses for want of space evicts the least recently used
|
|
178
|
+
// entries and is tried once more.
|
|
179
|
+
async function writeValue(database, write, budgets, freeBytes) {
|
|
180
|
+
try {
|
|
181
|
+
await putValue(database, write, budgets, freeBytes);
|
|
182
|
+
}
|
|
183
|
+
catch (error) {
|
|
184
|
+
if (!isQuotaError(error)) {
|
|
185
|
+
throw error;
|
|
186
|
+
}
|
|
187
|
+
await makeRoom(database, write);
|
|
188
|
+
await putValue(database, write, budgets, freeBytes);
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
// The write, the totals and the eviction happen in one transaction, so two
|
|
192
|
+
// tabs writing at once still leave the store within its budgets. The writing
|
|
193
|
+
// namespace's own entries are evicted first, until it is within the budget for
|
|
194
|
+
// a namespace; then the entries of every namespace, until the store is within
|
|
195
|
+
// its total budget.
|
|
196
|
+
function putValue(database, write, budgets, freeBytes) {
|
|
197
|
+
const transaction = database.transaction([VALUES, ENTRIES, META], "readwrite");
|
|
198
|
+
const stores = storesOf(transaction);
|
|
199
|
+
const [namespace, key] = write.id;
|
|
200
|
+
readTotals(stores, write.id, (total, namespaceTotal, old) => {
|
|
201
|
+
const totalBudget = Math.min(budgets.total, total + freeBytes);
|
|
202
|
+
const namespaceBudget = Math.min(budgets.deck, totalBudget);
|
|
203
|
+
// An entry over the budget for a namespace is not kept, and the old value
|
|
204
|
+
// under its key goes too, so a later get does not return it.
|
|
205
|
+
if (write.charge > namespaceBudget) {
|
|
206
|
+
deleteEntry(stores, write.id);
|
|
207
|
+
saveTotals(stores, total, new Map(old ? [[namespace, old.size]] : []));
|
|
208
|
+
return;
|
|
209
|
+
}
|
|
210
|
+
stores.values.put(write.value, write.id);
|
|
211
|
+
const entry = { namespace, key, size: write.charge, accessed: Date.now() };
|
|
212
|
+
stores.entries.put(entry);
|
|
213
|
+
const written = write.charge - (old?.size ?? 0);
|
|
214
|
+
stores.meta.put(namespaceTotal + written, namespaceTotalKey(namespace));
|
|
215
|
+
const freed = new Map();
|
|
216
|
+
const namespaceExcess = namespaceTotal + written - namespaceBudget;
|
|
217
|
+
evictOldest(stores, namespace, namespaceExcess, write.id, freed, () => {
|
|
218
|
+
const totalExcess = total + written - sumOf(freed) - totalBudget;
|
|
219
|
+
evictOldest(stores, null, totalExcess, write.id, freed, () => {
|
|
220
|
+
saveTotals(stores, total + written, freed);
|
|
221
|
+
});
|
|
222
|
+
});
|
|
223
|
+
});
|
|
224
|
+
return finished(transaction);
|
|
225
|
+
}
|
|
226
|
+
// After a write is refused for want of space, the old value under its key is
|
|
227
|
+
// removed, and the least recently used entries are evicted until the entries
|
|
228
|
+
// and the new value together take at most half of what the entries took.
|
|
229
|
+
function makeRoom(database, write) {
|
|
230
|
+
const transaction = database.transaction([VALUES, ENTRIES, META], "readwrite");
|
|
231
|
+
const stores = storesOf(transaction);
|
|
232
|
+
readTotals(stores, write.id, (total, _namespaceTotal, old) => {
|
|
233
|
+
deleteEntry(stores, write.id);
|
|
234
|
+
const freed = new Map();
|
|
235
|
+
if (old) {
|
|
236
|
+
freed.set(old.namespace, old.size);
|
|
237
|
+
}
|
|
238
|
+
const target = Math.max(0, total / 2 - write.charge);
|
|
239
|
+
evictOldest(stores, null, total - sumOf(freed) - target, null, freed, () => {
|
|
240
|
+
saveTotals(stores, total, freed);
|
|
241
|
+
});
|
|
242
|
+
});
|
|
243
|
+
return finished(transaction);
|
|
244
|
+
}
|
|
245
|
+
// Walks the entries from least recently accessed, those of one namespace or of
|
|
246
|
+
// all, deleting until `excess` bytes are freed, then calls `then`. The entry
|
|
247
|
+
// just written is skipped. Each deletion is added to `freed` under its
|
|
248
|
+
// namespace.
|
|
249
|
+
function evictOldest(stores, namespace, excess, kept, freed, then) {
|
|
250
|
+
if (excess <= 0) {
|
|
251
|
+
then();
|
|
252
|
+
return;
|
|
253
|
+
}
|
|
254
|
+
const request = namespace === null
|
|
255
|
+
? stores.entries.index(ACCESSED).openCursor()
|
|
256
|
+
: stores.entries
|
|
257
|
+
.index(NAMESPACE_ACCESSED)
|
|
258
|
+
.openCursor(IDBKeyRange.bound([namespace, -Infinity], [namespace, Infinity]));
|
|
259
|
+
request.onsuccess = () => {
|
|
260
|
+
const cursor = request.result;
|
|
261
|
+
if (!cursor || excess <= 0) {
|
|
262
|
+
then();
|
|
263
|
+
return;
|
|
264
|
+
}
|
|
265
|
+
const entry = cursor.value;
|
|
266
|
+
if (!kept || entry.namespace !== kept[0] || entry.key !== kept[1]) {
|
|
267
|
+
stores.values.delete(cursor.primaryKey);
|
|
268
|
+
cursor.delete();
|
|
269
|
+
excess -= entry.size;
|
|
270
|
+
freed.set(entry.namespace, (freed.get(entry.namespace) ?? 0) + entry.size);
|
|
271
|
+
}
|
|
272
|
+
cursor.continue();
|
|
273
|
+
};
|
|
274
|
+
}
|
|
275
|
+
function removeValue(database, id) {
|
|
276
|
+
const transaction = database.transaction([VALUES, ENTRIES, META], "readwrite");
|
|
277
|
+
const stores = storesOf(transaction);
|
|
278
|
+
readTotals(stores, id, (total, _namespaceTotal, entry) => {
|
|
279
|
+
deleteEntry(stores, id);
|
|
280
|
+
if (entry) {
|
|
281
|
+
saveTotals(stores, total, new Map([[entry.namespace, entry.size]]));
|
|
282
|
+
}
|
|
283
|
+
});
|
|
284
|
+
return finished(transaction);
|
|
285
|
+
}
|
|
286
|
+
function storesOf(transaction) {
|
|
287
|
+
return {
|
|
288
|
+
values: transaction.objectStore(VALUES),
|
|
289
|
+
entries: transaction.objectStore(ENTRIES),
|
|
290
|
+
meta: transaction.objectStore(META),
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
// Requests in a transaction complete in the order they were made, so both
|
|
294
|
+
// totals have been read when the entry's request succeeds.
|
|
295
|
+
function readTotals(stores, id, then) {
|
|
296
|
+
const total = stores.meta.get(TOTAL);
|
|
297
|
+
const namespaceTotal = stores.meta.get(namespaceTotalKey(id[0]));
|
|
298
|
+
const entry = stores.entries.get(id);
|
|
299
|
+
entry.onsuccess = () => {
|
|
300
|
+
then(total.result ?? 0, namespaceTotal.result ?? 0, entry.result);
|
|
301
|
+
};
|
|
302
|
+
}
|
|
303
|
+
// Stores the total less what was freed, and takes what was freed off each
|
|
304
|
+
// namespace's total. A namespace left with nothing loses its record.
|
|
305
|
+
function saveTotals(stores, total, freed) {
|
|
306
|
+
stores.meta.put(total - sumOf(freed), TOTAL);
|
|
307
|
+
for (const [namespace, bytes] of freed) {
|
|
308
|
+
const request = stores.meta.get(namespaceTotalKey(namespace));
|
|
309
|
+
request.onsuccess = () => {
|
|
310
|
+
const left = (request.result ?? 0) - bytes;
|
|
311
|
+
if (left > 0) {
|
|
312
|
+
stores.meta.put(left, namespaceTotalKey(namespace));
|
|
313
|
+
}
|
|
314
|
+
else {
|
|
315
|
+
stores.meta.delete(namespaceTotalKey(namespace));
|
|
316
|
+
}
|
|
317
|
+
};
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
function namespaceTotalKey(namespace) {
|
|
321
|
+
return ["namespace", namespace];
|
|
322
|
+
}
|
|
323
|
+
function sumOf(freed) {
|
|
324
|
+
let sum = 0;
|
|
325
|
+
for (const bytes of freed.values()) {
|
|
326
|
+
sum += bytes;
|
|
327
|
+
}
|
|
328
|
+
return sum;
|
|
329
|
+
}
|
|
330
|
+
function deleteEntry(stores, id) {
|
|
331
|
+
stores.values.delete(id);
|
|
332
|
+
stores.entries.delete(id);
|
|
333
|
+
}
|
|
334
|
+
// Text is counted at two bytes a character, the size of a JavaScript string,
|
|
335
|
+
// so measuring it costs no encoding.
|
|
336
|
+
function chargeOf(id, value) {
|
|
337
|
+
const valueBytes = typeof value === "string" ? value.length * 2 : value.byteLength;
|
|
338
|
+
return valueBytes + (id[0].length + id[1].length) * 4 + RECORD_BYTES;
|
|
339
|
+
}
|
|
340
|
+
function asValue(stored) {
|
|
341
|
+
if (typeof stored === "string" || stored instanceof ArrayBuffer) {
|
|
342
|
+
return stored;
|
|
343
|
+
}
|
|
344
|
+
return null;
|
|
345
|
+
}
|
|
346
|
+
function isQuotaError(error) {
|
|
347
|
+
return error instanceof DOMException && error.name === "QuotaExceededError";
|
|
348
|
+
}
|
|
349
|
+
// A failed request aborts its transaction with that request's error, so a write
|
|
350
|
+
// the browser refuses for space rejects with QuotaExceededError.
|
|
351
|
+
function finished(transaction) {
|
|
352
|
+
return new Promise((resolve, reject) => {
|
|
353
|
+
transaction.oncomplete = () => resolve();
|
|
354
|
+
transaction.onabort = () => {
|
|
355
|
+
reject(transaction.error ?? new Error("IndexedDB transaction aborted."));
|
|
356
|
+
};
|
|
357
|
+
});
|
|
358
|
+
}
|
|
@@ -143,7 +143,7 @@ function sendCommand(channel, command, params, stream) {
|
|
|
143
143
|
return;
|
|
144
144
|
}
|
|
145
145
|
installHostListener();
|
|
146
|
-
sendEnvelope(channel, { castleSdk: CASTLE_SDK_PROTOCOL, requestId, command, params });
|
|
146
|
+
sendEnvelope(channel, { castleSdk: CASTLE_SDK_PROTOCOL, requestId, command, params }, stream.transfer);
|
|
147
147
|
});
|
|
148
148
|
}
|
|
149
149
|
// Interactive commands have no timeout; they resolve only when the host replies.
|
|
@@ -202,13 +202,12 @@ function cancelledError(command) {
|
|
|
202
202
|
operation: command,
|
|
203
203
|
});
|
|
204
204
|
}
|
|
205
|
-
function sendEnvelope(channel, envelope) {
|
|
206
|
-
const json = JSON.stringify(envelope);
|
|
205
|
+
function sendEnvelope(channel, envelope, transfer = []) {
|
|
207
206
|
if (channel === "mobile") {
|
|
208
|
-
window.ReactNativeWebView?.postMessage(
|
|
207
|
+
window.ReactNativeWebView?.postMessage(JSON.stringify(envelope));
|
|
209
208
|
}
|
|
210
209
|
else {
|
|
211
|
-
window.parent.postMessage(envelope, "*");
|
|
210
|
+
window.parent.postMessage(envelope, "*", transfer);
|
|
212
211
|
}
|
|
213
212
|
}
|
|
214
213
|
// The mobile host can't dispatch a DOM 'message' event, so it calls this global
|
package/kits/hub-game/CLAUDE.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
A game behind a door in the Cauldron hub town. A hub game is a
|
|
4
4
|
`castle.multiplayer-3d` deck that meets the **hub contract**
|
|
5
|
-
(`docs/contract.md`, latest version 1.
|
|
5
|
+
(`docs/contract.md`, latest version 1.158; manifest `hub.contract: 1`): the kit
|
|
6
6
|
draws every player as their platform avatar, brings them in at the arrival
|
|
7
7
|
together and sends them back out
|
|
8
8
|
through the door they came in by, and draws the HUD, labels and Back control
|
|
@@ -39,6 +39,15 @@ notes messages and the client's refill behavior stay exactly as before.
|
|
|
39
39
|
`fall(hub, playerId)` (below the place's `fallY`; every place catches at
|
|
40
40
|
-20 by default, including past the edge of the finite implicit ground).
|
|
41
41
|
`server.main` stays `imports/castle.hub-game/code/server/index.js`.
|
|
42
|
+
- **Cars (v1.160).** Server-only `hub.drive(playerId, { look, color?, seats?,
|
|
43
|
+
speed?, reverse?, accel?, brake?, turn?, length?, width?, camDistance?,
|
|
44
|
+
camHeight?, horn? })` selects a predicted car on the player's capsule;
|
|
45
|
+
`look` is a scene Model template. At most 24 cars and four seats each.
|
|
46
|
+
`hub.ride(playerId, driverId, seat)` seats a nearby unheld walker (seat 1
|
|
47
|
+
onward), held and drawn from the driver's pose. `hub.vehicle(playerId)`
|
|
48
|
+
reads the role. `drive(id, null, at?)` gets everyone out; `ride(id, null)`
|
|
49
|
+
gets one rider out. Holds stop drivers, walk tune returns on exit; retained
|
|
50
|
+
reconnect keeps cars. Horn must be listed in `idle.sounds`. See contract §6.
|
|
42
51
|
- **A player's progress between visits** goes in `hub.session.storage.deck`
|
|
43
52
|
under `'<name>:<userId>'`, never user scope, which their own client can
|
|
44
53
|
write (contract §14).
|
|
@@ -79,6 +88,11 @@ notes messages and the client's refill behavior stay exactly as before.
|
|
|
79
88
|
`result(playerId, { outcome, score, stats })`, `results(playerId)` (ghost's
|
|
80
89
|
recent results and records of a player), `end(playerIds?)`,
|
|
81
90
|
`go(door, playerIds)`, `send`, `broadcast`, `session`, `sim`, `place`.
|
|
91
|
+
- **Visit roles** (v1.157): `hub.role(playerId, { id, label, color, hat?, top?, tool? } | null)`
|
|
92
|
+
dresses a player for this visit; `hub.roleOf(playerId)` returns a copy or null.
|
|
93
|
+
Role hat > try-on > owned Look. Tops hide earned belt/sash; tools hide earned
|
|
94
|
+
held items. The coloured label sits below the name. Nothing goes to ghost;
|
|
95
|
+
retained reconnect keeps it, leave/end/account change clears it. Contract §11.
|
|
82
96
|
- **Place menu** (v1.79): only with `menu: true`,
|
|
83
97
|
`hub.menu(playerId, { title, note?, readOnly?, face?, sections: [{ title, items:
|
|
84
98
|
[{ id, label, color?, icon?, on? }] }] } | null)` offers that player a
|
|
@@ -289,7 +303,7 @@ notes messages and the client's refill behavior stay exactly as before.
|
|
|
289
303
|
and on a phone on its side the text keeps to two lines. Without it the HUD
|
|
290
304
|
and labels are drawn as they always were.
|
|
291
305
|
- **Idle play** (contract v1.6): `"idle": true` in the `hub` block (or
|
|
292
|
-
`{ emotes, seats, sounds: ["sounds/x.mp3"] }`) gives players an emote picker
|
|
306
|
+
`{ emotes, seats, sounds: ["sounds/x.mp3"], expression }`) gives players an emote picker
|
|
293
307
|
(wave, dance, cheer, bow, spin, drawn on their avatar) and Sit on scene
|
|
294
308
|
actors carrying `HubSeat` (`{ face, height, pose }`, all optional; v1.82 `pose: "lie"` offers Lie down and draws a back-lying player, absent/`"sit"` keeps Sit); a seat is a hold, so the
|
|
295
309
|
place's `hub.release` stands a sitter. Hooks `emote(hub, playerId, id)` and
|
|
@@ -298,6 +312,11 @@ notes messages and the client's refill behavior stay exactly as before.
|
|
|
298
312
|
radius })` / `hub.sound(actorId, null)` for a listed sound file of the deck
|
|
299
313
|
(carried in its content pack's `audio`, so a game behind a door sounds too;
|
|
300
314
|
silent only on a town whose engine predates that).
|
|
315
|
+
v1.158 `expression: true` (requires `emotes: true`) replaces the picker with
|
|
316
|
+
an RP wheel and sit-anywhere (`hub.seat` returns `'ground'`, sit hook gets
|
|
317
|
+
null). `{ roleEmotes: [{ id, emoji, label, motion, ms }] }` declares up to
|
|
318
|
+
12 role emotes; `hub.emotesFor(playerId, ids | null)` grants them for the
|
|
319
|
+
visit, privately. Absent expression keeps existing UI and wire bytes (§6).
|
|
301
320
|
- **The soundscape** (contract v1.42, v1.49, v1.50, v1.56, v1.60): `"soundscape": true` in the `hub`
|
|
302
321
|
block (or `{ babble, steps }`, each on unless `false`; the deck's, not a
|
|
303
322
|
place's) has the kit make its own sounds, synthesised in the client and
|
|
@@ -494,6 +513,7 @@ notes messages and the client's refill behavior stay exactly as before.
|
|
|
494
513
|
| `scripts/check.mjs` | the publish check (`onCheck`) |
|
|
495
514
|
| `scripts/pack.mjs` | the content pack exporter (`onPack`): the deck's client half as data, for another deck's engine (`docs/content-pack.md`) |
|
|
496
515
|
| `code/client/pack.js`, `packFormat.js`, `sha256.js` | mounting a pack: fetch, verify, validate, build content |
|
|
516
|
+
| `tools/hubScene/` | the save-time HubSceneManifest exporter (castle.json `exports.hubScene`, run by `castle-web export`, and by `save-deck` under `CASTLE_SAVE_EXPORTS=1`): the deck's world built in Node with the CLI's own shipped kits (the loader refuses any other module; a deck's imports/ is read as data only), written into a stage the CLI then moves to `.castle/exports/hubScene/`; glbs are content-addressed in `~/.castle/export-cache/hubScene/shared/` (created exclusively, never overwritten; no GC yet), and the last manifest is reused while its key (CLI version, the shipped kit trees, three, every data file read) holds; `validate-manifest.mjs` checks it, `merge-root.mjs` merges decks into one root for the native host, `test/export-fixture.mjs` is its test. Manifest v1.4 adds `deck` (the hub block's client flags, `code/shared/deckFlags.js`) and `interactables` (HubNpc, HubAct and HubSeat actors as `{ id, components }` with their Transform, and, when the scene opts in to chat Report & block, the component-only `{ id: 'hub-chat-moderation', components: { HubChatModeration: { v: 1 } } }`) for the DOM-less native kit, which applies `deck` with `hookLayer.applyDeck` (`scripts/test-apply-deck.mjs`). v1.6 (`format` and `version` unchanged) adds the deck's sound: each file the hub block's root and places' `idle.sounds` name, read as the page's initialMedia holds it (the deck's own .mp3/.wav/.m4a; others are left out with a source note), is a content-addressed asset mapped by its castle.json path in `audio`; `deck` keeps `soundscape` and the root and places' `idle` at their keys; `interactables` adds the `jukebox` actor (Shape, Lookable, Transform) and every actor carrying a component the soundscape names (`zones`, `steps.paths`, `ambience.spots` keys), whole, with its Transform. v1.7 (`format` and `version` still unchanged) always adds `avatarFits` (16 entries per style after `Avatar.drawn` fallback, earned fit arrays verbatim, `hat` and `top`), `wearModels` (untinted content-addressed glb asset records for every hat, earned and role model, including square variants, also registered in `assets`) and `wearPieces` (anchors, constant scales, main colours to tint and fit-dependent placement notes). Fits are over feet; placement shifts to the avatar origin as in `wear.js`. Ring `scale` is the unchanged height scale; horizontal stretch and all top scaling depend on the fit. Hats retain authored colours; lantern/lighthouse perch on the crown (`wear.js`), while other hats sit at the seat. The shipped client avatar/role/earned/hats modules and model files are already covered by the kits hash. Upload rewrites the embedded wear asset URIs too. Earlier fields match castle-client's live-page exporter (`nativetown/hubscene/tools/export-hub.mjs`) |
|
|
497
517
|
| `scripts/test-manifest.mjs`, `test-pack.mjs`, `test-actors.mjs`, `test-idle.mjs`, `test-classic.mjs` | tests over the manifest, results, place resolution, the pack, moved and painted actors, idle play, and cabinets |
|
|
498
518
|
| `scripts/test-avatar.mjs`, `test-avatar-models.mjs`, `test-picker.mjs` | the avatar seam; the toon models held to the generator and to 1,500 triangles and 8 draw calls (the engine's own count); the character picker |
|
|
499
519
|
| `code/client/avatarCap.js`, `scripts/test-avatar-cap.mjs` | a limit on different characters drawn at once, by default all sixteen (no stand-ins); with `?hubAvDistinct=N`, at most N (the local player's included): the farthest players past that are drawn as their stand-in (`avatar % 4`), never anyone within 8 m, with hysteresis, respawned through the hook layer's avatar-change path; client display only. `?hubAvDistinct=N` sets the limit (absent or 0 the default) |
|