wenay-react2 1.0.40 → 1.0.42

package/doc/target/my.md

@@ -0,0 +1,81 @@
+# Target — очередь задач
+
+Правила ведения: [README.md](README.md). Ниже — статус по задачам; **исходные надиктовки сохранены дословно в конце файла** (ничего не удаляю).
+
+## In Progress
+
+_Пусто._ «Hook extraction — do-now кандидаты (3)» выполнен 2026-07-09: `useCacheMapPersistence` (cache.ts), `useResizeObserver`/`useElementSize` (MyResizeObserver.tsx), `useLogsPageTable` (logs.tsx); старые имена — compatibility wrappers, card 25 не тронута. Проверено: tsc qa-check, jest 45/45, build, стенд 3010 (карточки 21 F5-persistence / 19 resize / 9 logs). Durable-запись: `doc/changes/v1.0.41.md`; parked/отклонённые кандидаты остаются в `doc/progress/hook-extraction-audit.md`.
+
+(Предыдущий проход «Нормализация внутренних слоёв библиотеки» проверен multi-agent-верификацией и отгружен в v1.0.40/v1.0.41; durable-запись: `doc/progress/public-surface-normalization.md`, `doc/progress/hook-controller-opportunities.md`, `doc/changes/v1.0.38–v1.0.41.md`.)
+
+## Ready
+
+- **API-витрина: ярусы канон/compat + quickstart** (из оценки юзабельности 2026-07-10, надиктовка в конце файла).
+  - Проблема: вызовы лаконичные, но ИЗУЧЕНИЕ — нет. Рядом с каноном на одной поверхности торчит легаси (3 публичных способа модалки, 2 стека логов, `Get*`/`*2`/`*3`-имена, demo-экспорты типа `MyChartEngine`); новичок не отличит канон от compat без rare-дока; `updateBy`-модель — налог на вход.
+  - Задача (без breaking, чисто витрина): 1) **README/quickstart** — 5 главных примитивов с примерами (toolbar+columnState, SettingsDialog, FloatingWindow, replay-хуки, memoryCache-контракт), «начни отсюда»; 2) **явные ярусы** — либо отдельный «modern» entrypoint (реэкспорт только канона, старый корень не трогаем), либо чёткая namespace-разметка в api.tsx + в brief-доке бейджи канон/compat/deprecated; 3) размеченный список compat-поверхности синхронизировать с Cleanup Inventory (rare-док) — он же план breaking-версии.
+  - Оценка: эффективность high (самый дешёвый рост юзабельности), простота easy/medium (докосновно + один реэкспорт-модуль), риск low (аддитивно, публичный API не меняется).
+  - Связка: breaking-версия (A3 + снос deprecated `onCLickClose`/`keySave`/`DragArea`/`menuR`, сужение `ListenApi`) идёт ПОСЛЕ витрины — витрина и есть список того, что сносим.
+
+- **common2 1.0.66–1.0.68 adoption: Media + route coordinator/WebRTC React surface** (из надиктовки №4 «посмотри, что нового, создай цели использовать»).
+  - Контекст: 1.0.66 = `Media` (захват мик/камера как бинарные Listen/replay-источники, `decodeMediaFrame`), 1.0.67 = `Replay.createRouteCoordinator` (policy-gated relay↔direct, link.subscribe без switchRoute), 1.0.68 = WebRTC direct-путь (`createSignalHub` по существующему RPC-сокету, `createWebRtcConnector` с инжектируемой `rtc`-фабрикой — инжекция `() => new RTCPeerConnection(cfg)` живёт на браузерной/React-стороне, `acceptWebRtcDirect`, `serveReplayChannel`). Вместе: media → replay line → policy-маршрутизация relay/direct.
+  - **1. `useMediaSource` (capture-control hook)** — пересмотр прежнего решения «Media-хуков намеренно нет»: consumption по-прежнему через существующие `useReplay*`-хуки, но capture `control` (`start()` → `'idle'|'requesting'|'live'|'denied'|'no-device'|'error'`, `stop()`, `setDevice`, `listDevices`, stats) — это permission/device/lifecycle state machine, hook-shaped. Хук: state как React state, `listen` наружу как есть, stop() на unmount. QA card: камера → `replay:true` линия → canvas через `useReplaySubscribe`+`decodeMediaFrame`; deny/no-device видимы на стенде.
+  - **2. Peer SDK adapter (supersedes the raw coordinator-link idea, common2 1.0.69)** — React surface over `Peer.createPeerClient`: `usePeer(client, account)` -> peer's mirrored store (plugs into existing `useStoreNode`/`useStoreKeys`) + route state/controls (`promoteDirect` result-object, `reinterposeRelay`, `route()`, `ready`, `seq()`). Do NOT bend existing route hooks; mirrors survive route changes by design. QA card modeled on oracle `replay/peer-sdk.test.ts` (fake in-proc RTC runtime); common2 1.0.70 ships the oracles + `demo/` stand in the package as living examples to crib from.
+  - **3. WebRTC recipe (docs/example, not a hook)** — how the app injects the `rtc` factory (`() => new RTCPeerConnection(cfg)`) and wires the signal port from `createRpcServerAuto`; combine with a Media source (call/stream demo) over Peer. Real-browser ICE serialization is fixed in 1.0.69 (`toJSON()` on the wire), so a live two-tab demo is feasible — see common2 `demo/` shared-cursors stand.
+  - Оценка: 1 — simple/low-risk (аддитивно); 2 — medium (in-proc fake стенд, по образцу peer-sdk oracle); 3 — docs-first. Приоритет: после architecture-fix очереди A1-A10.
+
+- **Context menu / Menu: controller-first split**.
+  - Прогресс/оценка: [../progress/hook-controller-opportunities.md](../progress/hook-controller-opportunities.md)
+  - Смысл: выделить `createContextMenuController` / `useMenuLayer` + `MenuView` и action-layer для async/progress/submenu flow, не ломая `contextMenu.openAt`, `contextMenu.Layer` и `contextMenu.stats`.
+  - Оценка: эффективность high; простота medium/hard; риск medium. Брать только отдельным focused pass с tests по click/async/submenu/stats.
+- **Chart canvas wrapper: `useChartEngineCanvas` + view split**.
+  - Прогресс/оценка: [../progress/hook-controller-opportunities.md](../progress/hook-controller-opportunities.md)
+  - Смысл: вынести canvas lifecycle, `ResizeObserver`, event attach/destroy and RAF bridge из `MyChartEngine` wrapper.
+  - Оценка: эффективность medium; простота medium; риск medium. Брать, если будет stand/test на chart lifecycle.
+
+- **Architecture audit 2026-07-09 — fix queue** (4 subsystem readers + core reading; suspicious surfaces recorded in rare-doc Cleanup Inventory).
+  - DONE 2026-07-09/10 (details + verification in `doc/changes/v1.0.41.md`): **A1** memoryStore layering inverted (`utils/persistedMaps.ts`, components re-export their maps); **A2** `getLogsApi` per-call state isolation (+`settingsKey`), global `logsApi` keeps legacy shared state; **A4** columnState barrel is ag-grid-free again (columnGrid ships from its own module via root api); **A5** shared `utils/fixedOrder.ts` replaced 4 inline pinFixed copies; **A6** updateBy: f-through-ref, separate React/imperative listener sets (renderByLast/Revers touch only React subscribers), bounded reentrancy coalescing; **A8** `dispose()` on createToolbar/createColumnGrid + `visibleCount` re-seed on re-attach; **A10-safe** searchHistory read purity, window guards (RightMenu render clamp, LeftModal useViewport, ApiLeftMenu default element), dead imports dropped.
+  - **A3 (high, BREAKING)** `menuR.tsx` is dead public code + duplicates menuMouse gesture logic (menuMouse.tsx:342-380). Remove in a deliberate breaking version (recorded in Cleanup Inventory).
+  - DONE 2026-07-10 (**A7**, details in `doc/changes/v1.0.42.md`): DragBox → адаптер над useDraggableApi (+аддитивные `onMove`/`trackState` в хук, `__test/dragBox.test.tsx`, QA card 35); DragArea @deprecated as-is (уникальная семантика, потребителей нет — снос только в breaking); useFloatingWindowController/StickerMenu остаются на своих loop'ах осознанно (clamp/buttons-recovery/persist/z-stack и mount-lifetime listeners/click-suppression — load-bearing).
+  - DONE 2026-07-10 (**A9**, details in `doc/changes/v1.0.42.md`): внутренний `components/Overlay.tsx` (portal+scrim+outside+Escape, НЕ экспортирован); ModalProvider и SettingsDialog — адаптеры над ним (публичный API/поведение 1:1, включая двухступенчатый Escape SettingsDialog); createModalElementStore/LeftModal-drawer/ModalWrapper — осознанно не overlay'и. `__test/modalProvider.test.tsx`. Overlay = DOM-шов для будущего RN-слоя.
+  - DONE 2026-07-10 (**A10 safe part 2**, details in `doc/changes/v1.0.42.md`): `onClickClose` additive alias (+deprecated `onCLickClose`); `keyForSave` alias on useOutside `Button` (+deprecated `keySave`); QA card dup fixed (Replay 25→33, 26→34; toolbar 25 / useReorder 26 keep numbers); `__test/tokens.test.ts` two-way tokens.ts↔tokens.css guarantee (codegen отклонён — сборку не трогаем).
+  - DONE 2026-07-10 (**A10 loop-guard**, details in `doc/changes/v1.0.42.md`): `readFromGrid` guards на `structEqual` (utils/structEqual.ts, экспортирован из barrel); порядок-чувствительный `sameMap` НЕ тронут осознанно (его чувствительность реимпозит stored order при сбросе columnDefs).
+  - **A10 remaining (breaking only)**: raw `ListenApi` (emit/close) exposed from columnState/Toolbar onChange (narrowing is breaking); removal of deprecated `onCLickClose`/`keySave` — breaking pass only.
+  - Rule: each fix is its own focused pass with verify (tsc+jest+build+stand); breaking removals only in a deliberate breaking version.
+
+- **Hook extraction — parked кандидаты** (do-now 1-3 выполнены и отгружены, см. In Progress выше / `doc/changes/v1.0.41.md`). Остались условные: `useChartCanvas` (ждёт ChartDemo в карточке/тесте), `useContextMenuGesture` (ждёт оживления menuR или live touch-consumer), `columnState.api.reorderPreview` (ждёт общего reorder-контракта), `useResizeableFit` (маленький shared bind callback-ref, отдельный микро-pass). Полные причины/условия возврата: [../progress/hook-extraction-audit.md](../progress/hook-extraction-audit.md).
+
+## Inbox
+
+- **React Native / мобильная версия функционала** (надиктовка 2026-07-10, дословно в конце файла).
+  - Суть: библиотеку планируют использовать и в мобильном (React Native), где DOM недоступен (нет `document`/`window`/`createPortal`/CSS-классов).
+  - Первичная оценка: слоистость уже движется в нужную сторону — headless/controller-слой (updateBy/renderBy, columnState config, createToolbar config+Settings-модель, callbackHub, observableMap/memoryCache, replay-хуки) в основном DOM-free и потенциально переносим; DOM живёт во view-слое (FloatingWindow/Rnd, порталы/скримы, CSS-токены, ag-grid). Направление: (1) аудит `document`/`window`/`createPortal`/CSS-зависимостей по модулям; (2) выделить/закрепить platform-neutral core (возможно отдельный entrypoint без DOM-импортов); (3) RN-view-адаптеры — отдельный пакет/подпапка, не в этом проходе. ag-grid в RN не живёт — мобильные представления уже есть (ColumnDots/CardList) как модель. Персист: storage-слой абстрагировать (localStorage → AsyncStorage).
+  - Статус: требует отдельного скоупинга после A-очереди; A9 Overlay-примитив планировать сразу с учётом этого (ядро без DOM, портал/скрим — в web-адаптере). Стоявшие здесь specs («Недоиспользуемые методы: primitive-reuse pass» и «Hook/controller-first backlog») проверены multi-agent-верификацией: оба `doneInCode=fully`, отгружены в v1.0.39–v1.0.41, конкретные изменения записаны в changelog (MiniLogs/AgGridTable/`useListenEffect`/стиль-токены — v1.0.39/40; MessageEventLogs split — v1.0.41). Удалены из очереди; durable-запись — в `doc/progress/public-surface-normalization.md` и `doc/progress/hook-controller-opportunities.md`. Внутренний `createUpdateApi`-pass намеренно только в progress (публичный API не менялся).
+
+## Verify
+
+_Пусто._ «Система стилей и CSS variables» проверена: `doneInCode=fully`, `.wenayColsMenu*`/`--cols-menu-*` и `--cols-dots-*`/`--cols-card-*` в коде, changelog v1.0.38/v1.0.39/v1.0.41, отгружено в релизах. Удалено; durable-запись — `doc/progress/style-system-normalization.md`.
+
+## Blocked — уровень приложения (не эта React-библиотека)
+
+Эти задачи живут на стороне приложения (`clientBacktest` / супер-админка), а не в этой библиотеке. Держим как источник, пока не будет доступа к тем репозиториям.
+
+- **Balance / Client Backtest**: total по категориям и общий total; фильтры по каждой категории; количество монет в базовой валюте (или фильтр относительно прайса, как на главной странице — есть спец-фильтр для кредитов); кликабельность — возврат займа (по одной и массово, правой кнопкой), панель займа как на главной, трансфер в spot/др. (в т.ч. массовый), массовая очистка лимиток, массовое закрытие позиций на фьючерсах; окно рыночной сделки (buy/sell по выбранному рынку) по кнопке Asset и по BaseOne.
+- **Уровень прав пользователя через супер-админку**: IP супер-админки статичен (хардкод-константа в коде, не ENV); узнавать уровень/права клиента через супер-админку (клиентские страницы и так открываются через неё); нужно комплексное решение — bootstrap прав при открытии клиентской страницы.
+
+---
+
+## Исходные надиктовки (дословно)
+
+> Тут я буду надиктовывать различные задачи через Transkriptor, э-э-э, поэтому могут быть какие-тооо опечатки в словах, это нужно понимать. Вот. И вот этот главный пункт — это как бы ты запишешь как README таргета, что ли, а-а-а, файл README. Это твоя первая задача, по сути. А-а-а, потом суть данного направления в том, что типа я просто надиктовываю задачи, которые хочу сделать в порядке какой-нибудь очереди, ну, чтобы про них потом не забыть. Иии потом ты- Угу действия начинаешь выполнять, ты делаешь согласно своих правил, там, у тебя правила записаны, как поступать. Типааа прогрееесс, там, файл, типа, и прочее, ход выполнения. Иии к-- если ты её взял на разработку, то ты как-то должен помечать, типа, вот взял на разработку. Типа, доделано, недоделано — это мы уже потом по прогрессу будем смотреть. Вот и всё. Ну и удалять отсюда, чтобы всегда подчищать документ. То есть я сюда- выкидываю задачи. Можно даже сделать несколько слоёв. Слой, типа, от меня, как задачи, слой, который выполняется, пока не выполнен полностью, и тот, который выполнен и уже очищен. Ну, вот, я думаю, это так будет наиболее правильно.
+
+> Нам нужнооо Используя технологию из библиотек, наших же, а-а-а, изменить Ниньо. А точнее, давай не миньо, начнем с баланса. А-а-а, вот есть Binance, а-а-а, баланс нааа Client Backtest. Э-э-э, там есть кнопка, так и называется она Баланс есть. И там есть для спота, для кросса, для фьючерсов отдельные записи. Хотелось бы видеть там же total общий, а-а-а, в базе в его соответствиях, также total по категории. Такжеяя ты сделал таблицу, нооо Лучшеее разрешить таммм вот эти фильтрыыы везде. Который, ну, м-можно было, чтоб каждую категорию фильтровать. Ну, в общем, как обычно. Потом А, кстати, вас бы, чтобы палатка кабельность То есть важно Чтооо, допустим, количество монет мне нужно фильтровать в базовой валюте, ну, типа относительно. Ну, тут есть хотя бы базовая валюта. Я могу по этому столбцу фильтровать. Вот. Ну, либо писать там, как бы в скобках, сколько это будет в базовой валюте, как, ну, как на главной странице. Иии фильтр-- ну, тоже сделать всё, как на главной странице: фильтр относительно прайса. Там у нас специальный фильтр для кредитов для этого написан, и он там используется. Потоммм А, добавить кликабельность, наверное. Что я имею в виду под кликабельностью? Ну, типа чтобы можно было нажать там на «Борууу» и можно было вернуть займ. Вот. Чтобы можно было выделить массово и вернуть займ везде правой кнопкой, допустим, а-а-а, либо по одной монете вернуть займ. Вот. Чтобы при клике на «Борууу» именно открывалась панелька займа, как с главной страницы. Ну, это касаемо кросс. Вот. Чтобы я мог нажать правую кнопку, нажать «Перевести трансфер» иии просто перекинуть её, а-а-а, в spot или куда-нибудь ещё, чтобы я мог массово выделить и сделать массовый трансфер. Вот. Хоть получается у нас много где такие правды, но всё-таки. Также по лимиткам хочу иметь возможность очистить данную лимитку, также массово выбрать, очистить массово лимитки. Вот. А-а-а, на фьючерсах Закрыть позиции массово. А-а-а, также я хочу при нажатии на кнопку «Asset» Чтобы у меняяя, наверное, открывалось окно возможности конвертации данной монеты, но без кон-- ну и без системы конвертации рыночной, типа buy-sell. По различным рынкам. Ну, типа, чтобы мне предполагалось, м-м-м, на как-- по какому рынку я хочу открыть диалоговое окно на покупку-продажу. Вот. Ну, типа, чтобы на месте я мог Выбрать, куда я хочу Стифом продать или купить. А-а-а, потом. А-а-а, м-м-м Как бы, конверт у BaseOne. А-а-а, конвертировать базовую валюту. Но опять же, это ещё не конвертация, а именно сделка по рынку, по ASL. Вот, а-а-а Точно так же хотелось бы отцу-то её иметь.
+
+> Смотри, нам, короче, нужно как-то брать. У нас есть, короче, супер-админка, и его-- и ее IP-шник, как правило, пока что статичен. Можно хардкодить временно, ну, либо использовать как через переменную, хардкодить через переменную статическую, чтобы было-- ну, не через ENW, а в коде прям, короче. Вот. И просто у нас есть некоторые моменты, которые требуются только для определенных вещей, и нам бы узнавать уровень пользователя. Типа, ну, есть ли права, а-а-а, в клиентской системе, э-э-э, типа для такого-то режима. А узнать уровень пользователя мы можем только через супер-админку. Вот. Как это правильнее сделать? Я пока не понимаю. Ну, типа, к примеру, вот мы на фронте показываем APK. Пока что понятно для отладки, у нас пока так и оставляем. Ну, это больше задачааа, которая требует, наверное, комплексного решения. Скорее всего, нам нужно просто открывать клиентскую страницу через суперадминку. Кстати, мы так и делаем. Все клиентские страницы мы открываем через суперадминку.
+
+> wenay-common2 Обнови эту библиотеку на последней версии. Посмотри, что там есть новое, можем ли это использовать. Если можем, тооо создай в таргете цели использовать это. И что необходимо сделать в качестве задач.
+
+> у нас еще планируется мобильные устройства - там говорят нет каких то элементов. и что то скорее всего надо продублировать
+
+> да мы еще планиурем использовать библиотеку и для мобильного использования , а там дум обьекты вроде не потдерживаются.... ну ты сам знаешь что надо для реакт нативу - может сделать мобильную версию этого функционала
+
+> вопрос насоклько этот код вобще лакнчиный и юзабельный?ты бы сам ег остал использовать [оценка 2026-07-10: вызовы лаконичны, изучение — нет; задача «API-витрина» в Ready] да оформи задачу в my.md но текущий релиз запуш