docs: added computed property & validator