test: pin date in account events date filter test (WealthLedger/frontend#98)

The test clicked today + 10 days, which falls outside the Mantine calendar grid for some real dates and made the suite fail depending on the run date.

.ai/architecture.md

@@ -8,7 +8,7 @@ Vitest — отдельную JSDOM конфигурацию. Точные versi
 [package.json](../package.json), реализация — source of truth.
 
 ```text
-app → pages → features → entities → shared
+app → pages → widgets → features → entities → shared
 page container → page VM → entity/feature query → shared/api → backend /api/v1
                          ↓
                  props → state/section views
@@ -30,13 +30,15 @@ contract; frontend не читает его checkout для генерации
 | --- | --- |
 | Bootstrap, глобальные providers, routes | `app` |
 | Композиция маршрута и поведение, нужное только этому экрану | `pages/<page>` |
+| Крупная переиспользуемая композиция экрана | `widgets/<widget>` |
 | Самостоятельная пользовательская возможность с собственным смыслом | `features/<capability>` |
 | Представление/поведение бизнес-сущности | `entities/<entity>` |
 | Переиспользуемый код без WealthLedger domain meaning | `shared` |
 
-Локальный FSD profile: `app → pages → features → entities → shared`, без `widgets`.
+Локальный FSD profile: `app → pages → widgets → features → entities → shared`.
-Крупный уникальный блок остаётся в своей page. Form, mutation или click handler
+Widget собирает несколько нижних слоёв в самостоятельный UI-блок; компонент для
-сами по себе не требуют feature. Два callers не делают domain helper generic shared.
+одной page остаётся у page. Form, mutation или click handler сами по себе не
+требуют feature. Два callers не делают domain helper generic shared.
 Slice именуется по ответственности, а не `helpers`, `hooks` или `types`.
 
 **Безопасный путь:** при сомнении оставь код у ближайшего допустимого owner.
@@ -47,35 +49,45 @@ Slice именуется по ответственности, а не `helpers`,
 
 Cross-slice consumer использует `@/` и `index.ts` владельца, например
 `@/entities/portfolio`. Alias Vite и TypeScript согласован. Другой slice не
-импортирует внутренний файл напрямую. Slices `pages`, `features`, `entities` не зависят от соседнего slice своего слоя;
+импортирует внутренний файл напрямую. Slices `pages`, `widgets`, `features`, `entities` не зависят от соседнего slice своего слоя;
 композиция принадлежит вышележащему owner. Existing меж-slice исключения
 не являются разрешением добавлять новые.
 
-Направление зависимостей и public imports частично проверяет
+Направление зависимостей, public imports и запрет соседних slices в
-`npm run deps`; Knip проверяет использование exports, а не смысл placement.
+`pages`, `widgets`, `features`, `entities` проверяет `npm run deps`. Внутренние imports
+одного slice и связи shared segments этот запрет не ограничивает.
+Knip проверяет использование exports, а не смысл placement.
 
 ## UI foundation
 
-`shared/theme/tokens.json` — переносимый source design tokens; `theme.ts`
+Private workspace `packages/tokens` экспортирует переносимый source design tokens
+как `@wealthledger/tokens/tokens.json`. Private workspace `packages/ui`
 адаптирует доверенный JSON к Mantine без runtime schema. App и Storybook читают
-public API `shared/theme`. Storybook показывает synthetic presentation states,
+`@wealthledger/ui/theme` и явно подключают `@wealthledger/ui/styles.css` после
+Mantine CSS. Потребители используют public exports пакетов напрямую. Storybook показывает synthetic presentation states,
 не использует application API. RTL/MSW проверяют поведение приложения отдельно.
 
-Existing route-aware AppShell расположен в shared/ui; это legacy placement,
+Route-aware AppShell и его navigation styles принадлежат `app/ui`;
-а не образец нового shared primitive. При изменении foundation прочитай
+`ProtectedLayout` использует public API этого владельца. При изменении foundation прочитай
 [UI](conventions/ui.md#визуальная-основа) и [Storybook](conventions/storybook.md).
 
+Все SVG, их геометрия и анимации принадлежат private `packages/icons`.
+Приложение импортирует компоненты из `@wealthledger/icons` и подключает
+`@wealthledger/icons/styles.css`. В `src` нет SVG-файлов и компонентов,
+единственная задача которых — рисовать иконку. Domain mapping категории в
+параметры `OperationIcon` остаётся в `entities/bank-card/model`.
+
 ## Примеры
 
-- Общая busy-область: существующий [LoadingSkeleton](../src/shared/ui/LoadingSkeleton.tsx), а не domain widget в shared.
+- Общая busy-область: существующий [LoadingSkeleton](../packages/ui/src/LoadingSkeleton/LoadingSkeleton.tsx), а не domain widget в shared.
-- Account-income state views: [страница](../src/pages/account-income/ui/AccountIncomePage.tsx) и её flat `components/*.view.tsx`; новый page-local filter остаётся здесь.
+- Account-income state views: [страница](../src/pages/account-income/ui/AccountIncomePage/AccountIncomePage.tsx) и её `components/`; новый page-local filter остаётся здесь. Комплекты файлов группируются по [UI convention](conventions/ui.md#размещение-файлов-компонента).
 - Portfolio query: [entity public API](../src/entities/portfolio/index.ts); новая UI-сводка с бизнес-смыслом не становится shared только из-за нескольких экранов.
 
 ## Проверка
 
 После placement/import change: `npm run deps`, `npm run typecheck`, `npm run knip`;
 после собственного behavior — применимые tests. Финальный gate указан в AGENTS.
-Existing dependency config не запрещает все same-layer imports: их и смысл
+Graph `src` и `packages` проверяет текущий dependency-cruiser; зависимости
-owner проверяет review. Не объявляй Steiger установленным; graph проверяет
+из packages в код приложения `src` запрещены. Generated `packages/*/dist`
-текущий dependency-cruiser. Review отдельно проверяет смысл owner: разрешённый dependency graph не доказывает
+не анализируется как исходник; все package sources остаются в graph. Review отдельно проверяет смысл
-правильный выбор слоя.
+owner: разрешённый dependency graph не доказывает правильный выбор слоя.

.ai/conventions/data.md

@@ -30,7 +30,8 @@ backend checkout и не проверяют backend runtime OpenAPI; измен
 shape/status/route сохраняет
 публичный контракт предоставленного snapshot.
 Одна UI-модель не требует менять API. `openapi:generate` работает offline от snapshot;
-`openapi:check` генерирует во временный каталог и сравнивает, не меняя tracked files.
+`openapi:check` запускает native `--check` того же CLI и падает при устаревших
+generated types, не меняя tracked files.
 
 ## Auth и invalidation
 
@@ -39,6 +40,10 @@ Authorization. Auth endpoints исключены из Bearer/retry middleware. R
 координируется single-flight; после `401` с `UNAUTHORIZED` возможен один retry.
 Не добавляй собственный refresh/retry loop в caller.
 
+Cookie-writing requests упорядочены только в текущей вкладке. Cross-tab auth
+synchronization не требуется; допустим reload/re-login. Web Locks и отдельные
+token stores не добавляются.
+
 Protected queries используют existing session-aware boundary; logout очищает
 session-scoped cache. Access token хранится только в памяти, refresh передаётся
 httpOnly cookie с `credentials: include`. Не сохраняй tokens в localStorage,
@@ -50,6 +55,15 @@ GET subtree; ошибка mutation не меняет generation/cache. Это о
 от обычного фонового refetch. Даже повторное сохранение того же token начинает
 новую generation; поздний ответ прежней generation не попадает в новый кэш.
 
+Отмена/reset принадлежат TanStack Query и generated queryFn с AbortSignal,
+без HTTP request registry, URL-wide latest-read counters и access epochs.
+Успешный HTTP с `data: null` остаётся query success; readiness выбирается по
+data/metadata, без подмены query status и отдельного transport state.
+Status синхронизации содержит только состояние работы. Resources читаются
+через `sync=observe` во время работы и после завершения, без hash comparison.
+Согласованность income entries/groups обеспечивает backend; frontend не
+дублирует её runtime validator.
+
 Mutations используют существующий generated client и query-key owner;
 после успеха обновляй/invalidируй только связанные данные. Optimistic update
 нужен конкретному UX и обязан иметь rollback/error behavior.
@@ -70,7 +84,7 @@ Network/unknown error получает безопасное локальное
 
 Если одна группа API codes требует одинакового recovery в нескольких views,
 сведи классификацию у ближайшего общего owner. Не размножай magic comparisons
-и не объявляй закрытый frontend error enum: generated `code` пока `string`.
+и используй `ApiErrorCode` для известных значений: generated `code` остаётся `string`.
 Неизвестный новый code должен сохранять fallback. Рефакторинг существующих
 разных recovery paths требует behavior proof, а не общей обработки всех ошибок.
 

.ai/conventions/engineering.md

@@ -7,11 +7,19 @@
 checkout. Внешний API задаётся предоставленным публичным контрактом;
 исходники или инструкции его реализации не являются зависимостью разработки.
 При нехватке требования сообщи, какое решение не определено, до его реализации.
+При конфликте с общим шаблоном следуй местным правилам и явному запросу
+пользователя. Выбирай реализацию самостоятельно, но изменение финансовой
+логики, публичного контракта или утверждённой семантики возвращай владельцу
+на согласование до зависимой работы.
 
 Начни с результата и affected areas. До edits проследи flow/invariants, найди
 owner и 1–3 примера. Код показывает механизм; случайный аналог не меняет контракт.
-Работай напрямую; OpenSpec/SDD lifecycle — только по явному запросу.
+Выбери lightweight или SDD по [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/03b3b59e6ff2ba391f9dfc42a039a96d0d84c1c9/.ai/conventions/engineering-workflow.md);
-Перед Node-командами активируй местную `.nvmrc`: `nvm use --silent`.
+OpenSpec lifecycle начинай после явного решения Change Owner.
+Перед Node-командами активируй местную `.nvmrc`: если `nvm` не загружен в
+non-interactive shell, загрузи установленный `$HOME/.nvm/nvm.sh`; затем
+выполни `nvm use --silent` из frontend. Если `nvm.sh` недоступен, остановись,
+не используй системный Node.
 Сохраняй чужие staged/unstaged/untracked изменения и read-only архивы.
 
 ## Change scope
@@ -29,7 +37,8 @@ owner и 1–3 примера. Код показывает механизм; с
 ## Domain values
 
 Finite business vocabulary принадлежит одному domain/module/entity owner.
-Переиспользуй его symbols; для нового словаря без аналога — `as const` + union.
+Переиспользуй его symbols; для machine codes и protocol values используй
+строковые `enum`, для структуры с разными payload — discriminated union.
 Сохраняй wire values; generated/external enums не переписывай вручную.
 Numeric policy называй по смыслу и единицам. Индексы, `Math.max(value, 0)` и
 обычные labels не выноси в constants без semantic benefit.
@@ -56,21 +65,33 @@ Peer-конфликт решай совместимыми версиями бе
 
 ## Проверки и завершение
 
-Code/dependency change: `npm ci`, полный `npm run verify` и дополнительные
+| Когда | Что проверить |
-risk checks из местной testing convention. Targeted tests ускоряют итерацию,
+| --- | --- |
-но не заменяют финальный gate. `lint:fix`/format — edits, не proof.
+| Окружение новое, изменились manifest/lockfile или Node, установка сомнительна | `npm ci` до Node-проверок; одна правка кода переустановки не требует. |
-Markdown-only: проверь новые/изменённые тексты, локальные ссылки/якоря, маршруты
+| Итерация | Адресные тесты, typecheck и lint по затронутому поведению и риску. При изменении поведения добавь/обнови содержательную регрессию, если существующая проверка не ловит её; для косметики не создавай искусственный тест. |
-чтения и `git diff --check`; application build ради текста не нужен.
+| Итоговый code/dependency diff | Перед объявлением готовности и передачей к интеграции выполни один полный `npm run verify` на итоговых входах. Дополнительные risk checks из testing convention и явно утверждённые task checks обязательны; CI проверяет независимо. |
-Повтори routing по staged/unstaged/new files. Запиши краткие команды, результаты
+| Только Markdown | Проверь тексты, ссылки/якоря, маршруты чтения и `git diff --check`; application build не нужен. При изменении verification-контура проверь его работу. |
-и ограничения. Зелёный lint не заменяет semantic/security review.
+| Pre-commit | Hook не скачивает tools: вызывай установленные бинарники из `node_modules/.bin` (не `npx`). Full graph не входит в hook; он выполняется в `npm run verify` и CI. |
+
+Повтори routing по staged/unstaged/new files. В отчёте по задаче/PR запиши
+проверенные входы, команду, exit code, результат и ограничения. Повторяй
+проверку при изменении значимых входов (включая config, dependencies и
+generated artifacts), сомнении в evidence или явном запросе пользователя.
+`lint:fix`/format — edits, не proof; lint не заменяет semantic/security review.
 
 ## Git и релизы
 
-Работа — в `codex/<task>` от актуального `develop`, затем PR в `develop`.
+Работа — в ветке `<type>/<issue-number>-<slug>` от актуального `develop`,
+затем PR в `develop`; для cross-repo ссылки укажи owner/repo#number.
 Сохраняй чужие изменения; перед commit просмотри staged paths и diff.
-Commits и PR titles — Conventional Commits; допустим `spec:`. Каждый commit
+Commits и PR titles — Conventional Commits с parser-recognized Issue reference (`fix: … (#12)`
-содержит одну связанную задачу. При связанной issue добавь её номер в конец
+или `chore: … (WealthLedger/main#27)`); допустим `spec:`. Каждый commit
-заголовка (`fix: … #12`); без issue номер не нужен. Root другого checkout
+содержит одну связанную задачу. Исключения release и правила ссылки — в
-не управляет этим repo.
+Engineering Workflow из AGENTS. Root другого checkout не управляет этим repo.
 Прямой push в `main`, force-push и перенос опубликованных тегов не входят в
-обычную работу. Перед release/hotfix прочитай местный README, раздел «Релизы».
+обычную работу. PR сливается squash или rebase-merge; merge-коммит не
+используется. `main` обновляется только fast-forward из `develop`, поэтому
+`origin/main` всегда предок `origin/develop`:
+`git merge-base --is-ancestor origin/main origin/develop`. Срочный fix —
+обычная ветка `fix/*` от `develop`; пути hotfix от `main` нет.
+Перед релизом прочитай местный README, раздел «Релизы».

.ai/conventions/storybook.md

@@ -1,5 +1,8 @@
 # Storybook
 
+Единый каталог включает stories приложения и `packages/*/src`; общие
+StateView/LoadingSkeleton и их stories принадлежат `packages/ui`.
+
 ## Когда нужна story
 
 - Shared UI/theme: показывай принятые visual roles и переиспользуемое поведение.
@@ -16,14 +19,16 @@
 Используй CSF, `Meta`/`StoryObj`, `satisfies Meta`, локальные fixtures и actions.
 Общие Mantine/theme/i18n/Dates providers уже есть в
 [preview](../../.storybook/preview.tsx); не создавай второй theme source.
-Stories не достигают application API, auth, VM и query providers даже транзитивно;
+Stories не достигают application API, auth и query providers даже транзитивно.
+Presentation VM с form-context/UI-only state допустима; data VM остаётся за
+этой границей, которую проверяет полный reachable graph;
 границу проверяет `deps:storybook`. Не добавляй MSW worker ради каталога.
 
 `play` через `storybook/test` нужен, когда interaction иллюстрирует собственный
 контракт: keyboard activation, доступность действия, local callback. Не повторяй
 RTL suite и не тестируй внутренности Mantine. Существующий
 [Button](../../src/shared/ui/Button.stories.tsx) показывает themed control
-без production wrapper; [LoadingSkeleton](../../src/shared/ui/LoadingSkeleton.stories.tsx)
+без production wrapper; [LoadingSkeleton](../../packages/ui/src/LoadingSkeleton/LoadingSkeleton.stories.tsx)
 — значимые busy states.
 
 `npm run typecheck`, `npm run deps:storybook`, `npm run build:catalog` проверяют

.ai/conventions/testing.md

@@ -45,9 +45,9 @@ Finance: loading/error/empty/loaded, cached snapshot при refetch failure, ret
 отсутствие старых данных после session/connection switch. ErrorBoundary: test-only
 throwing route, безопасная ссылка и reset после navigation.
 
-Примеры: [AuthForm test](../../src/features/auth/ui/AuthForm.test.tsx),
+Примеры: [AuthForm test](../../src/features/auth/ui/AuthForm/AuthForm.test.tsx),
 [client test](../../src/shared/api/client.test.ts),
-[usePortfolio test](../../src/entities/portfolio/api/usePortfolio.test.tsx).
+[resource lifecycle test](../../src/shared/api/resource-query.test.tsx).
 Не копируй fixtures/сценарии целиком, если задача затрагивает один исход.
 
 ## Команды

.ai/conventions/typescript-react.md

@@ -5,7 +5,8 @@
 - Сохраняй strict TS profile и `import type`. Для недоверенного значения используй
   `unknown` с narrowing; `any` не заменяет DTO/validation. Локальное исключение
   на нетипизированной boundary должно быть узким и объяснённым.
-- `enum` и `namespace` не используются: frontend имеет `erasableSyntaxOnly`.
+- Строковые `enum` используются для machine codes и protocol values.
+  `namespace` не используется; tooling сохраняет `erasableSyntaxOnly`.
   Для состояния с разными payload выбирай discriminated union; не добавляй
   необязательные поля, допускающие невозможные комбинации.
 - Named components — const-valued `FC<Props>`; named props находятся рядом или
@@ -14,7 +15,42 @@
   на основе `PropsWithChildren<{ … }>`; без props — `FC`.
 - Обычные exports — нижний named block; barrel делает прямой re-export.
   CSF сохраняет default meta и прямые story exports; configuration exceptions
-  заданы в [Biome](../../biome.json). Не распространяй их на application code.
+  заданы в [ESLint](../../eslint.config.mjs). Не распространяй их на application code.
+
+Тип значений формы выводится из её schema, когда input/output совпадают.
+Общие props определяются у одного owner; DTO и presentation model сохраняют
+собственные типы при смысловом отличии. Type re-export сохраняет public imports.
+
+## Читаемость: ESLint и review
+
+ESLint проверяет ограничение 80 символов (tab = 2), пустые строки между
+JSX siblings и вокруг многострочных declarations/control-flow/return, вынос
+функций и условных выражений из JSX props, отдельные Zod schema files,
+отсутствие SVG в приложении, optional trailing parameters и многострочные
+сложные union types. Generated artifacts не форматируй вручную.
+URL, строковые/template/regex literals и комментарии исключены из `max-len`;
+это исключение для содержимого, а не повод собирать длинные expressions.
+Однострочный JSX не требует обрамляющих скобок; многострочный — требует.
+`unicorn/no-null` отключён: API DTO, React refs и Mantine используют `null`.
+Сохраняй различие `null`/`undefined` из контракта вместо массовых suppressions.
+CSS и Markdown также держи в 80 колонках там, где это не ломает данные/ссылки.
+
+Review проверяет то, чего синтаксис не доказывает:
+
+Обоснованное config exception сопровождается причиной и явным ожиданием в
+existing lint tests, включая разрешённый и запрещённый примеры. Это позволяет
+настраивать профиль без случайного ослабления остальных правил.
+
+- Пустая строка отделяет смысловые шаги: inputs, вычисления, действие, результат.
+- Имена derived values описывают значение, например `projectedAmount`.
+- Тернарник остаётся коротким выбором двух значений. Mapping, несколько веток
+  и многострочное преобразование — отдельная функция с guard и `if/else`.
+- Union из object shapes оформляй несколькими строками; nullable scalar
+  `null | string` остаётся компактным. Для повторяемого shape используй named type.
+- Последний необязательный аргумент — `accountId?: string`. Required аргумент
+  перед следующим required параметром может сохранять `T | undefined`.
+- Helpers и действия размещай по [UI ownership](ui.md#container-vm-и-view);
+  перенос не меняет null/zero, validation, recovery, closures и hook ordering.
 
 ## Hooks и derived state
 
@@ -33,19 +69,23 @@ Container/VM/view и state owners — в [UI](ui.md).
 
 Общее правило ownership и символических значений —
 [Domain values](engineering.md#domain-values).
-Backend vocabulary бери из generated `paths`, не создавай ручную копию enum.
+Backend vocabulary бери из generated `paths`; generated artifacts вручную не меняй.
-Текущий `schema.d.ts` содержит только types: typed wire literals допустимы,
+Для открытых `string` полей допускается локальный enum известных значений,
-когда generator не предоставляет runtime values.
+используемых UI. Он не закрывает wire contract и сохраняет unknown fallback.
+Если generator предоставляет runtime enum, используй его.
 
-`ProblemDetailsDto.code` сейчас `string`. Не объявляй закрытый frontend error
+`ProblemDetailsDto.code` сейчас `string`. `ApiErrorCode` перечисляет известные UI коды, а не закрывает wire contract.
-enum и не превращай неизвестный code в известный через cast. Повторяющуюся
+`apiErrorCode` сохраняет произвольную строку; `isApiErrorCode` проверяет известное
+значение без cast и сохраняет fallback для неизвестного кода. Повторяющуюся
 обработку своди у ответственного owner; [errors](data.md#errors).
 
-`noMagicNumbers` в Biome — error; fixtures/tests/stories исключены только
+`@typescript-eslint/no-magic-numbers` — error; fixtures/tests/stories исключены
-из этого правила. Policy получает имя и единицы; подавление допустимо для
+из этой дополнительной проверки. Policy получает имя и единицы; подавление допустимо для
 incidental value с объяснением. Обычный UI-текст не превращай в constant:
 его owner — [i18n](ui.md#строки-и-валидация).
-Semantic magic strings и props profile требуют review.
+`no-restricted-syntax` запрещает inline machine codes и protocol values в production;
+`no-unsafe-enum-comparison` проверяет сравнения enum. Fixtures/stories сохраняют
+literal wire values. Новые vocabularies и props profile требуют review.
 
 ## Проверка
 

.ai/conventions/ui.md

@@ -11,10 +11,17 @@ Mantine component и общую тему. Для выпадающего выбо
 ограничения JSDOM решай в test setup, сохраняя production UI.
 Семантический HTML для структуры страницы остаётся уместным.
 
-Icons ищи у существующего owner (например,
+Icons импортируй из `@wealthledger/icons`; геометрия, SVG assets и animation
-[BankOperationIcon](../../src/entities/bank-card/ui/BankOperationIcon.tsx));
+lifecycle принадлежат этому пакету. Domain/category lookup возвращает параметры
-общая icon library сейчас не принята. Не добавляй пакет ради одного символа. Business/domain
+иконки из model сущности. Каждый SVG хранится цельным декларативным
-components живут у feature/entity/page, даже при повторном использовании.
+компонентом: не разбивай path-строки и не собирай геометрию в runtime.
+Русские category names из API — данные для нормализованного сопоставления,
+не ключи реестра иконок; неизвестные/переименованные категории имеют fallback.
+Известные названия банков принадлежат enum `BankName` в bank-card model;
+свободный ввод пользовательского названия остаётся строкой.
+SVG декоративны по умолчанию; доступное имя action
+принадлежит кнопке. Meaningful icon получает `aria-hidden={false}`, `role="img"`
+и доступное имя. Приложение и Storybook подключают CSS пакета.
 
 Wrapper нужен для проектной ответственности, а не ради нового имени
 для Button. Локальный CSS module принадлежит component; общий token вводи для
@@ -48,19 +55,76 @@ retry callbacks, domain grouping и derived presentation data. View получа
 | `Component.types.ts` | Переиспользуемые props/local types, когда отдельный owner полезен |
 | `Component.module.css` | Локальные стили |
 
-Во view нет data/auth/router/navigation/VM hooks и вычислений по domain collection.
+View получает готовые данные и именованные действия. Container вызывает VM;
-Допустимы `useTranslation`, form-context hooks, UI-only state (например failed
+VM владеет запросами, формой, состоянием, обработчиками и derived values.
-image fallback) и formatter одного переданного значения. Группировка/доли
+Во view нет data/auth/router/navigation hooks и domain grouping. Data VM
-коллекции готовятся в VM. Перенос fetch во view ради меньшего container нарушает границу.
+вызывает container; presentation hook не должен скрывать fetching во view.
+Presentation VM для form-context/UI-only state может использоваться автономно
+в каталоге: её граф зависимостей не достигает application data/API.
+`useTranslation` и декларативный вывод коллекции допустимы во view.
 
-Отдельный state/section с самостоятельной responsibility выноси в flat
+ESLint ограничивает прямые data/auth/router hook imports в `*.view.tsx`;
-`components/*.view.tsx`. Небольшой tightly-coupled renderer оставляй рядом.
+type imports, error helpers, router components и form context разрешены.
-Не создавай folder/barrel/test/CSS для каждого view и не дроби по line count.
+Транзитивный fetching через local presentation hook проверяется review;
-Пример: [AccountIncomePage](../../src/pages/account-income/ui/AccountIncomePage.tsx)
+Storybook дополнительно проверяет reachable graph. Новое исключение должно
-и [его VM](../../src/pages/account-income/ui/AccountIncomePage.vm.ts).
+сохранять presentation-only responsibility.
+
+JSX props получают ссылки на функции, включая `onClick`, render props,
+`dateParser` и callbacks внутри объектов props. Для React Hook Form предпочитай
+`useController` в VM вместо inline `Controller.render`. Значение prop с условием
+сначала получает предметное имя: `projectedAmount`, `archiveActionLabel`.
+Проверяй narrowing при переносе: выражение не должно читать отсутствующие данные
+до ветки, которая раньше защищала доступ; обработчик сохраняет актуальный snapshot.
+
+Внутри компонента нет именованных helpers. Чистые функции форматирования и
+адаптации UI inputs выноси в `shared/lib`, передавая явные аргументы. Domain
+преобразование остаётся в model своего owner; shared не импортирует entities/pages.
+Closure над состоянием, mutations и refs является действием VM, а не shared helper.
+
+VM собирает связные предметные hooks, когда внутри смешиваются независимые
+сценарии. Например, `useRefundPurchase` владеет выбором исходной покупки,
+её загрузкой и пагинацией. Общий адаптер `bankDateField` обслуживает поля даты;
+простое подключение одного controller остаётся в VM формы.
+Не группируй несвязанные функции только по префиксу `on*` и не создавай
+passthrough hook над одним вызовом ради формального дробления.
+
+Render-helper замени самостоятельным presentation component у того же owner.
+
+Отдельный state/section с самостоятельной responsibility выноси в
+`components/` своего component. Небольшой tightly-coupled renderer оставляй
+рядом; размер файла сам по себе не требует разделения.
+Пример: [AccountIncomePage](../../src/pages/account-income/ui/AccountIncomePage/AccountIncomePage.tsx)
+и [его VM](../../src/pages/account-income/ui/AccountIncomePage/AccountIncomePage.vm.ts).
+
+## Размещение файлов компонента
+
+Правило действует в `src` и `packages`: компонент с сопутствующими файлами
+(view, VM, types, CSS, tests, stories) размещай в папке `Component/`.
+Сохраняй полные имена файлов: `Component.tsx`, `Component.view.tsx`,
+`Component.test.tsx`. Создавай только нужные файлы; одиночный компонент
+оставляй непосредственно в `ui`, `components` или source-каталоге пакета.
+
+Внутренние части принадлежат папке родителя; для набора state/section views
+используй её `components/`. Внутри него действует то же правило: отдельная
+папка объединяет комплект файлов, одиночный view остаётся файлом.
+Стили и хуки нескольких соседних компонентов остаются у ближайшего общего
+владельца; не копируй их и не прячь внутрь одного потребителя.
+
+Папка компонента не создаёт новую FSD-границу. Публичные exports остаются в
+существующем `index.ts` slice/segment или entry пакета; внутри используй
+прямые относительные imports без дополнительных barrels на каждый компонент.
+При переносе обновляй imports, ссылки документации и проверки, зависящие от пути.
+
+Пример: [BankCardForm](../../src/entities/bank-card/ui/BankCardForm/BankCardForm.tsx)
+лежит рядом со своим view, тестом и story. Формы используют Mantine
+`Fieldset variant="unstyled"` для групповой блокировки полей без локального CSS.
 
 ## Формы
 
+Схемы Zod объявляй в `*.schema.ts`, включая `.refine`/`.superRefine`.
+Зависимая от текущих данных схема — фабрика с явными inputs в том же файле;
+VM вызывает фабрику. Сохраняй актуальность данных и deferred validation messages.
+
 Используй `react-hook-form`, `zodResolver`, `FormProvider`. Container/VM создаёт
 form state, view получает `onSubmit`/`disabled`, fields используют `useFormContext`.
 Во время submit блокируй все действия формы. Zod errors показывай у поля;
@@ -95,7 +159,7 @@ Types, props, hooks и memoization — в [TypeScript/React](typescript-react.md
 Продуктовый текст хранится в `src/shared/i18n/locales/ru.ts`, читается через
 `useTranslation()`. В Zod используй `validationMessage(key)` из i18n/zod, без
 пользовательских literal messages. Это mandatory semantic review: общего запрета
-непереведённых JSX-строк в Biome/TypeScript нет. Synthetic story fixtures и
+непереведённых JSX-строк в ESLint/TypeScript нет. Synthetic story fixtures и
 описания историй допустимы; они не заменяют продуктовую локализацию.
 
 ## Проверка
@@ -107,10 +171,29 @@ loading/error/empty/loaded и recovery по применимости. [Storybook
 
 ## Визуальная основа
 
-Общая тема живёт в `src/shared/theme`: `tokens.json` задаёт переносимые значения,
+Private workspace `packages/tokens` владеет переносимыми значениями
-`theme.ts` адаптирует их к Mantine. Используй public API темы и её semantic roles,
+`tokens.json`; `packages/ui/src/theme.ts` читает export пакета
-без отдельной палитры в page/component. Поддерживается светлая схема.
+`@wealthledger/tokens/tokens.json` и адаптирует его к Mantine. Используй
+`@wealthledger/ui/theme` и его semantic roles; runtime подключает
+`@wealthledger/ui/styles.css` после Mantine CSS. Providers остаются у runtime.
+Палитра page/component следует этим semantic roles. Поддерживается светлая схема.
 Цвет дополняет подпись или знак; проверяй контраст конкретной пары text/background.
 Warning не используй для мелкого текста на белом. Деньги сохраняют валюту, знак
 и различие между нулём и неизвестной суммой. Общие состояния демонстрирует
 Storybook; presentation stories используют synthetic data без application API.
+
+EntryCard, StateView и LoadingSkeleton принадлежат `packages/ui`; публичный import —
+`@wealthledger/ui`. Переводы, retry и формы skeleton остаются у callers.
+Compatibility re-exports удалены; callers используют public export пакета.
+
+## Modal animation
+
+BankCardForm, OperationForm, DeleteOperation и CategoryManager монтируют Modal
+с `opened=true`: Mantine Transition начинает в состоянии `entered`.
+CSS `modal-appear`/`modal-backdrop-appear` в `packages/ui/src/styles.css`
+обеспечивает появление при mount (220ms, только no-preference). Mantine theme
+владеет exit transition (180ms), overlay blur и completion callback;
+`onExitTransitionEnd` позволяет дождаться закрытия перед unmount и вернуть фокус.
+Удаление CSS без изменения mount lifecycle убирает вступительную анимацию.
+TbankConnection Modal использует toggle `opened`; вывод о разделении фаз
+банковских форм на этот сценарий автоматически не распространяется.

.dockerignore

@@ -13,3 +13,33 @@
 !public/**
 !docker/
 !docker/**
+!packages/
+!packages/tokens/
+!packages/tokens/package.json
+!packages/tokens/tokens.json
+!packages/ui/
+!packages/ui/package.json
+!packages/ui/vite.config.ts
+!packages/ui/tsconfig.json
+!packages/ui/src/
+!packages/ui/src/**
+!packages/icons/
+!packages/icons/package.json
+!packages/icons/tsconfig.json
+!packages/icons/vite.config.ts
+!packages/icons/src/
+!packages/icons/src/index.ts
+!packages/icons/src/types.ts
+!packages/icons/src/svg/
+!packages/icons/src/svg/AddIcon.tsx
+!packages/icons/src/svg/EditIcon.tsx
+!packages/icons/src/svg/DeleteIcon.tsx
+
+# Keep local dependencies, outputs and secrets out of allowed source trees.
+**/node_modules
+**/dist
+**/coverage
+**/storybook-static
+**/.env*
+**/*.pem
+**/*.key

.gitea/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,12 @@
+---
+name: Bug Report
+about: Неверное поведение
+---
+## Проблема и шаги воспроизведения
+
+## Факт / ожидание
+
+## Acceptance Criteria
+- [ ]
+
+## Окружение / ссылки (если применимо)

.gitea/ISSUE_TEMPLATE/engineering.md

@@ -0,0 +1,10 @@
+---
+name: Engineering Task
+about: CI, тесты, документация, процесс и прочее
+---
+## Контекст и результат
+
+## Scope / связанные Issues (если есть)
+
+## Acceptance Criteria
+- [ ]

.gitea/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,12 @@
+---
+name: Feature Request
+about: Новое наблюдаемое поведение
+---
+## Зачем и какой результат
+
+## Ожидаемое поведение
+
+## Acceptance Criteria
+- [ ]
+
+## Зависимости / связанные Issues (если есть)

.gitea/ISSUE_TEMPLATE/refactor.md

@@ -0,0 +1,12 @@
+---
+name: Refactoring / Technical Debt
+about: Улучшение без нового поведения
+---
+## Проблема и результат
+
+## Сохраняемые инварианты / границы
+
+## Acceptance Criteria
+- [ ]
+
+## Зависимости / ссылки (если есть)

.gitea/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,11 @@
+## Summary
+
+## Linked Issue
+Refs
+
+## Changes
+
+## Verification
+- Команда / результат / ограничения:
+
+## Breaking Changes (если есть)

.gitea/workflows/image.yml

@@ -12,7 +12,7 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     env:
-      IMAGE: git.personal.ksv741.ru/wealthledger/frontend
+      IMAGE: nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend
       RELEASE_TAG: ${{ gitea.ref_name }}
       REVISION: ${{ gitea.sha }}
       DOCKER_CONFIG: ${{ runner.temp }}/wealthledger-frontend-docker
@@ -30,30 +30,34 @@ jobs:
       - run: npm ci
         env:
           HUSKY: '0'
+      - name: Install Chromium and system dependencies
+        run: npx --no-install playwright install --with-deps chromium
       - run: npm run verify
         env:
           KNIP_DISABLE_RAW_TRANSFER: '1'
-      - name: Login with dedicated package writer
+      - name: Login with dedicated Nexus writer
         env:
-          REGISTRY_USERNAME: ${{ secrets.REGISTRY_USERNAME }}
+          REGISTRY_USERNAME: ${{ secrets.NEXUS_USERNAME }}
-          REGISTRY_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
+          REGISTRY_TOKEN: ${{ secrets.NEXUS_PASSWORD }}
         run: |
           test -n "$REGISTRY_USERNAME" && test -n "$REGISTRY_TOKEN"
           install -d -m 700 "$DOCKER_CONFIG"
-          printf '%s' "$REGISTRY_TOKEN" | docker login git.personal.ksv741.ru --username "$REGISTRY_USERNAME" --password-stdin
+          printf '%s' "$REGISTRY_TOKEN" | docker login nexus.personal.ksv741.ru --username "$REGISTRY_USERNAME" --password-stdin
       - name: Publish immutable release tag
         run: |
           VERSION="${RELEASE_TAG#v}"
           if docker manifest inspect "$IMAGE:$VERSION" >/dev/null 2>manifest-error.log; then
-            echo 'Refusing to overwrite an existing release tag'; exit 1
+            DIGEST="$(docker buildx imagetools inspect "$IMAGE:$VERSION" --format '{{.Manifest.Digest}}')"
+          else
+            if ! grep -Eq 'manifest unknown|no such manifest' manifest-error.log; then
+              echo 'Cannot prove tag absence; refusing publication'; exit 1
+            fi
+            docker buildx build --target production --build-arg VERSION="$VERSION" --build-arg REVISION="$REVISION" --tag "$IMAGE:$VERSION" --metadata-file image-metadata.json --push .
+            DIGEST="$(node --input-type=commonjs -p 'require("./image-metadata.json")["containerimage.digest"]')"
           fi
-          if ! grep -Eq 'manifest unknown|no such manifest' manifest-error.log; then
-            echo 'Cannot prove tag absence; refusing publication'; exit 1
-          fi
-          docker buildx build --target production --build-arg VERSION="$VERSION" --build-arg REVISION="$REVISION" --tag "$IMAGE:$VERSION" --metadata-file image-metadata.json --push .
-          DIGEST="$(node --input-type=commonjs -p 'require("./image-metadata.json")["containerimage.digest"]')"
           docker pull "$IMAGE@$DIGEST"
           test "$(docker image inspect "$IMAGE@$DIGEST" --format '{{index .Config.Labels "org.opencontainers.image.revision"}}')" = "$REVISION"
+          test "$(docker image inspect "$IMAGE@$DIGEST" --format '{{index .Config.Labels "org.opencontainers.image.version"}}')" = "$VERSION"
           docker run --rm --entrypoint sh "$IMAGE@$DIGEST" -c 'test -s /usr/share/nginx/html/index.html && nginx -t && nginx && wget -q -O /dev/null http://127.0.0.1:8080/'
           printf 'Frontend image: %s@%s\n' "$IMAGE" "$DIGEST"
       - name: Remove registry session

.gitea/workflows/pr-title.yml

@@ -1,11 +1,19 @@
-name: Conventional commits
+name: Frontend verify
 
+# Metadata-only: refreshes only the `commits` context after a PR title edit.
+# Same workflow name keeps the required context; `security` and `verify`
+# statuses of the head revision stay untouched (no skipped overwrite).
 on:
   pull_request:
-    types: [opened, synchronize, reopened, edited]
+    types: [edited]
+
+concurrency:
+  group: frontend-pr-title-${{ gitea.event.pull_request.number }}
+  cancel-in-progress: true
 
 jobs:
   commits:
+    timeout-minutes: 15
     runs-on: ubuntu-latest
     steps:
       - uses: https://github.com/actions/checkout@v4

.gitea/workflows/security.yml

@@ -1,33 +0,0 @@
-name: Frontend security
-
-on:
-  push:
-    branches:
-      - '**'
-  pull_request:
-  schedule:
-    - cron: '17 5 * * *'
-
-jobs:
-  security:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: https://github.com/actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Record checked revision
-        run: git rev-parse HEAD
-      - name: Scan history with Gitleaks 8.30.1
-        run: |
-          curl --fail --location --silent --show-error https://github.com/gitleaks/gitleaks/releases/download/v8.30.1/gitleaks_8.30.1_linux_x64.tar.gz -o /tmp/gitleaks.tar.gz
-          echo '551f6fc83ea457d62a0d98237cbad105af8d557003051f41f3e7ca7b3f2470eb  /tmp/gitleaks.tar.gz' | sha256sum --check
-          mkdir -p /tmp/gitleaks-bin
-          tar -xzf /tmp/gitleaks.tar.gz -C /tmp/gitleaks-bin gitleaks
-          /tmp/gitleaks-bin/gitleaks git --log-opts=--all --redact=100 --no-banner
-      - uses: https://github.com/actions/setup-node@v4
-        with:
-          node-version-file: .nvmrc
-      - name: Verify pre-commit secret blocking and redaction
-        run: PATH=/tmp/gitleaks-bin:$PATH node --test scripts/test-pre-commit.mjs
-      - name: Audit runtime and development dependencies
-        run: npm audit --include=dev --audit-level=low

.gitea/workflows/verify.yml

@@ -2,15 +2,83 @@ name: Frontend verify
 
 on:
   push:
-    branches:
+    branches: [develop, main]
-      - '**'
   pull_request:
+    types: [opened, synchronize, reopened]
+  schedule:
+    - cron: '17 5 * * *'
+
+# Gitea >= 1.26. A new revision supersedes only the same PR/branch/event.
+concurrency:
+  group: frontend-verify-${{ gitea.event_name }}-${{ gitea.event.pull_request.number || gitea.ref }}
+  cancel-in-progress: true
 
 jobs:
-  verify:
+  commits:
+    if: gitea.event_name == 'pull_request'
+    timeout-minutes: 15
     runs-on: ubuntu-latest
     steps:
       - uses: https://github.com/actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+      - uses: https://github.com/actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+      - run: npm ci --ignore-scripts
+      - name: Check PR title and commits
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: |
+          printf '%s\n' "$PR_TITLE" | npm run commitlint -- --strict
+          if [[ "$PR_TITLE" =~ ^chore\(release\):\ [0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            npm run commitlint -- --strict --from "$HEAD_SHA^" --to "$HEAD_SHA"
+          else
+            npm run commitlint -- --strict --from "$BASE_SHA" --to "$HEAD_SHA"
+          fi
+
+  security:
+    needs: commits
+    if: >-
+      !cancelled() &&
+      (needs.commits.result == 'success' || needs.commits.result == 'skipped')
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    steps:
+      - uses: https://github.com/actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Record checked revision
+        run: git rev-parse HEAD
+      - name: Scan history with Gitleaks 8.30.1
+        run: |
+          curl --fail --location --silent --show-error https://github.com/gitleaks/gitleaks/releases/download/v8.30.1/gitleaks_8.30.1_linux_x64.tar.gz -o /tmp/gitleaks.tar.gz
+          echo '551f6fc83ea457d62a0d98237cbad105af8d557003051f41f3e7ca7b3f2470eb  /tmp/gitleaks.tar.gz' | sha256sum --check
+          mkdir -p /tmp/gitleaks-bin
+          tar -xzf /tmp/gitleaks.tar.gz -C /tmp/gitleaks-bin gitleaks
+          /tmp/gitleaks-bin/gitleaks git --log-opts=--all --redact=100 --no-banner
+      - uses: https://github.com/actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+      - name: Verify pre-commit secret blocking and redaction
+        run: PATH=/tmp/gitleaks-bin:$PATH node --test scripts/test-pre-commit.mjs
+      - name: Audit runtime and development dependencies
+        run: npm audit --include=dev --audit-level=low
+
+  verify:
+    needs: [commits, security]
+    if: >-
+      !cancelled() && needs.security.result == 'success' &&
+      gitea.event_name != 'schedule'
+    timeout-minutes: 45
+    runs-on: ubuntu-latest
+    steps:
+      - uses: https://github.com/actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Record checked revision
         run: git rev-parse HEAD
       - uses: https://github.com/actions/setup-node@v4
@@ -19,8 +87,18 @@ jobs:
       - run: npm ci
         env:
           HUSKY: '0'
+      - name: Install Chromium and system dependencies
+        run: npx --no-install playwright install --with-deps chromium
       - name: Run all frontend gates
         run: npm run verify
         env:
           # OXC raw transfer allocates a ~6 GiB buffer; use the standard parser in CI.
           KNIP_DISABLE_RAW_TRANSFER: '1'
+      - name: Analyze develop with SonarQube
+        if: gitea.event_name == 'push' && gitea.ref == 'refs/heads/develop'
+        # v2.3.0: Docker-based scanner for the SonarQube 9.9 server.
+        uses: https://github.com/SonarSource/sonarqube-scan-action@aecaf43ae57e412bd97d70ef9ce6076e672fe0a9
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+        with:
+          args: -Dsonar.qualitygate.wait=true

.gitignore

@@ -12,6 +12,8 @@ dist
 storybook-static
 dist-ssr
 coverage
+.vitest
+.scannerwork
 *.local
 
 # Local runtime configuration

.husky/pre-commit

@@ -1,3 +1,6 @@
 gitleaks git --pre-commit --staged --redact=100 --no-banner || exit $?
-npx lint-staged
+if [ ! -x node_modules/.bin/lint-staged ]; then
-npm run deps
+	echo "lint-staged is not installed; run npm ci" >&2
+	exit 1
+fi
+node_modules/.bin/lint-staged

.storybook/dependency-cruiser.cjs

@@ -5,11 +5,16 @@ module.exports = {
 	forbidden: [
 		...base.forbidden,
 		{
+			from: { path: "[.]stories[.]tsx$|^[.]storybook/preview[.]tsx$" },
 			name: "stories-must-not-reach-application-data",
 			severity: "error",
-			from: { path: "\\.stories\\.tsx$|^\\.storybook/preview\\.tsx$" },
 			to: {
-				path: "^src/(shared/api|features/auth|app/routes|app/ui)/|^src/(entities|features)/[^/]+/api/|\\.vm\\.ts$|^src/pages/[^/]+/ui/[^/]+Page\\.tsx$|node_modules/(@tanstack/react-query|openapi-fetch|openapi-react-query)/",
+				path: [
+					"^src/(shared/api|features/auth|app/routes|app/ui)/",
+					"^src/(entities|features)/[^/]+/api/",
+					"^src/pages/[^/]+/ui/.*Page[.]tsx$",
+					"node_modules/(@tanstack/react-query|openapi-fetch|openapi-react-query)/",
+				],
 				reachable: true,
 			},
 		},

.storybook/main.ts

@@ -1,10 +1,10 @@
 import type { StorybookConfig } from "@storybook/react-vite";
 
 const config: StorybookConfig = {
-	stories: ["../src/**/*.stories.tsx"],
 	addons: ["@storybook/addon-docs"],
-	framework: "@storybook/react-vite",
 	core: { disableTelemetry: true },
+	framework: "@storybook/react-vite",
+	stories: ["../src/**/*.stories.tsx", "../packages/*/src/**/*.stories.tsx"],
 };
 
 export default config;

.storybook/preview.tsx

@@ -1,38 +1,34 @@
-import "@mantine/core/styles.css";
 import "@mantine/charts/styles.css";
+import "@mantine/core/styles.css";
 import "@mantine/dates/styles.css";
+import "@wealthledger/icons/styles.css";
+import "@wealthledger/ui/styles.css";
 import "dayjs/locale/ru";
+
+import type { Preview } from "@storybook/react-vite";
+
 import "../src/shared/i18n";
+
 import { MantineProvider } from "@mantine/core";
 import { DatesProvider } from "@mantine/dates";
-import type { Preview } from "@storybook/react-vite";
+import { cssVariablesResolver, theme } from "@wealthledger/ui/theme";
-import { cssVariablesResolver, theme } from "@/shared/theme";
 
 const colorSchemeManager = {
+	clear: () => {},
 	get: () => "light" as const,
 	set: () => {},
-	clear: () => {},
 	subscribe: () => {},
 	unsubscribe: () => {},
 };
 
 const preview: Preview = {
-	parameters: {
-		layout: "padded",
-		options: {
-			storySort: {
-				order: ["Design System", ["Foundations", "Components"], "Product"],
-			},
-		},
-		controls: { expanded: true },
-	},
 	decorators: [
-		(Story) => (
+		Story => (
 			<MantineProvider
-				cssVariablesResolver={cssVariablesResolver}
-				theme={theme}
-				forceColorScheme="light"
 				colorSchemeManager={colorSchemeManager}
+				cssVariablesResolver={cssVariablesResolver}
+				forceColorScheme="light"
+				theme={theme}
 			>
 				<DatesProvider settings={{ locale: "ru" }}>
 					<Story />
@@ -40,6 +36,15 @@ const preview: Preview = {
 			</MantineProvider>
 		),
 	],
+	parameters: {
+		controls: { expanded: true },
+		layout: "padded",
+		options: {
+			storySort: {
+				order: ["Design System", ["Foundations", "Components"], "Product"],
+			},
+		},
+	},
 };
 
 export default preview;

AGENTS.md

@@ -4,6 +4,9 @@
 только его файлы и предоставленные публичные контракты. Перед работой прочитай
 [порядок работы](.ai/conventions/engineering.md#граница-и-порядок-работы), затем
 объединяй triggers задачи и путей; читай активированные темы до решения.
+До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение
+допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/03b3b59e6ff2ba391f9dfc42a039a96d0d84c1c9/.ai/conventions/engineering-workflow.md)
+(main#28; после merge — актуальная версия `develop`).
 
 | Решение / сигнал | Читать |
 | --- | --- |
@@ -34,4 +37,4 @@ Testing и без production diff. Перед завершением повто
 | Money, account/position/income | Entity types, API snapshot, formatters и tests соответствующего slice |
 | Theme/tokens, UI-каталог | [UI](.ai/conventions/ui.md), [Storybook](README.md#ui-каталог-storybook) |
 | Поведение области | Source и tests её page/entity/feature; неясное ожидание уточни до изменения |
-| Versions/scripts/check scope | Manifest/lockfile, Biome/TypeScript/dependency configs |
+| Versions/scripts/check scope | Manifest/lockfile, ESLint/TypeScript/dependency configs |

CHANGELOG.md

@@ -1,5 +1,185 @@
 # Changelog
 
+## [1.2.0](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v1.1.0...v1.2.0) (2026-10-18)
+
+### Features
+
+* unify income payment cards and remove comparisons (WealthLedger/main[#33](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/33)) ([#74](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/74)) ([43b0f55](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/43b0f5574a79e26de0abae35de16d8aa8700f718))
+
+### Bug Fixes
+
+* align password validation with backend ASCII policy (WealthLedger/backend[#60](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/60)) ([#89](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/89)) ([ebe9268](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/ebe92684a74b4e2617b04ef00d9406b8a0f674ea))
+* **auth,bank:** guard switch-auth nav and surface banking retry ([e38ecd8](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/e38ecd87d6f69968bb56e6035ceeb6cfda208a3f)), closes [#56](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/56) [#57](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/57)
+* **bank:** break BankFeedback's shared/api edge for stories ([#80](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/80)) ([2336804](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/233680448f97dc3ec57d7665ec14c68ac92410e5))
+* deliver screener OpenAPI constraints (WealthLedger/backend[#70](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/70)) ([#85](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/85)) ([ed63ada](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/ed63adad94f5d0e20f7d0d1446a235f953d10ec2))
+* **events:** seven-date default period and picker from today (WealthLedger/frontend[#63](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/63)) ([612ab62](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/612ab6250979bf8d9b57f4feb6e1476ed3d759e4))
+* respect query eligibility in screen sync (WealthLedger/frontend[#54](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/54)) ([f295dea](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f295dea6a6a33c597c753b52aff629d5382c963a))
+
+### Refactoring
+
+* derive payment-system options from schema tuple ([#58](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/58)) ([#75](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/75)) ([e67c47b](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/e67c47b102329877eb5d9c9d8bb4ea7c0bc70883))
+
+### Build
+
+* use native openapi-typescript --check ([#60](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/60)) ([#77](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/77)) ([df05c8c](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/df05c8c7dbb5d6816fb95d54ca43cd0d83eecd48))
+
+### CI
+
+* keep pre-commit proportionate and avoid tool downloads (WealthLedger/frontend[#62](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/62)) ([#86](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/86)) ([d409a29](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/d409a297e5f9ae5658d4efa958bda9a012a859a1))
+* recheck PR title on edited without the full pipeline (WealthLedger/frontend[#64](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/64)) ([bc28973](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/bc28973d1ad5e15bfbc2e5b73b00ba63449933db))
+
+### Tests
+
+* await client settlement in late-response cases (WealthLedger/frontend[#61](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/61)) ([#81](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/81)) ([f3725c2](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f3725c202bd8cef4ba711085df82a921a2da6b7d))
+* cover non-retry of INVALID_TBANK_TOKEN reads (WealthLedger/backend[#59](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/59)) ([#90](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/90)) ([5134106](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/513410669680480a1f68f5720744cc85e43c8286))
+* cover null events and income envelopes on account pages ([#72](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/72)) ([#79](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/79)) ([e5f8bbe](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/e5f8bbe33cd438f432281818c5276abe9a425646))
+* cover null resource envelopes for account pages ([#70](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/70)) ([#71](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/71)) ([#78](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/78)) ([f7f53ff](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f7f53ff8e4de3c1d06fac6063974ff9667145ed6))
+
+### Maintenance
+
+* adopt linear git model in frontend docs ([#91](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/91)) ([eefdde2](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/eefdde29f8da269581e90bd797078e10a39e472f))
+
+## [1.1.0](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v1.0.0...v1.1.0) (2026-10-12)
+
+### Features
+
+* add stock screener ([a84411d](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/a84411df39dc131290e9f5b5d9313fed17cc629a))
+* align investment client with hourly sync ([432cca2](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/432cca299f3a9a9e45b2697527369ee95f2d0adc))
+* render hourly investment states ([3c226f8](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/3c226f8c29efceccb75af0d6424639a757534f39))
+
+### Bug Fixes
+
+* align frontend workflow rules (WealthLedger/main[#27](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/27)) ([c315f80](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/c315f80b1b07ae0888366512ec157b8e29c81d62))
+* preserve latest stock screener result ([cec9c63](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/cec9c6348a389f16f272dac5533aebc9d12ceae8))
+* show bank summary totals ([20b2cdf](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/20b2cdfd432f8b01e447f68657cf5c685a297f1e))
+
+### Documentation
+
+* clarify frontend verification policy ([cac4351](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/cac4351bc4abf2cec7c5b6611a74d87bf4ec2f70))
+* pin frontend workflow reference (WealthLedger/main[#27](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/27)) ([0d747cc](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/0d747cc93ee08c337cf300c0367612708f45dfb9))
+
+### CI
+
+* skip checks on PR metadata edits ([c882120](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/c8821200ce699dab1ce65360d1968d5877a2e78b))
+
+### Maintenance
+
+* align frontend engineering workflow (WealthLedger/main[#27](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/27)) ([617edfd](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/617edfd489a6a84bb33b57386eca4eb54661f4f0))
+
+## [1.0.0](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.4.0...v1.0.0) (2026-10-07)
+
+### ⚠ BREAKING CHANGES
+
+* drop investment stateVersion/progress/resources
+  from the client contract and use data/metadata readiness instead of
+  rewritten query status. Cross-tab auth may require re-login.
+
+### Features
+
+* add quiet reading with rare confirmations ([5b30bb8](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/5b30bb802a4ec43c036066f9a7e178f37e747a0b))
+* default journal period to last 7 days ([0ea8d7b](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/0ea8d7b62d50a4b7c92e9a9934aead6246ac97f9))
+
+### Bug Fixes
+
+* **deps:** remove npm dependency on Nexus ([c096fc7](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/c096fc70ef442474c9b7766fdf5772b645166b92))
+* **deps:** resolve npm audit advisories ([f873db7](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f873db7b027b6dee0c7382b4bd3df5198c7a4198))
+* **deps:** resolve npm audit advisories ([10baefd](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/10baefda790e7fb491c893724ddc4da7992103f0))
+* resolve frontend audit findings ([f6db28d](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f6db28defa51bd9d8fe932ceae4c3c720aba7eb3))
+* sort stock and bond events by payment date ([f5f4447](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f5f4447d60661aa92c80b50a16e8cb194dfa161f))
+
+### Performance
+
+* **tbank-connection:** poll screen sync every five seconds ([74f8a72](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/74f8a72ed55af2348fa3668f57312f4fdfc1e8a8)), references [WealthLedger/specs#21](https://git.personal.ksv741.ru/WealthLedger/specs/issues/21)
+
+### Refactoring
+
+* address frontend review feedback ([a4046db](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/a4046dbe87bd7dc949df32da3b6aaf174e6f5e8f))
+* clarify frontend model ownership ([0865b35](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/0865b35f93865b4052181d918cee80c995312930))
+* clarify frontend module ownership ([f9f0f69](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/f9f0f6921e86f6c81510373c680b136e4580f386))
+* encapsulate instrument chart data ([64fe902](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/64fe902192b60a72440635f5610ebe02cf8543f8))
+* enforce enum machine codes [#18](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/18) ([5b69003](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/5b6900351612b6ba34c694fc99612733e7901c79))
+* enforce frontend view model boundaries ([ca0ad4f](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/ca0ad4f824a47fa47e32d4717e27b15c8a985f7d))
+* move PortfolioStructure to widgets layer ([c25f6bd](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/c25f6bd85b88c4c7acb2f5ae6fc013aec77005b2))
+* remove redundant page view models ([fb3a5a6](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/fb3a5a6eaa0223a15ea2c9f585a06459371f0a25))
+* share instrument search presentation ([32a7786](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/32a77860c8eaea4a59a26e55b2d66976fd8f9484))
+* share source sync status presentation ([0bc8bc3](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/0bc8bc36b7263b7f0120a08df840b290b40d8116))
+* simplify auth and instrument pages ([b404c18](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/b404c1802a74f5f369173fdfcb086a3d5760e35a))
+* simplify calendar and form state ([94adbaf](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/94adbafa344b23d7f95c31db975d99d990bfcb8b))
+* simplify errors and focus tests ([7e976c3](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/7e976c330c54715018eda4bff0764c5d4de9c8b0))
+* simplify finance view models ([2844b22](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/2844b22dbace41a02c1b5a07b3801e84c66b3528))
+* simplify frontend state and mutation boundaries ([a7537da](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/a7537da34452ab1a15138ab0c1cd93d53d06c517))
+* simplify query and session ownership ([6999707](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/69997075e569da3edd43e242ef36f09311262412))
+* simplify resource queries and layout tests ([c1b0873](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/c1b08735e3a45d565c3836ae37ad76186bf48f26))
+* tighten types and reuse instrument UI ([7c28a42](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/7c28a423dd8a3cc4a5bdcb49b8de7018979df413))
+* unify bank form types and actions ([ff67a76](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/ff67a768addc0c4ba55247f5e2d9d5d5d5aec734))
+
+### CI
+
+* reduce duplicate actions and serialize checks ([95fdc87](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/95fdc8759e20f9baa4ac3d00e703752c79010e01))
+
+### Tests
+
+* remove redundant frontend checks ([320ea59](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/320ea5922a70ab81ce4f05c3c90eb7b6a664fa39))
+
+### Styles
+
+* pin ternary operator formatting [#18](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/18) ([12c3b72](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/12c3b72bfb32dff5f1ffdb36519c90f7ea852488))
+
+### Maintenance
+
+* add typed ESLint checks [#18](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/18) ([5763010](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/57630102e4bcc6b555dd546ba373a14a88256eed))
+* finish frontend ESLint migration [#18](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/18) ([72d7835](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/72d7835227340e349d99f57db134a635f276f6e9))
+* guard presentation data boundaries ([6a89b08](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/6a89b08ee571562fea349801169c40f1f993e9b9))
+* guard unsafe DOM HTML with ESLint [#18](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/18) ([061ec70](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/061ec708c651029cd7d61d22319d11e7ac9f074e))
+* remove unused exports ([fcb938b](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/fcb938b5a29fc82f00bbaa8b2ee776ca57dad010))
+
+## [0.4.0](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.3.0...v0.4.0) (2026-09-26)
+
+### Features
+
+* show persisted investment data and sync state ([4e5f564](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/4e5f564fa1d583013fb3e7febdb3baa9737446b4))
+
+### Bug Fixes
+
+* **api:** update validation and conflict response contract ([db184c8](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/db184c8caec01609e8a3df3b16097ce634e5eff0))
+* **auth:** isolate session races and financial caches ([a209d71](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/a209d715892862bb6d48084df0c84a10b8d56bf1))
+* **ci:** resume verification of immutable release images ([6a87379](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/6a87379813ba1d4002779b23b2a65446b4d10258))
+* **ui:** improve financial text contrast ([c86be7b](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/c86be7bf73d0141e0606d259ada6453c0d8e3dec))
+
+### Refactoring
+
+* colocate frontend component files ([b987fd8](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/b987fd8e780963dfe1dde0c714232697a52e0475))
+* establish local frontend workspace boundaries ([85fcfe3](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/85fcfe3d073f80e759dafb14281c9462c1d7410d))
+
+## [0.3.0](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.2.3...v0.3.0) (2026-09-20)
+
+### Features
+
+* add installable PWA [#30](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/30) ([bb30935](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/bb30935f73bfcbb77c10663cf6c683d8f0caca85))
+
+## [0.2.3](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.2.2...v0.2.3) (2026-09-19)
+
+### Bug Fixes
+
+* correct Nexus routing and SonarQube host ([9171b9f](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/9171b9f5c8e0b694a2310e5a200fa2f8d3f28a61))
+
+## [0.2.2](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.2.1...v0.2.2) (2026-09-19)
+
+### Bug Fixes
+
+* update Nexus registry host ([bac95eb](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/bac95ebb392febb667a9fc2f1fa4f06fa110d685))
+
+## [0.2.1](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.2.0...v0.2.1) (2026-09-18)
+
+### Documentation
+
+* use shared Nexus account [#21](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/21) ([1ad578f](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/1ad578fb37b8dd6161dc362541d9c0cd0b008b75))
+
+### CI
+
+* add frontend SonarQube analysis [#19](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/19) ([3f19b36](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/3f19b3643f88e36d10e7c374262351f61947ed47))
+* publish frontend images to Nexus [#21](https://git.personal.ksv741.ru/WealthLedger/frontend/issues/21) ([999b859](https://git.personal.ksv741.ru/WealthLedger/frontend/commit/999b8590ecd0a551da628c349d005ebb9b318883))
+
 ## [0.2.0](https://git.personal.ksv741.ru/WealthLedger/frontend/compare/v0.1.0...v0.2.0) (2026-09-16)
 
 ### Features

Dockerfile

@@ -2,10 +2,14 @@ FROM node:24.21.0-bookworm-slim AS dependencies
 WORKDIR /app
 ENV HUSKY=0
 COPY package.json package-lock.json ./
+COPY packages/tokens/package.json ./packages/tokens/
+COPY packages/ui/package.json ./packages/ui/
+COPY packages/icons/package.json ./packages/icons/
 RUN npm ci
 
 FROM dependencies AS development
 COPY . .
+RUN npm run build:packages
 ENV VITE_API_BASE_URL="" API_PROXY_TARGET=http://backend:3000
 EXPOSE 8080
 CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0", "--port", "8080", "--strictPort"]

README.md

@@ -19,8 +19,10 @@ npm run dev
 
 Для commits установите [Gitleaks](https://github.com/gitleaks/gitleaks/releases/tag/v8.30.1)
 8.30.1 в `PATH` (macOS: `brew install gitleaks`). Pre-commit сначала проверяет
-staged diff с полной редакцией секретов, затем запускает formatting и FSD checks.
+staged diff с полной редакцией секретов, затем запускает установленный
-Находка или отсутствие Gitleaks блокирует commit.
+`node_modules/.bin/lint-staged` только для staged JS/TS. Hook не скачивает tools и
+не запускает full graph: полный `npm run verify` выполняется в CI и перед передачей.
+Находка или отсутствие Gitleaks либо lint-staged блокирует commit.
 Проверка этого поведения: `node --test scripts/test-pre-commit.mjs`.
 
 ## Контейнерный image
@@ -28,7 +30,8 @@ staged diff с полной редакцией секретов, затем за
 `Dockerfile` имеет targets `development` (Vite HMR и proxy `/api/` во внутренний backend)
 и `production` (nginx на 8080, SPA fallback и same-origin API proxy). Node соответствует `.nvmrc`.
 Build context ограничен `.dockerignore`; `.env`, local DB и host node_modules
-не попадают в image.
+не попадают в image. Изменение `packages/tokens` или `packages/ui` требует rebuild development
+image, если локальный запуск использует bind-mount только `src`/`public`.
 
 ```bash
 docker build --target development -t wealthledger-frontend:development .
@@ -37,10 +40,13 @@ docker build --target production -t wealthledger-frontend:production .
 
 Gitea `image.yml` запускается на защищённом release tag `vX.Y.Z`, проверяет
 package/lock version и canonical gates. Runner `ubuntu-latest` должен иметь
-Docker/buildx. Dedicated package writer задаётся Actions secrets
+Docker/buildx. Образы хранятся в Nexus:
-`REGISTRY_USERNAME`/`REGISTRY_TOKEN`; server использует отдельную read-only
+`nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend`. Пользователь `wealthledger-ci`
-identity. Публикуются semver tags, без `latest`; существующие
+задаётся Actions secrets `NEXUS_USERNAME`/`NEXUS_PASSWORD`; эта же учётная
-release tags не перезаписываются. Production выбирает опубликованный version tag.
+запись используется сервером для загрузки образов. Docker endpoint и token realm должны использовать
+HTTPS; в `docker-hosted` включается запрет redeploy. Прежние Gitea secrets
+сохраняются на время перехода и не передаются в Nexus.
+Публикуются semver tags, без `latest`; существующие release tags не перезаписываются. Production выбирает опубликованный version tag.
 
 Compose topology принадлежит workspace, эксплуатационная последовательность —
 [документация](https://git.personal.ksv741.ru/WealthLedger/docs),
@@ -48,24 +54,92 @@ Compose topology принадлежит workspace, эксплуатационн
 Проверка публикации требует настроенного registry/runner; локальный build
 не доказывает package permissions.
 
+## Установка как приложение (PWA)
+
+Production-сборка поддерживает установку WealthLedger в отдельное окно через
+`vite-plugin-pwa`. Нужен HTTPS или localhost. В Chrome/Edge выберите «Установить
+WealthLedger» в меню браузера или значок установки в адресной строке; на iPhone
+и iPad — Safari → «Поделиться» → «На экран Домой». Доступность установки зависит
+от браузера и ОС.
+
+Service worker кеширует только статическую оболочку, включая страницы SPA.
+Вход, финансовые данные и сохранение изменений требуют сети: API, токены и
+ответы API не сохраняются в Cache Storage. Это не автономный финансовый
+клиент. Новая версия загружается в фоне и применяется после закрытия всех
+вкладок и окон WealthLedger и повторного открытия; открытые формы автоматически
+не перезагружаются.
+
+Локальная проверка: `nvm use --silent`, `npm run build`, `npm run preview`.
+В DevTools → Application проверьте Manifest, Service Workers и Cache Storage.
+В режиме `npm run dev` и в Storybook service worker не включается.
+
 ## Проверка
 
 ```bash
 nvm use --silent
+npm ci
+npx --no-install playwright install chromium
 npm run verify
 ```
 
 Команда проверяет, что generated OpenAPI types соответствуют committed snapshot,
-затем запускает strict TypeScript, Biome, один coverage-backed запуск Vitest,
+затем запускает strict TypeScript, ESLint и проверку его конфигурации,
+один coverage-backed запуск Vitest,
 Knip, dependency rules приложения и stories, сборки приложения и Storybook.
-Отдельный CI workflow `Frontend security` на push, pull request и ежедневно
+
-проверяет полную доступную историю Gitleaks 8.30.1 и выполняет
+`npm run lint` запускает ESLint с `--max-warnings=0`; `npm run lint:fix`
+применяет автофиксы. [Конфигурация](eslint.config.mjs) подключает рекомендованные
+наборы всех установленных плагинов: TypeScript, React, Hooks, Refresh, Query,
+Unicorn, import-x, SonarJS, RegExp, Security, no-unsanitized, Perfectionist, Stylistic,
+Vitest, Testing Library, jest-dom и Storybook. Правила React, тестов и stories
+применяются к соответствующим файлам; generated/build artifacts исключены.
+
+Stylistic отвечает за форматирование JS/TS/TSX, Perfectionist — за сортировку.
+Сохраняются табы, двойные кавычки и точки с запятой. Biome удалён; Prettier
+не используется. CSS, JSON и Markdown не форматируются через ESLint.
+`lint-staged` исправляет JS/TS/TSX перед commit. `lint:eslint` сначала собирает
+private packages, чтобы анализ типов использовал актуальные declarations.
+`npm run test:lint` проверяет действующие presets и ошибочные примеры.
+`no-unsanitized` проверяет опасные DOM HTML-присваивания и вызовы;
+React `dangerouslySetInnerHTML` отдельно проверяется React-плагином.
+
+Точечные исключения в исходниках объясняют контракты и ограничения статического
+анализа; изменение nullable API fields, query keys или порядка race-операций
+ради линтера недопустимо. Архитектуру проверяет dependency-cruiser, поведение —
+Vitest/MSW и Chromium. Линтеры не заменяют semantic/security review.
+`jsx-a11y` без поддержки ESLint 10 остаётся отложенным в
+[workspace issue #18](https://git.personal.ksv741.ru/WealthLedger/main/issues/18).
+
+Vitest включает JSDOM-тесты и проверку геометрии секций позиций в headless
+Chromium при ширинах 375 и 1280 px. Browser project не использует JSDOM setup
+и его заглушки layout API. Только браузерная проверка:
+`npm run test:run -- --project='browser-*'`. После обновления Playwright повторите
+установку Chromium; CI устанавливает его с `--with-deps` для Linux.
+Единый `.gitea/workflows/verify.yml` запускает `commits → security → verify`
+последовательно на PR; на push в `develop`/`main` — `security → verify`.
+Рабочие ветки проверяются после открытия PR, без дублирующего push-запуска.
+Изменение заголовка PR запускает `.gitea/workflows/pr-title.yml` (то же имя workflow,
+только job `commits`): статусы `security` и `verify` на HEAD не перезаписываются.
+Новый запуск отменяет устаревший для того же PR/ветки и типа события
+(требуется Gitea 1.26+). Ежедневно в 05:17 UTC выполняется только `security`.
+Job `security` проверяет полную доступную историю Gitleaks 8.30.1 и выполняет
 `npm audit --include=dev --audit-level=low`. Любой advisory блокирует security job;
 исключений frontend нет. Локально можно выполнить те же команды:
 `gitleaks git --log-opts=--all --redact=100 --no-banner` и
 `npm audit --include=dev --audit-level=low`. Audit требует доступа к npm registry;
 проверка секретов выполняется локально и не выводит их значения.
 
+Имена jobs `commits`, `security`, `verify` сохранены, но Gitea включает имя
+workflow в статус. При внедрении администратор должен заменить required checks
+для защищённых веток на `Frontend verify / commits (pull_request)`,
+`Frontend verify / security (pull_request)` и
+`Frontend verify / verify (pull_request)`, удалив старые имена и push-статусы,
+если они требовались. Все три PR-проверки должны оставаться обязательными.
+Публикация образов по тегам остаётся в `image.yml`.
+Последовательность jobs ограничивает один запуск; для ограничения нагрузки всего сервера настройте
+`runner.capacity: 1` у общего runner и учтите остальные зарегистрированные
+runners. Конфигурация runner управляется вне этого репозитория.
+
 TypeScript остаётся на 5.9.3: `openapi-typescript@7.13.0` требует peer `^5.x`.
 Обновление до TypeScript 7 из Renovate dashboard откладывается до совместимого
 релиза генератора; `--force`/`--legacy-peer-deps` для обхода этого ограничения
@@ -74,6 +148,42 @@ TypeScript остаётся на 5.9.3: `openapi-typescript@7.13.0` требуе
 обновите `src/shared/api/spec/openapi.json` копированием backend OpenAPI
 document и затем выполните `npm run openapi:generate`.
 
+## SonarQube
+
+Проект `wealthledger-frontend` использует настройки из
+`sonar-project.properties`. Анализируются исходники `src`; тесты учитываются
+отдельно, а Storybook fixtures, test helpers, generated API types и OpenAPI
+snapshot исключены. `npm run test:coverage` (также входит в `npm run verify`)
+создаёт `coverage/lcov.info` для импорта покрытия.
+
+Для первого анализа установите SonarScanner CLI, совместимый с версией сервера,
+и выполните из корня frontend:
+
+```bash
+nvm use --silent
+npm ci
+npm run test:coverage
+# SONAR_TOKEN передайте через окружение; не сохраняйте токен в репозитории.
+sonar-scanner
+```
+
+В Gitea откройте frontend → Settings → Actions → Secrets и добавьте
+`SONAR_TOKEN` с токеном анализа проекта. Переименовывать основную ветку в
+SonarQube не требуется; `sonar.branch.name` не задаётся.
+Используется Community Edition 9.9.8: CI отправляет только
+push в `develop`, после успешного `verify`, и ожидает результат Quality Gate.
+PR и остальные ветки проходят обычные проверки без отправки в SonarQube.
+Отрицательный Quality Gate или ошибка scanner завершает `verify` с ошибкой.
+
+Runner должен поддерживать Docker actions и иметь HTTPS-доступ к
+`https://sonarqube.personal.ksv741.ru`, GitHub и Docker Hub. Docker action
+SonarSource закреплён на commit версии 2.3.0; scanner запускается отдельно от
+Node 24, используемого для сборки. `tsconfig.sonar.json` содержит совместимые
+со старым анализатором TS настройки; приложение проверяется штатным TypeScript
+5.9 через `npm run verify`. После обновления сервера пересмотрите scanner и
+возможность использовать основной tsconfig. Успешный локальный `verify` не
+доказывает доступность сервера и успешность анализа в CI.
+
 ## UI-каталог Storybook
 
 После `nvm use --silent` выполните `npm run dev:catalog`; статическая сборка —
@@ -96,7 +206,8 @@ Checkout frontend содержит все входы сборки и прове
 локальную копию и не обращаются к исходникам или CI сервера. Доставка новой
 схемы — явное обновление snapshot с review и `npm run openapi:generate`.
 Runtime URL API задаётся окружением, а не расположением другого репозитория.
-Разработка идёт напрямую по задаче пользователя; OpenSpec/SDD — по явному запросу.
+Разработка начинается с Issue; lightweight или SDD выбирается по критериям
+Engineering Workflow из AGENTS. OpenSpec — после явного решения Change Owner.
 
 Knip исключает `conventional-changelog-conventionalcommits`: release-it загружает
 preset по имени из `.release-it.json`. Версия preset закреплена напрямую.
@@ -104,35 +215,90 @@ preset по имени из `.release-it.json`. Версия preset закреп
 ## Релизы
 
 Репозиторий выпускается независимо. `develop` — интеграция, `main` — принятые
-релизы. Работа: `codex/<task>` от актуального `develop`, PR в `develop`.
+релизы. Обычная работа: issue-linked ветка от актуального `develop`, PR в `develop`;
-Обычные PR допускают squash; release и обратная синхронизация сохраняют историю.
+общие правила — в Engineering Workflow по ссылке из AGENTS.
-Commits и PR titles — Conventional Commits, включая `spec:`. Версии вручную не повышай.
+PR сливается squash или rebase-merge; merge-коммит не используется. `main`
+обновляется только fast-forward из `develop`, поэтому история линейна:
 
-1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Убедись, что
+```text
-   `develop` содержит последний релиз. Создай `release/<name>` от проверенного
+<type>/<issue>-<slug> --squash--> develop --ff-only--> main --> tag vX.Y.Z
-   `develop`; `nvm use --silent`, `npm ci`. Hotfix начинается от `main` в
+```
-   `release/hotfix-<name>` и проходит тот же процесс.
+
+Инвариант: `origin/main` всегда предок `origin/develop`. Проверка:
+
+```bash
+git fetch -q origin
+git merge-base --is-ancestor origin/main origin/develop && echo ok || echo BROKEN
+```
+
+Commits и PR titles — Conventional Commits со ссылкой на Issue (кроме release),
+включая `spec:`. Версии вручную не повышай.
+
+1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Проверь
+   инвариант. Создай `release/X.Y.Z` от проверенного `develop`;
+   `nvm use --silent`, `npm ci`.
 2. На чистой ветке выполни `npm run release:preview`, просмотри версию/changelog,
    затем `npm run release:prepare`. Команда создаёт `chore(release): X.Y.Z`,
    обновляет manifest/lockfile/CHANGELOG; тег и push не выполняет. Не обходи
    guards ветки, чистого дерева, отсутствующих тегов или уже подготовленной версии.
 3. Проверь diff и штатные gates этого репозитория. Отправь только release-ветку,
-   открой PR в `main` с заголовком `chore(release): X.Y.Z`. После зелёных
+   открой PR в **`develop`** с заголовком `chore(release): X.Y.Z`. После зелёных
-   `verify`, `security`, `commits` выполни fast-forward-only merge. Если `main`
+   `verify`, `security`, `commits` выполни fast-forward-only merge. Если
-   изменился, согласуй историю и повтори проверки кандидата.
+   `develop` изменился, обнови release-ветку и повтори проверки кандидата.
-4. Получи удалённый `main`, сравни его HEAD с проверенным release SHA и версией
+4. Открой PR `develop → main` с тем же заголовком и слей fast-forward-only.
+5. Получи удалённый `main`, сравни его HEAD с проверенным release SHA и версией
    manifest/lockfile. Создай аннотированный `vX.Y.Z` именно на этом SHA:
    `git tag -a vX.Y.Z <release-sha> -m "Release X.Y.Z"`, затем отправь только
    `git push origin refs/tags/vX.Y.Z`. Не запускай release-it повторно на `main`.
-5. Верни release-коммит через PR `main → develop` без squash/rebase; проверь,
+
-   что `develop` содержит тег. Опубликованные теги не перемещай. При сбое после
+Обратная синхронизация не нужна: release-коммит попал в `develop` на шаге 3.
-   merge создай отсутствующий тег без нового bump; до merge исправь и проверь
+Опубликованные теги не перемещай. При сбое после merge создай отсутствующий тег
-   существующий кандидат без повторного повышения версии.
+без нового bump; до merge исправь и проверь существующий кандидат без
+повторного повышения версии.
+
+Freeze релиза не поддерживается: пока открыт релизный PR, `develop` не двигают.
+Срочный fix — обычная ветка `fix/*` от `develop` с последующим релизом;
+пути от `main` нет, он сделал бы `main` не-предком `develop`. Исключение
+требует явного решения: `release/hotfix-<name>` от `main`, PR в `main`, тег,
+затем merge `main → develop` для восстановления инварианта.
 
 `feat:` повышает minor, `fix:`/`perf:` и прочие разрешённые типы — patch;
 `!`/`BREAKING CHANGE:` — major, включая версии до 1.0. `chore(release):`
 исключён из рекомендации и changelog. Конфигурация — `.release-it.json`.
 В Gitea для `main`/`develop` должны быть запрещены прямой/force push и обход
-администратором, обязательны `verify`, `security`, `commits`; теги `v*` защищены.
+администратором, включена блокировка устаревшей ветки, обязательны `verify`,
+`security`, `commits`; теги `v*` защищены. Линейность обеспечивают merge styles
+репозитория: merge-коммиты и rebase `--no-ff` выключены, доступны squash,
+rebase-merge и fast-forward-only; стиль по умолчанию — squash.
 Workflow сам не включает эти настройки. Отдельное review approval для одного
 владельца не требуется. Npm publishing, deploy и Gitea Releases не включены.
+
+## Локальные пакеты
+
+`packages/tokens` — private npm workspace с единственным export
+`@wealthledger/tokens/tokens.json`. `packages/ui` экспортирует собранные
+`@wealthledger/ui/theme` (JS + declarations) и `@wealthledger/ui/styles.css`.
+Корневой export `@wealthledger/ui` содержит EntryCard, StateView и LoadingSkeleton;
+Потребители импортируют компоненты напрямую из `@wealthledger/ui`.
+CSS явно подключается после Mantine; providers остаются в приложении/Storybook.
+Тема доступна через `@wealthledger/ui/theme`; compatibility re-exports удалены.
+
+JSON не требует сборки. `npm ci` связывает workspaces, а существующие команды
+разработки, проверок и сборки сначала выполняют `npm run build:packages`.
+Library build использует отдельный Vite config без app plugins и TypeScript
+для declarations. После изменения package sources перезапустите `npm run dev`
+или `npm run dev:catalog`; отдельный watch-процесс пока не нужен.
+Начальная версия manifest взята из приложения; отдельный release-процесс
+и публикация не настроены.
+
+Private `@wealthledger/icons` содержит все SVG приложения: действия,
+навигацию, contactless/wallet и геометрию `OperationIcon`. Пакет поставляет
+ESM, declarations и `@wealthledger/icons/styles.css`; приложение и Storybook
+подключают CSS явно. В `src` нет raw SVG и компонентов только для рисования
+иконок. Category/kind mapping остаётся в model `entities/bank-card`.
+
+Статичные иконки принимают `IconProps`: `size` по умолчанию 24,
+`strokeWidth` 1.5, цвет через `currentColor`. В кнопке иконка декоративная,
+имя принадлежит действию. Для самостоятельного изображения передайте
+`aria-hidden={false}`, `role="img"` и `aria-label` либо `aria-labelledby`.
+Анимации сохраняют hover/focus lifecycle и `prefers-reduced-motion`.

SECURITY_ESLINT_REVIEW.md

@@ -0,0 +1,70 @@
+# Security-плагины ESLint
+
+Проверено 28 сентября 2026 года для frontend: ESLint 10.11.0,
+TypeScript и React 19. Рекомендация — добавить только
+`eslint-plugin-no-unsanitized@4.1.5` с полным `configs.recommended`.
+Решение реализовано: пакет добавлен в devDependencies, полный recommended
+подключён в ESLint. Ниже сохранены результаты исследования до установки.
+
+## Все пакеты из раздела Security
+
+Источник списка: [awesome-eslint / Security](https://github.com/dustinspecker/awesome-eslint#security).
+Версии и даты ниже — опубликованные `latest` из npm на момент проверки.
+Широкий peer range сам по себе не доказывает работоспособность.
+
+| Пакет | Версия; публикация | Заявленный peer ESLint | Решение для frontend |
+| --- | --- | --- | --- |
+| [no-unsanitized](https://github.com/mozilla/eslint-plugin-no-unsanitized) | [4.1.5](https://registry.npmjs.org/eslint-plugin-no-unsanitized/4.1.5); 2026-02-19 | `^9 \|\| ^10` | Добавить: проверяет опасные присваивания и вызовы native DOM HTML API. Flat recommended включает `property` и `method` как errors. |
+| [no-secrets](https://github.com/nickdeis/eslint-plugin-no-secrets) | [2.3.3](https://registry.npmjs.org/eslint-plugin-no-secrets/2.3.3); 2026-03-01 | `>=5` | Не добавлять: поиск секретов по entropy/patterns существенно пересекается с существующими Gitleaks и SonarJS. Flat config поддерживается; отсутствие рекомендации связано с дублированием. |
+| [pii](https://github.com/shiva-hack/eslint-plugin-pii) | [1.0.2](https://registry.npmjs.org/eslint-plugin-pii/1.0.2); 2021-04-13 | `>=4.19.1` | Не добавлять: правило падает на ESLint 10. Проверяет email/даты рождения/IP/телефоны в литералах и комментариях, а не потоки персональных данных; потребует исключений для тестовых данных. |
+| [pg](https://github.com/interlace-collie/eslint/tree/main/packages/eslint-plugin-pg) | [1.4.14](https://registry.npmjs.org/eslint-plugin-pg/1.4.14); 2026-08-06 | `^8.0.0 \|\| ^9.0.0 \|\| ^10.0.0` | Не добавлять: предназначен для Node.js с `pg`, которого во frontend нет. Пакет deprecated и переименован в `eslint-plugin-postgresql-security`; старое имя больше не обновляется. |
+| [security](https://github.com/eslint-community/eslint-plugin-security) | [4.1.0](https://registry.npmjs.org/eslint-plugin-security/4.1.0); 2026-09-27 | Не указан | Уже установлен с recommended. Ориентирован главным образом на Node.js; не заменяет проверки DOM. |
+| [xss](https://github.com/Rantanen/eslint-plugin-xss) | [0.1.12](https://registry.npmjs.org/eslint-plugin-xss/0.1.12); 2022-06-27 | Не указан | Не добавлять: правило падает на ESLint 10. Проверяет HTML-конкатенации/соглашения об именах и присваивания `location.href`; это не специализированная проверка React/TSX. |
+
+## Что добавляет no-unsanitized
+
+[Правило property](https://github.com/mozilla/eslint-plugin-no-unsanitized/blob/master/docs/rules/property.md)
+проверяет присваивания `innerHTML`/`outerHTML`;
+[method](https://github.com/mozilla/eslint-plugin-no-unsanitized/blob/master/docs/rules/method.md)
+проверяет, в частности, `insertAdjacentHTML`, `document.write` и `document.writeln`.
+В [исходнике method](https://github.com/mozilla/eslint-plugin-no-unsanitized/blob/master/lib/rules/method.js)
+также есть проверки `createContextualFragment`, `setHTMLUnsafe` и dynamic import.
+Следовательно, перед включением нужно прогнать весь lint, а не только HTML-примеры.
+
+До подключения no-unsanitized [eslint.config.mjs](eslint.config.mjs) уже включал
+React-проверку `dom-no-dangerously-set-innerhtml` и security-правила SonarJS.
+Предварительная проверка через локальный `ESLint.lintText` показала пробел:
+функция с `element.innerHTML = html` не получала security-диагностику,
+тогда как JSX `dangerouslySetInnerHTML` получал
+диагностику React. Это различие в покрытии, не обнаруженная уязвимость приложения:
+таких production DOM-присваиваний при поиске не найдено.
+
+Плагин понимает TS-синтаксис через TypeScript parser, включая `as`-выражения,
+но не использует TypeScript type checker. Он не доказывает безопасность всех
+потоков данных. У версии 4.1.5 нет runtime dependencies; Prettier указан только
+в devDependencies самого плагина и при его обычной установке потребителем
+не устанавливается.
+
+## Проверка совместимости без установки
+
+Опубликованные npm tarballs прочитаны в `/tmp`; использованы локальные
+ESLint 10.11.0 и `@typescript-eslint/parser`, без lifecycle-скриптов пакетов.
+Через `Linter.verify` с recommended no-unsanitized проверены:
+
+- `innerHTML`/`outerHTML` с параметром `html: string` — обе ошибки найдены;
+- `insertAdjacentHTML`/`document.write`/`document.writeln` — все три ошибки найдены;
+- `innerHTML = html as string` — ошибка найдена;
+- безопасный `textContent` и обычная TSX-интерполяция — без ошибок.
+
+Отдельный запуск реальных правил `pii/no-email` и
+`xss/no-location-href-assign` завершился
+`TypeError: context.getSourceCode is not a function` на ESLint 10.
+Это подтверждает несовместимость проверенных версий, несмотря на широкий
+или отсутствующий peer range. Обходы через legacy adapters не предлагаются.
+
+Поиск секретов уже выполняют [security workflow](.gitea/workflows/security.yml)
+и pre-commit Gitleaks; SonarJS дополнительно проверяет hardcoded secrets.
+Добавление ещё одного secret-scanner в ESLint сейчас не оправдано.
+
+Активацию обоих правил и примеры опасных DOM-вставок проверяет
+`npm run test:lint`; интеграцию зависимости — полный `npm run verify`.

biome.json

@@ -1,78 +0,0 @@
-{
-	"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
-	"vcs": {
-		"useIgnoreFile": true
-	},
-	"files": {
-		"includes": [
-			"**",
-			"!dist",
-			"!storybook-static",
-			"!src/shared/api/generated",
-			"!src/shared/api/spec",
-			"!coverage",
-			"!node_modules"
-		]
-	},
-	"linter": {
-		"rules": {
-			"preset": "recommended",
-			"nursery": {
-				"useReactFunctionComponentDefinition": {
-					"level": "error",
-					"options": {
-						"namedComponents": "arrowFunction"
-					}
-				}
-			},
-			"style": {
-				"noDefaultExport": "error",
-				"useExportsLast": "error",
-				"noMagicNumbers": "error"
-			}
-		}
-	},
-	"overrides": [
-		{
-			"includes": [
-				"vite.config.ts",
-				"vitest.config.ts",
-				".storybook/main.ts",
-				".storybook/preview.tsx"
-			],
-			"linter": {
-				"rules": {
-					"style": {
-						"noDefaultExport": "off"
-					}
-				}
-			}
-		},
-		{
-			"includes": ["**/*.stories.tsx"],
-			"linter": {
-				"rules": {
-					"style": {
-						"noDefaultExport": "off",
-						"useExportsLast": "off"
-					}
-				}
-			}
-		},
-		{
-			"includes": [
-				"**/*.test.ts",
-				"**/*.test.tsx",
-				"**/*.stories.tsx",
-				"src/test/**"
-			],
-			"linter": {
-				"rules": {
-					"style": {
-						"noMagicNumbers": "off"
-					}
-				}
-			}
-		}
-	]
-}

commitlint.config.cjs

@@ -1,6 +1,12 @@
 module.exports = {
+	defaultIgnores: false,
 	extends: ["@commitlint/config-conventional"],
+	ignores: [
+		message => /^chore\(release\): \d+\.\d+\.\d+$/.test(message.trim()),
+		message => /^Merge pull request ['"].+['"] \(#\d+\) from .+ into .+$/.test(message.trim()),
+	],
 	rules: {
+		"references-empty": [2, "never"],
 		"type-enum": [
 			2,
 			"always",

dependency-cruiser.cjs

@@ -1,50 +1,88 @@
 module.exports = {
 	forbidden: [
 		{
+			from: {
+				path: "^(src|packages/[^/]+/src)/",
+				pathNot: "[.](test|stories|fixtures)[.]|^src/test/",
+			},
+			name: "production-must-not-depend-on-test-code",
+			severity: "error",
+			to: { path: "[.](test|stories|fixtures)[.]|^src/test/" },
+		},
+		{
+			from: {},
+			name: "no-unresolved",
+			severity: "error",
+			to: { couldNotResolve: true },
+		},
+		{
+			from: { path: "^packages/" },
+			name: "packages-must-not-depend-on-app",
+			severity: "error",
+			to: { path: "^src/" },
+		},
+		{
+			from: {},
 			name: "no-circular",
 			severity: "error",
-			from: {},
 			to: { circular: true },
 		},
 		{
+			from: {
+				path: "^src/(app|pages|widgets|features|entities|shared)/([^/]+)/",
+			},
 			name: "slices-must-use-public-api",
 			severity: "error",
-			from: {
-				path: "^src/(app|pages|features|entities|shared)/([^/]+)/",
-			},
 			to: {
-				path: "^src/(app|pages|features|entities|shared)/([^/]+)/(?!index\\.ts$)",
+				path: String.raw`^src/(app|pages|widgets|features|entities|shared)/([^/]+)/(?!index\.ts$)`,
 				pathNot: "^src/$1/$2/",
 			},
 		},
 		{
+			from: { path: "^src/(pages|widgets|features|entities)/([^/]+)/" },
+			name: "no-same-layer-cross-slice-imports",
+			severity: "error",
+			to: { path: "^src/$1/", pathNot: "^src/$1/$2/" },
+		},
+		{
+			from: { path: "^src/shared/" },
 			name: "shared-must-not-depend-on-layers",
 			severity: "error",
-			from: { path: "^src/shared/" },
+			to: { path: "^src/(entities|features|widgets|pages|app)/" },
-			to: { path: "^src/(entities|features|pages|app)/" },
 		},
 		{
+			from: { path: "^src/entities/" },
 			name: "entities-must-not-depend-on-higher-layers",
 			severity: "error",
-			from: { path: "^src/entities/" },
+			to: { path: "^src/(features|widgets|pages|app)/" },
-			to: { path: "^src/(features|pages|app)/" },
 		},
 		{
+			from: { path: "^src/features/" },
 			name: "features-must-not-depend-on-higher-layers",
 			severity: "error",
-			from: { path: "^src/features/" },
+			to: { path: "^src/(widgets|pages|app)/" },
+		},
+		{
+			from: { path: "^src/widgets/" },
+			name: "widgets-must-not-depend-on-higher-layers",
+			severity: "error",
 			to: { path: "^src/(pages|app)/" },
 		},
 		{
+			from: { path: "^src/pages/" },
 			name: "pages-must-not-depend-on-app",
 			severity: "error",
-			from: { path: "^src/pages/" },
 			to: { path: "^src/app/" },
 		},
 	],
 	options: {
 		doNotFollow: { path: "node_modules" },
-		tsConfig: { fileName: "tsconfig.app.json" },
+		enhancedResolveOptions: {
+			conditionNames: ["import", "require", "node", "default"],
+			exportsFields: ["exports"],
+		},
+		exclude: "^packages/[^/]+/dist/",
+		tsConfig: { fileName: "tsconfig.dependency-cruiser.json" },
 		tsPreCompilationDeps: true,
 	},
 };

eslint-rules.mjs

@@ -0,0 +1,178 @@
+const readability = {
+	create(context) {
+		const filename = context.filename;
+
+		function checkParameters(node) {
+			const last = node.params.at(-1);
+			if (
+				last?.type === "Identifier"
+				&& !last.optional
+				&& last.typeAnnotation?.typeAnnotation.type === "TSUnionType"
+				&& last.typeAnnotation.typeAnnotation.types.some(
+					type => type.type === "TSUndefinedKeyword",
+				)
+			)
+				context.report({ messageId: "optional", node: last });
+		}
+
+		return {
+			ArrowFunctionExpression: checkParameters,
+			CallExpression(node) {
+				if (
+					node.callee.type === "MemberExpression"
+					&& ["refine", "superRefine"].includes(node.callee.property.name)
+					&& !filename.endsWith(".schema.ts")
+				)
+					context.report({ messageId: "schema", node });
+			},
+			FunctionDeclaration: checkParameters,
+			FunctionExpression: checkParameters,
+			ImportDeclaration(node) {
+				if (
+					node.source.value === "zod"
+					&& node.importKind !== "type"
+					&& !filename.endsWith(".schema.ts")
+				)
+					context.report({ messageId: "schema", node });
+			},
+			JSXOpeningElement(node) {
+				if (
+					!filename.includes("/packages/icons/")
+					&& node.name.type === "JSXIdentifier"
+					&& /^(?:svg|path|circle|ellipse|rect|polygon|polyline|line|g|defs|use|symbol)$/.test(
+						node.name.name,
+					)
+				)
+					context.report({ messageId: "svg", node });
+			},
+			TSUnionType(node) {
+				const complex
+					= node.types.length > 2
+						|| node.types.some(type => type.type === "TSTypeLiteral");
+
+				if (
+					complex
+					&& node.types.some(
+						(type, index) =>
+							index > 0
+							&& type.loc.start.line === node.types[index - 1].loc.end.line,
+					)
+				)
+					context.report({ messageId: "union", node });
+			},
+			VariableDeclarator(node) {
+				if (
+					!/^[A-Z]/.test(node.id.name ?? "")
+					|| node.init?.type !== "ArrowFunctionExpression"
+					|| node.init.body.type !== "BlockStatement"
+				)
+					return;
+
+				for (const statement of node.init.body.body) {
+					if (statement.type === "FunctionDeclaration")
+						context.report({ messageId: "helper", node: statement });
+
+					else if (statement.type === "VariableDeclaration") {
+						for (const declaration of statement.declarations) {
+							if (
+								["ArrowFunctionExpression", "FunctionExpression"].includes(
+									declaration.init?.type,
+								)
+							)
+								context.report({ messageId: "helper", node: declaration });
+						}
+					}
+				}
+			},
+		};
+	},
+	meta: {
+		messages: {
+			helper:
+				"Move helpers outside components; actions belong to the ViewModel.",
+			optional:
+				"Use an optional trailing parameter instead of a union with undefined.",
+			schema: "Declare Zod schemas in a dedicated *.schema.ts file.",
+			svg: "Own SVG markup in packages/icons, and import its public component.",
+			union: "Put complex union members on separate lines.",
+		},
+		schema: [],
+		type: "suggestion",
+	},
+};
+
+function isComponent(node) {
+	const pending = [node];
+
+	while (pending.length > 0) {
+		const child = pending.pop();
+		if (!child) continue;
+
+		switch (child.type) {
+			case "JSXElement": {
+				return true;
+			}
+
+			case "JSXFragment": {
+				return true;
+			}
+
+			case "JSXExpressionContainer": {
+				pending.push(child.expression);
+				continue;
+			}
+
+			case "LogicalExpression": {
+				pending.push(child.right);
+				continue;
+			}
+
+			case "ConditionalExpression": {
+				pending.push(child.consequent, child.alternate);
+				continue;
+			}
+		}
+	}
+
+	return false;
+}
+
+const jsxSpacing = {
+	create(context) {
+		function check(node) {
+			let previous;
+
+			for (const child of node.children) {
+				if (child.type === "JSXText" && !child.value.trim()) continue;
+				if (isComponent(child)) {
+					if (previous) {
+						const gap = context.sourceCode.text.slice(
+							previous.range[1],
+							child.range[0],
+						);
+
+						if (!/\n\s*\n/.test(gap))
+							context.report({
+								fix: fixer => fixer.insertTextAfter(previous, "\n"),
+								messageId: "space",
+								node: child,
+							});
+					}
+
+					previous = child;
+				}
+				else previous = undefined;
+			}
+		}
+
+		return { JSXElement: check, JSXFragment: check };
+	},
+	meta: {
+		fixable: "whitespace",
+		messages: { space: "Separate sibling JSX components with a blank line." },
+		schema: [],
+		type: "layout",
+	},
+};
+
+export default { rules: { "jsx-spacing": jsxSpacing, readability } };

eslint.config.mjs

@@ -0,0 +1,323 @@
+import react from "@eslint-react/eslint-plugin";
+import js from "@eslint/js";
+import stylistic from "@stylistic/eslint-plugin";
+import query from "@tanstack/eslint-plugin-query";
+import vitest from "@vitest/eslint-plugin";
+import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript";
+import { importX } from "eslint-plugin-import-x";
+import jestDom from "eslint-plugin-jest-dom";
+import noUnsanitized from "eslint-plugin-no-unsanitized";
+import perfectionist from "eslint-plugin-perfectionist";
+import hooks from "eslint-plugin-react-hooks";
+import refresh from "eslint-plugin-react-refresh";
+import regexp from "eslint-plugin-regexp";
+import security from "eslint-plugin-security";
+import sonarjs from "eslint-plugin-sonarjs";
+import storybook from "eslint-plugin-storybook";
+import testingLibrary from "eslint-plugin-testing-library";
+import unicorn from "eslint-plugin-unicorn";
+import { defineConfig, globalIgnores } from "eslint/config";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+
+import frontend from "./eslint-rules.mjs";
+
+export default defineConfig(
+	{
+		files: ["src/**/*.{ts,tsx}", "packages/*/src/**/*.{ts,tsx}"],
+		ignores: ["**/*.test.{ts,tsx}", "**/*.stories.tsx", "src/test/**"],
+		plugins: { frontend },
+		rules: { "frontend/jsx-spacing": "error", "frontend/readability": "error" },
+	},
+	globalIgnores([
+		"**/dist/**",
+		"dist-ssr/**",
+		"storybook-static/**",
+		"coverage/**",
+		".vitest/**",
+		".scannerwork/**",
+		"src/shared/api/generated/**",
+		"src/shared/api/spec/**",
+	]),
+	{
+		extends: [
+			js.configs.recommended,
+			importX.flatConfigs.recommended,
+			unicorn.configs.recommended,
+			sonarjs.configs.recommended,
+			regexp.configs.recommended,
+			security.configs.recommended,
+			noUnsanitized.configs.recommended,
+			perfectionist.configs["recommended-natural"],
+			stylistic.configs.customize({
+				indent: "tab",
+				jsx: true,
+				quotes: "double",
+				semi: true,
+			}),
+		],
+		files: ["**/*.{js,mjs,cjs,ts,tsx}"],
+		linterOptions: { reportUnusedDisableDirectives: "error" },
+		rules: {
+			// A comma disambiguates generic arrow functions from JSX in TSX.
+			"@stylistic/comma-dangle": [
+				"error",
+				{
+					arrays: "always-multiline",
+					enums: "always-multiline",
+					exports: "always-multiline",
+					functions: "always-multiline",
+					generics: "ignore",
+					imports: "always-multiline",
+					objects: "always-multiline",
+					tuples: "always-multiline",
+				},
+			],
+
+			// Keep text/interpolation together: splitting can change rendered whitespace.
+			"@stylistic/jsx-one-expression-per-line": ["error", { allow: "non-jsx" }],
+			"@stylistic/max-len": [
+				"error",
+				{
+					code: 80,
+					ignoreComments: true,
+					ignoreRegExpLiterals: true,
+					ignoreStrings: true,
+					ignoreTemplateLiterals: true,
+					ignoreTrailingComments: true,
+					ignoreUrls: true,
+					tabWidth: 2,
+				},
+			],
+
+			"@stylistic/multiline-ternary": ["error", "always-multiline"],
+			"@stylistic/no-tabs": ["error", { allowIndentationTabs: true }],
+			"@stylistic/operator-linebreak": ["error", "before"],
+			"@stylistic/padding-line-between-statements": [
+				"error",
+				{ blankLine: "always", next: "return", prev: "*" },
+				{
+					blankLine: "always",
+					next: "*",
+					prev: ["multiline-const", "multiline-let", "block-like", "type"],
+				},
+				{
+					blankLine: "always",
+					next: ["multiline-const", "multiline-let", "block-like", "type"],
+					prev: "*",
+				},
+				{ blankLine: "any", next: "cjs-import", prev: "cjs-import" },
+			],
+			"no-nested-ternary": "error",
+			"perfectionist/sort-classes": [
+				"error",
+				{
+					groups: ["static-method", "property", "method", "unknown"],
+					type: "natural",
+				},
+			],
+			// Preserve the repository's component, hook and config file naming conventions.
+			"unicorn/filename-case": [
+				"error",
+				{ cases: { camelCase: true, kebabCase: true, pascalCase: true } },
+			],
+			// React uses Props/Ref names, including the recommended React ref-name rule.
+			"unicorn/name-replacements": [
+				"error",
+				{ replacements: { props: false, ref: false } },
+			],
+			// API DTOs, React refs and Mantine use null as part of their contracts.
+			"unicorn/no-null": "off",
+			"unicorn/prefer-ternary": ["error", "only-single-line"],
+		},
+		settings: {
+			"import-x/resolver-next": [
+				createTypeScriptImportResolver({ project: "tsconfig.json" }),
+			],
+		},
+	},
+	{
+		files: ["**/*.{js,mjs,cjs}", "**/*.config.ts", ".storybook/main.ts"],
+		languageOptions: { globals: globals.node },
+	},
+	{
+		extends: [
+			tseslint.configs.recommendedTypeChecked,
+			importX.flatConfigs.typescript,
+		],
+		files: ["**/*.{ts,tsx}"],
+		languageOptions: {
+			parserOptions: {
+				projectService: true,
+				tsconfigRootDir: import.meta.dirname,
+			},
+		},
+		rules: {
+			"@typescript-eslint/consistent-type-imports": "error",
+			// React ignores event handler return values; floating promises are still checked in bodies.
+			"@typescript-eslint/no-misused-promises": [
+				"error",
+				{ checksVoidReturn: { attributes: false } },
+			],
+			"@typescript-eslint/no-non-null-assertion": "error",
+			"@typescript-eslint/switch-exhaustiveness-check": "error",
+		},
+	},
+	{
+		extends: [
+			react.configs["recommended-type-checked"],
+			hooks.configs.flat.recommended,
+			query.configs["flat/recommended"],
+		],
+		files: [
+			"src/**/*.{ts,tsx}",
+			"packages/*/src/**/*.{ts,tsx}",
+			".storybook/preview.tsx",
+		],
+		languageOptions: { globals: globals.browser },
+		rules: {
+			"import-x/exports-last": "error",
+			"import-x/no-default-export": "error",
+		},
+	},
+	{
+		extends: [refresh.configs.vite],
+		files: ["src/**/*.tsx", "packages/*/src/**/*.tsx"],
+		ignores: ["**/*.test.tsx", "**/*.stories.tsx", "src/test/**"],
+	},
+	{
+		files: ["src/**/*.view.tsx"],
+		rules: {
+			"no-restricted-imports": ["error", {
+				paths: [
+					{
+						allowTypeImports: true,
+						message: "Query lifecycle belongs to the data VM.",
+						name: "@tanstack/react-query",
+					},
+					{
+						allowTypeImports: true,
+						message: "Transport belongs to shared/api and the data VM.",
+						name: "openapi-fetch",
+					},
+					{
+						allowTypeImports: true,
+						message: "Transport belongs to shared/api and the data VM.",
+						name: "openapi-react-query",
+					},
+				],
+				patterns: [
+					{
+						allowTypeImports: true,
+						group: ["react-router", "@/entities/*", "@/features/*"],
+						importNamePattern: "^use",
+						message: "Pass route, auth and entity data from the data VM.",
+					},
+					{
+						allowTypeImports: true,
+						group: ["@/shared/api", "@/shared/api/*"],
+						importNamePattern: "^use|^api(?:Query)?Client$",
+						message: "Fetching belongs to the data VM; error helpers are allowed.",
+					},
+				],
+			}],
+		},
+	},
+	{
+		files: ["src/**/*.{ts,tsx}", "packages/*/src/**/*.{ts,tsx}"],
+		ignores: ["**/*.test.{ts,tsx}", "**/*.stories.tsx", "src/test/**"],
+		rules: {
+			"@typescript-eslint/no-magic-numbers": [
+				"error",
+				{
+					ignore: [-1, 0, 1, "-1n", "0n", "1n"],
+					ignoreArrayIndexes: true,
+					ignoreDefaultValues: true,
+					ignoreNumericLiteralTypes: true,
+					ignoreTypeIndexes: true,
+				},
+			],
+			"@typescript-eslint/no-unnecessary-condition": ["error", { allowConstantLoopConditions: true }],
+		},
+	},
+	{
+		extends: [vitest.configs.recommended],
+		files: ["**/*.test.{ts,tsx}"],
+		rules: {
+			"vitest/no-focused-tests": "error",
+			"vitest/valid-expect": ["error", { maxArgs: 2 }],
+		},
+	},
+	{
+		extends: [
+			testingLibrary.configs["flat/react"],
+			jestDom.configs["flat/recommended"],
+		],
+		files: ["**/*.test.tsx"],
+	},
+	storybook.configs["flat/recommended"],
+	{
+		files: ["**/*.stories.tsx", ".storybook/preview.tsx"],
+		rules: {
+			"import-x/exports-last": "off",
+			"import-x/no-default-export": "off",
+		},
+	},
+	{
+		files: ["src/**/*.{ts,tsx}", "packages/*/src/**/*.{ts,tsx}"],
+		ignores: ["**/*.test.{ts,tsx}", "**/*.stories.tsx", "src/test/**"],
+		rules: {
+			"@typescript-eslint/no-unsafe-enum-comparison": "error",
+			"no-restricted-syntax": [
+				"error",
+				{
+					message:
+						"Pass a named handler from the ViewModel; prepare prop data before JSX.",
+					selector:
+						"JSXAttribute > JSXExpressionContainer :matches(ArrowFunctionExpression, FunctionExpression)",
+				},
+				{
+					message: "Name the derived prop value before JSX.",
+					selector:
+						"JSXAttribute > JSXExpressionContainer ConditionalExpression",
+				},
+
+				{
+					message:
+						"Use the owning enum member for machine codes and protocol values.",
+					selector:
+						"Literal[value=/^(?:(?:INSTRUMENT_ID_TYPE|INSTRUMENT_TYPE|OPERATION_STATE|OPERATION_TYPE|ACCOUNT_STATUS|ACCOUNT_TYPE|CANDLE_INTERVAL|COUPON_TYPE|BANK|INVALID)_[A-Z0-9]+(?:_[A-Z0-9]+)*|[A-Z][A-Z0-9_]*_(?:ERROR|UNAVAILABLE|NOT_FOUND|NOT_CONNECTED|CONFLICT|AMBIGUOUS|REGISTERED)|P[0-9]{4}|UNAUTHORIZED|FORBIDDEN|BAD_REQUEST|NOT_FOUND|UNSUPPORTED_MEDIA_TYPE)$/]:not(TSEnumMember > Literal)",
+				},
+				{
+					message:
+						"Use the owning enum member instead of a template machine code.",
+					selector:
+						"TemplateElement[value.cooked=/^(?:(?:INSTRUMENT_ID_TYPE|INSTRUMENT_TYPE|OPERATION_STATE|OPERATION_TYPE|ACCOUNT_STATUS|ACCOUNT_TYPE|CANDLE_INTERVAL|COUPON_TYPE|BANK|INVALID)_[A-Z0-9]+(?:_[A-Z0-9]+)*|[A-Z][A-Z0-9_]*_(?:ERROR|UNAVAILABLE|NOT_FOUND|NOT_CONNECTED|CONFLICT|AMBIGUOUS|REGISTERED)|P[0-9]{4}|UNAUTHORIZED|FORBIDDEN|BAD_REQUEST|NOT_FOUND|UNSUPPORTED_MEDIA_TYPE)$/]:not(TSEnumMember TemplateElement)",
+				},
+				{
+					message:
+						"Use an enum member instead of an inline code or protocol value.",
+					selector:
+						"Property:matches([key.name=/^(code|errorCode|idType|instrumentKind)$/], [key.value=/^(code|errorCode|idType|instrumentKind)$/]) > Literal.value[value=type(string)]",
+				},
+				{
+					message:
+						"Use an enum member instead of constructing a code or protocol value.",
+					selector:
+						"Property:matches([key.name=/^(code|errorCode|idType|instrumentKind)$/], [key.value=/^(code|errorCode|idType|instrumentKind)$/]) > TemplateLiteral.value",
+				},
+				{
+					message: "Use a computed enum member as the protocol mapping key.",
+					selector:
+						"Property[computed=false][key.name=/^(OPERATION_TYPE|ACCOUNT_TYPE)_/]",
+				},
+				{
+					message:
+						"Compare codes with their enum members, not string literals.",
+					selector:
+						"BinaryExpression:has(> :matches(MemberExpression[property.name=/^(code|errorCode)$/], Identifier[name=/^(code|errorCode)$/])) > Literal[value=type(string)]",
+				},
+			],
+		},
+	},
+);

index.html

@@ -1,8 +1,10 @@
 <!doctype html>
-<html lang="en">
+<html lang="ru">
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+    <meta name="theme-color" content="#ffffff" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>WealthLedger</title>
   </head>

knip.json

@@ -1,4 +1,17 @@
 {
-	"project": ["src/**/*.{ts,tsx}", "!src/shared/api/generated/**"],
+	"ignoreDependencies": ["conventional-changelog-conventionalcommits"],
-	"ignoreDependencies": ["conventional-changelog-conventionalcommits"]
+	"workspaces": {
+		".": {
+			"project": ["src/**/*.{ts,tsx}", "!src/shared/api/generated/**"]
+		},
+		"packages/tokens": {
+			"entry": ["tokens.json"]
+		},
+		"packages/ui": {
+			"project": ["src/**/*.{ts,tsx}"]
+		},
+		"packages/icons": {
+			"project": ["src/**/*.{ts,tsx}"]
+		}
+	}
 }

package.json

@@ -1,36 +1,40 @@
 {
 	"name": "wealth-ledger-frontend",
 	"private": true,
-	"version": "0.2.0",
+	"version": "1.2.0",
 	"type": "module",
 	"engines": {
 		"node": "24.21.0"
 	},
 	"scripts": {
-		"dev": "vite",
+		"dev": "npm run build:packages && vite",
-		"dev:catalog": "storybook dev -p 6006 --no-open --disable-telemetry",
+		"dev:catalog": "npm run build:packages && storybook dev -p 6006 --no-open --disable-telemetry",
-		"build:catalog": "storybook build --output-dir storybook-static --disable-telemetry",
+		"build:catalog": "npm run build:packages && storybook build --output-dir storybook-static --disable-telemetry",
 		"preview:catalog": "vite preview --outDir storybook-static",
-		"typecheck": "tsc -b --noEmit",
+		"typecheck": "npm run build:packages && tsc -b --noEmit",
-		"build": "tsc -b && vite build",
+		"build": "npm run build:packages && tsc -b && vite build",
-		"lint": "biome check .",
+		"lint": "npm run lint:eslint",
-		"test": "vitest",
+		"lint:eslint": "npm run build:packages && eslint . --max-warnings=0",
-		"test:run": "vitest run",
+		"test": "npm run build:packages && vitest",
-		"test:coverage": "vitest run --coverage",
+		"test:run": "npm run build:packages && vitest run",
+		"test:coverage": "npm run build:packages && vitest run --coverage",
+		"test:lint": "node --test scripts/test-eslint.mjs",
 		"openapi:generate": "openapi-typescript src/shared/api/spec/openapi.json -o src/shared/api/generated/schema.d.ts",
-		"openapi:check": "node scripts/check-openapi.mjs",
+		"openapi:check": "openapi-typescript src/shared/api/spec/openapi.json -o src/shared/api/generated/schema.d.ts --check",
-		"knip": "knip",
+		"knip": "npm run build:packages && knip",
-		"deps": "depcruise src --config dependency-cruiser.cjs --output-type err-long",
+		"deps": "npm run build:packages && depcruise src packages --config dependency-cruiser.cjs --output-type err-long",
-		"verify": "npm run openapi:check && npm run typecheck && npm run lint && npm run test:coverage && npm run knip && npm run deps && npm run deps:storybook && npm run build && npm run build:catalog",
+		"verify": "npm run build:packages && npm run openapi:check && tsc -b --noEmit && eslint . --max-warnings=0 && npm run test:lint && vitest run --coverage && knip && depcruise src packages --config dependency-cruiser.cjs --output-type err-long && depcruise src packages .storybook/preview.tsx --config .storybook/dependency-cruiser.cjs --output-type err-long && tsc -b && vite build && storybook build --output-dir storybook-static --disable-telemetry",
 		"prepare": "husky",
 		"preview": "vite preview",
-		"deps:storybook": "depcruise src .storybook/preview.tsx --config .storybook/dependency-cruiser.cjs --output-type err-long",
+		"deps:storybook": "npm run build:packages && depcruise src packages .storybook/preview.tsx --config .storybook/dependency-cruiser.cjs --output-type err-long",
 		"release:preview": "release-it --dry-run --ci",
 		"release:prepare": "release-it --ci",
-		"commitlint": "commitlint"
+		"commitlint": "commitlint",
+		"build:packages": "npm run build --workspaces --if-present",
+		"lint:fix": "npm run build:packages && eslint . --fix --max-warnings=0"
 	},
 	"lint-staged": {
-		"*.{css,html,json,md,ts,tsx}": "biome format --write --no-errors-on-unmatched"
+		"*.{js,mjs,cjs,ts,tsx}": "eslint --fix --max-warnings=0 --no-warn-ignored"
 	},
 	"dependencies": {
 		"@hookform/resolvers": "5.9.1",
@@ -38,7 +42,11 @@
 		"@mantine/core": "9.6.1",
 		"@mantine/dates": "9.6.1",
 		"@mantine/hooks": "9.6.1",
+		"@mantine/notifications": "9.6.1",
 		"@tanstack/react-query": "5.102.8",
+		"@wealthledger/icons": "file:packages/icons",
+		"@wealthledger/tokens": "file:packages/tokens",
+		"@wealthledger/ui": "file:packages/ui",
 		"dayjs": "1.11.23",
 		"i18next": "26.4.2",
 		"motion": "13.2.0",
@@ -55,37 +63,69 @@
 	},
 	"devDependencies": {
 		"@babel/core": "8.0.5",
-		"@biomejs/biome": "2.5.13",
 		"@commitlint/cli": "21.2.2",
 		"@commitlint/config-conventional": "21.2.2",
+		"@eslint-react/eslint-plugin": "5.21.0",
+		"@eslint/js": "10.0.1",
 		"@release-it/conventional-changelog": "12.0.0",
 		"@rolldown/plugin-babel": "0.2.4",
 		"@storybook/addon-docs": "10.6.0",
 		"@storybook/react-vite": "10.6.0",
+		"@stylistic/eslint-plugin": "5.10.0",
+		"@tanstack/eslint-plugin-query": "5.104.0",
 		"@testing-library/jest-dom": "7.0.1",
 		"@testing-library/react": "16.3.3",
 		"@types/node": "24.13.4",
 		"@types/react": "19.3.0",
 		"@types/react-dom": "19.3.0",
 		"@vitejs/plugin-react": "6.1.1",
+		"@vitest/browser-playwright": "5.0.0",
 		"@vitest/coverage-v8": "5.0.0",
+		"@vitest/eslint-plugin": "1.6.27",
 		"babel-plugin-react-compiler": "1.0.0",
 		"conventional-changelog-conventionalcommits": "10.4.0",
 		"dependency-cruiser": "18.2.0",
+		"eslint": "10.11.0",
+		"eslint-import-resolver-typescript": "4.4.5",
+		"eslint-plugin-import-x": "4.17.1",
+		"eslint-plugin-jest-dom": "5.10.1",
+		"eslint-plugin-no-unsanitized": "4.1.5",
+		"eslint-plugin-perfectionist": "5.12.1",
+		"eslint-plugin-react-hooks": "7.1.1",
+		"eslint-plugin-react-refresh": "0.5.7",
+		"eslint-plugin-regexp": "3.3.1",
+		"eslint-plugin-security": "4.1.0",
+		"eslint-plugin-sonarjs": "4.2.1",
+		"eslint-plugin-storybook": "10.6.0",
+		"eslint-plugin-testing-library": "7.16.2",
+		"eslint-plugin-unicorn": "76.0.0",
+		"globals": "17.12.0",
 		"husky": "9.1.7",
 		"jsdom": "30.0.1",
 		"knip": "6.35.1",
 		"lint-staged": "17.5.1",
 		"msw": "2.15.0",
 		"openapi-typescript": "7.13.0",
+		"playwright": "1.63.0",
 		"release-it": "21.0.2",
 		"storybook": "10.6.0",
 		"typescript": "5.9.3",
+		"typescript-eslint": "8.70.1",
 		"vite": "8.3.0",
+		"vite-plugin-pwa": "1.3.0",
 		"vitest": "5.0.0"
 	},
+	"overrides": {
+		"release-it": {
+			"basic-ftp": "6.2.1",
+			"undici": "7.29.1"
+		}
+	},
 	"allowScripts": {
 		"esbuild@0.28.2": true,
 		"fsevents@2.3.3": true
-	}
+	},
+	"workspaces": [
+		"packages/*"
+	]
 }

packages/icons/package.json

@@ -0,0 +1,33 @@
+{
+	"name": "@wealthledger/icons",
+	"version": "0.3.0",
+	"private": true,
+	"type": "module",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./styles.css": "./dist/index.css"
+	},
+	"sideEffects": [
+		"**/*.css"
+	],
+	"scripts": {
+		"build": "vite build && tsc -p tsconfig.json"
+	},
+	"peerDependencies": {
+		"react": "19.3.0"
+	},
+	"devDependencies": {
+		"@storybook/react-vite": "10.6.0",
+		"@testing-library/react": "16.3.3",
+		"@types/react": "19.3.0",
+		"typescript": "5.9.3",
+		"vite": "8.3.0",
+		"vitest": "5.0.0"
+	}
+}

packages/icons/src/Icons.stories.tsx

@@ -0,0 +1,51 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+
+import { AddIcon, DeleteIcon, EditIcon } from "./index";
+
+const meta = {
+	component: AddIcon,
+	parameters: {
+		docs: {
+			description: {
+				component:
+					"Статичные SVG: size по умолчанию 24, strokeWidth 1.5, цвет currentColor. В кнопке иконка декоративная, имя принадлежит действию. Для самостоятельного изображения задайте aria-hidden={false}, role=img и aria-label либо aria-labelledby. Геометрия взята из Card/Cards; подписи и действия остаются у приложения.",
+			},
+		},
+	},
+	tags: ["autodocs"],
+	title: "Design System/Icons",
+} satisfies Meta<typeof AddIcon>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Decorative: Story = {
+	render: () => (
+		<div style={{ color: "#2563eb", display: "flex", gap: 16 }}>
+			<button aria-label="Добавить пример" type="button">
+				<AddIcon size={20} strokeWidth={2} />
+			</button>
+
+			<button aria-label="Изменить пример" type="button">
+				<EditIcon size={18} />
+			</button>
+
+			<button aria-label="Удалить пример" type="button">
+				<DeleteIcon size={18} />
+			</button>
+		</div>
+	),
+};
+
+export const Meaningful: Story = {
+	render: () => (
+		<div style={{ color: "#2563eb", display: "flex", gap: 16 }}>
+			<AddIcon aria-hidden={false} aria-label="Добавление" role="img" />
+
+			<EditIcon aria-hidden={false} aria-label="Редактирование" role="img" />
+
+			<DeleteIcon aria-hidden={false} aria-label="Удаление" role="img" />
+		</div>
+	),
+};

packages/icons/src/Icons.test.tsx

@@ -0,0 +1,49 @@
+import { render, screen } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+
+import { AddIcon, DeleteIcon, EditIcon, OperationIcon } from "./index";
+
+describe("icon accessibility", () => {
+	it.each([AddIcon, EditIcon, DeleteIcon])(
+		"keeps decoration hidden and exposes explicitly named images: %s",
+		(Icon) => {
+			const { rerender } = render(
+				<button aria-label="Действие" type="button">
+					<Icon />
+				</button>,
+			);
+
+			expect(screen.queryByRole("img")).not.toBeInTheDocument();
+			expect(
+				// eslint-disable-next-line testing-library/no-node-access -- This assertion checks DOM structure, decoration or focus behavior that semantic queries cannot establish.
+				screen.getByRole("button", { name: "Действие" }).querySelector("svg"),
+			).toHaveAttribute("focusable", "false");
+			rerender(
+				<Icon
+					aria-hidden={false}
+					aria-label="Пример"
+					role="img"
+					size={18}
+					strokeWidth={2}
+				/>,
+			);
+			const icon = screen.getByRole("img", { name: "Пример" });
+			expect(icon).toHaveAttribute("width", "18");
+			expect(icon).toHaveAttribute("height", "18");
+			expect(icon).toHaveAttribute("stroke-width", "2");
+			expect(icon).toHaveAttribute("stroke", "currentColor");
+		},
+	);
+	it("keeps operation icons decorative", () => {
+		render(
+			<button aria-label="Операция" type="button">
+				<OperationIcon color="orange" variant="home" />
+			</button>,
+		);
+		expect(screen.queryByRole("img")).not.toBeInTheDocument();
+		// eslint-disable-next-line testing-library/no-node-access -- Decorative SVG has no accessible role.
+		expect(screen.getByRole("button").querySelector("svg")).toHaveAttribute(
+			"aria-hidden", "true",
+		);
+	});
+});

packages/icons/src/OperationIcon/OperationIcon.module.css

@@ -1,4 +1,5 @@
 .icon {
+	flex-shrink: 0;
 	overflow: visible;
 
 	& path {

packages/icons/src/OperationIcon/OperationIcon.tsx

@@ -0,0 +1,72 @@
+import type { FC } from "react";
+
+import { BasketIcon } from "./svg/BasketIcon";
+import { CarIcon } from "./svg/CarIcon";
+import { CashWithdrawalIcon } from "./svg/CashWithdrawalIcon";
+import { CoffeeIcon } from "./svg/CoffeeIcon";
+import { DepositIcon } from "./svg/DepositIcon";
+import { DiceIcon } from "./svg/DiceIcon";
+import { DownloadIcon } from "./svg/DownloadIcon";
+import { EducationIcon } from "./svg/EducationIcon";
+import { GridIcon } from "./svg/GridIcon";
+import { GrowthIcon } from "./svg/GrowthIcon";
+import { HomeIcon } from "./svg/HomeIcon";
+import { MedicalIcon } from "./svg/MedicalIcon";
+import { MusicIcon } from "./svg/MusicIcon";
+import { RefundIcon } from "./svg/RefundIcon";
+import { RepaymentIcon } from "./svg/RepaymentIcon";
+import { ServerIcon } from "./svg/ServerIcon";
+import { ShieldIcon } from "./svg/ShieldIcon";
+import { ShoppingIcon } from "./svg/ShoppingIcon";
+import { SmokingIcon } from "./svg/SmokingIcon";
+import { SubscriptionsIcon } from "./svg/SubscriptionsIcon";
+import { TaxiIcon } from "./svg/TaxiIcon";
+import { TopupIcon } from "./svg/TopupIcon";
+import { TransferIcon } from "./svg/TransferIcon";
+import { TravelIcon } from "./svg/TravelIcon";
+import { WifiIcon } from "./svg/WifiIcon";
+import { WineIcon } from "./svg/WineIcon";
+
+const icons = {
+	basket: BasketIcon,
+	car: CarIcon,
+	cashWithdrawal: CashWithdrawalIcon,
+	coffee: CoffeeIcon,
+	deposit: DepositIcon,
+	dice: DiceIcon,
+	download: DownloadIcon,
+	education: EducationIcon,
+	grid: GridIcon,
+	growth: GrowthIcon,
+	home: HomeIcon,
+	medical: MedicalIcon,
+	music: MusicIcon,
+	refund: RefundIcon,
+	repayment: RepaymentIcon,
+	server: ServerIcon,
+	shield: ShieldIcon,
+	shopping: ShoppingIcon,
+	smoking: SmokingIcon,
+	subscriptions: SubscriptionsIcon,
+	taxi: TaxiIcon,
+	topup: TopupIcon,
+	transfer: TransferIcon,
+	travel: TravelIcon,
+	wifi: WifiIcon,
+	wine: WineIcon,
+};
+
+type OperationIconProps = {
+	color: string;
+	variant: keyof typeof icons;
+};
+
+const OperationIcon: FC<OperationIconProps> = (props) => {
+	const { color, variant } = props;
+	// eslint-disable-next-line security/detect-object-injection -- Variant is a closed key of the static icon registry.
+	const Icon = icons[variant];
+
+	return <Icon style={{ color: `var(--mantine-color-${color}-7)` }} />;
+};
+
+export { OperationIcon, type OperationIconProps };

packages/icons/src/OperationIcon/svg/BasketIcon.tsx

@@ -0,0 +1,40 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const BasketIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.basket}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 9h18l-2 11H5L3 9Z" pathLength={1} />
+
+			<path d="M8 9l4-6 4 6" pathLength={1} />
+
+			<path d="M9 13v3" pathLength={1} />
+
+			<path d="M15 13v3" pathLength={1} />
+
+			<path d="M10 6a2 2 0 1 0 4 0a2 2 0 1 0-4 0" pathLength={1} />
+		</svg>
+	);
+};
+
+export { BasketIcon };

packages/icons/src/OperationIcon/svg/CarIcon.tsx

@@ -0,0 +1,40 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const CarIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.car}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 16H2v-4l3-1 3-4h6l4 4 4 1v4h-2" pathLength={1} />
+
+			<path d="M8 16h8" pathLength={1} />
+
+			<path d="M6 11h12m-6-4v4" pathLength={1} />
+
+			<path d="M4 16a2 2 0 1 0 4 0a2 2 0 1 0-4 0m2-2v4m-2-2h4" pathLength={1} />
+
+			<path d="M16 16a2 2 0 1 0 4 0a2 2 0 1 0-4 0m2-2v4m-2-2h4" pathLength={1} />
+		</svg>
+	);
+};
+
+export { CarIcon };

packages/icons/src/OperationIcon/svg/CashWithdrawalIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const CashWithdrawalIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 10V3h16v7" pathLength={1} />
+
+			<path d="M7 7h10v14H7V7Z" pathLength={1} />
+
+			<path d="M7 11h10" pathLength={1} />
+
+			<path d="M10 16h4" pathLength={1} />
+		</svg>
+	);
+};
+
+export { CashWithdrawalIcon };

packages/icons/src/OperationIcon/svg/CoffeeIcon.tsx

@@ -0,0 +1,40 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const CoffeeIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.coffee}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 8h12v7a4 4 0 0 1-4 4H8a4 4 0 0 1-4-4V8Z" pathLength={1} />
+
+			<path d="M16 9h2a3 3 0 0 1 0 6h-2" pathLength={1} />
+
+			<path d="M8 6c-2-1 2-2 0-4" pathLength={1} />
+
+			<path d="M12 6c-2-1 2-2 0-4" pathLength={1} />
+
+			<path d="M3 22h15" pathLength={1} />
+		</svg>
+	);
+};
+
+export { CoffeeIcon };

packages/icons/src/OperationIcon/svg/DepositIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const DepositIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.deposit}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M6 9a6 6 0 1 0 12 0a6 6 0 1 0-12 0" pathLength={1} />
+
+			<path d="M10.5 12V6h2a1.5 1.5 0 0 1 0 3h-3m0 1.5h3" pathLength={1} />
+
+			<path d="M4 16c0 4 16 4 16 0" pathLength={1} />
+
+			<path d="M4 19c0 4 16 4 16 0" pathLength={1} />
+		</svg>
+	);
+};
+
+export { DepositIcon };

packages/icons/src/OperationIcon/svg/DiceIcon.tsx

@@ -0,0 +1,42 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const DiceIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2Z" pathLength={1} />
+
+			<path d="M7 7h.01" pathLength={1} />
+
+			<path d="M17 7h.01" pathLength={1} />
+
+			<path d="M12 12h.01" pathLength={1} />
+
+			<path d="M7 17h.01" pathLength={1} />
+
+			<path d="M17 17h.01" pathLength={1} />
+		</svg>
+	);
+};
+
+export { DiceIcon };

packages/icons/src/OperationIcon/svg/DownloadIcon.tsx

@@ -0,0 +1,40 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const DownloadIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 3h18v13H3V3Z" pathLength={1} />
+
+			<path d="M8 21h8" pathLength={1} />
+
+			<path d="M12 16v5" pathLength={1} />
+
+			<path d="M12 6v7" pathLength={1} />
+
+			<path d="M9 10l3 3 3-3" pathLength={1} />
+		</svg>
+	);
+};
+
+export { DownloadIcon };

packages/icons/src/OperationIcon/svg/EducationIcon.tsx

@@ -0,0 +1,36 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const EducationIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M2 8l10-5 10 5-10 5L2 8Z" pathLength={1} />
+
+			<path d="M6 10v7c4 3 8 3 12 0v-7" pathLength={1} />
+
+			<path d="M22 8v9" pathLength={1} />
+		</svg>
+	);
+};
+
+export { EducationIcon };

packages/icons/src/OperationIcon/svg/GridIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const GridIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.grid}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 4h6v6H4V4Z" pathLength={1} />
+
+			<path d="M14 4h6v6h-6V4Z" pathLength={1} />
+
+			<path d="M4 14h6v6H4v-6Z" pathLength={1} />
+
+			<path d="M14 14h6v6h-6v-6Z" pathLength={1} />
+		</svg>
+	);
+};
+
+export { GridIcon };

packages/icons/src/OperationIcon/svg/GrowthIcon.tsx

@@ -0,0 +1,36 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const GrowthIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.growth}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 3v18h18" pathLength={1} />
+
+			<path d="M6 15l5-5 4 3 6-8" pathLength={1} />
+
+			<path d="M16 5h5v5" pathLength={1} />
+		</svg>
+	);
+};
+
+export { GrowthIcon };

packages/icons/src/OperationIcon/svg/HomeIcon.tsx

@@ -0,0 +1,36 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const HomeIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 11l9-8 9 8" pathLength={1} />
+
+			<path d="M5 10v11h14V10" pathLength={1} />
+
+			<path d="M9 21v-8h6v8" pathLength={1} />
+		</svg>
+	);
+};
+
+export { HomeIcon };

packages/icons/src/OperationIcon/svg/MedicalIcon.tsx

@@ -0,0 +1,32 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const MedicalIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M9 3h6v6h6v6h-6v6H9v-6H3V9h6V3Z" pathLength={1} />
+		</svg>
+	);
+};
+
+export { MedicalIcon };

packages/icons/src/OperationIcon/svg/MusicIcon.tsx

@@ -0,0 +1,36 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const MusicIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M9 5v14a3 3 0 1 1-3-3h3" pathLength={1} />
+
+			<path d="M9 5l11-2v14a3 3 0 1 1-3-3h3" pathLength={1} />
+
+			<path d="M9 9l11-2" pathLength={1} />
+		</svg>
+	);
+};
+
+export { MusicIcon };

packages/icons/src/OperationIcon/svg/RefundIcon.tsx

@@ -0,0 +1,34 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const RefundIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M8 4L3 9l5 5" pathLength={1} />
+
+			<path d="M3 9h11a7 7 0 0 1 0 14" pathLength={1} />
+		</svg>
+	);
+};
+
+export { RefundIcon };

packages/icons/src/OperationIcon/svg/RepaymentIcon.tsx

@@ -0,0 +1,36 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const RepaymentIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.repayment}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 5h18v14H3V5Z" pathLength={1} />
+
+			<path d="M3 9h18" pathLength={1} />
+
+			<path d="M10 18v-7h3a2 2 0 0 1 0 4H9m0 1.5h4" pathLength={1} />
+		</svg>
+	);
+};
+
+export { RepaymentIcon };

packages/icons/src/OperationIcon/svg/ServerIcon.tsx

@@ -0,0 +1,42 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const ServerIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.server}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 3h18v7H3V3Z" pathLength={1} />
+
+			<path d="M3 14h18v7H3v-7Z" pathLength={1} />
+
+			<path d="M7 6.5h.01" pathLength={1} />
+
+			<path d="M7 17.5h.01" pathLength={1} />
+
+			<path d="M15 6.5h3" pathLength={1} />
+
+			<path d="M15 17.5h3" pathLength={1} />
+		</svg>
+	);
+};
+
+export { ServerIcon };

packages/icons/src/OperationIcon/svg/ShieldIcon.tsx

@@ -0,0 +1,34 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const ShieldIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M12 2l8 4v6c0 5-8 10-8 10S4 17 4 12V6l8-4Z" pathLength={1} />
+
+			<path d="M8 12l3 3 5-6" pathLength={1} />
+		</svg>
+	);
+};
+
+export { ShieldIcon };

packages/icons/src/OperationIcon/svg/ShoppingIcon.tsx

@@ -0,0 +1,34 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const ShoppingIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M5 7h14l2 14H3L5 7Z" pathLength={1} />
+
+			<path d="M8 8V6a4 4 0 0 1 8 0v2" pathLength={1} />
+		</svg>
+	);
+};
+
+export { ShoppingIcon };

packages/icons/src/OperationIcon/svg/SmokingIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const SmokingIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 14h18v5H3v-5Z" pathLength={1} />
+
+			<path d="M16 14v5" pathLength={1} />
+
+			<path d="M8 10V8c0-2 3-2 3-4V2" pathLength={1} />
+
+			<path d="M15 10V8c0-2 3-2 3-4" pathLength={1} />
+		</svg>
+	);
+};
+
+export { SmokingIcon };

packages/icons/src/OperationIcon/svg/SubscriptionsIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const SubscriptionsIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 10a8 8 0 0 1 13-6l3 3" pathLength={1} />
+
+			<path d="M20 3v4h-4" pathLength={1} />
+
+			<path d="M20 14a8 8 0 0 1-13 6l-3-3" pathLength={1} />
+
+			<path d="M4 21v-4h4" pathLength={1} />
+		</svg>
+	);
+};
+
+export { SubscriptionsIcon };

packages/icons/src/OperationIcon/svg/TaxiIcon.tsx

@@ -0,0 +1,44 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const TaxiIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 10l2-6h12l2 6" pathLength={1} />
+
+			<path d="M3 10h18v8H3v-8Z" pathLength={1} />
+
+			<path d="M6 18v3" pathLength={1} />
+
+			<path d="M18 18v3" pathLength={1} />
+
+			<path d="M6 14h2" pathLength={1} />
+
+			<path d="M16 14h2" pathLength={1} />
+
+			<path d="M10 4V2h4v2" pathLength={1} />
+		</svg>
+	);
+};
+
+export { TaxiIcon };

packages/icons/src/OperationIcon/svg/TopupIcon.tsx

@@ -0,0 +1,36 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const TopupIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.topup}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M20 8V5H5a2 2 0 0 1 0-4h13v4" pathLength={1} />
+
+			<path d="M3 3v16a2 2 0 0 0 2 2h15V8H5" pathLength={1} />
+
+			<path d="M16 12v5m-2.5-2.5h5" pathLength={1} />
+		</svg>
+	);
+};
+
+export { TopupIcon };

packages/icons/src/OperationIcon/svg/TransferIcon.tsx

@@ -0,0 +1,34 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const TransferIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.transfer}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 7h18l-4-4" pathLength={1} />
+
+			<path d="M21 17H3l4 4" pathLength={1} />
+		</svg>
+	);
+};
+
+export { TransferIcon };

packages/icons/src/OperationIcon/svg/TravelIcon.tsx

@@ -0,0 +1,32 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const TravelIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={classes.icon}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M10 3h4v7l7 5v3l-7-3v5l2 1v1l-4-1-4 1v-1l2-1v-5l-7 3v-3l7-5V3Z" pathLength={1} />
+		</svg>
+	);
+};
+
+export { TravelIcon };

packages/icons/src/OperationIcon/svg/WifiIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const WifiIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.wifi}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 7a14 14 0 0 1 18 0" pathLength={1} />
+
+			<path d="M6 11a9 9 0 0 1 12 0" pathLength={1} />
+
+			<path d="M9 15a4 4 0 0 1 6 0" pathLength={1} />
+
+			<path d="M12 19h.01" pathLength={1} />
+		</svg>
+	);
+};
+
+export { WifiIcon };

packages/icons/src/OperationIcon/svg/WineIcon.tsx

@@ -0,0 +1,38 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../../types";
+
+import { bindIconAnimation } from "../../bind-icon-animation";
+import classes from "../OperationIcon.module.css";
+
+const WineIcon: FC<IconProps> = (props) => {
+	const { size = 24, ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			className={`${classes.icon} ${classes.wine}`}
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.6"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M7 3h10v5a5 5 0 0 1-10 0V3Z" pathLength={1} />
+
+			<path d="M7 7h10v1a5 5 0 0 1-10 0V7Z" pathLength={1} />
+
+			<path d="M12 13v8" pathLength={1} />
+
+			<path d="M8 21h8" pathLength={1} />
+		</svg>
+	);
+};
+
+export { WineIcon };

packages/icons/src/bind-icon-animation.test.tsx

@@ -1,36 +1,38 @@
-import { fireEvent, render, waitFor } from "@testing-library/react";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
 import { afterEach, expect, it, vi } from "vitest";
+
 import { bindIconAnimation } from "./bind-icon-animation";
 
 afterEach(() => vi.restoreAllMocks());
 
 it("finishes every delayed part after leaving and does not restart on quick re-entry", async () => {
-	vi.spyOn(window, "matchMedia").mockReturnValue({
+	vi.spyOn(globalThis, "matchMedia").mockReturnValue({
 		matches: true,
 	} as MediaQueryList);
-	const { container, getByRole } = render(
+
+	const { container } = render(
 		<button type="button">
-			<svg ref={bindIconAnimation} aria-hidden="true" />
+			<svg aria-hidden="true" ref={bindIconAnimation} />
 			Category
 		</button>,
 	);
+
+	// eslint-disable-next-line testing-library/no-container, testing-library/no-node-access -- Bind browser animation doubles to the decorative SVG, which has no accessible role.
 	const icon = container.querySelector("svg");
 	if (!icon) throw new Error("Missing icon");
-	const target = getByRole("button");
+	const target = screen.getByRole("button");
 	let finishFirst!: () => void;
 	let finishLast!: () => void;
-	const getAnimations = vi.fn(() => [
+
-		{
+	const getAnimations = vi.fn(() => {
-			finished: new Promise<void>((resolve) => {
+		const first = Promise.withResolvers<void>();
-				finishFirst = resolve;
+		const last = Promise.withResolvers<void>();
-			}),
+		finishFirst = first.resolve;
-		},
+		finishLast = last.resolve;
-		{
+
-			finished: new Promise<void>((resolve) => {
+		return [{ finished: first.promise }, { finished: last.promise }];
-				finishLast = resolve;
+	});
-			}),
+
-		},
-	]);
 	Object.defineProperty(icon, "getAnimations", { value: getAnimations });
 	fireEvent.mouseEnter(target);
 	fireEvent.mouseLeave(target);
@@ -50,18 +52,20 @@ it("finishes every delayed part after leaving and does not restart on quick re-e
 });
 
 it("keeps playing after keyboard blur and releases cancelled animations", async () => {
-	const { container, getByRole, unmount } = render(
+	const { container, unmount } = render(
 		<button type="button">
-			<svg ref={bindIconAnimation} aria-hidden="true" />
+			<svg aria-hidden="true" ref={bindIconAnimation} />
 			Category
 		</button>,
 	);
+
+	// eslint-disable-next-line testing-library/no-container, testing-library/no-node-access -- Bind browser animation doubles to the decorative SVG, which has no accessible role.
 	const icon = container.querySelector("svg");
 	if (!icon) throw new Error("Missing icon");
-	const target = getByRole("button");
+	const target = screen.getByRole("button");
 	// JSDOM does not model the browser keyboard-focus modality.
 	vi.spyOn(target, "matches").mockImplementation(
-		(selector) => selector === ":focus-visible",
+		selector => selector === ":focus-visible",
 	);
 	let cancel!: () => void;
 	Object.defineProperty(icon, "getAnimations", {

packages/icons/src/bind-icon-animation.ts

@@ -1,67 +1,74 @@
 // React ref cleanup keeps native animation lifetimes tied to the mounted icon.
-const bindIconAnimation = (icon: SVGSVGElement | null) => {
+const bindIconAnimation = (icon: null | SVGSVGElement) => {
 	if (!icon) return;
 	const target = icon.closest<HTMLElement>("a, button") ?? icon.parentElement;
 	if (!target) return;
-	let hovered = false;
+	let isHovered = false;
-	let focused = false;
+	let isFocused = false;
-	let running = false;
+	let isRunning = false;
-	let disposed = false;
+	let isDisposed = false;
 
 	const release = () => {
-		if (!running && !hovered && !focused) {
+		if (!isRunning && !isHovered && !isFocused) {
-			icon.removeAttribute("data-icon-animating");
+			delete icon.dataset.iconAnimating;
 		}
 	};
+
 	const start = () => {
-		if (icon.hasAttribute("data-icon-animating")) return;
+		if (Object.hasOwn(icon.dataset, "iconAnimating")) return;
-		icon.setAttribute("data-icon-animating", "");
+		icon.dataset.iconAnimating = "";
-		running = true;
+		isRunning = true;
 		// Includes staggered/delayed children and finite iterations, without timers.
 		const animations = icon.getAnimations({ subtree: true });
 		void Promise.allSettled(
-			animations.map((animation) => animation.finished),
+			animations.map(animation => animation.finished),
 		).then(() => {
-			if (disposed) return;
+			if (isDisposed) return;
-			running = false;
+			isRunning = false;
 			release();
 		});
 	};
+
 	const enter = () => {
-		if (!window.matchMedia("(hover: hover)").matches) return;
+		if (!matchMedia("(hover: hover)").matches) return;
-		hovered = true;
+		isHovered = true;
 		start();
 	};
+
 	const leave = () => {
-		hovered = false;
+		isHovered = false;
 		release();
 	};
+
 	const focus = () => {
-		focused =
+		isFocused
-			target.matches(":focus-visible") ||
+			= target.matches(":focus-visible")
-			!!target.querySelector(":focus-visible");
+				|| !!target.querySelector(":focus-visible");
-		if (focused) start();
+		if (isFocused) start();
 	};
+
 	const blur = (event: FocusEvent) => {
 		if (
-			event.relatedTarget instanceof Node &&
+			event.relatedTarget instanceof Node
-			target.contains(event.relatedTarget)
+			&& target.contains(event.relatedTarget)
 		)
 			return;
-		focused = false;
+		isFocused = false;
 		release();
 	};
+
 	target.addEventListener("mouseenter", enter);
 	target.addEventListener("mouseleave", leave);
 	target.addEventListener("focusin", focus);
 	target.addEventListener("focusout", blur);
+
 	return () => {
-		disposed = true;
+		isDisposed = true;
 		target.removeEventListener("mouseenter", enter);
 		target.removeEventListener("mouseleave", leave);
 		target.removeEventListener("focusin", focus);
 		target.removeEventListener("focusout", blur);
-		icon.removeAttribute("data-icon-animating");
+		delete icon.dataset.iconAnimating;
 	};
 };
 

packages/icons/src/index.ts

@@ -0,0 +1,17 @@
+export {
+	OperationIcon,
+	type OperationIconProps,
+} from "./OperationIcon/OperationIcon";
+export { AddIcon } from "./svg/AddIcon";
+export { BondsIcon } from "./svg/BondsIcon";
+export { CardsIcon } from "./svg/CardsIcon";
+export { CategoriesIcon } from "./svg/CategoriesIcon";
+export { ContactlessIcon } from "./svg/ContactlessIcon";
+export { DeleteIcon } from "./svg/DeleteIcon";
+export { EditIcon } from "./svg/EditIcon";
+export { PortfolioIcon } from "./svg/PortfolioIcon";
+export { RestoreIcon } from "./svg/RestoreIcon";
+export { SettingsIcon } from "./svg/SettingsIcon";
+export { StocksIcon } from "./svg/StocksIcon";
+export { WalletIcon } from "./svg/WalletIcon";
+export type { IconProps } from "./types";

packages/icons/src/navigation.module.css

@@ -1,35 +1,3 @@
-.content {
-	max-width: 1120px;
-	margin-inline: auto;
-}
-
-.header {
-	align-items: center;
-	display: flex;
-	padding: 0 var(--mantine-spacing-md);
-}
-
-.bottomNav {
-	display: none;
-}
-
-.navIcon {
-	display: inline-flex;
-	flex-shrink: 0;
-}
-
-.portfolioIcon {
-	color: var(--mantine-color-blue-7);
-}
-
-.cardsIcon {
-	color: var(--mantine-color-grape-7);
-
-	& svg {
-		overflow: visible;
-	}
-}
-
 .rubles {
 	pointer-events: none;
 	color: var(--mantine-color-green-8);
@@ -55,18 +23,6 @@
 	}
 }
 
-.stocksIcon {
-	color: var(--mantine-color-green-8);
-}
-
-.bondsIcon {
-	color: var(--mantine-color-orange-8);
-}
-
-.settingsIcon {
-	color: var(--mantine-color-gray-7);
-}
-
 .portfolioRuble {
 	stroke: var(--mantine-color-green-8);
 	opacity: 0;
@@ -82,10 +38,6 @@
 }
 
 @media (prefers-reduced-motion: no-preference) {
-	.navLink {
-		transition: background-color 180ms ease-in-out;
-	}
-
 	.drawStroke,
 	.couponLines path {
 		stroke-dasharray: 1;
@@ -225,34 +177,3 @@
 		transform: translateX(var(--slider-offset));
 	}
 }
-
-@media (max-width: 47.99375em) {
-	.bottomNav {
-		background: var(--mantine-color-white);
-		border-top: 1px solid var(--mantine-color-gray-3);
-		bottom: 0;
-		display: flex;
-		justify-content: space-around;
-		left: 0;
-		padding: var(--mantine-spacing-xs) 2px;
-		gap: 2px;
-		font-size: 11px;
-		& a {
-			min-width: 0;
-			padding: 8px 2px;
-			text-align: center;
-		}
-		position: fixed;
-		right: 0;
-		z-index: 200;
-	}
-
-	.active {
-		color: var(--mantine-primary-color-filled);
-		font-weight: 600;
-	}
-
-	.main {
-		padding-bottom: 5rem;
-	}
-}

packages/icons/src/svg/AddIcon.tsx

@@ -0,0 +1,26 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const AddIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M12 5v14 M5 12h14" />
+		</svg>
+	);
+};
+
+export { AddIcon };

packages/icons/src/svg/BondsIcon.tsx

@@ -0,0 +1,39 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+import { bindIconAnimation } from "../bind-icon-animation";
+import classes from "../navigation.module.css";
+
+const BondsIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M6 3h12v18l-3-2-3 2-3-2-3 2V3Z" />
+
+			<g className={classes.couponLines}>
+				<path d="M9 7h6" pathLength={1} />
+
+				<path d="M9 11h6" pathLength={1} />
+
+				<path d="M9 15h3" pathLength={1} />
+			</g>
+		</svg>
+	);
+};
+
+export { BondsIcon };

packages/icons/src/svg/CardsIcon.tsx

@@ -0,0 +1,39 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+import { bindIconAnimation } from "../bind-icon-animation";
+import classes from "../navigation.module.css";
+
+const CardsIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 5h18v14H3V5Zm0 4h18M6 15h4" />
+
+			<g className={classes.rubles}>
+				<path d="M10 12V4h3a2 2 0 0 1 0 4H9m0 2h4" />
+
+				<path d="M10 12V4h3a2 2 0 0 1 0 4H9m0 2h4" />
+
+				<path d="M10 12V4h3a2 2 0 0 1 0 4H9m0 2h4" />
+			</g>
+		</svg>
+	);
+};
+
+export { CardsIcon };

packages/icons/src/svg/CategoriesIcon.tsx

@@ -0,0 +1,27 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const CategoriesIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 3h7v7H3zM14 3h7v7h-7zM3 14h7v7H3zM14 14h7v7h-7z" />
+		</svg>
+	);
+};
+
+export { CategoriesIcon };

packages/icons/src/svg/ContactlessIcon.tsx

@@ -0,0 +1,32 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const ContactlessIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path
+				d="M7 11a8 8 0 0 1 0 8m5-12a15 15 0 0 1 0 16m5-20a23 23 0 0 1 0 24"
+				stroke="currentColor"
+				strokeLinecap="round"
+				strokeWidth="2"
+			/>
+		</svg>
+	);
+};
+
+export { ContactlessIcon };

packages/icons/src/svg/DeleteIcon.tsx

@@ -0,0 +1,27 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const DeleteIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 6h18 M9 6V3h6v3 M5 6l1 15h12l1-15 M10 10v7 M14 10v7" />
+		</svg>
+	);
+};
+
+export { DeleteIcon };

packages/icons/src/svg/EditIcon.tsx

@@ -0,0 +1,27 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const EditIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="m16 3 5 5-12 12-6 1 1-6L16 3Z M13 6l5 5" />
+		</svg>
+	);
+};
+
+export { EditIcon };

packages/icons/src/svg/PortfolioIcon.tsx

@@ -0,0 +1,43 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+import { bindIconAnimation } from "../bind-icon-animation";
+import classes from "../navigation.module.css";
+
+const PortfolioIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 10v9h18v-9" />
+
+			<path className={classes.portfolioHandle} d="M8 6V4h8v2" />
+
+			<path
+				className={classes.portfolioLid}
+				d="M3 10V8a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v2H3Zm6 0v3h6v-3"
+			/>
+
+			<path
+				className={classes.portfolioRuble}
+				d="M10 18v-7h3a2 2 0 0 1 0 4H9m0 1.5h4"
+			/>
+		</svg>
+	);
+};
+
+export { PortfolioIcon };

packages/icons/src/svg/RestoreIcon.tsx

@@ -0,0 +1,27 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const RestoreIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 3h18v4H3z M5 7v14h14V7 M12 17V10m-3 3 3-3 3 3" />
+		</svg>
+	);
+};
+
+export { RestoreIcon };

packages/icons/src/svg/SettingsIcon.tsx

@@ -0,0 +1,35 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+import { bindIconAnimation } from "../bind-icon-animation";
+import classes from "../navigation.module.css";
+
+const SettingsIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M4 7h16M4 17h16" />
+
+			<path className={classes.topSlider} d="M10 4v6h4V4h-4Z" />
+
+			<path className={classes.bottomSlider} d="M10 14v6h4v-6h-4Z" />
+		</svg>
+	);
+};
+
+export { SettingsIcon };

packages/icons/src/svg/StocksIcon.tsx

@@ -0,0 +1,39 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+import { bindIconAnimation } from "../bind-icon-animation";
+import classes from "../navigation.module.css";
+
+const StocksIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			ref={bindIconAnimation}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<path d="M3 3v18h18" />
+
+			<path
+				className={classes.drawStroke}
+				d="M7 14l5-5 4 3 5-7"
+				pathLength={1}
+			/>
+
+			<path className={classes.stockArrow} d="M16 5h5v5" />
+		</svg>
+	);
+};
+
+export { StocksIcon };

packages/icons/src/svg/WalletIcon.tsx

@@ -0,0 +1,29 @@
+import type { FC } from "react";
+
+import type { IconProps } from "../types";
+
+const WalletIcon: FC<IconProps> = (props) => {
+	const { size = "24", ...svgProps } = props;
+
+	return (
+		<svg
+			aria-hidden="true"
+			fill="none"
+			focusable="false"
+			height={size}
+			stroke="currentColor"
+			strokeLinecap="round"
+			strokeLinejoin="round"
+			strokeWidth="1.5"
+			viewBox="0 0 24 24"
+			width={size}
+			{...svgProps}
+		>
+			<rect height="15" rx="3" width="18" x="3" y="5" />
+
+			<path d="M3 9h18M7 15h3M14 5V3H7a4 4 0 0 0-4 4" />
+		</svg>
+	);
+};
+
+export { WalletIcon };

packages/icons/src/types.ts

@@ -0,0 +1,10 @@
+import type { ComponentPropsWithoutRef } from "react";
+
+type IconProps = Omit<
+	ComponentPropsWithoutRef<"svg">,
+	"children" | "dangerouslySetInnerHTML"
+> & {
+	size?: number | string;
+};
+
+export type { IconProps };

packages/icons/tsconfig.json

@@ -0,0 +1,22 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"lib": [
+			"ES2023",
+			"DOM"
+		],
+		"module": "ESNext",
+		"moduleResolution": "Bundler",
+		"declaration": true,
+		"emitDeclarationOnly": true,
+		"rootDir": "src",
+		"outDir": "dist",
+		"jsx": "react-jsx",
+		"types": [
+			"vite/client"
+		]
+	},
+	"include": [
+		"src/index.ts"
+	]
+}

packages/icons/vite.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vite";
+
+export default defineConfig({
+	build: {
+		lib: { entry: "src/index.ts", fileName: "index", formats: ["es"] },
+		rolldownOptions: { external: /^react(\/|$)/ },
+	},
+});

packages/tokens/package.json

@@ -0,0 +1,12 @@
+{
+	"name": "@wealthledger/tokens",
+	"version": "0.3.0",
+	"private": true,
+	"type": "module",
+	"files": [
+		"tokens.json"
+	],
+	"exports": {
+		"./tokens.json": "./tokens.json"
+	}
+}

packages/tokens/tokens.json

@@ -53,7 +53,7 @@
 				"#40c057",
 				"#37b24d",
 				"#2f9e44",
-				"#2b8a3e"
+				"#237032"
 			],
 			"red": [
 				"#fff5f5",
@@ -131,7 +131,7 @@
 			},
 			"muted": {
 				"color": "gray",
-				"shade": 6,
+				"shade": 7,
 				"description": "Вторичный текст; проверяйте контраст при выборе фона"
 			},
 			"border": {
@@ -151,12 +151,12 @@
 			},
 			"positive": {
 				"color": "green",
-				"shade": 6,
+				"shade": 9,
 				"description": "Положительный результат; дополните знаком и текстом"
 			},
 			"negative": {
 				"color": "red",
-				"shade": 6,
+				"shade": 9,
 				"description": "Ошибка / отрицательный результат; дополните текстом"
 			},
 			"warning": {

packages/ui/package.json

@@ -0,0 +1,44 @@
+{
+	"name": "@wealthledger/ui",
+	"version": "0.3.0",
+	"private": true,
+	"type": "module",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./theme": {
+			"types": "./dist/theme.d.ts",
+			"import": "./dist/theme.js"
+		},
+		"./styles.css": "./dist/styles.css"
+	},
+	"sideEffects": [
+		"**/*.css"
+	],
+	"scripts": {
+		"build": "vite build && tsc -p tsconfig.json"
+	},
+	"dependencies": {
+		"@wealthledger/tokens": "0.3.0"
+	},
+	"peerDependencies": {
+		"@mantine/core": "9.6.1",
+		"@mantine/hooks": "9.6.1",
+		"react": "19.3.0",
+		"react-dom": "19.3.0"
+	},
+	"devDependencies": {
+		"@storybook/react-vite": "10.6.0",
+		"@testing-library/react": "16.3.3",
+		"@types/react": "19.3.0",
+		"storybook": "10.6.0",
+		"typescript": "5.9.3",
+		"vite": "8.3.0",
+		"vitest": "5.0.0"
+	}
+}

