TypeScript Declaration Files

How it works

The downloadable fixture pairs a small CommonJS JavaScript function with a declaration file. TypeScript checks the caller using rounding.d.ts, while Node loads rounding.js. This is a useful way to integrate a small untyped library, but an incorrect declaration can make a bad call look valid. The review therefore executes the real JavaScript as well as checking the TypeScript caller.

Run the code

This example runs locally with its documented files and dependencies. It cannot run in the single-file browser worker. Save every download under its shown name in one new folder, run npm install, npm run build, then npm start. The course review compiles and executes the actual files, not just an inline replacement.

Use npm run check for a separate no-output compiler pass. The supplied project enables strict checking, indexed-access checks and exact optional properties. Node fixtures use Node 22.15.1; React fixtures use React/React DOM 19.3.1. These dependencies are installed only in your new example folder, not into Bhylu’s application.

• lesson.ts
• rounding.d.ts
• rounding.js
• tsconfig.json
• package.json

Example

import { roundCount } from "./rounding.js";
console.log(roundCount(3.6));

Expected result

4

The declaration says the function accepts and returns numbers; the JavaScript implements rounding. Download all three files into the same folder before compiling. If a package already bundles declarations, use those rather than adding a second competing definition without a reason.