import treeService from './tree.js'; import server from './server.js'; import utils from './utils.js'; import toastService from './toast.js'; import linkService from './link.js'; import treeCache from './tree_cache.js'; import noteDetailService from './note_detail.js'; import noteTooltipService from './note_tooltip.js'; import protectedSessionService from './protected_session.js'; import dateNotesService from './date_notes.js'; import StandardWidget from '../widgets/standard_widget.js'; /** * This is the main frontend API interface for scripts. It's published in the local "api" object. * * @constructor * @hideconstructor */ function FrontendScriptApi(startNote, currentNote, originEntity = null, tabContext = null, $container = null) { const $pluginButtons = $("#plugin-buttons"); /** @property {jQuery} container of all the rendered script content */ this.$container = $container; /** @property {object} note where script started executing */ this.startNote = startNote; /** @property {object} note where script is currently executing */ this.currentNote = currentNote; /** @property {object|null} entity whose event triggered this execution */ this.originEntity = originEntity; // to keep consistency with backend API this.dayjs = dayjs; /** @property {TabContext|null} - experimental! */ this.tabContext = tabContext; /** @property {StandardWidget} */ this.StandardWidget = StandardWidget; /** * Activates note in the tree and in the note detail. * * @method * @param {string} notePath (or noteId) * @returns {Promise} */ this.activateNote = async (notePath, noteLoadedListener) => { await treeService.activateNote(notePath, async () => { await treeService.scrollToActiveNote(); if (noteLoadedListener) { noteLoadedListener(); } }); }; /** * Activates newly created note. Compared to this.activateNote() also refreshes tree. * * @param {string} notePath (or noteId) * @return {Promise} */ this.activateNewNote = async notePath => { await treeService.reload(); await treeService.activateNote(notePath, noteDetailService.focusAndSelectTitle); }; /** * @typedef {Object} ToolbarButtonOptions * @property {string} title * @property {string} [icon] - name of the JAM icon to be used (e.g. "clock" for "jam-clock" icon) * @property {function} action - callback handling the click on the button * @property {string} [shortcut] - keyboard shortcut for the button, e.g. "alt+t" */ /** * Adds new button the the plugin area. * * @param {ToolbarButtonOptions} opts */ this.addButtonToToolbar = opts => { const buttonId = "toolbar-button-" + opts.title.replace(/[^a-zA-Z0-9]/g, "-"); const button = $('