packages/ui/src/EntryCard/EntryCard.browser.test.tsx

@@ -0,0 +1,38 @@
+import "@mantine/core/styles.css";
+
+import "../styles.css";
+
+import { MantineProvider } from "@mantine/core";
+// eslint-disable-next-line testing-library/no-manual-cleanup -- Vitest globals are disabled, so RTL cannot register its automatic afterEach cleanup.
+import { cleanup, render, screen } from "@testing-library/react";
+import { afterEach, expect, it } from "vitest";
+
+import { cssVariablesResolver, theme } from "../theme";
+import { EntryCard } from "./EntryCard";
+
+afterEach(cleanup);
+
+it("shows the full wrapped title without horizontal overflow", () => {
+	const title = "Дивидендная выплата с очень длинным описанием, которое должно переноситься и оставаться доступным полностью";
+
+	render(
+		<MantineProvider cssVariablesResolver={cssVariablesResolver} theme={theme}>
+			<EntryCard
+				initial="Д"
+				metadata="29.09.2026"
+				title={title}
+				tone="positive"
+				value="123 456 789,90 ₽"
+				valueLabel="Дивиденды"
+				wrap
+			/>
+		</MantineProvider>,
+	);
+
+	const description = screen.getByText(title);
+	expect(description.clientHeight).toBeGreaterThan(0);
+	expect(description.scrollHeight)
+		.toBeLessThanOrEqual(description.clientHeight);
+	expect(document.documentElement.scrollWidth)
+		.toBeLessThanOrEqual(window.innerWidth);
+});

