feat: enhance sidebar navigation with localStorage state management and section key support

web/lib/navigation-active.test.mjs

@@ -63,3 +63,23 @@ describe("dashboardNavSectionHasActiveItem", () => {
     assert.equal(dashboardNavSectionHasActiveItem(items, "/dashboard/users"), false)
   })
 })
+
+describe("dashboard nav section storage helpers", () => {
+  it("builds stable localStorage keys from section identifiers", async () => {
+    const { getDashboardNavSectionStorageKey } = await loadModule()
+
+    assert.equal(
+      getDashboardNavSectionStorageKey("nav.receptionCenter"),
+      "dashboard.sidebar.navSection.nav.receptionCenter.open"
+    )
+  })
+
+  it("parses stored open states and ignores unknown values", async () => {
+    const { parseDashboardNavSectionOpenState } = await loadModule()
+
+    assert.equal(parseDashboardNavSectionOpenState("true"), true)
+    assert.equal(parseDashboardNavSectionOpenState("false"), false)
+    assert.equal(parseDashboardNavSectionOpenState(null), undefined)
+    assert.equal(parseDashboardNavSectionOpenState("bad"), undefined)
+  })
+})

web/lib/navigation-active.ts

@@ -2,6 +2,8 @@ export type DashboardNavActiveItem = {
   url: string
 }
 
+const DASHBOARD_NAV_SECTION_STORAGE_PREFIX = "dashboard.sidebar.navSection"
+
 function normalizePath(path: string) {
   return path !== "/" ? path.replace(/\/+$/, "") : path
 }
@@ -22,3 +24,17 @@ export function dashboardNavSectionHasActiveItem(
 ) {
   return items.some((item) => isDashboardNavItemActive(pathname, item.url))
 }
+
+export function getDashboardNavSectionStorageKey(sectionKey: string) {
+  return `${DASHBOARD_NAV_SECTION_STORAGE_PREFIX}.${sectionKey}.open`
+}
+
+export function parseDashboardNavSectionOpenState(value: string | null) {
+  if (value === "true") {
+    return true
+  }
+  if (value === "false") {
+    return false
+  }
+  return undefined
+}