@exxatdesignux/ui 0.0.5 → 0.0.7

package/template/lib/mock/navigation.tsx

@@ -0,0 +1,231 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Mock data — Navigation
+// Uses .tsx because icons are JSX (<i> elements).
+// ─────────────────────────────────────────────────────────────────────────────
+
+import type * as React from "react"
+
+import { logoDevUrl } from "@/lib/logo-dev"
+import { stockPortraitUrl } from "@/lib/stock-portrait"
+
+// ── Types ─────────────────────────────────────────────────────────────────────
+
+/** Flat sidebar link (screenshot: primary + Documents + utilities) */
+export interface NavLinkItem {
+  key: string
+  title: string
+  url: string
+  icon: React.ReactNode
+  iconActive?: React.ReactNode
+  /** Optional child links — renders as a collapsible sub-menu */
+  children?: NavLinkItem[]
+  /** Optional inline badge — count (number) or label text (string).
+   *  Special string values get distinct colors:
+   *  "New" → green,  "Beta" → amber,  other strings → brand/primary  */
+  badge?: number | string
+  /**
+   * When this collapsible section uses `SecondaryPanel`, set the panel id so
+   * child links can reopen the panel on click while already on the same route
+   * (Next.js Link does not navigate on same href).
+   */
+  secondaryPanel?: string
+  /**
+   * When several children share the same `url` (hub route), only this child’s
+   * key receives `data-active` for that pathname — otherwise every sub-row
+   * looks selected (same issue as duplicate `href` in any nav).
+   */
+  primaryHubChildKey?: string
+}
+
+// ── Team / school switcher mock data ─────────────────────────────────────────
+
+export interface NavProgram { id: string; name: string }
+export interface NavSchool {
+  id: string
+  name: string
+  /** URL of school logo — used as the avatar image */
+  logo: string
+  /** Two-letter abbreviation shown as AvatarFallback */
+  initials: string
+  programs: NavProgram[]
+}
+
+export const NAV_SCHOOLS: NavSchool[] = [
+  {
+    id: "jhu",
+    name: "Johns Hopkins University",
+    logo: logoDevUrl("jhu.edu"),
+    initials: "JH",
+    programs: [
+      { id: "som", name: "School of Medicine" },
+      { id: "son", name: "School of Nursing" },
+      { id: "sph", name: "Bloomberg School of Public Health" },
+    ],
+  },
+  {
+    id: "mayo",
+    name: "Mayo Clinic Alix School of Medicine",
+    logo: logoDevUrl("mayoclinic.org"),
+    initials: "MC",
+    programs: [
+      { id: "md", name: "Doctor of Medicine" },
+      { id: "bms", name: "Biomedical Sciences" },
+    ],
+  },
+]
+
+export const NAV_SCHOOL_DEFAULT = NAV_SCHOOLS[0]
+export const NAV_PROGRAM_DEFAULT = NAV_SCHOOLS[0].programs[0]
+
+// ── Primary navigation ────────────────────────────────────────────────────────
+
+export const NAV_PRIMARY: NavLinkItem[] = [
+  {
+    key: "dashboard",
+    title: "Dashboard",
+    url: "/dashboard",
+    icon:       <i className="fa-light fa-grid-2" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-grid-2" aria-hidden="true" />,
+  },
+  {
+    key: "question-bank",
+    title: "Question bank",
+    url: "/question-bank",
+    icon:       <i className="fa-light fa-books" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-books" aria-hidden="true" />,
+  },
+  {
+    key: "data-list",
+    title: "Placements",
+    url: "/data-list",
+    icon:       <i className="fa-light fa-user-graduate" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-user-graduate" aria-hidden="true" />,
+    badge: 24,
+  },
+  {
+    key: "rotations",
+    title: "Rotations",
+    url: "/rotations",
+    icon:       <i className="fa-light fa-arrows-rotate" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-arrows-rotate" aria-hidden="true" />,
+    secondaryPanel: "rotations",
+    primaryHubChildKey: "view-all-rotations",
+    children: [
+      {
+        key: "rotation-1",
+        title: "Clinical Nursing — Fall 2026",
+        url: "/rotations",
+        icon: <i className="fa-light fa-folder" aria-hidden="true" />,
+      },
+      {
+        key: "rotation-2",
+        title: "PT Fieldwork — Spring 2026",
+        url: "/rotations",
+        icon: <i className="fa-light fa-folder" aria-hidden="true" />,
+      },
+      {
+        key: "rotation-3",
+        title: "OT Level II — Summer 2026",
+        url: "/rotations",
+        icon: <i className="fa-light fa-folder" aria-hidden="true" />,
+      },
+      {
+        key: "view-all-rotations",
+        title: "View all",
+        url: "/rotations",
+        icon: <i className="fa-light fa-arrow-right" aria-hidden="true" />,
+      },
+    ],
+  },
+  {
+    key: "sites",
+    title: "Sites",
+    url: "/sites/all",
+    icon:       <i className="fa-light fa-hospital" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-hospital" aria-hidden="true" />,
+    children: Array.from({ length: 45 }, (_, i) => ({
+      key: `site-${i + 1}`,
+      title: `Site ${String(i + 1).padStart(2, "0")}`,
+      url: `/sites/all#site-${i + 1}`,
+      icon: <i className="fa-light fa-hospital" aria-hidden="true" />,
+    })),
+  },
+]
+
+// ── Documents section ───────────────────────────────────────────────────────
+
+export const NAV_DOCUMENTS_LABEL = "Documents"
+
+export const NAV_DOCUMENTS: NavLinkItem[] = [
+  {
+    key: "word-assistant",
+    title: "Word Assistant",
+    url: "#",
+    icon:       <i className="fa-light fa-file-pen" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-file-pen" aria-hidden="true" />,
+    badge: "Beta",
+  },
+  {
+    key: "more",
+    title: "More",
+    url: "#",
+    icon:       <i className="fa-light fa-ellipsis" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-ellipsis" aria-hidden="true" />,
+  },
+]
+
+// ── Quick actions (above primary nav) + bottom utilities ───────────────────────
+
+/** `opensCommandMenu` wires ⌘K instead of `url`. */
+export interface NavSecondaryItem {
+  key: string
+  title: string
+  url: string
+  icon: React.ReactNode
+  /** Solid / filled variant when the route is active — matches primary `NavLinkItem` rows. */
+  iconActive?: React.ReactNode
+  opensCommandMenu?: boolean
+}
+
+/** Search + Notifications — rendered above Dashboard in the sidebar. */
+export const NAV_QUICK_ACTIONS: NavSecondaryItem[] = [
+  {
+    key: "command-menu",
+    title: "Search or ask Leo",
+    url: "#",
+    icon: <i className="fa-light fa-magnifying-glass" aria-hidden="true" />,
+    opensCommandMenu: true,
+  },
+  {
+    key: "notifications",
+    title: "Notifications",
+    url: "#",
+    icon: <i className="fa-light fa-bell" aria-hidden="true" />,
+  },
+]
+
+export const NAV_SECONDARY: NavSecondaryItem[] = [
+  {
+    key: "settings",
+    title: "Settings",
+    url: "/settings",
+    icon:       <i className="fa-light fa-gear" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-gear" aria-hidden="true" />,
+  },
+  {
+    key: "help",
+    title: "Get Help",
+    url: "/help",
+    icon:       <i className="fa-light fa-circle-question" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-circle-question" aria-hidden="true" />,
+  },
+]
+
+// ── User ──────────────────────────────────────────────────────────────────────
+
+export const NAV_USER = {
+  name:  "Jordan Rivera",
+  email: "jordan.rivera@jhmi.edu",
+  /** Stock portrait (randomuser.me); stable for this seed */
+  avatar: stockPortraitUrl("exxat-nav-user-jordan-rivera"),
+}

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

