Tsconfig Build speedup

[mxfh]

should reduce cross-project source typechecking by switching selected targets to package-mode builds.

easy win for build times, but the annotations spike changed a few details of the approach.

new findings from the annotations spike

• buildLibsFromSource: false is still the right switch for stopping cross-library source typechecks.
• the global Nx default in nx.json (targetDefaults.build.dependsOn: ["^build"] and targetDefaults["@nx/vite:build"].dependsOn: ["^build"]) still forces transitive dependency builds. if a target should really build itself only, it must override that with dependsOn: [].
• nested alias imports such as @carma-commons/utils/* are the main friction point. Nx rewrites those nested paths to exact extensionless dist targets, so tsconfig aliases alone are not enough. the built package surface has to match that shape.
• temporary package-surface fixes can unblock this before full cleanup. for the annotations work, commons/utils needed secondary entrypoint outputs for promise, window, number-format, and fetching, and cesium-legacy needed a declaration-surface fix so its built API matches its source barrel.
• that means issue #625 is still valid backlog, but it is no longer a hard prerequisite for making the annotations packages build in package mode.
• with dependsOn: [], changed dependencies are not rebuilt automatically. that is intentional for isolated library builds, but app/playground targets either need fresh dependency outputs or they should keep dependency orchestration.

verified in the annotations spike

• nx run annotations-core:build
• nx run annotations-runtime:build
• nx run annotations-builtin-tools:build
• nx run annotations:build:production after rebuilding touched dependency outputs

external prerequisites / follow-ups

• remove @carma/math alias as part of #588
• normalize @carma-commons/utils/* nesting via #625 as follow-up cleanup, not a hard blocker for annotations package-mode builds
• fix mapping-layers boundary / break utils cycle via #624
• fix collab imports via #626
• optionally remove Jest and standardize on Vitest via #627

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 69543f0

---

☁️ Nx Cloud last updated this comment at 2026-04-22 10:53:55 UTC