diff --git a/packages/superdoc/scripts/jsdoc-debt-snapshot.json b/packages/superdoc/scripts/jsdoc-debt-snapshot.json
index f8adff0215..8f0ff8e6ea 100644
--- a/packages/superdoc/scripts/jsdoc-debt-snapshot.json
+++ b/packages/superdoc/scripts/jsdoc-debt-snapshot.json
@@ -102,7 +102,6 @@
     "packages/super-editor/src/editors/v1/extensions/track-changes/trackChangesHelpers/replaceAroundStep.js",
     "packages/super-editor/src/editors/v1/extensions/track-changes/trackChangesHelpers/replaceStep.js",
     "packages/super-editor/src/editors/v1/extensions/track-changes/trackChangesHelpers/trackedTransaction.js",
-    "packages/super-editor/src/editors/v1/extensions/underline/underline.js",
-    "packages/superdoc/src/index.js"
+    "packages/super-editor/src/editors/v1/extensions/underline/underline.js"
   ]
 }
diff --git a/packages/superdoc/src/index.js b/packages/superdoc/src/index.js
index daaed5f22a..9057308edc 100644
--- a/packages/superdoc/src/index.js
+++ b/packages/superdoc/src/index.js
@@ -1,3 +1,4 @@
+// @ts-check
 import {
   SuperConverter,
   Editor,
@@ -34,6 +35,8 @@ import {
   SlashMenu,
 } from '@superdoc/super-editor';
 import { DOCX, PDF, HTML, getFileObject, compareVersions } from '@superdoc/common';
+// @ts-expect-error Vite resolves DOCX asset URL imports; plain tsc does not.
+// Keep local suppression until URL asset imports can be typed without d.ts leaks.
 import BlankDOCX from '@superdoc/common/data/blank.docx?url';
 import { getSchemaIntrospection } from './helpers/schema-introspection.js';
 
@@ -234,7 +237,7 @@ import { getSchemaIntrospection } from './helpers/schema-introspection.js';
 
 // Public exports
 export { SuperDoc } from './core/SuperDoc.js';
-export { createTheme, buildTheme } from './core/theme/create-theme.ts';
+export { createTheme, buildTheme } from './core/theme/create-theme.js';
 export {
   BlankDOCX,
   getFileObject,