zulip/static/js/popovers.js

const confirmDatePlugin = require("flatpickr/dist/plugins/confirmDate/confirmDate.js");
const render_actions_popover_content = require('../templates/actions_popover_content.hbs');
const render_mobile_message_buttons_popover = require('../templates/mobile_message_buttons_popover.hbs');
const render_mobile_message_buttons_popover_content = require('../templates/mobile_message_buttons_popover_content.hbs');
const render_no_arrow_popover = require('../templates/no_arrow_popover.hbs');
const render_remind_me_popover_content = require('../templates/remind_me_popover_content.hbs');
const render_user_group_info_popover = require('../templates/user_group_info_popover.hbs');
const render_user_group_info_popover_content = require('../templates/user_group_info_popover_content.hbs');
const render_user_info_popover_content = require('../templates/user_info_popover_content.hbs');
const render_user_info_popover_title = require('../templates/user_info_popover_title.hbs');
const render_user_profile_modal = require("../templates/user_profile_modal.hbs");

let current_actions_popover_elem;
let current_flatpickr_instance;
let current_message_info_popover_elem;
let current_mobile_message_buttons_popover_elem;
let userlist_placement = "right";

let list_of_popovers = [];

// this utilizes the proxy pattern to intercept all calls to $.fn.popover
// and push the $.fn.data($o, "popover") results to an array.
// this is needed so that when we try to unload popovers, we can kill all dead
// ones that no longer have valid parents in the DOM.
(function (popover) {

    $.fn.popover = function () {
        // apply the jQuery object as `this`, and popover function arguments.
        popover.apply(this, arguments);

        // if there is a valid "popover" key in the jQuery data object then
        // push it to the array.
        if (this.data("popover")) {
            list_of_popovers.push(this.data("popover"));
        }
    };

    // add back all shallow properties of $.fn.popover to the new proxied version.
    for (const x in popover) {
        if (popover.hasOwnProperty(x)) {
            $.fn.popover[x] = popover[x];
        }
    }
}($.fn.popover));

function copy_email_handler(e) {
    const email_el = $(e.trigger.parentElement);
    const copy_icon = email_el.find('i');

    // only change the parent element's text back to email
    // and not overwrite the tooltip.
    const email_textnode = email_el[0].childNodes[2];

    email_el.addClass('email_copied');
    email_textnode.nodeValue = i18n.t('Email copied');

    setTimeout(function () {
        email_el.removeClass('email_copied');
        email_textnode.nodeValue = copy_icon.attr('data-clipboard-text');
    }, 1500);
    e.clearSelection();
}

function init_email_clipboard() {
    $('.user_popover_email').each(function () {
        if (this.clientWidth < this.scrollWidth) {
            const email_el = $(this);
            const copy_email_icon = email_el.find('i');
            copy_email_icon.removeClass('hide_copy_icon');

            const copy_email_clipboard = new ClipboardJS(copy_email_icon[0]);
            copy_email_clipboard.on('success', copy_email_handler);
        }
    });
}

function load_medium_avatar(user, elt) {
    const user_avatar_url = "avatar/" + user.user_id + "/medium";
    const sender_avatar_medium = new Image();
    sender_avatar_medium.src = user_avatar_url;
    $(sender_avatar_medium).on("load", function () {
        elt.css("background-image", "url(" + $(this).attr("src") + ")");
    });
}

function calculate_info_popover_placement(size, elt) {
    const ypos = elt.offset().top;

    if (!(ypos + size / 2 < message_viewport.height() &&
          ypos > size / 2)) {
        if (ypos + size < message_viewport.height()) {
            return 'bottom';
        } else if (ypos > size) {
            return 'top';
        }
    }
}

function get_custom_profile_field_data(user, field, field_types, dateFormat) {
    const field_value = people.get_custom_profile_data(user.user_id, field.id);
    const field_type = field.type;
    const profile_field = {};

    if (!field_value) {
        return profile_field;
    }
    if (!field_value.value) {
        return profile_field;
    }
    profile_field.name = field.name;
    profile_field.is_user_field = false;
    profile_field.is_link = field_type === field_types.URL.id;
    profile_field.is_external_account = field_type === field_types.EXTERNAL_ACCOUNT.id;
    profile_field.type = field_type;

    switch (field_type) {
    case field_types.DATE.id:
        profile_field.value = moment(field_value.value).format(dateFormat);
        break;
    case field_types.USER.id:
        profile_field.id = field.id;
        profile_field.is_user_field = true;
        profile_field.value = field_value.value;
        break;
    case field_types.CHOICE.id: {
        const field_choice_dict = JSON.parse(field.field_data);
        profile_field.value = field_choice_dict[field_value.value].text;
        break;
    }
    case field_types.SHORT_TEXT.id:
    case field_types.LONG_TEXT.id:
        profile_field.value = field_value.value;
        profile_field.rendered_value = field_value.rendered_value;
        break;
    case field_types.EXTERNAL_ACCOUNT.id:
        profile_field.value = field_value.value;
        profile_field.field_data = JSON.parse(field.field_data);
        profile_field.link = settings_profile_fields.get_external_account_link(profile_field);
        break;
    default:
        profile_field.value = field_value.value;
    }
    return profile_field;
}

