wenay-react2 1.0.43 → 1.0.45

package/doc/changes/v1.0.44.md

@@ -0,0 +1,14 @@
+# v1.0.44
+
+Date: 2026-07-10
+
+Status: released.
+
+- Fixed: `createColumnState` no longer persists `visible=false` for a column
+  hidden solely by runtime `presentGate` when another grid interaction is read
+  back. Opening the gate restores the user's saved visibility as intended.
+- Added: regression coverage for gated-column readback and normal user
+  visibility changes while the gate is open.
+- Verification: repro first failed on v1.0.43 (`visible.b` became `false` after
+  an unrelated resize); targeted Jest 3/3; full Jest 64/64; `tsc -p
+  tsconfig.qa-check.json --noEmit`; `pnpm run build`.

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

@@ -0,0 +1,28 @@
+# ColumnState present-gate — progress
+
+## Scope
+
+Fix the v1.0.43 regression reported by a consumer: a grid event must not persist
+`visible=false` for a column that is hidden only by the runtime `presentGate`.
+
+## Contract
+
+`presentGate` is application-owned runtime presence. `visible` is user-owned,
+persisted configuration. A grid readback may update visibility only when the
+column passes the gate; order, width, sort and filter continue to read back for
+all known columns.
+
+## Plan
+
+1. Reproduce against current source with a fake grid. **Confirmed:** an unrelated
+   resize changed gated `b` from persisted `visible=true` to `false`.
+2. Guard the visibility fold in `readFromGrid` with `passesPresentGate`. **Done.**
+3. Add regression coverage for closed and open gates. **Done:** fake GridApi
+   covers both the protected gated column and a normal open-gate visibility edit.
+4. Run TypeScript, Jest and package build; record release notes. **Done:**
+   targeted Jest 3/3, full Jest 64/64, qa-check TypeScript and build passed.
+
+## Result
+
+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,12 @@
 
 Правила ведения: [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`.
+«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`.
 
 (Предыдущий проход «Нормализация внутренних слоёв библиотеки» проверен multi-agent-верификацией и отгружен в v1.0.40/v1.0.41; durable-запись: `doc/progress/public-surface-normalization.md`, `doc/progress/hook-controller-opportunities.md`, `doc/changes/v1.0.38–v1.0.41.md`.)
 
@@ -16,12 +19,13 @@ _Пусто._ «Hook extraction — do-now кандидаты (3)» выполн
   - Оценка: эффективность 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)
@@ -42,10 +46,36 @@ _Пусто._ «Hook extraction — do-now кандидаты (3)» выполн
   - **A10 remaining (breaking only)**: raw `ListenApi` (emit/close) exposed from columnState/Toolbar onChange (narrowing is breaking); removal of deprecated `onCLickClose`/`keySave` — breaking pass only.
   - Rule: each fix is its own focused pass with verify (tsc+jest+build+stand); breaking removals only in a deliberate breaking version.
 
