wenay-react2 1.0.39 → 1.0.41

package/doc/changes/v1.0.37.md

@@ -0,0 +1,13 @@
+# v1.0.37
+
+Date: 2026-07-08
+
+- Changed: Refactored `Menu` active/open handling so it no longer mutates `item.status`; `status` remains an initial hint and custom-renderer compatibility field.
+- Changed: Routed mouse context-menu item colors, active state, and separators through the existing `--menu-*` tokens while preserving `MenuR` / `toButton` class compatibility.
+- Changed: Added the shared logger style contract in `src/common/src/logs/logStyles.ts` and wired global/context logger chrome to `--logs-*` tokens.
+- Changed: Tokenized `OutlineDragDemo` outline color as `--menu-outline-color` and reused `--dlg-scrim` in `ModalProvider`.
+- Changed: Added project rules and `doc/progress/README.md` for temporary task progress files during active non-trivial work.
+- Changed: Added `doc/target/README.md` and clarified that `doc/target/my.md` is the durable task queue while `doc/progress` is temporary; target tasks now pass through a `Verify` status before removal.
+- Changed: Added `common2` shorthand rules for checking `wenay-common2` updates from the installed package changelog.
+- Reason: Reduce hidden state mutation and hardcoded shared styling while preserving the existing public API; make agent working notes and common2 update checks explicit.
+- Verification: `npm run build`; `npm run testjest -- --runInBand`; QA stand `http://127.0.0.1:3002/` returns HTTP 200; documentation-only policy reviewed in `doc/PROJECT_RULES.md`, `doc/progress/README.md`, and `node_modules/wenay-common2/doc/changes/README.md`.

package/doc/changes/v1.0.38.md

@@ -0,0 +1,48 @@
+# 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: `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.
+- Verification: Documentation-only review against `doc/wenay-react2.md`, `doc/wenay-react2-rare.md`, `src/common/api.tsx`, and the QA stand.
+- Changed: Added reusable `createSearchHistory({key,max?})`, wired `SettingsDialog` search to persisted history, and replaced three tree tool buttons with one compact dotted cycle control in the search row.
+- Changed: Moved `ColumnDots` and `CardList` visual styling from inline/raw styles into shared `.wenayColDots*` and `.wenayCardList*` CSS classes while preserving runtime geometry inline.
+- Reason: Apply the newly documented usage standards inside the library itself: reuse persistence helpers for search history and keep public primitives styleable through shared CSS contracts.
+- 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`.

package/doc/changes/v1.0.39.md

@@ -0,0 +1,35 @@
+# 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.
+- Changed: Moved `ColumnsMenu/MenuStrip` visual button styles into `.wenayColsMenu*` classes and `--cols-menu-*` tokens while leaving runtime reorder transforms inline.
+- Changed: Tokenized `ColumnDots` / `CardList` restored defaults through `--cols-dots-*` and `--cols-card-*` without changing component runtime geometry.
+- 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 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 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.
+- 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`.

package/doc/changes/v1.0.40.md

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

@@ -0,0 +1,13 @@
+# 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.
+- 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/progress/README.md

@@ -0,0 +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.
+
+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/hook-controller-opportunities.md

