@gntik-ai/blocks 0.10.0 → 0.12.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 (248) hide show
  1. package/dist/index.d.ts +1761 -1231
  2. package/dist/index.js +3280 -1088
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/ai/PromptEditor/PromptEditor.tsx +2 -2
  6. package/src/ai/PromptEditor/examples/controlled-variables.tsx +1 -1
  7. package/src/ai/TraceWaterfall/TraceWaterfall.tsx +2 -2
  8. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.labels.test.tsx +179 -0
  9. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.test.tsx +6 -0
  10. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +63 -25
  11. package/src/auth/ForgotPasswordForm/block.meta.ts +22 -1
  12. package/src/auth/ForgotPasswordForm/examples/Labels.tsx +29 -0
  13. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  14. package/src/auth/MfaChallenge/MfaChallenge.labels.test.tsx +139 -0
  15. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  16. package/src/auth/MfaChallenge/MfaChallenge.tsx +74 -25
  17. package/src/auth/MfaChallenge/block.meta.ts +29 -1
  18. package/src/auth/MfaChallenge/examples/Labels.tsx +28 -0
  19. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  20. package/src/auth/ResetPasswordForm/ResetPasswordForm.labels.test.tsx +104 -0
  21. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  22. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +47 -18
  23. package/src/auth/ResetPasswordForm/block.meta.ts +17 -1
  24. package/src/auth/ResetPasswordForm/examples/Labels.tsx +28 -0
  25. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  26. package/src/auth/SignInForm/SignInForm.labels.test.tsx +137 -0
  27. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  28. package/src/auth/SignInForm/SignInForm.tsx +48 -17
  29. package/src/auth/SignInForm/block.meta.ts +22 -1
  30. package/src/auth/SignInForm/examples/Labels.tsx +29 -0
  31. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  32. package/src/auth/SignUpForm/SignUpForm.labels.test.tsx +217 -0
  33. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  34. package/src/auth/SignUpForm/SignUpForm.tsx +72 -27
  35. package/src/auth/SignUpForm/block.meta.ts +27 -1
  36. package/src/auth/SignUpForm/examples/Labels.tsx +29 -0
  37. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  38. package/src/auth/SsoButtons/SsoButtons.labels.test.tsx +30 -0
  39. package/src/auth/SsoButtons/SsoButtons.tsx +10 -2
  40. package/src/auth/SsoButtons/block.meta.ts +8 -1
  41. package/src/auth/SsoButtons/examples/Labels.tsx +24 -0
  42. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  43. package/src/auth/field-size.test.tsx +21 -0
  44. package/src/auth/large-examples.test.tsx +30 -0
  45. package/src/auth/shared.i18n.test.tsx +71 -0
  46. package/src/auth/shared.tsx +55 -13
  47. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  48. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  49. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  50. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  51. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  52. package/src/builders/CodePanel/CodePanel.tsx +2 -2
  53. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  54. package/src/builders/FlowBuilder/parts.tsx +4 -4
  55. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  56. package/src/builders/LogViewer/LogViewer.levels.test.tsx +49 -0
  57. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  58. package/src/builders/LogViewer/LogViewer.tsx +96 -28
  59. package/src/builders/LogViewer/LogViewer.wrap.test.tsx +181 -0
  60. package/src/builders/LogViewer/block.meta.ts +7 -1
  61. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  62. package/src/builders/LogViewer/examples/Wrap.tsx +62 -0
  63. package/src/builders/LogViewer/use-wrapped-log-rows.ts +42 -0
  64. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  65. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  66. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  67. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  68. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  69. package/src/data-display/CommentThread/block.meta.ts +1 -1
  70. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  71. package/src/data-display/DescriptionListCard/DescriptionListCard.options.test.tsx +64 -0
  72. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  73. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +52 -37
  74. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  75. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +9 -1
  76. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  77. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  78. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  79. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  80. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  81. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  82. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  83. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  84. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  85. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  86. package/src/feedback/EmptyStates/EmptyStates.tsx +37 -17
  87. package/src/feedback/EmptyStates/NoAccessEmpty.options.test.tsx +38 -0
  88. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  89. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  90. package/src/feedback/EmptyStates/examples/Spanish.tsx +7 -0
  91. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  92. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.labels.test.tsx +115 -0
  93. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  94. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +153 -122
  95. package/src/forms/CreateApiKeyDialog/block.meta.ts +34 -2
  96. package/src/forms/CreateApiKeyDialog/examples/Labels.tsx +29 -0
  97. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.labels.test.tsx +165 -0
  98. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.tsx +31 -8
  99. package/src/forms/CredentialDisclosureDialog/SecretCopy.tsx +16 -8
  100. package/src/forms/CredentialDisclosureDialog/block.meta.ts +19 -1
  101. package/src/forms/CredentialDisclosureDialog/examples/Labels.tsx +38 -0
  102. package/src/forms/DangerZone/ConfirmDestructiveDialog.tsx +17 -3
  103. package/src/forms/DangerZone/DangerZone.labels.test.tsx +87 -0
  104. package/src/forms/DangerZone/DangerZone.tsx +20 -5
  105. package/src/forms/DangerZone/block.meta.ts +10 -1
  106. package/src/forms/DangerZone/examples/Labels.tsx +29 -0
  107. package/src/forms/DateRangeFilter/DateRangeFilter.labels.test.tsx +52 -0
  108. package/src/forms/DateRangeFilter/DateRangeFilter.tsx +11 -3
  109. package/src/forms/DateRangeFilter/block.meta.ts +8 -1
  110. package/src/forms/DateRangeFilter/examples/Labels.tsx +28 -0
  111. package/src/forms/DialogWizard/DialogWizard.labels.test.tsx +37 -0
  112. package/src/forms/DialogWizard/DialogWizard.tsx +13 -2
  113. package/src/forms/DialogWizard/block.meta.ts +7 -1
  114. package/src/forms/DialogWizard/examples/Labels.tsx +39 -0
  115. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  116. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  117. package/src/forms/FileUploadPanel/FileUploadPanel.labels.test.tsx +126 -0
  118. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  119. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +336 -75
  120. package/src/forms/FileUploadPanel/block.meta.ts +26 -1
  121. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  122. package/src/forms/FileUploadPanel/examples/Labels.tsx +29 -0
  123. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  124. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  125. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  126. package/src/forms/FormSection/FormSection.labels.test.tsx +37 -0
  127. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  128. package/src/forms/FormSection/FormSection.tsx +34 -25
  129. package/src/forms/FormSection/block.meta.ts +7 -1
  130. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  131. package/src/forms/FormSection/examples/Labels.tsx +27 -0
  132. package/src/forms/InviteMembersDialog/InviteMembersDialog.labels.test.tsx +87 -0
  133. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  134. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +121 -105
  135. package/src/forms/InviteMembersDialog/block.meta.ts +21 -2
  136. package/src/forms/InviteMembersDialog/examples/Labels.tsx +28 -0
  137. package/src/forms/SettingsRow/SettingsRow.labels.test.tsx +33 -0
  138. package/src/forms/SettingsRow/SettingsRow.tsx +14 -3
  139. package/src/forms/SettingsRow/block.meta.ts +7 -1
  140. package/src/forms/SettingsRow/examples/Labels.tsx +27 -0
  141. package/src/forms/ValidationSummary/ValidationSummary.labels.test.tsx +47 -0
  142. package/src/forms/ValidationSummary/ValidationSummary.tsx +10 -7
  143. package/src/forms/ValidationSummary/block.meta.ts +6 -1
  144. package/src/forms/ValidationSummary/examples/Labels.tsx +24 -0
  145. package/src/forms/index.ts +5 -1
  146. package/src/forms/translated-content.tsx +12 -0
  147. package/src/hooks/index.ts +2 -0
  148. package/src/hooks/useTableData.integration.test.tsx +89 -0
  149. package/src/hooks/useTableData.test.tsx +613 -0
  150. package/src/hooks/useTableData.ts +377 -0
  151. package/src/index.ts +1 -0
  152. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  153. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  154. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  155. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  156. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  157. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  158. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  159. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  160. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  161. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  162. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  163. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  164. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  165. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  166. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  167. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  168. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  169. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  170. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  171. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  172. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  173. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  174. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  175. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  176. package/src/marketing/index.ts +6 -0
  177. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  178. package/src/page-chrome/PageHeader/PageHeader.options.test.tsx +34 -0
  179. package/src/page-chrome/PageHeader/PageHeader.tsx +11 -5
  180. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  181. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  182. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  183. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  184. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  185. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  186. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  187. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  188. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  189. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  190. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  191. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  192. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  193. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  194. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  195. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  196. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  197. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  198. package/src/scheduling/shared/dates.ts +102 -58
  199. package/src/scheduling/shared/events.ts +2 -2
  200. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  201. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  202. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  203. package/src/shell/AppSidebar/block.meta.ts +1 -1
  204. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  205. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  206. package/src/tables/DataTable/DataTable.cross-page-selection.test.tsx +322 -0
  207. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  208. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  209. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  210. package/src/tables/DataTable/DataTable.labels.test.tsx +74 -0
  211. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  212. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  213. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +329 -15
  214. package/src/tables/DataTable/DataTable.single-select.test.tsx +47 -7
  215. package/src/tables/DataTable/DataTable.test.tsx +140 -1
  216. package/src/tables/DataTable/DataTable.tsx +241 -80
  217. package/src/tables/DataTable/block.meta.ts +31 -3
  218. package/src/tables/DataTable/column-sizing.ts +2 -2
  219. package/src/tables/DataTable/data-table-props.ts +43 -6
  220. package/src/tables/DataTable/data-table-row.tsx +9 -5
  221. package/src/tables/DataTable/data-table-utils.ts +6 -0
  222. package/src/tables/DataTable/editable-cell.tsx +20 -79
  223. package/src/tables/DataTable/examples/client-selection.tsx +33 -0
  224. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  225. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  226. package/src/tables/DataTable/examples/paginated-single-selection.tsx +46 -0
  227. package/src/tables/DataTable/examples/server-pagination.tsx +91 -44
  228. package/src/tables/DataTable/export-menu.tsx +58 -0
  229. package/src/tables/DataTable/header-cell.tsx +1 -1
  230. package/src/tables/DataTable/labels.ts +11 -0
  231. package/src/tables/DataTable/resize-handle.tsx +2 -2
  232. package/src/tables/DataTable/selection-strip.tsx +31 -0
  233. package/src/tables/DataTable/single-selection.tsx +0 -7
  234. package/src/tables/DataTable/use-multiple-selection.ts +86 -0
  235. package/src/tables/DataTable/use-table-export.ts +117 -0
  236. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  237. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  238. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  239. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  240. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  241. package/src/team/ProfileHeader/block.meta.ts +1 -1
  242. package/src/test/OptInDefaults.test.tsx +36 -0
  243. package/src/test/clipboard-fallback.test.tsx +49 -0
  244. package/src/test/copy-examples.test.tsx +29 -0
  245. package/src/test/copy-feedback.test.tsx +166 -0
  246. package/src/test/fixtures/opt-in-defaults.json +10 -0
  247. package/src/test/without-forced-colors.test.ts +44 -0
  248. package/src/test/without-forced-colors.ts +14 -0
