wenay-react2 1.0.49 → 1.0.50

package/README.md

@@ -1,18 +1,18 @@
-# wenay-react2
-
-Documentation index only.
-
+# wenay-react2
+
+Documentation index only.
+
 - Brief API guide: [doc/wenay-react2.md](doc/wenay-react2.md)
-- React Native/headless entrypoint: [doc/native.md](doc/native.md)
-- Detailed / rare API guide: [doc/wenay-react2-rare.md](doc/wenay-react2-rare.md)
-- Project functionality map: [doc/PROJECT_FUNCTIONALITY.md](doc/PROJECT_FUNCTIONALITY.md)
-- Example usage standards: [doc/EXAMPLE_USAGE.md](doc/EXAMPLE_USAGE.md)
-- wenay-react2 rename map: [doc/WENAY_REACT2_RENAMES.md](doc/WENAY_REACT2_RENAMES.md)
-- Project rules for maintainers and AI agents: [doc/PROJECT_RULES.md](doc/PROJECT_RULES.md)
-- Recent version changes: [doc/changes/](doc/changes/)
-
-`wenay-common2` is an external dependency. Read its current docs from the installed module/package when needed; keep this README focused on `wenay-react2` documentation.
-
+- React Native/headless entrypoint: [doc/native.md](doc/native.md)
+- Detailed / rare API guide: [doc/wenay-react2-rare.md](doc/wenay-react2-rare.md)
+- Project functionality map: [doc/PROJECT_FUNCTIONALITY.md](doc/PROJECT_FUNCTIONALITY.md)
+- Example usage standards: [doc/EXAMPLE_USAGE.md](doc/EXAMPLE_USAGE.md)
+- wenay-react2 rename map: [doc/WENAY_REACT2_RENAMES.md](doc/WENAY_REACT2_RENAMES.md)
+- Project rules for maintainers and AI agents: [doc/PROJECT_RULES.md](doc/PROJECT_RULES.md)
+- Recent version changes: [doc/changes/](doc/changes/)
+
+`wenay-common2` is an external dependency. Read its current docs from the installed module/package when needed; keep this README focused on `wenay-react2` documentation.
+
 Feature-specific docs may also live next to their code, for example agGrid4 docs under `src/common/src/grid/agGrid4/`.
 
 ## Shipped examples

package/doc/EXAMPLE_USAGE.md

@@ -783,8 +783,56 @@ Standard:
 - For per-key grid updates, prefer `useStoreEach` or `useStoreReplayEach`
   feeding a grid/controller outside React state.
 
+## Lossless Replay Across a Transport Reconnect
+
+Use when every retained event matters, such as orders, audit records, or
+state-machine transitions. Obtain one RPC replay remote outside component
+render and keep that same object through a temporary Socket.IO reconnect.
+
+```tsx
+import { useRef } from "react"
+import { useReplaySubscribe } from "wenay-react2"
+
+// Created once by the RPC/client setup, not during OrdersFeed render.
+// It remains the same object while its transport reconnects.
+const ordersRemote = rpc.orders.replay
+
+export function OrdersFeed() {
+    const applied = useRef<number[]>([])
+
+    const replay = useReplaySubscribe(ordersRemote, event => {
+        applied.current.push(event.id) // fold into a ref, store, or controller
+    }, {
+        since: 0,
+        policy: "queue",
+        onError: error => reportReplayGap(error),
+    })
+
+    return <span>{replay.ready ? `up to ${replay.seq()}` : "connecting"}</span>
+}
+```
+
+Why:
+
+- `wenay-common2@^1.0.75` restores a stable remote after a transient transport
+  reconnect: live delivery, seq catch-up, queued race drain, then dedupe.
+- `policy: "queue"` keeps every event available in the retained journal;
+  `"frame"` is intentionally lossy and belongs to visual/latest-value feeds.
+- Callback identity and ordinary parent rerenders do not recreate the
+  subscription.
+
+Standard:
+
+- Do not call `restart()`, replace `ordersRemote`, remount with a new key, or
+  listen to Socket.IO in React just because the transport reconnected.
+- Treat `replay.error` as a real recovery failure: a sacred journal gap without
+  a keyframe cannot be safely continued.
+- `client.dispose()`/`close()` and hub token rotation are deliberate hard
+  teardowns. Start a new subscription only with the intentionally new remote.
+
 ## Replay Feed Into A Grid
 
