@exxatdesignux/ui 0.2.17 → 0.2.19

package/template/lib/data-view-dashboard-storage.ts

@@ -1,5 +1,5 @@
 /**
- * Centralized localStorage for **Data** view dashboard canvas (Placements, Team, Compliance).
+ * Centralized localStorage for **Data** view dashboard canvas (list hub, question bank).
  * Single bundle key; per-scope slices. Migrates legacy per-hub keys when a scope is missing.
  */
 
@@ -9,14 +9,16 @@ const BUNDLE_KEY = "exxat-ds:data-view-dashboards:v1"
 
 /** Legacy keys (pre-bundle) — read when that scope is absent from the bundle. */
 const LEGACY_KEYS: Record<DataViewScope, string> = {
-  placements: "exxat-dashboard-cards",
-  team: "exxat-team-dashboard-cards",
-  compliance: "exxat-compliance-dashboard-cards",
+  "list-hub": "exxat-dashboard-cards",
+  "question-bank": "exxat-question-bank-dashboard-cards",
 }
 
-export type DataViewScope = "placements" | "team" | "compliance"
+/** @deprecated Legacy scopes still migrated from the bundle. */
+const LEGACY_SCOPES = ["placements", "team", "compliance"] as const
 
-type LayoutBundle = Partial<Record<DataViewScope, DashboardLayoutV1>>
+export type DataViewScope = "list-hub" | "question-bank"
+
+type LayoutBundle = Partial<Record<DataViewScope | (typeof LEGACY_SCOPES)[number], DashboardLayoutV1>>
 
 function parseLayout(raw: unknown): DashboardLayoutV1 | null {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null
@@ -51,51 +53,52 @@ function readBundleRaw(): LayoutBundle {
   }
 }
 
