LCOV - code coverage report
Current view: top level - components - activity.go Coverage Total Hit
Test: coverage.lcov Lines: 0.0 % 19 0
Test Date: 2026-11-19 00:25:22 Functions: - 0 0

            Line data    Source code
       1              : package components
       2              : 
       3              : import (
       4              :         "github.com/kijimaD/ruins/internal/i18n"
       5              :         "github.com/mlange-42/ark/ecs"
       6              : )
       7              : 
       8              : // ActivityState はアクティビティの実行状態を表す
       9              : type ActivityState int
      10              : 
      11              : const (
      12              :         // ActivityStateRunning はアクティビティが実行中であることを表す
      13              :         ActivityStateRunning ActivityState = iota
      14              :         // ActivityStatePaused はアクティビティが一時停止中であることを表す
      15              :         ActivityStatePaused
      16              :         // ActivityStateCompleted はアクティビティが完了したことを表す
      17              :         ActivityStateCompleted
      18              :         // ActivityStateCanceled はアクティビティがキャンセルされたことを表す
      19              :         ActivityStateCanceled
      20              : )
      21              : 
      22              : // String はActivityStateの文字列表現を返す
      23              : func (s ActivityState) String() string {
      24            0 :         switch s {
      25              :         case ActivityStateRunning:
      26            0 :                 return "Running"
      27              :         case ActivityStatePaused:
      28            0 :                 return "Paused"
      29              :         case ActivityStateCompleted:
      30            0 :                 return "Completed"
      31              :         case ActivityStateCanceled:
      32            0 :                 return "Canceled"
      33              :         default:
      34            0 :                 return "Unknown"
      35              :         }
      36              : }
      37              : 
      38              : // BehaviorName はアクティビティの種類を表す列挙型
      39              : type BehaviorName string
      40              : 
      41              : // BehaviorName の定義
      42              : const (
      43              :         BehaviorMove      BehaviorName = "Move"
      44              :         BehaviorMelee     BehaviorName = "Melee"
      45              :         BehaviorRest      BehaviorName = "Rest"
      46              :         BehaviorWait      BehaviorName = "Wait"
      47              :         BehaviorPickup    BehaviorName = "Pickup"
      48              :         BehaviorDrop      BehaviorName = "Drop"
      49              :         BehaviorUseItem   BehaviorName = "UseItem"
      50              :         BehaviorTalk      BehaviorName = "Talk"
      51              :         BehaviorOpenDoor  BehaviorName = "OpenDoor"
      52              :         BehaviorCloseDoor BehaviorName = "CloseDoor"
      53              :         BehaviorPortal    BehaviorName = "Portal"
      54              :         BehaviorStorage   BehaviorName = "Storage"
      55              :         BehaviorRead      BehaviorName = "Read"
      56              :         BehaviorShoot     BehaviorName = "Shoot"
      57              :         BehaviorReload    BehaviorName = "Reload"
      58              :         // BehaviorIgnite は火種で隣接の燃焼物に火をつけて焚き火を熾す。ExecuteInteraction が直接処理する
      59              :         BehaviorIgnite BehaviorName = "Ignite"
      60              :         // BehaviorFeedFuel は隣接の火へ燃料をくべる給油メニューを開く。ExecuteInteraction が直接処理する
      61              :         BehaviorFeedFuel BehaviorName = "FeedFuel"
      62              :         // BehaviorSleep は疲労が抜けるまで眠り続ける。外因で中断される
      63              :         BehaviorSleep BehaviorName = "Sleep"
      64              :         // BehaviorSwap は隣接の相手と位置を入れ替える
      65              :         BehaviorSwap BehaviorName = "Swap"
      66              :         // BehaviorDisassemble は所持品のアイテムを材質の素材に戻す
      67              :         BehaviorDisassemble BehaviorName = "Disassemble"
      68              :         // BehaviorSearch はまだ探していない収納を探し、終えると収納を開く
      69              :         BehaviorSearch BehaviorName = "Search"
      70              : )
      71              : 
      72              : // Activity は実行中のアクティビティを保持するコンポーネント
      73              : // 1エンティティにつき最大1つのアクティビティを持つ
      74              : type Activity struct {
      75              :         BehaviorName BehaviorName   // アクティビティの種類
      76              :         State        ActivityState  // 実行状態
      77              :         Progress     IntPool        // Max=完了に必要な総量、Current=注ぎ込んだ総量。Current>=Max で完了。初回ステップで満ちれば即時アクションになる
      78              :         Params       ActivityParams // 各アクティビティ固有のパラメータ。無いアクションは nil
      79              :         CancelReason i18n.Msgid     // キャンセル理由
      80              : }
      81              : 
      82              : // ActivityParams は各アクティビティ固有のパラメータを表すマーカーインターフェース。
      83              : // Activity は serde の skip 対象なので、interface を保持しても保存互換に影響しない。
      84              : // VisualEffect と同じく、依存の無いデータだけを components 層の interface として持つ。
      85              : // 実行ロジックを持つ Behavior は w.World に依存するため activity 層に置く。
      86              : //
      87              : // 型の分け方: 対象が1エンティティでも意味が behavior ごとに違うものは共有せず専用型に分ける。
      88              : // 攻撃対象と会話相手は同じ ecs.Entity だが意味が違うので MeleeParams などに分ける。
      89              : // 一方 PlaceParams のように共有ヘルパを介して同じ形を使い回すものは共有型のままにする。
      90              : type ActivityParams interface {
      91              :         isActivityParams()
      92              : }
      93              : 
      94              : // MoveParams は移動アクションのパラメータ。
      95              : type MoveParams struct {
      96              :         Destination GridElement // 移動先タイル
      97              : }
      98              : 
      99            0 : func (*MoveParams) isActivityParams() {}
     100              : 
     101              : // MeleeParams は近接攻撃のパラメータ。
     102              : type MeleeParams struct {
     103              :         Target ecs.Entity // 攻撃対象のエンティティ
     104              : }
     105              : 
     106            0 : func (*MeleeParams) isActivityParams() {}
     107              : 
     108              : // TalkParams は会話のパラメータ。
     109              : type TalkParams struct {
     110              :         Target ecs.Entity // 会話相手のエンティティ
     111              : }
     112              : 
     113            0 : func (*TalkParams) isActivityParams() {}
     114              : 
     115              : // OpenDoorParams は扉を開くアクションのパラメータ。
     116              : type OpenDoorParams struct {
     117              :         Target ecs.Entity // 開く扉のエンティティ
     118              : }
     119              : 
     120            0 : func (*OpenDoorParams) isActivityParams() {}
     121              : 
     122              : // CloseDoorParams は扉を閉じるアクションのパラメータ。
     123              : type CloseDoorParams struct {
     124              :         Target ecs.Entity // 閉じる扉のエンティティ
     125              : }
     126              : 
     127            0 : func (*CloseDoorParams) isActivityParams() {}
     128              : 
     129              : // SwapParams は位置を入れ替えるアクションのパラメータ。
     130              : type SwapParams struct {
     131              :         Target ecs.Entity // 入れ替える相手のエンティティ
     132              : }
     133              : 
     134            0 : func (*SwapParams) isActivityParams() {}
     135              : 
     136              : // ShootParams は射撃のパラメータ。
     137              : type ShootParams struct {
     138              :         Target ecs.Entity // 射撃対象のエンティティ
     139              : }
     140              : 
     141            0 : func (*ShootParams) isActivityParams() {}
     142              : 
     143              : // UseItemParams はアイテム使用のパラメータ。
     144              : type UseItemParams struct {
     145              :         Target ecs.Entity // 使用するアイテムのエンティティ
     146              : }
     147              : 
     148            0 : func (*UseItemParams) isActivityParams() {}
     149              : 
     150              : // ReadParams は読書のパラメータ。
     151              : type ReadParams struct {
     152              :         Target ecs.Entity // 読む本のエンティティ
     153              : }
     154              : 
     155            0 : func (*ReadParams) isActivityParams() {}
     156              : 
     157              : // DisassembleParams はアイテムの分解のパラメータ。
     158              : type DisassembleParams struct {
     159              :         Target ecs.Entity // 分解するアイテムのエンティティ
     160              : }
     161              : 
     162            0 : func (*DisassembleParams) isActivityParams() {}
     163              : 
     164              : // SearchParams は収納を探すアクティビティのパラメータ。
     165              : type SearchParams struct {
     166              :         Target ecs.Entity // 探す収納のエンティティ
     167              : }
     168              : 
     169            0 : func (*SearchParams) isActivityParams() {}
     170              : 
     171              : // PlaceParams は対象と操作先を取るアクションのパラメータ。ドロップ・押し引きが使う。
     172              : type PlaceParams struct {
     173              :         Target      ecs.Entity  // 操作対象のエンティティ
     174              :         Destination GridElement // 操作先タイル
     175              : }
     176              : 
     177            0 : func (*PlaceParams) isActivityParams() {}
     178              : 
     179              : // PickupParams は拾得アクションのパラメータ。拾う対象は呼び出し側が確定して渡す。
     180              : // 単一のアイテムでも足元一掃でも、拾うエンティティの並びを Targets として同じ形で持つ。
     181              : // タイル上の何を拾うかという決定は behavior でなく構築側にあり、標識に頼らない。
     182              : type PickupParams struct {
     183              :         Targets []ecs.Entity // 拾うエンティティ。空なら検証で弾く
     184              : }
     185              : 
     186            0 : func (*PickupParams) isActivityParams() {}
     187              : 
     188              : // LastActivity は直近のアクティビティ実行結果を保持するコンポーネント
     189              : type LastActivity struct {
     190              :         BehaviorName BehaviorName  // 実行されたアクティビティ名
     191              :         State        ActivityState // アクティビティの終了状態
     192              :         Success      bool          // 成功/失敗
     193              :         Message      string        // 結果メッセージ
     194              : }
        

Generated by: LCOV version 2.0-1