Scenario

TypeScript is a variation of JavaScript with extra type-checking and developer tooling. It adds things like declared data types, better error checking, interfaces, and stronger editor support, then gets converted into ordinary JavaScript that browsers or Node.js can run.

It is widely used in modern web development, especially in larger or more structured projects. You’ll see it in frameworks and tools such as React, Next.js, Angular, Vue, Node.js backends, and Quartz. In your Quartz setup, files ending in .ts and .tsx are TypeScript files, and tsconfig.json controls how TypeScript checks and processes them.

Warning!

While reviewing the Quartz project configuration, VS Code showed a TypeScript deprecation warning for:

"moduleResolution": "node"

This setting uses the older Node-style module resolution mode and is deprecated in newer TypeScript versions. The fix was a single-line change in tsconfig.json:

"moduleResolution": "bundler"

No other TypeScript settings were changed.

After saving the file, the deprecation warning disappeared. This change affects how TypeScript resolves imports during development and build processes; it does not directly change the Markdown content, site structure, theme, URLs, or published Quartz output.

Verification

Before the next publish, the normal Quartz build can be run as a quick check:

npx quartz build --serve

If the build completes successfully, the publishing workflow can continue as normal.

Outcome

  • TypeScript deprecation warning removed
  • One configuration line changed
  • No content files altered
  • No expected impact on existing Quartz publishing