@dudousxd/nestjs-catalog-react 0.33.0 → 0.34.1

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 (101) hide show
  1. package/dist/AccessConsole.d.ts +1 -1
  2. package/dist/CatalogManager.d.ts +1 -1
  3. package/dist/ConnectionPanel.d.ts +1 -1
  4. package/dist/CoverageLedger.d.ts +1 -1
  5. package/dist/DashboardBoard.d.ts +1 -1
  6. package/dist/EditableField.d.ts +1 -1
  7. package/dist/FlowView.d.ts +1 -1
  8. package/dist/GovernanceTimeline.d.ts +1 -1
  9. package/dist/LoadExpectationSection.d.ts +1 -1
  10. package/dist/LoadedBySection.d.ts +1 -1
  11. package/dist/ObjectExplorer.d.ts +1 -1
  12. package/dist/ObjectExplorer.js +12 -2
  13. package/dist/PipelineConsole.d.ts +1 -1
  14. package/dist/QueryConsole.d.ts +1 -1
  15. package/dist/SavedQueryPanel.d.ts +1 -1
  16. package/dist/TraceExplorer.d.ts +1 -1
  17. package/dist/TransformEditor.d.ts +1 -1
  18. package/dist/WorkflowCanvas.d.ts +1 -1
  19. package/dist/WorkflowCanvas.js +23 -1
  20. package/dist/charts/bklit/area-chart-loading.d.ts +1 -1
  21. package/dist/charts/bklit/area-chart.d.ts +1 -1
  22. package/dist/charts/bklit/area-gradient-defs.d.ts +1 -1
  23. package/dist/charts/bklit/area.d.ts +1 -1
  24. package/dist/charts/bklit/bar-chart-loading.d.ts +1 -1
  25. package/dist/charts/bklit/bar-chart.d.ts +1 -1
  26. package/dist/charts/bklit/bar-squares.d.ts +2 -2
  27. package/dist/charts/bklit/bar-x-axis.d.ts +1 -1
  28. package/dist/charts/bklit/bar-y-axis.d.ts +1 -1
  29. package/dist/charts/bklit/bar.d.ts +1 -1
  30. package/dist/charts/bklit/chart-config-context.d.ts +1 -1
  31. package/dist/charts/bklit/chart-context.d.ts +1 -1
  32. package/dist/charts/bklit/chart-legend-hover.d.ts +1 -1
  33. package/dist/charts/bklit/chart-loading-label.d.ts +1 -1
  34. package/dist/charts/bklit/chart-reveal-clip.d.ts +1 -1
  35. package/dist/charts/bklit/dash-tail-stroke.d.ts +1 -1
  36. package/dist/charts/bklit/grid.d.ts +1 -1
  37. package/dist/charts/bklit/highlight-segment.d.ts +1 -1
  38. package/dist/charts/bklit/line-chart-loading.d.ts +1 -1
  39. package/dist/charts/bklit/line-chart.d.ts +1 -1
  40. package/dist/charts/bklit/line-loading-pulse.d.ts +1 -1
  41. package/dist/charts/bklit/line-series-terminal-marker.d.ts +1 -1
  42. package/dist/charts/bklit/line.d.ts +1 -1
  43. package/dist/charts/bklit/loading-sweep.d.ts +2 -2
  44. package/dist/charts/bklit/pattern-area.d.ts +1 -1
  45. package/dist/charts/bklit/projection-line-end-marker.d.ts +1 -1
  46. package/dist/charts/bklit/projection-line.d.ts +1 -1
  47. package/dist/charts/bklit/series-dash-tail-overlay.d.ts +1 -1
  48. package/dist/charts/bklit/series-highlight-layer.d.ts +1 -1
  49. package/dist/charts/bklit/series-hover-dim.d.ts +1 -1
  50. package/dist/charts/bklit/series-markers.d.ts +1 -1
  51. package/dist/charts/bklit/series-point-marker.d.ts +1 -1
  52. package/dist/charts/bklit/static-chart-preview-context.d.ts +1 -1
  53. package/dist/charts/bklit/time-series-chart-shell.d.ts +1 -1
  54. package/dist/charts/bklit/tooltip/chart-tooltip.d.ts +1 -1
  55. package/dist/charts/bklit/tooltip/date-ticker.d.ts +1 -1
  56. package/dist/charts/bklit/tooltip/tooltip-box.d.ts +1 -1
  57. package/dist/charts/bklit/tooltip/tooltip-content.d.ts +1 -1
  58. package/dist/charts/bklit/tooltip/tooltip-dot.d.ts +1 -1
  59. package/dist/charts/bklit/tooltip/tooltip-indicator.d.ts +1 -1
  60. package/dist/charts/bklit/visx-pattern.d.ts +4 -4
  61. package/dist/charts/bklit/x-axis.d.ts +1 -1
  62. package/dist/charts/bklit.d.ts +1 -1
  63. package/dist/charts/body.d.ts +1 -1
  64. package/dist/charts/components/shimmering-text.d.ts +1 -1
  65. package/dist/charts/css.d.ts +1 -1
  66. package/dist/charts/recharts.d.ts +1 -1
  67. package/dist/charts/skeleton.d.ts +3 -3
  68. package/dist/connection-form.d.ts +5 -5
  69. package/dist/context.d.ts +1 -1
  70. package/dist/diff/RevisionDiff.d.ts +4 -4
  71. package/dist/embed/EmbeddedChart.d.ts +1 -1
  72. package/dist/embed/EmbeddedDashboard.d.ts +1 -1
  73. package/dist/embed/chart-card.d.ts +1 -1
  74. package/dist/schema-discovery.d.ts +1 -1
  75. package/dist/search-console.d.ts +1 -1
  76. package/dist/sharing.d.ts +2 -2
  77. package/dist/source-connection.d.ts +1 -1
  78. package/dist/source-fields.d.ts +24 -6
  79. package/dist/source-fields.js +100 -4
  80. package/dist/ui/button.d.ts +1 -1
  81. package/dist/ui/chart.d.ts +4 -4
  82. package/dist/ui/code-editor.d.ts +1 -1
  83. package/dist/ui/combobox.d.ts +2 -2
  84. package/dist/ui/data-table.d.ts +1 -1
  85. package/dist/ui/dialog.d.ts +1 -1
  86. package/dist/ui/field.d.ts +3 -3
  87. package/dist/ui/rich-text-field.d.ts +2 -2
  88. package/dist/ui/select.d.ts +2 -2
  89. package/dist/ui/sheet.d.ts +1 -1
  90. package/dist/ui/switch.d.ts +1 -1
  91. package/dist/ui/tabs.d.ts +4 -4
  92. package/dist/ui/tooltip.d.ts +2 -2
  93. package/dist/workflow/edges.d.ts +2 -2
  94. package/dist/workflow/history.d.ts +1 -1
  95. package/dist/workflow/lifecycle.d.ts +5 -5
  96. package/dist/workflow/menu.d.ts +2 -2
  97. package/dist/workflow/nodes.d.ts +2 -2
  98. package/dist/workflow/runs.d.ts +1 -1
  99. package/dist/workflow/templates.js +5 -2
  100. package/dist/workflow/wiring.d.ts +2 -2
  101. package/package.json +25 -22