function get_visible_email(user) {
    if (user.delivery_email) {
        return user.delivery_email;
    }
    return user.email;
}

function render_user_info_popover(user, popover_element, is_sender_popover, private_msg_class,
                                  template_class, popover_placement) {
    const is_me = people.is_my_user_id(user.user_id);

    let can_set_away = false;
    let can_revoke_away = false;

    if (is_me) {
        if (user_status.is_away(user.user_id)) {
            can_revoke_away = true;
        } else {
            can_set_away = true;
        }
    }

    const args = {
        can_revoke_away: can_revoke_away,
        can_set_away: can_set_away,
        is_active: people.is_active_user_for_popover(user.user_id),
        is_bot: user.is_bot,
        is_me: is_me,
        is_sender_popover: is_sender_popover,
        pm_with_uri: hash_util.pm_with_uri(user.email),
        user_circle_class: buddy_data.get_user_circle_class(user.user_id),
        private_message_class: private_msg_class,
        sent_by_uri: hash_util.by_sender_uri(user.email),
        show_email: settings_org.show_email(),
        show_user_profile: !(user.is_bot || page_params.custom_profile_fields.length === 0),
        user_email: get_visible_email(user),
        user_full_name: user.full_name,
        user_id: user.user_id,
        user_last_seen_time_status: buddy_data.user_last_seen_time_status(user.user_id),
        user_time: people.get_user_time(user.user_id),
        user_type: people.get_user_type(user.user_id),
        status_text: user_status.get_status_text(user.user_id),
    };

    if (user.is_bot) {
        const is_cross_realm_bot = user.is_cross_realm_bot;
        const bot_owner_id = user.bot_owner_id;
        if (is_cross_realm_bot) {
            args.is_cross_realm_bot = is_cross_realm_bot;
        } else if (bot_owner_id) {
            const bot_owner = people.get_person_from_user_id(bot_owner_id);
            args.bot_owner = bot_owner;
        }
    }

    popover_element.popover({
        content: render_user_info_popover_content(args),
        // TODO: Determine whether `fixed` should be applied
        // unconditionally.  Right now, we only do it for the user
        // sidebar version of the popover.
        fixed: template_class === 'user_popover',
        placement: popover_placement,
        template: render_no_arrow_popover({class: template_class}),
        title: render_user_info_popover_title({
            user_avatar: "avatar/" + user.email,
            user_is_guest: user.is_guest,
        }),
        html: true,
        trigger: "manual",
        top_offset: 100,
        fix_positions: true,
    });
    popover_element.popover("show");

    init_email_clipboard();
    load_medium_avatar(user, $(".popover-avatar"));
}

// exporting for testability
exports._test_calculate_info_popover_placement = calculate_info_popover_placement;

// element is the target element to pop off of
// user is the user whose profile to show
// message is the message containing it, which should be selected
function show_user_info_popover(element, user, message) {
    const last_popover_elem = current_message_info_popover_elem;
    exports.hide_all();
    if (last_popover_elem !== undefined
        && last_popover_elem.get()[0] === element) {
        // We want it to be the case that a user can dismiss a popover
        // by clicking on the same element that caused the popover.
        return;
    }
    current_msg_list.select_id(message.id);
    const elt = $(element);
    if (elt.data('popover') === undefined) {
        if (user === undefined) {
            // This is never supposed to happen, not even for deactivated
            // users, so we'll need to debug this error if it occurs.
            blueslip.error('Bad sender in message' + message.sender_id);
            return;
        }

        const is_sender_popover =  message.sender_id === user.user_id;
        render_user_info_popover(user, elt, is_sender_popover, "respond_personal_button",
                                 "message-info-popover", "right");

        current_message_info_popover_elem = elt;
    }
}

function show_mobile_message_buttons_popover(element) {
    const last_popover_elem = current_mobile_message_buttons_popover_elem;
    exports.hide_all();
    if (last_popover_elem !== undefined
        && last_popover_elem.get()[0] === element) {
        // We want it to be the case that a user can dismiss a popover
        // by clicking on the same element that caused the popover.
        return;
    }

    const $element = $(element);
    $element.popover({
        placement: "left",
        template: render_mobile_message_buttons_popover(),
        content: render_mobile_message_buttons_popover_content({
            is_in_private_narrow: narrow_state.narrowed_to_pms(),
        }),
        html: true,
        trigger: "manual",
    });
    $element.popover("show");

    current_mobile_message_buttons_popover_elem = $element;
}

