@gntik-ai/blocks 0.9.0 → 0.11.0

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 (162) hide show
  1. package/dist/index.d.ts +426 -55
  2. package/dist/index.js +2275 -639
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.labels.test.tsx +179 -0
  6. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +59 -24
  7. package/src/auth/ForgotPasswordForm/block.meta.ts +22 -1
  8. package/src/auth/ForgotPasswordForm/examples/Labels.tsx +29 -0
  9. package/src/auth/MfaChallenge/MfaChallenge.labels.test.tsx +139 -0
  10. package/src/auth/MfaChallenge/MfaChallenge.tsx +69 -23
  11. package/src/auth/MfaChallenge/block.meta.ts +29 -1
  12. package/src/auth/MfaChallenge/examples/Labels.tsx +28 -0
  13. package/src/auth/ResetPasswordForm/ResetPasswordForm.labels.test.tsx +104 -0
  14. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +42 -15
  15. package/src/auth/ResetPasswordForm/block.meta.ts +17 -1
  16. package/src/auth/ResetPasswordForm/examples/Labels.tsx +28 -0
  17. package/src/auth/SignInForm/SignInForm.labels.test.tsx +137 -0
  18. package/src/auth/SignInForm/SignInForm.tsx +43 -16
  19. package/src/auth/SignInForm/block.meta.ts +22 -1
  20. package/src/auth/SignInForm/examples/Labels.tsx +29 -0
  21. package/src/auth/SignUpForm/SignUpForm.labels.test.tsx +217 -0
  22. package/src/auth/SignUpForm/SignUpForm.tsx +65 -26
  23. package/src/auth/SignUpForm/block.meta.ts +27 -1
  24. package/src/auth/SignUpForm/examples/Labels.tsx +29 -0
  25. package/src/auth/SsoButtons/SsoButtons.labels.test.tsx +30 -0
  26. package/src/auth/SsoButtons/SsoButtons.tsx +10 -2
  27. package/src/auth/SsoButtons/block.meta.ts +8 -1
  28. package/src/auth/SsoButtons/examples/Labels.tsx +24 -0
  29. package/src/auth/shared.i18n.test.tsx +71 -0
  30. package/src/auth/shared.tsx +48 -11
  31. package/src/billing/CostBreakdown/CostBreakdown.test.tsx +10 -0
  32. package/src/billing/CostBreakdown/CostBreakdown.tsx +50 -43
  33. package/src/billing/SpendVsBudget/SpendVsBudget.test.tsx +10 -0
  34. package/src/billing/SpendVsBudget/SpendVsBudget.tsx +35 -31
  35. package/src/builders/FlowBuilder/FlowBuilder.test.tsx +237 -2
  36. package/src/builders/FlowBuilder/FlowBuilder.tsx +101 -29
  37. package/src/builders/FlowBuilder/block.meta.ts +1 -1
  38. package/src/builders/FlowBuilder/connections.ts +30 -12
  39. package/src/builders/FlowBuilder/examples/ControlledGraph.tsx +8 -0
  40. package/src/builders/FlowBuilder/graph-state.ts +78 -0
  41. package/src/builders/LogViewer/LogViewer.labels.test.tsx +90 -0
  42. package/src/builders/LogViewer/LogViewer.levels.test.tsx +49 -0
  43. package/src/builders/LogViewer/LogViewer.tsx +72 -18
  44. package/src/builders/LogViewer/LogViewer.wrap.test.tsx +181 -0
  45. package/src/builders/LogViewer/block.meta.ts +19 -1
  46. package/src/builders/LogViewer/examples/Spanish.tsx +30 -0
  47. package/src/builders/LogViewer/examples/Wrap.tsx +62 -0
  48. package/src/builders/LogViewer/use-wrapped-log-rows.ts +42 -0
  49. package/src/data-display/ChartCard/ChartCard.locale.test.tsx +15 -0
  50. package/src/data-display/ChartCard/ChartCard.test.tsx +9 -0
  51. package/src/data-display/ChartCard/ChartCard.tsx +81 -67
  52. package/src/data-display/ChartCard/block.meta.ts +1 -1
  53. package/src/data-display/DescriptionListCard/DescriptionListCard.labels.test.tsx +73 -0
  54. package/src/data-display/DescriptionListCard/DescriptionListCard.options.test.tsx +64 -0
  55. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +74 -23
  56. package/src/data-display/DescriptionListCard/block.meta.ts +11 -1
  57. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +29 -0
  58. package/src/feedback/EmptyStates/EmptyStates.labels.test.tsx +185 -0
  59. package/src/feedback/EmptyStates/EmptyStates.tsx +101 -30
  60. package/src/feedback/EmptyStates/NoAccessEmpty.options.test.tsx +38 -0
  61. package/src/feedback/EmptyStates/block.meta.ts +73 -1
  62. package/src/feedback/EmptyStates/examples/Spanish.tsx +48 -0
  63. package/src/feedback/ErrorPanel/ErrorPanel.labels.test.tsx +99 -0
  64. package/src/feedback/ErrorPanel/ErrorPanel.tsx +38 -9
  65. package/src/feedback/ErrorPanel/block.meta.ts +19 -1
  66. package/src/feedback/ErrorPanel/examples/Spanish.tsx +30 -0
  67. package/src/feedback/InlineCallout/InlineCallout.labels.test.tsx +62 -0
  68. package/src/feedback/InlineCallout/InlineCallout.tsx +22 -9
  69. package/src/feedback/InlineCallout/block.meta.ts +9 -1
  70. package/src/feedback/InlineCallout/examples/Spanish.tsx +19 -0
  71. package/src/feedback/Skeletons/Skeletons.labels.test.tsx +24 -0
  72. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.labels.test.tsx +115 -0
  73. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +63 -21
  74. package/src/forms/CreateApiKeyDialog/block.meta.ts +22 -1
  75. package/src/forms/CreateApiKeyDialog/examples/Labels.tsx +29 -0
  76. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.labels.test.tsx +165 -0
  77. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.tsx +31 -8
  78. package/src/forms/CredentialDisclosureDialog/SecretCopy.tsx +16 -8
  79. package/src/forms/CredentialDisclosureDialog/block.meta.ts +19 -1
  80. package/src/forms/CredentialDisclosureDialog/examples/Labels.tsx +38 -0
  81. package/src/forms/DangerZone/ConfirmDestructiveDialog.tsx +17 -3
  82. package/src/forms/DangerZone/DangerZone.labels.test.tsx +87 -0
  83. package/src/forms/DangerZone/DangerZone.tsx +20 -5
  84. package/src/forms/DangerZone/block.meta.ts +10 -1
  85. package/src/forms/DangerZone/examples/Labels.tsx +29 -0
  86. package/src/forms/DateRangeFilter/DateRangeFilter.labels.test.tsx +52 -0
  87. package/src/forms/DateRangeFilter/DateRangeFilter.tsx +11 -3
  88. package/src/forms/DateRangeFilter/block.meta.ts +8 -1
  89. package/src/forms/DateRangeFilter/examples/Labels.tsx +28 -0
  90. package/src/forms/DialogWizard/DialogWizard.labels.test.tsx +37 -0
  91. package/src/forms/DialogWizard/DialogWizard.tsx +13 -2
  92. package/src/forms/DialogWizard/block.meta.ts +7 -1
  93. package/src/forms/DialogWizard/examples/Labels.tsx +39 -0
  94. package/src/forms/FileUploadPanel/FileUploadPanel.labels.test.tsx +126 -0
  95. package/src/forms/FileUploadPanel/FileUploadPanel.test.tsx +22 -1
  96. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +85 -22
  97. package/src/forms/FileUploadPanel/block.meta.ts +22 -1
  98. package/src/forms/FileUploadPanel/examples/Labels.tsx +29 -0
  99. package/src/forms/FileUploadPanel/fixtures.ts +0 -12
  100. package/src/forms/FileUploadPanel/format-bytes.test.ts +8 -0
  101. package/src/forms/FormSection/FormSection.labels.test.tsx +37 -0
  102. package/src/forms/FormSection/FormSection.tsx +14 -3
  103. package/src/forms/FormSection/block.meta.ts +7 -1
  104. package/src/forms/FormSection/examples/Labels.tsx +27 -0
  105. package/src/forms/InviteMembersDialog/InviteMembersDialog.labels.test.tsx +87 -0
  106. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +51 -16
  107. package/src/forms/InviteMembersDialog/block.meta.ts +20 -1
  108. package/src/forms/InviteMembersDialog/examples/Labels.tsx +28 -0
  109. package/src/forms/SettingsRow/SettingsRow.labels.test.tsx +33 -0
  110. package/src/forms/SettingsRow/SettingsRow.tsx +14 -3
  111. package/src/forms/SettingsRow/block.meta.ts +7 -1
  112. package/src/forms/SettingsRow/examples/Labels.tsx +27 -0
  113. package/src/forms/ValidationSummary/ValidationSummary.labels.test.tsx +47 -0
  114. package/src/forms/ValidationSummary/ValidationSummary.tsx +9 -3
  115. package/src/forms/ValidationSummary/block.meta.ts +6 -1
  116. package/src/forms/ValidationSummary/examples/Labels.tsx +24 -0
  117. package/src/forms/index.ts +5 -1
  118. package/src/forms/translated-content.tsx +12 -0
  119. package/src/page-chrome/PageHeader/PageHeader.labels.test.tsx +56 -0
  120. package/src/page-chrome/PageHeader/PageHeader.options.test.tsx +34 -0
  121. package/src/page-chrome/PageHeader/PageHeader.tsx +26 -5
  122. package/src/page-chrome/PageHeader/block.meta.ts +8 -1
  123. package/src/page-chrome/PageHeader/examples/Labels.tsx +16 -0
  124. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  125. package/src/scheduling/AgendaList/AgendaList.test.tsx +25 -0
  126. package/src/scheduling/AgendaList/AgendaList.tsx +7 -2
  127. package/src/scheduling/AgendaList/AgendaListLocale.test.tsx +11 -0
  128. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  129. package/src/scheduling/AgendaList/examples/Locale.tsx +29 -0
  130. package/src/scheduling/MonthCalendar/MonthCalendar.test.tsx +111 -1
  131. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +19 -9
  132. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  133. package/src/scheduling/MonthCalendar/examples/Locale.tsx +19 -0
  134. package/src/scheduling/WeekCalendar/WeekCalendar.test.tsx +73 -2
  135. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +26 -12
  136. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  137. package/src/scheduling/WeekCalendar/examples/Locale.tsx +19 -0
  138. package/src/scheduling/shared/dates.test.ts +75 -0
  139. package/src/scheduling/shared/dates.ts +46 -22
  140. package/src/scheduling/shared/useSchedulingClock.ts +13 -0
  141. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +12 -0
  142. package/src/shell/GlobalSearch/fixtures.ts +2 -2
  143. package/src/tables/DataTable/DataTable.cross-page-selection.test.tsx +322 -0
  144. package/src/tables/DataTable/DataTable.labels.test.tsx +74 -0
  145. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +1 -1
  146. package/src/tables/DataTable/DataTable.single-select.test.tsx +47 -7
  147. package/src/tables/DataTable/DataTable.test.tsx +55 -0
  148. package/src/tables/DataTable/DataTable.tsx +134 -67
  149. package/src/tables/DataTable/block.meta.ts +21 -3
  150. package/src/tables/DataTable/data-table-props.ts +14 -5
  151. package/src/tables/DataTable/data-table-row.tsx +7 -3
  152. package/src/tables/DataTable/data-table-utils.ts +2 -0
  153. package/src/tables/DataTable/examples/client-selection.tsx +33 -0
  154. package/src/tables/DataTable/examples/paginated-single-selection.tsx +46 -0
  155. package/src/tables/DataTable/examples/server-pagination.tsx +55 -15
  156. package/src/tables/DataTable/labels.ts +4 -0
  157. package/src/tables/DataTable/selection-strip.tsx +31 -0
  158. package/src/tables/DataTable/single-selection.tsx +0 -7
  159. package/src/tables/DataTable/use-multiple-selection.ts +86 -0
  160. package/src/tables/PaginationFooter/PaginationFooter.i18n.test.tsx +26 -0
  161. package/src/test/OptInDefaults.test.tsx +27 -0
  162. package/src/test/fixtures/opt-in-defaults.json +10 -0