@@ -37,7 +37,7 @@ export interface TooltipIndicatorProps {
37
37
  /** SVG stroke dash pattern. When set, renders a dashed stroke instead of a solid fill. */
38
38
  strokeDasharray?: string;
39
39
  }
40
- export declare function TooltipIndicator(props: TooltipIndicatorProps): import("react/jsx-runtime").JSX.Element | null;
40
+ export declare function TooltipIndicator(props: TooltipIndicatorProps): import("react").JSX.Element | null;
41
41
  export declare namespace TooltipIndicator {
42
42
  var displayName: string;
43
43
  }
@@ -9,19 +9,19 @@
9
9
  */
10
10
  import { PatternCircles as VisxPatternCircles, PatternHexagons as VisxPatternHexagons, PatternLines as VisxPatternLines, PatternWaves as VisxPatternWaves } from '@visx/pattern';
11
11
  import type { ComponentProps } from 'react';
12
- export declare function PatternLines(props: ComponentProps<typeof VisxPatternLines>): import("react/jsx-runtime").JSX.Element;
12
+ export declare function PatternLines(props: ComponentProps<typeof VisxPatternLines>): import("react").JSX.Element;
13
13
  export declare namespace PatternLines {
14
14
  var displayName: string;
15
15
  }
16
- export declare function PatternCircles(props: ComponentProps<typeof VisxPatternCircles>): import("react/jsx-runtime").JSX.Element;
16
+ export declare function PatternCircles(props: ComponentProps<typeof VisxPatternCircles>): import("react").JSX.Element;
17
17
  export declare namespace PatternCircles {
18
18
  var displayName: string;
19
19
  }
20
- export declare function PatternWaves(props: ComponentProps<typeof VisxPatternWaves>): import("react/jsx-runtime").JSX.Element;
20
+ export declare function PatternWaves(props: ComponentProps<typeof VisxPatternWaves>): import("react").JSX.Element;
21
21
  export declare namespace PatternWaves {
22
22
  var displayName: string;
23
23
  }
24
- export declare function PatternHexagons(props: ComponentProps<typeof VisxPatternHexagons>): import("react/jsx-runtime").JSX.Element;
24
+ export declare function PatternHexagons(props: ComponentProps<typeof VisxPatternHexagons>): import("react").JSX.Element;
25
25
  export declare namespace PatternHexagons {
26
26
  var displayName: string;
27
27
  }
@@ -19,7 +19,7 @@ export declare function selectEvenlySpacedIndices(length: number, targetCount: n
19
19
  xAccessor?: (d: Record<string, unknown>) => Date;
20
20
  resolveXPx?: (index: number) => number;
21
21
  }): number[];
22
- export declare function XAxis(props: XAxisProps): import("react/jsx-runtime").JSX.Element | null;
22
+ export declare function XAxis(props: XAxisProps): import("react").JSX.Element | null;
23
23
  export declare namespace XAxis {
24
24
  var displayName: string;
25
25
  }
@@ -1,2 +1,2 @@
1
1
  import { type ChartRendererProps } from './registry';
2
- export declare function BklitRenderer({ result, visualization, height }: ChartRendererProps): import("react/jsx-runtime").JSX.Element;
2
+ export declare function BklitRenderer({ result, visualization, height }: ChartRendererProps): import("react").JSX.Element;
@@ -36,4 +36,4 @@ export interface ChartBodyProps {
36
36
  maxColumns?: number;
37
37
  maxRows?: number;
38
38
  }
39
- export declare function ChartBody({ result, visualization, height, maxColumns, maxRows, }: ChartBodyProps): import("react/jsx-runtime").JSX.Element;
39
+ export declare function ChartBody({ result, visualization, height, maxColumns, maxRows, }: ChartBodyProps): import("react").JSX.Element;
@@ -28,4 +28,4 @@ export type ShimmeringTextProps = Omit<ComponentProps<typeof motion.span>, 'chil
28
28
  */
29
29
  isStopped?: boolean;
30
30
  };
31
- export declare function ShimmeringText({ text, duration, isStopped, paused, className, ...props }: ShimmeringTextProps): import("react/jsx-runtime").JSX.Element;
31
+ export declare function ShimmeringText({ text, duration, isStopped, paused, className, ...props }: ShimmeringTextProps): import("react").JSX.Element;
@@ -15,7 +15,7 @@ import type { ChartRendererProps } from './registry';
15
15
  * A registered library that hits data it does not support has to land somewhere,
