@exxatdesignux/ui 0.2.19 → 0.4.0

package/template/components/templates/page-loading-shell.tsx

@@ -1,262 +0,0 @@
-import * as React from "react"
-
-import { Skeleton } from "@/components/ui/skeleton"
-import { SidebarInset } from "@/components/ui/sidebar"
-import {
-  FOCUSED_WORKFLOW_CONTENT_PADDING_CLASS,
-  FOCUSED_WORKFLOW_MAX_WIDTH,
-} from "@/components/templates/focused-workflow-page-template"
-import { FOCUSED_WORKFLOW_SIDEBAR_SECTIONS_GRID_CLASS } from "@/components/templates/focused-workflow-layouts"
-import { PRIMARY_PAGE_MAX_WIDTH_CLASS } from "@/components/templates/primary-page-template"
-import type { PageLoadingVariant } from "@/lib/page-loading-variant"
-import { cn } from "@/lib/utils"
-
-/** Breadcrumb bar placeholder — matches `SiteHeader` footprint without client hooks. */
-function SiteHeaderSkeleton() {
-  return (
-    <div className="sticky top-0 z-30 bg-transparent">
-      <header
-        role="presentation"
-        className="flex h-(--header-height) shrink-0 items-center gap-2 rounded-t-xl bg-background ps-4 pe-2 lg:gap-2 lg:ps-6 lg:pe-2"
-      >
-        <Skeleton className="size-8 shrink-0 rounded-md" />
-        <Skeleton className="h-4 w-36 max-w-[50vw] rounded-md" />
-        <div className="ms-auto flex items-center gap-2">
-          <Skeleton className="h-8 w-16 rounded-md" />
-          <Skeleton className="size-8 rounded-md" />
-        </div>
-      </header>
-    </div>
-  )
-}
-
-interface PageLoadingChromeProps {
-  children: React.ReactNode
-  maxWidthClassName?: string
-  contentClassName?: string
-  paddingClassName?: string
-}
-
-function PageLoadingChrome({
-  children,
-  maxWidthClassName = PRIMARY_PAGE_MAX_WIDTH_CLASS,
-  contentClassName,
-  paddingClassName = "px-4 pt-2 pb-32 sm:px-6 lg:px-8",
-}: PageLoadingChromeProps) {
-  return (
-    <SidebarInset id="main-content" tabIndex={-1} aria-busy="true" aria-label="Loading page">
-      <SiteHeaderSkeleton />
-      <div className="flex min-h-0 flex-1 flex-col outline-none">
-        <div
-          className={cn(
-            "@container/main mx-auto flex min-h-0 w-full min-w-0 flex-1 flex-col",
-            maxWidthClassName,
-            paddingClassName,
-            contentClassName,
-          )}
-        >
-          {children}
-        </div>
-      </div>
-    </SidebarInset>
-  )
-}
-
-/** List hub — header, KPI band, toolbar, table rows. */
-export function PrimaryListHubLoadingBody() {
-  return (
-    <div className="flex flex-col gap-6">
-      <div className="flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between">
-        <div className="space-y-2">
-          <Skeleton className="h-9 w-56 max-w-full rounded-md" />
-          <Skeleton className="h-4 w-72 max-w-full rounded-md" />
-        </div>
-        <div className="flex shrink-0 gap-2">
-          <Skeleton className="h-9 w-28 rounded-md" />
-          <Skeleton className="h-9 w-9 rounded-md" />
-        </div>
-      </div>
-      <div className="grid grid-cols-2 gap-px overflow-hidden rounded-xl border border-border bg-border sm:grid-cols-4">
-        {Array.from({ length: 4 }).map((_, i) => (
-          <Skeleton key={i} className="h-[4.75rem] rounded-none bg-card" />
-        ))}
-      </div>
-      <div className="flex flex-wrap items-center gap-2">
-        <Skeleton className="h-9 min-w-[12rem] flex-1 rounded-md sm:max-w-xs" />
-        <Skeleton className="h-9 w-24 rounded-md" />
-        <Skeleton className="h-9 w-9 rounded-md" />
-      </div>
-      <div className="space-y-2 rounded-xl border border-border bg-card p-2">
-        <Skeleton className="h-10 w-full rounded-md" />
-        {Array.from({ length: 8 }).map((_, i) => (
-          <Skeleton key={i} className="h-11 w-full rounded-md" />
-        ))}
-      </div>
-    </div>
-  )
-}
-
-export function PrimaryListHubLoadingFallback() {
-  return (
-    <PageLoadingChrome>
-      <PrimaryListHubLoadingBody />
-    </PageLoadingChrome>
-  )
-}
-
-/** Question bank discovery hub — composer + folder grid. */
-export function QuestionBankHubLoadingBody() {
-  return (
-    <div className="flex flex-col gap-10">
-      <div className="mx-auto flex w-full max-w-3xl flex-col gap-4 py-6">
-        <Skeleton className="mx-auto h-10 w-64 max-w-full rounded-md" />
-        <Skeleton className="h-12 w-full rounded-xl" />
-        <Skeleton className="h-4 w-48 rounded-md" />
-      </div>
-      <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3">
-        {Array.from({ length: 6 }).map((_, i) => (
-          <Skeleton key={i} className="h-28 rounded-xl" />
-        ))}
-      </div>
-    </div>
-  )
-}
-
-export function QuestionBankHubLoadingFallback() {
-  return (
-    <PageLoadingChrome>
-      <QuestionBankHubLoadingBody />
-    </PageLoadingChrome>
-  )
-}
-
-/** Dedicated search landing / results (`?q=`). */
-export function DedicatedSearchLoadingBody() {
-  return (
-    <div className="mx-auto flex min-h-[min(52vh,28rem)] w-full max-w-3xl flex-col justify-center gap-6 py-10">
-      <Skeleton className="h-10 w-72 max-w-full rounded-md" />
-      <Skeleton className="h-12 w-full rounded-xl" />
-      <div className="flex flex-wrap gap-2">
-        <Skeleton className="h-8 w-24 rounded-full" />
-        <Skeleton className="h-8 w-32 rounded-full" />
-        <Skeleton className="h-8 w-20 rounded-full" />
-      </div>
-    </div>
-  )
-}
-
-export function DedicatedSearchLoadingFallback() {
-  return (
-    <PageLoadingChrome maxWidthClassName="max-w-5xl">
-      <DedicatedSearchLoadingBody />
-    </PageLoadingChrome>
-  )
-}
-
-/** Dashboard tabs — KPI row + chart block. */
-export function DashboardLoadingBody() {
-  return (
-    <div className="flex flex-col gap-6">
-      <div className="space-y-2">
-        <Skeleton className="h-9 w-56 max-w-full rounded-md" />
-        <Skeleton className="h-4 w-80 max-w-full rounded-md" />
-      </div>
-      <Skeleton className="h-11 w-full max-w-xl rounded-md" />
-      <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-4">
-        {Array.from({ length: 4 }).map((_, i) => (
-          <Skeleton key={i} className="h-24 rounded-xl" />
-        ))}
-      </div>
-      <Skeleton className="min-h-[320px] w-full rounded-xl" />
-    </div>
-  )
-}
-
-export function DashboardLoadingFallback() {
-  return (
-    <PageLoadingChrome maxWidthClassName={PRIMARY_PAGE_MAX_WIDTH_CLASS}>
-      <DashboardLoadingBody />
-    </PageLoadingChrome>
-  )
-}
-
-/** Focused workflow — single column form/settings sections. */
-export function FocusedWorkflowLoadingBody({ withSidebar = false }: { withSidebar?: boolean }) {
-  if (withSidebar) {
-    return (
-      <div className={cn("flex flex-col gap-8", FOCUSED_WORKFLOW_SIDEBAR_SECTIONS_GRID_CLASS)}>
-        <div className="space-y-2 lg:col-span-2">
-          <Skeleton className="h-9 w-40 max-w-full rounded-md" />
-          <Skeleton className="h-4 w-full max-w-xl rounded-md" />
-        </div>
-        <div className="flex flex-col gap-1">
-          {Array.from({ length: 5 }).map((_, i) => (
-            <Skeleton key={i} className="h-9 w-full rounded-md" />
-          ))}
-        </div>
-        <div className="flex flex-col gap-8">
-          <Skeleton className="h-24 w-full rounded-xl" />
-          <Skeleton className="h-48 w-full rounded-xl" />
-          <Skeleton className="h-32 w-full rounded-xl" />
-        </div>
-      </div>
-    )
-  }
-
-  return (
-    <div className="flex flex-col gap-8">
-      <div className="space-y-2">
-        <Skeleton className="h-9 w-48 max-w-full rounded-md" />
-        <Skeleton className="h-4 w-full max-w-lg rounded-md" />
-      </div>
-      <Skeleton className="h-40 w-full rounded-xl" />
-      <Skeleton className="h-56 w-full rounded-xl" />
-    </div>
-  )
-}
-
-export function FocusedWorkflowLoadingFallback({ withSidebar = false }: { withSidebar?: boolean }) {
-  return (
-    <PageLoadingChrome
-      maxWidthClassName={FOCUSED_WORKFLOW_MAX_WIDTH.lg}
-      paddingClassName={FOCUSED_WORKFLOW_CONTENT_PADDING_CLASS}
-    >
-      <FocusedWorkflowLoadingBody withSidebar={withSidebar} />
-    </PageLoadingChrome>
-  )
-}
-
-export function SimplePageLoadingBody() {
-  return (
-    <div className="flex max-w-xl flex-col gap-4 py-4">
-      <Skeleton className="h-4 w-full rounded-md" />
-      <Skeleton className="h-4 w-5/6 rounded-md" />
-      <div className="flex gap-3 pt-2">
-        <Skeleton className="h-9 w-36 rounded-md" />
-        <Skeleton className="h-9 w-28 rounded-md" />
-      </div>
-    </div>
-  )
-}
-
-export function SimplePageLoadingFallback() {
-  return (
-    <PageLoadingChrome maxWidthClassName="max-w-3xl">
-      <SimplePageLoadingBody />
-    </PageLoadingChrome>
-  )
-}
-
-const FALLBACK_BY_VARIANT: Record<PageLoadingVariant, React.ReactNode> = {
-  dashboard: <DashboardLoadingFallback />,
-  "primary-list-hub": <PrimaryListHubLoadingFallback />,
-  "question-bank-hub": <QuestionBankHubLoadingFallback />,
-  "dedicated-search": <DedicatedSearchLoadingFallback />,
-  "focused-workflow": <FocusedWorkflowLoadingFallback />,
-  "focused-workflow-sidebar": <FocusedWorkflowLoadingFallback withSidebar />,
-  simple: <SimplePageLoadingFallback />,
-}
-
-export function PageLoadingByVariant({ variant }: { variant: PageLoadingVariant }) {
-  return FALLBACK_BY_VARIANT[variant]
-}

