alpha-visualizer 1.3.2__tar.gz → 1.3.4__tar.gz

alpha_visualizer-1.3.2/.hypothesis/constants/a143537c99265376 → alpha_visualizer-1.3.4/.hypothesis/constants/3039d4d1f0d58a79

@@ -1,4 +1,4 @@
 # file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/__init__.py
 # hypothesis_version: 6.161.6
 
-['1.3.2']
+['1.3.4']

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/CHANGELOG.md

@@ -11,6 +11,24 @@ alpha-visualizer の全バージョン変更履歴です。
 _(EN) Entries below are generated from Conventional Commits (Japanese). Group names: 新機能 = Features, バグ修正 = Bug fixes, リファクタリング = Refactoring, パフォーマンス改善 = Performance, ドキュメント = Docs, テスト = Tests, その他 = Chore. Breaking commits are tagged 破壊的変更._
 
 
+## [1.3.3] - 2026-08-01
+
+
+### 新機能
+
+- エクイティチャートに系列凡例を追加する (#463)
+
+
+
+## [1.3.2] - 2026-08-01
+
+
+### 新機能
+
+- EULA 未同意で forge が Abort した際に同意手順を案内する (#462)
+
+
+
 ## [1.3.1] - 2026-08-01
 
 

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-visualizer
-Version: 1.3.2
+Version: 1.3.4
 Summary: Web visualization tool for AlphaForge backtest results
 Project-URL: Homepage, https://github.com/alforge-labs/alpha-visualizer
 Project-URL: Repository, https://github.com/alforge-labs/alpha-visualizer

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/frontend/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "alpha-visualizer",
     "description": "AlphaForge バックテスト結果の Web 可視化ツール",
-    "version": "1.3.2"
+    "version": "1.3.4"
   },
   "paths": {
     "/api/results": {

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/frontend/src/charts/tv/EquityDrawdownPaneTV.tsx

@@ -45,6 +45,13 @@ export interface EquityOverlay {
   dashed?: boolean
 }
 
+/** 凡例 1 件分。色・線種は対応する系列に実際に適用したものと同じ値を入れる。 */
+interface SeriesLegendEntry {
+  label: string
+  color: string
+  dashed: boolean
+}
+
 export interface EquityDrawdownPaneTVProps {
   equity: number[]
   dates: string[]
@@ -54,6 +61,11 @@ export interface EquityDrawdownPaneTVProps {
   showBenchmark?: boolean
   /** equity と並走する追加比較系列（issue の多系列比較・任意本数） */
   overlays?: EquityOverlay[]
+  /**
+   * 凡例に出す主系列（equity）の名前。主系列が何を指すかは画面ごとに違う
+   * （バックテスト = 戦略の成績 / ライブ = 実際の運用成績）ため呼び出し側が決める。
+   */
+  equityLabel?: string
   compact?: boolean
   /** レジーム背景バンドの元データ（issue #317） */
   regimeSeries?: RegimeSeries | null
@@ -78,6 +90,7 @@ export function EquityDrawdownPaneTV(props: EquityDrawdownPaneTVProps) {
     benchmark,
     showBenchmark = false,
     overlays,
+    equityLabel = 'Strategy',
     compact = false,
     regimeSeries,
     showRegime = false,
@@ -113,6 +126,22 @@ export function EquityDrawdownPaneTV(props: EquityDrawdownPaneTVProps) {
 
   const overlayCount = overlays?.length ?? 0
 
+  /**
+   * overlay のラベル → パレット位置。**系列の生成と凡例が共有する唯一の割り当て**。
+   *
+   * 色は配列位置ではなく**ラベル**で決める。配列位置で決めると、ラベルはそのままで
+   * 並び順だけ変わったときに系列の色が入れ替わり、線の色で系列を識別している画面では
+   * 同じものが別物に見える。ソート済みユニークラベルの位置を使うことで、並び替えに
+   * 対して安定させる。
+   *
+   * ここを 1 箇所に集約するのは、凡例が系列と別ロジックで色を決めると両者が食い違う
+   * ため（凡例の存在価値は色と系列名の対応付けだけにあり、ずれた凡例は無いより悪い）。
+   */
+  const overlayColorIndexByLabel = useMemo(() => {
+    const labels = [...new Set((overlays ?? []).map((o) => o.label))].sort()
+    return new Map(labels.map((label, idx) => [label, idx] as const))
+  }, [overlays])
+
   const { equityData, benchmarkData, overlayData, drawdownData, markers } = useMemo(() => {
     const conv = fromViewportPoints(points, overlayCount)
     const ddSlicedDates = points.map((p) => p.date.toISOString().slice(0, 10))
@@ -240,16 +269,8 @@ export function EquityDrawdownPaneTV(props: EquityDrawdownPaneTVProps) {
       }
     }
 
-    // 色は配列位置ではなく**ラベル**で決める。配列位置で決めると、ラベルは
-    // そのままで並び順だけ変わったときに系列の色が入れ替わり、線の色で系列を
-    // 識別している画面では同じものが別物に見える。ソート済みユニークラベルの
-    // 位置を使うことで、並び替えに対して安定させる。
-    const colorIndexByLabel = new Map(
-      [...wantedLabels].sort().map((label, idx) => [label, idx]),
-    )
-
     wanted.forEach((overlay) => {
-      const colorIndex = colorIndexByLabel.get(overlay.label) ?? 0
+      const colorIndex = overlayColorIndexByLabel.get(overlay.label) ?? 0
       const options = overlayLineOptions(theme, colorIndex, overlay.color, overlay.dashed)
       const existing = map.get(overlay.label)
       if (existing) {
@@ -258,7 +279,7 @@ export function EquityDrawdownPaneTV(props: EquityDrawdownPaneTVProps) {
         map.set(overlay.label, chart.addSeries(LineSeries, options, 0))
       }
     })
-  }, [overlays, theme])
+  }, [overlays, overlayColorIndexByLabel, theme])
 
   // issue #317: レジーム背景バンドの attach/detach。
   // primitive は bands をクロージャに持つため、series/表示切替/テーマが変わったら
@@ -331,6 +352,50 @@ export function EquityDrawdownPaneTV(props: EquityDrawdownPaneTVProps) {
   )
 
   // 凡例は DOM 側に描く（canvas 内に描くとテキスト検索・SR 到達性が失われるため）
+
+  /**
+   * equity + 比較系列の凡例。
+   *
+   * 比較系列が 1 本も無い画面（IS/OOS・レポート）では線が equity 1 本しかなく、
+   * 凡例は操作行を圧迫するだけなので出さない。色・線種は系列に渡すオプションを
+   * そのまま引くので、系列側の色決定を変えても凡例が置き去りにならない。
+   */
+  const seriesLegend = useMemo<SeriesLegendEntry[]>(() => {
+    // 重複ラベルは系列側が label キーの Map で後勝ちに統合する。凡例だけ 2 件
+    // 並ぶと、描かれていない線が存在するように見えるので同じ規則で潰す。
+    const uniqueOverlays = [...new Map((overlays ?? []).map((o) => [o.label, o])).values()]
+    if (!showBenchmark && uniqueOverlays.length === 0) return []
+
+    const entries: SeriesLegendEntry[] = [
+      {
+        label: equityLabel,
+        color: equityAreaOptions(theme, isPositive).lineColor ?? theme.text3,
+        dashed: false,
+      },
+    ]
+    if (showBenchmark) {
+      entries.push({
+        label: 'Buy & Hold',
+        color: benchmarkLineOptions(theme).color ?? theme.text3,
+        dashed: true,
+      })
+    }
+    for (const overlay of uniqueOverlays) {
+      const options = overlayLineOptions(
+        theme,
+        overlayColorIndexByLabel.get(overlay.label) ?? 0,
+        overlay.color,
+        overlay.dashed,
+      )
+      entries.push({
+        label: overlay.label,
+        color: options.color ?? theme.text3,
+        dashed: Boolean(overlay.dashed),
+      })
+    }
+    return entries
+  }, [overlays, overlayColorIndexByLabel, showBenchmark, equityLabel, theme, isPositive])
+
   const regimeLegend = useMemo(() => {
     if (!showRegime || !regimeSeries) return []
     return createRegimeBandsPrimitive(regimeSeries, theme.series, REGIME_BAND_ALPHA).legend()
@@ -407,20 +472,33 @@ export function EquityDrawdownPaneTV(props: EquityDrawdownPaneTVProps) {
         >
           Log
         </button>
-        {showBenchmark && (
+        {seriesLegend.length > 0 && (
           <div
+            data-testid="series-legend"
             style={{
               marginLeft: 12,
               display: 'flex',
               gap: 12,
               alignItems: 'center',
+              flexWrap: 'wrap',
               fontFamily: 'var(--mono)',
               fontSize: 'var(--fs-mono-sm)',
               color: 'var(--text3)',
             }}
           >
-            <span style={{ color: theme.accent }}>━━ Strategy</span>
-            <span>╌╌ Buy &amp; Hold</span>
+            {seriesLegend.map((e) => (
+              <span key={e.label} style={{ display: 'flex', alignItems: 'center', gap: 5 }}>
+                <span
+                  data-testid={`series-legend-swatch-${e.label}`}
+                  aria-hidden="true"
+                  style={{
+                    width: 16,
+                    borderTop: `2px ${e.dashed ? 'dashed' : 'solid'} ${e.color}`,
+                  }}
+                />
+                {e.label}
+              </span>
+            ))}
           </div>
         )}
         {regimeLegend.length > 0 && (

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/frontend/src/charts/tv/__tests__/EquityDrawdownPaneTV.test.tsx

@@ -596,3 +596,115 @@ describe('EquityDrawdownPaneTV log scale (issue #378)', () => {
     )
   })
 })
+
+/**
+ * 系列凡例。ライブ画面は overlays（指数・バックテスト）で 3 本の線を重ねて描くが、
+ * 凡例が無いためどの線が何かを判別できなかった。
+ */
+describe('EquityDrawdownPaneTV series legend', () => {
+  const baseProps = {
+    lang: 'ja' as const,
+    equity: sampleEquity,
+    dates: sampleDates,
+    drawdown: sampleDrawdown,
+    isCutoffIdx: 15,
+  }
+
+  function overlayColors(): string[] {
+    return addSeriesMock.mock.calls
+      .filter((args) => (args as unknown[])[0] === 'LineSeriesDef')
+      .map((args) => ((args as unknown[])[1] as { color?: string }).color ?? '')
+  }
+
+  it('overlays の各ラベルを凡例に表示する', () => {
+    render(
+      <EquityDrawdownPaneTV
+        {...baseProps}
+        overlays={[
+          { label: '指数（Buy & Hold）', values: sampleEquity },
+          { label: 'バックテスト', values: sampleEquity, dashed: true },
+        ]}
+      />,
+    )
+    const legend = screen.getByTestId('series-legend')
+    expect(legend).toHaveTextContent('指数（Buy & Hold）')
+    expect(legend).toHaveTextContent('バックテスト')
+  })
+
+  it('凡例の色は実際に系列へ渡した色と一致する', () => {
+    // WHY: 凡例の存在価値は「線の色 → 系列名」の対応付けだけにある。色が
+    // 食い違った凡例は、無いより悪い（別系列を読み違えたまま判断される）。
+    // 実際、統合前の凡例は Strategy を theme.accent 固定で描いていたが、
+    // equity 線は success/danger で描かれており一致していなかった。
+    render(
+      <EquityDrawdownPaneTV
+        {...baseProps}
+        overlays={[
+          { label: 'QQQ', values: sampleEquity },
+          { label: 'BT', values: sampleEquity, dashed: true },
+        ]}
+      />,
+    )
+    const [qqqColor, btColor] = overlayColors()
+    expect(qqqColor).toBeTruthy()
+    expect(btColor).toBeTruthy()
+
+    const swatchOf = (label: string) =>
+      screen.getByTestId(`series-legend-swatch-${label}`)
+    expect(swatchOf('QQQ')).toHaveStyle({ borderTopColor: qqqColor })
+    expect(swatchOf('BT')).toHaveStyle({ borderTopColor: btColor })
+    // dashed 指定は線種としても凡例に反映する（色だけでは 2 系列を区別しにくい）
+    expect(swatchOf('BT')).toHaveStyle({ borderTopStyle: 'dashed' })
+    expect(swatchOf('QQQ')).toHaveStyle({ borderTopStyle: 'solid' })
+  })
+
+  it('主系列のラベルは equityLabel で差し替えられる', () => {
+    // WHY: 主系列が何かは画面ごとに違う（バックテスト = Strategy / ライブ = 実績）。
+    // 比較系列だけ名前が付いて主系列が無名だと、どれが自分の成績か分からない。
+    render(
+      <EquityDrawdownPaneTV
+        {...baseProps}
+        equityLabel="ライブ"
+        overlays={[{ label: 'QQQ', values: sampleEquity }]}
+      />,
+    )
+    expect(screen.getByTestId('series-legend')).toHaveTextContent('ライブ')
+  })
+
+  it('比較系列が無ければ凡例を出さない', () => {
+    // WHY: 線が 1 本しかない画面（IS/OOS・レポート）で凡例を出しても情報量は
+    // 増えず、チャート上部の操作行を圧迫するだけ。
+    render(<EquityDrawdownPaneTV {...baseProps} />)
+    expect(screen.queryByTestId('series-legend')).not.toBeInTheDocument()
+  })
+
+  it('showBenchmark 時は Buy & Hold を凡例に含む', () => {
+    render(
+      <EquityDrawdownPaneTV
+        {...baseProps}
+        benchmark={sampleEquity.map((v) => v * 0.9)}
+        showBenchmark
+      />,
+    )
+    const legend = screen.getByTestId('series-legend')
+    expect(legend).toHaveTextContent('Strategy')
+    expect(legend).toHaveTextContent('Buy & Hold')
+  })
+
+  it('重複ラベルの overlays は凡例にも 1 件だけ出す', () => {
+    // WHY: 系列側は label をキーにした Map で 1 本に統合される。凡例だけ 2 件
+    // 並ぶと、描かれていない線が存在するように見える。
+    const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    render(
+      <EquityDrawdownPaneTV
+        {...baseProps}
+        overlays={[
+          { label: 'QQQ', values: sampleEquity },
+          { label: 'QQQ', values: sampleEquity.map((v) => v * 2) },
+        ]}
+      />,
+    )
+    expect(screen.getAllByTestId('series-legend-swatch-QQQ')).toHaveLength(1)
+    warn.mockRestore()
+  })
+})

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/frontend/src/components/live/LivePositionView.tsx

@@ -78,10 +78,25 @@ function admitComparisonSeries(
   return series
 }
 
+/**
+ * `ChartTheme.series`（accent / steel / moss / umber / mauve）における mauve の位置。
+ *
+ * 指数の色をパレット任せにすると、ラベルのソート順で 2 色目の steel が当たる。
+ * ライブ equity は success（緑 #4A723A）/ danger（赤）で描かれ、steel(#5B7A8C) は
+ * 緑と ΔE 44.6 しか離れていない（他の系列ペアは 67〜75）。明度も L* 49.5 vs 43.9 と
+ * 近いため、細い線では主系列と見分けられない。緑からも赤からも離れた mauve
+ * （ΔE 67.7）を固定で割り当てる。
+ */
+const MAUVE_SERIES_INDEX = 4
+
 /** 許容済み系列（`admitComparisonSeries` 通過後）を overlay 形式に変換する。 */
-function toOverlay(label: string, series: [string, number][] | null): EquityOverlay | null {
+function toOverlay(
+  label: string,
+  series: [string, number][] | null,
+  style?: Pick<EquityOverlay, 'color' | 'dashed'>,
+): EquityOverlay | null {
   if (!series) return null
-  return { label, values: series.map(([, v]) => v) }
+  return { label, values: series.map(([, v]) => v), ...style }
 }
 
 /**
@@ -115,7 +130,13 @@ export function LivePositionView({ summary, warnings, lang }: Props): ReactEleme
   const acceptedBacktest = admitComparisonSeries(backtestLabel, summary.backtest_equity, values.length)
 
   const overlays: EquityOverlay[] = [
-    toOverlay(benchmarkLabel, acceptedBenchmark),
+    // 指数だけは色と線種を明示する（理由は MAUVE_SERIES_INDEX のコメント）。
+    // 破線は色以外の手がかりでの区別も兼ねる（バックテスト画面の Buy & Hold と同じ扱い）
+    toOverlay(benchmarkLabel, acceptedBenchmark, {
+      color: theme.series[MAUVE_SERIES_INDEX],
+      dashed: true,
+    }),
+    // バックテストは既定パレット（accent 橙）のまま。equity の緑・赤とは十分離れている
     toOverlay(backtestLabel, acceptedBacktest),
   ].filter((o): o is EquityOverlay => o != null)
 
@@ -179,6 +200,9 @@ export function LivePositionView({ summary, warnings, lang }: Props): ReactEleme
               drawdown={drawdown}
               isCutoffIdx={0}
               overlays={overlays}
+              // 既定の 'Strategy' はバックテスト画面向けの名前。ここでの主系列は
+              // 実運用の成績なので、比較系列（指数・バックテスト）と取り違えない名前にする
+              equityLabel={L('ライブ', 'Live')}
               lang={lang}
             />
           </div>

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/frontend/src/components/live/__tests__/LivePositionView.test.tsx

@@ -125,6 +125,24 @@ describe('<LivePositionView /> assembly (Task 13)', () => {
     expect(props?.overlays).toEqual([])
   })
 
+  it('主系列の凡例ラベルを言語に応じて渡す', () => {
+    // WHY: ライブ画面は equity に指数・バックテストを重ねる。凡例の既定ラベルは
+    // 'Strategy'（バックテスト画面向け）なので、そのままだと主系列が「戦略の
+    // バックテスト曲線」に見え、実運用の成績と取り違える。
+    const summary = {
+      strategy_id: 'pf_1',
+      kind: 'position' as const,
+      metrics: {},
+      equity: [['2026-06-04T00:00:00', 1_000_000]],
+    } as unknown as LiveSummary
+
+    render(<LivePositionView summary={summary} warnings={[]} lang="ja" />)
+    expect(equityPaneProps.current?.equityLabel).toBe('ライブ')
+
+    render(<LivePositionView summary={summary} warnings={[]} lang="en" />)
+    expect(equityPaneProps.current?.equityLabel).toBe('Live')
+  })
+
   it('ベンチマークがあれば overlays に指数系列を equity と同じインデックスで積む', () => {
     const summary = {
       strategy_id: 'pf_1',
@@ -164,6 +182,44 @@ describe('<LivePositionView /> assembly (Task 13)', () => {
     expect(overlays[0]?.values).toEqual([1_000_000, 1_020_000])
   })
 
+  it('指数は主系列と混同しない色・線種を明示指定する', () => {
+    // WHY: ライブ equity は success（緑 #4A723A）/ danger（赤）で描かれる。
+    // overlay の色をパレット任せにすると、ラベルのソート順で 2 色目の
+    // steel(#5B7A8C) が指数に当たる。steel は緑と ΔE 44.6 しか離れておらず
+    // （他の系列ペアは 67〜75）、明度も L* 49.5 vs 43.9 と近いため、細い線では
+    // 見分けられない。緑からも赤からも離れた mauve を固定で割り当て、さらに
+    // 破線にして色以外の手がかりでも区別できるようにする。
+    const summary = {
+      strategy_id: 'pf_1',
+      kind: 'position' as const,
+      metrics: {},
+      equity: [
+        ['2026-06-04T00:00:00', 1_000_000],
+        ['2026-06-05T00:00:00', 995_000],
+      ] as [string, number][],
+      benchmark_equity: [
+        ['2026-06-04T00:00:00', 1_000_000],
+        ['2026-06-05T00:00:00', 1_020_000],
+      ] as [string, number][],
+      backtest_equity: [
+        ['2026-06-04T00:00:00', 1_000_000],
+        ['2026-06-05T00:00:00', 1_010_000],
+      ] as [string, number][],
+    } as unknown as LiveSummary
+
+    render(<LivePositionView summary={summary} warnings={[]} lang="ja" />)
+    const overlays = equityPaneProps.current?.overlays ?? []
+    const index = overlays.find((o) => o.label === '指数（Buy & Hold）')
+    const backtest = overlays.find((o) => o.label === 'バックテスト')
+
+    // mauve（ChartTheme.series の 5 色目）。steel が当たらないことが要点
+    expect(index?.color).toBe('#7B5380')
+    expect(index?.dashed).toBe(true)
+    // バックテストは既定パレット（accent 橙）のまま。緑とは十分離れている
+    expect(backtest?.color).toBeUndefined()
+    expect(backtest?.dashed).toBeFalsy()
+  })
+
   it('overlay で除外された系列は KPI の超過リターンにも使われない（Finding 1: チャートと KPI の判定を統一）', () => {
     // WHY: buildOverlay がチャート描画を弾く系列を、KPI 行（超過リターン）が
     // 生の summary.benchmark_equity / backtest_equity をそのまま受け取って

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "alpha-visualizer"
-version = "1.3.2"
+version = "1.3.4"
 description = "Web visualization tool for AlphaForge backtest results"
 readme = "README.md"
 license = "Apache-2.0"
@@ -93,7 +93,7 @@ dev = [
 ]
 
 [tool.bumpversion]
-current_version = "1.3.2"
+current_version = "1.3.4"
 commit = true
 message = "chore: バージョン {new_version} にバンプ"
 tag = true

{alpha_visualizer-1.3.2 → alpha_visualizer-1.3.4}/src/alpha_visualizer/__init__.py

@@ -1,3 +1,3 @@
 """alpha-visualizer: AlphaForge バックテスト結果の Web 可視化ツール"""
 
-__version__ = "1.3.2"
+__version__ = "1.3.4"