LCOV - code coverage report
Current view: top level - hooks - tabmenu.go Coverage Total Hit
Test: coverage.lcov Lines: 94.3 % 87 82
Test Date: 2026-11-19 00:25:22 Functions: - 0 0

            Line data    Source code
       1              : package hooks
       2              : 
       3              : import "github.com/kijimaD/ruins/internal/inputmapper"
       4              : 
       5              : // TabMenuConfig はタブメニューの設定
       6              : type TabMenuConfig struct {
       7              :         TabCount     int      // タブの数
       8              :         ItemCounts   []int    // 各タブのアイテム数
       9              :         ItemsPerPage int      // 1ページに表示するアイテム数(0=ペジネーションなし)
      10              :         Skips        [][]bool // 各タブのスキップ判定。trueの位置はカーソルが止まらない
      11              : }
      12              : 
      13              : // TabMenuState はタブメニューの状態
      14              : type TabMenuState struct {
      15              :         TabIndex  int
      16              :         ItemIndex int
      17              :         Page      int // 現在のページ(0ベース)
      18              : }
      19              : 
      20              : // tabMenuNav はタブメニューのナビゲーションロジックを保持する
      21              : type tabMenuNav struct {
      22              :         config TabMenuConfig
      23              : }
      24              : 
      25              : func (n *tabMenuNav) itemCountForTab(tabIdx int) int {
      26            1 :         if tabIdx >= 0 && tabIdx < len(n.config.ItemCounts) {
      27            1 :                 return n.config.ItemCounts[tabIdx]
      28            1 :         }
      29            1 :         return 0
      30              : }
      31              : 
      32              : func (n *tabMenuNav) isSkip(tabIdx, itemIdx int) bool {
      33            1 :         if tabIdx < 0 || tabIdx >= len(n.config.Skips) {
      34            1 :                 return false
      35            1 :         }
      36            1 :         skips := n.config.Skips[tabIdx]
      37            1 :         if itemIdx < 0 || itemIdx >= len(skips) {
      38            1 :                 return false
      39            1 :         }
      40            1 :         return skips[itemIdx]
      41              : }
      42              : 
      43              : // skipNext は指定タブ内で指定方向にスキップ対象でない次のインデックスを返す
      44              : func (n *tabMenuNav) skipNext(tabIdx, idx, dir int) int {
      45            1 :         count := n.itemCountForTab(tabIdx)
      46            1 :         if tabIdx < 0 || tabIdx >= len(n.config.Skips) || len(n.config.Skips[tabIdx]) == 0 {
      47            1 :                 return idx
      48            1 :         }
      49            1 :         for range count {
      50            1 :                 if !n.isSkip(tabIdx, idx) {
      51            1 :                         return idx
      52            1 :                 }
      53            1 :                 idx = (idx + dir + count) % count
      54              :         }
      55            1 :         return idx
      56              : }
      57              : 
      58              : func (n *tabMenuNav) firstSelectable(tabIdx int) int {
      59            1 :         return n.skipNext(tabIdx, 0, 1)
      60            1 : }
      61              : 
      62              : // clamp はアイテム数変化に対してインデックスを安全な範囲に収める
      63              : func (n *tabMenuNav) clamp(s TabMenuState) TabMenuState {
      64            1 :         count := n.itemCountForTab(s.TabIndex)
      65            1 :         if count == 0 {
      66            1 :                 s.ItemIndex = 0
      67            2 :         } else if s.ItemIndex >= count {
      68            1 :                 s.ItemIndex = count - 1
      69            1 :         }
      70            1 :         return s
      71              : }
      72              : 
      73              : // navHandlers は移動系 Action と状態遷移の対応表。移動系の集合の唯一の定義で、
      74              : // DispatchNav の消費判定も reduce の分岐もここから導く。集合と挙動が別の場所に複製されると
      75              : // 片方だけ更新してずれるため、1つの表に束ねる
      76              : var navHandlers = map[inputmapper.ActionID]func(*tabMenuNav, TabMenuState) TabMenuState{
      77              :         inputmapper.ActionMenuTabPrev: (*tabMenuNav).tabPrev,
      78              :         inputmapper.ActionMenuTabNext: (*tabMenuNav).tabNext,
      79              :         inputmapper.ActionMenuUp:      (*tabMenuNav).up,
      80              :         inputmapper.ActionMenuDown:    (*tabMenuNav).down,
      81              :         inputmapper.ActionMenuLeft:    (*tabMenuNav).left,
      82              :         inputmapper.ActionMenuRight:   (*tabMenuNav).right,
      83              : }
      84              : 
      85              : // reduce はアクションに応じて状態を更新する。移動系でなければ何もしない
      86              : func (n *tabMenuNav) reduce(s TabMenuState, a inputmapper.ActionID) TabMenuState {
      87            1 :         s = n.clamp(s)
      88            1 :         if h, ok := navHandlers[a]; ok {
      89            1 :                 return h(n, s)
      90            1 :         }
      91            1 :         return s
      92              : }
      93              : 
      94              : // tabPrev は前のタブへ循環して移り、カーソルを新タブの先頭選択可能行へ置く
      95              : func (n *tabMenuNav) tabPrev(s TabMenuState) TabMenuState {
      96            1 :         if n.config.TabCount == 0 {
      97            1 :                 return s
      98            1 :         }
      99            1 :         newTab := (s.TabIndex - 1 + n.config.TabCount) % n.config.TabCount
     100            1 :         return TabMenuState{TabIndex: newTab, ItemIndex: n.firstSelectable(newTab)}
     101              : }
     102              : 
     103              : // tabNext は次のタブへ循環して移り、カーソルを新タブの先頭選択可能行へ置く
     104              : func (n *tabMenuNav) tabNext(s TabMenuState) TabMenuState {
     105            1 :         if n.config.TabCount == 0 {
     106            1 :                 return s
     107            1 :         }
     108            1 :         newTab := (s.TabIndex + 1) % n.config.TabCount
     109            1 :         return TabMenuState{TabIndex: newTab, ItemIndex: n.firstSelectable(newTab)}
     110              : }
     111              : 
     112              : // up はカーソルを1つ上へ動かす。端では循環し、見出し行は飛ばす
     113              : func (n *tabMenuNav) up(s TabMenuState) TabMenuState {
     114            1 :         count := n.itemCountForTab(s.TabIndex)
     115            1 :         if count == 0 {
     116            1 :                 return s
     117            1 :         }
     118            1 :         next := (s.ItemIndex - 1 + count) % count
     119            1 :         return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, next, -1)}
     120              : }
     121              : 
     122              : // down はカーソルを1つ下へ動かす。端では循環し、見出し行は飛ばす
     123              : func (n *tabMenuNav) down(s TabMenuState) TabMenuState {
     124            1 :         count := n.itemCountForTab(s.TabIndex)
     125            1 :         if count == 0 {
     126            1 :                 return s
     127            1 :         }
     128            1 :         next := (s.ItemIndex + 1) % count
     129            1 :         return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, next, 1)}
     130              : }
     131              : 
     132              : // left はページを1つ前へ繰る。ページ送りが無効か先頭ページなら何もしない
     133              : func (n *tabMenuNav) left(s TabMenuState) TabMenuState {
     134            1 :         if n.config.ItemsPerPage > 0 && s.ItemIndex >= n.config.ItemsPerPage {
     135            1 :                 return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, s.ItemIndex-n.config.ItemsPerPage, 1)}
     136            1 :         }
     137            1 :         return s
     138              : }
     139              : 
     140              : // right はページを1つ次へ繰る。ページ送りが無効か末尾ページなら何もしない
     141              : func (n *tabMenuNav) right(s TabMenuState) TabMenuState {
     142            1 :         count := n.itemCountForTab(s.TabIndex)
     143            1 :         if n.config.ItemsPerPage > 0 && s.ItemIndex+n.config.ItemsPerPage < count {
     144            1 :                 return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, s.ItemIndex+n.config.ItemsPerPage, 1)}
     145            1 :         }
     146            1 :         return s
     147              : }
     148              : 
     149              : // SetTab は指定タブへ直接カーソルを移す。新タブの先頭選択可能行へカーソルを置き、範囲外はクランプする。
     150              : // キー再生を避けてタブを設定する用途に使う。UseTabMenu と同じ nav ロジックを通す
     151              : func SetTab(store *Store, keyPrefix string, config TabMenuConfig, tab int) {
     152            1 :         nav := &tabMenuNav{config: config}
     153            1 :         store.set(keyPrefix, nav.clamp(TabMenuState{TabIndex: tab, ItemIndex: nav.firstSelectable(tab)}))
     154            1 : }
     155              : 
     156              : // DispatchNav はカーソル移動系の Action なら Dispatch して真を返し、それ以外は何もせず偽を返す。
     157              : // 呼び出し側は集合を知る必要がなく、消費されなかった Action をそのまま後続へ渡せばよい。
     158              : // 消費の可否は navHandlers の所属と一致するので、reduce の実行を待たず同期的に答えられる
     159              : func (m *Mount[Props]) DispatchNav(a inputmapper.ActionID) bool {
     160            0 :         if _, ok := navHandlers[a]; !ok {
     161            0 :                 return false
     162            0 :         }
     163            0 :         m.Dispatch(a)
     164            0 :         return true
     165              : }
     166              : 
     167              : // UseTabMenu は再利用可能なタブメニュー状態管理を提供する
     168              : // ReactのカスタムHooksに相当するパターンで、複数のUseStateを組み合わせる
     169              : // keyPrefixは状態キーの接頭辞で、複数のタブメニューを区別するために使う
     170              : // 端での循環は常に有効
     171              : // ペジネーションが有効な場合、ページはitemIndexから自動計算される
     172              : // タブ切り替え: Tab / Shift+Tab
     173              : // ページ移動: 左右キー
     174              : func UseTabMenu(store *Store, keyPrefix string, config TabMenuConfig) TabMenuState {
     175            1 :         nav := &tabMenuNav{config: config}
     176            1 : 
     177              :         // tabIndexとitemIndexを複合状態として管理する。
     178              :         // 単一のreducerでタブ切り替えとアイテム移動を原子的に処理するため、
     179              :         // タブ切り替え時に新タブのitemsで正しくfirstSelectableを計算できる
     180            1 :         init := TabMenuState{ItemIndex: nav.firstSelectable(0)}
     181            1 :         state := nav.clamp(UseState(store, keyPrefix, init, nav.reduce))
     182            1 :         // クランプ後の値をstoreに反映して、UI側が参照する値と一致させる
     183            1 :         store.set(keyPrefix, state)
     184            1 : 
     185              :         // ページはitemIndexから派生する値として計算
     186            1 :         itemCount := nav.itemCountForTab(state.TabIndex)
     187            1 :         if nav.config.ItemsPerPage > 0 && itemCount > 0 {
     188            1 :                 state.Page = state.ItemIndex / nav.config.ItemsPerPage
     189            1 :         }
     190              : 
     191            1 :         return state
     192              : }
        

Generated by: LCOV version 2.0-1