16
16
  * and before this it had nowhere to land but an error.
17
17
  */
18
- export declare function CssBarChart({ result, visualization }: ChartRendererProps): import("react/jsx-runtime").JSX.Element;
18
+ export declare function CssBarChart({ result, visualization }: ChartRendererProps): import("react").JSX.Element;
19
19
  /**
20
20
  * Whether a column holds something a time scale can actually place.
21
21
  *
@@ -23,6 +23,6 @@ import { type ChartRendererProps } from './registry';
23
23
  * its series and silently loses its axes, which reads as a styling problem and
24
24
  * is not.
25
25
  */
26
- export declare function ShadcnChartRenderer({ result, visualization, height }: ChartRendererProps): import("react/jsx-runtime").JSX.Element;
26
+ export declare function ShadcnChartRenderer({ result, visualization, height }: ChartRendererProps): import("react").JSX.Element;
27
27
  /** The name this shipped under before it used the shadcn primitives. */
28
28
  export { ShadcnChartRenderer as RechartsRenderer };
@@ -33,7 +33,7 @@ export interface ChartSkeletonProps {
33
33
  points?: number;
34
34
  className?: string;
35
35
  }
36
- export declare function ChartSkeleton({ kind, height, points, className }: ChartSkeletonProps): import("react/jsx-runtime").JSX.Element;
36
+ export declare function ChartSkeleton({ kind, height, points, className }: ChartSkeletonProps): import("react").JSX.Element;
37
37
  /**
38
38
  * What a card shows when the query finished and there was nothing to draw.
39
39
  *
@@ -46,10 +46,10 @@ export declare function ChartSkeleton({ kind, height, points, className }: Chart
46
46
  export declare function ChartEmpty({ height, message, }: {
47
47
  height?: number;
48
48
  message?: string;
49
- }): import("react/jsx-runtime").JSX.Element;
49
+ }): import("react").JSX.Element;
50
50
  /** And what it shows when the query failed, which is not the same thing at all. */
51
51
  export declare function ChartFailed({ height, message, onRetry, }: {
52
52
  height?: number;
53
53
  message: string;
54
54
  onRetry?: () => void;
55
- }): import("react/jsx-runtime").JSX.Element;
55
+ }): import("react").JSX.Element;
@@ -188,7 +188,7 @@ export declare function redactedCredentialIn(config: Record<string, unknown>): s
188
188
  declare function HttpFields({ draft, update }: {
189
189
  draft: ConnectionDraft;
190
190
  update: UpdateDraft;
191
- }): import("react/jsx-runtime").JSX.Element;
191
+ }): import("react").JSX.Element;
192
192
  /**
193
193
  * The connection string, and nothing beside it.
194
194
  *
@@ -212,12 +212,12 @@ declare function HttpFields({ draft, update }: {
212
212
  declare function SqlFields({ draft, update }: {
213
213
  draft: ConnectionDraft;
214
214
  update: UpdateDraft;
215
- }): import("react/jsx-runtime").JSX.Element;
215
+ }): import("react").JSX.Element;
216
216
  /** A bucket, plus everything needed to address a non-AWS one. */
217
217
  declare function S3Fields({ draft, update }: {
218
218
  draft: ConnectionDraft;
219
219
  update: UpdateDraft;
220
- }): import("react/jsx-runtime").JSX.Element;
220
+ }): import("react").JSX.Element;
221
221
  /**
222
222
  * What a check that just ran found, in the checker's own words.
223
223
  *
@@ -235,11 +235,11 @@ declare function S3Fields({ draft, update }: {
235
235
  */
236
236
  export declare function ConnectionCheckResult({ result }: {
237
237
  result: ConnectionCheck;
238
- }): import("react/jsx-runtime").JSX.Element;
238
+ }): import("react").JSX.Element;
239
239
  /** The address fields for whichever kind is selected, and only those. */
240
240
  export declare function ConnectionKindFields({ kind, draft, update, }: {
241
241
  kind: ConnectableKind;
242
242
  draft: ConnectionDraft;
243
243
  update: UpdateDraft;
244
- }): import("react/jsx-runtime").JSX.Element;
244
+ }): import("react").JSX.Element;
245
245
  export {};
package/dist/context.d.ts CHANGED
@@ -940,7 +940,7 @@ export interface CatalogProviderProps {
940
940
  accessBasePath?: string;
941
941
  children: ReactNode;
942
942
  }
943
- export declare function CatalogProvider({ transport, pipelineBasePath, publishBasePath, accessBasePath, children, }: CatalogProviderProps): import("react/jsx-runtime").JSX.Element;
943
+ export declare function CatalogProvider({ transport, pipelineBasePath, publishBasePath, accessBasePath, children, }: CatalogProviderProps): import("react").JSX.Element;
944
944
  export declare function useCatalogClient(): CatalogClient;
945
945
  /** Query keys, exported so a host can invalidate them from its own code. */