@@ -0,0 +1,367 @@
+# Hook/controller opportunities audit
+
+Дата: 2026-07-09.
+
+Задача: пройтись по коду библиотеки и записать места, где есть смысл продолжать переводить функционал в стиль `use*` hook / `create*` controller + тонкий visual wrapper. Не записывать задачи ради задач: у каждой позиции есть оценка эффективности, простоты и риска.
+
+## Проверенные зоны
+
+- `src/common/src/logs/miniLogs.tsx`
+- `src/common/src/logs/logs.tsx`
+- `src/common/src/logs/logsContext.tsx`
+- `src/common/src/components/ParamsEditor.tsx`
+- `src/common/src/components/Other.tsx`
+- `src/common/src/components/Settings/SettingsDialog.tsx`
+- `src/common/src/menu/menu.tsx`
+- `src/common/src/menu/menuMouse.tsx`
+- `src/common/src/components/Menu/RightMenu.tsx`
+- `src/common/src/components/Menu/StickerMenu.tsx`
+- `src/common/src/components/Dnd/FloatingWindow.tsx`
+- `src/common/src/components/Dnd/Resizable.tsx`
+- `src/common/src/hooks/useDraggable.tsx`
+- `src/common/src/components/MyResizeObserver.tsx`
+- QA usage references in `src/common/testUseReact/qa.tsx`
+
+## Execution updates
+
+### MiniLogs layered redesign — done
+
+Сделано:
+- добавлены `useMiniLogsTable`, `MiniLogsView`, `MiniLogsTable` и compatibility wrapper `MiniLogs`;
+- hook возвращает table props, `gridProps` alias, `apiRef`, `fit`, `getApi`, `withApi`, `onGridReady`, `onGridPreDestroyed`, `onCellMouseDown`;
+- сохранён старый `rowData` path, чтобы не менять row identity для повторяющихся log `id`;
+- MiniLogs-owned store/append/history не добавлялись: реального consumer для этого пока нет;
+- обновлены `doc/EXAMPLE_USAGE.md`, `doc/wenay-react2.md`, `doc/wenay-react2-rare.md`, QA card 9 и добавлен `__test/miniLogs.test.tsx`.
+
+Проверено:
+- `npm run testjest -- --runInBand miniLogs.test.tsx`;
+- `npx tsc -p tsconfig.qa-check.json --noEmit`;
+- `npm run testjest -- --runInBand`;
+- `npm run build`;
+- `git diff --check`.
+
+## Очередь полезных задач
+
+### 1. MiniLogs layered redesign
+
+Статус: выполнено; оставить как reference implementation для следующих hook/controller passes.
+
+Что сделать:
+- слой 1: `useMiniLogsTable(...)` или `createMiniLogsTableController(...)`, который готовит `columns`, `defaultColDef`, callbacks и grid contract;
+- слой 2: `MiniLogsTable` / `MiniLogsView` как тонкий visual wrapper на `AgGridTable`;
+- слой 3: совместимый `<MiniLogs data onClick />`.
+
+Оценка:
+- эффективность: medium/high;
+- простота: medium;
+- риск: medium.
+
+Почему задача не высосана из пальца:
+- текущий `MiniLogs` уже использует наши grid helpers, но сам API остаётся плоским компонентом;
+- это небольшой публичный компонент, его можно проверить отдельно без переписывания всего logger API.
+
+Проверка:
+- найти или добавить QA usage для `MiniLogs`;
+- проверить отображение времени, click callback, fit/resize таблицы.
+
+### 2. ParamsEditor / ParamsEdit controller split
+
+Статус: first controller layer done; full renderer/view split deferred.
+
+Что сделано:
+- добавлен `useParamsEditorController(...)` в `ParamsEditor.tsx`;
+- controller владеет mutable draft clone, immediate notify, delayed notify, expand callback и cleanup таймера;
+- `ParamsEditorBase` использует controller, но сложная JSX-разметка rows/arrays/inputs не переписывалась;
+- `ParamsEditor`, `ParamsEdit`, `ParamsArrayEdit` остались compatibility wrappers.
+
+Что не сделано сейчас:
+- `ParamsEditorView` / row-model split: слишком большой pass, высокий риск array mutation/resize/autostep UX;
+- async load/save hook для `ParamsEdit`/`ParamsArrayEdit`: полезно только отдельным pass с policy tests;
+- стили/плотность/buttons add/remove не трогались.
+
+Оценка:
+- эффективность: medium/high;
+- простота: medium;
+- риск: medium, потому что renderer остался на месте.
+
+Проверка:
+- `paramsEditorController.test.tsx`: draft clone isolation, delayed notify + unmount cleanup, current `onExpand` callback;
+- QA card 7/10 остаются ручными regression points для обычного renderer/save behavior.
+
+### 3. Logs API controller split
+
+Статус: headless controller pass done; full UI split deferred.
+
+Что видно сейчас:
+- `logs.tsx` хранит global maps (`cashLogs`, `datumConst`, `datumMiniConst`), settings, rendering API, table UI and notification UI вместе;
+- `logsContext.tsx` уже предлагает отдельный context-based logger, но это параллельный surface;
+- `PageLogs` и `MiniLogs` уже переведены на `AgGridTable`; `LogsTable` из `logsContext.tsx` теперь тоже переведён на `AgGridTable` + `colDefCentered` без изменения context state;
+- right-click copy action in `PageLogs` now has explicit `actionKey: "logs.copyCell"` for contextMenu action stats.
+
+Что сделано:
+- добавлен `src/common/src/logs/logsController.ts`;
+- экспортированы `LogsApiOptions`, `LogsController`, `LogsControllerState`, `createLogsControllerState`, `createLogsController` через `logs.tsx`;
+- `LogInput` / `LogEntry` остались в `logsController.ts`, но не re-export через общий `api.tsx`, потому эти имена уже заняты `logsContext.tsx`;
+- вынесен headless state/API слой: `addLogs`, `limit/limitPer`, `num`, `getRows()`, `getMiniRows()`, `getLatest()`, `params.def/get/set`, update emitters;
+- `getLogsApi`, `logsApi`, `PageLogs`, `MessageEventLogs`, `LogsPage`, `logsApi.React.*` оставлены compatibility wrappers;
+- `logsContext.tsx` не объединялся с global logger.
+
+Оценка:
+- эффективность: high для headless controller;
+- простота: medium;
+- риск: medium, если UI не переписывать.
+
+Дополнительный context logger pass:
+- добавлены `useLogsTableController()` и `useLogsNotificationsController()`;
+- `LogsTable` и `LogsNotifications` остались compatibility visual wrappers;
+- provider state, localStorage settings, notification timers and visual styles не менялись.
+
+Что пропустить:
+- публичный конфликт имён `logsContext.LogInput/LogEntry` решать отдельно, если понадобится единый logger contract;
+- merge/deprecate `logsContext.tsx` без отдельного решения;
+- MiniLogs-owned store/history без реального consumer.
+### 4. SettingsDialog controller split
+
+Статус: first controller layer done; full view split deferred.
+
+Что сделано:
+- добавлен `useSettingsDialogController(props)`;
+- controller владеет open/close, active/search, search history open/commit/pick/clear, expanded tree state, dotted tree cycle, nav resize state/commit, Escape handling and refs;
+- `SettingsDialog` остался compatibility wrapper with the same JSX/portal/FloatingWindowBase/classes;
+- pure tree/search helpers не переписывались;
+- QA card 20 менять не нужно: он продолжает проверять старый visual wrapper.
+
+Что пропущено:
+- full `SettingsDialogView` split по файлам: риск выше пользы сейчас;
+- переписывание `buildSettingsTree`/search helpers, registry, `settingsDialogLayout` store, `FloatingWindowBase`, CSS/tokens/default trigger;
+- любые UX changes search history/divider/dotted tree control ради красивого split.
+
+Оценка:
+- эффективность: medium/high;
+- простота: medium;
+- риск: medium, снижен тем, что JSX и UX остались на месте.
+
+Проверка:
+- `settingsDialog.test.tsx`: old search/content/history regression + hook open/search/tree-cycle state;
+- QA card 20: search history, outside blur close, dotted tree cycle, divider drag/keyboard/double-click reset, Escape behavior.
+### 5. Menu action controller + action-level stats
+
+Статус: action-level stats done; полный action-controller split отложен как более крупный pass.
+
+Что сделано:
+- `MenuItemStrict.actionKey?: string | null` стал стабильным diagnostics-key контрактом;
+- `MenuActionEvent` / `MenuActionHandler` прокинуты через `Menu`, nested menu layers и `contextMenu.Layer`;
+- `contextMenu.stats` теперь считает `actionTotals` и `actions[actionKey]` для click/ok/error/task/submenu/func/focus outcomes;
+- stats не падают обратно на `name`/index/source, не хранят labels и errors;
+- QA card 4 использует `qa4.*` action keys.
+
+Что осталось отдельной задачей:
+- выделить `createMenuActionController(...)` или `useMenuAction(...)`, если нужен более тонкий визуальный слой;
+- перенести исполнение item action/progress/loading cleanup из visual components без изменения DOM/classes;
+- добавить расширенные async-error tests, если будет выделяться controller.
+
+Оценка выполненного pass:
+- эффективность: medium/high;
+- простота: medium;
+- риск: medium, снижен явным `actionKey` и focused tests.
+
+Проверка:
+- unit tests: direct stats, reset/onChange, legacy Layer, keyed action, unkeyed action, keyed submenu;
+- QA card 4: right-click menu open/close/click/submenu behavior.
+
+### 6. FloatingWindow / DnD controller split
+
+Статус: first controller layer done; pointer-drag migration deferred.
+
+Что сделано:
+- добавлен `useFloatingWindowController(...)` в `FloatingWindow.tsx`;
+- controller владеет saved geometry (`position/size`), update counter, z-index stack, drag active state, mouse/touch header handlers, resize callbacks, viewport clamp and persistence `touch`;
+- экспортированы `FloatingWindowProps`, `FloatingWindowPosition`, `FloatingWindowSize`, `FloatingWindowSavedGeometry`, `FloatingWindowControllerOptions`, `FloatingWindowController`;
+- `FloatingWindowBase` остался compatibility visual wrapper над тем же `Rnd`, с теми же DOM/classes/header/close/overlay paths;
+- `FloatingWindow` memo-child wrapper сохранён;
+- `openWindows` registry уже использует `createUpdateApi`, отдельный `useWindowStack` не выделялся, чтобы не раздувать API без внешнего consumer.
+
+Что не сделано сейчас:
+- перенос drag на `useDraggableApi`/pointer-drag не делался: семантика другая (absolute `x/y`, limit clamp, touch id, z-index, persisted map), риск visual regression высокий;
+- `DragBox` не трогался: это отдельный legacy/compat path;
+- `SettingsDialog` JSX/portal/classes не менялись, он продолжает использовать `FloatingWindowBase`.
+
+Оценка выполненного pass:
+- эффективность: medium/high;
+- простота: medium/hard;
+- риск: medium, потому что DOM/Rnd/gesture semantics сохранены.
+
+Проверка:
+- `floatingWindowController.test.tsx`: restore saved geometry, resize stop commits/touches map, drag clamp and touch, live resize `onUpdate` forwarding;
+- manual QA still needed: card 2 drag/resize/z-index/persisted geometry/no listener spam;
+- card 20 SettingsDialog remains regression point because it uses `FloatingWindowBase`.
+
+### 7. logsContext migration or deprecation
+
+Статус: полезно решить направление, но не обязательно переписывать.
+
+Что видно сейчас:
+- `logsContext.tsx` содержит свою локальную `memoryGetOrCreate` на `localStorage`;
+- `LogsTable` использует raw `AgGridReact`, хотя основной путь уже перешёл на `AgGridTable`;
+- это выглядит как старый альтернативный logger implementation.
+
+Варианты:
+- мигрировать на общий `memoryStore`, `AgGridTable`, `colDefCentered` и общий logs controller;
+- или пометить как deprecated/compat example, чтобы не было двух “правильных” logger API.
+
+Оценка:
+- эффективность: medium;
+- простота: hard;
+- риск: medium/high.
+
+Почему не делать как quick fix:
+- простая замена `AgGridReact` на `AgGridTable` не решает дублирование logger architecture;
+- прямой `localStorage` лучше убирать вместе с решением о будущем этого модуля.
+
+### 8. RightMenu controller cleanup
+
+Статус: hook/controller split done for `DropdownMenu`; deeper registry rewrite skipped as low-effectiveness for now.
+
+Что сделано:
+- добавлен `useRightMenuController(...)` для open/fixed/select/submenu/drag-position state;
+- `DropdownMenu` стал compatibility visual wrapper поверх hook/controller state;
+- `createRightMenuController().Render` сохранён и продолжает рендерить `DropdownMenu`;
+- docs и usage examples показывают hook для кастомного DOM, а default wrapper для старого вида.
+
+Что пропущено:
+- registry `createRightMenuController` не переводился на `createUpdateApi`: текущий single-render setter уже покрывает реальный consumer/test, а переписывание массива элементов сейчас даст мало пользы при риске совместимости;
+- drag save проверен компиляцией и сохранением старого кода, но без отдельного DOM drag unit-test из-за сложности jsdom geometry.
+
+Оценка:
+- эффективность: medium;
+- простота: medium;
+- риск: low/medium после сохранения wrapper API.
+
+Проверка:
+- `createRightMenuController` mounted Render rerender;
+- `useRightMenuController` direct open/fixed/select/submenu state;
+- `DropdownMenu` hover submenu and fixed toggle compatibility.
+
+### 9. Resizable primitive hook
+
+Статус: skipped for now; low-effectiveness without consumers.
+
+Что проверено:
+- `rg` по `src`/`__test` нашёл `FResizableReact` только в export/docs and `mapResiReact` persistence wiring через `memoryStore`;
+- реальных render-consumers, которые проверили бы новый `useResizableSave`, нет.
+
+Почему не делать:
+- hook был бы speculative refactor без проверки behavior;
+- `FResizableReact` маленький compatibility wrapper, а риск сломать persisted size/save path выше пользы;
+- возвращаться стоит только когда появится consumer или новая resize-секция в стенде.
+
+Оценка:
+- эффективность: low сейчас;
+- простота: medium;
+- риск: medium.
+
+## Задачи, которые сейчас лучше не делать
+
+### memoryStore core helper
+
+Статус: пропускать без конкретного test/consumer.
+
+Причина:
+- `memoryStore` является core persistence helper для toolbar/columnState/UiSlot/search history/settings/window/right menu flows;
+- `memoryUpdate` можно технически обернуть через `createUpdateApi(cur)`, но это почти не улучшит публичный contract;
+- ошибка здесь ударит сразу по нескольким primitives.
+
+Когда возвращаться:
+- если появится test на stored object subscription + `memoryUpdate` + dirty event;
+- если вводим отдельный стандарт “memory object update controller”.
+
+### PageVisibilityProvider
+
+Статус: не внедрять в обычный UI ради helper.
+
+Причина:
+- полезен только для polling, replay/canvas или тяжёлых анимаций, которые должны паузиться в hidden tab;
+- без конкретного consumer это будет искусственное усложнение.
+
+### StickerMenu
+
+Статус: не делать shared-standard pass сейчас.
+
+Причина:
+- выглядит как standalone/demo-like side menu с hardcoded items and styles;
+- прежде чем переписывать, нужно решить: это публичный primitive или legacy/demo.
+
+Если делать:
+- сначала определить API и usage card;
+- затем уже `useStickerMenuController` + visual wrapper.
+
+### DragBox broad rewrite
+
+Статус: не делать вместе с FloatingWindow.
+
+Причина:
+- `DragBox` legacy/compat and low-level;
+- новый код лучше вести через `useDraggableApi` или будущий `usePointerDrag`, но существующий compatibility path не ломать без consumer-driven миграции.
+
+## Рекомендуемый порядок выполнения
+
+Текущий hook/controller-first backlog из этого audit-pass выполнен настолько, насколько это осмысленно без новых consumers:
+
+1. Logs API/controller split — done.
+2. SettingsDialog controller split — done.
+3. FloatingWindow first controller layer — done.
+4. Resizable hook — skipped until real consumers appear.
+
+Дальше не выполнять задачи ради задачи: `memoryStore`, обычный UI + `PageVisibilityProvider`, `StickerMenu`, `DragBox` broad rewrite and `FResizableReact` hook требуют отдельного consumer/test сценария.
+
+## Дополнительный проход: notification layer и новые кандидаты
+
+Дата: 2026-07-09.
+
+### MessageEventLogs notification split — done
+
+Что сделано:
+- старый `MessageEventLogs` разбит на `useMessageEventLogsController`, `MessageEventLogsView` и `MessageEventLogCard`;
+- `MessageEventLogs` и `logsApi.React.Message` оставлены compatibility wrappers;
+- controller владеет queue/timers/filter by `minVarMessage`, `show`, `setShow`, `toggleShow`, `visibleNotifications`, `maxVisible`;
+- QA card 9 теперь реально монтирует notification layer поверх log card, а не только описывает его в тексте;
+- добавлен focused test `messageEventLogs.test.tsx` и usage docs.
+
+Оценка:
+- эффективность: high — убран старый module-level JSX store `tt`, таймеры и подписка вынесены из visual wrapper;
+- простота: medium — глобальный `logsApi`/`datumMiniConst` сохранён ради совместимости;
+- риск: low/medium — старый компонент остался, но уведомления теперь локальны для mounted layer вместо общего module-level React-element map.
+
+### Кандидаты на следующие split passes
+
+1. `menuMouse.tsx` + `menu.tsx`: context menu/action controller split.
+   - Идея: выделить `createContextMenuController` / `useMenuLayer` + `MenuView` и отдельный `useMenuAction` для async action/progress/submenu flow.
+   - Эффективность: high; простота: medium/hard; риск: medium.
+   - Почему не делать мелким quick fix: меню уже имеет compatibility/statistics контракты, нужен focused pass с tests по click/async/submenu/stats.
+
+2. `LeftModal.tsx`: sidebar/modal controller split.
+   - Идея: вынести viewport listener, drag API, open/close animation state and imperative store из visual layer.
+   - Эффективность: medium/high; простота: medium/hard; риск: medium.
+   - Делать, когда появится задача по left/sidebar UX или QA card для ручной приёмки.
+
+3. `logsContext.tsx`: migration/deprecation decision.
+   - Идея: не просто дробить файл, а решить направление: общий `logsController`/memoryStore или documented compat surface.
+   - Эффективность: medium/high; простота: hard; риск: medium/high.
+   - Без решения о будущем context logger переписывание будет косметическим.
+
+4. `chartEngineReact.tsx`: `useChartEngineCanvas` + `ChartCanvasView`.
+   - Идея: вынести canvas lifecycle, `ResizeObserver`, event attach/destroy and RAF bridge из React wrapper.
+   - Эффективность: medium; простота: medium; риск: medium.
+   - Имеет смысл, если будет stand/test на chart canvas lifecycle.
+
+5. `ParamsEditor.tsx`: full row-model/View split.
+   - Идея: продолжить после `useParamsEditorController`, но только через отдельную модель строк/inputs.
+   - Эффективность: medium/high; простота: hard; риск: high.
+   - Сейчас не брать как простую задачу: renderer рекурсивный и чувствителен к array mutation/resize/autostep UX.
+
+6. `SettingsDialog.tsx`: full View split.
+   - Идея: controller уже есть; следующий шаг — вынести visual tree/portal/FloatingWindow composition.
+   - Эффективность: medium; простота: medium/hard; риск: medium.
+   - Делать только вместе с реальным изменением UI, иначе польза ниже риска.
+
+Не включать как активные задачи без нового consumer/test: `memoryStore` core rewrite, `StickerMenu`, broad `DragBox`, `FResizableReact` hook.