@exxatdesignux/ui 0.2.9 → 0.2.11

package/template/lib/dedicated-search-recents.ts

@@ -0,0 +1,76 @@
+/**
+ * Namespaced recent-query storage for dedicated search routes (localStorage + sync event).
+ * Hub code creates one controller per surface (namespace) and passes it into
+ * {@link DedicatedSearchRecents} / {@link DedicatedSearchUrlComposer}.
+ */
+
+const MAX_RECENTS = 12
+
+function parseStored(raw: string | null): string[] {
+  if (!raw) return []
+  try {
+    const parsed = JSON.parse(raw) as unknown
+    if (!Array.isArray(parsed)) return []
+    return parsed
+      .filter((x): x is string => typeof x === "string" && x.trim().length > 0)
+      .map(s => s.trim())
+      .slice(0, MAX_RECENTS)
+  } catch {
+    return []
+  }
+}
+
+export interface DedicatedSearchRecentsController {
+  /** Pass to `addEventListener` / `removeEventListener` (CustomEvent, no detail). */
+  readonly eventName: string
+  read: () => string[]
+  record: (query: string) => void
+  clear: () => void
+}
+
+export type DedicatedSearchRecentsLegacyKeys = {
+  storageKey: string
+  eventName: string
+}
+
+/**
+ * @param namespace — Stable id when not using `legacy` (storage key + event name derive from it).
+ * @param legacy — Optional stable keys for an existing shipped surface (avoid resetting users’ saved recents).
+ */
+export function createDedicatedSearchRecentsController(
+  namespace: string,
+  legacy?: DedicatedSearchRecentsLegacyKeys,
+): DedicatedSearchRecentsController {
+  const storageKey = legacy?.storageKey ?? `exxat-ds.dedicated-search.recents.${namespace}.v1`
+  const eventName = legacy?.eventName ?? `exxat-dedicated-search-recents-${namespace}`
+
+  const read = (): string[] => {
+    if (typeof window === "undefined") return []
+    return parseStored(window.localStorage.getItem(storageKey))
+  }
+
+  const record = (query: string): void => {
+    const q = query.trim()
+    if (!q || typeof window === "undefined") return
+    const prev = read()
+    const deduped = [q, ...prev.filter(x => x.toLowerCase() !== q.toLowerCase())].slice(0, MAX_RECENTS)
+    try {
+      window.localStorage.setItem(storageKey, JSON.stringify(deduped))
+    } catch {
+      /* ignore quota / private mode */
+    }
+    window.dispatchEvent(new CustomEvent(eventName))
+  }
+
+  const clear = (): void => {
+    if (typeof window === "undefined") return
+    try {
+      window.localStorage.removeItem(storageKey)
+    } catch {
+      /* ignore */
+    }
+    window.dispatchEvent(new CustomEvent(eventName))
+  }
+
+  return { eventName, read, record, clear }
+}

package/template/lib/dedicated-search-url.ts

@@ -0,0 +1,23 @@
+/**
+ * URL helpers for dedicated search surfaces — hubs pass domain-specific patchers.
+ */
+
+export type DedicatedSearchParamsPatch = (
+  /** Current query string snapshot (e.g. from `useSearchParams` serialization). */
+  searchParamsKey: string,
+  /** Trimmed query text; empty string means “clear primary search param”. */
+  submittedText: string,
+) => URLSearchParams
+
+/** Default: single `q` param, replaces or deletes only `q`. */
+export function patchDedicatedSearchQueryParam(
+  searchParamsKey: string,
+  submittedText: string,
+  paramName = "q",
+): URLSearchParams {
+  const next = new URLSearchParams(searchParamsKey)
+  const t = submittedText.trim()
+  if (t) next.set(paramName, t)
+  else next.delete(paramName)
+  return next
+}

package/template/lib/discovery-hub.ts

@@ -0,0 +1,15 @@
+export type DiscoveryHubSearchItem = {
+  id: string
+  label: string
+  keywords?: string
+  icon?: string
+  href?: string
+  askLeoPrompt?: string
+}
+
+export type DiscoveryHubSearchGroup = {
+  id: string
+  heading: string
+  items: DiscoveryHubSearchItem[]
+  searchOnly?: boolean
+}

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

