fix: update Vite configuration and TypeScript settings for improved type handling and asset resolution

Author: Simon-He95

scripts/rollup.dts.config.mjs

@@ -1,9 +1,21 @@
 import dts from 'rollup-plugin-dts'
 
+// Bundle the generated declaration entry into a single dist/index.d.ts.
+// Treat workspace deps as external so we don't try to resolve them during
+// bundling (the consumer will have their own types for those packages).
 export default [
   {
+    // Vite emits declarations under dist/types
     input: './dist/types/exports.d.ts',
-    plugins: [dts()],
+    plugins: [
+      dts({
+        // Leave external type imports in place
+        respectExternal: true,
+      }),
+    ],
+    external: [
+      /^(?:stream-markdown-parser)(?:\/.*)?$/,
+    ],
     output: [
       {
         file: 'dist/index.d.ts',

src/shims-vue.d.ts

@@ -3,3 +3,14 @@ declare module '*.vue' {
   const component: ReturnType<typeof defineComponent>
   export default component
 }
+
+// Vite asset imports used in this project
+declare module '*.svg?raw' {
+  const src: string
+  export default src
+}
+
+declare module '*.svg?url' {
+  const src: string
+  export default src
+}

tsconfig.build.json

@@ -5,6 +5,7 @@
     "lib": ["DOM", "ESNext"],
     "module": "ESNext",
     "moduleResolution": "node",
+    "types": ["vite/client"],
     "resolveJsonModule": true,
     "declaration": true,
     "emitDeclarationOnly": true,

vite.config.ts

@@ -26,6 +26,10 @@ export default defineConfig(({ mode }) => {
       Vue(),
       dts({
         outDir: 'dist/types',
+        // Use a build-only tsconfig without path aliases to avoid rewriting
+        // imports like "stream-markdown-parser" into relative workspace paths
+        // in the emitted .d.ts (which breaks type bundling).
+        tsconfigPath: './tsconfig.build.json',
       }),
       UnpluginClassExtractor({
         output: 'dist/tailwind.ts',
@@ -111,6 +115,15 @@ export default defineConfig(({ mode }) => {
     }
   }
 
+  // Alias resolution: during dev/test, point workspace dep to source to avoid needing its dist build
+  const alias: Record<string, string> = {
+    '@': '/src',
+  }
+  if (mode !== 'npm') {
+    alias['stream-markdown-parser'] = '/packages/markdown-parser/src/index.ts'
+    alias['stream-markdown-parser/*'] = '/packages/markdown-parser/src/*'
+  }
+
   return {
     base,
     plugins,
@@ -137,10 +150,6 @@ export default defineConfig(({ mode }) => {
     css: {
       postcss: './postcss.config.cjs',
     },
-    resolve: {
-      alias: {
-        '@': '/src',
-      },
-    },
+    resolve: { alias },
   }
 })