946
946
  export declare const catalogQueryKeys: {
@@ -48,7 +48,7 @@ export interface RevisionHistoryProps {
48
48
  */
49
49
  ranVersion?: number | undefined;
50
50
  }
51
- export declare function RevisionHistory({ subject, current, buffer, ranVersion }: RevisionHistoryProps): import("react/jsx-runtime").JSX.Element;
51
+ export declare function RevisionHistory({ subject, current, buffer, ranVersion }: RevisionHistoryProps): import("react").JSX.Element;
52
52
  /**
53
53
  * The comparison itself.
54
54
  *
@@ -99,7 +99,7 @@ language, name, }: {
99
99
  after: string;
100
100
  language?: CatalogCodeLanguage | undefined;
101
101
  name?: string;
102
- }): import("react/jsx-runtime").JSX.Element;
102
+ }): import("react").JSX.Element;
103
103
  export interface RevisionHistorySheetProps extends RevisionHistoryProps {
104
104
  open: boolean;
105
105
  onOpenChange: (open: boolean) => void;
@@ -114,7 +114,7 @@ export interface RevisionHistorySheetProps extends RevisionHistoryProps {
114
114
  * of a list. `wide`, because a diff at 24rem wraps every line and stops being a
115
115
  * diff.
116
116
  */
117
- export declare function RevisionHistorySheet({ open, onOpenChange, ...props }: RevisionHistorySheetProps): import("react/jsx-runtime").JSX.Element;
117
+ export declare function RevisionHistorySheet({ open, onOpenChange, ...props }: RevisionHistorySheetProps): import("react").JSX.Element;
118
118
  /**
119
119
  * The control that opens it, so the three entry points cannot drift into three
120
120
  * different affordances for one thing.
@@ -123,4 +123,4 @@ export declare function RevisionHistoryButton({ label, onClick, className, }: {
123
123
  label?: string;
124
124
  onClick: () => void;
125
125
  className?: string;
126
- }): import("react/jsx-runtime").JSX.Element;
126
+ }): import("react").JSX.Element;
@@ -38,4 +38,4 @@ export interface EmbeddedChartProps {
38
38
  height?: number;
39
39
  className?: string;
40
40
  }
41
- export declare function EmbeddedChart({ chartId, actions, loading, failure, height, className, }: EmbeddedChartProps): import("react/jsx-runtime").JSX.Element;
41
+ export declare function EmbeddedChart({ chartId, actions, loading, failure, height, className, }: EmbeddedChartProps): import("react").JSX.Element;
@@ -29,4 +29,4 @@ export interface EmbeddedDashboardProps {
29
29
  empty?: ReactNode;
30
30
  className?: string;
31
31
  }
32
- export declare function EmbeddedDashboard({ dashboardId, actions, loading, failure, height, empty, className, }: EmbeddedDashboardProps): import("react/jsx-runtime").JSX.Element;
32
+ export declare function EmbeddedDashboard({ dashboardId, actions, loading, failure, height, empty, className, }: EmbeddedDashboardProps): import("react").JSX.Element;
@@ -17,4 +17,4 @@ export declare function EmbeddedChartCard({ chart, actions, height, className, }
17
17
  actions?: EmbedActions;
18
18
  height?: number;
19
19
  className?: string;
20
- }): import("react/jsx-runtime").JSX.Element;
20
+ }): import("react").JSX.Element;
@@ -229,4 +229,4 @@ export declare function SchemaDiscoveryPanel({ workflowId, nodeId, bridge, disab
229
229
  * written around.
230
230
  */
231
231
  onDiscovered?: (nodeId: string, discovery: ConnectorSchemaDiscovery) => void;
232
- }): import("react/jsx-runtime").JSX.Element;
232
+ }): import("react").JSX.Element;
@@ -20,4 +20,4 @@ export interface CatalogSearchProps {
20
20
  title?: string;
21
21
  eyebrow?: string;
22
22
  }
23
- export declare function CatalogSearch({ explorerHref, savedQueryHref, dashboardHref, limit, placeholder, title, eyebrow, }: CatalogSearchProps): import("react/jsx-runtime").JSX.Element;
23
+ export declare function CatalogSearch({ explorerHref, savedQueryHref, dashboardHref, limit, placeholder, title, eyebrow, }: CatalogSearchProps): import("react").JSX.Element;
package/dist/sharing.d.ts CHANGED
@@ -50,7 +50,7 @@ export declare function shareActionLabel(kind: ShareableKind, shared: boolean):
50
50
  export declare function ShareBadge({ shared, className }: {
51
51
  shared: boolean;
52
52
  className?: string;
53
- }): import("react/jsx-runtime").JSX.Element;
53
+ }): import("react").JSX.Element;
54
54
  export interface ShareControlProps {
55
55
  kind: ShareableKind;
56
56
  shared: boolean;
@@ -78,4 +78,4 @@ export interface ShareControlProps {
78
78
  layout?: 'panel' | 'row';
79
79
  className?: string;
80
80
  }
81
- export declare function ShareControl({ kind, shared, onChange, pending, error, name, layout, className, }: ShareControlProps): import("react/jsx-runtime").JSX.Element;
81
+ export declare function ShareControl({ kind, shared, onChange, pending, error, name, layout, className, }: ShareControlProps): import("react").JSX.Element;
@@ -79,4 +79,4 @@ export declare function SourceConnectionCreator({ kind, canEdit, hasOptions, onC
79
79
  hasOptions: boolean;
80
80
  /** Attach it to the node. The caller decides what that does to the draft. */
81
81
  onCreated: (connection: CatalogConnection) => void;
82
- }): import("react/jsx-runtime").JSX.Element | null;
82
+ }): import("react").JSX.Element | null;
@@ -1,4 +1,4 @@
1
- import type { ConnectorKind } from '@dudousxd/nestjs-catalog/client';
1
+ import type { ConnectorKind, SnapshotRef } from '@dudousxd/nestjs-catalog/client';
2
2
  import { type ConnectableKind } from './connection-form';
3
3
  import { type StorageAvailability } from './workflow/model';
4
4
  /** A select hands back a string. Narrow it rather than promise it is a kind. */
