@exxatdesignux/ui 0.3.0 → 0.4.1

package/template/lib/data-view-dashboard-placements-layout.ts

@@ -1,215 +0,0 @@
-/**
- * Placements **Data** view dashboard — card ids, defaults, and persistence.
- * Split from `data-view-dashboard-charts.tsx` so list-hub code can import layout
- * without pulling Recharts / chart canvas into the main chunk.
- */
-
-import {
-  KEY_METRICS_KPI_COUNT_DEFAULT,
-  mergeDashboardLayoutGeneric,
-} from "@/lib/dashboard-layout-merge"
-import {
-  loadDataViewLayout as loadStoredDataViewLayout,
-  saveDataViewLayout as saveStoredDataViewLayout,
-} from "@/lib/data-view-dashboard-storage"
-
-export type ChartType =
-  | "bar"
-  | "horizontal-bar"
-  | "pie"
-  | "area"
-  | "line"
-  | "radial"
-  | "stacked-bar"
-
-export interface ChartTypeOption {
-  type: ChartType
-  label: string
-  icon: string
-}
-
-export interface DashboardCardDef {
-  id: string
-  title: string
-  description: string
-  defaultSpan: 1 | 2
-  defaultChartType: ChartType
-  chartTypes: ChartTypeOption[]
-}
-
-/** Virtual “card” for the KPI strip — reorderable with charts in edit mode */
-export const KEY_METRICS_CARD_ID = "key-metrics"
-
-export const ALL_DASHBOARD_CARDS: DashboardCardDef[] = [
-  {
-    id: KEY_METRICS_CARD_ID,
-    title: "Key metrics",
-    description: "Summary KPIs for filtered placements",
-    defaultSpan: 1,
-    defaultChartType: "bar",
-    chartTypes: [],
-  },
-  {
-    id: "status-pipeline",
-    title: "Status Pipeline",
-    description: "Where placements are in the workflow",
-    defaultSpan: 1,
-    defaultChartType: "bar",
-    chartTypes: [
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-      { type: "horizontal-bar", label: "Horizontal Bar", icon: "fa-light fa-chart-bar fa-rotate-90" },
-      { type: "pie", label: "Donut", icon: "fa-light fa-chart-pie" },
-    ],
-  },
-  {
-    id: "program-mix",
-    title: "Placements by Program",
-    description: "Distribution across active programs",
-    defaultSpan: 1,
-    defaultChartType: "pie",
-    chartTypes: [
-      { type: "pie", label: "Donut", icon: "fa-light fa-chart-pie" },
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-      { type: "horizontal-bar", label: "Horizontal Bar", icon: "fa-light fa-chart-bar fa-rotate-90" },
-    ],
-  },
-  {
-    id: "compliance-status",
-    title: "Compliance Status",
-    description: "Document readiness for upcoming placements",
-    defaultSpan: 1,
-    defaultChartType: "horizontal-bar",
-    chartTypes: [
-      { type: "horizontal-bar", label: "Horizontal Bar", icon: "fa-light fa-chart-bar fa-rotate-90" },
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-      { type: "pie", label: "Donut", icon: "fa-light fa-chart-pie" },
-    ],
-  },
-  {
-    id: "readiness-overview",
-    title: "Student Readiness",
-    description: "How prepared students are for their placements",
-    defaultSpan: 1,
-    defaultChartType: "bar",
-    chartTypes: [
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-      { type: "horizontal-bar", label: "Horizontal Bar", icon: "fa-light fa-chart-bar fa-rotate-90" },
-      { type: "pie", label: "Donut", icon: "fa-light fa-chart-pie" },
-    ],
-  },
-  {
-    id: "progress-tracker",
-    title: "Ongoing Progress",
-    description: "How far along each ongoing placement is",
-    defaultSpan: 2,
-    defaultChartType: "stacked-bar",
-    chartTypes: [
-      { type: "stacked-bar", label: "Stacked Bar", icon: "fa-light fa-layer-group" },
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-    ],
-  },
-  {
-    id: "site-utilisation",
-    title: "Site Utilisation",
-    description: "Which clinical sites have the most placements",
-    defaultSpan: 1,
-    defaultChartType: "horizontal-bar",
-    chartTypes: [
-      { type: "horizontal-bar", label: "Horizontal Bar", icon: "fa-light fa-chart-bar fa-rotate-90" },
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-      { type: "pie", label: "Donut", icon: "fa-light fa-chart-pie" },
-    ],
-  },
-  {
-    id: "completion-outcomes",
-    title: "Completion Outcomes",
-    description: "Pass rate and average ratings for completed placements",
-    defaultSpan: 1,
-    defaultChartType: "radial",
-    chartTypes: [
-      { type: "radial", label: "Radial", icon: "fa-light fa-circle-notch" },
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-    ],
-  },
-  {
-    id: "upcoming-timeline",
-    title: "Upcoming Start Dates",
-    description: "New placements starting in the next 8 weeks",
-    defaultSpan: 2,
-    defaultChartType: "area",
-    chartTypes: [
-      { type: "area", label: "Area", icon: "fa-light fa-chart-area" },
-      { type: "line", label: "Line", icon: "fa-light fa-chart-line" },
-      { type: "bar", label: "Bar", icon: "fa-light fa-chart-bar" },
-    ],
-  },
-]
-
-export const DEFAULT_VISIBLE_CARDS = ALL_DASHBOARD_CARDS.map(c => c.id)
-export const DEFAULT_SPANS: Record<string, 1 | 2> = Object.fromEntries(
-  ALL_DASHBOARD_CARDS.map(c => [c.id, c.defaultSpan]),
-)
-export const DEFAULT_CHART_TYPES: Record<string, ChartType> = Object.fromEntries(
-  ALL_DASHBOARD_CARDS.map(c => [c.id, c.defaultChartType]),
-)
-
-export interface DashboardLayout {
-  visible: string[]
-  order: string[]
-  spans?: Record<string, 1 | 2>
-  chartTypes?: Record<string, ChartType>
-  keyMetricsKpiCount?: number
-}
-
-export function loadDashboardLayout(): DashboardLayout | null {
-  const v = loadStoredDataViewLayout("placements")
-  if (!v) return null
-  return {
-    visible: v.visible,
-    order: v.order,
-    spans: v.spans,
-    chartTypes: v.chartTypes as Record<string, ChartType> | undefined,
-    keyMetricsKpiCount: v.keyMetricsKpiCount,
-  }
-}
-
-export function mergeDashboardLayout(saved: DashboardLayout | null): DashboardLayout {
-  const defaults = {
-    visible: [...DEFAULT_VISIBLE_CARDS],
-    order: ALL_DASHBOARD_CARDS.map(c => c.id),
-    spans: { ...DEFAULT_SPANS },
-    chartTypes: { ...DEFAULT_CHART_TYPES } as Record<string, string>,
-    keyMetricsKpiCount: KEY_METRICS_KPI_COUNT_DEFAULT,
-  }
-  const ids = ALL_DASHBOARD_CARDS.map(c => c.id)
-  const m = mergeDashboardLayoutGeneric(saved, defaults, ids)
-  return {
-    visible: m.visible,
-    order: m.order,
-    spans: m.spans as Record<string, 1 | 2>,
-    chartTypes: m.chartTypes as Record<string, ChartType>,
-    keyMetricsKpiCount: m.keyMetricsKpiCount,
-  }
-}
-
-export function saveDashboardLayout(layout: DashboardLayout) {
-  saveStoredDataViewLayout("placements", {
-    visible: layout.visible,
-    order: layout.order,
-    spans: layout.spans,
-    chartTypes: layout.chartTypes as Record<string, string> | undefined,
-    keyMetricsKpiCount: layout.keyMetricsKpiCount,
-  })
-}
-
-export function applyVisibleReorder(
-  fullOrder: string[],
-  visible: Set<string>,
-  newVisibleOrder: string[],
-): string[] {
-  let vi = 0
-  return fullOrder.map(id => {
-    if (!visible.has(id)) return id
-    return newVisibleOrder[vi++]!
-  })
-}

