@exxatdesignux/ui 0.3.0 → 0.4.1

package/template/lib/command-menu-search-data.ts

@@ -1,48 +1,17 @@
 /**
  * Searchable ⌘K rows from mock/API data. Wire new sources here — not in `command-menu-config.ts`.
+ *
+ * In this demo app the global ⌘K palette ships with route + Ask Leo entries only.
+ * When a consumer adds a real data source (e.g. a Students hub), build a
+ * `CommandMenuGroup` here with `searchOnly: true` so the palette stays
+ * lightweight on open and the items only surface once the user types.
  */
 
-import type { CommandMenuGroup, CommandMenuItem } from "@/lib/command-menu-config"
-import { ALL_PLACEMENTS } from "@/lib/mock/placements"
+import type { CommandMenuGroup } from "@/lib/command-menu-config"
 
-function sampleRowSearchItems(): CommandMenuItem[] {
-  return ALL_PLACEMENTS.map((p) => {
-    const nameParts = p.student.trim().split(/\s+/)
-    return {
-      id: `sample-row-${p.id}`,
-      label: `Row ${p.id} — ${p.student}`,
-      icon: "fa-light fa-table",
-      href: `/data-list/${p.id}`,
-      keywords: [
-        `row ${p.id}`,
-        p.student,
-        ...nameParts,
-        p.program,
-        p.site,
-        p.internship,
-        p.specialization,
-        p.email,
-        p.supervisor,
-        p.status,
-        p.compliance,
-      ]
-        .filter(Boolean)
-        .join(" "),
-    }
-  })
-}
-
-/** Built once at module load — avoids remapping all placement rows on every layout render. */
-export const COMMAND_MENU_SEARCH_DATA_GROUPS: CommandMenuGroup[] = [
-  {
-    id: "sample-rows",
-    heading: "Demo rows",
-    items: sampleRowSearchItems(),
-    searchOnly: true,
-  },
-]
+/** Demo rows for hubs — none in this app. Real apps populate this from their primary entity. */
+export const COMMAND_MENU_SEARCH_DATA_GROUPS: CommandMenuGroup[] = []
 
-/** Demo rows for the list hub — search-only so the palette stays lightweight on open. */
 export function getCommandMenuSearchDataGroups(): CommandMenuGroup[] {
   return COMMAND_MENU_SEARCH_DATA_GROUPS
 }

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

@@ -1,19 +1,20 @@
 /**
- * Question bank authoring — health-science domain constants for `NewQuestionAuthoring`.
+ * Library authoring — generic demo constants for the new-item composer.
  *
- * Storage in `lib/mock/question-bank.ts` keeps the simple `QuestionBankType` enum
+ * Storage in `lib/mock/library.ts` keeps the simple `LibraryItemType` enum
  * (`multiple_choice` | `true_false` | `short_answer`). The authoring surface
- * exposes the richer item-writer model that health-science assessments rely on
- * (NBME / NCLEX / OSCE style) and maps back to that base enum on save.
+ * exposes a richer item-writer model and maps back to that base enum on save.
+ *
+ * All copy is intentionally generic so the demo applies to any product domain.
  */
 
-import type { QuestionBankType, QuestionBankBloomLevel } from "@/lib/mock/question-bank"
+import type { LibraryItemType, LibraryTierLevel } from "@/lib/mock/library"
 
 // ─────────────────────────────────────────────────────────────────────────────
-// Question type
+// Item type
 // ─────────────────────────────────────────────────────────────────────────────
 
-/** Authoring-time question type — richer than the storage enum. */
+/** Authoring-time item type — richer than the storage enum. */
 export type AuthoringQuestionType =
   | "mcq_single"
   | "mcq_multiple"
