Latest article
Does TypeScript Have Dependent Types? Model Literal-Driven Constraints
TypeScript can correlate properties and return types with literal inputs, but those patterns are not general dependencies on runtime values.
Types / boundaries / better code
TypeScript in Production: TypeScript in Real Software
A blog about TypeScript in production software, focused on the practical context of using the language in real applications.
Pick a starting point
More from the notebook
Publish and protect package APIs
Write TypeScript JSDoc Comments That Help API Consumers
Put usage guidance beside public declarations, leave types in TypeScript, and check how the comments read in editor help and generated reference pages.
Publish and protect package APIs
What TypeDoc Includes from a TypeScript Entry Point
Use a library entry point’s exports to predict which declarations TypeDoc will represent, then check the result and its extracted comments.
Choose runtime structure and behavior
Awaiting Async Work in TypeScript Loops: Choose Sequential `for...of` or Concurrent `Promise.all`
Use `for...of` when each operation must finish before the next starts; use `Promise.all` for independent operations, while accounting for its rejection behavior.
Publish and protect package APIs
Create a TypeScript npm Package That Publishes JavaScript and Declarations
Build a CommonJS-only TypeScript library, package its JavaScript and declarations, and check both entry points from a separate consumer.
Choose runtime structure and behavior
Choose TypeScript or Python for a Backend Service: Workload, Contracts, and Ownership
Choose the language around the service’s defining dependencies, then account for runtime validation, contract ownership, and the cost of operating another service.
Choose runtime structure and behavior
TypeScript Classes vs Modules: Should State Belong to an Instance or a File?
Use a class when callers need independently changing state; use a module to group operations and control what other files can import.
Validate inputs and enforce contracts
Model a TypeScript API Contract: Requests, Responses, and the Network Boundary
Define one user-update contract for a handler and client, then check actual request and response data before trusting its types.
Model data and type relationships
TypeScript Pick vs Extract: Select Properties or Union Variants
Use Pick to select fields from a type, Extract to retain matching union members, and Extract before Pick when the fields belong to only one variant.
Configure, migrate, and verify projects
Run a TypeScript Development Script with `tsx` and npm
Use `tsx watch` for a repeatable development command, then run type checking and compiled JavaScript as separate checks.
Keep the next useful detail within reach.
Follow via RSS