@backtest-kit/ui 13.5.0 → 14.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 # 📊 @backtest-kit/ui
 
-> Full-stack UI framework for visualizing cryptocurrency trading signals, backtests, and real-time market data. Combines a Node.js backend server with a React dashboard - all in one package.
+> The web cockpit for [backtest-kit](https://www.npmjs.com/package/backtest-kit). A self-hosted dashboard that turns a running backtest or live session into screens you can read: portfolio cards, KPI boards, candlestick charts with signal overlays, a notification feed, a strategy heatmap, markdown reports, a dump-file explorer, a live manual-control panel, and an in-browser Pine Script editor.
 
 ![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot16.png)
 
@@ -14,241 +14,260 @@ Interactive dashboard for backtest-kit with signal visualization, candle charts,
 
 📚 **[Backtest Kit Docs](https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html)** | 🌟 **[GitHub](https://github.com/tripolskypetr/backtest-kit)**
 
-> **New to backtest-kit?** The fastest way to get a real, production-ready setup is to clone the [reference implementation](https://github.com/tripolskypetr/backtest-kit/tree/master/example) — a fully working news-sentiment AI trading system with LLM forecasting, multi-timeframe data, and a documented February 2026 backtest. Start there instead of from scratch.
+> **New here?** The fastest real setup is to clone the [reference implementation](https://github.com/tripolskypetr/backtest-kit/tree/master/example) — a working news-sentiment AI trading system with LLM forecasting, multi-timeframe data, and a documented February 2026 backtest. Start there, not from scratch.
 
-## ✨ Features
+```bash
+npm install @backtest-kit/ui backtest-kit
+```
 
-- 📈 **Interactive Charts**: Candlestick visualization with Lightweight Charts (1m, 15m, 1h timeframes)
-- 🎯 **Signal Tracking**: View opened, closed, scheduled, and cancelled signals with full details
-- 📊 **Risk Analysis**: Monitor risk rejections and position management
-- 🔔 **Notifications**: Real-time notification system for all trading events
-- 💹 **Trailing & Breakeven**: Visualize trailing stop/take and breakeven events
-- 🌐 **Multi-Exchange**: Support for 100+ exchanges via CCXT integration
-- 🎨 **Material Design**: Beautiful UI with MUI 5 and Mantine components
-- 🌍 **i18n Ready**: Internationalization support built-in
+```typescript
+import { serve } from "@backtest-kit/ui";
+serve("0.0.0.0", 60050); // → http://localhost:60050
+```
 
-## 📋 What It Does
+One call boots the server and serves the dashboard. Everything below describes **what each screen shows you** — the layout, the data on it, and what you can do there.
 
-`@backtest-kit/ui` provides both backend API and frontend dashboard:
+---
 
-| Component | Description |
-|-----------|-------------|
-| **`serve()`** | Start HTTP server with REST API endpoints |
-| **`getRouter()`** | Get expressjs-compatible router for custom middleware integration |
+## The shell
 
-## 🚀 Installation
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot19.png)
 
-```bash
-npm install @backtest-kit/ui backtest-kit ccxt
-```
+Every page sits inside a common frame: a top **app bar** with the logo (click to toggle home), a horizontally-scrollable row of section tabs, a live **notification bell**, a fullscreen toggle, and a GitHub link. A thin **progress bar** under the app bar animates whenever a screen is loading data. Below the bar, most screens open with a **breadcrumb strip** (Main › Section › …) that doubles as the action bar — refresh, download, print, and mode-switch buttons live there.
 
-## 📖 Usage
+The home screen (`/main`) is a **launchpad**: three labelled groups of large colored tiles, each tile a doorway to one section, with a status banner up top summarizing the engine. The groups:
 
-### Quick Start - Launch Dashboard
+- **Application** — Portfolio Overview, PNL Performance, System Logs
+- **Live** — Notifications, Pending Status, Dump Explorer
+- **Other** — Markdown Reports, Price Charts, Heatmap
 
-```typescript
-import { serve } from '@backtest-kit/ui';
+---
 
-// Start the UI server
-serve('0.0.0.0', 60050);
+## Portfolio Overview — `/overview`
 
-// Dashboard available at http://localhost:60050
-```
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot1.png)
 
-### Custom Logger Integration
+Closed trading signals, grouped by symbol, split across **Backtest** and **Live** tabs at the top.
 
-```typescript
-import { setLogger } from '@backtest-kit/ui';
+<details>
+<summary>What's on the page</summary>
 
-setLogger({
-  log: (msg) => console.log(`[UI] ${msg}`),
-  warn: (msg) => console.warn(`[UI] ${msg}`),
-  error: (msg) => console.error(`[UI] ${msg}`),
-});
-```
+Each symbol gets a section of cards; every card is one closed signal showing position type (long/short), entry price, take-profit and stop-loss levels, and the realized **PNL in both amount and percent**. Where a position used dollar-cost averaging or partial closes, the card displays the **DCA entry count** and **partial-close count**. A Backtest/Live tab toggle switches the dataset; the list supports **JSON export** and manual refresh. Layout is a scrollable tabbed container with a decorative background.
 
-## 📐 Dashboard Revenue Math
+</details>
 
-The **Revenue** metrics on the dashboard are calculated in **dollar terms** by summing the `pnlCost` field from all closed signals within each time window.
+## PNL Performance (Dashboard) — `/dashboard` · `/dashboard/:mode`
 
-### Dollar PnL formula
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot13.png)
 
-```
-revenue[window] = Σ signal.pnl.pnlCost   (for all closed signals in that window)
-```
+The KPI board. Aggregates trading performance **across all symbols** for the chosen mode.
 
-`pnlCost` is computed by the backend (`toProfitLossDto`) as:
+<details>
+<summary>What's on the page</summary>
 
-```
-pnlCost = (pnlPercentage / 100) × pnlEntries
-```
+Inside a breadcrumb header (`KPI BACKTEST` / `KPI LIVE`) the body is a declarative field grid (`dashboard_fields`) of live widgets fed by four aggregated measures pulled per-symbol and summed:
 
-| Field | Source | Description |
-|-------|--------|-------------|
-| `pnl.pnlCost` | `IStorageSignalRow` | Absolute P&L in USD — the only value summed for revenue |
-| `pnl.pnlPercentage` | `IStorageSignalRow` | Percentage P&L (accounts for DCA-weighted entry price, slippage, and fees) |
-| `pnl.pnlEntries` | `IStorageSignalRow` | Total invested capital in USD — sum of all entry costs (`Σ entry.cost`) |
+- **Four revenue cards** (`SingleValueWidget`) — Today / Yesterday / 7 days / 31 days, each showing profit in USDT with a trade-count caption, **color-coded** red (loss) / green (profit) / orange (flat).
+- **Trade-performance donut** (`SpeedDonutWidget`) — Failed vs. Successful vs. Total signal counts.
+- **Daily-trades chart** (`ChartWidget`) — a per-day series of total / resolved / rejected trades.
+- **Success-rate panel** (`SuccessRateWidget`) — per symbol (icon + display name), broken into take-profit / stop-loss / close-resolved / close-rejected counts.
+- **Signal grid** (`SignalGridWidget`) — the paginated signal table for the active mode.
 
-**Example** (1 DCA entry at $100, position closed +5%):
+The breadcrumb actions: **Download** (exports the raw signals as a timestamped JSON blob), **Switch to LIVE / BACKTEST** (jumps between modes), and **Refresh manually** (clears the signal cache and reloads). A modal loader covers the board while it recomputes.
 
-| DCA entries | `pnlEntries` | `pnlPercentage` | `pnlCost` |
-|:-----------:|-------------:|----------------:|----------:|
-| 1 | $100 | 5 % | +$5.00 |
-| 2 | $200 | 5 % | +$10.00 |
-| 3 | $300 | 5 % | +$15.00 |
+</details>
 
-### Time windows
+## System Logs — `/logs`
 
-The anchor point depends on execution mode:
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot14.png)
 
