wenay-react2 1.0.47 → 1.0.48

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.35.md

@@ -1,26 +1,26 @@
-# v1.0.35
-
-Date: 2026-07-08
-
-- Changed: Migrated this repository to the published `wenay-common2@1.0.62` naming surface (`Observe`, `listen`, `Replay.replayListen`, `promiseProgress`) and updated matching React docs/tests.
-- Changed: Made `README.md` a documentation index only and added the project rule file plus `doc/changes/` catalog.
-- Reason: Keep the repository aligned with the breaking rename publication and make future AI edits record version-scoped changes consistently.
-- Verification: `npm run build`; `npm run testjest -- --runInBand`.
-- Changed: Updated `wenay-common2` from `1.0.62` to `1.0.64` and refreshed the pulled `doc/wenay-common2*.md` / `doc/NAMING_RENAMES.md` files from the npm package.
-- Reason: `wenay-common2@1.0.63` adds `Observe.createStoreManager` / `Observe.managedStore` for declarative mirror/replay/offline startup; `1.0.64` packages documentation and recent-change notes into npm.
-- React impact: no required hook migration in `wenay-react2`; the new manager remains a common2 resource-planning layer, while React hooks can keep wrapping concrete stores/remotes.
-- Changed: Applied a breaking `wenay-react2` naming cleanup across public exports, internal imports, docs, and source filenames; added `doc/WENAY_REACT2_RENAMES.md`.
-- Reason: Remove old compatibility aliases and make the package surface concise (`kit`, `memoryCache`, `FloatingWindow`, `ParamsEditor`, `Menu`, `AgGridTable`, `applyGridRows`).
+# v1.0.35
+
+Date: 2026-07-08
+
+- Changed: Migrated this repository to the published `wenay-common2@1.0.62` naming surface (`Observe`, `listen`, `Replay.replayListen`, `promiseProgress`) and updated matching React docs/tests.
+- Changed: Made `README.md` a documentation index only and added the project rule file plus `doc/changes/` catalog.
+- Reason: Keep the repository aligned with the breaking rename publication and make future AI edits record version-scoped changes consistently.
+- Verification: `npm run build`; `npm run testjest -- --runInBand`.
+- Changed: Updated `wenay-common2` from `1.0.62` to `1.0.64` and refreshed the pulled `doc/wenay-common2*.md` / `doc/NAMING_RENAMES.md` files from the npm package.
+- Reason: `wenay-common2@1.0.63` adds `Observe.createStoreManager` / `Observe.managedStore` for declarative mirror/replay/offline startup; `1.0.64` packages documentation and recent-change notes into npm.
+- React impact: no required hook migration in `wenay-react2`; the new manager remains a common2 resource-planning layer, while React hooks can keep wrapping concrete stores/remotes.
+- Changed: Applied a breaking `wenay-react2` naming cleanup across public exports, internal imports, docs, and source filenames; added `doc/WENAY_REACT2_RENAMES.md`.
+- Reason: Remove old compatibility aliases and make the package surface concise (`kit`, `memoryCache`, `FloatingWindow`, `ParamsEditor`, `Menu`, `AgGridTable`, `applyGridRows`).
 - Verification: `npm run build`; `npm run testjest -- --runInBand`.
 - Changed: Added a style/token audit, QA stand note, and cleanup inventory to doc/wenay-react2-rare.md; added project rules requiring rare-doc updates for style/theme/cleanup decisions.
 - Changed: Updated the QA stand Vite middleware from the removed `ObserveAll2` name to the current `Observe` export from `wenay-common2`.
 - Reason: Make style normalization and suspected-trash decisions explicit without deleting public exports blindly, and keep the stand runnable after the common2 rename publication.
 - Verification: `npm run testReact -- --host 127.0.0.1 --port 3002` starts and `http://127.0.0.1:3002/` returns HTTP 200; `npm run build`; `npm run testjest -- --runInBand`.