package/template/components/ui/button-group.tsx

@@ -1 +0,0 @@
-export * from "@exxatdesignux/ui/components/button-group"

package/template/docs/consumer-app-pattern.md

@@ -1,39 +0,0 @@
-# Consumer app pattern (`@exxatdesignux/ui`)
-
-> **Audience:** Product repos that **install** the design system from npm — not the `apps/web` monorepo reference app.  
-> **Handbook:** `packages/ui/consumer-extras/AGENTS.md` · **Upgrade:** `consumer-upgrade-checklist.md` · **Skill:** `.cursor/skills/exxat-consumer-app/SKILL.md`
-
-## Intent
-
-A **consumer app** composes **`@exxatdesignux/ui`** primitives and copies **patterns** from the published **`template/`** tree. It does **not** fork parallel table stacks, view routers, or shell tokens.
-
-## MUST
-
-1. **Install** — `@exxatdesignux/ui` + peers; import DS CSS once (`@exxatdesignux/ui/globals.css` or documented entry).
-2. **Sync extras** — After version bumps: `npx --package=@exxatdesignux/ui@latest exxat-ui sync-extras` → `.cursor/skills/exxat-*` + `docs/exxat-ds/*.md`.
-3. **Diff template** — Compare `node_modules/@exxatdesignux/ui/template/` for new files (layouts, `ListPageConnectedViewBody`, `FocusedWorkflowPageTemplate`, mocks).
-4. **List hubs** — One **`useTableState`** row bag; **`ListPageConnectedViewBody`** + **`defineHubViewRenderers`**; same **`supportedViewTypes`** on **`ListPageTemplate`** and **`TablePropertiesDrawer`**.
-5. **Shell tokens** — Sidebar / secondary panel / page elevation via **`--sidebar`**, **`--secondary-panel-bg`**, **`--background`** — see **`shell-surface-elevation-pattern.md`**.
-6. **Focused workflows** — Dedicated create/edit/settings routes use **`FocusedWorkflowPageTemplate`** — **`focused-workflow-page-pattern.md`**.
-
-## MUST NOT
-
-- Copy only components without porting **AGENTS**, **rules**, and **pattern docs** when behavior changes.
-- Ship hub view tabs with long **`if (view === "table")`** chains instead of **`ListPageConnectedViewBody`**.
-- Keep a second mock array per view while the grid uses **`useTableState`**.
-- Set secondary panel to **`bg-sidebar`** or light **`--brand-tint`** mixes in dark mode.
-
-## Checklist (new consumer feature)
-
-- [ ] Read **`consumer-upgrade-checklist.md`** for the installed UI version.
-- [ ] Run **`exxat-ui sync-extras`** if skills/patterns are stale.
-- [ ] Find the closest **`template/`** hub or page; port file names and imports to your app paths.
-- [ ] **List hub:** `lib/<hub>-supported-views.ts`, `lib/data-list-view-registry.ts`, `ListPageConnectedViewBody`, centralized **`tableState.rows`**.
-- [ ] **Form route:** `FocusedWorkflowPageTemplate` + one body layout from **`focused-workflow-layouts.tsx`**.
-- [ ] **Nav + secondary panel:** `secondaryPanel` on nav item, `PANELS` registry, `useAutoPanel` — **`exxat-primary-nav-secondary-panel`** skill.
-- [ ] Re-run **`fa:subset-audit`** when adding Font Awesome glyphs.
-
-## See also
-
-- Monorepo reference: `apps/web/` (full product demo)
-- **`.cursor/rules/exxat-consumer-app.mdc`** (when working inside a consumer repo that synced rules)

