chore: Migrate to typescript

.eslintrc.cjs

@@ -4,5 +4,14 @@ module.exports = {
 	],
 	globals: {
 		appName: true,
-	}
+	},
+	overrides: [
+		{
+			files: ['*.ts', '*.vue'],
+			rules: {
+				'jsdoc/require-jsdoc': 'off',
+				'jsdoc/require-param': 'off',
+			},
+		},
+	],
 }

src/Photos.vue

@@ -111,7 +111,7 @@
 	</NcContent>
 </template>
 
-<script>
+<script lang='ts'>
 import { getCurrentUser } from '@nextcloud/auth'
 import { generateUrl } from '@nextcloud/router'
 import { loadState } from '@nextcloud/initial-state'

src/PhotosPublic.vue

@@ -19,7 +19,7 @@
 	</NcContent>
 </template>
 
-<script>
+<script lang='ts'>
 import { generateUrl } from '@nextcloud/router'
 
 import { NcContent, NcAppContent } from '@nextcloud/vue'

src/components/Actions/ActionDownload.vue

@@ -12,7 +12,7 @@
 	</NcActionLink>
 </template>
 
-<script>
+<script lang='ts'>
 import { mapGetters } from 'vuex'
 
 import { generateUrl } from '@nextcloud/router'

src/components/Actions/ActionFavorite.vue

@@ -19,7 +19,7 @@
 	</NcActionButton>
 </template>
 
-<script>
+<script lang='ts'>
 import { mapActions, mapGetters } from 'vuex'
 import Star from 'vue-material-design-icons/Star.vue'
 

src/components/Albums/AlbumForm.vue

@@ -74,7 +74,7 @@
 		</template>
 	</CollaboratorsSelectionForm>
 </template>
-<script>
+<script lang='ts'>
 import { mapActions } from 'vuex'
 
 import MapMarker from 'vue-material-design-icons/MapMarker.vue'
@@ -87,6 +87,8 @@
 import { generateRemoteUrl } from '@nextcloud/router'
 
 import CollaboratorsSelectionForm from './CollaboratorsSelectionForm.vue'
+import type { Album, Collaborator } from '../../store/albums'
+import type { PropType } from 'vue'
 
 export default {
 	name: 'AlbumForm',
@@ -102,9 +104,8 @@
 	},
 
 	props: {
-		/** @type {import('vue').PropType<import('../../store/albums.js').Album|null>} */
 		album: {
-			type: Object,
+			type: Object as PropType<Album|null>,
 			default: null,
 		},
 		displayBackButton: {
@@ -123,24 +124,15 @@
 	},
 
 	computed: {
-		/**
-		 * @return {boolean} Whether sharing is enabled.
-		 */
-		editMode() {
+		editMode(): boolean {
 			return this.album !== null
 		},
 
-		/**
-		 * @return {boolean} Whether sharing is enabled.
-		 */
-		sharingEnabled() {
+		sharingEnabled(): boolean {
 			return OC.Share !== undefined
 		},
 
-		/**
-		 * @return {string} The album's filename based on its name. Useful to fetch the location information and content.
-		 */
-		albumFileName() {
+		albumFileName(): string {
 			return this.$store.getters.getAlbumName(this.albumName)
 		},
 	},
@@ -159,8 +151,7 @@
 	methods: {
 		...mapActions(['createCollection', 'renameCollection', 'updateCollection']),
 
-		/** @param {import('../../store/albums.js').Collaborator[]} collaborators */
-		submit(collaborators = []) {
+		submit(collaborators: Collaborator[] = []) {
 			if (this.albumName === '' || this.loading) {
 				return
 			}
@@ -172,8 +163,7 @@
 			}
 		},
 
-		/** @param {import('../../store/albums.js').Collaborator[]} collaborators */
-		async handleCreateAlbum(collaborators = []) {
+		async handleCreateAlbum(collaborators: Collaborator[] = []) {
 			try {
 				this.loading = true
 				let album = await this.createCollection({

src/components/Albums/AlbumPicker.vue

@@ -50,7 +50,7 @@
 		@done="albumCreatedHandler" />
 </template>
 
-<script>
+<script lang='ts'>
 import { mapGetters } from 'vuex'
 import Plus from 'vue-material-design-icons/Plus.vue'
 import ImageMultiple from 'vue-material-design-icons/ImageMultiple.vue'
@@ -62,6 +62,7 @@
 
 import FetchCollectionsMixin from '../../mixins/FetchCollectionsMixin.js'
 import AlbumForm from './AlbumForm.vue'
+import type { Album } from '../../store/albums.js'
 
 export default {
 	name: 'AlbumPicker',
@@ -77,11 +78,7 @@
 	},
 
 	filters: {
-		/**
-		 * @param {string} fileId - The id of the file.
-		 * @return {string}
-		 */
-		toCoverUrl(fileId) {
+		toCoverUrl(fileId: string): string {
 			return generateUrl(`/apps/photos/api/v1/preview/${fileId}?x=${64}&y=${64}`)
 		},
 	},
@@ -102,10 +99,7 @@
 			'sharedAlbums',
 		]),
 
-		/**
-		 * @return {import('../../store/albums.js').Album[]}
-		 */
-		allAlbums() {
+		allAlbums(): Album[] {
 			return [...Object.values(this.albums), ...Object.values(this.sharedAlbums)]
 		},
 	},
@@ -125,23 +119,15 @@
 			this.fetchAlbumList()
 		},
 
-		pickAlbum(album) {
+		pickAlbum(album: Album) {
 			this.$emit('album-picked', album)
 		},
 
-		/**
-		 * @param {object} album
-		 * @return {boolean}
-		 */
-		isSharedAlbum(album) {
+		isSharedAlbum(album: Album): boolean {
 			return album.filename.match(/^\/photos\/.+\/sharedalbums\//) !== null
 		},
 
-		/**
-		 * @param {object} album The album's full name, including the userid.
-		 * @return {string} The album name without the userId between parentheses.
-		 */
-		originalName(album) {
+		originalName(album: Album): string {
 			if (this.isSharedAlbum(album)) {
 				return album.basename.replace(new RegExp(`\\(${album.collaborators[0].id}\\)$`), '')
 			} else {