-- Changed: Refactored `contextMenu` around explicit `openAt` / `close` / `getState` controller methods while keeping the old `map` as a legacy Layer queue; updated QA/demo/logger callers to use `openAt`.
+- Changed: Refactored `contextMenu` around explicit `openAt` / `close` / `getState` controller methods while keeping the old `map` as a legacy Layer queue; updated QA/demo/logger callers to use `openAt`.
 - Changed: Made `DropdownMenu` trigger glyph/content, class names, and inline style slots configurable (`trigger`, `classNames`, `styles`) instead of hardcoding all right-menu visuals.
-- Changed: Updated both `doc/wenay-react2.md` and `doc/wenay-react2-rare.md` to describe `contextMenu.openAt` as the primary right-click integration path and `contextMenu.map` as legacy.
-- Reason: Make the right-click path more logical and reduce visual lock-in from the shared library while preserving current default behavior.
+- Changed: Updated both `doc/wenay-react2.md` and `doc/wenay-react2-rare.md` to describe `contextMenu.openAt` as the primary right-click integration path and `contextMenu.map` as legacy.
+- Reason: Make the right-click path more logical and reduce visual lock-in from the shared library while preserving current default behavior.
 - Verification: `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
-- Changed: Removed pulled `wenay-common2` docs from the README/project-rules canonical documentation list; `wenay-react2` docs now remain the only local docs that agents should update for this package.
-- Reason: `wenay-common2` is an external dependency and its current docs should be read from the installed module/package; this repo should only record React-facing impact in `doc/wenay-react2.md` and `doc/wenay-react2-rare.md`.
+- Changed: Removed pulled `wenay-common2` docs from the README/project-rules canonical documentation list; `wenay-react2` docs now remain the only local docs that agents should update for this package.
+- Reason: `wenay-common2` is an external dependency and its current docs should be read from the installed module/package; this repo should only record React-facing impact in `doc/wenay-react2.md` and `doc/wenay-react2-rare.md`.
 - Verification: documentation-only update.

package/doc/changes/v1.0.38.md

@@ -1,27 +1,27 @@
-# v1.0.38
-
-Date: 2026-07-09
-
-- Changed: Redesigned `SettingsDialog` from a flat section list into a searchable settings tree while preserving flat `{key, name, render}` sections.
-- Changed: Extended `SettingsSection` with optional `children`, `parentKey`, `searchText`, and `keywords` for nested settings pages and content-aware search.
-- Changed: Added SettingsDialog tree/search styles and widened the default `--dlg-nav-width` token to `220px` with the TypeScript token mirror updated.
-- Changed: Updated the QA stand SettingsDialog card and public docs for tree structure, registry `parentKey`, and search behavior.
-- Reason: Let client apps present larger settings surfaces in a JetBrains-style tree without moving hierarchy/search logic into each app.
-- Verification: `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
-- Changed: Extended `createToolbar` with focused API writes (`setOrder`, `show`, `setDensity`, `showSettings`, `showReset`), `sourceMode:"order"`, and a default-hidden reset pseudo-control (`resetItem`, `Bar reset`).
-- Changed: Updated QA card 30 to use `createToolbar({source: columnState.api.listSource, sourceMode:"order"})` instead of a manual order bridge.
-- Reason: Let table/grid layers own icon-menu order directly while toolbar membership, density, pseudo-controls, and extra non-source items stay local; give users a built-in reset-to-default control that starts hidden while Settings stays visible by default.
-- Verification: `.\node_modules\.bin\tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
-- Changed: Added runtime `columnState.api.setPresentGate(...)` and switched QA card 30 to stable grouped `columnDefs` plus a 3-letter vertical-dot mode button in the upper toolbar; removed the old lower menu from this demo.
+# v1.0.38
+
+Date: 2026-07-09
+
+- Changed: Redesigned `SettingsDialog` from a flat section list into a searchable settings tree while preserving flat `{key, name, render}` sections.
+- Changed: Extended `SettingsSection` with optional `children`, `parentKey`, `searchText`, and `keywords` for nested settings pages and content-aware search.
+- Changed: Added SettingsDialog tree/search styles and widened the default `--dlg-nav-width` token to `220px` with the TypeScript token mirror updated.
+- Changed: Updated the QA stand SettingsDialog card and public docs for tree structure, registry `parentKey`, and search behavior.
+- Reason: Let client apps present larger settings surfaces in a JetBrains-style tree without moving hierarchy/search logic into each app.
+- Verification: `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
+- Changed: Extended `createToolbar` with focused API writes (`setOrder`, `show`, `setDensity`, `showSettings`, `showReset`), `sourceMode:"order"`, and a default-hidden reset pseudo-control (`resetItem`, `Bar reset`).
+- Changed: Updated QA card 30 to use `createToolbar({source: columnState.api.listSource, sourceMode:"order"})` instead of a manual order bridge.
+- Reason: Let table/grid layers own icon-menu order directly while toolbar membership, density, pseudo-controls, and extra non-source items stay local; give users a built-in reset-to-default control that starts hidden while Settings stays visible by default.
+- Verification: `.\node_modules\.bin\tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
+- Changed: Added runtime `columnState.api.setPresentGate(...)` and switched QA card 30 to stable grouped `columnDefs` plus a 3-letter vertical-dot mode button in the upper toolbar; removed the old lower menu from this demo.
 - Reason: Demonstrate the app-owned multi-state layer above MenuStrip without rebuilding the grid schema on each mode click: presentGate decides which leaf columns are available while persisted user visibility stays separate.
-- Verification: `.\node_modules\.bin\tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
-- Changed: Updated `wenay-common2` from `^1.0.64` to `^1.0.65` and recorded a target backlog item for React route hand-off hooks over `Replay.replayRouteSubscribe` / `Observe.syncStoreReplayRoute`.
-- Reason: common2 1.0.65 adds replay route hand-off for relay/direct promotion; using it in this package needs an explicit React controller surface rather than changing existing replay hooks implicitly.
-- Verification: `tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; `npm run testjest -- --runInBand`.
-- Changed: Added route hand-off React hooks: `useReplayRouteSubscribe`, `useStoreReplayRouteSync`, and `useStoreReplayRouteMirror`.
-- Changed: Added unit coverage and QA card 26 with a canvas video route switch demo for relay/direct/failure fallback.
-- Changed: Updated Replay docs with the explicit `switchRoute(...)` contract and the current no-`stale`/`lastTs()` limitation of common2 route handles.
-- Reason: Let React consumers use `wenay-common2@1.0.65` replay route replacement without changing existing non-route hook semantics.
+- Verification: `.\node_modules\.bin\tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200.
+- Changed: Updated `wenay-common2` from `^1.0.64` to `^1.0.65` and recorded a target backlog item for React route hand-off hooks over `Replay.replayRouteSubscribe` / `Observe.syncStoreReplayRoute`.
+- Reason: common2 1.0.65 adds replay route hand-off for relay/direct promotion; using it in this package needs an explicit React controller surface rather than changing existing replay hooks implicitly.
+- Verification: `tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; `npm run testjest -- --runInBand`.
+- Changed: Added route hand-off React hooks: `useReplayRouteSubscribe`, `useStoreReplayRouteSync`, and `useStoreReplayRouteMirror`.
+- Changed: Added unit coverage and QA card 26 with a canvas video route switch demo for relay/direct/failure fallback.
+- Changed: Updated Replay docs with the explicit `switchRoute(...)` contract and the current no-`stale`/`lastTs()` limitation of common2 route handles.
+- Reason: Let React consumers use `wenay-common2@1.0.65` replay route replacement without changing existing non-route hook semantics.
 - Verification: `npm run testjest -- --runInBand`; `tsc -p tsconfig.qa-check.json --noEmit`; `npm run build`; QA stand `http://127.0.0.1:3004/` returns HTTP 200.
 - Changed: Added `doc/PROJECT_FUNCTIONALITY.md` and `doc/EXAMPLE_USAGE.md`, and linked both from `README.md` and `doc/PROJECT_RULES.md`.
 - Reason: Separate project purpose/feature boundaries and example usage standards from the API cheat sheet, including guidance to prefer current controller primitives over legacy low-level stand examples.