@@ -1,4 +1,5 @@
1
- import { Card, cn } from '@gntik-ai/ui';
1
+ import { ChartLocaleProvider } from '@gntik-ai/charts';
2
+ import { Card, cn, useI18n } from '@gntik-ai/ui';
2
3
  import { CHART_COLORS, DonutChart, type ChartColor } from '@gntik-ai/charts';
3
4
  import { formatMoney } from '../format';
4
5
  import { sampleCosts } from './fixtures';
@@ -47,49 +48,55 @@ export function CostBreakdown({
47
48
  const money = (n: number) => formatMoney(n, currency);
48
49
  const colorAt = (i: number): ChartColor => CHART_COLORS[i % CHART_COLORS.length] ?? 'primary';
49
50
 
51
+ const { locale } = useI18n();
50
52
  return (
51
- <Card className={cn('p-6', className)}>
52
- <div className="flex items-baseline justify-between gap-3">
53
- <TitleTag className="text-[15px] font-semibold tracking-tight text-foreground">{title}</TitleTag>
54
- <span className="font-mono text-[13px] font-semibold text-foreground tabular-nums">{money(total)}</span>
55
- </div>
56
- <div className="mt-5 flex flex-col items-center gap-6 sm:flex-row sm:items-center">
57
- <DonutChart
58
- data={ranked}
59
- index="label"
60
- category="amount"
61
- showLegend={false}
62
- centerLabel={centerLabel}
63
- valueFormatter={(n) => formatMoney(n, currency, true)}
64
- height={size}
65
- aria-label={`${title}: ${ranked.map((i) => `${i.label} ${money(i.amount)}`).join(', ')}`}
66
- className="shrink-0"
67
- />
68
- <ol aria-label="Categories by cost" className="grid w-full min-w-0 flex-1 gap-3">
69
- {ranked.map((item, i) => {
70
- const pct = total > 0 ? (item.amount / total) * 100 : 0;
71
- return (
72
- <li key={item.label} className="grid gap-1.5">
73
- <div className="flex items-center justify-between gap-3">
74
- <span className="flex min-w-0 items-center gap-2 text-[13px] text-foreground">
75
- <span aria-hidden className="w-4 shrink-0 font-mono text-[11px] text-muted-foreground tabular-nums">
76
- {i + 1}
53
+ <ChartLocaleProvider locale={locale}>
54
+ <Card className={cn('p-6', className)}>
55
+ <div className="flex items-baseline justify-between gap-3">
56
+ <TitleTag className="text-[15px] font-semibold tracking-tight text-foreground">{title}</TitleTag>
57
+ <span className="font-mono text-[13px] font-semibold text-foreground tabular-nums">{money(total)}</span>
58
+ </div>
59
+ <div className="mt-5 flex flex-col items-center gap-6 sm:flex-row sm:items-center">
60
+ <DonutChart
61
+ data={ranked}
62
+ index="label"
63
+ category="amount"
64
+ showLegend={false}
65
+ centerLabel={centerLabel}
66
+ valueFormatter={(n) => formatMoney(n, currency, true)}
67
+ height={size}
68
+ aria-label={`${title}: ${ranked.map((i) => `${i.label} ${money(i.amount)}`).join(', ')}`}
69
+ className="shrink-0"
70
+ />
71
+ <ol aria-label="Categories by cost" className="grid w-full min-w-0 flex-1 gap-3">
72
+ {ranked.map((item, i) => {
73
+ const pct = total > 0 ? (item.amount / total) * 100 : 0;
74
+ return (
75
+ <li key={item.label} className="grid gap-1.5">
76
+ <div className="flex items-center justify-between gap-3">
77
+ <span className="flex min-w-0 items-center gap-2 text-[13px] text-foreground">
78
+ <span
79
+ aria-hidden
80
+ className="w-4 shrink-0 font-mono text-[11px] text-muted-foreground tabular-nums"
81
+ >
82
+ {i + 1}
83
+ </span>
84
+ <span aria-hidden className={cn('size-2.5 shrink-0 rounded-[3px]', SWATCH[colorAt(i)])} />
85
+ <span className="truncate">{item.label}</span>
77
86
  </span>
78
- <span aria-hidden className={cn('size-2.5 shrink-0 rounded-[3px]', SWATCH[colorAt(i)])} />
79
- <span className="truncate">{item.label}</span>
80
- </span>
81
- <span className="shrink-0 font-mono text-[12.5px] whitespace-nowrap text-muted-foreground tabular-nums">
82
- <span className="font-semibold text-foreground">{money(item.amount)}</span> · {pct.toFixed(1)}%
83
- </span>
84
- </div>
85
- <div aria-hidden className="h-1.5 overflow-hidden rounded-full bg-secondary">
86
- <div className={cn('h-full rounded-full', SWATCH[colorAt(i)])} style={{ width: `${pct}%` }} />
87
- </div>
88
- </li>
89
- );
90
- })}
91
- </ol>
92
- </div>
93
- </Card>
87
+ <span className="shrink-0 font-mono text-[12.5px] whitespace-nowrap text-muted-foreground tabular-nums">
88
+ <span className="font-semibold text-foreground">{money(item.amount)}</span> · {pct.toFixed(1)}%
89
+ </span>
90
+ </div>
91
+ <div aria-hidden className="h-1.5 overflow-hidden rounded-full bg-secondary">
92
+ <div className={cn('h-full rounded-full', SWATCH[colorAt(i)])} style={{ width: `${pct}%` }} />
93
+ </div>
94
+ </li>
95
+ );
96
+ })}
97
+ </ol>
98
+ </div>
99
+ </Card>
100
+ </ChartLocaleProvider>
94
101
  );
95
102
  }
@@ -1,9 +1,19 @@
1
+ import { I18nProvider } from '@gntik-ai/ui';
1
2
  import { render, screen } from '@testing-library/react';
2
3
  import userEvent from '@testing-library/user-event';
3
4
  import { expectNoAxeViolations } from '../../test/a11y';
4
5
  import { SpendVsBudget } from './SpendVsBudget';
5
6
 
6
7
  describe('SpendVsBudget', () => {
8
+ it('uses the kit locale for an empty chart', () => {
9
+ render(
10
+ <I18nProvider locale="es">
11
+ <SpendVsBudget data={[]} />
12
+ </I18nProvider>,
13
+ );
14
+ expect(screen.getByText('Sin datos para este periodo')).toBeInTheDocument();
15
+ });
16
+
7
17
  it('renders the summary and the chart figure', async () => {
8
18
  const { container } = render(<SpendVsBudget />);
9
19
  expect(screen.getByRole('heading', { name: 'Spend vs budget' })).toBeInTheDocument();
@@ -1,4 +1,5 @@
1
- import { Badge, Card, cn } from '@gntik-ai/ui';
1
+ import { ChartLocaleProvider } from '@gntik-ai/charts';
2
+ import { Badge, Card, cn, useI18n } from '@gntik-ai/ui';
2
3
  import { LineChart } from '@gntik-ai/charts';
3
4
  import { formatMoney } from '../format';
4
5
  import { sampleBudget, sampleSpend } from './fixtures';
@@ -69,37 +70,40 @@ export function SpendVsBudget({
69
70
  { label: 'Budget', value: formatMoney(budget, currency) },
70
71
  ];
71
72
 
73
+ const { locale } = useI18n();
72
74
  return (
73
- <Card className={cn('p-6', className)}>
74
- <div className="flex flex-wrap items-start justify-between gap-3">
75
- <div>
76
- <TitleTag className="text-[15px] font-semibold tracking-tight text-foreground">{title}</TitleTag>
77
- {period && <p className="mt-0.5 text-[12.5px] text-muted-foreground">{period}</p>}
78
- </div>
79
- <Badge tone={over ? 'warning' : 'success'} dot>
80
- {over ? 'Forecast over budget' : 'Within budget'}
81
- </Badge>
82
- </div>
83
- <dl className="mt-4 grid grid-cols-3 gap-4">
84
- {stats.map((s) => (
85
- <div key={s.label} className="min-w-0">
86
- <dt className="text-[11.5px] text-muted-foreground">{s.label}</dt>
87
- <dd className="mt-1 truncate font-mono text-[14px] font-semibold text-foreground tabular-nums">
88
- {s.value}
89
- </dd>
75
+ <ChartLocaleProvider locale={locale}>
76
+ <Card className={cn('p-6', className)}>
77
+ <div className="flex flex-wrap items-start justify-between gap-3">
78
+ <div>
79
+ <TitleTag className="text-[15px] font-semibold tracking-tight text-foreground">{title}</TitleTag>
80
+ {period && <p className="mt-0.5 text-[12.5px] text-muted-foreground">{period}</p>}
90
81
  </div>
91
- ))}
92
- </dl>
93
- <LineChart
94
- className="mt-5"
95
- data={rows}
96
- index="day"
97
- categories={['Spend', 'Forecast', 'Budget']}
98
- colors={['primary', 'cyan', 'amber']}
99
- valueFormatter={money}
100
- height={height}
101
- aria-label={`${title}: ${formatMoney(toDate, currency)} spent, ${formatMoney(forecast, currency)} forecast against a ${formatMoney(budget, currency)} budget`}
102
- />
103
- </Card>
82
+ <Badge tone={over ? 'warning' : 'success'} dot>
83
+ {over ? 'Forecast over budget' : 'Within budget'}
84
+ </Badge>
85
+ </div>
86
+ <dl className="mt-4 grid grid-cols-3 gap-4">
87
+ {stats.map((s) => (
88
+ <div key={s.label} className="min-w-0">
89
+ <dt className="text-[11.5px] text-muted-foreground">{s.label}</dt>
90
+ <dd className="mt-1 truncate font-mono text-[14px] font-semibold text-foreground tabular-nums">
91
+ {s.value}
92
+ </dd>
93
+ </div>
94
+ ))}
95
+ </dl>
96
+ <LineChart
97
+ className="mt-5"
98
+ data={rows}
99
+ index="day"
100
+ categories={['Spend', 'Forecast', 'Budget']}
101
+ colors={['primary', 'cyan', 'amber']}
102
+ valueFormatter={money}
103
+ height={height}
104
+ aria-label={`${title}: ${formatMoney(toDate, currency)} spent, ${formatMoney(forecast, currency)} forecast against a ${formatMoney(budget, currency)} budget`}
105
+ />
106
+ </Card>
107
+ </ChartLocaleProvider>
104
108
  );
105
109
  }
@@ -4,7 +4,8 @@ import userEvent from '@testing-library/user-event';
4
4
  import { FlowStatusBadge } from '@gntik-ai/flow';
5
5
  import { expectNoAxeViolations } from '../../test/a11y';
6
6
  import * as blocks from '../../index';
7
- import { FlowBuilder, type ConsoleEntry, type FlowEdge, type FlowNode } from './FlowBuilder';
7
+ import { FlowBuilder, type ConsoleEntry, type FlowEdge, type FlowNode, type FlowGraph } from './FlowBuilder';
8
+ import { builderNodes, builderEdges } from './fixtures';
8
9
 
9
10
  // React Flow in jsdom reads the zoom from DOMMatrixReadOnly and node sizes from offset*.
10
11
  beforeAll(() => {
@@ -27,6 +28,203 @@ function setWide(matches: boolean) {
27
28
  }
28
29
 
29
30
  describe('FlowBuilder', () => {
31
+ it('keeps controlled positions fixed until the host applies a move', async () => {
32
+ const changed = vi.fn<(graph: FlowGraph) => void>();
33
+ const onRun = vi.fn<(graph: FlowGraph) => void>();
34
+ const graph = { nodes: builderNodes, edges: builderEdges };
35
+ const { rerender } = render(<FlowBuilder graph={graph} onGraphChange={changed} onRun={onRun} />);
36
+ fireEvent.click(screen.getByTestId('rf__node-validate'));
37
+ screen.getByTestId('rf__node-validate').focus();
38
+ await userEvent.keyboard('{ArrowRight}');
39
+ expect(changed).toHaveBeenCalledOnce();
40
+ expect(changed.mock.calls[0]?.[0].nodes.find((node) => node.id === 'validate')?.position).toEqual({
41
+ x: 272,
42
+ y: 96,
43
+ });
44
+ await userEvent.click(screen.getByRole('button', { name: 'Run' }));
45
+ expect(onRun.mock.calls[0]?.[0].nodes.find((node) => node.id === 'validate')?.position).toEqual({ x: 256, y: 96 });
46
+ rerender(<FlowBuilder graph={changed.mock.calls[0]![0]} onGraphChange={changed} onRun={onRun} />);
47
+ expect(screen.getByTestId('rf__node-validate')).toHaveClass('selected');
48
+ await userEvent.click(screen.getByRole('button', { name: 'Run' }));
49
+ expect(onRun.mock.calls[1]?.[0].nodes.find((node) => node.id === 'validate')?.position).toEqual({ x: 272, y: 96 });
50
+ });
51
+
52
+ it('reports an edge-only Backspace deletion once', async () => {
53
+ const changed = vi.fn();
54
+ render(
55
+ <FlowBuilder
56
+ edges={builderEdges.map((edge) => ({ ...edge, selected: edge.id === 'e-webhook-validate' }))}
57
+ onGraphChange={changed}
58
+ />,
59
+ );
60
+ screen.getByTestId('rf__node-webhook').focus();
61
+ expect(changed).not.toHaveBeenCalled();
62
+ await userEvent.keyboard('{Backspace}');
63
+ expect(changed).toHaveBeenCalledExactlyOnceWith(
64
+ expect.objectContaining({ nodes: expect.any(Array), edges: expect.any(Array) }),
65
+ { type: 'delete', nodeIds: [], edgeIds: ['e-webhook-validate'] },
66
+ );
67
+ expect(changed.mock.calls[0]?.[0].nodes).toHaveLength(5);
68
+ expect(changed.mock.calls[0]?.[0].edges).toHaveLength(3);
69
+ });
70
+
71
+ it('reports a drag only on drop', async () => {
72
+ const changed = vi.fn();
73
+ render(<FlowBuilder onGraphChange={changed} />);
74
+ const node = screen.getByTestId('rf__node-notify');
75
+ // jsdom rejects Vitest's Window proxy in the constructor; d3 needs the event view.
76
+ const mouse = (target: HTMLElement | Window, type: string, x: number, buttons = 1) => {
77
+ const event = new MouseEvent(type, {
78
+ bubbles: true,
79
+ cancelable: true,
80
+ clientX: x,
81
+ clientY: 20,
82
+ button: 0,
83
+ buttons,
84
+ });
85
+ Object.defineProperty(event, 'view', { value: window });
86
+ fireEvent(target, event);
87
+ };
88
+ mouse(node, 'mousedown', 20);
89
+ mouse(window, 'mousemove', 32);
90
+ mouse(window, 'mousemove', 64);
91
+ mouse(window, 'mousemove', 96);
92
+ expect(changed).not.toHaveBeenCalled();
93
+ mouse(window, 'mouseup', 96, 0);
94
+ // d3 suppresses the next click until a zero-delay task removes its window listener.
95
+ await new Promise<void>((resolve) => setTimeout(resolve, 0));
96
+ expect(changed).toHaveBeenCalledExactlyOnceWith(expect.objectContaining({ nodes: expect.any(Array) }), {
97
+ type: 'move',
98
+ nodeIds: ['notify'],
99
+ edgeIds: [],
100
+ });
101
+ expect(changed.mock.calls[0]?.[0].nodes.find((n: FlowNode) => n.id === 'notify').position).toEqual({
102
+ x: 832,
103
+ y: 16,
104
+ });
105
+ });
106
+
107
+ it('reports each inspector value change without transient node fields', () => {
108
+ const changed = vi.fn();
109
+ render(
110
+ <FlowBuilder
111
+ nodes={builderNodes.map((node) => ({ ...node, measured: { width: 208, height: 90 }, dragging: false }))}
112
+ onGraphChange={changed}
113
+ />,
114
+ );
115
+ fireEvent.click(screen.getByTestId('rf__node-validate'));
116
+ const title = screen.getByRole('textbox', { name: 'Title' });
117
+ fireEvent.change(title, { target: { value: 'Check' } });
118
+ fireEvent.change(title, { target: { value: 'Check order' } });
119
+ expect(changed).toHaveBeenCalledTimes(2);
120
+ expect(changed.mock.calls.map((call) => call[1])).toEqual([
121
+ { type: 'update', nodeIds: ['validate'], edgeIds: [] },
122
+ { type: 'update', nodeIds: ['validate'], edgeIds: [] },
123
+ ]);
124
+ const graph = changed.mock.calls[1]?.[0];
125
+ expect(graph.nodes.find((n: FlowNode) => n.id === 'validate').data.title).toBe('Check order');
126
+ for (const node of graph.nodes) {
127
+ expect(node).not.toHaveProperty('selected');
128
+ expect(node).not.toHaveProperty('dragging');
129
+ expect(node).not.toHaveProperty('measured');
130
+ }
131
+ });
132
+
133
+ it('ignores selection and reports each arrow-key move step', async () => {
134
+ const changed = vi.fn();
135
+ render(<FlowBuilder onGraphChange={changed} />);
136
+ fireEvent.click(screen.getByTestId('rf__node-validate'));
137
+ expect(changed).not.toHaveBeenCalled();
138
+ screen.getByTestId('rf__node-validate').focus();
139
+ await userEvent.keyboard('{ArrowRight}{ArrowRight}');
140
+ expect(changed).toHaveBeenCalledTimes(2);
141
+ expect(changed.mock.calls.map((call) => call[1])).toEqual([
142
+ { type: 'move', nodeIds: ['validate'], edgeIds: [] },
143
+ { type: 'move', nodeIds: ['validate'], edgeIds: [] },
144
+ ]);
145
+ expect(changed.mock.calls[1]?.[0].nodes.find((n: FlowNode) => n.id === 'validate').position).toEqual({
146
+ x: 288,
147
+ y: 96,
148
+ });
149
+ });
150
+
151
+ it.each(['keyboard', 'inspector'])('reports a node and its connected edges in one delete via %s', async (method) => {
152
+ const changed = vi.fn();
153
+ render(<FlowBuilder onGraphChange={changed} />);
154
+ fireEvent.click(screen.getByTestId('rf__node-route'));
155
+ if (method === 'keyboard') {
156
+ screen.getByTestId('rf__node-route').focus();
157
+ await userEvent.keyboard('{Backspace}');
158
+ } else await userEvent.click(screen.getByRole('button', { name: 'Delete node' }));
159
+ expect(changed).toHaveBeenCalledExactlyOnceWith(
160
+ expect.objectContaining({ nodes: expect.any(Array), edges: expect.any(Array) }),
161
+ {
162
+ type: 'delete',
163
+ nodeIds: ['route'],
164
+ edgeIds: ['e-validate-route', 'e-route-notify', 'e-route-store'],
165
+ },
166
+ );
167
+ expect(changed.mock.calls[0]?.[0].nodes).toHaveLength(4);
168
+ expect(changed.mock.calls[0]?.[0].edges).toHaveLength(1);
169
+ });
170
+
171
+ it('leaves controlled edits to the host and retains the new selection when applied', async () => {
172
+ const graph = { nodes: builderNodes, edges: builderEdges };
173
+ const changed = vi.fn<(graph: FlowGraph) => void>();
174
+ const { rerender } = render(<FlowBuilder graph={graph} onGraphChange={changed} />);
175
+ await userEvent.click(screen.getByRole('button', { name: 'Add Step' }));
176
+ expect(changed).toHaveBeenCalledOnce();
177
+ expect(changed.mock.calls[0]?.[0].nodes).toHaveLength(6);
178
+ expect(screen.getByText('5 nodes · 4 edges')).toBeInTheDocument();
179
+ expect(screen.queryByTestId('rf__node-step-1')).toBeNull();
180
+ rerender(<FlowBuilder graph={changed.mock.calls[0]![0]} onGraphChange={changed} />);
181
+ expect(screen.getByText('6 nodes · 4 edges')).toBeInTheDocument();
182
+ expect(screen.getByTestId('rf__node-step-1')).toHaveClass('selected');
183
+ expect(screen.getByRole('textbox', { name: 'Title' })).toHaveValue('New step');
184
+ fireEvent.change(screen.getByRole('textbox', { name: 'Title' }), { target: { value: 'Parent must apply' } });
185
+ expect(screen.getByRole('textbox', { name: 'Title' })).toHaveValue('New step');
186
+ });
187
+
188
+ it('skips palette ids that are already present in a reloaded graph', async () => {
189
+ const changed = vi.fn();
190
+ render(
191
+ <FlowBuilder
192
+ nodes={[
193
+ ...builderNodes,
194
+ { id: 'step-1', type: 'step', position: { x: 1024, y: 0 }, data: { title: 'Existing' } },
195
+ ]}
196
+ onGraphChange={changed}
197
+ />,
198
+ );
199
+ await userEvent.click(screen.getByRole('button', { name: 'Add Step' }));
200
+ expect(changed.mock.calls[0]?.[1]).toEqual({ type: 'add', nodeIds: ['step-2'], edgeIds: [] });
201
+ expect(screen.getByTestId('rf__node-step-2')).toBeInTheDocument();
202
+ });
203
+
204
+ it('reports a palette add once with a persistent graph and keeps onRun canvas state', async () => {
205
+ const changed = vi.fn();
206
+ const onRun = vi.fn();
207
+ render(<FlowBuilder onGraphChange={changed} onRun={onRun} />);
208
+ await userEvent.click(screen.getByRole('button', { name: 'Add Step' }));
209
+ expect(changed).toHaveBeenCalledExactlyOnceWith(
210
+ expect.objectContaining({
211
+ nodes: expect.any(Array),
212
+ edges: expect.any(Array),
213
+ }),
214
+ { type: 'add', nodeIds: ['step-1'], edgeIds: [] },
215
+ );
216
+ const graph = changed.mock.calls[0]?.[0];
217
+ expect(graph.nodes).toHaveLength(6);
218
+ expect(graph.edges).toHaveLength(4);
219
+ for (const node of graph.nodes) {
220
+ expect(node).not.toHaveProperty('selected');
221
+ expect(node).not.toHaveProperty('dragging');
222
+ expect(node).not.toHaveProperty('measured');
223
+ }
224
+ await userEvent.click(screen.getByRole('button', { name: 'Run' }));
225
+ expect(onRun.mock.calls[0]?.[0].nodes.find((n: FlowNode) => n.id === 'step-1')).toHaveProperty('selected', true);
226
+ });
227
+
30
228
  it('renders palette, canvas, inspector and console; resizable on wide screens', async () => {
31
229
  const restore = setWide(true);
32
230
  try {
@@ -169,6 +367,32 @@ function connectHandles(sourceId: string, handleId: string, targetId: string) {
169
367
  fireEvent.click(target);
170
368
  }
171
369
 
370
+ it.each([false, true])('reports an accepted connection once (mapped: %s)', (mapped) => {
371
+ const changed = vi.fn();
372
+ render(
373
+ <FlowBuilder
374
+ nodes={[
375
+ { id: 'a', type: 'custom', position: { x: 0, y: 0 }, data: { title: 'Source' } },
376
+ { id: 'b', type: 'output', position: { x: 256, y: 0 }, data: { title: 'Target' } },
377
+ ]}
378
+ edges={[]}
379
+ nodeTypes={[
380
+ { type: 'custom', handles: [{ id: 'next', kind: 'source' }], render: ({ data }) => <span>{data.title}</span> },
381
+ ]}
382
+ onConnectEdge={mapped ? () => ({ type: 'smoothstep', data: { kind: 'sequence' } }) : undefined}
383
+ onGraphChange={changed}
384
+ />,
385
+ );
386
+ connectHandles('a', 'next', 'b');
387
+ expect(changed).toHaveBeenCalledOnce();
388
+ const [graph, change] = changed.mock.calls[0]!;
389
+ expect(graph.edges).toEqual([
390
+ expect.objectContaining({ source: 'a', target: 'b', sourceHandle: 'next', type: 'smoothstep' }),
391
+ ]);
392
+ expect(change).toEqual({ type: 'connect', nodeIds: [], edgeIds: [graph.edges[0].id] });
393
+ if (mapped) expect(graph.edges[0].data).toEqual({ kind: 'sequence' });
394
+ });
395
+
172
396
  it('preserves built-in node kinds in the public inspector props', () => {
173
397
  const node: NonNullable<blocks.NodeInspectorProps['node']> = {
174
398
  id: 'step',
@@ -236,6 +460,7 @@ it.each([
236
460
  });
237
461
 
238
462
  it('rejects a connection without mapping, notifying acceptance or adding an edge', async () => {
463
+ const changed = vi.fn();
239
464
  const rejection = {
240
465
  code: 'cycle',
241
466
  nodeId: 'a',
@@ -274,12 +499,14 @@ it('rejects a connection without mapping, notifying acceptance or adding an edge
274
499
  onConnect={accepted}
275
500
  onConnectEdge={mapper}
276
501
  onRun={onRun}
502
+ onGraphChange={changed}
277
503
  />,
278
504
  );
279
505
  connectHandles('a', 'arm', 'b');
280
506
  expect(rejected).toHaveBeenCalledExactlyOnceWith(rejection);
281
507
  expect(accepted).not.toHaveBeenCalled();
282
508
  expect(mapper).not.toHaveBeenCalled();
509
+ expect(changed).not.toHaveBeenCalled();
283
510
  await userEvent.click(screen.getByRole('button', { name: 'Run' }));
284
511
  expect(onRun.mock.calls[0]?.[0].edges).toEqual([]);
285
512
  expect(screen.queryByRole('list', { name: 'Flow problems' })).toBeNull();
@@ -307,8 +534,14 @@ it('decorates invalid nodes with an icon and text and focuses a problem node', a
307
534
 
308
535
  it('run mode keeps labelled nodes selectable with live status but prevents editing', async () => {
309
536
  const selected = vi.fn();
537
+ const changed = vi.fn();
310
538
  const { rerender } = render(
311
- <FlowBuilder mode="run" nodeStatus={{ webhook: 'running', validate: 'paused' }} onNodeSelect={selected} />,
539
+ <FlowBuilder
540
+ mode="run"
541
+ nodeStatus={{ webhook: 'running', validate: 'paused' }}
542
+ onNodeSelect={selected}
543
+ onGraphChange={changed}
544
+ />,
312
545
  );
313
546
  expect(screen.queryByRole('button', { name: /Add Step/ })).toBeNull();
314
547
  expect(screen.queryByRole('button', { name: 'Run' })).toBeNull();
@@ -327,6 +560,8 @@ it('run mode keeps labelled nodes selectable with live status but prevents editi
327
560
  fireEvent.click(other);
328
561
  await userEvent.keyboard('{Backspace}');
329
562
  expect(other).toBeInTheDocument();
563
+ fireEvent.keyDown(other, { key: 'ArrowRight' });
564
+ expect(changed).not.toHaveBeenCalled();
330
565
  rerender(<FlowBuilder mode="run" nodeStatus={{ webhook: 'done', validate: 'paused' }} onNodeSelect={selected} />);
331
566
  expect(within(node).getByText('Done')).toBeInTheDocument();
332
567
  expect(within(other).getByText('Paused')).toBeInTheDocument();