import $ from "jquery"; import _ from "lodash"; import generated_emoji_codes from "../../static/generated/emoji/emoji_codes.json"; import generated_pygments_data from "../generated/pygments_data.json"; import * as fenced_code from "../shared/src/fenced_code"; import render_compose from "../templates/compose.hbs"; import render_left_sidebar from "../templates/left_sidebar.hbs"; import render_message_feed_bottom_whitespace from "../templates/message_feed_bottom_whitespace.hbs"; import render_message_feed_errors from "../templates/message_feed_errors.hbs"; import render_navbar from "../templates/navbar.hbs"; import render_right_sidebar from "../templates/right_sidebar.hbs"; import * as about_zulip from "./about_zulip"; import * as activity from "./activity"; import * as activity_ui from "./activity_ui"; import * as add_stream_options_popover from "./add_stream_options_popover"; import * as alert_words from "./alert_words"; import * as audible_notifications from "./audible_notifications"; import * as blueslip from "./blueslip"; import * as bot_data from "./bot_data"; import * as channel from "./channel"; import * as click_handlers from "./click_handlers"; import * as common from "./common"; import * as compose from "./compose"; import * as compose_closed_ui from "./compose_closed_ui"; import * as compose_notifications from "./compose_notifications"; import * as compose_pm_pill from "./compose_pm_pill"; import * as compose_popovers from "./compose_popovers"; import * as compose_recipient from "./compose_recipient"; import * as compose_reply from "./compose_reply"; import * as compose_setup from "./compose_setup"; import * as compose_textarea from "./compose_textarea"; import * as compose_tooltips from "./compose_tooltips"; import * as composebox_typeahead from "./composebox_typeahead"; import * as condense from "./condense"; import * as copy_and_paste from "./copy_and_paste"; import * as dark_theme from "./dark_theme"; import * as desktop_notifications from "./desktop_notifications"; import * as drafts from "./drafts"; import * as drafts_overlay_ui from "./drafts_overlay_ui"; import * as echo from "./echo"; import * as emoji from "./emoji"; import * as emoji_picker from "./emoji_picker"; import * as emojisets from "./emojisets"; import * as gear_menu from "./gear_menu"; import * as giphy from "./giphy"; import * as hashchange from "./hashchange"; import * as hotkey from "./hotkey"; import * as hotspots from "./hotspots"; import * as i18n from "./i18n"; import * as inbox_ui from "./inbox_ui"; import * as invite from "./invite"; import * as left_sidebar_navigation_area from "./left_sidebar_navigation_area"; import * as left_sidebar_navigation_area_popovers from "./left_sidebar_navigation_area_popovers"; import * as lightbox from "./lightbox"; import * as linkifiers from "./linkifiers"; import {localstorage} from "./localstorage"; import * as markdown from "./markdown"; import * as markdown_config from "./markdown_config"; import * as message_actions_popover from "./message_actions_popover"; import * as message_edit_history from "./message_edit_history"; import * as message_fetch from "./message_fetch"; import * as message_list from "./message_list"; import * as message_list_hover from "./message_list_hover"; import * as message_list_tooltips from "./message_list_tooltips"; import * as message_lists from "./message_lists"; import * as message_scroll from "./message_scroll"; import * as message_view_header from "./message_view_header"; import * as message_viewport from "./message_viewport"; import * as muted_users from "./muted_users"; import * as narrow from "./narrow"; import * as narrow_history from "./narrow_history"; import * as narrow_state from "./narrow_state"; import * as narrow_title from "./narrow_title"; import * as navbar_alerts from "./navbar_alerts"; import * as navigate from "./navigate"; import * as overlays from "./overlays"; import {page_params} from "./page_params"; import * as people from "./people"; import * as playground_links_popover from "./playground_links_popover"; import * as pm_conversations from "./pm_conversations"; import * as pm_list from "./pm_list"; import * as popover_menus from "./popover_menus"; import * as popovers from "./popovers"; import * as presence from "./presence"; import * as realm_logo from "./realm_logo"; import * as realm_playground from "./realm_playground"; import * as realm_user_settings_defaults from "./realm_user_settings_defaults"; import * as recent_view_ui from "./recent_view_ui"; import * as reload_setup from "./reload_setup"; import * as rendered_markdown from "./rendered_markdown"; import * as resize_handler from "./resize_handler"; import * as scheduled_messages from "./scheduled_messages"; import * as scheduled_messages_overlay_ui from "./scheduled_messages_overlay_ui"; import * as scheduled_messages_popover from "./scheduled_messages_popover"; import * as scheduled_messages_ui from "./scheduled_messages_ui"; import * as scroll_bar from "./scroll_bar"; import * as scroll_util from "./scroll_util"; import * as search from "./search"; import * as sent_messages from "./sent_messages"; import * as server_events from "./server_events"; import * as settings from "./settings"; import * as settings_data from "./settings_data"; import * as settings_display from "./settings_display"; import * as settings_notifications from "./settings_notifications"; import * as settings_panel_menu from "./settings_panel_menu"; import * as settings_realm_user_settings_defaults from "./settings_realm_user_settings_defaults"; import * as settings_sections from "./settings_sections"; import * as settings_toggle from "./settings_toggle"; import * as sidebar_ui from "./sidebar_ui"; import * as spoilers from "./spoilers"; import * as starred_messages from "./starred_messages"; import * as starred_messages_ui from "./starred_messages_ui"; import * as stream_data from "./stream_data"; import * as stream_edit from "./stream_edit"; import * as stream_edit_subscribers from "./stream_edit_subscribers"; import * as stream_list from "./stream_list"; import * as stream_list_sort from "./stream_list_sort"; import * as stream_popover from "./stream_popover"; import * as stream_settings_ui from "./stream_settings_ui"; import * as sub_store from "./sub_store"; import * as timerender from "./timerender"; import * as tippyjs from "./tippyjs"; import * as topic_list from "./topic_list"; import * as topic_popover from "./topic_popover"; import * as transmit from "./transmit"; import * as tutorial from "./tutorial"; import * as typeahead_helper from "./typeahead_helper"; import * as typing from "./typing"; import * as unread from "./unread"; import * as unread_ops from "./unread_ops"; import * as unread_ui from "./unread_ui"; import * as upload from "./upload"; import * as user_card_popover from "./user_card_popover"; import * as user_group_edit from "./user_group_edit"; import * as user_group_edit_members from "./user_group_edit_members"; import * as user_group_popover from "./user_group_popover"; import * as user_groups from "./user_groups"; import * as user_profile from "./user_profile"; import {initialize_user_settings, user_settings} from "./user_settings"; import * as user_status from "./user_status"; import * as user_status_ui from "./user_status_ui"; import * as user_topic_popover from "./user_topic_popover"; import * as user_topics from "./user_topics"; import * as widgets from "./widgets"; // This is where most of our initialization takes place. // TODO: Organize it a lot better. In particular, move bigger // functions to other modules. /* We use 'visibility' rather than 'display' and jQuery's show() / hide(), because we want to reserve space for the email address. This avoids things jumping around slightly when the email address is shown. */ function initialize_bottom_whitespace() { $("#bottom_whitespace").html(render_message_feed_bottom_whitespace()); } function initialize_left_sidebar() { const rendered_sidebar = render_left_sidebar({ is_guest: page_params.is_guest, development_environment: page_params.development_environment, }); $("#left-sidebar-container").html(rendered_sidebar); } function initialize_right_sidebar() { const rendered_sidebar = render_right_sidebar({ realm_rendered_description: page_params.realm_rendered_description, }); $("#right-sidebar-container").html(rendered_sidebar); sidebar_ui.update_invite_user_option(); if (page_params.is_spectator) { rendered_markdown.update_elements( $(".right-sidebar .realm-description .rendered_markdown"), ); } $("#user_presences").on("mouseenter", ".user_sidebar_entry", (e) => { const $status_emoji = $(e.target).closest(".user_sidebar_entry").find("img.status-emoji"); if ($status_emoji.length) { const animated_url = $status_emoji.data("animated-url"); if (animated_url) { $status_emoji.attr("src", animated_url); } } }); $("#user_presences").on("mouseleave", ".user_sidebar_entry", (e) => { const $status_emoji = $(e.target).closest(".user_sidebar_entry").find("img.status-emoji"); if ($status_emoji.length) { const still_url = $status_emoji.data("still-url"); if (still_url) { $status_emoji.attr("src", still_url); } } }); } function initialize_navbar() { const rendered_navbar = render_navbar({ embedded: page_params.narrow_stream !== undefined, }); $("#header-container").html(rendered_navbar); } function initialize_compose_box() { $("#compose-container").append( render_compose({ embedded: $("#compose").attr("data-embedded") === "", file_upload_enabled: page_params.max_file_upload_size_mib > 0, giphy_enabled: giphy.is_giphy_enabled(), max_stream_name_length: page_params.max_stream_name_length, max_topic_length: page_params.max_topic_length, }), ); $(`.enter_sends_${user_settings.enter_sends}`).show(); common.adjust_mac_kbd_tags(".open_enter_sends_dialog kbd"); } function initialize_message_feed_errors() { $("#message_feed_errors_container").html(render_message_feed_errors()); } export function initialize_kitchen_sink_stuff() { // TODO: // This function is a historical dumping ground // for lots of miscellaneous setup. Almost all of // the code here can probably be moved to more // specific-purpose modules like message_viewport.js. const throttled_mousewheelhandler = _.throttle((_e, delta) => { // Most of the mouse wheel's work will be handled by the // scroll handler, but when we're at the top or bottom of the // page, the pointer may still need to move. if (delta < 0 && message_viewport.at_top()) { navigate.up(); } else if (delta > 0 && message_viewport.at_bottom()) { navigate.down(); } message_viewport.set_last_movement_direction(delta); }, 50); message_viewport.$scroll_container.on("wheel", (e) => { const delta = e.originalEvent.deltaY; if (!overlays.is_overlay_or_modal_open() && narrow_state.is_message_feed_visible()) { // In the message view, we use a throttled mousewheel handler. throttled_mousewheelhandler(e, delta); } // If in a modal, we neither handle the event nor // preventDefault, allowing the modal to scroll normally. }); $(window).on("resize", _.throttle(resize_handler.handler, 50)); // Scrolling in overlays. input boxes, and other elements that // explicitly scroll should not scroll the main view. Stop // propagation in all cases. Also, ignore the event if the // element is already at the top or bottom. Otherwise we get a // new scroll event on the parent (?). $(".modal-body, .scrolling_list, input, textarea").on("wheel", function (e) { const $self = scroll_util.get_scroll_element($(this)); const scroll = $self.scrollTop(); const delta = e.originalEvent.deltaY; // The -1 fudge factor is important here due to rounding errors. Better // to err on the side of not scrolling. const max_scroll = $self.prop("scrollHeight") - $self.innerHeight() - 1; e.stopPropagation(); if ((delta < 0 && scroll <= 0) || (delta > 0 && scroll >= max_scroll)) { e.preventDefault(); } }); // Ignore wheel events in the compose area which weren't already handled above. $("#compose").on("wheel", (e) => { // Except for the compose banners, which still need scroll events. if ($(e.target).closest("#compose_banners").length) { return; } e.stopPropagation(); e.preventDefault(); }); // A little hackish, because it doesn't seem to totally get us the // exact right width for the compose box, but, close enough for now. resize_handler.handler(); if (page_params.is_spectator) { $("body").addClass("spectator-view"); } if (user_settings.high_contrast_mode) { $("body").addClass("high-contrast"); } if (!user_settings.dense_mode) { $("body").addClass("less_dense_mode"); } else { $("body").addClass("more_dense_mode"); } $(window).on("blur", () => { $(document.body).addClass("window_blurred"); }); $(window).on("focus", () => { $(document.body).removeClass("window_blurred"); }); $(document).on("message_selected.zulip", (event) => { if (message_lists.current !== event.msg_list) { return; } if (event.id === -1) { // If the message list is empty, don't do anything return; } const $row = event.msg_list.get_row(event.id); $(".selected_message").removeClass("selected_message"); $row.addClass("selected_message"); narrow_history.save_narrow_state(); if (event.then_scroll) { if ($row.length === 0) { const $row_from_dom = message_lists.current.get_row(event.id); const messages = event.msg_list.all_messages(); blueslip.debug("message_selected missing selected row", { previously_selected_id: event.previously_selected_id, selected_id: event.id, selected_idx: event.msg_list.selected_idx(), selected_idx_exact: messages.indexOf(event.msg_list.get(event.id)), render_start: event.msg_list.view._render_win_start, render_end: event.msg_list.view._render_win_end, selected_id_from_idx: messages[event.msg_list.selected_idx()].id, msg_list_sorted: _.isEqual( messages.map((message) => message.id), message_lists.current .all_messages() .map((message) => message.id) .sort(), ), found_in_dom: $row_from_dom.length, }); } if (event.target_scroll_offset !== undefined) { message_lists.current.view.set_message_offset(event.target_scroll_offset); } else { // Scroll to place the message within the current view; // but if this is the initial placement of the pointer, // just place it in the very center message_viewport.recenter_view($row, { from_scroll: event.from_scroll, force_center: event.previously_selected_id === -1, }); } } }); if (!page_params.realm_allow_message_editing) { $("#edit-message-hotkey-help").hide(); } if (page_params.realm_presence_disabled) { $("#user-list").hide(); } } function initialize_unread_ui() { unread_ui.register_update_unread_counts_hook((counts) => activity_ui.update_dom_with_unread_counts(counts), ); unread_ui.register_update_unread_counts_hook((counts, skip_animations) => left_sidebar_navigation_area.update_dom_with_unread_counts(counts, skip_animations), ); unread_ui.register_update_unread_counts_hook((counts) => stream_list.update_dom_with_unread_counts(counts), ); unread_ui.register_update_unread_counts_hook((counts) => pm_list.update_dom_with_unread_counts(counts), ); unread_ui.register_update_unread_counts_hook(() => topic_list.update()); unread_ui.register_update_unread_counts_hook((counts) => narrow_title.update_unread_counts(counts), ); unread_ui.register_update_unread_counts_hook(inbox_ui.update); unread_ui.initialize({notify_server_messages_read: unread_ops.notify_server_messages_read}); } export function initialize_everything() { /* When we initialize our various modules, a lot of them will consume data from the server in the form of `page_params`. The `page_params` variable is basically a massive dictionary with all the information that the client needs to run the app. Here are some examples of what it includes: - all of the user's user-specific settings - all realm-specific settings that are pertinent to the user - info about streams/subscribers on the realm - realm settings - info about all the other users - some fairly dynamic data, like which of the other users are "present" Except for the actual Zulip messages, basically any data that you see in the app soon after page load comes from `page_params`. ## Mostly static data Now, we mostly leave `page_params` intact through the duration of the app. Most of the data in `page_params` is fairly static in nature, and we will simply update it for basic changes like the following (meant as examples, not gospel): - I changed my 24-hour time preference. - The realm admin changed who can edit topics. - The team's realm icon has changed. - I switched from light theme to dark theme. Especially for things that are settings-related, we rarely abstract away the data from `page_params`. As of this writing, over 90 modules refer directly to `page_params` for some reason or another. ## Dynamic data Some of the data in `page_params` is either more highly dynamic than settings data, or has more performance requirements than simple settings data, or both. Examples include: - tracking all users (we want to have multiple Maps to find users, for example) - tracking all streams - tracking presence data - tracking user groups and bots - tracking recent direct messages Using stream data as an example, we use a module called `stream_data` to actually track all the info about the streams that a user can know about. We populate this module with data from `page_params`, but thereafter `stream_data.js` "owns" the stream data: - other modules should ask `stream_data` for stuff (and not go to `page_params`) - when server events come in, they should be processed by stream_data to update its own data structures To help enforce this paradigm, we do the following: - only pass `stream_data` what it needs from `page_params` - delete the reference to data owned by `stream_data` in `page_params` itself */ function pop_fields(...fields) { const result = {}; for (const field of fields) { result[field] = page_params[field]; delete page_params[field]; } return result; } const alert_words_params = pop_fields("alert_words"); const emoji_params = pop_fields("realm_emoji"); const bot_params = pop_fields("realm_bots"); const people_params = pop_fields("realm_users", "realm_non_active_users", "cross_realm_bots"); const pm_conversations_params = pop_fields("recent_private_conversations"); const presence_params = pop_fields("presences", "server_timestamp"); const starred_messages_params = pop_fields("starred_messages"); const stream_data_params = pop_fields( "subscriptions", "unsubscribed", "never_subscribed", "realm_default_streams", ); const user_groups_params = pop_fields("realm_user_groups"); const unread_params = pop_fields("unread_msgs"); const muted_users_params = pop_fields("muted_users"); const user_topics_params = pop_fields("user_topics"); const user_status_params = pop_fields("user_status"); const i18n_params = pop_fields("language_list"); const user_settings_params = pop_fields("user_settings"); const realm_settings_defaults_params = pop_fields("realm_user_settings_defaults"); const scheduled_messages_params = pop_fields("scheduled_messages"); /* To store theme data for spectators, we need to initialize user_settings before setting the theme. */ initialize_user_settings(user_settings_params); if (page_params.is_spectator) { const ls = localstorage(); const preferred_theme = ls.get("spectator-theme-preference"); if (preferred_theme === "dark") { dark_theme.enable(); } else if (preferred_theme === "light") { dark_theme.disable(); } } i18n.initialize(i18n_params); widgets.initialize(); tippyjs.initialize(); compose_tooltips.initialize(); message_list_tooltips.initialize(); // This populates data for scheduled messages. scheduled_messages.initialize(scheduled_messages_params); scheduled_messages_ui.initialize(); popover_menus.initialize(); compose_popovers.initialize(); left_sidebar_navigation_area_popovers.initialize(); user_topic_popover.initialize(); topic_popover.initialize(); message_actions_popover.initialize(); scheduled_messages_popover.initialize(); realm_user_settings_defaults.initialize(realm_settings_defaults_params); people.initialize(page_params.user_id, people_params); starred_messages.initialize(starred_messages_params); let date_joined; if (!page_params.is_spectator) { const user = people.get_by_user_id(page_params.user_id); date_joined = user.date_joined; } else { // Spectators don't have an account, so we just prevent their // date_joined is now. date_joined = new Date(); } settings_data.initialize(date_joined); // The emoji module must be initialized before the right sidebar // module, so that we can display custom emoji in statuses. emoji.initialize({ realm_emoji: emoji_params.realm_emoji, emoji_codes: generated_emoji_codes, }); // The user_group must be initialized before right sidebar // module, so that we can tell whether user is member of // user_group whose members are allowed to create multiuse invite. user_groups.initialize(user_groups_params); // These components must be initialized early, because other // modules' initialization has not been audited for whether they // expect DOM elements to always exist (As that did before these // modules were migrated from Django templates to Handlebars). initialize_bottom_whitespace(); initialize_left_sidebar(); initialize_right_sidebar(); initialize_compose_box(); settings.initialize(); initialize_navbar(); initialize_message_feed_errors(); realm_logo.initialize(); message_lists.initialize(); message_list.initialize(); recent_view_ui.initialize({ on_click_participant(avatar_element, participant_user_id) { const user = people.get_by_user_id(participant_user_id); user_card_popover.toggle_user_card_popover(avatar_element, user); }, on_mark_pm_as_read: unread_ops.mark_pm_as_read, on_mark_topic_as_read: unread_ops.mark_topic_as_read, }); inbox_ui.initialize(); alert_words.initialize(alert_words_params); emojisets.initialize(); scroll_bar.initialize(); message_viewport.initialize(); navbar_alerts.initialize(); message_list_hover.initialize(); initialize_kitchen_sink_stuff(); echo.initialize({ on_send_message_success: compose.send_message_success, send_message: transmit.send_message, }); stream_edit.initialize(); user_group_edit.initialize(); stream_edit_subscribers.initialize(); stream_data.initialize(stream_data_params); user_group_edit_members.initialize(); pm_conversations.recent.initialize(pm_conversations_params); user_topics.initialize(user_topics_params); muted_users.initialize(muted_users_params); stream_settings_ui.initialize(); left_sidebar_navigation_area.initialize(); stream_list.initialize({ on_stream_click(stream_id, trigger) { const sub = sub_store.get(stream_id); sidebar_ui.hide_all(); popovers.hide_all(); narrow.by("stream", sub.name, {trigger}); }, }); stream_list_sort.initialize(); condense.initialize(); spoilers.initialize(); lightbox.initialize(); sidebar_ui.initialize(); user_profile.initialize(); stream_popover.initialize(); add_stream_options_popover.initialize(); click_handlers.initialize(); scheduled_messages_overlay_ui.initialize(); copy_and_paste.initialize(); overlays.initialize(); invite.initialize(); timerender.initialize(); message_view_header.initialize(); server_events.initialize(); user_status.initialize(user_status_params); compose_recipient.initialize(); compose_pm_pill.initialize({ on_pill_create_or_remove: compose_recipient.update_placeholder_text, }); compose_closed_ui.initialize(); compose_reply.initialize(); reload_setup.initialize(); unread.initialize(unread_params); bot_data.initialize(bot_params); // Must happen after people.initialize() message_fetch.initialize(server_events.home_view_loaded); message_scroll.initialize(); markdown.initialize(markdown_config.get_helpers()); linkifiers.initialize(page_params.realm_linkifiers); realm_playground.initialize({ playground_data: page_params.realm_playgrounds, pygments_comparator_func: typeahead_helper.compare_language, }); compose_setup.initialize(); // Typeahead must be initialized after compose_setup.initialize() composebox_typeahead.initialize({ on_enter_send: compose.finish, }); compose_textarea.initialize(); upload.initialize(); search.initialize({ on_narrow_search: narrow.activate, }); tutorial.initialize(); desktop_notifications.initialize(); audible_notifications.initialize(); compose_notifications.initialize({ on_click_scroll_to_selected: navigate.scroll_to_selected, on_narrow_to_recipient(message_id) { narrow.by_topic(message_id, {trigger: "compose_notification"}); }, }); unread_ops.initialize(); gear_menu.initialize(); giphy.initialize(); presence.initialize(presence_params); settings_display.initialize(); settings_notifications.initialize(); settings_realm_user_settings_defaults.initialize(); settings_panel_menu.initialize(); settings_sections.initialize(); settings_toggle.initialize(); about_zulip.initialize(); // All overlays must be initialized before hashchange.js hashchange.initialize(); initialize_unread_ui(); activity.initialize(); activity_ui.initialize(); emoji_picker.initialize(); user_group_popover.initialize(); user_card_popover.initialize(); playground_links_popover.initialize(); pm_list.initialize(); topic_list.initialize({ on_topic_click(stream_id, topic) { const sub = sub_store.get(stream_id); narrow.activate( [ {operator: "stream", operand: sub.name}, {operator: "topic", operand: topic}, ], {trigger: "sidebar"}, ); }, }); drafts.initialize(); drafts_overlay_ui.initialize(); sent_messages.initialize(); hotspots.initialize(); typing.initialize(); starred_messages_ui.initialize(); user_status_ui.initialize(); fenced_code.initialize(generated_pygments_data); message_edit_history.initialize(); hotkey.initialize(); $("#app-loading").addClass("loaded"); } $(async () => { if (page_params.is_spectator) { const data = { apply_markdown: true, client_capabilities: JSON.stringify({ notification_settings_null: true, bulk_message_deletion: true, user_avatar_url_field_optional: true, // Set this to true when stream typing notifications are implemented. stream_typing_notifications: false, user_settings_object: true, }), client_gravatar: false, }; channel.post({ url: "/json/register", data, success(response_data) { Object.assign(page_params, response_data); initialize_everything(); }, error() { $("#app-loading-middle-content").hide(); $("#app-loading-bottom-content").hide(); $(".app").hide(); $("#app-loading-error").css({visibility: "visible"}); }, }); } else { initialize_everything(); } });