@@ -32,17 +32,17 @@ Date: 2026-07-09
 - Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `git diff --check -- src/common/src/components/Settings/SettingsDialog.tsx src/common/src/utils/searchHistory.ts src/common/src/utils/index.ts src/common/src/grid/columnState/ColumnDots.tsx src/common/src/grid/columnState/CardList.tsx src/style/style.css`.
 - Changed: Documented the hook/controller-first architecture rule for shared functionality and added a target audit for converting component-owned behavior into headless APIs where appropriate.
 - Reason: Keep reusable behavior available to apps, visual components, and QA stand layers without copying component internals.
-- Verification: Documentation-only scoped review; `git diff --check` on touched docs.
-- Changed: Recorded the compatibility policy for old public APIs and added a backlog item for local menu/context-menu usage statistics.
-- Reason: New hook/controller APIs should not break existing consumers, and risky menu migrations need usage signal before deprecation/removal.
-- Verification: Documentation-only scoped review; git diff --check on touched docs.
-- Changed: Refined compatibility guidance to allow explicit aggressive migrations while treating removed default styles as compatibility breaks unless a replacement class/token path is shipped.
-- Changed: Added a style-system normalization target for default primitive styles and CSS variable contracts.
-- Reason: API migrations can be explained in changelog, but broken default visuals make shared primitives hard to use and override safely.
-- Verification: Documentation-only scoped review; git diff --check on touched docs.
-- Changed: Added a persisted SettingsDialog tree/content width divider with mouse drag, keyboard arrows, and double-click/Enter reset to the default width.
-- Changed: Tightened the SettingsDialog tree/search layout so the search row, dotted tree-cycle control, toggles, and rows use less horizontal and vertical space.
-- Changed: Restored the card 29 `ColumnDots` / `CardList` default visual shape after CSS extraction: the primitive remains class-styleable, but the QA/default look matches the original compact track, dark dots, selected blue dot, and clean white cards.
-- Changed: Added click-only FLIP movement animation to the card 30 horizontal toolbar menu when order or density changes elsewhere; the menu itself does not gain drag reorder behavior.
-- Reason: Finish the settings usability pass without treating demo-only sketches as global style standards, and keep column-state demos visually usable while preserving the new CSS override contracts.
-- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand`; `git diff --check`; `npm run build`.
+- Verification: Documentation-only scoped review; `git diff --check` on touched docs.
+- Changed: Recorded the compatibility policy for old public APIs and added a backlog item for local menu/context-menu usage statistics.
+- Reason: New hook/controller APIs should not break existing consumers, and risky menu migrations need usage signal before deprecation/removal.
+- Verification: Documentation-only scoped review; git diff --check on touched docs.
+- Changed: Refined compatibility guidance to allow explicit aggressive migrations while treating removed default styles as compatibility breaks unless a replacement class/token path is shipped.
+- Changed: Added a style-system normalization target for default primitive styles and CSS variable contracts.
+- Reason: API migrations can be explained in changelog, but broken default visuals make shared primitives hard to use and override safely.
+- Verification: Documentation-only scoped review; git diff --check on touched docs.
+- Changed: Added a persisted SettingsDialog tree/content width divider with mouse drag, keyboard arrows, and double-click/Enter reset to the default width.
+- Changed: Tightened the SettingsDialog tree/search layout so the search row, dotted tree-cycle control, toggles, and rows use less horizontal and vertical space.
+- Changed: Restored the card 29 `ColumnDots` / `CardList` default visual shape after CSS extraction: the primitive remains class-styleable, but the QA/default look matches the original compact track, dark dots, selected blue dot, and clean white cards.
+- Changed: Added click-only FLIP movement animation to the card 30 horizontal toolbar menu when order or density changes elsewhere; the menu itself does not gain drag reorder behavior.
+- Reason: Finish the settings usability pass without treating demo-only sketches as global style standards, and keep column-state demos visually usable while preserving the new CSS override contracts.
+- Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand`; `git diff --check`; `npm run build`.