packages/ui/src/EntryCard/EntryCard.module.css

@@ -4,8 +4,8 @@
 	gap: var(--mantine-spacing-sm);
 	align-items: center;
 	padding: var(--mantine-spacing-md);
-	border-color: var(--mantine-color-gray-3);
+	border-color: var(--wl-color-border);
-	background: var(--mantine-color-gray-0);
+	background: var(--wl-color-subtle);
 }
 
 .identity,
@@ -19,15 +19,15 @@
 }
 
 .positive {
-	color: var(--mantine-color-green-6);
+	color: var(--wl-color-positive);
 }
 
 .negative {
-	color: var(--mantine-color-red-6);
+	color: var(--wl-color-negative);
 }
 
 .neutral {
-	color: var(--mantine-color-dimmed);
+	color: var(--mantine-color-gray-7);
 }
 
 @media (max-width: 36em) {
@@ -93,3 +93,13 @@
 		transition: none;
 	}
 }
+
+.row[data-wrap] p {
+	white-space: normal;
+	overflow-wrap: anywhere;
+}
+@media (min-width: 36em) {
+	.row[data-wrap] {
+		grid-template-columns: auto minmax(0, 1fr) minmax(0, 40%);
+	}
+}

packages/ui/src/EntryCard/EntryCard.stories.tsx

