@1337exp/pkt-threejs-blueprint 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.1.0
+
+First release. Each module is its own import (`@1337exp/pkt-threejs-blueprint/<module>`), there is no root entry.
+
+- **`ease`**: `Ease`, our curves (`easeOutBack` overshoots), `smoothstep(edge0, edge1, x)` in GLSL argument order.
+- **`ticker`**: `Ticker`, game time with a `speed` (0 is a hit-stop), `tween` and `wait` as promises.
+- **`spring`**: `spring(stiffness, zeta)`, `stepSpring`, `stepSpring3`. The exact solution of the spring equation: stable at any step, the same path at any frame rate.
+- **`rng`**: `mulberry32`, `randomInt`. The sequence is frozen by a test, so saved seeds stay valid.
+- **`tuning`**: `createTuning`, the core of a "tweak it live" panel (live values, saving only the differences from the defaults, reset, copy as code).
+- **`loop`**: `startLoop(frame, { maxDt })`, the frame loop with a capped delta; `maxDt` is required.
+- **`renderer`** (needs `three`): `createRenderer`, `bindResize`.
+- **`pointer`** (needs `three`): `clientToNdc`, `rayOnPlane`.
+- **`dispose`** (needs `three`): `disposeObject`.
+- **`vue/tuning-panel`** (needs `vue`): `TuningPanel`, styled with `--tbp-*` CSS variables.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 1337exp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+# @1337exp/pkt-threejs-blueprint
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**English** · [Русский](README.ru.md)
+
+The small shared layer our Three.js prototypes keep rewriting: a game clock with tweens, springs that do not blow up, seeded random, and the core of a "tweak it live" panel. Import only what you need; nothing is pulled in that you did not ask for.
+
+## Stack
+
+TypeScript 6, Vitest, plain `tsc` (no bundler: one file per module is the tree-shaking). The core has no dependencies and no DOM. `three` is an optional peer, used only by the modules that say so in the table; `vue` is an optional peer of the panel. It does not depend on TaoUI or TaoUX.
+
+```bash
+npm install @1337exp/pkt-threejs-blueprint   # plus three and vue if you use the modules that need them
+```
+
+Work on the library itself:
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## What it can do
+
+Each module is its own import (`@1337exp/pkt-threejs-blueprint/<module>`), there is no root entry.
+
+| Module | What |
+|---|---|
+| `ease` | `Ease = (t) => number`, our curves (`easeOutBack` overshoots), `smoothstep(edge0, edge1, x)` in GLSL argument order |
+| `ticker` | `Ticker`: game time with a `speed` (0 is a hit-stop), `tween` and `wait` as promises, `add`, `busy`, `clear` |
+| `spring` | `spring(stiffness, zeta)`, `stepSpring` (a number) and `stepSpring3` (a vector): the exact solution, stable at any step, the same path at any frame rate |
+| `rng` | `mulberry32(seed)`, `randomInt`; the sequence is frozen by a test, saved seeds stay valid |
+| `tuning` | `createTuning(values, { groups, storageKey })`: live values, saving only the differences from the defaults, reset, "copy as code" (`toSource`), safe `localStorage` |
+| `loop` | `startLoop(frame, { maxDt })`: the frame loop; `frame(dt, now)` gets a delta capped at `maxDt` (required: you choose it); `stop()` |
+| `renderer` | needs `three`. `createRenderer(container)`, `bindResize(renderer, container, onResize)`: size and a pixel ratio capped at 2, read again on every resize |
+| `pointer` | needs `three`. `clientToNdc(event, element)`, `rayOnPlane(ndc, camera, plane)`: a pointer to the point on a plane, with the camera matrix refreshed |
+| `vue/tuning-panel` | needs `vue`. `TuningPanel`: draws a `tuning` (groups of sliders, what differs from the defaults, Copy as code, Reset). No `.vue` file, no UI library; looks are `--tbp-*` CSS variables with our dark-theme values as fallbacks |
+| `dispose` | needs `three`. `disposeObject(root, { textures })`: geometries and materials (arrays too) freed once however many meshes share them; textures only when asked |
+
+```ts
+import { Ticker } from '@1337exp/pkt-threejs-blueprint/ticker';
+import { easeOutBack } from '@1337exp/pkt-threejs-blueprint/ease';
+
+const ticker = new Ticker();
+// every frame: ticker.update(Math.min(realDt, maxDt));
+await ticker.tween(0.4, (k) => (mesh.scale.x = 1 + k), easeOutBack);
+```
+
+### The frame delta
+
+`dt` is the time between two frames in seconds, not a simulation rate: the frame rate stays the screen's (60, 120, 144 Hz). Cap it from above (`maxDt`) before feeding the ticker, so a hidden tab or a stall does not deliver a `dt` of seconds and send every tween to its end in one frame. Our projects use `1/30`, `0.05` or `0.1`; pick one deliberately.
+
+Springs do not need a cap to stay alive: `stepSpring` and `stepSpring3` use the exact solution of the spring equation, so they are stable for any `dt` and give the same path at 30, 60 or 144 frames per second. The usual one-line Euler step (`v += (k·(target − x) − c·v)·dt; x += v·dt`) does neither: stiffness 2000 with `zeta` 1 blows up below ~54 frames per second, and even where it holds the path depends on the frame rate. Do not write that line by hand.
+
+## How it is built
+
+Three layers by dependency: `core/` (nothing), `three/` (needs `three`), `components/` (ready-made interface blocks over the core, styled with our dark-theme values copied as CSS variables, no TaoUI). Design, decisions and the analysis behind them: [docs/design.md](docs/design.md), [docs/analysis-grok.md](docs/analysis-grok.md).
+
+## Not yet
+
+A plain-DOM panel over `tuning` (the Vue one is done). Particles, ribbons, cameras, bloom and shaders stay in the games on purpose: they differ because the pictures differ.
+
+## License
+
+MIT, see [LICENSE](LICENSE).
+
+## Us
+
+Homepage: [666.io](https://666.io). If you want to help, suggest an idea or just talk, come by.

package/README.ru.md

@@ -0,0 +1,70 @@
+# @1337exp/pkt-threejs-blueprint
+
+[English](README.md) · **Русский**
+
+Небольшой общий слой, который наши прототипы на Three.js постоянно пишут заново: игровое время с твинами, пружины, которые не разлетаются, случайные числа с зерном и ядро панели «покрутить вживую». Подключай только то, что нужно; лишнего не тянется.
+
+## Стек
+
+TypeScript 6, Vitest, обычный `tsc` (без бандлера: по файлу на модуль и есть tree-shaking). Ядро без зависимостей и без DOM. `three` необязательный peer, он нужен только модулям, у которых это сказано в таблице; `vue` необязательный peer панели. От TaoUI и TaoUX не зависит.
+
+```bash
+npm install @1337exp/pkt-threejs-blueprint   # плюс three и vue, если берёшь модули, которым они нужны
+```
+
+Работа над самой библиотекой:
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## Что умеет
+
+Каждый модуль подключается отдельно (`@1337exp/pkt-threejs-blueprint/<модуль>`), общего входа нет.
+
+| Модуль | Что |
+|---|---|
+| `ease` | `Ease = (t) => number`, наши кривые (`easeOutBack` с перелётом), `smoothstep(edge0, edge1, x)` в порядке аргументов GLSL |
+| `ticker` | `Ticker`: игровое время со `speed` (0 — hit-stop), `tween` и `wait` как обещания, `add`, `busy`, `clear` |
+| `spring` | `spring(stiffness, zeta)`, `stepSpring` (число) и `stepSpring3` (вектор): точное решение, устойчиво при любом шаге, один и тот же путь на любой частоте кадров |
+| `rng` | `mulberry32(seed)`, `randomInt`; последовательность заморожена тестом, сохранённые зёрна остаются верными |
+| `tuning` | `createTuning(values, { groups, storageKey })`: живые значения, сохранение только отличий от умолчаний, сброс, «скопировать как код» (`toSource`), безопасный `localStorage` |
+| `loop` | `startLoop(frame, { maxDt })`: цикл кадров; `frame(dt, now)` получает дельту не больше `maxDt` (параметр обязателен: выбираешь ты); `stop()` |
+| `renderer` | нужен `three`. `createRenderer(container)`, `bindResize(renderer, container, onResize)`: размер и плотность пикселей с потолком 2, читаются заново при каждом изменении размера |
+| `pointer` | нужен `three`. `clientToNdc(event, element)`, `rayOnPlane(ndc, camera, plane)`: от указателя до точки на плоскости, с обновлением матрицы камеры |
+| `vue/tuning-panel` | нужен `vue`. `TuningPanel`: рисует `tuning` (группы ползунков, что отличается от умолчаний, «скопировать как код», сброс). Без `.vue`-файла и без UI-библиотеки; вид задают CSS-переменные `--tbp-*`, запасные значения это наша тёмная тема |
+| `dispose` | нужен `three`. `disposeObject(root, { textures })`: геометрии и материалы (и массивы) освобождаются один раз, сколько бы мешей их ни делило; текстуры только по просьбе |
+
+```ts
+import { Ticker } from '@1337exp/pkt-threejs-blueprint/ticker';
+import { easeOutBack } from '@1337exp/pkt-threejs-blueprint/ease';
+
+const ticker = new Ticker();
+// каждый кадр: ticker.update(Math.min(realDt, maxDt));
+await ticker.tween(0.4, (k) => (mesh.scale.x = 1 + k), easeOutBack);
+```
+
+### Дельта кадра
+
+`dt` — время между двумя кадрами в секундах, а не частота симуляции: частота кадров остаётся экранной (60, 120, 144 Гц). Ограничь её сверху (`maxDt`) перед подачей в тикер, чтобы после фона вкладки или подвисания не прилетел `dt` в секунды и все твины не ушли в конец за один кадр. В наших проектах это `1/30`, `0.05` или `0.1`; выбирай осознанно.
+
+Пружине потолок, чтобы выжить, не нужен: `stepSpring` и `stepSpring3` берут точное решение уравнения пружины, поэтому устойчивы при любом `dt` и дают один и тот же путь на 30, 60 и 144 кадрах в секунду. Привычный однострочный шаг Эйлера (`v += (k·(цель − x) − c·v)·dt; x += v·dt`) не даёт ни того ни другого: жёсткость 2000 при `zeta` 1 разлетается ниже ~54 кадров в секунду, а и там, где держится, путь зависит от частоты кадров. Не пиши эту строку руками.
+
+## Как устроено
+
+Три слоя по зависимостям: `core/` (ничего), `three/` (нужен `three`), `components/` (готовые блоки интерфейса поверх ядра; стили это значения нашей тёмной темы, скопированные как CSS-переменные, без TaoUI). Дизайн, решения и анализ, на котором они стоят: [docs/design.md](docs/design.md), [docs/analysis-grok.md](docs/analysis-grok.md).
+
+## Пока нет
+
+Панель на чистом DOM поверх `tuning` (на Vue готова). Частицы, ленты, камеры, bloom и шейдеры остаются в играх намеренно: они разные, потому что разные картинки.
+
+## Лицензия
+
+MIT, см. [LICENSE](LICENSE).
+
+## Мы
+
+Домашняя страница: [666.io](https://666.io). Хочешь помочь, предложить идею или просто поговорить — заходи.

package/dist/components/vue/tuning-panel.d.ts

@@ -0,0 +1,74 @@
+import { type PropType, type VNode } from 'vue';
+import type { Tuning } from '../../core/tuning.js';
+/**
+ * The "tweak it live" panel for Vue: draws the schema of a `Tuning` (groups of sliders), shows what differs from the defaults,
+ * and offers "copy as code" and "reset". It owns no state: every change goes through `tuning.set`, so saving and the live object
+ * stay the core's business. Written with `defineComponent` and render functions, not a `.vue` file, so plain `tsc` builds it.
+ * Панель «покрутить вживую» для Vue: рисует схему `Tuning` (группы ползунков), показывает, что отличается от умолчаний,
+ * и даёт «скопировать как код» и «сбросить». Своего состояния не держит: любое изменение идёт через `tuning.set`, поэтому
+ * сохранение и живой объект остаются делом ядра. Написана на `defineComponent` и функциях отрисовки, а не в `.vue`, чтобы её собирал обычный `tsc`.
+ */
+/** Texts of the panel. Defaults are English; pass your own for another language. / Тексты панели. По умолчанию английские; передай свои для другого языка. */
+export interface TuningPanelLabels {
+    copy: string;
+    reset: string;
+    copied: string;
+    copyFailed: string;
+}
+/**
+ * A value for the label next to a slider: as many decimals as the step needs, plus the unit.
+ * Значение для подписи рядом с ползунком: столько знаков, сколько нужно шагу, и единица.
+ */
+export declare function formatKnobValue(value: number, step: number, unit?: string): string;
+export declare const TuningPanel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** The store to draw. May be swapped at runtime (the panel rebinds). / Хранилище, которое рисуем. Можно менять на лету (панель переподключится). */
+    tuning: {
+        type: PropType<Tuning<any>>;
+        required: true;
+    };
+    /** Pin to the right edge of a positioned parent. Off: an ordinary block you place yourself. / Прижать к правому краю позиционированного родителя. Выключено: обычный блок, ставь сам. */
+    floating: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    labels: {
+        type: PropType<Partial<TuningPanelLabels>>;
+        default: () => {};
+    };
+    /** The name in "copy as code": `export const <name> = { … }`. / Имя в «скопировать как код»: `export const <name> = { … }`. */
+    sourceName: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    /** After every change and reset made through the panel or anywhere else through the same store. / После каждого изменения и сброса, из панели или откуда угодно через то же хранилище. */
+    change: () => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** The store to draw. May be swapped at runtime (the panel rebinds). / Хранилище, которое рисуем. Можно менять на лету (панель переподключится). */
+    tuning: {
+        type: PropType<Tuning<any>>;
+        required: true;
+    };
+    /** Pin to the right edge of a positioned parent. Off: an ordinary block you place yourself. / Прижать к правому краю позиционированного родителя. Выключено: обычный блок, ставь сам. */
+    floating: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    labels: {
+        type: PropType<Partial<TuningPanelLabels>>;
+        default: () => {};
+    };
+    /** The name in "copy as code": `export const <name> = { … }`. / Имя в «скопировать как код»: `export const <name> = { … }`. */
+    sourceName: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    onChange?: (() => any) | undefined;
+}>, {
+    floating: boolean;
+    labels: Partial<TuningPanelLabels>;
+    sourceName: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/vue/tuning-panel.js

@@ -0,0 +1,155 @@
+import { defineComponent, h, onBeforeUnmount, shallowRef, watch } from 'vue';
+const DEFAULT_LABELS = { copy: 'Copy', reset: 'Reset', copied: 'Copied', copyFailed: 'Clipboard unavailable' };
+/**
+ * A value for the label next to a slider: as many decimals as the step needs, plus the unit.
+ * Значение для подписи рядом с ползунком: столько знаков, сколько нужно шагу, и единица.
+ */
+export function formatKnobValue(value, step, unit = '') {
+    const text = value.toFixed(step < 0.01 ? 3 : step < 1 ? 2 : 0);
+    return unit ? `${text} ${unit}` : text;
+}
+/**
+ * The look. Every colour, radius and gap is a CSS variable with a fallback, so an app restyles the panel by setting `--tbp-*`
+ * anywhere above it. The fallbacks are the values of our dark theme (TaoUI), copied, not imported.
+ * Вид. Каждый цвет, радиус и отступ это CSS-переменная с запасным значением, поэтому приложение перекрашивает панель, задав `--tbp-*`
+ * где угодно выше неё. Запасные значения это значения нашей тёмной темы (TaoUI), скопированные, а не подключённые.
+ */
+const CSS = `
+.tbp-panel {
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+    gap: var(--tbp-space-3, 12px);
+    padding: var(--tbp-space-3, 12px);
+    background: var(--tbp-bg, #151515);
+    border: 1px solid var(--tbp-border, rgb(51 51 51 / 0.4));
+    border-radius: var(--tbp-radius, 8px);
+    color: var(--tbp-text, #bfbfbf);
+    font: var(--tbp-font-size, 12px) / 1.4 var(--tbp-font, system-ui, sans-serif);
+}
+.tbp-panel--floating {
+    position: absolute;
+    top: var(--tbp-space-4, 16px);
+    right: var(--tbp-space-4, 16px);
+    bottom: var(--tbp-space-4, 16px);
+    width: 280px;
+    max-height: calc(100% - 2 * var(--tbp-space-4, 16px));
+}
+.tbp-scroll { flex: 1; min-height: 0; overflow-y: auto; padding-right: var(--tbp-space-1, 4px); }
+.tbp-group + .tbp-group { margin-top: var(--tbp-space-3, 12px); }
+.tbp-title { margin-bottom: var(--tbp-space-2, 8px); color: var(--tbp-text-bright, #fff); font-weight: 600; font-size: var(--tbp-font-size-title, 13px); }
+.tbp-knob { display: block; margin-bottom: var(--tbp-space-2, 8px); }
+.tbp-head { display: flex; justify-content: space-between; margin-bottom: var(--tbp-space-1, 4px); color: var(--tbp-text-muted, #8a8a8a); }
+.tbp-value { color: var(--tbp-text-bright, #fff); font-weight: 500; font-variant-numeric: tabular-nums; }
+.tbp-value--changed { color: var(--tbp-accent, #ffc04a); }
+.tbp-range { display: block; width: 100%; margin: 0; accent-color: var(--tbp-accent, #ffc04a); }
+.tbp-actions { display: flex; gap: var(--tbp-space-2, 8px); }
+.tbp-btn {
+    flex: 1;
+    padding: var(--tbp-space-2, 8px) var(--tbp-space-3, 12px);
+    background: var(--tbp-field, rgb(51 51 51 / 0.2));
+    border: 1px solid var(--tbp-border, rgb(51 51 51 / 0.4));
+    border-radius: var(--tbp-radius-sm, 4px);
+    color: var(--tbp-text, #bfbfbf);
+    font: inherit;
+    cursor: pointer;
+}
+.tbp-btn:hover { background: var(--tbp-hover, #262626); color: var(--tbp-text-bright, #fff); }
+.tbp-btn--primary { background: var(--tbp-accent, #ffc04a); border-color: transparent; color: var(--tbp-on-accent, #0d0d0d); font-weight: 600; }
+.tbp-btn--primary:hover { background: var(--tbp-accent-hover, #ffb40b); color: var(--tbp-on-accent, #0d0d0d); }
+`;
+const STYLE_ID = 'tbp-styles';
+/** Put the stylesheet into the page once. Does nothing without a `document` (server rendering, tests in node). / Положить стили на страницу один раз. Ничего не делает без `document` (серверная отрисовка, тесты в node). */
+function ensureStyles() {
+    if (typeof document === 'undefined' || document.getElementById(STYLE_ID))
+        return;
+    const style = document.createElement('style');
+    style.id = STYLE_ID;
+    style.textContent = CSS;
+    document.head.appendChild(style);
+}
+export const TuningPanel = defineComponent({
+    name: 'TbpTuningPanel',
+    props: {
+        /** The store to draw. May be swapped at runtime (the panel rebinds). / Хранилище, которое рисуем. Можно менять на лету (панель переподключится). */
+        tuning: { type: Object, required: true },
+        /** Pin to the right edge of a positioned parent. Off: an ordinary block you place yourself. / Прижать к правому краю позиционированного родителя. Выключено: обычный блок, ставь сам. */
+        floating: { type: Boolean, default: false },
+        labels: { type: Object, default: () => ({}) },
+        /** The name in "copy as code": `export const <name> = { … }`. / Имя в «скопировать как код»: `export const <name> = { … }`. */
+        sourceName: { type: String, default: 'tuning' },
+    },
+    emits: {
+        /** After every change and reset made through the panel or anywhere else through the same store. / После каждого изменения и сброса, из панели или откуда угодно через то же хранилище. */
+        change: () => true,
+    },
+    setup(props, { emit, slots }) {
+        ensureStyles();
+        // The store's values are a plain object, not reactive: bump a counter to redraw after the store says it changed.
+        // Значения хранилища это обычный объект, не реактивный: после оповещения хранилища увеличиваем счётчик, чтобы перерисоваться.
+        const version = shallowRef(0);
+        const copyState = shallowRef('idle');
+        let unsubscribe = () => { };
+        let timer;
+        watch(() => props.tuning, (tuning) => {
+            unsubscribe();
+            unsubscribe = tuning.subscribe(() => {
+                version.value++;
+                emit('change');
+            });
+            version.value++;
+        }, { immediate: true });
+        onBeforeUnmount(() => {
+            unsubscribe();
+            clearTimeout(timer);
+        });
+        async function copy() {
+            try {
+                await navigator.clipboard.writeText(props.tuning.toSource(props.sourceName));
+                copyState.value = 'copied';
+            }
+            catch {
+                copyState.value = 'failed';
+            }
+            clearTimeout(timer);
+            timer = setTimeout(() => (copyState.value = 'idle'), 1600);
+        }
+        return () => {
+            void version.value;
+            const { tuning } = props;
+            const labels = { ...DEFAULT_LABELS, ...props.labels };
+            const copyLabel = copyState.value === 'copied' ? labels.copied : copyState.value === 'failed' ? labels.copyFailed : labels.copy;
+            const groups = tuning.groups.map((group) => h('section', { class: 'tbp-group', key: group.title }, [
+                h('div', { class: 'tbp-title' }, group.title),
+                ...group.knobs.map((knob) => {
+                    const value = tuning.values[knob.key];
+                    const changed = value !== tuning.defaults[knob.key];
+                    return h('label', { class: 'tbp-knob', key: knob.key }, [
+                        h('span', { class: 'tbp-head' }, [
+                            h('span', knob.label),
+                            h('b', { class: ['tbp-value', { 'tbp-value--changed': changed }] }, formatKnobValue(value, knob.step, knob.unit)),
+                        ]),
+                        h('input', {
+                            class: 'tbp-range',
+                            type: 'range',
+                            min: knob.min,
+                            max: knob.max,
+                            step: knob.step,
+                            value,
+                            'aria-label': knob.label,
+                            onInput: (event) => tuning.set(knob.key, Number(event.target.value)),
+                        }),
+                    ]);
+                }),
+            ]));
+            return h('div', { class: ['tbp-panel', { 'tbp-panel--floating': props.floating }] }, [
+                h('div', { class: 'tbp-scroll' }, [slots.before?.(), ...groups]),
+                h('div', { class: 'tbp-actions' }, [
+                    h('button', { class: 'tbp-btn tbp-btn--primary', type: 'button', onClick: copy }, copyLabel),
+                    h('button', { class: 'tbp-btn', type: 'button', onClick: () => tuning.reset() }, labels.reset),
+                ]),
+            ]);
+        };
+    },
+});
+//# sourceMappingURL=tuning-panel.js.map

package/dist/components/vue/tuning-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuning-panel.js","sourceRoot":"","sources":["../../../src/components/vue/tuning-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAA6B,MAAM,KAAK,CAAC;AAoBxG,MAAM,cAAc,GAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC;AAElI;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,IAAY,EAAE,IAAI,GAAG,EAAE;IAClE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CX,CAAC;AAEF,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,8NAA8N;AAC9N,SAAS,YAAY;IACjB,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO;IACjF,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC;IACpB,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;IACvC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE;QACH,oJAAoJ;QACpJ,MAAM,EAAE,EAAE,IAAI,EAAE,MAA+B,EAAE,QAAQ,EAAE,IAAI,EAAE;QACjE,yLAAyL;QACzL,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,MAA8C,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE;QACrF,+HAA+H;QAC/H,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;KAClD;IACD,KAAK,EAAE;QACH,0LAA0L;QAC1L,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI;KACrB;IACD,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;QACxB,YAAY,EAAE,CAAC;QAEf,iHAAiH;QACjH,8HAA8H;QAC9H,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,UAAU,CAA+B,MAAM,CAAC,CAAC;QACnE,IAAI,WAAW,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;QACvC,IAAI,KAAgD,CAAC;QAErD,KAAK,CACD,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAClB,CAAC,MAAM,EAAE,EAAE;YACP,WAAW,EAAE,CAAC;YACd,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;gBAChC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EACD,EAAE,SAAS,EAAE,IAAI,EAAE,CACtB,CAAC;QACF,eAAe,CAAC,GAAG,EAAE;YACjB,WAAW,EAAE,CAAC;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,KAAK,UAAU,IAAI;YACf,IAAI,CAAC;gBACD,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC7E,SAAS,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACL,SAAS,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC/B,CAAC;YACD,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,GAAG,EAAE;YACR,KAAK,OAAO,CAAC,KAAK,CAAC;YACnB,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YACzB,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;YAEhI,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAChD,CAAC,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE;gBACnD,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC;gBAC7C,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAW,CAAC;oBAChD,MAAM,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACpD,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;wBACpD,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;4BAC7B,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;4BACrB,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;yBACpH,CAAC;wBACF,CAAC,CAAC,OAAO,EAAE;4BACP,KAAK,EAAE,WAAW;4BAClB,IAAI,EAAE,OAAO;4BACb,GAAG,EAAE,IAAI,CAAC,GAAG;4BACb,GAAG,EAAE,IAAI,CAAC,GAAG;4BACb,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,KAAK;4BACL,YAAY,EAAE,IAAI,CAAC,KAAK;4BACxB,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAE,KAAK,CAAC,MAA2B,CAAC,KAAK,CAAC,CAAC;yBACpG,CAAC;qBACL,CAAC,CAAC;gBACP,CAAC,CAAC;aACL,CAAC,CACL,CAAC;YAEF,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE,qBAAqB,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE;gBACjF,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;gBAChE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;oBAC/B,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC;oBAC5F,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC;iBACjG,CAAC;aACL,CAAC,CAAC;QACP,CAAC,CAAC;IACN,CAAC;CACJ,CAAC,CAAC"}

package/dist/core/ease.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Easing curve: `t` from 0 to 1 → progress from 0 to 1 (Back overshoots past 1).
+ * Кривая времени: `t` от 0 до 1 → прогресс от 0 до 1 (у Back — с перелётом).
+ */
+export type Ease = (t: number) => number;
+export declare const linear: Ease;
+export declare const easeInQuad: Ease;
+export declare const easeOutQuad: Ease;
+export declare const easeInCubic: Ease;
+export declare const easeOutCubic: Ease;
+export declare const easeInOutCubic: Ease;
+/** Overshoots by ~10 % and settles (overshoot constant 1.70158). / Перелёт около 10 % и возврат (константа 1.70158). */
+export declare const easeOutBack: Ease;
+/**
+ * Smooth 0 → 1 transition between `edge0` and `edge1`, the same argument order as `smoothstep` in GLSL.
+ * Note: `THREE.MathUtils.smoothstep` takes `(x, min, max)`.
+ * Плавный переход от 0 к 1 между `edge0` и `edge1`, порядок аргументов как у `smoothstep` в GLSL.
+ * Внимание: `THREE.MathUtils.smoothstep` принимает `(x, min, max)`.
+ */
+export declare const smoothstep: (edge0: number, edge1: number, x: number) => number;

package/dist/core/ease.js

@@ -0,0 +1,19 @@
+export const linear = (t) => t;
+export const easeInQuad = (t) => t * t;
+export const easeOutQuad = (t) => 1 - (1 - t) * (1 - t);
+export const easeInCubic = (t) => t * t * t;
+export const easeOutCubic = (t) => 1 - (1 - t) ** 3;
+export const easeInOutCubic = (t) => (t < 0.5 ? 4 * t * t * t : 1 - (-2 * t + 2) ** 3 / 2);
+/** Overshoots by ~10 % and settles (overshoot constant 1.70158). / Перелёт около 10 % и возврат (константа 1.70158). */
+export const easeOutBack = (t) => 1 + 2.70158 * (t - 1) ** 3 + 1.70158 * (t - 1) ** 2;
+/**
+ * Smooth 0 → 1 transition between `edge0` and `edge1`, the same argument order as `smoothstep` in GLSL.
+ * Note: `THREE.MathUtils.smoothstep` takes `(x, min, max)`.
+ * Плавный переход от 0 к 1 между `edge0` и `edge1`, порядок аргументов как у `smoothstep` в GLSL.
+ * Внимание: `THREE.MathUtils.smoothstep` принимает `(x, min, max)`.
+ */
+export const smoothstep = (edge0, edge1, x) => {
+    const t = Math.min(1, Math.max(0, (x - edge0) / (edge1 - edge0)));
+    return t * t * (3 - 2 * t);
+};
+//# sourceMappingURL=ease.js.map

package/dist/core/ease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ease.js","sourceRoot":"","sources":["../../src/core/ease.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,MAAM,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,YAAY,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjG,wHAAwH;AACxH,MAAM,CAAC,MAAM,WAAW,GAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,CAAS,EAAU,EAAE;IAC1E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC"}

package/dist/core/loop.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The frame loop: calls `frame(dt, now)` once per screen frame with the delta capped at `maxDt`.
+ * No `three` and no DOM types here: `requestAnimationFrame` is taken from `globalThis` (or injected), so the cap logic runs in tests.
+ * Цикл кадров: зовёт `frame(dt, now)` раз за кадр экрана с дельтой, ограниченной `maxDt`.
+ * Здесь нет ни `three`, ни типов DOM: `requestAnimationFrame` берётся из `globalThis` (или подставляется), так что логика потолка проверяется тестами.
+ */
+export interface LoopOptions {
+    /**
+     * The upper bound of the frame delta, in seconds. It is NOT a simulation rate: the frame rate stays the screen's.
+     * It exists so that a hidden tab or a stall does not deliver a `dt` of seconds, which would send every tween to its end
+     * and every spring across the screen in one frame. Our projects use 1/30, 0.05 or 0.1: pick it deliberately.
+     * Springs from `spring` do not depend on it for stability.
+     * Верхний предел дельты кадра в секундах. Это НЕ частота симуляции: частота кадров остаётся экранной.
+     * Он нужен, чтобы после фона вкладки или подвисания не прилетел `dt` в секунды: все твины ушли бы в конец,
+     * а пружины прыгнули бы через весь экран за один кадр. У нас 1/30, 0.05 или 0.1: выбирай осознанно.
+     * Пружинам из `spring` он для устойчивости не нужен.
+     */
+    maxDt: number;
+    /** Default: the global `requestAnimationFrame`. / По умолчанию глобальный `requestAnimationFrame`. */
+    schedule?: (callback: (now: number) => void) => number;
+    /** Default: the global `cancelAnimationFrame`. / По умолчанию глобальный `cancelAnimationFrame`. */
+    cancel?: (handle: number) => void;
+    /** Time in milliseconds, on the same clock as the timestamps `schedule` passes. Default: `performance.now`. / Время в миллисекундах на тех же часах, что и метки от `schedule`. По умолчанию `performance.now`. */
+    now?: () => number;
+}
+export interface Loop {
+    /** Stop the loop. Safe to call twice and from inside `frame`. / Остановить цикл. Можно звать дважды и изнутри `frame`. */
+    stop(): void;
+    readonly running: boolean;
+}
+/**
+ * Start the loop. `frame(dt, now)` gets `dt` in seconds (never negative, never above `maxDt`) and `now`, the raw timestamp in milliseconds:
+ * keep real time for shaders from `now`, and move things by `dt`. The first frame measures from the moment of the call.
+ * Запустить цикл. `frame(dt, now)` получает `dt` в секундах (не меньше нуля и не больше `maxDt`) и `now`, сырую метку в миллисекундах:
+ * реальное время для шейдеров бери из `now`, а двигай всё по `dt`. Первый кадр отсчитывается от момента вызова.
+ */
+export declare function startLoop(frame: (dt: number, now: number) => void, options: LoopOptions): Loop;

package/dist/core/loop.js

@@ -0,0 +1,47 @@
+/**
+ * The frame loop: calls `frame(dt, now)` once per screen frame with the delta capped at `maxDt`.
+ * No `three` and no DOM types here: `requestAnimationFrame` is taken from `globalThis` (or injected), so the cap logic runs in tests.
+ * Цикл кадров: зовёт `frame(dt, now)` раз за кадр экрана с дельтой, ограниченной `maxDt`.
+ * Здесь нет ни `three`, ни типов DOM: `requestAnimationFrame` берётся из `globalThis` (или подставляется), так что логика потолка проверяется тестами.
+ */
+/**
+ * Start the loop. `frame(dt, now)` gets `dt` in seconds (never negative, never above `maxDt`) and `now`, the raw timestamp in milliseconds:
+ * keep real time for shaders from `now`, and move things by `dt`. The first frame measures from the moment of the call.
+ * Запустить цикл. `frame(dt, now)` получает `dt` в секундах (не меньше нуля и не больше `maxDt`) и `now`, сырую метку в миллисекундах:
+ * реальное время для шейдеров бери из `now`, а двигай всё по `dt`. Первый кадр отсчитывается от момента вызова.
+ */
+export function startLoop(frame, options) {
+    const { maxDt } = options;
+    if (!(maxDt > 0) || !Number.isFinite(maxDt))
+        throw new RangeError(`startLoop: maxDt must be a positive number of seconds, got ${maxDt}`);
+    const host = globalThis;
+    const schedule = options.schedule ?? host.requestAnimationFrame?.bind(host);
+    const cancel = options.cancel ?? host.cancelAnimationFrame?.bind(host);
+    const now = options.now ?? (() => host.performance?.now() ?? Date.now());
+    if (!schedule || !cancel)
+        throw new Error('startLoop: requestAnimationFrame is not available here, pass `schedule` and `cancel`');
+    let last = now();
+    let handle = 0;
+    let running = true;
+    const tick = (time) => {
+        // Schedule first: a throw inside `frame` must not silently end the loop, and `stop()` inside it must still win.
+        // Сначала планируем следующий: исключение в `frame` не должно молча остановить цикл, а `stop()` внутри него всё равно побеждает.
+        handle = schedule(tick);
+        const dt = Math.min(Math.max((time - last) / 1000, 0), maxDt);
+        last = time;
+        frame(dt, time);
+    };
+    handle = schedule(tick);
+    return {
+        get running() {
+            return running;
+        },
+        stop() {
+            if (!running)
+                return;
+            running = false;
+            cancel(handle);
+        },
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/core/loop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkCH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAwC,EAAE,OAAoB;IACpF,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,8DAA8D,KAAK,EAAE,CAAC,CAAC;IAEzI,MAAM,IAAI,GAAG,UAAkB,CAAC;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAElI,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;IACjB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE;QAChC,gHAAgH;QAChH,iIAAiI;QACjI,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,GAAG,IAAI,CAAC;QACZ,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC;IACF,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAExB,OAAO;QACH,IAAI,OAAO;YACP,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,IAAI;YACA,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/core/rng.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A random number generator returning [0, 1). Any one fits, a seeded one included.
+ * Генератор случайных чисел [0, 1). Подойдёт любой, в том числе с зерном.
+ */
+export type Rng = () => number;
+/**
+ * A tiny deterministic generator (mulberry32): the same seed gives the same sequence on every machine, so a game,
+ * a map or a scatter of grass can be replayed from its seed. The sequence is frozen by a test against the original
+ * from pkt-3match: do not change the arithmetic, saved seeds depend on it.
+ * Маленький детерминированный генератор (mulberry32): одно зерно даёт одну последовательность на любой машине, поэтому партию,
+ * карту или раскладку травы можно повторить по зерну. Последовательность заморожена тестом по оригиналу из pkt-3match:
+ * арифметику не менять, от неё зависят сохранённые зёрна.
+ */
+export declare function mulberry32(seed: number): Rng;
+/** An integer in [0, count). / Целое число в [0, count). */
+export declare function randomInt(rng: Rng, count: number): number;

package/dist/core/rng.js

@@ -0,0 +1,23 @@
+/**
+ * A tiny deterministic generator (mulberry32): the same seed gives the same sequence on every machine, so a game,
+ * a map or a scatter of grass can be replayed from its seed. The sequence is frozen by a test against the original
+ * from pkt-3match: do not change the arithmetic, saved seeds depend on it.
+ * Маленький детерминированный генератор (mulberry32): одно зерно даёт одну последовательность на любой машине, поэтому партию,
+ * карту или раскладку травы можно повторить по зерну. Последовательность заморожена тестом по оригиналу из pkt-3match:
+ * арифметику не менять, от неё зависят сохранённые зёрна.
+ */
+export function mulberry32(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** An integer in [0, count). / Целое число в [0, count). */
+export function randomInt(rng, count) {
+    return Math.floor(rng() * count);
+}
+//# sourceMappingURL=rng.js.map

package/dist/core/rng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng.js","sourceRoot":"","sources":["../../src/core/rng.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACR,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IACjD,CAAC,CAAC;AACN,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,GAAQ,EAAE,KAAa;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;AACrC,CAAC"}