-- **Backtest mode** — latest `updatedAt` across all closed signals (time windows are relative to the end of the run)
-- **Live mode** — `Date.now()` (wall-clock time)
+A virtualized, filterable feed of the engine's runtime log.
 
-| Window | Range |
-|--------|-------|
-| Today | `>= startOf(anchorDay)` |
-| Yesterday | `[anchorDay − 1d, anchorDay)` |
-| 7 days | `>= anchorDay − 7d` |
-| 31 days | `>= anchorDay − 31d` |
+<details>
+<summary>What's on the page</summary>
 
-Revenue and signal count are tracked separately for each window and aggregated across all symbols on the Dashboard.
+Each entry is a row with a **type badge** (Debug / Info / Warn / Log), the log **topic**, a **timestamp**, and the raw JSON arguments rendered in monospace. A search prompt filters by **keyword or regex**. The whole log exports as a JSON file. Virtualized so it stays smooth over very long histories.
 
-## 📐 Position PNL Math
+</details>
 
-### Effective entry price (DCA-weighted)
+## Notifications — `/notifications`
 
-When multiple DCA entries exist, the effective open price is a **cost-weighted harmonic mean**:
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot46.png)
 
-```
-effectivePrice = Σcost / Σ(cost / price)
-```
+The event feed for the entire signal lifecycle.
 
-This is the correct formula for fixed-dollar entries (not simple average), because buying $100 worth at different prices gives different coin quantities.
+<details>
+<summary>What's on the page</summary>
 
-### Partial closes (PP/PL)
+Color-coded cards, one per event — **opens, closes, schedules, errors** — each showing symbol, position, PNL, and the entry / exit / TP / SL prices. **Infinite-scroll** pagination loads more as you go; clicking a card opens a **detailed modal** for that event. Manual refresh pulls the latest activity. The same notifications drive the bell badge in the app bar.
 
-Each partial stores a `costBasisAtClose` snapshot — the running dollar cost-basis **before** that partial fired. This avoids replaying the full entry history on every call.
+</details>
 
-**Cost-basis replay:**
+## Pending Status — `/status` → `/status/:id` → `/status/:id/control`
 
