Zulip server and web application. Open-source team chat that helps teams stay productive and focused.
import {$} from "jquery";
import _ from "lodash";
import assert from "minimalistic-assert";
import type * as tippy from "tippy.js";
import render_delete_topic_modal from "../templates/confirm_dialog/confirm_delete_topic.hbs";
import render_left_sidebar_topic_actions_popover from "../templates/popovers/left_sidebar/left_sidebar_topic_actions_popover.hbs";
import render_left_sidebar_topic_links_popover from "../templates/popovers/left_sidebar/left_sidebar_topic_links_popover.hbs";
import * as clipboard_handler from "./clipboard_handler.ts";
import * as confirm_dialog from "./confirm_dialog.ts";
import * as hash_util from "./hash_util.ts";
import {$t, $t_html} from "./i18n.ts";
import * as message_delete from "./message_delete.ts";
import * as message_edit from "./message_edit.ts";
import * as message_store from "./message_store.ts";
import * as message_summary from "./message_summary.ts";
import * as popover_menus from "./popover_menus.ts";
import * as popover_menus_data from "./popover_menus_data.ts";
import * as recent_view_ui from "./recent_view_ui.ts";
import * as starred_messages_ui from "./starred_messages_ui.ts";
import {realm} from "./state_data.ts";
import * as stream_data from "./stream_data.ts";
import * as stream_popover from "./stream_popover.ts";
import * as stream_topic_history from "./stream_topic_history.ts";
import type {StreamSubscription} from "./sub_store.ts";
import * as tippyjs from "./tippyjs.ts";
import * as topic_link_util from "./topic_link_util.ts";
import * as ui_util from "./ui_util.ts";
import * as unread_ops from "./unread_ops.ts";
import * as user_topics from "./user_topics.ts";
import * as util from "./util.ts";
function get_conversation(instance: tippy.Instance): {
stream_id: number;
topic_name: string;
url: string;
} {
let stream_id;
let topic_name;
let url;
if (instance.reference.classList.contains("recipient-bar-control")) {
const $elt = $(instance.reference);
const $message_header = $elt.closest(".message_header").expectOne();
stream_id = Number.parseInt($message_header.attr("data-stream-id")!, 10);
topic_name = $message_header.attr("data-topic-name")!;
const topic_narrow_url = stream_topic_history.channel_topic_permalink_hash(
stream_id,
topic_name,
);
url = new URL(topic_narrow_url, realm.realm_url).href;
} else if (!instance.reference.classList.contains("topic-sidebar-menu-icon")) {
const $elt = $(instance.reference);
stream_id = Number.parseInt($elt.attr("data-stream-id")!, 10);
topic_name = $elt.attr("data-topic-name")!;
url = new URL($elt.attr("data-topic-url")!, realm.realm_url).href;
} else {
const $elt = $(instance.reference).closest(".topic-sidebar-menu-icon").expectOne();
const $stream_li = $elt.closest(".narrow-filter").expectOne();
topic_name = $elt.closest("li").expectOne().attr("data-topic-name")!;
url = util.the($elt.closest("li").find<HTMLAnchorElement>("a.topic-box")).href;
stream_id = stream_popover.elem_to_stream_id($stream_li);
}
return {stream_id, topic_name, url};
}
// Builds the render context for a cross-conversation link, matching the
// data expected by the `channel_message_link` / `topic_link` /
// `decorated_channel_name` templates so the popover renders these links
// identically to how they appear inline in message content.
function get_cross_conversation_link_render_context(link: message_store.TopicLink): {
url: string;
stream: StreamSubscription | undefined;
channel_id: number;
channel_name: string;
topic_display_name_html: string;
is_empty_string_topic: boolean;
is_message_link: boolean;
} {
const topic_name =
stream_topic_history.get_known_topic_name(link.stream_id, link.topic) ?? link.topic;
let url: string;
if (link.kind === "message") {
({url} = topic_link_util.get_topic_link_content_with_stream_id({
stream_id: link.stream_id,
topic_name,
message_id: link.message_id.toString(),
}));
} else if (link.message_id !== undefined) {
url = hash_util.by_stream_topic_permalink(link.stream_id, topic_name, link.message_id);
} else {
url = hash_util.by_stream_topic_url(link.stream_id, topic_name);
}
const stream = stream_data.get_sub_by_id(link.stream_id);
return {
url,
stream,
channel_id: link.stream_id,
channel_name: stream?.name ?? "",
topic_display_name_html: _.escape(util.get_final_topic_display_name(topic_name)),
is_empty_string_topic: topic_name === "",
is_message_link: link.kind === "message",
};
}
export function open_cross_topic_links(
stream_id: number,
topic_name: string,
placement: tippy.Placement,
target: tippy.ReferenceElement,
): void {
popover_menus.toggle_popover_menu(target, {
theme: "popover-menu",
placement,
onShow(instance) {
popover_menus.popover_instances.topic_links = instance;
ui_util.show_left_sidebar_menu_icon(instance.reference);
popover_menus.on_show_prep(instance);
const links_from_narrow = message_store
.topic_links_from_narrow(stream_id, topic_name)
.map((link) => get_cross_conversation_link_render_context(link));
const links_to_narrow = message_store
.topic_links_to_narrow(stream_id, topic_name)
.map((link) => get_cross_conversation_link_render_context(link));
const context = {
has_links_from_narrow: links_from_narrow.length > 0,
links_from_narrow,
has_links_to_narrow: links_to_narrow.length > 0,
links_to_narrow,
};
instance.setContent(
ui_util.parse_html(render_left_sidebar_topic_links_popover(context)),
);
},
onHidden(instance) {
instance.destroy();
popover_menus.popover_instances.topic_links = null;
},
});
}
export function initialize(): void {
$("body").on("click", ".recipient-bar-copy-link-to-topic", (e) => {
e.preventDefault();
e.stopPropagation();
assert(e.currentTarget instanceof HTMLElement);
const $copy_button = $(e.currentTarget);
const topic_a_tag = util.the(
$copy_button.closest(".message-header-contents").find("a.narrows_by_topic"),
);
assert(topic_a_tag instanceof HTMLAnchorElement);
const topic_url = topic_a_tag.href;
void (async () => {
await clipboard_handler.copy_link_to_clipboard(topic_url);
// After copying successfully, change the tooltip text to "Copied!".
const tippy_reference: tippy.ReferenceElement | undefined = $copy_button.get(0);
const tippy_instance: tippy.Instance | undefined = tippy_reference!._tippy;
if (tippy_instance) {
tippy_instance.setContent($t_html({defaultMessage: "Copied!"}));
tippy_instance.show();
setTimeout(() => {
tippy_instance.hide();
}, 1000);
}
})();
});
register_popover_menu("#stream_filters .topic-sidebar-menu-icon", "right");
register_popover_menu("#more-topics-modal .topic-sidebar-menu-icon", "right");
register_popover_menu(".inbox-row .inbox-topic-menu", "bottom");
register_popover_menu(
".recipient-row-topic-menu, .recent_view_focusable .visibility-status-icon",
"bottom",
);
}
function register_popover_menu(target: string, placement: tippy.Placement): void {
popover_menus.register_popover_menu(
target,
{
theme: "popover-menu",
placement,
onShow(instance) {
popover_menus.popover_instances.topics_menu = instance;
ui_util.show_left_sidebar_menu_icon(instance.reference);
popover_menus.on_show_prep(instance);
const context = popover_menus_data.get_topic_popover_content_context(
get_conversation(instance),
);
instance.setContent(
ui_util.parse_html(render_left_sidebar_topic_actions_popover(context)),
);
},
onMount(instance) {
const $reference = $(instance.reference);
const $popper = $(instance.popper);
const {stream_id, topic_name, url} = get_conversation(instance);
const context = popover_menus_data.get_topic_popover_content_context({
stream_id,
topic_name,
url,
});
const is_topic_empty = context.is_topic_empty;
const topic_display_name = context.topic_display_name;
const is_empty_string_topic = context.is_empty_string_topic;
const $popover_trigger = $(instance.reference).closest(
".recent_view_focusable, .inbox-action-button",
);
if ($popover_trigger.length === 1) {
$popover_trigger.addClass("topic-popover-visible");
if ($popover_trigger.hasClass("recent-view-topic-visibility")) {
recent_view_ui.update_visibility_icon_swap_state($popover_trigger);
}
}
if (!stream_id) {
popover_menus.hide_current_popover_if_visible(instance);
return;
}
popover_menus.focus_popover(instance);
$popper.on("change", "input[name='sidebar-topic-visibility-select']", function () {
const start_time = Date.now();
const visibility_policy = Number.parseInt(
$(this).attr("data-visibility-policy")!,
10,
);
const success_cb = (): void => {
setTimeout(
() => {
popover_menus.hide_current_popover_if_visible(instance);
},
util.get_remaining_time(start_time, 500),
);
};
const error_cb = (): void => {
const prev_visibility_policy = user_topics.get_topic_visibility_policy(
stream_id,
topic_name,
);
const $prev_visibility_policy_input = $(this)
.parent()
.find(`input[data-visibility-policy="${prev_visibility_policy}"]`);
setTimeout(
() => {
$prev_visibility_policy_input.prop("checked", true);
},
util.get_remaining_time(start_time, 500),
);
};
user_topics.set_user_topic_visibility_policy(
stream_id,
topic_name,
visibility_policy,
false,
false,
undefined,
success_cb,
error_cb,
);
});
if (is_topic_empty) {
return;
}
$popper.one("click", ".sidebar-popover-unstar-all-in-topic", () => {
starred_messages_ui.confirm_unstar_all_messages_in_topic(stream_id, topic_name);
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-mark-topic-read", () => {
unread_ops.mark_topic_as_read(stream_id, topic_name);
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-mark-topic-unread", () => {
unread_ops.mark_topic_as_unread(stream_id, topic_name);
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-delete-topic-messages", () => {
const modal_content_html = render_delete_topic_modal({
topic_display_name,
is_empty_string_topic,
});
confirm_dialog.launch({
modal_title_html: $t_html({defaultMessage: "Delete topic"}),
help_link: "/help/delete-a-topic",
modal_content_html,
modal_submit_button_text: $t({defaultMessage: "Delete"}),
on_click() {
message_delete.delete_topic(stream_id, topic_name);
},
dangerous_action: true,
});
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-summarize-topic", () => {
message_summary.get_narrow_summary(stream_id, topic_name);
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-toggle-resolved", () => {
message_edit.with_first_message_id(stream_id, topic_name, (message_id) => {
assert(message_id !== undefined);
let $recipient_row;
if ($reference.hasClass("recipient-row-topic-menu")) {
// If the popover was opened from the recipient row, we
// we pass the recipient row to the toggle_resolve_topic
// function to show the loading indicator accordingly.
$recipient_row = $reference.closest(".recipient_row");
}
message_edit.toggle_resolve_topic(
message_id,
topic_name,
true,
$recipient_row,
);
});
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-move-topic-messages", () => {
void stream_popover.build_move_topic_to_stream_popover(
stream_id,
topic_name,
false,
);
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.one("click", ".sidebar-popover-rename-topic-messages", () => {
void stream_popover.build_move_topic_to_stream_popover(
stream_id,
topic_name,
true,
);
popover_menus.hide_current_popover_if_visible(instance);
});
$popper.on("click", ".sidebar-open-topic-links", () => {
const {stream_id, topic_name} = get_conversation(instance);
// Keep the same placement when replacing the popover.
const placement = tippyjs.get_actual_placement(instance);
const reference = instance.reference;
popover_menus.hide_current_popover_if_visible(instance);
open_cross_topic_links(stream_id, topic_name, placement, reference);
});
$popper.on(
"click",
".sidebar-popover-copy-link-to-topic",
function (this: HTMLElement) {
void clipboard_handler.popover_copy_link_to_clipboard(instance, $(this));
},
);
},
onHidden(instance) {
const $popover_trigger = $(instance.reference).closest(
".recent_view_focusable, .inbox-action-button",
);
if ($popover_trigger.length === 1) {
$popover_trigger.removeClass("topic-popover-visible");
if ($popover_trigger.hasClass("recent-view-topic-visibility")) {
recent_view_ui.update_visibility_icon_swap_state($popover_trigger);
}
}
instance.destroy();
popover_menus.popover_instances.topics_menu = null;
ui_util.hide_left_sidebar_menu_icon();
},
},
{
also_trigger_on_enter: true,
get_focus_return_element(reference) {
// Left sidebar triggers sit inside a `.topic-box` or
// `.selectable_sidebar_block`; return focus to that
// enclosing row so the user re-lands on a natural
// target. From inbox and recent-view triggers there
// is no such ancestor, so fall back to the nearest
// focusable ancestor (or the reference itself)
// rather than crashing in `util.the`.
const $block = $(reference).closest(".topic-box, .selectable_sidebar_block");
return $block[0] ?? $(reference).closest("[tabindex='0']")[0] ?? reference;
},
},
);
}