package/template/docs/focused-workflow-page-pattern.md

@@ -1,84 +0,0 @@
-# Focused workflow page (dedicated routes)
-
-> **Related:** **`AGENTS.md` §6.4** (page vs drawer vs dialog), **§14** (AI checklist), **`docs/drawer-vs-dialog-pattern.md`**, **`.cursor/rules/exxat-page-vs-drawer.mdc`**, **`.cursor/rules/exxat-focused-workflow-page.mdc`**, **`.cursor/skills/exxat-focused-workflow-page/SKILL.md`**.
-
-## Intent
-
-Use **`FocusedWorkflowPageTemplate`** for **large or multi-step work** on its **own route** — create/edit forms, wizards, and sectioned settings. The shell is **narrower** than list hubs and **does not** use Miller-column / split-panel explorers.
-
-| Surface | Use instead |
-| --- | --- |
-| Browsable record hubs (table, board, dashboard tabs) | **`PrimaryPageTemplate`** + **`ListPageTemplate`** |
-| Finder / folder columns / split hub chrome | **`ListPageSplitHubChrome`**, **`ListPageFolderColumnsPanel`** |
-| Quick properties or export beside a grid | **Drawer** (`TablePropertiesDrawer`, `ExportDrawer`) |
-| Blocking confirm on the same route | **Dialog** |
-
-## Surface matrix (§6.4)
-
-| Need | Drawer | Dialog | **Focused workflow route** |
-| --- | --- | --- | --- |
-| Keep hub visible while acting | Yes | No | No |
-| Own URL / bookmark / history | Rare | No | **Yes** |
-| Multi-step wizard | Cramped | No | **Yes** |
-| Sectioned settings (left nav) | Awkward | No | **Yes** |
-| Short delete confirm | No | **Yes** | Overkill |
-
-## Shell
-
-**`FocusedWorkflowPageTemplate`** (`components/templates/focused-workflow-page-template.tsx`):
-
-- **`SidebarInset`** + **`SiteHeader`** (breadcrumb back link + title).
-- Centered column: **`max-w-3xl` / `max-w-4xl` / `max-w-5xl`** via **`maxWidth`** (`md` | `lg` | `xl`).
-- Default padding: **`FOCUSED_WORKFLOW_CONTENT_PADDING_CLASS`**.
-
-Optional **`beforeSiteHeader`** (e.g. **`SidebarAutoCollapse`** on long forms).
-
-## Body layouts
-
-Import from **`components/templates/focused-workflow-layouts.tsx`**:
-
-| Layout | When |
-| --- | --- |
-| **`FocusedWorkflowSingleColumn`** | Default stack — header, form sections, footer actions (e.g. question authoring). |
-| **`FocusedWorkflowStepForm`** + **`FocusedWorkflowWizardFooter`** | Multi-step wizard with progress list and sticky footer (placement-style flows). |
-| **`FocusedWorkflowSidebarSections`** | Sectioned form with **left nav rail** (settings-style); put **`id`** on each `<section>` matching **`sections[].id`**. |
-| **`FocusedWorkflowEmptyState`** | Placeholder / not-yet-configured route body. |
-| **`FocusedWorkflowActionFooter`** | Single-step Cancel (Esc) + primary (Enter) without step chrome. |
-
-Keyboard: wizard and action footers pair **`Shortcut`** with inline **`<Kbd variant="bare">`** per **`.cursor/rules/exxat-kbd-shortcuts.mdc`**.
-
-## Golden references
-
-| Route | Variant |
-| --- | --- |
-| **`/question-bank/new`** | Shell + **`FocusedWorkflowSingleColumn`** + domain composer |
-| **`/settings`** | Shell (`maxWidth="lg"`) + **`FocusedWorkflowSidebarSections`** |
-| **`/examples/focused-workflow`** | Showcase: empty, steps, sidebar (toggle) |
-
-## Wiring checklist (implementers)
-
-1. **Route** under **`app/(app)/…/page.tsx`** — thin server page; heavy UI in a **client** component.
-2. **`siteHeader`**: **`back`** or **`breadcrumbs`** + **`title`**; avoid duplicating the trail in the body.
-3. Pick **`maxWidth`**: **`md`** for simple forms, **`lg`** for settings / wide fields.
-4. Choose **one** body layout; do **not** nest Miller columns or **`ListPageTemplate`** view tabs inside this shell.
-5. Domain logic stays in **`*-composer.tsx`** / **`*-client.tsx`**; templates stay generic **`FocusedWorkflow*`**.
-6. Run **§14** in **`AGENTS.md`** when reviewing.
-
-## AI execution checklist (copy for PRs)
-
-- [ ] **`FocusedWorkflowPageTemplate`** on the route — not ad-hoc **`SidebarInset`** / list-hub shell.
-- [ ] Correct body variant: **single column** | **step form** | **sidebar sections** | **empty**.
-- [ ] Wizard/action footers use **`Shortcut`** + bare **`Kbd`** in buttons.
-- [ ] **No** list-hub view tabs, **no** folder-column explorer inside the page.
-- [ ] Template/component names remain **generic** (not tied to one entity).
-- [ ] **§6.5** — no toast for product feedback.
-
-## Pair with
-
-- **`exxat-page-vs-drawer.mdc`**, **`exxat-drawer-vs-dialog.mdc`**, **`exxat-kbd-shortcuts.mdc`**
-- **`exxat-reuse-before-custom.mdc`** — extend **`focused-workflow-layouts.tsx`** before forking a second shell
-
-## See also
-
-- **`components/examples/focused-workflow-showcase.tsx`**
-- **`packages/ui/consumer-extras/patterns/focused-workflow-page-pattern.md`** (npm consumers)

