feat: signal async CMS nav ready via flag and event

[wesleyboar]

Overview

After the CMS nav HTML is injected and post-processed, set a data- attr flag and send a CustomEvent. This lets scripts in other repos safely defer link initialization until the async nav is populated.

The custom script loaded via #1303 needs to modify a CMS nav link — but on Portal the nav is injected asynchronously, so the link doesn't exist at script load time. This PR adds the signal that lets that script wait safely.

Related

• supports client-side solution for WP-1230
• server-side alternative: feat: set a CMS menu link to open in new tab - via data Core-CMS#1151
• requires feat: custom scripts via PORTAL_JS_FILENAMES #1303
• required by fix(ptdatax): new tab link on Portal requires CMS nav ready Core-CMS-Custom#538
• tested via https://github.com/TACC/Core-Portal-Deployments/pull/194
• mentioned in WP-1290

Changes

• added NAV_READY_ATTR and NAV_READY_EVENT const's
• added data-nav-ready flag and cms-nav:ready event dispatch

Testing

1. In DevTools console, run document.getElementById('s-cms-nav').dataset.navReady — should return 'true' once the nav is populated.
2. Test fix(ptdatax): new tab link on Portal requires CMS nav ready Core-CMS-Custom#538.
3. Load a Portal page and confirm the CMS nav renders normally.
4. Confirm no regressions i.e. these still work:
   1. On portal, active link is highlighted.
   2. On CMS page, Bootstrap 4→5 toggle shim still work.

UI

Tip

Tested on https://pprd.ptdatax.tacc.utexas.edu/.

1. Console Test

2. & 3. Render Normal & Link Set to Open in New Tab

4.a. flagLinkActive Still Works

4.b. Bootstrap Shim Still Works

Notes

Note

Gray links in CMS Nav on Portal is known, recent, unrelated bug.

---

Made with Cursor

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 64.09%. Comparing base (bc7c1ce) to head (16dc201).

Additional details and impacted files

@@                 Coverage Diff                  @@
##           feat/custom-scripts    #1304   +/-   ##
====================================================
  Coverage                64.09%   64.09%           
====================================================
  Files                      461      461           
  Lines                    13794    13794           
  Branches                  2750     2745    -5     
====================================================
  Hits                      8841     8841           
  Misses                    4604     4604           
  Partials                   349      349           

Flag	Coverage Δ
javascript	67.10% <ø> (ø)
unittests	60.90% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.