@exxatdesignux/ui 0.2.19 → 0.4.0

package/template/lib/data-list-view-registry.ts

@@ -1,104 +1 @@
-/**
- * Central registry for list-page view types — labels, render kinds, and hub chrome rules.
- *
- * **Add a new view once here** (plus a body in `components/data-views/`). Hubs declare
- * `supportedViewTypes` on `ListPageTemplate`; table components branch with
- * `getDataListViewRenderKind` + `ListPageConnectedViewBody` (never a dashboard fallback).
- *
- * @see `docs/data-views-pattern.md` — "View registry and connected bodies"
- */
-
-import {
-  DATA_LIST_VIEW_TILES,
-  type DataListViewType,
-  dataListViewAddShortcut,
-  dataListViewIcon,
-  dataListViewLabel,
-} from "@/lib/data-list-view"
-import {
-  getDataListViewRenderKind,
-  type DataListViewRenderKind,
-} from "@/lib/data-list-view-surface"
-
-export interface DataListViewDefinition {
-  value: DataListViewType
-  label: string
-  icon: string
-  renderKind: DataListViewRenderKind
-  /** `ListPageTemplate` metrics slot above the views toolbar. */
-  hubMetricsStrip: boolean
-}
-
-const DEFINITIONS: DataListViewDefinition[] = DATA_LIST_VIEW_TILES.map(tile => {
-  const renderKind = getDataListViewRenderKind(tile.value)
-  const hubMetricsStrip = renderKind !== "calendar-with-toolbar" && renderKind !== "dashboard-with-toolbar"
-  return {
-    value: tile.value,
-    label: tile.label,
-    icon: tile.icon,
-    renderKind,
-    hubMetricsStrip,
-  }
-})
-
-const BY_VALUE = new Map<DataListViewType, DataListViewDefinition>(
-  DEFINITIONS.map(d => [d.value, d]),
-)
-
-export const DATA_LIST_VIEW_REGISTRY: readonly DataListViewDefinition[] = DEFINITIONS
-
-export function dataListViewDefinition(view: DataListViewType): DataListViewDefinition {
-  const def = BY_VALUE.get(view)
-  if (!def) {
-    throw new Error(`Unknown DataListViewType: ${view}`)
-  }
-  return def
-}
-
-/** `ListPageTemplate` hub KPI strip — false for calendar and dashboard (inline KPIs). */
-export function showsListPageHubMetricsStrip(view: DataListViewType): boolean {
-  return dataListViewDefinition(view).hubMetricsStrip
-}
-
-/** Tiles for Add view + Properties when a hub only supports a subset of views. */
-export function dataListViewTilesForHub(supported: readonly DataListViewType[]) {
-  const allowed = new Set(supported)
-  return DATA_LIST_VIEW_REGISTRY.filter(d => allowed.has(d.value)).map(d => ({
-    type: d.value,
-    label: d.label,
-    icon: d.icon,
-  }))
-}
-
-/** `SelectionTileGrid` options for Properties when a hub supports a subset of views. */
-export function dataListViewSelectionTilesForHub(supported: readonly DataListViewType[]) {
-  return dataListViewTilesForHub(supported).map(t => ({
-    value: t.type,
-    label: t.label,
-    icon: t.icon,
-  }))
-}
-
-/** View types that expose Table Properties (all registered `DataListViewType` values). */
-export const DATA_LIST_SURFACE_VIEW_TYPES: ReadonlySet<DataListViewType> = new Set(
-  DATA_LIST_VIEW_REGISTRY.map(d => d.value),
-)
-
-export function isDataListSurfaceViewType(viewType: string): viewType is DataListViewType {
-  return DATA_LIST_SURFACE_VIEW_TYPES.has(viewType as DataListViewType)
-}
-
-export function isDataListViewTypeSupported(
-  view: DataListViewType,
-  supported: readonly DataListViewType[],
-): boolean {
-  return supported.includes(view)
-}
-
-export {
-  dataListViewAddShortcut,
-  dataListViewIcon,
-  dataListViewLabel,
-  getDataListViewRenderKind,
-  type DataListViewRenderKind,
-}
+export * from "@exxatdesignux/ui/lib/data-list-view-registry"

package/template/lib/data-list-view-surface.ts

