wenay-react2 1.0.46 → 1.0.48

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

@@ -0,0 +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.

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/examples/README.md

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

package/doc/examples/peer-call-media.tsx

@@ -1,8 +1,8 @@
-/**
- * This is the same interactive component used by the QA stand cards 41–44.
- * It is shipped as a supported demo entrypoint, not a private test helper.
- *
- * import {PeerCallDemo, PeerPresenceDemo, MediaRelayAclDemo, MediaRelayAudioDemo}
- *   from "wenay-react2/demo/peer-media"
- */
+/**
+ * This is the same interactive component used by the QA stand cards 41–44.
+ * It is shipped as a supported demo entrypoint, not a private test helper.
+ *
+ * import {PeerCallDemo, PeerPresenceDemo, MediaRelayAclDemo, MediaRelayAudioDemo}
+ *   from "wenay-react2/demo/peer-media"
+ */
 export {PeerCallDemo, PeerPresenceDemo, MediaRelayAclDemo, MediaRelayAudioDemo} from "wenay-react2/demo/peer-media";

package/doc/examples/stand.tsx

@@ -1,6 +1,6 @@
-/** The complete interactive wenay-react2 stand, shipped in the package. */
-export {QABoard} from "wenay-react2/demo/stand";
-
-// import {createRoot} from "react-dom/client";
-// import {QABoard} from "wenay-react2/demo/stand";
+/** The complete interactive wenay-react2 stand, shipped in the package. */
+export {QABoard} from "wenay-react2/demo/stand";
+
+// import {createRoot} from "react-dom/client";
+// import {QABoard} from "wenay-react2/demo/stand";
 // createRoot(document.getElementById("root")!).render(<QABoard />);

package/doc/native.md

@@ -0,0 +1,37 @@
+# React Native entrypoint
+
+Import the renderer-neutral API from `wenay-react2/native`. It has no React DOM,
+CSS, browser-global or ag-grid dependency.
+
+```ts
+import AsyncStorage from '@react-native-async-storage/async-storage'
+import {createNativeColumnDots, createNativeColumnState} from 'wenay-react2/native'
+
+const columns = createNativeColumnState({
+    key: 'super-admin.columns',
+    columns: [
+        {key: 'server', title: 'Server', fixed: true},
+        {key: 'status', title: 'Status'},
+        {key: 'panic', title: 'Panic'},
+    ],
+    storage: AsyncStorage,
+})
+await columns.ready
+
+const dots = createNativeColumnDots({state: columns, max: 8})
+dots.begin('status', 40, 0)
+dots.move(120, 0, {start: 0, length: 240})
+dots.end()
+```
+
+The persisted `v/order/visible/width/sort/filter/groups` shape matches the web
+`ColumnsConfig`. Writes are serialized and local edits made while hydration is
+pending win over stale storage.
+
+`createNativeColumnDots` is a view-independent interaction model. Connect its
+`begin/move/end` coordinates to PanResponder or Gesture Handler. Set `removeDirection` to `up`, `down` or `either` (the renderer-neutral default). It supports
+live field replacement along the slider, explicit reorder and toggle, sticky
+`asc -> desc -> off` sorting, and upward tear-off.
+
+Call `dots.dispose()` and `columns.dispose()` with the owning screen. Use
+`columns.api.flush()` when the latest AsyncStorage write must be awaited.

package/doc/progress/README.md

@@ -1,14 +1,14 @@
-# Task progress
-
-This directory is for short-lived checkpoint files during active non-trivial tasks.
-
-Rules:
-- create one file per task, named `doc/progress/<task>.md`;
-- keep it short: goal, checkpoints, decisions, blockers, and verification;
-- update it when checkpoints are completed or before switching context;
-- delete it when the task is finished;
-- keep durable history elsewhere: changelog/release notes for publishable changes,
-  roadmap/recommendations/target docs for long-lived project direction,
-  and the commit message or final response for the immediate summary.
-
+# Task progress
+
+This directory is for short-lived checkpoint files during active non-trivial tasks.
+
+Rules:
+- create one file per task, named `doc/progress/<task>.md`;
+- keep it short: goal, checkpoints, decisions, blockers, and verification;
+- update it when checkpoints are completed or before switching context;
+- delete it when the task is finished;
+- keep durable history elsewhere: changelog/release notes for publishable changes,
+  roadmap/recommendations/target docs for long-lived project direction,
+  and the commit message or final response for the immediate summary.
+
 Progress files are working notes, not API docs, release notes, or the durable target queue. When a task comes from `doc/target/my.md`, update that file before deleting the progress file: move completed work to `Verify` until checks pass, or remove it only after verification is recorded.

package/doc/progress/architecture-fix-queue.md