package/template/lib/mock/compliance-kpi.ts

@@ -1,61 +0,0 @@
-import type { MetricInsight, MetricItem } from "@/components/key-metrics"
-import type { ComplianceItem } from "@/lib/mock/compliance"
-
-export function complianceKpiMetrics(rows: ComplianceItem[]): MetricItem[] {
-  const compliant = rows.filter(r => r.status === "compliant").length
-  const dueSoon = rows.filter(r => r.status === "due_soon").length
-  const overdue = rows.filter(r => r.status === "overdue").length
-  const pending = rows.filter(r => r.status === "pending").length
-
-  return [
-    {
-      id: "total",
-      label: "Total items",
-      value: rows.length,
-      delta: "—",
-      trend: "neutral",
-      href: "#",
-      metricVariant: "hero",
-    },
-    {
-      id: "compliant",
-      label: "Compliant",
-      value: compliant,
-      delta: "—",
-      trend: "neutral",
-      href: "#",
-    },
-    {
-      id: "attention",
-      label: "Due soon",
-      value: dueSoon,
-      delta: dueSoon > 0 ? "!" : "—",
-      trend: dueSoon > 0 ? "up" : "neutral",
-      href: "#",
-    },
-    {
-      id: "risk",
-      label: "Overdue / pending",
-      value: overdue + pending,
-      delta: "—",
-      trend: overdue + pending > 0 ? "up" : "neutral",
-      href: "#",
-    },
-  ]
-}
-
-export function complianceKpiInsight(rows: ComplianceItem[]): MetricInsight {
-  const overdue = rows.filter(r => r.status === "overdue").length
-  const dueSoon = rows.filter(r => r.status === "due_soon").length
-  return {
-    title: "Compliance queue",
-    description:
-      overdue > 0
-        ? `${overdue} item(s) overdue. ${dueSoon} due within 30 days.`
-        : dueSoon > 0
-          ? `${dueSoon} item(s) due soon — review owners and dates.`
-          : "No overdue items in this view.",
-    severity: overdue > 0 ? "warning" : dueSoon > 0 ? "warning" : "info",
-    actionLabel: "Ask Leo",
-  }
-}

