@exxatdesignux/ui 0.2.19 → 0.4.0

package/template/lib/mock/{question-bank-folders.ts → library-folders.ts}

@@ -1,9 +1,9 @@
 /**
- * Question bank folder tree (mock) — OS-style icon folders with appearance + hierarchy.
+ * Library folder tree (mock) — OS-style icon folders with appearance + hierarchy.
  * Production: replace with API + optimistic updates.
  */
 
-export type QuestionBankFolderColorKey =
+export type LibraryFolderColorKey =
   | "brand"
   | "success"
   | "warning"
@@ -13,19 +13,19 @@ export type QuestionBankFolderColorKey =
   | "chart2"
   | "chart3"
 
-export interface QuestionBankFolder {
+export interface LibraryFolder {
   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
+  colorKey: LibraryFolderColorKey
 }
 
 /** Tile + icon tint classes (semantic tokens). */
-export const QUESTION_BANK_FOLDER_COLOR_STYLES: Record<
-  QuestionBankFolderColorKey,
+export const LIBRARY_FOLDER_COLOR_STYLES: Record<
+  LibraryFolderColorKey,
   { tile: string; iconWrap: string; icon: string }
 > = {
   brand: {
@@ -71,7 +71,7 @@ export const QUESTION_BANK_FOLDER_COLOR_STYLES: Record<
 }
 
 /** Icon color classes using Tailwind — for use in text-based contexts (list views, panels). */
-export const QUESTION_BANK_FOLDER_ICON_COLORS: Record<QuestionBankFolderColorKey, string> = {
+export const LIBRARY_FOLDER_ICON_COLORS: Record<LibraryFolderColorKey, 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",
@@ -83,25 +83,25 @@ export const QUESTION_BANK_FOLDER_ICON_COLORS: Record<QuestionBankFolderColorKey
 }
 
 /** Preset icons for folder appearance picker. */
-export const QUESTION_BANK_FOLDER_ICON_OPTIONS: readonly string[] = [
+export const LIBRARY_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-bookmark",
+  "fa-box",
+  "fa-box-archive",
+  "fa-tag",
+  "fa-flag",
+  "fa-star",
   "fa-file-lines",
   "fa-layer-group",
   "fa-clipboard-check",
-  "fa-vial",
-  "fa-user-doctor",
-  "fa-kit-medical",
-  "fa-notes-medical",
+  "fa-list-check",
+  "fa-grid-2",
+  "fa-folder-tree",
 ] as const
 
-export const DEFAULT_QUESTION_BANK_FOLDERS: QuestionBankFolder[] = [
+export const DEFAULT_LIBRARY_FOLDERS: LibraryFolder[] = [
   {
     id: "fld-favorites",
     name: "Favorites",
@@ -111,37 +111,37 @@ export const DEFAULT_QUESTION_BANK_FOLDERS: QuestionBankFolder[] = [
   },
   {
     id: "fld-clinical",
-    name: "Clinical",
+    name: "Folder 1",
     parentId: null,
-    icon: "fa-stethoscope",
+    icon: "fa-folder",
     colorKey: "brand",
   },
   {
     id: "fld-science",
-    name: "Basic science",
+    name: "Folder 2",
     parentId: null,
-    icon: "fa-flask",
+    icon: "fa-folder",
     colorKey: "chart2",
   },
   {
     id: "fld-ops",
-    name: "Operations",
+    name: "Folder 3",
     parentId: null,
-    icon: "fa-clipboard-check",
+    icon: "fa-folder",
     colorKey: "warning",
   },
   {
     id: "fld-ethics",
-    name: "Ethics & law",
+    name: "Folder 4",
     parentId: null,
-    icon: "fa-scale-balanced",
+    icon: "fa-folder",
     colorKey: "muted",
   },
   {
     id: "fld-skills-lab",
-    name: "Skills lab",
+    name: "Folder 1.A",
     parentId: "fld-clinical",
-    icon: "fa-vial",
+    icon: "fa-folder",
     colorKey: "success",
   },
 ]
@@ -150,7 +150,7 @@ 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> {
+export function collectFolderDescendantIds(folders: LibraryFolder[], rootId: string): Set<string> {
   const out = new Set<string>()
   function walk(id: string) {
     out.add(id)
@@ -163,7 +163,7 @@ export function collectFolderDescendantIds(folders: QuestionBankFolder[], rootId
 }
 
 export function isValidFolderMove(
-  folders: QuestionBankFolder[],
+  folders: LibraryFolder[],
   folderId: string,
   newParentId: string | null,
 ): boolean {

package/template/lib/mock/library-header-collaborators.ts

@@ -0,0 +1,54 @@
+/**
+ * Demo collaborators for Library collaboration header (stacked faces).
+ */
+
+import { stockPortraitUrl } from "@/lib/stock-portrait"
+import type { PageHeaderCollaborator } from "@/components/page-header"
+
+export const LIBRARY_HEADER_COLLABORATORS: PageHeaderCollaborator[] = [
+  {
+    id: "1",
+    name: "Owner A",
+    email: "owner.a@demo.exxat.io",
+    imageUrl: stockPortraitUrl("qb-collab-a"),
+    initials: "OA",
+    access: "owner",
+    roles: ["Role 1", "Role 2"],
+  },
+  {
+    id: "2",
+    name: "Owner B",
+    email: "owner.b@demo.exxat.io",
+    imageUrl: stockPortraitUrl("qb-collab-b"),
+    initials: "OB",
+    access: "editor",
+    roles: ["Role 3"],
+  },
+  {
+    id: "3",
+    name: "Owner C",
+    email: "owner.c@demo.exxat.io",
+    imageUrl: stockPortraitUrl("qb-collab-c"),
+    initials: "OC",
+    access: "editor",
+    roles: ["Role 2"],
+  },
+  {
+    id: "4",
+    name: "Owner D",
+    email: "owner.d@demo.exxat.io",
+    imageUrl: stockPortraitUrl("qb-collab-d"),
+    initials: "OD",
+    access: "commenter",
+    roles: ["Role 2"],
+  },
+  {
+    id: "5",
+    name: "Owner E",
+    email: "owner.e@demo.exxat.io",
+    imageUrl: stockPortraitUrl("qb-collab-e"),
+    initials: "OE",
+    access: "viewer",
+    roles: ["Role 3"],
+  },
+]

package/template/lib/mock/{question-bank-inspector.ts → library-inspector.ts}

@@ -1,39 +1,39 @@
 /**
- * Derived labels for the question bank inspector (mock — replace with API fields).
+ * Derived labels for the library 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"
+import type { LibraryLevel, LibraryItem, LibraryItemType } from "@/lib/mock/library"
+import type { LibraryFolder } from "@/lib/mock/library-folders"
+import { collectFolderDescendantIds } from "@/lib/mock/library-folders"
 
-export const QUESTION_TYPE_ABBREV: Record<QuestionBankType, string> = {
-  multiple_choice: "MCQ",
-  true_false: "T/F",
-  short_answer: "Short answer",
+export const QUESTION_TYPE_ABBREV: Record<LibraryItemType, string> = {
+  multiple_choice: "Choice",
+  true_false: "Toggle",
+  short_answer: "Short text",
 }
 
-export function deriveQuestionItemCode(q: QuestionBankItem): string {
+export function deriveQuestionItemCode(q: LibraryItem): string {
   const raw = q.itemCode?.trim()
   if (raw) return raw
   return q.questionId
 }
 
-export function deriveBloomLevel(q: QuestionBankItem): string {
+export function deriveBloomLevel(q: LibraryItem): string {
   if (q.bloomLevel && String(q.bloomLevel).trim()) return String(q.bloomLevel)
   switch (q.difficulty) {
     case "easy":
-      return "Remember"
+      return "Tier 1"
     case "medium":
-      return "Apply"
+      return "Tier 2"
     case "hard":
-      return "Analyze"
+      return "Tier 3"
     default:
-      return "Apply"
+      return "Tier 2"
   }
 }
 
 /** Relative “last edited” clause when `lastEditedSummary` is absent. */
-export function deriveLastEditedLine(q: QuestionBankItem): string {
+export function deriveLastEditedLine(q: LibraryItem): string {
   if (q.lastEditedSummary?.trim()) return q.lastEditedSummary.trim()
   const editor = q.lastEditedBy ?? q.author
   const d = new Date(q.updatedAt)
@@ -48,41 +48,41 @@ export function deriveLastEditedLine(q: QuestionBankItem): string {
   return `${years} year${years === 1 ? "" : "s"} ago · ${editor}`
 }
 
-export function deriveTags(q: QuestionBankItem): string[] {
+export function deriveTags(q: LibraryItem): string[] {
   if (q.tags && q.tags.length > 0) return q.tags
   return [q.topic].filter(Boolean)
 }
 
-/** Bloom taxonomy row order for folder aggregate charts. */
+/** Tier row order for folder aggregate charts. */
 export const BLOOM_LEVEL_ORDER = [
-  "Remember",
-  "Understand",
-  "Apply",
-  "Analyze",
-  "Evaluate",
-  "Create",
+  "Tier 1",
+  "Tier 2",
+  "Tier 3",
+  "Tier 4",
+  "Tier 5",
+  "Tier 6",
 ] as const
 
 export function questionsInFolderSubtree(
-  folders: QuestionBankFolder[],
-  questions: QuestionBankItem[],
+  folders: LibraryFolder[],
+  questions: LibraryItem[],
   folderId: string,
-): QuestionBankItem[] {
+): LibraryItem[] {
   const scope = collectFolderDescendantIds(folders, folderId)
   return questions.filter(q => scope.has(q.folderId))
 }
 
 export interface FolderQuestionAggregate {
   totalQuestions: number
-  difficulty: Record<QuestionBankDifficulty, number>
+  difficulty: Record<LibraryLevel, 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> = {
+export function aggregateFolderQuestions(rows: LibraryItem[]): FolderQuestionAggregate {
+  const difficulty: Record<LibraryLevel, number> = {
     easy: 0,
     medium: 0,
     hard: 0,

package/template/lib/mock/{question-bank-kpi.ts → library-kpi.ts}

@@ -1,16 +1,16 @@
 import type { MetricInsight, MetricItem } from "@/components/key-metrics"
-import type { QuestionBankItem, QuestionBankType } from "@/lib/mock/question-bank"
+import type { LibraryItem, LibraryItemType } from "@/lib/mock/library"
 
-/** Point-biserial below this mock threshold counts as a psychometric review flag. */
+/** Quality score below this mock threshold counts as a 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",
+const TYPE_LABEL: Record<LibraryItemType, string> = {
+  multiple_choice: "Type 1",
+  true_false: "Type 2",
+  short_answer: "Type 3",
 }
 
-export function questionBankKpiMetrics(rows: QuestionBankItem[]): MetricItem[] {
+export function libraryKpiMetrics(rows: LibraryItem[]): MetricItem[] {
   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
@@ -20,9 +20,9 @@ export function questionBankKpiMetrics(rows: QuestionBankItem[]): MetricItem[] {
   return [
     {
       id: "total",
-      label: "Total questions",
+      label: "Total items",
       value: rows.length,
-      delta: "—",
+      delta: "",
       trend: "neutral",
       href: "#",
       metricVariant: "hero",
@@ -31,23 +31,23 @@ export function questionBankKpiMetrics(rows: QuestionBankItem[]): MetricItem[] {
       id: "mcq",
       label: TYPE_LABEL.multiple_choice,
       value: mcq,
-      delta: "—",
+      delta: "",
       trend: "neutral",
       href: "#",
     },
     {
       id: "written",
-      label: "True / false & short answer",
+      label: "Type 2 & 3",
       value: writtenTypes,
-      delta: "—",
+      delta: "",
       trend: "neutral",
       href: "#",
     },
     {
       id: "pbi-flags",
-      label: "Low PBI (review)",
+      label: "Review flags",
       value: lowPbiFlags,
-      delta: lowPbiFlags >= 2 ? "+1" : "—",
+      delta: lowPbiFlags >= 2 ? "+1" : "",
       trend: lowPbiFlags >= 2 ? "up" : "neutral",
       trendPolarity: "lower_is_better",
       href: "#",
@@ -55,18 +55,18 @@ export function questionBankKpiMetrics(rows: QuestionBankItem[]): MetricItem[] {
   ]
 }
 
-export function questionBankKpiInsight(rows: QuestionBankItem[]): MetricInsight {
+export function libraryKpiInsight(rows: LibraryItem[]): MetricInsight {
   const hard = rows.filter(r => r.difficulty === "hard").length
   const topics = new Set(rows.map(r => r.topic)).size
   return {
-    title: "Folder library",
+    title: "Library snapshot",
     description:
       rows.length === 0
-        ? "Add questions to populate metrics and charts."
+        ? "Add items 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",
+          ? `${hard} high-level items in this view — balance with lower-level items where helpful.`
+          : `${rows.length} item${rows.length === 1 ? "" : "s"} across ${topics} categor${topics === 1 ? "y" : "ies"} in the filtered set.`,
+    href: "/library/all",
     severity: hard > 3 ? "warning" : "info",
     actionLabel: "Ask Leo",
   }

package/template/lib/mock/library.ts

@@ -0,0 +1,249 @@
+/**
+ * Mock library items — replace with API in production.
+ */
+
+export type LibraryItemType = "multiple_choice" | "true_false" | "short_answer"
+export type LibraryLevel = "easy" | "medium" | "hard"
+
+/** Tier label for inspector / analytics (optional on mock rows). */
+export type LibraryTierLevel =
+  | "Tier 1"
+  | "Tier 2"
+  | "Tier 3"
+  | "Tier 4"
+  | "Tier 5"
+  | "Tier 6"
+
+export interface LibraryItem extends Record<string, unknown> {
+  id: string
+  /** Stable human-facing identifier (catalog, search, citations). */
+  questionId: string
+  /** Short preview / stem */
+  stem: string
+  topic: string
+  type: LibraryItemType
+  difficulty: LibraryLevel
+  author: string
+  /** Work email for the primary author (demo; optional when API omits). */
+  authorEmail?: string
+  updatedAt: string
+  /** Folder tree id (`lib/mock/library-folders.ts`). */
+  folderId: string
+  /** Multiple choice options (only for type: "multiple_choice") */
+  options?: {
+    text: string
+    isCorrect?: boolean
+  }[]
+  /** Stable bank code for lists / inspector (e.g. PH-ANA-001). */
+  itemCode?: string
+  bloomLevel?: LibraryTierLevel | string
+  /** Topic-style tags for inspector (# displayed in UI). */
+  tags?: string[]
+  /** ISO-ish created date (inspector “Creator & history”). */
+  createdAt?: string
+  /** Display name for “Created by” when different from `author`. */
+  createdBy?: string
+  /** Last editor display name (inspector copy). */
+  lastEditedBy?: string
+  /** Precomposed “Last edited” line; overrides derived copy when set. */
+  lastEditedSummary?: string
+  /** Revision label e.g. v4 */
+  version?: string
+  examUsageCount?: number
+  /** Point-biserial index (psychometrics preview). */
+  pbi?: number
+  /** Mean percent correct when used in assessments. */
+  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 newLibraryQuestionId(): string {
+  return `LIB-NEW-${Date.now().toString(36).toUpperCase()}`
+}
+
+export const LIBRARY_ITEMS: LibraryItem[] = [
+  {
+    id: "q1",
+    questionId: "LIB-2026-001",
+    stem: "Item 01 — sample primary entry for the demo dataset.",
+    topic: "Category 1",
+    type: "multiple_choice",
+    difficulty: "medium",
+    author: "Owner A",
+    authorEmail: "owner.a@demo.exxat.io",
+    updatedAt: "2026-03-28",
+    folderId: "fld-favorites",
+    itemCode: "LIB-2026-001",
+    bloomLevel: "Tier 2",
+    tags: ["Tag 1", "Tag 2", "Tag 3"],
+    createdAt: "2024-11-02",
+    createdBy: "Owner B",
+    lastEditedBy: "Owner C",
+    lastEditedSummary: "14 months ago · Owner C",
+    version: "v4",
+    examUsageCount: 22,
+    pbi: 0.48,
+    avgScoreCorrectPct: 88,
+    lastUsedLabel: "Reference set · 14 months ago",
+    options: [
+      { text: "Option A", isCorrect: true },
+      { text: "Option B", isCorrect: false },
+      { text: "Option C", isCorrect: false },
+      { text: "Option D", isCorrect: false },
+    ],
+  },
+  {
+    id: "q2",
+    questionId: "LIB-2026-002",
+    stem: "Item 02 — sample entry with a single inline action.",
+    topic: "Category 2",
+    type: "true_false",
+    difficulty: "easy",
+    author: "Owner B",
+    authorEmail: "owner.b@demo.exxat.io",
+    updatedAt: "2026-03-27",
+    folderId: "fld-skills-lab",
+    isStarred: true,
+    pbi: 0.55,
+  },
+  {
+    id: "q3",
+    questionId: "LIB-2026-003",
+    stem: "Item 03 — short prompt entry for the catalog demo.",
+    topic: "Category 3",
+    type: "short_answer",
+    difficulty: "hard",
+    author: "Owner C",
+    authorEmail: "owner.c@demo.exxat.io",
+    updatedAt: "2026-03-26",
+    folderId: "fld-science",
+    isStarred: true,
+    pbi: 0.14,
+  },
+  {
+    id: "q4",
+    questionId: "LIB-2026-004",
+    stem: "Item 04 — multi-option entry showing the picker pattern.",
+    topic: "Category 4",
+    type: "multiple_choice",
+    difficulty: "medium",
+    author: "Owner D",
+    authorEmail: "owner.d@demo.exxat.io",
+    updatedAt: "2026-03-25",
+    folderId: "fld-ethics",
+    isStarred: true,
+    pbi: 0.19,
+    options: [
+      { text: "Option A", isCorrect: true },
+      { text: "Option B", isCorrect: false },
+      { text: "Option C", isCorrect: false },
+      { text: "Option D", isCorrect: false },
+    ],
+  },
+  {
+    id: "q5",
+    questionId: "LIB-2026-005",
+    stem: "Item 05 — short-answer entry pinned to the Favorites folder.",
+    topic: "Category 1",
+    type: "short_answer",
+    difficulty: "easy",
+    author: "Owner A",
+    authorEmail: "owner.a@demo.exxat.io",
+    updatedAt: "2026-03-24",
+    folderId: "fld-favorites",
+  },
+  {
+    id: "q6",
+    questionId: "LIB-2026-006",
+    stem: "Item 06 — choice-list entry for the catalog demo.",
+    topic: "Category 3",
+    type: "multiple_choice",
+    difficulty: "medium",
+    author: "Owner E",
+    authorEmail: "owner.e@demo.exxat.io",
+    updatedAt: "2026-03-23",
+    folderId: "fld-ops",
+    options: [
+      { text: "Option A", isCorrect: true },
+      { text: "Option B", isCorrect: false },
+      { text: "Option C", isCorrect: false },
+      { text: "Option D", isCorrect: false },
+    ],
+  },
+  {
+    id: "q7",
+    questionId: "LIB-2026-007",
+    stem: "Item 07 — boolean entry to show toggle-style answers.",
+    topic: "Category 2",
+    type: "true_false",
+    difficulty: "easy",
+    author: "Owner B",
+    authorEmail: "owner.b@demo.exxat.io",
+    updatedAt: "2026-03-22",
+    folderId: "fld-clinical",
+  },
+  {
+    id: "q8",
+    questionId: "LIB-2026-008",
+    stem: "Item 08 — multi-option entry filed under Folder 2.",
+    topic: "Category 3",
+    type: "multiple_choice",
+    difficulty: "hard",
+    author: "Owner C",
+    authorEmail: "owner.c@demo.exxat.io",
+    updatedAt: "2026-03-21",
+    folderId: "fld-science",
+  },
+  {
+    id: "q9",
+    questionId: "LIB-2026-009",
+    stem: "Item 09 — quick true / false entry for the demo set.",
+    topic: "Category 4",
+    type: "true_false",
+    difficulty: "medium",
+    author: "Owner D",
+    authorEmail: "owner.d@demo.exxat.io",
+    updatedAt: "2026-03-20",
+    folderId: "fld-clinical",
+  },
+  {
+    id: "q10",
+    questionId: "LIB-2026-010",
+    stem: "Item 10 — short-answer entry from Owner A.",
+    topic: "Category 1",
+    type: "short_answer",
+    difficulty: "hard",
+    author: "Owner A",
+    authorEmail: "owner.a@demo.exxat.io",
+    updatedAt: "2026-03-19",
+    folderId: "fld-science",
+  },
+  {
+    id: "q11",
+    questionId: "LIB-2026-011",
+    stem: "Item 11 — true / false entry showing chip alignment.",
+    topic: "Category 2",
+    type: "true_false",
+    difficulty: "easy",
+    author: "Owner E",
+    authorEmail: "owner.e@demo.exxat.io",
+    updatedAt: "2026-03-18",
+    folderId: "fld-ops",
+  },
+  {
+    id: "q12",
+    questionId: "LIB-2026-012",
+    stem: "Item 12 — short-answer entry for the catalog demo.",
+    topic: "Category 3",
+    type: "short_answer",
+    difficulty: "medium",
+    author: "Owner B",
+    authorEmail: "owner.b@demo.exxat.io",
+    updatedAt: "2026-03-17",
+    folderId: "fld-ops",
+  },
+]