@@ -73,8 +73,16 @@ export interface SourceDraft {
73
73
  forcePathStyle: boolean;
74
74
  maxObjectsPerRun: string;
75
75
  watermarkColumn: string;
76
- /** The object type a `catalog` source reads. Its whole configuration. */
76
+ /** The object type a `catalog` source reads. */
77
77
  objectType: string;
78
+ /**
79
+ * Which snapshot of it, when the node names one.
80
+ *
81
+ * Blank is the ordinary case and means the snapshot the type is currently
82
+ * serving — see {@link CATALOG_SOURCE_SNAPSHOT_KEY} for why that default has
83
+ * no spelling of its own.
84
+ */
85
+ objectSnapshot: string;
78
86
  }
79
87
  export declare function sourceDraftFrom(config: Record<string, unknown> | undefined): SourceDraft;
80
88
  /**
@@ -106,7 +114,7 @@ export interface SourceConfigOptions {
106
114
  * stale url on a SQL source, which reads as configuration somebody meant.
107
115
  */
108
116
  export declare function sourceConfigFrom(kind: ConnectorKind, draft: SourceDraft, { viaConnection, incremental }: SourceConfigOptions): Record<string, unknown>;
109
- export declare function SourceFields({ kind, draft, onChange, viaConnection, disabled, storage, }: {
117
+ export declare function SourceFields({ kind, draft, onChange, viaConnection, disabled, storage, snapshots, }: {
110
118
  kind: ConnectorKind;
111
119
  draft: SourceDraft;
112
120
  onChange: (draft: SourceDraft) => void;
@@ -119,7 +127,17 @@ export declare function SourceFields({ kind, draft, onChange, viaConnection, dis
119
127
  * {@link describeStorage}, which is what renders it.
120
128
  */
121
129
  storage?: StorageAvailability;
122
- }): import("react/jsx-runtime").JSX.Element;
130
+ /**
131
+ * The history of the type a `catalog` source names, when the caller has it.
132
+ *
133
+ * Handed in rather than fetched here, exactly as `storage` is: this module is
134
+ * shared by two screens and has no transport of its own, and a component that
135
+ * reached for one would make the source form unusable anywhere the catalog
136
+ * client is not mounted. Absent falls back to a text field — see
137
+ * {@link SnapshotField}.
138
+ */
139
+ snapshots?: SnapshotRef[];
140
+ }): import("react").JSX.Element;
123
141
  /** Full or incremental, with the per-kind explanation of what that means. */
124
142
  export declare function ReadModeFields({ kind, mode, onModeChange, draft, onChange, disabled, }: {
125
143
  kind: ConnectorKind;
@@ -128,11 +146,11 @@ export declare function ReadModeFields({ kind, mode, onModeChange, draft, onChan
128
146
  draft: SourceDraft;
129
147
  onChange: (draft: SourceDraft) => void;
130
148
  disabled?: boolean;
131
- }): import("react/jsx-runtime").JSX.Element | null;
149
+ }): import("react").JSX.Element | null;
132
150
  /** The env var holding the credential — the name of one, never the value. */
133
151
  export declare function CredentialField({ kind, value, onChange, disabled, }: {
134
152
  kind: ConnectorKind;
135
153
  value: string;
136
154
  onChange: (value: string) => void;
137
155
  disabled?: boolean;
138
- }): import("react/jsx-runtime").JSX.Element;
156
+ }): import("react").JSX.Element;
@@ -1,5 +1,5 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { CATALOG_SOURCE_TYPE_KEY, CONNECTOR_KINDS, SOURCE_FORMATS, } from '@dudousxd/nestjs-catalog/client';
2
+ import { CATALOG_SOURCE_SNAPSHOT_KEY, CATALOG_SOURCE_TYPE_KEY, CONNECTOR_KINDS, SOURCE_FORMATS, catalogSnapshotRefusal, } from '@dudousxd/nestjs-catalog/client';
3
3
  import { cn } from './cn';
4
4
  import { CONNECTION_KINDS } from './connection-form';
5
5
  import { FieldGroup, TextAreaField, TextField } from './ui/field';
@@ -134,6 +134,7 @@ export function sourceDraftFrom(config) {
134
134
  maxObjectsPerRun: typeof source.maxObjectsPerRun === 'number' ? String(source.maxObjectsPerRun) : '',
135
135
  watermarkColumn: text('watermarkColumn'),
136
136
  objectType: text(CATALOG_SOURCE_TYPE_KEY),
137
+ objectSnapshot: text(CATALOG_SOURCE_SNAPSHOT_KEY),
137
138
  };
138
139
  }
139
140
  export function parseRecords(text) {
@@ -212,6 +213,23 @@ function s3Config(draft, viaConnection) {
212
213
  ...(draft.maxObjectsPerRun ? { maxObjectsPerRun: Number(draft.maxObjectsPerRun) } : {}),
213
214
  };
214
215
  }
216
+ /**
217
+ * The type, and the snapshot of it only when one was named.
218
+ *
219
+ * **Omitted rather than sent empty**, which is the entire reason this is a
220
+ * function and not an object literal at the call site. A blank field stored as
221
+ * `objectSnapshot: ""` would mean the current snapshot and read as one — and it
222
+ * would also be a config key that was not there before, so `workflowGraphHash`
223
+ * would fingerprint the node differently and present every graph somebody merely
224
+ * opened as a new version of itself. Absent is how "the current one" is spelled.
225
+ */
226
+ function catalogConfig(draft) {
227
+ const snapshot = draft.objectSnapshot.trim();
228
+ return {
229
+ [CATALOG_SOURCE_TYPE_KEY]: draft.objectType.trim(),
230
+ ...(snapshot.length === 0 ? {} : { [CATALOG_SOURCE_SNAPSHOT_KEY]: snapshot }),
231
+ };
232
+ }
215
233
  /**
216
234
  * The pasted records, or none when the text will not parse.
217
235
  *
@@ -239,7 +257,7 @@ export function sourceConfigFrom(kind, draft, { viaConnection, incremental }) {
239
257
  if (kind === 's3')
240
258
  return s3Config(draft, viaConnection);
241
259
  if (kind === 'catalog')
242
- return { [CATALOG_SOURCE_TYPE_KEY]: draft.objectType.trim() };
260
+ return catalogConfig(draft);
243
261
  return inlineConfig(draft);
244
262
  }
245
263
  /*
@@ -272,10 +290,88 @@ export function sourceConfigFrom(kind, draft, { viaConnection, incremental }) {
272
290
  * mapped back to `''` on the way into the draft.
273
291
  */
