ci(superdoc): enroll use-password-prompt.js under checkJs gate (SD-2866) (#3050)

Third file under the SD-2863 ratchet. Closes 8 errors that the probe
surfaced:

- The internal queue's element type lacked the `originalException`
  field that handleEncryptionError pushes onto each entry. Real drift:
  the JSDoc said `{ doc, errorCode }` but the runtime stored
  `{ doc, errorCode, originalException }` and the value was read again
  in onUnhandled. Promoted to a named QueueEntry typedef with the
  field properly declared.
- queue.shift() returns undefined when empty; added a fast-path early
  return after the shift so the rest of the function can rely on a
  defined entry.
- The lazy import of PasswordPromptSurface.vue now goes through the
  *.vue ambient shim added in SD-2865 and casts the default export to
  object before passing to markRaw().

Stacks on caio/SD-2865-checkjs-find-replace because SD-2865 introduced
the *.vue shim.

Author: caio-pizzol

packages/superdoc/scripts/check-jsdoc.cjs

@@ -41,6 +41,7 @@ const { spawnSync } = require('child_process');
 const CHECKED_FILES = [
   'src/helpers/schema-introspection.js',
   'src/composables/use-find-replace.js',
+  'src/composables/use-password-prompt.js',
 ];
 
 const packageDir = path.resolve(__dirname, '..');

packages/superdoc/src/composables/use-password-prompt.js

@@ -1,3 +1,4 @@
+// @ts-check
 import { shallowRef, markRaw } from 'vue';
 
 /** @typedef {import('../core/types').PasswordPromptConfig} PasswordPromptConfig */
@@ -41,7 +42,16 @@ const DEFAULT_TEXTS = {
 export function usePasswordPrompt({ getSurfaceManager, getPasswordPromptConfig, onUnhandled }) {
   // ---- internal state -------------------------------------------------------
 
-  /** @type {Array<{ doc: any, errorCode: string }>} */
+  /**
+   * Pending password-prompt request waiting for a free `activePrompt` slot.
+   * `originalException` is preserved so `onUnhandled` can re-emit the host's
+   * original exception payload verbatim if the prompt cannot render.
+   * @typedef {Object} QueueEntry
+   * @property {any} doc
+   * @property {string} errorCode
+   * @property {{ error?: Error, editor?: any }} [originalException]
+   */
+  /** @type {QueueEntry[]} */
   const queue = [];
 
   /** @type {import('vue').ShallowRef<{ doc: any, surfaceHandle: any } | null>} */
@@ -128,6 +138,7 @@ export function usePasswordPrompt({ getSurfaceManager, getPasswordPromptConfig,
     if (queue.length === 0) return;
 
     const entry = queue.shift();
+    if (!entry) return;
     showPrompt(entry).catch((err) => {
       // Surface errors (e.g. from a consumer's resolver or invalid config)
       // as console errors rather than letting them become unhandled rejections.
@@ -233,8 +244,11 @@ export function usePasswordPrompt({ getSurfaceManager, getPasswordPromptConfig,
     } else {
       // Built-in component — use ariaLabelledBy pointing to the component's
       // reactive heading, so the accessible name updates after a bad password
-      // (e.g. "Password Required" → "Incorrect Password").
-      const { default: PasswordPromptSurface } = await import('../components/surfaces/PasswordPromptSurface.vue');
+      // (e.g. "Password Required" → "Incorrect Password"). The `.vue` shim
+      // types the default export as `unknown`; narrow to `object` for
+      // `markRaw()`.
+      const mod = await import('../components/surfaces/PasswordPromptSurface.vue');
+      const PasswordPromptSurface = /** @type {object} */ (mod.default);
       const surfaceId = `password-prompt-${doc.id}`;
       handle = manager.open({
         id: surfaceId,