@@ -38,17 +39,17 @@ export interface AuthoringQuestionTypeOption {
   /** "Single best answer", "Multiple response", etc. — appears under the title. */
   badge?: string
   /** Maps to the storage type when persisting. */
-  storageType: QuestionBankType
+  storageType: LibraryItemType
 }
 
 export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] = [
   {
     value: "mcq_single",
-    label: "Multiple choice",
-    shortLabel: "Multiple choice",
+    label: "Single choice",
+    shortLabel: "Single choice",
     icon: "fa-list-radio",
     description:
-      "NBME-style. Stem describes a clinical scenario; pick the one best option. Default 5 distractors.",
+      "One correct answer from a set of options. Default 5 distractors.",
     tileSummary: "Single correct answer from a set of options",
     badge: "Single best answer",
     storageType: "multiple_choice",
@@ -59,7 +60,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Multi-select",
     icon: "fa-list-check",
     description:
-      "NCLEX-style. Learner selects every correct option from the list. Common for safety and prioritisation items.",
+      "Select every correct option from the list. Optional partial credit.",
     tileSummary: "One or more correct answers — partial credit",
     badge: "Multiple response",
     storageType: "multiple_choice",
@@ -70,7 +71,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "True / False",
     icon: "fa-circle-half-stroke",
     description:
-      "Use sparingly — best for unambiguous facts. Avoid for nuanced clinical judgment.",
+      "Use for simple, unambiguous statements.",
     tileSummary: "Binary statement — quick recall",
     storageType: "true_false",
   },
@@ -80,7 +81,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Short answer",
     icon: "fa-input-text",
     description:
-      "Free-text response with a model answer + acceptable variants. Good for definitions and one-line answers.",
+      "Free-text response with an expected answer + acceptable variants.",
     tileSummary: "Single word or short phrase, exact-match",
     storageType: "short_answer",
   },
@@ -90,7 +91,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Numeric",
     icon: "fa-input-numeric",
     description:
-      "Number-only response with optional units and a ± tolerance band. Auto-graded on submission.",
+      "Number-only response with optional units and a ± tolerance band.",
     tileSummary: "Number with units and tolerance band",
     badge: "Auto-graded",
     storageType: "short_answer",
@@ -101,7 +102,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Essay",
     icon: "fa-paragraph",
     description:
-      "Long-form response graded against a rubric. Use for clinical reasoning and care-plan items.",
+      "Long-form response graded against a rubric.",
     tileSummary: "Long response — rubric-graded",
     badge: "Rubric",
     storageType: "short_answer",
@@ -112,7 +113,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Fill in the blank",
     icon: "fa-text-size",
     description:
-      "Sentence with one or more {{blanks}}; learners type the missing word(s). List accepted answers per blank.",
+      "Sentence with one or more {{blanks}}; respondents type the missing word(s).",
     tileSummary: "Sentence with one or more blanks to fill",
     storageType: "short_answer",
   },
@@ -123,7 +124,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     icon: "fa-arrow-right-arrow-left",
     description:
       "Two columns — pair each prompt on the left to its correct match on the right.",
-    tileSummary: "Pair terms on the left to definitions on the right",
+    tileSummary: "Pair entries on the left to entries on the right",
     storageType: "multiple_choice",
   },
   {
@@ -132,7 +133,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Ordering",
     icon: "fa-list-ol",
     description:
-      "Show the steps; the learner re-orders them into the correct sequence (e.g. ACLS algorithm steps).",
+      "Show steps; respondents re-order them into the correct sequence.",
     tileSummary: "Place items in the correct sequence",
     storageType: "multiple_choice",
   },
@@ -142,7 +143,7 @@ export const AUTHORING_QUESTION_TYPES: readonly AuthoringQuestionTypeOption[] =
     shortLabel: "Hotspot",
     icon: "fa-bullseye-pointer",
     description:
-      "Image-based item — learner clicks the correct region (e.g. anatomy, x-ray, ECG).",
+      "Image-based item — respondents click the correct region.",
     tileSummary: "Click the correct region of an image",
     badge: "Image-based",
     storageType: "multiple_choice",
