Как задокументировать parent в IDE на примере YII2?
Мне кажется никак.
Трейт должен реализовывать общие функции. И может быть внедрен в любой класс. С чего вы взяли, что у класса, который внедрит трейт, будет наследован от нужного Вам класса и иметь соответствующую функцию?
Единственный совет - использовать тот же $this.
Или использовать не трейт, а промежуточную модель, поскольку Вы явно подразумеваете использование данной функции только в модели и только в ActiveRecord
Я бы сделал это через behavior а не через trait, что решит много проблем, но будет незначительнее медленнее работать.
Советую почитать вот эту статейку:Поведение или трейт