@exxatdesignux/ui 0.1.0 → 0.2.7

package/template/lib/mock/dashboard.ts

@@ -5,18 +5,18 @@
 import type { MetricItem, MetricInsight } from "@/components/key-metrics"
 
 export const DASHBOARD_METRICS: MetricItem[] = [
-  { id: "pending-requests",     label: "Pending requests",     value: "23",  delta: "+5",  trend: "up",   href: "/data-list#pending"     },
-  { id: "confirmed-placements", label: "Confirmed placements", value: "89",  delta: "+12", trend: "up",   href: "/data-list#confirmed"   },
-  { id: "pending-reviews",      label: "Pending Reviews",      value: "8",   delta: "-3",  trend: "down", href: "/data-list#reviews"     },
-  { id: "available-slots",      label: "Available Slots",      value: "156", delta: "+24", trend: "up",   href: "/data-list#slots"       },
-  { id: "new-applications",     label: "New Applications",     value: "34",  delta: "+7",  trend: "up",   href: "/data-list#applications"},
-  { id: "compliance-rate",      label: "Compliance Rate",      value: "98%", delta: "+2",  trend: "up",   href: "/data-list#compliance"  },
+  { id: "pending-requests",     label: "Open tasks",       value: "23",  delta: "+5",  trend: "up",   href: "/data-list" },
+  { id: "confirmed-placements", label: "Active pipelines", value: "89",  delta: "+12", trend: "up",   href: "/data-list" },
+  { id: "pending-reviews",      label: "In review",        value: "8",   delta: "-3",  trend: "down", href: "/data-list" },
+  { id: "available-slots",      label: "Available slots",  value: "156", delta: "+24", trend: "up",   href: "/data-list" },
+  { id: "new-applications",     label: "New items",        value: "34",  delta: "+7",  trend: "up",   href: "/data-list" },
+  { id: "compliance-rate",      label: "Health score",     value: "98%", delta: "+2",  trend: "up",   href: "/data-list" },
 ]
 
 export const DASHBOARD_INSIGHT: MetricInsight = {
-  title:       "Review Bottleneck",
-  description: "8 reviews pending with 23 new requests waiting. Clear reviews to maintain placement velocity.",
-  href:        "/reviews",
+  title:       "Throughput note",
+  description: "Demo insight card — wire real KPIs from your product domain.",
+  href:        "/examples",
   severity:    "warning",
   actionLabel: "Ask Leo",
 }
