@datarecce/ui 1.52.0-nightly.20260604 → 1.52.0-nightly.20260607

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/dist/{RouteConfigContext-CF2ynFu6.d.ts → RouteConfigContext-Dhffxg0a.d.ts} +1 -1
  2. package/dist/{RouteConfigContext-CF2ynFu6.d.ts.map → RouteConfigContext-Dhffxg0a.d.ts.map} +1 -1
  3. package/dist/{ScreenshotDataGrid-CFWyhxE7.d.ts → ScreenshotDataGrid-5EwaZxMk.d.ts} +1 -1
  4. package/dist/{ScreenshotDataGrid-CFWyhxE7.d.ts.map → ScreenshotDataGrid-5EwaZxMk.d.ts.map} +1 -1
  5. package/dist/advanced.d.ts +9 -9
  6. package/dist/advanced.js +1 -1
  7. package/dist/{api-D50B0UMd.js → api-D7m6D3R5.js} +2 -2
  8. package/dist/api-D7m6D3R5.js.map +1 -0
  9. package/dist/{api-CVXkhvDl.d.ts → api-DZymTKh4.d.ts} +2 -2
  10. package/dist/{api-CVXkhvDl.d.ts.map → api-DZymTKh4.d.ts.map} +1 -1
  11. package/dist/api.d.ts +3 -3
  12. package/dist/api.js +1 -1
  13. package/dist/{chartTheme-D_J0wCs9.d.ts → chartTheme-CzJoXHE8.d.ts} +1 -1
  14. package/dist/{chartTheme-D_J0wCs9.d.ts.map → chartTheme-CzJoXHE8.d.ts.map} +1 -1
  15. package/dist/components-run.d.ts +2 -3
  16. package/dist/components-run.js +1 -1
  17. package/dist/components.d.ts +6 -8
  18. package/dist/components.js +1 -1
  19. package/dist/constants.d.ts +1 -1
  20. package/dist/contexts.d.ts +4 -4
  21. package/dist/hooks-DxNrS1mN.js +7 -0
  22. package/dist/hooks-DxNrS1mN.js.map +1 -0
  23. package/dist/hooks.d.ts +2 -2
  24. package/dist/hooks.js +1 -1
  25. package/dist/{index-ebgKX4Gr.d.ts → index--3nbLBO3.d.ts} +56 -4
  26. package/dist/index--3nbLBO3.d.ts.map +1 -0
  27. package/dist/{index-C_rwHada.d.ts → index-BwwK0z1-.d.ts} +3 -3
  28. package/dist/index-BwwK0z1-.d.ts.map +1 -0
  29. package/dist/{index-CBfydi66.d.ts → index-CHGw3r8p.d.ts} +2 -2
  30. package/dist/{index-CBfydi66.d.ts.map → index-CHGw3r8p.d.ts.map} +1 -1
  31. package/dist/{index-C-vMzkvF.d.ts → index-CcjcKQNp.d.ts} +1 -1
  32. package/dist/index-CcjcKQNp.d.ts.map +1 -0
  33. package/dist/{index-Zui-8enI.d.ts → index-DbZc6tFS.d.ts} +3 -3
  34. package/dist/{index-Zui-8enI.d.ts.map → index-DbZc6tFS.d.ts.map} +1 -1
  35. package/dist/{index-CitmP9e7.d.ts → index-DiylGzO1.d.ts} +4 -4
  36. package/dist/{index-CitmP9e7.d.ts.map → index-DiylGzO1.d.ts.map} +1 -1
  37. package/dist/{index-_QtUThVd.d.ts → index-ljGk0vtJ.d.ts} +1 -1
  38. package/dist/{index-_QtUThVd.d.ts.map → index-ljGk0vtJ.d.ts.map} +1 -1
  39. package/dist/{index-CDG2V3lk.d.ts → index-tycbfWRA.d.ts} +6 -6
  40. package/dist/{index-CDG2V3lk.d.ts.map → index-tycbfWRA.d.ts.map} +1 -1
  41. package/dist/{index-D8FcsCIF.d.ts → index-yom8qvXO.d.ts} +3 -3
  42. package/dist/index-yom8qvXO.d.ts.map +1 -0
  43. package/dist/index.d.ts +15 -16
  44. package/dist/index.js +1 -1
  45. package/dist/{instanceInfo-DZJ47qaP.d.ts → instanceInfo-Cxe3cNOM.d.ts} +13 -3
  46. package/dist/instanceInfo-Cxe3cNOM.d.ts.map +1 -0
  47. package/dist/lib/api/track.d.ts +23 -1
  48. package/dist/lib/api/track.d.ts.map +1 -1
  49. package/dist/lib/api/track.js +1 -1
  50. package/dist/lib/api/track.js.map +1 -1
  51. package/dist/{lineage-D_TBiJDk.d.ts → lineage-Ba_RtC68.d.ts} +12 -75
  52. package/dist/lineage-Ba_RtC68.d.ts.map +1 -0
  53. package/dist/primitives-CH-N_7Xw.d.ts +3057 -0
  54. package/dist/primitives-CH-N_7Xw.d.ts.map +1 -0
  55. package/dist/primitives.d.ts +7 -9
  56. package/dist/primitives.js +1 -1
  57. package/dist/result.d.ts +1 -1
  58. package/dist/result.js +1 -1
  59. package/dist/src-0N-BnDdU.js +12 -0
  60. package/dist/src-0N-BnDdU.js.map +1 -0
  61. package/dist/style.css +46 -0
  62. package/dist/theme.d.ts +2 -2
  63. package/dist/{RunProgress-DMnOxPYv.d.ts → types-B3DXJzwE.d.ts} +258 -4
  64. package/dist/types-B3DXJzwE.d.ts.map +1 -0
  65. package/dist/{types-CxqTcNx7.d.ts → types-Dmemk4LS.d.ts} +2 -2
  66. package/dist/{types-CxqTcNx7.d.ts.map → types-Dmemk4LS.d.ts.map} +1 -1
  67. package/dist/types.d.ts +9 -9
  68. package/dist/{useThemeColors-Ds1thBNy.d.ts → useThemeColors-C-siKolp.d.ts} +1 -1
  69. package/dist/{useThemeColors-Ds1thBNy.d.ts.map → useThemeColors-C-siKolp.d.ts.map} +1 -1
  70. package/dist/utils-D1p-E_Ng.js +6 -0
  71. package/dist/utils-D1p-E_Ng.js.map +1 -0
  72. package/dist/utils.d.ts +2 -2
  73. package/dist/utils.js +1 -1
  74. package/package.json +1 -1
  75. package/dist/RunProgress-DMnOxPYv.d.ts.map +0 -1
  76. package/dist/SplitPane-DKjK6eiV.d.ts +0 -1623
  77. package/dist/SplitPane-DKjK6eiV.d.ts.map +0 -1
  78. package/dist/api-D50B0UMd.js.map +0 -1
  79. package/dist/hooks-D15-EL7C.js +0 -7
  80. package/dist/hooks-D15-EL7C.js.map +0 -1
  81. package/dist/index-C-vMzkvF.d.ts.map +0 -1
  82. package/dist/index-C_rwHada.d.ts.map +0 -1
  83. package/dist/index-D8FcsCIF.d.ts.map +0 -1
  84. package/dist/index-ebgKX4Gr.d.ts.map +0 -1
  85. package/dist/instanceInfo-DZJ47qaP.d.ts.map +0 -1
  86. package/dist/lineage-D_TBiJDk.d.ts.map +0 -1
  87. package/dist/primitives-CJIlGlsM.d.ts +0 -1279
  88. package/dist/primitives-CJIlGlsM.d.ts.map +0 -1
  89. package/dist/src-D3Oco6am.js +0 -12
  90. package/dist/src-D3Oco6am.js.map +0 -1
  91. package/dist/types-3N6OUHk6.d.ts +0 -260
  92. package/dist/types-3N6OUHk6.d.ts.map +0 -1
  93. package/dist/utils-DV3twX_X.js +0 -6
  94. package/dist/utils-DV3twX_X.js.map +0 -1