-```
-for each partial[i]:
-    closedDollar      += (percent[i] / 100) × costBasisAtClose[i]
-    remainingCostBasis = costBasisAtClose[i] × (1 - percent[i] / 100)
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot18.png)
 
-# DCA entries added AFTER the last partial are appended:
-remainingCostBasis += Σ entry.cost for entries[lastEntryCount..]
+A three-level drill-down for *live* positions: list → detail → manual control.
 
-totalClosedPercent = closedDollar / totalInvested × 100
-```
+<details>
+<summary>What's on the page</summary>
 
-**Effective price through partials** is computed iteratively so that a partial sell does not change the entry price of the remaining coins:
+**List (`/status`)** — active signals grouped by strategy, rendered as a grid of strategy buttons; click one to inspect it.
 
-```
-# partial[0]:
-  effPrice = costBasisAtClose[0] / Σ(cost/price for entries[0..cnt[0]])
-
-# partial[j]:
-  remainingCB = prev.costBasisAtClose × (1 - prev.percent / 100)
-  oldCoins    = remainingCB / effPrice        ← coins still held
-  newCoins    = Σ(cost/price for DCA entries between j-1 and j)
-  effPrice    = (remainingCB + newCost) / (oldCoins + newCoins)
-```
+**Detail (`/status/:id`)** — the full state of one pending signal as a structured field view (`status_fields`): entry, exit, effective (blended) price, DCA entry count and partial-close count, and live PnL. Header actions: **Manual Control**, **Print** (renders the signal's fields to a downloadable PDF/markdown), **Download** (JSON), **Refresh**. Empty states read *"Loading…"* or *"No pending signal."*
 
-### toProfitLossDto — weighted PNL with slippage & fees
+**Manual Control (`/status/:id/control`)** — an operator panel (`RecordView`, expand-all) where you intervene in a live position by hand through four **multi-step wizard modals**: **Open Pending**, **Average Buy**, **Close Pending**, and **Breakeven**. Each is launched from the panel via an emitter, walks you through *Briefing → Input → Submit*, fires the commit, and reloads the record. Export to JSON is available. (See **The modal system** below for how these are built.)
 
-**Without partials:**
+</details>
 
-```
-priceOpenSlip  = effectivePrice × (1 ± slippage)
-priceCloseSlip = priceClose     × (1 ∓ slippage)
+## Markdown Reports — `/report`
 
-pnlPercentage = (priceCloseSlip - priceOpenSlip) / priceOpenSlip × 100
-fee           = CC_PERCENT_FEE × (1 + priceCloseSlip / priceOpenSlip)
-pnlPercentage -= fee
-```
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot20.png)
 
-**With partials — dollar-weighted sum:**
+Rendered strategy-performance reports for Backtest and Live runs.
 
-```
-weight[i] = (percent[i] / 100 × costBasisAtClose[i]) / totalInvested
+<details>
+<summary>What's on the page</summary>
 
-totalWeightedPnl = Σ weight[i] × pnl[i]           # each partial at its own effectivePrice
-                 + remainingWeight × pnlRemaining   # rest closed at final priceClose
+A grid of strategy buttons, **grouped by type and sorted by signal volume**; selecting one renders its markdown report inline. Each report downloads as **markdown, PDF, or raw JSON**. Manual refresh regenerates the content. This is the human-facing view of the engine's analytics (strategy / breakeven / risk / partial / drawdown / schedule / performance / sync reports).
 
-fee = CC_PERCENT_FEE                                              # open (once)
-    + Σ CC_PERCENT_FEE × weight[i] × (closeSlip[i] / openSlip[i])  # per partial
-    + CC_PERCENT_FEE × remainingWeight × (closeSlip / openSlip)     # final close
+</details>
 
-pnlPercentage = totalWeightedPnl - fee
-pnlCost       = pnlPercentage / 100 × totalInvested
-```
+## Price Charts — `/price_chart` → `/price_chart/:symbol` → `/price_chart/:symbol/:interval`
 
-| Field | Description |
-|-------|-------------|
-| `totalInvested` | `Σ entry.cost` (or `CC_POSITION_ENTRY_COST` if no `_entry`) |
-| `weight[i]` | Real dollar share of each partial relative to `totalInvested` |
-| `effectivePrice` at partial `i` | Computed via iterative `costBasisAtClose` replay up to `partials[i]` |
-| `priceOpen` in result | `getEffectivePriceOpen(signal)` — DCA-weighted harmonic mean across all entries |
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot33.png)
 
-## 🖥️ Dashboard Views
+Interactive candlesticks powered by TradingView Lightweight Charts.
 
-The frontend provides specialized views for different trading events:
+<details>
+<summary>What's on the page</summary>
 
-| View | Description |
-|------|-------------|
-| **Signal Opened** | Entry details with chart visualization |
-| **Signal Closed** | Exit details with PnL analysis |
-| **Signal Scheduled** | Pending orders awaiting activation |
-| **Signal Cancelled** | Cancelled orders with reasons |
-| **Risk Rejection** | Signals rejected by risk management |
-| **Partial Profit/Loss** | Partial position closures |
-| **Trailing Stop/Take** | Trailing adjustments visualization |
-| **Breakeven** | Breakeven level adjustments |
+You navigate **by symbol, then by interval** (1m / 15m / 1h) to view price history. The chart overlays the active signal's lines: **entry**, **take-profit (green)**, and **stop-loss (red)**. Supports chart-image export and clicking through to signal detail. Built on the shared `ChartWidget`.
 