@@ -1,6 +1,6 @@
 /**
  * Shared status chip labels, tint classes, and FA icon names for product list hubs
- * (Placements, Team, Compliance, Question bank — table, list, board), plus related chips
+ * (Placements, Team, Compliance — table, list, board), plus related chips
  * (dashboard **task priority**, placement **readiness** on the detail drawer).
  *
  * Labels use **sentence / title case** (e.g. "Due soon", "Under Review"). Do **not** add **`uppercase`**.
@@ -14,7 +14,6 @@
  */
 
 import type { ComplianceStatus } from "@/lib/mock/compliance"
-import type { QuestionBankStatus } from "@/lib/mock/question-bank"
 import type { Status as PlacementStatus } from "@/lib/mock/placements"
 import type { TeamMember } from "@/lib/mock/team"
 
@@ -147,22 +146,3 @@ export const COMPLIANCE_STATUS_ICON: Record<ComplianceStatus, string> = {
   pending: "fa-hourglass-half",
 }
 
-// ─── Question bank ────────────────────────────────────────────────────────
-
-export const QUESTION_BANK_STATUS_LABEL: Record<QuestionBankStatus, string> = {
-  published: "Published",
-  draft: "Draft",
-  in_review: "In review",
-}
-
-export const QUESTION_BANK_STATUS_BADGE_CLASS: Record<QuestionBankStatus, string> = {
-  published: LIST_HUB_STATUS_TINT_SUCCESS,
-  draft: LIST_HUB_STATUS_TINT_NEUTRAL,
-  in_review: LIST_HUB_STATUS_TINT_WARNING,
-}
-
-export const QUESTION_BANK_STATUS_ICON: Record<QuestionBankStatus, string> = {
-  published: "fa-circle-check",
-  draft: "fa-pen-field",
-  in_review: "fa-user-magnifying-glass",
-}

package/template/lib/mock/navigation.tsx