package/dist/index.d.ts CHANGED
@@ -135,7 +135,7 @@ export interface TraceWaterfallProps {
135
135
  export declare function TraceWaterfall({ spans, title, selectedId: selectedProp, defaultSelectedId, onSelect, onSelectedIdChange, defaultCollapsed, showDetails, renderDetails, titleAs: TitleTag, className }: TraceWaterfallProps): import("react").JSX.Element;
136
136
  //#endregion
137
137
  //#region src/ai/TraceWaterfall/block.meta.d.ts
138
- declare const meta$74: BlockMeta;
138
+ declare const meta$76: BlockMeta;
139
139
  //#endregion
140
140
  //#region src/ai/TokenCostCard/fixtures.d.ts
141
141
  interface TokenUsagePeriod {
@@ -169,7 +169,7 @@ export interface TokenCostCardProps {
169
169
  export declare function TokenCostCard({ periods, defaultPeriod, currency, title, description, titleAs, className }: TokenCostCardProps): import("react").JSX.Element | null;
170
170
  //#endregion
171
171
  //#region src/ai/TokenCostCard/block.meta.d.ts
172
- declare const meta$73: BlockMeta;
172
+ declare const meta$75: BlockMeta;
173
173
  //#endregion
174
174
  //#region src/ai/PromptEditor/PromptEditor.d.ts
175
175
  export interface PromptRunInput {
@@ -206,7 +206,7 @@ export declare function extractPromptVariables(...texts: string[]): string[];
206
206
  export declare function PromptEditor({ title, defaultSystem, defaultUser, defaultVariables, variables: variablesProp, onVariablesChange, defaultTemperature, defaultMaxTokens, maxTokensLimit, onRun, titleAs: TitleTag, className }: PromptEditorProps): import("react").JSX.Element;
207
207
  //#endregion
208
208
  //#region src/ai/PromptEditor/block.meta.d.ts
209
- declare const meta$55: BlockMeta;
209
+ declare const meta$56: BlockMeta;
210
210
  //#endregion
211
211
  //#region src/ai/EvaluationScorecard/fixtures.d.ts
212
212
  interface EvalMetric {
@@ -288,9 +288,13 @@ export interface ModelKeysListProps {
288
288
  export declare function ModelKeysList({ keys, title, onTest, onRevoke, onAdd, titleAs, className }: ModelKeysListProps): import("react").JSX.Element;
289
289
  //#endregion
290
290
  //#region src/ai/ModelKeysList/block.meta.d.ts
291
- declare const meta$43: BlockMeta;
291
+ declare const meta$44: BlockMeta;
292
292
  //#endregion
293
293
  //#region src/auth/shared.d.ts
294
+ interface AuthFieldSizeProps {
295
+ /** Field size: auto follows density (default); lg matches the 44px submit button. */
296
+ fieldSize?: 'auto' | 'lg';
297
+ }
294
298
  interface AuthHeaderProps {
295
299
  eyebrow?: ReactNode;
296
300
  title: ReactNode;
@@ -352,6 +356,10 @@ interface AuthSignUpField {
352
356
  invalid?: string;
353
357
  };
354
358
  }
359
+ interface AuthSignUpFieldLabels {
360
+ fieldRequired: (label: string) => string;
361
+ fieldInvalid: string;
362
+ }
355
363
  /** Consumer-owned copy and optional action when account creation is unavailable. */
356
364
  interface AuthUnavailableState {
357
365
  title: ReactNode;
@@ -368,7 +376,25 @@ interface AuthSignUpValidationMessages {
368
376
  export interface ForgotPasswordFormRef {
369
377
  focus(field: 'identifier'): void;
370
378
  }
371
- export interface ForgotPasswordFormProps extends AuthFormAccessibilityProps {
379
+ export interface ForgotPasswordFormLabels extends Required<Omit<AuthValidationMessages, 'passwordRequired'>> {
380
+ formLabel: string;
381
+ eyebrow: string;
382
+ title: string;
383
+ description: string;
384
+ sentTitle: string;
385
+ sentDescription: (email: string) => ReactNode;
386
+ addressFallback: string;
387
+ sentStatus: string;
388
+ fallbackError: string;
389
+ backToSignIn: string;
390
+ resend: string;
391
+ changeEmail: string;
392
+ identifierLabel: string;
393
+ identifierPlaceholder: string;
394
+ submit: string;
395
+ }
396
+ export interface ForgotPasswordFormProps extends AuthFormAccessibilityProps, AuthFieldSizeProps {
397
+ labels?: Partial<ForgotPasswordFormLabels>;
372
398
  /** React 19 ref for focus after a server response; available in the request state. */
373
399
  ref?: Ref<ForgotPasswordFormRef>;
374
400
  identifier?: AuthIdentifierConfig;
@@ -396,14 +422,37 @@ export interface ForgotPasswordFormProps extends AuthFormAccessibilityProps {
396
422
  className?: string;
397
423
  }
398
424
  /** Request a reset link by email, then a "check your inbox" state with resend and a way back. */
399
- export declare function ForgotPasswordForm({ identifier, messages, ref, fieldInvalid, feedbackId, 'aria-describedby': describedBy, 'aria-label': ariaLabel, 'aria-labelledby': labelledBy, onSubmit, error: errorProp, defaultEmail, defaultSent, signInHref, onBackToSignIn, eyebrow, title, description, sentTitle, sentDescription, sentStatus, resendActions, headingLevel, className }: ForgotPasswordFormProps): import("react").JSX.Element;
425
+ export declare function ForgotPasswordForm({ labels, fieldSize, identifier, messages, ref, fieldInvalid, feedbackId, 'aria-describedby': describedBy, 'aria-label': ariaLabelProp, 'aria-labelledby': labelledBy, onSubmit, error: errorProp, defaultEmail, defaultSent, signInHref, onBackToSignIn, eyebrow: eyebrowProp, title: titleProp, description: descriptionProp, sentTitle: sentTitleProp, sentDescription, sentStatus: sentStatusProp, resendActions, headingLevel, className }: ForgotPasswordFormProps): import("react").JSX.Element;
400
426
  //#endregion
401
427
  //#region src/auth/ForgotPasswordForm/block.meta.d.ts
402
428
  declare const meta$30: BlockMeta;
403
429
  //#endregion
404
430
  //#region src/auth/MfaChallenge/MfaChallenge.d.ts
405
431
  export type MfaMethod = 'code' | 'backup';
406
- export interface MfaChallengeProps {
432
+ export interface MfaChallengeLabels {
433
+ eyebrow: string;
434
+ title: string;
435
+ backupTitle: string;
436
+ backupDescription: string;
437
+ destinationDescription: (length: number, destination: string) => string;
438
+ description: (length: number) => string;
439
+ formLabel: string;
440
+ codeLabel: string;
441
+ codeRequired: (length: number) => string;
442
+ backupLabel: string;
443
+ backupPlaceholder: string;
444
+ backupHint: string;
445
+ backupRequired: string;
446
+ submit: string;
447
+ useCode: string;
448
+ resendIn: (remaining: number) => string;
449
+ resend: string;
450
+ resent: string;
451
+ backToSignIn: string;
452
+ fallbackError: string;
453
+ }
454
+ export interface MfaChallengeProps extends AuthFieldSizeProps {
455
+ labels?: Partial<MfaChallengeLabels>;
407
456
  /** Verifies the code. A returned promise shows the loading state; a rejection shows in the alert. */
408
457
  onVerify?: (code: string, method: MfaMethod) => void | Promise<void>;
409
458
  /** Sends a new code; the resend button then waits `resendCooldown` seconds. */
@@ -428,13 +477,29 @@ export interface MfaChallengeProps {
428
477
  * Second-factor step: a one-time code (auto-submits when complete), a switch to a backup code,
429
478
  * and a resend button with a countdown.
430
479
  */
431
- export declare function MfaChallenge({ onVerify, onResend, resendCooldown, initialCooldown, length, destination, error: errorProp, loading: loadingProp, onCancel, eyebrow, title, className }: MfaChallengeProps): import("react").JSX.Element;
480
+ export declare function MfaChallenge({ labels, fieldSize, onVerify, onResend, resendCooldown, initialCooldown, length, destination, error: errorProp, loading: loadingProp, onCancel, eyebrow: eyebrowProp, title: titleProp, className }: MfaChallengeProps): import("react").JSX.Element;
432
481
  //#endregion
433
482
  //#region src/auth/MfaChallenge/block.meta.d.ts
434
- declare const meta$42: BlockMeta;
483
+ declare const meta$43: BlockMeta;
435
484
  //#endregion
436
485
  //#region src/auth/ResetPasswordForm/ResetPasswordForm.d.ts
437
- export interface ResetPasswordFormProps {
486
+ export interface ResetPasswordFormLabels {
487
+ eyebrow: string;
488
+ title: string;
489
+ description: (minimum: number) => string;
490
+ newPassword: string;
491
+ confirmPassword: string;
492
+ passwordTooShort: (minimum: number) => string;
493
+ passwordMismatch: string;
494
+ submit: string;
495
+ successTitle: string;
496
+ successDescription: string;
497
+ successStatus: string;
498
+ continue: string;
499
+ fallbackError: string;
500
+ }
501
+ export interface ResetPasswordFormProps extends AuthFieldSizeProps {
502
+ labels?: Partial<ResetPasswordFormLabels>;
438
503
  /** Saves the new password. A returned promise shows the loading state; a rejection shows in the alert. */
439
504
  onSubmit?: (password: string) => void | Promise<void>;
440
505
  error?: string | null;
@@ -445,10 +510,10 @@ export interface ResetPasswordFormProps {
445
510
  className?: string;
446
511
  }
447
512
  /** New password + confirmation with length and mismatch validation, then a success state. */
448
- export declare function ResetPasswordForm({ onSubmit, error: errorProp, minPasswordLength, onContinue, eyebrow, className }: ResetPasswordFormProps): import("react").JSX.Element;
513
+ export declare function ResetPasswordForm({ labels, fieldSize, onSubmit, error: errorProp, minPasswordLength, onContinue, eyebrow: eyebrowProp, className }: ResetPasswordFormProps): import("react").JSX.Element;
449
514
  //#endregion
450
515
  //#region src/auth/ResetPasswordForm/block.meta.d.ts
451
- declare const meta$57: BlockMeta;
516
+ declare const meta$58: BlockMeta;
452
517
  //#endregion
453
518
  //#region src/auth/SignInForm/SignInForm.d.ts
454
519
  export interface SignInValues {
@@ -461,7 +526,25 @@ export interface SignInValues {
461
526
  export interface SignInFormRef {
462
527
  focus(field: 'identifier' | 'password'): void;
463
528
  }
464
- export interface SignInFormProps extends AuthFormAccessibilityProps {
529
+ export interface SignInFormLabels extends Required<AuthValidationMessages> {
530
+ eyebrow: string;
531
+ title: string;
532
+ description: string;
533
+ formLabel: string;
534
+ identifierLabel: string;
535
+ identifierPlaceholder: string;
536
+ password: string;
537
+ forgotPassword: string;
538
+ passwordRequired: string;
539
+ remember: string;
540
+ submit: string;
541
+ divider: string;
542
+ signUpPrompt: string;
543
+ signUp: string;
544
+ fallbackError: string;
545
+ }
546
+ export interface SignInFormProps extends AuthFormAccessibilityProps, AuthFieldSizeProps {
547
+ labels?: Partial<SignInFormLabels>;
465
548
  /** React 19 ref for focus after a server response. */
466
549
  ref?: Ref<SignInFormRef>;
467
550
  identifier?: AuthIdentifierConfig;
@@ -492,10 +575,10 @@ export interface SignInFormProps extends AuthFormAccessibilityProps {
492
575
  className?: string;
493
576
  }
494
577
  /** Email + password sign-in with remember me, forgot-password link, SSO slot, error alert and loading. */
495
- export declare function SignInForm({ identifier, messages, passwordHelp, passwordHelpId, ref, fieldInvalid, feedbackId, 'aria-describedby': describedBy, 'aria-label': ariaLabel, 'aria-labelledby': labelledBy, onSubmit, error: errorProp, loading: loadingProp, defaultEmail, forgotPasswordHref, onForgotPassword, signUpHref, onSignUp, signUpPrompt, sso, eyebrow, title, description, headingLevel, className }: SignInFormProps): import("react").JSX.Element;
578
+ export declare function SignInForm({ labels, fieldSize, identifier, messages, passwordHelp, passwordHelpId, ref, fieldInvalid, feedbackId, 'aria-describedby': describedBy, 'aria-label': ariaLabelProp, 'aria-labelledby': labelledBy, onSubmit, error: errorProp, loading: loadingProp, defaultEmail, forgotPasswordHref, onForgotPassword, signUpHref, onSignUp, signUpPrompt, sso, eyebrow: eyebrowProp, title: titleProp, description: descriptionProp, headingLevel, className }: SignInFormProps): import("react").JSX.Element;
496
579
  //#endregion
497
580
  //#region src/auth/SignInForm/block.meta.d.ts
498
- declare const meta$62: BlockMeta;
581
+ declare const meta$63: BlockMeta;
499
582
  //#endregion
500
583
  //#region src/auth/SignUpForm/SignUpForm.d.ts
501
584
  export interface SignUpValues {
@@ -505,7 +588,31 @@ export interface SignUpValues {
505
588
  /** Present only in configured mode. Text/email values are trimmed and keyed by field id. */
506
589
  fields?: Record<string, string>;
507
590
  }
508
- export interface SignUpFormProps {
591
+ export interface SignUpFormLabels extends AuthSignUpFieldLabels {
592
+ eyebrow: string;
593
+ title: string;
594
+ description: string;
595
+ name: string;
596
+ namePlaceholder: string;
597
+ nameRequired: string;
598
+ email: string;
599
+ emailPlaceholder: string;
600
+ password: string;
601
+ passwordTooShort: (minimum: number) => string;
602
+ termsRequired: string;
603
+ terms: string;
604
+ privacy: string;
605
+ termsConsent: (terms: ReactNode, privacy: ReactNode) => ReactNode;
606
+ submit: string;
607
+ divider: string;
608
+ signInPrompt: string;
609
+ signIn: string;
610
+ policyLoading: string;
611
+ fallbackError: string;
612
+ emailInvalid: string;
613
+ }
614
+ export interface SignUpFormProps extends AuthFieldSizeProps {
615
+ labels?: Partial<SignUpFormLabels>;
509
616
  /** Ordered text/email inputs before Password. Omit to keep the default fields and payload. */
510
617
  fields?: readonly AuthSignUpField[];
511
618
  messages?: AuthSignUpValidationMessages;
@@ -535,10 +642,10 @@ export interface SignUpFormProps {
535
642
  className?: string;
536
643
  }
537
644
  /** Account creation: name, work email, password with a strength meter and a required terms checkbox. */
538
- export declare function SignUpForm({ fields, messages, unavailable, policyLoading, onSubmit, error: errorProp, loading: loadingProp, minPasswordLength, passwordHelp, terms: termsProp, termsHref, privacyHref, signInHref, onSignIn, sso, eyebrow, title, description, className }: SignUpFormProps): import("react").JSX.Element;
645
+ export declare function SignUpForm({ labels, fieldSize, fields, messages, unavailable, policyLoading, onSubmit, error: errorProp, loading: loadingProp, minPasswordLength, passwordHelp, terms: termsProp, termsHref, privacyHref, signInHref, onSignIn, sso, eyebrow: eyebrowProp, title: titleProp, description: descriptionProp, className }: SignUpFormProps): import("react").JSX.Element;
539
646
  //#endregion
540
647
  //#region src/auth/SignUpForm/block.meta.d.ts
541
- declare const meta$63: BlockMeta;
648
+ declare const meta$64: BlockMeta;
542
649
  //#endregion
543
650
  //#region src/auth/SsoButtons/fixtures.d.ts
544
651
  interface SsoProvider {
@@ -551,7 +658,11 @@ interface SsoProvider {
551
658
  export declare const ssoProviders: SsoProvider[];
552
659
  //#endregion
553
660
  //#region src/auth/SsoButtons/SsoButtons.d.ts
661
+ export interface SsoButtonsLabels {
662
+ label: string;
663
+ }
554
664
  export interface SsoButtonsProps {
665
+ labels?: Partial<SsoButtonsLabels>;
555
666
  providers?: SsoProvider[];
556
667
  /** Called with the provider id. */
557
668
  onSelect?: (providerId: string) => void;
@@ -565,10 +676,10 @@ export interface SsoButtonsProps {
565
676
  className?: string;
566
677
  }
567
678
  /** Neutral single-sign-on buttons: text labels and lucide icons, no brand colours or logos. */
568
- export declare function SsoButtons({ providers, onSelect, loadingId, disabled, layout, label, className }: SsoButtonsProps): import("react").JSX.Element;
679
+ export declare function SsoButtons({ labels, providers, onSelect, loadingId, disabled, layout, label: labelProp, className }: SsoButtonsProps): import("react").JSX.Element;
569
680
  //#endregion
570
681
  //#region src/auth/SsoButtons/block.meta.d.ts
571
- declare const meta$66: BlockMeta;
682
+ declare const meta$68: BlockMeta;
572
683
  //#endregion
573
684
  //#region src/billing/format.d.ts
574
685
  /** Shared formatting for the billing blocks (en-US, Intl). */
@@ -637,7 +748,7 @@ export type PlanCardProps = BillingPlanCardProps | PlanSummaryProps;
637
748
  export declare function PlanCard(props: PlanCardProps): import("react").JSX.Element;
638
749
  //#endregion
639
750
  //#region src/billing/PlanCard/block.meta.d.ts
640
- declare const meta$51: BlockMeta;
751
+ declare const meta$52: BlockMeta;
641
752
  //#endregion
642
753
  //#region src/billing/PlanCard/fixtures.d.ts
643
754
  /** Sample current plan (neutral workspace data). */
@@ -668,7 +779,7 @@ export interface PlanDefinitionCardProps {
668
779
  export declare function PlanDefinitionCard({ plan, density, actions, statusLabels, titleAs: TitleTag, className }: PlanDefinitionCardProps): import("react").JSX.Element;
669
780
  //#endregion
670
781
  //#region src/billing/PlanDefinitionCard/block.meta.d.ts
671
- declare const meta$52: BlockMeta;
782
+ declare const meta$53: BlockMeta;
672
783
  //#endregion
673
784
  //#region src/billing/PlanDefinitionCard/fixtures.d.ts
674
785
  export declare const samplePlanDefinition: PlanDefinition;
@@ -705,7 +816,7 @@ export interface QuotaMetersProps {
705
816
  export declare function QuotaMeters({ quotas, title, thresholds, formatValue, defaultScope, onScopeChange, titleAs: TitleTag, className }: QuotaMetersProps): import("react").JSX.Element;
706
817
  //#endregion
707
818
  //#region src/billing/QuotaMeters/block.meta.d.ts
708
- declare const meta$56: BlockMeta;
819
+ declare const meta$57: BlockMeta;
709
820
  //#endregion
710
821
  //#region src/billing/QuotaMeters/fixtures.d.ts
711
822
  /** Sample plan quotas: usage so far this cycle and the end-of-cycle projection. */
@@ -738,7 +849,7 @@ export interface SpendVsBudgetProps {
738
849
  export declare function SpendVsBudget({ data, budget, currency, title, period, height, titleAs: TitleTag, className }: SpendVsBudgetProps): import("react").JSX.Element;
739
850
  //#endregion
740
851
  //#region src/billing/SpendVsBudget/block.meta.d.ts
741
- declare const meta$65: BlockMeta;
852
+ declare const meta$67: BlockMeta;
742
853
  //#endregion
743
854
  //#region src/billing/SpendVsBudget/fixtures.d.ts
744
855
  /**
@@ -813,7 +924,7 @@ export interface PaymentMethodCardProps {
813
924
  export declare function PaymentMethodCard({ method, title, description, onUpdate, onRemove, updateLabel, titleAs, className }: PaymentMethodCardProps): import("react").JSX.Element;
814
925
  //#endregion
815
926
  //#region src/billing/PaymentMethodCard/block.meta.d.ts
816
- declare const meta$49: BlockMeta;
927
+ declare const meta$50: BlockMeta;
817
928
  //#endregion
818
929
  //#region src/billing/PaymentMethodCard/fixtures.d.ts
819
930
  /** Sample default payment method. */
@@ -1069,6 +1180,7 @@ interface LogLine {
1069
1180
  //#region src/builders/LogViewer/LogViewer.d.ts
1070
1181
  export declare const LOG_LEVELS: LogLevel[];
1071
1182
  export interface LogViewerLabels {
1183
+ levels?: Partial<Record<LogLevel, string>>;
1072
1184
  title: string;
1073
1185
  levelFilter: string;
1074
1186
  searchLabel: string;
@@ -1079,6 +1191,7 @@ export interface LogViewerLabels {
1079
1191
  inspect: (timestamp: string) => string;
1080
1192
  copy: (timestamp: string) => string;
1081
1193
  copied: string;
1194
+ copyFailed?: string;
1082
1195
  }
1083
1196
  export interface LogViewerProps {
1084
1197
  /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
@@ -1091,6 +1204,8 @@ export interface LogViewerProps {
1091
1204
  height?: number;
1092
1205
  /** Fixed row height in px (the windowing math relies on it). */
1093
1206
  rowHeight?: number;
1207
+ /** Wrap full messages and measure variable-height rows. Default false; rowHeight estimates unmeasured rows. */
1208
+ wrap?: boolean;
1094
1209
  /** Rows rendered above and below the visible window. */
1095
1210
  overscan?: number;
1096
1211
  /** Levels shown initially. */
@@ -1114,7 +1229,7 @@ export interface LogViewerProps {
1114
1229
  * so it stays fast with thousands of lines. Level filter, search with highlighted matches,
1115
1230
  * follow-tail and per-line copy.
1116
1231
  */
1117
- export declare function LogViewer({ lines, title: titleProp, labels, height, rowHeight, overscan, defaultLevels, defaultFollow, onCopyLine, onSelectLine, selectedLineId, announceLines, titleAs: TitleTag, className }: LogViewerProps): import("react").JSX.Element;
1232
+ export declare function LogViewer({ lines, title: titleProp, labels, height, rowHeight, wrap, overscan, defaultLevels, defaultFollow, onCopyLine, onSelectLine, selectedLineId, announceLines, titleAs: TitleTag, className }: LogViewerProps): import("react").JSX.Element;
1118
1233
  //#endregion
1119
1234
  //#region src/builders/LogViewer/block.meta.d.ts
1120
1235
  declare const meta$40: BlockMeta;
@@ -1162,12 +1277,14 @@ export interface KpiRowProps {
1162
1277
  /** Accessible name of the list. */
1163
1278
  label?: string;
1164
1279
  className?: string;
1280
+ /** Styles the container wrapper, including placement in a parent grid. */
1281
+ containerClassName?: string;
1165
1282
  }
1166
1283
  /**
1167
1284
  * KPI row: label, big number, delta (direction and sentiment are independent) and an optional
1168
1285
  * Sparkline. A description list, so each label is announced with its value.
1169
1286
  */
1170
- export declare function KpiRow({ items, variant, showTrends, label, className }: KpiRowProps): import("react").JSX.Element;
1287
+ export declare function KpiRow({ items, variant, showTrends, label, className, containerClassName }: KpiRowProps): import("react").JSX.Element;
1171
1288
  //#endregion
1172
1289
  //#region src/data-display/KpiRow/block.meta.d.ts
1173
1290
  declare const meta$38: BlockMeta;
@@ -1216,7 +1333,7 @@ export interface StatCardProps {
1216
1333
  export declare function StatCard({ label, icon: IconCmp, ranges, defaultRange, range: rangeProp, onRangeChange, chart, tone, action, titleAs: TitleTag, className }: StatCardProps): import("react").JSX.Element;
1217
1334
  //#endregion
1218
1335
  //#region src/data-display/StatCard/block.meta.d.ts
1219
- declare const meta$67: BlockMeta;
1336
+ declare const meta$69: BlockMeta;
1220
1337
  //#endregion
1221
1338
  //#region src/data-display/StatCard/fixtures.d.ts
1222
1339
  /** Requests per range: the value and delta recalculate when the range changes. */
@@ -1336,6 +1453,7 @@ export interface DescriptionListCardLabels {
1336
1453
  copy: (label: string) => string;
1337
1454
  copied: (label: string) => string;
1338
1455
  copiedToClipboard: string;
1456
+ copyFailed?: string;
1339
1457
  }
1340
1458
  export interface DescriptionListCardProps {
1341
1459
  /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
@@ -1343,6 +1461,10 @@ export interface DescriptionListCardProps {
1343
1461
  title?: string;
1344
1462
  description?: string;
1345
1463
  items?: readonly DescriptionItem[];
1464
+ /** Wrap values, including long unbroken strings, instead of truncating (default false). */
1465
+ wrap?: boolean;
1466
+ /** Responsive columns; items fill top to bottom in contiguous groups (default 1). */
1467
+ columns?: 1 | 2 | 3;
1346
1468
  /** Shows an Edit button in the header. */
1347
1469
  onEdit?: () => void;
1348
1470
  editLabel?: string;
@@ -1353,7 +1475,7 @@ export interface DescriptionListCardProps {
1353
1475
  className?: string;
1354
1476
  }
1355
1477
  /** Key–value detail card: label column, values (mono, status or rich), copy buttons and an Edit action. */
1356
- export declare function DescriptionListCard({ title: titleProp, labels, description: descriptionProp, items, onEdit, editLabel: editLabelProp, onCopy, titleAs, className }: DescriptionListCardProps): import("react").JSX.Element;
1478
+ export declare function DescriptionListCard({ title: titleProp, labels, description: descriptionProp, items, wrap, columns, onEdit, editLabel: editLabelProp, onCopy, titleAs, className }: DescriptionListCardProps): import("react").JSX.Element;
1357
1479
  //#endregion
1358
1480
  //#region src/data-display/DescriptionListCard/block.meta.d.ts
1359
1481
  declare const meta$19: BlockMeta;
@@ -1391,17 +1513,19 @@ export interface ResourceCardGridProps {
1391
1513
  onAction?: (action: ResourceAction, item: ResourceCard) => void;
1392
1514
  /** Replaces the default menu entirely. Return an empty array to hide the menu. */
1393
1515
  getActions?: (item: ResourceCard) => Array<MoreMenuAction | 'separator'>;
1394
- /** Columns at the widest breakpoint. */
1516
+ /** Maximum columns, chosen from this block's container width. */
1395
1517
  columns?: 2 | 3 | 4;
1396
1518
  /** Heading level of each card's name, to fit the page outline (default h3). */
1397
1519
  titleAs?: 'h2' | 'h3' | 'h4';
1398
1520
  className?: string;
1521
+ /** Styles the container wrapper, including placement in a parent grid. */
1522
+ containerClassName?: string;
1399
1523
  }
1400
1524
  /** Responsive grid of resource cards: icon or avatar, name, status, meta figures and a row-actions MoreMenu. */
1401
- export declare function ResourceCardGrid({ items, label, onAction, getActions, columns, titleAs: TitleTag, className }: ResourceCardGridProps): import("react").JSX.Element;
1525
+ export declare function ResourceCardGrid({ items, label, onAction, getActions, columns, titleAs: TitleTag, className, containerClassName }: ResourceCardGridProps): import("react").JSX.Element;
1402
1526
  //#endregion
1403
1527
  //#region src/data-display/ResourceCardGrid/block.meta.d.ts
1404
- declare const meta$58: BlockMeta;
1528
+ declare const meta$59: BlockMeta;
1405
1529
  //#endregion
1406
1530
  //#region src/data-display/ResourceCardGrid/fixtures.d.ts
1407
1531
  /** Project resources. */
@@ -1444,7 +1568,7 @@ export interface StatusTimelineProps {
1444
1568
  export declare function StatusTimeline({ events, label: labelProp, emptyLabel: emptyLabelProp, showFewerLabel: showFewerLabelProp, showEarlierLabel: showEarlierLabelProp, actorLabel: actorLabelProp, maxVisible, timeFormat, className }: StatusTimelineProps): import("react").JSX.Element;
1445
1569
  //#endregion
1446
1570
  //#region src/data-display/StatusTimeline/block.meta.d.ts
1447
- declare const meta$68: BlockMeta;
1571
+ declare const meta$70: BlockMeta;
1448
1572
  //#endregion
1449
1573
  //#region src/data-display/StatusTimeline/fixtures.d.ts
1450
1574
  /** State changes of a deployment, newest first. */
@@ -1503,12 +1627,18 @@ export interface CommentAuthor {
1503
1627
  export interface ThreadComment {
1504
1628
  id: string;
1505
1629
  author: CommentAuthor;
1506
- /** Plain text (no markdown); line breaks are kept. */
1630
+ /** Plain text by default, with line breaks kept; pass renderBody to render Markdown. */
1507
1631
  body: string;
1508
1632
  at: DateInput;
1509
1633
  }
1510
1634
  export interface CommentThreadProps {
1511
1635
  comments?: readonly ThreadComment[];
1636
+ /**
1637
+ * Render the raw comment in a block container. Bodies are untrusted: use a safe
1638
+ * renderer such as Markdown from @gntik-ai/chat (without allowHtml), never raw HTML.
1639
+ * Defaults to plain text with line breaks kept.
1640
+ */
1641
+ renderBody?: (comment: ThreadComment) => ReactNode;
1512
1642
  /** Author of new comments (the signed-in user). */
1513
1643
  currentUser?: CommentAuthor;
1514
1644
  /** Called with the trimmed text when a comment is posted. */
@@ -1519,10 +1649,12 @@ export interface CommentThreadProps {
1519
1649
  label?: string;
1520
1650
  placeholder?: string;
1521
1651
  submitLabel?: string;
1652
+ /** Overrides the plain-text or Markdown hint; stays the composer's accessible description. */
1653
+ composerHint?: ReactNode;
1522
1654
  className?: string;
1523
1655
  }
1524
- /** Comment thread: avatar, author, plain-text body and Timestamp, with a reply composer (⌘/Ctrl+Enter posts). */
1525
- export declare function CommentThread({ comments, currentUser, onSubmit, appendOnSubmit, label: labelProp, placeholder: placeholderProp, submitLabel: submitLabelProp, className }: CommentThreadProps): import("react").JSX.Element;
1656
+ /** Comment thread: avatar, author, plain text (or Markdown via renderBody) and Timestamp, with a reply composer (⌘/Ctrl+Enter posts). */
1657
+ export declare function CommentThread({ comments, renderBody, currentUser, onSubmit, appendOnSubmit, label: labelProp, placeholder: placeholderProp, submitLabel: submitLabelProp, composerHint, className }: CommentThreadProps): import("react").JSX.Element;
1526
1658
  //#endregion
1527
1659
  //#region src/data-display/CommentThread/block.meta.d.ts
1528
1660
  declare const meta$9: BlockMeta;
@@ -1567,7 +1699,7 @@ export interface SystemBannerProps {
1567
1699
  export declare function SystemBanner({ kind, title, message, action, dismissible, open, onDismiss, className }: SystemBannerProps): import("react").JSX.Element | null;
1568
1700
  //#endregion
1569
1701
  //#region src/feedback/SystemBanner/block.meta.d.ts
1570
- declare const meta$71: BlockMeta;
1702
+ declare const meta$73: BlockMeta;
1571
1703
  //#endregion
1572
1704
  //#region src/feedback/InlineCallout/InlineCallout.d.ts
1573
1705
  export interface InlineCalloutLabels {
@@ -1626,7 +1758,8 @@ export interface FirstRunEmptyProps extends SharedEmptyProps {
1626
1758
  icon?: LucideIcon;
1627
1759
  title?: ReactNode;
1628
1760
  description?: ReactNode;
1629
- actionLabel?: string;
1761
+ /** Omit to use labels.action or the localized default. `null` or "" hides the action; onAction is ignored. */
1762
+ actionLabel?: string | null;
1630
1763
  onAction?: () => void;
1631
1764
  /** Secondary link (docs, guide). `null` hides it. */
1632
1765
  secondary?: {
@@ -1676,11 +1809,18 @@ export interface NoAccessEmptyProps extends SharedEmptyProps {
1676
1809
  owner?: string;
1677
1810
  /** Called on "Request access"; may return a promise (the button shows a spinner). */
1678
1811
  onRequestAccess?: () => void | Promise<void>;
1812
+ /** Show the request button and its status announcement (default true). */
1813
+ showRequestAccess?: boolean;
1814
+ /** One href link; secondary to the request button, or primary when the button is hidden. */
1815
+ action?: {
1816
+ label: string;
1817
+ href: string;
1818
+ };
1679
1819
  /** Start in the "requested" state (e.g. a pending request exists). */
1680
1820
  defaultRequested?: boolean;
1681
1821
  }
1682
1822
  /** Permission state: the viewer lacks access; explains who can grant it and lets them ask. */
1683
- export declare function NoAccessEmpty({ resource, labels, owner, onRequestAccess, defaultRequested, titleAs, bordered, className }: NoAccessEmptyProps): import("react").JSX.Element;
1823
+ export declare function NoAccessEmpty({ resource, labels, owner, onRequestAccess, showRequestAccess, action, defaultRequested, titleAs, bordered, className }: NoAccessEmptyProps): import("react").JSX.Element;
1684
1824
  //#endregion
1685
1825
  //#region src/feedback/EmptyStates/fixtures.d.ts
1686
1826
  /** Neutral sample copy for the empty states. */
@@ -1731,7 +1871,7 @@ export interface PageSkeletonProps {
1731
1871
  export declare function PageSkeleton({ stats, rows, label: labelProp, className }: PageSkeletonProps): import("react").JSX.Element;
1732
1872
  //#endregion
1733
1873
  //#region src/feedback/Skeletons/block.meta.d.ts
1734
- declare const meta$64: BlockMeta;
1874
+ declare const meta$66: BlockMeta;
1735
1875
  //#endregion
1736
1876
  //#region src/feedback/ConfirmDestructive/ConfirmDestructive.d.ts
1737
1877
  export type ConfirmDestructiveFailure = {
@@ -1828,6 +1968,27 @@ export declare function ErrorPanel({ icon: Icon, title: titleProp, labels, messa
1828
1968
  //#region src/feedback/ErrorPanel/block.meta.d.ts
1829
1969
  declare const meta$23: BlockMeta;
1830
1970
  //#endregion
1971
+ //#region src/forms/DangerZone/ConfirmDestructiveDialog.d.ts
1972
+ interface ConfirmDestructiveDialogLabels {
1973
+ confirmPrompt: (text: ReactNode) => ReactNode;
1974
+ cancel: string;
1975
+ fallbackError: string;
1976
+ }
1977
+ interface ConfirmDestructiveDialogProps {
1978
+ labels?: Partial<ConfirmDestructiveDialogLabels>;
1979
+ open: boolean;
1980
+ onOpenChange: (open: boolean) => void;
1981
+ title: ReactNode;
1982
+ description: ReactNode;
1983
+ /** Text that must be typed exactly to enable the confirming button. */
1984
+ confirmText?: string;
1985
+ confirmLabel: string;
1986
+ /** Runs on confirm; a returned promise shows a loading state and keeps the dialog open until it settles. */
1987
+ onConfirm?: () => void | Promise<void>;
1988
+ }
1989
+ /** Destructive confirmation (alertdialog) that can require typing the resource name first. */
1990
+ export declare function ConfirmDestructiveDialog({ labels, open, onOpenChange, title, description, confirmText, confirmLabel, onConfirm }: ConfirmDestructiveDialogProps): import("react").JSX.Element;
1991
+ //#endregion
1831
1992
  //#region src/forms/DangerZone/fixtures.d.ts
1832
1993
  interface DangerZoneAction {
1833
1994
  id: string;
@@ -1843,7 +2004,13 @@ interface DangerZoneAction {
1843
2004
  export declare const dangerZoneActions: DangerZoneAction[];
1844
2005
  //#endregion
1845
2006
  //#region src/forms/DangerZone/DangerZone.d.ts
2007
+ export interface DangerZoneLabels extends ConfirmDestructiveDialogLabels {
2008
+ title: string;
2009
+ description: string;
2010
+ confirmationTitle: (title: string) => string;
2011
+ }
1846
2012
  export interface DangerZoneProps {
2013
+ labels?: Partial<DangerZoneLabels>;
1847
2014
  title?: ReactNode;
1848
2015
  description?: ReactNode;
1849
2016
  actions?: DangerZoneAction[];
@@ -1856,7 +2023,7 @@ export interface DangerZoneProps {
1856
2023
  * Bordered destructive section. Each action opens a confirmation dialog; actions with
1857
2024
  * `confirmText` require typing it (e.g. the project name) before the confirm button enables.
1858
2025
  */
1859
- export declare function DangerZone({ title, description, actions, onConfirm, headingLevel: Heading, className }: DangerZoneProps): import("react").JSX.Element;
2026
+ export declare function DangerZone({ labels, title: titleProp, description: descriptionProp, actions, onConfirm, headingLevel: Heading, className }: DangerZoneProps): import("react").JSX.Element;
1860
2027
  //#endregion
1861
2028
  //#region src/forms/DangerZone/block.meta.d.ts
1862
2029
  declare const meta$16: BlockMeta;
@@ -1882,7 +2049,28 @@ export interface CreateApiKeyInput {
1882
2049
  scopes: string[];
1883
2050
  expiry: string;
1884
2051
  }
2052
+ export interface CreateApiKeyDialogLabels {
2053
+ title: string;
2054
+ description: string;
2055
+ name: string;
2056
+ namePlaceholder: string;
2057
+ nameRequired: string;
2058
+ scopes: string;
2059
+ scopesRequired: string;
2060
+ expiration: string;
2061
+ errorTitle: string;
2062
+ fallbackError: string;
2063
+ cancel: string;
2064
+ submit: string;
2065
+ successTitle: string;
2066
+ successDescription: string;
2067
+ warningTitle: string;
2068
+ warningDescription: string;
2069
+ secretLabel: string;
2070
+ done: string;
2071
+ }
1885
2072
  export interface CreateApiKeyDialogProps {
2073
+ labels?: Partial<CreateApiKeyDialogLabels>;
1886
2074
  scopes?: ApiKeyScope[];
1887
2075
  expiries?: ApiKeyExpiry[];
1888
2076
  defaultExpiry?: string;
@@ -1898,7 +2086,7 @@ export interface CreateApiKeyDialogProps {
1898
2086
  * Two-step API key dialog: name, scopes and expiry, then the secret shown once in a CodeBlock
1899
2087
  * with copy. Closing the dialog discards the secret; it can't be shown again.
1900
2088
  */
1901
- export declare function CreateApiKeyDialog({ scopes, expiries, defaultExpiry, onCreate, open: openProp, defaultOpen, onOpenChange, trigger }: CreateApiKeyDialogProps): import("react").JSX.Element;
2089
+ export declare function CreateApiKeyDialog({ labels, scopes, expiries, defaultExpiry, onCreate, open, defaultOpen, onOpenChange, trigger }: CreateApiKeyDialogProps): import("react").JSX.Element;
1902
2090
  //#endregion
1903
2091
  //#region src/forms/CreateApiKeyDialog/block.meta.d.ts
1904
2092
  declare const meta$13: BlockMeta;
@@ -1918,7 +2106,25 @@ export interface CredentialDisclosure {
1918
2106
  expiresAt: ReactNode;
1919
2107
  secret: string;
1920
2108
  }
2109
+ export interface CredentialDisclosureDialogLabels {
2110
+ title: string;
2111
+ description: string;
2112
+ credentialIdLabel: string;
2113
+ expiryLabel: string;
2114
+ secretLabel: string;
2115
+ showLabel: string;
2116
+ hideLabel: string;
2117
+ copyLabel: string;
2118
+ copiedLabel: string;
2119
+ successAnnouncement: string;
2120
+ failureAnnouncement: string;
2121
+ warningTitle: string;
2122
+ warningText: string;
2123
+ closeLabel: string;
2124
+ copiedAnnouncementFor: (label: string, copied: string) => string;
2125
+ }
1921
2126
  export interface CredentialDisclosureDialogProps {
2127
+ labels?: Partial<CredentialDisclosureDialogLabels>;
1922
2128
  /** Additional masked values; ids must be unique, non-empty and not "secret". */
1923
2129
  additionalSecrets?: readonly CredentialSecret[];
1924
2130
  /** Mask a fresh primary secret; read at the start of each session. */
@@ -1966,7 +2172,13 @@ export declare function CredentialDisclosureDialog(props: CredentialDisclosureDi
1966
2172
  declare const meta$14: BlockMeta;
1967
2173
  //#endregion
1968
2174
  //#region src/forms/DateRangeFilter/DateRangeFilter.d.ts
2175
+ export interface DateRangeFilterLabels {
2176
+ label: string;
2177
+ placeholder: string;
2178
+ clear: (label: string) => string;
2179
+ }
1969
2180
  export interface DateRangeFilterProps {
2181
+ labels?: Partial<DateRangeFilterLabels>;
1970
2182
  value?: DateRange;
1971
2183
  /** Initial range; defaults to the "Last 7 days" preset. Pass `{ start: null, end: null }` for none. */
1972
2184
  defaultValue?: DateRange;
@@ -1984,15 +2196,17 @@ export interface DateRangeFilterProps {
1984
2196
  className?: string;
1985
2197
  }
1986
2198
  /** Compact DateRangePicker for toolbars: small trigger, short dates, presets and a clear button. */
1987
- export declare function DateRangeFilter({ value, defaultValue, onValueChange, presets, today, label: labelProp, placeholder: placeholderProp, clearable, disabled, className }: DateRangeFilterProps): import("react").JSX.Element;
2199
+ export declare function DateRangeFilter({ labels, value, defaultValue, onValueChange, presets, today, label: labelProp, placeholder: placeholderProp, clearable, disabled, className }: DateRangeFilterProps): import("react").JSX.Element;
1988
2200
  //#endregion
1989
2201
  //#region src/forms/DateRangeFilter/block.meta.d.ts
1990
2202
  declare const meta$18: BlockMeta;
1991
2203
  //#endregion
1992
2204
  //#region src/forms/FileUploadPanel/fixtures.d.ts
1993
- type UploadStatus = 'uploading' | 'done' | 'error';
2205
+ type UploadStatus = 'pending' | 'uploading' | 'done' | 'error';
1994
2206
  interface UploadItem {
1995
2207
  id: string;
2208
+ /** Picked source file, absent for previously uploaded items. */
2209
+ file?: File;
1996
2210
  name: string;
1997
2211
  /** Size in bytes. */
1998
2212
  size: number;
@@ -2004,10 +2218,42 @@ interface UploadItem {
2004
2218
  }
2005
2219
  export declare const uploadItems: UploadItem[];
2006
2220
  /** Demo uploader: reports progress in steps and resolves after ~1.5 s. */
2007
- export declare function simulateUpload(_file: File, onProgress: (pct: number) => void): Promise<void>;
2221
+ export declare function simulateUpload(_file: File, onProgress: (pct: number) => void, context?: {
2222
+ signal: AbortSignal;
2223
+ id: string;
2224
+ }): Promise<void>;
2008
2225
  //#endregion
2009
2226
  //#region src/forms/FileUploadPanel/FileUploadPanel.d.ts
2227
+ export interface FileUploadPanelLabels {
2228
+ label: string;
2229
+ drop: string;
2230
+ browse: string;
2231
+ files: string;
2232
+ failed: string;
2233
+ typeRejected: string;
2234
+ hint: (types: string, size: string) => string;
2235
+ tooLarge: (size: string) => string;
2236
+ done: (name: string) => string;
2237
+ error: (name: string) => string;
2238
+ added: (count: number) => string;
2239
+ rejected: (count: number) => string;
2240
+ removed: (name: string) => string;
2241
+ uploading: (name: string) => string;
2242
+ notUploaded: (error: string) => string;
2243
+ uploaded: (size: string) => string;
2244
+ retry: (name: string) => string;
2245
+ remove: (name: string) => string;
2246
+ ready?: (size: string) => string;
2247
+ cancel?: (name: string) => string;
2248
+ cancelled?: (name: string) => string;
2249
+ removeFailed?: (name: string) => string;
2250
+ }
2251
+ export interface UploadChange {
2252
+ reason: 'add' | 'progress' | 'done' | 'error' | 'remove' | 'cancel';
2253
+ ids: string[];
2254
+ }
2010
2255
  export interface FileUploadPanelProps {
2256
+ labels?: Partial<FileUploadPanelLabels>;
2011
2257
  /** Accepted types, as for `<input accept>` (".csv,.json", "image/*"). */
2012
2258
  accept?: string;
2013
2259
  /** Maximum size per file in bytes. */
@@ -2015,9 +2261,20 @@ export interface FileUploadPanelProps {
2015
2261
  multiple?: boolean;
2016
2262
  /** Initial list (e.g. files already uploaded). */
2017
2263
  defaultFiles?: UploadItem[];
2264
+ /** Controlled list; changes are requested through onFilesChange. */
2265
+ files?: UploadItem[];
2266
+ onFilesChange?: (files: UploadItem[], change: UploadChange) => void;
2267
+ /** Manual mode retains File objects for a later form submission. */
2268
+ uploadMode?: 'auto' | 'manual';
2269
+ /** Runs after built-in validation. False drops, a File replaces, and rejection adds a non-retryable error. */
2270
+ beforeUpload?: (file: File) => boolean | File | void | Promise<boolean | File | void>;
2018
2271
  /** Uploads one file and reports progress (0–100). Defaults to a demo simulation. */
2019
- onUpload?: (file: File, onProgress: (pct: number) => void) => Promise<void>;
2020
- onRemove?: (item: UploadItem) => void;
2272
+ onUpload?: (file: File, onProgress: (pct: number) => void, context: {
2273
+ signal: AbortSignal;
2274
+ id: string;
2275
+ }) => Promise<void>;
2276
+ /** Called before removal; false or rejection keeps the row. */
2277
+ onRemove?: (item: UploadItem) => void | boolean | Promise<void | boolean>;
2021
2278
  /** Visible label of the panel. */
2022
2279
  label?: string;
2023
2280
  /** Hint under the drop text; defaults to the accepted types and size limit. */
@@ -2029,13 +2286,18 @@ export interface FileUploadPanelProps {
2029
2286
  * Drop zone with a Browse button, accept and size validation, and a file list with progress,
2030
2287
  * retry and remove. Rejected files stay in the list with the reason.
2031
2288
  */
2032
- export declare function FileUploadPanel({ accept, maxSize, multiple, defaultFiles, onUpload, onRemove, label: labelProp, hint, disabled, className }: FileUploadPanelProps): import("react").JSX.Element;
2289
+ export declare function FileUploadPanel({ labels, accept, maxSize, multiple, defaultFiles, files, onFilesChange, uploadMode, beforeUpload, onUpload, onRemove, label: labelProp, hint, disabled, className }: FileUploadPanelProps): import("react").JSX.Element;
2033
2290
  //#endregion
2034
2291
  //#region src/forms/FileUploadPanel/block.meta.d.ts
2035
2292
  declare const meta$27: BlockMeta;
2036
2293
  //#endregion
2037
2294
  //#region src/forms/FormSection/FormSection.d.ts
2295
+ export interface FormSectionLabels {
2296
+ title: string;
2297
+ description: string;
2298
+ }
2038
2299
  export interface FormSectionProps extends Omit<HTMLAttributes<HTMLElement>, 'title' | 'className'> {
2300
+ labels?: Partial<FormSectionLabels>;
2039
2301
  /** Section title shown in the left column; also names the section landmark. */
2040
2302
  title?: ReactNode;
2041
2303
  /** Help text under the title. */
@@ -2052,9 +2314,9 @@ export interface FormSectionProps extends Omit<HTMLAttributes<HTMLElement>, 'tit
2052
2314
  }
2053
2315
  /**
2054
2316
  * Two-column form section: title and help on the left, fields on the right. Stacks into a
2055
- * single column on small screens.
2317
+ * single column in narrow containers.
2056
2318
  */
2057
- export declare function FormSection({ title, description, children, actions, headingLevel: Heading, divided, className, ...props }: FormSectionProps): import("react").JSX.Element;
2319
+ export declare function FormSection({ labels, title: titleProp, description: descriptionProp, children, actions, headingLevel: Heading, divided, className, ...props }: FormSectionProps): import("react").JSX.Element;
2058
2320
  //#endregion
2059
2321
  //#region src/forms/FormSection/block.meta.d.ts
2060
2322
  declare const meta$31: BlockMeta;
@@ -2073,7 +2335,26 @@ export interface InvitePayload {
2073
2335
  role: string;
2074
2336
  message: string;
2075
2337
  }
2338
+ export interface InviteMembersDialogLabels {
2339
+ title: string;
2340
+ description: string;
2341
+ emails: string;
2342
+ placeholder: string;
2343
+ listLabel: string;
2344
+ role: string;
2345
+ message: string;
2346
+ messagePlaceholder: string;
2347
+ emailRequired: string;
2348
+ emailInvalid: (email: string) => string;
2349
+ fixInvalid: (count: number) => string;
2350
+ errorTitle: string;
2351
+ fallbackError: string;
2352
+ cancel: string;
2353
+ submit: string;
2354
+ submitMany: (count: number) => string;
2355
+ }
2076
2356
  export interface InviteMembersDialogProps {
2357
+ labels?: Partial<InviteMembersDialogLabels>;
2077
2358
  roles?: RoleOption[];
2078
2359
  defaultRole?: string;
2079
2360
  /** Sends the invitations. A returned promise shows a loading state; a rejection shows its message. */
@@ -2089,7 +2370,7 @@ export interface InviteMembersDialogProps {
2089
2370
  description?: string;
2090
2371
  }
2091
2372
  /** Invite dialog: email chips with validation, a role and an optional message; submit with loading. */
2092
- export declare function InviteMembersDialog({ roles, defaultRole, onInvite, maxInvites, open: openProp, defaultOpen, onOpenChange, trigger, title, description }: InviteMembersDialogProps): import("react").JSX.Element;
2373
+ export declare function InviteMembersDialog({ labels, roles, defaultRole, onInvite, maxInvites, open, defaultOpen, onOpenChange, trigger, title: titleProp, description: descriptionProp }: InviteMembersDialogProps): import("react").JSX.Element;
2093
2374
  //#endregion
2094
2375
  //#region src/forms/InviteMembersDialog/block.meta.d.ts
2095
2376
  declare const meta$36: BlockMeta;
@@ -2101,7 +2382,12 @@ export interface SettingsRowControlIds {
2101
2382
  /** Id of the description element (when there is one): pass it as `aria-describedby`. */
2102
2383
  descriptionId: string | undefined;
2103
2384
  }
2385
+ export interface SettingsRowLabels {
2386
+ label: string;
2387
+ description: string;
2388
+ }
2104
2389
  export interface SettingsRowProps {
2390
+ labels?: Partial<SettingsRowLabels>;
2105
2391
  label?: ReactNode;
2106
2392
  description?: ReactNode;
2107
2393
  /**
@@ -2118,10 +2404,10 @@ export interface SettingsRowProps {
2118
2404
  className?: string;
2119
2405
  }
2120
2406
  /** One setting: label and description on the left, its control (a Switch by default) on the right. */
2121
- export declare function SettingsRow({ label, description, control, checked, defaultChecked, onCheckedChange, disabled, children, className }: SettingsRowProps): import("react").JSX.Element;
2407
+ export declare function SettingsRow({ labels, label: labelProp, description: descriptionProp, control, checked, defaultChecked, onCheckedChange, disabled, children, className }: SettingsRowProps): import("react").JSX.Element;
2122
2408
  //#endregion
2123
2409
  //#region src/forms/SettingsRow/block.meta.d.ts
2124
- declare const meta$61: BlockMeta;
2410
+ declare const meta$62: BlockMeta;
2125
2411
  //#endregion
2126
2412
  //#region src/forms/ValidationSummary/fixtures.d.ts
2127
2413
  interface ValidationIssue {
@@ -2134,7 +2420,11 @@ interface ValidationIssue {
2134
2420
  declare const validationIssues$1: ValidationIssue[];
2135
2421
  //#endregion
2136
2422
  //#region src/forms/ValidationSummary/ValidationSummary.d.ts
2423
+ export interface ValidationSummaryLabels {
2424
+ title: (count: number) => string;
2425
+ }
2137
2426
  export interface ValidationSummaryProps {
2427
+ labels?: Partial<ValidationSummaryLabels>;
2138
2428
  errors?: ValidationIssue[];
2139
2429
  /** Increment on every submit attempt: the summary takes focus when there are errors. */
2140
2430
  submitCount?: number;
@@ -2146,10 +2436,16 @@ export interface ValidationSummaryProps {
2146
2436
  * Error summary for long forms: lists every problem with a link that moves focus to the field.
2147
2437
  * After a failed submit it takes focus, so screen readers announce it.
2148
2438
  */
2149
- export declare function ValidationSummary({ errors, submitCount, title, className }: ValidationSummaryProps): import("react").JSX.Element | null;
2439
+ export declare function ValidationSummary({ labels, errors, submitCount, title, className }: ValidationSummaryProps): import("react").JSX.Element | null;
2150
2440
  //#endregion
2151
2441
  //#region src/forms/DialogWizard/DialogWizard.d.ts
2442
+ export interface DialogWizardLabels {
2443
+ title: string;
2444
+ details: string;
2445
+ review: string;
2446
+ }
2152
2447
  export interface DialogWizardProps extends Omit<WizardLayoutProps, 'mode' | 'steps' | 'current'> {
2448
+ labels?: Partial<DialogWizardLabels>;
2153
2449
  steps?: WizardLayoutProps['steps'];
2154
2450
  current?: number;
2155
2451
  /** Step-local validation surface, normally a ValidationSummary with consumer copy. */
@@ -2158,7 +2454,7 @@ export interface DialogWizardProps extends Omit<WizardLayoutProps, 'mode' | 'ste
2158
2454
  reviewStep?: ReactNode;
2159
2455
  }
2160
2456
  /** Modal variant of create-wizard for a flow over its parent page. State stays consumer-owned. */
2161
- export declare function DialogWizard({ steps, current, size, stepError, reviewStep, children, title, ...props }: DialogWizardProps): import("react").JSX.Element;
2457
+ export declare function DialogWizard({ labels, steps, current, size, stepError, reviewStep, children, title, ...props }: DialogWizardProps): import("react").JSX.Element;
2162
2458
  //#endregion
2163
2459
  //#region src/forms/DialogWizard/block.meta.d.ts
2164
2460
  declare const meta$20: BlockMeta;
@@ -2191,1233 +2487,1507 @@ export declare const dialogWizardCopy: {
2191
2487
  };
2192
2488
  //#endregion
2193
2489
  //#region src/forms/ValidationSummary/block.meta.d.ts
2194
- declare const meta$76: BlockMeta;
2195
- //#endregion
2196
- //#region src/forms/DangerZone/ConfirmDestructiveDialog.d.ts
2197
- interface ConfirmDestructiveDialogProps {
2198
- open: boolean;
2199
- onOpenChange: (open: boolean) => void;
2200
- title: ReactNode;
2201
- description: ReactNode;
2202
- /** Text that must be typed exactly to enable the confirming button. */
2203
- confirmText?: string;
2204
- confirmLabel: string;
2205
- /** Runs on confirm; a returned promise shows a loading state and keeps the dialog open until it settles. */
2206
- onConfirm?: () => void | Promise<void>;
2207
- }
2208
- /** Destructive confirmation (alertdialog) that can require typing the resource name first. */
2209
- export declare function ConfirmDestructiveDialog({ open, onOpenChange, title, description, confirmText, confirmLabel, onConfirm }: ConfirmDestructiveDialogProps): import("react").JSX.Element;
2210
- //#endregion
2211
- //#region src/marketing/actions.d.ts
2212
- type IconComponent = ComponentType<{
2213
- size?: number;
2214
- 'aria-hidden'?: boolean;
2215
- }>;
2216
- /** A call to action: a link when `href` is set, otherwise a button. */
2217
- interface MarketingAction {
2218
- label: string;
2219
- href?: string;
2220
- onClick?: () => void;
2221
- /** Trailing icon (lucide component). */
2222
- icon?: IconComponent;
2223
- }
2490
+ declare const meta$78: BlockMeta;
2224
2491
  //#endregion
2225
- //#region src/marketing/Hero/Hero.d.ts
2226
- export interface HeroProps {
2227
- /** `centered` (copy over the media) or `split` (copy left, media right from `lg`). */
2228
- variant?: 'centered' | 'split';
2229
- /** Small label above the title. */
2230
- eyebrow?: ReactNode;
2231
- title?: ReactNode;
2232
- description?: ReactNode;
2233
- primaryAction?: MarketingAction | null;
2234
- secondaryAction?: MarketingAction | null;
2235
- /** Screenshot slot. Defaults to a neutral app-window placeholder; null hides it. */
2236
- media?: ReactNode;
2237
- /** Heading level of the title. */
2238
- headingLevel?: 'h1' | 'h2';
2239
- className?: string;
2240
- }
2241
- /** Neutral app-window placeholder for the screenshot slot (decorative). */
2242
- export declare function HeroScreenshotPlaceholder({ className }: {
2492
+ //#region src/tables/DataTable/data-table-utils.d.ts
2493
+ export type SortDirectionValue = 'ascending' | 'descending';
2494
+ /** Include lists selected ids; exclude selects every match except the listed ids. */
2495
+ export type DataTableSelectionModel = {
2496
+ type: 'include';
2497
+ ids: string[];
2498
+ } | {
2499
+ type: 'exclude';
2500
+ ids: string[];
2501
+ };
2502
+ export type CellValue = string | number | boolean | Date | null | undefined;
2503
+ export type DataTableColumnVariant = 'default' | 'mono' | 'muted' | 'numeric';
2504
+ /** Body-cell classes of each column variant. */
2505
+ export declare const COLUMN_VARIANT_CLASSES: Record<DataTableColumnVariant, string>;
2506
+ /** Effective alignment of a column (numeric columns default to right). */
2507
+ export declare function columnAlign<T>(column: DataTableColumn<T>): DataTableColumn<T>['align'];
2508
+ /** One typed column of a DataTable. */
2509
+ export interface DataTableColumn<T> {
2510
+ /** Stable key (sorting, visibility). */
2511
+ id: string;
2512
+ /** Header text; also the column's name in the visibility menu. */
2513
+ header: string;
2514
+ /** Raw value: used to sort, and rendered when `cell` is absent. */
2515
+ accessor?: (row: T) => CellValue;
2516
+ /** Raw CSV/clipboard value; nullish results fall back to the accessor. */
2517
+ exportValue?: (row: T) => CellValue;
2518
+ /** Include in CSV/clipboard output (default true). Hidden columns are always omitted. */
2519
+ exportable?: boolean;
2520
+ /** Custom cell rendering. */
2521
+ cell?: (row: T) => ReactNode;
2522
+ sortable?: boolean;
2523
+ align?: 'left' | 'right' | 'center';
2524
+ /** Can be hidden from the column menu (default true). */
2525
+ hideable?: boolean;
2526
+ /** Hidden until turned on in the column menu. */
2527
+ defaultHidden?: boolean;
2528
+ /**
2529
+ * Presentational preset for the body cells: `mono` (monospace ids, regions), `muted`
2530
+ * (secondary text), `numeric` (monospace tabular figures, right-aligned unless `align` is set).
2531
+ */
2532
+ variant?: DataTableColumnVariant;
2533
+ /** Classes for the body cells (merged after the variant's). */
2243
2534
  className?: string;
2244
- }): import("react").JSX.Element;
2245
- /** Landing hero: eyebrow, title, description, two calls to action and a screenshot slot. */
2246
- export declare function Hero({ variant, eyebrow, title, description, primaryAction, secondaryAction, media, headingLevel: Heading, className }: HeroProps): import("react").JSX.Element;
2247
- //#endregion
2248
- //#region src/marketing/Hero/block.meta.d.ts
2249
- declare const meta$33: BlockMeta;
2250
- //#endregion
2251
- //#region src/marketing/FeatureGrid/FeatureGrid.d.ts
2252
- export interface Feature {
2253
- icon: LucideIcon;
2254
- title: string;
2255
- description: ReactNode;
2535
+ /** Classes for the header cell (e.g. a width). */
2536
+ headClassName?: string;
2537
+ /** Initial width in px (resizable or pinned tables; default 160). */
2538
+ width?: number;
2539
+ /** Smallest width a resize can reach (default 60). */
2540
+ minWidth?: number;
2541
+ /** Largest width a resize can reach (default 640). */
2542
+ maxWidth?: number;
2543
+ /** Shows a resize handle when the table is `resizable` (default true). */
2544
+ resizable?: boolean;
2545
+ /** Can be pinned from the column menu (default true). */
2546
+ pinnable?: boolean;
2547
+ /** Inline editing: Enter or F2 on the cell edits it (needs `onCellEdit` on the table). */
2548
+ editable?: boolean | ((row: T) => boolean);
2549
+ /** Editor of an editable cell (default a text input). */
2550
+ editor?: DataTableCellEditor;
2551
+ /** Value the editor starts from (default the accessor's value). */
2552
+ editValue?: (row: T) => string | number | null | undefined;
2256
2553
  }
2257
- export interface FeatureGridProps {
2258
- features?: Feature[];
2259
- eyebrow?: ReactNode;
2260
- title?: ReactNode;
2261
- description?: ReactNode;
2262
- /** Columns from `lg` (one column on phones, two on tablets). */
2263
- columns?: 2 | 3 | 4;
2264
- /** Heading level of the section title; feature titles use the next level. */
2265
- headingLevel?: 'h2' | 'h3';
2266
- className?: string;
2554
+ /** Editor of an editable column. */
2555
+ export type DataTableCellEditor = {
2556
+ type: 'text';
2557
+ placeholder?: string;
2558
+ } | {
2559
+ type: 'number';
2560
+ min?: number;
2561
+ max?: number;
2562
+ step?: number;
2563
+ } | {
2564
+ type: 'select';
2565
+ options: ReadonlyArray<{
2566
+ value: string;
2567
+ label: string;
2568
+ }>;
2569
+ };
2570
+ export interface SortState {
2571
+ columnId: string;
2572
+ direction: SortDirectionValue;
2267
2573
  }
2268
- /** Features section: a heading block over a grid of icon + title + description. */
2269
- export declare function FeatureGrid({ features, eyebrow, title, description, columns, headingLevel: Heading, className }: FeatureGridProps): import("react").JSX.Element;
2270
- //#endregion
2271
- //#region src/marketing/FeatureGrid/block.meta.d.ts
2272
- declare const meta$26: BlockMeta;
2273
- //#endregion
2274
- //#region src/marketing/FeatureGrid/fixtures.d.ts
2275
- /** Sample product-agnostic features. */
2276
- export declare const sampleFeatures: Feature[];
2277
- //#endregion
2278
- //#region src/marketing/PricingTable/PricingTable.d.ts
2279
- export type PricingCycle = 'monthly' | 'annual';
2280
- export interface PricingTier {
2281
- id: string;
2282
- name: string;
2283
- description?: string;
2284
- /** Price per month on monthly billing; null shows "Custom". */
2285
- priceMonthly: number | null;
2286
- /** Price per month on annual billing; null shows "Custom". */
2287
- priceAnnual: number | null;
2288
- /** Call-to-action label. */
2289
- cta: string;
2290
- features: string[];
2291
- /** Emphasised with a primary border (no colour fill). */
2292
- highlighted?: boolean;
2293
- /** Label on the tier, e.g. "Most popular". */
2294
- badge?: string;
2574
+ /** Compares two cell values: nulls last, numbers and dates numerically, strings with localeCompare (numeric). */
2575
+ export declare function compareValues(a: CellValue, b: CellValue): number;
2576
+ /** Client-side sort (stable). Returns the input order when there is no sort or the column has no accessor. */
2577
+ export declare function sortRows<T>(rows: readonly T[], columns: ReadonlyArray<DataTableColumn<T>>, sort: SortState | null): T[];
2578
+ /** Number of pages for a row count (at least 1). */
2579
+ export declare function pageCountOf(total: number, pageSize: number): number;
2580
+ /** Client-side pagination: the rows of a 1-based page (clamped to the valid range). */
2581
+ export declare function paginate<T>(rows: readonly T[], page: number, pageSize: number): T[];
2582
+ /** Header checkbox state for the rows on screen. */
2583
+ export declare function selectionState(visibleIds: readonly string[], selected: ReadonlySet<string>): {
2584
+ checked: boolean;
2585
+ indeterminate: boolean;
2586
+ };
2587
+ /** Selects all of `ids` when not all are selected; otherwise clears them. Other selections are kept. */
2588
+ export declare function toggleAll(ids: readonly string[], selected: ReadonlySet<string>): Set<string>;
2589
+ export declare function toggleOne(id: string, selected: ReadonlySet<string>): Set<string>;
2590
+ /** Optional locale and boolean text for default cells. */
2591
+ export interface DataTableCellFormatOptions {
2592
+ locale?: string;
2593
+ booleanLabels?: [trueLabel: string, falseLabel: string];
2295
2594
  }
2296
- export interface PricingTableProps {
2297
- tiers?: PricingTier[];
2298
- eyebrow?: ReactNode;
2299
- title?: ReactNode;
2300
- description?: ReactNode;
2301
- currency?: string;
2302
- defaultCycle?: PricingCycle;
2303
- onCycleChange?: (cycle: PricingCycle) => void;
2304
- /** Called with the tier and the cycle shown when a CTA is activated. */
2305
- onSelectTier?: (tier: PricingTier, cycle: PricingCycle) => void;
2306
- /** Note next to the annual option, e.g. "Save 20%". */
2307
- annualNote?: string;
2308
- /** Level of the section title; tier names use the next level (or this one when there is no title). */
2309
- headingLevel?: 'h2' | 'h3';
2310
- /** Shows the monthly/annual toggle (default true). */
2311
- showCycleToggle?: boolean;
2312
- /** Columns at the widest breakpoint (default: one per tier, up to 4). */
2313
- columns?: 1 | 2 | 3 | 4;
2314
- /** Names the tier list / radio group when `title` is null (the block then renders no landmark), e.g. inside a wizard step. */
2315
- 'aria-label'?: string;
2316
- /** Id of an external heading that names the section when `title` is null. */
2317
- 'aria-labelledby'?: string;
2318
- /**
2319
- * Id of the tier the account is on: its card gets a "Current plan" badge and
2320
- * `aria-current`, and its CTA becomes a disabled "Current plan" button.
2321
- */
2322
- currentTierId?: string;
2323
- /** Label of the current tier's badge and disabled CTA. */
2324
- currentPlanLabel?: string;
2325
- /**
2326
- * Turns the tiers into a single-choice radio group (role radiogroup/radio, arrow keys,
2327
- * selected card with a primary border and a check). CTAs are not rendered in this mode.
2328
- */
2329
- selectable?: boolean;
2330
- /** Selected tier id (controlled, `selectable` only). */
2331
- value?: string;
2332
- /** Initially selected tier id (uncontrolled, `selectable` only). */
2333
- defaultValue?: string;
2334
- /** Called with the newly selected tier id (`selectable` only). */
2335
- onValueChange?: (value: string) => void;
2336
- className?: string;
2595
+ /** Default cell text for a raw value. Omitting options preserves the legacy output. */
2596
+ export declare function formatCell(value: CellValue, options?: DataTableCellFormatOptions): ReactNode;
2597
+ /** Groups rows by a field key or by a function returning the group key. */
2598
+ export type DataTableGroupBy<T> = Extract<keyof T, string> | ((row: T) => string | number | null | undefined);
2599
+ /** One group of rows, in display order. */
2600
+ export interface DataTableGroup<T> {
2601
+ /** Group key (`''` for rows without a value). */
2602
+ key: string;
2603
+ rows: T[];
2337
2604
  }
2338
- /** Pricing section: tiers with a monthly/annual toggle, a highlighted tier and a feature checklist. */
2339
- export declare function PricingTable({ tiers, eyebrow, title, description, currency, defaultCycle, onCycleChange, onSelectTier, annualNote, headingLevel: Heading, showCycleToggle, columns, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, currentTierId, currentPlanLabel, selectable, value, defaultValue, onValueChange, className }: PricingTableProps): import("react").JSX.Element;
2340
- //#endregion
2341
- //#region src/marketing/PricingTable/block.meta.d.ts
2342
- declare const meta$53: BlockMeta;
2605
+ /** Group key of a row (`''` when the value is null or undefined). */
2606
+ export declare function groupKeyOf<T>(row: T, groupBy: DataTableGroupBy<T>): string;
2607
+ /**
2608
+ * Splits rows into groups, keeping the row order inside each group. Groups follow `order` (the
2609
+ * keys' first appearance in it, e.g. the unsorted input) and then any key not seen there.
2610
+ */
2611
+ export declare function groupRows<T>(rows: readonly T[], groupBy: DataTableGroupBy<T>, order?: readonly T[]): DataTableGroup<T>[];
2343
2612
  //#endregion
2344
- //#region src/marketing/PricingTable/fixtures.d.ts
2345
- /** Sample three-tier pricing. Prices are per month; annual is per month billed yearly. */
2346
- export declare const samplePricingTiers: PricingTier[];
2613
+ //#region src/tables/DataTable/column-sizing.d.ts
2614
+ /** Column widths in px by column id. */
2615
+ type ColumnWidths = Readonly<Record<string, number>>;
2616
+ /** Columns pinned to the start (left in LTR) and end edges, in display order. */
2617
+ interface PinnedColumns {
2618
+ left?: readonly string[];
2619
+ right?: readonly string[];
2620
+ }
2621
+ type PinSide = 'left' | 'right';
2622
+ export declare const DEFAULT_COLUMN_WIDTH = 160;
2623
+ export declare const MIN_COLUMN_WIDTH = 60;
2624
+ export declare const MAX_COLUMN_WIDTH = 640;
2625
+ /** Clamps a width to the column's limits (rounded to whole px). */
2626
+ export declare function clampColumnWidth<T>(column: DataTableColumn<T>, width: number): number;
2627
+ /** Effective width of a column: the widths map, then `column.width`, then the default. */
2628
+ export declare function columnWidthOf<T>(column: DataTableColumn<T>, widths: ColumnWidths): number;
2629
+ /** Pins a column to a side (appended to that side) or unpins it (`null`). */
2630
+ export declare function setColumnPin(pinned: PinnedColumns, id: string, side: PinSide | null): PinnedColumns;
2631
+ /** Display order: start-pinned columns (pin order), unpinned columns (column order), end-pinned columns. */
2632
+ export declare function orderColumns<T>(columns: ReadonlyArray<DataTableColumn<T>>, pinned: PinnedColumns): Array<DataTableColumn<T>>;
2347
2633
  //#endregion
2348
- //#region src/marketing/Faq/Faq.d.ts
2349
- export interface FaqItem {
2350
- id: string;
2351
- question: string;
2352
- answer: ReactNode;
2634
+ //#region src/tables/PaginationFooter/PaginationFooter.d.ts
2635
+ export interface PaginationFooterLabels {
2636
+ rowsPerPage: string;
2637
+ rowsPerPageLabel: string;
2638
+ rangeSummary: (from: number, to: number, total: number) => string;
2639
+ paginationNav: (noun: string) => string;
2640
+ previous: string;
2641
+ next: string;
2642
+ page: (page: number) => string;
2353
2643
  }
2354
- export interface FaqProps {
2355
- items?: FaqItem[];
2356
- title?: ReactNode;
2357
- description?: ReactNode;
2358
- /** `stacked` (heading over the list) or `split` (heading left from `lg`). */
2359
- layout?: 'stacked' | 'split';
2360
- /** Ids of the items open on mount. */
2361
- defaultOpen?: string[];
2362
- /** Allow several items open at once. */
2363
- multiple?: boolean;
2364
- headingLevel?: 'h2' | 'h3';
2644
+ export interface PaginationFooterProps {
2645
+ /** Per-key overrides; omitted keys retain the existing provider translations and defaults. */
2646
+ labels?: Partial<PaginationFooterLabels>;
2647
+ /** Total number of rows. */
2648
+ total?: number;
2649
+ /** Current page, 1-based (controlled). */
2650
+ page?: number;
2651
+ defaultPage?: number;
2652
+ onPageChange?: (page: number) => void;
2653
+ /** Rows per page (controlled). */
2654
+ pageSize?: number;
2655
+ defaultPageSize?: number;
2656
+ onPageSizeChange?: (pageSize: number) => void;
2657
+ pageSizeOptions?: readonly number[];
2658
+ /** What the rows are, for the accessible names ("Deployments"). */
2659
+ noun?: string;
2660
+ locale?: string;
2365
2661
  className?: string;
2366
2662
  }
2367
- /** Frequently asked questions in an accordion, with a heading block. */
2368
- export declare function Faq({ items, title, description, layout, defaultOpen, multiple, headingLevel: Heading, className }: FaqProps): import("react").JSX.Element;
2369
- //#endregion
2370
- //#region src/marketing/Faq/block.meta.d.ts
2371
- declare const meta$25: BlockMeta;
2663
+ /** Table footer: rows-per-page Select, a "1–10 of 97" summary and numbered Pagination. Stacks on small screens. */
2664
+ export declare function PaginationFooter({ total, page: pageProp, defaultPage, onPageChange, pageSize: sizeProp, defaultPageSize, onPageSizeChange, pageSizeOptions, noun: nounProp, locale: localeProp, className, labels }: PaginationFooterProps): import("react").JSX.Element;
2372
2665
  //#endregion
2373
- //#region src/marketing/Faq/fixtures.d.ts
2374
- /** Sample product-agnostic questions. */
2375
- export declare const sampleFaqs: FaqItem[];
2666
+ //#region src/tables/DataTable/labels.d.ts
2667
+ /** Per-instance table chrome, including the composed PaginationFooter. Caller data stays caller-owned. */
2668
+ interface DataTableLabels extends PaginationFooterLabels {
2669
+ export?: string;
2670
+ exportAll?: (count: number) => string;
2671
+ exportPage?: string;
2672
+ exportSelected?: (count: number) => string;
2673
+ copySelected?: string;
2674
+ copiedToClipboard?: string;
2675
+ copyFailed?: string;
2676
+ booleanTrue: string;
2677
+ booleanFalse: string;
2678
+ /** Non-virtual table overflow region; virtualized regions keep the caller caption. */
2679
+ scrollRegion: string;
2680
+ selectionCount: (count: number) => string;
2681
+ pageSelected: (count: number) => string;
2682
+ selectAllMatching: (count: number) => string;
2683
+ allMatchingSelected: (count: number) => string;
2684
+ clearSelection: string;
2685
+ columns: string;
2686
+ visibleColumns: string;
2687
+ pinColumns: string;
2688
+ pinnedLeft: string;
2689
+ pinnedRight: string;
2690
+ pinLeft: string;
2691
+ pinRight: string;
2692
+ unpinned: string;
2693
+ density: string;
2694
+ comfortable: string;
2695
+ compact: string;
2696
+ resizeColumn: (label: string) => string;
2697
+ columnWidth: (width: number) => string;
2698
+ defaultView: string;
2699
+ defaultViewOption: string;
2700
+ modified: string;
2701
+ views: string;
2702
+ saveChanges: string;
2703
+ saveAs: string;
2704
+ renameView: string;
2705
+ deleteView: string;
2706
+ resetChanges: string;
2707
+ saveViewTitle: string;
2708
+ renameViewTitle: string;
2709
+ viewName: string;
2710
+ cancel: string;
2711
+ saveView: string;
2712
+ rename: string;
2713
+ closeDialog: string;
2714
+ selection: string;
2715
+ selectAll: string;
2716
+ selectRow: (label: string) => string;
2717
+ selectGroup: (group: string) => string;
2718
+ groupRows: (count: number) => string;
2719
+ noGroup: string;
2720
+ actions: string;
2721
+ rowActions: (label: string) => string;
2722
+ emptyTitle: string;
2723
+ emptyDescription: string;
2724
+ loading: (caption: string) => string;
2725
+ editHint: string;
2726
+ editLabel: (column: string, row: string) => string;
2727
+ editError: string;
2728
+ enterNumber: string;
2729
+ minimumValue: (min: number) => string;
2730
+ maximumValue: (max: number) => string;
2731
+ }
2376
2732
  //#endregion
2377
- //#region src/marketing/ComparisonTable/ComparisonTable.d.ts
2378
- /** A plan or option: one column of the comparison. */
2379
- export interface ComparisonPlan {
2380
- id: string;
2381
- name: string;
2382
- /** Headline price or figure under the name ("$49", "Custom"). */
2383
- price?: ReactNode;
2384
- /** Small text after the price ("per month"). */
2385
- priceNote?: ReactNode;
2386
- /** Call to action under the price. */
2387
- cta?: MarketingAction;
2388
- }
2389
- /** A plain value, or a value with a short note under it ("Add-on"). */
2390
- export type ComparisonValue = boolean | string | number | null | undefined | {
2391
- value: boolean | string | number | null;
2392
- note?: string;
2393
- };
2394
- export interface ComparisonFeature {
2395
- id: string;
2396
- label: string;
2397
- /** Muted text under the label. */
2398
- description?: string;
2399
- /** Value per plan id. Missing / null values render like `false` (a dash, "Not included"). */
2400
- values: Readonly<Record<string, ComparisonValue>>;
2401
- }
2402
- export interface ComparisonSection {
2403
- id: string;
2404
- title: string;
2405
- features: ComparisonFeature[];
2406
- }
2407
- export interface ComparisonTableProps {
2408
- plans?: ComparisonPlan[];
2409
- sections?: ComparisonSection[];
2410
- /** Plan column marked as recommended: badge text, a primary top rule and a tinted column. */
2411
- highlightedPlanId?: string;
2412
- /** Text of the recommended badge (default "Recommended"). */
2413
- highlightLabel?: string;
2414
- eyebrow?: ReactNode;
2415
- title?: ReactNode;
2416
- description?: ReactNode;
2417
- /** Level of the section title (default h2). */
2418
- headingLevel?: 'h2' | 'h3';
2419
- /** Table name (screen-reader caption). Default: the title when it is a string, else "Plan comparison". */
2420
- caption?: string;
2421
- /** Header of the feature column (screen-reader only unless `showFeatureHeader`). */
2422
- featureHeader?: string;
2423
- showFeatureHeader?: boolean;
2424
- /** Screen-reader text of `true` (default "Included"). */
2425
- includedLabel?: string;
2426
- /** Screen-reader text of `false` / missing values (default "Not included"). */
2427
- notIncludedLabel?: string;
2428
- /** Formats numeric values (default: en-US grouping). */
2429
- formatNumber?: (value: number, feature: ComparisonFeature) => string;
2430
- className?: string;
2733
+ //#region src/tables/DataTable/editable-cell.d.ts
2734
+ /** One committed cell edit, as `onCellEdit` receives it. */
2735
+ interface DataTableCellEdit<T> {
2736
+ row: T;
2737
+ rowId: string;
2738
+ columnId: string;
2739
+ /** Parsed value: a string (text, select) or a number / null (number editor). */
2740
+ value: string | number | null;
2741
+ /** Value the editor started from. */
2742
+ previous: string | number | null;
2431
2743
  }
2432
2744
  /**
2433
- * Feature comparison of plans or options: columns are plans, rows are features grouped by section.
2434
- * Booleans render as a check or a dash with screen-reader text; text and numbers render as is. The
2435
- * table scrolls sideways on narrow screens with the feature column pinned.
2745
+ * Result of `onCellEdit`: nothing or `true` accepts the edit (the parent updates `rows`); a string
2746
+ * rejects it and is shown inline as the error; `false` rejects with a generic message. A thrown
2747
+ * error (or a rejected promise) rejects with its message.
2436
2748
  */
2437
- export declare function ComparisonTable({ plans, sections, highlightedPlanId, highlightLabel, eyebrow, title, description, headingLevel: Heading, caption, featureHeader, showFeatureHeader, includedLabel, notIncludedLabel, formatNumber, className }: ComparisonTableProps): import("react").JSX.Element;
2438
- //#endregion
2439
- //#region src/marketing/ComparisonTable/block.meta.d.ts
2440
- declare const meta$10: BlockMeta;
2441
- //#endregion
2442
- //#region src/marketing/ComparisonTable/fixtures.d.ts
2443
- /** Three sample plans (generic, product-agnostic). */
2444
- export declare const sampleComparisonPlans: ComparisonPlan[];
2445
- /** Features grouped by section; values are keyed by plan id. */
2446
- export declare const sampleComparisonSections: ComparisonSection[];
2447
- //#endregion
2448
- //#region src/page-chrome/types.d.ts
2449
- /** A header/toolbar action rendered as a kit Button (or a MoreMenu item when folded). */
2450
- interface PageChromeAction {
2451
- /** Stable key; defaults to `label`. */
2452
- id?: string;
2453
- label: string;
2454
- icon?: LucideIcon;
2455
- /** Button style; when omitted the block picks one (primary for the main action, secondary otherwise). */
2456
- variant?: ButtonProps['variant'];
2457
- disabled?: boolean;
2458
- onClick?: () => void;
2749
+ type DataTableCellEditResult = void | boolean | string;
2750
+ type DataTableCellEditHandler<T> = (edit: DataTableCellEdit<T>) => DataTableCellEditResult | Promise<DataTableCellEditResult>;
2751
+ interface EditableCellProps<T> {
2752
+ labels?: Partial<DataTableLabels>;
2753
+ row: T;
2754
+ rowId: string;
2755
+ rowLabel: string;
2756
+ column: DataTableColumn<T>;
2757
+ onCellEdit: DataTableCellEditHandler<T>;
2758
+ /** Id of the shared "Press Enter or F2 to edit" hint. */
2759
+ hintId: string;
2760
+ /** The cell's display content. */
2761
+ children: ReactNode;
2459
2762
  }
2763
+ /**
2764
+ * An editable body cell's content. At rest it is a button showing the value (Enter, F2 or a click
2765
+ * edits); while editing, an input or a select: Enter or Tab commits, Escape cancels. `onCellEdit`
2766
+ * can reject the value with a message, shown inline under the editor.
2767
+ */
2768
+ export declare function EditableCell<T>({ row, rowId, rowLabel, column, onCellEdit, hintId, children, labels }: EditableCellProps<T>): import("react").JSX.Element;
2460
2769
  //#endregion
2461
- //#region src/page-chrome/PageHeader/PageHeader.d.ts
2462
- export interface PageHeaderMetaItem {
2463
- /** Term (screen-reader only when an icon is shown). */
2464
- label: string;
2465
- value: ReactNode;
2466
- icon?: LucideIcon;
2467
- /** Render the value in Geist Mono (ids, regions, versions). */
2468
- mono?: boolean;
2469
- }
2470
- export interface PageHeaderTab {
2471
- value: string;
2472
- label: string;
2473
- count?: number;
2770
+ //#region src/tables/DataTable/views.d.ts
2771
+ /** What a saved view captures. Every field is optional: a missing field keeps the table's default. */
2772
+ interface DataTableViewState {
2773
+ /** Opaque filter state of the page's toolbar (see the table's `filters` / `onFiltersChange`). */
2774
+ filters?: unknown;
2775
+ sort?: SortState | null;
2776
+ hiddenColumns?: readonly string[];
2777
+ columnWidths?: ColumnWidths;
2778
+ pinnedColumns?: PinnedColumns;
2779
+ /** A field key, or `null` for no grouping (function `groupBy`s cannot be saved). */
2780
+ groupBy?: string | null;
2474
2781
  }
2475
- export interface PageHeaderLabels {
2476
- title: string;
2477
- description: string;
2478
- moreActions: string;
2479
- sections: string;
2782
+ interface DataTableView {
2783
+ id: string;
2784
+ name: string;
2785
+ state: DataTableViewState;
2480
2786
  }
2481
- export interface PageHeaderProps {
2482
- /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
2483
- labels?: Partial<PageHeaderLabels>;
2484
- /** Root element. Use 'div' where the layout already has a banner (e.g. StackedLayout's pageHeader slot). */
2485
- as?: 'header' | 'div';
2486
- /** Location trail above the title; `null` hides it. */
2487
- breadcrumbs?: BreadcrumbItem[] | null;
2488
- title?: ReactNode;
2489
- /** h1 focus target: adds tabIndex=-1 for titleRef.current.focus(), outside the Tab order. */
2490
- titleRef?: Ref<HTMLHeadingElement>;
2491
- description?: ReactNode;
2492
- /** StatusTag key next to the title (e.g. `active`, `paused`, `failed`). */
2493
- status?: string;
2494
- statuses?: Record<string, StatusDefinition>;
2495
- /** Meta row under the description. */
2496
- meta?: PageHeaderMetaItem[];
2497
- /**
2498
- * Header actions in visual order. The primary one (first with `variant: 'primary'`, else the
2499
- * last) stays visible on small screens; the rest fold into a MoreMenu.
2500
- */
2501
- actions?: PageChromeAction[];
2502
- /** Resource-level navigation tabs under the header; `null` hides them. */
2503
- tabs?: PageHeaderTab[] | null;
2504
- tab?: string;
2505
- defaultTab?: string;
2506
- onTabChange?: (value: string) => void;
2507
- className?: string;
2787
+ /** Whether two view states are equivalent (key order and empty values ignored). */
2788
+ export declare function sameViewState(a: DataTableViewState, b: DataTableViewState): boolean;
2789
+ interface ViewSwitcherProps {
2790
+ labels?: Partial<DataTableLabels>;
2791
+ views: readonly DataTableView[];
2792
+ activeId: string | null;
2793
+ /** The table differs from the active view (or from the defaults when none is active). */
2794
+ dirty: boolean;
2795
+ onSelect: (id: string | null) => void;
2796
+ onSaveAs: (name: string) => void;
2797
+ onSave: () => void;
2798
+ onRename: (id: string, name: string) => void;
2799
+ onDelete: (id: string) => void;
2800
+ onReset: () => void;
2508
2801
  }
2509
- /** Screen header: breadcrumb, title + status, description, meta row, actions and optional tabs. */
2510
- export declare function PageHeader({ as: Root, breadcrumbs, title: titleProp, labels, titleRef, description: descriptionProp, status, statuses, meta, actions, tabs, tab, defaultTab, onTabChange, className }: PageHeaderProps): import("react").JSX.Element;
2511
- //#endregion
2512
- //#region src/page-chrome/PageHeader/fixtures.d.ts
2513
- export declare const pageHeaderBreadcrumbs: BreadcrumbItem[];
2514
- export declare const pageHeaderActions: PageChromeAction[];
2515
- export declare const pageHeaderTabs: PageHeaderTab[];
2516
- //#endregion
2517
- //#region src/page-chrome/PageHeader/block.meta.d.ts
2518
- declare const meta$46: BlockMeta;
2802
+ /** "Views" menu: switch between saved views, save the current table as a view, rename, delete, reset. */
2803
+ declare function ViewSwitcher({ labels, views, activeId, dirty, onSelect, onSaveAs, onSave, onRename, onDelete, onReset }: ViewSwitcherProps): import("react").JSX.Element;
2519
2804
  //#endregion
2520
- //#region src/page-chrome/SectionHeader/SectionHeader.d.ts
2521
- export interface SectionHeaderProps {
2522
- title?: ReactNode;
2523
- description?: ReactNode;
2524
- /** Count pill after the title (members, items…). */
2525
- count?: number;
2526
- /** Small actions on the right; the last one without a variant is secondary. */
2527
- actions?: PageChromeAction[];
2528
- /** Heading level that fits the page outline. */
2529
- as?: 'h2' | 'h3';
2530
- /** Hairline under the header. */
2531
- bordered?: boolean;
2532
- /** Id for the heading, so a section can use `aria-labelledby`. */
2533
- headingId?: string;
2534
- className?: string;
2805
+ //#region src/tables/DataTable/data-table-props.d.ts
2806
+ /** Complete next query, emitted synchronously once per user action in either pagination mode. */
2807
+ interface DataTableQuery {
2808
+ page: number;
2809
+ pageSize: number;
2810
+ sort: SortState | null;
2811
+ filters: unknown;
2812
+ cause: 'page' | 'pageSize' | 'sort' | 'view';
2535
2813
  }
2536
- /** Heading for a section inside a page: title (+ count), description and small actions. */
2537
- export declare function SectionHeader({ title, description, count, actions, as: Heading, bordered, headingId, className }: SectionHeaderProps): import("react").JSX.Element;
2538
- //#endregion
2539
- //#region src/page-chrome/SectionHeader/block.meta.d.ts
2540
- declare const meta$59: BlockMeta;
2541
- //#endregion
2542
- //#region src/page-chrome/PageToolbar/PageToolbar.d.ts
2543
- export interface PageToolbarView {
2544
- value: string;
2545
- /** Accessible name of the icon toggle. */
2546
- label: string;
2547
- icon: LucideIcon;
2814
+ interface DataTableCsvExportOptions {
2815
+ fileName?: string;
2816
+ scopes?: Array<'rows' | 'page' | 'selected'>;
2548
2817
  }
2549
- export interface PageToolbarProps {
2550
- /** Controlled search text. */
2551
- search?: string;
2552
- defaultSearch?: string;
2553
- onSearchChange?: (value: string) => void;
2554
- searchLabel?: string;
2555
- searchPlaceholder?: string;
2818
+ interface DataTableExportRequest {
2819
+ scope: 'rows' | 'page' | 'selected';
2820
+ columns: string[];
2821
+ selectedIds: string[];
2822
+ sort: SortState | null;
2823
+ filters: unknown;
2824
+ }
2825
+ interface DataTableCommonProps<T> {
2826
+ /** Opt-in CSV menu. Values are raw, with spreadsheet formula protection. */
2827
+ csvExport?: boolean | DataTableCsvExportOptions;
2828
+ /** Delegate exports to the consumer; required for server pagination. */
2829
+ onExport?: (request: DataTableExportRequest) => void | Promise<void>;
2830
+ /** Per-key overrides; omitted keys keep existing defaults and provider translations. */
2831
+ labels?: Partial<DataTableLabels>;
2832
+ rows?: readonly T[];
2833
+ columns?: ReadonlyArray<DataTableColumn<T>>;
2834
+ /** Stable row id (defaults to `row.id`). */
2835
+ getRowId?: (row: T) => string;
2836
+ /** Row name for selection and menu labels (defaults to the first column's value). */
2837
+ getRowLabel?: (row: T) => string;
2838
+ /** Table name (screen-reader caption unless `showCaption`). */
2839
+ caption?: string;
2840
+ showCaption?: boolean;
2841
+ /** Row selection with a select-all header checkbox (current page). */
2842
+ selectable?: boolean;
2843
+ /** Native radio name in single mode. Supplied names must be unique per page. */
2844
+ selectionName?: string;
2845
+ selectedId?: string | null;
2846
+ defaultSelectedId?: string | null;
2847
+ onSelectedIdChange?: (id: string) => void;
2848
+ isRowDisabled?: (row: T) => boolean;
2849
+ selectedIds?: readonly string[];
2850
+ defaultSelectedIds?: readonly string[];
2851
+ onSelectionChange?: (ids: string[]) => void;
2852
+ /** Keep ids absent from rows. Defaults to true for server pagination, false for client pagination. */
2853
+ preserveSelection?: boolean;
2854
+ /** Offer to extend a selected page to all matching rows (default false). */
2855
+ selectAllMatching?: boolean;
2856
+ /** Hide the page select-all checkbox, retaining row controls and the column heading. */
2857
+ hideSelectAll?: boolean;
2858
+ /** Controlled model; takes precedence over selectedIds. */
2859
+ selectionModel?: DataTableSelectionModel;
2860
+ /** Required to offer select-all-matching with server pagination. */
2861
+ onSelectionModelChange?: (model: DataTableSelectionModel) => void;
2862
+ /** Rendered in the toolbar while rows are selected. */
2863
+ bulkActions?: (selectedIds: string[], selection: DataTableSelectionModel) => ReactNode;
2556
2864
  /**
2557
- * Filter controls. Use ToolbarButton (optionally with `render` for a Menu/Popover trigger) so they
2558
- * join the toolbar's arrow-key navigation. Omitted: a single "Filters" button; `null` hides it.
2865
+ * Shows the "N selected" text in the toolbar while rows are selected (default true). Turn it
2866
+ * off when the page renders its own count, e.g. a BulkActionBar.
2559
2867
  */
2560
- filters?: ReactNode;
2561
- /** View modes for the segmented toggle; `null` or an empty list hides it. */
2562
- views?: PageToolbarView[] | null;
2563
- view?: string;
2564
- defaultView?: string;
2565
- onViewChange?: (value: string) => void;
2566
- /** Main action at the end of the bar; `null` hides it. */
2567
- primaryAction?: PageChromeAction | null;
2568
- 'aria-label'?: string;
2569
- className?: string;
2570
- }
2571
- /** List/table toolbar: search, filters, view toggle and the primary action, with one Tab stop. */
2572
- export declare function PageToolbar({ search, defaultSearch, onSearchChange, searchLabel: searchLabelProp, searchPlaceholder, filters, views, view, defaultView, onViewChange, primaryAction, 'aria-label': ariaLabelProp, className }: PageToolbarProps): import("react").JSX.Element;
2573
- //#endregion
2574
- //#region src/page-chrome/PageToolbar/fixtures.d.ts
2575
- export declare const pageToolbarViews: PageToolbarView[];
2576
- //#endregion
2577
- //#region src/page-chrome/PageToolbar/block.meta.d.ts
2578
- declare const meta$47: BlockMeta;
2579
- //#endregion
2580
- //#region src/page-chrome/StickyActionBar/StickyActionBar.d.ts
2581
- export interface StickyActionBarProps {
2582
- /** Whether the form has unsaved changes; Save and Discard are disabled while clean. */
2583
- dirty?: boolean;
2584
- /** Shows a spinner on Save and blocks both buttons. */
2585
- saving?: boolean;
2586
- onSave?: () => void;
2587
- onCancel?: () => void;
2588
- /** Text while dirty. */
2589
- dirtyMessage?: ReactNode;
2590
- /** Text while clean. */
2591
- cleanMessage?: ReactNode;
2592
- saveLabel?: string;
2593
- cancelLabel?: string;
2594
- /** Render nothing while clean (the bar slides in only when there is something to save). */
2595
- hideWhenClean?: boolean;
2596
- /** Accessible name of the region. */
2597
- 'aria-label'?: string;
2868
+ selectionSummary?: boolean;
2869
+ /** Row-actions menu items. */
2870
+ rowActions?: (row: T) => Array<MoreMenuAction | 'separator'>;
2871
+ sort?: SortState | null;
2872
+ defaultSort?: SortState | null;
2873
+ onSortChange?: (sort: SortState) => void;
2874
+ /** Use this OR the separate callbacks for fetching, to avoid duplicate requests. Prop changes do not emit queries. */
2875
+ onQueryChange?: (query: DataTableQuery) => void;
2876
+ /** Rows arrive sorted (server side): headers still toggle, rows are not re-sorted. */
2877
+ manualSorting?: boolean;
2878
+ defaultPageSize?: number;
2879
+ pageSizeOptions?: readonly number[];
2880
+ /** Controlled row density. */
2881
+ density?: TableDensity;
2882
+ /** Initial density; omitted, the table follows the surrounding DensityProvider (comfortable outside one). */
2883
+ defaultDensity?: TableDensity;
2884
+ onDensityChange?: (density: TableDensity) => void;
2885
+ showDensityToggle?: boolean;
2886
+ showColumnMenu?: boolean;
2887
+ loading?: boolean;
2888
+ loadingRows?: number;
2889
+ emptyState?: ReactNode;
2890
+ /**
2891
+ * Groups rows under header rows (a field key or a function returning the group key). Groups keep
2892
+ * the order in which their keys first appear in `rows`; sorting applies inside each group, and
2893
+ * pagination pages through the grouped rows (each header shows the group's full count).
2894
+ */
2895
+ groupBy?: DataTableGroupBy<T>;
2896
+ /** Header text of a group (default: the key, or "No group" for rows without a value). */
2897
+ groupLabel?: (key: string, rows: readonly T[]) => ReactNode;
2898
+ /** Group headers render a keyboard-accessible collapse button (default true). */
2899
+ collapsibleGroups?: boolean;
2900
+ /** Controlled collapsed group keys. */
2901
+ collapsedGroups?: readonly string[];
2902
+ /** Group keys collapsed initially. */
2903
+ defaultCollapsedGroups?: readonly string[];
2904
+ onCollapsedGroupsChange?: (keys: string[]) => void;
2905
+ /** Called when a saved view switches grouping (a field key, or `null` for none). */
2906
+ onGroupByChange?: (groupBy: string | null) => void;
2907
+ /** Controlled hidden column ids (default: columns with `defaultHidden`). */
2908
+ hiddenColumns?: readonly string[];
2909
+ onHiddenColumnsChange?: (ids: string[]) => void;
2910
+ /** Resize handles on the column headers (pointer drag, or arrow keys on the focused handle). */
2911
+ resizable?: boolean;
2912
+ /** Controlled column widths in px by column id. */
2913
+ columnWidths?: ColumnWidths;
2914
+ defaultColumnWidths?: ColumnWidths;
2915
+ onColumnWidthsChange?: (widths: Record<string, number>) => void;
2916
+ /** Controlled pinned columns (sticky at the start or end edge while scrolling sideways). */
2917
+ pinnedColumns?: PinnedColumns;
2918
+ defaultPinnedColumns?: PinnedColumns;
2919
+ onPinnedColumnsChange?: (pinned: PinnedColumns) => void;
2920
+ /** Pin / unpin from the column menu (default true when pinning is in use: a pinned prop or callback). */
2921
+ showPinMenu?: boolean;
2922
+ /**
2923
+ * Renders only the rows in view (plus overscan) inside a scrolling body with a sticky header.
2924
+ * `'auto'` (default) turns it on above `virtualizeThreshold` rendered rows (with pagination,
2925
+ * the rows of the current page). The table exposes `aria-rowcount` and each row its
2926
+ * `aria-rowindex`; selection (select-all covers every row) and grouping keep working.
2927
+ * Limits: rows get a fixed height (`rowHeight`), so multi-line cells are clipped; a row that
2928
+ * scrolls out of view unmounts, so focus inside it (or an open inline editor) is lost; a group's
2929
+ * header row renders only while it is in view.
2930
+ */
2931
+ virtualize?: boolean | 'auto';
2932
+ virtualizeThreshold?: number;
2933
+ /** Row height in px for virtualization (default by density: 44 comfortable, 36 compact). */
2934
+ rowHeight?: number;
2935
+ /** Classes of the virtualized scroll container: its max height (default `max-h-[32rem]`). */
2936
+ virtualContainerClassName?: string;
2937
+ /**
2938
+ * Inline editing of `editable` columns. Return nothing to accept (and update `rows`), or a
2939
+ * message (or throw) to reject: the message is shown inline under the editor.
2940
+ */
2941
+ onCellEdit?: DataTableCellEditHandler<T>;
2942
+ /** Saved views (controlled). Each captures filters, sort, visible columns, widths, pinning and grouping. */
2943
+ views?: readonly DataTableView[];
2944
+ defaultViews?: readonly DataTableView[];
2945
+ onViewsChange?: (views: DataTableView[]) => void;
2946
+ activeViewId?: string | null;
2947
+ defaultActiveViewId?: string | null;
2948
+ onActiveViewChange?: (id: string | null) => void;
2949
+ /** Shows the view switcher (default: when views are in use). */
2950
+ showViewSwitcher?: boolean;
2951
+ /** Opaque filter state of the page's toolbar, saved with views. */
2952
+ filters?: unknown;
2953
+ /** Called when a view (or a reset) restores filters. */
2954
+ onFiltersChange?: (filters: unknown) => void;
2955
+ /** Left side of the toolbar (title, search, FilterBar…). */
2956
+ toolbar?: ReactNode;
2598
2957
  className?: string;
2599
2958
  }
2600
- /** Bottom bar for long forms: unsaved-changes status plus Discard / Save, sticky to the viewport. */
2601
- export declare function StickyActionBar({ dirty, saving, onSave, onCancel, dirtyMessage: dirtyMessageProp, cleanMessage: cleanMessageProp, saveLabel: saveLabelProp, cancelLabel: cancelLabelProp, hideWhenClean, 'aria-label': ariaLabelProp, className }: StickyActionBarProps): import("react").JSX.Element | null;
2602
- //#endregion
2603
- //#region src/page-chrome/StickyActionBar/block.meta.d.ts
2604
- declare const meta$69: BlockMeta;
2605
- //#endregion
2606
- //#region src/page-chrome/BulkActionBar/BulkActionBar.d.ts
2607
- export interface BulkActionBarProps {
2608
- /** Number of selected rows; the bar renders nothing at 0. */
2609
- selectedCount?: number;
2610
- /** Total rows, shown as "3 of 24 selected". */
2611
- totalCount?: number;
2612
- /** Noun for the count, singular and plural. */
2613
- noun?: [singular: string, plural: string];
2614
- actions?: PageChromeAction[];
2615
- onClear?: () => void;
2616
- clearLabel?: string;
2617
- className?: string;
2959
+ interface ClientPaginationProps {
2960
+ paginationMode?: 'client';
2961
+ rowCount?: never;
2962
+ page?: never;
2963
+ pageSize?: never;
2964
+ onPageChange?: never;
2965
+ onPageSizeChange?: never;
2618
2966
  }
2619
- /** Contextual toolbar shown while rows are selected: count, bulk actions and clear selection. */
2620
- export declare function BulkActionBar({ selectedCount, totalCount, noun: nounProp, actions, onClear, clearLabel: clearLabelProp, className }: BulkActionBarProps): import("react").JSX.Element | null;
2621
- //#endregion
2622
- //#region src/page-chrome/BulkActionBar/block.meta.d.ts
2623
- declare const meta$6: BlockMeta;
2624
- //#endregion
2625
- //#region src/scheduling/shared/dates.d.ts
2626
- /** The clock options accepted by the scheduling blocks. */
2627
- type HourCycle = 'h12' | 'h23';
2967
+ interface ServerPaginationProps {
2968
+ /** Rows arrive as one server page without client sorting or slicing. Sortable headers require onSortChange or onQueryChange; sorting requests page 1. */
2969
+ paginationMode: 'server';
2970
+ /** Total number of rows across all pages; required even for an empty result. */
2971
+ rowCount: number;
2972
+ /** Current page, 1-based. Out-of-range pages are clamped for display without callbacks. */
2973
+ page: number;
2974
+ pageSize: number;
2975
+ onPageChange?: (page: number) => void;
2976
+ /** The footer may also request a page change to keep the first visible row on screen. */
2977
+ onPageSizeChange?: (size: number) => void;
2978
+ }
2979
+ type DataTableProps<T> = DataTableCommonProps<T> & (({
2980
+ selectionMode: 'single';
2981
+ paginated?: boolean;
2982
+ /** Consumer-supplied accessible group label; the kit adds no default. */
2983
+ legend?: ReactNode;
2984
+ 'aria-label'?: string;
2985
+ 'aria-labelledby'?: string;
2986
+ } & (ClientPaginationProps | ServerPaginationProps)) | ({
2987
+ selectionMode?: 'none' | 'multiple';
2988
+ paginated?: boolean;
2989
+ legend?: never;
2990
+ 'aria-label'?: never;
2991
+ 'aria-labelledby'?: never;
2992
+ } & (ClientPaginationProps | ServerPaginationProps)));
2628
2993
  //#endregion
2629
- //#region src/scheduling/shared/events.d.ts
2630
- /** A scheduled item on a calendar. */
2631
- interface ScheduleEvent {
2994
+ //#region src/tables/DataTable/fixtures.d.ts
2995
+ interface DeploymentRow {
2632
2996
  id: string;
2633
- title: string;
2634
- start: Date;
2635
- end: Date;
2636
- /** Key into the `kinds` map (job, deploy, review, backup, maintenance…). */
2637
- kind?: string;
2638
- /** Region, room or target, shown after the time. */
2639
- location?: string;
2640
- }
2641
- type EventTone = 'primary' | 'violet' | 'cyan' | 'amber' | 'neutral';
2642
- interface EventKind {
2643
- label: string;
2644
- icon: LucideIcon;
2645
- tone: EventTone;
2997
+ name: string;
2998
+ region: string;
2999
+ status: 'running' | 'queued' | 'paused' | 'degraded' | 'failed';
3000
+ requests: number;
3001
+ cost: number;
3002
+ updatedAt: Date;
2646
3003
  }
2647
- /** Default kinds: brand green for jobs, categorical accents for the rest (never severity). */
2648
- export declare const defaultEventKinds: Record<string, EventKind>;
3004
+ /** Deterministic deployments (the first 24 are DEPLOYMENT_ROWS); large counts exercise virtualization. */
3005
+ export declare function generateDeployments(count: number): DeploymentRow[];
3006
+ /** 24 deployments: enough for two pages at the default page size. */
3007
+ export declare const DEPLOYMENT_ROWS: DeploymentRow[];
3008
+ /** Columns for DEPLOYMENT_ROWS. */
3009
+ export declare const DEPLOYMENT_COLUMNS: DataTableColumn<DeploymentRow>[];
2649
3010
  //#endregion
2650
- //#region src/scheduling/MonthCalendar/MonthCalendar.d.ts
2651
- export interface MonthCalendarProps {
2652
- events?: ScheduleEvent[];
2653
- /** Clock used for event times; defaults to the provider or runtime locale. */
2654
- hourCycle?: HourCycle;
2655
- /** First weekday; defaults to the provider or runtime locale. */
2656
- weekStartsOn?: WeekDay;
2657
- /** The app's "today" (the block never reads the clock). */
2658
- today?: Date;
2659
- /** Month shown first (uncontrolled). Defaults to the month of `today`. */
2660
- defaultMonth?: Date;
2661
- onMonthChange?: (month: Date) => void;
2662
- /** Initially selected day (uncontrolled). */
2663
- defaultSelected?: Date;
2664
- /** Called when a day is activated (click, Enter or Space). */
2665
- onSelectDate?: (date: Date, events: ScheduleEvent[]) => void;
2666
- /** Event kinds (label, icon, tone) by `event.kind`. */
2667
- kinds?: Record<string, EventKind>;
2668
- /** Event lines per day before "+N more". */
2669
- maxEventsPerDay?: number;
2670
- /** Caller actions in the header (e.g. a "Schedule" button). */
2671
- actions?: ReactNode;
2672
- className?: string;
2673
- }
3011
+ //#region src/tables/DataTable/DataTable.d.ts
2674
3012
  /**
2675
- * Month view of scheduled work: a locale-first grid with up to N events per day.
2676
- * Keyboard: arrows move by day/week, Home/End to the week edges, PageUp/PageDown by month,
2677
- * Enter/Space selects.
3013
+ * Generic data table on the kit Table: typed columns, sortable headers (aria-sort), row selection
3014
+ * with select-all / indeterminate, column visibility menu, density toggle, row actions, loading
3015
+ * and empty states, client-side sort + pagination, optional collapsible row groups (`groupBy`),
3016
+ * column resize and pinning, row virtualization, inline cell editing and saved views.
2678
3017
  */
2679
- export declare function MonthCalendar({ events, hourCycle: hourCycleProp, weekStartsOn: weekStartsOnProp, today, defaultMonth, onMonthChange, defaultSelected, onSelectDate, kinds, maxEventsPerDay, actions, className }: MonthCalendarProps): import("react").JSX.Element;
2680
- //#endregion
2681
- //#region src/scheduling/MonthCalendar/block.meta.d.ts
2682
- declare const meta$44: BlockMeta;
3018
+ export declare function DataTable<T = (typeof DEPLOYMENT_ROWS)[number]>({ rows, columns, getRowId, getRowLabel, caption: captionProp, showCaption, selectable: selectableProp, selectionMode, selectionName, legend, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, selectedId, defaultSelectedId, onSelectedIdChange, isRowDisabled, selectedIds, defaultSelectedIds, onSelectionChange, preserveSelection, selectAllMatching, hideSelectAll, selectionModel, onSelectionModelChange, bulkActions, selectionSummary, rowActions, sort: sortProp, defaultSort, onSortChange, onQueryChange, manualSorting, paginated: paginatedProp, paginationMode, rowCount, page: controlledPage, pageSize: controlledPageSize, onPageChange, onPageSizeChange, defaultPageSize, pageSizeOptions, density: densityProp, defaultDensity, onDensityChange, showDensityToggle, showColumnMenu, loading, loadingRows, emptyState, groupBy, groupLabel, collapsibleGroups, collapsedGroups: collapsedProp, defaultCollapsedGroups, onCollapsedGroupsChange, onGroupByChange, hiddenColumns: hiddenProp, onHiddenColumnsChange, resizable, columnWidths: widthsProp, defaultColumnWidths, onColumnWidthsChange, pinnedColumns: pinnedProp, defaultPinnedColumns, onPinnedColumnsChange, showPinMenu, virtualize, virtualizeThreshold, rowHeight: rowHeightProp, virtualContainerClassName, onCellEdit, views: viewsProp, defaultViews, onViewsChange, activeViewId, defaultActiveViewId, onActiveViewChange, showViewSwitcher, filters, onFiltersChange, toolbar, csvExport, onExport, className, labels }: DataTableProps<T>): import("react").JSX.Element;
2683
3019
  //#endregion
2684
- //#region src/scheduling/WeekCalendar/WeekCalendar.d.ts
2685
- export interface WeekCalendarProps {
2686
- events?: ScheduleEvent[];
2687
- /** First weekday; defaults to the provider or runtime locale. */
2688
- weekStartsOn?: WeekDay;
2689
- /** Clock used for events and hour labels; defaults to the provider or runtime locale. */
2690
- hourCycle?: HourCycle;
2691
- /** The app's "today" (the block never reads the clock). */
2692
- today?: Date;
2693
- /** Current time for the "now" line, shown when it falls in the visible week. Defaults to `today`. */
2694
- now?: Date;
2695
- /** A date inside the week shown first (uncontrolled). Defaults to `today`. */
2696
- defaultWeek?: Date;
2697
- /** Called with the first day of the newly shown week. */
2698
- onWeekChange?: (weekStart: Date) => void;
2699
- /** Makes events buttons. */
2700
- onEventClick?: (event: ScheduleEvent) => void;
2701
- kinds?: Record<string, EventKind>;
2702
- /** Hour the grid scrolls to on mount. */
2703
- scrollToHour?: number;
2704
- /** Pixels per hour. */
2705
- hourHeight?: number;
2706
- /** Max height of the scrolling time grid in px. */
2707
- height?: number;
2708
- actions?: ReactNode;
2709
- className?: string;
3020
+ //#region src/tables/LoadMoreFooter/LoadMoreFooter.d.ts
3021
+ export interface LoadMoreFooterLabels {
3022
+ loadMore: string;
3023
+ loading: string;
3024
+ retry: string;
3025
+ group: string;
3026
+ moreAvailable: string;
3027
+ summary: (count: number) => string;
3028
+ loadedAnnouncement: (count: number) => string;
2710
3029
  }
2711
- /** Week view: seven day columns over a scrolling 24-hour time grid, with a "now" line. */
2712
- export declare function WeekCalendar({ events, weekStartsOn: weekStartsOnProp, hourCycle: hourCycleProp, today, now, defaultWeek, onWeekChange, onEventClick, kinds, scrollToHour, hourHeight, height, actions, className }: WeekCalendarProps): import("react").JSX.Element;
2713
- //#endregion
2714
- //#region src/scheduling/WeekCalendar/block.meta.d.ts
2715
- declare const meta$77: BlockMeta;
2716
- //#endregion
2717
- //#region src/scheduling/AgendaList/AgendaList.d.ts
2718
- export interface AgendaListProps {
2719
- events?: ScheduleEvent[];
2720
- /** Clock used for event ranges; defaults to the provider or runtime locale. */
2721
- hourCycle?: HourCycle;
2722
- /** The app's "today": labels the Today/Tomorrow groups. */
2723
- today?: Date;
2724
- /** Only events on or after this day. Defaults to `today`; pass null for all. */
2725
- from?: Date | null;
2726
- /** Number of days shown from `from`. Default 7; null for no limit. */
2727
- days?: number | null;
2728
- /** Makes each row a button. */
2729
- onEventClick?: (event: ScheduleEvent) => void;
2730
- kinds?: Record<string, EventKind>;
2731
- title?: string;
2732
- /** Max height of the scrolling list in px. */
2733
- maxHeight?: number;
2734
- emptyTitle?: string;
2735
- emptyDescription?: string;
2736
- /** Heading level of the title, to fit the page outline (default h3); inner headings use the next level. */
2737
- titleAs?: 'h2' | 'h3' | 'h4';
3030
+ /**
3031
+ * Each attempt must settle in one update: loading=false together with its result
3032
+ * (error, or an empty error on success). Split settles are unsupported.
3033
+ */
3034
+ export interface LoadMoreFooterProps {
3035
+ /** Undefined selects flag mode; null or an empty string exhausts cursor mode. */
3036
+ nextCursor?: string | null;
3037
+ hasMore?: boolean;
3038
+ loading?: boolean;
3039
+ error?: string;
3040
+ onLoadMore?: (cursor?: string) => void;
3041
+ onRetry?: (cursor?: string) => void;
3042
+ loadedCount?: number;
3043
+ /** Increasing sequence for successful appends only; leave unchanged on replacement or failure. */
3044
+ lastAppend?: {
3045
+ seq: number;
3046
+ count: number;
3047
+ };
3048
+ exhaustedFocusTarget?: 'summary' | 'root';
3049
+ labels?: Partial<LoadMoreFooterLabels>;
2738
3050
  className?: string;
2739
3051
  }
2740
- /** Upcoming scheduled work grouped by day, each row with a kind tile, time range and location. */
2741
- export declare function AgendaList({ events, hourCycle: hourCycleProp, today, from, days, onEventClick, kinds, title: titleProp, maxHeight, emptyTitle: emptyTitleProp, emptyDescription: emptyDescriptionProp, titleAs: TitleTag, className }: AgendaListProps): import("react").JSX.Element;
2742
- //#endregion
2743
- //#region src/scheduling/AgendaList/block.meta.d.ts
2744
- declare const meta$2: BlockMeta;
3052
+ /**
3053
+ * Load more for appended lists without a total or page count. The consumer owns rows and requests.
3054
+ * With no props, renders a static catalogue preview using fixture data. Supplying any prop selects
3055
+ * the consumer contract: undefined nextCursor means flag mode and requires hasMore=true.
3056
+ * loadedCount defaults to the preview fixture; consumers should pass their actual loaded count.
3057
+ */
3058
+ export declare function LoadMoreFooter(props?: LoadMoreFooterProps): import("react").JSX.Element;
2745
3059
  //#endregion
2746
- //#region src/scheduling/TimeSlotPicker/TimeSlotPicker.d.ts
2747
- export interface TimeSlot {
2748
- /** Submitted value, e.g. "09:30". */
2749
- value: string;
2750
- /** Visible label. Defaults to `value`. */
2751
- label?: string;
2752
- /** Taken slots render struck through and disabled. Default true. */
2753
- available?: boolean;
3060
+ //#region src/hooks/useTableData.d.ts
3061
+ /** One server query. Pages are 1-based; cursor is null for the first cursor page. */
3062
+ interface TableDataParams<F = unknown> {
3063
+ page: number;
3064
+ pageSize: number;
3065
+ sort: SortState | null;
3066
+ filters: F | undefined;
3067
+ cursor: string | null;
3068
+ signal: AbortSignal;
2754
3069
  }
2755
- export interface TimeSlotPickerProps {
2756
- slots?: TimeSlot[];
2757
- /** Controlled value. */
2758
- value?: string | null;
2759
- /** Uncontrolled initial value. */
2760
- defaultValue?: string | null;
2761
- onValueChange?: (value: string) => void;
2762
- /** Group label (the fieldset legend). */
2763
- legend?: string;
2764
- /** Secondary line under the legend, e.g. the chosen date. */
2765
- description?: string;
2766
- /** Form field name. */
2767
- name?: string;
2768
- /** Slot columns from the `sm` breakpoint (two on small screens). */
2769
- columns?: 2 | 3 | 4 | 6;
2770
- /** Max height of the scrolling slot list in px. */
2771
- maxHeight?: number;
2772
- className?: string;
3070
+ /** A numbered page supplies rowCount; a cursor page supplies nextCursor (null means exhausted). */
3071
+ interface TableDataResult<T> {
3072
+ rows: T[];
3073
+ rowCount?: number;
3074
+ nextCursor?: string | null;
3075
+ }
3076
+ /** Per-instance server data options. Filters must support JSON.stringify. */
3077
+ interface UseTableDataOptions<T, F = unknown> {
3078
+ getRows: (params: TableDataParams<F>) => Promise<TableDataResult<T>>;
3079
+ /** Initial numbered page, 1-based (default 1). */
3080
+ initialPage?: number;
3081
+ /** Rows per request (default 20). */
3082
+ initialPageSize?: number;
3083
+ /** Initial server order (default null). */
3084
+ initialSort?: SortState | null;
3085
+ /** Compared by JSON.stringify value, including object key order. */
3086
+ filters?: F;
3087
+ /** Freshness in milliseconds (30000); zero disables cache reads and writes. */
3088
+ cacheTime?: number;
3089
+ /** Retain the last resolved page while fetching (default true). */
3090
+ keepPreviousData?: boolean;
3091
+ /** Foreground polling in milliseconds (zero, the default, disables it). */
3092
+ revalidateInterval?: number;
3093
+ /** False aborts work and clears loading (default true). */
3094
+ enabled?: boolean;
3095
+ /** Called once per current non-abort failure; nullish reasons become an Error. */
3096
+ onError?: (error: unknown) => void;
3097
+ }
3098
+ type Query<F> = Omit<TableDataParams<F>, 'signal'>;
3099
+ type TableProps<T> = Required<Pick<DataTableProps<T>, 'rows' | 'paginationMode' | 'rowCount' | 'page' | 'pageSize' | 'onPageChange' | 'onPageSizeChange' | 'sort' | 'onSortChange' | 'onQueryChange' | 'manualSorting' | 'loading' | 'filters'>> & {
3100
+ paginationMode: 'server';
3101
+ };
3102
+ interface Snapshot<T> {
3103
+ rows: T[];
3104
+ rowCount: number;
3105
+ nextCursor: string | null | undefined;
3106
+ page: number;
3107
+ pageSize: number;
3108
+ sort: SortState | null;
3109
+ isLoading: boolean;
3110
+ isFetching: boolean;
3111
+ footerLoading: boolean;
3112
+ error: unknown;
3113
+ lastAppend: {
3114
+ seq: number;
3115
+ count: number;
3116
+ };
3117
+ }
3118
+ /** Data and props for a server DataTable; params describes the requested page, including while old rows remain. */
3119
+ interface UseTableDataResult<T, F = unknown> extends Omit<Snapshot<T>, 'footerLoading'> {
3120
+ /** Requested values; the AbortSignal is passed only to getRows. */
3121
+ params: Query<F>;
3122
+ tableProps: TableProps<T>;
3123
+ loadMoreProps: LoadMoreFooterProps;
3124
+ hasMore: boolean;
3125
+ /** Append the next cursor page; after a failure, retry the query before loading more. */
3126
+ loadMore: () => void;
3127
+ /** Bypass cache freshness and replace active work; cursor lists restart at the first page. */
3128
+ refetch: () => void;
3129
+ /** Clear this instance's cache and refetch. */
3130
+ invalidate: () => void;
2773
3131
  }
2774
3132
  /**
2775
- * Pick one time slot. Native radio semantics: Tab enters the group, arrow keys move and select,
2776
- * taken slots are disabled.
3133
+ * Map committed table queries to abortable requests. Callback identities do not trigger requests.
3134
+ * Spread tableProps into DataTable; use paginated={false} and loadMoreProps for cursor lists.
3135
+ * Available from the npm package only (not the copy-install registry).
2777
3136
  */
2778
- export declare function TimeSlotPicker({ slots, value, defaultValue, onValueChange, legend: legendProp, description, name, columns, maxHeight, className }: TimeSlotPickerProps): import("react").JSX.Element;
2779
- //#endregion
2780
- //#region src/scheduling/TimeSlotPicker/block.meta.d.ts
2781
- declare const meta$72: BlockMeta;
2782
- //#endregion
2783
- //#region src/scheduling/TimeSlotPicker/fixtures.d.ts
2784
- /** Half-hour slots from 09:00 to 21:00 with a few already taken. */
2785
- export declare const sampleTimeSlots: TimeSlot[];
2786
- //#endregion
2787
- //#region src/scheduling/shared/fixtures.d.ts
2788
- /** The sample calendar's "today" (Wed 15 Apr 2026, 10:20). Pass your own `today` in apps. */
2789
- declare const sampleToday: Date;
2790
- /** Sample scheduled work for April 2026 (jobs, deploys, reviews, backups, maintenance). */
2791
- declare const sampleEvents: ScheduleEvent[];
3137
+ export declare function useTableData<T, F = unknown>(options: UseTableDataOptions<T, F>): UseTableDataResult<T, F>;
2792
3138
  //#endregion
2793
- //#region src/shell/AppSidebar/fixtures.d.ts
2794
- export declare const appSidebarNavGroups: NavGroup[];
2795
- export declare const appSidebarWorkspaces: Workspace[];
2796
- export interface AppSidebarUsage {
3139
+ //#region src/marketing/actions.d.ts
3140
+ type IconComponent = ComponentType<{
3141
+ size?: number;
3142
+ 'aria-hidden'?: boolean;
3143
+ }>;
3144
+ /** A call to action: a link when `href` is set, otherwise a button. */
3145
+ interface MarketingAction {
2797
3146
  label: string;
2798
- value: number;
2799
- max: number;
2800
- /** Formatted value, e.g. "8.2k / 10k requests". */
2801
- valueLabel?: string;
3147
+ href?: string;
3148
+ onClick?: () => void;
3149
+ /** Trailing icon (lucide component). */
3150
+ icon?: IconComponent;
2802
3151
  }
2803
- export declare const appSidebarUsage: AppSidebarUsage;
2804
- export declare const appSidebarUser: UserMenuUser;
2805
3152
  //#endregion
2806
- //#region src/shell/AppSidebar/AppSidebar.d.ts
2807
- export interface AppSidebarHeaderProps {
2808
- /** Icon rail: shows only the brand mark. */
2809
- collapsed?: boolean;
2810
- /** Workspaces for the switcher; `null` shows the logo + wordmark instead. */
2811
- workspaces?: Workspace[] | null;
2812
- currentWorkspaceId?: string;
2813
- onWorkspaceChange?: (workspace: Workspace) => void;
2814
- onCreateWorkspace?: () => void;
3153
+ //#region src/marketing/Hero/Hero.d.ts
3154
+ export interface HeroProps {
3155
+ /** `centered` (copy over the media) or `split` (copy left, media right from `lg`). */
3156
+ variant?: 'centered' | 'split';
3157
+ /** Small label above the title. */
3158
+ eyebrow?: ReactNode;
3159
+ title?: ReactNode;
3160
+ description?: ReactNode;
3161
+ primaryAction?: MarketingAction | null;
3162
+ secondaryAction?: MarketingAction | null;
3163
+ /** Screenshot slot. Defaults to a neutral app-window placeholder; null hides it. */
3164
+ media?: ReactNode;
3165
+ /** Heading level of the title. */
3166
+ headingLevel?: 'h1' | 'h2';
2815
3167
  className?: string;
2816
3168
  }
2817
- /** Sidebar top: workspace switcher (or the brand logo), the brand mark alone in the icon rail. */
2818
- export declare function AppSidebarHeader({ collapsed, workspaces, currentWorkspaceId, onWorkspaceChange, onCreateWorkspace, className }: AppSidebarHeaderProps): import("react").JSX.Element;
2819
- export interface AppSidebarNavProps {
2820
- groups?: NavGroup[];
2821
- currentHref?: string;
2822
- collapsed?: boolean;
2823
- /** Accessible name of the nav landmark. */
2824
- label?: string;
2825
- onNavigate?: (item: NavItem) => void;
3169
+ /** Neutral app-window placeholder for the screenshot slot (decorative). */
3170
+ export declare function HeroScreenshotPlaceholder({ className }: {
2826
3171
  className?: string;
3172
+ }): import("react").JSX.Element;
3173
+ /** Landing hero: eyebrow, title, description, two calls to action and a screenshot slot. */
3174
+ export declare function Hero({ variant, eyebrow, title, description, primaryAction, secondaryAction, media, headingLevel: Heading, className }: HeroProps): import("react").JSX.Element;
3175
+ //#endregion
3176
+ //#region src/marketing/Hero/block.meta.d.ts
3177
+ declare const meta$33: BlockMeta;
3178
+ //#endregion
3179
+ //#region src/marketing/FeatureGrid/FeatureGrid.d.ts
3180
+ export interface Feature {
3181
+ icon: LucideIcon;
3182
+ title: string;
3183
+ description: ReactNode;
2827
3184
  }
2828
- /** Sidebar body: the NavList (icon rail with tooltips when collapsed). */
2829
- export declare function AppSidebarNav({ groups, currentHref, collapsed, label, onNavigate, className }: AppSidebarNavProps): import("react").JSX.Element;
2830
- export interface AppSidebarFooterProps {
2831
- collapsed?: boolean;
2832
- /** Plan usage meter; `null` hides it. */
2833
- usage?: AppSidebarUsage | null;
2834
- /** Help link; `null` hides it. */
2835
- helpHref?: string | null;
2836
- helpLabel?: string;
2837
- /** Signed-in user; `null` hides the user menu. */
2838
- user?: UserMenuUser | null;
2839
- userMenuItems?: UserMenuEntry[];
2840
- onSignOut?: () => void;
3185
+ export interface FeatureGridProps {
3186
+ features?: Feature[];
3187
+ eyebrow?: ReactNode;
3188
+ title?: ReactNode;
3189
+ description?: ReactNode;
3190
+ /** Columns from `lg` (one column on phones, two on tablets). */
3191
+ columns?: 2 | 3 | 4;
3192
+ /** Heading level of the section title; feature titles use the next level. */
3193
+ headingLevel?: 'h2' | 'h3';
2841
3194
  className?: string;
2842
3195
  }
2843
- /** Sidebar bottom: usage meter, help link and the user menu (avatar only in the icon rail). */
2844
- export declare function AppSidebarFooter({ collapsed, usage, helpHref, helpLabel, user, userMenuItems, onSignOut, className }: AppSidebarFooterProps): import("react").JSX.Element;
2845
- export interface AppSidebarProps extends AppSidebarHeaderProps, Omit<AppSidebarNavProps, 'className' | 'groups' | 'label'>, Omit<AppSidebarFooterProps, 'className'> {
2846
- navGroups?: NavGroup[];
2847
- navLabel?: string;
2848
- }
2849
- /**
2850
- * Complete application sidebar column (chrome surface): workspace switcher header, NavList body
2851
- * and a footer with usage, help and the user menu. Inside SidebarLayout, use the parts
2852
- * (AppSidebarHeader / AppSidebarNav / AppSidebarFooter) in its three slots.
2853
- */
2854
- export declare function AppSidebar({ collapsed, workspaces, currentWorkspaceId, onWorkspaceChange, onCreateWorkspace, navGroups, navLabel, currentHref, onNavigate, usage, helpHref, helpLabel, user, userMenuItems, onSignOut, className }: AppSidebarProps): import("react").JSX.Element;
3196
+ /** Features section: a heading block over a grid of icon + title + description. */
3197
+ export declare function FeatureGrid({ features, eyebrow, title, description, columns, headingLevel: Heading, className }: FeatureGridProps): import("react").JSX.Element;
2855
3198
  //#endregion
2856
- //#region src/shell/AppSidebar/block.meta.d.ts
2857
- declare const meta$3: BlockMeta;
3199
+ //#region src/marketing/FeatureGrid/block.meta.d.ts
3200
+ declare const meta$26: BlockMeta;
2858
3201
  //#endregion
2859
- //#region src/shell/EnvironmentBadge/EnvironmentBadge.d.ts
2860
- export type EnvironmentTone = 'primary' | 'warning' | 'info' | 'neutral' | 'destructive';
2861
- /** Default tone per environment name; anything else is neutral. */
2862
- export declare const environmentTones: Record<string, EnvironmentTone>;
2863
- export interface EnvironmentBadgeProps {
2864
- /** Environment name, e.g. `production`, `staging`, `preview`. */
2865
- environment?: string;
2866
- /** Region or cluster shown after the environment, e.g. `eu-west`; `null` hides it. */
2867
- region?: string | null;
2868
- /** Overrides the tone looked up from `environmentTones`. */
2869
- tone?: EnvironmentTone;
2870
- /** Prefix read by screen readers only. */
2871
- srLabel?: string;
2872
- className?: string;
2873
- }
2874
- /** Environment + region chip for the topbar or a page header: "production · eu-west". */
2875
- export declare function EnvironmentBadge({ environment, region, tone, srLabel, className }: EnvironmentBadgeProps): import("react").JSX.Element;
3202
+ //#region src/marketing/FeatureGrid/fixtures.d.ts
3203
+ /** Sample product-agnostic features. */
3204
+ export declare const sampleFeatures: Feature[];
2876
3205
  //#endregion
2877
- //#region src/shell/AppTopbar/AppTopbar.d.ts
2878
- export interface AppTopbarProps {
2879
- /** Location trail; `null` hides it. */
2880
- breadcrumbs?: BreadcrumbItem[] | null;
2881
- /** Replaces the breadcrumb (custom title, tabs…). */
2882
- breadcrumb?: ReactNode;
2883
- /** Environment chip after the breadcrumb; `null` hides it. */
2884
- environment?: EnvironmentBadgeProps | null;
2885
- /** Search control; defaults to GlobalSearch (⌘K). `null` hides it. */
2886
- search?: ReactNode;
2887
- /** Notifications; `null` hides the bell. */
2888
- notifications?: NotificationItem[] | null;
2889
- onNotificationSelect?: (notification: NotificationItem) => void;
2890
- onMarkAllRead?: () => void;
2891
- /** Theme control: a one-button cycle, the segmented switcher, or none. */
2892
- theme?: 'cycle' | 'segmented' | null;
2893
- /** Signed-in user; `null` hides the user menu. */
2894
- user?: UserMenuUser | null;
2895
- userMenuItems?: UserMenuEntry[];
2896
- onSignOut?: () => void;
3206
+ //#region src/marketing/PricingTable/PricingTable.d.ts
3207
+ export type PricingCycle = 'monthly' | 'annual';
3208
+ export interface PricingTier {
3209
+ id: string;
3210
+ name: string;
3211
+ description?: string;
3212
+ /** Price per month on monthly billing; null shows "Custom". */
3213
+ priceMonthly: number | null;
3214
+ /** Price per month on annual billing; null shows "Custom". */
3215
+ priceAnnual: number | null;
3216
+ /** Call-to-action label. */
3217
+ cta: string;
3218
+ features: string[];
3219
+ /** Emphasised with a primary border (no colour fill). */
3220
+ highlighted?: boolean;
3221
+ /** Label on the tier, e.g. "Most popular". */
3222
+ badge?: string;
3223
+ }
3224
+ export interface PricingTableProps {
3225
+ tiers?: PricingTier[];
3226
+ eyebrow?: ReactNode;
3227
+ title?: ReactNode;
3228
+ description?: ReactNode;
3229
+ currency?: string;
3230
+ defaultCycle?: PricingCycle;
3231
+ onCycleChange?: (cycle: PricingCycle) => void;
3232
+ /** Called with the tier and the cycle shown when a CTA is activated. */
3233
+ onSelectTier?: (tier: PricingTier, cycle: PricingCycle) => void;
3234
+ /** Note next to the annual option, e.g. "Save 20%". */
3235
+ annualNote?: string;
3236
+ /** Level of the section title; tier names use the next level (or this one when there is no title). */
3237
+ headingLevel?: 'h2' | 'h3';
3238
+ /** Shows the monthly/annual toggle (default true). */
3239
+ showCycleToggle?: boolean;
3240
+ /** Columns at the widest breakpoint (default: one per tier, up to 4). */
3241
+ columns?: 1 | 2 | 3 | 4;
3242
+ /** Names the tier list / radio group when `title` is null (the block then renders no landmark), e.g. inside a wizard step. */
3243
+ 'aria-label'?: string;
3244
+ /** Id of an external heading that names the section when `title` is null. */
3245
+ 'aria-labelledby'?: string;
3246
+ /**
3247
+ * Id of the tier the account is on: its card gets a "Current plan" badge and
3248
+ * `aria-current`, and its CTA becomes a disabled "Current plan" button.
3249
+ */
3250
+ currentTierId?: string;
3251
+ /** Label of the current tier's badge and disabled CTA. */
3252
+ currentPlanLabel?: string;
3253
+ /**
3254
+ * Turns the tiers into a single-choice radio group (role radiogroup/radio, arrow keys,
3255
+ * selected card with a primary border and a check). CTAs are not rendered in this mode.
3256
+ */
3257
+ selectable?: boolean;
3258
+ /** Selected tier id (controlled, `selectable` only). */
3259
+ value?: string;
3260
+ /** Initially selected tier id (uncontrolled, `selectable` only). */
3261
+ defaultValue?: string;
3262
+ /** Called with the newly selected tier id (`selectable` only). */
3263
+ onValueChange?: (value: string) => void;
2897
3264
  className?: string;
2898
3265
  }
2899
- /**
2900
- * Topbar contents: breadcrumb (+ environment chip) on the left; ⌘K search, notifications, theme
2901
- * and user menu on the right. Renders no <header>: put it in SidebarLayout's `topbar` slot or a
2902
- * header of your own.
2903
- */
2904
- export declare function AppTopbar({ breadcrumbs, breadcrumb, environment, search, notifications, onNotificationSelect, onMarkAllRead, theme, user, userMenuItems, onSignOut, className }: AppTopbarProps): import("react").JSX.Element;
2905
- //#endregion
2906
- //#region src/shell/AppTopbar/fixtures.d.ts
2907
- export declare const appTopbarBreadcrumbs: BreadcrumbItem[];
2908
- export declare const appTopbarNotifications: NotificationItem[];
3266
+ /** Pricing section: tiers with a monthly/annual toggle, a highlighted tier and a feature checklist. */
3267
+ export declare function PricingTable({ tiers, eyebrow, title, description, currency, defaultCycle, onCycleChange, onSelectTier, annualNote, headingLevel: Heading, showCycleToggle, columns, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, currentTierId, currentPlanLabel, selectable, value, defaultValue, onValueChange, className }: PricingTableProps): import("react").JSX.Element;
2909
3268
  //#endregion
2910
- //#region src/shell/AppTopbar/block.meta.d.ts
2911
- declare const meta$4: BlockMeta;
3269
+ //#region src/marketing/PricingTable/block.meta.d.ts
3270
+ declare const meta$54: BlockMeta;
2912
3271
  //#endregion
2913
- //#region src/shell/EnvironmentBadge/block.meta.d.ts
2914
- declare const meta$22: BlockMeta;
3272
+ //#region src/marketing/PricingTable/fixtures.d.ts
3273
+ /** Sample three-tier pricing. Prices are per month; annual is per month billed yearly. */
3274
+ export declare const samplePricingTiers: PricingTier[];
2915
3275
  //#endregion
2916
- //#region src/shell/GlobalSearch/GlobalSearch.d.ts
2917
- export type GlobalSearchGroup = 'pages' | 'records' | 'actions' | 'recent';
2918
- export interface GlobalSearchProps {
2919
- pages?: CommandItem[];
2920
- records?: CommandItem[];
2921
- actions?: CommandItem[];
2922
- /** Shown first while the query is empty. */
2923
- recent?: CommandItem[];
2924
- /** Called with every chosen item and the group it came from (after the item's own onSelect). */
2925
- onSelect?: (item: CommandItem, group: GlobalSearchGroup) => void;
2926
- /** Group headings. */
2927
- labels?: Partial<Record<GlobalSearchGroup, string>>;
2928
- /** Registers ⌘K / Ctrl+K. */
2929
- shortcut?: boolean;
2930
- open?: boolean;
2931
- defaultOpen?: boolean;
2932
- onOpenChange?: (open: boolean) => void;
2933
- placeholder?: string;
2934
- /** Text of the trigger button. */
2935
- triggerLabel?: string;
2936
- /** Classes for the trigger (e.g. `hidden md:inline-flex`). */
3276
+ //#region src/marketing/Faq/Faq.d.ts
3277
+ export interface FaqItem {
3278
+ id: string;
3279
+ question: string;
3280
+ answer: ReactNode;
3281
+ }
3282
+ export interface FaqProps {
3283
+ items?: FaqItem[];
3284
+ title?: ReactNode;
3285
+ description?: ReactNode;
3286
+ /** `stacked` (heading over the list) or `split` (heading left from `lg`). */
3287
+ layout?: 'stacked' | 'split';
3288
+ /** Ids of the items open on mount. */
3289
+ defaultOpen?: string[];
3290
+ /** Allow several items open at once. */
3291
+ multiple?: boolean;
3292
+ headingLevel?: 'h2' | 'h3';
2937
3293
  className?: string;
2938
3294
  }
2939
- /** ⌘K search: a CommandPalette pre-wired with recent items and Pages / Records / Actions groups. */
2940
- export declare function GlobalSearch({ pages, records, actions, recent, onSelect, labels, shortcut, open, defaultOpen, onOpenChange, placeholder: placeholderProp, triggerLabel: triggerLabelProp, className }: GlobalSearchProps): import("react").JSX.Element;
3295
+ /** Frequently asked questions in an accordion, with a heading block. */
3296
+ export declare function Faq({ items, title, description, layout, defaultOpen, multiple, headingLevel: Heading, className }: FaqProps): import("react").JSX.Element;
2941
3297
  //#endregion
2942
- //#region src/shell/GlobalSearch/fixtures.d.ts
2943
- export declare const globalSearchPages: CommandItem[];
2944
- export declare const globalSearchRecords: CommandItem[];
2945
- export declare const globalSearchActions: CommandItem[];
2946
- export declare const globalSearchRecent: CommandItem[];
3298
+ //#region src/marketing/Faq/block.meta.d.ts
3299
+ declare const meta$25: BlockMeta;
2947
3300
  //#endregion
2948
- //#region src/shell/GlobalSearch/block.meta.d.ts
2949
- declare const meta$32: BlockMeta;
3301
+ //#region src/marketing/Faq/fixtures.d.ts
3302
+ /** Sample product-agnostic questions. */
3303
+ export declare const sampleFaqs: FaqItem[];
2950
3304
  //#endregion
2951
- //#region src/tables/DataTable/data-table-utils.d.ts
2952
- export type SortDirectionValue = 'ascending' | 'descending';
2953
- export type CellValue = string | number | boolean | Date | null | undefined;
2954
- export type DataTableColumnVariant = 'default' | 'mono' | 'muted' | 'numeric';
2955
- /** Body-cell classes of each column variant. */
2956
- export declare const COLUMN_VARIANT_CLASSES: Record<DataTableColumnVariant, string>;
2957
- /** Effective alignment of a column (numeric columns default to right). */
2958
- export declare function columnAlign<T>(column: DataTableColumn<T>): DataTableColumn<T>['align'];
2959
- /** One typed column of a DataTable. */
2960
- export interface DataTableColumn<T> {
2961
- /** Stable key (sorting, visibility). */
3305
+ //#region src/marketing/ComparisonTable/ComparisonTable.d.ts
3306
+ /** A plan or option: one column of the comparison. */
3307
+ export interface ComparisonPlan {
2962
3308
  id: string;
2963
- /** Header text; also the column's name in the visibility menu. */
2964
- header: string;
2965
- /** Raw value: used to sort, and rendered when `cell` is absent. */
2966
- accessor?: (row: T) => CellValue;
2967
- /** Custom cell rendering. */
2968
- cell?: (row: T) => ReactNode;
2969
- sortable?: boolean;
2970
- align?: 'left' | 'right' | 'center';
2971
- /** Can be hidden from the column menu (default true). */
2972
- hideable?: boolean;
2973
- /** Hidden until turned on in the column menu. */
2974
- defaultHidden?: boolean;
2975
- /**
2976
- * Presentational preset for the body cells: `mono` (monospace ids, regions), `muted`
2977
- * (secondary text), `numeric` (monospace tabular figures, right-aligned unless `align` is set).
2978
- */
2979
- variant?: DataTableColumnVariant;
2980
- /** Classes for the body cells (merged after the variant's). */
2981
- className?: string;
2982
- /** Classes for the header cell (e.g. a width). */
2983
- headClassName?: string;
2984
- /** Initial width in px (resizable or pinned tables; default 160). */
2985
- width?: number;
2986
- /** Smallest width a resize can reach (default 60). */
2987
- minWidth?: number;
2988
- /** Largest width a resize can reach (default 640). */
2989
- maxWidth?: number;
2990
- /** Shows a resize handle when the table is `resizable` (default true). */
2991
- resizable?: boolean;
2992
- /** Can be pinned from the column menu (default true). */
2993
- pinnable?: boolean;
2994
- /** Inline editing: Enter or F2 on the cell edits it (needs `onCellEdit` on the table). */
2995
- editable?: boolean | ((row: T) => boolean);
2996
- /** Editor of an editable cell (default a text input). */
2997
- editor?: DataTableCellEditor;
2998
- /** Value the editor starts from (default the accessor's value). */
2999
- editValue?: (row: T) => string | number | null | undefined;
3309
+ name: string;
3310
+ /** Headline price or figure under the name ("$49", "Custom"). */
3311
+ price?: ReactNode;
3312
+ /** Small text after the price ("per month"). */
3313
+ priceNote?: ReactNode;
3314
+ /** Call to action under the price. */
3315
+ cta?: MarketingAction;
3000
3316
  }
3001
- /** Editor of an editable column. */
3002
- export type DataTableCellEditor = {
3003
- type: 'text';
3004
- placeholder?: string;
3005
- } | {
3006
- type: 'number';
3007
- min?: number;
3008
- max?: number;
3009
- step?: number;
3010
- } | {
3011
- type: 'select';
3012
- options: ReadonlyArray<{
3013
- value: string;
3014
- label: string;
3015
- }>;
3317
+ /** A plain value, or a value with a short note under it ("Add-on"). */
3318
+ export type ComparisonValue = boolean | string | number | null | undefined | {
3319
+ value: boolean | string | number | null;
3320
+ note?: string;
3016
3321
  };
3017
- export interface SortState {
3018
- columnId: string;
3019
- direction: SortDirectionValue;
3322
+ export interface ComparisonFeature {
3323
+ id: string;
3324
+ label: string;
3325
+ /** Muted text under the label. */
3326
+ description?: string;
3327
+ /** Value per plan id. Missing / null values render like `false` (a dash, "Not included"). */
3328
+ values: Readonly<Record<string, ComparisonValue>>;
3020
3329
  }
3021
- /** Compares two cell values: nulls last, numbers and dates numerically, strings with localeCompare (numeric). */
3022
- export declare function compareValues(a: CellValue, b: CellValue): number;
3023
- /** Client-side sort (stable). Returns the input order when there is no sort or the column has no accessor. */
3024
- export declare function sortRows<T>(rows: readonly T[], columns: ReadonlyArray<DataTableColumn<T>>, sort: SortState | null): T[];
3025
- /** Number of pages for a row count (at least 1). */
3026
- export declare function pageCountOf(total: number, pageSize: number): number;
3027
- /** Client-side pagination: the rows of a 1-based page (clamped to the valid range). */
3028
- export declare function paginate<T>(rows: readonly T[], page: number, pageSize: number): T[];
3029
- /** Header checkbox state for the rows on screen. */
3030
- export declare function selectionState(visibleIds: readonly string[], selected: ReadonlySet<string>): {
3031
- checked: boolean;
3032
- indeterminate: boolean;
3033
- };
3034
- /** Selects all of `ids` when not all are selected; otherwise clears them. Other selections are kept. */
3035
- export declare function toggleAll(ids: readonly string[], selected: ReadonlySet<string>): Set<string>;
3036
- export declare function toggleOne(id: string, selected: ReadonlySet<string>): Set<string>;
3037
- /** Optional locale and boolean text for default cells. */
3038
- export interface DataTableCellFormatOptions {
3039
- locale?: string;
3040
- booleanLabels?: [trueLabel: string, falseLabel: string];
3330
+ export interface ComparisonSection {
3331
+ id: string;
3332
+ title: string;
3333
+ features: ComparisonFeature[];
3041
3334
  }
3042
- /** Default cell text for a raw value. Omitting options preserves the legacy output. */
3043
- export declare function formatCell(value: CellValue, options?: DataTableCellFormatOptions): ReactNode;
3044
- /** Groups rows by a field key or by a function returning the group key. */
3045
- export type DataTableGroupBy<T> = Extract<keyof T, string> | ((row: T) => string | number | null | undefined);
3046
- /** One group of rows, in display order. */
3047
- export interface DataTableGroup<T> {
3048
- /** Group key (`''` for rows without a value). */
3049
- key: string;
3050
- rows: T[];
3335
+ export interface ComparisonTableProps {
3336
+ plans?: ComparisonPlan[];
3337
+ sections?: ComparisonSection[];
3338
+ /** Plan column marked as recommended: badge text, a primary top rule and a tinted column. */
3339
+ highlightedPlanId?: string;
3340
+ /** Text of the recommended badge (default "Recommended"). */
3341
+ highlightLabel?: string;
3342
+ eyebrow?: ReactNode;
3343
+ title?: ReactNode;
3344
+ description?: ReactNode;
3345
+ /** Level of the section title (default h2). */
3346
+ headingLevel?: 'h2' | 'h3';
3347
+ /** Table name (screen-reader caption). Default: the title when it is a string, else "Plan comparison". */
3348
+ caption?: string;
3349
+ /** Header of the feature column (screen-reader only unless `showFeatureHeader`). */
3350
+ featureHeader?: string;
3351
+ showFeatureHeader?: boolean;
3352
+ /** Screen-reader text of `true` (default "Included"). */
3353
+ includedLabel?: string;
3354
+ /** Screen-reader text of `false` / missing values (default "Not included"). */
3355
+ notIncludedLabel?: string;
3356
+ /** Formats numeric values (default: en-US grouping). */
3357
+ formatNumber?: (value: number, feature: ComparisonFeature) => string;
3358
+ className?: string;
3051
3359
  }
3052
- /** Group key of a row (`''` when the value is null or undefined). */
3053
- export declare function groupKeyOf<T>(row: T, groupBy: DataTableGroupBy<T>): string;
3054
3360
  /**
3055
- * Splits rows into groups, keeping the row order inside each group. Groups follow `order` (the
3056
- * keys' first appearance in it, e.g. the unsorted input) and then any key not seen there.
3361
+ * Feature comparison of plans or options: columns are plans, rows are features grouped by section.
3362
+ * Booleans render as a check or a dash with screen-reader text; text and numbers render as is. The
3363
+ * table scrolls sideways on narrow screens with the feature column pinned.
3057
3364
  */
3058
- export declare function groupRows<T>(rows: readonly T[], groupBy: DataTableGroupBy<T>, order?: readonly T[]): DataTableGroup<T>[];
3365
+ export declare function ComparisonTable({ plans, sections, highlightedPlanId, highlightLabel, eyebrow, title, description, headingLevel: Heading, caption, featureHeader, showFeatureHeader, includedLabel, notIncludedLabel, formatNumber, className }: ComparisonTableProps): import("react").JSX.Element;
3059
3366
  //#endregion
3060
- //#region src/tables/DataTable/column-sizing.d.ts
3061
- /** Column widths in px by column id. */
3062
- type ColumnWidths = Readonly<Record<string, number>>;
3063
- /** Columns pinned to the start (left in LTR) and end edges, in display order. */
3064
- interface PinnedColumns {
3065
- left?: readonly string[];
3066
- right?: readonly string[];
3067
- }
3068
- type PinSide = 'left' | 'right';
3069
- export declare const DEFAULT_COLUMN_WIDTH = 160;
3070
- export declare const MIN_COLUMN_WIDTH = 60;
3071
- export declare const MAX_COLUMN_WIDTH = 640;
3072
- /** Clamps a width to the column's limits (rounded to whole px). */
3073
- export declare function clampColumnWidth<T>(column: DataTableColumn<T>, width: number): number;
3074
- /** Effective width of a column: the widths map, then `column.width`, then the default. */
3075
- export declare function columnWidthOf<T>(column: DataTableColumn<T>, widths: ColumnWidths): number;
3076
- /** Pins a column to a side (appended to that side) or unpins it (`null`). */
3077
- export declare function setColumnPin(pinned: PinnedColumns, id: string, side: PinSide | null): PinnedColumns;
3078
- /** Display order: start-pinned columns (pin order), unpinned columns (column order), end-pinned columns. */
3079
- export declare function orderColumns<T>(columns: ReadonlyArray<DataTableColumn<T>>, pinned: PinnedColumns): Array<DataTableColumn<T>>;
3367
+ //#region src/marketing/ComparisonTable/block.meta.d.ts
3368
+ declare const meta$10: BlockMeta;
3080
3369
  //#endregion
3081
- //#region src/tables/PaginationFooter/PaginationFooter.d.ts
3082
- export interface PaginationFooterLabels {
3083
- rowsPerPage: string;
3084
- rowsPerPageLabel: string;
3085
- rangeSummary: (from: number, to: number, total: number) => string;
3086
- paginationNav: (noun: string) => string;
3087
- previous: string;
3088
- next: string;
3089
- page: (page: number) => string;
3370
+ //#region src/marketing/ComparisonTable/fixtures.d.ts
3371
+ /** Three sample plans (generic, product-agnostic). */
3372
+ export declare const sampleComparisonPlans: ComparisonPlan[];
3373
+ /** Features grouped by section; values are keyed by plan id. */
3374
+ export declare const sampleComparisonSections: ComparisonSection[];
3375
+ //#endregion
3376
+ //#region src/marketing/SiteFooter/SiteFooter.d.ts
3377
+ export interface SiteFooterLink {
3378
+ label: string;
3379
+ href: string;
3380
+ external?: boolean;
3090
3381
  }
3091
- export interface PaginationFooterProps {
3092
- /** Per-key overrides; omitted keys retain the existing provider translations and defaults. */
3093
- labels?: Partial<PaginationFooterLabels>;
3094
- /** Total number of rows. */
3095
- total?: number;
3096
- /** Current page, 1-based (controlled). */
3097
- page?: number;
3098
- defaultPage?: number;
3099
- onPageChange?: (page: number) => void;
3100
- /** Rows per page (controlled). */
3101
- pageSize?: number;
3102
- defaultPageSize?: number;
3103
- onPageSizeChange?: (pageSize: number) => void;
3104
- pageSizeOptions?: readonly number[];
3105
- /** What the rows are, for the accessible names ("Deployments"). */
3106
- noun?: string;
3107
- locale?: string;
3382
+ export interface SiteFooterColumn {
3383
+ title: string;
3384
+ links: SiteFooterLink[];
3385
+ }
3386
+ export interface SiteFooterSocialLink {
3387
+ /** Use the network name (for example "RSS feed") as the accessible name. */
3388
+ label: string;
3389
+ href: string;
3390
+ icon: ComponentType<{
3391
+ size?: number;
3392
+ 'aria-hidden'?: boolean;
3393
+ }>;
3394
+ }
3395
+ export interface SiteFooterProps {
3396
+ layout?: 'columns' | 'centered' | 'simple';
3397
+ brand?: ReactNode;
3398
+ description?: ReactNode;
3399
+ columns?: SiteFooterColumn[];
3400
+ links?: SiteFooterLink[];
3401
+ legalLinks?: SiteFooterLink[];
3402
+ social?: SiteFooterSocialLink[];
3403
+ copyright?: ReactNode;
3404
+ headingLevel?: 'h2' | 'h3';
3405
+ navLabel?: string;
3406
+ landmark?: boolean;
3407
+ /** Show the icon-only theme control at every viewport width. */
3408
+ themeSwitcher?: boolean;
3409
+ /** Content under the brand blurb in columns and centered layouts; supply your own form. */
3410
+ newsletter?: ReactNode;
3108
3411
  className?: string;
3109
3412
  }
3110
- /** Table footer: rows-per-page Select, a "1–10 of 97" summary and numbered Pagination. Stacks on small screens. */
3111
- export declare function PaginationFooter({ total, page: pageProp, defaultPage, onPageChange, pageSize: sizeProp, defaultPageSize, onPageSizeChange, pageSizeOptions, noun: nounProp, locale: localeProp, className, labels }: PaginationFooterProps): import("react").JSX.Element;
3413
+ /** Public-page footer. The default div fits inside a layout's existing footer landmark. */
3414
+ export declare function SiteFooter({ layout, brand, description, columns, links, legalLinks, social, copyright, headingLevel: Heading, navLabel, landmark, themeSwitcher, newsletter, className }: SiteFooterProps): import("react").JSX.Element;
3112
3415
  //#endregion
3113
- //#region src/tables/DataTable/labels.d.ts
3114
- /** Per-instance table chrome, including the composed PaginationFooter. Caller data stays caller-owned. */
3115
- interface DataTableLabels extends PaginationFooterLabels {
3116
- booleanTrue: string;
3117
- booleanFalse: string;
3118
- /** Non-virtual table overflow region; virtualized regions keep the caller caption. */
3119
- scrollRegion: string;
3120
- selectionCount: (count: number) => string;
3121
- columns: string;
3122
- visibleColumns: string;
3123
- pinColumns: string;
3124
- pinnedLeft: string;
3125
- pinnedRight: string;
3126
- pinLeft: string;
3127
- pinRight: string;
3128
- unpinned: string;
3129
- density: string;
3130
- comfortable: string;
3131
- compact: string;
3132
- resizeColumn: (label: string) => string;
3133
- columnWidth: (width: number) => string;
3134
- defaultView: string;
3135
- defaultViewOption: string;
3136
- modified: string;
3137
- views: string;
3138
- saveChanges: string;
3139
- saveAs: string;
3140
- renameView: string;
3141
- deleteView: string;
3142
- resetChanges: string;
3143
- saveViewTitle: string;
3144
- renameViewTitle: string;
3145
- viewName: string;
3146
- cancel: string;
3147
- saveView: string;
3148
- rename: string;
3149
- closeDialog: string;
3150
- selection: string;
3151
- selectAll: string;
3152
- selectRow: (label: string) => string;
3153
- selectGroup: (group: string) => string;
3154
- groupRows: (count: number) => string;
3155
- noGroup: string;
3156
- actions: string;
3157
- rowActions: (label: string) => string;
3158
- emptyTitle: string;
3159
- emptyDescription: string;
3160
- loading: (caption: string) => string;
3161
- editHint: string;
3162
- editLabel: (column: string, row: string) => string;
3163
- editError: string;
3164
- enterNumber: string;
3165
- minimumValue: (min: number) => string;
3166
- maximumValue: (max: number) => string;
3167
- }
3416
+ //#region src/marketing/SiteFooter/block.meta.d.ts
3417
+ declare const meta$65: BlockMeta;
3168
3418
  //#endregion
3169
- //#region src/tables/DataTable/editable-cell.d.ts
3170
- /** One committed cell edit, as `onCellEdit` receives it. */
3171
- interface DataTableCellEdit<T> {
3172
- row: T;
3173
- rowId: string;
3174
- columnId: string;
3175
- /** Parsed value: a string (text, select) or a number / null (number editor). */
3176
- value: string | number | null;
3177
- /** Value the editor started from. */
3178
- previous: string | number | null;
3179
- }
3180
- /**
3181
- * Result of `onCellEdit`: nothing or `true` accepts the edit (the parent updates `rows`); a string
3182
- * rejects it and is shown inline as the error; `false` rejects with a generic message. A thrown
3183
- * error (or a rejected promise) rejects with its message.
3184
- */
3185
- type DataTableCellEditResult = void | boolean | string;
3186
- type DataTableCellEditHandler<T> = (edit: DataTableCellEdit<T>) => DataTableCellEditResult | Promise<DataTableCellEditResult>;
3187
- interface EditableCellProps<T> {
3188
- labels?: Partial<DataTableLabels>;
3189
- row: T;
3190
- rowId: string;
3191
- rowLabel: string;
3192
- column: DataTableColumn<T>;
3193
- onCellEdit: DataTableCellEditHandler<T>;
3194
- /** Id of the shared "Press Enter or F2 to edit" hint. */
3195
- hintId: string;
3196
- /** The cell's display content. */
3197
- children: ReactNode;
3198
- }
3199
- /**
3200
- * An editable body cell's content. At rest it is a button showing the value (Enter, F2 or a click
3201
- * edits); while editing, an input or a select: Enter or Tab commits, Escape cancels. `onCellEdit`
3202
- * can reject the value with a message, shown inline under the editor.
3203
- */
3204
- export declare function EditableCell<T>({ row, rowId, rowLabel, column, onCellEdit, hintId, children, labels }: EditableCellProps<T>): import("react").JSX.Element;
3419
+ //#region src/marketing/SiteFooter/fixtures.d.ts
3420
+ export declare const sampleFooterColumns: SiteFooterColumn[];
3421
+ export declare const sampleLegalLinks: SiteFooterLink[];
3422
+ export declare const sampleSocialLinks: SiteFooterSocialLink[];
3205
3423
  //#endregion
3206
- //#region src/tables/DataTable/views.d.ts
3207
- /** What a saved view captures. Every field is optional: a missing field keeps the table's default. */
3208
- interface DataTableViewState {
3209
- /** Opaque filter state of the page's toolbar (see the table's `filters` / `onFiltersChange`). */
3210
- filters?: unknown;
3211
- sort?: SortState | null;
3212
- hiddenColumns?: readonly string[];
3213
- columnWidths?: ColumnWidths;
3214
- pinnedColumns?: PinnedColumns;
3215
- /** A field key, or `null` for no grouping (function `groupBy`s cannot be saved). */
3216
- groupBy?: string | null;
3217
- }
3218
- interface DataTableView {
3424
+ //#region src/marketing/LogoCloud/LogoCloud.d.ts
3425
+ export interface LogoCloudItem {
3219
3426
  id: string;
3220
3427
  name: string;
3221
- state: DataTableViewState;
3428
+ /** Supply a single-colour SVG painted with currentColor. */
3429
+ mark: ReactNode;
3430
+ /** Optional token colour override for this mark. Otherwise inherits the root colour. */
3431
+ className?: string;
3222
3432
  }
3223
- /** Whether two view states are equivalent (key order and empty values ignored). */
3224
- export declare function sameViewState(a: DataTableViewState, b: DataTableViewState): boolean;
3225
- interface ViewSwitcherProps {
3226
- labels?: Partial<DataTableLabels>;
3227
- views: readonly DataTableView[];
3228
- activeId: string | null;
3229
- /** The table differs from the active view (or from the defaults when none is active). */
3230
- dirty: boolean;
3231
- onSelect: (id: string | null) => void;
3232
- onSaveAs: (name: string) => void;
3233
- onSave: () => void;
3234
- onRename: (id: string, name: string) => void;
3235
- onDelete: (id: string) => void;
3236
- onReset: () => void;
3433
+ export interface LogoCloudProps {
3434
+ /** Customer marks. Empty arrays render nothing. */
3435
+ logos: LogoCloudItem[];
3436
+ /** Accessible list name; defaults to the active locale's catalog caption. */
3437
+ caption?: ReactNode;
3438
+ /** Above at every width, or beside the logos from md. */
3439
+ captionPlacement?: 'above' | 'start';
3440
+ /** A centred wrapping row (default) or a responsive grid. */
3441
+ layout?: 'row' | 'grid';
3442
+ /** Desktop column count in grid layout; phones always use two columns. */
3443
+ columns?: 3 | 4 | 6;
3444
+ /** Mark height in pixels. Width remains automatic and constrained to the available space. */
3445
+ logoHeight?: number;
3446
+ /** Root utilities; text-foreground overrides the default muted mark colour. */
3447
+ className?: string;
3237
3448
  }
3238
- /** "Views" menu: switch between saved views, save the current table as a view, rename, delete, reset. */
3239
- declare function ViewSwitcher({ labels, views, activeId, dirty, onSelect, onSaveAs, onSave, onRename, onDelete, onReset }: ViewSwitcherProps): import("react").JSX.Element;
3449
+ /** Static social proof. Marks inherit the root token colour unless an item overrides it. */
3450
+ export declare function LogoCloud({ logos, caption, captionPlacement, layout, columns, logoHeight, className }: LogoCloudProps): import("react").JSX.Element | null;
3240
3451
  //#endregion
3241
- //#region src/tables/DataTable/data-table-props.d.ts
3242
- interface DataTableCommonProps<T> {
3243
- /** Per-key overrides; omitted keys keep existing defaults and provider translations. */
3244
- labels?: Partial<DataTableLabels>;
3245
- rows?: readonly T[];
3246
- columns?: ReadonlyArray<DataTableColumn<T>>;
3247
- /** Stable row id (defaults to `row.id`). */
3248
- getRowId?: (row: T) => string;
3249
- /** Row name for selection and menu labels (defaults to the first column's value). */
3250
- getRowLabel?: (row: T) => string;
3251
- /** Table name (screen-reader caption unless `showCaption`). */
3252
- caption?: string;
3253
- showCaption?: boolean;
3254
- /** Row selection with a select-all header checkbox (current page). */
3255
- selectable?: boolean;
3256
- /** Native radio name in single mode. Supplied names must be unique per page. */
3257
- selectionName?: string;
3258
- selectedId?: string | null;
3259
- defaultSelectedId?: string | null;
3260
- onSelectedIdChange?: (id: string) => void;
3261
- isRowDisabled?: (row: T) => boolean;
3262
- selectedIds?: readonly string[];
3263
- defaultSelectedIds?: readonly string[];
3264
- onSelectionChange?: (ids: string[]) => void;
3265
- /** Rendered in the toolbar while rows are selected. */
3266
- bulkActions?: (selectedIds: string[]) => ReactNode;
3267
- /**
3268
- * Shows the "N selected" text in the toolbar while rows are selected (default true). Turn it
3269
- * off when the page renders its own count, e.g. a BulkActionBar.
3270
- */
3271
- selectionSummary?: boolean;
3272
- /** Row-actions menu items. */
3273
- rowActions?: (row: T) => Array<MoreMenuAction | 'separator'>;
3274
- sort?: SortState | null;
3275
- defaultSort?: SortState | null;
3276
- onSortChange?: (sort: SortState) => void;
3277
- /** Rows arrive sorted (server side): headers still toggle, rows are not re-sorted. */
3278
- manualSorting?: boolean;
3279
- defaultPageSize?: number;
3280
- pageSizeOptions?: readonly number[];
3281
- /** Controlled row density. */
3282
- density?: TableDensity;
3283
- /** Initial density; omitted, the table follows the surrounding DensityProvider (comfortable outside one). */
3284
- defaultDensity?: TableDensity;
3285
- onDensityChange?: (density: TableDensity) => void;
3286
- showDensityToggle?: boolean;
3287
- showColumnMenu?: boolean;
3288
- loading?: boolean;
3289
- loadingRows?: number;
3290
- emptyState?: ReactNode;
3291
- /**
3292
- * Groups rows under header rows (a field key or a function returning the group key). Groups keep
3293
- * the order in which their keys first appear in `rows`; sorting applies inside each group, and
3294
- * pagination pages through the grouped rows (each header shows the group's full count).
3295
- */
3296
- groupBy?: DataTableGroupBy<T>;
3297
- /** Header text of a group (default: the key, or "No group" for rows without a value). */
3298
- groupLabel?: (key: string, rows: readonly T[]) => ReactNode;
3299
- /** Group headers render a keyboard-accessible collapse button (default true). */
3300
- collapsibleGroups?: boolean;
3301
- /** Controlled collapsed group keys. */
3302
- collapsedGroups?: readonly string[];
3303
- /** Group keys collapsed initially. */
3304
- defaultCollapsedGroups?: readonly string[];
3305
- onCollapsedGroupsChange?: (keys: string[]) => void;
3306
- /** Called when a saved view switches grouping (a field key, or `null` for none). */
3307
- onGroupByChange?: (groupBy: string | null) => void;
3308
- /** Controlled hidden column ids (default: columns with `defaultHidden`). */
3309
- hiddenColumns?: readonly string[];
3310
- onHiddenColumnsChange?: (ids: string[]) => void;
3311
- /** Resize handles on the column headers (pointer drag, or arrow keys on the focused handle). */
3312
- resizable?: boolean;
3313
- /** Controlled column widths in px by column id. */
3314
- columnWidths?: ColumnWidths;
3315
- defaultColumnWidths?: ColumnWidths;
3316
- onColumnWidthsChange?: (widths: Record<string, number>) => void;
3317
- /** Controlled pinned columns (sticky at the start or end edge while scrolling sideways). */
3318
- pinnedColumns?: PinnedColumns;
3319
- defaultPinnedColumns?: PinnedColumns;
3320
- onPinnedColumnsChange?: (pinned: PinnedColumns) => void;
3321
- /** Pin / unpin from the column menu (default true when pinning is in use: a pinned prop or callback). */
3322
- showPinMenu?: boolean;
3452
+ //#region src/marketing/LogoCloud/block.meta.d.ts
3453
+ declare const meta$41: BlockMeta;
3454
+ //#endregion
3455
+ //#region src/marketing/LogoCloud/fixtures.d.ts
3456
+ /** Neutral placeholder marks, never customer assets. Supply your own currentColor SVGs. */
3457
+ export declare const sampleLogos: LogoCloudItem[];
3458
+ //#endregion
3459
+ //#region src/page-chrome/types.d.ts
3460
+ /** A header/toolbar action rendered as a kit Button (or a MoreMenu item when folded). */
3461
+ interface PageChromeAction {
3462
+ /** Stable key; defaults to `label`. */
3463
+ id?: string;
3464
+ label: string;
3465
+ icon?: LucideIcon;
3466
+ /** Button style; when omitted the block picks one (primary for the main action, secondary otherwise). */
3467
+ variant?: ButtonProps['variant'];
3468
+ disabled?: boolean;
3469
+ onClick?: () => void;
3470
+ }
3471
+ //#endregion
3472
+ //#region src/page-chrome/PageHeader/PageHeader.d.ts
3473
+ export interface PageHeaderMetaItem {
3474
+ /** Term (screen-reader only when an icon is shown). */
3475
+ label: string;
3476
+ value: ReactNode;
3477
+ icon?: LucideIcon;
3478
+ /** Render the value in Geist Mono (ids, regions, versions). */
3479
+ mono?: boolean;
3480
+ }
3481
+ export interface PageHeaderTab {
3482
+ value: string;
3483
+ label: string;
3484
+ count?: number;
3485
+ }
3486
+ export interface PageHeaderLabels {
3487
+ title: string;
3488
+ description: string;
3489
+ moreActions: string;
3490
+ sections: string;
3491
+ }
3492
+ export interface PageHeaderProps {
3493
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
3494
+ labels?: Partial<PageHeaderLabels>;
3495
+ /** Root element. Use 'div' where the layout already has a banner (e.g. StackedLayout's pageHeader slot). */
3496
+ as?: 'header' | 'div';
3497
+ /** Location trail above the title; `null` hides it. */
3498
+ breadcrumbs?: BreadcrumbItem[] | null;
3499
+ title?: ReactNode;
3500
+ /** Wrap the title, including long unbroken words, instead of truncating (default false). */
3501
+ wrapTitle?: boolean;
3502
+ /** h1 focus target: adds tabIndex=-1 for titleRef.current.focus(), outside the Tab order. */
3503
+ titleRef?: Ref<HTMLHeadingElement>;
3504
+ description?: ReactNode;
3505
+ /** StatusTag key next to the title (e.g. `active`, `paused`, `failed`). */
3506
+ status?: string;
3507
+ statuses?: Record<string, StatusDefinition>;
3508
+ /** Meta row under the description. */
3509
+ meta?: PageHeaderMetaItem[];
3323
3510
  /**
3324
- * Renders only the rows in view (plus overscan) inside a scrolling body with a sticky header.
3325
- * `'auto'` (default) turns it on above `virtualizeThreshold` rendered rows (with pagination,
3326
- * the rows of the current page). The table exposes `aria-rowcount` and each row its
3327
- * `aria-rowindex`; selection (select-all covers every row) and grouping keep working.
3328
- * Limits: rows get a fixed height (`rowHeight`), so multi-line cells are clipped; a row that
3329
- * scrolls out of view unmounts, so focus inside it (or an open inline editor) is lost; a group's
3330
- * header row renders only while it is in view.
3511
+ * Header actions in visual order. The primary one (first with `variant: 'primary'`, else the
3512
+ * last) stays visible in narrow containers; the rest fold into a MoreMenu.
3331
3513
  */
3332
- virtualize?: boolean | 'auto';
3333
- virtualizeThreshold?: number;
3334
- /** Row height in px for virtualization (default by density: 44 comfortable, 36 compact). */
3335
- rowHeight?: number;
3336
- /** Classes of the virtualized scroll container: its max height (default `max-h-[32rem]`). */
3337
- virtualContainerClassName?: string;
3514
+ actions?: PageChromeAction[];
3515
+ /** Resource-level navigation tabs under the header; `null` hides them. */
3516
+ tabs?: PageHeaderTab[] | null;
3517
+ tab?: string;
3518
+ defaultTab?: string;
3519
+ onTabChange?: (value: string) => void;
3520
+ className?: string;
3521
+ }
3522
+ /** Screen header: breadcrumb, title + status, description, meta row, actions and optional tabs. */
3523
+ export declare function PageHeader({ as: Root, breadcrumbs, title: titleProp, wrapTitle, labels, titleRef, description: descriptionProp, status, statuses, meta, actions, tabs, tab, defaultTab, onTabChange, className }: PageHeaderProps): import("react").JSX.Element;
3524
+ //#endregion
3525
+ //#region src/page-chrome/PageHeader/fixtures.d.ts
3526
+ export declare const pageHeaderBreadcrumbs: BreadcrumbItem[];
3527
+ export declare const pageHeaderActions: PageChromeAction[];
3528
+ export declare const pageHeaderTabs: PageHeaderTab[];
3529
+ //#endregion
3530
+ //#region src/page-chrome/PageHeader/block.meta.d.ts
3531
+ declare const meta$47: BlockMeta;
3532
+ //#endregion
3533
+ //#region src/page-chrome/SectionHeader/SectionHeader.d.ts
3534
+ export interface SectionHeaderProps {
3535
+ title?: ReactNode;
3536
+ description?: ReactNode;
3537
+ /** Count pill after the title (members, items…). */
3538
+ count?: number;
3539
+ /** Small actions on the right; the last one without a variant is secondary. */
3540
+ actions?: PageChromeAction[];
3541
+ /** Heading level that fits the page outline. */
3542
+ as?: 'h2' | 'h3';
3543
+ /** Hairline under the header. */
3544
+ bordered?: boolean;
3545
+ /** Id for the heading, so a section can use `aria-labelledby`. */
3546
+ headingId?: string;
3547
+ className?: string;
3548
+ }
3549
+ /** Heading for a section inside a page: title (+ count), description and small actions. */
3550
+ export declare function SectionHeader({ title, description, count, actions, as: Heading, bordered, headingId, className }: SectionHeaderProps): import("react").JSX.Element;
3551
+ //#endregion
3552
+ //#region src/page-chrome/SectionHeader/block.meta.d.ts
3553
+ declare const meta$60: BlockMeta;
3554
+ //#endregion
3555
+ //#region src/page-chrome/PageToolbar/PageToolbar.d.ts
3556
+ export interface PageToolbarView {
3557
+ value: string;
3558
+ /** Accessible name of the icon toggle. */
3559
+ label: string;
3560
+ icon: LucideIcon;
3561
+ }
3562
+ export interface PageToolbarProps {
3563
+ /** Controlled search text. */
3564
+ search?: string;
3565
+ defaultSearch?: string;
3566
+ onSearchChange?: (value: string) => void;
3567
+ searchLabel?: string;
3568
+ searchPlaceholder?: string;
3338
3569
  /**
3339
- * Inline editing of `editable` columns. Return nothing to accept (and update `rows`), or a
3340
- * message (or throw) to reject: the message is shown inline under the editor.
3570
+ * Filter controls. Use ToolbarButton (optionally with `render` for a Menu/Popover trigger) so they
3571
+ * join the toolbar's arrow-key navigation. Omitted: a single "Filters" button; `null` hides it.
3341
3572
  */
3342
- onCellEdit?: DataTableCellEditHandler<T>;
3343
- /** Saved views (controlled). Each captures filters, sort, visible columns, widths, pinning and grouping. */
3344
- views?: readonly DataTableView[];
3345
- defaultViews?: readonly DataTableView[];
3346
- onViewsChange?: (views: DataTableView[]) => void;
3347
- activeViewId?: string | null;
3348
- defaultActiveViewId?: string | null;
3349
- onActiveViewChange?: (id: string | null) => void;
3350
- /** Shows the view switcher (default: when views are in use). */
3351
- showViewSwitcher?: boolean;
3352
- /** Opaque filter state of the page's toolbar, saved with views. */
3353
- filters?: unknown;
3354
- /** Called when a view (or a reset) restores filters. */
3355
- onFiltersChange?: (filters: unknown) => void;
3356
- /** Left side of the toolbar (title, search, FilterBar…). */
3357
- toolbar?: ReactNode;
3573
+ filters?: ReactNode;
3574
+ /** View modes for the segmented toggle; `null` or an empty list hides it. */
3575
+ views?: PageToolbarView[] | null;
3576
+ view?: string;
3577
+ defaultView?: string;
3578
+ onViewChange?: (value: string) => void;
3579
+ /** Main action at the end of the bar; `null` hides it. */
3580
+ primaryAction?: PageChromeAction | null;
3581
+ 'aria-label'?: string;
3582
+ className?: string;
3583
+ }
3584
+ /** List/table toolbar: search, filters, view toggle and the primary action, with one Tab stop. */
3585
+ export declare function PageToolbar({ search, defaultSearch, onSearchChange, searchLabel: searchLabelProp, searchPlaceholder, filters, views, view, defaultView, onViewChange, primaryAction, 'aria-label': ariaLabelProp, className }: PageToolbarProps): import("react").JSX.Element;
3586
+ //#endregion
3587
+ //#region src/page-chrome/PageToolbar/fixtures.d.ts
3588
+ export declare const pageToolbarViews: PageToolbarView[];
3589
+ //#endregion
3590
+ //#region src/page-chrome/PageToolbar/block.meta.d.ts
3591
+ declare const meta$48: BlockMeta;
3592
+ //#endregion
3593
+ //#region src/page-chrome/StickyActionBar/StickyActionBar.d.ts
3594
+ export interface StickyActionBarProps {
3595
+ /** Whether the form has unsaved changes; Save and Discard are disabled while clean. */
3596
+ dirty?: boolean;
3597
+ /** Shows a spinner on Save and blocks both buttons. */
3598
+ saving?: boolean;
3599
+ onSave?: () => void;
3600
+ onCancel?: () => void;
3601
+ /** Text while dirty. */
3602
+ dirtyMessage?: ReactNode;
3603
+ /** Text while clean. */
3604
+ cleanMessage?: ReactNode;
3605
+ saveLabel?: string;
3606
+ cancelLabel?: string;
3607
+ /** Render nothing while clean (the bar slides in only when there is something to save). */
3608
+ hideWhenClean?: boolean;
3609
+ /** Accessible name of the region. */
3610
+ 'aria-label'?: string;
3611
+ className?: string;
3612
+ }
3613
+ /** Bottom bar for long forms: unsaved-changes status plus Discard / Save, sticky to the viewport. */
3614
+ export declare function StickyActionBar({ dirty, saving, onSave, onCancel, dirtyMessage: dirtyMessageProp, cleanMessage: cleanMessageProp, saveLabel: saveLabelProp, cancelLabel: cancelLabelProp, hideWhenClean, 'aria-label': ariaLabelProp, className }: StickyActionBarProps): import("react").JSX.Element | null;
3615
+ //#endregion
3616
+ //#region src/page-chrome/StickyActionBar/block.meta.d.ts
3617
+ declare const meta$71: BlockMeta;
3618
+ //#endregion
3619
+ //#region src/page-chrome/BulkActionBar/BulkActionBar.d.ts
3620
+ export interface BulkActionBarProps {
3621
+ /** Number of selected rows; the bar renders nothing at 0. */
3622
+ selectedCount?: number;
3623
+ /** Total rows, shown as "3 of 24 selected". */
3624
+ totalCount?: number;
3625
+ /** Noun for the count, singular and plural. */
3626
+ noun?: [singular: string, plural: string];
3627
+ actions?: PageChromeAction[];
3628
+ onClear?: () => void;
3629
+ clearLabel?: string;
3630
+ className?: string;
3631
+ }
3632
+ /** Contextual toolbar shown while rows are selected: count, bulk actions and clear selection. */
3633
+ export declare function BulkActionBar({ selectedCount, totalCount, noun: nounProp, actions, onClear, clearLabel: clearLabelProp, className }: BulkActionBarProps): import("react").JSX.Element | null;
3634
+ //#endregion
3635
+ //#region src/page-chrome/BulkActionBar/block.meta.d.ts
3636
+ declare const meta$6: BlockMeta;
3637
+ //#endregion
3638
+ //#region src/scheduling/shared/dates.d.ts
3639
+ /** The clock options accepted by the scheduling blocks. */
3640
+ type HourCycle = 'h12' | 'h23';
3641
+ //#endregion
3642
+ //#region src/scheduling/shared/events.d.ts
3643
+ /** A scheduled item on a calendar. */
3644
+ interface ScheduleEvent {
3645
+ id: string;
3646
+ title: string;
3647
+ start: Date;
3648
+ end: Date;
3649
+ /** Key into the `kinds` map (job, deploy, review, backup, maintenance…). */
3650
+ kind?: string;
3651
+ /** Region, room or target, shown after the time. */
3652
+ location?: string;
3653
+ }
3654
+ type EventTone = 'primary' | 'violet' | 'cyan' | 'amber' | 'neutral';
3655
+ interface EventKind {
3656
+ label: string;
3657
+ icon: LucideIcon;
3658
+ tone: EventTone;
3659
+ }
3660
+ /** Default kinds: brand green for jobs, categorical accents for the rest (never severity). */
3661
+ export declare const defaultEventKinds: Record<string, EventKind>;
3662
+ //#endregion
3663
+ //#region src/scheduling/MonthCalendar/MonthCalendar.d.ts
3664
+ export interface MonthCalendarProps {
3665
+ events?: ScheduleEvent[];
3666
+ /** Display time zone; defaults to the I18nProvider zone (system outside a provider). */
3667
+ timeZone?: string;
3668
+ /** Clock used for event times; defaults to the provider or runtime locale. */
3669
+ hourCycle?: HourCycle;
3670
+ /** First weekday; defaults to the provider or runtime locale. */
3671
+ weekStartsOn?: WeekDay;
3672
+ /** The app's "today" (the block never reads the clock). */
3673
+ today?: Date;
3674
+ /** Month shown first (uncontrolled). Defaults to the month of `today`. */
3675
+ defaultMonth?: Date;
3676
+ onMonthChange?: (month: Date) => void;
3677
+ /** Initially selected day (uncontrolled). */
3678
+ defaultSelected?: Date;
3679
+ /** Called when a day is activated (click, Enter or Space). */
3680
+ onSelectDate?: (date: Date, events: ScheduleEvent[]) => void;
3681
+ /** Event kinds (label, icon, tone) by `event.kind`. */
3682
+ kinds?: Record<string, EventKind>;
3683
+ /** Event lines per day before "+N more". */
3684
+ maxEventsPerDay?: number;
3685
+ /** Caller actions in the header (e.g. a "Schedule" button). */
3686
+ actions?: ReactNode;
3687
+ className?: string;
3688
+ }
3689
+ /**
3690
+ * Month view of scheduled work: a locale-first grid with up to N events per day.
3691
+ * Keyboard: arrows move by day/week, Home/End to the week edges, PageUp/PageDown by month,
3692
+ * Enter/Space selects.
3693
+ */
3694
+ export declare function MonthCalendar({ events, timeZone: timeZoneProp, hourCycle: hourCycleProp, weekStartsOn: weekStartsOnProp, today, defaultMonth, onMonthChange, defaultSelected, onSelectDate, kinds, maxEventsPerDay, actions, className }: MonthCalendarProps): import("react").JSX.Element;
3695
+ //#endregion
3696
+ //#region src/scheduling/MonthCalendar/block.meta.d.ts
3697
+ declare const meta$45: BlockMeta;
3698
+ //#endregion
3699
+ //#region src/scheduling/WeekCalendar/WeekCalendar.d.ts
3700
+ export interface WeekCalendarProps {
3701
+ events?: ScheduleEvent[];
3702
+ /** Display time zone; defaults to the I18nProvider zone (system outside a provider). */
3703
+ timeZone?: string;
3704
+ /** First weekday; defaults to the provider or runtime locale. */
3705
+ weekStartsOn?: WeekDay;
3706
+ /** Clock used for events and hour labels; defaults to the provider or runtime locale. */
3707
+ hourCycle?: HourCycle;
3708
+ /** The app's "today" (the block never reads the clock). */
3709
+ today?: Date;
3710
+ /** Current time for the "now" line, shown when it falls in the visible week. Defaults to `today`. */
3711
+ now?: Date;
3712
+ /** A date inside the week shown first (uncontrolled). Defaults to `today`. */
3713
+ defaultWeek?: Date;
3714
+ /** Called with the first day of the newly shown week. */
3715
+ onWeekChange?: (weekStart: Date) => void;
3716
+ /** Makes events buttons. */
3717
+ onEventClick?: (event: ScheduleEvent) => void;
3718
+ kinds?: Record<string, EventKind>;
3719
+ /** Hour the grid scrolls to on mount. */
3720
+ scrollToHour?: number;
3721
+ /** Pixels per hour. */
3722
+ hourHeight?: number;
3723
+ /** Max height of the scrolling time grid in px. */
3724
+ height?: number;
3725
+ actions?: ReactNode;
3726
+ className?: string;
3727
+ }
3728
+ /** Week view: seven day columns over a scrolling 24-hour time grid, with a "now" line. */
3729
+ export declare function WeekCalendar({ events, timeZone: timeZoneProp, weekStartsOn: weekStartsOnProp, hourCycle: hourCycleProp, today, now, defaultWeek, onWeekChange, onEventClick, kinds, scrollToHour, hourHeight, height, actions, className }: WeekCalendarProps): import("react").JSX.Element;
3730
+ //#endregion
3731
+ //#region src/scheduling/WeekCalendar/block.meta.d.ts
3732
+ declare const meta$79: BlockMeta;
3733
+ //#endregion
3734
+ //#region src/scheduling/AgendaList/AgendaList.d.ts
3735
+ export interface AgendaListProps {
3736
+ events?: ScheduleEvent[];
3737
+ /** Display time zone; defaults to the I18nProvider zone (system outside a provider). */
3738
+ timeZone?: string;
3739
+ /** Clock used for event ranges; defaults to the provider or runtime locale. */
3740
+ hourCycle?: HourCycle;
3741
+ /** The app's "today": labels the Today/Tomorrow groups. */
3742
+ today?: Date;
3743
+ /** Only events on or after this day. Defaults to `today`; pass null for all. */
3744
+ from?: Date | null;
3745
+ /** Number of days shown from `from`. Default 7; null for no limit. */
3746
+ days?: number | null;
3747
+ /** Makes each row a button. */
3748
+ onEventClick?: (event: ScheduleEvent) => void;
3749
+ kinds?: Record<string, EventKind>;
3750
+ title?: string;
3751
+ /** Max height of the scrolling list in px. */
3752
+ maxHeight?: number;
3753
+ emptyTitle?: string;
3754
+ emptyDescription?: string;
3755
+ /** Heading level of the title, to fit the page outline (default h3); inner headings use the next level. */
3756
+ titleAs?: 'h2' | 'h3' | 'h4';
3757
+ className?: string;
3758
+ }
3759
+ /** Upcoming scheduled work grouped by day, each row with a kind tile, time range and location. */
3760
+ export declare function AgendaList({ events, timeZone: timeZoneProp, hourCycle: hourCycleProp, today, from, days, onEventClick, kinds, title: titleProp, maxHeight, emptyTitle: emptyTitleProp, emptyDescription: emptyDescriptionProp, titleAs: TitleTag, className }: AgendaListProps): import("react").JSX.Element;
3761
+ //#endregion
3762
+ //#region src/scheduling/AgendaList/block.meta.d.ts
3763
+ declare const meta$2: BlockMeta;
3764
+ //#endregion
3765
+ //#region src/scheduling/TimeSlotPicker/TimeSlotPicker.d.ts
3766
+ export interface TimeSlot {
3767
+ /** Submitted value, e.g. "09:30". */
3768
+ value: string;
3769
+ /** Visible label. Defaults to `value`. */
3770
+ label?: string;
3771
+ /** Taken slots render struck through and disabled. Default true. */
3772
+ available?: boolean;
3773
+ }
3774
+ export interface TimeSlotPickerProps {
3775
+ slots?: TimeSlot[];
3776
+ /** Controlled value. */
3777
+ value?: string | null;
3778
+ /** Uncontrolled initial value. */
3779
+ defaultValue?: string | null;
3780
+ onValueChange?: (value: string) => void;
3781
+ /** Group label (the fieldset legend). */
3782
+ legend?: string;
3783
+ /** Secondary line under the legend, e.g. the chosen date. */
3784
+ description?: string;
3785
+ /** Form field name. */
3786
+ name?: string;
3787
+ /** Slot columns from the `sm` breakpoint (two on small screens). */
3788
+ columns?: 2 | 3 | 4 | 6;
3789
+ /** Max height of the scrolling slot list in px. */
3790
+ maxHeight?: number;
3791
+ className?: string;
3792
+ }
3793
+ /**
3794
+ * Pick one time slot. Native radio semantics: Tab enters the group, arrow keys move and select,
3795
+ * taken slots are disabled.
3796
+ */
3797
+ export declare function TimeSlotPicker({ slots, value, defaultValue, onValueChange, legend: legendProp, description, name, columns, maxHeight, className }: TimeSlotPickerProps): import("react").JSX.Element;
3798
+ //#endregion
3799
+ //#region src/scheduling/TimeSlotPicker/block.meta.d.ts
3800
+ declare const meta$74: BlockMeta;
3801
+ //#endregion
3802
+ //#region src/scheduling/TimeSlotPicker/fixtures.d.ts
3803
+ /** Half-hour slots from 09:00 to 21:00 with a few already taken. */
3804
+ export declare const sampleTimeSlots: TimeSlot[];
3805
+ //#endregion
3806
+ //#region src/scheduling/shared/fixtures.d.ts
3807
+ /** The sample calendar's "today" (Wed 15 Apr 2026, 10:20). Pass your own `today` in apps. */
3808
+ declare const sampleToday: Date;
3809
+ /** Sample scheduled work for April 2026 (jobs, deploys, reviews, backups, maintenance). */
3810
+ declare const sampleEvents: ScheduleEvent[];
3811
+ //#endregion
3812
+ //#region src/shell/AppSidebar/fixtures.d.ts
3813
+ export declare const appSidebarNavGroups: NavGroup[];
3814
+ export declare const appSidebarWorkspaces: Workspace[];
3815
+ export interface AppSidebarUsage {
3816
+ label: string;
3817
+ value: number;
3818
+ max: number;
3819
+ /** Formatted value, e.g. "8.2k / 10k requests". */
3820
+ valueLabel?: string;
3821
+ }
3822
+ export declare const appSidebarUsage: AppSidebarUsage;
3823
+ export declare const appSidebarUser: UserMenuUser;
3824
+ //#endregion
3825
+ //#region src/shell/AppSidebar/AppSidebar.d.ts
3826
+ export interface AppSidebarHeaderProps {
3827
+ /** Icon rail: shows only the brand mark. */
3828
+ collapsed?: boolean;
3829
+ /** Workspaces for the switcher; `null` shows the logo + wordmark instead. */
3830
+ workspaces?: Workspace[] | null;
3831
+ currentWorkspaceId?: string;
3832
+ onWorkspaceChange?: (workspace: Workspace) => void;
3833
+ onCreateWorkspace?: () => void;
3834
+ /** Omit to hide the tenant picker. Clearing selects the platform-wide context. */
3835
+ tenants?: {
3836
+ id: string;
3837
+ name: string;
3838
+ }[];
3839
+ currentTenantId?: string | null;
3840
+ onTenantSelect?: (id: string | null) => void;
3841
+ tenantLabel?: string;
3842
+ tenantEmptyText?: string;
3843
+ workspaceLabel?: string;
3844
+ workspaceEmptyText?: string;
3845
+ /** Platform-wide mode: hide all context controls and status. */
3846
+ hideWorkspaceContext?: boolean;
3847
+ /** Opt into a named section around the controls and status. */
3848
+ contextRegionLabel?: string;
3849
+ /** Consumer-owned loading state; reset when the context finishes changing. */
3850
+ contextBusy?: boolean;
3851
+ contextStatus?: ReactNode;
3852
+ /** Product-owned identity, rendered in place of the default logo. */
3853
+ brand?: ReactNode;
3358
3854
  className?: string;
3359
3855
  }
3360
- interface ClientPaginationProps {
3361
- paginationMode?: 'client';
3362
- rowCount?: never;
3363
- page?: never;
3364
- pageSize?: never;
3365
- onPageChange?: never;
3366
- onPageSizeChange?: never;
3856
+ /** Sidebar top: workspace switcher (or the brand logo), the brand mark alone in the icon rail. */
3857
+ export declare function AppSidebarHeader({ collapsed, workspaces, currentWorkspaceId, onWorkspaceChange, onCreateWorkspace, tenants, currentTenantId, onTenantSelect, tenantLabel, tenantEmptyText, workspaceLabel, workspaceEmptyText, hideWorkspaceContext, contextRegionLabel, contextBusy, contextStatus, brand, className }: AppSidebarHeaderProps): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined>;
3858
+ export interface AppSidebarNavProps {
3859
+ groups?: NavGroup[];
3860
+ currentHref?: string;
3861
+ collapsed?: boolean;
3862
+ /** Accessible name of the nav landmark. */
3863
+ label?: string;
3864
+ onNavigate?: (item: NavItem) => void;
3865
+ className?: string;
3367
3866
  }
3368
- interface ServerPaginationProps {
3369
- /** Rows arrive as one server page: no client sorting or slicing, and no sortable headers. */
3370
- paginationMode: 'server';
3371
- /** Total number of rows across all pages; required even for an empty result. */
3372
- rowCount: number;
3373
- /** Current page, 1-based. Out-of-range pages are clamped for display without callbacks. */
3374
- page: number;
3375
- pageSize: number;
3376
- onPageChange?: (page: number) => void;
3377
- /** The footer may also request a page change to keep the first visible row on screen. */
3378
- onPageSizeChange?: (size: number) => void;
3867
+ /** Sidebar body: the NavList (icon rail with tooltips when collapsed). */
3868
+ export declare function AppSidebarNav({ groups, currentHref, collapsed, label, onNavigate, className }: AppSidebarNavProps): import("react").JSX.Element;
3869
+ export interface AppSidebarFooterProps {
3870
+ collapsed?: boolean;
3871
+ /** Plan usage meter; `null` hides it. */
3872
+ usage?: AppSidebarUsage | null;
3873
+ /** Help link; `null` hides it. */
3874
+ helpHref?: string | null;
3875
+ helpLabel?: string;
3876
+ /** Signed-in user; `null` hides the user menu. */
3877
+ user?: UserMenuUser | null;
3878
+ userMenuItems?: UserMenuEntry[];
3879
+ /** Extra content inside the account menu popup, before sign out. */
3880
+ userMenuChildren?: ReactNode;
3881
+ onSignOut?: () => void;
3882
+ className?: string;
3379
3883
  }
3380
- type DataTableProps<T> = DataTableCommonProps<T> & (({
3381
- selectionMode: 'single';
3382
- paginated?: false;
3383
- /** Consumer-supplied accessible group label; the kit adds no default. */
3384
- legend?: ReactNode;
3385
- 'aria-label'?: string;
3386
- 'aria-labelledby'?: string;
3387
- paginationMode?: never;
3388
- } & ClientPaginationProps) | ({
3389
- selectionMode?: 'none' | 'multiple';
3390
- paginated?: boolean;
3391
- legend?: never;
3392
- 'aria-label'?: never;
3393
- 'aria-labelledby'?: never;
3394
- } & (ClientPaginationProps | ServerPaginationProps)));
3884
+ /** Sidebar bottom: usage meter, help link and the user menu (avatar only in the icon rail). */
3885
+ export declare function AppSidebarFooter({ collapsed, usage, helpHref, helpLabel, user, userMenuItems, userMenuChildren, onSignOut, className }: AppSidebarFooterProps): import("react").JSX.Element;
3886
+ export interface AppSidebarProps extends AppSidebarHeaderProps, Omit<AppSidebarNavProps, 'className' | 'groups' | 'label'>, Omit<AppSidebarFooterProps, 'className'> {
3887
+ navGroups?: NavGroup[];
3888
+ navLabel?: string;
3889
+ }
3890
+ /**
3891
+ * Complete application sidebar column (chrome surface): workspace switcher header, NavList body
3892
+ * and a footer with usage, help and the user menu. Inside SidebarLayout, use the parts
3893
+ * (AppSidebarHeader / AppSidebarNav / AppSidebarFooter) in its three slots.
3894
+ */
3895
+ export declare function AppSidebar({ collapsed, navGroups, navLabel, currentHref, onNavigate, usage, helpHref, helpLabel, user, userMenuItems, userMenuChildren, onSignOut, className, ...headerProps }: AppSidebarProps): import("react").JSX.Element;
3395
3896
  //#endregion
3396
- //#region src/tables/DataTable/fixtures.d.ts
3397
- interface DeploymentRow {
3398
- id: string;
3399
- name: string;
3400
- region: string;
3401
- status: 'running' | 'queued' | 'paused' | 'degraded' | 'failed';
3402
- requests: number;
3403
- cost: number;
3404
- updatedAt: Date;
3897
+ //#region src/shell/AppSidebar/block.meta.d.ts
3898
+ declare const meta$3: BlockMeta;
3899
+ //#endregion
3900
+ //#region src/shell/EnvironmentBadge/EnvironmentBadge.d.ts
3901
+ export type EnvironmentTone = 'primary' | 'warning' | 'info' | 'neutral' | 'destructive';
3902
+ /** Default tone per environment name; anything else is neutral. */
3903
+ export declare const environmentTones: Record<string, EnvironmentTone>;
3904
+ export interface EnvironmentBadgeProps {
3905
+ /** Environment name, e.g. `production`, `staging`, `preview`. */
3906
+ environment?: string;
3907
+ /** Region or cluster shown after the environment, e.g. `eu-west`; `null` hides it. */
3908
+ region?: string | null;
3909
+ /** Overrides the tone looked up from `environmentTones`. */
3910
+ tone?: EnvironmentTone;
3911
+ /** Prefix read by screen readers only. */
3912
+ srLabel?: string;
3913
+ className?: string;
3405
3914
  }
3406
- /** Deterministic deployments (the first 24 are DEPLOYMENT_ROWS); large counts exercise virtualization. */
3407
- export declare function generateDeployments(count: number): DeploymentRow[];
3408
- /** 24 deployments: enough for two pages at the default page size. */
3409
- export declare const DEPLOYMENT_ROWS: DeploymentRow[];
3410
- /** Columns for DEPLOYMENT_ROWS. */
3411
- export declare const DEPLOYMENT_COLUMNS: DataTableColumn<DeploymentRow>[];
3915
+ /** Environment + region chip for the topbar or a page header: "production · eu-west". */
3916
+ export declare function EnvironmentBadge({ environment, region, tone, srLabel, className }: EnvironmentBadgeProps): import("react").JSX.Element;
3412
3917
  //#endregion
3413
- //#region src/tables/DataTable/DataTable.d.ts
3918
+ //#region src/shell/AppTopbar/AppTopbar.d.ts
3919
+ export interface AppTopbarProps {
3920
+ /** Location trail; `null` hides it. */
3921
+ breadcrumbs?: BreadcrumbItem[] | null;
3922
+ /** Replaces the breadcrumb (custom title, tabs…). */
3923
+ breadcrumb?: ReactNode;
3924
+ /** Environment chip after the breadcrumb; `null` hides it. */
3925
+ environment?: EnvironmentBadgeProps | null;
3926
+ /** Search control; defaults to GlobalSearch (⌘K). `null` hides it. */
3927
+ search?: ReactNode;
3928
+ /** Notifications; `null` hides the bell. */
3929
+ notifications?: NotificationItem[] | null;
3930
+ onNotificationSelect?: (notification: NotificationItem) => void;
3931
+ onMarkAllRead?: () => void;
3932
+ /** Theme control: a one-button cycle, the segmented switcher, or none. */
3933
+ theme?: 'cycle' | 'segmented' | null;
3934
+ /** Signed-in user; `null` hides the user menu. */
3935
+ user?: UserMenuUser | null;
3936
+ userMenuItems?: UserMenuEntry[];
3937
+ onSignOut?: () => void;
3938
+ className?: string;
3939
+ }
3414
3940
  /**
3415
- * Generic data table on the kit Table: typed columns, sortable headers (aria-sort), row selection
3416
- * with select-all / indeterminate, column visibility menu, density toggle, row actions, loading
3417
- * and empty states, client-side sort + pagination, optional collapsible row groups (`groupBy`),
3418
- * column resize and pinning, row virtualization, inline cell editing and saved views.
3941
+ * Topbar contents: breadcrumb (+ environment chip) on the left; ⌘K search, notifications, theme
3942
+ * and user menu on the right. Renders no <header>: put it in SidebarLayout's `topbar` slot or a
3943
+ * header of your own.
3419
3944
  */
3420
- export declare function DataTable<T = (typeof DEPLOYMENT_ROWS)[number]>({ rows, columns, getRowId, getRowLabel, caption, showCaption, selectable: selectableProp, selectionMode, selectionName, legend, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, selectedId, defaultSelectedId, onSelectedIdChange, isRowDisabled, selectedIds, defaultSelectedIds, onSelectionChange, bulkActions, selectionSummary, rowActions, sort: sortProp, defaultSort, onSortChange, manualSorting, paginated: paginatedProp, paginationMode, rowCount, page: controlledPage, pageSize: controlledPageSize, onPageChange, onPageSizeChange, defaultPageSize, pageSizeOptions, density: densityProp, defaultDensity, onDensityChange, showDensityToggle, showColumnMenu, loading, loadingRows, emptyState, groupBy, groupLabel, collapsibleGroups, collapsedGroups: collapsedProp, defaultCollapsedGroups, onCollapsedGroupsChange, onGroupByChange, hiddenColumns: hiddenProp, onHiddenColumnsChange, resizable, columnWidths: widthsProp, defaultColumnWidths, onColumnWidthsChange, pinnedColumns: pinnedProp, defaultPinnedColumns, onPinnedColumnsChange, showPinMenu, virtualize, virtualizeThreshold, rowHeight: rowHeightProp, virtualContainerClassName, onCellEdit, views: viewsProp, defaultViews, onViewsChange, activeViewId, defaultActiveViewId, onActiveViewChange, showViewSwitcher, filters, onFiltersChange, toolbar, className, labels }: DataTableProps<T>): import("react").JSX.Element;
3945
+ export declare function AppTopbar({ breadcrumbs, breadcrumb, environment, search, notifications, onNotificationSelect, onMarkAllRead, theme, user, userMenuItems, onSignOut, className }: AppTopbarProps): import("react").JSX.Element;
3946
+ //#endregion
3947
+ //#region src/shell/AppTopbar/fixtures.d.ts
3948
+ export declare const appTopbarBreadcrumbs: BreadcrumbItem[];
3949
+ export declare const appTopbarNotifications: NotificationItem[];
3950
+ //#endregion
3951
+ //#region src/shell/AppTopbar/block.meta.d.ts
3952
+ declare const meta$4: BlockMeta;
3953
+ //#endregion
3954
+ //#region src/shell/EnvironmentBadge/block.meta.d.ts
3955
+ declare const meta$22: BlockMeta;
3956
+ //#endregion
3957
+ //#region src/shell/GlobalSearch/GlobalSearch.d.ts
3958
+ export type GlobalSearchGroup = 'pages' | 'records' | 'actions' | 'recent';
3959
+ export interface GlobalSearchProps {
3960
+ pages?: CommandItem[];
3961
+ records?: CommandItem[];
3962
+ actions?: CommandItem[];
3963
+ /** Shown first while the query is empty. */
3964
+ recent?: CommandItem[];
3965
+ /** Called with every chosen item and the group it came from (after the item's own onSelect). */
3966
+ onSelect?: (item: CommandItem, group: GlobalSearchGroup) => void;
3967
+ /** Group headings. */
3968
+ labels?: Partial<Record<GlobalSearchGroup, string>>;
3969
+ /** Registers ⌘K on macOS/iOS and Ctrl+K on other platforms. */
3970
+ shortcut?: boolean;
3971
+ open?: boolean;
3972
+ defaultOpen?: boolean;
3973
+ onOpenChange?: (open: boolean) => void;
3974
+ placeholder?: string;
3975
+ /** Text of the trigger button. */
3976
+ triggerLabel?: string;
3977
+ /** Classes for the trigger (e.g. `hidden md:inline-flex`). */
3978
+ className?: string;
3979
+ }
3980
+ /** ⌘K search: a CommandPalette pre-wired with recent items and Pages / Records / Actions groups. */
3981
+ export declare function GlobalSearch({ pages, records, actions, recent, onSelect, labels, shortcut, open, defaultOpen, onOpenChange, placeholder: placeholderProp, triggerLabel: triggerLabelProp, className }: GlobalSearchProps): import("react").JSX.Element;
3982
+ //#endregion
3983
+ //#region src/shell/GlobalSearch/fixtures.d.ts
3984
+ export declare const globalSearchPages: CommandItem[];
3985
+ export declare const globalSearchRecords: CommandItem[];
3986
+ export declare const globalSearchActions: CommandItem[];
3987
+ export declare const globalSearchRecent: CommandItem[];
3988
+ //#endregion
3989
+ //#region src/shell/GlobalSearch/block.meta.d.ts
3990
+ declare const meta$32: BlockMeta;
3421
3991
  //#endregion
3422
3992
  //#region src/tables/DataTable/column-menu.d.ts
3423
3993
  interface ColumnVisibilityMenuProps<T> {
@@ -3519,7 +4089,7 @@ export interface FilterBarProps {
3519
4089
  className?: string;
3520
4090
  }
3521
4091
  /**
3522
- * Filter bar: search Input, saved views Select, an "Add filter" Menu (multi-select per field),
4092
+ * Filter bar: SearchField, saved views Select, an "Add filter" Menu (multi-select per field),
3523
4093
  * removable filter chips (Token) and Clear all.
3524
4094
  */
3525
4095
  export declare function FilterBar({ fields, query: queryProp, defaultQuery, onQueryChange, filters: filtersProp, defaultFilters, onFiltersChange, views, defaultView, onViewChange, searchLabel: searchLabelProp, placeholder: placeholderProp, resultCount, className, labels }: FilterBarProps): import("react").JSX.Element;
@@ -3542,47 +4112,7 @@ export declare function CursorPagerFooter(props?: CursorPagerFooterProps): impor
3542
4112
  declare const meta$15: BlockMeta;
3543
4113
  //#endregion
3544
4114
  //#region src/tables/PaginationFooter/block.meta.d.ts
3545
- declare const meta$48: BlockMeta;
3546
- //#endregion
3547
- //#region src/tables/LoadMoreFooter/LoadMoreFooter.d.ts
3548
- export interface LoadMoreFooterLabels {
3549
- loadMore: string;
3550
- loading: string;
3551
- retry: string;
3552
- group: string;
3553
- moreAvailable: string;
3554
- summary: (count: number) => string;
3555
- loadedAnnouncement: (count: number) => string;
3556
- }
3557
- /**
3558
- * Each attempt must settle in one update: loading=false together with its result
3559
- * (error, or an empty error on success). Split settles are unsupported.
3560
- */
3561
- export interface LoadMoreFooterProps {
3562
- /** Undefined selects flag mode; null or an empty string exhausts cursor mode. */
3563
- nextCursor?: string | null;
3564
- hasMore?: boolean;
3565
- loading?: boolean;
3566
- error?: string;
3567
- onLoadMore?: (cursor?: string) => void;
3568
- onRetry?: (cursor?: string) => void;
3569
- loadedCount?: number;
3570
- /** Increasing sequence for successful appends only; leave unchanged on replacement or failure. */
3571
- lastAppend?: {
3572
- seq: number;
3573
- count: number;
3574
- };
3575
- exhaustedFocusTarget?: 'summary' | 'root';
3576
- labels?: Partial<LoadMoreFooterLabels>;
3577
- className?: string;
3578
- }
3579
- /**
3580
- * Load more for appended lists without a total or page count. The consumer owns rows and requests.
3581
- * With no props, renders a static catalogue preview using fixture data. Supplying any prop selects
3582
- * the consumer contract: undefined nextCursor means flag mode and requires hasMore=true.
3583
- * loadedCount defaults to the preview fixture; consumers should pass their actual loaded count.
3584
- */
3585
- export declare function LoadMoreFooter(props?: LoadMoreFooterProps): import("react").JSX.Element;
4115
+ declare const meta$49: BlockMeta;
3586
4116
  //#endregion
3587
4117
  //#region src/tables/LoadMoreFooter/block.meta.d.ts
3588
4118
  declare const meta$39: BlockMeta;
@@ -3611,7 +4141,7 @@ export interface TruncatedCollectionFooterProps {
3611
4141
  export declare function TruncatedCollectionFooter({ visibleCount, hasMore, noun: nounProp, locale: localeProp, summaryLabel, formatCount, truncationNote, noteId, className }: TruncatedCollectionFooterProps): import("react").JSX.Element;
3612
4142
  //#endregion
3613
4143
  //#region src/tables/TruncatedCollectionFooter/block.meta.d.ts
3614
- declare const meta$75: BlockMeta;
4144
+ declare const meta$77: BlockMeta;
3615
4145
  //#endregion
3616
4146
  //#region src/tables/InlineEditRow/fixtures.d.ts
3617
4147
  interface EditableMember {
@@ -3699,7 +4229,7 @@ export interface SubordinateListProps<T> {
3699
4229
  export declare function SubordinateList<T>({ title, headingLevel, count, columns, rows, getRowId, pagination, loading, error, onRetry, emptyState }: SubordinateListProps<T>): import("react").JSX.Element;
3700
4230
  //#endregion
3701
4231
  //#region src/tables/SubordinateList/block.meta.d.ts
3702
- declare const meta$70: BlockMeta;
4232
+ declare const meta$72: BlockMeta;
3703
4233
  //#endregion
3704
4234
  //#region src/team/MembersTable/fixtures.d.ts
3705
4235
  interface Member {
@@ -3730,7 +4260,7 @@ export interface MembersTableProps {
3730
4260
  export declare function MembersTable({ members, roles, currentUserId, onRoleChange, onRemove, onEmail, caption, className }: MembersTableProps): import("react").JSX.Element;
3731
4261
  //#endregion
3732
4262
  //#region src/team/MembersTable/block.meta.d.ts
3733
- declare const meta$41: BlockMeta;
4263
+ declare const meta$42: BlockMeta;
3734
4264
  //#endregion
3735
4265
  //#region src/team/NotificationMatrix/fixtures.d.ts
3736
4266
  interface NotificationChannel {
@@ -3767,7 +4297,7 @@ export interface NotificationMatrixProps {
3767
4297
  export declare function NotificationMatrix({ channels, events, value: valueProp, defaultValue, onValueChange, caption, className }: NotificationMatrixProps): import("react").JSX.Element;
3768
4298
  //#endregion
3769
4299
  //#region src/team/NotificationMatrix/block.meta.d.ts
3770
- declare const meta$45: BlockMeta;
4300
+ declare const meta$46: BlockMeta;
3771
4301
  //#endregion
3772
4302
  //#region src/team/PendingInvitations/fixtures.d.ts
3773
4303
  interface Invitation {
@@ -3796,7 +4326,7 @@ export interface PendingInvitationsProps {
3796
4326
  export declare function PendingInvitations({ invitations, onResend, onRevoke, title, headingLevel: Heading, className }: PendingInvitationsProps): import("react").JSX.Element;
3797
4327
  //#endregion
3798
4328
  //#region src/team/PendingInvitations/block.meta.d.ts
3799
- declare const meta$50: BlockMeta;
4329
+ declare const meta$51: BlockMeta;
3800
4330
  //#endregion
3801
4331
  //#region src/team/ProfileHeader/fixtures.d.ts
3802
4332
  interface ProfileMetaItem {
@@ -3830,7 +4360,7 @@ export interface ProfileHeaderProps {
3830
4360
  export declare function ProfileHeader({ profile, onAvatarChange, onEdit, actions, headingLevel: Heading, className }: ProfileHeaderProps): import("react").JSX.Element;
3831
4361
  //#endregion
3832
4362
  //#region src/team/ProfileHeader/block.meta.d.ts
3833
- declare const meta$54: BlockMeta;
4363
+ declare const meta$55: BlockMeta;
3834
4364
  //#endregion
3835
4365
  //#region src/team/SessionsDevices/fixtures.d.ts
3836
4366
  type DeviceKind = 'desktop' | 'mobile' | 'tablet';
@@ -3865,7 +4395,7 @@ export interface SessionsDevicesProps {
3865
4395
  export declare function SessionsDevices({ sessions, onRevoke, onRevokeOthers, title, description, headingLevel: Heading, className }: SessionsDevicesProps): import("react").JSX.Element;
3866
4396
  //#endregion
3867
4397
  //#region src/team/SessionsDevices/block.meta.d.ts
3868
- declare const meta$60: BlockMeta;
4398
+ declare const meta$61: BlockMeta;
3869
4399
  //#endregion
3870
- export { type ApiKeyExpiry, type ApiKeyScope, type Assistant, type AssistantStatus, type AuthFormAccessibilityProps, type AuthHeaderProps, type AuthIdentifierConfig, type AuthSignUpField, type AuthSignUpValidationMessages, type AuthUnavailableState, type AuthValidationMessages, type BlockMeta, type CodeFile, type CodePanelMarker, type CodeProblem, type ColumnResizeHandleProps, type ColumnVisibilityMenuProps, type ColumnWidths, type ConfirmDestructiveDialogProps, type ConsoleEntry, type CostPoint, type CredentialSecret, type DangerZoneAction, type DataTableCellEdit, type DataTableCellEditHandler, type DataTableCellEditResult, type DataTableLabels, type DataTableProps, type DataTableView, type DataTableViewState, ViewSwitcher as DataTableViewSwitcher, type ViewSwitcherProps as DataTableViewSwitcherProps, type DensityToggleProps, type DeploymentRow, type DeviceKind, type DeviceSession, type EditableMember, type EvalMetric, type EvalRow, type EventKind, type EventTone, type FeedbackAction, type FlowConnection, type FlowConnectionRejection, type FlowEdge, type FlowHandle, type FlowNode, type FlowNodeData, type FlowNodeKind, type FlowNodeRenderProps, type FlowNodeRenderer, type FlowTone, type FlowValidationIssue, type Invitation, type LogLevel, type LogLine, type MarketingAction, type Member, type ModelKey, type ModelKeyStatus, type MonacoReady, type NodeInspectorProps, type NodePaletteProps, type NotificationChannel, type NotificationEvent, type NotificationMatrixValue, type PageChromeAction, type PaletteItem, type PanelHeading, type PinSide, type PinnedColumns, type PlanSummaryProps, type ProblemSeverity, type Profile, type ProfileMetaItem, type RoleOption, type RunConsoleProps, type ScheduleEvent, type SpanDetailsProps, type SpanKind, type SsoProvider, type SummaryPlan, type TokenUsagePeriod, type TraceSpan, type TrafficRow, type UploadItem, type UploadStatus, type ValidationIssue, meta$1 as activityFeedMeta, meta$2 as agendaListMeta, meta$3 as appSidebarMeta, meta$4 as appTopbarMeta, meta$5 as assistantCardGridMeta, meta$6 as bulkActionBarMeta, meta$7 as chartCardMeta, meta$8 as codePanelMeta, meta$9 as commentThreadMeta, meta$10 as comparisonTableMeta, meta$11 as confirmDestructiveMeta, meta$12 as costBreakdownMeta, meta$13 as createApiKeyDialogMeta, meta$14 as credentialDisclosureDialogMeta, meta$15 as cursorPagerFooterMeta, meta$16 as dangerZoneMeta, meta$17 as dataTableMeta, meta$18 as dateRangeFilterMeta, meta$19 as descriptionListCardMeta, meta$20 as dialogWizardMeta, meta$21 as emptyStatesMeta, meta$22 as environmentBadgeMeta, meta$23 as errorPanelMeta, meta$24 as evaluationScorecardMeta, meta$25 as faqMeta, meta$26 as featureGridMeta, meta$27 as fileUploadPanelMeta, meta$28 as filterBarMeta, meta$29 as flowBuilderMeta, meta$30 as forgotPasswordFormMeta, meta$31 as formSectionMeta, meta$32 as globalSearchMeta, meta$33 as heroMeta, meta$34 as inlineCalloutMeta, meta$35 as inlineEditRowMeta, meta$36 as inviteMembersDialogMeta, meta$37 as invoiceTableMeta, meta$38 as kpiRowMeta, meta$39 as loadMoreFooterMeta, meta$40 as logViewerMeta, meta$41 as membersTableMeta, meta$42 as mfaChallengeMeta, meta$43 as modelKeysListMeta, meta$44 as monthCalendarMeta, meta$45 as notificationMatrixMeta, meta$46 as pageHeaderMeta, meta$47 as pageToolbarMeta, meta$48 as paginationFooterMeta, meta$49 as paymentMethodCardMeta, meta$50 as pendingInvitationsMeta, meta$51 as planCardMeta, meta$52 as planDefinitionCardMeta, meta$53 as pricingTableMeta, meta$54 as profileHeaderMeta, meta$55 as promptEditorMeta, meta$56 as quotaMetersMeta, meta$57 as resetPasswordFormMeta, meta$58 as resourceCardGridMeta, deviceSessions as sampleDeviceSessions, invitations$1 as sampleInvitations, members$1 as sampleMembers, profile$1 as sampleProfile, sampleEvents as sampleScheduleEvents, sampleToday as sampleScheduleToday, meta$59 as sectionHeaderMeta, meta$60 as sessionsDevicesMeta, meta$61 as settingsRowMeta, meta$62 as signInFormMeta, meta$63 as signUpFormMeta, meta$64 as skeletonsMeta, meta$65 as spendVsBudgetMeta, meta$66 as ssoButtonsMeta, meta$67 as statCardMeta, meta$68 as statusTimelineMeta, meta$69 as stickyActionBarMeta, meta$70 as subordinateListMeta, meta$71 as systemBannerMeta, meta$72 as timeSlotPickerMeta, meta$73 as tokenCostCardMeta, meta$74 as traceWaterfallMeta, meta$75 as truncatedCollectionFooterMeta, validationIssues$1 as validationIssues, meta$76 as validationSummaryMeta, meta$77 as weekCalendarMeta };
4400
+ export { type ApiKeyExpiry, type ApiKeyScope, type Assistant, type AssistantStatus, type AuthFormAccessibilityProps, type AuthHeaderProps, type AuthIdentifierConfig, type AuthSignUpField, type AuthSignUpValidationMessages, type AuthUnavailableState, type AuthValidationMessages, type BlockMeta, type CodeFile, type CodePanelMarker, type CodeProblem, type ColumnResizeHandleProps, type ColumnVisibilityMenuProps, type ColumnWidths, type ConfirmDestructiveDialogLabels, type ConfirmDestructiveDialogProps, type ConsoleEntry, type CostPoint, type CredentialSecret, type DangerZoneAction, type DataTableCellEdit, type DataTableCellEditHandler, type DataTableCellEditResult, type DataTableCsvExportOptions, type DataTableExportRequest, type DataTableLabels, type DataTableProps, type DataTableQuery, type DataTableView, type DataTableViewState, ViewSwitcher as DataTableViewSwitcher, type ViewSwitcherProps as DataTableViewSwitcherProps, type DensityToggleProps, type DeploymentRow, type DeviceKind, type DeviceSession, type EditableMember, type EvalMetric, type EvalRow, type EventKind, type EventTone, type FeedbackAction, type FlowConnection, type FlowConnectionRejection, type FlowEdge, type FlowHandle, type FlowNode, type FlowNodeData, type FlowNodeKind, type FlowNodeRenderProps, type FlowNodeRenderer, type FlowTone, type FlowValidationIssue, type Invitation, type LogLevel, type LogLine, type MarketingAction, type Member, type ModelKey, type ModelKeyStatus, type MonacoReady, type NodeInspectorProps, type NodePaletteProps, type NotificationChannel, type NotificationEvent, type NotificationMatrixValue, type PageChromeAction, type PaletteItem, type PanelHeading, type PinSide, type PinnedColumns, type PlanSummaryProps, type ProblemSeverity, type Profile, type ProfileMetaItem, type RoleOption, type RunConsoleProps, type ScheduleEvent, type SpanDetailsProps, type SpanKind, type SsoProvider, type SummaryPlan, type TableDataParams, type TableDataResult, type TokenUsagePeriod, type TraceSpan, type TrafficRow, type UploadItem, type UploadStatus, type UseTableDataOptions, type UseTableDataResult, type ValidationIssue, meta$1 as activityFeedMeta, meta$2 as agendaListMeta, meta$3 as appSidebarMeta, meta$4 as appTopbarMeta, meta$5 as assistantCardGridMeta, meta$6 as bulkActionBarMeta, meta$7 as chartCardMeta, meta$8 as codePanelMeta, meta$9 as commentThreadMeta, meta$10 as comparisonTableMeta, meta$11 as confirmDestructiveMeta, meta$12 as costBreakdownMeta, meta$13 as createApiKeyDialogMeta, meta$14 as credentialDisclosureDialogMeta, meta$15 as cursorPagerFooterMeta, meta$16 as dangerZoneMeta, meta$17 as dataTableMeta, meta$18 as dateRangeFilterMeta, meta$19 as descriptionListCardMeta, meta$20 as dialogWizardMeta, meta$21 as emptyStatesMeta, meta$22 as environmentBadgeMeta, meta$23 as errorPanelMeta, meta$24 as evaluationScorecardMeta, meta$25 as faqMeta, meta$26 as featureGridMeta, meta$27 as fileUploadPanelMeta, meta$28 as filterBarMeta, meta$29 as flowBuilderMeta, meta$30 as forgotPasswordFormMeta, meta$31 as formSectionMeta, meta$32 as globalSearchMeta, meta$33 as heroMeta, meta$34 as inlineCalloutMeta, meta$35 as inlineEditRowMeta, meta$36 as inviteMembersDialogMeta, meta$37 as invoiceTableMeta, meta$38 as kpiRowMeta, meta$39 as loadMoreFooterMeta, meta$40 as logViewerMeta, meta$41 as logoCloudMeta, meta$42 as membersTableMeta, meta$43 as mfaChallengeMeta, meta$44 as modelKeysListMeta, meta$45 as monthCalendarMeta, meta$46 as notificationMatrixMeta, meta$47 as pageHeaderMeta, meta$48 as pageToolbarMeta, meta$49 as paginationFooterMeta, meta$50 as paymentMethodCardMeta, meta$51 as pendingInvitationsMeta, meta$52 as planCardMeta, meta$53 as planDefinitionCardMeta, meta$54 as pricingTableMeta, meta$55 as profileHeaderMeta, meta$56 as promptEditorMeta, meta$57 as quotaMetersMeta, meta$58 as resetPasswordFormMeta, meta$59 as resourceCardGridMeta, deviceSessions as sampleDeviceSessions, invitations$1 as sampleInvitations, members$1 as sampleMembers, profile$1 as sampleProfile, sampleEvents as sampleScheduleEvents, sampleToday as sampleScheduleToday, meta$60 as sectionHeaderMeta, meta$61 as sessionsDevicesMeta, meta$62 as settingsRowMeta, meta$63 as signInFormMeta, meta$64 as signUpFormMeta, meta$65 as siteFooterMeta, meta$66 as skeletonsMeta, meta$67 as spendVsBudgetMeta, meta$68 as ssoButtonsMeta, meta$69 as statCardMeta, meta$70 as statusTimelineMeta, meta$71 as stickyActionBarMeta, meta$72 as subordinateListMeta, meta$73 as systemBannerMeta, meta$74 as timeSlotPickerMeta, meta$75 as tokenCostCardMeta, meta$76 as traceWaterfallMeta, meta$77 as truncatedCollectionFooterMeta, validationIssues$1 as validationIssues, meta$78 as validationSummaryMeta, meta$79 as weekCalendarMeta };
3871
4401
  //# sourceMappingURL=index.d.ts.map