package/doc/changes/v1.0.39.md

@@ -1,11 +1,11 @@
-# v1.0.39
-
-Date: 2026-07-09
-
-- Changed: Added local in-memory `contextMenu.stats` diagnostics with `getSnapshot()`, `reset()`, and `onChange(cb)`.
-- Changed: Counted direct `openAt`, `openAtPoint`, legacy Layer queued opens, empty opens, close/replace, and source/layer usage without storing menu labels.
-- Changed: Added explicit `MenuItemStrict.actionKey` and action-level `contextMenu.stats` counters: aggregate `actionTotals` plus keyed `actions[actionKey]` for click/ok/error/task/submenu/func/focus outcomes.
-- Changed: Added focused tests for direct stats, reset/onChange, the legacy `contextMenu.map` Layer path, keyed actions, unkeyed action totals, and keyed submenu stats.
+# v1.0.39
+
+Date: 2026-07-09
+
+- Changed: Added local in-memory `contextMenu.stats` diagnostics with `getSnapshot()`, `reset()`, and `onChange(cb)`.
+- Changed: Counted direct `openAt`, `openAtPoint`, legacy Layer queued opens, empty opens, close/replace, and source/layer usage without storing menu labels.
+- Changed: Added explicit `MenuItemStrict.actionKey` and action-level `contextMenu.stats` counters: aggregate `actionTotals` plus keyed `actions[actionKey]` for click/ok/error/task/submenu/func/focus outcomes.
+- Changed: Added focused tests for direct stats, reset/onChange, the legacy `contextMenu.map` Layer path, keyed actions, unkeyed action totals, and keyed submenu stats.
 - Changed: Clarified the columnState menu guidance: `createToolbar({source: cs.api.listSource})` is the richer Settings-integrated surface; `ColumnsMenu` remains the compact presentation menu.
 - Changed: Extracted card 27 `BoardDemo` stand-only inline styles into local style helpers without changing `useReorderBoard` behavior.
 - Changed: Recorded the style-system default contract inventory and corrected the style source-of-truth paths for the next token migration.
