ci: improve workflow

1. Run tests, iff the other prerequisites are met
2. In case of a translation PR, skip tests not related to translations

.envrc

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# Automatically sets up your devbox environment whenever you cd into this
+# directory via our direnv integration:
+
+eval "$(devbox generate direnv --print-envrc)"
+
+# check out https://www.jetpack.io/devbox/docs/ide_configuration/direnv/
+# for more details

.eslintignore

@@ -85,6 +85,7 @@ plugin_types/
 readme/
 packages/react-native-vosk/lib/
 packages/lib/countable/Countable.js
+packages/onenote-converter/pkg/onenote_converter.js
 
 # AUTO-GENERATED - EXCLUDED TYPESCRIPT BUILD
 packages/app-cli/app/LinkSelector.js
@@ -150,11 +151,16 @@ packages/app-desktop/checkForUpdates.js
 packages/app-desktop/commands/copyDevCommand.js
 packages/app-desktop/commands/editProfileConfig.js
 packages/app-desktop/commands/emptyTrash.js
+packages/app-desktop/commands/exportDeletionLog.test.js
+packages/app-desktop/commands/exportDeletionLog.js
 packages/app-desktop/commands/exportFolders.js
 packages/app-desktop/commands/exportNotes.js
 packages/app-desktop/commands/focusElement.js
 packages/app-desktop/commands/index.js
+packages/app-desktop/commands/openNoteInNewWindow.js
 packages/app-desktop/commands/openProfileDirectory.js
+packages/app-desktop/commands/renderMarkup.test.js
+packages/app-desktop/commands/renderMarkup.js
 packages/app-desktop/commands/replaceMisspelling.js
 packages/app-desktop/commands/restoreNoteRevision.js
 packages/app-desktop/commands/startExternalEditing.js
@@ -205,60 +211,14 @@ packages/app-desktop/gui/KeymapConfig/styles/index.js
 packages/app-desktop/gui/KeymapConfig/utils/getLabel.js
 packages/app-desktop/gui/KeymapConfig/utils/useCommandStatus.js
 packages/app-desktop/gui/KeymapConfig/utils/useKeymap.js
-packages/app-desktop/gui/MainScreen/MainScreen.js
-packages/app-desktop/gui/MainScreen/commands/addProfile.js
-packages/app-desktop/gui/MainScreen/commands/commandPalette.js
-packages/app-desktop/gui/MainScreen/commands/deleteFolder.js
-packages/app-desktop/gui/MainScreen/commands/duplicateNote.js
-packages/app-desktop/gui/MainScreen/commands/editAlarm.js
-packages/app-desktop/gui/MainScreen/commands/exportPdf.js
-packages/app-desktop/gui/MainScreen/commands/gotoAnything.js
-packages/app-desktop/gui/MainScreen/commands/hideModalMessage.js
-packages/app-desktop/gui/MainScreen/commands/index.js
-packages/app-desktop/gui/MainScreen/commands/leaveSharedFolder.js
-packages/app-desktop/gui/MainScreen/commands/moveToFolder.js
-packages/app-desktop/gui/MainScreen/commands/newFolder.js
-packages/app-desktop/gui/MainScreen/commands/newNote.js
-packages/app-desktop/gui/MainScreen/commands/newSubFolder.js
-packages/app-desktop/gui/MainScreen/commands/newTodo.js
-packages/app-desktop/gui/MainScreen/commands/openFolder.js
-packages/app-desktop/gui/MainScreen/commands/openFolderDialog.js
-packages/app-desktop/gui/MainScreen/commands/openItem.js
-packages/app-desktop/gui/MainScreen/commands/openNote.js
-packages/app-desktop/gui/MainScreen/commands/openPdfViewer.js
-packages/app-desktop/gui/MainScreen/commands/openTag.js
-packages/app-desktop/gui/MainScreen/commands/print.js
-packages/app-desktop/gui/MainScreen/commands/renameFolder.js
-packages/app-desktop/gui/MainScreen/commands/renameTag.js
-packages/app-desktop/gui/MainScreen/commands/resetLayout.js
-packages/app-desktop/gui/MainScreen/commands/restoreFolder.js
-packages/app-desktop/gui/MainScreen/commands/restoreNote.js
-packages/app-desktop/gui/MainScreen/commands/revealResourceFile.js
-packages/app-desktop/gui/MainScreen/commands/search.js
-packages/app-desktop/gui/MainScreen/commands/setTags.js
-packages/app-desktop/gui/MainScreen/commands/showModalMessage.js
-packages/app-desktop/gui/MainScreen/commands/showNoteContentProperties.js
-packages/app-desktop/gui/MainScreen/commands/showNoteProperties.js
-packages/app-desktop/gui/MainScreen/commands/showPrompt.js
-packages/app-desktop/gui/MainScreen/commands/showShareFolderDialog.js
-packages/app-desktop/gui/MainScreen/commands/showShareNoteDialog.js
-packages/app-desktop/gui/MainScreen/commands/showSpellCheckerMenu.test.js
-packages/app-desktop/gui/MainScreen/commands/showSpellCheckerMenu.js
-packages/app-desktop/gui/MainScreen/commands/toggleEditors.js
-packages/app-desktop/gui/MainScreen/commands/toggleLayoutMoveMode.js
-packages/app-desktop/gui/MainScreen/commands/toggleMenuBar.js
-packages/app-desktop/gui/MainScreen/commands/toggleNoteList.js
-packages/app-desktop/gui/MainScreen/commands/toggleNoteType.js
-packages/app-desktop/gui/MainScreen/commands/toggleNotesSortOrderField.js
-packages/app-desktop/gui/MainScreen/commands/toggleNotesSortOrderReverse.js
-packages/app-desktop/gui/MainScreen/commands/togglePerFolderSortOrder.js
-packages/app-desktop/gui/MainScreen/commands/toggleSideBar.js
-packages/app-desktop/gui/MainScreen/commands/toggleVisiblePanes.js
+packages/app-desktop/gui/MainScreen.js
 packages/app-desktop/gui/MasterPasswordDialog/Dialog.js
 packages/app-desktop/gui/MenuBar.js
 packages/app-desktop/gui/MultiNoteActions.js
 packages/app-desktop/gui/Navigator.js
+packages/app-desktop/gui/NewWindowOrIFrame.js
 packages/app-desktop/gui/NoteContentPropertiesDialog.js
+packages/app-desktop/gui/NoteEditor/EditorWindow.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/Toolbar.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/utils/index.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/utils/normalizeAccelerator.test.js
@@ -284,6 +244,7 @@ packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v5/utils/useScrollUtils.
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/CodeMirror.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/Editor.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/useEditorCommands.js
+packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/utils/localisation.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/utils/useKeymap.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/utils/useRefocusOnVisiblePaneChange.js
 packages/app-desktop/gui/NoteEditor/NoteBody/PlainEditor/PlainEditor.js
@@ -318,6 +279,7 @@ packages/app-desktop/gui/NoteEditor/utils/clipboardUtils.test.js
 packages/app-desktop/gui/NoteEditor/utils/clipboardUtils.js
 packages/app-desktop/gui/NoteEditor/utils/contextMenu.js
 packages/app-desktop/gui/NoteEditor/utils/contextMenuUtils.js
+packages/app-desktop/gui/NoteEditor/utils/getWindowCommandPriority.js
 packages/app-desktop/gui/NoteEditor/utils/index.js
 packages/app-desktop/gui/NoteEditor/utils/markupRenderOptions.js
 packages/app-desktop/gui/NoteEditor/utils/resourceHandling.test.js
@@ -331,6 +293,8 @@ packages/app-desktop/gui/NoteEditor/utils/useFormNote.js
 packages/app-desktop/gui/NoteEditor/utils/useMarkupToHtml.js
 packages/app-desktop/gui/NoteEditor/utils/useMessageHandler.js
 packages/app-desktop/gui/NoteEditor/utils/useNoteSearchBar.js
+packages/app-desktop/gui/NoteEditor/utils/usePluginEditorView.test.js
+packages/app-desktop/gui/NoteEditor/utils/usePluginEditorView.js
 packages/app-desktop/gui/NoteEditor/utils/usePluginServiceRegistration.js
 packages/app-desktop/gui/NoteEditor/utils/useScheduleSaveCallbacks.js
 packages/app-desktop/gui/NoteEditor/utils/useScrollWhenReadyOptions.js
@@ -385,7 +349,9 @@ packages/app-desktop/gui/NoteTextViewer.js
 packages/app-desktop/gui/NoteToolbar/NoteToolbar.js
 packages/app-desktop/gui/NotyfContext.js
 packages/app-desktop/gui/OneDriveLoginScreen.js
+packages/app-desktop/gui/PasswordInput/LabelledPasswordInput.js
 packages/app-desktop/gui/PasswordInput/PasswordInput.js
+packages/app-desktop/gui/PasswordInput/types.js
 packages/app-desktop/gui/PdfViewer.js
 packages/app-desktop/gui/PromptDialog.js
 packages/app-desktop/gui/ResizableLayout/MoveButtons.js
@@ -419,16 +385,19 @@ packages/app-desktop/gui/Sidebar/commands/focusElementSideBar.js
 packages/app-desktop/gui/Sidebar/commands/index.js
 packages/app-desktop/gui/Sidebar/hooks/useFocusHandler.js
 packages/app-desktop/gui/Sidebar/hooks/useOnRenderItem.js
+packages/app-desktop/gui/Sidebar/hooks/useOnRenderListWrapper.js
 packages/app-desktop/gui/Sidebar/hooks/useOnSidebarKeyDownHandler.js
 packages/app-desktop/gui/Sidebar/hooks/useSelectedSidebarIndex.js
 packages/app-desktop/gui/Sidebar/hooks/useSidebarCommandHandler.js
 packages/app-desktop/gui/Sidebar/hooks/useSidebarListData.js
+packages/app-desktop/gui/Sidebar/hooks/utils/toggleHeader.js
 packages/app-desktop/gui/Sidebar/listItemComponents/AllNotesItem.js
 packages/app-desktop/gui/Sidebar/listItemComponents/EmptyExpandLink.js
 packages/app-desktop/gui/Sidebar/listItemComponents/ExpandIcon.js
 packages/app-desktop/gui/Sidebar/listItemComponents/ExpandLink.js
 packages/app-desktop/gui/Sidebar/listItemComponents/FolderItem.js
 packages/app-desktop/gui/Sidebar/listItemComponents/HeaderItem.js
+packages/app-desktop/gui/Sidebar/listItemComponents/ListItemWrapper.js
 packages/app-desktop/gui/Sidebar/listItemComponents/NoteCount.js
 packages/app-desktop/gui/Sidebar/listItemComponents/TagItem.js
 packages/app-desktop/gui/Sidebar/styles/index.js
@@ -445,7 +414,68 @@ packages/app-desktop/gui/ToolbarButton/ToolbarButton.js
 packages/app-desktop/gui/ToolbarSpace.js
 packages/app-desktop/gui/TrashNotification/TrashNotification.js
 packages/app-desktop/gui/UpdateNotification/UpdateNotification.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/AppDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/ModalMessageOverlay.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/PluginDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/WindowCommandsAndDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/addProfile.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/commandPalette.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/deleteFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/duplicateNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/editAlarm.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/exportPdf.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/gotoAnything.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/hideModalMessage.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/index.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/leaveSharedFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/moveToFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newSubFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newTodo.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openFolderDialog.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openItem.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openPdfViewer.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openTag.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/print.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/renameFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/renameTag.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/resetLayout.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/restoreFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/restoreNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/revealResourceFile.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/search.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/setTags.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showEditorPlugin.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showModalMessage.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showNoteContentProperties.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showNoteProperties.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showPrompt.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showShareFolderDialog.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showShareNoteDialog.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showSpellCheckerMenu.test.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showSpellCheckerMenu.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleEditorPlugin.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleEditors.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleLayoutMoveMode.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleMenuBar.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNoteList.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNoteType.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNotesSortOrderField.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNotesSortOrderReverse.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/togglePerFolderSortOrder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleSideBar.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleVisiblePanes.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/types.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/appDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/usePrintToCallback.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/useSyncDialogState.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/useWindowCommands.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/useWindowControl.js
 packages/app-desktop/gui/dialogs.js
+packages/app-desktop/gui/hooks/useDocument.js
 packages/app-desktop/gui/hooks/useEffectDebugger.js
 packages/app-desktop/gui/hooks/useElementHeight.js
 packages/app-desktop/gui/hooks/useImperativeHandlerDebugger.js
@@ -485,10 +515,12 @@ packages/app-desktop/integration-tests/util/createStartupArgs.js
 packages/app-desktop/integration-tests/util/extendedExpect.js
 packages/app-desktop/integration-tests/util/firstNonDevToolsWindow.js
 packages/app-desktop/integration-tests/util/getImageSourceSize.js
+packages/app-desktop/integration-tests/util/setDarkMode.js
 packages/app-desktop/integration-tests/util/setFilePickerResponse.js
 packages/app-desktop/integration-tests/util/setMessageBoxResponse.js
 packages/app-desktop/integration-tests/util/test.js
 packages/app-desktop/integration-tests/util/waitForNextOpenPath.js
+packages/app-desktop/integration-tests/wcag.spec.js
 packages/app-desktop/playwright.config.js
 packages/app-desktop/plugins/GotoAnything.js
 packages/app-desktop/services/autoUpdater/AutoUpdaterService.test.js
@@ -532,9 +564,9 @@ packages/app-desktop/utils/customProtocols/handleCustomProtocols.js
 packages/app-desktop/utils/customProtocols/registerCustomProtocols.js
 packages/app-desktop/utils/isSafeToOpen.test.js
 packages/app-desktop/utils/isSafeToOpen.js
-packages/app-desktop/utils/markupLanguageUtils.js
 packages/app-desktop/utils/restartInSafeModeFromMain.test.js
 packages/app-desktop/utils/restartInSafeModeFromMain.js
+packages/app-desktop/utils/window/types.js
 packages/app-mobile/PluginAssetsLoader.js
 packages/app-mobile/commands/index.js
 packages/app-mobile/commands/newNote.test.js
@@ -544,11 +576,23 @@ packages/app-mobile/commands/openNote.js
 packages/app-mobile/commands/scrollToHash.js
 packages/app-mobile/commands/util/goToNote.js
 packages/app-mobile/commands/util/showResource.js
-packages/app-mobile/components/BackButtonDialogBox.js
 packages/app-mobile/components/BetaChip.js
-packages/app-mobile/components/CameraView.js
+packages/app-mobile/components/CameraView/ActionButtons.js
+packages/app-mobile/components/CameraView/Camera/index.jest.js
+packages/app-mobile/components/CameraView/Camera/index.js
+packages/app-mobile/components/CameraView/Camera/types.js
+packages/app-mobile/components/CameraView/CameraView.test.js
+packages/app-mobile/components/CameraView/CameraView.js
+packages/app-mobile/components/CameraView/ScannedBarcodes.js
+packages/app-mobile/components/CameraView/types.js
+packages/app-mobile/components/CameraView/utils/fitRectIntoBounds.js
+packages/app-mobile/components/CameraView/utils/useBarcodeScanner.js
 packages/app-mobile/components/Checkbox.js
-packages/app-mobile/components/DialogManager.js
+packages/app-mobile/components/DialogManager/PromptButton.js
+packages/app-mobile/components/DialogManager/PromptDialog.js
+packages/app-mobile/components/DialogManager/hooks/useDialogControl.js
+packages/app-mobile/components/DialogManager/index.js
+packages/app-mobile/components/DialogManager/types.js
 packages/app-mobile/components/DismissibleDialog.js
 packages/app-mobile/components/Dropdown.test.js
 packages/app-mobile/components/Dropdown.js
@@ -720,9 +764,12 @@ packages/app-mobile/components/screens/ShareManager/IncomingShareItem.js
 packages/app-mobile/components/screens/ShareManager/index.test.js
 packages/app-mobile/components/screens/ShareManager/index.js
 packages/app-mobile/components/screens/UpgradeSyncTargetScreen.js
+packages/app-mobile/components/screens/dropbox-login.js
 packages/app-mobile/components/screens/encryption-config.js
 packages/app-mobile/components/screens/status.js
+packages/app-mobile/components/screens/tags.js
 packages/app-mobile/components/side-menu-content.js
+packages/app-mobile/components/testing/TestProviderStack.js
 packages/app-mobile/components/voiceTyping/VoiceTypingDialog.js
 packages/app-mobile/gulpfile.js
 packages/app-mobile/index.web.js
@@ -732,10 +779,17 @@ packages/app-mobile/services/AlarmServiceDriver.ios.js
 packages/app-mobile/services/AlarmServiceDriver.web.js
 packages/app-mobile/services/BackButtonService.js
 packages/app-mobile/services/e2ee/RSA.react-native.js
+packages/app-mobile/services/e2ee/crypto.js
 packages/app-mobile/services/plugins/PlatformImplementation.js
 packages/app-mobile/services/profiles/index.js
+packages/app-mobile/services/voiceTyping/VoiceTyping.js
+packages/app-mobile/services/voiceTyping/utils/splitWhisperText.test.js
+packages/app-mobile/services/voiceTyping/utils/splitWhisperText.js
+packages/app-mobile/services/voiceTyping/utils/unzip.android.js
+packages/app-mobile/services/voiceTyping/utils/unzip.js
 packages/app-mobile/services/voiceTyping/vosk.android.js
 packages/app-mobile/services/voiceTyping/vosk.js
+packages/app-mobile/services/voiceTyping/whisper.js
 packages/app-mobile/setupQuickActions.js
 packages/app-mobile/tools/buildInjectedJs/BundledFile.js
 packages/app-mobile/tools/buildInjectedJs/constants.js
@@ -765,6 +819,7 @@ packages/app-mobile/utils/fs-driver/testUtil/createFilesFromPathRecord.js
 packages/app-mobile/utils/fs-driver/testUtil/verifyDirectoryMatches.js
 packages/app-mobile/utils/getPackageInfo.js
 packages/app-mobile/utils/getVersionInfoText.js
+packages/app-mobile/utils/hooks/useOnLongPressProps.js
 packages/app-mobile/utils/hooks/useReduceMotionEnabled.js
 packages/app-mobile/utils/image/fileToImage.web.js
 packages/app-mobile/utils/image/getImageDimensions.js
@@ -863,6 +918,9 @@ packages/editor/CodeMirror/utils/growSelectionToNode.js
 packages/editor/CodeMirror/utils/handlePasteEvent.js
 packages/editor/CodeMirror/utils/isCursorAtBeginning.js
 packages/editor/CodeMirror/utils/isInSyntaxNode.js
+packages/editor/CodeMirror/utils/keyUpHandlerExtension.js
+packages/editor/CodeMirror/utils/overwriteModeExtension.test.js
+packages/editor/CodeMirror/utils/overwriteModeExtension.js
 packages/editor/CodeMirror/utils/searchExtension.js
 packages/editor/CodeMirror/utils/setupVim.js
 packages/editor/SelectionFormatting.js
@@ -968,6 +1026,8 @@ packages/lib/geolocation-node.js
 packages/lib/hooks/useAsyncEffect.js
 packages/lib/hooks/useElementSize.js
 packages/lib/hooks/useEventListener.js
+packages/lib/hooks/useNowEffect.test.js
+packages/lib/hooks/useNowEffect.js
 packages/lib/hooks/usePlugin.js
 packages/lib/hooks/usePrevious.js
 packages/lib/hooks/useQueuedAsyncEffect.test.js
@@ -1097,6 +1157,10 @@ packages/lib/services/debug/populateDatabase.js
 packages/lib/services/e2ee/EncryptionService.test.js
 packages/lib/services/e2ee/EncryptionService.js
 packages/lib/services/e2ee/RSA.node.js
+packages/lib/services/e2ee/crypto.test.js
+packages/lib/services/e2ee/crypto.js
+packages/lib/services/e2ee/cryptoShared.js
+packages/lib/services/e2ee/cryptoTestUtils.js
 packages/lib/services/e2ee/ppk.test.js
 packages/lib/services/e2ee/ppk.js
 packages/lib/services/e2ee/ppkTestUtils.js
@@ -1124,6 +1188,8 @@ packages/lib/services/interop/InteropService_Importer_Md.test.js
 packages/lib/services/interop/InteropService_Importer_Md.js
 packages/lib/services/interop/InteropService_Importer_Md_frontmatter.test.js
 packages/lib/services/interop/InteropService_Importer_Md_frontmatter.js
+packages/lib/services/interop/InteropService_Importer_OneNote.test.js
+packages/lib/services/interop/InteropService_Importer_OneNote.js
 packages/lib/services/interop/InteropService_Importer_Raw.test.js
 packages/lib/services/interop/InteropService_Importer_Raw.js
 packages/lib/services/interop/Module.test.js
@@ -1135,7 +1201,6 @@ packages/lib/services/keychain/KeychainService.test.js
 packages/lib/services/keychain/KeychainService.js
 packages/lib/services/keychain/KeychainServiceDriver.dummy.js
 packages/lib/services/keychain/KeychainServiceDriver.electron.js
-packages/lib/services/keychain/KeychainServiceDriver.mobile.js
 packages/lib/services/keychain/KeychainServiceDriver.node.js
 packages/lib/services/keychain/KeychainServiceDriverBase.js
 packages/lib/services/noteList/defaultLeftToRightListRenderer.js
@@ -1177,6 +1242,7 @@ packages/lib/services/plugins/api/JoplinPlugins.js
 packages/lib/services/plugins/api/JoplinSettings.js
 packages/lib/services/plugins/api/JoplinViews.js
 packages/lib/services/plugins/api/JoplinViewsDialogs.js
+packages/lib/services/plugins/api/JoplinViewsEditor.js
 packages/lib/services/plugins/api/JoplinViewsMenuItems.js
 packages/lib/services/plugins/api/JoplinViewsMenus.js
 packages/lib/services/plugins/api/JoplinViewsNoteList.js
@@ -1195,6 +1261,7 @@ packages/lib/services/plugins/testing/MockPlatformImplementation.js
 packages/lib/services/plugins/testing/MockPluginRunner.js
 packages/lib/services/plugins/utils/createViewHandle.js
 packages/lib/services/plugins/utils/executeSandboxCall.js
+packages/lib/services/plugins/utils/getActivePluginEditorView.js
 packages/lib/services/plugins/utils/getPluginIssueReportUrl.test.js
 packages/lib/services/plugins/utils/getPluginIssueReportUrl.js
 packages/lib/services/plugins/utils/getPluginNamespacedSettingKey.js
@@ -1309,6 +1376,7 @@ packages/lib/services/trash/permanentlyDeleteOldItems.test.js
 packages/lib/services/trash/permanentlyDeleteOldItems.js
 packages/lib/services/trash/restoreItems.test.js
 packages/lib/services/trash/restoreItems.js
+packages/lib/shim-init-node.test.js
 packages/lib/shim-init-node.js
 packages/lib/shim.js
 packages/lib/string-utils.test.js
@@ -1333,6 +1401,7 @@ packages/lib/types.js
 packages/lib/urlUtils.js
 packages/lib/utils/ActionLogger.test.js
 packages/lib/utils/ActionLogger.js
+packages/lib/utils/attachedResources.js
 packages/lib/utils/credentialFiles.js
 packages/lib/utils/dom/makeSandboxedIframe.js
 packages/lib/utils/focusHandler.js
@@ -1352,6 +1421,7 @@ packages/lib/utils/ipc/utils/separateCallbacksFromSerializable.js
 packages/lib/utils/ipc/utils/separateCallbacksFromSerializableArray.js
 packages/lib/utils/joplinCloud/index.js
 packages/lib/utils/joplinCloud/types.js
+packages/lib/utils/markupLanguageUtils.js
 packages/lib/utils/processStartFlags.js
 packages/lib/utils/replaceUnsupportedCharacters.test.js
 packages/lib/utils/replaceUnsupportedCharacters.js
@@ -1487,6 +1557,7 @@ packages/tools/update-readme-download.test.js
 packages/tools/update-readme-download.js
 packages/tools/update-readme-sponsors.js
 packages/tools/updateMarkdownDoc.js
+packages/tools/utils/discourse.test.js
 packages/tools/utils/discourse.js
 packages/tools/utils/loadSponsors.js
 packages/tools/utils/translation.js

.eslintrc.js

@@ -287,6 +287,14 @@ module.exports = {
 							'match': true,
 						},
 					},
+					{
+						selector: 'enumMember',
+						format: null,
+						'filter': {
+							'regex': '^(sha1|sha256|sha384|sha512|AES_128_GCM|AES_192_GCM|AES_256_GCM)$',
+							'match': true,
+						},
+					},
 
 					// -----------------------------------
 					// INTERFACE

.github/scripts/run_ci.sh

@@ -55,6 +55,7 @@ echo "GIT_TAG_NAME=$GIT_TAG_NAME"
 echo "BUILD_SEQUENCIAL=$BUILD_SEQUENCIAL"
 echo "SERVER_REPOSITORY=$SERVER_REPOSITORY"
 echo "SERVER_TAG_PREFIX=$SERVER_TAG_PREFIX"
+echo "PR_TITLE=$PR_TITLE"
 
 echo "IS_CONTINUOUS_INTEGRATION=$IS_CONTINUOUS_INTEGRATION"
 echo "IS_PULL_REQUEST=$IS_PULL_REQUEST"
@@ -67,6 +68,7 @@ echo "IS_MACOS=$IS_MACOS"
 echo "Node $( node -v )"
 echo "Npm $( npm -v )"
 echo "Yarn $( yarn -v )"
+echo "Rust $( rustc --version )"
 
 # =============================================================================
 # Install packages
@@ -80,40 +82,6 @@ if [ $testResult -ne 0 ]; then
 	exit $testResult
 fi
 