package/template/lib/mock/compliance.ts

@@ -1,146 +0,0 @@
-/**
- * Mock compliance obligations — replace with API data in production.
- */
-
-export type ComplianceStatus = "compliant" | "due_soon" | "overdue" | "pending"
-
-export interface ComplianceItem extends Record<string, unknown> {
-  id: string
-  title: string
-  category: string
-  status: ComplianceStatus
-  /** MM/DD/YYYY */
-  dueDate: string
-  owner: string
-  /** MM/DD/YYYY */
-  lastReviewed: string
-}
-
-export const COMPLIANCE_ITEMS: ComplianceItem[] = [
-  {
-    id: "1",
-    title: "Annual HIPAA training attestation",
-    category: "HIPAA",
-    status: "compliant",
-    dueDate: "12/31/2026",
-    owner: "Alex Rivera",
-    lastReviewed: "03/01/2026",
-  },
-  {
-    id: "2",
-    title: "OSHA bloodborne pathogen review",
-    category: "OSHA",
-    status: "due_soon",
-    dueDate: "04/10/2026",
-    owner: "Jordan Chen",
-    lastReviewed: "10/15/2025",
-  },
-  {
-    id: "3",
-    title: "Clinical site affiliation agreements",
-    category: "Clinical",
-    status: "pending",
-    dueDate: "05/01/2026",
-    owner: "Sam Patel",
-    lastReviewed: "—",
-  },
-  {
-    id: "4",
-    title: "FERPA student records policy",
-    category: "Privacy",
-    status: "compliant",
-    dueDate: "09/30/2026",
-    owner: "Taylor Brooks",
-    lastReviewed: "02/20/2026",
-  },
-  {
-    id: "5",
-    title: "Background check re-verification",
-    category: "Clinical",
-    status: "overdue",
-    dueDate: "03/01/2026",
-    owner: "Jordan Chen",
-    lastReviewed: "03/01/2025",
-  },
-  {
-    id: "6",
-    title: "Accreditation self-study draft",
-    category: "Accreditation",
-    status: "due_soon",
-    dueDate: "04/22/2026",
-    owner: "Alex Rivera",
-    lastReviewed: "01/10/2026",
-  },
-  {
-    id: "7",
-    title: "Incident response tabletop exercise",
-    category: "HIPAA",
-    status: "pending",
-    dueDate: "06/15/2026",
-    owner: "Sam Patel",
-    lastReviewed: "—",
-  },
-  {
-    id: "8",
-    title: "Emergency preparedness plan",
-    category: "OSHA",
-    status: "compliant",
-    dueDate: "11/01/2026",
-    owner: "Taylor Brooks",
-    lastReviewed: "02/28/2026",
-  },
-  {
-    id: "9",
-    title: "Medication safety competency checklist",
-    category: "Clinical",
-    status: "compliant",
-    dueDate: "08/01/2026",
-    owner: "Alex Rivera",
-    lastReviewed: "03/15/2026",
-  },
-  {
-    id: "10",
-    title: "Data breach notification procedure",
-    category: "Privacy",
-    status: "due_soon",
-    dueDate: "04/05/2026",
-    owner: "Jordan Chen",
-    lastReviewed: "10/01/2025",
-  },
-  {
-    id: "11",
-    title: "LCME / programmatic review evidence",
-    category: "Accreditation",
-    status: "pending",
-    dueDate: "07/30/2026",
-    owner: "Sam Patel",
-    lastReviewed: "—",
-  },
-  {
-    id: "12",
-    title: "Sharps injury log audit",
-    category: "OSHA",
-    status: "overdue",
-    dueDate: "02/20/2026",
-    owner: "Taylor Brooks",
-    lastReviewed: "02/20/2025",
-  },
-  {
-    id: "13",
-    title: "Business associate agreement inventory",
-    category: "HIPAA",
-    status: "compliant",
-    dueDate: "10/15/2026",
-    owner: "Alex Rivera",
-    lastReviewed: "03/01/2026",
-  },
-  {
-    id: "14",
-    title: "Student immunization tracking",
-    category: "Clinical",
-    status: "due_soon",
-    dueDate: "04/18/2026",
-    owner: "Jordan Chen",
-    lastReviewed: "09/01/2025",
-  },
-]

