Function mapUsersToOptions

site/src/pages/TasksPage/UsersCombobox.tsx:133–165

(
	users: readonly User[],
	/**
	 * Includes the authenticated user in the list if they are not already
	 * present. So the current user can always select themselves easily.
	 */
	authUser: User,
	/**
	 * Username of the currently selected user.
	 */
	selectedValue: string,
)

};

function mapUsersToOptions(
	users: readonly User[],
	/**
	 * Includes the authenticated user in the list if they are not already
	 * present. So the current user can always select themselves easily.
	 */
	authUser: User,
	/**
	 * Username of the currently selected user.
	 */
	selectedValue: string,
): UserOption[] {
	const includeAuthenticatedUser = (users: readonly User[]) => {
		const hasAuthenticatedUser = users.some(
			(u) => u.username === authUser.username,
		);
		if (hasAuthenticatedUser) {
			return users;
		}
		return [authUser, ...users];
	};

	const sortSelectedFirst = (a: User) =>
		selectedValue && a.username === selectedValue ? -1 : 0;

	return includeAuthenticatedUser(users)
		.toSorted(sortSelectedFirst)
		.map((user) => ({
			label: user.name || user.username,
			value: user.username,
			avatarUrl: user.avatar_url,
		}));
}