package/template/docs/question-bank-hub-header-pattern.md

@@ -1,25 +0,0 @@
-# Question bank hub header — folder scope + Customize folder
-
-**Audience:** Engineers extending the question bank library hub (`QuestionBankClient`, `QuestionBankPageHeader`, URL scope).
-
-## Problem
-
-The library uses **`ListPageTemplate`** with multiple **view tabs** (table, panel, tree, …). **`QuestionBankNewFolderSheet`** (customize mode) is also used inside **`QuestionBankTable`** for some views (e.g. panel columns). If **Customize folder** exists only there, users on **table** or other tabs **cannot** open the sheet from a consistent chrome entry point when the URL is scoped to a folder (`?scope=folder&folderId=…`).
-
-## Pattern
-
-1. **`QuestionBankPageHeader`** exposes optional **`onCustomizeFolder?: () => void`**. When **`navState.scope === "folder"`** and **`navState.folderId`** is set, the hub client passes a callback that opens customize mode for the matching **`QuestionBankFolder`**.
-2. **`QuestionBankClient`** (or equivalent hub client) mounts **`QuestionBankNewFolderSheet`** **once** beside **`SecondaryPanelHubTemplate` / `ListPageTemplate`**, with local state for **`open`** and **`customizingFolder`**. Saving updates **`folders`** the same way as table-embedded customize flows.
-3. The header **⋯ More** menu order stays aligned with **§4.7**: **Invite people** (when collaboration variant) → **Customize folder** (when folder-scoped) → **Export** → **Show / hide metric section** (when applicable).
-
-## References
-
-| Piece | Location |
-|-------|-----------|
-| Header prop + menu item | `components/question-bank-page-header.tsx` |
-| Client wiring + sheet | `components/question-bank-client.tsx` |
-| URL scope | `lib/question-bank-nav.ts` (`parseQuestionBankNav`, `QuestionBankNavState`) |
-| Sheet UI | `components/question-bank-new-folder-sheet.tsx` |
-
-**Cursor rule:** `.cursor/rules/exxat-question-bank-hub-header.mdc`  
-**Handbook:** `AGENTS.md` §4.6 (folder-scoped hub chrome).