exports.hide_mobile_message_buttons_popover = function () {
    if (current_mobile_message_buttons_popover_elem) {
        current_mobile_message_buttons_popover_elem.popover("destroy");
        current_mobile_message_buttons_popover_elem = undefined;
    }
};

exports.hide_user_profile = function () {
    $("#user-profile-modal").modal("hide");
};

exports.show_user_profile = function (user) {
    exports.hide_all();

    const dateFormat = moment.localeData().longDateFormat('LL');
    const field_types = page_params.custom_profile_field_types;
    const profile_data = page_params.custom_profile_fields
        .map(function (f) {return get_custom_profile_field_data(user, f, field_types, dateFormat);})
        .filter(function (f) {return f.name !== undefined;});

    const args = {
        full_name: user.full_name,
        email: get_visible_email(user),
        profile_data: profile_data,
        user_avatar: "avatar/" + user.email + "/medium",
        is_me: people.is_current_user(user.email),
        date_joined: moment(user.date_joined).format(dateFormat),
        last_seen: buddy_data.user_last_seen_time_status(user.user_id),
        show_email: settings_org.show_email(),
        user_time: people.get_user_time(user.user_id),
        user_type: people.get_user_type(user.user_id),
        user_is_guest: user.is_guest,
    };

    $("#user-profile-modal-holder").html(render_user_profile_modal(args));
    $("#user-profile-modal").modal("show");

    settings_account.initialize_custom_user_type_fields("#user-profile-modal #content", user.user_id, false, false);
};

function get_user_info_popover_items() {
    if (!current_message_info_popover_elem) {
        blueslip.error('Trying to get menu items when action popover is closed.');
        return;
    }

    const popover_data = current_message_info_popover_elem.data('popover');
    if (!popover_data) {
        blueslip.error('Cannot find popover data for actions menu.');
        return;
    }

    return $('li:not(.divider):visible a', popover_data.$tip);
}

function fetch_group_members(member_ids) {
    return member_ids
        .map(function (m) {
            return people.get_person_from_user_id(m);
        })
        .filter(function (m) {
            return m !== undefined;
        })
        .map(function (p) {
            return Object.assign({}, p, {
                user_circle_class: buddy_data.get_user_circle_class(p.user_id),
                is_active: people.is_active_user_for_popover(p.user_id),
                user_last_seen_time_status: buddy_data.user_last_seen_time_status(p.user_id),
            });
        });
}

function sort_group_members(members) {
    return members
        .sort(function (a, b) {
            return a.full_name.localeCompare(b.full_name);
        });
}

// exporting these functions for testing purposes
exports._test_fetch_group_members = fetch_group_members;
exports._test_sort_group_members = sort_group_members;

// element is the target element to pop off of
// user is the user whose profile to show
// message is the message containing it, which should be selected
function show_user_group_info_popover(element, group, message) {
    const last_popover_elem = current_message_info_popover_elem;
    // hardcoded pixel height of the popover
    // note that the actual size varies (in group size), but this is about as big as it gets
    const popover_size = 390;
    exports.hide_all();
    if (last_popover_elem !== undefined
        && last_popover_elem.get()[0] === element) {
        // We want it to be the case that a user can dismiss a popover
        // by clicking on the same element that caused the popover.
        return;
    }
    current_msg_list.select_id(message.id);
    const elt = $(element);
    if (elt.data('popover') === undefined) {
        const args = {
            group_name: group.name,
            group_description: group.description,
            members: sort_group_members(fetch_group_members(group.members.keys())),
        };
        elt.popover({
            placement: calculate_info_popover_placement(popover_size, elt),
            template: render_user_group_info_popover({class: "message-info-popover"}),
            content: render_user_group_info_popover_content(args),
            html: true,
            trigger: "manual",
        });
        elt.popover("show");
        current_message_info_popover_elem = elt;
    }
}