@@ -0,0 +1,43 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+
+import { Button } from "@mantine/core";
+import { fn } from "storybook/test";
+
+import { EntryCard } from "./EntryCard";
+
+const meta = {
+	args: {
+		actions: (
+			<Button onClick={fn()} size="compact-sm">
+				Открыть пример
+			</Button>
+		),
+		imageSrc: "data:image/png;base64,invalid",
+		initial: "У",
+		metadata: "22.09.2026 · Синтетические данные",
+		title:
+			"Учебная запись с очень длинным названием для проверки узкого экрана",
+		tone: "negative",
+		value: "−1 250,00 ₽",
+		valueLabel: "Тестовое значение",
+	},
+	component: EntryCard,
+	parameters: {
+		docs: {
+			description: {
+				component:
+					"Готовые строки и slots без финансовых вычислений. Невалидное локальное изображение показывает fallback; действие доступно с клавиатуры и на узком экране. Данные вымышлены.",
+			},
+		},
+	},
+	tags: ["autodocs"],
+	title: "Design System/Components/EntryCard",
+} satisfies Meta<typeof EntryCard>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const LongContentAndFallback: Story = {};
+
+export const WrappedOperation: Story = { args: { value: "−123 456 789 012 345 678,90 ₽", wrap: true } };

packages/ui/src/EntryCard/EntryCard.test.tsx

