docs(hydrogen): mark the current page in the sample nav

[romain-pm]

Summary

Makes the current page actually show as current in the hydrogen navigation. Stacked on #751; the diff here is nine lines in one sample file.

Why

The nav marked the current entry with aria-current={page === mainNode ? "page" : undefined}. Both sides are Graal host proxies wrapping a JCR node, and two proxies for the same node are not the same object — so the test never passed and aria-current never appeared. <JLink> compares identifiers instead.

Changes

• Both link sites become <JLink node={page} />. No children, so the label comes from the page's displayable name.
• The view declares properties: { "cache.mainResource": "true" }. Current-page state is a function of the main resource, and PathCacheKeyPartGenerator leaves the main resource out of the fragment cache key unless the view opts in — so without this the nav would be cached once and replayed on every page with the same entry marked current. Nothing in this monorepo declared the property before; core declares it on jnt_navMenu, jnt_area and the other main-resource-dependent views, and Jahia/luxe-jahia-demo declares it on its own nav.

Validation

• tsc --noEmit on samples/hydrogen and eslint both clean, against the library built from this branch. prettier --check clean.
• Not run on an instance. The caching claim is the whole point of the change and it is exactly what a unit test cannot reach: the case to check is the same nav rendered on two pages through an AbsoluteArea, asserting aria-current follows the page. That is hydrogen NavBar: current-page state that actually works, and is cached correctly #759's third box and cache.mainResource: make current-page state safe to cache #755's Cypress case.

Why it is separate from #751

#751 adopts the API mechanically. This changes what the reference sample renders — aria-current appears where it never did, on the navigation every new module copies — and it introduces a caching rule the docs have never stated. Worth its own review rather than one line in a 12-file diff.

Part of #759. Depends on #751.

[pkg-pr-new]

Open in StackBlitz

yarn add https://pkg.pr.new/@jahia/create-module@760.tgz

yarn add https://pkg.pr.new/@jahia/javascript-modules-library@760.tgz

yarn add https://pkg.pr.new/@jahia/vite-plugin@760.tgz

commit: 1a43a3f