exports.toggle_actions_popover = function (element, id) {
    const last_popover_elem = current_actions_popover_elem;
    exports.hide_all();
    if (last_popover_elem !== undefined
        && last_popover_elem.get()[0] === element) {
        // We want it to be the case that a user can dismiss a popover
        // by clicking on the same element that caused the popover.
        return;
    }

    $(element).closest('.message_row').toggleClass('has_popover has_actions_popover');
    current_msg_list.select_id(id);
    const elt = $(element);
    if (elt.data('popover') === undefined) {
        const message = current_msg_list.get(id);
        const editability = message_edit.get_editability(message);
        let use_edit_icon;
        let editability_menu_item;
        if (editability === message_edit.editability_types.FULL) {
            use_edit_icon = true;
            editability_menu_item = i18n.t("Edit");
        } else if (editability === message_edit.editability_types.TOPIC_ONLY) {
            use_edit_icon = false;
            editability_menu_item = i18n.t("View source / Edit topic");
        } else {
            use_edit_icon = false;
            editability_menu_item = i18n.t("View source");
        }
        const topic = util.get_message_topic(message);
        const can_mute_topic =
                message.stream &&
                topic &&
                !muting.is_topic_muted(message.stream_id, topic);
        const can_unmute_topic =
                message.stream &&
                topic &&
                muting.is_topic_muted(message.stream_id, topic);

        const should_display_edit_history_option = _.any(message.edit_history, function (entry) {
            const prev_topic = util.get_edit_event_prev_topic(entry);
            return entry.prev_content !== undefined || prev_topic !== undefined;
        }) && page_params.realm_allow_edit_history;

        // Disabling this for /me messages is a temporary workaround
        // for the fact that we don't have a styling for how that
        // should look.  See also condense.js.
        const should_display_collapse = !message.locally_echoed &&
                                      !message.is_me_message &&
                                      !message.collapsed;
        const should_display_uncollapse = !message.locally_echoed &&
                                        !message.is_me_message &&
                                        message.collapsed;

        const should_display_edit_and_view_source =
                message.content !== '<p>(deleted)</p>' ||
                editability === message_edit.editability_types.FULL ||
                editability === message_edit.editability_types.TOPIC_ONLY;
        const should_display_quote_and_reply = message.content !== '<p>(deleted)</p>';

        const conversation_time_uri = hash_util.by_conversation_and_time_uri(message)
            .replace(/\(/g, '%28')
            .replace(/\)/g, '%29');

        const should_display_delete_option = message_edit.get_deletability(message);
        const args = {
            message_id: message.id,
            historical: message.historical,
            stream_id: message.stream_id,
            topic: topic,
            use_edit_icon: use_edit_icon,
            editability_menu_item: editability_menu_item,
            can_mute_topic: can_mute_topic,
            can_unmute_topic: can_unmute_topic,
            should_display_collapse: should_display_collapse,
            should_display_uncollapse: should_display_uncollapse,
            should_display_add_reaction_option: message.sent_by_me,
            should_display_edit_history_option: should_display_edit_history_option,
            conversation_time_uri: conversation_time_uri,
            narrowed: narrow_state.active(),
            should_display_delete_option: should_display_delete_option,
            should_display_reminder_option: feature_flags.reminders_in_message_action_menu,
            should_display_edit_and_view_source: should_display_edit_and_view_source,
            should_display_quote_and_reply: should_display_quote_and_reply,
        };

        const ypos = elt.offset().top;
        elt.popover({
            // Popover height with 7 items in it is ~190 px
            placement: message_viewport.height() - ypos < 220 ? 'top' : 'bottom',
            title: "",
            content: render_actions_popover_content(args),
            html: true,
            trigger: "manual",
        });
        elt.popover("show");
        current_actions_popover_elem = elt;
    }
};

exports.render_actions_remind_popover = function (element, id) {
    exports.hide_all();
    $(element).closest('.message_row').toggleClass('has_popover has_actions_popover');
    current_msg_list.select_id(id);
    const elt = $(element);
    if (elt.data('popover') === undefined) {
        const message = current_msg_list.get(id);
        const args = {
            message: message,
        };
        const ypos = elt.offset().top;
        elt.popover({
            // Popover height with 7 items in it is ~190 px
            placement: message_viewport.height() - ypos < 220 ? 'top' : 'bottom',
            title: "",
            content: render_remind_me_popover_content(args),
            html: true,
            trigger: "manual",
        });
        elt.popover("show");
        current_flatpickr_instance = $('.remind.custom[data-message-id="' + message.id + '"]').flatpickr({
            enableTime: true,
            clickOpens: false,
            defaultDate: moment().format(),
            minDate: 'today',
            plugins: [new confirmDatePlugin({})], // eslint-disable-line new-cap, no-undef
        });
        current_actions_popover_elem = elt;
    }
};

function get_action_menu_menu_items() {
    if (!current_actions_popover_elem) {
        blueslip.error('Trying to get menu items when action popover is closed.');
        return;
    }

    const popover_data = current_actions_popover_elem.data('popover');
    if (!popover_data) {
        blueslip.error('Cannot find popover data for actions menu.');
        return;
    }

    return $('li:not(.divider):visible a', popover_data.$tip);
}

function focus_first_popover_item(items) {
    if (!items) {
        return;
    }

    items.eq(0).expectOne().focus();
}

function popover_items_handle_keyboard(key, items) {
    if (!items) {
        return;
    }

    let index = items.index(items.filter(':focus'));

    if (key === "enter" && index >= 0 && index < items.length) {
        return items[index].click();
    }
    if (index === -1) {
        index = 0;
    } else if ((key === 'down_arrow' || key === 'vim_down') && index < items.length - 1) {
        index += 1;
    } else if ((key === 'up_arrow' || key === 'vim_up') && index > 0) {
        index -= 1;
    }
    items.eq(index).focus();
}