package/template/lib/mock/placements-kpi.ts

@@ -1,134 +0,0 @@
-// ─────────────────────────────────────────────────────────────────────────────
-// List hub — KPI strip + insight (data-list; dashboard view uses row-driven helpers)
-// ─────────────────────────────────────────────────────────────────────────────
-
-import type { MetricInsight, MetricItem } from "@/components/key-metrics"
-import { ALL_PLACEMENTS, type Placement, type Status } from "./placements"
-
-function statusCount(status: Status): number {
-  return ALL_PLACEMENTS.filter((p) => p.status === status).length
-}
-
-/**
- * KPIs from the current filtered row set (table/list/board/dashboard shared state).
- * Use for the dashboard view tab; optional for the template metrics strip when you want parity.
- */
-export function placementKpiMetricsFromRows(rows: Placement[]): MetricItem[] {
-  const total = rows.length
-  const startingWeek = rows.filter(p => p.daysUntilStart >= 0 && p.daysUntilStart <= 7).length
-  const alerts = rows.filter(p => {
-    const r = p.readiness.toLowerCase()
-    return r.includes("risk") || r.includes("blocked")
-  }).length
-  const complete = rows.filter(p => p.compliance === "Complete").length
-  const avgPct = total > 0 ? Math.round((complete / total) * 100) : 0
-
-  return [
-    {
-      id: "total-placements",
-      label: "Total rows",
-      value: total,
-      delta: "—",
-      trend: "neutral",
-      href: "#",
-      metricVariant: "hero",
-    },
-    {
-      id: "starting-week",
-      label: "Due this week",
-      value: startingWeek,
-      delta: "—",
-      trend: startingWeek > 0 ? "up" : "neutral",
-      href: "#",
-    },
-    {
-      id: "compliance-alerts",
-      label: "Attention flags",
-      value: alerts,
-      delta: "—",
-      trend: alerts > 0 ? "up" : "neutral",
-      href: "#",
-    },
-    {
-      id: "avg-compliance",
-      label: "Completeness",
-      value: `${avgPct}%`,
-      delta: "—",
-      trend: "neutral",
-      href: "#",
-    },
-  ]
-}
-
-export function placementKpiInsightFromRows(rows: Placement[]): MetricInsight {
-  const pending = rows.filter(p => p.status === "pending").length
-  const inReview = rows.filter(p => p.status === "under-review").length
-  const n = rows.length
-  return {
-    title: "Queue snapshot",
-    description:
-      n > 0
-        ? `${pending} pending, ${inReview} in review in this view. Clear the queue to keep work moving.`
-        : "No rows match the current filters.",
-    href: "/data-list",
-    severity: pending + inReview > 0 ? "warning" : "info",
-    actionLabel: "Ask Leo",
-  }
-}
-
-/**
- * KPI row for the list hub metrics strip (demo numbers).
- */
-export const PLACEMENT_KPI_METRICS: MetricItem[] = [
-  {
-    id: "total-placements",
-    label: "Total rows",
-    value: 50,
-    delta: "+12",
-    trend: "up",
-    href: "#all",
-    metricVariant: "hero",
-  },
-  {
-    id: "starting-week",
-    label: "Due this week",
-    value: 0,
-    delta: "-5",
-    trend: "down",
-    href: "#starting",
-  },
-  {
-    id: "compliance-alerts",
-    label: "Attention flags",
-    value: 23,
-    delta: "+13",
-    trend: "up",
-    href: "#alerts",
-  },
-  {
-    id: "avg-compliance",
-    label: "Completeness",
-    value: "87%",
-    delta: "+3",
-    trend: "up",
-    href: "#compliance",
-  },
-]
-
-/**
- * Insight copy derived from demo row status counts.
- */
-export function getPlacementInsight(): MetricInsight {
-  const pending = statusCount("pending")
-  const inReview = statusCount("under-review")
-
-  return {
-    title: "Queue snapshot",
-    description: `${pending} pending, ${inReview} in review. Clear the queue to keep work moving.`,
-    href: "/data-list",
-    severity: "warning",
-    actionLabel: "Ask Leo",
-  }
-}
-
-export const PLACEMENT_KPI_INSIGHT = getPlacementInsight()