alpha-visualizer 0.7.2__tar.gz → 0.7.3__tar.gz

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/.github/workflows/ci.yml

@@ -306,3 +306,71 @@ jobs:
           name: playwright-traces
           path: frontend/test-results/
           retention-days: 14
+
+  e2e-samples:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.11.19"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install Python dependencies
+        run: uv sync --all-extras
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 11
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+          cache-dependency-path: frontend/pnpm-lock.yaml
+
+      - name: Install pnpm dependencies
+        working-directory: frontend
+        run: pnpm install --frozen-lockfile
+
+      - name: Cache Playwright browsers
+        uses: actions/cache@v5
+        id: playwright-cache
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('frontend/pnpm-lock.yaml') }}
+
+      - name: Install Playwright browsers (cold)
+        working-directory: frontend
+        if: steps.playwright-cache.outputs.cache-hit != 'true'
+        run: pnpm exec playwright install --with-deps chromium
+
+      - name: Install Playwright system deps (cache hit)
+        working-directory: frontend
+        if: steps.playwright-cache.outputs.cache-hit == 'true'
+        run: pnpm exec playwright install-deps chromium
+
+      - name: Build frontend
+        working-directory: frontend
+        run: pnpm run build
+
+      - name: Run Playwright samples smoke
+        working-directory: frontend
+        env:
+          CI: 'true'
+        run: pnpm run e2e:samples
+
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: playwright-report-samples
+          path: frontend/playwright-report-samples/
+          retention-days: 14

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/.gitignore

@@ -28,6 +28,7 @@ frontend/.tsbuildinfo
 
 # Playwright artifacts
 frontend/playwright-report/
+frontend/playwright-report-samples/
 frontend/test-results/
 frontend/blob-report/
 frontend/playwright/.cache/

alpha_visualizer-0.7.2/.hypothesis/constants/65993953f7ccf191 → alpha_visualizer-0.7.3/.hypothesis/constants/efa1548145a8bfba

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

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-visualizer
-Version: 0.7.2
+Version: 0.7.3
 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-0.7.2 → alpha_visualizer-0.7.3}/frontend/e2e/screenshots/capture.spec.ts

@@ -151,12 +151,13 @@ test.describe.serial('README / docs 用スクリーンショット撮影', () =>
         await captureViewport(page, lang, 'browse', 1180)
       })
 
-      // detail: 「エクイティ vs Buy&Hold」カード（タイトル＋チャート）をクロップ
+      // detail: 「エクイティ & ドローダウン」カード（タイトル＋チャート）をクロップ
       test('detail', async ({ page }) => {
         await gotoDetail(page, STRATEGY_ID)
         await setLang(page, lang)
-        // backtest-equity-chart の親 div = セクションラベル＋エクイティチャート
-        const equitySection = page.getByTestId('backtest-equity-chart').locator('..')
+        // backtest-equity-chart-tv の親 div = セクションラベル＋エクイティチャート
+        // （issue #231 以降は TV レンダラが既定）
+        const equitySection = page.getByTestId('backtest-equity-chart-tv').locator('..')
         await captureElement(page, lang, 'detail', equitySection, 280)
       })
 

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/e2e/screenshots/equity-tv.spec.ts

