@energy8platform/golem 0.2.1 → 0.5.0

package/README.md

@@ -2,6 +2,21 @@
 
 Документ (`rig.json`, формат v2) — источник истины. Агент работает через MCP, человек — через вьюер и редактор в браузере (`npm run editor`). Рантайм — PixiJS v8.
 
+Поддержан рабочий процесс для персонажей в полный рост: утверждённый арт + скрытые дорисовки,
+плавное прохождение ключей, длинные IK-цепи, передача реквизита, запекание вторички, clipping,
+редактирование весов и проверяемые прозрачные кадры/MP4 60 fps.
+[Что изменилось, как использовать и результаты проверок](docs/verification-2026-09-27.md).
+
+В 0.4 добавлен пилот параметрической мимики: независимые глаза, совместные формы
+«улыбка × открытие рта», ползунки и ключевые формы в редакторе, дорожки параметров
+и проверка сочетаний через реальный рендер. [Устройство и API](docs/expression-controls.md),
+[воспроизводимый персонаж Milo](examples/expressions/README.md).
+
+В 0.5 добавлен [редактор деталей и костей для встраиваемых превью](docs/interactive-editor.md):
+правки мышью, группы, отмена и отдельные JSON-поправки. Поправки костей применяются
+поверх параметрической мимики и сохраняются при смене анимации.
+[Результаты объединения и проверок](docs/verification-2026-09-28.md).
+
 ```
 src/rig-format.ts       схема документа (zod) + семантическая валидация; v1: deform-треки, asset.frame (атлас)
 src/rig-anim.ts         чистая математика: easing, семплирование, Pose, аффинные матрицы костей, контуры слотов
@@ -13,6 +28,10 @@ src/rig-symbol.ts       RigSymbol — адаптер под SymbolView из @ene
 src/rig-presets.ts      пресеты: idle_breathing, weight_shift, win_bounce, anticipation_shake, blink, mouth_talk, dim, symbol_idle, symbol_win
 src/rig-tools.ts        операции над документом, импорт слоёв (swap/bone), createSymbol, replaceAsset, layerPrompt
 src/rig-check.ts        автокритика без рендера: out_of_canvas, static_track, loop_seam, deform_flip, patch_offset, motion_pop, …
+src/rig-motion.ts       градиент/сглаживание/фиксация весов, attach-to-bone, запекание вторички
+src/rig-quality.ts      проходные ключи, скорость петли, вторичка, порядок слоёв, ориентиры сменных рисунков
+src/rig-gates.ts        пороги движения, контакты/пропорции, условия FX, реальные переходы AnimationState
+src/rig-qa.ts           манифесты кадров с хешами исходных данных и проверкой полноты
 src/rig-history.ts      снимки .rig-history/, undo, структурный diff
 src/rig-atlas.ts        упаковка PNG-слоёв в atlas.png с экструзией краёв
 src/rig-templates.ts    rig_save_as_preset: шаблон из готовой анимации (треки относительно rest, кости по role, множители)
@@ -157,6 +176,13 @@ golem editor --root public/assets/rigs   # редактор над ригами
 `public/`, vite dev перезагружает игру на каждую запись редактора. Спека:
 `docs/superpowers/specs/2026-09-15-engine-integration-design.md`.
 
+### Правки мышью прямо в превью
+
+Отдельный браузерный модуль `@energy8platform/golem/interactive-editor` подключается к
+`RigPlayer`: выбор по видимым пикселям, перемещение, масштаб по осям и углам, вращение,
+группы связанных деталей, отмена и JSON с правками. [Подключение и ограничения](docs/interactive-editor.md).
+Полный редактор по-прежнему отвечает за кости, веса, IK и ключи анимации.
+
 ### Настоящие данные
 
 ```bash
@@ -323,7 +349,7 @@ IK, тащить напрямую нельзя: жест перенаправл
 ## Шаг 4 — риг класса Spine: формат v2 и импорт настоящего Spine-проекта (ross)
 
 Инструмент больше не «двигает картинки»: документ v2 — это меши с весами костей, регионы, пути, shear и режимы наследования,
-ограничения IK (1–2 кости, softness/stretch/compress), transform (мировой и локальный, relative) и path (4 режима шага,
+ограничения IK (1–2 кости с softness/stretch/compress; длинные цепи через CCD), transform (мировой и локальный, relative) и path (4 режима шага,
 3 режима поворота, замкнутые и открытые пути), треки деформации вершин, порядка отрисовки, цвета слота и миксов ограничений.
 Это своя реализация по документированной семантике Spine, не порт рантайма; spine-core используется только как оракул в тестах.
 
@@ -352,7 +378,7 @@ npm run ktx2 -- ross/ross.ktx2 ross/ross.png   # транскодер из three
 transform- и path-ограничения правят мировую матрицу и раскладываются обратно в локальные значения (иначе при неравномерном
 масштабе родителя поворот «уезжает»); двухкостный IK при отрицательном масштабе добавляет 180° и зеркалит сгиб.
 
-Не поддержано или отличается: linked mesh, clipping/bounding box/point attachments (пропускаются с предупреждением), скины
+Не поддержано или отличается при импорте Spine: linked mesh, clipping/bounding box/point attachments (пропускаются с предупреждением; собственные clipping-маски Golem задаются через `slot.clip`), скины
 сливаются в один с префиксом (переключения нет), physics 4.2 и sequence 4.1 нет, смешивание анимаций — наш `AnimationState`
 (кроссфейд поз), а не MixBlend-треки; в локальном режиме transform-ограничения масштаб смешивается линейно (spine-core делит
 на масштаб кости); IK у костей с нестандартным `inherit` приближённый.

package/dist/editor.css

@@ -698,4 +698,54 @@ h4 {
   color: var(--fg2);
   font-size: 11px;
 }
+.control-panel {
+  padding: 14px;
+  font-size: 12px;
+}
+.control-panel p {
+  color: #a9b2bf;
+  line-height: 1.5;
+}
+.control-panel label {
+  display: block;
+  margin: 12px 0;
+}
+.control-panel select {
+  width: 100%;
+  margin-top: 6px;
+}
+.control-slider span {
+  display: flex;
+  justify-content: space-between;
+}
+.control-slider input {
+  width: 100%;
+  margin-top: 6px;
+}
+.control-panel button {
+  margin: 5px 5px 5px 0;
+}
+.control-panel fieldset {
+  border: 0;
+  padding: 0;
+  min-width: 0;
+}
+.keyform-channel {
+  margin: 16px 0;
+}
+.keyform-channel b {
+  display: block;
+  margin-bottom: 6px;
+}
+.keyform-channel input {
+  width: 82px;
+}
+.keyform-points {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 4px;
+}
+.keyform-points label {
+  margin: 3px 0;
+}
 /*# sourceMappingURL=editor.css.map */