WORK-038
ID:WORK-038Status:done

Build nav region builder for plan site

Convert the existing buildNavigation() output (NavGroup[]) into a renderable tag tree that can be passed as a layout region to renderFullPage().

Currently the sidebar HTML is hand-rolled in the HTML shell template. This work item replaces that with a buildNavRegion() function that produces serialized tags with BEM classes matching the existing .rf-plan-sidebar__* selectors.

Priority:highComplexity:moderateSource:SPEC-014,SPEC-015
main View source

Criteria completion

No incremental history — criteria tracking started on Apr 21.

Relationships

Implements 2
Related 4
Branches 3
main current done
claude/file-naming-convention-LJdwR donechangeset-release/main doneclaude/align-sidenav-styling-4MuxV done
History 4
  1. e900a90
    Created (done)by bjornolofandersson
  2. f262d7b
    Content editedby Claude
  3. 4f81969
    statusready→done
    by Claude
  4. f5b8bf8
    Created (ready)by Claude
    Add work items WORK-037 through WORK-049 for plan site specs

Acceptance Criteria

  • buildNavRegion(groups, activePath) function exists in @refrakt-md/plan
  • Output is a serialized tag tree (plain {$$mdtype:'Tag'} objects)
  • Tags use correct BEM classes: .rf-plan-sidebar, .rf-plan-sidebar__group, .rf-plan-sidebar__link, .rf-plan-sidebar__link--active
  • Entity links include data-status, data-id attributes for future filtering (SPEC-015)
  • Existing sidebar visual appearance is preserved
  • Unit tests verify the tag tree structure

Approach

Create buildNavRegion() alongside the existing buildNavigation() in render-pipeline.ts. It walks the NavGroup[] array and emits tags with appropriate BEM classes and data attributes. The output plugs directly into LayoutPageData.regions.nav.

References

  • SPEC-014 (Plan Site via HTML Adapter)
  • WORK-037 (defines the layout that consumes this region)