@hypersoniclabs/helix-sdk 0.1.1 → 0.1.9
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/README.md +954 -2
- package/dist/action-surface.d.ts +182 -0
- package/dist/action-surface.js +1032 -0
- package/dist/action-surface.js.map +1 -0
- package/dist/camera.d.ts +78 -0
- package/dist/camera.js +640 -0
- package/dist/camera.js.map +1 -0
- package/dist/dev-shell/criteria.d.ts +46 -0
- package/dist/dev-shell/criteria.js +98 -0
- package/dist/dev-shell/criteria.js.map +1 -0
- package/dist/dev-shell/index.d.ts +189 -0
- package/dist/dev-shell/index.js +287 -0
- package/dist/dev-shell/index.js.map +1 -0
- package/dist/dev-shell/keys.d.ts +14 -0
- package/dist/dev-shell/keys.js +78 -0
- package/dist/dev-shell/keys.js.map +1 -0
- package/dist/dev-shell/simulator.d.ts +436 -0
- package/dist/dev-shell/simulator.js +1634 -0
- package/dist/dev-shell/simulator.js.map +1 -0
- package/dist/dev-shell/state.d.ts +148 -0
- package/dist/dev-shell/state.js +196 -0
- package/dist/dev-shell/state.js.map +1 -0
- package/dist/device-definition-resolver.d.ts +34 -0
- package/dist/device-definition-resolver.js +172 -0
- package/dist/device-definition-resolver.js.map +1 -0
- package/dist/device-trial.d.ts +3 -0
- package/dist/device-trial.js +132 -0
- package/dist/device-trial.js.map +1 -0
- package/dist/devices.d.ts +228 -0
- package/dist/devices.js +198 -0
- package/dist/devices.js.map +1 -0
- package/dist/dreamerAudio.d.ts +126 -0
- package/dist/dreamerAudio.js +135 -0
- package/dist/dreamerAudio.js.map +1 -0
- package/dist/generated/runtime-contract.d.ts +15529 -0
- package/dist/generated/runtime-contract.js +20470 -0
- package/dist/generated/runtime-contract.js.map +1 -0
- package/dist/index.d.ts +364 -3
- package/dist/index.js +1954 -13
- package/dist/index.js.map +1 -1
- package/dist/interaction-mode.d.ts +172 -0
- package/dist/interaction-mode.js +553 -0
- package/dist/interaction-mode.js.map +1 -0
- package/dist/internal/avatar-pose.d.ts +25 -0
- package/dist/internal/avatar-pose.js +46 -0
- package/dist/internal/avatar-pose.js.map +1 -0
- package/dist/internal/keyed-collection.d.ts +2 -0
- package/dist/internal/keyed-collection.js +12 -0
- package/dist/internal/keyed-collection.js.map +1 -0
- package/dist/internal/vehicle-detach-action.d.ts +2 -0
- package/dist/internal/vehicle-detach-action.js +6 -0
- package/dist/internal/vehicle-detach-action.js.map +1 -0
- package/dist/matchmaking.d.ts +433 -0
- package/dist/matchmaking.js +1487 -0
- package/dist/matchmaking.js.map +1 -0
- package/dist/materials.d.ts +122 -0
- package/dist/materials.js +217 -0
- package/dist/materials.js.map +1 -0
- package/dist/multiplayer-accessors.d.ts +100 -0
- package/dist/multiplayer-accessors.js +200 -0
- package/dist/multiplayer-accessors.js.map +1 -0
- package/dist/multiplayer-contract/avatar-pose.d.ts +112 -0
- package/dist/multiplayer-contract/avatar-pose.js +250 -0
- package/dist/multiplayer-contract/avatar-pose.js.map +1 -0
- package/dist/multiplayer-contract/credential.d.ts +80 -0
- package/dist/multiplayer-contract/credential.js +5 -0
- package/dist/multiplayer-contract/credential.js.map +1 -0
- package/dist/multiplayer-contract/final-rest.d.ts +66 -0
- package/dist/multiplayer-contract/final-rest.js +38 -0
- package/dist/multiplayer-contract/final-rest.js.map +1 -0
- package/dist/multiplayer-contract/index.d.ts +20 -0
- package/dist/multiplayer-contract/index.js +41 -0
- package/dist/multiplayer-contract/index.js.map +1 -0
- package/dist/multiplayer-contract/messages.d.ts +731 -0
- package/dist/multiplayer-contract/messages.js +237 -0
- package/dist/multiplayer-contract/messages.js.map +1 -0
- package/dist/multiplayer-contract/room.d.ts +177 -0
- package/dist/multiplayer-contract/room.js +17 -0
- package/dist/multiplayer-contract/room.js.map +1 -0
- package/dist/multiplayer-contract/state.d.ts +241 -0
- package/dist/multiplayer-contract/state.js +15 -0
- package/dist/multiplayer-contract/state.js.map +1 -0
- package/dist/multiplayer-final-rest.d.ts +32 -0
- package/dist/multiplayer-final-rest.js +217 -0
- package/dist/multiplayer-final-rest.js.map +1 -0
- package/dist/multiplayer.d.ts +624 -0
- package/dist/multiplayer.js +2503 -0
- package/dist/multiplayer.js.map +1 -0
- package/dist/package.json +3 -0
- package/dist/protocol.d.ts +859 -1
- package/dist/protocol.js +117 -5
- package/dist/protocol.js.map +1 -1
- package/dist/runtime-contract/index.d.ts +15 -0
- package/dist/runtime-contract/index.js +12 -0
- package/dist/runtime-contract/index.js.map +1 -0
- package/dist/server-clock.d.ts +25 -0
- package/dist/server-clock.js +88 -0
- package/dist/server-clock.js.map +1 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/universal-vehicles.d.ts +111 -0
- package/dist/universal-vehicles.js +2 -0
- package/dist/universal-vehicles.js.map +1 -0
- package/dist/vault.d.ts +562 -0
- package/dist/vault.js +365 -0
- package/dist/vault.js.map +1 -0
- package/dist/vehicle-specialty-placement.d.ts +28 -0
- package/dist/vehicle-specialty-placement.js +154 -0
- package/dist/vehicle-specialty-placement.js.map +1 -0
- package/dist/vehicle-specialty-transport.d.ts +78 -0
- package/dist/vehicle-specialty-transport.js +183 -0
- package/dist/vehicle-specialty-transport.js.map +1 -0
- package/dist/voice.d.ts +229 -0
- package/dist/voice.js +1348 -0
- package/dist/voice.js.map +1 -0
- package/generated/runtime-contract/helix-runtime-contract.json +13332 -0
- package/generated/runtime-contract/known-answer.json +20471 -0
- package/generated/runtime-contract/known-answer.schema.json +630 -0
- package/generated/runtime-contract/runtime-contract.schema.json +607 -0
- package/generated/runtime-contract/unreal/HelixRuntimeContract.generated.h +908 -0
- package/package.json +44 -5
|
@@ -0,0 +1,553 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Portable interaction takeover primitive v0.3.
|
|
3
|
+
*
|
|
4
|
+
* This module deliberately has no engine or renderer dependency. It owns stack ordering,
|
|
5
|
+
* validation, lifecycle, results and safety teardown; a trusted host owns the actual input,
|
|
6
|
+
* camera, locomotion and HUD integrations.
|
|
7
|
+
*/
|
|
8
|
+
/** @deprecated v0.3 touch declarations are already normalized presentation objects. */
|
|
9
|
+
export function normaliseTouch(touch) {
|
|
10
|
+
return touch;
|
|
11
|
+
}
|
|
12
|
+
export const ANY_VERB = '*';
|
|
13
|
+
const ACTIONS = new Set([
|
|
14
|
+
'move',
|
|
15
|
+
'look',
|
|
16
|
+
'primary',
|
|
17
|
+
'secondary',
|
|
18
|
+
'tertiary',
|
|
19
|
+
'cancel',
|
|
20
|
+
]);
|
|
21
|
+
const TOUCH_KINDS = new Set([
|
|
22
|
+
'button',
|
|
23
|
+
'drag',
|
|
24
|
+
'tap',
|
|
25
|
+
'hold',
|
|
26
|
+
'stick',
|
|
27
|
+
'none',
|
|
28
|
+
]);
|
|
29
|
+
const TOUCH_ZONES = new Set([
|
|
30
|
+
'surface',
|
|
31
|
+
'primary',
|
|
32
|
+
'secondary',
|
|
33
|
+
'left',
|
|
34
|
+
'right',
|
|
35
|
+
]);
|
|
36
|
+
const RAW_BINDING_FIELDS = ['keys', 'pointer', 'gamepad', 'key', 'mouseButton', 'touchBinding'];
|
|
37
|
+
/**
|
|
38
|
+
* Validate a mode input map. Suppression is optional for callers validating a reusable map; the
|
|
39
|
+
* stack always supplies it and therefore enforces the reachable-cancel rule.
|
|
40
|
+
*/
|
|
41
|
+
export function validateInputMap(input, suppression = {}) {
|
|
42
|
+
const errors = [];
|
|
43
|
+
const enabledActions = new Map();
|
|
44
|
+
const surfaceContinuous = [];
|
|
45
|
+
for (const [verb, typedBinding] of Object.entries(input)) {
|
|
46
|
+
const binding = typedBinding;
|
|
47
|
+
for (const field of RAW_BINDING_FIELDS) {
|
|
48
|
+
if (Object.prototype.hasOwnProperty.call(binding, field)) {
|
|
49
|
+
errors.push(`verb '${verb}' declares raw device field '${field}'`);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
const action = binding.action;
|
|
53
|
+
if (typeof action !== 'string' || !ACTIONS.has(action)) {
|
|
54
|
+
errors.push(`verb '${verb}' has unsupported action '${String(action)}'`);
|
|
55
|
+
}
|
|
56
|
+
if (typeof binding.label !== 'string' || binding.label.trim() === '') {
|
|
57
|
+
errors.push(`verb '${verb}' has no label, so touch and hints cannot render it`);
|
|
58
|
+
}
|
|
59
|
+
const touch = binding.touch;
|
|
60
|
+
if (!touch || typeof touch !== 'object') {
|
|
61
|
+
errors.push(`verb '${verb}' has no touch presentation`);
|
|
62
|
+
}
|
|
63
|
+
else {
|
|
64
|
+
if (typeof touch.kind !== 'string' || !TOUCH_KINDS.has(touch.kind)) {
|
|
65
|
+
errors.push(`verb '${verb}' has unsupported touch kind '${String(touch.kind)}'`);
|
|
66
|
+
}
|
|
67
|
+
if (typeof touch.zone !== 'string' || !TOUCH_ZONES.has(touch.zone)) {
|
|
68
|
+
errors.push(`verb '${verb}' has unsupported touch zone '${String(touch.zone)}'`);
|
|
69
|
+
}
|
|
70
|
+
if (binding.continuous === true && touch.kind !== 'none' && touch.zone === 'surface') {
|
|
71
|
+
surfaceContinuous.push(verb);
|
|
72
|
+
}
|
|
73
|
+
if ((action === 'move' || action === 'look') && !['drag', 'stick', 'none'].includes(String(touch.kind))) {
|
|
74
|
+
errors.push(`verb '${verb}' maps vector action '${action}' to non-vector touch kind '${String(touch.kind)}'`);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
if (binding.disabled === true &&
|
|
78
|
+
(typeof binding.disabledReason !== 'string' || binding.disabledReason.trim() === '')) {
|
|
79
|
+
errors.push(`verb '${verb}' is disabled without disabledReason`);
|
|
80
|
+
}
|
|
81
|
+
if (binding.repeatMs !== undefined &&
|
|
82
|
+
(typeof binding.repeatMs !== 'number' || !Number.isFinite(binding.repeatMs) || binding.repeatMs <= 0)) {
|
|
83
|
+
errors.push(`verb '${verb}' has invalid repeatMs`);
|
|
84
|
+
}
|
|
85
|
+
if (ACTIONS.has(action) && binding.disabled !== true) {
|
|
86
|
+
const standardAction = action;
|
|
87
|
+
const prior = enabledActions.get(standardAction);
|
|
88
|
+
if (prior) {
|
|
89
|
+
errors.push(`verbs '${prior}' and '${verb}' both map enabled action '${standardAction}'`);
|
|
90
|
+
}
|
|
91
|
+
else if (!prior) {
|
|
92
|
+
enabledActions.set(standardAction, verb);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
if (surfaceContinuous.length > 1) {
|
|
97
|
+
errors.push(`verbs [${surfaceContinuous.join(', ')}] are continuous and claim the whole touch surface; ` +
|
|
98
|
+
'at most one may');
|
|
99
|
+
}
|
|
100
|
+
if ((suppression.locomotion || suppression.cameraControl) && !enabledActions.has('cancel')) {
|
|
101
|
+
errors.push('a mode suppressing locomotion or cameraControl requires an enabled cancel action');
|
|
102
|
+
}
|
|
103
|
+
return errors;
|
|
104
|
+
}
|
|
105
|
+
const EXCLUSIVE = ['locomotion', 'cameraControl'];
|
|
106
|
+
const OWNERS = new WeakMap();
|
|
107
|
+
export class ModeStack {
|
|
108
|
+
#host;
|
|
109
|
+
#frames = [];
|
|
110
|
+
#sink = (verb, event) => this.dispatchVerb(verb, event);
|
|
111
|
+
#disposed = false;
|
|
112
|
+
#clearPromise = null;
|
|
113
|
+
constructor(host) {
|
|
114
|
+
this.#host = host;
|
|
115
|
+
}
|
|
116
|
+
get active() {
|
|
117
|
+
return this.#frames.at(-1)?.mode ?? null;
|
|
118
|
+
}
|
|
119
|
+
get depth() {
|
|
120
|
+
return this.#frames.length;
|
|
121
|
+
}
|
|
122
|
+
get busy() {
|
|
123
|
+
return this.#frames.some((frame) => frame.leaving);
|
|
124
|
+
}
|
|
125
|
+
has(id) {
|
|
126
|
+
return this.#frames.some((frame) => frame.mode.id === id);
|
|
127
|
+
}
|
|
128
|
+
async push(mode, params = {}, options = {}) {
|
|
129
|
+
if (this.#disposed)
|
|
130
|
+
return rejected(new Error('mode stack is disposed'));
|
|
131
|
+
if (this.#clearPromise)
|
|
132
|
+
return rejected(new Error('mode stack is clearing'));
|
|
133
|
+
if (this.has(mode.id))
|
|
134
|
+
return this.#reject(new Error(`mode '${mode.id}' is already on the stack`), mode.id);
|
|
135
|
+
const owner = OWNERS.get(mode);
|
|
136
|
+
if (owner && owner !== this) {
|
|
137
|
+
return this.#reject(new Error(`mode '${mode.id}' is already live on another stack`), mode.id);
|
|
138
|
+
}
|
|
139
|
+
const clash = this.#exclusiveClash(mode);
|
|
140
|
+
if (clash) {
|
|
141
|
+
return this.#reject(new Error(`mode '${mode.id}' claims '${clash.cap}' already held by '${clash.byId}'`), mode.id);
|
|
142
|
+
}
|
|
143
|
+
if (mode.input) {
|
|
144
|
+
const errors = validateInputMap(mode.input, mode.suppress);
|
|
145
|
+
if (errors.length) {
|
|
146
|
+
return this.#reject(new Error(`mode '${mode.id}' has an invalid input map: ${errors.join('; ')}`), mode.id);
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
else if (mode.suppress.locomotion || mode.suppress.cameraControl) {
|
|
150
|
+
return this.#reject(new Error(`mode '${mode.id}' suppresses locomotion or cameraControl without a cancel action`), mode.id);
|
|
151
|
+
}
|
|
152
|
+
const frame = this.#makeFrame(mode, params, options);
|
|
153
|
+
OWNERS.set(mode, this);
|
|
154
|
+
const below = this.#frames.at(-1);
|
|
155
|
+
this.#frames.push(frame);
|
|
156
|
+
if (below)
|
|
157
|
+
this.#cover(below);
|
|
158
|
+
this.#applySuppression();
|
|
159
|
+
this.#applyTop();
|
|
160
|
+
try {
|
|
161
|
+
await mode.enter(frame.ctx);
|
|
162
|
+
if (frame.settled) {
|
|
163
|
+
await frame.done;
|
|
164
|
+
return { ok: false, error: new Error(`mode '${mode.id}' left while entering`), done: frame.done };
|
|
165
|
+
}
|
|
166
|
+
frame.entered = true;
|
|
167
|
+
this.#applyTop();
|
|
168
|
+
return { ok: true, done: frame.done };
|
|
169
|
+
}
|
|
170
|
+
catch (error) {
|
|
171
|
+
this.#fail(error, mode.id, 'enter');
|
|
172
|
+
await this.#popFrame(frame, true, 'error', error);
|
|
173
|
+
return { ok: false, error, done: frame.done };
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
async pop(id, aborted = false) {
|
|
177
|
+
const frame = id === undefined
|
|
178
|
+
? this.#frames.at(-1)
|
|
179
|
+
: [...this.#frames].reverse().find((candidate) => candidate.mode.id === id);
|
|
180
|
+
if (!frame)
|
|
181
|
+
return false;
|
|
182
|
+
return this.#popFrame(frame, aborted, aborted ? 'cleared' : 'popped');
|
|
183
|
+
}
|
|
184
|
+
clear(aborted = true) {
|
|
185
|
+
if (this.#clearPromise)
|
|
186
|
+
return this.#clearPromise;
|
|
187
|
+
this.#clearPromise = this.#clearFrames(aborted).finally(() => {
|
|
188
|
+
this.#clearPromise = null;
|
|
189
|
+
});
|
|
190
|
+
return this.#clearPromise;
|
|
191
|
+
}
|
|
192
|
+
update(dtSeconds) {
|
|
193
|
+
if (this.#disposed)
|
|
194
|
+
return;
|
|
195
|
+
const top = this.#frames.at(-1);
|
|
196
|
+
for (const frame of [...this.#frames]) {
|
|
197
|
+
if (frame.leaving || !frame.entered || !frame.mode.update)
|
|
198
|
+
continue;
|
|
199
|
+
if (frame !== top && !frame.mode.updateWhileCovered)
|
|
200
|
+
continue;
|
|
201
|
+
try {
|
|
202
|
+
frame.mode.update(dtSeconds, frame.ctx);
|
|
203
|
+
}
|
|
204
|
+
catch (error) {
|
|
205
|
+
this.#failAndPop(frame, error, 'update');
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
dispatchVerb(verb, event) {
|
|
210
|
+
if (this.#disposed)
|
|
211
|
+
return false;
|
|
212
|
+
const frame = this.#frames.at(-1);
|
|
213
|
+
if (!frame || frame.leaving || !frame.entered)
|
|
214
|
+
return false;
|
|
215
|
+
const binding = frame.input?.[verb];
|
|
216
|
+
if (!binding) {
|
|
217
|
+
this.#fail(new Error(`mode '${frame.mode.id}' received undeclared verb '${verb}'`), frame.mode.id, 'verb');
|
|
218
|
+
return false;
|
|
219
|
+
}
|
|
220
|
+
if (binding.disabled)
|
|
221
|
+
return false;
|
|
222
|
+
if (event.phase === 'start')
|
|
223
|
+
frame.activeVerbs.add(verb);
|
|
224
|
+
if (event.phase === 'end')
|
|
225
|
+
frame.activeVerbs.delete(verb);
|
|
226
|
+
this.#invoke(frame, verb, event);
|
|
227
|
+
return true;
|
|
228
|
+
}
|
|
229
|
+
async dispose() {
|
|
230
|
+
if (this.#disposed)
|
|
231
|
+
return this.#clearPromise ?? Promise.resolve();
|
|
232
|
+
this.#disposed = true;
|
|
233
|
+
await this.clear(true);
|
|
234
|
+
}
|
|
235
|
+
async #clearFrames(aborted) {
|
|
236
|
+
// Mark every existing frame first: no lower frame is briefly revealed or reacquires input on
|
|
237
|
+
// the way down, and a racing second lifecycle signal observes the same teardown in progress.
|
|
238
|
+
for (const frame of this.#frames)
|
|
239
|
+
frame.leaving = true;
|
|
240
|
+
this.#applyTop();
|
|
241
|
+
while (this.#frames.length) {
|
|
242
|
+
const frame = this.#frames.at(-1);
|
|
243
|
+
if (frame.settled) {
|
|
244
|
+
await frame.done;
|
|
245
|
+
}
|
|
246
|
+
else {
|
|
247
|
+
await this.#popFrame(frame, aborted, 'cleared');
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
#reject(error, modeId) {
|
|
252
|
+
this.#fail(error, modeId, 'enter');
|
|
253
|
+
return rejected(error);
|
|
254
|
+
}
|
|
255
|
+
#exclusiveClash(mode) {
|
|
256
|
+
for (const cap of EXCLUSIVE) {
|
|
257
|
+
if (!mode.suppress[cap])
|
|
258
|
+
continue;
|
|
259
|
+
const holder = this.#frames.find((frame) => frame.mode.suppress[cap]);
|
|
260
|
+
if (holder)
|
|
261
|
+
return { cap, byId: holder.mode.id };
|
|
262
|
+
}
|
|
263
|
+
return null;
|
|
264
|
+
}
|
|
265
|
+
#applySuppression() {
|
|
266
|
+
const effective = {
|
|
267
|
+
locomotion: false,
|
|
268
|
+
cameraControl: false,
|
|
269
|
+
defaultHud: false,
|
|
270
|
+
interaction: false,
|
|
271
|
+
};
|
|
272
|
+
for (const frame of this.#frames) {
|
|
273
|
+
for (const capability of Object.keys(effective)) {
|
|
274
|
+
if (frame.mode.suppress[capability])
|
|
275
|
+
effective[capability] = true;
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
this.#host.setSuppression(effective);
|
|
279
|
+
}
|
|
280
|
+
#applyTop() {
|
|
281
|
+
const top = this.#frames.at(-1);
|
|
282
|
+
const usable = top?.entered && !top.leaving ? top : null;
|
|
283
|
+
if (!top || usable)
|
|
284
|
+
this.#host.applyCamera(usable?.camera ?? null);
|
|
285
|
+
this.#host.setVerbs(usable?.input ?? null, usable?.input ? this.#sink : null);
|
|
286
|
+
}
|
|
287
|
+
#cover(frame) {
|
|
288
|
+
if (frame.covered)
|
|
289
|
+
return;
|
|
290
|
+
frame.covered = true;
|
|
291
|
+
this.#endHeldVerbs(frame);
|
|
292
|
+
if (!frame.mode.onCovered)
|
|
293
|
+
return;
|
|
294
|
+
try {
|
|
295
|
+
frame.mode.onCovered(frame.ctx);
|
|
296
|
+
}
|
|
297
|
+
catch (error) {
|
|
298
|
+
this.#failAndPop(frame, error, 'covered');
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
#reveal(frame) {
|
|
302
|
+
if (!frame.covered)
|
|
303
|
+
return;
|
|
304
|
+
frame.covered = false;
|
|
305
|
+
if (!frame.mode.onRevealed)
|
|
306
|
+
return;
|
|
307
|
+
try {
|
|
308
|
+
frame.mode.onRevealed(frame.ctx);
|
|
309
|
+
}
|
|
310
|
+
catch (error) {
|
|
311
|
+
this.#failAndPop(frame, error, 'revealed');
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
#endHeldVerbs(frame) {
|
|
315
|
+
const held = [...frame.activeVerbs];
|
|
316
|
+
frame.activeVerbs.clear();
|
|
317
|
+
for (const verb of held) {
|
|
318
|
+
this.#invoke(frame, verb, { phase: 'end', value: 0, source: 'script' });
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
#invoke(frame, verb, event) {
|
|
322
|
+
const targets = [frame.handlers.get(verb), frame.handlers.get(ANY_VERB)];
|
|
323
|
+
for (const handlers of targets) {
|
|
324
|
+
if (!handlers)
|
|
325
|
+
continue;
|
|
326
|
+
for (const handler of [...handlers]) {
|
|
327
|
+
try {
|
|
328
|
+
handler(event, verb);
|
|
329
|
+
}
|
|
330
|
+
catch (error) {
|
|
331
|
+
// A held start that throws is followed by synthetic end during teardown. Remove the
|
|
332
|
+
// failed callback first so that safety cleanup cannot invoke the same broken code twice.
|
|
333
|
+
handlers.delete(handler);
|
|
334
|
+
this.#failAndPop(frame, error, 'verb');
|
|
335
|
+
return;
|
|
336
|
+
}
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
#failAndPop(frame, error, phase) {
|
|
341
|
+
if (frame.leaving || frame.settled)
|
|
342
|
+
return;
|
|
343
|
+
this.#fail(error, frame.mode.id, phase);
|
|
344
|
+
void this.#popFrame(frame, true, 'error', error);
|
|
345
|
+
}
|
|
346
|
+
async #popFrame(frame, aborted, reason, error) {
|
|
347
|
+
if (!this.#frames.includes(frame) || frame.settled)
|
|
348
|
+
return false;
|
|
349
|
+
frame.settled = true;
|
|
350
|
+
frame.leaving = true;
|
|
351
|
+
frame.aborted = aborted;
|
|
352
|
+
this.#endHeldVerbs(frame);
|
|
353
|
+
this.#applyTop();
|
|
354
|
+
let endReason = reason;
|
|
355
|
+
let failure = error;
|
|
356
|
+
try {
|
|
357
|
+
await frame.mode.exit(frame.ctx);
|
|
358
|
+
}
|
|
359
|
+
catch (exitError) {
|
|
360
|
+
this.#fail(exitError, frame.mode.id, 'exit');
|
|
361
|
+
if (failure === undefined)
|
|
362
|
+
failure = exitError;
|
|
363
|
+
endReason = 'error';
|
|
364
|
+
}
|
|
365
|
+
const at = this.#frames.indexOf(frame);
|
|
366
|
+
if (at >= 0)
|
|
367
|
+
this.#frames.splice(at, 1);
|
|
368
|
+
OWNERS.delete(frame.mode);
|
|
369
|
+
frame.handlers.clear();
|
|
370
|
+
frame.activeVerbs.clear();
|
|
371
|
+
this.#host.reportDiag(frame.mode.id, { active: false });
|
|
372
|
+
this.#applySuppression();
|
|
373
|
+
this.#applyTop();
|
|
374
|
+
const next = this.#frames.at(-1);
|
|
375
|
+
if (next && !next.leaving)
|
|
376
|
+
this.#reveal(next);
|
|
377
|
+
const result = {
|
|
378
|
+
reason: endReason,
|
|
379
|
+
aborted,
|
|
380
|
+
...(frame.result ? { value: frame.result.value } : {}),
|
|
381
|
+
...(failure !== undefined ? { error: failure } : {}),
|
|
382
|
+
};
|
|
383
|
+
frame.settle(result);
|
|
384
|
+
try {
|
|
385
|
+
frame.options.onResult?.(result);
|
|
386
|
+
}
|
|
387
|
+
catch (callbackError) {
|
|
388
|
+
this.#fail(callbackError, frame.mode.id, 'exit');
|
|
389
|
+
}
|
|
390
|
+
return true;
|
|
391
|
+
}
|
|
392
|
+
#makeFrame(mode, params, options) {
|
|
393
|
+
let settle = () => undefined;
|
|
394
|
+
const done = new Promise((resolve) => {
|
|
395
|
+
settle = resolve;
|
|
396
|
+
});
|
|
397
|
+
const frame = {
|
|
398
|
+
mode,
|
|
399
|
+
params,
|
|
400
|
+
diagState: {},
|
|
401
|
+
camera: mode.camera ?? null,
|
|
402
|
+
input: mode.input ?? null,
|
|
403
|
+
handlers: new Map(),
|
|
404
|
+
activeVerbs: new Set(),
|
|
405
|
+
entered: false,
|
|
406
|
+
leaving: false,
|
|
407
|
+
settled: false,
|
|
408
|
+
aborted: false,
|
|
409
|
+
covered: false,
|
|
410
|
+
result: null,
|
|
411
|
+
options,
|
|
412
|
+
settle,
|
|
413
|
+
done,
|
|
414
|
+
ctx: null,
|
|
415
|
+
};
|
|
416
|
+
frame.ctx = this.#makeContext(frame);
|
|
417
|
+
return frame;
|
|
418
|
+
}
|
|
419
|
+
#makeContext(frame) {
|
|
420
|
+
const stack = this;
|
|
421
|
+
return {
|
|
422
|
+
params: frame.params,
|
|
423
|
+
get live() {
|
|
424
|
+
return stack.#frames.includes(frame);
|
|
425
|
+
},
|
|
426
|
+
get covered() {
|
|
427
|
+
return frame.covered;
|
|
428
|
+
},
|
|
429
|
+
get aborted() {
|
|
430
|
+
return frame.aborted;
|
|
431
|
+
},
|
|
432
|
+
setCamera(intent) {
|
|
433
|
+
frame.camera = intent;
|
|
434
|
+
if (stack.#frames.at(-1) === frame && frame.entered && !frame.leaving) {
|
|
435
|
+
// Camera changes are independent of the input lease. Reapplying the whole top frame here
|
|
436
|
+
// revokes and reacquires unchanged verbs, silently advancing the trusted host's epoch.
|
|
437
|
+
stack.#host.applyCamera(frame.camera);
|
|
438
|
+
}
|
|
439
|
+
},
|
|
440
|
+
setInput(input) {
|
|
441
|
+
if (input) {
|
|
442
|
+
const errors = validateInputMap(input, frame.mode.suppress);
|
|
443
|
+
if (errors.length) {
|
|
444
|
+
const error = new Error(`setInput rejected for '${frame.mode.id}': ${errors.join('; ')}`);
|
|
445
|
+
stack.#failAndPop(frame, error, 'verb');
|
|
446
|
+
return;
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
else if (frame.mode.suppress.locomotion || frame.mode.suppress.cameraControl) {
|
|
450
|
+
const error = new Error(`setInput rejected for '${frame.mode.id}': exclusive suppression requires cancel`);
|
|
451
|
+
stack.#failAndPop(frame, error, 'verb');
|
|
452
|
+
return;
|
|
453
|
+
}
|
|
454
|
+
for (const verb of [...frame.activeVerbs]) {
|
|
455
|
+
if (!input?.[verb]) {
|
|
456
|
+
frame.activeVerbs.delete(verb);
|
|
457
|
+
stack.#invoke(frame, verb, { phase: 'end', value: 0, source: 'script' });
|
|
458
|
+
}
|
|
459
|
+
}
|
|
460
|
+
frame.input = input;
|
|
461
|
+
if (stack.#frames.at(-1) === frame && frame.entered && !frame.leaving) {
|
|
462
|
+
stack.#host.setVerbs(frame.input, frame.input ? stack.#sink : null);
|
|
463
|
+
}
|
|
464
|
+
},
|
|
465
|
+
onVerb(verb, handler) {
|
|
466
|
+
const handlers = frame.handlers.get(verb) ?? new Set();
|
|
467
|
+
frame.handlers.set(verb, handlers);
|
|
468
|
+
handlers.add(handler);
|
|
469
|
+
return () => handlers.delete(handler);
|
|
470
|
+
},
|
|
471
|
+
isVerbActive(verb) {
|
|
472
|
+
return frame.activeVerbs.has(verb);
|
|
473
|
+
},
|
|
474
|
+
emit(event, payload) {
|
|
475
|
+
try {
|
|
476
|
+
frame.options.onEvent?.(event, payload);
|
|
477
|
+
stack.#host.onModeEvent?.(frame.mode.id, event, payload);
|
|
478
|
+
}
|
|
479
|
+
catch (callbackError) {
|
|
480
|
+
stack.#failAndPop(frame, callbackError, 'update');
|
|
481
|
+
}
|
|
482
|
+
},
|
|
483
|
+
release(value) {
|
|
484
|
+
frame.result = { value };
|
|
485
|
+
if (!stack.#frames.includes(frame) || frame.leaving)
|
|
486
|
+
return;
|
|
487
|
+
void stack.#popFrame(frame, false, 'released');
|
|
488
|
+
},
|
|
489
|
+
diag(patch) {
|
|
490
|
+
for (const [key, value] of Object.entries(patch)) {
|
|
491
|
+
if (value === undefined)
|
|
492
|
+
delete frame.diagState[key];
|
|
493
|
+
else
|
|
494
|
+
frame.diagState[key] = value;
|
|
495
|
+
}
|
|
496
|
+
stack.#host.reportDiag(frame.mode.id, {
|
|
497
|
+
active: stack.#frames.includes(frame),
|
|
498
|
+
...frame.diagState,
|
|
499
|
+
});
|
|
500
|
+
},
|
|
501
|
+
clearDiag(...keys) {
|
|
502
|
+
if (keys.length) {
|
|
503
|
+
for (const key of keys)
|
|
504
|
+
delete frame.diagState[key];
|
|
505
|
+
}
|
|
506
|
+
else {
|
|
507
|
+
for (const key of Object.keys(frame.diagState))
|
|
508
|
+
delete frame.diagState[key];
|
|
509
|
+
}
|
|
510
|
+
stack.#host.reportDiag(frame.mode.id, {
|
|
511
|
+
active: stack.#frames.includes(frame),
|
|
512
|
+
...frame.diagState,
|
|
513
|
+
});
|
|
514
|
+
},
|
|
515
|
+
};
|
|
516
|
+
}
|
|
517
|
+
#fail(error, modeId, phase) {
|
|
518
|
+
this.#host.onError?.(error, modeId, phase);
|
|
519
|
+
this.#host.reportDiag(modeId, { error: String(error), phase });
|
|
520
|
+
}
|
|
521
|
+
}
|
|
522
|
+
function rejected(error) {
|
|
523
|
+
return {
|
|
524
|
+
ok: false,
|
|
525
|
+
error,
|
|
526
|
+
done: Promise.resolve({ reason: 'error', aborted: true, error }),
|
|
527
|
+
};
|
|
528
|
+
}
|
|
529
|
+
/**
|
|
530
|
+
* Bind browser lifecycle edges that otherwise strand held input or camera takeover.
|
|
531
|
+
*
|
|
532
|
+
* `visibilitychange` is a Document event (and does not bubble to Window), so its target is
|
|
533
|
+
* deliberately separate from the window lifecycle target. Tests and non-browser hosts may pass
|
|
534
|
+
* an explicit visibility target; `null` disables only that binding.
|
|
535
|
+
*/
|
|
536
|
+
export function bindStackSafety(stack, target = globalThis, visibilityTarget = globalThis.document ?? null) {
|
|
537
|
+
const clear = () => void stack.clear(true);
|
|
538
|
+
const onVisibility = () => {
|
|
539
|
+
if (visibilityTarget?.hidden)
|
|
540
|
+
clear();
|
|
541
|
+
};
|
|
542
|
+
target.addEventListener('blur', clear);
|
|
543
|
+
visibilityTarget?.addEventListener('visibilitychange', onVisibility);
|
|
544
|
+
target.addEventListener('pagehide', clear);
|
|
545
|
+
target.addEventListener('beforeunload', clear);
|
|
546
|
+
return () => {
|
|
547
|
+
target.removeEventListener('blur', clear);
|
|
548
|
+
visibilityTarget?.removeEventListener('visibilitychange', onVisibility);
|
|
549
|
+
target.removeEventListener('pagehide', clear);
|
|
550
|
+
target.removeEventListener('beforeunload', clear);
|
|
551
|
+
};
|
|
552
|
+
}
|
|
553
|
+
//# sourceMappingURL=interaction-mode.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interaction-mode.js","sourceRoot":"","sources":["../src/interaction-mode.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { HelixRoom } from '../multiplayer.js';
|
|
2
|
+
import { AVATAR_POSE_LIMITS, AVATAR_POSE_MASK_ALL, AVATAR_POSE_SOURCE_ALL, AVATAR_POSE_VERSION, AvatarPoseMask, AvatarPoseSource, decodeAvatarPoseReplica, decodeAvatarPoseWire, encodeAvatarPose, sanitizeAvatarPoseWire, type AvatarPoseInputV1, type AvatarPoseReplicaStateV1, type AvatarPoseWireV1, type FingerCurls, type FingerCurlsU8, type HeadPoseI16, type QuatI16 } from '../multiplayer-contract/avatar-pose.js';
|
|
3
|
+
/**
|
|
4
|
+
* Engine/server-only semantic pose. This subpath is intentionally absent from the creator-facing root,
|
|
5
|
+
* multiplayer contract, HelixRoom state, and generated runtime API inventory.
|
|
6
|
+
*/
|
|
7
|
+
export type InternalAvatarPoseV1 = AvatarPoseInputV1;
|
|
8
|
+
export interface InternalAvatarPoseCapabilityV1 {
|
|
9
|
+
readonly version: typeof AVATAR_POSE_VERSION;
|
|
10
|
+
/** Set the pose sampled alongside the next ordinary sendState frame. null explicitly clears tracking. */
|
|
11
|
+
setLocalPose(pose: InternalAvatarPoseV1 | null): void;
|
|
12
|
+
/** Decode the reflected transport child. Missing, old, neutral, or malformed data returns null. */
|
|
13
|
+
decodeReplica(player: unknown): InternalAvatarPoseV1 | null;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Feature-detect the private humanoid transport seam on a room handle. Symbol.for keeps this working when the
|
|
17
|
+
* room creator and humanoid runtime resolve different copies of the SDK. A previous/foreign room returns null.
|
|
18
|
+
*/
|
|
19
|
+
export declare function getInternalAvatarPoseCapability(room: unknown): InternalAvatarPoseCapabilityV1 | null;
|
|
20
|
+
/** SDK-internal installer used while constructing the curated HelixRoom handle. */
|
|
21
|
+
export declare function installInternalAvatarPoseCapability(room: HelixRoom, capability: InternalAvatarPoseCapabilityV1): InternalAvatarPoseCapabilityV1;
|
|
22
|
+
/** Read a reflected child without adding it to the public PlayerState type. */
|
|
23
|
+
export declare function decodeInternalAvatarPoseReplica(player: unknown): InternalAvatarPoseV1 | null;
|
|
24
|
+
export { AVATAR_POSE_LIMITS, AVATAR_POSE_MASK_ALL, AVATAR_POSE_SOURCE_ALL, AVATAR_POSE_VERSION, AvatarPoseMask, AvatarPoseSource, decodeAvatarPoseReplica, decodeAvatarPoseWire, encodeAvatarPose, sanitizeAvatarPoseWire, };
|
|
25
|
+
export type { AvatarPoseReplicaStateV1 as InternalAvatarPoseReplicaStateV1, AvatarPoseWireV1 as InternalAvatarPoseWireV1, FingerCurls as InternalFingerCurls, FingerCurlsU8 as InternalFingerCurlsU8, HeadPoseI16 as InternalHeadPoseI16, QuatI16 as InternalQuatI16, };
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { AVATAR_POSE_LIMITS, AVATAR_POSE_MASK_ALL, AVATAR_POSE_SOURCE_ALL, AVATAR_POSE_VERSION, AvatarPoseMask, AvatarPoseSource, decodeAvatarPoseReplica, decodeAvatarPoseWire, encodeAvatarPose, sanitizeAvatarPoseWire, } from '../multiplayer-contract/avatar-pose.js';
|
|
2
|
+
const CAPABILITY = Symbol.for('@hypersoniclabs/helix-sdk/internal/avatar-pose/v1');
|
|
3
|
+
function isObject(value) {
|
|
4
|
+
return (typeof value === 'object' && value !== null) || typeof value === 'function';
|
|
5
|
+
}
|
|
6
|
+
function isCapability(value) {
|
|
7
|
+
if (!isObject(value))
|
|
8
|
+
return false;
|
|
9
|
+
const candidate = value;
|
|
10
|
+
return candidate.version === AVATAR_POSE_VERSION
|
|
11
|
+
&& typeof candidate.setLocalPose === 'function'
|
|
12
|
+
&& typeof candidate.decodeReplica === 'function';
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Feature-detect the private humanoid transport seam on a room handle. Symbol.for keeps this working when the
|
|
16
|
+
* room creator and humanoid runtime resolve different copies of the SDK. A previous/foreign room returns null.
|
|
17
|
+
*/
|
|
18
|
+
export function getInternalAvatarPoseCapability(room) {
|
|
19
|
+
if (!isObject(room))
|
|
20
|
+
return null;
|
|
21
|
+
const value = room[CAPABILITY];
|
|
22
|
+
return isCapability(value) ? value : null;
|
|
23
|
+
}
|
|
24
|
+
/** SDK-internal installer used while constructing the curated HelixRoom handle. */
|
|
25
|
+
export function installInternalAvatarPoseCapability(room, capability) {
|
|
26
|
+
const existing = getInternalAvatarPoseCapability(room);
|
|
27
|
+
if (existing)
|
|
28
|
+
return existing;
|
|
29
|
+
if (!isCapability(capability))
|
|
30
|
+
throw new TypeError('invalid internal avatar-pose capability');
|
|
31
|
+
Object.defineProperty(room, CAPABILITY, {
|
|
32
|
+
value: capability,
|
|
33
|
+
enumerable: false,
|
|
34
|
+
configurable: false,
|
|
35
|
+
writable: false,
|
|
36
|
+
});
|
|
37
|
+
return capability;
|
|
38
|
+
}
|
|
39
|
+
/** Read a reflected child without adding it to the public PlayerState type. */
|
|
40
|
+
export function decodeInternalAvatarPoseReplica(player) {
|
|
41
|
+
if (!isObject(player))
|
|
42
|
+
return null;
|
|
43
|
+
return decodeAvatarPoseReplica(player.avatarPose);
|
|
44
|
+
}
|
|
45
|
+
export { AVATAR_POSE_LIMITS, AVATAR_POSE_MASK_ALL, AVATAR_POSE_SOURCE_ALL, AVATAR_POSE_VERSION, AvatarPoseMask, AvatarPoseSource, decodeAvatarPoseReplica, decodeAvatarPoseWire, encodeAvatarPose, sanitizeAvatarPoseWire, };
|
|
46
|
+
//# sourceMappingURL=avatar-pose.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"avatar-pose.js","sourceRoot":"","sources":["../../src/internal/avatar-pose.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,GAQvB,MAAM,qCAAqC,CAAC;AAgB7C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;AAEnF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,SAAS,GAAG,KAAgD,CAAC;IACnE,OAAO,SAAS,CAAC,OAAO,KAAK,mBAAmB;WAC3C,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU;WAC5C,OAAO,SAAS,CAAC,aAAa,KAAK,UAAU,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAI,IAAqC,CAAC,UAAU,CAAC,CAAC;IACjE,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mCAAmC,CACjD,IAAe,EACf,UAA0C;IAE1C,MAAM,QAAQ,GAAG,+BAA+B,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAC9F,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;QACtC,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,+BAA+B,CAAC,MAAe;IAC7D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,uBAAuB,CAC3B,MAA2D,CAAC,UAAU,CACxE,CAAC;AACJ,CAAC;AAED,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,GACvB,CAAC"}
|