@@ -120,14 +120,16 @@ export const NAV_DOCUMENTS: NavLinkItem[] = [
   {
     key: "tokens",
     title: "Tokens & themes",
-    url: "/settings",
+    /** Same page as Settings — disambiguate active state via `#appearance` (see `isNavActive`). */
+    url: "/settings#appearance",
     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: "/help",
+    /** Same page as Get Help — disambiguate via `#more`. */
+    url: "/help#more",
     icon:       <i className="fa-light fa-ellipsis" aria-hidden="true" />,
     iconActive: <i className="fa-solid fa-ellipsis" aria-hidden="true" />,
   },

package/template/lib/mock/placements.ts

@@ -46,7 +46,7 @@ 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",
+    readiness: "Ready", progressWeeksDone: 5, progressWeeksTotal: 12, endDate: "06/07/2026", lastCheckin: "03/22/2026",
     completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—", isNew: true,
   },
   {
@@ -67,7 +67,7 @@ export const ALL_PLACEMENTS: Placement[] = [
     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",
+    readiness: "Ready", progressWeeksDone: 2, progressWeeksTotal: 12, endDate: "06/30/2026", lastCheckin: "03/21/2026",
     completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
   },
   {
@@ -88,7 +88,7 @@ export const ALL_PLACEMENTS: Placement[] = [
     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",
+    readiness: "Ready", progressWeeksDone: 7, progressWeeksTotal: 12, endDate: "06/14/2026", lastCheckin: "03/23/2026",
     completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—", isNew: true,
   },
   {
@@ -102,7 +102,7 @@ export const ALL_PLACEMENTS: Placement[] = [
     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",
+    readiness: "Ready", progressWeeksDone: 8, progressWeeksTotal: 12, endDate: "06/10/2026", lastCheckin: "03/24/2026",
     completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
   },
   {
@@ -116,7 +116,7 @@ export const ALL_PLACEMENTS: Placement[] = [
     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",
+    readiness: "Ready", progressWeeksDone: 4, progressWeeksTotal: 10, endDate: "06/03/2026", lastCheckin: "03/19/2026",
     completionDate: "—", finalStatus: "—", rating: 0, suggestedToHire: "—",
   },
   {
@@ -130,28 +130,28 @@ export const ALL_PLACEMENTS: Placement[] = [
     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",
+    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: "Dec 28, 2025",
+    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: "Dec 08, 2025",
+    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: "Nov 22, 2025",
+    readiness: "Ready", progressWeeksDone: 12, progressWeeksTotal: 12, endDate: "11/25/2025", lastCheckin: "11/22/2025",
     completionDate: "11/25/2025", finalStatus: "Passed", rating: 5, suggestedToHire: "Yes",
   },
 ]

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

@@ -102,6 +102,13 @@ export const QUESTION_BANK_FOLDER_ICON_OPTIONS: readonly string[] = [
 ] as const
 
 export const DEFAULT_QUESTION_BANK_FOLDERS: QuestionBankFolder[] = [
+  {
+    id: "fld-favorites",
+    name: "Favorites",
+    parentId: null,
+    icon: "fa-star",
+    colorKey: "warning",
+  },
   {
     id: "fld-clinical",
     name: "Clinical",

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

@@ -6,9 +6,49 @@ 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" },
+  {
+    id: "1",
+    name: "Alex Morgan",
+    email: "alex.morgan@example.com",
+    imageUrl: stockPortraitUrl("qb-collab-alex"),
+    initials: "AM",
+    access: "owner",
+    roles: ["Director", "Faculty"],
+  },
+  {
+    id: "2",
+    name: "Jordan Lee",
+    email: "jordan.lee@example.com",
+    imageUrl: stockPortraitUrl("qb-collab-jordan"),
+    initials: "JL",
+    access: "editor",
+    roles: ["Program coordinator"],
+  },
+  {
+    id: "3",
+    name: "Sam Rivera",
+    email: "sam.rivera@example.com",
+    imageUrl: stockPortraitUrl("qb-collab-sam"),
+    initials: "SR",
+    access: "editor",
+    roles: ["Faculty"],
+  },
+  {
+    id: "4",
+    name: "Taylor Kim",
+    email: "taylor.kim@example.com",
+    imageUrl: stockPortraitUrl("qb-collab-taylor"),
+    initials: "TK",
+    access: "commenter",
+    roles: ["Faculty"],
+  },
+  {
+    id: "5",
+    name: "Riley Patel",
+    email: "riley.patel@example.com",
+    imageUrl: stockPortraitUrl("qb-collab-riley"),
+    initials: "RP",
+    access: "viewer",
+    roles: ["Program coordinator"],
+  },
 ]

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

@@ -15,8 +15,7 @@ export const QUESTION_TYPE_ABBREV: Record<QuestionBankType, string> = {
 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")}`
+  return q.questionId
 }
 
 export function deriveBloomLevel(q: QuestionBankItem): string {

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

@@ -1,10 +1,21 @@
 import type { MetricInsight, MetricItem } from "@/components/key-metrics"
-import type { QuestionBankItem } from "@/lib/mock/question-bank"
+import type { QuestionBankItem, QuestionBankType } from "@/lib/mock/question-bank"
+
+/** Point-biserial below this mock threshold counts as a psychometric review flag. */
+const PBI_REVIEW_THRESHOLD = 0.2
+
+const TYPE_LABEL: Record<QuestionBankType, string> = {
+  multiple_choice: "Multiple choice",
+  true_false: "True / false",
+  short_answer: "Short answer",
+}
 
 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
+  const mcq = rows.filter(r => r.type === "multiple_choice").length
+  const tf = rows.filter(r => r.type === "true_false").length
+  const sa = rows.filter(r => r.type === "short_answer").length
+  const writtenTypes = tf + sa
+  const lowPbiFlags = rows.filter(r => r.pbi != null && r.pbi < PBI_REVIEW_THRESHOLD).length
 
   return [
     {
@@ -17,45 +28,46 @@ export function questionBankKpiMetrics(rows: QuestionBankItem[]): MetricItem[] {
       metricVariant: "hero",
     },
     {
-      id: "published",
-      label: "Published",
-      value: published,
+      id: "mcq",
+      label: TYPE_LABEL.multiple_choice,
+      value: mcq,
       delta: "—",
       trend: "neutral",
       href: "#",
     },
     {
-      id: "review",
-      label: "In review",
-      value: review,
-      delta: review > 0 ? "!" : "—",
-      trend: review > 0 ? "up" : "neutral",
+      id: "written",
+      label: "True / false & short answer",
+      value: writtenTypes,
+      delta: "—",
+      trend: "neutral",
       href: "#",
     },
     {
-      id: "draft",
-      label: "Drafts",
-      value: draft,
-      delta: "—",
-      trend: "neutral",
+      id: "pbi-flags",
+      label: "Low PBI (review)",
+      value: lowPbiFlags,
+      delta: lowPbiFlags >= 2 ? "+1" : "—",
+      trend: lowPbiFlags >= 2 ? "up" : "neutral",
+      trendPolarity: "lower_is_better",
       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
+  const hard = rows.filter(r => r.difficulty === "hard").length
+  const topics = new Set(rows.map(r => r.topic)).size
   return {
     title: "Folder library",
     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",
+      rows.length === 0
+        ? "Add questions to populate metrics and charts."
+        : hard > 3
+          ? `${hard} hard items in this view — balance with easier items where learners need quick wins.`
+          : `${rows.length} question${rows.length === 1 ? "" : "s"} across ${topics} topic${topics === 1 ? "" : "s"} in the filtered set.`,
+    href: "/question-bank/library",
+    severity: hard > 3 ? "warning" : "info",
     actionLabel: "Ask Leo",
   }
 }

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

@@ -2,7 +2,6 @@
  * Mock question bank items — replace with API in production.
  */
 
-export type QuestionBankStatus = "published" | "draft" | "in_review"
 export type QuestionBankType = "multiple_choice" | "true_false" | "short_answer"
 export type QuestionBankDifficulty = "easy" | "medium" | "hard"
 
@@ -17,13 +16,16 @@ export type QuestionBankBloomLevel =
 
 export interface QuestionBankItem extends Record<string, unknown> {
   id: string
+  /** Stable human-facing identifier (catalog, search, citations). */
+  questionId: string
   /** Short preview / stem */
   stem: string
   topic: string
   type: QuestionBankType
   difficulty: QuestionBankDifficulty
-  status: QuestionBankStatus
   author: string
+  /** Work email for the primary author (demo; optional when API omits). */
+  authorEmail?: string
   updatedAt: string
   /** Folder tree id (`lib/mock/question-bank-folders.ts`). */
   folderId: string
@@ -54,19 +56,27 @@ export interface QuestionBankItem extends Record<string, unknown> {
   avgScoreCorrectPct?: number
   /** Where / when the item was last used on an exam. */
   lastUsedLabel?: string
+  /** Starred outside the Favorites folder (list landing demo). */
+  isStarred?: boolean
+}
+
+/** New mock rows — assign a unique `questionId` when creating client-side. */
+export function newQuestionBankQuestionId(): string {
+  return `QB-NEW-${Date.now().toString(36).toUpperCase()}`
 }
 
 export const QUESTION_BANK_ITEMS: QuestionBankItem[] = [
   {
     id: "q1",
+    questionId: "QB-ANA-001",
     stem: "Which nerve roots contribute to the brachial plexus?",
     topic: "Anatomy",
     type: "multiple_choice",
     difficulty: "medium",
-    status: "published",
     author: "Dr. Chen",
+    authorEmail: "mei.chen@demo.exxat.io",
     updatedAt: "2026-03-28",
-    folderId: "fld-science",
+    folderId: "fld-favorites",
     itemCode: "QB-ANA-001",
     bloomLevel: "Apply",
     tags: ["Brachial plexus", "Peripheral nerves", "Spine"],
@@ -88,36 +98,45 @@ export const QUESTION_BANK_ITEMS: QuestionBankItem[] = [
   },
   {
     id: "q2",
+    questionId: "QB-CNL-002",
     stem: "Document baseline vitals before administering contrast.",
     topic: "Clinical skills",
     type: "true_false",
     difficulty: "easy",
-    status: "published",
     author: "Jordan Lee",
+    authorEmail: "jordan.lee@demo.exxat.io",
     updatedAt: "2026-03-27",
     folderId: "fld-skills-lab",
+    isStarred: true,
+    pbi: 0.55,
   },
   {
     id: "q3",
+    questionId: "QB-NEU-003",
     stem: "List three red flags for cauda equina syndrome.",
     topic: "Neurology",
     type: "short_answer",
     difficulty: "hard",
-    status: "in_review",
     author: "Alex Rivera",
+    authorEmail: "alex.rivera@demo.exxat.io",
     updatedAt: "2026-03-26",
     folderId: "fld-science",
+    isStarred: true,
+    pbi: 0.14,
   },
   {
     id: "q4",
+    questionId: "QB-ETH-004",
     stem: "HIPAA permits disclosure to family without consent when…",
     topic: "Ethics & law",
     type: "multiple_choice",
     difficulty: "medium",
-    status: "draft",
     author: "Sam Patel",
+    authorEmail: "sam.patel@demo.exxat.io",
     updatedAt: "2026-03-25",
     folderId: "fld-ethics",
+    isStarred: true,
+    pbi: 0.19,
     options: [
       { text: "Patient is incapacitated and disclosure is in their best interest", isCorrect: true },
       { text: "Family member requests the information", isCorrect: false },
@@ -127,23 +146,25 @@ export const QUESTION_BANK_ITEMS: QuestionBankItem[] = [
   },
   {
     id: "q5",
+    questionId: "QB-ASM-005",
     stem: "Calculate BMI given height and weight (metric).",
     topic: "Assessment",
     type: "short_answer",
     difficulty: "easy",
-    status: "published",
     author: "Dr. Chen",
+    authorEmail: "mei.chen@demo.exxat.io",
     updatedAt: "2026-03-24",
-    folderId: "fld-clinical",
+    folderId: "fld-favorites",
   },
   {
     id: "q6",
+    questionId: "QB-ICO-006",
     stem: "Sterile field must be prepared before which step?",
     topic: "Infection control",
     type: "multiple_choice",
     difficulty: "medium",
-    status: "published",
     author: "Morgan Lee",
+    authorEmail: "morgan.lee@demo.exxat.io",
     updatedAt: "2026-03-23",
     folderId: "fld-ops",
     options: [
@@ -155,67 +176,73 @@ export const QUESTION_BANK_ITEMS: QuestionBankItem[] = [
   },
   {
     id: "q7",
+    questionId: "QB-DOC-007",
     stem: "SOAP note: subjective section documents patient-reported data only.",
     topic: "Documentation",
     type: "true_false",
     difficulty: "easy",
-    status: "draft",
     author: "Casey Nguyen",
+    authorEmail: "casey.nguyen@demo.exxat.io",
     updatedAt: "2026-03-22",
     folderId: "fld-clinical",
   },
   {
     id: "q8",
+    questionId: "QB-RAD-008",
     stem: "Contrast MRI safety screening includes renal function when…",
     topic: "Radiology",
     type: "multiple_choice",
     difficulty: "hard",
-    status: "in_review",
     author: "Riley Johnson",
+    authorEmail: "riley.johnson@demo.exxat.io",
     updatedAt: "2026-03-21",
     folderId: "fld-science",
   },
   {
     id: "q9",
+    questionId: "QB-COM-009",
     stem: "Therapeutic communication: reflect feelings before offering solutions.",
     topic: "Communication",
     type: "true_false",
     difficulty: "medium",
-    status: "published",
     author: "Quinn Martinez",
+    authorEmail: "quinn.martinez@demo.exxat.io",
     updatedAt: "2026-03-20",
     folderId: "fld-clinical",
   },
   {
     id: "q10",
+    questionId: "QB-PHA-010",
     stem: "Pediatric dose calculation uses body surface area when…",
     topic: "Pharmacology",
     type: "short_answer",
     difficulty: "hard",
-    status: "published",
     author: "Dr. Chen",
+    authorEmail: "mei.chen@demo.exxat.io",
     updatedAt: "2026-03-19",
     folderId: "fld-science",
   },
   {
     id: "q11",
+    questionId: "QB-SAF-011",
     stem: "Fall risk assessment should be repeated after medication changes.",
     topic: "Safety",
     type: "true_false",
     difficulty: "easy",
-    status: "draft",
     author: "Taylor Brooks",
+    authorEmail: "taylor.brooks@demo.exxat.io",
     updatedAt: "2026-03-18",
     folderId: "fld-ops",
   },
   {
     id: "q12",
+    questionId: "QB-ICO-012",
     stem: "Describe hand hygiene moments (WHO five moments).",
     topic: "Infection control",
     type: "short_answer",
     difficulty: "medium",
-    status: "in_review",
     author: "Jordan Lee",
+    authorEmail: "jordan.lee@demo.exxat.io",
     updatedAt: "2026-03-17",
     folderId: "fld-ops",
   },