package/template/lib/list-hub-nav.ts

@@ -1,121 +0,0 @@
-/**
- * List hub secondary panel + URL scope — demo filters on {@link LIST_HUB_DIRECTORY}.
- */
-
-import type { ListHubRecord } from "@/lib/mock/list-hub-directory"
-
-export const LIST_HUB_PATH = "/data-list"
-
-export type ListHubNavScope = "all" | "upcoming" | "past" | "category"
-
-export interface ListHubNavState {
-  scope: ListHubNavScope
-  /** Set when `scope === "category"` */
-  category: string | null
-}
-
-export const LIST_HUB_DEFAULT_NAV: ListHubNavState = {
-  scope: "all",
-  category: null,
-}
-
-export const LIST_HUB_CATEGORY_SCOPES = ["Training", "Field", "Clinical", "Admin"] as const
-
-export type ListHubCategoryScope = (typeof LIST_HUB_CATEGORY_SCOPES)[number]
-
-export function parseListHubNav(searchParams: URLSearchParams): ListHubNavState {
-  const raw = (searchParams.get("scope") ?? "all").toLowerCase()
-  if (raw === "upcoming") return { scope: "upcoming", category: null }
-  if (raw === "past") return { scope: "past", category: null }
-  if (raw === "category") {
-    const category = searchParams.get("category")?.trim() || null
-    return { scope: "category", category }
-  }
-  return { ...LIST_HUB_DEFAULT_NAV }
-}
-
-export function isListHubDefaultNav(nav: ListHubNavState): boolean {
-  return nav.scope === "all" && nav.category === null
-}
-
-export function isListHubNavActive(
-  pathname: string,
-  nav: ListHubNavState,
-  scope: ListHubNavScope,
-  category?: string | null,
-): boolean {
-  const p = pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname
-  if (p !== LIST_HUB_PATH) return false
-  if (scope === "all") return nav.scope === "all"
-  if (scope === "upcoming") return nav.scope === "upcoming"
-  if (scope === "past") return nav.scope === "past"
-  if (scope === "category" && category) {
-    return nav.scope === "category" && nav.category === category
-  }
-  return false
-}
-
-export function listHubNavHref(opts: {
-  scope: ListHubNavScope
-  category?: string | null
-  hash?: string
-}): string {
-  const params = new URLSearchParams()
-  if (opts.scope !== "all") params.set("scope", opts.scope)
-  if (opts.scope === "category" && opts.category) params.set("category", opts.category)
-  const q = params.toString()
-  const hash = opts.hash ?? ""
-  return `${LIST_HUB_PATH}${q ? `?${q}` : ""}${hash}`
-}
-
-export function listHubHubScopeHref(
-  pathname: string,
-  currentSearch: URLSearchParams,
-  patch: { scope: ListHubNavScope; category?: string | null },
-): string {
-  void pathname
-  void currentSearch
-  return listHubNavHref({
-    scope: patch.scope,
-    category: patch.scope === "category" ? patch.category : null,
-  })
-}
-
-function todayIsoDate(): string {
-  return new Date().toISOString().slice(0, 10)
-}
-
-export function filterListHubRows(rows: ListHubRecord[], nav: ListHubNavState): ListHubRecord[] {
-  const today = todayIsoDate()
-  switch (nav.scope) {
-    case "upcoming":
-      return rows.filter(r => r.eventDate >= today)
-    case "past":
-      return rows.filter(r => r.eventDate < today)
-    case "category":
-      if (!nav.category) return rows
-      return rows.filter(r => r.category === nav.category)
-    case "all":
-    default:
-      return rows
-  }
-}
-
-export function listHubScopeLabel(nav: ListHubNavState): string {
-  switch (nav.scope) {
-    case "upcoming":
-      return "Upcoming"
-    case "past":
-      return "Past"
-    case "category":
-      return nav.category ?? "Category"
-    case "all":
-    default:
-      return "All records"
-  }
-}
-
-export function listHubHeaderSubtitle(nav: ListHubNavState, count: number): string {
-  const noun = count === 1 ? "record" : "records"
-  return `${count} ${noun} · ${listHubScopeLabel(nav)} · One dataset across table, calendar, and board`
-}

