wenay-react2 1.0.44 → 1.0.45

package/doc/changes/v1.0.44.md

@@ -2,7 +2,7 @@
 
 Date: 2026-07-10
 
-Status: ready for publish.
+Status: released.
 
 - Fixed: `createColumnState` no longer persists `visible=false` for a column
   hidden solely by runtime `presentGate` when another grid interaction is read

package/doc/changes/v1.0.45.md

@@ -0,0 +1,9 @@
+# v1.0.45 — Media and Peer React adapters
+
+Status: ready for publication.
+
+- Updated `wenay-common2` to `^1.0.73`.
+- Added `useMediaSource` for capture lifecycle only; video/audio frames stay outside React state.
+- Added `usePeer` as a thin Peer SDK adapter with mirrored store, route/status and explicit resync controls.
+- Added QA stand cards 38–40 and focused hook tests.
+- Verified with qa-check TypeScript, full Jest, package build, diff-check and the live stand; manual stand verification was confirmed by the user.

package/doc/progress/column-state-present-gate.md

@@ -24,5 +24,5 @@ all known columns.
 
 ## Result
 
-Version v1.0.44 is prepared for publication; durable details are in
+Published as `wenay-react2@1.0.44`; durable details are in
 `doc/changes/v1.0.44.md`.

package/doc/progress/common2-adoption-1.0.73.md

@@ -0,0 +1,30 @@
+# wenay-common2 1.0.73 adoption — progress
+
+## Update
+
+- Previous dependency: 1.0.70.
+- npm latest verified: 1.0.73.
+- Updated dependency and lockfile to 1.0.73.
+- Compatibility: `tsc -p tsconfig.qa-check.json --noEmit` and full Jest 21 suites / 68 tests pass.
+
+## Architecture decision
+
+| common2 capability | wenay-react2 decision | Reason |
+| --- | --- | --- |
+| Peer gap repair / `resync()` (1.0.71) | Core-only protocol; future `usePeer` may expose status and explicit `resync` | React must not own journal or repair state. |
+| Hidden-tab Media capture (1.0.72) | Adopt core defaults, no adapter | Browser worker/ImageCapture implementation belongs below React. |
+| `Media.attachVideoCanvas` / audio player / publish pipe (1.0.73) | Recipe and QA consumer first; thin ref-lifecycle hooks only if repeated | Frame decode/playback must bypass React renders. |
+
+## Follow-up
+
+- Keep the existing `useMediaSource`, `usePeer` and WebRTC recipe items in target.
+- Add a real Media/Peer QA consumer before introducing any new hook.
+- No raw route-coordinator hook: Peer mirrors already survive route changes.
+## Implementation batch
+
+- Added `useMediaSource`: React owns source start/stop/device lifecycle only; frames remain on the common2 Listen path.
+- Added `usePeer`: React exposes an SDK peer's mirrored store, low-frequency route state and explicit controls; it owns no repair or transport state.
+- QA cards 38/39/40 cover camera canvas viewer, microphone player and an in-process Peer host/mirror/resync scenario.
+- Verification: qa-check TypeScript, Jest 22 suites / 71 tests, package build, diff-check and live stand HTTP 200.
+- Manual Verify: run cards 38, 39, 40 together with existing replay cards 23 and 34 before release.
+- Manual verification completed by the user on the stand; release candidate is 1.0.45.

package/doc/target/my.md

@@ -2,9 +2,10 @@
 
 Правила ведения: [README.md](README.md). Ниже — статус по задачам; **исходные надиктовки сохранены дословно в конце файла** (ничего не удаляю).
 
-## In Progress
-
-_Пусто._
+## In Progress
+
+_Пусто._
+
 
 «Hook extraction — do-now кандидаты (3)» выполнен 2026-07-09: `useCacheMapPersistence` (cache.ts), `useResizeObserver`/`useElementSize` (MyResizeObserver.tsx), `useLogsPageTable` (logs.tsx); старые имена — compatibility wrappers, card 25 не тронута. Проверено: tsc qa-check, jest 45/45, build, стенд 3010 (карточки 21 F5-persistence / 19 resize / 9 logs). Durable-запись: `doc/changes/v1.0.41.md`; parked/отклонённые кандидаты остаются в `doc/progress/hook-extraction-audit.md`.
 
