wenay-react2 1.0.40 → 1.0.42

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.

package/doc/progress/hook-extraction-audit.md

@@ -0,0 +1,195 @@
+# Hook extraction audit (API-возвращающие хуки)
+
+Дата: 2026-07-09.
+
+Задача (надиктовка): пройти по всему коду фронт-библиотеки и осмысленно найти места,
+которые стоит вынести в `use*`/`create*` хуки, где хук **возвращает API** — методы,
+которые отдают X, Y, размеры, «сколько», snapshot и т.п. Не «работа ради работы»:
+каждый кандидат обязан устранять реальный императивный код/дублирование и иметь
+реального consumer (QA card / test / app), иначе он отклоняется.
+
+Метод: multi-agent проход. 7 finder-агентов по подсистемам (chart, menu, grid,
+dnd-geometry, replay-logs, settings/params/input, utils-core) → на каждый найденный
+кандидат отдельный adversarial critic (проверка фактов grep'ом, сверка с уже
+сделанным и запрещённым списком). Всего 27 агентов, 0 ошибок. Итог: 7 кандидатов
+прошли verify (3 do-now, 4 parked), 13 отклонено.
+
+Критерий осмысленности (из надиктовки): хочешь получить X,Y/размер/счётчик →
+правильный хук отдаёт **метод**, который это возвращает (`getSize()`, `getXY()`,
+`toPixel(v)`, `count()`, `isDirty()`). Не рефактор ради стиля.
+
+## Сверка с уже сделанным / запрещённым
+
+Проход НЕ переоткрывает уже сделанное: `useKeyboard`, `useMiniLogsTable`,
+`useParamsEditorController`, `useSettingsDialogController`, `useFloatingWindowController`,
+`useRightMenuController`, `createLogsController`/`useLogsTableController`/
+`useLogsNotificationsController`, `useTextInputPanel`/`useFileInputPanel`, section/density
+registries, `createSearchHistory`, `createUiSlot`, `columnState` `createUpdateApi` и др.
+И НЕ предлагает запрещённое без consumer: `FResizableReact` hook, `memoryStore` core
+rewrite, `PageVisibilityProvider` в обычный UI, `StickerMenu` shared primitive, `DragBox`
+broad rewrite. QA card 25 (эталонный toolbar, ~qa.tsx:603) — не трогать.
+
+---
+
+## Прошли verify — DO NOW (3)
+
+### 1. `useResizeObserver` / `useElementSize` — `MyResizeObserver.tsx`
+
+- Эффективность: medium; простота: simple; риск: low.
+- Императив сейчас: `CResizeObserver` — это класс + модульный синглтон
+  `global_resizeObserver`, чисто side-effect (`add()`/`delete()`), **без React-хука**,
+  который бы отдавал измерения.
+- Реальный consumer: `qa.tsx` `ResizeBugRepro` (объявлен ~1076, рендерится ~1723)
+  вручную городит `new ResizeObserver` + `rAF` + `getBoundingClientRect` +
+  `disconnect` в `useState`. Это **не** эталонная card 25.
+- Также `REFACTOR_PLAN.md` (строки 187/209/221/309) явно просит `useElementSize`
+  вместо ручного `MyResizeObserver` цикла.
+- API, который вернёт хук: `{ width, height, getSize(), ref/bind }` — ровно «хочу
+  размер → получаю метод/значение».
+- Подход: хук оборачивает существующий синглтон `CResizeObserver`, поэтому
+  `setResizeableElement`/вызовы из `ParamsEditor` остаются нетронутыми → малый surface.
+- Оговорки verify: только один чистый consumer (QA card); упомянутые «места
+  переиспользования» (FloatingWindow читает x/y для clamp, не размер; chart/agGrid
+  имеют свои ResizeObserver, но сложные) чисто не переходят на width/height API —
+  не завышать охват.
+- Проверка: `tsc` + `jest`; `ResizeBugRepro` переведён на хук, width/height
+  обновляются при ресайзе на стенде; старый `setResizeableElement` путь не сломан.
+
+### 2. `useLogsPageTable` / `useLogsFullTableController` — `logs.tsx`
+
+- Эффективность: medium; простота: medium; риск: medium.
+- Императив сейчас: `PageLogs` гоняет ag-grid императивно через `apiGrid` ref;
+  блок importance-filter `setFilterModel` **написан дважды** (эффект `updateBy(setting)`
+  ~92-103 И `onGridReady` ~160-167); `sizeColumnsToFit()` на update; `applyTransactionAsync`
+  append (~105-112).
+- Реальный live consumer: `qa.tsx` card 9 (монтирует `<PageLogs />` ~94; assertion ~1765).
+- Это последняя logs-таблица, не переведённая на controller-паттерн (MiniLogs и
+  `logsContext.LogsTable` — отдельные поверхности, уже сделаны).
+- API: `getApi()`, `fit()`, `applyImportanceFilter(min)`, `appendRow(row)`,
+  `onGridReady`, `columnDefs`, `gridProps`. Дедуп filter-логики в один метод.
+- Подход: `PageLogs` остаётся тонким wrapper; row identity сохранить.
+- Проверка: card 9 + стенд, особое внимание filter-timing и `applyTransactionAsync` append.
+
+### 3. `useCacheMapPersistence` — `cache.ts`
+
+- Эффективность: medium; простота: simple; риск: low.
+- Императив сейчас: тройное **точное** дублирование
+  `useEffect(() => { void cache.load(); return cache.onDirty(() => cache.saveDebounced(300)); }, [])`
+  в `qa.tsx`: `SettingsDialogDemo` (1221-1224), `UiSlotDemo` (1247-1251),
+  `ToolbarDemo` (1329-1332). `ToolbarDemo` (~1320) — отдельная демка, **не** эталонная
+  card 25 (та ~603).
+- Совпадает с задокументированным app-контрактом `doc/EXAMPLE_USAGE.md:85-99`,
+  `doc/wenay-react2.md:54-63`.
+- API: `{ isDirty(), flush(), save(), reload() }`. Внимание: cache отдаёт `load()`,
+  а не `reload()` — `reload()` сделать явным alias/ре-экспортом `load()`, не выдумывать
+  несуществующий метод.
+- Границы: аддитивная обёртка, **НЕ** `memoryStore` rewrite; scope строго
+  `load` + `onDirty`→`saveDebounced`, без pagehide/visibility flush.
+- Каждый сайт схлопывает ~2-3 строки — польза реальная, но скромная (поэтому
+  medium, не high).
+- Проверка: card 20/21 и toolbar demo — persistence переживает reload; card 25 не трогать.
+
+---
+
+## Прошли verify — PARKED (4)
+
+Реальны, но сейчас не do-now; причина зафиксирована, вернуть при условии.
+
+### `useChartCanvas` — `myChart/1/myChartTest.tsx`
+- Boilerplate реален (`ChartDemo`: `chartRef`+`containerRef`, `useEffect` с
+  `createChartCanvas`/`appendData`/`jumpToEnd`/`setInterval`/`destroy`, кнопки через
+  `chartRef.current?.method` null-check). `createChartCanvas` уже сам возвращает
+  API-объект — хук лишь добавил бы lifecycle и стабильные non-null методы (паттерн
+  как `useFloatingWindowController`). API: `containerRef, appendData, clearData,
+  scrollX, zoomX, jumpToStart/End/Index, setAutoScaleY, setShowTimeAxis/PriceAxis, draw()`.
+- **Почему parked**: единственный consumer — сам example-компонент `ChartDemo`, который
+  **не отрендерен ни в одной карточке/тесте** → нельзя проверить на стенде (working-style
+  требует tsc+стенд). Польза чисто косметическая/демонстрационная.
+- Поправки к автору кандидата: `redraw()` не существует (в `IChartCanvas` это `draw()`);
+  `ready` в интерфейсе нет — не тащить в API.
+- Вернуть как do-now, когда `ChartDemo` реально появится в карточке/тесте.
+
+### `useContextMenuGesture` — `menuMouse.tsx`
+- Дублирование реально: gesture-распознавание (порог 0.05, long-press 300ms,
+  right/dbl-click) в `menuMouse` `Layer` (~348-380) и в `menuR` `MenuR` (~55-107).
+- **Почему parked**: `menuR.MenuR` — **мёртвый код** (нет app-consumer; заявленный тест
+  на самом деле импортит `RightMenu.tsx`, не `menuR`). Единственный live consumer —
+  `Layer`. Делить хук с мёртвым кодом — мнимый выигрыш; честный фикс той половины —
+  удалить `menuR`. Touch-семантика тонкая, card 4 гоняет только mouse-путь → риск
+  touch-регрессии без нового consumer. Это часть уже-parked context-menu controller split.
+- Вернуть при: оживлении `menuR` с touch-тестами ИЛИ новом live touch-consumer.
+
+### `columnState.api.reorderPreview(order, key, to)` — `columnState.ts`
+- Метод на существующем `createColumnState` контроллере (не новый хук): экспонировать
+  move+fixed-pinning preview (+опц. `applyFixedPinning(order)`). Тройное дублирование
+  идиомы `filter(!fixed)+pinFixed-splice`: `columnState.ts:140-145`,
+  `ColumnsMenu.tsx:187-198`, `Toolbar.tsx:448-459`. Реальный consumer — `ColumnsMenu`
+  (qa cards 30/31).
+- **Почему parked**: метод дедупит только 1 из 3 копий (копия `Toolbar` — другой
+  контроллер над своими `opts.items`, честно вне охвата), и пересекается лишь pin-половина
+  → польза low. Брать, если появится общий reorder-контракт для обоих контроллеров.
+
+### `useResizeableFit` — `ParamsEditor.tsx`
+- 4x **байт-идентичный** inline ref-callback (`InputTime` 113-117, `InputList` 175-179,
+  `InputNumber` 212-216, `InputListArray` 269-273): `setResizeableElement(el)` +
+  `removeResizeableElement` cleanup. Consumer — `ParamsEditor` (qa cards 7 и 19).
+  Также чинит minor unmount-dispose leak.
+- **Почему parked / поправка**: это **не** `use*`-хук — все 4 сайта внутри обычных
+  функций-хелперов (`InputTime`/`InputList`/`InputNumber`/`InputListArray`), а не
+  компонентов, там нельзя вызывать хуки. Правильная форма — общий **module-level
+  стабильный bind callback-ref** (`bind(el)` ставит `setResizeableElement`, возвращает
+  `()=>removeResizeableElement`). Не пересекается с done (`useParamsEditorController`
+  покрывает только draft/notify) и forbidden (`FResizableReact` — другое). low risk,
+  узкая польза — можно сделать как маленький shared primitive отдельным микро-passом.
+
+---
+
+## Отклонено (13) — кратко, для покрытия
+
+- `useChartEngine` (`chartEngineReact.tsx`) — **parked/не conscious**: императивная
+  проводка реальна, но НИ ОДИН consumer не читает обратно координатный API
+  (`xToPixel/pixelToValue/getViewport/getCrosshair/getPanelCount`); обе точки
+  (`qa.tsx:1707` card 6, `use.tsx:187`) рендерят `<MyChartEngine/>` без пропов и ничего
+  не считывают. Координатный хук был бы спекулятивным. Вернуть, если появится стенд/тест
+  на chart canvas lifecycle или реальный consumer координат.
+- `useMenuPlacement` (`menu.tsx`) — **skip**: реальный `useLayoutEffect` + `getBoundingClientRect`,
+  но ровно один in-file consumer и ноль дублирования; `RightMenu`/`LeftModal` клампят
+  по другой семантике (parent rect / другая ось). Извлекать нечего дедуплицировать.
+- `useSidebarMenuController` (`LeftModal.tsx`) — **parked**: движок реален, но заявленные
+  consumers ложны (в `use.tsx` — закомментированный блок; `Parameters.tsx` не импортит
+  `LeftModal`). Нет live consumer. Совпадает с уже-parked LeftModal split.
+- `useStickerMenuDrag` (`StickerMenu.tsx`) — **skip** (overlap forbidden): drag реален,
+  но consumer'ов нет (только barrel export + docs). `StickerMenu` в запрещённом списке.
+- `useColumnDotsGestures` (`ColumnDots.tsx`) — **skip**: жестовая логика реальна, но
+  единственный consumer — card 29, второго нет. Извлечение = вью-модель без внешнего
+  X/Y/size/count consumer.
+- `useCardModel` (`CardList.tsx`) — **skip**: single-use presentation-деривация (~15 строк),
+  без дублирования, consumer только сам `CardList` (card 29). Спекулятивно.
+- `useDragArea` / `getXY on DragArea` (`DragArea.tsx`) — **skip** (overlap): у `DragArea`
+  нет render-consumers (только export + docs); дублирует `useDraggable`. Мёртвая поверхность.
+- `createLogsStore` / `useLogsStore` (`logsContext.tsx`) — **parked** (overlap): store
+  реален и дублирует `logsController`, но новых consumer'ов нет (только same-file демо +
+  1 unit-test). Это migration/deprecation-решение по `logsContext`, а не быстрый split.
+- `useInputAutoStep` (`ParamsEditor.tsx`) — **parked** (overlap): apply-only DOM behavior,
+  1 consumer (`InputNumber`), геттеров не читает; есть minor unmount-dispose leak (стоит
+  починить точечно). Не тянет на API-хук.
+- `useNumericInputDraft` (`ParamsEditor.tsx`) — **parked**: WeakMap-черновик реален, но
+  `InputNumber` вызывается как обычная функция (`InputNumber(set,val,range)`, не JSX) →
+  хук внутри вызвать нельзя. Блокер до превращения `InputNumber` в компонент.
+- `useCallbackHubEffect` (`callbackHub.ts`) — **skip**: `createCallbackHub.on` уже
+  возвращает unsubscribe, годный прямо в `useEffect`; обёртка не нужна; 1 demo-consumer.
+- `useObservableMap` (`observableMap.ts`) — **skip**: чистый 45-строчный data-layer,
+  ноль UI-императива/дублирования; подписчики только внутренние + тесты.
+- `usePageVisibility` (`pageVisibilityContext.tsx`) — **parked** (overlap forbidden):
+  дублирования нет (`PageVisibilityProvider` уже инкапсулирует listener); хук был бы просто
+  `useContext`; consumer'ов ноль. В запрещённом «без consumer» списке.
+
+## Рекомендованный порядок
+
+1. `useCacheMapPersistence` — самый безопасный (simple/low), аддитивный, 3 реальных consumer.
+2. `useResizeObserver`/`useElementSize` — simple/low, явный запрос в REFACTOR_PLAN + живой consumer.
+3. `useLogsPageTable` — medium/medium, последняя logs-таблица вне controller-паттерна; делать аккуратно (filter-timing).
+
+Каждую задачу — по правилам `doc/target/README.md`: старое имя оставить compatibility
+wrapper, публичный API не менять, проверять `tsc -p tsconfig.qa-check.json --noEmit` +
+`jest` + сборку + стенд. Версию не бампать, не публиковать, не пушить.