@exxatdesignux/ui 0.2.19 → 0.3.0

package/template/lib/mock/placements.ts

@@ -0,0 +1,176 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Mock data — Placements
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type Status = "confirmed" | "pending" | "under-review" | "rejected" | "completed"
+
+/** Which lifecycle tab owns this row (All shows every row). */
+export type PlacementPhase = "upcoming" | "ongoing" | "completed"
+
+export interface Placement extends Record<string, unknown> {
+  id: number
+  student: string
+  email: string
+  initials: string
+  program: string
+  site: string
+  siteAddress: string
+  status: Status
+  start: string
+  duration: string
+  supervisor: string
+  placementPhase: PlacementPhase
+  /** Display title for internship column */
+  internship: string
+  specialization: string
+  /** Upcoming */
+  compliance: string
+  daysUntilStart: number
+  readiness: string
+  /** Ongoing */
+  progressWeeksDone: number
+  progressWeeksTotal: number
+  endDate: string
+  lastCheckin: string
+  /** Completed */
+  completionDate: string
+  finalStatus: string
+  rating: number
+  suggestedToHire: string
+  /** Visual indicator — row has new activity or was recently updated */
+  isNew?: boolean
+}
+
+export const ALL_PLACEMENTS: Placement[] = [
+  {
+    id: 1, student: "Sarah Johnson", email: "s.johnson@college.edu", initials: "SJ", program: "Nursing", site: "City Medical Center",
+    siteAddress: "1400 N Lake Shore Dr, Chicago, IL", status: "confirmed", start: "03/15/2026", duration: "12 wks", supervisor: "Dr. Patel",
+    placementPhase: "ongoing", internship: "Med-Surg Clinical I", specialization: "Adult Health", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 5, progressWeeksTotal: 12, endDate: "06/07/2026", lastCheckin: "03/22/2026",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—", isNew: true,
+  },
+  {
+    id: 2, student: "Mike Chen", email: "m.chen@university.edu", initials: "MC", program: "Physical Therapy", site: "Metro Rehab",
+    siteAddress: "250 E Superior St, Chicago, IL", status: "pending", start: "04/01/2026", duration: "8 wks", supervisor: "Dr. Kim",
+    placementPhase: "upcoming", internship: "Outpatient PT Rotation", specialization: "Orthopedics", compliance: "In progress", daysUntilStart: 8,
+    readiness: "Ready", progressWeeksDone: 0, progressWeeksTotal: 8, endDate: "05/27/2026", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 3, student: "Amy Park", email: "a.park@school.edu", initials: "AP", program: "Occupational Therapy", site: "Bay Area Health",
+    siteAddress: "3100 Telegraph Ave, Oakland, CA", status: "under-review", start: "03/28/2026", duration: "10 wks", supervisor: "Unassigned",
+    placementPhase: "upcoming", internship: "Acute Care OT", specialization: "Hand Therapy", compliance: "Pending documents", daysUntilStart: 4,
+    readiness: "At risk", progressWeeksDone: 0, progressWeeksTotal: 10, endDate: "06/06/2026", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—", isNew: true,
+  },
+  {
+    id: 4, student: "James Williams", email: "j.williams@college.edu", initials: "JW", program: "Nursing", site: "Sunrise Hospital",
+    siteAddress: "5775 Wayzata Blvd, Minneapolis, MN", status: "confirmed", start: "04/07/2026", duration: "12 wks", supervisor: "Dr. Torres",
+    placementPhase: "ongoing", internship: "ICU Practicum", specialization: "Critical Care", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 2, progressWeeksTotal: 12, endDate: "06/30/2026", lastCheckin: "03/21/2026",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 5, student: "Emily Davis", email: "e.davis@university.edu", initials: "ED", program: "Social Work", site: "Community Care",
+    siteAddress: "220 S State St, Chicago, IL", status: "rejected", start: "—", duration: "—", supervisor: "—",
+    placementPhase: "upcoming", internship: "Community SW Field", specialization: "Behavioral Health", compliance: "Incomplete", daysUntilStart: 0,
+    readiness: "Blocked", progressWeeksDone: 0, progressWeeksTotal: 10, endDate: "—", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 6, student: "Carlos Rivera", email: "c.rivera@school.edu", initials: "CR", program: "Physical Therapy", site: "Summit Sports Med",
+    siteAddress: "900 N Michigan Ave, Chicago, IL", status: "pending", start: "04/14/2026", duration: "8 wks", supervisor: "Dr. Lee",
+    placementPhase: "upcoming", internship: "Sports Medicine PT", specialization: "Sports Rehab", compliance: "Complete", daysUntilStart: 21,
+    readiness: "Ready", progressWeeksDone: 0, progressWeeksTotal: 8, endDate: "06/09/2026", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 7, student: "Priya Sharma", email: "p.sharma@college.edu", initials: "PS", program: "Nursing", site: "Harbor Medical",
+    siteAddress: "1200 W Harrison St, Chicago, IL", status: "confirmed", start: "03/22/2026", duration: "12 wks", supervisor: "Dr. Patel",
+    placementPhase: "ongoing", internship: "Pediatric Nursing", specialization: "Pediatrics", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 7, progressWeeksTotal: 12, endDate: "06/14/2026", lastCheckin: "03/23/2026",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—", isNew: true,
+  },
+  {
+    id: 8, student: "Tom Bradley", email: "t.bradley@university.edu", initials: "TB", program: "Occupational Therapy", site: "Valley Health",
+    siteAddress: "4646 N Marine Dr, Chicago, IL", status: "under-review", start: "04/03/2026", duration: "10 wks", supervisor: "Dr. Wong",
+    placementPhase: "upcoming", internship: "Rehabilitation OT", specialization: "Neuro", compliance: "Review", daysUntilStart: 10,
+    readiness: "In review", progressWeeksDone: 0, progressWeeksTotal: 10, endDate: "06/12/2026", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 9, student: "Lena Fischer", email: "l.fischer@school.edu", initials: "LF", program: "Nursing", site: "Westside Clinic",
+    siteAddress: "2525 S Michigan Ave, Chicago, IL", status: "confirmed", start: "03/18/2026", duration: "12 wks", supervisor: "Dr. Santos",
+    placementPhase: "ongoing", internship: "Primary Care RN", specialization: "Family Practice", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 8, progressWeeksTotal: 12, endDate: "06/10/2026", lastCheckin: "03/24/2026",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 10, student: "Omar Hassan", email: "o.hassan@college.edu", initials: "OH", program: "Physical Therapy", site: "Metro Rehab",
+    siteAddress: "250 E Superior St, Chicago, IL", status: "pending", start: "04/21/2026", duration: "8 wks", supervisor: "Dr. Kim",
+    placementPhase: "upcoming", internship: "Neurologic PT", specialization: "Neuro Rehab", compliance: "Pending", daysUntilStart: 28,
+    readiness: "Ready", progressWeeksDone: 0, progressWeeksTotal: 8, endDate: "06/16/2026", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 11, student: "Nina Patel", email: "n.patel@university.edu", initials: "NP", program: "Social Work", site: "Hope Community Ctr",
+    siteAddress: "3517 W Arthington St, Chicago, IL", status: "confirmed", start: "03/25/2026", duration: "10 wks", supervisor: "Ms. Torres",
+    placementPhase: "ongoing", internship: "School Social Work", specialization: "Youth Services", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 4, progressWeeksTotal: 10, endDate: "06/03/2026", lastCheckin: "03/19/2026",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 12, student: "David Okonkwo", email: "d.okonkwo@school.edu", initials: "DO", program: "Nursing", site: "Lakeside Hospital",
+    siteAddress: "4440 N Clark St, Chicago, IL", status: "under-review", start: "04/10/2026", duration: "12 wks", supervisor: "Unassigned",
+    placementPhase: "upcoming", internship: "Emergency Dept RN", specialization: "Emergency", compliance: "Pending", daysUntilStart: 17,
+    readiness: "At risk", progressWeeksDone: 0, progressWeeksTotal: 12, endDate: "07/03/2026", lastCheckin: "—",
+    completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
+  },
+  {
+    id: 13, student: "Alex Morgan", email: "a.morgan@college.edu", initials: "AM", program: "Nursing", site: "City Medical Center",
+    siteAddress: "1400 N Lake Shore Dr, Chicago, IL", status: "completed", start: "01/06/2026", duration: "12 wks", supervisor: "Dr. Patel",
+    placementPhase: "completed", internship: "Med-Surg Clinical II", specialization: "Adult Health", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 12, progressWeeksTotal: 12, endDate: "03/30/2026", lastCheckin: "03/28/2026",
+    completionDate: "03/30/2026", finalStatus: "Passed", rating: 4.8, suggestedToHire: "Yes",
+  },
+  {
+    id: 14, student: "Jordan Lee", email: "j.lee@university.edu", initials: "JL", program: "Physical Therapy", site: "Metro Rehab",
+    siteAddress: "250 E Superior St, Chicago, IL", status: "completed", start: "11/04/2025", duration: "8 wks", supervisor: "Dr. Kim",
+    placementPhase: "completed", internship: "Inpatient PT", specialization: "Acute Care", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 8, progressWeeksTotal: 8, endDate: "12/30/2025", lastCheckin: "12/28/2025",
+    completionDate: "12/30/2025", finalStatus: "Passed", rating: 4.2, suggestedToHire: "Yes",
+  },
+  {
+    id: 15, student: "Sam Rivera", email: "s.rivera@school.edu", initials: "SR", program: "Occupational Therapy", site: "Bay Area Health",
+    siteAddress: "3100 Telegraph Ave, Oakland, CA", status: "completed", start: "10/01/2025", duration: "10 wks", supervisor: "Dr. Nguyen",
+    placementPhase: "completed", internship: "Hand Therapy OT", specialization: "Hand Therapy", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 10, progressWeeksTotal: 10, endDate: "12/10/2025", lastCheckin: "12/08/2025",
+    completionDate: "12/10/2025", finalStatus: "Incomplete", rating: 3.5, suggestedToHire: "No",
+  },
+  {
+    id: 16, student: "Taylor Brooks", email: "t.brooks@college.edu", initials: "TB", program: "Nursing", site: "Sunrise Hospital",
+    siteAddress: "5775 Wayzata Blvd, Minneapolis, MN", status: "completed", start: "09/02/2025", duration: "12 wks", supervisor: "Dr. Torres",
+    placementPhase: "completed", internship: "Labor & Delivery", specialization: "Women's Health", compliance: "Complete", daysUntilStart: 0,
+    readiness: "Ready", progressWeeksDone: 12, progressWeeksTotal: 12, endDate: "11/25/2025", lastCheckin: "11/22/2025",
+    completionDate: "11/25/2025", finalStatus: "Passed", rating: 5, suggestedToHire: "Yes",
+  },
+]
+
+/** Distinct sorted values for filter dropdowns (list UI) on text-like columns. */
+export function uniquePlacementFieldOptions(
+  key: keyof Placement,
+): { value: string; label: string }[] {
+  const set = new Set<string>()
+  for (const r of ALL_PLACEMENTS) {
+    const raw = r[key]
+    if (raw === undefined || raw === null) continue
+    const v = typeof raw === "number" ? String(raw) : String(raw).trim()
+    if (!v || v === "—") continue
+    set.add(v)
+  }
+  return [...set].sort((a, b) => a.localeCompare(b)).map(v => ({ value: v, label: v }))
+}
+
+export function getPlacementById(id: number): Placement | undefined {
+  return ALL_PLACEMENTS.find(p => p.id === id)
+}

