fix(web): use base URL for synthetic page assets

[Herrtian]

Fixes #809

Uses the configured base URL for synthetic page asset roots, so the 404 page can be served from deep links without resolving CSS and JS relative to the missing path.

Checks:

• node --test --experimental-test-module-mocks src\generators\web\utils_tests_\processing.test.mjs
• npx.cmd eslint src\generators\web\utils\processing.mjs src\generators\web\utils_tests_\processing.test.mjs
• npx.cmd prettier --check src\generators\web\utils\processing.mjs src\generators\web\utils_tests_\processing.test.mjs
• git diff --check

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	May 27, 2026 12:59pm

[cursor]

PR Summary

Low Risk
Small, scoped change to template root for synthetic pages only; regular pages unchanged and behavior is covered by new unit tests.

Overview
Fixes broken CSS/JS on synthetic pages (e.g. 404) when the site is opened from a deep or missing URL path.

Page HTML rendering now uses a new resolvePageRoot helper instead of always deriving root from each page’s path. Regular pages still get the same path-relative prefix (e.g. ../ for /api/fs). Synthetic pages use / by default, or the configured baseURL (with trailing slash) when useAbsoluteURLs is enabled—so import maps and other ${root}-based asset URLs no longer point under the bogus request path.

Tests in processing.test.mjs set web generator config and cover normal pages, synthetic pages, and the absolute-URL case.

^{Reviewed by Cursor Bugbot for commit ba42722. Bugbot is set up for automated code reviews on this repo. Configure here.}

[AugustinMauroy]

look at preview root link it's just broke

[Herrtian]

Updated this so synthetic pages use / in relative URL mode and only use baseURL when absolute URLs are enabled. That should keep the preview assets on the preview origin.

[AugustinMauroy]

just open https://api-docs-tooling-git-fork-herrtian-fix-synthetic-f9f8be-openjs.vercel.app/ on your browser and see oh broken css url

[Herrtian]

The branch synced now and the latest preview points the root page stylesheet at /styles.css.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit ba42722. Configure here.}

[AugustinMauroy]

LGTM !

[codecov]

Codecov Report

❌ Patch coverage is 98.27586% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 82.86%. Comparing base (f97991b) to head (ba42722).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/generators/web/utils/processing.mjs	93.33%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #811      +/-   ##
==========================================
+ Coverage   82.80%   82.86%   +0.06%     
==========================================
  Files         171      171              
  Lines       14904    14957      +53     
  Branches     1305     1312       +7     
==========================================
+ Hits        12341    12394      +53     
+ Misses       2555     2554       -1     
- Partials        8        9       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.