+- **Architecture follow-up: ownership and lifecycle boundaries (overlay / grid / columnState)** (code review 2026-07-10).
+  - **Overlay stack (high)**: `Overlay` instances independently subscribe to `document`. A `SettingsDialog` above a `ModalProvider` lets the lower modal handle the same Escape/outside interaction; this breaks SettingsDialog's two-stage Escape contract. Introduce an internal stack/arbiter so only the topmost dismissible layer receives Escape and outside-click; verify nested ModalProvider + SettingsDialog (search clear on first Escape, dialog close on second, parent remains open).
+  - **ag-grid row identity (high)**: `AgGridTable` currently lets a caller supply `getRowId` alongside `controller`, while the controller buffer owns another `getId`. Make the ownership unambiguous (reject/ignore override or explicitly derive the core identity); verify update/remove/reconnect with a controller and a conflicting callback.
+  - **ColumnGrid attachment ownership (high)**: one controller keeps one mutable `gridApi`, but its `Table` surface permits multiple mounts; an old table's destroy can detach the newer one. Either enforce one table per controller with a clear error or scope attachment state to a Table instance; verify two mounts plus either unmount order.
+  - **ColumnState contract consistency (medium)**: `groups` affects `visibleKeys()`/cards but is ignored when applying state to desktop ag-grid; `ColumnGrid.View` also forwards index `0` to a supplied `getId`. Align the shared config on both views and pass the actual row index. Add integration coverage.
+  - **Dispose lifecycle (medium)**: `createColumnGrid.dispose()` releases local listeners but not its attached grid listeners. Define dispose as a full release and make it detach the active grid; verify no grid events mutate state after dispose.
+  - Приоритет: отдельные focused passes; не смешивать с feature-задачами ColumnDots. Проверка каждого: tsc qa-check, jest, build и соответствующий lifecycle/integration test.
+
+- **QA-стенд: расширить интеграционное покрытие и сделать его картой публичных примитивов**.
+  - Проблема: стенд уже содержит полезные локальные карточки (modal 13, Settings 20, columnState 28–32, replay 23–26), но не покрывает опасные межслойные сценарии: вложенные overlay, ownership `GridApi`, `dispose`, повторный mount и смену entrypoint/платформенного слоя. Зелёный Jest не заменяет эти проверки.
+  - Задача: 1) составить компактную матрицу «публичный primitive → unit → QA card → ручной сценарий» и пометить пробелы; 2) добавить active QA-карточки только для interaction/lifecycle сценариев, которые нельзя надёжно доказать unit-тестом: overlay stack (Modal + Settings), ColumnGrid mount/unmount/ownership, persistence reload/reset, replay reconnect/route switch; 3) дать каждой карточке действия, ожидаемый результат, reset/изоляцию ключей и номер без дублей; 4) завести правило: новая визуальная либо lifecycle-поверхность не считается готовой без unit/integration проверки и обновлённой или намеренно неприменимой QA-карточки.
+  - Не превращать стенд в копию всех компонентов: чистые функции и детерминированные controller-ветки остаются в Jest; стенд — для пользовательского взаимодействия, DOM, аг-grid, browser lifecycle и визуальной приёмки.
+  - Acceptance: карточки запускаются на чистой странице без console errors; ключевые сценарии воспроизводимы вручную; карта покрытия хранится в `doc/`; команды tsc qa-check, jest и build проходят.
+  - Приоритет: после исправления overlay/grid ownership — новые карточки должны проверять именно исправленные контракты.
+
 - **Hook extraction — parked кандидаты** (do-now 1-3 выполнены и отгружены, см. In Progress выше / `doc/changes/v1.0.41.md`). Остались условные: `useChartCanvas` (ждёт ChartDemo в карточке/тесте), `useContextMenuGesture` (ждёт оживления menuR или live touch-consumer), `columnState.api.reorderPreview` (ждёт общего reorder-контракта), `useResizeableFit` (маленький shared bind callback-ref, отдельный микро-pass). Полные причины/условия возврата: [../progress/hook-extraction-audit.md](../progress/hook-extraction-audit.md).
 
 ## Inbox
 