@@ -1,74 +1,74 @@
-# Architecture fix queue (A1-A10) — progress
-
-Status: in progress (session 2026-07-10). Queue source: `doc/target/my.md` (audit 2026-07-09).
-Durable per-change record: `doc/changes/v1.0.41.md` (shipped part), `doc/changes/v1.0.42.md` (current).
-
-## Session 2026-07-10 — recovery + tail of the queue
-
-Context: the machine rebooted; recovered from docs. Discovered and fixed first:
-the 1.0.41 release commit did NOT contain `columnGrid.tsx`, `fixedOrder.ts`,
-`persistedMaps.ts` and the whole architecture pass (npm had them, git did not —
-same failure mode as the earlier eb4e9b3 fix). Also `.npmrc` with a live npm
-auth token was sitting untracked — now gitignored (`/.npmrc`, `.vite-*.log`);
-the token itself should probably be rotated since it was on disk in the repo dir.
-
-Commits this session (chronological):
-
-1. **Post-release commit of the 1.0.41 working tree** — createColumnGrid sources,
-   A1/A2/A4/A5/A6/A8/A10-safe, hook-extraction do-now trio, common2 ^1.0.70,
-   changelog/docs; .gitignore hardening.
-2. **A10 safe part 2** — `onClickClose` alias (+deprecated `onCLickClose`),
-   `keyForSave` alias on `Button` (+deprecated `keySave`), QA card dup fix
-   (Replay 25→33, 26→34), `__test/tokens.test.ts` (two-way tokens.ts↔tokens.css).
-   Verify: tsc qa-check, jest 47/47.
-3. **A10 loop-guard** — `utils/structEqual.ts` (+barrel export, permanent test);
-   `columnState.readFromGrid` guards off `JSON.stringify`; order-sensitive
-   `sameMap` deliberately untouched (its sensitivity re-imposes stored order on
-   columnDefs reset). Verify: tsc, jest 53/53.
-4. **A7** — `DragBox` → thin adapter over `useDraggableApi` (+additive
-   `onMove`/`trackState:false` on the hook); `DragArea` @deprecated as-is;
-   `useFloatingWindowController`/`StickerMenu` deliberately stay bespoke
-   (recon: clamp, `buttons===1` recovery, persist, z-stack / mount-lifetime
-   listeners, click-suppression are load-bearing). `__test/dragBox.test.tsx`,
-   QA card 35. Verify: tsc, jest 58/58, stand: card 35 two drags commit without
-   jump-back (renders 1+2/gesture), card 26 reorder commits once, zero console
-   errors on fresh load.
-
-## A9 — DONE (committed 2026-07-10, 5th commit of the session; build OK)
-
-Done:
-
-- `components/Overlay.tsx` — INTERNAL (not exported) portal+scrim+outside+Escape
-  composition; outside-click delegates to `OutsideClickArea`; Escape listener only
-  when `onEscape` given; callbacks through refs. Doubles as the DOM seam for the
-  future react-native view layer (headless state stays in hosts).
-- `ModalProvider` → Overlay (inline token scrim + flex centering, Escape gated by
-  `closeOnEscape`, outside by `closeOnOutsideClick`) — public API untouched.
-- `SettingsDialog` → Overlay (`wenayDlgScrim`/`wenayDlgOutside` classes,
-  NO onEscape — the controller keeps the two-stage Escape: clear search, then close).
-- New permanent `__test/modalProvider.test.tsx` (portal/scrim/Escape/outside gates).
-
-Verified so far: tsc qa-check OK; jest 62/62; stand card 13 — open, Escape,
-outside click, close button all work (scrim dims, token z-index); card 20 —
-open, two-stage Escape (clear → close), outside click, window x. Console clean
-on fresh load (the ReferenceError seen mid-session was a vite HMR intermediate
-between two sequential edits, gone after reload).
-
-Deliberately NOT overlaid (recorded in changelog): `createModalElementStore`
-(render-slot store, not chrome), `LeftModal`/`Modal2` drawer (gesture-driven,
-no scrim), `ModalWrapper`/Input helpers (backdrop-less by design, hosted inside
-another modal slot).
-
-Close-out complete: fresh-page card-13/20 spot checks passed, changelog +
-my.md updated, `npm run build` OK, committed.
-
-## Queue after this session
-
-- **A3 (BREAKING)** dead `menuR.tsx` removal — only in a deliberate breaking version.
-- **A10 breaking leftovers** — raw `ListenApi` narrowing; removal of deprecated
-  `onCLickClose`/`keySave`/`DragArea`.
-- Then Ready queue: common2 1.0.66-1.0.70 adoption (useMediaSource, Peer SDK
-  adapter, WebRTC recipe), context-menu controller split, chart canvas wrapper.
-- New Inbox item 2026-07-10: React Native / mobile version of the library's
-  functionality (see `doc/target/my.md` Inbox + verbatim dictation) — A9 Overlay
-  was already shaped with that in mind (DOM isolated in one leaf).
+# Architecture fix queue (A1-A10) — progress
+
+Status: in progress (session 2026-07-10). Queue source: `doc/target/my.md` (audit 2026-07-09).
+Durable per-change record: `doc/changes/v1.0.41.md` (shipped part), `doc/changes/v1.0.42.md` (current).
+
+## Session 2026-07-10 — recovery + tail of the queue
+
+Context: the machine rebooted; recovered from docs. Discovered and fixed first:
+the 1.0.41 release commit did NOT contain `columnGrid.tsx`, `fixedOrder.ts`,
+`persistedMaps.ts` and the whole architecture pass (npm had them, git did not —
+same failure mode as the earlier eb4e9b3 fix). Also `.npmrc` with a live npm
+auth token was sitting untracked — now gitignored (`/.npmrc`, `.vite-*.log`);
+the token itself should probably be rotated since it was on disk in the repo dir.
+
+Commits this session (chronological):
+
+1. **Post-release commit of the 1.0.41 working tree** — createColumnGrid sources,
+   A1/A2/A4/A5/A6/A8/A10-safe, hook-extraction do-now trio, common2 ^1.0.70,
+   changelog/docs; .gitignore hardening.
+2. **A10 safe part 2** — `onClickClose` alias (+deprecated `onCLickClose`),
+   `keyForSave` alias on `Button` (+deprecated `keySave`), QA card dup fix
+   (Replay 25→33, 26→34), `__test/tokens.test.ts` (two-way tokens.ts↔tokens.css).
+   Verify: tsc qa-check, jest 47/47.
+3. **A10 loop-guard** — `utils/structEqual.ts` (+barrel export, permanent test);
+   `columnState.readFromGrid` guards off `JSON.stringify`; order-sensitive
+   `sameMap` deliberately untouched (its sensitivity re-imposes stored order on
+   columnDefs reset). Verify: tsc, jest 53/53.
+4. **A7** — `DragBox` → thin adapter over `useDraggableApi` (+additive
+   `onMove`/`trackState:false` on the hook); `DragArea` @deprecated as-is;
+   `useFloatingWindowController`/`StickerMenu` deliberately stay bespoke
+   (recon: clamp, `buttons===1` recovery, persist, z-stack / mount-lifetime
+   listeners, click-suppression are load-bearing). `__test/dragBox.test.tsx`,
+   QA card 35. Verify: tsc, jest 58/58, stand: card 35 two drags commit without
+   jump-back (renders 1+2/gesture), card 26 reorder commits once, zero console
+   errors on fresh load.
+
+## A9 — DONE (committed 2026-07-10, 5th commit of the session; build OK)
+
+Done:
+
+- `components/Overlay.tsx` — INTERNAL (not exported) portal+scrim+outside+Escape
+  composition; outside-click delegates to `OutsideClickArea`; Escape listener only
+  when `onEscape` given; callbacks through refs. Doubles as the DOM seam for the
+  future react-native view layer (headless state stays in hosts).
+- `ModalProvider` → Overlay (inline token scrim + flex centering, Escape gated by
+  `closeOnEscape`, outside by `closeOnOutsideClick`) — public API untouched.
+- `SettingsDialog` → Overlay (`wenayDlgScrim`/`wenayDlgOutside` classes,
+  NO onEscape — the controller keeps the two-stage Escape: clear search, then close).
+- New permanent `__test/modalProvider.test.tsx` (portal/scrim/Escape/outside gates).
+
+Verified so far: tsc qa-check OK; jest 62/62; stand card 13 — open, Escape,
+outside click, close button all work (scrim dims, token z-index); card 20 —
+open, two-stage Escape (clear → close), outside click, window x. Console clean
+on fresh load (the ReferenceError seen mid-session was a vite HMR intermediate
+between two sequential edits, gone after reload).
+
+Deliberately NOT overlaid (recorded in changelog): `createModalElementStore`
+(render-slot store, not chrome), `LeftModal`/`Modal2` drawer (gesture-driven,
+no scrim), `ModalWrapper`/Input helpers (backdrop-less by design, hosted inside
+another modal slot).
+
+Close-out complete: fresh-page card-13/20 spot checks passed, changelog +
+my.md updated, `npm run build` OK, committed.
+
+## Queue after this session
+
+- **A3 (BREAKING)** dead `menuR.tsx` removal — only in a deliberate breaking version.
+- **A10 breaking leftovers** — raw `ListenApi` narrowing; removal of deprecated
+  `onCLickClose`/`keySave`/`DragArea`.
+- Then Ready queue: common2 1.0.66-1.0.70 adoption (useMediaSource, Peer SDK
+  adapter, WebRTC recipe), context-menu controller split, chart canvas wrapper.
+- New Inbox item 2026-07-10: React Native / mobile version of the library's
+  functionality (see `doc/target/my.md` Inbox + verbatim dictation) — A9 Overlay
+  was already shaped with that in mind (DOM isolated in one leaf).