@@ -74,8 +74,8 @@ export interface DashboardStudentScoresData {
 
 /** Example: student 75 on scale 50–80, class average 60 (same band). */
 export const DASHBOARD_STUDENT_SCORES: DashboardStudentScoresData = {
-  title: "Student scores",
-  description: "Your score vs class average on the published scale (reference).",
+  title: "Sample scores",
+  description: "Reference chart: individual vs average on a fixed band (demo).",
   metrics: [
     {
       id: "midterm",

package/template/lib/mock/navigation.tsx

@@ -87,88 +87,47 @@ export const NAV_PRIMARY: NavLinkItem[] = [
     icon:       <i className="fa-light fa-grid-2" aria-hidden="true" />,
     iconActive: <i className="fa-solid fa-grid-2" aria-hidden="true" />,
   },
+  {
+    key: "examples",
+    title: "Patterns",
+    url: "/examples",
+    icon:       <i className="fa-light fa-layer-group" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-layer-group" 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" />,
+    secondaryPanel: "question-bank",
   },
   {
     key: "data-list",
-    title: "Placements",
+    title: "List hub",
     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" />,
+    icon:       <i className="fa-light fa-table" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-table" 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_LABEL = "Resources"
 
 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: "tokens",
+    title: "Tokens & themes",
+    url: "/settings",
+    icon:       <i className="fa-light fa-palette" aria-hidden="true" />,
+    iconActive: <i className="fa-solid fa-palette" aria-hidden="true" />,
   },
   {
     key: "more",
     title: "More",
-    url: "#",
+    url: "/help",
     icon:       <i className="fa-light fa-ellipsis" aria-hidden="true" />,
     iconActive: <i className="fa-solid fa-ellipsis" aria-hidden="true" />,
   },
@@ -191,7 +150,7 @@ export interface NavSecondaryItem {
 export const NAV_QUICK_ACTIONS: NavSecondaryItem[] = [
   {
     key: "command-menu",
-    title: "Search or ask Leo",
+    title: "Search",
     url: "#",
     icon: <i className="fa-light fa-magnifying-glass" aria-hidden="true" />,
     opensCommandMenu: true,
@@ -224,8 +183,8 @@ export const NAV_SECONDARY: NavSecondaryItem[] = [
 // ── User ──────────────────────────────────────────────────────────────────────
 
 export const NAV_USER = {
-  name:  "Jordan Rivera",
-  email: "jordan.rivera@jhmi.edu",
+  name:  "Alex Morgan",
+  email: "alex.morgan@example.com",
   /** Stock portrait (randomuser.me); stable for this seed */
-  avatar: stockPortraitUrl("exxat-nav-user-jordan-rivera"),
+  avatar: stockPortraitUrl("exxat-nav-user-alex-morgan"),
 }

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

@@ -1,5 +1,5 @@
 // ─────────────────────────────────────────────────────────────────────────────
-// Placements page — KPI strip + insight (data-list; dashboard view uses row-driven helpers)
+// List hub — KPI strip + insight (data-list; dashboard view uses row-driven helpers)
 // ─────────────────────────────────────────────────────────────────────────────
 
 import type { MetricInsight, MetricItem } from "@/components/key-metrics"
@@ -10,7 +10,7 @@ function statusCount(status: Status): number {
 }
 
 /**
- * KPIs from the current filtered placement set (table/list/board/dashboard shared state).
+ * KPIs from the current filtered row 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[] {
@@ -26,7 +26,7 @@ export function placementKpiMetricsFromRows(rows: Placement[]): MetricItem[] {
   return [
     {
       id: "total-placements",
-      label: "Total Placements",
+      label: "Total rows",
       value: total,
       delta: "—",
       trend: "neutral",
@@ -35,7 +35,7 @@ export function placementKpiMetricsFromRows(rows: Placement[]): MetricItem[] {
     },
     {
       id: "starting-week",
-      label: "Starting This Week",
+      label: "Due this week",
       value: startingWeek,
       delta: "—",
       trend: startingWeek > 0 ? "up" : "neutral",
@@ -43,7 +43,7 @@ export function placementKpiMetricsFromRows(rows: Placement[]): MetricItem[] {
     },
     {
       id: "compliance-alerts",
-      label: "Readiness alerts",
+      label: "Attention flags",
       value: alerts,
       delta: "—",
       trend: alerts > 0 ? "up" : "neutral",
@@ -51,7 +51,7 @@ export function placementKpiMetricsFromRows(rows: Placement[]): MetricItem[] {
     },
     {
       id: "avg-compliance",
-      label: "Compliance complete",
+      label: "Completeness",
       value: `${avgPct}%`,
       delta: "—",
       trend: "neutral",
@@ -65,24 +65,24 @@ export function placementKpiInsightFromRows(rows: Placement[]): MetricInsight {
   const inReview = rows.filter(p => p.status === "under-review").length
   const n = rows.length
   return {
-    title: "Pending Reviews",
+    title: "Queue snapshot",
     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",
+        ? `${pending} pending, ${inReview} in review in this view. Clear the queue to keep work moving.`
+        : "No rows match the current filters.",
+    href: "/data-list",
     severity: pending + inReview > 0 ? "warning" : "info",
     actionLabel: "Ask Leo",
   }
 }
 
 /**
- * Placements KPI row — matches design reference (totals + operational metrics).
+ * KPI row for the list hub metrics strip (demo numbers).
  */
 export const PLACEMENT_KPI_METRICS: MetricItem[] = [
   {
     id: "total-placements",
-    label: "Total Placements",
+    label: "Total rows",
     value: 50,
     delta: "+12",
     trend: "up",
@@ -91,7 +91,7 @@ export const PLACEMENT_KPI_METRICS: MetricItem[] = [
   },
   {
     id: "starting-week",
-    label: "Starting This Week",
+    label: "Due this week",
     value: 0,
     delta: "-5",
     trend: "down",
@@ -99,7 +99,7 @@ export const PLACEMENT_KPI_METRICS: MetricItem[] = [
   },
   {
     id: "compliance-alerts",
-    label: "Compliance Alerts",
+    label: "Attention flags",
     value: 23,
     delta: "+13",
     trend: "up",
@@ -107,7 +107,7 @@ export const PLACEMENT_KPI_METRICS: MetricItem[] = [
   },
   {
     id: "avg-compliance",
-    label: "Avg Compliance",
+    label: "Completeness",
     value: "87%",
     delta: "+3",
     trend: "up",
@@ -116,16 +116,16 @@ export const PLACEMENT_KPI_METRICS: MetricItem[] = [
 ]
 
 /**
- * Insight copy still derived from live placement rows for the queue narrative.
+ * Insight copy derived from demo row status counts.
  */
 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",
+    title: "Queue snapshot",
+    description: `${pending} pending, ${inReview} in review. Clear the queue to keep work moving.`,
+    href: "/data-list",
     severity: "warning",
     actionLabel: "Ask Leo",
   }

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

@@ -0,0 +1,167 @@
+/**
+ * Question bank folder tree (mock) — OS-style icon folders with appearance + hierarchy.
+ * Production: replace with API + optimistic updates.
+ */
+
+export type QuestionBankFolderColorKey =
+  | "brand"
+  | "success"
+  | "warning"
+  | "destructive"
+  | "muted"
+  | "chart1"
+  | "chart2"
+  | "chart3"
+
+export interface QuestionBankFolder {
+  id: string
+  name: string
+  /** `null` = top-level folder */
+  parentId: string | null
+  /** Font Awesome icon without weight prefix (e.g. `fa-folder`, `fa-flask`). */
+  icon: string
+  colorKey: QuestionBankFolderColorKey
+}
+
+/** Tile + icon tint classes (semantic tokens). */
+export const QUESTION_BANK_FOLDER_COLOR_STYLES: Record<
+  QuestionBankFolderColorKey,
+  { tile: string; iconWrap: string; icon: string }
+> = {
+  brand: {
+    tile: "border-brand/35 bg-brand/10",
+    iconWrap: "bg-brand/20",
+    icon: "text-brand",
+  },
+  success: {
+    tile: "border-emerald-500/35 bg-emerald-500/10",
+    iconWrap: "bg-emerald-500/15",
+    icon: "text-emerald-600 dark:text-emerald-400",
+  },
+  warning: {
+    tile: "border-amber-500/35 bg-amber-500/10",
+    iconWrap: "bg-amber-500/15",
+    icon: "text-amber-700 dark:text-amber-400",
+  },
+  destructive: {
+    tile: "border-destructive/35 bg-destructive/10",
+    iconWrap: "bg-destructive/15",
+    icon: "text-destructive",
+  },
+  muted: {
+    tile: "border-border bg-muted/50",
+    iconWrap: "bg-muted",
+    icon: "text-muted-foreground",
+  },
+  chart1: {
+    tile: "border-[color-mix(in_oklab,var(--color-chart-1)_40%,transparent)] bg-[color-mix(in_oklab,var(--color-chart-1)_12%,transparent)]",
+    iconWrap: "bg-[color-mix(in_oklab,var(--color-chart-1)_20%,transparent)]",
+    icon: "text-[var(--color-chart-1)]",
+  },
+  chart2: {
+    tile: "border-[color-mix(in_oklab,var(--color-chart-2)_40%,transparent)] bg-[color-mix(in_oklab,var(--color-chart-2)_12%,transparent)]",
+    iconWrap: "bg-[color-mix(in_oklab,var(--color-chart-2)_20%,transparent)]",
+    icon: "text-[var(--color-chart-2)]",
+  },
+  chart3: {
+    tile: "border-[color-mix(in_oklab,var(--color-chart-3)_40%,transparent)] bg-[color-mix(in_oklab,var(--color-chart-3)_12%,transparent)]",
+    iconWrap: "bg-[color-mix(in_oklab,var(--color-chart-3)_20%,transparent)]",
+    icon: "text-[var(--color-chart-3)]",
+  },
+}
+
+/** Icon color classes using Tailwind — for use in text-based contexts (list views, panels). */
+export const QUESTION_BANK_FOLDER_ICON_COLORS: Record<QuestionBankFolderColorKey, string> = {
+  brand: "text-orange-600 dark:text-orange-400",
+  success: "text-emerald-600 dark:text-emerald-400",
+  warning: "text-amber-600 dark:text-amber-400",
+  destructive: "text-red-600 dark:text-red-400",
+  muted: "text-slate-500 dark:text-slate-400",
+  chart1: "text-blue-600 dark:text-blue-400",
+  chart2: "text-lime-600 dark:text-lime-400",
+  chart3: "text-purple-600 dark:text-purple-400",
+}
+
+/** Preset icons for folder appearance picker. */
+export const QUESTION_BANK_FOLDER_ICON_OPTIONS: readonly string[] = [
+  "fa-folder",
+  "fa-folder-open",
+  "fa-book",
+  "fa-flask",
+  "fa-stethoscope",
+  "fa-heart-pulse",
+  "fa-brain",
+  "fa-scale-balanced",
+  "fa-file-lines",
+  "fa-layer-group",
+  "fa-clipboard-check",
+  "fa-vial",
+  "fa-user-doctor",
+  "fa-kit-medical",
+  "fa-notes-medical",
+] as const
+
+export const DEFAULT_QUESTION_BANK_FOLDERS: QuestionBankFolder[] = [
+  {
+    id: "fld-clinical",
+    name: "Clinical",
+    parentId: null,
+    icon: "fa-stethoscope",
+    colorKey: "brand",
+  },
+  {
+    id: "fld-science",
+    name: "Basic science",
+    parentId: null,
+    icon: "fa-flask",
+    colorKey: "chart2",
+  },
+  {
+    id: "fld-ops",
+    name: "Operations",
+    parentId: null,
+    icon: "fa-clipboard-check",
+    colorKey: "warning",
+  },
+  {
+    id: "fld-ethics",
+    name: "Ethics & law",
+    parentId: null,
+    icon: "fa-scale-balanced",
+    colorKey: "muted",
+  },
+  {
+    id: "fld-skills-lab",
+    name: "Skills lab",
+    parentId: "fld-clinical",
+    icon: "fa-vial",
+    colorKey: "success",
+  },
+]
+
+export function newFolderId(): string {
+  return `fld-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 7)}`
+}
+
+export function collectFolderDescendantIds(folders: QuestionBankFolder[], rootId: string): Set<string> {
+  const out = new Set<string>()
+  function walk(id: string) {
+    out.add(id)
+    for (const f of folders) {
+      if (f.parentId === id) walk(f.id)
+    }
+  }
+  walk(rootId)
+  return out
+}
+
+export function isValidFolderMove(
+  folders: QuestionBankFolder[],
+  folderId: string,
+  newParentId: string | null,
+): boolean {
+  if (folderId === newParentId) return false
+  if (newParentId === null) return true
+  const desc = collectFolderDescendantIds(folders, folderId)
+  return !desc.has(newParentId)
+}

package/template/lib/mock/question-bank-header-collaborators.ts

@@ -0,0 +1,14 @@
+/**
+ * Demo collaborators for Question bank collaboration header (stacked faces).
+ */
+
+import { stockPortraitUrl } from "@/lib/stock-portrait"
+import type { PageHeaderCollaborator } from "@/components/page-header"
+
+export const QUESTION_BANK_HEADER_COLLABORATORS: PageHeaderCollaborator[] = [
+  { id: "1", name: "Alex Morgan", imageUrl: stockPortraitUrl("qb-collab-alex"), initials: "AM" },
+  { id: "2", name: "Jordan Lee", imageUrl: stockPortraitUrl("qb-collab-jordan"), initials: "JL" },
+  { id: "3", name: "Sam Rivera", imageUrl: stockPortraitUrl("qb-collab-sam"), initials: "SR" },
+  { id: "4", name: "Taylor Kim", imageUrl: stockPortraitUrl("qb-collab-taylor"), initials: "TK" },
+  { id: "5", name: "Riley Patel", imageUrl: stockPortraitUrl("qb-collab-riley"), initials: "RP" },
+]

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

@@ -0,0 +1,109 @@
+/**
+ * Derived labels for the question bank inspector (mock — replace with API fields).
+ */
+
+import type { QuestionBankDifficulty, QuestionBankItem, QuestionBankType } from "@/lib/mock/question-bank"
+import type { QuestionBankFolder } from "@/lib/mock/question-bank-folders"
+import { collectFolderDescendantIds } from "@/lib/mock/question-bank-folders"
+
+export const QUESTION_TYPE_ABBREV: Record<QuestionBankType, string> = {
+  multiple_choice: "MCQ",
+  true_false: "T/F",
+  short_answer: "Short answer",
+}
+
+export function deriveQuestionItemCode(q: QuestionBankItem): string {
+  const raw = q.itemCode?.trim()
+  if (raw) return raw
+  const n = q.id.replace(/\D/g, "") || "0"
+  return `QB-${String(n).padStart(3, "0")}`
+}
+
+export function deriveBloomLevel(q: QuestionBankItem): string {
+  if (q.bloomLevel && String(q.bloomLevel).trim()) return String(q.bloomLevel)
+  switch (q.difficulty) {
+    case "easy":
+      return "Remember"
+    case "medium":
+      return "Apply"
+    case "hard":
+      return "Analyze"
+    default:
+      return "Apply"
+  }
+}
+
+/** Relative “last edited” clause when `lastEditedSummary` is absent. */
+export function deriveLastEditedLine(q: QuestionBankItem): string {
+  if (q.lastEditedSummary?.trim()) return q.lastEditedSummary.trim()
+  const editor = q.lastEditedBy ?? q.author
+  const d = new Date(q.updatedAt)
+  if (Number.isNaN(d.getTime())) return `Updated · ${editor}`
+  const ms = Date.now() - d.getTime()
+  const days = Math.floor(ms / (86400 * 1000))
+  if (days < 1) return `Today · ${editor}`
+  if (days < 14) return `${days} days ago · ${editor}`
+  const months = Math.floor(days / 30)
+  if (months < 24) return `${months} month${months === 1 ? "" : "s"} ago · ${editor}`
+  const years = Math.floor(months / 12)
+  return `${years} year${years === 1 ? "" : "s"} ago · ${editor}`
+}
+
+export function deriveTags(q: QuestionBankItem): string[] {
+  if (q.tags && q.tags.length > 0) return q.tags
+  return [q.topic].filter(Boolean)
+}
+
+/** Bloom taxonomy row order for folder aggregate charts. */
+export const BLOOM_LEVEL_ORDER = [
+  "Remember",
+  "Understand",
+  "Apply",
+  "Analyze",
+  "Evaluate",
+  "Create",
+] as const
+
+export function questionsInFolderSubtree(
+  folders: QuestionBankFolder[],
+  questions: QuestionBankItem[],
+  folderId: string,
+): QuestionBankItem[] {
+  const scope = collectFolderDescendantIds(folders, folderId)
+  return questions.filter(q => scope.has(q.folderId))
+}
+
+export interface FolderQuestionAggregate {
+  totalQuestions: number
+  difficulty: Record<QuestionBankDifficulty, number>
+  /** Counts keyed by Bloom label (includes derived levels). */
+  bloom: Record<string, number>
+  avgPbi: number | null
+  scoredCount: number
+}
+
+export function aggregateFolderQuestions(rows: QuestionBankItem[]): FolderQuestionAggregate {
+  const difficulty: Record<QuestionBankDifficulty, number> = {
+    easy: 0,
+    medium: 0,
+    hard: 0,
+  }
+  const bloom: Record<string, number> = {}
+  for (const label of BLOOM_LEVEL_ORDER) bloom[label] = 0
+  const pbis: number[] = []
+  for (const q of rows) {
+    difficulty[q.difficulty]++
+    const bl = deriveBloomLevel(q)
+    bloom[bl] = (bloom[bl] ?? 0) + 1
+    if (typeof q.pbi === "number" && !Number.isNaN(q.pbi)) pbis.push(q.pbi)
+  }
+  const scoredCount = pbis.length
+  const avgPbi = scoredCount ? pbis.reduce((a, n) => a + n, 0) / scoredCount : null
+  return {
+    totalQuestions: rows.length,
+    difficulty,
+    bloom,
+    avgPbi,
+    scoredCount,
+  }
+}

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

@@ -47,7 +47,7 @@ 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",
+    title: "Folder library",
     description:
       review > 0
         ? `${review} item(s) in review. ${draft} draft(s) not yet published.`