@@ -18,12 +19,13 @@ _Пусто._
   - Оценка: эффективность high (самый дешёвый рост юзабельности), простота easy/medium (докосновно + один реэкспорт-модуль), риск low (аддитивно, публичный API не меняется).
   - Связка: breaking-версия (A3 + снос deprecated `onCLickClose`/`keySave`/`DragArea`/`menuR`, сужение `ListenApi`) идёт ПОСЛЕ витрины — витрина и есть список того, что сносим.
 
-- **common2 1.0.66–1.0.68 adoption: Media + route coordinator/WebRTC React surface** (из надиктовки №4 «посмотри, что нового, создай цели использовать»).
+- **common2 1.0.66–1.0.73 adoption: Media + Peer/route React surface** (из надиктовки №4 «посмотри, что нового, создай цели использовать»).
   - Контекст: 1.0.66 = `Media` (захват мик/камера как бинарные Listen/replay-источники, `decodeMediaFrame`), 1.0.67 = `Replay.createRouteCoordinator` (policy-gated relay↔direct, link.subscribe без switchRoute), 1.0.68 = WebRTC direct-путь (`createSignalHub` по существующему RPC-сокету, `createWebRtcConnector` с инжектируемой `rtc`-фабрикой — инжекция `() => new RTCPeerConnection(cfg)` живёт на браузерной/React-стороне, `acceptWebRtcDirect`, `serveReplayChannel`). Вместе: media → replay line → policy-маршрутизация relay/direct.
-  - **1. `useMediaSource` (capture-control hook)** — пересмотр прежнего решения «Media-хуков намеренно нет»: consumption по-прежнему через существующие `useReplay*`-хуки, но capture `control` (`start()` → `'idle'|'requesting'|'live'|'denied'|'no-device'|'error'`, `stop()`, `setDevice`, `listDevices`, stats) — это permission/device/lifecycle state machine, hook-shaped. Хук: state как React state, `listen` наружу как есть, stop() на unmount. QA card: камера → `replay:true` линия → canvas через `useReplaySubscribe`+`decodeMediaFrame`; deny/no-device видимы на стенде.
-  - **2. Peer SDK adapter (supersedes the raw coordinator-link idea, common2 1.0.69)** — React surface over `Peer.createPeerClient`: `usePeer(client, account)` -> peer's mirrored store (plugs into existing `useStoreNode`/`useStoreKeys`) + route state/controls (`promoteDirect` result-object, `reinterposeRelay`, `route()`, `ready`, `seq()`). Do NOT bend existing route hooks; mirrors survive route changes by design. QA card modeled on oracle `replay/peer-sdk.test.ts` (fake in-proc RTC runtime); common2 1.0.70 ships the oracles + `demo/` stand in the package as living examples to crib from.
+  - **1. `useMediaSource` — DONE in 1.0.45.** Capture lifecycle only: state, start/stop, device selection and stats; frame consumption stays on Listen/replay. QA cards 38/39 use core canvas/audio viewers.
+  - **2. Peer SDK adapter — DONE in 1.0.45.** `usePeer(client, account)` exposes the mirrored store, route/status and explicit controls including resync, without taking over protocol repair or transport. QA card 40 covers an in-process host/mirror/resync scenario.
   - **3. WebRTC recipe (docs/example, not a hook)** — how the app injects the `rtc` factory (`() => new RTCPeerConnection(cfg)`) and wires the signal port from `createRpcServerAuto`; combine with a Media source (call/stream demo) over Peer. Real-browser ICE serialization is fixed in 1.0.69 (`toJSON()` on the wire), so a live two-tab demo is feasible — see common2 `demo/` shared-cursors stand.
-  - Оценка: 1 — simple/low-risk (аддитивно); 2 — medium (in-proc fake стенд, по образцу peer-sdk oracle); 3 — docs-first. Приоритет: после architecture-fix очереди A1-A10.
+  - Оценка: 1 — simple/low-risk (аддитивно); 2 — medium (in-proc fake стенд, по образцу peer-sdk oracle); 3 — docs-first. Приоритет: после architecture-fix очереди A1-A10.
+  - **Аудит 1.0.71–1.0.73 (2026-07-10, dependency обновлена до 1.0.73)**: `Peer` repair/resync (1.0.71) остаётся core protocol — React не должен повторять gap/journal state machine; `usePeer` может лишь отразить `peer(account)` store/route и вызвать `resync()` по app-owned transport reconnect. Media hidden-tab workers/ImageCapture (1.0.72) принимаем автоматически через core defaults, без React-кода. Media viewer helpers (1.0.73: canvas/audio/publish pipe) — core imperative hot path; React-кандидаты только тонкие lifecycle bindings над ref (`useMediaVideoCanvas`, `useMediaAudioPlayer`), без frame-level React state. Сначала docs/recipe + QA card с реальным consumer; хук — лишь если recipe повторяется.
 
 - **Context menu / Menu: controller-first split**.
   - Прогресс/оценка: [../progress/hook-controller-opportunities.md](../progress/hook-controller-opportunities.md)
