@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
@@ -0,0 +1,3057 @@
1
+
2
+ import { S as ProfileDistributionColumnPayload, en as RowObjectType, yn as NodeData } from "./instanceInfo-Cxe3cNOM.js";
3
+ import { c as LineageGraphNode, i as LineageGraph } from "./types-Dmemk4LS.js";
4
+ import { r as DataGridHandle } from "./ScreenshotDataGrid-5EwaZxMk.js";
5
+ import React$1, { CSSProperties, MouseEvent, ReactNode, Ref } from "react";
6
+ import { BoxProps } from "@mui/material/Box";
7
+ import { SxProps, Theme } from "@mui/material/styles";
8
+ import { ColDef, ColGroupDef, ICellRendererParams } from "ag-grid-community";
9
+ import { Edge, EdgeProps } from "@xyflow/react";
10
+ import { SplitProps } from "react-split";
11
+
12
+ //#region src/components/lineage/nodes/LineageNode.d.ts
13
+ /**
14
+ * Change status for node visualization
15
+ */
16
+ type NodeChangeStatus = "added" | "removed" | "modified" | "unchanged";
17
+ /**
18
+ * Selection mode for the node
19
+ */
20
+ type SelectMode = "normal" | "selecting" | "action_result";
21
+ /**
22
+ * Change category from column-level lineage analysis
23
+ */
24
+ type ChangeCategory = "breaking" | "non_breaking" | "partial_breaking" | "unknown";
25
+ /**
26
+ * Data structure for lineage node
27
+ */
28
+ interface LineageNodeData extends Record<string, unknown> {
29
+ /** Display label for the node */
30
+ label: string;
31
+ /** Node type (model, source, seed, etc.) */
32
+ nodeType?: string;
33
+ /** Change status for diff visualization */
34
+ changeStatus?: NodeChangeStatus;
35
+ /** Whether this node is currently selected */
36
+ isSelected?: boolean;
37
+ /** Resource type for icon display */
38
+ resourceType?: string;
39
+ /** Materialization strategy (table, view, incremental, etc.) */
40
+ materialized?: string;
41
+ /** Package name */
42
+ packageName?: string;
43
+ /** Whether new CLL experience is active (data-level, for ReactFlow passthrough) */
44
+ newCllExperience?: boolean;
45
+ /** Whether this node is impacted by CLL analysis (data-level, for ReactFlow passthrough) */
46
+ isImpacted?: boolean;
47
+ /** Whether to show column-level details */
48
+ showColumns?: boolean;
49
+ /** Column data if showing columns */
50
+ columns?: Array<{
51
+ name: string;
52
+ type?: string;
53
+ changeStatus?: NodeChangeStatus;
54
+ }>;
55
+ }
56
+ /**
57
+ * Props for LineageNode component
58
+ */
59
+ interface LineageNodeProps {
60
+ /** Node ID */
61
+ id: string;
62
+ /** Node data */
63
+ data: LineageNodeData;
64
+ /** Whether the node is selected (from React Flow) */
65
+ selected?: boolean;
66
+ /** Enable interactive mode with checkbox */
67
+ interactive?: boolean;
68
+ /** Selection mode */
69
+ selectMode?: SelectMode;
70
+ /** Whether the node is selected (checkbox state) */
71
+ isNodeSelected?: boolean;
72
+ /** Whether the node is focused */
73
+ isFocused?: boolean;
74
+ /** Whether the node is highlighted */
75
+ isHighlighted?: boolean;
76
+ /** Whether to show content (zoom level visibility) */
77
+ showContent?: boolean;
78
+ /** Action tag to display (for action_result mode) */
79
+ actionTag?: ReactNode;
80
+ /** Whether to show change analysis mode */
81
+ showChangeAnalysis?: boolean;
82
+ /** Change category text */
83
+ changeCategory?: ChangeCategory;
84
+ /** Runs aggregated display component */
85
+ runsAggregatedTag?: ReactNode;
86
+ /** Whether node has parent nodes (show left handle) */
87
+ hasParents?: boolean;
88
+ /** Whether node has child nodes (show right handle) */
89
+ hasChildren?: boolean;
90
+ /** Number of columns for column container height */
91
+ columnCount?: number;
92
+ /** Height per column in pixels */
93
+ columnHeight?: number;
94
+ /** Whether dark mode is active */
95
+ isDark?: boolean;
96
+ /** Whether new CLL experience is active */
97
+ newCllExperience?: boolean;
98
+ /** Whether this node is impacted by CLL analysis */
99
+ isImpacted?: boolean;
100
+ /** 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. */
101
+ isWholeModelChanged?: boolean;
102
+ /** 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. */
103
+ isWholeModelImpacted?: boolean;
104
+ /** 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. */
105
+ wholeModelImpact?: boolean;
106
+ /** Callback when node is clicked */
107
+ onNodeClick?: (nodeId: string) => void;
108
+ /** Callback when node is double-clicked */
109
+ onNodeDoubleClick?: (nodeId: string) => void;
110
+ /** Callback when checkbox is clicked */
111
+ onSelect?: (nodeId: string) => void;
112
+ /** Callback when context menu is requested */
113
+ onContextMenu?: (event: MouseEvent, nodeId: string) => void;
114
+ }
115
+ /**
116
+ * LineageNode - Pure presentation component for displaying nodes in a lineage graph
117
+ *
118
+ * This component is designed to be used with @xyflow/react and receives all data via props.
119
+ * It does not perform any data fetching or state management - it is purely presentational.
120
+ *
121
+ * @example Basic usage
122
+ * ```tsx
123
+ * <LineageNode
124
+ * id="model.my_model"
125
+ * data={{
126
+ * label: "my_model",
127
+ * nodeType: "model",
128
+ * changeStatus: "modified",
129
+ * resourceType: "model"
130
+ * }}
131
+ * selected={false}
132
+ * onNodeClick={(nodeId) => console.log("Clicked:", nodeId)}
133
+ * />
134
+ * ```
135
+ *
136
+ * @example Interactive mode with selection
137
+ * ```tsx
138
+ * <LineageNode
139
+ * id="model.my_model"
140
+ * data={{ label: "my_model", changeStatus: "added" }}
141
+ * interactive
142
+ * selectMode="selecting"
143
+ * isNodeSelected={selectedNodes.has("model.my_model")}
144
+ * onSelect={(nodeId) => toggleSelection(nodeId)}
145
+ * />
146
+ * ```
147
+ *
148
+ * @example Action result mode
149
+ * ```tsx
150
+ * <LineageNode
151
+ * id="model.my_model"
152
+ * data={{ label: "my_model", changeStatus: "modified" }}
153
+ * selectMode="action_result"
154
+ * actionTag={<ActionTag status="running" progress={{ percentage: 0.5 }} />}
155
+ * />
156
+ * ```
157
+ */
158
+ declare function LineageNodeComponent({
159
+ id,
160
+ data,
161
+ selected,
162
+ interactive,
163
+ selectMode,
164
+ isNodeSelected,
165
+ isFocused,
166
+ isHighlighted,
167
+ showContent,
168
+ actionTag,
169
+ showChangeAnalysis,
170
+ changeCategory,
171
+ runsAggregatedTag,
172
+ hasParents,
173
+ hasChildren,
174
+ columnCount,
175
+ columnHeight,
176
+ isDark,
177
+ newCllExperience: newCllExperienceProp,
178
+ isImpacted: isImpactedProp,
179
+ isWholeModelChanged,
180
+ isWholeModelImpacted,
181
+ wholeModelImpact,
182
+ onNodeClick,
183
+ onNodeDoubleClick,
184
+ onSelect,
185
+ onContextMenu
186
+ }: LineageNodeProps): import("react/jsx-runtime").JSX.Element;
187
+ declare const LineageNode: import("react").MemoExoticComponent<typeof LineageNodeComponent>;
188
+ //#endregion
189
+ //#region src/components/lineage/edges/LineageEdge.d.ts
190
+ type EdgeChangeStatus = "added" | "removed" | "modified" | "unchanged";
191
+ interface LineageEdgeData extends Record<string, unknown> {
192
+ /** Change status for diff visualization */
193
+ changeStatus?: EdgeChangeStatus;
194
+ /** Whether this edge is highlighted */
195
+ isHighlighted?: boolean;
196
+ /** Label to display on edge */
197
+ label?: string;
198
+ }
199
+ type LineageEdgeType = Edge<LineageEdgeData>;
200
+ type LineageEdgeProps = EdgeProps<LineageEdgeType>;
201
+ declare function LineageEdgeComponent({
202
+ id,
203
+ sourceX,
204
+ sourceY,
205
+ targetX,
206
+ targetY,
207
+ sourcePosition,
208
+ targetPosition,
209
+ data,
210
+ selected
211
+ }: LineageEdgeProps): import("react/jsx-runtime").JSX.Element;
212
+ declare const LineageEdge: import("react").MemoExoticComponent<typeof LineageEdgeComponent>;
213
+ //#endregion
214
+ //#region src/components/lineage/LineageView.d.ts
215
+ /**
216
+ * Props for the LineageView component.
217
+ * Defines options for viewing lineage diff data.
218
+ */
219
+ interface LineageViewProps {
220
+ /**
221
+ * Optional lineage graph data. If not provided, uses LineageGraphContext.
222
+ */
223
+ lineageGraph?: LineageGraph;
224
+ /**
225
+ * View options for lineage diff visualization
226
+ */
227
+ viewOptions?: {
228
+ view_mode?: "changed_models" | "all";
229
+ node_ids?: string[];
230
+ select?: string;
231
+ exclude?: string;
232
+ packages?: string[];
233
+ column_level_lineage?: {
234
+ node_id?: string;
235
+ column?: string;
236
+ change_analysis?: boolean;
237
+ };
238
+ };
239
+ /**
240
+ * Whether the view allows user interaction
241
+ * @default true
242
+ */
243
+ interactive?: boolean;
244
+ /**
245
+ * Optional height for the view
246
+ * @default 600
247
+ */
248
+ height?: number | string;
249
+ /**
250
+ * Optional filter function for nodes
251
+ */
252
+ filterNodes?: (key: string, node: LineageGraphNode) => boolean;
253
+ /**
254
+ * Callback when a node is selected
255
+ */
256
+ onNodeSelect?: (nodeId: string | null) => void;
257
+ /**
258
+ * Callback when a node is double-clicked
259
+ */
260
+ onNodeDoubleClick?: (nodeId: string) => void;
261
+ /**
262
+ * Optional dagre instance for layout.
263
+ * If not provided, nodes will be positioned at (0,0).
264
+ * Install @dagrejs/dagre and pass the imported module.
265
+ */
266
+ dagre?: any;
267
+ /**
268
+ * Whether to show the minimap
269
+ * @default true
270
+ */
271
+ showMiniMap?: boolean;
272
+ /**
273
+ * Whether to show the controls
274
+ * @default true
275
+ */
276
+ showControls?: boolean;
277
+ /**
278
+ * Whether to show the background grid
279
+ * @default true
280
+ */
281
+ showBackground?: boolean;
282
+ }
283
+ /**
284
+ * Ref interface for LineageView component.
285
+ * Provides methods to interact with the LineageView programmatically.
286
+ */
287
+ interface LineageViewRef {
288
+ /**
289
+ * Copies the current lineage view as an image to the clipboard
290
+ */
291
+ copyToClipboard: () => Promise<void>;
292
+ }
293
+ /**
294
+ * LineageView Component
295
+ *
296
+ * A high-level component for visualizing data lineage graphs using React Flow.
297
+ * Shows relationships between models and their change status.
298
+ *
299
+ * Can receive data from:
300
+ * 1. LineageGraphContext (wrap with LineageGraphProvider)
301
+ * 2. Direct prop (pass lineageGraph prop)
302
+ *
303
+ * For auto-layout, provide a dagre instance:
304
+ *
305
+ * @example Using with context
306
+ * ```tsx
307
+ * import { LineageGraphProvider, LineageView } from '@datarecce/ui';
308
+ * import dagre from '@dagrejs/dagre';
309
+ *
310
+ * function App() {
311
+ * return (
312
+ * <LineageGraphProvider serverInfo={serverInfo}>
313
+ * <LineageView dagre={dagre} />
314
+ * </LineageGraphProvider>
315
+ * );
316
+ * }
317
+ * ```
318
+ *
319
+ * @example Using with direct data
320
+ * ```tsx
321
+ * import { buildLineageGraph, LineageView } from '@datarecce/ui';
322
+ * import dagre from '@dagrejs/dagre';
323
+ *
324
+ * function App({ serverInfo }) {
325
+ * const lineageGraph = buildLineageGraph(
326
+ * serverInfo.lineage.base,
327
+ * serverInfo.lineage.current,
328
+ * serverInfo.lineage.diff
329
+ * );
330
+ *
331
+ * return <LineageView lineageGraph={lineageGraph} dagre={dagre} />;
332
+ * }
333
+ * ```
334
+ */
335
+ declare const LineageView: import("react").ForwardRefExoticComponent<LineageViewProps & import("react").RefAttributes<LineageViewRef>>;
336
+ //#endregion
337
+ //#region src/components/check/CheckActions.d.ts
338
+ /**
339
+ * Action types available for checks
340
+ */
341
+ type CheckActionType = "run" | "approve" | "edit" | "delete" | "duplicate" | "copy" | "preset";
342
+ /**
343
+ * Configuration for a check action
344
+ */
345
+ interface CheckAction {
346
+ /** Action type identifier */
347
+ type: CheckActionType;
348
+ /** Display label */
349
+ label: string;
350
+ /** Icon element (optional) */
351
+ icon?: React.ReactNode;
352
+ /** Whether the action is disabled */
353
+ disabled?: boolean;
354
+ /** Tooltip for disabled state */
355
+ disabledTooltip?: string;
356
+ /** Whether this is a destructive action (shown in red) */
357
+ destructive?: boolean;
358
+ }
359
+ /**
360
+ * Props for the CheckActions component
361
+ */
362
+ interface CheckActionsProps {
363
+ /** ID of the check these actions are for */
364
+ checkId: string;
365
+ /** List of primary actions (shown as buttons) */
366
+ primaryActions?: CheckAction[];
367
+ /** List of secondary actions (shown in dropdown menu) */
368
+ secondaryActions?: CheckAction[];
369
+ /** Callback when an action is triggered */
370
+ onAction?: (checkId: string, actionType: CheckActionType) => void;
371
+ /** Render variant */
372
+ variant?: "buttons" | "menu" | "combined";
373
+ /** Size of buttons */
374
+ size?: "small" | "medium";
375
+ /** Icon for menu trigger button */
376
+ menuIcon?: React.ReactNode;
377
+ /** Optional CSS class name */
378
+ className?: string;
379
+ }
380
+ /**
381
+ * CheckActions Component
382
+ *
383
+ * A pure presentation component for displaying action buttons/menu for a check.
384
+ * Supports primary actions as buttons and secondary actions in a dropdown menu.
385
+ *
386
+ * @example Basic usage with buttons
387
+ * ```tsx
388
+ * import { CheckActions } from '@datarecce/ui/primitives';
389
+ *
390
+ * <CheckActions
391
+ * checkId={check.id}
392
+ * primaryActions={[
393
+ * { type: 'run', label: 'Run' },
394
+ * { type: 'approve', label: 'Approve' },
395
+ * ]}
396
+ * onAction={(id, action) => handleAction(id, action)}
397
+ * />
398
+ * ```
399
+ *
400
+ * @example Combined buttons and menu
401
+ * ```tsx
402
+ * <CheckActions
403
+ * checkId={check.id}
404
+ * variant="combined"
405
+ * primaryActions={[
406
+ * { type: 'run', label: 'Run', icon: <PlayIcon /> },
407
+ * ]}
408
+ * secondaryActions={[
409
+ * { type: 'duplicate', label: 'Duplicate' },
410
+ * { type: 'copy', label: 'Copy Markdown' },
411
+ * { type: 'delete', label: 'Delete', destructive: true },
412
+ * ]}
413
+ * onAction={(id, action) => handleAction(id, action)}
414
+ * />
415
+ * ```
416
+ *
417
+ * @example Menu only
418
+ * ```tsx
419
+ * <CheckActions
420
+ * checkId={check.id}
421
+ * variant="menu"
422
+ * secondaryActions={allActions}
423
+ * onAction={(id, action) => handleAction(id, action)}
424
+ * />
425
+ * ```
426
+ */
427
+ declare function CheckActionsComponent({
428
+ checkId,
429
+ primaryActions,
430
+ secondaryActions,
431
+ onAction,
432
+ variant,
433
+ size,
434
+ menuIcon,
435
+ className
436
+ }: CheckActionsProps): import("react/jsx-runtime").JSX.Element;
437
+ declare const CheckActions: import("react").MemoExoticComponent<typeof CheckActionsComponent>;
438
+ //#endregion
439
+ //#region src/components/check/CheckBreadcrumb.d.ts
440
+ /**
441
+ * Props for the CheckBreadcrumb component
442
+ */
443
+ interface CheckBreadcrumbProps {
444
+ /** Current name value */
445
+ name: string;
446
+ /** Callback when name is saved */
447
+ onNameChange?: (name: string) => void;
448
+ /** Placeholder text when empty */
449
+ placeholder?: string;
450
+ /** Whether editing is disabled */
451
+ disabled?: boolean;
452
+ /** Optional CSS class name */
453
+ className?: string;
454
+ }
455
+ /**
456
+ * CheckBreadcrumb Component
457
+ *
458
+ * A pure presentation component for displaying and editing a check name inline.
459
+ * Supports click-to-edit behavior with Enter to save and Escape to cancel.
460
+ * Also commits changes when clicking outside the input.
461
+ *
462
+ * @example Basic usage
463
+ * ```tsx
464
+ * import { CheckBreadcrumb } from '@datarecce/ui/primitives';
465
+ *
466
+ * function CheckHeader({ check }) {
467
+ * return (
468
+ * <CheckBreadcrumb
469
+ * name={check.name}
470
+ * onNameChange={(name) => updateCheck(check.id, { name })}
471
+ * />
472
+ * );
473
+ * }
474
+ * ```
475
+ *
476
+ * @example Disabled state
477
+ * ```tsx
478
+ * <CheckBreadcrumb
479
+ * name={check.name}
480
+ * disabled
481
+ * placeholder="Unnamed check"
482
+ * />
483
+ * ```
484
+ *
485
+ * @example With placeholder
486
+ * ```tsx
487
+ * <CheckBreadcrumb
488
+ * name=""
489
+ * placeholder="Enter check name..."
490
+ * onNameChange={(name) => updateCheck(check.id, { name })}
491
+ * />
492
+ * ```
493
+ */
494
+ declare function CheckBreadcrumbComponent({
495
+ name,
496
+ onNameChange,
497
+ placeholder,
498
+ disabled,
499
+ className
500
+ }: CheckBreadcrumbProps): import("react/jsx-runtime").JSX.Element;
501
+ declare const CheckBreadcrumb: import("react").MemoExoticComponent<typeof CheckBreadcrumbComponent>;
502
+ //#endregion
503
+ //#region src/components/check/CheckCard.d.ts
504
+ /**
505
+ * Check type categories for icon display
506
+ */
507
+ 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";
508
+ /**
509
+ * Status of a check run
510
+ */
511
+ type CheckRunStatus = "pending" | "running" | "success" | "error";
512
+ /**
513
+ * Data structure for check display
514
+ */
515
+ interface CheckCardData {
516
+ /** Unique check identifier */
517
+ id: string;
518
+ /** Display name of the check */
519
+ name: string;
520
+ /** Type of check for icon display */
521
+ type: CheckType;
522
+ /** Whether the check is approved */
523
+ isApproved?: boolean;
524
+ /** Run status of the check */
525
+ runStatus?: CheckRunStatus;
526
+ /** Whether the check is a preset */
527
+ isPreset?: boolean;
528
+ /**
529
+ * Whether the check result is outdated because the dbt project/manifest
530
+ * (code or artifacts) has changed since the last run.
531
+ */
532
+ isOutdated?: boolean;
533
+ /**
534
+ * ISO timestamp of the last check run used to determine staleness when the
535
+ * dbt manifest or related artifacts are regenerated (shown in outdated tooltip).
536
+ */
537
+ lastRunAt?: string;
538
+ /** Who created this check: "recce_ai" | "user" | "preset_system" */
539
+ actorType?: string;
540
+ }
541
+ /**
542
+ * Props for the CheckCard component
543
+ */
544
+ interface CheckCardProps {
545
+ /** Check data to display */
546
+ check: CheckCardData;
547
+ /** Whether this card is currently selected */
548
+ isSelected?: boolean;
549
+ /** Callback when card is clicked */
550
+ onClick?: (checkId: string) => void;
551
+ /** Callback when approval checkbox is toggled */
552
+ onApprovalChange?: (checkId: string, isApproved: boolean) => void;
553
+ /** Whether approval checkbox is disabled */
554
+ disableApproval?: boolean;
555
+ /** Tooltip text for disabled approval */
556
+ disabledApprovalTooltip?: string;
557
+ /** Whether the entire card is disabled */
558
+ disabled?: boolean;
559
+ /** Optional CSS class name */
560
+ className?: string;
561
+ }
562
+ /**
563
+ * CheckCard Component
564
+ *
565
+ * A pure presentation component for displaying a single check in a list.
566
+ * Shows check type icon, name, approval status, and run status.
567
+ *
568
+ * @example Basic usage
569
+ * ```tsx
570
+ * import { CheckCard } from '@datarecce/ui/primitives';
571
+ *
572
+ * function CheckListItem({ check }) {
573
+ * return (
574
+ * <CheckCard
575
+ * check={{
576
+ * id: check.check_id,
577
+ * name: check.name,
578
+ * type: check.type,
579
+ * isApproved: check.is_checked,
580
+ * }}
581
+ * isSelected={selectedId === check.check_id}
582
+ * onClick={(id) => setSelectedId(id)}
583
+ * onApprovalChange={(id, approved) => updateCheck(id, { is_checked: approved })}
584
+ * />
585
+ * );
586
+ * }
587
+ * ```
588
+ *
589
+ * @example Disabled state
590
+ * ```tsx
591
+ * <CheckCard
592
+ * check={check}
593
+ * disableApproval
594
+ * disabledApprovalTooltip="Run the check first to enable approval"
595
+ * />
596
+ * ```
597
+ */
598
+ declare function CheckCardComponent({
599
+ check,
600
+ isSelected,
601
+ onClick,
602
+ onApprovalChange,
603
+ disableApproval,
604
+ disabledApprovalTooltip,
605
+ disabled,
606
+ className
607
+ }: CheckCardProps): import("react/jsx-runtime").JSX.Element;
608
+ declare const CheckCard: import("react").MemoExoticComponent<typeof CheckCardComponent>;
609
+ //#endregion
610
+ //#region src/components/check/CheckDescription.d.ts
611
+ /**
612
+ * Props for the CheckDescription component
613
+ */
614
+ interface CheckDescriptionProps {
615
+ /** Current description value */
616
+ value?: string;
617
+ /** Callback when description is saved */
618
+ onChange?: (value?: string) => void;
619
+ /** Placeholder text when empty */
620
+ placeholder?: string;
621
+ /** Whether editing is disabled */
622
+ disabled?: boolean;
623
+ /** Optional CSS class name */
624
+ className?: string;
625
+ }
626
+ /**
627
+ * CheckDescription Component
628
+ *
629
+ * A pure presentation component for displaying and editing check descriptions.
630
+ * Supports click-to-edit with Cmd+Enter (Mac) or Ctrl+Enter (Windows) to save.
631
+ *
632
+ * @example Basic usage
633
+ * ```tsx
634
+ * import { CheckDescription } from '@datarecce/ui/primitives';
635
+ *
636
+ * function CheckDetail({ check }) {
637
+ * return (
638
+ * <CheckDescription
639
+ * value={check.description}
640
+ * onChange={(desc) => updateCheck(check.id, { description: desc })}
641
+ * placeholder="Add a description..."
642
+ * />
643
+ * );
644
+ * }
645
+ * ```
646
+ *
647
+ * @example Disabled state
648
+ * ```tsx
649
+ * <CheckDescription
650
+ * value={check.description}
651
+ * disabled
652
+ * placeholder="Description not available"
653
+ * />
654
+ * ```
655
+ */
656
+ declare function CheckDescriptionComponent({
657
+ value,
658
+ onChange,
659
+ placeholder,
660
+ disabled,
661
+ className
662
+ }: CheckDescriptionProps): import("react/jsx-runtime").JSX.Element;
663
+ declare const CheckDescription: import("react").MemoExoticComponent<typeof CheckDescriptionComponent>;
664
+ //#endregion
665
+ //#region src/components/check/CheckDetail.d.ts
666
+ /**
667
+ * Tab configuration for CheckDetail
668
+ */
669
+ interface CheckDetailTab {
670
+ /** Unique tab identifier */
671
+ id: string;
672
+ /** Tab label */
673
+ label: string;
674
+ /** Tab content */
675
+ content: ReactNode;
676
+ }
677
+ /**
678
+ * Props for the CheckDetail component
679
+ */
680
+ interface CheckDetailProps {
681
+ /** Check ID */
682
+ checkId: string;
683
+ /** Check name (displayed as header) */
684
+ name: string;
685
+ /** Check type for display */
686
+ type: string;
687
+ /** Check description */
688
+ description?: string;
689
+ /** Whether the check is approved */
690
+ isApproved?: boolean;
691
+ /** Tabs to display (result, query, etc.) */
692
+ tabs?: CheckDetailTab[];
693
+ /** Default selected tab ID */
694
+ defaultTab?: string;
695
+ /** Primary actions for the check */
696
+ primaryActions?: CheckAction[];
697
+ /** Secondary actions for the check */
698
+ secondaryActions?: CheckAction[];
699
+ /** Callback when an action is triggered */
700
+ onAction?: (checkId: string, actionType: CheckActionType) => void;
701
+ /** Callback when description changes */
702
+ onDescriptionChange?: (description?: string) => void;
703
+ /** Callback when name changes */
704
+ onNameChange?: (name: string) => void;
705
+ /** Whether editing is disabled */
706
+ disabled?: boolean;
707
+ /** Optional header content (breadcrumbs, etc.) */
708
+ headerContent?: ReactNode;
709
+ /** Optional sidebar content */
710
+ sidebarContent?: ReactNode;
711
+ /** Optional CSS class name */
712
+ className?: string;
713
+ }
714
+ /**
715
+ * CheckDetail Component
716
+ *
717
+ * A pure presentation component for displaying detailed information
718
+ * about a single check with tabs, actions, and editable fields.
719
+ *
720
+ * @example Basic usage
721
+ * ```tsx
722
+ * import { CheckDetail } from '@datarecce/ui/primitives';
723
+ *
724
+ * function CheckPage({ check, run }) {
725
+ * return (
726
+ * <CheckDetail
727
+ * checkId={check.id}
728
+ * name={check.name}
729
+ * type={check.type}
730
+ * description={check.description}
731
+ * isApproved={check.is_checked}
732
+ * tabs={[
733
+ * { id: 'result', label: 'Result', content: <ResultView run={run} /> },
734
+ * { id: 'query', label: 'Query', content: <QueryView sql={check.params.sql} /> },
735
+ * ]}
736
+ * primaryActions={[
737
+ * { type: 'run', label: 'Run' },
738
+ * { type: 'approve', label: check.is_checked ? 'Approved' : 'Pending' },
739
+ * ]}
740
+ * secondaryActions={[
741
+ * { type: 'delete', label: 'Delete', destructive: true },
742
+ * ]}
743
+ * onAction={(id, action) => handleAction(id, action)}
744
+ * onDescriptionChange={(desc) => updateCheck(id, { description: desc })}
745
+ * />
746
+ * );
747
+ * }
748
+ * ```
749
+ *
750
+ * @example With sidebar
751
+ * ```tsx
752
+ * <CheckDetail
753
+ * {...props}
754
+ * sidebarContent={<CheckTimeline checkId={check.id} />}
755
+ * />
756
+ * ```
757
+ */
758
+ declare function CheckDetailComponent({
759
+ checkId,
760
+ name,
761
+ type,
762
+ description,
763
+ isApproved,
764
+ tabs,
765
+ defaultTab,
766
+ primaryActions,
767
+ secondaryActions,
768
+ onAction,
769
+ onDescriptionChange,
770
+ onNameChange,
771
+ disabled,
772
+ headerContent,
773
+ sidebarContent,
774
+ className
775
+ }: CheckDetailProps): import("react/jsx-runtime").JSX.Element;
776
+ declare const CheckDetail: import("react").MemoExoticComponent<typeof CheckDetailComponent>;
777
+ //#endregion
778
+ //#region src/components/check/CheckEmptyState.d.ts
779
+ /**
780
+ * Props for the CheckEmptyState component
781
+ */
782
+ interface CheckEmptyStateProps {
783
+ /** Main title text */
784
+ title?: string;
785
+ /** Description text */
786
+ description?: string;
787
+ /** Icon element to display */
788
+ icon?: ReactNode;
789
+ /** Primary action button text */
790
+ actionText?: string;
791
+ /** Callback when primary action is clicked */
792
+ onAction?: () => void;
793
+ /** Whether the action is loading */
794
+ isLoading?: boolean;
795
+ /** Optional helper text below the action */
796
+ helperText?: string;
797
+ /** Optional CSS class name */
798
+ className?: string;
799
+ }
800
+ /**
801
+ * CheckEmptyState Component
802
+ *
803
+ * A pure presentation component for displaying an empty state
804
+ * when no checks exist in the list.
805
+ *
806
+ * @example Basic usage
807
+ * ```tsx
808
+ * import { CheckEmptyState } from '@datarecce/ui/primitives';
809
+ *
810
+ * function MyCheckList() {
811
+ * if (checks.length === 0) {
812
+ * return (
813
+ * <CheckEmptyState
814
+ * title="No checks yet"
815
+ * description="Create your first check to start validating data"
816
+ * actionText="Create Schema Diff Check"
817
+ * onAction={() => createSchemaDiffCheck()}
818
+ * />
819
+ * );
820
+ * }
821
+ * return <CheckList checks={checks} />;
822
+ * }
823
+ * ```
824
+ *
825
+ * @example Custom icon
826
+ * ```tsx
827
+ * import { TbChecklist } from 'react-icons/tb';
828
+ *
829
+ * <CheckEmptyState
830
+ * icon={<TbChecklist size={48} />}
831
+ * title="No checks found"
832
+ * description="Checks help you validate your data changes"
833
+ * />
834
+ * ```
835
+ */
836
+ declare function CheckEmptyStateComponent({
837
+ title,
838
+ description,
839
+ icon,
840
+ actionText,
841
+ onAction,
842
+ isLoading,
843
+ helperText,
844
+ className
845
+ }: CheckEmptyStateProps): import("react/jsx-runtime").JSX.Element;
846
+ declare const CheckEmptyState: import("react").MemoExoticComponent<typeof CheckEmptyStateComponent>;
847
+ //#endregion
848
+ //#region src/components/check/CheckList.d.ts
849
+ /**
850
+ * Props for the CheckList component
851
+ */
852
+ interface CheckListProps {
853
+ /** Array of checks to display */
854
+ checks: CheckCardData[];
855
+ /** Currently selected check ID */
856
+ selectedId?: string | null;
857
+ /** Callback when a check is selected */
858
+ onCheckSelect?: (checkId: string) => void;
859
+ /** Callback when check approval status changes */
860
+ onApprovalChange?: (checkId: string, isApproved: boolean) => void;
861
+ /** Callback when checks are reordered (for drag-drop implementations) */
862
+ onReorder?: (sourceIndex: number, destinationIndex: number) => void;
863
+ /** Whether approval is disabled for all checks */
864
+ disableApproval?: boolean;
865
+ /** Tooltip for disabled approval */
866
+ disabledApprovalTooltip?: string;
867
+ /** Optional title for the list */
868
+ title?: string;
869
+ /** Optional CSS class name */
870
+ className?: string;
871
+ /** Whether the list is loading */
872
+ isLoading?: boolean;
873
+ /** Content to show when list is empty */
874
+ emptyContent?: React.ReactNode;
875
+ }
876
+ /**
877
+ * CheckList Component
878
+ *
879
+ * A pure presentation component for displaying a list of checks.
880
+ * This component does not include drag-and-drop functionality -
881
+ * implement that at the consumer level if needed.
882
+ *
883
+ * @example Basic usage
884
+ * ```tsx
885
+ * import { CheckList } from '@datarecce/ui/primitives';
886
+ *
887
+ * function MyCheckList({ checks }) {
888
+ * const [selectedId, setSelectedId] = useState(null);
889
+ *
890
+ * return (
891
+ * <CheckList
892
+ * checks={checks.map(c => ({
893
+ * id: c.check_id,
894
+ * name: c.name,
895
+ * type: c.type,
896
+ * isApproved: c.is_checked,
897
+ * }))}
898
+ * selectedId={selectedId}
899
+ * onCheckSelect={setSelectedId}
900
+ * onApprovalChange={(id, approved) => updateCheck(id, approved)}
901
+ * />
902
+ * );
903
+ * }
904
+ * ```
905
+ *
906
+ * @example With empty state
907
+ * ```tsx
908
+ * <CheckList
909
+ * checks={[]}
910
+ * emptyContent={<CheckEmptyState onCreateFirst={() => createCheck()} />}
911
+ * />
912
+ * ```
913
+ */
914
+ declare function CheckListComponent({
915
+ checks,
916
+ selectedId,
917
+ onCheckSelect,
918
+ onApprovalChange,
919
+ disableApproval,
920
+ disabledApprovalTooltip,
921
+ title,
922
+ className,
923
+ isLoading,
924
+ emptyContent
925
+ }: CheckListProps): import("react/jsx-runtime").JSX.Element;
926
+ declare const CheckList: import("react").MemoExoticComponent<typeof CheckListComponent>;
927
+ //#endregion
928
+ //#region src/components/check/PresetCheckTemplateView.d.ts
929
+ /**
930
+ * Props for generating a preset check template
931
+ */
932
+ interface GenerateCheckTemplateOptions {
933
+ /** Check name */
934
+ name: string;
935
+ /** Check description */
936
+ description: string;
937
+ /** Check type (e.g., "row_count_diff", "schema_diff") */
938
+ type: string;
939
+ /** Check parameters */
940
+ params: Record<string, unknown>;
941
+ /** View options (optional) */
942
+ viewOptions?: Record<string, unknown>;
943
+ }
944
+ /**
945
+ * Generates a YAML template for a preset check configuration.
946
+ * This can be used to export checks to recce.yml.
947
+ *
948
+ * @example
949
+ * ```ts
950
+ * const template = generateCheckTemplate({
951
+ * name: "Schema Check",
952
+ * description: "Check for schema changes",
953
+ * type: "schema_diff",
954
+ * params: { select: "state:modified" },
955
+ * });
956
+ * // Returns:
957
+ * // checks:
958
+ * // - name: Schema Check
959
+ * // description: Check for schema changes
960
+ * // type: schema_diff
961
+ * // params:
962
+ * // select: state:modified
963
+ * ```
964
+ */
965
+ declare function generateCheckTemplate({
966
+ name,
967
+ description,
968
+ type,
969
+ params,
970
+ viewOptions
971
+ }: GenerateCheckTemplateOptions): string;
972
+ /**
973
+ * Props for the PresetCheckTemplateView component
974
+ */
975
+ interface PresetCheckTemplateViewProps {
976
+ /** The YAML template string to display */
977
+ yamlTemplate: string;
978
+ /** Optional height for the editor */
979
+ height?: string;
980
+ }
981
+ /**
982
+ * PresetCheckTemplateView Component
983
+ *
984
+ * A presentation component for displaying a preset check YAML template
985
+ * in a read-only code editor. Used in modals to show users how to
986
+ * add checks to their recce.yml file.
987
+ *
988
+ * @example Basic usage
989
+ * ```tsx
990
+ * import { PresetCheckTemplateView, generateCheckTemplate } from '@datarecce/ui/primitives';
991
+ *
992
+ * function CheckTemplateDialog({ check }) {
993
+ * const template = generateCheckTemplate({
994
+ * name: check.name,
995
+ * description: check.description,
996
+ * type: check.type,
997
+ * params: check.params,
998
+ * });
999
+ *
1000
+ * return (
1001
+ * <Dialog open>
1002
+ * <DialogContent>
1003
+ * <PresetCheckTemplateView yamlTemplate={template} />
1004
+ * </DialogContent>
1005
+ * </Dialog>
1006
+ * );
1007
+ * }
1008
+ * ```
1009
+ */
1010
+ declare function PresetCheckTemplateViewComponent({
1011
+ yamlTemplate,
1012
+ height
1013
+ }: PresetCheckTemplateViewProps): import("react/jsx-runtime").JSX.Element;
1014
+ declare const PresetCheckTemplateView: import("react").MemoExoticComponent<typeof PresetCheckTemplateViewComponent>;
1015
+ //#endregion
1016
+ //#region src/components/lineage/columns/LineageColumnNode.d.ts
1017
+ /**
1018
+ * Transformation type for column-level lineage
1019
+ */
1020
+ type ColumnTransformationType = "passthrough" | "renamed" | "derived" | "source" | "unknown";
1021
+ /**
1022
+ * Column change status for diff views
1023
+ */
1024
+ type ColumnChangeStatus = "added" | "removed" | "modified";
1025
+ /**
1026
+ * Data structure for a column node
1027
+ */
1028
+ interface LineageColumnNodeData extends Record<string, unknown> {
1029
+ /** Column name */
1030
+ column: string;
1031
+ /** Column data type (e.g., "VARCHAR", "INTEGER") */
1032
+ type?: string;
1033
+ /** ID of the parent model/table node */
1034
+ nodeId: string;
1035
+ /** Transformation type for this column */
1036
+ transformationType?: ColumnTransformationType;
1037
+ /** Change status for diff views */
1038
+ changeStatus?: ColumnChangeStatus;
1039
+ /** Whether the column is highlighted */
1040
+ isHighlighted?: boolean;
1041
+ /** Whether the column is selected/focused */
1042
+ isFocused?: boolean;
1043
+ /** Whether this column is impacted (new CLL experience) */
1044
+ isImpacted?: boolean;
1045
+ /** Whether to use the new CLL experience palette (muted bg + left accent) */
1046
+ newCllExperience?: boolean;
1047
+ }
1048
+ /**
1049
+ * Props for the LineageColumnNode component
1050
+ */
1051
+ interface LineageColumnNodeProps {
1052
+ /** Unique node ID */
1053
+ id: string;
1054
+ /** Node data */
1055
+ data: LineageColumnNodeData;
1056
+ /** Whether the node is selected */
1057
+ selected?: boolean;
1058
+ /**
1059
+ * Whether to show content (used for zoom-level visibility)
1060
+ * When false, the node renders nothing (hidden at low zoom levels)
1061
+ * @default true
1062
+ */
1063
+ showContent?: boolean;
1064
+ /**
1065
+ * Whether to show change analysis mode
1066
+ * When true and changeStatus exists, shows change status indicator
1067
+ * When false, shows transformation type indicator
1068
+ * @default false
1069
+ */
1070
+ showChangeAnalysis?: boolean;
1071
+ /**
1072
+ * Whether to use dark mode styling
1073
+ * @default false
1074
+ */
1075
+ isDark?: boolean;
1076
+ /**
1077
+ * Whether to use the new CLL experience palette (muted bg + left accent
1078
+ * for changed columns, dark hex fallbacks). When false, renders the
1079
+ * original behavior: only `isImpacted` triggers a tinted bg.
1080
+ * Falls back to `data.newCllExperience` when prop is omitted.
1081
+ * @default false
1082
+ */
1083
+ newCllExperience?: boolean;
1084
+ /** Callback when column is clicked */
1085
+ onColumnClick?: (columnId: string) => void;
1086
+ /**
1087
+ * Callback when context menu is requested (kebab menu click)
1088
+ * When provided, shows kebab menu on hover
1089
+ */
1090
+ onContextMenu?: (event: MouseEvent, columnId: string) => void;
1091
+ }
1092
+ /**
1093
+ * Default column height in pixels
1094
+ */
1095
+ declare const COLUMN_NODE_HEIGHT = 24;
1096
+ /**
1097
+ * Default column width in pixels
1098
+ */
1099
+ declare const COLUMN_NODE_WIDTH = 280;
1100
+ /**
1101
+ * LineageColumnNode Component
1102
+ *
1103
+ * A pure presentation component for rendering individual columns
1104
+ * in column-level lineage visualizations using React Flow.
1105
+ *
1106
+ * @example Basic usage
1107
+ * ```tsx
1108
+ * import { LineageColumnNode } from '@datarecce/ui/primitives';
1109
+ *
1110
+ * // Register as a React Flow node type
1111
+ * const nodeTypes = {
1112
+ * columnNode: LineageColumnNode,
1113
+ * };
1114
+ *
1115
+ * function ColumnLineageGraph() {
1116
+ * return (
1117
+ * <ReactFlow nodes={columnNodes} edges={edges} nodeTypes={nodeTypes} />
1118
+ * );
1119
+ * }
1120
+ * ```
1121
+ *
1122
+ * @example Node data structure
1123
+ * ```tsx
1124
+ * const columnNode = {
1125
+ * id: 'users-id',
1126
+ * type: 'columnNode',
1127
+ * data: {
1128
+ * column: 'id',
1129
+ * type: 'INTEGER',
1130
+ * nodeId: 'users',
1131
+ * transformationType: 'passthrough',
1132
+ * changeStatus: undefined,
1133
+ * isHighlighted: true,
1134
+ * },
1135
+ * position: { x: 0, y: 0 },
1136
+ * };
1137
+ * ```
1138
+ *
1139
+ * @example With change analysis mode
1140
+ * ```tsx
1141
+ * // In change analysis mode, shows change status instead of transformation type
1142
+ * <LineageColumnNode
1143
+ * showChangeAnalysis={true}
1144
+ * showContent={zoomLevel > 0.3}
1145
+ * onContextMenu={(e, columnId) => showMenu(e, columnId)}
1146
+ * />
1147
+ * ```
1148
+ */
1149
+ declare function LineageColumnNodeComponent({
1150
+ id,
1151
+ data,
1152
+ showContent,
1153
+ showChangeAnalysis,
1154
+ isDark,
1155
+ newCllExperience: newCllExperienceProp,
1156
+ onColumnClick,
1157
+ onContextMenu
1158
+ }: LineageColumnNodeProps): import("react/jsx-runtime").JSX.Element | null;
1159
+ declare const LineageColumnNode: import("react").MemoExoticComponent<typeof LineageColumnNodeComponent>;
1160
+ //#endregion
1161
+ //#region src/components/lineage/legend/LineageLegend.d.ts
1162
+ /**
1163
+ * Legend item for change status
1164
+ */
1165
+ interface ChangeStatusLegendItem {
1166
+ status: "added" | "removed" | "modified" | "impacted";
1167
+ label: string;
1168
+ description?: string;
1169
+ }
1170
+ /**
1171
+ * Legend item for transformation type
1172
+ */
1173
+ interface TransformationLegendItem {
1174
+ type: "passthrough" | "renamed" | "derived" | "source" | "unknown";
1175
+ label: string;
1176
+ description?: string;
1177
+ }
1178
+ /**
1179
+ * Props for the LineageLegend component
1180
+ */
1181
+ interface LineageLegendProps {
1182
+ /**
1183
+ * Type of legend to display
1184
+ */
1185
+ variant: "changeStatus" | "transformation";
1186
+ /**
1187
+ * Whether to show tooltips on hover
1188
+ * @default true
1189
+ */
1190
+ showTooltips?: boolean;
1191
+ /**
1192
+ * Optional title for the legend
1193
+ */
1194
+ title?: string;
1195
+ /**
1196
+ * CSS class name for additional styling
1197
+ */
1198
+ className?: string;
1199
+ /**
1200
+ * When true, render the muted CLL palette and include the "Impacted" entry.
1201
+ * When false (default), render the original Tailwind palette and omit
1202
+ * "Impacted" — matching the legend OSS users have always seen.
1203
+ * @default false
1204
+ */
1205
+ newCllExperience?: boolean;
1206
+ }
1207
+ /**
1208
+ * LineageLegend Component
1209
+ *
1210
+ * A pure presentation component for displaying legends in lineage visualizations.
1211
+ * Supports both change status legends (added/removed/modified) and
1212
+ * transformation type legends (passthrough/renamed/derived/source/unknown).
1213
+ *
1214
+ * @example Change status legend
1215
+ * ```tsx
1216
+ * import { LineageLegend } from '@datarecce/ui/primitives';
1217
+ *
1218
+ * function MyLineageGraph() {
1219
+ * return (
1220
+ * <div style={{ position: 'relative' }}>
1221
+ * <ReactFlow nodes={nodes} edges={edges} />
1222
+ * <div style={{ position: 'absolute', bottom: 10, right: 10 }}>
1223
+ * <LineageLegend variant="changeStatus" title="Changes" />
1224
+ * </div>
1225
+ * </div>
1226
+ * );
1227
+ * }
1228
+ * ```
1229
+ *
1230
+ * @example Transformation type legend
1231
+ * ```tsx
1232
+ * import { LineageLegend } from '@datarecce/ui/primitives';
1233
+ *
1234
+ * function ColumnLineageGraph() {
1235
+ * return (
1236
+ * <div>
1237
+ * <ReactFlow nodes={columnNodes} edges={edges} />
1238
+ * <LineageLegend variant="transformation" />
1239
+ * </div>
1240
+ * );
1241
+ * }
1242
+ * ```
1243
+ */
1244
+ declare function LineageLegend({
1245
+ variant,
1246
+ showTooltips,
1247
+ title,
1248
+ className,
1249
+ newCllExperience
1250
+ }: LineageLegendProps): import("react/jsx-runtime").JSX.Element;
1251
+ //#endregion
1252
+ //#region src/components/lineage/tags/NodeTag.d.ts
1253
+ interface NodeTagProps {
1254
+ resourceType?: string;
1255
+ materialized?: string;
1256
+ "data-testid"?: string;
1257
+ }
1258
+ declare function NodeTagComponent({
1259
+ resourceType,
1260
+ materialized,
1261
+ "data-testid": testId
1262
+ }: NodeTagProps): import("react/jsx-runtime").JSX.Element;
1263
+ declare const NodeTag: import("react").MemoExoticComponent<typeof NodeTagComponent>;
1264
+ //#endregion
1265
+ //#region src/components/check/timeline/CommentInput.d.ts
1266
+ /**
1267
+ * Props for the CommentInput component
1268
+ */
1269
+ interface CommentInputProps {
1270
+ /** Callback when comment is submitted */
1271
+ onSubmit: (content: string) => void;
1272
+ /** Whether submission is in progress */
1273
+ isSubmitting?: boolean;
1274
+ /** Placeholder text for the input */
1275
+ placeholder?: string;
1276
+ /** Button text (defaults to "Comment") */
1277
+ submitLabel?: string;
1278
+ /** Submitting button text (defaults to "Submitting...") */
1279
+ submittingLabel?: string;
1280
+ /** Optional CSS class name */
1281
+ className?: string;
1282
+ }
1283
+ /**
1284
+ * CommentInput Component
1285
+ *
1286
+ * A pure presentation component for adding comments to a timeline.
1287
+ * Supports Cmd+Enter (Mac) or Ctrl+Enter (Windows) keyboard shortcut to submit.
1288
+ *
1289
+ * @example Basic usage
1290
+ * ```tsx
1291
+ * import { CommentInput } from '@datarecce/ui/primitives';
1292
+ *
1293
+ * function CheckTimeline({ checkId }) {
1294
+ * const [isSubmitting, setIsSubmitting] = useState(false);
1295
+ *
1296
+ * const handleSubmit = async (content: string) => {
1297
+ * setIsSubmitting(true);
1298
+ * await addComment(checkId, content);
1299
+ * setIsSubmitting(false);
1300
+ * };
1301
+ *
1302
+ * return (
1303
+ * <CommentInput
1304
+ * onSubmit={handleSubmit}
1305
+ * isSubmitting={isSubmitting}
1306
+ * />
1307
+ * );
1308
+ * }
1309
+ * ```
1310
+ *
1311
+ * @example Custom labels
1312
+ * ```tsx
1313
+ * <CommentInput
1314
+ * onSubmit={handleSubmit}
1315
+ * placeholder="Leave feedback..."
1316
+ * submitLabel="Send"
1317
+ * submittingLabel="Sending..."
1318
+ * />
1319
+ * ```
1320
+ */
1321
+ declare function CommentInputComponent({
1322
+ onSubmit,
1323
+ isSubmitting,
1324
+ placeholder,
1325
+ submitLabel,
1326
+ submittingLabel,
1327
+ className
1328
+ }: CommentInputProps): import("react/jsx-runtime").JSX.Element;
1329
+ declare const CommentInput: import("react").MemoExoticComponent<typeof CommentInputComponent>;
1330
+ //#endregion
1331
+ //#region src/components/check/timeline/TimelineEvent.d.ts
1332
+ /**
1333
+ * Actor information for timeline events
1334
+ */
1335
+ interface TimelineActor {
1336
+ /** User ID */
1337
+ user_id?: string | number;
1338
+ /** Full name of the actor */
1339
+ fullname?: string;
1340
+ /** Login/username of the actor */
1341
+ login?: string;
1342
+ /** Avatar URL (props-driven, consumer provides) */
1343
+ avatarUrl?: string;
1344
+ }
1345
+ /**
1346
+ * Event types supported by the timeline
1347
+ */
1348
+ type TimelineEventType = "check_created" | "comment" | "approval_change" | "description_change" | "name_change" | "preset_applied";
1349
+ /**
1350
+ * Timeline event data structure
1351
+ */
1352
+ interface TimelineEventData {
1353
+ /** Unique event ID */
1354
+ id: string;
1355
+ /** Type of event */
1356
+ event_type: TimelineEventType;
1357
+ /** Actor who performed the event */
1358
+ actor: TimelineActor;
1359
+ /** Event creation timestamp (ISO string) */
1360
+ created_at: string;
1361
+ /** Event content (for comments) */
1362
+ content?: string;
1363
+ /** New value (for change events) */
1364
+ new_value?: string;
1365
+ /** Whether the event was edited */
1366
+ is_edited?: boolean;
1367
+ /** Whether the event was deleted */
1368
+ is_deleted?: boolean;
1369
+ }
1370
+ /**
1371
+ * Props for the TimelineEvent component
1372
+ */
1373
+ interface TimelineEventProps {
1374
+ /** Event data to render */
1375
+ event: TimelineEventData;
1376
+ /** Current user ID (to show edit/delete for own comments) */
1377
+ currentUserId?: string;
1378
+ /** Callback when editing a comment */
1379
+ onEdit?: (eventId: string, content: string) => Promise<void>;
1380
+ /** Callback when deleting a comment */
1381
+ onDelete?: (eventId: string) => Promise<void>;
1382
+ /** Optional markdown renderer component */
1383
+ markdownRenderer?: React.ComponentType<{
1384
+ content: string;
1385
+ }>;
1386
+ /** Optional CSS class name */
1387
+ className?: string;
1388
+ }
1389
+ /**
1390
+ * TimelineEvent Component
1391
+ *
1392
+ * A pure presentation component for rendering timeline events.
1393
+ * Supports different event types including comments with edit/delete functionality.
1394
+ *
1395
+ * @example Basic usage with state change events
1396
+ * ```tsx
1397
+ * import { TimelineEvent } from '@datarecce/ui/primitives';
1398
+ *
1399
+ * function CheckTimeline({ events }) {
1400
+ * return (
1401
+ * <div>
1402
+ * {events.map(event => (
1403
+ * <TimelineEvent key={event.id} event={event} />
1404
+ * ))}
1405
+ * </div>
1406
+ * );
1407
+ * }
1408
+ * ```
1409
+ *
1410
+ * @example With comment editing
1411
+ * ```tsx
1412
+ * <TimelineEvent
1413
+ * event={commentEvent}
1414
+ * currentUserId={currentUser.id}
1415
+ * onEdit={async (eventId, content) => {
1416
+ * await updateComment(eventId, content);
1417
+ * }}
1418
+ * onDelete={async (eventId) => {
1419
+ * await deleteComment(eventId);
1420
+ * }}
1421
+ * />
1422
+ * ```
1423
+ *
1424
+ * @example With custom markdown renderer
1425
+ * ```tsx
1426
+ * import { MarkdownContent } from '@/components/ui/markdown/MarkdownContent';
1427
+ *
1428
+ * <TimelineEvent
1429
+ * event={event}
1430
+ * markdownRenderer={({ content }) => (
1431
+ * <MarkdownContent content={content} fontSize="sm" />
1432
+ * )}
1433
+ * />
1434
+ * ```
1435
+ */
1436
+ declare function TimelineEventComponent({
1437
+ event,
1438
+ currentUserId,
1439
+ onEdit,
1440
+ onDelete,
1441
+ markdownRenderer,
1442
+ className
1443
+ }: TimelineEventProps): import("react/jsx-runtime").JSX.Element;
1444
+ declare const TimelineEvent: import("react").MemoExoticComponent<typeof TimelineEventComponent>;
1445
+ //#endregion
1446
+ //#region src/components/check/utils.d.ts
1447
+ /**
1448
+ * Utility functions for check components
1449
+ */
1450
+ /**
1451
+ * Build a title string for a check with optional approval indicator
1452
+ *
1453
+ * @example
1454
+ * ```ts
1455
+ * const title = buildCheckTitle({ name: "Schema check", isChecked: true });
1456
+ * // Returns: "✅ Schema check"
1457
+ * ```
1458
+ */
1459
+ declare function buildCheckTitle({
1460
+ name,
1461
+ isChecked
1462
+ }: {
1463
+ name: string;
1464
+ isChecked?: boolean;
1465
+ }): string;
1466
+ /**
1467
+ * Build a description string with fallback for empty descriptions
1468
+ *
1469
+ * @example
1470
+ * ```ts
1471
+ * const desc = buildCheckDescription({ description: "" });
1472
+ * // Returns: "_(no description)_"
1473
+ * ```
1474
+ */
1475
+ declare function buildCheckDescription({
1476
+ description,
1477
+ fallback
1478
+ }: {
1479
+ description?: string | null;
1480
+ fallback?: string;
1481
+ }): string;
1482
+ /**
1483
+ * Check if a run result is missing or has an error
1484
+ *
1485
+ * Certain check types (schema_diff, lineage_diff) don't require results
1486
+ * to enable approval functionality.
1487
+ *
1488
+ * @example
1489
+ * ```ts
1490
+ * const disabled = isDisabledByNoResult({
1491
+ * type: "row_count_diff",
1492
+ * hasResult: false,
1493
+ * hasError: false,
1494
+ * });
1495
+ * // Returns: true
1496
+ *
1497
+ * const enabled = isDisabledByNoResult({
1498
+ * type: "schema_diff",
1499
+ * hasResult: false,
1500
+ * hasError: false,
1501
+ * });
1502
+ * // Returns: false (schema_diff doesn't require results)
1503
+ * ```
1504
+ */
1505
+ declare function isDisabledByNoResult({
1506
+ type,
1507
+ hasResult,
1508
+ hasError
1509
+ }: {
1510
+ type: string;
1511
+ hasResult: boolean;
1512
+ hasError: boolean;
1513
+ }): boolean;
1514
+ /**
1515
+ * Format SQL as a markdown code block
1516
+ *
1517
+ * @example
1518
+ * ```ts
1519
+ * const markdown = formatSqlAsMarkdown({ sql: "SELECT * FROM users" });
1520
+ * // Returns:
1521
+ * // **SQL**
1522
+ * // ```sql
1523
+ * // SELECT * FROM users
1524
+ * // ```
1525
+ * ```
1526
+ */
1527
+ declare function formatSqlAsMarkdown({
1528
+ sql,
1529
+ label
1530
+ }: {
1531
+ sql: string;
1532
+ label?: string;
1533
+ }): string;
1534
+ //#endregion
1535
+ //#region src/components/data/HistogramChart.d.ts
1536
+ /**
1537
+ * Histogram dataset for a single environment
1538
+ */
1539
+ interface HistogramDataset {
1540
+ /** Count values per bin */
1541
+ counts: number[];
1542
+ /** Optional dataset label */
1543
+ label?: string;
1544
+ }
1545
+ /**
1546
+ * Histogram data type
1547
+ */
1548
+ type HistogramDataType = "numeric" | "datetime" | "string";
1549
+ /**
1550
+ * Props for the HistogramChart component
1551
+ */
1552
+ interface HistogramChartProps {
1553
+ /** Chart title */
1554
+ title: string;
1555
+ /** Data type (numeric, datetime, or string) */
1556
+ dataType?: HistogramDataType;
1557
+ /** Total sample count */
1558
+ samples?: number;
1559
+ /** Minimum value (for datetime scale) */
1560
+ min?: string | number;
1561
+ /** Maximum value (for datetime scale) */
1562
+ max?: string | number;
1563
+ /** Bin edge values */
1564
+ binEdges: number[];
1565
+ /** Base environment dataset */
1566
+ baseData: HistogramDataset;
1567
+ /** Current environment dataset */
1568
+ currentData: HistogramDataset;
1569
+ /** Enable animation */
1570
+ animate?: boolean;
1571
+ /** Hide axis labels and ticks */
1572
+ hideAxis?: boolean;
1573
+ /** Theme mode */
1574
+ theme?: "light" | "dark";
1575
+ /** Chart height in pixels */
1576
+ height?: number;
1577
+ /** Optional CSS class */
1578
+ className?: string;
1579
+ }
1580
+ /**
1581
+ * HistogramChart Component
1582
+ *
1583
+ * A pure presentation component for displaying histogram charts comparing
1584
+ * base and current data distributions using Chart.js.
1585
+ *
1586
+ * @example Basic usage
1587
+ * ```tsx
1588
+ * import { HistogramChart } from '@datarecce/ui/primitives';
1589
+ *
1590
+ * function ProfilePanel({ histogramData }) {
1591
+ * return (
1592
+ * <HistogramChart
1593
+ * title="Age Distribution"
1594
+ * dataType="numeric"
1595
+ * binEdges={histogramData.binEdges}
1596
+ * baseData={{ counts: histogramData.baseCounts }}
1597
+ * currentData={{ counts: histogramData.currentCounts }}
1598
+ * samples={1000}
1599
+ * />
1600
+ * );
1601
+ * }
1602
+ * ```
1603
+ *
1604
+ * @example With datetime scale
1605
+ * ```tsx
1606
+ * <HistogramChart
1607
+ * title="Events Over Time"
1608
+ * dataType="datetime"
1609
+ * binEdges={timestamps}
1610
+ * baseData={{ counts: baseCounts }}
1611
+ * currentData={{ counts: currentCounts }}
1612
+ * min={startDate}
1613
+ * max={endDate}
1614
+ * />
1615
+ * ```
1616
+ */
1617
+ declare function HistogramChartComponent({
1618
+ title,
1619
+ dataType,
1620
+ samples,
1621
+ min,
1622
+ max,
1623
+ binEdges,
1624
+ baseData,
1625
+ currentData,
1626
+ animate,
1627
+ hideAxis,
1628
+ theme,
1629
+ height,
1630
+ className
1631
+ }: HistogramChartProps): import("react/jsx-runtime").JSX.Element;
1632
+ declare const HistogramChart: import("react").MemoExoticComponent<typeof HistogramChartComponent>;
1633
+ //#endregion
1634
+ //#region src/components/data/InlineProfileDistributionCell.d.ts
1635
+ /**
1636
+ * @file InlineProfileDistributionCell.tsx
1637
+ * @description The schema-grid cell container that turns a single column's
1638
+ * {@link ProfileDistributionColumnPayload} into the right paired-histogram
1639
+ * leaf, and renders the loading / error / empty / per-column-failure states
1640
+ * around it.
1641
+ *
1642
+ * This is the one place the snake_case wire payload is mapped to the
1643
+ * camelCase cell props, and the only place that has to know the column's dbt
1644
+ * type (to format datetime histogram edges, which arrive as epoch seconds).
1645
+ * The leaf cells stay type-blind; this container owns the formatting seam.
1646
+ *
1647
+ * State machine (first match wins):
1648
+ * 1. `isLoading` → pending dot
1649
+ * 2. `hasError` → run-level error glyph
1650
+ * 3. no payload + notProfiled → "not profiled" dash (column outside a scoped run)
1651
+ * 4. no payload → blank (column has no distribution data)
1652
+ * 5. `kind: null` → per-column failure glyph
1653
+ * 6. `kind: "histogram"` → {@link PairedHistogramContinuous}
1654
+ * 7. `kind: "topk"` + ranks → {@link PairedHistogramDiscrete} (ranks mode)
1655
+ * 8. `kind: "topk"` + counts→ {@link PairedHistogramDiscrete} (counts mode)
1656
+ */
1657
+ interface InlineProfileDistributionCellProps {
1658
+ /** The per-column payload from the run result, or undefined when none. */
1659
+ payload?: ProfileDistributionColumnPayload;
1660
+ /**
1661
+ * The column's dbt type, used only to format continuous histogram edges:
1662
+ * calendar dates for date/timestamp/datetime (edges are epoch seconds), or
1663
+ * `HH:MM:SS` clock times for `TIME` (edges are seconds-since-midnight).
1664
+ */
1665
+ columnType?: string;
1666
+ /**
1667
+ * Envelope-level row totals — the denominator for counts-mode proportions.
1668
+ * Unused in ranks mode (the DuckDB path that ships today), so optional. NOT
1669
+ * speculative: full warehouse adapters (Snowflake/BigQuery top-K return
1670
+ * value+count pairs) emit counts mode, so this is threaded now to match the
1671
+ * single `run.ts` payload contract rather than retrofitted later.
1672
+ */
1673
+ baseTotal?: number;
1674
+ currentTotal?: number;
1675
+ /** True while the run is in flight (no payload yet). */
1676
+ isLoading?: boolean;
1677
+ /** True when the whole run failed (distinct from a per-column failure). */
1678
+ hasError?: boolean;
1679
+ /**
1680
+ * True when this column was outside a scoped run — never requested, so it has
1681
+ * no data by design. Renders a faint dash so the empty cell reads as
1682
+ * "intentionally not profiled" rather than broken. Ignored once a payload,
1683
+ * loading, or error state applies.
1684
+ */
1685
+ notProfiled?: boolean;
1686
+ className?: string;
1687
+ }
1688
+ declare function InlineProfileDistributionCell({
1689
+ payload,
1690
+ columnType,
1691
+ baseTotal,
1692
+ currentTotal,
1693
+ isLoading,
1694
+ hasError,
1695
+ notProfiled,
1696
+ className
1697
+ }: InlineProfileDistributionCellProps): import("react/jsx-runtime").JSX.Element | null;
1698
+ //#endregion
1699
+ //#region src/components/data/PairedHistogramContinuous.d.ts
1700
+ /**
1701
+ * Small continuous paired-bar chart for high-cardinality quantitative data
1702
+ * (order amounts, latency, file sizes) using **constant-area** rendering.
1703
+ *
1704
+ * This is the GA replacement for the prototype `PairedHistogramContinuousCell`,
1705
+ * rewritten for the quantile-bin payload shipped by PR 2. The visual
1706
+ * vocabulary is preserved (agreement zone + differential), but bar
1707
+ * **width** now varies with the bin's quantile
1708
+ * span and bar **height** with density, so the **area** of each bar reads
1709
+ * directly as the proportion of rows in that bin.
1710
+ *
1711
+ * Per-env edges, merged x-grid: base and current are binned on their own
1712
+ * quantile edges (that's the only way each stays constant-area — see the
1713
+ * PR #1398 discussion). They generally don't line up. Rather than force
1714
+ * one env onto the other's edges (which destroys the equal-area property
1715
+ * and, in the backend, collapses the two densities into one), we overlay
1716
+ * both edge sets onto a **shared value axis** and draw a bar at every
1717
+ * segment of the *merged* edge set. Each merged segment falls entirely
1718
+ * within one base bin and one current bin, so both densities are constant
1719
+ * across it — which lets the original agreement-zone + differential
1720
+ * renderer run unchanged on the skinnier segments.
1721
+ *
1722
+ * Why constant-area: with quantile bins, equal-row-count slots have
1723
+ * different widths. Uniform-width rendering would overweight wide,
1724
+ * sparse bins. Area = density × span gives every bar the same row-share
1725
+ * meaning regardless of bin width.
1726
+ *
1727
+ * Why not reuse `HistogramChart`: HistogramChart unconditionally renders
1728
+ * a title row + legend (~50 px overhead). At cell density (h≈28) there
1729
+ * is no room left for the bars. HistogramChart still belongs on popover
1730
+ * and detail surfaces where its title/legend/tooltip machinery is welcome —
1731
+ * just not in a 140×28 grid cell.
1732
+ *
1733
+ * Bar palette + theme colors come from `getChartBarColors` /
1734
+ * `getChartThemeColors` (canonical in `@datarecce/ui/theme`), so all
1735
+ * chart surfaces stay in lockstep.
1736
+ */
1737
+ /**
1738
+ * Payload for the continuous cell. Matches `ProfileDistributionHistogramPayload`
1739
+ * from the run API (snake_case wire format) so callers can pass results
1740
+ * through with minimal adapting.
1741
+ */
1742
+ interface PairedHistogramContinuousData {
1743
+ /** Length 12 — base quantile-bin edges. */
1744
+ baseBinEdges: number[];
1745
+ /** Length 12 — current quantile-bin edges (independent of base's). */
1746
+ currentBinEdges: number[];
1747
+ /** Length 11 — base density per base bin (count / total / span). */
1748
+ baseDensity: number[];
1749
+ /** Length 11 — current density per current bin. */
1750
+ currentDensity: number[];
1751
+ baseTotal: number;
1752
+ currentTotal: number;
1753
+ }
1754
+ interface PairedHistogramContinuousProps {
1755
+ data: PairedHistogramContinuousData;
1756
+ /** Override default tooltip-range formatter. Default: 1.2K-style abbreviation. */
1757
+ formatValue?: (v: number) => string;
1758
+ /** Optional CSS class. */
1759
+ className?: string;
1760
+ }
1761
+ /**
1762
+ * PairedHistogramContinuous — constant-area paired-bar chart, fixed
1763
+ * `CELL_WIDTH × CELL_HEIGHT` (140×28) for SchemaView cell density.
1764
+ *
1765
+ * @example
1766
+ * ```tsx
1767
+ * <PairedHistogramContinuous data={distribution} />
1768
+ * ```
1769
+ */
1770
+ declare function PairedHistogramContinuous({
1771
+ data,
1772
+ formatValue,
1773
+ className
1774
+ }: PairedHistogramContinuousProps): import("react/jsx-runtime").JSX.Element;
1775
+ //#endregion
1776
+ //#region src/components/data/PairedHistogramDiscrete.d.ts
1777
+ /**
1778
+ * Small categorical paired-bar chart for top-K low-cardinality data —
1779
+ * both string-valued (country codes) and numeric-as-label (HTTP status
1780
+ * codes). Cell-density sibling of `HistogramChart`/`TopKBarChart`; those
1781
+ * keep their place on detail/popover surfaces where title + legend fit.
1782
+ *
1783
+ * This is the GA replacement for the prototype `PairedHistogramDiscreteCell`,
1784
+ * rewritten for the top-K payload shipped by PR 2.
1785
+ *
1786
+ * Visual: paired bars per category slot. When one side's count is 0
1787
+ * (value absent on that side), that bar simply doesn't render, leaving
1788
+ * a visible gap that reads as "category absent on this side." This is
1789
+ * the **gap-on-absent** semantic locked in DRC-3390.
1790
+ *
1791
+ * Two rendering modes share the same slot/bar layout:
1792
+ *
1793
+ * - **counts** (default) — bars sized by per-side proportion. Used when
1794
+ * the backend can return both values and counts (e.g. DuckDB
1795
+ * `approx_top_k_counts`, Snowflake `APPROX_TOP_K`).
1796
+ * - **ranks** — bars sized by rank position only, with
1797
+ * `height = (k - rank + 1) / k * chartHeight`. Used when the engine
1798
+ * only returns top-K values without counts (DuckDB `approx_top_k`).
1799
+ * Stable case reads as two side-by-side descending staircases; an
1800
+ * order shift makes current bars zig-zag against base's clean descent.
1801
+ *
1802
+ * Stage B's wire contract guarantees both sides use the same algorithm —
1803
+ * if either side has no counts, both are returned as rank-only. The cell
1804
+ * never has to mix counts on one side with ranks on the other.
1805
+ *
1806
+ * Bar palette + theme colors come from `getChartBarColors` /
1807
+ * `getChartThemeColors` (canonical in `@datarecce/ui/theme`).
1808
+ */
1809
+ /**
1810
+ * Counts-mode payload. Matches `ProfileDistributionTopKPayload`
1811
+ * from the run API (snake_case wire format) so callers can pass results
1812
+ * through with minimal adapting.
1813
+ */
1814
+ interface PairedHistogramDiscreteCountsData {
1815
+ /** Optional discriminator — absent or `"counts"` selects this mode. */
1816
+ mode?: "counts";
1817
+ /** Display order = union(baseTopK, currentTopK), backend-chosen.
1818
+ * Caller may pre-sort (e.g. frequency-desc) for cell density.
1819
+ *
1820
+ * Element type is `unknown` to match Stage B's wire contract — values
1821
+ * may arrive as strings, numbers, booleans, dates, NULL, etc. The
1822
+ * renderer routes each value through `formatValue` to produce its
1823
+ * display string. */
1824
+ values: unknown[];
1825
+ baseCounts: number[];
1826
+ currentCounts: number[];
1827
+ /** Denominator for per-slot proportions. Convention is the **column-wide**
1828
+ * row count, not `sum(baseCounts)` — so a trimmed top-K renders bars
1829
+ * whose proportions sum to <1 (the missing mass is the long tail). When
1830
+ * trimmed is false (or absent), column total and sum-of-shown coincide.
1831
+ * Stage B owns the wire-format contract; cells just consume what's passed. */
1832
+ baseTotal: number;
1833
+ currentTotal: number;
1834
+ /** True when the original distribution had more values than K — caller
1835
+ * passes this through from the payload's `trimmed` field. */
1836
+ trimmed?: boolean;
1837
+ }
1838
+ /**
1839
+ * Ranks-mode payload — used when the backend cannot return counts (the
1840
+ * DuckDB `approx_top_k` path). Bar heights encode rank position only.
1841
+ *
1842
+ * Slot order is **baked in by the caller**: base's top-K in base-rank
1843
+ * order, then values that appear only in current's top-K appended on the
1844
+ * right (sorted by current rank ascending). The component renders the
1845
+ * `values` array straight through — it does not re-sort.
1846
+ */
1847
+ interface PairedHistogramDiscreteRanksData {
1848
+ /** Discriminator — selects rank-only rendering. */
1849
+ mode: "ranks";
1850
+ /** Display order = base's top-K in base-rank order, then values
1851
+ * in current's top-K but not base's, sorted by current rank.
1852
+ *
1853
+ * Element type is `unknown` to match Stage B's wire contract — values
1854
+ * may arrive as strings, numbers, booleans, dates, NULL, etc. The
1855
+ * renderer routes each value through `formatValue` to produce its
1856
+ * display string. */
1857
+ values: unknown[];
1858
+ /** Per-value rank in base's top-K, 1-indexed. `null` = value not in
1859
+ * base's top-K (no base bar drawn for that slot). */
1860
+ baseRanks: (number | null)[];
1861
+ /** Per-value rank in current's top-K, 1-indexed. `null` = value not
1862
+ * in current's top-K (no current bar drawn for that slot). */
1863
+ currentRanks: (number | null)[];
1864
+ /** Max rank in top-K (e.g. 12). Drives bar-height scaling. */
1865
+ k: number;
1866
+ /** True when the original distribution had more values than K. */
1867
+ trimmed?: boolean;
1868
+ }
1869
+ /**
1870
+ * Discriminated union of the two supported payload shapes. Counts mode
1871
+ * sizes bars by per-side proportion; ranks mode sizes by rank position.
1872
+ */
1873
+ type PairedHistogramDiscreteData = PairedHistogramDiscreteCountsData | PairedHistogramDiscreteRanksData;
1874
+ interface PairedHistogramDiscreteProps {
1875
+ data: PairedHistogramDiscreteData;
1876
+ /**
1877
+ * Convert each raw value to its display string. Default: `String(v)`.
1878
+ * Override to handle NULL nicely, abbreviate large numbers, format
1879
+ * dates, etc.
1880
+ *
1881
+ * Stage B's payload contract types `values` as `unknown[]`; this hook
1882
+ * is the cell's single seam for turning heterogeneous raw values into
1883
+ * something legible. Stage C will dispatch on column type and pass the
1884
+ * right formatter; the cell itself stays type-blind.
1885
+ */
1886
+ formatValue?: (v: unknown) => string;
1887
+ /** Optional CSS class. */
1888
+ className?: string;
1889
+ }
1890
+ /**
1891
+ * PairedHistogramDiscrete — paired-bar top-K chart with gap-on-absent
1892
+ * semantics, fixed `CELL_WIDTH × CELL_HEIGHT` (140×28) for SchemaView
1893
+ * cell density. Supports counts mode (proportion-sized bars) and ranks
1894
+ * mode (rank-position-sized bars).
1895
+ *
1896
+ * @example
1897
+ * ```tsx
1898
+ * <PairedHistogramDiscrete data={topK} />
1899
+ * ```
1900
+ */
1901
+ declare function PairedHistogramDiscrete({
1902
+ data,
1903
+ formatValue,
1904
+ className
1905
+ }: PairedHistogramDiscreteProps): import("react/jsx-runtime").JSX.Element;
1906
+ //#endregion
1907
+ //#region src/components/data/ProfileDistributionUnsupportedBanner.d.ts
1908
+ /**
1909
+ * One-time banner shown when the dbt adapter can't run the paired-
1910
+ * distribution feature at all (e.g. Postgres, MySQL, SQLite,
1911
+ * SQL Server < 2022). The backend signals this with a single
1912
+ * `{status: "unsupported", reason: ...}` envelope rather than a per-
1913
+ * column payload. DRC-3390 PR 3.
1914
+ *
1915
+ * The banner is intentionally low-key (MUI Alert "info" severity, dense
1916
+ * padding) so it doesn't dominate the schema view when the feature is
1917
+ * flag-enabled but unavailable on this warehouse. It carries the
1918
+ * backend's `reason` string so users know *why* — usually "adapter
1919
+ * lacks native HLL / approx_percentile / approx_top_k".
1920
+ */
1921
+ interface ProfileDistributionUnsupportedBannerProps {
1922
+ /** Backend-provided explanation. Falls back to a generic message. */
1923
+ reason?: string;
1924
+ /** Optional adapter-type for a more specific message (e.g. "postgres"). */
1925
+ adapterType?: string;
1926
+ /** Optional CSS class override. */
1927
+ className?: string;
1928
+ }
1929
+ declare function ProfileDistributionUnsupportedBanner({
1930
+ reason,
1931
+ adapterType,
1932
+ className
1933
+ }: ProfileDistributionUnsupportedBannerProps): import("react/jsx-runtime").JSX.Element;
1934
+ //#endregion
1935
+ //#region src/components/data/TopKBarChart.d.ts
1936
+ /**
1937
+ * Single Top-K value item
1938
+ */
1939
+ interface TopKItem {
1940
+ /** Value label */
1941
+ label: string;
1942
+ /** Count */
1943
+ count: number;
1944
+ /** Whether this is a special label (null, empty, others) */
1945
+ isSpecial?: boolean;
1946
+ }
1947
+ /**
1948
+ * Top-K dataset for a single environment
1949
+ * Compatible with TopKResult from @datarecce/ui/api
1950
+ */
1951
+ interface TopKDataset {
1952
+ /** Value labels (null or undefined treated as special) */
1953
+ values: (string | number | null | undefined)[];
1954
+ /** Counts per value */
1955
+ counts: number[];
1956
+ /** Total valid count */
1957
+ valids: number;
1958
+ }
1959
+ /**
1960
+ * Props for the TopKBarChart component
1961
+ */
1962
+ interface TopKBarChartProps {
1963
+ /** Base environment dataset */
1964
+ baseData?: TopKDataset;
1965
+ /** Current environment dataset */
1966
+ currentData: TopKDataset;
1967
+ /** Maximum items to display (default 10) */
1968
+ maxItems?: number;
1969
+ /** Show comparison with base */
1970
+ showComparison?: boolean;
1971
+ /** Theme mode */
1972
+ theme?: "light" | "dark";
1973
+ /** Chart title */
1974
+ title?: string;
1975
+ /** Optional CSS class */
1976
+ className?: string;
1977
+ }
1978
+ /**
1979
+ * TopKBarChart Component
1980
+ *
1981
+ * A pure presentation component for displaying top-k value distributions
1982
+ * with optional base/current comparison.
1983
+ *
1984
+ * @example Basic usage
1985
+ * ```tsx
1986
+ * import { TopKBarChart } from '@datarecce/ui/primitives';
1987
+ *
1988
+ * function ValueDistribution({ topKData }) {
1989
+ * return (
1990
+ * <TopKBarChart
1991
+ * currentData={topKData}
1992
+ * maxItems={10}
1993
+ * />
1994
+ * );
1995
+ * }
1996
+ * ```
1997
+ *
1998
+ * @example With comparison
1999
+ * ```tsx
2000
+ * <TopKBarChart
2001
+ * baseData={baseTopK}
2002
+ * currentData={currentTopK}
2003
+ * showComparison
2004
+ * maxItems={10}
2005
+ * />
2006
+ * ```
2007
+ */
2008
+ declare function TopKBarChartComponent({
2009
+ baseData,
2010
+ currentData,
2011
+ maxItems,
2012
+ showComparison,
2013
+ theme,
2014
+ title,
2015
+ className
2016
+ }: TopKBarChartProps): import("react/jsx-runtime").JSX.Element;
2017
+ declare const TopKBarChart: import("react").MemoExoticComponent<typeof TopKBarChartComponent>;
2018
+ //#endregion
2019
+ //#region src/components/schema/ColumnNameCell.d.ts
2020
+ /**
2021
+ * Props for the ColumnNameCell component
2022
+ */
2023
+ interface ColumnNameCellProps {
2024
+ /** The model/node data containing column information */
2025
+ model: NodeData;
2026
+ /** The schema diff row data for this column */
2027
+ row: SchemaDiffRow;
2028
+ /** Whether viewing a single environment (disables diff menu) */
2029
+ singleEnv?: boolean;
2030
+ /** Whether column-level lineage is currently being computed */
2031
+ cllRunning?: boolean;
2032
+ /** Whether to show the context menu (defaults to true) */
2033
+ showMenu?: boolean;
2034
+ /** Callback when user clicks a definition-changed badge to view SQL diff */
2035
+ onViewCode?: () => void;
2036
+ /** Whether this column is impacted by upstream changes */
2037
+ isImpacted?: boolean;
2038
+ }
2039
+ /**
2040
+ * ColumnNameCell - Renders a column name with optional diff action menu
2041
+ *
2042
+ * Displays the column name with:
2043
+ * - A context menu for initiating diff operations (when applicable)
2044
+ * - A loading spinner when column-level lineage is running
2045
+ * - Tooltip indicating column lineage viewing capability
2046
+ *
2047
+ * The menu is hidden when:
2048
+ * - showMenu is false
2049
+ * - singleEnv is true (no comparison available)
2050
+ * - The model is a source (sources don't support diff operations)
2051
+ */
2052
+ declare function ColumnNameCell({
2053
+ model,
2054
+ row,
2055
+ singleEnv,
2056
+ cllRunning,
2057
+ showMenu,
2058
+ onViewCode,
2059
+ isImpacted
2060
+ }: ColumnNameCellProps): import("react/jsx-runtime").JSX.Element;
2061
+ //#endregion
2062
+ //#region src/components/schema/SchemaView.d.ts
2063
+ declare function SchemaLegend(): import("react/jsx-runtime").JSX.Element;
2064
+ interface SchemaViewProps {
2065
+ base?: NodeData;
2066
+ current?: NodeData;
2067
+ enableScreenshot?: boolean;
2068
+ showMenu?: boolean;
2069
+ /** Per-column change status from breaking change analysis */
2070
+ columnChanges?: Record<string, "added" | "removed" | "modified" | "unknown"> | null;
2071
+ /** Callback when user clicks a definition-changed badge to view SQL diff */
2072
+ onViewCode?: () => void;
2073
+ /** Optional action element rendered next to the legend (e.g. add-to-checklist button) */
2074
+ headerAction?: ReactNode;
2075
+ }
2076
+ declare const SchemaView: import("react").ForwardRefExoticComponent<SchemaViewProps & import("react").RefAttributes<DataGridHandle>>;
2077
+ declare const SingleEnvSchemaView: import("react").ForwardRefExoticComponent<{
2078
+ current?: NodeData;
2079
+ showMenu?: boolean;
2080
+ } & import("react").RefAttributes<DataGridHandle>>;
2081
+ //#endregion
2082
+ //#region src/components/ui/dataGrid/schemaCells.d.ts
2083
+ /**
2084
+ * Per-task distribution data threaded into the schema grid (DRC-3390 Stage C).
2085
+ * Holds the resolved per-column payloads plus the run-level loading/error
2086
+ * flags so the Distribution column's renderer can pick the right cell state.
2087
+ */
2088
+ interface SchemaDistributionData {
2089
+ /** Per-column payloads keyed by column name. */
2090
+ payloads: Record<string, ProfileDistributionColumnPayload>;
2091
+ /** Envelope-level totals — denominator for counts-mode proportions. */
2092
+ baseTotal: number;
2093
+ currentTotal: number;
2094
+ /** True while the run is in flight (cells show a pending dot). */
2095
+ isLoading: boolean;
2096
+ /** True when the run failed at the task level (not per-column). */
2097
+ hasError: boolean;
2098
+ /**
2099
+ * Column names the run actually requested. `undefined` means every column was
2100
+ * profiled (whole-model change or "Profile all columns"). Columns outside this
2101
+ * set were never part of the run, so the run-level pending/error state must not
2102
+ * bleed onto them — they stay blank.
2103
+ */
2104
+ scopedColumns?: string[];
2105
+ }
2106
+ //#endregion
2107
+ //#region src/lib/dataGrid/generators/toSchemaDataGrid.d.ts
2108
+ interface SchemaDiffRow extends RowObjectType {
2109
+ name: string;
2110
+ reordered?: boolean;
2111
+ currentIndex?: number;
2112
+ baseIndex?: number;
2113
+ currentType?: string;
2114
+ baseType?: string;
2115
+ /** True when the column's SQL definition changed but name/type stayed the same */
2116
+ definitionChanged?: boolean;
2117
+ /**
2118
+ * True when the analyzer couldn't determine the column's change status
2119
+ * (e.g., CTE-internal column with missing parent schema). Mutually exclusive
2120
+ * with definitionChanged.
2121
+ */
2122
+ changeUnknown?: boolean;
2123
+ /** True when the column traces upstream to a changed column via CLL parent_map */
2124
+ isImpacted?: boolean;
2125
+ }
2126
+ interface SchemaRow extends RowObjectType {
2127
+ name: string;
2128
+ index: number;
2129
+ type?: string;
2130
+ }
2131
+ type SchemaDiff = Record<string, SchemaDiffRow>;
2132
+ interface SchemaDataGridOptions {
2133
+ /** Node data for context menu actions */
2134
+ node?: NodeData;
2135
+ /** Map of column names to CLL loading state */
2136
+ cllRunningMap?: Map<string, boolean>;
2137
+ /** Whether to show the column action menu (default: true) */
2138
+ showMenu?: boolean;
2139
+ /** Per-column change status from breaking change analysis */
2140
+ columnChanges?: Record<string, "added" | "removed" | "modified" | "unknown"> | null;
2141
+ /** Callback when user clicks a definition-changed badge to view SQL diff */
2142
+ onViewCode?: () => void;
2143
+ /** Set of impacted column IDs from CLL parent_map walk (e.g. "model.jaffle_shop.orders_STATUS") */
2144
+ impactedColumns?: Set<string>;
2145
+ /** Node unique_id, used to build column IDs for impacted lookup */
2146
+ nodeId?: string;
2147
+ /**
2148
+ * Inline paired-distribution data (DRC-3390 Stage C). When present, a
2149
+ * "Distribution" column is appended to the schema-diff grid. Omitted when
2150
+ * the `inline_profile` flag is off or the adapter is unsupported.
2151
+ */
2152
+ distribution?: SchemaDistributionData;
2153
+ }
2154
+ interface SchemaDataGridResult {
2155
+ columns: (ColDef<SchemaDiffRow> | ColGroupDef<SchemaDiffRow>)[];
2156
+ rows: SchemaDiffRow[];
2157
+ }
2158
+ interface SingleEnvSchemaDataGridResult {
2159
+ columns: (ColDef<SchemaRow> | ColGroupDef<SchemaRow>)[];
2160
+ rows: SchemaRow[];
2161
+ }
2162
+ /**
2163
+ * Merges base and current column schemas into a diff structure
2164
+ */
2165
+ declare function mergeColumns(baseColumns?: NodeData["columns"], currentColumns?: NodeData["columns"]): SchemaDiff;
2166
+ /**
2167
+ * Generates grid configuration for schema diff view
2168
+ * Uses merged columns: Index (merged base/current), Name (with inline DataTypeIcon)
2169
+ */
2170
+ declare function toSchemaDataGrid(schemaDiff: SchemaDiff, options?: SchemaDataGridOptions): SchemaDataGridResult;
2171
+ /**
2172
+ * Generates grid configuration for single-environment schema view
2173
+ */
2174
+ declare function toSingleEnvDataGrid(nodeColumns?: NodeData["columns"], options?: SchemaDataGridOptions): SingleEnvSchemaDataGridResult;
2175
+ //#endregion
2176
+ //#region src/components/schema/types.d.ts
2177
+ /**
2178
+ * @file types.ts
2179
+ * @description Schema diff types for comparing schemas between environments.
2180
+ */
2181
+ /**
2182
+ * Schema diff row status
2183
+ */
2184
+ type SchemaDiffStatus = "added" | "removed" | "modified" | "unchanged";
2185
+ //#endregion
2186
+ //#region src/components/editor/CodeEditor.d.ts
2187
+ /**
2188
+ * Supported languages for the code editor
2189
+ */
2190
+ type CodeEditorLanguage = "sql" | "yaml" | "text";
2191
+ /**
2192
+ * Theme options for the code editor
2193
+ */
2194
+ type CodeEditorTheme = "light" | "dark";
2195
+ /**
2196
+ * Props for the CodeEditor component
2197
+ */
2198
+ interface CodeEditorProps {
2199
+ /** The code content to display */
2200
+ value: string;
2201
+ /** Callback when content changes */
2202
+ onChange?: (value: string) => void;
2203
+ /** Language for syntax highlighting */
2204
+ language?: CodeEditorLanguage;
2205
+ /** Whether editor is read-only */
2206
+ readOnly?: boolean;
2207
+ /** Show line numbers */
2208
+ lineNumbers?: boolean;
2209
+ /** Enable word wrap */
2210
+ wordWrap?: boolean;
2211
+ /** Font size in pixels */
2212
+ fontSize?: number;
2213
+ /** Editor height */
2214
+ height?: string;
2215
+ /** Optional CSS class */
2216
+ className?: string;
2217
+ /** Theme mode */
2218
+ theme?: CodeEditorTheme;
2219
+ /** Custom keyboard shortcuts */
2220
+ keyBindings?: Array<{
2221
+ key: string;
2222
+ run: () => boolean;
2223
+ }>;
2224
+ }
2225
+ /**
2226
+ * CodeEditor Component
2227
+ *
2228
+ * A code editor component using CodeMirror with React integration.
2229
+ * Supports SQL and YAML syntax highlighting with customizable theming.
2230
+ *
2231
+ * @example Basic usage
2232
+ * ```tsx
2233
+ * import { CodeEditor } from '@datarecce/ui/primitives';
2234
+ *
2235
+ * function SqlEditor({ sql, onSqlChange }) {
2236
+ * return (
2237
+ * <CodeEditor
2238
+ * value={sql}
2239
+ * onChange={onSqlChange}
2240
+ * language="sql"
2241
+ * />
2242
+ * );
2243
+ * }
2244
+ * ```
2245
+ *
2246
+ * @example Read-only with dark theme
2247
+ * ```tsx
2248
+ * <CodeEditor
2249
+ * value={yamlContent}
2250
+ * language="yaml"
2251
+ * readOnly
2252
+ * theme="dark"
2253
+ * height="300px"
2254
+ * />
2255
+ * ```
2256
+ *
2257
+ * @example With custom key bindings
2258
+ * ```tsx
2259
+ * const keyBindings = [
2260
+ * { key: "Mod-Enter", run: () => { handleSubmit(); return true; } }
2261
+ * ];
2262
+ *
2263
+ * <CodeEditor
2264
+ * value={sql}
2265
+ * onChange={setSql}
2266
+ * language="sql"
2267
+ * keyBindings={keyBindings}
2268
+ * />
2269
+ * ```
2270
+ */
2271
+ declare function CodeEditor({
2272
+ value,
2273
+ onChange,
2274
+ language,
2275
+ readOnly,
2276
+ lineNumbers,
2277
+ wordWrap,
2278
+ fontSize,
2279
+ height,
2280
+ className,
2281
+ theme,
2282
+ keyBindings
2283
+ }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;
2284
+ //#endregion
2285
+ //#region src/components/editor/DiffEditor.d.ts
2286
+ /**
2287
+ * Supported languages for the diff editor
2288
+ */
2289
+ type DiffEditorLanguage = "sql" | "yaml" | "text";
2290
+ /**
2291
+ * Theme options for the diff editor
2292
+ */
2293
+ type DiffEditorTheme = "light" | "dark";
2294
+ /**
2295
+ * Props for the DiffEditor component
2296
+ */
2297
+ interface DiffEditorProps {
2298
+ /** Original (base) text content */
2299
+ original: string;
2300
+ /** Modified (current) text content */
2301
+ modified: string;
2302
+ /** Language for syntax highlighting */
2303
+ language?: DiffEditorLanguage;
2304
+ /** Whether editor is read-only */
2305
+ readOnly?: boolean;
2306
+ /** Show line numbers */
2307
+ lineNumbers?: boolean;
2308
+ /** Side-by-side view (true) or unified view (false) */
2309
+ sideBySide?: boolean;
2310
+ /** Editor height */
2311
+ height?: string;
2312
+ /** Theme mode */
2313
+ theme?: DiffEditorTheme;
2314
+ /** Callback when modified content changes */
2315
+ onModifiedChange?: (value: string) => void;
2316
+ /** Optional CSS class */
2317
+ className?: string;
2318
+ }
2319
+ /**
2320
+ * DiffEditor Component
2321
+ *
2322
+ * A pure presentation component for displaying text diffs using CodeMirror's
2323
+ * merge view. Supports side-by-side and unified diff views.
2324
+ *
2325
+ * @example Basic usage
2326
+ * ```tsx
2327
+ * import { DiffEditor } from '@datarecce/ui/primitives';
2328
+ *
2329
+ * function SqlDiffPanel({ baseSql, currentSql }) {
2330
+ * return (
2331
+ * <DiffEditor
2332
+ * original={baseSql}
2333
+ * modified={currentSql}
2334
+ * language="sql"
2335
+ * sideBySide
2336
+ * />
2337
+ * );
2338
+ * }
2339
+ * ```
2340
+ *
2341
+ * @example Unified view with editing
2342
+ * ```tsx
2343
+ * const [modifiedSql, setModifiedSql] = useState(currentSql);
2344
+ *
2345
+ * <DiffEditor
2346
+ * original={baseSql}
2347
+ * modified={modifiedSql}
2348
+ * language="sql"
2349
+ * sideBySide={false}
2350
+ * onModifiedChange={setModifiedSql}
2351
+ * />
2352
+ * ```
2353
+ */
2354
+ declare function DiffEditorComponent({
2355
+ original,
2356
+ modified,
2357
+ language,
2358
+ readOnly,
2359
+ lineNumbers: showLineNumbers,
2360
+ sideBySide,
2361
+ height,
2362
+ theme,
2363
+ onModifiedChange,
2364
+ className
2365
+ }: DiffEditorProps): import("react/jsx-runtime").JSX.Element;
2366
+ declare const DiffEditor: import("react").MemoExoticComponent<typeof DiffEditorComponent>;
2367
+ //#endregion
2368
+ //#region src/components/ui/ChangedOnlyCheckbox.d.ts
2369
+ interface ChangedOnlyCheckboxProps {
2370
+ /** Whether the changed-only filter is enabled */
2371
+ changedOnly?: boolean;
2372
+ /** Callback when the checkbox state changes */
2373
+ onChange: () => void;
2374
+ }
2375
+ /**
2376
+ * A checkbox component for filtering diff results to show only changed rows.
2377
+ *
2378
+ * @example
2379
+ * ```tsx
2380
+ * <ChangedOnlyCheckbox
2381
+ * changedOnly={viewOptions.changed_only}
2382
+ * onChange={() => setChangedOnly(!viewOptions.changed_only)}
2383
+ * />
2384
+ * ```
2385
+ */
2386
+ declare function ChangedOnlyCheckbox({
2387
+ changedOnly,
2388
+ onChange
2389
+ }: ChangedOnlyCheckboxProps): import("react/jsx-runtime").JSX.Element;
2390
+ //#endregion
2391
+ //#region src/components/ui/DiffDisplayModeSwitch.d.ts
2392
+ type DiffDisplayMode = "inline" | "side_by_side";
2393
+ interface DiffDisplayModeSwitchProps {
2394
+ /** Current display mode */
2395
+ displayMode: DiffDisplayMode;
2396
+ /** Callback when display mode changes */
2397
+ onDisplayModeChanged: (displayMode: DiffDisplayMode) => void;
2398
+ }
2399
+ /**
2400
+ * A switch component for toggling between inline and side-by-side diff display modes.
2401
+ *
2402
+ * When in inline mode, also shows color legend (Base = red, Current = green).
2403
+ *
2404
+ * @example
2405
+ * ```tsx
2406
+ * <DiffDisplayModeSwitch
2407
+ * displayMode="inline"
2408
+ * onDisplayModeChanged={(mode) => setDisplayMode(mode)}
2409
+ * />
2410
+ * ```
2411
+ */
2412
+ declare function DiffDisplayModeSwitch({
2413
+ displayMode,
2414
+ onDisplayModeChanged
2415
+ }: DiffDisplayModeSwitchProps): import("react/jsx-runtime").JSX.Element;
2416
+ //#endregion
2417
+ //#region src/components/ui/DiffText.d.ts
2418
+ /**
2419
+ * Props for the DiffText component
2420
+ */
2421
+ interface DiffTextProps {
2422
+ /** The text value to display */
2423
+ value: string;
2424
+ /** Color palette for the diff indicator */
2425
+ colorPalette: "red" | "green";
2426
+ /** Whether to gray out the text (for null/missing values) */
2427
+ grayOut?: boolean;
2428
+ /** Hide the copy button */
2429
+ noCopy?: boolean;
2430
+ /** Custom font size */
2431
+ fontSize?: string;
2432
+ /**
2433
+ * Callback when copy button is clicked.
2434
+ * If provided, the component will use this for copy functionality.
2435
+ * If not provided, uses navigator.clipboard.writeText.
2436
+ */
2437
+ onCopy?: (value: string) => void;
2438
+ }
2439
+ /**
2440
+ * DiffText Component
2441
+ *
2442
+ * Displays a text value with diff styling (red for removed, green for added).
2443
+ * Includes an optional copy-to-clipboard button on hover.
2444
+ *
2445
+ * @example Basic usage
2446
+ * ```tsx
2447
+ * import { DiffText } from '@datarecce/ui';
2448
+ *
2449
+ * // Show a value that was added (green)
2450
+ * <DiffText value="new_value" colorPalette="green" />
2451
+ *
2452
+ * // Show a value that was removed (red)
2453
+ * <DiffText value="old_value" colorPalette="red" />
2454
+ * ```
2455
+ *
2456
+ * @example With custom copy callback
2457
+ * ```tsx
2458
+ * <DiffText
2459
+ * value="copy_me"
2460
+ * colorPalette="green"
2461
+ * onCopy={(value) => {
2462
+ * navigator.clipboard.writeText(value);
2463
+ * showToast(`${value} copied!`);
2464
+ * }}
2465
+ * />
2466
+ * ```
2467
+ *
2468
+ * @example Grayed out (null value)
2469
+ * ```tsx
2470
+ * <DiffText value="null" colorPalette="red" grayOut />
2471
+ * ```
2472
+ */
2473
+ declare function DiffText({
2474
+ value,
2475
+ colorPalette,
2476
+ grayOut,
2477
+ noCopy,
2478
+ fontSize,
2479
+ onCopy
2480
+ }: DiffTextProps): import("react/jsx-runtime").JSX.Element;
2481
+ //#endregion
2482
+ //#region src/components/ui/DiffTextWithToast.d.ts
2483
+ type DiffTextWithToastProps = Omit<DiffTextProps, "onCopy">;
2484
+ /**
2485
+ * DiffText component with automatic copy-to-clipboard toast notifications.
2486
+ *
2487
+ * This is a convenience wrapper around the base DiffText component that adds
2488
+ * the toast notification behavior. Use this when you want the "batteries included"
2489
+ * experience with copy feedback.
2490
+ *
2491
+ * @example
2492
+ * ```tsx
2493
+ * // Shows toast when user clicks copy icon
2494
+ * <DiffTextWithToast base="old value" current="new value" />
2495
+ * ```
2496
+ */
2497
+ declare function DiffTextWithToast(props: DiffTextWithToastProps): import("react/jsx-runtime").JSX.Element;
2498
+ //#endregion
2499
+ //#region src/components/ui/DropdownValuesInput.d.ts
2500
+ /**
2501
+ * @file DropdownValuesInput.tsx
2502
+ * @description Multi-select dropdown input component with filtering and custom value support
2503
+ *
2504
+ * Features:
2505
+ * - Dropdown menu with suggestion list
2506
+ * - Filter/search functionality (case-insensitive)
2507
+ * - Chip-based value display with removal
2508
+ * - Keyboard navigation (Enter, comma, Backspace)
2509
+ * - Custom value addition
2510
+ * - Configurable size variants
2511
+ */
2512
+ /**
2513
+ * Size variants for the dropdown input
2514
+ */
2515
+ type DropdownValuesInputSize = "2xs" | "xs" | "sm" | "md" | "lg";
2516
+ /**
2517
+ * Props for the DropdownValuesInput component
2518
+ */
2519
+ interface DropdownValuesInputProps {
2520
+ /** Unit name for pluralization in "X {unitName}s selected" display */
2521
+ unitName: string;
2522
+ /** List of suggested values to show in dropdown */
2523
+ suggestionList?: string[];
2524
+ /** Initial selected values */
2525
+ defaultValues?: string[];
2526
+ /** Callback when selected values change */
2527
+ onValuesChange: (values: string[]) => void;
2528
+ /** Optional CSS class name */
2529
+ className?: string;
2530
+ /** Size variant for the input */
2531
+ size?: DropdownValuesInputSize;
2532
+ /** Width of the input (CSS value or number in pixels) */
2533
+ width?: string | number;
2534
+ /** Placeholder text when no values are selected */
2535
+ placeholder?: string;
2536
+ /** Whether the input is disabled */
2537
+ disabled?: boolean;
2538
+ }
2539
+ /**
2540
+ * A multi-select dropdown input component for selecting multiple values.
2541
+ *
2542
+ * Provides a dropdown menu with suggestion list, filtering, and the ability
2543
+ * to add custom values. Selected values are displayed as chips that can be
2544
+ * removed individually.
2545
+ *
2546
+ * @example
2547
+ * ```tsx
2548
+ * <DropdownValuesInput
2549
+ * unitName="key"
2550
+ * suggestionList={["id", "name", "email"]}
2551
+ * defaultValues={["id"]}
2552
+ * onValuesChange={(values) => console.log(values)}
2553
+ * placeholder="Select or type to add keys"
2554
+ * size="sm"
2555
+ * width={240}
2556
+ * />
2557
+ * ```
2558
+ */
2559
+ declare const DropdownValuesInput: (props: DropdownValuesInputProps) => import("react/jsx-runtime").JSX.Element;
2560
+ //#endregion
2561
+ //#region src/components/ui/EmptyState.d.ts
2562
+ /**
2563
+ * Props for the EmptyState component
2564
+ */
2565
+ interface EmptyStateProps {
2566
+ /** Main title text */
2567
+ title: string;
2568
+ /** Description text */
2569
+ description?: string;
2570
+ /** Icon to display */
2571
+ icon?: ReactNode;
2572
+ /** Primary action button text */
2573
+ actionLabel?: string;
2574
+ /** Primary action callback */
2575
+ onAction?: () => void;
2576
+ /** Secondary action button text */
2577
+ secondaryActionLabel?: string;
2578
+ /** Secondary action callback */
2579
+ onSecondaryAction?: () => void;
2580
+ /** Theme mode */
2581
+ theme?: "light" | "dark";
2582
+ /** Vertical padding */
2583
+ paddingY?: number;
2584
+ /** Optional CSS class */
2585
+ className?: string;
2586
+ /** Additional content below actions */
2587
+ children?: ReactNode;
2588
+ }
2589
+ /**
2590
+ * EmptyState Component
2591
+ *
2592
+ * A pure presentation component for displaying empty states
2593
+ * with optional icon, actions, and custom content.
2594
+ *
2595
+ * @example Basic usage
2596
+ * ```tsx
2597
+ * import { EmptyState } from '@datarecce/ui/primitives';
2598
+ *
2599
+ * function ChecksPanel({ checks }) {
2600
+ * if (checks.length === 0) {
2601
+ * return (
2602
+ * <EmptyState
2603
+ * title="No checks yet"
2604
+ * description="Create your first check to get started"
2605
+ * />
2606
+ * );
2607
+ * }
2608
+ * // ... render checks
2609
+ * }
2610
+ * ```
2611
+ *
2612
+ * @example With action button
2613
+ * ```tsx
2614
+ * <EmptyState
2615
+ * title="No results found"
2616
+ * description="Try adjusting your search criteria"
2617
+ * actionLabel="Clear Filters"
2618
+ * onAction={() => clearFilters()}
2619
+ * />
2620
+ * ```
2621
+ *
2622
+ * @example With icon and multiple actions
2623
+ * ```tsx
2624
+ * <EmptyState
2625
+ * icon={<FolderIcon />}
2626
+ * title="No files"
2627
+ * description="Upload files to get started"
2628
+ * actionLabel="Upload File"
2629
+ * onAction={handleUpload}
2630
+ * secondaryActionLabel="Learn More"
2631
+ * onSecondaryAction={() => window.open(docsUrl)}
2632
+ * />
2633
+ * ```
2634
+ */
2635
+ declare function EmptyStateComponent({
2636
+ title,
2637
+ description,
2638
+ icon,
2639
+ actionLabel,
2640
+ onAction,
2641
+ secondaryActionLabel,
2642
+ onSecondaryAction,
2643
+ theme,
2644
+ paddingY,
2645
+ className,
2646
+ children
2647
+ }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;
2648
+ declare const EmptyState: import("react").MemoExoticComponent<typeof EmptyStateComponent>;
2649
+ //#endregion
2650
+ //#region src/components/ui/ExternalLinkConfirmDialog.d.ts
2651
+ /**
2652
+ * Props for ExternalLinkConfirmDialog
2653
+ */
2654
+ interface ExternalLinkConfirmDialogProps {
2655
+ /** Whether the dialog is open */
2656
+ isOpen: boolean;
2657
+ /** The external URL the user is trying to navigate to */
2658
+ url: string;
2659
+ /** Callback when user confirms navigation */
2660
+ onConfirm: () => void;
2661
+ /** Callback when user cancels navigation */
2662
+ onCancel: () => void;
2663
+ }
2664
+ /**
2665
+ * Truncate a URL for display, keeping the domain visible
2666
+ */
2667
+ declare function truncateUrl(url: string, maxLength?: number): string;
2668
+ /**
2669
+ * ExternalLinkConfirmDialog Component
2670
+ *
2671
+ * A dialog that asks users to confirm before navigating to external URLs.
2672
+ *
2673
+ * @example Basic usage
2674
+ * ```tsx
2675
+ * import { ExternalLinkConfirmDialog } from '@datarecce/ui/primitives';
2676
+ *
2677
+ * function MyComponent() {
2678
+ * const [isOpen, setIsOpen] = useState(false);
2679
+ * const [pendingUrl, setPendingUrl] = useState('');
2680
+ *
2681
+ * return (
2682
+ * <ExternalLinkConfirmDialog
2683
+ * isOpen={isOpen}
2684
+ * url={pendingUrl}
2685
+ * onConfirm={() => {
2686
+ * window.open(pendingUrl, '_blank');
2687
+ * setIsOpen(false);
2688
+ * }}
2689
+ * onCancel={() => setIsOpen(false)}
2690
+ * />
2691
+ * );
2692
+ * }
2693
+ * ```
2694
+ */
2695
+ declare function ExternalLinkConfirmDialog({
2696
+ isOpen,
2697
+ url,
2698
+ onConfirm,
2699
+ onCancel
2700
+ }: ExternalLinkConfirmDialogProps): import("react/jsx-runtime").JSX.Element;
2701
+ //#endregion
2702
+ //#region src/components/ui/MarkdownContent.d.ts
2703
+ /**
2704
+ * Props for MarkdownContent component
2705
+ */
2706
+ interface MarkdownContentProps {
2707
+ /** The markdown content to render */
2708
+ content: string;
2709
+ /** Font size for the rendered content */
2710
+ fontSize?: string;
2711
+ /** Additional domains to treat as internal (not showing confirmation) */
2712
+ internalDomains?: string[];
2713
+ }
2714
+ /**
2715
+ * MarkdownContent Component
2716
+ *
2717
+ * A component for rendering GitHub-flavored Markdown with syntax highlighting
2718
+ * and external link confirmation.
2719
+ *
2720
+ * @example Basic usage
2721
+ * ```tsx
2722
+ * import { MarkdownContent } from '@datarecce/ui/primitives';
2723
+ *
2724
+ * function Description({ text }) {
2725
+ * return <MarkdownContent content={text} />;
2726
+ * }
2727
+ * ```
2728
+ *
2729
+ * @example With custom font size
2730
+ * ```tsx
2731
+ * <MarkdownContent content={markdown} fontSize="1rem" />
2732
+ * ```
2733
+ *
2734
+ * @example With additional internal domains
2735
+ * ```tsx
2736
+ * <MarkdownContent
2737
+ * content={markdown}
2738
+ * internalDomains={['company.com', 'docs.company.com']}
2739
+ * />
2740
+ * ```
2741
+ */
2742
+ declare function MarkdownContent({
2743
+ content,
2744
+ fontSize,
2745
+ internalDomains
2746
+ }: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
2747
+ //#endregion
2748
+ //#region src/components/ui/ScreenshotBox.d.ts
2749
+ interface ScreenshotBoxProps extends BoxProps {
2750
+ /** Background color for the screenshot area */
2751
+ backgroundColor?: string;
2752
+ /** Block size (height in block direction) */
2753
+ blockSize?: string;
2754
+ /** Content to render inside the screenshot area */
2755
+ children?: React.ReactNode;
2756
+ }
2757
+ /**
2758
+ * A container component that can be captured as a screenshot.
2759
+ *
2760
+ * The component forwards its ref to the outer container, allowing parent
2761
+ * components to capture the element using snapdom or similar libraries.
2762
+ *
2763
+ * @example
2764
+ * ```tsx
2765
+ * const ref = useRef<HTMLDivElement>(null);
2766
+ *
2767
+ * const captureScreenshot = async () => {
2768
+ * if (ref.current) {
2769
+ * const dataUrl = await toPng(ref.current);
2770
+ * // Use dataUrl...
2771
+ * }
2772
+ * };
2773
+ *
2774
+ * return (
2775
+ * <ScreenshotBox ref={ref} backgroundColor="white">
2776
+ * <Chart data={data} />
2777
+ * </ScreenshotBox>
2778
+ * );
2779
+ * ```
2780
+ */
2781
+ declare const ScreenshotBox: import("react").ForwardRefExoticComponent<Omit<ScreenshotBoxProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
2782
+ //#endregion
2783
+ //#region src/components/ui/Split.d.ts
2784
+ /**
2785
+ * Props for HSplit and VSplit components
2786
+ *
2787
+ * These components provide backward-compatible wrappers around SplitPane,
2788
+ * accepting the same props as react-split's SplitProps.
2789
+ */
2790
+ type SplitProps$1 = SplitProps;
2791
+ /**
2792
+ * Horizontal Split Component
2793
+ *
2794
+ * A convenience wrapper around SplitPane that creates a horizontal (left-right) split.
2795
+ * Maintains backward compatibility with react-split's SplitProps interface.
2796
+ *
2797
+ * @example Basic horizontal split
2798
+ * ```tsx
2799
+ * import { HSplit } from '@datarecce/ui';
2800
+ *
2801
+ * function TwoColumnLayout() {
2802
+ * return (
2803
+ * <HSplit sizes={[30, 70]} minSize={100}>
2804
+ * <div>Left Panel</div>
2805
+ * <div>Right Panel</div>
2806
+ * </HSplit>
2807
+ * );
2808
+ * }
2809
+ * ```
2810
+ *
2811
+ * @example With custom styling
2812
+ * ```tsx
2813
+ * <HSplit
2814
+ * sizes={[20, 80]}
2815
+ * minSize={50}
2816
+ * style={{ height: "100%" }}
2817
+ * >
2818
+ * <nav>Navigation</nav>
2819
+ * <main>Content</main>
2820
+ * </HSplit>
2821
+ * ```
2822
+ */
2823
+ declare function HSplit(props: SplitProps$1): import("react/jsx-runtime").JSX.Element;
2824
+ /**
2825
+ * Vertical Split Component
2826
+ *
2827
+ * A convenience wrapper around SplitPane that creates a vertical (top-bottom) split.
2828
+ * Maintains backward compatibility with react-split's SplitProps interface.
2829
+ *
2830
+ * @example Basic vertical split
2831
+ * ```tsx
2832
+ * import { VSplit } from '@datarecce/ui';
2833
+ *
2834
+ * function TwoRowLayout() {
2835
+ * return (
2836
+ * <VSplit sizes={[60, 40]} minSize={100}>
2837
+ * <div>Top Panel</div>
2838
+ * <div>Bottom Panel</div>
2839
+ * </VSplit>
2840
+ * );
2841
+ * }
2842
+ * ```
2843
+ *
2844
+ * @example Nested splits
2845
+ * ```tsx
2846
+ * <HSplit sizes={[30, 70]}>
2847
+ * <div>Sidebar</div>
2848
+ * <VSplit sizes={[70, 30]}>
2849
+ * <div>Main Content</div>
2850
+ * <div>Footer</div>
2851
+ * </VSplit>
2852
+ * </HSplit>
2853
+ * ```
2854
+ */
2855
+ declare function VSplit(props: SplitProps$1): import("react/jsx-runtime").JSX.Element;
2856
+ //#endregion
2857
+ //#region src/components/ui/SplitPane.d.ts
2858
+ /**
2859
+ * Split direction
2860
+ */
2861
+ type SplitDirection = "horizontal" | "vertical";
2862
+ /**
2863
+ * Props for the SplitPane component
2864
+ */
2865
+ interface SplitPaneProps {
2866
+ /** Child elements to split */
2867
+ children: ReactNode;
2868
+ /** Split direction */
2869
+ direction?: SplitDirection;
2870
+ /** Initial sizes as percentages (should sum to 100) */
2871
+ sizes?: number[];
2872
+ /** Minimum sizes in pixels */
2873
+ minSizes?: number | number[];
2874
+ /** Maximum sizes in pixels */
2875
+ maxSizes?: number | number[];
2876
+ /** Gutter (drag handle) size in pixels */
2877
+ gutterSize?: number;
2878
+ /** Snap to closed at this threshold (pixels) */
2879
+ snapOffset?: number;
2880
+ /** Allow dragging past minSize to collapse */
2881
+ dragInterval?: number;
2882
+ /** Callback when sizes change */
2883
+ onDragEnd?: (sizes: number[]) => void;
2884
+ /** Callback during drag */
2885
+ onDrag?: (sizes: number[]) => void;
2886
+ /** Theme mode */
2887
+ theme?: "light" | "dark";
2888
+ /** Container style */
2889
+ style?: CSSProperties;
2890
+ /** Optional CSS class */
2891
+ className?: string;
2892
+ }
2893
+ /**
2894
+ * SplitPane Component
2895
+ *
2896
+ * A pure presentation component for creating resizable split panes
2897
+ * using react-split. Supports horizontal and vertical layouts.
2898
+ *
2899
+ * @example Horizontal split
2900
+ * ```tsx
2901
+ * import { SplitPane } from '@datarecce/ui/primitives';
2902
+ *
2903
+ * function TwoColumnLayout() {
2904
+ * return (
2905
+ * <SplitPane direction="horizontal" sizes={[30, 70]}>
2906
+ * <div>Left Panel</div>
2907
+ * <div>Right Panel</div>
2908
+ * </SplitPane>
2909
+ * );
2910
+ * }
2911
+ * ```
2912
+ *
2913
+ * @example Vertical split with min sizes
2914
+ * ```tsx
2915
+ * <SplitPane
2916
+ * direction="vertical"
2917
+ * sizes={[50, 50]}
2918
+ * minSizes={[100, 100]}
2919
+ * >
2920
+ * <div>Top Panel</div>
2921
+ * <div>Bottom Panel</div>
2922
+ * </SplitPane>
2923
+ * ```
2924
+ *
2925
+ * @example Three-way split with callbacks
2926
+ * ```tsx
2927
+ * <SplitPane
2928
+ * direction="horizontal"
2929
+ * sizes={[25, 50, 25]}
2930
+ * onDragEnd={(sizes) => saveSizes(sizes)}
2931
+ * >
2932
+ * <div>Navigation</div>
2933
+ * <div>Content</div>
2934
+ * <div>Details</div>
2935
+ * </SplitPane>
2936
+ * ```
2937
+ */
2938
+ declare function SplitPaneComponent({
2939
+ children,
2940
+ direction,
2941
+ sizes,
2942
+ minSizes,
2943
+ maxSizes,
2944
+ gutterSize,
2945
+ snapOffset,
2946
+ dragInterval,
2947
+ onDragEnd,
2948
+ onDrag,
2949
+ theme,
2950
+ style,
2951
+ className
2952
+ }: SplitPaneProps): import("react/jsx-runtime").JSX.Element;
2953
+ declare const SplitPane: import("react").MemoExoticComponent<typeof SplitPaneComponent>;
2954
+ //#endregion
2955
+ //#region src/components/ui/Toaster.d.ts
2956
+ /**
2957
+ * Toast types and interfaces
2958
+ */
2959
+ interface ToastOptions {
2960
+ id?: string;
2961
+ title?: string;
2962
+ description?: ReactNode;
2963
+ type?: "success" | "error" | "warning" | "info" | "loading";
2964
+ duration?: number;
2965
+ closable?: boolean;
2966
+ action?: {
2967
+ label: string;
2968
+ onClick: () => void;
2969
+ };
2970
+ }
2971
+ interface ToasterContextValue {
2972
+ toast: (options: ToastOptions) => string;
2973
+ success: (options: Omit<ToastOptions, "type">) => string;
2974
+ error: (options: Omit<ToastOptions, "type">) => string;
2975
+ warning: (options: Omit<ToastOptions, "type">) => string;
2976
+ info: (options: Omit<ToastOptions, "type">) => string;
2977
+ loading: (options: Omit<ToastOptions, "type">) => string;
2978
+ dismiss: (id: string) => void;
2979
+ update: (id: string, options: Partial<ToastOptions>) => void;
2980
+ }
2981
+ /**
2982
+ * Simple toaster implementation using MUI Snackbar
2983
+ */
2984
+ declare function ToasterProvider({
2985
+ children
2986
+ }: {
2987
+ children: ReactNode;
2988
+ }): import("react/jsx-runtime").JSX.Element;
2989
+ /**
2990
+ * Hook to use the toaster
2991
+ */
2992
+ declare function useToaster(): ToasterContextValue;
2993
+ /**
2994
+ * Standalone toaster instance for use outside React context
2995
+ * Uses a simple event-based system
2996
+ */
2997
+ interface ToastEvent {
2998
+ type: "create" | "dismiss" | "update";
2999
+ options?: ToastOptions;
3000
+ id?: string;
3001
+ }
3002
+ declare const toaster: {
3003
+ create: (options: ToastOptions) => string;
3004
+ success: (options: Omit<ToastOptions, "type">) => string;
3005
+ error: (options: Omit<ToastOptions, "type">) => string;
3006
+ warning: (options: Omit<ToastOptions, "type">) => string;
3007
+ info: (options: Omit<ToastOptions, "type">) => string;
3008
+ loading: (options: Omit<ToastOptions, "type">) => string;
3009
+ dismiss: (id: string) => void;
3010
+ remove: (id: string) => void;
3011
+ update: (id: string, options: Partial<ToastOptions>) => void;
3012
+ subscribe: (listener: (event: ToastEvent) => void) => () => boolean;
3013
+ };
3014
+ /**
3015
+ * Toaster component that renders toasts from the standalone toaster
3016
+ */
3017
+ declare function Toaster(): import("react/jsx-runtime").JSX.Element;
3018
+ //#endregion
3019
+ //#region src/components/ui/ToggleSwitch.d.ts
3020
+ interface ToggleSwitchProps {
3021
+ /** Current toggle state */
3022
+ value: boolean;
3023
+ /** Callback when toggle state changes */
3024
+ onChange: (value: boolean) => void;
3025
+ /** Label for the "on" state */
3026
+ textOn?: string;
3027
+ /** Label for the "off" state */
3028
+ textOff?: string;
3029
+ }
3030
+ /**
3031
+ * A toggle switch component that allows switching between two values.
3032
+ *
3033
+ * @example
3034
+ * ```tsx
3035
+ * <ToggleSwitch
3036
+ * value={isEnabled}
3037
+ * onChange={setIsEnabled}
3038
+ * textOff="Inline"
3039
+ * textOn="Side by side"
3040
+ * />
3041
+ * ```
3042
+ */
3043
+ declare function ToggleSwitch({
3044
+ value,
3045
+ onChange,
3046
+ textOn,
3047
+ textOff
3048
+ }: ToggleSwitchProps): import("react/jsx-runtime").JSX.Element;
3049
+ //#endregion
3050
+ //#region src/primitives.d.ts
3051
+ /**
3052
+ * Version marker for the primitives surface.
3053
+ */
3054
+ declare const PRIMITIVES_API_VERSION = "0.1.0";
3055
+ //#endregion
3056
+ export { SchemaLegend as $, CheckEmptyState as $t, DiffTextProps as A, TimelineEventData as At, CodeEditor as B, TransformationLegendItem as Bt, EmptyStateProps as C, LineageEdgeProps as Cn, HistogramDataset as Ct, DiffTextWithToast as D, NodeChangeStatus as Dn, isDisabledByNoResult as Dt, DropdownValuesInputSize as E, LineageNodeProps as En, formatSqlAsMarkdown as Et, ChangedOnlyCheckboxProps as F, NodeTag as Ft, SchemaDataGridOptions as G, LineageColumnNodeData as Gt, CodeEditorProps as H, COLUMN_NODE_WIDTH as Ht, DiffEditor as I, NodeTagProps as It, SchemaRow as J, PresetCheckTemplateView as Jt, SchemaDataGridResult as K, LineageColumnNodeProps as Kt, DiffEditorLanguage as L, ChangeStatusLegendItem as Lt, DiffDisplayModeSwitch as M, TimelineEventType as Mt, DiffDisplayModeSwitchProps as N, CommentInput as Nt, DiffTextWithToastProps as O, TimelineActor as Ot, ChangedOnlyCheckbox as P, CommentInputProps as Pt, toSingleEnvDataGrid as Q, CheckListProps as Qt, DiffEditorProps as R, LineageLegend as Rt, EmptyState as S, LineageEdgeData as Sn, HistogramDataType as St, DropdownValuesInputProps as T, LineageNodeData as Tn, buildCheckTitle as Tt, CodeEditorTheme as U, ColumnTransformationType as Ut, CodeEditorLanguage as V, COLUMN_NODE_HEIGHT as Vt, SchemaDiffStatus as W, LineageColumnNode as Wt, mergeColumns as X, generateCheckTemplate as Xt, SingleEnvSchemaDataGridResult as Y, PresetCheckTemplateViewProps as Yt, toSchemaDataGrid as Z, CheckList as Zt, MarkdownContent as _, LineageView as _n, PairedHistogramContinuousProps as _t, Toaster as a, CheckDescriptionProps as an, TopKBarChartProps as at, ExternalLinkConfirmDialogProps as b, EdgeChangeStatus as bn, HistogramChart as bt, useToaster as c, CheckCardProps as cn, ProfileDistributionUnsupportedBanner as ct, SplitPaneProps as d, CheckBreadcrumb as dn, PairedHistogramDiscreteCountsData as dt, CheckEmptyStateProps as en, SchemaView as et, HSplit as f, CheckBreadcrumbProps as fn, PairedHistogramDiscreteData as ft, ScreenshotBoxProps as g, CheckActionsProps as gn, PairedHistogramContinuousData as gt, ScreenshotBox as h, CheckActions as hn, PairedHistogramContinuous as ht, ToastOptions as i, CheckDescription as in, TopKBarChart as it, DiffDisplayMode as j, TimelineEventProps as jt, DiffText as k, TimelineEvent as kt, SplitDirection as l, CheckRunStatus as ln, ProfileDistributionUnsupportedBannerProps as lt, VSplit as m, CheckActionType as mn, PairedHistogramDiscreteRanksData as mt, ToggleSwitch as n, CheckDetailProps as nn, ColumnNameCell as nt, ToasterProvider as o, CheckCard as on, TopKDataset as ot, SplitProps$1 as p, CheckAction as pn, PairedHistogramDiscreteProps as pt, SchemaDiffRow as q, GenerateCheckTemplateOptions as qt, ToggleSwitchProps as r, CheckDetailTab as rn, ColumnNameCellProps as rt, toaster as s, CheckCardData as sn, TopKItem as st, PRIMITIVES_API_VERSION as t, CheckDetail as tn, SingleEnvSchemaView as tt, SplitPane as u, CheckType as un, PairedHistogramDiscrete as ut, MarkdownContentProps as v, LineageViewProps as vn, InlineProfileDistributionCell as vt, DropdownValuesInput as w, LineageNode as wn, buildCheckDescription as wt, truncateUrl as x, LineageEdge as xn, HistogramChartProps as xt, ExternalLinkConfirmDialog as y, LineageViewRef as yn, InlineProfileDistributionCellProps as yt, DiffEditorTheme as z, LineageLegendProps as zt };
3057
+ //# sourceMappingURL=primitives-CH-N_7Xw.d.ts.map