-Each view includes:
-- 📋 Detailed information form
-- 📈 1m, 15m, 1h candlestick charts
-- 📥 JSON export for all data
+</details>
 
-## 💡 Why Use @backtest-kit/ui?
+## Heatmap — `/heat`
 
-Instead of building custom dashboards:
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot31.png)
 
-**Without backtest-kit**
+A color-coded performance matrix across every tracked symbol.
 
-```typescript
-// ❌ Without @backtest-kit/ui
-// Build your own React app
-// Implement chart components
-// Create signal visualization
-// Handle notifications
-// Write API endpoints
-// ... weeks of development
-```
+<details>
+<summary>What's on the page</summary>
 
-**With backtest-kit**
+Cells are colored by performance; each shows **win rate, profit factor, Sharpe ratio** and other aggregated metrics per symbol. The whole heatmap exports as **JSON, markdown report, or PDF**, with manual refresh to recalculate the statistics. (The same heat report download lives on the home screen's action bar.)
 
-```typescript
-// ✅ With @backtest-kit/ui
-import { serve } from '@backtest-kit/ui';
+</details>
 
-serve(); // Full dashboard ready!
-```
+## Dump Explorer — `/dump` · `/dump/:search`
+
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot12.png)
+
+A file browser for everything the engine wrote to disk.
+
+<details>
+<summary>What's on the page</summary>
+
+A **tree-structured** browser of backtest output and artifact files. Icons mark file type — image, JSON, plain text, or generic. Clicking a file opens a **full-screen preview modal**. Keyword search filters the tree; manual refresh rebuilds it. Backed by the `FileTreeWidget`.
+
+</details>
+
+## About & Setup — `/about` · `/about/setup`
+
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot36.png)
+
+Framework information (`/about`) and a **Setup** view (`/about/setup`) showing the resolved configuration / environment of the running instance.
+
+---
+
+## Widgets — the reusable pieces screens are built from
+
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot8.png)
+
+<details>
+<summary>The building blocks</summary>
+
+- **ChartWidget** — Lightweight Charts candlestick/line rendering with signal overlays (Price Charts, signal detail).
+- **SignalGridWidget** — the paginated signal table (offset pagination + async item iterator).
+- **StatusWidget** — live workload status tiles.
+- **SuccessRateWidget** / **SpeedDonutWidget** — donut gauges for win-rate and throughput.
+- **SingleValueWidget** / **IndicatorValueWidget** — single-KPI and indicator-value cards.
+- **AveragingWidget** — DCA-ladder / effective-price visualization.
+- **PartialWidget** — partial-close breakdown.
+- **FileTreeWidget** — the dump-explorer tree.
+
+Shared chrome lives in `components/common/`: `AppHeader`, a `Markdown` renderer, the `CodeEditor`, `NotificationView`, `Tooltip`, `IconPhoto`, `ErrorView`, decorative `Background` / `BottomImage`. Providers (`AlertProvider`, `ErrorProvider`, `LayoutModalProvider`, `StatusInfo`, `Translate`) wrap the app for alerts, error boundaries, modal stacking, the status banner, and i18n.
+
+</details>
+
+## The modal system — a window manager with navigation history
+
+![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot26.png)
+
+The dashboard is, at its core, a **modal window manager**. Two complementary mechanisms sit on top of [react-declarative](https://github.com/react-declarative)'s `useModalManager` / `useWizardModal`, both of which keep their own **navigation history** so modals stack, go back, and close as a managed stack rather than ad-hoc dialogs.
+
+### 1. Global modal registry — tabbed detail modals on a managed stack
+
+One provider wraps the whole app and registers **~25 detail modals** — one per signal-lifecycle event and commit type — each wired to a `layoutService` subject. Anywhere in the app, pushing to a subject (e.g. `pickSignalSubject.next(signal)`) `push`es the matching modal onto the **managed stack**; because the stack tracks depth, opening a modal *from inside* another (e.g. clicking a related signal) stacks it, and the title-bar **Back** arrow `pop`s you to the previous one. `closeModalSubject` / `ctx.clear()` tears the whole stack down centrally. The provider also hosts global **prompt**, **alert**, and **document-download/preview** (`useOpenDocument`) flows.
+
+These are the modals that open when you click a notification card, a signal in a grid, or a risk event — every point in a position's life has a dedicated, fielded modal, each with the same Back / Print / Search / Copy / **ActionMenu** / Close title bar and the same StockChart candle tabs.
+
+<details>
+<summary>What's registered (every modal hook)</summary>
+
+Each hook below is a `pick*` opener subscribed to its `layoutService.pick*Subject`; the hook renders a modal that displays the event's DTO through its `assets/*_fields.tsx` schema, inside the tabbed shell + `<ActionMenu />` title bar described above:
+
+| Hook | Opens a modal for |
+|---|---|
+| `useSignalView` | a generic signal (`signal_fields`) |
+| `useRiskView` | a risk rejection (`risk_fields`) |
+| `useSignalOpenedView` / `useSignalClosedView` / `useSignalScheduledView` / `useSignalCancelledView` | the four signal-notification kinds |
+| `useSignalNotifyView` | an info notification |
+| `useSignalSyncOpenView` / `useSignalSyncCloseView` | broker-sync open/close |
+| `useActivateScheduledView` | a scheduled signal activating |
+| `useAverageBuyCommitView` | a DCA-rung commit |
+| `useClosePendingView` / `useCancelScheduledView` | close / cancel commits |
+| `usePartialProfitAvailableView` / `usePartialProfitCommitView` | partial-profit available + committed |
+| `usePartialLossAvailableView` / `usePartialLossCommitView` | partial-loss available + committed |
+| `useBreakevenAvailableView` / `useBreakevenCommitView` | breakeven available + committed |
+| `useTrailingStopView` / `useTrailingTakeView` | trailing stop / take |
+| `useDumpContentView` | a dump-file preview |
+
+These are the modals that open when you click a notification card, a signal in a grid, or a risk event — every point in a position's life has a dedicated, fielded modal, each with the same Back / Print / Search / Copy / **ActionMenu** / Close title bar.
+
+</details>
+
+### 2. Manual-control wizard modals (per-operation, own history)
+
+The four operations on the Manual Control screen are **multi-step wizards**, each built with `useWizardModal` over a private `createMemoryHistory()` — so each modal has its *own* back/forward navigation through three routed steps.
+
+<details>
+<summary>The wizard anatomy (shared by all four)</summary>
+
+Folders: `useOpenPendingModal`, `useAverageBuyModal`, `useClosePendingModal`, `useBreakevenModal`. Each contains `useXModal.tsx` (the `useWizardModal` config — title, fullscreen size request, close button, `onSubmit` → reload), `routes.tsx` (three `IWizardModal` routes), `steps.ts` (the stepper labels), `view/{BriefView,FormView,SubmitView}.tsx`, and `components/StatusCard.tsx`. The page (`ControlView`) subscribes to four emitters (`commitOpenPendingEmitter`, `commitAverageBuyEmitter`, `commitClosePendingEmitter`, `commitBreakevenEmitter`) and calls `pickData()` to launch the matching wizard.
+
+The three steps (Open Position example):
+
+1. **Brief** — fetches and shows the symbol + current effective price (`controlViewService.getAveragePrice`) with a *"verify the symbol AND the price"* warning. `Next → /form`, `Close` dismisses.
+2. **Form** — collects direction (long/short), amount in USDT, and a note; **live-computes coin quantity** = amount ÷ price as a read-only field; warns that the position opens *immediately*. `Back → /brief`, `Next → /submit`.
+3. **Submit** — fires the commit (`controlViewService.commitOpenPending` / `commitAverageBuy` / `commitClosePending` / `commitBreakeven`) and shows a `StatusCard` in **loading → success / error** state; `Close` finalizes (`beginSave`) and the underlying record reloads.
+
+Average Buy, Close Pending, and Breakeven follow the same Brief→Form→Submit shape with operation-specific form fields and StatusCard copy.
+
+</details>
 
-**Benefits:**
+## Field schemas (`assets/*_fields.tsx`) — every DTO rendered as a real form
 
-- 📊 Production-ready trading dashboard out of the box
-- 📈 Professional chart visualization with price lines and markers
-- 🔔 Complete notification system for all trading events
-- 🎨 Beautiful Material Design interface
-- ⚡ Fast development - focus on strategy, not UI
-- 🛡️ Full TypeScript support
+The 24 files in `assets/` are the **declarative field schemas** that drive both the detail pages and every modal above. Each exports a default `TypedField[]` array (react-declarative), so a DTO is shown with typed, labeled, validated, grouped fields — and, where useful, live widgets — instead of a raw JSON dump. Nothing in a signal's life is hidden from the operator.
 
-## 🤝 Contribute
+<details>
+<summary>The schemas and who imports them</summary>
 
-Fork/PR on [GitHub](https://github.com/tripolskypetr/backtest-kit).
+- **`dashboard_fields`** (→ `DashboardPage`) — not a text form but a **widget grid**: revenue cards, donut, daily-trades chart, success-rate panel, signal grid (see PNL Performance above).
+- **`signal_fields`** (→ `StatusView` detail + print, `useSignalView`) and **`status_fields`** (→ `StatusView`) — the full pending/closed signal record.
+- **`risk_fields`** (→ `useRiskView`), **`setup_fields`** (→ About/Setup view).
+- **Lifecycle/commit schemas** (each → its `use*View` hook in the global registry): `signal_opened_fields`, `signal_closed_fields`, `signal_scheduled_fields`, `signal_cancelled_fields`, `signal_notify_fields`, `signal_sync_open_fields`, `signal_sync_close_fields`, `activate_scheduled_fields`, `average_buy_commit_fields`, `close_pending_commit_fields`, `cancel_scheduled_commit_fields`, `breakeven_available_fields`, `breakeven_commit_fields`, `partial_profit_available_fields`, `partial_profit_commit_fields`, `partial_loss_available_fields`, `partial_loss_commit_fields`, `trailing_stop_fields`, `trailing_take_fields`.
 
-## 📜 License
+These are the largest source files in the package (most 27–37 KB) precisely because they describe every field of every lifecycle DTO — the schemas *are* the UI's knowledge of the engine's data model.
 
-MIT © [tripolskypetr](https://github.com/tripolskypetr)
+</details>

package/build/modules/frontend/build/assets/{Article-C7I5Jc2B.js → Article-CJq_3XCa.js}

@@ -1 +1 @@
-import{b as c,f as v}from"./index-kQlTYlpK.js";const h=c(v("path",{d:"M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z"}),"Article");export{h as A};
+import{b as c,f as v}from"./index-Djrg7_-q.js";const h=c(v("path",{d:"M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z"}),"Article");export{h as A};

package/build/modules/frontend/build/assets/{Background-xwzJo61H.js → Background-xfzkOWU4.js}

@@ -1 +1 @@
-import{f as n,S as o}from"./index-kQlTYlpK.js";const d=()=>n(o,{children:"\n                body {\n                    background-color: #ddd !important;\n                }\n            "});export{d as B};
+import{f as n,S as o}from"./index-Djrg7_-q.js";const d=()=>n(o,{children:"\n                body {\n                    background-color: #ddd !important;\n                }\n            "});export{d as B};

package/build/modules/frontend/build/assets/{IconPhoto-DrGLW-rX.js → IconPhoto-C03KsEBk.js}

@@ -1 +1 @@
-import{f as e,i as t,B as r,V as s}from"./index-kQlTYlpK.js";const o=({className:o,symbol:i,style:a,sx:n})=>e(s,{children:async()=>{try{const s=(await t.symbolGlobalService.getSymbolMap())[i],l=(null==s?void 0:s.logo)||(null==s?void 0:s.icon),c=(null==s?void 0:s.color)||"#ccc";return e(r,{className:o,sx:{position:"relative",width:24,height:24,borderRadius:"50%",display:"flex",alignItems:"center",justifyContent:"center",background:l?"transparent":c,...n},style:a,children:l?e("img",{loading:"lazy",crossOrigin:"anonymous",src:l,alt:i,style:{width:"100%",height:"100%",borderRadius:"50%",objectFit:"contain"},onError:e=>{const t=e.target,r=t.parentElement;r&&(r.style.background=c,t.style.display="none")}}):e(r,{sx:{width:"60%",height:"60%",borderRadius:"50%",backgroundColor:"rgba(255, 255, 255, 0.2)"}})})}catch(s){return e(r,{className:o,sx:{position:"relative",width:24,height:24,borderRadius:"50%",display:"flex",alignItems:"center",justifyContent:"center",background:"#ccc",...n},style:a,children:e(r,{sx:{width:"60%",height:"60%",borderRadius:"50%",backgroundColor:"rgba(255, 255, 255, 0.2)"}})})}}});export{o as I};
+import{f as e,i as t,B as r,V as s}from"./index-Djrg7_-q.js";const o=({className:o,symbol:i,style:a,sx:n})=>e(s,{children:async()=>{try{const s=(await t.symbolGlobalService.getSymbolMap())[i],l=(null==s?void 0:s.logo)||(null==s?void 0:s.icon),c=(null==s?void 0:s.color)||"#ccc";return e(r,{className:o,sx:{position:"relative",width:24,height:24,borderRadius:"50%",display:"flex",alignItems:"center",justifyContent:"center",background:l?"transparent":c,...n},style:a,children:l?e("img",{loading:"lazy",crossOrigin:"anonymous",src:l,alt:i,style:{width:"100%",height:"100%",borderRadius:"50%",objectFit:"contain"},onError:e=>{const t=e.target,r=t.parentElement;r&&(r.style.background=c,t.style.display="none")}}):e(r,{sx:{width:"60%",height:"60%",borderRadius:"50%",backgroundColor:"rgba(255, 255, 255, 0.2)"}})})}catch(s){return e(r,{className:o,sx:{position:"relative",width:24,height:24,borderRadius:"50%",display:"flex",alignItems:"center",justifyContent:"center",background:"#ccc",...n},style:a,children:e(r,{sx:{width:"60%",height:"60%",borderRadius:"50%",backgroundColor:"rgba(255, 255, 255, 0.2)"}})})}}});export{o as I};

package/build/modules/frontend/build/assets/{KeyboardArrowLeft-BpxUzr7-.js → KeyboardArrowLeft-bxIYZMcN.js}

@@ -1 +1 @@
-import{b as o,f as r}from"./index-kQlTYlpK.js";const a=o(r("path",{d:"M15.41 16.59 10.83 12l4.58-4.59L14 6l-6 6 6 6 1.41-1.41z"}),"KeyboardArrowLeft");export{a as K};
+import{b as o,f as r}from"./index-Djrg7_-q.js";const a=o(r("path",{d:"M15.41 16.59 10.83 12l4.58-4.59L14 6l-6 6 6 6 1.41-1.41z"}),"KeyboardArrowLeft");export{a as K};

package/build/modules/frontend/build/assets/{PictureAsPdfOutlined-BTv5MH3G.js → PictureAsPdfOutlined-BF2HVAsQ.js}

@@ -1 +1 @@
-import{b as h,f as c}from"./index-kQlTYlpK.js";const v=h(c("path",{d:"M20 2H8c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H8V4h12v12zM4 6H2v14c0 1.1.9 2 2 2h14v-2H4V6zm12 6V9c0-.55-.45-1-1-1h-2v5h2c.55 0 1-.45 1-1zm-2-3h1v3h-1V9zm4 2h1v-1h-1V9h1V8h-2v5h1zm-8 0h1c.55 0 1-.45 1-1V9c0-.55-.45-1-1-1H9v5h1v-2zm0-2h1v1h-1V9z"}),"PictureAsPdfOutlined");export{v as P};
+import{b as h,f as c}from"./index-Djrg7_-q.js";const v=h(c("path",{d:"M20 2H8c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H8V4h12v12zM4 6H2v14c0 1.1.9 2 2 2h14v-2H4V6zm12 6V9c0-.55-.45-1-1-1h-2v5h2c.55 0 1-.45 1-1zm-2-3h1v3h-1V9zm4 2h1v-1h-1V9h1V8h-2v5h1zm-8 0h1c.55 0 1-.45 1-1V9c0-.55-.45-1-1-1H9v5h1v-2zm0-2h1v1h-1V9z"}),"PictureAsPdfOutlined");export{v as P};

package/build/modules/frontend/build/assets/{Refresh-DixrXBVq.js → Refresh-DdJstAqE.js}

@@ -1 +1 @@
-import{bI as e,d as t,r as a,_ as s,f as i,bJ as n,j as o,bK as r,k as d,bL as m,g as u,u as p,s as x,b as c}from"./index-kQlTYlpK.js";const h=e(),b=["className","component","disableGutters","fixed","maxWidth","classes"],l=m(),f=h("div",{name:"MuiContainer",slot:"Root",overridesResolver:(e,t)=>{const{ownerState:a}=e;return[t.root,t[`maxWidth${o(String(a.maxWidth))}`],a.fixed&&t.fixed,a.disableGutters&&t.disableGutters]}}),g=e=>r({props:e,name:"MuiContainer",defaultTheme:l});const W=function(e={}){const{createStyledComponent:r=f,useThemeProps:m=g,componentName:p="MuiContainer"}=e,x=r(({theme:e,ownerState:a})=>t({width:"100%",marginLeft:"auto",boxSizing:"border-box",marginRight:"auto",display:"block"},!a.disableGutters&&{paddingLeft:e.spacing(2),paddingRight:e.spacing(2),[e.breakpoints.up("sm")]:{paddingLeft:e.spacing(3),paddingRight:e.spacing(3)}}),({theme:e,ownerState:t})=>t.fixed&&Object.keys(e.breakpoints.values).reduce((t,a)=>{const s=a,i=e.breakpoints.values[s];return 0!==i&&(t[e.breakpoints.up(s)]={maxWidth:`${i}${e.breakpoints.unit}`}),t},{}),({theme:e,ownerState:a})=>t({},"xs"===a.maxWidth&&{[e.breakpoints.up("xs")]:{maxWidth:Math.max(e.breakpoints.values.xs,444)}},a.maxWidth&&"xs"!==a.maxWidth&&{[e.breakpoints.up(a.maxWidth)]:{maxWidth:`${e.breakpoints.values[a.maxWidth]}${e.breakpoints.unit}`}}));return a.forwardRef(function(e,a){const r=m(e),{className:c,component:h="div",disableGutters:l=!1,fixed:f=!1,maxWidth:g="lg"}=r,W=s(r,b),k=t({},r,{component:h,disableGutters:l,fixed:f,maxWidth:g}),S=((e,t)=>{const{classes:a,fixed:s,disableGutters:i,maxWidth:n}=e,r={root:["root",n&&`maxWidth${o(String(n))}`,s&&"fixed",i&&"disableGutters"]};return d(r,e=>u(t,e),a)})(k,p);return i(x,t({as:h,ownerState:k,className:n(S.root,c),ref:a},W))})}({createStyledComponent:x("div",{name:"MuiContainer",slot:"Root",overridesResolver:(e,t)=>{const{ownerState:a}=e;return[t.root,t[`maxWidth${o(String(a.maxWidth))}`],a.fixed&&t.fixed,a.disableGutters&&t.disableGutters]}}),useThemeProps:e=>p({props:e,name:"MuiContainer"})}),k=c(i("path",{d:"M17.65 6.35C16.2 4.9 14.21 4 12 4c-4.42 0-7.99 3.58-7.99 8s3.57 8 7.99 8c3.73 0 6.84-2.55 7.73-6h-2.08c-.82 2.33-3.04 4-5.65 4-3.31 0-6-2.69-6-6s2.69-6 6-6c1.66 0 3.14.69 4.22 1.78L13 11h7V4l-2.35 2.35z"}),"Refresh");export{W as C,k as R};
+import{bI as e,d as t,r as a,_ as s,f as i,bJ as n,j as o,bK as r,k as d,bL as m,g as u,u as p,s as x,b as c}from"./index-Djrg7_-q.js";const h=e(),b=["className","component","disableGutters","fixed","maxWidth","classes"],l=m(),f=h("div",{name:"MuiContainer",slot:"Root",overridesResolver:(e,t)=>{const{ownerState:a}=e;return[t.root,t[`maxWidth${o(String(a.maxWidth))}`],a.fixed&&t.fixed,a.disableGutters&&t.disableGutters]}}),g=e=>r({props:e,name:"MuiContainer",defaultTheme:l});const W=function(e={}){const{createStyledComponent:r=f,useThemeProps:m=g,componentName:p="MuiContainer"}=e,x=r(({theme:e,ownerState:a})=>t({width:"100%",marginLeft:"auto",boxSizing:"border-box",marginRight:"auto",display:"block"},!a.disableGutters&&{paddingLeft:e.spacing(2),paddingRight:e.spacing(2),[e.breakpoints.up("sm")]:{paddingLeft:e.spacing(3),paddingRight:e.spacing(3)}}),({theme:e,ownerState:t})=>t.fixed&&Object.keys(e.breakpoints.values).reduce((t,a)=>{const s=a,i=e.breakpoints.values[s];return 0!==i&&(t[e.breakpoints.up(s)]={maxWidth:`${i}${e.breakpoints.unit}`}),t},{}),({theme:e,ownerState:a})=>t({},"xs"===a.maxWidth&&{[e.breakpoints.up("xs")]:{maxWidth:Math.max(e.breakpoints.values.xs,444)}},a.maxWidth&&"xs"!==a.maxWidth&&{[e.breakpoints.up(a.maxWidth)]:{maxWidth:`${e.breakpoints.values[a.maxWidth]}${e.breakpoints.unit}`}}));return a.forwardRef(function(e,a){const r=m(e),{className:c,component:h="div",disableGutters:l=!1,fixed:f=!1,maxWidth:g="lg"}=r,W=s(r,b),k=t({},r,{component:h,disableGutters:l,fixed:f,maxWidth:g}),S=((e,t)=>{const{classes:a,fixed:s,disableGutters:i,maxWidth:n}=e,r={root:["root",n&&`maxWidth${o(String(n))}`,s&&"fixed",i&&"disableGutters"]};return d(r,e=>u(t,e),a)})(k,p);return i(x,t({as:h,ownerState:k,className:n(S.root,c),ref:a},W))})}({createStyledComponent:x("div",{name:"MuiContainer",slot:"Root",overridesResolver:(e,t)=>{const{ownerState:a}=e;return[t.root,t[`maxWidth${o(String(a.maxWidth))}`],a.fixed&&t.fixed,a.disableGutters&&t.disableGutters]}}),useThemeProps:e=>p({props:e,name:"MuiContainer"})}),k=c(i("path",{d:"M17.65 6.35C16.2 4.9 14.21 4 12 4c-4.42 0-7.99 3.58-7.99 8s3.57 8 7.99 8c3.73 0 6.84-2.55 7.73-6h-2.08c-.82 2.33-3.04 4-5.65 4-3.31 0-6-2.69-6-6s2.69-6 6-6c1.66 0 3.14.69 4.22 1.78L13 11h7V4l-2.35 2.35z"}),"Refresh");export{W as C,k as R};

package/build/modules/frontend/build/assets/emitters-Bc8GPUEm.js

@@ -0,0 +1 @@
+import{a8 as o}from"./index-Djrg7_-q.js";const r=new o;export{r};

package/build/modules/frontend/build/assets/{hasRouteMatch-C0K-M4jy.js → hasRouteMatch-Cp7g01zK.js}

@@ -1 +1 @@
-import{i as a,bG as e,bH as t}from"./index-kQlTYlpK.js";const i=(i,o=a.routerService.location.pathname)=>!!e(t.filter(({path:a})=>i.includes(a)),o);export{i as h};
+import{i as a,bG as e,bH as t}from"./index-Djrg7_-q.js";const i=(i,o=a.routerService.location.pathname)=>!!e(t.filter(({path:a})=>i.includes(a)),o);export{i as h};

package/build/modules/frontend/build/assets/{html2canvas-Xo2SFHzw.js → html2canvas-Dt1QJQhu.js}

@@ -1 +1 @@
-import{bM as e,bO as t}from"./index-kQlTYlpK.js";function r(e,t){for(var r=0;r<t.length;r++){const o=t[r];if("string"!=typeof o&&!Array.isArray(o))for(const t in o)if("default"!==t&&!(t in e)){const r=Object.getOwnPropertyDescriptor(o,t);r&&Object.defineProperty(e,t,r.get?r:{enumerable:!0,get:()=>o[t]})}}return Object.freeze(Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}))}var o=t();const n=r({__proto__:null,default:e(o)},[o]);export{n as h};
+import{bM as e,bO as t}from"./index-Djrg7_-q.js";function r(e,t){for(var r=0;r<t.length;r++){const o=t[r];if("string"!=typeof o&&!Array.isArray(o))for(const t in o)if("default"!==t&&!(t in e)){const r=Object.getOwnPropertyDescriptor(o,t);r&&Object.defineProperty(e,t,r.get?r:{enumerable:!0,get:()=>o[t]})}}return Object.freeze(Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}))}var o=t();const n=r({__proto__:null,default:e(o)},[o]);export{n as h};