@exxatdesignux/ui 0.2.9 → 0.2.11

package/template/lib/question-bank-dedicated-search.ts

@@ -0,0 +1,19 @@
+import { patchQuestionBankUrlSearchParams } from "@/lib/question-bank-nav"
+
+/** Rotating example queries for dedicated search composers on list/find surfaces. */
+export const QUESTION_BANK_DEDICATED_SEARCH_PLACEHOLDERS = [
+  "all the questions I used in last year's assessment",
+  "what did we run for the spring OSCE checkout?",
+  "Clinical folder, cardiology tagged, for third-year summative",
+  "find QB-2024-0012 and anything like it",
+  "that anemia vignette from the shelf-style block",
+  "MCQs I still need before next week's diabetes station",
+] as const
+
+export function patchQuestionBankDedicatedSearchParams(
+  current: URLSearchParams,
+  submittedText: string,
+): URLSearchParams {
+  const t = submittedText.trim()
+  return patchQuestionBankUrlSearchParams(current, { q: t || null })
+}

package/template/lib/question-bank-hub-search.ts

@@ -0,0 +1,90 @@
+import type { DiscoveryHubSearchGroup } from "@/lib/discovery-hub"
+import {
+  QUESTION_BANK_ENTRY_PATH,
+  QUESTION_BANK_LIBRARY_PATH,
+} from "@/lib/question-bank-nav"
+
+export type { DiscoveryHubSearchGroup, DiscoveryHubSearchItem } from "@/lib/discovery-hub"
+
+export function buildQuestionBankHubSearchGroups(): DiscoveryHubSearchGroup[] {
+  return [
+    {
+      id: "ai-create",
+      heading: "Create with AI",
+      items: [
+        {
+          id: "ai-mcq",
+          label: "Draft a multiple-choice question on clinical reasoning",
+          keywords: "ai leo create mcq multiple choice clinical reasoning",
+          askLeoPrompt:
+            "Help me draft a multiple-choice assessment question focused on clinical reasoning. Ask clarifying questions about topic, difficulty, and learning objective before proposing stems and distractors.",
+        },
+        {
+          id: "ai-osce",
+          label: "Generate an OSCE checklist from a case vignette",
+          keywords: "ai leo osce checklist vignette station",
+          askLeoPrompt:
+            "I want to generate an OSCE checklist from a case vignette. Walk me through the case details you need, then propose observable behaviors and scoring notes.",
+        },
+        {
+          id: "ai-remediation",
+          label: "Turn missed items into remediation questions",
+          keywords: "ai leo remediation review missed items",
+          askLeoPrompt:
+            "Turn a list of missed assessment items into remediation questions. Ask what content area and learner level to target, then suggest short-answer or MCQ follow-ups.",
+        },
+        {
+          id: "ai-bank-outline",
+          label: "Outline a new question bank for a course module",
+          keywords: "ai leo outline bank module taxonomy folders",
+          askLeoPrompt:
+            "Help me outline a new question bank for a course module. Suggest folder structure, item types, and a balanced mix of difficulty before we add items.",
+        },
+      ],
+    },
+    {
+      id: "actions",
+      heading: "Quick actions",
+      items: [
+        {
+          id: "browse-library",
+          label: "Browse question library",
+          keywords: "library table folder panel tree views",
+          icon: "fa-light fa-table-list",
+          href: QUESTION_BANK_LIBRARY_PATH,
+        },
+        {
+          id: "browse-my",
+          label: "Open my questions",
+          keywords: "my questions author scope",
+          icon: "fa-light fa-user",
+          href: `${QUESTION_BANK_LIBRARY_PATH}?scope=my`,
+        },
+        {
+          id: "new-question",
+          label: "Create new question",
+          keywords: "new question create draft author",
+          icon: "fa-light fa-plus",
+          askLeoPrompt:
+            "Help me create a new assessment question. Start by asking for topic, item type, difficulty, and learning objective, then draft the stem, answer choices, and rationale.",
+        },
+        {
+          id: "hub-entry",
+          label: "Question bank home",
+          keywords: "home hub search",
+          icon: "fa-light fa-house",
+          href: QUESTION_BANK_ENTRY_PATH,
+        },
+      ],
+    },
+  ]
+}
+
+export const QUESTION_BANK_HUB_SEARCH_PLACEHOLDER =
+  "Search questions, folders, or describe what you want to create…"
+
+export const QUESTION_BANK_HUB_ASK_LEO_PROMPTS = [
+  "Draft five MCQs on pharmacology with rationales",
+  "Suggest folder names for a new pediatrics bank",
+  "Rewrite this stem for clarity and bias-free wording",
+] as const

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