@@ -14,22 +14,22 @@ Date: 2026-07-09
 - Changed: Added headless `useTextInputPanel` and `useFileInputPanel` hooks while keeping the old input panel/modal components as compatible visual wrappers.
 - Changed: Increased `ColumnDots` default max visible dots from 4 to 8 and updated QA card 29 to show 8 fields with the dots control overlaid on the bottom card.
 - Changed: Split `MiniLogs` into hook/controller-first layers: `useMiniLogsTable`, `MiniLogsView`, `MiniLogsTable`, with `MiniLogs` kept as the compatibility wrapper.
-- Changed: Added MiniLogs hook tests and updated QA card 9 plus usage docs for the compact log table flow.
-- Changed: Added `useRightMenuController` as the hook/controller layer behind `DropdownMenu`; kept `DropdownMenu` and `createRightMenuController().Render` compatible.
-- Changed: Added RightMenu tests for mounted controller rerender, direct hook state, hover submenu, and fixed toggle compatibility.
-- Changed: Added `useParamsEditorController` as the first controller layer for `ParamsEditor` draft clone, immediate/delayed notify, expand callback, and timer cleanup.
-- Changed: Added ParamsEditor controller tests for clone isolation, delayed notify cleanup, and current expand callbacks.
-- Changed: Moved context logger `LogsTable` from raw `AgGridReact` to shared `AgGridTable` defaults and added `logs.copyCell` action stats key to `PageLogs` copy menu.
-- Changed: Added headless `createLogsController` / `createLogsControllerState` for log append, limits, latest rows, settings, and update emitters while keeping `getLogsApi` as the compatibility entrypoint.
-- Changed: Added Logs controller tests for append order, `num`, mini/per-id limits, fresh latest, and settings emitters.
-- Changed: Added `useSettingsDialogController` as the first controller layer for `SettingsDialog` open/search/history/tree-cycle/nav-resize/Escape actions while keeping the visual wrapper compatible.
-- Changed: Added a SettingsDialog controller test for headless open/search/current-section/tree-cycle state.
-- Changed: Added context logger hooks `useLogsTableController` and `useLogsNotificationsController` while keeping `LogsTable` and `LogsNotifications` as visual wrappers.
+- Changed: Added MiniLogs hook tests and updated QA card 9 plus usage docs for the compact log table flow.
+- Changed: Added `useRightMenuController` as the hook/controller layer behind `DropdownMenu`; kept `DropdownMenu` and `createRightMenuController().Render` compatible.
+- Changed: Added RightMenu tests for mounted controller rerender, direct hook state, hover submenu, and fixed toggle compatibility.
+- Changed: Added `useParamsEditorController` as the first controller layer for `ParamsEditor` draft clone, immediate/delayed notify, expand callback, and timer cleanup.
+- Changed: Added ParamsEditor controller tests for clone isolation, delayed notify cleanup, and current expand callbacks.
+- Changed: Moved context logger `LogsTable` from raw `AgGridReact` to shared `AgGridTable` defaults and added `logs.copyCell` action stats key to `PageLogs` copy menu.
+- Changed: Added headless `createLogsController` / `createLogsControllerState` for log append, limits, latest rows, settings, and update emitters while keeping `getLogsApi` as the compatibility entrypoint.
+- Changed: Added Logs controller tests for append order, `num`, mini/per-id limits, fresh latest, and settings emitters.
+- Changed: Added `useSettingsDialogController` as the first controller layer for `SettingsDialog` open/search/history/tree-cycle/nav-resize/Escape actions while keeping the visual wrapper compatible.
+- Changed: Added a SettingsDialog controller test for headless open/search/current-section/tree-cycle state.
+- Changed: Added context logger hooks `useLogsTableController` and `useLogsNotificationsController` while keeping `LogsTable` and `LogsNotifications` as visual wrappers.
 - Changed: Added context logger hook tests for table rows/defaults/filter state and notification gate/show state.