package/template/lib/mock/list-hub-directory.ts

@@ -1,27 +0,0 @@
-/** Row shape for the List hub (`/data-list`) — one dataset for table, calendar, board, etc. */
-export interface ListHubRecord extends Record<string, unknown> {
-  id: string
-  title: string
-  category: string
-  /** ISO date (YYYY-MM-DD) for calendar view */
-  eventDate: string
-}
-
-function addDays(base: Date, days: number) {
-  const d = new Date(base)
-  d.setDate(d.getDate() + days)
-  return d.toISOString().slice(0, 10)
-}
-
-const BASE = new Date()
-
-export const LIST_HUB_DIRECTORY: ListHubRecord[] = [
-  { id: "LH-2401", title: "Orientation workshop", category: "Training", eventDate: addDays(BASE, 2) },
-  { id: "LH-2402", title: "Site visit — Metro campus", category: "Field", eventDate: addDays(BASE, 5) },
-  { id: "LH-2403", title: "Compliance review", category: "Admin", eventDate: addDays(BASE, 9) },
-  { id: "LH-2404", title: "Preceptor check-in", category: "Clinical", eventDate: addDays(BASE, 12) },
-  { id: "LH-2405", title: "Skills lab session", category: "Training", eventDate: addDays(BASE, 18) },
-  { id: "LH-2406", title: "Cohort debrief", category: "Admin", eventDate: addDays(BASE, 22) },
-  { id: "LH-2407", title: "Documentation audit", category: "Admin", eventDate: addDays(BASE, -3) },
-  { id: "LH-2408", title: "Weekend rotation", category: "Clinical", eventDate: addDays(BASE, -7) },
-]

