feat(nx-plugin): refactor plugin options normalization to common method with defaultOptions (normalizeOptions)

[mxfh]

• Move all plugin option normalization to a shared utility
• Add formatter and fallback logic, with tests for normalizeOptions/normalizeExtensions
• Webpack plugin now is no longer overriding user supplied build/watch deps strings, it fills them from defaults if unset
• Note: consider whether internal options like buildDepsTargetName and watchDepsTargetName should be exposed to users at all

This is a refactor for plugin option handling. Further plugin-specific improvements.

found some likely inconsistencies in the process.

Current Behavior

in nx.json

ommiting options

{
  "plugin": "@nx/storybook/plugin",
}

causes failure in processin project graph

npx nx run-many -t=build --verbose

 NX   Failed to process project graph.

     - TypeError: Cannot read properties of undefined (reading 'buildStorybookTargetName')
      at normalizeOptions (workspaceRoot/node_modules/@nx/storybook/src/plugins/plugin.js:240:43)
      at exports.createNodesV2 (workspaceRoot/node_modules/@nx/storybook/src/plugins/plugin.js:31:35)

this works:

{
  "plugin": "@nx/storybook/plugin",
  "options": {}
}

Expected Behavior

{
  "plugin": "@nx/storybook/plugin",
}

should just run with all default Options

Related Issue(s)

could not find any open issues in that context

Fixes #

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
nx-dev	✅ Ready (Inspect)	Visit Preview	Jun 22, 2025 2:01am

[mxfh]

all other options pretty much had this pattern
options ??= {};
but here no empy object is filled with the defaults

[mxfh]

ommited the deprecated value here since the startTargetName is also in the defaults
serveStaticTargetName?: string;

[mxfh]

buildDepsTargetName
watchDepsTargetName

are missing from the defaults, see also webpack options behavior

[mxfh]

they got added in this commit but only webpack got an update to the defaultOptions:

0ae8665#diff-8ea87d5fdfbfcec0fc69136da5a959e64f7e2747a01611c16227183d06b24eabR33-R331

[graphite-app]

The serveTargetName option is defined in the old normalizeOptions function but is missing from the new defaultOptions object. Please add serveTargetName: 'serve' to maintain backward compatibility with existing configurations.

Suggested change

	const defaultOptions: VitePluginOptions = {
	buildTargetName: 'build',
	testTargetName: 'test',
	devTargetName: 'dev',
	previewTargetName: 'preview',
	serveStaticTargetName: 'serve-static',
	typecheckTargetName: 'typecheck',
	};
	const defaultOptions: VitePluginOptions = {
	buildTargetName: 'build',
	testTargetName: 'test',
	devTargetName: 'dev',
	previewTargetName: 'preview',
	serveStaticTargetName: 'serve-static',
	serveTargetName: 'serve',
	typecheckTargetName: 'typecheck',
	};

Spotted by Diamond

Is this helpful? React 👍 or 👎 to let us know.

[mxfh]

/**

• @deprecated Use devTargetName instead. This option will be removed in Nx 22.
  */

intentionally removed so the deprecated option stays unset.