274
292
  const NO_DISK = '__no_disk__';
275
- export function SourceFields({ kind, draft, onChange, viaConnection, disabled, storage, }) {
293
+ /** The value of the "read whatever is being served" choice, for the same reason. */
294
+ const CURRENT_SNAPSHOT = '__current_snapshot__';
295
+ /**
296
+ * A snapshot's date, for a row in the picker.
297
+ *
298
+ * The id is what gets stored and it is a run id — `wf-9ff572d8` — which nobody
299
+ * can order in their head. The date is what somebody is actually choosing by, so
300
+ * it leads and the id follows on the hint line.
301
+ */
302
+ function snapshotLabel(snapshot) {
303
+ const at = new Date(snapshot.createdAt);
304
+ if (Number.isNaN(at.getTime()))
305
+ return snapshot.id;
306
+ return at.toLocaleString(undefined, {
307
+ year: 'numeric',
308
+ month: 'short',
309
+ day: '2-digit',
310
+ hour: '2-digit',
311
+ minute: '2-digit',
312
+ });
313
+ }
314
+ /**
315
+ * Which snapshot of the type this source reads.
316
+ *
317
+ * ## A list where there is one, a text field where there is not
318
+ *
319
+ * The list is the reason relative references are not supported. "The one before
320
+ * current" is a real thing to want and the objection to it is that it resolves
321
+ * differently on every run — but the friction it was going to relieve was
322
+ * *having to look an id up*, and that friction is this control's whole job. An
323
+ * id chosen from a list of dates is not looked up at all.
324
+ *
325
+ * The text field is the fallback rather than the primary, and it stays for two
326
+ * cases the list cannot cover: a type whose name has been typed but not yet
327
+ * published, and a graph being edited on a console that cannot see this
328
+ * catalog's history.
329
+ *
330
+ * ## A dropped snapshot is shown, and cannot be chosen
331
+ *
332
+ * Shown because the record is kept on purpose and hiding it would make a load
333
+ * that visibly happened look like one that never did. Unchoosable because its
334
+ * rows are gone and every read of it is refused — offering it and then refusing
335
+ * is a worse screen than one that says so up front. The same rule the object
336
+ * explorer's history picker follows, for the same reason.
337
+ */
338
+ function SnapshotField({ value, onChange, snapshots, disabled, }) {
339
+ const refusal = catalogSnapshotRefusal(value);
340
+ const listed = snapshots ?? [];
341
+ // A named snapshot that is not in the list — an id typed by hand, or one older
342
+ // than the window the list covers. Carried as its own row so choosing anything
343
+ // else and changing one's mind is not a one-way door.
344
+ const orphan = value.trim().length > 0 && !listed.some((each) => each.id === value.trim());
345
+ if (listed.length === 0) {
346
+ return (_jsx(TextField, { label: "Snapshot (optional)", value: value, onChange: onChange, placeholder: "Blank reads the current load", disabled: disabled, hint: refusal ? (_jsx("span", { className: "text-red-600 dark:text-red-400", children: refusal })) : ('Blank reads the snapshot the catalog is currently serving, resolved when the run starts. Name one snapshot id to read that load instead — an id, never "latest" or "previous", because a name that resolves at run time reads different data on different days without the graph changing.') }));
347
+ }
348
+ return (_jsxs("div", { className: "space-y-1", children: [_jsx(SelectField, { label: "Snapshot", ariaLabel: "Which snapshot to read", value: value.trim().length === 0 ? CURRENT_SNAPSHOT : value.trim(), onValueChange: (next) => onChange(next === CURRENT_SNAPSHOT ? '' : next), options: [
349
+ {
350
+ value: CURRENT_SNAPSHOT,
351
+ label: 'Current load',
352
+ hint: 'Resolved when the run starts',
353
+ },
354
+ ...(orphan
355
+ ? [{ value: value.trim(), label: value.trim(), hint: 'Not in this history' }]
356
+ : []),
357
+ ...listed.map((snapshot) => ({
358
+ value: snapshot.id,
359
+ label: snapshot.droppedAt
360
+ ? `${snapshotLabel(snapshot)} — dropped`
361
+ : snapshotLabel(snapshot),
362
+ hint: snapshot.droppedAt
363
+ ? `${snapshot.rowCount.toLocaleString()} rows, dropped · ${snapshot.id}`
364
+ : `${snapshot.rowCount.toLocaleString()} rows · ${snapshot.id}`,
365
+ // The rows are gone. Offering it and refusing the run is the screen
366
+ // this avoids.
367
+ disabled: Boolean(snapshot.droppedAt),
368
+ })),
369
+ ], disabled: disabled, hint: "A named snapshot is pinned by the name itself, so every run of this graph reads the same load. Leave it on the current load and the run resolves what the catalog is serving when it starts." }), refusal && (_jsx("p", { className: "text-[11px] leading-relaxed text-red-600 dark:text-red-400", children: refusal }))] }));
370
+ }
371
+ export function SourceFields({ kind, draft, onChange, viaConnection, disabled, storage, snapshots, }) {
276
372
  const set = (patch) => onChange({ ...draft, ...patch });
277
373
  if (kind === 'catalog') {
278
- return (_jsx(TextField, { label: "Object type", value: draft.objectType, onChange: (objectType) => set({ objectType }), placeholder: "e.g. SubwoReplica", disabled: disabled, hint: "The type, not a table. This reads the snapshot the catalog is currently serving, resolved when the run starts \u2014 the physical table keeps every load that has ever run, so naming it directly reads them all." }));
374
+ return (_jsxs("div", { className: "space-y-3", children: [_jsx(TextField, { label: "Object type", value: draft.objectType, onChange: (objectType) => set({ objectType }), placeholder: "e.g. SubwoReplica", disabled: disabled, hint: "The type, not a table. The physical table keeps every load that has ever run, so naming it directly reads them all." }), _jsx(SnapshotField, { value: draft.objectSnapshot, onChange: (objectSnapshot) => set({ objectSnapshot }), snapshots: snapshots, disabled: disabled })] }));
279
375
  }
280
376
  if (kind === 'http') {
281
377
  return (_jsxs("div", { className: "grid gap-3 sm:grid-cols-2", children: [!viaConnection && (_jsx(TextField, { label: "URL", value: draft.url, onChange: (url) => set({ url }), placeholder: "https://\u2026", disabled: disabled })), _jsx(TextField, { label: "Path to the array", value: draft.path, onChange: (path) => set({ path }), placeholder: "e.g. data", disabled: disabled })] }));
@@ -21,4 +21,4 @@ export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
21
21
  children?: ReactNode;
22
22
  ref?: Ref<HTMLButtonElement>;
23
23
  }
24
- export declare function Button({ variant, size, className, type, ...props }: ButtonProps): import("react/jsx-runtime").JSX.Element;
24
+ export declare function Button({ variant, size, className, type, ...props }: ButtonProps): import("react").JSX.Element;
@@ -33,11 +33,11 @@ export type ChartConfig = {
33
33
  export declare function ChartContainer({ id, className, children, config, ...props }: React.ComponentProps<'div'> & {
34
34
  config: ChartConfig;
35
35
  children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>['children'];
36
- }): import("react/jsx-runtime").JSX.Element;
36
+ }): React.JSX.Element;
37
37
  export declare const ChartStyle: ({ id, config, }: {
38
38
  id: string;
39
39
  config: ChartConfig;
40
- }) => import("react/jsx-runtime").JSX.Element | null;
40
+ }) => React.JSX.Element | null;
41
41
  export declare const ChartTooltip: typeof RechartsPrimitive.Tooltip;