@@ -0,0 +1,134 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Placements page — KPI strip + insight (data-list; dashboard view uses row-driven helpers)
+// ─────────────────────────────────────────────────────────────────────────────
+
+import type { MetricInsight, MetricItem } from "@/components/key-metrics"
+import { ALL_PLACEMENTS, type Placement, type Status } from "./placements"
+
+function statusCount(status: Status): number {
+  return ALL_PLACEMENTS.filter((p) => p.status === status).length
+}
+
+/**
+ * KPIs from the current filtered placement set (table/list/board/dashboard shared state).
+ * Use for the dashboard view tab; optional for the template metrics strip when you want parity.
+ */
+export function placementKpiMetricsFromRows(rows: Placement[]): MetricItem[] {
+  const total = rows.length
+  const startingWeek = rows.filter(p => p.daysUntilStart >= 0 && p.daysUntilStart <= 7).length
+  const alerts = rows.filter(p => {
+    const r = p.readiness.toLowerCase()
+    return r.includes("risk") || r.includes("blocked")
+  }).length
+  const complete = rows.filter(p => p.compliance === "Complete").length
+  const avgPct = total > 0 ? Math.round((complete / total) * 100) : 0
+
+  return [
+    {
+      id: "total-placements",
+      label: "Total Placements",
+      value: total,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+      metricVariant: "hero",
+    },
+    {
+      id: "starting-week",
+      label: "Starting This Week",
+      value: startingWeek,
+      delta: "—",
+      trend: startingWeek > 0 ? "up" : "neutral",
+      href: "#",
+    },
+    {
+      id: "compliance-alerts",
+      label: "Readiness alerts",
+      value: alerts,
+      delta: "—",
+      trend: alerts > 0 ? "up" : "neutral",
+      href: "#",
+    },
+    {
+      id: "avg-compliance",
+      label: "Compliance complete",
+      value: `${avgPct}%`,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+    },
+  ]
+}
+
+export function placementKpiInsightFromRows(rows: Placement[]): MetricInsight {
+  const pending = rows.filter(p => p.status === "pending").length
+  const inReview = rows.filter(p => p.status === "under-review").length
+  const n = rows.length
+  return {
+    title: "Pending Reviews",
+    description:
+      n > 0
+        ? `${pending} pending, ${inReview} in review in this view. Clear the queue to keep placements moving.`
+        : "No placements match the current filters.",
+    href: "/placements/reviews",
+    severity: pending + inReview > 0 ? "warning" : "info",
+    actionLabel: "Ask Leo",
+  }
+}
+
+/**
+ * Placements KPI row — matches design reference (totals + operational metrics).
+ */
+export const PLACEMENT_KPI_METRICS: MetricItem[] = [
+  {
+    id: "total-placements",
+    label: "Total Placements",
+    value: 50,
+    delta: "+12",
+    trend: "up",
+    href: "#all",
+    metricVariant: "hero",
+  },
+  {
+    id: "starting-week",
+    label: "Starting This Week",
+    value: 0,
+    delta: "-5",
+    trend: "down",
+    href: "#starting",
+  },
+  {
+    id: "compliance-alerts",
+    label: "Compliance Alerts",
+    value: 23,
+    delta: "+13",
+    trend: "up",
+    href: "#alerts",
+  },
+  {
+    id: "avg-compliance",
+    label: "Avg Compliance",
+    value: "87%",
+    delta: "+3",
+    trend: "up",
+    href: "#compliance",
+  },
+]
+
+/**
+ * Insight copy still derived from live placement rows for the queue narrative.
+ */
+export function getPlacementInsight(): MetricInsight {
+  const pending = statusCount("pending")
+  const inReview = statusCount("under-review")
+
+  return {
+    title: "Pending Reviews",
+    description: `${pending} pending, ${inReview} in review. Clear the queue to keep placements moving.`,
+    href: "/placements/reviews",
+    severity: "warning",
+    actionLabel: "Ask Leo",
+  }
+}
+
+export const PLACEMENT_KPI_INSIGHT = getPlacementInsight()