package/template/lib/mock/sites-directory.ts

@@ -0,0 +1,16 @@
+import { NAV_PRIMARY } from "@/lib/mock/navigation"
+
+/** Clinical site row — same source as legacy Sites nav children. */
+export interface SiteDirectoryRow extends Record<string, unknown> {
+  id: string
+  name: string
+  url: string
+}
+
+export const SITES_DIRECTORY: SiteDirectoryRow[] = (NAV_PRIMARY.find(i => i.key === "sites")?.children ?? []).map(
+  c => ({
+    id: c.key,
+    name: c.title,
+    url: c.url,
+  }),
+)

package/template/lib/mock/sites-kpi.ts

@@ -0,0 +1,25 @@
+import type { MetricInsight, MetricItem } from "@/components/key-metrics"
+
+export function sitesKpiMetrics(count: number): MetricItem[] {
+  const active = Math.max(0, count - 3)
+  const pending = Math.min(count, 3)
+  return [
+    {
+      id: "total-sites",
+      label: "Total sites",
+      value: count,
+      delta: "+4",
+      trend: "up",
+      href: "#",
+      metricVariant: "hero",
+    },
+    { id: "active", label: "Active", value: active, delta: "+3", trend: "up", href: "#" },
+    { id: "pending", label: "Pending", value: pending, delta: "—", trend: "neutral", href: "#" },
+    { id: "archived", label: "Archived", value: 0, delta: "—", trend: "neutral", href: "#" },
+  ]
+}
+
+export const SITES_KPI_INSIGHT: MetricInsight = {
+  title: "4 new sites added this month",
+  description: "Most recent additions are affiliated with the Nursing program.",
+}

