feat(motion): объединить сценарии интерфейса и проверки движения

.github/workflows/ci.yml

@@ -6,6 +6,11 @@ on:
   pull_request:
   merge_group:
   workflow_dispatch:
+    inputs:
+      profile_baseline:
+        description: 'Снять зарегистрированный размерный baseline PROFILE-01'
+        type: boolean
+        default: false
 
 permissions:
   contents: read
@@ -21,6 +26,12 @@ env:
   COREPACK_DEFAULT_TO_LATEST: "0"
 
 jobs:
+  # Только явный baseline-запрос: обычный кандидат может менять runtime и
+  # не обязан совпадать с зарегистрированным старым источником PROFILE-01.
+  profile-baseline:
+    if: ${{ github.event_name == 'workflow_dispatch' && inputs.profile_baseline }}
+    uses: ./.github/workflows/profile-01.yml
+
   verify:
     name: typecheck · build · size · package
     runs-on: ubuntu-latest
@@ -180,6 +191,16 @@ jobs:
       - name: Fuzz · finiteness gate (virtual-time, seeded LCG, zero-dep)
         run: pnpm vitest run --reporter=verbose test/*finiteness-fuzz.test.ts
 
+      # Проверяем настоящий C/header/API на зарегистрированном Node, сохраняя
+      # обычный suite выше на текущем Node24. Это не performance calibration.
+      - name: Setup registered native-clock Node
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v6
+        with:
+          node-version: "24.19.0"
+
+      - name: Native CPU clock · actual source and refusal controls
+        run: node test/fixtures/server-thread-cpu-clock-check.mjs
+
   mutation:
     name: driver mutation
     runs-on: ubuntu-latest

.github/workflows/profile-01.yml

@@ -0,0 +1,121 @@
+name: PROFILE-01 — проверка размерного протокола
+
+# Размерный вектор вызывается вручную через ci.yml в той же среде, что обычный CI
+# публичного репозитория. Время/GPU/энергия этой машины не являются device proof.
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+
+env:
+  COREPACK_ENABLE_DOWNLOAD_PROMPT: '0'
+  COREPACK_DEFAULT_TO_LATEST: '0'
+  PROFILE_SOURCE_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
+
+jobs:
+  probe:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    steps:
+      - name: Получить точный источник измерителя
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Настроить Node
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v6
+        with:
+          node-version: '24'
+
+      - name: Активировать закреплённый pnpm
+        run: |
+          corepack enable
+          corepack install --global pnpm@11.11.0
+
+      - name: Проверить точную версию протокола
+        shell: bash
+        run: |
+          set -euo pipefail
+          test "$(git rev-parse HEAD)" = "$PROFILE_SOURCE_SHA"
+          node --input-type=module <<'NODE'
+          import { PROFILE_01, preregistrationDigest, verifyPreregistration } from './bench/profile/profile-01-preregistration.mjs';
+          verifyPreregistration(PROFILE_01);
+          if (PROFILE_01.candidateSamplesObservedAtRegistration !== false) {
+            throw new Error('preregistration обязана предшествовать samples');
+          }
+          console.log(`preregistration digest: ${preregistrationDigest(PROFILE_01)}`);
+          NODE
+
+      - name: Установить зависимости
+        run: pnpm install --frozen-lockfile
+
+      - name: Измерить прежний размерный вектор
+        id: probe
+        shell: bash
+        run: |
+          set -euo pipefail
+          mkdir -p "$RUNNER_TEMP/profile-01-raw"
+          node bench/profile/probe-profile-01.mjs \
+            --mode old-vector \
+            --cells all \
+            --out "$RUNNER_TEMP/profile-01-raw"
+
+      - name: Независимо перепроверить raw-артефакт
+        if: ${{ !cancelled() && steps.probe.outcome != 'skipped' }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          for raw in "$RUNNER_TEMP"/profile-01-raw/*.json; do
+            test -f "$raw"
+            node bench/profile/validate-profile-01.mjs --raw "$raw"
+          done
+
+      - name: Проверить отказ внешнего validator на подменах настоящего результата
+        if: ${{ !cancelled() && steps.probe.outcome == 'success' }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          node --input-type=module <<'NODE'
+          import assert from 'node:assert/strict';
+          import { spawnSync } from 'node:child_process';
+          import { mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+          import { tmpdir } from 'node:os';
+          import { join } from 'node:path';
+          const rawDirectory = join(process.env.RUNNER_TEMP, 'profile-01-raw');
+          const files = readdirSync(rawDirectory).filter(name => name.endsWith('.json'));
+          assert.equal(files.length, 1);
+          const original = JSON.parse(readFileSync(join(rawDirectory, files[0]), 'utf8'));
+          const directory = mkdtempSync(join(tmpdir(), 'profile-replay-mutations-'));
+          try {
+            const cases = [
+              ['число', value => { value.costVector.scenarios[0].gzBytes += 1; }, 'scenarios не воспроизводится'],
+              ['identity', value => { value.head = '0'.repeat(40); }, 'baseProof не покрывает'],
+              ['клетки', value => { value.cellsUnproven = []; }, 'неизмеренные клетки потеряны'],
+            ];
+            for (const [name, mutate, rejection] of cases) {
+              const value = structuredClone(original);
+              mutate(value);
+              const path = join(directory, 'mutated.json');
+              writeFileSync(path, JSON.stringify(value));
+              const run = spawnSync(process.execPath, ['bench/profile/validate-profile-01.mjs', '--raw', path],
+                { encoding: 'utf8', timeout: 180_000, maxBuffer: 8 * 1024 * 1024 });
+              assert.equal(run.status, 1, `${name}: ${run.error ?? run.stderr}`);
+              assert.ok(run.stderr.includes(rejection), `${name}: неверная причина отказа: ${run.stderr}`);
+              console.log(`${name}: ожидаемый предметный отказ подтверждён`);
+            }
+          } finally {
+            rmSync(directory, { recursive: true, force: true });
+          }
+          NODE
+
+      - name: Опубликовать raw-артефакт
+        # Отрицательный результат сохраняется даже после отказа измерителя.
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: profile-01-raw-${{ env.PROFILE_SOURCE_SHA }}
+          path: ${{ runner.temp }}/profile-01-raw/
+          retention-days: 90

.gitignore

@@ -21,3 +21,7 @@ blob-report
 .playwright
 browser/.artifacts
 site/dist
+examples/reading-shelf/.artifacts
+examples/itinerary-sheet/.artifacts
+examples/call-sheet/.artifacts
+examples/audio-cue/.artifacts

CHANGELOG.md

@@ -7,6 +7,28 @@
 ## [Unreleased]
 
 ### Исправлено
+- `CompositorSpring`: синхронный callback во время передачи движения композитору
+  сохраняет новую цель, остановку или уничтожение. Устаревшая передача больше
+  не подменяет новое состояние живого движения.
+- `animate`: завершённые controls освобождают исполнителей, а завершённый
+  compositor-слот освобождает кривую и live-delegate даже при активном sibling.
+  Вложенный handoff из getter `requestFrame` сохраняет один кадровый цикл
+  после частичного host-отказа и в минифицированном npm-пакете.
+- `MotionValue` и подписки `./behaviors`: уничтожение освобождает внедрённый
+  scheduler и callback компонента даже при сохранённых controller/off handles.
+  Живые подписки сохраняют дедупликацию callback; `stop()` остаётся возобновляемым.
+- `MotionValue`: отзыв подписки освобождает callback; старая отписка не удаляет
+  повторную регистрацию. Callback нового запуска не теряется при перезапуске
+  из getter или слушателя до возврата прежнего tick.
+- `./svelte`: повторная подписка использует текущую регистрацию; отписка и
+  `destroy()` освобождают её callback, а старый handle не затрагивает преемника.
+- `MotionValue` после `destroy()` освобождает пользовательские `spring` и `requestFrame`,
+  не принимает новые подписки и не продолжает кадр или планирование после уничтожения
+  из getter или callback `requestFrame`. `CompositorSpring` и follow-контроллер освобождают
+  исходный `spring`; инертный handoff больше не читает его getters.
+- `./vue`: остановка `effectScope` освобождает активные `useMotionValue` и
+  `useSpring`, включая уже поставленные кадры. Уборка при unmount в Vue 3.0/3.1
+  и явный `MotionValue.destroy()` вне scope сохранены.
 - `./behaviors`: изменение snap-точек или размеров страниц сохраняет текущего
   владельца движения. Отмена и уничтожение из подписчика прекращают последующую
   доводку, планирование кадров и внешнее уведомление о закрытии.
@@ -18,6 +40,10 @@
   публичные типы не расширены.
 
 ### Добавлено
+- `CompositorSpring.handoffToCompositor(target)` завершает интерактивную live-фазу
+  автономным переходом с текущей позиции и скорости. Старый MotionValue становится
+  инертным после успешного native commit; неподдержанная форма продолжает live-путь.
+  Исполняемые примеры sheet и pager оставляют выбор snap/page и геометрию компоненту.
 - Управляемое присутствие: `createPresenceTransition` связывает одну цель видимости
   с группой анимаций, отменяет устаревший уход и освобождает исполнителей при очистке.
   Рабочий пример диалога поддерживает повторное открытие и Escape без ручного `done`.

README.md

@@ -19,7 +19,8 @@ spring-солвер, кейфреймы, инерция, FLIP) отделена
 pnpm add @labpics/motion
 ```
 
-Node ≥ 22, ESM и CJS, типы в комплекте. Фреймворк для биндинга — optional
+Серверная среда — Node ≥ 22; браузерная — ES2022 со встроенным `WeakRef`.
+ESM и CJS, типы в комплекте. Фреймворк для биндинга — optional
 peer. Git-установка не поддерживается (`dist/` собирается, в репозитории его
 нет) — установка из тарбола описана в [справочнике](docs/api.md).
 
@@ -111,11 +112,11 @@ pnpm site:preview   # отдаёт site/dist на локальном серве
 ## Карта пакета
 
 Импорт — `@labpics/motion` (ядро) или `@labpics/motion/<субпуть>`.
-Корневой экспорт + 43 субпути (входов `exports` в `package.json` — 44):
+Корневой экспорт + 44 субпути (входов `exports` в `package.json` — 45):
 
 | Группа | Субпути |
 | --- | --- |
-| Ядро анимации | `./nano` (WAAPI ≤ 1 КБ), `./animate` (one-liner фасад), `./frame`, `./driver`, `./compositor`, `./compositor/stagger`, `./waapi`, `./auto` |
+| Ядро анимации | `./nano` (WAAPI ≤ 1 КБ), `./animate` (one-liner фасад), `./frame`, `./driver`, `./compositor`, `./compositor/stagger`, `./compositor/follow`, `./waapi`, `./auto` |
 | Значения и физика | `./value`, `./spring`, `./decay`, `./easing`, `./keyframes`, `./stagger`, `./timeline`, `./presets`, `./tokens`, `./utils` |
 | Доменные эффекты | `./bindings`, `./flip`, `./projection`, `./smart`, `./gestures`, `./behaviors`, `./behaviors/reorder`, `./scroll`, `./in-view`, `./presence`, `./svg`, `./svg-morph`, `./a11y`, `./compiler/surface` (приватный executor compiled-поверхности) |
 | Биндинги | `./react`, `./preact`, `./vue`, `./svelte`, `./solid`, `./angular`, `./qwik`, `./lit`, `./wc` |
@@ -200,7 +201,7 @@ springFromDurationBounce(0.35, 0); // восприятие (duration, bounce) 
 | Раздел | Что внутри |
 | --- | --- |
 | [Рецепты](docs/recipes.md) | Runnable-интеграции: drag, FLIP, presence, скролл, bottom sheet |
-| [Справочник API](docs/api.md) | Все 43 субпути: что даёт каждый вход |
+| [Справочник API](docs/api.md) | Все 44 субпути: что даёт каждый вход |
 | [Архитектура](docs/architecture.md) | Слои движка, фазовая модель, инварианты, отвергнутые пути |
 | [Compositor](docs/compositor.md) | WAAPI-план, ретаргет, хендофф, fallback-матрица, поддержка браузеров |
 | [Projection](docs/projection.md) | Вложенный FLIP: дерево узлов, C¹-перехваты, не-цели v1 |