@@ -17,14 +17,85 @@ export interface QuestionBankNavState {
   folderId: string | null
 }
 
+export const QUESTION_BANK_ENTRY_PATH = "/question-bank"
+
+/** Breadcrumb segment for the discovery hub — links from library / search shells back to `/question-bank`. */
+export const QUESTION_BANK_HUB_BREADCRUMB = {
+  label: "Question hub",
+  href: QUESTION_BANK_ENTRY_PATH,
+} as const
+
+/** List hub with secondary nav, views, and table state. */
+export const QUESTION_BANK_LIBRARY_PATH = "/question-bank/library"
+
+/**
+ * Same hub as the library (table + panel + tree) but intended for search landings (`?q=`).
+ * Keeps secondary panel + nav behavior aligned with {@link QUESTION_BANK_LIBRARY_PATH}.
+ */
+export const QUESTION_BANK_LIST_PATH = "/question-bank/list"
+
+/**
+ * Results from the discovery hub composer — same table stack as {@link QUESTION_BANK_LIST_PATH} but a
+ * distinct URL so library “Search” and hub-driven search are not conflated.
+ */
+export const QUESTION_BANK_HUB_FIND_PATH = "/question-bank/find"
+
+/** @deprecated Use `QUESTION_BANK_LIBRARY_PATH` for scoped library routes. */
+export const QUESTION_BANK_HUB_PATH = QUESTION_BANK_LIBRARY_PATH
+
+export const QUESTION_BANK_LIBRARY_HUB_PATHS: readonly string[] = [
+  QUESTION_BANK_LIBRARY_PATH,
+  QUESTION_BANK_LIST_PATH,
+  QUESTION_BANK_HUB_FIND_PATH,
+]
+
+/** Library list search (`/list`) or hub discovery search (`/find`) — both use the dedicated search shell. */
+export function isQuestionBankDedicatedSearchPathname(pathname: string): boolean {
+  return pathname === QUESTION_BANK_LIST_PATH || pathname === QUESTION_BANK_HUB_FIND_PATH
+}
+
+/** Default secondary-nav selection — All questions (no `scope` query). */
+export const QUESTION_BANK_DEFAULT_NAV: QuestionBankNavState = {
+  scope: "all",
+  folderId: null,
+}
+
+export function isQuestionBankDefaultNav(nav: QuestionBankNavState): boolean {
+  return nav.scope === "all" && nav.folderId === null
+}
+
 export function parseQuestionBankNav(searchParams: URLSearchParams): QuestionBankNavState {
   const raw = (searchParams.get("scope") ?? "all").toLowerCase()
   if (raw === "my") return { scope: "my", folderId: null }
   if (raw === "folder") {
+    const rawId = searchParams.get("folderId") ?? searchParams.get("folder")
+    const folderId = typeof rawId === "string" ? rawId.trim() || null : null
+    return { scope: "folder", folderId }
+  }
+  if (raw === "all") return { ...QUESTION_BANK_DEFAULT_NAV }
+  return { ...QUESTION_BANK_DEFAULT_NAV }
+}
+
+/** Rewrite invalid or incomplete scope URLs back to the default All questions hub. Preserves list search params when present. */
+export function questionBankCanonicalNavHref(searchParams: URLSearchParams): string | null {
+  const raw = searchParams.get("scope")
+  if (!raw) return null
+  const lowered = raw.toLowerCase()
+  const q = searchParams.get("q")?.trim() || null
+  const fav = searchParams.get("fav") === "1"
+  const deckClinical = searchParams.get("deck") === "clinical"
+  const preserved = {
+    q,
+    ...(fav ? { fav: true as const } : {}),
+    ...(deckClinical ? { deck: "clinical" as const } : {}),
+  }
+  if (lowered === "my") return null
+  if (lowered === "folder") {
     const folderId = searchParams.get("folderId") ?? searchParams.get("folder")
-    return { scope: "folder", folderId: folderId || null }
+    return folderId ? null : questionBankNavHref({ scope: "all", ...preserved })
   }
-  return { scope: "all", folderId: null }
+  if (lowered === "all") return null
+  return questionBankNavHref({ scope: "all", ...preserved })
 }
 
 /** Breadcrumb + title for `SiteHeader` / `PageHeader` (matches secondary nav scopes). */