package/template/lib/mock/team-kpi.ts

@@ -0,0 +1,60 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Team page — KPI strip (mirrors placements-kpi pattern for primary list template)
+// ─────────────────────────────────────────────────────────────────────────────
+
+import type { MetricInsight, MetricItem } from "@/components/key-metrics"
+import type { TeamMember } from "@/lib/mock/team"
+
+export function teamKpiMetrics(members: TeamMember[]): MetricItem[] {
+  const active = members.filter(m => m.status === "active").length
+  const away = members.filter(m => m.status === "away").length
+  const invited = members.filter(m => m.status === "invited").length
+  return [
+    {
+      id: "total-members",
+      label: "Total members",
+      value: members.length,
+      delta: "+2",
+      trend: "up",
+      href: "#",
+      metricVariant: "hero",
+    },
+    {
+      id: "active",
+      label: "Active",
+      value: active,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+    },
+    {
+      id: "away",
+      label: "Away",
+      value: away,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+    },
+    {
+      id: "invited",
+      label: "Invited",
+      value: invited,
+      delta: invited > 0 ? "+1" : "—",
+      trend: invited > 0 ? "up" : "neutral",
+      href: "#",
+    },
+  ]
+}
+
+export function teamKpiInsight(members: TeamMember[]): MetricInsight {
+  const invited = members.filter(m => m.status === "invited").length
+  return {
+    title: "Pending invites",
+    description:
+      invited > 0
+        ? `${invited} invitation(s) outstanding. Resend or revoke from the roster.`
+        : "No pending invitations.",
+    severity: invited > 0 ? "warning" : "info",
+    actionLabel: "Ask Leo",
+  }
+}

