prettier-plugin-explicit-return weekly downloads statistics

Prettier Plugin Explicit Return

A Prettier plugin that automatically adds explicit return type annotations to TypeScript functions using type inference.

Installation

Usage

Add the plugin to your Prettier configuration:

.prettierrc.json:

package.json:

Then format your TypeScript files as usual:

Features

This plugin automatically adds explicit return type annotations to:

• ✅ Function declarations • ✅ Arrow functions • ✅ Class methods • ✅ Function expressions • ✅ Async functions (including Promise return types)

Functions that already have explicit return types are skipped to avoid duplication.

Examples

Function Declaration

Before:

After:

Arrow Function

Before:

After:

Class Method

Before:

After:

Function Expression

Before:

After:

Async Function

Before:

After:

Existing Return Types (Skipped)

Functions with existing return types are left unchanged:

Before & After:

How It Works

The plugin uses TypeScript's type checker to infer return types for functions that don't have explicit return type annotations. It:

1. Parses your TypeScript code using TypeScript's compiler API 2. Uses the type checker to infer return types 3. Adds explicit return type annotations to functions that don't have them 4. Preserves all formatting and existing code structure 5. Works seamlessly with Prettier's formatting pipeline

Requirements

• Node.js 14+ • Prettier 3.6+ • TypeScript 5.9+

License

MIT © 2025 Gavin Harris