package/template/lib/mock/placements.ts

@@ -0,0 +1,183 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// 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: "Mar 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: "Mar 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: "Mar 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: "Mar 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: "Mar 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: "Mar 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: "Dec 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: "Dec 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: "Nov 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 placementsForPhase(
+  phase: "all" | PlacementPhase,
+): Placement[] {
+  if (phase === "all") return ALL_PLACEMENTS
+  return ALL_PLACEMENTS.filter((p) => p.placementPhase === phase)
+}
+
+export function getPlacementById(id: number): Placement | undefined {
+  return ALL_PLACEMENTS.find(p => p.id === id)
+}

package/template/lib/mock/question-bank-kpi.ts

@@ -0,0 +1,61 @@
+import type { MetricInsight, MetricItem } from "@/components/key-metrics"
+import type { QuestionBankItem } from "@/lib/mock/question-bank"
+
+export function questionBankKpiMetrics(rows: QuestionBankItem[]): MetricItem[] {
+  const published = rows.filter(r => r.status === "published").length
+  const draft = rows.filter(r => r.status === "draft").length
+  const review = rows.filter(r => r.status === "in_review").length
+
+  return [
+    {
+      id: "total",
+      label: "Total questions",
+      value: rows.length,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+      metricVariant: "hero",
+    },
+    {
+      id: "published",
+      label: "Published",
+      value: published,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+    },
+    {
+      id: "review",
+      label: "In review",
+      value: review,
+      delta: review > 0 ? "!" : "—",
+      trend: review > 0 ? "up" : "neutral",
+      href: "#",
+    },
+    {
+      id: "draft",
+      label: "Drafts",
+      value: draft,
+      delta: "—",
+      trend: "neutral",
+      href: "#",
+    },
+  ]
+}
+
+export function questionBankKpiInsight(rows: QuestionBankItem[]): MetricInsight {
+  const review = rows.filter(r => r.status === "in_review").length
+  const draft = rows.filter(r => r.status === "draft").length
+  return {
+    title: "Question bank",
+    description:
+      review > 0
+        ? `${review} item(s) in review. ${draft} draft(s) not yet published.`
+        : draft > 0
+          ? `${draft} draft(s) ready to finalize or send for review.`
+          : "All items are published or in review with no backlog.",
+    href: "/question-bank",
+    severity: review > 2 ? "warning" : "info",
+    actionLabel: "Ask Leo",
+  }
+}