package/template/lib/mock/team.ts

@@ -0,0 +1,118 @@
+/**
+ * Mock team directory — replace with API data in production.
+ * Kept at 11+ rows so the Team page demonstrates search / sort / properties toolbar (see data-views-pattern.md).
+ */
+
+export interface TeamMember extends Record<string, unknown> {
+  id: string
+  name: string
+  role: string
+  email: string
+  /** US 10-digit storage (filter uses masked entry; matching normalizes digits). */
+  phone: string
+  initials: string
+  /** Shown as a subtle status chip */
+  status: "active" | "away" | "invited"
+}
+
+export const TEAM_MEMBERS: TeamMember[] = [
+  {
+    id: "1",
+    name: "Alex Rivera",
+    role: "Program Administrator",
+    email: "alex.rivera@school.edu",
+    phone: "5550100001",
+    initials: "AR",
+    status: "active",
+  },
+  {
+    id: "2",
+    name: "Jordan Chen",
+    role: "Clinical Coordinator",
+    email: "jordan.chen@school.edu",
+    phone: "5550100002",
+    initials: "JC",
+    status: "active",
+  },
+  {
+    id: "3",
+    name: "Sam Patel",
+    role: "Field Education",
+    email: "sam.patel@school.edu",
+    phone: "5550100003",
+    initials: "SP",
+    status: "away",
+  },
+  {
+    id: "4",
+    name: "Taylor Brooks",
+    role: "Viewer",
+    email: "taylor.brooks@school.edu",
+    phone: "5550100004",
+    initials: "TB",
+    status: "invited",
+  },
+  {
+    id: "5",
+    name: "Morgan Lee",
+    role: "Program Administrator",
+    email: "morgan.lee@school.edu",
+    phone: "5550100005",
+    initials: "ML",
+    status: "active",
+  },
+  {
+    id: "6",
+    name: "Casey Nguyen",
+    role: "Clinical Coordinator",
+    email: "casey.nguyen@school.edu",
+    phone: "5550100006",
+    initials: "CN",
+    status: "active",
+  },
+  {
+    id: "7",
+    name: "Riley Johnson",
+    role: "Field Education",
+    email: "riley.johnson@school.edu",
+    phone: "5550100007",
+    initials: "RJ",
+    status: "away",
+  },
+  {
+    id: "8",
+    name: "Quinn Martinez",
+    role: "Viewer",
+    email: "quinn.martinez@school.edu",
+    phone: "5550100008",
+    initials: "QM",
+    status: "active",
+  },
+  {
+    id: "9",
+    name: "Jamie Wilson",
+    role: "Program Administrator",
+    email: "jamie.wilson@school.edu",
+    phone: "5550100009",
+    initials: "JW",
+    status: "invited",
+  },
+  {
+    id: "10",
+    name: "Drew Anderson",
+    role: "Clinical Coordinator",
+    email: "drew.anderson@school.edu",
+    phone: "5550100010",
+    initials: "DA",
+    status: "active",
+  },
+  {
+    id: "11",
+    name: "Skyler Kim",
+    role: "Field Education",
+    email: "skyler.kim@school.edu",
+    phone: "5550100011",
+    initials: "SK",
+    status: "active",
+  },
+]

