✨ Phase δ：render hook context への周期情報追加と API version 2 化

[EllaCoat]

概要

render hook の context に animation 単位の周期情報を追加し、公開 API version を 2 へ上げます。
外部 plugin が「表示上の最終 frame」を判定可能にすることが目的です。
従来は context に animation object のみが含まれており、plugin 側で内部構造を推測する必要がありました。

主な変更点

変更	内容
context の拡張	RenderAnimationContext に readonly の animationLengthSeconds / renderSampleCount / loopMode / loopDelayFrames を追加
API version	RENDER_HOOKS_API.version を 1 から 2 へ。必須 context の追加に伴う破壊的変更
frame ループ	訪れる時刻の列を先に配列化し、loop 本体も同じ配列を回す構成へ変更
異常値の扱い	length が +Infinity の場合と、時刻が進まなくなった場合に throw

renderSampleCount は render loop が実際に生成する frame 数そのものです。
animation.length から再計算すると丸め誤差で off-by-one が発生するため、同一配列から長さを取得します。
loop 直後に frames.length と突合する dev guard (= warn のみ) を配置しました。

周期情報は rendered object と同一 source から構築します。
animation.select() の同期 dispatch による context と datapack meta の不一致を防ぐためです。

spring 固有のロジックは含めていません。
「最終 frame が N-2 か N-1 か」という解釈は Minecraft runtime の挙動に依存するため、利用側の plugin に委ねます。

動作確認

• yarn test : 104 passed / 1 todo
• yarn lint : 変更前と同一 (問題数の増加なし)
• hook 未登録時の出力が従来と完全に同一であることを既存 test で検証

有限長の animation で 時刻列そのもの が変更前と一致することを test で固定しました。
frame 数だけの比較では「件数は同じだが時刻が変わる」回帰を検出できないためです。

設計判断

• 異常値は一律の件数上限ではなく、終わらない条件だけを弾く。 上限を設けると長尺 animation の出力が短くなり、従来と同一の出力を保証できなくなるためです。
• NaN / -Infinity は throw しない。 0 frame で処理される従来の挙動を維持します。ハングの原因となる +Infinity のみを制限対象としました。
• 時刻列の生成位置は context 組み立ての直前。 onBeginAnimation の dispatch 前に確定させる必要があります。副作用として、hook 内で animation.length を書き換えても loop 回数は不変となりますが、これは renderSampleCount の保証として正しい挙動です。

注意

loopMode は文字列 ('once' / 'hold' / 'loop') です。
datapack meta の lp (score 値) とはエンコードが異なります。
指す設定は同じですが、値の表現が異なる点に注意してください。