@@ -39,7 +39,9 @@ test.describe.serial('lightweight-charts (TV) 用スクリーンショット', (
   }
 
   test('backtest-tv (ja, gotoDetail helper)', async ({ page }) => {
-    // gotoDetail を経由しても feature flag が ON のまま維持されることの回帰確認
+    // gotoDetail を経由しても feature flag が ON のまま維持されることの回帰確認。
+    // renderer-mode バッジは issue #231 以降 ?tv クエリ無しの本番ビルドでは
+    // 表示されないため、TV チャート本体の testid で検証する。
     await clearViewerSettings(page)
     await page.addInitScript(() => {
       try {
@@ -50,6 +52,6 @@ test.describe.serial('lightweight-charts (TV) 用スクリーンショット', (
     })
     await gotoDetail(page, STRATEGY_ID)
     await page.waitForLoadState('networkidle')
-    await page.getByTestId('renderer-mode').waitFor({ state: 'visible' })
+    await page.locator('[data-testid="backtest-equity-chart-tv"]').waitFor({ state: 'visible' })
   })
 })

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/e2e/specs/compare.spec.ts

@@ -11,10 +11,11 @@ test.describe('Compare スモーク', () => {
 
     await expect(page.getByTestId('compare-main-grid')).toBeVisible()
 
-    const chart = page.getByLabel(/Compare equity chart, 2 strategies/)
+    // issue #231 以降は TV レンダラが既定（canvas 描画）
+    const chart = page.getByTestId('compare-equity-tv')
     await expect(chart).toBeVisible()
-    // visx の SVG パスが少なくとも 1 本描画されていること
-    await expect(chart.locator('path').first()).toBeVisible()
+    await expect(chart.getByLabel(/Compare equity chart, 2 strategies/)).toBeVisible()
+    await expect(chart.locator('canvas').first()).toBeVisible()
 
     const table = page.getByTestId('compare-table')
     await expect(table).toBeVisible()

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/e2e/specs/detail.spec.ts

@@ -9,9 +9,9 @@ test.describe('Detail スモーク', () => {
   test('sma_cross の主要タブを順次切り替えられる', async ({ page }) => {
     await gotoDetail(page, 'sma_cross')
 
-    // backtest タブ（既定）
+    // backtest タブ（既定）— issue #231 以降は TV レンダラが既定
     await expect(page.getByTestId('backtest-screen')).toBeVisible()
-    await expect(page.getByTestId('backtest-equity-chart')).toBeVisible()
+    await expect(page.getByTestId('backtest-equity-chart-tv')).toBeVisible()
 
     // IS / OOS タブ
     await page.getByRole('tab', { name: 'IS / OOS' }).click()
@@ -36,4 +36,11 @@ test.describe('Detail スモーク', () => {
     await page.getByRole('tab', { name: /最適化|Optimize/ }).click()
     await expect(page.getByTestId('optimize-screen')).toBeVisible()
   })
+
+  test('?tv=0 で visx レンダラに fallback できる', async ({ page }) => {
+    // issue #231: TV 既定化後も visx を opt-out 経路として維持していることの回帰確認
+    await page.goto('/detail/sma_cross?tv=0')
+    await expect(page.getByTestId('backtest-equity-chart')).toBeVisible()
+    await expect(page.getByTestId('backtest-equity-chart-tv')).not.toBeVisible()
+  })
 })

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/playwright.samples.config.ts

@@ -37,7 +37,7 @@ export default defineConfig({
   webServer: {
     // FORGE_CONFIG が外部 forge.yaml を指していないよう明示クリア。
     command:
-      'env FORGE_CONFIG= uv run vis serve --forge-dir samples/sample-forge --forge-config samples/sample-forge/forge.yaml --host 127.0.0.1 --port 8124 --no-open',
+      'env FORGE_CONFIG= uv run alpha-vis serve --forge-dir samples/sample-forge --forge-config samples/sample-forge/forge.yaml --host 127.0.0.1 --port 8124 --no-open',
     url: `${BASE_URL}/health`,
     cwd: '..',
     reuseExistingServer: !process.env.CI,

alpha_visualizer-0.7.3/frontend/src/constants/__tests__/featureFlags.test.ts

@@ -0,0 +1,120 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+import {
+  resolveLightweightChartsFlag,
+  setLightweightChartsFlag,
+} from '../featureFlags'
+
+const LS_KEY = 'alpha.flags.lightweightCharts'
+
+/** jsdom の location.search をテストごとに設定する */
+function setSearch(search: string): void {
+  window.history.replaceState(null, '', search === '' ? '/' : `/?${search}`)
+}
+
+// jsdom の localStorage が無効なため、useTheme.test.tsx と同じ in-memory Storage を stub する
+function createMemoryStorage(): Storage {
+  const store = new Map<string, string>()
+  return {
+    getItem: (k: string) => store.get(k) ?? null,
+    setItem: (k: string, v: string) => {
+      store.set(k, v)
+    },
+    removeItem: (k: string) => {
+      store.delete(k)
+    },
+    clear: () => {
+      store.clear()
+    },
+    key: (i: number) => Array.from(store.keys())[i] ?? null,
+    get length() {
+      return store.size
+    },
+  }
+}
+
+let storage: Storage
+
+beforeEach(() => {
+  storage = createMemoryStorage()
+  vi.stubGlobal('localStorage', storage)
+  setSearch('')
+})
+
+afterEach(() => {
+  vi.unstubAllGlobals()
+  vi.unstubAllEnvs()
+  window.history.replaceState({}, '', '/')
+})
+
+describe('resolveLightweightChartsFlag', () => {
+  // issue #231: TV チャートは既定 ON。docs/README は TV を主要機能として
+  // 提示しており（v0.3.0/v0.4.0 で移行済みと記載）、既定 OFF のままでは
+  // 公開 wheel の実挙動が docs と乖離する。
+  it('クエリ・localStorage・env が無いとき既定で true（TV レンダラ）を返す', () => {
+    expect(resolveLightweightChartsFlag()).toBe(true)
+  })
+
+  it('?tv=0 で false（visx fallback）になり localStorage に persist される', () => {
+    setSearch('tv=0')
+    expect(resolveLightweightChartsFlag()).toBe(false)
+    expect(storage.getItem(LS_KEY)).toBe('0')
+  })
+
+  it('?tv=1 で true になり localStorage に persist される', () => {
+    setSearch('tv=1')
+    expect(resolveLightweightChartsFlag()).toBe(true)
+    expect(storage.getItem(LS_KEY)).toBe('1')
+  })
+
+  it('localStorage の "0" で false を返す（クエリ無し）', () => {
+    storage.setItem(LS_KEY, '0')
+    expect(resolveLightweightChartsFlag()).toBe(false)
+  })
+
+  it('localStorage の "1" で true を返す', () => {
+    storage.setItem(LS_KEY, '1')
+    expect(resolveLightweightChartsFlag()).toBe(true)
+  })
+
+  // 既定 ON 化後も env で明示 OFF できること（CI やビルド時の退避経路）
+  it.each(['0', 'false'])('env VITE_USE_LIGHTWEIGHT_CHARTS=%s で false を返す', (raw) => {
+    vi.stubEnv('VITE_USE_LIGHTWEIGHT_CHARTS', raw)
+    expect(resolveLightweightChartsFlag()).toBe(false)
+  })
+
+  it.each(['1', 'true'])('env VITE_USE_LIGHTWEIGHT_CHARTS=%s で true を返す', (raw) => {
+    vi.stubEnv('VITE_USE_LIGHTWEIGHT_CHARTS', raw)
+    expect(resolveLightweightChartsFlag()).toBe(true)
+  })
+
+  it('認識できない env 値（typo 等）は無視して既定 true にフォールバックする', () => {
+    vi.stubEnv('VITE_USE_LIGHTWEIGHT_CHARTS', 'off')
+    expect(resolveLightweightChartsFlag()).toBe(true)
+  })
+
+  it('優先順位: クエリ ?tv=1 は localStorage の "0" に勝つ', () => {
+    storage.setItem(LS_KEY, '0')
+    setSearch('tv=1')
+    expect(resolveLightweightChartsFlag()).toBe(true)
+  })
+
+  it('優先順位: localStorage の "1" は env の "0" に勝つ', () => {
+    vi.stubEnv('VITE_USE_LIGHTWEIGHT_CHARTS', '0')
+    storage.setItem(LS_KEY, '1')
+    expect(resolveLightweightChartsFlag()).toBe(true)
+  })
+
+  it('優先順位: env の "0" は既定 true に勝つ（クエリ・storage 無し）', () => {
+    vi.stubEnv('VITE_USE_LIGHTWEIGHT_CHARTS', '0')
+    expect(resolveLightweightChartsFlag()).toBe(false)
+  })
+})
+
+describe('setLightweightChartsFlag', () => {
+  it('false を保存すると次回解決時に visx fallback になる', () => {
+    setLightweightChartsFlag(false)
+    expect(storage.getItem(LS_KEY)).toBe('0')
+    expect(resolveLightweightChartsFlag()).toBe(false)
+  })
+})

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/src/constants/featureFlags.ts

@@ -1,21 +1,25 @@
 /**
- * Feature flag 解決ロジック。issue #180 の lightweight-charts PoC 用。
+ * Feature flag 解決ロジック。issue #180 の lightweight-charts PoC として導入し、
+ * issue #231 で既定 ON に反転（TV レンダラを正式採用。visx は `?tv=0` fallback）。
  *
  * 優先順位:
  *   1. URL クエリ `?tv=1` / `?tv=0` (top priority — セッション中は localStorage へ persist)
  *   2. localStorage['alpha.flags.lightweightCharts']
- *   3. import.meta.env.VITE_USE_LIGHTWEIGHT_CHARTS === '1'
- *   4. デフォルト false
+ *   3. import.meta.env.VITE_USE_LIGHTWEIGHT_CHARTS（'1'/'true' で ON、'0'/'false' で OFF）
+ *   4. デフォルト true
  *
  * SSR / non-DOM コンテキストでは env と デフォルトだけを評価する。
  */
 
 const LS_KEY = 'alpha.flags.lightweightCharts'
 const QS_KEY = 'tv'
+const DEFAULT_FLAG = true
 
-function readEnvFlag(): boolean {
+function readEnvFlag(): boolean | null {
   const raw = import.meta.env.VITE_USE_LIGHTWEIGHT_CHARTS
-  return raw === '1' || raw === 'true'
+  if (raw === '1' || raw === 'true') return true
+  if (raw === '0' || raw === 'false') return false
+  return null
 }
 
 function readQueryFlag(): boolean | null {
@@ -62,7 +66,7 @@ export function resolveLightweightChartsFlag(): boolean {
   }
   const fromStorage = readStorageFlag()
   if (fromStorage != null) return fromStorage
-  return readEnvFlag()
+  return readEnvFlag() ?? DEFAULT_FLAG
 }
 
 /**

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/src/screens/BacktestScreen.tsx

@@ -148,25 +148,28 @@ function BacktestScreenInner({ data, compact, lang }: Props) {
                   {L('エクイティ & ドローダウン', 'Equity & Drawdown')}
                 </SectionLabel>
                 <div style={{ display: 'flex', gap: 6, alignItems: 'center' }}>
-                  <span
-                    data-testid="renderer-mode"
-                    style={{
-                      fontFamily: 'var(--mono)',
-                      fontSize: 10,
-                      letterSpacing: '0.08em',
-                      color: 'var(--accent)',
-                      padding: '2px 6px',
-                      borderRadius: 4,
-                      background: 'var(--accent-bg)',
-                      border: '1px solid var(--accent-glow)',
-                    }}
-                  >
-                    tv β
-                  </span>
+                  {/* issue #231: TV が既定レンダラになったため、開発時のみバッジを表示（本番露出を防ぐ） */}
                   {showRendererToggle && (
-                    <button type="button" style={exportBtnS} onClick={toggleTvRenderer}>
-                      {L('visx に戻す', 'Switch to visx')}
-                    </button>
+                    <>
+                      <span
+                        data-testid="renderer-mode"
+                        style={{
+                          fontFamily: 'var(--mono)',
+                          fontSize: 10,
+                          letterSpacing: '0.08em',
+                          color: 'var(--accent)',
+                          padding: '2px 6px',
+                          borderRadius: 4,
+                          background: 'var(--accent-bg)',
+                          border: '1px solid var(--accent-glow)',
+                        }}
+                      >
+                        tv
+                      </span>
+                      <button type="button" style={exportBtnS} onClick={toggleTvRenderer}>
+                        {L('visx に戻す', 'Switch to visx')}
+                      </button>
+                    </>
                   )}
                   <button
                     type="button"

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/frontend/src/screens/strategy/SignalChartCard.tsx

@@ -20,7 +20,7 @@ export interface SignalChartCardProps {
  * StrategyScreen の「シグナル時系列」セクション。
  *
  * 責務:
- * - feature flag `?tv=1` の gating（OFF 時は実験機能 placeholder）
+ * - feature flag の gating（既定 ON。`?tv=0` で OFF にした場合は placeholder を表示）
  * - `useStrategyHistorical(symbol)` の loading / no_data / error / ready 分岐
  * - 空 trades のときも chart は表示し caption で「シグナルなし」と伝える
  *
@@ -29,7 +29,7 @@ export interface SignalChartCardProps {
  */
 export function SignalChartCard({ symbol, trades, regimeSeries, lang }: SignalChartCardProps) {
   const L = makeL(lang)
-  // mount 時に 1 回だけ評価。?tv=1 で URL を切り替えた場合はリロード前提（既存 BacktestScreen と同等）。
+  // mount 時に 1 回だけ評価。?tv= で URL を切り替えた場合はリロード前提（既存 BacktestScreen と同等）。
   const [flagOn] = useState(() => resolveLightweightChartsFlag())
 
   if (!flagOn) {
@@ -37,8 +37,8 @@ export function SignalChartCard({ symbol, trades, regimeSeries, lang }: SignalCh
       <CardShell title={L('シグナル時系列', 'Signal Chart')}>
         <Hint>
           {L(
-            'シグナル時系列は実験機能です（?tv=1 で有効化）',
-            'Signal chart is experimental (enable with ?tv=1)',
+            'シグナル時系列は TV レンダラでのみ利用できます（?tv=1 で再有効化）',
+            'Signal chart requires the TV renderer (re-enable with ?tv=1)',
           )}
         </Hint>
       </CardShell>

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/pyproject.toml

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

{alpha_visualizer-0.7.2 → alpha_visualizer-0.7.3}/src/alpha_visualizer/__init__.py

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