package/template/lib/placement-board-card-layout.ts

@@ -0,0 +1,79 @@
+/**
+ * Board placement card layout — which fields appear on the card by default,
+ * which keys are grouped into header / site / schedule blocks, and helpers to
+ * resolve "active" fields against current column visibility.
+ *
+ * Previously parameterized by `lifecycleTabId` (all / upcoming / ongoing / completed).
+ * Lifecycle has been removed — one canonical card definition is used everywhere
+ * and the card falls back to existing row data when a column is hidden.
+ */
+
+import type { ColumnDef } from "@/components/data-table/types"
+import type { Placement } from "@/lib/mock/placements"
+
+/** Default card fields — intersected with visible table columns (except header-only rules below). */
+export const DEFAULT_BOARD_CARD_KEYS: readonly string[] = [
+  "student",
+  "specialization",
+  "site",
+  "status",
+  "internship",
+  "start",
+  "duration",
+  "progressWeeksDone",
+  "endDate",
+  "daysUntilStart",
+  "completionDate",
+  "finalStatus",
+]
+
+export const SCHEDULE_KEYS: readonly string[] = [
+  "start",
+  "duration",
+  "daysUntilStart",
+  "progressWeeksDone",
+  "endDate",
+  "completionDate",
+  "finalStatus",
+]
+
+/** Keys rendered in the title/header cluster (not as icon rows). */
+export function consumedKeysForCard(): Set<string> {
+  return new Set<string>(["student", "status", "site", ...SCHEDULE_KEYS])
+}
+
+export function isKeyInBoardWhitelist(key: string): boolean {
+  return DEFAULT_BOARD_CARD_KEYS.includes(key)
+}
+
+/**
+ * Field is allowed on the card when it is in the whitelist, not hidden, and either
+ * the column exists in this view and is visible, or the column does not exist —
+ * then we still show from row data for header/summary fields.
+ */
+export function isBoardFieldActive<Row extends Placement>(
+  key: string,
+  hiddenColKeys: Set<string>,
+  boardColumns: ColumnDef<Row>[],
+): boolean {
+  if (hiddenColKeys.has(key)) return false
+  if (!isKeyInBoardWhitelist(key)) return false
+  const hasCol = boardColumns.some(c => c.key === key)
+  if (!hasCol) return true
+  return boardColumns.some(c => c.key === key && !hiddenColKeys.has(c.key))
+}
+
+/** Visible columns that pass whitelist (intersection). Order follows boardColumns. */
+export function filterColumnsForBoardCard<Row extends Placement>(
+  visibleCols: ColumnDef<Row>[],
+): ColumnDef<Row>[] {
+  return visibleCols.filter(c => isKeyInBoardWhitelist(c.key))
+}
+
+/** Body rows only: columns not consumed by title, header badges, site block, or schedule block. */
+export function remainingBodyColumns<Row extends Placement>(
+  cardCols: ColumnDef<Row>[],
+): ColumnDef<Row>[] {
+  const consumed = consumedKeysForCard()
+  return cardCols.filter(c => !consumed.has(c.key))
+}