-- 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: Kept `FloatingWindowBase` as a compatibility visual wrapper over the same `Rnd` DOM/classes/gesture behavior; `DragBox` and `FResizableReact` were not rewritten.
+- 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: Kept `FloatingWindowBase` as a compatibility visual wrapper over the same `Rnd` DOM/classes/gesture behavior; `DragBox` and `FResizableReact` were not rewritten.
 - Changed: Added FloatingWindow controller tests for saved geometry restore, resize-stop commit, drag clamp/persistence touch, and live resize `onUpdate` forwarding.
 - 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 now closes when focus leaves the search box; added a regression test.
-- Reason: Start the menu compatibility/statistics target with a safe diagnostics layer while keeping old public context-menu paths working.
+- Fixed: `SettingsDialog` search history now closes when focus leaves the search box; added a regression test.
+- Reason: Start the menu compatibility/statistics target with a safe diagnostics layer while keeping old public context-menu paths working.
 - Verification: `npx tsc -p tsconfig.qa-check.json --noEmit`; `npm run testjest -- --runInBand logsController.test.ts miniLogs.test.tsx`; `npm run testjest -- --runInBand logsContextControllers.test.tsx`; `npm run testjest -- --runInBand contextMenuStats.test.tsx`; `npm run testjest -- --runInBand createRightMenuController.test.tsx`; `npm run testjest -- --runInBand paramsEditorController.test.tsx`; `npm run testjest -- --runInBand floatingWindowController.test.tsx`; `npm run testjest -- --runInBand createToolbar.test.ts`; `npm run testjest -- --runInBand __test/inputPanelHooks.test.tsx`; `npm run testjest -- --runInBand __test/settingsDialog.test.tsx`; `npm run testjest -- --runInBand`; `npm run build`; `git diff --check`.