perf(build): remove redundant steps and add fast dev build (SD-1886) (#1999)

* perf(build): speed up build pipeline and add fast dev build (SD-1886)

- Remove --force from type-check to enable incremental tsc caching
- Remove clean:packages from default build (vite cleans dist/ itself)
- Add build:clean for when a full clean build is needed
- Add build:dev that skips DTS generation for fast local iteration (~15s vs ~50s)

* perf(build): deduplicate types:build across build scripts

Remove redundant types:build calls from root build, build:es, and
pack:es — superdoc's own build scripts already invoke it. Adds
type-check:force for build:clean where a full rebuild is needed.

Saves ~7s on incremental builds by eliminating duplicate tsc runs.

Author: caio-pizzol

package.json

@@ -13,7 +13,8 @@
     "test:editor": "vitest run --root ./packages/super-editor",
     "test:superdoc": "vitest run --root ./packages/superdoc",
     "test:cov": "node scripts/test-cov.mjs",
-    "type-check": "tsc -b --force tsconfig.references.json",
+    "type-check": "tsc -b tsconfig.references.json",
+    "type-check:force": "tsc -b --force tsconfig.references.json",
     "rebuild:types": "pnpm run --filter=@superdoc/common --filter=@superdoc/word-layout --filter=@superdoc/contracts --filter=@superdoc/geometry-utils --filter=@superdoc/style-engine --filter=@superdoc/pm-adapter --filter=@superdoc/measuring-dom --filter=@superdoc/layout-engine --filter=@superdoc/painter-dom --filter=@superdoc/layout-bridge build",
     "validate:commands": "node scripts/validate-command-types.mjs",
     "unzip": "bash packages/super-editor/src/tests/helpers/unzip.sh",
@@ -24,9 +25,11 @@
     "dev:docs": "pnpm --prefix apps/docs run dev",
     "build:superdoc": "pnpm --prefix packages/superdoc run build",
     "build:super-editor": "pnpm --prefix packages/super-editor run build",
-    "build": "pnpm run clean:packages && pnpm --prefix packages/super-editor run types:build && pnpm run build:superdoc && pnpm run type-check",
-    "build:es": "pnpm --prefix packages/super-editor run types:build && pnpm --prefix packages/superdoc run build:es",
-    "pack:es": "pnpm --prefix packages/super-editor run types:build && pnpm --prefix packages/superdoc run pack:es",
+    "build": "pnpm run build:superdoc && pnpm run type-check",
+    "build:clean": "pnpm run clean:packages && pnpm run build:superdoc && pnpm run type-check:force",
+    "build:dev": "pnpm --prefix packages/superdoc run build:dev",
+    "build:es": "pnpm --prefix packages/superdoc run build:es",
+    "pack:es": "pnpm --prefix packages/superdoc run pack:es",
     "clean:packages": "rm -rf ./packages/**/dist ./shared/**/dist",
     "reset": "pnpm run clean:packages && find . -name 'node_modules' -type d -prune -exec rm -rf {} + && find . -name 'package-lock.json' -type f -delete && pnpm install",
     "publish": "node scripts/publish-superdoc.cjs",

packages/superdoc/package.json

@@ -63,6 +63,7 @@
     "dev:collab": "concurrently -k -n VITE,COLLAB -c cyan,green \"vite\" \"node src/dev/collab-server.js\"",
     "collab-server": "node src/dev/collab-server.js",
     "build": "pnpm --prefix ../super-editor run types:build && vite build && pnpm run build:umd",
+    "build:dev": "SUPERDOC_SKIP_DTS=1 vite build",
     "postbuild": "node ./scripts/ensure-types.cjs",
     "build:es": "pnpm --prefix ../super-editor run types:build && vite build && node ./scripts/ensure-types.cjs",
     "watch:es": "vite build --watch",

packages/superdoc/vite.config.js

@@ -62,9 +62,10 @@ export const getAliases = (_isDev) => {
 
 // https://vitejs.dev/config/
 export default defineConfig(({ mode, command}) => {
+  const skipDts = process.env.SUPERDOC_SKIP_DTS === '1';
   const plugins = [
     vue(),
-    dts({
+    !skipDts && dts({
       include: ['src/**/*', '../super-editor/src/**/*'],
       outDir: 'dist',
     }),
@@ -78,7 +79,7 @@ export default defineConfig(({ mode, command}) => {
       hook: 'writeBundle'
     }),
     // visualizer(visualizerConfig)
-  ];
+  ].filter(Boolean);
   if (mode !== 'test') plugins.push(nodePolyfills());
   const isDev = command === 'serve';