-function writeBundle(bundle: LayoutBundle) {
+function writeBundleRaw(bundle: LayoutBundle) {
   if (typeof window === "undefined") return
   try {
     localStorage.setItem(BUNDLE_KEY, JSON.stringify(bundle))
   } catch {
-    /* ignore quota */
+    /* quota / private mode */
   }
 }
 
-/**
- * Merge any missing scopes from legacy keys into the bundle (one-time per scope per session edge cases OK).
- */
-function ensureBundleWithLegacy(): LayoutBundle {
-  let bundle = readBundleRaw()
-  let changed = false
-  for (const scope of ["placements", "team", "compliance"] as const) {
-    if (bundle[scope]) continue
-    try {
-      const raw = localStorage.getItem(LEGACY_KEYS[scope])
-      if (!raw) continue
-      const layout = parseLayout(JSON.parse(raw) as unknown)
-      if (layout) {
-        bundle = { ...bundle, [scope]: layout }
-        changed = true
-      }
-    } catch {
-      /* ignore */
+function migrateLegacyScope(scope: DataViewScope): DashboardLayoutV1 | null {
+  const legacyKey = LEGACY_KEYS[scope]
+  if (typeof window === "undefined") return null
+  try {
+    const raw = localStorage.getItem(legacyKey)
+    if (!raw) return null
+    return parseLayout(JSON.parse(raw))
+  } catch {
+    return null
+  }
+}
+
+/** One-time migration: copy legacy placements/team/compliance slices into list-hub when empty. */
+function migrateRemovedHubScopes(bundle: LayoutBundle): LayoutBundle {
+  if (bundle["list-hub"]) return bundle
+  for (const legacy of LEGACY_SCOPES) {
+    const layout = bundle[legacy]
+    if (layout) {
+      return { ...bundle, "list-hub": layout }
     }
   }
-  if (changed) writeBundle(bundle)
+  const fromPlacementsKey = migrateLegacyScope("list-hub")
+  if (fromPlacementsKey) return { ...bundle, "list-hub": fromPlacementsKey }
   return bundle
 }
 
 /**
- * Load persisted layout for a hub (Placements / Team / Compliance Data view).
+ * Load persisted layout for a hub Data view.
  */
 export function loadDataViewLayout(scope: DataViewScope): DashboardLayoutV1 | null {
-  const bundle = ensureBundleWithLegacy()
-  return bundle[scope] ?? null
+  const bundle = migrateRemovedHubScopes(readBundleRaw())
+  return bundle[scope] ?? migrateLegacyScope(scope)
 }
 
-/**
- * Save layout for one hub; updates the shared bundle atomically.
- */
+/** Persist layout for a hub Data view. */
 export function saveDataViewLayout(scope: DataViewScope, layout: DashboardLayoutV1) {
-  const bundle = ensureBundleWithLegacy()
-  writeBundle({ ...bundle, [scope]: layout })
+  const bundle = migrateRemovedHubScopes(readBundleRaw())
+  bundle[scope] = layout
+  writeBundleRaw(bundle)
 }

package/template/lib/hub-connected-view-renderers.ts

@@ -0,0 +1,58 @@
+/**
+ * Typed `ListPageConnectedViewBody` renderers aligned with `supportedViewTypes`.
+ */
+
+import type * as React from "react"
+import type { DataListViewType } from "@/lib/data-list-view"
+import {
+  getDataListViewRenderKind,
+  type DataListViewRenderKind,
+} from "@/lib/data-list-view-registry"
+import type { ListPageConnectedViewRenderers } from "@/components/data-views/list-page-connected-view-body"
+
+/** Maps each `DataListViewType` to its `DataListViewRenderKind` (compile-time). */
+export type DataListViewRenderKindMap = {
+  table: "data-table"
+  list: "list-with-toolbar"
+  board: "board-with-toolbar"
+  dashboard: "dashboard-with-toolbar"
+  calendar: "calendar-with-toolbar"
+  folder: "folder-with-toolbar"
+  panel: "panel-with-toolbar"
+  "tree-panel": "tree-panel-with-toolbar"
+}
+
+export type HubRenderKindForViews<Supported extends readonly DataListViewType[]> =
+  DataListViewRenderKindMap[Supported[number]]
+
+export type HubConnectedViewRenderers<Supported extends readonly DataListViewType[]> = Partial<
+  Record<HubRenderKindForViews<Supported>, React.ReactNode | (() => React.ReactNode)>
+>
+
+/** Render kinds required for a hub's `supportedViewTypes` array. */
+export function hubRenderKindsForSupported(
+  supported: readonly DataListViewType[],
+): DataListViewRenderKind[] {
+  return supported.map(v => getDataListViewRenderKind(v))
+}
+
+/**
+ * Build renderers for `ListPageConnectedViewBody` and warn in dev when a supported view has no body.
+ */
+export function defineHubViewRenderers<Supported extends readonly DataListViewType[]>(
+  supported: Supported,
+  renderers: HubConnectedViewRenderers<Supported>,
+): ListPageConnectedViewRenderers {
+  if (process.env.NODE_ENV !== "production") {
+    for (const viewType of supported) {
+      const kind = getDataListViewRenderKind(viewType)
+      if (renderers[kind as HubRenderKindForViews<Supported>] == null) {
+        console.warn(
+          `[Exxat DS] Missing ListPageConnectedViewBody renderer for view "${viewType}" (${kind}). ` +
+            "Add it to defineHubViewRenderers or remove the view from supportedViewTypes.",
+        )
+      }
+    }
+  }
+  return renderers as ListPageConnectedViewRenderers
+}

package/template/lib/list-hub-nav.ts

@@ -0,0 +1,121 @@
+/**
+ * List hub secondary panel + URL scope — demo filters on {@link LIST_HUB_DIRECTORY}.
+ */
+
+import type { ListHubRecord } from "@/lib/mock/list-hub-directory"
+
+export const LIST_HUB_PATH = "/data-list"
+
+export type ListHubNavScope = "all" | "upcoming" | "past" | "category"
+
+export interface ListHubNavState {
+  scope: ListHubNavScope
+  /** Set when `scope === "category"` */
+  category: string | null
+}
+
+export const LIST_HUB_DEFAULT_NAV: ListHubNavState = {
+  scope: "all",
+  category: null,
+}
+
+export const LIST_HUB_CATEGORY_SCOPES = ["Training", "Field", "Clinical", "Admin"] as const
+
+export type ListHubCategoryScope = (typeof LIST_HUB_CATEGORY_SCOPES)[number]
+
+export function parseListHubNav(searchParams: URLSearchParams): ListHubNavState {
+  const raw = (searchParams.get("scope") ?? "all").toLowerCase()
+  if (raw === "upcoming") return { scope: "upcoming", category: null }
+  if (raw === "past") return { scope: "past", category: null }
+  if (raw === "category") {
+    const category = searchParams.get("category")?.trim() || null
+    return { scope: "category", category }
+  }
+  return { ...LIST_HUB_DEFAULT_NAV }
+}
+
+export function isListHubDefaultNav(nav: ListHubNavState): boolean {
+  return nav.scope === "all" && nav.category === null
+}
+
+export function isListHubNavActive(
+  pathname: string,
+  nav: ListHubNavState,
+  scope: ListHubNavScope,
+  category?: string | null,
+): boolean {
+  const p = pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname
+  if (p !== LIST_HUB_PATH) return false
+  if (scope === "all") return nav.scope === "all"
+  if (scope === "upcoming") return nav.scope === "upcoming"
+  if (scope === "past") return nav.scope === "past"
+  if (scope === "category" && category) {
+    return nav.scope === "category" && nav.category === category
+  }
+  return false
+}
+
+export function listHubNavHref(opts: {
+  scope: ListHubNavScope
+  category?: string | null
+  hash?: string
+}): string {
+  const params = new URLSearchParams()
+  if (opts.scope !== "all") params.set("scope", opts.scope)
+  if (opts.scope === "category" && opts.category) params.set("category", opts.category)
+  const q = params.toString()
+  const hash = opts.hash ?? ""
+  return `${LIST_HUB_PATH}${q ? `?${q}` : ""}${hash}`
+}
+
+export function listHubHubScopeHref(
+  pathname: string,
+  currentSearch: URLSearchParams,
+  patch: { scope: ListHubNavScope; category?: string | null },
+): string {
+  void pathname
+  void currentSearch
+  return listHubNavHref({
+    scope: patch.scope,
+    category: patch.scope === "category" ? patch.category : null,
+  })
+}
+
+function todayIsoDate(): string {
+  return new Date().toISOString().slice(0, 10)
+}
+
+export function filterListHubRows(rows: ListHubRecord[], nav: ListHubNavState): ListHubRecord[] {
+  const today = todayIsoDate()
+  switch (nav.scope) {
+    case "upcoming":
+      return rows.filter(r => r.eventDate >= today)
+    case "past":
+      return rows.filter(r => r.eventDate < today)
+    case "category":
+      if (!nav.category) return rows
+      return rows.filter(r => r.category === nav.category)
+    case "all":
+    default:
+      return rows
+  }
+}
+
+export function listHubScopeLabel(nav: ListHubNavState): string {
+  switch (nav.scope) {
+    case "upcoming":
+      return "Upcoming"
+    case "past":
+      return "Past"
+    case "category":
+      return nav.category ?? "Category"
+    case "all":
+    default:
+      return "All records"
+  }
+}
+
+export function listHubHeaderSubtitle(nav: ListHubNavState, count: number): string {
+  const noun = count === 1 ? "record" : "records"
+  return `${count} ${noun} · ${listHubScopeLabel(nav)} · One dataset across table, calendar, and board`
+}

package/template/lib/list-hub-supported-views.ts

@@ -0,0 +1,10 @@
+import type { DataListViewType } from "@/lib/data-list-view"
+
+/** Views implemented in `ListHubTable` — keep in sync with `ListPageConnectedViewBody` renderers. */
+export const LIST_HUB_SUPPORTED_VIEWS = [
+  "table",
+  "list",
+  "board",
+  "calendar",
+  "panel",
+] as const satisfies readonly DataListViewType[]

package/template/lib/list-page-table-properties.ts

@@ -10,19 +10,15 @@
 import * as React from "react"
 
 import { dataListViewIcon, type DataListViewType } from "@/lib/data-list-view"
+import { isDataListSurfaceViewType } from "@/lib/data-list-view-registry"
+
+export { isDataListSurfaceViewType }
 
 /** Minimal ref API any list/table surface exposes for the shared Properties drawer. */
 export interface OpenTablePropertiesHandle {
   openPropertiesDrawer: () => void
 }
 
-const SURFACE_VIEW_TYPES = new Set<DataListViewType>(["table", "list", "board", "dashboard"])
-
-/** True when `viewType` is one of the data-list surfaces that support TablePropertiesDrawer. */
-export function isDataListSurfaceViewType(viewType: string): viewType is DataListViewType {
-  return SURFACE_VIEW_TYPES.has(viewType as DataListViewType)
-}
-
 export interface CreateListPageEditViewHandlerOptions {
   /** Delay before opening Properties after switching to table (ms). Default 160. */
   switchDelayMs?: number

package/template/lib/list-status-badges.ts

@@ -1,22 +1,16 @@
 /**
  * Shared status chip labels, tint classes, and FA icon names for product list hubs
- * (Placements, Team, Compliance — table, list, board), plus related chips
- * (dashboard **task priority**, placement **readiness** on the detail drawer).
+ * (Question bank, list hub, future entities), plus related chips (dashboard **task priority**).
  *
  * Labels use **sentence / title case** (e.g. "Due soon", "Under Review"). Do **not** add **`uppercase`**.
  *
- * **Rendering:** Use **`ListHubStatusBadge`** from `@/components/list-hub-status-badge`, or
- * **`StatusBadge`** from **`components/placements-table-cells.tsx`** for placement rows (wrapper
- * around **`ListHubStatusBadge`** + **`PLACEMENT_STATUS_*`** below). Task priority → **`TaskPriorityBadge`**.
+ * **Rendering:** Use **`ListHubStatusBadge`** from `@/components/list-hub-status-badge`.
+ * Task priority → **`TaskPriorityBadge`**.
  *
  * **Semantic tints:** Map domain statuses onto **`LIST_HUB_STATUS_TINT_*`** before inventing new colors.
  * **Icon-on-tinted-disc** (insights / activity): **`TintedIconDisc`** + **`--icon-disc-*`** in **`app/globals.css`**.
  */
 
-import type { ComplianceStatus } from "@/lib/mock/compliance"
-import type { Status as PlacementStatus } from "@/lib/mock/placements"
-import type { TeamMember } from "@/lib/mock/team"
-
 // ─── Semantic variants (reuse for new entities) ─────────────────────────────
 //
 // **Light washes** (same visual weight as before) + **darker ink** via `--chip-*` for WCAG 1.4.3.
@@ -34,24 +28,10 @@ export const LIST_HUB_STATUS_TINT_NEUTRAL =
 export const LIST_HUB_STATUS_TINT_DANGER =
   "bg-destructive/15 text-[var(--chip-destructive)] border-destructive/20 dark:bg-destructive/15 dark:text-red-200"
 
-/** In-progress / review (distinct from warning where both appear — e.g. Placements “Under review”). */
+/** In-progress / review (distinct from warning where both appear). */
 export const LIST_HUB_STATUS_TINT_INFO =
   "bg-sky-500/15 text-[var(--chip-1)] border-sky-500/20 dark:bg-sky-500/15 dark:text-sky-100"
 
-// ─── Placement detail — readiness row (string labels from mock) ─────────────
-
-const PLACEMENT_READINESS_BADGE_CLASS: Record<string, string> = {
-  Ready: LIST_HUB_STATUS_TINT_SUCCESS,
-  "At risk": LIST_HUB_STATUS_TINT_DANGER,
-  Blocked: LIST_HUB_STATUS_TINT_DANGER,
-  "In review": LIST_HUB_STATUS_TINT_INFO,
-}
-
-/** Badge `className` tail for placement readiness labels; unknown → neutral. */
-export function placementReadinessBadgeClass(readiness: string): string {
-  return PLACEMENT_READINESS_BADGE_CLASS[readiness] ?? LIST_HUB_STATUS_TINT_NEUTRAL
-}
-
 // ─── Dashboard task priority (shared chip system) ──────────────────────────
 
 export type TaskPriorityLevel = "high" | "medium" | "low"
@@ -73,76 +53,3 @@ export function normalizeTaskPriority(priority: string): TaskPriorityLevel | nul
   if (k === "high" || k === "medium" || k === "low") return k
   return null
 }
-
-// ─── Placements (lifecycle status) ───────────────────────────────────────
-
-export const PLACEMENT_STATUS_LABEL: Record<PlacementStatus, string> = {
-  confirmed: "Confirmed",
-  pending: "Pending",
-  "under-review": "Under Review",
-  rejected: "Rejected",
-  completed: "Completed",
-}
-
-export const PLACEMENT_STATUS_BADGE_CLASS: Record<PlacementStatus, string> = {
-  confirmed: LIST_HUB_STATUS_TINT_SUCCESS,
-  pending: LIST_HUB_STATUS_TINT_WARNING,
-  "under-review": LIST_HUB_STATUS_TINT_INFO,
-  rejected: LIST_HUB_STATUS_TINT_DANGER,
-  completed: LIST_HUB_STATUS_TINT_NEUTRAL,
-}
-
-export const PLACEMENT_STATUS_ICON: Record<PlacementStatus, string> = {
-  confirmed: "fa-circle-check",
-  pending: "fa-hourglass-half",
-  "under-review": "fa-eye",
-  rejected: "fa-circle-xmark",
-  completed: "fa-clipboard-check",
-}
-
-// ─── Team ─────────────────────────────────────────────────────────────────
-
-export type TeamMemberStatus = TeamMember["status"]
-
-export const TEAM_MEMBER_STATUS_LABEL: Record<TeamMemberStatus, string> = {
-  active: "Active",
-  away: "Away",
-  invited: "Invited",
-}
-
-export const TEAM_MEMBER_STATUS_BADGE_CLASS: Record<TeamMemberStatus, string> = {
-  active: LIST_HUB_STATUS_TINT_SUCCESS,
-  away: LIST_HUB_STATUS_TINT_WARNING,
-  invited: LIST_HUB_STATUS_TINT_NEUTRAL,
-}
-
-/** Font Awesome icon per status — shape + label, not colour alone (WCAG 1.4.1). */
-export const TEAM_MEMBER_STATUS_ICON: Record<TeamMemberStatus, string> = {
-  active: "fa-circle-check",
-  away: "fa-moon",
-  invited: "fa-envelope",
-}
-
-// ─── Compliance ───────────────────────────────────────────────────────────
-
-export const COMPLIANCE_STATUS_LABEL: Record<ComplianceStatus, string> = {
-  compliant: "Compliant",
-  due_soon: "Due soon",
-  overdue: "Overdue",
-  pending: "Pending",
-}
-
-export const COMPLIANCE_STATUS_BADGE_CLASS: Record<ComplianceStatus, string> = {
-  compliant: LIST_HUB_STATUS_TINT_SUCCESS,
-  due_soon: LIST_HUB_STATUS_TINT_WARNING,
-  overdue: LIST_HUB_STATUS_TINT_DANGER,
-  pending: LIST_HUB_STATUS_TINT_NEUTRAL,
-}
-
-export const COMPLIANCE_STATUS_ICON: Record<ComplianceStatus, string> = {
-  compliant: "fa-shield-check",
-  due_soon: "fa-clock",
-  overdue: "fa-triangle-exclamation",
-  pending: "fa-hourglass-half",
-}
-

package/template/lib/mock/list-hub-directory.ts

@@ -0,0 +1,27 @@
+/** Row shape for the List hub (`/data-list`) — one dataset for table, calendar, board, etc. */
+export interface ListHubRecord extends Record<string, unknown> {
+  id: string
+  title: string
+  category: string
+  /** ISO date (YYYY-MM-DD) for calendar view */
+  eventDate: string
+}
+
+function addDays(base: Date, days: number) {
+  const d = new Date(base)
+  d.setDate(d.getDate() + days)
+  return d.toISOString().slice(0, 10)
+}
+
+const BASE = new Date()
+
+export const LIST_HUB_DIRECTORY: ListHubRecord[] = [
+  { id: "LH-2401", title: "Orientation workshop", category: "Training", eventDate: addDays(BASE, 2) },
+  { id: "LH-2402", title: "Site visit — Metro campus", category: "Field", eventDate: addDays(BASE, 5) },
+  { id: "LH-2403", title: "Compliance review", category: "Admin", eventDate: addDays(BASE, 9) },
+  { id: "LH-2404", title: "Preceptor check-in", category: "Clinical", eventDate: addDays(BASE, 12) },
+  { id: "LH-2405", title: "Skills lab session", category: "Training", eventDate: addDays(BASE, 18) },
+  { id: "LH-2406", title: "Cohort debrief", category: "Admin", eventDate: addDays(BASE, 22) },
+  { id: "LH-2407", title: "Documentation audit", category: "Admin", eventDate: addDays(BASE, -3) },
+  { id: "LH-2408", title: "Weekend rotation", category: "Clinical", eventDate: addDays(BASE, -7) },
+]

package/template/lib/mock/list-hub-kpi.ts

@@ -0,0 +1,27 @@
+import type { MetricInsight, MetricItem } from "@/components/key-metrics"
+import type { ListHubRecord } from "@/lib/mock/list-hub-directory"
+
+export function listHubKpiMetrics(countOrRows: number | ListHubRecord[]): MetricItem[] {
+  const count = typeof countOrRows === "number" ? countOrRows : countOrRows.length
+  const scheduled = Math.max(0, count - 2)
+  const thisWeek = Math.min(count, 4)
+  return [
+    {
+      id: "total",
+      label: "Total records",
+      value: count,
+      delta: "+2",
+      trend: "up",
+      href: "#",
+      metricVariant: "hero",
+    },
+    { id: "scheduled", label: "Scheduled", value: scheduled, delta: "+1", trend: "up", href: "#" },
+    { id: "this-week", label: "This week", value: thisWeek, delta: "—", trend: "neutral", href: "#" },
+    { id: "completed", label: "Completed", value: 2, delta: "—", trend: "neutral", href: "#" },
+  ]
+}
+
+export const LIST_HUB_KPI_INSIGHT: MetricInsight = {
+  title: "3 events land this week",
+  description: "Filtered calendar and table views share the same row set after search and filters.",
+}

package/template/lib/mock/navigation.tsx

@@ -138,6 +138,7 @@ export const NAV_PRIMARY: NavLinkItem[] = [
     icon:       <i className="fa-light fa-table" aria-hidden="true" />,
     iconActive: <i className="fa-solid fa-table" aria-hidden="true" />,
     badge: 24,
+    secondaryPanel: "list-hub",
   },
 ]
 

package/template/lib/page-loading-variant.ts

@@ -0,0 +1,40 @@
+/**
+ * Maps app routes to loading skeleton layouts — keep in sync with page templates
+ * (`PrimaryPageTemplate`, `FocusedWorkflowPageTemplate`, dedicated search, hub landing).
+ */
+
+export type PageLoadingVariant =
+  | "dashboard"
+  | "primary-list-hub"
+  | "question-bank-hub"
+  | "dedicated-search"
+  | "focused-workflow"
+  | "focused-workflow-sidebar"
+  | "simple"
+
+function normalizePathname(pathname: string): string {
+  if (!pathname || pathname === "/") return "/"
+  return pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname
+}
+
+/** Pick the loading skeleton for the destination route (client-safe). */
+export function resolvePageLoadingVariant(pathname: string): PageLoadingVariant {
+  const path = normalizePathname(pathname)
+
+  if (path === "/dashboard") return "dashboard"
+  if (path === "/settings") return "focused-workflow-sidebar"
+  if (path === "/help" || path === "/examples" || path.startsWith("/examples/")) {
+    return path === "/examples/focused-workflow" ? "focused-workflow-sidebar" : "simple"
+  }
+  if (path === "/question-bank/new" || path.startsWith("/question-bank/new/")) {
+    return "focused-workflow"
+  }
+  if (path === "/question-bank/find" || path === "/question-bank/list") {
+    return "dedicated-search"
+  }
+  if (path === "/question-bank") return "question-bank-hub"
+  if (path.startsWith("/question-bank/")) return "primary-list-hub"
+  if (path === "/data-list") return "primary-list-hub"
+
+  return "primary-list-hub"
+}

package/template/lib/question-bank-supported-views.ts

@@ -0,0 +1,13 @@
+import type { DataListViewType } from "@/lib/data-list-view"
+
+/** Views implemented in `QuestionBankTable` — keep in sync with `ListPageConnectedViewBody` renderers. */
+export const QUESTION_BANK_SUPPORTED_VIEWS = [
+  "table",
+  "list",
+  "board",
+  "dashboard",
+  "calendar",
+  "folder",
+  "panel",
+  "tree-panel",
+] as const satisfies readonly DataListViewType[]

package/template/lib/sidebar-state-cookie.ts

@@ -0,0 +1,9 @@
+/** Cookie name persisted by `@exxatdesignux/ui` `SidebarProvider` (`setOpen`). */
+export const SIDEBAR_STATE_COOKIE_NAME = "sidebar_state"
+
+/** Read desktop sidebar expanded state for SSR `defaultOpen` (matches client cookie restore). */
+export function sidebarDefaultOpenFromCookie(
+  value: string | undefined,
+): boolean {
+  return value !== "false"
+}