npm

The npm plugin is enabled by default. It discovers workspace packages, bumps versions in package.json, updates dependency ranges, and publishes to npm.

Discovery

Tegami scans:

• The root package.json (if present).
• Workspace packages from pnpm-workspace.yaml or the workspaces field in the root manifest.

Private packages are versioned but not published unless you set publish: true in packages.

Configuration

Pass options through the top-level npm field:

const paper = tegami({
  npm: {
    client: "pnpm",
    updateLockFile: true,
    onBreakPeerDep: "set",
  },
});

Dependency bumps

When a package is bumped, the plugin may bump its dependents based on dependency kind:

• dependencies and optionalDependencies → patch bump on the dependent
• devDependencies → no automatic bump
• peerDependencies → major bump (or handled by onBreakPeerDep)

Customize this with bumpDep:

npm({
  bumpDep: ({ kind }) => (kind === "dependencies" ? "patch" : false),
});

Package options

It allows to override distTag for npm publish, otherwise, it will read from your publishConfig in package.json.

tegami({
  packages: {
    "@acme/ui": {
      npm: {
        distTag: "next",
      },
    },
  },
});