@@ -1,83 +1 @@
-/**
- * Maps `DataListViewType` to the UI surface pattern for list pages.
- *
- * **Data:** One `useTableState(fullRows, columns, …)` per tab; **filtered/sorted rows**
- * (`tableState.rows`) are the single source of truth for List, Board, and Dashboard.
- * Table view renders the same state via `DataTable`.
- *
- * | View        | Surface |
- * |------------|---------|
- * | `table`    | `DataTable` |
- * | `list`     | `DataTableToolbar` + list layout |
- * | `board`    | `DataTableToolbar` + board / kanban |
- * | `dashboard`| `DataTableToolbar` + KPI (`KeyMetrics`) + optional charts (`ChartCard`, Recharts, etc.) |
- * | `calendar` | `DataTableToolbar` + `ListPageCalendarView` (month grid + day detail) |
- * | `folder`   | `DataTableToolbar` + icon grid (macOS-Finder-style) |
- * | `panel`    | `DataTableToolbar` + resizable split (list / tree column + detail inspector) |
- */
-
-import type { DataListViewType } from "@/lib/data-list-view"
-
-export { showsListPageHubMetricsStrip } from "@/lib/data-list-view-registry"
-
-/** What to render for the active view tab (routing / branching). */
-export type DataListViewRenderKind =
-  | "data-table"
-  | "list-with-toolbar"
-  | "board-with-toolbar"
-  | "dashboard-with-toolbar"
-  | "calendar-with-toolbar"
-  | "folder-with-toolbar"
-  | "panel-with-toolbar"
-  | "tree-panel-with-toolbar"
-
-/**
- * Stable classification for switch/if chains. **Every** `DataListViewType` maps to exactly one kind.
- * Use this so `dashboard` is never mistaken for `board` (a common bug when only `list` is special-cased).
- */
-export function getDataListViewRenderKind(view: DataListViewType): DataListViewRenderKind {
-  switch (view) {
-    case "table":
-      return "data-table"
-    case "list":
-      return "list-with-toolbar"
-    case "board":
-      return "board-with-toolbar"
-    case "dashboard":
-      return "dashboard-with-toolbar"
-    case "calendar":
-      return "calendar-with-toolbar"
-    case "folder":
-      return "folder-with-toolbar"
-    case "panel":
-      return "panel-with-toolbar"
-    case "tree-panel":
-      return "tree-panel-with-toolbar"
-    default: {
-      const _x: never = view
-      return _x
-    }
-  }
-}
-
-export function usesDataTableComponent(view: DataListViewType): boolean {
-  return view === "table"
-}
-
-/** KPI band + optional charts — not the kanban board. */
-export function usesDashboardSurface(view: DataListViewType): boolean {
-  return view === "dashboard"
-}
-
-/** Shared toolbar (search, filters, properties); body differs by view. */
-export function usesToolbarWithFilteredRows(view: DataListViewType): boolean {
-  return (
-    view === "list" ||
-    view === "board" ||
-    view === "dashboard" ||
-    view === "calendar" ||
-    view === "folder" ||
-    view === "panel" ||
-    view === "tree-panel"
-  )
-}
+export * from "@exxatdesignux/ui/lib/data-list-view-surface"

package/template/lib/data-list-view.ts

@@ -1,47 +1 @@
-/**
- * Data list “view type” — shared by Properties drawer, ListPageTemplate tabs, and client state.
- *
- * **Single source of truth** for view labels/icons: use `DATA_LIST_VIEW_TILES` and
- * `dataListViewLabel` / `dataListViewIcon` on every page so Table / List / Board / Dashboard
- * stay consistent and stay wired to the same `useTableState` dataset (see `docs/data-views-pattern.md`).
- */
-export type DataListViewType =
-  | "table"
-  | "list"
-  | "board"
-  | "dashboard"
-  | "calendar"
-  | "folder"
-  | "panel"
-  | "tree-panel"
-
-export const DATA_LIST_VIEW_TILES: readonly {
-  value: DataListViewType
-  label: string
-  icon: string
-}[] = [
-  { value: "table",     icon: "fa-table",         label: "Table view" },
-  { value: "list",      icon: "fa-list",          label: "List view" },
-  { value: "board",     icon: "fa-table-columns", label: "Board view" },
-  { value: "dashboard", icon: "fa-chart-mixed",   label: "Dashboard view" },
-  { value: "calendar",  icon: "fa-calendar-days", label: "Calendar view" },
-  { value: "folder",    icon: "fa-grid-2",        label: "Folder view" },
-  { value: "panel",      icon: "fa-sidebar",      label: "List & details" },
-  { value: "tree-panel", icon: "fa-sitemap",      label: "Tree & details" },
-]
-
-/** User-facing name for tabs, Properties summary rows, and tooltips (not entity-specific). */
-export function dataListViewLabel(view: DataListViewType): string {
-  return DATA_LIST_VIEW_TILES.find(t => t.value === view)?.label ?? view
-}
-
-/** Font Awesome icon class (no prefix) for tab / toolbar state when view changes. */
-export function dataListViewIcon(view: DataListViewType): string {
-  return DATA_LIST_VIEW_TILES.find(t => t.value === view)?.icon ?? "fa-table"
-}
-
-/** Add-view menu hint + `<Shortcut>` keys (1–9). Skipped in inputs via `useShortcut`. */
-export function dataListViewAddShortcut(index: number): string | undefined {
-  if (index < 0 || index > 8) return undefined
-  return String(index + 1)
-}
+export * from "@exxatdesignux/ui/lib/data-list-view"

package/template/lib/data-view-dashboard-storage.ts

@@ -1,5 +1,5 @@
 /**
- * Centralized localStorage for **Data** view dashboard canvas (list hub, question bank).
+ * Centralized localStorage for **Data** view dashboard canvas (Placements, Team, Compliance).
  * Single bundle key; per-scope slices. Migrates legacy per-hub keys when a scope is missing.
  */
 