-# =============================================================================
-# Run test units
-# =============================================================================
-
-if [ "$RUN_TESTS" == "1" ]; then
-	echo "Step: Running tests..."
-
-	# On Linux, we run the Joplin Server tests using PostgreSQL
-	if [ "$IS_LINUX" == "1" ]; then
-		echo "Running Joplin Server tests using PostgreSQL..."
-		sudo docker compose --file docker-compose.db-dev.yml up -d
-		cmdResult=$?
-		if [ $cmdResult -ne 0 ]; then
-			exit $cmdResult
-		fi
-		export JOPLIN_TESTS_SERVER_DB=pg
-	else
-		echo "Running Joplin Server tests using SQLite..."
-	fi
-
-	# Need this because we're getting this error:
-	#
-	# @joplin/lib: FATAL ERROR: Ineffective mark-compacts near heap limit
-	# Allocation failed - JavaScript heap out of memory
-	#
-	# https://stackoverflow.com/questions/38558989
-	export NODE_OPTIONS="--max-old-space-size=32768"
-	yarn test-ci
-	testResult=$?
-	if [ $testResult -ne 0 ]; then
-		exit $testResult
-	fi
-fi
-
 # =============================================================================
 # Run linter for pull requests only. We also don't want this to make the desktop
 # release randomly fail.
@@ -171,6 +139,23 @@ if [ "$RUN_TESTS" == "1" ]; then
 	fi
 fi
 
+# =============================================================================
+# Check whether this is a translation PR. There is no need to run the entire
+# pipeline in such a case, thus exit early.
+# =============================================================================
+
+if [ "$RUN_TESTS" == "1" ]; then
+	# Due to the ancient bash release in macOS, the following is required, instead
+	# of using ${var,,}
+	PR_TITLE=$(echo $PR_TITLE |tr '[:upper:]' '[:lower:]')
+	echo "Step: Checking for translation PR..."
+
+	if [[ "$PR_TITLE" =~ ^.*(translation|(add|fix|update) .*language|\.po)( .*)?$ ]]; then
+		echo "It is a translation PR. Exit early."
+		exit 0
+	fi
+fi
+
 # =============================================================================
 # Check .gitignore and .eslintignore files - they should be updated when
 # new TypeScript files are added by running `yarn updateIgnored`.
@@ -184,7 +169,7 @@ if [ "$IS_LINUX" == "1" ]; then
 	# so that checkIgnoredFiles works.
 	git restore .gitignore .eslintignore
 
-	node packages/tools/checkIgnoredFiles.js 
+	node packages/tools/checkIgnoredFiles.js
 	testResult=$?
 	if [ $testResult -ne 0 ]; then
 		exit $testResult
@@ -223,6 +208,40 @@ if [ "$IS_LINUX" == "1" ]; then
 	fi
 fi
 
+# =============================================================================
+# Run test units
+# =============================================================================
+
+if [ "$RUN_TESTS" == "1" ]; then
+	echo "Step: Running tests..."
+
+	# On Linux, we run the Joplin Server tests using PostgreSQL
+	if [ "$IS_LINUX" == "1" ]; then
+		echo "Running Joplin Server tests using PostgreSQL..."
+		sudo docker compose --file docker-compose.db-dev.yml up -d
+		cmdResult=$?
+		if [ $cmdResult -ne 0 ]; then
+			exit $cmdResult
+		fi
+		export JOPLIN_TESTS_SERVER_DB=pg
+	else
+		echo "Running Joplin Server tests using SQLite..."
+	fi
+
+	# Need this because we're getting this error:
+	#
+	# @joplin/lib: FATAL ERROR: Ineffective mark-compacts near heap limit
+	# Allocation failed - JavaScript heap out of memory
+	#
+	# https://stackoverflow.com/questions/38558989
+	export NODE_OPTIONS="--max-old-space-size=32768"
+	yarn test-ci
+	testResult=$?
+	if [ $testResult -ne 0 ]; then
+		exit $testResult
+	fi
+fi
+
 # =============================================================================
 # Find out if we should run the build or not. Electron-builder gets stuck when
 # building PRs so we disable it in this case. The Linux build should provide
@@ -256,7 +275,7 @@ if [ "$IS_DESKTOP_RELEASE" == "1" ]; then
 
 	if [ "$IS_MACOS" == "1" ]; then
 		# This is to fix this error:
-		# 
+		#
 		# Exit code: ENOENT. spawn /usr/bin/python ENOENT
 		#
 		# Ref: https://github.com/electron-userland/electron-builder/issues/6767#issuecomment-1096589528
@@ -272,14 +291,14 @@ if [ "$IS_DESKTOP_RELEASE" == "1" ]; then
 		USE_HARD_LINKS=false yarn dist
 	else
 		USE_HARD_LINKS=false yarn dist
-	fi	
+	fi
 elif [[ $IS_LINUX = 1 ]] && [ "$IS_SERVER_RELEASE" == "1" ]; then
 	echo "Step: Building Docker Image..."
 	cd "$ROOT_DIR"
 	yarn buildServerDocker --tag-name $GIT_TAG_NAME --push-images --repository $SERVER_REPOSITORY
 else
 	echo "Step: Building but *not* publishing desktop application..."
-	
+
 	if [ "$IS_MACOS" == "1" ]; then
 		# See above why we need to specify Python
 		alias python=$(which python3)
@@ -289,7 +308,7 @@ else
 		# https://www.electron.build/code-signing#how-to-disable-code-signing-during-the-build-process-on-macos
 		export CSC_IDENTITY_AUTO_DISCOVERY=false
 		npm pkg set 'build.mac.identity'=null --json
-		
+
 		USE_HARD_LINKS=false yarn dist --publish=never
 	else
 		USE_HARD_LINKS=false yarn dist --publish=never

.github/workflows/automerge.yml

@@ -3,6 +3,14 @@ on:
   schedule:
     - cron: '*/10 * * * *'
 jobs:
+
+  # This job will make the action fail if any of the checks hasn't passed
+  # https://github.com/marketplace/actions/allcheckspassed
+  # allchecks:
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: wechuli/allcheckspassed@v1
+
   automerge:
     runs-on: ubuntu-latest
     permissions:

.github/workflows/build-android.yml

@@ -5,20 +5,8 @@ name: react-native-android-build-apk
 on: [push, pull_request]
 
 jobs:
-  pre_job:
-    if: github.repository == 'laurent22/joplin'
-    runs-on: ubuntu-latest
-    outputs:
-      should_skip: ${{ steps.skip_check.outputs.should_skip }}
-    steps:
-      - id: skip_check
-        uses: fkirc/skip-duplicate-actions@v5
-        with:
-          concurrent_skipping: 'same_content_newer'
-
   AssembleRelease:
-    needs: pre_job
-    if: github.repository == 'laurent22/joplin' && needs.pre_job.outputs.should_skip != 'true'
+    if: github.repository == 'laurent22/joplin'
     runs-on: ubuntu-latest
     steps:
       - name: Install Linux dependencies
@@ -38,6 +26,8 @@ jobs:
           node-version: '18'
           cache: 'yarn'
 
+      - uses: dtolnay/rust-toolchain@stable
+
       - name: Install Yarn
         run: |
           corepack enable

.github/workflows/build-macos-m1.yml

@@ -1,21 +1,9 @@
 name: Build macOS M1
 on: [push, pull_request]
 jobs:
-  pre_job:
-    if: github.repository == 'laurent22/joplin'
-    runs-on: ubuntu-latest
-    outputs:
-      should_skip: ${{ steps.skip_check.outputs.should_skip }}
-    steps:
-      - id: skip_check
-        uses: fkirc/skip-duplicate-actions@v5
-        with:
-          concurrent_skipping: 'same_content_newer'
-
   Main:
-    needs: pre_job
     # We always process desktop release tags, because they also publish the release
-    if: github.repository == 'laurent22/joplin' && (needs.pre_job.outputs.should_skip != 'true' || startsWith(github.ref, 'refs/tags/v'))
+    if: github.repository == 'laurent22/joplin'
     runs-on: macos-latest
     steps:
 

.github/workflows/cla.yml

@@ -22,7 +22,7 @@ jobs:
           path-to-signatures: 'readme/cla_signatures.json'
           path-to-document: 'https://github.com/laurent22/joplin/blob/dev/readme/cla.md' # e.g. a CLA or a DCO document
           # branch should not be protected
-          branch: 'dev'
+          branch: 'cla_signatures'
           allowlist: joplinbot,renovate[bot]
 
          # the followings are the optional inputs - If the optional inputs are not given, then default values will be taken

.github/workflows/github-actions-main.yml

@@ -1,29 +1,15 @@
 name: Joplin Continuous Integration
 on: [push, pull_request]
 jobs:
-  pre_job:
-    if: github.repository == 'laurent22/joplin'
-    # Do not use unbuntu-latest because it causes `The operation was canceled` failures:
-    # https://github.com/actions/runner-images/issues/6709
-    runs-on: ubuntu-20.04
-    outputs:
-      should_skip: ${{ steps.skip_check.outputs.should_skip }}
-    steps:
-      - id: skip_check
-        uses: fkirc/skip-duplicate-actions@v5
-        with:
-          concurrent_skipping: 'same_content_newer'
-
   Main:
-    needs: pre_job
     # We always process server or desktop release tags, because they also publish the release
-    if: github.repository == 'laurent22/joplin' && (needs.pre_job.outputs.should_skip != 'true' || startsWith(github.ref, 'refs/tags/server-v') || startsWith(github.ref, 'refs/tags/v'))
+    if: github.repository == 'laurent22/joplin'
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         # Do not use unbuntu-latest because it causes `The operation was canceled` failures:
         # https://github.com/actions/runner-images/issues/6709
-        os: [macos-12, ubuntu-20.04, windows-2019]
+        os: [macos-13, ubuntu-20.04, windows-2019]
     steps:
 
       # Trying to fix random networking issues on Windows
@@ -83,6 +69,7 @@ jobs:
 
       - uses: actions/checkout@v4
       - uses: olegtarasov/get-tag@v2.1.3
+      - uses: dtolnay/rust-toolchain@stable
       - uses: actions/setup-node@v4
         with:
           # We need to pin the version to 18.15, because 18.16+ fails with this error:
@@ -94,7 +81,7 @@ jobs:
         run: |
           # https://yarnpkg.com/getting-started/install
           corepack enable
-      
+
       # Login to Docker only if we're on a server release tag. If we run this on
       # a pull request it will fail because the PR doesn't have access to
       # secrets
@@ -128,6 +115,7 @@ jobs:
           SERVER_REPOSITORY: joplin/server
           SERVER_TAG_PREFIX: server
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+          PR_TITLE: ${{ github.event.pull_request.title }}
         run: |
           "${GITHUB_WORKSPACE}/.github/scripts/run_ci.sh"
 
@@ -157,8 +145,7 @@ jobs:
           yarn install && cd packages/app-desktop && yarn dist --publish=never
 
   ServerDockerImage:
-    needs: pre_job
-    if: github.repository == 'laurent22/joplin' && needs.pre_job.outputs.should_skip != 'true'
+    if: github.repository == 'laurent22/joplin'
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
@@ -203,7 +190,7 @@ jobs:
           # Basic test to ensure that the created build is valid. It should exit with
           # code 0  if it works.
           docker run joplin/server:0.0.0-beta node dist/app.js migrate list
- 
+
       - name: Check HTTP request
         run: |
           # Need to pass environment variables:
@@ -215,23 +202,22 @@ jobs:
           # Check if status code is correct
           # if the actual_status DOES NOT include the expected_status
           # it exits the process with code 1
-          
+
           expected_status="HTTP/1.1 200 OK"
           actual_status=$(curl -I -X GET http://localhost:22300/api/ping | head -n 1)
-          if [[ ! "$actual_status" =~ "$expected_status" ]]; then 
+          if [[ ! "$actual_status" =~ "$expected_status" ]]; then
             echo 'Failed while checking the status code after request to /api/ping'
             echo 'expected: ' $expected_status
             echo 'actual:   ' $actual_status
-            exit 1; 
+            exit 1;
           fi
-          
+
           # Check if the body response is correct
           # if the actual_body is different of expected_body exit with code 1
           expected_body='{"status":"ok","message":"Joplin Server is running"}'
           actual_body=$(curl http://localhost:22300/api/ping)
-          
+
           if [[ "$actual_body" != "$expected_body" ]]; then
             echo 'Failed while checking the body response after request to /api/ping'
             exit 1;
           fi
-

.gitignore

@@ -127,11 +127,16 @@ packages/app-desktop/checkForUpdates.js
 packages/app-desktop/commands/copyDevCommand.js
 packages/app-desktop/commands/editProfileConfig.js
 packages/app-desktop/commands/emptyTrash.js
+packages/app-desktop/commands/exportDeletionLog.test.js
+packages/app-desktop/commands/exportDeletionLog.js
 packages/app-desktop/commands/exportFolders.js
 packages/app-desktop/commands/exportNotes.js
 packages/app-desktop/commands/focusElement.js
 packages/app-desktop/commands/index.js
+packages/app-desktop/commands/openNoteInNewWindow.js
 packages/app-desktop/commands/openProfileDirectory.js
+packages/app-desktop/commands/renderMarkup.test.js
+packages/app-desktop/commands/renderMarkup.js
 packages/app-desktop/commands/replaceMisspelling.js
 packages/app-desktop/commands/restoreNoteRevision.js
 packages/app-desktop/commands/startExternalEditing.js
@@ -182,60 +187,14 @@ packages/app-desktop/gui/KeymapConfig/styles/index.js
 packages/app-desktop/gui/KeymapConfig/utils/getLabel.js
 packages/app-desktop/gui/KeymapConfig/utils/useCommandStatus.js
 packages/app-desktop/gui/KeymapConfig/utils/useKeymap.js
-packages/app-desktop/gui/MainScreen/MainScreen.js
-packages/app-desktop/gui/MainScreen/commands/addProfile.js
-packages/app-desktop/gui/MainScreen/commands/commandPalette.js
-packages/app-desktop/gui/MainScreen/commands/deleteFolder.js
-packages/app-desktop/gui/MainScreen/commands/duplicateNote.js
-packages/app-desktop/gui/MainScreen/commands/editAlarm.js
-packages/app-desktop/gui/MainScreen/commands/exportPdf.js
-packages/app-desktop/gui/MainScreen/commands/gotoAnything.js
-packages/app-desktop/gui/MainScreen/commands/hideModalMessage.js
-packages/app-desktop/gui/MainScreen/commands/index.js
-packages/app-desktop/gui/MainScreen/commands/leaveSharedFolder.js
-packages/app-desktop/gui/MainScreen/commands/moveToFolder.js
-packages/app-desktop/gui/MainScreen/commands/newFolder.js
-packages/app-desktop/gui/MainScreen/commands/newNote.js
-packages/app-desktop/gui/MainScreen/commands/newSubFolder.js
-packages/app-desktop/gui/MainScreen/commands/newTodo.js
-packages/app-desktop/gui/MainScreen/commands/openFolder.js
-packages/app-desktop/gui/MainScreen/commands/openFolderDialog.js
-packages/app-desktop/gui/MainScreen/commands/openItem.js
-packages/app-desktop/gui/MainScreen/commands/openNote.js
-packages/app-desktop/gui/MainScreen/commands/openPdfViewer.js
-packages/app-desktop/gui/MainScreen/commands/openTag.js
-packages/app-desktop/gui/MainScreen/commands/print.js
-packages/app-desktop/gui/MainScreen/commands/renameFolder.js
-packages/app-desktop/gui/MainScreen/commands/renameTag.js
-packages/app-desktop/gui/MainScreen/commands/resetLayout.js
-packages/app-desktop/gui/MainScreen/commands/restoreFolder.js
-packages/app-desktop/gui/MainScreen/commands/restoreNote.js
-packages/app-desktop/gui/MainScreen/commands/revealResourceFile.js
-packages/app-desktop/gui/MainScreen/commands/search.js
-packages/app-desktop/gui/MainScreen/commands/setTags.js
-packages/app-desktop/gui/MainScreen/commands/showModalMessage.js
-packages/app-desktop/gui/MainScreen/commands/showNoteContentProperties.js
-packages/app-desktop/gui/MainScreen/commands/showNoteProperties.js
-packages/app-desktop/gui/MainScreen/commands/showPrompt.js
-packages/app-desktop/gui/MainScreen/commands/showShareFolderDialog.js
-packages/app-desktop/gui/MainScreen/commands/showShareNoteDialog.js
-packages/app-desktop/gui/MainScreen/commands/showSpellCheckerMenu.test.js
-packages/app-desktop/gui/MainScreen/commands/showSpellCheckerMenu.js
-packages/app-desktop/gui/MainScreen/commands/toggleEditors.js
-packages/app-desktop/gui/MainScreen/commands/toggleLayoutMoveMode.js
-packages/app-desktop/gui/MainScreen/commands/toggleMenuBar.js
-packages/app-desktop/gui/MainScreen/commands/toggleNoteList.js
-packages/app-desktop/gui/MainScreen/commands/toggleNoteType.js
-packages/app-desktop/gui/MainScreen/commands/toggleNotesSortOrderField.js
-packages/app-desktop/gui/MainScreen/commands/toggleNotesSortOrderReverse.js
-packages/app-desktop/gui/MainScreen/commands/togglePerFolderSortOrder.js
-packages/app-desktop/gui/MainScreen/commands/toggleSideBar.js
-packages/app-desktop/gui/MainScreen/commands/toggleVisiblePanes.js
+packages/app-desktop/gui/MainScreen.js
 packages/app-desktop/gui/MasterPasswordDialog/Dialog.js
 packages/app-desktop/gui/MenuBar.js
 packages/app-desktop/gui/MultiNoteActions.js
 packages/app-desktop/gui/Navigator.js
+packages/app-desktop/gui/NewWindowOrIFrame.js
 packages/app-desktop/gui/NoteContentPropertiesDialog.js
+packages/app-desktop/gui/NoteEditor/EditorWindow.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/Toolbar.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/utils/index.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/utils/normalizeAccelerator.test.js
@@ -261,6 +220,7 @@ packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v5/utils/useScrollUtils.
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/CodeMirror.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/Editor.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/useEditorCommands.js
+packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/utils/localisation.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/utils/useKeymap.js
 packages/app-desktop/gui/NoteEditor/NoteBody/CodeMirror/v6/utils/useRefocusOnVisiblePaneChange.js
 packages/app-desktop/gui/NoteEditor/NoteBody/PlainEditor/PlainEditor.js
@@ -295,6 +255,7 @@ packages/app-desktop/gui/NoteEditor/utils/clipboardUtils.test.js
 packages/app-desktop/gui/NoteEditor/utils/clipboardUtils.js
 packages/app-desktop/gui/NoteEditor/utils/contextMenu.js
 packages/app-desktop/gui/NoteEditor/utils/contextMenuUtils.js
+packages/app-desktop/gui/NoteEditor/utils/getWindowCommandPriority.js
 packages/app-desktop/gui/NoteEditor/utils/index.js
 packages/app-desktop/gui/NoteEditor/utils/markupRenderOptions.js
 packages/app-desktop/gui/NoteEditor/utils/resourceHandling.test.js
@@ -308,6 +269,8 @@ packages/app-desktop/gui/NoteEditor/utils/useFormNote.js
 packages/app-desktop/gui/NoteEditor/utils/useMarkupToHtml.js
 packages/app-desktop/gui/NoteEditor/utils/useMessageHandler.js
 packages/app-desktop/gui/NoteEditor/utils/useNoteSearchBar.js
+packages/app-desktop/gui/NoteEditor/utils/usePluginEditorView.test.js
+packages/app-desktop/gui/NoteEditor/utils/usePluginEditorView.js
 packages/app-desktop/gui/NoteEditor/utils/usePluginServiceRegistration.js
 packages/app-desktop/gui/NoteEditor/utils/useScheduleSaveCallbacks.js
 packages/app-desktop/gui/NoteEditor/utils/useScrollWhenReadyOptions.js
@@ -362,7 +325,9 @@ packages/app-desktop/gui/NoteTextViewer.js
 packages/app-desktop/gui/NoteToolbar/NoteToolbar.js
 packages/app-desktop/gui/NotyfContext.js
 packages/app-desktop/gui/OneDriveLoginScreen.js
+packages/app-desktop/gui/PasswordInput/LabelledPasswordInput.js
 packages/app-desktop/gui/PasswordInput/PasswordInput.js
+packages/app-desktop/gui/PasswordInput/types.js
 packages/app-desktop/gui/PdfViewer.js
 packages/app-desktop/gui/PromptDialog.js
 packages/app-desktop/gui/ResizableLayout/MoveButtons.js
@@ -396,16 +361,19 @@ packages/app-desktop/gui/Sidebar/commands/focusElementSideBar.js
 packages/app-desktop/gui/Sidebar/commands/index.js
 packages/app-desktop/gui/Sidebar/hooks/useFocusHandler.js
 packages/app-desktop/gui/Sidebar/hooks/useOnRenderItem.js
+packages/app-desktop/gui/Sidebar/hooks/useOnRenderListWrapper.js
 packages/app-desktop/gui/Sidebar/hooks/useOnSidebarKeyDownHandler.js
 packages/app-desktop/gui/Sidebar/hooks/useSelectedSidebarIndex.js
 packages/app-desktop/gui/Sidebar/hooks/useSidebarCommandHandler.js
 packages/app-desktop/gui/Sidebar/hooks/useSidebarListData.js
+packages/app-desktop/gui/Sidebar/hooks/utils/toggleHeader.js
 packages/app-desktop/gui/Sidebar/listItemComponents/AllNotesItem.js
 packages/app-desktop/gui/Sidebar/listItemComponents/EmptyExpandLink.js
 packages/app-desktop/gui/Sidebar/listItemComponents/ExpandIcon.js
 packages/app-desktop/gui/Sidebar/listItemComponents/ExpandLink.js
 packages/app-desktop/gui/Sidebar/listItemComponents/FolderItem.js
 packages/app-desktop/gui/Sidebar/listItemComponents/HeaderItem.js
+packages/app-desktop/gui/Sidebar/listItemComponents/ListItemWrapper.js
 packages/app-desktop/gui/Sidebar/listItemComponents/NoteCount.js
 packages/app-desktop/gui/Sidebar/listItemComponents/TagItem.js
 packages/app-desktop/gui/Sidebar/styles/index.js
@@ -422,7 +390,68 @@ packages/app-desktop/gui/ToolbarButton/ToolbarButton.js
 packages/app-desktop/gui/ToolbarSpace.js
 packages/app-desktop/gui/TrashNotification/TrashNotification.js
 packages/app-desktop/gui/UpdateNotification/UpdateNotification.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/AppDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/ModalMessageOverlay.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/PluginDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/WindowCommandsAndDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/addProfile.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/commandPalette.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/deleteFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/duplicateNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/editAlarm.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/exportPdf.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/gotoAnything.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/hideModalMessage.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/index.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/leaveSharedFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/moveToFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newSubFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/newTodo.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openFolderDialog.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openItem.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openPdfViewer.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/openTag.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/print.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/renameFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/renameTag.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/resetLayout.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/restoreFolder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/restoreNote.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/revealResourceFile.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/search.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/setTags.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showEditorPlugin.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showModalMessage.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showNoteContentProperties.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showNoteProperties.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showPrompt.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showShareFolderDialog.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showShareNoteDialog.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showSpellCheckerMenu.test.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/showSpellCheckerMenu.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleEditorPlugin.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleEditors.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleLayoutMoveMode.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleMenuBar.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNoteList.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNoteType.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNotesSortOrderField.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleNotesSortOrderReverse.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/togglePerFolderSortOrder.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleSideBar.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/commands/toggleVisiblePanes.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/types.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/appDialogs.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/usePrintToCallback.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/useSyncDialogState.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/useWindowCommands.js
+packages/app-desktop/gui/WindowCommandsAndDialogs/utils/useWindowControl.js
 packages/app-desktop/gui/dialogs.js
+packages/app-desktop/gui/hooks/useDocument.js
 packages/app-desktop/gui/hooks/useEffectDebugger.js
 packages/app-desktop/gui/hooks/useElementHeight.js
 packages/app-desktop/gui/hooks/useImperativeHandlerDebugger.js
@@ -462,10 +491,12 @@ packages/app-desktop/integration-tests/util/createStartupArgs.js
 packages/app-desktop/integration-tests/util/extendedExpect.js
 packages/app-desktop/integration-tests/util/firstNonDevToolsWindow.js
 packages/app-desktop/integration-tests/util/getImageSourceSize.js
+packages/app-desktop/integration-tests/util/setDarkMode.js
 packages/app-desktop/integration-tests/util/setFilePickerResponse.js
 packages/app-desktop/integration-tests/util/setMessageBoxResponse.js
 packages/app-desktop/integration-tests/util/test.js
 packages/app-desktop/integration-tests/util/waitForNextOpenPath.js
+packages/app-desktop/integration-tests/wcag.spec.js
 packages/app-desktop/playwright.config.js
 packages/app-desktop/plugins/GotoAnything.js
 packages/app-desktop/services/autoUpdater/AutoUpdaterService.test.js
@@ -509,9 +540,9 @@ packages/app-desktop/utils/customProtocols/handleCustomProtocols.js
 packages/app-desktop/utils/customProtocols/registerCustomProtocols.js
 packages/app-desktop/utils/isSafeToOpen.test.js
 packages/app-desktop/utils/isSafeToOpen.js
-packages/app-desktop/utils/markupLanguageUtils.js
 packages/app-desktop/utils/restartInSafeModeFromMain.test.js
 packages/app-desktop/utils/restartInSafeModeFromMain.js
+packages/app-desktop/utils/window/types.js
 packages/app-mobile/PluginAssetsLoader.js
 packages/app-mobile/commands/index.js
 packages/app-mobile/commands/newNote.test.js
@@ -521,11 +552,23 @@ packages/app-mobile/commands/openNote.js
 packages/app-mobile/commands/scrollToHash.js
 packages/app-mobile/commands/util/goToNote.js
 packages/app-mobile/commands/util/showResource.js
-packages/app-mobile/components/BackButtonDialogBox.js
 packages/app-mobile/components/BetaChip.js
-packages/app-mobile/components/CameraView.js
+packages/app-mobile/components/CameraView/ActionButtons.js
+packages/app-mobile/components/CameraView/Camera/index.jest.js
+packages/app-mobile/components/CameraView/Camera/index.js
+packages/app-mobile/components/CameraView/Camera/types.js
+packages/app-mobile/components/CameraView/CameraView.test.js
+packages/app-mobile/components/CameraView/CameraView.js
+packages/app-mobile/components/CameraView/ScannedBarcodes.js
+packages/app-mobile/components/CameraView/types.js
+packages/app-mobile/components/CameraView/utils/fitRectIntoBounds.js
+packages/app-mobile/components/CameraView/utils/useBarcodeScanner.js
 packages/app-mobile/components/Checkbox.js
-packages/app-mobile/components/DialogManager.js
+packages/app-mobile/components/DialogManager/PromptButton.js
+packages/app-mobile/components/DialogManager/PromptDialog.js
+packages/app-mobile/components/DialogManager/hooks/useDialogControl.js
+packages/app-mobile/components/DialogManager/index.js
+packages/app-mobile/components/DialogManager/types.js
 packages/app-mobile/components/DismissibleDialog.js
 packages/app-mobile/components/Dropdown.test.js
 packages/app-mobile/components/Dropdown.js
@@ -697,9 +740,12 @@ packages/app-mobile/components/screens/ShareManager/IncomingShareItem.js
 packages/app-mobile/components/screens/ShareManager/index.test.js
 packages/app-mobile/components/screens/ShareManager/index.js
 packages/app-mobile/components/screens/UpgradeSyncTargetScreen.js
+packages/app-mobile/components/screens/dropbox-login.js
 packages/app-mobile/components/screens/encryption-config.js
 packages/app-mobile/components/screens/status.js
+packages/app-mobile/components/screens/tags.js
 packages/app-mobile/components/side-menu-content.js
+packages/app-mobile/components/testing/TestProviderStack.js
 packages/app-mobile/components/voiceTyping/VoiceTypingDialog.js
 packages/app-mobile/gulpfile.js
 packages/app-mobile/index.web.js
@@ -709,10 +755,17 @@ packages/app-mobile/services/AlarmServiceDriver.ios.js
 packages/app-mobile/services/AlarmServiceDriver.web.js
 packages/app-mobile/services/BackButtonService.js
 packages/app-mobile/services/e2ee/RSA.react-native.js
+packages/app-mobile/services/e2ee/crypto.js
 packages/app-mobile/services/plugins/PlatformImplementation.js
 packages/app-mobile/services/profiles/index.js
+packages/app-mobile/services/voiceTyping/VoiceTyping.js
+packages/app-mobile/services/voiceTyping/utils/splitWhisperText.test.js
+packages/app-mobile/services/voiceTyping/utils/splitWhisperText.js
+packages/app-mobile/services/voiceTyping/utils/unzip.android.js
+packages/app-mobile/services/voiceTyping/utils/unzip.js
 packages/app-mobile/services/voiceTyping/vosk.android.js
 packages/app-mobile/services/voiceTyping/vosk.js
+packages/app-mobile/services/voiceTyping/whisper.js
 packages/app-mobile/setupQuickActions.js
 packages/app-mobile/tools/buildInjectedJs/BundledFile.js
 packages/app-mobile/tools/buildInjectedJs/constants.js
@@ -742,6 +795,7 @@ packages/app-mobile/utils/fs-driver/testUtil/createFilesFromPathRecord.js
 packages/app-mobile/utils/fs-driver/testUtil/verifyDirectoryMatches.js
 packages/app-mobile/utils/getPackageInfo.js
 packages/app-mobile/utils/getVersionInfoText.js
+packages/app-mobile/utils/hooks/useOnLongPressProps.js
 packages/app-mobile/utils/hooks/useReduceMotionEnabled.js
 packages/app-mobile/utils/image/fileToImage.web.js
 packages/app-mobile/utils/image/getImageDimensions.js
@@ -840,6 +894,9 @@ packages/editor/CodeMirror/utils/growSelectionToNode.js
 packages/editor/CodeMirror/utils/handlePasteEvent.js
 packages/editor/CodeMirror/utils/isCursorAtBeginning.js
 packages/editor/CodeMirror/utils/isInSyntaxNode.js
+packages/editor/CodeMirror/utils/keyUpHandlerExtension.js
+packages/editor/CodeMirror/utils/overwriteModeExtension.test.js
+packages/editor/CodeMirror/utils/overwriteModeExtension.js
 packages/editor/CodeMirror/utils/searchExtension.js
 packages/editor/CodeMirror/utils/setupVim.js
 packages/editor/SelectionFormatting.js
@@ -945,6 +1002,8 @@ packages/lib/geolocation-node.js
 packages/lib/hooks/useAsyncEffect.js
 packages/lib/hooks/useElementSize.js
 packages/lib/hooks/useEventListener.js
+packages/lib/hooks/useNowEffect.test.js
+packages/lib/hooks/useNowEffect.js
 packages/lib/hooks/usePlugin.js
 packages/lib/hooks/usePrevious.js
 packages/lib/hooks/useQueuedAsyncEffect.test.js
@@ -1074,6 +1133,10 @@ packages/lib/services/debug/populateDatabase.js
 packages/lib/services/e2ee/EncryptionService.test.js
 packages/lib/services/e2ee/EncryptionService.js
 packages/lib/services/e2ee/RSA.node.js
+packages/lib/services/e2ee/crypto.test.js
+packages/lib/services/e2ee/crypto.js
+packages/lib/services/e2ee/cryptoShared.js
+packages/lib/services/e2ee/cryptoTestUtils.js
 packages/lib/services/e2ee/ppk.test.js
 packages/lib/services/e2ee/ppk.js
 packages/lib/services/e2ee/ppkTestUtils.js
@@ -1101,6 +1164,8 @@ packages/lib/services/interop/InteropService_Importer_Md.test.js
 packages/lib/services/interop/InteropService_Importer_Md.js
 packages/lib/services/interop/InteropService_Importer_Md_frontmatter.test.js
 packages/lib/services/interop/InteropService_Importer_Md_frontmatter.js
+packages/lib/services/interop/InteropService_Importer_OneNote.test.js
+packages/lib/services/interop/InteropService_Importer_OneNote.js
 packages/lib/services/interop/InteropService_Importer_Raw.test.js
 packages/lib/services/interop/InteropService_Importer_Raw.js
 packages/lib/services/interop/Module.test.js
@@ -1112,7 +1177,6 @@ packages/lib/services/keychain/KeychainService.test.js
 packages/lib/services/keychain/KeychainService.js
 packages/lib/services/keychain/KeychainServiceDriver.dummy.js
 packages/lib/services/keychain/KeychainServiceDriver.electron.js
-packages/lib/services/keychain/KeychainServiceDriver.mobile.js
 packages/lib/services/keychain/KeychainServiceDriver.node.js
 packages/lib/services/keychain/KeychainServiceDriverBase.js
 packages/lib/services/noteList/defaultLeftToRightListRenderer.js
@@ -1154,6 +1218,7 @@ packages/lib/services/plugins/api/JoplinPlugins.js
 packages/lib/services/plugins/api/JoplinSettings.js
 packages/lib/services/plugins/api/JoplinViews.js
 packages/lib/services/plugins/api/JoplinViewsDialogs.js
+packages/lib/services/plugins/api/JoplinViewsEditor.js
 packages/lib/services/plugins/api/JoplinViewsMenuItems.js
 packages/lib/services/plugins/api/JoplinViewsMenus.js
 packages/lib/services/plugins/api/JoplinViewsNoteList.js
@@ -1172,6 +1237,7 @@ packages/lib/services/plugins/testing/MockPlatformImplementation.js
 packages/lib/services/plugins/testing/MockPluginRunner.js
 packages/lib/services/plugins/utils/createViewHandle.js
 packages/lib/services/plugins/utils/executeSandboxCall.js
+packages/lib/services/plugins/utils/getActivePluginEditorView.js
 packages/lib/services/plugins/utils/getPluginIssueReportUrl.test.js
 packages/lib/services/plugins/utils/getPluginIssueReportUrl.js
 packages/lib/services/plugins/utils/getPluginNamespacedSettingKey.js
@@ -1286,6 +1352,7 @@ packages/lib/services/trash/permanentlyDeleteOldItems.test.js
 packages/lib/services/trash/permanentlyDeleteOldItems.js
 packages/lib/services/trash/restoreItems.test.js
 packages/lib/services/trash/restoreItems.js
+packages/lib/shim-init-node.test.js
 packages/lib/shim-init-node.js
 packages/lib/shim.js
 packages/lib/string-utils.test.js
@@ -1310,6 +1377,7 @@ packages/lib/types.js
 packages/lib/urlUtils.js
 packages/lib/utils/ActionLogger.test.js
 packages/lib/utils/ActionLogger.js
+packages/lib/utils/attachedResources.js
 packages/lib/utils/credentialFiles.js
 packages/lib/utils/dom/makeSandboxedIframe.js
 packages/lib/utils/focusHandler.js
@@ -1329,6 +1397,7 @@ packages/lib/utils/ipc/utils/separateCallbacksFromSerializable.js
 packages/lib/utils/ipc/utils/separateCallbacksFromSerializableArray.js
 packages/lib/utils/joplinCloud/index.js
 packages/lib/utils/joplinCloud/types.js
+packages/lib/utils/markupLanguageUtils.js
 packages/lib/utils/processStartFlags.js
 packages/lib/utils/replaceUnsupportedCharacters.test.js
 packages/lib/utils/replaceUnsupportedCharacters.js
@@ -1464,6 +1533,7 @@ packages/tools/update-readme-download.test.js
 packages/tools/update-readme-download.js
 packages/tools/update-readme-sponsors.js
 packages/tools/updateMarkdownDoc.js
+packages/tools/utils/discourse.test.js
 packages/tools/utils/discourse.js
 packages/tools/utils/loadSponsors.js
 packages/tools/utils/translation.js

Assets/WebsiteAssets/rss.xml

@@ -1,4 +1,9 @@
-<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Joplin]]></title><description><![CDATA[Joplin, the open source note-taking application]]></description><link>https://joplinapp.org</link><generator>RSS for Node</generator><lastBuildDate>Mon, 01 Jul 2024 00:00:00 GMT</lastBuildDate><atom:link href="https://joplinapp.org/rss.xml" rel="self" type="application/rss+xml"/><pubDate>Mon, 01 Jul 2024 00:00:00 GMT</pubDate><item><title><![CDATA[What's new in Joplin 3.0]]></title><description><![CDATA[<h2>Desktop application<a name="desktop-application" href="#desktop-application" class="heading-anchor">🔗</a></h2>
+<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Joplin]]></title><description><![CDATA[Joplin, the open source note-taking application]]></description><link>https://joplinapp.org</link><generator>RSS for Node</generator><lastBuildDate>Thu, 28 Nov 2024 00:00:00 GMT</lastBuildDate><atom:link href="https://joplinapp.org/rss.xml" rel="self" type="application/rss+xml"/><pubDate>Thu, 28 Nov 2024 00:00:00 GMT</pubDate><item><title><![CDATA[Project 1: Making voice typing even better for everyone]]></title><description><![CDATA[<p>Joplin is partnering with a French government institution to bring you innovative new features! We will work on accessibility, voice typing, HTR and add Rocketbook integration. Today we'll present the planned improvements to voice typing:</p>
+<p>Right now, voice input works pretty well, but there’s one thing that still needs improvement: punctuation. Our current system is accurate, but it doesn’t pick up on things like commas or periods, which can make spoken text harder to understand. That’s why we’re looking into other voice recognition engines that can handle punctuation better while keeping the accuracy we need.</p>
+<p>Improving voice input like this isn’t just about convenience – it’s about making our app more accessible to everyone. For people with visual impairments, being able to use voice input means they don’t have to rely on typing. Those with motor difficulties can control the app without needing to use their hands. And for users with dyslexia or other learning challenges, voice input can be much easier and more natural than typing out words.</p>
+<p>We’re excited to experiment with this new feature, knowing it could make a real difference for people who rely on voice technology to get things done.</p>
+<p><img src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/news/20241128-voice-typing.jpg" alt=""></p>
+]]></description><link>https://joplinapp.org/news/20241128-project-1-voice-input</link><guid isPermaLink="false">20241128-project-1-voice-input</guid><pubDate>Thu, 28 Nov 2024 00:00:00 GMT</pubDate><twitter-text></twitter-text></item><item><title><![CDATA[What's new in Joplin 3.0]]></title><description><![CDATA[<h2>Desktop application<a name="desktop-application" href="#desktop-application" class="heading-anchor">🔗</a></h2>
 <h3>Trash folder<a name="trash-folder" href="#trash-folder" class="heading-anchor">🔗</a></h3>
 <p>Joplin now support a trash folder - any deleted notes or notebooks will be moved to that folder. You can also choose to have these notes permanently deleted after a number of days.</p>
 <p><img src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/news/20240701-trash.png" alt=""></p>
