'Admin', self::Editor => 'Editor', self::Marker => 'Marker', self::Viewer => 'Viewer', }; } /** * Determine whether the role may change a todo's completion state. */ public function canMarkComplete(): bool { return $this !== self::Viewer; } /** * Determine whether the role may create, edit or delete todos. Editors * manage todo content only; folder structure and collaborators are an * admin concern. */ public function canEditTodos(): bool { return in_array($this, [self::Admin, self::Editor], true); } /** * Determine whether the role may manage the folder itself: its structure, * visibility and collaborators, and new folders beneath it. */ public function canManage(): bool { return $this === self::Admin; } /** * Get the folder roles a collaborator may be assigned, most privileged * first. * * @return list */ public static function assignable(): array { return [self::Admin, self::Editor, self::Marker, self::Viewer]; } /** * Get this role's rank, so the strongest of two roles can be picked. */ public function rank(): int { return match ($this) { self::Admin => 3, self::Editor => 2, self::Marker => 1, self::Viewer => 0, }; } /** * Get the strongest of the two roles, ignoring missing ones. */ public static function higherOf(?self $left, ?self $right): ?self { if ($left === null) { return $right; } if ($right === null) { return $left; } return $left->rank() >= $right->rank() ? $left : $right; } }