+
 Use when a replay line carries store patches and the grid should update per key.
 
 ```tsx

package/doc/PROJECT_FUNCTIONALITY.md

@@ -278,6 +278,15 @@ Main APIs:
 Use these for high-frequency event lines, state sync from a replay source, and
 route hand-off between relay/direct transports.
 
+Transport reconnect and replay recovery belong to `wenay-common2`, not these
+hooks. With a stable RPC `remote`, common2 1.0.75 rebinds a transiently lost
+physical Listen subscription, resumes from its own delivered seq, orders and
+deduplicates catch-up, and reports an unrecoverable journal gap as an error.
+`wenay-react2` owns only React mount/unmount, StrictMode-safe callback refs,
+and controller state; it must not add reconnect listeners, retry timers, or a
+second journal. Deliberate client disposal or token rotation is a hard
+teardown, not an automatic recovery path.
+
 Avoid storing every frame in React state. High-frequency lines should fold into
 canvas, refs, external stores, or grid controllers. The controller exposes
 `seq()` and related getters so consumers can observe position without

package/doc/PROJECT_RULES.md

@@ -19,35 +19,35 @@ Canonical documentation locations:
 
 `wenay-common2` documentation is not canonical in this repository. When common2 behavior matters, read the installed package/module docs and summarize only the React-facing impact in `doc/wenay-react2.md` or `doc/wenay-react2-rare.md`.
 
-## wenay-common2 / common2 Updates
-
-In this repository, `common2` is the short name for `wenay-common2`. If a request says to check updates, update common/common2, read what changed in common, or similar, and no other dependency is named, assume it means `wenay-common2`.
-
-Before summarizing or acting on such an update, read:
-
-- `node_modules/wenay-common2/package.json` for the installed version.
-- `node_modules/wenay-common2/doc/changes/README.md` and the newest files in `node_modules/wenay-common2/doc/changes/` for what changed.
-
+## wenay-common2 / common2 Updates
+
+In this repository, `common2` is the short name for `wenay-common2`. If a request says to check updates, update common/common2, read what changed in common, or similar, and no other dependency is named, assume it means `wenay-common2`.
+
+Before summarizing or acting on such an update, read:
+
+- `node_modules/wenay-common2/package.json` for the installed version.
+- `node_modules/wenay-common2/doc/changes/README.md` and the newest files in `node_modules/wenay-common2/doc/changes/` for what changed.
+
 If the package is updated, read the changelog from the newly installed package before changing React-facing docs or code. Keep local docs focused on the React-facing impact.
 
-## Target Backlog
-
-- `doc/target/` is the durable queue for dictated tasks and imported task direction. Read `doc/target/README.md` before acting on a request that starts from `target`.
-- `doc/target/my.md` must show task status. Before implementation, move/normalize the selected item into `In Progress`; when implementation is believed complete, move it to `Verify`; remove it from the queue only after acceptance checks pass and durable results are recorded.
-- `doc/progress/` is temporary and must not be used as the only task-status record. If a progress file is deleted at completion, `doc/target/my.md` must already be cleaned, moved to `Verify`, or otherwise updated with the next required check.
-- `target/*.md` files are source specs/prompts. Do not edit or delete them merely for progress tracking unless the user explicitly asks.
-## Work Progress Files
-
-- For any task that is more than a tiny/local edit, create a temporary progress file before starting broad changes.
-- Put progress files under `doc/progress/`. This is the working-doc area, separate from public docs, roadmap docs, and release notes.
-- Name them by task, for example `doc/progress/replay-route-handoff.md`.
-- Keep the file short: goal, current checkpoints, notable decisions, blockers, and verification already run or still needed.
-- Update the progress file as checkpoints are completed, especially before switching context or making broad edits.
-- When the task is finished, delete the progress file.
-- Preserve only the durable outcome: final response, commit message, and, for publishable changes, the matching changelog/release-note entry.
-- If work is paused or blocked locally, leave the progress file in place and make the next required action explicit.
-- If the paused state must be committed or handed off, promote the useful part into a durable doc such as `ROADMAP`, `RECOMMENDATIONS`, `doc/target`, or `doc/changes`, instead of relying on an ignored progress file.
-
+## Target Backlog
+
+- `doc/target/` is the durable queue for dictated tasks and imported task direction. Read `doc/target/README.md` before acting on a request that starts from `target`.
+- `doc/target/my.md` must show task status. Before implementation, move/normalize the selected item into `In Progress`; when implementation is believed complete, move it to `Verify`; remove it from the queue only after acceptance checks pass and durable results are recorded.
+- `doc/progress/` is temporary and must not be used as the only task-status record. If a progress file is deleted at completion, `doc/target/my.md` must already be cleaned, moved to `Verify`, or otherwise updated with the next required check.
+- `target/*.md` files are source specs/prompts. Do not edit or delete them merely for progress tracking unless the user explicitly asks.
+## Work Progress Files
+
+- For any task that is more than a tiny/local edit, create a temporary progress file before starting broad changes.
+- Put progress files under `doc/progress/`. This is the working-doc area, separate from public docs, roadmap docs, and release notes.
+- Name them by task, for example `doc/progress/replay-route-handoff.md`.
+- Keep the file short: goal, current checkpoints, notable decisions, blockers, and verification already run or still needed.
+- Update the progress file as checkpoints are completed, especially before switching context or making broad edits.
+- When the task is finished, delete the progress file.
+- Preserve only the durable outcome: final response, commit message, and, for publishable changes, the matching changelog/release-note entry.
+- If work is paused or blocked locally, leave the progress file in place and make the next required action explicit.
+- If the paused state must be committed or handed off, promote the useful part into a durable doc such as `ROADMAP`, `RECOMMENDATIONS`, `doc/target`, or `doc/changes`, instead of relying on an ignored progress file.
+
 ## Recent Changes Catalog
 
 Every meaningful code, public API, dependency, migration, or documentation-policy change must add or update a file in `doc/changes/`.

package/doc/WENAY_REACT2_RENAMES.md

@@ -1,177 +1,177 @@
-# wenay-react2 Rename Map
-
-Date: 2026-07-08
-
-This is a breaking rename map. The package does not keep old aliases for these names.
-
-## Root
-
-| Old | New |
-| --- | --- |
-| `v2` | `kit` |
-| `test()` | removed |
-| `LegacyMenuElement` | `MenuItemElement` |
-
-## Persistent Memory
-
-| Old | New |
-| --- | --- |
-| `Cash` | `memoryCache` |
-| `MemoryMap` | `memoryMaps` |
-| `staticGetAdd` | `memoryGetOrCreate` |
-| `staticGetById` | `memoryGetById` |
-| `staticSet` | `memorySet` |
-| `staticGet` | `memoryGet` |
-| `staticUpdate` | `memoryUpdate` |
-| `staticMarkDirty` | `memoryMarkDirty` |
-| `staticProps` | `memoryProps` |
-| `mapMemory.tsx` | `memoryStore.tsx` |
-
-## Outside Click And Keyboard
-
-| Old | New |
-| --- | --- |
-| `DivOutsideClick` | `OutsideClickArea` |
-| `DivOutsideClick2` | `OutsideClickArea` |
-| `ButtonOutClick` | `OutsideButton` |
-| `ButtonHover` | `HoverButton` |
-| `ButtonAbs` | `AbsoluteButton` |
-| `StyleOtherColum` | `StyleOtherColumn` |
-| `useOutsideOld` | `useOutsideRef` |
-| `useAddDownAnyKey` | `useKeyboard` |
-| `useKeyDown` | `useKeyboard` |
-| `useAnyKey` | `useKeyboard` |
-| `keyDownApi` | `keyboard` |
-| `KeyDown` | `keyboardState` |
-| `AnyKeyDownApi` | `KeyboardApi` |
-| `addDownAnyKey` | removed |
-| `useAddDownAnyKeyOld` | removed |
-| `useAddDownAnyKey.ts` | `useKeyboard.ts` |
-
+# wenay-react2 Rename Map
+
+Date: 2026-07-08
+
+This is a breaking rename map. The package does not keep old aliases for these names.
+
+## Root
+
+| Old | New |
+| --- | --- |
+| `v2` | `kit` |
+| `test()` | removed |
+| `LegacyMenuElement` | `MenuItemElement` |
+
+## Persistent Memory
+
+| Old | New |
+| --- | --- |
+| `Cash` | `memoryCache` |
+| `MemoryMap` | `memoryMaps` |
+| `staticGetAdd` | `memoryGetOrCreate` |
+| `staticGetById` | `memoryGetById` |
+| `staticSet` | `memorySet` |
+| `staticGet` | `memoryGet` |
+| `staticUpdate` | `memoryUpdate` |
+| `staticMarkDirty` | `memoryMarkDirty` |
+| `staticProps` | `memoryProps` |
+| `mapMemory.tsx` | `memoryStore.tsx` |
+
+## Outside Click And Keyboard
+
+| Old | New |
+| --- | --- |
+| `DivOutsideClick` | `OutsideClickArea` |
+| `DivOutsideClick2` | `OutsideClickArea` |
+| `ButtonOutClick` | `OutsideButton` |
+| `ButtonHover` | `HoverButton` |
+| `ButtonAbs` | `AbsoluteButton` |
+| `StyleOtherColum` | `StyleOtherColumn` |
+| `useOutsideOld` | `useOutsideRef` |
+| `useAddDownAnyKey` | `useKeyboard` |
+| `useKeyDown` | `useKeyboard` |
+| `useAnyKey` | `useKeyboard` |
+| `keyDownApi` | `keyboard` |
+| `KeyDown` | `keyboardState` |
+| `AnyKeyDownApi` | `KeyboardApi` |
+| `addDownAnyKey` | removed |
+| `useAddDownAnyKeyOld` | removed |
+| `useAddDownAnyKey.ts` | `useKeyboard.ts` |
+
 ## Floating Windows And Drag
 
 | Old | New |
 | --- | --- |
-| `DraggableOutlineDiv` | `OutlineDragDemo` |
-| `DivRnd3` | `FloatingWindow` |
-| `DivRndBase3` | `FloatingWindowBase` |
-| `ExRNDMap3` | `floatingWindowMap` |
-| `tRndUpdate` | `FloatingWindowUpdate` |
-| `Drag22` | `DragBox` |
-| `Drag2Props` | `DragBoxProps` |
-| `Drag2` | `DragArea` |
-| `RNDFunc3.tsx` | `FloatingWindow.tsx` |
-| `RNDFunc.tsx` | `DragArea.tsx` |
-
-## Modal And Inputs
-
-| Old | New |
-| --- | --- |
-| `InputPage` | `TextInputPanel` |
-| `InputPageModal` | `TextInputModal` |
-| `InputFile` | `FileInputPanel` |
-| `InputFileModal` | `FileInputModal` |
-| `PageModalFree` | `FreeModal` |
-| `GetModalJSX` | `createModalElementStore` |
-| `GetModalFuncJSX` | `createModalRenderStore` |
-| `setModalJSX` argument | `modal` argument |
-| `LegacyModalSetter` | `ModalSetter` |
-| `useModalOld` | removed |
-| `useModalApi` | removed |
-
-## Params
-
-| Old | New |
-| --- | --- |
-| `ParametersReact` | `ParamsEditor` |
-| `ParametersBaseReact` | `ParamsEditorBase` |
-| `ParametersEngine.tsx` | `ParamsEditor.tsx` |
-| `EditParams2` | `ParamsEdit` |
-| `EditParams3` | `ParamsArrayEdit` |
-| `CParameter` | `ParamRow` |
-| `FButton` | `ParamLabelContent` |
-| `FNameButton` | `ParamToggleLabel` |
-| `SetAutoStepForElement` | `setAutoStepForElement` |
-
-## Menu
-
-| Old | New |
-| --- | --- |
-| `MenuBase` | `Menu` |
-| `MenuBaseProps` | `MenuProps` |
-| `tMenuReact` | `MenuItem` |
-| `tMenuReactStrictly` | `MenuItemStrict` |
-| `TimeNum` | `MenuProgress` |
-| `tCounters` | `MenuProgressCounters` |
-| `GetMouseMenuApi` | `createContextMenu` |
-| `mouseMenuApi` | `contextMenu` |
-| `ReactMouse` | `Layer` |
-| `ReactMenu` | `MenuView` |
-| `GetMenuR` | `createRightClickMenu` |
-| `MenuRightApi` | `createRightMenuController` |
-| `DropdownMenuTest` | `RightMenuDemo` |
-
-## Buttons And Grid
-
-| Old | New |
-| --- | --- |
-| `MiniButton2` | `PopupButton` |
-| `MiniButton3` | removed |
-| `AgGridMy` | `AgGridTable` |
-| `AgGridMyProps` | `AgGridTableProps` |
-| `AgGridMyInner` | `AgGridTableInner` |
-| `applyTransactionAsyncUpdate2` | `applyGridRows` |
-| `applyTransactionAsyncUpdate` | removed; use `applyGridRows` or `useAgGrid` |
-| `getUpdateTable` | removed |
-| `getComparatorGrid` | removed; use `numericComparator` |
-| `applyTransactionAsyncUpdate.tsx` | `gridRows.ts` |
-
-
-
-## Cache Helpers
-
-| Old | New |
-| --- | --- |
-| `tDirtyListener` | `DirtyListener` |
-| `IServerSaveBasePromise` | `CacheStorage` |
-| `CSaveToCache` | `BrowserCacheStorage` |
-| `CSaveToLocalStorage` | `LocalStorageCache` |
-| `CacheG` | `browserCacheStorage` |
-| `CacheLocal` | `localStorageCache` |
-| `CacheFuncMapBase` | `createCacheMapWithStorage` |
-| `CacheFuncMap` | `createCacheMap` |
+| `DraggableOutlineDiv` | `OutlineDragDemo` |
+| `DivRnd3` | `FloatingWindow` |
+| `DivRndBase3` | `FloatingWindowBase` |
+| `ExRNDMap3` | `floatingWindowMap` |
+| `tRndUpdate` | `FloatingWindowUpdate` |
+| `Drag22` | `DragBox` |
+| `Drag2Props` | `DragBoxProps` |
+| `Drag2` | `DragArea` |
+| `RNDFunc3.tsx` | `FloatingWindow.tsx` |
+| `RNDFunc.tsx` | `DragArea.tsx` |
+
+## Modal And Inputs
+
+| Old | New |
+| --- | --- |
+| `InputPage` | `TextInputPanel` |
+| `InputPageModal` | `TextInputModal` |
+| `InputFile` | `FileInputPanel` |
+| `InputFileModal` | `FileInputModal` |
+| `PageModalFree` | `FreeModal` |
+| `GetModalJSX` | `createModalElementStore` |
+| `GetModalFuncJSX` | `createModalRenderStore` |
+| `setModalJSX` argument | `modal` argument |
+| `LegacyModalSetter` | `ModalSetter` |
+| `useModalOld` | removed |
+| `useModalApi` | removed |
+
+## Params
+
+| Old | New |
+| --- | --- |
+| `ParametersReact` | `ParamsEditor` |
+| `ParametersBaseReact` | `ParamsEditorBase` |
+| `ParametersEngine.tsx` | `ParamsEditor.tsx` |
+| `EditParams2` | `ParamsEdit` |
+| `EditParams3` | `ParamsArrayEdit` |
+| `CParameter` | `ParamRow` |
+| `FButton` | `ParamLabelContent` |
+| `FNameButton` | `ParamToggleLabel` |
+| `SetAutoStepForElement` | `setAutoStepForElement` |
+
+## Menu
+
+| Old | New |
+| --- | --- |
+| `MenuBase` | `Menu` |
+| `MenuBaseProps` | `MenuProps` |
+| `tMenuReact` | `MenuItem` |
+| `tMenuReactStrictly` | `MenuItemStrict` |
+| `TimeNum` | `MenuProgress` |
+| `tCounters` | `MenuProgressCounters` |
+| `GetMouseMenuApi` | `createContextMenu` |
+| `mouseMenuApi` | `contextMenu` |
+| `ReactMouse` | `Layer` |
+| `ReactMenu` | `MenuView` |
+| `GetMenuR` | `createRightClickMenu` |
+| `MenuRightApi` | `createRightMenuController` |
+| `DropdownMenuTest` | `RightMenuDemo` |
+
+## Buttons And Grid
+
+| Old | New |
+| --- | --- |
+| `MiniButton2` | `PopupButton` |
+| `MiniButton3` | removed |
+| `AgGridMy` | `AgGridTable` |
+| `AgGridMyProps` | `AgGridTableProps` |
+| `AgGridMyInner` | `AgGridTableInner` |
+| `applyTransactionAsyncUpdate2` | `applyGridRows` |
+| `applyTransactionAsyncUpdate` | removed; use `applyGridRows` or `useAgGrid` |
+| `getUpdateTable` | removed |
+| `getComparatorGrid` | removed; use `numericComparator` |
+| `applyTransactionAsyncUpdate.tsx` | `gridRows.ts` |
+
+
+
+## Cache Helpers
+
+| Old | New |
+| --- | --- |
+| `tDirtyListener` | `DirtyListener` |
+| `IServerSaveBasePromise` | `CacheStorage` |
+| `CSaveToCache` | `BrowserCacheStorage` |
+| `CSaveToLocalStorage` | `LocalStorageCache` |
+| `CacheG` | `browserCacheStorage` |
+| `CacheLocal` | `localStorageCache` |
+| `CacheFuncMapBase` | `createCacheMapWithStorage` |
+| `CacheFuncMap` | `createCacheMap` |
 | `ObjectStringToDate` | `restoreDates` |
-## Public Type Prefix Cleanup
-
-| Old | New |
-| --- | --- |
-| `tToolbarItem` | `ToolbarItem` |
-| `tToolbarConfig` | `ToolbarConfig` |
-| `tToolbarDensity` | `ToolbarDensity` |
-| `tUiListConfig` | `UiListConfig` |
-| `tUiListSource` | `UiListSource` |
-| `tColumnMeta` | `ColumnMeta` |
-| `tColumnsSort` | `ColumnsSort` |
-| `tColumnsConfig` | `ColumnsConfig` |
-| `tMenuStripItem` | `MenuStripItem` |
-| `tReorderOptions` | `ReorderOptions` |
-| `tReorderItem` | `ReorderItem` |
-| `tReorderBoardOptions` | `ReorderBoardOptions` |
-| `tBoardPos` | `BoardPosition` |
-| `tBoardColumn` | `BoardColumn` |
-| `tSettingsSection` | `SettingsSection` |
-| `tThemeMode` | `ThemeMode` |
-| `tMapChangeListener` | `MapChangeListener` |
-| `tCallFuncAgGrid` | `AgGridClassRule` |
-| `tLogsInput` | `LogInput` |
-| `tLogs` | `LogEntry` |
-| `MenuRightPosition2` | `MenuRightVerticalPosition` |
-| `position2` prop/state | `verticalPosition` |
-| `PageLogs2` | `LogsPage` |
+## Public Type Prefix Cleanup
+
+| Old | New |
+| --- | --- |
+| `tToolbarItem` | `ToolbarItem` |
+| `tToolbarConfig` | `ToolbarConfig` |
+| `tToolbarDensity` | `ToolbarDensity` |
+| `tUiListConfig` | `UiListConfig` |
+| `tUiListSource` | `UiListSource` |
+| `tColumnMeta` | `ColumnMeta` |
+| `tColumnsSort` | `ColumnsSort` |
+| `tColumnsConfig` | `ColumnsConfig` |
+| `tMenuStripItem` | `MenuStripItem` |
+| `tReorderOptions` | `ReorderOptions` |
+| `tReorderItem` | `ReorderItem` |
+| `tReorderBoardOptions` | `ReorderBoardOptions` |
+| `tBoardPos` | `BoardPosition` |
+| `tBoardColumn` | `BoardColumn` |
+| `tSettingsSection` | `SettingsSection` |
+| `tThemeMode` | `ThemeMode` |
+| `tMapChangeListener` | `MapChangeListener` |
+| `tCallFuncAgGrid` | `AgGridClassRule` |
+| `tLogsInput` | `LogInput` |
+| `tLogs` | `LogEntry` |
+| `MenuRightPosition2` | `MenuRightVerticalPosition` |
+| `position2` prop/state | `verticalPosition` |
+| `PageLogs2` | `LogsPage` |
 | `logs3.tsx` | `logsContext.tsx` |
-## wenay-common2 Names Used Here
-
-| Old common2 alias | New name used in this package |
-| --- | --- |
-| `GetDblPrecision` / `GetDblPrecision2` | `decimals` |
+## wenay-common2 Names Used Here
+
+| Old common2 alias | New name used in this package |
+| --- | --- |
+| `GetDblPrecision` / `GetDblPrecision2` | `decimals` |
 | `NormalizeDouble` | `round` |

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`.