@@ -9,16 +9,14 @@ const BUNDLE_KEY = "exxat-ds:data-view-dashboards:v1"
 
 /** Legacy keys (pre-bundle) — read when that scope is absent from the bundle. */
 const LEGACY_KEYS: Record<DataViewScope, string> = {
-  "list-hub": "exxat-dashboard-cards",
-  "question-bank": "exxat-question-bank-dashboard-cards",
+  placements: "exxat-dashboard-cards",
+  team: "exxat-team-dashboard-cards",
+  compliance: "exxat-compliance-dashboard-cards",
 }
 
-/** @deprecated Legacy scopes still migrated from the bundle. */
-const LEGACY_SCOPES = ["placements", "team", "compliance"] as const
+export type DataViewScope = "placements" | "team" | "compliance"
 
-export type DataViewScope = "list-hub" | "question-bank"
-
-type LayoutBundle = Partial<Record<DataViewScope | (typeof LEGACY_SCOPES)[number], DashboardLayoutV1>>
+type LayoutBundle = Partial<Record<DataViewScope, DashboardLayoutV1>>
 
 function parseLayout(raw: unknown): DashboardLayoutV1 | null {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null
@@ -53,52 +51,51 @@ function readBundleRaw(): LayoutBundle {
   }
 }
 
-function writeBundleRaw(bundle: LayoutBundle) {
+function writeBundle(bundle: LayoutBundle) {
   if (typeof window === "undefined") return
   try {
     localStorage.setItem(BUNDLE_KEY, JSON.stringify(bundle))
   } catch {
-    /* quota / private mode */
-  }
-}
-
-function migrateLegacyScope(scope: DataViewScope): DashboardLayoutV1 | null {
-  const legacyKey = LEGACY_KEYS[scope]
-  if (typeof window === "undefined") return null
-  try {
-    const raw = localStorage.getItem(legacyKey)
-    if (!raw) return null
-    return parseLayout(JSON.parse(raw))
-  } catch {
-    return null
+    /* ignore quota */
   }
 }
 
-/** One-time migration: copy legacy placements/team/compliance slices into list-hub when empty. */
-function migrateRemovedHubScopes(bundle: LayoutBundle): LayoutBundle {
-  if (bundle["list-hub"]) return bundle
-  for (const legacy of LEGACY_SCOPES) {
-    const layout = bundle[legacy]
-    if (layout) {
-      return { ...bundle, "list-hub": layout }
+/**
+ * Merge any missing scopes from legacy keys into the bundle (one-time per scope per session edge cases OK).
+ */
+function ensureBundleWithLegacy(): LayoutBundle {
+  let bundle = readBundleRaw()
+  let changed = false
+  for (const scope of ["placements", "team", "compliance"] as const) {
+    if (bundle[scope]) continue
+    try {
+      const raw = localStorage.getItem(LEGACY_KEYS[scope])
+      if (!raw) continue
+      const layout = parseLayout(JSON.parse(raw) as unknown)
+      if (layout) {
+        bundle = { ...bundle, [scope]: layout }
+        changed = true
+      }
+    } catch {
+      /* ignore */
     }
   }
-  const fromPlacementsKey = migrateLegacyScope("list-hub")
-  if (fromPlacementsKey) return { ...bundle, "list-hub": fromPlacementsKey }
+  if (changed) writeBundle(bundle)
   return bundle
 }
 
 /**
- * Load persisted layout for a hub Data view.
+ * Load persisted layout for a hub (Placements / Team / Compliance Data view).
  */
 export function loadDataViewLayout(scope: DataViewScope): DashboardLayoutV1 | null {
-  const bundle = migrateRemovedHubScopes(readBundleRaw())
-  return bundle[scope] ?? migrateLegacyScope(scope)
+  const bundle = ensureBundleWithLegacy()
+  return bundle[scope] ?? null
 }
 
-/** Persist layout for a hub Data view. */
+/**
+ * Save layout for one hub; updates the shared bundle atomically.
+ */
 export function saveDataViewLayout(scope: DataViewScope, layout: DashboardLayoutV1) {
-  const bundle = migrateRemovedHubScopes(readBundleRaw())
-  bundle[scope] = layout
-  writeBundleRaw(bundle)
+  const bundle = ensureBundleWithLegacy()
+  writeBundle({ ...bundle, [scope]: layout })
 }

package/template/lib/dev-log.ts

@@ -1,8 +1 @@
-/**
- * Logs only in development. Use for mock flows (export, submit) instead of raw console.log.
- */
-export function devLog(...args: unknown[]): void {
-  if (process.env.NODE_ENV === "development") {
-    console.log(...args)
-  }
-}
+export * from "@exxatdesignux/ui/lib/dev-log"

package/template/lib/editable-target.ts

@@ -1,10 +1 @@
-/**
- * True when focus is in a field where global shortcuts should not fire.
- */
-export function isEditableTarget(target: EventTarget | null): boolean {
-  const el = target as HTMLElement | null
-  if (!el) return false
-  if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)
-    return true
-  return el.getAttribute?.("contenteditable") === "true"
-}
+export { isEditableTarget } from "@exxatdesignux/ui/lib/editable-target"