@@ -1,1623 +0,0 @@
1
-
2
- import { $t as RowObjectType, vn as NodeData } from "./instanceInfo-DZJ47qaP.js";
3
- import { c as LineageGraphNode, i as LineageGraph } from "./types-CxqTcNx7.js";
4
- import { CSSProperties, MouseEvent, ReactNode } from "react";
5
- import { ColDef, ColGroupDef } from "ag-grid-community";
6
- import { Edge, EdgeProps } from "@xyflow/react";
7
-
8
- //#region src/components/lineage/nodes/LineageNode.d.ts
9
- /**
10
- * Change status for node visualization
11
- */
12
- type NodeChangeStatus = "added" | "removed" | "modified" | "unchanged";
13
- /**
14
- * Selection mode for the node
15
- */
16
- type SelectMode = "normal" | "selecting" | "action_result";
17
- /**
18
- * Change category from column-level lineage analysis
19
- */
20
- type ChangeCategory = "breaking" | "non_breaking" | "partial_breaking" | "unknown";
21
- /**
22
- * Data structure for lineage node
23
- */
24
- interface LineageNodeData extends Record<string, unknown> {
25
- /** Display label for the node */
26
- label: string;
27
- /** Node type (model, source, seed, etc.) */
28
- nodeType?: string;
29
- /** Change status for diff visualization */
30
- changeStatus?: NodeChangeStatus;
31
- /** Whether this node is currently selected */
32
- isSelected?: boolean;
33
- /** Resource type for icon display */
34
- resourceType?: string;
35
- /** Materialization strategy (table, view, incremental, etc.) */
36
- materialized?: string;
37
- /** Package name */
38
- packageName?: string;
39
- /** Whether new CLL experience is active (data-level, for ReactFlow passthrough) */
40
- newCllExperience?: boolean;
41
- /** Whether this node is impacted by CLL analysis (data-level, for ReactFlow passthrough) */
42
- isImpacted?: boolean;
43
- /** Whether to show column-level details */
44
- showColumns?: boolean;
45
- /** Column data if showing columns */
46
- columns?: Array<{
47
- name: string;
48
- type?: string;
49
- changeStatus?: NodeChangeStatus;
50
- }>;
51
- }
52
- /**
53
- * Props for LineageNode component
54
- */
55
- interface LineageNodeProps {
56
- /** Node ID */
57
- id: string;
58
- /** Node data */
59
- data: LineageNodeData;
60
- /** Whether the node is selected (from React Flow) */
61
- selected?: boolean;
62
- /** Enable interactive mode with checkbox */
63
- interactive?: boolean;
64
- /** Selection mode */
65
- selectMode?: SelectMode;
66
- /** Whether the node is selected (checkbox state) */
67
- isNodeSelected?: boolean;
68
- /** Whether the node is focused */
69
- isFocused?: boolean;
70
- /** Whether the node is highlighted */
71
- isHighlighted?: boolean;
72
- /** Whether to show content (zoom level visibility) */
73
- showContent?: boolean;
74
- /** Action tag to display (for action_result mode) */
75
- actionTag?: ReactNode;
76
- /** Whether to show change analysis mode */
77
- showChangeAnalysis?: boolean;
78
- /** Change category text */
79
- changeCategory?: ChangeCategory;
80
- /** Runs aggregated display component */
81
- runsAggregatedTag?: ReactNode;
82
- /** Whether node has parent nodes (show left handle) */
83
- hasParents?: boolean;
84
- /** Whether node has child nodes (show right handle) */
85
- hasChildren?: boolean;
86
- /** Number of columns for column container height */
87
- columnCount?: number;
88
- /** Height per column in pixels */
89
- columnHeight?: number;
90
- /** Whether dark mode is active */
91
- isDark?: boolean;
92
- /** Whether new CLL experience is active */
93
- newCllExperience?: boolean;
94
- /** Whether this node is impacted by CLL analysis */
95
- isImpacted?: boolean;
96
- /** This model itself has a whole-model change. Suppresses the graph badge (the signal lives on NodeView's title chip + stripe) and the change-category text label. */
97
- isWholeModelChanged?: boolean;
98
- /** This model is downstream of (impacted by) a whole-model change. Suppresses the graph badge (the signal lives on NodeView's title chip + stripe) and the change-category text label. Precedence is enforced internally: `isWholeModelChanged` outranks this flag. */
99
- isWholeModelImpacted?: boolean;
100
- /** Whether the `--whole-model-impact` server flag is on. When false, no per-column badges render and the "Model-Wide Change / Column Change / Additive Change" text labels are shown instead. */
101
- wholeModelImpact?: boolean;
102
- /** Callback when node is clicked */
103
- onNodeClick?: (nodeId: string) => void;
104
- /** Callback when node is double-clicked */
105
- onNodeDoubleClick?: (nodeId: string) => void;
106
- /** Callback when checkbox is clicked */
107
- onSelect?: (nodeId: string) => void;
108
- /** Callback when context menu is requested */
109
- onContextMenu?: (event: MouseEvent, nodeId: string) => void;
110
- }
111
- /**
112
- * LineageNode - Pure presentation component for displaying nodes in a lineage graph
113
- *
114
- * This component is designed to be used with @xyflow/react and receives all data via props.
115
- * It does not perform any data fetching or state management - it is purely presentational.
116
- *
117
- * @example Basic usage
118
- * ```tsx
119
- * <LineageNode
120
- * id="model.my_model"
121
- * data={{
122
- * label: "my_model",
123
- * nodeType: "model",
124
- * changeStatus: "modified",
125
- * resourceType: "model"
126
- * }}
127
- * selected={false}
128
- * onNodeClick={(nodeId) => console.log("Clicked:", nodeId)}
129
- * />
130
- * ```
131
- *
132
- * @example Interactive mode with selection
133
- * ```tsx
134
- * <LineageNode
135
- * id="model.my_model"
136
- * data={{ label: "my_model", changeStatus: "added" }}
137
- * interactive
138
- * selectMode="selecting"
139
- * isNodeSelected={selectedNodes.has("model.my_model")}
140
- * onSelect={(nodeId) => toggleSelection(nodeId)}
141
- * />
142
- * ```
143
- *
144
- * @example Action result mode
145
- * ```tsx
146
- * <LineageNode
147
- * id="model.my_model"
148
- * data={{ label: "my_model", changeStatus: "modified" }}
149
- * selectMode="action_result"
150
- * actionTag={<ActionTag status="running" progress={{ percentage: 0.5 }} />}
151
- * />
152
- * ```
153
- */
154
- declare function LineageNodeComponent({
155
- id,
156
- data,
157
- selected,
158
- interactive,
159
- selectMode,
160
- isNodeSelected,
161
- isFocused,
162
- isHighlighted,
163
- showContent,
164
- actionTag,
165
- showChangeAnalysis,
166
- changeCategory,
167
- runsAggregatedTag,
168
- hasParents,
169
- hasChildren,
170
- columnCount,
171
- columnHeight,
172
- isDark,
173
- newCllExperience: newCllExperienceProp,
174
- isImpacted: isImpactedProp,
175
- isWholeModelChanged,
176
- isWholeModelImpacted,
177
- wholeModelImpact,
178
- onNodeClick,
179
- onNodeDoubleClick,
180
- onSelect,
181
- onContextMenu
182
- }: LineageNodeProps): import("react/jsx-runtime").JSX.Element;
183
- declare const LineageNode: import("react").MemoExoticComponent<typeof LineageNodeComponent>;
184
- //#endregion
185
- //#region src/components/lineage/edges/LineageEdge.d.ts
186
- type EdgeChangeStatus = "added" | "removed" | "modified" | "unchanged";
187
- interface LineageEdgeData extends Record<string, unknown> {
188
- /** Change status for diff visualization */
189
- changeStatus?: EdgeChangeStatus;
190
- /** Whether this edge is highlighted */
191
- isHighlighted?: boolean;
192
- /** Label to display on edge */
193
- label?: string;
194
- }
195
- type LineageEdgeType = Edge<LineageEdgeData>;
196
- type LineageEdgeProps = EdgeProps<LineageEdgeType>;
197
- declare function LineageEdgeComponent({
198
- id,
199
- sourceX,
200
- sourceY,
201
- targetX,
202
- targetY,
203
- sourcePosition,
204
- targetPosition,
205
- data,
206
- selected
207
- }: LineageEdgeProps): import("react/jsx-runtime").JSX.Element;
208
- declare const LineageEdge: import("react").MemoExoticComponent<typeof LineageEdgeComponent>;
209
- //#endregion
210
- //#region src/components/lineage/LineageView.d.ts
211
- /**
212
- * Props for the LineageView component.
213
- * Defines options for viewing lineage diff data.
214
- */
215
- interface LineageViewProps {
216
- /**
217
- * Optional lineage graph data. If not provided, uses LineageGraphContext.
218
- */
219
- lineageGraph?: LineageGraph;
220
- /**
221
- * View options for lineage diff visualization
222
- */
223
- viewOptions?: {
224
- view_mode?: "changed_models" | "all";
225
- node_ids?: string[];
226
- select?: string;
227
- exclude?: string;
228
- packages?: string[];
229
- column_level_lineage?: {
230
- node_id?: string;
231
- column?: string;
232
- change_analysis?: boolean;
233
- };
234
- };
235
- /**
236
- * Whether the view allows user interaction
237
- * @default true
238
- */
239
- interactive?: boolean;
240
- /**
241
- * Optional height for the view
242
- * @default 600
243
- */
244
- height?: number | string;
245
- /**
246
- * Optional filter function for nodes
247
- */
248
- filterNodes?: (key: string, node: LineageGraphNode) => boolean;
249
- /**
250
- * Callback when a node is selected
251
- */
252
- onNodeSelect?: (nodeId: string | null) => void;
253
- /**
254
- * Callback when a node is double-clicked
255
- */
256
- onNodeDoubleClick?: (nodeId: string) => void;
257
- /**
258
- * Optional dagre instance for layout.
259
- * If not provided, nodes will be positioned at (0,0).
260
- * Install @dagrejs/dagre and pass the imported module.
261
- */
262
- dagre?: any;
263
- /**
264
- * Whether to show the minimap
265
- * @default true
266
- */
267
- showMiniMap?: boolean;
268
- /**
269
- * Whether to show the controls
270
- * @default true
271
- */
272
- showControls?: boolean;
273
- /**
274
- * Whether to show the background grid
275
- * @default true
276
- */
277
- showBackground?: boolean;
278
- }
279
- /**
280
- * Ref interface for LineageView component.
281
- * Provides methods to interact with the LineageView programmatically.
282
- */
283
- interface LineageViewRef {
284
- /**
285
- * Copies the current lineage view as an image to the clipboard
286
- */
287
- copyToClipboard: () => Promise<void>;
288
- }
289
- /**
290
- * LineageView Component
291
- *
292
- * A high-level component for visualizing data lineage graphs using React Flow.
293
- * Shows relationships between models and their change status.
294
- *
295
- * Can receive data from:
296
- * 1. LineageGraphContext (wrap with LineageGraphProvider)
297
- * 2. Direct prop (pass lineageGraph prop)
298
- *
299
- * For auto-layout, provide a dagre instance:
300
- *
301
- * @example Using with context
302
- * ```tsx
303
- * import { LineageGraphProvider, LineageView } from '@datarecce/ui';
304
- * import dagre from '@dagrejs/dagre';
305
- *
306
- * function App() {
307
- * return (
308
- * <LineageGraphProvider serverInfo={serverInfo}>
309
- * <LineageView dagre={dagre} />
310
- * </LineageGraphProvider>
311
- * );
312
- * }
313
- * ```
314
- *
315
- * @example Using with direct data
316
- * ```tsx
317
- * import { buildLineageGraph, LineageView } from '@datarecce/ui';
318
- * import dagre from '@dagrejs/dagre';
319
- *
320
- * function App({ serverInfo }) {
321
- * const lineageGraph = buildLineageGraph(
322
- * serverInfo.lineage.base,
323
- * serverInfo.lineage.current,
324
- * serverInfo.lineage.diff
325
- * );
326
- *
327
- * return <LineageView lineageGraph={lineageGraph} dagre={dagre} />;
328
- * }
329
- * ```
330
- */
331
- declare const LineageView: import("react").ForwardRefExoticComponent<LineageViewProps & import("react").RefAttributes<LineageViewRef>>;
332
- //#endregion
333
- //#region src/components/check/CheckActions.d.ts
334
- /**
335
- * Action types available for checks
336
- */
337
- type CheckActionType = "run" | "approve" | "edit" | "delete" | "duplicate" | "copy" | "preset";
338
- /**
339
- * Configuration for a check action
340
- */
341
- interface CheckAction {
342
- /** Action type identifier */
343
- type: CheckActionType;
344
- /** Display label */
345
- label: string;
346
- /** Icon element (optional) */
347
- icon?: React.ReactNode;
348
- /** Whether the action is disabled */
349
- disabled?: boolean;
350
- /** Tooltip for disabled state */
351
- disabledTooltip?: string;
352
- /** Whether this is a destructive action (shown in red) */
353
- destructive?: boolean;
354
- }
355
- /**
356
- * Props for the CheckActions component
357
- */
358
- interface CheckActionsProps {
359
- /** ID of the check these actions are for */
360
- checkId: string;
361
- /** List of primary actions (shown as buttons) */
362
- primaryActions?: CheckAction[];
363
- /** List of secondary actions (shown in dropdown menu) */
364
- secondaryActions?: CheckAction[];
365
- /** Callback when an action is triggered */
366
- onAction?: (checkId: string, actionType: CheckActionType) => void;
367
- /** Render variant */
368
- variant?: "buttons" | "menu" | "combined";
369
- /** Size of buttons */
370
- size?: "small" | "medium";
371
- /** Icon for menu trigger button */
372
- menuIcon?: React.ReactNode;
373
- /** Optional CSS class name */
374
- className?: string;
375
- }
376
- /**
377
- * CheckActions Component
378
- *
379
- * A pure presentation component for displaying action buttons/menu for a check.
380
- * Supports primary actions as buttons and secondary actions in a dropdown menu.
381
- *
382
- * @example Basic usage with buttons
383
- * ```tsx
384
- * import { CheckActions } from '@datarecce/ui/primitives';
385
- *
386
- * <CheckActions
387
- * checkId={check.id}
388
- * primaryActions={[
389
- * { type: 'run', label: 'Run' },
390
- * { type: 'approve', label: 'Approve' },
391
- * ]}
392
- * onAction={(id, action) => handleAction(id, action)}
393
- * />
394
- * ```
395
- *
396
- * @example Combined buttons and menu
397
- * ```tsx
398
- * <CheckActions
399
- * checkId={check.id}
400
- * variant="combined"
401
- * primaryActions={[
402
- * { type: 'run', label: 'Run', icon: <PlayIcon /> },
403
- * ]}
404
- * secondaryActions={[
405
- * { type: 'duplicate', label: 'Duplicate' },
406
- * { type: 'copy', label: 'Copy Markdown' },
407
- * { type: 'delete', label: 'Delete', destructive: true },
408
- * ]}
409
- * onAction={(id, action) => handleAction(id, action)}
410
- * />
411
- * ```
412
- *
413
- * @example Menu only
414
- * ```tsx
415
- * <CheckActions
416
- * checkId={check.id}
417
- * variant="menu"
418
- * secondaryActions={allActions}
419
- * onAction={(id, action) => handleAction(id, action)}
420
- * />
421
- * ```
422
- */
423
- declare function CheckActionsComponent({
424
- checkId,
425
- primaryActions,
426
- secondaryActions,
427
- onAction,
428
- variant,
429
- size,
430
- menuIcon,
431
- className
432
- }: CheckActionsProps): import("react/jsx-runtime").JSX.Element;
433
- declare const CheckActions: import("react").MemoExoticComponent<typeof CheckActionsComponent>;
434
- //#endregion
435
- //#region src/components/check/CheckCard.d.ts
436
- /**
437
- * Check type categories for icon display
438
- */
439
- type CheckType = "query" | "query_base" | "query_diff" | "schema_diff" | "lineage_diff" | "profile" | "profile_diff" | "row_count" | "row_count_diff" | "value_diff" | "histogram_diff" | "top_k_diff" | "simple";
440
- /**
441
- * Status of a check run
442
- */
443
- type CheckRunStatus = "pending" | "running" | "success" | "error";
444
- /**
445
- * Data structure for check display
446
- */
447
- interface CheckCardData {
448
- /** Unique check identifier */
449
- id: string;
450
- /** Display name of the check */
451
- name: string;
452
- /** Type of check for icon display */
453
- type: CheckType;
454
- /** Whether the check is approved */
455
- isApproved?: boolean;
456
- /** Run status of the check */
457
- runStatus?: CheckRunStatus;
458
- /** Whether the check is a preset */
459
- isPreset?: boolean;
460
- /**
461
- * Whether the check result is outdated because the dbt project/manifest
462
- * (code or artifacts) has changed since the last run.
463
- */
464
- isOutdated?: boolean;
465
- /**
466
- * ISO timestamp of the last check run used to determine staleness when the
467
- * dbt manifest or related artifacts are regenerated (shown in outdated tooltip).
468
- */
469
- lastRunAt?: string;
470
- /** Who created this check: "recce_ai" | "user" | "preset_system" */
471
- actorType?: string;
472
- }
473
- /**
474
- * Props for the CheckCard component
475
- */
476
- interface CheckCardProps {
477
- /** Check data to display */
478
- check: CheckCardData;
479
- /** Whether this card is currently selected */
480
- isSelected?: boolean;
481
- /** Callback when card is clicked */
482
- onClick?: (checkId: string) => void;
483
- /** Callback when approval checkbox is toggled */
484
- onApprovalChange?: (checkId: string, isApproved: boolean) => void;
485
- /** Whether approval checkbox is disabled */
486
- disableApproval?: boolean;
487
- /** Tooltip text for disabled approval */
488
- disabledApprovalTooltip?: string;
489
- /** Whether the entire card is disabled */
490
- disabled?: boolean;
491
- /** Optional CSS class name */
492
- className?: string;
493
- }
494
- /**
495
- * CheckCard Component
496
- *
497
- * A pure presentation component for displaying a single check in a list.
498
- * Shows check type icon, name, approval status, and run status.
499
- *
500
- * @example Basic usage
501
- * ```tsx
502
- * import { CheckCard } from '@datarecce/ui/primitives';
503
- *
504
- * function CheckListItem({ check }) {
505
- * return (
506
- * <CheckCard
507
- * check={{
508
- * id: check.check_id,
509
- * name: check.name,
510
- * type: check.type,
511
- * isApproved: check.is_checked,
512
- * }}
513
- * isSelected={selectedId === check.check_id}
514
- * onClick={(id) => setSelectedId(id)}
515
- * onApprovalChange={(id, approved) => updateCheck(id, { is_checked: approved })}
516
- * />
517
- * );
518
- * }
519
- * ```
520
- *
521
- * @example Disabled state
522
- * ```tsx
523
- * <CheckCard
524
- * check={check}
525
- * disableApproval
526
- * disabledApprovalTooltip="Run the check first to enable approval"
527
- * />
528
- * ```
529
- */
530
- declare function CheckCardComponent({
531
- check,
532
- isSelected,
533
- onClick,
534
- onApprovalChange,
535
- disableApproval,
536
- disabledApprovalTooltip,
537
- disabled,
538
- className
539
- }: CheckCardProps): import("react/jsx-runtime").JSX.Element;
540
- declare const CheckCard: import("react").MemoExoticComponent<typeof CheckCardComponent>;
541
- //#endregion
542
- //#region src/components/check/CheckDescription.d.ts
543
- /**
544
- * Props for the CheckDescription component
545
- */
546
- interface CheckDescriptionProps {
547
- /** Current description value */
548
- value?: string;
549
- /** Callback when description is saved */
550
- onChange?: (value?: string) => void;
551
- /** Placeholder text when empty */
552
- placeholder?: string;
553
- /** Whether editing is disabled */
554
- disabled?: boolean;
555
- /** Optional CSS class name */
556
- className?: string;
557
- }
558
- /**
559
- * CheckDescription Component
560
- *
561
- * A pure presentation component for displaying and editing check descriptions.
562
- * Supports click-to-edit with Cmd+Enter (Mac) or Ctrl+Enter (Windows) to save.
563
- *
564
- * @example Basic usage
565
- * ```tsx
566
- * import { CheckDescription } from '@datarecce/ui/primitives';
567
- *
568
- * function CheckDetail({ check }) {
569
- * return (
570
- * <CheckDescription
571
- * value={check.description}
572
- * onChange={(desc) => updateCheck(check.id, { description: desc })}
573
- * placeholder="Add a description..."
574
- * />
575
- * );
576
- * }
577
- * ```
578
- *
579
- * @example Disabled state
580
- * ```tsx
581
- * <CheckDescription
582
- * value={check.description}
583
- * disabled
584
- * placeholder="Description not available"
585
- * />
586
- * ```
587
- */
588
- declare function CheckDescriptionComponent({
589
- value,
590
- onChange,
591
- placeholder,
592
- disabled,
593
- className
594
- }: CheckDescriptionProps): import("react/jsx-runtime").JSX.Element;
595
- declare const CheckDescription: import("react").MemoExoticComponent<typeof CheckDescriptionComponent>;
596
- //#endregion
597
- //#region src/components/check/CheckDetail.d.ts
598
- /**
599
- * Tab configuration for CheckDetail
600
- */
601
- interface CheckDetailTab {
602
- /** Unique tab identifier */
603
- id: string;
604
- /** Tab label */
605
- label: string;
606
- /** Tab content */
607
- content: ReactNode;
608
- }
609
- /**
610
- * Props for the CheckDetail component
611
- */
612
- interface CheckDetailProps {
613
- /** Check ID */
614
- checkId: string;
615
- /** Check name (displayed as header) */
616
- name: string;
617
- /** Check type for display */
618
- type: string;
619
- /** Check description */
620
- description?: string;
621
- /** Whether the check is approved */
622
- isApproved?: boolean;
623
- /** Tabs to display (result, query, etc.) */
624
- tabs?: CheckDetailTab[];
625
- /** Default selected tab ID */
626
- defaultTab?: string;
627
- /** Primary actions for the check */
628
- primaryActions?: CheckAction[];
629
- /** Secondary actions for the check */
630
- secondaryActions?: CheckAction[];
631
- /** Callback when an action is triggered */
632
- onAction?: (checkId: string, actionType: CheckActionType) => void;
633
- /** Callback when description changes */
634
- onDescriptionChange?: (description?: string) => void;
635
- /** Callback when name changes */
636
- onNameChange?: (name: string) => void;
637
- /** Whether editing is disabled */
638
- disabled?: boolean;
639
- /** Optional header content (breadcrumbs, etc.) */
640
- headerContent?: ReactNode;
641
- /** Optional sidebar content */
642
- sidebarContent?: ReactNode;
643
- /** Optional CSS class name */
644
- className?: string;
645
- }
646
- /**
647
- * CheckDetail Component
648
- *
649
- * A pure presentation component for displaying detailed information
650
- * about a single check with tabs, actions, and editable fields.
651
- *
652
- * @example Basic usage
653
- * ```tsx
654
- * import { CheckDetail } from '@datarecce/ui/primitives';
655
- *
656
- * function CheckPage({ check, run }) {
657
- * return (
658
- * <CheckDetail
659
- * checkId={check.id}
660
- * name={check.name}
661
- * type={check.type}
662
- * description={check.description}
663
- * isApproved={check.is_checked}
664
- * tabs={[
665
- * { id: 'result', label: 'Result', content: <ResultView run={run} /> },
666
- * { id: 'query', label: 'Query', content: <QueryView sql={check.params.sql} /> },
667
- * ]}
668
- * primaryActions={[
669
- * { type: 'run', label: 'Run' },
670
- * { type: 'approve', label: check.is_checked ? 'Approved' : 'Pending' },
671
- * ]}
672
- * secondaryActions={[
673
- * { type: 'delete', label: 'Delete', destructive: true },
674
- * ]}
675
- * onAction={(id, action) => handleAction(id, action)}
676
- * onDescriptionChange={(desc) => updateCheck(id, { description: desc })}
677
- * />
678
- * );
679
- * }
680
- * ```
681
- *
682
- * @example With sidebar
683
- * ```tsx
684
- * <CheckDetail
685
- * {...props}
686
- * sidebarContent={<CheckTimeline checkId={check.id} />}
687
- * />
688
- * ```
689
- */
690
- declare function CheckDetailComponent({
691
- checkId,
692
- name,
693
- type,
694
- description,
695
- isApproved,
696
- tabs,
697
- defaultTab,
698
- primaryActions,
699
- secondaryActions,
700
- onAction,
701
- onDescriptionChange,
702
- onNameChange,
703
- disabled,
704
- headerContent,
705
- sidebarContent,
706
- className
707
- }: CheckDetailProps): import("react/jsx-runtime").JSX.Element;
708
- declare const CheckDetail: import("react").MemoExoticComponent<typeof CheckDetailComponent>;
709
- //#endregion
710
- //#region src/components/check/CheckEmptyState.d.ts
711
- /**
712
- * Props for the CheckEmptyState component
713
- */
714
- interface CheckEmptyStateProps {
715
- /** Main title text */
716
- title?: string;
717
- /** Description text */
718
- description?: string;
719
- /** Icon element to display */
720
- icon?: ReactNode;
721
- /** Primary action button text */
722
- actionText?: string;
723
- /** Callback when primary action is clicked */
724
- onAction?: () => void;
725
- /** Whether the action is loading */
726
- isLoading?: boolean;
727
- /** Optional helper text below the action */
728
- helperText?: string;
729
- /** Optional CSS class name */
730
- className?: string;
731
- }
732
- /**
733
- * CheckEmptyState Component
734
- *
735
- * A pure presentation component for displaying an empty state
736
- * when no checks exist in the list.
737
- *
738
- * @example Basic usage
739
- * ```tsx
740
- * import { CheckEmptyState } from '@datarecce/ui/primitives';
741
- *
742
- * function MyCheckList() {
743
- * if (checks.length === 0) {
744
- * return (
745
- * <CheckEmptyState
746
- * title="No checks yet"
747
- * description="Create your first check to start validating data"
748
- * actionText="Create Schema Diff Check"
749
- * onAction={() => createSchemaDiffCheck()}
750
- * />
751
- * );
752
- * }
753
- * return <CheckList checks={checks} />;
754
- * }
755
- * ```
756
- *
757
- * @example Custom icon
758
- * ```tsx
759
- * import { TbChecklist } from 'react-icons/tb';
760
- *
761
- * <CheckEmptyState
762
- * icon={<TbChecklist size={48} />}
763
- * title="No checks found"
764
- * description="Checks help you validate your data changes"
765
- * />
766
- * ```
767
- */
768
- declare function CheckEmptyStateComponent({
769
- title,
770
- description,
771
- icon,
772
- actionText,
773
- onAction,
774
- isLoading,
775
- helperText,
776
- className
777
- }: CheckEmptyStateProps): import("react/jsx-runtime").JSX.Element;
778
- declare const CheckEmptyState: import("react").MemoExoticComponent<typeof CheckEmptyStateComponent>;
779
- //#endregion
780
- //#region src/components/check/CheckList.d.ts
781
- /**
782
- * Props for the CheckList component
783
- */
784
- interface CheckListProps {
785
- /** Array of checks to display */
786
- checks: CheckCardData[];
787
- /** Currently selected check ID */
788
- selectedId?: string | null;
789
- /** Callback when a check is selected */
790
- onCheckSelect?: (checkId: string) => void;
791
- /** Callback when check approval status changes */
792
- onApprovalChange?: (checkId: string, isApproved: boolean) => void;
793
- /** Callback when checks are reordered (for drag-drop implementations) */
794
- onReorder?: (sourceIndex: number, destinationIndex: number) => void;
795
- /** Whether approval is disabled for all checks */
796
- disableApproval?: boolean;
797
- /** Tooltip for disabled approval */
798
- disabledApprovalTooltip?: string;
799
- /** Optional title for the list */
800
- title?: string;
801
- /** Optional CSS class name */
802
- className?: string;
803
- /** Whether the list is loading */
804
- isLoading?: boolean;
805
- /** Content to show when list is empty */
806
- emptyContent?: React.ReactNode;
807
- }
808
- /**
809
- * CheckList Component
810
- *
811
- * A pure presentation component for displaying a list of checks.
812
- * This component does not include drag-and-drop functionality -
813
- * implement that at the consumer level if needed.
814
- *
815
- * @example Basic usage
816
- * ```tsx
817
- * import { CheckList } from '@datarecce/ui/primitives';
818
- *
819
- * function MyCheckList({ checks }) {
820
- * const [selectedId, setSelectedId] = useState(null);
821
- *
822
- * return (
823
- * <CheckList
824
- * checks={checks.map(c => ({
825
- * id: c.check_id,
826
- * name: c.name,
827
- * type: c.type,
828
- * isApproved: c.is_checked,
829
- * }))}
830
- * selectedId={selectedId}
831
- * onCheckSelect={setSelectedId}
832
- * onApprovalChange={(id, approved) => updateCheck(id, approved)}
833
- * />
834
- * );
835
- * }
836
- * ```
837
- *
838
- * @example With empty state
839
- * ```tsx
840
- * <CheckList
841
- * checks={[]}
842
- * emptyContent={<CheckEmptyState onCreateFirst={() => createCheck()} />}
843
- * />
844
- * ```
845
- */
846
- declare function CheckListComponent({
847
- checks,
848
- selectedId,
849
- onCheckSelect,
850
- onApprovalChange,
851
- disableApproval,
852
- disabledApprovalTooltip,
853
- title,
854
- className,
855
- isLoading,
856
- emptyContent
857
- }: CheckListProps): import("react/jsx-runtime").JSX.Element;
858
- declare const CheckList: import("react").MemoExoticComponent<typeof CheckListComponent>;
859
- //#endregion
860
- //#region src/components/lineage/columns/LineageColumnNode.d.ts
861
- /**
862
- * Transformation type for column-level lineage
863
- */
864
- type ColumnTransformationType = "passthrough" | "renamed" | "derived" | "source" | "unknown";
865
- /**
866
- * Column change status for diff views
867
- */
868
- type ColumnChangeStatus = "added" | "removed" | "modified";
869
- /**
870
- * Data structure for a column node
871
- */
872
- interface LineageColumnNodeData extends Record<string, unknown> {
873
- /** Column name */
874
- column: string;
875
- /** Column data type (e.g., "VARCHAR", "INTEGER") */
876
- type?: string;
877
- /** ID of the parent model/table node */
878
- nodeId: string;
879
- /** Transformation type for this column */
880
- transformationType?: ColumnTransformationType;
881
- /** Change status for diff views */
882
- changeStatus?: ColumnChangeStatus;
883
- /** Whether the column is highlighted */
884
- isHighlighted?: boolean;
885
- /** Whether the column is selected/focused */
886
- isFocused?: boolean;
887
- /** Whether this column is impacted (new CLL experience) */
888
- isImpacted?: boolean;
889
- /** Whether to use the new CLL experience palette (muted bg + left accent) */
890
- newCllExperience?: boolean;
891
- }
892
- /**
893
- * Props for the LineageColumnNode component
894
- */
895
- interface LineageColumnNodeProps {
896
- /** Unique node ID */
897
- id: string;
898
- /** Node data */
899
- data: LineageColumnNodeData;
900
- /** Whether the node is selected */
901
- selected?: boolean;
902
- /**
903
- * Whether to show content (used for zoom-level visibility)
904
- * When false, the node renders nothing (hidden at low zoom levels)
905
- * @default true
906
- */
907
- showContent?: boolean;
908
- /**
909
- * Whether to show change analysis mode
910
- * When true and changeStatus exists, shows change status indicator
911
- * When false, shows transformation type indicator
912
- * @default false
913
- */
914
- showChangeAnalysis?: boolean;
915
- /**
916
- * Whether to use dark mode styling
917
- * @default false
918
- */
919
- isDark?: boolean;
920
- /**
921
- * Whether to use the new CLL experience palette (muted bg + left accent
922
- * for changed columns, dark hex fallbacks). When false, renders the
923
- * original behavior: only `isImpacted` triggers a tinted bg.
924
- * Falls back to `data.newCllExperience` when prop is omitted.
925
- * @default false
926
- */
927
- newCllExperience?: boolean;
928
- /** Callback when column is clicked */
929
- onColumnClick?: (columnId: string) => void;
930
- /**
931
- * Callback when context menu is requested (kebab menu click)
932
- * When provided, shows kebab menu on hover
933
- */
934
- onContextMenu?: (event: MouseEvent, columnId: string) => void;
935
- }
936
- /**
937
- * Default column height in pixels
938
- */
939
- declare const COLUMN_NODE_HEIGHT = 24;
940
- /**
941
- * Default column width in pixels
942
- */
943
- declare const COLUMN_NODE_WIDTH = 280;
944
- /**
945
- * LineageColumnNode Component
946
- *
947
- * A pure presentation component for rendering individual columns
948
- * in column-level lineage visualizations using React Flow.
949
- *
950
- * @example Basic usage
951
- * ```tsx
952
- * import { LineageColumnNode } from '@datarecce/ui/primitives';
953
- *
954
- * // Register as a React Flow node type
955
- * const nodeTypes = {
956
- * columnNode: LineageColumnNode,
957
- * };
958
- *
959
- * function ColumnLineageGraph() {
960
- * return (
961
- * <ReactFlow nodes={columnNodes} edges={edges} nodeTypes={nodeTypes} />
962
- * );
963
- * }
964
- * ```
965
- *
966
- * @example Node data structure
967
- * ```tsx
968
- * const columnNode = {
969
- * id: 'users-id',
970
- * type: 'columnNode',
971
- * data: {
972
- * column: 'id',
973
- * type: 'INTEGER',
974
- * nodeId: 'users',
975
- * transformationType: 'passthrough',
976
- * changeStatus: undefined,
977
- * isHighlighted: true,
978
- * },
979
- * position: { x: 0, y: 0 },
980
- * };
981
- * ```
982
- *
983
- * @example With change analysis mode
984
- * ```tsx
985
- * // In change analysis mode, shows change status instead of transformation type
986
- * <LineageColumnNode
987
- * showChangeAnalysis={true}
988
- * showContent={zoomLevel > 0.3}
989
- * onContextMenu={(e, columnId) => showMenu(e, columnId)}
990
- * />
991
- * ```
992
- */
993
- declare function LineageColumnNodeComponent({
994
- id,
995
- data,
996
- showContent,
997
- showChangeAnalysis,
998
- isDark,
999
- newCllExperience: newCllExperienceProp,
1000
- onColumnClick,
1001
- onContextMenu
1002
- }: LineageColumnNodeProps): import("react/jsx-runtime").JSX.Element | null;
1003
- declare const LineageColumnNode: import("react").MemoExoticComponent<typeof LineageColumnNodeComponent>;
1004
- //#endregion
1005
- //#region src/components/lineage/legend/LineageLegend.d.ts
1006
- /**
1007
- * Legend item for change status
1008
- */
1009
- interface ChangeStatusLegendItem {
1010
- status: "added" | "removed" | "modified" | "impacted";
1011
- label: string;
1012
- description?: string;
1013
- }
1014
- /**
1015
- * Legend item for transformation type
1016
- */
1017
- interface TransformationLegendItem {
1018
- type: "passthrough" | "renamed" | "derived" | "source" | "unknown";
1019
- label: string;
1020
- description?: string;
1021
- }
1022
- /**
1023
- * Props for the LineageLegend component
1024
- */
1025
- interface LineageLegendProps {
1026
- /**
1027
- * Type of legend to display
1028
- */
1029
- variant: "changeStatus" | "transformation";
1030
- /**
1031
- * Whether to show tooltips on hover
1032
- * @default true
1033
- */
1034
- showTooltips?: boolean;
1035
- /**
1036
- * Optional title for the legend
1037
- */
1038
- title?: string;
1039
- /**
1040
- * CSS class name for additional styling
1041
- */
1042
- className?: string;
1043
- /**
1044
- * When true, render the muted CLL palette and include the "Impacted" entry.
1045
- * When false (default), render the original Tailwind palette and omit
1046
- * "Impacted" — matching the legend OSS users have always seen.
1047
- * @default false
1048
- */
1049
- newCllExperience?: boolean;
1050
- }
1051
- /**
1052
- * LineageLegend Component
1053
- *
1054
- * A pure presentation component for displaying legends in lineage visualizations.
1055
- * Supports both change status legends (added/removed/modified) and
1056
- * transformation type legends (passthrough/renamed/derived/source/unknown).
1057
- *
1058
- * @example Change status legend
1059
- * ```tsx
1060
- * import { LineageLegend } from '@datarecce/ui/primitives';
1061
- *
1062
- * function MyLineageGraph() {
1063
- * return (
1064
- * <div style={{ position: 'relative' }}>
1065
- * <ReactFlow nodes={nodes} edges={edges} />
1066
- * <div style={{ position: 'absolute', bottom: 10, right: 10 }}>
1067
- * <LineageLegend variant="changeStatus" title="Changes" />
1068
- * </div>
1069
- * </div>
1070
- * );
1071
- * }
1072
- * ```
1073
- *
1074
- * @example Transformation type legend
1075
- * ```tsx
1076
- * import { LineageLegend } from '@datarecce/ui/primitives';
1077
- *
1078
- * function ColumnLineageGraph() {
1079
- * return (
1080
- * <div>
1081
- * <ReactFlow nodes={columnNodes} edges={edges} />
1082
- * <LineageLegend variant="transformation" />
1083
- * </div>
1084
- * );
1085
- * }
1086
- * ```
1087
- */
1088
- declare function LineageLegend({
1089
- variant,
1090
- showTooltips,
1091
- title,
1092
- className,
1093
- newCllExperience
1094
- }: LineageLegendProps): import("react/jsx-runtime").JSX.Element;
1095
- //#endregion
1096
- //#region src/components/data/HistogramChart.d.ts
1097
- /**
1098
- * Histogram dataset for a single environment
1099
- */
1100
- interface HistogramDataset {
1101
- /** Count values per bin */
1102
- counts: number[];
1103
- /** Optional dataset label */
1104
- label?: string;
1105
- }
1106
- /**
1107
- * Histogram data type
1108
- */
1109
- type HistogramDataType = "numeric" | "datetime" | "string";
1110
- /**
1111
- * Props for the HistogramChart component
1112
- */
1113
- interface HistogramChartProps {
1114
- /** Chart title */
1115
- title: string;
1116
- /** Data type (numeric, datetime, or string) */
1117
- dataType?: HistogramDataType;
1118
- /** Total sample count */
1119
- samples?: number;
1120
- /** Minimum value (for datetime scale) */
1121
- min?: string | number;
1122
- /** Maximum value (for datetime scale) */
1123
- max?: string | number;
1124
- /** Bin edge values */
1125
- binEdges: number[];
1126
- /** Base environment dataset */
1127
- baseData: HistogramDataset;
1128
- /** Current environment dataset */
1129
- currentData: HistogramDataset;
1130
- /** Enable animation */
1131
- animate?: boolean;
1132
- /** Hide axis labels and ticks */
1133
- hideAxis?: boolean;
1134
- /** Theme mode */
1135
- theme?: "light" | "dark";
1136
- /** Chart height in pixels */
1137
- height?: number;
1138
- /** Optional CSS class */
1139
- className?: string;
1140
- }
1141
- /**
1142
- * HistogramChart Component
1143
- *
1144
- * A pure presentation component for displaying histogram charts comparing
1145
- * base and current data distributions using Chart.js.
1146
- *
1147
- * @example Basic usage
1148
- * ```tsx
1149
- * import { HistogramChart } from '@datarecce/ui/primitives';
1150
- *
1151
- * function ProfilePanel({ histogramData }) {
1152
- * return (
1153
- * <HistogramChart
1154
- * title="Age Distribution"
1155
- * dataType="numeric"
1156
- * binEdges={histogramData.binEdges}
1157
- * baseData={{ counts: histogramData.baseCounts }}
1158
- * currentData={{ counts: histogramData.currentCounts }}
1159
- * samples={1000}
1160
- * />
1161
- * );
1162
- * }
1163
- * ```
1164
- *
1165
- * @example With datetime scale
1166
- * ```tsx
1167
- * <HistogramChart
1168
- * title="Events Over Time"
1169
- * dataType="datetime"
1170
- * binEdges={timestamps}
1171
- * baseData={{ counts: baseCounts }}
1172
- * currentData={{ counts: currentCounts }}
1173
- * min={startDate}
1174
- * max={endDate}
1175
- * />
1176
- * ```
1177
- */
1178
- declare function HistogramChartComponent({
1179
- title,
1180
- dataType,
1181
- samples,
1182
- min,
1183
- max,
1184
- binEdges,
1185
- baseData,
1186
- currentData,
1187
- animate,
1188
- hideAxis,
1189
- theme,
1190
- height,
1191
- className
1192
- }: HistogramChartProps): import("react/jsx-runtime").JSX.Element;
1193
- declare const HistogramChart: import("react").MemoExoticComponent<typeof HistogramChartComponent>;
1194
- //#endregion
1195
- //#region src/components/data/TopKBarChart.d.ts
1196
- /**
1197
- * Single Top-K value item
1198
- */
1199
- interface TopKItem {
1200
- /** Value label */
1201
- label: string;
1202
- /** Count */
1203
- count: number;
1204
- /** Whether this is a special label (null, empty, others) */
1205
- isSpecial?: boolean;
1206
- }
1207
- /**
1208
- * Top-K dataset for a single environment
1209
- * Compatible with TopKResult from @datarecce/ui/api
1210
- */
1211
- interface TopKDataset {
1212
- /** Value labels (null or undefined treated as special) */
1213
- values: (string | number | null | undefined)[];
1214
- /** Counts per value */
1215
- counts: number[];
1216
- /** Total valid count */
1217
- valids: number;
1218
- }
1219
- /**
1220
- * Props for the TopKBarChart component
1221
- */
1222
- interface TopKBarChartProps {
1223
- /** Base environment dataset */
1224
- baseData?: TopKDataset;
1225
- /** Current environment dataset */
1226
- currentData: TopKDataset;
1227
- /** Maximum items to display (default 10) */
1228
- maxItems?: number;
1229
- /** Show comparison with base */
1230
- showComparison?: boolean;
1231
- /** Theme mode */
1232
- theme?: "light" | "dark";
1233
- /** Chart title */
1234
- title?: string;
1235
- /** Optional CSS class */
1236
- className?: string;
1237
- }
1238
- /**
1239
- * TopKBarChart Component
1240
- *
1241
- * A pure presentation component for displaying top-k value distributions
1242
- * with optional base/current comparison.
1243
- *
1244
- * @example Basic usage
1245
- * ```tsx
1246
- * import { TopKBarChart } from '@datarecce/ui/primitives';
1247
- *
1248
- * function ValueDistribution({ topKData }) {
1249
- * return (
1250
- * <TopKBarChart
1251
- * currentData={topKData}
1252
- * maxItems={10}
1253
- * />
1254
- * );
1255
- * }
1256
- * ```
1257
- *
1258
- * @example With comparison
1259
- * ```tsx
1260
- * <TopKBarChart
1261
- * baseData={baseTopK}
1262
- * currentData={currentTopK}
1263
- * showComparison
1264
- * maxItems={10}
1265
- * />
1266
- * ```
1267
- */
1268
- declare function TopKBarChartComponent({
1269
- baseData,
1270
- currentData,
1271
- maxItems,
1272
- showComparison,
1273
- theme,
1274
- title,
1275
- className
1276
- }: TopKBarChartProps): import("react/jsx-runtime").JSX.Element;
1277
- declare const TopKBarChart: import("react").MemoExoticComponent<typeof TopKBarChartComponent>;
1278
- //#endregion
1279
- //#region src/lib/dataGrid/generators/toSchemaDataGrid.d.ts
1280
- interface SchemaDiffRow extends RowObjectType {
1281
- name: string;
1282
- reordered?: boolean;
1283
- currentIndex?: number;
1284
- baseIndex?: number;
1285
- currentType?: string;
1286
- baseType?: string;
1287
- /** True when the column's SQL definition changed but name/type stayed the same */
1288
- definitionChanged?: boolean;
1289
- /**
1290
- * True when the analyzer couldn't determine the column's change status
1291
- * (e.g., CTE-internal column with missing parent schema). Mutually exclusive
1292
- * with definitionChanged.
1293
- */
1294
- changeUnknown?: boolean;
1295
- /** True when the column traces upstream to a changed column via CLL parent_map */
1296
- isImpacted?: boolean;
1297
- }
1298
- interface SchemaRow extends RowObjectType {
1299
- name: string;
1300
- index: number;
1301
- type?: string;
1302
- }
1303
- type SchemaDiff = Record<string, SchemaDiffRow>;
1304
- interface SchemaDataGridOptions {
1305
- /** Node data for context menu actions */
1306
- node?: NodeData;
1307
- /** Map of column names to CLL loading state */
1308
- cllRunningMap?: Map<string, boolean>;
1309
- /** Whether to show the column action menu (default: true) */
1310
- showMenu?: boolean;
1311
- /** Per-column change status from breaking change analysis */
1312
- columnChanges?: Record<string, "added" | "removed" | "modified" | "unknown"> | null;
1313
- /** Callback when user clicks a definition-changed badge to view SQL diff */
1314
- onViewCode?: () => void;
1315
- /** Set of impacted column IDs from CLL parent_map walk (e.g. "model.jaffle_shop.orders_STATUS") */
1316
- impactedColumns?: Set<string>;
1317
- /** Node unique_id, used to build column IDs for impacted lookup */
1318
- nodeId?: string;
1319
- }
1320
- interface SchemaDataGridResult {
1321
- columns: (ColDef<SchemaDiffRow> | ColGroupDef<SchemaDiffRow>)[];
1322
- rows: SchemaDiffRow[];
1323
- }
1324
- interface SingleEnvSchemaDataGridResult {
1325
- columns: (ColDef<SchemaRow> | ColGroupDef<SchemaRow>)[];
1326
- rows: SchemaRow[];
1327
- }
1328
- /**
1329
- * Merges base and current column schemas into a diff structure
1330
- */
1331
- declare function mergeColumns(baseColumns?: NodeData["columns"], currentColumns?: NodeData["columns"]): SchemaDiff;
1332
- /**
1333
- * Generates grid configuration for schema diff view
1334
- * Uses merged columns: Index (merged base/current), Name (with inline DataTypeIcon)
1335
- */
1336
- declare function toSchemaDataGrid(schemaDiff: SchemaDiff, options?: SchemaDataGridOptions): SchemaDataGridResult;
1337
- /**
1338
- * Generates grid configuration for single-environment schema view
1339
- */
1340
- declare function toSingleEnvDataGrid(nodeColumns?: NodeData["columns"], options?: SchemaDataGridOptions): SingleEnvSchemaDataGridResult;
1341
- //#endregion
1342
- //#region src/components/schema/types.d.ts
1343
- /**
1344
- * @file types.ts
1345
- * @description Schema diff types for comparing schemas between environments.
1346
- */
1347
- /**
1348
- * Schema diff row status
1349
- */
1350
- type SchemaDiffStatus = "added" | "removed" | "modified" | "unchanged";
1351
- //#endregion
1352
- //#region src/components/editor/DiffEditor.d.ts
1353
- /**
1354
- * Supported languages for the diff editor
1355
- */
1356
- type DiffEditorLanguage = "sql" | "yaml" | "text";
1357
- /**
1358
- * Theme options for the diff editor
1359
- */
1360
- type DiffEditorTheme = "light" | "dark";
1361
- /**
1362
- * Props for the DiffEditor component
1363
- */
1364
- interface DiffEditorProps {
1365
- /** Original (base) text content */
1366
- original: string;
1367
- /** Modified (current) text content */
1368
- modified: string;
1369
- /** Language for syntax highlighting */
1370
- language?: DiffEditorLanguage;
1371
- /** Whether editor is read-only */
1372
- readOnly?: boolean;
1373
- /** Show line numbers */
1374
- lineNumbers?: boolean;
1375
- /** Side-by-side view (true) or unified view (false) */
1376
- sideBySide?: boolean;
1377
- /** Editor height */
1378
- height?: string;
1379
- /** Theme mode */
1380
- theme?: DiffEditorTheme;
1381
- /** Callback when modified content changes */
1382
- onModifiedChange?: (value: string) => void;
1383
- /** Optional CSS class */
1384
- className?: string;
1385
- }
1386
- /**
1387
- * DiffEditor Component
1388
- *
1389
- * A pure presentation component for displaying text diffs using CodeMirror's
1390
- * merge view. Supports side-by-side and unified diff views.
1391
- *
1392
- * @example Basic usage
1393
- * ```tsx
1394
- * import { DiffEditor } from '@datarecce/ui/primitives';
1395
- *
1396
- * function SqlDiffPanel({ baseSql, currentSql }) {
1397
- * return (
1398
- * <DiffEditor
1399
- * original={baseSql}
1400
- * modified={currentSql}
1401
- * language="sql"
1402
- * sideBySide
1403
- * />
1404
- * );
1405
- * }
1406
- * ```
1407
- *
1408
- * @example Unified view with editing
1409
- * ```tsx
1410
- * const [modifiedSql, setModifiedSql] = useState(currentSql);
1411
- *
1412
- * <DiffEditor
1413
- * original={baseSql}
1414
- * modified={modifiedSql}
1415
- * language="sql"
1416
- * sideBySide={false}
1417
- * onModifiedChange={setModifiedSql}
1418
- * />
1419
- * ```
1420
- */
1421
- declare function DiffEditorComponent({
1422
- original,
1423
- modified,
1424
- language,
1425
- readOnly,
1426
- lineNumbers: showLineNumbers,
1427
- sideBySide,
1428
- height,
1429
- theme,
1430
- onModifiedChange,
1431
- className
1432
- }: DiffEditorProps): import("react/jsx-runtime").JSX.Element;
1433
- declare const DiffEditor: import("react").MemoExoticComponent<typeof DiffEditorComponent>;
1434
- //#endregion
1435
- //#region src/components/ui/EmptyState.d.ts
1436
- /**
1437
- * Props for the EmptyState component
1438
- */
1439
- interface EmptyStateProps {
1440
- /** Main title text */
1441
- title: string;
1442
- /** Description text */
1443
- description?: string;
1444
- /** Icon to display */
1445
- icon?: ReactNode;
1446
- /** Primary action button text */
1447
- actionLabel?: string;
1448
- /** Primary action callback */
1449
- onAction?: () => void;
1450
- /** Secondary action button text */
1451
- secondaryActionLabel?: string;
1452
- /** Secondary action callback */
1453
- onSecondaryAction?: () => void;
1454
- /** Theme mode */
1455
- theme?: "light" | "dark";
1456
- /** Vertical padding */
1457
- paddingY?: number;
1458
- /** Optional CSS class */
1459
- className?: string;
1460
- /** Additional content below actions */
1461
- children?: ReactNode;
1462
- }
1463
- /**
1464
- * EmptyState Component
1465
- *
1466
- * A pure presentation component for displaying empty states
1467
- * with optional icon, actions, and custom content.
1468
- *
1469
- * @example Basic usage
1470
- * ```tsx
1471
- * import { EmptyState } from '@datarecce/ui/primitives';
1472
- *
1473
- * function ChecksPanel({ checks }) {
1474
- * if (checks.length === 0) {
1475
- * return (
1476
- * <EmptyState
1477
- * title="No checks yet"
1478
- * description="Create your first check to get started"
1479
- * />
1480
- * );
1481
- * }
1482
- * // ... render checks
1483
- * }
1484
- * ```
1485
- *
1486
- * @example With action button
1487
- * ```tsx
1488
- * <EmptyState
1489
- * title="No results found"
1490
- * description="Try adjusting your search criteria"
1491
- * actionLabel="Clear Filters"
1492
- * onAction={() => clearFilters()}
1493
- * />
1494
- * ```
1495
- *
1496
- * @example With icon and multiple actions
1497
- * ```tsx
1498
- * <EmptyState
1499
- * icon={<FolderIcon />}
1500
- * title="No files"
1501
- * description="Upload files to get started"
1502
- * actionLabel="Upload File"
1503
- * onAction={handleUpload}
1504
- * secondaryActionLabel="Learn More"
1505
- * onSecondaryAction={() => window.open(docsUrl)}
1506
- * />
1507
- * ```
1508
- */
1509
- declare function EmptyStateComponent({
1510
- title,
1511
- description,
1512
- icon,
1513
- actionLabel,
1514
- onAction,
1515
- secondaryActionLabel,
1516
- onSecondaryAction,
1517
- theme,
1518
- paddingY,
1519
- className,
1520
- children
1521
- }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;
1522
- declare const EmptyState: import("react").MemoExoticComponent<typeof EmptyStateComponent>;
1523
- //#endregion
1524
- //#region src/components/ui/SplitPane.d.ts
1525
- /**
1526
- * Split direction
1527
- */
1528
- type SplitDirection = "horizontal" | "vertical";
1529
- /**
1530
- * Props for the SplitPane component
1531
- */
1532
- interface SplitPaneProps {
1533
- /** Child elements to split */
1534
- children: ReactNode;
1535
- /** Split direction */
1536
- direction?: SplitDirection;
1537
- /** Initial sizes as percentages (should sum to 100) */
1538
- sizes?: number[];
1539
- /** Minimum sizes in pixels */
1540
- minSizes?: number | number[];
1541
- /** Maximum sizes in pixels */
1542
- maxSizes?: number | number[];
1543
- /** Gutter (drag handle) size in pixels */
1544
- gutterSize?: number;
1545
- /** Snap to closed at this threshold (pixels) */
1546
- snapOffset?: number;
1547
- /** Allow dragging past minSize to collapse */
1548
- dragInterval?: number;
1549
- /** Callback when sizes change */
1550
- onDragEnd?: (sizes: number[]) => void;
1551
- /** Callback during drag */
1552
- onDrag?: (sizes: number[]) => void;
1553
- /** Theme mode */
1554
- theme?: "light" | "dark";
1555
- /** Container style */
1556
- style?: CSSProperties;
1557
- /** Optional CSS class */
1558
- className?: string;
1559
- }
1560
- /**
1561
- * SplitPane Component
1562
- *
1563
- * A pure presentation component for creating resizable split panes
1564
- * using react-split. Supports horizontal and vertical layouts.
1565
- *
1566
- * @example Horizontal split
1567
- * ```tsx
1568
- * import { SplitPane } from '@datarecce/ui/primitives';
1569
- *
1570
- * function TwoColumnLayout() {
1571
- * return (
1572
- * <SplitPane direction="horizontal" sizes={[30, 70]}>
1573
- * <div>Left Panel</div>
1574
- * <div>Right Panel</div>
1575
- * </SplitPane>
1576
- * );
1577
- * }
1578
- * ```
1579
- *
1580
- * @example Vertical split with min sizes
1581
- * ```tsx
1582
- * <SplitPane
1583
- * direction="vertical"
1584
- * sizes={[50, 50]}
1585
- * minSizes={[100, 100]}
1586
- * >
1587
- * <div>Top Panel</div>
1588
- * <div>Bottom Panel</div>
1589
- * </SplitPane>
1590
- * ```
1591
- *
1592
- * @example Three-way split with callbacks
1593
- * ```tsx
1594
- * <SplitPane
1595
- * direction="horizontal"
1596
- * sizes={[25, 50, 25]}
1597
- * onDragEnd={(sizes) => saveSizes(sizes)}
1598
- * >
1599
- * <div>Navigation</div>
1600
- * <div>Content</div>
1601
- * <div>Details</div>
1602
- * </SplitPane>
1603
- * ```
1604
- */
1605
- declare function SplitPaneComponent({
1606
- children,
1607
- direction,
1608
- sizes,
1609
- minSizes,
1610
- maxSizes,
1611
- gutterSize,
1612
- snapOffset,
1613
- dragInterval,
1614
- onDragEnd,
1615
- onDrag,
1616
- theme,
1617
- style,
1618
- className
1619
- }: SplitPaneProps): import("react/jsx-runtime").JSX.Element;
1620
- declare const SplitPane: import("react").MemoExoticComponent<typeof SplitPaneComponent>;
1621
- //#endregion
1622
- export { CheckActions as $, TransformationLegendItem as A, CheckEmptyStateProps as B, HistogramChart as C, ChangeStatusLegendItem as D, HistogramDataset as E, LineageColumnNodeData as F, CheckDescriptionProps as G, CheckDetailProps as H, LineageColumnNodeProps as I, CheckCardProps as J, CheckCard as K, CheckList as L, COLUMN_NODE_WIDTH as M, ColumnTransformationType as N, LineageLegend as O, LineageColumnNode as P, CheckActionType as Q, CheckListProps as R, TopKItem as S, HistogramDataType as T, CheckDetailTab as U, CheckDetail as V, CheckDescription as W, CheckType as X, CheckRunStatus as Y, CheckAction as Z, toSchemaDataGrid as _, EmptyStateProps as a, LineageEdge as at, TopKBarChartProps as b, DiffEditorProps as c, LineageNode as ct, SchemaDataGridOptions as d, NodeChangeStatus as dt, CheckActionsProps as et, SchemaDataGridResult as f, mergeColumns as g, SingleEnvSchemaDataGridResult as h, EmptyState as i, EdgeChangeStatus as it, COLUMN_NODE_HEIGHT as j, LineageLegendProps as k, DiffEditorTheme as l, LineageNodeData as lt, SchemaRow as m, SplitPane as n, LineageViewProps as nt, DiffEditor as o, LineageEdgeData as ot, SchemaDiffRow as p, CheckCardData as q, SplitPaneProps as r, LineageViewRef as rt, DiffEditorLanguage as s, LineageEdgeProps as st, SplitDirection as t, LineageView as tt, SchemaDiffStatus as u, LineageNodeProps as ut, toSingleEnvDataGrid as v, HistogramChartProps as w, TopKDataset as x, TopKBarChart as y, CheckEmptyState as z };
1623
- //# sourceMappingURL=SplitPane-DKjK6eiV.d.ts.map