@@ -0,0 +1,64 @@
+import { MantineProvider } from "@mantine/core";
+import { fireEvent, render, screen } from "@testing-library/react";
+import { assert, describe, expect, it } from "vitest";
+
+import { EntryCard } from "./EntryCard";
+
+describe("EntryCard", () => {
+	it("does not leak a numeric zero from an absent action", () => {
+		render(
+			<MantineProvider>
+				<EntryCard
+					actions={0}
+					initial="У"
+					metadata="Описание"
+					title="Пример"
+					tone="neutral"
+					value="—"
+					valueLabel="Неизвестно"
+				/>
+			</MantineProvider>,
+		);
+		expect(screen.queryByText("0")).not.toBeInTheDocument();
+	});
+	it("keeps a failed image fallback until a new source is supplied", () => {
+		const props = {
+			imageSrc: "data:image/png;base64,invalid",
+			initial: "У",
+			metadata: "Описание",
+			title: "Пример",
+			tone: "neutral" as const,
+			value: "—",
+			valueLabel: "Неизвестно",
+		};
+
+		const { rerender } = render(
+			<MantineProvider>
+				<EntryCard {...props} />
+			</MantineProvider>,
+		);
+
+		// Decorative image has no accessible name; trigger its actual failure event.
+		const image = screen.queryByAltText("");
+		assert(image);
+		fireEvent.error(image);
+		rerender(
+			<MantineProvider>
+				<EntryCard {...props} title="Обновлённый пример" />
+			</MantineProvider>,
+		);
+		expect(screen.queryByAltText("")).not.toBeInTheDocument();
+		expect(screen.getByText("У")).toBeInTheDocument();
+		expect(screen.getByText("Обновлённый пример")).toBeInTheDocument();
+		rerender(
+			<MantineProvider>
+				<EntryCard {...props} imageSrc="/replacement-logo.png" />
+			</MantineProvider>,
+		);
+		expect(screen.queryByAltText("")).toHaveAttribute(
+			"src",
+			"/replacement-logo.png",
+		);
+		expect(screen.queryByText("У")).not.toBeInTheDocument();
+	});
+});

