Normalize Modules

Normalize exports, main, type, browser, and imports fields in workspace package.json files.

Summary

The normalize-modules recipe ensures that module resolution fields in each workspace's package.json follow the official Node.js module specification conventions.

It handles exports map structure, main entry point, module type declaration, browser field, and import maps.

Why Use This Command?

1. Keeps Node.js entry points aligned with the module fields each workspace role supports.
2. Normalizes shorthand exports into one predictable object shape for consumers and tools.
3. Removes inapplicable module fields before they advertise entry points that should not exist.

Requirements

• Node.js runtime — Use a supported Node.js LTS release with the Nova CLI available.
• Project config — Register the workspace and enable recipes.package-json.<workspace>.normalize-modules in nova.config.json.
• Workspace manifest — The configured workspace must contain a readable package.json file.

Behavior

For each eligible workspace, the recipe inspects module resolution fields and applies the following rules. See Workspace Rules for how tags are determined.

• exports (Conditional) — Removed if the workspace role is not config, package, or tool. For allowed roles, if the value is a string it is normalized into { ".": { "default": value } }.
• main (Conditional) — Removed if the workspace role is not config, app, package, or tool. For allowed roles, the recipe cross-references main with exports['.'].require:
  • If both exist and differ — a warning is logged and no changes are applied.
  • If main exists but exports['.'].require does not — exports['.'].require is set from main.
  • If exports['.'].require exists but main does not — main is set from exports['.'].require.
  • If main exists and exports['.'] is a string — exports['.'] is normalized into { "default": exports['.'], "require": main }.
• type (Conditional) — Removed if the workspace role is not config, app, package, or tool.
• browser (Conditional) — Removed if the workspace role is not package. For packages, the same cross-reference logic as main is applied using exports['.'].browser.
• imports (Conditional) — Removed if the workspace role is not config, app, package, or tool.

Usage

Options