@@ -81,7 +83,7 @@ _Пусто._
 
 ## Verify
 
-- **ColumnState present-gate не должен перезаписывать пользовательскую visibility** — реализация и release v1.0.44 готовы; [progress](../progress/column-state-present-gate.md), [changelog](../changes/v1.0.44.md). Проверить публикацию пакета и потребительский repro: gated `b` остаётся `visible:true` после resize другой колонки и становится видимой при открытии gate.
+_Пусто._ «ColumnState present-gate» выпущен как v1.0.44: repro сначала подтвердил утечку `visible.b=false` после чужого resize под закрытым gate; фикс читает visibility только для ключей, проходящих gate; targeted Jest 3/3, полный Jest 64/64, tsc и build прошли; пакет опубликован. Durable-запись: `doc/changes/v1.0.44.md`; рабочая история: `doc/progress/column-state-present-gate.md`.
 
 «Система стилей и CSS variables» проверена: `doneInCode=fully`, `.wenayColsMenu*`/`--cols-menu-*` и `--cols-dots-*`/`--cols-card-*` в коде, changelog v1.0.38/v1.0.39/v1.0.41, отгружено в релизах. Удалено; durable-запись — `doc/progress/style-system-normalization.md`.
 

package/doc/wenay-react2.md

@@ -472,9 +472,9 @@ const tt = useReplayHistory(history, (frame) => draw(frame), {head: () => replay
 tt.live; tt.seq; tt.head; tt.pause(); tt.play(); tt.seek({seq})
 ```
 
-Route hand-off here is the MANUAL surface (`switchRoute`). common2 1.0.67 `Replay.createRouteCoordinator` moves route decisions (policy, promote/fallback/shadow) out of the consumer; a coordinator `link.subscribe(cb)` handle has the same shape (`ready, seq(), label(), active()`) and survives every route change, so components consuming a coordinator link do not need `switchRoute` at all. common2 1.0.68 supplies the direct transport for it: `createWebRtcConnector` with an app-injected `rtc: () => new RTCPeerConnection(cfg)` factory (the browser — i.e. the React app — owns that injection) and signaling over the existing RPC socket (`createSignalHub`). common2 1.0.69 wraps the whole stack into the `Peer` SDK (`wenay-common2/peer`): `createPeerClient(...).peer(account)` returns a live mirrored store (works with `useStoreNode`/`useStoreKeys` as-is) + route control, surviving relay<->direct hand-offs in one seq space. A dedicated `usePeer` adapter is a target-backlog item, not yet a library surface.
+Route hand-off here is the MANUAL surface (`switchRoute`). common2 1.0.67 `Replay.createRouteCoordinator` moves route decisions (policy, promote/fallback/shadow) out of the consumer; a coordinator `link.subscribe(cb)` handle has the same shape (`ready, seq(), label(), active()`) and survives every route change, so components consuming a coordinator link do not need `switchRoute` at all. common2 1.0.68 supplies the direct transport for it: `createWebRtcConnector` with an app-injected `rtc: () => new RTCPeerConnection(cfg)` factory (the browser — i.e. the React app — owns that injection) and signaling over the existing RPC socket (`createSignalHub`). common2 1.0.69 wraps the whole stack into the `Peer` SDK (`wenay-common2/peer`): `createPeerClient(...).peer(account)` returns a live mirrored store (works with `useStoreNode`/`useStoreKeys` as-is) + route control, surviving relay<->direct hand-offs in one seq space. `usePeer(client, account)` is the thin React adapter: it returns that mirror plus low-frequency route/status and explicit route/resync controls; it does not own journal, repair or transport state.
 
-Media lines (common2 1.0.66 `Media.createAudioSource` / `Media.createVideoSource`) are ordinary binary Listen sources; with `replay:true` their `listen` is a replay line, so `useReplaySubscribe` / `useReplayFrame` consume mic/camera frames with no media-specific hook. Each frame is one `Uint8Array` (`Media.decodeMediaFrame`); draw/play it via ref (canvas, AudioContext), never useState — the same rule as any high-frequency line. Without `replay`, the plain `listen` works with the listen hooks above.
+Media lines (common2 1.0.66 `Media.createAudioSource` / `Media.createVideoSource`) are ordinary binary Listen sources; with `replay:true` their `listen` is a replay line, so `useReplaySubscribe` / `useReplayFrame` consume mic/camera frames with no media-specific hook. `useMediaSource(kind, options)` is only the capture lifecycle adapter (`start`, `stop`, device selection, state and stats); it stops a started source on unmount and returns `listen` unchanged. Each frame is one `Uint8Array` (`Media.decodeMediaFrame`); draw/play it via ref (canvas, AudioContext), never useState — the same rule as any high-frequency line. Without `replay`, the plain `listen` works with the listen hooks above.
 
 Contract: `off()` on unmount, StrictMode-safe; seq survives resubscribes inside one mount (keepSeq, default on) — a resubscribe reconnects with `{since}` and gets the journal tail, not a keyframe. Across a FULL unmount/remount keep the position outside via `onSeq` and pass it back as `since`. `seq()` is a getter — high-frequency lines (video frames, ticks) do not re-render per event; draw to canvas via ref, bypassing VDOM. Freshness: detection lives in wenay-common2 (`staleMs` watchdog); the non-route hooks mirror its edge-triggered `onStale` into `stale`, so a fresh 100 ev/s line causes zero extra renders. Route hand-off is explicit through `switchRoute(nextRemote, {label?, since?, reset?, policy?, hint?})`: old route stays live while the replacement catches up by `seq`, then closes. `useReplayHistory` is archive playback — staleness does not apply. QA cards 23 (video line + conflation + time travel + freshness), 24 (store sync), 25 (per-key feed), and 26 (route hand-off) are the live examples.
 

package/lib/common/src/hooks/index.d.ts

@@ -1,7 +1,9 @@
+export * from './useReplay';
+export * from './useObserveStore';
+export * from './useOutside';
 export * from './useKeyboard';
 export * from './useDraggable';
 export * from './useReorder';
 export * from './useReorderBoard';
-export * from './useObserveStore';
-export * from './useReplay';
-export * from './useOutside';
+export * from './useMedia';
+export * from './usePeer';

package/lib/common/src/hooks/index.js

@@ -1,7 +1,9 @@
+export * from './useReplay';
+export * from './useObserveStore';
+export * from './useOutside';
 export * from './useKeyboard';
 export * from './useDraggable';
 export * from './useReorder';
 export * from './useReorderBoard';
-export * from './useObserveStore';
-export * from './useReplay';
-export * from './useOutside';
+export * from './useMedia';
+export * from './usePeer';

package/lib/common/src/hooks/useMedia.d.ts

@@ -0,0 +1,14 @@
+import { Media } from "wenay-common2";
+export type UseMediaSourceController = {
+    source: Media.MediaSource;
+    listen: Media.MediaAnyListen;
+    state: Media.MediaSourceState;
+    start(): Promise<Media.MediaSourceState>;
+    stop(): void;
+    setDevice(id: string): Promise<Media.MediaSourceState>;
+    listDevices(): Promise<Media.MediaSourceDevice[]>;
+    stats(): Media.MediaStats;
+};
+/** React lifecycle adapter for a common2 Media source. Frames stay on `listen`:
+ * draw/play them through a canvas or AudioContext, never through React state. */
+export declare function useMediaSource(kind: "audio" | "video", options?: Media.AudioSourceOpts | Media.VideoSourceOpts): UseMediaSourceController;

package/lib/common/src/hooks/useMedia.js

@@ -0,0 +1,39 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Media } from "wenay-common2";
+/** React lifecycle adapter for a common2 Media source. Frames stay on `listen`:
+ * draw/play them through a canvas or AudioContext, never through React state. */
+export function useMediaSource(kind, options = {}) {
+    const sourceRef = useRef(null);
+    if (!sourceRef.current)
+        sourceRef.current = kind == "video"
+            ? Media.createVideoSource(options)
+            : Media.createAudioSource(options);
+    const source = sourceRef.current;
+    const [state, setState] = useState(source.state);
+    const sync = useCallback(() => setState(source.state), [source]);
+    const start = useCallback(async () => {
+        const next = await source.start();
+        setState(next);
+        return next;
+    }, [source]);
+    const stop = useCallback(() => {
+        source.stop();
+        sync();
+    }, [source, sync]);
+    const setDevice = useCallback(async (id) => {
+        const next = await source.setDevice(id);
+        setState(next);
+        return next;
+    }, [source]);
+    useEffect(() => () => source.stop(), [source]);
+    return useMemo(() => ({
+        source,
+        listen: source[1],
+        state,
+        start,
+        stop,
+        setDevice,
+        listDevices: () => source.listDevices(),
+        stats: () => source.getStats(),
+    }), [source, state, start, stop, setDevice]);
+}

package/lib/common/src/hooks/usePeer.d.ts

@@ -0,0 +1,16 @@
+import { Peer } from "wenay-common2";
+/** Thin React view over common2 Peer SDK. The SDK keeps route/repair ownership;
+ * consumers use `store` with useStoreNode/useStoreKeys as usual. */
+export declare function usePeer<T extends object>(client: Peer.PeerClient<T>, account: string): {
+    store: import("wenay-common2/lib/Common/Observe").Store<T>;
+    ready: boolean;
+    route: string;
+    state: import("wenay-common2/lib/Common/events/route-coordinator").tRouteState;
+    seq: () => number;
+    promoteDirect: (opts?: import("wenay-common2/lib/Common/events/route-coordinator").PromoteDirectOpts) => Promise<import("wenay-common2/lib/Common/events/route-coordinator").RouteOpResult>;
+    reinterposeRelay: (reason?: unknown) => Promise<import("wenay-common2/lib/Common/events/route-coordinator").RouteOpResult>;
+    fallback: (reason?: unknown) => Promise<import("wenay-common2/lib/Common/events/route-coordinator").RouteOpResult>;
+    block: (reason?: unknown) => Promise<import("wenay-common2/lib/Common/events/route-coordinator").RouteOpResult>;
+    resync: () => Promise<void>;
+    close: () => void;
+};

package/lib/common/src/hooks/usePeer.js

@@ -0,0 +1,29 @@
+import { useEffect, useMemo, useState } from "react";
+/** Thin React view over common2 Peer SDK. The SDK keeps route/repair ownership;
+ * consumers use `store` with useStoreNode/useStoreKeys as usual. */
+export function usePeer(client, account) {
+    const peer = useMemo(() => client.peer(account), [client, account]);
+    const [epoch, setEpoch] = useState(0);
+    const [ready, setReady] = useState(false);
+    useEffect(() => {
+        let alive = true;
+        setReady(false);
+        peer.ready.then(() => { if (alive)
+            setReady(true); });
+        const off = client.onRoute(() => setEpoch(v => v + 1));
+        return () => { alive = false; off(); };
+    }, [client, peer]);
+    return useMemo(() => ({
+        store: peer.store,
+        ready,
+        route: peer.route(),
+        state: peer.state(),
+        seq: peer.seq,
+        promoteDirect: peer.promoteDirect,
+        reinterposeRelay: peer.reinterposeRelay,
+        fallback: peer.fallback,
+        block: peer.block,
+        resync: client.resync,
+        close: peer.close,
+    }), [client, peer, ready, epoch]);
+}

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "wenay-react2",
-  "version": "1.0.44",
-  "description": "Common react",
-  "strict": true,
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "lib/**/*",
-    "doc/**/*",
-    "!**/*.tsbuildinfo"
-  ],
-  "author": "wenay",
-  "license": "ISC",
-  "peerDependenciesMeta": {
-    "react-dom": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "ag-grid-community": "^35.1.0",
-    "ag-grid-react": "^35.1.0",
-    "re-resizable": "^6.11.2",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-rnd": "^10.5.3",
-    "wenay-common2": "^1.0.70"
-  },
-  "peerDependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0"
-  },
-  "engines": {
-    "node": ">=18",
-    "vscode": "^1.22.0"
-  },
-  "browserslist": {
-    "production": [
-      ">0.2%",
-      "not dead"
-    ],
-    "development": [
-      ">1%"
-    ]
-  },
-  "exports": {
-    ".": "./lib/index.js",
-    "./package.json": "./package.json"
-  }
-}
+{
+  "name": "wenay-react2",
+  "version": "1.0.45",
+  "description": "Common react",
+  "strict": true,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "lib/**/*",
+    "doc/**/*",
+    "!**/*.tsbuildinfo"
+  ],
+  "author": "wenay",
+  "license": "ISC",
+  "peerDependenciesMeta": {
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "ag-grid-community": "^35.1.0",
+    "ag-grid-react": "^35.1.0",
+    "re-resizable": "^6.11.2",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-rnd": "^10.5.3",
+    "wenay-common2": "^1.0.73"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "engines": {
+    "node": ">=18",
+    "vscode": "^1.22.0"
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead"
+    ],
+    "development": [
+      ">1%"
+    ]
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  }
+}