fix: lint code

- disable new jsdoc rules
- wrap some jsdoc inline tags
- cleanup redundant close-on-click-outside

Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>

eslint.config.mjs

@@ -44,8 +44,13 @@ export default [
 			'@typescript-eslint/no-unused-expressions': 'off', // non-fixable
 			'@typescript-eslint/no-unused-vars': 'off', // non-fixable
 			'@typescript-eslint/no-use-before-define': 'off', // non-fixable
+			'jsdoc/check-tag-names': 'off', // need to respect JS
+			'jsdoc/reject-function-type': 'off', // need to respect JS
+			'jsdoc/reject-any-type': 'off', // need to respect JS
+			'jsdoc/require-function-type': 'off', // need to respect JS
 			'jsdoc/require-param-type': 'off', // need to respect JS
 			'jsdoc/require-param-description': 'off', // need to respect JS
+			'jsdoc/require-throws-type': 'off', // need to respect JS
 			'no-console': 'off', // non-fixable
 			'no-unused-vars': 'off', // non-fixable
 			'no-use-before-define': 'off', // non-fixable

src/components/ExtendOneToOneDialog.vue

@@ -74,8 +74,7 @@ async function extendOneToOneConversation() {
 <template>
 	<NcPopover
 		:container="container"
-		popup-role="dialog"
+		popup-role="dialog">
-		close-on-click-outside>
 		<template #trigger>
 			<NcButton
 				variant="tertiary"

src/components/GuestWelcomeWindow.vue

@@ -6,7 +6,6 @@
 <template>
 	<NcModal
 		no-close
-		:close-on-click-outside="false"
 		:label-id="dialogHeaderId"
 		size="small">
 		<div class="modal__content">

src/components/NewMessage/NewMessageUploadEditor.vue

@@ -8,7 +8,6 @@
 		v-if="showModal"
 		ref="modal"
 		:size="isVoiceMessage ? 'small' : 'normal'"
-		:close-on-click-outside="false"
 		:label-id="dialogHeaderId"
 		@close="handleDismiss">
 		<div

src/components/SetGuestUsername.vue

@@ -111,7 +111,7 @@ EventBus.once('joined-conversation', () => {
 	}
 })
 
-/** Update guest displayName from public event (e.g. @nextcloud/auth) */
+/** Update guest displayName from public event (e.g. `@nextcloud/auth`) */
 subscribe('user:info:changed', updateDisplayNameFromPublicEvent)
 onBeforeUnmount(() => {
 	unsubscribe('user:info:changed', updateDisplayNameFromPublicEvent)

src/services/conversationsService.ts

@@ -375,7 +375,7 @@ async function changeListable(token: string, scope: setConversationListableParam
 }
 
 /**
- * Set mention permissions to allow or disallow mentioning @all for non-moderators
+ * Set mention permissions to allow or disallow mentioning `@all` for non-moderators
  *
  * @param token The token of the conversation to be modified
  * @param mentionPermissions The mention permissions to set

src/stores/actor.ts

@@ -99,7 +99,7 @@ export const useActorStore = defineStore('actor', () => {
 	/**
 	 * Set the actor from the current user
 	 *
-	 * @param user A NextcloudUser object as returned by @nextcloud/auth
+	 * @param user A NextcloudUser object as returned by `@nextcloud/auth`
 	 * @param user.uid The user id of the user
 	 * @param user.displayName The display name of the user
 	 */

src/utils/e2ee/JitsiEncryptionWorkerContext.js

@@ -217,8 +217,8 @@ export class Context {
 	async _decryptFrame(
 		encodedFrame,
 		keyIndex,
-			initialKey = undefined,
+		initialKey = undefined,
-			ratchetCount = 0,
+		ratchetCount = 0,
 	) {
 		const { encryptionKey } = this._cryptoKeyRing[keyIndex]
 		let { material } = this._cryptoKeyRing[keyIndex]

src/utils/handleUrl.ts

@@ -10,7 +10,7 @@ import { t } from '@nextcloud/l10n'
 import { generateUrl, getBaseUrl } from '@nextcloud/router'
 
 /**
- * Generate a full absolute link with @nextcloud/router.generateUrl
+ * Generate a full absolute link with `@nextcloud/router` generateUrl()
  *
  * @param url - path
  * @param params - parameters to be replaced into the address

src/utils/webrtc/simplewebrtc/simplewebrtc.js

@@ -61,9 +61,9 @@ export default function SimpleWebRTC(opts) {
 	// Note that this is a coarse check; calling "getScreenMedia" may fail even
 	// if "supportScreenSharing" is true.
 	const screenSharingSupported
-			= (window.navigator.mediaDevices && window.navigator.mediaDevices.getDisplayMedia)
+		= (window.navigator.mediaDevices && window.navigator.mediaDevices.getDisplayMedia)
-				|| (window.navigator.webkitGetUserMedia)
+			|| (window.navigator.webkitGetUserMedia)
-				|| (window.navigator.userAgent.match('Firefox'))
+			|| (window.navigator.userAgent.match('Firefox'))
 	webrtcSupport.supportScreenSharing = window.location.protocol === 'https:' && screenSharingSupported
 
 	// attach detected support for convenience