42
42
  export declare function ChartTooltipContent({ active, payload, className, indicator, hideLabel, hideIndicator, label, labelFormatter, labelClassName, formatter, color, nameKey, labelKey, }: React.ComponentProps<typeof RechartsPrimitive.Tooltip> & React.ComponentProps<'div'> & {
43
43
  hideLabel?: boolean;
@@ -45,10 +45,10 @@ export declare function ChartTooltipContent({ active, payload, className, indica
45
45
  indicator?: 'line' | 'dot' | 'dashed';
46
46
  nameKey?: string;
47
47
  labelKey?: string;
48
- }): import("react/jsx-runtime").JSX.Element | null;
48
+ }): React.JSX.Element | null;
49
49
  export declare const ChartLegend: typeof RechartsPrimitive.Legend;
50
50
  export declare function ChartLegendContent({ className, hideIcon, payload, verticalAlign, nameKey, }: React.ComponentProps<'div'> & Pick<RechartsPrimitive.LegendProps, 'payload' | 'verticalAlign'> & {
51
51
  hideIcon?: boolean;
52
52
  nameKey?: string;
53
- }): import("react/jsx-runtime").JSX.Element | null;
53
+ }): React.JSX.Element | null;
54
54
  export {};
@@ -182,7 +182,7 @@ export declare function codeOptions(themeType: CodeThemeType): {
182
182
  readonly disableFileHeader: true;
183
183
  readonly themeType: CodeThemeType;
184
184
  };
185
- export declare function CodeEditor({ value, onChange, language, label, onKeyDown, handleRef, className, readOnly, }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;
185
+ export declare function CodeEditor({ value, onChange, language, label, onKeyDown, handleRef, className, readOnly, }: CodeEditorProps): import("react").JSX.Element;
186
186
  /**
187
187
  * The shadow root a code surface renders into.
188
188
  *
@@ -85,7 +85,7 @@ export interface ComboboxProps {
85
85
  ariaLabel?: string;
86
86
  className?: string;
87
87
  }
88
- export declare function Combobox({ value, onValueChange, onSelect, options, emptyMessage, placeholder, disabled, ariaLabel, className, }: ComboboxProps): import("react/jsx-runtime").JSX.Element;
88
+ export declare function Combobox({ value, onValueChange, onSelect, options, emptyMessage, placeholder, disabled, ariaLabel, className, }: ComboboxProps): import("react").JSX.Element;
89
89
  /**
90
90
  * A {@link Combobox} with a label above it, matching `TextField` — and a real
91
91
  * `<label>`, because unlike `Select` this renders an `<input>` and a label
@@ -94,4 +94,4 @@ export declare function Combobox({ value, onValueChange, onSelect, options, empt
94
94
  export declare function ComboboxField({ label, hint, ...props }: Omit<ComboboxProps, 'ariaLabel'> & {
95
95
  label: string;
96
96
  hint?: ReactNode;
97
- }): import("react/jsx-runtime").JSX.Element;
97
+ }): import("react").JSX.Element;
@@ -79,7 +79,7 @@ declare function featureSet(): {
79
79
  coreRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, RowData>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, RowData>;
80
80
  };
81
81
  export type DataTableFeatures = ReturnType<typeof featureSet>;
82
- export declare function DataTable<TData extends RowData>({ data, columns, getRowId, sort, empty, numeric, className, density, rowClassName, columnClassName, cellClassName, }: DataTableProps<TData>): import("react/jsx-runtime").JSX.Element;
82
+ export declare function DataTable<TData extends RowData>({ data, columns, getRowId, sort, empty, numeric, className, density, rowClassName, columnClassName, cellClassName, }: DataTableProps<TData>): import("react").JSX.Element;
83
83
  /**
84
84
  * A value from an arbitrary query, as a cell.
85
85
  *
@@ -36,4 +36,4 @@ destructive, }: {
36
36
  confirmDisabled?: boolean;
37
37
  error?: ReactNode;
38
38
  destructive?: boolean;
39
- }): import("react/jsx-runtime").JSX.Element;
39
+ }): import("react").JSX.Element;
@@ -9,7 +9,7 @@ export declare function TextField({ label, value, onChange, placeholder, hint, t
9
9
  inputMode?: 'numeric' | 'text';
10
10
  autoComplete?: string;
11
11
  disabled?: boolean;
12
- }): import("react/jsx-runtime").JSX.Element;
12
+ }): import("react").JSX.Element;
13
13
  export declare function TextAreaField({ label, value, onChange, placeholder, hint, rows, mono, disabled, }: {
14
14
  label: string;
15
15
  value: string;
@@ -20,10 +20,10 @@ export declare function TextAreaField({ label, value, onChange, placeholder, hin
20
20
  mono?: boolean;
21
21
  /** Matches {@link TextField}, so a read-only form can dim every control. */
22
22
  disabled?: boolean;
23
- }): import("react/jsx-runtime").JSX.Element;
23
+ }): import("react").JSX.Element;
24
24
  /** A heading for a run of fields, so a long form reads as sections. */