+- **ColumnDots: фильтр-ползунок по значениям + мультисорт-опция + именованные пресеты** (надиктовка 2026-07-10, дословно в конце файла; контекст — мобильный ползунок таблицы, карточки 29/32).
+  - **1. Сорт-кнопка**: сейчас одна (asc→desc→off) — оставить одиночной по умолчанию, но добавить ОПЦИЮ множественной сортировки (multi-sort) настройкой.
+  - **2. Второй ползунок — фильтр по значениям** (открывается по кнопке при необходимости, кнопок вызова две — уточнить у пользователя что вторая): такой же трек с ячейками/метками, на котором пользователь СТАВИТ ТОЧКИ:
+    - числовые значения: значения раскладываются по треку; две точки = диапазон (считаем всегда по КРАЙНИМ точкам — лишние точки внутри не меняют диапазон); крайняя правая + середина = правый диапазон;
+    - категориальные значения (например, 9 типов): те же точки по меткам типов; выбор = диапазон ЛИБО конкретные точки;
+    - **режим фильтра** переключается кнопкой (как сорт-кнопка): «левее точек / между точками / только по точкам / …» — т.е. lt/range/in-set и т.п.;
+    - главный сценарий — мобила, всё пальцем (продолжение live-драга точек из v1.0.43).
+  - **3. Именованные пресеты**: кнопки «Сохранить» (с именем) и «Сбросить»; загрузка = выбор из сохранённых по имени. ОТКРЫТЫЙ ВОПРОС (пользователь сам не решил): куда поместить кнопки на телефоне — места на треке не хватает; кандидаты — в шапку дотс-панели / в меню по long-press / отдельная строка-«шторка». Персист — обычный путь memoryGetOrCreate→memoryCache (пресеты = отдельный ключ со словарём имя→конфиг фильтра+сорта).
+  - Смежное: фильтр должен лечь в columnState-конфиг (`filter` там уже есть — формат согласовать с ag-grid setFilterModel), чтобы desktop-грид получал тот же фильтр через grid.attach.
+  - Статус: надиктовка записана, скоупинг и уточнения (вторая кнопка вызова; полный список режимов) — перед взятием в работу.
+
 - **React Native / мобильная версия функционала** (надиктовка 2026-07-10, дословно в конце файла).
   - Суть: библиотеку планируют использовать и в мобильном (React Native), где DOM недоступен (нет `document`/`window`/`createPortal`/CSS-классов).
   - Первичная оценка: слоистость уже движется в нужную сторону — headless/controller-слой (updateBy/renderBy, columnState config, createToolbar config+Settings-модель, callbackHub, observableMap/memoryCache, replay-хуки) в основном DOM-free и потенциально переносим; DOM живёт во view-слое (FloatingWindow/Rnd, порталы/скримы, CSS-токены, ag-grid). Направление: (1) аудит `document`/`window`/`createPortal`/CSS-зависимостей по модулям; (2) выделить/закрепить platform-neutral core (возможно отдельный entrypoint без DOM-импортов); (3) RN-view-адаптеры — отдельный пакет/подпапка, не в этом проходе. ag-grid в RN не живёт — мобильные представления уже есть (ColumnDots/CardList) как модель. Персист: storage-слой абстрагировать (localStorage → AsyncStorage).
@@ -53,7 +83,9 @@ _Пусто._ «Hook extraction — do-now кандидаты (3)» выполн
 
 ## Verify
 
-_Пусто._ «Система стилей и 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`.
+_Пусто._ «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`.
 
 ## Blocked — уровень приложения (не эта React-библиотека)
 
@@ -79,3 +111,5 @@ _Пусто._ «Система стилей и CSS variables» проверен
 > да мы еще планиурем использовать библиотеку и для мобильного использования , а там дум обьекты вроде не потдерживаются.... ну ты сам знаешь что надо для реакт нативу - может сделать мобильную версию этого функционала
 
 > вопрос насоклько этот код вобще лакнчиный и юзабельный?ты бы сам ег остал использовать [оценка 2026-07-10: вызовы лаконичны, изучение — нет; задача «API-витрина» в Ready] да оформи задачу в my.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/grid/columnState/columnState.js

@@ -229,7 +229,11 @@ export function createColumnState(opts) {
             if (!known.has(s.colId))
                 continue;
             order.push(s.colId);
-            visible[s.colId] = !s.hide;
+            // `hide` for a gated-out column was written by applyToGrid(), not by
+            // the user. Folding it back would turn runtime presence into persisted
+            // visibility and keep the column hidden when the gate opens again.
+            if (passesPresentGate(s.colId))
+                visible[s.colId] = !s.hide;
             if (typeof s.width == 'number' && s.width > 0)
                 width[s.colId] = s.width;
             if (s.sort == 'asc' || s.sort == 'desc')

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.43",
-  "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"
+  }
+}