package/template/lib/mock/list-hub-kpi.ts

@@ -1,27 +0,0 @@
-import type { MetricInsight, MetricItem } from "@/components/key-metrics"
-import type { ListHubRecord } from "@/lib/mock/list-hub-directory"
-
-export function listHubKpiMetrics(countOrRows: number | ListHubRecord[]): MetricItem[] {
-  const count = typeof countOrRows === "number" ? countOrRows : countOrRows.length
-  const scheduled = Math.max(0, count - 2)
-  const thisWeek = Math.min(count, 4)
-  return [
-    {
-      id: "total",
-      label: "Total records",
-      value: count,
-      delta: "+2",
-      trend: "up",
-      href: "#",
-      metricVariant: "hero",
-    },
-    { id: "scheduled", label: "Scheduled", value: scheduled, delta: "+1", trend: "up", href: "#" },
-    { id: "this-week", label: "This week", value: thisWeek, delta: "—", trend: "neutral", href: "#" },
-    { id: "completed", label: "Completed", value: 2, delta: "—", trend: "neutral", href: "#" },
-  ]
-}
-
-export const LIST_HUB_KPI_INSIGHT: MetricInsight = {
-  title: "3 events land this week",
-  description: "Filtered calendar and table views share the same row set after search and filters.",
-}

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

@@ -1,54 +0,0 @@
-/**
- * Demo collaborators for Question bank collaboration header (stacked faces).
- */
-
-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",
-    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"],
-  },
-]