25
25
  export declare function FieldGroup({ title, hint, children, }: {
26
26
  title: string;
27
27
  hint?: ReactNode;
28
28
  children: ReactNode;
29
- }): import("react/jsx-runtime").JSX.Element;
29
+ }): import("react").JSX.Element;
@@ -13,9 +13,9 @@ export interface RichTextFieldProps {
13
13
  placeholder?: string;
14
14
  className?: string;
15
15
  }
16
- export declare function RichTextField({ value, onSave, label, placeholder, className, }: RichTextFieldProps): import("react/jsx-runtime").JSX.Element;
16
+ export declare function RichTextField({ value, onSave, label, placeholder, className, }: RichTextFieldProps): import("react").JSX.Element;
17
17
  /** Read-only, through the same editor, so one parser decides what the text means. */
18
18
  export declare function RichTextView({ value, className }: {
19
19
  value: string;
20
20
  className?: string;
21
- }): import("react/jsx-runtime").JSX.Element;
21
+ }): import("react").JSX.Element;
@@ -29,7 +29,7 @@ export declare function Select({ value, onValueChange, options, ariaLabel, place
29
29
  placeholder?: string;
30
30
  disabled?: boolean;
31
31
  className?: string;
32
- }): import("react/jsx-runtime").JSX.Element;
32
+ }): import("react").JSX.Element;
33
33
  /**
34
34
  * A select with a label above it, which is what every form in this package
35
35
  * actually wants.
@@ -48,4 +48,4 @@ export declare function SelectField({ label, hint, ariaLabel, ...props }: Omit<P
48
48
  * "Kind" alone has nothing to go on and wants "Connection kind".
49
49
  */
50
50
  ariaLabel?: string;
51
- }): import("react/jsx-runtime").JSX.Element;
51
+ }): import("react").JSX.Element;
@@ -35,4 +35,4 @@ export declare function Sheet({ open, onOpenChange, title, description, width, m
35
35
  width?: 'narrow' | 'wide';
36
36
  modal?: boolean;
37
37
  children: ReactNode;
38
- }): import("react/jsx-runtime").JSX.Element;
38
+ }): import("react").JSX.Element;
@@ -14,4 +14,4 @@ export declare function Switch({ checked, onCheckedChange, label, hint, disabled
14
14
  label: ReactNode;
15
15
  hint?: ReactNode;
16
16
  disabled?: boolean;
17
- }): import("react/jsx-runtime").JSX.Element;
17
+ }): import("react").JSX.Element;
package/dist/ui/tabs.d.ts CHANGED
@@ -14,7 +14,7 @@ export declare function Tabs({ value, onValueChange, children, className, }: {
14
14
  onValueChange: (value: string) => void;
15
15
  children: ReactNode;
16
16
  className?: string;
17
- }): import("react/jsx-runtime").JSX.Element;
17
+ }): import("react").JSX.Element;
18
18
  export declare function TabsList({ children, className, ref, }: {
19
19
  children: ReactNode;
20
20
  className?: string;
@@ -23,7 +23,7 @@ export declare function TabsList({ children, className, ref, }: {
23
23
  * scroll needs to know how far it has scrolled to say so.
24
24
  */
25
25
  ref?: Ref<HTMLDivElement>;
26
- }): import("react/jsx-runtime").JSX.Element;
26
+ }): import("react").JSX.Element;
27
27
  export declare function TabsTab({ value, children, className, ref, }: {
28
28
  value: string;
29
29
  children: ReactNode;
@@ -39,9 +39,9 @@ export declare function TabsTab({ value, children, className, ref, }: {
39
39
  * which is the bug this scrolling was introduced to fix.
40
40
  */
41
41
  ref?: Ref<HTMLButtonElement>;
42
- }): import("react/jsx-runtime").JSX.Element;
42
+ }): import("react").JSX.Element;
43
43
  export declare function TabsPanel({ value, children, className, }: {
44
44
  value: string;
45
45
  children: ReactNode;
46
46
  className?: string;
47
- }): import("react/jsx-runtime").JSX.Element;
47
+ }): import("react").JSX.Element;