@exxatdesignux/ui 0.3.0 → 0.4.1

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

@@ -1,477 +0,0 @@
-/**
- * Question bank secondary nav + URL scope — demo “My” matches mock author rows.
- */
-
-import type { QuestionBankItem } from "@/lib/mock/question-bank"
-import type { QuestionBankFolder } from "@/lib/mock/question-bank-folders"
-import { collectFolderDescendantIds } from "@/lib/mock/question-bank-folders"
-
-/** Demo curator — “My questions” filters `author` / `createdBy` to this value. */
-export const QUESTION_BANK_NAV_MY_AUTHOR = "Dr. Chen"
-
-export type QuestionBankNavScope = "all" | "my" | "folder"
-
-export interface QuestionBankNavState {
-  scope: QuestionBankNavScope
-  /** Set when `scope === "folder"` */
-  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
-}
-
-/**
- * Whether a secondary-nav row (All / My / folder / Search) matches the current URL + parsed nav.
- * Used by `QuestionBankSecondaryNav` and the folder tree branch.
- */
-export function isQuestionBankNavActive(
-  pathname: string,
-  nav: QuestionBankNavState,
-  scope: QuestionBankNavScope,
-  folderId?: string | null,
-): boolean {
-  const p = pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname
-  if (!QUESTION_BANK_LIBRARY_HUB_PATHS.includes(p)) return false
-  if (scope === "all") {
-    if (isQuestionBankDedicatedSearchPathname(pathname)) return false
-    return nav.scope === "all"
-  }
-  if (scope === "my") {
-    if (isQuestionBankDedicatedSearchPathname(pathname)) return false
-    return nav.scope === "my"
-  }
-  if (scope === "folder" && folderId) {
-    return nav.scope === "folder" && nav.folderId === folderId
-  }
-  return false
-}
-
-/** 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 folderId ? null : questionBankNavHref({ scope: "all", ...preserved })
-  }
-  if (lowered === "all") return null
-  return questionBankNavHref({ scope: "all", ...preserved })
-}
-
-/** Breadcrumb + title for `SiteHeader` / `PageHeader` (matches secondary nav scopes). */
-export interface QuestionBankHubHeaderModel {
-  title: string
-  breadcrumbs?: { label: string; href?: string }[]
-}
-
-/** Back link for `/question-bank/new` — icon + parent label in `SiteHeader` (`back` prop). */
-export function newQuestionBackNav(
-  folders: QuestionBankFolder[],
-  folderId?: string,
-): { label: string; href: string } {
-  if (folderId) {
-    const folder = folders.find(f => f.id === folderId)
-    if (folder) {
-      return {
-        label: folder.name,
-        href: questionBankNavHref({ scope: "folder", folderId: folder.id }),
-      }
-    }
-  }
-  return {
-    label: QUESTION_BANK_HUB_BREADCRUMB.label,
-    href: questionBankNavHref({ scope: "all" }),
-  }
-}
-
-/** Ancestor-only breadcrumbs for `/question-bank/new` (current page is the PageHeader title). */
-export function newQuestionBreadcrumbs(
-  folders: QuestionBankFolder[],
-  folderId?: string,
-): { label: string; href: string }[] {
-  if (folderId) {
-    const folder = folders.find(f => f.id === folderId)
-    if (folder) {
-      return [
-        {
-          label: folder.name,
-          href: questionBankNavHref({ scope: "folder", folderId: folder.id }),
-        },
-      ]
-    }
-  }
-  return [
-    {
-      label: QUESTION_BANK_HUB_BREADCRUMB.label,
-      href: QUESTION_BANK_HUB_BREADCRUMB.href,
-    },
-  ]
-}
-
-export function questionBankHubHeaderModel(
-  folders: QuestionBankFolder[],
-  nav: QuestionBankNavState,
-): QuestionBankHubHeaderModel {
-  if (nav.scope === "my") {
-    return {
-      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_HUB_BREADCRUMB.label, href: QUESTION_BANK_HUB_BREADCRUMB.href }],
-      title: name,
-    }
-  }
-  return {
-    breadcrumbs: [{ label: QUESTION_BANK_HUB_BREADCRUMB.label, href: QUESTION_BANK_HUB_BREADCRUMB.href }],
-    title: "All questions",
-  }
-}
-
-export function filterQuestionBankItemsByNav(
-  items: QuestionBankItem[],
-  folders: QuestionBankFolder[],
-  nav: QuestionBankNavState,
-): QuestionBankItem[] {
-  if (nav.scope === "all") return items
-  if (nav.scope === "my") {
-    return items.filter(
-      i => i.author === QUESTION_BANK_NAV_MY_AUTHOR || i.createdBy === QUESTION_BANK_NAV_MY_AUTHOR,
-    )
-  }
-  if (nav.scope === "folder" && nav.folderId) {
-    const allowedFolderIds = collectFolderDescendantIds(folders, nav.folderId)
-    return items.filter(i => allowedFolderIds.has(i.folderId))
-  }
-  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 =
-    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}` : ""
-  return qs ? `${base}?${qs}${hashPart}` : `${base}${hashPart}`
-}

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

@@ -1,22 +0,0 @@
-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/lib/question-bank-supported-views.ts

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

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

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

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

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