@@ -393,48 +398,4 @@ sys 0m38.013s</p>
 <p><img src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/news/20220606-publish-website.png" alt=""></p>
 <h2>And more!<a name="and-more" href="#and-more" class="heading-anchor">🔗</a></h2>
 <p>In total there are 38 changes to improve the app reliability, security and usability. Full changelog is at <a href="https://joplinapp.org/help/about/changelog/desktop">https://joplinapp.org/help/about/changelog/desktop</a></p>
-]]></description><link>https://joplinapp.org/news/20220606-release-2-8</link><guid isPermaLink="false">20220606-release-2-8</guid><pubDate>Mon, 06 Jun 2022 00:00:00 GMT</pubDate><twitter-text></twitter-text></item><item><title><![CDATA[Joplin received 6 Contributor Projects for GSoC 2022!]]></title><description><![CDATA[<p>We are glad to announce that Google allocated us six projects this year for Google Summer of Code! So this is six contributors who will be working on various parts of the apps, both desktop and mobile, over the summer.</p>
-<p>Over the next few weeks, till 13 June, will be the Community Bonding Period during which GSoC contributors get to know mentors, read documentation, and get up to speed to begin working on their projects.</p>
-<p>Here's the full list of projects, contributors and mentors.</p>
-<table class="table">
-<thead>
-<tr>
-<th>Project Title</th>
-<th>Contributor</th>
-<th>Assigned Mentor(s)</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Improve PDF previewer of Joplin</td>
-<td>asrient</td>
-<td>Roman, JackGruber</td>
-</tr>
-<tr>
-<td>Implement default plugins on desktop application</td>
-<td>mak2002</td>
-<td>CalebJohn, Laurent</td>
-</tr>
-<tr>
-<td>Mobile — Easier Editing</td>
-<td>Henry H</td>
-<td>Daeraxa, CalebJohn</td>
-</tr>
-<tr>
-<td>Improve plugin search and discoverability</td>
-<td>Retr0ve</td>
-<td>JackGruber, Stefan</td>
-</tr>
-<tr>
-<td>Tablet Layout Project</td>
-<td>Tolu-Mals</td>
-<td>Laurent, Daeraxa</td>
-</tr>
-<tr>
-<td>Email Plugin</td>
-<td>Bishoy Magdy Adeeb</td>
-<td>Stefan, Roman</td>
-</tr>
-</tbody>
-</table>
-]]></description><link>https://joplinapp.org/news/20220522-gsoc-contributors</link><guid isPermaLink="false">20220522-gsoc-contributors</guid><pubDate>Sun, 22 May 2022 00:00:00 GMT</pubDate><twitter-text>Joplin received 6 Contributor Projects for GSoC 2022! Welcome to our new contributors who will be working on these projects over summer!</twitter-text></item></channel></rss>
+]]></description><link>https://joplinapp.org/news/20220606-release-2-8</link><guid isPermaLink="false">20220606-release-2-8</guid><pubDate>Mon, 06 Jun 2022 00:00:00 GMT</pubDate><twitter-text></twitter-text></item></channel></rss>

Dockerfile.server

@@ -35,6 +35,9 @@ COPY packages/utils ./packages/utils
 COPY packages/lib ./packages/lib
 COPY packages/server ./packages/server
 
+# We don't want to build onenote-converter since it is not used by the server
+RUN sed --in-place '/onenote-converter/d' ./packages/lib/package.json
+
 # For some reason there's both a .yarn/cache and .yarn/berry/cache that are
 # being generated, and both have the same content. Not clear why it does this
 # but we can delete it anyway. We can delete the cache because we use

Joplin_install_and_update.sh

@@ -263,7 +263,8 @@ StartupWMClass=Joplin
 Type=Application
 Categories=Office;
 MimeType=x-scheme-handler/joplin;
-X-GNOME-SingleWindow=true // should be removed eventually as it was upstream to be an XDG specification
+# should be removed eventually as it was upstream to be an XDG specification
+X-GNOME-SingleWindow=true
 SingleMainWindow=true
 EOF
 

README.md

