wenay-react2 1.0.47 → 1.0.49

package/doc/changes/v1.0.40.md

@@ -1,15 +1,15 @@
-# v1.0.40
-
-Date: 2026-07-09
-
-- Changed: Added FLIP-style item movement animation to the standard `createToolbar().Bar`, matching the card 30 behavior for horizontal toolbar menus.
-- Changed: QA cards 25 and 31 now receive toolbar item glide animation through the shared `Toolbar.Bar`; card 30 remains the stand-only visual reference.
-- Changed: Added `useFloatingWindowController` plus public geometry/controller types as the first controller layer for `FloatingWindow` saved geometry, z-index stack, drag state, resize callbacks, and viewport clamp.
-- Changed: Added controller-first layers for MiniLogs, RightMenu, ParamsEditor, Logs, SettingsDialog, and context logger UI wrappers while keeping compatibility components.
-- Changed: Added explicit `MenuItemStrict.actionKey` and action-level `contextMenu.stats` counters.
-- Changed: Moved log tables and context log table to shared `AgGridTable` primitives where behavior was safe to preserve.
-- Changed: Updated QA card 25 toolbar subscription to use `useListenEffect(tb.api.onChange, ...)` instead of a manual `useEffect(() => listen.on(...))` cleanup.
-- Fixed: `SettingsDialog` search history closes when focus leaves the search box.
-- Skipped: `FResizableReact` hook, `memoryStore` core rewrite, broad `DragBox` rewrite, `PageVisibilityProvider` adoption, and `logsContext` persistence migration until a real consumer/test scenario exists.
-- Note: The QA stand mounts log tables in card 9; top-right log notification layers exist in the library but are not mounted globally in the stand.
+# v1.0.40
+
+Date: 2026-07-09
+
+- Changed: Added FLIP-style item movement animation to the standard `createToolbar().Bar`, matching the card 30 behavior for horizontal toolbar menus.
+- Changed: QA cards 25 and 31 now receive toolbar item glide animation through the shared `Toolbar.Bar`; card 30 remains the stand-only visual reference.
+- Changed: Added `useFloatingWindowController` plus public geometry/controller types as the first controller layer for `FloatingWindow` saved geometry, z-index stack, drag state, resize callbacks, and viewport clamp.
+- Changed: Added controller-first layers for MiniLogs, RightMenu, ParamsEditor, Logs, SettingsDialog, and context logger UI wrappers while keeping compatibility components.
+- Changed: Added explicit `MenuItemStrict.actionKey` and action-level `contextMenu.stats` counters.
+- Changed: Moved log tables and context log table to shared `AgGridTable` primitives where behavior was safe to preserve.
+- Changed: Updated QA card 25 toolbar subscription to use `useListenEffect(tb.api.onChange, ...)` instead of a manual `useEffect(() => listen.on(...))` cleanup.
+- Fixed: `SettingsDialog` search history closes when focus leaves the search box.
+- Skipped: `FResizableReact` hook, `memoryStore` core rewrite, broad `DragBox` rewrite, `PageVisibilityProvider` adoption, and `logsContext` persistence migration until a real consumer/test scenario exists.
+- Note: The QA stand mounts log tables in card 9; top-right log notification layers exist in the library but are not mounted globally in the stand.
 - Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand`; `npm run build`; `git diff --check`.

package/doc/changes/v1.0.41.md

@@ -1,36 +1,36 @@
-# v1.0.41
-
-Date: 2026-07-09
-
-Status: released.
-
-- Changed: Split global log notifications into `useMessageEventLogsController`, `MessageEventLogsView`, and `MessageEventLogCard`; `MessageEventLogs` and `logsApi.React.Message` remain compatibility wrappers.
-- Changed: QA card 9 now mounts the global log notification layer, so the corner popups can be checked from the stand with the existing `add log` button.
-- Changed: Added usage docs for the hook/controller notification layer and recorded follow-up hook/controller split candidates with effectiveness/simplicity estimates.
-- Fixed: npm package assembly now copies `doc/` into `dist` and allows `doc/**/*` in package `files`; pack verification confirms `doc/changes/v1.0.41.md`, `doc/wenay-react2.md`, and `doc/wenay-react2-rare.md` are included.
-- Fixed: Restored opaque dark default styling for mouse/right-click menus; hover is white with dark text, active stays dark, and pressed state has a separate contrast token.
-- Changed: Polished the log notification toggle in card 9 / `MessageEventLogsView` from a large text `X` into a compact close button.
-- Added: `createColumnGrid` / `useColumnGrid`, a high-level column kit that infers `ColumnMeta` from ag-grid `columnDefs`, accepts optional default `data`/`getId`, and returns ready table, menu, dots, cards, toolbar, settings, and view surfaces.
-- Changed: Added QA card 32 for the default grid-menu wrapper, including the built-in dots overlay driving both table and card representations.
-- Changed: `createColumnGrid.View` now defaults `controls="auto"` to the dots overlay; `Dots` defaults to all columns, default toolbar items toggle column visibility, and `autoSizeOnColumnCountChange` optionally fits only when visible column count changes.
-- Changed: Updated `wenay-common2` from `^1.0.65` to `^1.0.70`.
-- Reason: common2 1.0.66 adds the `Media` namespace (browser mic/camera capture as binary `Listen` sources, fixed-header media frames via `encodeMediaFrame`/`decodeMediaFrame`, `replay:true` media mode in `createRpcServerAuto`, `wenay-common2/media` export). Media lines are ordinary Listen/replay lines, so existing `useListen*`/`useReplay*` hooks consume them without new React surface; the brief/rare replay docs now record this instead of adding hooks.
-- Reason: common2 1.0.67 adds `Replay.createRouteCoordinator` (policy-gated relay<->direct routing over pure `RouteConnector` transports; data continuity via `replayRouteSubscribe`). Coordinator `link.subscribe` returns the same handle shape as our route hooks (`ready, seq(), label(), active()`); a React adapter for coordinator links is recorded as a target goal, existing route hooks stay the manual `switchRoute` surface.
-- Reason: common2 1.0.68 completes the direct path: `Replay.createSignalHub` (WebRTC signaling over the existing socket/RPC control channel), `Replay.createWebRtcConnector` (the direct `RouteConnector`; `rtc` is an injected runtime factory — in the browser `() => new RTCPeerConnection(cfg)`, which is exactly this library's environment), `acceptWebRtcDirect`, and `serveReplayChannel`/`channelReplayRemote` (replay wire over any ordered channel). Together 1.0.66-1.0.68 form the media -> replay line -> policy-routed relay/direct stack; React-side adoption goals are recorded in `doc/target/my.md`.
-- Reason: common2 1.0.69 adds the `Peer` namespace (`wenay-common2/peer`) — the one-call SDK over rpc + store + replay + route coordinator (`createPeerHost` / `createPeerClient` / `createPatchRelayJournal`; per-peer mirrored stores survive relay<->direct hand-offs in one seq space) and fixes real-browser ICE candidate serialization. This reframes our coordinator-adapter target goal: the React surface should sit on `Peer` (peer store mirror + route control), not on raw coordinator links. 1.0.70 ships oracle suites and the demo stand inside the npm package as living examples.
-- Added: `useCacheMapPersistence(cache, delay?)` in `utils/cache.ts` (+ exported `CacheMap` type) - the documented load + onDirty->saveDebounced app contract as one hook returning `{isDirty, flush, save, reload}`; the three duplicated effects in QA cards 20/21/25 now use it.
-- Added: `useResizeObserver(onResize)` / `useElementSize()` in `components/MyResizeObserver.tsx` - hook-shaped entry over the existing `CResizeObserver` singleton (callback ref, cb through a ref, rounded equality-guarded width/height state + live `getSize()`); `setResizeableElement` path untouched; QA card 19 migrated off its manual `ResizeObserver`+rAF wiring.
-- Added: `useLogsPageTable()` -> `LogsPageTableController` in `logs/logs.tsx` - the full-page logs table moved to the controller pattern (mount-time row snapshot, `applyTransactionAsync` appends, importance filter deduplicated into one `applyImportanceFilter` method); `PageLogs` is now a thin wrapper over `table.gridProps`.
-- Reason: the three do-now candidates from the hook-extraction audit (`doc/progress/hook-extraction-audit.md`): each removes real imperative duplication and has a live QA consumer; old names stay compatibility wrappers, public API unchanged.
-- Changed: Architecture audit (2026-07-09, 4 subsystem readers + core reading) recorded: fix queue in `doc/target/my.md` (A1-A10: memoryStore layering inversion, getLogsApi shared state, dead menuR, columnState barrel pulling ag-grid runtime, quadruplicated pinFixed idiom, updateBy resubscribe/ordering, drag primitive x4, undisposed onChange subscriptions, triple modal systems, naming/SSR pack); dead/suspicious surfaces added to the rare-doc Cleanup Inventory. No code changed by the audit itself.
-- Changed (A1): persisted maps (`floatingWindowMap`, `mapResiReact`, `mapRightMenu`) moved to the new utils leaf `utils/persistedMaps.ts`; FloatingWindow/Resizable/RightMenuStore now import and re-export them (public surface unchanged), `memoryStore` no longer imports the component layer - the utils->components backward edge is gone; `api.tsx` layer comments corrected.
-- Changed (A4): `columnState/index.ts` barrel is ag-grid-free again - `createColumnGrid` (AgGridTable + createToolbar runtime) is exported from the root api via its own module, grid-less consumers can import the columnState barrel directly.
-- Changed (A2): `getLogsApi<T>()` builds fresh per-call state (own map/mini/settings; optional `settingsKey` in `LogsApiOptions` persists instance settings); the global `logsApi` explicitly injects the legacy shared module state, so all existing consumers and QA card 9 are behavior-identical; React views bound per instance via optional state props defaulting to the legacy state.
-- Changed (A5): the quadruplicated `filter(!fixed)`+pinFixed idiom (columnState.normalize, ColumnsMenu.movedOrder, Toolbar.normalize, Toolbar.Settings.movedOrder) now shares `utils/fixedOrder.ts` (`pinFixedOrder`, `movedOrderWithFixed`), exported from the utils barrel; dead `renderBy`/`updateBy` imports dropped from columnState.
-- Changed (A6): `updateBy` - imperative `f` goes through a ref (inline callbacks no longer resubscribe every render); React notifiers and imperative callbacks live in separate sets, so `renderByLast`/`renderByRevers` affect ONLY React subscribers while `f` callbacks always run in subscription order (before React notifiers), matching the documented contract; reentrant `renderBy` on the same object coalesces (bounded passes).
-- Changed (A8): `createToolbar().api.dispose()` and `createColumnGrid().dispose()` release factory-lifetime subscriptions (external-source onChange, config onChange, pending fit RAF) - repeated factories over one key no longer accumulate permanent listeners; `createColumnGrid` re-seeds `visibleCount` on grid re-attach so the auto-fit is not mis-skipped after a remount.
-- Changed (A10, safe part): `searchHistory.items`/`use()` no longer mutate persisted state on read (normalization moved to the write path); `window` reads guarded in `RightMenu` render clamp, `LeftModal.useViewport`, and `ApiLeftMenu`'s import-time default element (SSR/tests).
-- Verification (architecture pass): `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (45/45); `npm run build`; QA stand 3010 fresh load with zero console errors; spot checks - card 21 place persisted across reload (persistedMaps path), card 25 toolbar click updates last action (fixedOrder + updateBy path), card 32 table/cards switch + dots overlay, card 9 add-log appends rows (isolated getLogsApi, global path).
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (45/45); `npm run build`; QA stand 3010: card 21 place switch survives F5 (hook persistence), card 19 fixed-parent 150->240px updates select 92->180px and container 150x51->240x51 via `useElementSize`, card 9 add-log appends rows through the controller.
-- Verification: `npx tsc --noEmit`; `npm run build`; QA stand `http://127.0.0.1:3010/` and `/src/testReact.tsx` return HTTP 200.
+# v1.0.41
+
+Date: 2026-07-09
+
+Status: released.
+
+- Changed: Split global log notifications into `useMessageEventLogsController`, `MessageEventLogsView`, and `MessageEventLogCard`; `MessageEventLogs` and `logsApi.React.Message` remain compatibility wrappers.
+- Changed: QA card 9 now mounts the global log notification layer, so the corner popups can be checked from the stand with the existing `add log` button.
+- Changed: Added usage docs for the hook/controller notification layer and recorded follow-up hook/controller split candidates with effectiveness/simplicity estimates.
+- Fixed: npm package assembly now copies `doc/` into `dist` and allows `doc/**/*` in package `files`; pack verification confirms `doc/changes/v1.0.41.md`, `doc/wenay-react2.md`, and `doc/wenay-react2-rare.md` are included.
+- Fixed: Restored opaque dark default styling for mouse/right-click menus; hover is white with dark text, active stays dark, and pressed state has a separate contrast token.
+- Changed: Polished the log notification toggle in card 9 / `MessageEventLogsView` from a large text `X` into a compact close button.
+- Added: `createColumnGrid` / `useColumnGrid`, a high-level column kit that infers `ColumnMeta` from ag-grid `columnDefs`, accepts optional default `data`/`getId`, and returns ready table, menu, dots, cards, toolbar, settings, and view surfaces.
+- Changed: Added QA card 32 for the default grid-menu wrapper, including the built-in dots overlay driving both table and card representations.
+- Changed: `createColumnGrid.View` now defaults `controls="auto"` to the dots overlay; `Dots` defaults to all columns, default toolbar items toggle column visibility, and `autoSizeOnColumnCountChange` optionally fits only when visible column count changes.
+- Changed: Updated `wenay-common2` from `^1.0.65` to `^1.0.70`.
+- Reason: common2 1.0.66 adds the `Media` namespace (browser mic/camera capture as binary `Listen` sources, fixed-header media frames via `encodeMediaFrame`/`decodeMediaFrame`, `replay:true` media mode in `createRpcServerAuto`, `wenay-common2/media` export). Media lines are ordinary Listen/replay lines, so existing `useListen*`/`useReplay*` hooks consume them without new React surface; the brief/rare replay docs now record this instead of adding hooks.
+- Reason: common2 1.0.67 adds `Replay.createRouteCoordinator` (policy-gated relay<->direct routing over pure `RouteConnector` transports; data continuity via `replayRouteSubscribe`). Coordinator `link.subscribe` returns the same handle shape as our route hooks (`ready, seq(), label(), active()`); a React adapter for coordinator links is recorded as a target goal, existing route hooks stay the manual `switchRoute` surface.
+- Reason: common2 1.0.68 completes the direct path: `Replay.createSignalHub` (WebRTC signaling over the existing socket/RPC control channel), `Replay.createWebRtcConnector` (the direct `RouteConnector`; `rtc` is an injected runtime factory — in the browser `() => new RTCPeerConnection(cfg)`, which is exactly this library's environment), `acceptWebRtcDirect`, and `serveReplayChannel`/`channelReplayRemote` (replay wire over any ordered channel). Together 1.0.66-1.0.68 form the media -> replay line -> policy-routed relay/direct stack; React-side adoption goals are recorded in `doc/target/my.md`.
+- Reason: common2 1.0.69 adds the `Peer` namespace (`wenay-common2/peer`) — the one-call SDK over rpc + store + replay + route coordinator (`createPeerHost` / `createPeerClient` / `createPatchRelayJournal`; per-peer mirrored stores survive relay<->direct hand-offs in one seq space) and fixes real-browser ICE candidate serialization. This reframes our coordinator-adapter target goal: the React surface should sit on `Peer` (peer store mirror + route control), not on raw coordinator links. 1.0.70 ships oracle suites and the demo stand inside the npm package as living examples.
+- Added: `useCacheMapPersistence(cache, delay?)` in `utils/cache.ts` (+ exported `CacheMap` type) - the documented load + onDirty->saveDebounced app contract as one hook returning `{isDirty, flush, save, reload}`; the three duplicated effects in QA cards 20/21/25 now use it.
+- Added: `useResizeObserver(onResize)` / `useElementSize()` in `components/MyResizeObserver.tsx` - hook-shaped entry over the existing `CResizeObserver` singleton (callback ref, cb through a ref, rounded equality-guarded width/height state + live `getSize()`); `setResizeableElement` path untouched; QA card 19 migrated off its manual `ResizeObserver`+rAF wiring.
+- Added: `useLogsPageTable()` -> `LogsPageTableController` in `logs/logs.tsx` - the full-page logs table moved to the controller pattern (mount-time row snapshot, `applyTransactionAsync` appends, importance filter deduplicated into one `applyImportanceFilter` method); `PageLogs` is now a thin wrapper over `table.gridProps`.
+- Reason: the three do-now candidates from the hook-extraction audit (`doc/progress/hook-extraction-audit.md`): each removes real imperative duplication and has a live QA consumer; old names stay compatibility wrappers, public API unchanged.
+- Changed: Architecture audit (2026-07-09, 4 subsystem readers + core reading) recorded: fix queue in `doc/target/my.md` (A1-A10: memoryStore layering inversion, getLogsApi shared state, dead menuR, columnState barrel pulling ag-grid runtime, quadruplicated pinFixed idiom, updateBy resubscribe/ordering, drag primitive x4, undisposed onChange subscriptions, triple modal systems, naming/SSR pack); dead/suspicious surfaces added to the rare-doc Cleanup Inventory. No code changed by the audit itself.
+- Changed (A1): persisted maps (`floatingWindowMap`, `mapResiReact`, `mapRightMenu`) moved to the new utils leaf `utils/persistedMaps.ts`; FloatingWindow/Resizable/RightMenuStore now import and re-export them (public surface unchanged), `memoryStore` no longer imports the component layer - the utils->components backward edge is gone; `api.tsx` layer comments corrected.
+- Changed (A4): `columnState/index.ts` barrel is ag-grid-free again - `createColumnGrid` (AgGridTable + createToolbar runtime) is exported from the root api via its own module, grid-less consumers can import the columnState barrel directly.
+- Changed (A2): `getLogsApi<T>()` builds fresh per-call state (own map/mini/settings; optional `settingsKey` in `LogsApiOptions` persists instance settings); the global `logsApi` explicitly injects the legacy shared module state, so all existing consumers and QA card 9 are behavior-identical; React views bound per instance via optional state props defaulting to the legacy state.
+- Changed (A5): the quadruplicated `filter(!fixed)`+pinFixed idiom (columnState.normalize, ColumnsMenu.movedOrder, Toolbar.normalize, Toolbar.Settings.movedOrder) now shares `utils/fixedOrder.ts` (`pinFixedOrder`, `movedOrderWithFixed`), exported from the utils barrel; dead `renderBy`/`updateBy` imports dropped from columnState.
+- Changed (A6): `updateBy` - imperative `f` goes through a ref (inline callbacks no longer resubscribe every render); React notifiers and imperative callbacks live in separate sets, so `renderByLast`/`renderByRevers` affect ONLY React subscribers while `f` callbacks always run in subscription order (before React notifiers), matching the documented contract; reentrant `renderBy` on the same object coalesces (bounded passes).
+- Changed (A8): `createToolbar().api.dispose()` and `createColumnGrid().dispose()` release factory-lifetime subscriptions (external-source onChange, config onChange, pending fit RAF) - repeated factories over one key no longer accumulate permanent listeners; `createColumnGrid` re-seeds `visibleCount` on grid re-attach so the auto-fit is not mis-skipped after a remount.
+- Changed (A10, safe part): `searchHistory.items`/`use()` no longer mutate persisted state on read (normalization moved to the write path); `window` reads guarded in `RightMenu` render clamp, `LeftModal.useViewport`, and `ApiLeftMenu`'s import-time default element (SSR/tests).
+- Verification (architecture pass): `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (45/45); `npm run build`; QA stand 3010 fresh load with zero console errors; spot checks - card 21 place persisted across reload (persistedMaps path), card 25 toolbar click updates last action (fixedOrder + updateBy path), card 32 table/cards switch + dots overlay, card 9 add-log appends rows (isolated getLogsApi, global path).
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (45/45); `npm run build`; QA stand 3010: card 21 place switch survives F5 (hook persistence), card 19 fixed-parent 150->240px updates select 92->180px and container 150x51->240x51 via `useElementSize`, card 9 add-log appends rows through the controller.
+- Verification: `npx tsc --noEmit`; `npm run build`; QA stand `http://127.0.0.1:3010/` and `/src/testReact.tsx` return HTTP 200.
 - Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand`; `npm run build`; `npm pack .\dist --json` confirmed `doc/changes/v1.0.41.md`, `doc/wenay-react2.md`, `doc/wenay-react2-rare.md`, `doc/EXAMPLE_USAGE.md`, and `doc/target/my.md`.

package/doc/changes/v1.0.42.md

@@ -1,26 +1,26 @@
-# v1.0.42
-
-Date: 2026-07-10
-
-Status: released.
-
-- Added: `onClickClose` prop on `FloatingWindow`/`FloatingWindowBase`; the historical `onCLickClose` typo prop stays as a deprecated compatibility alias (`onClickClose` wins when both are set). Internal `SettingsDialog` usage migrated. (A10)
-- Added: `keyForSave` prop on `useOutside`'s `Button` (same persist-key naming as `FloatingWindow`/`Resizable`/`RightMenu`); the old `keySave` stays as a deprecated compatibility alias. Factory-option `key` names (`createToolbar`, `staticGetAdd`, `createUiSlot`) are not React props and stay as is. (A10)
-- Fixed: duplicate QA card numbering - Replay per-key feed and route hand-off cards renumbered 25→33 and 26→34; card 25 (createToolbar) and 26 (useReorder) keep their numbers. (A10)
-- Added: `__test/tokens.test.ts` - permanent jest guarantee that `tokens.ts` mirrors `tokens.css` in both directions (CSS `var()` references resolved before compare). Chosen instead of codegen so the build pipeline stays untouched. (A10)
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (47/47).
-- Added: `structEqual` in `utils/structEqual.ts` (exported from the utils barrel) - structural deep equality with the `JSON.stringify` idiom's tolerances (undefined props absent, NaN==NaN) but without its key-order sensitivity. (A10)
-- Changed: `columnState.readFromGrid` change/loop guards use `structEqual` instead of `JSON.stringify` - the grid's `getFilterModel()` key order no longer counts as a change (false-positive commits gone). The order-SENSITIVE `sameMap` presence guard is intentionally untouched: its order sensitivity re-imposes the stored order when columnDefs reset the grid's order. (A10)
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (53/53, incl. new `structEqual` suite).
-- Added (A7): `useDraggableApi` options `onMove` (imperative per-move-tick callback through a ref; not fired on setPosition/reset/cancel or release) and `trackState: false` (position lives only in `positionRef`/`onMove`, no re-render per move tick; start/end re-renders remain). Both additive, defaults unchanged.
-- Changed (A7): `DragBox` is now a thin adapter over `useDraggableApi` (holdMs 0, trackState false, onMove) instead of its own document-listener loop. Contract preserved and pinned by the new permanent `__test/dragBox.test.tsx`: immediate start, per-tick imperative `onX`/`onY` with the delta from the press point, mouse `preventDefault` / touch none, touch identifier tracking, no re-render per move tick, `onStop` (no args) only after a real gesture, `last` ref shares the live position object, per-gesture delta reset. The unused `dragging` prop stays accepted.
-- Changed (A7): `DragArea` marked `@deprecated` (no consumers; unique semantics - `document.body` listeners, `stopPropagation` per move tick, ABSOLUTE coords, no preventDefault - re-basing would change observable behavior). Removal only in a deliberate breaking version.
-- Decided (A7): `useFloatingWindowController`'s header loop and `StickerMenu` stay on their own loops - their unique behavior is load-bearing (viewport clamp + `e.buttons===1` release recovery + persist/z-stack; mount-lifetime listeners + click-vs-drag suppression respectively).
-- Changed: QA card 35 added - DragBox delta drag with starts/stops/renders counters (renders must NOT grow per move pixel).
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (58/58); stand 3010 fresh load zero console errors, card 35 two consecutive drags (commit without jump-back, renders 1+2 per gesture), card 26 reorder drag commits once (`B C A D E F G H`, commits 1).
-- Added (A9): internal `components/Overlay.tsx` - the one portal+scrim+outside-click+Escape composition for scrim-based modal systems. Deliberately NOT exported from public barrels; outside-click delegates to `OutsideClickArea` (mousedown+touchstart semantics preserved); the Escape listener attaches only when `onEscape` is passed; callbacks go through refs. Also the DOM seam for a future react-native view layer.
-- Changed (A9): `ModalProvider` composes `Overlay` (inline token scrim + flex centering, `tokens.zIndex.modal`, Escape gated by `closeOnEscape`, outside by `closeOnOutsideClick`) - public API and observable behavior unchanged; pinned by new permanent `__test/modalProvider.test.tsx`.
-- Changed (A9): `SettingsDialog` composes `Overlay` (`wenayDlgScrim`/`wenayDlgOutside` classes, window zIndex 10000 over the 9999 scrim); NO `onEscape` - the controller keeps its two-stage Escape (clear search, then close).
-- Decided (A9): `createModalElementStore` (render-slot store, not chrome), `LeftModal`/`Modal2` drawer (gesture-driven, scrim-less), and `ModalWrapper`/Input helpers (backdrop-less by design, hosted inside another modal slot) are NOT overlays and stay separate.
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (62/62); stand 3010 fresh load zero console errors; card 13 - open, Escape, outside click, close button (scrim dims, token z-index); card 20 - open, two-stage Escape (clear -> close), outside click, window x.
-- Changed: docs updated for the whole pass - `wenay-react2.md` (useDraggableApi `onMove`/`trackState`, `onClickClose` in the FloatingWindow example, `Button` `keyForSave`), `wenay-react2-rare.md` (internal Overlay note in Modal Low Level, A7 drag-primitives outcome in Drag/Resize Low Level, `structEqual` in utilities, Cleanup Inventory refreshed: getLogsApi/onCLickClose marked fixed/aliased, DragArea and keySave added as deprecated); session note in `doc/progress/architecture-fix-queue.md`.
+# v1.0.42
+
+Date: 2026-07-10
+
+Status: released.
+
+- Added: `onClickClose` prop on `FloatingWindow`/`FloatingWindowBase`; the historical `onCLickClose` typo prop stays as a deprecated compatibility alias (`onClickClose` wins when both are set). Internal `SettingsDialog` usage migrated. (A10)
+- Added: `keyForSave` prop on `useOutside`'s `Button` (same persist-key naming as `FloatingWindow`/`Resizable`/`RightMenu`); the old `keySave` stays as a deprecated compatibility alias. Factory-option `key` names (`createToolbar`, `staticGetAdd`, `createUiSlot`) are not React props and stay as is. (A10)
+- Fixed: duplicate QA card numbering - Replay per-key feed and route hand-off cards renumbered 25→33 and 26→34; card 25 (createToolbar) and 26 (useReorder) keep their numbers. (A10)
+- Added: `__test/tokens.test.ts` - permanent jest guarantee that `tokens.ts` mirrors `tokens.css` in both directions (CSS `var()` references resolved before compare). Chosen instead of codegen so the build pipeline stays untouched. (A10)
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (47/47).
+- Added: `structEqual` in `utils/structEqual.ts` (exported from the utils barrel) - structural deep equality with the `JSON.stringify` idiom's tolerances (undefined props absent, NaN==NaN) but without its key-order sensitivity. (A10)
+- Changed: `columnState.readFromGrid` change/loop guards use `structEqual` instead of `JSON.stringify` - the grid's `getFilterModel()` key order no longer counts as a change (false-positive commits gone). The order-SENSITIVE `sameMap` presence guard is intentionally untouched: its order sensitivity re-imposes the stored order when columnDefs reset the grid's order. (A10)
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (53/53, incl. new `structEqual` suite).
+- Added (A7): `useDraggableApi` options `onMove` (imperative per-move-tick callback through a ref; not fired on setPosition/reset/cancel or release) and `trackState: false` (position lives only in `positionRef`/`onMove`, no re-render per move tick; start/end re-renders remain). Both additive, defaults unchanged.
+- Changed (A7): `DragBox` is now a thin adapter over `useDraggableApi` (holdMs 0, trackState false, onMove) instead of its own document-listener loop. Contract preserved and pinned by the new permanent `__test/dragBox.test.tsx`: immediate start, per-tick imperative `onX`/`onY` with the delta from the press point, mouse `preventDefault` / touch none, touch identifier tracking, no re-render per move tick, `onStop` (no args) only after a real gesture, `last` ref shares the live position object, per-gesture delta reset. The unused `dragging` prop stays accepted.
+- Changed (A7): `DragArea` marked `@deprecated` (no consumers; unique semantics - `document.body` listeners, `stopPropagation` per move tick, ABSOLUTE coords, no preventDefault - re-basing would change observable behavior). Removal only in a deliberate breaking version.
+- Decided (A7): `useFloatingWindowController`'s header loop and `StickerMenu` stay on their own loops - their unique behavior is load-bearing (viewport clamp + `e.buttons===1` release recovery + persist/z-stack; mount-lifetime listeners + click-vs-drag suppression respectively).
+- Changed: QA card 35 added - DragBox delta drag with starts/stops/renders counters (renders must NOT grow per move pixel).
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (58/58); stand 3010 fresh load zero console errors, card 35 two consecutive drags (commit without jump-back, renders 1+2 per gesture), card 26 reorder drag commits once (`B C A D E F G H`, commits 1).
+- Added (A9): internal `components/Overlay.tsx` - the one portal+scrim+outside-click+Escape composition for scrim-based modal systems. Deliberately NOT exported from public barrels; outside-click delegates to `OutsideClickArea` (mousedown+touchstart semantics preserved); the Escape listener attaches only when `onEscape` is passed; callbacks go through refs. Also the DOM seam for a future react-native view layer.
+- Changed (A9): `ModalProvider` composes `Overlay` (inline token scrim + flex centering, `tokens.zIndex.modal`, Escape gated by `closeOnEscape`, outside by `closeOnOutsideClick`) - public API and observable behavior unchanged; pinned by new permanent `__test/modalProvider.test.tsx`.
+- Changed (A9): `SettingsDialog` composes `Overlay` (`wenayDlgScrim`/`wenayDlgOutside` classes, window zIndex 10000 over the 9999 scrim); NO `onEscape` - the controller keeps its two-stage Escape (clear search, then close).
+- Decided (A9): `createModalElementStore` (render-slot store, not chrome), `LeftModal`/`Modal2` drawer (gesture-driven, scrim-less), and `ModalWrapper`/Input helpers (backdrop-less by design, hosted inside another modal slot) are NOT overlays and stay separate.
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (62/62); stand 3010 fresh load zero console errors; card 13 - open, Escape, outside click, close button (scrim dims, token z-index); card 20 - open, two-stage Escape (clear -> close), outside click, window x.
+- Changed: docs updated for the whole pass - `wenay-react2.md` (useDraggableApi `onMove`/`trackState`, `onClickClose` in the FloatingWindow example, `Button` `keyForSave`), `wenay-react2-rare.md` (internal Overlay note in Modal Low Level, A7 drag-primitives outcome in Drag/Resize Low Level, `structEqual` in utilities, Cleanup Inventory refreshed: getLogsApi/onCLickClose marked fixed/aliased, DragArea and keySave added as deprecated); session note in `doc/progress/architecture-fix-queue.md`.

package/doc/changes/v1.0.43.md

@@ -1,10 +1,10 @@
-# v1.0.43
-
-Date: 2026-07-10
-
-Status: released.
-
-- Changed: `ColumnDots` drag is LIVE (user request from the stand, card 32: "отображать и выключать надо по мере движения — я так буду искать нужный мне столбик"): every EMPTY mark the dot crosses swaps the shown column immediately - the grid/cards follow the finger during the drag; the drop no longer commits a swap (it only settles selection and the tear-off). Occupied marks are passed over; a fixed dot still never swaps; the vertical tear-off flick hides the CURRENTLY shown column of the gesture.
-- Added: a small label above the dragged dot (`.wenayColDotsDragLabel`, tokens `--cols-dots-drag-label-bg/color/font-size` + TS mirror) naming the currently shown column - sized for a finger on a phone.
-- Changed: QA cards 29 and 32 do/expect texts updated to the live semantics.
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (62/62, incl. the two-way tokens sync test); stand 3010 card 32 - dragging the NOTE dot left across QTY to PRICE leaves the table showing NAME+PRICE with the dot settled on the PRICE mark (the drop path commits nothing, so the end state proves the live path), zero console errors.
+# v1.0.43
+
+Date: 2026-07-10
+
+Status: released.
+
+- Changed: `ColumnDots` drag is LIVE (user request from the stand, card 32: "отображать и выключать надо по мере движения — я так буду искать нужный мне столбик"): every EMPTY mark the dot crosses swaps the shown column immediately - the grid/cards follow the finger during the drag; the drop no longer commits a swap (it only settles selection and the tear-off). Occupied marks are passed over; a fixed dot still never swaps; the vertical tear-off flick hides the CURRENTLY shown column of the gesture.
+- Added: a small label above the dragged dot (`.wenayColDotsDragLabel`, tokens `--cols-dots-drag-label-bg/color/font-size` + TS mirror) naming the currently shown column - sized for a finger on a phone.
+- Changed: QA cards 29 and 32 do/expect texts updated to the live semantics.
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand` (62/62, incl. the two-way tokens sync test); stand 3010 card 32 - dragging the NOTE dot left across QTY to PRICE leaves the table showing NAME+PRICE with the dot settled on the PRICE mark (the drop path commits nothing, so the end state proves the live path), zero console errors.

package/doc/changes/v1.0.44.md

@@ -1,14 +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`.
+# 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

@@ -1,9 +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.
+# 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/changes/v1.0.46.md

@@ -1,16 +1,16 @@
-# v1.0.46 — common2 Calls, presence and media relay adoption
-
-Status: ready for publication.
-
-- Updated the declared `wenay-common2` dependency to `^1.0.74`.
-- Added `usePeerCalls` over the common2 call manager; React renders call lifecycle but does not own signaling, busy/glare, timeout or closure policy.
-- Added `usePeerPresence` for the host presence snapshot and edge stream.
-- Added QA cards 41–44 and in-process tests for call lifecycle, presence edges and ACL revocation; card 43 carries a real camera frame through Media → relay → policy-filtered canvas.
+# v1.0.46 — common2 Calls, presence and media relay adoption
+
+Status: ready for publication.
+
+- Updated the declared `wenay-common2` dependency to `^1.0.74`.
+- Added `usePeerCalls` over the common2 call manager; React renders call lifecycle but does not own signaling, busy/glare, timeout or closure policy.
+- Added `usePeerPresence` for the host presence snapshot and edge stream.
+- Added QA cards 41–44 and in-process tests for call lifecycle, presence edges and ACL revocation; card 43 carries a real camera frame through Media → relay → policy-filtered canvas.
 - Verified with qa-check TypeScript, Jest, package build and the QA stand.
 - Ships doc/examples/peer-call-media.tsx: a consumer template for calls, presence, camera/microphone relay and server-owned ACL.
 
 - Ships the entire QA stand as wenay-react2/demo/stand; Active cards are canonical examples, Archive cards are regression/compat context.
-
-- Added runtime-only live drag-preview across `useReorder`, Toolbar, ColumnsMenu, columnState and attached grid; persistence still happens only on drop.
-- Added optional `CardList layout="compact"` for dense mobile key/value cards; the stacked layout remains default.
+
+- Added runtime-only live drag-preview across `useReorder`, Toolbar, ColumnsMenu, columnState and attached grid; persistence still happens only on drop.
+- Added optional `CardList layout="compact"` for dense mobile key/value cards; the stacked layout remains default.
 - Rebuilt QA card 27 controls on one CSS-grid track system so remove/insert actions cannot drift from their columns.

package/doc/changes/v1.0.47.md

@@ -1,9 +1,9 @@
-# 1.0.47
-
-- Added the platform-neutral `wenay-react2/native` entrypoint.
-- Added `createNativeColumnState`: an AsyncStorage-compatible controller for order, visibility, width, sorting, filters and groups without DOM, CSS, React DOM or ag-grid dependencies.
-- Added `createNativeColumnDots`: a renderer-independent gesture model with live replacement, reorder, visibility, sorting and tear-off behavior.
-- Added focused hydration, persistence, gesture and dependency-boundary tests.
-- Fixed the shipped examples list formatting in README.
-
-Verification: Jest, TypeScript build, package archive inspection and runtime import of `wenay-react2/native` from the packed artifact.
+# 1.0.47
+
+- Added the platform-neutral `wenay-react2/native` entrypoint.
+- Added `createNativeColumnState`: an AsyncStorage-compatible controller for order, visibility, width, sorting, filters and groups without DOM, CSS, React DOM or ag-grid dependencies.
+- Added `createNativeColumnDots`: a renderer-independent gesture model with live replacement, reorder, visibility, sorting and tear-off behavior.
+- Added focused hydration, persistence, gesture and dependency-boundary tests.
+- Fixed the shipped examples list formatting in README.
+
+Verification: Jest, TypeScript build, package archive inspection and runtime import of `wenay-react2/native` from the packed artifact.

package/doc/changes/v1.0.48.md

@@ -0,0 +1,8 @@
+# 1.0.48
+
+- Fixed swapped display labels of the logs settings: `minVarLogs` is the log-table importance filter, `minVarMessage` gates notifications (keys and behavior unchanged).
+- Peer call demo (`demo/peer-media`, QA card 45): the audio enable intent is remembered and applied to the player created after accept, so the documented order (enable -> call -> accept) produces sound without a second click.
+- QA stand: stale card texts corrected (14 reset label, 29 unreachable "Max 4 dots", 38 phantom "requesting" state, card 2 note); card 2 switched off the deprecated `onCLickClose` typo alias to `onClickClose`.
+- `typescript ^5` is pinned in devDependencies (the build used to rely on a global install; TS 7 is incompatible with ts-jest and `moduleResolution: node10`).
+
+Verification: tsc qa-check, Jest 23/78 green, library build, and a full automated walkthrough of all 43 QA stand cards with zero console errors (`doc/progress/qa-stand-walkthrough-2026-07-12.md`; manual-device checks listed there).

package/doc/changes/v1.0.49.md

@@ -0,0 +1,7 @@
+# 1.0.49
+
+- Added the conference demo `wenay-react2/demo/peer-conference` (QA card 46): a 3-way host-star room exercising BOTH media technologies — `Peer.createMediaRelay` fan-out gated by call-derived room membership, and a policy-routed focus pair over `Replay.createRouteCoordinator` whose relay hop (`serveReplayChannel` over an in-proc text channel) and WebRTC direct route (`createWebRtcConnector`/`acceptWebRtcDirect`) serve ONE owner-sequenced line, making every hand-off gap-free by seq. Includes a headless `createConferenceWorld` factory (injectable rtc/fps/frame for tests) and a fake-RTC loopback runtime ported from the common2 oracle.
+- Added `useRouteState(coordinator, link)`: thin React binding for route chips — live route state, last denial/failure reason, 500ms connector metrics and a short hand-off log.
+- Added the real-backend conference example: `doc/examples/conference-server.mjs` (Node + Socket.IO peer host with a server-owned room policy: accepted calls join both parties, WebRTC offers are brokered only inside a shared room, `canWatch` reads shared-room membership) and `doc/examples/conference-client.html/.ts` (one seat per tab: media grid through the server relay, peer-store rows promotable to a real RTCPeerConnection datachannel and back).
+
+Verification: tsc qa-check; Jest 25 suites / 87 tests including 9 new (star-room roster, relay ACL follows membership, relay-hop seq authority, gap-free promote/demote over loopback RTC, loud policy denials with recovery, server revoke + transport-death fallbacks, late-joiner catch-up, React flow, useRouteState transitions); library build; stand card 46 walkthrough.

package/doc/examples/README.md

@@ -1,6 +1,7 @@
-# Runnable consumer examples
-
-- [`peer-call-media.tsx`](peer-call-media.tsx) — re-exports the interactive Peer/Media demos used by QA cards 41–44. Install the package and import from `wenay-react2/demo/peer-media`.
-
+# Runnable consumer examples
+
+- [`peer-call-media.tsx`](peer-call-media.tsx) — re-exports the interactive Peer/Media demos used by QA cards 41–44. Install the package and import from `wenay-react2/demo/peer-media`.
+
 The component uses an in-process `Peer.createPeerHost`, so calls, presence, camera and microphone relay work without server credentials. For production, expose `publishOf(account)` and `watchOf(account)` from the RPC server and keep `canWatch` plus call authorization on that server.
 - [stand.tsx](stand.tsx) — exports the entire interactive stand from wenay-react2/demo/stand. Active cards teach canonical APIs; Archive cards remain visible regression/compat examples.
+- [`conference-server.mjs`](conference-server.mjs) + [`conference-client.html`](conference-client.html) / [`conference-client.ts`](conference-client.ts) — the real-backend conference bridge (QA card 46's in-process world is `wenay-react2/demo/peer-conference`). Run `node doc/examples/conference-server.mjs` (needs `socket.io`), serve the client page from any dev server that transpiles TS (the wenay-react2 stand does), and open 2-3 tabs with `?me=a&peers=b,c&host=1` / `?me=b&peers=a,c` / `?me=c&peers=a,b`. The server owns the room policy (accepted calls join both parties to the room; WebRTC offers are brokered only inside a shared room) and the media relay; each peer row in a tab can promote its store link to a real RTCPeerConnection datachannel and re-interpose back.

package/doc/examples/conference-client.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>wenay conference seat</title>
+    <style>
+        body { font-family: system-ui, sans-serif; margin: 16px; background: #f6f8fa; color: #1f2328; }
+        h2 { margin: 0 0 4px; }
+        .row { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; margin: 8px 0; }
+        .tiles { display: flex; gap: 12px; flex-wrap: wrap; }
+        figure { margin: 0; display: grid; gap: 2px; }
+        img.tile { width: 160px; height: 90px; background: #111; border-radius: 6px; object-fit: cover; }
+        figcaption, .fine { font-size: 12px; color: #57606a; }
+        .peers { display: grid; gap: 6px; margin: 8px 0; }
+        .peerRow { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; background: #fff; border: 1px solid #d0d7de; border-radius: 8px; padding: 6px 10px; }
+        .chip { padding: 1px 8px; border-radius: 10px; font-size: 12px; color: #fff; background: #0969da; }
+        .chip.direct { background: #1a7f37; }
+        .chip.fallback, .chip.offline { background: #cf222e; }
+        #log { font: 11px/1.5 monospace; background: #fff; border: 1px solid #d0d7de; border-radius: 8px; padding: 8px; max-height: 180px; overflow: auto; }
+        button { cursor: pointer; }
+    </style>
+</head>
+<body>
+    <h2 id="who">conference seat</h2>
+    <div class="fine">media grid = server relay (room ACL) · peer rows = store links, promotable to a real WebRTC datachannel</div>
+    <div class="row" id="callControls"></div>
+    <div class="tiles" id="tiles"></div>
+    <div class="peers" id="peers"></div>
+    <div class="row"><input id="status" placeholder="my status (syncs over the peer store)" style="flex: 1; max-width: 320px;" /></div>
+    <div id="log"></div>
+    <script type="module" src="./conference-client.ts"></script>
+</body>
+</html>

package/doc/examples/conference-client.ts

@@ -0,0 +1,212 @@
+// Browser seat for conference-server.mjs — the real-backend variant of demo/peer-conference.
+// One tab = one participant. Media tiles ride the SERVER relay (room-gated fan-out);
+// each peer row is a peer-store link that starts on the server relay and can promote to
+// a real RTCPeerConnection datachannel (negotiated through the same server signal hub),
+// then re-interpose back — the two technologies of the conference bridge, cross-tab.
+//
+// Serve this page from the wenay-react2 dev stand (vite transpiles the .ts):
+//   /doc/examples/conference-client.html?me=a&peers=b,c&host=1&room=demo
+import {io} from "socket.io-client";
+import {createRpcClientHub, Peer} from "wenay-common2";
+
+type SeatWorld = {name: string, hue: number, beat: number, status: string};
+type ConfFrame = {n: number, at: number, image: string};
+
+const params = new URLSearchParams(location.search);
+const me = params.get("me") ?? "a";
+const peers = (params.get("peers") ?? (me === "a" ? "b,c" : "a")).split(",").map(value => value.trim()).filter(Boolean);
+const isHost = params.get("host") === "1" || me === "a";
+const room = params.get("room") ?? "demo";
+const serverUrl = params.get("server") ?? `${location.protocol}//${location.hostname}:8391`;
+
+const el = (id: string) => document.getElementById(id)!;
+const logBox = el("log");
+function log(line: string) {
+    const row = document.createElement("div");
+    row.textContent = `${new Date().toLocaleTimeString()}  ${line}`;
+    logBox.prepend(row);
+    while (logBox.children.length > 60) logBox.lastChild?.remove();
+}
+
+const seatHue = (account: string) => {
+    let hash = 0;
+    for (const ch of account) hash = (hash * 31 + ch.charCodeAt(0)) % 360;
+    return hash;
+};
+const paintFrame = (account: string, n: number): ConfFrame => {
+    const hue = seatHue(account);
+    const cx = 16 + (n * 9) % 128;
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="160" height="90">` +
+        `<rect width="160" height="90" fill="hsl(${hue},65%,42%)"/>` +
+        `<circle cx="${cx}" cy="${24 + (n * 5) % 44}" r="7" fill="#fff" opacity="0.9"/>` +
+        `<text x="8" y="82" font-size="12" font-family="monospace" fill="#fff">${account} #${n}</text></svg>`;
+    return {n, at: Date.now(), image: "data:image/svg+xml," + encodeURIComponent(svg)};
+};
+
+async function main() {
+    document.title = `conf seat ${me}`;
+    el("who").textContent = `seat ${me}${isHost ? " (host)" : ""} · room "${room}" · peers: ${peers.join(", ")}`;
+
+    const hub = createRpcClientHub(
+        () => io(serverUrl, {transports: ["websocket"], auth: {account: me}}),
+        r => ({app: r<any>("app")}) as const,
+    );
+    const clients = await hub.setToken(null);
+    await clients.app.readyStrict();
+    const deep: any = clients.app.func;
+    log("connected; server time " + await deep.serverTime());
+
+    // ============== calls: host-star membership over the server policy ==============
+    const manager = Peer.createCallManager({port: Peer.callPortOf(deep.peer), self: me});
+    const live = new Map<string, any>();
+    const controls = el("callControls");
+    function renderCalls() {
+        controls.innerHTML = "";
+        const inRoom = [...live.values()].some(call => call.state() === "active");
+        const state = document.createElement("b");
+        state.textContent = inRoom ? "in room" : "not in room";
+        controls.append(state);
+        if (isHost) {
+            for (const peer of peers) {
+                const current = [...live.values()].find(call => call.peer === peer && call.state() !== "ended");
+                const button = document.createElement("button");
+                if (!current) {
+                    button.textContent = `ring ${peer}`;
+                    button.onclick = () => bindCall(manager.call(peer, {room}));
+                } else if (current.state() === "ringing") {
+                    button.textContent = `cancel ${peer}…`;
+                    button.onclick = () => current.hangup();
+                } else {
+                    button.textContent = `hang up ${peer}`;
+                    button.onclick = () => current.hangup();
+                }
+                controls.append(button);
+            }
+        } else {
+            const incoming = [...live.values()].find(call => call.direction === "in" && call.state() === "ringing");
+            if (incoming) {
+                const accept = document.createElement("button");
+                accept.textContent = `accept ${incoming.peer}`;
+                accept.onclick = () => incoming.accept();
+                const decline = document.createElement("button");
+                decline.textContent = "decline";
+                decline.onclick = () => incoming.decline();
+                controls.append(accept, decline);
+            }
+            const active = [...live.values()].find(call => call.state() === "active");
+            if (active) {
+                const leave = document.createElement("button");
+                leave.textContent = "leave room";
+                leave.onclick = () => active.hangup();
+                controls.append(leave);
+            }
+        }
+    }
+    function bindCall(call: any) {
+        live.set(call.id, call);
+        call.changed.on((state: string) => { log(`call ${call.peer}: ${state}${call.reason() ? ` (${call.reason()})` : ""}`); renderCalls(); });
+        void call.ended.then(() => { live.delete(call.id); renderCalls(); });
+        renderCalls();
+    }
+    manager.rings.on(bindCall);
+    await manager.ready;
+    renderCalls();
+    const amInRoom = () => [...live.values()].some(call => call.state() === "active");
+
+    // ============== technology 1: media grid through the server relay ==============
+    let frameN = 0;
+    setInterval(function publishSyntheticCam() {
+        if (!amInRoom()) return; // stream only while in the room (the server ACL gates viewers anyway)
+        frameN++;
+        const frame = paintFrame(me, frameN);
+        void deep.media.publish("cam", frame, frame.at);
+    }, 125);
+
+    const tiles = el("tiles");
+    for (const peer of peers) {
+        const figure = document.createElement("figure");
+        const img = document.createElement("img");
+        img.className = "tile";
+        const caption = document.createElement("figcaption");
+        caption.textContent = `${peer} · waiting`;
+        figure.append(img, caption);
+        tiles.append(figure);
+        // the server's watch proxy resolves per access through canWatch: a subscription
+        // made before the room grant lands on nothing, so keep re-attaching until the
+        // FIRST FRAME proves the line is live (then stop churning)
+        let off: (() => void) | null = null;
+        let lastN = 0, lastAt = 0;
+        const attach = () => {
+            if (lastAt) return;
+            try { off?.(); } catch { /* stale RPC handle */ }
+            off = null;
+            try {
+                const line = deep.media.watch?.[peer]?.cam;
+                if (!line?.on) return;
+                off = line.on((frame: ConfFrame) => {
+                    if (!lastAt) log(`watching ${peer} through the server relay`);
+                    lastN = frame.n; lastAt = frame.at;
+                    img.src = frame.image;
+                });
+            } catch (error) { log(`watch ${peer} failed: ${error}`); }
+        };
+        setInterval(attach, 1500);
+        setInterval(() => {
+            const age = lastAt ? Math.round((Date.now() - lastAt) / 100) / 10 : 0;
+            caption.textContent = `${peer} · #${lastN}${lastAt ? ` · ${age}s ago` : " · waiting"}`;
+        }, 500);
+        attach();
+    }
+
+    // ============== technology 2: peer-store links, relay <-> direct per pair ==============
+    const client = Peer.createPeerClient<SeatWorld>({
+        remote: deep.peer,
+        account: me,
+        initial: {name: me, hue: seatHue(me), beat: 0, status: ""},
+        rtc: () => new RTCPeerConnection(),
+        drain: "micro",
+    });
+    client.onRoute((event: any) => log(`route ${event.key}: ${event.from} -> ${event.to}${event.reason ? ` (${String(event.reason)})` : ""}`));
+    setInterval(function heartbeat() { client.store.state.beat++; }, 1000);
+    (el("status") as HTMLInputElement).addEventListener("input", function onStatusInput(event) {
+        client.store.state.status = (event.target as HTMLInputElement).value;
+    });
+
+    const peersBox = el("peers");
+    for (const account of peers) {
+        const link = client.peer(account);
+        const row = document.createElement("div");
+        row.className = "peerRow";
+        const title = document.createElement("b");
+        const chip = document.createElement("span");
+        const info = document.createElement("span");
+        info.className = "fine";
+        const direct = document.createElement("button");
+        direct.textContent = "go direct";
+        direct.onclick = async () => {
+            log(`promoteDirect ${account}…`);
+            const result = await link.promoteDirect({timeoutMs: 8000});
+            log(result.ok ? `direct with ${account}: ok (${result.state})` : `direct with ${account} denied: ${String(result.reason)}`);
+        };
+        const relay = document.createElement("button");
+        relay.textContent = "back to relay";
+        relay.onclick = async () => {
+            const result = await link.reinterposeRelay("manual");
+            log(result.ok ? `relay with ${account}` : `re-interpose ${account} failed: ${String(result.reason)}`);
+        };
+        row.append(title, chip, info, direct, relay);
+        peersBox.append(row);
+        setInterval(function renderPeerRow() {
+            const mirrored: any = link.store.state;
+            title.textContent = account;
+            const route = link.route();
+            chip.textContent = `${route} · ${link.state()}`;
+            chip.className = "chip" + (route === "direct" ? " direct" : link.state() === "fallback" ? " fallback" : "");
+            info.textContent = mirrored
+                ? `beat ${mirrored.beat} · seq ${link.seq()}${mirrored.status ? ` · "${mirrored.status}"` : ""}`
+                : "no mirror yet";
+        }, 500);
+    }
+}
+
+main().catch(error => { console.error(error); log("FATAL: " + error); });