@@ -154,87 +155,87 @@ export function authoringQuestionType(value: AuthoringQuestionType): AuthoringQu
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
-// Difficulty + Bloom + cognitive level (NBME)
+// Level + tier + cognitive level
 // ─────────────────────────────────────────────────────────────────────────────
 
 export const AUTHORING_DIFFICULTY_OPTIONS = [
-  { value: "easy", label: "Easy", description: "Recall · expected ≥ 80% correct" },
-  { value: "medium", label: "Medium", description: "Application · 50–80% correct" },
-  { value: "hard", label: "Hard", description: "Analysis · ≤ 50% correct" },
+  { value: "easy", label: "Low", description: "Quick recall — most respondents complete" },
+  { value: "medium", label: "Normal", description: "Standard application — mixed completion" },
+  { value: "hard", label: "High", description: "Deeper analysis — fewer respondents complete" },
 ] as const
 
-export const AUTHORING_BLOOM_OPTIONS: readonly { value: QuestionBankBloomLevel; label: string; hint: string }[] = [
-  { value: "Remember", label: "Remember", hint: "Recall facts, terms, basic concepts" },
-  { value: "Understand", label: "Understand", hint: "Explain, summarise, classify" },
-  { value: "Apply", label: "Apply", hint: "Use knowledge in a new situation" },
-  { value: "Analyze", label: "Analyze", hint: "Break information apart, examine relationships" },
-  { value: "Evaluate", label: "Evaluate", hint: "Justify a stand, defend a decision" },
-  { value: "Create", label: "Create", hint: "Produce new or original work" },
+export const AUTHORING_BLOOM_OPTIONS: readonly { value: LibraryTierLevel; label: string; hint: string }[] = [
+  { value: "Tier 1", label: "Tier 1", hint: "Recall basic facts" },
+  { value: "Tier 2", label: "Tier 2", hint: "Explain, summarise, classify" },
+  { value: "Tier 3", label: "Tier 3", hint: "Use knowledge in a new situation" },
+  { value: "Tier 4", label: "Tier 4", hint: "Break information apart, examine relationships" },
+  { value: "Tier 5", label: "Tier 5", hint: "Justify a stand, defend a decision" },
+  { value: "Tier 6", label: "Tier 6", hint: "Produce new or original work" },
 ] as const
 
-/** NBME-aligned cognitive level — separate from Bloom (broader). */
+/** Cognitive level — broader bucketing for analytics. */
 export const AUTHORING_COG_LEVEL_OPTIONS = [
-  { value: "recall", label: "Recall", hint: "Definitions, mechanisms, anatomy" },
-  { value: "application", label: "Application", hint: "Apply concept to a new patient scenario" },
-  { value: "analysis", label: "Analysis", hint: "Compare, evaluate, synthesise findings" },
+  { value: "recall", label: "Recall", hint: "Definitions and core concepts" },
+  { value: "application", label: "Application", hint: "Apply concept to a new scenario" },
+  { value: "analysis", label: "Analysis", hint: "Compare, evaluate, synthesise" },
 ] as const
 export type AuthoringCogLevel = typeof AUTHORING_COG_LEVEL_OPTIONS[number]["value"]
 
 // ─────────────────────────────────────────────────────────────────────────────
-// Subject area / body system / discipline / phase
+// Category / subject / track / phase
 // ─────────────────────────────────────────────────────────────────────────────
 
 export const AUTHORING_SUBJECT_AREAS = [
-  "Anatomy",
-  "Physiology",
-  "Pathology",
-  "Pharmacology",
-  "Microbiology & immunology",
-  "Behavioral science",
-  "Biochemistry & genetics",
-  "Public health & epidemiology",
-  "Clinical skills",
-  "Communication & ethics",
+  "Category 1",
+  "Category 2",
+  "Category 3",
+  "Category 4",
+  "Category 5",
+  "Category 6",
+  "Category 7",
+  "Category 8",
+  "Category 9",
+  "Category 10",
 ] as const
 export type AuthoringSubjectArea = typeof AUTHORING_SUBJECT_AREAS[number]
 
 export const AUTHORING_BODY_SYSTEMS = [
-  { value: "cardiovascular", label: "Cardiovascular", icon: "fa-heart-pulse" },
-  { value: "respiratory", label: "Respiratory", icon: "fa-lungs" },
-  { value: "renal", label: "Renal & urinary", icon: "fa-droplet" },
-  { value: "gastrointestinal", label: "Gastrointestinal", icon: "fa-stomach" },
-  { value: "endocrine", label: "Endocrine", icon: "fa-flask" },
-  { value: "musculoskeletal", label: "Musculoskeletal", icon: "fa-bone" },
-  { value: "nervous", label: "Nervous", icon: "fa-brain" },
-  { value: "reproductive", label: "Reproductive", icon: "fa-venus-mars" },
-  { value: "hematologic", label: "Hematologic & oncologic", icon: "fa-vial" },
-  { value: "immune", label: "Immune", icon: "fa-shield-virus" },
-  { value: "skin", label: "Skin & subcutaneous", icon: "fa-hand-dots" },
-  { value: "behavioral_psych", label: "Behavioral / psych", icon: "fa-comments" },
-  { value: "multisystem", label: "Multisystem", icon: "fa-circle-nodes" },
+  { value: "topic-a", label: "Topic A", icon: "fa-circle" },
+  { value: "topic-b", label: "Topic B", icon: "fa-circle" },
+  { value: "topic-c", label: "Topic C", icon: "fa-circle" },
+  { value: "topic-d", label: "Topic D", icon: "fa-circle" },
+  { value: "topic-e", label: "Topic E", icon: "fa-circle" },
+  { value: "topic-f", label: "Topic F", icon: "fa-circle" },
+  { value: "topic-g", label: "Topic G", icon: "fa-circle" },
+  { value: "topic-h", label: "Topic H", icon: "fa-circle" },
+  { value: "topic-i", label: "Topic I", icon: "fa-circle" },
+  { value: "topic-j", label: "Topic J", icon: "fa-circle" },
+  { value: "topic-k", label: "Topic K", icon: "fa-circle" },
+  { value: "topic-l", label: "Topic L", icon: "fa-circle" },
+  { value: "topic-multi", label: "Multi-topic", icon: "fa-circle-nodes" },
 ] as const
 export type AuthoringBodySystem = typeof AUTHORING_BODY_SYSTEMS[number]["value"]
 
 export const AUTHORING_DISCIPLINES = [
-  "Medicine (MD / DO)",
-  "Nursing (BSN / MSN)",
-  "Pharmacy (PharmD)",
-  "Dental (DMD / DDS)",
-  "Physical therapy (DPT)",
-  "Occupational therapy",
-  "Physician assistant",
-  "Respiratory therapy",
-  "Medical lab science",
-  "Radiologic sciences",
-  "Public health (MPH)",
+  "Track 1",
+  "Track 2",
+  "Track 3",
+  "Track 4",
+  "Track 5",
+  "Track 6",
+  "Track 7",
+  "Track 8",
+  "Track 9",
+  "Track 10",
+  "Track 11",
 ] as const
 export type AuthoringDiscipline = typeof AUTHORING_DISCIPLINES[number]
 
 export const AUTHORING_PHASES = [
-  { value: "preclinical", label: "Pre-clinical", hint: "Foundational sciences" },
-  { value: "clinical", label: "Clinical", hint: "Clerkships / practicum" },
-  { value: "residency", label: "Residency / fellowship", hint: "Post-graduate training" },
-  { value: "ce", label: "Continuing education", hint: "Practising clinicians" },
+  { value: "preclinical", label: "Phase 1", hint: "Early stage" },
+  { value: "clinical", label: "Phase 2", hint: "Practice stage" },
+  { value: "residency", label: "Phase 3", hint: "Advanced stage" },
+  { value: "ce", label: "Phase 4", hint: "Ongoing stage" },
 ] as const
 export type AuthoringPhase = typeof AUTHORING_PHASES[number]["value"]
 
@@ -248,31 +249,31 @@ export const AUTHORING_STATUS_OPTIONS: readonly { value: AuthoringStatus; label:
   {
     value: "draft",
     label: "Draft",
-    description: "Visible only to authors. Not eligible for assessments.",
+    description: "Visible only to owners. Not eligible for use.",
     icon: "fa-file-pen",
   },
   {
     value: "in_review",
     label: "In review",
-    description: "Awaiting subject-matter expert peer review.",
+    description: "Awaiting peer review.",
     icon: "fa-magnifying-glass",
   },
   {
     value: "approved",
     label: "Approved",
-    description: "SME signed off. Ready to publish to the live bank.",
+    description: "Reviewer signed off. Ready to publish.",
     icon: "fa-circle-check",
   },
   {
     value: "published",
     label: "Published",
-    description: "Live in the bank. Available for exam / quiz selection.",
+    description: "Live in the library. Available for use.",
     icon: "fa-broadcast-tower",
   },
   {
     value: "retired",
     label: "Retired",
-    description: "Removed from active use. Kept for audit and reuse history.",
+    description: "Removed from active use. Kept for history.",
     icon: "fa-box-archive",
   },
 ] as const
@@ -285,24 +286,24 @@ export const AUTHORING_DEFAULT_OPTION_COUNT = 5
 export const AUTHORING_MIN_OPTION_COUNT = 2
 export const AUTHORING_MAX_OPTION_COUNT = 8
 
-/** Stem placeholder — modelled on a typical NBME / clerkship vignette. */
-export const AUTHORING_STEM_PLACEHOLDER = `A 58-year-old man presents to the emergency department with substernal chest pressure that began two hours ago while mowing the lawn. The pain radiates to the left jaw and is associated with diaphoresis and nausea. Past medical history is significant for hypertension and type 2 diabetes mellitus. Vital signs show blood pressure 158/92 mm Hg, heart rate 102/min, respirations 20/min. Physical examination is notable for an S4 gallop. ECG shows 2 mm ST-segment elevation in leads II, III, and aVF.`
+/** Name placeholder — generic primary line for the demo composer. */
+export const AUTHORING_STEM_PLACEHOLDER = `Item 13 — sample primary line for a new library entry. Describe the item in one or two sentences so respondents understand the prompt without needing extra context. Use placeholder content that demonstrates the layout without committing to a specific product domain.`
 
 export const AUTHORING_LEAD_IN_PLACEHOLDER =
-  "Which of the following is the most likely diagnosis?"
+  "Which option fits best?"
 
-/** Best-practice rationale prompt — author-side, not student-facing. */
+/** Best-practice notes prompt — owner-side, not respondent-facing. */
 export const AUTHORING_RATIONALE_PLACEHOLDER =
-  "Explain why this option is correct (or why this distractor is plausible). Cite mechanism, guideline, or reference where possible."
+  "Explain why this option is correct (or why this distractor is plausible). Cite the source or reference where possible."
 
 /**
- * Draft question handle assigned when the composer route loads.
- * Format: `Q-YYMM-XXXX` (e.g. `Q-2605-A3F2`). Generate on the server and pass
- * into `NewQuestionComposer` so SSR and hydration share one value.
+ * Draft item handle assigned when the composer route loads.
+ * Format: `LIB-YYMM-XXXX` (e.g. `LIB-2605-A3F2`). Generate on the server and pass
+ * into the composer so SSR and hydration share one value.
  */
 export function generateDraftQuestionId(now = new Date()): string {
   const yy = String(now.getFullYear()).slice(-2)
   const mm = String(now.getMonth() + 1).padStart(2, "0")
   const rand = Math.random().toString(16).slice(2, 6).toUpperCase().padEnd(4, "0")
-  return `Q-${yy}${mm}-${rand}`
+  return `LIB-${yy}${mm}-${rand}`
 }

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

@@ -0,0 +1,19 @@
+import { patchLibraryUrlSearchParams } from "@/lib/library-nav"
+
+/** Rotating example queries for dedicated search composers on list/find surfaces. */
+export const LIBRARY_DEDICATED_SEARCH_PLACEHOLDERS = [
+  "items tagged with Tag 1 and Category 2",
+  "everything Owner A edited this month",
+  "Folder 1 entries marked High",
+  "find LIB-2026-001 and anything like it",
+  "drafts from the most recent reference set",
+  "Type 1 items I still need for the demo block",
+] as const
+
+export function patchLibraryDedicatedSearchParams(
+  current: URLSearchParams,
+  submittedText: string,
+): URLSearchParams {
+  const t = submittedText.trim()
+  return patchLibraryUrlSearchParams(current, { q: t || null })
+}

package/template/lib/library-hub-search.ts

@@ -0,0 +1,90 @@
+import type { DiscoveryHubSearchGroup } from "@/lib/discovery-hub"
+import {
+  LIBRARY_ENTRY_PATH,
+  LIBRARY_ALL_PATH,
+} from "@/lib/library-nav"
+
+export type { DiscoveryHubSearchGroup, DiscoveryHubSearchItem } from "@/lib/discovery-hub"
+
+export function buildLibraryHubSearchGroups(): DiscoveryHubSearchGroup[] {
+  return [
+    {
+      id: "ai-create",
+      heading: "Create with AI",
+      items: [
+        {
+          id: "ai-mcq",
+          label: "Draft a choice-style item from a prompt",
+          keywords: "ai leo create item choice prompt",
+          askLeoPrompt:
+            "Help me draft a new choice-style library item. Ask clarifying questions about category, level, and intent before proposing a name and options.",
+        },
+        {
+          id: "ai-osce",
+          label: "Generate a checklist from a sample scenario",
+          keywords: "ai leo checklist scenario",
+          askLeoPrompt:
+            "I want to generate a checklist from a sample scenario. Walk me through the scenario details you need, then propose observable steps and scoring notes.",
+        },
+        {
+          id: "ai-remediation",
+          label: "Turn flagged items into follow-up entries",
+          keywords: "ai leo follow-up review flagged items",
+          askLeoPrompt:
+            "Turn a list of flagged items into follow-up library entries. Ask what category and level to target, then suggest short-text or choice-style follow-ups.",
+        },
+        {
+          id: "ai-bank-outline",
+          label: "Outline a new library section",
+          keywords: "ai leo outline library section folders",
+          askLeoPrompt:
+            "Help me outline a new library section. Suggest folder structure, item types, and a balanced mix of levels before we add items.",
+        },
+      ],
+    },
+    {
+      id: "actions",
+      heading: "Quick actions",
+      items: [
+        {
+          id: "browse-library",
+          label: "Browse the library",
+          keywords: "library table folder panel tree views",
+          icon: "fa-light fa-table-list",
+          href: LIBRARY_ALL_PATH,
+        },
+        {
+          id: "browse-my",
+          label: "Open my items",
+          keywords: "my items owner scope",
+          icon: "fa-light fa-user",
+          href: `${LIBRARY_ALL_PATH}?scope=my`,
+        },
+        {
+          id: "new-question",
+          label: "Create new item",
+          keywords: "new item create draft owner",
+          icon: "fa-light fa-plus",
+          askLeoPrompt:
+            "Help me create a new library item. Start by asking for category, item type, level, and intent, then draft the name, options, and notes.",
+        },
+        {
+          id: "hub-entry",
+          label: "Library home",
+          keywords: "home hub search",
+          icon: "fa-light fa-house",
+          href: LIBRARY_ENTRY_PATH,
+        },
+      ],
+    },
+  ]
+}
+
+export const LIBRARY_HUB_SEARCH_PLACEHOLDER =
+  "Search items, folders, or describe what you want to create…"
+
+export const LIBRARY_HUB_ASK_LEO_PROMPTS = [
+  "Draft five choice-style items for Category 1",
+  "Suggest folder names for a new library section",
+  "Rewrite this name for clarity",
+] as const