@hypersoniclabs/helix-sdk 0.1.2 → 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 +859 -8
- 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 +65 -1
- package/dist/camera.js +568 -0
- package/dist/camera.js.map +1 -1
- 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 +272 -15
- package/dist/index.js +1401 -91
- 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 +38 -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 +11 -5
- package/dist/multiplayer-contract/index.js +16 -5
- package/dist/multiplayer-contract/index.js.map +1 -1
- package/dist/multiplayer-contract/messages.d.ts +461 -14
- package/dist/multiplayer-contract/messages.js +141 -15
- package/dist/multiplayer-contract/messages.js.map +1 -1
- package/dist/multiplayer-contract/room.d.ts +55 -4
- package/dist/multiplayer-contract/state.d.ts +181 -1
- package/dist/multiplayer-contract/state.js.map +1 -1
- 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 +507 -16
- package/dist/multiplayer.js +2242 -73
- package/dist/multiplayer.js.map +1 -1
- package/dist/package.json +3 -0
- package/dist/protocol.d.ts +668 -5
- package/dist/protocol.js +101 -1
- 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 +32 -6
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
// Typed, guarded, LIVE-READING views over the declared game state (roomVars / per-player vars / phase /
|
|
2
|
+
// turn order). Read-side sugar only: nothing here touches multiplayer-contract or the wire — it exists so
|
|
3
|
+
// world code stops hand-rolling `(p.vars as Record<string, unknown>)?.x` casts, frame-0 guards, and
|
|
4
|
+
// ArraySchema index loops. Every accessor reads the CURRENT state on each call (never cache the result
|
|
5
|
+
// across frames — call again instead; the underlying schema mutates in place).
|
|
6
|
+
import { keyedCollectionEntry } from './internal/keyed-collection.js';
|
|
7
|
+
// ---- transport-chunk awareness (room schema chunking for >64 declared vars) --------------------------
|
|
8
|
+
// @colyseus/schema caps a concrete class at 64 wire fields, so above 64 declared vars the room transports
|
|
9
|
+
// a bag as `$0..$N` typed chunks and keeps flat names only as SERVER-side non-enumerable accessors (see
|
|
10
|
+
// helix-colyseus-server src/declared-state.ts). A reflected client materializes just the containers, so a
|
|
11
|
+
// flat read must look through them. The `$` prefix cannot collide: the manifest identifier grammar never
|
|
12
|
+
// admits `$`, so `$`-prefixed keys are transport-reserved by construction — the accessors treat them as
|
|
13
|
+
// invisible (never readable as vars, never listed) on BOTH layouts.
|
|
14
|
+
// Chunk membership is fixed per build and chunks mutate in place (stable identity), so each bag's
|
|
15
|
+
// name→chunk resolution is memoized weakly; values are always re-read live off the resolved chunk.
|
|
16
|
+
const chunkHomes = new WeakMap();
|
|
17
|
+
function chunkAt(bag, index) {
|
|
18
|
+
const c = bag[`$${index}`];
|
|
19
|
+
return c !== null && c !== undefined && typeof c === 'object' ? c : null;
|
|
20
|
+
}
|
|
21
|
+
function readThroughChunks(bag, name) {
|
|
22
|
+
let homes = chunkHomes.get(bag);
|
|
23
|
+
const cached = homes?.get(name);
|
|
24
|
+
if (cached) {
|
|
25
|
+
const v = cached[name];
|
|
26
|
+
if (v !== undefined)
|
|
27
|
+
return v;
|
|
28
|
+
}
|
|
29
|
+
for (let i = 0;; i++) {
|
|
30
|
+
const chunk = chunkAt(bag, i);
|
|
31
|
+
if (!chunk)
|
|
32
|
+
return undefined;
|
|
33
|
+
const v = chunk[name];
|
|
34
|
+
if (v !== undefined) {
|
|
35
|
+
if (!homes) {
|
|
36
|
+
homes = new Map();
|
|
37
|
+
chunkHomes.set(bag, homes);
|
|
38
|
+
}
|
|
39
|
+
homes.set(name, chunk);
|
|
40
|
+
return v;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
/** Build a VarsView over a live bag getter — `source()` is re-read on every access (live semantics). */
|
|
45
|
+
export function createVarsView(source) {
|
|
46
|
+
const read = (name) => {
|
|
47
|
+
if (name.charCodeAt(0) === 0x24 /* '$' */)
|
|
48
|
+
return undefined; // transport-reserved, never a declared var
|
|
49
|
+
const bag = source();
|
|
50
|
+
if (bag === null || bag === undefined)
|
|
51
|
+
return undefined;
|
|
52
|
+
const direct = bag[name];
|
|
53
|
+
if (direct !== undefined)
|
|
54
|
+
return direct; // flat layout (≤64 declared vars) — byte-compatible fast path
|
|
55
|
+
return readThroughChunks(bag, name);
|
|
56
|
+
};
|
|
57
|
+
return {
|
|
58
|
+
num: (name, fallback = 0) => {
|
|
59
|
+
const v = read(name);
|
|
60
|
+
return typeof v === 'number' && Number.isFinite(v) ? v : fallback;
|
|
61
|
+
},
|
|
62
|
+
str: (name, fallback = '') => {
|
|
63
|
+
const v = read(name);
|
|
64
|
+
if (typeof v === 'string')
|
|
65
|
+
return v;
|
|
66
|
+
// A ref var arrives as an object that stringifies to its id (the wire's ref convention).
|
|
67
|
+
return v !== null && v !== undefined && typeof v === 'object' ? String(v) : fallback;
|
|
68
|
+
},
|
|
69
|
+
bool: (name, fallback = false) => {
|
|
70
|
+
const v = read(name);
|
|
71
|
+
return typeof v === 'boolean' ? v : fallback;
|
|
72
|
+
},
|
|
73
|
+
vec3: (name) => {
|
|
74
|
+
const v = read(name);
|
|
75
|
+
return v && typeof v.x === 'number' && typeof v.y === 'number' && typeof v.z === 'number'
|
|
76
|
+
? { x: v.x, y: v.y, z: v.z }
|
|
77
|
+
: null;
|
|
78
|
+
},
|
|
79
|
+
list: (name) => {
|
|
80
|
+
const v = read(name);
|
|
81
|
+
if (Array.isArray(v))
|
|
82
|
+
return v.slice();
|
|
83
|
+
if (v !== null && v !== undefined && typeof v === 'object' && Symbol.iterator in v)
|
|
84
|
+
return [...v];
|
|
85
|
+
return [];
|
|
86
|
+
},
|
|
87
|
+
raw: read,
|
|
88
|
+
has: (name) => read(name) !== undefined,
|
|
89
|
+
names: () => {
|
|
90
|
+
const bag = source();
|
|
91
|
+
if (bag === null || bag === undefined)
|
|
92
|
+
return [];
|
|
93
|
+
// A recipient-filtered Colyseus Schema may retain an enumerable reflected field whose value is
|
|
94
|
+
// `undefined`. That is absent on the wire for this recipient and must be absent from the sanctioned
|
|
95
|
+
// logical-name surface too; otherwise names() leaks the key of an owner-only field while has()/raw()
|
|
96
|
+
// correctly report it missing.
|
|
97
|
+
const logical = (o) => Object.keys(o).filter((k) => k.charCodeAt(0) !== 0x24 && o[k] !== undefined);
|
|
98
|
+
if (!chunkAt(bag, 0))
|
|
99
|
+
return logical(bag);
|
|
100
|
+
const out = [];
|
|
101
|
+
for (let i = 0;; i++) {
|
|
102
|
+
const chunk = chunkAt(bag, i);
|
|
103
|
+
if (!chunk)
|
|
104
|
+
return out;
|
|
105
|
+
out.push(...logical(chunk));
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
/** Build a guarded module-instance view over the flat and overflow module wire fields. */
|
|
111
|
+
export function createModuleAccessors(sessionId, moduleId, state) {
|
|
112
|
+
const dynamicVars = (module) => {
|
|
113
|
+
const output = {};
|
|
114
|
+
const copy = (bag, accept) => {
|
|
115
|
+
if (!bag)
|
|
116
|
+
return;
|
|
117
|
+
if (typeof bag.forEach === 'function') {
|
|
118
|
+
bag.forEach((value, key) => {
|
|
119
|
+
if (accept(value))
|
|
120
|
+
output[key] = value;
|
|
121
|
+
});
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
124
|
+
for (const [key, value] of Object.entries(bag))
|
|
125
|
+
if (accept(value))
|
|
126
|
+
output[key] = value;
|
|
127
|
+
};
|
|
128
|
+
copy(module.booleans, (value) => typeof value === 'boolean');
|
|
129
|
+
copy(module.numbers, (value) => typeof value === 'number' && Number.isFinite(value));
|
|
130
|
+
copy(module.strings, (value) => typeof value === 'string');
|
|
131
|
+
return output;
|
|
132
|
+
};
|
|
133
|
+
const current = () => {
|
|
134
|
+
const root = state();
|
|
135
|
+
const wireKey = `m:${moduleId}`;
|
|
136
|
+
const flat = root?.modules?.[wireKey];
|
|
137
|
+
if (flat)
|
|
138
|
+
return flat;
|
|
139
|
+
// The first 64 modules retain their original wire layout. Overflow chunks are consecutive,
|
|
140
|
+
// schema-declared fields (not an iterable map); always read the live state after each patch.
|
|
141
|
+
for (let index = 0;; index++) {
|
|
142
|
+
const chunk = root?.moduleChunks?.[`c${index}`];
|
|
143
|
+
if (!chunk)
|
|
144
|
+
break;
|
|
145
|
+
const module = chunk[wireKey];
|
|
146
|
+
if (module)
|
|
147
|
+
return module;
|
|
148
|
+
}
|
|
149
|
+
const dynamic = keyedCollectionEntry(root?.dynamicModules, moduleId);
|
|
150
|
+
return dynamic === undefined
|
|
151
|
+
? undefined
|
|
152
|
+
: {
|
|
153
|
+
roomVars: dynamicVars(dynamic),
|
|
154
|
+
phase: dynamic.phase,
|
|
155
|
+
};
|
|
156
|
+
};
|
|
157
|
+
const varsFor = (collection, id) => keyedCollectionEntry(collection, id)?.vars;
|
|
158
|
+
return {
|
|
159
|
+
moduleId,
|
|
160
|
+
vars: createVarsView(() => current()?.roomVars),
|
|
161
|
+
me: createVarsView(() => varsFor(current()?.players, sessionId)),
|
|
162
|
+
player: (id) => createVarsView(() => varsFor(current()?.players, id)),
|
|
163
|
+
entity: (id) => createVarsView(() => varsFor(current()?.entities, id)),
|
|
164
|
+
phase: () => current()?.phase ?? '',
|
|
165
|
+
timerDeadline: (name, key) => keyedCollectionEntry(current()?.timerDeadlines, key === undefined ? name : `${name}|${key}`) ?? 0,
|
|
166
|
+
};
|
|
167
|
+
}
|
|
168
|
+
/** Build the room-level accessor set over a live state getter + this client's session id. */
|
|
169
|
+
export function createRoomAccessors(sessionId, state) {
|
|
170
|
+
const vars = createVarsView(() => state()?.roomVars);
|
|
171
|
+
// players is a MapSchema on live state — bracket access silently returns undefined there, only .get() resolves.
|
|
172
|
+
const playerVars = (id) => {
|
|
173
|
+
const players = state()?.players;
|
|
174
|
+
if (!players)
|
|
175
|
+
return undefined;
|
|
176
|
+
return keyedCollectionEntry(players, id)?.vars;
|
|
177
|
+
};
|
|
178
|
+
const player = (id) => createVarsView(() => playerVars(id));
|
|
179
|
+
const currentTurn = () => {
|
|
180
|
+
const order = vars.list('turnOrder');
|
|
181
|
+
if (order.length === 0)
|
|
182
|
+
return '';
|
|
183
|
+
const idx = vars.num('turnIndex');
|
|
184
|
+
const entry = order[idx];
|
|
185
|
+
return entry === null || entry === undefined ? '' : String(entry);
|
|
186
|
+
};
|
|
187
|
+
return {
|
|
188
|
+
vars,
|
|
189
|
+
me: player(sessionId),
|
|
190
|
+
player,
|
|
191
|
+
phase: () => state()?.phase ?? '',
|
|
192
|
+
currentTurn,
|
|
193
|
+
isMyTurn: () => {
|
|
194
|
+
const turn = currentTurn();
|
|
195
|
+
return turn !== '' && turn === sessionId;
|
|
196
|
+
},
|
|
197
|
+
module: (moduleId) => createModuleAccessors(sessionId, moduleId, state),
|
|
198
|
+
};
|
|
199
|
+
}
|
|
200
|
+
//# sourceMappingURL=multiplayer-accessors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"multiplayer-accessors.js","sourceRoot":"","sources":["../src/multiplayer-accessors.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
import type { Quat, Vec3 } from './state.js';
|
|
2
|
+
/**
|
|
3
|
+
* Compact, additive universal-avatar tracking state. This is deliberately hardware/runtime neutral: a headset,
|
|
4
|
+
* controller, optical hand, native client, or future tracker may all produce the same semantic pose.
|
|
5
|
+
*
|
|
6
|
+
* Root space is the avatar's feet/facing frame: +X right, +Y up, +Z forward. Palm quaternions are root-local,
|
|
7
|
+
* right-handed, and ordered x/y/z/w. Wrist positions stay on the existing world-space reachLeft/reachRight fields.
|
|
8
|
+
*/
|
|
9
|
+
export declare const AVATAR_POSE_VERSION: 1;
|
|
10
|
+
export declare const AvatarPoseMask: {
|
|
11
|
+
readonly Head: number;
|
|
12
|
+
readonly LeftPalm: number;
|
|
13
|
+
readonly RightPalm: number;
|
|
14
|
+
readonly LeftFingers: number;
|
|
15
|
+
readonly RightFingers: number;
|
|
16
|
+
};
|
|
17
|
+
export declare const AvatarPoseSource: {
|
|
18
|
+
readonly Headset: number;
|
|
19
|
+
readonly LeftController: number;
|
|
20
|
+
readonly RightController: number;
|
|
21
|
+
readonly LeftHand: number;
|
|
22
|
+
readonly RightHand: number;
|
|
23
|
+
};
|
|
24
|
+
export declare const AVATAR_POSE_MASK_ALL: number;
|
|
25
|
+
export declare const AVATAR_POSE_SOURCE_ALL: number;
|
|
26
|
+
export declare const AVATAR_POSE_LIMITS: {
|
|
27
|
+
/** Root-local head lean in centimetres. */
|
|
28
|
+
readonly headHorizontalCm: 200;
|
|
29
|
+
/** Root-local headset height in centimetres, including seated/crouched tracking. */
|
|
30
|
+
readonly minHeadHeightCm: -50;
|
|
31
|
+
readonly maxHeadHeightCm: 300;
|
|
32
|
+
/** Head roll uses tenths of a degree on the wire. */
|
|
33
|
+
readonly headRollDeciDeg: 1800;
|
|
34
|
+
/** Signed-int16 normalized quaternion scale. */
|
|
35
|
+
readonly quaternionScale: 32767;
|
|
36
|
+
readonly curlMax: 255;
|
|
37
|
+
};
|
|
38
|
+
/** Thumb, index, middle, ring, little. Semantic/public curls are normalized 0..1. */
|
|
39
|
+
export type FingerCurls = readonly [number, number, number, number, number];
|
|
40
|
+
export type FingerCurlsU8 = [number, number, number, number, number];
|
|
41
|
+
export type QuatI16 = [number, number, number, number];
|
|
42
|
+
export type HeadPoseI16 = [number, number, number, number];
|
|
43
|
+
/** Engine-facing input. The SDK alone owns the compact representation below. */
|
|
44
|
+
export interface AvatarPoseInputV1 {
|
|
45
|
+
v: typeof AVATAR_POSE_VERSION;
|
|
46
|
+
mask: number;
|
|
47
|
+
sources: number;
|
|
48
|
+
headOffset?: Vec3;
|
|
49
|
+
headRollDeg?: number;
|
|
50
|
+
leftPalm?: Quat;
|
|
51
|
+
rightPalm?: Quat;
|
|
52
|
+
leftCurls?: FingerCurls;
|
|
53
|
+
rightCurls?: FingerCurls;
|
|
54
|
+
}
|
|
55
|
+
/** Existing StateMessage payload member. Short keys + tuples keep the 10/20 Hz upload small. */
|
|
56
|
+
export interface AvatarPoseWireV1 {
|
|
57
|
+
v: typeof AVATAR_POSE_VERSION;
|
|
58
|
+
/** AvatarPoseMask bitset. */
|
|
59
|
+
m: number;
|
|
60
|
+
/** AvatarPoseSource bitset. */
|
|
61
|
+
s: number;
|
|
62
|
+
/** [root-local x/y/z centimetres, head roll tenths-of-a-degree]. */
|
|
63
|
+
h?: HeadPoseI16;
|
|
64
|
+
/** Root-local xyzw unit quaternions, each component normalized to signed int16. */
|
|
65
|
+
lp?: QuatI16;
|
|
66
|
+
rp?: QuatI16;
|
|
67
|
+
/** Thumb/index/middle/ring/little curl, 0..255. */
|
|
68
|
+
lc?: FingerCurlsU8;
|
|
69
|
+
rc?: FingerCurlsU8;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The reflected PlayerState mirror. Scalars use uint8/int16 in the Colyseus schema, so changed finger curls cost
|
|
73
|
+
* one byte each and tracked rotations avoid float64 churn. `mask === 0` is the one neutral/inactive reading.
|
|
74
|
+
*/
|
|
75
|
+
export interface AvatarPoseReplicaStateV1 {
|
|
76
|
+
version: number;
|
|
77
|
+
mask: number;
|
|
78
|
+
sources: number;
|
|
79
|
+
headXCm: number;
|
|
80
|
+
headYCm: number;
|
|
81
|
+
headZCm: number;
|
|
82
|
+
headRollDeciDeg: number;
|
|
83
|
+
leftPalmX: number;
|
|
84
|
+
leftPalmY: number;
|
|
85
|
+
leftPalmZ: number;
|
|
86
|
+
leftPalmW: number;
|
|
87
|
+
rightPalmX: number;
|
|
88
|
+
rightPalmY: number;
|
|
89
|
+
rightPalmZ: number;
|
|
90
|
+
rightPalmW: number;
|
|
91
|
+
leftThumb: number;
|
|
92
|
+
leftIndex: number;
|
|
93
|
+
leftMiddle: number;
|
|
94
|
+
leftRing: number;
|
|
95
|
+
leftLittle: number;
|
|
96
|
+
rightThumb: number;
|
|
97
|
+
rightIndex: number;
|
|
98
|
+
rightMiddle: number;
|
|
99
|
+
rightRing: number;
|
|
100
|
+
rightLittle: number;
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Validate an untrusted compact group without throwing. The room treats `null` as a neutral avatar pose while
|
|
104
|
+
* still applying the ordinary locomotion frame; malformed optional embodiment must never freeze movement.
|
|
105
|
+
*/
|
|
106
|
+
export declare function sanitizeAvatarPoseWire(value: unknown): AvatarPoseWireV1 | null;
|
|
107
|
+
/** Encode the engine-facing float pose into the compact state-lane group. Invalid semantics fail neutral. */
|
|
108
|
+
export declare function encodeAvatarPose(input: AvatarPoseInputV1 | null | undefined): AvatarPoseWireV1 | null;
|
|
109
|
+
/** Decode an inbound compact group for tests/non-Colyseus consumers. Invalid input returns neutral. */
|
|
110
|
+
export declare function decodeAvatarPoseWire(value: unknown): AvatarPoseInputV1 | null;
|
|
111
|
+
/** Decode the reflected, quantized PlayerState child. Missing/old-room/neutral state returns null. */
|
|
112
|
+
export declare function decodeAvatarPoseReplica(value: AvatarPoseReplicaStateV1 | null | undefined): AvatarPoseInputV1 | null;
|
|
@@ -0,0 +1,250 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Compact, additive universal-avatar tracking state. This is deliberately hardware/runtime neutral: a headset,
|
|
3
|
+
* controller, optical hand, native client, or future tracker may all produce the same semantic pose.
|
|
4
|
+
*
|
|
5
|
+
* Root space is the avatar's feet/facing frame: +X right, +Y up, +Z forward. Palm quaternions are root-local,
|
|
6
|
+
* right-handed, and ordered x/y/z/w. Wrist positions stay on the existing world-space reachLeft/reachRight fields.
|
|
7
|
+
*/
|
|
8
|
+
export const AVATAR_POSE_VERSION = 1;
|
|
9
|
+
export const AvatarPoseMask = {
|
|
10
|
+
Head: 1 << 0,
|
|
11
|
+
LeftPalm: 1 << 1,
|
|
12
|
+
RightPalm: 1 << 2,
|
|
13
|
+
LeftFingers: 1 << 3,
|
|
14
|
+
RightFingers: 1 << 4,
|
|
15
|
+
};
|
|
16
|
+
export const AvatarPoseSource = {
|
|
17
|
+
Headset: 1 << 0,
|
|
18
|
+
LeftController: 1 << 1,
|
|
19
|
+
RightController: 1 << 2,
|
|
20
|
+
LeftHand: 1 << 3,
|
|
21
|
+
RightHand: 1 << 4,
|
|
22
|
+
};
|
|
23
|
+
export const AVATAR_POSE_MASK_ALL = Object.values(AvatarPoseMask).reduce((a, b) => a | b, 0);
|
|
24
|
+
export const AVATAR_POSE_SOURCE_ALL = Object.values(AvatarPoseSource).reduce((a, b) => a | b, 0);
|
|
25
|
+
export const AVATAR_POSE_LIMITS = {
|
|
26
|
+
/** Root-local head lean in centimetres. */
|
|
27
|
+
headHorizontalCm: 200,
|
|
28
|
+
/** Root-local headset height in centimetres, including seated/crouched tracking. */
|
|
29
|
+
minHeadHeightCm: -50,
|
|
30
|
+
maxHeadHeightCm: 300,
|
|
31
|
+
/** Head roll uses tenths of a degree on the wire. */
|
|
32
|
+
headRollDeciDeg: 1800,
|
|
33
|
+
/** Signed-int16 normalized quaternion scale. */
|
|
34
|
+
quaternionScale: 32767,
|
|
35
|
+
curlMax: 255,
|
|
36
|
+
};
|
|
37
|
+
const integerWithin = (value, min, max) => typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max;
|
|
38
|
+
function has(mask, bit) {
|
|
39
|
+
return (mask & bit) !== 0;
|
|
40
|
+
}
|
|
41
|
+
function validTuple(value, length, min, max) {
|
|
42
|
+
return Array.isArray(value) && value.length === length && value.every((part) => integerWithin(part, min, max));
|
|
43
|
+
}
|
|
44
|
+
function validQuatI16(value) {
|
|
45
|
+
if (!validTuple(value, 4, -AVATAR_POSE_LIMITS.quaternionScale, AVATAR_POSE_LIMITS.quaternionScale))
|
|
46
|
+
return false;
|
|
47
|
+
const scale = AVATAR_POSE_LIMITS.quaternionScale;
|
|
48
|
+
const normSq = value.reduce((sum, part) => sum + (part / scale) ** 2, 0);
|
|
49
|
+
// Encoder rounding is effectively unit length. Leave a small cross-runtime tolerance; reject zero/garbage.
|
|
50
|
+
return normSq >= 0.95 * 0.95 && normSq <= 1.05 * 1.05;
|
|
51
|
+
}
|
|
52
|
+
function validSources(mask, sources) {
|
|
53
|
+
if ((sources & ~AVATAR_POSE_SOURCE_ALL) !== 0)
|
|
54
|
+
return false;
|
|
55
|
+
if (has(mask, AvatarPoseMask.Head) !== has(sources, AvatarPoseSource.Headset))
|
|
56
|
+
return false;
|
|
57
|
+
const leftSources = Number(has(sources, AvatarPoseSource.LeftController)) + Number(has(sources, AvatarPoseSource.LeftHand));
|
|
58
|
+
const rightSources = Number(has(sources, AvatarPoseSource.RightController)) + Number(has(sources, AvatarPoseSource.RightHand));
|
|
59
|
+
if (leftSources !== (has(mask, AvatarPoseMask.LeftPalm) ? 1 : 0))
|
|
60
|
+
return false;
|
|
61
|
+
if (rightSources !== (has(mask, AvatarPoseMask.RightPalm) ? 1 : 0))
|
|
62
|
+
return false;
|
|
63
|
+
if (has(mask, AvatarPoseMask.LeftFingers) && !has(mask, AvatarPoseMask.LeftPalm))
|
|
64
|
+
return false;
|
|
65
|
+
if (has(mask, AvatarPoseMask.RightFingers) && !has(mask, AvatarPoseMask.RightPalm))
|
|
66
|
+
return false;
|
|
67
|
+
return true;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Validate an untrusted compact group without throwing. The room treats `null` as a neutral avatar pose while
|
|
71
|
+
* still applying the ordinary locomotion frame; malformed optional embodiment must never freeze movement.
|
|
72
|
+
*/
|
|
73
|
+
export function sanitizeAvatarPoseWire(value) {
|
|
74
|
+
if (typeof value !== 'object' || value === null || Array.isArray(value))
|
|
75
|
+
return null;
|
|
76
|
+
const pose = value;
|
|
77
|
+
if (pose.v !== AVATAR_POSE_VERSION || !integerWithin(pose.m, 0, AVATAR_POSE_MASK_ALL) || !integerWithin(pose.s, 0, AVATAR_POSE_SOURCE_ALL))
|
|
78
|
+
return null;
|
|
79
|
+
const mask = pose.m;
|
|
80
|
+
const sources = pose.s;
|
|
81
|
+
if (!validSources(mask, sources))
|
|
82
|
+
return null;
|
|
83
|
+
const wantsHead = has(mask, AvatarPoseMask.Head);
|
|
84
|
+
const wantsLeftPalm = has(mask, AvatarPoseMask.LeftPalm);
|
|
85
|
+
const wantsRightPalm = has(mask, AvatarPoseMask.RightPalm);
|
|
86
|
+
const wantsLeftFingers = has(mask, AvatarPoseMask.LeftFingers);
|
|
87
|
+
const wantsRightFingers = has(mask, AvatarPoseMask.RightFingers);
|
|
88
|
+
if (wantsHead !== (pose.h !== undefined))
|
|
89
|
+
return null;
|
|
90
|
+
if (wantsLeftPalm !== (pose.lp !== undefined))
|
|
91
|
+
return null;
|
|
92
|
+
if (wantsRightPalm !== (pose.rp !== undefined))
|
|
93
|
+
return null;
|
|
94
|
+
if (wantsLeftFingers !== (pose.lc !== undefined))
|
|
95
|
+
return null;
|
|
96
|
+
if (wantsRightFingers !== (pose.rc !== undefined))
|
|
97
|
+
return null;
|
|
98
|
+
if (pose.h !== undefined) {
|
|
99
|
+
if (!Array.isArray(pose.h) || pose.h.length !== 4)
|
|
100
|
+
return null;
|
|
101
|
+
if (!integerWithin(pose.h[0], -AVATAR_POSE_LIMITS.headHorizontalCm, AVATAR_POSE_LIMITS.headHorizontalCm))
|
|
102
|
+
return null;
|
|
103
|
+
if (!integerWithin(pose.h[1], AVATAR_POSE_LIMITS.minHeadHeightCm, AVATAR_POSE_LIMITS.maxHeadHeightCm))
|
|
104
|
+
return null;
|
|
105
|
+
if (!integerWithin(pose.h[2], -AVATAR_POSE_LIMITS.headHorizontalCm, AVATAR_POSE_LIMITS.headHorizontalCm))
|
|
106
|
+
return null;
|
|
107
|
+
if (!integerWithin(pose.h[3], -AVATAR_POSE_LIMITS.headRollDeciDeg, AVATAR_POSE_LIMITS.headRollDeciDeg))
|
|
108
|
+
return null;
|
|
109
|
+
}
|
|
110
|
+
if (pose.lp !== undefined && !validQuatI16(pose.lp))
|
|
111
|
+
return null;
|
|
112
|
+
if (pose.rp !== undefined && !validQuatI16(pose.rp))
|
|
113
|
+
return null;
|
|
114
|
+
if (pose.lc !== undefined && !validTuple(pose.lc, 5, 0, AVATAR_POSE_LIMITS.curlMax))
|
|
115
|
+
return null;
|
|
116
|
+
if (pose.rc !== undefined && !validTuple(pose.rc, 5, 0, AVATAR_POSE_LIMITS.curlMax))
|
|
117
|
+
return null;
|
|
118
|
+
// Copy into plain fixed tuples. Never let a decoded payload's mutable arrays become authoritative state.
|
|
119
|
+
return {
|
|
120
|
+
v: AVATAR_POSE_VERSION,
|
|
121
|
+
m: mask,
|
|
122
|
+
s: sources,
|
|
123
|
+
...(pose.h !== undefined ? { h: [...pose.h] } : {}),
|
|
124
|
+
...(pose.lp !== undefined ? { lp: normalizeQuatI16(pose.lp) } : {}),
|
|
125
|
+
...(pose.rp !== undefined ? { rp: normalizeQuatI16(pose.rp) } : {}),
|
|
126
|
+
...(pose.lc !== undefined ? { lc: [...pose.lc] } : {}),
|
|
127
|
+
...(pose.rc !== undefined ? { rc: [...pose.rc] } : {}),
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
function normalizeQuat(quat) {
|
|
131
|
+
if (![quat.x, quat.y, quat.z, quat.w].every(Number.isFinite))
|
|
132
|
+
return null;
|
|
133
|
+
const norm = Math.hypot(quat.x, quat.y, quat.z, quat.w);
|
|
134
|
+
if (norm < 1e-6)
|
|
135
|
+
return null;
|
|
136
|
+
// Canonical hemisphere prevents q/-q patch churn. w alone cannot choose when w=0, so use a stable
|
|
137
|
+
// lexicographic tie-break (w, z, y, x): the first non-zero component is always positive.
|
|
138
|
+
const firstNonZero = [quat.w, quat.z, quat.y, quat.x].find((part) => part !== 0) ?? 0;
|
|
139
|
+
const sign = firstNonZero < 0 ? -1 : 1;
|
|
140
|
+
const normalized = (part) => {
|
|
141
|
+
const value = sign * part / norm;
|
|
142
|
+
return value === 0 ? 0 : value; // collapse -0 so byte output is identical cross-runtime
|
|
143
|
+
};
|
|
144
|
+
return { x: normalized(quat.x), y: normalized(quat.y), z: normalized(quat.z), w: normalized(quat.w) };
|
|
145
|
+
}
|
|
146
|
+
function quantizeQuat(quat) {
|
|
147
|
+
if (!quat)
|
|
148
|
+
return null;
|
|
149
|
+
const q = normalizeQuat(quat);
|
|
150
|
+
if (!q)
|
|
151
|
+
return null;
|
|
152
|
+
const scale = AVATAR_POSE_LIMITS.quaternionScale;
|
|
153
|
+
return [q.x, q.y, q.z, q.w].map((part) => {
|
|
154
|
+
const value = Math.max(-scale, Math.min(scale, Math.round(part * scale)));
|
|
155
|
+
return value === 0 ? 0 : value;
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
function normalizeQuatI16(quat) {
|
|
159
|
+
const scale = AVATAR_POSE_LIMITS.quaternionScale;
|
|
160
|
+
const normalized = normalizeQuat({ x: quat[0] / scale, y: quat[1] / scale, z: quat[2] / scale, w: quat[3] / scale });
|
|
161
|
+
return quantizeQuat(normalized);
|
|
162
|
+
}
|
|
163
|
+
function quantizeCurls(curls) {
|
|
164
|
+
if (!curls || curls.length !== 5 || !curls.every(Number.isFinite))
|
|
165
|
+
return null;
|
|
166
|
+
return curls.map((curl) => Math.round(Math.max(0, Math.min(1, curl)) * AVATAR_POSE_LIMITS.curlMax));
|
|
167
|
+
}
|
|
168
|
+
/** Encode the engine-facing float pose into the compact state-lane group. Invalid semantics fail neutral. */
|
|
169
|
+
export function encodeAvatarPose(input) {
|
|
170
|
+
if (!input || input.v !== AVATAR_POSE_VERSION || !integerWithin(input.mask, 0, AVATAR_POSE_MASK_ALL) || !integerWithin(input.sources, 0, AVATAR_POSE_SOURCE_ALL))
|
|
171
|
+
return null;
|
|
172
|
+
if (!validSources(input.mask, input.sources))
|
|
173
|
+
return null;
|
|
174
|
+
const head = has(input.mask, AvatarPoseMask.Head);
|
|
175
|
+
const leftPalm = has(input.mask, AvatarPoseMask.LeftPalm);
|
|
176
|
+
const rightPalm = has(input.mask, AvatarPoseMask.RightPalm);
|
|
177
|
+
const leftFingers = has(input.mask, AvatarPoseMask.LeftFingers);
|
|
178
|
+
const rightFingers = has(input.mask, AvatarPoseMask.RightFingers);
|
|
179
|
+
if (head && (!input.headOffset || ![input.headOffset.x, input.headOffset.y, input.headOffset.z, input.headRollDeg].every((v) => typeof v === 'number' && Number.isFinite(v))))
|
|
180
|
+
return null;
|
|
181
|
+
if (!head && (input.headOffset !== undefined || input.headRollDeg !== undefined))
|
|
182
|
+
return null;
|
|
183
|
+
const lp = leftPalm ? quantizeQuat(input.leftPalm) : null;
|
|
184
|
+
const rp = rightPalm ? quantizeQuat(input.rightPalm) : null;
|
|
185
|
+
const lc = leftFingers ? quantizeCurls(input.leftCurls) : null;
|
|
186
|
+
const rc = rightFingers ? quantizeCurls(input.rightCurls) : null;
|
|
187
|
+
if ((leftPalm && !lp) || (!leftPalm && input.leftPalm !== undefined))
|
|
188
|
+
return null;
|
|
189
|
+
if ((rightPalm && !rp) || (!rightPalm && input.rightPalm !== undefined))
|
|
190
|
+
return null;
|
|
191
|
+
if ((leftFingers && !lc) || (!leftFingers && input.leftCurls !== undefined))
|
|
192
|
+
return null;
|
|
193
|
+
if ((rightFingers && !rc) || (!rightFingers && input.rightCurls !== undefined))
|
|
194
|
+
return null;
|
|
195
|
+
const clamp = (n, min, max) => Math.round(Math.max(min, Math.min(max, n)));
|
|
196
|
+
const wire = {
|
|
197
|
+
v: AVATAR_POSE_VERSION,
|
|
198
|
+
m: input.mask,
|
|
199
|
+
s: input.sources,
|
|
200
|
+
...(head ? {
|
|
201
|
+
h: [
|
|
202
|
+
clamp(input.headOffset.x * 100, -AVATAR_POSE_LIMITS.headHorizontalCm, AVATAR_POSE_LIMITS.headHorizontalCm),
|
|
203
|
+
clamp(input.headOffset.y * 100, AVATAR_POSE_LIMITS.minHeadHeightCm, AVATAR_POSE_LIMITS.maxHeadHeightCm),
|
|
204
|
+
clamp(input.headOffset.z * 100, -AVATAR_POSE_LIMITS.headHorizontalCm, AVATAR_POSE_LIMITS.headHorizontalCm),
|
|
205
|
+
clamp(input.headRollDeg * 10, -AVATAR_POSE_LIMITS.headRollDeciDeg, AVATAR_POSE_LIMITS.headRollDeciDeg),
|
|
206
|
+
],
|
|
207
|
+
} : {}),
|
|
208
|
+
...(lp ? { lp } : {}),
|
|
209
|
+
...(rp ? { rp } : {}),
|
|
210
|
+
...(lc ? { lc } : {}),
|
|
211
|
+
...(rc ? { rc } : {}),
|
|
212
|
+
};
|
|
213
|
+
return sanitizeAvatarPoseWire(wire);
|
|
214
|
+
}
|
|
215
|
+
function dequantizeQuat(quat) {
|
|
216
|
+
const scale = AVATAR_POSE_LIMITS.quaternionScale;
|
|
217
|
+
return normalizeQuat({ x: quat[0] / scale, y: quat[1] / scale, z: quat[2] / scale, w: quat[3] / scale });
|
|
218
|
+
}
|
|
219
|
+
/** Decode an inbound compact group for tests/non-Colyseus consumers. Invalid input returns neutral. */
|
|
220
|
+
export function decodeAvatarPoseWire(value) {
|
|
221
|
+
const pose = sanitizeAvatarPoseWire(value);
|
|
222
|
+
if (!pose || pose.m === 0)
|
|
223
|
+
return null;
|
|
224
|
+
return {
|
|
225
|
+
v: AVATAR_POSE_VERSION,
|
|
226
|
+
mask: pose.m,
|
|
227
|
+
sources: pose.s,
|
|
228
|
+
...(pose.h ? { headOffset: { x: pose.h[0] / 100, y: pose.h[1] / 100, z: pose.h[2] / 100 }, headRollDeg: pose.h[3] / 10 } : {}),
|
|
229
|
+
...(pose.lp ? { leftPalm: dequantizeQuat(pose.lp) } : {}),
|
|
230
|
+
...(pose.rp ? { rightPalm: dequantizeQuat(pose.rp) } : {}),
|
|
231
|
+
...(pose.lc ? { leftCurls: pose.lc.map((v) => v / AVATAR_POSE_LIMITS.curlMax) } : {}),
|
|
232
|
+
...(pose.rc ? { rightCurls: pose.rc.map((v) => v / AVATAR_POSE_LIMITS.curlMax) } : {}),
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
/** Decode the reflected, quantized PlayerState child. Missing/old-room/neutral state returns null. */
|
|
236
|
+
export function decodeAvatarPoseReplica(value) {
|
|
237
|
+
if (!value || value.version !== AVATAR_POSE_VERSION || value.mask === 0)
|
|
238
|
+
return null;
|
|
239
|
+
return decodeAvatarPoseWire({
|
|
240
|
+
v: value.version,
|
|
241
|
+
m: value.mask,
|
|
242
|
+
s: value.sources,
|
|
243
|
+
...(has(value.mask, AvatarPoseMask.Head) ? { h: [value.headXCm, value.headYCm, value.headZCm, value.headRollDeciDeg] } : {}),
|
|
244
|
+
...(has(value.mask, AvatarPoseMask.LeftPalm) ? { lp: [value.leftPalmX, value.leftPalmY, value.leftPalmZ, value.leftPalmW] } : {}),
|
|
245
|
+
...(has(value.mask, AvatarPoseMask.RightPalm) ? { rp: [value.rightPalmX, value.rightPalmY, value.rightPalmZ, value.rightPalmW] } : {}),
|
|
246
|
+
...(has(value.mask, AvatarPoseMask.LeftFingers) ? { lc: [value.leftThumb, value.leftIndex, value.leftMiddle, value.leftRing, value.leftLittle] } : {}),
|
|
247
|
+
...(has(value.mask, AvatarPoseMask.RightFingers) ? { rc: [value.rightThumb, value.rightIndex, value.rightMiddle, value.rightRing, value.rightLittle] } : {}),
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
//# sourceMappingURL=avatar-pose.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"avatar-pose.js","sourceRoot":"","sources":["../../src/multiplayer-contract/avatar-pose.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAU,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,CAAC,IAAI,CAAC;IACZ,QAAQ,EAAE,CAAC,IAAI,CAAC;IAChB,SAAS,EAAE,CAAC,IAAI,CAAC;IACjB,WAAW,EAAE,CAAC,IAAI,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,CAAC;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,cAAc,EAAE,CAAC,IAAI,CAAC;IACtB,eAAe,EAAE,CAAC,IAAI,CAAC;IACvB,QAAQ,EAAE,CAAC,IAAI,CAAC;IAChB,SAAS,EAAE,CAAC,IAAI,CAAC;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,2CAA2C;IAC3C,gBAAgB,EAAE,GAAG;IACrB,oFAAoF;IACpF,eAAe,EAAE,CAAC,EAAE;IACpB,eAAe,EAAE,GAAG;IACpB,qDAAqD;IACrD,eAAe,EAAE,IAAI;IACrB,gDAAgD;IAChD,eAAe,EAAE,KAAK;IACtB,OAAO,EAAE,GAAG;CACJ,CAAC;AAsEX,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,GAAW,EAAE,GAAW,EAAmB,EAAE,CAClF,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AAEvF,SAAS,GAAG,CAAC,IAAY,EAAE,GAAW;IACpC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,GAAW,EAAE,GAAW;IAC1E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACjH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,eAAe,CAAC;QAAE,OAAO,KAAK,CAAC;IACjH,MAAM,KAAK,GAAG,kBAAkB,CAAC,eAAe,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,2GAA2G;IAC3G,OAAO,MAAM,IAAI,IAAI,GAAG,IAAI,IAAI,MAAM,IAAI,IAAI,GAAG,IAAI,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,OAAe;IACjD,IAAI,CAAC,OAAO,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5F,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5H,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/H,IAAI,WAAW,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/E,IAAI,YAAY,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,IAAI,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/F,IAAI,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACjG,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,IAAI,IAAI,CAAC,CAAC,KAAK,mBAAmB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IACxJ,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAAG,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IACjE,IAAI,SAAS,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,aAAa,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,cAAc,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,gBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,iBAAiB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/D,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,gBAAgB,CAAC;YAAE,OAAO,IAAI,CAAC;QACtH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,eAAe,CAAC;YAAE,OAAO,IAAI,CAAC;QACnH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,gBAAgB,CAAC;YAAE,OAAO,IAAI,CAAC;QACtH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,eAAe,CAAC;YAAE,OAAO,IAAI,CAAC;IACtH,CAAC;IACD,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjG,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjG,yGAAyG;IACzG,OAAO;QACL,CAAC,EAAE,mBAAmB;QACtB,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,OAAO;QACV,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAU;IAC/B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,kGAAkG;IAClG,yFAAyF;IACzF,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;QAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACjC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,wDAAwD;IAC1F,CAAC,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACxG,CAAC;AAED,SAAS,YAAY,CAAC,IAAsB;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,KAAK,GAAG,kBAAkB,CAAC,eAAe,CAAC;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjC,CAAC,CAAY,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IACrC,MAAM,KAAK,GAAG,kBAAkB,CAAC,eAAe,CAAC;IACjD,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;IACrH,OAAO,YAAY,CAAC,UAAW,CAAE,CAAC;AACpC,CAAC;AAED,SAAS,aAAa,CAAC,KAA8B;IACnD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAkB,CAAC;AACvH,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,gBAAgB,CAAC,KAA2C;IAC1E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,KAAK,mBAAmB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9K,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3L,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9F,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,IAAI,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACzF,IAAI,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5F,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAqB;QAC7B,CAAC,EAAE,mBAAmB;QACtB,CAAC,EAAE,KAAK,CAAC,IAAI;QACb,CAAC,EAAE,KAAK,CAAC,OAAO;QAChB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACT,CAAC,EAAE;gBACD,KAAK,CAAC,KAAK,CAAC,UAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,gBAAgB,CAAC;gBAC3G,KAAK,CAAC,KAAK,CAAC,UAAW,CAAC,CAAC,GAAG,GAAG,EAAE,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,eAAe,CAAC;gBACxG,KAAK,CAAC,KAAK,CAAC,UAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,gBAAgB,CAAC;gBAC3G,KAAK,CAAC,KAAK,CAAC,WAAY,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,eAAe,CAAC;aACzF;SACjB,CAAC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,MAAM,KAAK,GAAG,kBAAkB,CAAC,eAAe,CAAC;IACjD,OAAO,aAAa,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAE,CAAC;AAC5G,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO;QACL,CAAC,EAAE,mBAAmB;QACtB,IAAI,EAAE,IAAI,CAAC,CAAC;QACZ,OAAO,EAAE,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9H,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAA2B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/G,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAA2B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjH,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,uBAAuB,CAAC,KAAkD;IACxF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,OAAO,oBAAoB,CAAC;QAC1B,CAAC,EAAE,KAAK,CAAC,OAAO;QAChB,CAAC,EAAE,KAAK,CAAC,IAAI;QACb,CAAC,EAAE,KAAK,CAAC,OAAO;QAChB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5H,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtJ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7J,CAAC,CAAC;AACL,CAAC"}
|