@@ -39,18 +110,21 @@ export function questionBankHubHeaderModel(
 ): QuestionBankHubHeaderModel {
   if (nav.scope === "my") {
     return {
-      breadcrumbs: [{ label: "Question bank", href: "/question-bank" }],
+      breadcrumbs: [{ label: QUESTION_BANK_HUB_BREADCRUMB.label, href: QUESTION_BANK_HUB_BREADCRUMB.href }],
       title: "My questions",
     }
   }
   if (nav.scope === "folder" && nav.folderId) {
     const name = folders.find(f => f.id === nav.folderId)?.name ?? "Folder"
     return {
-      breadcrumbs: [{ label: "Question bank", href: "/question-bank" }],
+      breadcrumbs: [{ label: QUESTION_BANK_HUB_BREADCRUMB.label, href: QUESTION_BANK_HUB_BREADCRUMB.href }],
       title: name,
     }
   }
-  return { title: "All questions" }
+  return {
+    breadcrumbs: [{ label: QUESTION_BANK_HUB_BREADCRUMB.label, href: QUESTION_BANK_HUB_BREADCRUMB.href }],
+    title: "All questions",
+  }
 }
 
 export function filterQuestionBankItemsByNav(
@@ -71,19 +145,261 @@ export function filterQuestionBankItemsByNav(
   return items
 }
 
+/** Mock folder id for the Favorites bucket (see `DEFAULT_QUESTION_BANK_FOLDERS`). */
+export const QUESTION_BANK_FAVORITES_FOLDER_ID = "fld-favorites"
+
+/** Root folder id for the mock “Clinical” tree (`fld-skills-lab` is a child). */
+export const QUESTION_BANK_CLINICAL_ROOT_FOLDER_ID = "fld-clinical"
+
+/**
+ * Client-side “AI / hub” free-text filter — same scan as `useTableState` toolbar search
+ * (`Object.values` → string → lowercase `includes`).
+ */
+export function filterQuestionBankItemsByFreeText(items: QuestionBankItem[], q: string): QuestionBankItem[] {
+  const t = q.trim()
+  if (!t) return items
+  const needle = t.toLowerCase()
+  return items.filter(row =>
+    Object.values(row).some(v => String(v ?? "").toLowerCase().includes(needle)),
+  )
+}
+
+export function isQuestionBankItemFavorite(item: QuestionBankItem): boolean {
+  return item.folderId === QUESTION_BANK_FAVORITES_FOLDER_ID || item.isStarred === true
+}
+
+/** When a mock row lives in the Favorites folder, toggling off moves it here (no “original folder” yet). */
+const QUESTION_BANK_UNFAVORITE_FALLBACK_FOLDER_ID = "fld-science"
+
+/** Demo toggle for `isStarred` / Favorites folder membership (offline mock only). */
+export function toggleQuestionBankItemFavorite(item: QuestionBankItem): QuestionBankItem {
+  if (isQuestionBankItemFavorite(item)) {
+    if (item.folderId === QUESTION_BANK_FAVORITES_FOLDER_ID) {
+      return {
+        ...item,
+        folderId: QUESTION_BANK_UNFAVORITE_FALLBACK_FOLDER_ID,
+        isStarred: false,
+      }
+    }
+    return { ...item, isStarred: false }
+  }
+  return { ...item, isStarred: true }
+}
+
+export function filterQuestionBankItemsByFavoritesOnly(items: QuestionBankItem[]): QuestionBankItem[] {
+  return items.filter(isQuestionBankItemFavorite)
+}
+
+/**
+ * Mock “Clinical deck” (`deck=clinical`): items under the Clinical folder tree **or**
+ * demo topics “Clinical skills” / “Neurology” (so list landings can show a coherent slice).
+ */
+export function filterQuestionBankItemsByClinicalDeckMock(
+  items: QuestionBankItem[],
+  folders: QuestionBankFolder[],
+): QuestionBankItem[] {
+  const inClinicalTree = collectFolderDescendantIds(folders, QUESTION_BANK_CLINICAL_ROOT_FOLDER_ID)
+  const topicMatch = new Set(["Clinical skills", "Neurology"])
+  return items.filter(
+    i => inClinicalTree.has(i.folderId) || topicMatch.has(i.topic),
+  )
+}
+
+export type QuestionBankLandingFilterState = {
+  hubFreeText: string
+  favOnly: boolean
+  clinicalDeck: boolean
+}
+
+/**
+ * Nav scope + optional dedicated search routes (`/question-bank/list`, `/question-bank/find`) landing filters (`q`, `fav`, `deck`).
+ * When `hubFreeText` is non-empty but matches no rows, hub text is ignored so the scoped list still shows.
+ */
+export function applyQuestionBankHubDisplayFilters(
+  items: QuestionBankItem[],
+  folders: QuestionBankFolder[],
+  nav: QuestionBankNavState,
+  landing: QuestionBankLandingFilterState | null,
+): QuestionBankItem[] {
+  let rows = filterQuestionBankItemsByNav(items, folders, nav)
+  if (!landing) return rows
+  let afterText = filterQuestionBankItemsByFreeText(rows, landing.hubFreeText)
+  if (landing.hubFreeText.trim() && afterText.length === 0) {
+    afterText = rows
+  }
+  rows = afterText
+  if (landing.favOnly) rows = filterQuestionBankItemsByFavoritesOnly(rows)
+  if (landing.clinicalDeck) rows = filterQuestionBankItemsByClinicalDeckMock(rows, folders)
+  return rows
+}
+
+/** True when hub `q` is non-empty but matches no rows under the current nav (before fav/deck). */
+export function questionBankHubTextMatchesNothing(
+  items: QuestionBankItem[],
+  folders: QuestionBankFolder[],
+  nav: QuestionBankNavState,
+  landing: QuestionBankLandingFilterState | null,
+): boolean {
+  if (!landing?.hubFreeText.trim()) return false
+  const navRows = filterQuestionBankItemsByNav(items, folders, nav)
+  return filterQuestionBankItemsByFreeText(navRows, landing.hubFreeText).length === 0
+}
+
+export function patchQuestionBankUrlSearchParams(
+  sp: URLSearchParams,
+  patch: {
+    q?: string | null
+    fav?: boolean | null
+    deckClinical?: boolean | null
+  },
+): URLSearchParams {
+  const next = new URLSearchParams(sp.toString())
+  if (patch.q !== undefined) {
+    const t = patch.q?.trim() ?? ""
+    if (t) next.set("q", t)
+    else next.delete("q")
+  }
+  if (patch.fav !== undefined) {
+    if (patch.fav) next.set("fav", "1")
+    else next.delete("fav")
+  }
+  if (patch.deckClinical !== undefined) {
+    if (patch.deckClinical) next.set("deck", "clinical")
+    else next.delete("deck")
+  }
+  return next
+}
+
+/** Build {@link QUESTION_BANK_LIST_PATH} query consistently (nav + hub search + mock toggles). */
+export function questionBankListSearchHref(
+  nav: QuestionBankNavState,
+  opts: { q?: string | null; fav?: boolean; deckClinical?: boolean },
+): string {
+  return questionBankNavHref({
+    scope: nav.scope,
+    folderId: nav.folderId,
+    searchLanding: true,
+    q: opts.q,
+    fav: opts.fav,
+    deck: opts.deckClinical ? "clinical" : undefined,
+  })
+}
+
+/** Favorites bucket — same folder scope on library, list, or hub-find; preserves `q` / mock toggles on dedicated search routes. */
+export function questionBankFavoritesFolderHref(pathname: string, currentSearch: URLSearchParams): string {
+  const onList = pathname === QUESTION_BANK_LIST_PATH
+  const onHubFind = pathname === QUESTION_BANK_HUB_FIND_PATH
+  const q = currentSearch.get("q")
+  const fav = currentSearch.get("fav") === "1"
+  const deckClinical = currentSearch.get("deck") === "clinical"
+  return questionBankNavHref({
+    scope: "folder",
+    folderId: QUESTION_BANK_FAVORITES_FOLDER_ID,
+    ...(onList ? { searchLanding: true } : onHubFind ? { hubFind: true } : {}),
+    q,
+    ...(fav ? { fav: true as const } : {}),
+    ...(deckClinical ? { deck: "clinical" as const } : {}),
+  })
+}
+
+/** “Search” secondary nav — {@link QUESTION_BANK_LIST_PATH} without `?q=` (always the search landing). Preserves `fav` / `deck` when set. */
+export function questionBankSearchLandingNavHref(
+  nav: QuestionBankNavState,
+  currentSearch: URLSearchParams,
+): string {
+  const listNav: QuestionBankNavState =
+    nav.scope === "folder" ? QUESTION_BANK_DEFAULT_NAV : nav
+  return questionBankListSearchHref(listNav, {
+    fav: currentSearch.get("fav") === "1" ? true : undefined,
+    deckClinical: currentSearch.get("deck") === "clinical" ? true : undefined,
+  })
+}
+
+/** True when the dedicated search shell should show the “Search” nav row as current (not browsing a folder there). */
+export function isQuestionBankSearchNavActive(pathname: string, nav: QuestionBankNavState): boolean {
+  if (pathname !== QUESTION_BANK_LIST_PATH && pathname !== QUESTION_BANK_HUB_FIND_PATH) return false
+  if (nav.scope === "folder" && nav.folderId) return false
+  return true
+}
+
+/**
+ * Hub scope link that preserves list-only params (`q`, `fav`, `deck`) when the user is already
+ * on {@link QUESTION_BANK_LIST_PATH}; folder / “My” targets use the library path per product rule.
+ */
+export function questionBankHubScopeHref(
+  pathname: string,
+  currentSearch: URLSearchParams,
+  patch: { scope: QuestionBankNavScope; folderId?: string | null },
+): string {
+  const onList = pathname === QUESTION_BANK_LIST_PATH
+  const onHubFind = pathname === QUESTION_BANK_HUB_FIND_PATH
+  const q = currentSearch.get("q")
+  const fav = currentSearch.get("fav") === "1"
+  const deckClinical = currentSearch.get("deck") === "clinical"
+  const landingBits = {
+    q,
+    ...(fav ? { fav: true as const } : {}),
+    ...(deckClinical ? { deck: "clinical" as const } : {}),
+  }
+  if (patch.scope === "my" || (patch.scope === "folder" && patch.folderId)) {
+    return questionBankNavHref({
+      scope: patch.scope,
+      folderId: patch.folderId,
+      searchLanding: false,
+    })
+  }
+  if (patch.scope === "all") {
+    return questionBankNavHref({
+      scope: "all",
+      ...(onList ? { searchLanding: true } : onHubFind ? { hubFind: true } : {}),
+      ...landingBits,
+    })
+  }
+  return questionBankNavHref({ scope: "all", searchLanding: false })
+}
+
 /** Build `/question-bank` href with optional query + hash (hash without leading `#`). */
 export function questionBankNavHref(opts: {
   scope: QuestionBankNavScope
   folderId?: string | null
   hash?: string
+  /**
+   * Hub / panel search string (`?q=`). On {@link QUESTION_BANK_LIST_PATH} and {@link QUESTION_BANK_HUB_FIND_PATH}
+   * this filters rows via {@link applyQuestionBankHubDisplayFilters} — **not** the DataTable toolbar
+   * (toolbar stays independent on those routes).
+   */
+  q?: string | null
+  /** Mock list filter: `fav=1` — favorites folder or `isStarred` rows. */
+  fav?: boolean
+  /** Mock list filter: `deck=clinical` — see {@link filterQuestionBankItemsByClinicalDeckMock}. */
+  deck?: "clinical" | null
+  /**
+   * When true, links use {@link QUESTION_BANK_LIST_PATH} (library “Search” in secondary nav).
+   * Scoped folder / mine links should use `searchLanding: false` (library path).
+   */
+  searchLanding?: boolean
+  /**
+   * When true, links use {@link QUESTION_BANK_HUB_FIND_PATH} (discovery hub composer submit).
+   * Do not combine with `searchLanding` — hub find wins if both are set.
+   */
+  hubFind?: boolean
 }): string {
-  const base = "/question-bank"
+  const base =
+    opts.hubFind === true
+      ? QUESTION_BANK_HUB_FIND_PATH
+      : opts.searchLanding === true
+        ? QUESTION_BANK_LIST_PATH
+        : QUESTION_BANK_LIBRARY_PATH
   const sp = new URLSearchParams()
   if (opts.scope === "my") sp.set("scope", "my")
   if (opts.scope === "folder" && opts.folderId) {
     sp.set("scope", "folder")
     sp.set("folderId", opts.folderId)
   }
+  const trimmedQ = opts.q?.trim()
+  if (trimmedQ) sp.set("q", trimmedQ)
+  if (opts.fav) sp.set("fav", "1")
+  if (opts.deck === "clinical") sp.set("deck", "clinical")
   const qs = sp.toString()
   const h = opts.hash?.replace(/^#/, "")
   const hashPart = h ? `#${h}` : ""

package/template/lib/question-bank-recent-searches.ts

@@ -0,0 +1,22 @@
+import { createDedicatedSearchRecentsController } from "@/lib/dedicated-search-recents"
+
+const controller = createDedicatedSearchRecentsController("question-bank", {
+  storageKey: "exxat-ds.question-bank.recent-searches.v1",
+  eventName: "exxat-question-bank-recent-searches",
+})
+
+export const QUESTION_BANK_RECENT_SEARCHES_EVENT = controller.eventName
+
+export const questionBankDedicatedSearchRecents = controller
+
+export function readQuestionBankRecentSearches(): string[] {
+  return controller.read()
+}
+
+export function recordQuestionBankRecentSearch(query: string): void {
+  controller.record(query)
+}
+
+export function clearQuestionBankRecentSearches(): void {
+  controller.clear()
+}

package/template/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "private": true,
   "engines": {
-    "node": ">=24"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "dev": "next dev --turbopack",
@@ -44,7 +44,6 @@
     "motion": "^12.38.0",
     "next": "16.2.4",
     "next-themes": "^0.4.6",
-    "radix-ui": "^1.4.3",
     "react": "^19.2.4",
     "react-day-picker": "^9.14.0",
     "react-dom": "^19.2.4",