function focus_first_action_popover_item() {
    // For now I recommend only calling this when the user opens the menu with a hotkey.
    // Our popup menus act kind of funny when you mix keyboard and mouse.
    const items = get_action_menu_menu_items();
    focus_first_popover_item(items);
}

exports.open_message_menu = function (message) {
    if (message.locally_echoed) {
        // Don't open the popup for locally echoed messages for now.
        // It creates bugs with things like keyboard handlers when
        // we get the server response.
        return true;
    }

    const id = message.id;
    exports.toggle_actions_popover($(".selected_message .actions_hover")[0], id);
    if (current_actions_popover_elem) {
        focus_first_action_popover_item();
    }
    return true;
};

exports.actions_menu_handle_keyboard = function (key) {
    const items = get_action_menu_menu_items();
    popover_items_handle_keyboard(key, items);
};

exports.actions_popped = function () {
    return current_actions_popover_elem !== undefined;
};

exports.hide_actions_popover = function () {
    if (exports.actions_popped()) {
        $('.has_popover').removeClass('has_popover has_actions_popover');
        current_actions_popover_elem.popover("destroy");
        current_actions_popover_elem = undefined;
    }
    if (current_flatpickr_instance !== undefined) {
        current_flatpickr_instance.destroy();
        current_flatpickr_instance = undefined;
    }
};

exports.message_info_popped = function () {
    return current_message_info_popover_elem !== undefined;
};

exports.hide_message_info_popover = function () {
    if (exports.message_info_popped()) {
        current_message_info_popover_elem.popover("destroy");
        current_message_info_popover_elem = undefined;
    }
};

exports.hide_userlist_sidebar = function () {
    $(".app-main .column-right").removeClass("expanded");
};

exports.hide_pm_list_sidebar = function () {
    $(".app-main .column-left").removeClass("expanded");
};

exports.show_userlist_sidebar = function () {
    $(".app-main .column-right").addClass("expanded");
    resize.resize_page_components();
};

exports.show_pm_list_sidebar = function () {
    $(".app-main .column-left").addClass("expanded");
    resize.resize_page_components();
};

let current_user_sidebar_user_id;
let current_user_sidebar_popover;

function user_sidebar_popped() {
    return current_user_sidebar_popover !== undefined;
}

exports.hide_user_sidebar_popover = function () {
    if (user_sidebar_popped()) {
        // this hide_* method looks different from all the others since
        // the presence list may be redrawn. Due to funkiness with jquery's .data()
        // this would confuse $.popover("destroy"), which looks at the .data() attached
        // to a certain element. We thus save off the .data("popover") in the
        // show_user_sidebar_popover and inject it here before calling destroy.
        $('#user_presences').data("popover", current_user_sidebar_popover);
        $('#user_presences').popover("destroy");
        current_user_sidebar_user_id = undefined;
        current_user_sidebar_popover = undefined;
    }
};

function focus_user_info_popover_item() {
    // For now I recommend only calling this when the user opens the menu with a hotkey.
    // Our popup menus act kind of funny when you mix keyboard and mouse.
    const items = get_user_info_popover_items();
    focus_first_popover_item(items);
}

exports.user_info_popover_handle_keyboard = function (key) {
    const items = get_user_info_popover_items();
    popover_items_handle_keyboard(key, items);
};

exports.show_sender_info = function () {
    const $message = $(".selected_message");
    const $sender = $message.find('.sender_info_hover');

    const message = current_msg_list.get(rows.id($message));
    const user = people.get_person_from_user_id(message.sender_id);
    show_user_info_popover($sender[0], user, message);
    if (current_message_info_popover_elem) {
        focus_user_info_popover_item();
    }
};

// On mobile web, opening the keyboard can trigger a resize event
// (which in turn can trigger a scroll event).  This will have the
// side effect of closing popovers, which we don't want.  So we
// suppress the first hide from scrolling after a resize using this
// variable.
let suppress_scroll_hide = false;

exports.set_suppress_scroll_hide = function () {
    suppress_scroll_hide = true;
};

