Add workaround for Shiki being a DOM project

Author: Gerrit0

.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
               with:
                   node-version: ${{ matrix.node }}
             - name: Install
-              run: npm ci --legacy-peer-deps
+              run: npm ci
             - name: Build
               run: npm run build
             - name: Test
@@ -43,7 +43,7 @@ jobs:
             - name: Upgrade npm
               run: npm i -g npm@latest
             - name: Install
-              run: npm ci --legacy-peer-deps
+              run: npm ci
             - name: Build
               run: npm run build
             - name: Test

.github/workflows/publish-beta.yml

@@ -24,7 +24,7 @@ jobs:
               run: npm i -g npm@latest
             - name: Install
               if: steps.check.outputs.changed == 'true' && contains(steps.check.outputs.version, 'beta')
-              run: npm ci --legacy-peer-deps
+              run: npm ci
             - name: Setup publish token
               if: steps.check.outputs.changed == 'true' && contains(steps.check.outputs.version, 'beta')
               run: echo "//registry.npmjs.org/:_authToken=${NPM_AUTH_TOKEN}" > .npmrc

.github/workflows/publish-lts.yml

@@ -24,7 +24,7 @@ jobs:
               run: npm i -g npm@latest
             - name: Install
               if: steps.check.outputs.changed == 'true'
-              run: npm ci --legacy-peer-deps
+              run: npm ci
             - name: Setup publish token
               if: steps.check.outputs.changed == 'true'
               run: echo "//registry.npmjs.org/:_authToken=${NPM_AUTH_TOKEN}" > .npmrc

.github/workflows/publish.yml

@@ -23,7 +23,7 @@ jobs:
                   node-version: "18"
             - name: Install
               if: steps.check.outputs.changed == 'true'
-              run: npm ci --legacy-peer-deps
+              run: npm ci
             - name: Setup publish token
               if: steps.check.outputs.changed == 'true'
               run: echo "//registry.npmjs.org/:_authToken=${NPM_AUTH_TOKEN}" > .npmrc

.github/workflows/visual-regression.yml

@@ -16,15 +16,15 @@ jobs:
               run: |
                   git fetch
                   git checkout origin/$GITHUB_BASE_REF
-                  npm ci --legacy-peer-deps
+                  npm ci
                   npm run build
                   node dist/test/capture-screenshots.js
                   npm run test:visual:accept
 
             - name: Get current screenshots
               run: |
                   git checkout $GITHUB_SHA
-                  npm ci --legacy-peer-deps
+                  npm ci
                   npm run build
                   node dist/test/capture-screenshots.js
             - name: Test

.npmrc

@@ -3,3 +3,6 @@
 # an install, so just turn it off. We can still check for findings
 # with npm audit --production.
 audit = false
+
+# While we're on the TS beta, need this flag.
+legacy-peer-deps = true

package-lock.json

@@ -27,7 +27,7 @@
     "lunr": "^2.3.9",
     "markdown-it": "^14.1.0",
     "minimatch": "^9.0.4",
-    "shiki": "^1.3.0"
+    "shiki": "^1.4.0"
   },
   "peerDependencies": {
     "typescript": "4.6.x || 4.7.x || 4.8.x || 4.9.x || 5.0.x || 5.1.x || 5.2.x || 5.3.x || 5.4.x || 5.5.x"

package.json

@@ -0,0 +1,19 @@
+// Shiki 1.x declares a `loadWasm` function which takes these types as input.
+// They are declared in the DOM library, but since TypeDoc doesn't use that library,
+// we have to declare some shims, intentionally crafted to not be accidentally
+// constructed.
+
+declare namespace WebAssembly {
+    interface Instance {
+        __shikiHack: never;
+        exports: unknown;
+    }
+    interface WebAssemblyInstantiatedSource {
+        __shikiHack: never;
+    }
+    type ImportValue = unknown;
+}
+
+interface Response {
+    __shikiHack: never;
+}

src/lib/types/shiki/shiki.d.ts

@@ -10,8 +10,7 @@
         // Speed up dev compilation time
         "incremental": true,
         "tsBuildInfoFile": "dist/.tsbuildinfo",
-        // Shiki's types are broken again, https://github.com/shikijs/shiki/issues/665
-        "skipLibCheck": true,
+        "skipLibCheck": false,
 
         "strict": true,
         "alwaysStrict": true,