@exxatdesignux/ui 0.2.18 → 0.3.0

package/template/components/compliance-table.tsx

@@ -1,7 +1,8 @@
 "use client"
 
 /**
- * Compliance obligations — DataTable + TablePropertiesDrawer + list/board/dashboard.
+ * Compliance obligations — thin wrapper around the centralized `<HubTable>`. Owns only the
+ * column defs, panel-view helpers, dashboard layout state, and per-view renderers.
  */
 
 import * as React from "react"
@@ -11,7 +12,7 @@ import {
   COMPLIANCE_STATUS_LABEL,
 } from "@/lib/list-status-badges"
 import type { ComplianceItem } from "@/lib/mock/compliance"
-import { DataTable, DataTableToolbar } from "@/components/data-table"
+import { DataTableToolbar } from "@/components/data-table"
 import {
   ComplianceDashboardChartsSection,
   ALL_COMPLIANCE_DASHBOARD_CARDS,
@@ -23,15 +24,19 @@ import {
 } from "@/components/data-view-dashboard-charts-compliance"
 import { KEY_METRICS_KPI_COUNT_DEFAULT } from "@/lib/dashboard-layout-merge"
 import type { ChartType, DashboardLayout } from "@/lib/data-view-dashboard-placements-layout"
-import { ComplianceListView } from "@/components/compliance-list-view"
+import { ListPageBoardCard } from "@/components/data-views/list-page-board-card"
 import { ComplianceBoardView, COMPLIANCE_BOARD_GROUP_OPTIONS } from "@/components/compliance-board-view"
 import { complianceKpiInsight, complianceKpiMetrics } from "@/lib/mock/compliance-kpi"
 import type { DataListViewType } from "@/lib/data-list-view"
-import type { OpenTablePropertiesHandle } from "@/lib/list-page-table-properties"
 import type { ColumnDef } from "@/components/data-table/types"
-import { useTableState } from "@/components/data-table/use-table-state"
 import { TablePropertiesDrawerButton } from "@/components/table-properties"
-import type { ConditionalRule, FilterFieldDef, FilterOperator } from "@/components/table-properties/types"
+import {
+  HubTable,
+  type HubTableHandle,
+  type HubTableRenderers,
+  type HubTableRendererArgs,
+} from "@/components/data-views"
+import { COMPLIANCE_SUPPORTED_VIEWS } from "@/lib/compliance-supported-views"
 import { ListHubStatusBadge } from "@/components/list-hub-status-badge"
 import { Button } from "@/components/ui/button"
 import {
@@ -46,10 +51,8 @@ import { useCoachMark } from "@/hooks/use-coach-mark"
 import { DASHBOARD_CUSTOMIZE_COACH_STEPS } from "@/lib/dashboard-customize-coach-mark"
 import { FinderPanelView, type FinderGroup } from "@/components/data-views/finder-panel-view"
 import { ListPageSplitHubChrome } from "@/components/data-views/list-page-split-hub-chrome"
-import {
-  DEFAULT_DATA_LIST_DISPLAY_OPTIONS,
-  type DataListDisplayOptions,
-} from "@/lib/data-list-display-options"
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
 
 function uniqueCategories(items: ComplianceItem[]) {
   return [...new Set(items.map(i => i.category))].sort().map(c => ({ value: c, label: c }))
@@ -62,42 +65,10 @@ const STATUS_FILTER_OPTS = [
   { value: "pending", label: COMPLIANCE_STATUS_LABEL.pending },
 ]
 
-function columnToFilterFieldDef(c: ColumnDef<ComplianceItem>): FilterFieldDef | null {
-  if (!c.filter) return null
-  const f = c.filter
-  const defaultOps: FilterOperator[] =
-    f.type === "select" || f.type === "date"
-      ? ["is", "is_not"]
-      : ["contains", "not_contains"]
-  return {
-    key: c.key,
-    label: c.label,
-    icon: f.icon ?? "fa-filter",
-    type: f.type,
-    operators: (f.operators ?? defaultOps) as FilterOperator[],
-    options: f.options,
-    ...(f.textMask ? { textMask: f.textMask } : {}),
-  }
-}
-
-function columnsToFilterFields(cols: ColumnDef<ComplianceItem>[]) {
-  return cols.map(columnToFilterFieldDef).filter((x): x is FilterFieldDef => x !== null)
-}
-
 function buildComplianceColumns(items: ComplianceItem[]): ColumnDef<ComplianceItem>[] {
   const catOpts = uniqueCategories(items)
-
-  const COLUMN_SELECT: ColumnDef<ComplianceItem> = {
-    key: "select",
-    label: "",
-    width: 40,
-    minWidth: 40,
-    defaultPin: "left",
-    lockPin: true,
-  }
-
-  const cols: ColumnDef<ComplianceItem>[] = [
-    COLUMN_SELECT,
+  return [
+    { key: "select", label: "", width: 40, minWidth: 40, defaultPin: "left", lockPin: true },
     {
       key: "title",
       label: "Obligation",
@@ -106,11 +77,7 @@ function buildComplianceColumns(items: ComplianceItem[]): ColumnDef<ComplianceIt
       sortable: true,
       sortKey: "title",
       defaultPin: "left",
-      filter: {
-        type: "text",
-        icon: "fa-file-lines",
-        operators: ["contains", "not_contains"],
-      },
+      filter: { type: "text", icon: "fa-file-lines", operators: ["contains", "not_contains"] },
       cell: row => (
         <span className="line-clamp-2 text-sm font-medium text-foreground">{row.title}</span>
       ),
@@ -122,12 +89,7 @@ function buildComplianceColumns(items: ComplianceItem[]): ColumnDef<ComplianceIt
       minWidth: 120,
       sortable: true,
       sortKey: "category",
-      filter: {
-        type: "select",
-        icon: "fa-layer-group",
-        operators: ["is", "is_not"],
-        options: catOpts,
-      },
+      filter: { type: "select", icon: "fa-layer-group", operators: ["is", "is_not"], options: catOpts },
       cell: row => <span className="text-sm text-foreground/90">{row.category}</span>,
     },
     {
@@ -137,12 +99,7 @@ function buildComplianceColumns(items: ComplianceItem[]): ColumnDef<ComplianceIt
       minWidth: 100,
       sortable: true,
       sortKey: "status",
-      filter: {
-        type: "select",
-        icon: "fa-circle-dot",
-        operators: ["is", "is_not"],
-        options: STATUS_FILTER_OPTS,
-      },
+      filter: { type: "select", icon: "fa-circle-dot", operators: ["is", "is_not"], options: STATUS_FILTER_OPTS },
       cell: row => (
         <ListHubStatusBadge
           label={COMPLIANCE_STATUS_LABEL[row.status]}
@@ -170,11 +127,7 @@ function buildComplianceColumns(items: ComplianceItem[]): ColumnDef<ComplianceIt
       minWidth: 120,
       sortable: true,
       sortKey: "owner",
-      filter: {
-        type: "text",
-        icon: "fa-user",
-        operators: ["contains", "not_contains"],
-      },
+      filter: { type: "text", icon: "fa-user", operators: ["contains", "not_contains"] },
       cell: row => <span className="text-sm text-foreground/90">{row.owner}</span>,
     },
     {
@@ -219,349 +172,123 @@ function buildComplianceColumns(items: ComplianceItem[]): ColumnDef<ComplianceIt
       ),
     },
   ]
-
-  return cols
 }
 
+// ─── Panel view helpers ─────────────────────────────────────────────────────
 
-export type ComplianceTableHandle = OpenTablePropertiesHandle
-
-export const ComplianceTable = React.forwardRef<
-  ComplianceTableHandle,
-  { items: ComplianceItem[]; view?: DataListViewType; onViewChange?: (v: DataListViewType) => void }
->(function ComplianceTable({ items, view = "table", onViewChange }, ref) {
-  const columns = React.useMemo(() => buildComplianceColumns(items), [items])
-  const filterFields = React.useMemo(() => columnsToFilterFields(columns), [columns])
-  const fieldDefinitionsForDrawer = React.useMemo(
-    () =>
-      columns
-        .filter(c => c.key !== "select" && c.key !== "actions")
-        .map(c => ({ key: c.key, label: c.label, sortable: !!(c.sortable && (c.sortKey ?? c.key)) })),
-    [columns],
-  )
-
-  const resolveColumnLabel = React.useCallback(
-    (key: string) => columns.find(c => c.key === key)?.label ?? key,
-    [columns],
-  )
+function buildCompliancePanelGroups(rows: ComplianceItem[]): FinderGroup[] {
+  const byCategory = new Map<string, ComplianceItem[]>()
+  for (const item of rows) {
+    if (!byCategory.has(item.category)) byCategory.set(item.category, [])
+    byCategory.get(item.category)!.push(item)
+  }
+  return Array.from(byCategory.keys())
+    .sort()
+    .map(category => ({
+      id: category,
+      label: category,
+      icon: "fa-folder",
+      count: (byCategory.get(category) ?? []).length,
+    }))
+}
 
-  const [displayOptions, setDisplayOptions] = React.useState<DataListDisplayOptions>(DEFAULT_DATA_LIST_DISPLAY_OPTIONS)
-  const patchDisplay = React.useCallback((patch: Partial<DataListDisplayOptions>) => {
-    setDisplayOptions(prev => ({ ...prev, ...patch }))
-  }, [])
+// ─── Dashboard body ─────────────────────────────────────────────────────────
 
-  const [conditionalRules, setConditionalRules] = React.useState<ConditionalRule[]>([])
-  const addConditionalRule = React.useCallback((rule: Omit<ConditionalRule, "id">) => {
-    setConditionalRules(prev => [...prev, { ...rule, id: `cr-${Date.now()}` }])
-  }, [])
-  const removeConditionalRule = React.useCallback((id: string) => {
-    setConditionalRules(prev => prev.filter(r => r.id !== id))
-  }, [])
-  const updateConditionalRule = React.useCallback((id: string, patch: Partial<ConditionalRule>) => {
-    setConditionalRules(prev => prev.map(r => r.id === id ? { ...r, ...patch } : r))
-  }, [])
+interface ComplianceDashboardBodyProps {
+  args: HubTableRendererArgs<ComplianceItem>
+  columns: ColumnDef<ComplianceItem>[]
+}
 
-  const tableState = useTableState(items, columns, { key: "dueDate", dir: "asc" })
+function ComplianceDashboardBody({ args, columns }: ComplianceDashboardBodyProps) {
+  const { state, drawerToolbarProps, displayOptions } = args
+  const rows = state.rows as ComplianceItem[]
 
   const dashboardKpi = React.useMemo(
-    () => ({
-      metrics: complianceKpiMetrics(tableState.rows as ComplianceItem[]),
-      insight: complianceKpiInsight(tableState.rows as ComplianceItem[]),
-    }),
-    [tableState.rows],
+    () => ({ metrics: complianceKpiMetrics(rows), insight: complianceKpiInsight(rows) }),
+    [rows],
   )
 
-  const [visibleComplianceCards, setVisibleComplianceCards] = React.useState<string[]>(() =>
+  const [visibleCards, setVisibleCards] = React.useState<string[]>(() =>
     ALL_COMPLIANCE_DASHBOARD_CARDS.map(c => c.id),
   )
-  const [complianceCardOrder, setComplianceCardOrder] = React.useState<string[]>(() =>
+  const [cardOrder, setCardOrder] = React.useState<string[]>(() =>
     ALL_COMPLIANCE_DASHBOARD_CARDS.map(c => c.id),
   )
-  const [complianceCardSpans, setComplianceCardSpans] = React.useState<Record<string, 1 | 2>>(() => ({
-    ...DEFAULT_COMPLIANCE_SPANS,
-  }))
-  const [complianceCardChartTypes, setComplianceCardChartTypes] = React.useState<Record<string, ChartType>>(() => ({
+  const [cardSpans, setCardSpans] = React.useState<Record<string, 1 | 2>>(() => ({ ...DEFAULT_COMPLIANCE_SPANS }))
+  const [cardChartTypes, setCardChartTypes] = React.useState<Record<string, ChartType>>(() => ({
     ...DEFAULT_COMPLIANCE_CHART_TYPES,
   }))
-  const [complianceKeyMetricsKpiCount, setComplianceKeyMetricsKpiCount] = React.useState<number>(
-    KEY_METRICS_KPI_COUNT_DEFAULT,
-  )
-  const [complianceDashboardLayoutEdit, setComplianceDashboardLayoutEdit] = React.useState(false)
-  const complianceDashboardLayoutHydrated = React.useRef(false)
-  const complianceDashboardLayoutEditBaselineRef = React.useRef<DashboardLayout | null>(null)
+  const [kpiCount, setKpiCount] = React.useState<number>(KEY_METRICS_KPI_COUNT_DEFAULT)
+  const [layoutEdit, setLayoutEdit] = React.useState(false)
+  const hydrated = React.useRef(false)
+  const baselineRef = React.useRef<DashboardLayout | null>(null)
 
   React.useEffect(() => {
     const saved = loadComplianceDashboardLayout()
     const m = mergeComplianceDashboardLayout(saved)
-    setVisibleComplianceCards(m.visible)
-    setComplianceCardOrder(m.order)
-    setComplianceCardSpans(m.spans ?? { ...DEFAULT_COMPLIANCE_SPANS })
-    setComplianceCardChartTypes(m.chartTypes ?? { ...DEFAULT_COMPLIANCE_CHART_TYPES })
-    setComplianceKeyMetricsKpiCount(m.keyMetricsKpiCount ?? KEY_METRICS_KPI_COUNT_DEFAULT)
-    complianceDashboardLayoutHydrated.current = true
+    setVisibleCards(m.visible)
+    setCardOrder(m.order)
+    setCardSpans(m.spans ?? { ...DEFAULT_COMPLIANCE_SPANS })
+    setCardChartTypes(m.chartTypes ?? { ...DEFAULT_COMPLIANCE_CHART_TYPES })
+    setKpiCount(m.keyMetricsKpiCount ?? KEY_METRICS_KPI_COUNT_DEFAULT)
+    hydrated.current = true
   }, [])
 
   React.useEffect(() => {
-    if (!complianceDashboardLayoutHydrated.current) return
+    if (!hydrated.current) return
     saveComplianceDashboardLayout({
-      visible: visibleComplianceCards,
-      order: complianceCardOrder,
-      spans: complianceCardSpans,
-      chartTypes: complianceCardChartTypes,
-      keyMetricsKpiCount: complianceKeyMetricsKpiCount,
+      visible: visibleCards,
+      order: cardOrder,
+      spans: cardSpans,
+      chartTypes: cardChartTypes,
+      keyMetricsKpiCount: kpiCount,
     })
-  }, [visibleComplianceCards, complianceCardOrder, complianceCardSpans, complianceCardChartTypes, complianceKeyMetricsKpiCount])
-
-  const handleComplianceVisibleChange = React.useCallback((v: string[]) => {
-    setVisibleComplianceCards(v)
-  }, [])
-
-  const handleComplianceOrderChange = React.useCallback((o: string[]) => {
-    setComplianceCardOrder(o)
-  }, [])
-
-  const handleComplianceSpanChange = React.useCallback((id: string, span: 1 | 2) => {
-    setComplianceCardSpans(prev => ({ ...prev, [id]: span }))
-  }, [])
-
-  const handleComplianceChartTypeChange = React.useCallback((id: string, t: ChartType) => {
-    setComplianceCardChartTypes(prev => ({ ...prev, [id]: t }))
+  }, [visibleCards, cardOrder, cardSpans, cardChartTypes, kpiCount])
+
+  const onResetLayout = React.useCallback(() => {
+    setVisibleCards(ALL_COMPLIANCE_DASHBOARD_CARDS.map(c => c.id))
+    setCardOrder(ALL_COMPLIANCE_DASHBOARD_CARDS.map(c => c.id))
+    setCardSpans({ ...DEFAULT_COMPLIANCE_SPANS })
+    setCardChartTypes({ ...DEFAULT_COMPLIANCE_CHART_TYPES })
+    setKpiCount(KEY_METRICS_KPI_COUNT_DEFAULT)
   }, [])
 
-  const handleResetComplianceDashboardLayout = React.useCallback(() => {
-    setVisibleComplianceCards(ALL_COMPLIANCE_DASHBOARD_CARDS.map(c => c.id))
-    setComplianceCardOrder(ALL_COMPLIANCE_DASHBOARD_CARDS.map(c => c.id))
-    setComplianceCardSpans({ ...DEFAULT_COMPLIANCE_SPANS })
-    setComplianceCardChartTypes({ ...DEFAULT_COMPLIANCE_CHART_TYPES })
-    setComplianceKeyMetricsKpiCount(KEY_METRICS_KPI_COUNT_DEFAULT)
-  }, [])
-
-  const handleComplianceDashboardLayoutEditStart = React.useCallback(() => {
-    complianceDashboardLayoutEditBaselineRef.current = {
-      visible: [...visibleComplianceCards],
-      order: [...complianceCardOrder],
-      spans: { ...complianceCardSpans },
-      chartTypes: { ...complianceCardChartTypes },
-      keyMetricsKpiCount: complianceKeyMetricsKpiCount,
+  const onLayoutEditStart = React.useCallback(() => {
+    baselineRef.current = {
+      visible: [...visibleCards],
+      order: [...cardOrder],
+      spans: { ...cardSpans },
+      chartTypes: { ...cardChartTypes },
+      keyMetricsKpiCount: kpiCount,
     }
-    setComplianceDashboardLayoutEdit(true)
-  }, [visibleComplianceCards, complianceCardOrder, complianceCardSpans, complianceCardChartTypes, complianceKeyMetricsKpiCount])
-
-  const handleComplianceDashboardLayoutEditDone = React.useCallback(() => {
-    setComplianceDashboardLayoutEdit(false)
-  }, [])
+    setLayoutEdit(true)
+  }, [visibleCards, cardOrder, cardSpans, cardChartTypes, kpiCount])
 
-  const handleComplianceDashboardLayoutEditCancel = React.useCallback(() => {
-    const b = complianceDashboardLayoutEditBaselineRef.current
+  const onLayoutEditCancel = React.useCallback(() => {
+    const b = baselineRef.current
     if (b) {
-      setVisibleComplianceCards(b.visible)
-      setComplianceCardOrder(b.order)
-      setComplianceCardSpans(b.spans ?? { ...DEFAULT_COMPLIANCE_SPANS })
-      setComplianceCardChartTypes(b.chartTypes ?? { ...DEFAULT_COMPLIANCE_CHART_TYPES })
-      setComplianceKeyMetricsKpiCount(b.keyMetricsKpiCount ?? KEY_METRICS_KPI_COUNT_DEFAULT)
+      setVisibleCards(b.visible)
+      setCardOrder(b.order)
+      setCardSpans(b.spans ?? { ...DEFAULT_COMPLIANCE_SPANS })
+      setCardChartTypes(b.chartTypes ?? { ...DEFAULT_COMPLIANCE_CHART_TYPES })
+      setKpiCount(b.keyMetricsKpiCount ?? KEY_METRICS_KPI_COUNT_DEFAULT)
     }
-    setComplianceDashboardLayoutEdit(false)
+    setLayoutEdit(false)
   }, [])
 
-  const dashboardCustomizeCoach = useCoachMark({
+  const coach = useCoachMark({
     flowId: "compliance-dashboard-customize",
     steps: DASHBOARD_CUSTOMIZE_COACH_STEPS,
     delay: 700,
-    enabled: view === "dashboard",
+    enabled: true,
   })
 
-  React.useImperativeHandle(ref, () => ({
-    openPropertiesDrawer: () => {
-      tableState.setSheetOpen(true)
-    },
-  // `tableState` is freshly returned each render by useTableState; depending on
-  // it would re-create the imperative handle on every render. Only the React
-  // setter is needed (and is referentially stable).
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  }), [tableState.setSheetOpen])
-
-  const complianceBoardGroupKey = COMPLIANCE_BOARD_GROUP_OPTIONS.some(
-    o => o.key === displayOptions.boardGroupByColumnKey,
-  )
-    ? displayOptions.boardGroupByColumnKey
-    : "status"
-
-  // Build panel groups from categories
-  const panelGroupsBuilder = (rows: ComplianceItem[]): FinderGroup[] => {
-    // Group items by category
-    const itemsByCategory = new Map<string, ComplianceItem[]>()
-    for (const item of rows) {
-      const category = item.category
-      if (!itemsByCategory.has(category)) {
-        itemsByCategory.set(category, [])
-      }
-      itemsByCategory.get(category)!.push(item)
-    }
-
-    // Build groups from categories, sorted alphabetically
-    const groups: FinderGroup[] = []
-    const categories = Array.from(itemsByCategory.keys()).sort()
-
-    for (const category of categories) {
-      const categoryItems = itemsByCategory.get(category) ?? []
-      groups.push({
-        id: category,
-        label: category,
-        icon: "fa-folder",
-        count: categoryItems.length,
-      })
-    }
-
-    return groups
-  }
-
-  const panelRenderListRow = (row: ComplianceItem, _isSelected: boolean) => (
-    <div className="flex-1 min-w-0">
-      <p className="text-sm font-medium text-foreground truncate">{row.title}</p>
-      <p className="text-xs text-muted-foreground mt-1">{row.category}</p>
-    </div>
-  )
-
-  const panelRenderDetail = (row: ComplianceItem) => (
-    <div className="flex min-h-0 flex-1 flex-col overflow-y-auto p-4">
-      <div>
-        <h3 className="text-sm font-semibold text-foreground mb-2">Obligation</h3>
-        <p className="text-sm text-foreground">{row.title}</p>
-      </div>
-      <div className="flex flex-col gap-2">
-        <div>
-          <span className="text-xs font-medium text-muted-foreground">Category</span>
-          <p className="text-sm text-foreground">{row.category}</p>
-        </div>
-        <div>
-          <span className="text-xs font-medium text-muted-foreground">Status</span>
-          <p className="text-sm text-foreground">{COMPLIANCE_STATUS_LABEL[row.status]}</p>
-        </div>
-      </div>
-    </div>
-  )
-
-  const drawerToolbarProps = {
-    totalRows: items.length,
-    filterFields,
-    fieldDefinitions: fieldDefinitionsForDrawer,
-    resolveColumnLabel,
-    displayOptions,
-    onDisplayOptionsChange: patchDisplay,
-    conditionalRules,
-    onAddConditionalRule: addConditionalRule,
-    onRemoveConditionalRule: removeConditionalRule,
-    onUpdateConditionalRule: updateConditionalRule,
-    currentView: view,
-    onViewChange,
-    lifecycleTabLabel: "Compliance",
-    boardGroupByColumnOptions: [...COMPLIANCE_BOARD_GROUP_OPTIONS],
-  }
-
-  const tableProps = {
-    data: items,
-    columns,
-    getRowId: (row: ComplianceItem) => row.id,
-    getRowSelectionLabel: (row: ComplianceItem) => row.title,
-    selectable: true,
-    searchable: displayOptions.showToolbarSearch,
-    showColumnHeaders: displayOptions.showColumnLabels,
-    groupable: true,
-    defaultSort: { key: "dueDate", dir: "asc" as const },
-    emptyState: <p className="text-sm text-muted-foreground">No compliance items.</p>,
-    conditionalRules,
-    state: tableState,
-    toolbarSlot: (s: ReturnType<typeof useTableState<ComplianceItem>>) => (
-      <TablePropertiesDrawerButton {...drawerToolbarProps} state={s} />
-    ),
-    bulkActionsSlot: (selected: Set<string | number>) => {
-      const n = selected.size
-      if (n === 0) return null
-      return (
-        <>
-          <span className="sr-only">{n} selected</span>
-          <Tip label="Export selection (demo)">
-            <Button size="sm" variant="outline" type="button">
-              <i className="fa-light fa-arrow-down-to-line" aria-hidden="true" />
-              Export
-            </Button>
-          </Tip>
-        </>
-      )
-    },
-  }
-
-  if (view === "table") {
-    return (
-      <div className="pb-6">
-        <DataTable<ComplianceItem> {...tableProps} />
-      </div>
-    )
-  }
-
-  const sharedToolbar = (
-    <DataTableToolbar
-      state={tableState}
-      columns={columns}
-      searchable={displayOptions.showToolbarSearch}
-      searchAriaLabel="Search compliance obligations"
-      toolbarSlot={s => <TablePropertiesDrawerButton {...drawerToolbarProps} state={s} />}
-    />
-  )
-
-  if (view === "list") {
-    return (
-      <div className="flex min-h-0 flex-1 flex-col">
-        {sharedToolbar}
-        <ComplianceListView
-          rows={tableState.rows as ComplianceItem[]}
-          onRowActivate={row => tableState.toggleRow(row.id)}
-        />
-      </div>
-    )
-  }
-
-  if (view === "board") {
-    return (
-      <div className="flex min-h-0 flex-1 flex-col">
-        {sharedToolbar}
-        <ComplianceBoardView
-          rows={tableState.rows as ComplianceItem[]}
-          groupByColumnKey={complianceBoardGroupKey}
-          onRowActivate={row => tableState.toggleRow(row.id)}
-        />
-      </div>
-    )
-  }
-
-  if (view === "panel") {
-    return (
-      <div className="flex min-h-0 flex-1 flex-col">
-        {sharedToolbar}
-        <ListPageSplitHubChrome aria-label="Compliance obligations panel view">
-          <FinderPanelView<ComplianceItem>
-            embedded
-            groupsColumnTitle="Category"
-            groups={panelGroupsBuilder(tableState.rows)}
-            rows={tableState.rows}
-            getRowId={(row) => row.id}
-            getRowGroupId={(row) => row.category}
-            autoSaveId="compliance-panel-view"
-            renderListRow={panelRenderListRow}
-            renderDetail={panelRenderDetail}
-            emptyList={<p className="text-sm text-muted-foreground">No obligations found.</p>}
-          />
-        </ListPageSplitHubChrome>
-      </div>
-    )
-  }
-
   return (
     <div className="flex min-h-0 flex-1 flex-col">
-      <CoachMark state={dashboardCustomizeCoach} />
-      {!complianceDashboardLayoutEdit ? (
+      <CoachMark state={coach} />
+      {!layoutEdit ? (
         <DataTableToolbar
-          state={tableState}
+          state={state}
           columns={columns}
           searchable={displayOptions.showToolbarSearch}
           searchAriaLabel="Search compliance obligations"
@@ -576,7 +303,7 @@ export const ComplianceTable = React.forwardRef<
                     variant="ghost"
                     size="icon-sm"
                     aria-label="Edit dashboard layout"
-                    onClick={handleComplianceDashboardLayoutEditStart}
+                    onClick={onLayoutEditStart}
                     className="text-muted-foreground hover:text-interactive-hover-foreground hover:bg-interactive-hover"
                   >
                     <i className="fa-light fa-pen-ruler text-[13px]" aria-hidden="true" />
@@ -588,25 +315,154 @@ export const ComplianceTable = React.forwardRef<
         />
       ) : null}
       <ComplianceDashboardChartsSection
-        rows={tableState.rows as ComplianceItem[]}
+        rows={rows}
         keyMetrics={dashboardKpi}
-        visibleCards={visibleComplianceCards}
-        cardOrder={complianceCardOrder}
-        cardSpans={complianceCardSpans}
-        cardChartTypes={complianceCardChartTypes}
-        keyMetricsKpiCount={complianceKeyMetricsKpiCount}
-        layoutEditMode={complianceDashboardLayoutEdit}
-        onVisibleChange={handleComplianceVisibleChange}
-        onOrderChange={handleComplianceOrderChange}
-        onSpanChange={handleComplianceSpanChange}
-        onChartTypeChange={handleComplianceChartTypeChange}
-        onKeyMetricsKpiCountChange={setComplianceKeyMetricsKpiCount}
-        onResetLayout={handleResetComplianceDashboardLayout}
-        onLayoutEditDone={handleComplianceDashboardLayoutEditDone}
-        onLayoutEditCancel={handleComplianceDashboardLayoutEditCancel}
+        visibleCards={visibleCards}
+        cardOrder={cardOrder}
+        cardSpans={cardSpans}
+        cardChartTypes={cardChartTypes}
+        keyMetricsKpiCount={kpiCount}
+        layoutEditMode={layoutEdit}
+        onVisibleChange={setVisibleCards}
+        onOrderChange={setCardOrder}
+        onSpanChange={(id, span) => setCardSpans(prev => ({ ...prev, [id]: span }))}
+        onChartTypeChange={(id, t) => setCardChartTypes(prev => ({ ...prev, [id]: t }))}
+        onKeyMetricsKpiCountChange={setKpiCount}
+        onResetLayout={onResetLayout}
+        onLayoutEditDone={() => setLayoutEdit(false)}
+        onLayoutEditCancel={onLayoutEditCancel}
       />
     </div>
   )
+}
+
+// ─── Public component ───────────────────────────────────────────────────────
+
+export type ComplianceTableHandle = HubTableHandle
+
+export const ComplianceTable = React.forwardRef<
+  ComplianceTableHandle,
+  { items: ComplianceItem[]; view?: DataListViewType; onViewChange?: (v: DataListViewType) => void }
+>(function ComplianceTable({ items, view = "table", onViewChange }, ref) {
+  const columns = React.useMemo(() => buildComplianceColumns(items), [items])
+
+  const renderers: HubTableRenderers<ComplianceItem> = {
+    "board-with-toolbar": ({ state, toolbarShell, displayOptions }) => {
+      const boardGroupKey = COMPLIANCE_BOARD_GROUP_OPTIONS.some(
+        o => o.key === displayOptions.boardGroupByColumnKey,
+      )
+        ? displayOptions.boardGroupByColumnKey
+        : "status"
+      return toolbarShell(
+        <ComplianceBoardView
+          rows={state.rows as ComplianceItem[]}
+          groupByColumnKey={boardGroupKey}
+          onRowActivate={row => state.toggleRow(row.id)}
+        />,
+      )
+    },
+    "panel-with-toolbar": ({ state, toolbarShell }) =>
+      toolbarShell(
+        <ListPageSplitHubChrome aria-label="Compliance obligations panel view">
+          <FinderPanelView<ComplianceItem>
+            embedded
+            groupsColumnTitle="Category"
+            groups={buildCompliancePanelGroups(state.rows as ComplianceItem[])}
+            rows={state.rows as ComplianceItem[]}
+            getRowId={row => row.id}
+            getRowGroupId={row => row.category}
+            autoSaveId="compliance-panel-view"
+            renderListRow={row => (
+              <div className="flex-1 min-w-0">
+                <p className="text-sm font-medium text-foreground truncate">{row.title}</p>
+                <p className="text-xs text-muted-foreground mt-1">{row.category}</p>
+              </div>
+            )}
+            renderDetail={row => (
+              <div className="flex min-h-0 flex-1 flex-col overflow-y-auto p-4">
+                <div>
+                  <h3 className="text-sm font-semibold text-foreground mb-2">Obligation</h3>
+                  <p className="text-sm text-foreground">{row.title}</p>
+                </div>
+                <div className="flex flex-col gap-2">
+                  <div>
+                    <span className="text-xs font-medium text-muted-foreground">Category</span>
+                    <p className="text-sm text-foreground">{row.category}</p>
+                  </div>
+                  <div>
+                    <span className="text-xs font-medium text-muted-foreground">Status</span>
+                    <p className="text-sm text-foreground">{COMPLIANCE_STATUS_LABEL[row.status]}</p>
+                  </div>
+                </div>
+              </div>
+            )}
+            emptyList={<p className="text-sm text-muted-foreground">No obligations found.</p>}
+          />
+        </ListPageSplitHubChrome>,
+      ),
+    "dashboard-with-toolbar": args => <ComplianceDashboardBody args={args} columns={columns} />,
+  }
+
+  return (
+    <HubTable<ComplianceItem>
+      rows={items}
+      columns={columns}
+      view={view}
+      onViewChange={onViewChange}
+      supportedViewTypes={COMPLIANCE_SUPPORTED_VIEWS}
+      hubLabel="Compliance"
+      lifecycleTabLabel="Compliance"
+      searchAriaLabel="Search compliance obligations"
+      getRowId={row => row.id}
+      getRowSelectionLabel={row => row.title}
+      defaultSort={{ key: "dueDate", dir: "asc" }}
+      emptyState={<p className="text-sm text-muted-foreground">No compliance items.</p>}
+      boardGroupByColumnOptions={[...COMPLIANCE_BOARD_GROUP_OPTIONS]}
+      listAriaLabel="Compliance items"
+      listEmptyState="No compliance items match your filters."
+      renderListRow={row => (
+        <ListPageBoardCard
+          layout="row"
+          rowContainerClassName="flex w-full flex-col gap-1 sm:flex-row sm:items-center sm:gap-4"
+          rowEnd={
+            <div className="flex shrink-0 items-center gap-2">
+              <ListHubStatusBadge
+                surface="board"
+                label={COMPLIANCE_STATUS_LABEL[row.status]}
+                tintClassName={COMPLIANCE_STATUS_BADGE_CLASS[row.status]}
+                icon={COMPLIANCE_STATUS_ICON[row.status]}
+              />
+              <i className="fa-light fa-chevron-right text-xs text-muted-foreground" aria-hidden="true" />
+            </div>
+          }
+        >
+          <div className="space-y-0.5">
+            <p className="text-sm font-semibold text-foreground">{row.title}</p>
+            <p className="text-xs text-muted-foreground">
+              {row.category} · Due {row.dueDate}
+            </p>
+            <p className="text-xs text-muted-foreground">Owner: {row.owner}</p>
+          </div>
+        </ListPageBoardCard>
+      )}
+      bulkActionsSlot={selected => {
+        if (selected.size === 0) return null
+        return (
+          <>
+            <span className="sr-only">{selected.size} selected</span>
+            <Tip label="Export selection (demo)">
+              <Button size="sm" variant="outline" type="button">
+                <i className="fa-light fa-arrow-down-to-line" aria-hidden="true" />
+                Export
+              </Button>
+            </Tip>
+          </>
+        )
+      }}
+      renderers={renderers}
+      handleRef={ref}
+    />
+  )
 })
 
 ComplianceTable.displayName = "ComplianceTable"