@@ -31,7 +31,7 @@ Please see the [donation page](https://github.com/laurent22/joplin/blob/dev/read
 # Sponsors
 
 <!-- SPONSORS-ORG -->
-<a href="https://seirei.ne.jp"><img title="Serei Network" width="256" src="https://joplinapp.org/images/sponsors/SeireiNetwork.png"/></a> <a href="https://www.hosting.de/nextcloud/?mtm_campaign=managed-nextcloud&amp;mtm_kwd=joplinapp&amp;mtm_source=joplinapp-webseite&amp;mtm_medium=banner"><img title="Hosting.de" width="256" src="https://joplinapp.org/images/sponsors/HostingDe.png"/></a> <a href="https://citricsheep.com"><img title="Citric Sheep" width="256" src="https://joplinapp.org/images/sponsors/CitricSheep.png"/></a> <a href="https://sorted.travel/?utm_source=joplinapp"><img title="Sorted Travel" width="256" src="https://joplinapp.org/images/sponsors/SortedTravel.png"/></a> <a href="https://celebian.com"><img title="Celebian" width="256" src="https://joplinapp.org/images/sponsors/Celebian.png"/></a> <a href="https://bestkru.com"><img title="BestKru" width="256" src="https://joplinapp.org/images/sponsors/BestKru.png"/></a> <a href="https://www.socialfollowers.uk/buy-tiktok-followers/"><img title="Social Followers" width="256" src="https://joplinapp.org/images/sponsors/SocialFollowers.png"/></a> <a href="https://stormlikes.com/"><img title="Stormlikes" width="256" src="https://joplinapp.org/images/sponsors/Stormlikes.png"/></a> <a href="https://route4me.com"><img title="Route4Me" width="256" src="https://joplinapp.org/images/sponsors/Route4Me.png"/></a> <a href="https://buyyoutubviews.com"><img title="BYTV" width="256" src="https://joplinapp.org/images/sponsors/BYTV.png"/></a> <a href="https://www.famegear.com"><img title="Famegear" width="256" src="https://joplinapp.org/images/sponsors/Famegear.png"/></a> <a href="https://casinoreviews.net"><img title="Casino Reviews" width="256" src="https://joplinapp.org/images/sponsors/CasinoReviews.png"/></a>
+<a href="https://seirei.ne.jp"><img title="Serei Network" width="256" src="https://joplinapp.org/images/sponsors/SeireiNetwork.png"/></a> <a href="https://www.hosting.de/nextcloud/?mtm_campaign=managed-nextcloud&amp;mtm_kwd=joplinapp&amp;mtm_source=joplinapp-webseite&amp;mtm_medium=banner"><img title="Hosting.de" width="256" src="https://joplinapp.org/images/sponsors/HostingDe.png"/></a> <a href="https://citricsheep.com"><img title="Citric Sheep" width="256" src="https://joplinapp.org/images/sponsors/CitricSheep.png"/></a> <a href="https://sorted.travel/?utm_source=joplinapp"><img title="Sorted Travel" width="256" src="https://joplinapp.org/images/sponsors/SortedTravel.png"/></a> <a href="https://celebian.com"><img title="Celebian" width="256" src="https://joplinapp.org/images/sponsors/Celebian.png"/></a> <a href="https://bestkru.com"><img title="BestKru" width="256" src="https://joplinapp.org/images/sponsors/BestKru.png"/></a> <a href="https://www.socialfollowers.uk/buy-tiktok-followers/"><img title="Social Followers" width="256" src="https://joplinapp.org/images/sponsors/SocialFollowers.png"/></a> <a href="https://stormlikes.com/"><img title="Stormlikes" width="256" src="https://joplinapp.org/images/sponsors/Stormlikes.png"/></a> <a href="https://route4me.com"><img title="Route4Me" width="256" src="https://joplinapp.org/images/sponsors/Route4Me.png"/></a> <a href="https://buyyoutubviews.com"><img title="BYTV" width="256" src="https://joplinapp.org/images/sponsors/BYTV.png"/></a> <a href="https://casinoreviews.net"><img title="Casino Reviews" width="256" src="https://joplinapp.org/images/sponsors/CasinoReviews.png"/></a> <a href="https://useviral.com.br/"><img title="Comprar seguidores Instagram" width="256" src="https://joplinapp.org/images/sponsors/Useviral.png"/></a>
 <!-- SPONSORS-ORG -->
 
 * * *
@@ -40,11 +40,9 @@ Please see the [donation page](https://github.com/laurent22/joplin/blob/dev/read
 |       |       |       |       |
 | :---: | :---: | :---: | :---: |
 | <img width="50" src="https://avatars2.githubusercontent.com/u/97193607?s=96&v=4"/></br>[Akhil-CM](https://github.com/Akhil-CM) | <img width="50" src="https://avatars2.githubusercontent.com/u/552452?s=96&v=4"/></br>[andypiper](https://github.com/andypiper) | <img width="50" src="https://avatars2.githubusercontent.com/u/215668?s=96&v=4"/></br>[avanderberg](https://github.com/avanderberg) | <img width="50" src="https://avatars2.githubusercontent.com/u/67130?s=96&v=4"/></br>[chr15m](https://github.com/chr15m) |
-| <img width="50" src="https://avatars2.githubusercontent.com/u/2793530?s=96&v=4"/></br>[CyberXZT](https://github.com/CyberXZT) | <img width="50" src="https://avatars2.githubusercontent.com/u/1307332?s=96&v=4"/></br>[dbrandonjohnson](https://github.com/dbrandonjohnson) | <img width="50" src="https://avatars2.githubusercontent.com/u/14873877?s=96&v=4"/></br>[dchecks](https://github.com/dchecks) | <img width="50" src="https://avatars2.githubusercontent.com/u/56287?s=96&v=4"/></br>[fats](https://github.com/fats) |
-| <img width="50" src="https://avatars2.githubusercontent.com/u/8030470?s=96&v=4"/></br>[Galliver7](https://github.com/Galliver7) | <img width="50" src="https://avatars2.githubusercontent.com/u/64712218?s=96&v=4"/></br>[Hegghammer](https://github.com/Hegghammer) | <img width="50" src="https://avatars2.githubusercontent.com/u/2583421?s=96&v=4"/></br>[jamesandariese](https://github.com/jamesandariese) | <img width="50" src="https://avatars2.githubusercontent.com/u/1310474?s=96&v=4"/></br>[jknowles](https://github.com/jknowles) |
-| <img width="50" src="https://avatars2.githubusercontent.com/u/11947658?s=96&v=4"/></br>[KentBrockman](https://github.com/KentBrockman) | <img width="50" src="https://avatars2.githubusercontent.com/u/24908652?s=96&v=4"/></br>[konishi-t](https://github.com/konishi-t) | <img width="50" src="https://avatars2.githubusercontent.com/u/42319182?s=96&v=4"/></br>[marcdw1289](https://github.com/marcdw1289) | <img width="50" src="https://avatars2.githubusercontent.com/u/126279083?s=96&v=4"/></br>[matmoly](https://github.com/matmoly) |
-| <img width="50" src="https://avatars2.githubusercontent.com/u/1788010?s=96&v=4"/></br>[maxtruxa](https://github.com/maxtruxa) | <img width="50" src="https://avatars2.githubusercontent.com/u/4560672?s=96&v=4"/></br>[mu88](https://github.com/mu88) | <img width="50" src="https://avatars2.githubusercontent.com/u/31054972?s=96&v=4"/></br>[saarantras](https://github.com/saarantras) | <img width="50" src="https://avatars2.githubusercontent.com/u/327998?s=96&v=4"/></br>[sif](https://github.com/sif) |
-| <img width="50" src="https://avatars2.githubusercontent.com/u/765564?s=96&v=4"/></br>[taskcruncher](https://github.com/taskcruncher) | <img width="50" src="https://avatars2.githubusercontent.com/u/333944?s=96&v=4"/></br>[tateisu](https://github.com/tateisu) |       |       |
+| <img width="50" src="https://avatars2.githubusercontent.com/u/8030470?s=96&v=4"/></br>[Galliver7](https://github.com/Galliver7) | <img width="50" src="https://avatars2.githubusercontent.com/u/64712218?s=96&v=4"/></br>[Hegghammer](https://github.com/Hegghammer) | <img width="50" src="https://avatars2.githubusercontent.com/u/11947658?s=96&v=4"/></br>[KentBrockman](https://github.com/KentBrockman) | <img width="50" src="https://avatars2.githubusercontent.com/u/42319182?s=96&v=4"/></br>[marcdw1289](https://github.com/marcdw1289) |
+| <img width="50" src="https://avatars2.githubusercontent.com/u/126279083?s=96&v=4"/></br>[matmoly](https://github.com/matmoly) | <img width="50" src="https://avatars2.githubusercontent.com/u/1788010?s=96&v=4"/></br>[maxtruxa](https://github.com/maxtruxa) | <img width="50" src="https://avatars2.githubusercontent.com/u/327998?s=96&v=4"/></br>[sif](https://github.com/sif) | <img width="50" src="https://avatars2.githubusercontent.com/u/765564?s=96&v=4"/></br>[taskcruncher](https://github.com/taskcruncher) |
+|       |       |       |       |
 <!-- SPONSORS-GITHUB -->
 	
 # Community

devbox.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://raw.githubusercontent.com/jetify-com/devbox/0.13.4/.schema/devbox.schema.json",
+  "packages": {
+    "cocoapods": {
+      "version":   "latest",
+      "platforms": ["aarch64-darwin", "x86_64-darwin"],
+    },
+    "yarn": "latest",
+    "vips.dev": {
+      "platforms": ["aarch64-darwin"],
+    },
+    "nodejs":     "latest",
+    "pkg-config": "latest",
+    "pixman":     "latest",
+    "cairo.dev":  "",
+    "pango.dev":  "",
+    "darwin.apple_sdk.frameworks.Foundation": { // satisfies missing CoreText/CoreText.h
+      // https://github.com/NixOS/nixpkgs/blob/master/pkgs/os-specific/darwin/apple-sdk/default.nix
+      "version":   "",
+      "platforms": ["aarch64-darwin", "x86_64-darwin"],
+    },
+    "python": "latest",
+    "bat":    "latest",
+    "electron": {
+      "version":            "latest",
+      "excluded_platforms": ["aarch64-darwin", "x86_64-darwin"],
+    },
+    "git": "latest",
+  },
+  "shell": {
+    "init_hook": [
+      "export COLOR_BLACK='\\e[0;30m' COLOR_GRAY='\\e[1;30m' COLOR_RED='\\e[0;31m' COLOR_LIGHT_RED='\\e[1;31m' COLOR_GREEN='\\e[0;32m' COLOR_LIGHT_GREEN='\\e[1;32m' COLOR_BROWN='\\e[0;33m' COLOR_YELLOW='\\e[1;33m' COLOR_BLUE='\\e[0;34m' COLOR_LIGHT_BLUE='\\e[1;34m' COLOR_PURPLE='\\e[0;35m' COLOR_LIGHT_PURPLE='\\e[1;35m' COLOR_CYAN='\\e[0;36m'; export COLOR_LIGHT_CYAN='\\e[1;36m'; export COLOR_LIGHT_GRAY='\\e[0;37m'; export COLOR_WHITE='\\e[1;37m'",
+      ". $VENV_DIR/bin/activate",
+      "pip -q install -U pip setuptools wheel", // Newer Pythons are missing distutils
+      "echo -e \"${COLOR_LIGHT_PURPLE}Build ${COLOR_LIGHT_BLUE}Joplin${COLOR_LIGHT_PURPLE}: ${COLOR_LIGHT_GREEN}yarn install ${COLOR_GRAY}\"",
+      "echo -e \"${COLOR_LIGHT_PURPLE}Run ${COLOR_LIGHT_BLUE}Joplin Desktop${COLOR_LIGHT_PURPLE}: ${COLOR_LIGHT_GREEN}cd packages/app-desktop && ${COLOR_YELLOW}$(grep -q '^ID=nixos$' /etc/os-release 2>/dev/null && echo 'ELECTRON_OVERRIDE_DIST_PATH=$(dirname $(which electron)) ')${COLOR_LIGHT_GREEN}yarn start ${COLOR_GRAY}\"",
+      "echo -e \"${COLOR_LIGHT_PURPLE}Run ${COLOR_LIGHT_BLUE}Joplin CLI${COLOR_LIGHT_PURPLE}: ${COLOR_LIGHT_GREEN}cd packages/app-cli && yarn start ${COLOR_GRAY}\"",
+      "echo -e \"${COLOR_LIGHT_PURPLE}Read ${COLOR_LIGHT_BLUE}Full Build Instructions${COLOR_LIGHT_PURPLE}: ${COLOR_LIGHT_GREEN}bat readme/dev/BUILD.md ${COLOR_GRAY}\"",
+    ],
+  },
+}

fastlane/metadata/android/hu/full_description.txt

@@ -0,0 +1,13 @@
+A <strong>Joplin</strong> egy ingyenes, nyílt forráskódú jegyzetkészítő és teendők készítésére szolgáló alkalmazás, amely számos jegyzetfüzetbe rendezett jegyzet kezelésére képes. A jegyzetek kereshetők, másolhatók, címkézhetők és módosíthatók akár közvetlenül az alkalmazásokból, akár saját szövegszerkesztőből.
+
+A jegyzetek <a href="https://joplinapp.org/help/apps/markdown">Markdown formátumban</a> vannak.
+
+Az Evernote-ból exportált jegyzetek <a href="https://joplinapp.org/help/apps/import_export">importálhatók</a> a Joplinba, beleértve a formázott tartalmat (amelyet Markdown-ba konvertálunk), az erőforrásokat (képeket, mellékletek stb.) és teljes metaadatok (földrajzi hely, frissített idő, létrehozási idő stb.). Sima Markdown fájlok is importálhatók.
+
+A Joplin „offline elszobb”, ami azt jelenti, hogy mindig minden adata a telefonján vagy a számítógépén van. Ez biztosítja, hogy jegyzetei mindig elérhetőek legyenek, akár van internetkapcsolata, akár nem.</p>
+
+A jegyzetek biztonságosan <a href="https://joplinapp.org/help/apps/sync">összehangolhatók</a> a <a href="https://joplinapp.org/help/apps/sync/e2ee">végpontok közötti titkosítás</a> segítségével különféle felhőszolgáltatásokkal, köztük a Nextcloud, a Dropbox, a OneDrive és a <a href="https://joplinapp.org/plans/">Joplin Cloud</a> segítségével.
+
+A teljes szöveges keresés minden platformon elérhető, hogy gyorsan megtalálja a szükséges információkat. Az alkalmazás beépülő modulok és témák segítségével testreszabható, és könnyedén létrehozhatja sajátját is.
+
+Az alkalmazás elérhető Android, iOS, Linux, macOS és Windows rendszeren. Egy <a href="https://joplinapp.org/help/apps/clipper">Web Clipper</a>, amely weboldalakat és képernyőképeket menthet a böngészőből, szintén elérhető a <a href="https://addons.mozilla.org/firefox/addon/joplin-web-clipper/">Firefox</a> és <a href="https://chrome.google.com/webstore/detail/joplin-web-clipper/alofnhikmmkdbbbgpnglcpdollgjjfek">Chrome</a>.

fastlane/metadata/android/hu/short_description.txt

@@ -0,0 +1 @@
+Jegyzetkészítő és teendők alkalmazás Linux, macOS, Windows és mobileszközök közötti összehangolással

joplin.code-workspace

@@ -5,6 +5,9 @@
 		},
 	],
 	"settings": {
+		"rust-analyzer.linkedProjects": [
+			"./packages/onenote-converter/Cargo.toml",
+		],
 		"files.exclude": {
 			"_mydocs/mdtest/": true,
 			"_releases/": true,

package.json

@@ -9,7 +9,8 @@
     "url": "git+https://github.com/laurent22/joplin.git"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=18",
+    "yarn": "3.8.3"
   },
   "scripts": {
     "buildApiDoc": "yarn workspace joplin start apidoc ../../readme/api/references/rest_api.md",
@@ -87,8 +88,8 @@
     "gulp": "4.0.2",
     "husky": "3.1.0",
     "lerna": "3.22.1",
-    "lint-staged": "15.2.7",
-    "madge": "6.1.0",
+    "lint-staged": "15.2.8",
+    "madge": "7.0.0",
     "npm-package-json-lint": "7.1.0",
     "typescript": "5.4.5"
   },

packages/app-cli/app/command-e2ee.ts

@@ -8,8 +8,7 @@ import shim from '@joplin/lib/shim';
 import * as pathUtils from '@joplin/lib/path-utils';
 import { getEncryptionEnabled, localSyncInfo } from '@joplin/lib/services/synchronizer/syncInfoUtils';
 import { generateMasterKeyAndEnableEncryption, loadMasterKeysFromSettings, masterPasswordIsValid, setupAndDisableEncryption } from '@joplin/lib/services/e2ee/utils';
-const imageType = require('image-type');
-const readChunk = require('read-chunk');
+import { fromFile as fileTypeFromFile } from 'file-type';
 
 class Command extends BaseCommand {
 	public usage() {
@@ -136,8 +135,7 @@ class Command extends BaseCommand {
 					const outputDir = options.output ? options.output : require('os').tmpdir();
 					let outFile = `${outputDir}/${pathUtils.filename(args.path)}.${Date.now()}.bin`;
 					await EncryptionService.instance().decryptFile(args.path, outFile);
-					const buffer = await readChunk(outFile, 0, 64);
-					const detectedType = imageType(buffer);
+					const detectedType = await fileTypeFromFile(outFile);
 
 					if (detectedType) {
 						const newOutFile = `${outFile}.${detectedType.ext}`;

packages/app-cli/package.json

@@ -35,27 +35,26 @@
     ],
     "owner": "Laurent Cozic"
   },
-  "version": "3.1.0",
+  "version": "3.2.0",
   "bin": "./main.js",
   "engines": {
     "node": ">=10.0.0"
   },
   "dependencies": {
-    "@joplin/lib": "~3.1",
-    "@joplin/renderer": "~3.1",
-    "@joplin/utils": "~3.1",
+    "@joplin/lib": "~3.2",
+    "@joplin/renderer": "~3.2",
+    "@joplin/utils": "~3.2",
     "aws-sdk": "2.1340.0",
     "chalk": "4.1.2",
     "compare-version": "0.1.2",
+    "file-type": "16.5.4",
     "fs-extra": "11.2.0",
     "html-entities": "1.4.0",
-    "image-type": "3.1.0",
     "keytar": "7.9.0",
     "md5": "2.3.0",
     "node-rsa": "1.1.1",
     "open": "8.4.2",
     "proper-lockfile": "4.1.2",
-    "read-chunk": "2.1.0",
     "server-destroy": "1.0.1",
     "sharp": "0.33.4",
     "sprintf-js": "1.1.3",
@@ -70,10 +69,10 @@
     "yargs-parser": "21.1.1"
   },
   "devDependencies": {
-    "@joplin/tools": "~3.1",
+    "@joplin/tools": "~3.2",
     "@types/fs-extra": "11.0.4",
     "@types/jest": "29.5.12",
-    "@types/node": "18.19.39",
+    "@types/node": "18.19.48",
     "@types/proper-lockfile": "^4.1.2",
     "gulp": "4.0.2",
     "jest": "29.7.0",

packages/app-cli/tests/support/onenote/svg_with_text_and_style.html

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+<body>
+
+<div class="container-outline" style="left: 48px;position: absolute;top: 107px;width: 624px;">
+    <svg viewBox="0 0 240 80" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    .small {
+      font: italic 13px sans-serif;
+    }
+    .heavy {
+      font: bold 30px sans-serif;
+    }
+    /* Note that the color of the text is set with the    *
+     * fill property, the color property is for HTML only */
+    .Rrrrr {
+      font: italic 40px serif;
+      fill: red;
+    }
+  </style>
+  <text x="20" y="35" class="small">My</text>
+  <text x="40" y="35" class="heavy">cat</text>
+  <text x="55" y="55" class="small">is</text>
+  <text x="65" y="55" class="Rrrrr">Grumpy!</text>
+</svg>
+</div>
+</body>
+</html>

packages/app-cli/tests/support/plugins/clipboard/api/Joplin.d.ts

@@ -68,6 +68,8 @@ export default class Joplin {
      * - [fs-extra](https://www.npmjs.com/package/fs-extra)
      *
      * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/nativeModule)
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     require(_path: string): any;
     versionInfo(): Promise<import("./types").VersionInfo>;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinClipboard.d.ts

@@ -4,14 +4,20 @@ export default class JoplinClipboard {
     constructor(electronClipboard: any, electronNativeImage: any);
     readText(): Promise<string>;
     writeText(text: string): Promise<void>;
+    /** <span class="platform-desktop">desktop</span> */
     readHtml(): Promise<string>;
+    /** <span class="platform-desktop">desktop</span> */
     writeHtml(html: string): Promise<void>;
     /**
      * Returns the image in [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) format.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     readImage(): Promise<string>;
     /**
      * Takes an image in [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) format.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     writeImage(dataUrl: string): Promise<void>;
     /**

packages/app-cli/tests/support/plugins/clipboard/api/JoplinCommands.d.ts

@@ -1,4 +1,5 @@
 import { Command } from './types';
+import Plugin from '../Plugin';
 /**
  * This class allows executing or registering new Joplin commands. Commands
  * can be executed or associated with
@@ -20,6 +21,12 @@ import { Command } from './types';
  * To view what arguments are supported, you can open any of these files
  * and look at the `execute()` command.
  *
+ * Note that many of these commands only work on desktop. The more limited list of mobile
+ * commands can be found in these places:
+ *
+ * * [Global commands](https://github.com/laurent22/joplin/tree/dev/packages/app-mobile/commands)
+ * * [Editor commands](https://github.com/laurent22/joplin/blob/dev/packages/app-mobile/components/NoteEditor/commandDeclarations.ts)
+ *
  * ## Executing editor commands
  *
  * There might be a situation where you want to invoke editor commands
@@ -49,9 +56,10 @@ import { Command } from './types';
  *
  */
 export default class JoplinCommands {
+    private plugin_;
+    constructor(plugin_: Plugin);
     /**
-     * <span class="platform-desktop">desktop</span> Executes the given
-     * command.
+     * Executes the given command.
      *
      * The command can take any number of arguments, and the supported
      * arguments will vary based on the command. For custom commands, this
@@ -70,7 +78,7 @@ export default class JoplinCommands {
      */
     execute(commandName: string, ...args: any[]): Promise<any | void>;
     /**
-     * <span class="platform-desktop">desktop</span> Registers a new command.
+     * Registers a new command.
      *
      * ```typescript
      * // Register a new commmand called "testCommand1"

packages/app-cli/tests/support/plugins/clipboard/api/JoplinContentScripts.d.ts

@@ -21,7 +21,8 @@ export default class JoplinContentScripts {
      * for more information.
      *
      * * [View the renderer demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/content_script)
-     * * [View the editor demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
+     * * [View the editor plugin tutorial](https://joplinapp.org/help/api/tutorials/cm6_plugin)
+     * * [View the legacy editor demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
      *
      * See also the [postMessage demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/post_messages)
      *

packages/app-cli/tests/support/plugins/clipboard/api/JoplinData.d.ts

@@ -2,7 +2,7 @@ import { ModelType } from '../../../BaseModel';
 import Plugin from '../Plugin';
 import { Path } from './types';
 /**
- * This module provides access to the Joplin data API: https://joplinapp.org/api/references/rest_api/
+ * This module provides access to the Joplin data API: https://joplinapp.org/help/api/references/rest_api
  * This is the main way to retrieve data, such as notes, notebooks, tags, etc.
  * or to update them or delete them.
  *
@@ -13,12 +13,12 @@ import { Path } from './types';
  * In general you would use the methods in this class as if you were using a REST API. There are four methods that map to GET, POST, PUT and DELETE calls.
  * And each method takes these parameters:
  *
- * * `path`: This is an array that represents the path to the resource in the form `["resouceName", "resourceId", "resourceLink"]` (eg. ["tags", ":id", "notes"]). The "resources" segment is the name of the resources you want to access (eg. "notes", "folders", etc.). If not followed by anything, it will refer to all the resources in that collection. The optional "resourceId" points to a particular resources within the collection. Finally, an optional "link" can be present, which links the resource to a collection of resources. This can be used in the API for example to retrieve all the notes associated with a tag.
+ * * `path`: This is an array that represents the path to the resource in the form `["resourceName", "resourceId", "resourceLink"]` (eg. ["tags", ":id", "notes"]). The "resources" segment is the name of the resources you want to access (eg. "notes", "folders", etc.). If not followed by anything, it will refer to all the resources in that collection. The optional "resourceId" points to a particular resources within the collection. Finally, an optional "link" can be present, which links the resource to a collection of resources. This can be used in the API for example to retrieve all the notes associated with a tag.
  * * `query`: (Optional) The query parameters. In a URL, this is the part after the question mark "?". In this case, it should be an object with key/value pairs.
  * * `data`: (Optional) Applies to PUT and POST calls only. The request body contains the data you want to create or modify, for example the content of a note or folder.
  * * `files`: (Optional) Used to create new resources and associate them with files.
  *
- * Please refer to the [Joplin API documentation](https://joplinapp.org/api/references/rest_api/) for complete details about each call. As the plugin runs within the Joplin application **you do not need an authorisation token** to use this API.
+ * Please refer to the [Joplin API documentation](https://joplinapp.org/help/api/references/rest_api) for complete details about each call. As the plugin runs within the Joplin application **you do not need an authorisation token** to use this API.
  *
  * For example:
  *

packages/app-cli/tests/support/plugins/clipboard/api/JoplinFilters.d.ts

@@ -1,3 +1,4 @@
+import { FilterHandler } from '../../../eventManager';
 /**
  * @ignore
  *
@@ -5,6 +6,6 @@
  * so for now disable filters.
  */
 export default class JoplinFilters {
-    on(name: string, callback: Function): Promise<void>;
-    off(name: string, callback: Function): Promise<void>;
+    on(name: string, callback: FilterHandler): Promise<void>;
+    off(name: string, callback: FilterHandler): Promise<void>;
 }

packages/app-cli/tests/support/plugins/clipboard/api/JoplinImaging.d.ts

@@ -1,12 +1,33 @@
 import { Rectangle } from './types';
-export interface Implementation {
-    nativeImage: any;
-}
 export interface CreateFromBufferOptions {
     width?: number;
     height?: number;
     scaleFactor?: number;
 }
+export interface CreateFromPdfOptions {
+    /**
+     * The first page to export. Defaults to `1`, the first page in
+     * the document.
+     */
+    minPage?: number;
+    /**
+     * The number of the last page to convert. Defaults to the last page
+     * if not given.
+     *
+     * If `maxPage` is greater than the number of pages in the PDF, all pages
+     * in the PDF will be converted to images.
+     */
+    maxPage?: number;
+    scaleFactor?: number;
+}
+export interface PdfInfo {
+    pageCount: number;
+}
+export interface Implementation {
+    createFromPath: (path: string) => Promise<unknown>;
+    createFromPdf: (path: string, options: CreateFromPdfOptions) => Promise<unknown[]>;
+    getPdfInfo: (path: string) => Promise<PdfInfo>;
+}
 export interface ResizeOptions {
     width?: number;
     height?: number;
@@ -24,6 +45,7 @@ export type Handle = string;
  * [View the
  * example](https://github.com/laurent22/joplin/blob/dev/packages/app-cli/tests/support/plugins/imaging/src/index.ts)
  *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinImaging {
     private implementation_;
@@ -32,11 +54,20 @@ export default class JoplinImaging {
     private createImageHandle;
     private imageByHandle;
     private cacheImage;
+    /**
+     * Creates an image from the provided path. Note that images and PDFs are supported. If you
+     * provide a URL instead of a local path, the file will be downloaded first then converted to an
+     * image.
+     */
     createFromPath(filePath: string): Promise<Handle>;
     createFromResource(resourceId: string): Promise<Handle>;
+    createFromPdfPath(path: string, options?: CreateFromPdfOptions): Promise<Handle[]>;
+    createFromPdfResource(resourceId: string, options?: CreateFromPdfOptions): Promise<Handle[]>;
+    getPdfInfoFromPath(path: string): Promise<PdfInfo>;
+    getPdfInfoFromResource(resourceId: string): Promise<PdfInfo>;
     getSize(handle: Handle): Promise<any>;
     resize(handle: Handle, options?: ResizeOptions): Promise<string>;
-    crop(handle: Handle, rectange: Rectangle): Promise<string>;
+    crop(handle: Handle, rectangle: Rectangle): Promise<string>;
     toPngFile(handle: Handle, filePath: string): Promise<void>;
     /**
      * Quality is between 0 and 100
@@ -57,5 +88,5 @@ export default class JoplinImaging {
      * Image data is not automatically deleted by Joplin so make sure you call
      * this method on the handle once you are done.
      */
-    free(handle: Handle): Promise<void>;
+    free(handles: Handle[] | Handle): Promise<void>;
 }

packages/app-cli/tests/support/plugins/clipboard/api/JoplinInterop.d.ts

@@ -9,7 +9,10 @@ import { ExportModule, ImportModule } from './types';
  *
  * See the documentation of the [[ExportModule]] and [[ImportModule]] for more information.
  *
- * You may also want to refer to the Joplin API documentation to see the list of properties for each item (note, notebook, etc.) - https://joplinapp.org/api/references/rest_api/
+ * You may also want to refer to the Joplin API documentation to see the list of properties for each item (note, notebook, etc.) - https://joplinapp.org/help/api/references/rest_api
+ *
+ * <span class="platform-desktop">desktop</span>: While it is possible to register import and export
+ * modules on mobile, there is no GUI to activate them.
  */
 export default class JoplinInterop {
     registerExportModule(module: ExportModule): Promise<void>;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinSettings.d.ts

@@ -19,8 +19,6 @@ export type ChangeHandler = (event: ChangeEvent) => void;
 export default class JoplinSettings {
     private plugin_;
     constructor(plugin: Plugin);
-    private get keyPrefix();
-    private namespacedKey;
     /**
      * Registers new settings.
      * Note that registering a setting item is dynamic and will be gone next time Joplin starts.
@@ -40,6 +38,12 @@ export default class JoplinSettings {
      */
     registerSection(name: string, section: SettingSection): Promise<void>;
     /**
+     * Gets setting values (only applies to setting you registered from your plugin)
+     */
+    values(keys: string[] | string): Promise<Record<string, unknown>>;
+    /**
+     * @deprecated Use joplin.settings.values()
+     *
      * Gets a setting value (only applies to setting you registered from your plugin)
      */
     value(key: string): Promise<any>;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViews.d.ts

@@ -5,6 +5,7 @@ import JoplinViewsMenus from './JoplinViewsMenus';
 import JoplinViewsToolbarButtons from './JoplinViewsToolbarButtons';
 import JoplinViewsPanels from './JoplinViewsPanels';
 import JoplinViewsNoteList from './JoplinViewsNoteList';
+import JoplinViewsEditors from './JoplinViewsEditor';
 /**
  * This namespace provides access to view-related services.
  *
@@ -19,11 +20,13 @@ export default class JoplinViews {
     private menus_;
     private toolbarButtons_;
     private dialogs_;
+    private editors_;
     private noteList_;
     private implementation_;
     constructor(implementation: any, plugin: Plugin, store: any);
     get dialogs(): JoplinViewsDialogs;
     get panels(): JoplinViewsPanels;
+    get editors(): JoplinViewsEditors;
     get menuItems(): JoplinViewsMenuItems;
     get menus(): JoplinViewsMenus;
     get toolbarButtons(): JoplinViewsToolbarButtons;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViewsDialogs.d.ts

@@ -43,6 +43,14 @@ export default class JoplinViewsDialogs {
      * Displays a message box with OK/Cancel buttons. Returns the button index that was clicked - "0" for OK and "1" for "Cancel"
      */
     showMessageBox(message: string): Promise<number>;
+    /**
+     * Displays a dialog to select a file or a directory. Same options and
+     * output as
+     * https://www.electronjs.org/docs/latest/api/dialog#dialogshowopendialogbrowserwindow-options
+     *
+     * <span class="platform-desktop">desktop</span>
+     */
+    showOpenDialog(options: any): Promise<any>;
     /**
      * Sets the dialog HTML content
      */
@@ -56,7 +64,9 @@ export default class JoplinViewsDialogs {
      */
     setButtons(handle: ViewHandle, buttons: ButtonSpec[]): Promise<ButtonSpec[]>;
     /**
-     * Opens the dialog
+     * Opens the dialog.
+     *
+     * On desktop, this closes any copies of the dialog open in different windows.
      */
     open(handle: ViewHandle): Promise<DialogResult>;
     /**

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViewsEditor.d.ts

@@ -0,0 +1,88 @@
+import Plugin from '../Plugin';
+import { ActivationCheckCallback, ViewHandle, UpdateCallback } from './types';
+/**
+ * Allows creating alternative note editors. You can create a view to handle loading and saving the
+ * note, and do your own rendering.
+ *
+ * Although it may be used to implement an alternative text editor, the more common use case may be
+ * to render the note in a different, graphical way - for example displaying a graph, and
+ * saving/loading the graph data in the associated note. In that case, you would detect whether the
+ * current note contains graph data and, in this case, you'd display your viewer.
+ *
+ * Terminology: An editor is **active** when it can be used to edit the current note. Note that it
+ * doesn't necessarily mean that your editor is visible - it just means that the user has the option
+ * to switch to it (via the "toggle editor" button). A **visible** editor is active and is currently
+ * being displayed.
+ *
+ * To implement an editor you need to listen to two events:
+ *
+ * - `onActivationCheck`: This is a way for the app to know whether your editor should be active or
+ *   not. Return `true` from this handler to activate your editor.
+ *
+ * - `onUpdate`: When this is called you should update your editor based on the current note
+ *   content. Call `joplin.workspace.selectedNote()` to get the current note.
+ *
+ * - `showEditorPlugin` and `toggleEditorPlugin` commands. Additionally you can use these commands
+ *   to display your editor via `joplin.commands.execute('showEditorPlugin')`. This is not always
+ *   necessary since the user can switch to your editor using the "toggle editor" button, however
+ *   you may want to programmatically display the editor in some cases - for example when creating a
+ *   new note specific to your editor.
+ *
+ * Note that only one editor view can be active at a time. This is why it is important not to
+ * activate your view if it's not relevant to the current note. If more than one is active, it is
+ * undefined which editor is going to be used to display the note.
+ *
+ * For an example of editor plugin, see the [YesYouKan
+ * plugin](https://github.com/joplin/plugin-yesyoukan/blob/master/src/index.ts). In particular,
+ * check the logic around `onActivationCheck` and `onUpdate` since this is the entry points for
+ * using this API.
+ */
+export default class JoplinViewsEditors {
+    private store;
+    private plugin;
+    private activationCheckHandlers_;
+    constructor(plugin: Plugin, store: any);
+    private controller;
+    /**
+     * Creates a new editor view
+     */
+    create(id: string): Promise<ViewHandle>;
+    /**
+     * Sets the editor HTML content
+     */
+    setHtml(handle: ViewHandle, html: string): Promise<string>;
+    /**
+     * Adds and loads a new JS or CSS file into the panel.
+     */
+    addScript(handle: ViewHandle, scriptPath: string): Promise<void>;
+    /**
+     * See [[JoplinViewPanels]]
+     */
+    onMessage(handle: ViewHandle, callback: Function): Promise<void>;
+    /**
+     * Emitted when the editor can potentially be activated - this for example when the current note
+     * is changed, or when the application is opened. At that point should can check the current
+     * note and decide whether your editor should be activated or not. If it should return `true`,
+     * otherwise return `false`.
+     */
+    onActivationCheck(handle: ViewHandle, callback: ActivationCheckCallback): Promise<void>;
+    /**
+     * Emitted when the editor content should be updated. This for example when the currently
+     * selected note changes, or when the user makes the editor visible.
+     */
+    onUpdate(handle: ViewHandle, callback: UpdateCallback): Promise<void>;
+    /**
+     * See [[JoplinViewPanels]]
+     */
+    postMessage(handle: ViewHandle, message: any): void;
+    /**
+     * Tells whether the editor is active or not.
+     */
+    isActive(handle: ViewHandle): Promise<boolean>;
+    /**
+     * Tells whether the editor is effectively visible or not. If the editor is inactive, this will
+     * return `false`. If the editor is active and the user has switched to it, it will return
+     * `true`. Otherwise it will return `false`.
+     */
+    isVisible(handle: ViewHandle): Promise<boolean>;
+}

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViewsMenuItems.d.ts

@@ -4,6 +4,8 @@ import Plugin from '../Plugin';
  * Allows creating and managing menu items.
  *
  * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/register_command)
+ *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinViewsMenuItems {
     private store;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViewsMenus.d.ts

@@ -4,6 +4,8 @@ import Plugin from '../Plugin';
  * Allows creating menus.
  *
  * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/menu)
+ *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinViewsMenus {
     private store;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViewsNoteList.d.ts

@@ -1,6 +1,39 @@
 import { Store } from 'redux';
 import Plugin from '../Plugin';
 import { ListRenderer } from './noteListType';
+/**
+ * This API allows you to customise how each note in the note list is rendered.
+ * The renderer you implement follows a unidirectional data flow.
+ *
+ * The app provides the required dependencies whenever a note is updated - you
+ * process these dependencies, and return some props, which are then passed to
+ * your template and rendered. See [[ListRenderer]] for a detailed description
+ * of each property of the renderer.
+ *
+ * ## Reference
+ *
+ * * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/note_list_renderer)
+ *
+ * * [Default simple renderer](https://github.com/laurent22/joplin/tree/dev/packages/lib/services/noteList/defaultListRenderer.ts)
+ *
+ * * [Default detailed renderer](https://github.com/laurent22/joplin/tree/dev/packages/lib/services/noteList/defaultMultiColumnsRenderer.ts)
+ *
+ * ## Screenshots:
+ *
+ * ### Top to bottom with title, date and body
+ *
+ * <img width="250px" src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/note_list/TopToBottom.png"/>
+ *
+ * ### Left to right with thumbnails
+ *
+ * <img width="250px" src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/note_list/LeftToRight_Thumbnails.png"/>
+ *
+ * ### Top to bottom with editable title
+ *
+ * <img width="250px" src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/note_list/TopToBottom_Editable.png"/>
+ *
+ * <span class="platform-desktop">desktop</span>
+ */
 export default class JoplinViewsNoteList {
     private plugin_;
     private store_;

packages/app-cli/tests/support/plugins/clipboard/api/JoplinViewsPanels.d.ts

@@ -1,12 +1,17 @@
 import Plugin from '../Plugin';
 import { ViewHandle } from './types';
 /**
- * Allows creating and managing view panels. View panels currently are
- * displayed at the right of the sidebar and allows displaying any HTML
- * content (within a webview) and update it in real-time. For example it
+ * Allows creating and managing view panels. View panels allow displaying any HTML
+ * content (within a webview) and updating it in real-time. For example it
  * could be used to display a table of content for the active note, or
  * display various metadata or graph.
  *
+ * On desktop, view panels currently are displayed at the right of the sidebar, though can
+ * be moved with "View" > "Change application layout".
+ *
+ * On mobile, view panels are shown in a tabbed dialog that can be opened using a
+ * toolbar button.
+ *
  * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/toc)
  */
 export default class JoplinViewsPanels {
@@ -75,4 +80,5 @@ export default class JoplinViewsPanels {
      * Tells whether the panel is visible or not
      */
     visible(handle: ViewHandle): Promise<boolean>;
+    isActive(handle: ViewHandle): Promise<boolean>;
 }

packages/app-cli/tests/support/plugins/clipboard/api/JoplinWindow.d.ts

@@ -1,17 +1,14 @@
 import Plugin from '../Plugin';
-export interface Implementation {
-    injectCustomStyles(elementId: string, cssFilePath: string): Promise<void>;
-}
 export default class JoplinWindow {
-    private plugin_;
     private store_;
-    private implementation_;
-    constructor(implementation: Implementation, plugin: Plugin, store: any);
+    constructor(_plugin: Plugin, store: any);
     /**
      * Loads a chrome CSS file. It will apply to the window UI elements, except
      * for the note viewer. It is the same as the "Custom stylesheet for
      * Joplin-wide app styles" setting. See the [Load CSS Demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/load_css)
      * for an example.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     loadChromeCssFile(filePath: string): Promise<void>;
     /**
@@ -19,6 +16,8 @@ export default class JoplinWindow {
      * exported or printed note. It is the same as the "Custom stylesheet for
      * rendered Markdown" setting. See the [Load CSS Demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/load_css)
      * for an example.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     loadNoteCssFile(filePath: string): Promise<void>;
 }

packages/app-cli/tests/support/plugins/clipboard/api/JoplinWorkspace.d.ts

@@ -1,9 +1,6 @@
+import Plugin from '../Plugin';
 import { FolderEntity } from '../../database/types';
-import { Disposable, MenuItem } from './types';
-export interface EditContextMenuFilterObject {
-    items: MenuItem[];
-}
-type FilterHandler<T> = (object: T) => Promise<void>;
+import { Disposable, EditContextMenuFilterObject, FilterHandler } from './types';
 declare enum ItemChangeEventType {
     Create = 1,
     Update = 2,
@@ -13,15 +10,25 @@ interface ItemChangeEvent {
     id: string;
     event: ItemChangeEventType;
 }
-interface SyncStartEvent {
-    withErrors: boolean;
-}
 interface ResourceChangeEvent {
     id: string;
 }
-type ItemChangeHandler = (event: ItemChangeEvent) => void;
-type SyncStartHandler = (event: SyncStartEvent) => void;
-type ResourceChangeHandler = (event: ResourceChangeEvent) => void;
+interface NoteContentChangeEvent {
+    note: any;
+}
+interface NoteSelectionChangeEvent {
+    value: string[];
+}
+interface NoteAlarmTriggerEvent {
+    noteId: string;
+}
+interface SyncCompleteEvent {
+    withErrors: boolean;
+}
+type WorkspaceEventHandler<EventType> = (event: EventType) => void;
+type ItemChangeHandler = WorkspaceEventHandler<ItemChangeEvent>;
+type SyncStartHandler = () => void;
+type ResourceChangeHandler = WorkspaceEventHandler<ResourceChangeEvent>;
 /**
  * The workspace service provides access to all the parts of Joplin that
  * are being worked on - i.e. the currently selected notes or notebooks as
@@ -32,16 +39,17 @@ type ResourceChangeHandler = (event: ResourceChangeEvent) => void;
  */
 export default class JoplinWorkspace {
     private store;
-    constructor(store: any);
+    private plugin;
+    constructor(plugin: Plugin, store: any);
     /**
      * Called when a new note or notes are selected.
      */
-    onNoteSelectionChange(callback: Function): Promise<Disposable>;
+    onNoteSelectionChange(callback: WorkspaceEventHandler<NoteSelectionChangeEvent>): Promise<Disposable>;
     /**
      * Called when the content of a note changes.
      * @deprecated Use `onNoteChange()` instead, which is reliably triggered whenever the note content, or any note property changes.
      */
-    onNoteContentChange(callback: Function): Promise<void>;
+    onNoteContentChange(callback: WorkspaceEventHandler<NoteContentChangeEvent>): Promise<void>;
     /**
      * Called when the content of the current note changes.
      */
@@ -54,7 +62,7 @@ export default class JoplinWorkspace {
     /**
      * Called when an alarm associated with a to-do is triggered.
      */
-    onNoteAlarmTrigger(handler: Function): Promise<Disposable>;
+    onNoteAlarmTrigger(handler: WorkspaceEventHandler<NoteAlarmTriggerEvent>): Promise<Disposable>;
     /**
      * Called when the synchronisation process is starting.
      */
@@ -62,14 +70,16 @@ export default class JoplinWorkspace {
     /**
      * Called when the synchronisation process has finished.
      */
-    onSyncComplete(callback: Function): Promise<Disposable>;
+    onSyncComplete(callback: WorkspaceEventHandler<SyncCompleteEvent>): Promise<Disposable>;
     /**
      * Called just before the editor context menu is about to open. Allows
      * adding items to it.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     filterEditorContextMenu(handler: FilterHandler<EditContextMenuFilterObject>): void;
     /**
-     * Gets the currently selected note
+     * Gets the currently selected note. Will be `null` if no note is selected.
      */
     selectedNote(): Promise<any>;
     /**

packages/app-cli/tests/support/plugins/clipboard/api/noteListType.d.ts

@@ -1,5 +1,5 @@
 import { Size } from './types';
-type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
+type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.deleted_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_data' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.deleted_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
 export declare enum ItemFlow {
     TopToBottom = "topToBottom",
     LeftToRight = "leftToRight"
@@ -10,18 +10,245 @@ export interface OnChangeEvent {
     value: any;
     noteId: string;
 }
+export interface OnClickEvent {
+    elementId: string;
+}
 export type OnRenderNoteHandler = (props: any) => Promise<RenderNoteView>;
 export type OnChangeHandler = (event: OnChangeEvent) => Promise<void>;
-export type ListRendererDepependency = ListRendererDatabaseDependency | 'item.size.width' | 'item.size.height' | 'item.selected' | 'note.titleHtml' | 'note.isWatched' | 'note.tags';
+export type OnClickHandler = (event: OnClickEvent) => Promise<void>;
+/**
+ * Most of these are the built-in note properties, such as `note.title`, `note.todo_completed`, etc.
+ * complemented with special properties such as `note.isWatched`, to know if a note is currently
+ * opened in the external editor, and `note.tags` to get the list tags associated with the note.
+ *
+ * The `note.todoStatusText` property is a localised description of the to-do status (e.g.
+ * "to-do, incomplete"). If you include an `<input type='checkbox' ... />` for to-do items that would
+ * otherwise be unlabelled, consider adding `note.todoStatusText` as the checkbox's `aria-label`.
+ *
+ * ## Item properties
+ *
+ * The `item.*` properties are specific to the rendered item. The most important being
+ * `item.selected`, which you can use to display the selected note in a different way.
+ */
+export type ListRendererDependency = ListRendererDatabaseDependency | 'item.index' | 'item.selected' | 'item.size.height' | 'item.size.width' | 'note.folder.title' | 'note.isWatched' | 'note.tags' | 'note.todoStatusText' | 'note.titleHtml';
+export type ListRendererItemValueTemplates = Record<string, string>;
+export declare const columnNames: readonly ["note.folder.title", "note.is_todo", "note.latitude", "note.longitude", "note.source_url", "note.tags", "note.title", "note.todo_completed", "note.todo_due", "note.user_created_time", "note.user_updated_time"];
+export type ColumnName = typeof columnNames[number];
 export interface ListRenderer {
+    /**
+     * It must be unique to your plugin.
+     */
     id: string;
+    /**
+     * Can be top to bottom or left to right. Left to right gives you more
+     * option to set the size of the items since you set both its width and
+     * height.
+     */
     flow: ItemFlow;
+    /**
+     * Whether the renderer supports multiple columns. Applies only when `flow`
+     * is `topToBottom`. Defaults to `false`.
+     */
+    multiColumns?: boolean;
+    /**
+     * The size of each item must be specified in advance for performance
+     * reasons, and cannot be changed afterwards. If the item flow is top to
+     * bottom, you only need to specify the item height (the width will be
+     * ignored).
+     */
     itemSize: Size;
+    /**
+     * The CSS is relative to the list item container. What will appear in the
+     * page is essentially `.note-list-item { YOUR_CSS; }`. It means you can use
+     * child combinator with guarantee it will only apply to your own items. In
+     * this example, the styling will apply to `.note-list-item > .content`:
+     *
+     * ```css
+     * > .content {
+     *     padding: 10px;
+     * }
+     * ```
+     *
+     * In order to get syntax highlighting working here, it's recommended
+     * installing an editor extension such as [es6-string-html VSCode
+     * extension](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html)
+     */
     itemCss?: string;
-    dependencies: ListRendererDepependency[];
+    /**
+     * List the dependencies that your plugin needs to render the note list
+     * items. Only these will be passed to your `onRenderNote` handler. Ensure
+     * that you do not add more than what you need since there is a performance
+     * penalty for each property.
+     */
+    dependencies?: ListRendererDependency[];
+    headerTemplate?: string;
+    headerHeight?: number;
+    onHeaderClick?: OnClickHandler;
+    /**
+     * This property is set differently depending on the `multiColumns` property.
+     *
+     * ## If `multiColumns` is `false`
+     *
+     * There is only one column and the template is used to render the entire row.
+     *
+     * This is the HTML template that will be used to render the note list item. This is a [Mustache
+     * template](https://github.com/janl/mustache.js) and it will receive the variable you return
+     * from `onRenderNote` as tags. For example, if you return a property named `formattedDate` from
+     * `onRenderNote`, you can insert it in the template using `Created date: {{formattedDate}}`
+     *
+     * ## If `multiColumns` is `true`
+     *
+     * Since there is multiple columns, this template will be used to render each note property
+     * within the row. For example if the current columns are the Updated and Title properties, this
+     * template will be called once to render the updated time and a second time to render the
+     * title. To display the current property, the generic `value` property is provided - it will be
+     * replaced at runtime by the actual note property. To render something different depending on
+     * the note property, use `itemValueTemplate`. A minimal example would be
+     * `<span>{{value}}</span>` which will simply render the current property inside a span tag.
+     *
+     * In order to get syntax highlighting working here, it's recommended installing an editor
+     * extension such as [es6-string-html VSCode
+     * extension](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html)
+     *
+     * ## Default property rendering
+     *
+     * Certain properties are automatically rendered once inserted in the Mustache template. Those
+     * are in particular all the date-related fields, such as `note.user_updated_time` or
+     * `note.todo_completed`. Internally, those are timestamps in milliseconds, however when
+     * rendered we display them as date/time strings using the user's preferred time format. Another
+     * notable auto-rendered property is `note.title` which is going to include additional HTML,
+     * such as the search markers.
+     *
+     * If you do not want this default rendering behaviour, for example if you want to display the
+     * raw timestamps in milliseconds, you can simply return custom properties from
+     * `onRenderNote()`. For example:
+     *
+     * ```typescript
+     * onRenderNote: async (props: any) => {
+     *     return {
+     *         ...props,
+     *         // Return the property under a different name
+     *         updatedTimeMs: props.note.user_updated_time,
+     *     }
+     * },
+     *
+     * itemTemplate: // html
+     *     `
+     *     <div>
+     *         Raw timestamp: {{updatedTimeMs}} <!-- This is **not** auto-rendered ->
+     *         Formatted time: {{note.user_updated_time}} <!-- This is -->
+     *     </div>
+     * `,
+     *
+     * ```
+     *
+     * See
+     * `[https://github.com/laurent22/joplin/blob/dev/packages/lib/services/noteList/renderViewProps.ts](renderViewProps.ts)`
+     * for the list of properties that have a default rendering.
+     */
     itemTemplate: string;
+    /**
+     * This property applies only when `multiColumns` is `true`. It is used to render something
+     * different for each note property.
+     *
+     * This is a map of actual dependencies to templates - you only need to return something if the
+     * default, as specified in `template`, is not enough.
+     *
+     * Again you need to return a Mustache template and it will be combined with the `template`
+     * property to create the final template. For example if you return a property named
+     * `formattedDate` from `onRenderNote`, you can insert it in the template using
+     * `{{formattedDate}}`. This string will replace `{{value}}` in the `template` property.
+     *
+     * So if the template property is set to `<span>{{value}}</span>`, the final template will be
+     * `<span>{{formattedDate}}</span>`.
+     *
+     * The property would be set as so:
+     *
+     * ```javascript
+     * itemValueTemplates: {
+     *     'note.user_updated_time': '{{formattedDate}}',
+     * }
+     * ```
+     */
+    itemValueTemplates?: ListRendererItemValueTemplates;
+    /**
+     * This user-facing text is used for example in the View menu, so that your
+     * renderer can be selected.
+     */
     label: () => Promise<string>;
+    /**
+     * This is where most of the real-time processing will happen. When a note
+     * is rendered for the first time and every time it changes, this handler
+     * receives the properties specified in the `dependencies` property. You can
+     * then process them, load any additional data you need, and once done you
+     * need to return the properties that are needed in the `itemTemplate` HTML.
+     * Again, to use the formatted date example, you could have such a renderer:
+     *
+     * ```typescript
+     * dependencies: [
+     *     'note.title',
+     *     'note.created_time',
+     * ],
+     *
+     * itemTemplate: // html
+     *     `
+     *     <div>
+     *         Title: {{note.title}}<br/>
+     *         Date: {{formattedDate}}
+     *     </div>
+     * `,
+     *
+     * onRenderNote: async (props: any) => {
+     *     const formattedDate = dayjs(props.note.created_time).format();
+     *     return {
+     *         // Also return the props, so that note.title is available from the
+     *         // template
+     *         ...props,
+     *         formattedDate,
+     *     }
+     * },
+     * ```
+     */
     onRenderNote: OnRenderNoteHandler;
+    /**
+     * This handler allows adding some interactivity to the note renderer - whenever an input element
+     * within the item is changed (for example, when a checkbox is clicked, or a text input is
+     * changed), this `onChange` handler is going to be called.
+     *
+     * You can inspect `event.elementId` to know which element had some changes, and `event.value`
+     * to know the new value. `event.noteId` also tells you what note is affected, so that you can
+     * potentially apply changes to it.
+     *
+     * You specify the element ID, by setting a `data-id` attribute on the input.
+     *
+     * For example, if you have such a template:
+     *
+     * ```html
+     * <div>
+     *     <input type="text" value="{{note.title}}" data-id="noteTitleInput"/>
+     * </div>
+     * ```
+     *
+     * The event handler will receive an event with `elementId` set to `noteTitleInput`.
+     *
+     * ## Default event handlers
+     *
+     * Currently one click event is automatically handled:
+     *
+     * If there is a checkbox with a `data-id="todo-checkbox"` attribute is present, it is going to
+     * automatically toggle the note to-do "completed" status.
+     *
+     * For example this is what is used in the default list renderer:
+     *
+     * `<input data-id="todo-checkbox" type="checkbox" {{#note.todo_completed}}checked="checked"{{/note.todo_completed}}>`
+     */
     onChange?: OnChangeHandler;
 }
+export interface NoteListColumn {
+    name: ColumnName;
+    width: number;
+}
+export type NoteListColumns = NoteListColumn[];
+export declare const defaultWidth = 100;
+export declare const defaultListColumns: () => NoteListColumns;
 export {};

packages/app-cli/tests/support/plugins/clipboard/api/noteListType.ts

@@ -1,7 +1,9 @@
+/* eslint-disable multiline-comment-style */
+
 import { Size } from './types';
 
 // AUTO-GENERATED by generate-database-type
-type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
+type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.deleted_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_data' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.deleted_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
 // AUTO-GENERATED by generate-database-type
 
 export enum ItemFlow {
@@ -9,34 +11,315 @@ export enum ItemFlow {
 	LeftToRight = 'leftToRight',
 }
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 export type RenderNoteView = Record<string, any>;
 
 export interface OnChangeEvent {
 	elementId: string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	value: any;
 	noteId: string;
 }
 
+export interface OnClickEvent {
+	elementId: string;
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 export type OnRenderNoteHandler = (props: any)=> Promise<RenderNoteView>;
 export type OnChangeHandler = (event: OnChangeEvent)=> Promise<void>;
+export type OnClickHandler = (event: OnClickEvent)=> Promise<void>;
 
-export type ListRendererDepependency =
+/**
+ * Most of these are the built-in note properties, such as `note.title`, `note.todo_completed`, etc.
+ * complemented with special properties such as `note.isWatched`, to know if a note is currently
+ * opened in the external editor, and `note.tags` to get the list tags associated with the note.
+ *
+ * The `note.todoStatusText` property is a localised description of the to-do status (e.g.
+ * "to-do, incomplete"). If you include an `<input type='checkbox' ... />` for to-do items that would
+ * otherwise be unlabelled, consider adding `note.todoStatusText` as the checkbox's `aria-label`.
+ *
+ * ## Item properties
+ *
+ * The `item.*` properties are specific to the rendered item. The most important being
+ * `item.selected`, which you can use to display the selected note in a different way.
+ */
+export type ListRendererDependency =
 	ListRendererDatabaseDependency |
-	'item.size.width' |
-	'item.size.height' |
+	'item.index' |
 	'item.selected' |
-	'note.titleHtml' |
+	'item.size.height' |
+	'item.size.width' |
+	'note.folder.title' |
 	'note.isWatched' |
-	'note.tags';
+	'note.tags' |
+	'note.todoStatusText' |
+	'note.titleHtml';
+
+export type ListRendererItemValueTemplates = Record<string, string>;
+
+export const columnNames = [
+	'note.folder.title',
+	'note.is_todo',
+	'note.latitude',
+	'note.longitude',
+	'note.source_url',
+	'note.tags',
+	'note.title',
+	'note.todo_completed',
+	'note.todo_due',
+	'note.user_created_time',
+	'note.user_updated_time',
+] as const;
+
+export type ColumnName = typeof columnNames[number];
 
 export interface ListRenderer {
+	/**
+	 * It must be unique to your plugin.
+	 */
 	id: string;
+
+	/**
+	 * Can be top to bottom or left to right. Left to right gives you more
+	 * option to set the size of the items since you set both its width and
+	 * height.
+	 */
 	flow: ItemFlow;
+
+	/**
+	 * Whether the renderer supports multiple columns. Applies only when `flow`
+	 * is `topToBottom`. Defaults to `false`.
+	 */
+	multiColumns?: boolean;
+
+	/**
+	 * The size of each item must be specified in advance for performance
+	 * reasons, and cannot be changed afterwards. If the item flow is top to
+	 * bottom, you only need to specify the item height (the width will be
+	 * ignored).
+	 */
 	itemSize: Size;
+
+	/**
+	 * The CSS is relative to the list item container. What will appear in the
+	 * page is essentially `.note-list-item { YOUR_CSS; }`. It means you can use
+	 * child combinator with guarantee it will only apply to your own items. In
+	 * this example, the styling will apply to `.note-list-item > .content`:
+	 *
+	 * ```css
+	 * > .content {
+	 *     padding: 10px;
+	 * }
+	 * ```
+	 *
+	 * In order to get syntax highlighting working here, it's recommended
+	 * installing an editor extension such as [es6-string-html VSCode
+	 * extension](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html)
+	 */
 	itemCss?: string;
-	dependencies: ListRendererDepependency[];
+
+	/**
+	 * List the dependencies that your plugin needs to render the note list
+	 * items. Only these will be passed to your `onRenderNote` handler. Ensure
+	 * that you do not add more than what you need since there is a performance
+	 * penalty for each property.
+	 */
+	dependencies?: ListRendererDependency[];
+
+	headerTemplate?: string;
+	headerHeight?: number;
+	onHeaderClick?: OnClickHandler;
+
+	/**
+	 * This property is set differently depending on the `multiColumns` property.
+	 *
+	 * ## If `multiColumns` is `false`
+	 *
+	 * There is only one column and the template is used to render the entire row.
+	 *
+	 * This is the HTML template that will be used to render the note list item. This is a [Mustache
+	 * template](https://github.com/janl/mustache.js) and it will receive the variable you return
+	 * from `onRenderNote` as tags. For example, if you return a property named `formattedDate` from
+	 * `onRenderNote`, you can insert it in the template using `Created date: {{formattedDate}}`
+	 *
+	 * ## If `multiColumns` is `true`
+	 *
+	 * Since there is multiple columns, this template will be used to render each note property
+	 * within the row. For example if the current columns are the Updated and Title properties, this
+	 * template will be called once to render the updated time and a second time to render the
+	 * title. To display the current property, the generic `value` property is provided - it will be
+	 * replaced at runtime by the actual note property. To render something different depending on
+	 * the note property, use `itemValueTemplate`. A minimal example would be
+	 * `<span>{{value}}</span>` which will simply render the current property inside a span tag.
+	 *
+	 * In order to get syntax highlighting working here, it's recommended installing an editor
+	 * extension such as [es6-string-html VSCode
+	 * extension](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html)
+	 *
+	 * ## Default property rendering
+	 *
+	 * Certain properties are automatically rendered once inserted in the Mustache template. Those
+	 * are in particular all the date-related fields, such as `note.user_updated_time` or
+	 * `note.todo_completed`. Internally, those are timestamps in milliseconds, however when
+	 * rendered we display them as date/time strings using the user's preferred time format. Another
+	 * notable auto-rendered property is `note.title` which is going to include additional HTML,
+	 * such as the search markers.
+	 *
+	 * If you do not want this default rendering behaviour, for example if you want to display the
+	 * raw timestamps in milliseconds, you can simply return custom properties from
+	 * `onRenderNote()`. For example:
+	 *
+	 * ```typescript
+	 * onRenderNote: async (props: any) => {
+	 *     return {
+	 *         ...props,
+	 *         // Return the property under a different name
+	 *         updatedTimeMs: props.note.user_updated_time,
+	 *     }
+	 * },
+	 *
+	 * itemTemplate: // html
+	 *     `
+	 *     <div>
+	 *         Raw timestamp: {{updatedTimeMs}} <!-- This is **not** auto-rendered ->
+	 *         Formatted time: {{note.user_updated_time}} <!-- This is -->
+	 *     </div>
+	 * `,
+	 *
+	 * ```
+	 *
+	 * See
+	 * `[https://github.com/laurent22/joplin/blob/dev/packages/lib/services/noteList/renderViewProps.ts](renderViewProps.ts)`
+	 * for the list of properties that have a default rendering.
+	 */
 	itemTemplate: string;
+
+	/**
+	 * This property applies only when `multiColumns` is `true`. It is used to render something
+	 * different for each note property.
+	 *
+	 * This is a map of actual dependencies to templates - you only need to return something if the
+	 * default, as specified in `template`, is not enough.
+	 *
+	 * Again you need to return a Mustache template and it will be combined with the `template`
+	 * property to create the final template. For example if you return a property named
+	 * `formattedDate` from `onRenderNote`, you can insert it in the template using
+	 * `{{formattedDate}}`. This string will replace `{{value}}` in the `template` property.
+	 *
+	 * So if the template property is set to `<span>{{value}}</span>`, the final template will be
+	 * `<span>{{formattedDate}}</span>`.
+	 *
+	 * The property would be set as so:
+	 *
+	 * ```javascript
+	 * itemValueTemplates: {
+	 *     'note.user_updated_time': '{{formattedDate}}',
+	 * }
+	 * ```
+	 */
+	itemValueTemplates?: ListRendererItemValueTemplates;
+
+	/**
+	 * This user-facing text is used for example in the View menu, so that your
+	 * renderer can be selected.
+	 */
 	label: ()=> Promise<string>;
+
+	/**
+	 * This is where most of the real-time processing will happen. When a note
+	 * is rendered for the first time and every time it changes, this handler
+	 * receives the properties specified in the `dependencies` property. You can
+	 * then process them, load any additional data you need, and once done you
+	 * need to return the properties that are needed in the `itemTemplate` HTML.
+	 * Again, to use the formatted date example, you could have such a renderer:
+	 *
+	 * ```typescript
+	 * dependencies: [
+	 *     'note.title',
+	 *     'note.created_time',
+	 * ],
+	 *
+	 * itemTemplate: // html
+	 *     `
+	 *     <div>
+	 *         Title: {{note.title}}<br/>
+	 *         Date: {{formattedDate}}
+	 *     </div>
+	 * `,
+	 *
+	 * onRenderNote: async (props: any) => {
+	 *     const formattedDate = dayjs(props.note.created_time).format();
+	 *     return {
+	 *         // Also return the props, so that note.title is available from the
+	 *         // template
+	 *         ...props,
+	 *         formattedDate,
+	 *     }
+	 * },
+	 * ```
+	 */
 	onRenderNote: OnRenderNoteHandler;
+
+	/**
+	 * This handler allows adding some interactivity to the note renderer - whenever an input element
+	 * within the item is changed (for example, when a checkbox is clicked, or a text input is
+	 * changed), this `onChange` handler is going to be called.
+	 *
+	 * You can inspect `event.elementId` to know which element had some changes, and `event.value`
+	 * to know the new value. `event.noteId` also tells you what note is affected, so that you can
+	 * potentially apply changes to it.
+	 *
+	 * You specify the element ID, by setting a `data-id` attribute on the input.
+	 *
+	 * For example, if you have such a template:
+	 *
+	 * ```html
+	 * <div>
+	 *     <input type="text" value="{{note.title}}" data-id="noteTitleInput"/>
+	 * </div>
+	 * ```
+	 *
+	 * The event handler will receive an event with `elementId` set to `noteTitleInput`.
+	 *
+	 * ## Default event handlers
+	 *
+	 * Currently one click event is automatically handled:
+	 *
+	 * If there is a checkbox with a `data-id="todo-checkbox"` attribute is present, it is going to
+	 * automatically toggle the note to-do "completed" status.
+	 *
+	 * For example this is what is used in the default list renderer:
+	 *
+	 * `<input data-id="todo-checkbox" type="checkbox" {{#note.todo_completed}}checked="checked"{{/note.todo_completed}}>`
+	 */
 	onChange?: OnChangeHandler;
 }
+
+export interface NoteListColumn {
+	name: ColumnName;
+	width: number;
+}
+
+export type NoteListColumns = NoteListColumn[];
+
+export const defaultWidth = 100;
+
+export const defaultListColumns = () => {
+	const columns: NoteListColumns = [
+		{
+			name: 'note.is_todo',
+			width: 30,
+		},
+		{
+			name: 'note.user_updated_time',
+			width: defaultWidth,
+		},
+		{
+			name: 'note.title',
+			width: 0,
+		},
+	];
+
+	return columns;
+};

packages/app-cli/tests/support/plugins/clipboard/api/types.ts

@@ -26,6 +26,7 @@ export interface Command {
 	/**
 	 * Code to be ran when the command is executed. It may return a result.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	execute(...args: any[]): Promise<any | void>;
 
 	/**
@@ -115,11 +116,13 @@ export interface ExportModule {
 	/**
 	 * Called when an item needs to be processed. An "item" can be any Joplin object, such as a note, a folder, a notebook, etc.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	onProcessItem(context: ExportContext, itemType: number, item: any): Promise<void>;
 
 	/**
 	 * Called when a resource file needs to be exported.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	onProcessResource(context: ExportContext, resource: any, filePath: string): Promise<void>;
 
 	/**
@@ -181,13 +184,15 @@ export interface ExportContext {
 	options: ExportOptions;
 
 	/**
-	 * You can attach your own custom data using this propery - it will then be passed to each event handler, allowing you to keep state from one event to the next.
+	 * You can attach your own custom data using this property - it will then be passed to each event handler, allowing you to keep state from one event to the next.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	userData?: any;
 }
 
 export interface ImportContext {
 	sourcePath: string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	options: any;
 	warnings: string[];
 }
@@ -197,6 +202,7 @@ export interface ImportContext {
 // =================================================================
 
 export interface Script {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	onStart?(event: any): Promise<void>;
 }
 
@@ -227,6 +233,8 @@ export interface VersionInfo {
 	version: string;
 	profileVersion: number;
 	syncVersion: number;
+
+	platform: 'desktop'|'mobile';
 }
 
 // =================================================================
@@ -300,6 +308,7 @@ export interface MenuItem {
 	 * Arguments that should be passed to the command. They will be as rest
 	 * parameters.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	commandArgs?: any[];
 
 	/**
@@ -338,6 +347,8 @@ export type ButtonId = string;
 export enum ToolbarButtonLocation {
 	/**
 	 * This toolbar in the top right corner of the application. It applies to the note as a whole, including its metadata.
+	 *
+	 * <span class="platform-desktop">desktop</span>
 	 */
 	NoteToolbar = 'noteToolbar',
 
@@ -351,11 +362,13 @@ export type ViewHandle = string;
 
 export interface EditorCommand {
 	name: string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	value?: any;
 }
 
 export interface DialogResult {
 	id: ButtonId;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	formData?: any;
 }
 
@@ -371,6 +384,26 @@ export interface Rectangle {
 	height?: number;
 }
 
+export type ActivationCheckCallback = ()=> Promise<boolean>;
+
+export type UpdateCallback = ()=> Promise<void>;
+
+export type VisibleHandler = ()=> Promise<void>;
+
+export interface EditContextMenuFilterObject {
+	items: MenuItem[];
+}
+
+export interface EditorActivationCheckFilterObject {
+	activatedEditors: {
+		pluginId: string;
+		viewId: string;
+		isActive: boolean;
+	}[];
+}
+
+export type FilterHandler<T> = (object: T)=> Promise<T>;
+
 // =================================================================
 // Settings types
 // =================================================================
@@ -404,6 +437,7 @@ export enum SettingStorage {
 // Redefine a simplified interface to mask internal details
 // and to remove function calls as they would have to be async.
 export interface SettingItem {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	value: any;
 	type: SettingItemType;
 
@@ -440,6 +474,7 @@ export interface SettingItem {
 	 * This property is required when `isEnum` is `true`. In which case, it
 	 * should contain a map of value => label.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	options?: Record<any, any>;
 
 	/**
@@ -497,6 +532,7 @@ export type Path = string[];
 // Content Script types
 // =================================================================
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 export type PostMessageHandler = (message: any)=> Promise<any>;
 
 /**
@@ -519,6 +555,67 @@ export interface ContentScriptContext {
 	postMessage: PostMessageHandler;
 }
 
+export interface ContentScriptModuleLoadedEvent {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	userData?: any;
+}
+
+export interface ContentScriptModule {
+	onLoaded?: (event: ContentScriptModuleLoadedEvent)=> void;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	plugin: ()=> any;
+	assets?: ()=> void;
+}
+
+export interface MarkdownItContentScriptModule extends Omit<ContentScriptModule, 'plugin'> {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	plugin: (markdownIt: any, options: any)=> any;
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+type EditorCommandCallback = (...args: any[])=> any;
+
+export interface CodeMirrorControl {
+	/** Points to a CodeMirror 6 EditorView instance. */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	editor: any;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	cm6: any;
+
+	/** `extension` should be a [CodeMirror 6 extension](https://codemirror.net/docs/ref/#state.Extension). */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	addExtension(extension: any|any[]): void;
+
+	supportsCommand(name: string): boolean;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	execCommand(name: string, ...args: any[]): any;
+	registerCommand(name: string, callback: EditorCommandCallback): void;
+
+	joplinExtensions: {
+		/**
+		 * Returns a [CodeMirror 6 extension](https://codemirror.net/docs/ref/#state.Extension) that
+		 * registers the given [CompletionSource](https://codemirror.net/docs/ref/#autocomplete.CompletionSource).
+		 *
+		 * Use this extension rather than the built-in CodeMirror [`autocompletion`](https://codemirror.net/docs/ref/#autocomplete.autocompletion)
+		 * if you don't want to use [languageData-based autocompletion](https://codemirror.net/docs/ref/#autocomplete.autocompletion^config.override).
+		 *
+		 * Using `autocompletion({ override: [ ... ]})` causes errors when done by multiple plugins.
+		 */
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+		completionSource(completionSource: any): any;
+
+		/**
+		 * Creates an extension that enables or disables [`languageData`-based autocompletion](https://codemirror.net/docs/ref/#autocomplete.autocompletion^config.override).
+		 */
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+		enableLanguageDataAutocomplete: { of: (enabled: boolean)=> any };
+	};
+}
+
+export interface MarkdownEditorContentScriptModule extends Omit<ContentScriptModule, 'plugin'> {
+	plugin: (editorControl: CodeMirrorControl)=> void;
+}
+
 export enum ContentScriptType {
 	/**
 	 * Registers a new Markdown-It plugin, which should follow the template
@@ -528,7 +625,7 @@ export enum ContentScriptType {
 	 * module.exports = {
 	 *     default: function(context) {
 	 *         return {
-	 *             plugin: function(markdownIt, options) {
+	 *             plugin: function(markdownIt, pluginOptions) {
 	 *                 // ...
 	 *             },
 	 *             assets: {
@@ -538,6 +635,7 @@ export enum ContentScriptType {
 	 *     }
 	 * }
 	 * ```
+	 *
 	 * See [the
 	 * demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/content_script)
 	 * for a simple Markdown-it plugin example.
@@ -550,10 +648,7 @@ export enum ContentScriptType {
 	 *
 	 * - The **required** `plugin` key is the actual Markdown-It plugin - check
 	 *   the [official doc](https://github.com/markdown-it/markdown-it) for more
-	 *   information. The `options` parameter is of type
-	 *   [RuleOptions](https://github.com/laurent22/joplin/blob/dev/packages/renderer/MdToHtml.ts),
-	 *   which contains a number of options, mostly useful for Joplin's internal
-	 *   code.
+	 *   information.
 	 *
 	 * - Using the **optional** `assets` key you may specify assets such as JS
 	 *   or CSS that should be loaded in the rendered HTML document. Check for
@@ -561,6 +656,50 @@ export enum ContentScriptType {
 	 *   plugin](https://github.com/laurent22/joplin/blob/dev/packages/renderer/MdToHtml/rules/mermaid.ts)
 	 *   to see how the data should be structured.
 	 *
+	 * ## Supporting the Rich Text Editor
+	 *
+	 * Joplin's Rich Text Editor works with rendered HTML, which is converted back
+	 * to markdown when saving. To prevent the original markdown for your plugin from
+	 * being lost, Joplin needs additional metadata.
+	 *
+	 * To provide this,
+	 * 1. Wrap the HTML generated by your plugin in an element with class `joplin-editable`.
+	 *    For example,
+	 *    ```html
+	 *    <div class="joplin-editable">
+	 *        ...your html...
+	 *    </div>
+	 *    ```
+	 * 2. Add a child with class `joplin-source` that contains the original markdown that
+	 *    was rendered by your plugin. Include `data-joplin-source-open`, `data-joplin-source-close`,
+	 *    and `data-joplin-language` attributes.
+	 *    For example, if your plugin rendered the following code block,
+	 *    ````
+	 *    ```foo
+	 *    ... original source here ...
+	 *    ```
+	 *    ````
+	 *    then it should render to
+	 *    ```html
+	 *    <div class="joplin-editable">
+	 *        <pre
+	 *            class="joplin-source"
+	 *            data-joplin-language="foo"
+	 *            data-joplin-source-open="```foo&NewLine;"
+	 *            data-joplin-source-close="```"
+	 *        > ... original source here ... </pre>
+	 *        ... rendered HTML here ...
+	 *    </div>
+	 *    ```
+	 *
+	 * See [the demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/content_script)
+	 * for a complete example.
+	 *
+	 * ## Getting the settings from the renderer
+	 *
+	 * You can access your plugin settings from the renderer by calling
+	 * `pluginOptions.settingValue("your-setting-key')`.
+	 *
 	 * ## Posting messages from the content script to your plugin
 	 *
 	 * The application provides the following function to allow executing
@@ -630,21 +769,21 @@ export enum ContentScriptType {
 	 * }
 	 * ```
 	 *
-	 * - The `context` argument is currently unused but could be used later on
-	 *   to provide access to your own plugin so that the content script and
-	 *   plugin can communicate.
+	 * - The `context` argument allows communicating with other parts of
+	 *   your plugin (see below).
 	 *
 	 * - The `plugin` key is your CodeMirror plugin. This is where you can
 	 *   register new commands with CodeMirror or interact with the CodeMirror
 	 *   instance as needed.
 	 *
-	 * - The `codeMirrorResources` key is an array of CodeMirror resources that
+	 * - **CodeMirror 5 only**: The `codeMirrorResources` key is an array of CodeMirror resources that
 	 *   will be loaded and attached to the CodeMirror module. These are made up
 	 *   of addons, keymaps, and modes. For example, for a plugin that want's to
 	 *   enable clojure highlighting in code blocks. `codeMirrorResources` would
 	 *   be set to `['mode/clojure/clojure']`.
+	 *   This field is ignored on mobile and when the desktop beta editor is enabled.
 	 *
-	 * - The `codeMirrorOptions` key contains all the
+	 * - **CodeMirror 5 only**: The `codeMirrorOptions` key contains all the
 	 *   [CodeMirror](https://codemirror.net/doc/manual.html#config) options
 	 *   that will be set or changed by this plugin. New options can alse be
 	 *   declared via
@@ -662,9 +801,11 @@ export enum ContentScriptType {
 	 * must be provided for the plugin to be valid. Having multiple or all
 	 * provided is also okay.
 	 *
-	 * See also the [demo
-	 * plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
-	 * for an example of all these keys being used in one plugin.
+	 * See also:
+	 * - The [demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
+	 *   for an example of all these keys being used in one plugin.
+	 * - See [the editor plugin tutorial](https://joplinapp.org/help/api/tutorials/cm6_plugin)
+	 *   for how to develop a plugin for the mobile editor and the desktop beta markdown editor.
 	 *
 	 * ## Posting messages from the content script to your plugin
 	 *

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/Joplin.d.ts

@@ -68,6 +68,8 @@ export default class Joplin {
      * - [fs-extra](https://www.npmjs.com/package/fs-extra)
      *
      * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/nativeModule)
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     require(_path: string): any;
     versionInfo(): Promise<import("./types").VersionInfo>;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinClipboard.d.ts

@@ -4,14 +4,20 @@ export default class JoplinClipboard {
     constructor(electronClipboard: any, electronNativeImage: any);
     readText(): Promise<string>;
     writeText(text: string): Promise<void>;
+    /** <span class="platform-desktop">desktop</span> */
     readHtml(): Promise<string>;
+    /** <span class="platform-desktop">desktop</span> */
     writeHtml(html: string): Promise<void>;
     /**
      * Returns the image in [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) format.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     readImage(): Promise<string>;
     /**
      * Takes an image in [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) format.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     writeImage(dataUrl: string): Promise<void>;
     /**

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinCommands.d.ts

@@ -1,4 +1,5 @@
 import { Command } from './types';
+import Plugin from '../Plugin';
 /**
  * This class allows executing or registering new Joplin commands. Commands
  * can be executed or associated with
@@ -20,6 +21,12 @@ import { Command } from './types';
  * To view what arguments are supported, you can open any of these files
  * and look at the `execute()` command.
  *
+ * Note that many of these commands only work on desktop. The more limited list of mobile
+ * commands can be found in these places:
+ *
+ * * [Global commands](https://github.com/laurent22/joplin/tree/dev/packages/app-mobile/commands)
+ * * [Editor commands](https://github.com/laurent22/joplin/blob/dev/packages/app-mobile/components/NoteEditor/commandDeclarations.ts)
+ *
  * ## Executing editor commands
  *
  * There might be a situation where you want to invoke editor commands
@@ -49,9 +56,10 @@ import { Command } from './types';
  *
  */
 export default class JoplinCommands {
+    private plugin_;
+    constructor(plugin_: Plugin);
     /**
-     * <span class="platform-desktop">desktop</span> Executes the given
-     * command.
+     * Executes the given command.
      *
      * The command can take any number of arguments, and the supported
      * arguments will vary based on the command. For custom commands, this
@@ -70,7 +78,7 @@ export default class JoplinCommands {
      */
     execute(commandName: string, ...args: any[]): Promise<any | void>;
     /**
-     * <span class="platform-desktop">desktop</span> Registers a new command.
+     * Registers a new command.
      *
      * ```typescript
      * // Register a new commmand called "testCommand1"

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinContentScripts.d.ts

@@ -21,7 +21,8 @@ export default class JoplinContentScripts {
      * for more information.
      *
      * * [View the renderer demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/content_script)
-     * * [View the editor demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
+     * * [View the editor plugin tutorial](https://joplinapp.org/help/api/tutorials/cm6_plugin)
+     * * [View the legacy editor demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
      *
      * See also the [postMessage demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/post_messages)
      *

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinData.d.ts

@@ -13,7 +13,7 @@ import { Path } from './types';
  * In general you would use the methods in this class as if you were using a REST API. There are four methods that map to GET, POST, PUT and DELETE calls.
  * And each method takes these parameters:
  *
- * * `path`: This is an array that represents the path to the resource in the form `["resouceName", "resourceId", "resourceLink"]` (eg. ["tags", ":id", "notes"]). The "resources" segment is the name of the resources you want to access (eg. "notes", "folders", etc.). If not followed by anything, it will refer to all the resources in that collection. The optional "resourceId" points to a particular resources within the collection. Finally, an optional "link" can be present, which links the resource to a collection of resources. This can be used in the API for example to retrieve all the notes associated with a tag.
+ * * `path`: This is an array that represents the path to the resource in the form `["resourceName", "resourceId", "resourceLink"]` (eg. ["tags", ":id", "notes"]). The "resources" segment is the name of the resources you want to access (eg. "notes", "folders", etc.). If not followed by anything, it will refer to all the resources in that collection. The optional "resourceId" points to a particular resources within the collection. Finally, an optional "link" can be present, which links the resource to a collection of resources. This can be used in the API for example to retrieve all the notes associated with a tag.
  * * `query`: (Optional) The query parameters. In a URL, this is the part after the question mark "?". In this case, it should be an object with key/value pairs.
  * * `data`: (Optional) Applies to PUT and POST calls only. The request body contains the data you want to create or modify, for example the content of a note or folder.
  * * `files`: (Optional) Used to create new resources and associate them with files.

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinFilters.d.ts

@@ -1,3 +1,4 @@
+import { FilterHandler } from '../../../eventManager';
 /**
  * @ignore
  *
@@ -5,6 +6,6 @@
  * so for now disable filters.
  */
 export default class JoplinFilters {
-    on(name: string, callback: Function): Promise<void>;
-    off(name: string, callback: Function): Promise<void>;
+    on(name: string, callback: FilterHandler): Promise<void>;
+    off(name: string, callback: FilterHandler): Promise<void>;
 }

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinImaging.d.ts

@@ -1,12 +1,33 @@
 import { Rectangle } from './types';
-export interface Implementation {
-    nativeImage: any;
-}
 export interface CreateFromBufferOptions {
     width?: number;
     height?: number;
     scaleFactor?: number;
 }
+export interface CreateFromPdfOptions {
+    /**
+     * The first page to export. Defaults to `1`, the first page in
+     * the document.
+     */
+    minPage?: number;
+    /**
+     * The number of the last page to convert. Defaults to the last page
+     * if not given.
+     *
+     * If `maxPage` is greater than the number of pages in the PDF, all pages
+     * in the PDF will be converted to images.
+     */
+    maxPage?: number;
+    scaleFactor?: number;
+}
+export interface PdfInfo {
+    pageCount: number;
+}
+export interface Implementation {
+    createFromPath: (path: string) => Promise<unknown>;
+    createFromPdf: (path: string, options: CreateFromPdfOptions) => Promise<unknown[]>;
+    getPdfInfo: (path: string) => Promise<PdfInfo>;
+}
 export interface ResizeOptions {
     width?: number;
     height?: number;
@@ -24,6 +45,7 @@ export type Handle = string;
  * [View the
  * example](https://github.com/laurent22/joplin/blob/dev/packages/app-cli/tests/support/plugins/imaging/src/index.ts)
  *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinImaging {
     private implementation_;
@@ -32,11 +54,20 @@ export default class JoplinImaging {
     private createImageHandle;
     private imageByHandle;
     private cacheImage;
+    /**
+     * Creates an image from the provided path. Note that images and PDFs are supported. If you
+     * provide a URL instead of a local path, the file will be downloaded first then converted to an
+     * image.
+     */
     createFromPath(filePath: string): Promise<Handle>;
     createFromResource(resourceId: string): Promise<Handle>;
+    createFromPdfPath(path: string, options?: CreateFromPdfOptions): Promise<Handle[]>;
+    createFromPdfResource(resourceId: string, options?: CreateFromPdfOptions): Promise<Handle[]>;
+    getPdfInfoFromPath(path: string): Promise<PdfInfo>;
+    getPdfInfoFromResource(resourceId: string): Promise<PdfInfo>;
     getSize(handle: Handle): Promise<any>;
     resize(handle: Handle, options?: ResizeOptions): Promise<string>;
-    crop(handle: Handle, rectange: Rectangle): Promise<string>;
+    crop(handle: Handle, rectangle: Rectangle): Promise<string>;
     toPngFile(handle: Handle, filePath: string): Promise<void>;
     /**
      * Quality is between 0 and 100
@@ -57,5 +88,5 @@ export default class JoplinImaging {
      * Image data is not automatically deleted by Joplin so make sure you call
      * this method on the handle once you are done.
      */
-    free(handle: Handle): Promise<void>;
+    free(handles: Handle[] | Handle): Promise<void>;
 }

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinInterop.d.ts

@@ -10,6 +10,9 @@ import { ExportModule, ImportModule } from './types';
  * See the documentation of the [[ExportModule]] and [[ImportModule]] for more information.
  *
  * You may also want to refer to the Joplin API documentation to see the list of properties for each item (note, notebook, etc.) - https://joplinapp.org/help/api/references/rest_api
+ *
+ * <span class="platform-desktop">desktop</span>: While it is possible to register import and export
+ * modules on mobile, there is no GUI to activate them.
  */
 export default class JoplinInterop {
     registerExportModule(module: ExportModule): Promise<void>;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinSettings.d.ts

@@ -7,7 +7,6 @@ export interface ChangeEvent {
     keys: string[];
 }
 export type ChangeHandler = (event: ChangeEvent) => void;
-export declare const namespacedKey: (pluginId: string, key: string) => string;
 /**
  * This API allows registering new settings and setting sections, as well as getting and setting settings. Once a setting has been registered it will appear in the config screen and be editable by the user.
  *
@@ -39,6 +38,12 @@ export default class JoplinSettings {
      */
     registerSection(name: string, section: SettingSection): Promise<void>;
     /**
+     * Gets setting values (only applies to setting you registered from your plugin)
+     */
+    values(keys: string[] | string): Promise<Record<string, unknown>>;
+    /**
+     * @deprecated Use joplin.settings.values()
+     *
      * Gets a setting value (only applies to setting you registered from your plugin)
      */
     value(key: string): Promise<any>;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViews.d.ts

@@ -5,6 +5,7 @@ import JoplinViewsMenus from './JoplinViewsMenus';
 import JoplinViewsToolbarButtons from './JoplinViewsToolbarButtons';
 import JoplinViewsPanels from './JoplinViewsPanels';
 import JoplinViewsNoteList from './JoplinViewsNoteList';
+import JoplinViewsEditors from './JoplinViewsEditor';
 /**
  * This namespace provides access to view-related services.
  *
@@ -19,11 +20,13 @@ export default class JoplinViews {
     private menus_;
     private toolbarButtons_;
     private dialogs_;
+    private editors_;
     private noteList_;
     private implementation_;
     constructor(implementation: any, plugin: Plugin, store: any);
     get dialogs(): JoplinViewsDialogs;
     get panels(): JoplinViewsPanels;
+    get editors(): JoplinViewsEditors;
     get menuItems(): JoplinViewsMenuItems;
     get menus(): JoplinViewsMenus;
     get toolbarButtons(): JoplinViewsToolbarButtons;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViewsDialogs.d.ts

@@ -47,6 +47,8 @@ export default class JoplinViewsDialogs {
      * Displays a dialog to select a file or a directory. Same options and
      * output as
      * https://www.electronjs.org/docs/latest/api/dialog#dialogshowopendialogbrowserwindow-options
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     showOpenDialog(options: any): Promise<any>;
     /**
@@ -62,7 +64,9 @@ export default class JoplinViewsDialogs {
      */
     setButtons(handle: ViewHandle, buttons: ButtonSpec[]): Promise<ButtonSpec[]>;
     /**
-     * Opens the dialog
+     * Opens the dialog.
+     *
+     * On desktop, this closes any copies of the dialog open in different windows.
      */
     open(handle: ViewHandle): Promise<DialogResult>;
     /**

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViewsEditor.d.ts

@@ -0,0 +1,88 @@
+import Plugin from '../Plugin';
+import { ActivationCheckCallback, ViewHandle, UpdateCallback } from './types';
+/**
+ * Allows creating alternative note editors. You can create a view to handle loading and saving the
+ * note, and do your own rendering.
+ *
+ * Although it may be used to implement an alternative text editor, the more common use case may be
+ * to render the note in a different, graphical way - for example displaying a graph, and
+ * saving/loading the graph data in the associated note. In that case, you would detect whether the
+ * current note contains graph data and, in this case, you'd display your viewer.
+ *
+ * Terminology: An editor is **active** when it can be used to edit the current note. Note that it
+ * doesn't necessarily mean that your editor is visible - it just means that the user has the option
+ * to switch to it (via the "toggle editor" button). A **visible** editor is active and is currently
+ * being displayed.
+ *
+ * To implement an editor you need to listen to two events:
+ *
+ * - `onActivationCheck`: This is a way for the app to know whether your editor should be active or
+ *   not. Return `true` from this handler to activate your editor.
+ *
+ * - `onUpdate`: When this is called you should update your editor based on the current note
+ *   content. Call `joplin.workspace.selectedNote()` to get the current note.
+ *
+ * - `showEditorPlugin` and `toggleEditorPlugin` commands. Additionally you can use these commands
+ *   to display your editor via `joplin.commands.execute('showEditorPlugin')`. This is not always
+ *   necessary since the user can switch to your editor using the "toggle editor" button, however
+ *   you may want to programmatically display the editor in some cases - for example when creating a
+ *   new note specific to your editor.
+ *
+ * Note that only one editor view can be active at a time. This is why it is important not to
+ * activate your view if it's not relevant to the current note. If more than one is active, it is
+ * undefined which editor is going to be used to display the note.
+ *
+ * For an example of editor plugin, see the [YesYouKan
+ * plugin](https://github.com/joplin/plugin-yesyoukan/blob/master/src/index.ts). In particular,
+ * check the logic around `onActivationCheck` and `onUpdate` since this is the entry points for
+ * using this API.
+ */
+export default class JoplinViewsEditors {
+    private store;
+    private plugin;
+    private activationCheckHandlers_;
+    constructor(plugin: Plugin, store: any);
+    private controller;
+    /**
+     * Creates a new editor view
+     */
+    create(id: string): Promise<ViewHandle>;
+    /**
+     * Sets the editor HTML content
+     */
+    setHtml(handle: ViewHandle, html: string): Promise<string>;
+    /**
+     * Adds and loads a new JS or CSS file into the panel.
+     */
+    addScript(handle: ViewHandle, scriptPath: string): Promise<void>;
+    /**
+     * See [[JoplinViewPanels]]
+     */
+    onMessage(handle: ViewHandle, callback: Function): Promise<void>;
+    /**
+     * Emitted when the editor can potentially be activated - this for example when the current note
+     * is changed, or when the application is opened. At that point should can check the current
+     * note and decide whether your editor should be activated or not. If it should return `true`,
+     * otherwise return `false`.
+     */
+    onActivationCheck(handle: ViewHandle, callback: ActivationCheckCallback): Promise<void>;
+    /**
+     * Emitted when the editor content should be updated. This for example when the currently
+     * selected note changes, or when the user makes the editor visible.
+     */
+    onUpdate(handle: ViewHandle, callback: UpdateCallback): Promise<void>;
+    /**
+     * See [[JoplinViewPanels]]
+     */
+    postMessage(handle: ViewHandle, message: any): void;
+    /**
+     * Tells whether the editor is active or not.
+     */
+    isActive(handle: ViewHandle): Promise<boolean>;
+    /**
+     * Tells whether the editor is effectively visible or not. If the editor is inactive, this will
+     * return `false`. If the editor is active and the user has switched to it, it will return
+     * `true`. Otherwise it will return `false`.
+     */
+    isVisible(handle: ViewHandle): Promise<boolean>;
+}

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViewsMenuItems.d.ts

@@ -4,6 +4,8 @@ import Plugin from '../Plugin';
  * Allows creating and managing menu items.
  *
  * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/register_command)
+ *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinViewsMenuItems {
     private store;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViewsMenus.d.ts

@@ -4,6 +4,8 @@ import Plugin from '../Plugin';
  * Allows creating menus.
  *
  * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/menu)
+ *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinViewsMenus {
     private store;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViewsNoteList.d.ts

@@ -7,14 +7,32 @@ import { ListRenderer } from './noteListType';
  *
  * The app provides the required dependencies whenever a note is updated - you
  * process these dependencies, and return some props, which are then passed to
- * your template and rendered. See [[[ListRenderer]]] for a detailed description
+ * your template and rendered. See [[ListRenderer]] for a detailed description
  * of each property of the renderer.
  *
- * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/note_list_renderer)
+ * ## Reference
  *
- * The default list renderer is implemented using the same API, so it worth checking it too:
+ * * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/note_list_renderer)
  *
- * [Default list renderer](https://github.com/laurent22/joplin/tree/dev/packages/lib/services/noteList/defaultListRenderer.ts)
+ * * [Default simple renderer](https://github.com/laurent22/joplin/tree/dev/packages/lib/services/noteList/defaultListRenderer.ts)
+ *
+ * * [Default detailed renderer](https://github.com/laurent22/joplin/tree/dev/packages/lib/services/noteList/defaultMultiColumnsRenderer.ts)
+ *
+ * ## Screenshots:
+ *
+ * ### Top to bottom with title, date and body
+ *
+ * <img width="250px" src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/note_list/TopToBottom.png"/>
+ *
+ * ### Left to right with thumbnails
+ *
+ * <img width="250px" src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/note_list/LeftToRight_Thumbnails.png"/>
+ *
+ * ### Top to bottom with editable title
+ *
+ * <img width="250px" src="https://raw.githubusercontent.com/laurent22/joplin/dev/Assets/WebsiteAssets/images/note_list/TopToBottom_Editable.png"/>
+ *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinViewsNoteList {
     private plugin_;

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinViewsPanels.d.ts

@@ -1,12 +1,17 @@
 import Plugin from '../Plugin';
 import { ViewHandle } from './types';
 /**
- * Allows creating and managing view panels. View panels currently are
- * displayed at the right of the sidebar and allows displaying any HTML
- * content (within a webview) and update it in real-time. For example it
+ * Allows creating and managing view panels. View panels allow displaying any HTML
+ * content (within a webview) and updating it in real-time. For example it
  * could be used to display a table of content for the active note, or
  * display various metadata or graph.
  *
+ * On desktop, view panels currently are displayed at the right of the sidebar, though can
+ * be moved with "View" > "Change application layout".
+ *
+ * On mobile, view panels are shown in a tabbed dialog that can be opened using a
+ * toolbar button.
+ *
  * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/toc)
  */
 export default class JoplinViewsPanels {
@@ -75,4 +80,5 @@ export default class JoplinViewsPanels {
      * Tells whether the panel is visible or not
      */
     visible(handle: ViewHandle): Promise<boolean>;
+    isActive(handle: ViewHandle): Promise<boolean>;
 }

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinWindow.d.ts

@@ -1,17 +1,14 @@
 import Plugin from '../Plugin';
-export interface Implementation {
-    injectCustomStyles(elementId: string, cssFilePath: string): Promise<void>;
-}
 export default class JoplinWindow {
-    private plugin_;
     private store_;
-    private implementation_;
-    constructor(implementation: Implementation, plugin: Plugin, store: any);
+    constructor(_plugin: Plugin, store: any);
     /**
      * Loads a chrome CSS file. It will apply to the window UI elements, except
      * for the note viewer. It is the same as the "Custom stylesheet for
      * Joplin-wide app styles" setting. See the [Load CSS Demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/load_css)
      * for an example.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     loadChromeCssFile(filePath: string): Promise<void>;
     /**
@@ -19,6 +16,8 @@ export default class JoplinWindow {
      * exported or printed note. It is the same as the "Custom stylesheet for
      * rendered Markdown" setting. See the [Load CSS Demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/load_css)
      * for an example.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     loadNoteCssFile(filePath: string): Promise<void>;
 }

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/JoplinWorkspace.d.ts

@@ -1,9 +1,6 @@
+import Plugin from '../Plugin';
 import { FolderEntity } from '../../database/types';
-import { Disposable, MenuItem } from './types';
-export interface EditContextMenuFilterObject {
-    items: MenuItem[];
-}
-type FilterHandler<T> = (object: T) => Promise<void>;
+import { Disposable, EditContextMenuFilterObject, FilterHandler } from './types';
 declare enum ItemChangeEventType {
     Create = 1,
     Update = 2,
@@ -13,15 +10,25 @@ interface ItemChangeEvent {
     id: string;
     event: ItemChangeEventType;
 }
-interface SyncStartEvent {
-    withErrors: boolean;
-}
 interface ResourceChangeEvent {
     id: string;
 }
-type ItemChangeHandler = (event: ItemChangeEvent) => void;
-type SyncStartHandler = (event: SyncStartEvent) => void;
-type ResourceChangeHandler = (event: ResourceChangeEvent) => void;
+interface NoteContentChangeEvent {
+    note: any;
+}
+interface NoteSelectionChangeEvent {
+    value: string[];
+}
+interface NoteAlarmTriggerEvent {
+    noteId: string;
+}
+interface SyncCompleteEvent {
+    withErrors: boolean;
+}
+type WorkspaceEventHandler<EventType> = (event: EventType) => void;
+type ItemChangeHandler = WorkspaceEventHandler<ItemChangeEvent>;
+type SyncStartHandler = () => void;
+type ResourceChangeHandler = WorkspaceEventHandler<ResourceChangeEvent>;
 /**
  * The workspace service provides access to all the parts of Joplin that
  * are being worked on - i.e. the currently selected notes or notebooks as
@@ -32,16 +39,17 @@ type ResourceChangeHandler = (event: ResourceChangeEvent) => void;
  */
 export default class JoplinWorkspace {
     private store;
-    constructor(store: any);
+    private plugin;
+    constructor(plugin: Plugin, store: any);
     /**
      * Called when a new note or notes are selected.
      */
-    onNoteSelectionChange(callback: Function): Promise<Disposable>;
+    onNoteSelectionChange(callback: WorkspaceEventHandler<NoteSelectionChangeEvent>): Promise<Disposable>;
     /**
      * Called when the content of a note changes.
      * @deprecated Use `onNoteChange()` instead, which is reliably triggered whenever the note content, or any note property changes.
      */
-    onNoteContentChange(callback: Function): Promise<void>;
+    onNoteContentChange(callback: WorkspaceEventHandler<NoteContentChangeEvent>): Promise<void>;
     /**
      * Called when the content of the current note changes.
      */
@@ -54,7 +62,7 @@ export default class JoplinWorkspace {
     /**
      * Called when an alarm associated with a to-do is triggered.
      */
-    onNoteAlarmTrigger(handler: Function): Promise<Disposable>;
+    onNoteAlarmTrigger(handler: WorkspaceEventHandler<NoteAlarmTriggerEvent>): Promise<Disposable>;
     /**
      * Called when the synchronisation process is starting.
      */
@@ -62,14 +70,16 @@ export default class JoplinWorkspace {
     /**
      * Called when the synchronisation process has finished.
      */
-    onSyncComplete(callback: Function): Promise<Disposable>;
+    onSyncComplete(callback: WorkspaceEventHandler<SyncCompleteEvent>): Promise<Disposable>;
     /**
      * Called just before the editor context menu is about to open. Allows
      * adding items to it.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     filterEditorContextMenu(handler: FilterHandler<EditContextMenuFilterObject>): void;
     /**
-     * Gets the currently selected note
+     * Gets the currently selected note. Will be `null` if no note is selected.
      */
     selectedNote(): Promise<any>;
     /**

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/noteListType.d.ts

@@ -1,5 +1,5 @@
 import { Size } from './types';
-type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_data' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
+type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.deleted_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_data' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.deleted_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
 export declare enum ItemFlow {
     TopToBottom = "topToBottom",
     LeftToRight = "leftToRight"
@@ -10,29 +10,30 @@ export interface OnChangeEvent {
     value: any;
     noteId: string;
 }
+export interface OnClickEvent {
+    elementId: string;
+}
 export type OnRenderNoteHandler = (props: any) => Promise<RenderNoteView>;
 export type OnChangeHandler = (event: OnChangeEvent) => Promise<void>;
+export type OnClickHandler = (event: OnClickEvent) => Promise<void>;
 /**
- * Most of these are the built-in note properties, such as `note.title`,
- * `note.todo_completed`, etc.
+ * Most of these are the built-in note properties, such as `note.title`, `note.todo_completed`, etc.
+ * complemented with special properties such as `note.isWatched`, to know if a note is currently
+ * opened in the external editor, and `note.tags` to get the list tags associated with the note.
  *
- * Additionally, the `item.*` properties are specific to the rendered item. The
- * most important being `item.selected`, which you can use to display the
- * selected note in a different way.
+ * The `note.todoStatusText` property is a localised description of the to-do status (e.g.
+ * "to-do, incomplete"). If you include an `<input type='checkbox' ... />` for to-do items that would
+ * otherwise be unlabelled, consider adding `note.todoStatusText` as the checkbox's `aria-label`.
  *
- * Finally some special properties are provided to make it easier to render
- * notes. In particular, if possible prefer `note.titleHtml` to `note.title`
- * since some important processing has already been done on the string, such as
- * handling the search highlighter and escaping. Since it's HTML and already
- * escaped you would insert it using `{{{titleHtml}}}` (triple-mustache syntax,
- * which disables escaping).
+ * ## Item properties
  *
- * `notes.tag` gives you the list of tags associated with the note.
- *
- * `note.isWatched` tells you if the note is currently opened in an external
- * editor. In which case you would generally display some indicator.
+ * The `item.*` properties are specific to the rendered item. The most important being
+ * `item.selected`, which you can use to display the selected note in a different way.
  */
-export type ListRendererDepependency = ListRendererDatabaseDependency | 'item.size.width' | 'item.size.height' | 'item.selected' | 'note.titleHtml' | 'note.isWatched' | 'note.tags';
+export type ListRendererDependency = ListRendererDatabaseDependency | 'item.index' | 'item.selected' | 'item.size.height' | 'item.size.width' | 'note.folder.title' | 'note.isWatched' | 'note.tags' | 'note.todoStatusText' | 'note.titleHtml';
+export type ListRendererItemValueTemplates = Record<string, string>;
+export declare const columnNames: readonly ["note.folder.title", "note.is_todo", "note.latitude", "note.longitude", "note.source_url", "note.tags", "note.title", "note.todo_completed", "note.todo_due", "note.user_created_time", "note.user_updated_time"];
+export type ColumnName = typeof columnNames[number];
 export interface ListRenderer {
     /**
      * It must be unique to your plugin.
@@ -44,10 +45,15 @@ export interface ListRenderer {
      * height.
      */
     flow: ItemFlow;
+    /**
+     * Whether the renderer supports multiple columns. Applies only when `flow`
+     * is `topToBottom`. Defaults to `false`.
+     */
+    multiColumns?: boolean;
     /**
      * The size of each item must be specified in advance for performance
      * reasons, and cannot be changed afterwards. If the item flow is top to
-     * bottom, you only need to specificy the item height (the width will be
+     * bottom, you only need to specify the item height (the width will be
      * ignored).
      */
     itemSize: Size;
@@ -74,20 +80,97 @@ export interface ListRenderer {
      * that you do not add more than what you need since there is a performance
      * penalty for each property.
      */
-    dependencies: ListRendererDepependency[];
+    dependencies?: ListRendererDependency[];
+    headerTemplate?: string;
+    headerHeight?: number;
+    onHeaderClick?: OnClickHandler;
     /**
-     * This is the HTML template that will be used to render the note list item.
-     * This is a [Mustache template](https://github.com/janl/mustache.js) and it
-     * will receive the variable you return from `onRenderNote` as tags. For
-     * example, if you return a property named `formattedDate` from
-     * `onRenderNote`, you can insert it in the template using `Created date:
-     * {{formattedDate}}`.
+     * This property is set differently depending on the `multiColumns` property.
      *
-     * In order to get syntax highlighting working here, it's recommended
-     * installing an editor extension such as [es6-string-html VSCode
+     * ## If `multiColumns` is `false`
+     *
+     * There is only one column and the template is used to render the entire row.
+     *
+     * This is the HTML template that will be used to render the note list item. This is a [Mustache
+     * template](https://github.com/janl/mustache.js) and it will receive the variable you return
+     * from `onRenderNote` as tags. For example, if you return a property named `formattedDate` from
+     * `onRenderNote`, you can insert it in the template using `Created date: {{formattedDate}}`
+     *
+     * ## If `multiColumns` is `true`
+     *
+     * Since there is multiple columns, this template will be used to render each note property
+     * within the row. For example if the current columns are the Updated and Title properties, this
+     * template will be called once to render the updated time and a second time to render the
+     * title. To display the current property, the generic `value` property is provided - it will be
+     * replaced at runtime by the actual note property. To render something different depending on
+     * the note property, use `itemValueTemplate`. A minimal example would be
+     * `<span>{{value}}</span>` which will simply render the current property inside a span tag.
+     *
+     * In order to get syntax highlighting working here, it's recommended installing an editor
+     * extension such as [es6-string-html VSCode
      * extension](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html)
+     *
+     * ## Default property rendering
+     *
+     * Certain properties are automatically rendered once inserted in the Mustache template. Those
+     * are in particular all the date-related fields, such as `note.user_updated_time` or
+     * `note.todo_completed`. Internally, those are timestamps in milliseconds, however when
+     * rendered we display them as date/time strings using the user's preferred time format. Another
+     * notable auto-rendered property is `note.title` which is going to include additional HTML,
+     * such as the search markers.
+     *
+     * If you do not want this default rendering behaviour, for example if you want to display the
+     * raw timestamps in milliseconds, you can simply return custom properties from
+     * `onRenderNote()`. For example:
+     *
+     * ```typescript
+     * onRenderNote: async (props: any) => {
+     *     return {
+     *         ...props,
+     *         // Return the property under a different name
+     *         updatedTimeMs: props.note.user_updated_time,
+     *     }
+     * },
+     *
+     * itemTemplate: // html
+     *     `
+     *     <div>
+     *         Raw timestamp: {{updatedTimeMs}} <!-- This is **not** auto-rendered ->
+     *         Formatted time: {{note.user_updated_time}} <!-- This is -->
+     *     </div>
+     * `,
+     *
+     * ```
+     *
+     * See
+     * `[https://github.com/laurent22/joplin/blob/dev/packages/lib/services/noteList/renderViewProps.ts](renderViewProps.ts)`
+     * for the list of properties that have a default rendering.
      */
     itemTemplate: string;
+    /**
+     * This property applies only when `multiColumns` is `true`. It is used to render something
+     * different for each note property.
+     *
+     * This is a map of actual dependencies to templates - you only need to return something if the
+     * default, as specified in `template`, is not enough.
+     *
+     * Again you need to return a Mustache template and it will be combined with the `template`
+     * property to create the final template. For example if you return a property named
+     * `formattedDate` from `onRenderNote`, you can insert it in the template using
+     * `{{formattedDate}}`. This string will replace `{{value}}` in the `template` property.
+     *
+     * So if the template property is set to `<span>{{value}}</span>`, the final template will be
+     * `<span>{{formattedDate}}</span>`.
+     *
+     * The property would be set as so:
+     *
+     * ```javascript
+     * itemValueTemplates: {
+     *     'note.user_updated_time': '{{formattedDate}}',
+     * }
+     * ```
+     */
+    itemValueTemplates?: ListRendererItemValueTemplates;
     /**
      * This user-facing text is used for example in the View menu, so that your
      * renderer can be selected.
@@ -128,17 +211,15 @@ export interface ListRenderer {
      */
     onRenderNote: OnRenderNoteHandler;
     /**
-     * This handler allows adding some interacivity to the note renderer -
-     * whenever an input element within the item is changed (for example, when a
-     * checkbox is clicked, or a text input is changed), this `onChange` handler
-     * is going to be called.
+     * This handler allows adding some interactivity to the note renderer - whenever an input element
+     * within the item is changed (for example, when a checkbox is clicked, or a text input is
+     * changed), this `onChange` handler is going to be called.
      *
-     * You can inspect `event.elementId` to know which element had some changes,
-     * and `event.value` to know the new value. `event.noteId` also tells you
-     * what note is affected, so that you can potentially apply changes to it.
+     * You can inspect `event.elementId` to know which element had some changes, and `event.value`
+     * to know the new value. `event.noteId` also tells you what note is affected, so that you can
+     * potentially apply changes to it.
      *
-     * You specify the element ID, by setting a `data-id` attribute on the
-     * input.
+     * You specify the element ID, by setting a `data-id` attribute on the input.
      *
      * For example, if you have such a template:
      *
@@ -148,9 +229,26 @@ export interface ListRenderer {
      * </div>
      * ```
      *
-     * The event handler will receive an event with `elementId` set to
-     * `noteTitleInput`.
+     * The event handler will receive an event with `elementId` set to `noteTitleInput`.
+     *
+     * ## Default event handlers
+     *
+     * Currently one click event is automatically handled:
+     *
+     * If there is a checkbox with a `data-id="todo-checkbox"` attribute is present, it is going to
+     * automatically toggle the note to-do "completed" status.
+     *
+     * For example this is what is used in the default list renderer:
+     *
+     * `<input data-id="todo-checkbox" type="checkbox" {{#note.todo_completed}}checked="checked"{{/note.todo_completed}}>`
      */
     onChange?: OnChangeHandler;
 }
+export interface NoteListColumn {
+    name: ColumnName;
+    width: number;
+}
+export type NoteListColumns = NoteListColumn[];
+export declare const defaultWidth = 100;
+export declare const defaultListColumns: () => NoteListColumns;
 export {};

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/noteListType.ts

@@ -3,7 +3,7 @@
 import { Size } from './types';
 
 // AUTO-GENERATED by generate-database-type
-type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_data' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
+type ListRendererDatabaseDependency = 'folder.created_time' | 'folder.deleted_time' | 'folder.encryption_applied' | 'folder.encryption_cipher_text' | 'folder.icon' | 'folder.id' | 'folder.is_shared' | 'folder.master_key_id' | 'folder.parent_id' | 'folder.share_id' | 'folder.title' | 'folder.updated_time' | 'folder.user_created_time' | 'folder.user_data' | 'folder.user_updated_time' | 'folder.type_' | 'note.altitude' | 'note.application_data' | 'note.author' | 'note.body' | 'note.conflict_original_id' | 'note.created_time' | 'note.deleted_time' | 'note.encryption_applied' | 'note.encryption_cipher_text' | 'note.id' | 'note.is_conflict' | 'note.is_shared' | 'note.is_todo' | 'note.latitude' | 'note.longitude' | 'note.markup_language' | 'note.master_key_id' | 'note.order' | 'note.parent_id' | 'note.share_id' | 'note.source' | 'note.source_application' | 'note.source_url' | 'note.title' | 'note.todo_completed' | 'note.todo_due' | 'note.updated_time' | 'note.user_created_time' | 'note.user_data' | 'note.user_updated_time' | 'note.type_';
 // AUTO-GENERATED by generate-database-type
 
 export enum ItemFlow {
@@ -11,45 +11,68 @@ export enum ItemFlow {
 	LeftToRight = 'leftToRight',
 }
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 export type RenderNoteView = Record<string, any>;
 
 export interface OnChangeEvent {
 	elementId: string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	value: any;
 	noteId: string;
 }
 
+export interface OnClickEvent {
+	elementId: string;
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 export type OnRenderNoteHandler = (props: any)=> Promise<RenderNoteView>;
 export type OnChangeHandler = (event: OnChangeEvent)=> Promise<void>;
+export type OnClickHandler = (event: OnClickEvent)=> Promise<void>;
 
 /**
- * Most of these are the built-in note properties, such as `note.title`,
- * `note.todo_completed`, etc.
+ * Most of these are the built-in note properties, such as `note.title`, `note.todo_completed`, etc.
+ * complemented with special properties such as `note.isWatched`, to know if a note is currently
+ * opened in the external editor, and `note.tags` to get the list tags associated with the note.
  *
- * Additionally, the `item.*` properties are specific to the rendered item. The
- * most important being `item.selected`, which you can use to display the
- * selected note in a different way.
+ * The `note.todoStatusText` property is a localised description of the to-do status (e.g.
+ * "to-do, incomplete"). If you include an `<input type='checkbox' ... />` for to-do items that would
+ * otherwise be unlabelled, consider adding `note.todoStatusText` as the checkbox's `aria-label`.
  *
- * Finally some special properties are provided to make it easier to render
- * notes. In particular, if possible prefer `note.titleHtml` to `note.title`
- * since some important processing has already been done on the string, such as
- * handling the search highlighter and escaping. Since it's HTML and already
- * escaped you would insert it using `{{{titleHtml}}}` (triple-mustache syntax,
- * which disables escaping).
+ * ## Item properties
  *
- * `notes.tag` gives you the list of tags associated with the note.
- *
- * `note.isWatched` tells you if the note is currently opened in an external
- * editor. In which case you would generally display some indicator.
+ * The `item.*` properties are specific to the rendered item. The most important being
+ * `item.selected`, which you can use to display the selected note in a different way.
  */
-export type ListRendererDepependency =
+export type ListRendererDependency =
 	ListRendererDatabaseDependency |
-	'item.size.width' |
-	'item.size.height' |
+	'item.index' |
 	'item.selected' |
-	'note.titleHtml' |
+	'item.size.height' |
+	'item.size.width' |
+	'note.folder.title' |
 	'note.isWatched' |
-	'note.tags';
+	'note.tags' |
+	'note.todoStatusText' |
+	'note.titleHtml';
+
+export type ListRendererItemValueTemplates = Record<string, string>;
+
+export const columnNames = [
+	'note.folder.title',
+	'note.is_todo',
+	'note.latitude',
+	'note.longitude',
+	'note.source_url',
+	'note.tags',
+	'note.title',
+	'note.todo_completed',
+	'note.todo_due',
+	'note.user_created_time',
+	'note.user_updated_time',
+] as const;
+
+export type ColumnName = typeof columnNames[number];
 
 export interface ListRenderer {
 	/**
@@ -64,10 +87,16 @@ export interface ListRenderer {
 	 */
 	flow: ItemFlow;
 
+	/**
+	 * Whether the renderer supports multiple columns. Applies only when `flow`
+	 * is `topToBottom`. Defaults to `false`.
+	 */
+	multiColumns?: boolean;
+
 	/**
 	 * The size of each item must be specified in advance for performance
 	 * reasons, and cannot be changed afterwards. If the item flow is top to
-	 * bottom, you only need to specificy the item height (the width will be
+	 * bottom, you only need to specify the item height (the width will be
 	 * ignored).
 	 */
 	itemSize: Size;
@@ -96,22 +125,101 @@ export interface ListRenderer {
 	 * that you do not add more than what you need since there is a performance
 	 * penalty for each property.
 	 */
-	dependencies: ListRendererDepependency[];
+	dependencies?: ListRendererDependency[];
+
+	headerTemplate?: string;
+	headerHeight?: number;
+	onHeaderClick?: OnClickHandler;
 
 	/**
-	 * This is the HTML template that will be used to render the note list item.
-	 * This is a [Mustache template](https://github.com/janl/mustache.js) and it
-	 * will receive the variable you return from `onRenderNote` as tags. For
-	 * example, if you return a property named `formattedDate` from
-	 * `onRenderNote`, you can insert it in the template using `Created date:
-	 * {{formattedDate}}`.
+	 * This property is set differently depending on the `multiColumns` property.
 	 *
-	 * In order to get syntax highlighting working here, it's recommended
-	 * installing an editor extension such as [es6-string-html VSCode
+	 * ## If `multiColumns` is `false`
+	 *
+	 * There is only one column and the template is used to render the entire row.
+	 *
+	 * This is the HTML template that will be used to render the note list item. This is a [Mustache
+	 * template](https://github.com/janl/mustache.js) and it will receive the variable you return
+	 * from `onRenderNote` as tags. For example, if you return a property named `formattedDate` from
+	 * `onRenderNote`, you can insert it in the template using `Created date: {{formattedDate}}`
+	 *
+	 * ## If `multiColumns` is `true`
+	 *
+	 * Since there is multiple columns, this template will be used to render each note property
+	 * within the row. For example if the current columns are the Updated and Title properties, this
+	 * template will be called once to render the updated time and a second time to render the
+	 * title. To display the current property, the generic `value` property is provided - it will be
+	 * replaced at runtime by the actual note property. To render something different depending on
+	 * the note property, use `itemValueTemplate`. A minimal example would be
+	 * `<span>{{value}}</span>` which will simply render the current property inside a span tag.
+	 *
+	 * In order to get syntax highlighting working here, it's recommended installing an editor
+	 * extension such as [es6-string-html VSCode
 	 * extension](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html)
+	 *
+	 * ## Default property rendering
+	 *
+	 * Certain properties are automatically rendered once inserted in the Mustache template. Those
+	 * are in particular all the date-related fields, such as `note.user_updated_time` or
+	 * `note.todo_completed`. Internally, those are timestamps in milliseconds, however when
+	 * rendered we display them as date/time strings using the user's preferred time format. Another
+	 * notable auto-rendered property is `note.title` which is going to include additional HTML,
+	 * such as the search markers.
+	 *
+	 * If you do not want this default rendering behaviour, for example if you want to display the
+	 * raw timestamps in milliseconds, you can simply return custom properties from
+	 * `onRenderNote()`. For example:
+	 *
+	 * ```typescript
+	 * onRenderNote: async (props: any) => {
+	 *     return {
+	 *         ...props,
+	 *         // Return the property under a different name
+	 *         updatedTimeMs: props.note.user_updated_time,
+	 *     }
+	 * },
+	 *
+	 * itemTemplate: // html
+	 *     `
+	 *     <div>
+	 *         Raw timestamp: {{updatedTimeMs}} <!-- This is **not** auto-rendered ->
+	 *         Formatted time: {{note.user_updated_time}} <!-- This is -->
+	 *     </div>
+	 * `,
+	 *
+	 * ```
+	 *
+	 * See
+	 * `[https://github.com/laurent22/joplin/blob/dev/packages/lib/services/noteList/renderViewProps.ts](renderViewProps.ts)`
+	 * for the list of properties that have a default rendering.
 	 */
 	itemTemplate: string;
 
+	/**
+	 * This property applies only when `multiColumns` is `true`. It is used to render something
+	 * different for each note property.
+	 *
+	 * This is a map of actual dependencies to templates - you only need to return something if the
+	 * default, as specified in `template`, is not enough.
+	 *
+	 * Again you need to return a Mustache template and it will be combined with the `template`
+	 * property to create the final template. For example if you return a property named
+	 * `formattedDate` from `onRenderNote`, you can insert it in the template using
+	 * `{{formattedDate}}`. This string will replace `{{value}}` in the `template` property.
+	 *
+	 * So if the template property is set to `<span>{{value}}</span>`, the final template will be
+	 * `<span>{{formattedDate}}</span>`.
+	 *
+	 * The property would be set as so:
+	 *
+	 * ```javascript
+	 * itemValueTemplates: {
+	 *     'note.user_updated_time': '{{formattedDate}}',
+	 * }
+	 * ```
+	 */
+	itemValueTemplates?: ListRendererItemValueTemplates;
+
 	/**
 	 * This user-facing text is used for example in the View menu, so that your
 	 * renderer can be selected.
@@ -154,17 +262,15 @@ export interface ListRenderer {
 	onRenderNote: OnRenderNoteHandler;
 
 	/**
-	 * This handler allows adding some interacivity to the note renderer -
-	 * whenever an input element within the item is changed (for example, when a
-	 * checkbox is clicked, or a text input is changed), this `onChange` handler
-	 * is going to be called.
+	 * This handler allows adding some interactivity to the note renderer - whenever an input element
+	 * within the item is changed (for example, when a checkbox is clicked, or a text input is
+	 * changed), this `onChange` handler is going to be called.
 	 *
-	 * You can inspect `event.elementId` to know which element had some changes,
-	 * and `event.value` to know the new value. `event.noteId` also tells you
-	 * what note is affected, so that you can potentially apply changes to it.
+	 * You can inspect `event.elementId` to know which element had some changes, and `event.value`
+	 * to know the new value. `event.noteId` also tells you what note is affected, so that you can
+	 * potentially apply changes to it.
 	 *
-	 * You specify the element ID, by setting a `data-id` attribute on the
-	 * input.
+	 * You specify the element ID, by setting a `data-id` attribute on the input.
 	 *
 	 * For example, if you have such a template:
 	 *
@@ -174,8 +280,46 @@ export interface ListRenderer {
 	 * </div>
 	 * ```
 	 *
-	 * The event handler will receive an event with `elementId` set to
-	 * `noteTitleInput`.
+	 * The event handler will receive an event with `elementId` set to `noteTitleInput`.
+	 *
+	 * ## Default event handlers
+	 *
+	 * Currently one click event is automatically handled:
+	 *
+	 * If there is a checkbox with a `data-id="todo-checkbox"` attribute is present, it is going to
+	 * automatically toggle the note to-do "completed" status.
+	 *
+	 * For example this is what is used in the default list renderer:
+	 *
+	 * `<input data-id="todo-checkbox" type="checkbox" {{#note.todo_completed}}checked="checked"{{/note.todo_completed}}>`
 	 */
 	onChange?: OnChangeHandler;
 }
+
+export interface NoteListColumn {
+	name: ColumnName;
+	width: number;
+}
+
+export type NoteListColumns = NoteListColumn[];
+
+export const defaultWidth = 100;
+
+export const defaultListColumns = () => {
+	const columns: NoteListColumns = [
+		{
+			name: 'note.is_todo',
+			width: 30,
+		},
+		{
+			name: 'note.user_updated_time',
+			width: defaultWidth,
+		},
+		{
+			name: 'note.title',
+			width: 0,
+		},
+	];
+
+	return columns;
+};

packages/app-cli/tests/support/plugins/codemirror5-and-codemirror6/api/types.ts

@@ -26,6 +26,7 @@ export interface Command {
 	/**
 	 * Code to be ran when the command is executed. It may return a result.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	execute(...args: any[]): Promise<any | void>;
 
 	/**
@@ -115,11 +116,13 @@ export interface ExportModule {
 	/**
 	 * Called when an item needs to be processed. An "item" can be any Joplin object, such as a note, a folder, a notebook, etc.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	onProcessItem(context: ExportContext, itemType: number, item: any): Promise<void>;
 
 	/**
 	 * Called when a resource file needs to be exported.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	onProcessResource(context: ExportContext, resource: any, filePath: string): Promise<void>;
 
 	/**
@@ -181,13 +184,15 @@ export interface ExportContext {
 	options: ExportOptions;
 
 	/**
-	 * You can attach your own custom data using this propery - it will then be passed to each event handler, allowing you to keep state from one event to the next.
+	 * You can attach your own custom data using this property - it will then be passed to each event handler, allowing you to keep state from one event to the next.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	userData?: any;
 }
 
 export interface ImportContext {
 	sourcePath: string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	options: any;
 	warnings: string[];
 }
@@ -197,6 +202,7 @@ export interface ImportContext {
 // =================================================================
 
 export interface Script {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	onStart?(event: any): Promise<void>;
 }
 
@@ -227,6 +233,8 @@ export interface VersionInfo {
 	version: string;
 	profileVersion: number;
 	syncVersion: number;
+
+	platform: 'desktop'|'mobile';
 }
 
 // =================================================================
@@ -300,6 +308,7 @@ export interface MenuItem {
 	 * Arguments that should be passed to the command. They will be as rest
 	 * parameters.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	commandArgs?: any[];
 
 	/**
@@ -338,6 +347,8 @@ export type ButtonId = string;
 export enum ToolbarButtonLocation {
 	/**
 	 * This toolbar in the top right corner of the application. It applies to the note as a whole, including its metadata.
+	 *
+	 * <span class="platform-desktop">desktop</span>
 	 */
 	NoteToolbar = 'noteToolbar',
 
@@ -351,11 +362,13 @@ export type ViewHandle = string;
 
 export interface EditorCommand {
 	name: string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	value?: any;
 }
 
 export interface DialogResult {
 	id: ButtonId;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	formData?: any;
 }
 
@@ -371,6 +384,26 @@ export interface Rectangle {
 	height?: number;
 }
 
+export type ActivationCheckCallback = ()=> Promise<boolean>;
+
+export type UpdateCallback = ()=> Promise<void>;
+
+export type VisibleHandler = ()=> Promise<void>;
+
+export interface EditContextMenuFilterObject {
+	items: MenuItem[];
+}
+
+export interface EditorActivationCheckFilterObject {
+	activatedEditors: {
+		pluginId: string;
+		viewId: string;
+		isActive: boolean;
+	}[];
+}
+
+export type FilterHandler<T> = (object: T)=> Promise<T>;
+
 // =================================================================
 // Settings types
 // =================================================================
@@ -404,6 +437,7 @@ export enum SettingStorage {
 // Redefine a simplified interface to mask internal details
 // and to remove function calls as they would have to be async.
 export interface SettingItem {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	value: any;
 	type: SettingItemType;
 
@@ -440,6 +474,7 @@ export interface SettingItem {
 	 * This property is required when `isEnum` is `true`. In which case, it
 	 * should contain a map of value => label.
 	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	options?: Record<any, any>;
 
 	/**
@@ -497,6 +532,7 @@ export type Path = string[];
 // Content Script types
 // =================================================================
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 export type PostMessageHandler = (message: any)=> Promise<any>;
 
 /**
@@ -520,19 +556,66 @@ export interface ContentScriptContext {
 }
 
 export interface ContentScriptModuleLoadedEvent {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	userData?: any;
 }
 
 export interface ContentScriptModule {
 	onLoaded?: (event: ContentScriptModuleLoadedEvent)=> void;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	plugin: ()=> any;
 	assets?: ()=> void;
 }
 
 export interface MarkdownItContentScriptModule extends Omit<ContentScriptModule, 'plugin'> {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
 	plugin: (markdownIt: any, options: any)=> any;
 }
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+type EditorCommandCallback = (...args: any[])=> any;
+
+export interface CodeMirrorControl {
+	/** Points to a CodeMirror 6 EditorView instance. */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	editor: any;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	cm6: any;
+
+	/** `extension` should be a [CodeMirror 6 extension](https://codemirror.net/docs/ref/#state.Extension). */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	addExtension(extension: any|any[]): void;
+
+	supportsCommand(name: string): boolean;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+	execCommand(name: string, ...args: any[]): any;
+	registerCommand(name: string, callback: EditorCommandCallback): void;
+
+	joplinExtensions: {
+		/**
+		 * Returns a [CodeMirror 6 extension](https://codemirror.net/docs/ref/#state.Extension) that
+		 * registers the given [CompletionSource](https://codemirror.net/docs/ref/#autocomplete.CompletionSource).
+		 *
+		 * Use this extension rather than the built-in CodeMirror [`autocompletion`](https://codemirror.net/docs/ref/#autocomplete.autocompletion)
+		 * if you don't want to use [languageData-based autocompletion](https://codemirror.net/docs/ref/#autocomplete.autocompletion^config.override).
+		 *
+		 * Using `autocompletion({ override: [ ... ]})` causes errors when done by multiple plugins.
+		 */
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+		completionSource(completionSource: any): any;
+
+		/**
+		 * Creates an extension that enables or disables [`languageData`-based autocompletion](https://codemirror.net/docs/ref/#autocomplete.autocompletion^config.override).
+		 */
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied
+		enableLanguageDataAutocomplete: { of: (enabled: boolean)=> any };
+	};
+}
+
+export interface MarkdownEditorContentScriptModule extends Omit<ContentScriptModule, 'plugin'> {
+	plugin: (editorControl: CodeMirrorControl)=> void;
+}
+
 export enum ContentScriptType {
 	/**
 	 * Registers a new Markdown-It plugin, which should follow the template
@@ -573,6 +656,45 @@ export enum ContentScriptType {
 	 *   plugin](https://github.com/laurent22/joplin/blob/dev/packages/renderer/MdToHtml/rules/mermaid.ts)
 	 *   to see how the data should be structured.
 	 *
+	 * ## Supporting the Rich Text Editor
+	 *
+	 * Joplin's Rich Text Editor works with rendered HTML, which is converted back
+	 * to markdown when saving. To prevent the original markdown for your plugin from
+	 * being lost, Joplin needs additional metadata.
+	 *
+	 * To provide this,
+	 * 1. Wrap the HTML generated by your plugin in an element with class `joplin-editable`.
+	 *    For example,
+	 *    ```html
+	 *    <div class="joplin-editable">
+	 *        ...your html...
+	 *    </div>
+	 *    ```
+	 * 2. Add a child with class `joplin-source` that contains the original markdown that
+	 *    was rendered by your plugin. Include `data-joplin-source-open`, `data-joplin-source-close`,
+	 *    and `data-joplin-language` attributes.
+	 *    For example, if your plugin rendered the following code block,
+	 *    ````
+	 *    ```foo
+	 *    ... original source here ...
+	 *    ```
+	 *    ````
+	 *    then it should render to
+	 *    ```html
+	 *    <div class="joplin-editable">
+	 *        <pre
+	 *            class="joplin-source"
+	 *            data-joplin-language="foo"
+	 *            data-joplin-source-open="```foo&NewLine;"
+	 *            data-joplin-source-close="```"
+	 *        > ... original source here ... </pre>
+	 *        ... rendered HTML here ...
+	 *    </div>
+	 *    ```
+	 *
+	 * See [the demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/content_script)
+	 * for a complete example.
+	 *
 	 * ## Getting the settings from the renderer
 	 *
 	 * You can access your plugin settings from the renderer by calling
@@ -647,21 +769,21 @@ export enum ContentScriptType {
 	 * }
 	 * ```
 	 *
-	 * - The `context` argument is currently unused but could be used later on
-	 *   to provide access to your own plugin so that the content script and
-	 *   plugin can communicate.
+	 * - The `context` argument allows communicating with other parts of
+	 *   your plugin (see below).
 	 *
 	 * - The `plugin` key is your CodeMirror plugin. This is where you can
 	 *   register new commands with CodeMirror or interact with the CodeMirror
 	 *   instance as needed.
 	 *
-	 * - The `codeMirrorResources` key is an array of CodeMirror resources that
+	 * - **CodeMirror 5 only**: The `codeMirrorResources` key is an array of CodeMirror resources that
 	 *   will be loaded and attached to the CodeMirror module. These are made up
 	 *   of addons, keymaps, and modes. For example, for a plugin that want's to
 	 *   enable clojure highlighting in code blocks. `codeMirrorResources` would
 	 *   be set to `['mode/clojure/clojure']`.
+	 *   This field is ignored on mobile and when the desktop beta editor is enabled.
 	 *
-	 * - The `codeMirrorOptions` key contains all the
+	 * - **CodeMirror 5 only**: The `codeMirrorOptions` key contains all the
 	 *   [CodeMirror](https://codemirror.net/doc/manual.html#config) options
 	 *   that will be set or changed by this plugin. New options can alse be
 	 *   declared via
@@ -679,9 +801,11 @@ export enum ContentScriptType {
 	 * must be provided for the plugin to be valid. Having multiple or all
 	 * provided is also okay.
 	 *
-	 * See also the [demo
-	 * plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
-	 * for an example of all these keys being used in one plugin.
+	 * See also:
+	 * - The [demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
+	 *   for an example of all these keys being used in one plugin.
+	 * - See [the editor plugin tutorial](https://joplinapp.org/help/api/tutorials/cm6_plugin)
+	 *   for how to develop a plugin for the mobile editor and the desktop beta markdown editor.
 	 *
 	 * ## Posting messages from the content script to your plugin
 	 *

packages/app-cli/tests/support/plugins/codemirror6/api/Joplin.d.ts

@@ -68,6 +68,8 @@ export default class Joplin {
      * - [fs-extra](https://www.npmjs.com/package/fs-extra)
      *
      * [View the demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/nativeModule)
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     require(_path: string): any;
     versionInfo(): Promise<import("./types").VersionInfo>;

packages/app-cli/tests/support/plugins/codemirror6/api/JoplinClipboard.d.ts

@@ -4,14 +4,20 @@ export default class JoplinClipboard {
     constructor(electronClipboard: any, electronNativeImage: any);
     readText(): Promise<string>;
     writeText(text: string): Promise<void>;
+    /** <span class="platform-desktop">desktop</span> */
     readHtml(): Promise<string>;
+    /** <span class="platform-desktop">desktop</span> */
     writeHtml(html: string): Promise<void>;
     /**
      * Returns the image in [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) format.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     readImage(): Promise<string>;
     /**
      * Takes an image in [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) format.
+     *
+     * <span class="platform-desktop">desktop</span>
      */
     writeImage(dataUrl: string): Promise<void>;
     /**

packages/app-cli/tests/support/plugins/codemirror6/api/JoplinCommands.d.ts

@@ -1,4 +1,5 @@
 import { Command } from './types';
+import Plugin from '../Plugin';
 /**
  * This class allows executing or registering new Joplin commands. Commands
  * can be executed or associated with
@@ -20,6 +21,12 @@ import { Command } from './types';
  * To view what arguments are supported, you can open any of these files
  * and look at the `execute()` command.
  *
+ * Note that many of these commands only work on desktop. The more limited list of mobile
+ * commands can be found in these places:
+ *
+ * * [Global commands](https://github.com/laurent22/joplin/tree/dev/packages/app-mobile/commands)
+ * * [Editor commands](https://github.com/laurent22/joplin/blob/dev/packages/app-mobile/components/NoteEditor/commandDeclarations.ts)
+ *
  * ## Executing editor commands
  *
  * There might be a situation where you want to invoke editor commands
@@ -49,9 +56,10 @@ import { Command } from './types';
  *
  */
 export default class JoplinCommands {
+    private plugin_;
+    constructor(plugin_: Plugin);
     /**
-     * <span class="platform-desktop">desktop</span> Executes the given
-     * command.
+     * Executes the given command.
      *
      * The command can take any number of arguments, and the supported
      * arguments will vary based on the command. For custom commands, this
@@ -70,7 +78,7 @@ export default class JoplinCommands {
      */
     execute(commandName: string, ...args: any[]): Promise<any | void>;
     /**
-     * <span class="platform-desktop">desktop</span> Registers a new command.
+     * Registers a new command.
      *
      * ```typescript
      * // Register a new commmand called "testCommand1"

packages/app-cli/tests/support/plugins/codemirror6/api/JoplinContentScripts.d.ts

@@ -21,7 +21,8 @@ export default class JoplinContentScripts {
      * for more information.
      *
      * * [View the renderer demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/content_script)
-     * * [View the editor demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
+     * * [View the editor plugin tutorial](https://joplinapp.org/help/api/tutorials/cm6_plugin)
+     * * [View the legacy editor demo plugin](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/codemirror_content_script)
      *
      * See also the [postMessage demo](https://github.com/laurent22/joplin/tree/dev/packages/app-cli/tests/support/plugins/post_messages)
      *

packages/app-cli/tests/support/plugins/codemirror6/api/JoplinData.d.ts

@@ -13,7 +13,7 @@ import { Path } from './types';
  * In general you would use the methods in this class as if you were using a REST API. There are four methods that map to GET, POST, PUT and DELETE calls.
  * And each method takes these parameters:
  *
- * * `path`: This is an array that represents the path to the resource in the form `["resouceName", "resourceId", "resourceLink"]` (eg. ["tags", ":id", "notes"]). The "resources" segment is the name of the resources you want to access (eg. "notes", "folders", etc.). If not followed by anything, it will refer to all the resources in that collection. The optional "resourceId" points to a particular resources within the collection. Finally, an optional "link" can be present, which links the resource to a collection of resources. This can be used in the API for example to retrieve all the notes associated with a tag.
+ * * `path`: This is an array that represents the path to the resource in the form `["resourceName", "resourceId", "resourceLink"]` (eg. ["tags", ":id", "notes"]). The "resources" segment is the name of the resources you want to access (eg. "notes", "folders", etc.). If not followed by anything, it will refer to all the resources in that collection. The optional "resourceId" points to a particular resources within the collection. Finally, an optional "link" can be present, which links the resource to a collection of resources. This can be used in the API for example to retrieve all the notes associated with a tag.
  * * `query`: (Optional) The query parameters. In a URL, this is the part after the question mark "?". In this case, it should be an object with key/value pairs.
  * * `data`: (Optional) Applies to PUT and POST calls only. The request body contains the data you want to create or modify, for example the content of a note or folder.
  * * `files`: (Optional) Used to create new resources and associate them with files.

packages/app-cli/tests/support/plugins/codemirror6/api/JoplinFilters.d.ts

@@ -1,3 +1,4 @@
+import { FilterHandler } from '../../../eventManager';
 /**
  * @ignore
  *
@@ -5,6 +6,6 @@
  * so for now disable filters.
  */
 export default class JoplinFilters {
-    on(name: string, callback: Function): Promise<void>;
-    off(name: string, callback: Function): Promise<void>;
+    on(name: string, callback: FilterHandler): Promise<void>;
+    off(name: string, callback: FilterHandler): Promise<void>;
 }

packages/app-cli/tests/support/plugins/codemirror6/api/JoplinImaging.d.ts

@@ -1,12 +1,33 @@
 import { Rectangle } from './types';
-export interface Implementation {
-    nativeImage: any;
-}
 export interface CreateFromBufferOptions {
     width?: number;
     height?: number;
     scaleFactor?: number;
 }
+export interface CreateFromPdfOptions {
+    /**
+     * The first page to export. Defaults to `1`, the first page in
+     * the document.
+     */
+    minPage?: number;
+    /**
+     * The number of the last page to convert. Defaults to the last page
+     * if not given.
+     *
+     * If `maxPage` is greater than the number of pages in the PDF, all pages
+     * in the PDF will be converted to images.
+     */
+    maxPage?: number;
+    scaleFactor?: number;
+}
+export interface PdfInfo {
+    pageCount: number;
+}
+export interface Implementation {
+    createFromPath: (path: string) => Promise<unknown>;
+    createFromPdf: (path: string, options: CreateFromPdfOptions) => Promise<unknown[]>;
+    getPdfInfo: (path: string) => Promise<PdfInfo>;
+}
 export interface ResizeOptions {
     width?: number;
     height?: number;
@@ -24,6 +45,7 @@ export type Handle = string;
  * [View the
  * example](https://github.com/laurent22/joplin/blob/dev/packages/app-cli/tests/support/plugins/imaging/src/index.ts)
  *
+ * <span class="platform-desktop">desktop</span>
  */
 export default class JoplinImaging {
     private implementation_;
@@ -32,11 +54,20 @@ export default class JoplinImaging {
     private createImageHandle;
     private imageByHandle;
     private cacheImage;
+    /**
+     * Creates an image from the provided path. Note that images and PDFs are supported. If you
+     * provide a URL instead of a local path, the file will be downloaded first then converted to an
+     * image.
+     */
     createFromPath(filePath: string): Promise<Handle>;
     createFromResource(resourceId: string): Promise<Handle>;
+    createFromPdfPath(path: string, options?: CreateFromPdfOptions): Promise<Handle[]>;
+    createFromPdfResource(resourceId: string, options?: CreateFromPdfOptions): Promise<Handle[]>;
+    getPdfInfoFromPath(path: string): Promise<PdfInfo>;
+    getPdfInfoFromResource(resourceId: string): Promise<PdfInfo>;
     getSize(handle: Handle): Promise<any>;
     resize(handle: Handle, options?: ResizeOptions): Promise<string>;
-    crop(handle: Handle, rectange: Rectangle): Promise<string>;
+    crop(handle: Handle, rectangle: Rectangle): Promise<string>;
     toPngFile(handle: Handle, filePath: string): Promise<void>;
     /**
      * Quality is between 0 and 100
@@ -57,5 +88,5 @@ export default class JoplinImaging {
      * Image data is not automatically deleted by Joplin so make sure you call
      * this method on the handle once you are done.
      */
-    free(handle: Handle): Promise<void>;
+    free(handles: Handle[] | Handle): Promise<void>;
 }