exports.register_click_handlers = function () {
    $("#main_div").on("click", ".actions_hover", function (e) {
        const row = $(this).closest(".message_row");
        e.stopPropagation();
        exports.toggle_actions_popover(this, rows.id(row));
    });

    $("#main_div").on("click", ".sender_name, .sender_name-in-status, .inline_profile_picture", function (e) {
        const row = $(this).closest(".message_row");
        e.stopPropagation();
        const message = current_msg_list.get(rows.id(row));
        const user = people.get_person_from_user_id(message.sender_id);

        show_user_info_popover(this, user, message);
    });

    $("#main_div").on("click", ".user-mention", function (e) {
        const id = $(this).attr('data-user-id');
        // We fallback to email to handle legacy markdown that was rendered
        // before we cut over to using data-user-id
        const email = $(this).attr('data-user-email');
        if (id === '*' || email === '*') {
            return;
        }
        const row = $(this).closest(".message_row");
        e.stopPropagation();
        const message = current_msg_list.get(rows.id(row));
        let user;
        if (id) {
            user = people.get_person_from_user_id(id);
        } else {
            user = people.get_by_email(email);
        }
        show_user_info_popover(this, user, message);
    });

    $("#main_div").on("click", ".user-group-mention", function (e) {
        const id = $(this).attr('data-user-group-id');
        const row = $(this).closest(".message_row");
        e.stopPropagation();
        const message = current_msg_list.get(rows.id(row));
        const group = user_groups.get_user_group_from_id(id, true);
        if (group === undefined) {
            // This user group has likely been deleted.
            blueslip.info('Unable to find user group in message' + message.sender_id);
        } else {
            show_user_group_info_popover(this, group, message);
        }
    });


    $('body').on('click', '.info_popover_actions .narrow_to_private_messages', function (e) {
        const user_id = $(e.target).parents('ul').attr('data-user-id');
        const email = people.get_person_from_user_id(user_id).email;
        exports.hide_message_info_popover();
        narrow.by('pm-with', email, {trigger: 'user sidebar popover'});
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.info_popover_actions .narrow_to_messages_sent', function (e) {
        const user_id = $(e.target).parents('ul').attr('data-user-id');
        const email = people.get_person_from_user_id(user_id).email;
        exports.hide_message_info_popover();
        narrow.by('sender', email, {trigger: 'user sidebar popover'});
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.user_popover .mention_user', function (e) {
        if (!compose_state.composing()) {
            compose_actions.start('stream', {trigger: 'sidebar user actions'});
        }
        const user_id = $(e.target).parents('ul').attr('data-user-id');
        const name = people.get_person_from_user_id(user_id).full_name;
        const mention = people.get_mention_syntax(name, user_id);
        compose_ui.insert_syntax_and_focus(mention);
        exports.hide_user_sidebar_popover();
        exports.hide_userlist_sidebar();
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.message-info-popover .mention_user', function (e) {
        if (!compose_state.composing()) {
            compose_actions.respond_to_message({trigger: 'user sidebar popover'});
        }
        const user_id = $(e.target).parents('ul').attr('data-user-id');
        const name = people.get_person_from_user_id(user_id).full_name;
        const mention = people.get_mention_syntax(name, user_id);
        compose_ui.insert_syntax_and_focus(mention);
        exports.hide_message_info_popover();
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.info_popover_actions .view_user_profile', function (e) {
        const user_id = $(e.target).parents('ul').attr('data-user-id');
        const user = people.get_person_from_user_id(user_id);
        exports.show_user_profile(user);
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.info_popover_actions .clear_status', function (e) {
        e.preventDefault();
        const me = $(e.target).parents('ul').attr('data-user-id');
        user_status.server_update({
            user_id: me,
            status_text: '',
            success: function () {
                $('.info_popover_actions #status_message').html('');
            },
        });
    });

    $('body').on('click', '.bot-owner-name', function (e) {
        const user_id = $(e.target).attr('data-bot-owner-id');
        const user = people.get_person_from_user_id(user_id);
        exports.show_user_profile(user);
    });

    $('body').on('click', '#user-profile-modal #name #edit-button', function () {
        exports.hide_user_profile();
    });

    $('body').on('click', '.compose_mobile_button', function (e) {
        show_mobile_message_buttons_popover(this);
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.set_away_status', function (e) {
        exports.hide_all();
        user_status.server_set_away();
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.revoke_away_status', function (e) {
        exports.hide_all();
        user_status.server_revoke_away();
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.update_status_text', function (e) {
        exports.hide_all();

        user_status_ui.open_overlay();

        e.stopPropagation();
        e.preventDefault();
    });

    $('#user_presences').on('click', '.user-list-arrow', function (e) {
        e.stopPropagation();

        // use email of currently selected user, rather than some elem comparison,
        // as the presence list may be redrawn with new elements.
        const target = $(this).closest('li');
        const user_id = target.find('a').attr('data-user-id');

        if (String(current_user_sidebar_user_id) === user_id) {
            // If the popover is already shown, clicking again should toggle it.
            // We don't want to hide the sidebars on smaller browser windows.
            exports.hide_all_except_sidebars();
            return;
        }
        exports.hide_all();

        if (userlist_placement === "right") {
            exports.show_userlist_sidebar();
        } else {
            // Maintain the same behavior when displaying with the streamlist.
            stream_popover.show_streamlist_sidebar();
        }

        const user = people.get_person_from_user_id(user_id);
        const popover_placement = userlist_placement === "left" ? "right" : "left";

        render_user_info_popover(user, target, false, "compose_private_message",
                                 "user_popover", popover_placement);

        current_user_sidebar_user_id = user.user_id;
        current_user_sidebar_popover = target.data('popover');
    });

    $('body').on("mouseenter", ".user_popover_email", function () {
        const tooltip_holder = $(this).find('div');

        if (this.offsetWidth < this.scrollWidth) {
            tooltip_holder.addClass('display-tooltip');
        } else {
            tooltip_holder.removeClass('display-tooltip');
        }
    });

    $('body').on('click', '.respond_button', function (e) {
        // Arguably, we should fetch the message ID to respond to from
        // e.target, but that should always be the current selected
        // message in the current message list (and
        // compose_actions.respond_to_message doesn't take a message
        // argument).
        compose_actions.quote_and_reply({trigger: 'popover respond'});
        exports.hide_actions_popover();
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.reminder_button', function (e) {
        const message_id = $(e.currentTarget).data('message-id');
        exports.render_actions_remind_popover($(".selected_message .actions_hover")[0], message_id);
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.remind.custom', function (e) {
        $(e.currentTarget)[0]._flatpickr.toggle();
        e.stopPropagation();
        e.preventDefault();
    });

    function reminder_click_handler(datestr, e) {
        const id = $(".remind.custom").data('message-id');
        reminder.do_set_reminder_for_message(id, datestr);
        exports.hide_all();
        e.stopPropagation();
        e.preventDefault();
    }

    $('body').on('click', '.remind.in_20m', function (e) {
        const datestr = moment().add(20, 'm').format();
        reminder_click_handler(datestr, e);
    });

    $('body').on('click', '.remind.in_1h', function (e) {
        const datestr = moment().add(1, 'h').format();
        reminder_click_handler(datestr, e);
    });

    $('body').on('click', '.remind.in_3h', function (e) {
        const datestr = moment().add(3, 'h').format();
        reminder_click_handler(datestr, e);
    });

    $('body').on('click', '.remind.tomo', function (e) {
        const datestr = moment().add(1, 'd').hour(9).minute(0).seconds(0).format();
        reminder_click_handler(datestr, e);
    });

    $('body').on('click', '.remind.nxtw', function (e) {
        const datestr = moment().add(1, 'w').day('monday').hour(9).minute(0).seconds(0).format();
        reminder_click_handler(datestr, e);
    });

    $('body').on('click', '.flatpickr-calendar', function (e) {
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.flatpickr-confirm', function (e) {
        const datestr = $(".remind.custom")[0].value;
        reminder_click_handler(datestr, e);
    });

    $('body').on('click', '.respond_personal_button, .compose_private_message', function (e) {
        const user_id = $(e.target).parents('ul').attr('data-user-id');
        const email = people.get_person_from_user_id(user_id).email;
        compose_actions.start('private', {
            trigger: 'popover send private',
            private_message_recipient: email});
        exports.hide_all();
        e.stopPropagation();
        e.preventDefault();
    });
    $('body').on('click', '.popover_toggle_collapse', function (e) {
        const message_id = $(e.currentTarget).data('message-id');
        const row = current_msg_list.get_row(message_id);
        const message = current_msg_list.get(rows.id(row));

        exports.hide_actions_popover();

        if (row) {
            if (message.collapsed) {
                condense.uncollapse(row);
            } else {
                condense.collapse(row);
            }
        }

        e.stopPropagation();
        e.preventDefault();
    });
    $('body').on('click', '.popover_edit_message', function (e) {
        const message_id = $(e.currentTarget).data('message-id');
        const row = current_msg_list.get_row(message_id);
        exports.hide_actions_popover();
        message_edit.start(row);
        e.stopPropagation();
        e.preventDefault();
    });
    $('body').on('click', '.view_edit_history', function (e) {
        const message_id = $(e.currentTarget).data('message-id');
        const row = current_msg_list.get_row(message_id);
        const message = current_msg_list.get(rows.id(row));
        const message_history_cancel_btn = $('#message-history-cancel');

        exports.hide_actions_popover();
        message_edit.show_history(message);
        message_history_cancel_btn.focus();
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.popover_mute_topic', function (e) {
        const stream_id = $(e.currentTarget).attr('data-msg-stream-id');
        const topic = $(e.currentTarget).attr('data-msg-topic');

        exports.hide_actions_popover();
        muting_ui.mute(stream_id, topic);
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.popover_unmute_topic', function (e) {
        const stream_id = $(e.currentTarget).attr('data-msg-stream-id');
        const topic = $(e.currentTarget).attr('data-msg-topic');

        exports.hide_actions_popover();
        muting_ui.unmute(stream_id, topic);
        e.stopPropagation();
        e.preventDefault();
    });

    $('body').on('click', '.delete_message', function (e) {
        const message_id = $(e.currentTarget).data('message-id');
        exports.hide_actions_popover();
        message_edit.delete_message(message_id);
        e.stopPropagation();
        e.preventDefault();
    });

    new ClipboardJS('.copy_link');

    $('body').on('click', '.copy_link', function (e) {
        exports.hide_actions_popover();
        const id = $(this).attr("data-message-id");
        const row = $("[zid='" + id + "']");
        row.find(".alert-msg")
            .text(i18n.t("Copied!"))
            .css("display", "block")
            .delay(1000).fadeOut(300);

        setTimeout(function () {
            // The Cliboard library works by focusing to a hidden textarea.
            // We unfocus this so keyboard shortcuts, etc., will work again.
            $(":focus").blur();
        }, 0);

        e.stopPropagation();
        e.preventDefault();
    });

    (function () {
        let last_scroll = 0;

        $('.app').on('scroll', function () {
            if (suppress_scroll_hide) {
                suppress_scroll_hide = false;
                return;
            }

            const date = new Date().getTime();

            // only run `popovers.hide_all()` if the last scroll was more
            // than 250ms ago.
            if (date - last_scroll > 250) {
                exports.hide_all();
            }

            // update the scroll time on every event to make sure it doesn't
            // retrigger `hide_all` while still scrolling.
            last_scroll = date;
        });
    }());
};

