@1337exp/pkt-threejs-blueprint 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/LICENSE +21 -0
- package/README.md +69 -2
- package/README.ru.md +70 -0
- package/dist/components/vue/tuning-panel.d.ts +74 -0
- package/dist/components/vue/tuning-panel.js +155 -0
- package/dist/components/vue/tuning-panel.js.map +1 -0
- package/dist/core/ease.d.ts +20 -0
- package/dist/core/ease.js +19 -0
- package/dist/core/ease.js.map +1 -0
- package/dist/core/loop.d.ts +37 -0
- package/dist/core/loop.js +47 -0
- package/dist/core/loop.js.map +1 -0
- package/dist/core/rng.d.ts +16 -0
- package/dist/core/rng.js +23 -0
- package/dist/core/rng.js.map +1 -0
- package/dist/core/spring.d.ts +38 -0
- package/dist/core/spring.js +91 -0
- package/dist/core/spring.js.map +1 -0
- package/dist/core/ticker.d.ts +44 -0
- package/dist/core/ticker.js +71 -0
- package/dist/core/ticker.js.map +1 -0
- package/dist/core/tuning.d.ts +74 -0
- package/dist/core/tuning.js +117 -0
- package/dist/core/tuning.js.map +1 -0
- package/dist/three/dispose.d.ts +19 -0
- package/dist/three/dispose.js +47 -0
- package/dist/three/dispose.js.map +1 -0
- package/dist/three/pointer.d.ts +34 -0
- package/dist/three/pointer.js +28 -0
- package/dist/three/pointer.js.map +1 -0
- package/dist/three/renderer.d.ts +36 -0
- package/dist/three/renderer.js +41 -0
- package/dist/three/renderer.js.map +1 -0
- package/package.json +104 -4
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Anything with x, y, z: `THREE.Vector3` fits, and the core does not import three.
|
|
3
|
+
* Всё, у чего есть x, y, z: подходит `THREE.Vector3`, а ядро three не импортирует.
|
|
4
|
+
*/
|
|
5
|
+
export interface Vec3Like {
|
|
6
|
+
x: number;
|
|
7
|
+
y: number;
|
|
8
|
+
z: number;
|
|
9
|
+
}
|
|
10
|
+
/** A number and its velocity. / Число и его скорость. */
|
|
11
|
+
export interface SpringState {
|
|
12
|
+
x: number;
|
|
13
|
+
v: number;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* A damped spring: lively motion (hover, drag, layout) goes through it.
|
|
17
|
+
* `zeta < 1` overshoots and wobbles, `1` arrives without overshoot, `> 1` is sluggish.
|
|
18
|
+
* Пружина с затуханием: всё «живое» движение (наведение, перетаскивание, раскладка) идёт через неё.
|
|
19
|
+
* `zeta < 1` с перелётом и покачиванием, `1` ровно приходит в цель, `> 1` вязко.
|
|
20
|
+
*/
|
|
21
|
+
export interface Spring {
|
|
22
|
+
stiffness: number;
|
|
23
|
+
damping: number;
|
|
24
|
+
}
|
|
25
|
+
/** Build a spring from stiffness and damping ratio. / Собрать пружину из жёсткости и коэффициента затухания. */
|
|
26
|
+
export declare function spring(stiffness: number, zeta: number): Spring;
|
|
27
|
+
/**
|
|
28
|
+
* One step for a number, in place. Exact for a fixed target and stable for any `dt`: the same time gives the same
|
|
29
|
+
* result at 30, 60 or 144 frames per second. A target that moves is sampled once per step, as in any per-frame code.
|
|
30
|
+
* Шаг для числа на месте. Точен при неподвижной цели и устойчив при любом `dt`: одно и то же время даёт один и тот же
|
|
31
|
+
* результат на 30, 60 или 144 кадрах в секунду. Движущаяся цель берётся раз за шаг, как в любом покадровом коде.
|
|
32
|
+
*/
|
|
33
|
+
export declare function stepSpring(state: SpringState, target: number, s: Spring, dt: number): void;
|
|
34
|
+
/**
|
|
35
|
+
* One step for a vector: changes `pos` and `vel` in place. Same guarantees as {@link stepSpring}.
|
|
36
|
+
* Шаг для вектора: меняет `pos` и `vel` на месте. Те же гарантии, что у {@link stepSpring}.
|
|
37
|
+
*/
|
|
38
|
+
export declare function stepSpring3(pos: Vec3Like, vel: Vec3Like, target: Vec3Like, s: Spring, dt: number): void;
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/** Build a spring from stiffness and damping ratio. / Собрать пружину из жёсткости и коэффициента затухания. */
|
|
2
|
+
export function spring(stiffness, zeta) {
|
|
3
|
+
return { stiffness, damping: 2 * Math.sqrt(stiffness) * zeta };
|
|
4
|
+
}
|
|
5
|
+
/**
|
|
6
|
+
* The spring's step as a matrix: over `dt` the offset `y = x - target` and the velocity `v` become
|
|
7
|
+
* `y' = a·y + b·v`, `v' = c·y + d·v`. These are the exact solutions of `x'' = -stiffness·y - damping·x'`
|
|
8
|
+
* (a matrix exponential), so the step is stable for any `dt` and splitting it into several steps changes nothing.
|
|
9
|
+
* The three cases are by the sign of `damping² - 4·stiffness`: under- (cos, sin), critically and over-damped.
|
|
10
|
+
* Шаг пружины в виде матрицы: за `dt` смещение `y = x - target` и скорость `v` становятся
|
|
11
|
+
* `y' = a·y + b·v`, `v' = c·y + d·v`. Это точные решения `x'' = -stiffness·y - damping·x'` (матричная экспонента),
|
|
12
|
+
* поэтому шаг устойчив при любом `dt`, а деление его на несколько шагов ничего не меняет.
|
|
13
|
+
* Три случая по знаку `damping² - 4·stiffness`: недодемпфированный (cos, sin), критический и передемпфированный.
|
|
14
|
+
*/
|
|
15
|
+
const m = { a: 1, b: 0, c: 0, d: 1 };
|
|
16
|
+
function transition(s, dt) {
|
|
17
|
+
const k = s.stiffness;
|
|
18
|
+
const alpha = s.damping / 2;
|
|
19
|
+
const disc = alpha * alpha - k;
|
|
20
|
+
// Relative tolerance: closer than this to critical, the critical formula is exact to well below a pixel.
|
|
21
|
+
// Относительный допуск: ближе этого к критическому критическая формула точна с запасом до долей пикселя.
|
|
22
|
+
const eps = 1e-9 * (alpha * alpha + k);
|
|
23
|
+
if (Math.abs(disc) <= eps) {
|
|
24
|
+
const e = Math.exp(-alpha * dt);
|
|
25
|
+
m.a = e * (1 + alpha * dt);
|
|
26
|
+
m.b = e * dt;
|
|
27
|
+
m.c = -e * alpha * alpha * dt;
|
|
28
|
+
m.d = e * (1 - alpha * dt);
|
|
29
|
+
}
|
|
30
|
+
else if (disc < 0) {
|
|
31
|
+
const w = Math.sqrt(-disc);
|
|
32
|
+
const e = Math.exp(-alpha * dt);
|
|
33
|
+
const cs = Math.cos(w * dt);
|
|
34
|
+
const sn = Math.sin(w * dt);
|
|
35
|
+
m.a = e * (cs + (alpha / w) * sn);
|
|
36
|
+
m.b = (e * sn) / w;
|
|
37
|
+
m.c = -((e * k) / w) * sn;
|
|
38
|
+
m.d = e * (cs - (alpha / w) * sn);
|
|
39
|
+
}
|
|
40
|
+
else {
|
|
41
|
+
// e·cosh and e·sinh written through the two decaying exponentials: no overflow on a long step.
|
|
42
|
+
// e·cosh и e·sinh через две затухающие экспоненты: без переполнения на длинном шаге.
|
|
43
|
+
const r = Math.sqrt(disc);
|
|
44
|
+
const e1 = Math.exp(-(alpha - r) * dt);
|
|
45
|
+
const e2 = Math.exp(-(alpha + r) * dt);
|
|
46
|
+
const ch = (e1 + e2) / 2;
|
|
47
|
+
const sh = (e1 - e2) / 2;
|
|
48
|
+
m.a = ch + (alpha / r) * sh;
|
|
49
|
+
m.b = sh / r;
|
|
50
|
+
m.c = -(k / r) * sh;
|
|
51
|
+
m.d = ch - (alpha / r) * sh;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* One step for a number, in place. Exact for a fixed target and stable for any `dt`: the same time gives the same
|
|
56
|
+
* result at 30, 60 or 144 frames per second. A target that moves is sampled once per step, as in any per-frame code.
|
|
57
|
+
* Шаг для числа на месте. Точен при неподвижной цели и устойчив при любом `dt`: одно и то же время даёт один и тот же
|
|
58
|
+
* результат на 30, 60 или 144 кадрах в секунду. Движущаяся цель берётся раз за шаг, как в любом покадровом коде.
|
|
59
|
+
*/
|
|
60
|
+
export function stepSpring(state, target, s, dt) {
|
|
61
|
+
if (!(dt > 0))
|
|
62
|
+
return;
|
|
63
|
+
transition(s, dt);
|
|
64
|
+
const y = state.x - target;
|
|
65
|
+
const v = state.v;
|
|
66
|
+
state.x = target + m.a * y + m.b * v;
|
|
67
|
+
state.v = m.c * y + m.d * v;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* One step for a vector: changes `pos` and `vel` in place. Same guarantees as {@link stepSpring}.
|
|
71
|
+
* Шаг для вектора: меняет `pos` и `vel` на месте. Те же гарантии, что у {@link stepSpring}.
|
|
72
|
+
*/
|
|
73
|
+
export function stepSpring3(pos, vel, target, s, dt) {
|
|
74
|
+
if (!(dt > 0))
|
|
75
|
+
return;
|
|
76
|
+
transition(s, dt);
|
|
77
|
+
const { a, b, c, d } = m;
|
|
78
|
+
const yx = pos.x - target.x;
|
|
79
|
+
const yy = pos.y - target.y;
|
|
80
|
+
const yz = pos.z - target.z;
|
|
81
|
+
const vx = vel.x;
|
|
82
|
+
const vy = vel.y;
|
|
83
|
+
const vz = vel.z;
|
|
84
|
+
pos.x = target.x + a * yx + b * vx;
|
|
85
|
+
pos.y = target.y + a * yy + b * vy;
|
|
86
|
+
pos.z = target.z + a * yz + b * vz;
|
|
87
|
+
vel.x = c * yx + d * vx;
|
|
88
|
+
vel.y = c * yy + d * vy;
|
|
89
|
+
vel.z = c * yz + d * vz;
|
|
90
|
+
}
|
|
91
|
+
//# sourceMappingURL=spring.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spring.js","sourceRoot":"","sources":["../../src/core/spring.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { type Ease } from './ease.js';
|
|
2
|
+
/**
|
|
3
|
+
* A function the ticker calls every update. Return `false` to remove it.
|
|
4
|
+
* Функция, которую тикер зовёт на каждом обновлении. Вернул `false` — снимается.
|
|
5
|
+
*/
|
|
6
|
+
export type TickFn = (dt: number, time: number) => boolean | void;
|
|
7
|
+
/**
|
|
8
|
+
* Game time. Tweens and pauses count frames, not `setTimeout`: pause or slow the game and everything slows at once.
|
|
9
|
+
* Feed it the real frame delta (already capped, see the `maxDt` notes in the docs); it scales that by `speed`.
|
|
10
|
+
*
|
|
11
|
+
* Игровое время. Твины и паузы считаются по кадрам, а не по `setTimeout`: поставил игру на паузу или замедлил,
|
|
12
|
+
* и замедлилось всё сразу. Подавай реальную дельту кадра (уже ограниченную сверху, см. заметки про `maxDt` в документации);
|
|
13
|
+
* тикер умножает её на `speed`.
|
|
14
|
+
*/
|
|
15
|
+
export declare class Ticker {
|
|
16
|
+
/** Game seconds since creation. / Игровые секунды с создания. */
|
|
17
|
+
time: number;
|
|
18
|
+
/** Speed multiplier: 0.25 is slow motion, 0 is a full stop (hit-stop). / Множитель скорости: 0.25 — замедление, 0 — полная остановка (hit-stop). */
|
|
19
|
+
speed: number;
|
|
20
|
+
private readonly fns;
|
|
21
|
+
/** True while something is subscribed (a tween in flight, a running effect). / Пока что-то подписано (идёт твин, работает эффект). */
|
|
22
|
+
get busy(): boolean;
|
|
23
|
+
/** Subscribe; returns the function that unsubscribes. / Подписать; возвращает функцию отписки. */
|
|
24
|
+
add(fn: TickFn): () => void;
|
|
25
|
+
/**
|
|
26
|
+
* Advance by a real frame delta, in seconds. Returns the game delta (`realDt * speed`).
|
|
27
|
+
* A function removed by an earlier one during the same update is not called.
|
|
28
|
+
* Продвинуть на реальную дельту кадра в секундах. Возвращает игровую дельту (`realDt * speed`).
|
|
29
|
+
* Функция, которую в этом же обновлении отписала предыдущая, не вызывается.
|
|
30
|
+
*/
|
|
31
|
+
update(realDt: number): number;
|
|
32
|
+
/**
|
|
33
|
+
* Tween: `onUpdate` gets the progress 0…1 after the curve; the last call is exactly `ease(1)`. The promise resolves after it.
|
|
34
|
+
* Твин: `onUpdate` получает прогресс 0…1 уже после кривой; последний вызов ровно `ease(1)`. Обещание выполняется после него.
|
|
35
|
+
*/
|
|
36
|
+
tween(duration: number, onUpdate: (k: number) => void, ease?: Ease): Promise<void>;
|
|
37
|
+
/** Pause for game seconds. / Пауза в игровых секундах. */
|
|
38
|
+
wait(seconds: number): Promise<void>;
|
|
39
|
+
/**
|
|
40
|
+
* Drop every subscription (scene teardown). Promises of dropped tweens never resolve: do not `await` them across a teardown.
|
|
41
|
+
* Снять все подписки (разбор сцены). Обещания снятых твинов не выполняются: не жди их через разбор.
|
|
42
|
+
*/
|
|
43
|
+
clear(): void;
|
|
44
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { linear } from './ease.js';
|
|
2
|
+
/**
|
|
3
|
+
* Game time. Tweens and pauses count frames, not `setTimeout`: pause or slow the game and everything slows at once.
|
|
4
|
+
* Feed it the real frame delta (already capped, see the `maxDt` notes in the docs); it scales that by `speed`.
|
|
5
|
+
*
|
|
6
|
+
* Игровое время. Твины и паузы считаются по кадрам, а не по `setTimeout`: поставил игру на паузу или замедлил,
|
|
7
|
+
* и замедлилось всё сразу. Подавай реальную дельту кадра (уже ограниченную сверху, см. заметки про `maxDt` в документации);
|
|
8
|
+
* тикер умножает её на `speed`.
|
|
9
|
+
*/
|
|
10
|
+
export class Ticker {
|
|
11
|
+
/** Game seconds since creation. / Игровые секунды с создания. */
|
|
12
|
+
time = 0;
|
|
13
|
+
/** Speed multiplier: 0.25 is slow motion, 0 is a full stop (hit-stop). / Множитель скорости: 0.25 — замедление, 0 — полная остановка (hit-stop). */
|
|
14
|
+
speed = 1;
|
|
15
|
+
fns = new Set();
|
|
16
|
+
/** True while something is subscribed (a tween in flight, a running effect). / Пока что-то подписано (идёт твин, работает эффект). */
|
|
17
|
+
get busy() {
|
|
18
|
+
return this.fns.size > 0;
|
|
19
|
+
}
|
|
20
|
+
/** Subscribe; returns the function that unsubscribes. / Подписать; возвращает функцию отписки. */
|
|
21
|
+
add(fn) {
|
|
22
|
+
this.fns.add(fn);
|
|
23
|
+
return () => this.fns.delete(fn);
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Advance by a real frame delta, in seconds. Returns the game delta (`realDt * speed`).
|
|
27
|
+
* A function removed by an earlier one during the same update is not called.
|
|
28
|
+
* Продвинуть на реальную дельту кадра в секундах. Возвращает игровую дельту (`realDt * speed`).
|
|
29
|
+
* Функция, которую в этом же обновлении отписала предыдущая, не вызывается.
|
|
30
|
+
*/
|
|
31
|
+
update(realDt) {
|
|
32
|
+
const dt = realDt * this.speed;
|
|
33
|
+
this.time += dt;
|
|
34
|
+
for (const fn of [...this.fns]) {
|
|
35
|
+
if (!this.fns.has(fn))
|
|
36
|
+
continue;
|
|
37
|
+
if (fn(dt, this.time) === false)
|
|
38
|
+
this.fns.delete(fn);
|
|
39
|
+
}
|
|
40
|
+
return dt;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Tween: `onUpdate` gets the progress 0…1 after the curve; the last call is exactly `ease(1)`. The promise resolves after it.
|
|
44
|
+
* Твин: `onUpdate` получает прогресс 0…1 уже после кривой; последний вызов ровно `ease(1)`. Обещание выполняется после него.
|
|
45
|
+
*/
|
|
46
|
+
tween(duration, onUpdate, ease = linear) {
|
|
47
|
+
return new Promise((resolve) => {
|
|
48
|
+
let t = 0;
|
|
49
|
+
this.add((dt) => {
|
|
50
|
+
t = Math.min(duration, t + dt);
|
|
51
|
+
onUpdate(ease(duration > 0 ? t / duration : 1));
|
|
52
|
+
if (t >= duration) {
|
|
53
|
+
resolve();
|
|
54
|
+
return false;
|
|
55
|
+
}
|
|
56
|
+
});
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
/** Pause for game seconds. / Пауза в игровых секундах. */
|
|
60
|
+
wait(seconds) {
|
|
61
|
+
return this.tween(seconds, () => { });
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Drop every subscription (scene teardown). Promises of dropped tweens never resolve: do not `await` them across a teardown.
|
|
65
|
+
* Снять все подписки (разбор сцены). Обещания снятых твинов не выполняются: не жди их через разбор.
|
|
66
|
+
*/
|
|
67
|
+
clear() {
|
|
68
|
+
this.fns.clear();
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
//# sourceMappingURL=ticker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ticker.js","sourceRoot":"","sources":["../../src/core/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,WAAW,CAAC;AAQ9C;;;;;;;GAOG;AACH,MAAM,OAAO,MAAM;IACf,iEAAiE;IACjE,IAAI,GAAG,CAAC,CAAC;IACT,oJAAoJ;IACpJ,KAAK,GAAG,CAAC,CAAC;IACO,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,sIAAsI;IACtI,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,kGAAkG;IAClG,GAAG,CAAC,EAAU;QACV,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAc;QACjB,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAChB,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAChC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAgB,EAAE,QAA6B,EAAE,OAAa,MAAM;QACtE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACZ,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChD,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;oBAChB,OAAO,EAAE,CAAC;oBACV,OAAO,KAAK,CAAC;gBACjB,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED,0DAA0D;IAC1D,IAAI,CAAC,OAAe;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACJ"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The core of "tweak it live": a bag of numbers the scene reads every frame, plus saving, reset and "copy as code".
|
|
3
|
+
* No DOM, no framework: a panel (Vue, plain DOM, anything) only draws the schema and calls `set`.
|
|
4
|
+
* Ядро «покрутить вживую»: набор чисел, которые сцена читает каждый кадр, плюс сохранение, сброс и «скопировать как код».
|
|
5
|
+
* Без DOM и без фреймворка: панель (Vue, чистый DOM, что угодно) только рисует схему и зовёт `set`.
|
|
6
|
+
*/
|
|
7
|
+
/** One slider. / Один ползунок. */
|
|
8
|
+
export interface Knob<K extends string = string> {
|
|
9
|
+
key: K;
|
|
10
|
+
label: string;
|
|
11
|
+
min: number;
|
|
12
|
+
max: number;
|
|
13
|
+
step: number;
|
|
14
|
+
/** Unit label: "s", "×". / Подпись единиц: «с», «×». */
|
|
15
|
+
unit?: string;
|
|
16
|
+
}
|
|
17
|
+
/** Sliders under a heading. / Ползунки под заголовком. */
|
|
18
|
+
export interface KnobGroup<K extends string = string> {
|
|
19
|
+
title: string;
|
|
20
|
+
knobs: Knob<K>[];
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Where tweaks are kept. `read` returns null when nothing is saved or storage is unavailable; `write` returns false on failure.
|
|
24
|
+
* Neither throws.
|
|
25
|
+
* Где хранятся правки. `read` возвращает null, если ничего нет или хранилище недоступно; `write` возвращает false при неудаче.
|
|
26
|
+
* Ни то ни другое не бросает исключений.
|
|
27
|
+
*/
|
|
28
|
+
export interface TuningStorage {
|
|
29
|
+
read(key: string): string | null;
|
|
30
|
+
write(key: string, text: string): boolean;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* `localStorage`, safe: private mode, a site ban, a full quota or a missing `localStorage` give null / false, not an exception.
|
|
34
|
+
* `localStorage` без риска: приватный режим, запрет сайта, полная квота или отсутствие `localStorage` дают null / false, а не исключение.
|
|
35
|
+
*/
|
|
36
|
+
export declare function localStorageAdapter(): TuningStorage;
|
|
37
|
+
export interface TuningOptions<K extends string> {
|
|
38
|
+
/** The schema for a panel. The store itself does not need it. / Схема для панели. Самому хранилищу не нужна. */
|
|
39
|
+
groups?: KnobGroup<K>[];
|
|
40
|
+
/** Storage key. Without it nothing is saved. / Ключ хранилища. Без него ничего не сохраняется. */
|
|
41
|
+
storageKey?: string;
|
|
42
|
+
/** Default: {@link localStorageAdapter}. / По умолчанию {@link localStorageAdapter}. */
|
|
43
|
+
storage?: TuningStorage;
|
|
44
|
+
}
|
|
45
|
+
export interface Tuning<T extends {
|
|
46
|
+
[K in keyof T]: number;
|
|
47
|
+
}> {
|
|
48
|
+
/** The live object (the same one you passed in): read it from the scene every frame. / Живой объект (тот же, что передали): читай его из сцены каждый кадр. */
|
|
49
|
+
readonly values: T;
|
|
50
|
+
/** What the numbers were when the store was created: the defaults in code. / Какими числа были при создании: значения по умолчанию в коде. */
|
|
51
|
+
readonly defaults: Readonly<T>;
|
|
52
|
+
readonly groups: readonly KnobGroup<Extract<keyof T, string>>[];
|
|
53
|
+
/** Change one number: saves and notifies. Not a finite number: ignored. / Изменить одно число: сохраняет и оповещает. Не конечное число: игнорируется. */
|
|
54
|
+
set<K extends keyof T>(key: K, value: number): void;
|
|
55
|
+
/** Back to the defaults in code. / Вернуть значения по умолчанию из кода. */
|
|
56
|
+
reset(): void;
|
|
57
|
+
/** Only what differs from the defaults. / Только то, что отличается от умолчаний. */
|
|
58
|
+
changed(): Partial<T>;
|
|
59
|
+
/** The values as source code to paste over the defaults: `export const tuning = { … };`. / Значения как код, чтобы вставить поверх умолчаний. */
|
|
60
|
+
toSource(name?: string): string;
|
|
61
|
+
/** Called after every `set` and `reset`; returns the function that stops listening. / Зовётся после каждого `set` и `reset`; возвращает функцию отписки. */
|
|
62
|
+
subscribe(listener: () => void): () => void;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Wrap a bag of numbers. `values` stays the live object (the scene keeps reading it); its current content becomes the defaults.
|
|
66
|
+
* Saved tweaks are applied at once. Only the **differences from the defaults** are saved, so a knob you never touched
|
|
67
|
+
* follows new defaults when you change them in code.
|
|
68
|
+
* Обернуть набор чисел. `values` остаётся живым объектом (сцена продолжает его читать); его текущее содержимое становится
|
|
69
|
+
* значениями по умолчанию. Сохранённые правки применяются сразу. Сохраняются только **отличия от умолчаний**, поэтому
|
|
70
|
+
* ручка, которую не трогали, идёт за новыми умолчаниями, когда их меняют в коде.
|
|
71
|
+
*/
|
|
72
|
+
export declare function createTuning<T extends {
|
|
73
|
+
[K in keyof T]: number;
|
|
74
|
+
}>(values: T, options?: TuningOptions<Extract<keyof T, string>>): Tuning<T>;
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The core of "tweak it live": a bag of numbers the scene reads every frame, plus saving, reset and "copy as code".
|
|
3
|
+
* No DOM, no framework: a panel (Vue, plain DOM, anything) only draws the schema and calls `set`.
|
|
4
|
+
* Ядро «покрутить вживую»: набор чисел, которые сцена читает каждый кадр, плюс сохранение, сброс и «скопировать как код».
|
|
5
|
+
* Без DOM и без фреймворка: панель (Vue, чистый DOM, что угодно) только рисует схему и зовёт `set`.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* `localStorage`, safe: private mode, a site ban, a full quota or a missing `localStorage` give null / false, not an exception.
|
|
9
|
+
* `localStorage` без риска: приватный режим, запрет сайта, полная квота или отсутствие `localStorage` дают null / false, а не исключение.
|
|
10
|
+
*/
|
|
11
|
+
export function localStorageAdapter() {
|
|
12
|
+
const web = () => {
|
|
13
|
+
try {
|
|
14
|
+
return globalThis.localStorage ?? null;
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return null;
|
|
18
|
+
}
|
|
19
|
+
};
|
|
20
|
+
return {
|
|
21
|
+
read(key) {
|
|
22
|
+
try {
|
|
23
|
+
return web()?.getItem(key) ?? null;
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
return null;
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
write(key, text) {
|
|
30
|
+
try {
|
|
31
|
+
const storage = web();
|
|
32
|
+
if (!storage)
|
|
33
|
+
return false;
|
|
34
|
+
storage.setItem(key, text);
|
|
35
|
+
return true;
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
return false;
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Wrap a bag of numbers. `values` stays the live object (the scene keeps reading it); its current content becomes the defaults.
|
|
45
|
+
* Saved tweaks are applied at once. Only the **differences from the defaults** are saved, so a knob you never touched
|
|
46
|
+
* follows new defaults when you change them in code.
|
|
47
|
+
* Обернуть набор чисел. `values` остаётся живым объектом (сцена продолжает его читать); его текущее содержимое становится
|
|
48
|
+
* значениями по умолчанию. Сохранённые правки применяются сразу. Сохраняются только **отличия от умолчаний**, поэтому
|
|
49
|
+
* ручка, которую не трогали, идёт за новыми умолчаниями, когда их меняют в коде.
|
|
50
|
+
*/
|
|
51
|
+
export function createTuning(values, options = {}) {
|
|
52
|
+
const keys = Object.keys(values);
|
|
53
|
+
const defaults = Object.freeze({ ...values });
|
|
54
|
+
const { storageKey, groups = [] } = options;
|
|
55
|
+
const storage = options.storage ?? localStorageAdapter();
|
|
56
|
+
const listeners = new Set();
|
|
57
|
+
const changed = () => {
|
|
58
|
+
const diff = {};
|
|
59
|
+
for (const key of keys)
|
|
60
|
+
if (values[key] !== defaults[key])
|
|
61
|
+
diff[key] = values[key];
|
|
62
|
+
return diff;
|
|
63
|
+
};
|
|
64
|
+
const persist = () => {
|
|
65
|
+
if (storageKey !== undefined)
|
|
66
|
+
storage.write(storageKey, JSON.stringify(changed()));
|
|
67
|
+
};
|
|
68
|
+
const notify = () => {
|
|
69
|
+
for (const listener of [...listeners])
|
|
70
|
+
listener();
|
|
71
|
+
};
|
|
72
|
+
if (storageKey !== undefined) {
|
|
73
|
+
const text = storage.read(storageKey);
|
|
74
|
+
if (text !== null) {
|
|
75
|
+
try {
|
|
76
|
+
const saved = JSON.parse(text);
|
|
77
|
+
// Only keys we know and finite numbers: a stale or damaged save must not break the scene.
|
|
78
|
+
// Только известные ключи и конечные числа: устаревшее или испорченное сохранение не должно ломать сцену.
|
|
79
|
+
for (const key of keys) {
|
|
80
|
+
const value = saved?.[key];
|
|
81
|
+
if (typeof value === 'number' && Number.isFinite(value))
|
|
82
|
+
values[key] = value;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
// damaged save: work with the defaults / испорченное сохранение: работаем с умолчаниями
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return {
|
|
91
|
+
values,
|
|
92
|
+
defaults,
|
|
93
|
+
groups,
|
|
94
|
+
set(key, value) {
|
|
95
|
+
if (!Number.isFinite(value))
|
|
96
|
+
return;
|
|
97
|
+
values[key] = value;
|
|
98
|
+
persist();
|
|
99
|
+
notify();
|
|
100
|
+
},
|
|
101
|
+
reset() {
|
|
102
|
+
Object.assign(values, defaults);
|
|
103
|
+
persist();
|
|
104
|
+
notify();
|
|
105
|
+
},
|
|
106
|
+
changed,
|
|
107
|
+
toSource(name = 'tuning') {
|
|
108
|
+
const lines = keys.map((key) => ` ${key}: ${+values[key].toFixed(3)},`);
|
|
109
|
+
return `export const ${name} = {\n${lines.join('\n')}\n};\n`;
|
|
110
|
+
},
|
|
111
|
+
subscribe(listener) {
|
|
112
|
+
listeners.add(listener);
|
|
113
|
+
return () => listeners.delete(listener);
|
|
114
|
+
},
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
//# sourceMappingURL=tuning.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tuning.js","sourceRoot":"","sources":["../../src/core/tuning.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { Object3D } from 'three';
|
|
2
|
+
export interface DisposeOptions {
|
|
3
|
+
/**
|
|
4
|
+
* Also free the textures the materials hold (the standard slots such as `map`, and shader uniforms). Off by default:
|
|
5
|
+
* a texture is often shared with something that outlives this tree (an atlas, a cache), and freeing it is then a bug.
|
|
6
|
+
* Освобождать ли ещё и текстуры материалов (обычные слоты вроде `map` и uniform'ы шейдеров). По умолчанию выключено:
|
|
7
|
+
* текстура часто общая с тем, что переживёт это дерево (атлас, кэш), и освободить её тогда ошибка.
|
|
8
|
+
*/
|
|
9
|
+
textures?: boolean;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Free the GPU resources of everything under `root`: geometries and materials (a single one or an array), and with
|
|
13
|
+
* `textures: true` their textures. Each resource is freed exactly once however many meshes share it.
|
|
14
|
+
* Does not detach anything: remove `root` from its parent yourself.
|
|
15
|
+
* Освободить ресурсы видеокарты у всего под `root`: геометрии и материалы (одиночные или массивом), а с `textures: true` ещё и их текстуры.
|
|
16
|
+
* Каждый ресурс освобождается ровно один раз, сколько бы мешей его ни делило.
|
|
17
|
+
* Ничего не отцепляет: убери `root` у родителя сам.
|
|
18
|
+
*/
|
|
19
|
+
export declare function disposeObject(root: Object3D, options?: DisposeOptions): void;
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
const isTexture = (value) => typeof value === 'object' && value !== null && value.isTexture === true;
|
|
2
|
+
/**
|
|
3
|
+
* Free the GPU resources of everything under `root`: geometries and materials (a single one or an array), and with
|
|
4
|
+
* `textures: true` their textures. Each resource is freed exactly once however many meshes share it.
|
|
5
|
+
* Does not detach anything: remove `root` from its parent yourself.
|
|
6
|
+
* Освободить ресурсы видеокарты у всего под `root`: геометрии и материалы (одиночные или массивом), а с `textures: true` ещё и их текстуры.
|
|
7
|
+
* Каждый ресурс освобождается ровно один раз, сколько бы мешей его ни делило.
|
|
8
|
+
* Ничего не отцепляет: убери `root` у родителя сам.
|
|
9
|
+
*/
|
|
10
|
+
export function disposeObject(root, options = {}) {
|
|
11
|
+
const geometries = new Set();
|
|
12
|
+
const materials = new Set();
|
|
13
|
+
const instanced = [];
|
|
14
|
+
root.traverse((object) => {
|
|
15
|
+
const item = object;
|
|
16
|
+
if (item.geometry)
|
|
17
|
+
geometries.add(item.geometry);
|
|
18
|
+
if (item.material)
|
|
19
|
+
for (const material of Array.isArray(item.material) ? item.material : [item.material])
|
|
20
|
+
materials.add(material);
|
|
21
|
+
if (item.isInstancedMesh)
|
|
22
|
+
instanced.push(item);
|
|
23
|
+
});
|
|
24
|
+
const textures = new Set();
|
|
25
|
+
if (options.textures) {
|
|
26
|
+
for (const material of materials) {
|
|
27
|
+
for (const value of Object.values(material))
|
|
28
|
+
if (isTexture(value))
|
|
29
|
+
textures.add(value);
|
|
30
|
+
const uniforms = material.uniforms;
|
|
31
|
+
if (uniforms)
|
|
32
|
+
for (const uniform of Object.values(uniforms))
|
|
33
|
+
if (isTexture(uniform.value))
|
|
34
|
+
textures.add(uniform.value);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
// An instanced mesh also owns its instance buffers. / У instanced-меша есть ещё и свои буферы экземпляров.
|
|
38
|
+
for (const mesh of instanced)
|
|
39
|
+
mesh.dispose?.();
|
|
40
|
+
for (const geometry of geometries)
|
|
41
|
+
geometry.dispose();
|
|
42
|
+
for (const material of materials)
|
|
43
|
+
material.dispose();
|
|
44
|
+
for (const texture of textures)
|
|
45
|
+
texture.dispose();
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=dispose.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispose.js","sourceRoot":"","sources":["../../src/three/dispose.ts"],"names":[],"mappings":"AAmBA,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAiB,CAAC,SAAS,KAAK,IAAI,CAAC;AAE7I;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,UAA0B,EAAE;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IACtC,MAAM,SAAS,GAAkB,EAAE,CAAC;IAEpC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,MAAgC,CAAC;QAC9C,IAAI,IAAI,CAAC,QAAQ;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClI,IAAI,IAAI,CAAC,eAAe;YAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;IACpC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAAE,IAAI,SAAS,CAAC,KAAK,CAAC;oBAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvF,MAAM,QAAQ,GAAI,QAA8D,CAAC,QAAQ,CAAC;YAC1F,IAAI,QAAQ;gBAAE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAAE,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;wBAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3H,CAAC;IACL,CAAC;IAED,2GAA2G;IAC3G,KAAK,MAAM,IAAI,IAAI,SAAS;QAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,UAAU;QAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtD,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrD,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AACtD,CAAC"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { Vector2, Vector3, type Camera, type Plane } from 'three';
|
|
2
|
+
/** Anything with a client position: a `PointerEvent`, a `MouseEvent`, a `Touch`. / Всё, у чего есть позиция в окне: `PointerEvent`, `MouseEvent`, `Touch`. */
|
|
3
|
+
export interface ClientPoint {
|
|
4
|
+
clientX: number;
|
|
5
|
+
clientY: number;
|
|
6
|
+
}
|
|
7
|
+
/** Anything that knows its rectangle on the page: an element, the canvas. / Всё, что знает свой прямоугольник на странице: элемент, холст. */
|
|
8
|
+
export interface RectSource {
|
|
9
|
+
getBoundingClientRect(): {
|
|
10
|
+
left: number;
|
|
11
|
+
top: number;
|
|
12
|
+
width: number;
|
|
13
|
+
height: number;
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* A point of the window in normalized device coordinates of `element`: x from -1 (left) to 1 (right), y from -1 (bottom) to 1 (top),
|
|
18
|
+
* as `Raycaster.setFromCamera` wants it. A zero-size element gives (0, 0).
|
|
19
|
+
* Точка окна в нормализованных координатах `element`: x от -1 (слева) до 1 (справа), y от -1 (снизу) до 1 (сверху),
|
|
20
|
+
* как нужно `Raycaster.setFromCamera`. Элемент нулевого размера даёт (0, 0).
|
|
21
|
+
*/
|
|
22
|
+
export declare function clientToNdc(point: ClientPoint, element: RectSource, out?: Vector2): Vector2;
|
|
23
|
+
/**
|
|
24
|
+
* Where the ray through `ndc` meets `plane`; `null` when it never does (parallel, or the plane is behind the camera).
|
|
25
|
+
* Refreshes the camera's world matrix first, so a camera moved since the last render (a shake, a rig) still aims right.
|
|
26
|
+
* Pass `out` to avoid an allocation per move event.
|
|
27
|
+
* Где луч через `ndc` встречает `plane`; `null`, если не встречает (параллелен или плоскость позади камеры).
|
|
28
|
+
* Сначала обновляет мировую матрицу камеры, поэтому камера, сдвинутая после последнего кадра (тряска, штатив), всё равно целится верно.
|
|
29
|
+
* Передай `out`, чтобы не создавать объект на каждое событие движения.
|
|
30
|
+
*/
|
|
31
|
+
export declare function rayOnPlane(ndc: {
|
|
32
|
+
x: number;
|
|
33
|
+
y: number;
|
|
34
|
+
}, camera: Camera, plane: Plane, out?: Vector3): Vector3 | null;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { Raycaster, Vector2, Vector3 } from 'three';
|
|
2
|
+
/**
|
|
3
|
+
* A point of the window in normalized device coordinates of `element`: x from -1 (left) to 1 (right), y from -1 (bottom) to 1 (top),
|
|
4
|
+
* as `Raycaster.setFromCamera` wants it. A zero-size element gives (0, 0).
|
|
5
|
+
* Точка окна в нормализованных координатах `element`: x от -1 (слева) до 1 (справа), y от -1 (снизу) до 1 (сверху),
|
|
6
|
+
* как нужно `Raycaster.setFromCamera`. Элемент нулевого размера даёт (0, 0).
|
|
7
|
+
*/
|
|
8
|
+
export function clientToNdc(point, element, out = new Vector2()) {
|
|
9
|
+
const rect = element.getBoundingClientRect();
|
|
10
|
+
if (!rect.width || !rect.height)
|
|
11
|
+
return out.set(0, 0);
|
|
12
|
+
return out.set(((point.clientX - rect.left) / rect.width) * 2 - 1, -((point.clientY - rect.top) / rect.height) * 2 + 1);
|
|
13
|
+
}
|
|
14
|
+
const raycaster = new Raycaster();
|
|
15
|
+
/**
|
|
16
|
+
* Where the ray through `ndc` meets `plane`; `null` when it never does (parallel, or the plane is behind the camera).
|
|
17
|
+
* Refreshes the camera's world matrix first, so a camera moved since the last render (a shake, a rig) still aims right.
|
|
18
|
+
* Pass `out` to avoid an allocation per move event.
|
|
19
|
+
* Где луч через `ndc` встречает `plane`; `null`, если не встречает (параллелен или плоскость позади камеры).
|
|
20
|
+
* Сначала обновляет мировую матрицу камеры, поэтому камера, сдвинутая после последнего кадра (тряска, штатив), всё равно целится верно.
|
|
21
|
+
* Передай `out`, чтобы не создавать объект на каждое событие движения.
|
|
22
|
+
*/
|
|
23
|
+
export function rayOnPlane(ndc, camera, plane, out = new Vector3()) {
|
|
24
|
+
camera.updateMatrixWorld();
|
|
25
|
+
raycaster.setFromCamera(ndc, camera);
|
|
26
|
+
return raycaster.ray.intersectPlane(plane, out);
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=pointer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../src/three/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAA2B,MAAM,OAAO,CAAC;AAa7E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,OAAmB,EAAE,MAAe,IAAI,OAAO,EAAE;IAC7F,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5H,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAA6B,EAAE,MAAc,EAAE,KAAY,EAAE,MAAe,IAAI,OAAO,EAAE;IAChH,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC3B,SAAS,CAAC,aAAa,CAAC,GAAc,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC"}
|