@nx/rspack:rspack executor does not use baseHref option

[scott-gmr]

Current Behavior

The @nx/rspack:rspack executor ignores the baseHref option. The output index.html file does not have the <base href="<baseHref>" /> tag when this option is provided.

I ended up using this code to make a bandaid for this in rspack.config.js:

module.exports = composePlugins(withNx(), withReact(), (config) => { 
  config.plugins.find(
    (plugin) => plugin.constructor.name === 'HtmlRspackPlugin'
  )._args[0].base = { href: '/my-base-href/' };

  return config;
});

Expected Behavior

When provided, baseHref should set the <base href="<baseHref>"> tag in the output HTML document.

GitHub Repo

https://github.com/scott-gmr/nx-base-href-bug

Steps to Reproduce

1. Use the @nx/rspack:rspack executor with the baseHref option set.
2. Check the output index.html file.

Nx Report

Node : 20.14.0 OS : darwin-arm64 Native Target : aarch64-macos npm : 10.7.0

nx : 20.0.0 @nx/js : 20.0.0 @nx/jest : 20.0.0 @nx/eslint : 20.0.0 @nx/workspace : 20.0.0 @nx/devkit : 20.0.0 @nx/eslint-plugin : 20.0.0 @nx/react : 20.0.0 @nx/rspack : 20.0.0 @nx/web : 20.0.0 typescript : 5.5.4

Registered Plugins: @nx/eslint/plugin @nx/jest/plugin

Failure Logs

No response

Package Manager Version

10.7.0

Operating System

• [x] macOS
• [ ] Linux
• [ ] Windows
• [ ] Other (Please specify)

Additional Information

This is documented as a valid option, but it isn't used.

It is fairly plain to see why this occurs just by looking at Nx's code directly. This code search shows that the option is only even referenced in the @nx:rspack/dev-server executor's package.

It can also been seen here that the HtmlRspackPlugin is only given the template option with no base set, and this is the only time HtmlRspackPlugin occurs in the source code.

I would also say that often options for CLI commands and generators/executors are often under-documented. "Base url for the application being built" is a pretty vague and redundant description for this option. I would assume this has the same intention as the baseHref option previously working as expected for Nx's Webpack package, but the description says nothing about what this option is supposed to actually affect. When this appears alongside the similarly vaguely described deployUrl, it makes it confusing for a developer to know what the intention of these options even are, especially when the options themselves are not taking effect.

I try not to jump to blaming my libraries' code for issues I'm experiencing, but to be honest I have had to dig in Nx's node_modules frequently, more frequently than any other libraries, and this is not the first time my issue has turned out to be an Nx bug (or a sneaky breaking change with no release notes in a minor/patch release), but it's the first time no one seems to have created the same issue. Is there no testing to make sure that at minimum the options passed to these generators are being even basically utilized? I would think if you were to test anything it would at least be the public interface of these tools. It seems the push is to migrate to Rspack from Webpack, yet feature parity feels very sloppy.