packages/ui/src/EntryCard/EntryCard.tsx

@@ -1,66 +1,78 @@
+import type { FC, ReactNode } from "react";
+
 import { Avatar, Paper, Stack, Text } from "@mantine/core";
-import { type FC, type ReactNode, useState } from "react";
+
 import classes from "./EntryCard.module.css";
 
 type EntryCardProps = {
-	title: string;
-	metadata: string;
-	details?: ReactNode;
 	actions?: ReactNode;
-	initial: string;
-	icon?: ReactNode;
 	color?: string;
-	imageSrc?: string | null;
+	details?: ReactNode;
+	icon?: ReactNode;
+	imageSrc?: null | string;
+	initial: string;
+	metadata: string;
+	title: string;
+	tone: "negative"
+		| "neutral"
+		| "positive";
 	value: string;
 	valueLabel: string;
-	tone: "positive" | "negative" | "neutral";
+	wrap?: boolean;
 };
 
 const EntryCard: FC<EntryCardProps> = (props) => {
-	const [imageFailed, setImageFailed] = useState(false);
+	const surfaceStyle = props.color
+		? {
+				background: `color-mix(in srgb, var(--mantine-color-${props.color}-0) 45%, var(--wl-color-surface))`,
+			}
+		: undefined;
+
+	const titleLineClamp = props.wrap ? undefined : 1;
+
+	const valueContainerClass = props.actions ? classes.valueFooter : undefined;
+	const valueLabelClass = `${classes[props.tone]} ${props.actions ? classes.valueLabel : ""}`;
+
 	return (
 		<Paper
 			className={classes.row}
+			data-wrap={props.wrap || undefined}
+			style={surfaceStyle}
 			withBorder
-			style={
-				props.color
-					? {
-							background: `color-mix(in srgb, var(--mantine-color-${props.color}-0) 45%, white)`,
-						}
-					: undefined
-			}
 		>
 			<Avatar
 				alt=""
 				aria-hidden="true"
 				radius="md"
 				size={40}
-				src={imageFailed ? null : props.imageSrc}
+				src={props.imageSrc}
-				onError={() => setImageFailed(true)}
 			>
 				{props.icon ?? props.initial}
 			</Avatar>
+
 			<Stack className={classes.identity} gap={2}>
-				<Text fw={700} lineClamp={1}>
+				<Text fw={700} lineClamp={titleLineClamp}>
 					{props.title}
 				</Text>
+
 				<Text c="dimmed" size="sm">
 					{props.metadata}
 				</Text>
+
 				{props.details}
 			</Stack>
+
 			<Stack className={classes.value} gap={2}>
 				<Text className={classes[props.tone]} fw={700}>
 					{props.value}
 				</Text>
-				<div className={props.actions ? classes.valueFooter : undefined}>
+
-					<Text
+				<div className={valueContainerClass}>
-						className={`${classes[props.tone]} ${props.actions ? classes.valueLabel : ""}`}
+					<Text className={valueLabelClass} size="sm">
-						size="sm"
-					>
 						{props.valueLabel}
 					</Text>
-					{props.actions && (
+
+					{Boolean(props.actions) && (
 						<div className={classes.actions}>{props.actions}</div>
 					)}
 				</div>

packages/ui/src/LoadingSkeleton/LoadingSkeleton.stories.tsx

@@ -1,16 +1,16 @@
-import { Paper, Skeleton } from "@mantine/core";
 import type { Meta, StoryObj } from "@storybook/react-vite";
+
+import { Paper, Skeleton } from "@mantine/core";
+
 import { LoadingSkeleton } from "./LoadingSkeleton";
 
 const meta = {
-	title: "Design System/Components/LoadingSkeleton",
-	component: LoadingSkeleton,
-	tags: ["autodocs"],
 	args: { label: "Загрузка содержимого" },
 	argTypes: {
-		label: { control: "text" },
 		children: { table: { disable: true } },
+		label: { control: "text" },
 	},
+	component: LoadingSkeleton,
 	parameters: {
 		docs: {
 			description: {
@@ -19,17 +19,23 @@ const meta = {
 			},
 		},
 	},
-	render: (args) => (
+	render: arguments_ => (
 		<Paper p="md" withBorder>
-			<LoadingSkeleton {...args}>
+			<LoadingSkeleton {...arguments_}>
 				<Skeleton h={24} w="60%" />
+
 				<Skeleton h={72} />
+
 				<Skeleton h={16} w="80%" />
 			</LoadingSkeleton>
 		</Paper>
 	),
+	tags: ["autodocs"],
+	title: "Design System/Components/LoadingSkeleton",
 } satisfies Meta<typeof LoadingSkeleton>;
 
 export default meta;
+
 type Story = StoryObj<typeof meta>;
+
 export const Initial: Story = { name: "Загрузка области" };

packages/ui/src/LoadingSkeleton/LoadingSkeleton.tsx

@@ -1,6 +1,7 @@
-import { Stack } from "@mantine/core";
 import type { FC, PropsWithChildren } from "react";
 
+import { Stack } from "@mantine/core";
+
 type LoadingSkeletonProps = PropsWithChildren<{
 	label: string;
 }>;

packages/ui/src/StateView/StateView.stories.tsx

@@ -1,36 +1,36 @@
-import { Button } from "@mantine/core";
 import type { Meta, StoryObj } from "@storybook/react-vite";
 import type { ComponentProps } from "react";
+
+import { Button } from "@mantine/core";
 import { fn } from "storybook/test";
+
 import { StateView } from "./StateView";
 
-type StateStoryArgs = ComponentProps<typeof StateView> & {
+type StateStoryArguments = ComponentProps<typeof StateView> & {
-	withAction: boolean;
 	onAction: () => void;
+	withAction: boolean;
 };
 
 const meta = {
-	title: "Design System/Components/StateView",
-	component: StateView,
-	tags: ["autodocs"],
 	args: {
-		title: "Нет учебных данных",
-		text: "Синтетическое пустое состояние. Пользовательские данные не загружаются.",
 		error: false,
-		withAction: false,
 		onAction: fn(),
+		text: "Синтетическое пустое состояние. Пользовательские данные не загружаются.",
+		title: "Нет учебных данных",
+		withAction: false,
 	},
 	argTypes: {
-		title: { control: "text" },
-		text: { control: "text" },
-		error: { control: "boolean" },
 		action: { table: { disable: true } },
+		error: { control: "boolean" },
+		onAction: { control: false },
+		text: { control: "text" },
+		title: { control: "text" },
 		withAction: {
 			control: "boolean",
 			description: "Показать необязательное действие StateView",
 		},
-		onAction: { control: false },
 	},
+	component: StateView,
 	parameters: {
 		docs: {
 			description: {
@@ -39,40 +39,46 @@ const meta = {
 			},
 		},
 	},
-	render: (args) => {
+	render: (arguments_) => {
-		const { withAction, onAction, ...stateProps } = args;
+		const { onAction, withAction, ...stateProps } = arguments_;
+
 		return (
 			<StateView
 				{...stateProps}
 				action={
-					withAction ? (
+					withAction
-						<Button onClick={onAction} variant="default">
+						? (
-							{args.error ? "Повторить локально" : "Выполнить пример"}
+								<Button onClick={onAction} variant="default">
-						</Button>
+									{arguments_.error ? "Повторить локально" : "Выполнить пример"}
-					) : undefined
+								</Button>
+							)
+						: undefined
 				}
 			/>
 		);
 	},
-} satisfies Meta<StateStoryArgs>;
+	tags: ["autodocs"],
+	title: "Design System/Components/StateView",
+} satisfies Meta<StateStoryArguments>;
 
 export default meta;
 
 type Story = StoryObj<typeof meta>;
+
 export const Empty: Story = { name: "Пустое состояние" };
 export const EmptyWithAction: Story = {
-	name: "Пустое состояние с действием",
 	args: { withAction: true },
+	name: "Пустое состояние с действием",
 };
 export const Failed: Story = {
-	name: "Ошибка",
 	args: {
 		error: true,
-		title: "Учебная ошибка",
 		text: "Демонстрация недоступных данных без вызова API.",
+		title: "Учебная ошибка",
 	},
+	name: "Ошибка",
 };
 export const ErrorWithAction: Story = {
-	name: "Ошибка с retry",
 	args: { ...Failed.args, withAction: true },
+	name: "Ошибка с retry",
 };

packages/ui/src/StateView/StateView.test.tsx

@@ -1,7 +1,8 @@
 import { MantineProvider } from "@mantine/core";
 import { render, screen } from "@testing-library/react";
 import { describe, expect, it } from "vitest";
-import { LoadingSkeleton } from "./LoadingSkeleton";
+
+import { LoadingSkeleton } from "../LoadingSkeleton/LoadingSkeleton";
 import { StateView } from "./StateView";
 
 describe("StateView", () => {