chore: update TypeScript to 5.5 (#759)

Notably for us, TypeScript 5.5 introduces the [`@import` JSDoc tag][0],
which we can start using.

This required us to upgrade Typedoc and fix a small type error.

[0]: https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/#the-jsdoc-import-tag

package.json

@@ -144,10 +144,10 @@
     "streamx": "^2.15.1",
     "tempy": "^3.1.0",
     "ts-proto": "^1.156.7",
-    "typedoc": "^0.25.13",
-    "typedoc-plugin-markdown": "^3.17.1",
-    "typedoc-plugin-missing-exports": "^2.2.0",
-    "typescript": "^5.4.5",
+    "typedoc": "^0.26.6",
+    "typedoc-plugin-markdown": "^4.2.5",
+    "typedoc-plugin-missing-exports": "^3.0.0",
+    "typescript": "^5.5.4",
     "yazl": "^2.5.1"
   },
   "dependencies": {

test-e2e/project-crud.js

@@ -13,6 +13,7 @@ import {
 import { round } from './utils.js'
 import { generate } from '@mapeo/mock-data'
 import { setTimeout as delay } from 'timers/promises'
+/** @import { MapeoDoc } from '@mapeo/schema' */
 
 /** @satisfies {Array<import('@mapeo/schema').MapeoValue>} */
 const fixtures = [
@@ -102,6 +103,7 @@ test('CRUD operations', async (t) => {
       const project = await manager.getProject(projectId)
       /** @type {any[]} */
       const updates = []
+      /** @type {Promise<MapeoDoc>[]} */
       const writePromises = []
       project[schemaName].on('updated-docs', (docs) => updates.push(...docs))
       let i = 0
@@ -278,6 +280,7 @@ test('CRUD operations', async (t) => {
     await t.test(`create and delete ${schemaName}`, async () => {
       const projectId = await manager.createProject()
       const project = await manager.getProject(projectId)
+      /** @type {Promise<MapeoDoc>[]} */
       const writePromises = []
       let i = 0
       while (i++ < CREATE_COUNT) {