package/template/lib/placements-supported-views.ts

@@ -0,0 +1,12 @@
+import type { DataListViewType } from "@/lib/data-list-view"
+
+/** Views implemented in `PlacementsTable` — keep in sync with the renderers passed to `HubTable`. */
+export const PLACEMENTS_SUPPORTED_VIEWS = [
+  "table",
+  "list",
+  "board",
+  "dashboard",
+  "folder",
+  "panel",
+  "tree-panel",
+] as const satisfies readonly DataListViewType[]

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

@@ -6,7 +6,6 @@ export const QUESTION_BANK_SUPPORTED_VIEWS = [
   "list",
   "board",
   "dashboard",
-  "calendar",
   "folder",
   "panel",
   "tree-panel",

package/template/lib/raf-throttle.ts

@@ -1,45 +1 @@
-/**
- * Coalesce many calls to `fn` into one per animation frame.
- *
- * Use for high-frequency layout-reading event handlers (scroll, resize,
- * visualViewport, ResizeObserver) where the work must happen in a frame but
- * doing it on every event call (60+/s for resize, hundreds/s for capture
- * scrolls) wastes layout/paint cycles. The returned function exposes
- * `.cancel()` so effect cleanup can drop a pending frame.
- *
- * Pattern:
- *   const apply = () => { ...layout reads + setState... }
- *   const scheduled = rafThrottle(apply)
- *   window.addEventListener("scroll", scheduled, { passive: true, capture: true })
- *   return () => {
- *     scheduled.cancel()
- *     window.removeEventListener("scroll", scheduled, { capture: true })
- *   }
- */
-export function rafThrottle<TArgs extends unknown[]>(
-  fn: (...args: TArgs) => void,
-): ((...args: TArgs) => void) & { cancel: () => void } {
-  let rafId = 0
-  let lastArgs: TArgs | null = null
-
-  const scheduled = ((...args: TArgs) => {
-    lastArgs = args
-    if (rafId !== 0) return
-    rafId = requestAnimationFrame(() => {
-      rafId = 0
-      const a = lastArgs
-      lastArgs = null
-      if (a) fn(...a)
-    })
-  }) as ((...args: TArgs) => void) & { cancel: () => void }
-
-  scheduled.cancel = () => {
-    if (rafId !== 0) {
-      cancelAnimationFrame(rafId)
-      rafId = 0
-    }
-    lastArgs = null
-  }
-
-  return scheduled
-}
+export { rafThrottle } from "@exxatdesignux/ui/lib/raf-throttle"

package/template/lib/row-height.ts

@@ -1,10 +1,4 @@
-/**
- * Table row density — shared by Properties drawer tiles and useTableState.
- */
-export type RowHeight = "compact" | "default" | "comfortable"
-
-export const ROW_HEIGHT_TILES: readonly { value: RowHeight; label: string; icon: string }[] = [
-  { value: "compact",     label: "Compact",     icon: "fa-down-to-line" },
-  { value: "default",     label: "Default",     icon: "fa-arrows-up-down" },
-  { value: "comfortable", label: "Comfortable", icon: "fa-up-to-line" },
-]
+export {
+  ROW_HEIGHT_TILES,
+  type RowHeight,
+} from "@exxatdesignux/ui/lib/row-height"

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

@@ -1,9 +1,18 @@
-/** Cookie name persisted by `@exxatdesignux/ui` `SidebarProvider` (`setOpen`). */
-export const SIDEBAR_STATE_COOKIE_NAME = "sidebar_state"
+/**
+ * Cookie name persisted by `@exxatdesignux/ui` `SidebarProvider` (`setOpen`).
+ *
+ * Versioned (`_v2`) on 2026-05-21 to drop stale values written by the pre-fix
+ * code where incidental layout collapses clobbered the user's preference on
+ * every navigation. The legacy `sidebar_state` cookie (without `_v2`) is
+ * ignored on the server and actively deleted client-side on first mount.
+ */
+export const SIDEBAR_STATE_COOKIE_NAME = "sidebar_state_v2"
 
 /** Read desktop sidebar expanded state for SSR `defaultOpen` (matches client cookie restore). */
 export function sidebarDefaultOpenFromCookie(
   value: string | undefined,
 ): boolean {
+  // No cookie OR malformed value → default expanded.
+  // Only an exact `"false"` from the new cookie counts as a saved collapsed preference.
   return value !== "false"
 }

package/template/lib/sites-supported-views.ts

@@ -0,0 +1,10 @@
+import type { DataListViewType } from "@/lib/data-list-view"
+
+/** Views implemented in `SitesTable` — keep in sync with the renderers passed to `HubTable`. */
+export const SITES_SUPPORTED_VIEWS = [
+  "table",
+  "list",
+  "board",
+  "panel",
+  "dashboard",
+] as const satisfies readonly DataListViewType[]

package/template/lib/table-state-lifecycle.ts

@@ -26,7 +26,7 @@ import type { RowHeight } from "@/lib/row-height"
 import type { DataListDisplayOptions } from "@/lib/data-list-display-options"
 import type { ActiveFilter, ConditionalRule, SortRule } from "@/components/table-properties/types"
 import type { ViewTab } from "@/components/templates/list-page"
-import { DATA_LIST_VIEW_TILES, type DataListViewType } from "@/lib/data-list-view"
+import type { DataListViewType } from "@/lib/data-list-view"
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Storage key + debounce config
@@ -139,7 +139,7 @@ export interface TableStatePersistSlice {
 // Parsers + validators
 // ─────────────────────────────────────────────────────────────────────────────
 
-const VIEW_TYPES: DataListViewType[] = DATA_LIST_VIEW_TILES.map(t => t.value)
+const VIEW_TYPES: DataListViewType[] = ["table", "list", "board", "dashboard"]
 
 function isViewType(v: unknown): v is DataListViewType {
   return typeof v === "string" && (VIEW_TYPES as string[]).includes(v)

package/template/lib/team-supported-views.ts

@@ -0,0 +1,10 @@
+import type { DataListViewType } from "@/lib/data-list-view"
+
+/** Views implemented in `TeamTable` — keep in sync with the renderers passed to `HubTable`. */
+export const TEAM_SUPPORTED_VIEWS = [
+  "table",
+  "list",
+  "board",
+  "panel",
+  "dashboard",
+] as const satisfies readonly DataListViewType[]

package/template/package.json

@@ -60,6 +60,7 @@
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3",
+    "@exxatdesignux/eslint-plugin": "workspace:*",
     "@next/bundle-analyzer": "16.2.6",
     "@tailwindcss/postcss": "^4.2.1",
     "@testing-library/jest-dom": "^6.9.1",