exports.any_active = function () {
    // True if any popover (that this module manages) is currently shown.
    // Expanded sidebars on mobile view count as popovers as well.
    return exports.actions_popped() || user_sidebar_popped() ||
        stream_popover.stream_popped() || stream_popover.topic_popped() ||
        exports.message_info_popped() || emoji_picker.reactions_popped() ||
        $("[class^='column-'].expanded").length;
};

// This function will hide all true popovers (the streamlist and
// userlist sidebars use the popover infrastructure, but doesn't work
// like a popover structurally).
exports.hide_all_except_sidebars = function () {
    $('.has_popover').removeClass('has_popover has_actions_popover has_emoji_popover');
    exports.hide_actions_popover();
    exports.hide_message_info_popover();
    emoji_picker.hide_emoji_popover();
    stream_popover.hide_stream_popover();
    stream_popover.hide_topic_popover();
    stream_popover.hide_all_messages_popover();
    stream_popover.hide_starred_messages_popover();
    exports.hide_user_sidebar_popover();
    exports.hide_mobile_message_buttons_popover();
    exports.hide_user_profile();

    // look through all the popovers that have been added and removed.
    list_of_popovers.forEach(function ($o) {
        if (!document.body.contains($o.$element[0]) && $o.$tip) {
            $o.$tip.remove();
        }
    });
    list_of_popovers = [];
};

