Data Quality Status

1"use client";
2 
3import * as React from "react";
4import { motion, AnimatePresence } from "motion/react";
5 
6import { cn } from "@/lib/utils";
7import {
8  useReducedMotion,
9  useDisclosure,
10  useAnimatedNumber,
11  statusVars,
12  formatTimestamp as sharedFormatTimestamp,
13  type StatusTone,
14} from "@/lib/motiq";
15 
16/* -------------------------------------------------------------------------- */
17/* Types                                                                       */
18/* -------------------------------------------------------------------------- */
19 
20export type TimeValue = Date | number | string;
21 
22/**
23 * The outcome of a single validation check, owned by the host application. The
24 * component never runs the check and never decides pass/fail — it presents the
25 * verdict the app supplies. `unknown` is a first-class, honest state: it means
26 * the check has not produced evidence, and it is *never* silently upgraded to a
27 * pass.
28 */
29export type CheckState = "pass" | "warning" | "failure" | "unknown";
30 
31/** Filter selector for the check list (state, or "all"). */
32export type CheckFilter = CheckState | "all";
33 
34/** One line of detail for a check, revealed when its row is expanded. */
35export interface QualityIssue {
36  id: string;
37  /** Human-readable description of the problem. */
38  message: string;
39  /** Records touched by this specific issue (app-supplied). */
40  records?: number;
41  /** Where the issue lives, e.g. "column: email". */
42  location?: string;
43}
44 
45/** A single validation check result (app-supplied — never computed here). */
46export interface QualityCheck {
47  id: string;
48  /** Short human label, e.g. "No null emails". */
49  label: string;
50  /** Verdict supplied by the application. */
51  state: CheckState;
52  /** One-line summary shown on the collapsed row. */
53  summary?: string;
54  /** How many records this check flagged (drives the affected-records count). */
55  affectedRecords?: number;
56  /** Per-check issue detail, shown when the row is expanded. */
57  issues?: QualityIssue[];
58}
59 
60/**
61 * A headline quality metric. Every field is optional so the app can honestly
62 * report "Unknown" for anything it has not measured. The component NEVER invents
63 * a value: with no `score` and no `label`, the tile shows "Unknown".
64 */
65export interface QualityMetric {
66  /** Normalised 0–1 score, if the app measured one. */
67  score?: number | null;
68  /** Explicit display value (e.g. "98.6%", "2h behind"). Overrides `score`. */
69  label?: string;
70// … truncated