// This function will hide all the popovers, including the mobile web
// or narrow window sidebars.
exports.hide_all = function () {
    exports.hide_userlist_sidebar();
    stream_popover.hide_streamlist_sidebar();
    exports.hide_all_except_sidebars();
};

exports.set_userlist_placement = function (placement) {
    userlist_placement = placement || "right";
};

exports.compute_placement = function (elt, popover_height, popover_width,
                                      prefer_vertical_positioning) {
    const client_rect = elt.get(0).getBoundingClientRect();
    const distance_from_top = client_rect.top;
    const distance_from_bottom = message_viewport.height() - client_rect.bottom;
    const distance_from_left = client_rect.left;
    const distance_from_right = message_viewport.width() - client_rect.right;

    const elt_will_fit_horizontally =
        distance_from_left + elt.width() / 2 > popover_width / 2 &&
        distance_from_right + elt.width() / 2 > popover_width / 2;

    const elt_will_fit_vertically =
        distance_from_bottom + elt.height() / 2 > popover_height / 2 &&
        distance_from_top + elt.height() / 2 > popover_height / 2;

    // default to placing the popover in the center of the screen
    let placement = 'viewport_center';

    // prioritize left/right over top/bottom
    if (distance_from_top > popover_height && elt_will_fit_horizontally) {
        placement = 'top';
    }
    if (distance_from_bottom > popover_height && elt_will_fit_horizontally) {
        placement = 'bottom';
    }

    if (prefer_vertical_positioning && placement !== 'viewport_center') {
        // If vertical positioning is preferred and the popover fits in
        // either top or bottom position then return.
        return placement;
    }

    if (distance_from_left > popover_width && elt_will_fit_vertically) {
        placement = 'left';
    }
    if (distance_from_right > popover_width && elt_will_fit_vertically) {
        placement = 'right';
    }

    return placement;
};

window.popovers = exports;